primitive-admin 1.1.0-alpha.9 → 1.1.0

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

@@ -0,0 +1,17 @@
+/**
+ * Short fingerprint for a database-type TOML string (issue #814).
+ *
+ * Stamped in the header of every generated file so a human (or the
+ * `--check` CI guard) can tell at a glance whether the source TOML and the
+ * generated output are in sync. Mirrors codegen-v2's `fingerprintToml`
+ * (`packages/js-bao/src/cli/v2/fingerprint.ts`): 16 hex chars of SHA-256 —
+ * enough for a sanity check, short enough to fit on one comment line.
+ */
+import { createHash } from "crypto";
+export function fingerprintToml(tomlContent) {
+    return createHash("sha256")
+        .update(tomlContent, "utf-8")
+        .digest("hex")
+        .slice(0, 16);
+}
+//# sourceMappingURL=dbFingerprint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dbFingerprint.js","sourceRoot":"","sources":["../../../../src/lib/db-codegen/dbFingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC;SAC5B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * `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`.
+ *
+ * The op/record RESOLUTION (parse, schema load, required-ness inference, op
+ * params, and per-op result descriptors) lives in the shared, naming-neutral
+ * `describeDbType` IR (`dbTypeIR.ts`) — the SAME source the Swift renderer
+ * (`swift-codegen/dbGenerator.ts`) consumes (issue #1547 binding 5). This file
+ * is now purely the TS *rendering* half: it applies TS identifier naming
+ * (`resolveRecordInterfaceName`, `opParamsInterfaceName`, …) to that IR and
+ * emits `*.generated.ts` via the pure `dbTemplates` string-emitters. The
+ * emitted bytes are unchanged from the former inline implementation.
+ */
+import { type GeneratedFileMismatch } from "../codegen-shared/generatedFiles.js";
+import { type DbCodegenInput } from "./dbTypeIR.js";
+export type { DbCodegenInput } from "./dbTypeIR.js";
+export { inferArrayParamElementTypes, inferRequiredRecordFields, type InferredRecordModelInfo, } from "./dbTypeIR.js";
+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[];
+}
+/**
+ * Re-exported from the shared generated-file module so existing importers keep
+ * a stable type. The write/`--check`/cleanup lifecycle now lives in
+ * `codegen-shared/generatedFiles.ts` (shared with `workflows codegen`).
+ */
+export type DbCheckMismatch = GeneratedFileMismatch;
+/**
+ * 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;
+/**
+ * Run codegen end-to-end across one or more database-type TOML inputs. The
+ * disk lifecycle (write / `--check` / stale cleanup) is delegated to the
+ * shared `writeOrCheckGeneratedFiles` (shared with `workflows codegen`).
+ */
+export declare function generateDbTypes(options: GenerateDbTypesOptions): Promise<DbCodegenResult>;

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

@@ -0,0 +1,170 @@
+/**
+ * `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`.
+ *
+ * The op/record RESOLUTION (parse, schema load, required-ness inference, op
+ * params, and per-op result descriptors) lives in the shared, naming-neutral
+ * `describeDbType` IR (`dbTypeIR.ts`) — the SAME source the Swift renderer
+ * (`swift-codegen/dbGenerator.ts`) consumes (issue #1547 binding 5). This file
+ * is now purely the TS *rendering* half: it applies TS identifier naming
+ * (`resolveRecordInterfaceName`, `opParamsInterfaceName`, …) to that IR and
+ * emits `*.generated.ts` via the pure `dbTemplates` string-emitters. The
+ * emitted bytes are unchanged from the former inline implementation.
+ */
+import * as path from "path";
+import { writeOrCheckGeneratedFiles, } from "../codegen-shared/generatedFiles.js";
+import { describeDbType, } from "./dbTypeIR.js";
+import { resolveRecordInterfaceName, opParamsInterfaceName, opResultAliasName, opsFactoryName, subscriptionsFactoryName, objectPropertyKey, } from "./dbNaming.js";
+import { renderHeader, renderRecordInterface, renderOpParamsInterface, renderOpResultAlias, renderFactories, fieldNameUnion, RESULT_ALIASES_BLOCK, } from "./dbTemplates.js";
+import { atom, generic } from "../codegen-shared/prettierStable.js";
+export { inferArrayParamElementTypes, inferRequiredRecordFields, } from "./dbTypeIR.js";
+const GENERATED_FILE_SUFFIX = ".generated.ts";
+/**
+ * Map the naming-neutral pipeline-return IR to the interface-named descriptor
+ * the TS `renderOpResultAlias` template consumes.
+ */
+function mapPipelineReturn(ir, recordInterfaceByModel) {
+    switch (ir.kind) {
+        case "query":
+            return {
+                kind: "query",
+                recordInterfaceName: ir.modelName
+                    ? recordInterfaceByModel[ir.modelName] ?? null
+                    : null,
+                projection: ir.projection,
+            };
+        case "count":
+            return { kind: "count" };
+        case "aggregate":
+            return { kind: "aggregate" };
+        case "opaque":
+        default:
+            return { kind: "opaque" };
+    }
+}
+/**
+ * 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 ir = describeDbType(input);
+    // model name → resolved record interface name (used by query result aliases),
+    // with the same collision guard the inline implementation had.
+    const recordInterfaceByModel = {};
+    const seenInterfaceNames = new Map(); // interfaceName → modelName
+    for (const rec of ir.records) {
+        const ifaceName = resolveRecordInterfaceName(rec.modelName, rec.className);
+        const prior = seenInterfaceNames.get(ifaceName);
+        if (prior !== undefined && prior !== rec.modelName) {
+            throw new Error(`Record-interface name collision: models "${prior}" and ` +
+                `"${rec.modelName}" both produce interface "${ifaceName}". Add a ` +
+                `class_name override to one of them.`);
+        }
+        seenInterfaceNames.set(ifaceName, rec.modelName);
+        recordInterfaceByModel[rec.modelName] = ifaceName;
+    }
+    const blocks = [];
+    blocks.push(renderHeader(ir.fingerprint));
+    blocks.push(RESULT_ALIASES_BLOCK.trimEnd());
+    // Record interfaces, sorted by interface name for deterministic output.
+    const sortedRecords = [...ir.records].sort((a, b) => recordInterfaceByModel[a.modelName].localeCompare(recordInterfaceByModel[b.modelName]));
+    for (const rec of sortedRecords) {
+        blocks.push(renderRecordInterface({
+            interfaceName: recordInterfaceByModel[rec.modelName],
+            modelName: rec.modelName,
+            fields: rec.fields,
+            stampedFields: ir.stampedFields,
+        }));
+    }
+    // Operation interfaces + result aliases, already sorted by op name in the IR.
+    // Descriptors for the typed-ops factory (#1441), collected in the same order.
+    const factoryOps = [];
+    for (const op of ir.ops) {
+        blocks.push(renderOpParamsInterface({
+            interfaceName: opParamsInterfaceName(op.opName),
+            opName: op.opName,
+            params: op.params,
+        }));
+        factoryOps.push({
+            propertyKey: objectPropertyKey(op.opName),
+            opName: op.opName,
+            paramsInterfaceName: opParamsInterfaceName(op.opName),
+            resultAliasName: opResultAliasName(op.opName),
+            hasParams: op.hasParams,
+        });
+        const recordInterfaceName = op.resultModelName
+            ? recordInterfaceByModel[op.resultModelName] ?? null
+            : null;
+        const pipelineReturn = op.pipelineReturn
+            ? mapPipelineReturn(op.pipelineReturn, recordInterfaceByModel)
+            : undefined;
+        blocks.push(renderOpResultAlias({
+            aliasName: opResultAliasName(op.opName),
+            opName: op.opName,
+            opType: op.opType,
+            recordInterfaceName,
+            projection: op.projection,
+            pipelineReturn,
+        }));
+    }
+    // Typed-subscriptions descriptors (#1544 Phase 2): map each subscription's
+    // model to its record interface (or a `Pick` when it declares `select`). The
+    // IR already validated that every model resolves and every select field is a
+    // known member, so this mapping never fails.
+    const factorySubscriptions = ir.subscriptions.map((sub) => {
+        const interfaceName = recordInterfaceByModel[sub.modelName];
+        // `Pick<Record, "a" | "b">` when the subscription projects fields, else
+        // the bare record interface — built as a `TypeNode` (mirroring
+        // `queryResultGeneric`'s projection) so the emitter can break it the way
+        // Prettier would inside `SubscribeOptions<...>` / `subscribe<...>`.
+        const eventType = sub.select && sub.select.length > 0
+            ? generic("Pick", [atom(interfaceName), fieldNameUnion(sub.select)])
+            : atom(interfaceName);
+        return {
+            propertyKey: objectPropertyKey(sub.subscriptionKey),
+            subscriptionKey: sub.subscriptionKey,
+            eventType,
+        };
+    });
+    // Typed-ops factory (#1441) + typed-subscriptions factory (#1544 Phase 2),
+    // sharing one structural client interface. Omitted entirely for a type with
+    // neither ops nor subscriptions.
+    if (factoryOps.length > 0 || factorySubscriptions.length > 0) {
+        blocks.push(renderFactories({
+            databaseType: input.databaseType,
+            opsFactoryName: opsFactoryName(input.databaseType),
+            subscriptionsFactoryName: subscriptionsFactoryName(input.databaseType),
+            ops: factoryOps,
+            subscriptions: factorySubscriptions,
+        }));
+    }
+    // Single trailing newline; blocks separated by a blank line.
+    return blocks.join("\n\n") + "\n";
+}
+/**
+ * Run codegen end-to-end across one or more database-type TOML inputs. The
+ * disk lifecycle (write / `--check` / stale cleanup) is delegated to the
+ * shared `writeOrCheckGeneratedFiles` (shared with `workflows codegen`).
+ */
+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));
+    }
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        // A single-type filter run owns only a subset of the generated files, so
+        // orphan cleanup / stale detection must be scoped to the filtered file.
+        fullOwnership: options.singleType !== true,
+        generatedSuffix: GENERATED_FILE_SUFFIX,
+    });
+}
+//# 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,87 @@
+/**
+ * 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;
+/**
+ * Name of the generated typed-operations factory for a database type (#1441).
+ * `securities-ref` → `securitiesRefOps`, `portfolio` → `portfolioOps`. A type
+ * whose camelCased name would start with a digit (e.g. `2fa`) gets a leading
+ * `_` so the emitted `export function` name is a valid JS identifier.
+ */
+export declare function opsFactoryName(databaseType: string): string;
+/**
+ * Name of the generated typed-subscriptions factory for a database type
+ * (#1544 Phase 2). Same casing + leading-digit guard as {@link opsFactoryName}:
+ * `tasks-db` → `tasksDbSubscriptions`, `2fa` → `_2faSubscriptions`. Kept a
+ * separate export from `<type>Ops` (Fork 4 = A): realtime subscriptions are a
+ * different surface than HTTP `executeOperation`.
+ */
+export declare function subscriptionsFactoryName(databaseType: string): string;
+/**
+ * camelCase an identifier: splits on non-alphanumeric separators, lower-cases
+ * the first segment's first char and PascalCases the rest
+ * (`securities-ref` → `securitiesRef`, `save_account` → `saveAccount`). Existing
+ * internal casing after the first char is preserved.
+ */
+export declare function camelCase(name: string): string;
+/**
+ * Render a name (an operation name #1441, or a subscription key #1544 Phase 2)
+ * as an object-literal property key. A name that is a plain, non-reserved JS
+ * identifier is emitted bare (`getX:`); anything else — a hyphen, a leading
+ * digit, or a reserved word — is emitted as a quoted key (`"get-x":`,
+ * `"delete":`) so the factory stays valid TypeScript. The original name string
+ * passed to `executeOperation` / `subscribe` is always the exact original name.
+ *
+ * `__proto__` is a special case. The factory return value is a *runtime* object
+ * literal, and in that position both the bare `__proto__:` form AND the quoted
+ * `"__proto__":` form set the object's prototype instead of defining an own
+ * method — silently dropping that operation. Only a computed key
+ * (`["__proto__"]:`) defines a normal own property, so emit that form.
+ *
+ * A quoted key uses `tsStringLiteral` (Prettier's fewer-escapes quote choice),
+ * not `JSON.stringify`, so a quote-bearing op name / subscription key (e.g.
+ * `weird"key` → `'weird"key':`) stays a fixed point of Prettier's default
+ * config (#1678). For identifier and quote-free keys the two are identical.
+ */
+export declare function objectPropertyKey(name: 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,180 @@
+/**
+ * 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`).
+ */
+import { tsStringLiteral } from "../codegen-shared/prettierStable.js";
+/**
+ * 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`;
+}
+/**
+ * Name of the generated typed-operations factory for a database type (#1441).
+ * `securities-ref` → `securitiesRefOps`, `portfolio` → `portfolioOps`. A type
+ * whose camelCased name would start with a digit (e.g. `2fa`) gets a leading
+ * `_` so the emitted `export function` name is a valid JS identifier.
+ */
+export function opsFactoryName(databaseType) {
+    const base = camelCase(databaseType);
+    const safe = /^[0-9]/.test(base) ? `_${base}` : base;
+    return `${safe}Ops`;
+}
+/**
+ * Name of the generated typed-subscriptions factory for a database type
+ * (#1544 Phase 2). Same casing + leading-digit guard as {@link opsFactoryName}:
+ * `tasks-db` → `tasksDbSubscriptions`, `2fa` → `_2faSubscriptions`. Kept a
+ * separate export from `<type>Ops` (Fork 4 = A): realtime subscriptions are a
+ * different surface than HTTP `executeOperation`.
+ */
+export function subscriptionsFactoryName(databaseType) {
+    const base = camelCase(databaseType);
+    const safe = /^[0-9]/.test(base) ? `_${base}` : base;
+    return `${safe}Subscriptions`;
+}
+/**
+ * camelCase an identifier: splits on non-alphanumeric separators, lower-cases
+ * the first segment's first char and PascalCases the rest
+ * (`securities-ref` → `securitiesRef`, `save_account` → `saveAccount`). Existing
+ * internal casing after the first char is preserved.
+ */
+export function camelCase(name) {
+    const pascal = pascalCase(name);
+    if (pascal.length === 0)
+        return pascal;
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * JS reserved words. Used as object-literal property keys these are actually
+ * legal unquoted, but quoting them keeps the generated output unambiguous and
+ * matches the "non-identifier op name -> quoted key" behavior (#1441).
+ */
+const RESERVED_WORDS = new Set([
+    "break", "case", "catch", "class", "const", "continue", "debugger",
+    "default", "delete", "do", "else", "enum", "export", "extends", "false",
+    "finally", "for", "function", "if", "import", "in", "instanceof", "new",
+    "null", "return", "super", "switch", "this", "throw", "true", "try",
+    "typeof", "var", "void", "while", "with", "yield", "let", "static",
+    "implements", "interface", "package", "private", "protected", "public",
+]);
+/**
+ * Render a name (an operation name #1441, or a subscription key #1544 Phase 2)
+ * as an object-literal property key. A name that is a plain, non-reserved JS
+ * identifier is emitted bare (`getX:`); anything else — a hyphen, a leading
+ * digit, or a reserved word — is emitted as a quoted key (`"get-x":`,
+ * `"delete":`) so the factory stays valid TypeScript. The original name string
+ * passed to `executeOperation` / `subscribe` is always the exact original name.
+ *
+ * `__proto__` is a special case. The factory return value is a *runtime* object
+ * literal, and in that position both the bare `__proto__:` form AND the quoted
+ * `"__proto__":` form set the object's prototype instead of defining an own
+ * method — silently dropping that operation. Only a computed key
+ * (`["__proto__"]:`) defines a normal own property, so emit that form.
+ *
+ * A quoted key uses `tsStringLiteral` (Prettier's fewer-escapes quote choice),
+ * not `JSON.stringify`, so a quote-bearing op name / subscription key (e.g.
+ * `weird"key` → `'weird"key':`) stays a fixed point of Prettier's default
+ * config (#1678). For identifier and quote-free keys the two are identical.
+ */
+export function objectPropertyKey(name) {
+    if (name === "__proto__")
+        return `[${tsStringLiteral(name)}]`;
+    const isPlainIdentifier = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
+    if (isPlainIdentifier && !RESERVED_WORDS.has(name))
+        return name;
+    return tsStringLiteral(name);
+}
+/**
+ * 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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"}