mezon-light-sdk 1.0.3 → 1.0.4

package/dist/client.js

@@ -1,267 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LightClient = exports.SessionError = exports.AuthenticationError = void 0;
-const session_1 = require("./session");
-const api_gen_1 = require("./api.gen");
-const constants_1 = require("./constants");
-const web_socket_adapter_pb_1 = require("./web_socket_adapter_pb");
-const socket_gen_1 = require("./socket.gen");
-/**
- * Error thrown when authentication fails.
- */
-class AuthenticationError extends Error {
-    constructor(message, statusCode) {
-        super(message ?? "Authentication failed.");
-        this.statusCode = statusCode;
-        this.name = "AuthenticationError";
-    }
-}
-exports.AuthenticationError = AuthenticationError;
-/**
- * Error thrown when session-related operations fail.
- */
-class SessionError extends Error {
-    constructor(message) {
-        super(message ?? "Session error.");
-        this.name = "SessionError";
-    }
-}
-exports.SessionError = SessionError;
-/**
- * Parses a URL and extracts client connection parameters.
- */
-function parseBaseUrl(apiUrl) {
-    const url = new URL(apiUrl);
-    const scheme = url.protocol === "https:" ? "https://" : "http://";
-    return `${scheme}${url.hostname}:${url.port}`;
-}
-/**
- * LightClient provides a simplified interface for Mezon authentication and channel management.
- *
- * @example
- * ```typescript
- * // Initialize from existing tokens
- * const client = LightClient.initClient({
- *   token: 'your-token',
- *   refresh_token: 'your-refresh-token',
- *   api_url: 'https://api.mezon.ai',
- *   user_id: 'user-123'
- * });
- *
- * // Or authenticate with ID token
- * const client = await LightClient.authenticate({
- *   id_token: 'id-token-from-provider',
- *   user_id: 'user-123',
- *   username: 'johndoe'
- * });
- * ```
- */
-class LightClient {
-    constructor(session, client, userId) {
-        /** Promise that resolves when the refresh token operation completes */
-        this.refreshTokenPromise = null;
-        this._session = session;
-        this._client = client;
-        this._userId = userId;
-    }
-    /**
-     * Gets the current user ID.
-     */
-    get userId() {
-        return this._userId;
-    }
-    /**
-     * Gets the underlying Mezon session.
-     */
-    get session() {
-        return this._session;
-    }
-    /**
-     * Gets the underlying Mezon client.
-     */
-    get client() {
-        return this._client;
-    }
-    /**
-     * Initializes a LightClient from existing session tokens.
-     * Use this when you have stored tokens from a previous authentication.
-     *
-     * @param config - Configuration containing tokens and connection details
-     * @returns A new LightClient instance
-     * @throws {SessionError} If required fields are missing
-     */
-    static initClient(config) {
-        const { token, refresh_token, api_url, user_id, serverkey } = config;
-        if (!token || !refresh_token || !api_url || !user_id) {
-            throw new SessionError("Missing required fields: token, refresh_token, api_url, and user_id are all required");
-        }
-        const session = session_1.Session.restore(token, refresh_token, api_url, true);
-        const client = new api_gen_1.MezonApi(serverkey || constants_1.DEFAULT_SERVER_KEY, 7000, parseBaseUrl(api_url));
-        return new LightClient(session, client, user_id);
-    }
-    /**
-     * Authenticates a user with an ID token from an identity provider.
-     *
-     * @param config - Authentication configuration
-     * @returns A promise that resolves to a new LightClient instance
-     * @throws {AuthenticationError} If authentication fails or response is invalid
-     */
-    static async authenticate(config) {
-        const { id_token, user_id, username, serverkey = constants_1.DEFAULT_SERVER_KEY, gateway_url = constants_1.MEZON_GW_URL } = config;
-        const client = new api_gen_1.MezonApi(serverkey || constants_1.DEFAULT_SERVER_KEY, 7000, parseBaseUrl(gateway_url));
-        const body = {
-            id_token,
-            user_id,
-            username,
-        };
-        const response = await client.authenticateIdToken(serverkey, "", body);
-        if (!response) {
-            throw new AuthenticationError("Authentication failed: No response from server.");
-        }
-        if (!response.token || !response.refresh_token || !response.api_url || !response.user_id) {
-            throw new AuthenticationError("Invalid authentication response: missing required fields");
-        }
-        const session = session_1.Session.restore(response.token, response.refresh_token, response.api_url, true);
-        client.setBasePath(parseBaseUrl(response.api_url));
-        return new LightClient(session, client, response.user_id);
-    }
-    /**
-     * Creates a direct message channel with a single user.
-     *
-     * @param peerId - The user ID to create a DM channel with
-     * @returns A promise that resolves to the created channel descriptor
-     */
-    async createDM(peerId) {
-        const request = {
-            type: constants_1.CHANNEL_TYPE_DM,
-            channel_private: 1,
-            user_ids: [peerId],
-        };
-        return this._client.createChannelDesc(this._session.token, request);
-    }
-    /**
-     * Creates a group direct message channel with multiple users.
-     *
-     * @param userIds - Array of user IDs to include in the group DM
-     * @returns A promise that resolves to the created channel descriptor
-     */
-    async createGroupDM(userIds) {
-        if (userIds.length === 0) {
-            throw new Error("At least one user ID is required for a group DM");
-        }
-        const request = {
-            type: constants_1.CHANNEL_TYPE_GROUP,
-            channel_private: 1,
-            user_ids: userIds,
-        };
-        return this._client.createChannelDesc(this._session.token, request);
-    }
-    /**
-     * Refreshes the current session using the refresh token.
-     * Call this before the session expires to maintain connectivity.
-     *
-     * @returns A promise that resolves when the session is refreshed
-     */
-    async refreshSession() {
-        if (!this._session) {
-            console.error("Cannot refresh a null session.");
-            return this._session;
-        }
-        if (this._session.created && this._session.expires_at - this._session.created_at < 70) {
-            console.warn("Session lifetime too short, please set '--session.token_expiry_sec' option. See the documentation for more info: https://mezon.vn/docs/mezon/getting-started/configuration/#session");
-        }
-        if (this._session.created && this._session.refresh_expires_at - this._session.created_at < 3700) {
-            console.warn("Session refresh lifetime too short, please set '--session.refresh_token_expiry_sec' option. See the documentation for more info: https://mezon.vn/docs/mezon/getting-started/configuration/#session");
-        }
-        if (this.refreshTokenPromise) {
-            return this.refreshTokenPromise;
-        }
-        this.refreshTokenPromise = new Promise(async (resolve, reject) => {
-            try {
-                const apiSession = await this.client.sessionRefresh(this._client.serverKey || constants_1.DEFAULT_SERVER_KEY, "", {
-                    token: this._session.refresh_token,
-                    vars: this._session.vars,
-                    is_remember: this._session.is_remember,
-                });
-                this._session.update(apiSession.token, apiSession.refresh_token, apiSession.is_remember || false);
-                this.onRefreshSession(apiSession);
-                resolve(this._session);
-            }
-            catch (error) {
-                console.error("Session refresh failed:", error);
-                reject(error);
-            }
-            finally {
-                this.refreshTokenPromise = null;
-            }
-        });
-        return this.refreshTokenPromise;
-    }
-    /** A socket created with the client's configuration. */
-    createSocket(verbose = false, adapter = new web_socket_adapter_pb_1.WebSocketAdapterPb(), sendTimeoutMs = socket_gen_1.DefaultSocket.DefaultSendTimeoutMs) {
-        const url = new URL(this._client.basePath);
-        const { host, port, useSSL } = {
-            host: url.hostname,
-            port: url.port || (url.protocol === "https:" ? "443" : "80"),
-            useSSL: url.protocol === "https:",
-        };
-        return new socket_gen_1.DefaultSocket(host, port, useSSL, verbose, adapter, sendTimeoutMs);
-    }
-    /**
-     * Called when a token refresh is initiated.
-     * This is a placeholder method that subclasses or instances can override
-     * to perform actions before or after the refresh logic.
-     */
-    onRefreshSession(session) {
-        console.log(`Token refresh occurred. Token: ${session.token}`);
-    }
-    /**
-     * Checks if the current session token has expired.
-     *
-     * @returns True if the session is expired, false otherwise
-     */
-    isSessionExpired() {
-        return this._session.isexpired(Date.now() / 1000);
-    }
-    /**
-     * Checks if the refresh token has expired.
-     * If this returns true, the user needs to re-authenticate.
-     *
-     * @returns True if the refresh token is expired, false otherwise
-     */
-    isRefreshSessionExpired() {
-        return this._session.isrefreshexpired(Date.now() / 1000);
-    }
-    /**
-     * Gets the authentication token for external use.
-     */
-    getToken() {
-        return this._session.token;
-    }
-    /**
-     * Gets the refresh token for storage.
-     */
-    getRefreshToken() {
-        return this._session.refresh_token;
-    }
-    /**
-     * Gets the current session.
-     */
-    getSession() {
-        return this.session;
-    }
-    /**
-     * Exports session data for storage and later restoration.
-     *
-     * @returns Object containing all data needed to restore the session
-     */
-    exportSession() {
-        return {
-            token: this._session.token,
-            refresh_token: this._session.refresh_token,
-            api_url: this._session.api_url || "",
-            user_id: this._userId,
-        };
-    }
-}
-exports.LightClient = LightClient;

package/dist/constants.d.ts

@@ -1,16 +0,0 @@
-/** Default Mezon Gateway URL */
-export declare const MEZON_GW_URL = "https://gw.mezon.ai";
-/** Maximum number of retries when waiting for socket to be ready */
-export declare const SOCKET_READY_MAX_RETRY = 20;
-/** Initial delay in milliseconds between socket ready retries (uses exponential backoff) */
-export declare const SOCKET_READY_RETRY_DELAY = 100;
-/** Clan ID used for Direct Messages */
-export declare const CLAN_DM = "0";
-/** Channel type for Direct Messages */
-export declare const CHANNEL_TYPE_DM = 3;
-export declare const CHANNEL_TYPE_GROUP = 2;
-/** Stream mode for Direct Messages */
-export declare const STREAM_MODE_DM = 4;
-export declare const STREAM_MODE_GROUP = 3;
-/** Default server key if none is provided */
-export declare const DEFAULT_SERVER_KEY = "DefaultServerKey";

package/dist/constants.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SERVER_KEY = exports.STREAM_MODE_GROUP = exports.STREAM_MODE_DM = exports.CHANNEL_TYPE_GROUP = exports.CHANNEL_TYPE_DM = exports.CLAN_DM = exports.SOCKET_READY_RETRY_DELAY = exports.SOCKET_READY_MAX_RETRY = exports.MEZON_GW_URL = void 0;
-/** Default Mezon Gateway URL */
-exports.MEZON_GW_URL = 'https://gw.mezon.ai';
-/** Maximum number of retries when waiting for socket to be ready */
-exports.SOCKET_READY_MAX_RETRY = 20;
-/** Initial delay in milliseconds between socket ready retries (uses exponential backoff) */
-exports.SOCKET_READY_RETRY_DELAY = 100;
-/** Clan ID used for Direct Messages */
-exports.CLAN_DM = '0';
-/** Channel type for Direct Messages */
-exports.CHANNEL_TYPE_DM = 3;
-exports.CHANNEL_TYPE_GROUP = 2;
-/** Stream mode for Direct Messages */
-exports.STREAM_MODE_DM = 4;
-exports.STREAM_MODE_GROUP = 3;
-/** Default server key if none is provided */
-exports.DEFAULT_SERVER_KEY = 'DefaultServerKey';

package/dist/google/protobuf/struct.d.ts

@@ -1,201 +0,0 @@
-import _m0 from "protobufjs/minimal";
-export declare const protobufPackage = "google.protobuf";
-/**
- * `NullValue` is a singleton enumeration to represent the null value for the
- * `Value` type union.
- *
- * The JSON representation for `NullValue` is JSON `null`.
- */
-export declare enum NullValue {
-    /** NULL_VALUE - Null value. */
-    NULL_VALUE = 0,
-    UNRECOGNIZED = -1
-}
-export declare function nullValueFromJSON(object: any): NullValue;
-export declare function nullValueToJSON(object: NullValue): string;
-/**
- * `Struct` represents a structured data value, consisting of fields
- * which map to dynamically typed values. In some languages, `Struct`
- * might be supported by a native representation. For example, in
- * scripting languages like JS a struct is represented as an
- * object. The details of that representation are described together
- * with the proto support for the language.
- *
- * The JSON representation for `Struct` is JSON object.
- */
-export interface Struct {
-    /** Unordered map of dynamically typed values. */
-    fields: {
-        [key: string]: any | undefined;
-    };
-}
-export interface Struct_FieldsEntry {
-    key: string;
-    value: any | undefined;
-}
-/**
- * `Value` represents a dynamically typed value which can be either
- * null, a number, a string, a boolean, a recursive struct value, or a
- * list of values. A producer of value is expected to set one of these
- * variants. Absence of any variant indicates an error.
- *
- * The JSON representation for `Value` is JSON value.
- */
-export interface Value {
-    /** Represents a null value. */
-    null_value?: NullValue | undefined;
-    /** Represents a double value. */
-    number_value?: number | undefined;
-    /** Represents a string value. */
-    string_value?: string | undefined;
-    /** Represents a boolean value. */
-    bool_value?: boolean | undefined;
-    /** Represents a structured value. */
-    struct_value?: {
-        [key: string]: any;
-    } | undefined;
-    /** Represents a repeated `Value`. */
-    list_value?: Array<any> | undefined;
-}
-/**
- * `ListValue` is a wrapper around a repeated field of values.
- *
- * The JSON representation for `ListValue` is JSON array.
- */
-export interface ListValue {
-    /** Repeated field of dynamically typed values. */
-    values: any[];
-}
-export declare const Struct: {
-    encode(message: Struct, writer?: _m0.Writer): _m0.Writer;
-    decode(input: _m0.Reader | Uint8Array, length?: number): Struct;
-    fromJSON(object: any): Struct;
-    toJSON(message: Struct): unknown;
-    create<I extends {
-        fields?: {
-            [x: string]: any;
-        } | undefined;
-    } & {
-        fields?: ({
-            [x: string]: any;
-        } & {
-            [x: string]: any;
-        } & { [K in Exclude<keyof I["fields"], string | number>]: never; }) | undefined;
-    } & { [K_1 in Exclude<keyof I, "fields">]: never; }>(base?: I | undefined): Struct;
-    fromPartial<I_1 extends {
-        fields?: {
-            [x: string]: any;
-        } | undefined;
-    } & {
-        fields?: ({
-            [x: string]: any;
-        } & {
-            [x: string]: any;
-        } & { [K_2 in Exclude<keyof I_1["fields"], string | number>]: never; }) | undefined;
-    } & { [K_3 in Exclude<keyof I_1, "fields">]: never; }>(object: I_1): Struct;
-    wrap(object: {
-        [key: string]: any;
-    } | undefined): Struct;
-    unwrap(message: Struct): {
-        [key: string]: any;
-    };
-};
-export declare const Struct_FieldsEntry: {
-    encode(message: Struct_FieldsEntry, writer?: _m0.Writer): _m0.Writer;
-    decode(input: _m0.Reader | Uint8Array, length?: number): Struct_FieldsEntry;
-    fromJSON(object: any): Struct_FieldsEntry;
-    toJSON(message: Struct_FieldsEntry): unknown;
-    create<I extends {
-        key?: string | undefined;
-        value?: any | undefined;
-    } & {
-        key?: string | undefined;
-        value?: any | undefined;
-    } & { [K in Exclude<keyof I, keyof Struct_FieldsEntry>]: never; }>(base?: I | undefined): Struct_FieldsEntry;
-    fromPartial<I_1 extends {
-        key?: string | undefined;
-        value?: any | undefined;
-    } & {
-        key?: string | undefined;
-        value?: any | undefined;
-    } & { [K_1 in Exclude<keyof I_1, keyof Struct_FieldsEntry>]: never; }>(object: I_1): Struct_FieldsEntry;
-};
-export declare const Value: {
-    encode(message: Value, writer?: _m0.Writer): _m0.Writer;
-    decode(input: _m0.Reader | Uint8Array, length?: number): Value;
-    fromJSON(object: any): Value;
-    toJSON(message: Value): unknown;
-    create<I extends {
-        null_value?: NullValue | undefined;
-        number_value?: number | undefined;
-        string_value?: string | undefined;
-        bool_value?: boolean | undefined;
-        struct_value?: {
-            [x: string]: any;
-        } | undefined;
-        list_value?: any[] | undefined;
-    } & {
-        null_value?: NullValue | undefined;
-        number_value?: number | undefined;
-        string_value?: string | undefined;
-        bool_value?: boolean | undefined;
-        struct_value?: ({
-            [x: string]: any;
-        } & {
-            [x: string]: any;
-        } & { [K in Exclude<keyof I["struct_value"], string | number>]: never; }) | undefined;
-        list_value?: (any[] & any[] & { [K_1 in Exclude<keyof I["list_value"], keyof any[]>]: never; }) | undefined;
-    } & { [K_2 in Exclude<keyof I, keyof Value>]: never; }>(base?: I | undefined): Value;
-    fromPartial<I_1 extends {
-        null_value?: NullValue | undefined;
-        number_value?: number | undefined;
-        string_value?: string | undefined;
-        bool_value?: boolean | undefined;
-        struct_value?: {
-            [x: string]: any;
-        } | undefined;
-        list_value?: any[] | undefined;
-    } & {
-        null_value?: NullValue | undefined;
-        number_value?: number | undefined;
-        string_value?: string | undefined;
-        bool_value?: boolean | undefined;
-        struct_value?: ({
-            [x: string]: any;
-        } & {
-            [x: string]: any;
-        } & { [K_3 in Exclude<keyof I_1["struct_value"], string | number>]: never; }) | undefined;
-        list_value?: (any[] & any[] & { [K_4 in Exclude<keyof I_1["list_value"], keyof any[]>]: never; }) | undefined;
-    } & { [K_5 in Exclude<keyof I_1, keyof Value>]: never; }>(object: I_1): Value;
-    wrap(value: any): Value;
-    unwrap(message: any): string | number | boolean | Object | null | Array<any> | undefined;
-};
-export declare const ListValue: {
-    encode(message: ListValue, writer?: _m0.Writer): _m0.Writer;
-    decode(input: _m0.Reader | Uint8Array, length?: number): ListValue;
-    fromJSON(object: any): ListValue;
-    toJSON(message: ListValue): unknown;
-    create<I extends {
-        values?: any[] | undefined;
-    } & {
-        values?: (any[] & any[] & { [K in Exclude<keyof I["values"], keyof any[]>]: never; }) | undefined;
-    } & { [K_1 in Exclude<keyof I, "values">]: never; }>(base?: I | undefined): ListValue;
-    fromPartial<I_1 extends {
-        values?: any[] | undefined;
-    } & {
-        values?: (any[] & any[] & { [K_2 in Exclude<keyof I_1["values"], keyof any[]>]: never; }) | undefined;
-    } & { [K_3 in Exclude<keyof I_1, "values">]: never; }>(object: I_1): ListValue;
-    wrap(array: Array<any> | undefined): ListValue;
-    unwrap(message: ListValue): Array<any>;
-};
-type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
-export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : Partial<T>;
-type KeysOfUnion<T> = T extends T ? keyof T : never;
-export type Exact<P, I extends P> = P extends Builtin ? P : P & {
-    [K in keyof P]: Exact<P[K], I[K]>;
-} & {
-    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
-};
-export {};