@metaobjectsdev/codegen-ts 0.7.0-rc.8 → 0.7.0

package/dist/templates/docs-file.js

@@ -0,0 +1,37 @@
+// Backward-compatible facade over the rc.12+ template-driven docsFile()
+// implementation. The Markdown structure now lives in
+// `templates/docs/entity-page.md.mustache`; this module preserves the
+// `renderDocsFile()` + `DocsRenderOpts` exports so the per-section unit
+// tests in `test/templates/docs-file.test.ts` keep working without
+// modification.
+//
+// Adopters writing custom docs templates should import the public surface
+// from `@metaobjectsdev/codegen-ts/generators` instead:
+//   - `buildEntityDocData(entity, opts)` for the typed data dict
+//   - `templateGenerator({ template: "docs/entity-page.md", ... })` for the
+//     standard end-to-end generator
+import { render } from "@metaobjectsdev/render";
+import { buildEntityDocData } from "../generators/docs-data-builder.js";
+import { frameworkTemplatesProvider } from "../render-engine/framework-provider.js";
+/** Backward-compatible entry point: builds the EntityDocData payload and
+ *  renders it via the framework template. Byte-identical to the hand-coded
+ *  rc.11 output (gated by `docs-file-conformance.test.ts`). */
+export function renderDocsFile(entity, opts) {
+    const data = buildEntityDocData(entity, {
+        dialect: opts.dialect,
+        ...(opts.columnNamingStrategy !== undefined
+            ? { columnNamingStrategy: opts.columnNamingStrategy }
+            : {}),
+        loadedRoot: opts.loadedRoot,
+        ...(opts.generatorNames !== undefined
+            ? { generatorNames: opts.generatorNames }
+            : {}),
+    });
+    return render({
+        ref: "docs/entity-page.md",
+        payload: data,
+        provider: frameworkTemplatesProvider,
+        format: "markdown",
+    });
+}
+//# sourceMappingURL=docs-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-file.js","sourceRoot":"","sources":["../../src/templates/docs-file.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sDAAsD;AACtD,sEAAsE;AACtE,wEAAwE;AACxE,mEAAmE;AACnE,gBAAgB;AAChB,EAAE;AACF,0EAA0E;AAC1E,wDAAwD;AACxD,iEAAiE;AACjE,4EAA4E;AAC5E,oCAAoC;AAKpC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAYpF;;+DAE+D;AAC/D,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,IAAoB;IACrE,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE;QACtC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,oBAAoB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;QACP,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;QACZ,GAAG,EAAE,qBAAqB;QAC1B,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,0BAA0B;QACpC,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { MetaObject } from "@metaobjectsdev/metadata";
+import { type RenderContext } from "../render-context.js";
+export declare function renderRoutesFileHono(entity: MetaObject, ctx: RenderContext): string;
+//# sourceMappingURL=routes-file-hono.d.ts.map

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

@@ -0,0 +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;AAM1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA2GnF"}

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

@@ -0,0 +1,119 @@
+// Hono route template — emits a per-entity routes file that delegates
+// CRUD verbs to helpers from @metaobjectsdev/runtime-ts/hono.
+//
+// Hono parallel of templates/routes-file.ts. Two emit-shape differences
+// vs the Fastify flavor, both reflecting Hono idioms rather than contract
+// drift:
+//
+//   1) Exported function shape — `registerXxxRoutes(app, deps)` instead of
+//      `xxxRoutes(fastify)`. Workers/Bun consumers typically pass `db`
+//      through a per-request deps object (so a Worker can attach the
+//      D1 client pulled off bindings) rather than reaching for a
+//      module-level singleton. The Fastify flavor uses `import { db }`
+//      because Fastify apps are long-lived Node processes where a
+//      singleton is the norm. Both flavors talk to mountCrudRoutes /
+//      mountReadOnlyCrudRoutes with identical wire behavior.
+//
+//   2) apiPrefix is composed into the resource path (`${apiPrefix}${path}`)
+//      rather than wrapping the registration. Hono has no fastify.register
+//      / prefix-wrapping primitive; sub-apps via `app.route(prefix, sub)`
+//      exist but bloat the generated code. String concat is simpler and
+//      produces identical URL grammar.
+//
+// Dispatch logic mirrors Fastify:
+//   isProjection(entity)              → mountReadOnlyCrudRoutes (GET list + GET :id)
+//   vanilla / write-through entity    → mountCrudRoutes (all 5 CRUD verbs)
+import { code, imp } from "ts-poet";
+import {} from "../render-context.js";
+import { entityModuleSpecifier } from "../import-path.js";
+import { GENERATED_HEADER } from "../constants.js";
+import { variableNameFromEntity } from "../naming.js";
+import { isProjection } from "../projection/projection-detector.js";
+export function renderRoutesFileHono(entity, ctx) {
+    const entityName = entity.name;
+    const handlerName = `register${entityName}Routes`;
+    const entityFileSpec = entityModuleSpecifier(ctx.selfTarget, ctx.entityModuleTarget, entity.package, entityName, ctx.extStyle);
+    const header = `// ${GENERATED_HEADER} — DO NOT EDIT.\n` +
+        `// Source metadata: ${entityName} (${entity.fqn()})\n` +
+        `// Customize via ${entityName}.extra.ts in this directory (e.g., auth, additional handlers).\n`;
+    // Path composition: apiPrefix is a literal string in the URL.
+    const pathExpr = ctx.apiPrefix
+        ? `\`${ctx.apiPrefix}\${${entityName}.$path}\``
+        : `${entityName}.$path`;
+    // --- Projection path: read-only routes (GET list + GET :id) ---
+    if (isProjection(entity)) {
+        const camelName = entityName.charAt(0).toLowerCase() + entityName.slice(1);
+        const HonoSym = imp("t:Hono@hono");
+        const mountReadOnlyCrudRoutesSym = imp("mountReadOnlyCrudRoutes@@metaobjectsdev/runtime-ts/hono");
+        const literalImports = code `
+import {
+  ${entityName},
+  ${camelName}View,
+  ${entityName}FilterAllowlist,
+  ${entityName}SortAllowlist,
+} from ${JSON.stringify(entityFileSpec)};
+`;
+        const body = code `
+/**
+ * Mount read-only REST endpoints for ${entityName} (projection — view-backed, no writes).
+ *
+ * Exposes GET list + GET :id only. POST/PATCH/DELETE return 405.
+ * Customize: register this as-is, or import individual route helpers from
+ * @metaobjectsdev/runtime-ts/hono.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: consumer-defined Hono bindings/variables
+export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unknown }): void {
+  ${mountReadOnlyCrudRoutesSym}({
+    app,
+    path: ${pathExpr},
+    db: deps.db,
+    view: ${camelName}View,
+    filterAllowlist: ${entityName}FilterAllowlist,
+    sortAllowlist: ${entityName}SortAllowlist,
+    dialect: ${JSON.stringify(ctx.dialect)},
+  });
+}
+`;
+        return header + literalImports.toString() + body.toString();
+    }
+    // --- Vanilla / write-through entity path: full CRUD routes ---
+    const tableVar = variableNameFromEntity(entityName);
+    const HonoSym = imp("t:Hono@hono");
+    const mountCrudRoutesSym = imp("mountCrudRoutes@@metaobjectsdev/runtime-ts/hono");
+    const literalImports = code `
+import {
+  ${entityName},
+  ${tableVar},
+  ${entityName}InsertSchema,
+  ${entityName}UpdateSchema,
+  ${entityName}FilterAllowlist,
+  ${entityName}SortAllowlist,
+} from ${JSON.stringify(entityFileSpec)};
+`;
+    const body = code `
+/**
+ * Mount the 5 standard REST endpoints for ${entityName} using Drizzle directly.
+ *
+ * Customize: register this as-is for stock CRUD, OR import the per-verb
+ * helpers (mountListRoute, mountGetRoute, ...) from
+ * @metaobjectsdev/runtime-ts/hono and mix with your own handlers
+ * (auth, side effects, etc.).
+ */
+// biome-ignore lint/suspicious/noExplicitAny: consumer-defined Hono bindings/variables
+export function ${handlerName}(app: ${HonoSym}<any, any, any>, deps: { db: unknown }): void {
+  ${mountCrudRoutesSym}({
+    app,
+    path: ${pathExpr},
+    db: deps.db,
+    table: ${tableVar},
+    insertSchema: ${entityName}InsertSchema,
+    updateSchema: ${entityName}UpdateSchema,
+    filterAllowlist: ${entityName}FilterAllowlist,
+    sortAllowlist: ${entityName}SortAllowlist,
+    dialect: ${JSON.stringify(ctx.dialect)},
+  });
+}
+`;
+    return header + literalImports.toString() + body.toString();
+}
+//# sourceMappingURL=routes-file-hono.js.map

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

@@ -0,0 +1 @@
+{"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.7.0-rc.8",
+  "version": "0.7.0",
   "description": "TypeScript codegen engine for MetaObjects — emits Drizzle, Zod, and Fastify artifacts.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
       "default": "./dist/generators/index.js"
     }
   },
-  "files": ["dist", "src", "README.md", "LICENSE"],
+  "files": ["dist", "src", "templates", "README.md", "LICENSE"],
   "scripts": {
     "build": "tsc -p .",
     "typecheck": "tsc -p tsconfig.typecheck.json"
@@ -38,7 +38,8 @@
 "access": "public"
 },
 "dependencies": {
-  "@metaobjectsdev/metadata": "0.7.0-rc.8",
+  "@metaobjectsdev/metadata": "0.7.0",
+  "@metaobjectsdev/render": "0.7.0",
   "@biomejs/js-api": "^0.7.0",
   "@biomejs/wasm-nodejs": "^1.9.4",
   "ts-poet": "^6.10.0"
@@ -49,10 +50,10 @@
 },
 "devDependencies": {
   "@biomejs/biome": "^1.9.0",
-  "@metaobjectsdev/codegen-ts-react": "0.7.0-rc.8",
-  "@metaobjectsdev/render": "0.7.0-rc.8",
+  "@metaobjectsdev/codegen-ts-react": "0.7.0",
   "bun-types": "latest",
   "drizzle-orm": "^0.36.0",
+  "hono": "^4.6.0",
   "typescript": "^5.6.0",
   "zod": "^3.23.0"
 }

package/src/generator.ts

@@ -24,6 +24,15 @@ export interface GenContext {
    *  present at run time when invoked via runGen(); optional in the type
    *  so tests and custom callers don't need a placeholder. */
   renderContext?: RenderContext;
+  /** Resolved absolute project root — what the runner derives from
+   *  `opts.projectRoot` (the directory holding `.metaobjects/config.json`).
+   *  Generators that resolve project-scoped resources (e.g.
+   *  `templateGenerator` looking up the project's `templates/` directory)
+   *  should read this rather than `process.cwd()`, which is whatever
+   *  directory the CLI was invoked from and breaks when `meta gen` runs
+   *  in a sub-directory. Undefined only when the runner was driven
+   *  programmatically without an explicit projectRoot. */
+  projectRoot?: string;
   warn: (msg: string) => void;
 }