dolphin-server-modules 1.0.0

package/middleware/zod.ts

@@ -0,0 +1,73 @@
+import { z, ZodError } from 'zod';
+
+/**
+ * Framework-agnostic validation utility.
+ * Validates any given data against a provided Zod schema.
+ */
+export const validateStructure = <T>(schema: z.ZodSchema<T>, data: unknown): T => {
+  try {
+    return schema.parse(data);
+  } catch (err: any) {
+    if (err instanceof ZodError) {
+      const zodErr = err as ZodError<any>;
+      throw {
+        status: 400,
+        message: 'Validation Error',
+        errors: zodErr.issues.map((e: z.ZodIssue) => ({ field: e.path.join('.'), message: e.message }))
+      };
+    }
+    throw err;
+  }
+};
+
+/**
+ * Express / Next.js Pages API Middleware
+ * Validates request body, query, and params.
+ */
+export const validatePagesRequest = (schemas: {
+  body?: z.ZodSchema<any>;
+  query?: z.ZodSchema<any>;
+  params?: z.ZodSchema<any>;
+}) => {
+  return (req: any, res: any, next: Function) => {
+    try {
+      if (schemas.body) req.body = validateStructure(schemas.body, req.body);
+      if (schemas.query) req.query = validateStructure(schemas.query, req.query);
+      if (schemas.params) req.params = validateStructure(schemas.params, req.params);
+      next();
+    } catch (err: any) {
+      return res.status(err.status || 400).json(err);
+    }
+  };
+};
+
+/**
+ * App Router Route Handler Wrapper
+ * Used to wrap a standard Route Handler function to ensure request validation.
+ */
+export const validateAppRoute = (
+  schema: z.ZodSchema<any>,
+  handler: (req: Request, validatedData: any, ...args: any[]) => Promise<Response> | Response
+) => {
+  return async (req: Request, ...args: any[]) => {
+    try {
+      // Typically we validate the body for App Router POST/PUT requests
+      let body;
+      if (req.method === 'POST' || req.method === 'PUT' || req.method === 'PATCH') {
+        body = await req.json().catch(() => ({}));
+      } else {
+        const url = new URL(req.url);
+        body = Object.fromEntries(url.searchParams.entries());
+      }
+      
+      const validatedData = validateStructure(schema, body);
+      return handler(req, validatedData, ...args);
+    } catch (err: any) {
+      const status = err.status || 400;
+      return new Response(JSON.stringify(err), {
+        status,
+        headers: { 'Content-Type': 'application/json' }
+      });
+    }
+  };
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "dolphin-server-modules",
+  "version": "1.0.0",
+  "description": "Core utility modules for Auth, CRUD, and Controllers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./auth": "./dist/auth/auth.js",
+    "./controller": "./dist/controller/controller.js",
+    "./crud": "./dist/curd/crud.js",
+    "./middleware/zod": "./dist/middleware/zod.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dolphin",
+    "server",
+    "auth",
+    "crud",
+    "controller"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "argon2": "^0.40.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.30",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.3"
+  }
+}