@metaobjectsdev/codegen-ts 0.21.4 → 0.21.5

package/dist/api-surface.d.ts

@@ -0,0 +1,18 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+/**
+ * True when the object is served by a generated READ endpoint — so a hook has
+ * something to fetch and a grid has something to render.
+ *
+ * Abstract types are excluded (no instance to address). Today the endpoint test is
+ * "declares or inherits a `source.rdb`", which is precisely the predicate
+ * `routesFile` / `routesFileHono` gate on, so hooks exist exactly where routes do.
+ */
+export declare function servesReadApi(entity: MetaObject): boolean;
+/**
+ * True when the object is served by generated WRITE endpoints — so a form has
+ * somewhere to submit. Requires a WRITABLE source: the same predicate the entity-file
+ * generator uses to decide whether `Insert`/`Update` schemas exist at all, so a form
+ * can never be emitted against schemas that were never generated.
+ */
+export declare function servesWriteApi(entity: MetaObject): boolean;
+//# sourceMappingURL=api-surface.d.ts.map

package/dist/api-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-surface.d.ts","sourceRoot":"","sources":["../src/api-surface.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE1D"}

package/dist/api-surface.js

@@ -0,0 +1,42 @@
+// Does this object have a generated HTTP API surface?
+//
+// THIS is the question the UI tier should ask. A hook, a grid and a form are all
+// clients of a REST endpoint: hooks fetch one, a grid renders what a hook returned,
+// a form submits to one. None of them knows or cares where the data is stored — that
+// is the whole point of the architecture, and `@metaobjectsdev/runtime-web` is
+// deliberately browser-only with no database dependency at all.
+//
+// The UI generators used to ask `hasAnyRdbSource` directly, which produced the RIGHT
+// answer for the WRONG reason: routes are currently derived from sources (FR-008/009
+// derived CRUD), so "has a relational source" and "has an endpoint" happen to
+// coincide today. They are not the same question, and the coincidence is temporary —
+// FR-024 declared `api.*` surfaces and #211 non-RDB projection materialization both
+// break it, at which point a UI tier reaching through to storage starts refusing to
+// generate hooks for entities that genuinely do have endpoints.
+//
+// So the reach-through lives in exactly one place now, named for what it means. When
+// route derivation grows a second source of truth, this function changes and every
+// UI generator follows for free.
+import { isAbstract } from "./instance-artifacts.js";
+import { hasAnyRdbSource, hasWritableRdbSource } from "./source-detect.js";
+/**
+ * True when the object is served by a generated READ endpoint — so a hook has
+ * something to fetch and a grid has something to render.
+ *
+ * Abstract types are excluded (no instance to address). Today the endpoint test is
+ * "declares or inherits a `source.rdb`", which is precisely the predicate
+ * `routesFile` / `routesFileHono` gate on, so hooks exist exactly where routes do.
+ */
+export function servesReadApi(entity) {
+    return !isAbstract(entity) && hasAnyRdbSource(entity);
+}
+/**
+ * True when the object is served by generated WRITE endpoints — so a form has
+ * somewhere to submit. Requires a WRITABLE source: the same predicate the entity-file
+ * generator uses to decide whether `Insert`/`Update` schemas exist at all, so a form
+ * can never be emitted against schemas that were never generated.
+ */
+export function servesWriteApi(entity) {
+    return !isAbstract(entity) && hasWritableRdbSource(entity);
+}
+//# sourceMappingURL=api-surface.js.map

package/dist/api-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-surface.js","sourceRoot":"","sources":["../src/api-surface.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,iFAAiF;AACjF,oFAAoF;AACpF,qFAAqF;AACrF,+EAA+E;AAC/E,gEAAgE;AAChE,EAAE;AACF,qFAAqF;AACrF,qFAAqF;AACrF,8EAA8E;AAC9E,qFAAqF;AACrF,oFAAoF;AACpF,oFAAoF;AACpF,gEAAgE;AAChE,EAAE;AACF,qFAAqF;AACrF,mFAAmF;AACnF,iCAAiC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/generators/routes-file-hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EA4BtB,gBAAgB,CAAC,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAQnF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EAyDtB,gBAAgB,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/generators/routes-file-hono.js

@@ -4,6 +4,7 @@ import { hasAnyRdbSource } from "../source-detect.js";
 import { formatTs } from "../format.js";
 import { entityOutputPath } from "../import-path.js";
 import { CODEGEN_ATTR_EMIT_ROUTES } from "../constants.js";
+import { isTphSubtype } from "../templates/zod-validators.js";
 /**
  * Hono variant of routesFile() — emits `<Entity>.routes.hono.ts` mounting
  * the same five CRUD verbs (GET list / GET :id / POST / PATCH+PUT / DELETE)
@@ -29,17 +30,42 @@ export const routesFileHono = function routesFileHono(opts) {
         // `ctx.config.includeHonoRoutes` and api-docs auto-documents the Hono surface.
         emitsHonoRoutes: true,
         // ADR-0039: resolving — a concrete entity may inherit @emitRoutes via extends.
-        filter: (e) => e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false && hasAnyRdbSource(e) && userFilter(e),
-        generate: perEntity(async (entity, ctx) => {
-            if (!ctx.renderContext) {
-                throw new Error("routes-file-hono: renderContext is required (provided by runGen)");
+        //
+        // TPH subtypes are EXCLUDED, matching the Fastify generator. A TPH subtype shares
+        // its base's table, so mounting vanilla CRUD for it produced routes with no
+        // discriminator scoping at all: the list returned EVERY subtype's rows, and
+        // get/patch/delete by id happily operated on rows belonging to a different
+        // subtype. Silently wrong data, which is worse than no route. Fastify dispatches
+        // these to a discriminator-aware renderer; the Hono runtime has no discriminator
+        // support yet, so this fails CLOSED and the run says so (see the warning below)
+        // rather than shipping an artifact that returns the wrong rows.
+        filter: (e) => e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false
+            && hasAnyRdbSource(e)
+            && !isTphSubtype(e)
+            && userFilter(e),
+        generate: async (ctx) => {
+            // One note per run naming every TPH subtype held back, so the gap is visible at
+            // `meta gen` time rather than discovered as missing endpoints in production.
+            const skipped = ctx.entities.filter((e) => e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false
+                && hasAnyRdbSource(e) && isTphSubtype(e) && userFilter(e));
+            if (skipped.length > 0) {
+                ctx.warn(`no Hono routes emitted for the TPH subtype(s) ${skipped.map((e) => e.name).join(", ")} — ` +
+                    "the Hono adapter has no discriminator scoping yet, so per-subtype CRUD would " +
+                    "return and mutate OTHER subtypes' rows. Use routesFile() (Fastify), which " +
+                    "dispatches TPH correctly, or hand-write the scoped routes.");
             }
-            return {
-                path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.routes.hono.ts`),
-                content: await formatTs(renderRoutesFileHono(entity, ctx.renderContext)),
-            };
-        }),
+            return emit(ctx);
+        },
     };
+    const emit = perEntity(async (entity, ctx) => {
+        if (!ctx.renderContext) {
+            throw new Error("routes-file-hono: renderContext is required (provided by runGen)");
+        }
+        return {
+            path: entityOutputPath(ctx.config.outputLayout ?? "flat", entity.package, `${entity.name}.routes.hono.ts`),
+            content: await formatTs(renderRoutesFileHono(entity, ctx.renderContext)),
+        };
+    });
     if (opts?.target) {
         generator.target = opts.target;
     }

package/dist/generators/routes-file-hono.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAO3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,cAAc,CAAC,IAAyB;IAC7E,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,kBAAkB;QACxB,sEAAsE;QACtE,+EAA+E;QAC/E,eAAe,EAAE,IAAI;QACrB,+EAA+E;QAC/E,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE,CACxB,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC;QACnF,QAAQ,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACxC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,gBAAgB,CACpB,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EACjC,MAAM,CAAC,OAAO,EACd,GAAG,MAAM,CAAC,IAAI,iBAAiB,CAChC;gBACD,OAAO,EAAE,MAAM,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;aACzE,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;IACF,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAyC,CAAC"}
+{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/generators/routes-file-hono.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAO9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,cAAc,CAAC,IAAyB;IAC7E,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,kBAAkB;QACxB,sEAAsE;QACtE,+EAA+E;QAC/E,eAAe,EAAE,IAAI;QACrB,+EAA+E;QAC/E,EAAE;QACF,kFAAkF;QAClF,4EAA4E;QAC5E,4EAA4E;QAC5E,2EAA2E;QAC3E,iFAAiF;QACjF,iFAAiF;QACjF,gFAAgF;QAChF,gEAAgE;QAChE,MAAM,EAAE,CAAC,CAAa,EAAE,EAAE,CACxB,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,KAAK;eACvC,eAAe,CAAC,CAAC,CAAC;eAClB,CAAC,YAAY,CAAC,CAAC,CAAC;eAChB,UAAU,CAAC,CAAC,CAAC;QAClB,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,gFAAgF;YAChF,6EAA6E;YAC7E,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,KAAK;mBAC5C,eAAe,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAC5D,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,IAAI,CACN,iDAAiD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC3F,+EAA+E;oBAC/E,4EAA4E;oBAC5E,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,CAAC;IACF,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QACzC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB,CACpB,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,EACjC,MAAM,CAAC,OAAO,EACd,GAAG,MAAM,CAAC,IAAI,iBAAiB,CAChC;YACD,OAAO,EAAE,MAAM,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;SACzE,CAAC;IACN,CAAC,CAAC,CAAC;IACH,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAyC,CAAC"}

package/dist/index.d.ts

@@ -33,6 +33,8 @@ export { docPageOutputPath, docPageHref, docPageNode, effectivePackage, assertNo
 export type { DocPageNode, DocPagePlacement } from "./docs-paths.js";
 export { isProjection, isWriteThrough } from "./projection/projection-detector.js";
 export { isAbstract, emitsInstanceArtifacts, emitsWriteArtifacts } from "./instance-artifacts.js";
+export { servesReadApi, servesWriteApi } from "./api-surface.js";
+export { renderEntityMetaFile, entityMetaFileName, entityMetaSpecifier } from "./templates/entity-meta-file.js";
 export { isTphDiscriminatorBase, tphConcreteSubtypes, collectTphSubtypeFields, tphPlan, tphRouteSegment } from "./templates/tph-discriminator.js";
 export type { TphPlan, TphSubtypePlan } from "./templates/tph-discriminator.js";
 export { isTphSubtype, tphDiscriminatorPin } from "./templates/zod-validators.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAClG,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC/F,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGxE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErF,YAAY,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC9P,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEvL,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1G,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxM,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGlG,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAClJ,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAOlF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIzF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,SAAS,GACV,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,WAAW,IAAI,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACxG,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAExG,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKvH,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,eAAe,GAChB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -26,6 +26,10 @@ export { packageToPath, entityOutputPath, crossEntitySpecifier, barrelEntrySpeci
 export { docPageOutputPath, docPageHref, docPageNode, effectivePackage, assertNoDuplicateDocPaths, } from "./docs-paths.js";
 export { isProjection, isWriteThrough } from "./projection/projection-detector.js";
 export { isAbstract, emitsInstanceArtifacts, emitsWriteArtifacts } from "./instance-artifacts.js";
+// The UI tier asks THESE — "is there an endpoint?" — never the storage predicates.
+export { servesReadApi, servesWriteApi } from "./api-surface.js";
+// The DB-free descriptor module the UI tier imports from (see entity-meta-file.ts).
+export { renderEntityMetaFile, entityMetaFileName, entityMetaSpecifier } from "./templates/entity-meta-file.js";
 // FR-017 TPH helpers — used by the per-framework codegen packages (tanstack,
 // react) to dispatch polymorphic/per-subtype emission and skip subtype files.
 export { isTphDiscriminatorBase, tphConcreteSubtypes, collectTphSubtypeFields, tphPlan, tphRouteSegment } from "./templates/tph-discriminator.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/instance-artifacts.d.ts

@@ -1,4 +1,4 @@
-import type { MetaData } from "@metaobjectsdev/metadata";
+import type { MetaData, MetaObject } from "@metaobjectsdev/metadata";
 /**
  * True when `entity` is abstract (`@isAbstract: true`).
  *
@@ -10,20 +10,26 @@ import type { MetaData } from "@metaobjectsdev/metadata";
 export declare function isAbstract(entity: MetaData): boolean;
 /**
  * True when `entity` should produce INSTANCE artifacts of ANY kind (read OR
- * write): CRUD/read hooks, grid columns, grid hooks. Abstract types are
- * excluded — they have no instantiable representation.
+ * write): CRUD/read hooks, grid columns, grid hooks. Excludes abstract types
+ * (no instantiable representation) and sourceless objects (no route for the
+ * artifact to talk to — see the header note, and #248 for the doctrine).
  *
  * Read-capable generators (tanstack hooks/grids) compose this so they skip
- * abstract bases while still serving projections via their own
- * `isProjection` read-only branch.
+ * abstract bases while still serving VIEW-BACKED projections via their own
+ * `isProjection` read-only branch — a projection over a `@kind: view` source
+ * has a source, so it passes here and keeps its read-only hooks.
  */
-export declare function emitsInstanceArtifacts(entity: MetaData): boolean;
+export declare function emitsInstanceArtifacts(entity: MetaObject): boolean;
 /**
  * True when `entity` should produce WRITE artifacts (write forms, mutation
- * surfaces). Excludes both abstract types (no instance at all) and projections
- * (read-only views — instantiable for read, never for write).
+ * surfaces). Excludes abstract types (no instance at all), projections
+ * (read-only views — instantiable for read, never for write), and objects with
+ * no WRITABLE source (nothing to submit to; this is the same predicate the
+ * entity-file generator uses to decide whether an `Insert`/`Update` surface
+ * exists at all, so a form can no longer be emitted against schemas that were
+ * never generated).
  *
  * WRITE-only generators (e.g. the React form generator) compose this.
  */
-export declare function emitsWriteArtifacts(entity: MetaData): boolean;
+export declare function emitsWriteArtifacts(entity: MetaObject): boolean;
 //# sourceMappingURL=instance-artifacts.d.ts.map

package/dist/instance-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance-artifacts.d.ts","sourceRoot":"","sources":["../src/instance-artifacts.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"instance-artifacts.d.ts","sourceRoot":"","sources":["../src/instance-artifacts.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAIrE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAElE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE/D"}

package/dist/instance-artifacts.js

@@ -1,7 +1,7 @@
 // Framework-level guard shared by every generator that emits INSTANCE / WRITE
 // artifacts (write forms, CRUD hooks, grid columns, grid hooks, …).
 //
-// Two MetaData concepts make an entity *not* a source of instance artifacts:
+// THREE things make an object *not* a source of instance artifacts:
 //
 //   1. Abstract (`@isAbstract: true`) — a fundamental MetaData concept: an
 //      abstract type contributes shape via inheritance ONLY. It never has an
@@ -11,7 +11,25 @@
 //      consumers can reference its shape), but nothing that points at an
 //      `<E>Insert` schema / `$table` / mutation hook it does not have.
 //
-//   2. Projection (read-only view; see `isProjection`) — instantiable for READ
+//   2. SOURCELESS — no declared/inherited `source.*` at all. #248 settled that DB
+//      participation derives from a declared source, never from the object subtype,
+//      and the routes/queries tier already gates on exactly this. An instance
+//      artifact is a client for a route: hooks fetch one, a grid renders what hooks
+//      return, a form submits to one. A sourceless object has no route, so there is
+//      nothing for any of them to talk to. This subsumes `object.value` — a value is
+//      sourceless by loader-enforced purity (ADR-0028) — WITHOUT reintroducing a
+//      subtype check, which is the family #248 spent two releases eradicating. It
+//      also covers sourceless entities and the sourceless `object.projection` that
+//      #210 made the recommended payload re-host: that shape's generated surface is
+//      the payload VO + render helper + output parser, never TanStack CRUD.
+//
+//      This is a BUG FIX, not a policy change. Before it, a value object got a
+//      `<V>.hooks.ts` importing `<V>Filter` / `<V>Insert` / `<V>Update` and the
+//      `<V>` const — none of which the entity module emits for a value — so the
+//      generated file could not typecheck (TS2305 ×3, TS2693) and could not even
+//      link under native ESM. There was never working output here to lose.
+//
+//   3. Projection (read-only view; see `isProjection`) — instantiable for READ
 //      but never for WRITE. It legitimately gets read models + read-only hooks
 //      + grids, but NOT a write form. WRITE-only generators (forms) reuse
 //      `emitsWriteArtifacts` to skip these; read-capable generators (tanstack
@@ -19,8 +37,10 @@
 //
 // Centralizing these as `emitsInstanceArtifacts` / `emitsWriteArtifacts` keeps
 // the rule in one place: a generator composes the matching guard into its
-// `filter` rather than re-deriving "is this abstract / read-only" ad hoc.
+// `filter` rather than re-deriving "is this abstract / read-only / persisted" ad
+// hoc — and a third-party generator composing the guard inherits the fix.
 import { isProjection } from "./projection/projection-detector.js";
+import { hasAnyRdbSource, hasWritableRdbSource } from "./source-detect.js";
 /**
  * True when `entity` is abstract (`@isAbstract: true`).
  *
@@ -34,24 +54,30 @@ export function isAbstract(entity) {
 }
 /**
  * True when `entity` should produce INSTANCE artifacts of ANY kind (read OR
- * write): CRUD/read hooks, grid columns, grid hooks. Abstract types are
- * excluded — they have no instantiable representation.
+ * write): CRUD/read hooks, grid columns, grid hooks. Excludes abstract types
+ * (no instantiable representation) and sourceless objects (no route for the
+ * artifact to talk to — see the header note, and #248 for the doctrine).
  *
  * Read-capable generators (tanstack hooks/grids) compose this so they skip
- * abstract bases while still serving projections via their own
- * `isProjection` read-only branch.
+ * abstract bases while still serving VIEW-BACKED projections via their own
+ * `isProjection` read-only branch — a projection over a `@kind: view` source
+ * has a source, so it passes here and keeps its read-only hooks.
  */
 export function emitsInstanceArtifacts(entity) {
-    return !isAbstract(entity);
+    return !isAbstract(entity) && hasAnyRdbSource(entity);
 }
 /**
  * True when `entity` should produce WRITE artifacts (write forms, mutation
- * surfaces). Excludes both abstract types (no instance at all) and projections
- * (read-only views — instantiable for read, never for write).
+ * surfaces). Excludes abstract types (no instance at all), projections
+ * (read-only views — instantiable for read, never for write), and objects with
+ * no WRITABLE source (nothing to submit to; this is the same predicate the
+ * entity-file generator uses to decide whether an `Insert`/`Update` surface
+ * exists at all, so a form can no longer be emitted against schemas that were
+ * never generated).
  *
  * WRITE-only generators (e.g. the React form generator) compose this.
  */
 export function emitsWriteArtifacts(entity) {
-    return !isAbstract(entity) && !isProjection(entity);
+    return !isAbstract(entity) && !isProjection(entity) && hasWritableRdbSource(entity);
 }
 //# sourceMappingURL=instance-artifacts.js.map

package/dist/instance-artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance-artifacts.js","sourceRoot":"","sources":["../src/instance-artifacts.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,0EAA0E;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IACzC,OAAO,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAgB;IACrD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAClD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"instance-artifacts.js","sourceRoot":"","sources":["../src/instance-artifacts.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,uEAAuE;AACvE,EAAE;AACF,kFAAkF;AAClF,oFAAoF;AACpF,8EAA8E;AAC9E,oFAAoF;AACpF,oFAAoF;AACpF,qFAAqF;AACrF,iFAAiF;AACjF,kFAAkF;AAClF,mFAAmF;AACnF,oFAAoF;AACpF,4EAA4E;AAC5E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,iFAAiF;AACjF,0EAA0E;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IACzC,OAAO,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAkB;IACvD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtF,CAAC"}

package/dist/templates/entity-meta-file.d.ts

@@ -0,0 +1,7 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+/** File name (no directory) of an entity's DB-free descriptor module. */
+export declare function entityMetaFileName(entityName: string): string;
+/** Module specifier the UI files use to reach it — a same-directory sibling. */
+export declare function entityMetaSpecifier(entityName: string, extStyle: string | undefined): string;
+export declare function renderEntityMetaFile(entity: MetaObject, apiPrefix?: string): string;
+//# sourceMappingURL=entity-meta-file.d.ts.map

package/dist/templates/entity-meta-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-meta-file.d.ts","sourceRoot":"","sources":["../../src/templates/entity-meta-file.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE5F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,SAAK,GAAG,MAAM,CAa/E"}

package/dist/templates/entity-meta-file.js

@@ -0,0 +1,47 @@
+// `<Entity>.meta.ts` — the entity descriptor, with no database in the module graph.
+//
+// The generated UI files (hooks, grid hooks, forms) value-import exactly ONE thing
+// from the entity module: the `<Entity>` descriptor const. Everything else they take
+// is `import type`, which the compiler erases. But `<Entity>.ts` also constructs the
+// Drizzle table at module scope, so that single value import dragged the entire ORM
+// into every browser bundle — measured at 716 KB for one generated hook, containing
+// `SQLiteTable` and the whole driver.
+//
+// Nothing in the UI path READS the table. The descriptor is plain data — `$table` is
+// a string, not a table object — so this was never a semantic dependency on the
+// database, only a physical one created by sharing a module. A `/* @__PURE__ */`
+// annotation on the table construction does NOT help (measured: still 716 KB), so
+// separating the module is the fix.
+//
+// Deliberately ADDITIVE. `<Entity>.ts` is untouched and still exports the descriptor,
+// so every existing import keeps working and this stays a PATCH. The UI generators
+// simply take the descriptor from here instead, and each emits this file itself —
+// byte-identical between them, which #266 collapses — rather than depending on the
+// consumer having wired an extra generator, since the entity generator is
+// scaffold-and-own (ADR-0034) and cannot be changed from the package.
+import { code } from "ts-poet";
+import { GENERATED_HEADER } from "../constants.js";
+import { renderEntityConstants } from "./entity-constants.js";
+/** File name (no directory) of an entity's DB-free descriptor module. */
+export function entityMetaFileName(entityName) {
+    return `${entityName}.meta.ts`;
+}
+/** Module specifier the UI files use to reach it — a same-directory sibling. */
+export function entityMetaSpecifier(entityName, extStyle) {
+    return `./${entityName}.meta${extStyle === "js" ? ".js" : ""}`;
+}
+export function renderEntityMetaFile(entity, apiPrefix = "") {
+    const body = code `
+// ${GENERATED_HEADER} — DO NOT EDIT.
+// Source metadata: ${entity.name}
+//
+// Browser-safe: this module contains ONLY the entity descriptor — plain data, no
+// Drizzle table and no database import of any kind. The generated UI files import it
+// from here so a client bundle never pulls the ORM in. \`${entity.name}.ts\` also
+// exports this descriptor, for server-side and pre-existing consumers.
+
+${renderEntityConstants(entity, apiPrefix)}
+`;
+    return body.toString();
+}
+//# sourceMappingURL=entity-meta-file.js.map

package/dist/templates/entity-meta-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-meta-file.js","sourceRoot":"","sources":["../../src/templates/entity-meta-file.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,mFAAmF;AACnF,qFAAqF;AACrF,qFAAqF;AACrF,oFAAoF;AACpF,oFAAoF;AACpF,sCAAsC;AACtC,EAAE;AACF,qFAAqF;AACrF,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,oCAAoC;AACpC,EAAE;AACF,sFAAsF;AACtF,mFAAmF;AACnF,kFAAkF;AAClF,mFAAmF;AACnF,0EAA0E;AAC1E,sEAAsE;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,GAAG,UAAU,UAAU,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,QAA4B;IAClF,OAAO,KAAK,UAAU,QAAQ,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB,EAAE,SAAS,GAAG,EAAE;IACrE,MAAM,IAAI,GAAG,IAAI,CAAA;KACd,gBAAgB;sBACC,MAAM,CAAC,IAAI;;;;4DAI2B,MAAM,CAAC,IAAI;;;EAGrE,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC;CACzC,CAAC;IACA,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC"}

package/dist/templates/routes-file-hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/templates/routes-file-hono.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA2GnF"}
+{"version":3,"file":"routes-file-hono.d.ts","sourceRoot":"","sources":["../../src/templates/routes-file-hono.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAqHnF"}

package/dist/templates/routes-file-hono.js

@@ -27,7 +27,7 @@ import { code, imp } from "ts-poet";
 import {} from "../render-context.js";
 import { entityModuleSpecifier } from "../import-path.js";
 import { GENERATED_HEADER } from "../constants.js";
-import { isProjection } from "../projection/projection-detector.js";
+import { isProjection, isWriteThrough } from "../projection/projection-detector.js";
 export function renderRoutesFileHono(entity, ctx) {
     const entityName = entity.name;
     const handlerName = `register${entityName}Routes`;
@@ -77,6 +77,15 @@ export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unkno
     }
     // --- Vanilla / write-through entity path: full CRUD routes ---
     const tableVar = ctx.collectionName(entityName);
+    // #214: a write-through entity reads through its replica view so derived origin.*
+    // columns are present. Without this the Hono adapter returned rows missing every
+    // derived field the generated type and Zod schema promise, and a filter or sort on
+    // one — both ALLOWED by the generated allowlists — hit a column the table does not
+    // have, producing a 500. Fastify has done this since #214; Hono was simply never
+    // wired, exactly as it was never wired for #286's `.all()`/`.get()` fix.
+    const writeThrough = isWriteThrough(entity);
+    const camelName = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+    const readViewLine = writeThrough ? `\n    readView: ${camelName}View,` : "";
     const HonoSym = imp("t:Hono@hono");
     const mountCrudRoutesSym = imp("mountCrudRoutes@@metaobjectsdev/runtime-ts/hono");
     const literalImports = code `
@@ -86,7 +95,7 @@ import {
   ${entityName}InsertSchema,
   ${entityName}UpdateSchema,
   ${entityName}FilterAllowlist,
-  ${entityName}SortAllowlist,
+  ${entityName}SortAllowlist,${writeThrough ? `\n  ${camelName}View,` : ""}
 } from ${JSON.stringify(entityFileSpec)};
 `;
     const body = code `
@@ -104,7 +113,7 @@ export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unkno
     app,
     path: ${pathExpr},
     db: deps.db,
-    table: ${tableVar},
+    table: ${tableVar},${readViewLine}
     insertSchema: ${entityName}InsertSchema,
     updateSchema: ${entityName}UpdateSchema,
     filterAllowlist: ${entityName}FilterAllowlist,

package/dist/templates/routes-file-hono.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/templates/routes-file-hono.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes-file-hono.js","sourceRoot":"","sources":["../../src/templates/routes-file-hono.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/codegen-ts",
-  "version": "0.21.4",
+  "version": "0.21.5",
   "description": "TypeScript codegen engine for MetaObjects — emits Drizzle, Zod, and Fastify artifacts.",
   "type": "module",
   "main": "./dist/index.js",
@@ -111,21 +111,21 @@
     "access": "public"
   },
   "dependencies": {
-    "@metaobjectsdev/metadata": "0.21.4",
-    "@metaobjectsdev/render": "0.21.4",
+    "@metaobjectsdev/metadata": "0.21.5",
+    "@metaobjectsdev/render": "0.21.5",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.4",
     "ts-poet": "^6.10.0"
   },
   "peerDependencies": {
-    "drizzle-orm": ">=0.36.0",
-    "zod": ">=3.23.0"
+    "drizzle-orm": ">=0.36.0 <1.0.0",
+    "zod": ">=3.23.0 <5.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.0",
-    "@metaobjectsdev/codegen-ts-react": "0.21.4",
-    "@metaobjectsdev/migrate-ts": "0.21.4",
-    "@metaobjectsdev/runtime-ts": "0.21.4",
+    "@metaobjectsdev/codegen-ts-react": "0.21.5",
+    "@metaobjectsdev/migrate-ts": "0.21.5",
+    "@metaobjectsdev/runtime-ts": "0.21.5",
     "bun-types": "latest",
     "drizzle-orm": "^0.36.0",
     "hono": "^4.6.0",

package/src/api-surface.ts

@@ -0,0 +1,45 @@
+// Does this object have a generated HTTP API surface?
+//
+// THIS is the question the UI tier should ask. A hook, a grid and a form are all
+// clients of a REST endpoint: hooks fetch one, a grid renders what a hook returned,
+// a form submits to one. None of them knows or cares where the data is stored — that
+// is the whole point of the architecture, and `@metaobjectsdev/runtime-web` is
+// deliberately browser-only with no database dependency at all.
+//
+// The UI generators used to ask `hasAnyRdbSource` directly, which produced the RIGHT
+// answer for the WRONG reason: routes are currently derived from sources (FR-008/009
+// derived CRUD), so "has a relational source" and "has an endpoint" happen to
+// coincide today. They are not the same question, and the coincidence is temporary —
+// FR-024 declared `api.*` surfaces and #211 non-RDB projection materialization both
+// break it, at which point a UI tier reaching through to storage starts refusing to
+// generate hooks for entities that genuinely do have endpoints.
+//
+// So the reach-through lives in exactly one place now, named for what it means. When
+// route derivation grows a second source of truth, this function changes and every
+// UI generator follows for free.
+
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import { isAbstract } from "./instance-artifacts.js";
+import { hasAnyRdbSource, hasWritableRdbSource } from "./source-detect.js";
+
+/**
+ * True when the object is served by a generated READ endpoint — so a hook has
+ * something to fetch and a grid has something to render.
+ *
+ * Abstract types are excluded (no instance to address). Today the endpoint test is
+ * "declares or inherits a `source.rdb`", which is precisely the predicate
+ * `routesFile` / `routesFileHono` gate on, so hooks exist exactly where routes do.
+ */
+export function servesReadApi(entity: MetaObject): boolean {
+  return !isAbstract(entity) && hasAnyRdbSource(entity);
+}
+
+/**
+ * True when the object is served by generated WRITE endpoints — so a form has
+ * somewhere to submit. Requires a WRITABLE source: the same predicate the entity-file
+ * generator uses to decide whether `Insert`/`Update` schemas exist at all, so a form
+ * can never be emitted against schemas that were never generated.
+ */
+export function servesWriteApi(entity: MetaObject): boolean {
+  return !isAbstract(entity) && hasWritableRdbSource(entity);
+}

package/src/generators/routes-file-hono.ts

@@ -5,6 +5,7 @@ import { hasAnyRdbSource } from "../source-detect.js";
 import { formatTs } from "../format.js";
 import { entityOutputPath } from "../import-path.js";
 import { CODEGEN_ATTR_EMIT_ROUTES } from "../constants.js";
+import { isTphSubtype } from "../templates/zod-validators.js";
 
 export interface RoutesFileHonoOpts {
   filter?: (entity: MetaObject) => boolean;
@@ -36,9 +37,39 @@ export const routesFileHono = function routesFileHono(opts?: RoutesFileHonoOpts)
     // `ctx.config.includeHonoRoutes` and api-docs auto-documents the Hono surface.
     emitsHonoRoutes: true,
     // ADR-0039: resolving — a concrete entity may inherit @emitRoutes via extends.
+    //
+    // TPH subtypes are EXCLUDED, matching the Fastify generator. A TPH subtype shares
+    // its base's table, so mounting vanilla CRUD for it produced routes with no
+    // discriminator scoping at all: the list returned EVERY subtype's rows, and
+    // get/patch/delete by id happily operated on rows belonging to a different
+    // subtype. Silently wrong data, which is worse than no route. Fastify dispatches
+    // these to a discriminator-aware renderer; the Hono runtime has no discriminator
+    // support yet, so this fails CLOSED and the run says so (see the warning below)
+    // rather than shipping an artifact that returns the wrong rows.
     filter: (e: MetaObject) =>
-      e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false && hasAnyRdbSource(e) && userFilter(e),
-    generate: perEntity(async (entity, ctx) => {
+      e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false
+      && hasAnyRdbSource(e)
+      && !isTphSubtype(e)
+      && userFilter(e),
+    generate: async (ctx) => {
+      // One note per run naming every TPH subtype held back, so the gap is visible at
+      // `meta gen` time rather than discovered as missing endpoints in production.
+      const skipped = ctx.entities.filter(
+        (e) => e.attr(CODEGEN_ATTR_EMIT_ROUTES) !== false
+          && hasAnyRdbSource(e) && isTphSubtype(e) && userFilter(e),
+      );
+      if (skipped.length > 0) {
+        ctx.warn(
+          `no Hono routes emitted for the TPH subtype(s) ${skipped.map((e) => e.name).join(", ")} — ` +
+          "the Hono adapter has no discriminator scoping yet, so per-subtype CRUD would " +
+          "return and mutate OTHER subtypes' rows. Use routesFile() (Fastify), which " +
+          "dispatches TPH correctly, or hand-write the scoped routes.",
+        );
+      }
+      return emit(ctx);
+    },
+  };
+  const emit = perEntity(async (entity, ctx) => {
       if (!ctx.renderContext) {
         throw new Error("routes-file-hono: renderContext is required (provided by runGen)");
       }
@@ -50,8 +81,7 @@ export const routesFileHono = function routesFileHono(opts?: RoutesFileHonoOpts)
         ),
         content: await formatTs(renderRoutesFileHono(entity, ctx.renderContext)),
       };
-    }),
-  };
+  });
   if (opts?.target) {
     generator.target = opts.target;
   }

package/src/index.ts

@@ -82,6 +82,10 @@ export type { DocPageNode, DocPagePlacement } from "./docs-paths.js";
 
 export { isProjection, isWriteThrough } from "./projection/projection-detector.js";
 export { isAbstract, emitsInstanceArtifacts, emitsWriteArtifacts } from "./instance-artifacts.js";
+// The UI tier asks THESE — "is there an endpoint?" — never the storage predicates.
+export { servesReadApi, servesWriteApi } from "./api-surface.js";
+// The DB-free descriptor module the UI tier imports from (see entity-meta-file.ts).
+export { renderEntityMetaFile, entityMetaFileName, entityMetaSpecifier } from "./templates/entity-meta-file.js";
 // FR-017 TPH helpers — used by the per-framework codegen packages (tanstack,
 // react) to dispatch polymorphic/per-subtype emission and skip subtype files.
 export { isTphDiscriminatorBase, tphConcreteSubtypes, collectTphSubtypeFields, tphPlan, tphRouteSegment } from "./templates/tph-discriminator.js";

package/src/instance-artifacts.ts

@@ -1,7 +1,7 @@
 // Framework-level guard shared by every generator that emits INSTANCE / WRITE
 // artifacts (write forms, CRUD hooks, grid columns, grid hooks, …).
 //
-// Two MetaData concepts make an entity *not* a source of instance artifacts:
+// THREE things make an object *not* a source of instance artifacts:
 //
 //   1. Abstract (`@isAbstract: true`) — a fundamental MetaData concept: an
 //      abstract type contributes shape via inheritance ONLY. It never has an
@@ -11,7 +11,25 @@
 //      consumers can reference its shape), but nothing that points at an
 //      `<E>Insert` schema / `$table` / mutation hook it does not have.
 //
-//   2. Projection (read-only view; see `isProjection`) — instantiable for READ
+//   2. SOURCELESS — no declared/inherited `source.*` at all. #248 settled that DB
+//      participation derives from a declared source, never from the object subtype,
+//      and the routes/queries tier already gates on exactly this. An instance
+//      artifact is a client for a route: hooks fetch one, a grid renders what hooks
+//      return, a form submits to one. A sourceless object has no route, so there is
+//      nothing for any of them to talk to. This subsumes `object.value` — a value is
+//      sourceless by loader-enforced purity (ADR-0028) — WITHOUT reintroducing a
+//      subtype check, which is the family #248 spent two releases eradicating. It
+//      also covers sourceless entities and the sourceless `object.projection` that
+//      #210 made the recommended payload re-host: that shape's generated surface is
+//      the payload VO + render helper + output parser, never TanStack CRUD.
+//
+//      This is a BUG FIX, not a policy change. Before it, a value object got a
+//      `<V>.hooks.ts` importing `<V>Filter` / `<V>Insert` / `<V>Update` and the
+//      `<V>` const — none of which the entity module emits for a value — so the
+//      generated file could not typecheck (TS2305 ×3, TS2693) and could not even
+//      link under native ESM. There was never working output here to lose.
+//
+//   3. Projection (read-only view; see `isProjection`) — instantiable for READ
 //      but never for WRITE. It legitimately gets read models + read-only hooks
 //      + grids, but NOT a write form. WRITE-only generators (forms) reuse
 //      `emitsWriteArtifacts` to skip these; read-capable generators (tanstack
@@ -19,10 +37,12 @@
 //
 // Centralizing these as `emitsInstanceArtifacts` / `emitsWriteArtifacts` keeps
 // the rule in one place: a generator composes the matching guard into its
-// `filter` rather than re-deriving "is this abstract / read-only" ad hoc.
+// `filter` rather than re-deriving "is this abstract / read-only / persisted" ad
+// hoc — and a third-party generator composing the guard inherits the fix.
 
-import type { MetaData } from "@metaobjectsdev/metadata";
+import type { MetaData, MetaObject } from "@metaobjectsdev/metadata";
 import { isProjection } from "./projection/projection-detector.js";
+import { hasAnyRdbSource, hasWritableRdbSource } from "./source-detect.js";
 
 /**
  * True when `entity` is abstract (`@isAbstract: true`).
@@ -38,24 +58,30 @@ export function isAbstract(entity: MetaData): boolean {
 
 /**
  * True when `entity` should produce INSTANCE artifacts of ANY kind (read OR
- * write): CRUD/read hooks, grid columns, grid hooks. Abstract types are
- * excluded — they have no instantiable representation.
+ * write): CRUD/read hooks, grid columns, grid hooks. Excludes abstract types
+ * (no instantiable representation) and sourceless objects (no route for the
+ * artifact to talk to — see the header note, and #248 for the doctrine).
  *
  * Read-capable generators (tanstack hooks/grids) compose this so they skip
- * abstract bases while still serving projections via their own
- * `isProjection` read-only branch.
+ * abstract bases while still serving VIEW-BACKED projections via their own
+ * `isProjection` read-only branch — a projection over a `@kind: view` source
+ * has a source, so it passes here and keeps its read-only hooks.
  */
-export function emitsInstanceArtifacts(entity: MetaData): boolean {
-  return !isAbstract(entity);
+export function emitsInstanceArtifacts(entity: MetaObject): boolean {
+  return !isAbstract(entity) && hasAnyRdbSource(entity);
 }
 
 /**
  * True when `entity` should produce WRITE artifacts (write forms, mutation
- * surfaces). Excludes both abstract types (no instance at all) and projections
- * (read-only views — instantiable for read, never for write).
+ * surfaces). Excludes abstract types (no instance at all), projections
+ * (read-only views — instantiable for read, never for write), and objects with
+ * no WRITABLE source (nothing to submit to; this is the same predicate the
+ * entity-file generator uses to decide whether an `Insert`/`Update` surface
+ * exists at all, so a form can no longer be emitted against schemas that were
+ * never generated).
  *
  * WRITE-only generators (e.g. the React form generator) compose this.
  */
-export function emitsWriteArtifacts(entity: MetaData): boolean {
-  return !isAbstract(entity) && !isProjection(entity);
+export function emitsWriteArtifacts(entity: MetaObject): boolean {
+  return !isAbstract(entity) && !isProjection(entity) && hasWritableRdbSource(entity);
 }

package/src/templates/entity-meta-file.ts

@@ -0,0 +1,51 @@
+// `<Entity>.meta.ts` — the entity descriptor, with no database in the module graph.
+//
+// The generated UI files (hooks, grid hooks, forms) value-import exactly ONE thing
+// from the entity module: the `<Entity>` descriptor const. Everything else they take
+// is `import type`, which the compiler erases. But `<Entity>.ts` also constructs the
+// Drizzle table at module scope, so that single value import dragged the entire ORM
+// into every browser bundle — measured at 716 KB for one generated hook, containing
+// `SQLiteTable` and the whole driver.
+//
+// Nothing in the UI path READS the table. The descriptor is plain data — `$table` is
+// a string, not a table object — so this was never a semantic dependency on the
+// database, only a physical one created by sharing a module. A `/* @__PURE__ */`
+// annotation on the table construction does NOT help (measured: still 716 KB), so
+// separating the module is the fix.
+//
+// Deliberately ADDITIVE. `<Entity>.ts` is untouched and still exports the descriptor,
+// so every existing import keeps working and this stays a PATCH. The UI generators
+// simply take the descriptor from here instead, and each emits this file itself —
+// byte-identical between them, which #266 collapses — rather than depending on the
+// consumer having wired an extra generator, since the entity generator is
+// scaffold-and-own (ADR-0034) and cannot be changed from the package.
+
+import { code } from "ts-poet";
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import { GENERATED_HEADER } from "../constants.js";
+import { renderEntityConstants } from "./entity-constants.js";
+
+/** File name (no directory) of an entity's DB-free descriptor module. */
+export function entityMetaFileName(entityName: string): string {
+  return `${entityName}.meta.ts`;
+}
+
+/** Module specifier the UI files use to reach it — a same-directory sibling. */
+export function entityMetaSpecifier(entityName: string, extStyle: string | undefined): string {
+  return `./${entityName}.meta${extStyle === "js" ? ".js" : ""}`;
+}
+
+export function renderEntityMetaFile(entity: MetaObject, apiPrefix = ""): string {
+  const body = code`
+// ${GENERATED_HEADER} — DO NOT EDIT.
+// Source metadata: ${entity.name}
+//
+// Browser-safe: this module contains ONLY the entity descriptor — plain data, no
+// Drizzle table and no database import of any kind. The generated UI files import it
+// from here so a client bundle never pulls the ORM in. \`${entity.name}.ts\` also
+// exports this descriptor, for server-side and pre-existing consumers.
+
+${renderEntityConstants(entity, apiPrefix)}
+`;
+  return body.toString();
+}

package/src/templates/routes-file-hono.ts

@@ -29,7 +29,7 @@ import type { MetaObject } from "@metaobjectsdev/metadata";
 import { type RenderContext } from "../render-context.js";
 import { entityModuleSpecifier } from "../import-path.js";
 import { GENERATED_HEADER } from "../constants.js";
-import { isProjection } from "../projection/projection-detector.js";
+import { isProjection, isWriteThrough } from "../projection/projection-detector.js";
 
 export function renderRoutesFileHono(entity: MetaObject, ctx: RenderContext): string {
   const entityName = entity.name;
@@ -98,6 +98,16 @@ export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unkno
   // --- Vanilla / write-through entity path: full CRUD routes ---
   const tableVar = ctx.collectionName(entityName);
 
+  // #214: a write-through entity reads through its replica view so derived origin.*
+  // columns are present. Without this the Hono adapter returned rows missing every
+  // derived field the generated type and Zod schema promise, and a filter or sort on
+  // one — both ALLOWED by the generated allowlists — hit a column the table does not
+  // have, producing a 500. Fastify has done this since #214; Hono was simply never
+  // wired, exactly as it was never wired for #286's `.all()`/`.get()` fix.
+  const writeThrough = isWriteThrough(entity);
+  const camelName = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+  const readViewLine = writeThrough ? `\n    readView: ${camelName}View,` : "";
+
   const HonoSym = imp("t:Hono@hono");
   const mountCrudRoutesSym = imp("mountCrudRoutes@@metaobjectsdev/runtime-ts/hono");
 
@@ -108,7 +118,7 @@ import {
   ${entityName}InsertSchema,
   ${entityName}UpdateSchema,
   ${entityName}FilterAllowlist,
-  ${entityName}SortAllowlist,
+  ${entityName}SortAllowlist,${writeThrough ? `\n  ${camelName}View,` : ""}
 } from ${JSON.stringify(entityFileSpec)};
 `;
 
@@ -127,7 +137,7 @@ export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unkno
     app,
     path: ${pathExpr},
     db: deps.db,
-    table: ${tableVar},
+    table: ${tableVar},${readViewLine}
     insertSchema: ${entityName}InsertSchema,
     updateSchema: ${entityName}UpdateSchema,
     filterAllowlist: ${entityName}FilterAllowlist,