dolphin-server-modules 2.11.1 → 2.11.3

package/dist/utils/ctx.js

@@ -0,0 +1,82 @@
+/**
+ * Dolphin Universal Context Builder
+ *
+ * Dolphin modules (auth-controller, crud, router) ले ctx object use गर्छन्।
+ * यो helper ले कुनै पनि framework को req/res बाट ctx बनाउँछ।
+ *
+ * ─── Express ──────────────────────────────────────────────────────
+ *   import { createCtx } from 'dolphin-server-modules/utils/ctx';
+ *   app.post('/login', (req, res) => auth.login(createCtx(req, res)));
+ *
+ * ─── Fastify ──────────────────────────────────────────────────────
+ *   fastify.post('/login', (req, reply) =>
+ *     auth.login(createCtx(req.raw, reply.raw, req.body, req.params, req.query))
+ *   );
+ *
+ * ─── Next.js API Route ────────────────────────────────────────────
+ *   export default async function handler(req, res) {
+ *     return auth.login(createCtx(req, res));
+ *   }
+ *
+ * ─── Hono ─────────────────────────────────────────────────────────
+ *   app.post('/login', async (c) => {
+ *     const ctx = createCtx(c.req.raw, c.res, await c.req.json(), c.req.param());
+ *     return auth.login(ctx);
+ *   });
+ */
+/**
+ * कुनै पनि framework को req/res बाट Dolphin ctx बनाउने
+ * @param req  - Express req / Fastify request.raw / Next.js req / Node.js IncomingMessage
+ * @param res  - Express res / Fastify reply.raw / Next.js res / Node.js ServerResponse
+ * @param body - parsed body (req.body वा await req.json())
+ * @param params - route params ({ id: '123' })
+ * @param query  - query string params
+ */
+export function createCtx(req, res, body, params = {}, query = {}) {
+    // Auto-detect body from common frameworks
+    const resolvedBody = body ?? req.body ?? {};
+    const resolvedQuery = query && Object.keys(query).length
+        ? query
+        : req.query ?? {};
+    const resolvedParams = params && Object.keys(params).length
+        ? params
+        : req.params ?? {};
+    let pendingStatus = 200;
+    const send = (data, contentType, status = 200) => {
+        if (res.headersSent || res.writableEnded)
+            return ctx;
+        const finalStatus = status !== undefined ? status : pendingStatus;
+        // Express / Node.js style
+        if (typeof res.status === 'function' && typeof res.json === 'function') {
+            res.status(finalStatus).setHeader('Content-Type', contentType);
+            contentType === 'application/json'
+                ? res.json(data)
+                : res.end(String(data));
+        }
+        else {
+            // Raw Node.js ServerResponse
+            res.statusCode = finalStatus;
+            res.setHeader('Content-Type', contentType);
+            res.end(contentType === 'application/json' ? JSON.stringify(data) : String(data));
+        }
+        pendingStatus = 200;
+        return ctx;
+    };
+    const ctx = {
+        req,
+        res,
+        params: resolvedParams,
+        query: resolvedQuery,
+        body: resolvedBody,
+        state: {},
+        json: (data, status = 200) => send(data, 'application/json', status),
+        text: (data, status = 200) => send(data, 'text/plain', status),
+        html: (data, status = 200) => send(data, 'text/html', status),
+        status: (code) => { pendingStatus = code; return ctx; },
+        setHeader: (name, value) => { res.setHeader(name, value); return ctx; },
+        getHeader: (name) => req.headers?.[name.toLowerCase()],
+    };
+    return ctx;
+}
+export default createCtx;
+//# sourceMappingURL=ctx.js.map

package/dist/utils/ctx.js.map

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

package/package.json

@@ -1,65 +1,171 @@
-{
-  "name": "dolphin-server-modules",
-  "version": "2.11.1",
-  "type": "module",
-  "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
-  "description": "Core utility modules for Auth, CRUD, and Controllers",
-  "main": "dist/index.js",
-  "exports": {
-    ".": "./dist/index.js",
-    "./server": "./dist/server/server.js",
-    "./router": "./dist/router/router.js",
-    "./adapters/mongoose": "./dist/adapters/mongoose/index.js",
-    "./auth-controller": "./dist/authController/authController.js",
-    "./crud": "./dist/curd/crud.js"
-  },
-  "bin": {
-    "dolphin": "dist/bin/cli.js"
-  },
-  "files": [
-    "dist",
-    "scripts",
-    "README.md",
-    "LICENSE",
-    "DOLPHIN_MASTER_GUIDE_NEPALI.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc -w",
-    "test": "jest"
-  },
-  "keywords": [
-    "dolphin",
-    "framework",
-    "server",
-    "auth",
-    "crud"
-  ],
-  "author": "Phuyal Shankar",
-  "license": "MIT",
-  "dependencies": {
-    "@google/generative-ai": "^0.11.0",
-    "chalk": "^5.3.0",
-    "dotenv": "^16.4.5",
-    "express": "^4.19.2",
-    "mongoose": "^8.3.4",
-    "node-fetch": "^3.3.2",
-    "ora": "^8.0.1",
-    "ws": "^8.20.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/ioredis": "^4.28.10",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.12.11",
-    "@types/supertest": "^7.2.0",
-    "@types/ws": "^8.18.1",
-    "ioredis": "^5.10.1",
-    "jest": "^29.7.0",
-    "mongodb-memory-server": "^11.0.1",
-    "supertest": "^7.2.2",
-    "ts-jest": "^29.4.9",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.5"
-  }
-}
+{
+  "name": "dolphin-server-modules",
+  "version": "2.11.3",
+  "type": "module",
+  "homepage": "https://github.com/Phuyalshankar/dolphin-server-modules#readme",
+  "description": "Core utility modules for Auth, CRUD, and Controllers",
+  "main": "dist/index.js",
+  "bin": {
+    "dolphin": "dist/bin/cli.js",
+    "dolphin-server": "dist/bin/cli.js"
+  },
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "TUTORIAL_NEPALI.md",
+    "DOLPHIN_MASTER_GUIDE_NEPALI.md",
+    "scripts/client.js",
+    "scripts/dolphin-persist.js"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/auth.d.ts",
+      "default": "./dist/auth/auth.js"
+    },
+    "./auth.js": "./dist/auth/auth.js",
+    "./auth-controller": {
+      "types": "./dist/authController/authController.d.ts",
+      "default": "./dist/authController/authController.js"
+    },
+    "./auth-controller.js": "./dist/authController/authController.js",
+    "./controller": {
+      "types": "./dist/controller/controller.d.ts",
+      "default": "./dist/controller/controller.js"
+    },
+    "./controller.js": "./dist/controller/controller.js",
+    "./crud": {
+      "types": "./dist/curd/crud.d.ts",
+      "default": "./dist/curd/crud.js"
+    },
+    "./crud.js": "./dist/curd/crud.js",
+    "./curd": {
+      "types": "./dist/curd/crud.d.ts",
+      "default": "./dist/curd/crud.js"
+    },
+    "./curd.js": "./dist/curd/crud.js",
+    "./middleware/zod": {
+      "types": "./dist/middleware/zod.d.ts",
+      "default": "./dist/middleware/zod.js"
+    },
+    "./middleware/zod.js": "./dist/middleware/zod.js",
+    "./adapters/mongoose": {
+      "types": "./dist/adapters/mongoose/index.d.ts",
+      "default": "./dist/adapters/mongoose/index.js"
+    },
+    "./adapters/mongoose/index.js": "./dist/adapters/mongoose/index.js",
+    "./server": {
+      "types": "./dist/server/server.d.ts",
+      "default": "./dist/server/server.js"
+    },
+    "./server.js": "./dist/server/server.js",
+    "./router": {
+      "types": "./dist/router/router.d.ts",
+      "default": "./dist/router/router.js"
+    },
+    "./router.js": "./dist/router/router.js",
+    "./realtime": {
+      "types": "./dist/realtime/index.d.ts",
+      "default": "./dist/realtime/index.js"
+    },
+    "./realtime.js": "./dist/realtime/index.js",
+    "./realtime/core": {
+      "types": "./dist/realtime/core.d.ts",
+      "default": "./dist/realtime/core.js"
+    },
+    "./realtime/trie": {
+      "types": "./dist/realtime/trie.d.ts",
+      "default": "./dist/realtime/trie.js"
+    },
+    "./realtime/codec": {
+      "types": "./dist/realtime/codec.d.ts",
+      "default": "./dist/realtime/codec.js"
+    },
+    "./realtime/codec.js": "./dist/realtime/codec.js",
+    "./realtime/plugins": {
+      "types": "./dist/realtime/plugins.d.ts",
+      "default": "./dist/realtime/plugins.js"
+    },
+    "./realtime/camera": {
+      "types": "./dist/realtime/camera.d.ts",
+      "default": "./dist/realtime/camera.js"
+    },
+    "./realtime/rtsp": {
+      "types": "./dist/realtime/rtsp.d.ts",
+      "default": "./dist/realtime/rtsp.js"
+    },
+    "./swagger": {
+      "types": "./dist/swagger/swagger.d.ts",
+      "default": "./dist/swagger/swagger.js"
+    },
+    "./swagger.js": "./dist/swagger/swagger.js",
+    "./djson": {
+      "types": "./dist/djson/djson.d.ts",
+      "default": "./dist/djson/djson.js"
+    },
+    "./djson.js": "./dist/djson/djson.js",
+    "./signaling": {
+      "types": "./dist/signaling/index.d.ts",
+      "default": "./dist/signaling/index.js"
+    },
+    "./signaling/index.js": "./dist/signaling/index.js",
+    "./cli": "./dist/bin/cli.js",
+    "./client": "./scripts/client.js",
+    "./utils/ctx": {
+      "types": "./dist/utils/ctx.d.ts",
+      "default": "./dist/utils/ctx.js"
+    },
+    "./utils/ctx.js": "./dist/utils/ctx.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/demo-server.js",
+    "dolphin": "node dist/bin/cli.js",
+    "dev": "npm run build && npm run start",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dolphin",
+    "server",
+    "auth",
+    "crud",
+    "controller",
+    "realtime",
+    "iot",
+    "2fa",
+    "jwt"
+  ],
+  "author": "Shankar Phuyal",
+  "license": "ISC",
+  "dependencies": {
+    "argon2": "^0.40.1",
+    "ioredis": "^5.10.1",
+    "jsonwebtoken": "^9.0.3",
+    "mongoose": "^9.3.2",
+    "ws": "^8.20.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^20.11.30",
+    "@types/ws": "^8.18.1",
+    "jest": "^29.7.0",
+    "mongodb-memory-server": "^11.0.1",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Phuyalshankar/dolphin-server-modules.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Phuyalshankar/dolphin-server-modules/issues"
+  }
+}