stitchkit 0.54.0 → 0.56.0

package/dist/index.js

@@ -1,6 +1,8 @@
 import {
   ALL_TRANSPORTS,
   AppError,
+  ManagedFilePathSchema,
+  ManagedFileRefSchema,
   STITCH_ERROR_STATUS,
   appError,
   badRequest,
@@ -17,7 +19,7 @@ import {
   parseTrailingWildcard,
   rateLimited,
   unauthorized
-} from "./index-pfqjb5xy.js";
+} from "./index-28cqssm3.js";
 import {
   isRecord,
   mapObject,
@@ -806,6 +808,39 @@ function createUrlBuilders(contracts, source, contractConfig) {
 function createScopedUrlBuilders(contracts, source, scopeConfigs) {
   return buildScopedRegistry(contracts, scopeConfigs, "URL builder", (contract, config) => createUrlBuilder(contract, source, config));
 }
+// src/realtime/request.ts
+class RealtimeRequestTimeoutError extends Error {
+  code = "REALTIME_REQUEST_TIMEOUT";
+  event;
+  timeoutMs;
+  constructor(event, timeoutMs) {
+    super(`Realtime request "${event}" timed out after ${timeoutMs}ms`);
+    this.name = "RealtimeRequestTimeoutError";
+    this.event = event;
+    this.timeoutMs = timeoutMs;
+  }
+}
+
+class RealtimeRequestDisconnectedError extends Error {
+  code = "REALTIME_REQUEST_DISCONNECTED";
+  event;
+  constructor(event) {
+    super(`Realtime request "${event}" was interrupted by disconnect`);
+    this.name = "RealtimeRequestDisconnectedError";
+    this.event = event;
+  }
+}
+
+class RealtimeRequestInvalidAcknowledgementError extends Error {
+  code = "REALTIME_REQUEST_INVALID_ACKNOWLEDGEMENT";
+  event;
+  constructor(event, cause) {
+    super(`Realtime request "${event}" received an invalid acknowledgement`, { cause });
+    this.name = "RealtimeRequestInvalidAcknowledgementError";
+    this.event = event;
+  }
+}
+
 // src/realtime/rejection.ts
 import { z as z2 } from "zod";
 
@@ -884,6 +919,45 @@ function reportRejected(rejected, hook, logger) {
     console.error("[stitchkit] realtime rejection hook failed", error);
   });
 }
+function parseRealtimeRequestArguments(registry, event, direction, args) {
+  const definition = eventDefinition(registry, event, direction);
+  const parsed = definition.args.safeParse(args);
+  if (!parsed.success) {
+    throw realtimeContractViolation({
+      event,
+      direction,
+      phase: "arguments",
+      reason: "invalid-arguments",
+      fault: "local",
+      cause: parsed.error
+    }).error;
+  }
+  if (!definition.ack) {
+    throw realtimeContractViolation({
+      event,
+      direction,
+      phase: "acknowledgement",
+      reason: "missing-acknowledgement",
+      fault: "local"
+    }).error;
+  }
+  return parsed.data;
+}
+function parseRealtimeRequestAcknowledgement(schema, event, direction, value, hook, logger) {
+  const parsed = schema.safeParse(value);
+  if (parsed.success)
+    return parsed.data;
+  const rejected = realtimeContractViolation({
+    event,
+    direction,
+    phase: "acknowledgement",
+    reason: "invalid-acknowledgement-value",
+    fault: "peer",
+    cause: parsed.error
+  });
+  reportRejected(rejected, hook, logger);
+  throw new RealtimeRequestInvalidAcknowledgementError(event, rejected.error);
+}
 function createValidatedRealtimeSocket({
   target,
   inbound,
@@ -1046,8 +1120,18 @@ function toIoAuth(auth) {
     Promise.resolve().then(auth).then(cb, () => cb({}));
   };
 }
-function createRealtimeClient(contract, { onRejected, logger, ...config }) {
-  const transport = createSocketIOClient(config);
+function assertRealtimeClientTransport(transport) {
+  for (const capability of ["on", "emit", "emitWithAck", "onConnectionChange"]) {
+    if (typeof Reflect.get(transport, capability) !== "function") {
+      throw new TypeError(`Realtime client transport does not implement ${capability}()`);
+    }
+  }
+  if (typeof transport.connected !== "boolean") {
+    throw new TypeError("Realtime client transport does not expose boolean connected");
+  }
+}
+function bindRealtimeClient(contract, transport, { onRejected, logger } = {}) {
+  assertRealtimeClientTransport(transport);
   const events = createValidatedRealtimeSocket({
     target: transport,
     inbound: contract.serverToClient,
@@ -1070,20 +1154,51 @@ function createRealtimeClient(contract, { onRejected, logger, ...config }) {
       };
     }
   });
+  async function request(event, ...args) {
+    const options = args.at(-1);
+    if (!options || typeof options !== "object" || !("timeoutMs" in options)) {
+      throw new TypeError(`Realtime request "${event}" requires { timeoutMs }`);
+    }
+    const timeoutMs = options.timeoutMs;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+      throw new RangeError(`Realtime request "${event}" timeoutMs must be finite and > 0`);
+    }
+    const values = args.slice(0, -1);
+    const parsedArgs = parseRealtimeRequestArguments(contract.clientToServer, event, "client-outbound", values);
+    const definition = contract.clientToServer[event];
+    if (!definition?.ack) {
+      throw new Error(`Realtime request "${event}" has no acknowledgement schema`);
+    }
+    const value = await transport.emitWithAck(event, parsedArgs, { timeoutMs });
+    const acknowledgement = parseRealtimeRequestAcknowledgement(definition.ack, event, "client-inbound", value, onRejected, logger);
+    return acknowledgement;
+  }
   return {
     ...events,
-    connect: transport.connect,
-    disconnect: transport.disconnect,
     get connected() {
       return transport.connected;
     },
-    onConnectionChange: transport.onConnectionChange
+    request,
+    onConnectionChange: (listener) => transport.onConnectionChange(listener)
+  };
+}
+function createRealtimeClient(contract, { onRejected, logger, ...config }) {
+  const transport = createSocketIOClient(config);
+  const bound = bindRealtimeClient(contract, transport, { onRejected, logger });
+  return {
+    ...bound,
+    get connected() {
+      return bound.connected;
+    },
+    connect: transport.connect,
+    disconnect: transport.disconnect
   };
 }
 function createSocketIOClient(config) {
   let socket = null;
   let desiredConnected = false;
   let reconnectTimer = null;
+  const pendingRequestDisconnects = new Set;
   const serverDisconnectDelay = config.reconnectOnServerDisconnect ?? 1000;
   const connectionListeners = new Set;
   const subscriptions = new Set;
@@ -1169,6 +1284,8 @@ function createSocketIOClient(config) {
     disconnect() {
       desiredConnected = false;
       clearReconnectTimer();
+      for (const reject of [...pendingRequestDisconnects])
+        reject();
       if (!socket)
         return;
       const wasConnected = socket.connected;
@@ -1204,6 +1321,31 @@ function createSocketIOClient(config) {
       socket.emit(name, ...args);
       return true;
     },
+    emitWithAck(event, args, options) {
+      const active = socket;
+      if (!active?.connected) {
+        return Promise.reject(new RealtimeRequestDisconnectedError(event));
+      }
+      return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (result) => {
+          if (settled)
+            return;
+          settled = true;
+          pendingRequestDisconnects.delete(onDisconnect);
+          active.off("disconnect", onDisconnect);
+          result();
+        };
+        const onDisconnect = () => {
+          finish(() => reject(new RealtimeRequestDisconnectedError(event)));
+        };
+        pendingRequestDisconnects.add(onDisconnect);
+        active.on("disconnect", onDisconnect);
+        active.timeout(options.timeoutMs).emitWithAck(event, ...args).then((value) => finish(() => resolve(value)), () => {
+          finish(() => reject(active.connected ? new RealtimeRequestTimeoutError(event, options.timeoutMs) : new RealtimeRequestDisconnectedError(event)));
+        });
+      });
+    },
     onConnectionChange(listener) {
       connectionListeners.add(listener);
       return () => connectionListeners.delete(listener);
@@ -1249,39 +1391,45 @@ function defineRealtimeContract(contract) {
   return contract;
 }
 export {
-  unauthorized,
-  rateLimited,
-  parseTraceparent,
-  parseSSE,
-  paginatedSchema,
-  notFound,
-  isStitchErrorCode,
-  formatTraceparent,
-  forbidden,
-  encodeCursor,
-  defineRealtimeContract,
-  defineErrors,
-  defineContract,
-  decodeCursor,
-  createUrlBuilders,
-  createUrlBuilder,
-  createTraceContext,
-  createSocketIOClient,
-  createScopedUrlBuilders,
-  createScopedClients,
-  createRetainedTopics,
-  createRealtimeClient,
-  createHttpClient,
-  createContractFactory,
-  createClients,
-  createClient,
-  contractEndpointMatchers,
-  conflict,
-  childSpan,
-  badRequest,
-  appError,
-  STITCH_ERROR_STATUS,
-  AppError,
+  ALL_TRANSPORTS,
   ApiError,
-  ALL_TRANSPORTS
+  AppError,
+  ManagedFilePathSchema,
+  ManagedFileRefSchema,
+  RealtimeRequestDisconnectedError,
+  RealtimeRequestInvalidAcknowledgementError,
+  RealtimeRequestTimeoutError,
+  STITCH_ERROR_STATUS,
+  appError,
+  badRequest,
+  bindRealtimeClient,
+  childSpan,
+  conflict,
+  contractEndpointMatchers,
+  createClient,
+  createClients,
+  createContractFactory,
+  createHttpClient,
+  createRealtimeClient,
+  createRetainedTopics,
+  createScopedClients,
+  createScopedUrlBuilders,
+  createSocketIOClient,
+  createTraceContext,
+  createUrlBuilder,
+  createUrlBuilders,
+  decodeCursor,
+  defineContract,
+  defineErrors,
+  defineRealtimeContract,
+  encodeCursor,
+  forbidden,
+  formatTraceparent,
+  isStitchErrorCode,
+  notFound,
+  paginatedSchema,
+  parseSSE,
+  parseTraceparent,
+  rateLimited,
+  unauthorized
 };

package/dist/node.js

@@ -8,7 +8,7 @@ import {
   createHandler,
   createServerLifecycle,
   createSocketIOServer
-} from "./index-z7761jk2.js";
+} from "./index-n4nfa7gh.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -17,7 +17,9 @@ import {
   createScopedImplementRegistry,
   implement,
   implementRegistry
-} from "./index-b15rtha1.js";
+} from "./index-sm2tjx06.js";
+import"./index-557by2db.js";
+import"./index-j3dem06f.js";
 import {
   AppError,
   appError,
@@ -27,8 +29,10 @@ import {
   notFound,
   rateLimited,
   unauthorized
-} from "./index-173tvqcp.js";
-import"./index-bmnhqtya.js";
+} from "./index-5r13htq1.js";
+import"./index-6k1937bx.js";
+import"./index-7eq9va6e.js";
+import"./index-1bx83sw4.js";
 // src/server/node.ts
 import { serve } from "srvx/node";
 async function serveNode(config) {
@@ -139,28 +143,28 @@ async function createNodeSocketIOServer(config) {
   return createSocketIOServer(config);
 }
 export {
-  unauthorized,
-  serveNode,
-  rateLimited,
-  notFound,
-  implementRegistry,
-  implement,
-  forbidden,
-  createNodeSocketIOServer as createSocketIOServer,
-  createScopedImplementRegistry,
-  createScopedImplement,
-  createMultipartStream,
-  createImplementRegistry,
-  createImplement,
-  createHandler,
-  conflict,
-  bindRealtimeServer,
-  bindProcessSignals,
-  badRequest,
-  appError,
-  ShutdownStatusSchema,
-  ShutdownStateSchema,
-  ShutdownResultSchema,
+  AppError,
   ShutdownOptionsSchema,
-  AppError
+  ShutdownResultSchema,
+  ShutdownStateSchema,
+  ShutdownStatusSchema,
+  appError,
+  badRequest,
+  bindProcessSignals,
+  bindRealtimeServer,
+  conflict,
+  createHandler,
+  createImplement,
+  createImplementRegistry,
+  createMultipartStream,
+  createScopedImplement,
+  createScopedImplementRegistry,
+  createNodeSocketIOServer as createSocketIOServer,
+  forbidden,
+  implement,
+  implementRegistry,
+  notFound,
+  rateLimited,
+  serveNode,
+  unauthorized
 };

package/dist/observability/index.js

@@ -3,7 +3,7 @@ import {
   redact,
   sanitizePayload,
   truncatePreview
-} from "../index-gvha32jh.js";
+} from "../index-jcc611vh.js";
 import {
   getRequestContext,
   getTraceId,
@@ -15,7 +15,9 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-173tvqcp.js";
+} from "../index-j3dem06f.js";
+import"../index-5r13htq1.js";
+import"../index-6k1937bx.js";
 import {
   childSpan,
   createTraceContext,
@@ -24,7 +26,8 @@ import {
   parseTraceparent,
   resolvePropagationContext,
   resolveTraceContext
-} from "../index-bmnhqtya.js";
+} from "../index-7eq9va6e.js";
+import"../index-1bx83sw4.js";
 
 // src/observability/status.ts
 import { z } from "zod";
@@ -376,27 +379,27 @@ function createObservability(config) {
   };
 }
 export {
-  wrapInRequestContext,
-  truncatePreview,
-  setRequestUser,
-  setRequestError,
-  setRequestEndpoint,
-  setRequestDimensions,
-  sanitizePayload,
-  runWithRequestContext,
-  resolveTraceContext,
-  resolvePropagationContext,
-  redact,
-  parseTraceparent,
-  measureSize,
-  getUserId,
-  getTraceId,
-  getRequestContext,
-  formatTraceparent,
-  createTraceContext,
-  createObservability,
-  childSpan,
-  ObservabilityStatusSchema,
+  ObservabilityDrainReportSchema,
   ObservabilitySinkStatusSchema,
-  ObservabilityDrainReportSchema
+  ObservabilityStatusSchema,
+  childSpan,
+  createObservability,
+  createTraceContext,
+  formatTraceparent,
+  getRequestContext,
+  getTraceId,
+  getUserId,
+  measureSize,
+  parseTraceparent,
+  redact,
+  resolvePropagationContext,
+  resolveTraceContext,
+  runWithRequestContext,
+  sanitizePayload,
+  setRequestDimensions,
+  setRequestEndpoint,
+  setRequestError,
+  setRequestUser,
+  truncatePreview,
+  wrapInRequestContext
 };

package/dist/react.js

@@ -213,7 +213,7 @@ function idOf(payload, getId) {
   return hasStringId(payload) ? payload.id : getId(payload);
 }
 export {
-  createEntityCacheHandlers,
+  createCacheBridge,
   createCursorQuery,
-  createCacheBridge
+  createEntityCacheHandlers
 };

package/dist/realtime/contract.d.ts

@@ -23,6 +23,15 @@ export type RealtimeEmitArguments<TDefinition extends RealtimeEventDefinition> =
     } ? [(value: z.output<TAck>) => void] : [])
 ];
 export type RealtimeEventHandler<TDefinition extends RealtimeEventDefinition> = (...args: RealtimeEventArguments<TDefinition>) => void;
+export type RealtimeAcknowledgedEvent<TRegistry extends RealtimeEventRegistry> = {
+    [TEvent in keyof TRegistry]: TRegistry[TEvent] extends {
+        ack: z.ZodType;
+    } ? TEvent : never;
+}[keyof TRegistry] & string;
+export type RealtimeRequestArguments<TDefinition extends RealtimeEventDefinition> = z.input<TDefinition['args']> extends unknown[] ? z.input<TDefinition['args']> : never;
+export type RealtimeAcknowledgement<TDefinition extends RealtimeEventDefinition> = TDefinition extends {
+    ack: infer TAck extends z.ZodType;
+} ? z.output<TAck> : never;
 export type InferRealtimeEventMap<TRegistry extends RealtimeEventRegistry> = {
     [TEvent in keyof TRegistry]: RealtimeEventHandler<TRegistry[TEvent]>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/realtime/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,uBAAuB,CACtC,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EACzD,IAAI,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC,OAAO,GAAG,SAAS;IAE1D,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE5E,MAAM,WAAW,gBAAgB,CAC/B,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB;IAE7C,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,eAAe,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,QAAQ,EAAE,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,sDAE7D;AAED,MAAM,MAAM,sBAAsB,CAAC,WAAW,SAAS,uBAAuB,IAAI;IAChF,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG,CAAC,WAAW,SAAS;QAAE,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,CAAA;KAAE,GACzD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAChC,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,WAAW,SAAS,uBAAuB,IAAI;IAC/E,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IAC1F,GAAG,CAAC,WAAW,SAAS;QAAE,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,CAAA;KAAE,GACzD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GACjC,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,WAAW,SAAS,uBAAuB,IAAI,CAC9E,GAAG,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC,KACzC,IAAI,CAAC;AAEV,MAAM,MAAM,qBAAqB,CAAC,SAAS,SAAS,qBAAqB,IAAI;KAC1E,MAAM,IAAI,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,uBAAuB,CAAC;IACnC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACvC,MAAM,EACF,eAAe,GACf,mBAAmB,GACnB,+BAA+B,GAC/B,yBAAyB,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,QAAQ,EAAE,qBAAqB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/realtime/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,uBAAuB,CACtC,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EACzD,IAAI,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC,OAAO,GAAG,SAAS;IAE1D,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE5E,MAAM,WAAW,gBAAgB,CAC/B,eAAe,SAAS,qBAAqB,EAC7C,eAAe,SAAS,qBAAqB;IAE7C,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,eAAe,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,KAAK,CAAC,eAAe,SAAS,qBAAqB,EACnD,QAAQ,EAAE,gBAAgB,CAAC,eAAe,EAAE,eAAe,CAAC,sDAE7D;AAED,MAAM,MAAM,sBAAsB,CAAC,WAAW,SAAS,uBAAuB,IAAI;IAChF,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG,CAAC,WAAW,SAAS;QAAE,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,CAAA;KAAE,GACzD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAChC,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,WAAW,SAAS,uBAAuB,IAAI;IAC/E,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IAC1F,GAAG,CAAC,WAAW,SAAS;QAAE,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,CAAA;KAAE,GACzD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GACjC,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,WAAW,SAAS,uBAAuB,IAAI,CAC9E,GAAG,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC,KACzC,IAAI,CAAC;AAEV,MAAM,MAAM,yBAAyB,CAAC,SAAS,SAAS,qBAAqB,IAAI;KAC9E,MAAM,IAAI,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS;QAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,KAAK;CAC3F,CAAC,MAAM,SAAS,CAAC,GAChB,MAAM,CAAC;AAET,MAAM,MAAM,wBAAwB,CAAC,WAAW,SAAS,uBAAuB,IAC9E,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;AAExF,MAAM,MAAM,uBAAuB,CAAC,WAAW,SAAS,uBAAuB,IAC7E,WAAW,SAAS;IAAE,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AAErF,MAAM,MAAM,qBAAqB,CAAC,SAAS,SAAS,qBAAqB,IAAI;KAC1E,MAAM,IAAI,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,uBAAuB,CAAC;IACnC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACvC,MAAM,EACF,eAAe,GACf,mBAAmB,GACnB,+BAA+B,GAC/B,yBAAyB,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,KAAK,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,QAAQ,EAAE,qBAAqB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/realtime/index.d.ts

@@ -1,3 +1,4 @@
-export { defineRealtimeContract, type InferRealtimeEventMap, type RealtimeContract, type RealtimeEmitArguments, type RealtimeEventArguments, type RealtimeEventDefinition, type RealtimeEventHandler, type RealtimeEventRegistry, type RealtimeRejectDirection, type RealtimeRejectedEvent, type RealtimeRejectedEventHook, } from './contract';
+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 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,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,GAC/B,MAAM,YAAY,CAAC;AACpB,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,gCAAgC,EAChC,0CAA0C,EAC1C,KAAK,sBAAsB,EAC3B,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}

package/dist/realtime/request.d.ts

@@ -0,0 +1,21 @@
+export interface RealtimeRequestOptions {
+    /** Maximum acknowledgement wait in milliseconds. Must be finite and > 0. */
+    timeoutMs: number;
+}
+export declare class RealtimeRequestTimeoutError extends Error {
+    readonly code = "REALTIME_REQUEST_TIMEOUT";
+    readonly event: string;
+    readonly timeoutMs: number;
+    constructor(event: string, timeoutMs: number);
+}
+export declare class RealtimeRequestDisconnectedError extends Error {
+    readonly code = "REALTIME_REQUEST_DISCONNECTED";
+    readonly event: string;
+    constructor(event: string);
+}
+export declare class RealtimeRequestInvalidAcknowledgementError extends Error {
+    readonly code = "REALTIME_REQUEST_INVALID_ACKNOWLEDGEMENT";
+    readonly event: string;
+    constructor(event: string, cause: unknown);
+}
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/realtime/request.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK3C;CACF;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAIxB;CACF;AAED,qBAAa,0CAA2C,SAAQ,KAAK;IACnE,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAIxC;CACF"}

package/dist/realtime/socket.d.ts

@@ -1,3 +1,4 @@
+import type { z } from 'zod';
 import type { StitchLogger } from '../logger';
 import type { RealtimeEmitArguments, RealtimeEventHandler, RealtimeEventRegistry, RealtimeRejectDirection, RealtimeRejectedEventHook } from './contract';
 interface ValidatedRealtimeSocketOptions<TInbound extends RealtimeEventRegistry, TOutbound extends RealtimeEventRegistry> {
@@ -32,6 +33,8 @@ export interface ValidatedRealtimeSocket<TInbound extends RealtimeEventRegistry,
      */
     emit<TEvent extends keyof TOutbound & string>(event: TEvent, ...args: RealtimeEmitArguments<TOutbound[TEvent]>): boolean;
 }
+export declare function parseRealtimeRequestArguments(registry: RealtimeEventRegistry, event: string, direction: RealtimeRejectDirection, args: unknown[]): unknown[];
+export declare function parseRealtimeRequestAcknowledgement<TAck extends z.ZodType>(schema: TAck, event: string, direction: RealtimeRejectDirection, value: unknown, hook: RealtimeRejectedEventHook | undefined, logger: StitchLogger | undefined): z.output<TAck>;
 export declare function createValidatedRealtimeSocket<const TInbound extends RealtimeEventRegistry, const TOutbound extends RealtimeEventRegistry>({ target, inbound, outbound, inboundDirection, outboundDirection, onRejected, logger, subscribe, }: ValidatedRealtimeSocketOptions<TInbound, TOutbound>): ValidatedRealtimeSocket<TInbound, TOutbound>;
 export {};
 //# sourceMappingURL=socket.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAEvB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAGpB,UAAU,8BAA8B,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAClF;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;;;;IAOhC,CAAC;AAEH,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,EAAE,CAAC,MAAM,SAAS,MAAM,QAAQ,GAAG,MAAM,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC9C,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAChD,OAAO,CAAC;CACZ;AA+DD,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,QAAQ,SAAS,qBAAqB,EAC5C,KAAK,CAAC,SAAS,SAAS,qBAAqB,EAC7C,EACA,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,uBAAuB,CAC9E,QAAQ,EACR,SAAS,CACV,CA+HA"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAEvB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAIpB,UAAU,8BAA8B,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAClF;AAED,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;;;;IAOhC,CAAC;AAEH,MAAM,WAAW,uBAAuB,CACtC,QAAQ,SAAS,qBAAqB,EACtC,SAAS,SAAS,qBAAqB;IAEvC,EAAE,CAAC,MAAM,SAAS,MAAM,QAAQ,GAAG,MAAM,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC9C,MAAM,IAAI,CAAC;IACd;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,SAAS,MAAM,SAAS,GAAG,MAAM,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAChD,OAAO,CAAC;CACZ;AA+DD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,EAAE,CAuBX;AAED,wBAAgB,mCAAmC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,EACxE,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,yBAAyB,GAAG,SAAS,EAC3C,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAahB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,QAAQ,SAAS,qBAAqB,EAC5C,KAAK,CAAC,SAAS,SAAS,qBAAqB,EAC7C,EACA,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,uBAAuB,CAC9E,QAAQ,EACR,SAAS,CACV,CA+HA"}

package/dist/remote.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `stitchkit/remote` — peer-free remote service implementation.
+ *
+ * `implementRemote` needs only the contract and HTTP client. Keeping it in its
+ * own entrypoint lets CLI and other thin processes proxy a deployed API without
+ * importing the MCP SDK or the AI SDK through the broad tools barrel.
+ */
+export { type ImplementRemoteOptions, implementRemote } from './tools/remote';
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/remote.js

@@ -0,0 +1,79 @@
+import {
+  ApiError,
+  createClient
+} from "./index-qh4xevf5.js";
+import"./index-48ffdxgk.js";
+import {
+  AppError,
+  mergeMeta
+} from "./index-5r13htq1.js";
+import"./index-6k1937bx.js";
+import {
+  isRecord
+} from "./index-7eq9va6e.js";
+import"./index-1bx83sw4.js";
+
+// src/tools/remote.ts
+var HTTP_ONLY = Object.freeze(["HTTP"]);
+function toArgs(ctx) {
+  const { params, input } = ctx;
+  return {
+    ...isRecord(params) ? params : {},
+    ...isRecord(input) ? input : {}
+  };
+}
+function implementRemote(contract, http, options) {
+  const client = createClient(contract, http);
+  const groupScope = contract.meta.scope ?? "public";
+  const methods = {};
+  for (const [key, endpoint] of Object.entries(contract.endpoints)) {
+    methods[key] = {
+      method: endpoint.method,
+      path: endpoint.path,
+      desc: endpoint.desc,
+      serviceName: contract.meta.prefix,
+      key,
+      toolName: "toolName" in endpoint ? endpoint.toolName : undefined,
+      expose: endpoint.rawResponse || endpoint.rawBody || endpoint.responseMeta ? HTTP_ONLY : endpoint.expose,
+      ui: "ui" in endpoint ? endpoint.ui : undefined,
+      annotations: "annotations" in endpoint ? endpoint.annotations : undefined,
+      meta: mergeMeta(contract.meta.meta, endpoint.meta),
+      scope: endpoint.scope ?? groupScope,
+      paramsSchema: endpoint.params,
+      inputSchema: endpoint.input,
+      outputSchema: endpoint.output,
+      multipart: endpoint.multipart,
+      maxJsonBodyBytes: endpoint.maxJsonBodyBytes,
+      idempotent: endpoint.idempotent,
+      rawResponse: endpoint.rawResponse,
+      rawBody: endpoint.rawBody,
+      responseMeta: endpoint.responseMeta,
+      contentType: "contentType" in endpoint ? endpoint.contentType : undefined,
+      handler: async (ctx) => {
+        const call = client[key];
+        if (!call) {
+          throw new Error(`implementRemote: endpoint "${key}" is not exposed over HTTP`);
+        }
+        const args = toArgs(ctx);
+        try {
+          const finalArgs = options?.transformArgs ? await options.transformArgs(key, args) : args;
+          return await call(finalArgs);
+        } catch (err) {
+          if (ApiError.is(err)) {
+            throw new AppError(err.code, err.message, err.status, isRecord(err.details) ? err.details : undefined, err.hint, err.traceId);
+          }
+          throw err;
+        }
+      }
+    };
+  }
+  return {
+    name: contract.meta.prefix,
+    prefix: contract.meta.prefix,
+    scope: groupScope,
+    methods
+  };
+}
+export {
+  implementRemote
+};

package/dist/server/context-contribution.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimeContext } from '../contract';
+/** Keys whose value is owned by a transport/runtime boundary, never by application enrichment. */
+export declare const RUNTIME_CONTEXT_RESERVED_KEYS: Set<string>;
+/**
+ * Return the application-owned fields changed on an isolated context. The
+ * descriptors are preserved so the regular contribution validator can reject
+ * accessors and symbols without invoking consumer code.
+ */
+export declare function contextContributionDelta(original: RuntimeContext, shadow: RuntimeContext, scope: string): Record<string, unknown>;
+/** Validate and copy a contribution without mutating a runtime context. */
+export declare function prepareContextContribution(value: unknown, scope: string): Record<string, unknown>;
+/**
+ * Validate the complete contribution before mutating the runtime context.
+ * Accessors, exotic prototypes and transport-owned keys fail closed so a
+ * rejected contribution can never leave a partial or poisoned context.
+ */
+export declare function mergeContextContribution(ctx: RuntimeContext, value: unknown, scope: string): void;
+//# sourceMappingURL=context-contribution.d.ts.map