@craft-ts/core 0.7.0-beta.13

package/src/lib/temporal-runtime.js

@@ -0,0 +1,375 @@
+import { InjectionToken, inject, } from './host/craft-compat';
+export const TEMPORAL_AWAIT_REQUEST_MARKER = Symbol('temporal-await-request-marker');
+export function createTemporalSleepRequest(delayMs, owner, signal) {
+    assertDelay(delayMs);
+    return {
+        [TEMPORAL_AWAIT_REQUEST_MARKER]: true,
+        kind: 'sleep',
+        delayMs,
+        ...(owner === undefined ? {} : { owner }),
+        ...(signal === undefined ? {} : { signal }),
+    };
+}
+export function isTemporalAwaitRequest(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        TEMPORAL_AWAIT_REQUEST_MARKER in value);
+}
+/**
+ * Suspends an async Craft program for `delayMs`.
+ *
+ * This is intentionally a generator rather than a Promise factory. The
+ * program driver can then replace the runtime clock in tests and can attach
+ * the request to the lifetime of the injector that owns the program.
+ */
+export function craftSleep(delayMs, options = {}) {
+    return (function* () {
+        yield createTemporalSleepRequest(delayMs, options.owner, options.signal);
+    })();
+}
+export function fixedTemporalSchedule(delayMs, options = {}) {
+    assertDelay(delayMs);
+    const maxAttempts = normalizeMaxAttempts(options.maxAttempts);
+    return {
+        next: ({ attempt }) => attempt > maxAttempts ? { done: true } : { done: false, delayMs },
+    };
+}
+export function exponentialTemporalSchedule(delayMs, options = {}) {
+    assertDelay(delayMs);
+    const factor = options.factor ?? 2;
+    if (!Number.isFinite(factor) || factor < 1) {
+        throw new RangeError('Temporal schedule factor must be finite and at least 1.');
+    }
+    const maxAttempts = normalizeMaxAttempts(options.maxAttempts);
+    const maxDelayMs = options.maxDelayMs ?? Number.POSITIVE_INFINITY;
+    if (maxDelayMs !== Number.POSITIVE_INFINITY)
+        assertDelay(maxDelayMs);
+    return {
+        next: ({ attempt }) => {
+            if (attempt > maxAttempts)
+                return { done: true };
+            return {
+                done: false,
+                delayMs: Math.min(maxDelayMs, delayMs * factor ** Math.max(0, attempt - 1)),
+            };
+        },
+    };
+}
+export function sequenceTemporalSchedule(delays) {
+    for (const delay of delays)
+        assertDelay(delay);
+    return {
+        next: ({ attempt }) => {
+            const delayMs = delays[attempt - 1];
+            return delayMs === undefined ? { done: true } : { done: false, delayMs };
+        },
+    };
+}
+function normalizeMaxAttempts(value) {
+    const maxAttempts = value ?? Number.POSITIVE_INFINITY;
+    if (maxAttempts !== Number.POSITIVE_INFINITY &&
+        (!Number.isInteger(maxAttempts) || maxAttempts < 0)) {
+        throw new RangeError('Temporal schedule maxAttempts must be a non-negative integer.');
+    }
+    return maxAttempts;
+}
+export const CRAFT_TEMPORAL_RUNTIME = new InjectionToken('CRAFT_TEMPORAL_RUNTIME', {
+    providedIn: 'root',
+    factory: () => new RealCraftTemporalRuntime(),
+});
+export function provideCraftTemporalRuntime(runtime) {
+    return { provide: CRAFT_TEMPORAL_RUNTIME, useValue: runtime };
+}
+export class CraftTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Craft operation timed out after ${timeoutMs}ms.`);
+        this.name = 'CraftTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** Races an operation against the injected (or explicitly supplied) clock. */
+export function withCraftTimeout(operation, timeoutMs, options = {}) {
+    assertDelay(timeoutMs);
+    const runtime = options.runtime ??
+        tryInjectTemporalRuntime() ??
+        new RealCraftTemporalRuntime();
+    return new Promise((resolve, reject) => {
+        const timeout = runtime.schedule(() => reject(new CraftTimeoutError(timeoutMs)), timeoutMs, {
+            kind: 'timeout',
+            owner: options.owner,
+            destroyRef: options.destroyRef,
+        });
+        Promise.resolve(operation).then((value) => {
+            timeout.cancel();
+            resolve(value);
+        }, (error) => {
+            timeout.cancel();
+            reject(error);
+        });
+    });
+}
+function tryInjectTemporalRuntime() {
+    try {
+        return inject(CRAFT_TEMPORAL_RUNTIME, { optional: true }) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+class TemporalTask {
+    _status = 'pending';
+    cancelListeners = new Set();
+    id;
+    dueAt;
+    kind;
+    owner;
+    callback;
+    onCancel;
+    onComplete;
+    constructor(id, dueAt, kind, owner, callback, onCancel, onComplete) {
+        this.id = id;
+        this.dueAt = dueAt;
+        this.kind = kind;
+        this.owner = owner;
+        this.callback = callback;
+        this.onCancel = onCancel;
+        this.onComplete = onComplete;
+    }
+    cancel() {
+        if (this._status === 'completed' || this._status === 'cancelled') {
+            return false;
+        }
+        this._status = 'cancelled';
+        this.onCancel();
+        for (const listener of this.cancelListeners)
+            listener();
+        return true;
+    }
+    onCancelled(listener) {
+        if (this._status === 'cancelled') {
+            listener();
+            return;
+        }
+        this.cancelListeners.add(listener);
+    }
+    snapshot() {
+        return {
+            id: this.id,
+            kind: this.kind,
+            dueAt: this.dueAt,
+            ...(this.owner === undefined ? {} : { owner: this.owner }),
+            status: this._status,
+        };
+    }
+    markRunning() {
+        if (this._status !== 'pending')
+            return false;
+        this._status = 'running';
+        return true;
+    }
+    markCompleted() {
+        if (this._status === 'running') {
+            this._status = 'completed';
+            this.onComplete();
+        }
+    }
+}
+class BaseCraftTemporalRuntime {
+    tasks = new Map();
+    nextId = 1;
+    dateNow() {
+        return Date.now();
+    }
+    createTask(callback, delayMs, options) {
+        assertDelay(delayMs);
+        const id = this.nextId++;
+        const destroyRef = options.destroyRef;
+        const signal = options.signal;
+        let removeAbortListener = () => undefined;
+        const task = new TemporalTask(id, this.now() + delayMs, options.kind ?? 'schedule', options.owner, callback, () => {
+            removeAbortListener();
+            this.tasks.delete(id);
+        }, () => removeAbortListener());
+        this.tasks.set(id, task);
+        if (signal) {
+            const abort = () => task.cancel();
+            signal.addEventListener('abort', abort, { once: true });
+            removeAbortListener = () => signal.removeEventListener('abort', abort);
+            if (signal.aborted)
+                task.cancel();
+        }
+        destroyRef?.onDestroy(() => task.cancel());
+        return task;
+    }
+    schedule(callback, delayMs, options = {}) {
+        return this.createTask(callback, delayMs, options);
+    }
+    sleep(delayMs, options = {}) {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const { destroyRef, ...scheduleOptions } = options;
+            const task = this.schedule(() => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve();
+            }, delayMs, { ...scheduleOptions, kind: options.kind ?? 'sleep' });
+            if (task instanceof TemporalTask) {
+                task.onCancelled(() => {
+                    if (!settled) {
+                        settled = true;
+                        reject(new TemporalCancelledError());
+                    }
+                });
+            }
+            destroyRef?.onDestroy(() => {
+                task.cancel();
+            });
+        });
+    }
+    pendingTasks(owner) {
+        return [...this.tasks.values()]
+            .filter((task) => task.snapshot().status === 'pending' &&
+            (owner === undefined || task.snapshot().owner === owner))
+            .sort(compareTasks)
+            .map((task) => task.snapshot());
+    }
+    cancelAll(owner) {
+        for (const task of [...this.tasks.values()]) {
+            if (owner === undefined || task.snapshot().owner === owner) {
+                task.cancel();
+            }
+        }
+    }
+    takeNextDueTask(limit) {
+        return [...this.tasks.values()]
+            .filter((task) => task.snapshot().status === 'pending' &&
+            task.snapshot().dueAt <= limit)
+            .sort(compareTasks)[0];
+    }
+    runTask(task) {
+        if (!task.markRunning())
+            return;
+        try {
+            task.callback();
+        }
+        finally {
+            task.markCompleted();
+            this.tasks.delete(task.id);
+        }
+    }
+}
+/** Runtime adapter backed by the host's native timer APIs. */
+export class RealCraftTemporalRuntime extends BaseCraftTemporalRuntime {
+    nativeTimers = new Map();
+    now() {
+        return typeof globalThis.performance?.now === 'function'
+            ? globalThis.performance.now()
+            : Date.now();
+    }
+    schedule(callback, delayMs, options = {}) {
+        const task = super.schedule(callback, delayMs, options);
+        if (task.snapshot().status === 'cancelled')
+            return task;
+        const nativeTimer = setTimeout(() => {
+            this.nativeTimers.delete(task.id);
+            this.runTask(task);
+        }, delayMs);
+        this.nativeTimers.set(task.id, nativeTimer);
+        const cancel = task.cancel.bind(task);
+        task.cancel = () => {
+            const cancelled = cancel();
+            if (cancelled) {
+                const timer = this.nativeTimers.get(task.id);
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                this.nativeTimers.delete(task.id);
+            }
+            return cancelled;
+        };
+        return task;
+    }
+}
+/**
+ * Deterministic adapter for tests. It never waits for wall-clock time.
+ * Equal deadlines are executed in creation order.
+ */
+export class VirtualCraftTemporalRuntime extends BaseCraftTemporalRuntime {
+    currentTime;
+    constructor(initialTime = 0) {
+        super();
+        assertFiniteTime(initialTime, 'initialTime');
+        this.currentTime = initialTime;
+    }
+    now() {
+        return this.currentTime;
+    }
+    dateNow() {
+        return this.currentTime;
+    }
+    async advanceBy(milliseconds) {
+        assertDelay(milliseconds);
+        await this.advanceTo(this.currentTime + milliseconds);
+    }
+    async advanceTo(time) {
+        assertFiniteTime(time, 'time');
+        if (time < this.currentTime) {
+            throw new RangeError('Virtual time cannot move backwards.');
+        }
+        for (;;) {
+            const task = this.takeNextDueTask(time);
+            if (!task)
+                break;
+            this.currentTime = task.snapshot().dueAt;
+            this.runTask(task);
+            await Promise.resolve();
+        }
+        this.currentTime = time;
+        await Promise.resolve();
+    }
+    async advanceToNextTask() {
+        const next = this.pendingTasks()[0];
+        if (!next)
+            return false;
+        await this.advanceTo(next.dueAt);
+        return true;
+    }
+    async runUntilIdle(maxTasks = 10_000) {
+        let count = 0;
+        while (await this.advanceToNextTask()) {
+            count += 1;
+            if (count > maxTasks) {
+                throw new Error(`Virtual temporal runtime exceeded ${maxTasks} tasks without becoming idle.`);
+            }
+        }
+    }
+    reset(time = 0) {
+        assertFiniteTime(time, 'time');
+        this.cancelAll();
+        this.currentTime = time;
+    }
+}
+export class TemporalCancelledError extends Error {
+    constructor() {
+        super('The Craft temporal task was cancelled.');
+        this.name = 'TemporalCancelledError';
+    }
+}
+function assertDelay(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new RangeError(`Temporal delay must be a finite non-negative number; received ${value}.`);
+    }
+}
+function assertFiniteTime(value, name) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`Virtual ${name} must be finite; received ${value}.`);
+    }
+}
+function compareTasks(left, right) {
+    const leftSnapshot = left.snapshot();
+    const rightSnapshot = right.snapshot();
+    return (leftSnapshot.dueAt - rightSnapshot.dueAt ||
+        leftSnapshot.id - rightSnapshot.id);
+}
+//# sourceMappingURL=temporal-runtime.js.map

package/src/lib/temporal-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-runtime.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/temporal-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DestroyRef,\n  InjectionToken,\n  inject,\n  type Provider,\n} from './host/craft-compat';\n\nexport const TEMPORAL_AWAIT_REQUEST_MARKER = Symbol(\n  'temporal-await-request-marker',\n);\n\nexport type TemporalTaskKind = 'sleep' | 'timeout' | 'schedule' | (string & {});\n\nexport type TemporalTaskStatus =\n  | 'pending'\n  | 'running'\n  | 'completed'\n  | 'cancelled';\n\nexport type TemporalTaskSnapshot = Readonly<{\n  id: number;\n  kind: TemporalTaskKind;\n  dueAt: number;\n  owner?: string;\n  status: TemporalTaskStatus;\n}>;\n\nexport type TemporalScheduleOptions = Readonly<{\n  kind?: TemporalTaskKind;\n  owner?: string;\n  destroyRef?: DestroyRef;\n  signal?: AbortSignal;\n}>;\n\nexport type TemporalTaskHandle = Readonly<{\n  id: number;\n  cancel(): boolean;\n  snapshot(): TemporalTaskSnapshot;\n}>;\n\nexport interface CraftTemporalRuntime {\n  /** Monotonic time used for durations and deadlines. */\n  now(): number;\n\n  /** Civil time, kept separate from the monotonic duration clock. */\n  dateNow(): number;\n\n  schedule(\n    callback: () => void,\n    delayMs: number,\n    options?: TemporalScheduleOptions,\n  ): TemporalTaskHandle;\n\n  sleep(delayMs: number, options?: TemporalScheduleOptions): Promise<void>;\n\n  pendingTasks(owner?: string): readonly TemporalTaskSnapshot[];\n\n  cancelAll(owner?: string): void;\n}\n\nexport type RuntimeTemporalAwaitRequest = Readonly<{\n  [TEMPORAL_AWAIT_REQUEST_MARKER]: true;\n  kind: 'sleep' | 'promise';\n  delayMs: number;\n  owner?: string;\n  signal?: AbortSignal;\n}>;\n\nexport function createTemporalSleepRequest(\n  delayMs: number,\n  owner?: string,\n  signal?: AbortSignal,\n): RuntimeTemporalAwaitRequest {\n  assertDelay(delayMs);\n  return {\n    [TEMPORAL_AWAIT_REQUEST_MARKER]: true,\n    kind: 'sleep',\n    delayMs,\n    ...(owner === undefined ? {} : { owner }),\n    ...(signal === undefined ? {} : { signal }),\n  };\n}\n\nexport function isTemporalAwaitRequest(\n  value: unknown,\n): value is RuntimeTemporalAwaitRequest {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    TEMPORAL_AWAIT_REQUEST_MARKER in value\n  );\n}\n\n/**\n * Suspends an async Craft program for `delayMs`.\n *\n * This is intentionally a generator rather than a Promise factory. The\n * program driver can then replace the runtime clock in tests and can attach\n * the request to the lifetime of the injector that owns the program.\n */\nexport function craftSleep(\n  delayMs: number,\n  options: Readonly<{ owner?: string; signal?: AbortSignal }> = {},\n): Generator<RuntimeTemporalAwaitRequest, void, unknown> {\n  return (function* () {\n    yield createTemporalSleepRequest(delayMs, options.owner, options.signal);\n  })();\n}\n\nexport type CraftTemporalScheduleContext = Readonly<{\n  /** One-based number of the next retry/repeat attempt. */\n  attempt: number;\n  elapsedMs: number;\n  input?: unknown;\n  error?: unknown;\n}>;\n\nexport type CraftTemporalScheduleDecision =\n  | Readonly<{ done: true }>\n  | Readonly<{ done: false; delayMs: number }>;\n\nexport interface CraftTemporalSchedule {\n  next(context: CraftTemporalScheduleContext): CraftTemporalScheduleDecision;\n}\n\nexport function fixedTemporalSchedule(\n  delayMs: number,\n  options: Readonly<{ maxAttempts?: number }> = {},\n): CraftTemporalSchedule {\n  assertDelay(delayMs);\n  const maxAttempts = normalizeMaxAttempts(options.maxAttempts);\n  return {\n    next: ({ attempt }) =>\n      attempt > maxAttempts ? { done: true } : { done: false, delayMs },\n  };\n}\n\nexport function exponentialTemporalSchedule(\n  delayMs: number,\n  options: Readonly<{\n    factor?: number;\n    maxAttempts?: number;\n    maxDelayMs?: number;\n  }> = {},\n): CraftTemporalSchedule {\n  assertDelay(delayMs);\n  const factor = options.factor ?? 2;\n  if (!Number.isFinite(factor) || factor < 1) {\n    throw new RangeError(\n      'Temporal schedule factor must be finite and at least 1.',\n    );\n  }\n  const maxAttempts = normalizeMaxAttempts(options.maxAttempts);\n  const maxDelayMs = options.maxDelayMs ?? Number.POSITIVE_INFINITY;\n  if (maxDelayMs !== Number.POSITIVE_INFINITY) assertDelay(maxDelayMs);\n\n  return {\n    next: ({ attempt }) => {\n      if (attempt > maxAttempts) return { done: true };\n      return {\n        done: false,\n        delayMs: Math.min(\n          maxDelayMs,\n          delayMs * factor ** Math.max(0, attempt - 1),\n        ),\n      };\n    },\n  };\n}\n\nexport function sequenceTemporalSchedule(\n  delays: readonly number[],\n): CraftTemporalSchedule {\n  for (const delay of delays) assertDelay(delay);\n  return {\n    next: ({ attempt }) => {\n      const delayMs = delays[attempt - 1];\n      return delayMs === undefined ? { done: true } : { done: false, delayMs };\n    },\n  };\n}\n\nfunction normalizeMaxAttempts(value: number | undefined): number {\n  const maxAttempts = value ?? Number.POSITIVE_INFINITY;\n  if (\n    maxAttempts !== Number.POSITIVE_INFINITY &&\n    (!Number.isInteger(maxAttempts) || maxAttempts < 0)\n  ) {\n    throw new RangeError(\n      'Temporal schedule maxAttempts must be a non-negative integer.',\n    );\n  }\n  return maxAttempts;\n}\n\nexport const CRAFT_TEMPORAL_RUNTIME = new InjectionToken<CraftTemporalRuntime>(\n  'CRAFT_TEMPORAL_RUNTIME',\n  {\n    providedIn: 'root',\n    factory: () => new RealCraftTemporalRuntime(),\n  },\n);\n\nexport function provideCraftTemporalRuntime(\n  runtime: CraftTemporalRuntime,\n): Provider {\n  return { provide: CRAFT_TEMPORAL_RUNTIME, useValue: runtime };\n}\n\nexport class CraftTimeoutError extends Error {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Craft operation timed out after ${timeoutMs}ms.`);\n    this.name = 'CraftTimeoutError';\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/** Races an operation against the injected (or explicitly supplied) clock. */\nexport function withCraftTimeout<T>(\n  operation: PromiseLike<T>,\n  timeoutMs: number,\n  options: Readonly<{\n    runtime?: CraftTemporalRuntime;\n    owner?: string;\n    destroyRef?: DestroyRef;\n  }> = {},\n): Promise<T> {\n  assertDelay(timeoutMs);\n  const runtime =\n    options.runtime ??\n    tryInjectTemporalRuntime() ??\n    new RealCraftTemporalRuntime();\n\n  return new Promise<T>((resolve, reject) => {\n    const timeout = runtime.schedule(\n      () => reject(new CraftTimeoutError(timeoutMs)),\n      timeoutMs,\n      {\n        kind: 'timeout',\n        owner: options.owner,\n        destroyRef: options.destroyRef,\n      },\n    );\n\n    Promise.resolve(operation).then(\n      (value) => {\n        timeout.cancel();\n        resolve(value);\n      },\n      (error: unknown) => {\n        timeout.cancel();\n        reject(error);\n      },\n    );\n  });\n}\n\nfunction tryInjectTemporalRuntime(): CraftTemporalRuntime | undefined {\n  try {\n    return inject(CRAFT_TEMPORAL_RUNTIME, { optional: true }) ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nclass TemporalTask implements TemporalTaskHandle {\n  private _status: TemporalTaskStatus = 'pending';\n  private readonly cancelListeners = new Set<() => void>();\n  readonly id: number;\n  private readonly dueAt: number;\n  private readonly kind: TemporalTaskKind;\n  private readonly owner: string | undefined;\n  readonly callback: () => void;\n  private readonly onCancel: () => void;\n  private readonly onComplete: () => void;\n\n  constructor(\n    id: number,\n    dueAt: number,\n    kind: TemporalTaskKind,\n    owner: string | undefined,\n    callback: () => void,\n    onCancel: () => void,\n    onComplete: () => void,\n  ) {\n    this.id = id;\n    this.dueAt = dueAt;\n    this.kind = kind;\n    this.owner = owner;\n    this.callback = callback;\n    this.onCancel = onCancel;\n    this.onComplete = onComplete;\n  }\n\n  cancel(): boolean {\n    if (this._status === 'completed' || this._status === 'cancelled') {\n      return false;\n    }\n\n    this._status = 'cancelled';\n    this.onCancel();\n    for (const listener of this.cancelListeners) listener();\n    return true;\n  }\n\n  onCancelled(listener: () => void): void {\n    if (this._status === 'cancelled') {\n      listener();\n      return;\n    }\n    this.cancelListeners.add(listener);\n  }\n\n  snapshot(): TemporalTaskSnapshot {\n    return {\n      id: this.id,\n      kind: this.kind,\n      dueAt: this.dueAt,\n      ...(this.owner === undefined ? {} : { owner: this.owner }),\n      status: this._status,\n    };\n  }\n\n  markRunning(): boolean {\n    if (this._status !== 'pending') return false;\n    this._status = 'running';\n    return true;\n  }\n\n  markCompleted(): void {\n    if (this._status === 'running') {\n      this._status = 'completed';\n      this.onComplete();\n    }\n  }\n}\n\ntype TrackedTask = TemporalTask;\n\nabstract class BaseCraftTemporalRuntime implements CraftTemporalRuntime {\n  protected readonly tasks = new Map<number, TrackedTask>();\n  private nextId = 1;\n\n  abstract now(): number;\n\n  dateNow(): number {\n    return Date.now();\n  }\n\n  protected createTask(\n    callback: () => void,\n    delayMs: number,\n    options: TemporalScheduleOptions,\n  ): TrackedTask {\n    assertDelay(delayMs);\n    const id = this.nextId++;\n    const destroyRef = options.destroyRef;\n    const signal = options.signal;\n    let removeAbortListener: () => void = () => undefined;\n\n    const task = new TemporalTask(\n      id,\n      this.now() + delayMs,\n      options.kind ?? 'schedule',\n      options.owner,\n      callback,\n      () => {\n        removeAbortListener();\n        this.tasks.delete(id);\n      },\n      () => removeAbortListener(),\n    );\n\n    this.tasks.set(id, task);\n\n    if (signal) {\n      const abort = () => task.cancel();\n      signal.addEventListener('abort', abort, { once: true });\n      removeAbortListener = () => signal.removeEventListener('abort', abort);\n      if (signal.aborted) task.cancel();\n    }\n\n    destroyRef?.onDestroy(() => task.cancel());\n    return task;\n  }\n\n  schedule(\n    callback: () => void,\n    delayMs: number,\n    options: TemporalScheduleOptions = {},\n  ): TemporalTaskHandle {\n    return this.createTask(callback, delayMs, options);\n  }\n\n  sleep(delayMs: number, options: TemporalScheduleOptions = {}): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      let settled = false;\n      const { destroyRef, ...scheduleOptions } = options;\n      const task = this.schedule(\n        () => {\n          if (settled) return;\n          settled = true;\n          resolve();\n        },\n        delayMs,\n        { ...scheduleOptions, kind: options.kind ?? 'sleep' },\n      );\n\n      if (task instanceof TemporalTask) {\n        task.onCancelled(() => {\n          if (!settled) {\n            settled = true;\n            reject(new TemporalCancelledError());\n          }\n        });\n      }\n\n      destroyRef?.onDestroy(() => {\n        task.cancel();\n      });\n    });\n  }\n\n  pendingTasks(owner?: string): readonly TemporalTaskSnapshot[] {\n    return [...this.tasks.values()]\n      .filter(\n        (task) =>\n          task.snapshot().status === 'pending' &&\n          (owner === undefined || task.snapshot().owner === owner),\n      )\n      .sort(compareTasks)\n      .map((task) => task.snapshot());\n  }\n\n  cancelAll(owner?: string): void {\n    for (const task of [...this.tasks.values()]) {\n      if (owner === undefined || task.snapshot().owner === owner) {\n        task.cancel();\n      }\n    }\n  }\n\n  protected takeNextDueTask(limit: number): TrackedTask | undefined {\n    return [...this.tasks.values()]\n      .filter(\n        (task) =>\n          task.snapshot().status === 'pending' &&\n          task.snapshot().dueAt <= limit,\n      )\n      .sort(compareTasks)[0];\n  }\n\n  protected runTask(task: TrackedTask): void {\n    if (!task.markRunning()) return;\n    try {\n      task.callback();\n    } finally {\n      task.markCompleted();\n      this.tasks.delete(task.id);\n    }\n  }\n}\n\n/** Runtime adapter backed by the host's native timer APIs. */\nexport class RealCraftTemporalRuntime extends BaseCraftTemporalRuntime {\n  private readonly nativeTimers = new Map<\n    number,\n    ReturnType<typeof setTimeout>\n  >();\n\n  now(): number {\n    return typeof globalThis.performance?.now === 'function'\n      ? globalThis.performance.now()\n      : Date.now();\n  }\n\n  override schedule(\n    callback: () => void,\n    delayMs: number,\n    options: TemporalScheduleOptions = {},\n  ): TemporalTaskHandle {\n    const task = super.schedule(callback, delayMs, options) as TemporalTask;\n    if (task.snapshot().status === 'cancelled') return task;\n    const nativeTimer = setTimeout(() => {\n      this.nativeTimers.delete(task.id);\n      this.runTask(task as TrackedTask);\n    }, delayMs);\n    this.nativeTimers.set(task.id, nativeTimer);\n\n    const cancel = task.cancel.bind(task);\n    task.cancel = () => {\n      const cancelled = cancel();\n      if (cancelled) {\n        const timer = this.nativeTimers.get(task.id);\n        if (timer !== undefined) clearTimeout(timer);\n        this.nativeTimers.delete(task.id);\n      }\n      return cancelled;\n    };\n    return task;\n  }\n}\n\n/**\n * Deterministic adapter for tests. It never waits for wall-clock time.\n * Equal deadlines are executed in creation order.\n */\nexport class VirtualCraftTemporalRuntime extends BaseCraftTemporalRuntime {\n  private currentTime: number;\n\n  constructor(initialTime = 0) {\n    super();\n    assertFiniteTime(initialTime, 'initialTime');\n    this.currentTime = initialTime;\n  }\n\n  now(): number {\n    return this.currentTime;\n  }\n\n  override dateNow(): number {\n    return this.currentTime;\n  }\n\n  async advanceBy(milliseconds: number): Promise<void> {\n    assertDelay(milliseconds);\n    await this.advanceTo(this.currentTime + milliseconds);\n  }\n\n  async advanceTo(time: number): Promise<void> {\n    assertFiniteTime(time, 'time');\n    if (time < this.currentTime) {\n      throw new RangeError('Virtual time cannot move backwards.');\n    }\n\n    for (;;) {\n      const task = this.takeNextDueTask(time);\n      if (!task) break;\n      this.currentTime = task.snapshot().dueAt;\n      this.runTask(task);\n      await Promise.resolve();\n    }\n\n    this.currentTime = time;\n    await Promise.resolve();\n  }\n\n  async advanceToNextTask(): Promise<boolean> {\n    const next = this.pendingTasks()[0];\n    if (!next) return false;\n    await this.advanceTo(next.dueAt);\n    return true;\n  }\n\n  async runUntilIdle(maxTasks = 10_000): Promise<void> {\n    let count = 0;\n    while (await this.advanceToNextTask()) {\n      count += 1;\n      if (count > maxTasks) {\n        throw new Error(\n          `Virtual temporal runtime exceeded ${maxTasks} tasks without becoming idle.`,\n        );\n      }\n    }\n  }\n\n  reset(time = 0): void {\n    assertFiniteTime(time, 'time');\n    this.cancelAll();\n    this.currentTime = time;\n  }\n}\n\nexport class TemporalCancelledError extends Error {\n  constructor() {\n    super('The Craft temporal task was cancelled.');\n    this.name = 'TemporalCancelledError';\n  }\n}\n\nfunction assertDelay(value: number): void {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new RangeError(\n      `Temporal delay must be a finite non-negative number; received ${value}.`,\n    );\n  }\n}\n\nfunction assertFiniteTime(value: number, name: string): void {\n  if (!Number.isFinite(value)) {\n    throw new RangeError(`Virtual ${name} must be finite; received ${value}.`);\n  }\n}\n\nfunction compareTasks(\n  left: TemporalTaskHandle,\n  right: TemporalTaskHandle,\n): number {\n  const leftSnapshot = left.snapshot();\n  const rightSnapshot = right.snapshot();\n  return (\n    leftSnapshot.dueAt - rightSnapshot.dueAt ||\n    leftSnapshot.id - rightSnapshot.id\n  );\n}\n"]}