@devmonks/notify 0.3.0 → 0.4.0

package/README.md

@@ -119,7 +119,7 @@ const store = drizzleStore(db, { notifications, devices, notificationPrefs, noti
 });
 ```
 
-Store methods: `loadRecipient`, `writeInbox` (the inApp write), `recordDelivery` (false if the idempotency key exists: do not send), `finishDelivery`, `touchDevice` (upsert by device id; a token seen under another device id moves), `handleDeviceResult` (device cleanup from a send result) and `pruneDevices`.
+Store methods: `loadRecipient` / `loadRecipients(ids)` (batch, for fan-out), `writeInbox` (the inApp write; returns the new row id, or null when `(type, sourceId, user)` already exists), `recordDelivery` (false if the idempotency key exists: do not send), `finishDelivery`, `touchDevice` (upsert by device id; a token seen under another device id moves), `handleDeviceResult` (device cleanup from a send result), `pruneDevices` and `pruneHistory(days)`.
 
 Devices: one row per install (`id` is stable, the token may rotate). A dead address (`deadAddress`) deletes the device at once; any other permanent failure adds a strike and the device is deleted at 3; a success resets the count; retryable failures change nothing. `pruneDevices()` removes devices unseen for `pruneInactiveAfterDays` and does nothing while that is null.
 

package/dist/drizzle/store.d.ts

@@ -31,13 +31,14 @@ export declare function drizzleStore(db: AnyPgDb, tables: NotifyTables, opts: Dr
     loadRecipients(userIds: readonly string[]): Promise<Map<string, Recipient>>;
     /**
      * The inApp channel's write. With a `sourceId`, a second write for the same type, source and user
-     * is ignored. Returns whether a row was inserted.
+     * is ignored. Returns the new row's id (e.g. to put in the push data so a tap can mark it read), or
+     * null when nothing was inserted.
      */
     writeInbox(recipientId: string, content: Content, meta?: {
         type?: string;
         sourceId?: string;
         actorId?: string;
-    }): Promise<boolean>;
+    }): Promise<string | null>;
     /** Inserts a pending delivery row. False when the idempotency key already exists (do not send again). */
     recordDelivery(d: Delivery): Promise<boolean>;
     finishDelivery(d: Delivery, status: "sent" | "failed" | "skipped", attempts: number, error?: string): Promise<void>;

package/dist/drizzle/store.js

@@ -52,7 +52,8 @@ export function drizzleStore(db, tables, opts) {
         },
         /**
          * The inApp channel's write. With a `sourceId`, a second write for the same type, source and user
-         * is ignored. Returns whether a row was inserted.
+         * is ignored. Returns the new row's id (e.g. to put in the push data so a tap can mark it read), or
+         * null when nothing was inserted.
          */
         async writeInbox(recipientId, content, meta = {}) {
             const rows = await db
@@ -70,7 +71,7 @@ export function drizzleStore(db, tables, opts) {
             })
                 .onConflictDoNothing()
                 .returning({ id: notifications.id });
-            return rows.length > 0;
+            return rows[0]?.id ?? null;
         },
         /** Inserts a pending delivery row. False when the idempotency key already exists (do not send again). */
         async recordDelivery(d) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devmonks/notify",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Plan-then-send notifications with an FCM HTTP v1 push adapter. No DB, no queue; the core entry has no dependencies. Optional email (Resend + React Email) and Drizzle entries.",
   "license": "MIT",
   "keywords": [