@ours.network/notifications 1.0.1 → 1.0.3-nightly.1

package/README.md

@@ -55,7 +55,7 @@ Responses are never cached. User and producer credentials have separate scopes.
 | POST `/api/v1/devices` | User | `{ "subscription": PushSubscriptionJSON }` → device `id` |
 | POST `/api/v1/devices/delete` | User | `{ "id": "device-id" }`, only that user's device |
 | GET `/api/v1/devices/status?id=...` | User | `{ "active": true }` |
-| GET `/api/v1/inbox?limit=50&before=...` | User | Items, shared unread count, revision, next cursor |
+| GET `/api/v1/inbox?limit=50&before=...&unread=true` | User | Items, shared unread count, revision, next cursor; with `unread=true` only unread items and `filter: "unread"` |
 | GET `/api/v1/unread-evidence?target=TARGET_JSON[&target=ALIAS_JSON]&revision=OBSERVED_REVISION&limit=100&after=...` | User | Capability `unread-evidence/1`: one conversation's records created at or before the observed revision and still unread, oldest first (limit 1-200). A record read since that revision is absent, so a caller comparing with that revision's count sees it as incomplete. Items omit title and body. A cursor whose record was deleted, or that this scope and revision could not have returned, answers 409. Services without the route answer 404 |
 | GET `/api/v1/summary` | User | Shared unread count, revision, per-chat source/identity/count, and `sections: {chats, tasks}`; mission-associated rows (task and room targets, or any row with a `taskId`) count under `chats`, agent rows without a `taskId` field count in neither section (as before), and `tasks` is always 0 (kept for compatibility) |
 | POST `/api/v1/read-target` | User | `{ "target": { "kind": "agent", "agentId": "agent" }, "revision": OBSERVED_REVISION }`, reads only this chat up to the revision captured before its history load |

package/dist/server.js

@@ -134,7 +134,10 @@ export function createNotificationService(config, send) {
                 const limit = Number(url.searchParams.get('limit') ?? 50);
                 if (!Number.isInteger(limit) || limit < 1 || limit > 100)
                     throw new HttpError(400, 'invalid limit');
-                result = store.inbox(user, url.searchParams.get('before') ?? undefined, limit);
+                const unread = url.searchParams.get('unread');
+                if (unread !== null && unread !== 'true' && unread !== 'false')
+                    throw new HttpError(400, 'invalid unread filter');
+                result = store.inbox(user, url.searchParams.get('before') ?? undefined, limit, unread === 'true');
             }
             else if (req.method === 'GET' && url.pathname === '/api/v1/unread-evidence') {
                 // Capability `unread-evidence/1`: a separate route, so a service without it answers

package/dist/store.d.ts

@@ -74,7 +74,9 @@ export declare class Store {
     deleteDevice(userId: string, id: string): boolean;
     device(userId: string, id: string): Device | undefined;
     deviceStatus(userId: string, id: string): boolean;
-    inbox(userId: string, before?: string, limit?: number): {
+    /** Newest first. With `unread`, only unread records; the cursor may name a record that has been read since. */
+    inbox(userId: string, before?: string, limit?: number, unread?: boolean): {
+        filter?: "unread" | undefined;
         items: Notification[];
         unread: number;
         revision: number;

package/dist/store.js

@@ -313,14 +313,16 @@ export class Store {
     }
     device(userId, id) { const d = this.state.devices.find(d => d.id === id && d.userId === userId); return d ? structuredClone(d) : undefined; }
     deviceStatus(userId, id) { return this.state.devices.some(d => d.id === id && d.userId === userId); }
-    inbox(userId, before, limit = 50) {
+    /** Newest first. With `unread`, only unread records; the cursor may name a record that has been read since. */
+    inbox(userId, before, limit = 50, unread = false) {
         const all = this.state.notifications.filter(n => n.userId === userId);
         const index = before ? all.findIndex(n => n.id === before) : all.length;
         if (index < 0)
             throw new HttpError(400, 'invalid cursor');
-        const items = all.slice(Math.max(0, index - limit), index).reverse();
+        const older = unread ? all.slice(0, index).filter(n => !n.readAt) : all.slice(0, index);
+        const items = older.slice(Math.max(0, older.length - limit)).reverse();
         return { items, unread: all.filter(n => !n.readAt).length, revision: this.state.revision,
-            nextCursor: index > limit ? items.at(-1)?.id : null };
+            nextCursor: older.length > limit ? items.at(-1)?.id : null, ...(unread ? { filter: 'unread' } : {}) };
     }
     /**
      * One conversation's unread evidence as of an observed revision, oldest first.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ours.network/notifications",
-  "version": "1.0.1",
+  "version": "1.0.3-nightly.1",
   "description": "Authenticated web push delivery and shared notification inbox",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",