stitchkit 0.80.0 → 0.80.1

package/dist/application/revision-signal.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+export declare const RevisionSignalStateSchema: z.ZodEnum<{
+    closed: "closed";
+    open: "open";
+}>;
+export type RevisionSignalState = z.infer<typeof RevisionSignalStateSchema>;
+export declare const RevisionSignalWaitOutcomeSchema: z.ZodEnum<{
+    aborted: "aborted";
+    capacity: "capacity";
+    changed: "changed";
+    closed: "closed";
+    "timed-out": "timed-out";
+}>;
+export type RevisionSignalWaitOutcome = z.infer<typeof RevisionSignalWaitOutcomeSchema>;
+export declare const RevisionSignalWaitResultSchema: z.ZodReadonly<z.ZodObject<{
+    outcome: z.ZodEnum<{
+        aborted: "aborted";
+        capacity: "capacity";
+        changed: "changed";
+        closed: "closed";
+        "timed-out": "timed-out";
+    }>;
+    revision: z.ZodNumber;
+}, z.core.$strict>>;
+export type RevisionSignalWaitResult = z.infer<typeof RevisionSignalWaitResultSchema>;
+export declare const RevisionSignalAdvanceResultSchema: z.ZodReadonly<z.ZodObject<{
+    outcome: z.ZodEnum<{
+        advanced: "advanced";
+        closed: "closed";
+    }>;
+    revision: z.ZodNumber;
+}, z.core.$strict>>;
+export type RevisionSignalAdvanceResult = z.infer<typeof RevisionSignalAdvanceResultSchema>;
+export declare const RevisionSignalSnapshotSchema: z.ZodReadonly<z.ZodObject<{
+    state: z.ZodEnum<{
+        closed: "closed";
+        open: "open";
+    }>;
+    revision: z.ZodNumber;
+    pending: z.ZodNumber;
+    maxWaiters: z.ZodNumber;
+    advances: z.ZodNumber;
+    refusedAdvances: z.ZodNumber;
+    waits: z.ZodNumber;
+    changed: z.ZodNumber;
+    timedOut: z.ZodNumber;
+    aborted: z.ZodNumber;
+    closedWaits: z.ZodNumber;
+    capacityRefusals: z.ZodNumber;
+    clockFailures: z.ZodNumber;
+}, z.core.$strict>>;
+export type RevisionSignalSnapshot = z.infer<typeof RevisionSignalSnapshotSchema>;
+export interface RevisionSignalTimer {
+    cancel(): void;
+}
+/** Timer boundary for deterministic wait-budget tests. */
+export interface RevisionSignalClock {
+    schedule(callback: () => void, delayMs: number): RevisionSignalTimer;
+}
+export interface RevisionSignalConfig {
+    /** Maximum simultaneously parked waits. */
+    readonly maxWaiters: number;
+    /** Defaults to the platform timer. */
+    readonly clock?: RevisionSignalClock;
+}
+export interface RevisionSignalWaitOptions {
+    readonly signal?: AbortSignal;
+    /** Absent means wait until an advance, abort or close. */
+    readonly timeoutMs?: number;
+}
+export interface RevisionSignal {
+    /** Advance the monotonic revision and broadcast it to every older waiter. */
+    advance(): RevisionSignalAdvanceResult;
+    /**
+     * Wait for a revision newer than `after`.
+     *
+     * An already newer revision resolves immediately. The current revision parks the wait. A
+     * future revision is a caller bug and is rejected before any waiter is retained.
+     */
+    wait(after: number, options?: RevisionSignalWaitOptions): Promise<RevisionSignalWaitResult>;
+    close(): RevisionSignalSnapshot;
+    getSnapshot(): RevisionSignalSnapshot;
+}
+/** Finite process-local broadcast wake-up keyed by a monotonic revision. */
+export declare function createRevisionSignal(config: RevisionSignalConfig): RevisionSignal;
+//# sourceMappingURL=revision-signal.d.ts.map

package/dist/application/revision-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-signal.d.ts","sourceRoot":"","sources":["../../src/application/revision-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB;;;EAA6B,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,+BAA+B;;;;;;EAM1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,8BAA8B;;;;;;;;;mBAM9B,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,iCAAiC;;;;;;mBAMjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;mBAiB5B,CAAC;AACd,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,OAAO,IAAI,2BAA2B,CAAC;IACvC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5F,KAAK,IAAI,sBAAsB,CAAC;IAChC,WAAW,IAAI,sBAAsB,CAAC;CACvC;AAaD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoHjF"}

package/dist/application.d.ts

@@ -10,6 +10,7 @@ export { defineKeyspace, type KeyspaceBackend, type KeyspaceChange, type Keyspac
 export { type SqliteKeyspaceBackendConfig, sqliteKeyspaceBackend, } from './application/keyspace-sqlite.js';
 export { type ApplicationSnapshotSink, type ApplicationSnapshotSinkConfig, type ApplicationSnapshotSinkError, type ApplicationSnapshotSinkStatus, ApplicationSnapshotSinkStatusSchema, createApplicationSnapshotSink, type RevisionedApplicationSnapshot, } from './application/latest-sink.js';
 export { defineManagedResource, type ManagedResource, type ManagedResourceContext, type ManagedResourceDependency, type ManagedResourcePublished, type ManagedResourcePublishesNoValue, type ManagedResourceStartResult, managedResourceDependencyId, } from './application/resource.js';
+export { createRevisionSignal, type RevisionSignal, type RevisionSignalAdvanceResult, RevisionSignalAdvanceResultSchema, type RevisionSignalClock, type RevisionSignalConfig, type RevisionSignalSnapshot, RevisionSignalSnapshotSchema, type RevisionSignalState, RevisionSignalStateSchema, type RevisionSignalTimer, type RevisionSignalWaitOptions, type RevisionSignalWaitOutcome, RevisionSignalWaitOutcomeSchema, type RevisionSignalWaitResult, RevisionSignalWaitResultSchema, } from './application/revision-signal.js';
 export { createManagedSchedule, type ManagedSchedule, type ManagedScheduleClock, type ManagedScheduleConfig, type ManagedScheduleDescriptor, ManagedScheduleDescriptorSchema, type ManagedScheduleErrorPolicy, ManagedScheduleErrorPolicySchema, type ManagedScheduleOverlap, ManagedScheduleOverlapSchema, type ManagedScheduleRunContext, type ManagedScheduleStatus, ManagedScheduleStatusSchema, type ManagedScheduleTimer, } from './application/schedule.js';
 export { type ManagedServerResource, type ManagedServerResourceConfig, managedServerResource, } from './application/server-resource.js';
 export { type AttachedWatcher, createWatchHub, type WatchHub, type WatchHubConfig, type WatchOperation, type WatchSubscriber, watchKey, } from './application/watch-hub.js';

package/dist/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,sBAAsB,EACtB,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,8BAA8B,EACnC,oCAAoC,EACpC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,2CAA2C,EAC3C,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAC/B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,eAAe,EACpB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/application.js

@@ -778,6 +778,167 @@ function sqliteKeyspaceBackend(declaration, config) {
     }
   };
 }
+// src/application/revision-signal.ts
+import { z as z5 } from "zod";
+var NonNegativeSafeIntegerSchema = z5.number().int().nonnegative().safe();
+var PositiveSafeIntegerSchema2 = z5.number().int().positive().safe();
+var TimerDelaySchema = z5.number().int().positive().max(2147483647);
+var RevisionSignalStateSchema = z5.enum(["open", "closed"]);
+var RevisionSignalWaitOutcomeSchema = z5.enum([
+  "changed",
+  "timed-out",
+  "aborted",
+  "closed",
+  "capacity"
+]);
+var RevisionSignalWaitResultSchema = z5.object({
+  outcome: RevisionSignalWaitOutcomeSchema,
+  revision: NonNegativeSafeIntegerSchema
+}).strict().readonly();
+var RevisionSignalAdvanceResultSchema = z5.object({
+  outcome: z5.enum(["advanced", "closed"]),
+  revision: NonNegativeSafeIntegerSchema
+}).strict().readonly();
+var RevisionSignalSnapshotSchema = z5.object({
+  state: RevisionSignalStateSchema,
+  revision: NonNegativeSafeIntegerSchema,
+  pending: NonNegativeSafeIntegerSchema,
+  maxWaiters: PositiveSafeIntegerSchema2,
+  advances: NonNegativeSafeIntegerSchema,
+  refusedAdvances: NonNegativeSafeIntegerSchema,
+  waits: NonNegativeSafeIntegerSchema,
+  changed: NonNegativeSafeIntegerSchema,
+  timedOut: NonNegativeSafeIntegerSchema,
+  aborted: NonNegativeSafeIntegerSchema,
+  closedWaits: NonNegativeSafeIntegerSchema,
+  capacityRefusals: NonNegativeSafeIntegerSchema,
+  clockFailures: NonNegativeSafeIntegerSchema
+}).strict().readonly();
+var systemClock = {
+  schedule(callback, delayMs) {
+    const timer = setTimeout(callback, delayMs);
+    return { cancel: () => clearTimeout(timer) };
+  }
+};
+function createRevisionSignal(config) {
+  const maxWaiters = PositiveSafeIntegerSchema2.parse(config.maxWaiters);
+  const clock = config.clock ?? systemClock;
+  const waiters = new Set;
+  let state = "open";
+  let revision = 0;
+  let advances = 0;
+  let refusedAdvances = 0;
+  let waits = 0;
+  let changed = 0;
+  let timedOut = 0;
+  let aborted = 0;
+  let closedWaits = 0;
+  let capacityRefusals = 0;
+  let clockFailures = 0;
+  const result = (outcome) => {
+    if (outcome === "changed")
+      changed += 1;
+    else if (outcome === "timed-out")
+      timedOut += 1;
+    else if (outcome === "aborted")
+      aborted += 1;
+    else if (outcome === "closed")
+      closedWaits += 1;
+    else
+      capacityRefusals += 1;
+    return RevisionSignalWaitResultSchema.parse({ outcome, revision });
+  };
+  const snapshot = () => RevisionSignalSnapshotSchema.parse({
+    state,
+    revision,
+    pending: waiters.size,
+    maxWaiters,
+    advances,
+    refusedAdvances,
+    waits,
+    changed,
+    timedOut,
+    aborted,
+    closedWaits,
+    capacityRefusals,
+    clockFailures
+  });
+  return {
+    advance() {
+      if (state === "closed") {
+        refusedAdvances += 1;
+        return RevisionSignalAdvanceResultSchema.parse({ outcome: "closed", revision });
+      }
+      if (revision === Number.MAX_SAFE_INTEGER) {
+        throw new RangeError("Revision signal exhausted the safe-integer revision range");
+      }
+      revision += 1;
+      advances += 1;
+      for (const waiter of [...waiters])
+        waiter.settle("changed");
+      return RevisionSignalAdvanceResultSchema.parse({ outcome: "advanced", revision });
+    },
+    wait(after, options = {}) {
+      const parsedAfter = NonNegativeSafeIntegerSchema.parse(after);
+      const timeoutMs = options.timeoutMs === undefined ? undefined : TimerDelaySchema.parse(options.timeoutMs);
+      if (parsedAfter > revision) {
+        throw new RangeError(`Revision signal cannot wait after future revision ${parsedAfter}; current revision is ${revision}`);
+      }
+      waits += 1;
+      if (state === "closed")
+        return Promise.resolve(result("closed"));
+      if (parsedAfter < revision)
+        return Promise.resolve(result("changed"));
+      if (options.signal?.aborted)
+        return Promise.resolve(result("aborted"));
+      if (waiters.size >= maxWaiters)
+        return Promise.resolve(result("capacity"));
+      return new Promise((resolve) => {
+        let settled = false;
+        let timer;
+        const waiter = {
+          settle(outcome) {
+            if (settled)
+              return;
+            settled = true;
+            timer?.cancel();
+            options.signal?.removeEventListener("abort", onAbort);
+            waiters.delete(waiter);
+            resolve(result(outcome));
+          }
+        };
+        function onAbort() {
+          waiter.settle("aborted");
+        }
+        waiters.add(waiter);
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        if (timeoutMs !== undefined) {
+          try {
+            const scheduled = clock.schedule(() => waiter.settle("timed-out"), timeoutMs);
+            timer = scheduled;
+            if (settled)
+              scheduled.cancel();
+          } catch (error) {
+            settled = true;
+            options.signal?.removeEventListener("abort", onAbort);
+            waiters.delete(waiter);
+            clockFailures += 1;
+            throw error;
+          }
+        }
+      });
+    },
+    close() {
+      if (state === "closed")
+        return snapshot();
+      state = "closed";
+      for (const waiter of [...waiters])
+        waiter.settle("closed");
+      return snapshot();
+    },
+    getSnapshot: snapshot
+  };
+}
 // src/application/server-resource.ts
 function managedServerResource(config) {
   let shutdownPromise;
@@ -1092,6 +1253,7 @@ export {
   defineManagedResource,
   defineKeyspace,
   createWatchHub,
+  createRevisionSignal,
   createManagedSchedule,
   createDecisionPipeline,
   createCreditWindow,
@@ -1104,6 +1266,11 @@ export {
   createApplication,
   createActivityProjection,
   applicationLifecycleEvent,
+  RevisionSignalWaitResultSchema,
+  RevisionSignalWaitOutcomeSchema,
+  RevisionSignalStateSchema,
+  RevisionSignalSnapshotSchema,
+  RevisionSignalAdvanceResultSchema,
   PolicyDecisionSchema,
   ManagedScheduleStatusSchema,
   ManagedScheduleOverlapSchema,

package/llms-full.txt

@@ -5153,7 +5153,7 @@ description: Compose process-local resources, schedules, readiness, drain and op
 type: architecture
 status: active
 created: 2026-08-23
-updated: 2026-08-23
+updated: 2026-09-04 14:11 +07:00
 ---
 
 # Managed application kernel
@@ -5663,6 +5663,40 @@ underlying Promise actually settles. `drain()` therefore reports real work;
 `force()` closes admission and reports remaining work without claiming to have
 terminated it. → ADR 0118.
 
+### Bounded revision wake-up
+
+Use `createRevisionSignal` when several operations need to wait for the same
+process-local fact to change, but the change itself is not a queue item:
+
+```ts
+const connectionsChanged = createRevisionSignal({ maxWaiters: 256 })
+
+const observed = connectionsChanged.getSnapshot().revision
+const result = await connectionsChanged.wait(observed, {
+  signal: request.signal,
+  timeoutMs: 10_000,
+})
+
+// After changing the canonical connection state:
+connectionsChanged.advance()
+```
+
+`wait(after)` resolves immediately when the signal is already newer than
+`after`; this closes the race between reading a snapshot and registering the
+wait. Waiting on the current revision parks one operation, up to `maxWaiters`.
+Every terminal result carries the revision it observed and distinguishes
+`changed`, `timed-out`, `aborted`, `closed` and `capacity`. A future `after` is
+a caller error rather than a revision the signal could honestly promise to
+reach.
+
+One advance wakes every older waiter. It is not consumed by the first reader,
+does not retain event payloads and has no replay history. A bounded channel is
+for delivering items to one reader; a credit window grants a finite resource.
+
+The signal is already its whole lifecycle handle. Call its idempotent `close()`
+from the `close` phase of the managed resource that owns the changing fact;
+there is no second managed-resource wrapper around the same state. → ADR 0163.
+
 ### Bounded delivery and byte credit
 
 `createBoundedChannel` is for one asynchronous reader when an event bus is not a
@@ -13775,6 +13809,19 @@ cutovers are covered by the executable
 | `BoundedAdmissionRefusalError` | class | `run()` refusal with reason and optional `retryAfterMs` |
 | `BoundedOperationWaitError` | class | caller wait ended as `cancelled` or `timed-out`; underlying capacity remains leased until work settles |
 
+### Revision wake-up
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `createRevisionSignal` | function | finite broadcast wait for the next monotonic process-local revision |
+| `RevisionSignal` / `RevisionSignalConfig` / `RevisionSignalClock` / `RevisionSignalTimer` | _type_ | signal handle, waiter bound and replaceable timer boundary |
+| `RevisionSignalWaitOptions` | _type_ | optional caller `signal` and positive `timeoutMs`; absent options wait until advance or close |
+| `RevisionSignalWaitOutcomeSchema` / `RevisionSignalWaitOutcome` | schema / _type_ | `changed \| timed-out \| aborted \| closed \| capacity` |
+| `RevisionSignalWaitResultSchema` / `RevisionSignalWaitResult` | schema / _type_ | terminal wait outcome with the revision observed at settlement |
+| `RevisionSignalAdvanceResultSchema` / `RevisionSignalAdvanceResult` | schema / _type_ | successful `advanced` or post-close `closed`, with the resulting revision |
+| `RevisionSignalStateSchema` / `RevisionSignalState` | schema / _type_ | `open \| closed` lifecycle |
+| `RevisionSignalSnapshotSchema` / `RevisionSignalSnapshot` | schema / _type_ | current revision, finite pending count and lifetime outcome counters |
+
 ### Bounded delivery
 
 | Export | Kind | Summary |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.80.0",
+  "version": "0.80.1",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -170,7 +170,7 @@
     "check": "bun x tsc --noEmit",
     "build:js": "bun run build:entrypoints && bun scripts/preserve-webpack-ignore.mjs",
     "build:types": "bun x tsc -p tsconfig.build.json --emitDeclarationOnly && bun scripts/rewrite-declaration-specifiers.mjs",
-    "build": "rm -rf dist && bun run build:js && bun run build:types && bun scripts/check-browser-clean.mjs && bun scripts/check-browser-executes.mjs && bun scripts/check-env-live.mjs && bun scripts/check-public-types.mjs",
+    "build": "rm -rf dist && bun run build:js && bun run build:types && bun scripts/check-browser-clean.mjs && bun scripts/check-browser-executes.mjs && bun scripts/check-env-live.mjs && bun scripts/check-public-types.mjs && bun scripts/check-declarations-strict.mjs",
     "dev": "bun run build:entrypoints -- --watch",
     "prepack": "cp ../../README.md ./README.md && bun ../../scripts/gen-llms.ts && bun run build",
     "test": "bun test",