primitive-admin 1.0.53 → 1.0.55

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

@@ -0,0 +1,517 @@
+/**
+ * Shared database-type operation IR (issue #1547, Phase 4).
+ *
+ * `describeDbType` resolves ONE database-type TOML into a naming-neutral
+ * descriptor of its record models and operations — the record fields (with
+ * inferred required-ness), the per-op input params, and the per-op result
+ * descriptor (query projection #1439, mutation, count, aggregate,
+ * applyToQuery, pipeline return #1437). It performs NO language-specific
+ * naming: the TS renderer (`dbGenerator.ts`) and the Swift renderer
+ * (`swift-codegen/dbGenerator.ts`) both consume this SAME IR and each apply
+ * their own identifier rules. Neither renderer re-walks the op definitions, so
+ * the two clients can never disagree on which operations a database type
+ * exposes, what params they take, or what shape they return (issue #1547
+ * binding item 5 — the same "shared operation IR, no metadata reconstruction"
+ * contract Phase 3's `describeWorkflowInvoker` gives the workflow invoker).
+ *
+ * The resolution logic here was lifted verbatim from `renderDbTypeFile`'s
+ * former inline body; the only change is that result descriptors reference a
+ * MODEL NAME (naming-neutral) rather than a resolved TS interface name, so the
+ * Swift renderer can map the same model to its own type name.
+ */
+import { parseConfigToml, stringifyConfigToml } from "../config-toml.js";
+import { loadSchemaFromTomlString } from "js-bao";
+import { parseDatabaseTypeToml } from "../../commands/sync.js";
+import { fingerprintToml } from "./dbFingerprint.js";
+import { tsTypeForDbFieldType } from "./dbTsTypes.js";
+/**
+ * Resolve a database-type TOML into the shared, naming-neutral IR. Pure: no
+ * I/O beyond parsing the passed content. Both the TS and Swift renderers call
+ * this so their op/record metadata can never diverge.
+ */
+export function describeDbType(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 = parseConfigToml(tomlContent);
+    const { typeConfig, operations, subscriptions } = parseDatabaseTypeToml(tomlData);
+    const schemas = tomlData.models
+        ? loadSchemaFromTomlString(stringifyConfigToml({ models: tomlData.models }), {
+            strict: false,
+        })
+        : [];
+    const stampedFields = collectStampedFields(typeConfig);
+    // model → record fields that op params prove are always supplied at create
+    // time; OR'd with the schema-level `required` flag below (#842).
+    const inferredRequired = inferRequiredRecordFields(operations);
+    // model → the field names on its record (declared + stamped), used to guard
+    // projection `pick` against unknown keys (#1439).
+    const recordFieldsByModel = new Map();
+    // model → declared field name → field type, feeding array-param element-type
+    // inference (#1488).
+    const fieldTypesByModel = new Map();
+    for (const schema of schemas) {
+        const ftypes = new Map();
+        for (const [fname, fopts] of Object.entries(schema.fields)) {
+            const t = fopts?.type;
+            if (typeof t === "string")
+                ftypes.set(fname, t);
+        }
+        fieldTypesByModel.set(schema.name, ftypes);
+        const memberNames = new Set(Object.keys(schema.fields));
+        for (const stamped of stampedFields)
+            memberNames.add(stamped);
+        recordFieldsByModel.set(schema.name, memberNames);
+    }
+    const modelsWithRecord = new Set(schemas.map((s) => s.name));
+    // Record IRs (schema order — renderers sort by their own type name).
+    const records = schemas.map((schema) => {
+        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,
+            enum: opts.enum,
+        }));
+        return {
+            modelName: schema.name,
+            className: schema.options?.className,
+            fields,
+        };
+    });
+    // Operation IRs, sorted by op name for deterministic output.
+    const sortedOps = [...operations]
+        .filter((op) => op && typeof op.name === "string")
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const ops = sortedOps.map((op) => {
+        const inferredArrays = inferArrayParamElementTypes(op, fieldTypesByModel);
+        const params = paramsToFields(op.params, inferredArrays);
+        const resultModelName = op.type === "query" && op.modelName && modelsWithRecord.has(op.modelName)
+            ? op.modelName
+            : null;
+        const projection = op.type === "query"
+            ? classifyProjection(op.definition?.projection, (op.modelName && recordFieldsByModel.get(op.modelName)) ||
+                new Set())
+            : undefined;
+        const pipelineReturn = op.type === "pipeline"
+            ? resolvePipelineReturn(op.definition, recordFieldsByModel, modelsWithRecord)
+            : undefined;
+        return {
+            opName: op.name,
+            opType: op.type,
+            params,
+            hasParams: params.length > 0,
+            resultModelName,
+            projection,
+            pipelineReturn,
+        };
+    });
+    // Subscription IRs (#1544 Phase 2), sorted by subscription key for
+    // deterministic output. Each is bound to its declared `modelName`'s record
+    // type; `select` narrows that to a projection.
+    const subscriptionIRs = describeSubscriptions(subscriptions, input.databaseType, modelsWithRecord, recordFieldsByModel);
+    return {
+        databaseType: input.databaseType,
+        fingerprint,
+        stampedFields,
+        records,
+        ops,
+        subscriptions: subscriptionIRs,
+    };
+}
+/**
+ * Resolve the parsed `[[subscriptions]]` rows into naming-neutral IR
+ * (#1544 Phase 2). Sorted by subscription key.
+ *
+ * Precise per-subscription typing (maintainer decision, Fork 2 amended): each
+ * subscription is bound to its declared `modelName`. A subscription whose
+ * `modelName` is missing or names a model this type declares no record schema
+ * for is an authoring error the generator surfaces by THROWING — there is no
+ * silent `Record<string, unknown>` fallback and no discriminated-union fallback
+ * (the server has required `modelName` on every subscription since the feature
+ * shipped in #740, so no legacy no-`modelName` rows exist).
+ *
+ * `select` narrows the event record to a `Pick`; each selected field must be a
+ * known member of the record (or the record must be the open
+ * `Record<string, unknown>` form), else the generator throws rather than emit
+ * an invalid `Pick`.
+ */
+function describeSubscriptions(subscriptions, databaseType, modelsWithRecord, recordFieldsByModel) {
+    const result = (subscriptions ?? [])
+        .filter((sub) => sub && typeof sub.subscriptionKey === "string")
+        .map((sub) => {
+        const subscriptionKey = sub.subscriptionKey;
+        const modelName = sub.modelName;
+        if (typeof modelName !== "string" || modelName === "") {
+            throw new Error(`Subscription "${subscriptionKey}" on database type ` +
+                `"${databaseType}" has no modelName. Every subscription must ` +
+                `declare the model whose changes it delivers.`);
+        }
+        if (!modelsWithRecord.has(modelName)) {
+            throw new Error(`Subscription "${subscriptionKey}" on database type ` +
+                `"${databaseType}" names model "${modelName}", which has no ` +
+                `[models.${modelName}] schema block. Declare the model's schema ` +
+                `so its change payload can be typed.`);
+        }
+        // `select` present (non-empty array) → Pick over those fields. Guard each
+        // field against the record's known members unless the record is the open
+        // `Record<string, unknown>` form (no declared/stamped members), where any
+        // key is valid.
+        let select = null;
+        if (Array.isArray(sub.select) && sub.select.length > 0) {
+            const members = recordFieldsByModel.get(modelName) ?? new Set();
+            const recordIsOpen = members.size === 0;
+            for (const field of sub.select) {
+                if (typeof field !== "string" || field === "") {
+                    throw new Error(`Subscription "${subscriptionKey}" on database type ` +
+                        `"${databaseType}" has a non-string select entry.`);
+                }
+                if (!recordIsOpen && !members.has(field)) {
+                    throw new Error(`Subscription "${subscriptionKey}" on database type ` +
+                        `"${databaseType}" selects field "${field}", which is not ` +
+                        `declared on model "${modelName}". Add it to ` +
+                        `[models.${modelName}] or remove it from select.`);
+                }
+            }
+            select = [...new Set(sub.select)].sort();
+        }
+        return { subscriptionKey, modelName, select };
+    });
+    result.sort((a, b) => a.subscriptionKey.localeCompare(b.subscriptionKey));
+    return result;
+}
+/**
+ * Classify a query op's static `projection` into how it narrows the record type
+ * (#1439). Kept private to the generator: the returned `{ kind, fields }` shape
+ * is what the template needs, and the field-guard / `id`-folding / sorting live
+ * here so the template stays a pure string-emitter.
+ *
+ * `recordFieldNames` is the set of members on the record interface (declared +
+ * stamped). A projected key that is not a member (a nested `"a.b"` path, or a
+ * field absent from the schema) makes the whole projection fall back to
+ * `Partial<M>` rather than emit an invalid `Pick`. Reused for a pipeline
+ * op's returning `query` step (#1437).
+ *
+ * Rules (projection values are validated server-side to be `1` or `0`, mixing
+ * rejected — codegen runs pre-push, so it still guards):
+ *   - absent / not an object / empty `{}`      → `full` (whole record `M`).
+ *   - all `1` (inclusion), keys all known      → `pick` (with `id` folded in,
+ *                                                since inclusion always retains
+ *                                                `id` at runtime).
+ *   - all `0` (exclusion), keys all known       → `omit` (over the excluded set
+ *                                                minus `id`/`type`). The DO strips
+ *                                                excluded fields server-side
+ *                                                (#1493 / issue #1456), so the
+ *                                                rows genuinely omit them and
+ *                                                `Omit<M, …>` is truthful. Falls
+ *                                                back to `partial` when the set is
+ *                                                empty after dropping `id`/`type`.
+ *   - mixed / dynamic / non-`1|0` / unknown /   → `partial` (honest fallback).
+ *     nested-key exclusion
+ */
+function classifyProjection(projection, recordFieldNames) {
+    if (!projection ||
+        typeof projection !== "object" ||
+        Array.isArray(projection)) {
+        return { kind: "full" };
+    }
+    const entries = Object.entries(projection);
+    if (entries.length === 0)
+        return { kind: "full" };
+    let allInclude = true;
+    let allExclude = true;
+    const included = [];
+    const excluded = [];
+    for (const [field, val] of entries) {
+        if (val === 1) {
+            included.push(field);
+            allExclude = false;
+        }
+        else if (val === 0) {
+            excluded.push(field);
+            allInclude = false;
+        }
+        else {
+            // A dynamic (`$params.x`) or otherwise non-`1|0` value — can't resolve
+            // statically. Fall back rather than emit garbage.
+            allInclude = false;
+            allExclude = false;
+        }
+    }
+    if (allInclude && included.length > 0) {
+        if (!included.every((f) => recordFieldNames.has(f)))
+            return { kind: "partial" };
+        // Inclusion always retains `id` at runtime (the DO unshifts it), so fold it
+        // into the union when the model has an `id` field.
+        const fields = new Set(included);
+        if (recordFieldNames.has("id"))
+            fields.add("id");
+        return { kind: "pick", fields: [...fields].sort() };
+    }
+    if (allExclude && excluded.length > 0) {
+        // Static all-exclusion projection (e.g. `{ secret: 0 }`). Since #1493 (issue
+        // #1456) the DO's `_applyProjection` deletes excluded keys server-side, so
+        // the returned rows genuinely omit them and `Omit<M, …>` is the truthful,
+        // tighter type — reading an excluded field off the result is now a compile
+        // error rather than a value that silently existed.
+        //
+        // `id`/`type` are always returned (the validator 400s on excluding them and
+        // the DO force-keeps them), so they can never be in the Omit set — drop them
+        // first. Dropping them is defensive handling of invalid local/unpushed TOML,
+        // not a supported projection shape.
+        const omitKeys = excluded.filter((f) => f !== "id" && f !== "type");
+        // Every remaining key must be a known member so `Omit<M, union>` is valid TS.
+        // A nested `"a.b"` path or an off-schema key falls back to the honest
+        // `Partial`, and an exclusion set that is only `id`/`type` reduces to empty
+        // after filtering (op rejected server-side) → also `Partial`.
+        if (omitKeys.length > 0 && omitKeys.every((f) => recordFieldNames.has(f))) {
+            return { kind: "omit", fields: [...new Set(omitKeys)].sort() };
+        }
+        return { kind: "partial" };
+    }
+    return { kind: "partial" };
+}
+/**
+ * Resolve a pipeline op's `return`-step shape (#1437), naming-neutral (keyed on
+ * model name). Never throws — one odd op must not break codegen for the file.
+ */
+function resolvePipelineReturn(definition, recordFieldsByModel, modelsWithRecord) {
+    if (!definition || typeof definition !== "object")
+        return { kind: "opaque" };
+    const def = definition;
+    const ret = def.return ?? "all";
+    if (ret === "all" || typeof ret !== "string")
+        return { kind: "opaque" };
+    if (!Array.isArray(def.steps))
+        return { kind: "opaque" };
+    const step = def.steps.find((s) => s && typeof s === "object" && s.name === ret);
+    if (!step)
+        return { kind: "opaque" };
+    if (step.type === "query") {
+        const modelName = typeof step.modelName === "string" ? step.modelName : undefined;
+        const resultModelName = modelName && modelsWithRecord.has(modelName) ? modelName : null;
+        const fieldNames = (modelName && recordFieldsByModel.get(modelName)) || new Set();
+        const projection = classifyProjection(step.projection, fieldNames);
+        return { kind: "query", modelName: resultModelName, projection };
+    }
+    if (step.type === "count")
+        return { kind: "count" };
+    if (step.type === "aggregate")
+        return { kind: "aggregate" };
+    return { kind: "opaque" };
+}
+/**
+ * Collect server-stamped field names from the parsed [type] config: timestamp
+ * field names + auto-populated field names. These render as OPTIONAL record
+ * 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);
+    }
+    return [...new Set(names)];
+}
+/**
+ * Convert the normalized op `params` map into a sorted `ParamField[]`. See the
+ * original doc in `dbGenerator.ts`. `inferredArrayElements` (#1488) narrows a
+ * `$in`/`$nin`-bound untyped/object param to its array element type.
+ */
+function paramsToFields(params, inferredArrayElements) {
+    if (!params || typeof params !== "object")
+        return [];
+    return Object.entries(params)
+        .map(([name, def]) => {
+        const rawType = def?.type;
+        const declaredType = rawType ?? "object";
+        const declaredItems = def?.items;
+        let type = declaredType;
+        let items = declaredItems;
+        const inferred = inferredArrayElements?.get(name);
+        if (declaredType === "object" && inferred !== undefined) {
+            type = "array";
+            items = inferred === "unknown" ? undefined : inferred;
+        }
+        return {
+            name,
+            type,
+            required: def?.required === true,
+            enum: def?.enum,
+            items,
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Infer the scalar element type for op params consumed by a `$in`/`$nin`
+ * filter operator (#1488). See the original doc in `dbGenerator.ts` — moved
+ * here unchanged. Returns a map of param name → element TS type
+ * (`"unknown"` sentinel → widen to an untyped element).
+ */
+export function inferArrayParamElementTypes(op, fieldTypesByModel) {
+    const result = new Map();
+    if (!op || typeof op !== "object")
+        return result;
+    const def = op.definition;
+    if (!def || typeof def !== "object")
+        return result;
+    const arrayElems = new Map();
+    const scalarRefs = new Set();
+    const addArrayElem = (param, elem) => {
+        let s = arrayElems.get(param);
+        if (!s) {
+            s = new Set();
+            arrayElems.set(param, s);
+        }
+        s.add(elem);
+    };
+    const paramRef = (v) => {
+        if (typeof v !== "string")
+            return null;
+        const m = v.match(/^\$params\.([A-Za-z0-9_]+)$/);
+        return m ? m[1] : null;
+    };
+    const elemTypeForField = (field, fields) => {
+        const ftype = fields?.get(field);
+        if (ftype === undefined)
+            return "unknown";
+        if (ftype === "stringset")
+            return "string";
+        const ts = tsTypeForDbFieldType(ftype);
+        return ts === "string" || ts === "number" || ts === "boolean"
+            ? ts
+            : "unknown";
+    };
+    const modelFields = (name) => typeof name === "string" ? fieldTypesByModel.get(name) : undefined;
+    const walkFilter = (filter, fields) => {
+        if (!filter || typeof filter !== "object" || Array.isArray(filter))
+            return;
+        for (const [key, value] of Object.entries(filter)) {
+            if (key === "$and" || key === "$or") {
+                if (Array.isArray(value)) {
+                    for (const sub of value)
+                        walkFilter(sub, fields);
+                }
+                continue;
+            }
+            if (key === "$not") {
+                walkFilter(value, fields);
+                continue;
+            }
+            if (value && typeof value === "object" && !Array.isArray(value)) {
+                for (const [operator, opVal] of Object.entries(value)) {
+                    const p = paramRef(opVal);
+                    if (!p)
+                        continue;
+                    if (operator === "$in" || operator === "$nin") {
+                        addArrayElem(p, elemTypeForField(key, fields));
+                    }
+                    else {
+                        scalarRefs.add(p);
+                    }
+                }
+            }
+            else {
+                const p = paramRef(value);
+                if (p)
+                    scalarRefs.add(p);
+            }
+        }
+    };
+    walkFilter(def.filter, modelFields(op.modelName));
+    if (def.source && typeof def.source === "object") {
+        walkFilter(def.source.filter, modelFields(def.source.modelName ?? op.modelName));
+    }
+    if (Array.isArray(def.operations)) {
+        for (const inner of def.operations) {
+            if (inner && typeof inner === "object") {
+                walkFilter(inner.filter, modelFields(inner.modelName ?? op.modelName));
+            }
+        }
+    }
+    if (Array.isArray(def.steps)) {
+        for (const step of def.steps) {
+            if (step && typeof step === "object") {
+                walkFilter(step.filter, modelFields(step.modelName ?? op.modelName));
+            }
+        }
+    }
+    for (const [param, elems] of arrayElems) {
+        if (scalarRefs.has(param) || elems.size !== 1) {
+            result.set(param, "unknown");
+        }
+        else {
+            result.set(param, [...elems][0]);
+        }
+    }
+    return result;
+}
+/**
+ * Infer which record fields are always supplied at create time from `save` op
+ * params (#842). See the original doc in `dbGenerator.ts` — moved here
+ * unchanged.
+ */
+export function inferRequiredRecordFields(operations) {
+    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;
+            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)) {
+                const match = typeof value === "string"
+                    ? value.match(/^\$params\.([A-Za-z0-9_]+)$/)
+                    : null;
+                if (!match) {
+                    fieldVerdicts.set(field, false);
+                    continue;
+                }
+                const paramName = match[1];
+                const required = params[paramName]?.required === true;
+                const prior = fieldVerdicts.get(field);
+                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;
+}
+//# sourceMappingURL=dbTypeIR.js.map

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

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

package/dist/src/lib/db-codegen/generated-operation-def-descriptor.d.ts

@@ -0,0 +1,101 @@
+/**
+ * GENERATED FILE — DO NOT EDIT BY HAND.
+ *
+ * Vendored byte-for-byte from the canonical server module
+ * `src/app-api/controllers/operation-definition-descriptor.ts` — the SAME
+ * allow-lists the server validator (`validateDefinition` / `validateParams`)
+ * enforces. The client operation-definition types
+ * (`src/client/api/operationDefinition.ts`) hand-author the matching union;
+ * a key-parity test compares them against this committed copy.
+ *
+ * Regenerate with:
+ *   node cli/scripts/gen-operation-def-descriptor.mjs   (runs at CLI prebuild)
+ *
+ * A CI freshness guard
+ * (`cli/scripts/gen-operation-def-descriptor.mjs --check`, also asserted by
+ * `cli/tests/unit/operation-def-descriptor-drift-guard.test.ts`) fails if
+ * this committed copy does not match the source — see issue #1544 / #1442.
+ */
+/**
+ * Canonical, dependency-free descriptor of the database operation-definition
+ * schema (issue #1544).
+ *
+ * The server validator (`validateDefinition` / `validateParams` in
+ * `database-type-operations-controller.ts`) and the CLIENT operation-definition
+ * types (`src/client/api/operationDefinition.ts`, consumed by
+ * `createOperation` / `updateOperation` / `DatabaseOperationInfo`) must agree on
+ * the set of operation types and the allowed keys for each definition shape —
+ * otherwise a hand-authored `OperationDefinition` member promises a key the
+ * runtime rejects (or omits one the runtime accepts).
+ *
+ * This module is the single source of that declarative contract: the op-type
+ * list, the per-type allowed definition-key sets, the per-type mutation/action
+ * op-name enums, and the param-schema key/type enums. The validator imports
+ * these constants directly (so a change here changes what the server enforces),
+ * and the CLI vendors a byte-for-byte copy as a committed artifact via
+ * `cli/scripts/gen-operation-def-descriptor.mjs` (the #1442 workflow
+ * schema-descriptor pattern). A drift-guard test runs that generator in
+ * `--check` mode, and a key-parity test asserts the hand-authored client type
+ * members' keys equal the corresponding allow-lists here — so the validator and
+ * the client types can never silently diverge. The CLI never imports server
+ * `src/` at runtime; only the build-time generator reads this file.
+ *
+ * The value-shape checks that are NOT purely declarative (requiredness, nested
+ * object structure, CEL parsing) stay imperative in the validator. This
+ * descriptor captures the declarative allow-lists — the part that is genuinely
+ * shared between the runtime boundary and the descriptive client types.
+ *
+ * Ordering is significant: the validator joins these arrays into its 400-level
+ * error messages (`Must be one of: ${X.join(", ")}`), so reordering an array
+ * changes an error string. Keep entries in their current order.
+ */
+/** The operation `type` values accepted by `createOperation` / `updateOperation`. */
+export declare const OPERATION_TYPES: readonly string[];
+/** Allowed top-level keys in a `query` definition. `cache` (#1247) is query-only. */
+export declare const QUERY_DEF_KEYS: readonly string[];
+/** Allowed top-level keys in a `mutation` definition. */
+export declare const MUTATION_DEF_KEYS: readonly string[];
+/** Allowed top-level keys in a `count` definition. */
+export declare const COUNT_DEF_KEYS: readonly string[];
+/** Allowed top-level keys in an `aggregate` definition. */
+export declare const AGGREGATE_DEF_KEYS: readonly string[];
+/** Allowed top-level keys in a `pipeline` definition. */
+export declare const PIPELINE_DEF_KEYS: readonly string[];
+/** Allowed top-level keys in an `applyToQuery` definition. */
+export declare const APPLY_TO_QUERY_DEF_KEYS: readonly string[];
+/** Mutation op names allowed in a `mutation` definition's `operations[]`. */
+export declare const MUTATION_OPS: readonly string[];
+/**
+ * Aggregate op `type` names allowed in an `aggregate` definition's
+ * `operations[]`.
+ */
+export declare const AGGREGATE_OP_TYPES: readonly string[];
+/**
+ * `applyToQuery` action ops. Only mutation ops that operate on existing matched
+ * records — `save` is excluded because it makes no sense in a find-and-mutate
+ * flow.
+ */
+export declare const APPLY_TO_QUERY_ACTIONS: readonly string[];
+/** Allowed keys in an `applyToQuery` `source` block. */
+export declare const APPLY_TO_QUERY_SOURCE_KEYS: readonly string[];
+/** Allowed keys in an `applyToQuery` `action` block. */
+export declare const APPLY_TO_QUERY_ACTION_KEYS: readonly string[];
+/** Step `type` values allowed inside a `pipeline` definition's `steps[]`. */
+export declare const PIPELINE_STEP_TYPES: readonly string[];
+/** Allowed keys on a pipeline `query` step. */
+export declare const PIPELINE_QUERY_STEP_KEYS: readonly string[];
+/** Allowed keys on a pipeline `count` step. */
+export declare const PIPELINE_COUNT_STEP_KEYS: readonly string[];
+/** Allowed keys on a pipeline `aggregate` step. */
+export declare const PIPELINE_AGGREGATE_STEP_KEYS: readonly string[];
+/**
+ * Built-in param types. `integer` (#1488) is accepted here and by the runtime
+ * coercion path. `array` (#1488) declares a list param with a scalar `items`
+ * element type. Keep in step with the runtime coercion list
+ * (`MODEL_PARAM_SCALAR_TYPES` in `database-operations-controller.ts`).
+ */
+export declare const PARAM_TYPES: readonly string[];
+/** Scalar element types allowed for an `array` param's `items` (#1488). */
+export declare const ARRAY_ELEMENT_TYPES: readonly string[];
+/** Allowed keys in a single param definition. */
+export declare const PARAM_DEF_KEYS: readonly string[];