@metaobjectsdev/codegen-ts 0.9.0 → 0.10.0

package/dist/templates/render-helper.js

@@ -24,10 +24,10 @@
 //     depend on the cli package; the walk is the same as cli's payload-field-tree).
 //   • PayloadField — the verify() field-tree shape; serialized into the emitted
 //     `verify:` literal so render()'s runtime drift check runs too.
-import { TYPE_OBJECT, TYPE_FIELD, TYPE_TEMPLATE, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, TEMPLATE_SUBTYPE_OUTPUT, TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_TEXT_REF, TEMPLATE_ATTR_FORMAT, TEMPLATE_ATTR_MAX_CHARS, TEMPLATE_ATTR_KIND, TEMPLATE_KIND_EMAIL, TEMPLATE_KIND_DEFAULT, TEMPLATE_ATTR_SUBJECT_REF, TEMPLATE_ATTR_HTML_BODY_REF, TEMPLATE_ATTR_TEXT_BODY_REF, } from "@metaobjectsdev/metadata";
+import { TYPE_OBJECT, TYPE_FIELD, TYPE_TEMPLATE, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, TEMPLATE_SUBTYPE_OUTPUT, TEMPLATE_ATTR_PAYLOAD_REF, TEMPLATE_ATTR_TEXT_REF, TEMPLATE_ATTR_FORMAT, TEMPLATE_ATTR_MAX_CHARS, TEMPLATE_ATTR_KIND, TEMPLATE_KIND_EMAIL, TEMPLATE_KIND_DEFAULT, TEMPLATE_ATTR_SUBJECT_REF, TEMPLATE_ATTR_HTML_BODY_REF, TEMPLATE_ATTR_TEXT_BODY_REF, refMatchesObject, } from "@metaobjectsdev/metadata";
 import { verify, ERR_REQUIRED_SLOT_UNUSED, } from "@metaobjectsdev/render";
 function findObject(root, name) {
-    return root.ownChildren().find((c) => c.type === TYPE_OBJECT && c.name === name);
+    return root.ownChildren().find((c) => c.type === TYPE_OBJECT && refMatchesObject(c, name));
 }
 function findTemplate(root, name) {
     return root.ownChildren().find((c) => c.type === TYPE_TEMPLATE && c.name === name);
@@ -133,7 +133,7 @@ export function renderRenderHelper(root, templateName, provider) {
             : "";
         return `import { render } from "@metaobjectsdev/render";
 import type { Provider, EmailDocument } from "@metaobjectsdev/render";
-import type { ${payloadRef} } from "./payloads.js";
+import type { ${payloadRef} } from "./${payloadRef}.js";
 
 /**
  * Render the ${templateName} email (subject + html body${typeof textBodyRef === "string" ? " + text body" : ""}) from a
@@ -165,7 +165,7 @@ export function ${fnName}(payload: ${payloadRef}, provider: Provider): EmailDocu
     const maxCharsArg = maxChars !== undefined && Number.isFinite(maxChars) ? `, maxChars: ${maxChars}` : "";
     return `import { render } from "@metaobjectsdev/render";
 import type { Provider } from "@metaobjectsdev/render";
-import type { ${payloadRef} } from "./payloads.js";
+import type { ${payloadRef} } from "./${payloadRef}.js";
 
 /**
  * Render the ${templateName} document from a typed ${payloadRef} payload. Wraps the

package/dist/templates/render-helper.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"routes-file.d.ts","sourceRoot":"","sources":["../../src/templates/routes-file.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM1D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAyJ/E"}
+{"version":3,"file":"routes-file.d.ts","sourceRoot":"","sources":["../../src/templates/routes-file.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA8K/E"}

package/dist/templates/routes-file.js

@@ -14,15 +14,24 @@
 // The user's Drizzle `db` instance is imported from ctx.dbImport (matching
 // the existing queries-file template). The entity's Drizzle table const is
 // imported alongside the Zod schemas + constants from the sibling Entity.ts.
-import { code, imp } from "ts-poet";
+import { code, imp, joinCode } from "ts-poet";
+import { TYPE_FIELD, resolveColumnName, } from "@metaobjectsdev/metadata";
 import {} from "../render-context.js";
-import { entityModuleSpecifier, relativeModuleSpecifier } from "../import-path.js";
+import { crossEntitySpecifier, entityModuleSpecifier, relativeModuleSpecifier } from "../import-path.js";
 import { GENERATED_HEADER } from "../constants.js";
-import { variableNameFromEntity } from "../naming.js";
+import { variableNameFromEntity, routesHandlerName } from "../naming.js";
 import { isProjection } from "../projection/projection-detector.js";
+import { isTphDiscriminatorBase, tphPlan } from "./tph-discriminator.js";
 export function renderRoutesFile(entity, ctx) {
+    // FR-017 Tier 2 — a TPH discriminator base mounts polymorphic list/get at the
+    // base path plus a full per-subtype CRUD route set scoped to each
+    // discriminator value. (Subtype entities are filtered out of the routes
+    // generator entirely — their routes live here.)
+    if (isTphDiscriminatorBase(entity, ctx.loadedRoot)) {
+        return renderTphRoutesFile(entity, ctx);
+    }
     const entityName = entity.name;
-    const handlerName = `${entityName.charAt(0).toLowerCase()}${entityName.slice(1)}Routes`;
+    const handlerName = routesHandlerName(entityName);
     // Import the entity's own file. Same target → relative "./Entity"; cross
     // target → importBase-qualified package path.
     const entityFileSpec = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, entity.package, entityName, ctx.extStyle);
@@ -93,6 +102,16 @@ export async function ${handlerName}(fastify: ${FastifyInstanceSym}) {
     const tableVar = variableNameFromEntity(entityName);
     const FastifyInstanceSym = imp("t:FastifyInstance@fastify");
     const mountCrudRoutesSym = imp("mountCrudRoutes@@metaobjectsdev/runtime-ts/drizzle-fastify");
+    // FR-018 M:N traversal: for each many-to-many navigation declared on this
+    // entity, emit a mountM2mRoute(...) that traverses the junction. The junction
+    // FK columns were derived from the junction's identity.reference children (the
+    // SSOT) by the relation-resolver pre-pass; here we resolve them to physical
+    // column names for the Drizzle two-stage join.
+    const m2mEntries = (ctx.relationMap.get(entityName) ?? []).filter((e) => e.junctionEntity !== undefined);
+    // Two fastify-scope variants: under an apiPrefix the mounts live inside the
+    // register-block (`instance`); otherwise they bind directly to `fastify`.
+    const m2mMountsPrefixed = renderM2mMounts(m2mEntries, entity, ctx, "instance");
+    const m2mMountsFlat = renderM2mMounts(m2mEntries, entity, ctx, "fastify");
     const literalImports = code `
 import { db } from ${JSON.stringify(dbImportSpec)};
 import {
@@ -127,7 +146,7 @@ export async function ${handlerName}(fastify: ${FastifyInstanceSym}) {
       sortAllowlist: ${entityName}SortAllowlist,
       dialect: ${JSON.stringify(ctx.dialect)},
     });
-  }, { prefix: ${JSON.stringify(ctx.apiPrefix)} });
+${m2mMountsPrefixed}  }, { prefix: ${JSON.stringify(ctx.apiPrefix)} });
 }
 `
         : code `
@@ -151,8 +170,166 @@ export async function ${handlerName}(fastify: ${FastifyInstanceSym}) {
     sortAllowlist: ${entityName}SortAllowlist,
     dialect: ${JSON.stringify(ctx.dialect)},
   });
-}
+${m2mMountsFlat}}
 `;
     return header + literalImports.toString() + body.toString();
 }
+/**
+ * Render the M:N traversal mounts for an entity as a single Code fragment to
+ * interpolate INTO the handler-body code template (so the junction/target table
+ * + mountM2mRoute imports hoist with the rest of the body's imports, not inline
+ * mid-function). `fastifyVar` is the in-scope Fastify reference (`instance`
+ * under an apiPrefix register-block, else `fastify`). Returns "" when the entity
+ * has no M:N relationships — CRUD-only output stays byte-identical to before.
+ */
+function renderM2mMounts(entries, source, ctx, fastifyVar) {
+    if (entries.length === 0)
+        return "";
+    const mounts = entries.map((e) => renderM2mMount(e, source, ctx, fastifyVar));
+    return code `${joinCode(mounts, { on: "\n", trim: false })}
+`;
+}
+/**
+ * Render one M:N traversal mount. The junction + target Drizzle table consts are
+ * imported from their sibling entity files (imp() lets ts-poet track + emit the
+ * import). The source/target FK columns + the target PK are resolved to PHYSICAL
+ * column names via resolveColumnName (the runtime two-stage join queries by
+ * column). mountM2mRoute appends `/:id/<relationName>` to the source $path.
+ */
+function renderM2mMount(entry, source, ctx, fastifyVar) {
+    const junctionVarSym = imp(`${variableNameFromEntity(entry.junctionEntity)}@${crossEntitySpecifier(ctx.outputLayout, source.package, ctx.packageOf.get(entry.junctionEntity), entry.junctionEntity, ctx.extStyle)}`);
+    const targetVarSym = imp(`${variableNameFromEntity(entry.targetEntity)}@${crossEntitySpecifier(ctx.outputLayout, source.package, ctx.packageOf.get(entry.targetEntity), entry.targetEntity, ctx.extStyle)}`);
+    const mountM2mRouteSym = imp("mountM2mRoute@@metaobjectsdev/runtime-ts/drizzle-fastify");
+    const junction = ctx.loadedRoot.findObject(entry.junctionEntity);
+    const target = ctx.loadedRoot.findObject(entry.targetEntity);
+    const sourceColumn = junction
+        ? resolveJunctionColumn(junction, entry.sourceJoinField, ctx)
+        : entry.sourceJoinField;
+    const targetColumn = junction
+        ? resolveJunctionColumn(junction, entry.targetJoinField, ctx)
+        : entry.targetJoinField;
+    const targetPkColumn = target
+        ? resolveJunctionColumn(target, ctx.pkMap.get(entry.targetEntity)?.fieldName ?? "id", ctx)
+        : "id";
+    return code `  ${mountM2mRouteSym}({
+    fastify: ${fastifyVar},
+    path: ${source.name}.$path,
+    relationName: ${JSON.stringify(entry.name)},
+    db,
+    junctionTable: ${junctionVarSym},
+    targetTable: ${targetVarSym},
+    sourceColumn: ${JSON.stringify(sourceColumn)},
+    targetColumn: ${JSON.stringify(targetColumn)},
+    targetPkColumn: ${JSON.stringify(targetPkColumn)},
+    symmetric: ${entry.symmetric ? "true" : "false"},
+  });`;
+}
+/** Resolve a field's physical column name on an entity (defaults if missing). */
+function resolveJunctionColumn(entity, fieldName, ctx) {
+    const field = entity.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === fieldName);
+    if (!field)
+        return fieldName;
+    return resolveColumnName(field, ctx.columnNamingStrategy);
+}
+/**
+ * FR-017 Tier 2 — the routes file for a TPH discriminator base.
+ *
+ * Mounts a polymorphic list/get route set at the base path (`GET /auths`,
+ * `GET /auths/:id` — rows carry the discriminator by value), then a full
+ * per-subtype CRUD route set at `<basePath>/<discriminatorValue lowercased>`
+ * (`/auths/bridge`, ...). The per-subtype create body OMITS the discriminator
+ * (the URL names the subtype); the runtime helper injects it. The per-subtype
+ * route set is scoped to its discriminator value via the `discriminator` option
+ * (cross-subtype get/update/delete 404; update strips the discriminator).
+ *
+ * Subtype route segment defaults to the lowercased `@discriminatorValue`
+ * (`"Bridge"` → `bridge`) — a robust, value-derived path that matches the
+ * FR-017 design's `/auths/bridge` examples. Fastify resolves the static
+ * `/auths/bridge` ahead of the parametric `/auths/:id`, so the two coexist.
+ */
+function renderTphRoutesFile(base, ctx) {
+    const baseName = base.name;
+    const handlerName = routesHandlerName(baseName);
+    // Single source of truth for the discriminator field + subtypes + route segments.
+    const plan = tphPlan(base, ctx.loadedRoot);
+    const discField = plan.discriminatorField;
+    const tableVar = variableNameFromEntity(baseName);
+    const baseFileSpec = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, base.package, baseName, ctx.extStyle);
+    const dbImportSpec = relativeModuleSpecifier(ctx.outputLayout, base.package, ctx.dbImport);
+    const FastifyInstanceSym = imp("t:FastifyInstance@fastify");
+    const mountCrudRoutesSym = imp("mountCrudRoutes@@metaobjectsdev/runtime-ts/drizzle-fastify");
+    const dbSym = imp(`db@${dbImportSpec}`);
+    const tableSym = imp(`${tableVar}@${baseFileSpec}`);
+    const baseConstSym = imp(`${baseName}@${baseFileSpec}`);
+    const baseInsertSym = imp(`${baseName}InsertSchema@${baseFileSpec}`);
+    const baseUpdateSym = imp(`${baseName}UpdateSchema@${baseFileSpec}`);
+    const baseFilterSym = imp(`${baseName}FilterAllowlist@${baseFileSpec}`);
+    const baseSortSym = imp(`${baseName}SortAllowlist@${baseFileSpec}`);
+    const fastifyRef = ctx.apiPrefix ? "instance" : "fastify";
+    const dialectLit = JSON.stringify(ctx.dialect);
+    const polymorphic = code `
+    ${mountCrudRoutesSym}({
+      fastify: ${fastifyRef},
+      path: ${baseConstSym}.$path,
+      db: ${dbSym},
+      table: ${tableSym},
+      insertSchema: ${baseInsertSym},
+      updateSchema: ${baseUpdateSym},
+      filterAllowlist: ${baseFilterSym},
+      sortAllowlist: ${baseSortSym},
+      dialect: ${dialectLit},
+      expose: ["list", "get"],
+    });`;
+    const subtypeMounts = plan.subtypes.map(({ entity: sub, value, routeSegment: segment }) => {
+        const subFileSpec = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, sub.package, sub.name, ctx.extStyle);
+        const subInsertSym = imp(`${sub.name}InsertSchema@${subFileSpec}`);
+        // FR-017 Tier 3: each subtype carries its OWN filter/sort allowlist
+        // (discriminator excluded — it's pinned by this path).
+        const subFilterSym = imp(`${sub.name}FilterAllowlist@${subFileSpec}`);
+        const subSortSym = imp(`${sub.name}SortAllowlist@${subFileSpec}`);
+        return code `
+    ${mountCrudRoutesSym}({
+      fastify: ${fastifyRef},
+      path: ${baseConstSym}.$path + ${JSON.stringify("/" + segment)},
+      db: ${dbSym},
+      table: ${tableSym},
+      insertSchema: ${subInsertSym}.omit({ ${discField}: true }),
+      updateSchema: ${subInsertSym}.omit({ ${discField}: true }).partial(),
+      filterAllowlist: ${subFilterSym},
+      sortAllowlist: ${subSortSym},
+      dialect: ${dialectLit},
+      discriminator: { column: ${JSON.stringify(discField)}, value: ${JSON.stringify(value)} },
+    });`;
+    });
+    const mounts = joinCode([polymorphic, ...subtypeMounts], { on: "\n" });
+    const fn = ctx.apiPrefix
+        ? code `
+/**
+ * Mount polymorphic + per-subtype REST endpoints for the ${baseName} TPH hierarchy.
+ *
+ * GET ${baseName}.$path (+ /:id) lists/gets the discriminated union; each
+ * /${baseName}.$path/<subtype> path is a full per-subtype CRUD set.
+ */
+export async function ${handlerName}(fastify: ${FastifyInstanceSym}) {
+  await fastify.register(async (instance) => {
+${mounts}
+  }, { prefix: ${JSON.stringify(ctx.apiPrefix)} });
+}
+`
+        : code `
+/**
+ * Mount polymorphic + per-subtype REST endpoints for the ${baseName} TPH hierarchy.
+ *
+ * GET ${baseName}.$path (+ /:id) lists/gets the discriminated union; each
+ * /${baseName}.$path/<subtype> path is a full per-subtype CRUD set.
+ */
+export async function ${handlerName}(fastify: ${FastifyInstanceSym}) {
+${mounts}
+}
+`;
+    const header = `// ${GENERATED_HEADER} — DO NOT EDIT.\n` +
+        `// Source metadata: ${baseName} (${base.fqn()}) — TPH discriminator base\n` +
+        `// Customize via ${baseName}.extra.ts in this directory (e.g., auth, additional handlers).\n`;
+    return header + fn.toString();
+}
 //# sourceMappingURL=routes-file.js.map

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

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

package/dist/templates/tph-discriminator.d.ts

@@ -0,0 +1,56 @@
+import { type Code } from "ts-poet";
+import { type MetaObject, type MetaField, type MetaRoot } from "@metaobjectsdev/metadata";
+/** One concrete subtype in a {@link TphPlan}. */
+export interface TphSubtypePlan {
+    /** The concrete subtype entity. */
+    entity: MetaObject;
+    /** Its `@discriminatorValue`. */
+    value: string;
+    /** The per-subtype REST route segment (e.g. `"bridge"`). The ONE place this
+     *  rule is derived — see {@link tphRouteSegment}. */
+    routeSegment: string;
+}
+/**
+ * The single source of truth for a TPH base's polymorphic shape: the
+ * discriminator field name, the concrete subtypes (stable name-sorted order),
+ * each subtype's `@discriminatorValue`, and its per-subtype route segment.
+ *
+ * Every generator in the stack (entity, queries, routes, hooks, grid, forms)
+ * derives its TPH behavior from this one model rather than re-walking the root
+ * and re-deriving the segment / write-shape independently — so the route-segment
+ * rule and subtype set can never drift between, say, the generated routes and
+ * the generated hooks that call them.
+ */
+export interface TphPlan {
+    base: MetaObject;
+    discriminatorField: string;
+    subtypes: TphSubtypePlan[];
+}
+/** The per-subtype REST route segment for a discriminator value. The ONE place
+ *  this rule lives: `routesFile` and the TanStack hooks both read it through the
+ *  plan, so generated hooks can't call a URL the generated routes don't serve. */
+export declare function tphRouteSegment(discriminatorValue: string): string;
+/** The {@link TphPlan} for a discriminator base, or `null` when `base` is not a
+ *  discriminator base (no `@discriminator`, or no concrete subtypes). */
+export declare function tphPlan(base: MetaObject, root: MetaRoot): TphPlan | null;
+/** True when this entity is a TPH discriminator base — it carries
+ *  `@discriminator` AND at least one concrete subtype declares
+ *  `@discriminatorValue` extending it. This is the predicate the generator
+ *  stack uses to switch into single-table-inheritance emission. */
+export declare function isTphDiscriminatorBase(obj: MetaObject, root: MetaRoot): boolean;
+/** The concrete subtypes bound to this discriminator base, in stable
+ *  (name-sorted) order. Returns `[]` when `base` is not a discriminator base. */
+export declare function tphConcreteSubtypes(base: MetaObject, root: MetaRoot): MetaObject[];
+/**
+ * The subtype-only fields that must be folded into the base's single TPH table.
+ * For each concrete subtype, every effective field NOT already on the base is
+ * collected (effective, so fields declared on abstract intermediate levels of a
+ * multi-level hierarchy are captured too). Deduplicated by field name across
+ * subtypes — two subtypes sharing a column name contribute one column. The
+ * caller emits each as a nullable column (rows of other subtypes store NULL).
+ */
+export declare function collectTphSubtypeFields(base: MetaObject, root: MetaRoot): MetaField[];
+/** Render the TPH union + guards + dispatcher block, or null when the entity
+ *  is not a discriminator-bearing base with at least one concrete subtype. */
+export declare function renderTphDiscriminatorUnion(base: MetaObject, root: MetaRoot): Code | null;
+//# sourceMappingURL=tph-discriminator.d.ts.map

package/dist/templates/tph-discriminator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tph-discriminator.d.ts","sourceRoot":"","sources":["../../src/templates/tph-discriminator.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EAId,MAAM,0BAA0B,CAAC;AAOlC,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;yDACqD;IACrD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAOD;;kFAEkF;AAClF,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;yEACyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAqBxE;AAED;;;mEAGmE;AACnE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE/E;AAED;iFACiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAElF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,CAgBrF;AAED;8EAC8E;AAC9E,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,QAAQ,GACb,IAAI,GAAG,IAAI,CA0Db"}

package/dist/templates/tph-discriminator.js

@@ -0,0 +1,180 @@
+// FR-017 Tier 1 — TS discriminated-union + type guards + dispatcher emission.
+//
+// For an entity that carries `@discriminator`, this template emits:
+//   1. `export type <Base> = <Sub1> | <Sub2> | ...` — discriminated union of
+//      every concrete subtype declaring @discriminatorValue against this base.
+//   2. `export function is<Sub>(value: <Base>): value is <Sub>` — one type
+//      guard per subtype, checking the discriminator field's value.
+//   3. `export function parse<Base>(row: unknown): <Base>` — runtime dispatcher
+//      that reads the discriminator off the raw row and parses with the
+//      matching subtype's Zod schema.
+//
+// When the entity does NOT carry @discriminator, returns null. When the entity
+// carries @discriminator but has no concrete subtypes yet (refactor-in-progress
+// shape — covered by FR-014 fixture `tph-discriminator-string-no-subtypes`),
+// returns null too: there are no subtype names to union.
+import { code, joinCode, imp } from "ts-poet";
+import { OBJECT_ATTR_DISCRIMINATOR, OBJECT_ATTR_DISCRIMINATOR_VALUE, OBJECT_SUBTYPE_ENTITY, } from "@metaobjectsdev/metadata";
+// Memoized per base instance — the plan is pure over the (immutable, fully
+// resolved) post-load model, and a base belongs to exactly one root, so caching
+// by the base node identity is safe and erases the repeated root walks.
+const _tphPlanCache = new WeakMap();
+/** The per-subtype REST route segment for a discriminator value. The ONE place
+ *  this rule lives: `routesFile` and the TanStack hooks both read it through the
+ *  plan, so generated hooks can't call a URL the generated routes don't serve. */
+export function tphRouteSegment(discriminatorValue) {
+    return discriminatorValue.toLowerCase();
+}
+/** The {@link TphPlan} for a discriminator base, or `null` when `base` is not a
+ *  discriminator base (no `@discriminator`, or no concrete subtypes). */
+export function tphPlan(base, root) {
+    const cached = _tphPlanCache.get(base);
+    if (cached !== undefined)
+        return cached;
+    const discriminatorField = base.ownAttr(OBJECT_ATTR_DISCRIMINATOR);
+    let plan = null;
+    if (typeof discriminatorField === "string" && discriminatorField !== "") {
+        const bindings = collectConcreteSubtypes(base, root);
+        if (bindings.length > 0) {
+            plan = {
+                base,
+                discriminatorField,
+                subtypes: bindings.map((b) => ({
+                    entity: b.subtype,
+                    value: b.value,
+                    routeSegment: tphRouteSegment(b.value),
+                })),
+            };
+        }
+    }
+    _tphPlanCache.set(base, plan);
+    return plan;
+}
+/** True when this entity is a TPH discriminator base — it carries
+ *  `@discriminator` AND at least one concrete subtype declares
+ *  `@discriminatorValue` extending it. This is the predicate the generator
+ *  stack uses to switch into single-table-inheritance emission. */
+export function isTphDiscriminatorBase(obj, root) {
+    return tphPlan(obj, root) !== null;
+}
+/** The concrete subtypes bound to this discriminator base, in stable
+ *  (name-sorted) order. Returns `[]` when `base` is not a discriminator base. */
+export function tphConcreteSubtypes(base, root) {
+    return tphPlan(base, root)?.subtypes.map((s) => s.entity) ?? [];
+}
+/**
+ * The subtype-only fields that must be folded into the base's single TPH table.
+ * For each concrete subtype, every effective field NOT already on the base is
+ * collected (effective, so fields declared on abstract intermediate levels of a
+ * multi-level hierarchy are captured too). Deduplicated by field name across
+ * subtypes — two subtypes sharing a column name contribute one column. The
+ * caller emits each as a nullable column (rows of other subtypes store NULL).
+ */
+export function collectTphSubtypeFields(base, root) {
+    const discFieldName = base.ownAttr(OBJECT_ATTR_DISCRIMINATOR);
+    if (typeof discFieldName !== "string" || discFieldName === "")
+        return [];
+    const baseFieldNames = new Set(base.fields().map((f) => f.name));
+    const seen = new Set();
+    const out = [];
+    for (const { subtype } of collectConcreteSubtypes(base, root)) {
+        for (const f of subtype.fields()) {
+            if (baseFieldNames.has(f.name))
+                continue; // base column — already emitted
+            if (seen.has(f.name))
+                continue; // shared subtype column — emit once
+            seen.add(f.name);
+            out.push(f);
+        }
+    }
+    return out;
+}
+/** Render the TPH union + guards + dispatcher block, or null when the entity
+ *  is not a discriminator-bearing base with at least one concrete subtype. */
+export function renderTphDiscriminatorUnion(base, root) {
+    const discFieldName = base.ownAttr(OBJECT_ATTR_DISCRIMINATOR);
+    if (typeof discFieldName !== "string" || discFieldName === "")
+        return null;
+    const subtypes = collectConcreteSubtypes(base, root);
+    if (subtypes.length === 0)
+        return null;
+    const baseName = base.name;
+    // 1. Union type alias. Subtype names are imported lazily via ts-poet `imp()`
+    //    so they resolve cross-module without manual import wiring.
+    const unionMembers = subtypes.map((b) => {
+        const sub = imp(`t:${b.subtype.name}@./${b.subtype.name}.js`);
+        return code `${sub}`;
+    });
+    const unionType = code `export type ${baseName} = ${joinCode(unionMembers, { on: " | " })};`;
+    // 2. Type guards.
+    const guards = subtypes.map((b) => {
+        const sub = imp(`t:${b.subtype.name}@./${b.subtype.name}.js`);
+        return code `
+/** True when value is a ${b.subtype.name} (discriminated by ${discFieldName} === "${b.value}"). */
+export function is${b.subtype.name}(value: ${baseName}): value is ${sub} {
+  return value.${discFieldName} === "${b.value}";
+}`;
+    });
+    // 3. Dispatcher. The head-read uses z.object so the discriminator is read
+    //    without committing the row to any subtype yet.
+    const z = imp("z@zod");
+    const enumLiterals = subtypes.map((b) => JSON.stringify(b.value)).join(", ");
+    const caseBranches = subtypes.map((b) => {
+        const schema = imp(`${b.subtype.name}Schema@./${b.subtype.name}.js`);
+        return code `    case ${JSON.stringify(b.value)}: return ${schema}.parse(row);`;
+    });
+    const dispatcher = code `
+/**
+ * Parse a row from the ${baseName} table, dispatching by the
+ * \`${discFieldName}\` discriminator value to the matching subtype's
+ * Zod schema. Throws on unknown discriminator values.
+ */
+export function parse${baseName}(row: unknown): ${baseName} {
+  const head = ${z}.object({ ${discFieldName}: ${z}.enum([${enumLiterals}]) }).parse(row);
+  switch (head.${discFieldName}) {
+${joinCode(caseBranches, { on: "\n" })}
+  }
+}
+`;
+    return code `
+${unionType}
+
+${joinCode(guards, { on: "\n" })}
+
+${dispatcher}
+`;
+}
+/** Walk every top-level object.entity in the root and return the concrete
+ *  subtypes whose @discriminatorValue is bound to this base via extends.
+ *  Abstract intermediates are skipped (they don't have polymorphic instances). */
+function collectConcreteSubtypes(base, root) {
+    const bindings = [];
+    for (const obj of root.objects()) {
+        if (obj.subType !== OBJECT_SUBTYPE_ENTITY)
+            continue;
+        if (obj.isAbstract === true)
+            continue;
+        if (obj === base)
+            continue;
+        const value = obj.ownAttr(OBJECT_ATTR_DISCRIMINATOR_VALUE);
+        if (typeof value !== "string" || value === "")
+            continue;
+        // Walk this entity's extends chain looking for `base`.
+        let cursor = obj.superResolved;
+        let found = false;
+        while (cursor !== undefined) {
+            if (cursor === base) {
+                found = true;
+                break;
+            }
+            cursor = cursor.superResolved;
+        }
+        if (!found)
+            continue;
+        bindings.push({ subtype: obj, value });
+    }
+    // Stable order by subtype name so emission is deterministic.
+    bindings.sort((a, b) => a.subtype.name.localeCompare(b.subtype.name));
+    return bindings;
+}
+//# sourceMappingURL=tph-discriminator.js.map

package/dist/templates/tph-discriminator.js.map

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

package/dist/templates/value-object-file.d.ts

@@ -1,3 +1,4 @@
 import type { MetaObject } from "@metaobjectsdev/metadata";
-export declare function renderValueObjectFile(obj: MetaObject): string;
+import type { RenderContext } from "../render-context.js";
+export declare function renderValueObjectFile(obj: MetaObject, apiPrefix?: string, ctx?: RenderContext): string;
 //# sourceMappingURL=value-object-file.d.ts.map

package/dist/templates/value-object-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-object-file.d.ts","sourceRoot":"","sources":["../../src/templates/value-object-file.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAa7D"}
+{"version":3,"file":"value-object-file.d.ts","sourceRoot":"","sources":["../../src/templates/value-object-file.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,SAAK,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,MAAM,CAsClG"}

package/dist/templates/value-object-file.js

@@ -9,14 +9,42 @@
 // handled by the projection path before this one is reached).
 import { joinCode } from "ts-poet";
 import { renderValueObjectInterface, renderEnumTypeAliases } from "./inferred-types.js";
-import { renderInsertSchemaOnly } from "./zod-validators.js";
+import { renderInsertSchemaOnly, isTphSubtype, renderTphSubtypeReadSchema, tphDiscriminatorPin, } from "./zod-validators.js";
+import { renderEntityConstants } from "./entity-constants.js";
+import { renderFilterAllowlist, renderSortAllowlist } from "./filter-allowlist.js";
+import { renderFilterType } from "./filter-type.js";
 import { GENERATED_HEADER } from "../constants.js";
-export function renderValueObjectFile(obj) {
-    const enumAliases = renderEnumTypeAliases(obj);
+export function renderValueObjectFile(obj, apiPrefix = "", ctx) {
+    const enumAliases = renderEnumTypeAliases(obj, ctx);
+    // FR-017 Tier 2: a TPH subtype lands here (it inherits the base's source.rdb
+    // but declares none of its own). In addition to the insert schema it emits a
+    // full read schema `<Sub>Schema` so parse<Base>(row) can dispatch to it.
+    const tphSubtype = isTphSubtype(obj);
+    const tphReadSchema = tphSubtype ? renderTphSubtypeReadSchema(obj) : null;
+    // FR-017 Tier 3: a TPH subtype also emits its field-metadata constants object
+    // (the `<Sub>` const), so the React form generator can render per-field
+    // labels / rules / inputs the same way it does for ordinary entities.
+    const tphConstants = tphSubtype ? renderEntityConstants(obj, apiPrefix) : null;
+    // FR-017 Tier 3: per-subtype filter + sort allowlists, excluding the
+    // discriminator (it's pinned by the per-subtype route path, so a client must
+    // not filter on it). Included fields are the subtype's own + inherited base
+    // filterable fields. Drives the per-subtype REST routes' filter layer.
+    const discField = tphSubtype ? tphDiscriminatorPin(obj)?.fieldName : undefined;
+    const tphFilterAllowlist = tphSubtype ? renderFilterAllowlist(obj, discField) : null;
+    const tphSortAllowlist = tphSubtype ? renderSortAllowlist(obj, discField) : null;
+    // FR-017 Tier 3: the per-subtype CLIENT filter type, discriminator-excluded —
+    // kept in lockstep with the per-subtype allowlist above so a typed
+    // `<Sub>Filter` can't express a filter the server allowlist would 400.
+    const tphFilterType = tphSubtype ? renderFilterType(obj, discField) : null;
     const sections = [
-        renderValueObjectInterface(obj),
+        renderValueObjectInterface(obj, ctx),
         ...(enumAliases !== null ? [enumAliases] : []),
+        ...(tphReadSchema !== null ? [tphReadSchema] : []),
         renderInsertSchemaOnly(obj),
+        ...(tphConstants !== null ? [tphConstants] : []),
+        ...(tphFilterAllowlist !== null ? [tphFilterAllowlist] : []),
+        ...(tphSortAllowlist !== null ? [tphSortAllowlist] : []),
+        ...(tphFilterType !== null ? [tphFilterType] : []),
     ];
     const body = joinCode(sections, { on: "\n" }).toString();
     const header = `// ${GENERATED_HEADER} — DO NOT EDIT.\n` +