agentic-notify 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,18 @@
 
 Notifications for humans and agents: in-app inbox, email and webhook delivery, with a CLI, API, MCP server and SDK.
 
-**Status: 0.1.0, first release.** Works today: the notification model, preferences and mute, digest, an in-memory store and a D1 store (both pass one contract suite), signed webhook and email delivery through a dispatcher, an HTTP API in a Worker, an SDK, a CLI, MCP tools, per-recipient export and erase, and a retention sweep. Not done: a real email provider adapter, webhook endpoint management, and a web UI.
+**Status: 0.2.0.** Breaking for 0.1.0 code and databases, see the CHANGELOG upgrade steps. Works today: the notification model, preferences and mute, digest, a store port from agentic-identity with its memory and D1 adapters, signed webhook and email delivery through a dispatcher, an HTTP API in a Worker, an SDK, a CLI, MCP tools, per-recipient export and erase, and a retention sweep. Not done: a real email provider adapter, webhook endpoint management, and a web UI.
+
+## Live demo
+
+A demo Worker runs at https://agentic-notify-demo.hello-fd1.workers.dev. `GET /health` answers 200. The `/api/v1` routes need a bearer token, so without one they answer 401. The demo keeps its data in the EU and sweeps notifications after 7 days.
+
+Redeploy your own copy with `wrangler.demo.jsonc` (create the D1 database with `--location weur`, put its id in the file, set the `NOTIFY_TOKENS` secret):
+
+```sh
+npx wrangler secret put NOTIFY_TOKENS --config wrangler.demo.jsonc
+WRANGLER_SEND_METRICS=false npm run deploy:demo
+```
 
 ## Install
 
@@ -18,9 +29,9 @@ npm install agentic-notify
 Library, with the memory store:
 
 ```ts
-import { createNotifier, MemoryStore } from "agentic-notify";
+import { createNotifier, createMemoryStore } from "agentic-notify";
 
-const notifier = createNotifier({ store: new MemoryStore() });
+const notifier = createNotifier({ store: createMemoryStore() });
 await notifier.send({
   recipient: { kind: "agent", id: "helper" },
   type: "approval_request",
@@ -78,6 +89,8 @@ Auth is a port: `PrincipalResolver` turns a request into `{ kind: "human" | "age
 ## Privacy
 
 - Export and erase work per recipient. `retentionMs` plus `sweep()` (or a cron trigger on the Worker, with `NOTIFY_RETENTION_DAYS`) deletes old notifications.
+- Erase and sweep delete in batches of 100 inside one transaction each, so a large erase does not cost one query per row.
+- The Worker reads `NOTIFY_REGION` (`eu`, `us` or `unknown`, default `eu`). The D1 adapter refuses a database that does not report a serving region in that area. For local runs without a real D1, set `NOTIFY_REGION=unknown`.
 - Logs hold ids, channel names and error names only. They never hold bodies or addresses.
 - Erase removes a recipient's own notifications and preferences. Notifications that name the person only as actor stay with their recipients.
 

package/dist/{chunk-6CKFBZOF.js → chunk-3N77SYRA.js}

@@ -1,3 +1,6 @@
+// src/index.ts
+import { createMemoryStore } from "agentic-identity";
+
 // src/delivery/dispatch.ts
 function createDispatcher(options) {
   return {
@@ -148,6 +151,7 @@ function createWebhookChannel(options) {
 }
 
 // src/index.ts
+import { createD1Store, D1_SCHEMA } from "agentic-identity/cloudflare";
 var PACKAGE_NAME = "agentic-notify";
 
 export {
@@ -157,5 +161,8 @@ export {
   signPayload,
   verifySignature,
   createWebhookChannel,
-  PACKAGE_NAME
+  PACKAGE_NAME,
+  createMemoryStore,
+  createD1Store,
+  D1_SCHEMA
 };

package/dist/{chunk-FMU2ED2H.js → chunk-6QCYA3X7.js}

@@ -1,14 +1,7 @@
-import {
-  canonicalJson,
-  clampLimit,
-  decodeCursor,
-  encodeCursor
-} from "./chunk-GJFAXI2K.js";
-
 // package.json
 var package_default = {
   name: "agentic-notify",
-  version: "0.1.0",
+  version: "0.2.0",
   description: "Notifications for humans and agents: in-app inbox, webhook and email delivery, with SDK, CLI, MCP server and Worker API.",
   keywords: [
     "notifications",
@@ -69,10 +62,12 @@ var package_default = {
     clean: "rm -rf dist",
     prepack: "npm run build",
     "ci:local": "npm run build && npm run typecheck && npm run check:worker && npm test",
+    "deploy:demo": "wrangler deploy --config wrangler.demo.jsonc",
     "check:worker": "esbuild src/worker.ts --bundle --platform=neutral --format=esm --log-level=warning --outfile=node_modules/.cache/worker-check.js"
   },
   dependencies: {
     "@modelcontextprotocol/sdk": "^1.12.0",
+    "agentic-identity": "^0.4.0",
     hono: "^4.13.14",
     zod: "^3.25.0"
   },
@@ -82,7 +77,8 @@ var package_default = {
     miniflare: "^4.20260730.0",
     tsup: "^8.0.0",
     typescript: "^5.6.0",
-    vitest: "^3.0.0"
+    vitest: "^3.0.0",
+    wrangler: "^4.155.0"
   },
   peerDependencies: {
     vitest: ">=3"
@@ -142,12 +138,18 @@ function recipientKey(recipient) {
   return `${recipient.kind}:${recipient.id}`;
 }
 
-// src/core/service.ts
-import { z as z2 } from "zod";
-
 // src/core/gdpr.ts
 var NOTES = "notifications";
 var PREFS = "preferences";
+var DELETE_BATCH = 100;
+async function deleteAll(store, ids) {
+  for (let i = 0; i < ids.length; i += DELETE_BATCH) {
+    const batch = ids.slice(i, i + DELETE_BATCH);
+    await store.transaction(async (tx) => {
+      for (const id2 of batch) await tx.delete(NOTES, id2);
+    });
+  }
+}
 async function* notificationDocs(store, recipient, ordered = true) {
   let cursor;
   do {
@@ -165,7 +167,7 @@ async function* notificationDocs(store, recipient, ordered = true) {
 async function exportRecipient(store, recipient) {
   const notifications = [];
   for await (const item of notificationDocs(store, recipient, false)) {
-    const { recipientKey: _drop, ...rest } = item.doc;
+    const { recipientKey: _drop, ...rest } = item.data;
     notifications.push(notificationSchema.parse(rest));
   }
   notifications.sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : 1));
@@ -179,7 +181,7 @@ async function eraseRecipient(store, recipient) {
     const ids = [];
     for await (const item of notificationDocs(store, recipient, false)) ids.push(item.id);
     if (ids.length === 0) break;
-    for (const id2 of ids) await store.delete(NOTES, id2);
+    await deleteAll(store, ids);
     removed += ids.length;
   }
   await store.delete(PREFS, recipientKey(recipient));
@@ -192,20 +194,19 @@ async function sweepBefore(store, cutoff) {
   const gone = /* @__PURE__ */ new Set();
   for (; ; ) {
     const page = await store.query(NOTES, { orderBy: { field: "createdAt", direction: "asc" }, limit });
-    const old = page.items.filter((i) => typeof i.doc.createdAt === "number" && i.doc.createdAt < cutoff);
+    const old = page.items.filter((i) => typeof i.data.createdAt === "number" && i.data.createdAt < cutoff);
     if (old.some((i) => gone.has(i.id))) throw new Error("retention sweep did not finish: deletes had no effect");
-    for (const item of old) {
-      await store.delete(NOTES, item.id);
-      gone.add(item.id);
-    }
+    await deleteAll(store, old.map((i) => i.id));
+    for (const item of old) gone.add(item.id);
     removed += old.length;
     if (old.length > 0) continue;
-    if (page.items.length < limit || page.items.some((i) => typeof i.doc.createdAt === "number")) return removed;
+    if (page.items.length < limit || page.items.some((i) => typeof i.data.createdAt === "number")) return removed;
     throw new Error("retention sweep blocked: a full page of notifications has no usable createdAt");
   }
 }
 
 // src/core/service.ts
+import { z as z2 } from "zod";
 var NotFoundError = class extends Error {
   code = "NOT_FOUND";
   constructor(message = "notification not found") {
@@ -220,6 +221,22 @@ function fromDoc(doc) {
   const { recipientKey: _drop, ...rest } = doc;
   return notificationSchema.parse(rest);
 }
+var DEFAULT_LIMIT = 50;
+var MAX_LIMIT = 200;
+function clampLimit(limit) {
+  if (limit === void 0) return DEFAULT_LIMIT;
+  if (!Number.isInteger(limit) || limit < 1) throw new RangeError("limit must be an integer of 1 or more");
+  return Math.min(limit, MAX_LIMIT);
+}
+function checkCursor(cursor) {
+  try {
+    const bytes = Uint8Array.from(atob(cursor.replace(/-/g, "+").replace(/_/g, "/")), (c) => c.charCodeAt(0));
+    const parsed = JSON.parse(new TextDecoder().decode(bytes));
+    if (Array.isArray(parsed) && parsed.length === 2 && Number.isFinite(parsed[0]) && typeof parsed[1] === "string") return;
+  } catch {
+  }
+  throw new RangeError("bad cursor");
+}
 function createNotifier(options) {
   const { store } = options;
   const now = options.now ?? (() => Date.now());
@@ -253,41 +270,43 @@ function createNotifier(options) {
       readAt: null
     });
     if (!channels.includes("inbox")) return { notification, stored: false, channels, muted: false };
-    if (!await store.create(NOTES, notification.id, toDoc(notification))) {
-      throw new Error("notification id collision");
-    }
+    await store.transaction(async (tx) => {
+      if (await tx.get(NOTES, notification.id)) throw new Error("notification id collision");
+      await tx.put(NOTES, notification.id, toDoc(notification));
+    });
     return { notification, stored: true, channels, muted: false };
   }
   async function list(recipient, opts = {}) {
     const r = recipientSchema.parse(recipient);
     const where = { recipientKey: recipientKey(r) };
     if (opts.unreadOnly) where.readAt = null;
+    if (opts.cursor !== void 0) checkCursor(opts.cursor);
+    const limit = clampLimit(opts.limit);
     const page = await store.query(NOTES, {
       where,
       orderBy: { field: "createdAt", direction: "desc" },
-      limit: opts.limit,
+      limit,
       cursor: opts.cursor
     });
-    return { items: page.items.map((i) => fromDoc(i.doc)), nextCursor: page.nextCursor };
+    return { items: page.items.map((i) => fromDoc(i.data)), nextCursor: page.nextCursor ?? null };
   }
-  async function load(recipient, id2) {
-    const r = recipientSchema.parse(recipient);
-    const doc = await store.get(NOTES, id2);
-    if (!doc || doc.recipientKey !== recipientKey(r)) throw new NotFoundError();
+  function check(doc, recipient) {
+    if (!doc || doc.recipientKey !== recipientKey(recipient)) throw new NotFoundError();
     return doc;
   }
   async function get(recipient, id2) {
-    return fromDoc(await load(recipient, id2));
+    const r = recipientSchema.parse(recipient);
+    return fromDoc(check(await store.get(NOTES, id2), r));
   }
   async function markReadOnce(recipient, id2) {
-    for (let attempt = 0; attempt < 5; attempt++) {
-      const doc = await load(recipient, id2);
-      const n = fromDoc(doc);
+    const r = recipientSchema.parse(recipient);
+    return store.transaction(async (tx) => {
+      const n = fromDoc(check(await tx.get(NOTES, id2), r));
       if (n.readAt !== null) return { notification: n, won: false };
       const next = notificationSchema.parse({ ...n, readAt: now() });
-      if (await store.replaceIf(NOTES, id2, doc, toDoc(next))) return { notification: next, won: true };
-    }
-    throw new Error("could not mark read: too much contention");
+      await tx.put(NOTES, id2, toDoc(next));
+      return { notification: next, won: true };
+    });
   }
   async function markRead(recipient, id2) {
     return (await markReadOnce(recipient, id2)).notification;
@@ -366,108 +385,6 @@ function createNotifier(options) {
   };
 }
 
-// src/adapters/d1.ts
-var FIELD = /^[A-Za-z_][A-Za-z0-9_]{0,63}$/;
-var SCHEMA = `CREATE TABLE IF NOT EXISTS notify_docs (
-  collection TEXT NOT NULL,
-  id TEXT NOT NULL,
-  doc TEXT NOT NULL,
-  PRIMARY KEY (collection, id)
-)`;
-function field(name) {
-  if (!FIELD.test(name)) throw new RangeError("bad field name");
-  return `json_extract(doc, '$.${name}')`;
-}
-function bindable(v) {
-  return typeof v === "boolean" ? v ? 1 : 0 : v;
-}
-var TYPES = {
-  number: ["integer", "real"],
-  string: ["text"],
-  boolean: ["true", "false"]
-};
-var INDEXES = [
-  `CREATE INDEX IF NOT EXISTS notify_by_recipient ON notify_docs (collection, json_extract(doc, '$.recipientKey'), json_extract(doc, '$.createdAt'), id)`,
-  `CREATE INDEX IF NOT EXISTS notify_by_created ON notify_docs (collection, json_extract(doc, '$.createdAt'), id)`
-];
-async function migrateD1(db) {
-  for (const sql of [SCHEMA, ...INDEXES]) await db.prepare(sql).bind().run();
-}
-var D1Store = class {
-  constructor(db) {
-    this.db = db;
-  }
-  db;
-  async get(collection, id2) {
-    const row = await this.db.prepare("SELECT doc FROM notify_docs WHERE collection = ? AND id = ?").bind(collection, id2).first();
-    return row ? JSON.parse(row.doc) : null;
-  }
-  async put(collection, id2, doc) {
-    await this.db.prepare("INSERT OR REPLACE INTO notify_docs (collection, id, doc) VALUES (?, ?, ?)").bind(collection, id2, canonicalJson(doc)).run();
-  }
-  async create(collection, id2, doc) {
-    const res = await this.db.prepare("INSERT OR IGNORE INTO notify_docs (collection, id, doc) VALUES (?, ?, ?)").bind(collection, id2, canonicalJson(doc)).run();
-    return (res.meta.changes ?? 0) > 0;
-  }
-  async replaceIf(collection, id2, expected, next) {
-    const res = await this.db.prepare("UPDATE notify_docs SET doc = ? WHERE collection = ? AND id = ? AND doc = ?").bind(canonicalJson(next), collection, id2, canonicalJson(expected)).run();
-    return (res.meta.changes ?? 0) > 0;
-  }
-  async delete(collection, id2) {
-    await this.db.prepare("DELETE FROM notify_docs WHERE collection = ? AND id = ?").bind(collection, id2).run();
-  }
-  async query(collection, query = {}) {
-    const limit = clampLimit(query.limit);
-    const desc = query.orderBy?.direction === "desc";
-    const key = query.orderBy ? field(query.orderBy.field) : "id";
-    const conds = ["collection = ?"];
-    const args = [collection];
-    for (const [name, value] of Object.entries(query.where ?? {})) {
-      if (value === null) conds.push(`${field(name)} IS NULL`);
-      else {
-        const types = TYPES[typeof value] ?? [];
-        conds.push(`${field(name)} = ? AND json_type(doc, '$.${name}') IN (${types.map(() => "?").join(",")})`);
-        args.push(bindable(value), ...types);
-      }
-    }
-    if (query.cursor !== void 0) {
-      const [cv, cid] = decodeCursor(query.cursor);
-      if (query.orderBy && cv !== null) {
-        const allowed = TYPES[typeof cv] ?? [];
-        const marks = allowed.map(() => "?").join(",");
-        const bad = await this.db.prepare(
-          `SELECT 1 AS x FROM notify_docs WHERE ${conds.join(" AND ")} AND ${key} IS NOT NULL AND json_type(doc, '$.${query.orderBy.field}') NOT IN (${marks}) LIMIT 1`
-        ).bind(...args, ...allowed).first();
-        if (bad) throw new RangeError("bad cursor");
-      }
-      const idCmp = desc ? "<" : ">";
-      if (!query.orderBy) {
-        conds.push(`id ${idCmp} ?`);
-        args.push(cid);
-      } else if (cv === null) {
-        conds.push(desc ? `(${key} IS NULL AND id < ?)` : `(${key} IS NOT NULL OR id > ?)`);
-        args.push(cid);
-      } else if (desc) {
-        conds.push(`(${key} < ? OR ${key} IS NULL OR (${key} = ? AND id < ?))`);
-        args.push(bindable(cv), bindable(cv), cid);
-      } else {
-        conds.push(`(${key} > ? OR (${key} = ? AND id > ?))`);
-        args.push(bindable(cv), bindable(cv), cid);
-      }
-    }
-    const dir = desc ? "DESC" : "ASC";
-    const sql = `SELECT id, doc FROM notify_docs WHERE ${conds.join(" AND ")} ORDER BY ${key} ${dir}, id ${dir} LIMIT ?`;
-    const { results } = await this.db.prepare(sql).bind(...args, limit + 1).all();
-    const rows = results.slice(0, limit).map((r) => ({ id: r.id, doc: JSON.parse(r.doc) }));
-    const last = rows[rows.length - 1];
-    const lastKey = last && query.orderBy ? last.doc[query.orderBy.field] ?? null : last?.id ?? null;
-    return {
-      items: rows,
-      nextCursor: results.length > limit && last ? encodeCursor(lastKey, last.id) : null
-    };
-  }
-};
-
 export {
   VERSION,
   CHANNELS,
@@ -478,8 +395,7 @@ export {
   DEFAULT_CHANNELS,
   defaultPreferences,
   recipientKey,
+  NOTES,
   NotFoundError,
-  createNotifier,
-  migrateD1,
-  D1Store
+  createNotifier
 };

package/dist/{chunk-DEPJ3SHO.js → chunk-POSHKDNY.js}

@@ -1,6 +1,6 @@
 import {
   PACKAGE_NAME
-} from "./chunk-6CKFBZOF.js";
+} from "./chunk-3N77SYRA.js";
 import {
   ApiError
 } from "./chunk-FJPEUDTG.js";
@@ -10,7 +10,7 @@ import {
   recipientSchema,
   resourceRefSchema,
   typeNameSchema
-} from "./chunk-FMU2ED2H.js";
+} from "./chunk-6QCYA3X7.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PACKAGE_NAME
-} from "./chunk-6CKFBZOF.js";
+} from "./chunk-3N77SYRA.js";
 import {
   ApiError,
   createClient
@@ -9,8 +9,7 @@ import {
 import "./chunk-KJKM56FT.js";
 import {
   VERSION
-} from "./chunk-FMU2ED2H.js";
-import "./chunk-GJFAXI2K.js";
+} from "./chunk-6QCYA3X7.js";
 
 // src/cli.ts
 import { realpathSync } from "fs";

package/dist/{d1-CUcNko0m.d.ts → dispatch-LBnkLOQg.d.ts}

@@ -1,6 +1,7 @@
-import { R as RecipientExport } from './gdpr-9I4eV86m.js';
-import { S as Store, D as DeliveryChannel, L as Logger, b as Doc, Q as Query, P as Page } from './types-Dkst26cb.js';
-import { S as SendInput, N as Notification, b as Channel, R as Recipient, D as Digest, P as Preferences } from './types-GuAgyMOc.js';
+import { R as RecipientExport } from './gdpr-CUq5MUwo.js';
+import { Store } from 'agentic-identity';
+import { S as SendInput, N as Notification, C as Channel, R as Recipient, D as Digest, P as Preferences } from './types-C842YAMe.js';
+import { D as DeliveryChannel, L as Logger } from './types-DONKNIOo.js';
 
 interface NotifierOptions {
     store: Store;
@@ -73,34 +74,4 @@ declare function createDispatcher(options: DispatcherOptions): {
     notify(input: SendInput): Promise<DispatchResult>;
 };
 
-/** The slice of the Cloudflare D1 binding this adapter uses. */
-interface D1Like {
-    prepare(sql: string): {
-        bind(...values: unknown[]): {
-            first<T = unknown>(): Promise<T | null>;
-            all<T = unknown>(): Promise<{
-                results: T[];
-            }>;
-            run(): Promise<{
-                meta: {
-                    changes?: number;
-                };
-            }>;
-        };
-    };
-}
-/** Create the table and indexes. Safe to run on every start. */
-declare function migrateD1(db: D1Like): Promise<void>;
-/** Store adapter for Cloudflare D1. Run `migrateD1` once first. */
-declare class D1Store implements Store {
-    private readonly db;
-    constructor(db: D1Like);
-    get(collection: string, id: string): Promise<Doc | null>;
-    put(collection: string, id: string, doc: Doc): Promise<void>;
-    create(collection: string, id: string, doc: Doc): Promise<boolean>;
-    replaceIf(collection: string, id: string, expected: Doc, next: Doc): Promise<boolean>;
-    delete(collection: string, id: string): Promise<void>;
-    query(collection: string, query?: Query): Promise<Page>;
-}
-
-export { type D1Like as D, type ListOptions as L, NotFoundError as N, type SendResult as S, D1Store as a, type DispatchResult as b, type DispatcherOptions as c, type ListResult as d, type Notifier as e, type NotifierOptions as f, createDispatcher as g, createNotifier as h, migrateD1 as m };
+export { type DispatchResult as D, type ListOptions as L, NotFoundError as N, type SendResult as S, type DispatcherOptions as a, type ListResult as b, type Notifier as c, type NotifierOptions as d, createDispatcher as e, createNotifier as f };

package/dist/{gdpr-9I4eV86m.d.ts → gdpr-CUq5MUwo.d.ts}

@@ -1,4 +1,4 @@
-import { R as Recipient, P as Preferences, N as Notification } from './types-GuAgyMOc.js';
+import { R as Recipient, P as Preferences, N as Notification } from './types-C842YAMe.js';
 
 interface RecipientExport {
     recipient: Recipient;

package/dist/index.d.ts

@@ -1,11 +1,14 @@
-export { D as D1Like, a as D1Store, b as DispatchResult, c as DispatcherOptions, L as ListOptions, d as ListResult, N as NotFoundError, e as Notifier, f as NotifierOptions, S as SendResult, g as createDispatcher, h as createNotifier, m as migrateD1 } from './d1-CUcNko0m.js';
-import { D as DeliveryChannel } from './types-Dkst26cb.js';
-export { a as DeliveryError, b as Doc, L as Logger, M as MemoryStore, P as Page, Q as Query, c as Scalar, S as Store } from './types-Dkst26cb.js';
-import { R as Recipient } from './types-GuAgyMOc.js';
-export { A as Actor, C as CHANNELS, b as Channel, c as DEFAULT_CHANNELS, D as Digest, d as DigestGroup, N as Notification, P as Preferences, a as ResourceRef, S as SendInput, e as defaultPreferences, r as recipientKey } from './types-GuAgyMOc.js';
-export { E as EmailChannelOptions, a as EmailMessage, b as EmailPort, c as createEmailChannel } from './email-UqtllxjF.js';
-export { R as RecipientExport } from './gdpr-9I4eV86m.js';
+export { D as DispatchResult, a as DispatcherOptions, L as ListOptions, b as ListResult, N as NotFoundError, c as Notifier, d as NotifierOptions, S as SendResult, e as createDispatcher, f as createNotifier } from './dispatch-LBnkLOQg.js';
+export { Doc, Page, Query, Scalar, Store, StoreOps, createMemoryStore } from 'agentic-identity';
+import { R as Recipient } from './types-C842YAMe.js';
+export { A as Actor, b as CHANNELS, C as Channel, c as DEFAULT_CHANNELS, D as Digest, d as DigestGroup, N as Notification, P as Preferences, a as ResourceRef, S as SendInput, e as defaultPreferences, r as recipientKey } from './types-C842YAMe.js';
+import { D as DeliveryChannel } from './types-DONKNIOo.js';
+export { a as DeliveryError, L as Logger } from './types-DONKNIOo.js';
+export { E as EmailChannelOptions, a as EmailMessage, b as EmailPort, c as createEmailChannel } from './testing-B5slvYDV.js';
+export { D1Like, D1_SCHEMA, createD1Store } from 'agentic-identity/cloudflare';
+export { R as RecipientExport } from './gdpr-CUq5MUwo.js';
 import 'zod';
+import 'agentic-identity/testing';
 
 declare const VERSION: string;
 

package/dist/index.js

@@ -1,45 +1,43 @@
 import {
+  D1_SCHEMA,
   DeliveryError,
   PACKAGE_NAME,
   SIGNATURE_HEADER,
+  createD1Store,
   createDispatcher,
+  createMemoryStore,
   createWebhookChannel,
   signPayload,
   verifySignature
-} from "./chunk-6CKFBZOF.js";
+} from "./chunk-3N77SYRA.js";
 import {
   createEmailChannel
 } from "./chunk-KJKM56FT.js";
 import {
   CHANNELS,
-  D1Store,
   DEFAULT_CHANNELS,
   NotFoundError,
   VERSION,
   createNotifier,
   defaultPreferences,
-  migrateD1,
   recipientKey
-} from "./chunk-FMU2ED2H.js";
-import {
-  MemoryStore
-} from "./chunk-GJFAXI2K.js";
+} from "./chunk-6QCYA3X7.js";
 export {
   CHANNELS,
-  D1Store,
+  D1_SCHEMA,
   DEFAULT_CHANNELS,
   DeliveryError,
-  MemoryStore,
   NotFoundError,
   PACKAGE_NAME,
   SIGNATURE_HEADER,
   VERSION,
+  createD1Store,
   createDispatcher,
   createEmailChannel,
+  createMemoryStore,
   createNotifier,
   createWebhookChannel,
   defaultPreferences,
-  migrateD1,
   recipientKey,
   signPayload,
   verifySignature

package/dist/mcp-bin.js

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 import {
   startMcp
-} from "./chunk-DEPJ3SHO.js";
-import "./chunk-6CKFBZOF.js";
+} from "./chunk-POSHKDNY.js";
+import "./chunk-3N77SYRA.js";
 import {
   createClient
 } from "./chunk-FJPEUDTG.js";
 import "./chunk-KJKM56FT.js";
-import "./chunk-FMU2ED2H.js";
-import "./chunk-GJFAXI2K.js";
+import "./chunk-6QCYA3X7.js";
 
 // src/mcp-bin.ts
 var { NOTIFY_URL, NOTIFY_TOKEN } = process.env;

package/dist/mcp.d.ts

@@ -1,8 +1,8 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Client } from './sdk.js';
-import './types-GuAgyMOc.js';
+import './types-C842YAMe.js';
 import 'zod';
-import './gdpr-9I4eV86m.js';
+import './gdpr-CUq5MUwo.js';
 
 /** Without a client, only `ping` works and the other tools report that setup is missing. */
 declare function createMcpServer(client?: Client): McpServer;

package/dist/mcp.js

@@ -1,12 +1,11 @@
 import {
   createMcpServer,
   startMcp
-} from "./chunk-DEPJ3SHO.js";
-import "./chunk-6CKFBZOF.js";
+} from "./chunk-POSHKDNY.js";
+import "./chunk-3N77SYRA.js";
 import "./chunk-FJPEUDTG.js";
 import "./chunk-KJKM56FT.js";
-import "./chunk-FMU2ED2H.js";
-import "./chunk-GJFAXI2K.js";
+import "./chunk-6QCYA3X7.js";
 export {
   createMcpServer,
   startMcp

package/dist/sdk.d.ts

@@ -1,5 +1,5 @@
-import { N as Notification, D as Digest, P as Preferences, R as Recipient, a as ResourceRef } from './types-GuAgyMOc.js';
-import { R as RecipientExport } from './gdpr-9I4eV86m.js';
+import { N as Notification, D as Digest, P as Preferences, R as Recipient, a as ResourceRef } from './types-C842YAMe.js';
+import { R as RecipientExport } from './gdpr-CUq5MUwo.js';
 import 'zod';
 
 declare class ApiError extends Error {

package/dist/{email-UqtllxjF.d.ts → testing-B5slvYDV.d.ts}

@@ -1,5 +1,6 @@
-import { R as Recipient } from './types-GuAgyMOc.js';
-import { D as DeliveryChannel } from './types-Dkst26cb.js';
+import 'agentic-identity/testing';
+import { R as Recipient } from './types-C842YAMe.js';
+import { D as DeliveryChannel } from './types-DONKNIOo.js';
 
 interface EmailMessage {
     to: string;

package/dist/testing.d.ts

@@ -1,13 +1,5 @@
-import { S as Store } from './types-Dkst26cb.js';
-export { T as TestEmailAdapter } from './email-UqtllxjF.js';
-import './types-GuAgyMOc.js';
+export { runStoreContract } from 'agentic-identity/testing';
+export { T as TestEmailAdapter } from './testing-B5slvYDV.js';
+import './types-C842YAMe.js';
 import 'zod';
-
-/**
- * Contract suite for the Store port. Run it on every adapter.
- * `make` must return a fresh store. When two calls share one backing
- * database, the concurrency tests use both handles.
- */
-declare function storeContract(name: string, make: () => Promise<Store>, makePeer?: (s: Store) => Promise<Store>): void;
-
-export { storeContract };
+import './types-DONKNIOo.js';

package/dist/testing.js

@@ -1,155 +1,10 @@
 import {
   TestEmailAdapter
 } from "./chunk-KJKM56FT.js";
-import {
-  encodeCursor
-} from "./chunk-GJFAXI2K.js";
 
 // src/testing.ts
-import { describe, expect, test } from "vitest";
-function storeContract(name, make, makePeer) {
-  describe(`Store contract: ${name}`, () => {
-    test("get returns null for a missing doc, put then get round-trips", async () => {
-      const s = await make();
-      expect(await s.get("c", "a")).toBeNull();
-      await s.put("c", "a", { n: 1, s: "x", t: true, z: null });
-      expect(await s.get("c", "a")).toEqual({ n: 1, s: "x", t: true, z: null });
-    });
-    test("collections are separate", async () => {
-      const s = await make();
-      await s.put("c1", "a", { v: 1 });
-      expect(await s.get("c2", "a")).toBeNull();
-    });
-    test("create refuses an existing id and keeps the old doc", async () => {
-      const s = await make();
-      expect(await s.create("c", "a", { v: 1 })).toBe(true);
-      expect(await s.create("c", "a", { v: 2 })).toBe(false);
-      expect(await s.get("c", "a")).toEqual({ v: 1 });
-    });
-    test("only one of two racing creates wins", async () => {
-      const s = await make();
-      const peer = makePeer ? await makePeer(s) : s;
-      const results = await Promise.all([s.create("c", "a", { v: 1 }), peer.create("c", "a", { v: 2 })]);
-      expect(results.filter(Boolean)).toHaveLength(1);
-    });
-    test("replaceIf swaps only when the doc is unchanged", async () => {
-      const s = await make();
-      await s.put("c", "a", { v: 1 });
-      expect(await s.replaceIf("c", "a", { v: 9 }, { v: 2 })).toBe(false);
-      expect(await s.replaceIf("c", "a", { v: 1 }, { v: 2 })).toBe(true);
-      expect(await s.get("c", "a")).toEqual({ v: 2 });
-      expect(await s.replaceIf("c", "missing", { v: 1 }, { v: 2 })).toBe(false);
-    });
-    test("replaceIf equality ignores key order", async () => {
-      const s = await make();
-      await s.put("c", "a", { a: 1, b: { x: 1, y: 2 } });
-      expect(await s.replaceIf("c", "a", { b: { y: 2, x: 1 }, a: 1 }, { a: 2 })).toBe(true);
-    });
-    test("only one of two racing replaceIf calls wins", async () => {
-      const s = await make();
-      const peer = makePeer ? await makePeer(s) : s;
-      await s.put("c", "a", { v: 0 });
-      const results = await Promise.all([
-        s.replaceIf("c", "a", { v: 0 }, { v: 1 }),
-        peer.replaceIf("c", "a", { v: 0 }, { v: 2 })
-      ]);
-      expect(results.filter(Boolean)).toHaveLength(1);
-    });
-    test("delete removes a doc and ignores a missing one", async () => {
-      const s = await make();
-      await s.put("c", "a", { v: 1 });
-      await s.delete("c", "a");
-      await s.delete("c", "a");
-      expect(await s.get("c", "a")).toBeNull();
-    });
-    test("query filters on equality, including null", async () => {
-      const s = await make();
-      await s.put("c", "a", { k: "x", r: null });
-      await s.put("c", "b", { k: "x", r: 5 });
-      await s.put("c", "c", { k: "y", r: null });
-      const ids = async (where) => (await s.query("c", { where, orderBy: { field: "k", direction: "asc" } })).items.map((i) => i.id).sort();
-      expect(await ids({ k: "x" })).toEqual(["a", "b"]);
-      expect(await ids({ k: "x", r: null })).toEqual(["a"]);
-      expect(await ids({ r: 5 })).toEqual(["b"]);
-      expect(await ids({ k: "none" })).toEqual([]);
-    });
-    test("equality filters respect the value type", async () => {
-      const s = await make();
-      await s.put("c", "t", { f: true, o: { a: 1 } });
-      await s.put("c", "u", { f: 1, o: '{"a":1}' });
-      await s.put("c", "v", { f: "1", o: [1] });
-      const ids = async (where) => (await s.query("c", { where })).items.map((i) => i.id).sort();
-      expect(await ids({ f: true })).toEqual(["t"]);
-      expect(await ids({ f: 1 })).toEqual(["u"]);
-      expect(await ids({ f: "1" })).toEqual(["v"]);
-      expect(await ids({ o: '{"a":1}' })).toEqual(["u"]);
-    });
-    test("query orders by one field and breaks ties by id", async () => {
-      const s = await make();
-      for (const [id, n] of [["b", 2], ["a", 2], ["c", 1], ["d", 3]]) await s.put("c", id, { n });
-      const order = async (direction) => (await s.query("c", { orderBy: { field: "n", direction } })).items.map((i) => i.id);
-      expect(await order("asc")).toEqual(["c", "a", "b", "d"]);
-      expect(await order("desc")).toEqual(["d", "b", "a", "c"]);
-    });
-    test("cursor paging walks every doc once, in both directions", async () => {
-      const s = await make();
-      for (let i = 0; i < 7; i++) await s.put("c", `id${i}`, { n: i % 3 });
-      for (const direction of ["asc", "desc"]) {
-        const seen = [];
-        let cursor;
-        let pages = 0;
-        do {
-          const page = await s.query("c", { orderBy: { field: "n", direction }, limit: 3, cursor });
-          seen.push(...page.items.map((i) => i.id));
-          cursor = page.nextCursor ?? void 0;
-          pages++;
-        } while (cursor);
-        const whole = (await s.query("c", { orderBy: { field: "n", direction }, limit: 50 })).items.map((i) => i.id);
-        expect(pages).toBe(3);
-        expect(seen).toEqual(whole);
-        expect(new Set(seen).size).toBe(7);
-      }
-    });
-    test("cursor paging works with a filter and with no orderBy", async () => {
-      const s = await make();
-      for (let i = 0; i < 6; i++) await s.put("c", `id${i}`, { g: i % 2 === 0 ? "even" : "odd", n: i });
-      const walk = async (query) => {
-        const seen = [];
-        let cursor;
-        do {
-          const page = await s.query("c", { ...query, limit: 2, cursor });
-          seen.push(...page.items.map((i) => i.id));
-          cursor = page.nextCursor ?? void 0;
-        } while (cursor);
-        return seen;
-      };
-      expect(await walk({ where: { g: "even" }, orderBy: { field: "n", direction: "desc" } })).toEqual(["id4", "id2", "id0"]);
-      expect(await walk({})).toEqual(["id0", "id1", "id2", "id3", "id4", "id5"]);
-    });
-    test("a cursor of the wrong type for the sort field is rejected", async () => {
-      const s = await make();
-      await s.put("c", "a", { n: 1 });
-      await s.put("c", "b", { n: 2 });
-      await expect(s.query("c", { orderBy: { field: "n", direction: "asc" }, cursor: encodeCursor("abc", "a") })).rejects.toThrow();
-    });
-    test("bad limit and bad cursor are rejected", async () => {
-      const s = await make();
-      await expect(s.query("c", { limit: 0 })).rejects.toThrow();
-      await expect(s.query("c", { cursor: "%%%" })).rejects.toThrow();
-    });
-    test("stored docs are copies", async () => {
-      const s = await make();
-      const doc = { nested: { v: 1 } };
-      await s.put("c", "a", doc);
-      doc.nested.v = 2;
-      const got = await s.get("c", "a");
-      expect(got.nested.v).toBe(1);
-      got.nested.v = 3;
-      expect((await s.get("c", "a")).nested.v).toBe(1);
-    });
-  });
-}
+import { runStoreContract } from "agentic-identity/testing";
 export {
   TestEmailAdapter,
-  storeContract
+  runStoreContract
 };

package/dist/{types-GuAgyMOc.d.ts → types-C842YAMe.d.ts}

@@ -214,4 +214,4 @@ interface Digest {
     groups: DigestGroup[];
 }
 
-export { type Actor as A, CHANNELS as C, type Digest as D, type Notification as N, type Preferences as P, type Recipient as R, type SendInput as S, type ResourceRef as a, type Channel as b, DEFAULT_CHANNELS as c, type DigestGroup as d, defaultPreferences as e, recipientKey as r };
+export { type Actor as A, type Channel as C, type Digest as D, type Notification as N, type Preferences as P, type Recipient as R, type SendInput as S, type ResourceRef as a, CHANNELS as b, DEFAULT_CHANNELS as c, type DigestGroup as d, defaultPreferences as e, recipientKey as r };

package/dist/types-DONKNIOo.d.ts

@@ -0,0 +1,20 @@
+import { N as Notification } from './types-C842YAMe.js';
+
+/** A delivery channel other than the inbox. */
+interface DeliveryChannel {
+    /** Resolves "skipped" when the recipient has no target (no endpoint, no address). Throws on failure. */
+    deliver(notification: Notification): Promise<"sent" | "skipped">;
+}
+declare class DeliveryError extends Error {
+    readonly attempts: number;
+    readonly code = "DELIVERY_FAILED";
+    constructor(message: string, attempts: number, options?: {
+        cause?: unknown;
+    });
+}
+/** Logger that takes ids and counts only. Never pass content or addresses. */
+interface Logger {
+    warn(message: string, fields?: Record<string, string | number>): void;
+}
+
+export { type DeliveryChannel as D, type Logger as L, DeliveryError as a };

package/dist/worker.d.ts

@@ -1,8 +1,10 @@
 import { z } from 'zod';
-import { e as Notifier, g as createDispatcher, D as D1Like } from './d1-CUcNko0m.js';
-import { R as Recipient } from './types-GuAgyMOc.js';
-import './gdpr-9I4eV86m.js';
-import './types-Dkst26cb.js';
+import { c as Notifier, e as createDispatcher } from './dispatch-LBnkLOQg.js';
+import { R as Recipient } from './types-C842YAMe.js';
+import { D1Like } from 'agentic-identity/cloudflare';
+import './gdpr-CUq5MUwo.js';
+import 'agentic-identity';
+import './types-DONKNIOo.js';
 
 /** Who is calling. `kind` has no default: a missing kind is an error. */
 declare const principalSchema: z.ZodObject<{
@@ -11,12 +13,12 @@ declare const principalSchema: z.ZodObject<{
     /** Allowed to send notifications to others. */
     canSend: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    id: string;
     kind: "human" | "agent";
+    id: string;
     canSend?: boolean | undefined;
 }, {
-    id: string;
     kind: "human" | "agent";
+    id: string;
     canSend?: boolean | undefined;
 }>;
 type Principal = z.infer<typeof principalSchema>;
@@ -38,6 +40,8 @@ interface WorkerEnv {
     DB?: D1Like;
     /** Secret. JSON map of bearer token (32 bytes or more) to principal. */
     NOTIFY_TOKENS?: string;
+    /** Data region of the store: "eu", "us" or "unknown". Default "eu". */
+    NOTIFY_REGION?: string;
     /** Retention window in days. Unset keeps notifications. */
     NOTIFY_RETENTION_DAYS?: string;
 }

package/dist/worker.js

@@ -1,15 +1,13 @@
 import {
-  D1Store,
+  NOTES,
   NotFoundError,
   VERSION,
   createNotifier,
-  migrateD1,
   preferencesSchema,
   recipientSchema,
   resourceRefSchema,
   typeNameSchema
-} from "./chunk-FMU2ED2H.js";
-import "./chunk-GJFAXI2K.js";
+} from "./chunk-6QCYA3X7.js";
 
 // src/api.ts
 import { Hono } from "hono";
@@ -113,17 +111,27 @@ function createApp(options) {
 }
 
 // src/worker.ts
+import { parseRegion } from "agentic-identity";
+import { createD1Store, D1_SCHEMA } from "agentic-identity/cloudflare";
 function json(value, status = 200) {
   return new Response(JSON.stringify(value), { status, headers: { "content-type": "application/json" } });
 }
+async function hasLegacyRows(db) {
+  const table = await db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'notify_docs'").bind().first();
+  if (!table) return false;
+  return await db.prepare("SELECT 1 AS found FROM notify_docs LIMIT 1").bind().first() !== null;
+}
 function createWorker(config) {
   const apps = /* @__PURE__ */ new WeakMap();
   async function buildNotifier(env) {
     if (!env.DB) return null;
-    await migrateD1(env.DB);
+    if (await hasLegacyRows(env.DB)) throw new Error("notify_docs holds rows that were not copied to store_docs");
+    await env.DB.prepare(D1_SCHEMA).bind().run();
     const days = env.NOTIFY_RETENTION_DAYS === void 0 ? void 0 : Number(env.NOTIFY_RETENTION_DAYS);
+    const store = createD1Store(env.DB, { region: parseRegion(env.NOTIFY_REGION ?? "eu") });
+    await store.query(NOTES, { limit: 1 });
     return createNotifier({
-      store: new D1Store(env.DB),
+      store,
       retentionMs: days === void 0 ? void 0 : days * 864e5
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-notify",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Notifications for humans and agents: in-app inbox, webhook and email delivery, with SDK, CLI, MCP server and Worker API.",
   "keywords": [
     "notifications",
@@ -61,10 +61,12 @@
     "clean": "rm -rf dist",
     "prepack": "npm run build",
     "ci:local": "npm run build && npm run typecheck && npm run check:worker && npm test",
+    "deploy:demo": "wrangler deploy --config wrangler.demo.jsonc",
     "check:worker": "esbuild src/worker.ts --bundle --platform=neutral --format=esm --log-level=warning --outfile=node_modules/.cache/worker-check.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
+    "agentic-identity": "^0.4.0",
     "hono": "^4.13.14",
     "zod": "^3.25.0"
   },
@@ -74,7 +76,8 @@
     "miniflare": "^4.20260730.0",
     "tsup": "^8.0.0",
     "typescript": "^5.6.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "wrangler": "^4.155.0"
   },
   "peerDependencies": {
     "vitest": ">=3"

package/dist/chunk-GJFAXI2K.js

@@ -1,104 +0,0 @@
-// src/core/store.ts
-var MAX_LIMIT = 200;
-var DEFAULT_LIMIT = 50;
-function clampLimit(limit) {
-  if (limit === void 0) return DEFAULT_LIMIT;
-  if (!Number.isInteger(limit) || limit < 1) {
-    throw new RangeError("limit must be an integer of 1 or more");
-  }
-  return Math.min(limit, MAX_LIMIT);
-}
-function encodeCursor(value, id) {
-  return btoa(unescape(encodeURIComponent(JSON.stringify([value, id]))));
-}
-function decodeCursor(cursor) {
-  try {
-    const parsed = JSON.parse(decodeURIComponent(escape(atob(cursor))));
-    if (Array.isArray(parsed) && parsed.length === 2 && typeof parsed[1] === "string" && (parsed[0] === null || ["string", "number", "boolean"].includes(typeof parsed[0]))) {
-      return [parsed[0], parsed[1]];
-    }
-  } catch {
-  }
-  throw new RangeError("bad cursor");
-}
-function compare(a, b) {
-  if (a === b) return 0;
-  if (a === null) return -1;
-  if (b === null) return 1;
-  return a < b ? -1 : 1;
-}
-function canonicalJson(value) {
-  return JSON.stringify(
-    value,
-    (_k, v) => v && typeof v === "object" && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) : v
-  );
-}
-function sameDoc(a, b) {
-  return canonicalJson(a) === canonicalJson(b);
-}
-var MemoryStore = class {
-  data = /* @__PURE__ */ new Map();
-  coll(name) {
-    let c = this.data.get(name);
-    if (!c) {
-      c = /* @__PURE__ */ new Map();
-      this.data.set(name, c);
-    }
-    return c;
-  }
-  async get(collection, id) {
-    const doc = this.coll(collection).get(id);
-    return doc ? structuredClone(doc) : null;
-  }
-  async put(collection, id, doc) {
-    this.coll(collection).set(id, structuredClone(doc));
-  }
-  async create(collection, id, doc) {
-    const c = this.coll(collection);
-    if (c.has(id)) return false;
-    c.set(id, structuredClone(doc));
-    return true;
-  }
-  async replaceIf(collection, id, expected, next) {
-    const c = this.coll(collection);
-    const current = c.get(id);
-    if (!current || !sameDoc(current, expected)) return false;
-    c.set(id, structuredClone(next));
-    return true;
-  }
-  async delete(collection, id) {
-    this.coll(collection).delete(id);
-  }
-  async query(collection, query = {}) {
-    const limit = clampLimit(query.limit);
-    const field = query.orderBy?.field;
-    const dir = query.orderBy?.direction === "desc" ? -1 : 1;
-    const where = Object.entries(query.where ?? {});
-    const key = (id, doc) => field ? doc[field] ?? null : id;
-    let rows = [...this.coll(collection)].filter(([, doc]) => where.every(([k, v]) => (doc[k] ?? null) === v)).sort(([ia, a], [ib, b]) => dir * (compare(key(ia, a), key(ib, b)) || compare(ia, ib)));
-    if (query.cursor !== void 0) {
-      const [cv, cid] = decodeCursor(query.cursor);
-      const kind = (v) => v === null ? "null" : typeof v;
-      if (rows.some(([id, doc]) => key(id, doc) !== null && cv !== null && kind(key(id, doc)) !== kind(cv))) {
-        throw new RangeError("bad cursor");
-      }
-      rows = rows.filter(([id, doc]) => dir * (compare(key(id, doc), cv) || compare(id, cid)) > 0);
-    }
-    const slice = rows.slice(0, limit + 1);
-    const hasMore = slice.length > limit;
-    const items = slice.slice(0, limit).map(([id, doc]) => ({ id, doc: structuredClone(doc) }));
-    const last = items[items.length - 1];
-    return {
-      items,
-      nextCursor: hasMore && last ? encodeCursor(key(last.id, last.doc), last.id) : null
-    };
-  }
-};
-
-export {
-  clampLimit,
-  encodeCursor,
-  decodeCursor,
-  canonicalJson,
-  MemoryStore
-};

package/dist/types-Dkst26cb.d.ts

@@ -1,69 +0,0 @@
-import { N as Notification } from './types-GuAgyMOc.js';
-
-/**
- * Store port. Documents are flat JSON objects in named collections.
- * The shape fits document stores and SQL alike: equality filters, one
- * orderBy, a limit, cursor paging. No joins.
- */
-type Scalar = string | number | boolean | null;
-type Doc = Record<string, unknown>;
-interface Query {
-    /** Equality filters on top-level scalar fields. */
-    where?: Record<string, Scalar>;
-    /** One sort field. Ties break by id, in the same direction. */
-    orderBy?: {
-        field: string;
-        direction: "asc" | "desc";
-    };
-    limit?: number;
-    /** Opaque value from a previous page. */
-    cursor?: string;
-}
-interface Page {
-    items: {
-        id: string;
-        doc: Doc;
-    }[];
-    nextCursor: string | null;
-}
-interface Store {
-    get(collection: string, id: string): Promise<Doc | null>;
-    /** Insert or replace. */
-    put(collection: string, id: string, doc: Doc): Promise<void>;
-    /** Insert only. Returns false when the id exists. Atomic. */
-    create(collection: string, id: string, doc: Doc): Promise<boolean>;
-    /** Replace only when the stored doc still equals `expected`. Equality is structural: key order does not matter. Atomic. */
-    replaceIf(collection: string, id: string, expected: Doc, next: Doc): Promise<boolean>;
-    delete(collection: string, id: string): Promise<void>;
-    query(collection: string, query?: Query): Promise<Page>;
-}
-/** In-memory adapter. Also the reference for the contract suite. */
-declare class MemoryStore implements Store {
-    private readonly data;
-    private coll;
-    get(collection: string, id: string): Promise<Doc | null>;
-    put(collection: string, id: string, doc: Doc): Promise<void>;
-    create(collection: string, id: string, doc: Doc): Promise<boolean>;
-    replaceIf(collection: string, id: string, expected: Doc, next: Doc): Promise<boolean>;
-    delete(collection: string, id: string): Promise<void>;
-    query(collection: string, query?: Query): Promise<Page>;
-}
-
-/** A delivery channel other than the inbox. */
-interface DeliveryChannel {
-    /** Resolves "skipped" when the recipient has no target (no endpoint, no address). Throws on failure. */
-    deliver(notification: Notification): Promise<"sent" | "skipped">;
-}
-declare class DeliveryError extends Error {
-    readonly attempts: number;
-    readonly code = "DELIVERY_FAILED";
-    constructor(message: string, attempts: number, options?: {
-        cause?: unknown;
-    });
-}
-/** Logger that takes ids and counts only. Never pass content or addresses. */
-interface Logger {
-    warn(message: string, fields?: Record<string, string | number>): void;
-}
-
-export { type DeliveryChannel as D, type Logger as L, MemoryStore as M, type Page as P, type Query as Q, type Store as S, DeliveryError as a, type Doc as b, type Scalar as c };