@truefoundry/trueforge-core 0.0.0 → 0.1.0-rc.0

package/dist/core/util/promiseUtils.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/util/promiseUtils.ts
+var promiseUtils_exports = {};
+__export(promiseUtils_exports, {
+  PromiseTimeoutError: () => PromiseTimeoutError,
+  mergeAsyncGenerators: () => mergeAsyncGenerators,
+  withTimeout: () => withTimeout
+});
+module.exports = __toCommonJS(promiseUtils_exports);
+var import_errorLogFields = require("./errorLogFields.js");
+var PromiseTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PromiseTimeoutError";
+  }
+};
+function withTimeout(p, ms, label) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      reject(
+        new PromiseTimeoutError(
+          label ? `Timed out after ${String(ms)}ms (${label})` : `Timed out after ${String(ms)}ms`
+        )
+      );
+    }, ms);
+  });
+  return Promise.race([p, timeout]).finally(() => {
+    clearTimeout(timer);
+  });
+}
+async function* mergeAsyncGenerators(generators, logger) {
+  const pending = /* @__PURE__ */ new Map();
+  const getNextIteration = (idx) => {
+    const generator = generators[idx];
+    if (generator === void 0) {
+      throw new Error(`Unreachable: missing generator at index ${String(idx)}`);
+    }
+    const nextPromise = generator.next().then((result) => ({ idx, result }));
+    nextPromise.catch((error) => {
+      logger.error(`Unexpected error in mergeAsyncGenerators generator ${String(idx)}`, (0, import_errorLogFields.extractErrorLogFields)(error));
+    });
+    return nextPromise;
+  };
+  for (let i = 0; i < generators.length; i++) {
+    pending.set(i, getNextIteration(i));
+  }
+  while (pending.size > 0) {
+    const { idx, result } = await Promise.race(pending.values());
+    if (result.done) {
+      pending.delete(idx);
+      continue;
+    }
+    yield result.value;
+    pending.set(idx, getNextIteration(idx));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PromiseTimeoutError,
+  mergeAsyncGenerators,
+  withTimeout
+});
+//# sourceMappingURL=promiseUtils.js.map

package/dist/core/util/promiseUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/util/promiseUtils.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport { extractErrorLogFields } from './errorLogFields';\n\nexport class PromiseTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PromiseTimeoutError';\n  }\n}\n\nexport function withTimeout<T>(p: Promise<T>, ms: number, label?: string): Promise<T> {\n  let timer: ReturnType<typeof setTimeout>;\n\n  const timeout = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      reject(\n        new PromiseTimeoutError(\n          label ? `Timed out after ${String(ms)}ms (${label})` : `Timed out after ${String(ms)}ms`,\n        ),\n      );\n    }, ms);\n  });\n\n  return Promise.race([p, timeout]).finally(() => {\n    clearTimeout(timer);\n  });\n}\n\nexport async function* mergeAsyncGenerators<T>(\n  generators: AsyncGenerator<T>[],\n  logger: Logger,\n): AsyncGenerator<T, void, unknown> {\n  interface PendingResult {\n    idx: number;\n    result: IteratorResult<T, void>;\n  }\n  const pending = new Map<number, Promise<PendingResult>>();\n\n  const getNextIteration = (idx: number): Promise<PendingResult> => {\n    const generator = generators[idx];\n    if (generator === undefined) {\n      throw new Error(`Unreachable: missing generator at index ${String(idx)}`);\n    }\n    const nextPromise = generator.next().then(result => ({ idx, result }));\n    nextPromise.catch((error: unknown) => {\n      logger.error(`Unexpected error in mergeAsyncGenerators generator ${String(idx)}`, extractErrorLogFields(error));\n    });\n    return nextPromise;\n  };\n\n  for (let i = 0; i < generators.length; i++) {\n    pending.set(i, getNextIteration(i));\n  }\n\n  while (pending.size > 0) {\n    const { idx, result } = await Promise.race(pending.values());\n    if (result.done) {\n      pending.delete(idx);\n      continue;\n    }\n\n    yield result.value;\n    pending.set(idx, getNextIteration(idx));\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,4BAAsC;AAE/B,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAC7C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,YAAe,GAAe,IAAY,OAA4B;AACpF,MAAI;AAEJ,QAAM,UAAU,IAAI,QAAe,CAAC,GAAG,WAAW;AAChD,YAAQ,WAAW,MAAM;AACvB;AAAA,QACE,IAAI;AAAA,UACF,QAAQ,mBAAmB,OAAO,EAAE,CAAC,OAAO,KAAK,MAAM,mBAAmB,OAAO,EAAE,CAAC;AAAA,QACtF;AAAA,MACF;AAAA,IACF,GAAG,EAAE;AAAA,EACP,CAAC;AAED,SAAO,QAAQ,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,MAAM;AAC9C,iBAAa,KAAK;AAAA,EACpB,CAAC;AACH;AAEA,gBAAuB,qBACrB,YACA,QACkC;AAKlC,QAAM,UAAU,oBAAI,IAAoC;AAExD,QAAM,mBAAmB,CAAC,QAAwC;AAChE,UAAM,YAAY,WAAW,GAAG;AAChC,QAAI,cAAc,QAAW;AAC3B,YAAM,IAAI,MAAM,2CAA2C,OAAO,GAAG,CAAC,EAAE;AAAA,IAC1E;AACA,UAAM,cAAc,UAAU,KAAK,EAAE,KAAK,aAAW,EAAE,KAAK,OAAO,EAAE;AACrE,gBAAY,MAAM,CAAC,UAAmB;AACpC,aAAO,MAAM,sDAAsD,OAAO,GAAG,CAAC,QAAI,6CAAsB,KAAK,CAAC;AAAA,IAChH,CAAC;AACD,WAAO;AAAA,EACT;AAEA,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,YAAQ,IAAI,GAAG,iBAAiB,CAAC,CAAC;AAAA,EACpC;AAEA,SAAO,QAAQ,OAAO,GAAG;AACvB,UAAM,EAAE,KAAK,OAAO,IAAI,MAAM,QAAQ,KAAK,QAAQ,OAAO,CAAC;AAC3D,QAAI,OAAO,MAAM;AACf,cAAQ,OAAO,GAAG;AAClB;AAAA,IACF;AAEA,UAAM,OAAO;AACb,YAAQ,IAAI,KAAK,iBAAiB,GAAG,CAAC;AAAA,EACxC;AACF;","names":[]}

package/dist/core/util/promiseUtils.mjs

@@ -0,0 +1,55 @@
+// src/core/util/promiseUtils.ts
+import { extractErrorLogFields } from "./errorLogFields.mjs";
+var PromiseTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PromiseTimeoutError";
+  }
+};
+function withTimeout(p, ms, label) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      reject(
+        new PromiseTimeoutError(
+          label ? `Timed out after ${String(ms)}ms (${label})` : `Timed out after ${String(ms)}ms`
+        )
+      );
+    }, ms);
+  });
+  return Promise.race([p, timeout]).finally(() => {
+    clearTimeout(timer);
+  });
+}
+async function* mergeAsyncGenerators(generators, logger) {
+  const pending = /* @__PURE__ */ new Map();
+  const getNextIteration = (idx) => {
+    const generator = generators[idx];
+    if (generator === void 0) {
+      throw new Error(`Unreachable: missing generator at index ${String(idx)}`);
+    }
+    const nextPromise = generator.next().then((result) => ({ idx, result }));
+    nextPromise.catch((error) => {
+      logger.error(`Unexpected error in mergeAsyncGenerators generator ${String(idx)}`, extractErrorLogFields(error));
+    });
+    return nextPromise;
+  };
+  for (let i = 0; i < generators.length; i++) {
+    pending.set(i, getNextIteration(i));
+  }
+  while (pending.size > 0) {
+    const { idx, result } = await Promise.race(pending.values());
+    if (result.done) {
+      pending.delete(idx);
+      continue;
+    }
+    yield result.value;
+    pending.set(idx, getNextIteration(idx));
+  }
+}
+export {
+  PromiseTimeoutError,
+  mergeAsyncGenerators,
+  withTimeout
+};
+//# sourceMappingURL=promiseUtils.mjs.map

package/dist/core/util/promiseUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/util/promiseUtils.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport { extractErrorLogFields } from './errorLogFields';\n\nexport class PromiseTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'PromiseTimeoutError';\n  }\n}\n\nexport function withTimeout<T>(p: Promise<T>, ms: number, label?: string): Promise<T> {\n  let timer: ReturnType<typeof setTimeout>;\n\n  const timeout = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      reject(\n        new PromiseTimeoutError(\n          label ? `Timed out after ${String(ms)}ms (${label})` : `Timed out after ${String(ms)}ms`,\n        ),\n      );\n    }, ms);\n  });\n\n  return Promise.race([p, timeout]).finally(() => {\n    clearTimeout(timer);\n  });\n}\n\nexport async function* mergeAsyncGenerators<T>(\n  generators: AsyncGenerator<T>[],\n  logger: Logger,\n): AsyncGenerator<T, void, unknown> {\n  interface PendingResult {\n    idx: number;\n    result: IteratorResult<T, void>;\n  }\n  const pending = new Map<number, Promise<PendingResult>>();\n\n  const getNextIteration = (idx: number): Promise<PendingResult> => {\n    const generator = generators[idx];\n    if (generator === undefined) {\n      throw new Error(`Unreachable: missing generator at index ${String(idx)}`);\n    }\n    const nextPromise = generator.next().then(result => ({ idx, result }));\n    nextPromise.catch((error: unknown) => {\n      logger.error(`Unexpected error in mergeAsyncGenerators generator ${String(idx)}`, extractErrorLogFields(error));\n    });\n    return nextPromise;\n  };\n\n  for (let i = 0; i < generators.length; i++) {\n    pending.set(i, getNextIteration(i));\n  }\n\n  while (pending.size > 0) {\n    const { idx, result } = await Promise.race(pending.values());\n    if (result.done) {\n      pending.delete(idx);\n      continue;\n    }\n\n    yield result.value;\n    pending.set(idx, getNextIteration(idx));\n  }\n}\n"],"mappings":";AACA,SAAS,6BAA6B;AAE/B,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAC7C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,YAAe,GAAe,IAAY,OAA4B;AACpF,MAAI;AAEJ,QAAM,UAAU,IAAI,QAAe,CAAC,GAAG,WAAW;AAChD,YAAQ,WAAW,MAAM;AACvB;AAAA,QACE,IAAI;AAAA,UACF,QAAQ,mBAAmB,OAAO,EAAE,CAAC,OAAO,KAAK,MAAM,mBAAmB,OAAO,EAAE,CAAC;AAAA,QACtF;AAAA,MACF;AAAA,IACF,GAAG,EAAE;AAAA,EACP,CAAC;AAED,SAAO,QAAQ,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,MAAM;AAC9C,iBAAa,KAAK;AAAA,EACpB,CAAC;AACH;AAEA,gBAAuB,qBACrB,YACA,QACkC;AAKlC,QAAM,UAAU,oBAAI,IAAoC;AAExD,QAAM,mBAAmB,CAAC,QAAwC;AAChE,UAAM,YAAY,WAAW,GAAG;AAChC,QAAI,cAAc,QAAW;AAC3B,YAAM,IAAI,MAAM,2CAA2C,OAAO,GAAG,CAAC,EAAE;AAAA,IAC1E;AACA,UAAM,cAAc,UAAU,KAAK,EAAE,KAAK,aAAW,EAAE,KAAK,OAAO,EAAE;AACrE,gBAAY,MAAM,CAAC,UAAmB;AACpC,aAAO,MAAM,sDAAsD,OAAO,GAAG,CAAC,IAAI,sBAAsB,KAAK,CAAC;AAAA,IAChH,CAAC;AACD,WAAO;AAAA,EACT;AAEA,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,YAAQ,IAAI,GAAG,iBAAiB,CAAC,CAAC;AAAA,EACpC;AAEA,SAAO,QAAQ,OAAO,GAAG;AACvB,UAAM,EAAE,KAAK,OAAO,IAAI,MAAM,QAAQ,KAAK,QAAQ,OAAO,CAAC;AAC3D,QAAI,OAAO,MAAM;AACf,cAAQ,OAAO,GAAG;AAClB;AAAA,IACF;AAEA,UAAM,OAAO;AACb,YAAQ,IAAI,KAAK,iBAAiB,GAAG,CAAC;AAAA,EACxC;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Root barrel for @truefoundry/trueforge-core.
+ * Namespaced to avoid colliding event-schema exports between layers.
+ */
+export * as agentSession from './agent-session';
+export * as core from './core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  agentSession: () => agentSession,
+  core: () => core
+});
+module.exports = __toCommonJS(index_exports);
+var agentSession = __toESM(require("./agent-session/index.js"), 1);
+var core = __toESM(require("./core/index.js"), 1);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  agentSession,
+  core
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Root barrel for @truefoundry/trueforge-core.\n * Namespaced to avoid colliding event-schema exports between layers.\n */\nexport * as agentSession from './agent-session';\nexport * as core from './core';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,mBAA8B;AAC9B,WAAsB;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,8 @@
+// src/index.ts
+import * as agentSession from "./agent-session/index.mjs";
+import * as core from "./core/index.mjs";
+export {
+  agentSession,
+  core
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Root barrel for @truefoundry/trueforge-core.\n * Namespaced to avoid colliding event-schema exports between layers.\n */\nexport * as agentSession from './agent-session';\nexport * as core from './core';\n"],"mappings":";AAIA,YAAY,kBAAkB;AAC9B,YAAY,UAAU;","names":[]}

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/request-reply/client.d.ts

@@ -0,0 +1,21 @@
+import type { RedisClientType } from 'redis';
+import type { JSONReply, JSONValue, RequestEnvelope } from './types';
+export interface SendRequestOptions {
+    /** Max time to wait for a reply after the request is published (ms). */
+    replyTimeoutMs: number;
+    /** Sleep between poll attempts when the reply is not yet present (ms). */
+    pollIntervalMs: number;
+}
+/**
+ * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL
+ * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait
+ * budget is exceeded.
+ */
+export declare function redisRequest<T extends JSONValue>({ redis: redisClient, executorId, path, request, options, }: {
+    redis: RedisClientType;
+    executorId: string;
+    path: string;
+    request: RequestEnvelope<T>;
+    options?: Partial<SendRequestOptions> | undefined;
+}): Promise<JSONReply>;
+//# sourceMappingURL=client.d.ts.map

package/dist/request-reply/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/request-reply/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAoB,eAAe,EAAE,MAAM,SAAS,CAAC;AAIvF,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;CACxB;AAyBD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,EACtD,KAAK,EAAE,WAAW,EAClB,UAAU,EACV,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE;IACD,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,CAkCrB"}

package/dist/request-reply/client.js

@@ -0,0 +1,92 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/client.ts
+var client_exports = {};
+__export(client_exports, {
+  redisRequest: () => redisRequest
+});
+module.exports = __toCommonJS(client_exports);
+var import_node_crypto = require("crypto");
+var import_node_perf_hooks = require("perf_hooks");
+var import_errors = require("./errors.js");
+var import_types = require("./types.js");
+var import_utils = require("./utils.js");
+var DEFAULT_REPLY_TIMEOUT_MS = 6e4;
+var DEFAULT_POLL_INTERVAL_MS = 500;
+function resolveSendRequestOptions(options) {
+  return {
+    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,
+    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS
+  };
+}
+function parseReplyPayload(raw) {
+  const parsed = JSON.parse(raw);
+  return import_types.jsonReplySchema.parse(parsed);
+}
+async function getDelReply(redisClient, rKey) {
+  const raw = await redisClient.getDel(rKey);
+  if (raw === null) {
+    return null;
+  }
+  return parseReplyPayload(raw);
+}
+async function redisRequest({
+  redis: redisClient,
+  executorId,
+  path,
+  request,
+  options
+}) {
+  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);
+  const aliveK = (0, import_utils.heartbeatKey)(executorId);
+  if (await redisClient.exists(aliveK) === 0) {
+    throw new import_errors.NoResponderError(executorId);
+  }
+  const requestId = (0, import_node_crypto.randomUUID)();
+  const rKey = (0, import_utils.replyKey)(requestId);
+  const payload = {
+    replyKey: rKey,
+    path,
+    body: request.body,
+    headers: request.headers
+  };
+  const serializedPayload = JSON.stringify(payload);
+  const subscriberCount = await redisClient.publish((0, import_utils.requestChannel)(executorId), serializedPayload);
+  if (subscriberCount === 0) {
+    throw new import_errors.NoResponderError(executorId, "No executor received the published request");
+  }
+  const replyDeadline = import_node_perf_hooks.performance.now() + replyTimeoutMs;
+  await (0, import_utils.sleep)(Math.min(200, replyTimeoutMs));
+  for (; ; ) {
+    const replyPayload = await getDelReply(redisClient, rKey);
+    if (replyPayload) {
+      return replyPayload;
+    }
+    if (import_node_perf_hooks.performance.now() >= replyDeadline) {
+      throw new import_errors.RequestTimeoutError(replyTimeoutMs);
+    }
+    await (0, import_utils.sleep)(pollIntervalMs);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  redisRequest
+});
+//# sourceMappingURL=client.js.map

package/dist/request-reply/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait\n * budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAC3B,6BAA4B;AAE5B,oBAAsD;AAEtD,mBAAgC;AAChC,mBAA8D;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,6BAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,aAAS,2BAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,+BAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,gBAAY,+BAAW;AAC7B,QAAM,WAAO,uBAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,YAAQ,6BAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,+BAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,mCAAY,IAAI,IAAI;AAE1C,YAAM,oBAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AACA,QAAI,mCAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,kCAAoB,cAAc;AAAA,IAC9C;AACA,cAAM,oBAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}

package/dist/request-reply/client.mjs

@@ -0,0 +1,67 @@
+// src/request-reply/client.ts
+import { randomUUID } from "crypto";
+import { performance } from "perf_hooks";
+import { NoResponderError, RequestTimeoutError } from "./errors.mjs";
+import { jsonReplySchema } from "./types.mjs";
+import { heartbeatKey, replyKey, requestChannel, sleep } from "./utils.mjs";
+var DEFAULT_REPLY_TIMEOUT_MS = 6e4;
+var DEFAULT_POLL_INTERVAL_MS = 500;
+function resolveSendRequestOptions(options) {
+  return {
+    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,
+    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS
+  };
+}
+function parseReplyPayload(raw) {
+  const parsed = JSON.parse(raw);
+  return jsonReplySchema.parse(parsed);
+}
+async function getDelReply(redisClient, rKey) {
+  const raw = await redisClient.getDel(rKey);
+  if (raw === null) {
+    return null;
+  }
+  return parseReplyPayload(raw);
+}
+async function redisRequest({
+  redis: redisClient,
+  executorId,
+  path,
+  request,
+  options
+}) {
+  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);
+  const aliveK = heartbeatKey(executorId);
+  if (await redisClient.exists(aliveK) === 0) {
+    throw new NoResponderError(executorId);
+  }
+  const requestId = randomUUID();
+  const rKey = replyKey(requestId);
+  const payload = {
+    replyKey: rKey,
+    path,
+    body: request.body,
+    headers: request.headers
+  };
+  const serializedPayload = JSON.stringify(payload);
+  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);
+  if (subscriberCount === 0) {
+    throw new NoResponderError(executorId, "No executor received the published request");
+  }
+  const replyDeadline = performance.now() + replyTimeoutMs;
+  await sleep(Math.min(200, replyTimeoutMs));
+  for (; ; ) {
+    const replyPayload = await getDelReply(redisClient, rKey);
+    if (replyPayload) {
+      return replyPayload;
+    }
+    if (performance.now() >= replyDeadline) {
+      throw new RequestTimeoutError(replyTimeoutMs);
+    }
+    await sleep(pollIntervalMs);
+  }
+}
+export {
+  redisRequest
+};
+//# sourceMappingURL=client.mjs.map

package/dist/request-reply/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait\n * budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAE5B,SAAS,kBAAkB,2BAA2B;AAEtD,SAAS,uBAAuB;AAChC,SAAS,cAAc,UAAU,gBAAgB,aAAa;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,gBAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,SAAS,aAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,iBAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,YAAY,WAAW;AAC7B,QAAM,OAAO,SAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,QAAQ,eAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,iBAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,YAAY,IAAI,IAAI;AAE1C,QAAM,MAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AACA,QAAI,YAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,oBAAoB,cAAc;AAAA,IAC9C;AACA,UAAM,MAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}

package/dist/request-reply/errors.d.ts

@@ -0,0 +1,23 @@
+/** The target executor's heartbeat is missing or nobody is subscribed (map to HTTP 412). */
+export declare class NoResponderError extends Error {
+    readonly executorId: string;
+    readonly detail: string;
+    readonly code: 'NO_RESPONDER';
+    constructor(executorId: string, detail?: string);
+}
+/** No reply arrived within the wait budget (map to HTTP 424). */
+export declare class RequestTimeoutError extends Error {
+    readonly code: 'REQUEST_TIMEOUT';
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Thrown by route handlers (or the router itself) to reply with a specific
+ * status; the executor converts it to a JSONReply instead of a blanket 500.
+ */
+export declare class ReplyError extends Error {
+    readonly code: 'REPLY_ERROR';
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/request-reply/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/request-reply/errors.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,MAAM;IAHjB,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,YACW,UAAU,EAAE,MAAM,EAClB,MAAM,SAA0B,EAK1C;CACF;AAED,iEAAiE;AACjE,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,YAAY,SAAS,EAAE,MAAM,EAK5B;CACF;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAK1C;CACF"}

package/dist/request-reply/errors.js

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/errors.ts
+var errors_exports = {};
+__export(errors_exports, {
+  NoResponderError: () => NoResponderError,
+  ReplyError: () => ReplyError,
+  RequestTimeoutError: () => RequestTimeoutError
+});
+module.exports = __toCommonJS(errors_exports);
+var NoResponderError = class extends Error {
+  constructor(executorId, detail = "heartbeat not present") {
+    super(`No responder for executor: ${executorId} (${detail}).`);
+    this.executorId = executorId;
+    this.detail = detail;
+    this.name = "NoResponderError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  executorId;
+  detail;
+  code = "NO_RESPONDER";
+};
+var RequestTimeoutError = class extends Error {
+  code = "REQUEST_TIMEOUT";
+  timeoutMs;
+  constructor(timeoutMs) {
+    super(`Request timed out after ${String(timeoutMs)}ms`);
+    this.name = "RequestTimeoutError";
+    this.timeoutMs = timeoutMs;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ReplyError = class extends Error {
+  code = "REPLY_ERROR";
+  status;
+  constructor(status, message) {
+    super(message);
+    this.name = "ReplyError";
+    this.status = status;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NoResponderError,
+  ReplyError,
+  RequestTimeoutError
+});
+//# sourceMappingURL=errors.js.map

package/dist/request-reply/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/errors.ts"],"sourcesContent":["/** The target executor's heartbeat is missing or nobody is subscribed (map to HTTP 412). */\nexport class NoResponderError extends Error {\n  readonly code = 'NO_RESPONDER' as const;\n  constructor(\n    readonly executorId: string,\n    readonly detail = 'heartbeat not present',\n  ) {\n    super(`No responder for executor: ${executorId} (${detail}).`);\n    this.name = 'NoResponderError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** No reply arrived within the wait budget (map to HTTP 424). */\nexport class RequestTimeoutError extends Error {\n  readonly code = 'REQUEST_TIMEOUT' as const;\n  readonly timeoutMs: number;\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${String(timeoutMs)}ms`);\n    this.name = 'RequestTimeoutError';\n    this.timeoutMs = timeoutMs;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown by route handlers (or the router itself) to reply with a specific\n * status; the executor converts it to a JSONReply instead of a blanket 500.\n */\nexport class ReplyError extends Error {\n  readonly code = 'REPLY_ERROR' as const;\n  readonly status: number;\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = 'ReplyError';\n    this.status = status;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAE1C,YACW,YACA,SAAS,yBAClB;AACA,UAAM,8BAA8B,UAAU,KAAK,MAAM,IAAI;AAHpD;AACA;AAGT,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AAAA,EANW;AAAA,EACA;AAAA,EAHF,OAAO;AASlB;AAGO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EACpC,OAAO;AAAA,EACP;AAAA,EACT,YAAY,WAAmB;AAC7B,UAAM,2BAA2B,OAAO,SAAS,CAAC,IAAI;AACtD,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;AAMO,IAAM,aAAN,cAAyB,MAAM;AAAA,EAC3B,OAAO;AAAA,EACP;AAAA,EACT,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;","names":[]}

package/dist/request-reply/errors.mjs

@@ -0,0 +1,39 @@
+// src/request-reply/errors.ts
+var NoResponderError = class extends Error {
+  constructor(executorId, detail = "heartbeat not present") {
+    super(`No responder for executor: ${executorId} (${detail}).`);
+    this.executorId = executorId;
+    this.detail = detail;
+    this.name = "NoResponderError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  executorId;
+  detail;
+  code = "NO_RESPONDER";
+};
+var RequestTimeoutError = class extends Error {
+  code = "REQUEST_TIMEOUT";
+  timeoutMs;
+  constructor(timeoutMs) {
+    super(`Request timed out after ${String(timeoutMs)}ms`);
+    this.name = "RequestTimeoutError";
+    this.timeoutMs = timeoutMs;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ReplyError = class extends Error {
+  code = "REPLY_ERROR";
+  status;
+  constructor(status, message) {
+    super(message);
+    this.name = "ReplyError";
+    this.status = status;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+export {
+  NoResponderError,
+  ReplyError,
+  RequestTimeoutError
+};
+//# sourceMappingURL=errors.mjs.map

package/dist/request-reply/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/errors.ts"],"sourcesContent":["/** The target executor's heartbeat is missing or nobody is subscribed (map to HTTP 412). */\nexport class NoResponderError extends Error {\n  readonly code = 'NO_RESPONDER' as const;\n  constructor(\n    readonly executorId: string,\n    readonly detail = 'heartbeat not present',\n  ) {\n    super(`No responder for executor: ${executorId} (${detail}).`);\n    this.name = 'NoResponderError';\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** No reply arrived within the wait budget (map to HTTP 424). */\nexport class RequestTimeoutError extends Error {\n  readonly code = 'REQUEST_TIMEOUT' as const;\n  readonly timeoutMs: number;\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${String(timeoutMs)}ms`);\n    this.name = 'RequestTimeoutError';\n    this.timeoutMs = timeoutMs;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Thrown by route handlers (or the router itself) to reply with a specific\n * status; the executor converts it to a JSONReply instead of a blanket 500.\n */\nexport class ReplyError extends Error {\n  readonly code = 'REPLY_ERROR' as const;\n  readonly status: number;\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = 'ReplyError';\n    this.status = status;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n"],"mappings":";AACO,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAE1C,YACW,YACA,SAAS,yBAClB;AACA,UAAM,8BAA8B,UAAU,KAAK,MAAM,IAAI;AAHpD;AACA;AAGT,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AAAA,EANW;AAAA,EACA;AAAA,EAHF,OAAO;AASlB;AAGO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EACpC,OAAO;AAAA,EACP;AAAA,EACT,YAAY,WAAmB;AAC7B,UAAM,2BAA2B,OAAO,SAAS,CAAC,IAAI;AACtD,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;AAMO,IAAM,aAAN,cAAyB,MAAM;AAAA,EAC3B,OAAO;AAAA,EACP;AAAA,EACT,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;","names":[]}