@massalabs/gossip-sdk 0.0.2-dev.20260128094509 → 0.0.2-dev.20260128160824

package/dist/assets/generated/wasm-node/gossip_wasm_bg.wasm.d.ts

@@ -0,0 +1,164 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_announcementresult_free: (a: number, b: number) => void;
+export const __wbg_encryptionkey_free: (a: number, b: number) => void;
+export const __wbg_nonce_free: (a: number, b: number) => void;
+export const __wbg_receivemessageoutput_free: (a: number, b: number) => void;
+export const __wbg_sendmessageoutput_free: (a: number, b: number) => void;
+export const __wbg_sessionconfig_free: (a: number, b: number) => void;
+export const __wbg_sessionmanagerwrapper_free: (a: number, b: number) => void;
+export const __wbg_userkeys_free: (a: number, b: number) => void;
+export const __wbg_userpublickeys_free: (a: number, b: number) => void;
+export const __wbg_usersecretkeys_free: (a: number, b: number) => void;
+export const aead_decrypt: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number,
+  f: number
+) => [number, number];
+export const aead_encrypt: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number,
+  f: number
+) => [number, number];
+export const announcementresult_announcer_public_keys: (a: number) => number;
+export const announcementresult_timestamp: (a: number) => number;
+export const announcementresult_user_data: (a: number) => [number, number];
+export const encryptionkey_from_bytes: (
+  a: number,
+  b: number
+) => [number, number, number];
+export const encryptionkey_from_seed: (
+  a: number,
+  b: number,
+  c: number,
+  d: number
+) => [number, number, number];
+export const encryptionkey_generate: () => number;
+export const encryptionkey_to_bytes: (a: number) => [number, number];
+export const generate_user_keys: (
+  a: number,
+  b: number
+) => [number, number, number];
+export const nonce_from_bytes: (
+  a: number,
+  b: number
+) => [number, number, number];
+export const nonce_generate: () => number;
+export const nonce_to_bytes: (a: number) => [number, number];
+export const receivemessageoutput_acknowledged_seekers: (a: number) => any;
+export const receivemessageoutput_message: (a: number) => [number, number];
+export const receivemessageoutput_timestamp: (a: number) => number;
+export const receivemessageoutput_user_id: (a: number) => [number, number];
+export const sendmessageoutput_data: (a: number) => [number, number];
+export const sendmessageoutput_seeker: (a: number) => [number, number];
+export const sessionconfig_new: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number,
+  f: number,
+  g: bigint
+) => number;
+export const sessionconfig_new_default: () => number;
+export const sessionmanagerwrapper_establish_outgoing_session: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number,
+  f: number
+) => [number, number];
+export const sessionmanagerwrapper_feed_incoming_announcement: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number
+) => number;
+export const sessionmanagerwrapper_feed_incoming_message_board_read: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number,
+  f: number
+) => number;
+export const sessionmanagerwrapper_from_encrypted_blob: (
+  a: number,
+  b: number,
+  c: number
+) => [number, number, number];
+export const sessionmanagerwrapper_get_message_board_read_keys: (
+  a: number
+) => any;
+export const sessionmanagerwrapper_new: (a: number) => number;
+export const sessionmanagerwrapper_peer_discard: (
+  a: number,
+  b: number,
+  c: number
+) => [number, number];
+export const sessionmanagerwrapper_peer_list: (a: number) => any;
+export const sessionmanagerwrapper_peer_session_status: (
+  a: number,
+  b: number,
+  c: number
+) => [number, number, number];
+export const sessionmanagerwrapper_refresh: (a: number) => any;
+export const sessionmanagerwrapper_send_message: (
+  a: number,
+  b: number,
+  c: number,
+  d: number,
+  e: number
+) => [number, number, number];
+export const sessionmanagerwrapper_to_encrypted_blob: (
+  a: number,
+  b: number
+) => [number, number, number, number];
+export const userkeys_public_keys: (a: number) => [number, number, number];
+export const userkeys_secret_keys: (a: number) => [number, number, number];
+export const userpublickeys_derive_id: (a: number) => [number, number];
+export const userpublickeys_dsa_verification_key: (
+  a: number
+) => [number, number];
+export const userpublickeys_from_bytes: (
+  a: number,
+  b: number
+) => [number, number, number];
+export const userpublickeys_kem_public_key: (a: number) => [number, number];
+export const userpublickeys_massa_public_key: (a: number) => [number, number];
+export const userpublickeys_to_bytes: (
+  a: number
+) => [number, number, number, number];
+export const usersecretkeys_dsa_signing_key: (a: number) => [number, number];
+export const usersecretkeys_from_bytes: (
+  a: number,
+  b: number
+) => [number, number, number];
+export const usersecretkeys_kem_secret_key: (a: number) => [number, number];
+export const usersecretkeys_massa_secret_key: (a: number) => [number, number];
+export const usersecretkeys_to_bytes: (
+  a: number
+) => [number, number, number, number];
+export const start: () => void;
+export const __wbindgen_exn_store: (a: number) => void;
+export const __externref_table_alloc: () => number;
+export const __wbindgen_export_2: WebAssembly.Table;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (
+  a: number,
+  b: number,
+  c: number,
+  d: number
+) => number;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_start: () => void;

package/dist/assets/generated/wasm-node/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "gossip-wasm",
+  "version": "0.1.0",
+  "files": [
+    "gossip_wasm_bg.wasm",
+    "gossip_wasm.js",
+    "gossip_wasm.d.ts"
+  ],
+  "main": "gossip_wasm.js",
+  "types": "gossip_wasm.d.ts"
+}

package/dist/config/protocol.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Protocol API Configuration
+ *
+ * Centralized configuration for the message protocol API endpoints.
+ * This allows easy switching between different protocol implementations.
+ */
+export interface ProtocolConfig {
+    baseUrl: string;
+    timeout: number;
+    retryAttempts: number;
+}
+export declare const protocolConfig: ProtocolConfig;
+export declare enum MessageProtocolType {
+    REST = "rest",
+    MOCK = "mock"
+}
+export declare const defaultMessageProtocol: MessageProtocolType;
+/**
+ * Set the base URL for the protocol API at runtime.
+ * This overrides environment variables and defaults.
+ *
+ * @param baseUrl - The base URL to use (e.g., 'https://api.example.com/api')
+ *
+ * @example
+ * ```typescript
+ * import { setProtocolBaseUrl } from 'gossip-sdk';
+ *
+ * // Set custom API endpoint
+ * setProtocolBaseUrl('https://my-server.com/api');
+ * ```
+ */
+export declare function setProtocolBaseUrl(baseUrl: string): void;
+/**
+ * Reset the base URL to use environment variables or defaults.
+ */
+export declare function resetProtocolBaseUrl(): void;

package/dist/config/protocol.js

@@ -0,0 +1,77 @@
+/**
+ * Protocol API Configuration
+ *
+ * Centralized configuration for the message protocol API endpoints.
+ * This allows easy switching between different protocol implementations.
+ */
+// Default API URL for the hosted REST protocol.
+// Override via setProtocolBaseUrl() or environment variables.
+const DEFAULT_API_URL = 'https://api.usegossip.com';
+// Mutable config that can be updated at runtime
+let currentBaseUrl = null;
+function buildProtocolApiBaseUrl() {
+    // If runtime override is set, use it
+    if (currentBaseUrl !== null) {
+        return currentBaseUrl;
+    }
+    // Try to get from environment variable (Vite)
+    let apiUrl;
+    try {
+        // Check if import.meta.env is available (Vite environment)
+        if (typeof import.meta !== 'undefined' &&
+            import.meta.env?.VITE_GOSSIP_API_URL) {
+            apiUrl = import.meta.env.VITE_GOSSIP_API_URL;
+        }
+    }
+    catch {
+        // import.meta.env not available (Node.js without Vite)
+    }
+    // Check process.env for Node.js environment
+    if (!apiUrl &&
+        typeof process !== 'undefined' &&
+        process.env?.GOSSIP_API_URL) {
+        apiUrl = process.env.GOSSIP_API_URL;
+    }
+    // Fall back to default
+    if (!apiUrl)
+        apiUrl = DEFAULT_API_URL;
+    // Normalize trailing slashes to avoid `//api`
+    const trimmed = apiUrl.replace(/\/+$/, '');
+    return `${trimmed}/api`;
+}
+export const protocolConfig = {
+    get baseUrl() {
+        return buildProtocolApiBaseUrl();
+    },
+    timeout: 10000,
+    retryAttempts: 3,
+};
+export var MessageProtocolType;
+(function (MessageProtocolType) {
+    MessageProtocolType["REST"] = "rest";
+    MessageProtocolType["MOCK"] = "mock";
+})(MessageProtocolType || (MessageProtocolType = {}));
+export const defaultMessageProtocol = MessageProtocolType.REST;
+/**
+ * Set the base URL for the protocol API at runtime.
+ * This overrides environment variables and defaults.
+ *
+ * @param baseUrl - The base URL to use (e.g., 'https://api.example.com/api')
+ *
+ * @example
+ * ```typescript
+ * import { setProtocolBaseUrl } from 'gossip-sdk';
+ *
+ * // Set custom API endpoint
+ * setProtocolBaseUrl('https://my-server.com/api');
+ * ```
+ */
+export function setProtocolBaseUrl(baseUrl) {
+    currentBaseUrl = baseUrl;
+}
+/**
+ * Reset the base URL to use environment variables or defaults.
+ */
+export function resetProtocolBaseUrl() {
+    currentBaseUrl = null;
+}

package/dist/config/sdk.d.ts

@@ -0,0 +1,82 @@
+/**
+ * SDK Configuration
+ *
+ * Centralized configuration for the Gossip SDK.
+ * All values have sensible defaults that can be overridden.
+ */
+/**
+ * Protocol configuration for network requests
+ */
+export interface ProtocolConfig {
+    /** API base URL (default: from environment or https://api.usegossip.com) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 10000) */
+    timeout: number;
+    /** Number of retry attempts for failed requests (default: 3) */
+    retryAttempts: number;
+}
+/**
+ * Polling configuration for automatic message/announcement fetching
+ */
+export interface PollingConfig {
+    /** Enable automatic polling (default: false) */
+    enabled: boolean;
+    /** Interval for fetching messages in milliseconds (default: 5000) */
+    messagesIntervalMs: number;
+    /** Interval for fetching announcements in milliseconds (default: 10000) */
+    announcementsIntervalMs: number;
+    /** Interval for session refresh/keep-alive in milliseconds (default: 30000) */
+    sessionRefreshIntervalMs: number;
+}
+/**
+ * Message fetching configuration
+ */
+export interface MessagesConfig {
+    /** Delay between fetch iterations in milliseconds (default: 100) */
+    fetchDelayMs: number;
+    /** Maximum number of fetch iterations per call (default: 30) */
+    maxFetchIterations: number;
+    /**
+     * Time window in milliseconds for duplicate detection (default: 30000 = 30 seconds).
+     * Messages with same content from same sender within this window are considered duplicates.
+     * This handles edge case where app crashes after network send but before DB update,
+     * resulting in message being re-sent on restart.
+     */
+    deduplicationWindowMs: number;
+}
+/**
+ * Announcement configuration
+ */
+export interface AnnouncementsConfig {
+    /** Maximum announcements to fetch per request (default: 500) */
+    fetchLimit: number;
+    /** Time before marking failed announcements as broken in ms (default: 3600000 = 1 hour) */
+    brokenThresholdMs: number;
+}
+/**
+ * Complete SDK configuration
+ */
+export interface SdkConfig {
+    /** Network/protocol settings */
+    protocol: ProtocolConfig;
+    /** Automatic polling settings */
+    polling: PollingConfig;
+    /** Message fetching settings */
+    messages: MessagesConfig;
+    /** Announcement settings */
+    announcements: AnnouncementsConfig;
+}
+/**
+ * Default SDK configuration values
+ */
+export declare const defaultSdkConfig: SdkConfig;
+/**
+ * Deep merge partial config with defaults
+ */
+export declare function mergeConfig(partial?: DeepPartial<SdkConfig>): SdkConfig;
+/**
+ * Helper type for deep partial objects
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};

package/dist/config/sdk.js

@@ -0,0 +1,55 @@
+/**
+ * SDK Configuration
+ *
+ * Centralized configuration for the Gossip SDK.
+ * All values have sensible defaults that can be overridden.
+ */
+/**
+ * Default SDK configuration values
+ */
+export const defaultSdkConfig = {
+    protocol: {
+        timeout: 10000,
+        retryAttempts: 3,
+    },
+    polling: {
+        enabled: false,
+        messagesIntervalMs: 5000,
+        announcementsIntervalMs: 10000,
+        sessionRefreshIntervalMs: 30000,
+    },
+    messages: {
+        fetchDelayMs: 100,
+        maxFetchIterations: 30,
+        deduplicationWindowMs: 30000, // 30 seconds
+    },
+    announcements: {
+        fetchLimit: 500,
+        brokenThresholdMs: 60 * 60 * 1000, // 1 hour
+    },
+};
+/**
+ * Deep merge partial config with defaults
+ */
+export function mergeConfig(partial) {
+    if (!partial)
+        return { ...defaultSdkConfig };
+    return {
+        protocol: {
+            ...defaultSdkConfig.protocol,
+            ...partial.protocol,
+        },
+        polling: {
+            ...defaultSdkConfig.polling,
+            ...partial.polling,
+        },
+        messages: {
+            ...defaultSdkConfig.messages,
+            ...partial.messages,
+        },
+        announcements: {
+            ...defaultSdkConfig.announcements,
+            ...partial.announcements,
+        },
+    };
+}

package/{src/contacts.ts → dist/contacts.d.ts}

@@ -17,22 +17,11 @@
  * await deleteContact(userId, contactUserId);
  * ```
  */
-
-import {
-  updateContactName as updateContactNameUtil,
-  deleteContact as deleteContactUtil,
-} from './utils/contacts';
 import { type Contact, type GossipDatabase } from './db';
-import type {
-  UpdateContactNameResult,
-  DeleteContactResult,
-} from './utils/contacts';
-import type { UserPublicKeys } from './assets/generated/wasm/gossip_wasm';
+import type { UpdateContactNameResult, DeleteContactResult } from './utils/contacts';
+import type { UserPublicKeys } from '#wasm';
 import type { SessionModule } from './wasm/session';
-
-// Re-export result types
 export type { UpdateContactNameResult, DeleteContactResult };
-
 /**
  * Get all contacts for an owner.
  *
@@ -46,18 +35,7 @@ export type { UpdateContactNameResult, DeleteContactResult };
  * contacts.forEach(c => console.log(c.name, c.userId));
  * ```
  */
-export async function getContacts(
-  ownerUserId: string,
-  db: GossipDatabase
-): Promise<Contact[]> {
-  try {
-    return await db.getContactsByOwner(ownerUserId);
-  } catch (error) {
-    console.error('Error getting contacts:', error);
-    return [];
-  }
-}
-
+export declare function getContacts(ownerUserId: string, db: GossipDatabase): Promise<Contact[]>;
 /**
  * Get a specific contact by owner and contact user IDs.
  *
@@ -74,23 +52,7 @@ export async function getContacts(
  * }
  * ```
  */
-export async function getContact(
-  ownerUserId: string,
-  contactUserId: string,
-  db: GossipDatabase
-): Promise<Contact | null> {
-  try {
-    const contact = await db.getContactByOwnerAndUserId(
-      ownerUserId,
-      contactUserId
-    );
-    return contact ?? null;
-  } catch (error) {
-    console.error('Error getting contact:', error);
-    return null;
-  }
-}
-
+export declare function getContact(ownerUserId: string, contactUserId: string, db: GossipDatabase): Promise<Contact | null>;
 /**
  * Add a new contact.
  *
@@ -117,42 +79,11 @@ export async function getContact(
  * }
  * ```
  */
-export async function addContact(
-  ownerUserId: string,
-  userId: string,
-  name: string,
-  publicKeys: UserPublicKeys,
-  db: GossipDatabase
-): Promise<{ success: boolean; error?: string; contact?: Contact }> {
-  try {
-    // Check if contact already exists
-    const existing = await db.getContactByOwnerAndUserId(ownerUserId, userId);
-    if (existing) {
-      return { success: false, error: 'Contact already exists' };
-    }
-
-    const contact: Contact = {
-      ownerUserId,
-      userId,
-      name,
-      publicKeys: publicKeys.to_bytes(),
-      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 };
-  } catch (error) {
-    console.error('Error adding contact:', error);
-    return {
-      success: false,
-      error: error instanceof Error ? error.message : 'Unknown error',
-    };
-  }
-}
-
+export declare function addContact(ownerUserId: string, userId: string, name: string, publicKeys: UserPublicKeys, db: GossipDatabase): Promise<{
+    success: boolean;
+    error?: string;
+    contact?: Contact;
+}>;
 /**
  * Update contact name.
  *
@@ -172,15 +103,7 @@ export async function addContact(
  * }
  * ```
  */
-export async function updateContactName(
-  ownerUserId: string,
-  contactUserId: string,
-  newName: string,
-  db: GossipDatabase
-): Promise<UpdateContactNameResult> {
-  return await updateContactNameUtil(ownerUserId, contactUserId, newName, db);
-}
-
+export declare function updateContactName(ownerUserId: string, contactUserId: string, newName: string, db: GossipDatabase): Promise<UpdateContactNameResult>;
 /**
  * Delete a contact and all associated discussions and messages.
  *
@@ -200,11 +123,4 @@ export async function updateContactName(
  * }
  * ```
  */
-export async function deleteContact(
-  ownerUserId: string,
-  contactUserId: string,
-  db: GossipDatabase,
-  session: SessionModule
-): Promise<DeleteContactResult> {
-  return await deleteContactUtil(ownerUserId, contactUserId, db, session);
-}
+export declare function deleteContact(ownerUserId: string, contactUserId: string, db: GossipDatabase, session: SessionModule): Promise<DeleteContactResult>;