stitchkit 0.89.0 → 0.90.1

package/dist/observability/index.js

@@ -27,10 +27,10 @@ import {
 import"../index-f9mb610r.js";
 import {
   recordedErrorMessage
-} from "../index-7evdsyez.js";
-import"../index-2bxcmqkb.js";
+} from "../index-2hryh65w.js";
+import"../index-kazec06k.js";
 import"../index-6k1937bx.js";
-import"../index-0w9abg87.js";
+import"../index-scs3f1eg.js";
 import {
   childSpan,
   createTraceContext,
@@ -364,6 +364,131 @@ function createBoundedLogger(options) {
     debug: (message, data) => write("debug", message, data)
   };
 }
+// src/observability/changes.ts
+var READ_METHODS = new Set(["GET", "HEAD", "OPTIONS"]);
+var SECURITY_STATUSES = new Set([401, 403]);
+function auditChanges(event) {
+  if (SECURITY_STATUSES.has(event.statusCode))
+    return true;
+  const verb = event.httpMethod ?? event.method;
+  return !READ_METHODS.has(verb.toUpperCase());
+}
+// src/observability/spool.ts
+import { appendFile, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+function reviveEvent(event) {
+  return { ...event, startedAt: new Date(event.startedAt) };
+}
+function createSpooledSink(config) {
+  const keyOf = config.key ?? ((event) => event.spanId);
+  const compactAfter = config.compactAfter ?? 512;
+  const undelivered = new Map;
+  let delivered = 0;
+  let tail = Promise.resolve();
+  function serialise(work) {
+    const next = tail.then(work, work);
+    tail = next.catch(() => {
+      return;
+    });
+    return next;
+  }
+  async function append(line, event) {
+    try {
+      await appendFile(config.path, `${JSON.stringify(line)}
+`, "utf8");
+    } catch (error) {
+      if (isMissing(error)) {
+        await mkdir(dirname(config.path), { recursive: true });
+        await appendFile(config.path, `${JSON.stringify(line)}
+`, "utf8");
+        return;
+      }
+      config.onSpoolError?.({ error, ...event !== undefined && { event } });
+    }
+  }
+  async function compact() {
+    const temporary = `${config.path}.compacting`;
+    const body = [...undelivered.entries()].map(([key, event]) => `${JSON.stringify({ k: key, e: event })}
+`).join("");
+    try {
+      await writeFile(temporary, body, "utf8");
+      await rename(temporary, config.path);
+      delivered = 0;
+    } catch (error) {
+      config.onSpoolError?.({ error });
+    }
+  }
+  return {
+    async write(event) {
+      const key = keyOf(event);
+      await serialise(() => append({ k: key, e: event }, event));
+      undelivered.set(key, event);
+      await config.write(event);
+      undelivered.delete(key);
+      delivered += 1;
+      await serialise(async () => {
+        await append({ a: key });
+        if (delivered >= compactAfter)
+          await compact();
+      });
+    },
+    async recover() {
+      let body;
+      try {
+        body = await readFile(config.path, "utf8");
+      } catch (error) {
+        if (!isMissing(error))
+          config.onSpoolError?.({ error });
+        return { replayed: 0, failed: 0 };
+      }
+      const pending = new Map;
+      for (const line of body.split(`
+`)) {
+        if (line.length === 0)
+          continue;
+        let parsed;
+        try {
+          parsed = JSON.parse(line);
+        } catch (error) {
+          config.onSpoolError?.({ error });
+          continue;
+        }
+        if (parsed.a !== undefined) {
+          pending.delete(parsed.a);
+          continue;
+        }
+        if (parsed.k !== undefined && parsed.e !== undefined) {
+          pending.set(parsed.k, reviveEvent(parsed.e));
+        }
+      }
+      const replayed = pending.size;
+      let failed = 0;
+      for (const [key, event] of pending) {
+        try {
+          await config.write(event);
+          pending.delete(key);
+        } catch (error) {
+          failed += 1;
+          config.onSpoolError?.({ error, event });
+        }
+      }
+      undelivered.clear();
+      for (const [key, event] of pending)
+        undelivered.set(key, event);
+      delivered = 0;
+      await serialise(compact);
+      return { replayed, failed };
+    },
+    pending: () => undelivered.size
+  };
+}
+function code(error) {
+  if (typeof error !== "object" || error === null)
+    return;
+  const value = Reflect.get(error, "code");
+  return typeof value === "string" ? value : undefined;
+}
+var isMissing = (error) => code(error) === "ENOENT";
 export {
   wrapInRequestContext,
   truncatePreview,
@@ -383,10 +508,12 @@ export {
   getRequestContext,
   formatTraceparent,
   createTraceContext,
+  createSpooledSink,
   createObservability,
   createDimensionsProjector,
   createBoundedLogger,
   childSpan,
+  auditChanges,
   ObservabilityStatusSchema,
   ObservabilitySinkStatusSchema,
   ObservabilityDrainReportSchema,

package/dist/observability/spool.d.ts

@@ -0,0 +1,53 @@
+import type { RequestEvent } from './event.js';
+export interface SpooledSinkConfig {
+    /** The real sink — normally the project's audit-table write. */
+    write: (event: RequestEvent) => void | Promise<void>;
+    /**
+     * The spool file. Created with its directory if missing.
+     *
+     * One process, one path: see the module header.
+     */
+    path: string;
+    /**
+     * The identity a replayed record is recognised by. Default: `event.spanId`,
+     * which is unique per call by construction.
+     *
+     * Whatever it returns is what the store must be idempotent on.
+     */
+    key?: (event: RequestEvent) => string;
+    /**
+     * Delivered records tolerated in the file before it is rewritten without
+     * them. Default 512. The rewrite is atomic — a temporary file and a rename —
+     * so a crash during it leaves either the old file or the new one.
+     */
+    compactAfter?: number;
+    /** Observe a spool-file failure. The event is still offered to the store. */
+    onSpoolError?: (failure: {
+        error: unknown;
+        event?: RequestEvent;
+    }) => void;
+}
+export interface SpoolRecovery {
+    /** Records found undelivered and offered to the store again. */
+    replayed: number;
+    /** Of those, the ones the store refused again. They stay in the file. */
+    failed: number;
+}
+export interface SpooledSink {
+    /** Spool, then deliver. Hand this to `RequestEventSinkConfig.write`. */
+    write(event: RequestEvent): Promise<void>;
+    /**
+     * Replay what a previous process left undelivered, then rewrite the file with
+     * whatever is still undelivered.
+     *
+     * Call it once at startup, **before** the sink is wired, and await it: a
+     * replay racing live writes can only make the file larger and the order
+     * stranger. Safe to call on a path that does not exist — that is the ordinary
+     * first run, and it reports zero rather than failing.
+     */
+    recover(): Promise<SpoolRecovery>;
+    /** Records spooled and not yet marked delivered, in this process. */
+    pending(): number;
+}
+export declare function createSpooledSink(config: SpooledSinkConfig): SpooledSink;
+//# sourceMappingURL=spool.d.ts.map

package/dist/observability/spool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spool.d.ts","sourceRoot":"","sources":["../../src/observability/spool.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC;IACtC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C;;;;;;;;OAQG;IACH,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAClC,qEAAqE;IACrE,OAAO,IAAI,MAAM,CAAC;CACnB;AAqBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAuHxE"}

package/dist/primitives.js

@@ -1,8 +1,8 @@
-import"./index-2bxcmqkb.js";
+import"./index-kazec06k.js";
 import {
   ManagedFileRefSchema
 } from "./index-6k1937bx.js";
-import"./index-0w9abg87.js";
+import"./index-scs3f1eg.js";
 import"./index-kzfs85xp.js";
 import"./index-77fekveh.js";
 

package/dist/remote.js

@@ -1,19 +1,19 @@
 import {
   createClient
-} from "./index-27gm3d6g.js";
-import"./index-qmgs7y68.js";
+} from "./index-6q3zjwaz.js";
+import"./index-1txvygak.js";
 import {
   ApiError
 } from "./index-3xwxfj4z.js";
-import"./index-7evdsyez.js";
+import"./index-2hryh65w.js";
 import {
   mergeMeta,
   resolveRouteParamsSchema
-} from "./index-2bxcmqkb.js";
+} from "./index-kazec06k.js";
 import"./index-6k1937bx.js";
 import {
   AppError
-} from "./index-0w9abg87.js";
+} from "./index-scs3f1eg.js";
 import"./index-zcgf3gqf.js";
 import"./index-kzfs85xp.js";
 import {

package/dist/server/index.js

@@ -13,7 +13,7 @@ import {
   sseRoute,
   streamingRoute,
   webSocketLane
-} from "../index-vchzar7e.js";
+} from "../index-db51n3xr.js";
 import"../index-y91ry9h2.js";
 import {
   withDeadline
@@ -25,13 +25,13 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "../index-3z73fh2c.js";
-import"../index-apn8repm.js";
+import"../index-7gqx71yd.js";
 import"../index-2qzskm8h.js";
 import {
   inputIsQuery,
   parseSSE,
   streamSSE
-} from "../index-qmgs7y68.js";
+} from "../index-1txvygak.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -45,7 +45,7 @@ import {
   signJwt,
   verifyJwt,
   verifyPkce
-} from "../index-90d7h2cr.js";
+} from "../index-bg8ypxzn.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
@@ -59,7 +59,7 @@ import {
   defineMultipartStream,
   implement,
   implementRegistry
-} from "../index-p18f59zy.js";
+} from "../index-z78bjcxj.js";
 import {
   isWithinDir,
   realPathWithinDir
@@ -80,12 +80,12 @@ import {
   formatZodError,
   normalizeError,
   zodIssues
-} from "../index-7evdsyez.js";
+} from "../index-2hryh65w.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   joinRoutePath,
   parseTrailingWildcard
-} from "../index-2bxcmqkb.js";
+} from "../index-kazec06k.js";
 import"../index-6k1937bx.js";
 import {
   AppError,
@@ -98,7 +98,7 @@ import {
   notFound,
   rateLimited,
   unauthorized
-} from "../index-0w9abg87.js";
+} from "../index-scs3f1eg.js";
 import"../index-zcgf3gqf.js";
 import"../index-kzfs85xp.js";
 import {

package/dist/testing.js

@@ -1,6 +1,6 @@
 import {
   createApplication
-} from "./index-t7fkyxcr.js";
+} from "./index-zkcqhxx8.js";
 import"./index-3gye9wzb.js";
 import"./index-2k4yrqkc.js";
 import"./index-3z73fh2c.js";
@@ -28,20 +28,20 @@ import {
 import {
   createClient,
   createClients
-} from "./index-27gm3d6g.js";
+} from "./index-6q3zjwaz.js";
 import {
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
   RealtimeRequestTimeoutError
 } from "./index-2qzskm8h.js";
-import"./index-qmgs7y68.js";
+import"./index-1txvygak.js";
 import"./index-3xwxfj4z.js";
-import"./index-7evdsyez.js";
+import"./index-2hryh65w.js";
 import {
   joinRoutePath
-} from "./index-2bxcmqkb.js";
+} from "./index-kazec06k.js";
 import"./index-6k1937bx.js";
-import"./index-0w9abg87.js";
+import"./index-scs3f1eg.js";
 import"./index-zcgf3gqf.js";
 import"./index-kzfs85xp.js";
 import {

package/dist/tool-invoker.js

@@ -1,14 +1,14 @@
 import {
   createToolInvoker
-} from "./index-mnm4qp0p.js";
-import"./index-8c3a7m4g.js";
-import"./index-zyvby92n.js";
+} from "./index-79hb1wyh.js";
+import"./index-2hrfpw2c.js";
+import"./index-44ht2790.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
-import"./index-7evdsyez.js";
-import"./index-2bxcmqkb.js";
+import"./index-2hryh65w.js";
+import"./index-kazec06k.js";
 import"./index-6k1937bx.js";
-import"./index-0w9abg87.js";
+import"./index-scs3f1eg.js";
 import"./index-zcgf3gqf.js";
 import"./index-7zbps32p.js";
 import"./index-kzfs85xp.js";

package/dist/tools.js

@@ -4,7 +4,7 @@ import {
 import {
   signJwt,
   verifyPkce
-} from "./index-90d7h2cr.js";
+} from "./index-bg8ypxzn.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_PROCESS_SIGNALS,
@@ -13,7 +13,7 @@ import {
   guardSignalCallback,
   mediaTypeEssence,
   reportSignalError
-} from "./index-p18f59zy.js";
+} from "./index-z78bjcxj.js";
 import {
   redact
 } from "./index-xbppf54a.js";
@@ -21,7 +21,7 @@ import {
   buildToolManifest,
   describeToolCatalog,
   mountAgent
-} from "./index-q3ve2d1k.js";
+} from "./index-gbqjt8jz.js";
 import"./index-7rkhw9ec.js";
 import {
   argumentsDigest
@@ -37,7 +37,7 @@ import {
 } from "./index-4fpa9dy2.js";
 import {
   createToolInvoker
-} from "./index-mnm4qp0p.js";
+} from "./index-79hb1wyh.js";
 import {
   WaitTimeoutError,
   createCli,
@@ -46,22 +46,22 @@ import {
   fetchPinnedDocument,
   readCapped,
   runWaitOperation
-} from "./index-7601qfg1.js";
+} from "./index-8dph3pw6.js";
 import"./index-sbdmyz75.js";
 import {
   collectToolSurface
-} from "./index-31jw8fjq.js";
+} from "./index-wb15909q.js";
 import {
   collectTools,
   createToolRunner,
   formatToolError
-} from "./index-8c3a7m4g.js";
+} from "./index-2hrfpw2c.js";
 import {
   ToolExecutionControlError,
   executeToolMethod,
   isToolExecutionControlError,
   toolResultFromError
-} from "./index-zyvby92n.js";
+} from "./index-44ht2790.js";
 import {
   getRequestContext,
   getTraceId,
@@ -70,10 +70,10 @@ import {
 import"./index-f9mb610r.js";
 import {
   normalizeError
-} from "./index-7evdsyez.js";
+} from "./index-2hryh65w.js";
 import {
   defineContract
-} from "./index-2bxcmqkb.js";
+} from "./index-kazec06k.js";
 import {
   ManagedFilePathSchema,
   ManagedFileRefSchema
@@ -81,7 +81,7 @@ import {
 import {
   AppError,
   STITCH_ERROR_STATUS
-} from "./index-0w9abg87.js";
+} from "./index-scs3f1eg.js";
 import {
   resolvePropagationContext
 } from "./index-zcgf3gqf.js";

package/dist/tracking.js

@@ -3,9 +3,9 @@ import {
 } from "./index-3xwxfj4z.js";
 import {
   defineContract
-} from "./index-2bxcmqkb.js";
+} from "./index-kazec06k.js";
 import"./index-6k1937bx.js";
-import"./index-0w9abg87.js";
+import"./index-scs3f1eg.js";
 import"./index-zcgf3gqf.js";
 import"./index-kzfs85xp.js";
 import"./index-77fekveh.js";