@sparkvault/sdk-mobile 4.3.2 → 4.5.0

package/dist/client.d.ts

@@ -6,8 +6,8 @@ import { MobileFoldersClient } from './folders.js';
 import { MobileHealthClient } from './health.js';
 import { type AuthEventListener } from './http.js';
 import { MobileIngotsClient } from './ingots.js';
+import { MobileNotifyClient } from './notify.js';
 import { MobileProductsClient } from './products/index.js';
-import { MobilePushTokensClient } from './push-tokens.js';
 import { MobileSparksClient } from './sparks.js';
 import { MobileUsersClient } from './users.js';
 import { MobileVaultsClient } from './vaults.js';
@@ -21,7 +21,7 @@ export declare class SparkVaultMobile {
     readonly health: MobileHealthClient;
     readonly sparks: MobileSparksClient;
     readonly entropy: MobileEntropyClient;
-    readonly pushTokens: MobilePushTokensClient;
+    readonly notify: MobileNotifyClient;
     readonly billing: MobileBillingClient;
     readonly users: MobileUsersClient;
     private readonly http;

package/dist/client.js

@@ -6,8 +6,8 @@ import { MobileFoldersClient } from './folders.js';
 import { MobileHealthClient } from './health.js';
 import { MobileHttpClient } from './http.js';
 import { MobileIngotsClient } from './ingots.js';
+import { MobileNotifyClient } from './notify.js';
 import { MobileProductsClient } from './products/index.js';
-import { MobilePushTokensClient } from './push-tokens.js';
 import { MobileSparksClient } from './sparks.js';
 import { MobileUsersClient } from './users.js';
 import { MobileVaultsClient } from './vaults.js';
@@ -23,7 +23,7 @@ export class SparkVaultMobile {
         this.health = new MobileHealthClient(this.config);
         this.sparks = new MobileSparksClient(this.http);
         this.entropy = new MobileEntropyClient(this.http);
-        this.pushTokens = new MobilePushTokensClient(this.http);
+        this.notify = new MobileNotifyClient(this.http);
         this.billing = new MobileBillingClient(this.http);
         this.users = new MobileUsersClient(this.http);
         if (this.config.preloadIdentityConfig) {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAA0D,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,gBAAgB;IAe3B,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,QAA2B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,MAA8B;IACzE,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAA0D,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,gBAAgB;IAe3B,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,QAA2B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,MAA8B;IACzE,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -13,8 +13,8 @@ export { MobileSparksClient, } from './sparks.js';
 export type { CreateSparkOptions, CreateSparkResponse, ListSparksOptions, ListSparksResponse, ShareSparkOptions, Spark, SparkResponse, } from './sparks.js';
 export { MobileEntropyClient, } from './entropy.js';
 export type { EntropyFormat, EntropyResponse, GenerateEntropyOptions, } from './entropy.js';
-export { MobilePushTokensClient, } from './push-tokens.js';
-export type { RegisterPushTokenResponse, } from './push-tokens.js';
+export { MobileNotifyClient, } from './notify.js';
+export type { NotificationInboxState, NotificationMarkState, NotificationRow, ListNotificationsOptions, ListNotificationsResponse, UnreadCountResponse, MarkNotificationStateOptions, MarkNotificationStateResponse, RegisterDeviceResponse, } from './notify.js';
 export { MobileBillingClient, } from './billing.js';
 export type { PortalSession, } from './billing.js';
 export { MobileUsersClient, } from './users.js';

package/dist/index.js

@@ -7,7 +7,7 @@ export { MobileIngotsClient, } from './ingots.js';
 export { MobileHealthClient, } from './health.js';
 export { MobileSparksClient, } from './sparks.js';
 export { MobileEntropyClient, } from './entropy.js';
-export { MobilePushTokensClient, } from './push-tokens.js';
+export { MobileNotifyClient, } from './notify.js';
 export { MobileBillingClient, } from './billing.js';
 export { MobileUsersClient, } from './users.js';
 export { MobileTusUploader, parseForgeUrl, } from './tus.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAYrB,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,aAAa,GACd,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/notify.d.ts

@@ -0,0 +1,84 @@
+import type { MobileHttpClient } from './http.js';
+/** Inbox views the feed can be filtered to. `all` excludes archived rows. */
+export type NotificationInboxState = 'all' | 'unseen' | 'unread' | 'archived';
+/** Terminal display states the recipient can apply to one of their rows. */
+export type NotificationMarkState = 'seen' | 'read' | 'archived';
+/**
+ * A metadata-only inbox row. Rows are LOCKED pointers: the content lives behind
+ * the SparkLink (`sparklink_code`) and is never carried here — open the SparkLink
+ * to unseal it. Timestamps are epoch SECONDS.
+ */
+export interface NotificationRow {
+    notification_id: string;
+    send_id: string;
+    created_at: number;
+    title: string;
+    category: string;
+    type: string;
+    seen_at: number | null;
+    read_at: number | null;
+    archived_at: number | null;
+    sparklink_code: string;
+    locked: true;
+    thread_id?: string;
+}
+export interface ListNotificationsOptions {
+    state?: NotificationInboxState;
+    /** Page size, 1-100 (server default 50). */
+    limit?: number;
+    /** Opaque cursor from a prior response. */
+    cursor?: string;
+}
+export interface ListNotificationsResponse {
+    notifications: NotificationRow[];
+    /**
+     * Next-page cursor, or null on the last page. A page can be SHORT of `limit`
+     * yet still carry a non-null cursor (the state/sender filter is applied after
+     * the key query) — follow the cursor; never treat a short page as the end.
+     */
+    cursor: string | null;
+}
+export interface UnreadCountResponse {
+    unread_count: number;
+    /** True when the true count is at/beyond the badge ceiling (render "N+"). */
+    capped: boolean;
+}
+export interface MarkNotificationStateOptions {
+    /** The row's `created_at` (epoch seconds), round-tripped from the list row. Required. */
+    createdAt: number;
+    state: NotificationMarkState;
+}
+export interface MarkNotificationStateResponse {
+    notification_id: string;
+    state: NotificationMarkState;
+    updated_at: number;
+}
+/** Response to registering/refreshing this device's push token. */
+export interface RegisterDeviceResponse {
+    success: boolean;
+    created: boolean;
+    refreshed: boolean;
+}
+/**
+ * The signed-in user's first-party Notify surface: their own metadata-only inbox
+ * plus this device's push registration. The recipient is ALWAYS derived from the
+ * session on the server — no method takes a `recipient_id`, and any account/
+ * recipient a caller might try to supply is ignored.
+ */
+export declare class MobileNotifyClient {
+    private readonly http;
+    constructor(http: MobileHttpClient);
+    /** The caller's own inbox feed (newest first). */
+    getInbox(options?: ListNotificationsOptions): Promise<ListNotificationsResponse>;
+    /** Bounded unseen badge count for the caller's own inbox. */
+    getUnreadCount(): Promise<UnreadCountResponse>;
+    /**
+     * Apply a terminal display state to one of the caller's own rows (idempotent).
+     * `createdAt` MUST be the row's own `created_at` — the id alone is insufficient.
+     */
+    markState(notificationId: string, options: MarkNotificationStateOptions): Promise<MarkNotificationStateResponse>;
+    /** Register/refresh this device's Expo push token under the session user. */
+    registerDevice(pushToken: string): Promise<RegisterDeviceResponse>;
+    /** Deregister a device token (logout / disable notifications). */
+    unregisterDevice(tokenHash: string): Promise<void>;
+}

package/dist/notify.js

@@ -0,0 +1,49 @@
+/**
+ * The signed-in user's first-party Notify surface: their own metadata-only inbox
+ * plus this device's push registration. The recipient is ALWAYS derived from the
+ * session on the server — no method takes a `recipient_id`, and any account/
+ * recipient a caller might try to supply is ignored.
+ */
+export class MobileNotifyClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /** The caller's own inbox feed (newest first). */
+    async getInbox(options = {}) {
+        const params = new URLSearchParams();
+        if (options.state)
+            params.set('state', options.state);
+        if (options.limit)
+            params.set('limit', String(options.limit));
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const query = params.toString();
+        const response = await this.http.get(query ? `/me/notifications?${query}` : '/me/notifications');
+        return response.data;
+    }
+    /** Bounded unseen badge count for the caller's own inbox. */
+    async getUnreadCount() {
+        const response = await this.http.get('/me/notifications/unread-count');
+        return response.data;
+    }
+    /**
+     * Apply a terminal display state to one of the caller's own rows (idempotent).
+     * `createdAt` MUST be the row's own `created_at` — the id alone is insufficient.
+     */
+    async markState(notificationId, options) {
+        const response = await this.http.post(`/me/notifications/${encodeURIComponent(notificationId)}/state`, { created_at: options.createdAt, state: options.state });
+        return response.data;
+    }
+    /** Register/refresh this device's Expo push token under the session user. */
+    async registerDevice(pushToken) {
+        const response = await this.http.post('/me/notifications/devices', {
+            push_token: pushToken,
+        });
+        return response.data;
+    }
+    /** Deregister a device token (logout / disable notifications). */
+    async unregisterDevice(tokenHash) {
+        await this.http.delete(`/me/notifications/devices/${encodeURIComponent(tokenHash)}`);
+    }
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAuEA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAG7B,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,QAAQ,CAAC,UAAoC,EAAE;QACnD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,KAAK,CAAC,CAAC,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAC3D,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,gCAAgC,CAAC,CAAC;QAC5F,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CACb,cAAsB,EACtB,OAAqC;QAErC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CACnC,qBAAqB,kBAAkB,CAAC,cAAc,CAAC,QAAQ,EAC/D,EAAE,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CACxD,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAyB,2BAA2B,EAAE;YACzF,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACtC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,6BAA6B,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;CACF"}

package/dist/types.d.ts

@@ -135,13 +135,17 @@ export interface SubscriptionIdentityStatus {
     state: PoolState;
 }
 /**
- * GET /v1/billing/subscription — the account's current plan, licensed vs. used
- * seats, capacity blocks, live pool usage, and Identity attempts. Drives the
- * subscription / usage view. `renewal_amount_usd` is a formatted dollars string;
- * `renewal_date` is an epoch (seconds) or null when there is no active plan.
+ * GET /v1/billing/subscription — the account's derived billing lifecycle,
+ * licensed vs. used seats, capacity blocks, live pool usage, and Identity
+ * attempts. Drives the subscription / usage view. `status` is the derived
+ * lifecycle label; `is_paying`/`is_entitled` are the booleans the UI gates on
+ * (paying vs merely entitled). `renewal_amount_usd` is a formatted dollars
+ * string; `renewal_date` is an epoch (seconds) or null when there is no plan.
  */
 export interface SparkVaultSubscription {
-    plan: 'subscription' | 'internal' | 'unsubscribed';
+    status: 'free' | 'customer' | 'churned' | 'suspended';
+    is_paying: boolean;
+    is_entitled: boolean;
     unlimited: boolean;
     subscription_status: string | null;
     past_due: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkvault/sdk-mobile",
-  "version": "4.3.2",
+  "version": "4.5.0",
   "description": "Mobile SDK for SparkVault Identity, vault, folder, and ingot workflows",
   "type": "module",
   "main": "./dist/index.js",

package/src/client.ts

@@ -6,8 +6,8 @@ import { MobileFoldersClient } from './folders.js';
 import { MobileHealthClient } from './health.js';
 import { MobileHttpClient, type AuthEventListener } from './http.js';
 import { MobileIngotsClient } from './ingots.js';
+import { MobileNotifyClient } from './notify.js';
 import { MobileProductsClient } from './products/index.js';
-import { MobilePushTokensClient } from './push-tokens.js';
 import { MobileSparksClient } from './sparks.js';
 import { MobileUsersClient } from './users.js';
 import { MobileVaultsClient } from './vaults.js';
@@ -22,7 +22,7 @@ export class SparkVaultMobile {
   readonly health: MobileHealthClient;
   readonly sparks: MobileSparksClient;
   readonly entropy: MobileEntropyClient;
-  readonly pushTokens: MobilePushTokensClient;
+  readonly notify: MobileNotifyClient;
   readonly billing: MobileBillingClient;
   readonly users: MobileUsersClient;
   private readonly http: MobileHttpClient;
@@ -38,7 +38,7 @@ export class SparkVaultMobile {
     this.health = new MobileHealthClient(this.config);
     this.sparks = new MobileSparksClient(this.http);
     this.entropy = new MobileEntropyClient(this.http);
-    this.pushTokens = new MobilePushTokensClient(this.http);
+    this.notify = new MobileNotifyClient(this.http);
     this.billing = new MobileBillingClient(this.http);
     this.users = new MobileUsersClient(this.http);
 

package/src/index.ts

@@ -65,11 +65,19 @@ export type {
   GenerateEntropyOptions,
 } from './entropy.js';
 export {
-  MobilePushTokensClient,
-} from './push-tokens.js';
+  MobileNotifyClient,
+} from './notify.js';
 export type {
-  RegisterPushTokenResponse,
-} from './push-tokens.js';
+  NotificationInboxState,
+  NotificationMarkState,
+  NotificationRow,
+  ListNotificationsOptions,
+  ListNotificationsResponse,
+  UnreadCountResponse,
+  MarkNotificationStateOptions,
+  MarkNotificationStateResponse,
+  RegisterDeviceResponse,
+} from './notify.js';
 export {
   MobileBillingClient,
 } from './billing.js';

package/src/notify.ts

@@ -0,0 +1,132 @@
+import type { MobileHttpClient } from './http.js';
+
+/** Inbox views the feed can be filtered to. `all` excludes archived rows. */
+export type NotificationInboxState = 'all' | 'unseen' | 'unread' | 'archived';
+
+/** Terminal display states the recipient can apply to one of their rows. */
+export type NotificationMarkState = 'seen' | 'read' | 'archived';
+
+/**
+ * A metadata-only inbox row. Rows are LOCKED pointers: the content lives behind
+ * the SparkLink (`sparklink_code`) and is never carried here — open the SparkLink
+ * to unseal it. Timestamps are epoch SECONDS.
+ */
+export interface NotificationRow {
+  notification_id: string;
+  send_id: string;
+  created_at: number;
+  title: string;
+  category: string;
+  type: string;
+  seen_at: number | null;
+  read_at: number | null;
+  archived_at: number | null;
+  sparklink_code: string;
+  locked: true;
+  thread_id?: string;
+}
+
+export interface ListNotificationsOptions {
+  state?: NotificationInboxState;
+  /** Page size, 1-100 (server default 50). */
+  limit?: number;
+  /** Opaque cursor from a prior response. */
+  cursor?: string;
+}
+
+export interface ListNotificationsResponse {
+  notifications: NotificationRow[];
+  /**
+   * Next-page cursor, or null on the last page. A page can be SHORT of `limit`
+   * yet still carry a non-null cursor (the state/sender filter is applied after
+   * the key query) — follow the cursor; never treat a short page as the end.
+   */
+  cursor: string | null;
+}
+
+export interface UnreadCountResponse {
+  unread_count: number;
+  /** True when the true count is at/beyond the badge ceiling (render "N+"). */
+  capped: boolean;
+}
+
+export interface MarkNotificationStateOptions {
+  /** The row's `created_at` (epoch seconds), round-tripped from the list row. Required. */
+  createdAt: number;
+  state: NotificationMarkState;
+}
+
+export interface MarkNotificationStateResponse {
+  notification_id: string;
+  state: NotificationMarkState;
+  updated_at: number;
+}
+
+/** Response to registering/refreshing this device's push token. */
+export interface RegisterDeviceResponse {
+  success: boolean;
+  created: boolean;
+  refreshed: boolean;
+}
+
+/**
+ * The signed-in user's first-party Notify surface: their own metadata-only inbox
+ * plus this device's push registration. The recipient is ALWAYS derived from the
+ * session on the server — no method takes a `recipient_id`, and any account/
+ * recipient a caller might try to supply is ignored.
+ */
+export class MobileNotifyClient {
+  private readonly http: MobileHttpClient;
+
+  constructor(http: MobileHttpClient) {
+    this.http = http;
+  }
+
+  /** The caller's own inbox feed (newest first). */
+  async getInbox(options: ListNotificationsOptions = {}): Promise<ListNotificationsResponse> {
+    const params = new URLSearchParams();
+    if (options.state) params.set('state', options.state);
+    if (options.limit) params.set('limit', String(options.limit));
+    if (options.cursor) params.set('cursor', options.cursor);
+
+    const query = params.toString();
+    const response = await this.http.get<ListNotificationsResponse>(
+      query ? `/me/notifications?${query}` : '/me/notifications'
+    );
+    return response.data;
+  }
+
+  /** Bounded unseen badge count for the caller's own inbox. */
+  async getUnreadCount(): Promise<UnreadCountResponse> {
+    const response = await this.http.get<UnreadCountResponse>('/me/notifications/unread-count');
+    return response.data;
+  }
+
+  /**
+   * Apply a terminal display state to one of the caller's own rows (idempotent).
+   * `createdAt` MUST be the row's own `created_at` — the id alone is insufficient.
+   */
+  async markState(
+    notificationId: string,
+    options: MarkNotificationStateOptions
+  ): Promise<MarkNotificationStateResponse> {
+    const response = await this.http.post<MarkNotificationStateResponse>(
+      `/me/notifications/${encodeURIComponent(notificationId)}/state`,
+      { created_at: options.createdAt, state: options.state }
+    );
+    return response.data;
+  }
+
+  /** Register/refresh this device's Expo push token under the session user. */
+  async registerDevice(pushToken: string): Promise<RegisterDeviceResponse> {
+    const response = await this.http.post<RegisterDeviceResponse>('/me/notifications/devices', {
+      push_token: pushToken,
+    });
+    return response.data;
+  }
+
+  /** Deregister a device token (logout / disable notifications). */
+  async unregisterDevice(tokenHash: string): Promise<void> {
+    await this.http.delete(`/me/notifications/devices/${encodeURIComponent(tokenHash)}`);
+  }
+}

package/src/types.ts

@@ -157,13 +157,17 @@ export interface SubscriptionIdentityStatus {
 }
 
 /**
- * GET /v1/billing/subscription — the account's current plan, licensed vs. used
- * seats, capacity blocks, live pool usage, and Identity attempts. Drives the
- * subscription / usage view. `renewal_amount_usd` is a formatted dollars string;
- * `renewal_date` is an epoch (seconds) or null when there is no active plan.
+ * GET /v1/billing/subscription — the account's derived billing lifecycle,
+ * licensed vs. used seats, capacity blocks, live pool usage, and Identity
+ * attempts. Drives the subscription / usage view. `status` is the derived
+ * lifecycle label; `is_paying`/`is_entitled` are the booleans the UI gates on
+ * (paying vs merely entitled). `renewal_amount_usd` is a formatted dollars
+ * string; `renewal_date` is an epoch (seconds) or null when there is no plan.
  */
 export interface SparkVaultSubscription {
-  plan: 'subscription' | 'internal' | 'unsubscribed';
+  status: 'free' | 'customer' | 'churned' | 'suspended';
+  is_paying: boolean;
+  is_entitled: boolean;
   unlimited: boolean;
   subscription_status: string | null;
   past_due: boolean;

package/dist/push-tokens.d.ts

@@ -1,12 +0,0 @@
-import type { MobileHttpClient } from './http.js';
-export interface RegisterPushTokenResponse {
-    success: boolean;
-    created: boolean;
-    refreshed: boolean;
-}
-export declare class MobilePushTokensClient {
-    private readonly http;
-    constructor(http: MobileHttpClient);
-    register(pushToken: string): Promise<RegisterPushTokenResponse>;
-    unregister(tokenHash: string): Promise<void>;
-}

package/dist/push-tokens.js

@@ -1,15 +0,0 @@
-export class MobilePushTokensClient {
-    constructor(http) {
-        this.http = http;
-    }
-    async register(pushToken) {
-        const response = await this.http.post('/push-tokens', {
-            push_token: pushToken,
-        });
-        return response.data;
-    }
-    async unregister(tokenHash) {
-        await this.http.delete(`/push-tokens/${encodeURIComponent(tokenHash)}`);
-    }
-}
-//# sourceMappingURL=push-tokens.js.map

package/dist/push-tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"push-tokens.js","sourceRoot":"","sources":["../src/push-tokens.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,sBAAsB;IAGjC,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAA4B,cAAc,EAAE;YAC/E,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/src/push-tokens.ts

@@ -1,26 +0,0 @@
-import type { MobileHttpClient } from './http.js';
-
-export interface RegisterPushTokenResponse {
-  success: boolean;
-  created: boolean;
-  refreshed: boolean;
-}
-
-export class MobilePushTokensClient {
-  private readonly http: MobileHttpClient;
-
-  constructor(http: MobileHttpClient) {
-    this.http = http;
-  }
-
-  async register(pushToken: string): Promise<RegisterPushTokenResponse> {
-    const response = await this.http.post<RegisterPushTokenResponse>('/push-tokens', {
-      push_token: pushToken,
-    });
-    return response.data;
-  }
-
-  async unregister(tokenHash: string): Promise<void> {
-    await this.http.delete(`/push-tokens/${encodeURIComponent(tokenHash)}`);
-  }
-}