@shivaedev/email 0.0.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 0.1.1 - 2026-11-02
+
+### Changed
+
+- Update `@shivaedev/http` from 0.3.1 to 0.4.0.
+- Update `@shivaedev/jobs` from 0.29.1 to 0.29.2.
+- Update `@shivaedev/service` from 0.6.0 to 0.6.1.
+- Update `@shivaedev/test-story` from 0.32.0 to 0.33.0.
+
+## 0.1.0 - 2026-11-01
+
+### Added
+
+- Send transactional email through a Resend-backed Mailer or development log, with typed message queues, job-id idempotency, backoff and provider-timed rate-limit retries.
+- Read delivered messages and one-time links through a fake Resend inbox in stories.
+- Include the email package in Platform for applications, including the starter's queued authentication emails.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShivaeDev
+
+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,69 @@
 # @shivaedev/email
 
-Placeholder. The package is published from https://github.com/ShivaeDev/platform.
+Send transactional email through Resend with the same Effect services and durable jobs as the rest of your application. Share the delivery machinery once, and let each feature describe its own messages.
+
+## Why you want this
+
+Confirmation and password reset emails need more than an HTTP call: a durable payload, rendering, retries, idempotency and an inbox a story can read. Define those messages once and enqueue them from the web process:
+
+```ts
+import { Effect, Redacted, Schema } from "effect";
+import { defineEmailQueue } from "@shivaedev/email/server/defineEmailQueue.ts";
+
+const Confirmation = defineEmailQueue(Schema.Struct({ to: Schema.String, url: Schema.Redacted(Schema.String) }), ({ to, url }) =>
+	Effect.succeed({
+		from: "Accounts <accounts@example.com>",
+		to,
+		subject: "Confirm your account",
+		text: `Confirm your account: ${Redacted.value(url)}`,
+		html: `<p>Confirm your account</p>`,
+	}),
+);
+
+const confirm = Confirmation.enqueue({
+	to: "alice@example.com",
+	url: Redacted.make("https://example.com/confirm?token=one-time-token"),
+});
+```
+
+## Using it
+
+### Describe a message and render it
+
+`defineEmailQueue(schema, render, options?)` accepts an object Schema or an object union, and an Effect renderer returning `Email` from `@shivaedev/email/Email.ts`: `from`, `to`, `subject`, `text` and `html`. The optional `name` defaults to `transactional-email`; give separate queues distinct names. The renderer can read application services. Escape application values when interpolating them into HTML.
+
+Use `Schema.Redacted(Schema.String)` for one-time links and keep them wrapped until rendering. The jobs codec durably stores the value and restores its Redacted wrapper in the worker. Redaction masks diagnostics; it does not encrypt PostgreSQL storage.
+
+### Compose the web process and worker
+
+The returned `producerLayer` registers the queue without running a worker or requiring a mailer. `enqueue(message)` reads its `Jobs` service and returns the native optional job id. `queue`, `worker` and `Jobs` remain available for native jobs composition and diagnostics.
+
+Provide `producerLayer` to the web process and `workerLayer` to the worker process. Both read the scoped `PgBoss` client provided by `pgBossLayer` from `@shivaedev/jobs/server/service.ts`. Install the jobs schema through that package's migration path.
+
+```ts
+import { Layer } from "effect";
+import { resendMailerLayer } from "@shivaedev/email/server/adapters/resendMailerLayer.ts";
+import { logMailerLayer } from "@shivaedev/email/server/Mailer.ts";
+
+const producer = Confirmation.producerLayer;
+const worker = Confirmation.workerLayer.pipe(Layer.provide(resendMailerLayer()));
+const developmentWorker = Confirmation.workerLayer.pipe(Layer.provide(logMailerLayer));
+```
+
+`Mailer` is a service defined through `@shivaedev/service`. Its `send(email, idempotencyKey)` method reports typed `MailerError` or native jobs `RetryAt` failures. `resendMailerLayer()` reads `RESEND_API_KEY` with `Config.Redacted`; its options accept an already redacted `apiKey` for scoped configuration. `logMailerLayer` writes the rendered message and key to the development log instead of sending it. The jobs redactor masks sensitive URL parameters in worker logs.
+
+The email worker sends its job id as Resend's idempotency key on every attempt. Ordinary failures retry with the jobs engine's exponential backoff. A Resend 429 uses `Retry-After` seconds or HTTP date as a native timed deferral without consuming an ordinary retry; a missing or invalid header uses a short timed fallback. `MailerError` keeps the provider response redacted and uses a fixed message in recorded failures.
+
+### Read email in stories
+
+Install `@shivaedev/test-story` as a development dependency. In a scoped story setup, acquire `inbox()` from `@shivaedev/email/server/testing/adapters/inbox.ts` and provide its `mailerLayer` to the real worker. It uses the Resend SDK against a loopback fake HTTP endpoint.
+
+`nextEmail` waits for the next accepted message, including its `idempotencyKey`; `emails()` reads accepted messages so far. `emailLink(email)` reads the first HTTP link in the message's text. A story can follow that link through the application's HTTP or React boundary. The inbox's `endpoint` exposes the native fake HTTP controls for scripting provider failures.
+
+### Install and limits
+
+```sh
+pnpm add @shivaedev/email effect
+```
+
+Resend is the only delivery provider and is included as a regular dependency. The jobs package requires PostgreSQL. Delivery uses Resend's idempotency window; the package does not promise permanent exactly-once delivery. Application policy owns expiring links and retaining queued messages.

package/dist/Email.d.ts

@@ -0,0 +1,10 @@
+import { Schema } from "effect";
+export declare const Email: Schema.Struct<{
+    readonly from: Schema.String;
+    readonly html: Schema.String;
+    readonly subject: Schema.String;
+    readonly text: Schema.String;
+    readonly to: Schema.String;
+}>;
+export type Email = typeof Email.Type;
+//# sourceMappingURL=Email.d.ts.map

package/dist/Email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Email.d.ts","sourceRoot":"","sources":["../src/Email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,KAAK;;;;;;EAMhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC"}

package/dist/Email.js

@@ -0,0 +1,9 @@
+import { Schema } from "effect";
+export const Email = Schema.Struct({
+    from: Schema.String,
+    html: Schema.String,
+    subject: Schema.String,
+    text: Schema.String,
+    to: Schema.String,
+});
+//# sourceMappingURL=Email.js.map

package/dist/Email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Email.js","sourceRoot":"","sources":["../src/Email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC,MAAM;CACjB,CAAC,CAAC"}

package/dist/server/Mailer.d.ts

@@ -0,0 +1,16 @@
+import { Effect } from "effect";
+import type { RetryAt } from "@shivaedev/jobs/server/definition.ts";
+import type { MailerError } from "./MailerError.ts";
+export declare const Mailer: import("effect/Context").Service<"@shivaedev/email/Mailer", Readonly<{
+    readonly send: (email: {
+        readonly from: string;
+        readonly html: string;
+        readonly subject: string;
+        readonly text: string;
+        readonly to: string;
+    }, idempotencyKey: string) => Effect.Effect<void, MailerError | RetryAt, never>;
+}>> & {
+    readonly layer: import("effect/Layer").Layer<"@shivaedev/email/Mailer", never, never>;
+};
+export declare const logMailerLayer: import("effect/Layer").Layer<"@shivaedev/email/Mailer", never, never>;
+//# sourceMappingURL=Mailer.d.ts.map

package/dist/server/Mailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailer.d.ts","sourceRoot":"","sources":["../../src/server/Mailer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,MAAM;;;;;;;;;;CAOjB,CAAC;AAEH,eAAO,MAAM,cAAc,uEAAe,CAAC"}

package/dist/server/Mailer.js

@@ -0,0 +1,12 @@
+import { Effect } from "effect";
+import { defineService } from "@shivaedev/service/defineService.ts";
+export const Mailer = defineService({
+    id: "@shivaedev/email/Mailer",
+    initialize: Effect.void,
+    methods: () => ({
+        send: (email, idempotencyKey) => Effect.logInfo("Email", { ...email, idempotencyKey }),
+    }),
+    requires: [],
+});
+export const logMailerLayer = Mailer.layer;
+//# sourceMappingURL=Mailer.js.map

package/dist/server/Mailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailer.js","sourceRoot":"","sources":["../../src/server/Mailer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAIpE,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;IACnC,EAAE,EAAE,yBAAyB;IAC7B,UAAU,EAAE,MAAM,CAAC,IAAI;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACf,IAAI,EAAE,CAAC,KAAY,EAAE,cAAsB,EAA8C,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,CAAC;KACjJ,CAAC;IACF,QAAQ,EAAE,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC"}

package/dist/server/MailerError.d.ts

@@ -0,0 +1,10 @@
+import { Schema } from "effect";
+declare const MailerError_base: Schema.Class<MailerError, Schema.TaggedStruct<"MailerError", {
+    readonly original: Schema.Redacted<Schema.Unknown>;
+    readonly status: Schema.optionalKey<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+export declare class MailerError extends MailerError_base {
+    get message(): string;
+}
+export {};
+//# sourceMappingURL=MailerError.d.ts.map

package/dist/server/MailerError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailerError.d.ts","sourceRoot":"","sources":["../../src/server/MailerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,qBAAa,WAAY,SAAQ,gBAG/B;IACD,IAAa,OAAO,WAEnB;CACD"}

package/dist/server/MailerError.js

@@ -0,0 +1,10 @@
+import { Schema } from "effect";
+export class MailerError extends Schema.TaggedError()("MailerError", {
+    original: Schema.Redacted(Schema.Unknown),
+    status: Schema.optionalKey(Schema.Number),
+}) {
+    get message() {
+        return "Resend could not deliver the email";
+    }
+}
+//# sourceMappingURL=MailerError.js.map

package/dist/server/MailerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailerError.js","sourceRoot":"","sources":["../../src/server/MailerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,OAAO,WAAY,SAAQ,MAAM,CAAC,WAAW,EAAe,CAAC,aAAa,EAAE;IACjF,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;CACzC,CAAC;IACD,IAAa,OAAO;QACnB,OAAO,oCAAoC,CAAC;IAC7C,CAAC;CACD"}

package/dist/server/adapters/resendMailerLayer.d.ts

@@ -0,0 +1,5 @@
+import { Config, Layer, Redacted } from "effect";
+export declare function resendMailerLayer(options?: {
+    readonly apiKey?: Redacted.Redacted<string>;
+}): Layer.Layer<"@shivaedev/email/Mailer", Config.ConfigError, never>;
+//# sourceMappingURL=resendMailerLayer.d.ts.map

package/dist/server/adapters/resendMailerLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resendMailerLayer.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/resendMailerLayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoB,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAQnE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;CAAO,qEAS9F"}

package/dist/server/adapters/resendMailerLayer.js

@@ -0,0 +1,39 @@
+import { Config, DateTime, Effect, Layer, Redacted } from "effect";
+import { Resend } from "resend";
+import { parseRetryAfter } from "@shivaedev/http/parseRetryAfter.ts";
+import { RetryAt } from "@shivaedev/jobs/server/definition.ts";
+import { Mailer } from "#server/Mailer.ts";
+import { MailerError } from "#server/MailerError.ts";
+export function resendMailerLayer(options = {}) {
+    return Layer.effect(Mailer, Effect.gen(function* () {
+        const apiKey = options.apiKey ?? (yield* Config.Redacted("RESEND_API_KEY"));
+        const resend = new Resend(Redacted.value(apiKey));
+        return { send: sendEmail(resend) };
+    }));
+}
+function sendEmail(resend) {
+    return (email, idempotencyKey) => Effect.gen(function* () {
+        const response = yield* Effect.tryPromise({
+            catch: (original) => new MailerError({ original: Redacted.make(original) }),
+            try: (signal) => {
+                const request = { idempotencyKey, signal };
+                return resend.emails.send(email, request);
+            },
+        });
+        if (response.error === null) {
+            return;
+        }
+        if (response.error.statusCode === 429) {
+            const now = yield* DateTime.now;
+            return yield* new RetryAt({
+                at: parseRetryAfter(response.headers?.["retry-after"], now) ?? DateTime.add(now, { seconds: 1 }),
+                reason: "Resend rate limit",
+            });
+        }
+        return yield* new MailerError({
+            original: Redacted.make(response.error),
+            ...(response.error.statusCode === null ? {} : { status: response.error.statusCode }),
+        });
+    });
+}
+//# sourceMappingURL=resendMailerLayer.js.map

package/dist/server/adapters/resendMailerLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resendMailerLayer.js","sourceRoot":"","sources":["../../../src/server/adapters/resendMailerLayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAoD,EAAE;IAC9F,OAAO,KAAK,CAAC,MAAM,CAClB,MAAM,EACN,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IACpC,CAAC,CAAC,CACF,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAChC,OAAO,CAAC,KAAY,EAAE,cAAsB,EAAE,EAAE,CAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACzC,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3E,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;gBACf,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;gBAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC;SACD,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO;QACR,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAChC,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC;gBACzB,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBAChG,MAAM,EAAE,mBAAmB;aAC3B,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC;YAC7B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;SACpF,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/defineEmailQueue.d.ts

@@ -0,0 +1,20 @@
+import { Effect, type Schema } from "effect";
+import { type JobPayloadSchema } from "@shivaedev/jobs/server/definition.ts";
+import type { Email } from "#Email.ts";
+type Render<TSchema extends JobPayloadSchema, E, R> = (message: Schema.Schema.Type<TSchema>) => Effect.Effect<Email, E, R>;
+export declare function defineEmailQueue<const TSchema extends JobPayloadSchema, E, R>(schema: TSchema, render: Render<TSchema, E, R>): ReturnType<typeof makeEmailQueue<TSchema, E, R, "transactional-email">>;
+export declare function defineEmailQueue<const TSchema extends JobPayloadSchema, E, R, const TName extends string>(schema: TSchema, render: Render<TSchema, E, R>, options: {
+    readonly name: TName;
+}): ReturnType<typeof makeEmailQueue<TSchema, E, R, TName>>;
+declare function makeEmailQueue<TSchema extends JobPayloadSchema, E, R, const TName extends string>(schema: TSchema, render: Render<TSchema, E, R>, name: TName): {
+    enqueue: (message: Schema.Schema.Type<TSchema>) => Effect.Effect<import("effect/Option").Option<string>, import("@shivaedev/jobs/server/error.ts").PgBossError | import("@shivaedev/jobs/server/error.ts").PgBossPayloadError, `@shivaedev/email/${TName}` | TSchema["EncodingServices"]>;
+    Jobs: import("@shivaedev/jobs/server/service.ts").PgBossDefinition<`@shivaedev/email/${TName}`>;
+    producerLayer: import("effect/Layer").Layer<`@shivaedev/email/${TName}`, import("@shivaedev/jobs/server/error.ts").PgBossError | import("@shivaedev/jobs/server/error.ts").PgBossQueueNamesError | import("@shivaedev/jobs/server/error.ts").PgBossQueueOptionsError, import("@shivaedev/jobs/server/PgBoss.ts").PgBoss>;
+    queue: import("@shivaedev/jobs/server/definition.ts").QueueDefinition<TName, TSchema> & {
+        readonly key?: never;
+    };
+    worker: import("@shivaedev/jobs/server/definition.ts").QueueWorker<TSchema, "@shivaedev/email/Mailer" | R>;
+    workerLayer: import("effect/Layer").Layer<`@shivaedev/email/${TName}`, import("@shivaedev/jobs/server/error.ts").PgBossError | import("@shivaedev/jobs/server/error.ts").PgBossQueueNamesError | import("@shivaedev/jobs/server/error.ts").PgBossQueueOptionsError, import("@shivaedev/jobs/server/PgBoss.ts").PgBoss | Exclude<"@shivaedev/email/Mailer", `@shivaedev/email/${TName}`> | Exclude<R, `@shivaedev/email/${TName}`> | Exclude<TSchema["DecodingServices"], `@shivaedev/email/${TName}`>>;
+};
+export {};
+//# sourceMappingURL=defineEmailQueue.d.ts.map

package/dist/server/defineEmailQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEmailQueue.d.ts","sourceRoot":"","sources":["../../src/server/defineEmailQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE1F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGvC,KAAK,MAAM,CAAC,OAAO,SAAS,gBAAgB,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3H,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,OAAO,SAAS,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAC5E,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,GAC3B,UAAU,CAAC,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,OAAO,SAAS,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,SAAS,MAAM,EACxG,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC7B,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GAC/B,UAAU,CAAC,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAS3D,iBAAS,cAAc,CAAC,OAAO,SAAS,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,SAAS,MAAM,EACzF,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC7B,IAAI,EAAE,KAAK;uBAgBS,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;;;;;;;;EAO/C"}

package/dist/server/defineEmailQueue.js

@@ -0,0 +1,29 @@
+import { Effect } from "effect";
+import { defineQueue } from "@shivaedev/jobs/server/definition.ts";
+import { makePgBoss } from "@shivaedev/jobs/server/service.ts";
+import { Mailer } from "./Mailer.js";
+export function defineEmailQueue(schema, render, options) {
+    return makeEmailQueue(schema, render, options?.name ?? "transactional-email");
+}
+function makeEmailQueue(schema, render, name) {
+    const queue = defineQueue({
+        name,
+        queue: { retryBackoff: true, retryDelay: 30, retryLimit: 3 },
+        schema,
+    });
+    const Jobs = makePgBoss(`@shivaedev/email/${name}`);
+    const worker = queue.handle((message, job) => Effect.gen(function* () {
+        const email = yield* render(message);
+        const mailer = yield* Mailer;
+        yield* mailer.send(email, job.id);
+    }));
+    return {
+        enqueue: (message) => Effect.flatMap(Jobs, (jobs) => jobs.enqueue(queue, message)),
+        Jobs,
+        producerLayer: Jobs.layer({ jobs: [queue] }),
+        queue,
+        worker,
+        workerLayer: Jobs.layer({ jobs: [worker] }),
+    };
+}
+//# sourceMappingURL=defineEmailQueue.js.map

package/dist/server/defineEmailQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEmailQueue.js","sourceRoot":"","sources":["../../src/server/defineEmailQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAyB,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAarC,MAAM,UAAU,gBAAgB,CAC/B,MAAe,EACf,MAA6B,EAC7B,OAAmC;IAEnC,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,qBAAqB,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,cAAc,CACtB,MAAe,EACf,MAA6B,EAC7B,IAAW;IAEX,MAAM,KAAK,GAAG,WAAW,CAAC;QACzB,IAAI;QACJ,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE;QAC5D,MAAM;KACN,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,UAAU,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAC5C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;QAC7B,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CACF,CAAC;IACF,OAAO;QACN,OAAO,EAAE,CAAC,OAAoC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/G,IAAI;QACJ,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,KAAK;QACL,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KAC3C,CAAC;AACH,CAAC"}

package/dist/server/testing/adapters/inbox.d.ts

@@ -0,0 +1,23 @@
+import { Effect } from "effect";
+import { Email } from "#Email.ts";
+export interface ReceivedEmail extends Email {
+    readonly idempotencyKey: string | undefined;
+}
+export declare const inbox: () => Effect.Effect<{
+    emails: () => Effect.Effect<ReceivedEmail[], never, never>;
+    endpoint: {
+        fault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
+        hold: (route: string, holdOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpHoldOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpHold, never, never>;
+        narrate: (sink: (line: string) => void) => void;
+        releaseOnArrival: (route: string, arrival: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<void, never, never>;
+        readonly requests: readonly import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord[];
+        scriptFault: (route: string, fault: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpFault, scriptOptions?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScriptOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScript, never, never>;
+        stall: (route: string, scope?: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpScope) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpHold, never, never>;
+        untilAbandoned: (matches: (request: import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord) => boolean, wait: import("@shivaedev/test-story/server/until.ts").UntilOptions) => Effect.Effect<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, import("@shivaedev/test-story/server/until.ts").SignalNotReceived, never>;
+        url: string;
+    };
+    mailerLayer: import("effect/Layer").Layer<"@shivaedev/email/Mailer", import("effect/Config").ConfigError, never>;
+    nextEmail: Effect.Effect<ReceivedEmail, import("effect/Cause").TimeoutError, never>;
+}, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
+export declare function emailLink(email: Email): string;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/server/testing/adapters/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../../../src/server/testing/adapters/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA2B,MAAM,QAAQ,CAAC;AAGzD,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;qEAyBhB,CAAC;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAM9C"}

package/dist/server/testing/adapters/inbox.js

@@ -0,0 +1,39 @@
+import { Effect, Queue, Redacted, Schema } from "effect";
+import { fakeHttpService } from "@shivaedev/test-story/server/fakeHttpService.ts";
+import { routeOutbound } from "@shivaedev/test-story/server/routeOutbound.ts";
+import { Email } from "#Email.ts";
+import { resendMailerLayer } from "#server/adapters/resendMailerLayer.ts";
+export const inbox = Effect.fnUntraced(function* () {
+    const arrivals = yield* Queue.unbounded();
+    const emails = [];
+    const decode = Schema.decodeUnknownSync(Schema.fromJsonString(Email));
+    const endpoint = yield* fakeHttpService({
+        routes: {
+            send: {
+                method: "POST",
+                path: "/emails",
+                reply: (request) => {
+                    const email = { ...decode(request.body.toString()), idempotencyKey: request.headers["idempotency-key"]?.toString() };
+                    emails.push(email);
+                    Queue.offerUnsafe(arrivals, email);
+                    return { body: { id: `email-${emails.length}` } };
+                },
+            },
+        },
+    });
+    yield* routeOutbound({ "api.resend.com": endpoint.url });
+    return {
+        emails: () => Effect.sync(() => [...emails]),
+        endpoint,
+        mailerLayer: resendMailerLayer({ apiKey: Redacted.make("re_story") }),
+        nextEmail: Queue.take(arrivals).pipe(Effect.timeout("10 seconds")),
+    };
+});
+export function emailLink(email) {
+    const link = email.text.match(/https?:\/\/[^\s<>]+/u)?.[0];
+    if (link === undefined) {
+        throw new Error("The delivered email has no link in its text");
+    }
+    return link;
+}
+//# sourceMappingURL=inbox.js.map

package/dist/server/testing/adapters/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../../src/server/testing/adapters/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAM1E,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAiB,CAAC;IACzD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;QACvC,MAAM,EAAE;YACP,IAAI,EAAE;gBACL,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;oBAClB,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC;oBACrH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnB,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBACnC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;gBACnD,CAAC;aACD;SACD;KACD,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,OAAO;QACN,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QAC5C,QAAQ;QACR,WAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;KAClE,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,KAAY;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/package.json

@@ -1,11 +1,85 @@
 {
   "name": "@shivaedev/email",
-  "version": "0.0.0",
-  "description": "Placeholder for the ShivaeDev email package.",
-  "license": "MIT",
+  "version": "0.1.1",
+  "description": "Transactional email with Resend, durable Effect jobs and story inboxes",
+  "keywords": [
+    "effect"
+  ],
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/email#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShivaeDev/platform.git",
     "directory": "packages/email"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#test/*": "./src/test-support/*",
+    "#*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "exports": {
+    "./*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "README.md",
+    "!src/**/test-support",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@shivaedev/http": "0.4.0",
+    "@shivaedev/jobs": "0.29.2",
+    "@shivaedev/service": "0.6.1",
+    "resend": "6.34.1"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.6",
+    "@shivaedev/quality": "0.55.0",
+    "@shivaedev/test-sql": "0.16.1",
+    "@shivaedev/test-story": "0.33.0",
+    "@types/node": "24.19.2",
+    "effect": "4.0.6",
+    "typescript": "7.0.2",
+    "vitest": "5.0.5"
+  },
+  "peerDependencies": {
+    "@shivaedev/test-story": "0.33.0",
+    "effect": "4.0.6"
+  },
+  "peerDependenciesMeta": {
+    "@shivaedev/test-story": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc --project tsconfig.build.json",
+    "ready": "pnpm typecheck && pnpm test && pnpm build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/Email.ts

@@ -0,0 +1,10 @@
+import { Schema } from "effect";
+
+export const Email = Schema.Struct({
+	from: Schema.String,
+	html: Schema.String,
+	subject: Schema.String,
+	text: Schema.String,
+	to: Schema.String,
+});
+export type Email = typeof Email.Type;

package/src/server/Mailer.ts

@@ -0,0 +1,16 @@
+import { Effect } from "effect";
+import type { RetryAt } from "@shivaedev/jobs/server/definition.ts";
+import { defineService } from "@shivaedev/service/defineService.ts";
+import type { Email } from "#Email.ts";
+import type { MailerError } from "./MailerError.ts";
+
+export const Mailer = defineService({
+	id: "@shivaedev/email/Mailer",
+	initialize: Effect.void,
+	methods: () => ({
+		send: (email: Email, idempotencyKey: string): Effect.Effect<void, MailerError | RetryAt> => Effect.logInfo("Email", { ...email, idempotencyKey }),
+	}),
+	requires: [],
+});
+
+export const logMailerLayer = Mailer.layer;

package/src/server/MailerError.ts

@@ -0,0 +1,10 @@
+import { Schema } from "effect";
+
+export class MailerError extends Schema.TaggedError<MailerError>()("MailerError", {
+	original: Schema.Redacted(Schema.Unknown),
+	status: Schema.optionalKey(Schema.Number),
+}) {
+	override get message() {
+		return "Resend could not deliver the email";
+	}
+}

package/src/server/adapters/resendMailerLayer.ts

@@ -0,0 +1,45 @@
+import { Config, DateTime, Effect, Layer, Redacted } from "effect";
+import { Resend } from "resend";
+import { parseRetryAfter } from "@shivaedev/http/parseRetryAfter.ts";
+import { RetryAt } from "@shivaedev/jobs/server/definition.ts";
+import type { Email } from "#Email.ts";
+import { Mailer } from "#server/Mailer.ts";
+import { MailerError } from "#server/MailerError.ts";
+
+export function resendMailerLayer(options: { readonly apiKey?: Redacted.Redacted<string> } = {}) {
+	return Layer.effect(
+		Mailer,
+		Effect.gen(function* () {
+			const apiKey = options.apiKey ?? (yield* Config.Redacted("RESEND_API_KEY"));
+			const resend = new Resend(Redacted.value(apiKey));
+			return { send: sendEmail(resend) };
+		}),
+	);
+}
+
+function sendEmail(resend: Resend) {
+	return (email: Email, idempotencyKey: string) =>
+		Effect.gen(function* () {
+			const response = yield* Effect.tryPromise({
+				catch: (original) => new MailerError({ original: Redacted.make(original) }),
+				try: (signal) => {
+					const request = { idempotencyKey, signal };
+					return resend.emails.send(email, request);
+				},
+			});
+			if (response.error === null) {
+				return;
+			}
+			if (response.error.statusCode === 429) {
+				const now = yield* DateTime.now;
+				return yield* new RetryAt({
+					at: parseRetryAfter(response.headers?.["retry-after"], now) ?? DateTime.add(now, { seconds: 1 }),
+					reason: "Resend rate limit",
+				});
+			}
+			return yield* new MailerError({
+				original: Redacted.make(response.error),
+				...(response.error.statusCode === null ? {} : { status: response.error.statusCode }),
+			});
+		});
+}

package/src/server/defineEmailQueue.ts

@@ -0,0 +1,52 @@
+import { Effect, type Schema } from "effect";
+import { defineQueue, type JobPayloadSchema } from "@shivaedev/jobs/server/definition.ts";
+import { makePgBoss } from "@shivaedev/jobs/server/service.ts";
+import type { Email } from "#Email.ts";
+import { Mailer } from "./Mailer.ts";
+
+type Render<TSchema extends JobPayloadSchema, E, R> = (message: Schema.Schema.Type<TSchema>) => Effect.Effect<Email, E, R>;
+
+export function defineEmailQueue<const TSchema extends JobPayloadSchema, E, R>(
+	schema: TSchema,
+	render: Render<TSchema, E, R>,
+): ReturnType<typeof makeEmailQueue<TSchema, E, R, "transactional-email">>;
+export function defineEmailQueue<const TSchema extends JobPayloadSchema, E, R, const TName extends string>(
+	schema: TSchema,
+	render: Render<TSchema, E, R>,
+	options: { readonly name: TName },
+): ReturnType<typeof makeEmailQueue<TSchema, E, R, TName>>;
+export function defineEmailQueue<TSchema extends JobPayloadSchema, E, R>(
+	schema: TSchema,
+	render: Render<TSchema, E, R>,
+	options?: { readonly name: string },
+): unknown {
+	return makeEmailQueue(schema, render, options?.name ?? "transactional-email");
+}
+
+function makeEmailQueue<TSchema extends JobPayloadSchema, E, R, const TName extends string>(
+	schema: TSchema,
+	render: Render<TSchema, E, R>,
+	name: TName,
+) {
+	const queue = defineQueue({
+		name,
+		queue: { retryBackoff: true, retryDelay: 30, retryLimit: 3 },
+		schema,
+	});
+	const Jobs = makePgBoss(`@shivaedev/email/${name}`);
+	const worker = queue.handle((message, job) =>
+		Effect.gen(function* () {
+			const email = yield* render(message);
+			const mailer = yield* Mailer;
+			yield* mailer.send(email, job.id);
+		}),
+	);
+	return {
+		enqueue: (message: Schema.Schema.Type<TSchema>) => Effect.flatMap(Jobs, (jobs) => jobs.enqueue(queue, message)),
+		Jobs,
+		producerLayer: Jobs.layer({ jobs: [queue] }),
+		queue,
+		worker,
+		workerLayer: Jobs.layer({ jobs: [worker] }),
+	};
+}

package/src/server/testing/adapters/inbox.ts

@@ -0,0 +1,44 @@
+import { Effect, Queue, Redacted, Schema } from "effect";
+import { fakeHttpService } from "@shivaedev/test-story/server/fakeHttpService.ts";
+import { routeOutbound } from "@shivaedev/test-story/server/routeOutbound.ts";
+import { Email } from "#Email.ts";
+import { resendMailerLayer } from "#server/adapters/resendMailerLayer.ts";
+
+export interface ReceivedEmail extends Email {
+	readonly idempotencyKey: string | undefined;
+}
+
+export const inbox = Effect.fnUntraced(function* () {
+	const arrivals = yield* Queue.unbounded<ReceivedEmail>();
+	const emails: ReceivedEmail[] = [];
+	const decode = Schema.decodeUnknownSync(Schema.fromJsonString(Email));
+	const endpoint = yield* fakeHttpService({
+		routes: {
+			send: {
+				method: "POST",
+				path: "/emails",
+				reply: (request) => {
+					const email = { ...decode(request.body.toString()), idempotencyKey: request.headers["idempotency-key"]?.toString() };
+					emails.push(email);
+					Queue.offerUnsafe(arrivals, email);
+					return { body: { id: `email-${emails.length}` } };
+				},
+			},
+		},
+	});
+	yield* routeOutbound({ "api.resend.com": endpoint.url });
+	return {
+		emails: () => Effect.sync(() => [...emails]),
+		endpoint,
+		mailerLayer: resendMailerLayer({ apiKey: Redacted.make("re_story") }),
+		nextEmail: Queue.take(arrivals).pipe(Effect.timeout("10 seconds")),
+	};
+});
+
+export function emailLink(email: Email): string {
+	const link = email.text.match(/https?:\/\/[^\s<>]+/u)?.[0];
+	if (link === undefined) {
+		throw new Error("The delivered email has no link in its text");
+	}
+	return link;
+}