no-mistakes(document): docs: projection read-type nullability mirrors view column

Author: dmealing

CHANGELOG.md

@@ -7,6 +7,14 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+### Fixed
+- **codegen-ts — projection read-type nullability** now mirrors the view column:
+  a non-`@required` projection field generates a nullable Drizzle view column but
+  previously kept a non-null Zod read type, so the generated projection query
+  returned `T | null` into a non-null `<Name>` field and failed to compile under
+  strict TS. The read field is now emitted as `.nullable()` whenever its view
+  column is not `.notNull()`, so the read type matches the view's SELECT type.
+
 ## [0.12.4] — 2026-06-27
 
 _npm `0.12.4` (full lockstep across all 13 `@metaobjectsdev/*` publish candidates)._

docs/features/source-kinds.md

@@ -45,9 +45,9 @@ mutation routes, and read-only finders. A `table` emits the full CRUD surface.
     "name": "AuthorView",
     "children": [
       { "source.rdb": { "@kind": "view", "@table": "v_author" } },
-      { "field.long":   { "name": "id",
+      { "field.long":   { "name": "id", "@required": true,
         "children": [ { "origin.passthrough": { "@from": "Author.id" } } ] } },
-      { "field.string": { "name": "name",
+      { "field.string": { "name": "name", "@required": true,
         "children": [ { "origin.passthrough": { "@from": "Author.name" } } ] } },
       { "field.long":   { "name": "postCount",
         "children": [ { "origin.aggregate": {
@@ -124,13 +124,19 @@ export const authorView = pgView("v_author").as((qb) => qb.selectFrom("authors")
 export const AuthorViewSchema = z.object({
   id: z.number(),
   name: z.string(),
-  postCount: z.number(),
+  postCount: z.number().nullable(),
 });
 
 export type AuthorView = z.infer<typeof AuthorViewSchema>;
 // no createAuthorView / updateAuthorView / deleteAuthorView — read-only.
 ```
 
+Read-schema nullability mirrors the view column: a field that is not `@required`
+(here `postCount`, a derived aggregate) is nullable in the view's SELECT type, so
+its Zod read field is emitted as `.nullable()` — matching what
+`db.select().from(view)` actually returns. A `@required` field (`id`, `name`) stays
+non-null.
+
 ### Java
 
 OMDB resolves the physical name via `@table`; `@kind: "view"` flips the entity to