primitive-admin 1.0.53 → 1.0.55

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

@@ -29,6 +29,43 @@ export declare function resolveRecordInterfaceName(modelName: string, classNameO
 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.
+ */
+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

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

@@ -43,6 +43,76 @@ export function opParamsInterfaceName(opName) {
 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.
+ */
+export function objectPropertyKey(name) {
+    if (name === "__proto__")
+        return `[${JSON.stringify(name)}]`;
+    const isPlainIdentifier = /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
+    if (isPlainIdentifier && !RESERVED_WORDS.has(name))
+        return name;
+    return JSON.stringify(name);
+}
 /**
  * Convert a snake_case plural model name (`user_prefs`, `categories`) into a
  * PascalCase singular interface name (`UserPref`, `Category`). Returns null

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

@@ -1 +1 @@
-{"version":3,"file":"dbNaming.js","sourceRoot":"","sources":["../../../../src/lib/db-codegen/dbNaming.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dbNaming.js","sourceRoot":"","sources":["../../../../src/lib/db-codegen/dbNaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,iBAAqC;IAErC,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACvC,0EAA0E;IAC1E,oDAAoD;IACpD,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;AACvC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,OAAO,GAAG,IAAI,KAAK,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAAoB;IAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,OAAO,GAAG,IAAI,eAAe,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU;IAClE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;IACvE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK;IACvE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;IACnE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ;IAClE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ;CACvE,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7D,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,iBAAiB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,gBAAgB,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3C,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC5E,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACxD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

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

@@ -11,7 +11,12 @@
  *      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 keyed off `op.type`.
+ *      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.
  */
 /** A field on a record interface (read shape). */
 export interface RecordField {
@@ -42,7 +47,7 @@ export interface RenderRecordInterfaceInput {
 /** One declared param on an op-input interface (write shape). */
 export interface ParamField {
     name: string;
-    /** TOML param type (`string|number|boolean|object`). */
+    /** TOML param type (`string|number|boolean|object|array`). */
     type: string;
     required: boolean;
     /**
@@ -51,6 +56,13 @@ export interface ParamField {
      * renders the union when present and falls back to the base type otherwise.
      */
     enum?: string[];
+    /**
+     * Scalar element type for an `array` param (#1488), either declared
+     * (`type = "array"` + `items = "..."`) or inferred from a `$in`/`$nin`
+     * binding. Undefined on a non-array param, or on an array whose element type
+     * could not be resolved (renders `unknown[]`).
+     */
+    items?: string;
 }
 export interface RenderOpParamsInterfaceInput {
     /** PascalCase params interface name (e.g. `SaveAccountParams`). */
@@ -59,6 +71,49 @@ export interface RenderOpParamsInterfaceInput {
     opName: string;
     params: ParamField[];
 }
+/**
+ * How a query op's static `projection` narrows its record type (#1439). The
+ * generator resolves the projection against the model's record fields (guarding
+ * unknown / nested keys) and hands the template one of these; the template only
+ * assembles the `Pick`/`Partial` string.
+ *   - `full`    → `QueryResult<M>` (no projection, empty `{}`, or no schema).
+ *   - `pick`    → `QueryResult<Pick<M, ...fields>>` (inclusion; `id` folded in).
+ *   - `omit`    → `QueryResult<Omit<M, ...fields>>` (static all-exclusion over
+ *                 known schema fields, minus `id`/`type`). The DO strips excluded
+ *                 fields server-side (#1493 / issue #1456), so the excluded fields
+ *                 are genuinely absent from the result and `Omit` is truthful.
+ *   - `partial` → `QueryResult<Partial<M>>` (dynamic / mixed / unknown-key /
+ *                 nested-key exclusion — the honest fallback when the excluded set
+ *                 can't be resolved to known members; #1439/Codex-P2).
+ */
+export type ProjectionClassification = {
+    kind: "full";
+} | {
+    kind: "pick";
+    fields: string[];
+} | {
+    kind: "omit";
+    fields: string[];
+} | {
+    kind: "partial";
+};
+/**
+ * A `pipeline` op's resolved `return` step (#1437). The runtime flattens a
+ * returning pipeline to the returned step's shape, so codegen types it as that
+ * step's result. `return: "all"`, no `return`, or any step the generator can't
+ * resolve fall back to `opaque` → the generic `PipelineResult`.
+ */
+export type PipelineReturnDescriptor = {
+    kind: "query";
+    recordInterfaceName: string | null;
+    projection?: ProjectionClassification;
+} | {
+    kind: "count";
+} | {
+    kind: "aggregate";
+} | {
+    kind: "opaque";
+};
 export interface RenderOpResultAliasInput {
     /** Per-op result alias name (e.g. `SaveAccountResult`). */
     aliasName: string;
@@ -72,9 +127,24 @@ export interface RenderOpResultAliasInput {
      * interface (e.g. pipeline) — falls back to `QueryResult<Record<string, unknown>>`.
      */
     recordInterfaceName: string | null;
+    /**
+     * For `query` ops (#1439), how the op's `projection` narrows the record type.
+     * Absent → treated as `full`.
+     */
+    projection?: ProjectionClassification;
+    /**
+     * For `pipeline` ops (#1437), the resolved `return`-step descriptor. Absent
+     * or `opaque` → the generic `PipelineResult`.
+     */
+    pipelineReturn?: PipelineReturnDescriptor;
 }
-/** The shared generic result aliases, keyed off `op.type`. */
-export declare const RESULT_ALIASES_BLOCK = "// Generic per-op result shapes, keyed off the operation type. The op\n// return contract is NOT stored in the TOML \u2014 these mirror the runtime\n// result shapes produced by the database-operations controller.\n\n/** `query` ops return a page of records. */\nexport interface QueryResult<T = Record<string, unknown>> {\n  data: T[];\n  hasMore?: boolean;\n  nextCursor?: string;\n}\n\n/** `mutation` ops return per-step results. */\nexport interface MutationResult {\n  results: unknown[];\n}\n\n/** `count` ops return a single count. */\nexport interface CountResult {\n  count: number;\n}\n\n/** `aggregate` ops return a single result object. */\nexport interface AggregateResult {\n  result: Record<string, unknown>;\n}\n\n/** `applyToQuery` ops return match/affect/fail counts. */\nexport interface ApplyToQueryResult {\n  matched: number;\n  affected: number;\n  failed: number;\n  sample?: unknown[];\n}\n\n/** `pipeline` ops return per-step results keyed by step name. */\nexport interface PipelineResult {\n  steps: Record<string, unknown>;\n}\n";
+/**
+ * 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 declare const RESULT_ALIASES_BLOCK = "// Generic per-op result shapes. These mirror the runtime result shapes\n// produced by the database-operations controller; per-op aliases reference\n// them (or a narrowed form when the op definition makes the shape derivable).\n\n/** `query` ops return a page of records. */\nexport interface QueryResult<T = Record<string, unknown>> {\n  data: T[];\n  hasMore?: boolean;\n  nextCursor?: string;\n}\n\n/**\n * One step's result inside a `mutation` op's uniform response (#1458).\n * `op` is the step kind; `id` is the record id (the resolved canonical id for\n * `upsertOn` saves). `values` carries an `increment` step's post-increment\n * counters; `error` a per-step failure string.\n */\nexport interface MutationStepResult {\n  op: \"save\" | \"patch\" | \"delete\" | \"increment\" | \"addToSet\" | \"removeFromSet\";\n  success: boolean;\n  id: string;\n  values?: Record<string, number>;\n  error?: string;\n}\n\n/**\n * Every `mutation` op returns a uniform `{ results: MutationStepResult[] }`\n * in DEFINITION-STEP order \u2014 one entry per step, tagged with its `op` kind and\n * record `id` (#1458). This is a SUCCESS-PATH guarantee: a step that fails at\n * the HTTP level surfaces as an error, and committed sibling writes in the same\n * op are not reported (the ops are not yet executed atomically \u2014 see #1478).\n */\nexport interface MutationResult {\n  results: MutationStepResult[];\n}\n\n/** `count` ops return a single count. */\nexport interface CountResult {\n  count: number;\n}\n\n/** `aggregate` ops return a single result object. */\nexport interface AggregateResult {\n  result: Record<string, unknown>;\n}\n\n/** `applyToQuery` ops return match/affect/fail counts. */\nexport interface ApplyToQueryResult {\n  matched: number;\n  affected: number;\n  failed: number;\n  sample?: unknown[];\n}\n\n/** `pipeline` ops return per-step results keyed by step name. */\nexport interface PipelineResult {\n  steps: Record<string, unknown>;\n}\n";
 /**
  * Render the header (banner + regen hint + fingerprint).
  */
@@ -92,6 +162,96 @@ export declare function renderRecordInterface(input: RenderRecordInterfaceInput)
  */
 export declare function renderOpParamsInterface(input: RenderOpParamsInterfaceInput): string;
 /**
- * Render a per-op result alias keyed off `op.type`.
+ * 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 declare function renderOpResultAlias(input: RenderOpResultAliasInput): string;
+/** One operation the typed-ops factory exposes as a method (#1441). */
+export interface OpsFactoryOp {
+    /**
+     * Object-literal property key for the method — bare (`getX`) for a plain JS
+     * identifier, or a quoted string (`"get-x"`, `"delete"`) for a hyphenated /
+     * reserved-word / leading-digit op name. Produced by `objectPropertyKey`.
+     */
+    propertyKey: string;
+    /** Exact operation name passed as the `executeOperation` string argument. */
+    opName: string;
+    /** The op's `<Op>Params` interface name (write shape). */
+    paramsInterfaceName: string;
+    /** The op's `<Op>Result` alias name (read shape). */
+    resultAliasName: string;
+    /**
+     * Whether the op declares any params. A param-less op yields a method callable
+     * with no arguments (`ops.foo()`); its only arg is the optional `options`.
+     */
+    hasParams: boolean;
+}
+export interface RenderOpsFactoryInput {
+    /** Factory function name (e.g. `securitiesRefOps`). */
+    factoryName: string;
+    /** Database type name, for the doc comment. */
+    databaseType: string;
+    /** Operations to expose, in deterministic (name-sorted) order. */
+    ops: OpsFactoryOp[];
+}
+/**
+ * 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 declare function renderOpsFactory(input: RenderOpsFactoryInput): string;
+/** One subscription the typed-subscriptions factory exposes as a method. */
+export interface SubscriptionFactoryEntry {
+    /**
+     * Object-literal property key for the method — bare (`myTasks`) or a quoted /
+     * computed key for a non-identifier subscription key. Produced by
+     * `objectPropertyKey`.
+     */
+    propertyKey: string;
+    /** Exact subscription key string passed to `subscribe`. */
+    subscriptionKey: string;
+    /**
+     * The record type bound to the change payload — a record interface name
+     * (`Task`) or a projection (`Pick<Task, "id" | "name">`) when the
+     * subscription declares `select`.
+     */
+    eventType: string;
+}
+export interface RenderFactoriesInput {
+    /** Database type name, for the doc comments. */
+    databaseType: string;
+    /** Name of the `<type>Ops` factory function. */
+    opsFactoryName: string;
+    /** Name of the `<type>Subscriptions` factory function. */
+    subscriptionsFactoryName: string;
+    /** Operations to expose, in deterministic (name-sorted) order. */
+    ops: OpsFactoryOp[];
+    /** Subscriptions to expose, in deterministic (key-sorted) order. */
+    subscriptions: SubscriptionFactoryEntry[];
+}
+/**
+ * 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 declare function renderFactories(input: RenderFactoriesInput): string;