@metaobjectsdev/codegen-ts 0.5.0-rc.1

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other transformations
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of recording and
+      discussing modifications to the Work, but excluding communication that
+      is conspicuously marked or designated in writing by the copyright owner
+      as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or contributory
+      patent infringement, then any patent licenses granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, reproduce, modify,
+      prepare derivative works of, distribute, and sublicense such modifications,
+      as an additional requirement of this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer
+      only obligations consistent to this License provided that the
+      obligations are consistent with this License.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format in question. Also add information
+      on how to contact you electronically and/or by mail.
+
+      Copyright 2026 MetaObjects Contributors
+
+      Licensed under the Apache License, Version 2.0 (the "License");
+      you may not use this file except in compliance with the License.
+      You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+      See the License for the specific language governing permissions and
+      limitations under the License.

package/README.md

@@ -0,0 +1,101 @@
+# @metaobjectsdev/codegen-ts
+
+TypeScript codegen for the metaobjects metamodel — emits Drizzle schema +
+inferred types + Zod validators + typed CRUD queries from a loaded `MetaData`.
+
+## Install
+
+```bash
+npm install @metaobjectsdev/codegen-ts @metaobjectsdev/metadata drizzle-orm zod
+```
+
+## Usage
+
+```typescript
+import { FileMetaDataLoader } from "@metaobjectsdev/metadata/core";
+import { generate } from "@metaobjectsdev/codegen-ts";
+
+const loader = new FileMetaDataLoader();
+const { root } = await loader.loadFiles(["metaobjects/meta.blog.json"]);
+
+const result = await generate({
+  metadata: root,
+  outDir: "./src/db/entities",
+  dialect: "sqlite",
+  dbImport: "~/server/db",  // path to your { db } export
+});
+
+for (const f of result.files) console.log(f.status, f.path);
+```
+
+## Output
+
+Per entity, codegen emits **two files**:
+
+- `<Entity>.ts` — Drizzle table definition (with FK `.references()` + `relations()` blocks
+  auto-emitted from metadata relationships) + Drizzle-inferred types + Zod validators
+- `<Entity>.queries.ts` — typed CRUD query functions with prepared statements
+  (`findPostById`, `listPosts`, `createPost`, `updatePost`, `deletePostById`)
+
+Plus a barrel `index.ts` re-exporting from each `<Entity>.ts`.
+
+```typescript
+// Use the entity types and table:
+import { posts, type Post, PostInsertSchema } from './db/entities/Post.js';
+
+// Use the typed CRUD queries:
+import { findPostById, createPost } from './db/entities/Post.queries.js';
+
+const post = await findPostById(42);
+const newPost = await createPost({ title: 'Hello', body: 'World', authorId: 1 });
+```
+
+Generated files carry an `@generated by @metaobjectsdev/codegen-ts` header.
+codegen-ts overwrites files with the header but refuses to touch files
+without it. Hand-customizations live in sibling `<Entity>.extra.ts` files
+(for custom queries, derived-column indexes, etc. that metadata can't express).
+
+## Output targets
+
+Each generator can be routed to its own output directory via a named **target**
+(see the CLI's `defineConfig` — `@metaobjectsdev/cli` README, "Multiple output
+targets"). The runner gives every generator a `RenderContext` carrying its own
+`selfTarget` and the shared `entityModuleTarget` (where `entityFile()` output
+lives), then writes each emitted file under its target's `outDir` (collisions are
+keyed on the resolved full path, so the same filename in two targets is fine).
+
+Templates resolve the entity-module import through `entityModuleSpecifier(selfTarget,
+entityModuleTarget, pkg, name, extStyle)`:
+
+- **same target** → relative (`./Program`), honoring `extStyle`
+- **cross target** → extension-less package path from the entity-module target's
+  `importBase` (`@acme/database/generated/acme/commerce/Program`)
+
+Companion helpers: `siblingSpecifier` (same-target sibling module, e.g.
+`<Entity>.columns`) and `barrelModuleSpecifier` (barrel re-exports). A generator
+declares it produces the entity module with `emitsEntityModule: true` (set by
+`entityFile()`); the runner derives the entity-module target from it. With a single
+target, every specifier takes the relative branch, so output is unchanged.
+
+## Dialects
+
+- `sqlite` — emits `sqliteTable`, `text`, `integer`, etc. from `drizzle-orm/sqlite-core`
+- `postgres` — emits `pgTable`, `varchar`, `bigint`, etc. from `drizzle-orm/pg-core`
+
+## Driver compatibility
+
+Generated `<Entity>.queries.ts` files use Drizzle's `.returning()` API in
+`create*` and `update*` functions. This works on:
+
+- `libsql` / Turso
+- `node-postgres` (`pg`)
+- `@neondatabase/serverless`
+
+It does **not** work on `better-sqlite3` or `bun:sqlite` (no native
+`RETURNING` support). Users on those drivers should override the affected
+functions in the sibling `<Entity>.extra.ts` file with a non-`.returning()`
+form, or switch to a supported driver.
+
+## License
+
+Apache-2.0.

package/dist/column-mapper.d.ts

@@ -0,0 +1,38 @@
+import type { MetaField } from "@metaobjectsdev/metadata";
+import type { Dialect, ColumnNamingStrategy } from "./metaobjects-config.js";
+export type { Dialect };
+/**
+ * Discriminated union describing how a column default should be emitted.
+ * - { kind: "now" }            — dialect-aware: sql`CURRENT_TIMESTAMP` (sqlite) or .defaultNow() (postgres)
+ * - { kind: "sqlExpr"; raw }   — raw SQL expression wrapped in sql`...` (CURRENT_DATE, CURRENT_TIME, function calls)
+ * - { kind: "literal"; value } — .default(JSON.stringify(value))
+ */
+export type DefaultExpr = {
+    kind: "now";
+} | {
+    kind: "sqlExpr";
+    raw: string;
+} | {
+    kind: "literal";
+    value: unknown;
+};
+export interface ColumnSpec {
+    /** Drizzle function name, e.g., "text", "integer", "varchar". */
+    fnName: string;
+    /** DB column name (snake_case from field name, or @dbColumn override). */
+    dbName: string;
+    /** Positional args after dbName (currently always empty; reserved). */
+    fnArgs: unknown[];
+    /** Object passed as second arg if non-empty (e.g., { length: 200 }, { mode: 'boolean' }). */
+    fnOptions?: Record<string, unknown>;
+    /** Method chain modifiers, e.g., [".notNull()", ".unique()"]. */
+    modifiers: string[];
+    /** Default expression for the column — dialect-specific emission handled by the template. */
+    defaultExpr?: DefaultExpr;
+    /** Drizzle import module: "drizzle-orm/sqlite-core" or "drizzle-orm/pg-core". */
+    importModule: string;
+    /** Optional leading line-comment for the generated column (e.g., type-fallback notice). */
+    leadingComment?: string;
+}
+export declare function mapColumnType(field: MetaField, dialect: Dialect, strategy?: ColumnNamingStrategy): ColumnSpec;
+//# sourceMappingURL=column-mapper.d.ts.map

package/dist/column-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-mapper.d.ts","sourceRoot":"","sources":["../src/column-mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAyB1D,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,YAAY,EAAE,OAAO,EAAE,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAiCxC,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuBD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,oBAAmC,GAC5C,UAAU,CAmJZ"}

package/dist/column-mapper.js

@@ -0,0 +1,205 @@
+// Field-type → Drizzle column type mapping. Per design §6.
+// Uses the typed MetaField.validators() accessor (effective — includes inherited) for all validator checks.
+import { FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_TIME, FIELD_SUBTYPE_TIMESTAMP, FIELD_SUBTYPE_OBJECT, FIELD_SUBTYPE_CLASS, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, FIELD_ATTR_MAX_LENGTH, FIELD_ATTR_REQUIRED, FIELD_ATTR_DB_COLUMN, FIELD_ATTR_UNIQUE, FIELD_ATTR_DEFAULT, VALIDATOR_ATTR_MAX, } from "@metaobjectsdev/metadata";
+import { columnNameFromField } from "./naming.js";
+/**
+ * Patterns recognized as SQL expressions in a default value. Anything matching
+ * these is treated as a SQL expression, not a string literal. Mirrors
+ * migrate-ts/src/expected-schema.ts's EXPR_DEFAULT_PATTERNS so both sides
+ * agree on what's an expression.
+ */
+const SQL_EXPR_PATTERNS = [
+    /^now$/i,
+    /^now\(\)$/i,
+    /^current_timestamp$/i,
+    /^current_date$/i,
+    /^current_time$/i,
+    /\(\)$/, // anything function-like
+];
+/** True iff the value should be emitted as a SQL expression. */
+function isSqlExprDefault(value) {
+    return SQL_EXPR_PATTERNS.some((re) => re.test(value));
+}
+/** Map a recognized SQL expression to its canonical raw form (uppercase keywords). */
+function canonicalizeSqlExpr(value) {
+    const lower = value.toLowerCase();
+    if (lower === "now" || lower === "now()" || lower === "current_timestamp") {
+        return "CURRENT_TIMESTAMP";
+    }
+    if (lower === "current_date")
+        return "CURRENT_DATE";
+    if (lower === "current_time")
+        return "CURRENT_TIME";
+    return value; // unrecognized — pass through (function calls etc.)
+}
+/** Resolve max length from validator.length child or @maxLength attr.
+ *  Uses field.validators() (effective) so inherited validators are seen. */
+function getMaxLength(field) {
+    const lenAttr = field.ownAttr(FIELD_ATTR_MAX_LENGTH);
+    if (typeof lenAttr === "number")
+        return lenAttr;
+    for (const child of field.validators()) {
+        if (child.subType === VALIDATOR_SUBTYPE_LENGTH) {
+            const max = child.ownAttr(VALIDATOR_ATTR_MAX);
+            if (typeof max === "number")
+                return max;
+        }
+    }
+    return undefined;
+}
+/** Check for validator.required child OR @required attr.
+ *  Uses field.validators() (effective) so inherited validators are seen. */
+function isRequired(field) {
+    if (field.ownAttr(FIELD_ATTR_REQUIRED) === true)
+        return true;
+    return field.validators().some((child) => child.subType === VALIDATOR_SUBTYPE_REQUIRED);
+}
+export function mapColumnType(field, dialect, strategy = "snake_case") {
+    const dbName = field.ownAttr(FIELD_ATTR_DB_COLUMN) ?? columnNameFromField(field.name, strategy);
+    const importModule = dialect === "sqlite" ? "drizzle-orm/sqlite-core" : "drizzle-orm/pg-core";
+    const subType = field.subType;
+    const isArray = field.isArray;
+    let fnName;
+    let fnOptions;
+    let leadingComment;
+    if (dialect === "sqlite") {
+        if (isArray) {
+            // SQLite has no native array type; serialize as JSON in a text column.
+            fnName = "text";
+            fnOptions = { mode: "json" };
+        }
+        else {
+            switch (subType) {
+                case FIELD_SUBTYPE_BOOLEAN:
+                    fnName = "integer";
+                    fnOptions = { mode: "boolean" };
+                    break;
+                case FIELD_SUBTYPE_INT:
+                case FIELD_SUBTYPE_CURRENCY:
+                case FIELD_SUBTYPE_LONG:
+                    fnName = "integer";
+                    break;
+                case FIELD_SUBTYPE_DOUBLE:
+                case FIELD_SUBTYPE_FLOAT:
+                    fnName = "real";
+                    break;
+                case FIELD_SUBTYPE_DECIMAL:
+                    fnName = "text";
+                    // SQLite has no decimal type; the user must do precision math at the app
+                    // layer or migrate to Postgres. Surface this in the generated file so it
+                    // isn't a silent rounding hazard.
+                    leadingComment = "TODO: SQLite has no decimal type; stored as text. Convert at the application boundary or migrate to Postgres for native numeric.";
+                    break;
+                case FIELD_SUBTYPE_DATE:
+                case FIELD_SUBTYPE_TIME:
+                case FIELD_SUBTYPE_TIMESTAMP:
+                case FIELD_SUBTYPE_STRING:
+                case FIELD_SUBTYPE_CLASS:
+                case FIELD_SUBTYPE_OBJECT:
+                default:
+                    fnName = "text";
+                    break;
+            }
+        }
+    }
+    else {
+        switch (subType) {
+            case FIELD_SUBTYPE_BOOLEAN:
+                fnName = "boolean";
+                break;
+            case FIELD_SUBTYPE_INT:
+                fnName = "integer";
+                break;
+            case FIELD_SUBTYPE_CURRENCY:
+            case FIELD_SUBTYPE_LONG:
+                fnName = "bigint";
+                fnOptions = { mode: "number" };
+                break;
+            case FIELD_SUBTYPE_DOUBLE:
+                fnName = "doublePrecision";
+                break;
+            case FIELD_SUBTYPE_FLOAT:
+                fnName = "real";
+                break;
+            case FIELD_SUBTYPE_DATE:
+                fnName = "date";
+                break;
+            case FIELD_SUBTYPE_TIME:
+                fnName = "time";
+                break;
+            case FIELD_SUBTYPE_TIMESTAMP:
+                fnName = "timestamp";
+                break;
+            case FIELD_SUBTYPE_DECIMAL:
+                fnName = "numeric";
+                fnOptions = { precision: 19, scale: 4 }; // sane default; @precision/@scale attrs override
+                break;
+            case FIELD_SUBTYPE_STRING: {
+                const maxLen = getMaxLength(field);
+                if (maxLen !== undefined) {
+                    fnName = "varchar";
+                    fnOptions = { length: maxLen };
+                }
+                else {
+                    fnName = "text";
+                }
+                break;
+            }
+            case FIELD_SUBTYPE_CLASS:
+            case FIELD_SUBTYPE_OBJECT:
+            default:
+                fnName = "text";
+                break;
+        }
+    }
+    const modifiers = [];
+    if (dialect === "postgres" && isArray) {
+        modifiers.push(".array()");
+    }
+    if (isRequired(field)) {
+        modifiers.push(".notNull()");
+    }
+    if (field.ownAttr(FIELD_ATTR_UNIQUE) === true) {
+        modifiers.push(".unique()");
+    }
+    let defaultExpr;
+    const defaultAttr = field.ownAttr(FIELD_ATTR_DEFAULT);
+    if (defaultAttr !== undefined) {
+        // SQL-expression detection runs on the raw string value — a string like
+        // "CURRENT_TIMESTAMP" or "now" must be emitted as sql`...`, not a literal.
+        if (typeof defaultAttr === "string" && isSqlExprDefault(defaultAttr)) {
+            const canonical = canonicalizeSqlExpr(defaultAttr);
+            // "now"/"CURRENT_TIMESTAMP" gets the dialect-aware emit path (defaultNow for postgres);
+            // other SQL keywords go through the generic sqlExpr emit.
+            if (canonical === "CURRENT_TIMESTAMP") {
+                defaultExpr = { kind: "now" };
+            }
+            else {
+                defaultExpr = { kind: "sqlExpr", raw: canonical };
+            }
+        }
+        else {
+            // Literal branch: use the field-type-converted value so booleans/numbers
+            // are real JS booleans/numbers (not strings). field.defaultValue() applies
+            // convertToDataType(field.dataType, raw) — Java parity with getDefaultValue().
+            // JSON.stringify(false) → "false", JSON.stringify(0) → "0" (unquoted) in templates.
+            const typedValue = field.defaultValue() ?? defaultAttr;
+            defaultExpr = { kind: "literal", value: typedValue };
+        }
+    }
+    const result = {
+        fnName,
+        dbName,
+        fnArgs: [],
+        modifiers,
+        importModule,
+    };
+    if (fnOptions !== undefined)
+        result.fnOptions = fnOptions;
+    if (defaultExpr !== undefined)
+        result.defaultExpr = defaultExpr;
+    if (leadingComment !== undefined)
+        result.leadingComment = leadingComment;
+    return result;
+}
+//# sourceMappingURL=column-mapper.js.map

package/dist/column-mapper.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+/** The marker that says "codegen owns this file" — drives the overwrite policy. */
+export declare const GENERATED_HEADER = "@generated by @metaobjectsdev/codegen-ts";
+/** Suffix for sibling user extension files (codegen never touches these). */
+export declare const EXTRA_SUFFIX = ".extra";
+/** Default outDir used by tests + as a sane default for generate(). */
+export declare const DEFAULT_OUT_DIR = "./src/db/entities";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,6CAA6C,CAAC;AAE3E,6EAA6E;AAC7E,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC,uEAAuE;AACvE,eAAO,MAAM,eAAe,sBAAsB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,8 @@
+// Local constants for codegen-ts.
+/** The marker that says "codegen owns this file" — drives the overwrite policy. */
+export const GENERATED_HEADER = "@generated by @metaobjectsdev/codegen-ts";
+/** Suffix for sibling user extension files (codegen never touches these). */
+export const EXTRA_SUFFIX = ".extra";
+/** Default outDir used by tests + as a sane default for generate(). */
+export const DEFAULT_OUT_DIR = "./src/db/entities";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,0CAA0C,CAAC;AAE3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class CodegenError extends Error {
+    readonly file?: string;
+    constructor(message: string, opts?: {
+        file?: string;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAKtD"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+// Typed errors for codegen-ts.
+export class CodegenError extends Error {
+    file;
+    constructor(message, opts) {
+        super(message);
+        this.name = "CodegenError";
+        if (opts?.file !== undefined)
+            this.file = opts.file;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAU;IACvB,YAAY,OAAe,EAAE,IAAwB;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACtD,CAAC;CACF"}

package/dist/format.d.ts

@@ -0,0 +1,2 @@
+export declare function formatTs(content: string): Promise<string>;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAoCA,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa/D"}

package/dist/format.js

@@ -0,0 +1,47 @@
+// Biome formatter integration. Used by generate() to format rendered TS before write.
+// Per design §11: format errors are warnings, not throws.
+import { Biome, Distribution } from "@biomejs/js-api";
+// Cache the Promise (not the resolved instance) so concurrent first calls
+// share the same in-flight Biome.create() rather than racing to spawn two.
+let _biomePromise;
+function getBiome() {
+    if (!_biomePromise) {
+        _biomePromise = Biome.create({ distribution: Distribution.NODE }).then((biome) => {
+            biome.applyConfiguration({
+                formatter: { enabled: true, indentStyle: "space", indentWidth: 2 },
+                javascript: { formatter: { quoteStyle: "double", semicolons: "always" } },
+            });
+            return biome;
+        });
+    }
+    return _biomePromise;
+}
+/**
+ * Summarize Biome diagnostics into a single human-readable line, without
+ * dumping the raw diagnostic objects (which produce "[Object ...]" /
+ * "source: null" noise when stringified by console).
+ */
+function summarizeDiagnostics(diagnostics) {
+    const count = diagnostics.length;
+    const first = diagnostics[0];
+    const firstMsg = first?.description ?? first?.message ?? "(no description)";
+    return count === 1
+        ? `1 diagnostic: ${firstMsg}`
+        : `${count} diagnostics; first: ${firstMsg}`;
+}
+export async function formatTs(content) {
+    try {
+        const biome = await getBiome();
+        const result = biome.formatContent(content, { filePath: "in-memory.ts" });
+        if (result.diagnostics.length > 0) {
+            console.warn(`[codegen-ts] Biome formatter: ${summarizeDiagnostics(result.diagnostics)}`);
+            return content;
+        }
+        return result.content;
+    }
+    catch (err) {
+        console.warn(`[codegen-ts] Biome formatter error: ${err.message}`);
+        return content;
+    }
+}
+//# sourceMappingURL=format.js.map