@msssystems/mss-link-sdk 0.1.0 → 0.1.2

package/dist/client/api-base-url.d.ts

@@ -0,0 +1 @@
+export declare function normalizeProductApiBaseUrl(apiBaseUrl: string): string;

package/dist/client/api-base-url.js

@@ -0,0 +1,10 @@
+export function normalizeProductApiBaseUrl(apiBaseUrl) {
+    const normalizedApiUrl = apiBaseUrl.replace(/\/+$/, '');
+    if (!normalizedApiUrl) {
+        return '/link/v1';
+    }
+    if (normalizedApiUrl.endsWith('/link/v1')) {
+        return normalizedApiUrl;
+    }
+    return `${normalizedApiUrl}/link/v1`;
+}

package/dist/client/client-options.d.ts

@@ -0,0 +1,11 @@
+export interface MssLinkBrowserClientOptions {
+    userId: string;
+    apiBaseUrl: string;
+    accessToken?: string | null;
+    deviceId?: number;
+    registrationId?: number;
+    signedPrekeyId?: number;
+    initialOneTimePrekeyCount?: number;
+    minOneTimePrekeys?: number;
+    replenishOneTimePrekeys?: number;
+}

package/dist/client/client-options.js

@@ -0,0 +1 @@
+export {};

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export * from './api-base-url';
+export * from './client-options';
+export * from './message.contracts';
+export * from './message.mapper';
+export * from './mss-link-browser-client';

package/dist/client/index.js

@@ -0,0 +1,5 @@
+export * from './api-base-url';
+export * from './client-options';
+export * from './message.contracts';
+export * from './message.mapper';
+export * from './mss-link-browser-client';

package/dist/client/message.contracts.d.ts

@@ -0,0 +1,20 @@
+export interface LocalSdkMessage {
+    messageId: string;
+    chatId: string;
+    senderId: string;
+    plaintext: string;
+    kind: string;
+    deliveryState: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface DecryptedMessage {
+    id: string;
+    chatId: string;
+    senderId: string;
+    text: string;
+    kind: string;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/client/message.contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/client/message.mapper.d.ts

@@ -0,0 +1,2 @@
+import type { DecryptedMessage, LocalSdkMessage } from './message.contracts';
+export declare function mapLocalSdkMessage(message: LocalSdkMessage, now?: () => string): DecryptedMessage;

package/dist/client/message.mapper.js

@@ -0,0 +1,14 @@
+export function mapLocalSdkMessage(message, now = () => new Date().toISOString()) {
+    const createdAt = message.createdAt ?? now();
+    const updatedAt = message.updatedAt ?? createdAt;
+    return {
+        id: message.messageId,
+        chatId: message.chatId,
+        senderId: message.senderId,
+        text: message.plaintext,
+        kind: message.kind,
+        status: message.deliveryState,
+        createdAt,
+        updatedAt,
+    };
+}

package/dist/client/mss-link-browser-client.d.ts

@@ -0,0 +1,31 @@
+import type { MssLinkBrowserClientOptions } from './client-options';
+import type { DecryptedMessage } from './message.contracts';
+export declare class MssLinkBrowserClient {
+    private readonly userId;
+    private readonly apiBaseUrl;
+    private readonly deviceId;
+    private readonly registrationId;
+    private readonly signedPrekeyId;
+    private readonly initialOneTimePrekeyCount;
+    private readonly minOneTimePrekeys;
+    private readonly replenishOneTimePrekeys;
+    private readonly queue;
+    private wasmClient;
+    private wasmModulePromise;
+    private accessToken;
+    constructor(options: MssLinkBrowserClientOptions);
+    setAccessToken(accessToken: string | null): void;
+    ensureReady(): Promise<void>;
+    sendMessage(params: {
+        chatId: string;
+        targetUserId: string;
+        text: string;
+        kind?: string;
+    }): Promise<string>;
+    syncMessages(): Promise<void>;
+    getLocalMessages(chatId: string): Promise<DecryptedMessage[]>;
+    reset(): void;
+    private runWithClient;
+    private getClient;
+    private loadWasmModule;
+}

package/dist/client/mss-link-browser-client.js

@@ -0,0 +1,84 @@
+import { normalizeProductApiBaseUrl } from './api-base-url';
+import { mapLocalSdkMessage } from './message.mapper';
+import { WasmCallQueue } from './wasm-call-queue';
+const DEFAULT_DEVICE_ID = 1;
+const DEFAULT_REGISTRATION_ID = 1;
+const DEFAULT_SIGNED_PREKEY_ID = 1;
+const DEFAULT_ONE_TIME_PREKEY_COUNT = 10;
+const DEFAULT_MIN_ONE_TIME_PREKEYS = 5;
+const DEFAULT_REPLENISH_ONE_TIME_PREKEYS = 10;
+export class MssLinkBrowserClient {
+    userId;
+    apiBaseUrl;
+    deviceId;
+    registrationId;
+    signedPrekeyId;
+    initialOneTimePrekeyCount;
+    minOneTimePrekeys;
+    replenishOneTimePrekeys;
+    queue = new WasmCallQueue();
+    wasmClient = null;
+    wasmModulePromise = null;
+    accessToken;
+    constructor(options) {
+        this.userId = options.userId;
+        this.apiBaseUrl = normalizeProductApiBaseUrl(options.apiBaseUrl);
+        this.accessToken = options.accessToken ?? null;
+        this.deviceId = options.deviceId ?? DEFAULT_DEVICE_ID;
+        this.registrationId =
+            options.registrationId ?? DEFAULT_REGISTRATION_ID;
+        this.signedPrekeyId =
+            options.signedPrekeyId ?? DEFAULT_SIGNED_PREKEY_ID;
+        this.initialOneTimePrekeyCount =
+            options.initialOneTimePrekeyCount ??
+                DEFAULT_ONE_TIME_PREKEY_COUNT;
+        this.minOneTimePrekeys =
+            options.minOneTimePrekeys ?? DEFAULT_MIN_ONE_TIME_PREKEYS;
+        this.replenishOneTimePrekeys =
+            options.replenishOneTimePrekeys ??
+                DEFAULT_REPLENISH_ONE_TIME_PREKEYS;
+    }
+    setAccessToken(accessToken) {
+        this.accessToken = accessToken;
+        this.wasmClient?.setAccessToken(accessToken);
+    }
+    async ensureReady() {
+        await this.runWithClient(async (client) => {
+            await client.ensureDeviceRegistered(this.registrationId, this.signedPrekeyId, this.initialOneTimePrekeyCount);
+            await client.replenishOneTimePreKeys(this.minOneTimePrekeys, this.replenishOneTimePrekeys);
+        });
+    }
+    async sendMessage(params) {
+        return this.runWithClient((client) => client.sendMessage(params.chatId, params.targetUserId, params.text, params.kind ?? 'TEXT'));
+    }
+    async syncMessages() {
+        await this.runWithClient((client) => client.syncMessages());
+    }
+    async getLocalMessages(chatId) {
+        const rawMessages = await this.runWithClient((client) => client.getLocalMessages(chatId));
+        return rawMessages.map((message) => mapLocalSdkMessage(message));
+    }
+    reset() {
+        this.wasmClient?.free();
+        this.wasmClient = null;
+        this.wasmModulePromise = null;
+    }
+    async runWithClient(callback) {
+        return this.queue.run(async () => callback(await this.getClient()));
+    }
+    async getClient() {
+        if (typeof window === 'undefined') {
+            throw new Error('MSS Link browser client is available only in browser context.');
+        }
+        if (!this.wasmClient) {
+            const sdkModule = await this.loadWasmModule();
+            this.wasmClient = new sdkModule.WasmMssClient(this.userId, this.deviceId, this.apiBaseUrl);
+            this.wasmClient.setAccessToken(this.accessToken);
+        }
+        return this.wasmClient;
+    }
+    loadWasmModule() {
+        this.wasmModulePromise ??= import('@msssystems/mss-crypto-wasm');
+        return this.wasmModulePromise;
+    }
+}

package/dist/client/wasm-call-queue.d.ts

@@ -0,0 +1,4 @@
+export declare class WasmCallQueue {
+    private queue;
+    run<T>(callback: () => Promise<T>): Promise<T>;
+}

package/dist/client/wasm-call-queue.js

@@ -0,0 +1,8 @@
+export class WasmCallQueue {
+    queue = Promise.resolve();
+    async run(callback) {
+        const run = this.queue.then(callback);
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+}

package/dist/client/wasm-client.types.d.ts

@@ -0,0 +1,6 @@
+import type { WasmMssClient } from '@msssystems/mss-crypto-wasm';
+export type WasmMssClientConstructor = new (userId: string, deviceId: number, apiBaseUrl: string) => WasmMssClient;
+export interface MssCryptoWasmModule {
+    WasmMssClient: WasmMssClientConstructor;
+}
+export type WasmMssClientInstance = WasmMssClient;

package/dist/client/wasm-client.types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './control';
+export * from './client';
 export * from './contracts/capabilities.contract';
 export * from './contracts/commands.contract';
 export * from './contracts/health.contract';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './control';
+export * from './client';
 export * from './contracts/capabilities.contract';
 export * from './contracts/commands.contract';
 export * from './contracts/health.contract';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msssystems/mss-link-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Official managed application SDK for MSS ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
     "./control": {
       "types": "./dist/control/index.d.ts",
       "import": "./dist/control/index.js"
@@ -49,12 +53,16 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
+    "@msssystems/mss-crypto-wasm": "^0.1.16",
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
     "express": "^4.0.0 || ^5.0.0",
     "rxjs": "^7.0.0"
   },
   "peerDependenciesMeta": {
+    "@msssystems/mss-crypto-wasm": {
+      "optional": true
+    },
     "@nestjs/common": {
       "optional": true
     },
@@ -69,6 +77,7 @@
     }
   },
   "devDependencies": {
+    "@msssystems/mss-crypto-wasm": "^0.1.16",
     "@nestjs/common": "^11.0.1",
     "@nestjs/core": "^11.0.1",
     "@types/express": "^5.0.0",