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

package/dist/services/refresh.d.ts

@@ -4,7 +4,6 @@
  * Class-based service to periodically refresh sessions and handle
  * keep-alive messages and broken sessions.
  */
-import { type GossipDatabase } from '../db';
 import type { SessionModule } from '../wasm/session';
 import { MessageService } from './message';
 import { AnnouncementService } from './announcement';
@@ -16,11 +15,11 @@ import { SdkEventEmitter } from '../core/SdkEventEmitter';
  * @example
  * ```typescript
  * const refreshService = new RefreshService(
- *   db,
  *   messageService,
  *   discussionService,
  *   announcementService,
- *   session
+ *   session,
+ *   eventEmitter
  * );
  *
  * // Handle session refresh for active discussions
@@ -28,14 +27,13 @@ import { SdkEventEmitter } from '../core/SdkEventEmitter';
  * ```
  */
 export declare class RefreshService {
-    private db;
     private messageService;
     private announcementService;
     private discussionService;
     private session;
     private isUpdating;
     private eventEmitter;
-    constructor(db: GossipDatabase, messageService: MessageService, discussionService: DiscussionService, announcementService: AnnouncementService, session: SessionModule, eventEmitter: SdkEventEmitter);
+    constructor(messageService: MessageService, discussionService: DiscussionService, announcementService: AnnouncementService, session: SessionModule, eventEmitter: SdkEventEmitter);
     /**
      * Update state for all discussions:
      * - Cleanup orphaned peers

package/dist/services/refresh.js

@@ -4,7 +4,9 @@
  * Class-based service to periodically refresh sessions and handle
  * keep-alive messages and broken sessions.
  */
-import { MessageType, MessageDirection, MessageStatus, } from '../db';
+import { MessageType, MessageDirection, MessageStatus } from '../db';
+import { getDiscussionsByOwner } from '../queries';
+import { toSortedDiscussions } from '../utils/discussions';
 import { SessionStatus } from '../wasm/bindings';
 import { decodeUserId, encodeUserId } from '../utils/userId';
 import { Logger } from '../utils/logs';
@@ -16,11 +18,11 @@ const logger = new Logger('RefreshService');
  * @example
  * ```typescript
  * const refreshService = new RefreshService(
- *   db,
  *   messageService,
  *   discussionService,
  *   announcementService,
- *   session
+ *   session,
+ *   eventEmitter
  * );
  *
  * // Handle session refresh for active discussions
@@ -28,13 +30,7 @@ const logger = new Logger('RefreshService');
  * ```
  */
 export class RefreshService {
-    constructor(db, messageService, discussionService, announcementService, session, eventEmitter) {
-        Object.defineProperty(this, "db", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+    constructor(messageService, discussionService, announcementService, session, eventEmitter) {
         Object.defineProperty(this, "messageService", {
             enumerable: true,
             configurable: true,
@@ -71,7 +67,6 @@ export class RefreshService {
             writable: true,
             value: void 0
         });
-        this.db = db;
         this.messageService = messageService;
         this.discussionService = discussionService;
         this.announcementService = announcementService;
@@ -100,7 +95,8 @@ export class RefreshService {
                 log.error('ownerUserId is empty, skipping update_state');
                 return;
             }
-            const discussions = await this.db.getDiscussionsByOwner(ownerUserId);
+            const allRows = await getDiscussionsByOwner(ownerUserId);
+            const discussions = toSortedDiscussions(allRows);
             if (!discussions.length) {
                 return;
             }
@@ -147,7 +143,8 @@ export class RefreshService {
                 }
             }
             // Step 2: send announcements
-            const discussionsAfterRefresh = await this.db.getDiscussionsByOwner(ownerUserId);
+            const refreshRows = await getDiscussionsByOwner(ownerUserId);
+            const discussionsAfterRefresh = toSortedDiscussions(refreshRows);
             const activePendingDiscussions = discussionsAfterRefresh.filter(discussion => {
                 const status = this.session.peerSessionStatus(decodeUserId(discussion.contactUserId));
                 return [SessionStatus.Active, SessionStatus.SelfRequested].includes(status);

package/dist/sqlite-worker.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SQLite Web Worker — owns all WASM/SQLite state.
+ *
+ * Runs wa-sqlite (sync build) with AccessHandlePoolVFS for OPFS persistence.
+ * The main thread communicates via postMessage with { id, type, ... } messages.
+ *
+ * Messages:
+ *   init  → load WASM + VFS, open DB, run init SQL (PRAGMAs + DDL)
+ *   exec  → prepare/bind/step/finalize, return { rows, lastInsertRowId }
+ *   close → close DB
+ */
+export {};

package/dist/sqlite-worker.js

@@ -0,0 +1,106 @@
+/**
+ * SQLite Web Worker — owns all WASM/SQLite state.
+ *
+ * Runs wa-sqlite (sync build) with AccessHandlePoolVFS for OPFS persistence.
+ * The main thread communicates via postMessage with { id, type, ... } messages.
+ *
+ * Messages:
+ *   init  → load WASM + VFS, open DB, run init SQL (PRAGMAs + DDL)
+ *   exec  → prepare/bind/step/finalize, return { rows, lastInsertRowId }
+ *   close → close DB
+ */
+import SQLiteESMFactory from 'wa-sqlite/dist/wa-sqlite.mjs';
+import * as SQLite from 'wa-sqlite';
+import { AccessHandlePoolVFS } from 'wa-sqlite/src/examples/AccessHandlePoolVFS.js';
+let sqlite3 = null;
+let dbHandle = null;
+// Bind Worker's postMessage (avoids DOM lib signature mismatch at compile time)
+const post = globalThis.postMessage.bind(globalThis);
+function copyRow(row) {
+    return row.map(v => (v instanceof Uint8Array ? new Uint8Array(v) : v));
+}
+async function execSql(sql, params) {
+    if (!sqlite3 || dbHandle === null)
+        throw new Error('SQLite not initialized');
+    const rows = [];
+    if (params.length === 0) {
+        await sqlite3.exec(dbHandle, sql, (row) => {
+            rows.push(copyRow(row));
+        });
+    }
+    else {
+        const str = sqlite3.str_new(dbHandle, sql);
+        try {
+            const prepared = await sqlite3.prepare_v2(dbHandle, sqlite3.str_value(str));
+            if (prepared) {
+                try {
+                    sqlite3.bind_collection(prepared.stmt, params);
+                    while ((await sqlite3.step(prepared.stmt)) === SQLite.SQLITE_ROW) {
+                        rows.push(copyRow(sqlite3.row(prepared.stmt)));
+                    }
+                }
+                finally {
+                    await sqlite3.finalize(prepared.stmt);
+                }
+            }
+        }
+        finally {
+            sqlite3.str_finish(str);
+        }
+    }
+    // Only capture lastInsertRowId for INSERT statements (avoid unnecessary query on SELECT/UPDATE/DELETE)
+    let lastInsertRowId = 0;
+    if (sql.trimStart().toUpperCase().startsWith('INSERT')) {
+        await sqlite3.exec(dbHandle, 'SELECT last_insert_rowid()', (row) => {
+            lastInsertRowId = row[0];
+        });
+    }
+    return { rows, lastInsertRowId };
+}
+addEventListener('message', async (e) => {
+    const { id, type } = e.data;
+    try {
+        switch (type) {
+            case 'init': {
+                const { opfsPath, wasmUrl, initSql } = e.data;
+                const moduleArg = {};
+                if (wasmUrl)
+                    moduleArg.locateFile = () => wasmUrl;
+                const module = await SQLiteESMFactory(moduleArg);
+                sqlite3 = SQLite.Factory(module);
+                const vfs = new AccessHandlePoolVFS(opfsPath);
+                await vfs.isReady;
+                sqlite3.vfs_register(vfs, true);
+                dbHandle = await sqlite3.open_v2('gossip.db');
+                if (initSql) {
+                    await sqlite3.exec(dbHandle, initSql);
+                }
+                post({ id, type: 'init-result', success: true });
+                break;
+            }
+            case 'exec': {
+                const { sql, params } = e.data;
+                const result = await execSql(sql, params);
+                post({
+                    id,
+                    type: 'exec-result',
+                    rows: result.rows,
+                    lastInsertRowId: result.lastInsertRowId,
+                });
+                break;
+            }
+            case 'close': {
+                if (dbHandle !== null && sqlite3) {
+                    await sqlite3.close(dbHandle);
+                    dbHandle = null;
+                }
+                sqlite3 = null;
+                post({ id, type: 'close-result' });
+                break;
+            }
+        }
+    }
+    catch (err) {
+        post({ id, type: 'error', message: err.message });
+    }
+});

package/dist/sqlite.d.ts

@@ -0,0 +1,79 @@
+/**
+ * SQLite initialization module for the Gossip SDK.
+ *
+ * Uses wa-sqlite (WASM) with Drizzle ORM's sqlite-proxy driver.
+ * Two execution paths:
+ *   - Browser (opfsPath set): Web Worker + AccessHandlePoolVFS — OPFS persistence,
+ *     off the main thread. Uses the sync WASM build (wa-sqlite).
+ *   - In-memory (tests): :memory: in-process — no persistence, fast, isolated.
+ *     Uses the sync WASM build with wasmBinary passed directly.
+ *
+ * In Phase C the VFS will be swapped for the encrypted PlausibleDeniableVFS.
+ */
+import { type SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
+import * as schema from './schema.js';
+export type GossipDatabase = SqliteRemoteDatabase<typeof schema>;
+export interface InitDbOptions {
+    /**
+     * OPFS directory path for persistent storage.
+     * When set, spawns a Web Worker with AccessHandlePoolVFS for OPFS persistence.
+     * When omitted, uses an in-memory database (for tests).
+     */
+    opfsPath?: string;
+    /**
+     * Pre-loaded WASM binary for environments where fetch() is unavailable
+     * (e.g. Node.js tests). When omitted, the factory uses fetch() to load
+     * the .wasm file (browser default).
+     */
+    wasmBinary?: ArrayBuffer;
+    /**
+     * URL to the wa-sqlite WASM file. Used in browser to tell the Emscripten
+     * factory where to fetch the WASM binary (needed when bundlers like Vite
+     * rewrite asset paths). When omitted, the factory uses its default path.
+     */
+    wasmUrl?: string;
+}
+/**
+ * Initialize wa-sqlite and create the Drizzle ORM instance.
+ * Idempotent — subsequent calls are no-ops.
+ *
+ * @param options.opfsPath - Set to persist via OPFS Worker (production).
+ *                           Omit for in-memory database (tests).
+ */
+export declare function initDb(options?: InitDbOptions): Promise<void>;
+/**
+ * Get the Drizzle ORM database instance.
+ * Throws if initDb() has not been called.
+ */
+export declare function getSqliteDb(): GossipDatabase;
+export declare function isSqliteOpen(): boolean;
+/**
+ * Run a callback inside a SQLite transaction (BEGIN / COMMIT / ROLLBACK).
+ * All Drizzle operations inside the callback share the same transaction
+ * and the same dbLock hold, so they cannot interleave with outside queries.
+ */
+export declare function withTransaction<T>(fn: () => Promise<T>): Promise<T>;
+export declare function clearAllTables(): Promise<void>;
+/**
+ * Clear only conversation-related tables (contacts, discussions, messages).
+ * Preserves user profiles and other data.
+ */
+export declare function clearConversationTables(): Promise<void>;
+/**
+ * Get the last auto-increment row ID inserted via this connection.
+ * Used after INSERT into tables with INTEGER PRIMARY KEY AUTOINCREMENT.
+ *
+ * Browser path: returns the cached value from the last Worker exec response
+ * (returned atomically with every exec — no race condition).
+ * Test path: queries directly (same connection, serialized by dbLock).
+ */
+export declare function getLastInsertRowId(): Promise<number>;
+/**
+ * Close the database and release all resources.
+ * Browser path: sends close to Worker, then terminates it.
+ * Test path: closes in-process database handle.
+ * Atomically resets all state by replacing with a fresh default.
+ */
+export declare function closeSqlite(): Promise<void>;
+/** Exported for testing — the raw DDL string used to create tables. */
+export declare const _DDL_FOR_TESTING = "\n  CREATE TABLE IF NOT EXISTS contacts (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    ownerUserId TEXT NOT NULL,\n    userId TEXT NOT NULL,\n    name TEXT NOT NULL,\n    avatar TEXT,\n    publicKeys BLOB NOT NULL,\n    isOnline INTEGER NOT NULL DEFAULT 0,\n    lastSeen INTEGER NOT NULL,\n    createdAt INTEGER NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS messages (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    ownerUserId TEXT NOT NULL,\n    contactUserId TEXT NOT NULL,\n    messageId BLOB,\n    content TEXT NOT NULL,\n    serializedContent BLOB,\n    type TEXT NOT NULL,\n    direction TEXT NOT NULL,\n    status TEXT NOT NULL,\n    timestamp INTEGER NOT NULL,\n    metadata TEXT,\n    seeker BLOB,\n    replyTo TEXT,\n    forwardOf TEXT,\n    encryptedMessage BLOB,\n    whenToSend INTEGER\n  );\n\n  CREATE TABLE IF NOT EXISTS userProfile (\n    userId TEXT PRIMARY KEY,\n    username TEXT NOT NULL,\n    avatar TEXT,\n    bio TEXT,\n    status TEXT NOT NULL,\n    lastSeen INTEGER NOT NULL,\n    createdAt INTEGER NOT NULL,\n    updatedAt INTEGER NOT NULL,\n    lastPublicKeyPush INTEGER,\n    security TEXT NOT NULL,\n    session BLOB NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS discussions (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    ownerUserId TEXT NOT NULL,\n    contactUserId TEXT NOT NULL,\n    direction TEXT NOT NULL,\n    status TEXT NOT NULL,\n    weAccepted INTEGER NOT NULL DEFAULT 0,\n    sendAnnouncement TEXT,\n    nextSeeker BLOB,\n    initiationAnnouncement BLOB,\n    announcementMessage TEXT,\n    lastSyncTimestamp INTEGER,\n    customName TEXT,\n    lastMessageId INTEGER,\n    lastMessageContent TEXT,\n    lastMessageTimestamp INTEGER,\n    unreadCount INTEGER NOT NULL DEFAULT 0,\n    createdAt INTEGER NOT NULL,\n    updatedAt INTEGER NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS pendingEncryptedMessages (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    seeker BLOB NOT NULL,\n    ciphertext BLOB NOT NULL,\n    fetchedAt INTEGER NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS pendingAnnouncements (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    announcement BLOB NOT NULL,\n    fetchedAt INTEGER NOT NULL,\n    counter TEXT\n  );\n\n  CREATE TABLE IF NOT EXISTS activeSeekers (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    seeker BLOB NOT NULL\n  );\n\n  -- Indexes: contacts\n  CREATE INDEX IF NOT EXISTS contacts_owner_user_idx ON contacts(ownerUserId, userId);\n  CREATE INDEX IF NOT EXISTS contacts_owner_name_idx ON contacts(ownerUserId, name);\n\n  -- Indexes: messages\n  CREATE INDEX IF NOT EXISTS messages_owner_contact_idx ON messages(ownerUserId, contactUserId);\n  CREATE INDEX IF NOT EXISTS messages_owner_status_idx ON messages(ownerUserId, status);\n  CREATE INDEX IF NOT EXISTS messages_owner_contact_status_idx ON messages(ownerUserId, contactUserId, status);\n  CREATE INDEX IF NOT EXISTS messages_owner_seeker_idx ON messages(ownerUserId, seeker);\n  CREATE INDEX IF NOT EXISTS messages_owner_contact_dir_idx ON messages(ownerUserId, contactUserId, direction);\n  CREATE INDEX IF NOT EXISTS messages_owner_dir_status_idx ON messages(ownerUserId, direction, status);\n  CREATE INDEX IF NOT EXISTS messages_timestamp_idx ON messages(timestamp);\n\n  -- Indexes: userProfile\n  CREATE INDEX IF NOT EXISTS userProfile_username_idx ON userProfile(username);\n  CREATE INDEX IF NOT EXISTS userProfile_status_idx ON userProfile(status);\n\n  -- Indexes: discussions\n  CREATE UNIQUE INDEX IF NOT EXISTS discussions_owner_contact_idx ON discussions(ownerUserId, contactUserId);\n  CREATE INDEX IF NOT EXISTS discussions_owner_status_idx ON discussions(ownerUserId, status);\n\n  -- Indexes: pendingEncryptedMessages\n  CREATE INDEX IF NOT EXISTS pending_encrypted_seeker_idx ON pendingEncryptedMessages(seeker);\n  CREATE INDEX IF NOT EXISTS pending_encrypted_fetchedAt_idx ON pendingEncryptedMessages(fetchedAt);\n\n  -- Indexes: pendingAnnouncements\n  CREATE UNIQUE INDEX IF NOT EXISTS pending_announcements_announcement_idx ON pendingAnnouncements(announcement);\n  CREATE INDEX IF NOT EXISTS pending_announcements_fetchedAt_idx ON pendingAnnouncements(fetchedAt);\n\n  -- Indexes: activeSeekers\n  CREATE INDEX IF NOT EXISTS active_seekers_seeker_idx ON activeSeekers(seeker);\n\n  CREATE TABLE IF NOT EXISTS announcementCursors (\n    userId TEXT PRIMARY KEY,\n    counter TEXT NOT NULL\n  );\n";