primitive-admin 1.1.0-alpha.9 → 1.1.0

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

@@ -0,0 +1,480 @@
+/**
+ * Pure string templates for the `databases codegen` generator (issue #814).
+ *
+ * FORMATTING CONTRACT (#1565): the emitted TypeScript must be a fixed point of
+ * Prettier's DEFAULT config — `prettier --write` over a generated file must
+ * leave it byte-for-byte unchanged, because `--check` byte-compares. There is
+ * no Prettier dependency and no automated round-trip test to catch a
+ * regression, so any edit here that changes line shapes must be verified by
+ * hand (regenerate a representative output, run Prettier over it, confirm no
+ * diff). Wrap long constructs through `codegen-shared/prettierStable.ts` rather
+ * than hand-joining strings — see that file's header for the full contract.
+ *
+ * Mirrors the codegen-v2 template style
+ * (`packages/js-bao/src/cli/v2/templates.ts`): total functions (no I/O, no
+ * hidden state), an auto-generated banner + fingerprint header, and
+ * deterministic ordering so `--check` can compare byte-for-byte.
+ *
+ * Diverges from codegen-v2 in two ways:
+ *   1. Database-DO records are schemaless documents, NOT `BaseModel` ORM
+ *      classes — so we emit plain `export interface` types with no class
+ *      shell, no barrel registration, and `import type` only.
+ *   2. We add an OPERATIONS half codegen-v2 has no analog for: per-op
+ *      input-params interfaces + per-op result aliases. The alias for an op
+ *      is derived from `op.type` AND, where it matters, the op's parsed
+ *      `definition`: a query op's `projection` (#1439), a mutation op's step
+ *      kinds (#1438), and a pipeline op's `return` step (#1437). The generator
+ *      resolves those into the small descriptors below; the templates stay pure
+ *      string-emitters.
+ */
+import { typeNodeForDbField, typeNodeForDbParamType } from "./dbTsTypes.js";
+import { atom, generic, recordOf, renderArrowProperty, renderMember, renderParenList, renderTypeAlias, tsStringLiteral, union, } from "../codegen-shared/prettierStable.js";
+const HEADER_BANNER = "// AUTO-GENERATED FROM database-type-configs TOML — DO NOT EDIT.";
+const REGEN_INSTRUCTION = "// Run `primitive databases codegen <database-type>` to regenerate.";
+/**
+ * The shared generic result shapes referenced by the per-op aliases. These
+ * mirror the runtime result shapes produced by the database-operations
+ * controller; per-op aliases point at them (and, where the definition makes the
+ * shape derivable, at a narrowed form — see `renderOpResultAlias`).
+ */
+export const RESULT_ALIASES_BLOCK = `// Generic per-op result shapes. These mirror the runtime result shapes
+// produced by the database-operations controller; per-op aliases reference
+// them (or a narrowed form when the op definition makes the shape derivable).
+
+/** \`query\` ops return a page of records. */
+export interface QueryResult<T = Record<string, unknown>> {
+  data: T[];
+  hasMore?: boolean;
+  nextCursor?: string;
+}
+
+/**
+ * One step's result inside a \`mutation\` op's uniform response (#1458).
+ * \`op\` is the step kind; \`id\` is the record id (the resolved canonical id for
+ * \`upsertOn\` saves). \`values\` carries an \`increment\` step's post-increment
+ * counters; \`error\` a per-step failure string.
+ */
+export interface MutationStepResult {
+  op: "save" | "patch" | "delete" | "increment" | "addToSet" | "removeFromSet";
+  success: boolean;
+  id: string;
+  values?: Record<string, number>;
+  error?: string;
+}
+
+/**
+ * Every \`mutation\` op returns a uniform \`{ results: MutationStepResult[] }\`
+ * in DEFINITION-STEP order — one entry per step, tagged with its \`op\` kind and
+ * record \`id\` (#1458). This is a SUCCESS-PATH guarantee: a step that fails at
+ * the HTTP level surfaces as an error, and committed sibling writes in the same
+ * op are not reported (the ops are not yet executed atomically — see #1478).
+ */
+export interface MutationResult {
+  results: MutationStepResult[];
+}
+
+/** \`count\` ops return a single count. */
+export interface CountResult {
+  count: number;
+}
+
+/** \`aggregate\` ops return a single result object. */
+export interface AggregateResult {
+  result: Record<string, unknown>;
+}
+
+/** \`applyToQuery\` ops return match/affect/fail counts. */
+export interface ApplyToQueryResult {
+  matched: number;
+  affected: number;
+  failed: number;
+  sample?: unknown[];
+}
+
+/** \`pipeline\` ops return per-step results keyed by step name. */
+export interface PipelineResult {
+  steps: Record<string, unknown>;
+}
+`;
+/**
+ * Render the header (banner + regen hint + fingerprint).
+ */
+export function renderHeader(fingerprint) {
+    return [
+        HEADER_BANNER,
+        REGEN_INSTRUCTION,
+        `// fingerprint: ${fingerprint}`,
+    ].join("\n");
+}
+/**
+ * Render a single record interface (read shape). Stamped fields
+ * (`createdAt`, `modifiedAt`, `ownerId`, …) are appended as OPTIONAL props
+ * if not already present in `fields`.
+ */
+export function renderRecordInterface(input) {
+    const { interfaceName, fields, stampedFields } = input;
+    const memberLines = [];
+    const declared = new Set();
+    for (const f of fields) {
+        declared.add(f.name);
+        memberLines.push(renderMember(1, f.name, !f.required, typeNodeForDbField(f.type, f.enum)));
+    }
+    // Server-stamped fields appear on the read interface as optional —
+    // the runtime populates them, but a freshly-built object may not have
+    // them yet, so claiming them as required would be a type lie.
+    for (const stamped of stampedFields) {
+        if (declared.has(stamped))
+            continue;
+        declared.add(stamped);
+        memberLines.push(`  ${stamped}?: string;`);
+    }
+    // A record with no fields and no stamped fields would render an empty
+    // `interface X {}`, which trips `@typescript-eslint/no-empty-object-type`.
+    // Emit a `Record<string, unknown>` type alias instead. Database-DO records
+    // are SCHEMALESS — arbitrary runtime keys can exist — so the empty-schema
+    // shape must stay OPEN (`Record<string, unknown>`), NOT `Record<string,
+    // never>`. `Record<string, never>` forbids every key, which would make real
+    // returned records unassignable to `QueryResult<X>` and unusable in TS.
+    // (Contrast with the no-param-op case in `renderOpParamsInterface`, where
+    // `Record<string, never>` is correct: it means "no params allowed".)
+    if (memberLines.length === 0) {
+        return renderTypeAlias(interfaceName, recordOf("unknown"));
+    }
+    const lines = [];
+    lines.push(`export interface ${interfaceName} {`);
+    lines.push(...memberLines);
+    lines.push(`}`);
+    return lines.join("\n");
+}
+/**
+ * Render a single op-input-params interface (write shape). `required: true`
+ * params are non-optional; others are optional. `object` params render as
+ * `Record<string, any>`.
+ */
+export function renderOpParamsInterface(input) {
+    const { interfaceName, params } = input;
+    // An op with no declared params has no input shape. Emitting an empty
+    // `interface X {}` trips `@typescript-eslint/no-empty-object-type`, so
+    // render a `Record<string, never>` type alias instead — it types "no
+    // params allowed" and stays call-site compatible (`op({})`).
+    if (params.length === 0) {
+        return renderTypeAlias(interfaceName, recordOf("never"));
+    }
+    const lines = [];
+    lines.push(`export interface ${interfaceName} {`);
+    for (const p of params) {
+        lines.push(renderMember(1, p.name, !p.required, typeNodeForDbParamType(p.type, p.enum, p.items)));
+    }
+    lines.push(`}`);
+    return lines.join("\n");
+}
+/**
+ * Compute the generic argument for a `QueryResult<...>` from the op's record
+ * interface + projection classification (#1439). Reused for a pipeline op's
+ * returning `query` step (#1437), so both type identically to a plain query.
+ *
+ * A null record interface (the op's model has no `[models.*]` schema) has
+ * nothing to `Pick` from, so it always falls back to
+ * `Record<string, unknown>` regardless of any projection.
+ */
+function queryResultGeneric(recordInterfaceName, projection) {
+    if (recordInterfaceName === null)
+        return recordOf("unknown");
+    const record = atom(recordInterfaceName);
+    const p = projection ?? { kind: "full" };
+    switch (p.kind) {
+        case "full":
+            return record;
+        case "partial":
+            return generic("Partial", [record]);
+        case "pick": {
+            // The generator guarantees a non-empty, field-guarded, sorted list; a
+            // defensive empty check keeps this total. Field names are emitted as TS
+            // string literals via JSON.stringify.
+            if (p.fields.length === 0)
+                return record;
+            return generic("Pick", [record, fieldNameUnion(p.fields)]);
+        }
+        case "omit": {
+            // Static all-exclusion over known members (id/type already filtered out by
+            // the generator). The classifier guarantees a non-empty, sorted, member-
+            // guarded list; the defensive empty check keeps this total. Same literal
+            // emission style as `pick`.
+            if (p.fields.length === 0)
+                return record;
+            return generic("Omit", [record, fieldNameUnion(p.fields)]);
+        }
+    }
+}
+/** A `Pick`/`Omit` key union (`"a" | "b"`), wrappable when it gets long. */
+export function fieldNameUnion(fields) {
+    return union(fields.map((f) => atom(JSON.stringify(f))));
+}
+/**
+ * Render a per-op result alias. The alias is derived from `op.type` and, where
+ * the shape is derivable from the parsed op definition, a narrowed form:
+ *   - `query`    → `QueryResult<M>`, narrowed by the op `projection` (#1439).
+ *   - `mutation` → `MutationResult` — every mutation op returns the uniform
+ *                  `{ results: MutationStepResult[] }` in definition order (#1458).
+ *   - `pipeline` → the returned step's result type (#1437); `return: "all"` /
+ *                  no-return / unresolvable keep the generic `PipelineResult`.
+ */
+export function renderOpResultAlias(input) {
+    const { aliasName, opType, recordInterfaceName, projection } = input;
+    const alias = (node) => renderTypeAlias(aliasName, node);
+    switch (opType) {
+        case "query":
+            return alias(generic("QueryResult", [
+                queryResultGeneric(recordInterfaceName, projection),
+            ]));
+        case "mutation":
+            // Every mutation op returns the uniform `{ results: MutationStepResult[] }`
+            // in definition-step order (#1458) — no more per-category flat shapes.
+            return alias(atom("MutationResult"));
+        case "count":
+            return alias(atom("CountResult"));
+        case "aggregate":
+            return alias(atom("AggregateResult"));
+        case "applyToQuery":
+            return alias(atom("ApplyToQueryResult"));
+        case "pipeline": {
+            const d = input.pipelineReturn ?? { kind: "opaque" };
+            switch (d.kind) {
+                case "query":
+                    return alias(generic("QueryResult", [
+                        queryResultGeneric(d.recordInterfaceName, d.projection),
+                    ]));
+                case "count":
+                    return alias(atom("CountResult"));
+                case "aggregate":
+                    return alias(atom("AggregateResult"));
+                // `opaque` — `return: "all"`, no `return`, or a step the generator
+                // couldn't resolve — keeps the generic `PipelineResult` (unchanged).
+                case "opaque":
+                default:
+                    return alias(atom("PipelineResult"));
+            }
+        }
+        default:
+            // Unknown op type — emit a permissive alias rather than throwing,
+            // so one stray op doesn't block codegen for the whole file.
+            return alias(atom("unknown"));
+    }
+}
+// The `databases.executeOperation<R>` member on the structural client shape.
+// `object` (not `Record<string, unknown>`) so a strict generated `<Op>Params`
+// interface — which has no index signature — is still assignable here.
+const EXECUTE_OPERATION_MEMBER = [
+    "    executeOperation<R>(",
+    "      databaseId: string,",
+    "      name: string,",
+    "      options?: {",
+    "        params?: object;",
+    "        limit?: number;",
+    "        cursor?: string;",
+    "        direction?: 1 | -1;",
+    "        timing?: boolean;",
+    "      },",
+    "    ): Promise<R>;",
+];
+// The `databases.subscribe<T>` member on the structural client shape
+// (#1544 Phase 2). Mirrors the client's `subscribe<T, P>` closely enough that
+// the real `JsBaoClient` satisfies it structurally; `P` defaults there so the
+// single generic here is compatible.
+const SUBSCRIBE_MEMBER = [
+    "    subscribe<T>(",
+    "      databaseId: string,",
+    "      subscriptionKey: string,",
+    "      options: SubscribeOptions<T>,",
+    "    ): () => void;",
+];
+// Non-param options (pagination + diagnostics) each ops factory method accepts.
+const OPS_CALL_OPTIONS_BLOCK = [
+    "// Non-param options (pagination + diagnostics) each factory method accepts",
+    "// alongside its params, passed straight through to `executeOperation`.",
+    "interface OpsCallOptions {",
+    "  limit?: number;",
+    "  cursor?: string;",
+    "  direction?: 1 | -1;",
+    "  timing?: boolean;",
+    "}",
+].join("\n");
+// Inlined structural subscribe types (#1544 Phase 2) — import-free mirrors of
+// the client's `DatabaseSubscribeOptions` / `DatabaseChangePayload` /
+// `DatabaseChangeEvent`. `T` is the record type bound to each change; a
+// projected subscription binds `T` to a `Pick<Record, …select>`.
+const SUBSCRIBE_TYPES_BLOCK = [
+    "interface SubscribeOptions<T> {",
+    "  params?: Record<string, any>;",
+    "  onChange: (event: SubscribeChangePayload<T>) => void;",
+    "}",
+    "interface SubscribeChangePayload<T> {",
+    '  type: "db.change";',
+    "  databaseId: string;",
+    "  subscriptionKey: string;",
+    "  changes: SubscribeChangeEvent<T>[];",
+    "  timestamp: string;",
+    "  originConnectionId: string | null;",
+    "  originUserId: string | null;",
+    "  isOrigin: boolean;",
+    "  isOriginUser: boolean;",
+    "}",
+    "interface SubscribeChangeEvent<T> {",
+    '  changeType?: "enter" | "update" | "leave";',
+    '  op: "save" | "patch" | "delete" | "increment" | "addToSet" | "removeFromSet";',
+    "  modelName: string;",
+    "  id: string;",
+    "  data?: T | null;",
+    "  previousData?: T | null;",
+    "}",
+].join("\n");
+/**
+ * The inlined structural client shape, carrying whichever members the file
+ * needs (`executeOperation` for ops, `subscribe` for subscriptions). One shared
+ * `OpsClient` interface serves both the `<type>Ops` and `<type>Subscriptions`
+ * factories so the file never declares the interface twice.
+ */
+function renderClientInterface(members) {
+    return [
+        "// Minimal structural client shape — inlined so this file stays import-free",
+        "// and carries no runtime dependency on the client package. The real",
+        "// `JsBaoClient` satisfies it structurally.",
+        "interface OpsClient {",
+        "  databases: {",
+        ...members,
+        "  };",
+        "}",
+    ].join("\n");
+}
+/** One factory method per op, pairing `<Op>Params` in with `<Op>Result` out. */
+function opsMethodLines(ops) {
+    return ops.map((op) => {
+        const nameLiteral = JSON.stringify(op.opName);
+        // No declared params: the method takes only the optional options object, so
+        // it stays callable with no arguments (`ops.foo()`).
+        const params = op.hasParams
+            ? [`params: ${op.paramsInterfaceName}`, "options?: OpsCallOptions"]
+            : ["options?: OpsCallOptions"];
+        return renderArrowProperty({
+            level: 2,
+            key: op.propertyKey,
+            params,
+            signatureTail: `: Promise<${op.resultAliasName}> =>`,
+            callee: generic("client.databases.executeOperation", [
+                atom(op.resultAliasName),
+            ]),
+            leadingArgs: ["databaseId", nameLiteral],
+            objectMembers: op.hasParams ? ["params", "...options"] : ["...options"],
+            tail: ",",
+        });
+    });
+}
+/** The `export function <type>Ops(...)` factory body. */
+function opsFactoryBlock(factoryName, databaseType, ops) {
+    return [
+        `/** Typed accessor for \`${databaseType}\` operations. */`,
+        renderParenList(`export function ${factoryName}`, ["client: OpsClient", "databaseId: string"], " {", 0),
+        "  return {",
+        ...opsMethodLines(ops),
+        "  };",
+        "}",
+    ].join("\n");
+}
+/**
+ * Render the typed-operations factory (#1441): an inlined structural client
+ * interface + a shared call-options type + the `export function <type>Ops`
+ * factory. Each method pairs an op's `<Op>Params` input with its `<Op>Result`
+ * output and calls `client.databases.executeOperation<<Op>Result>(...)`, so the
+ * generated code carries no `as` cast and no import — the real `JsBaoClient`
+ * satisfies the structural `OpsClient` param.
+ *
+ * Returns "" for a database type with no operations, so the caller can omit the
+ * factory entirely rather than emit an empty function.
+ */
+export function renderOpsFactory(input) {
+    const { factoryName, databaseType, ops } = input;
+    if (ops.length === 0)
+        return "";
+    return [
+        renderClientInterface(EXECUTE_OPERATION_MEMBER),
+        OPS_CALL_OPTIONS_BLOCK,
+        opsFactoryBlock(factoryName, databaseType, ops),
+    ].join("\n\n");
+}
+/**
+ * The `export function <type>Subscriptions(...)` factory body.
+ *
+ * Each method is a `key: (options) => client.databases.subscribe<T>(...)` arrow
+ * routed through `renderArrowProperty` (#1678), so its signature and the
+ * `subscribe(...)` call are a fixed point of Prettier's default config at every
+ * subscription-key length. The `subscribe` call carries NO trailing object-
+ * literal argument (`objectMembers` omitted); `eventType` is a `TypeNode`, so a
+ * `Pick<...>` projection breaks inside `SubscribeOptions<...>` / the type
+ * argument the way Prettier breaks it. The subscription key literal uses
+ * `tsStringLiteral` (Prettier's fewer-escapes quote choice), not
+ * `JSON.stringify`.
+ */
+function subscriptionsFactoryBlock(factoryName, databaseType, subscriptions) {
+    const methodLines = subscriptions.map((sub) => renderArrowProperty({
+        level: 2,
+        key: sub.propertyKey,
+        params: [{ name: "options", type: generic("SubscribeOptions", [sub.eventType]) }],
+        signatureTail: ": (() => void) =>",
+        callee: generic("client.databases.subscribe", [sub.eventType]),
+        leadingArgs: [
+            "databaseId",
+            tsStringLiteral(sub.subscriptionKey),
+            "options",
+        ],
+        tail: ",",
+    }));
+    return [
+        `/** Typed accessor for \`${databaseType}\` realtime subscriptions. */`,
+        renderParenList(`export function ${factoryName}`, ["client: OpsClient", "databaseId: string"], " {", 0),
+        "  return {",
+        ...methodLines,
+        "  };",
+        "}",
+    ].join("\n");
+}
+/**
+ * Render the typed-ops factory (#1441) and the typed-subscriptions factory
+ * (#1544 Phase 2) for one database type, sharing a single structural `OpsClient`
+ * interface (Fork 4 = A).
+ *
+ * With no subscriptions this is byte-identical to {@link renderOpsFactory}, so
+ * every existing generated file (none of which has subscriptions) is unchanged.
+ * When subscriptions exist, the shared `OpsClient` gains a `subscribe<T>`
+ * member, the inlined subscribe types are emitted once, and a separate
+ * `<type>Subscriptions` factory follows the ops factory. The file stays
+ * import-free (behavior 10).
+ *
+ * Returns "" when the type has neither ops nor subscriptions.
+ */
+export function renderFactories(input) {
+    const { databaseType, ops, subscriptions } = input;
+    // No subscriptions → identical to the standalone ops factory (keeps every
+    // pre-#1544 generated file byte-for-byte unchanged).
+    if (subscriptions.length === 0) {
+        return renderOpsFactory({
+            factoryName: input.opsFactoryName,
+            databaseType,
+            ops,
+        });
+    }
+    const hasOps = ops.length > 0;
+    const members = [
+        ...(hasOps ? EXECUTE_OPERATION_MEMBER : []),
+        ...SUBSCRIBE_MEMBER,
+    ];
+    const blocks = [renderClientInterface(members)];
+    if (hasOps)
+        blocks.push(OPS_CALL_OPTIONS_BLOCK);
+    blocks.push(SUBSCRIBE_TYPES_BLOCK);
+    if (hasOps) {
+        blocks.push(opsFactoryBlock(input.opsFactoryName, databaseType, ops));
+    }
+    blocks.push(subscriptionsFactoryBlock(input.subscriptionsFactoryName, databaseType, subscriptions));
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=dbTemplates.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * Map database-type TOML field/param types → TypeScript types for the
+ * `databases codegen` generator (issue #814).
+ *
+ * The record-interface half reuses the SAME `FieldType` vocabulary that
+ * powers the document-model codegen-v2 generator
+ * (`packages/js-bao/src/cli/v2/tsTypes.ts`): the database-type
+ * `[models.<m>.fields.<f>]` blocks round-trip through the same
+ * `loadSchemaFromTomlString` loader, so the field→TS mapping is identical
+ * (`string|id|date → string`, `number → number`, `boolean → boolean`,
+ * `stringset → StringSet`).
+ *
+ * The op-params half maps the operation `params.{type}` vocabulary
+ * (`string|number|boolean|object`, validated server-side in
+ * `database-type-operations-controller.ts`). `object` has no field-type
+ * analog and carries no nested schema, so it renders as `Record<string, unknown>`.
+ *
+ * NOTE (#842 — infer required record fields from operation params): when that
+ * issue is scheduled, the op-params analysis it needs (which fields a `$params.X`
+ * binding writes, and whether the param is `required`) already exists in
+ * `inferParamFieldTypes(op)` in
+ * `src/app-api/controllers/database-type-config-controller.ts` (issue #845 /
+ * #812 Phase 2). Its return shape was deliberately made growable (it can carry
+ * a `requiredInThisOp` flag) so it can be lifted into a shared `analyzeOpParams`
+ * pass consumed by BOTH the scaffold (#845, field *type*) and codegen (#842,
+ * field *required-ness*). Lift it rather than re-walking the ops here.
+ */
+import { type TypeNode } from "../codegen-shared/prettierStable.js";
+/**
+ * Field types accepted in a database-type `[models.*]` schema. Mirrors
+ * `FieldType` in `packages/js-bao/src/types/ormTypes.ts`. Declared locally
+ * (rather than imported from `js-bao`) because `FieldType` is not part of
+ * the published `js-bao` entry point and the CLI does not depend on the
+ * library's internal type paths.
+ */
+export type DbFieldType = "string" | "number" | "boolean" | "date" | "id" | "stringset";
+/**
+ * Param types accepted in an `[[operations]]` `params` block. `array` (#1488)
+ * carries a scalar `items` element type; `integer` (also surfaced in #1488 when
+ * reconciling the registration/runtime type lists) maps to `number`.
+ */
+export type DbParamType = "string" | "number" | "boolean" | "integer" | "object" | "array";
+/**
+ * Returns the TS type expression for a record field type. Unknown types
+ * fall back to `unknown` rather than throwing: the database-type TOML is
+ * author-curated and may legitimately carry a field type the CLI's vendored
+ * vocabulary predates, and a hard throw would block codegen for the whole
+ * file over one unrecognized field.
+ */
+export declare function tsTypeForDbFieldType(fieldType: string): string;
+/**
+ * Returns the TS type expression for a record field as a wrappable node,
+ * honoring an optional string `enum` allowed-value set (#843). A non-empty
+ * `enum` on a `string` field renders a string-literal union (a long one in
+ * Prettier's leading-pipe form, #1565); otherwise falls back to the base
+ * `tsTypeForDbFieldType` mapping.
+ */
+export declare function typeNodeForDbField(fieldType: string, enumValues?: string[]): TypeNode;
+/**
+ * Returns the TS type expression for an op param as a wrappable node, honoring
+ * an optional string `enum` allowed-value set (#861). A non-empty `enum` on a
+ * `string` param renders a string-literal union (`"a" | "b"`; a long one in
+ * Prettier's leading-pipe form, #1565); otherwise falls back to the base
+ * param-type mapping below. Mirrors `typeNodeForDbField` (the record-field
+ * sibling) and reuses `unionNodeFromEnum` for a single escaping implementation.
+ *
+ * Unlike the record-field path (validated upstream by `parseFieldOptions`,
+ * which throws), op-param enum *shape* is validated server-side in
+ * `validateParams` at config-push time. So this renderer just falls back to
+ * the base type for a non-string param or an empty enum rather than throwing —
+ * the server is the source of truth for rejecting a malformed param `enum`.
+ */
+export declare function typeNodeForDbParamType(paramType: string, enumValues?: string[], items?: string): TypeNode;