easy-ping 0.1.0

package/dist/testing.d.cts

@@ -0,0 +1,38 @@
+import { D as DatabaseAdapter } from './adapter-f0OR2DhY.cjs';
+
+type ConformanceContext = {
+    adapter: DatabaseAdapter;
+    /**
+     * Forces a delivery's attempt count. Not reachable through the public API —
+     * the adapter would have marked the row failed on the way there — so each
+     * backend writes it directly.
+     */
+    setAttempts: (deliveryId: string, attempts: number) => Promise<void>;
+    /**
+     * Empties the tables. Cases must run against a clean table: claims are
+     * ordered by not_before ASC and bounded by limit, so leftover rows from an
+     * earlier case can push the row under test out of the claim window.
+     */
+    reset: () => Promise<void>;
+    /**
+     * Holds a row lock on a separate connection for the duration of `fn`.
+     *
+     * Required to test SKIP LOCKED deterministically. Two Promise.all'd claims
+     * do not reliably overlap — they complete in single-digit milliseconds and
+     * simply queue — so a race-based test passes even with no locking at all.
+     *
+     * Only meaningful where a claim can block on someone else's lock. A document
+     * store whose claim is a single atomic update has nothing to skip, so cases
+     * tagged `rowLock` do not apply to it.
+     */
+    lockRow?: (deliveryId: string, fn: () => Promise<void>) => Promise<void>;
+};
+type ConformanceCase = {
+    name: string;
+    /** Capability the case needs; a backend without it must filter the case out. */
+    requires?: "rowLock";
+    run: (ctx: ConformanceContext) => Promise<void>;
+};
+declare const adapterConformanceCases: readonly ConformanceCase[];
+
+export { type ConformanceCase, type ConformanceContext, adapterConformanceCases };

package/dist/testing.d.ts

@@ -0,0 +1,38 @@
+import { D as DatabaseAdapter } from './adapter-f0OR2DhY.js';
+
+type ConformanceContext = {
+    adapter: DatabaseAdapter;
+    /**
+     * Forces a delivery's attempt count. Not reachable through the public API —
+     * the adapter would have marked the row failed on the way there — so each
+     * backend writes it directly.
+     */
+    setAttempts: (deliveryId: string, attempts: number) => Promise<void>;
+    /**
+     * Empties the tables. Cases must run against a clean table: claims are
+     * ordered by not_before ASC and bounded by limit, so leftover rows from an
+     * earlier case can push the row under test out of the claim window.
+     */
+    reset: () => Promise<void>;
+    /**
+     * Holds a row lock on a separate connection for the duration of `fn`.
+     *
+     * Required to test SKIP LOCKED deterministically. Two Promise.all'd claims
+     * do not reliably overlap — they complete in single-digit milliseconds and
+     * simply queue — so a race-based test passes even with no locking at all.
+     *
+     * Only meaningful where a claim can block on someone else's lock. A document
+     * store whose claim is a single atomic update has nothing to skip, so cases
+     * tagged `rowLock` do not apply to it.
+     */
+    lockRow?: (deliveryId: string, fn: () => Promise<void>) => Promise<void>;
+};
+type ConformanceCase = {
+    name: string;
+    /** Capability the case needs; a backend without it must filter the case out. */
+    requires?: "rowLock";
+    run: (ctx: ConformanceContext) => Promise<void>;
+};
+declare const adapterConformanceCases: readonly ConformanceCase[];
+
+export { type ConformanceCase, type ConformanceContext, adapterConformanceCases };

package/dist/testing.js

@@ -0,0 +1,340 @@
+// src/testing/conformance.ts
+var ConformanceError = class extends Error {
+};
+function assert(condition, message) {
+  if (!condition) throw new ConformanceError(message);
+}
+var equal = (actual, expected, message) => assert(actual === expected, `${message} (got ${String(actual)}, expected ${String(expected)})`);
+var counter = 0;
+function uid(label) {
+  counter += 1;
+  return `${label}_${Date.now().toString(36)}_${counter}`;
+}
+async function seed(ctx, options = {}) {
+  const count = options.count ?? 1;
+  const userId = options.userId ?? uid("user");
+  const rows = Array.from({ length: count }, () => {
+    const id = uid("notif");
+    return {
+      id,
+      userId,
+      type: "commentReply",
+      payload: { authorName: "Dana" },
+      ...options.dedupeKey ? { dedupeKey: options.dedupeKey } : {},
+      deliveries: [
+        {
+          id: uid("delivery"),
+          channel: options.channel ?? "email",
+          maxAttempts: options.maxAttempts ?? 5,
+          notBefore: options.notBefore ?? new Date(Date.now() - 1e3)
+        }
+      ]
+    };
+  });
+  const result = await ctx.adapter.createNotifications(rows);
+  return { userId, rows, result };
+}
+var CLAIM = { limit: 10, leaseMs: 6e4 };
+var adapterConformanceCases = [
+  {
+    /**
+     * The case that actually distinguishes a correct adapter.
+     *
+     * A row locked by another transaction must be *skipped*, not waited on.
+     * Without SKIP LOCKED the claim blocks until the holder commits, which on
+     * a busy table serialises every worker behind the slowest one.
+     */
+    name: "a row locked by another transaction is skipped, not waited on",
+    requires: "rowLock",
+    run: async (ctx) => {
+      const { lockRow } = ctx;
+      assert(lockRow, "case requires lockRow");
+      const { rows } = await seed(ctx, { count: 2 });
+      const locked = rows[0]?.deliveries[0]?.id;
+      const free = rows[1]?.deliveries[0]?.id;
+      assert(locked && free, "seed produced too few deliveries");
+      await lockRow(locked, async () => {
+        const claimed = await Promise.race([
+          ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("token") }),
+          new Promise(
+            (_, reject) => setTimeout(
+              () => reject(
+                new ConformanceError(
+                  "claim blocked on a row locked by another transaction \u2014 SKIP LOCKED is missing"
+                )
+              ),
+              2e3
+            )
+          )
+        ]);
+        const ids = new Set(claimed.map((row) => row.id));
+        assert(!ids.has(locked), "claimed a row locked by another transaction");
+        assert(ids.has(free), "skipped an unlocked row alongside the locked one");
+      });
+    }
+  },
+  {
+    name: "concurrent claims return disjoint sets",
+    run: async (ctx) => {
+      await seed(ctx, { count: 40 });
+      const claimed = await Promise.all(
+        Array.from(
+          { length: 8 },
+          () => ctx.adapter.claimPendingDeliveries({ limit: 5, leaseMs: 6e4, claimToken: uid("t") })
+        )
+      );
+      const all = claimed.flatMap((batch) => batch.map((row) => row.id));
+      equal(new Set(all).size, all.length, "the same delivery was claimed by two callers");
+      assert(all.length <= 40, "claimed more rows than exist");
+    }
+  },
+  {
+    name: "a claimed row is invisible before its lease expires",
+    run: async (ctx) => {
+      const { rows } = await seed(ctx);
+      const target = rows[0]?.deliveries[0]?.id;
+      const first = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      assert(
+        first.some((row) => row.id === target),
+        "seeded delivery was not claimed"
+      );
+      const second = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      assert(!second.some((row) => row.id === target), "leased row was claimed twice");
+    }
+  },
+  {
+    name: "a claimed row is re-claimable after its lease expires",
+    run: async (ctx) => {
+      const { rows } = await seed(ctx);
+      const target = rows[0]?.deliveries[0]?.id;
+      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      const later = new Date(Date.now() + CLAIM.leaseMs + 5e3);
+      const reclaimed = await ctx.adapter.claimPendingDeliveries({
+        ...CLAIM,
+        claimToken: uid("t"),
+        now: later
+      });
+      assert(
+        reclaimed.some((row) => row.id === target),
+        "expired lease was not reclaimed"
+      );
+    }
+  },
+  {
+    name: "not_before in the future is never claimed",
+    run: async (ctx) => {
+      const { rows } = await seed(ctx, { notBefore: new Date(Date.now() + 36e5) });
+      const target = rows[0]?.deliveries[0]?.id;
+      const claimed = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      assert(!claimed.some((row) => row.id === target), "claimed a delivery before its not_before");
+    }
+  },
+  {
+    name: "attempts at or beyond max_attempts is never claimed",
+    run: async (ctx) => {
+      const { rows } = await seed(ctx, { maxAttempts: 3 });
+      const target = rows[0]?.deliveries[0]?.id;
+      assert(target, "seed produced no delivery");
+      await ctx.setAttempts(target, 3);
+      const claimed = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      assert(!claimed.some((row) => row.id === target), "claimed an exhausted delivery");
+    }
+  },
+  {
+    name: "claims are ordered by not_before ascending",
+    run: async (ctx) => {
+      const userId = uid("user");
+      const older = uid("delivery");
+      const newer = uid("delivery");
+      await ctx.adapter.createNotifications([
+        {
+          id: uid("notif"),
+          userId,
+          type: "t",
+          payload: {},
+          deliveries: [
+            {
+              id: newer,
+              channel: "email",
+              maxAttempts: 5,
+              notBefore: new Date(Date.now() - 1e3)
+            }
+          ]
+        },
+        {
+          id: uid("notif"),
+          userId,
+          type: "t",
+          payload: {},
+          deliveries: [
+            {
+              id: older,
+              channel: "email",
+              maxAttempts: 5,
+              notBefore: new Date(Date.now() - 6e5)
+            }
+          ]
+        }
+      ]);
+      const claimed = await ctx.adapter.claimPendingDeliveries({
+        limit: 1,
+        leaseMs: 6e4,
+        claimToken: uid("t")
+      });
+      equal(claimed[0]?.id, older, "oldest eligible delivery was not claimed first");
+    }
+  },
+  {
+    name: "release with a stale token still writes the terminal state",
+    run: async (ctx) => {
+      const { rows } = await seed(ctx);
+      const target = rows[0]?.deliveries[0]?.id;
+      assert(target, "seed produced no delivery");
+      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("real") });
+      await ctx.adapter.releaseDeliveries([
+        {
+          id: target,
+          claimToken: "a-token-that-never-held-this-lease",
+          outcome: { result: "sent" }
+        }
+      ]);
+      const stillClaimable = await ctx.adapter.claimPendingDeliveries({
+        ...CLAIM,
+        claimToken: uid("t"),
+        now: new Date(Date.now() + CLAIM.leaseMs + 5e3)
+      });
+      assert(
+        !stillClaimable.some((row) => row.id === target),
+        "row stayed claimable after being marked sent"
+      );
+    }
+  },
+  {
+    name: "retryable failure re-arms; non-retryable fails immediately",
+    run: async (ctx) => {
+      const retry = await seed(ctx, { maxAttempts: 5 });
+      const retryId = retry.rows[0]?.deliveries[0]?.id;
+      assert(retryId, "seed produced no delivery");
+      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      const soon = new Date(Date.now() + 3e4);
+      await ctx.adapter.releaseDeliveries([
+        {
+          id: retryId,
+          claimToken: "t",
+          outcome: { result: "failed", error: "smtp timeout", retryable: true },
+          nextAttemptAt: soon
+        }
+      ]);
+      const tooEarly = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      assert(
+        !tooEarly.some((row) => row.id === retryId),
+        "re-armed delivery was claimable before its backoff elapsed"
+      );
+      const afterBackoff = await ctx.adapter.claimPendingDeliveries({
+        ...CLAIM,
+        claimToken: uid("t"),
+        now: new Date(soon.getTime() + 1e3)
+      });
+      assert(
+        afterBackoff.some((row) => row.id === retryId),
+        "re-armed delivery never became claimable"
+      );
+      const terminal = await seed(ctx, { maxAttempts: 5 });
+      const terminalId = terminal.rows[0]?.deliveries[0]?.id;
+      assert(terminalId, "seed produced no delivery");
+      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid("t") });
+      await ctx.adapter.releaseDeliveries([
+        {
+          id: terminalId,
+          claimToken: "t",
+          outcome: { result: "failed", error: "invalid api key", retryable: false }
+        }
+      ]);
+      const failed = await ctx.adapter.getFailedDeliveries({
+        since: new Date(Date.now() - 6e4),
+        limit: 50
+      });
+      assert(
+        failed.some((row) => row.id === terminalId),
+        "non-retryable failure did not land in failed"
+      );
+    }
+  },
+  {
+    name: "duplicate dedupeKey is skipped, not thrown",
+    run: async (ctx) => {
+      const userId = uid("user");
+      const key = uid("dedupe");
+      const first = await seed(ctx, { userId, dedupeKey: key });
+      equal(first.result.created.length, 1, "first insert was not created");
+      const second = await seed(ctx, { userId, dedupeKey: key });
+      equal(second.result.created.length, 0, "duplicate was created");
+      equal(second.result.deduped.length, 1, "duplicate was not reported as deduped");
+    }
+  },
+  {
+    name: "notifications with no dedupeKey never collide",
+    run: async (ctx) => {
+      const userId = uid("user");
+      const result = await seed(ctx, { userId, count: 3 });
+      equal(result.result.created.length, 3, "undeduped notifications collided");
+    }
+  },
+  {
+    name: "markRead is scoped to the owning user",
+    run: async (ctx) => {
+      const owner = uid("user");
+      const { rows } = await seed(ctx, { userId: owner });
+      const notificationId = rows[0]?.id;
+      assert(notificationId, "seed produced no notification");
+      const stolen = await ctx.adapter.markRead(uid("attacker"), [notificationId]);
+      equal(stolen, 0, "another user marked a notification read");
+      const own = await ctx.adapter.markRead(owner, [notificationId]);
+      equal(own, 1, "owner could not mark their own notification read");
+    }
+  },
+  {
+    name: "unseen count and markSeen agree",
+    run: async (ctx) => {
+      const userId = uid("user");
+      await seed(ctx, { userId, count: 3 });
+      equal(await ctx.adapter.countUnseen(userId), 3, "unseen count wrong before markSeen");
+      await ctx.adapter.markSeen(userId, /* @__PURE__ */ new Date());
+      equal(await ctx.adapter.countUnseen(userId), 0, "unseen count wrong after markSeen");
+    }
+  },
+  {
+    /**
+     * createdAt must come from the same clock as the cutoff it is compared to.
+     *
+     * An adapter that leaves createdAt to a database DEFAULT now() is comparing
+     * the database clock against the application clock. On one machine they
+     * agree and this never fails; in production they are different hosts, and a
+     * database a second ahead means markSeen(now) silently misses the newest
+     * notifications and the unseen badge never clears. Found when a laptop
+     * resumed from sleep with its Docker VM 6s ahead.
+     */
+    name: "createdAt comes from the caller clock, not the database clock",
+    run: async (ctx) => {
+      const userId = uid("user");
+      const before = /* @__PURE__ */ new Date();
+      await seed(ctx, { userId, count: 1 });
+      const after = /* @__PURE__ */ new Date();
+      const { notifications } = await ctx.adapter.listNotifications({ userId, limit: 10 });
+      const createdAt = notifications[0]?.createdAt;
+      assert(createdAt, "seed produced no notification");
+      const skewMs = Math.max(
+        before.getTime() - createdAt.getTime(),
+        createdAt.getTime() - after.getTime()
+      );
+      assert(
+        skewMs <= 1e3,
+        `createdAt is ${skewMs}ms outside the window the caller observed \u2014 it is coming from another clock`
+      );
+    }
+  }
+];
+
+export { adapterConformanceCases };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/conformance.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["import type { DatabaseAdapter, InsertNotification } from \"../core/adapter\";\nimport type { Channel } from \"../core/types\";\n\nexport type ConformanceContext = {\n  adapter: DatabaseAdapter;\n  /**\n   * Forces a delivery's attempt count. Not reachable through the public API —\n   * the adapter would have marked the row failed on the way there — so each\n   * backend writes it directly.\n   */\n  setAttempts: (deliveryId: string, attempts: number) => Promise<void>;\n  /**\n   * Empties the tables. Cases must run against a clean table: claims are\n   * ordered by not_before ASC and bounded by limit, so leftover rows from an\n   * earlier case can push the row under test out of the claim window.\n   */\n  reset: () => Promise<void>;\n  /**\n   * Holds a row lock on a separate connection for the duration of `fn`.\n   *\n   * Required to test SKIP LOCKED deterministically. Two Promise.all'd claims\n   * do not reliably overlap — they complete in single-digit milliseconds and\n   * simply queue — so a race-based test passes even with no locking at all.\n   *\n   * Only meaningful where a claim can block on someone else's lock. A document\n   * store whose claim is a single atomic update has nothing to skip, so cases\n   * tagged `rowLock` do not apply to it.\n   */\n  lockRow?: (deliveryId: string, fn: () => Promise<void>) => Promise<void>;\n};\n\nexport type ConformanceCase = {\n  name: string;\n  /** Capability the case needs; a backend without it must filter the case out. */\n  requires?: \"rowLock\";\n  run: (ctx: ConformanceContext) => Promise<void>;\n};\n\nclass ConformanceError extends Error {}\n\nfunction assert(condition: unknown, message: string): asserts condition {\n  if (!condition) throw new ConformanceError(message);\n}\n\nconst equal = (actual: unknown, expected: unknown, message: string) =>\n  assert(actual === expected, `${message} (got ${String(actual)}, expected ${String(expected)})`);\n\nlet counter = 0;\nfunction uid(label: string): string {\n  counter += 1;\n  return `${label}_${Date.now().toString(36)}_${counter}`;\n}\n\ntype SeedOptions = {\n  count?: number;\n  notBefore?: Date;\n  maxAttempts?: number;\n  channel?: Channel;\n  dedupeKey?: string;\n  userId?: string;\n};\n\nasync function seed(ctx: ConformanceContext, options: SeedOptions = {}) {\n  const count = options.count ?? 1;\n  const userId = options.userId ?? uid(\"user\");\n\n  const rows: InsertNotification[] = Array.from({ length: count }, () => {\n    const id = uid(\"notif\");\n    return {\n      id,\n      userId,\n      type: \"commentReply\",\n      payload: { authorName: \"Dana\" },\n      ...(options.dedupeKey ? { dedupeKey: options.dedupeKey } : {}),\n      deliveries: [\n        {\n          id: uid(\"delivery\"),\n          channel: options.channel ?? \"email\",\n          maxAttempts: options.maxAttempts ?? 5,\n          notBefore: options.notBefore ?? new Date(Date.now() - 1000),\n        },\n      ],\n    };\n  });\n\n  const result = await ctx.adapter.createNotifications(rows);\n  return { userId, rows, result };\n}\n\nconst CLAIM = { limit: 10, leaseMs: 60_000 };\n\nexport const adapterConformanceCases: readonly ConformanceCase[] = [\n  {\n    /**\n     * The case that actually distinguishes a correct adapter.\n     *\n     * A row locked by another transaction must be *skipped*, not waited on.\n     * Without SKIP LOCKED the claim blocks until the holder commits, which on\n     * a busy table serialises every worker behind the slowest one.\n     */\n    name: \"a row locked by another transaction is skipped, not waited on\",\n    requires: \"rowLock\",\n    run: async (ctx) => {\n      const { lockRow } = ctx;\n      assert(lockRow, \"case requires lockRow\");\n\n      const { rows } = await seed(ctx, { count: 2 });\n      const locked = rows[0]?.deliveries[0]?.id;\n      const free = rows[1]?.deliveries[0]?.id;\n      assert(locked && free, \"seed produced too few deliveries\");\n\n      await lockRow(locked, async () => {\n        const claimed = await Promise.race([\n          ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"token\") }),\n          new Promise<never>((_, reject) =>\n            setTimeout(\n              () =>\n                reject(\n                  new ConformanceError(\n                    \"claim blocked on a row locked by another transaction — SKIP LOCKED is missing\",\n                  ),\n                ),\n              2_000,\n            ),\n          ),\n        ]);\n\n        const ids = new Set(claimed.map((row) => row.id));\n        assert(!ids.has(locked), \"claimed a row locked by another transaction\");\n        assert(ids.has(free), \"skipped an unlocked row alongside the locked one\");\n      });\n    },\n  },\n\n  {\n    name: \"concurrent claims return disjoint sets\",\n    run: async (ctx) => {\n      await seed(ctx, { count: 40 });\n\n      // Eight callers over 40 rows, repeated — a single Promise.all pair is\n      // too fast to overlap and proves nothing on its own.\n      const claimed = await Promise.all(\n        Array.from({ length: 8 }, () =>\n          ctx.adapter.claimPendingDeliveries({ limit: 5, leaseMs: 60_000, claimToken: uid(\"t\") }),\n        ),\n      );\n\n      const all = claimed.flatMap((batch) => batch.map((row) => row.id));\n      equal(new Set(all).size, all.length, \"the same delivery was claimed by two callers\");\n      assert(all.length <= 40, \"claimed more rows than exist\");\n    },\n  },\n\n  {\n    name: \"a claimed row is invisible before its lease expires\",\n    run: async (ctx) => {\n      const { rows } = await seed(ctx);\n      const target = rows[0]?.deliveries[0]?.id;\n\n      const first = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      assert(\n        first.some((row) => row.id === target),\n        \"seeded delivery was not claimed\",\n      );\n\n      const second = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      assert(!second.some((row) => row.id === target), \"leased row was claimed twice\");\n    },\n  },\n\n  {\n    name: \"a claimed row is re-claimable after its lease expires\",\n    run: async (ctx) => {\n      const { rows } = await seed(ctx);\n      const target = rows[0]?.deliveries[0]?.id;\n\n      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n\n      const later = new Date(Date.now() + CLAIM.leaseMs + 5_000);\n      const reclaimed = await ctx.adapter.claimPendingDeliveries({\n        ...CLAIM,\n        claimToken: uid(\"t\"),\n        now: later,\n      });\n\n      assert(\n        reclaimed.some((row) => row.id === target),\n        \"expired lease was not reclaimed\",\n      );\n    },\n  },\n\n  {\n    name: \"not_before in the future is never claimed\",\n    run: async (ctx) => {\n      const { rows } = await seed(ctx, { notBefore: new Date(Date.now() + 3_600_000) });\n      const target = rows[0]?.deliveries[0]?.id;\n\n      const claimed = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      assert(!claimed.some((row) => row.id === target), \"claimed a delivery before its not_before\");\n    },\n  },\n\n  {\n    name: \"attempts at or beyond max_attempts is never claimed\",\n    run: async (ctx) => {\n      const { rows } = await seed(ctx, { maxAttempts: 3 });\n      const target = rows[0]?.deliveries[0]?.id;\n      assert(target, \"seed produced no delivery\");\n\n      await ctx.setAttempts(target, 3);\n\n      const claimed = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      assert(!claimed.some((row) => row.id === target), \"claimed an exhausted delivery\");\n    },\n  },\n\n  {\n    name: \"claims are ordered by not_before ascending\",\n    run: async (ctx) => {\n      const userId = uid(\"user\");\n      const older = uid(\"delivery\");\n      const newer = uid(\"delivery\");\n\n      await ctx.adapter.createNotifications([\n        {\n          id: uid(\"notif\"),\n          userId,\n          type: \"t\",\n          payload: {},\n          deliveries: [\n            {\n              id: newer,\n              channel: \"email\",\n              maxAttempts: 5,\n              notBefore: new Date(Date.now() - 1_000),\n            },\n          ],\n        },\n        {\n          id: uid(\"notif\"),\n          userId,\n          type: \"t\",\n          payload: {},\n          deliveries: [\n            {\n              id: older,\n              channel: \"email\",\n              maxAttempts: 5,\n              notBefore: new Date(Date.now() - 600_000),\n            },\n          ],\n        },\n      ]);\n\n      const claimed = await ctx.adapter.claimPendingDeliveries({\n        limit: 1,\n        leaseMs: 60_000,\n        claimToken: uid(\"t\"),\n      });\n\n      equal(claimed[0]?.id, older, \"oldest eligible delivery was not claimed first\");\n    },\n  },\n\n  {\n    name: \"release with a stale token still writes the terminal state\",\n    run: async (ctx) => {\n      const { rows } = await seed(ctx);\n      const target = rows[0]?.deliveries[0]?.id;\n      assert(target, \"seed produced no delivery\");\n\n      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"real\") });\n\n      await ctx.adapter.releaseDeliveries([\n        {\n          id: target,\n          claimToken: \"a-token-that-never-held-this-lease\",\n          outcome: { result: \"sent\" },\n        },\n      ]);\n\n      const stillClaimable = await ctx.adapter.claimPendingDeliveries({\n        ...CLAIM,\n        claimToken: uid(\"t\"),\n        now: new Date(Date.now() + CLAIM.leaseMs + 5_000),\n      });\n\n      assert(\n        !stillClaimable.some((row) => row.id === target),\n        \"row stayed claimable after being marked sent\",\n      );\n    },\n  },\n\n  {\n    name: \"retryable failure re-arms; non-retryable fails immediately\",\n    run: async (ctx) => {\n      const retry = await seed(ctx, { maxAttempts: 5 });\n      const retryId = retry.rows[0]?.deliveries[0]?.id;\n      assert(retryId, \"seed produced no delivery\");\n\n      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n\n      const soon = new Date(Date.now() + 30_000);\n      await ctx.adapter.releaseDeliveries([\n        {\n          id: retryId,\n          claimToken: \"t\",\n          outcome: { result: \"failed\", error: \"smtp timeout\", retryable: true },\n          nextAttemptAt: soon,\n        },\n      ]);\n\n      const tooEarly = await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      assert(\n        !tooEarly.some((row) => row.id === retryId),\n        \"re-armed delivery was claimable before its backoff elapsed\",\n      );\n\n      const afterBackoff = await ctx.adapter.claimPendingDeliveries({\n        ...CLAIM,\n        claimToken: uid(\"t\"),\n        now: new Date(soon.getTime() + 1_000),\n      });\n      assert(\n        afterBackoff.some((row) => row.id === retryId),\n        \"re-armed delivery never became claimable\",\n      );\n\n      const terminal = await seed(ctx, { maxAttempts: 5 });\n      const terminalId = terminal.rows[0]?.deliveries[0]?.id;\n      assert(terminalId, \"seed produced no delivery\");\n\n      await ctx.adapter.claimPendingDeliveries({ ...CLAIM, claimToken: uid(\"t\") });\n      await ctx.adapter.releaseDeliveries([\n        {\n          id: terminalId,\n          claimToken: \"t\",\n          outcome: { result: \"failed\", error: \"invalid api key\", retryable: false },\n        },\n      ]);\n\n      const failed = await ctx.adapter.getFailedDeliveries({\n        since: new Date(Date.now() - 60_000),\n        limit: 50,\n      });\n      assert(\n        failed.some((row) => row.id === terminalId),\n        \"non-retryable failure did not land in failed\",\n      );\n    },\n  },\n\n  {\n    name: \"duplicate dedupeKey is skipped, not thrown\",\n    run: async (ctx) => {\n      const userId = uid(\"user\");\n      const key = uid(\"dedupe\");\n\n      const first = await seed(ctx, { userId, dedupeKey: key });\n      equal(first.result.created.length, 1, \"first insert was not created\");\n\n      const second = await seed(ctx, { userId, dedupeKey: key });\n      equal(second.result.created.length, 0, \"duplicate was created\");\n      equal(second.result.deduped.length, 1, \"duplicate was not reported as deduped\");\n    },\n  },\n\n  {\n    name: \"notifications with no dedupeKey never collide\",\n    run: async (ctx) => {\n      const userId = uid(\"user\");\n      const result = await seed(ctx, { userId, count: 3 });\n      equal(result.result.created.length, 3, \"undeduped notifications collided\");\n    },\n  },\n\n  {\n    name: \"markRead is scoped to the owning user\",\n    run: async (ctx) => {\n      const owner = uid(\"user\");\n      const { rows } = await seed(ctx, { userId: owner });\n      const notificationId = rows[0]?.id;\n      assert(notificationId, \"seed produced no notification\");\n\n      const stolen = await ctx.adapter.markRead(uid(\"attacker\"), [notificationId]);\n      equal(stolen, 0, \"another user marked a notification read\");\n\n      const own = await ctx.adapter.markRead(owner, [notificationId]);\n      equal(own, 1, \"owner could not mark their own notification read\");\n    },\n  },\n\n  {\n    name: \"unseen count and markSeen agree\",\n    run: async (ctx) => {\n      const userId = uid(\"user\");\n      await seed(ctx, { userId, count: 3 });\n\n      equal(await ctx.adapter.countUnseen(userId), 3, \"unseen count wrong before markSeen\");\n\n      await ctx.adapter.markSeen(userId, new Date());\n      equal(await ctx.adapter.countUnseen(userId), 0, \"unseen count wrong after markSeen\");\n    },\n  },\n\n  {\n    /**\n     * createdAt must come from the same clock as the cutoff it is compared to.\n     *\n     * An adapter that leaves createdAt to a database DEFAULT now() is comparing\n     * the database clock against the application clock. On one machine they\n     * agree and this never fails; in production they are different hosts, and a\n     * database a second ahead means markSeen(now) silently misses the newest\n     * notifications and the unseen badge never clears. Found when a laptop\n     * resumed from sleep with its Docker VM 6s ahead.\n     */\n    name: \"createdAt comes from the caller clock, not the database clock\",\n    run: async (ctx) => {\n      const userId = uid(\"user\");\n      const before = new Date();\n      await seed(ctx, { userId, count: 1 });\n      const after = new Date();\n\n      const { notifications } = await ctx.adapter.listNotifications({ userId, limit: 10 });\n      const createdAt = notifications[0]?.createdAt;\n      assert(createdAt, \"seed produced no notification\");\n\n      // A second of slack for a slow round trip, far under the skew that breaks\n      // markSeen but tight enough to catch a foreign clock.\n      const skewMs = Math.max(\n        before.getTime() - createdAt.getTime(),\n        createdAt.getTime() - after.getTime(),\n      );\n      assert(\n        skewMs <= 1_000,\n        `createdAt is ${skewMs}ms outside the window the caller observed — it is coming from another clock`,\n      );\n    },\n  },\n];\n"]}

package/package.json

@@ -0,0 +1,168 @@
+{
+  "name": "easy-ping",
+  "version": "0.1.0",
+  "description": "Self-hosted, type-safe notifications for TypeScript apps. Your database, your users.",
+  "license": "MIT",
+  "author": "Teklu Moges",
+  "homepage": "https://github.com/teklumt/easy-ping#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/teklumt/easy-ping.git",
+    "directory": "packages/easy-ping"
+  },
+  "bugs": {
+    "url": "https://github.com/teklumt/easy-ping/issues"
+  },
+  "keywords": [
+    "notifications",
+    "notification",
+    "in-app-notifications",
+    "notification-inbox",
+    "web-push",
+    "push-notifications",
+    "vapid",
+    "service-worker",
+    "email",
+    "transactional-email",
+    "resend",
+    "digest",
+    "notification-preferences",
+    "typescript",
+    "type-safe",
+    "self-hosted",
+    "drizzle",
+    "postgres",
+    "mongodb",
+    "react",
+    "nextjs"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./adapters/drizzle": {
+      "types": "./dist/adapters/drizzle.d.ts",
+      "import": "./dist/adapters/drizzle.js",
+      "require": "./dist/adapters/drizzle.cjs"
+    },
+    "./adapters/mongodb": {
+      "types": "./dist/adapters/mongodb.d.ts",
+      "import": "./dist/adapters/mongodb.js",
+      "require": "./dist/adapters/mongodb.cjs"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js",
+      "require": "./dist/schema.cjs"
+    },
+    "./package.json": "./package.json",
+    "./providers/resend": {
+      "types": "./dist/providers/resend.d.ts",
+      "import": "./dist/providers/resend.js",
+      "require": "./dist/providers/resend.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./plugins/preferences": {
+      "types": "./dist/plugins/preferences.d.ts",
+      "import": "./dist/plugins/preferences.js",
+      "require": "./dist/plugins/preferences.cjs"
+    },
+    "./plugins/preferences/client": {
+      "types": "./dist/plugins/preferences-client.d.ts",
+      "import": "./dist/plugins/preferences-client.js",
+      "require": "./dist/plugins/preferences-client.cjs"
+    },
+    "./plugins/preferences/react": {
+      "types": "./dist/plugins/preferences-react.d.ts",
+      "import": "./dist/plugins/preferences-react.js",
+      "require": "./dist/plugins/preferences-react.cjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "require": "./dist/node.cjs"
+    },
+    "./plugins/digests": {
+      "types": "./dist/plugins/digests.d.ts",
+      "import": "./dist/plugins/digests.js",
+      "require": "./dist/plugins/digests.cjs"
+    },
+    "./plugins/push": {
+      "types": "./dist/plugins/push.d.ts",
+      "import": "./dist/plugins/push.js",
+      "require": "./dist/plugins/push.cjs"
+    },
+    "./providers/web-push": {
+      "types": "./dist/providers/web-push.d.ts",
+      "import": "./dist/providers/web-push.js",
+      "require": "./dist/providers/web-push.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "require": "./dist/browser.cjs"
+    }
+  },
+  "peerDependencies": {
+    "drizzle-orm": ">=0.36.0",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "drizzle-orm": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node scripts/clean.mjs && tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "type-budget": "node scripts/check-type-budget.mjs",
+    "check-node-floor": "node scripts/check-node-floor.mjs",
+    "prepack": "node scripts/copy-docs.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "@types/react": "^19.2.18",
+    "drizzle-orm": "^0.45.2",
+    "http_ece": "^1.2.1",
+    "mongodb": "^7.6.0",
+    "postgres": "^3.4.9",
+    "react": "^19.2.8",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0"
+  }
+}