dolphin-server-modules 2.11.7 → 2.11.9

package/dist/utils/adapters.d.ts

@@ -0,0 +1,14 @@
+/**
+ * HTTP Adapters for Express and Fastify
+ * Maps native requests/responses to Dolphin's standard ctx structure.
+ */
+/**
+ * Express Adapter
+ * Maps (req, res, next) to Dolphin's standard ctx structure.
+ */
+export declare function toExpress(handler: Function): (req: any, res: any, next: any) => Promise<void>;
+/**
+ * Fastify Adapter
+ * Maps (request, reply) to Dolphin's standard ctx structure.
+ */
+export declare function toFastify(handler: Function): (request: any, reply: any) => Promise<void>;

package/dist/utils/adapters.js

@@ -0,0 +1,116 @@
+/**
+ * HTTP Adapters for Express and Fastify
+ * Maps native requests/responses to Dolphin's standard ctx structure.
+ */
+/**
+ * Express Adapter
+ * Maps (req, res, next) to Dolphin's standard ctx structure.
+ */
+export function toExpress(handler) {
+    return async (req, res, next) => {
+        let pendingStatus = 200;
+        const ctx = {
+            req,
+            res,
+            params: req.params || {},
+            query: req.query || {},
+            body: req.body || {},
+            state: res.locals || {},
+            json: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                res.status(finalStatus).json(data);
+                return ctx;
+            },
+            text: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                res.status(finalStatus).send(String(data));
+                return ctx;
+            },
+            html: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                res.status(finalStatus).send(String(data));
+                return ctx;
+            },
+            status: (code) => {
+                pendingStatus = code;
+                return ctx;
+            },
+            setHeader: (name, value) => {
+                res.setHeader(name, value);
+                return ctx;
+            },
+            getHeader: (name) => {
+                return req.headers[name.toLowerCase()];
+            }
+        };
+        try {
+            // If the handler is a middleware and takes next
+            if (handler.length >= 2) {
+                await handler(ctx, next);
+            }
+            else {
+                const result = await handler(ctx);
+                // If the handler returned a response directly instead of calling ctx.json()
+                if (result !== undefined && result !== null && !res.headersSent) {
+                    ctx.json(result);
+                }
+            }
+        }
+        catch (err) {
+            next(err);
+        }
+    };
+}
+/**
+ * Fastify Adapter
+ * Maps (request, reply) to Dolphin's standard ctx structure.
+ */
+export function toFastify(handler) {
+    return async (request, reply) => {
+        let pendingStatus = 200;
+        const ctx = {
+            req: request.raw,
+            res: reply.raw,
+            params: request.params || {},
+            query: request.query || {},
+            body: request.body || {},
+            state: request.state || {},
+            json: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                reply.status(finalStatus).send(data);
+                return ctx;
+            },
+            text: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                reply.status(finalStatus).type('text/plain').send(String(data));
+                return ctx;
+            },
+            html: (data, status) => {
+                const finalStatus = status !== undefined ? status : pendingStatus;
+                reply.status(finalStatus).type('text/html').send(String(data));
+                return ctx;
+            },
+            status: (code) => {
+                pendingStatus = code;
+                return ctx;
+            },
+            setHeader: (name, value) => {
+                reply.header(name, value);
+                return ctx;
+            },
+            getHeader: (name) => {
+                return request.headers[name.toLowerCase()];
+            }
+        };
+        try {
+            const result = await handler(ctx);
+            if (result !== undefined && result !== null && !reply.sent) {
+                ctx.json(result);
+            }
+        }
+        catch (err) {
+            reply.send(err);
+        }
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/utils/adapters.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dolphin-server-modules",
-  "version": "2.11.7",
+  "version": "2.11.9",
   "type": "module",
   "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
   "description": "Core utility modules for Auth, CRUD, and Controllers",

package/scripts/client.js

@@ -52,6 +52,7 @@
  * @property {number} [chunkSize=65536]      — file upload chunk size (bytes)
  * @property {number} [maxReconnect=5]       — max WebSocket reconnect attempts
  * @property {boolean} [autoRefreshToken=true] — auto-refresh expired access token
+ * @property {boolean} [autoBroadcast=false]   — auto-publish non-GET API requests to realtime
  */
 
 // ─── APIHandler ───────────────────────────────────────────────────────────────
@@ -168,6 +169,13 @@ class APIHandler {
                 : await response.text();
 
             if (!response.ok) throw { status: response.status, data };
+
+            // Auto Realtime Broadcast (Dual-Execution)
+            if (this.client.options.autoBroadcast && method !== 'GET') {
+                const topic = path.startsWith('/') ? path.slice(1) : path;
+                this.client.publish(topic, { method, payload: body, result: data });
+            }
+
             return data;
 
         } catch (err) {
@@ -473,6 +481,7 @@ class DolphinClient {
             chunkSize:        65536,   // 64 KB
             maxReconnect:     5,
             autoRefreshToken: true,
+            autoBroadcast:    false,
             ...options,
         };
 
@@ -505,6 +514,14 @@ class DolphinClient {
         this._offlineQueue  = [];
 
         this.reconnectAttempts = 0;
+
+        if (typeof window !== 'undefined') {
+            if (document.readyState === 'loading') {
+                document.addEventListener('DOMContentLoaded', () => this._initDOMBinding());
+            } else {
+                this._initDOMBinding();
+            }
+        }
     }
 
     /** Save or clear the access token */
@@ -822,6 +839,124 @@ class DolphinClient {
      * @param {function(FileMetadata): void} handler
      */
     offFileAvailable(handler) { this.fileHandlers.delete(handler); }
+
+    // ── DOM Binding (Hookless Realtime) ───────────────────────────────────────
+
+    /** @private */
+    _initDOMBinding() {
+        if (this._domInitialized) return;
+        this._domInitialized = true;
+
+        // 1. Listen for inputs
+        document.addEventListener('input', (e) => {
+            if (!e.target || !e.target.getAttribute) return;
+            const topic = e.target.getAttribute('data-rt-push');
+            if (topic) {
+                const payload = { name: e.target.name, value: e.target.value };
+                this.pubPush(topic, payload);
+            }
+        });
+
+        // 2. Listen for form submits (RT + API)
+        document.addEventListener('submit', async (e) => {
+            if (!e.target || !e.target.getAttribute) return;
+            
+            const rtTopic = e.target.getAttribute('data-rt-submit');
+            const apiTarget = e.target.getAttribute('data-api-submit');
+            
+            if (rtTopic || apiTarget) {
+                e.preventDefault();
+                const formData = new FormData(e.target);
+                const data = Object.fromEntries(formData.entries());
+                
+                if (rtTopic) {
+                    this.publish(rtTopic, data);
+                } else if (apiTarget) {
+                    const parts = apiTarget.trim().split(' ');
+                    const method = parts.length > 1 ? parts[0].toUpperCase() : 'POST';
+                    const path = parts.length > 1 ? parts[1] : parts[0];
+                    try {
+                        const result = await this.api.request(method, path, data);
+                        const resultBind = e.target.getAttribute('data-api-result');
+                        if (resultBind) this._updateDOM(resultBind, result);
+                    } catch (err) {
+                        console.error('[Dolphin] API Submit Error:', err);
+                    }
+                }
+            }
+        });
+
+        // 3. Listen for clicks (RT + API)
+        document.addEventListener('click', async (e) => {
+            if (!e.target || !e.target.closest) return;
+            
+            const rtBtn = e.target.closest('[data-rt-click]');
+            const apiBtn = e.target.closest('[data-api-click]');
+            
+            if (rtBtn) {
+                const topic = rtBtn.getAttribute('data-rt-click');
+                const actionData = rtBtn.getAttribute('data-rt-payload');
+                const payload = actionData ? JSON.parse(actionData) : {};
+                this.publish(topic, payload);
+            } else if (apiBtn) {
+                const apiTarget = apiBtn.getAttribute('data-api-click');
+                const actionData = apiBtn.getAttribute('data-api-payload');
+                const payload = actionData ? JSON.parse(actionData) : null;
+                const parts = apiTarget.trim().split(' ');
+                const method = parts.length > 1 ? parts[0].toUpperCase() : 'POST';
+                const path = parts.length > 1 ? parts[1] : parts[0];
+                try {
+                    const result = await this.api.request(method, path, payload);
+                    const resultBind = apiBtn.getAttribute('data-api-result');
+                    if (resultBind) this._updateDOM(resultBind, result);
+                } catch (err) {
+                    console.error('[Dolphin] API Click Error:', err);
+                }
+            }
+        });
+
+        // 4. Update DOM when RT data arrives
+        // Note: Subscribe to all topics ('#') to auto-update DOM bindings
+        this.subscribe('#', (payload, topic) => {
+            this._updateDOM(topic, payload);
+        });
+
+        // 5. Auto-fetch API GET bindings
+        this._scanAndFetchAPIBinds();
+    }
+
+    /** @private */
+    async _scanAndFetchAPIBinds() {
+        if (typeof document === 'undefined') return;
+        const elements = document.querySelectorAll('[data-api-get]');
+        for (const el of elements) {
+            const path = el.getAttribute('data-api-get');
+            if (!path) continue;
+            try {
+                const result = await this.api.get(path);
+                if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+                    el.value = typeof result === 'object' ? (result.value !== undefined ? result.value : '') : result;
+                } else {
+                    el.innerHTML = typeof result === 'object' ? (result.html || result.text || JSON.stringify(result)) : result;
+                }
+            } catch(e) {
+                console.error('[Dolphin] API Get Error:', e);
+            }
+        }
+    }
+
+    /** @private */
+    _updateDOM(topic, payload) {
+        if (typeof document === 'undefined') return;
+        const elements = document.querySelectorAll(`[data-rt-bind="${topic}"]`);
+        elements.forEach(el => {
+            if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+                el.value = typeof payload === 'object' ? (payload.value !== undefined ? payload.value : '') : payload;
+            } else {
+                el.innerHTML = typeof payload === 'object' ? (payload.html || payload.text || JSON.stringify(payload)) : payload;
+            }
+        });
+    }
 }
 
 // ─── Exports ──────────────────────────────────────────────────────────────────