stitchkit 0.59.4 → 0.60.1

package/dist/{index-s8w2y7kr.js → index-2cgbdckv.js}

@@ -7,7 +7,7 @@ import {
   defaultSignalSource,
   guardSignalCallback,
   reportSignalError
-} from "./index-41wm56v0.js";
+} from "./index-y91zd0ch.js";
 import {
   ShutdownOptionsSchema
 } from "./index-dk6e56g0.js";
@@ -26,21 +26,24 @@ import {
   setRequestError,
   validateDeclaredOutput,
   zodIssues
-} from "./index-7c0gkyvj.js";
+} from "./index-tvwcrx2d.js";
 import {
-  AppError,
-  badRequest,
   isUnsafeKey,
   safeJsonParse
-} from "./index-ps5pxp3h.js";
+} from "./index-wd8g8z6e.js";
 import {
+  joinRoutePath,
   parseTrailingWildcard,
   resolveTraceContext
-} from "./index-y2rb7dwx.js";
+} from "./index-pzyt11ch.js";
 import {
   isRecord,
   transportResult
 } from "./index-smpbdg6k.js";
+import {
+  AppError,
+  badRequest
+} from "./index-xxye8j3k.js";
 
 // src/server/multipart.ts
 var DEFAULT_MAX_REQUEST_BYTES = 25 * 1024 * 1024;
@@ -827,10 +830,6 @@ function applyResponseMetadata(target, metadata, endpointIdentity) {
 }
 
 // src/server/router.ts
-function joinPath(...parts) {
-  const joined = parts.filter(Boolean).map((part) => part.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
-  return `/${joined}`;
-}
 function routeSegments(path) {
   return path.split("/").filter(Boolean);
 }
@@ -914,8 +913,8 @@ function buildRouteMap(groups) {
     for (const [, method] of Object.entries(service.methods)) {
       if (method.expose && !method.expose.includes("HTTP"))
         continue;
-      const servicePath = joinPath("/", service.prefix, method.path === "/" ? "" : method.path);
-      const fullPath = prefix ? joinPath(prefix, servicePath) : servicePath;
+      const servicePath = joinRoutePath("/", service.prefix, method.path === "/" ? "" : method.path);
+      const fullPath = prefix ? joinRoutePath(prefix, servicePath) : servicePath;
       const segments = routeSegments(fullPath);
       const entries = map.get(method.method) ?? [];
       entries.push({ method, pattern: fullPath, segments, groupHooks: hooks });
@@ -1853,16 +1852,19 @@ function isModuleNotFound(err) {
   const message = "message" in err && typeof err.message === "string" ? err.message : "";
   return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || message.includes("Cannot find module") || message.includes("Cannot find package");
 }
-async function importPeer(load, pkg) {
+async function importPeer(load, pkg, injected) {
   try {
     return await load();
   } catch (err) {
     if (isModuleNotFound(err)) {
-      throw new Error(`[stitchkit] createSocketIOServer needs the optional peer "${pkg}" — install it: bun add ${pkg}`, { cause: err });
+      throw new Error(injected ? `[stitchkit] createSocketIOServer could not load the optional peer "${pkg}" through the loader passed in \`peers\` — the artifact does not contain it. Check that the loader is a literal \`import('${pkg}')\` your bundler can follow, and that "${pkg}" is a dependency of the package being bundled.` : `[stitchkit] createSocketIOServer needs the optional peer "${pkg}" — install it: bun add ${pkg}. Shipping one self-contained artifact instead? Pass \`peers: { … }\` so your bundler puts it inside.`, { cause: err });
     }
     throw err;
   }
 }
+function isBunEngineModule(value) {
+  return typeof value === "object" && value !== null && typeof Reflect.get(value, "Server") === "function";
+}
 function handshakeRejection(message) {
   const error = new Error(message);
   error.data = { code: "handshake_rejected" };
@@ -1906,11 +1908,11 @@ async function createSocketIOServer(config) {
   const transports = config.transports ?? (onBun ? ["websocket", "polling"] : ["websocket"]);
   const pingTimeout = config.pingTimeout ?? 20000;
   const pingInterval = config.pingInterval ?? 1e4;
-  const cors = {
+  const cors = config.cors ? {
     origin: config.cors.origin,
     credentials: config.cors.credentials ?? true,
     methods: ["GET", "POST"]
-  };
+  } : undefined;
   let accepting = true;
   let attached = false;
   let closePromise;
@@ -1939,7 +1941,8 @@ async function createSocketIOServer(config) {
     });
     checkRequest(webRequest).then(() => done(null, true), (error) => done(error instanceof Error ? error.message : "Request rejected", false));
   };
-  const { Server } = await importPeer(() => import(SOCKET_IO_SERVER).then((module) => module), SOCKET_IO_SERVER);
+  const injectedServer = config.peers?.server;
+  const { Server } = await importPeer(injectedServer ?? (() => import(SOCKET_IO_SERVER).then((module) => module)), SOCKET_IO_SERVER, injectedServer !== undefined);
   const io = new Server({
     ...config.serverOptions,
     path,
@@ -1966,7 +1969,12 @@ async function createSocketIOServer(config) {
     }
   };
   if (onBun) {
-    const { Server: Engine } = await importPeer(() => import(SOCKET_IO_BUN_ENGINE).then((module) => module), SOCKET_IO_BUN_ENGINE);
+    const injectedEngine = config.peers?.bunEngine;
+    const engineModule = await importPeer(injectedEngine ?? (() => import(SOCKET_IO_BUN_ENGINE).then((module) => module)), SOCKET_IO_BUN_ENGINE, injectedEngine !== undefined);
+    if (!isBunEngineModule(engineModule)) {
+      throw new Error(`[stitchkit] the loader passed in \`peers.bunEngine\` did not return the "${SOCKET_IO_BUN_ENGINE}" module — it must resolve to the module itself, as \`() => import('${SOCKET_IO_BUN_ENGINE}')\`.`);
+    }
+    const { Server: Engine } = engineModule;
     const engineOpts = {
       path,
       cors,

package/dist/{index-gnvzyw0k.js → index-6taryy00.js}

@@ -1,6 +1,6 @@
 import {
   isUnsafeKey
-} from "./index-ps5pxp3h.js";
+} from "./index-wd8g8z6e.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";
@@ -83,7 +83,7 @@ function redact(value, options = {}) {
       ancestors.add(input);
       const result = [...input.entries()].map(([key, value2]) => [
         walk(key, depth + 1),
-        walk(value2, depth + 1)
+        typeof key === "string" && isSensitive(key) ? MASK : walk(value2, depth + 1)
       ]);
       ancestors.delete(input);
       return { _type: "map", entries: result };

package/dist/{index-5c8n2123.js → index-82e74yfx.js}

@@ -2,10 +2,13 @@ import {
   ApplicationIdSchema,
   ApplicationShutdownResultSchema,
   ApplicationSnapshotSchema
-} from "./index-mgf6cdkm.js";
+} from "./index-8eywc9zv.js";
 import {
   ShutdownOptionsSchema
 } from "./index-dk6e56g0.js";
+import {
+  AppError
+} from "./index-xxye8j3k.js";
 
 // src/application/graph.ts
 function resolveResourceGraph(resources) {
@@ -61,10 +64,21 @@ class ResourceCompletionBeforeReadyError extends Error {
   }
 }
 
-class ApplicationAdmissionError extends Error {
-  code = "APPLICATION_NOT_ACCEPTING";
+class ApplicationStartupInterruptedError extends Error {
   constructor() {
-    super("Application is not accepting new operations");
+    super("[stitchkit] application startup interrupted by shutdown");
+    this.name = "ApplicationStartupInterruptedError";
+  }
+}
+var ApplicationShutdownOptionsSchema = ShutdownOptionsSchema.pick({
+  gracePeriodMs: true,
+  forceTimeoutMs: true,
+  signal: true
+});
+
+class ApplicationAdmissionError extends AppError {
+  constructor() {
+    super("APPLICATION_NOT_ACCEPTING", "Application is not accepting new operations", 503);
     this.name = "ApplicationAdmissionError";
   }
 }
@@ -87,6 +101,15 @@ function createApplication(config) {
   const id = ApplicationIdSchema.parse(config.id);
   const ordered = resolveResourceGraph(config.resources ?? []);
   const reverse = [...ordered].reverse();
+  const reportFailure = (resourceId, phase, error) => {
+    if (!config.onResourceFailure)
+      return;
+    try {
+      Promise.resolve(config.onResourceFailure({ resourceId, phase, error })).catch(() => {
+        return;
+      });
+    } catch {}
+  };
   const records = new Map;
   for (const entry of ordered) {
     records.set(entry.id, {
@@ -187,8 +210,10 @@ function createApplication(config) {
   const markLateCompletion = (record, failure) => {
     if (shutdownRequested || record.state === "stopping" || record.state === "stopped")
       return;
-    if (failure)
+    if (failure) {
       record.failures.push("completion");
+      reportFailure(record.entry.id, "completion", failure.error);
+    }
     record.state = "failed";
     record.health = "unhealthy";
     accepting = activationComplete && isReady();
@@ -209,6 +234,7 @@ function createApplication(config) {
       } catch (error) {
         record.failures.push("close");
         record.state = "failed";
+        reportFailure(entry.id, "close", error);
         errors.push(error);
       }
       publish();
@@ -222,7 +248,7 @@ function createApplication(config) {
     try {
       for (const entry of ordered) {
         if (shutdownRequested || startupAbort.signal.aborted) {
-          throw new Error("[stitchkit] application startup interrupted by shutdown");
+          throw new ApplicationStartupInterruptedError;
         }
         const record = records.get(entry.id);
         if (!record)
@@ -244,7 +270,7 @@ function createApplication(config) {
         try {
           const started = await entry.resource.start(contextFor(record, { signal: startupAbort.signal }));
           if (shutdownRequested || startupAbort.signal.aborted) {
-            throw new Error("[stitchkit] application startup interrupted by shutdown");
+            throw new ApplicationStartupInterruptedError;
           }
           if (isStartResult(started)) {
             record.runtime = started;
@@ -254,12 +280,12 @@ function createApplication(config) {
             const completion = started.completion?.then(() => {
               completionSettled = true;
               if (resourceReady)
-                markLateCompletion(record, false);
+                markLateCompletion(record);
             }, (error) => {
               completionSettled = true;
               completionFailure = error;
               if (resourceReady)
-                markLateCompletion(record, true);
+                markLateCompletion(record, { error });
             });
             if (started.ready && completion) {
               const readiness = started.ready.then(() => "ready");
@@ -278,19 +304,21 @@ function createApplication(config) {
             } else if (completion) {}
           }
           if (shutdownRequested || startupAbort.signal.aborted) {
-            throw new Error("[stitchkit] application startup interrupted by shutdown");
+            throw new ApplicationStartupInterruptedError;
           }
           record.state = "ready";
           record.health = "healthy";
           publish();
         } catch (error) {
-          if (shutdownRequested || startupAbort.signal.aborted)
-            throw error;
-          record.failures.push(error instanceof ResourceCompletionBeforeReadyError ? "completion" : record.runtime?.ready ? "ready" : "start");
-          record.state = "failed";
-          record.health = "unhealthy";
-          publish();
-          if (entry.required)
+          const interrupted = shutdownRequested || startupAbort.signal.aborted;
+          if (!(error instanceof ApplicationStartupInterruptedError)) {
+            record.failures.push(error instanceof ResourceCompletionBeforeReadyError ? "completion" : record.runtime?.ready ? "ready" : "start");
+            record.state = "failed";
+            record.health = "unhealthy";
+            reportFailure(entry.id, record.failures[record.failures.length - 1] ?? "start", error);
+            publish();
+          }
+          if (interrupted || entry.required)
             throw error;
         }
       }
@@ -298,7 +326,7 @@ function createApplication(config) {
       publish();
       for (const entry of ordered) {
         if (shutdownRequested || startupAbort.signal.aborted) {
-          throw new Error("[stitchkit] application startup interrupted by shutdown");
+          throw new ApplicationStartupInterruptedError;
         }
         const record = records.get(entry.id);
         if (record?.state !== "ready")
@@ -320,25 +348,27 @@ function createApplication(config) {
         try {
           await entry.resource.activate?.(contextFor(record));
           if (shutdownRequested || startupAbort.signal.aborted) {
-            throw new Error("[stitchkit] application startup interrupted by shutdown");
+            throw new ApplicationStartupInterruptedError;
           }
           record.activated = true;
           if (entry.required && (record.state !== "ready" || record.health !== "healthy")) {
             throw new Error(`[stitchkit] required resource "${entry.id}" lost readiness during activation`);
           }
         } catch (error) {
-          if (shutdownRequested || startupAbort.signal.aborted)
-            throw error;
-          record.failures.push("start");
-          record.state = "failed";
-          record.health = "unhealthy";
-          publish();
-          if (entry.required)
+          const interrupted = shutdownRequested || startupAbort.signal.aborted;
+          if (!(error instanceof ApplicationStartupInterruptedError)) {
+            record.failures.push("start");
+            record.state = "failed";
+            record.health = "unhealthy";
+            reportFailure(entry.id, "start", error);
+            publish();
+          }
+          if (interrupted || entry.required)
             throw error;
         }
       }
       if (shutdownRequested) {
-        throw new Error("[stitchkit] application startup interrupted by shutdown");
+        throw new ApplicationStartupInterruptedError;
       }
       if (!isReady()) {
         throw new Error("[stitchkit] a required resource lost readiness during startup");
@@ -417,7 +447,7 @@ function createApplication(config) {
   const shutdown = (options) => {
     if (shutdownPromise)
       return shutdownPromise;
-    const parsed = ShutdownOptionsSchema.parse(options ?? {});
+    const parsed = ApplicationShutdownOptionsSchema.parse(options ?? {});
     const startedAt = performance.now();
     const graceDeadlineAt = startedAt + parsed.gracePeriodMs;
     const forceDeadlineAt = graceDeadlineAt + parsed.forceTimeoutMs;
@@ -464,8 +494,9 @@ function createApplication(config) {
             break;
           if (result.error !== undefined)
             throw result.error;
-        } catch {
+        } catch (error) {
           record.failures.push("admission");
+          reportFailure(entry.id, "admission", error);
           gracefulFailed = true;
           lifetimeAbort.abort();
         }
@@ -491,8 +522,9 @@ function createApplication(config) {
           }
           if (drained.error !== undefined)
             throw drained.error;
-        } catch {
+        } catch (error) {
           record.failures.push("drain");
+          reportFailure(entry.id, "drain", error);
           gracefulFailed = true;
           lifetimeAbort.abort();
           break;
@@ -518,8 +550,9 @@ function createApplication(config) {
           record.closed = true;
           record.state = "stopped";
           publish();
-        } catch {
+        } catch (error) {
           record.failures.push("close");
+          reportFailure(entry.id, "close", error);
           record.state = "failed";
           gracefulFailed = true;
           lifetimeAbort.abort();
@@ -556,17 +589,20 @@ function createApplication(config) {
               })));
             } else if (entry.resource.close) {
               record.failures.push("force");
+              reportFailure(entry.id, "force", new Error(`[stitchkit] resource "${entry.id}" was already closing and did not settle before the force deadline`));
               return;
             }
             const forced = await untilDeadline(cleanup ?? Promise.resolve(), forceAbort.signal);
             if (!forced.settled || forced.error !== undefined) {
               record.failures.push("force");
+              reportFailure(entry.id, "force", forced.settled ? forced.error : new Error("[stitchkit] forced cleanup did not settle in time"));
               return;
             }
             record.closed = true;
             record.state = "stopped";
-          } catch {
+          } catch (error) {
             record.failures.push("force");
+            reportFailure(entry.id, "force", error);
           }
         }));
         clearTimeout(forceTimer);
@@ -614,4 +650,4 @@ function createApplication(config) {
   };
 }
 
-export { ApplicationAdmissionError, createApplication };
+export { ApplicationShutdownOptionsSchema, ApplicationAdmissionError, createApplication };

package/dist/{index-mgf6cdkm.js → index-8eywc9zv.js}

@@ -46,6 +46,40 @@ var ApplicationSnapshotSchema = z.object({
   admission: ApplicationAdmissionSnapshotSchema,
   resources: z.array(ManagedResourceSnapshotSchema).readonly()
 }).readonly();
+var ApplicationStatusProjectionSchema = z.object({
+  id: ApplicationIdSchema,
+  lifecycle: ApplicationLifecycleSchema,
+  health: ApplicationHealthSchema,
+  ready: z.boolean(),
+  capturedAt: z.string().datetime({ offset: true }),
+  resources: z.object({
+    total: NonNegativeIntegerSchema,
+    ready: NonNegativeIntegerSchema,
+    degraded: NonNegativeIntegerSchema,
+    failed: NonNegativeIntegerSchema
+  }).readonly()
+}).readonly();
+function projectApplicationStatus(snapshot) {
+  let ready = 0;
+  let degraded = 0;
+  let failed = 0;
+  for (const resource of snapshot.resources) {
+    if (resource.ready)
+      ready += 1;
+    if (resource.health === "degraded")
+      degraded += 1;
+    if (resource.state === "failed")
+      failed += 1;
+  }
+  return {
+    id: snapshot.id,
+    lifecycle: snapshot.lifecycle,
+    health: snapshot.health,
+    ready: snapshot.ready,
+    capturedAt: snapshot.capturedAt,
+    resources: { total: snapshot.resources.length, ready, degraded, failed }
+  };
+}
 var ApplicationResourceShutdownSchema = z.object({
   id: ApplicationIdSchema,
   state: z.enum(["not-started", "closed", "force-failed"]),
@@ -63,4 +97,4 @@ var ApplicationShutdownResultSchema = z.object({
   durationMs: z.number().nonnegative()
 }).readonly();
 
-export { ApplicationIdSchema, ApplicationLifecycleSchema, ApplicationHealthSchema, ManagedResourceStateSchema, ApplicationAdmissionSnapshotSchema, ManagedResourceSnapshotSchema, ApplicationSnapshotSchema, ApplicationResourceShutdownSchema, ApplicationShutdownResultSchema };
+export { ApplicationIdSchema, ApplicationLifecycleSchema, ApplicationHealthSchema, ManagedResourceStateSchema, ApplicationAdmissionSnapshotSchema, ManagedResourceSnapshotSchema, ApplicationSnapshotSchema, ApplicationStatusProjectionSchema, projectApplicationStatus, ApplicationResourceShutdownSchema, ApplicationShutdownResultSchema };

package/dist/{index-0nc0cddp.js → index-a59da114.js}

@@ -138,41 +138,30 @@ function createBoundedSinkManager(config) {
     flush() {
       return awaitGeneration(sequence);
     },
-    getStatus() {
-      return ObservabilitySinkStatusSchema.parse({
-        capacity: maxPending,
-        received,
-        accepted,
-        filtered,
-        completed,
-        dropped,
-        failed,
-        preparationFailed,
-        preparing: preparing.size,
-        pending: writes.size,
-        closed
-      });
-    },
+    getStatus,
     close() {
       if (closePromise)
         return closePromise;
       closed = true;
-      closePromise = awaitGeneration(sequence).then(() => ObservabilitySinkStatusSchema.parse({
-        capacity: maxPending,
-        received,
-        accepted,
-        filtered,
-        completed,
-        dropped,
-        failed,
-        preparationFailed,
-        preparing: preparing.size,
-        pending: writes.size,
-        closed
-      }));
+      closePromise = awaitGeneration(sequence).then(getStatus);
       return closePromise;
     }
   };
+  function getStatus() {
+    return ObservabilitySinkStatusSchema.parse({
+      capacity: maxPending,
+      received,
+      accepted,
+      filtered,
+      completed,
+      dropped,
+      failed,
+      preparationFailed,
+      preparing: preparing.size,
+      pending: writes.size,
+      closed
+    });
+  }
 }
 
 export { ObservabilitySinkStatusSchema, ObservabilityStatusSchema, ObservabilityDrainReportSchema, aggregateObservabilityStatus, createBoundedSinkManager };

package/dist/{index-f6pymtqe.js → index-mfw1pec7.js}

@@ -2,18 +2,20 @@ import {
   contextContributionDelta,
   mergeContextContribution,
   prepareContextContribution
-} from "./index-41wm56v0.js";
+} from "./index-y91zd0ch.js";
 import {
   base64UrlToBytes,
   bytesToBase64Url,
-  forbidden,
   isUnsafeKey,
-  safeJsonParse,
-  unauthorized
-} from "./index-ps5pxp3h.js";
+  safeJsonParse
+} from "./index-wd8g8z6e.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";
+import {
+  forbidden,
+  unauthorized
+} from "./index-xxye8j3k.js";
 
 // src/server/middleware/cookies.ts
 function parseCookies(header) {

package/dist/{index-y2rb7dwx.js → index-pzyt11ch.js}

@@ -80,6 +80,10 @@ function resolvePropagationContext(metadata, fallback) {
 
 // src/internal/route-pattern.ts
 var PARAM_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function joinRoutePath(...parts) {
+  const joined = parts.filter((part) => Boolean(part)).map((part) => part.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
+  return `/${joined}`;
+}
 function parseTrailingWildcard(path) {
   const segments = path.split("/").filter(Boolean);
   const paramNames = new Set;
@@ -120,4 +124,4 @@ function parseTrailingWildcard(path) {
   return wildcard;
 }
 
-export { parseTrailingWildcard, createTraceContext, parseTraceparent, formatTraceparent, resolveTraceContext, childSpan, resolvePropagationContext };
+export { joinRoutePath, parseTrailingWildcard, createTraceContext, parseTraceparent, formatTraceparent, resolveTraceContext, childSpan, resolvePropagationContext };

package/dist/{index-mr617n62.js → index-svqhcrrj.js}

@@ -3,7 +3,7 @@ import {
 } from "./index-48ffdxgk.js";
 import {
   parseTrailingWildcard
-} from "./index-y2rb7dwx.js";
+} from "./index-pzyt11ch.js";
 import {
   isRecord,
   mapObject,

package/dist/{index-28cqssm3.js → index-t8xrqc9g.js}

@@ -284,6 +284,13 @@ var STITCH_ERROR_STATUS = {
   FILE_TOO_LARGE: 413,
   FILE_EXISTS: 409,
   REALTIME_CONTRACT_VIOLATION: 500,
+  APPLICATION_NOT_ACCEPTING: 503,
+  GRAMMY_WEBHOOK_NOT_ACCEPTING: 503,
+  WAIT_TIMEOUT: 408,
+  WAIT_FAILED: 409,
+  DOWNLOAD_NOT_FOUND: 404,
+  VIEW_HTTP_ERROR: 502,
+  OPERATION_NOT_SUCCEEDED: 409,
   INTERNAL_SERVER_ERROR: 500
 };
 function isStitchErrorCode(code) {

package/dist/{index-7c0gkyvj.js → index-tvwcrx2d.js}

@@ -1,13 +1,15 @@
 import {
-  AppError,
   isUnsafeKey
-} from "./index-ps5pxp3h.js";
+} from "./index-wd8g8z6e.js";
 import {
   resolveTraceContext
-} from "./index-y2rb7dwx.js";
+} from "./index-pzyt11ch.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";
+import {
+  AppError
+} from "./index-xxye8j3k.js";
 
 // src/internal/errors.ts
 import { z } from "zod";

package/dist/{index-1tkyng3g.js → index-vkk06pv1.js}

@@ -338,14 +338,6 @@ function rebuild(value) {
     node[key] = rebuild(child);
   return flattenNode(node);
 }
-function stringValues2(schema) {
-  if (typeof schema.const === "string")
-    return [schema.const];
-  if (!Array.isArray(schema.enum))
-    return null;
-  const values = schema.enum.filter((value) => typeof value === "string");
-  return values.length === schema.enum.length ? values : null;
-}
 function objectVariants(node) {
   if (!Array.isArray(node.oneOf) || node.oneOf.length < 2)
     return null;
@@ -372,7 +364,7 @@ function findDiscriminator(variants) {
       }
       const properties = variant.properties;
       const field = isRecord(properties) ? properties[key] : undefined;
-      const branchValues = isRecord(field) ? stringValues2(field) : null;
+      const branchValues = isRecord(field) ? stringValues(field) : null;
       if (!branchValues || branchValues.length === 0) {
         valid = false;
         break;