@alimzen/simulator 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alimzen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @alimzen/simulator
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Driver for **Relayo Sim**, the delivery simulator. Swap it in for your real provider in tests and CI, send
+to scenario addresses, and the simulator answers like the real world: hard bounces, greylisting, blocklists,
+full mailboxes, complaints, delays... delivered to your webhook as ordinary Relayo events. Your
+`relayo.on(...)` handlers run exactly as they would in production.
+
+```sh
+npm install -D @alimzen/core @alimzen/simulator
+```
+
+## Usage
+
+```ts
+import { createRelayo } from '@alimzen/core';
+import { scenarioAddress, simulator } from '@alimzen/simulator';
+
+const relayo = createRelayo({
+  email: process.env.CI
+    ? simulator({
+        apiKey: process.env.RELAYO_SIM_API_KEY!,
+        baseUrl: process.env.RELAYO_SIM_URL!,
+        webhook: { secret: process.env.RELAYO_SIM_WEBHOOK_SECRET! },
+      })
+    : ses({ region: 'eu-west-1' }),
+});
+
+await relayo.email.send({ ...invoiceEmail, to: { address: scenarioAddress('hard-bounce') } });
+// → your relayo.on('bounced') handler gets { bounceType: 'hard', reason: 'user_unknown', ... }
+```
+
+Webhooks from the simulator go through `relayo.handleWebhook('email', req)` like any provider's (they are
+signed: `Relayo-Signature: t=...,v1=<HMAC-SHA256>`).
+
+## Scenarios
+
+Pick one with the recipient address (`name[+param]@sim.relayo.dev`, or `scenarioAddress(name, param)`) or
+with an `X-Sim-Scenario` header that applies to every recipient. Any other address is delivered normally.
+
+| Scenario | What happens |
+| --- | --- |
+| `hard-bounce` | 550 5.1.1: the mailbox does not exist → `bounced` hard / `user_unknown` |
+| `no-mx` | 550 5.1.2: the domain cannot receive mail → `bounced` hard / `domain_invalid` |
+| `mailbox-full` | 452 4.2.2: deferred twice, then `bounced` soft / `mailbox_full` |
+| `greylist+N` | 451 4.7.1 until attempt N (default 2), then delivered |
+| `blocked` | 550 5.7.1 policy → `bounced` block / `policy_block` |
+| `blocklisted` | 554 5.7.1 Spamhaus → `bounced` block / `reputation_block` |
+| `dmarc` | 550 5.7.26 → `bounced` block / `auth_failure` |
+| `too-large` | 552 5.3.4 → `bounced` block / `message_too_large` |
+| `rate-limit` | 421 4.7.28: deferred, then delivered |
+| `timeout` | No answer (SMTP); deferred and soft-bounced (API) |
+| `delay+30m` | Delivered after the given time (s, m or h) |
+| `complaint` | Delivered, then marked as spam |
+| `unsubscribe` | Delivered, then unsubscribed |
+| `engaged` | Delivered, opened, clicked |
+| `suppressed` | `rejected` / `suppressed`, never attempted |
+
+The simulator also has an SMTP endpoint (password: your API key), so apps sending through
+`@alimzen/smtp`, or any other language, get the same scenarios as live SMTP answers.
+
+Over SMTP, refusing scenarios answer during the session. Add `+async` (`hard-bounce+async@`) to have the
+simulator accept the message and bounce it later, mailing a DSN to the envelope sender, as a relay would: that
+is how you test reading your bounce mailbox with [`@alimzen/imap`](../imap). Complaints come back as ARF reports.
+
+`baseUrl` is required: the driver never sends your API key to a default host.

package/dist/index.cjs

@@ -0,0 +1,147 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_DOMAIN: () => DEFAULT_DOMAIN,
+  SIGNATURE_HEADER: () => SIGNATURE_HEADER,
+  scenarioAddress: () => scenarioAddress,
+  simulator: () => simulator,
+  verifySimulatorSignature: () => verifySimulatorSignature
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/simulator.ts
+var import_node_crypto = require("crypto");
+var import_core = require("@alimzen/core");
+var SIGNATURE_HEADER = "relayo-signature";
+var DEFAULT_DOMAIN = "sim.relayo.dev";
+function simulator(options) {
+  if (!options.apiKey) throw new import_core.ValidationError("simulator() needs an apiKey");
+  if (!options.baseUrl) throw new import_core.ValidationError("simulator() needs the baseUrl of your Relayo Sim");
+  const name = options.name ?? "simulator";
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const webhook = options.webhook ?? {};
+  return {
+    name,
+    channel: "email",
+    capabilities: { batch: false, attachments: true, scheduling: false, tracking: true, webhooks: true },
+    async send(message, context) {
+      const to = Array.isArray(message.to) ? message.to : [message.to];
+      const body = {
+        from: message.from,
+        to,
+        ...message.cc && { cc: message.cc },
+        ...message.bcc && { bcc: message.bcc },
+        ...message.replyTo && { replyTo: message.replyTo },
+        subject: message.subject,
+        ...message.html !== void 0 && { html: message.html },
+        ...message.text !== void 0 && { text: message.text },
+        ...message.headers && { headers: message.headers },
+        ...message.attachments?.length && {
+          attachments: message.attachments.map((a) => ({
+            filename: a.filename,
+            content: (typeof a.content === "string" ? Buffer.from(a.content, "utf8") : Buffer.from(a.content)).toString("base64"),
+            ...a.contentType && { contentType: a.contentType },
+            ...a.cid && { cid: a.cid }
+          }))
+        },
+        ...message.metadata && { metadata: message.metadata },
+        ...message.tags && { tags: message.tags },
+        relayoMessageId: context.messageId
+      };
+      let response;
+      try {
+        response = await doFetch(`${baseUrl}/v1/messages`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${options.apiKey}`, "Content-Type": "application/json" },
+          body: JSON.stringify(body),
+          signal: AbortSignal.timeout(options.timeoutMs ?? 3e4)
+        });
+      } catch (error) {
+        throw new import_core.ProviderUnavailableError(`Relayo Sim request failed: ${error.message}`, { provider: name, cause: error });
+      }
+      if (!response.ok) throw await errorFromResponse(response, name);
+      const { id } = await response.json();
+      const result = { messageId: context.messageId, provider: name, status: "queued" };
+      if (id) result.providerMessageId = id;
+      return result;
+    },
+    verifyWebhook(req) {
+      if (webhook.verifySignature === false) return true;
+      if (!webhook.secret) {
+        throw new import_core.ValidationError(
+          `Driver "${name}" has no webhook.secret; add the project's webhook secret or set webhook.verifySignature to false`,
+          { provider: name }
+        );
+      }
+      return verifySimulatorSignature(req, webhook.secret, webhook.toleranceSeconds ?? 300);
+    },
+    parseWebhook(req) {
+      const event = readBody(req);
+      if (!event || typeof event.type !== "string" || typeof event.id !== "string") {
+        throw new import_core.ValidationError("Unrecognized Relayo Sim webhook payload", { provider: name, raw: event });
+      }
+      return [{ ...event, timestamp: new Date(event.timestamp) }];
+    }
+  };
+}
+function scenarioAddress(scenario, param, domain = DEFAULT_DOMAIN) {
+  return `${scenario}${param !== void 0 ? `+${param}` : ""}@${domain}`;
+}
+function verifySimulatorSignature(req, secret, toleranceSeconds = 300) {
+  const header = Object.entries(req.headers).find(([k]) => k.toLowerCase() === SIGNATURE_HEADER)?.[1];
+  const value = Array.isArray(header) ? header[0] : header;
+  if (!value || req.rawBody === void 0) return false;
+  const parts = Object.fromEntries(value.split(",").map((p) => p.split("=")));
+  const timestamp = Number(parts.t);
+  if (!timestamp || !parts.v1) return false;
+  if (toleranceSeconds > 0 && Math.abs(Date.now() / 1e3 - timestamp) > toleranceSeconds) return false;
+  const body = typeof req.rawBody === "string" ? req.rawBody : Buffer.from(req.rawBody).toString("utf8");
+  const expected = (0, import_node_crypto.createHmac)("sha256", secret).update(`${timestamp}.${body}`).digest();
+  const given = Buffer.from(parts.v1, "hex");
+  return given.length === expected.length && (0, import_node_crypto.timingSafeEqual)(given, expected);
+}
+async function errorFromResponse(response, provider) {
+  const body = await response.json().catch(() => ({}));
+  const detail = Array.isArray(body.message) ? body.message.join("; ") : body.message ?? response.statusText;
+  const message = `Relayo Sim ${response.status}: ${detail}`;
+  const options = { provider, raw: { status: response.status, message: detail } };
+  if (response.status === 401 || response.status === 403) return new import_core.AuthenticationError(message, options);
+  if (response.status === 429) return new import_core.RateLimitError(message, options);
+  if (response.status >= 500) return new import_core.ProviderUnavailableError(message, options);
+  return new import_core.ValidationError(message, options);
+}
+function readBody(req) {
+  const source = req.rawBody ?? req.body;
+  if (typeof source === "string") return JSON.parse(source);
+  if (source instanceof Uint8Array) return JSON.parse(Buffer.from(source).toString("utf8"));
+  return source;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_DOMAIN,
+  SIGNATURE_HEADER,
+  scenarioAddress,
+  simulator,
+  verifySimulatorSignature
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/simulator.ts"],"sourcesContent":["export { DEFAULT_DOMAIN, scenarioAddress, SIGNATURE_HEADER, simulator, verifySimulatorSignature } from './simulator.js';\nexport type { SimulatorDriverOptions, SimulatorWebhookOptions } from './simulator.js';\n","import { createHmac, timingSafeEqual } from 'node:crypto';\nimport {\n  AuthenticationError,\n  ProviderUnavailableError,\n  RateLimitError,\n  ValidationError,\n  type Driver,\n  type EmailMessage,\n  type RelayoError,\n  type RelayoEvent,\n  type SendResult,\n  type WebhookRequest,\n} from '@alimzen/core';\n\nexport const SIGNATURE_HEADER = 'relayo-signature';\nexport const DEFAULT_DOMAIN = 'sim.relayo.dev';\n\nexport interface SimulatorWebhookOptions {\n  /** The project's webhook secret (`whsec_...`). */\n  secret?: string;\n  /** Set to false to accept unsigned webhooks. Default true. */\n  verifySignature?: boolean;\n  /** Reject signatures older than this many seconds. Default 300; `0` turns the check off. */\n  toleranceSeconds?: number;\n}\n\nexport interface SimulatorDriverOptions {\n  /** Project API key (`sim_live_...`). */\n  apiKey: string;\n  /** Base URL of the Relayo Sim API, e.g. `http://localhost:3000`. */\n  baseUrl: string;\n  timeoutMs?: number;\n  /** Provider name reported in results and errors. Defaults to `\"simulator\"`. */\n  name?: string;\n  webhook?: SimulatorWebhookOptions;\n  fetch?: typeof fetch;\n}\n\n/**\n * Relayo Sim driver: a drop-in replacement for your real provider in tests and CI. Send to scenario\n * addresses (see `scenarioAddress`) and the simulator plays the scenario back as Relayo events through\n * your webhook: bounces, deferrals, complaints, opens, clicks...\n */\nexport function simulator(options: SimulatorDriverOptions): Driver<EmailMessage> {\n  if (!options.apiKey) throw new ValidationError('simulator() needs an apiKey');\n  if (!options.baseUrl) throw new ValidationError('simulator() needs the baseUrl of your Relayo Sim');\n  const name = options.name ?? 'simulator';\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const webhook = options.webhook ?? {};\n\n  return {\n    name,\n    channel: 'email',\n    capabilities: { batch: false, attachments: true, scheduling: false, tracking: true, webhooks: true },\n\n    async send(message, context) {\n      const to = Array.isArray(message.to) ? message.to : [message.to];\n      const body = {\n        from: message.from,\n        to,\n        ...(message.cc && { cc: message.cc }),\n        ...(message.bcc && { bcc: message.bcc }),\n        ...(message.replyTo && { replyTo: message.replyTo }),\n        subject: message.subject,\n        ...(message.html !== undefined && { html: message.html }),\n        ...(message.text !== undefined && { text: message.text }),\n        ...(message.headers && { headers: message.headers }),\n        ...(message.attachments?.length && {\n          attachments: message.attachments.map((a) => ({\n            filename: a.filename,\n            content: (typeof a.content === 'string' ? Buffer.from(a.content, 'utf8') : Buffer.from(a.content)).toString('base64'),\n            ...(a.contentType && { contentType: a.contentType }),\n            ...(a.cid && { cid: a.cid }),\n          })),\n        }),\n        ...(message.metadata && { metadata: message.metadata }),\n        ...(message.tags && { tags: message.tags }),\n        relayoMessageId: context.messageId,\n      };\n\n      let response: Response;\n      try {\n        response = await doFetch(`${baseUrl}/v1/messages`, {\n          method: 'POST',\n          headers: { Authorization: `Bearer ${options.apiKey}`, 'Content-Type': 'application/json' },\n          body: JSON.stringify(body),\n          signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),\n        });\n      } catch (error) {\n        throw new ProviderUnavailableError(`Relayo Sim request failed: ${(error as Error).message}`, { provider: name, cause: error });\n      }\n      if (!response.ok) throw await errorFromResponse(response, name);\n\n      const { id } = (await response.json()) as { id: string };\n      const result: SendResult = { messageId: context.messageId, provider: name, status: 'queued' };\n      if (id) result.providerMessageId = id;\n      return result;\n    },\n\n    verifyWebhook(req) {\n      if (webhook.verifySignature === false) return true;\n      if (!webhook.secret) {\n        throw new ValidationError(\n          `Driver \"${name}\" has no webhook.secret; add the project's webhook secret or set webhook.verifySignature to false`,\n          { provider: name },\n        );\n      }\n      return verifySimulatorSignature(req, webhook.secret, webhook.toleranceSeconds ?? 300);\n    },\n\n    parseWebhook(req) {\n      const event = readBody(req) as RelayoEvent;\n      if (!event || typeof event.type !== 'string' || typeof event.id !== 'string') {\n        throw new ValidationError('Unrecognized Relayo Sim webhook payload', { provider: name, raw: event });\n      }\n      // The simulator already sends normalized Relayo events.\n      return [{ ...event, timestamp: new Date(event.timestamp) }];\n    },\n  };\n}\n\n/** `scenarioAddress('greylist', 3)` → `greylist+3@sim.relayo.dev`. */\nexport function scenarioAddress(scenario: string, param?: string | number, domain = DEFAULT_DOMAIN): string {\n  return `${scenario}${param !== undefined ? `+${param}` : ''}@${domain}`;\n}\n\n/** Checks `Relayo-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"t.body\">`. */\nexport function verifySimulatorSignature(req: WebhookRequest, secret: string, toleranceSeconds = 300): boolean {\n  const header = Object.entries(req.headers).find(([k]) => k.toLowerCase() === SIGNATURE_HEADER)?.[1];\n  const value = Array.isArray(header) ? header[0] : header;\n  if (!value || req.rawBody === undefined) return false;\n  const parts = Object.fromEntries(value.split(',').map((p) => p.split('=') as [string, string]));\n  const timestamp = Number(parts.t);\n  if (!timestamp || !parts.v1) return false;\n  if (toleranceSeconds > 0 && Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;\n\n  const body = typeof req.rawBody === 'string' ? req.rawBody : Buffer.from(req.rawBody).toString('utf8');\n  const expected = createHmac('sha256', secret).update(`${timestamp}.${body}`).digest();\n  const given = Buffer.from(parts.v1, 'hex');\n  return given.length === expected.length && timingSafeEqual(given, expected);\n}\n\nasync function errorFromResponse(response: Response, provider: string): Promise<RelayoError> {\n  const body = (await response.json().catch(() => ({}))) as { message?: string | string[] };\n  const detail = Array.isArray(body.message) ? body.message.join('; ') : (body.message ?? response.statusText);\n  const message = `Relayo Sim ${response.status}: ${detail}`;\n  const options = { provider, raw: { status: response.status, message: detail } };\n  if (response.status === 401 || response.status === 403) return new AuthenticationError(message, options);\n  if (response.status === 429) return new RateLimitError(message, options);\n  if (response.status >= 500) return new ProviderUnavailableError(message, options);\n  return new ValidationError(message, options);\n}\n\nfunction readBody(req: WebhookRequest): unknown {\n  const source = req.rawBody ?? req.body;\n  if (typeof source === 'string') return JSON.parse(source);\n  if (source instanceof Uint8Array) return JSON.parse(Buffer.from(source).toString('utf8'));\n  return source;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA4C;AAC5C,kBAWO;AAEA,IAAM,mBAAmB;AACzB,IAAM,iBAAiB;AA4BvB,SAAS,UAAU,SAAuD;AAC/E,MAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,4BAAgB,6BAA6B;AAC5E,MAAI,CAAC,QAAQ,QAAS,OAAM,IAAI,4BAAgB,kDAAkD;AAClG,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AACjD,QAAM,UAAU,QAAQ,SAAS,WAAW;AAC5C,QAAM,UAAU,QAAQ,WAAW,CAAC;AAEpC,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT,cAAc,EAAE,OAAO,OAAO,aAAa,MAAM,YAAY,OAAO,UAAU,MAAM,UAAU,KAAK;AAAA,IAEnG,MAAM,KAAK,SAAS,SAAS;AAC3B,YAAM,KAAK,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,KAAK,CAAC,QAAQ,EAAE;AAC/D,YAAM,OAAO;AAAA,QACX,MAAM,QAAQ;AAAA,QACd;AAAA,QACA,GAAI,QAAQ,MAAM,EAAE,IAAI,QAAQ,GAAG;AAAA,QACnC,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,IAAI;AAAA,QACtC,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,QAClD,SAAS,QAAQ;AAAA,QACjB,GAAI,QAAQ,SAAS,UAAa,EAAE,MAAM,QAAQ,KAAK;AAAA,QACvD,GAAI,QAAQ,SAAS,UAAa,EAAE,MAAM,QAAQ,KAAK;AAAA,QACvD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,QAClD,GAAI,QAAQ,aAAa,UAAU;AAAA,UACjC,aAAa,QAAQ,YAAY,IAAI,CAAC,OAAO;AAAA,YAC3C,UAAU,EAAE;AAAA,YACZ,UAAU,OAAO,EAAE,YAAY,WAAW,OAAO,KAAK,EAAE,SAAS,MAAM,IAAI,OAAO,KAAK,EAAE,OAAO,GAAG,SAAS,QAAQ;AAAA,YACpH,GAAI,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY;AAAA,YAClD,GAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI;AAAA,UAC5B,EAAE;AAAA,QACJ;AAAA,QACA,GAAI,QAAQ,YAAY,EAAE,UAAU,QAAQ,SAAS;AAAA,QACrD,GAAI,QAAQ,QAAQ,EAAE,MAAM,QAAQ,KAAK;AAAA,QACzC,iBAAiB,QAAQ;AAAA,MAC3B;AAEA,UAAI;AACJ,UAAI;AACF,mBAAW,MAAM,QAAQ,GAAG,OAAO,gBAAgB;AAAA,UACjD,QAAQ;AAAA,UACR,SAAS,EAAE,eAAe,UAAU,QAAQ,MAAM,IAAI,gBAAgB,mBAAmB;AAAA,UACzF,MAAM,KAAK,UAAU,IAAI;AAAA,UACzB,QAAQ,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,QACzD,CAAC;AAAA,MACH,SAAS,OAAO;AACd,cAAM,IAAI,qCAAyB,8BAA+B,MAAgB,OAAO,IAAI,EAAE,UAAU,MAAM,OAAO,MAAM,CAAC;AAAA,MAC/H;AACA,UAAI,CAAC,SAAS,GAAI,OAAM,MAAM,kBAAkB,UAAU,IAAI;AAE9D,YAAM,EAAE,GAAG,IAAK,MAAM,SAAS,KAAK;AACpC,YAAM,SAAqB,EAAE,WAAW,QAAQ,WAAW,UAAU,MAAM,QAAQ,SAAS;AAC5F,UAAI,GAAI,QAAO,oBAAoB;AACnC,aAAO;AAAA,IACT;AAAA,IAEA,cAAc,KAAK;AACjB,UAAI,QAAQ,oBAAoB,MAAO,QAAO;AAC9C,UAAI,CAAC,QAAQ,QAAQ;AACnB,cAAM,IAAI;AAAA,UACR,WAAW,IAAI;AAAA,UACf,EAAE,UAAU,KAAK;AAAA,QACnB;AAAA,MACF;AACA,aAAO,yBAAyB,KAAK,QAAQ,QAAQ,QAAQ,oBAAoB,GAAG;AAAA,IACtF;AAAA,IAEA,aAAa,KAAK;AAChB,YAAM,QAAQ,SAAS,GAAG;AAC1B,UAAI,CAAC,SAAS,OAAO,MAAM,SAAS,YAAY,OAAO,MAAM,OAAO,UAAU;AAC5E,cAAM,IAAI,4BAAgB,2CAA2C,EAAE,UAAU,MAAM,KAAK,MAAM,CAAC;AAAA,MACrG;AAEA,aAAO,CAAC,EAAE,GAAG,OAAO,WAAW,IAAI,KAAK,MAAM,SAAS,EAAE,CAAC;AAAA,IAC5D;AAAA,EACF;AACF;AAGO,SAAS,gBAAgB,UAAkB,OAAyB,SAAS,gBAAwB;AAC1G,SAAO,GAAG,QAAQ,GAAG,UAAU,SAAY,IAAI,KAAK,KAAK,EAAE,IAAI,MAAM;AACvE;AAGO,SAAS,yBAAyB,KAAqB,QAAgB,mBAAmB,KAAc;AAC7G,QAAM,SAAS,OAAO,QAAQ,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,MAAM,gBAAgB,IAAI,CAAC;AAClG,QAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,OAAO,CAAC,IAAI;AAClD,MAAI,CAAC,SAAS,IAAI,YAAY,OAAW,QAAO;AAChD,QAAM,QAAQ,OAAO,YAAY,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,CAAqB,CAAC;AAC9F,QAAM,YAAY,OAAO,MAAM,CAAC;AAChC,MAAI,CAAC,aAAa,CAAC,MAAM,GAAI,QAAO;AACpC,MAAI,mBAAmB,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,MAAO,SAAS,IAAI,iBAAkB,QAAO;AAE/F,QAAM,OAAO,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU,OAAO,KAAK,IAAI,OAAO,EAAE,SAAS,MAAM;AACrG,QAAM,eAAW,+BAAW,UAAU,MAAM,EAAE,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,EAAE,OAAO;AACpF,QAAM,QAAQ,OAAO,KAAK,MAAM,IAAI,KAAK;AACzC,SAAO,MAAM,WAAW,SAAS,cAAU,oCAAgB,OAAO,QAAQ;AAC5E;AAEA,eAAe,kBAAkB,UAAoB,UAAwC;AAC3F,QAAM,OAAQ,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACpD,QAAM,SAAS,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,QAAQ,KAAK,IAAI,IAAK,KAAK,WAAW,SAAS;AACjG,QAAM,UAAU,cAAc,SAAS,MAAM,KAAK,MAAM;AACxD,QAAM,UAAU,EAAE,UAAU,KAAK,EAAE,QAAQ,SAAS,QAAQ,SAAS,OAAO,EAAE;AAC9E,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO,IAAI,gCAAoB,SAAS,OAAO;AACvG,MAAI,SAAS,WAAW,IAAK,QAAO,IAAI,2BAAe,SAAS,OAAO;AACvE,MAAI,SAAS,UAAU,IAAK,QAAO,IAAI,qCAAyB,SAAS,OAAO;AAChF,SAAO,IAAI,4BAAgB,SAAS,OAAO;AAC7C;AAEA,SAAS,SAAS,KAA8B;AAC9C,QAAM,SAAS,IAAI,WAAW,IAAI;AAClC,MAAI,OAAO,WAAW,SAAU,QAAO,KAAK,MAAM,MAAM;AACxD,MAAI,kBAAkB,WAAY,QAAO,KAAK,MAAM,OAAO,KAAK,MAAM,EAAE,SAAS,MAAM,CAAC;AACxF,SAAO;AACT;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { Driver, EmailMessage, WebhookRequest } from '@alimzen/core';
+
+declare const SIGNATURE_HEADER = "relayo-signature";
+declare const DEFAULT_DOMAIN = "sim.relayo.dev";
+interface SimulatorWebhookOptions {
+    /** The project's webhook secret (`whsec_...`). */
+    secret?: string;
+    /** Set to false to accept unsigned webhooks. Default true. */
+    verifySignature?: boolean;
+    /** Reject signatures older than this many seconds. Default 300; `0` turns the check off. */
+    toleranceSeconds?: number;
+}
+interface SimulatorDriverOptions {
+    /** Project API key (`sim_live_...`). */
+    apiKey: string;
+    /** Base URL of the Relayo Sim API, e.g. `http://localhost:3000`. */
+    baseUrl: string;
+    timeoutMs?: number;
+    /** Provider name reported in results and errors. Defaults to `"simulator"`. */
+    name?: string;
+    webhook?: SimulatorWebhookOptions;
+    fetch?: typeof fetch;
+}
+/**
+ * Relayo Sim driver: a drop-in replacement for your real provider in tests and CI. Send to scenario
+ * addresses (see `scenarioAddress`) and the simulator plays the scenario back as Relayo events through
+ * your webhook: bounces, deferrals, complaints, opens, clicks...
+ */
+declare function simulator(options: SimulatorDriverOptions): Driver<EmailMessage>;
+/** `scenarioAddress('greylist', 3)` → `greylist+3@sim.relayo.dev`. */
+declare function scenarioAddress(scenario: string, param?: string | number, domain?: string): string;
+/** Checks `Relayo-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "t.body">`. */
+declare function verifySimulatorSignature(req: WebhookRequest, secret: string, toleranceSeconds?: number): boolean;
+
+export { DEFAULT_DOMAIN, SIGNATURE_HEADER, type SimulatorDriverOptions, type SimulatorWebhookOptions, scenarioAddress, simulator, verifySimulatorSignature };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { Driver, EmailMessage, WebhookRequest } from '@alimzen/core';
+
+declare const SIGNATURE_HEADER = "relayo-signature";
+declare const DEFAULT_DOMAIN = "sim.relayo.dev";
+interface SimulatorWebhookOptions {
+    /** The project's webhook secret (`whsec_...`). */
+    secret?: string;
+    /** Set to false to accept unsigned webhooks. Default true. */
+    verifySignature?: boolean;
+    /** Reject signatures older than this many seconds. Default 300; `0` turns the check off. */
+    toleranceSeconds?: number;
+}
+interface SimulatorDriverOptions {
+    /** Project API key (`sim_live_...`). */
+    apiKey: string;
+    /** Base URL of the Relayo Sim API, e.g. `http://localhost:3000`. */
+    baseUrl: string;
+    timeoutMs?: number;
+    /** Provider name reported in results and errors. Defaults to `"simulator"`. */
+    name?: string;
+    webhook?: SimulatorWebhookOptions;
+    fetch?: typeof fetch;
+}
+/**
+ * Relayo Sim driver: a drop-in replacement for your real provider in tests and CI. Send to scenario
+ * addresses (see `scenarioAddress`) and the simulator plays the scenario back as Relayo events through
+ * your webhook: bounces, deferrals, complaints, opens, clicks...
+ */
+declare function simulator(options: SimulatorDriverOptions): Driver<EmailMessage>;
+/** `scenarioAddress('greylist', 3)` → `greylist+3@sim.relayo.dev`. */
+declare function scenarioAddress(scenario: string, param?: string | number, domain?: string): string;
+/** Checks `Relayo-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "t.body">`. */
+declare function verifySimulatorSignature(req: WebhookRequest, secret: string, toleranceSeconds?: number): boolean;
+
+export { DEFAULT_DOMAIN, SIGNATURE_HEADER, type SimulatorDriverOptions, type SimulatorWebhookOptions, scenarioAddress, simulator, verifySimulatorSignature };

package/dist/index.js

@@ -0,0 +1,121 @@
+// src/simulator.ts
+import { createHmac, timingSafeEqual } from "crypto";
+import {
+  AuthenticationError,
+  ProviderUnavailableError,
+  RateLimitError,
+  ValidationError
+} from "@alimzen/core";
+var SIGNATURE_HEADER = "relayo-signature";
+var DEFAULT_DOMAIN = "sim.relayo.dev";
+function simulator(options) {
+  if (!options.apiKey) throw new ValidationError("simulator() needs an apiKey");
+  if (!options.baseUrl) throw new ValidationError("simulator() needs the baseUrl of your Relayo Sim");
+  const name = options.name ?? "simulator";
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const webhook = options.webhook ?? {};
+  return {
+    name,
+    channel: "email",
+    capabilities: { batch: false, attachments: true, scheduling: false, tracking: true, webhooks: true },
+    async send(message, context) {
+      const to = Array.isArray(message.to) ? message.to : [message.to];
+      const body = {
+        from: message.from,
+        to,
+        ...message.cc && { cc: message.cc },
+        ...message.bcc && { bcc: message.bcc },
+        ...message.replyTo && { replyTo: message.replyTo },
+        subject: message.subject,
+        ...message.html !== void 0 && { html: message.html },
+        ...message.text !== void 0 && { text: message.text },
+        ...message.headers && { headers: message.headers },
+        ...message.attachments?.length && {
+          attachments: message.attachments.map((a) => ({
+            filename: a.filename,
+            content: (typeof a.content === "string" ? Buffer.from(a.content, "utf8") : Buffer.from(a.content)).toString("base64"),
+            ...a.contentType && { contentType: a.contentType },
+            ...a.cid && { cid: a.cid }
+          }))
+        },
+        ...message.metadata && { metadata: message.metadata },
+        ...message.tags && { tags: message.tags },
+        relayoMessageId: context.messageId
+      };
+      let response;
+      try {
+        response = await doFetch(`${baseUrl}/v1/messages`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${options.apiKey}`, "Content-Type": "application/json" },
+          body: JSON.stringify(body),
+          signal: AbortSignal.timeout(options.timeoutMs ?? 3e4)
+        });
+      } catch (error) {
+        throw new ProviderUnavailableError(`Relayo Sim request failed: ${error.message}`, { provider: name, cause: error });
+      }
+      if (!response.ok) throw await errorFromResponse(response, name);
+      const { id } = await response.json();
+      const result = { messageId: context.messageId, provider: name, status: "queued" };
+      if (id) result.providerMessageId = id;
+      return result;
+    },
+    verifyWebhook(req) {
+      if (webhook.verifySignature === false) return true;
+      if (!webhook.secret) {
+        throw new ValidationError(
+          `Driver "${name}" has no webhook.secret; add the project's webhook secret or set webhook.verifySignature to false`,
+          { provider: name }
+        );
+      }
+      return verifySimulatorSignature(req, webhook.secret, webhook.toleranceSeconds ?? 300);
+    },
+    parseWebhook(req) {
+      const event = readBody(req);
+      if (!event || typeof event.type !== "string" || typeof event.id !== "string") {
+        throw new ValidationError("Unrecognized Relayo Sim webhook payload", { provider: name, raw: event });
+      }
+      return [{ ...event, timestamp: new Date(event.timestamp) }];
+    }
+  };
+}
+function scenarioAddress(scenario, param, domain = DEFAULT_DOMAIN) {
+  return `${scenario}${param !== void 0 ? `+${param}` : ""}@${domain}`;
+}
+function verifySimulatorSignature(req, secret, toleranceSeconds = 300) {
+  const header = Object.entries(req.headers).find(([k]) => k.toLowerCase() === SIGNATURE_HEADER)?.[1];
+  const value = Array.isArray(header) ? header[0] : header;
+  if (!value || req.rawBody === void 0) return false;
+  const parts = Object.fromEntries(value.split(",").map((p) => p.split("=")));
+  const timestamp = Number(parts.t);
+  if (!timestamp || !parts.v1) return false;
+  if (toleranceSeconds > 0 && Math.abs(Date.now() / 1e3 - timestamp) > toleranceSeconds) return false;
+  const body = typeof req.rawBody === "string" ? req.rawBody : Buffer.from(req.rawBody).toString("utf8");
+  const expected = createHmac("sha256", secret).update(`${timestamp}.${body}`).digest();
+  const given = Buffer.from(parts.v1, "hex");
+  return given.length === expected.length && timingSafeEqual(given, expected);
+}
+async function errorFromResponse(response, provider) {
+  const body = await response.json().catch(() => ({}));
+  const detail = Array.isArray(body.message) ? body.message.join("; ") : body.message ?? response.statusText;
+  const message = `Relayo Sim ${response.status}: ${detail}`;
+  const options = { provider, raw: { status: response.status, message: detail } };
+  if (response.status === 401 || response.status === 403) return new AuthenticationError(message, options);
+  if (response.status === 429) return new RateLimitError(message, options);
+  if (response.status >= 500) return new ProviderUnavailableError(message, options);
+  return new ValidationError(message, options);
+}
+function readBody(req) {
+  const source = req.rawBody ?? req.body;
+  if (typeof source === "string") return JSON.parse(source);
+  if (source instanceof Uint8Array) return JSON.parse(Buffer.from(source).toString("utf8"));
+  return source;
+}
+export {
+  DEFAULT_DOMAIN,
+  SIGNATURE_HEADER,
+  scenarioAddress,
+  simulator,
+  verifySimulatorSignature
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/simulator.ts"],"sourcesContent":["import { createHmac, timingSafeEqual } from 'node:crypto';\nimport {\n  AuthenticationError,\n  ProviderUnavailableError,\n  RateLimitError,\n  ValidationError,\n  type Driver,\n  type EmailMessage,\n  type RelayoError,\n  type RelayoEvent,\n  type SendResult,\n  type WebhookRequest,\n} from '@alimzen/core';\n\nexport const SIGNATURE_HEADER = 'relayo-signature';\nexport const DEFAULT_DOMAIN = 'sim.relayo.dev';\n\nexport interface SimulatorWebhookOptions {\n  /** The project's webhook secret (`whsec_...`). */\n  secret?: string;\n  /** Set to false to accept unsigned webhooks. Default true. */\n  verifySignature?: boolean;\n  /** Reject signatures older than this many seconds. Default 300; `0` turns the check off. */\n  toleranceSeconds?: number;\n}\n\nexport interface SimulatorDriverOptions {\n  /** Project API key (`sim_live_...`). */\n  apiKey: string;\n  /** Base URL of the Relayo Sim API, e.g. `http://localhost:3000`. */\n  baseUrl: string;\n  timeoutMs?: number;\n  /** Provider name reported in results and errors. Defaults to `\"simulator\"`. */\n  name?: string;\n  webhook?: SimulatorWebhookOptions;\n  fetch?: typeof fetch;\n}\n\n/**\n * Relayo Sim driver: a drop-in replacement for your real provider in tests and CI. Send to scenario\n * addresses (see `scenarioAddress`) and the simulator plays the scenario back as Relayo events through\n * your webhook: bounces, deferrals, complaints, opens, clicks...\n */\nexport function simulator(options: SimulatorDriverOptions): Driver<EmailMessage> {\n  if (!options.apiKey) throw new ValidationError('simulator() needs an apiKey');\n  if (!options.baseUrl) throw new ValidationError('simulator() needs the baseUrl of your Relayo Sim');\n  const name = options.name ?? 'simulator';\n  const baseUrl = options.baseUrl.replace(/\\/$/, '');\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const webhook = options.webhook ?? {};\n\n  return {\n    name,\n    channel: 'email',\n    capabilities: { batch: false, attachments: true, scheduling: false, tracking: true, webhooks: true },\n\n    async send(message, context) {\n      const to = Array.isArray(message.to) ? message.to : [message.to];\n      const body = {\n        from: message.from,\n        to,\n        ...(message.cc && { cc: message.cc }),\n        ...(message.bcc && { bcc: message.bcc }),\n        ...(message.replyTo && { replyTo: message.replyTo }),\n        subject: message.subject,\n        ...(message.html !== undefined && { html: message.html }),\n        ...(message.text !== undefined && { text: message.text }),\n        ...(message.headers && { headers: message.headers }),\n        ...(message.attachments?.length && {\n          attachments: message.attachments.map((a) => ({\n            filename: a.filename,\n            content: (typeof a.content === 'string' ? Buffer.from(a.content, 'utf8') : Buffer.from(a.content)).toString('base64'),\n            ...(a.contentType && { contentType: a.contentType }),\n            ...(a.cid && { cid: a.cid }),\n          })),\n        }),\n        ...(message.metadata && { metadata: message.metadata }),\n        ...(message.tags && { tags: message.tags }),\n        relayoMessageId: context.messageId,\n      };\n\n      let response: Response;\n      try {\n        response = await doFetch(`${baseUrl}/v1/messages`, {\n          method: 'POST',\n          headers: { Authorization: `Bearer ${options.apiKey}`, 'Content-Type': 'application/json' },\n          body: JSON.stringify(body),\n          signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),\n        });\n      } catch (error) {\n        throw new ProviderUnavailableError(`Relayo Sim request failed: ${(error as Error).message}`, { provider: name, cause: error });\n      }\n      if (!response.ok) throw await errorFromResponse(response, name);\n\n      const { id } = (await response.json()) as { id: string };\n      const result: SendResult = { messageId: context.messageId, provider: name, status: 'queued' };\n      if (id) result.providerMessageId = id;\n      return result;\n    },\n\n    verifyWebhook(req) {\n      if (webhook.verifySignature === false) return true;\n      if (!webhook.secret) {\n        throw new ValidationError(\n          `Driver \"${name}\" has no webhook.secret; add the project's webhook secret or set webhook.verifySignature to false`,\n          { provider: name },\n        );\n      }\n      return verifySimulatorSignature(req, webhook.secret, webhook.toleranceSeconds ?? 300);\n    },\n\n    parseWebhook(req) {\n      const event = readBody(req) as RelayoEvent;\n      if (!event || typeof event.type !== 'string' || typeof event.id !== 'string') {\n        throw new ValidationError('Unrecognized Relayo Sim webhook payload', { provider: name, raw: event });\n      }\n      // The simulator already sends normalized Relayo events.\n      return [{ ...event, timestamp: new Date(event.timestamp) }];\n    },\n  };\n}\n\n/** `scenarioAddress('greylist', 3)` → `greylist+3@sim.relayo.dev`. */\nexport function scenarioAddress(scenario: string, param?: string | number, domain = DEFAULT_DOMAIN): string {\n  return `${scenario}${param !== undefined ? `+${param}` : ''}@${domain}`;\n}\n\n/** Checks `Relayo-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"t.body\">`. */\nexport function verifySimulatorSignature(req: WebhookRequest, secret: string, toleranceSeconds = 300): boolean {\n  const header = Object.entries(req.headers).find(([k]) => k.toLowerCase() === SIGNATURE_HEADER)?.[1];\n  const value = Array.isArray(header) ? header[0] : header;\n  if (!value || req.rawBody === undefined) return false;\n  const parts = Object.fromEntries(value.split(',').map((p) => p.split('=') as [string, string]));\n  const timestamp = Number(parts.t);\n  if (!timestamp || !parts.v1) return false;\n  if (toleranceSeconds > 0 && Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;\n\n  const body = typeof req.rawBody === 'string' ? req.rawBody : Buffer.from(req.rawBody).toString('utf8');\n  const expected = createHmac('sha256', secret).update(`${timestamp}.${body}`).digest();\n  const given = Buffer.from(parts.v1, 'hex');\n  return given.length === expected.length && timingSafeEqual(given, expected);\n}\n\nasync function errorFromResponse(response: Response, provider: string): Promise<RelayoError> {\n  const body = (await response.json().catch(() => ({}))) as { message?: string | string[] };\n  const detail = Array.isArray(body.message) ? body.message.join('; ') : (body.message ?? response.statusText);\n  const message = `Relayo Sim ${response.status}: ${detail}`;\n  const options = { provider, raw: { status: response.status, message: detail } };\n  if (response.status === 401 || response.status === 403) return new AuthenticationError(message, options);\n  if (response.status === 429) return new RateLimitError(message, options);\n  if (response.status >= 500) return new ProviderUnavailableError(message, options);\n  return new ValidationError(message, options);\n}\n\nfunction readBody(req: WebhookRequest): unknown {\n  const source = req.rawBody ?? req.body;\n  if (typeof source === 'string') return JSON.parse(source);\n  if (source instanceof Uint8Array) return JSON.parse(Buffer.from(source).toString('utf8'));\n  return source;\n}\n"],"mappings":";AAAA,SAAS,YAAY,uBAAuB;AAC5C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AAEA,IAAM,mBAAmB;AACzB,IAAM,iBAAiB;AA4BvB,SAAS,UAAU,SAAuD;AAC/E,MAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,gBAAgB,6BAA6B;AAC5E,MAAI,CAAC,QAAQ,QAAS,OAAM,IAAI,gBAAgB,kDAAkD;AAClG,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,UAAU,QAAQ,QAAQ,QAAQ,OAAO,EAAE;AACjD,QAAM,UAAU,QAAQ,SAAS,WAAW;AAC5C,QAAM,UAAU,QAAQ,WAAW,CAAC;AAEpC,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT,cAAc,EAAE,OAAO,OAAO,aAAa,MAAM,YAAY,OAAO,UAAU,MAAM,UAAU,KAAK;AAAA,IAEnG,MAAM,KAAK,SAAS,SAAS;AAC3B,YAAM,KAAK,MAAM,QAAQ,QAAQ,EAAE,IAAI,QAAQ,KAAK,CAAC,QAAQ,EAAE;AAC/D,YAAM,OAAO;AAAA,QACX,MAAM,QAAQ;AAAA,QACd;AAAA,QACA,GAAI,QAAQ,MAAM,EAAE,IAAI,QAAQ,GAAG;AAAA,QACnC,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,IAAI;AAAA,QACtC,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,QAClD,SAAS,QAAQ;AAAA,QACjB,GAAI,QAAQ,SAAS,UAAa,EAAE,MAAM,QAAQ,KAAK;AAAA,QACvD,GAAI,QAAQ,SAAS,UAAa,EAAE,MAAM,QAAQ,KAAK;AAAA,QACvD,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,QAClD,GAAI,QAAQ,aAAa,UAAU;AAAA,UACjC,aAAa,QAAQ,YAAY,IAAI,CAAC,OAAO;AAAA,YAC3C,UAAU,EAAE;AAAA,YACZ,UAAU,OAAO,EAAE,YAAY,WAAW,OAAO,KAAK,EAAE,SAAS,MAAM,IAAI,OAAO,KAAK,EAAE,OAAO,GAAG,SAAS,QAAQ;AAAA,YACpH,GAAI,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY;AAAA,YAClD,GAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI;AAAA,UAC5B,EAAE;AAAA,QACJ;AAAA,QACA,GAAI,QAAQ,YAAY,EAAE,UAAU,QAAQ,SAAS;AAAA,QACrD,GAAI,QAAQ,QAAQ,EAAE,MAAM,QAAQ,KAAK;AAAA,QACzC,iBAAiB,QAAQ;AAAA,MAC3B;AAEA,UAAI;AACJ,UAAI;AACF,mBAAW,MAAM,QAAQ,GAAG,OAAO,gBAAgB;AAAA,UACjD,QAAQ;AAAA,UACR,SAAS,EAAE,eAAe,UAAU,QAAQ,MAAM,IAAI,gBAAgB,mBAAmB;AAAA,UACzF,MAAM,KAAK,UAAU,IAAI;AAAA,UACzB,QAAQ,YAAY,QAAQ,QAAQ,aAAa,GAAM;AAAA,QACzD,CAAC;AAAA,MACH,SAAS,OAAO;AACd,cAAM,IAAI,yBAAyB,8BAA+B,MAAgB,OAAO,IAAI,EAAE,UAAU,MAAM,OAAO,MAAM,CAAC;AAAA,MAC/H;AACA,UAAI,CAAC,SAAS,GAAI,OAAM,MAAM,kBAAkB,UAAU,IAAI;AAE9D,YAAM,EAAE,GAAG,IAAK,MAAM,SAAS,KAAK;AACpC,YAAM,SAAqB,EAAE,WAAW,QAAQ,WAAW,UAAU,MAAM,QAAQ,SAAS;AAC5F,UAAI,GAAI,QAAO,oBAAoB;AACnC,aAAO;AAAA,IACT;AAAA,IAEA,cAAc,KAAK;AACjB,UAAI,QAAQ,oBAAoB,MAAO,QAAO;AAC9C,UAAI,CAAC,QAAQ,QAAQ;AACnB,cAAM,IAAI;AAAA,UACR,WAAW,IAAI;AAAA,UACf,EAAE,UAAU,KAAK;AAAA,QACnB;AAAA,MACF;AACA,aAAO,yBAAyB,KAAK,QAAQ,QAAQ,QAAQ,oBAAoB,GAAG;AAAA,IACtF;AAAA,IAEA,aAAa,KAAK;AAChB,YAAM,QAAQ,SAAS,GAAG;AAC1B,UAAI,CAAC,SAAS,OAAO,MAAM,SAAS,YAAY,OAAO,MAAM,OAAO,UAAU;AAC5E,cAAM,IAAI,gBAAgB,2CAA2C,EAAE,UAAU,MAAM,KAAK,MAAM,CAAC;AAAA,MACrG;AAEA,aAAO,CAAC,EAAE,GAAG,OAAO,WAAW,IAAI,KAAK,MAAM,SAAS,EAAE,CAAC;AAAA,IAC5D;AAAA,EACF;AACF;AAGO,SAAS,gBAAgB,UAAkB,OAAyB,SAAS,gBAAwB;AAC1G,SAAO,GAAG,QAAQ,GAAG,UAAU,SAAY,IAAI,KAAK,KAAK,EAAE,IAAI,MAAM;AACvE;AAGO,SAAS,yBAAyB,KAAqB,QAAgB,mBAAmB,KAAc;AAC7G,QAAM,SAAS,OAAO,QAAQ,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,MAAM,gBAAgB,IAAI,CAAC;AAClG,QAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,OAAO,CAAC,IAAI;AAClD,MAAI,CAAC,SAAS,IAAI,YAAY,OAAW,QAAO;AAChD,QAAM,QAAQ,OAAO,YAAY,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,CAAqB,CAAC;AAC9F,QAAM,YAAY,OAAO,MAAM,CAAC;AAChC,MAAI,CAAC,aAAa,CAAC,MAAM,GAAI,QAAO;AACpC,MAAI,mBAAmB,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,MAAO,SAAS,IAAI,iBAAkB,QAAO;AAE/F,QAAM,OAAO,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU,OAAO,KAAK,IAAI,OAAO,EAAE,SAAS,MAAM;AACrG,QAAM,WAAW,WAAW,UAAU,MAAM,EAAE,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,EAAE,OAAO;AACpF,QAAM,QAAQ,OAAO,KAAK,MAAM,IAAI,KAAK;AACzC,SAAO,MAAM,WAAW,SAAS,UAAU,gBAAgB,OAAO,QAAQ;AAC5E;AAEA,eAAe,kBAAkB,UAAoB,UAAwC;AAC3F,QAAM,OAAQ,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACpD,QAAM,SAAS,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,QAAQ,KAAK,IAAI,IAAK,KAAK,WAAW,SAAS;AACjG,QAAM,UAAU,cAAc,SAAS,MAAM,KAAK,MAAM;AACxD,QAAM,UAAU,EAAE,UAAU,KAAK,EAAE,QAAQ,SAAS,QAAQ,SAAS,OAAO,EAAE;AAC9E,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,IAAK,QAAO,IAAI,oBAAoB,SAAS,OAAO;AACvG,MAAI,SAAS,WAAW,IAAK,QAAO,IAAI,eAAe,SAAS,OAAO;AACvE,MAAI,SAAS,UAAU,IAAK,QAAO,IAAI,yBAAyB,SAAS,OAAO;AAChF,SAAO,IAAI,gBAAgB,SAAS,OAAO;AAC7C;AAEA,SAAS,SAAS,KAA8B;AAC9C,QAAM,SAAS,IAAI,WAAW,IAAI;AAClC,MAAI,OAAO,WAAW,SAAU,QAAO,KAAK,MAAM,MAAM;AACxD,MAAI,kBAAkB,WAAY,QAAO,KAAK,MAAM,OAAO,KAAK,MAAM,EAAE,SAAS,MAAM,CAAC;AACxF,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@alimzen/simulator",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Relayo Sim driver: send to the delivery simulator and get realistic bounces, deferrals, complaints and more as Relayo events.",
+  "license": "MIT",
+  "author": "Alimzen",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Alimzen/relayo.git",
+    "directory": "packages/simulator"
+  },
+  "homepage": "https://github.com/Alimzen/relayo/tree/main/packages/simulator#readme",
+  "bugs": {
+    "url": "https://github.com/Alimzen/relayo/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "relayo",
+    "simulator",
+    "testing",
+    "email",
+    "bounces",
+    "ci"
+  ],
+  "peerDependencies": {
+    "@alimzen/core": ">=0.1.0 <1.0.0"
+  },
+  "devDependencies": {
+    "@alimzen/core": "^0.2.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
 }