@zudojs/middleware 0.0.1

package/dist/middlewareCore/middlewareCore.compose.js

@@ -0,0 +1,68 @@
+/**
+ * Compose multiple middleware functions into a single handler.
+ *
+ * @module middlewareCore/middlewareCore
+ *
+ * Middleware executes in order (first added = first executed).
+ * Each middleware calls `next()` to proceed to the next one.
+ */
+const MAX_DEPTH = 100;
+/**
+ * Compose an array of middleware into a single function.
+ *
+ * The returned function executes middleware in order.
+ * If no middleware is provided, the handler is called directly.
+ *
+ * @param middlewareList - Array of middleware functions
+ * @param handler - The final handler to execute after all middleware
+ * @returns Composed function
+ */
+export function compose(middlewareList, handler) {
+    if (middlewareList.length === 0) {
+        return handler;
+    }
+    return async (context) => {
+        let index = -1;
+        async function dispatch(i) {
+            if (i <= index) {
+                throw new Error("next() called multiple times");
+            }
+            index = i;
+            if (i < middlewareList.length) {
+                const mw = middlewareList[i];
+                return mw(context, () => dispatch(i + 1));
+            }
+            return handler(context);
+        }
+        return dispatch(0);
+    };
+}
+/**
+ * Sort and filter named middleware by priority.
+ *
+ * @param middlewareList - Array of named middleware
+ * @returns Sorted and filtered array of middleware handler functions
+ */
+export function resolveMiddleware(middlewareList) {
+    return middlewareList
+        .filter((mw) => mw.enabled !== false)
+        .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100))
+        .map((mw) => mw.handler);
+}
+/**
+ * Create a middleware that wraps another with timing.
+ */
+export function withTiming(name, middleware) {
+    return {
+        name,
+        handler: async (ctx, next) => {
+            const start = performance.now();
+            await middleware(ctx, next);
+            const duration = performance.now() - start;
+            if (duration > 100) {
+                console.warn(`[middleware] ${name} took ${duration.toFixed(1)}ms`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=middlewareCore.compose.js.map

package/dist/middlewareCore/middlewareCore.compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareCore.compose.js","sourceRoot":"","sources":["../../src/middlewareCore/middlewareCore.compose.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CACrB,cAAwD,EACxD,OAAgD;IAEhD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,EAAE,OAAiB,EAAoB,EAAE;QACnD,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QAEf,KAAK,UAAU,QAAQ,CAAC,CAAS;YAC/B,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YACD,KAAK,GAAG,CAAC,CAAC;YAEV,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;gBAC9B,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAE,CAAC;gBAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAA6D;IAE7D,OAAO,cAAc;SAClB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,UAAsC;IAEtC,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC3C,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,gBAAgB,IAAI,SAAS,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/middlewareErrors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Middleware-specific error types.
+ *
+ * @module middlewareErrors
+ */
+export { MiddlewareError, MiddlewareTimeoutError, MiddlewareNextCalledMultipleTimesError, } from "./middlewareError.base.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewareErrors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sCAAsC,GACvC,MAAM,2BAA2B,CAAC"}

package/dist/middlewareErrors/index.js

@@ -0,0 +1,7 @@
+/**
+ * Middleware-specific error types.
+ *
+ * @module middlewareErrors
+ */
+export { MiddlewareError, MiddlewareTimeoutError, MiddlewareNextCalledMultipleTimesError, } from "./middlewareError.base.js";
+//# sourceMappingURL=index.js.map

package/dist/middlewareErrors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middlewareErrors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sCAAsC,GACvC,MAAM,2BAA2B,CAAC"}

package/dist/middlewareErrors/middlewareError.base.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Middleware-specific error classes.
+ *
+ * @module middlewareErrors
+ */
+import { BaseError } from "@zudojs/errors";
+/**
+ * Error thrown when a middleware pipeline fails.
+ */
+export declare class MiddlewareError extends BaseError {
+    constructor(message: string, options?: {
+        readonly middlewareName?: string;
+        readonly cause?: unknown;
+    });
+}
+/**
+ * Error thrown when a middleware exceeds its timeout.
+ */
+export declare class MiddlewareTimeoutError extends MiddlewareError {
+    constructor(middlewareName: string, timeoutMs: number);
+}
+/**
+ * Error thrown when a middleware calls next() multiple times.
+ */
+export declare class MiddlewareNextCalledMultipleTimesError extends MiddlewareError {
+    constructor(middlewareName: string);
+}
+//# sourceMappingURL=middlewareError.base.d.ts.map

package/dist/middlewareErrors/middlewareError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareError.base.d.ts","sourceRoot":"","sources":["../../src/middlewareErrors/middlewareError.base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EAIV,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;KAC1B,EAWF;CACF;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;IACzD,YAAY,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAIpD;CACF;AAED;;GAEG;AACH,qBAAa,sCAAuC,SAAQ,eAAe;IACzE,YAAY,cAAc,EAAE,MAAM,EAIjC;CACF"}

package/dist/middlewareErrors/middlewareError.base.js

@@ -0,0 +1,43 @@
+/**
+ * Middleware-specific error classes.
+ *
+ * @module middlewareErrors
+ */
+import { BaseError, ErrorCode, ErrorCategory, ErrorSeverity, } from "@zudojs/errors";
+/**
+ * Error thrown when a middleware pipeline fails.
+ */
+export class MiddlewareError extends BaseError {
+    constructor(message, options) {
+        super(message, {
+            code: ErrorCode.OPERATION_FAILED,
+            category: ErrorCategory.INTERNAL,
+            severity: ErrorSeverity.ERROR,
+            metadata: {
+                middlewareName: options?.middlewareName,
+            },
+            cause: options?.cause,
+        });
+    }
+}
+/**
+ * Error thrown when a middleware exceeds its timeout.
+ */
+export class MiddlewareTimeoutError extends MiddlewareError {
+    constructor(middlewareName, timeoutMs) {
+        super(`Middleware "${middlewareName}" timed out after ${timeoutMs}ms`, {
+            middlewareName,
+        });
+    }
+}
+/**
+ * Error thrown when a middleware calls next() multiple times.
+ */
+export class MiddlewareNextCalledMultipleTimesError extends MiddlewareError {
+    constructor(middlewareName) {
+        super(`Middleware "${middlewareName}" called next() multiple times`, {
+            middlewareName,
+        });
+    }
+}
+//# sourceMappingURL=middlewareError.base.js.map

package/dist/middlewareErrors/middlewareError.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareError.base.js","sourceRoot":"","sources":["../../src/middlewareErrors/middlewareError.base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,YACE,OAAe,EACf,OAGC;QAED,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,QAAQ,EAAE,aAAa,CAAC,QAAQ;YAChC,QAAQ,EAAE,aAAa,CAAC,KAAK;YAC7B,QAAQ,EAAE;gBACR,cAAc,EAAE,OAAO,EAAE,cAAc;aACxC;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,YAAY,cAAsB,EAAE,SAAiB;QACnD,KAAK,CAAC,eAAe,cAAc,qBAAqB,SAAS,IAAI,EAAE;YACrE,cAAc;SACf,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sCAAuC,SAAQ,eAAe;IACzE,YAAY,cAAsB;QAChC,KAAK,CAAC,eAAe,cAAc,gCAAgC,EAAE;YACnE,cAAc;SACf,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/middlewarePipeline/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Middleware pipeline with execution tracking and result reporting.
+ *
+ * @module middlewarePipeline
+ */
+export { createPipeline } from "./middlewarePipeline.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewarePipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/middlewarePipeline/index.js

@@ -0,0 +1,7 @@
+/**
+ * Middleware pipeline with execution tracking and result reporting.
+ *
+ * @module middlewarePipeline
+ */
+export { createPipeline } from "./middlewarePipeline.core.js";
+//# sourceMappingURL=index.js.map

package/dist/middlewarePipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middlewarePipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/middlewarePipeline/middlewarePipeline.core.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Middleware pipeline with execution tracking and result reporting.
+ *
+ * @module middlewarePipeline/middlewarePipeline
+ */
+import type { NamedMiddleware } from "../middlewareTypes/middlewareDefinition.type.js";
+import type { PipelineResult, PipelineOptions } from "../middlewareTypes/middlewareContext.type.js";
+/**
+ * Create a middleware pipeline that tracks execution.
+ *
+ * @param middlewareList - Named middleware to include
+ * @param handler - Final handler function
+ * @param options - Pipeline configuration
+ * @returns Pipeline execution function
+ */
+export declare function createPipeline<TContext, TResult>(middlewareList: readonly NamedMiddleware<TContext, TResult>[], handler: (context: TContext) => Promise<TResult>, options?: PipelineOptions): (context: TContext) => Promise<PipelineResult<TResult>>;
+//# sourceMappingURL=middlewarePipeline.core.d.ts.map

package/dist/middlewarePipeline/middlewarePipeline.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewarePipeline.core.d.ts","sourceRoot":"","sources":["../../src/middlewarePipeline/middlewarePipeline.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAChB,MAAM,8CAA8C,CAAC;AAKtD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAC9C,cAAc,EAAE,SAAS,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAC7D,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,EAChD,OAAO,CAAC,EAAE,eAAe,GACxB,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAuDzD"}

package/dist/middlewarePipeline/middlewarePipeline.core.js

@@ -0,0 +1,65 @@
+/**
+ * Middleware pipeline with execution tracking and result reporting.
+ *
+ * @module middlewarePipeline/middlewarePipeline
+ */
+import { resolveMiddleware } from "../middlewareCore/middlewareCore.compose.js";
+const DEFAULT_MAX = 50;
+/**
+ * Create a middleware pipeline that tracks execution.
+ *
+ * @param middlewareList - Named middleware to include
+ * @param handler - Final handler function
+ * @param options - Pipeline configuration
+ * @returns Pipeline execution function
+ */
+export function createPipeline(middlewareList, handler, options) {
+    const resolved = resolveMiddleware(middlewareList);
+    const maxMiddleware = options?.maxMiddleware ?? DEFAULT_MAX;
+    const stopOnError = options?.stopOnError ?? true;
+    if (resolved.length > maxMiddleware) {
+        throw new Error(`Pipeline has ${resolved.length} middleware, exceeding maximum of ${maxMiddleware}`);
+    }
+    const enabledNames = middlewareList
+        .filter((mw) => mw.enabled !== false)
+        .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100))
+        .map((mw) => mw.name);
+    return async (context) => {
+        const startTime = performance.now();
+        const executed = [];
+        let index = -1;
+        async function dispatch(i) {
+            if (i <= index) {
+                throw new Error("next() called multiple times");
+            }
+            index = i;
+            if (i < resolved.length) {
+                executed.push(enabledNames[i] ?? `middleware-${i}`);
+                const mw = resolved[i];
+                return mw(context, () => dispatch(i + 1));
+            }
+            return handler(context);
+        }
+        try {
+            const result = await dispatch(0);
+            return {
+                success: true,
+                result,
+                durationMs: performance.now() - startTime,
+                executedMiddleware: executed,
+            };
+        }
+        catch (error) {
+            if (stopOnError) {
+                return {
+                    success: false,
+                    error,
+                    durationMs: performance.now() - startTime,
+                    executedMiddleware: executed,
+                };
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=middlewarePipeline.core.js.map

package/dist/middlewarePipeline/middlewarePipeline.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewarePipeline.core.js","sourceRoot":"","sources":["../../src/middlewarePipeline/middlewarePipeline.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAEhF,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,cAA6D,EAC7D,OAAgD,EAChD,OAAyB;IAEzB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,WAAW,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IAEjD,IAAI,QAAQ,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,gBAAgB,QAAQ,CAAC,MAAM,qCAAqC,aAAa,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,cAAc;SAChC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAExB,OAAO,KAAK,EAAE,OAAiB,EAAoC,EAAE;QACnE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QAEf,KAAK,UAAU,QAAQ,CAAC,CAAS;YAC/B,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YACD,KAAK,GAAG,CAAC,CAAC;YAEV,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;gBACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;gBACxB,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;gBACN,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS;gBACzC,kBAAkB,EAAE,QAAQ;aAC7B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK;oBACL,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS;oBACzC,kBAAkB,EAAE,QAAQ;iBAC7B,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/middlewareTypes/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core middleware type definitions: functions, contexts, and pipelines.
+ *
+ * @module middlewareTypes
+ */
+export { type Middleware, type NamedMiddleware, type MiddlewareFactory, } from "./middlewareDefinition.type.js";
+export { type PipelineResult, type PipelineOptions, } from "./middlewareContext.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewareTypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/middlewareTypes/index.js

@@ -0,0 +1,8 @@
+/**
+ * Core middleware type definitions: functions, contexts, and pipelines.
+ *
+ * @module middlewareTypes
+ */
+export {} from "./middlewareDefinition.type.js";
+export {} from "./middlewareContext.type.js";
+//# sourceMappingURL=index.js.map

package/dist/middlewareTypes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middlewareTypes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIN,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAGN,MAAM,6BAA6B,CAAC"}

package/dist/middlewareTypes/middlewareContext.type.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Middleware context and pipeline result types.
+ *
+ * @module middlewareTypes/middlewareContext
+ */
+/**
+ * Result of executing a middleware pipeline.
+ */
+export interface PipelineResult<TResult> {
+    /** Whether the pipeline completed successfully */
+    readonly success: boolean;
+    /** The result value (if successful) */
+    readonly result?: TResult;
+    /** Error that occurred (if failed) */
+    readonly error?: unknown;
+    /** Execution time in milliseconds */
+    readonly durationMs: number;
+    /** Names of middleware that executed */
+    readonly executedMiddleware: readonly string[];
+}
+/**
+ * Options for creating a middleware pipeline.
+ */
+export interface PipelineOptions {
+    /** Maximum number of middleware allowed */
+    readonly maxMiddleware?: number;
+    /** Whether to stop on first error (default: true) */
+    readonly stopOnError?: boolean;
+}
+//# sourceMappingURL=middlewareContext.type.d.ts.map

package/dist/middlewareTypes/middlewareContext.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareContext.type.d.ts","sourceRoot":"","sources":["../../src/middlewareTypes/middlewareContext.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO;IACrC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/middlewareTypes/middlewareContext.type.js

@@ -0,0 +1,7 @@
+/**
+ * Middleware context and pipeline result types.
+ *
+ * @module middlewareTypes/middlewareContext
+ */
+export {};
+//# sourceMappingURL=middlewareContext.type.js.map

package/dist/middlewareTypes/middlewareContext.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareContext.type.js","sourceRoot":"","sources":["../../src/middlewareTypes/middlewareContext.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/middlewareTypes/middlewareDefinition.type.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Core middleware type definitions.
+ *
+ * @module middlewareTypes/middlewareDefinition
+ */
+/**
+ * A middleware function that processes a context and calls the next middleware.
+ *
+ * @typeParam TContext - The context type flowing through the pipeline
+ * @typeParam TResult - The result type returned by the pipeline
+ */
+export type Middleware<TContext, TResult = void> = (context: TContext, next: () => Promise<TResult>) => Promise<TResult>;
+/**
+ * A middleware function with metadata.
+ */
+export interface NamedMiddleware<TContext, TResult = void> {
+    /** Human-readable name for debugging */
+    readonly name: string;
+    /** The middleware function */
+    readonly handler: Middleware<TContext, TResult>;
+    /** Execution priority (lower = earlier). Default: 100 */
+    readonly priority?: number;
+    /** Whether this middleware is enabled */
+    readonly enabled?: boolean;
+}
+/**
+ * Middleware factory function.
+ */
+export type MiddlewareFactory<TContext, TResult = void> = (options?: Record<string, unknown>) => NamedMiddleware<TContext, TResult>;
+//# sourceMappingURL=middlewareDefinition.type.d.ts.map

package/dist/middlewareTypes/middlewareDefinition.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareDefinition.type.d.ts","sourceRoot":"","sources":["../../src/middlewareTypes/middlewareDefinition.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,IAAI,CACjD,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KACzB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IACvD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,IAAI,CACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC"}

package/dist/middlewareTypes/middlewareDefinition.type.js

@@ -0,0 +1,7 @@
+/**
+ * Core middleware type definitions.
+ *
+ * @module middlewareTypes/middlewareDefinition
+ */
+export {};
+//# sourceMappingURL=middlewareDefinition.type.js.map

package/dist/middlewareTypes/middlewareDefinition.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareDefinition.type.js","sourceRoot":"","sources":["../../src/middlewareTypes/middlewareDefinition.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/middlewareUtils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Built-in middleware: logging, error handling, timeout, rate limiting.
+ *
+ * @module middlewareUtils
+ */
+export { loggingMiddleware, errorMiddleware, timeoutMiddleware, rateLimitMiddleware, } from "./middlewareUtils.builtins.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewareUtils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC"}

package/dist/middlewareUtils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Built-in middleware: logging, error handling, timeout, rate limiting.
+ *
+ * @module middlewareUtils
+ */
+export { loggingMiddleware, errorMiddleware, timeoutMiddleware, rateLimitMiddleware, } from "./middlewareUtils.builtins.js";
+//# sourceMappingURL=index.js.map

package/dist/middlewareUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middlewareUtils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC"}

package/dist/middlewareUtils/middlewareUtils.builtins.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Built-in middleware for common concerns.
+ *
+ * @module middlewareUtils/middlewareUtils
+ */
+import type { NamedMiddleware } from "../middlewareTypes/middlewareDefinition.type.js";
+export interface LoggingContext {
+    readonly requestId?: string;
+    readonly path?: string;
+    readonly method?: string;
+}
+/**
+ * Create a logging middleware.
+ *
+ * Logs request start, completion, and errors.
+ */
+export declare function loggingMiddleware(logger?: (msg: string) => void): NamedMiddleware<LoggingContext>;
+/**
+ * Create an error-handling middleware.
+ *
+ * Catches errors and wraps them with context.
+ */
+export declare function errorMiddleware(onError?: (error: unknown, ctx: unknown) => void): NamedMiddleware<unknown>;
+/**
+ * Create a timeout middleware.
+ *
+ * Rejects if the pipeline takes too long.
+ */
+export declare function timeoutMiddleware<TContext>(timeoutMs: number): NamedMiddleware<TContext>;
+/**
+ * Create a rate-limiting middleware.
+ *
+ * Uses a sliding window counter per key.
+ */
+export declare function rateLimitMiddleware<TContext extends {
+    readonly key?: string;
+}>(maxRequests: number, windowMs: number): NamedMiddleware<TContext>;
+//# sourceMappingURL=middlewareUtils.builtins.d.ts.map

package/dist/middlewareUtils/middlewareUtils.builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareUtils.builtins.d.ts","sourceRoot":"","sources":["../../src/middlewareUtils/middlewareUtils.builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,iDAAiD,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC7B,eAAe,CAAC,cAAc,CAAC,CAkBjC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GAC/C,eAAe,CAAC,OAAO,CAAC,CAa1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EACxC,SAAS,EAAE,MAAM,GAChB,eAAe,CAAC,QAAQ,CAAC,CAe3B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5E,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,eAAe,CAAC,QAAQ,CAAC,CAyB3B"}

package/dist/middlewareUtils/middlewareUtils.builtins.js

@@ -0,0 +1,92 @@
+/**
+ * Built-in middleware for common concerns.
+ *
+ * @module middlewareUtils/middlewareUtils
+ */
+/**
+ * Create a logging middleware.
+ *
+ * Logs request start, completion, and errors.
+ */
+export function loggingMiddleware(logger) {
+    const log = logger ?? console.log;
+    return {
+        name: "logging",
+        handler: async (ctx, next) => {
+            const start = performance.now();
+            log(`[middleware] → ${ctx.method ?? "UNKNOWN"} ${ctx.path ?? "/"}`);
+            try {
+                await next();
+                const ms = (performance.now() - start).toFixed(1);
+                log(`[middleware] ✓ completed in ${ms}ms`);
+            }
+            catch (error) {
+                const ms = (performance.now() - start).toFixed(1);
+                log(`[middleware] ✗ failed in ${ms}ms: ${error}`);
+                throw error;
+            }
+        },
+    };
+}
+/**
+ * Create an error-handling middleware.
+ *
+ * Catches errors and wraps them with context.
+ */
+export function errorMiddleware(onError) {
+    return {
+        name: "error-handler",
+        priority: 0,
+        handler: async (ctx, next) => {
+            try {
+                return await next();
+            }
+            catch (error) {
+                onError?.(error, ctx);
+                throw error;
+            }
+        },
+    };
+}
+/**
+ * Create a timeout middleware.
+ *
+ * Rejects if the pipeline takes too long.
+ */
+export function timeoutMiddleware(timeoutMs) {
+    return {
+        name: "timeout",
+        handler: async (ctx, next) => {
+            return Promise.race([
+                next(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Middleware timeout after ${timeoutMs}ms`)), timeoutMs)),
+            ]);
+        },
+    };
+}
+/**
+ * Create a rate-limiting middleware.
+ *
+ * Uses a sliding window counter per key.
+ */
+export function rateLimitMiddleware(maxRequests, windowMs) {
+    const counts = new Map();
+    return {
+        name: "rate-limit",
+        handler: async (ctx, next) => {
+            const key = ctx.key ?? "global";
+            const now = Date.now();
+            const entry = counts.get(key);
+            if (!entry || now > entry.resetAt) {
+                counts.set(key, { count: 1, resetAt: now + windowMs });
+                return next();
+            }
+            if (entry.count >= maxRequests) {
+                throw new Error(`Rate limit exceeded: ${maxRequests} requests per ${windowMs}ms`);
+            }
+            entry.count++;
+            return next();
+        },
+    };
+}
+//# sourceMappingURL=middlewareUtils.builtins.js.map

package/dist/middlewareUtils/middlewareUtils.builtins.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@zudojs/middleware",
+  "version": "0.0.1",
+  "description": "Composable middleware pipeline with composition, timing, error handling, and context propagation.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@zudojs/errors": "0.0.1"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "middleware",
+    "pipeline",
+    "composition"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}