primitive-admin 1.1.0-alpha.82 → 1.1.0-alpha.83

package/dist/src/lib/document-ingest-input.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Which files `primitive documents ingest` reads, and in which order.
+ *
+ * Two layouts, and the directory itself says which one it is:
+ *
+ * - **plain** — `<dir>/<model>.ndjson` or `<model>.ndjson.gz`, one record per
+ *   line. Nothing on disk promises the lines ascend, so they are sorted.
+ * - **export** — what `primitive documents export` wrote: a
+ *   `snapshot/manifest.json` and its chunks, at the directory itself or under
+ *   `documents/<document-id>/`. A snapshot's chunks ascend and are disjoint
+ *   per model in manifest order, so an export needs no sort — it is read in
+ *   that order and streamed straight through.
+ *
+ * A directory that is neither, or that is both, is refused naming what it
+ * held. Every refusal here happens before a session exists: an ingest replaces
+ * a live document's tables, and half of one is not something to discover from
+ * the server's side.
+ */
+/** A directory that is not an ingest input, said as what was found. */
+export declare class IngestInputError extends Error {
+    constructor(message: string);
+}
+/** One file of lines, and the model they belong to. */
+export interface IngestSource {
+    model: string;
+    /** Absolute path on disk. */
+    file: string;
+    gzip: boolean;
+    /** What a `file:line` message calls it: relative to the input root. */
+    label: string;
+}
+/** What the input directory holds. */
+export interface DiscoveredIngestInput {
+    layout: "plain" | "export";
+    /** The directory the sources are relative to. */
+    root: string;
+    /** In read order: manifest order for an export, model order for plain. */
+    sources: IngestSource[];
+    /** Parts of an export an ingest has no use for, named once on stderr. */
+    ignored: string[];
+    /** True when the read order is already ascending per model. */
+    presorted: boolean;
+}
+/**
+ * Decide what `dir` is and list the files to read, in order.
+ *
+ * `documentId` matters only for the export layout: an export directory may
+ * hold several documents, and re-ingesting one document's rows into another
+ * is not a thing to guess at.
+ */
+export declare function discoverIngestInput(dir: string, documentId: string): DiscoveredIngestInput;

package/dist/src/lib/document-ingest-input.js

@@ -0,0 +1,132 @@
+/**
+ * Which files `primitive documents ingest` reads, and in which order.
+ *
+ * Two layouts, and the directory itself says which one it is:
+ *
+ * - **plain** — `<dir>/<model>.ndjson` or `<model>.ndjson.gz`, one record per
+ *   line. Nothing on disk promises the lines ascend, so they are sorted.
+ * - **export** — what `primitive documents export` wrote: a
+ *   `snapshot/manifest.json` and its chunks, at the directory itself or under
+ *   `documents/<document-id>/`. A snapshot's chunks ascend and are disjoint
+ *   per model in manifest order, so an export needs no sort — it is read in
+ *   that order and streamed straight through.
+ *
+ * A directory that is neither, or that is both, is refused naming what it
+ * held. Every refusal here happens before a session exists: an ingest replaces
+ * a live document's tables, and half of one is not something to discover from
+ * the server's side.
+ */
+import fs from "fs";
+import path from "path";
+import { chunkAddressOf } from "./snapshot-manifest-layout.js";
+/** A directory that is not an ingest input, said as what was found. */
+export class IngestInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "IngestInputError";
+    }
+}
+/** Files and directories an export carries that a bulk load does not read. */
+const EXPORT_IGNORED = [
+    "epochs",
+    "current.yjs",
+    "chain.json",
+    "document.yjs",
+    "blobs",
+];
+const LINE_FILE = /^(.+)\.ndjson(\.gz)?$/;
+/**
+ * Decide what `dir` is and list the files to read, in order.
+ *
+ * `documentId` matters only for the export layout: an export directory may
+ * hold several documents, and re-ingesting one document's rows into another
+ * is not a thing to guess at.
+ */
+export function discoverIngestInput(dir, documentId) {
+    if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+        throw new IngestInputError(`Not a directory: ${dir}`);
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    const lineFiles = entries.filter((entry) => entry.isFile() && LINE_FILE.test(entry.name));
+    const hasOwnSnapshot = fs.existsSync(path.join(dir, "snapshot", "manifest.json"));
+    const documentsDir = path.join(dir, "documents");
+    const hasDocuments = fs.existsSync(documentsDir) && fs.statSync(documentsDir).isDirectory();
+    if (hasOwnSnapshot && lineFiles.length > 0) {
+        throw new IngestInputError(`${dir} holds both layouts: a snapshot/manifest.json and ` +
+            `${lineFiles.map((entry) => entry.name).join(", ")}. ` +
+            "An ingest reads one directory as one layout; split them.");
+    }
+    if (hasOwnSnapshot)
+        return exportInput(dir, dir);
+    if (hasDocuments && lineFiles.length === 0) {
+        const mine = path.join(documentsDir, documentId);
+        if (fs.existsSync(path.join(mine, "snapshot", "manifest.json"))) {
+            return exportInput(dir, mine);
+        }
+        const others = fs
+            .readdirSync(documentsDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+        throw new IngestInputError(`This export holds ${others.length === 0 ? "no documents" : others.join(", ")}` +
+            ` and nothing for ${documentId}. Point --input at the export of the ` +
+            "document being ingested, or at its documents/<document-id> directory.");
+    }
+    if (lineFiles.length === 0) {
+        const found = entries.map((entry) => entry.name);
+        if (found.length === 0) {
+            throw new IngestInputError(`${dir} is empty. An ingest reads <model>.ndjson[.gz] files, or an ` +
+                "export's snapshot/manifest.json.");
+        }
+        throw new IngestInputError(`${dir} holds nothing an ingest can read: ${found.join(", ")}. ` +
+            "Expected <model>.ndjson[.gz] files, or an export's snapshot/manifest.json.");
+    }
+    // A plain directory with a stray file in it is still ambiguous: the stray
+    // may be the model file somebody meant to name, so it is named rather than
+    // quietly skipped.
+    const strays = entries
+        .filter((entry) => !(entry.isFile() && LINE_FILE.test(entry.name)))
+        .map((entry) => entry.name);
+    if (strays.length > 0) {
+        throw new IngestInputError(`${dir} holds files an ingest cannot read: ${strays.join(", ")}. ` +
+            "A plain input directory holds <model>.ndjson[.gz] files and nothing else.");
+    }
+    const sources = lineFiles
+        .map((entry) => {
+        const match = LINE_FILE.exec(entry.name);
+        return {
+            model: match[1],
+            file: path.join(dir, entry.name),
+            gzip: Boolean(match[2]),
+            label: entry.name,
+        };
+    })
+        .sort((left, right) => left.model.localeCompare(right.model));
+    return { layout: "plain", root: dir, sources, ignored: [], presorted: false };
+}
+/** The sources of an export rooted at `root`, in manifest order. */
+function exportInput(dir, root) {
+    const manifestPath = path.join(root, "snapshot", "manifest.json");
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new IngestInputError(`${path.relative(dir, manifestPath) || manifestPath} is not readable JSON: ${error.message}`);
+    }
+    const chunks = Array.isArray(manifest?.chunks) ? manifest.chunks : null;
+    if (!chunks) {
+        throw new IngestInputError(`${path.relative(dir, manifestPath) || manifestPath} names no chunks.`);
+    }
+    const sources = chunks.map((chunk) => {
+        const address = chunkAddressOf(chunk);
+        const label = `snapshot/${address.model}/${address.index}.ndjson.gz`;
+        const file = path.join(root, "snapshot", address.model, `${address.index}.ndjson.gz`);
+        if (!fs.existsSync(file)) {
+            throw new IngestInputError(`The export's manifest names ${label}, which is not on disk.`);
+        }
+        return { model: address.model, file, gzip: true, label };
+    });
+    const ignored = EXPORT_IGNORED.filter((name) => fs.existsSync(path.join(root, name)));
+    return { layout: "export", root, sources, ignored, presorted: true };
+}
+//# sourceMappingURL=document-ingest-input.js.map

package/dist/src/lib/document-ingest-input.js.map

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

package/dist/src/lib/document-ingest.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Driving one bulk-load session: create, upload, commit, poll.
+ *
+ * The artifact is already built and checked by the time anything here runs
+ * (`document-ingest-artifact`), so every refusal this module reports comes
+ * from the server. What it decides is what to do about one:
+ *
+ * - a create the server refuses uploads nothing;
+ * - an upload that fails ABORTS the session rather than retrying a slot whose
+ *   reservation this side cannot see — the artifact is deterministic and a
+ *   re-run is cheap;
+ * - Ctrl-C during the uploads aborts too, because the session it was filling
+ *   is not going to be committed; Ctrl-C while POLLING leaves the session
+ *   alone, because by then the document is already being changed and giving up
+ *   on watching is not giving up on the load.
+ *
+ * Exit codes follow `functions runs wait`/`invoke`, as `docs/cli-design.md`
+ * records them: 0 completed, 1 failed or refused, 124 a wait that gave up,
+ * 130 Ctrl-C.
+ */
+import type { IngestArtifactPlan, IngestChunkDescriptor } from "./document-ingest-artifact.js";
+/** A plan the operator did not confirm, or cannot be asked about. */
+export declare class IngestRefusedError extends Error {
+    constructor(message: string);
+}
+/** The six calls driving a session; `ApiClient` supplies them in the verb. */
+export interface IngestDriverClient {
+    createIngest(documentId: string): Promise<any>;
+    uploadIngestChunk(documentId: string, sessionId: string, chunk: IngestChunkDescriptor & {
+        body: Buffer;
+    }): Promise<any>;
+    commitIngest(documentId: string, sessionId: string): Promise<any>;
+    abortIngest(documentId: string, sessionId: string): Promise<any>;
+    getIngest(documentId: string, sessionId: string): Promise<any>;
+}
+export interface DriveIngestOptions {
+    client: IngestDriverClient;
+    documentId: string;
+    plan: IngestArtifactPlan;
+    /** Uploads in flight at once. */
+    concurrency?: number;
+    /** Poll until the session settles; `--no-wait` sets this false. */
+    wait?: boolean;
+    /** `--timeout`, in milliseconds; null waits indefinitely. */
+    timeoutMs?: number | null;
+    /** Ctrl-C. */
+    signal?: AbortSignal;
+    /** State changes and progress; stderr in the verb. */
+    onProgress?: (line: string) => void;
+    /** Where a chunk's bytes come from; the plan's own files by default. */
+    readChunk?: (chunk: IngestChunkDescriptor) => Promise<Buffer>;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+/** What the run settled on. */
+export interface IngestOutcome {
+    /** 0 complete, 1 failed or refused, 124 timed out, 130 interrupted. */
+    exitCode: number;
+    sessionId: string | null;
+    /** The terminal session view, when one was read. */
+    session: any | null;
+    /** The reason, for stderr. */
+    message?: string;
+}
+/** The plan summary an operator confirms, one line per row. */
+export declare function summariseIngestPlan(plan: IngestArtifactPlan): string[];
+/**
+ * Refuse a run that cannot ask, before it asks the server anything.
+ *
+ * A bulk load deletes and overwrites a live document's records with no undo,
+ * which is what the CLI design's destructive default is for. A pipeline that
+ * meant to run one says so with `-y`.
+ */
+export declare function assertIngestConfirmable(options: {
+    yes: boolean;
+    isTTY: boolean;
+}): void;
+export declare function driveDocumentIngest(options: DriveIngestOptions): Promise<IngestOutcome>;

package/dist/src/lib/document-ingest.js

@@ -0,0 +1,231 @@
+/**
+ * Driving one bulk-load session: create, upload, commit, poll.
+ *
+ * The artifact is already built and checked by the time anything here runs
+ * (`document-ingest-artifact`), so every refusal this module reports comes
+ * from the server. What it decides is what to do about one:
+ *
+ * - a create the server refuses uploads nothing;
+ * - an upload that fails ABORTS the session rather than retrying a slot whose
+ *   reservation this side cannot see — the artifact is deterministic and a
+ *   re-run is cheap;
+ * - Ctrl-C during the uploads aborts too, because the session it was filling
+ *   is not going to be committed; Ctrl-C while POLLING leaves the session
+ *   alone, because by then the document is already being changed and giving up
+ *   on watching is not giving up on the load.
+ *
+ * Exit codes follow `functions runs wait`/`invoke`, as `docs/cli-design.md`
+ * records them: 0 completed, 1 failed or refused, 124 a wait that gave up,
+ * 130 Ctrl-C.
+ */
+import fs from "fs";
+/** A plan the operator did not confirm, or cannot be asked about. */
+export class IngestRefusedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "IngestRefusedError";
+    }
+}
+const POLL_FAST_MS = 2_000;
+const POLL_SLOW_MS = 5_000;
+const POLL_SLOWS_AFTER_MS = 60_000;
+/** The plan summary an operator confirms, one line per row. */
+export function summariseIngestPlan(plan) {
+    const lines = plan.models.map((model) => `  ${model.model}: ${model.rows} rows, ${model.chunks} chunks, ` +
+        `${model.bytes} bytes` +
+        (model.deletes > 0 ? `, ${model.deletes} deletes` : ""));
+    return [
+        `${plan.rows} rows across ${plan.models.length} model(s), ` +
+            `${plan.chunks.length} chunks, ${plan.bytes} bytes` +
+            (plan.deletes > 0 ? `, ${plan.deletes} deletes` : ""),
+        ...lines,
+    ];
+}
+/**
+ * Refuse a run that cannot ask, before it asks the server anything.
+ *
+ * A bulk load deletes and overwrites a live document's records with no undo,
+ * which is what the CLI design's destructive default is for. A pipeline that
+ * meant to run one says so with `-y`.
+ */
+export function assertIngestConfirmable(options) {
+    if (options.yes || options.isTTY)
+        return;
+    throw new IngestRefusedError("A bulk load replaces records in a live document and cannot be undone. " +
+        "Re-run with -y to confirm it without a prompt.");
+}
+export async function driveDocumentIngest(options) {
+    const { client, documentId, plan, concurrency = 4, wait = true, timeoutMs = null, signal, onProgress = () => { }, readChunk = async (chunk) => fs.readFileSync(chunk.file), now = () => Date.now(), sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)), } = options;
+    // ── create ──
+    let session;
+    try {
+        session = await client.createIngest(documentId);
+    }
+    catch (error) {
+        if (error?.code === "DOCUMENT_INGEST_ACTIVE") {
+            const active = (error.details && error.details.sessionId) ?? "the active session";
+            return {
+                exitCode: 1,
+                sessionId: null,
+                session: null,
+                message: `${error.message}\nThis document already has bulk load ${active}. ` +
+                    `Watch it with \`primitive documents ingests get ${documentId} ${active}\`, ` +
+                    `or give it up with \`primitive documents ingests abort\`.`,
+            };
+        }
+        return {
+            exitCode: 1,
+            sessionId: null,
+            session: null,
+            message: String(error?.message ?? error),
+        };
+    }
+    const sessionId = String(session.sessionId);
+    onProgress(`Session ${sessionId} opened.`);
+    const giveUp = async (message, exitCode) => {
+        try {
+            await client.abortIngest(documentId, sessionId);
+            onProgress(`Session ${sessionId} aborted; nothing was applied.`);
+        }
+        catch (error) {
+            onProgress(`Session ${sessionId} could not be aborted: ${error?.message ?? error}`);
+        }
+        return { exitCode, sessionId, session: null, message };
+    };
+    // ── upload ──
+    const queue = [...plan.chunks];
+    let uploaded = 0;
+    let failure = null;
+    const worker = async () => {
+        for (;;) {
+            if (failure !== null || signal?.aborted)
+                return;
+            const chunk = queue.shift();
+            if (!chunk)
+                return;
+            try {
+                const body = await readChunk(chunk);
+                await client.uploadIngestChunk(documentId, sessionId, { ...chunk, body });
+                uploaded += 1;
+                onProgress(`Uploaded ${uploaded}/${plan.chunks.length} chunks ` +
+                    `(${chunk.model} ${chunk.index}).`);
+            }
+            catch (error) {
+                // The first failure wins: the others are the same session going away.
+                if (failure === null)
+                    failure = String(error?.message ?? error);
+                return;
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(concurrency, queue.length || 1)) }, worker));
+    if (failure !== null)
+        return giveUp(failure, 1);
+    if (signal?.aborted) {
+        return giveUp("Interrupted while uploading; the session was aborted and nothing was applied.", 130);
+    }
+    // ── commit ──
+    try {
+        session = await client.commitIngest(documentId, sessionId);
+    }
+    catch (error) {
+        return giveUp(String(error?.message ?? error), 1);
+    }
+    onProgress(`Session ${sessionId} committed.`);
+    if (!wait) {
+        return { exitCode: 0, sessionId, session, message: undefined };
+    }
+    // ── poll ──
+    //
+    // Past this point the session is the server's business: the copy has begun
+    // and the document's tables will be swapped whatever this process does. So
+    // neither a timeout nor a Ctrl-C aborts it — both say so and leave.
+    const started = now();
+    let reported = null;
+    let reportedProgress = "";
+    for (;;) {
+        let view;
+        try {
+            view = await client.getIngest(documentId, sessionId);
+        }
+        catch (error) {
+            return {
+                exitCode: 1,
+                sessionId,
+                session: null,
+                message: String(error?.message ?? error),
+            };
+        }
+        if (view?.state !== reported) {
+            reported = view?.state ?? null;
+            onProgress(`Session ${sessionId} is ${reported}.`);
+        }
+        const progress = describeProgress(view?.progress);
+        if (progress && progress !== reportedProgress) {
+            reportedProgress = progress;
+            onProgress(`  ${progress}`);
+        }
+        if (view?.state === "complete") {
+            return { exitCode: 0, sessionId, session: view };
+        }
+        if (view?.state === "failed" || view?.state === "aborted") {
+            return {
+                exitCode: 1,
+                sessionId,
+                session: view,
+                message: describeFailure(view),
+            };
+        }
+        const elapsed = now() - started;
+        if (timeoutMs !== null && elapsed >= timeoutMs) {
+            return {
+                exitCode: 124,
+                sessionId,
+                session: view,
+                message: `Gave up waiting after ${Math.round(elapsed / 1000)}s. The session ` +
+                    `keeps running; watch it with \`primitive documents ingests get ` +
+                    `${documentId} ${sessionId}\`.`,
+            };
+        }
+        await sleep(elapsed >= POLL_SLOWS_AFTER_MS ? POLL_SLOW_MS : POLL_FAST_MS);
+        if (signal?.aborted) {
+            return {
+                exitCode: 130,
+                sessionId,
+                session: view,
+                message: `Interrupted. The session keeps running; watch it with ` +
+                    `\`primitive documents ingests get ${documentId} ${sessionId}\`.`,
+            };
+        }
+    }
+}
+/** The session's own words for why it stopped. */
+function describeFailure(view) {
+    if (view?.state === "aborted")
+        return "The session was aborted.";
+    const failure = view?.failure;
+    if (!failure)
+        return "The session failed.";
+    // A failure's rows are `{ model, id }` on the wire, and a bounded sample of
+    // them; a string is accepted too so a stub or an older server still reads.
+    const rows = Array.isArray(failure.rows) && failure.rows.length > 0
+        ? `\n  ${failure.rows
+            .map((row) => typeof row === "string" ? row : `${row?.model} ${row?.id}`)
+            .join("\n  ")}`
+        : "";
+    return `${failure.code}: ${failure.reason}${rows}`;
+}
+/** One line of counters, or nothing while they are all still zero. */
+function describeProgress(progress) {
+    if (!progress)
+        return "";
+    const copied = progress.rowsCopied ?? 0;
+    const chunks = progress.chunksApplied ?? 0;
+    const rows = progress.rowsApplied ?? 0;
+    const reconciled = progress.recordsReconciled ?? 0;
+    if (copied + chunks + rows + reconciled === 0)
+        return "";
+    return (`copied ${copied} rows, applied ${chunks} chunks / ${rows} rows, ` +
+        `reconciled ${reconciled} records`);
+}
+//# sourceMappingURL=document-ingest.js.map

package/dist/src/lib/document-ingest.js.map

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

package/dist/src/lib/function-bundle.d.ts

@@ -116,6 +116,12 @@ export interface EnvelopeShape {
     bundle: string;
     /** base64 of the collected manifest JSON, or null when there is none. */
     manifest?: string | null;
+    /**
+     * base64 of the project's authored `models/models.toml` bytes, or absent
+     * when the project declares no document schema (#3455). Must stay identical
+     * to the server's `FunctionEnvelope.documentSchema`.
+     */
+    documentSchema?: string | null;
 }
 /**
  * The canonical encoding both sides hash. Fixed key order, sources sorted by

package/dist/src/lib/function-bundle.js

@@ -135,6 +135,14 @@ export function canonicalFunctionEnvelopeBytes(envelope) {
         // `null` rather than absent when there is none, so the encoding of a
         // manifest-less push is stable rather than depending on a missing key.
         manifest: envelope.manifest ?? null,
+        // #3455 — the twin of the server's rule: the key is emitted ONLY when
+        // there is a schema, so a tree with no `models/models.toml` builds the
+        // same bytes it built before this change and its no-op detection is
+        // intact. `undefined` would be dropped by `JSON.stringify` anyway; the
+        // spread says the rule rather than relying on that.
+        ...(typeof envelope.documentSchema === "string" && envelope.documentSchema
+            ? { documentSchema: envelope.documentSchema }
+            : {}),
     };
     return new TextEncoder().encode(JSON.stringify(canonical));
 }

package/dist/src/lib/function-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-bundle.js","sourceRoot":"","sources":["../../../src/lib/function-bundle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"function-bundle.js","sourceRoot":"","sources":["../../../src/lib/function-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE1D,qDAAqD;AACrD,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,0EAA0E;AAC1E,MAAM,oBAAoB,GAAG,GAAW,EAAE,CACxC,QAAQ,kBAAkB,oCAAoC;IAC9D,IAAI,0BAA0B,WAAW,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAa;IACrC,6EAA6E;IAC7E,0DAA0D;IAC1D,IAAI,MAAM,CACR,kEAAkE,kBAAkB,KAAK,EACzF,GAAG,CACJ;IACD,qDAAqD;IACrD,IAAI,MAAM,CACR,sCAAsC,kBAAkB,KAAK,EAC7D,GAAG,CACJ;IACD,uEAAuE;IACvE,8CAA8C;IAC9C,IAAI,MAAM,CAAC,8BAA8B,kBAAkB,KAAK,EAAE,GAAG,CAAC;CACvE,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,+DAA+D;AAC/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,gFAAgF;AAChF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAoCD;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAuB;IAEvB,MAAM,SAAS,GAAG;QAChB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,kEAAkE;QAClE,qEAAqE;QACrE,uEAAuE;QACvE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;QACnC,sEAAsE;QACtE,uEAAuE;QACvE,oEAAoE;QACpE,uEAAuE;QACvE,oDAAoD;QACpD,GAAG,CAAC,OAAO,QAAQ,CAAC,cAAc,KAAK,QAAQ,IAAI,QAAQ,CAAC,cAAc;YACxE,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC7D,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEtE,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,SAAiB;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,IAAY;IAC/C,OAAO,IAAI,kBAAkB,CAC3B,GAAG,IAAI,KAAK,IAAI,2CAA2C;QACzD,wEAAwE;QACxE,+CAA+C,CAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAOzC;IACC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAElD,0EAA0E;IAC1E,uEAAuE;IACvE,wDAAwD;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,WAAW,KAAK,IAAI;QAAE,MAAM,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,kBAAkB,CAC1B,aAAa,WAAW,kBAAkB,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAC3E,CAAC;IACJ,CAAC;IACD,0BAA0B;IAC1B,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7D,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,gEAAgE;IAChE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAQ,EAAE;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE;QACjD,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAmB;QAC3C,IAAI,EAAE,oCAAoC;QAC1C,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC/C,uEAAuE;gBACvE,sCAAsC;gBACtC,IAAK,IAAI,CAAC,UAAkB,EAAE,yBAAyB;oBAAE,OAAO,IAAI,CAAC;gBACrE,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;oBAAE,OAAO,IAAI,CAAC;gBAC7C,mEAAmE;gBACnE,sEAAsE;gBACtE,wEAAwE;gBACxE,mCAAmC;gBACnC,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBACrC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,EAAE,CAAC;gBACxD,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,qEAAqE;gBACrE,4DAA4D;gBAC5D,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1E,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc;oBAAE,OAAO,IAAI,CAAC;gBAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,UAAU,EAAE,EAAE,yBAAyB,EAAE,IAAI,EAAE;iBAChD,CAAC,CAAC;gBACH,qEAAqE;gBACrE,iEAAiE;gBACjE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACxC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,IAAI,MAA2B,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YAC3B,WAAW,EAAE,CAAC,aAAa,CAAC;YAC5B,aAAa,EAAE,QAAQ;YACvB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,QAAQ;YAChB,+CAA+C;YAC/C,QAAQ,EAAE,CAAC,0BAA0B,CAAC;YACtC,OAAO,EAAE,CAAC,oBAAoB,CAAC;YAC/B,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAa,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;YACrD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;gBAC1B,MAAM,KAAK,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI;oBAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAClC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnB,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,IAAI,aAAa,EAAE,CAAC;YAC1D,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,aAAa,WAAW,uBAAuB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CAC1B,aAAa,WAAW,wCAAwC,OAAO,CAAC,KAAK,CAAC,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5C,8EAA8E;IAC9E,+EAA+E;IAC/E,6EAA6E;IAC7E,6EAA6E;IAC7E,mBAAmB;IACnB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,gBAAgB,CAAC,QAAQ,CAAC;YAAE,SAAS;QACzC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,oEAAoE;QACpE,uEAAuE;QACvE,uEAAuE;QACvE,kBAAkB;QAClB,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,SAAS;QACrC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,sEAAsE;QACtE,wEAAwE;QACxE,0EAA0E;QAC1E,IAAI,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,kBAAkB,CAC1B,aAAa,WAAW,yBAAyB,IAAI,KAAK,oBAAoB,EAAE,EAAE,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,OAAO;QACL,KAAK,EAAE,aAAa;QACpB,MAAM;QACN,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC9D,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/src/lib/function-collect.d.ts

@@ -99,7 +99,7 @@ export declare function scanBundleForManifest(bundle: string): {
  * every other export are inert, so a module that calls one at import time
  * neither fails nor has an effect.
  */
-export declare const COLLECT_STUB_SOURCE = "\nconst registry = (globalThis.__PRIMITIVE_COLLECT_REGISTRY__ ||= []);\n\n// The default-coercion rule the SDK applies at registration (#3281,\n// D3281-SO-005), spelled here too so a default the declared type cannot\n// coerce is refused at PUSH \u2014 this stub is what push runs \u2014 rather than at\n// the first invocation. The vendored grammar (`coerceParamDefault` in\n// generated-config-surfaces.ts) is the same rule and re-checks the manifest.\nconst SCALAR_TYPES = [\"string\", \"number\", \"boolean\", \"any\"];\nfunction coerceScalar(type, value) {\n  if (type === \"number\") {\n    const n = typeof value === \"number\" ? value : Number(value);\n    if (typeof value === \"boolean\" || value === null || value === \"\" || !Number.isFinite(n)) {\n      return { ok: false, reason: \"must be a number\" };\n    }\n    return { ok: true, value: n };\n  }\n  if (type === \"boolean\") {\n    if (typeof value === \"boolean\") return { ok: true, value };\n    if (value === \"true\") return { ok: true, value: true };\n    if (value === \"false\") return { ok: true, value: false };\n    return { ok: false, reason: \"must be a boolean\" };\n  }\n  if (type === \"string\") {\n    if (typeof value !== \"string\") return { ok: false, reason: \"must be a string\" };\n    return { ok: true, value };\n  }\n  return { ok: true, value };\n}\nfunction coerceDefault(spec, value) {\n  if (spec.type === \"array\") {\n    if (!Array.isArray(value)) return { ok: false, reason: \"must be an array\" };\n    const itemType = spec.items && spec.items.type ? String(spec.items.type) : \"any\";\n    const out = [];\n    for (const element of value) {\n      const coerced = coerceScalar(itemType, element);\n      if (!coerced.ok) return { ok: false, reason: \"every element \" + coerced.reason };\n      out.push(coerced.value);\n    }\n    return { ok: true, value: out };\n  }\n  return coerceScalar(spec.type === undefined ? \"any\" : String(spec.type), value);\n}\n\nfunction record(kind, name, config) {\n  const c = config || {};\n  const params = {};\n  for (const [key, value] of Object.entries(c.params || {})) {\n    const spec = value && typeof value === \"object\" ? value : { type: String(value) };\n    const entry = {};\n    const fail = (message) => {\n      throw new Error(\"'\" + name + \"': parameter '\" + key + \"' \" + message);\n    };\n    if (spec.type !== undefined) entry.type = String(spec.type);\n    if (entry.type === \"array\") {\n      if (spec.items !== undefined && spec.items !== null) {\n        const itemType =\n          spec.items && typeof spec.items === \"object\" ? String(spec.items.type ?? \"\") : \"\";\n        if (!SCALAR_TYPES.includes(itemType)) {\n          fail(\"declares an `items` type outside \" + SCALAR_TYPES.join(\", \") + \".\");\n        }\n        entry.items = { type: itemType };\n      }\n      if (spec.caller === true) fail(\"is an array bound to $caller; `caller` is a scalar binding.\");\n    }\n    if (spec.default !== undefined) {\n      const coerced = coerceDefault(entry, spec.default);\n      if (!coerced.ok) fail(\"has a default that \" + coerced.reason + \".\");\n      entry.default = coerced.value;\n    }\n    if (spec.caller === true || spec === \"$caller\" || spec.type === \"$caller\") {\n      entry.caller = true;\n    }\n    params[String(key)] = entry;\n  }\n  const declaredCaller = Object.values(params).some((p) => p.caller === true);\n  registry.push({\n    kind,\n    name: String(name),\n    models: Array.isArray(c.models) ? c.models.map(String) : [],\n    params,\n    cache:\n      c.cache && typeof c.cache === \"object\" && Number(c.cache.ttlMs) > 0\n        ? { ttlMs: Number(c.cache.ttlMs) }\n        : null,\n    callerScoped: declaredCaller,\n  });\n  return async () => {\n    throw new Error(\n      \"'\" + name + \"' was called during manifest collection; a registration's \" +\n        \"`run` only executes inside a real invocation.\"\n    );\n  };\n}\n\n// The PUBLIC surface, all of it. An ESM import of a name a module does not\n// export is a build error, so a stub missing one export refuses a tree the\n// sandbox would have run \u2014 collection is mandatory, so that is a valid\n// function that cannot be pushed at all (CR3187-007). The constants carry the\n// runtime's own values so a registration computed from one collects the same\n// way it will run.\nexport const SDK_STUB_VERSION = \"collect\";\nexport const MAX_QUERY_CACHE_TTL_MS = 60000;\nexport const PMAP_DEFAULT_CONCURRENCY = 8;\nexport function defineQuery(name, config) { return record(\"query\", name, config); }\nexport function defineMutation(name, config) { return record(\"mutation\", name, config); }\nexport function defineFunction(keyOrHandler, maybeHandler) {\n  // The KEYED form (#3281) returns a wrapper CARRYING its key, exactly as the\n  // baked SDK's does. That is what push reads: the child resolves the callable\n  // the bootstrap would select and compares THAT key to the file's\n  // (D3281-SO-006). The registry entry is the child's report of what the\n  // module scope did; it is not what the check consults, because a keyed\n  // handler an entry merely imports for composition registers here too.\n  if (typeof keyOrHandler === \"string\" || maybeHandler !== undefined) {\n    registry.push({ kind: \"function\", name: String(keyOrHandler) });\n    const wrapped = function (...args) {\n      return maybeHandler(...args);\n    };\n    wrapped.functionKey = String(keyOrHandler);\n    return wrapped;\n  }\n  return keyOrHandler;\n}\nexport function pMap(items, mapper) { return Promise.all((items || []).map(mapper)); }\nexport function ulid() { return \"00000000000000000000000000\"; }\nexport const stepPolicy = new Proxy({}, { get: () => ({}) });\nexport default {\n  SDK_STUB_VERSION,\n  defineFunction,\n  defineQuery,\n  defineMutation,\n  pMap,\n  ulid,\n};\n";
+export declare const COLLECT_STUB_SOURCE = "\nconst registry = (globalThis.__PRIMITIVE_COLLECT_REGISTRY__ ||= []);\n\n// The default-coercion rule the SDK applies at registration (#3281,\n// D3281-SO-005), spelled here too so a default the declared type cannot\n// coerce is refused at PUSH \u2014 this stub is what push runs \u2014 rather than at\n// the first invocation. The vendored grammar (`coerceParamDefault` in\n// generated-config-surfaces.ts) is the same rule and re-checks the manifest.\nconst SCALAR_TYPES = [\"string\", \"number\", \"boolean\", \"any\"];\nfunction coerceScalar(type, value) {\n  if (type === \"number\") {\n    const n = typeof value === \"number\" ? value : Number(value);\n    if (typeof value === \"boolean\" || value === null || value === \"\" || !Number.isFinite(n)) {\n      return { ok: false, reason: \"must be a number\" };\n    }\n    return { ok: true, value: n };\n  }\n  if (type === \"boolean\") {\n    if (typeof value === \"boolean\") return { ok: true, value };\n    if (value === \"true\") return { ok: true, value: true };\n    if (value === \"false\") return { ok: true, value: false };\n    return { ok: false, reason: \"must be a boolean\" };\n  }\n  if (type === \"string\") {\n    if (typeof value !== \"string\") return { ok: false, reason: \"must be a string\" };\n    return { ok: true, value };\n  }\n  return { ok: true, value };\n}\nfunction coerceDefault(spec, value) {\n  if (spec.type === \"array\") {\n    if (!Array.isArray(value)) return { ok: false, reason: \"must be an array\" };\n    const itemType = spec.items && spec.items.type ? String(spec.items.type) : \"any\";\n    const out = [];\n    for (const element of value) {\n      const coerced = coerceScalar(itemType, element);\n      if (!coerced.ok) return { ok: false, reason: \"every element \" + coerced.reason };\n      out.push(coerced.value);\n    }\n    return { ok: true, value: out };\n  }\n  return coerceScalar(spec.type === undefined ? \"any\" : String(spec.type), value);\n}\n\nfunction record(kind, name, config) {\n  const c = config || {};\n  const params = {};\n  for (const [key, value] of Object.entries(c.params || {})) {\n    const spec = value && typeof value === \"object\" ? value : { type: String(value) };\n    const entry = {};\n    const fail = (message) => {\n      throw new Error(\"'\" + name + \"': parameter '\" + key + \"' \" + message);\n    };\n    if (spec.type !== undefined) entry.type = String(spec.type);\n    if (entry.type === \"array\") {\n      if (spec.items !== undefined && spec.items !== null) {\n        const itemType =\n          spec.items && typeof spec.items === \"object\" ? String(spec.items.type ?? \"\") : \"\";\n        if (!SCALAR_TYPES.includes(itemType)) {\n          fail(\"declares an `items` type outside \" + SCALAR_TYPES.join(\", \") + \".\");\n        }\n        entry.items = { type: itemType };\n      }\n      if (spec.caller === true) fail(\"is an array bound to $caller; `caller` is a scalar binding.\");\n    }\n    if (spec.default !== undefined) {\n      const coerced = coerceDefault(entry, spec.default);\n      if (!coerced.ok) fail(\"has a default that \" + coerced.reason + \".\");\n      entry.default = coerced.value;\n    }\n    if (spec.caller === true || spec === \"$caller\" || spec.type === \"$caller\") {\n      entry.caller = true;\n    }\n    params[String(key)] = entry;\n  }\n  const declaredCaller = Object.values(params).some((p) => p.caller === true);\n  registry.push({\n    kind,\n    name: String(name),\n    models: Array.isArray(c.models) ? c.models.map(String) : [],\n    params,\n    cache:\n      c.cache && typeof c.cache === \"object\" && Number(c.cache.ttlMs) > 0\n        ? { ttlMs: Number(c.cache.ttlMs) }\n        : null,\n    callerScoped: declaredCaller,\n  });\n  return async () => {\n    throw new Error(\n      \"'\" + name + \"' was called during manifest collection; a registration's \" +\n        \"`run` only executes inside a real invocation.\"\n    );\n  };\n}\n\n// The PUBLIC surface, all of it. An ESM import of a name a module does not\n// export is a build error, so a stub missing one export refuses a tree the\n// sandbox would have run \u2014 collection is mandatory, so that is a valid\n// function that cannot be pushed at all (CR3187-007). The constants carry the\n// runtime's own values so a registration computed from one collects the same\n// way it will run.\nexport const SDK_STUB_VERSION = \"collect\";\nexport const MAX_QUERY_CACHE_TTL_MS = 60000;\nexport const PMAP_DEFAULT_CONCURRENCY = 8;\nexport function defineQuery(name, config) { return record(\"query\", name, config); }\nexport function defineMutation(name, config) { return record(\"mutation\", name, config); }\nexport function defineFunction(keyOrHandler, maybeHandler) {\n  // The KEYED form (#3281) returns a wrapper CARRYING its key, exactly as the\n  // baked SDK's does. That is what push reads: the child resolves the callable\n  // the bootstrap would select and compares THAT key to the file's\n  // (D3281-SO-006). The registry entry is the child's report of what the\n  // module scope did; it is not what the check consults, because a keyed\n  // handler an entry merely imports for composition registers here too.\n  if (typeof keyOrHandler === \"string\" || maybeHandler !== undefined) {\n    registry.push({ kind: \"function\", name: String(keyOrHandler) });\n    const wrapped = function (...args) {\n      return maybeHandler(...args);\n    };\n    wrapped.functionKey = String(keyOrHandler);\n    return wrapped;\n  }\n  return keyOrHandler;\n}\nexport function pMap(items, mapper) { return Promise.all((items || []).map(mapper)); }\nexport function ulid() { return \"00000000000000000000000000\"; }\nexport const stepPolicy = new Proxy({}, { get: () => ({}) });\n// #3482 \u2014 the runtime surface, and `assertRuntime` is INERT here on purpose.\n// Collection has no runtime: this child process exists to learn what a tree\n// registers, and there is nothing for an assertion to be about. A stub that\n// threw would refuse exactly the functions the assertion exists for \u2014 and the\n// placement the guide teaches is module scope, which collection runs.\nexport function assertRuntime() {}\nexport class FunctionRuntimeError extends Error {\n  constructor(message, runtime, required) {\n    super(message);\n    this.name = \"FUNCTION_RUNTIME_REFUSED\";\n    this.runtime = runtime;\n    this.required = required;\n  }\n}\nexport default {\n  SDK_STUB_VERSION,\n  defineFunction,\n  defineQuery,\n  defineMutation,\n  pMap,\n  ulid,\n  assertRuntime,\n  FunctionRuntimeError,\n};\n";
 /**
  * Collect one function's manifest.
  *