@shivaedev/email 0.1.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.3.0 - 2026-11-03
+
+### Breaking
+
+- Move `inbox`, `emailLink` and `ReceivedEmail` from `@shivaedev/email/server/testing/adapters/inbox.ts` to `@shivaedev/test-kits/email/adapters/inbox.ts`. Add test-kits as a development dependency. Email no longer has a test-story peer dependency.
+
+## 0.2.0 - 2026-11-03
+
+### Breaking
+
+- Queue definitions returned by `defineEmailQueue` expose jobs-owned queue and worker options. Import `QueueOptions` from `@shivaedev/jobs/server/queueOptions.ts` and `WorkerOptions` from `@shivaedev/jobs/server/workerOptions.ts` for explicit annotations.
+
 ## 0.1.2 - 2026-11-02
 
 ### Changed

package/README.md

@@ -56,7 +56,7 @@ The email worker sends its job id as Resend's idempotency key on every attempt.
 
 ### 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.
+Install `@shivaedev/test-kits` as a development dependency. In a scoped story setup, acquire `inbox()` from `@shivaedev/test-kits/email/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.
 

package/dist/server/defineEmailQueue.d.ts

@@ -11,7 +11,8 @@ declare function makeEmailQueue<TSchema extends JobPayloadSchema, E, R, const TN
     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;
+        readonly id?: undefined;
+        readonly key?: undefined;
     };
     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}`>>;

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

@@ -1 +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"}
+{"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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shivaedev/email",
-  "version": "0.1.2",
-  "description": "Transactional email with Resend, durable Effect jobs and story inboxes",
+  "version": "0.3.0",
+  "description": "Transactional email with Resend and durable Effect jobs",
   "keywords": [
     "effect"
   ],
@@ -45,30 +45,25 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@shivaedev/http": "0.4.0",
-    "@shivaedev/jobs": "0.30.0",
+    "@shivaedev/http": "0.5.0",
+    "@shivaedev/jobs": "0.32.0",
     "@shivaedev/service": "0.6.1",
     "resend": "6.34.1"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.6",
-    "@shivaedev/quality": "0.56.0",
-    "@shivaedev/test-sql": "0.16.2",
-    "@shivaedev/test-story": "0.34.0",
+    "@shivaedev/quality": "0.57.1",
+    "@shivaedev/test-kits": "0.1.0",
+    "@shivaedev/test-sql": "0.18.0",
+    "@shivaedev/test-story": "0.36.0",
     "@types/node": "24.19.2",
     "effect": "4.0.6",
     "typescript": "7.0.2",
     "vitest": "5.0.5"
   },
   "peerDependencies": {
-    "@shivaedev/test-story": "0.34.0",
     "effect": "4.0.6"
   },
-  "peerDependenciesMeta": {
-    "@shivaedev/test-story": {
-      "optional": true
-    }
-  },
   "engines": {
     "node": ">=24"
   },

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

@@ -1,25 +0,0 @@
-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: {
-        completed: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
-        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;
-        received: import("effect/Stream").Stream<import("@shivaedev/test-story/server/fakeHttpService.ts").FakeHttpRequestRecord, never, never>;
-        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

@@ -1 +0,0 @@
-{"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

@@ -1,39 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/src/server/testing/adapters/inbox.ts

@@ -1,44 +0,0 @@
-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;
-}