@krizaka/mail 0.0.0-stage → 0.1.1

package/dist/testkit.js

@@ -0,0 +1,67 @@
+import {
+  SUPPRESSION_REASON,
+  hashAddress
+} from "./chunk-YDSARDFP.js";
+
+// src/testkit.ts
+import { expect, it } from "vitest";
+var T0 = /* @__PURE__ */ new Date("2026-10-26T12:00:00.000Z");
+var day = (n) => new Date(T0.valueOf() + n * 24 * 3600 * 1e3);
+var entry = (over = {}) => ({ at: T0, template: "reset", category: "transactional", locale: "fr", to: hashAddress("a@b.co"), status: "sent", ...over });
+function mailStoreContract(name, make) {
+  it(`${name}: suppresses an address once, keeps the first reason, and lifts it`, async () => {
+    const store = await make();
+    const h = hashAddress("A@B.co");
+    expect(await store.isSuppressed(h)).toBe(false);
+    expect(await store.suppress(h, SUPPRESSION_REASON.bounce, T0)).toBe(true);
+    expect(await store.suppress(h, SUPPRESSION_REASON.complaint, T0)).toBe(false);
+    expect(await store.isSuppressed(hashAddress(" a@b.co "))).toBe(true);
+    expect(await store.unsuppress(h)).toBe(true);
+    expect(await store.unsuppress(h)).toBe(false);
+    expect(await store.isSuppressed(h)).toBe(false);
+  });
+  it(`${name}: claims an idempotency key once, and gives it back`, async () => {
+    const store = await make();
+    expect(await store.hasKey("k1")).toBe(false);
+    expect(await store.claimKey("k1", T0)).toBe(true);
+    expect(await store.claimKey("k1", T0)).toBe(false);
+    expect(await store.hasKey("k1")).toBe(true);
+    await store.releaseKey("k1");
+    expect(await store.hasKey("k1")).toBe(false);
+    expect(await store.claimKey("k1", T0)).toBe(true);
+  });
+  it(`${name}: claims a key once under concurrency`, async () => {
+    const store = await make();
+    const results = await Promise.all(Array.from({ length: 20 }, () => store.claimKey("race", T0)));
+    expect(results.filter(Boolean)).toHaveLength(1);
+  });
+  it(`${name}: logs newest first, with a hash and never an address`, async () => {
+    const store = await make();
+    await store.record(entry({ status: "failed", detail: "mailgun answered 500" }));
+    await store.record(entry({ at: day(1), status: "sent", messageId: "<m1>", idempotencyKey: "k" }));
+    const [first, second] = await store.recent(10);
+    expect(first).toMatchObject({ status: "sent", messageId: "<m1>", idempotencyKey: "k", to: hashAddress("a@b.co"), at: day(1).toISOString() });
+    expect(second).toMatchObject({ status: "failed", detail: "mailgun answered 500" });
+    expect(JSON.stringify(await store.recent(10))).not.toContain("a@b.co");
+    expect(await store.recent(1)).toHaveLength(1);
+  });
+  it(`${name}: purges the log and the keys before a date, and keeps the suppressions`, async () => {
+    const store = await make();
+    const h = hashAddress("x@y.co");
+    await store.record(entry());
+    await store.record(entry({ at: day(60) }));
+    await store.claimKey("old", T0);
+    await store.claimKey("new", day(60));
+    await store.suppress(h, SUPPRESSION_REASON.unsubscribed, T0);
+    expect(await store.purgeBefore(day(30))).toBe(2);
+    expect(await store.recent(10)).toHaveLength(1);
+    expect(await store.hasKey("old")).toBe(false);
+    expect(await store.hasKey("new")).toBe(true);
+    expect(await store.isSuppressed(h)).toBe(true);
+  });
+}
+export {
+  T0,
+  mailStoreContract
+};
+//# sourceMappingURL=testkit.js.map

package/dist/testkit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testkit.ts"],"sourcesContent":["import { expect, it } from \"vitest\";\n\nimport { type DeliveryInput, type MailStore, SUPPRESSION_REASON } from \"./port\";\nimport { hashAddress } from \"./rules\";\n\nexport const T0 = new Date(\"2026-10-26T12:00:00.000Z\");\nconst day = (n: number) => new Date(T0.valueOf() + n * 24 * 3600 * 1000);\nconst entry = (over: Partial<DeliveryInput> = {}) => ({ at: T0, template: \"reset\", category: \"transactional\", locale: \"fr\", to: hashAddress(\"a@b.co\"), status: \"sent\" as const, ...over });\n\n/** What every `MailStore` adapter must do: the same behaviour behind the same port. `make` gives an empty store. */\nexport function mailStoreContract(name: string, make: () => MailStore | Promise<MailStore>) {\n  it(`${name}: suppresses an address once, keeps the first reason, and lifts it`, async () => {\n    const store = await make();\n    const h = hashAddress(\"A@B.co\");\n    expect(await store.isSuppressed(h)).toBe(false);\n    expect(await store.suppress(h, SUPPRESSION_REASON.bounce, T0)).toBe(true);\n    expect(await store.suppress(h, SUPPRESSION_REASON.complaint, T0)).toBe(false);\n    expect(await store.isSuppressed(hashAddress(\" a@b.co \"))).toBe(true);\n    expect(await store.unsuppress(h)).toBe(true);\n    expect(await store.unsuppress(h)).toBe(false);\n    expect(await store.isSuppressed(h)).toBe(false);\n  });\n\n  it(`${name}: claims an idempotency key once, and gives it back`, async () => {\n    const store = await make();\n    expect(await store.hasKey(\"k1\")).toBe(false);\n    expect(await store.claimKey(\"k1\", T0)).toBe(true);\n    expect(await store.claimKey(\"k1\", T0)).toBe(false);\n    expect(await store.hasKey(\"k1\")).toBe(true);\n    await store.releaseKey(\"k1\");\n    expect(await store.hasKey(\"k1\")).toBe(false);\n    expect(await store.claimKey(\"k1\", T0)).toBe(true);\n  });\n\n  it(`${name}: claims a key once under concurrency`, async () => {\n    const store = await make();\n    const results = await Promise.all(Array.from({ length: 20 }, () => store.claimKey(\"race\", T0)));\n    expect(results.filter(Boolean)).toHaveLength(1);\n  });\n\n  it(`${name}: logs newest first, with a hash and never an address`, async () => {\n    const store = await make();\n    await store.record(entry({ status: \"failed\", detail: \"mailgun answered 500\" }));\n    await store.record(entry({ at: day(1), status: \"sent\", messageId: \"<m1>\", idempotencyKey: \"k\" }));\n    const [first, second] = await store.recent(10);\n    expect(first).toMatchObject({ status: \"sent\", messageId: \"<m1>\", idempotencyKey: \"k\", to: hashAddress(\"a@b.co\"), at: day(1).toISOString() });\n    expect(second).toMatchObject({ status: \"failed\", detail: \"mailgun answered 500\" });\n    expect(JSON.stringify(await store.recent(10))).not.toContain(\"a@b.co\");\n    expect(await store.recent(1)).toHaveLength(1);\n  });\n\n  it(`${name}: purges the log and the keys before a date, and keeps the suppressions`, async () => {\n    const store = await make();\n    const h = hashAddress(\"x@y.co\");\n    await store.record(entry());\n    await store.record(entry({ at: day(60) }));\n    await store.claimKey(\"old\", T0);\n    await store.claimKey(\"new\", day(60));\n    await store.suppress(h, SUPPRESSION_REASON.unsubscribed, T0);\n    expect(await store.purgeBefore(day(30))).toBe(2);\n    expect(await store.recent(10)).toHaveLength(1);\n    expect(await store.hasKey(\"old\")).toBe(false);\n    expect(await store.hasKey(\"new\")).toBe(true);\n    expect(await store.isSuppressed(h)).toBe(true);\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,87 @@
 {
   "name": "@krizaka/mail",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Mail for every Krizaka product: queued in the caller's transaction through the outbox, delivered once per idempotency key, never to a suppressed address (stored as a hash); providers (Mailgun, Resend, log) over an injected fetch; bounces and complaints from signed webhooks. No vendor SDK, no environment variable, no wall clock.",
+  "keywords": [
+    "krizaka",
+    "mail",
+    "email",
+    "outbox",
+    "suppression",
+    "mailgun",
+    "resend"
+  ],
+  "homepage": "https://github.com/krizaka/krizaka-ts/tree/main/packages/mail",
+  "bugs": "https://github.com/krizaka/krizaka-ts/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krizaka/krizaka-ts.git",
+    "directory": "packages/mail"
+  },
+  "license": "Apache-2.0",
+  "author": "Krizaka (https://www.krizaka.com)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./settings": {
+      "types": "./dist/settings.d.ts",
+      "import": "./dist/settings.js"
+    },
+    "./testkit": {
+      "types": "./dist/testkit.d.ts",
+      "import": "./dist/testkit.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/pg": "^8.23.1",
+    "eslint": "^9.39.0",
+    "pg": "^8.23.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "zod": "^4.6.7",
+    "@krizaka/config": "^0.14.1",
+    "@krizaka/outbox": "^0.1.2"
+  },
+  "dependencies": {
+    "@krizaka/time": "^0.1.0",
+    "@krizaka/db": "^0.3.0",
+    "@krizaka/settings": "^0.5.1"
+  },
+  "peerDependencies": {
+    "vitest": ">=4",
+    "zod": ">=3.23"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
+    "lint": "eslint . --max-warnings 0 && tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=lcov --coverage.reporter=text-summary \"--coverage.include=src/**/*.ts\"",
+    "check": "pnpm run lint && pnpm run test && pnpm run build"
+  }
 }