dolphin-server-modules 1.0.1 → 1.0.3

package/README.md

@@ -90,7 +90,27 @@ export const { GET, POST, PUT, DELETE } = createNextAppRoute(postController);
 
 ---
 
-## ✅ 4. Zod Validation Middleware (`/middleware/zod`)
+## 🍃 4. Mongoose Adapter (`/adapters/mongoose`)
+An official, fully typed Mongoose adapter for seamless integration with the Auth and CRUD modules. It handles mapping `id` to `_id`, query mapping (`$like` to `$regex`), and works independently!
+
+```typescript
+import { createMongooseAdapter } from 'dolphin-server-modules/adapters/mongoose';
+import { User, RefreshToken, Post } from './my-mongoose-models';
+
+const dbAdapter = createMongooseAdapter({
+  User,
+  RefreshToken,
+  models: {
+    posts: Post // Maps the 'posts' collection to the generic Post model
+  }
+});
+
+// Now pass dbAdapter to createAuth or createCRUD initializers!
+```
+
+---
+
+## ✅ 5. Zod Validation Middleware (`/middleware/zod`)
 Validate your data effortlessly using `zod`. Protect your endpoints from bad data.
 
 ```typescript

package/adapters/mongoose/index.ts

@@ -0,0 +1,142 @@
+import type { Model } from 'mongoose';
+
+export interface MongooseAdapterConfig {
+  User: Model<any>;
+  RefreshToken: Model<any>;
+  models?: Record<string, Model<any>>;
+}
+
+export function createMongooseAdapter(config: MongooseAdapterConfig) {
+  // Map MongoDB document to the standard BaseDocument shape
+  const mapDoc = (doc: any) => {
+    if (!doc) return null;
+    const obj = doc.toObject && typeof doc.toObject === 'function' ? doc.toObject() : { ...doc };
+    if (obj._id) {
+      obj.id = obj._id.toString();
+      delete obj._id;
+    }
+    delete obj.__v;
+    return obj;
+  };
+
+  // Convert standard QueryFilter to Mongoose Query format
+  const mapQuery = (query: any) => {
+    if (!query) return {};
+    const parsed: any = {};
+    for (const [key, val] of Object.entries(query)) {
+      if (key === 'id') {
+        parsed['_id'] = val;
+      } else if (key === '$and' || key === '$or') {
+        parsed[key] = (val as any[]).map(mapQuery);
+      } else if (typeof val === 'object' && val !== null && !Array.isArray(val)) {
+        const ops: any = {};
+        for (const [op, opVal] of Object.entries(val)) {
+          if (op === '$like') {
+            ops['$regex'] = opVal;
+            ops['$options'] = 'i';
+          } else {
+            ops[op] = opVal;
+          }
+        }
+        parsed[key] = ops;
+      } else {
+        parsed[key] = val;
+      }
+    }
+    return parsed;
+  };
+
+  // Convert standard sorting to Mongoose sort format
+  const mapSort = (sort?: Record<string, 'asc' | 'desc'>) => {
+    if (!sort) return undefined;
+    const result: Record<string, 1 | -1> = {};
+    for (const [k, v] of Object.entries(sort)) {
+      result[k] = v === 'asc' ? 1 : -1;
+    }
+    return result;
+  };
+
+  // Helper to fetch generic CRUD models
+  const getModel = (collection: string): Model<any> => {
+    if (!config.models || !config.models[collection]) {
+      throw new Error(`Model for collection '${collection}' not found in MongooseAdapterConfig`);
+    }
+    return config.models[collection];
+  };
+
+  return {
+    // ==========================================
+    // AUTHENTICATION ADAPTER METHODS
+    // ==========================================
+    async createUser(data: any) {
+      const user = await config.User.create(data);
+      return mapDoc(user);
+    },
+    async findUserByEmail(email: string) {
+      const user = await config.User.findOne({ email });
+      return mapDoc(user);
+    },
+    async findUserById(id: string) {
+      const user = await config.User.findById(id);
+      return mapDoc(user);
+    },
+    async updateUser(id: string, data: any) {
+      const user = await config.User.findByIdAndUpdate(id, data, { new: true });
+      return mapDoc(user);
+    },
+    async saveRefreshToken(data: any) {
+      await config.RefreshToken.create(data);
+    },
+    async findRefreshToken(token: string) {
+      const rt = await config.RefreshToken.findOne({ token });
+      return mapDoc(rt);
+    },
+    async deleteRefreshToken(token: string) {
+      await config.RefreshToken.deleteOne({ token });
+    },
+
+    // ==========================================
+    // CRUD ADAPTER METHODS
+    // ==========================================
+    async create(collection: string, data: any) {
+      const Model = getModel(collection);
+      const doc = await Model.create(data);
+      return mapDoc(doc);
+    },
+    async read(collection: string, query: any) {
+      const Model = getModel(collection);
+      const docs = await Model.find(mapQuery(query));
+      return docs.map(mapDoc);
+    },
+    async update(collection: string, query: any, data: any) {
+      const Model = getModel(collection);
+      await Model.updateMany(mapQuery(query), data);
+      
+      // Return updated documents if we can map them back, otherwise minimal info
+      // Since updateMany doesn't return the updated docs in mongoose, we can just return a generic success object 
+      // or fetch them. The interface expects Promise<any>. We will fetch them to match typical behavior.
+      const docs = await Model.find(mapQuery({ ...query, ...data }));
+      return docs.map(mapDoc);
+    },
+    async delete(collection: string, query: any) {
+      const Model = getModel(collection);
+      await Model.deleteMany(mapQuery(query));
+      return { deleted: true };
+    },
+    async advancedRead(collection: string, query: any, options: any) {
+      const Model = getModel(collection);
+      let mQuery = Model.find(mapQuery(query));
+      if (options.sort) {
+        mQuery = mQuery.sort(mapSort(options.sort));
+      }
+      if (options.offset !== undefined) {
+        mQuery = mQuery.skip(options.offset);
+      }
+      if (options.limit !== undefined) {
+        mQuery = mQuery.limit(options.limit);
+      }
+      const docs = await mQuery;
+      return docs.map(mapDoc);
+    }
+  };
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './auth/auth';
 export * from './controller/controller';
 export { createCRUD, BaseDocument, QueryFilter, PaginationOptions, DatabaseAdapter as CrudDatabaseAdapter } from './curd/crud';
+export * from './server/server';
+export * from './router/router';

package/dist/index.js

@@ -22,4 +22,7 @@ __exportStar(require("./controller/controller"), exports);
 // Re-export CRUD but alias DatabaseAdapter to avoid conflicts
 var crud_1 = require("./curd/crud");
 Object.defineProperty(exports, "createCRUD", { enumerable: true, get: function () { return crud_1.createCRUD; } });
+// Re-export Server & Router
+__exportStar(require("./server/server"), exports);
+__exportStar(require("./router/router"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,8CAA4B;AAC5B,uBAAuB;AACvB,0DAAwC;AACxC,8DAA8D;AAC9D,oCAMqB;AALnB,kGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,8CAA4B;AAC5B,uBAAuB;AACvB,0DAAwC;AACxC,8DAA8D;AAC9D,oCAMqB;AALnB,kGAAA,UAAU,OAAA;AAMZ,4BAA4B;AAC5B,kDAAgC;AAChC,kDAAgC"}

package/dist/router/router.d.ts

@@ -0,0 +1,13 @@
+type Handler = (req: any, res: any) => Promise<void> | void;
+export declare function createDolphinRouter(): {
+    get: (path: string, handler: Handler) => void;
+    post: (path: string, handler: Handler) => void;
+    put: (path: string, handler: Handler) => void;
+    delete: (path: string, handler: Handler) => void;
+    patch: (path: string, handler: Handler) => void;
+    match(method: string, url: string): {
+        handler: Handler;
+        params: Record<string, string>;
+    } | null;
+};
+export {};

package/dist/router/router.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDolphinRouter = createDolphinRouter;
+function createDolphinRouter() {
+    const routes = [];
+    const addRoute = (method, path, handler) => {
+        // Convert /users/:id to regex
+        const keys = [];
+        const pattern = path
+            .replace(/:([^\/]+)/g, (_, key) => {
+            keys.push(key);
+            return '([^\\/]+)';
+        })
+            .replace(/\//g, '\\/');
+        routes.push({
+            method: method.toUpperCase(),
+            path,
+            handler,
+            regex: new RegExp(`^${pattern}$`),
+            keys
+        });
+    };
+    return {
+        get: (path, handler) => addRoute('GET', path, handler),
+        post: (path, handler) => addRoute('POST', path, handler),
+        put: (path, handler) => addRoute('PUT', path, handler),
+        delete: (path, handler) => addRoute('DELETE', path, handler),
+        patch: (path, handler) => addRoute('PATCH', path, handler),
+        match(method, url) {
+            const path = url.split('?')[0];
+            const m = method.toUpperCase();
+            for (const route of routes) {
+                if (route.method !== m && route.method !== 'ALL')
+                    continue;
+                const match = path.match(route.regex);
+                if (match) {
+                    const params = {};
+                    route.keys.forEach((key, i) => {
+                        params[key] = match[i + 1];
+                    });
+                    return { handler: route.handler, params };
+                }
+            }
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/router/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../router/router.ts"],"names":[],"mappings":";;AAUA,kDAgDC;AAhDD,SAAgB,mBAAmB;IACjC,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,OAAgB,EAAE,EAAE;QAClE,8BAA8B;QAC9B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI;aACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,OAAO,WAAW,CAAC;QACrB,CAAC,CAAC;aACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEzB,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,IAAI;YACJ,OAAO;YACP,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC;YACjC,IAAI;SACL,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QACvE,IAAI,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;QACzE,GAAG,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QACvE,MAAM,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;QAC7E,KAAK,EAAE,CAAC,IAAY,EAAE,OAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;QAE3E,KAAK,CAAC,MAAc,EAAE,GAAW;YAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;oBAAE,SAAS;gBAE3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,MAAM,GAA2B,EAAE,CAAC;oBAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;wBAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7B,CAAC,CAAC,CAAC;oBACH,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/server.d.ts

@@ -0,0 +1,18 @@
+import http from 'node:http';
+export declare function createDolphinServer(options?: {
+    port?: number;
+    host?: string;
+}): {
+    use: (mw: any) => number;
+    listen: (port?: number, callback?: () => void) => void;
+    close: () => http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+    get: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    post: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    put: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    delete: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    patch: (path: string, handler: (req: any, res: any) => Promise<void> | void) => void;
+    match(method: string, url: string): {
+        handler: (req: any, res: any) => Promise<void> | void;
+        params: Record<string, string>;
+    } | null;
+};

package/dist/server/server.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDolphinServer = createDolphinServer;
+const node_http_1 = __importDefault(require("node:http"));
+const router_1 = require("../router/router");
+function createDolphinServer(options = {}) {
+    const router = (0, router_1.createDolphinRouter)();
+    const middlewares = [];
+    const server = node_http_1.default.createServer(async (req, res) => {
+        // Utility for JSON responses
+        res.json = (data, status = 200) => {
+            res.writeHead(status, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(data));
+        };
+        // Global middleware execution
+        for (const mw of middlewares) {
+            const next = new Promise(resolve => mw(req, res, resolve));
+            await next;
+            if (res.writableEnded)
+                return;
+        }
+        // Body parsing for POST/PUT/PATCH
+        if (['POST', 'PUT', 'PATCH'].includes(req.method) && req.headers['content-type']?.includes('application/json')) {
+            const chunks = [];
+            for await (const chunk of req)
+                chunks.push(chunk);
+            try {
+                req.body = JSON.parse(Buffer.concat(chunks).toString());
+            }
+            catch {
+                req.body = {};
+            }
+        }
+        // Matching route
+        const match = router.match(req.method, req.url);
+        if (match) {
+            req.params = match.params;
+            try {
+                await match.handler(req, res);
+            }
+            catch (err) {
+                res.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
+            }
+        }
+        else {
+            res.json({ error: 'Not Found' }, 404);
+        }
+    });
+    return {
+        ...router, // Mixin router methods (get, post, etc.)
+        use: (mw) => middlewares.push(mw),
+        listen: (port = options.port || 3000, callback) => {
+            server.listen(port, options.host || '0.0.0.0', callback);
+        },
+        close: () => server.close()
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

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

package/index.ts

@@ -10,3 +10,6 @@ export {
   PaginationOptions,
   DatabaseAdapter as CrudDatabaseAdapter
 } from './curd/crud';
+// Re-export Server & Router
+export * from './server/server';
+export * from './router/router';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dolphin-server-modules",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Core utility modules for Auth, CRUD, and Controllers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,10 @@
     "./auth": "./dist/auth/auth.js",
     "./controller": "./dist/controller/controller.js",
     "./crud": "./dist/curd/crud.js",
-    "./middleware/zod": "./dist/middleware/zod.js"
+    "./middleware/zod": "./dist/middleware/zod.js",
+    "./adapters/mongoose": "./dist/adapters/mongoose/index.js",
+    "./server": "./dist/server/server.js",
+    "./router": "./dist/router/router.js"
   },
   "scripts": {
     "build": "tsc",
@@ -33,6 +36,7 @@
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.30",
     "jest": "^29.7.0",
+    "mongoose": "^9.3.2",
     "ts-jest": "^29.1.2",
     "typescript": "^5.4.3"
   }

package/router/router.ts

@@ -0,0 +1,59 @@
+type Handler = (req: any, res: any) => Promise<void> | void;
+
+interface Route {
+  method: string;
+  path: string;
+  handler: Handler;
+  regex: RegExp;
+  keys: string[];
+}
+
+export function createDolphinRouter() {
+  const routes: Route[] = [];
+
+  const addRoute = (method: string, path: string, handler: Handler) => {
+    // Convert /users/:id to regex
+    const keys: string[] = [];
+    const pattern = path
+      .replace(/:([^\/]+)/g, (_, key) => {
+        keys.push(key);
+        return '([^\\/]+)';
+      })
+      .replace(/\//g, '\\/');
+    
+    routes.push({
+      method: method.toUpperCase(),
+      path,
+      handler,
+      regex: new RegExp(`^${pattern}$`),
+      keys
+    });
+  };
+
+  return {
+    get: (path: string, handler: Handler) => addRoute('GET', path, handler),
+    post: (path: string, handler: Handler) => addRoute('POST', path, handler),
+    put: (path: string, handler: Handler) => addRoute('PUT', path, handler),
+    delete: (path: string, handler: Handler) => addRoute('DELETE', path, handler),
+    patch: (path: string, handler: Handler) => addRoute('PATCH', path, handler),
+
+    match(method: string, url: string) {
+      const path = url.split('?')[0];
+      const m = method.toUpperCase();
+
+      for (const route of routes) {
+        if (route.method !== m && route.method !== 'ALL') continue;
+        
+        const match = path.match(route.regex);
+        if (match) {
+          const params: Record<string, string> = {};
+          route.keys.forEach((key, i) => {
+            params[key] = match[i + 1];
+          });
+          return { handler: route.handler, params };
+        }
+      }
+      return null;
+    }
+  };
+}

package/server/server.ts

@@ -0,0 +1,55 @@
+import http from 'node:http';
+import { createDolphinRouter } from '../router/router';
+
+export function createDolphinServer(options: { port?: number; host?: string } = {}) {
+  const router = createDolphinRouter();
+  const middlewares: any[] = [];
+
+  const server = http.createServer(async (req: any, res: any) => {
+    // Utility for JSON responses
+    res.json = (data: any, status = 200) => {
+      res.writeHead(status, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify(data));
+    };
+
+    // Global middleware execution
+    for (const mw of middlewares) {
+      const next = new Promise(resolve => mw(req, res, resolve));
+      await next;
+      if (res.writableEnded) return;
+    }
+
+    // Body parsing for POST/PUT/PATCH
+    if (['POST', 'PUT', 'PATCH'].includes(req.method!) && req.headers['content-type']?.includes('application/json')) {
+      const chunks: any[] = [];
+      for await (const chunk of req) chunks.push(chunk);
+      try {
+        req.body = JSON.parse(Buffer.concat(chunks).toString());
+      } catch {
+        req.body = {};
+      }
+    }
+
+    // Matching route
+    const match = router.match(req.method!, req.url!);
+    if (match) {
+      req.params = match.params;
+      try {
+        await match.handler(req, res);
+      } catch (err: any) {
+        res.json({ error: err.message || 'Internal Server Error' }, err.status || 500);
+      }
+    } else {
+      res.json({ error: 'Not Found' }, 404);
+    }
+  });
+
+  return {
+    ...router, // Mixin router methods (get, post, etc.)
+    use: (mw: any) => middlewares.push(mw),
+    listen: (port: number = options.port || 3000, callback?: () => void) => {
+      server.listen(port, options.host || '0.0.0.0', callback);
+    },
+    close: () => server.close()
+  };
+}