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

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Gossip SDK
+ *
+ * Main entry point for the Gossip SDK.
+ * Provides a platform-agnostic interface for automation, chatbot,
+ * and integration use cases with the Gossip messenger.
+ *
+ * @example
+ * ```typescript
+ * import { gossipSdk } from 'gossip-sdk';
+ *
+ * // Initialize once at app startup
+ * await gossipSdk.init({
+ *   db,
+ *   protocolBaseUrl: 'https://api.example.com',
+ * });
+ *
+ * // Open session (login)
+ * await gossipSdk.openSession({ mnemonic: '...' });
+ *
+ * // Use clean API
+ * await gossipSdk.messages.send(contactId, 'Hello!');
+ * await gossipSdk.discussions.start(contact);
+ *
+ * // Events
+ * gossipSdk.on('message', (msg) => { ... });
+ *
+ * // Logout
+ * await gossipSdk.closeSession();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export declare const SDK_VERSION = "0.0.1";
+export { gossipSdk, GossipSdkImpl } from './gossipSdk';
+export type { GossipSdkInitOptions, OpenSessionOptions, SdkEventType, SdkEventHandlers, } from './gossipSdk';
+export type { GossipSdkEvents } from './types/events';
+export { AuthService } from './services/auth';
+export type { PublicKeyResult } from './services/auth';
+export { getPublicKeyErrorMessage, PUBLIC_KEY_NOT_FOUND_ERROR, PUBLIC_KEY_NOT_FOUND_MESSAGE, FAILED_TO_FETCH_ERROR, FAILED_TO_FETCH_MESSAGE, FAILED_TO_RETRIEVE_CONTACT_PUBLIC_KEY_ERROR, } from './services/auth';
+export { AnnouncementService, EstablishSessionError, } from './services/announcement';
+export type { AnnouncementReceptionResult } from './services/announcement';
+export { MessageService } from './services/message';
+export type { MessageResult, SendMessageResult } from './services/message';
+export { DiscussionService } from './services/discussion';
+export { RefreshService } from './services/refresh';
+export { getContacts, getContact, addContact, updateContactName, deleteContact, } from './contacts';
+export type { UpdateContactNameResult, DeleteContactResult, } from './utils/contacts';
+export { updateDiscussionName } from './utils/discussions';
+export type { UpdateDiscussionNameResult } from './utils/discussions';
+export * from './types';
+export { createMessageProtocol, restMessageProtocol, RestMessageProtocol, MessageProtocol, } from './api/messageProtocol';
+export type { IMessageProtocol, EncryptedMessage, MessageProtocolResponse, BulletinItem, } from './api/messageProtocol';
+export { setProtocolBaseUrl, resetProtocolBaseUrl, MessageProtocolType, protocolConfig, } from './config/protocol';
+export type { ProtocolConfig } from './config/protocol';
+export { defaultSdkConfig, mergeConfig } from './config/sdk';
+export type { SdkConfig, PollingConfig, MessagesConfig, AnnouncementsConfig, DeepPartial, } from './config/sdk';
+export { setDb, getDb, db, GossipDatabase } from './db';
+export { SessionModule, sessionStatusToString } from './wasm/session';
+export { initializeWasm, ensureWasmInitialized, startWasmInitialization, } from './wasm/loader';
+export { EncryptionKey, Nonce, generateEncryptionKey, generateEncryptionKeyFromSeed, encryptionKeyFromBytes, generateNonce, nonceFromBytes, encryptAead, decryptAead, } from './wasm/encryption';
+export { generateUserKeys } from './wasm/userKeys';
+export { encodeUserId, decodeUserId, isValidUserId, formatUserId, generate as generateUserId, } from './utils/userId';
+export { validateUsernameFormat, validatePassword, validateUserIdFormat, validateUsernameAvailability, validateUsernameFormatAndAvailability, } from './utils/validation';
+export type { ValidationResult } from './utils/validation';
+export { encodeToBase64, decodeFromBase64, encodeToBase64Url, decodeFromBase64Url, } from './utils/base64';
+export type { Result } from './utils/type';
+export { MESSAGE_TYPE_KEEP_ALIVE, serializeKeepAliveMessage, serializeRegularMessage, serializeReplyMessage, serializeForwardMessage, deserializeMessage, } from './utils/messageSerialization';
+export type { DeserializedMessage } from './utils/messageSerialization';
+export { generateMnemonic, validateMnemonic, mnemonicToSeed, accountFromMnemonic, PRIVATE_KEY_VERSION, } from './crypto/bip39';
+export { encrypt, decrypt, deriveKey } from './crypto/encryption';
+export { UserPublicKeys, UserSecretKeys, SessionStatus, SessionConfig, SessionManagerWrapper, SendMessageOutput, ReceiveMessageOutput, AnnouncementResult, generate_user_keys, } from './assets/generated/wasm/gossip_wasm';
+export { UserKeys } from './wasm/userKeys';

package/dist/index.js

@@ -0,0 +1,77 @@
+/**
+ * Gossip SDK
+ *
+ * Main entry point for the Gossip SDK.
+ * Provides a platform-agnostic interface for automation, chatbot,
+ * and integration use cases with the Gossip messenger.
+ *
+ * @example
+ * ```typescript
+ * import { gossipSdk } from 'gossip-sdk';
+ *
+ * // Initialize once at app startup
+ * await gossipSdk.init({
+ *   db,
+ *   protocolBaseUrl: 'https://api.example.com',
+ * });
+ *
+ * // Open session (login)
+ * await gossipSdk.openSession({ mnemonic: '...' });
+ *
+ * // Use clean API
+ * await gossipSdk.messages.send(contactId, 'Hello!');
+ * await gossipSdk.discussions.start(contact);
+ *
+ * // Events
+ * gossipSdk.on('message', (msg) => { ... });
+ *
+ * // Logout
+ * await gossipSdk.closeSession();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// SDK version - matches package.json
+export const SDK_VERSION = '0.0.1';
+// ─────────────────────────────────────────────────────────────────────────────
+// SDK Singleton - Primary API
+// ─────────────────────────────────────────────────────────────────────────────
+export { gossipSdk, GossipSdkImpl } from './gossipSdk';
+// Services - class-based with dependency injection
+export { AuthService } from './services/auth';
+export { getPublicKeyErrorMessage, PUBLIC_KEY_NOT_FOUND_ERROR, PUBLIC_KEY_NOT_FOUND_MESSAGE, FAILED_TO_FETCH_ERROR, FAILED_TO_FETCH_MESSAGE, FAILED_TO_RETRIEVE_CONTACT_PUBLIC_KEY_ERROR, } from './services/auth';
+export { AnnouncementService, EstablishSessionError, } from './services/announcement';
+export { MessageService } from './services/message';
+export { DiscussionService } from './services/discussion';
+export { RefreshService } from './services/refresh';
+// Contact Management (utility functions)
+export { getContacts, getContact, addContact, updateContactName, deleteContact, } from './contacts';
+// Discussion utilities
+export { updateDiscussionName } from './utils/discussions';
+// Types - re-export all types from the types module
+export * from './types';
+// Message Protocol - for direct use by host apps
+export { createMessageProtocol, restMessageProtocol, RestMessageProtocol, MessageProtocol, } from './api/messageProtocol';
+// Config - for runtime configuration
+export { setProtocolBaseUrl, resetProtocolBaseUrl, MessageProtocolType, protocolConfig, } from './config/protocol';
+// SDK Config - for SDK initialization options
+export { defaultSdkConfig, mergeConfig } from './config/sdk';
+// Database - for direct access by host apps
+export { setDb, getDb, db, GossipDatabase } from './db';
+// WASM utilities - for session management
+export { SessionModule, sessionStatusToString } from './wasm/session';
+export { initializeWasm, ensureWasmInitialized, startWasmInitialization, } from './wasm/loader';
+export { EncryptionKey, Nonce, generateEncryptionKey, generateEncryptionKeyFromSeed, encryptionKeyFromBytes, generateNonce, nonceFromBytes, encryptAead, decryptAead, } from './wasm/encryption';
+export { generateUserKeys } from './wasm/userKeys';
+// Utility functions - for direct use
+export { encodeUserId, decodeUserId, isValidUserId, formatUserId, generate as generateUserId, } from './utils/userId';
+export { validateUsernameFormat, validatePassword, validateUserIdFormat, validateUsernameAvailability, validateUsernameFormatAndAvailability, } from './utils/validation';
+export { encodeToBase64, decodeFromBase64, encodeToBase64Url, decodeFromBase64Url, } from './utils/base64';
+// Message serialization utilities
+export { MESSAGE_TYPE_KEEP_ALIVE, serializeKeepAliveMessage, serializeRegularMessage, serializeReplyMessage, serializeForwardMessage, deserializeMessage, } from './utils/messageSerialization';
+// Crypto utilities
+export { generateMnemonic, validateMnemonic, mnemonicToSeed, accountFromMnemonic, PRIVATE_KEY_VERSION, } from './crypto/bip39';
+export { encrypt, decrypt, deriveKey } from './crypto/encryption';
+// WASM types and functions re-exported for convenience
+export { UserPublicKeys, UserSecretKeys, SessionStatus, SessionConfig, SessionManagerWrapper, SendMessageOutput, ReceiveMessageOutput, AnnouncementResult, generate_user_keys, } from './assets/generated/wasm/gossip_wasm';
+export { UserKeys } from './wasm/userKeys';

package/dist/services/announcement.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Announcement Service
+ *
+ * Handles broadcasting and processing of session announcements.
+ */
+import { type Discussion, type GossipDatabase } from '../db';
+import { IMessageProtocol } from '../api/messageProtocol';
+import { UserPublicKeys } from '../assets/generated/wasm/gossip_wasm';
+import { SessionModule } from '../wasm/session';
+import { GossipSdkEvents } from '../types/events';
+import { SdkConfig } from '../config/sdk';
+export interface AnnouncementReceptionResult {
+    success: boolean;
+    newAnnouncementsCount: number;
+    error?: string;
+}
+export declare const EstablishSessionError = "Session manager failed to establish outgoing session";
+export declare class AnnouncementService {
+    private db;
+    private messageProtocol;
+    private session;
+    private isProcessingAnnouncements;
+    private events;
+    private config;
+    constructor(db: GossipDatabase, messageProtocol: IMessageProtocol, session: SessionModule, events?: GossipSdkEvents, config?: SdkConfig);
+    setMessageProtocol(messageProtocol: IMessageProtocol): void;
+    sendAnnouncement(announcement: Uint8Array): Promise<{
+        success: boolean;
+        counter?: string;
+        error?: string;
+    }>;
+    establishSession(contactPublicKeys: UserPublicKeys, userData?: Uint8Array): Promise<{
+        success: boolean;
+        error?: string;
+        announcement: Uint8Array;
+    }>;
+    fetchAndProcessAnnouncements(): Promise<AnnouncementReceptionResult>;
+    resendAnnouncements(failedDiscussions: Discussion[]): Promise<void>;
+    private _fetchAnnouncements;
+    private _generateTemporaryContactName;
+    private _processIncomingAnnouncement;
+    private _handleReceivedDiscussion;
+}