@gaganref/confect-test 10.3.1-fork.90 → 10.3.1-fork.92

package/dist/internal/Attempt.d.ts

@@ -1,6 +1,7 @@
 import type { Attempt as AttemptNumber } from "./Invocation.js";
 import * as Kernel from "./Kernel.js";
 import type { DocumentId, StoredDocument } from "./KernelValues.js";
+import * as Metering from "./Metering.js";
 import type * as ReadSet from "./ReadSet.js";
 /**
  * One frame of an attempt at a query or mutation: the committed state the
@@ -28,8 +29,29 @@ export declare class KernelAttempt {
     private readonly overlay;
     private readonly life;
     private readonly allReads;
-    constructor(snapshot: Kernel.State, number?: AttemptNumber, parent?: KernelAttempt | undefined);
+    /**
+     * The attempt's transaction-limit accounting. A nested mutation's frame
+     * meters into its own child, so its writes merge or drop with it while its
+     * reads stay.
+     */
+    readonly meter: Metering.Meter;
+    /**
+     * Whether the attempt asked for its caller's identity, and the time it read.
+     * Every frame of the attempt shares them, as it shares the reads.
+     */
+    private readonly observed;
+    constructor(snapshot: Kernel.State, number?: AttemptNumber, parent?: KernelAttempt | undefined, meter?: Metering.Meter);
     get reads(): ReadonlyArray<ReadSet.Read>;
+    /**
+     * Whether the function asked for its caller's identity.
+     */
+    get observedIdentity(): boolean;
+    /**
+     * The pinned time the function read, or `null` when it never read the time.
+     */
+    get observedTime(): number | null;
+    observeIdentity(): void;
+    observeTime(at: number): void;
     get closed(): boolean;
     readDocument(componentPath: string, id: DocumentId): void;
     /**
@@ -59,6 +81,12 @@ export declare class KernelAttempt {
      */
     scan(componentPath: string, tableName: string): Array<StoredDocument>;
     write(componentPath: string, id: DocumentId, doc: StoredDocument | null): void;
+    /**
+     * A query run on this attempt's snapshot rather than its pending writes. It
+     * reads and meters on its own, and its meter starts with this attempt's
+     * scheduling counters, as the binary's snapshot clone does.
+     */
+    staleSnapshot(): KernelAttempt;
     /**
      * A nested mutation begins, in a frame of its own. Dropping a failed one is
      * forgetting it.

package/dist/internal/Attempt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Attempt.d.ts","sourceRoot":"","sources":["../../src/internal/Attempt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAiB7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAMtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAP1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,YACW,QAAQ,EAAE,MAAM,CAAC,KAAK,EACtB,MAAM,GAAE,aAAiB,EACjB,MAAM,CAAC,EAAE,aAAa,YAAA,EAGxC;IAED,IAAI,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAEvC;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,QAEjD;IAED;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,GAC1C,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,GAAG,KAAK,KAAK,IAAI,CAMxC;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,IAAI,CAOlB;IAED;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvB;IAED,KAAK,SAEJ;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAMhE;IAED;;;OAGG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,CAapE;IAED,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,QAItE;IAED;;;OAGG;IACH,KAAK,IAAI,aAAa,CAErB;IAED;;;OAGG;IACH,KAAK,SASJ;IAED;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAI5B;CACF"}
+{"version":3,"file":"Attempt.d.ts","sourceRoot":"","sources":["../../src/internal/Attempt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAiB7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAiBtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAlB1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAEtE,YACW,QAAQ,EAAE,MAAM,CAAC,KAAK,EACtB,MAAM,GAAE,aAAiB,EACjB,MAAM,CAAC,EAAE,aAAa,YAAA,EACvC,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,EAKvB;IAED,IAAI,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAEvC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,eAAe,SAEd;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,QAErB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,QAEjD;IAED;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,GAC1C,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,GAAG,KAAK,KAAK,IAAI,CAMxC;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,IAAI,CAOlB;IAED;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvB;IAED,KAAK,SAEJ;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAMhE;IAED;;;OAGG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,CAapE;IAED,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,QAItE;IAED;;;;OAIG;IACH,aAAa,IAAI,aAAa,CAO7B;IAED;;;OAGG;IACH,KAAK,IAAI,aAAa,CAErB;IAED;;;OAGG;IACH,KAAK,SAUJ;IAED;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAI5B;CACF"}

package/dist/internal/Attempt.js

@@ -1,5 +1,6 @@
 import { tableNameFromId } from "./KernelValues.js";
 import { get, rows } from "./Kernel.js";
+import { Meter } from "./Metering.js";
 import { setImmediate } from "node:timers/promises";
 //#region src/internal/Attempt.ts
 /**
@@ -32,15 +33,49 @@ var KernelAttempt = class KernelAttempt {
 		open: true
 	};
 	allReads;
-	constructor(snapshot, number = 1, parent) {
+	/**
+	* The attempt's transaction-limit accounting. A nested mutation's frame
+	* meters into its own child, so its writes merge or drop with it while its
+	* reads stay.
+	*/
+	meter;
+	/**
+	* Whether the attempt asked for its caller's identity, and the time it read.
+	* Every frame of the attempt shares them, as it shares the reads.
+	*/
+	observed;
+	constructor(snapshot, number = 1, parent, meter) {
 		this.snapshot = snapshot;
 		this.number = number;
 		this.parent = parent;
 		this.allReads = parent?.allReads ?? [];
+		this.meter = meter ?? parent?.meter.child() ?? new Meter();
+		this.observed = parent?.observed ?? {
+			identity: false,
+			time: null
+		};
 	}
 	get reads() {
 		return this.allReads;
 	}
+	/**
+	* Whether the function asked for its caller's identity.
+	*/
+	get observedIdentity() {
+		return this.observed.identity;
+	}
+	/**
+	* The pinned time the function read, or `null` when it never read the time.
+	*/
+	get observedTime() {
+		return this.observed.time;
+	}
+	observeIdentity() {
+		this.observed.identity = true;
+	}
+	observeTime(at) {
+		this.observed.time = at;
+	}
 	get closed() {
 		return !this.life.open;
 	}
@@ -122,6 +157,14 @@ var KernelAttempt = class KernelAttempt {
 		writes.set(id, doc);
 	}
 	/**
+	* A query run on this attempt's snapshot rather than its pending writes. It
+	* reads and meters on its own, and its meter starts with this attempt's
+	* scheduling counters, as the binary's snapshot clone does.
+	*/
+	staleSnapshot() {
+		return new KernelAttempt(this.snapshot, this.number, void 0, this.meter.forStaleSnapshot());
+	}
+	/**
 	* A nested mutation begins, in a frame of its own. Dropping a failed one is
 	* forgetting it.
 	*/
@@ -136,6 +179,7 @@ var KernelAttempt = class KernelAttempt {
 		if (this.parent === void 0) throw new Error("The outermost frame of an attempt has no caller.");
 		if (this.life.open) throw new Error("A nested mutation's frame merges only once closed.");
 		for (const [componentPath, writes] of this.overlay) for (const [id, doc] of writes) this.parent.write(componentPath, id, doc);
+		this.meter.merge();
 	}
 	/**
 	* The outermost frame's writes, for `Kernel.apply`.

package/dist/internal/Attempt.js.map

@@ -1 +1 @@
-{"version":3,"file":"Attempt.js","names":["Kernel.get","Kernel.rows"],"sources":["../../src/internal/Attempt.ts"],"sourcesContent":["// oxlint-disable-next-line effecttsgo/node-builtin-import, no-restricted-imports -- An attempt's drain waits one real turn of the event loop, which is no deadline. Fake timers in a test replace the global `setImmediate`, not this one.\nimport { setImmediate } from \"node:timers/promises\";\nimport type { Attempt as AttemptNumber } from \"./Invocation.js\";\nimport * as Kernel from \"./Kernel.js\";\nimport type { DocumentId, StoredDocument } from \"./KernelValues.js\";\nimport { tableNameFromId } from \"./KernelValues.js\";\nimport type * as ReadSet from \"./ReadSet.js\";\n\n/**\n * Pending writes, keyed by component path, then document ID. `null` deletes.\n */\ntype Overlay = Map<string, Map<DocumentId, StoredDocument | null>>;\n\n/**\n * How long one frame takes syscalls: those it has running, those it has\n * started, and whether it still takes them.\n */\ninterface Life {\n  running: number;\n  started: number;\n  open: boolean;\n}\n\n/**\n * One frame of an attempt at a query or mutation: the committed state the\n * attempt started from, its caller's frame and its own pending writes. The\n * outermost frame belongs to the top-level function. Each nested mutation opens\n * a child frame, which merges into its caller's frame when it returns and is\n * dropped when it fails. Reads belong to the whole attempt and are never\n * dropped: a failed nested mutation's reads stay in the attempt.\n *\n * Each frame has its own lifetime. A frame takes reads and writes until it is\n * closed. A mutation's frame closes once its function has returned and no\n * syscall it started is still running, so a write a detached fiber makes after\n * the handler settled still lands in it, as on the binary. A nested mutation's\n * frame closes before it merges into its caller's, so no write reaches it after\n * its writes became its caller's.\n *\n * A frame belongs to one invocation, which alone writes to it, so a caller's\n * write made while its nested mutation is in flight stays the caller's.\n * `Kernel.apply` publishes the outermost frame's writes.\n */\nexport class KernelAttempt {\n  private readonly overlay: Overlay = new Map();\n  private readonly life: Life = { running: 0, started: 0, open: true };\n  private readonly allReads: Array<ReadSet.Read>;\n\n  constructor(\n    readonly snapshot: Kernel.State,\n    readonly number: AttemptNumber = 1,\n    private readonly parent?: KernelAttempt,\n  ) {\n    this.allReads = parent?.allReads ?? [];\n  }\n\n  get reads(): ReadonlyArray<ReadSet.Read> {\n    return this.allReads;\n  }\n\n  get closed(): boolean {\n    return !this.life.open;\n  }\n\n  readDocument(componentPath: string, id: DocumentId) {\n    this.allReads.push({ kind: \"document\", componentPath, id });\n  }\n\n  /**\n   * Record a read of an interval. The returned function advances how far the\n   * query examined it.\n   */\n  readInterval(\n    read: Omit<ReadSet.IntervalRead, \"through\">,\n  ): (through: ReadSet.Key | \"end\") => void {\n    const interval: ReadSet.IntervalRead = { ...read, through: null };\n    this.allReads.push(interval);\n    return (through) => {\n      interval.through = through;\n    };\n  }\n\n  /**\n   * A syscall began. `end` runs when it settles.\n   */\n  begin(): () => void {\n    const life = this.life;\n    life.running++;\n    life.started++;\n    return () => {\n      life.running--;\n    };\n  }\n\n  /**\n   * Resolves once a whole turn of the event loop passes with no syscall of this\n   * frame running or started. A nested call is a syscall of its caller's frame\n   * until it has drained.\n   */\n  drained(): Promise<void> {\n    const before = this.life.started;\n    return setImmediate().then(() =>\n      this.life.running === 0 && this.life.started === before\n        ? undefined\n        : this.drained(),\n    );\n  }\n\n  close() {\n    this.life.open = false;\n  }\n\n  /**\n   * The pending writes this frame sees, from the outermost frame to this one.\n   */\n  private overlays(): Array<Overlay> {\n    return this.parent === undefined\n      ? [this.overlay]\n      : [...this.parent.overlays(), this.overlay];\n  }\n\n  get(componentPath: string, id: DocumentId): StoredDocument | null {\n    for (const overlay of this.overlays().toReversed()) {\n      const write = overlay.get(componentPath)?.get(id);\n      if (write !== undefined) return write;\n    }\n    return Kernel.get(this.snapshot, componentPath, id)?.doc ?? null;\n  }\n\n  /**\n   * The table as this frame sees it, committed rows under every pending write\n   * from the outermost frame to this one.\n   */\n  scan(componentPath: string, tableName: string): Array<StoredDocument> {\n    const ids = new Set<DocumentId>();\n    for (const row of Kernel.rows(this.snapshot, componentPath, tableName))\n      ids.add(row.doc._id);\n    for (const overlay of this.overlays())\n      for (const id of overlay.get(componentPath)?.keys() ?? [])\n        if (tableNameFromId(id) === tableName) ids.add(id);\n    const docs: Array<StoredDocument> = [];\n    for (const id of ids) {\n      const doc = this.get(componentPath, id);\n      if (doc !== null) docs.push(doc);\n    }\n    return docs;\n  }\n\n  write(componentPath: string, id: DocumentId, doc: StoredDocument | null) {\n    const writes = this.overlay.get(componentPath) ?? new Map();\n    this.overlay.set(componentPath, writes);\n    writes.set(id, doc);\n  }\n\n  /**\n   * A nested mutation begins, in a frame of its own. Dropping a failed one is\n   * forgetting it.\n   */\n  child(): KernelAttempt {\n    return new KernelAttempt(this.snapshot, this.number, this);\n  }\n\n  /**\n   * A nested mutation returned and its frame closed. Its writes become its\n   * caller's.\n   */\n  merge() {\n    if (this.parent === undefined) {\n      throw new Error(\"The outermost frame of an attempt has no caller.\");\n    }\n    if (this.life.open) {\n      throw new Error(\"A nested mutation's frame merges only once closed.\");\n    }\n    for (const [componentPath, writes] of this.overlay)\n      for (const [id, doc] of writes) this.parent.write(componentPath, id, doc);\n  }\n\n  /**\n   * The outermost frame's writes, for `Kernel.apply`.\n   */\n  writes(): Array<Kernel.Write> {\n    return Array.from(this.overlay, ([componentPath, writes]) =>\n      Array.from(writes, ([id, doc]) => ({ componentPath, id, doc })),\n    ).flat();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"Attempt.js","names":["Metering.Meter","Kernel.get","Kernel.rows"],"sources":["../../src/internal/Attempt.ts"],"sourcesContent":["// oxlint-disable-next-line effecttsgo/node-builtin-import, no-restricted-imports -- An attempt's drain waits one real turn of the event loop, which is no deadline. Fake timers in a test replace the global `setImmediate`, not this one.\nimport { setImmediate } from \"node:timers/promises\";\nimport type { Attempt as AttemptNumber } from \"./Invocation.js\";\nimport * as Kernel from \"./Kernel.js\";\nimport type { DocumentId, StoredDocument } from \"./KernelValues.js\";\nimport { tableNameFromId } from \"./KernelValues.js\";\nimport * as Metering from \"./Metering.js\";\nimport type * as ReadSet from \"./ReadSet.js\";\n\n/**\n * Pending writes, keyed by component path, then document ID. `null` deletes.\n */\ntype Overlay = Map<string, Map<DocumentId, StoredDocument | null>>;\n\n/**\n * How long one frame takes syscalls: those it has running, those it has\n * started, and whether it still takes them.\n */\ninterface Life {\n  running: number;\n  started: number;\n  open: boolean;\n}\n\n/**\n * One frame of an attempt at a query or mutation: the committed state the\n * attempt started from, its caller's frame and its own pending writes. The\n * outermost frame belongs to the top-level function. Each nested mutation opens\n * a child frame, which merges into its caller's frame when it returns and is\n * dropped when it fails. Reads belong to the whole attempt and are never\n * dropped: a failed nested mutation's reads stay in the attempt.\n *\n * Each frame has its own lifetime. A frame takes reads and writes until it is\n * closed. A mutation's frame closes once its function has returned and no\n * syscall it started is still running, so a write a detached fiber makes after\n * the handler settled still lands in it, as on the binary. A nested mutation's\n * frame closes before it merges into its caller's, so no write reaches it after\n * its writes became its caller's.\n *\n * A frame belongs to one invocation, which alone writes to it, so a caller's\n * write made while its nested mutation is in flight stays the caller's.\n * `Kernel.apply` publishes the outermost frame's writes.\n */\nexport class KernelAttempt {\n  private readonly overlay: Overlay = new Map();\n  private readonly life: Life = { running: 0, started: 0, open: true };\n  private readonly allReads: Array<ReadSet.Read>;\n  /**\n   * The attempt's transaction-limit accounting. A nested mutation's frame\n   * meters into its own child, so its writes merge or drop with it while its\n   * reads stay.\n   */\n  readonly meter: Metering.Meter;\n  /**\n   * Whether the attempt asked for its caller's identity, and the time it read.\n   * Every frame of the attempt shares them, as it shares the reads.\n   */\n  private readonly observed: { identity: boolean; time: number | null };\n\n  constructor(\n    readonly snapshot: Kernel.State,\n    readonly number: AttemptNumber = 1,\n    private readonly parent?: KernelAttempt,\n    meter?: Metering.Meter,\n  ) {\n    this.allReads = parent?.allReads ?? [];\n    this.meter = meter ?? parent?.meter.child() ?? new Metering.Meter();\n    this.observed = parent?.observed ?? { identity: false, time: null };\n  }\n\n  get reads(): ReadonlyArray<ReadSet.Read> {\n    return this.allReads;\n  }\n\n  /**\n   * Whether the function asked for its caller's identity.\n   */\n  get observedIdentity(): boolean {\n    return this.observed.identity;\n  }\n\n  /**\n   * The pinned time the function read, or `null` when it never read the time.\n   */\n  get observedTime(): number | null {\n    return this.observed.time;\n  }\n\n  observeIdentity() {\n    this.observed.identity = true;\n  }\n\n  observeTime(at: number) {\n    this.observed.time = at;\n  }\n\n  get closed(): boolean {\n    return !this.life.open;\n  }\n\n  readDocument(componentPath: string, id: DocumentId) {\n    this.allReads.push({ kind: \"document\", componentPath, id });\n  }\n\n  /**\n   * Record a read of an interval. The returned function advances how far the\n   * query examined it.\n   */\n  readInterval(\n    read: Omit<ReadSet.IntervalRead, \"through\">,\n  ): (through: ReadSet.Key | \"end\") => void {\n    const interval: ReadSet.IntervalRead = { ...read, through: null };\n    this.allReads.push(interval);\n    return (through) => {\n      interval.through = through;\n    };\n  }\n\n  /**\n   * A syscall began. `end` runs when it settles.\n   */\n  begin(): () => void {\n    const life = this.life;\n    life.running++;\n    life.started++;\n    return () => {\n      life.running--;\n    };\n  }\n\n  /**\n   * Resolves once a whole turn of the event loop passes with no syscall of this\n   * frame running or started. A nested call is a syscall of its caller's frame\n   * until it has drained.\n   */\n  drained(): Promise<void> {\n    const before = this.life.started;\n    return setImmediate().then(() =>\n      this.life.running === 0 && this.life.started === before\n        ? undefined\n        : this.drained(),\n    );\n  }\n\n  close() {\n    this.life.open = false;\n  }\n\n  /**\n   * The pending writes this frame sees, from the outermost frame to this one.\n   */\n  private overlays(): Array<Overlay> {\n    return this.parent === undefined\n      ? [this.overlay]\n      : [...this.parent.overlays(), this.overlay];\n  }\n\n  get(componentPath: string, id: DocumentId): StoredDocument | null {\n    for (const overlay of this.overlays().toReversed()) {\n      const write = overlay.get(componentPath)?.get(id);\n      if (write !== undefined) return write;\n    }\n    return Kernel.get(this.snapshot, componentPath, id)?.doc ?? null;\n  }\n\n  /**\n   * The table as this frame sees it, committed rows under every pending write\n   * from the outermost frame to this one.\n   */\n  scan(componentPath: string, tableName: string): Array<StoredDocument> {\n    const ids = new Set<DocumentId>();\n    for (const row of Kernel.rows(this.snapshot, componentPath, tableName))\n      ids.add(row.doc._id);\n    for (const overlay of this.overlays())\n      for (const id of overlay.get(componentPath)?.keys() ?? [])\n        if (tableNameFromId(id) === tableName) ids.add(id);\n    const docs: Array<StoredDocument> = [];\n    for (const id of ids) {\n      const doc = this.get(componentPath, id);\n      if (doc !== null) docs.push(doc);\n    }\n    return docs;\n  }\n\n  write(componentPath: string, id: DocumentId, doc: StoredDocument | null) {\n    const writes = this.overlay.get(componentPath) ?? new Map();\n    this.overlay.set(componentPath, writes);\n    writes.set(id, doc);\n  }\n\n  /**\n   * A query run on this attempt's snapshot rather than its pending writes. It\n   * reads and meters on its own, and its meter starts with this attempt's\n   * scheduling counters, as the binary's snapshot clone does.\n   */\n  staleSnapshot(): KernelAttempt {\n    return new KernelAttempt(\n      this.snapshot,\n      this.number,\n      undefined,\n      this.meter.forStaleSnapshot(),\n    );\n  }\n\n  /**\n   * A nested mutation begins, in a frame of its own. Dropping a failed one is\n   * forgetting it.\n   */\n  child(): KernelAttempt {\n    return new KernelAttempt(this.snapshot, this.number, this);\n  }\n\n  /**\n   * A nested mutation returned and its frame closed. Its writes become its\n   * caller's.\n   */\n  merge() {\n    if (this.parent === undefined) {\n      throw new Error(\"The outermost frame of an attempt has no caller.\");\n    }\n    if (this.life.open) {\n      throw new Error(\"A nested mutation's frame merges only once closed.\");\n    }\n    for (const [componentPath, writes] of this.overlay)\n      for (const [id, doc] of writes) this.parent.write(componentPath, id, doc);\n    this.meter.merge();\n  }\n\n  /**\n   * The outermost frame's writes, for `Kernel.apply`.\n   */\n  writes(): Array<Kernel.Write> {\n    return Array.from(this.overlay, ([componentPath, writes]) =>\n      Array.from(writes, ([id, doc]) => ({ componentPath, id, doc })),\n    ).flat();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2CA,IAAa,gBAAb,MAAa,cAAc;CAiBd;CACA;CACQ;CAlBnB,0BAAoC,IAAI,IAAI;CAC5C,OAA8B;EAAE,SAAS;EAAG,SAAS;EAAG,MAAM;CAAK;CACnE;;;;;;CAMA;;;;;CAKA;CAEA,YACE,UACA,SAAiC,GACjC,QACA,OACA;EAJS,KAAA,WAAA;EACA,KAAA,SAAA;EACQ,KAAA,SAAA;EAGjB,KAAK,WAAW,QAAQ,YAAY,CAAC;EACrC,KAAK,QAAQ,SAAS,QAAQ,MAAM,MAAM,KAAK,IAAIA,MAAe;EAClE,KAAK,WAAW,QAAQ,YAAY;GAAE,UAAU;GAAO,MAAM;EAAK;CACpE;CAEA,IAAI,QAAqC;EACvC,OAAO,KAAK;CACd;;;;CAKA,IAAI,mBAA4B;EAC9B,OAAO,KAAK,SAAS;CACvB;;;;CAKA,IAAI,eAA8B;EAChC,OAAO,KAAK,SAAS;CACvB;CAEA,kBAAkB;EAChB,KAAK,SAAS,WAAW;CAC3B;CAEA,YAAY,IAAY;EACtB,KAAK,SAAS,OAAO;CACvB;CAEA,IAAI,SAAkB;EACpB,OAAO,CAAC,KAAK,KAAK;CACpB;CAEA,aAAa,eAAuB,IAAgB;EAClD,KAAK,SAAS,KAAK;GAAE,MAAM;GAAY;GAAe;EAAG,CAAC;CAC5D;;;;;CAMA,aACE,MACwC;EACxC,MAAM,WAAiC;GAAE,GAAG;GAAM,SAAS;EAAK;EAChE,KAAK,SAAS,KAAK,QAAQ;EAC3B,QAAQ,YAAY;GAClB,SAAS,UAAU;EACrB;CACF;;;;CAKA,QAAoB;EAClB,MAAM,OAAO,KAAK;EAClB,KAAK;EACL,KAAK;EACL,aAAa;GACX,KAAK;EACP;CACF;;;;;;CAOA,UAAyB;EACvB,MAAM,SAAS,KAAK,KAAK;EACzB,OAAO,aAAa,CAAC,CAAC,WACpB,KAAK,KAAK,YAAY,KAAK,KAAK,KAAK,YAAY,SAC7C,KAAA,IACA,KAAK,QAAQ,CACnB;CACF;CAEA,QAAQ;EACN,KAAK,KAAK,OAAO;CACnB;;;;CAKA,WAAmC;EACjC,OAAO,KAAK,WAAW,KAAA,IACnB,CAAC,KAAK,OAAO,IACb,CAAC,GAAG,KAAK,OAAO,SAAS,GAAG,KAAK,OAAO;CAC9C;CAEA,IAAI,eAAuB,IAAuC;EAChE,KAAK,MAAM,WAAW,KAAK,SAAS,CAAC,CAAC,WAAW,GAAG;GAClD,MAAM,QAAQ,QAAQ,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE;GAChD,IAAI,UAAU,KAAA,GAAW,OAAO;EAClC;EACA,OAAOC,IAAW,KAAK,UAAU,eAAe,EAAE,CAAC,EAAE,OAAO;CAC9D;;;;;CAMA,KAAK,eAAuB,WAA0C;EACpE,MAAM,sBAAM,IAAI,IAAgB;EAChC,KAAK,MAAM,OAAOC,KAAY,KAAK,UAAU,eAAe,SAAS,GACnE,IAAI,IAAI,IAAI,IAAI,GAAG;EACrB,KAAK,MAAM,WAAW,KAAK,SAAS,GAClC,KAAK,MAAM,MAAM,QAAQ,IAAI,aAAa,CAAC,EAAE,KAAK,KAAK,CAAC,GACtD,IAAI,gBAAgB,EAAE,MAAM,WAAW,IAAI,IAAI,EAAE;EACrD,MAAM,OAA8B,CAAC;EACrC,KAAK,MAAM,MAAM,KAAK;GACpB,MAAM,MAAM,KAAK,IAAI,eAAe,EAAE;GACtC,IAAI,QAAQ,MAAM,KAAK,KAAK,GAAG;EACjC;EACA,OAAO;CACT;CAEA,MAAM,eAAuB,IAAgB,KAA4B;EACvE,MAAM,SAAS,KAAK,QAAQ,IAAI,aAAa,qBAAK,IAAI,IAAI;EAC1D,KAAK,QAAQ,IAAI,eAAe,MAAM;EACtC,OAAO,IAAI,IAAI,GAAG;CACpB;;;;;;CAOA,gBAA+B;EAC7B,OAAO,IAAI,cACT,KAAK,UACL,KAAK,QACL,KAAA,GACA,KAAK,MAAM,iBAAiB,CAC9B;CACF;;;;;CAMA,QAAuB;EACrB,OAAO,IAAI,cAAc,KAAK,UAAU,KAAK,QAAQ,IAAI;CAC3D;;;;;CAMA,QAAQ;EACN,IAAI,KAAK,WAAW,KAAA,GAClB,MAAM,IAAI,MAAM,kDAAkD;EAEpE,IAAI,KAAK,KAAK,MACZ,MAAM,IAAI,MAAM,oDAAoD;EAEtE,KAAK,MAAM,CAAC,eAAe,WAAW,KAAK,SACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,QAAQ,KAAK,OAAO,MAAM,eAAe,IAAI,GAAG;EAC1E,KAAK,MAAM,MAAM;CACnB;;;;CAKA,SAA8B;EAC5B,OAAO,MAAM,KAAK,KAAK,UAAU,CAAC,eAAe,YAC/C,MAAM,KAAK,SAAS,CAAC,IAAI,UAAU;GAAE;GAAe;GAAI;EAAI,EAAE,CAChE,CAAC,CAAC,KAAK;CACT;AACF"}

package/dist/internal/ConvexTest.d.ts

@@ -1,6 +1,7 @@
-import type { GenericSchema, SchemaDefinition } from "convex/server";
+import type { GenericSchema, SchemaDefinition, UserIdentity } from "convex/server";
 import * as Execution from "./Execution.js";
 import type * as Kernel from "./Kernel.js";
+import * as Subscriptions from "./Subscriptions.js";
 import type * as Scheduling from "./Scheduling.js";
 type Modules = Record<string, () => Promise<any>>;
 /**
@@ -14,6 +15,24 @@ export interface KernelControls {
     readonly prepare: (reference: any, args?: any) => Promise<Execution.HeldAttempt>;
     readonly apply: (id: string) => Promise<Execution.KernelApply>;
     readonly held: () => ReadonlyArray<Execution.HeldAttempt>;
+    readonly withIdentity: (identity: Partial<UserIdentity>) => KernelControls;
+    readonly withRequestMetadata: (metadata: {
+        readonly ip?: string | null;
+        readonly userAgent?: string | null;
+    }) => KernelControls;
+    /**
+     * A client's query set under this accessor's caller.
+     */
+    readonly subscriber: () => Subscriptions.Subscriber;
+    /**
+     * Rerun every stale subscription. Lists each one whose value changed.
+     */
+    readonly refresh: () => Promise<ReadonlyArray<Subscriptions.Transition>>;
+    /**
+     * Rerun every subscription from scratch. Lists each one whose value differs
+     * from the full rerun.
+     */
+    readonly reference: () => Promise<ReadonlyArray<Subscriptions.Disagreement>>;
     /**
      * Move the kernel's clock forward, running each job due on the way at its
      * deadline.
@@ -54,7 +73,9 @@ export interface RegisterOptions {
  * it, and `apply` validates and publishes a held attempt. `mutation` applies
  * each attempt it prepares at once and prepares the next on a conflict, up to
  * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled
- * functions run on the kernel's clock, never on a host timer.
+ * functions run on the kernel's clock, never on a host timer. A subscriber's
+ * subscriptions go stale when a commit changes what they read or the identity
+ * they read changes, and `refresh` reruns them.
  */
 export declare function convexTest(schemaOrOptions?: SchemaDefinition<GenericSchema, boolean> | {
     readonly schema?: SchemaDefinition<GenericSchema, boolean>;

package/dist/internal/ConvexTest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexTest.d.ts","sourceRoot":"","sources":["../../src/internal/ConvexTest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAChB,SAAS,EAAE,GAAG,EACd,IAAI,CAAC,EAAE,GAAG,KACP,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,kCAAkC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,EAAE,CACpC,aAAa,CAAC,EAAE,MAAM,IAAI,EAC1B,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,eAAe,CAAC,EACZ,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACxC;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC;CACzC,EACL,OAAO,CAAC,EAAE,OAAO,GAChB,GAAG,CAoCL"}
+{"version":3,"file":"ConvexTest.d.ts","sourceRoot":"","sources":["../../src/internal/ConvexTest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAChB,SAAS,EAAE,GAAG,EACd,IAAI,CAAC,EAAE,GAAG,KACP,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1D,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,cAAc,CAAC;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,CAAC,QAAQ,EAAE;QACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,KAAK,cAAc,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC;IACpD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,kCAAkC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,EAAE,CACpC,aAAa,CAAC,EAAE,MAAM,IAAI,EAC1B,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,eAAe,CAAC,EACZ,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACxC;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC;CACzC,EACL,OAAO,CAAC,EAAE,OAAO,GAChB,GAAG,CAoCL"}

package/dist/internal/ConvexTest.js

@@ -1,19 +1,23 @@
 import { rowPending } from "./KernelRefusal.js";
 import { World, anonymous, withIdentity } from "./Execution.js";
+import { Registry } from "./Subscriptions.js";
 import { componentsGeneric } from "convex/server";
 //#region src/internal/ConvexTest.ts
 const isSchemaDefinition = (value) => value !== null && typeof value === "object" && "tables" in value && typeof value.tables === "object";
-const accessor = (world, caller) => ({
+const accessor = (world, subscriptions, caller) => ({
 	query: (reference, args) => world.query(caller, reference, args),
 	mutation: (reference, args) => world.mutation(caller, reference, args),
 	action: (reference, args) => world.action(caller, reference, args),
 	prepare: (reference, args) => world.prepare(caller, reference, args),
 	apply: (id) => world.apply(id),
 	held: () => world.held(),
+	subscriber: () => subscriptions.subscriber(caller),
+	refresh: () => subscriptions.refresh(),
+	reference: () => subscriptions.reference(),
 	run: (handler) => world.run(caller, "", handler),
 	runInComponent: (componentPath, handler) => world.run(caller, componentPath, handler),
-	withIdentity: (identity) => accessor(world, withIdentity(caller, identity)),
-	withRequestMetadata: (metadata) => accessor(world, {
+	withIdentity: (identity) => accessor(world, subscriptions, withIdentity(caller, identity)),
+	withRequestMetadata: (metadata) => accessor(world, subscriptions, {
 		...caller,
 		ip: metadata.ip ?? null,
 		userAgent: metadata.userAgent ?? null
@@ -34,7 +38,9 @@ const accessor = (world, caller) => ({
 * it, and `apply` validates and publishes a held attempt. `mutation` applies
 * each attempt it prepares at once and prepares the next on a conflict, up to
 * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled
-* functions run on the kernel's clock, never on a host timer.
+* functions run on the kernel's clock, never on a host timer. A subscriber's
+* subscriptions go stale when a commit changes what they read or the identity
+* they read changes, and `refresh` reruns them.
 */
 function convexTest(schemaOrOptions, modules) {
 	let schema;
@@ -49,7 +55,7 @@ function convexTest(schemaOrOptions, modules) {
 	if (modules === void 0) throw new Error("The test kernel needs the modules map: pass `import.meta.glob(...)` as the second argument.");
 	const world = new World(schema, modules, runtime);
 	return {
-		...accessor(world, anonymous),
+		...accessor(world, new Registry(world), anonymous),
 		registerComponent: (componentPath, componentSchema, componentModules, options) => {
 			world.register(componentPath, componentSchema, componentModules, options?.standing);
 			return componentsGeneric()[componentPath];

package/dist/internal/ConvexTest.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexTest.js","names":["Execution.withIdentity","KernelRefusal.rowPending","Execution.World","Execution.anonymous"],"sources":["../../src/internal/ConvexTest.ts"],"sourcesContent":["import type {\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport { componentsGeneric } from \"convex/server\";\nimport * as Execution from \"./Execution.js\";\nimport type * as Kernel from \"./Kernel.js\";\nimport * as KernelRefusal from \"./KernelRefusal.js\";\nimport type * as Scheduling from \"./Scheduling.js\";\n\ntype Modules = Record<string, () => Promise<any>>;\n\n/**\n * What the kernel adds to convex-test's surface, typed. The shim itself returns\n * `any`, as convex-test's callers expect.\n */\nexport interface KernelControls {\n  readonly query: (reference: any, args?: any) => Promise<any>;\n  readonly mutation: (reference: any, args?: any) => Promise<any>;\n  readonly action: (reference: any, args?: any) => Promise<any>;\n  readonly prepare: (\n    reference: any,\n    args?: any,\n  ) => Promise<Execution.HeldAttempt>;\n  readonly apply: (id: string) => Promise<Execution.KernelApply>;\n  readonly held: () => ReadonlyArray<Execution.HeldAttempt>;\n  /**\n   * Move the kernel's clock forward, running each job due on the way at its\n   * deadline.\n   */\n  readonly advance: (ms: number) => Promise<void>;\n  /**\n   * The pending jobs, earliest deadline first.\n   */\n  readonly jobs: () => ReadonlyArray<Scheduling.Job>;\n  /**\n   * Run the jobs due now. No future deadline is crossed.\n   */\n  readonly finishInProgressScheduledFunctions: () => Promise<void>;\n  /**\n   * Run jobs at their deadlines until only standing jobs remain, or fail with\n   * `DrainBudgetExceeded` after `maxIterations` jobs. The kernel keeps its own\n   * clock, so it never calls `advanceTimers`.\n   */\n  readonly finishAllScheduledFunctions: (\n    advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => Promise<void>;\n}\n\n/**\n * How a kit registers a component beyond its schema and modules.\n */\nexport interface RegisterOptions {\n  /**\n   * The component's functions, as `module:export`, that schedule their own next\n   * run, such as the crons component's `public:rescheduler`. A job that runs\n   * one, or that one schedules, is never drain work.\n   */\n  readonly standing?: ReadonlyArray<string>;\n}\n\nconst isSchemaDefinition = (\n  value: unknown,\n): value is SchemaDefinition<GenericSchema, boolean> =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"tables\" in value &&\n  typeof (value as { tables: unknown }).tables === \"object\";\n\nconst accessor = (world: Execution.World, caller: Execution.Caller): any => ({\n  query: (reference: any, args?: any) => world.query(caller, reference, args),\n  mutation: (reference: any, args?: any) =>\n    world.mutation(caller, reference, args),\n  action: (reference: any, args?: any) => world.action(caller, reference, args),\n  prepare: (reference: any, args?: any) =>\n    world.prepare(caller, reference, args),\n  apply: (id: string) => world.apply(id),\n  held: () => world.held(),\n  run: (handler: (ctx: any) => any) => world.run(caller, \"\", handler),\n  runInComponent: (componentPath: string, handler: (ctx: any) => any) =>\n    world.run(caller, componentPath, handler),\n  withIdentity: (identity: Partial<UserIdentity>) =>\n    accessor(world, Execution.withIdentity(caller, identity)),\n  withRequestMetadata: (metadata: {\n    readonly ip?: string | null;\n    readonly userAgent?: string | null;\n  }) =>\n    accessor(world, {\n      ...caller,\n      ip: metadata.ip ?? null,\n      userAgent: metadata.userAgent ?? null,\n    }),\n  fetch: () => Promise.reject(KernelRefusal.rowPending(\"HTTP routes\", 6)),\n  jwks: () => Promise.reject(KernelRefusal.rowPending(\"JWT verification\", 6)),\n  advance: (ms: number) => world.advance(ms),\n  jobs: () => world.jobs(),\n  finishInProgressScheduledFunctions: () => world.advance(0),\n  finishAllScheduledFunctions: (\n    _advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => world.drain(maxIterations),\n});\n\n/**\n * The test kernel under convex-test's `convexTest` signature. The fork's kernel\n * lane aliases `convex-test` to this module, so every suite that calls\n * `convexTest` directly, and `TestConfect` itself, runs on the kernel.\n *\n * Beyond convex-test, `prepare` runs a mutation to its commit point and holds\n * it, and `apply` validates and publishes a held attempt. `mutation` applies\n * each attempt it prepares at once and prepares the next on a conflict, up to\n * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled\n * functions run on the kernel's clock, never on a host timer.\n */\nexport function convexTest(\n  schemaOrOptions?:\n    | SchemaDefinition<GenericSchema, boolean>\n    | {\n        readonly schema?: SchemaDefinition<GenericSchema, boolean>;\n        readonly modules?: Modules;\n        readonly transactionLimits?: unknown;\n        readonly runtime?: Kernel.KernelRuntime;\n      },\n  modules?: Modules,\n): any {\n  let schema: SchemaDefinition<GenericSchema, boolean> | undefined;\n  let runtime: Kernel.KernelRuntime | undefined;\n  if (isSchemaDefinition(schemaOrOptions)) {\n    schema = schemaOrOptions;\n  } else if (schemaOrOptions !== undefined) {\n    if (schemaOrOptions.transactionLimits !== undefined) {\n      throw KernelRefusal.rowPending(\"transaction limits\", 6);\n    }\n    schema = schemaOrOptions.schema;\n    modules = schemaOrOptions.modules;\n    runtime = schemaOrOptions.runtime;\n  }\n  if (modules === undefined) {\n    throw new Error(\n      \"The test kernel needs the modules map: pass `import.meta.glob(...)` as the second argument.\",\n    );\n  }\n  const world = new Execution.World(schema, modules, runtime);\n  return {\n    ...accessor(world, Execution.anonymous),\n    registerComponent: (\n      componentPath: string,\n      componentSchema: SchemaDefinition<GenericSchema, boolean>,\n      componentModules: Modules,\n      options?: RegisterOptions,\n    ) => {\n      world.register(\n        componentPath,\n        componentSchema,\n        componentModules,\n        options?.standing,\n      );\n      return (componentsGeneric() as any)[componentPath];\n    },\n  };\n}\n"],"mappings":";;;;AA+DA,MAAM,sBACJ,UAEA,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAQ,MAA8B,WAAW;AAEnD,MAAM,YAAY,OAAwB,YAAmC;CAC3E,QAAQ,WAAgB,SAAe,MAAM,MAAM,QAAQ,WAAW,IAAI;CAC1E,WAAW,WAAgB,SACzB,MAAM,SAAS,QAAQ,WAAW,IAAI;CACxC,SAAS,WAAgB,SAAe,MAAM,OAAO,QAAQ,WAAW,IAAI;CAC5E,UAAU,WAAgB,SACxB,MAAM,QAAQ,QAAQ,WAAW,IAAI;CACvC,QAAQ,OAAe,MAAM,MAAM,EAAE;CACrC,YAAY,MAAM,KAAK;CACvB,MAAM,YAA+B,MAAM,IAAI,QAAQ,IAAI,OAAO;CAClE,iBAAiB,eAAuB,YACtC,MAAM,IAAI,QAAQ,eAAe,OAAO;CAC1C,eAAe,aACb,SAAS,OAAOA,aAAuB,QAAQ,QAAQ,CAAC;CAC1D,sBAAsB,aAIpB,SAAS,OAAO;EACd,GAAG;EACH,IAAI,SAAS,MAAM;EACnB,WAAW,SAAS,aAAa;CACnC,CAAC;CACH,aAAa,QAAQ,OAAOC,WAAyB,eAAe,CAAC,CAAC;CACtE,YAAY,QAAQ,OAAOA,WAAyB,oBAAoB,CAAC,CAAC;CAC1E,UAAU,OAAe,MAAM,QAAQ,EAAE;CACzC,YAAY,MAAM,KAAK;CACvB,0CAA0C,MAAM,QAAQ,CAAC;CACzD,8BACE,gBACA,kBACG,MAAM,MAAM,aAAa;AAChC;;;;;;;;;;;;AAaA,SAAgB,WACd,iBAQA,SACK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI,mBAAmB,eAAe,GACpC,SAAS;MACJ,IAAI,oBAAoB,KAAA,GAAW;EACxC,IAAI,gBAAgB,sBAAsB,KAAA,GACxC,MAAMA,WAAyB,sBAAsB,CAAC;EAExD,SAAS,gBAAgB;EACzB,UAAU,gBAAgB;EAC1B,UAAU,gBAAgB;CAC5B;CACA,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,6FACF;CAEF,MAAM,QAAQ,IAAIC,MAAgB,QAAQ,SAAS,OAAO;CAC1D,OAAO;EACL,GAAG,SAAS,OAAOC,SAAmB;EACtC,oBACE,eACA,iBACA,kBACA,YACG;GACH,MAAM,SACJ,eACA,iBACA,kBACA,SAAS,QACX;GACA,OAAQ,kBAAkB,CAAC,CAAS;EACtC;CACF;AACF"}
+{"version":3,"file":"ConvexTest.js","names":["Execution.withIdentity","KernelRefusal.rowPending","Execution.World","Subscriptions.Registry","Execution.anonymous"],"sources":["../../src/internal/ConvexTest.ts"],"sourcesContent":["import type {\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport { componentsGeneric } from \"convex/server\";\nimport * as Execution from \"./Execution.js\";\nimport type * as Kernel from \"./Kernel.js\";\nimport * as KernelRefusal from \"./KernelRefusal.js\";\nimport * as Subscriptions from \"./Subscriptions.js\";\nimport type * as Scheduling from \"./Scheduling.js\";\n\ntype Modules = Record<string, () => Promise<any>>;\n\n/**\n * What the kernel adds to convex-test's surface, typed. The shim itself returns\n * `any`, as convex-test's callers expect.\n */\nexport interface KernelControls {\n  readonly query: (reference: any, args?: any) => Promise<any>;\n  readonly mutation: (reference: any, args?: any) => Promise<any>;\n  readonly action: (reference: any, args?: any) => Promise<any>;\n  readonly prepare: (\n    reference: any,\n    args?: any,\n  ) => Promise<Execution.HeldAttempt>;\n  readonly apply: (id: string) => Promise<Execution.KernelApply>;\n  readonly held: () => ReadonlyArray<Execution.HeldAttempt>;\n  readonly withIdentity: (identity: Partial<UserIdentity>) => KernelControls;\n  readonly withRequestMetadata: (metadata: {\n    readonly ip?: string | null;\n    readonly userAgent?: string | null;\n  }) => KernelControls;\n  /**\n   * A client's query set under this accessor's caller.\n   */\n  readonly subscriber: () => Subscriptions.Subscriber;\n  /**\n   * Rerun every stale subscription. Lists each one whose value changed.\n   */\n  readonly refresh: () => Promise<ReadonlyArray<Subscriptions.Transition>>;\n  /**\n   * Rerun every subscription from scratch. Lists each one whose value differs\n   * from the full rerun.\n   */\n  readonly reference: () => Promise<ReadonlyArray<Subscriptions.Disagreement>>;\n  /**\n   * Move the kernel's clock forward, running each job due on the way at its\n   * deadline.\n   */\n  readonly advance: (ms: number) => Promise<void>;\n  /**\n   * The pending jobs, earliest deadline first.\n   */\n  readonly jobs: () => ReadonlyArray<Scheduling.Job>;\n  /**\n   * Run the jobs due now. No future deadline is crossed.\n   */\n  readonly finishInProgressScheduledFunctions: () => Promise<void>;\n  /**\n   * Run jobs at their deadlines until only standing jobs remain, or fail with\n   * `DrainBudgetExceeded` after `maxIterations` jobs. The kernel keeps its own\n   * clock, so it never calls `advanceTimers`.\n   */\n  readonly finishAllScheduledFunctions: (\n    advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => Promise<void>;\n}\n\n/**\n * How a kit registers a component beyond its schema and modules.\n */\nexport interface RegisterOptions {\n  /**\n   * The component's functions, as `module:export`, that schedule their own next\n   * run, such as the crons component's `public:rescheduler`. A job that runs\n   * one, or that one schedules, is never drain work.\n   */\n  readonly standing?: ReadonlyArray<string>;\n}\n\nconst isSchemaDefinition = (\n  value: unknown,\n): value is SchemaDefinition<GenericSchema, boolean> =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"tables\" in value &&\n  typeof (value as { tables: unknown }).tables === \"object\";\n\nconst accessor = (\n  world: Execution.World,\n  subscriptions: Subscriptions.Registry,\n  caller: Execution.Caller,\n): any => ({\n  query: (reference: any, args?: any) => world.query(caller, reference, args),\n  mutation: (reference: any, args?: any) =>\n    world.mutation(caller, reference, args),\n  action: (reference: any, args?: any) => world.action(caller, reference, args),\n  prepare: (reference: any, args?: any) =>\n    world.prepare(caller, reference, args),\n  apply: (id: string) => world.apply(id),\n  held: () => world.held(),\n  subscriber: () => subscriptions.subscriber(caller),\n  refresh: () => subscriptions.refresh(),\n  reference: () => subscriptions.reference(),\n  run: (handler: (ctx: any) => any) => world.run(caller, \"\", handler),\n  runInComponent: (componentPath: string, handler: (ctx: any) => any) =>\n    world.run(caller, componentPath, handler),\n  withIdentity: (identity: Partial<UserIdentity>) =>\n    accessor(world, subscriptions, Execution.withIdentity(caller, identity)),\n  withRequestMetadata: (metadata: {\n    readonly ip?: string | null;\n    readonly userAgent?: string | null;\n  }) =>\n    accessor(world, subscriptions, {\n      ...caller,\n      ip: metadata.ip ?? null,\n      userAgent: metadata.userAgent ?? null,\n    }),\n  fetch: () => Promise.reject(KernelRefusal.rowPending(\"HTTP routes\", 6)),\n  jwks: () => Promise.reject(KernelRefusal.rowPending(\"JWT verification\", 6)),\n  advance: (ms: number) => world.advance(ms),\n  jobs: () => world.jobs(),\n  finishInProgressScheduledFunctions: () => world.advance(0),\n  finishAllScheduledFunctions: (\n    _advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => world.drain(maxIterations),\n});\n\n/**\n * The test kernel under convex-test's `convexTest` signature. The fork's kernel\n * lane aliases `convex-test` to this module, so every suite that calls\n * `convexTest` directly, and `TestConfect` itself, runs on the kernel.\n *\n * Beyond convex-test, `prepare` runs a mutation to its commit point and holds\n * it, and `apply` validates and publishes a held attempt. `mutation` applies\n * each attempt it prepares at once and prepares the next on a conflict, up to\n * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled\n * functions run on the kernel's clock, never on a host timer. A subscriber's\n * subscriptions go stale when a commit changes what they read or the identity\n * they read changes, and `refresh` reruns them.\n */\nexport function convexTest(\n  schemaOrOptions?:\n    | SchemaDefinition<GenericSchema, boolean>\n    | {\n        readonly schema?: SchemaDefinition<GenericSchema, boolean>;\n        readonly modules?: Modules;\n        readonly transactionLimits?: unknown;\n        readonly runtime?: Kernel.KernelRuntime;\n      },\n  modules?: Modules,\n): any {\n  let schema: SchemaDefinition<GenericSchema, boolean> | undefined;\n  let runtime: Kernel.KernelRuntime | undefined;\n  if (isSchemaDefinition(schemaOrOptions)) {\n    schema = schemaOrOptions;\n  } else if (schemaOrOptions !== undefined) {\n    if (schemaOrOptions.transactionLimits !== undefined) {\n      throw KernelRefusal.rowPending(\"transaction limits\", 6);\n    }\n    schema = schemaOrOptions.schema;\n    modules = schemaOrOptions.modules;\n    runtime = schemaOrOptions.runtime;\n  }\n  if (modules === undefined) {\n    throw new Error(\n      \"The test kernel needs the modules map: pass `import.meta.glob(...)` as the second argument.\",\n    );\n  }\n  const world = new Execution.World(schema, modules, runtime);\n  return {\n    ...accessor(world, new Subscriptions.Registry(world), Execution.anonymous),\n    registerComponent: (\n      componentPath: string,\n      componentSchema: SchemaDefinition<GenericSchema, boolean>,\n      componentModules: Modules,\n      options?: RegisterOptions,\n    ) => {\n      world.register(\n        componentPath,\n        componentSchema,\n        componentModules,\n        options?.standing,\n      );\n      return (componentsGeneric() as any)[componentPath];\n    },\n  };\n}\n"],"mappings":";;;;;AAkFA,MAAM,sBACJ,UAEA,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAQ,MAA8B,WAAW;AAEnD,MAAM,YACJ,OACA,eACA,YACS;CACT,QAAQ,WAAgB,SAAe,MAAM,MAAM,QAAQ,WAAW,IAAI;CAC1E,WAAW,WAAgB,SACzB,MAAM,SAAS,QAAQ,WAAW,IAAI;CACxC,SAAS,WAAgB,SAAe,MAAM,OAAO,QAAQ,WAAW,IAAI;CAC5E,UAAU,WAAgB,SACxB,MAAM,QAAQ,QAAQ,WAAW,IAAI;CACvC,QAAQ,OAAe,MAAM,MAAM,EAAE;CACrC,YAAY,MAAM,KAAK;CACvB,kBAAkB,cAAc,WAAW,MAAM;CACjD,eAAe,cAAc,QAAQ;CACrC,iBAAiB,cAAc,UAAU;CACzC,MAAM,YAA+B,MAAM,IAAI,QAAQ,IAAI,OAAO;CAClE,iBAAiB,eAAuB,YACtC,MAAM,IAAI,QAAQ,eAAe,OAAO;CAC1C,eAAe,aACb,SAAS,OAAO,eAAeA,aAAuB,QAAQ,QAAQ,CAAC;CACzE,sBAAsB,aAIpB,SAAS,OAAO,eAAe;EAC7B,GAAG;EACH,IAAI,SAAS,MAAM;EACnB,WAAW,SAAS,aAAa;CACnC,CAAC;CACH,aAAa,QAAQ,OAAOC,WAAyB,eAAe,CAAC,CAAC;CACtE,YAAY,QAAQ,OAAOA,WAAyB,oBAAoB,CAAC,CAAC;CAC1E,UAAU,OAAe,MAAM,QAAQ,EAAE;CACzC,YAAY,MAAM,KAAK;CACvB,0CAA0C,MAAM,QAAQ,CAAC;CACzD,8BACE,gBACA,kBACG,MAAM,MAAM,aAAa;AAChC;;;;;;;;;;;;;;AAeA,SAAgB,WACd,iBAQA,SACK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI,mBAAmB,eAAe,GACpC,SAAS;MACJ,IAAI,oBAAoB,KAAA,GAAW;EACxC,IAAI,gBAAgB,sBAAsB,KAAA,GACxC,MAAMA,WAAyB,sBAAsB,CAAC;EAExD,SAAS,gBAAgB;EACzB,UAAU,gBAAgB;EAC1B,UAAU,gBAAgB;CAC5B;CACA,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,6FACF;CAEF,MAAM,QAAQ,IAAIC,MAAgB,QAAQ,SAAS,OAAO;CAC1D,OAAO;EACL,GAAG,SAAS,OAAO,IAAIC,SAAuB,KAAK,GAAGC,SAAmB;EACzE,oBACE,eACA,iBACA,kBACA,YACG;GACH,MAAM,SACJ,eACA,iBACA,kBACA,SAAS,QACX;GACA,OAAQ,kBAAkB,CAAC,CAAS;EACtC;CACF;AACF"}

package/dist/internal/Execution.d.ts

@@ -75,6 +75,26 @@ export type KernelApply = {
     readonly tag: string;
     readonly error: unknown;
 };
+/**
+ * One top-level query run and every dependency it took: the commit and reads it
+ * read, whether it asked for the caller's identity, the pinned time it read and
+ * the end of its paginated read.
+ */
+export interface QueryRun {
+    readonly outcome: Outcome;
+    readonly snapshot: Kernel.Version;
+    readonly reads: ReadonlyArray<ReadSet.Read>;
+    readonly observedIdentity: boolean;
+    /**
+     * The pinned time the query read, or `null` when it never read the time.
+     */
+    readonly time: number | null;
+    /**
+     * Where the query's paginated read ended, or `null` when it ran none. A rerun
+     * ends its page there, as the binary's query journal does.
+     */
+    readonly journal: string | null;
+}
 /**
  * A test backend: its registered components and the kernel state they share.
  */
@@ -126,6 +146,16 @@ export declare class World {
      * The held attempts, oldest first.
      */
     held(): ReadonlyArray<HeldAttempt>;
+    /**
+     * Run a query at the latest commit as a subscription runs it, under `caller`,
+     * and return its answer with every dependency it took. `time` pins the time
+     * it reads, the kernel's time now by default. `journal` ends its paginated
+     * read where an earlier run's ended.
+     */
+    subscribed(caller: Caller, reference: any, args: any, pinned: {
+        readonly time?: number;
+        readonly journal: string | null;
+    }): Promise<QueryRun>;
     /**
      * The committed pending jobs, earliest deadline first.
      */
@@ -209,6 +239,19 @@ export declare class World {
     private runAction;
     private schema;
     private view;
+    /**
+     * Read one document by ID, as the binary's `get_inner` does for a get and for
+     * the document a patch, replace, delete or cancel changes: it reads the ID's
+     * interval of the table's `by_id` index, then charges the document if there
+     * is one (`crates/database/src/transaction.rs:1188-1250`).
+     */
+    private readById;
+    /**
+     * Stage a write to a user table, counted against the execution's limits
+     * first. A write over a limit is not staged (`Writes::update`,
+     * `crates/database/src/writes.rs:241-310`).
+     */
+    private stage;
     private generateId;
     syscall(op: string, jsonArgs: string): string;
     /**

package/dist/internal/Execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Execution.d.ts","sourceRoot":"","sources":["../../src/internal/Execution.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAA8B,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAIvE,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAyB9C,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,SAAS,EAAE,MAKvB,CAAC;AAEF,eAAO,MAAM,YAAY,WACf,MAAM,YACJ,OAAO,CAAC,YAAY,CAAC,KAC9B,MAMF,CAAC;AAYF;;GAEG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACzD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,mCAAmC,CAAC;CACnE,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AA+QhF;;GAEG;AACH,qBAAa,KAAK;IAoBd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnB1B,QAAQ,CAAC,UAAU,yBAAgC;IACnD,KAAK,EAAE,MAAM,CAAC,KAAK,CAAgB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,aAAa,CAAK;IAC1B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAEpE,YACE,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACnE,OAAO,EAAE,OAAO,EACC,OAAO,GAAE,MAAM,CAAC,aAAkC,EAKpE;IAED,QAAQ,CACN,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,EAChD,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,aAAa,CAAC,MAAM,CAAM,QAYrC;IAED;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAWpB;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;OAGG;IACH,GAAG,IAAI,MAAM,CAEZ;IAED,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IAwCf,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAY7D;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAYhE;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAY9D;IAED,GAAG,CACD,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GACzB,OAAO,CAAC,GAAG,CAAC,CAUd;IAID;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAcvE;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAUtC;IAED;;OAEG;IACH,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,CAEjC;IAID;;OAEG;IACH,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAUpC;IAED;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3C;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI;IA8BZ,OAAO,CAAC,UAAU;IAIlB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAgDd;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAOjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAerB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAqCnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,SAAS;IAiCjB,OAAO,CAAC,QAAQ;IA8ChB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,WAAW;IA4CnB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAyDvB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAsDjB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,SAAS;IA+EjB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiC5C;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1D;IAED,OAAO,CAAC,aAAa;IAmKrB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAMpC;IAID,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,MAAM;IAgBd;;;OAGG;IACH,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,MAAM;IAyBd,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,MAAM;CAUf;AAoHD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAEX,CAAC"}
+{"version":3,"file":"Execution.d.ts","sourceRoot":"","sources":["../../src/internal/Execution.ts"],"names":[],"mappings":"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"}