@massalabs/gossip-sdk 0.0.2-dev.20260211110128 → 0.0.2-dev.20260211172752

package/README.md

@@ -47,9 +47,8 @@ await gossipSdk.openSession({
   mnemonic: 'word1 word2 word3 ... word12',
   // For existing session:
   encryptedSession: savedBlob,
-  encryptionKey: savedKey,
+  encryptionKey,
   // For persistence:
-  persistEncryptionKey: encryptionKey,
   onPersist: async (blob, key) => {
     await saveToStorage(blob, key);
   },
@@ -113,7 +112,7 @@ await gossipSdk.openSession({
 // With persistence (saves session on changes)
 await gossipSdk.openSession({
   mnemonic: 'word1 word2 word3 ... word12',
-  persistEncryptionKey: encryptionKey,
+  encryptionKey,
   onPersist: async (blob, key) => {
     await db.userProfile.update(userId, { session: blob });
   },
@@ -387,25 +386,16 @@ const decoded = utils.decodeUserId(encodedString);
 
 ## Session Persistence
 
-For restoring sessions across app restarts:
+For restoring sessions across app restarts, pass `encryptionKey` and `onPersist` when opening the session:
 
 ```typescript
-// Option 1: Provide persistence config in openSession
 await gossipSdk.openSession({
   mnemonic,
-  persistEncryptionKey: key,
+  encryptionKey,
   onPersist: async (blob, key) => {
-    // Save blob to your storage
     await db.userProfile.update(userId, { session: blob });
   },
 });
-
-// Option 2: Configure persistence after account creation
-await gossipSdk.openSession({ mnemonic });
-// ... create account, get encryption key ...
-gossipSdk.configurePersistence(encryptionKey, async (blob, key) => {
-  await db.userProfile.update(userId, { session: blob });
-});
 ```
 
 ## Auto-Renewal Behavior

package/dist/config/protocol.d.ts

@@ -23,7 +23,7 @@ export declare const defaultMessageProtocol: MessageProtocolType;
  *
  * @example
  * ```typescript
- * import { setProtocolBaseUrl } from 'gossip-sdk';
+ * import { setProtocolBaseUrl } from '@massalabs/gossip-sdk';
  *
  * // Set custom API endpoint
  * setProtocolBaseUrl('https://my-server.com/api');

package/dist/config/protocol.js

@@ -66,7 +66,7 @@ export const defaultMessageProtocol = MessageProtocolType.REST;
  *
  * @example
  * ```typescript
- * import { setProtocolBaseUrl } from 'gossip-sdk';
+ * import { setProtocolBaseUrl } from '@massalabs/gossip-sdk';
  *
  * // Set custom API endpoint
  * setProtocolBaseUrl('https://my-server.com/api');

package/dist/config/sdk.d.ts

@@ -43,6 +43,8 @@ export interface MessagesConfig {
      * resulting in message being re-sent on restart.
      */
     deduplicationWindowMs: number;
+    /** Delay before retrying a failed message send in ms (default: 5000 = 5 seconds) */
+    retryDelayMs: number;
 }
 /**
  * Announcement configuration
@@ -52,6 +54,8 @@ export interface AnnouncementsConfig {
     fetchLimit: number;
     /** Time before marking failed announcements as broken in ms (default: 3600000 = 1 hour) */
     brokenThresholdMs: number;
+    /** Delay before retrying a failed announcement send in ms (default: 15000 = 15 seconds) */
+    retryDelayMs: number;
 }
 /**
  * Complete SDK configuration

package/dist/config/sdk.js

@@ -16,16 +16,18 @@ export const defaultSdkConfig = {
         enabled: false,
         messagesIntervalMs: 5000,
         announcementsIntervalMs: 10000,
-        sessionRefreshIntervalMs: 30000,
+        sessionRefreshIntervalMs: 10000, //30000,
     },
     messages: {
         fetchDelayMs: 100,
         maxFetchIterations: 30,
         deduplicationWindowMs: 30000, // 30 seconds
+        retryDelayMs: 5000, // 5 seconds
     },
     announcements: {
         fetchLimit: 500,
         brokenThresholdMs: 60 * 60 * 1000, // 1 hour
+        retryDelayMs: 15000, // 15 seconds
     },
 };
 /**

package/dist/contacts.d.ts

@@ -5,7 +5,7 @@
  *
  * @example
  * ```typescript
- * import { getContacts, addContact, deleteContact } from 'gossip-sdk';
+ * import { getContacts, addContact, deleteContact } from '@massalabs/gossip-sdk';
  *
  * // Get all contacts
  * const contacts = await getContacts(userId);

package/dist/contacts.js

@@ -5,7 +5,7 @@
  *
  * @example
  * ```typescript
- * import { getContacts, addContact, deleteContact } from 'gossip-sdk';
+ * import { getContacts, addContact, deleteContact } from '@massalabs/gossip-sdk';
  *
  * // Get all contacts
  * const contacts = await getContacts(userId);

package/dist/core/SdkEventEmitter.d.ts

@@ -4,31 +4,40 @@
  * Type-safe event emitter for SDK events.
  */
 import type { Message, Discussion, Contact } from '../db';
-export type SdkEventType = 'message' | 'messageSent' | 'messageFailed' | 'discussionRequest' | 'discussionStatusChanged' | 'sessionBroken' | 'sessionRenewed' | 'error';
+export declare enum SdkEventType {
+    MESSAGE_RECEIVED = "messageReceived",
+    MESSAGE_SENT = "messageSent",
+    MESSAGE_FAILED = "messageFailed",
+    SESSION_REQUESTED = "sessionRequested",
+    SESSION_CREATED = "sessionCreated",
+    SESSION_RENEWED = "sessionRenewed",
+    SESSION_ACCEPTED = "sessionAccepted",
+    ERROR = "error"
+}
 export interface SdkEventHandlers {
-    message: (message: Message) => void;
-    messageSent: (message: Message) => void;
-    messageFailed: (message: Message, error: Error) => void;
-    discussionRequest: (discussion: Discussion, contact: Contact) => void;
-    discussionStatusChanged: (discussion: Discussion) => void;
-    sessionBroken: (discussion: Discussion) => void;
-    sessionRenewed: (discussion: Discussion) => void;
-    error: (error: Error, context: string) => void;
+    [SdkEventType.MESSAGE_RECEIVED]: (message: Message) => void;
+    [SdkEventType.MESSAGE_SENT]: (message: Message) => void;
+    [SdkEventType.MESSAGE_FAILED]: (message: Message, error: Error) => void;
+    [SdkEventType.SESSION_REQUESTED]: (discussion: Discussion, contact: Contact) => void;
+    [SdkEventType.SESSION_CREATED]: (discussion: Discussion) => void;
+    [SdkEventType.SESSION_RENEWED]: (discussion: Discussion) => void;
+    [SdkEventType.SESSION_ACCEPTED]: (contactUserId: string) => void;
+    [SdkEventType.ERROR]: (error: Error, context: string) => void;
 }
 export declare class SdkEventEmitter {
     private handlers;
     /**
      * Register an event handler
      */
-    on<K extends SdkEventType>(event: K, handler: SdkEventHandlers[K]): void;
+    on<K extends keyof SdkEventHandlers>(event: K, handler: SdkEventHandlers[K]): void;
     /**
      * Remove an event handler
      */
-    off<K extends SdkEventType>(event: K, handler: SdkEventHandlers[K]): void;
+    off<K extends keyof SdkEventHandlers>(event: K, handler: SdkEventHandlers[K]): void;
     /**
      * Emit an event to all registered handlers
      */
-    emit<K extends SdkEventType>(event: K, ...args: Parameters<SdkEventHandlers[K]>): void;
+    emit<K extends keyof SdkEventHandlers>(event: K, ...args: Parameters<SdkEventHandlers[K]>): void;
     /**
      * Remove all handlers for all events
      */

package/dist/core/SdkEventEmitter.js

@@ -4,6 +4,20 @@
  * Type-safe event emitter for SDK events.
  */
 // ─────────────────────────────────────────────────────────────────────────────
+// Event Types
+// ─────────────────────────────────────────────────────────────────────────────
+export var SdkEventType;
+(function (SdkEventType) {
+    SdkEventType["MESSAGE_RECEIVED"] = "messageReceived";
+    SdkEventType["MESSAGE_SENT"] = "messageSent";
+    SdkEventType["MESSAGE_FAILED"] = "messageFailed";
+    SdkEventType["SESSION_REQUESTED"] = "sessionRequested";
+    SdkEventType["SESSION_CREATED"] = "sessionCreated";
+    SdkEventType["SESSION_RENEWED"] = "sessionRenewed";
+    SdkEventType["SESSION_ACCEPTED"] = "sessionAccepted";
+    SdkEventType["ERROR"] = "error";
+})(SdkEventType || (SdkEventType = {}));
+// ─────────────────────────────────────────────────────────────────────────────
 // Event Emitter Class
 // ─────────────────────────────────────────────────────────────────────────────
 export class SdkEventEmitter {
@@ -13,14 +27,14 @@ export class SdkEventEmitter {
             configurable: true,
             writable: true,
             value: {
-                message: new Set(),
-                messageSent: new Set(),
-                messageFailed: new Set(),
-                discussionRequest: new Set(),
-                discussionStatusChanged: new Set(),
-                sessionBroken: new Set(),
-                sessionRenewed: new Set(),
-                error: new Set(),
+                [SdkEventType.MESSAGE_RECEIVED]: new Set(),
+                [SdkEventType.MESSAGE_SENT]: new Set(),
+                [SdkEventType.MESSAGE_FAILED]: new Set(),
+                [SdkEventType.SESSION_REQUESTED]: new Set(),
+                [SdkEventType.SESSION_CREATED]: new Set(),
+                [SdkEventType.SESSION_RENEWED]: new Set(),
+                [SdkEventType.SESSION_ACCEPTED]: new Set(),
+                [SdkEventType.ERROR]: new Set(),
             }
         });
     }

package/dist/core/SdkPolling.d.ts

@@ -5,6 +5,7 @@
  */
 import type { SdkConfig } from '../config/sdk';
 import type { Discussion } from '../db';
+import { SdkEventEmitter } from './SdkEventEmitter';
 export interface PollingCallbacks {
     /** Fetch messages from protocol */
     fetchMessages: () => Promise<void>;
@@ -14,16 +15,15 @@ export interface PollingCallbacks {
     handleSessionRefresh: (discussions: Discussion[]) => Promise<void>;
     /** Get active discussions for session refresh */
     getActiveDiscussions: () => Promise<Discussion[]>;
-    /** Called when a polling error occurs */
-    onError: (error: Error, context: string) => void;
 }
 export declare class SdkPolling {
     private timers;
     private callbacks;
+    private eventEmitter;
     /**
      * Start polling with the given configuration and callbacks.
      */
-    start(config: SdkConfig, callbacks: PollingCallbacks): void;
+    start(config: SdkConfig, callbacks: PollingCallbacks, eventEmitter: SdkEventEmitter): void;
     /**
      * Stop all polling timers.
      */

package/dist/core/SdkPolling.js

@@ -3,6 +3,7 @@
  *
  * Manages polling timers for messages, announcements, and session refresh.
  */
+import { SdkEventType } from './SdkEventEmitter';
 // ─────────────────────────────────────────────────────────────────────────────
 // Polling Manager Class
 // ─────────────────────────────────────────────────────────────────────────────
@@ -24,14 +25,21 @@ export class SdkPolling {
             writable: true,
             value: null
         });
+        Object.defineProperty(this, "eventEmitter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
     }
     /**
      * Start polling with the given configuration and callbacks.
      */
-    start(config, callbacks) {
+    start(config, callbacks, eventEmitter) {
         // Stop any existing timers first
         this.stop();
         this.callbacks = callbacks;
+        this.eventEmitter = eventEmitter;
         console.log('[SdkPolling] Starting polling', {
             messagesIntervalMs: config.polling.messagesIntervalMs,
             announcementsIntervalMs: config.polling.announcementsIntervalMs,
@@ -43,8 +51,8 @@ export class SdkPolling {
                 await this.callbacks?.fetchMessages();
             }
             catch (error) {
-                console.error('[SdkPolling] Message polling error:', error);
-                this.callbacks?.onError(error instanceof Error ? error : new Error(String(error)), 'message_polling');
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.eventEmitter?.emit(SdkEventType.ERROR, err, 'message_polling');
             }
         }, config.polling.messagesIntervalMs);
         // Start announcement polling
@@ -53,8 +61,8 @@ export class SdkPolling {
                 await this.callbacks?.fetchAnnouncements();
             }
             catch (error) {
-                console.error('[SdkPolling] Announcement polling error:', error);
-                this.callbacks?.onError(error instanceof Error ? error : new Error(String(error)), 'announcement_polling');
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.eventEmitter?.emit(SdkEventType.ERROR, err, 'announcement_polling');
             }
         }, config.polling.announcementsIntervalMs);
         // Start session refresh polling
@@ -66,8 +74,8 @@ export class SdkPolling {
                 }
             }
             catch (error) {
-                console.error('[SdkPolling] Session refresh polling error:', error);
-                this.callbacks?.onError(error instanceof Error ? error : new Error(String(error)), 'session_refresh_polling');
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.eventEmitter?.emit(SdkEventType.ERROR, err, 'session_update');
             }
         }, config.polling.sessionRefreshIntervalMs);
     }
@@ -88,6 +96,7 @@ export class SdkPolling {
             this.timers.sessionRefresh = null;
         }
         this.callbacks = null;
+        this.eventEmitter = null;
     }
     /**
      * Check if polling is currently running.

package/dist/db.d.ts

@@ -23,6 +23,8 @@ export interface Message {
     contactUserId: string;
     content: string;
     serializedContent?: Uint8Array;
+    encryptedMessage?: Uint8Array;
+    whenToSend?: Date;
     type: MessageType;
     direction: MessageDirection;
     status: MessageStatus;
@@ -37,7 +39,6 @@ export interface Message {
         originalContent?: string;
         originalSeeker: Uint8Array;
     };
-    encryptedMessage?: Uint8Array;
 }
 export interface UserProfile {
     userId: string;
@@ -65,13 +66,9 @@ export interface UserProfile {
     lastPublicKeyPush?: Date;
     lastBulletinCounter?: string;
 }
-export declare enum DiscussionStatus {
-    PENDING = "pending",
-    ACTIVE = "active",
-    CLOSED = "closed",// closed by the user
-    BROKEN = "broken",// The session is killed. Need to be reinitiated
-    SEND_FAILED = "sendFailed",// The discussion was initiated by the session manager but could not be broadcasted on network
-    RECONNECTING = "reconnecting"
+export declare enum DiscussionDirection {
+    RECEIVED = "received",
+    INITIATED = "initiated"
 }
 export declare enum MessageDirection {
     INCOMING = "incoming",
@@ -79,35 +76,35 @@ export declare enum MessageDirection {
 }
 export declare enum MessageStatus {
     WAITING_SESSION = "waiting_session",// Waiting for active session with peer
-    SENDING = "sending",
+    READY = "ready",
     SENT = "sent",
     DELIVERED = "delivered",
-    READ = "read",
-    FAILED = "failed"
-}
-export declare enum DiscussionDirection {
-    INITIATED = "initiated",
-    RECEIVED = "received"
+    READ = "read"
 }
 export declare enum MessageType {
     TEXT = "text",
+    ANNOUNCEMENT = "announcement",
     KEEP_ALIVE = "keep_alive",
     IMAGE = "image",
     FILE = "file",
     AUDIO = "audio",
     VIDEO = "video"
 }
+export interface readyAnnouncement {
+    announcement_bytes: Uint8Array;
+    when_to_send: Date;
+}
+export type SendAnnouncement = null | readyAnnouncement;
 export interface Discussion {
     id?: number;
     ownerUserId: string;
     contactUserId: string;
+    weAccepted: boolean;
+    sendAnnouncement: SendAnnouncement;
     direction: DiscussionDirection;
-    status: DiscussionStatus;
-    nextSeeker?: Uint8Array;
-    initiationAnnouncement?: Uint8Array;
-    announcementMessage?: string;
     lastSyncTimestamp?: Date;
     customName?: string;
+    lastAnnouncementMessage?: string;
     lastMessageId?: number;
     lastMessageContent?: string;
     lastMessageTimestamp?: Date;
@@ -147,11 +144,6 @@ export declare class GossipDatabase extends Dexie {
     getDiscussionsByOwner(ownerUserId: string): Promise<Discussion[]>;
     getUnreadCountByOwner(ownerUserId: string): Promise<number>;
     getDiscussionByOwnerAndContact(ownerUserId: string, contactUserId: string): Promise<Discussion | undefined>;
-    /**
-     * Get all active discussions with their sync status
-     * @returns Array of active discussions
-     */
-    getActiveDiscussionsByOwner(ownerUserId: string): Promise<Discussion[]>;
     markMessagesAsRead(ownerUserId: string, contactUserId: string): Promise<void>;
     getMessagesForContactByOwner(ownerUserId: string, contactUserId: string, limit?: number): Promise<Message[]>;
     addMessage(message: Omit<Message, 'id'>): Promise<number>;

package/dist/db.js

@@ -5,16 +5,11 @@
  * Provides tables for contacts, messages, discussions, user profiles, and more.
  */
 import Dexie from 'dexie';
-// Unified discussion interface combining protocol state and UI metadata
-export var DiscussionStatus;
-(function (DiscussionStatus) {
-    DiscussionStatus["PENDING"] = "pending";
-    DiscussionStatus["ACTIVE"] = "active";
-    DiscussionStatus["CLOSED"] = "closed";
-    DiscussionStatus["BROKEN"] = "broken";
-    DiscussionStatus["SEND_FAILED"] = "sendFailed";
-    DiscussionStatus["RECONNECTING"] = "reconnecting";
-})(DiscussionStatus || (DiscussionStatus = {}));
+export var DiscussionDirection;
+(function (DiscussionDirection) {
+    DiscussionDirection["RECEIVED"] = "received";
+    DiscussionDirection["INITIATED"] = "initiated";
+})(DiscussionDirection || (DiscussionDirection = {}));
 export var MessageDirection;
 (function (MessageDirection) {
     MessageDirection["INCOMING"] = "incoming";
@@ -23,20 +18,15 @@ export var MessageDirection;
 export var MessageStatus;
 (function (MessageStatus) {
     MessageStatus["WAITING_SESSION"] = "waiting_session";
-    MessageStatus["SENDING"] = "sending";
+    MessageStatus["READY"] = "ready";
     MessageStatus["SENT"] = "sent";
     MessageStatus["DELIVERED"] = "delivered";
     MessageStatus["READ"] = "read";
-    MessageStatus["FAILED"] = "failed";
 })(MessageStatus || (MessageStatus = {}));
-export var DiscussionDirection;
-(function (DiscussionDirection) {
-    DiscussionDirection["INITIATED"] = "initiated";
-    DiscussionDirection["RECEIVED"] = "received";
-})(DiscussionDirection || (DiscussionDirection = {}));
 export var MessageType;
 (function (MessageType) {
     MessageType["TEXT"] = "text";
+    MessageType["ANNOUNCEMENT"] = "announcement";
     MessageType["KEEP_ALIVE"] = "keep_alive";
     MessageType["IMAGE"] = "image";
     MessageType["FILE"] = "file";
@@ -165,16 +155,6 @@ export class GossipDatabase extends Dexie {
             .equals([ownerUserId, contactUserId])
             .first();
     }
-    /**
-     * Get all active discussions with their sync status
-     * @returns Array of active discussions
-     */
-    async getActiveDiscussionsByOwner(ownerUserId) {
-        return await this.discussions
-            .where('[ownerUserId+status]')
-            .equals([ownerUserId, DiscussionStatus.ACTIVE])
-            .toArray();
-    }
     async markMessagesAsRead(ownerUserId, contactUserId) {
         await this.messages
             .where('[ownerUserId+contactUserId+status]')
@@ -216,16 +196,10 @@ export class GossipDatabase extends Dexie {
             await this.discussions.put({
                 ownerUserId: message.ownerUserId,
                 contactUserId: message.contactUserId,
-                direction: message.direction === MessageDirection.INCOMING
-                    ? DiscussionDirection.RECEIVED
-                    : DiscussionDirection.INITIATED,
-                status: DiscussionStatus.PENDING,
-                nextSeeker: undefined,
                 lastMessageId: messageId,
                 lastMessageContent: message.content,
                 lastMessageTimestamp: message.timestamp,
                 unreadCount: message.direction === MessageDirection.INCOMING ? 1 : 0,
-                createdAt: new Date(),
                 updatedAt: new Date(),
             });
         }
@@ -274,12 +248,15 @@ export class GossipDatabase extends Dexie {
 // Database instance - initialized lazily or via setDb()
 let _db = null;
 let _warnedGlobalDbAccess = false;
+// Store a reference to the Proxy to detect it
+let _proxyDb = null;
 /**
  * Get the database instance.
  * Creates a default instance if none was set via setDb().
  */
 export function getDb() {
-    if (!_db) {
+    // Prevent infinite recursion: if _db is the Proxy itself or not a real instance, create a new instance
+    if (!_db || _db === _proxyDb || !(_db instanceof GossipDatabase)) {
         _db = new GossipDatabase();
     }
     return _db;
@@ -289,13 +266,24 @@ export function getDb() {
  * Call this before using any SDK functions if you need a custom db instance.
  */
 export function setDb(database) {
-    _db = database;
+    // Prevent setting the Proxy itself to avoid infinite recursion
+    // The Proxy is not an instance of GossipDatabase, so we can detect it that way
+    if (!(database instanceof GossipDatabase) || database === _proxyDb) {
+        // If Proxy is passed, ensure _db exists by calling getDb()
+        // This will reuse existing _db if it was already created (e.g., by db.open())
+        // or create a new one if needed. This ensures we always use the same instance.
+        getDb();
+        // Don't overwrite _db - just ensure it exists and is consistent
+    }
+    else {
+        _db = database;
+    }
 }
 /**
  * Get the database instance.
  * Creates a default instance if none was set via setDb().
  */
-export const db = new Proxy({}, {
+export const db = (_proxyDb = new Proxy({}, {
     get(_target, prop) {
         if (!_warnedGlobalDbAccess) {
             _warnedGlobalDbAccess = true;
@@ -308,4 +296,4 @@ export const db = new Proxy({}, {
         }
         return value;
     },
-});
+}));