primitive-admin 1.1.0-alpha.4 → 1.1.0-alpha.41

package/dist/src/lib/db-codegen/dbGenerator.d.ts

@@ -0,0 +1,111 @@
+/**
+ * `databases codegen` orchestrator (issue #814).
+ *
+ * Pure-ish core: given a set of database-type TOML strings + a target
+ * output dir, decides what `*.generated.ts` files to write (in memory),
+ * then either (a) writes them, or (b) compares them against on-disk for
+ * `--check`. No commander dependency, no `process.exit`.
+ *
+ * Reuses the codegen-v2 machinery:
+ *   - `loadSchemaFromTomlString` (the shared `[models.*]` parser) for record
+ *     interfaces — the database-type `[models.*]` blocks round-trip through
+ *     the same loader and the same `FieldType` vocabulary.
+ *   - The banner + fingerprint header pattern and stale-output cleanup.
+ *
+ * Adds the OPERATIONS half (op-params interfaces + per-op result aliases)
+ * that codegen-v2 has no analog for. Op return contracts are NOT stored in
+ * the TOML, so result aliases are generic shapes keyed off `op.type`.
+ */
+export interface DbCodegenInput {
+    /** Database type name (drives the output filename). */
+    databaseType: string;
+    /** Path to the source `database-types/<type>.toml` file. */
+    tomlPath: string;
+    /** Raw TOML content (already read from disk). */
+    tomlContent: string;
+}
+export interface GenerateDbTypesOptions {
+    /** One entry per database-type TOML file to generate from. */
+    inputs: DbCodegenInput[];
+    /** Directory where `<type>.generated.ts` files are written. */
+    outputDir: string;
+    /**
+     * If true, do not write to disk. Compare the would-be output to what's on
+     * disk and return a non-empty `mismatches` list if any file would change.
+     */
+    check?: boolean;
+    /**
+     * Set when the run was filtered to a single database type (the
+     * `primitive databases codegen <type>` argument). The `inputs` set is then
+     * PARTIAL — it does not represent the full set of owned generated files — so
+     * stale-output cleanup (and `--check` stale detection) must be scoped to the
+     * filtered type's own file and must NOT touch / flag sibling types'
+     * `*.generated.ts` files. The unfiltered "generate all" run leaves this unset
+     * and keeps full orphan cleanup.
+     */
+    singleType?: boolean;
+}
+export interface DbCodegenResult {
+    /** Files written (or that would be written under `--check`). */
+    writtenFiles: string[];
+    /** Stale `*.generated.ts` files deleted (or flagged stale under `--check`). */
+    deletedFiles: string[];
+    /** Only populated under `--check`: files whose on-disk content is out of date. */
+    mismatches: DbCheckMismatch[];
+}
+export interface DbCheckMismatch {
+    filePath: string;
+    reason: "missing" | "differs" | "stale";
+}
+/**
+ * Render the in-memory `.generated.ts` content for a single database-type
+ * TOML. Exported so tests can assert on the rendered string directly.
+ */
+export declare function renderDbTypeFile(input: DbCodegenInput): string;
+/**
+ * Per-model result of {@link inferRequiredRecordFields}. Shaped as an object
+ * (rather than a bare `Set`) so it can grow additional inferred metadata later
+ * without changing the call-site contract — e.g. future alignment with #845's
+ * server-side op-params analysis. For now it carries only the set of record
+ * fields the operation params prove are always supplied at create time.
+ */
+export interface InferredRecordModelInfo {
+    /** Record field names promoted to non-optional by op-params inference. */
+    fields: Set<string>;
+}
+/**
+ * Infer which record fields are always supplied at create time, by reading the
+ * `save` operation params (issue #842).
+ *
+ * A field is promoted to required for a model only if:
+ *   - at least one `save` (create) op writes it from a bare `$params.X`
+ *     binding, AND
+ *   - EVERY `save` op that writes the field binds it to a param declared
+ *     `required: true` (the "ALL writers agree" rule).
+ *
+ * Deliberately conservative:
+ *   - `patch` (and every non-`save` inner op) is excluded — partial updates
+ *     don't guarantee creation-time presence.
+ *   - whole-object saves (`data = "$params.X"`, a string rather than a
+ *     per-field map) carry no field-level mapping, so no field can be promoted
+ *     from them (Q4 skip).
+ *   - only an EXACT top-level bare `$params.X` value counts (the whole binding
+ *     value must match `^\$params\.X$`, and `X` must be a declared top-level
+ *     param). A literal, computed, partially-interpolated value, or a nested
+ *     path (`$params.obj.sub`) never promotes a field — a nested sub-property
+ *     may be absent even when the top-level object param is required. This is
+ *     deliberately stricter than the CLI's lenient `collectParamRefs`
+ *     first-segment rule, which is fine for its validation use but would
+ *     wrongly promote nested bindings here.
+ *   - inner ops are matched to the record model by the inner op's own
+ *     `modelName` when present, falling back to the enclosing operation's
+ *     `modelName`.
+ *
+ * Pure: no I/O, no mutation of the input. The caller OR's the result with the
+ * schema-level `required` flag, so inference only ever ADDS requiredness.
+ */
+export declare function inferRequiredRecordFields(operations: any[]): Map<string, InferredRecordModelInfo>;
+/**
+ * Run codegen end-to-end across one or more database-type TOML inputs.
+ */
+export declare function generateDbTypes(options: GenerateDbTypesOptions): Promise<DbCodegenResult>;

package/dist/src/lib/db-codegen/dbGenerator.js

@@ -0,0 +1,371 @@
+/**
+ * `databases codegen` orchestrator (issue #814).
+ *
+ * Pure-ish core: given a set of database-type TOML strings + a target
+ * output dir, decides what `*.generated.ts` files to write (in memory),
+ * then either (a) writes them, or (b) compares them against on-disk for
+ * `--check`. No commander dependency, no `process.exit`.
+ *
+ * Reuses the codegen-v2 machinery:
+ *   - `loadSchemaFromTomlString` (the shared `[models.*]` parser) for record
+ *     interfaces — the database-type `[models.*]` blocks round-trip through
+ *     the same loader and the same `FieldType` vocabulary.
+ *   - The banner + fingerprint header pattern and stale-output cleanup.
+ *
+ * Adds the OPERATIONS half (op-params interfaces + per-op result aliases)
+ * that codegen-v2 has no analog for. Op return contracts are NOT stored in
+ * the TOML, so result aliases are generic shapes keyed off `op.type`.
+ */
+import * as path from "path";
+import { promises as fsp } from "fs";
+import * as TOML from "@iarna/toml";
+import { loadSchemaFromTomlString } from "js-bao";
+import { parseDatabaseTypeToml } from "../../commands/sync.js";
+import { fingerprintToml } from "./dbFingerprint.js";
+import { resolveRecordInterfaceName, opParamsInterfaceName, opResultAliasName } from "./dbNaming.js";
+import { renderHeader, renderRecordInterface, renderOpParamsInterface, renderOpResultAlias, RESULT_ALIASES_BLOCK, } from "./dbTemplates.js";
+const GENERATED_FILE_SUFFIX = ".generated.ts";
+/**
+ * Render the in-memory `.generated.ts` content for a single database-type
+ * TOML. Exported so tests can assert on the rendered string directly.
+ */
+export function renderDbTypeFile(input) {
+    const { tomlContent } = input;
+    const fingerprint = fingerprintToml(tomlContent);
+    // Parse the raw TOML once for the [type] / [[operations]] data, and route
+    // the [models.*] subtree through the shared js-bao loader (same path the
+    // server uses to validate the schema).
+    const tomlData = TOML.parse(tomlContent);
+    const { typeConfig, operations } = parseDatabaseTypeToml(tomlData);
+    // 1. Record interfaces (read shape) from [models.*].
+    const schemas = tomlData.models
+        ? loadSchemaFromTomlString(TOML.stringify({ models: tomlData.models }), {
+            strict: false,
+        })
+        : [];
+    const stampedFields = collectStampedFields(typeConfig);
+    // model name → set of record fields the operation params prove are always
+    // supplied at create time (every `save` op that sets the field binds it to a
+    // `required: true` param). OR'd with the schema-level `required` flag below;
+    // inference only ever ADDS requiredness, never removes it. (#842)
+    const inferredRequired = inferRequiredRecordFields(operations);
+    // model name → resolved record interface name (used by query result aliases).
+    const recordInterfaceByModel = {};
+    const seenInterfaceNames = new Map(); // interfaceName → modelName
+    for (const schema of schemas) {
+        const ifaceName = resolveRecordInterfaceName(schema.name, schema.options?.className);
+        const prior = seenInterfaceNames.get(ifaceName);
+        if (prior !== undefined && prior !== schema.name) {
+            throw new Error(`Record-interface name collision: models "${prior}" and ` +
+                `"${schema.name}" both produce interface "${ifaceName}". Add a ` +
+                `class_name override to one of them.`);
+        }
+        seenInterfaceNames.set(ifaceName, schema.name);
+        recordInterfaceByModel[schema.name] = ifaceName;
+    }
+    const blocks = [];
+    blocks.push(renderHeader(fingerprint));
+    blocks.push(RESULT_ALIASES_BLOCK.trimEnd());
+    // Record interfaces, sorted by interface name for deterministic output.
+    const sortedSchemas = [...schemas].sort((a, b) => recordInterfaceByModel[a.name].localeCompare(recordInterfaceByModel[b.name]));
+    for (const schema of sortedSchemas) {
+        const inferredForModel = inferredRequired.get(schema.name)?.fields;
+        const fields = Object.entries(schema.fields).map(([name, opts]) => ({
+            name,
+            type: opts.type,
+            required: opts.required === true ||
+                (opts.autoAssign === true && name === "id") ||
+                inferredForModel?.has(name) === true,
+            // Allowed-value set for string fields → string-literal union (#843).
+            // Threaded through the shared loader's FieldOptions.enum; validated
+            // (non-empty, all-string, string-only) by parseFieldOptions upstream.
+            enum: opts.enum,
+        }));
+        blocks.push(renderRecordInterface({
+            interfaceName: recordInterfaceByModel[schema.name],
+            modelName: schema.name,
+            fields,
+            stampedFields,
+        }));
+    }
+    // Operation interfaces + result aliases, sorted by op name.
+    const sortedOps = [...operations]
+        .filter((op) => op && typeof op.name === "string")
+        .sort((a, b) => a.name.localeCompare(b.name));
+    for (const op of sortedOps) {
+        const params = paramsToFields(op.params);
+        blocks.push(renderOpParamsInterface({
+            interfaceName: opParamsInterfaceName(op.name),
+            opName: op.name,
+            params,
+        }));
+        const recordInterfaceName = op.type === "query" && op.modelName
+            ? recordInterfaceByModel[op.modelName] ?? null
+            : null;
+        blocks.push(renderOpResultAlias({
+            aliasName: opResultAliasName(op.name),
+            opName: op.name,
+            opType: op.type,
+            recordInterfaceName,
+        }));
+    }
+    // Single trailing newline; blocks separated by a blank line.
+    return blocks.join("\n\n") + "\n";
+}
+/**
+ * Collect the server-stamped field names from the parsed [type] config:
+ * timestamps (`create`/`update` field names) + auto-populated field names
+ * (the keys of the `autoPopulatedFields` map). These appear on the READ
+ * record interface as OPTIONAL props.
+ */
+function collectStampedFields(typeConfig) {
+    const names = [];
+    const ts = typeConfig?.timestamps;
+    if (ts && typeof ts === "object") {
+        if (typeof ts.create === "string")
+            names.push(ts.create);
+        if (typeof ts.update === "string")
+            names.push(ts.update);
+    }
+    const apf = typeConfig?.autoPopulatedFields;
+    if (apf && typeof apf === "object") {
+        for (const key of Object.keys(apf))
+            names.push(key);
+    }
+    // De-dup, preserve first-seen order.
+    return [...new Set(names)];
+}
+/**
+ * Convert the normalized op `params` map (`{ name: { type, required, enum? } }`)
+ * into a sorted list of `ParamField`. Sorted by name for deterministic
+ * output. A string param's `enum` (#861) is carried through so the emitter can
+ * render a string-literal union.
+ */
+function paramsToFields(params) {
+    if (!params || typeof params !== "object")
+        return [];
+    return Object.entries(params)
+        .map(([name, def]) => ({
+        name,
+        type: def?.type ?? "object",
+        required: def?.required === true,
+        // Allowed-value set for a string param → string-literal union (#861).
+        // `normalizeOperationFromToml` preserves `enum` upstream via its `...rest`
+        // spread; carry it through here so it reaches `ParamField`/the emitter.
+        enum: def?.enum,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Infer which record fields are always supplied at create time, by reading the
+ * `save` operation params (issue #842).
+ *
+ * A field is promoted to required for a model only if:
+ *   - at least one `save` (create) op writes it from a bare `$params.X`
+ *     binding, AND
+ *   - EVERY `save` op that writes the field binds it to a param declared
+ *     `required: true` (the "ALL writers agree" rule).
+ *
+ * Deliberately conservative:
+ *   - `patch` (and every non-`save` inner op) is excluded — partial updates
+ *     don't guarantee creation-time presence.
+ *   - whole-object saves (`data = "$params.X"`, a string rather than a
+ *     per-field map) carry no field-level mapping, so no field can be promoted
+ *     from them (Q4 skip).
+ *   - only an EXACT top-level bare `$params.X` value counts (the whole binding
+ *     value must match `^\$params\.X$`, and `X` must be a declared top-level
+ *     param). A literal, computed, partially-interpolated value, or a nested
+ *     path (`$params.obj.sub`) never promotes a field — a nested sub-property
+ *     may be absent even when the top-level object param is required. This is
+ *     deliberately stricter than the CLI's lenient `collectParamRefs`
+ *     first-segment rule, which is fine for its validation use but would
+ *     wrongly promote nested bindings here.
+ *   - inner ops are matched to the record model by the inner op's own
+ *     `modelName` when present, falling back to the enclosing operation's
+ *     `modelName`.
+ *
+ * Pure: no I/O, no mutation of the input. The caller OR's the result with the
+ * schema-level `required` flag, so inference only ever ADDS requiredness.
+ */
+export function inferRequiredRecordFields(operations) {
+    // model → field → running verdict. `true` = every save op seen so far that
+    // sets the field bound it to a required param; `false` = at least one save op
+    // set it from an optional/absent param (sticky — never recovers).
+    const verdicts = new Map();
+    for (const op of operations ?? []) {
+        if (!op || op.type !== "mutation")
+            continue;
+        const innerOps = op.definition?.operations;
+        if (!Array.isArray(innerOps))
+            continue;
+        const params = op.params && typeof op.params === "object" ? op.params : {};
+        for (const inner of innerOps) {
+            if (!inner || inner.op !== "save")
+                continue;
+            // Whole-object save (`data` is a string $params ref) has no per-field
+            // map — skip (Q4).
+            const data = inner.data;
+            if (!data || typeof data !== "object" || Array.isArray(data))
+                continue;
+            const modelName = inner.modelName ?? op.modelName;
+            if (typeof modelName !== "string" || modelName === "")
+                continue;
+            let fieldVerdicts = verdicts.get(modelName);
+            if (!fieldVerdicts) {
+                fieldVerdicts = new Map();
+                verdicts.set(modelName, fieldVerdicts);
+            }
+            for (const [field, value] of Object.entries(data)) {
+                // Only an EXACT top-level bare binding (`$params.X`, no further `.sub`
+                // path) counts. `collectParamRefs` is intentionally lenient — it
+                // returns the FIRST dotted segment, so `$params.profile.name` yields
+                // `["profile"]` and would wrongly promote a field that actually reads
+                // a nested sub-property that may be absent. We match the whole value
+                // against `^\$params\.X$` here instead, leaving `collectParamRefs`
+                // untouched for its validation use. Partial interpolation
+                // (`prefix-$params.X`), literals, and nested paths all fail this match
+                // and therefore never promote a field.
+                const match = typeof value === "string"
+                    ? value.match(/^\$params\.([A-Za-z0-9_]+)$/)
+                    : null;
+                if (!match) {
+                    // Not an exact top-level bare param binding — this save op cannot
+                    // prove the field required. Mark it not-required for this writer.
+                    fieldVerdicts.set(field, false);
+                    continue;
+                }
+                const paramName = match[1];
+                // The matched name must resolve to a declared top-level param.
+                const required = params[paramName]?.required === true;
+                const prior = fieldVerdicts.get(field);
+                // ALL-writers semantics: stays `true` only while every save writer
+                // agrees; one disagreeing writer flips it to `false` permanently.
+                fieldVerdicts.set(field, prior === false ? false : required);
+            }
+        }
+    }
+    const result = new Map();
+    for (const [modelName, fieldVerdicts] of verdicts) {
+        const fields = new Set();
+        for (const [field, verdict] of fieldVerdicts) {
+            if (verdict)
+                fields.add(field);
+        }
+        if (fields.size > 0)
+            result.set(modelName, { fields });
+    }
+    return result;
+}
+/**
+ * Run codegen end-to-end across one or more database-type TOML inputs.
+ */
+export async function generateDbTypes(options) {
+    const outAbs = path.resolve(options.outputDir);
+    const filesToWrite = new Map();
+    for (const input of options.inputs) {
+        const filePath = path.join(outAbs, `${input.databaseType}${GENERATED_FILE_SUFFIX}`);
+        filesToWrite.set(filePath, renderDbTypeFile(input));
+    }
+    if (options.check === true) {
+        return await runCheck(outAbs, filesToWrite, options.singleType === true);
+    }
+    await fsp.mkdir(outAbs, { recursive: true });
+    const deletedFiles = await cleanupGeneratedOutputs(outAbs, filesToWrite, options.singleType === true);
+    const writtenFiles = [];
+    for (const [filePath, content] of filesToWrite) {
+        await fsp.writeFile(filePath, content, "utf-8");
+        writtenFiles.push(filePath);
+    }
+    writtenFiles.sort();
+    deletedFiles.sort();
+    return { writtenFiles, deletedFiles, mismatches: [] };
+}
+async function runCheck(outAbs, filesToWrite, singleType) {
+    const mismatches = [];
+    for (const [filePath, expected] of filesToWrite) {
+        let actual;
+        try {
+            actual = await fsp.readFile(filePath, "utf-8");
+        }
+        catch (err) {
+            if (err && err.code === "ENOENT") {
+                actual = null;
+            }
+            else {
+                throw err;
+            }
+        }
+        if (actual === null) {
+            mismatches.push({ filePath, reason: "missing" });
+        }
+        else if (actual !== expected) {
+            mismatches.push({ filePath, reason: "differs" });
+        }
+    }
+    // Stale on-disk generated files the generator wouldn't produce also count
+    // as a mismatch (so CI catches dropped database types). Skip this when the
+    // run was filtered to a single type: `filesToWrite` is then a partial set,
+    // so sibling types' files are not "stale" — they just weren't in scope.
+    if (!singleType && (await dirExists(outAbs))) {
+        const onDisk = await listOwnedGeneratedFiles(outAbs);
+        const expectedPaths = new Set(filesToWrite.keys());
+        for (const filePath of onDisk) {
+            if (!expectedPaths.has(filePath)) {
+                mismatches.push({ filePath, reason: "stale" });
+            }
+        }
+    }
+    return {
+        writtenFiles: [...filesToWrite.keys()].sort(),
+        deletedFiles: [],
+        mismatches,
+    };
+}
+async function cleanupGeneratedOutputs(outDir, filesToWrite, singleType) {
+    // A single-type filter run only owns its own file(s); the `filesToWrite`
+    // set does not represent the full set of generated files. Skip orphan
+    // cleanup so sibling types' `*.generated.ts` are not silently destroyed.
+    // Full cleanup only happens on the unfiltered "generate all" run.
+    if (singleType)
+        return [];
+    const onDisk = await listOwnedGeneratedFiles(outDir);
+    const expectedPaths = new Set(filesToWrite.keys());
+    const deleted = [];
+    for (const filePath of onDisk) {
+        if (!expectedPaths.has(filePath)) {
+            await fsp.unlink(filePath);
+            deleted.push(filePath);
+        }
+    }
+    return deleted;
+}
+/**
+ * List only the files in `outDir` that the generator owns: any file ending
+ * in `.generated.ts`. Hand-written files are never touched.
+ */
+async function listOwnedGeneratedFiles(outDir) {
+    if (!(await dirExists(outDir)))
+        return [];
+    const entries = await fsp.readdir(outDir, { withFileTypes: true });
+    const owned = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (entry.name.endsWith(GENERATED_FILE_SUFFIX)) {
+            owned.push(path.join(outDir, entry.name));
+        }
+    }
+    return owned;
+}
+async function dirExists(dir) {
+    try {
+        const stat = await fsp.stat(dir);
+        return stat.isDirectory();
+    }
+    catch (err) {
+        if (err && err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+}
+//# sourceMappingURL=dbGenerator.js.map

package/dist/src/lib/db-codegen/dbGenerator.js.map

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

package/dist/src/lib/db-codegen/dbNaming.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Identifier-naming helpers for the `databases codegen` generator (issue #814).
+ *
+ * Record interfaces mirror codegen-v2's class-name resolution
+ * (`packages/js-bao/src/cli/v2/pluralization.ts`): honor a `class_name`
+ * override, else singularize a snake_case plural to PascalCase. The
+ * singularization algorithm below is a faithful copy of codegen-v2's
+ * `singularizeToPascalCase`; it is inlined rather than imported because the
+ * CLI builds standalone (`tsc -p cli/tsconfig.json`, `rootDir: "."`) and
+ * cannot reach into the vendored `packages/js-bao/src` tree.
+ *
+ * It DIVERGES in the fallback: codegen-v2 THROWS when a model name doesn't
+ * look like a recognizable plural (ORM models are expected to be plural).
+ * Database-type model names are author-curated and frequently already
+ * singular / PascalCase (e.g. `[models.User]`), so we PascalCase the name
+ * verbatim rather than failing the whole run.
+ *
+ * Op interfaces/aliases derive from the operation name (PascalCase) +
+ * `Params` / `Result` suffix (e.g. `saveAccount` → `SaveAccountParams`,
+ * `SaveAccountResult`).
+ */
+/**
+ * Resolve the record-interface name for a model. Honors a `class_name`
+ * override, then tries plural→singular Pascal, then falls back to a verbatim
+ * PascalCase of the model name (no throw).
+ */
+export declare function resolveRecordInterfaceName(modelName: string, classNameOverride: string | undefined): string;
+/** `saveAccount` → `SaveAccountParams`. */
+export declare function opParamsInterfaceName(opName: string): string;
+/** `saveAccount` → `SaveAccountResult`. */
+export declare function opResultAliasName(opName: string): string;
+/**
+ * Convert a snake_case plural model name (`user_prefs`, `categories`) into a
+ * PascalCase singular interface name (`UserPref`, `Category`). Returns null
+ * if no suffix rule matches the input. Faithful copy of codegen-v2's
+ * `singularizeToPascalCase`.
+ */
+export declare function singularizeToPascalCase(snakePlural: string): string | null;
+/**
+ * PascalCase an identifier: splits on non-alphanumeric separators
+ * (`_`, `-`, spaces) and capitalizes each segment, preserving any existing
+ * internal casing (`saveAccount` → `SaveAccount`, `save_account` →
+ * `SaveAccount`).
+ */
+export declare function pascalCase(name: string): string;

package/dist/src/lib/db-codegen/dbNaming.js

@@ -0,0 +1,104 @@
+/**
+ * Identifier-naming helpers for the `databases codegen` generator (issue #814).
+ *
+ * Record interfaces mirror codegen-v2's class-name resolution
+ * (`packages/js-bao/src/cli/v2/pluralization.ts`): honor a `class_name`
+ * override, else singularize a snake_case plural to PascalCase. The
+ * singularization algorithm below is a faithful copy of codegen-v2's
+ * `singularizeToPascalCase`; it is inlined rather than imported because the
+ * CLI builds standalone (`tsc -p cli/tsconfig.json`, `rootDir: "."`) and
+ * cannot reach into the vendored `packages/js-bao/src` tree.
+ *
+ * It DIVERGES in the fallback: codegen-v2 THROWS when a model name doesn't
+ * look like a recognizable plural (ORM models are expected to be plural).
+ * Database-type model names are author-curated and frequently already
+ * singular / PascalCase (e.g. `[models.User]`), so we PascalCase the name
+ * verbatim rather than failing the whole run.
+ *
+ * Op interfaces/aliases derive from the operation name (PascalCase) +
+ * `Params` / `Result` suffix (e.g. `saveAccount` → `SaveAccountParams`,
+ * `SaveAccountResult`).
+ */
+/**
+ * Resolve the record-interface name for a model. Honors a `class_name`
+ * override, then tries plural→singular Pascal, then falls back to a verbatim
+ * PascalCase of the model name (no throw).
+ */
+export function resolveRecordInterfaceName(modelName, classNameOverride) {
+    if (classNameOverride && classNameOverride.length > 0) {
+        return classNameOverride;
+    }
+    const singular = singularizeToPascalCase(modelName);
+    if (singular !== null)
+        return singular;
+    // Fallback: PascalCase the model name as-is (handles already-singular and
+    // already-PascalCase names like `User`, `Account`).
+    return pascalCase(modelName);
+}
+/** `saveAccount` → `SaveAccountParams`. */
+export function opParamsInterfaceName(opName) {
+    return `${pascalCase(opName)}Params`;
+}
+/** `saveAccount` → `SaveAccountResult`. */
+export function opResultAliasName(opName) {
+    return `${pascalCase(opName)}Result`;
+}
+/**
+ * Convert a snake_case plural model name (`user_prefs`, `categories`) into a
+ * PascalCase singular interface name (`UserPref`, `Category`). Returns null
+ * if no suffix rule matches the input. Faithful copy of codegen-v2's
+ * `singularizeToPascalCase`.
+ */
+export function singularizeToPascalCase(snakePlural) {
+    if (!snakePlural || snakePlural.length === 0)
+        return null;
+    const parts = snakePlural.split("_");
+    if (parts.some((p) => p.length === 0))
+        return null;
+    const last = parts[parts.length - 1];
+    const singularizedLast = singularizeWord(last);
+    if (singularizedLast === null)
+        return null;
+    parts[parts.length - 1] = singularizedLast;
+    return parts.map(pascalSegment).join("");
+}
+/** Singularize a single plural word via simple suffix rules; null if none. */
+function singularizeWord(word) {
+    if (!word)
+        return null;
+    if (!word.endsWith("s"))
+        return null;
+    if (word.endsWith("ies") && word.length > 3)
+        return word.slice(0, -3) + "y";
+    if (word.endsWith("xes") && word.length > 3)
+        return word.slice(0, -2);
+    if (word.endsWith("ses") && word.length > 3)
+        return word.slice(0, -2);
+    if (word.endsWith("shes") && word.length > 4)
+        return word.slice(0, -2);
+    if (word.endsWith("ches") && word.length > 4)
+        return word.slice(0, -2);
+    if (word.endsWith("s") && word.length > 1)
+        return word.slice(0, -1);
+    return null;
+}
+function pascalSegment(segment) {
+    if (!segment)
+        return segment;
+    return segment.charAt(0).toUpperCase() + segment.slice(1);
+}
+/**
+ * PascalCase an identifier: splits on non-alphanumeric separators
+ * (`_`, `-`, spaces) and capitalizes each segment, preserving any existing
+ * internal casing (`saveAccount` → `SaveAccount`, `save_account` →
+ * `SaveAccount`).
+ */
+export function pascalCase(name) {
+    const segments = name.split(/[^A-Za-z0-9]+/).filter((s) => s.length > 0);
+    if (segments.length === 0)
+        return name;
+    return segments
+        .map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1))
+        .join("");
+}
+//# sourceMappingURL=dbNaming.js.map

package/dist/src/lib/db-codegen/dbNaming.js.map

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