@massalabs/gossip-sdk 0.0.2-dev.20260507171428 → 0.0.2-dev.20260513170310

package/dist/api/restClient.js

@@ -1,7 +1,4 @@
-/**
- * Base REST client with retry and timeout support.
- * Shared by RestMessageProtocol and RestAuthProtocol.
- */
+import { logger } from '../utils/logs.js';
 export class RestClient {
     constructor(baseUrl, timeout = 10000, retryAttempts = 3) {
         Object.defineProperty(this, "baseUrl", {
@@ -42,7 +39,7 @@ export class RestClient {
             }
             catch (error) {
                 lastError = error;
-                console.warn(`Request attempt ${attempt} failed:`, error);
+                logger.warn(`Request attempt ${attempt} failed:`, error);
                 if (attempt < this.retryAttempts) {
                     const delay = Math.pow(2, attempt) * 1000;
                     await new Promise(resolve => setTimeout(resolve, delay));

package/dist/core/SdkEventEmitter.d.ts

@@ -1,6 +1,3 @@
-/**
- * SDK Event Emitter — type-safe event bus backed by mitt.
- */
 import type { Message, Discussion, Contact } from '../db';
 import type { SessionStatus } from '../wasm/bindings';
 export declare enum SdkEventType {

package/dist/core/SdkEventEmitter.js

@@ -1,3 +1,4 @@
+import { logger } from '../utils/logs.js';
 /**
  * SDK Event Emitter — type-safe event bus backed by mitt.
  */
@@ -44,7 +45,7 @@ export class SdkEventEmitter {
                     handler(payload);
                 }
                 catch (error) {
-                    console.error(`[SdkEventEmitter] Error in ${String(event)} handler:`, error);
+                    logger.error(`[SdkEventEmitter] Error in ${String(event)} handler:`, error);
                 }
             }
         }

package/dist/core/SdkPolling.js

@@ -1,8 +1,4 @@
-/**
- * SDK Polling Manager
- *
- * Manages polling timers for messages, announcements, and session refresh.
- */
+import { logger } from '../utils/logs.js';
 import { SdkEventType } from './SdkEventEmitter.js';
 const SESSION_STATUS_POLL_INTERVAL_MS = 3000;
 // ─────────────────────────────────────────────────────────────────────────────
@@ -42,7 +38,7 @@ export class SdkPolling {
         this.stop();
         this.callbacks = callbacks;
         this.eventEmitter = eventEmitter;
-        console.log('[SdkPolling] Starting polling', {
+        logger.info('[SdkPolling] Starting polling', {
             messagesIntervalMs: config.polling.messagesIntervalMs,
             announcementsIntervalMs: config.polling.announcementsIntervalMs,
             sessionRefreshIntervalMs: config.polling.sessionRefreshIntervalMs,

package/dist/crypto/bip39.d.ts

@@ -1,7 +1,3 @@
-/**
- * BIP39 utilities for mnemonic generation, validation, and seed derivation
- * Using @scure/bip39 for browser compatibility
- */
 import { Account } from '@massalabs/massa-web3';
 export declare const PRIVATE_KEY_VERSION = 0;
 /**

package/dist/crypto/bip39.js

@@ -1,3 +1,4 @@
+import { logger } from '../utils/logs.js';
 /**
  * BIP39 utilities for mnemonic generation, validation, and seed derivation
  * Using @scure/bip39 for browser compatibility
@@ -55,8 +56,8 @@ export async function accountFromMnemonic(mnemonic, passphrase) {
         return account;
     }
     catch (error) {
-        console.error('Error in accountFromMnemonic:', error);
-        console.error('Error stack:', error instanceof Error ? error.stack : 'No stack');
+        logger.error('Error in accountFromMnemonic:', error);
+        logger.error('Error stack:', error instanceof Error ? error.stack : 'No stack');
         throw error;
     }
 }

package/dist/db/secure-storage-worker.d.ts

@@ -39,7 +39,7 @@ export declare class SecureStorageWorkerApi {
      * tick cannot overlap with itself, but the explicit `cover()` RPC
      * could be called concurrently by the SDK consumer).
      *
-     * PD-critical: errors are logged at `console.debug` only. Logging
+     * PD-critical: errors are logged at `logger.debug` only. Logging
      * at error level fingerprinted "secure-storage user with persistent
      * storage failure" in console history. Errors do not change the
      * scheduling cadence either: backing off would itself leak ("cover

package/dist/db/secure-storage-worker.js

@@ -1,3 +1,4 @@
+import { logger } from '../utils/logs.js';
 /**
  * Web worker that hosts the secure-storage WASM module and runs SQL on
  * the embedded sqlite-wasm-rs SQLite, routing main DB I/O through our
@@ -61,7 +62,7 @@ export class SecureStorageWorkerApi {
      * tick cannot overlap with itself, but the explicit `cover()` RPC
      * could be called concurrently by the SDK consumer).
      *
-     * PD-critical: errors are logged at `console.debug` only. Logging
+     * PD-critical: errors are logged at `logger.debug` only. Logging
      * at error level fingerprinted "secure-storage user with persistent
      * storage failure" in console history. Errors do not change the
      * scheduling cadence either: backing off would itself leak ("cover
@@ -81,7 +82,7 @@ export class SecureStorageWorkerApi {
             await flushEncrypted();
         }
         catch (err) {
-            console.debug('[SecureStorage] cover traffic tick failed', err);
+            logger.debug('[SecureStorage] cover traffic tick failed', err);
         }
         finally {
             this.coverTickInProgress = false;

package/dist/db/sqlite.d.ts

@@ -1,16 +1,3 @@
-/**
- * SQLite initialization module for the Gossip SDK.
- *
- * Uses wa-sqlite (WASM) with Drizzle ORM's sqlite-proxy driver.
- * Four execution paths:
- *   - Browser/OPFS (opfsPath set): Web Worker + AccessHandlePoolVFS — fast, single-tab.
- *   - Browser/IDB (idbName set): Web Worker + IDBBatchAtomicVFS — multi-tab safe.
- *   - Node.js file (path set): In-process + NodeFsVFS — file persistence via node:fs.
- *   - In-memory (tests): :memory: in-process — no persistence, fast, isolated.
- *
- * Each GossipSdk instance owns a DatabaseConnection, allowing multiple
- * independent SDK instances in the same process.
- */
 import { type SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
 import * as schema from './schema/index.js';
 export { SQL_NAMESPACE, SESSION_BLOB_NAMESPACE, SESSION_COUNT, } from './secure-storage-namespaces.js';

package/dist/db/sqlite.js

@@ -1,3 +1,4 @@
+import { logger } from '../utils/logs.js';
 /**
  * SQLite initialization module for the Gossip SDK.
  *
@@ -354,7 +355,7 @@ export class DatabaseConnection {
                         this.state.nativePlugin = null;
                         this.state.useNativePlugin = false;
                         if (import.meta.env?.DEV) {
-                            console.warn('[secureStorage] native plugin unavailable, falling back to WASM worker');
+                            logger.warn('[secureStorage] native plugin unavailable, falling back to WASM worker');
                         }
                     }
                     if (SecureStorageNative) {

package/dist/gossip.js

@@ -1,3 +1,4 @@
+import { logger } from './utils/logs.js';
 /**
  * GossipSdk - SDK with clean lifecycle API
  *
@@ -205,12 +206,12 @@ class GossipSdk {
     async init(options) {
         if (this.state.status !== SdkStatus.UNINITIALIZED) {
             if (import.meta.env?.DEV) {
-                console.warn('[GossipSdk] Already initialized');
+                logger.warn('[GossipSdk] Already initialized');
             }
             return this;
         }
         if (import.meta.env?.DEV) {
-            console.log('[GossipSdk] Initializing SDK');
+            logger.info('[GossipSdk] Initializing SDK');
         }
         // Merge config with defaults
         const config = mergeConfig(options.config);
@@ -222,7 +223,7 @@ class GossipSdk {
         // Start WASM initialization
         startWasmInitialization();
         if (import.meta.env?.DEV) {
-            console.log('[GossipSdk] Initializing SQLite');
+            logger.info('[GossipSdk] Initializing SQLite');
         }
         this._conn = await DatabaseConnection.create({ storage: options.storage });
         // Defer queries/profile when the database needs an unlock first.
@@ -230,7 +231,7 @@ class GossipSdk {
             this._queries = new Queries(this._conn);
         }
         if (import.meta.env?.DEV) {
-            console.log('[GossipSdk] SQLite initialized');
+            logger.info('[GossipSdk] SQLite initialized');
         }
         // Create message protocol
         const messageProtocol = createMessageProtocol();
@@ -817,7 +818,7 @@ class GossipSdk {
      */
     startPolling() {
         if (this.state.status !== SdkStatus.SESSION_OPEN) {
-            console.warn('[GossipSdk] Cannot start polling - no session open');
+            logger.warn('[GossipSdk] Cannot start polling - no session open');
             return;
         }
         const { config } = this.state;
@@ -876,9 +877,10 @@ class GossipSdk {
         if (this.state.status !== SdkStatus.SESSION_OPEN)
             return;
         // A/B test escape hatch: skip the entire pipeline if the debug flag
-        // is set in the dev console. WARNING: if the app crashes/reloads
-        // while this is on, the session state is lost. Gated on DEV so that
-        // a production XSS cannot silently disable session persistence.
+        // is set from browser developer tools. WARNING: if the app
+        // crashes/reloads while this is on, the session state is lost. Gated
+        // on DEV so that a production XSS cannot silently disable session
+        // persistence.
         if (import.meta.env?.DEV &&
             typeof globalThis !== 'undefined' &&
             globalThis
@@ -1049,11 +1051,11 @@ class GossipSdk {
                 });
             }
             if (stuck.length > 0 && import.meta.env?.DEV) {
-                console.log(`[GossipSdk] Reset ${stuck.length} stuck SENDING message(s) to WAITING_SESSION for auto-retry`);
+                logger.info(`[GossipSdk] Reset ${stuck.length} stuck SENDING message(s) to WAITING_SESSION for auto-retry`);
             }
         }
         catch (error) {
-            console.error('[GossipSdk] Failed to reset stuck messages:', error);
+            logger.error('[GossipSdk] Failed to reset stuck messages:', error);
         }
     }
 }

package/dist/utils/contacts.d.ts

@@ -1,8 +1,3 @@
-/**
- * Contact Utilities
- *
- * Functions for managing contacts including updating names and deleting contacts.
- */
 import type { SessionModule } from '../wasm/session.js';
 import type { UserPublicKeys } from '../wasm/bindings.js';
 import type { Contact } from '../db/index.js';

package/dist/utils/contacts.js

@@ -1,3 +1,4 @@
+import { logger } from './logs.js';
 /**
  * Contact Utilities
  *
@@ -43,7 +44,7 @@ export async function updateContactName(ownerUserId, contactUserId, newName, que
         return { success: true, trimmedName: trimmed };
     }
     catch (e) {
-        console.error('updateContactName failed', e);
+        logger.error('updateContactName failed', e);
         return {
             success: false,
             reason: 'error',
@@ -88,7 +89,7 @@ export async function deleteContact(ownerUserId, contactUserId, session, queries
         return { success: true };
     }
     catch (e) {
-        console.error('deleteContact failed', e);
+        logger.error('deleteContact failed', e);
         return {
             success: false,
             reason: 'error',
@@ -118,7 +119,7 @@ export async function addContact(ownerUserId, userId, name, publicKeys, queries)
         return { success: true, contact: newContact ?? undefined };
     }
     catch (error) {
-        console.error('Error adding contact:', error);
+        logger.error('Error adding contact:', error);
         return {
             success: false,
             error: error instanceof Error ? error.message : 'Unknown error',

package/dist/utils/discussions.js

@@ -1,3 +1,4 @@
+import { logger } from './logs.js';
 /**
  * Discussion Utilities
  *
@@ -30,7 +31,7 @@ export async function updateDiscussionPin(discussionId, pinned, queries) {
         return { success: true };
     }
     catch (e) {
-        console.error('updateDiscussionPin failed', e);
+        logger.error('updateDiscussionPin failed', e);
         return {
             success: false,
             message: 'Failed to update pin. Please try again.',
@@ -62,7 +63,7 @@ export async function updateDiscussionName(discussionId, newName, queries) {
         return { success: true, trimmedName: customName ?? undefined };
     }
     catch (e) {
-        console.error('updateDiscussionName failed', e);
+        logger.error('updateDiscussionName failed', e);
         return {
             success: false,
             reason: 'error',

package/dist/utils/index.d.ts

@@ -2,6 +2,7 @@ export * from './announcementPayload.js';
 export * from './base64.js';
 export * from './contacts.js';
 export * from './discussions.js';
+export * from './logs.js';
 export * from './queue.js';
 export * from './type.js';
 export * from './userId.js';

package/dist/utils/index.js

@@ -2,6 +2,7 @@ export * from './announcementPayload.js';
 export * from './base64.js';
 export * from './contacts.js';
 export * from './discussions.js';
+export * from './logs.js';
 export * from './queue.js';
 export * from './type.js';
 export * from './userId.js';

package/dist/utils/logs.d.ts

@@ -1,9 +1,29 @@
 /**
- * Logger utility for SDK
+ * Shared logger utility for app + SDK runtime code.
  *
- * Provides structured console logging with module and context support.
- * All output goes to the terminal via console methods.
+ * Production safety rule: logs are emitted only through configured sinks.
+ * Release builds configure no sinks, so logging calls are inert without
+ * relying on minifier console stripping.
  */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type LogSink = (level: LogLevel, message: unknown, args: readonly unknown[]) => void;
+export interface LoggerConfig {
+    enabled: boolean;
+    minLevel: LogLevel;
+    persist: boolean;
+}
+export declare function configureLogging(next: Partial<LoggerConfig>): void;
+export declare function getLoggingConfig(): LoggerConfig;
+export declare function setLogSinks(nextSinks: LogSink[]): void;
+export declare function addLogSink(sink: LogSink): void;
+export declare function resetLoggingForTests(): void;
+export declare const logger: {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    child: (scope: string) => Logger;
+};
 export declare class Logger {
     private module;
     private context;

package/dist/utils/logs.js

@@ -1,9 +1,57 @@
 /**
- * Logger utility for SDK
+ * Shared logger utility for app + SDK runtime code.
  *
- * Provides structured console logging with module and context support.
- * All output goes to the terminal via console methods.
+ * Production safety rule: logs are emitted only through configured sinks.
+ * Release builds configure no sinks, so logging calls are inert without
+ * relying on minifier console stripping.
  */
+const LEVEL_RANK = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const DEFAULT_CONFIG = {
+    enabled: false,
+    minLevel: 'error',
+    persist: false,
+};
+let config = { ...DEFAULT_CONFIG };
+let sinks = [];
+function shouldLog(level) {
+    return config.enabled && LEVEL_RANK[level] >= LEVEL_RANK[config.minLevel];
+}
+function emit(level, args) {
+    if (!shouldLog(level))
+        return;
+    const message = args[0];
+    for (const sink of sinks) {
+        sink(level, message, args);
+    }
+}
+export function configureLogging(next) {
+    config = { ...config, ...next };
+}
+export function getLoggingConfig() {
+    return { ...config };
+}
+export function setLogSinks(nextSinks) {
+    sinks = [...nextSinks];
+}
+export function addLogSink(sink) {
+    sinks = [...sinks, sink];
+}
+export function resetLoggingForTests() {
+    config = { ...DEFAULT_CONFIG };
+    sinks = [];
+}
+export const logger = {
+    debug: (...args) => emit('debug', args),
+    info: (...args) => emit('info', args),
+    warn: (...args) => emit('warn', args),
+    error: (...args) => emit('error', args),
+    child: (scope) => new Logger(scope),
+};
 export class Logger {
     constructor(module, context = '') {
         Object.defineProperty(this, "module", {
@@ -31,17 +79,17 @@ export class Logger {
     info(message, extra) {
         const main = this.formatMainMessage(message);
         if (extra !== undefined) {
-            console.log(main, extra);
+            logger.info(main, extra);
         }
         else {
-            console.log(main);
+            logger.info(main);
         }
     }
     error(messageOrError, extra) {
         const source = this.getSource();
         if (messageOrError instanceof Error) {
             const main = `[${source}] ${messageOrError.message}`;
-            console.error(main, messageOrError, extra);
+            logger.error(main, messageOrError, extra);
         }
         else {
             const message = typeof messageOrError === 'string'
@@ -49,29 +97,29 @@ export class Logger {
                 : JSON.stringify(messageOrError);
             const main = `[${source}] ${message}`;
             if (extra !== undefined) {
-                console.error(main, extra);
+                logger.error(main, extra);
             }
             else {
-                console.error(main);
+                logger.error(main);
             }
         }
     }
     debug(message, extra) {
         const main = this.formatMainMessage(message);
         if (extra !== undefined) {
-            console.debug(main, extra);
+            logger.debug(main, extra);
         }
         else {
-            console.debug(main);
+            logger.debug(main);
         }
     }
     warn(message, extra) {
         const main = this.formatMainMessage(message);
         if (extra !== undefined) {
-            console.warn(main, extra);
+            logger.warn(main, extra);
         }
         else {
-            console.warn(main);
+            logger.warn(main);
         }
     }
     // Chainable context builder

package/dist/wasm/loader.d.ts

@@ -1,11 +1,3 @@
-/**
- * WASM Module Loader and Initialization Service
- *
- * This file handles WASM initialization. It uses a single web-target build
- * and detects the runtime to load the WASM binary appropriately:
- * - Browser: init() with no args (uses import.meta.url + fetch internally)
- * - Node.js / Jiti: init(bytes) with WASM bytes read from the filesystem
- */
 /**
  * Initialize WASM modules if not already initialized
  * This function is idempotent - safe to call multiple times

package/dist/wasm/loader.js

@@ -1,3 +1,4 @@
+import { logger } from '../utils/logs.js';
 /**
  * WASM Module Loader and Initialization Service
  *
@@ -66,7 +67,7 @@ export async function initializeWasm() {
         catch (error) {
             initError = error;
             isInitializing = false;
-            console.error('[WASM] Failed to initialize WASM modules:', error);
+            logger.error('[WASM] Failed to initialize WASM modules:', error);
             throw error;
         }
     })();
@@ -91,6 +92,6 @@ export async function ensureWasmInitialized() {
 export function startWasmInitialization() {
     // Fire and forget - start initialization in background
     initializeWasm().catch(error => {
-        console.error('[WASM] Background initialization error:', error);
+        logger.error('[WASM] Background initialization error:', error);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massalabs/gossip-sdk",
-  "version": "0.0.2-dev.20260507171428",
+  "version": "0.0.2-dev.20260513170310",
   "description": "Gossip SDK for automation, chatbot, and integration use cases",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,6 +17,10 @@
     "./sw": {
       "types": "./dist/sw.d.ts",
       "import": "./dist/sw.js"
+    },
+    "./utils/logs.js": {
+      "types": "./dist/utils/logs.d.ts",
+      "import": "./dist/utils/logs.js"
     }
   },
   "scripts": {