@massalabs/gossip-sdk 0.0.1 → 0.0.2-dev.20260128111120

package/src/config/protocol.ts

@@ -1,97 +0,0 @@
-/**
- * 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;
-}
-
-// 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: string | null = null;
-
-function buildProtocolApiBaseUrl(): string {
-  // If runtime override is set, use it
-  if (currentBaseUrl !== null) {
-    return currentBaseUrl;
-  }
-
-  // Try to get from environment variable (Vite)
-  let apiUrl: string | undefined;
-  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: ProtocolConfig = {
-  get baseUrl() {
-    return buildProtocolApiBaseUrl();
-  },
-  timeout: 10000,
-  retryAttempts: 3,
-};
-
-export enum MessageProtocolType {
-  REST = 'rest',
-  MOCK = 'mock',
-}
-
-export const defaultMessageProtocol: MessageProtocolType =
-  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: string): void {
-  currentBaseUrl = baseUrl;
-}
-
-/**
- * Reset the base URL to use environment variables or defaults.
- */
-export function resetProtocolBaseUrl(): void {
-  currentBaseUrl = null;
-}

package/src/config/sdk.ts

@@ -1,131 +0,0 @@
-/**
- * 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 const defaultSdkConfig: SdkConfig = {
-  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?: DeepPartial<SdkConfig>): SdkConfig {
-  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,
-    },
-  };
-}
-
-/**
- * Helper type for deep partial objects
- */
-export type DeepPartial<T> = {
-  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};

package/src/core/SdkEventEmitter.ts

@@ -1,91 +0,0 @@
-/**
- * SDK Event Emitter
- *
- * Type-safe event emitter for SDK events.
- */
-
-import type { Message, Discussion, Contact } from '../db';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Event Types
-// ─────────────────────────────────────────────────────────────────────────────
-
-export type SdkEventType =
-  | 'message'
-  | 'messageSent'
-  | 'messageFailed'
-  | 'discussionRequest'
-  | 'discussionStatusChanged'
-  | 'sessionBroken'
-  | 'sessionRenewed'
-  | '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;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Event Emitter Class
-// ─────────────────────────────────────────────────────────────────────────────
-
-export class SdkEventEmitter {
-  private handlers = {
-    message: new Set<SdkEventHandlers['message']>(),
-    messageSent: new Set<SdkEventHandlers['messageSent']>(),
-    messageFailed: new Set<SdkEventHandlers['messageFailed']>(),
-    discussionRequest: new Set<SdkEventHandlers['discussionRequest']>(),
-    discussionStatusChanged: new Set<
-      SdkEventHandlers['discussionStatusChanged']
-    >(),
-    sessionBroken: new Set<SdkEventHandlers['sessionBroken']>(),
-    sessionRenewed: new Set<SdkEventHandlers['sessionRenewed']>(),
-    error: new Set<SdkEventHandlers['error']>(),
-  };
-
-  /**
-   * Register an event handler
-   */
-  on<K extends SdkEventType>(event: K, handler: SdkEventHandlers[K]): void {
-    (this.handlers[event] as Set<SdkEventHandlers[K]>).add(handler);
-  }
-
-  /**
-   * Remove an event handler
-   */
-  off<K extends SdkEventType>(event: K, handler: SdkEventHandlers[K]): void {
-    (this.handlers[event] as Set<SdkEventHandlers[K]>).delete(handler);
-  }
-
-  /**
-   * Emit an event to all registered handlers
-   */
-  emit<K extends SdkEventType>(
-    event: K,
-    ...args: Parameters<SdkEventHandlers[K]>
-  ): void {
-    const handlers = this.handlers[event] as Set<SdkEventHandlers[K]>;
-    handlers.forEach(handler => {
-      try {
-        (handler as (...args: Parameters<SdkEventHandlers[K]>) => void)(
-          ...args
-        );
-      } catch (error) {
-        console.error(`[SdkEventEmitter] Error in ${event} handler:`, error);
-      }
-    });
-  }
-
-  /**
-   * Remove all handlers for all events
-   */
-  clear(): void {
-    Object.values(this.handlers).forEach(set => set.clear());
-  }
-}

package/src/core/SdkPolling.ts

@@ -1,134 +0,0 @@
-/**
- * SDK Polling Manager
- *
- * Manages polling timers for messages, announcements, and session refresh.
- */
-
-import type { SdkConfig } from '../config/sdk';
-import type { Discussion } from '../db';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Types
-// ─────────────────────────────────────────────────────────────────────────────
-
-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[]>;
-  /** Called when a polling error occurs */
-  onError: (error: Error, context: string) => void;
-}
-
-interface PollingTimers {
-  messages: ReturnType<typeof setInterval> | null;
-  announcements: ReturnType<typeof setInterval> | null;
-  sessionRefresh: ReturnType<typeof setInterval> | null;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Polling Manager Class
-// ─────────────────────────────────────────────────────────────────────────────
-
-export class SdkPolling {
-  private timers: PollingTimers = {
-    messages: null,
-    announcements: null,
-    sessionRefresh: null,
-  };
-
-  private callbacks: PollingCallbacks | null = null;
-
-  /**
-   * Start polling with the given configuration and callbacks.
-   */
-  start(config: SdkConfig, callbacks: PollingCallbacks): void {
-    // Stop any existing timers first
-    this.stop();
-
-    this.callbacks = callbacks;
-
-    console.log('[SdkPolling] Starting polling', {
-      messagesIntervalMs: config.polling.messagesIntervalMs,
-      announcementsIntervalMs: config.polling.announcementsIntervalMs,
-      sessionRefreshIntervalMs: config.polling.sessionRefreshIntervalMs,
-    });
-
-    // Start message polling
-    this.timers.messages = setInterval(async () => {
-      try {
-        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'
-        );
-      }
-    }, config.polling.messagesIntervalMs);
-
-    // Start announcement polling
-    this.timers.announcements = setInterval(async () => {
-      try {
-        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'
-        );
-      }
-    }, config.polling.announcementsIntervalMs);
-
-    // 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);
-        }
-      } catch (error) {
-        console.error('[SdkPolling] Session refresh polling error:', error);
-        this.callbacks?.onError(
-          error instanceof Error ? error : new Error(String(error)),
-          'session_refresh_polling'
-        );
-      }
-    }, config.polling.sessionRefreshIntervalMs);
-  }
-
-  /**
-   * Stop all polling timers.
-   */
-  stop(): void {
-    if (this.timers.messages) {
-      clearInterval(this.timers.messages);
-      this.timers.messages = null;
-    }
-    if (this.timers.announcements) {
-      clearInterval(this.timers.announcements);
-      this.timers.announcements = null;
-    }
-    if (this.timers.sessionRefresh) {
-      clearInterval(this.timers.sessionRefresh);
-      this.timers.sessionRefresh = null;
-    }
-
-    this.callbacks = null;
-  }
-
-  /**
-   * Check if polling is currently running.
-   */
-  isRunning(): boolean {
-    return (
-      this.timers.messages !== null ||
-      this.timers.announcements !== null ||
-      this.timers.sessionRefresh !== null
-    );
-  }
-}

package/src/crypto/bip39.ts

@@ -1,84 +0,0 @@
-/**
- * BIP39 utilities for mnemonic generation, validation, and seed derivation
- * Using @scure/bip39 for browser compatibility
- */
-
-import {
-  generateMnemonic as generateMnemonicScure,
-  mnemonicToSeedSync,
-  validateMnemonic as validateMnemonicScure,
-} from '@scure/bip39';
-import { wordlist } from '@scure/bip39/wordlists/english.js';
-import { Account, PrivateKey } from '@massalabs/massa-web3';
-import varint from 'varint';
-
-export const PRIVATE_KEY_VERSION = 0;
-
-/**
- * Generate a new BIP39 mnemonic phrase
- * @param strength - Entropy strength in bits (128, 160, 192, 224, 256)
- * @returns Generated mnemonic phrase
- */
-export function generateMnemonic(strength = 256): string {
-  // @scure/bip39 generateMnemonic expects strength in bits (128, 160, 192, 224, 256)
-  return generateMnemonicScure(wordlist, strength);
-}
-
-/**
- * Validate a BIP39 mnemonic phrase
- * @param mnemonic - The mnemonic phrase to validate
- * @returns True if valid, false otherwise
- */
-export function validateMnemonic(mnemonic: string): boolean {
-  return validateMnemonicScure(mnemonic, wordlist);
-}
-
-/**
- * Generate a seed from mnemonic and optional passphrase
- * @param mnemonic - The BIP39 mnemonic phrase
- * @param passphrase - Optional passphrase (empty string if not provided)
- * @returns Uint8Array seed
- */
-export function mnemonicToSeed(
-  mnemonic: string,
-  passphrase: string = ''
-): Uint8Array {
-  return mnemonicToSeedSync(mnemonic, passphrase);
-}
-
-/**
- * Create a Massa blockchain account from a mnemonic phrase
- *
- * @param mnemonic - The BIP39 mnemonic phrase
- * @param passphrase - Optional passphrase for additional security
- * @returns Massa Account object
- * @throws Error if mnemonic is invalid
- */
-export async function accountFromMnemonic(
-  mnemonic: string,
-  passphrase?: string
-): Promise<Account> {
-  try {
-    if (!validateMnemonic(mnemonic)) {
-      throw new Error('Invalid mnemonic phrase');
-    }
-
-    const seed = mnemonicToSeed(mnemonic, passphrase);
-
-    const versionArray = varint.encode(PRIVATE_KEY_VERSION);
-
-    const privateKeyBytes = seed.slice(0, 32);
-    const privateKey = new Uint8Array([...versionArray, ...privateKeyBytes]);
-
-    const pkey = PrivateKey.fromBytes(privateKey);
-    const account = await Account.fromPrivateKey(pkey);
-    return account;
-  } catch (error) {
-    console.error('Error in accountFromMnemonic:', error);
-    console.error(
-      'Error stack:',
-      error instanceof Error ? error.stack : 'No stack'
-    );
-    throw error;
-  }
-}

package/src/crypto/encryption.ts

@@ -1,77 +0,0 @@
-/**
- * High-level encryption utilities
- *
- * Provides convenient wrappers for encrypting and decrypting strings
- * using the WASM encryption primitives.
- */
-
-import {
-  decryptAead,
-  encryptAead,
-  EncryptionKey,
-  generateNonce,
-  Nonce,
-} from '../wasm/encryption';
-
-/**
- * Encrypt a plaintext string using AES-256-SIV
- *
- * @param plaintext - The string to encrypt
- * @param key - The encryption key (64 bytes)
- * @param salt - Optional salt/nonce bytes (will generate random if not provided)
- * @returns Object containing encrypted data and nonce bytes
- */
-export async function encrypt(
-  plaintext: string,
-  key: EncryptionKey,
-  salt?: Uint8Array
-): Promise<{ encryptedData: Uint8Array; nonce: Uint8Array }> {
-  const nonce = salt ? Nonce.from_bytes(salt) : await generateNonce();
-  const encryptedData = await encryptAead(
-    key,
-    nonce,
-    new TextEncoder().encode(plaintext),
-    new Uint8Array()
-  );
-  return { encryptedData, nonce: nonce.to_bytes() };
-}
-
-/**
- * Decrypt encrypted data back to a string
- *
- * @param encryptedData - The encrypted data bytes
- * @param salt - The nonce/salt used during encryption
- * @param key - The encryption key (must match encryption key)
- * @returns The decrypted plaintext string
- * @throws Error if decryption fails (wrong key, corrupted data, etc.)
- */
-export async function decrypt(
-  encryptedData: Uint8Array,
-  salt: Uint8Array,
-  key: EncryptionKey
-): Promise<string> {
-  const plain = await decryptAead(
-    key,
-    Nonce.from_bytes(salt),
-    encryptedData,
-    new Uint8Array()
-  );
-  if (!plain) {
-    throw new Error('Failed to decrypt data');
-  }
-  return new TextDecoder().decode(plain);
-}
-
-/**
- * Derive an encryption key from a seed string and nonce
- *
- * @param seedString - The seed string (e.g., password)
- * @param nonce - The nonce/salt for key derivation
- * @returns The derived encryption key
- */
-export async function deriveKey(
-  seedString: string,
-  nonce: Uint8Array
-): Promise<EncryptionKey> {
-  return await EncryptionKey.from_seed(seedString, nonce);
-}