@massalabs/gossip-sdk 0.0.2-dev.20260210150149 → 0.0.2-dev.20260211110128

package/dist/gossipSdk.d.ts

@@ -48,6 +48,7 @@ import type { DeleteContactResult, UpdateContactNameResult } from './utils/conta
 import { type ValidationResult } from './utils/validation';
 import type { UserPublicKeys } from './wasm/bindings';
 import { type SdkEventType, type SdkEventHandlers } from './core/SdkEventEmitter';
+import { AnnouncementPayload } from './utils/announcementPayload';
 export type { SdkEventType, SdkEventHandlers };
 export interface GossipSdkInitOptions {
     /** Database instance */
@@ -210,7 +211,7 @@ interface MessageServiceAPI {
 }
 interface DiscussionServiceAPI {
     /** Start a new discussion with a contact */
-    start(contact: Contact, message?: string): Promise<{
+    start(contact: Contact, payload: AnnouncementPayload): Promise<{
         discussionId: number;
         announcement: Uint8Array;
     }>;

package/dist/gossipSdk.js

@@ -322,7 +322,7 @@ class GossipSdkImpl {
             findBySeeker: (seeker, ownerUserId) => this._message.findMessageBySeeker(seeker, ownerUserId),
         };
         this._discussionsAPI = {
-            start: (contact, message) => this._discussion.initialize(contact, message),
+            start: (contact, payload) => this._discussion.initialize(contact, payload),
             accept: discussion => this._discussion.accept(discussion),
             renew: contactUserId => this._discussion.renew(contactUserId),
             isStable: (ownerUserId, contactUserId) => this._discussion.isStableState(ownerUserId, contactUserId),

package/dist/index.d.ts

@@ -35,6 +35,8 @@ export { getContacts, getContact, addContact, updateContactName, deleteContact,
 export type { UpdateContactNameResult, DeleteContactResult, } from './utils/contacts';
 export { updateDiscussionName } from './utils/discussions';
 export type { UpdateDiscussionNameResult } from './utils/discussions';
+export { encodeAnnouncementPayload, decodeAnnouncementPayload, } from './utils/announcementPayload';
+export type { AnnouncementPayload } from './utils/announcementPayload';
 export * from './types';
 export { createMessageProtocol, restMessageProtocol, RestMessageProtocol, MessageProtocol, } from './api/messageProtocol';
 export type { IMessageProtocol, EncryptedMessage, MessageProtocolResponse, BulletinItem, } from './api/messageProtocol';

package/dist/index.js

@@ -34,6 +34,8 @@ export { RefreshService } from './services/refresh';
 export { getContacts, getContact, addContact, updateContactName, deleteContact, } from './contacts';
 // Discussion utilities
 export { updateDiscussionName } from './utils/discussions';
+// Announcement payload helpers
+export { encodeAnnouncementPayload, decodeAnnouncementPayload, } from './utils/announcementPayload';
 // Types
 export * from './types';
 // Message Protocol

package/dist/services/announcement.d.ts

@@ -29,7 +29,7 @@ export declare class AnnouncementService {
         counter?: string;
         error?: string;
     }>;
-    establishSession(contactPublicKeys: UserPublicKeys, userData?: Uint8Array): Promise<{
+    establishSession(contactPublicKeys: UserPublicKeys, payloadBytes?: Uint8Array): Promise<{
         success: boolean;
         error?: string;
         announcement: Uint8Array;

package/dist/services/announcement.js

@@ -9,6 +9,7 @@ import { SessionStatus } from '../wasm/bindings';
 import { sessionStatusToString } from '../wasm/session';
 import { Logger } from '../utils/logs';
 import { defaultSdkConfig } from '../config/sdk';
+import { decodeAnnouncementPayload } from '../utils/announcementPayload';
 const logger = new Logger('AnnouncementService');
 export const EstablishSessionError = 'Session manager failed to establish outgoing session';
 export class AnnouncementService {
@@ -73,11 +74,11 @@ export class AnnouncementService {
             };
         }
     }
-    async establishSession(contactPublicKeys, userData) {
+    async establishSession(contactPublicKeys, payloadBytes) {
         const log = logger.forMethod('establishSession');
         const contactUserId = encodeUserId(contactPublicKeys.derive_id());
         // CRITICAL: await to ensure session state is persisted before sending
-        const announcement = await this.session.establishOutgoingSession(contactPublicKeys, userData);
+        const announcement = await this.session.establishOutgoingSession(contactPublicKeys, payloadBytes);
         if (announcement.length === 0) {
             log.error('empty announcement returned', { contactUserId });
             return {
@@ -367,51 +368,7 @@ export class AnnouncementService {
             return { success: true };
         }
         log.info('announcement intended for us — decrypting');
-        let rawMessage;
-        if (result.user_data?.length > 0) {
-            try {
-                rawMessage = new TextDecoder().decode(result.user_data);
-            }
-            catch (error) {
-                log.error('failed to decode user data', error);
-            }
-        }
-        // Parse announcement message format:
-        // - JSON format: {"u":"username","m":"message"} (current)
-        // - Legacy colon format: "username:message" (backwards compat)
-        // - Plain text: "message" (oldest format)
-        // The username is used as the initial contact name if present.
-        // TODO: Remove legacy colon and plain text format support once all clients are updated
-        let extractedUsername;
-        let announcementMessage;
-        if (rawMessage) {
-            // Try JSON format first (starts with '{')
-            if (rawMessage.startsWith('{')) {
-                try {
-                    const parsed = JSON.parse(rawMessage);
-                    extractedUsername = parsed.u?.trim() || undefined;
-                    announcementMessage = parsed.m?.trim() || undefined;
-                }
-                catch {
-                    // Invalid JSON, treat as plain text
-                    announcementMessage = rawMessage;
-                }
-            }
-            else {
-                // Legacy format: check for colon separator
-                const colonIndex = rawMessage.indexOf(':');
-                if (colonIndex !== -1) {
-                    extractedUsername =
-                        rawMessage.slice(0, colonIndex).trim() || undefined;
-                    announcementMessage =
-                        rawMessage.slice(colonIndex + 1).trim() || undefined;
-                }
-                else {
-                    // Plain text (oldest format)
-                    announcementMessage = rawMessage;
-                }
-            }
-        }
+        const { username, message } = decodeAnnouncementPayload(result.user_data);
         const announcerPkeys = result.announcer_public_keys;
         const contactUserIdRaw = announcerPkeys.derive_id();
         const contactUserId = encodeUserId(contactUserIdRaw);
@@ -426,7 +383,7 @@ export class AnnouncementService {
         const isNewContact = !contact;
         if (isNewContact) {
             // Use extracted username if present, otherwise generate temporary name
-            const name = extractedUsername ||
+            const name = username ||
                 (await this._generateTemporaryContactName(this.session.userIdEncoded));
             await this.db.contacts.add({
                 ownerUserId: this.session.userIdEncoded,
@@ -445,7 +402,7 @@ export class AnnouncementService {
             log.error('contact lookup failed after creation');
             throw new Error('Could not find or create contact');
         }
-        const { discussionId } = await this._handleReceivedDiscussion(this.session.userIdEncoded, contactUserId, announcementMessage);
+        const { discussionId } = await this._handleReceivedDiscussion(this.session.userIdEncoded, contactUserId, message);
         // Emit event for new discussion request
         if (this.events.onDiscussionRequest) {
             const discussion = await this.db.discussions.get(discussionId);

package/dist/services/discussion.d.ts

@@ -6,6 +6,7 @@
 import { type Discussion, type Contact, type GossipDatabase } from '../db';
 import { AnnouncementService } from './announcement';
 import { SessionModule } from '../wasm/session';
+import { AnnouncementPayload } from '../utils/announcementPayload';
 import { GossipSdkEvents } from '../types/events';
 /**
  * Service for managing discussions between users.
@@ -33,10 +34,21 @@ export declare class DiscussionService {
     /**
      * Initialize a discussion with a contact using SessionManager
      * @param contact - The contact to start a discussion with
-     * @param message - Optional message to include in the announcement
+     * @param payload - Optional payload to include in the announcement (username and message)
      * @returns The discussion ID and the created announcement
+     *
+     * @example
+     * ```ts
+     * const payload: AnnouncementPayload = {
+     *   username: 'alice',
+     *   message: 'Hello!',
+     * };
+     *
+     * const { discussionId, announcement } =
+     *   await discussionService.initialize(contact, payload);
+     * ```
      */
-    initialize(contact: Contact, message?: string): Promise<{
+    initialize(contact: Contact, payload?: AnnouncementPayload): Promise<{
         discussionId: number;
         announcement: Uint8Array;
     }>;

package/dist/services/discussion.js

@@ -8,6 +8,7 @@ import { UserPublicKeys, SessionStatus } from '../wasm/bindings';
 import { EstablishSessionError } from './announcement';
 import { sessionStatusToString } from '../wasm/session';
 import { decodeUserId } from '../utils/userId';
+import { encodeAnnouncementPayload, } from '../utils/announcementPayload';
 import { Logger } from '../utils/logs';
 const logger = new Logger('DiscussionService');
 /**
@@ -61,19 +62,29 @@ export class DiscussionService {
     /**
      * Initialize a discussion with a contact using SessionManager
      * @param contact - The contact to start a discussion with
-     * @param message - Optional message to include in the announcement
+     * @param payload - Optional payload to include in the announcement (username and message)
      * @returns The discussion ID and the created announcement
+     *
+     * @example
+     * ```ts
+     * const payload: AnnouncementPayload = {
+     *   username: 'alice',
+     *   message: 'Hello!',
+     * };
+     *
+     * const { discussionId, announcement } =
+     *   await discussionService.initialize(contact, payload);
+     * ```
      */
-    async initialize(contact, message) {
+    async initialize(contact, payload) {
         const log = logger.forMethod('initialize');
         try {
             const userId = this.session.userIdEncoded;
-            // Encode message as UTF-8 if provided
-            const userData = message
-                ? new TextEncoder().encode(message)
-                : new Uint8Array(0);
-            log.info(`${userId} is establishing session with contact ${contact.name}`);
-            const result = await this.announcementService.establishSession(UserPublicKeys.from_bytes(contact.publicKeys), userData);
+            let payloadBytes;
+            if (payload) {
+                payloadBytes = encodeAnnouncementPayload(payload.username, payload.message);
+            }
+            const result = await this.announcementService.establishSession(UserPublicKeys.from_bytes(contact.publicKeys), payloadBytes);
             let status = DiscussionStatus.PENDING;
             if (!result.success) {
                 log.error(`Failed to establish session with contact ${contact.name}, got error: ${result.error}`);
@@ -85,26 +96,6 @@ export class DiscussionService {
             else {
                 log.info(`session established with contact and announcement sent: ${result.announcement.length}... bytes`);
             }
-            // Parse announcement message to extract only the actual message content.
-            // The message parameter may be JSON format: {"u":"username","m":"message"}
-            // We only want to store the "m" (message) field, not the full JSON.
-            let parsedAnnouncementMessage;
-            if (message) {
-                if (message.startsWith('{')) {
-                    try {
-                        const parsed = JSON.parse(message);
-                        parsedAnnouncementMessage = parsed.m?.trim() || undefined;
-                    }
-                    catch {
-                        // Invalid JSON, treat as plain text
-                        parsedAnnouncementMessage = message;
-                    }
-                }
-                else {
-                    parsedAnnouncementMessage = message;
-                }
-            }
-            // Persist discussion immediately with the announcement for reliable retry
             const discussionId = await this.db.discussions.add({
                 ownerUserId: userId,
                 contactUserId: contact.userId,
@@ -112,7 +103,7 @@ export class DiscussionService {
                 status: status,
                 nextSeeker: undefined,
                 initiationAnnouncement: result.announcement,
-                announcementMessage: parsedAnnouncementMessage,
+                announcementMessage: payload?.message,
                 unreadCount: 0,
                 createdAt: new Date(),
                 updatedAt: new Date(),

package/dist/utils/announcementPayload.d.ts

@@ -0,0 +1,6 @@
+export interface AnnouncementPayload {
+    username?: string;
+    message?: string;
+}
+export declare const encodeAnnouncementPayload: (username?: string, message?: string) => Uint8Array | undefined;
+export declare const decodeAnnouncementPayload: (data?: Uint8Array) => AnnouncementPayload;

package/dist/utils/announcementPayload.js

@@ -0,0 +1,23 @@
+import { Args } from '@massalabs/massa-web3';
+export const encodeAnnouncementPayload = (username, message) => {
+    const u = username?.trim() || '';
+    const m = message?.trim() || '';
+    if (!u && !m) {
+        return undefined;
+    }
+    return new Args().addString(u).addString(m).serialize();
+};
+export const decodeAnnouncementPayload = (data) => {
+    if (!data) {
+        return { username: undefined, message: undefined };
+    }
+    try {
+        const args = new Args(data);
+        const username = args.nextString() || undefined;
+        const message = args.nextString() || undefined;
+        return { username, message };
+    }
+    catch {
+        return { username: undefined, message: undefined };
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massalabs/gossip-sdk",
-  "version": "0.0.2-dev.20260210150149",
+  "version": "0.0.2-dev.20260211110128",
   "description": "Gossip SDK for automation, chatbot, and integration use cases",
   "type": "module",
   "main": "./dist/index.js",