dolphin-server-modules 2.12.1 → 2.12.2

package/README.md

@@ -14,6 +14,7 @@
 Dolphin Framework को विस्तृत र आधिकारिक गाइड उपलब्ध छ। यसमा **Auth, CRUD, Models, र Controllers** को १००% ट्युटोरियल समावेश छ।
 
 👉 **[Dolphin Master Guide (Web Version)](https://raw.githack.com/Phuyalshankar/dolphin-server-modules/main/guide.html)** *(Most Up-to-Date)*
+👉 **[Dolphin Client Tutorial (Nepali) - MD](./CLIENT_TUTORIAL_NEPALI.md)** | **[PDF Version](./CLIENT_TUTORIAL_NEPALI.pdf)**
 
 ---
 

package/dist/client/api.d.ts

@@ -0,0 +1,24 @@
+export declare class APIHandler {
+    /** @param {DolphinClient} client */
+    constructor(client: any);
+    /** @private */
+    _createProxy(pathParts: any): {
+        (options: any): any;
+        get(pathOrOptions: any, options: any): any;
+        post(pathOrBody: any, bodyOrOptions: any, options: any): any;
+        put(pathOrBody: any, bodyOrOptions: any, options: any): any;
+        patch(pathOrBody: any, bodyOrOptions: any, options: any): any;
+        del(pathOrOptions: any, options: any): any;
+        request(method: any, subPath: any, body: any, options: any): any;
+    };
+    /**
+     * Make an HTTP request with timeout + auto token refresh.
+     * @param {string}      method
+     * @param {string}      path
+     * @param {any}         [body]
+     * @param {RequestInit} [options]
+     * @param {boolean}     [_isRetry=false]   — internal: prevent infinite refresh loop
+     * @returns {Promise<any>}
+     */
+    request(method: any, path: any, body?: null, options?: {}): any;
+}

package/dist/client/api.js

@@ -0,0 +1,113 @@
+export class APIHandler {
+    /** @param {DolphinClient} client */
+    constructor(client) {
+        this.client = client;
+        return this._createProxy([]);
+    }
+    /** @private */
+    _createProxy(pathParts) {
+        const joined = pathParts.join('/');
+        const target = (options) => this.request('GET', joined, null, options);
+        target.get = (pathOrOptions, options) => typeof pathOrOptions === 'string'
+            ? this.request('GET', pathOrOptions, null, options)
+            : this.request('GET', joined, null, pathOrOptions);
+        target.post = (pathOrBody, bodyOrOptions, options) => typeof pathOrBody === 'string'
+            ? this.request('POST', pathOrBody, bodyOrOptions, options)
+            : this.request('POST', joined, pathOrBody, bodyOrOptions);
+        target.put = (pathOrBody, bodyOrOptions, options) => typeof pathOrBody === 'string'
+            ? this.request('PUT', pathOrBody, bodyOrOptions, options)
+            : this.request('PUT', joined, pathOrBody, bodyOrOptions);
+        target.patch = (pathOrBody, bodyOrOptions, options) => typeof pathOrBody === 'string'
+            ? this.request('PATCH', pathOrBody, bodyOrOptions, options)
+            : this.request('PATCH', joined, pathOrBody, bodyOrOptions);
+        target.del = (pathOrOptions, options) => typeof pathOrOptions === 'string'
+            ? this.request('DELETE', pathOrOptions, null, options)
+            : this.request('DELETE', joined, null, pathOrOptions);
+        target.request = (method, subPath, body, options) => {
+            const finalPath = subPath
+                ? `${joined}/${subPath.startsWith('/') ? subPath.slice(1) : subPath}`
+                : joined;
+            return this.request(method, finalPath, body, options);
+        };
+        const methods = ['get', 'post', 'put', 'patch', 'del', 'request'];
+        return new Proxy(target, {
+            get: (t, prop) => {
+                if (typeof prop === 'string' && !methods.includes(prop)) {
+                    return this._createProxy([...pathParts, prop]);
+                }
+                return t[prop];
+            }
+        });
+    }
+    /**
+     * Make an HTTP request with timeout + auto token refresh.
+     * @param {string}      method
+     * @param {string}      path
+     * @param {any}         [body]
+     * @param {RequestInit} [options]
+     * @param {boolean}     [_isRetry=false]   — internal: prevent infinite refresh loop
+     * @returns {Promise<any>}
+     */
+    async request(method, path, body = null, options = {}) {
+        const _isRetry = options._isRetry === true;
+        const url = `${this.client.httpUrl}${path.startsWith('/') ? path : '/' + path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.client.options.timeout);
+        const headers = {
+            'Content-Type': 'application/json',
+            ...(options.headers || {}),
+        };
+        if (this.client.accessToken) {
+            headers['Authorization'] = `Bearer ${this.client.accessToken}`;
+        }
+        const fetchOptions = { ...options };
+        delete fetchOptions._isRetry;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                signal: controller.signal,
+                ...(body ? { body: JSON.stringify(body) } : {}),
+                ...fetchOptions,
+            });
+            clearTimeout(timeoutId);
+            // Auto-refresh: 401 + not a retry + autoRefreshToken enabled
+            if (response.status === 401 &&
+                !_isRetry &&
+                this.client.options.autoRefreshToken) {
+                const refreshed = await this.client.auth._silentRefresh();
+                if (refreshed) {
+                    return this.request(method, path, body, { ...options, _isRetry: true });
+                }
+            }
+            const contentType = response.headers.get('content-type') || '';
+            const data = contentType.includes('application/json')
+                ? await response.json()
+                : await response.text();
+            if (!response.ok)
+                throw { status: response.status, data };
+            // Hookless auth token auto-save
+            if (data && typeof data === 'object') {
+                if (data.accessToken) {
+                    this.client.setToken(data.accessToken);
+                    if (data.user)
+                        this.client.auth.user = data.user;
+                }
+            }
+            // Auto-broadcast data changes
+            if (this.client.options.autoBroadcast && ['POST', 'PUT', 'PATCH', 'DELETE'].includes(method.toUpperCase())) {
+                const cleanPath = path.startsWith('/') ? path.substring(1) : path;
+                this.client.publish(cleanPath, { method: method.toUpperCase(), payload: body, result: data });
+            }
+            return data;
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err.name === 'AbortError') {
+                throw { status: 408, data: { error: 'Request timed out' } };
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/client/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/client/api.ts"],"names":[],"mappings":"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"}

package/dist/client/auth.d.ts

@@ -0,0 +1,53 @@
+export declare class AuthHandler {
+    /** @param {DolphinClient} client */
+    constructor(client: any);
+    /**
+     * Login with email + password.
+     * @param {string} email
+     * @param {string} password
+     */
+    login(email: any, password: any): Promise<any>;
+    /**
+     * Register a new account.
+     * @param {{ email: string, password: string, [key: string]: any }} data
+     */
+    register(data: any): Promise<any>;
+    /** Get current user profile. */
+    me(): Promise<any>;
+    /** Logout and clear token. */
+    logout(): Promise<void>;
+    /**
+     * Manually refresh the access token using the httpOnly refresh-token cookie.
+     * Called automatically on 401 if autoRefreshToken is enabled.
+     * @returns {Promise<boolean>} — true if refresh succeeded
+     */
+    refresh(): Promise<boolean>;
+    /** @private */
+    _silentRefresh(): Promise<boolean>;
+    /**
+     * Verify a 2FA TOTP code after login.
+     * @param {string} code     — 6-digit TOTP code
+     * @param {string} [email]  — email (if not already in user)
+     */
+    verify2FA(code: any, email: any): Promise<any>;
+    /**
+     * Enable 2FA — returns QR code URL and secret.
+     */
+    enable2FA(): Promise<any>;
+    /**
+     * Disable 2FA.
+     * @param {string} code — current TOTP code to confirm
+     */
+    disable2FA(code: any): Promise<any>;
+    /**
+     * Request a password reset email.
+     * @param {string} email
+     */
+    forgotPassword(email: any): Promise<any>;
+    /**
+     * Reset password using the token from email.
+     * @param {string} token
+     * @param {string} newPassword
+     */
+    resetPassword(token: any, newPassword: any): Promise<any>;
+}

package/dist/client/auth.js

@@ -0,0 +1,121 @@
+export class AuthHandler {
+    /** @param {DolphinClient} client */
+    constructor(client) {
+        this.client = client;
+        /** @type {any|null} */
+        this.user = null;
+        this._refreshing = false;
+    }
+    /**
+     * Login with email + password.
+     * @param {string} email
+     * @param {string} password
+     */
+    async login(email, password) {
+        const res = await this.client.api.post('/api/auth/login', { email, password });
+        if (res.accessToken) {
+            this.client.setToken(res.accessToken);
+            this.user = res.user || null;
+        }
+        return res;
+    }
+    /**
+     * Register a new account.
+     * @param {{ email: string, password: string, [key: string]: any }} data
+     */
+    async register(data) {
+        return this.client.api.post('/api/auth/register', data);
+    }
+    /** Get current user profile. */
+    async me() {
+        const res = await this.client.api.get('/api/auth/me');
+        if (res.success)
+            this.user = res.data;
+        return res;
+    }
+    /** Logout and clear token. */
+    async logout() {
+        try {
+            await this.client.api.post('/api/auth/logout');
+        }
+        catch { }
+        this.client.setToken(null);
+        this.user = null;
+    }
+    /**
+     * Manually refresh the access token using the httpOnly refresh-token cookie.
+     * Called automatically on 401 if autoRefreshToken is enabled.
+     * @returns {Promise<boolean>} — true if refresh succeeded
+     */
+    async refresh() {
+        return this._silentRefresh();
+    }
+    /** @private */
+    async _silentRefresh() {
+        if (this._refreshing)
+            return false;
+        this._refreshing = true;
+        try {
+            const res = await this.client.api.post('/api/auth/refresh', null, { _isRetry: true });
+            if (res.accessToken) {
+                this.client.setToken(res.accessToken);
+                return true;
+            }
+            return false;
+        }
+        catch {
+            this.client.setToken(null);
+            return false;
+        }
+        finally {
+            this._refreshing = false;
+        }
+    }
+    /**
+     * Verify a 2FA TOTP code after login.
+     * @param {string} code     — 6-digit TOTP code
+     * @param {string} [email]  — email (if not already in user)
+     */
+    async verify2FA(code, email) {
+        const payload = {
+            code,
+            email: email || this.user?.email,
+        };
+        const res = await this.client.api.post('/api/auth/2fa/verify', payload);
+        if (res.accessToken) {
+            this.client.setToken(res.accessToken);
+            if (res.user)
+                this.user = res.user;
+        }
+        return res;
+    }
+    /**
+     * Enable 2FA — returns QR code URL and secret.
+     */
+    async enable2FA() {
+        return this.client.api.post('/api/auth/2fa/enable');
+    }
+    /**
+     * Disable 2FA.
+     * @param {string} code — current TOTP code to confirm
+     */
+    async disable2FA(code) {
+        return this.client.api.post('/api/auth/2fa/disable', { code });
+    }
+    /**
+     * Request a password reset email.
+     * @param {string} email
+     */
+    async forgotPassword(email) {
+        return this.client.api.post('/api/auth/forgot-password', { email });
+    }
+    /**
+     * Reset password using the token from email.
+     * @param {string} token
+     * @param {string} newPassword
+     */
+    async resetPassword(token, newPassword) {
+        return this.client.api.post('/api/auth/reset-password', { token, newPassword });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"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"}

package/dist/client/core.d.ts

@@ -0,0 +1,97 @@
+export declare class DolphinClient {
+    constructor(url?: string, deviceId?: string, options?: {});
+    /** Save or clear the access token */
+    setToken(token: any): void;
+    /** Connect to the Dolphin realtime server */
+    connect(): Promise<unknown>;
+    /** Disconnect cleanly */
+    disconnect(): void;
+    /** @private */
+    _handleMessage(data: any): void;
+    /** @private */
+    _dispatch(pattern: any, payload: any, topic: any): void;
+    /** @private */
+    _sendRaw(msg: any): void;
+    /** Flush buffered messages after reconnect @private */
+    _flushOfflineQueue(): void;
+    /** @private */
+    _sendAck(to: any, msgId: any): void;
+    /** MQTT wildcard topic matching @private */
+    _matchTopic(pattern: any, topic: any): boolean;
+    /** @private */
+    _maybeReconnect(): void;
+    /**
+     * Subscribe to a topic (MQTT wildcards supported: + and #).
+     * @param {string}        topic
+     * @param {TopicCallback} callback
+     */
+    subscribe(topic: any, callback: any): void;
+    /**
+     * Unsubscribe from a topic.
+     * @param {string}        topic
+     * @param {TopicCallback} callback
+     */
+    unsubscribe(topic: any, callback: any): void;
+    /**
+     * Publish a message to a topic. Queued if offline.
+     * @param {string} topic
+     * @param {any}    payload
+     */
+    publish(topic: any, payload: any): void;
+    /**
+     * High-frequency data push (IoT sensors).
+     * @param {string} topic
+     * @param {any}    payload
+     */
+    pubPush(topic: any, payload: any): void;
+    /**
+     * Request historical data from a topic.
+     * @param {string} topic
+     * @param {number} [count=10]
+     */
+    subPull(topic: any, count?: number): void;
+    /**
+     * Upload a file to the server in chunks.
+     * @param {string}   fileId
+     * @param {Blob|ArrayBuffer|Uint8Array} fileData
+     * @param {string}   [filename]
+     * @param {function(number): void} [onProgress]  — progress callback (0-100)
+     * @returns {Promise<void>}
+     */
+    pubFile(fileId: any, fileData: any, filename: string | undefined, onProgress: any): Promise<void>;
+    /** @private */
+    _uint8ToBase64(uint8: any): string;
+    /**
+     * Download a file from the server by chunks.
+     * @param {string} fileId
+     * @param {number} [startChunk=0]
+     */
+    subFile(fileId: any, startChunk?: number): void;
+    /**
+     * Resume a file download from saved progress.
+     * @param {string} fileId
+     */
+    resumeFile(fileId: any): void;
+    /**
+     * Save download chunk progress.
+     * @param {string} fileId
+     * @param {number} chunkIndex
+     */
+    saveFileProgress(fileId: any, chunkIndex: any): void;
+    /**
+     * @param {function(SignalMessage): void} handler
+     */
+    onSignal(handler: any): void;
+    /**
+     * @param {function(SignalMessage): void} handler
+     */
+    offSignal(handler: any): void;
+    /**
+     * @param {function(FileMetadata): void} handler
+     */
+    onFileAvailable(handler: any): void;
+    /**
+     * @param {function(FileMetadata): void} handler
+     */
+    offFileAvailable(handler: any): void;
+}