perfect-payload 1.8.0-beta.0 → 2.0.0-beta.0

package/package.json

@@ -1,22 +1,31 @@
 {
   "name": "perfect-payload",
-  "version": "1.8.0-beta.0",
+  "version": "2.0.0-beta.0",
   "type": "module",
   "description": "Lightweight JSON payload validation library with structured errors, nested validation, field paths, and customizable validation rules.",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./index.js",
-    "./express": "./express.js",
-    "./fastify": "./fastify.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "import": "./dist/express.js"
+    },
+    "./fastify": {
+      "types": "./dist/fastify.d.ts",
+      "import": "./dist/fastify.js"
+    }
   },
   "scripts": {
-    "test": "jest"
+    "test": "jest",
+    "build": "tsc",
+    "test:types": "tsc type-test.ts --noEmit --strict --module NodeNext --moduleResolution NodeNext --target ES2022 --ignoreConfig --skipLibCheck"
   },
   "files": [
-    "index.js",
-    "framework.js",
-    "express.js",
-    "fastify.js"
+    "dist"
   ],
   "jest": {
     "testPathIgnorePatterns": [
@@ -56,7 +65,12 @@
   "devDependencies": {
     "@babel/core": "^7.25.2",
     "@babel/preset-env": "^7.25.4",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.6.2",
     "babel-jest": "^29.7.0",
-    "jest": "^29.7.0"
+    "express": "^5.2.1",
+    "fastify": "^5.12.5",
+    "jest": "^29.7.0",
+    "typescript": "^7.0.2"
   }
 }

package/express.js

@@ -1,75 +0,0 @@
-import {
-  validateFrameworkConfig,
-  validateFrameworkSources,
-  validateFrameworkSourcesAsync,
-} from "./framework.js";
-
-export function validatePayload(config = {}) {
-  const { rule, options = {} } = config;
-
-  // Validate developer configuration when middleware is created,
-  // not on every incoming request.
-  validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  return function perfectPayloadExpressMiddleware(req, res, next) {
-    try {
-      const result = validateFrameworkSources({
-        data: {
-          headers: req.headers,
-          params: req.params,
-          query: req.query,
-          body: req.body,
-        },
-        rule,
-        options,
-      });
-
-      if (result.valid === true) {
-        req.validatedPayload = result.validatedPayload;
-        return next();
-      }
-
-      return res.status(result.statusCode ?? 400).json(result);
-    } catch (error) {
-      return next(error);
-    }
-  };
-}
-
-export function validatePayloadAsync(config = {}) {
-  const { rule, options = {} } = config;
-
-  // Validate developer configuration when middleware is created,
-  // not on every incoming request.
-  validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  return async function perfectPayloadExpressAsyncMiddleware(req, res, next) {
-    try {
-      const result = await validateFrameworkSourcesAsync({
-        data: {
-          headers: req.headers,
-          params: req.params,
-          query: req.query,
-          body: req.body,
-        },
-        rule,
-        options,
-      });
-
-      if (result.valid === true) {
-        req.validatedPayload = result.validatedPayload;
-        return next();
-      }
-
-      return res.status(result.statusCode ?? 400).json(result);
-    } catch (error) {
-      return next(error);
-    }
-  };
-}

package/fastify.js

@@ -1,67 +0,0 @@
-import {
-  validateFrameworkConfig,
-  validateFrameworkSources,
-  validateFrameworkSourcesAsync,
-} from "./framework.js";
-
-export function validatePayload(config = {}) {
-  const { rule, options = {} } = config;
-
-  // Validate developer configuration when the hook is created,
-  // not on every incoming request.
-  validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  return async function perfectPayloadFastifyHook(request, reply) {
-    const result = validateFrameworkSources({
-      data: {
-        headers: request.headers,
-        params: request.params,
-        query: request.query,
-        body: request.body,
-      },
-      rule,
-      options,
-    });
-
-    if (result.valid === true) {
-      request.validatedPayload = result.validatedPayload;
-      return;
-    }
-
-    return reply.code(result.statusCode ?? 400).send(result);
-  };
-}
-
-export function validatePayloadAsync(config = {}) {
-  const { rule, options = {} } = config;
-
-  // Validate developer configuration when the hook is created,
-  // not on every incoming request.
-  validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  return async function perfectPayloadFastifyAsyncHook(request, reply) {
-    const result = await validateFrameworkSourcesAsync({
-      data: {
-        headers: request.headers,
-        params: request.params,
-        query: request.query,
-        body: request.body,
-      },
-      rule,
-      options,
-    });
-
-    if (result.valid === true) {
-      request.validatedPayload = result.validatedPayload;
-      return;
-    }
-
-    return reply.code(result.statusCode ?? 400).send(result);
-  };
-}

package/framework.js

@@ -1,175 +0,0 @@
-import { perfectPayload, perfectPayloadAsync } from "./index.js";
-
-const SUPPORTED_REQUEST_SOURCES = ["headers", "params", "query", "body"];
-
-export function validateFrameworkConfig({ rule, options } = {}) {
-  if (!rule || typeof rule !== "object" || Array.isArray(rule)) {
-    throw new Error("perfect-payload:- framework rule must be an object");
-  }
-
-  const configuredSources = Object.keys(rule);
-
-  if (configuredSources.length === 0) {
-    throw new Error(
-      "perfect-payload:- framework rule must contain at least one request source",
-    );
-  }
-
-  for (const source of configuredSources) {
-    if (!SUPPORTED_REQUEST_SOURCES.includes(source)) {
-      throw new Error(`perfect-payload:- unsupported request source ${source}`);
-    }
-
-    const sourceRule = rule[source];
-
-    if (
-      !sourceRule ||
-      typeof sourceRule !== "object" ||
-      Array.isArray(sourceRule)
-    ) {
-      throw new Error(
-        `perfect-payload:- rule for request source ${source} must be an object`,
-      );
-    }
-  }
-
-  if (
-    options !== undefined &&
-    (options === null || typeof options !== "object" || Array.isArray(options))
-  ) {
-    throw new Error("perfect-payload:- framework options must be an object");
-  }
-
-  return SUPPORTED_REQUEST_SOURCES.filter((source) =>
-    Object.prototype.hasOwnProperty.call(rule, source),
-  );
-}
-
-export function validateFrameworkSources({
-  data = {},
-  rule,
-  options = {},
-} = {}) {
-  const configuredSources = validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  const validatedPayload = {};
-  const errors = [];
-
-  let invalidResponse = null;
-
-  for (const source of configuredSources) {
-    const sourceData =
-      data?.[source] !== undefined && data?.[source] !== null
-        ? data[source]
-        : {};
-
-    const result = perfectPayload(sourceData, rule[source], options);
-
-    if (result.valid === true) {
-      validatedPayload[source] = result.validatedPayload;
-      continue;
-    }
-
-    if (!invalidResponse) {
-      const { errors: _errors, ...response } = result;
-      invalidResponse = response;
-    }
-
-    for (const error of result.errors ?? []) {
-      if (typeof error === "string") {
-        errors.push(error);
-      } else {
-        errors.push({
-          ...error,
-          path: `${source}.${error.path}`,
-        });
-      }
-    }
-  }
-
-  if (errors.length > 0) {
-    return {
-      ...invalidResponse,
-      errors,
-    };
-  }
-
-  return {
-    valid: true,
-    validatedPayload,
-  };
-}
-
-export async function validateFrameworkSourcesAsync({
-  data = {},
-  rule,
-  options = {},
-} = {}) {
-  const configuredSources = validateFrameworkConfig({
-    rule,
-    options,
-  });
-
-  const results = await Promise.all(
-    configuredSources.map(async (source) => {
-      const sourceData =
-        data?.[source] !== undefined && data?.[source] !== null
-          ? data[source]
-          : {};
-
-      const result = await perfectPayloadAsync(
-        sourceData,
-        rule[source],
-        options,
-      );
-
-      return {
-        source,
-        result,
-      };
-    }),
-  );
-
-  const validatedPayload = {};
-  const errors = [];
-
-  let invalidResponse = null;
-
-  for (const { source, result } of results) {
-    if (result.valid === true) {
-      validatedPayload[source] = result.validatedPayload;
-      continue;
-    }
-
-    if (!invalidResponse) {
-      const { errors: _errors, ...response } = result;
-      invalidResponse = response;
-    }
-
-    for (const error of result.errors ?? []) {
-      if (typeof error === "string") {
-        errors.push(error);
-      } else {
-        errors.push({
-          ...error,
-          path: `${source}.${error.path}`,
-        });
-      }
-    }
-  }
-
-  if (errors.length > 0) {
-    return {
-      ...invalidResponse,
-      errors,
-    };
-  }
-
-  return {
-    valid: true,
-    validatedPayload,
-  };
-}