easy-ping 0.1.0

package/dist/schema.js

@@ -0,0 +1,200 @@
+import { toSnakeCase } from './chunk-NYDVNMKG.js';
+export { coreSchema, toSnakeCase } from './chunk-NYDVNMKG.js';
+
+// src/schema/render-sql.ts
+var SQL_TYPE = {
+  string: "text",
+  number: "integer",
+  boolean: "boolean",
+  date: "timestamptz",
+  json: "jsonb"
+};
+var quote = (value) => `"${value.replace(/"/g, '""')}"`;
+var defaultClause = (field) => {
+  if (field.defaultNow) return " DEFAULT now()";
+  if (field.default === void 0) return "";
+  if (typeof field.default === "string") return ` DEFAULT '${field.default.replace(/'/g, "''")}'`;
+  return ` DEFAULT ${field.default}`;
+};
+function renderPostgresDdl(schema, prefix = "") {
+  const statements = [];
+  for (const table of Object.values(schema)) {
+    const name = quote(prefix + table.tableName);
+    const columns = Object.entries(table.fields).map(([field, spec]) => {
+      const nullability = spec.required ? " NOT NULL" : "";
+      return `  ${quote(toSnakeCase(field))} ${SQL_TYPE[spec.type]}${nullability}${defaultClause(spec)}`;
+    });
+    if (table.primaryKey?.length) {
+      const key = table.primaryKey.map((field) => quote(toSnakeCase(field))).join(", ");
+      columns.push(`  PRIMARY KEY (${key})`);
+    }
+    statements.push(`CREATE TABLE IF NOT EXISTS ${name} (
+${columns.join(",\n")}
+)`);
+    for (const declaration of table.indexes ?? []) {
+      const indexName2 = quote(
+        prefix + (declaration.name ?? `${table.tableName}_${declaration.on.join("_")}_idx`)
+      );
+      const columns2 = declaration.on.map((field) => quote(toSnakeCase(field))).join(", ");
+      const unique = declaration.unique ? "UNIQUE " : "";
+      statements.push(`CREATE ${unique}INDEX IF NOT EXISTS ${indexName2} ON ${name} (${columns2})`);
+    }
+  }
+  return statements;
+}
+
+// src/schema/migrate-sql.ts
+var SQL_TYPE2 = {
+  string: "text",
+  number: "integer",
+  boolean: "boolean",
+  date: "timestamptz",
+  json: "jsonb"
+};
+var LIVE_TYPE = {
+  string: ["text", "character varying", "character"],
+  number: ["integer", "bigint", "smallint"],
+  boolean: ["boolean"],
+  date: ["timestamp with time zone", "timestamp without time zone"],
+  json: ["jsonb", "json"]
+};
+var quote2 = (value) => `"${value.replace(/"/g, '""')}"`;
+var defaultClause2 = (field) => {
+  if (field.defaultNow) return " DEFAULT now()";
+  if (field.default === void 0) return "";
+  if (typeof field.default === "string") return ` DEFAULT '${field.default.replace(/'/g, "''")}'`;
+  return ` DEFAULT ${field.default}`;
+};
+var indexName = (table, declaration) => declaration.name ?? `${table.tableName}_${declaration.on.join("_")}_idx`;
+var INTROSPECT_SQL = `
+  SELECT table_name, column_name, data_type, is_nullable
+  FROM information_schema.columns
+  WHERE table_schema = current_schema()
+`;
+async function planPostgresMigration(introspect, schema, prefix = "") {
+  const live = await introspect();
+  const byTable = /* @__PURE__ */ new Map();
+  for (const column of live) {
+    const columns = byTable.get(column.table) ?? /* @__PURE__ */ new Map();
+    columns.set(column.column, column);
+    byTable.set(column.table, columns);
+  }
+  const statements = [];
+  const unsupported = [];
+  const createdTables = [];
+  for (const table of Object.values(schema)) {
+    const qualified = prefix + table.tableName;
+    const existing = byTable.get(qualified);
+    if (!existing || existing.size === 0) {
+      createdTables.push(qualified);
+      statements.push(...renderPostgresDdl({ [table.tableName]: table }, prefix));
+      continue;
+    }
+    for (const [field, spec] of Object.entries(table.fields)) {
+      const column = toSnakeCase(field);
+      const found = existing.get(column);
+      if (!found) {
+        const canFill = spec.defaultNow || spec.default !== void 0;
+        const nullability = spec.required && canFill ? " NOT NULL" : "";
+        statements.push(
+          `ALTER TABLE ${quote2(qualified)} ADD COLUMN IF NOT EXISTS ${quote2(column)} ${SQL_TYPE2[spec.type]}${nullability}${defaultClause2(spec)}`
+        );
+        if (spec.required && !canFill) {
+          unsupported.push(
+            `${qualified}.${column} is declared required but has no default; it was added nullable. Backfill it, then ALTER ... SET NOT NULL yourself.`
+          );
+        }
+        continue;
+      }
+      if (!LIVE_TYPE[spec.type].includes(found.type)) {
+        unsupported.push(
+          `${qualified}.${column} is ${found.type} but ${spec.type} is declared (${SQL_TYPE2[spec.type]}). Changing a column type can lose data \u2014 do it yourself.`
+        );
+      }
+    }
+    for (const declaration of table.indexes ?? []) {
+      const name = quote2(prefix + indexName(table, declaration));
+      const columns = declaration.on.map((field) => quote2(toSnakeCase(field))).join(", ");
+      statements.push(
+        `CREATE ${declaration.unique ? "UNIQUE " : ""}INDEX IF NOT EXISTS ${name} ON ${quote2(qualified)} (${columns})`
+      );
+    }
+    for (const column of existing.keys()) {
+      const declared = Object.keys(table.fields).some((field) => toSnakeCase(field) === column);
+      if (!declared) {
+        unsupported.push(
+          `${qualified}.${column} exists but is not declared. Left alone \u2014 drop it yourself if it is ours and no longer needed.`
+        );
+      }
+    }
+  }
+  return { statements, unsupported, createdTables };
+}
+
+// src/schema/render-drizzle.ts
+var COLUMN_BUILDER = {
+  string: "text",
+  number: "integer",
+  boolean: "boolean",
+  date: "timestamp",
+  json: "jsonb"
+};
+var literal = (value) => typeof value === "string" ? JSON.stringify(value) : String(value);
+function renderColumn(name, field, isSinglePk) {
+  const builder = COLUMN_BUILDER[field.type];
+  const column = toSnakeCase(name);
+  let expression = field.type === "date" ? `${builder}(${JSON.stringify(column)}, { withTimezone: true })` : `${builder}(${JSON.stringify(column)})`;
+  if (isSinglePk) return `    ${name}: ${expression}.primaryKey(),`;
+  if (field.required) expression += ".notNull()";
+  if (field.defaultNow) expression += ".defaultNow()";
+  else if (field.default !== void 0) expression += `.default(${literal(field.default)})`;
+  return `    ${name}: ${expression},`;
+}
+function renderTable(key, table, prefix) {
+  const compositePk = (table.primaryKey?.length ?? 0) > 1;
+  const singlePk = !compositePk ? table.primaryKey?.[0] : void 0;
+  const columns = Object.entries(table.fields).map(([name, field]) => renderColumn(name, field, name === singlePk)).join("\n");
+  const extras = [];
+  for (const declaration of table.indexes ?? []) {
+    const builder = declaration.unique ? "uniqueIndex" : "index";
+    const name = declaration.name ?? `${table.tableName}_${declaration.on.join("_")}_idx`;
+    const columns2 = declaration.on.map((field) => `table.${field}`).join(", ");
+    extras.push(`    ${builder}(${JSON.stringify(prefix + name)}).on(${columns2}),`);
+  }
+  if (compositePk) {
+    const columns2 = (table.primaryKey ?? []).map((field) => `table.${field}`).join(", ");
+    extras.push(`    primaryKey({ columns: [${columns2}] }),`);
+  }
+  const third = extras.length ? `,
+  (table) => [
+${extras.join("\n")}
+  ]` : "";
+  return `export const ${key} = pgTable(
+  ${JSON.stringify(prefix + table.tableName)},
+  {
+${columns}
+  }${third},
+);`;
+}
+function renderDrizzleSchema(schema, prefix = "") {
+  const tables = Object.entries(schema);
+  const used = /* @__PURE__ */ new Set(["pgTable"]);
+  for (const [, table] of tables) {
+    for (const field of Object.values(table.fields)) used.add(COLUMN_BUILDER[field.type]);
+    for (const declaration of table.indexes ?? []) {
+      used.add(declaration.unique ? "uniqueIndex" : "index");
+    }
+    if ((table.primaryKey?.length ?? 0) > 1) used.add("primaryKey");
+  }
+  const imports = [...used].sort().join(", ");
+  const body = tables.map(([key, table]) => renderTable(key, table, prefix)).join("\n\n");
+  return `// Generated by easy-ping. Do not edit by hand.
+import { ${imports} } from "drizzle-orm/pg-core";
+
+${body}
+`;
+}
+
+export { INTROSPECT_SQL, planPostgresMigration, renderDrizzleSchema, renderPostgresDdl };
+//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/render-sql.ts","../src/schema/migrate-sql.ts","../src/schema/render-drizzle.ts"],"names":["indexName","columns","SQL_TYPE","quote","defaultClause"],"mappings":"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","file":"schema.js","sourcesContent":["import type { FieldDeclaration, SchemaDeclaration } from \"../core/plugin\";\nimport { toSnakeCase } from \"./declaration\";\n\nconst SQL_TYPE: Record<FieldDeclaration[\"type\"], string> = {\n  string: \"text\",\n  number: \"integer\",\n  boolean: \"boolean\",\n  date: \"timestamptz\",\n  json: \"jsonb\",\n};\n\nconst quote = (value: string) => `\"${value.replace(/\"/g, '\"\"')}\"`;\n\nconst defaultClause = (field: FieldDeclaration): string => {\n  if (field.defaultNow) return \" DEFAULT now()\";\n  if (field.default === undefined) return \"\";\n  if (typeof field.default === \"string\") return ` DEFAULT '${field.default.replace(/'/g, \"''\")}'`;\n  return ` DEFAULT ${field.default}`;\n};\n\n/** SchemaDeclaration to Postgres DDL, from the same source as the Drizzle renderer. */\nexport function renderPostgresDdl(schema: SchemaDeclaration, prefix = \"\"): string[] {\n  const statements: string[] = [];\n\n  for (const table of Object.values(schema)) {\n    const name = quote(prefix + table.tableName);\n\n    const columns = Object.entries(table.fields).map(([field, spec]) => {\n      const nullability = spec.required ? \" NOT NULL\" : \"\";\n      return `  ${quote(toSnakeCase(field))} ${SQL_TYPE[spec.type]}${nullability}${defaultClause(spec)}`;\n    });\n\n    if (table.primaryKey?.length) {\n      const key = table.primaryKey.map((field) => quote(toSnakeCase(field))).join(\", \");\n      columns.push(`  PRIMARY KEY (${key})`);\n    }\n\n    statements.push(`CREATE TABLE IF NOT EXISTS ${name} (\\n${columns.join(\",\\n\")}\\n)`);\n\n    for (const declaration of table.indexes ?? []) {\n      const indexName = quote(\n        prefix + (declaration.name ?? `${table.tableName}_${declaration.on.join(\"_\")}_idx`),\n      );\n      const columns = declaration.on.map((field) => quote(toSnakeCase(field))).join(\", \");\n      const unique = declaration.unique ? \"UNIQUE \" : \"\";\n      statements.push(`CREATE ${unique}INDEX IF NOT EXISTS ${indexName} ON ${name} (${columns})`);\n    }\n  }\n\n  return statements;\n}\n","import type { FieldDeclaration, SchemaDeclaration, TableDeclaration } from \"../core/plugin\";\nimport { toSnakeCase } from \"./declaration\";\nimport { renderPostgresDdl } from \"./render-sql\";\n\n/**\n * Introspects a live Postgres schema and emits only what is missing.\n *\n * renderPostgresDdl emits CREATE TABLE IF NOT EXISTS, which is correct exactly\n * once. On an existing database it is a silent no-op, so an adopter who\n * bootstrapped with raw SQL had no way to pick up a column a later version\n * added — their app broke at runtime with \"column does not exist\" instead.\n *\n * Additive only, on purpose. Dropping a column or changing a type is\n * destructive and context-dependent, so those are reported in `unsupported`\n * rather than guessed at.\n */\n\nconst SQL_TYPE: Record<FieldDeclaration[\"type\"], string> = {\n  string: \"text\",\n  number: \"integer\",\n  boolean: \"boolean\",\n  date: \"timestamptz\",\n  json: \"jsonb\",\n};\n\n/** What information_schema reports for each of our declared types. */\nconst LIVE_TYPE: Record<FieldDeclaration[\"type\"], readonly string[]> = {\n  string: [\"text\", \"character varying\", \"character\"],\n  number: [\"integer\", \"bigint\", \"smallint\"],\n  boolean: [\"boolean\"],\n  date: [\"timestamp with time zone\", \"timestamp without time zone\"],\n  json: [\"jsonb\", \"json\"],\n};\n\nconst quote = (value: string) => `\"${value.replace(/\"/g, '\"\"')}\"`;\n\nconst defaultClause = (field: FieldDeclaration): string => {\n  if (field.defaultNow) return \" DEFAULT now()\";\n  if (field.default === undefined) return \"\";\n  if (typeof field.default === \"string\") return ` DEFAULT '${field.default.replace(/'/g, \"''\")}'`;\n  return ` DEFAULT ${field.default}`;\n};\n\nconst indexName = (\n  table: TableDeclaration,\n  declaration: { on: readonly string[]; name?: string },\n) => declaration.name ?? `${table.tableName}_${declaration.on.join(\"_\")}_idx`;\n\nexport type LiveColumn = { table: string; column: string; type: string; nullable: boolean };\n\nexport type MigrationPlan = {\n  /** Run in order. Empty means the live schema already matches. */\n  statements: readonly string[];\n  /** Differences this cannot express safely. Read them; they need a human. */\n  unsupported: readonly string[];\n  /** Tables that do not exist yet — these get a full CREATE TABLE. */\n  createdTables: readonly string[];\n};\n\n/**\n * Reads the live column list. Pass a function that runs the query — this\n * module stays driver-agnostic, as the rest of the schema tooling does.\n */\nexport type Introspector = () => Promise<readonly LiveColumn[]>;\n\n/** The query an Introspector should run. Exported so callers need not retype it. */\nexport const INTROSPECT_SQL = `\n  SELECT table_name, column_name, data_type, is_nullable\n  FROM information_schema.columns\n  WHERE table_schema = current_schema()\n`;\n\nexport async function planPostgresMigration(\n  introspect: Introspector,\n  schema: SchemaDeclaration,\n  prefix = \"\",\n): Promise<MigrationPlan> {\n  const live = await introspect();\n\n  const byTable = new Map<string, Map<string, LiveColumn>>();\n  for (const column of live) {\n    const columns = byTable.get(column.table) ?? new Map<string, LiveColumn>();\n    columns.set(column.column, column);\n    byTable.set(column.table, columns);\n  }\n\n  const statements: string[] = [];\n  const unsupported: string[] = [];\n  const createdTables: string[] = [];\n\n  for (const table of Object.values(schema)) {\n    const qualified = prefix + table.tableName;\n    const existing = byTable.get(qualified);\n\n    // Absent entirely: the ordinary bootstrap path still applies.\n    if (!existing || existing.size === 0) {\n      createdTables.push(qualified);\n      statements.push(...renderPostgresDdl({ [table.tableName]: table }, prefix));\n      continue;\n    }\n\n    for (const [field, spec] of Object.entries(table.fields)) {\n      const column = toSnakeCase(field);\n      const found = existing.get(column);\n\n      if (!found) {\n        // NOT NULL on a populated table fails without a default, so a required\n        // column that cannot fill itself is added nullable and flagged.\n        const canFill = spec.defaultNow || spec.default !== undefined;\n        const nullability = spec.required && canFill ? \" NOT NULL\" : \"\";\n\n        statements.push(\n          `ALTER TABLE ${quote(qualified)} ADD COLUMN IF NOT EXISTS ` +\n            `${quote(column)} ${SQL_TYPE[spec.type]}${nullability}${defaultClause(spec)}`,\n        );\n\n        if (spec.required && !canFill) {\n          unsupported.push(\n            `${qualified}.${column} is declared required but has no default; ` +\n              \"it was added nullable. Backfill it, then ALTER ... SET NOT NULL yourself.\",\n          );\n        }\n        continue;\n      }\n\n      if (!LIVE_TYPE[spec.type].includes(found.type)) {\n        unsupported.push(\n          `${qualified}.${column} is ${found.type} but ${spec.type} is declared ` +\n            `(${SQL_TYPE[spec.type]}). Changing a column type can lose data — do it yourself.`,\n        );\n      }\n    }\n\n    // Indexes are cheap and idempotent, so they are re-issued unconditionally.\n    for (const declaration of table.indexes ?? []) {\n      const name = quote(prefix + indexName(table, declaration));\n      const columns = declaration.on.map((field) => quote(toSnakeCase(field))).join(\", \");\n      statements.push(\n        `CREATE ${declaration.unique ? \"UNIQUE \" : \"\"}INDEX IF NOT EXISTS ${name} ` +\n          `ON ${quote(qualified)} (${columns})`,\n      );\n    }\n\n    for (const column of existing.keys()) {\n      const declared = Object.keys(table.fields).some((field) => toSnakeCase(field) === column);\n      if (!declared) {\n        unsupported.push(\n          `${qualified}.${column} exists but is not declared. Left alone — ` +\n            \"drop it yourself if it is ours and no longer needed.\",\n        );\n      }\n    }\n  }\n\n  return { statements, unsupported, createdTables };\n}\n","import type { FieldDeclaration, SchemaDeclaration, TableDeclaration } from \"../core/plugin\";\nimport { toSnakeCase } from \"./declaration\";\n\nconst COLUMN_BUILDER: Record<FieldDeclaration[\"type\"], string> = {\n  string: \"text\",\n  number: \"integer\",\n  boolean: \"boolean\",\n  date: \"timestamp\",\n  json: \"jsonb\",\n};\n\nconst literal = (value: string | number | boolean) =>\n  typeof value === \"string\" ? JSON.stringify(value) : String(value);\n\nfunction renderColumn(name: string, field: FieldDeclaration, isSinglePk: boolean): string {\n  const builder = COLUMN_BUILDER[field.type];\n  const column = toSnakeCase(name);\n\n  let expression =\n    field.type === \"date\"\n      ? `${builder}(${JSON.stringify(column)}, { withTimezone: true })`\n      : `${builder}(${JSON.stringify(column)})`;\n\n  if (isSinglePk) return `    ${name}: ${expression}.primaryKey(),`;\n\n  if (field.required) expression += \".notNull()\";\n  if (field.defaultNow) expression += \".defaultNow()\";\n  else if (field.default !== undefined) expression += `.default(${literal(field.default)})`;\n\n  return `    ${name}: ${expression},`;\n}\n\nfunction renderTable(key: string, table: TableDeclaration, prefix: string): string {\n  const compositePk = (table.primaryKey?.length ?? 0) > 1;\n  const singlePk = !compositePk ? table.primaryKey?.[0] : undefined;\n\n  const columns = Object.entries(table.fields)\n    .map(([name, field]) => renderColumn(name, field, name === singlePk))\n    .join(\"\\n\");\n\n  const extras: string[] = [];\n\n  for (const declaration of table.indexes ?? []) {\n    const builder = declaration.unique ? \"uniqueIndex\" : \"index\";\n    const name = declaration.name ?? `${table.tableName}_${declaration.on.join(\"_\")}_idx`;\n    const columns = declaration.on.map((field) => `table.${field}`).join(\", \");\n    extras.push(`    ${builder}(${JSON.stringify(prefix + name)}).on(${columns}),`);\n  }\n\n  if (compositePk) {\n    const columns = (table.primaryKey ?? []).map((field) => `table.${field}`).join(\", \");\n    extras.push(`    primaryKey({ columns: [${columns}] }),`);\n  }\n\n  const third = extras.length ? `,\\n  (table) => [\\n${extras.join(\"\\n\")}\\n  ]` : \"\";\n\n  return `export const ${key} = pgTable(\\n  ${JSON.stringify(prefix + table.tableName)},\\n  {\\n${columns}\\n  }${third},\\n);`;\n}\n\n/** Renders a SchemaDeclaration to Drizzle pg-core source. */\nexport function renderDrizzleSchema(schema: SchemaDeclaration, prefix = \"\"): string {\n  const tables = Object.entries(schema);\n\n  const used = new Set<string>([\"pgTable\"]);\n  for (const [, table] of tables) {\n    for (const field of Object.values(table.fields)) used.add(COLUMN_BUILDER[field.type]);\n    for (const declaration of table.indexes ?? []) {\n      used.add(declaration.unique ? \"uniqueIndex\" : \"index\");\n    }\n    if ((table.primaryKey?.length ?? 0) > 1) used.add(\"primaryKey\");\n  }\n\n  const imports = [...used].sort().join(\", \");\n  const body = tables.map(([key, table]) => renderTable(key, table, prefix)).join(\"\\n\\n\");\n\n  return `// Generated by easy-ping. Do not edit by hand.\\nimport { ${imports} } from \"drizzle-orm/pg-core\";\\n\\n${body}\\n`;\n}\n"]}

package/dist/testing.cjs

@@ -0,0 +1,342 @@
+'use strict';
+
+// 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`
+      );
+    }
+  }
+];
+
+exports.adapterConformanceCases = adapterConformanceCases;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/conformance.ts"],"names":[],"mappings":"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","file":"testing.cjs","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"]}