@ttt-productions/notification-core 0.15.17 → 0.15.18

package/dist/server/observed-generation.js

@@ -1,22 +1,3 @@
-/**
- * Observed-generation seen/archive protocol (notification redesign — P1).
- *
- * The SEEN/ARCHIVE precondition compares the card's current opaque
- * `activityGeneration` against the generation the client actually observed when
- * it rendered the row — so activity arriving after render (or a delete+recreate
- * that rotated the token) is never silently swallowed. Archive additionally
- * carries a retry-stable `requestId`; the deterministic history doc id makes a
- * replay return the stored result and touch nothing.
- *
- * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)
- * via its own canonical hash (in the consuming app's core package) and passes the
- * refs in; this module owns only the transactional state machine, not the id formulas.
- */
-/**
- * Set `seenAt`/`seenAtGeneration` ONLY if the card's current `activityGeneration`
- * still matches the observed one; otherwise no-op (the row stays unseen so newer
- * activity is never swallowed).
- */
 export async function markNotificationSeenWithGeneration(db, activeRef, params) {
     return db.runTransaction(async (tx) => {
         const snap = await tx.get(activeRef);
@@ -33,18 +14,10 @@ export async function markNotificationSeenWithGeneration(db, activeRef, params)
         return 'seen';
     });
 }
-/**
- * Archive one active card into history, idempotently and replay-safely.
- *
- * - history doc already exists + same `payloadHash` ⇒ `replayed` (touch NOTHING).
- * - history doc already exists + DIFFERENT `payloadHash` ⇒ `conflict` (caller alerts).
- * - first-seen: archive only if the active card's `activityGeneration` still
- *   matches the observed generation; else `generation-mismatch` (leave it active).
- */
 export async function archiveNotificationWithGeneration(db, params) {
     const { activeRef, historyRef, requestId, observedActivityGeneration, payloadHash, category, audienceScope, expireAtMs, timestampFromMillis, handledBy, auditWrite, } = params;
     return db.runTransaction(async (tx) => {
-        // Reads first (Firestore reads-before-writes).
+        // Firestore transactions take every read before any write.
         const historySnap = await tx.get(historyRef);
         if (historySnap.exists) {
             const existing = (historySnap.data() ?? {});
@@ -74,9 +47,6 @@ export async function archiveNotificationWithGeneration(db, params) {
             historyDoc.handledBy = handledBy;
         tx.set(historyRef, historyDoc);
         tx.delete(activeRef);
-        // Compose any caller-supplied write (e.g. an audit event) into THIS
-        // transaction so it commits atomically with the archive. Only reached on the
-        // successful path, after all reads, so reads-before-writes is preserved.
         await auditWrite?.(tx);
         return 'archived';
     });

package/dist/server/observed-generation.js.map

@@ -1 +1 @@
-{"version":3,"file":"observed-generation.js","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAmB,EACnB,SAAuB,EACvB,MAA4D;IAE5D,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QAC5D,IAAK,IAAI,CAAC,kBAAyC,KAAK,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1F,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAChC,gBAAgB,EAAE,MAAM,CAAC,0BAA0B;SACpD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,EAAmB,EACnB,MA0BC;IAED,MAAM,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,+CAA+C;QAC/C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;YACvE,OAAQ,QAAQ,CAAC,WAAkC,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QACxE,IAAK,UAAU,CAAC,kBAAyC,KAAK,0BAA0B,EAAE,CAAC;YACzF,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAA4B;YAC1C,mBAAmB,EAAE,UAAU,CAAC,EAAE;YAClC,SAAS;YACT,WAAW;YACX,QAAQ,EAAE,SAAS,CAAC,EAAE;YACtB,0BAA0B;YAC1B,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE,UAAU;YAC5B,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;SAC1C,CAAC;QACF,IAAI,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QAE9D,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrB,oEAAoE;QACpE,6EAA6E;QAC7E,yEAAyE;QACzE,MAAM,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Observed-generation seen/archive protocol (notification redesign — P1).\n *\n * The SEEN/ARCHIVE precondition compares the card's current opaque\n * `activityGeneration` against the generation the client actually observed when\n * it rendered the row — so activity arriving after render (or a delete+recreate\n * that rotated the token) is never silently swallowed. Archive additionally\n * carries a retry-stable `requestId`; the deterministic history doc id makes a\n * replay return the stored result and touch nothing.\n *\n * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)\n * via its own canonical hash (in the consuming app's core package) and passes the\n * refs in; this module owns only the transactional state machine, not the id formulas.\n */\n\nimport type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\n\nexport type MarkSeenOutcome = 'seen' | 'generation-mismatch' | 'missing';\n\n/**\n * Set `seenAt`/`seenAtGeneration` ONLY if the card's current `activityGeneration`\n * still matches the observed one; otherwise no-op (the row stays unseen so newer\n * activity is never swallowed).\n */\nexport async function markNotificationSeenWithGeneration(\n  db: ServerFirestore,\n  activeRef: ServerDocRef,\n  params: { observedActivityGeneration: string; now?: number },\n): Promise<MarkSeenOutcome> {\n  return db.runTransaction(async (tx) => {\n    const snap = await tx.get(activeRef);\n    if (!snap.exists) return 'missing';\n    const data = (snap.data() ?? {}) as Record<string, unknown>;\n    if ((data.activityGeneration as string | undefined) !== params.observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n    tx.update(activeRef, {\n      seenAt: params.now ?? Date.now(),\n      seenAtGeneration: params.observedActivityGeneration,\n    });\n    return 'seen';\n  });\n}\n\nexport type ArchiveOutcome =\n  'archived' | 'replayed' | 'conflict' | 'generation-mismatch' | 'missing';\n\n/**\n * Archive one active card into history, idempotently and replay-safely.\n *\n * - history doc already exists + same `payloadHash` ⇒ `replayed` (touch NOTHING).\n * - history doc already exists + DIFFERENT `payloadHash` ⇒ `conflict` (caller alerts).\n * - first-seen: archive only if the active card's `activityGeneration` still\n *   matches the observed generation; else `generation-mismatch` (leave it active).\n */\nexport async function archiveNotificationWithGeneration(\n  db: ServerFirestore,\n  params: {\n    activeRef: ServerDocRef;\n    /** Deterministic history doc id = hash('notification-archive', category, audienceScope, requestId) (app-built). */\n    historyRef: ServerDocRef;\n    requestId: string;\n    observedActivityGeneration: string;\n    /** Deterministic payload hash (app-built) — the replay-vs-conflict discriminator. */\n    payloadHash: string;\n    category: string;\n    audienceScope: string;\n    /** Native-TTL expiry for the history doc; converted to a Timestamp via the factory. */\n    expireAtMs: number;\n    timestampFromMillis: (ms: number) => unknown;\n    /** Admin history quick-access field (admin category only). */\n    handledBy?: string;\n    /**\n     * Optional hook to compose additional writes (e.g. an audit event) INTO the\n     * same archive transaction, so they commit atomically with the active→history\n     * move. Invoked in the write phase ONLY on the successful 'archived' path —\n     * never on replay/conflict/generation-mismatch/missing — so the audit is\n     * written iff the archive actually happens. Honor reads-before-writes: do not\n     * read inside the hook. The hook is awaited inside the transaction body, so a\n     * throw or a rejected promise fails the archive instead of committing it\n     * without its write.\n     */\n    auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n  },\n): Promise<ArchiveOutcome> {\n  const {\n    activeRef,\n    historyRef,\n    requestId,\n    observedActivityGeneration,\n    payloadHash,\n    category,\n    audienceScope,\n    expireAtMs,\n    timestampFromMillis,\n    handledBy,\n    auditWrite,\n  } = params;\n\n  return db.runTransaction(async (tx) => {\n    // Reads first (Firestore reads-before-writes).\n    const historySnap = await tx.get(historyRef);\n    if (historySnap.exists) {\n      const existing = (historySnap.data() ?? {}) as Record<string, unknown>;\n      return (existing.payloadHash as string | undefined) === payloadHash ? 'replayed' : 'conflict';\n    }\n    const activeSnap = await tx.get(activeRef);\n    if (!activeSnap.exists) return 'missing';\n    const activeData = (activeSnap.data() ?? {}) as Record<string, unknown>;\n    if ((activeData.activityGeneration as string | undefined) !== observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n\n    const now = Date.now();\n    const historyDoc: Record<string, unknown> = {\n      archiveOccurrenceId: historyRef.id,\n      requestId,\n      payloadHash,\n      activeId: activeRef.id,\n      observedActivityGeneration,\n      category,\n      audienceScope,\n      archivedSnapshot: activeData,\n      archivedAt: now,\n      expireAt: timestampFromMillis(expireAtMs),\n    };\n    if (handledBy !== undefined) historyDoc.handledBy = handledBy;\n\n    tx.set(historyRef, historyDoc);\n    tx.delete(activeRef);\n    // Compose any caller-supplied write (e.g. an audit event) into THIS\n    // transaction so it commits atomically with the archive. Only reached on the\n    // successful path, after all reads, so reads-before-writes is preserved.\n    await auditWrite?.(tx);\n    return 'archived';\n  });\n}\n"]}
+{"version":3,"file":"observed-generation.js","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAmB,EACnB,SAAuB,EACvB,MAA4D;IAE5D,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QAC5D,IAAK,IAAI,CAAC,kBAAyC,KAAK,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1F,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAChC,gBAAgB,EAAE,MAAM,CAAC,0BAA0B;SACpD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,EAAmB,EACnB,MAaC;IAED,MAAM,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,2DAA2D;QAC3D,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;YACvE,OAAQ,QAAQ,CAAC,WAAkC,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QACxE,IAAK,UAAU,CAAC,kBAAyC,KAAK,0BAA0B,EAAE,CAAC;YACzF,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAA4B;YAC1C,mBAAmB,EAAE,UAAU,CAAC,EAAE;YAClC,SAAS;YACT,WAAW;YACX,QAAQ,EAAE,SAAS,CAAC,EAAE;YACtB,0BAA0B;YAC1B,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE,UAAU;YAC5B,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;SAC1C,CAAC;QACF,IAAI,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QAE9D,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrB,MAAM,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\n\nexport type MarkSeenOutcome = 'seen' | 'generation-mismatch' | 'missing';\n\nexport async function markNotificationSeenWithGeneration(\n  db: ServerFirestore,\n  activeRef: ServerDocRef,\n  params: { observedActivityGeneration: string; now?: number },\n): Promise<MarkSeenOutcome> {\n  return db.runTransaction(async (tx) => {\n    const snap = await tx.get(activeRef);\n    if (!snap.exists) return 'missing';\n    const data = (snap.data() ?? {}) as Record<string, unknown>;\n    if ((data.activityGeneration as string | undefined) !== params.observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n    tx.update(activeRef, {\n      seenAt: params.now ?? Date.now(),\n      seenAtGeneration: params.observedActivityGeneration,\n    });\n    return 'seen';\n  });\n}\n\nexport type ArchiveOutcome =\n  'archived' | 'replayed' | 'conflict' | 'generation-mismatch' | 'missing';\n\nexport async function archiveNotificationWithGeneration(\n  db: ServerFirestore,\n  params: {\n    activeRef: ServerDocRef;\n    historyRef: ServerDocRef;\n    requestId: string;\n    observedActivityGeneration: string;\n    payloadHash: string;\n    category: string;\n    audienceScope: string;\n    expireAtMs: number;\n    timestampFromMillis: (ms: number) => unknown;\n    handledBy?: string;\n    /** Runs in the write phase, so it must not read (Firestore reads-before-writes). */\n    auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n  },\n): Promise<ArchiveOutcome> {\n  const {\n    activeRef,\n    historyRef,\n    requestId,\n    observedActivityGeneration,\n    payloadHash,\n    category,\n    audienceScope,\n    expireAtMs,\n    timestampFromMillis,\n    handledBy,\n    auditWrite,\n  } = params;\n\n  return db.runTransaction(async (tx) => {\n    // Firestore transactions take every read before any write.\n    const historySnap = await tx.get(historyRef);\n    if (historySnap.exists) {\n      const existing = (historySnap.data() ?? {}) as Record<string, unknown>;\n      return (existing.payloadHash as string | undefined) === payloadHash ? 'replayed' : 'conflict';\n    }\n    const activeSnap = await tx.get(activeRef);\n    if (!activeSnap.exists) return 'missing';\n    const activeData = (activeSnap.data() ?? {}) as Record<string, unknown>;\n    if ((activeData.activityGeneration as string | undefined) !== observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n\n    const now = Date.now();\n    const historyDoc: Record<string, unknown> = {\n      archiveOccurrenceId: historyRef.id,\n      requestId,\n      payloadHash,\n      activeId: activeRef.id,\n      observedActivityGeneration,\n      category,\n      audienceScope,\n      archivedSnapshot: activeData,\n      archivedAt: now,\n      expireAt: timestampFromMillis(expireAtMs),\n    };\n    if (handledBy !== undefined) historyDoc.handledBy = handledBy;\n\n    tx.set(historyRef, historyDoc);\n    tx.delete(activeRef);\n    await auditWrite?.(tx);\n    return 'archived';\n  });\n}\n"]}

package/dist/server/processBatchHelper.d.ts

@@ -1,7 +1,3 @@
-/**
- * Batch processor helper — called by the app's scheduled Cloud Function.
- * Reads pending notifications, groups by dedupKey, creates/increments active docs.
- */
 import type { NotificationSystemConfig } from '../types.js';
 import type { ServerFirestore } from './types.js';
 interface BatchProcessResult {
@@ -9,21 +5,6 @@ interface BatchProcessResult {
     notificationsCreated: number;
     notificationsUpdated: number;
 }
-/**
- * Process the pending notifications queue.
- *
- * @example
- * ```ts
- * // In your scheduled Cloud Function:
- * export const processNotificationBatch = onSchedule(
- *   { schedule: 'every 10 minutes' },
- *   async () => {
- *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);
- *     logger.info('Batch processed', result);
- *   }
- * );
- * ```
- */
 export declare function processBatchHelper(db: ServerFirestore, config: NotificationSystemConfig): Promise<BatchProcessResult>;
 export {};
 //# sourceMappingURL=processBatchHelper.d.ts.map

package/dist/server/processBatchHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processBatchHelper.d.ts","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAkM7B"}
+{"version":3,"file":"processBatchHelper.d.ts","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAyK7B"}

package/dist/server/processBatchHelper.js

@@ -1,30 +1,11 @@
-/**
- * Batch processor helper — called by the app's scheduled Cloud Function.
- * Reads pending notifications, groups by dedupKey, creates/increments active docs.
- */
 import { buildActiveNotificationDocId } from './activeNotificationId.js';
 const DEFAULT_COUNT_CAP = 5000;
 const DEFAULT_ACTOR_CAP = 5;
 const PROCESSING_BATCH_SIZE = 500;
 const MAX_ITERATIONS = 20;
-/**
- * Process the pending notifications queue.
- *
- * @example
- * ```ts
- * // In your scheduled Cloud Function:
- * export const processNotificationBatch = onSchedule(
- *   { schedule: 'every 10 minutes' },
- *   async () => {
- *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);
- *     logger.info('Batch processed', result);
- *   }
- * );
- * ```
- */
 export async function processBatchHelper(db, config) {
     const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';
-    const cutoff = Date.now() - 30_000; // Process items older than 30 seconds
+    const cutoff = Date.now() - 30_000;
     let totalProcessed = 0;
     let notificationsCreated = 0;
     let notificationsUpdated = 0;
@@ -41,7 +22,6 @@ export async function processBatchHelper(db, config) {
         if (snapshot.empty) {
             break;
         }
-        // Group by dedupKey
         const groups = new Map();
         for (const docSnap of snapshot.docs) {
             const data = docSnap.data();
@@ -52,17 +32,12 @@ export async function processBatchHelper(db, config) {
             if (!categoryConfig)
                 continue;
             const dedupKey = typeConfig.dedupKeyPattern(data.metadata);
-            // Personal notifications dedup per-recipient: a multi-recipient fan-out
-            // (same type/metadata, different targetUserId) must never collapse into
-            // one recipient's active doc. Shared notifications are intentionally a
-            // single doc for all admins (targetUserId is null).
             const groupKey = categoryConfig.audienceType === 'personal'
                 ? `${data.category}::${data.targetUserId}::${dedupKey}`
                 : `${data.category}::${dedupKey}`;
             const existing = groups.get(groupKey);
             if (existing) {
                 existing.count++;
-                // Add actor id if not already present
                 if (!existing.actorIds.includes(data.actorId)) {
                     existing.actorIds.push(data.actorId);
                 }
@@ -80,16 +55,6 @@ export async function processBatchHelper(db, config) {
                 });
             }
         }
-        // Process each group: create or increment the group's active doc.
-        // Each group's groupKey uniquely determines a single active doc — the doc ID
-        // is a deterministic hash of exactly the dedupKey + category (+ targetUserId
-        // for personal) that compose the groupKey — so two distinct groups can never
-        // resolve to the same active doc and there is no cross-group contention. The
-        // work per group is independent I/O, so Promise.all turns N sequential
-        // round-trips into one parallel wave, removing the timeout risk under high
-        // dedup-group counts. WITHIN a dedup scope, the transactional read-modify-write
-        // on the deterministic ID makes concurrent writers (a racing real-time send,
-        // or an overlapping batch run) converge on one doc with correct counts.
         const groupResults = await Promise.all(Array.from(groups.values()).map(async (group) => {
             const typeConfig = config.types[group.type];
             if (!typeConfig)
@@ -101,9 +66,6 @@ export async function processBatchHelper(db, config) {
             const dedupKey = typeConfig.dedupKeyPattern(group.metadata);
             const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;
             const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;
-            // Personal notifications are scoped to the recipient so different
-            // recipients never share an active doc; shared notifications omit
-            // targetUserId by design.
             const activeDocRef = db.collection(activePath).doc(buildActiveNotificationDocId({
                 category: group.category,
                 audienceType: categoryConfig.audienceType,
@@ -113,11 +75,9 @@ export async function processBatchHelper(db, config) {
             return db.runTransaction(async (tx) => {
                 const existingSnap = await tx.get(activeDocRef);
                 if (existingSnap.exists) {
-                    // Increment existing
                     const existingData = (existingSnap.data() ?? {});
                     const currentCount = existingData.count || 1;
                     const currentActorIds = existingData.latestActorIds || [];
-                    // Merge actor ids (new first, deduped, capped)
                     const newActorIds = group.actorIds.filter((id) => !currentActorIds.includes(id));
                     const mergedActorIds = [...newActorIds, ...currentActorIds].slice(0, actorCap);
                     const newCount = Math.min(currentCount + group.count, countCap);
@@ -125,15 +85,13 @@ export async function processBatchHelper(db, config) {
                         count: newCount,
                         latestActorIds: mergedActorIds,
                         message: typeConfig.messagePattern(group.metadata, newCount),
-                        // New activity on an existing notification re-lights the unread badge.
                         seenAt: 0,
                         updatedAt: Date.now(),
                     });
                     return 'updated';
                 }
                 else {
-                    // Create new notification. A type with no defaultTargetPath is
-                    // linkless — OMIT the field (Firestore rejects `undefined` values).
+                    // Firestore rejects `undefined` values, so a linkless type omits the field.
                     const targetPath = typeConfig.defaultTargetPath === undefined
                         ? undefined
                         : typeof typeConfig.defaultTargetPath === 'function'
@@ -151,7 +109,6 @@ export async function processBatchHelper(db, config) {
                         latestActorIds: group.actorIds.slice(0, actorCap),
                         ...(targetPath === undefined ? {} : { targetPath }),
                         metadata: group.metadata,
-                        // Active docs are created unseen so the unread count() predicate matches.
                         seenAt: 0,
                         createdAt: now,
                         updatedAt: now,
@@ -167,7 +124,6 @@ export async function processBatchHelper(db, config) {
             else if (r === 'updated')
                 notificationsUpdated++;
         }
-        // Delete processed pending docs in batches of 500
         const allDocs = snapshot.docs;
         for (let i = 0; i < allDocs.length; i += 500) {
             const chunk = allDocs.slice(i, i + 500);

package/dist/server/processBatchHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"processBatchHelper.js","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Batch processor helper — called by the app's scheduled Cloud Function.\n * Reads pending notifications, groups by dedupKey, creates/increments active docs.\n */\n\nimport type { NotificationSystemConfig, PendingNotification } from '../types.js';\nimport type { ServerFirestore } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst PROCESSING_BATCH_SIZE = 500;\nconst MAX_ITERATIONS = 20;\n\ninterface BatchProcessResult {\n  totalProcessed: number;\n  notificationsCreated: number;\n  notificationsUpdated: number;\n}\n\n/**\n * Process the pending notifications queue.\n *\n * @example\n * ```ts\n * // In your scheduled Cloud Function:\n * export const processNotificationBatch = onSchedule(\n *   { schedule: 'every 10 minutes' },\n *   async () => {\n *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);\n *     logger.info('Batch processed', result);\n *   }\n * );\n * ```\n */\nexport async function processBatchHelper(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n): Promise<BatchProcessResult> {\n  const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';\n  const cutoff = Date.now() - 30_000; // Process items older than 30 seconds\n\n  let totalProcessed = 0;\n  let notificationsCreated = 0;\n  let notificationsUpdated = 0;\n  let iterations = 0;\n  let hasMore = true;\n\n  while (hasMore && iterations < MAX_ITERATIONS) {\n    iterations++;\n\n    const pendingQuery = db\n      .collection(pendingPath)\n      .where('createdAt', '<=', cutoff)\n      .orderBy('createdAt', 'asc')\n      .limit(PROCESSING_BATCH_SIZE);\n\n    const snapshot = await pendingQuery.get();\n\n    if (snapshot.empty) {\n      break;\n    }\n\n    // Group by dedupKey\n    const groups = new Map<\n      string,\n      {\n        type: string;\n        category: string;\n        targetUserId: string | null;\n        metadata: Record<string, unknown>;\n        actorIds: string[];\n        count: number;\n        docs: typeof snapshot.docs;\n      }\n    >();\n\n    for (const docSnap of snapshot.docs) {\n      const data = docSnap.data() as Omit<PendingNotification, 'id'>;\n      const typeConfig = config.types[data.type];\n      if (!typeConfig) continue;\n      const categoryConfig = config.categories[data.category];\n      if (!categoryConfig) continue;\n\n      const dedupKey = typeConfig.dedupKeyPattern(data.metadata);\n      // Personal notifications dedup per-recipient: a multi-recipient fan-out\n      // (same type/metadata, different targetUserId) must never collapse into\n      // one recipient's active doc. Shared notifications are intentionally a\n      // single doc for all admins (targetUserId is null).\n      const groupKey =\n        categoryConfig.audienceType === 'personal'\n          ? `${data.category}::${data.targetUserId}::${dedupKey}`\n          : `${data.category}::${dedupKey}`;\n\n      const existing = groups.get(groupKey);\n      if (existing) {\n        existing.count++;\n        // Add actor id if not already present\n        if (!existing.actorIds.includes(data.actorId)) {\n          existing.actorIds.push(data.actorId);\n        }\n        existing.docs.push(docSnap);\n      } else {\n        groups.set(groupKey, {\n          type: data.type,\n          category: data.category,\n          targetUserId: data.targetUserId,\n          metadata: data.metadata,\n          actorIds: [data.actorId],\n          count: 1,\n          docs: [docSnap],\n        });\n      }\n    }\n\n    // Process each group: create or increment the group's active doc.\n    // Each group's groupKey uniquely determines a single active doc — the doc ID\n    // is a deterministic hash of exactly the dedupKey + category (+ targetUserId\n    // for personal) that compose the groupKey — so two distinct groups can never\n    // resolve to the same active doc and there is no cross-group contention. The\n    // work per group is independent I/O, so Promise.all turns N sequential\n    // round-trips into one parallel wave, removing the timeout risk under high\n    // dedup-group counts. WITHIN a dedup scope, the transactional read-modify-write\n    // on the deterministic ID makes concurrent writers (a racing real-time send,\n    // or an overlapping batch run) converge on one doc with correct counts.\n    const groupResults = await Promise.all(\n      Array.from(groups.values()).map(async (group): Promise<'created' | 'updated' | 'skipped'> => {\n        const typeConfig = config.types[group.type];\n        if (!typeConfig) return 'skipped';\n\n        const categoryConfig = config.categories[group.category];\n        if (!categoryConfig) return 'skipped';\n\n        const activePath = categoryConfig.activePath;\n        const dedupKey = typeConfig.dedupKeyPattern(group.metadata);\n        const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n        const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n\n        // Personal notifications are scoped to the recipient so different\n        // recipients never share an active doc; shared notifications omit\n        // targetUserId by design.\n        const activeDocRef = db.collection(activePath).doc(\n          buildActiveNotificationDocId({\n            category: group.category,\n            audienceType: categoryConfig.audienceType,\n            targetUserId: group.targetUserId,\n            dedupKey,\n          }),\n        );\n\n        return db.runTransaction(async (tx): Promise<'created' | 'updated'> => {\n          const existingSnap = await tx.get(activeDocRef);\n\n          if (existingSnap.exists) {\n            // Increment existing\n            const existingData = (existingSnap.data() ?? {}) as Record<string, unknown>;\n            const currentCount = (existingData.count as number) || 1;\n            const currentActorIds = (existingData.latestActorIds as string[]) || [];\n\n            // Merge actor ids (new first, deduped, capped)\n            const newActorIds = group.actorIds.filter((id) => !currentActorIds.includes(id));\n            const mergedActorIds = [...newActorIds, ...currentActorIds].slice(0, actorCap);\n\n            const newCount = Math.min(currentCount + group.count, countCap);\n\n            tx.update(activeDocRef, {\n              count: newCount,\n              latestActorIds: mergedActorIds,\n              message: typeConfig.messagePattern(group.metadata, newCount),\n              // New activity on an existing notification re-lights the unread badge.\n              seenAt: 0,\n              updatedAt: Date.now(),\n            });\n\n            return 'updated';\n          } else {\n            // Create new notification. A type with no defaultTargetPath is\n            // linkless — OMIT the field (Firestore rejects `undefined` values).\n            const targetPath =\n              typeConfig.defaultTargetPath === undefined\n                ? undefined\n                : typeof typeConfig.defaultTargetPath === 'function'\n                  ? typeConfig.defaultTargetPath(group.metadata)\n                  : typeConfig.defaultTargetPath;\n            const now = Date.now();\n\n            const newDoc = {\n              type: group.type,\n              dedupKey,\n              category: group.category,\n              targetUserId: group.targetUserId,\n              title: typeConfig.titlePattern(group.metadata),\n              message: typeConfig.messagePattern(group.metadata, group.count),\n              count: group.count,\n              latestActorIds: group.actorIds.slice(0, actorCap),\n              ...(targetPath === undefined ? {} : { targetPath }),\n              metadata: group.metadata,\n              // Active docs are created unseen so the unread count() predicate matches.\n              seenAt: 0,\n              createdAt: now,\n              updatedAt: now,\n            };\n\n            tx.set(activeDocRef, newDoc);\n            return 'created';\n          }\n        });\n      }),\n    );\n\n    for (const r of groupResults) {\n      if (r === 'created') notificationsCreated++;\n      else if (r === 'updated') notificationsUpdated++;\n    }\n\n    // Delete processed pending docs in batches of 500\n    const allDocs = snapshot.docs;\n    for (let i = 0; i < allDocs.length; i += 500) {\n      const chunk = allDocs.slice(i, i + 500);\n      const batch = db.batch();\n      chunk.forEach((docSnap) => batch.delete(docSnap.ref));\n      await batch.commit();\n    }\n\n    totalProcessed += snapshot.size;\n\n    if (snapshot.size < PROCESSING_BATCH_SIZE) {\n      hasMore = false;\n    }\n  }\n\n  return { totalProcessed, notificationsCreated, notificationsUpdated };\n}\n"]}
+{"version":3,"file":"processBatchHelper.js","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NotificationSystemConfig, PendingNotification } from '../types.js';\nimport type { ServerFirestore } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst PROCESSING_BATCH_SIZE = 500;\nconst MAX_ITERATIONS = 20;\n\ninterface BatchProcessResult {\n  totalProcessed: number;\n  notificationsCreated: number;\n  notificationsUpdated: number;\n}\n\nexport async function processBatchHelper(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n): Promise<BatchProcessResult> {\n  const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';\n  const cutoff = Date.now() - 30_000;\n\n  let totalProcessed = 0;\n  let notificationsCreated = 0;\n  let notificationsUpdated = 0;\n  let iterations = 0;\n  let hasMore = true;\n\n  while (hasMore && iterations < MAX_ITERATIONS) {\n    iterations++;\n\n    const pendingQuery = db\n      .collection(pendingPath)\n      .where('createdAt', '<=', cutoff)\n      .orderBy('createdAt', 'asc')\n      .limit(PROCESSING_BATCH_SIZE);\n\n    const snapshot = await pendingQuery.get();\n\n    if (snapshot.empty) {\n      break;\n    }\n\n    const groups = new Map<\n      string,\n      {\n        type: string;\n        category: string;\n        targetUserId: string | null;\n        metadata: Record<string, unknown>;\n        actorIds: string[];\n        count: number;\n        docs: typeof snapshot.docs;\n      }\n    >();\n\n    for (const docSnap of snapshot.docs) {\n      const data = docSnap.data() as Omit<PendingNotification, 'id'>;\n      const typeConfig = config.types[data.type];\n      if (!typeConfig) continue;\n      const categoryConfig = config.categories[data.category];\n      if (!categoryConfig) continue;\n\n      const dedupKey = typeConfig.dedupKeyPattern(data.metadata);\n      const groupKey =\n        categoryConfig.audienceType === 'personal'\n          ? `${data.category}::${data.targetUserId}::${dedupKey}`\n          : `${data.category}::${dedupKey}`;\n\n      const existing = groups.get(groupKey);\n      if (existing) {\n        existing.count++;\n        if (!existing.actorIds.includes(data.actorId)) {\n          existing.actorIds.push(data.actorId);\n        }\n        existing.docs.push(docSnap);\n      } else {\n        groups.set(groupKey, {\n          type: data.type,\n          category: data.category,\n          targetUserId: data.targetUserId,\n          metadata: data.metadata,\n          actorIds: [data.actorId],\n          count: 1,\n          docs: [docSnap],\n        });\n      }\n    }\n\n    const groupResults = await Promise.all(\n      Array.from(groups.values()).map(async (group): Promise<'created' | 'updated' | 'skipped'> => {\n        const typeConfig = config.types[group.type];\n        if (!typeConfig) return 'skipped';\n\n        const categoryConfig = config.categories[group.category];\n        if (!categoryConfig) return 'skipped';\n\n        const activePath = categoryConfig.activePath;\n        const dedupKey = typeConfig.dedupKeyPattern(group.metadata);\n        const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n        const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n\n        const activeDocRef = db.collection(activePath).doc(\n          buildActiveNotificationDocId({\n            category: group.category,\n            audienceType: categoryConfig.audienceType,\n            targetUserId: group.targetUserId,\n            dedupKey,\n          }),\n        );\n\n        return db.runTransaction(async (tx): Promise<'created' | 'updated'> => {\n          const existingSnap = await tx.get(activeDocRef);\n\n          if (existingSnap.exists) {\n            const existingData = (existingSnap.data() ?? {}) as Record<string, unknown>;\n            const currentCount = (existingData.count as number) || 1;\n            const currentActorIds = (existingData.latestActorIds as string[]) || [];\n\n            const newActorIds = group.actorIds.filter((id) => !currentActorIds.includes(id));\n            const mergedActorIds = [...newActorIds, ...currentActorIds].slice(0, actorCap);\n\n            const newCount = Math.min(currentCount + group.count, countCap);\n\n            tx.update(activeDocRef, {\n              count: newCount,\n              latestActorIds: mergedActorIds,\n              message: typeConfig.messagePattern(group.metadata, newCount),\n              seenAt: 0,\n              updatedAt: Date.now(),\n            });\n\n            return 'updated';\n          } else {\n            // Firestore rejects `undefined` values, so a linkless type omits the field.\n            const targetPath =\n              typeConfig.defaultTargetPath === undefined\n                ? undefined\n                : typeof typeConfig.defaultTargetPath === 'function'\n                  ? typeConfig.defaultTargetPath(group.metadata)\n                  : typeConfig.defaultTargetPath;\n            const now = Date.now();\n\n            const newDoc = {\n              type: group.type,\n              dedupKey,\n              category: group.category,\n              targetUserId: group.targetUserId,\n              title: typeConfig.titlePattern(group.metadata),\n              message: typeConfig.messagePattern(group.metadata, group.count),\n              count: group.count,\n              latestActorIds: group.actorIds.slice(0, actorCap),\n              ...(targetPath === undefined ? {} : { targetPath }),\n              metadata: group.metadata,\n              seenAt: 0,\n              createdAt: now,\n              updatedAt: now,\n            };\n\n            tx.set(activeDocRef, newDoc);\n            return 'created';\n          }\n        });\n      }),\n    );\n\n    for (const r of groupResults) {\n      if (r === 'created') notificationsCreated++;\n      else if (r === 'updated') notificationsUpdated++;\n    }\n\n    const allDocs = snapshot.docs;\n    for (let i = 0; i < allDocs.length; i += 500) {\n      const chunk = allDocs.slice(i, i + 500);\n      const batch = db.batch();\n      chunk.forEach((docSnap) => batch.delete(docSnap.ref));\n      await batch.commit();\n    }\n\n    totalProcessed += snapshot.size;\n\n    if (snapshot.size < PROCESSING_BATCH_SIZE) {\n      hasMore = false;\n    }\n  }\n\n  return { totalProcessed, notificationsCreated, notificationsUpdated };\n}\n"]}

package/dist/server/types.d.ts

@@ -1,11 +1,3 @@
-/**
- * Server-side types for notification-core backend helpers.
- * These use firebase-admin Firestore types passed in by the calling app.
- */
-/**
- * Firestore interface — matches firebase-admin's Firestore type.
- * We accept this instead of importing firebase-admin directly.
- */
 export interface ServerFirestore {
     collection(path: string): ServerCollectionRef;
     doc(path: string): ServerDocRef;
@@ -50,7 +42,6 @@ export interface ServerDocRef {
         merge?: boolean;
     }): Promise<unknown>;
     update(data: Record<string, unknown>): Promise<unknown>;
-    /** Create-if-absent. Rejects with an `already-exists` error (gRPC code 6) if the doc exists. */
     create(data: Record<string, unknown>): Promise<unknown>;
     delete(): Promise<unknown>;
     get(): Promise<ServerDocSnapshot>;

package/dist/server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}

package/dist/server/types.js

@@ -1,6 +1,2 @@
-/**
- * Server-side types for notification-core backend helpers.
- * These use firebase-admin Firestore types passed in by the calling app.
- */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Server-side types for notification-core backend helpers.\n * These use firebase-admin Firestore types passed in by the calling app.\n */\n\n/**\n * Firestore interface — matches firebase-admin's Firestore type.\n * We accept this instead of importing firebase-admin directly.\n */\nexport interface ServerFirestore {\n  collection(path: string): ServerCollectionRef;\n  doc(path: string): ServerDocRef;\n  batch(): ServerWriteBatch;\n  runTransaction<T>(updateFunction: (transaction: ServerTransaction) => Promise<T>): Promise<T>;\n}\n\nexport interface ServerTransaction {\n  get(ref: ServerDocRef): Promise<ServerDocSnapshot>;\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerTransaction;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerTransaction;\n  delete(ref: ServerDocRef): ServerTransaction;\n}\n\nexport interface ServerCollectionRef {\n  doc(id?: string): ServerDocRef;\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  add(data: Record<string, unknown>): Promise<ServerDocRef>;\n}\n\nexport interface ServerQuery {\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  get(): Promise<ServerQuerySnapshot>;\n}\n\nexport interface ServerQuerySnapshot {\n  empty: boolean;\n  size: number;\n  docs: ServerDocSnapshot[];\n}\n\nexport interface ServerDocSnapshot {\n  id: string;\n  exists: boolean;\n  data(): Record<string, unknown> | undefined;\n  ref: ServerDocRef;\n}\n\nexport interface ServerDocRef {\n  id: string;\n  set(data: Record<string, unknown>, options?: { merge?: boolean }): Promise<unknown>;\n  update(data: Record<string, unknown>): Promise<unknown>;\n  /** Create-if-absent. Rejects with an `already-exists` error (gRPC code 6) if the doc exists. */\n  create(data: Record<string, unknown>): Promise<unknown>;\n  delete(): Promise<unknown>;\n  get(): Promise<ServerDocSnapshot>;\n}\n\nexport interface ServerWriteBatch {\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerWriteBatch;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerWriteBatch;\n  delete(ref: ServerDocRef): ServerWriteBatch;\n  commit(): Promise<unknown>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ServerFirestore {\n  collection(path: string): ServerCollectionRef;\n  doc(path: string): ServerDocRef;\n  batch(): ServerWriteBatch;\n  runTransaction<T>(updateFunction: (transaction: ServerTransaction) => Promise<T>): Promise<T>;\n}\n\nexport interface ServerTransaction {\n  get(ref: ServerDocRef): Promise<ServerDocSnapshot>;\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerTransaction;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerTransaction;\n  delete(ref: ServerDocRef): ServerTransaction;\n}\n\nexport interface ServerCollectionRef {\n  doc(id?: string): ServerDocRef;\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  add(data: Record<string, unknown>): Promise<ServerDocRef>;\n}\n\nexport interface ServerQuery {\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  get(): Promise<ServerQuerySnapshot>;\n}\n\nexport interface ServerQuerySnapshot {\n  empty: boolean;\n  size: number;\n  docs: ServerDocSnapshot[];\n}\n\nexport interface ServerDocSnapshot {\n  id: string;\n  exists: boolean;\n  data(): Record<string, unknown> | undefined;\n  ref: ServerDocRef;\n}\n\nexport interface ServerDocRef {\n  id: string;\n  set(data: Record<string, unknown>, options?: { merge?: boolean }): Promise<unknown>;\n  update(data: Record<string, unknown>): Promise<unknown>;\n  create(data: Record<string, unknown>): Promise<unknown>;\n  delete(): Promise<unknown>;\n  get(): Promise<ServerDocSnapshot>;\n}\n\nexport interface ServerWriteBatch {\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerWriteBatch;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerWriteBatch;\n  delete(ref: ServerDocRef): ServerWriteBatch;\n  commit(): Promise<unknown>;\n}\n"]}