@absolutejs/sync-pack-digest 0.1.0

package/README.md

@@ -0,0 +1,138 @@
+# @absolutejs/sync-pack-digest
+
+Scheduled per-actor digest emails as a sync pack for
+[`@absolutejs/sync`](https://github.com/absolutejs/sync). Cron-fires a
+schedule that iterates the host's actor list, asks the host to build a
+digest payload, and dispatches it through a host-provided `send` adapter.
+The pack does NOT ship an SMTP client — you bring your own (Resend, SES,
+Postmark, or a CLI for tests).
+
+```bash
+bun add @absolutejs/sync-pack-digest
+```
+
+## Usage
+
+```ts
+import { createSyncEngine } from '@absolutejs/sync/engine';
+import { createDigestPack } from '@absolutejs/sync-pack-digest';
+
+const engine = createSyncEngine();
+engine.registerPack(
+	createDigestPack({
+		// Cron pattern for the digest fire. Default '0 8 * * 1' (Mon 8am).
+		cron: '0 8 * * 1',
+
+		// REQUIRED: yield the actor ids to iterate per fire. The host's
+		// data layer is the source of truth for "who exists" — the pack
+		// just maintains per-actor cursors.
+		listActors: () => db.users.allActiveIds(),
+
+		// REQUIRED: build the payload for one actor. `since` is the actor's
+		// last successful send (or null on first-ever). Return null to skip
+		// this actor silently (no content this week).
+		buildDigest: async (actorId, since) => {
+			const items = await db.feed.since(actorId, since ?? new Date(0));
+			if (items.length === 0) return null;
+			return {
+				to: await db.users.email(actorId),
+				subject: `Your weekly digest`,
+				body: render(items),
+			};
+		},
+
+		// REQUIRED: host's transport adapter. Pack catches throws per
+		// actor so one bad send doesn't block the rest.
+		send: async (msg) => await resend.send(msg),
+
+		// OPTIONAL: back-pressure. Default 1000.
+		maxActorsPerFire: 1000,
+
+		// OPTIONAL: per-actor cool-down. Default 168 hours = 1 week. Match
+		// to your cron — weekly cron + 168h = each actor gets one digest
+		// per fire; daily cron + 168h = each actor gets at most one per week.
+		minHoursBetweenDigests: 168,
+
+		// OPTIONAL: surface failures (default logs to console.error).
+		onActorFailure: ({ actorId, phase, error }) => {
+			logger.warn({ actorId, phase, error }, 'digest failure');
+		},
+
+		// OPTIONAL: outer schedule retry (sync 1.9.0+). Defaults to no
+		// retry — per-actor failures are handled internally; this is for
+		// transient infra failures (DB, etc) of the whole fire. The next
+		// cron fire catches up anyway.
+		// retry: { maxAttempts: 3, backoff: exponentialBackoff() },
+	})
+);
+```
+
+## The pack exposes
+
+| Surface     | Name              | What it does                                                               |
+| ----------- | ----------------- | -------------------------------------------------------------------------- |
+| Collection  | `digest_cursors`  | Subscribe (no params) — each actor sees their own `lastSentAt` cursor      |
+| Schedule    | `digest:fire`     | Cron handler. Call `engine.runSchedule('digest:fire')` directly for tests  |
+
+## Failure semantics
+
+Three failure phases, each independent per actor:
+
+| Phase         | Cause                          | Effect                                            |
+| ------------- | ------------------------------ | ------------------------------------------------- |
+| `buildDigest` | Host's content builder threw   | `onActorFailure` fires; cursor unchanged; skip    |
+| `send`        | Host's transport adapter threw | `onActorFailure` fires; cursor unchanged; skip    |
+| `cursor`      | Cursor update failed post-send | `onActorFailure` fires (email already went out)   |
+
+A failure on actor N doesn't affect actor N+1; the schedule keeps going.
+
+The `cursor` phase is the one to watch: the email already went out but the
+cursor didn't update, so the actor may double-receive next fire. The pack
+logs through `onActorFailure` so the operator notices.
+
+## Cursor row
+
+```ts
+type DigestCursor = {
+	id: string; // = actorId
+	actorId: string;
+	lastSentAt: number; // epoch ms
+	lastSubject: string;
+};
+```
+
+The collection is scoped per actor by default (each actor sees only their
+own cursor — useful for a "last digest: 5 days ago" UI). Hosts who want
+an admin view can register their own permissions on top — host wins-last.
+
+## Storage
+
+Default: per-instance in-memory cursor store. For a persistent backend,
+pass a custom `store`:
+
+```ts
+import {
+	createDigestPack,
+	type DigestStore,
+} from '@absolutejs/sync-pack-digest';
+
+const store: DigestStore = {
+	getById: (id) => /* SELECT * FROM digest_cursors WHERE id = $1 */,
+	reader: { all: () => /* SELECT * FROM digest_cursors */ },
+	writer: { insert, update, delete },
+};
+```
+
+## Multiple instances
+
+Pass a `prefix` to coexist with other digest pack instances (e.g. one per
+product surface, with different crons / templates):
+
+```ts
+engine.registerPack(createDigestPack({ prefix: 'team_', /* ... */ }));
+engine.registerPack(createDigestPack({ prefix: 'cust_', /* ... */ }));
+
+// Tables:       team_digest_cursors,  cust_digest_cursors
+// Schedules:    team_digest:fire,     cust_digest:fire
+// Collections:  team_digest_cursors,  cust_digest_cursors
+```

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * `@absolutejs/sync-pack-digest` — scheduled per-actor digest pack for
+ * `@absolutejs/sync`.
+ *
+ * Cron-fires a schedule that iterates the host's actor list, asks the host
+ * to build a digest payload for each actor since their last cursor, and
+ * dispatches it through a host-provided `send` adapter. Owns one table
+ * (`digest_cursors`) with one row per actor; nothing else.
+ *
+ * Per-actor failures are caught and logged so one bad send doesn't block
+ * the rest. The whole-handler retry shim from sync 1.9.0 is wired but off
+ * by default (digest fires are usually fine to skip on transient infra
+ * failures — the next cron fire catches up).
+ *
+ * @example
+ * ```ts
+ * import { createSyncEngine } from '@absolutejs/sync/engine';
+ * import { createDigestPack } from '@absolutejs/sync-pack-digest';
+ *
+ * const engine = createSyncEngine();
+ * engine.registerPack(createDigestPack({
+ *   cron: '0 8 * * 1', // Mondays 8am
+ *   listActors: () => db.users.allActiveIds(),
+ *   buildDigest: async (actorId, since) => {
+ *     const items = await db.feed.since(actorId, since ?? new Date(0));
+ *     if (items.length === 0) return null;
+ *     return {
+ *       to: await db.users.email(actorId),
+ *       subject: `Your weekly digest`,
+ *       body: render(items),
+ *     };
+ *   },
+ *   send: async (msg) => await resend.send(msg),
+ * }));
+ * ```
+ */
+import { type CollectionContext, type RetryPolicy, type SyncPack, type TableReader, type TableWriter } from '@absolutejs/sync/engine';
+/** One row per actor — created on first successful send, updated after each. */
+export type DigestCursor = {
+    /** Row id (= actorId). */
+    id: string;
+    actorId: string;
+    /** Epoch ms of the most recent successful send. */
+    lastSentAt: number;
+    /** Subject line of the most recent successful send (for observability). */
+    lastSubject: string;
+};
+/** The payload the host's `buildDigest` returns. Returning `null` skips. */
+export type DigestPayload = {
+    to: string;
+    subject: string;
+    body: string;
+};
+/** Storage adapter the pack uses for the cursors table. */
+export type DigestStore = {
+    reader: TableReader<CollectionContext>;
+    writer: TableWriter<DigestCursor, CollectionContext, unknown>;
+    getById: (id: string) => DigestCursor | undefined;
+};
+/** Default in-memory store. */
+export declare const createInMemoryDigestStore: () => DigestStore;
+/** Factory config. `send`, `buildDigest`, and `listActors` are required. */
+export type DigestPackConfig<Ctx = CollectionContext> = {
+    /**
+     * Prefix applied to the owned table name AND every collection/schedule
+     * the pack exposes. Default `""`.
+     */
+    prefix?: string;
+    /**
+     * Cron pattern for the digest fire (`@elysiajs/cron` / croner syntax).
+     * Default `"0 8 * * 1"` (Mondays 08:00).
+     */
+    cron?: string;
+    /**
+     * Host-supplied email sender. The pack does NOT own transport (no SMTP
+     * client, no Resend/SES/Postmark dep). Throws are caught per-actor.
+     */
+    send: (msg: DigestPayload) => Promise<void>;
+    /**
+     * Build the digest payload for one actor. `since` is the actor's last
+     * successful send timestamp, or `null` if they've never received one.
+     * Return `null` to skip this fire silently (no content for this actor).
+     */
+    buildDigest: (actorId: string, since: Date | null) => Promise<DigestPayload | null>;
+    /**
+     * Yield the actor ids the schedule should iterate per fire. The host's
+     * own data layer is the source of truth for "who exists" — the pack
+     * just maintains per-actor cursors.
+     */
+    listActors: () => Iterable<string> | Promise<Iterable<string>>;
+    /**
+     * Cap on actors processed per fire (back-pressure). The rest wait for
+     * the next cron fire. Default `1000`.
+     */
+    maxActorsPerFire?: number;
+    /**
+     * Minimum hours between digests for a given actor. An actor whose
+     * cursor is fresher than this is skipped on the fire. Default `168`
+     * (one week — matches the weekly default cron).
+     */
+    minHoursBetweenDigests?: number;
+    /**
+     * Extract the current actor id from ctx — used to scope the cursor
+     * collection so each actor sees their own row. Default
+     * `(ctx) => ctx.userId`.
+     */
+    getActorId?: (ctx: Ctx) => string | undefined;
+    /**
+     * Outer schedule retry policy. The pack catches per-actor failures
+     * already, so this only retries the whole handler on classified
+     * transient infrastructure failures (e.g. DB serialization). Default
+     * undefined — digest fires miss skip on infra failure and catch up
+     * next cron.
+     */
+    retry?: RetryPolicy;
+    /** Override the storage adapter. Default: per-instance in-memory. */
+    store?: DigestStore;
+    /** Wall-clock function. Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Hook for surfacing per-actor failures. Defaults to `console.error`.
+     * The pack swallows the error after this call so the schedule keeps
+     * going for the rest of the actor list.
+     */
+    onActorFailure?: (info: {
+        actorId: string;
+        phase: 'buildDigest' | 'send' | 'cursor';
+        error: unknown;
+    }) => void;
+};
+/**
+ * Build a {@link SyncPack} that exposes scheduled per-actor digests. Each
+ * call returns a fresh pack with its own cursor store (unless overridden).
+ */
+export declare const createDigestPack: <Ctx = CollectionContext>(config: DigestPackConfig<Ctx>) => SyncPack;

package/dist/index.js

@@ -0,0 +1,189 @@
+// @bun
+// src/index.ts
+import {
+  defineCollection,
+  defineSchedule,
+  defineSchema,
+  defineSyncPack,
+  field
+} from "@absolutejs/sync/engine";
+var createInMemoryDigestStore = () => {
+  const rows = new Map;
+  return {
+    getById: (id) => rows.get(id),
+    reader: {
+      all: () => [...rows.values()]
+    },
+    writer: {
+      delete: (row) => {
+        rows.delete(row.id);
+      },
+      insert: (data) => {
+        rows.set(data.id, data);
+        return data;
+      },
+      update: (data) => {
+        const prior = rows.get(data.id);
+        const merged = { ...prior ?? {}, ...data };
+        rows.set(data.id, merged);
+        return merged;
+      }
+    }
+  };
+};
+var DEFAULT_CRON = "0 8 * * 1";
+var DEFAULT_MAX_ACTORS_PER_FIRE = 1000;
+var DEFAULT_MIN_HOURS_BETWEEN_DIGESTS = 168;
+var resolveActor = (getActorId, ctx) => getActorId(ctx);
+var createDigestPack = (config) => {
+  const prefix = config.prefix ?? "";
+  const table = `${prefix}digest_cursors`;
+  const collectionName = table;
+  const scheduleName = `${prefix}digest:fire`;
+  const cron = config.cron ?? DEFAULT_CRON;
+  const maxActorsPerFire = config.maxActorsPerFire ?? DEFAULT_MAX_ACTORS_PER_FIRE;
+  const minIntervalMs = (config.minHoursBetweenDigests ?? DEFAULT_MIN_HOURS_BETWEEN_DIGESTS) * 60 * 60 * 1000;
+  const store = config.store ?? createInMemoryDigestStore();
+  const now = config.now ?? Date.now;
+  const getActorId = config.getActorId ?? ((ctx) => ctx.userId);
+  const onActorFailure = config.onActorFailure ?? ((info) => {
+    console.error(`[sync-pack-digest] actor "${info.actorId}" failed at ${info.phase}:`, info.error);
+  });
+  const pack = {
+    name: "@absolutejs/sync-pack-digest",
+    ownsTables: [table],
+    readsTables: [],
+    version: "0.1.0",
+    schemas: defineSchema({
+      [table]: {
+        fields: {
+          id: field.string,
+          actorId: field.string,
+          lastSentAt: field.number,
+          lastSubject: field.string
+        }
+      }
+    }),
+    readers: { [table]: store.reader },
+    writers: { [table]: store.writer },
+    permissions: {
+      [table]: {
+        read: (ctx, row) => {
+          const callerId = resolveActor(getActorId, ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        insert: (ctx, row) => {
+          const callerId = resolveActor(getActorId, ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        update: (ctx, row) => {
+          const callerId = resolveActor(getActorId, ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        delete: (ctx, row) => {
+          const callerId = resolveActor(getActorId, ctx);
+          if (callerId === undefined)
+            return false;
+          if (row.actorId !== undefined) {
+            return row.actorId === callerId;
+          }
+          const id = row.id;
+          if (id === undefined)
+            return false;
+          return store.getById(id)?.actorId === callerId;
+        }
+      }
+    },
+    collections: [
+      defineCollection({
+        name: collectionName,
+        tables: [table],
+        key: (row) => row.id,
+        hydrate: (_params, ctx) => {
+          const callerId = resolveActor(getActorId, ctx);
+          if (callerId === undefined)
+            return [];
+          return store.reader.all(ctx).filter((row) => row.actorId === callerId);
+        },
+        match: (row, _params, ctx) => {
+          const callerId = resolveActor(getActorId, ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        authorize: (_params, ctx) => resolveActor(getActorId, ctx) !== undefined
+      })
+    ],
+    schedules: [
+      defineSchedule({
+        name: scheduleName,
+        pattern: cron,
+        ...config.retry !== undefined ? { retry: config.retry } : {},
+        run: async ({ actions }) => {
+          const t = now();
+          const actors = await config.listActors();
+          let processed = 0;
+          for (const actorId of actors) {
+            if (processed >= maxActorsPerFire)
+              break;
+            const cursor = store.getById(actorId);
+            if (cursor !== undefined && t - cursor.lastSentAt < minIntervalMs) {
+              continue;
+            }
+            let payload;
+            try {
+              const since = cursor === undefined ? null : new Date(cursor.lastSentAt);
+              payload = await config.buildDigest(actorId, since);
+            } catch (error) {
+              onActorFailure({
+                actorId,
+                error,
+                phase: "buildDigest"
+              });
+              continue;
+            }
+            if (payload === null) {
+              continue;
+            }
+            try {
+              await config.send(payload);
+            } catch (error) {
+              onActorFailure({
+                actorId,
+                error,
+                phase: "send"
+              });
+              continue;
+            }
+            processed++;
+            try {
+              const next = {
+                id: actorId,
+                actorId,
+                lastSentAt: t,
+                lastSubject: payload.subject
+              };
+              if (cursor === undefined) {
+                await actions.insert(table, next);
+              } else {
+                await actions.update(table, next);
+              }
+            } catch (error) {
+              onActorFailure({
+                actorId,
+                error,
+                phase: "cursor"
+              });
+            }
+          }
+        }
+      })
+    ]
+  };
+  return defineSyncPack(pack);
+};
+export {
+  createInMemoryDigestStore,
+  createDigestPack
+};
+
+//# debugId=AE598FAB1C126FB164756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * `@absolutejs/sync-pack-digest` — scheduled per-actor digest pack for\n * `@absolutejs/sync`.\n *\n * Cron-fires a schedule that iterates the host's actor list, asks the host\n * to build a digest payload for each actor since their last cursor, and\n * dispatches it through a host-provided `send` adapter. Owns one table\n * (`digest_cursors`) with one row per actor; nothing else.\n *\n * Per-actor failures are caught and logged so one bad send doesn't block\n * the rest. The whole-handler retry shim from sync 1.9.0 is wired but off\n * by default (digest fires are usually fine to skip on transient infra\n * failures — the next cron fire catches up).\n *\n * @example\n * ```ts\n * import { createSyncEngine } from '@absolutejs/sync/engine';\n * import { createDigestPack } from '@absolutejs/sync-pack-digest';\n *\n * const engine = createSyncEngine();\n * engine.registerPack(createDigestPack({\n *   cron: '0 8 * * 1', // Mondays 8am\n *   listActors: () => db.users.allActiveIds(),\n *   buildDigest: async (actorId, since) => {\n *     const items = await db.feed.since(actorId, since ?? new Date(0));\n *     if (items.length === 0) return null;\n *     return {\n *       to: await db.users.email(actorId),\n *       subject: `Your weekly digest`,\n *       body: render(items),\n *     };\n *   },\n *   send: async (msg) => await resend.send(msg),\n * }));\n * ```\n */\n\nimport {\n\tdefineCollection,\n\tdefineSchedule,\n\tdefineSchema,\n\tdefineSyncPack,\n\tfield,\n\ttype CollectionContext,\n\ttype RetryPolicy,\n\ttype SyncPack,\n\ttype TableReader,\n\ttype TableWriter\n} from '@absolutejs/sync/engine';\n\n/** One row per actor — created on first successful send, updated after each. */\nexport type DigestCursor = {\n\t/** Row id (= actorId). */\n\tid: string;\n\tactorId: string;\n\t/** Epoch ms of the most recent successful send. */\n\tlastSentAt: number;\n\t/** Subject line of the most recent successful send (for observability). */\n\tlastSubject: string;\n};\n\n/** The payload the host's `buildDigest` returns. Returning `null` skips. */\nexport type DigestPayload = {\n\tto: string;\n\tsubject: string;\n\tbody: string;\n};\n\n/** Storage adapter the pack uses for the cursors table. */\nexport type DigestStore = {\n\treader: TableReader<CollectionContext>;\n\twriter: TableWriter<DigestCursor, CollectionContext, unknown>;\n\tgetById: (id: string) => DigestCursor | undefined;\n};\n\n/** Default in-memory store. */\nexport const createInMemoryDigestStore = (): DigestStore => {\n\tconst rows = new Map<string, DigestCursor>();\n\treturn {\n\t\tgetById: (id) => rows.get(id),\n\t\treader: {\n\t\t\tall: () => [...rows.values()]\n\t\t},\n\t\twriter: {\n\t\t\tdelete: (row) => {\n\t\t\t\trows.delete((row as { id: string }).id);\n\t\t\t},\n\t\t\tinsert: (data) => {\n\t\t\t\trows.set(data.id, data);\n\t\t\t\treturn data;\n\t\t\t},\n\t\t\tupdate: (data) => {\n\t\t\t\tconst prior = rows.get(data.id);\n\t\t\t\tconst merged = { ...(prior ?? {}), ...data } as DigestCursor;\n\t\t\t\trows.set(data.id, merged);\n\t\t\t\treturn merged;\n\t\t\t}\n\t\t}\n\t};\n};\n\nconst DEFAULT_CRON = '0 8 * * 1';\nconst DEFAULT_MAX_ACTORS_PER_FIRE = 1000;\nconst DEFAULT_MIN_HOURS_BETWEEN_DIGESTS = 168;\n\n/** Factory config. `send`, `buildDigest`, and `listActors` are required. */\nexport type DigestPackConfig<Ctx = CollectionContext> = {\n\t/**\n\t * Prefix applied to the owned table name AND every collection/schedule\n\t * the pack exposes. Default `\"\"`.\n\t */\n\tprefix?: string;\n\t/**\n\t * Cron pattern for the digest fire (`@elysiajs/cron` / croner syntax).\n\t * Default `\"0 8 * * 1\"` (Mondays 08:00).\n\t */\n\tcron?: string;\n\t/**\n\t * Host-supplied email sender. The pack does NOT own transport (no SMTP\n\t * client, no Resend/SES/Postmark dep). Throws are caught per-actor.\n\t */\n\tsend: (msg: DigestPayload) => Promise<void>;\n\t/**\n\t * Build the digest payload for one actor. `since` is the actor's last\n\t * successful send timestamp, or `null` if they've never received one.\n\t * Return `null` to skip this fire silently (no content for this actor).\n\t */\n\tbuildDigest: (\n\t\tactorId: string,\n\t\tsince: Date | null\n\t) => Promise<DigestPayload | null>;\n\t/**\n\t * Yield the actor ids the schedule should iterate per fire. The host's\n\t * own data layer is the source of truth for \"who exists\" — the pack\n\t * just maintains per-actor cursors.\n\t */\n\tlistActors: () =>\n\t\t| Iterable<string>\n\t\t| Promise<Iterable<string>>;\n\t/**\n\t * Cap on actors processed per fire (back-pressure). The rest wait for\n\t * the next cron fire. Default `1000`.\n\t */\n\tmaxActorsPerFire?: number;\n\t/**\n\t * Minimum hours between digests for a given actor. An actor whose\n\t * cursor is fresher than this is skipped on the fire. Default `168`\n\t * (one week — matches the weekly default cron).\n\t */\n\tminHoursBetweenDigests?: number;\n\t/**\n\t * Extract the current actor id from ctx — used to scope the cursor\n\t * collection so each actor sees their own row. Default\n\t * `(ctx) => ctx.userId`.\n\t */\n\tgetActorId?: (ctx: Ctx) => string | undefined;\n\t/**\n\t * Outer schedule retry policy. The pack catches per-actor failures\n\t * already, so this only retries the whole handler on classified\n\t * transient infrastructure failures (e.g. DB serialization). Default\n\t * undefined — digest fires miss skip on infra failure and catch up\n\t * next cron.\n\t */\n\tretry?: RetryPolicy;\n\t/** Override the storage adapter. Default: per-instance in-memory. */\n\tstore?: DigestStore;\n\t/** Wall-clock function. Default `Date.now`. */\n\tnow?: () => number;\n\t/**\n\t * Hook for surfacing per-actor failures. Defaults to `console.error`.\n\t * The pack swallows the error after this call so the schedule keeps\n\t * going for the rest of the actor list.\n\t */\n\tonActorFailure?: (info: {\n\t\tactorId: string;\n\t\tphase: 'buildDigest' | 'send' | 'cursor';\n\t\terror: unknown;\n\t}) => void;\n};\n\nconst resolveActor = (\n\tgetActorId: NonNullable<DigestPackConfig['getActorId']>,\n\tctx: unknown\n): string | undefined => getActorId(ctx as CollectionContext);\n\n/**\n * Build a {@link SyncPack} that exposes scheduled per-actor digests. Each\n * call returns a fresh pack with its own cursor store (unless overridden).\n */\nexport const createDigestPack = <Ctx = CollectionContext>(\n\tconfig: DigestPackConfig<Ctx>\n): SyncPack => {\n\tconst prefix = config.prefix ?? '';\n\tconst table = `${prefix}digest_cursors`;\n\tconst collectionName = table;\n\tconst scheduleName = `${prefix}digest:fire`;\n\tconst cron = config.cron ?? DEFAULT_CRON;\n\tconst maxActorsPerFire =\n\t\tconfig.maxActorsPerFire ?? DEFAULT_MAX_ACTORS_PER_FIRE;\n\tconst minIntervalMs =\n\t\t(config.minHoursBetweenDigests ??\n\t\t\tDEFAULT_MIN_HOURS_BETWEEN_DIGESTS) *\n\t\t60 *\n\t\t60 *\n\t\t1000;\n\tconst store = config.store ?? createInMemoryDigestStore();\n\tconst now = config.now ?? Date.now;\n\tconst getActorId = (config.getActorId ??\n\t\t((ctx: CollectionContext) =>\n\t\t\t(ctx as { userId?: string }).userId)) as (\n\t\tctx: CollectionContext\n\t) => string | undefined;\n\tconst onActorFailure =\n\t\tconfig.onActorFailure ??\n\t\t((info) => {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.error(\n\t\t\t\t`[sync-pack-digest] actor \"${info.actorId}\" failed at ${info.phase}:`,\n\t\t\t\tinfo.error\n\t\t\t);\n\t\t});\n\n\tconst pack: SyncPack = {\n\t\tname: '@absolutejs/sync-pack-digest',\n\t\townsTables: [table],\n\t\treadsTables: [],\n\t\tversion: '0.1.0',\n\n\t\tschemas: defineSchema({\n\t\t\t[table]: {\n\t\t\t\tfields: {\n\t\t\t\t\tid: field.string,\n\t\t\t\t\tactorId: field.string,\n\t\t\t\t\tlastSentAt: field.number,\n\t\t\t\t\tlastSubject: field.string\n\t\t\t\t}\n\t\t\t}\n\t\t}),\n\n\t\treaders: { [table]: store.reader },\n\t\twriters: { [table]: store.writer },\n\n\t\tpermissions: {\n\t\t\t[table]: {\n\t\t\t\t// Each actor sees only their own cursor — the cursor row\n\t\t\t\t// surfaces \"your last digest was at X\" to the user without\n\t\t\t\t// leaking other actors' state. Hosts who want a global\n\t\t\t\t// admin view register their own permissions on top.\n\t\t\t\tread: (ctx: unknown, row: DigestCursor) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\t// Writes flow only through the pack's schedule; deny\n\t\t\t\t// outside writers by stamping actorId === caller, which\n\t\t\t\t// fails for any non-actor (the schedule runs trusted and\n\t\t\t\t// bypasses these checks).\n\t\t\t\tinsert: (ctx: unknown, row: DigestCursor) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\tupdate: (ctx: unknown, row: DigestCursor) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\tdelete: (ctx: unknown, row: DigestCursor) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\tif (callerId === undefined) return false;\n\t\t\t\t\tif ((row as { actorId?: string }).actorId !== undefined) {\n\t\t\t\t\t\treturn (row as { actorId: string }).actorId === callerId;\n\t\t\t\t\t}\n\t\t\t\t\tconst id = (row as { id?: string }).id;\n\t\t\t\t\tif (id === undefined) return false;\n\t\t\t\t\treturn store.getById(id)?.actorId === callerId;\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tcollections: [\n\t\t\tdefineCollection<DigestCursor, void, CollectionContext>({\n\t\t\t\tname: collectionName,\n\t\t\t\ttables: [table],\n\t\t\t\tkey: (row) => row.id,\n\t\t\t\thydrate: (_params, ctx) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\tif (callerId === undefined) return [];\n\t\t\t\t\treturn (store.reader.all(ctx) as DigestCursor[]).filter(\n\t\t\t\t\t\t(row) => row.actorId === callerId\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tmatch: (row, _params, ctx) => {\n\t\t\t\t\tconst callerId = resolveActor(getActorId, ctx);\n\t\t\t\t\treturn (\n\t\t\t\t\t\tcallerId !== undefined && row.actorId === callerId\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tauthorize: (_params, ctx) =>\n\t\t\t\t\tresolveActor(getActorId, ctx) !== undefined\n\t\t\t})\n\t\t],\n\n\t\tschedules: [\n\t\t\tdefineSchedule({\n\t\t\t\tname: scheduleName,\n\t\t\t\tpattern: cron,\n\t\t\t\t...(config.retry !== undefined ? { retry: config.retry } : {}),\n\t\t\t\trun: async ({ actions }) => {\n\t\t\t\t\tconst t = now();\n\t\t\t\t\tconst actors = await config.listActors();\n\t\t\t\t\tlet processed = 0;\n\t\t\t\t\tfor (const actorId of actors) {\n\t\t\t\t\t\tif (processed >= maxActorsPerFire) break;\n\t\t\t\t\t\tconst cursor = store.getById(actorId);\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tcursor !== undefined &&\n\t\t\t\t\t\t\tt - cursor.lastSentAt < minIntervalMs\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t// Not yet due for this actor.\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlet payload: DigestPayload | null;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst since =\n\t\t\t\t\t\t\t\tcursor === undefined\n\t\t\t\t\t\t\t\t\t? null\n\t\t\t\t\t\t\t\t\t: new Date(cursor.lastSentAt);\n\t\t\t\t\t\t\tpayload = await config.buildDigest(actorId, since);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tonActorFailure({\n\t\t\t\t\t\t\t\tactorId,\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t\tphase: 'buildDigest'\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (payload === null) {\n\t\t\t\t\t\t\t// Host signalled no content for this actor — skip\n\t\t\t\t\t\t\t// without bumping the cursor.\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tawait config.send(payload);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tonActorFailure({\n\t\t\t\t\t\t\t\tactorId,\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t\tphase: 'send'\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tprocessed++;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst next: DigestCursor = {\n\t\t\t\t\t\t\t\tid: actorId,\n\t\t\t\t\t\t\t\tactorId,\n\t\t\t\t\t\t\t\tlastSentAt: t,\n\t\t\t\t\t\t\t\tlastSubject: payload.subject\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tif (cursor === undefined) {\n\t\t\t\t\t\t\t\tawait actions.insert(table, next);\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tawait actions.update(table, next);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t// The email already went out — losing the cursor\n\t\t\t\t\t\t\t// update means the actor may double-receive on\n\t\t\t\t\t\t\t// the next fire. We log so the operator sees it.\n\t\t\t\t\t\t\tonActorFailure({\n\t\t\t\t\t\t\t\tactorId,\n\t\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\t\tphase: 'cursor'\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t})\n\t\t]\n\t};\n\n\treturn defineSyncPack(pack);\n};\n"
+  ],
+  "mappings": ";;AAqCA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuCO,IAAM,4BAA4B,MAAmB;AAAA,EAC3D,MAAM,OAAO,IAAI;AAAA,EACjB,OAAO;AAAA,IACN,SAAS,CAAC,OAAO,KAAK,IAAI,EAAE;AAAA,IAC5B,QAAQ;AAAA,MACP,KAAK,MAAM,CAAC,GAAG,KAAK,OAAO,CAAC;AAAA,IAC7B;AAAA,IACA,QAAQ;AAAA,MACP,QAAQ,CAAC,QAAQ;AAAA,QAChB,KAAK,OAAQ,IAAuB,EAAE;AAAA;AAAA,MAEvC,QAAQ,CAAC,SAAS;AAAA,QACjB,KAAK,IAAI,KAAK,IAAI,IAAI;AAAA,QACtB,OAAO;AAAA;AAAA,MAER,QAAQ,CAAC,SAAS;AAAA,QACjB,MAAM,QAAQ,KAAK,IAAI,KAAK,EAAE;AAAA,QAC9B,MAAM,SAAS,KAAM,SAAS,CAAC,MAAO,KAAK;AAAA,QAC3C,KAAK,IAAI,KAAK,IAAI,MAAM;AAAA,QACxB,OAAO;AAAA;AAAA,IAET;AAAA,EACD;AAAA;AAGD,IAAM,eAAe;AACrB,IAAM,8BAA8B;AACpC,IAAM,oCAAoC;AA6E1C,IAAM,eAAe,CACpB,YACA,QACwB,WAAW,GAAwB;AAMrD,IAAM,mBAAmB,CAC/B,WACc;AAAA,EACd,MAAM,SAAS,OAAO,UAAU;AAAA,EAChC,MAAM,QAAQ,GAAG;AAAA,EACjB,MAAM,iBAAiB;AAAA,EACvB,MAAM,eAAe,GAAG;AAAA,EACxB,MAAM,OAAO,OAAO,QAAQ;AAAA,EAC5B,MAAM,mBACL,OAAO,oBAAoB;AAAA,EAC5B,MAAM,iBACJ,OAAO,0BACP,qCACD,KACA,KACA;AAAA,EACD,MAAM,QAAQ,OAAO,SAAS,0BAA0B;AAAA,EACxD,MAAM,MAAM,OAAO,OAAO,KAAK;AAAA,EAC/B,MAAM,aAAc,OAAO,eACzB,CAAC,QACA,IAA4B;AAAA,EAG/B,MAAM,iBACL,OAAO,mBACN,CAAC,SAAS;AAAA,IAEV,QAAQ,MACP,6BAA6B,KAAK,sBAAsB,KAAK,UAC7D,KAAK,KACN;AAAA;AAAA,EAGF,MAAM,OAAiB;AAAA,IACtB,MAAM;AAAA,IACN,YAAY,CAAC,KAAK;AAAA,IAClB,aAAa,CAAC;AAAA,IACd,SAAS;AAAA,IAET,SAAS,aAAa;AAAA,OACpB,QAAQ;AAAA,QACR,QAAQ;AAAA,UACP,IAAI,MAAM;AAAA,UACV,SAAS,MAAM;AAAA,UACf,YAAY,MAAM;AAAA,UAClB,aAAa,MAAM;AAAA,QACpB;AAAA,MACD;AAAA,IACD,CAAC;AAAA,IAED,SAAS,GAAG,QAAQ,MAAM,OAAO;AAAA,IACjC,SAAS,GAAG,QAAQ,MAAM,OAAO;AAAA,IAEjC,aAAa;AAAA,OACX,QAAQ;AAAA,QAKR,MAAM,CAAC,KAAc,QAAsB;AAAA,UAC1C,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,OAAO,aAAa,aAAa,IAAI,YAAY;AAAA;AAAA,QAMlD,QAAQ,CAAC,KAAc,QAAsB;AAAA,UAC5C,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,OAAO,aAAa,aAAa,IAAI,YAAY;AAAA;AAAA,QAElD,QAAQ,CAAC,KAAc,QAAsB;AAAA,UAC5C,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,OAAO,aAAa,aAAa,IAAI,YAAY;AAAA;AAAA,QAElD,QAAQ,CAAC,KAAc,QAAsB;AAAA,UAC5C,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,IAAI,aAAa;AAAA,YAAW,OAAO;AAAA,UACnC,IAAK,IAA6B,YAAY,WAAW;AAAA,YACxD,OAAQ,IAA4B,YAAY;AAAA,UACjD;AAAA,UACA,MAAM,KAAM,IAAwB;AAAA,UACpC,IAAI,OAAO;AAAA,YAAW,OAAO;AAAA,UAC7B,OAAO,MAAM,QAAQ,EAAE,GAAG,YAAY;AAAA;AAAA,MAExC;AAAA,IACD;AAAA,IAEA,aAAa;AAAA,MACZ,iBAAwD;AAAA,QACvD,MAAM;AAAA,QACN,QAAQ,CAAC,KAAK;AAAA,QACd,KAAK,CAAC,QAAQ,IAAI;AAAA,QAClB,SAAS,CAAC,SAAS,QAAQ;AAAA,UAC1B,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,IAAI,aAAa;AAAA,YAAW,OAAO,CAAC;AAAA,UACpC,OAAQ,MAAM,OAAO,IAAI,GAAG,EAAqB,OAChD,CAAC,QAAQ,IAAI,YAAY,QAC1B;AAAA;AAAA,QAED,OAAO,CAAC,KAAK,SAAS,QAAQ;AAAA,UAC7B,MAAM,WAAW,aAAa,YAAY,GAAG;AAAA,UAC7C,OACC,aAAa,aAAa,IAAI,YAAY;AAAA;AAAA,QAG5C,WAAW,CAAC,SAAS,QACpB,aAAa,YAAY,GAAG,MAAM;AAAA,MACpC,CAAC;AAAA,IACF;AAAA,IAEA,WAAW;AAAA,MACV,eAAe;AAAA,QACd,MAAM;AAAA,QACN,SAAS;AAAA,WACL,OAAO,UAAU,YAAY,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,QAC5D,KAAK,SAAS,cAAc;AAAA,UAC3B,MAAM,IAAI,IAAI;AAAA,UACd,MAAM,SAAS,MAAM,OAAO,WAAW;AAAA,UACvC,IAAI,YAAY;AAAA,UAChB,WAAW,WAAW,QAAQ;AAAA,YAC7B,IAAI,aAAa;AAAA,cAAkB;AAAA,YACnC,MAAM,SAAS,MAAM,QAAQ,OAAO;AAAA,YACpC,IACC,WAAW,aACX,IAAI,OAAO,aAAa,eACvB;AAAA,cAED;AAAA,YACD;AAAA,YACA,IAAI;AAAA,YACJ,IAAI;AAAA,cACH,MAAM,QACL,WAAW,YACR,OACA,IAAI,KAAK,OAAO,UAAU;AAAA,cAC9B,UAAU,MAAM,OAAO,YAAY,SAAS,KAAK;AAAA,cAChD,OAAO,OAAO;AAAA,cACf,eAAe;AAAA,gBACd;AAAA,gBACA;AAAA,gBACA,OAAO;AAAA,cACR,CAAC;AAAA,cACD;AAAA;AAAA,YAED,IAAI,YAAY,MAAM;AAAA,cAGrB;AAAA,YACD;AAAA,YACA,IAAI;AAAA,cACH,MAAM,OAAO,KAAK,OAAO;AAAA,cACxB,OAAO,OAAO;AAAA,cACf,eAAe;AAAA,gBACd;AAAA,gBACA;AAAA,gBACA,OAAO;AAAA,cACR,CAAC;AAAA,cACD;AAAA;AAAA,YAED;AAAA,YACA,IAAI;AAAA,cACH,MAAM,OAAqB;AAAA,gBAC1B,IAAI;AAAA,gBACJ;AAAA,gBACA,YAAY;AAAA,gBACZ,aAAa,QAAQ;AAAA,cACtB;AAAA,cACA,IAAI,WAAW,WAAW;AAAA,gBACzB,MAAM,QAAQ,OAAO,OAAO,IAAI;AAAA,cACjC,EAAO;AAAA,gBACN,MAAM,QAAQ,OAAO,OAAO,IAAI;AAAA;AAAA,cAEhC,OAAO,OAAO;AAAA,cAIf,eAAe;AAAA,gBACd;AAAA,gBACA;AAAA,gBACA,OAAO;AAAA,cACR,CAAC;AAAA;AAAA,UAEH;AAAA;AAAA,MAEF,CAAC;AAAA,IACF;AAAA,EACD;AAAA,EAEA,OAAO,eAAe,IAAI;AAAA;",
+  "debugId": "AE598FAB1C126FB164756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@absolutejs/sync-pack-digest",
+	"version": "0.1.0",
+	"description": "Scheduled per-actor digest pack for @absolutejs/sync — cron-fired, cursor-managed, transport-agnostic",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/sync-packs.git",
+		"directory": "digest"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"absolutejs",
+		"sync",
+		"sync-pack",
+		"digest",
+		"scheduled",
+		"email"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run typecheck && bun run test && bun run build && bun publish"
+	},
+	"peerDependencies": {
+		"@absolutejs/sync": ">= 1.9.1"
+	},
+	"devDependencies": {
+		"@absolutejs/sync": "^1.9.1",
+		"@types/bun": "1.3.14",
+		"prettier": "3.5.3",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": ["dist", "README.md"]
+}