@unisat/notification-service 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 UniSat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @unisat/notification-service
+
+Cross-platform notification management service for UniSat Wallet. Handles fetching, storing, reading, and deleting in-app notifications with local persistence and automatic cleanup.
+
+## Installation
+
+```bash
+pnpm add @unisat/notification-service
+```
+
+## Usage
+
+```ts
+import { NotificationService } from '@unisat/notification-service'
+
+const notificationService = new NotificationService()
+
+await notificationService.init({
+  storage, // ProxyStorageAdapter
+  api,     // WalletApiService
+  logger,  // optional Logger
+})
+```
+
+## API
+
+### `init(config)`
+
+Initializes the service and loads persisted notifications from storage.
+
+| Field     | Type                   | Required | Description              |
+| --------- | ---------------------- | -------- | ------------------------ |
+| `storage` | `ProxyStorageAdapter`  | Yes      | Storage adapter          |
+| `api`     | `WalletApiService`     | Yes      | API client               |
+| `logger`  | `Logger`               | No       | Custom logger            |
+
+### `getNotifications()`
+
+Fetches the latest notifications from the server, merges them with the local store, and returns a sorted list.
+
+- Sorted by `priority` desc, then `publishTime` desc
+- Caps the local store at **20 items** (lowest priority/oldest are dropped)
+- Automatically purges read notifications older than **7 days**
+- Falls back to the local store on network error
+
+```ts
+const notifications = await notificationService.getNotifications()
+// => StoredNotification[]
+```
+
+### `markAsRead(id)`
+
+Marks a notification as read on the server and records the read timestamp locally.
+
+```ts
+await notificationService.markAsRead('notification-id')
+```
+
+### `deleteNotification(id)`
+
+Deletes a notification locally. If it has not been read yet, it is first marked as read on the server.
+
+```ts
+await notificationService.deleteNotification('notification-id')
+```
+
+### `getUnreadCount()`
+
+Returns the number of unread notifications in the local store.
+
+```ts
+const count = notificationService.getUnreadCount()
+// => number
+```
+
+### `resetAllData()`
+
+Clears all notifications from both the local store and storage.
+
+```ts
+notificationService.resetAllData()
+```
+
+## Types
+
+```ts
+interface StoredNotification {
+  id: string
+  title: string
+  content: string
+  type: string
+  link?: string
+  priority: number
+  publishTime: number
+  readAt?: number  // timestamp when marked as read; undefined means unread
+}
+
+type NotificationStore = Record<string, StoredNotification>
+```

package/lib/index.d.mts

@@ -0,0 +1,27 @@
+import { WalletApiService } from '@unisat/wallet-api';
+import { StoredNotification, Logger } from '@unisat/wallet-shared';
+import { ProxyStorageAdapter } from '@unisat/wallet-storage';
+export { NotificationStore } from './types.mjs';
+
+interface NotificationServiceConfig {
+    storage?: ProxyStorageAdapter;
+    logger?: Logger;
+    api?: WalletApiService;
+}
+declare class NotificationService {
+    private storage;
+    private logger;
+    private storageKey;
+    private store;
+    private api;
+    constructor();
+    init(config: NotificationServiceConfig): Promise<void>;
+    resetAllData: () => void;
+    getNotifications: () => Promise<StoredNotification[]>;
+    markAsRead: (id: string) => Promise<void>;
+    readAll: () => Promise<void>;
+    deleteNotification: (id: string) => Promise<void>;
+    getUnreadCount: () => number;
+}
+
+export { NotificationService };

package/lib/index.d.ts

@@ -0,0 +1,27 @@
+import { WalletApiService } from '@unisat/wallet-api';
+import { StoredNotification, Logger } from '@unisat/wallet-shared';
+import { ProxyStorageAdapter } from '@unisat/wallet-storage';
+export { NotificationStore } from './types.js';
+
+interface NotificationServiceConfig {
+    storage?: ProxyStorageAdapter;
+    logger?: Logger;
+    api?: WalletApiService;
+}
+declare class NotificationService {
+    private storage;
+    private logger;
+    private storageKey;
+    private store;
+    private api;
+    constructor();
+    init(config: NotificationServiceConfig): Promise<void>;
+    resetAllData: () => void;
+    getNotifications: () => Promise<StoredNotification[]>;
+    markAsRead: (id: string) => Promise<void>;
+    readAll: () => Promise<void>;
+    deleteNotification: (id: string) => Promise<void>;
+    getUnreadCount: () => number;
+}
+
+export { NotificationService };

package/lib/index.js

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  NotificationService: () => NotificationService
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/notification-service.ts
+var MAX_NOTIFICATIONS = 20;
+var READ_EXPIRY_MS = 7 * 24 * 60 * 60 * 1e3;
+var defaultLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+var NotificationService = class {
+  constructor() {
+    this.storage = void 0;
+    this.logger = defaultLogger;
+    this.storageKey = "notifications";
+    this.store = {};
+    this.api = void 0;
+    this.resetAllData = () => {
+      this.storage.set(this.storageKey, {});
+      this.store = {};
+    };
+    // Fetch from server, merge into local store.
+    // Prune read+expired entries, then cap total at MAX_NOTIFICATIONS (keep highest priority / newest).
+    this.getNotifications = async () => {
+      try {
+        const res = await this.api.notification.getList();
+        for (const item of res.list) {
+          const existing = this.store[item.id];
+          this.store[item.id] = {
+            ...item,
+            // preserve readAt if already marked locally
+            readAt: existing?.readAt
+          };
+        }
+        const now = Date.now();
+        for (const id of Object.keys(this.store)) {
+          const entry = this.store[id];
+          if (entry.readAt !== void 0 && now - entry.readAt > READ_EXPIRY_MS) {
+            delete this.store[id];
+          }
+        }
+        const entries = Object.values(this.store);
+        if (entries.length > MAX_NOTIFICATIONS) {
+          entries.sort((a, b) => b.priority - a.priority || b.publishTime - a.publishTime);
+          const keep = entries.slice(0, MAX_NOTIFICATIONS);
+          const keepIds = new Set(keep.map((e) => e.id));
+          for (const id of Object.keys(this.store)) {
+            if (!keepIds.has(id)) {
+              delete this.store[id];
+            }
+          }
+        }
+        await this.storage.set(this.storageKey, this.store);
+      } catch (error) {
+        this.logger.error("Failed to fetch notifications from server:", error);
+      }
+      return Object.values(this.store).sort(
+        (a, b) => b.priority - a.priority || b.publishTime - a.publishTime
+      );
+    };
+    this.markAsRead = async (id) => {
+      if (!this.store[id])
+        return;
+      await this.api.notification.read(id);
+      this.store[id] = { ...this.store[id], readAt: Date.now() };
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.readAll = async () => {
+      const unreadIds = Object.values(this.store).filter((n) => n.readAt === void 0).map((n) => n.id);
+      await this.api.notification.readAll(unreadIds);
+      const now = Date.now();
+      for (const id of unreadIds) {
+        this.store[id] = { ...this.store[id], readAt: now };
+      }
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.deleteNotification = async (id) => {
+      if (!this.store[id])
+        return;
+      if (this.store[id].readAt === void 0) {
+        try {
+          await this.api.notification.read(id);
+        } catch (error) {
+          this.logger.warn("Failed to mark notification as read before deletion:", error);
+        }
+      }
+      delete this.store[id];
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.getUnreadCount = () => {
+      return Object.values(this.store).filter((n) => n.readAt === void 0).length;
+    };
+  }
+  async init(config) {
+    if (config.storage) {
+      this.storage = config.storage;
+    }
+    if (config.logger) {
+      this.logger = config.logger;
+    }
+    if (config.api) {
+      this.api = config.api;
+    }
+    this.logger.debug("Initializing notification service...");
+    try {
+      const storedData = await this.storage.get(this.storageKey);
+      this.store = storedData || {};
+      this.logger.debug("Notification service initialization completed");
+    } catch (error) {
+      this.logger.error("Notification service initialization failed:", error);
+      throw error;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NotificationService
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/notification-service.ts"],"sourcesContent":["export { NotificationService } from './notification-service'\nexport type { NotificationStore } from './types'\n","import { WalletApiService } from '@unisat/wallet-api'\nimport { Logger, StoredNotification } from '@unisat/wallet-shared'\nimport { ProxyStorageAdapter } from '@unisat/wallet-storage'\nimport { NotificationStore } from './types'\n\nconst MAX_NOTIFICATIONS = 20\n// Read notifications are deleted after 7 days\nconst READ_EXPIRY_MS = 7 * 24 * 60 * 60 * 1000\n\n// Default no-op logger\nconst defaultLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n}\n\nexport interface NotificationServiceConfig {\n  storage?: ProxyStorageAdapter\n  logger?: Logger\n  api?: WalletApiService\n}\n\nexport class NotificationService {\n  private storage: ProxyStorageAdapter = undefined as any\n  private logger: Logger = defaultLogger\n  private storageKey: string = 'notifications'\n  private store: NotificationStore = {}\n  private api: WalletApiService = undefined as any\n\n  constructor() {}\n\n  async init(config: NotificationServiceConfig): Promise<void> {\n    if (config.storage) {\n      this.storage = config.storage\n    }\n    if (config.logger) {\n      this.logger = config.logger\n    }\n    if (config.api) {\n      this.api = config.api\n    }\n\n    this.logger.debug('Initializing notification service...')\n\n    try {\n      const storedData = await this.storage.get(this.storageKey)\n      this.store = storedData || {}\n      this.logger.debug('Notification service initialization completed')\n    } catch (error) {\n      this.logger.error('Notification service initialization failed:', error)\n      throw error\n    }\n  }\n\n  resetAllData = () => {\n    this.storage.set(this.storageKey, {})\n    this.store = {}\n  }\n\n  // Fetch from server, merge into local store.\n  // Prune read+expired entries, then cap total at MAX_NOTIFICATIONS (keep highest priority / newest).\n  getNotifications = async (): Promise<StoredNotification[]> => {\n    try {\n      const res = await this.api.notification.getList()\n\n      // Merge server items into local store (server is source of truth for content)\n      for (const item of res.list) {\n        const existing = this.store[item.id]\n        this.store[item.id] = {\n          ...item,\n          // preserve readAt if already marked locally\n          readAt: existing?.readAt,\n        }\n      }\n\n      // Purge read entries that have expired\n      const now = Date.now()\n      for (const id of Object.keys(this.store)) {\n        const entry = this.store[id]\n        if (entry.readAt !== undefined && now - entry.readAt > READ_EXPIRY_MS) {\n          delete this.store[id]\n        }\n      }\n\n      // Cap at MAX_NOTIFICATIONS: sort by priority desc, then publishTime desc, keep first N\n      const entries = Object.values(this.store)\n      if (entries.length > MAX_NOTIFICATIONS) {\n        entries.sort((a, b) => b.priority - a.priority || b.publishTime - a.publishTime)\n        const keep = entries.slice(0, MAX_NOTIFICATIONS)\n        const keepIds = new Set(keep.map(e => e.id))\n        for (const id of Object.keys(this.store)) {\n          if (!keepIds.has(id)) {\n            delete this.store[id]\n          }\n        }\n      }\n\n      await this.storage.set(this.storageKey, this.store)\n    } catch (error) {\n      this.logger.error('Failed to fetch notifications from server:', error)\n      // Fall back to local store on network error\n    }\n\n    return Object.values(this.store).sort(\n      (a, b) => b.priority - a.priority || b.publishTime - a.publishTime\n    )\n  }\n\n  markAsRead = async (id: string): Promise<void> => {\n    if (!this.store[id]) return\n\n    await this.api.notification.read(id)\n\n    this.store[id] = { ...this.store[id], readAt: Date.now() }\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  readAll = async (): Promise<void> => {\n    const unreadIds = Object.values(this.store)\n      .filter(n => n.readAt === undefined)\n      .map(n => n.id)\n\n    await this.api.notification.readAll(unreadIds)\n    const now = Date.now()\n    for (const id of unreadIds) {\n      this.store[id] = { ...this.store[id], readAt: now }\n    }\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  deleteNotification = async (id: string): Promise<void> => {\n    if (!this.store[id]) return\n\n    // Mark as read on server before deleting locally if not already read\n    if (this.store[id].readAt === undefined) {\n      try {\n        await this.api.notification.read(id)\n      } catch (error) {\n        this.logger.warn('Failed to mark notification as read before deletion:', error)\n      }\n    }\n\n    delete this.store[id]\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  getUnreadCount = (): number => {\n    return Object.values(this.store).filter(n => n.readAt === undefined).length\n  }\n}\n"],"mappings":"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","names":[]}

package/lib/index.mjs

@@ -0,0 +1,121 @@
+// src/notification-service.ts
+var MAX_NOTIFICATIONS = 20;
+var READ_EXPIRY_MS = 7 * 24 * 60 * 60 * 1e3;
+var defaultLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+var NotificationService = class {
+  constructor() {
+    this.storage = void 0;
+    this.logger = defaultLogger;
+    this.storageKey = "notifications";
+    this.store = {};
+    this.api = void 0;
+    this.resetAllData = () => {
+      this.storage.set(this.storageKey, {});
+      this.store = {};
+    };
+    // Fetch from server, merge into local store.
+    // Prune read+expired entries, then cap total at MAX_NOTIFICATIONS (keep highest priority / newest).
+    this.getNotifications = async () => {
+      try {
+        const res = await this.api.notification.getList();
+        for (const item of res.list) {
+          const existing = this.store[item.id];
+          this.store[item.id] = {
+            ...item,
+            // preserve readAt if already marked locally
+            readAt: existing?.readAt
+          };
+        }
+        const now = Date.now();
+        for (const id of Object.keys(this.store)) {
+          const entry = this.store[id];
+          if (entry.readAt !== void 0 && now - entry.readAt > READ_EXPIRY_MS) {
+            delete this.store[id];
+          }
+        }
+        const entries = Object.values(this.store);
+        if (entries.length > MAX_NOTIFICATIONS) {
+          entries.sort((a, b) => b.priority - a.priority || b.publishTime - a.publishTime);
+          const keep = entries.slice(0, MAX_NOTIFICATIONS);
+          const keepIds = new Set(keep.map((e) => e.id));
+          for (const id of Object.keys(this.store)) {
+            if (!keepIds.has(id)) {
+              delete this.store[id];
+            }
+          }
+        }
+        await this.storage.set(this.storageKey, this.store);
+      } catch (error) {
+        this.logger.error("Failed to fetch notifications from server:", error);
+      }
+      return Object.values(this.store).sort(
+        (a, b) => b.priority - a.priority || b.publishTime - a.publishTime
+      );
+    };
+    this.markAsRead = async (id) => {
+      if (!this.store[id])
+        return;
+      await this.api.notification.read(id);
+      this.store[id] = { ...this.store[id], readAt: Date.now() };
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.readAll = async () => {
+      const unreadIds = Object.values(this.store).filter((n) => n.readAt === void 0).map((n) => n.id);
+      await this.api.notification.readAll(unreadIds);
+      const now = Date.now();
+      for (const id of unreadIds) {
+        this.store[id] = { ...this.store[id], readAt: now };
+      }
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.deleteNotification = async (id) => {
+      if (!this.store[id])
+        return;
+      if (this.store[id].readAt === void 0) {
+        try {
+          await this.api.notification.read(id);
+        } catch (error) {
+          this.logger.warn("Failed to mark notification as read before deletion:", error);
+        }
+      }
+      delete this.store[id];
+      await this.storage.set(this.storageKey, this.store);
+    };
+    this.getUnreadCount = () => {
+      return Object.values(this.store).filter((n) => n.readAt === void 0).length;
+    };
+  }
+  async init(config) {
+    if (config.storage) {
+      this.storage = config.storage;
+    }
+    if (config.logger) {
+      this.logger = config.logger;
+    }
+    if (config.api) {
+      this.api = config.api;
+    }
+    this.logger.debug("Initializing notification service...");
+    try {
+      const storedData = await this.storage.get(this.storageKey);
+      this.store = storedData || {};
+      this.logger.debug("Notification service initialization completed");
+    } catch (error) {
+      this.logger.error("Notification service initialization failed:", error);
+      throw error;
+    }
+  }
+};
+export {
+  NotificationService
+};
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/notification-service.ts"],"sourcesContent":["import { WalletApiService } from '@unisat/wallet-api'\nimport { Logger, StoredNotification } from '@unisat/wallet-shared'\nimport { ProxyStorageAdapter } from '@unisat/wallet-storage'\nimport { NotificationStore } from './types'\n\nconst MAX_NOTIFICATIONS = 20\n// Read notifications are deleted after 7 days\nconst READ_EXPIRY_MS = 7 * 24 * 60 * 60 * 1000\n\n// Default no-op logger\nconst defaultLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n}\n\nexport interface NotificationServiceConfig {\n  storage?: ProxyStorageAdapter\n  logger?: Logger\n  api?: WalletApiService\n}\n\nexport class NotificationService {\n  private storage: ProxyStorageAdapter = undefined as any\n  private logger: Logger = defaultLogger\n  private storageKey: string = 'notifications'\n  private store: NotificationStore = {}\n  private api: WalletApiService = undefined as any\n\n  constructor() {}\n\n  async init(config: NotificationServiceConfig): Promise<void> {\n    if (config.storage) {\n      this.storage = config.storage\n    }\n    if (config.logger) {\n      this.logger = config.logger\n    }\n    if (config.api) {\n      this.api = config.api\n    }\n\n    this.logger.debug('Initializing notification service...')\n\n    try {\n      const storedData = await this.storage.get(this.storageKey)\n      this.store = storedData || {}\n      this.logger.debug('Notification service initialization completed')\n    } catch (error) {\n      this.logger.error('Notification service initialization failed:', error)\n      throw error\n    }\n  }\n\n  resetAllData = () => {\n    this.storage.set(this.storageKey, {})\n    this.store = {}\n  }\n\n  // Fetch from server, merge into local store.\n  // Prune read+expired entries, then cap total at MAX_NOTIFICATIONS (keep highest priority / newest).\n  getNotifications = async (): Promise<StoredNotification[]> => {\n    try {\n      const res = await this.api.notification.getList()\n\n      // Merge server items into local store (server is source of truth for content)\n      for (const item of res.list) {\n        const existing = this.store[item.id]\n        this.store[item.id] = {\n          ...item,\n          // preserve readAt if already marked locally\n          readAt: existing?.readAt,\n        }\n      }\n\n      // Purge read entries that have expired\n      const now = Date.now()\n      for (const id of Object.keys(this.store)) {\n        const entry = this.store[id]\n        if (entry.readAt !== undefined && now - entry.readAt > READ_EXPIRY_MS) {\n          delete this.store[id]\n        }\n      }\n\n      // Cap at MAX_NOTIFICATIONS: sort by priority desc, then publishTime desc, keep first N\n      const entries = Object.values(this.store)\n      if (entries.length > MAX_NOTIFICATIONS) {\n        entries.sort((a, b) => b.priority - a.priority || b.publishTime - a.publishTime)\n        const keep = entries.slice(0, MAX_NOTIFICATIONS)\n        const keepIds = new Set(keep.map(e => e.id))\n        for (const id of Object.keys(this.store)) {\n          if (!keepIds.has(id)) {\n            delete this.store[id]\n          }\n        }\n      }\n\n      await this.storage.set(this.storageKey, this.store)\n    } catch (error) {\n      this.logger.error('Failed to fetch notifications from server:', error)\n      // Fall back to local store on network error\n    }\n\n    return Object.values(this.store).sort(\n      (a, b) => b.priority - a.priority || b.publishTime - a.publishTime\n    )\n  }\n\n  markAsRead = async (id: string): Promise<void> => {\n    if (!this.store[id]) return\n\n    await this.api.notification.read(id)\n\n    this.store[id] = { ...this.store[id], readAt: Date.now() }\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  readAll = async (): Promise<void> => {\n    const unreadIds = Object.values(this.store)\n      .filter(n => n.readAt === undefined)\n      .map(n => n.id)\n\n    await this.api.notification.readAll(unreadIds)\n    const now = Date.now()\n    for (const id of unreadIds) {\n      this.store[id] = { ...this.store[id], readAt: now }\n    }\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  deleteNotification = async (id: string): Promise<void> => {\n    if (!this.store[id]) return\n\n    // Mark as read on server before deleting locally if not already read\n    if (this.store[id].readAt === undefined) {\n      try {\n        await this.api.notification.read(id)\n      } catch (error) {\n        this.logger.warn('Failed to mark notification as read before deletion:', error)\n      }\n    }\n\n    delete this.store[id]\n    await this.storage.set(this.storageKey, this.store)\n  }\n\n  getUnreadCount = (): number => {\n    return Object.values(this.store).filter(n => n.readAt === undefined).length\n  }\n}\n"],"mappings":"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","names":[]}

package/lib/types.d.mts

@@ -0,0 +1,6 @@
+import { StoredNotification } from '@unisat/wallet-shared';
+export { NotificationListItem } from '@unisat/wallet-shared';
+
+type NotificationStore = Record<string, StoredNotification>;
+
+export { NotificationStore };

package/lib/types.d.ts

@@ -0,0 +1,6 @@
+import { StoredNotification } from '@unisat/wallet-shared';
+export { NotificationListItem } from '@unisat/wallet-shared';
+
+type NotificationStore = Record<string, StoredNotification>;
+
+export { NotificationStore };

package/lib/types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { StoredNotification } from '@unisat/wallet-shared'\n\nexport type { NotificationListItem } from '@unisat/wallet-shared'\n\nexport type NotificationStore = Record<string, StoredNotification>\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/lib/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/lib/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@unisat/notification-service",
+  "version": "1.1.1",
+  "description": "Cross-platform permission management service for web3 applications",
+  "main": "lib/index.js",
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/**/*",
+    "src/**/*",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "require": "./lib/index.js",
+      "import": "./lib/index.mjs"
+    },
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "require": "./lib/types.js",
+      "import": "./lib/types.mjs"
+    }
+  },
+  "keywords": [
+    "bitcoin",
+    "permission",
+    "web3",
+    "wallet",
+    "browser-extension",
+    "dapp",
+    "connected-sites"
+  ],
+  "author": "UniSat Team",
+  "license": "MIT",
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "@unisat/wallet-shared": "0.2.0",
+    "@unisat/wallet-storage": "0.2.1",
+    "@unisat/wallet-api": "1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^7.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^0.34.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { NotificationService } from './notification-service'
+export type { NotificationStore } from './types'

package/src/notification-service.ts

@@ -0,0 +1,151 @@
+import { WalletApiService } from '@unisat/wallet-api'
+import { Logger, StoredNotification } from '@unisat/wallet-shared'
+import { ProxyStorageAdapter } from '@unisat/wallet-storage'
+import { NotificationStore } from './types'
+
+const MAX_NOTIFICATIONS = 20
+// Read notifications are deleted after 7 days
+const READ_EXPIRY_MS = 7 * 24 * 60 * 60 * 1000
+
+// Default no-op logger
+const defaultLogger: Logger = {
+  debug: () => {},
+  info: () => {},
+  warn: () => {},
+  error: () => {},
+}
+
+export interface NotificationServiceConfig {
+  storage?: ProxyStorageAdapter
+  logger?: Logger
+  api?: WalletApiService
+}
+
+export class NotificationService {
+  private storage: ProxyStorageAdapter = undefined as any
+  private logger: Logger = defaultLogger
+  private storageKey: string = 'notifications'
+  private store: NotificationStore = {}
+  private api: WalletApiService = undefined as any
+
+  constructor() {}
+
+  async init(config: NotificationServiceConfig): Promise<void> {
+    if (config.storage) {
+      this.storage = config.storage
+    }
+    if (config.logger) {
+      this.logger = config.logger
+    }
+    if (config.api) {
+      this.api = config.api
+    }
+
+    this.logger.debug('Initializing notification service...')
+
+    try {
+      const storedData = await this.storage.get(this.storageKey)
+      this.store = storedData || {}
+      this.logger.debug('Notification service initialization completed')
+    } catch (error) {
+      this.logger.error('Notification service initialization failed:', error)
+      throw error
+    }
+  }
+
+  resetAllData = () => {
+    this.storage.set(this.storageKey, {})
+    this.store = {}
+  }
+
+  // Fetch from server, merge into local store.
+  // Prune read+expired entries, then cap total at MAX_NOTIFICATIONS (keep highest priority / newest).
+  getNotifications = async (): Promise<StoredNotification[]> => {
+    try {
+      const res = await this.api.notification.getList()
+
+      // Merge server items into local store (server is source of truth for content)
+      for (const item of res.list) {
+        const existing = this.store[item.id]
+        this.store[item.id] = {
+          ...item,
+          // preserve readAt if already marked locally
+          readAt: existing?.readAt,
+        }
+      }
+
+      // Purge read entries that have expired
+      const now = Date.now()
+      for (const id of Object.keys(this.store)) {
+        const entry = this.store[id]
+        if (entry.readAt !== undefined && now - entry.readAt > READ_EXPIRY_MS) {
+          delete this.store[id]
+        }
+      }
+
+      // Cap at MAX_NOTIFICATIONS: sort by priority desc, then publishTime desc, keep first N
+      const entries = Object.values(this.store)
+      if (entries.length > MAX_NOTIFICATIONS) {
+        entries.sort((a, b) => b.priority - a.priority || b.publishTime - a.publishTime)
+        const keep = entries.slice(0, MAX_NOTIFICATIONS)
+        const keepIds = new Set(keep.map(e => e.id))
+        for (const id of Object.keys(this.store)) {
+          if (!keepIds.has(id)) {
+            delete this.store[id]
+          }
+        }
+      }
+
+      await this.storage.set(this.storageKey, this.store)
+    } catch (error) {
+      this.logger.error('Failed to fetch notifications from server:', error)
+      // Fall back to local store on network error
+    }
+
+    return Object.values(this.store).sort(
+      (a, b) => b.priority - a.priority || b.publishTime - a.publishTime
+    )
+  }
+
+  markAsRead = async (id: string): Promise<void> => {
+    if (!this.store[id]) return
+
+    await this.api.notification.read(id)
+
+    this.store[id] = { ...this.store[id], readAt: Date.now() }
+    await this.storage.set(this.storageKey, this.store)
+  }
+
+  readAll = async (): Promise<void> => {
+    const unreadIds = Object.values(this.store)
+      .filter(n => n.readAt === undefined)
+      .map(n => n.id)
+
+    await this.api.notification.readAll(unreadIds)
+    const now = Date.now()
+    for (const id of unreadIds) {
+      this.store[id] = { ...this.store[id], readAt: now }
+    }
+    await this.storage.set(this.storageKey, this.store)
+  }
+
+  deleteNotification = async (id: string): Promise<void> => {
+    if (!this.store[id]) return
+
+    // Mark as read on server before deleting locally if not already read
+    if (this.store[id].readAt === undefined) {
+      try {
+        await this.api.notification.read(id)
+      } catch (error) {
+        this.logger.warn('Failed to mark notification as read before deletion:', error)
+      }
+    }
+
+    delete this.store[id]
+    await this.storage.set(this.storageKey, this.store)
+  }
+
+  getUnreadCount = (): number => {
+    return Object.values(this.store).filter(n => n.readAt === undefined).length
+  }
+}

package/src/types.ts

@@ -0,0 +1,5 @@
+import { StoredNotification } from '@unisat/wallet-shared'
+
+export type { NotificationListItem } from '@unisat/wallet-shared'
+
+export type NotificationStore = Record<string, StoredNotification>