@massalabs/gossip-sdk 0.0.2-dev.20260220052333 → 0.0.2-dev.20260220053835

package/dist/db.js

@@ -1,12 +1,21 @@
 /**
- * Gossip Database
+ * Gossip Database Types
  *
- * IndexedDB database implementation using Dexie for the Gossip messenger.
- * Provides tables for contacts, messages, discussions, user profiles, and more.
+ * Type definitions for the Gossip messenger data models.
+ * Database operations use SQLite via Drizzle ORM (see sqlite.ts and schema.ts).
  */
-import Dexie from 'dexie';
 // Constants
 export const MESSAGE_ID_SIZE = 12;
+// 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";
@@ -21,9 +30,11 @@ export var MessageStatus;
 (function (MessageStatus) {
     MessageStatus["WAITING_SESSION"] = "waiting_session";
     MessageStatus["READY"] = "ready";
+    MessageStatus["SENDING"] = "sending";
     MessageStatus["SENT"] = "sent";
     MessageStatus["DELIVERED"] = "delivered";
     MessageStatus["READ"] = "read";
+    MessageStatus["FAILED"] = "failed";
 })(MessageStatus || (MessageStatus = {}));
 export var MessageType;
 (function (MessageType) {
@@ -35,230 +46,29 @@ export var MessageType;
     MessageType["AUDIO"] = "audio";
     MessageType["VIDEO"] = "video";
 })(MessageType || (MessageType = {}));
-// Define the database class
-export class GossipDatabase extends Dexie {
-    constructor() {
-        super('GossipDatabase');
-        // Define tables
-        Object.defineProperty(this, "contacts", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "messages", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "userProfile", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "discussions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "pendingEncryptedMessages", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "pendingAnnouncements", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "activeSeekers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.version(13).stores({
-            contacts: '++id, ownerUserId, userId, name, isOnline, lastSeen, createdAt, [ownerUserId+userId] , [ownerUserId+name]',
-            messages: '++id, ownerUserId, contactUserId, type, direction, status, timestamp, seeker, [ownerUserId+contactUserId], [ownerUserId+status], [ownerUserId+contactUserId+status], [ownerUserId+seeker], [ownerUserId+contactUserId+direction], [ownerUserId+direction+status]',
-            userProfile: 'userId, username, status, lastSeen',
-            discussions: '++id, ownerUserId, &[ownerUserId+contactUserId], status, [ownerUserId+status], lastSyncTimestamp, unreadCount, lastMessageTimestamp, createdAt, updatedAt',
-            pendingEncryptedMessages: '++id, fetchedAt, seeker',
-            pendingAnnouncements: '++id, fetchedAt, &announcement',
-            activeSeekers: '++id, seeker',
-        });
-        // Add hooks for automatic timestamps
-        this.contacts.hook('creating', function (_primKey, obj, _trans) {
-            obj.createdAt = new Date();
-        });
-        this.userProfile.hook('creating', function (_primKey, obj, _trans) {
-            obj.createdAt = new Date();
-            obj.updatedAt = new Date();
-        });
-        this.userProfile.hook('updating', function (modifications, _primKey, _obj, _trans) {
-            modifications.updatedAt = new Date();
-        });
-        this.discussions.hook('creating', function (_primKey, obj, _trans) {
-            obj.createdAt = new Date();
-            obj.updatedAt = new Date();
-        });
-        this.discussions.hook('updating', function (modifications, _primKey, _obj, _trans) {
-            modifications.updatedAt = new Date();
-        });
-    }
-    // Helper methods for common operations
-    /** CONTACTS */
-    async getContactsByOwner(ownerUserId) {
-        return await this.contacts
-            .where('ownerUserId')
-            .equals(ownerUserId)
-            .toArray();
-    }
-    async getContactByOwnerAndUserId(ownerUserId, userId) {
-        return await this.contacts
-            .where('[ownerUserId+userId]')
-            .equals([ownerUserId, userId])
-            .first();
-    }
-    /** DISCUSSIONS */
-    async getDiscussionsByOwner(ownerUserId) {
-        const all = await this.discussions
-            .where('ownerUserId')
-            .equals(ownerUserId)
-            .toArray();
-        return all.sort((a, b) => {
-            if (a.lastMessageTimestamp && b.lastMessageTimestamp) {
-                return (b.lastMessageTimestamp.getTime() - a.lastMessageTimestamp.getTime());
-            }
-            if (a.lastMessageTimestamp)
-                return -1;
-            if (b.lastMessageTimestamp)
-                return 1;
-            return b.createdAt.getTime() - a.createdAt.getTime();
-        });
-    }
-    async getUnreadCountByOwner(ownerUserId) {
-        const discussions = await this.discussions
-            .where('ownerUserId')
-            .equals(ownerUserId)
-            .toArray();
-        return discussions.reduce((total, d) => total + d.unreadCount, 0);
-    }
-    async getDiscussionByOwnerAndContact(ownerUserId, contactUserId) {
-        if (!ownerUserId || !contactUserId) {
-            return undefined;
-        }
-        return await this.discussions
-            .where('[ownerUserId+contactUserId]')
-            .equals([ownerUserId, contactUserId])
-            .first();
-    }
-    async markMessagesAsRead(ownerUserId, contactUserId) {
-        await this.messages
-            .where('[ownerUserId+contactUserId+status]')
-            .equals([ownerUserId, contactUserId, MessageStatus.DELIVERED])
-            .and(msg => msg.direction === MessageDirection.INCOMING)
-            .modify({ status: MessageStatus.READ });
-        await this.discussions
-            .where('[ownerUserId+contactUserId]')
-            .equals([ownerUserId, contactUserId])
-            .modify({ unreadCount: 0 });
-    }
-    async getMessagesForContactByOwner(ownerUserId, contactUserId, limit = 50) {
-        return await this.messages
-            .where('[ownerUserId+contactUserId]')
-            .equals([ownerUserId, contactUserId])
-            .reverse()
-            .limit(limit)
-            .toArray();
-    }
-    async addMessage(message) {
-        const messageId = await this.messages.add(message);
-        // Get existing discussion
-        const discussion = await this.getDiscussionByOwnerAndContact(message.ownerUserId, message.contactUserId);
-        if (discussion) {
-            await this.discussions.update(discussion.id, {
-                lastMessageId: messageId,
-                lastMessageContent: message.content,
-                lastMessageTimestamp: message.timestamp,
-                unreadCount: message.direction === MessageDirection.INCOMING &&
-                    ![MessageType.ANNOUNCEMENT, MessageType.KEEP_ALIVE].includes(message.type)
-                    ? discussion.unreadCount + 1
-                    : discussion.unreadCount,
-                updatedAt: new Date(),
-            });
-        }
-        else {
-            // Note: For new messages, a discussion should already exist from the protocol
-            // If not, we'll create a minimal one (this shouldn't normally happen)
-            console.log('Warning: Creating discussion for contact without protocol setup:', message.contactUserId);
-            await this.discussions.put({
-                ownerUserId: message.ownerUserId,
-                contactUserId: message.contactUserId,
-                lastMessageId: messageId,
-                lastMessageContent: message.content,
-                lastMessageTimestamp: message.timestamp,
-                unreadCount: message.direction === MessageDirection.INCOMING &&
-                    ![MessageType.ANNOUNCEMENT, MessageType.KEEP_ALIVE].includes(message.type)
-                    ? 1
-                    : 0,
-                updatedAt: new Date(),
-            });
-        }
-        return messageId;
-    }
-    /**
-     * Update the last sync timestamp for a discussion
-     * @param discussionId - The discussion ID
-     * @param timestamp - The sync timestamp
-     */
-    async updateLastSyncTimestamp(discussionId, timestamp) {
-        await this.discussions.update(discussionId, {
-            lastSyncTimestamp: timestamp,
-            updatedAt: new Date(),
-        });
-    }
-    async deleteDb() {
-        await this.close();
-        await this.delete();
-    }
-    /**
-     * Set all active seekers, replacing any existing ones
-     * @param seekers - Array of seeker Uint8Arrays to store
-     */
-    async setActiveSeekers(seekers) {
-        await this.transaction('rw', this.activeSeekers, async () => {
-            // Clear all existing seekers
-            await this.activeSeekers.clear();
-            // Bulk add all new seekers
-            if (seekers.length > 0) {
-                await this.activeSeekers.bulkAdd(seekers.map(seeker => ({
-                    seeker,
-                })));
-            }
-        });
-    }
-    /**
-     * Get all active seekers from the database
-     * @returns Array of seeker Uint8Arrays
-     */
-    async getActiveSeekers() {
-        const activeSeekers = await this.activeSeekers.toArray();
-        return activeSeekers.map(item => item.seeker);
-    }
+/** Serialize a SendAnnouncement to a JSON string for SQLite text column */
+export function serializeSendAnnouncement(announcement) {
+    return JSON.stringify({
+        announcement_bytes: Array.from(announcement.announcement_bytes),
+        when_to_send: announcement.when_to_send.toISOString(),
+    });
 }
-// Database instance - lazily initialized singleton
-let _db = null;
-/**
- * Get the database instance. Creates a default instance on first call.
- */
-export function gossipDb() {
-    if (!_db || !(_db instanceof GossipDatabase)) {
-        _db = new GossipDatabase();
-    }
-    return _db;
+/** Deserialize a SendAnnouncement JSON string from SQLite back to an object */
+export function deserializeSendAnnouncement(json) {
+    const parsed = JSON.parse(json);
+    return {
+        announcement_bytes: new Uint8Array(parsed.announcement_bytes),
+        when_to_send: new Date(parsed.when_to_send),
+    };
+}
+/** Convert a raw SQLite discussion row to a Discussion object.
+ *  Deserializes sendAnnouncement from JSON text to SendAnnouncement. */
+export function rowToDiscussion(row) {
+    return {
+        ...row,
+        sendAnnouncement: typeof row.sendAnnouncement === 'string'
+            ? deserializeSendAnnouncement(row.sendAnnouncement)
+            : null,
+        lastAnnouncementMessage: row.announcementMessage ?? undefined,
+    };
 }

package/dist/gossip.d.ts

@@ -1,25 +1,24 @@
 /**
- * GossipSdk
+ * GossipSdk - Singleton SDK with clean lifecycle API
  *
  * @example
  * ```typescript
- * import { createGossipSdk } from '@massalabs/gossip-sdk';
- *
- * const sdk = createGossipSdk();
+ * import { gossipSdk } from '@massalabs/gossip-sdk';
  *
  * // Initialize once at app startup
- * await sdk.init({
+ * await gossipSdk.init({
+ *   db,
  *   protocolBaseUrl: 'https://api.example.com',
  * });
  *
  * // Open session (login) - SDK handles keys/session internally
- * await sdk.openSession({
+ * await gossipSdk.openSession({
  *   mnemonic: 'word1 word2 ...',
  *   onPersist: async (blob) => { /* save to db *\/ },
  * });
  *
  * // Or restore existing session
- * await sdk.openSession({
+ * await gossipSdk.openSession({
  *   mnemonic: 'word1 word2 ...',
  *   encryptedSession: savedBlob,
  *   encryptionKey: key,
@@ -27,28 +26,29 @@
  * });
  *
  * // Use clean API
- * await sdk.messages.send(contactId, 'Hello!');
- * await sdk.discussions.start(contact);
- * const contacts = await sdk.contacts.list(ownerUserId);
+ * await gossipSdk.messages.send(contactId, 'Hello!');
+ * await gossipSdk.discussions.start(contact);
+ * const contacts = await gossipSdk.contacts.list(ownerUserId);
  *
  * // Events
- * sdk.on('message', (msg) => { ... });
- * sdk.on('discussionRequest', (discussion, contact) => { ... });
+ * gossipSdk.on('message', (msg) => { ... });
+ * gossipSdk.on('discussionRequest', (discussion, contact) => { ... });
  *
  * // Logout
- * await sdk.closeSession();
+ * await gossipSdk.closeSession();
  * ```
  */
-import { type Contact, type Discussion, type Message, type GossipDatabase } from './db';
+import { type Contact, type Discussion, type Message } from './db';
 import { type SdkConfig, type DeepPartial } from './config/sdk';
+import { SessionStatus, SessionConfig } from './assets/generated/wasm/gossip_wasm';
 import { EncryptionKey } from './wasm/encryption';
 import { type AnnouncementReceptionResult } from './services/announcement';
-import { discussionInitializationResult } from './services/discussion';
+import { DiscussionInitializationResult } from './services/discussion';
 import { type MessageResult, type SendMessageResult } from './services/message';
 import { AuthService } from './services/auth';
 import type { DeleteContactResult, UpdateContactNameResult } from './utils/contacts';
 import { type ValidationResult } from './utils/validation';
-import { type UserPublicKeys, SessionStatus, SessionConfig } from './wasm/bindings';
+import type { UserPublicKeys } from './wasm/bindings';
 import { SdkEventType, type SdkEventHandlers } from './core/SdkEventEmitter';
 import { AnnouncementPayload } from './utils/announcementPayload';
 import { Result } from './utils/type';
@@ -64,16 +64,26 @@ export interface GossipSdkInitOptions {
     protocolBaseUrl?: string;
     /** SDK configuration (optional - uses defaults if not provided) */
     config?: DeepPartial<SdkConfig>;
+    /** URL to wa-sqlite.wasm (for bundlers that rewrite asset paths) */
+    wasmUrl?: string;
+    /**
+     * OPFS directory path for persistent SQLite storage.
+     * When set, data persists across page reloads via OPFS.
+     * When omitted, uses an in-memory database (data lost on reload).
+     */
+    opfsPath?: string;
 }
 export interface OpenSessionOptions {
     /** BIP39 mnemonic phrase */
     mnemonic: string;
     /** Existing encrypted session blob (for restoring session) */
     encryptedSession?: Uint8Array;
-    /** Encryption key for decrypting session and storage. Will be created if not provided. */
+    /** Encryption key for decrypting session */
     encryptionKey?: EncryptionKey;
     /** Callback when session state changes (for persistence) */
     onPersist?: (encryptedBlob: Uint8Array, encryptionKey: EncryptionKey) => Promise<void>;
+    /** Encryption key for persisting session (required if onPersist is provided) */
+    persistEncryptionKey?: EncryptionKey;
     /** Custom session configuration (optional, uses defaults if not provided) */
     sessionConfig?: SessionConfig;
 }
@@ -94,7 +104,7 @@ declare class GossipSdk {
     /**
      * Initialize the SDK. Call once at app startup.
      */
-    init(options?: GossipSdkInitOptions): Promise<void>;
+    init(options: GossipSdkInitOptions): Promise<void>;
     /**
      * Open a session (login).
      * Generates keys from mnemonic and initializes session.
@@ -123,7 +133,15 @@ declare class GossipSdk {
      * Get encrypted session blob for persistence.
      * Throws if no session is open.
      */
-    getEncryptedSession(): Uint8Array;
+    getEncryptedSession(encryptionKey: EncryptionKey): Uint8Array;
+    /**
+     * Configure session persistence after session is opened.
+     * Use this when you need to set up persistence after account creation.
+     *
+     * @param encryptionKey - Key to encrypt session blob
+     * @param onPersist - Callback to save encrypted session blob
+     */
+    configurePersistence(encryptionKey: EncryptionKey, onPersist: (encryptedBlob: Uint8Array, encryptionKey: EncryptionKey) => Promise<void>): void;
     /** Auth service (available after init, before session) */
     get auth(): AuthService;
     /** Message service */
@@ -134,7 +152,6 @@ declare class GossipSdk {
     get announcements(): AnnouncementServiceAPI;
     /** Contact management */
     get contacts(): ContactsAPI;
-    get db(): GossipDatabase;
     /**
      * Update state for all discussions:
      * - Cleanup orphaned peers
@@ -164,6 +181,20 @@ declare class GossipSdk {
     off<K extends SdkEventType>(event: K, handler: SdkEventHandlers[K]): void;
     private requireSession;
     private handleSessionPersist;
+    /**
+     * Reset messages stuck in SENDING status to WAITING_SESSION.
+     *
+     * Per spec: SENDING is a transient state that should never be persisted.
+     * If the app crashes/closes during a send, the message would be stuck forever.
+     *
+     * By resetting to WAITING_SESSION:
+     * - Message will be re-encrypted with current session keys
+     * - Message will be automatically sent when session is active
+     * - No manual user intervention required
+     *
+     * We also clear encryptedMessage and seeker since they may be stale.
+     */
+    private resetStuckSendingMessages;
 }
 interface MessageServiceAPI {
     /** Get a message by its ID */
@@ -181,7 +212,7 @@ interface MessageServiceAPI {
 }
 interface DiscussionServiceAPI {
     /** Start a new discussion with a contact */
-    start(contact: Contact, payload?: AnnouncementPayload): Promise<Result<discussionInitializationResult, Error>>;
+    start(contact: Contact, payload?: AnnouncementPayload): Promise<Result<DiscussionInitializationResult, Error>>;
     /** Accept an incoming discussion request */
     accept(discussion: Discussion): Promise<Result<Uint8Array, Error>>;
     /** Renew a broken discussion */
@@ -233,6 +264,6 @@ interface PollingAPI {
     /** Whether polling is currently running */
     isRunning: boolean;
 }
-/** Create a new GossipSdk instance. The consumer manages the instance lifecycle. */
-export declare function createGossipSdk(): GossipSdk;
+/** The singleton GossipSdk instance */
+export declare const gossipSdk: GossipSdk;
 export { GossipSdk };