import { each as eachAsync } from '../eachAsync.js'; import { NotHandled, convertToErrorMiddleware, convertToMiddleware, isErrorMiddleware, isStandardMiddleware } from './shared.js'; import type { AnyAsyncMiddleware, MiddlewareAsync, MiddlewarePromise, MiddlewareResult, OptionsResponse, SpecialNextParam } from './shared.js'; // eslint-disable-next-line @typescript-eslint/no-empty-interface, @typescript-eslint/no-unused-vars export interface ExtendableCompositeMiddlewareAsync { } /** * A class representing a composite middleware that handles asynchronous operations. */ export class MiddlewareCompositeAsync implements MiddlewareAsync, ExtendableCompositeMiddlewareAsync { public readonly name?: string /** * Creates an instance of MiddlewareCompositeAsync. * @param {string} [name] - The name of the middleware composite. */ constructor(name?: string) { this.name = name; } /** * Creates a new MiddlewareCompositeAsync instance with the provided middlewares. * @param {...AnyAsyncMiddleware[]} middlewares - The middlewares to be used. * @returns {MiddlewareCompositeAsync} A new MiddlewareCompositeAsync instance. */ public static new(...middlewares: AnyAsyncMiddleware[]) { return new MiddlewareCompositeAsync().useMiddleware(...middlewares); } private readonly stack: AnyAsyncMiddleware[] = []; /** * Adds middlewares to the stack. * @param {...AnyAsyncMiddleware[]} middlewares - The middlewares to be added. * @returns {this} The current instance of MiddlewareCompositeAsync. */ public useMiddleware(...middlewares: AnyAsyncMiddleware[]): this { this.stack.push(...middlewares); return this; } /** * Adds standard middlewares to the stack. * @param {...((...args: T) => Promise)[]} middlewares - The standard middlewares to be added. * @returns {this} The current instance of MiddlewareCompositeAsync. */ public use(...middlewares: ((...args: T) => Promise)[]): this { return this.useMiddleware(...middlewares.map(m => convertToMiddleware(m))); } /** * Adds error middlewares to the stack. * @param {...((error: Error | OptionsResponse, ...args: T) => Promise)[]} middlewares - The error middlewares to be added. * @returns {this} The current instance of MiddlewareCompositeAsync. */ public useError(...middlewares: ((error: Error | OptionsResponse, ...args: T) => Promise)[]): this { return this.useMiddleware(...middlewares.map(m => convertToErrorMiddleware(m))); } /** * Processes the request and returns a promise. * @param {...T} req - The request parameters. * @returns {Promise} A promise that resolves or rejects based on the middleware processing. */ public process(...req: T): Promise { return this.handle(...req).then(x => Promise.reject(x), x => Promise.resolve(x)); } /** * Handles errors in the middleware stack. * @param {MiddlewareResult} error - The error to be handled. * @param {...T} req - The request parameters. * @returns {MiddlewarePromise} A promise that resolves or rejects based on the error handling. */ public async handleError(error: MiddlewareResult, ...req: T): MiddlewarePromise { let failed: boolean = !!error; try { if (this.stack.length === 0) return error; await eachAsync(this.stack, async (middleware) => { try { if (failed && isErrorMiddleware(middleware)) { const err = await middleware.handleError(error as Error, ...req); if (err === 'break') throw err; if (typeof err != 'string' && typeof err != 'undefined') error = err; failed = true; } } catch (x) { throw { success: x }; } }, true); return error; } catch (err) { switch (typeof err) { case 'string': return; case 'undefined': return error; default: throw err.success; } } } /** * Handles the middleware stack. * @param {...T} req - The request parameters. * @returns {MiddlewarePromise} A promise that resolves or rejects based on the middleware processing. */ public async handle(...req: T): MiddlewarePromise { let error: Error | OptionsResponse = undefined; let failed: boolean = undefined; try { if (this.stack.length === 0) return error; await eachAsync(this.stack, (middleware) => { if (failed && isErrorMiddleware(middleware)) { return middleware.handleError(error as Error, ...req).then(err => { if (err === 'break') throw err; if (typeof err != 'string' && typeof err != 'undefined') error = err; failed = true; }) } else if (!failed && isStandardMiddleware(middleware)) { return middleware.handle(...req).then(err => { if (err === 'break') throw err; if (typeof err != 'string' && typeof err != 'undefined') { if (err['allow']) error['allow'].push(...err['allow']); else error = err; } failed = err instanceof Error; }).catch(e => Promise.reject({ success: e })) } return NotHandled; }, true); return error; } catch (err) { switch (typeof err) { case 'string': return; case 'undefined': return error; default: throw err.success; } } } }