stitchkit 0.70.6 → 0.72.0

package/dist/{index-w9m1wznn.js → index-nemjkxjp.js}

@@ -59,6 +59,123 @@ function parseQueryParams(url) {
   }
   return query;
 }
+var IPV4_RESERVED = [
+  ["0.0.0.0", 8],
+  ["10.0.0.0", 8],
+  ["100.64.0.0", 10],
+  ["127.0.0.0", 8],
+  ["169.254.0.0", 16],
+  ["172.16.0.0", 12],
+  ["192.0.0.0", 24],
+  ["192.0.2.0", 24],
+  ["192.88.99.0", 24],
+  ["192.168.0.0", 16],
+  ["198.18.0.0", 15],
+  ["198.51.100.0", 24],
+  ["203.0.113.0", 24],
+  ["224.0.0.0", 4],
+  ["240.0.0.0", 4]
+];
+function parseIpv4(value) {
+  const parts = value.split(".");
+  if (parts.length !== 4)
+    return;
+  let result = 0;
+  for (const part of parts) {
+    if (!/^(0|[1-9]\d{0,2})$/.test(part))
+      return;
+    const octet = Number(part);
+    if (octet > 255)
+      return;
+    result = result * 256 + octet;
+  }
+  return result;
+}
+function parseIpv6(value) {
+  const address = value.split("%")[0] ?? "";
+  if (!address.includes(":"))
+    return;
+  const halves = address.split("::");
+  if (halves.length > 2)
+    return;
+  const groups = [];
+  const tail = [];
+  const push = (into, text) => {
+    if (text === "")
+      return true;
+    for (const piece of text.split(":")) {
+      if (piece.includes(".")) {
+        const v4 = parseIpv4(piece);
+        if (v4 === undefined)
+          return false;
+        into.push(v4 >>> 16 & 65535, v4 & 65535);
+        continue;
+      }
+      if (!/^[0-9a-fA-F]{1,4}$/.test(piece))
+        return false;
+      into.push(Number.parseInt(piece, 16));
+    }
+    return true;
+  };
+  if (!push(groups, halves[0] ?? ""))
+    return;
+  if (halves.length === 2 && !push(tail, halves[1] ?? ""))
+    return;
+  const missing = 8 - groups.length - tail.length;
+  if (halves.length === 2 ? missing < 0 : missing !== 0)
+    return;
+  const words = [
+    ...groups,
+    ...Array(halves.length === 2 ? missing : 0).fill(0),
+    ...tail
+  ];
+  if (words.length !== 8)
+    return;
+  const bytes = new Uint8Array(16);
+  words.forEach((word, index) => {
+    bytes[index * 2] = word >>> 8 & 255;
+    bytes[index * 2 + 1] = word & 255;
+  });
+  return bytes;
+}
+function hasPrefix(bytes, prefix, bits) {
+  for (let index = 0;index < bits; index += 1) {
+    const byte = bytes[index >> 3] ?? 0;
+    const against = prefix[index >> 3] ?? 0;
+    const mask = 128 >> index % 8;
+    if ((byte & mask) !== (against & mask))
+      return false;
+  }
+  return true;
+}
+function isPublicIp(value) {
+  const address = value.trim();
+  if (!address)
+    return false;
+  const v4 = parseIpv4(address);
+  if (v4 !== undefined) {
+    return !IPV4_RESERVED.some(([network, bits]) => {
+      const base = parseIpv4(network);
+      if (base === undefined)
+        return false;
+      const mask = bits === 0 ? 0 : 4294967295 << 32 - bits >>> 0;
+      return (v4 & mask) >>> 0 === (base & mask) >>> 0;
+    });
+  }
+  const bytes = parseIpv6(address);
+  if (!bytes)
+    return false;
+  if (hasPrefix(bytes, [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 255, 255], 96)) {
+    return isPublicIp(Array.from(bytes.slice(12)).join("."));
+  }
+  if (!hasPrefix(bytes, [32], 3))
+    return false;
+  if (hasPrefix(bytes, [32, 1, 0, 0], 23))
+    return false;
+  if (hasPrefix(bytes, [32, 1, 13, 184], 32))
+    return false;
+  return true;
+}
 
 // src/observability/context.ts
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -114,4 +231,4 @@ function wrapInRequestContext(handler, options = {}) {
   };
 }
 
-export { generateTraceId, resolveTraceId, resolveSocketIp, extractIp, getClientInfo, parseQueryParams, runWithRequestContext, getRequestContext, getTraceId, getUserId, setRequestUser, setRequestEndpoint, setRequestDimensions, setRequestError, wrapInRequestContext };
+export { generateTraceId, resolveTraceId, resolveSocketIp, extractIp, getClientInfo, parseQueryParams, isPublicIp, runWithRequestContext, getRequestContext, getTraceId, getUserId, setRequestUser, setRequestEndpoint, setRequestDimensions, setRequestError, wrapInRequestContext };

package/dist/{index-tnazr5tc.js → index-pz7ytdga.js}

@@ -1,14 +1,14 @@
 import {
   collectToolSurface
-} from "./index-hxtm2xr2.js";
+} from "./index-k2zczx1g.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-ejv31h14.js";
+} from "./index-7qy2ex0m.js";
 import {
   coerceJsonArgs,
   toolResultFromError
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   isWithinDir
 } from "./index-sbdmyz75.js";

package/dist/{index-1z5xxfst.js → index-rqpdar1e.js}

@@ -8,7 +8,16 @@ import {
   read as readDescriptor,
   write as writeDescriptor
 } from "node:fs";
-import { lstat, open, readdir, realpath, rename, unlink, writeFile } from "node:fs/promises";
+import {
+  lstat,
+  mkdir,
+  open,
+  readdir,
+  realpath,
+  rename,
+  unlink,
+  writeFile
+} from "node:fs/promises";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -41,6 +50,7 @@ function loadDarwinBinding() {
     "openDirectoryAt",
     "openFileAt",
     "createFileAt",
+    "createDirectoryAt",
     "statAt",
     "listAt",
     "renameAt",
@@ -120,9 +130,10 @@ async function openFileAt(directory, name) {
   }
   return open(path.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_NOFOLLOW);
 }
-function entryMetadata(mode) {
+function entryMetadata(mode, size) {
   return {
     mode,
+    ...size !== undefined && { size },
     isDirectory: () => modeIs(mode, FILE_TYPE_DIRECTORY),
     isFile: () => modeIs(mode, FILE_TYPE_REGULAR),
     isSymbolicLink: () => modeIs(mode, FILE_TYPE_SYMLINK)
@@ -131,7 +142,7 @@ function entryMetadata(mode) {
 async function statAt(directory, name) {
   if (process.platform === "darwin") {
     const metadata = loadDarwinBinding().statAt(directory.fd, name);
-    return metadata ? entryMetadata(metadata.mode) : null;
+    return metadata ? entryMetadata(metadata.mode, metadata.size) : null;
   }
   return lstat(path.join(descriptorPath(directory), name)).catch((error) => {
     if (error.code === "ENOENT")
@@ -145,7 +156,91 @@ async function listAt(directory) {
   }
   return readdir(descriptorPath(directory), { withFileTypes: true });
 }
-async function openContainedParent(root, relative) {
+async function listContainedDirectory(root, relative, maxEntries) {
+  let current = await openPinnedDirectory(root);
+  try {
+    if (relative !== ".") {
+      for (const segment of safeSegments(relative)) {
+        const next = await openDirectoryAt(current, segment);
+        const metadata = await next.stat();
+        if (!metadata.isDirectory()) {
+          await next.close();
+          throw new Error("Contained ancestor is not a directory");
+        }
+        await current.close();
+        current = next;
+      }
+    }
+    const raw = [...await listAt(current)];
+    raw.sort((left, right) => left.name.localeCompare(right.name));
+    const entries = [];
+    for (const entry of raw.slice(0, maxEntries)) {
+      const kind = entry.isDirectory() ? "directory" : entry.isSymbolicLink() ? "symlink" : entry.isFile() ? "file" : "other";
+      if (kind !== "file") {
+        entries.push({ name: entry.name, kind });
+        continue;
+      }
+      const metadata = await statAt(current, entry.name);
+      entries.push({
+        name: entry.name,
+        kind,
+        ...metadata && { bytes: metadata.size }
+      });
+    }
+    entries.sort((left, right) => {
+      if (left.kind === right.kind)
+        return left.name.localeCompare(right.name);
+      return left.kind === "directory" ? -1 : right.kind === "directory" ? 1 : 0;
+    });
+    return { entries, truncated: raw.length > maxEntries };
+  } finally {
+    await current.close();
+  }
+}
+async function createDirectoryAt(directory, name) {
+  if (process.platform === "darwin") {
+    return loadDarwinBinding().createDirectoryAt(directory.fd, name, 511);
+  }
+  try {
+    await mkdir(path.join(descriptorPath(directory), name));
+    return true;
+  } catch (error) {
+    if (error.code === "EEXIST")
+      return false;
+    throw error;
+  }
+}
+async function missingContainedDirectories(root, relative) {
+  const segments = safeSegments(relative);
+  segments.pop();
+  const missing = [];
+  let current = await openPinnedDirectory(root);
+  try {
+    let walked = [];
+    for (const segment of segments) {
+      walked = [...walked, segment];
+      if (missing.length > 0) {
+        missing.push(walked.join(path.sep));
+        continue;
+      }
+      const next = await openDirectoryAt(current, segment).catch((error) => {
+        if (error.code === "ENOENT")
+          return null;
+        throw error;
+      });
+      if (!next) {
+        missing.push(walked.join(path.sep));
+        continue;
+      }
+      await current.close();
+      current = next;
+    }
+    return missing;
+  } finally {
+    await current.close();
+  }
+}
+async function openContainedParent(root, relative, options = {}) {
   const segments = safeSegments(relative);
   const basename = segments.pop();
   if (!basename)
@@ -153,6 +248,8 @@ async function openContainedParent(root, relative) {
   let current = await openPinnedDirectory(root);
   try {
     for (const segment of segments) {
+      if (options.create)
+        await createDirectoryAt(current, segment);
       const next = await openDirectoryAt(current, segment);
       const metadata = await next.stat();
       if (!metadata.isDirectory()) {
@@ -394,4 +491,4 @@ async function scanContainedFiles(input) {
   return { files, truncated, skippedDirectories, skippedSymlinks };
 }
 
-export { openContainedParent, openContainedFile, assertContainedFileCurrent, assertContainedParentCurrent, writeContainedFile, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle, walkContainedFiles, scanContainedFiles };
+export { listContainedDirectory, missingContainedDirectories, openContainedParent, openContainedFile, assertContainedFileCurrent, assertContainedParentCurrent, writeContainedFile, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle, walkContainedFiles, scanContainedFiles };

package/dist/{index-qm87g51s.js → index-s4c8wy8m.js}

@@ -1,7 +1,7 @@
 import {
   getRequestContext,
   runWithRequestContext
-} from "./index-w9m1wznn.js";
+} from "./index-nemjkxjp.js";
 import {
   objectShapeKeys
 } from "./index-22by16v6.js";

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { type ClientConfig, type ClientContract, type ClientFetch, type ClientRegistryValue, type ContractClientConfig, contractEndpointMatchers, createClient, createClients, createScopedClients, createScopedUrlBuilders, createUrlBuilder, createUrlBuilders, type PathPrefixArgs, type RegistryScope, type ScopeClientConfigs, type ScopedClientRegistry, type ScopedUrlBuilderRegistry, type UrlBuilderConfig, } from './browser/client.js';
 export { ApiError, type ApiEvent, type ApiEventListener, type ConfiguredHttpClient, createHttpClient, type HeaderProvider, type HttpClient, type HttpClientConfig, type RequestOptions, type UnauthorizedMatcher, } from './browser/http.js';
 export { createLiveStateController, type LiveStateController, type LiveStateControllerConfig, type LiveStateControllerError, type LiveStateControllerSnapshot, type LiveStateControllerStatus, LiveStateControllerStatusSchema, type LiveStateEventDecision, type LiveStatePhase, LiveStatePhaseSchema, type LiveStateSource, type LiveStateSourceOpenInput, type LiveStateSourceOpenResult, type LiveStateStopReason, LiveStateStopReasonSchema, type LiveStateSubscriberError, } from './browser/live-state.js';
+export { type Backoff, type BackoffPolicy, BackoffPolicySchema, createBackoff, type ResumableAttempt, type ResumableIteratorConfig, resumableIterator, } from './browser/resumable.js';
 export type { BindRealtimeClientOptions, BoundRealtimeClient, RealtimeClient, RealtimeClientOptions, RealtimeClientTransport, SocketEventMap, SocketIOClient, SocketIOClientConfig, SocketIOClientPeerLoaders, } from './browser/socket-io.js';
 export { bindRealtimeClient, createRealtimeClient, createSocketIOClient, } from './browser/socket-io.js';
 export { type ParseNDJSONOptions, type ParseSSEOptions, parseNDJSON, parseSSE, } from './browser/stream.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,WAAW,EACX,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,mBAAmB,EACnB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,WAAW,EACX,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1292,7 +1292,8 @@ var CreditWindowSnapshotSchema = z2.object({
   leasedBytes: z2.number().int().nonnegative(),
   acquired: z2.number().int().nonnegative(),
   refused: z2.number().int().nonnegative(),
-  replenishedBytes: z2.number().int().nonnegative()
+  replenishedBytes: z2.number().int().nonnegative(),
+  waiting: z2.number().int().nonnegative()
 }).strict().readonly();
 
 // src/browser/live-state.ts
@@ -1682,6 +1683,91 @@ function createLiveStateController(config) {
     close
   };
 }
+// src/browser/resumable.ts
+import { z as z4 } from "zod";
+var PositiveSafeIntegerSchema3 = z4.number().int().positive().safe();
+var BackoffPolicySchema = z4.object({
+  minDelayMs: PositiveSafeIntegerSchema3,
+  maxDelayMs: PositiveSafeIntegerSchema3,
+  jitter: z4.number().min(0).max(1)
+}).strict().readonly().refine((policy) => policy.maxDelayMs >= policy.minDelayMs, {
+  message: "maxDelayMs must be at least minDelayMs"
+});
+function createBackoff(policy, random = Math.random) {
+  const { minDelayMs, maxDelayMs, jitter } = BackoffPolicySchema.parse(policy);
+  let attempt = 0;
+  return {
+    next() {
+      const exponential = Math.min(maxDelayMs, minDelayMs * 2 ** attempt);
+      attempt += 1;
+      const spread = exponential * jitter * random();
+      return Math.max(1, Math.round(exponential - spread));
+    },
+    reset() {
+      attempt = 0;
+    }
+  };
+}
+var DEFAULT_RETRY = { minDelayMs: 100, maxDelayMs: 30000, jitter: 0.5 };
+
+class ResumableAbortError extends Error {
+  constructor() {
+    super("Resumable iterator was aborted");
+    this.name = "ResumableAbortError";
+  }
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(new ResumableAbortError);
+    }
+    if (signal?.aborted) {
+      clearTimeout(timer);
+      reject(new ResumableAbortError);
+      return;
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function* resumableIterator(config) {
+  const backoff = createBackoff(config.retry ?? DEFAULT_RETRY, config.random);
+  let cursor;
+  let attempt = 0;
+  for (;; ) {
+    if (config.signal?.aborted)
+      return;
+    try {
+      const source = await config.open(cursor);
+      for await (const item of source) {
+        if (config.signal?.aborted)
+          return;
+        attempt = 0;
+        backoff.reset();
+        cursor = config.advance(item, cursor);
+        yield item;
+        if (config.isTerminal?.(item))
+          return;
+      }
+      throw new Error("Resumable source ended without a terminal item");
+    } catch (error) {
+      if (config.signal?.aborted || error instanceof ResumableAbortError)
+        return;
+      attempt += 1;
+      const delayMs = backoff.next();
+      config.onAttempt?.({ number: attempt, delayMs, error });
+      try {
+        await sleep(delayMs, config.signal);
+      } catch {
+        return;
+      }
+    }
+  }
+}
 // src/internal/optional-peer.ts
 function isModuleNotFound(error) {
   if (typeof error !== "object" || error === null)
@@ -1692,19 +1778,19 @@ function isModuleNotFound(error) {
 }
 
 // src/realtime/request.ts
-import { z as z4 } from "zod";
-var RealtimeRequestPhaseSchema = z4.enum([
+import { z as z5 } from "zod";
+var RealtimeRequestPhaseSchema = z5.enum([
   "engine-handoff",
   "engine-ack-received",
   "settled",
   "timeout",
   "disconnected"
 ]);
-var RealtimeRequestPhaseEventSchema = z4.object({
-  requestId: z4.string().min(1),
-  event: z4.string().min(1),
+var RealtimeRequestPhaseEventSchema = z5.object({
+  requestId: z5.string().min(1),
+  event: z5.string().min(1),
   phase: RealtimeRequestPhaseSchema,
-  elapsedMs: z4.number().finite().nonnegative()
+  elapsedMs: z5.number().finite().nonnegative()
 }).strict();
 
 class RealtimeRequestTimeoutError extends Error {
@@ -1794,9 +1880,9 @@ function parseIssues(value) {
 }
 
 // src/realtime/rejection.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function realtimeContractViolation(options) {
-  const issues = options.cause instanceof z5.ZodError ? zodIssues(options.cause) : undefined;
+  const issues = options.cause instanceof z6.ZodError ? zodIssues(options.cause) : undefined;
   const reason = options.reason.replaceAll("-", " ");
   const error = new AppError("REALTIME_CONTRACT_VIOLATION", `Realtime event "${options.event}" (${options.direction}, ${options.phase}): ${reason}`, 500, {
     event: options.event,
@@ -2532,27 +2618,28 @@ function createSocketIOClientInternal(config, onRequestPhase) {
   };
 }
 // src/realtime/contract.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function defineRealtimeContract(contract) {
   return contract;
 }
-var RealtimeRejectDirectionSchema = z6.enum([
+var RealtimeRejectDirectionSchema = z7.enum([
   "client-inbound",
   "client-outbound",
   "server-inbound",
   "server-outbound"
 ]);
-var RealtimeRejectPhaseSchema = z6.enum(["arguments", "acknowledgement"]);
-var RealtimeRejectReasonSchema = z6.enum([
+var RealtimeRejectPhaseSchema = z7.enum(["arguments", "acknowledgement"]);
+var RealtimeRejectReasonSchema = z7.enum([
   "unknown-event",
   "invalid-arguments",
   "invalid-acknowledgement-value",
   "missing-acknowledgement",
   "rejected-by-peer"
 ]);
-var RealtimeRejectFaultSchema = z6.enum(["peer", "local"]);
+var RealtimeRejectFaultSchema = z7.enum(["peer", "local"]);
 export {
   unauthorized,
+  resumableIterator,
   rateLimited,
   parseTraceparent,
   parseSSE,
@@ -2580,6 +2667,7 @@ export {
   createContractFactory,
   createClients,
   createClient,
+  createBackoff,
   contractEndpointMatchers,
   conflict,
   childSpan,
@@ -2602,6 +2690,7 @@ export {
   LiveStateControllerStatusSchema,
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   ContractStreamFrameSchema,
+  BackoffPolicySchema,
   AppError,
   ApiError,
   ALL_TRANSPORTS

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-cx84zg25.js";
+} from "./index-118v0z41.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -15,7 +15,7 @@ import {
   implement,
   implementRegistry
 } from "./index-vbf2p6me.js";
-import"./index-w9m1wznn.js";
+import"./index-nemjkxjp.js";
 import"./index-7b188kmz.js";
 import {
   ShutdownOptionsSchema,

package/dist/observability/index.js

@@ -21,7 +21,7 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-w9m1wznn.js";
+} from "../index-nemjkxjp.js";
 import {
   childSpan,
   createTraceContext,

package/dist/primitives/audit.d.ts

@@ -0,0 +1,52 @@
+import { type ZodType, z } from 'zod';
+import type { ContractDef } from '../contract/index.js';
+import { type DomainEventActor, type DomainEventSubject } from './event.js';
+export interface AuditRecordPolicy<TChange extends ZodType = ZodType> {
+    readonly mode: 'record';
+    readonly change: TChange;
+}
+export interface AuditOmitPolicy {
+    readonly mode: 'omit';
+    readonly reason: string;
+}
+export type AuditPolicy = AuditRecordPolicy | AuditOmitPolicy;
+export declare const AuditChangeSchema: z.ZodObject<{
+    operation: z.ZodString;
+    change: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const AuditRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    occurredAt: z.ZodISODateTime;
+    actor: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodString;
+    }, z.core.$strip>>;
+    subject: z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    payload: z.ZodObject<{
+        operation: z.ZodString;
+        change: z.ZodUnknown;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AuditRecord = z.infer<typeof AuditRecordSchema>;
+export declare const audit: Readonly<{
+    record<TChange extends ZodType>(change: TChange): AuditRecordPolicy<TChange>;
+    omit(reason: string): AuditOmitPolicy;
+}>;
+/** Refuse a contract whose operation author did not make an explicit audit decision. */
+export declare function assertAuditDeclared(contract: ContractDef): void;
+export interface CreateAuditRecordInput<TChange> {
+    readonly id: string;
+    readonly occurredAt: string;
+    readonly operation: string;
+    readonly actor: DomainEventActor;
+    readonly subject: DomainEventSubject;
+    readonly policy: AuditRecordPolicy<ZodType<TChange>>;
+    readonly change: TChange;
+}
+/** Validate the declared change and return the same event value journals and delivery consume. */
+export declare function createAuditRecord<TChange>(input: CreateAuditRecordInput<TChange>): AuditRecord;
+//# sourceMappingURL=audit.d.ts.map

package/dist/primitives/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/primitives/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAC5D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,OAAO,GAAG,OAAO;IAClE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;iBAA6C,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,KAAK;WACT,OAAO,SAAS,OAAO,UAAU,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC;iBAG/D,MAAM,GAAG,eAAe;EAIrC,CAAC;AAuBH,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAQ/D;AAED,MAAM,WAAW,sBAAsB,CAAC,OAAO;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,OAAO,EACvC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACrC,WAAW,CAUb"}

package/dist/primitives/deadline.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const DeadlineResultSchema: z.ZodObject<{
+    dueAt: z.ZodISODateTime;
+    remainingDays: z.ZodNumber;
+    overdueDays: z.ZodNumber;
+    category: z.ZodString;
+}, z.core.$strip>;
+export type DeadlineResult = z.infer<typeof DeadlineResultSchema>;
+export declare function defineDeadlinePolicy<const TOnTrack extends string, const TWarning extends string, const TOverdue extends string>(config: {
+    readonly boundary: 'elapsed-day' | 'calendar-day';
+    readonly timeZone: string;
+    readonly warningDays: number;
+    readonly categories: {
+        readonly onTrack: TOnTrack;
+        readonly warning: TWarning;
+        readonly overdue: TOverdue;
+    };
+}): Readonly<{
+    definition: {
+        readonly boundary: 'elapsed-day' | 'calendar-day';
+        readonly timeZone: string;
+        readonly warningDays: number;
+        readonly categories: {
+            readonly onTrack: TOnTrack;
+            readonly warning: TWarning;
+            readonly overdue: TOverdue;
+        };
+    };
+    evaluate(input: {
+        readonly anchorAt: Date;
+        readonly durationDays: number;
+        readonly now: Date;
+    }): DeadlineResult;
+    queryBoundary(now: Date): Readonly<{
+        overdueBefore: string;
+        warningBefore: string;
+    }>;
+}>;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/primitives/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/primitives/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA8ElE,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,QAAQ,SAAS,MAAM,EAC7B,KAAK,CAAC,QAAQ,SAAS,MAAM,EAC7B,KAAK,CAAC,QAAQ,SAAS,MAAM,EAC7B,MAAM,EAAE;IACR,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC5B,CAAC;CACH;;2BARoB,aAAa,GAAG,cAAc;2BAC9B,MAAM;8BACH,MAAM;6BACP;YACnB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;SAC5B;;oBAYiB;QACd,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;QACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;KACpB,GAAG,cAAc;uBAsBC,IAAI;;;;GAO1B"}

package/dist/primitives/decimal.d.ts

@@ -0,0 +1,10 @@
+export interface DecimalParts {
+    readonly coefficient: bigint;
+    readonly scale: number;
+}
+export declare function parseDecimal(value: string): DecimalParts;
+export declare function normalizeDecimal(parts: DecimalParts): DecimalParts;
+export declare function formatDecimal(parts: DecimalParts): string;
+export declare function addDecimal(left: DecimalParts, right: DecimalParts): DecimalParts;
+export declare function multiplyDecimalRatio(value: DecimalParts, numerator: bigint, denominator: bigint): DecimalParts;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/primitives/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/primitives/decimal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAOxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAQlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAQzD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAKhF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,YAAY,CAYd"}