@coherent.js/api 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thomas Drouvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @coherent.js/api
+
+[![npm version](https://img.shields.io/npm/v/@coherent.js/api.svg)](https://www.npmjs.com/package/@coherent.js/api)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
+[![Node >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+
+API framework utilities for Coherent.js (routing, validation, serialization, security).
+
+- ESM-only, Node 20+
+- Build APIs with an object-first approach
+- Batteries-included: validation, error handling, auth helpers, and serialization
+
+For a high-level overview and repository-wide instructions, see the root README: ../../README.md
+
+## Installation
+
+```bash
+pnpm add @coherent.js/api
+```
+
+Requirements:
+- Node.js >= 20
+- ESM module system
+
+## Quick start
+
+JavaScript (ESM):
+```js
+import { createRouter, withValidation, ApiError } from '@coherent.js/api';
+
+const router = createRouter({
+  'GET /health': () => ({ status: 'ok' }),
+  'POST /echo': withValidation({ body: { message: 'string' } }, ({ body }) => ({ message: body.message }))
+});
+
+// router.handle(req) -> { statusCode, headers, body }
+```
+
+TypeScript:
+```ts
+import { createRouter, withValidation, ApiError } from '@coherent.js/api';
+
+type EchoBody = { message: string };
+
+const router = createRouter({
+  'GET /health': () => ({ status: 'ok' }),
+  'POST /echo': withValidation<{ body: EchoBody }>({ body: { message: 'string' } }, ({ body }) => ({ message: body.message }))
+});
+```
+
+## Exports overview (selected)
+
+- Routing
+  - `createRouter`
+- Errors & handlers
+  - `ApiError`, `ValidationError`, `AuthenticationError`, `AuthorizationError`, `NotFoundError`, `ConflictError`
+  - `withErrorHandling`, `createErrorHandler`
+- Validation
+  - `validateAgainstSchema`, `validateField`, `withValidation`, `withQueryValidation`, `withParamsValidation`
+- Serialization
+  - `serializeDate`, `deserializeDate`, `serializeMap`, `deserializeMap`, `serializeSet`, `deserializeSet`, `withSerialization`, `serializeForJSON`
+- Security
+  - `withAuth`, `withRole`, `hashPassword`, `verifyPassword`, `generateToken`, `withInputValidation`
+
+Tip: Combine `withValidation`, `withAuth`, and `withErrorHandling` to build robust endpoints.
+
+## Development
+
+Run tests for this package:
+```bash
+pnpm --filter @coherent.js/api run test
+```
+
+Watch mode:
+```bash
+pnpm --filter @coherent.js/api run test:watch
+```
+
+Type check:
+```bash
+pnpm --filter @coherent.js/api run typecheck
+```
+
+Build:
+```bash
+pnpm --filter @coherent.js/api run build
+```
+
+## License
+
+MIT © Coherent.js Team

package/dist/api/errors.d.ts

@@ -0,0 +1,92 @@
+/**
+ * API Error Handling for Coherent.js
+ * @fileoverview Standardized error classes and handling utilities
+ */
+/**
+ * Base API Error class
+ * @extends Error
+ */
+export class ApiError extends Error {
+    /**
+     * Create an API error
+     * @param {string} message - Error message
+     * @param {number} statusCode - HTTP status code
+     * @param {Object} details - Additional error details
+     */
+    constructor(message: string, statusCode?: number, details?: Object);
+    statusCode: number;
+    details: Object;
+    /**
+     * Convert error to JSON-serializable object
+     * @returns {Object} Error object
+     */
+    toJSON(): Object;
+}
+/**
+ * Validation Error class
+ * @extends ApiError
+ */
+export class ValidationError extends ApiError {
+    /**
+     * Create a validation error
+     * @param {Object} errors - Validation errors
+     * @param {string} message - Error message
+     */
+    constructor(errors: Object, message?: string);
+}
+/**
+ * Authentication Error class
+ * @extends ApiError
+ */
+export class AuthenticationError extends ApiError {
+    /**
+     * Create an authentication error
+     * @param {string} message - Error message
+     */
+    constructor(message?: string);
+}
+/**
+ * Authorization Error class
+ * @extends ApiError
+ */
+export class AuthorizationError extends ApiError {
+    /**
+     * Create an authorization error
+     * @param {string} message - Error message
+     */
+    constructor(message?: string);
+}
+/**
+ * Not Found Error class
+ * @extends ApiError
+ */
+export class NotFoundError extends ApiError {
+    /**
+     * Create a not found error
+     * @param {string} message - Error message
+     */
+    constructor(message?: string);
+}
+/**
+ * Conflict Error class
+ * @extends ApiError
+ */
+export class ConflictError extends ApiError {
+    /**
+     * Create a conflict error
+     * @param {string} message - Error message
+     */
+    constructor(message?: string);
+}
+/**
+ * Create error handling middleware
+ * @param {Function} handler - Error handler function
+ * @returns {Function} Middleware function
+ */
+export function withErrorHandling(handler: Function): Function;
+/**
+ * Global error handler middleware
+ * @returns {Function} Express error handler middleware
+ */
+export function createErrorHandler(): Function;
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/api/errors.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH;IACE;;;;;OAKG;IACH,qBAJW,MAAM,eACN,MAAM,YACN,MAAM,EAYhB;IAPC,mBAA4B;IAC5B,gBAAsB;IAQxB;;;OAGG;IACH,UAFa,MAAM,CASlB;CACF;AAED;;;GAGG;AACH;IACE;;;;OAIG;IACH,oBAHW,MAAM,YACN,MAAM,EAKhB;CACF;AAED;;;GAGG;AACH;IACE;;;OAGG;IACH,sBAFW,MAAM,EAKhB;CACF;AAED;;;GAGG;AACH;IACE;;;OAGG;IACH,sBAFW,MAAM,EAKhB;CACF;AAED;;;GAGG;AACH;IACE;;;OAGG;IACH,sBAFW,MAAM,EAKhB;CACF;AAED;;;GAGG;AACH;IACE;;;OAGG;IACH,sBAFW,MAAM,EAKhB;CACF;AAED;;;;GAIG;AACH,+DAcC;AAED;;;GAGG;AACH,+CA6BC"}

package/dist/api/errors.js

@@ -0,0 +1,161 @@
+/**
+ * API Error Handling for Coherent.js
+ * @fileoverview Standardized error classes and handling utilities
+ */
+/**
+ * Base API Error class
+ * @extends Error
+ */
+class ApiError extends Error {
+    /**
+     * Create an API error
+     * @param {string} message - Error message
+     * @param {number} statusCode - HTTP status code
+     * @param {Object} details - Additional error details
+     */
+    constructor(message, statusCode = 500, details = {}) {
+        super(message);
+        this.name = 'ApiError';
+        this.statusCode = statusCode;
+        this.details = details;
+        // Ensure proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ApiError);
+        }
+    }
+    /**
+     * Convert error to JSON-serializable object
+     * @returns {Object} Error object
+     */
+    toJSON() {
+        return {
+            error: this.name,
+            message: this.message,
+            statusCode: this.statusCode,
+            details: this.details
+        };
+    }
+}
+/**
+ * Validation Error class
+ * @extends ApiError
+ */
+class ValidationError extends ApiError {
+    /**
+     * Create a validation error
+     * @param {Object} errors - Validation errors
+     * @param {string} message - Error message
+     */
+    constructor(errors, message = 'Validation failed') {
+        super(message, 400, { errors });
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Authentication Error class
+ * @extends ApiError
+ */
+class AuthenticationError extends ApiError {
+    /**
+     * Create an authentication error
+     * @param {string} message - Error message
+     */
+    constructor(message = 'Authentication required') {
+        super(message, 401);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Authorization Error class
+ * @extends ApiError
+ */
+class AuthorizationError extends ApiError {
+    /**
+     * Create an authorization error
+     * @param {string} message - Error message
+     */
+    constructor(message = 'Access denied') {
+        super(message, 403);
+        this.name = 'AuthorizationError';
+    }
+}
+/**
+ * Not Found Error class
+ * @extends ApiError
+ */
+class NotFoundError extends ApiError {
+    /**
+     * Create a not found error
+     * @param {string} message - Error message
+     */
+    constructor(message = 'Resource not found') {
+        super(message, 404);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Conflict Error class
+ * @extends ApiError
+ */
+class ConflictError extends ApiError {
+    /**
+     * Create a conflict error
+     * @param {string} message - Error message
+     */
+    constructor(message = 'Resource conflict') {
+        super(message, 409);
+        this.name = 'ConflictError';
+    }
+}
+/**
+ * Create error handling middleware
+ * @param {Function} handler - Error handler function
+ * @returns {Function} Middleware function
+ */
+function withErrorHandling(handler) {
+    return async (req, res, next) => {
+        try {
+            return await handler(req, res, next);
+        }
+        catch (error) {
+            // If it's already an API error, use it as-is
+            if (error instanceof ApiError) {
+                throw error;
+            }
+            // Otherwise, wrap it as a generic server error
+            throw new ApiError(error.message || 'Internal server error', 500);
+        }
+    };
+}
+/**
+ * Global error handler middleware
+ * @returns {Function} Express error handler middleware
+ */
+function createErrorHandler() {
+    return (error, req, res, next) => {
+        // Log error for debugging
+        console.error('API Error:', error);
+        // If headers are already sent, delegate to default error handler
+        if (res.headersSent) {
+            return next(error);
+        }
+        // Format error response
+        const response = {
+            error: error.name || 'Error',
+            message: error.message || 'An error occurred',
+            statusCode: error.statusCode || 500
+        };
+        // Add details if available
+        if (error.details) {
+            response.details = error.details;
+        }
+        // Add stack trace in development
+        if (process.env.NODE_ENV === 'development') {
+            response.stack = error.stack;
+        }
+        res.status(response.statusCode).json(response);
+    };
+}
+// Export all error classes and utilities
+export { ApiError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, withErrorHandling, createErrorHandler };
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,61 @@
+declare namespace _default {
+    export { createObjectRouter };
+    export { ApiError };
+    export { ValidationError };
+    export { AuthenticationError };
+    export { AuthorizationError };
+    export { NotFoundError };
+    export { ConflictError };
+    export { withErrorHandling };
+    export { createErrorHandler };
+    export { validateAgainstSchema };
+    export { validateField };
+    export { withValidation };
+    export { withQueryValidation };
+    export { withParamsValidation };
+    export { serializeDate };
+    export { deserializeDate };
+    export { serializeMap };
+    export { deserializeMap };
+    export { serializeSet };
+    export { deserializeSet };
+    export { withSerialization };
+    export { serializeForJSON };
+    export { withAuth };
+    export { withRole };
+    export { hashPassword };
+    export { verifyPassword };
+    export { generateToken };
+    export { withInputValidation };
+}
+export default _default;
+import { createObjectRouter } from './router.js';
+import { ApiError } from './errors.js';
+import { ValidationError } from './errors.js';
+import { AuthenticationError } from './errors.js';
+import { AuthorizationError } from './errors.js';
+import { NotFoundError } from './errors.js';
+import { ConflictError } from './errors.js';
+import { withErrorHandling } from './errors.js';
+import { createErrorHandler } from './errors.js';
+import { validateAgainstSchema } from './validation.js';
+import { validateField } from './validation.js';
+import { withValidation } from './validation.js';
+import { withQueryValidation } from './validation.js';
+import { withParamsValidation } from './validation.js';
+import { serializeDate } from './serialization.js';
+import { deserializeDate } from './serialization.js';
+import { serializeMap } from './serialization.js';
+import { deserializeMap } from './serialization.js';
+import { serializeSet } from './serialization.js';
+import { deserializeSet } from './serialization.js';
+import { withSerialization } from './serialization.js';
+import { serializeForJSON } from './serialization.js';
+import { withAuth } from './security.js';
+import { withRole } from './security.js';
+import { hashPassword } from './security.js';
+import { verifyPassword } from './security.js';
+import { generateToken } from './security.js';
+import { withInputValidation } from './security.js';
+export { createObjectRouter, ApiError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, withErrorHandling, createErrorHandler, validateAgainstSchema, validateField, withValidation, withQueryValidation, withParamsValidation, serializeDate, deserializeDate, serializeMap, deserializeMap, serializeSet, deserializeSet, withSerialization, serializeForJSON, withAuth, withRole, hashPassword, verifyPassword, generateToken, withInputValidation };
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAKmC,aAAa;yBACwG,aAAa;gCAAb,aAAa;oCAAb,aAAa;mCAAb,aAAa;8BAAb,aAAa;8BAAb,aAAa;kCAAb,aAAa;mCAAb,aAAa;sCACrD,iBAAiB;8BAAjB,iBAAiB;+BAAjB,iBAAiB;oCAAjB,iBAAiB;qCAAjB,iBAAiB;8BACe,oBAAoB;gCAApB,oBAAoB;6BAApB,oBAAoB;+BAApB,oBAAoB;6BAApB,oBAAoB;+BAApB,oBAAoB;kCAApB,oBAAoB;iCAApB,oBAAoB;yBAC/D,eAAe;yBAAf,eAAe;6BAAf,eAAe;+BAAf,eAAe;8BAAf,eAAe;oCAAf,eAAe"}

package/dist/api/index.js

@@ -0,0 +1,41 @@
+/**
+ * Coherent.js API Module
+ * @fileoverview Core utilities for building APIs with Coherent.js
+ */
+import { createObjectRouter } from './router.js';
+import { ApiError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, withErrorHandling, createErrorHandler } from './errors.js';
+import { validateAgainstSchema, validateField, withValidation, withQueryValidation, withParamsValidation } from './validation.js';
+import { serializeDate, deserializeDate, serializeMap, deserializeMap, serializeSet, deserializeSet, withSerialization, serializeForJSON } from './serialization.js';
+import { withAuth, withRole, hashPassword, verifyPassword, generateToken, withInputValidation } from './security.js';
+export { createObjectRouter, ApiError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, withErrorHandling, createErrorHandler, validateAgainstSchema, validateField, withValidation, withQueryValidation, withParamsValidation, serializeDate, deserializeDate, serializeMap, deserializeMap, serializeSet, deserializeSet, withSerialization, serializeForJSON, withAuth, withRole, hashPassword, verifyPassword, generateToken, withInputValidation };
+export default {
+    createObjectRouter,
+    ApiError,
+    ValidationError,
+    AuthenticationError,
+    AuthorizationError,
+    NotFoundError,
+    ConflictError,
+    withErrorHandling,
+    createErrorHandler,
+    validateAgainstSchema,
+    validateField,
+    withValidation,
+    withQueryValidation,
+    withParamsValidation,
+    serializeDate,
+    deserializeDate,
+    serializeMap,
+    deserializeMap,
+    serializeSet,
+    deserializeSet,
+    withSerialization,
+    serializeForJSON,
+    withAuth,
+    withRole,
+    hashPassword,
+    verifyPassword,
+    generateToken,
+    withInputValidation
+};
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/api/index.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtK,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClI,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrK,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAErH,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,CAAC;AAEF,eAAe;IACb,kBAAkB;IAClB,QAAQ;IACR,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,aAAa;IACb,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,aAAa;IACb,eAAe;IACf,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,cAAc;IACd,aAAa;IACb,mBAAmB;CACpB,CAAC"}

package/dist/api/middleware.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Middleware system for Coherent.js API framework
+ * @fileoverview Common middleware utilities for API routes
+ */
+/**
+ * Creates a custom API middleware with error handling
+ * @param {Function} handler - Middleware handler function
+ * @returns {Function} Middleware function that catches errors
+ */
+export function createApiMiddleware(handler: Function): Function;
+/**
+ * Authentication middleware
+ * @param {Function} verifyToken - Function to verify authentication token
+ * @returns {Function} Middleware function
+ */
+export function withAuth(verifyToken: Function): Function;
+/**
+ * Authorization middleware
+ * @param {Function} checkPermission - Function to check user permissions
+ * @returns {Function} Middleware function
+ */
+export function withPermission(checkPermission: Function): Function;
+/**
+ * Logging middleware
+ * @param {Object} options - Logging options
+ * @returns {Function} Middleware function
+ */
+export function withLogging(options?: Object): Function;
+/**
+ * CORS middleware
+ * @param {Object} options - CORS options
+ * @returns {Function} Middleware function
+ */
+export function withCors(options?: Object): Function;
+/**
+ * Rate limiting middleware
+ * @param {Object} options - Rate limiting options
+ * @returns {Function} Middleware function
+ */
+export function withRateLimit(options?: Object): Function;
+/**
+ * Input sanitization middleware
+ * @param {Object} options - Sanitization options
+ * @returns {Function} Middleware function
+ */
+export function withSanitization(options?: Object): Function;
+declare namespace _default {
+    export { createApiMiddleware };
+    export { withAuth };
+    export { withPermission };
+    export { withLogging };
+    export { withCors };
+    export { withRateLimit };
+    export { withSanitization };
+}
+export default _default;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/api/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/api/middleware.js"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,iEASC;AAED;;;;GAIG;AACH,0DAwBC;AAED;;;;GAIG;AACH,oEA2BC;AAED;;;;GAIG;AACH,sCAHW,MAAM,YAsBhB;AAED;;;;GAIG;AACH,mCAHW,MAAM,YAiChB;AAED;;;;GAIG;AACH,wCAHW,MAAM,YAgEhB;AAED;;;;GAIG;AACH,2CAHW,MAAM,YAyBhB"}