serverless-event-orchestrator 1.0.1

package/dist/types/routes.d.ts

@@ -0,0 +1,163 @@
+import { RouteSegment } from './event-type.enum.js';
+/**
+ * HTTP methods supported by the router
+ */
+export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+/**
+ * Middleware function signature
+ * Returns the modified event or throws an error to halt execution
+ */
+export type MiddlewareFn = (event: NormalizedEvent) => Promise<NormalizedEvent | void>;
+/**
+ * Route configuration for a single endpoint
+ */
+export interface RouteConfig {
+    handler: (event: NormalizedEvent) => Promise<any>;
+    middleware?: MiddlewareFn[];
+    cors?: boolean | CorsConfig;
+    rateLimit?: RateLimitConfig;
+}
+/**
+ * CORS configuration options
+ */
+export interface CorsConfig {
+    origins: string[] | '*';
+    methods?: string[];
+    headers?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+    exposedHeaders?: string[];
+}
+/**
+ * Rate limit configuration
+ */
+export interface RateLimitConfig {
+    burstLimit: number;
+    rateLimit: number;
+}
+/**
+ * Standard HTTP router structure
+ * Maps HTTP methods to path-handler pairs
+ */
+export type HttpRouter = {
+    [K in HttpMethod]?: {
+        [path: string]: RouteConfig;
+    };
+};
+/**
+ * Segmented HTTP router for access control categorization
+ * Allows organizing routes by security context
+ */
+export interface SegmentedHttpRouter {
+    public?: HttpRouter;
+    private?: HttpRouter;
+    backoffice?: HttpRouter;
+    internal?: HttpRouter;
+}
+/**
+ * Segment configuration with optional middleware
+ */
+export interface SegmentConfig {
+    routes: HttpRouter;
+    middleware?: MiddlewareFn[];
+}
+/**
+ * Advanced segmented router with per-segment middleware
+ */
+export interface AdvancedSegmentedRouter {
+    public?: SegmentConfig | HttpRouter;
+    private?: SegmentConfig | HttpRouter;
+    backoffice?: SegmentConfig | HttpRouter;
+    internal?: SegmentConfig | HttpRouter;
+}
+/**
+ * EventBridge routes configuration
+ * Maps operation names to handlers
+ */
+export type EventBridgeRoutes = Record<string, (event: NormalizedEvent) => Promise<any>>;
+/**
+ * Lambda invocation routes
+ */
+export type LambdaRoutes = Record<string, (event: NormalizedEvent) => Promise<any>>;
+/**
+ * SQS queue routes
+ * Maps queue names to handlers
+ */
+export type SqsRoutes = Record<string, (event: NormalizedEvent) => Promise<any>>;
+/**
+ * Complete dispatch routes configuration
+ */
+export interface DispatchRoutes {
+    apigateway?: HttpRouter | SegmentedHttpRouter | AdvancedSegmentedRouter;
+    eventbridge?: EventBridgeRoutes;
+    lambda?: LambdaRoutes;
+    sqs?: SqsRoutes;
+}
+/**
+ * Identity context extracted from the event
+ */
+export interface IdentityContext {
+    userId?: string;
+    email?: string;
+    groups?: string[];
+    issuer?: string;
+    claims?: Record<string, any>;
+}
+/**
+ * Route match result with extracted parameters
+ */
+export interface RouteMatch {
+    handler: (event: NormalizedEvent) => Promise<any>;
+    params: Record<string, string>;
+    segment: RouteSegment;
+    middleware?: MiddlewareFn[];
+    config: RouteConfig;
+}
+/**
+ * Normalized event structure passed to handlers
+ */
+export interface NormalizedEvent {
+    eventRaw: any;
+    eventType: string;
+    payload: {
+        body?: Record<string, any>;
+        pathParameters?: Record<string, string>;
+        queryStringParameters?: Record<string, string>;
+        headers?: Record<string, string>;
+    };
+    params: Record<string, string>;
+    context: {
+        segment: RouteSegment;
+        identity?: IdentityContext;
+        requestId?: string;
+    };
+}
+/**
+ * Orchestrator configuration options
+ */
+export interface OrchestratorConfig {
+    /**
+     * Enable verbose logging for debugging
+     */
+    debug?: boolean;
+    /**
+     * User Pool ID mappings for segment-based validation
+     */
+    userPools?: {
+        [K in RouteSegment]?: string;
+    };
+    /**
+     * Global middleware applied to all routes
+     */
+    globalMiddleware?: MiddlewareFn[];
+    /**
+     * Custom response handlers
+     */
+    responses?: {
+        notFound?: () => any;
+        forbidden?: () => any;
+        badRequest?: (message?: string) => any;
+        internalError?: (message?: string) => any;
+    };
+}
+//# sourceMappingURL=routes.d.ts.map

package/dist/types/routes.d.ts.map

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

package/dist/types/routes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=routes.js.map

package/dist/types/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/types/routes.ts"],"names":[],"mappings":""}

package/dist/utils/headers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Header normalization utilities
+ * HTTP headers are case-insensitive, this ensures consistent access
+ */
+/**
+ * Normalizes headers to lowercase keys for consistent access
+ * @param headers - Original headers object
+ * @returns Headers with lowercase keys
+ */
+export declare function normalizeHeaders(headers: Record<string, string> | undefined): Record<string, string>;
+/**
+ * Gets a header value case-insensitively
+ * @param headers - Headers object
+ * @param name - Header name to find
+ * @returns Header value or undefined
+ */
+export declare function getHeader(headers: Record<string, string> | undefined, name: string): string | undefined;
+/**
+ * Standard CORS headers for preflight responses
+ */
+export declare function getCorsHeaders(config?: {
+    origins?: string[] | '*';
+    methods?: string[];
+    headers?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/utils/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUpG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE;IACtC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBzB"}

package/dist/utils/headers.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Header normalization utilities
+ * HTTP headers are case-insensitive, this ensures consistent access
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeHeaders = normalizeHeaders;
+exports.getHeader = getHeader;
+exports.getCorsHeaders = getCorsHeaders;
+/**
+ * Normalizes headers to lowercase keys for consistent access
+ * @param headers - Original headers object
+ * @returns Headers with lowercase keys
+ */
+function normalizeHeaders(headers) {
+    if (!headers)
+        return {};
+    const normalized = {};
+    for (const [key, value] of Object.entries(headers)) {
+        normalized[key.toLowerCase()] = value;
+    }
+    return normalized;
+}
+/**
+ * Gets a header value case-insensitively
+ * @param headers - Headers object
+ * @param name - Header name to find
+ * @returns Header value or undefined
+ */
+function getHeader(headers, name) {
+    if (!headers)
+        return undefined;
+    const normalizedName = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === normalizedName) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Standard CORS headers for preflight responses
+ */
+function getCorsHeaders(config) {
+    const origin = config?.origins === '*' ? '*' : (config?.origins?.join(', ') || '*');
+    const methods = config?.methods?.join(', ') || 'GET,POST,PUT,DELETE,PATCH,OPTIONS';
+    const headers = config?.headers?.join(', ') || 'Content-Type,Authorization,X-Amz-Date,X-Api-Key,X-Amz-Security-Token';
+    const corsHeaders = {
+        'Access-Control-Allow-Origin': origin,
+        'Access-Control-Allow-Methods': methods,
+        'Access-Control-Allow-Headers': headers,
+    };
+    if (config?.credentials) {
+        corsHeaders['Access-Control-Allow-Credentials'] = 'true';
+    }
+    if (config?.maxAge) {
+        corsHeaders['Access-Control-Max-Age'] = String(config.maxAge);
+    }
+    return corsHeaders;
+}
+//# sourceMappingURL=headers.js.map

package/dist/utils/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,4CAUC;AAQD,8BAYC;AAKD,wCA0BC;AAlED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,OAA2C;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAA2C,EAAE,IAAY;IACjF,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAM9B;IACC,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,mCAAmC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,sEAAsE,CAAC;IAEtH,MAAM,WAAW,GAA2B;QAC1C,6BAA6B,EAAE,MAAM;QACrC,8BAA8B,EAAE,OAAO;QACvC,8BAA8B,EAAE,OAAO;KACxC,CAAC;IAEF,IAAI,MAAM,EAAE,WAAW,EAAE,CAAC;QACxB,WAAW,CAAC,kCAAkC,CAAC,GAAG,MAAM,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,wBAAwB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './path-matcher.js';
+export * from './headers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./path-matcher.js"), exports);
+__exportStar(require("./headers.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,+CAA6B"}

package/dist/utils/path-matcher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Path matching utilities for extracting path parameters
+ * Supports patterns like /users/{id} and /users/{userId}/posts/{postId}
+ */
+/**
+ * Converts a route pattern to a regex and extracts parameter names
+ * @param pattern - Route pattern like /users/{id}
+ * @returns Object with regex and parameter names
+ */
+export declare function patternToRegex(pattern: string): {
+    regex: RegExp;
+    paramNames: string[];
+};
+/**
+ * Matches a path against a pattern and extracts parameters
+ * @param pattern - Route pattern like /users/{id}
+ * @param path - Actual path like /users/123
+ * @returns Extracted parameters or null if no match
+ */
+export declare function matchPath(pattern: string, path: string): Record<string, string> | null;
+/**
+ * Checks if a pattern contains path parameters
+ * @param pattern - Route pattern to check
+ * @returns True if pattern has parameters
+ */
+export declare function hasPathParameters(pattern: string): boolean;
+/**
+ * Normalizes a path by removing trailing slashes and ensuring leading slash
+ * @param path - Path to normalize
+ * @returns Normalized path
+ */
+export declare function normalizePath(path: string): string;
+//# sourceMappingURL=path-matcher.d.ts.map

package/dist/utils/path-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-matcher.d.ts","sourceRoot":"","sources":["../../src/utils/path-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBvF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CActF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD"}

package/dist/utils/path-matcher.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Path matching utilities for extracting path parameters
+ * Supports patterns like /users/{id} and /users/{userId}/posts/{postId}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patternToRegex = patternToRegex;
+exports.matchPath = matchPath;
+exports.hasPathParameters = hasPathParameters;
+exports.normalizePath = normalizePath;
+/**
+ * Converts a route pattern to a regex and extracts parameter names
+ * @param pattern - Route pattern like /users/{id}
+ * @returns Object with regex and parameter names
+ */
+function patternToRegex(pattern) {
+    const paramNames = [];
+    // Escape special regex characters except for our parameter syntax
+    let regexPattern = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+        .replace(/\\\{(\w+)\\\}/g, (_, paramName) => {
+        paramNames.push(paramName);
+        return '([^/]+)';
+    });
+    // Ensure exact match
+    regexPattern = `^${regexPattern}$`;
+    return {
+        regex: new RegExp(regexPattern),
+        paramNames,
+    };
+}
+/**
+ * Matches a path against a pattern and extracts parameters
+ * @param pattern - Route pattern like /users/{id}
+ * @param path - Actual path like /users/123
+ * @returns Extracted parameters or null if no match
+ */
+function matchPath(pattern, path) {
+    const { regex, paramNames } = patternToRegex(pattern);
+    const match = path.match(regex);
+    if (!match) {
+        return null;
+    }
+    const params = {};
+    paramNames.forEach((name, index) => {
+        params[name] = match[index + 1];
+    });
+    return params;
+}
+/**
+ * Checks if a pattern contains path parameters
+ * @param pattern - Route pattern to check
+ * @returns True if pattern has parameters
+ */
+function hasPathParameters(pattern) {
+    return /\{[\w]+\}/.test(pattern);
+}
+/**
+ * Normalizes a path by removing trailing slashes and ensuring leading slash
+ * @param path - Path to normalize
+ * @returns Normalized path
+ */
+function normalizePath(path) {
+    if (!path)
+        return '/';
+    // Ensure leading slash
+    let normalized = path.startsWith('/') ? path : `/${path}`;
+    // Remove trailing slash (except for root)
+    if (normalized.length > 1 && normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+//# sourceMappingURL=path-matcher.js.map

package/dist/utils/path-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-matcher.js","sourceRoot":"","sources":["../../src/utils/path-matcher.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,wCAkBC;AAQD,8BAcC;AAOD,8CAEC;AAOD,sCAYC;AAzED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,kEAAkE;IAClE,IAAI,YAAY,GAAG,OAAO;SACvB,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SACrC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QAC1C,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEL,qBAAqB;IACrB,YAAY,GAAG,IAAI,YAAY,GAAG,CAAC;IAEnC,OAAO;QACL,KAAK,EAAE,IAAI,MAAM,CAAC,YAAY,CAAC;QAC/B,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAAe,EAAE,IAAY;IACrD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAEtB,uBAAuB;IACvB,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAE1D,0CAA0C;IAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/jest.config.js

@@ -0,0 +1,32 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1'
+  },
+  transform: {
+    '^.+\\.tsx?$': ['ts-jest', {
+      useESM: false,
+      tsconfig: {
+        module: 'commonjs',
+        moduleResolution: 'node'
+      }
+    }]
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/**/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 70,
+      functions: 90,
+      lines: 80,
+      statements: 80
+    }
+  }
+};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "serverless-event-orchestrator",
+  "version": "1.0.1",
+  "description": "A lightweight, type-safe event dispatcher and middleware orchestrator for AWS Lambda. Designed for hexagonal architectures with support for segmented routing (public, private, backoffice), Cognito User Pool validation, and built-in infrastructure middlewares.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./http": {
+      "import": "./dist/http/index.js",
+      "require": "./dist/http/index.js",
+      "types": "./dist/http/index.d.ts"
+    },
+    "./identity": {
+      "import": "./dist/identity/index.js",
+      "require": "./dist/identity/index.js",
+      "types": "./dist/identity/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watchAll",
+    "test:coverage": "jest --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/carlosmora01/serverless-event-orchestrator.git"
+  },
+  "keywords": [
+    "aws",
+    "lambda",
+    "serverless",
+    "eventbridge",
+    "apigateway",
+    "sqs",
+    "router",
+    "dispatcher",
+    "cognito",
+    "middleware",
+    "hexagonal-architecture"
+  ],
+  "author": "Carlos Mora",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/carlosmora01/serverless-event-orchestrator/issues"
+  },
+  "homepage": "https://github.com/carlosmora01/serverless-event-orchestrator#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "@types/aws-lambda": "^8.10.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}