stitchkit 0.60.0 → 0.61.0

package/dist/index-xxye8j3k.js

@@ -0,0 +1,85 @@
+// src/contract/errors.ts
+var APP_ERROR_BRAND = Symbol.for("stitchkit.AppError");
+
+class AppError extends Error {
+  code;
+  status;
+  details;
+  hint;
+  traceId;
+  constructor(code, message, status = 500, details, hint, traceId) {
+    super(message ?? code);
+    this.code = code;
+    this.status = status;
+    this.details = details;
+    this.hint = hint;
+    this.traceId = traceId;
+    this.name = "AppError";
+    Object.defineProperty(this, APP_ERROR_BRAND, { value: true });
+  }
+  static is(err) {
+    return typeof err === "object" && err !== null && APP_ERROR_BRAND in err;
+  }
+  toJSON() {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        ...this.details && { details: this.details },
+        ...this.hint && { hint: this.hint }
+      }
+    };
+  }
+}
+function notFound(message = "Not found") {
+  throw new AppError("NOT_FOUND", message, 404);
+}
+function badRequest(message, details) {
+  throw new AppError("BAD_REQUEST", message, 400, details);
+}
+function unauthorized(message = "Unauthorized") {
+  throw new AppError("UNAUTHORIZED", message, 401);
+}
+function forbidden(message = "Forbidden") {
+  throw new AppError("FORBIDDEN", message, 403);
+}
+function conflict(message = "Conflict", details) {
+  throw new AppError("CONFLICT", message, 409, details);
+}
+function rateLimited(message = "Too many requests") {
+  throw new AppError("RATE_LIMITED", message, 429);
+}
+var STITCH_ERROR_STATUS = {
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  METHOD_NOT_ALLOWED: 405,
+  CONFLICT: 409,
+  RATE_LIMITED: 429,
+  VALIDATION_ERROR: 400,
+  FILE_INVALID_PATH: 400,
+  FILE_OUTSIDE_ROOT: 400,
+  FILE_NOT_FOUND: 404,
+  FILE_NOT_REGULAR: 422,
+  FILE_INSPECTION_REJECTED: 422,
+  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) {
+  return Object.hasOwn(STITCH_ERROR_STATUS, code);
+}
+function appError(code, message, details) {
+  throw new AppError(code, message, isStitchErrorCode(code) ? STITCH_ERROR_STATUS[code] : 500, details);
+}
+
+export { AppError, notFound, badRequest, unauthorized, forbidden, conflict, rateLimited, STITCH_ERROR_STATUS, isStitchErrorCode, appError };

package/dist/{index-3hn10n4c.js → index-y91zd0ch.js}

@@ -1,7 +1,7 @@
 import {
   isUnsafeKey,
   mergeMeta
-} from "./index-v6e8hnkx.js";
+} from "./index-wd8g8z6e.js";
 import {
   callRuntimeHandler,
   isRecord,

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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';
 export { ApiError, type ApiEvent, type ApiEventListener, type ConfiguredHttpClient, createHttpClient, type HeaderProvider, type HttpClient, type HttpClientConfig, type RequestOptions, type UnauthorizedMatcher, } from './browser/http';
-export type { BindRealtimeClientOptions, BoundRealtimeClient, RealtimeClient, RealtimeClientOptions, RealtimeClientTransport, SocketEventMap, SocketIOClient, SocketIOClientConfig, } from './browser/socket-io';
+export type { BindRealtimeClientOptions, BoundRealtimeClient, RealtimeClient, RealtimeClientOptions, RealtimeClientTransport, SocketEventMap, SocketIOClient, SocketIOClientConfig, SocketIOClientPeerLoaders, } from './browser/socket-io';
 export { bindRealtimeClient, createRealtimeClient, createSocketIOClient, } from './browser/socket-io';
-export { type ParseSSEOptions, parseSSE } from './browser/stream';
+export { type ParseNDJSONOptions, type ParseSSEOptions, parseNDJSON, parseSSE, } from './browser/stream';
 export * from './contract';
 export type { StitchLogger } from './logger';
 export { childSpan, createTraceContext, formatTraceparent, parseTraceparent, type TraceContext, } from './observability/trace';

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,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,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,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

@@ -19,7 +19,7 @@ import {
   parseTrailingWildcard,
   rateLimited,
   unauthorized
-} from "./index-9h1vba8n.js";
+} from "./index-413xk7ga.js";
 import {
   isRecord,
   mapObject,
@@ -808,6 +808,15 @@ function createUrlBuilders(contracts, source, contractConfig) {
 function createScopedUrlBuilders(contracts, source, scopeConfigs) {
   return buildScopedRegistry(contracts, scopeConfigs, "URL builder", (contract, config) => createUrlBuilder(contract, source, config));
 }
+// src/internal/optional-peer.ts
+function isModuleNotFound(error) {
+  if (typeof error !== "object" || error === null)
+    return false;
+  const code = "code" in error ? error.code : undefined;
+  const message = "message" in error && typeof error.message === "string" ? error.message : "";
+  return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || message.includes("Cannot find module") || message.includes("Cannot find package");
+}
+
 // src/realtime/request.ts
 class RealtimeRequestTimeoutError extends Error {
   code = "REALTIME_REQUEST_TIMEOUT";
@@ -841,8 +850,19 @@ class RealtimeRequestInvalidAcknowledgementError extends Error {
   }
 }
 
-// src/realtime/rejection.ts
-import { z as z2 } from "zod";
+class RealtimeRequestRejectedError extends Error {
+  code = "REALTIME_REQUEST_REJECTED";
+  event;
+  reason;
+  issues;
+  constructor(event, reason, detail, issues) {
+    super(`Realtime request "${event}" was rejected by the peer (${reason}): ${detail}`);
+    this.name = "RealtimeRequestRejectedError";
+    this.event = event;
+    this.reason = reason;
+    this.issues = issues;
+  }
+}
 
 // src/internal/errors.ts
 import { z } from "zod";
@@ -857,7 +877,48 @@ function zodIssues(error) {
   }));
 }
 
+// src/realtime/rejected-frame.ts
+var REALTIME_REJECTION_KEY = "@stitchkit/realtime-rejected";
+var MAX_REJECTION_ISSUES = 20;
+function realtimeRejectionEnvelope(report) {
+  return { [REALTIME_REJECTION_KEY]: report };
+}
+function asRealtimeRejection(value) {
+  if (typeof value !== "object" || value === null)
+    return null;
+  const report = Reflect.get(value, REALTIME_REJECTION_KEY);
+  if (typeof report !== "object" || report === null)
+    return null;
+  const event = Reflect.get(report, "event");
+  const reason = Reflect.get(report, "reason");
+  const message = Reflect.get(report, "message");
+  if (typeof event !== "string" || typeof reason !== "string" || typeof message !== "string") {
+    return null;
+  }
+  if (reason.length === 0)
+    return null;
+  const issues = parseIssues(Reflect.get(report, "issues"));
+  return { event, reason, message, ...issues !== undefined && { issues } };
+}
+function parseIssues(value) {
+  if (!Array.isArray(value))
+    return;
+  const issues = [];
+  for (const entry of value.slice(0, MAX_REJECTION_ISSUES)) {
+    if (typeof entry !== "object" || entry === null)
+      continue;
+    const path = Reflect.get(entry, "path");
+    const code = Reflect.get(entry, "code");
+    const message = Reflect.get(entry, "message");
+    if (typeof path === "string" && typeof code === "string" && typeof message === "string") {
+      issues.push({ path, code, message });
+    }
+  }
+  return issues.length > 0 ? issues : undefined;
+}
+
 // src/realtime/rejection.ts
+import { z as z2 } from "zod";
 function realtimeContractViolation(options) {
   const issues = options.cause instanceof z2.ZodError ? zodIssues(options.cause) : undefined;
   const reason = options.reason.replaceAll("-", " ");
@@ -883,15 +944,11 @@ function method(target, name) {
   return (...args) => Reflect.apply(value, target, args);
 }
 function splitWireArguments(definition, args) {
-  if (!definition.ack)
-    return { values: args };
-  const acknowledgement = args.at(-1);
-  if (typeof acknowledgement !== "function")
-    return { values: args };
-  return {
-    values: args.slice(0, -1),
-    acknowledgement: (...callbackArgs) => Reflect.apply(acknowledgement, undefined, callbackArgs)
-  };
+  const trailing = args.at(-1);
+  const replyTo = typeof trailing === "function" ? (...callbackArgs) => Reflect.apply(trailing, undefined, callbackArgs) : undefined;
+  if (!definition.ack || !replyTo)
+    return { values: args, ...replyTo && { replyTo } };
+  return { values: args.slice(0, -1), acknowledgement: replyTo, replyTo };
 }
 function eventDefinition(registry, event, direction) {
   const definition = registry[event];
@@ -919,6 +976,19 @@ function reportRejected(rejected, hook, logger) {
     console.error("[stitchkit] realtime rejection hook failed", error);
   });
 }
+function answerWithRejection(acknowledgement, report, logger) {
+  if (!acknowledgement)
+    return;
+  try {
+    acknowledgement(realtimeRejectionEnvelope(report));
+  } catch (error) {
+    const message = "[stitchkit] could not answer a rejected realtime frame";
+    if (logger)
+      logger.warn(message, { error });
+    else
+      console.warn(message, error);
+  }
+}
 function parseRealtimeRequestArguments(registry, event, direction, args) {
   const definition = eventDefinition(registry, event, direction);
   const parsed = definition.args.safeParse(args);
@@ -944,6 +1014,17 @@ function parseRealtimeRequestArguments(registry, event, direction, args) {
   return parsed.data;
 }
 function parseRealtimeRequestAcknowledgement(schema, event, direction, value, hook, logger) {
+  const refusal = asRealtimeRejection(value);
+  if (refusal) {
+    reportRejected(realtimeContractViolation({
+      event,
+      direction,
+      phase: "arguments",
+      reason: "rejected-by-peer",
+      fault: "local"
+    }), hook, logger);
+    throw new RealtimeRequestRejectedError(event, refusal.reason, refusal.message, refusal.issues);
+  }
   const parsed = schema.safeParse(value);
   if (parsed.success)
     return parsed.data;
@@ -973,17 +1054,24 @@ function createValidatedRealtimeSocket({
     on: (event, handler) => {
       const definition = eventDefinition(inbound, event, inboundDirection);
       const wrapped = (...wireArgs) => {
-        const { values, acknowledgement } = splitWireArguments(definition, wireArgs);
+        const { values, acknowledgement, replyTo } = splitWireArguments(definition, wireArgs);
         const parsed = definition.args.safeParse(values);
         if (!parsed.success) {
-          reportRejected(realtimeContractViolation({
+          const rejected = realtimeContractViolation({
             event,
             direction: inboundDirection,
             phase: "arguments",
             reason: "invalid-arguments",
             fault: "peer",
             cause: parsed.error
-          }), onRejected, logger);
+          });
+          reportRejected(rejected, onRejected, logger);
+          answerWithRejection(replyTo, {
+            event,
+            reason: "invalid-arguments",
+            message: rejected.error.message,
+            issues: zodIssues(parsed.error).slice(0, MAX_REJECTION_ISSUES)
+          }, logger);
           return;
         }
         if (definition.ack && !acknowledgement) {
@@ -1053,6 +1141,17 @@ function createValidatedRealtimeSocket({
       const wireArgs = [...parsed.data];
       if (definition.ack && acknowledgement) {
         wireArgs.push((value) => {
+          const refusal = asRealtimeRejection(value);
+          if (refusal) {
+            reportRejected(realtimeContractViolation({
+              event,
+              direction: outboundDirection,
+              phase: "arguments",
+              reason: "rejected-by-peer",
+              fault: "local"
+            }), onRejected, logger);
+            return;
+          }
           const ack = definition.ack?.safeParse(value);
           if (!ack?.success) {
             if (ack) {
@@ -1108,11 +1207,39 @@ function loadIo() {
   if (!ioLoader) {
     ioLoader = import(SOCKET_IO_CLIENT).then((mod) => mod.io, (cause) => {
       ioLoader = null;
-      throw new Error('stitchkit: createSocketIOClient needs the "socket.io-client" peer — install it (e.g. `bun add socket.io-client`).', { cause });
+      throw new Error("stitchkit: createSocketIOClient needs the \"socket.io-client\" peer — install it (e.g. `bun add socket.io-client`). Shipping one self-contained artifact instead? Pass `peers: { client: () => import('socket.io-client') }` so your bundler puts it inside.", { cause });
     });
   }
   return ioLoader;
 }
+function isIoModule(module) {
+  if (typeof module !== "object" || module === null)
+    return false;
+  return typeof Reflect.get(module, "io") === "function";
+}
+function createIoResolver(injected) {
+  if (!injected)
+    return loadIo;
+  let pending = null;
+  return () => {
+    if (!pending) {
+      pending = injected().then((module) => {
+        const io = isIoModule(module) ? module.io : null;
+        if (!io) {
+          pending = null;
+          throw new Error("stitchkit: the loader passed in `peers.client` did not return the \"socket.io-client\" module — it must resolve to the module itself, as `() => import('socket.io-client')`.");
+        }
+        return io;
+      }, (cause) => {
+        pending = null;
+        if (!isModuleNotFound(cause))
+          throw cause;
+        throw new Error('stitchkit: createSocketIOClient could not load "socket.io-client" through the loader passed in `peers` — the artifact does not contain it. Check that the loader is a literal `import(\'socket.io-client\')` your bundler can follow, and that "socket.io-client" is a dependency of the package being bundled.', { cause });
+      });
+    }
+    return pending;
+  };
+}
 function toIoAuth(auth) {
   if (typeof auth !== "function")
     return auth;
@@ -1196,7 +1323,9 @@ function createRealtimeClient(contract, { onRejected, logger, ...config }) {
 }
 function createSocketIOClient(config) {
   let socket = null;
+  const resolveIo = createIoResolver(config.peers?.client);
   let desiredConnected = false;
+  let loadingPeer = false;
   let reconnectTimer = null;
   const pendingRequestDisconnects = new Set;
   const serverDisconnectDelay = config.reconnectOnServerDisconnect ?? 1000;
@@ -1267,6 +1396,16 @@ function createSocketIOClient(config) {
       attach(socket);
     socket.connect();
   }
+  function reportPeerFailure(error) {
+    desiredConnected = false;
+    if (!config.onConnectError)
+      throw error;
+    config.onConnectError({
+      message: error instanceof Error ? error.message : String(error),
+      data: error,
+      terminal: true
+    });
+  }
   return {
     get connected() {
       return socket?.connected ?? false;
@@ -1279,7 +1418,16 @@ function createSocketIOClient(config) {
         socket.connect();
         return;
       }
-      loadIo().then(openSocket);
+      if (loadingPeer)
+        return;
+      loadingPeer = true;
+      resolveIo().then((io) => {
+        loadingPeer = false;
+        openSocket(io);
+      }, (error) => {
+        loadingPeer = false;
+        reportPeerFailure(error);
+      });
     },
     disconnect() {
       desiredConnected = false;
@@ -1386,6 +1534,50 @@ async function* parseSSE(response, options) {
     reader.releaseLock();
   }
 }
+
+// src/browser/stream.ts
+async function* parseNDJSON(response, options) {
+  const reader = response.body?.getReader();
+  if (!reader)
+    return;
+  const decoder = new TextDecoder;
+  let buffer = "";
+  try {
+    for (;; ) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split(`
+`);
+      buffer = lines.pop() ?? "";
+      for (const rawLine of lines) {
+        const line = (rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine).trim();
+        if (line === "")
+          continue;
+        try {
+          yield JSON.parse(line);
+        } catch (err) {
+          options?.onParseError?.(line, err instanceof Error ? err : new Error(String(err)));
+        }
+      }
+    }
+    buffer += decoder.decode();
+    const tail = buffer.trim();
+    if (tail !== "") {
+      try {
+        yield JSON.parse(tail);
+      } catch (err) {
+        options?.onParseError?.(tail, err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  } finally {
+    await reader.cancel().catch(() => {
+      return;
+    });
+    reader.releaseLock();
+  }
+}
 // src/realtime/contract.ts
 function defineRealtimeContract(contract) {
   return contract;
@@ -1396,11 +1588,14 @@ export {
   AppError,
   ManagedFilePathSchema,
   ManagedFileRefSchema,
+  REALTIME_REJECTION_KEY,
   RealtimeRequestDisconnectedError,
   RealtimeRequestInvalidAcknowledgementError,
+  RealtimeRequestRejectedError,
   RealtimeRequestTimeoutError,
   STITCH_ERROR_STATUS,
   appError,
+  asRealtimeRejection,
   badRequest,
   bindRealtimeClient,
   childSpan,
@@ -1428,6 +1623,7 @@ export {
   isStitchErrorCode,
   notFound,
   paginatedSchema,
+  parseNDJSON,
   parseSSE,
   parseTraceparent,
   rateLimited,

package/dist/internal/optional-peer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Telling "the package is not there" apart from "the loader itself threw".
+ *
+ * Both halves of the Socket.IO adapter resolve their optional peers through a
+ * variable specifier and both accept an injected loader, so both face the same
+ * question when a load fails — and both must answer it the same way. A loader
+ * that throws for its own reasons is not a packaging problem, and reporting it
+ * as one sends the reader after the wrong thing.
+ *
+ * Pure and dependency-free, so the browser half can share it without dragging
+ * anything from the server into a browser graph.
+ */
+export declare function isModuleNotFound(error: unknown): boolean;
+//# sourceMappingURL=optional-peer.d.ts.map

package/dist/internal/optional-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-peer.d.ts","sourceRoot":"","sources":["../../src/internal/optional-peer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUxD"}

package/dist/node.js

@@ -3,7 +3,7 @@ import {
   bindRealtimeServer,
   createHandler,
   createSocketIOServer
-} from "./index-f7521k0x.js";
+} from "./index-s1tywej8.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -12,7 +12,7 @@ import {
   createScopedImplementRegistry,
   implement,
   implementRegistry
-} from "./index-3hn10n4c.js";
+} from "./index-y91zd0ch.js";
 import"./index-557by2db.js";
 import {
   ShutdownOptionsSchema,
@@ -21,7 +21,11 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "./index-dk6e56g0.js";
-import"./index-6fbp58g8.js";
+import"./index-tvwcrx2d.js";
+import"./index-wd8g8z6e.js";
+import"./index-6k1937bx.js";
+import"./index-pzyt11ch.js";
+import"./index-smpbdg6k.js";
 import {
   AppError,
   appError,
@@ -31,10 +35,7 @@ import {
   notFound,
   rateLimited,
   unauthorized
-} from "./index-v6e8hnkx.js";
-import"./index-6k1937bx.js";
-import"./index-pzyt11ch.js";
-import"./index-smpbdg6k.js";
+} from "./index-xxye8j3k.js";
 // src/server/node.ts
 import { serve } from "srvx/node";
 

package/dist/observability/index.js

@@ -10,7 +10,7 @@ import {
   redact,
   sanitizePayload,
   truncatePreview
-} from "../index-8es1hrv4.js";
+} from "../index-6taryy00.js";
 import {
   getRequestContext,
   getTraceId,
@@ -22,8 +22,8 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-6fbp58g8.js";
-import"../index-v6e8hnkx.js";
+} from "../index-tvwcrx2d.js";
+import"../index-wd8g8z6e.js";
 import"../index-6k1937bx.js";
 import {
   childSpan,
@@ -36,6 +36,7 @@ import {
 import {
   isRecord
 } from "../index-smpbdg6k.js";
+import"../index-xxye8j3k.js";
 
 // src/observability/audit.ts
 function toolErrorMessage(result) {

package/dist/realtime/contract.d.ts

@@ -40,7 +40,13 @@ export interface RealtimeRejectedEvent {
     event: string;
     direction: RealtimeRejectDirection;
     phase: 'arguments' | 'acknowledgement';
-    reason: 'unknown-event' | 'invalid-arguments' | 'invalid-acknowledgement-value' | 'missing-acknowledgement';
+    reason: 'unknown-event' | 'invalid-arguments' | 'invalid-acknowledgement-value' | 'missing-acknowledgement'
+    /**
+     * The PEER refused our frame against its own copy of the contract, and
+     * said so. Reported on the sender, where a silent drop used to leave
+     * nothing but an expiring deadline.
+     */
+     | 'rejected-by-peer';
     fault: 'peer' | 'local';
     error: AppError<'REALTIME_CONTRACT_VIOLATION'>;
 }

package/dist/realtime/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/realtime/contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/realtime/contract.ts"],"names":[],"mappings":"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"}

package/dist/realtime/index.d.ts

@@ -1,4 +1,5 @@
 export { defineRealtimeContract, type InferRealtimeEventMap, type RealtimeAcknowledgedEvent, type RealtimeAcknowledgement, type RealtimeContract, type RealtimeEmitArguments, type RealtimeEventArguments, type RealtimeEventDefinition, type RealtimeEventHandler, type RealtimeEventRegistry, type RealtimeRejectDirection, type RealtimeRejectedEvent, type RealtimeRejectedEventHook, type RealtimeRequestArguments, } from './contract';
-export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, RealtimeRequestTimeoutError, } from './request';
+export { asRealtimeRejection, REALTIME_REJECTION_KEY, type RealtimeRejectionEnvelope, type RealtimeRejectionIssue, type RealtimeRejectionReport, } from './rejected-frame';
+export { RealtimeRequestDisconnectedError, RealtimeRequestInvalidAcknowledgementError, type RealtimeRequestOptions, RealtimeRequestRejectedError, RealtimeRequestTimeoutError, } from './request';
 export type { ValidatedRealtimeSocket } from './socket';
 //# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,KAAK,sBAAsB,EAC3B,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gCAAgC,EAChC,0CAA0C,EAC1C,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}