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

package/README.md

@@ -352,7 +352,7 @@ npm test           # Watch mode
 npm run test:run   # Single run
 ```
 
-Tests use `fake-indexeddb` to simulate IndexedDB in Node.js environment.
+Tests use wa-sqlite with in-memory databases for fast, isolated execution.
 
 ## Architecture
 
@@ -360,7 +360,7 @@ Tests use `fake-indexeddb` to simulate IndexedDB in Node.js environment.
 gossip-sdk/
 ├── src/
 │   ├── gossipSdk.ts      # SDK class & factory
-│   ├── db.ts             # Database (Dexie) implementation
+│   ├── db.ts             # Database (SQLite) implementation
 │   ├── contacts.ts       # Contact operations
 │   ├── api/
 │   │   └── messageProtocol/  # REST protocol implementation

package/dist/config/sdk.js

@@ -16,7 +16,7 @@ export const defaultSdkConfig = {
         enabled: false,
         messagesIntervalMs: 5000,
         announcementsIntervalMs: 10000,
-        sessionRefreshIntervalMs: 10000, //30000,
+        sessionRefreshIntervalMs: 10000,
     },
     messages: {
         fetchDelayMs: 100,

package/dist/contacts.d.ts

@@ -17,7 +17,7 @@
  * await deleteContact(userId, contactUserId);
  * ```
  */
-import { type Contact, type GossipDatabase } from './db';
+import { type Contact } from './db';
 import type { UpdateContactNameResult, DeleteContactResult } from './utils/contacts';
 import type { UserPublicKeys } from './wasm/bindings';
 import type { SessionModule } from './wasm/session';
@@ -26,33 +26,31 @@ export type { UpdateContactNameResult, DeleteContactResult };
  * Get all contacts for an owner.
  *
  * @param ownerUserId - The user ID of the contact owner
- * @param db - Database instance
  * @returns Array of contacts
  *
  * @example
  * ```typescript
- * const contacts = await getContacts(myUserId, db);
+ * const contacts = await getContacts(myUserId);
  * contacts.forEach(c => console.log(c.name, c.userId));
  * ```
  */
-export declare function getContacts(ownerUserId: string, db: GossipDatabase): Promise<Contact[]>;
+export declare function getContacts(ownerUserId: string): Promise<Contact[]>;
 /**
  * Get a specific contact by owner and contact user IDs.
  *
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact
- * @param db - Database instance
  * @returns Contact or null if not found
  *
  * @example
  * ```typescript
- * const contact = await getContact(myUserId, theirUserId, db);
+ * const contact = await getContact(myUserId, theirUserId);
  * if (contact) {
  *   console.log('Found contact:', contact.name);
  * }
  * ```
  */
-export declare function getContact(ownerUserId: string, contactUserId: string, db: GossipDatabase): Promise<Contact | null>;
+export declare function getContact(ownerUserId: string, contactUserId: string): Promise<Contact | null>;
 /**
  * Add a new contact.
  *
@@ -60,7 +58,6 @@ export declare function getContact(ownerUserId: string, contactUserId: string, d
  * @param userId - The user ID of the contact (Bech32-encoded)
  * @param name - Display name for the contact
  * @param publicKeys - The contact's public keys
- * @param db - Database instance
  * @returns Result with success status and optional contact
  *
  * @example
@@ -69,8 +66,7 @@ export declare function getContact(ownerUserId: string, contactUserId: string, d
  *   myUserId,
  *   'gossip1abc...',
  *   'Alice',
- *   alicePublicKeys,
- *   db
+ *   alicePublicKeys
  * );
  * if (result.success) {
  *   console.log('Contact added:', result.contact?.name);
@@ -79,7 +75,7 @@ export declare function getContact(ownerUserId: string, contactUserId: string, d
  * }
  * ```
  */
-export declare function addContact(ownerUserId: string, userId: string, name: string, publicKeys: UserPublicKeys, db: GossipDatabase): Promise<{
+export declare function addContact(ownerUserId: string, userId: string, name: string, publicKeys: UserPublicKeys): Promise<{
     success: boolean;
     error?: string;
     contact?: Contact;
@@ -90,12 +86,11 @@ export declare function addContact(ownerUserId: string, userId: string, name: st
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact
  * @param newName - New name for the contact
- * @param db - Database instance
  * @returns Result with success status and trimmed name
  *
  * @example
  * ```typescript
- * const result = await updateContactName(myUserId, theirUserId, 'Alice Smith', db);
+ * const result = await updateContactName(myUserId, theirUserId, 'Alice Smith');
  * if (result.ok) {
  *   console.log('Updated to:', result.trimmedName);
  * } else {
@@ -103,19 +98,18 @@ export declare function addContact(ownerUserId: string, userId: string, name: st
  * }
  * ```
  */
-export declare function updateContactName(ownerUserId: string, contactUserId: string, newName: string, db: GossipDatabase): Promise<UpdateContactNameResult>;
+export declare function updateContactName(ownerUserId: string, contactUserId: string, newName: string): Promise<UpdateContactNameResult>;
 /**
  * Delete a contact and all associated discussions and messages.
  *
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact to delete
- * @param db - Database instance
  * @param session - Session module for peer management
  * @returns Result with success status
  *
  * @example
  * ```typescript
- * const result = await deleteContact(myUserId, theirUserId, db, session);
+ * const result = await deleteContact(myUserId, theirUserId, session);
  * if (result.ok) {
  *   console.log('Contact deleted');
  * } else {
@@ -123,4 +117,4 @@ export declare function updateContactName(ownerUserId: string, contactUserId: st
  * }
  * ```
  */
-export declare function deleteContact(ownerUserId: string, contactUserId: string, db: GossipDatabase, session: SessionModule): Promise<DeleteContactResult>;
+export declare function deleteContact(ownerUserId: string, contactUserId: string, session: SessionModule): Promise<DeleteContactResult>;

package/dist/contacts.js

@@ -18,22 +18,22 @@
  * ```
  */
 import { updateContactName as updateContactNameUtil, deleteContact as deleteContactUtil, } from './utils/contacts';
+import { getContactsByOwner, getContactByOwnerAndUser, insertContact as queryInsertContact, } from './queries';
 /**
  * Get all contacts for an owner.
  *
  * @param ownerUserId - The user ID of the contact owner
- * @param db - Database instance
  * @returns Array of contacts
  *
  * @example
  * ```typescript
- * const contacts = await getContacts(myUserId, db);
+ * const contacts = await getContacts(myUserId);
  * contacts.forEach(c => console.log(c.name, c.userId));
  * ```
  */
-export async function getContacts(ownerUserId, db) {
+export async function getContacts(ownerUserId) {
     try {
-        return await db.getContactsByOwner(ownerUserId);
+        return await getContactsByOwner(ownerUserId);
     }
     catch (error) {
         console.error('Error getting contacts:', error);
@@ -45,20 +45,19 @@ export async function getContacts(ownerUserId, db) {
  *
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact
- * @param db - Database instance
  * @returns Contact or null if not found
  *
  * @example
  * ```typescript
- * const contact = await getContact(myUserId, theirUserId, db);
+ * const contact = await getContact(myUserId, theirUserId);
  * if (contact) {
  *   console.log('Found contact:', contact.name);
  * }
  * ```
  */
-export async function getContact(ownerUserId, contactUserId, db) {
+export async function getContact(ownerUserId, contactUserId) {
     try {
-        const contact = await db.getContactByOwnerAndUserId(ownerUserId, contactUserId);
+        const contact = await getContactByOwnerAndUser(ownerUserId, contactUserId);
         return contact ?? null;
     }
     catch (error) {
@@ -73,7 +72,6 @@ export async function getContact(ownerUserId, contactUserId, db) {
  * @param userId - The user ID of the contact (Bech32-encoded)
  * @param name - Display name for the contact
  * @param publicKeys - The contact's public keys
- * @param db - Database instance
  * @returns Result with success status and optional contact
  *
  * @example
@@ -82,8 +80,7 @@ export async function getContact(ownerUserId, contactUserId, db) {
  *   myUserId,
  *   'gossip1abc...',
  *   'Alice',
- *   alicePublicKeys,
- *   db
+ *   alicePublicKeys
  * );
  * if (result.success) {
  *   console.log('Contact added:', result.contact?.name);
@@ -92,14 +89,14 @@ export async function getContact(ownerUserId, contactUserId, db) {
  * }
  * ```
  */
-export async function addContact(ownerUserId, userId, name, publicKeys, db) {
+export async function addContact(ownerUserId, userId, name, publicKeys) {
     try {
         // Check if contact already exists
-        const existing = await db.getContactByOwnerAndUserId(ownerUserId, userId);
+        const existing = await getContactByOwnerAndUser(ownerUserId, userId);
         if (existing) {
             return { success: false, error: 'Contact already exists' };
         }
-        const contact = {
+        await queryInsertContact({
             ownerUserId,
             userId,
             name,
@@ -107,10 +104,9 @@ export async function addContact(ownerUserId, userId, name, publicKeys, db) {
             isOnline: false,
             lastSeen: new Date(),
             createdAt: new Date(),
-        };
-        const id = await db.contacts.add(contact);
-        const newContact = await db.contacts.get(id);
-        return { success: true, contact: newContact };
+        });
+        const newContact = await getContactByOwnerAndUser(ownerUserId, userId);
+        return { success: true, contact: newContact ?? undefined };
     }
     catch (error) {
         console.error('Error adding contact:', error);
@@ -126,12 +122,11 @@ export async function addContact(ownerUserId, userId, name, publicKeys, db) {
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact
  * @param newName - New name for the contact
- * @param db - Database instance
  * @returns Result with success status and trimmed name
  *
  * @example
  * ```typescript
- * const result = await updateContactName(myUserId, theirUserId, 'Alice Smith', db);
+ * const result = await updateContactName(myUserId, theirUserId, 'Alice Smith');
  * if (result.ok) {
  *   console.log('Updated to:', result.trimmedName);
  * } else {
@@ -139,21 +134,20 @@ export async function addContact(ownerUserId, userId, name, publicKeys, db) {
  * }
  * ```
  */
-export async function updateContactName(ownerUserId, contactUserId, newName, db) {
-    return await updateContactNameUtil(ownerUserId, contactUserId, newName, db);
+export async function updateContactName(ownerUserId, contactUserId, newName) {
+    return await updateContactNameUtil(ownerUserId, contactUserId, newName);
 }
 /**
  * Delete a contact and all associated discussions and messages.
  *
  * @param ownerUserId - The user ID of the contact owner
  * @param contactUserId - The user ID of the contact to delete
- * @param db - Database instance
  * @param session - Session module for peer management
  * @returns Result with success status
  *
  * @example
  * ```typescript
- * const result = await deleteContact(myUserId, theirUserId, db, session);
+ * const result = await deleteContact(myUserId, theirUserId, session);
  * if (result.ok) {
  *   console.log('Contact deleted');
  * } else {
@@ -161,6 +155,6 @@ export async function updateContactName(ownerUserId, contactUserId, newName, db)
  * }
  * ```
  */
-export async function deleteContact(ownerUserId, contactUserId, db, session) {
-    return await deleteContactUtil(ownerUserId, contactUserId, db, session);
+export async function deleteContact(ownerUserId, contactUserId, session) {
+    return await deleteContactUtil(ownerUserId, contactUserId, session);
 }

package/dist/core/SdkEventEmitter.d.ts

@@ -7,6 +7,7 @@ import type { Message, Discussion, Contact } from '../db';
 export declare enum SdkEventType {
     MESSAGE_RECEIVED = "messageReceived",
     MESSAGE_SENT = "messageSent",
+    MESSAGE_READ = "messageRead",
     MESSAGE_FAILED = "messageFailed",
     SESSION_REQUESTED = "sessionRequested",
     SESSION_CREATED = "sessionCreated",
@@ -17,6 +18,7 @@ export declare enum SdkEventType {
 export interface SdkEventHandlers {
     [SdkEventType.MESSAGE_RECEIVED]: (message: Message) => void;
     [SdkEventType.MESSAGE_SENT]: (message: Message) => void;
+    [SdkEventType.MESSAGE_READ]: (messageId: number) => void;
     [SdkEventType.MESSAGE_FAILED]: (message: Message, error: Error) => void;
     [SdkEventType.SESSION_REQUESTED]: (discussion: Discussion, contact: Contact) => void;
     [SdkEventType.SESSION_CREATED]: (discussion: Discussion) => void;

package/dist/core/SdkEventEmitter.js

@@ -10,6 +10,7 @@ export var SdkEventType;
 (function (SdkEventType) {
     SdkEventType["MESSAGE_RECEIVED"] = "messageReceived";
     SdkEventType["MESSAGE_SENT"] = "messageSent";
+    SdkEventType["MESSAGE_READ"] = "messageRead";
     SdkEventType["MESSAGE_FAILED"] = "messageFailed";
     SdkEventType["SESSION_REQUESTED"] = "sessionRequested";
     SdkEventType["SESSION_CREATED"] = "sessionCreated";
@@ -29,6 +30,7 @@ export class SdkEventEmitter {
             value: {
                 [SdkEventType.MESSAGE_RECEIVED]: new Set(),
                 [SdkEventType.MESSAGE_SENT]: new Set(),
+                [SdkEventType.MESSAGE_READ]: new Set(),
                 [SdkEventType.MESSAGE_FAILED]: new Set(),
                 [SdkEventType.SESSION_REQUESTED]: new Set(),
                 [SdkEventType.SESSION_CREATED]: new Set(),

package/dist/core/SdkPolling.d.ts

@@ -4,17 +4,14 @@
  * Manages polling timers for messages, announcements, and session refresh.
  */
 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>;
     /** Fetch and process announcements */
     fetchAnnouncements: () => Promise<void>;
-    /** Handle session refresh for active discussions */
-    handleSessionRefresh: (discussions: Discussion[]) => Promise<void>;
-    /** Get active discussions for session refresh */
-    getActiveDiscussions: () => Promise<Discussion[]>;
+    /** Handle session refresh (state update) */
+    handleSessionRefresh: () => Promise<void>;
 }
 export declare class SdkPolling {
     private timers;

package/dist/core/SdkPolling.js

@@ -68,10 +68,7 @@ export class SdkPolling {
         // Start session refresh polling
         this.timers.sessionRefresh = setInterval(async () => {
             try {
-                const discussions = await this.callbacks?.getActiveDiscussions();
-                if (discussions && discussions.length > 0) {
-                    await this.callbacks?.handleSessionRefresh(discussions);
-                }
+                await this.callbacks?.handleSessionRefresh();
             }
             catch (error) {
                 const err = error instanceof Error ? error : new Error(String(error));

package/dist/core/index.d.ts

@@ -2,6 +2,6 @@
  * Core SDK components
  */
 export { SdkEventEmitter } from './SdkEventEmitter';
-export type { SdkEventType, SdkEventHandlers } from './SdkEventEmitter';
+export { SdkEventType, type SdkEventHandlers } from './SdkEventEmitter';
 export { SdkPolling } from './SdkPolling';
 export type { PollingCallbacks } from './SdkPolling';

package/dist/core/index.js

@@ -2,4 +2,5 @@
  * Core SDK components
  */
 export { SdkEventEmitter } from './SdkEventEmitter';
+export { SdkEventType } from './SdkEventEmitter';
 export { SdkPolling } from './SdkPolling';

package/dist/db.d.ts

@@ -1,10 +1,9 @@
 /**
- * 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, { Table } from 'dexie';
 export type AuthMethod = 'capacitor' | 'webauthn' | 'password';
 export declare const MESSAGE_ID_SIZE = 12;
 export interface Contact {
@@ -12,7 +11,7 @@ export interface Contact {
     ownerUserId: string;
     userId: string;
     name: string;
-    avatar?: string;
+    avatar?: string | null;
     publicKeys: Uint8Array;
     isOnline: boolean;
     lastSeen: Date;
@@ -44,7 +43,7 @@ export interface Message {
 export interface UserProfile {
     userId: string;
     username: string;
-    avatar?: string;
+    avatar?: string | null;
     security: {
         encKeySalt: Uint8Array;
         authMethod: AuthMethod;
@@ -65,7 +64,14 @@ export interface UserProfile {
     createdAt: Date;
     updatedAt: Date;
     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",
@@ -78,9 +84,11 @@ export declare enum MessageDirection {
 export declare enum MessageStatus {
     WAITING_SESSION = "waiting_session",// Waiting for active session with peer
     READY = "ready",
+    SENDING = "sending",
     SENT = "sent",
     DELIVERED = "delivered",
-    READ = "read"
+    READ = "read",
+    FAILED = "failed"
 }
 export declare enum MessageType {
     TEXT = "text",
@@ -91,11 +99,18 @@ export declare enum MessageType {
     AUDIO = "audio",
     VIDEO = "video"
 }
-export interface readyAnnouncement {
+export interface ReadyAnnouncement {
     announcement_bytes: Uint8Array;
     when_to_send: Date;
 }
-export type SendAnnouncement = null | readyAnnouncement;
+export type SendAnnouncement = null | ReadyAnnouncement;
+/** Serialize a SendAnnouncement to a JSON string for SQLite text column */
+export declare function serializeSendAnnouncement(announcement: ReadyAnnouncement): string;
+/** Deserialize a SendAnnouncement JSON string from SQLite back to an object */
+export declare function deserializeSendAnnouncement(json: string): ReadyAnnouncement;
+/** Convert a raw SQLite discussion row to a Discussion object.
+ *  Deserializes sendAnnouncement from JSON text to SendAnnouncement. */
+export declare function rowToDiscussion(row: Record<string, unknown>): Discussion;
 export interface Discussion {
     id?: number;
     ownerUserId: string;
@@ -103,12 +118,16 @@ export interface Discussion {
     weAccepted: boolean;
     sendAnnouncement: SendAnnouncement;
     direction: DiscussionDirection;
-    lastSyncTimestamp?: Date;
-    customName?: string;
+    status: DiscussionStatus;
+    nextSeeker: Uint8Array | null;
+    initiationAnnouncement: Uint8Array | null;
+    announcementMessage: string | null;
+    lastSyncTimestamp: Date | null;
+    customName: string | null;
     lastAnnouncementMessage?: string;
-    lastMessageId?: number;
-    lastMessageContent?: string;
-    lastMessageTimestamp?: Date;
+    lastMessageId: number | null;
+    lastMessageContent: string | null;
+    lastMessageTimestamp: Date | null;
     unreadCount: number;
     createdAt: Date;
     updatedAt: Date;
@@ -129,44 +148,3 @@ export interface ActiveSeeker {
     id?: number;
     seeker: Uint8Array;
 }
-export declare class GossipDatabase extends Dexie {
-    contacts: Table<Contact>;
-    messages: Table<Message>;
-    userProfile: Table<UserProfile>;
-    discussions: Table<Discussion>;
-    pendingEncryptedMessages: Table<PendingEncryptedMessage>;
-    pendingAnnouncements: Table<PendingAnnouncement>;
-    activeSeekers: Table<ActiveSeeker>;
-    constructor();
-    /** CONTACTS */
-    getContactsByOwner(ownerUserId: string): Promise<Contact[]>;
-    getContactByOwnerAndUserId(ownerUserId: string, userId: string): Promise<Contact | undefined>;
-    /** DISCUSSIONS */
-    getDiscussionsByOwner(ownerUserId: string): Promise<Discussion[]>;
-    getUnreadCountByOwner(ownerUserId: string): Promise<number>;
-    getDiscussionByOwnerAndContact(ownerUserId: string, contactUserId: string): Promise<Discussion | undefined>;
-    markMessagesAsRead(ownerUserId: string, contactUserId: string): Promise<void>;
-    getMessagesForContactByOwner(ownerUserId: string, contactUserId: string, limit?: number): Promise<Message[]>;
-    addMessage(message: Omit<Message, 'id'>): Promise<number>;
-    /**
-     * Update the last sync timestamp for a discussion
-     * @param discussionId - The discussion ID
-     * @param timestamp - The sync timestamp
-     */
-    updateLastSyncTimestamp(discussionId: number, timestamp: Date): Promise<void>;
-    deleteDb(): Promise<void>;
-    /**
-     * Set all active seekers, replacing any existing ones
-     * @param seekers - Array of seeker Uint8Arrays to store
-     */
-    setActiveSeekers(seekers: Uint8Array[]): Promise<void>;
-    /**
-     * Get all active seekers from the database
-     * @returns Array of seeker Uint8Arrays
-     */
-    getActiveSeekers(): Promise<Uint8Array[]>;
-}
-/**
- * Get the database instance. Creates a default instance on first call.
- */
-export declare function gossipDb(): GossipDatabase;