arkos 2.0.0-next.3 → 2.0.0-next.30

package/dist/esm/utils/arkos-router/types/upload-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload-config.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/upload-config.ts"],"names":[],"mappings":"","sourcesContent":["export type UploadConfig =\n  /**\n   * Creates middleware that processes a single file associated with the\n   * given form field.\n   *\n   * The `Request` object will be populated with a `file` object containing\n   * information about the processed file.\n   *\n   * @example\n   * uploads: {\n   *   type: \"single\",\n   *   field: \"avatar\",\n   *   uploadDir: \"images\",\n   *   maxSize: 1024 * 1024 * 5 // 5MB\n   * }\n   */\n  | ({\n      type: \"single\";\n      /** Name of the multipart form field to process */\n      field: string;\n    } & ArkosRouterBaseUploadConfig)\n  /**\n   * Returns middleware that processes multiple files sharing the same field\n   * name.\n   *\n   * The `Request` object will be populated with a `files` array containing\n   * an information object for each processed file.\n   *\n   * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName`\n   *\n   * @example\n   * uploads: {\n   *   type: \"array\",\n   *   field: \"gallery\",\n   *   maxCount: 10,\n   *   minCount: 1,\n   *   uploadDir: \"images\"\n   * }\n   */\n  | ({\n      type: \"array\";\n      /** Shared name of the multipart form fields to process */\n      field: string;\n      /** Maximum number of files to process (defaults to framework config) */\n      maxCount?: number;\n      /** Minimum number of files required */\n      // minCount?: number;\n    } & ArkosRouterBaseUploadConfig)\n  /**\n   * Creates middleware that processes multiple files associated with the\n   * given form fields.\n   *\n   * The `Request` object will be populated with a `files` object which\n   * maps each field name to an array of the associated file information\n   * objects.\n   *\n   * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName` for any field\n   *\n   * @example\n   * uploads: {\n   *   type: \"fields\",\n   *   fields: [\n   *     { field: \"avatar\", maxCount: 1, uploadDir: \"images\" },\n   *     { field: \"resume\", maxCount: 1, uploadDir: \"documents\" }\n   *   ]\n   * }\n   */\n  | ({\n      type: \"fields\";\n      /** Array of field configurations describing multipart form fields to process */\n      fields: {\n        /** Name of the form field */\n        name: string;\n        /** Maximum number of files for this field (defaults to framework config) */\n        maxCount?: number;\n        // /** Minimum number of files required for this field */\n        // minCount?: number;\n      }[];\n    } & ArkosRouterBaseUploadConfig);\n\n/**\n * Base configuration options for file uploads.\n * These settings can override framework-level defaults for specific routes.\n */\nexport type ArkosRouterBaseUploadConfig = {\n  /**\n   * Directory category where files will be stored.\n   * Each category has its own default restrictions defined in framework config.\n   *\n   * @remarks Do not include the `baseUploadDir` defined under your arkos config\n   * @default Depends on the file type which is descovered by the file mimetype, otherwise falls to files.\n   */\n  uploadDir?: string;\n  /**\n   * Whether to automatically delete uploaded files if an error occurs during request processing.\n   * Cleanup happens when errors are thrown and not caught within the route handler.\n   *\n   * @default false\n   */\n  deleteOnError?: boolean;\n  /**\n   * How to attach file information to req.body for easier access in handlers and validation.\n   * - \"pathname\": Just the relative path (e.g., \"images/avatar-123.jpg\")\n   * - \"url\": Complete URL (e.g., \"https://api.com/uploads/images/avatar-123.jpg\")\n   * - \"file\": The complete Multer file object with all metadata\n   *\n   * @default \"pathname\"\n   *\n   * @remarks\n   * When using validation, the attached format will be available in your validated body.\n   * For array/fields uploads, an array of the specified format will be attached.\n   */\n  attachToBody?: \"pathname\" | \"url\" | \"file\" | false;\n  /**\n   * Maximum file size in bytes.\n   * Overrides the framework-level default for this uploadDir category.\n   *\n   * @example\n   * maxSize: 1024 * 1024 * 5 // 5MB\n   * maxSize: 1024 * 1024 * 50 // 50MB\n   */\n  maxSize?: number;\n  /**\n   * Allowed file types/extensions.\n   * Can be an array of extensions/MIME types or a RegExp pattern.\n   * Overrides the framework-level default for this uploadDir category.\n   *\n   * @example\n   * // Array of extensions\n   * allowedFileTypes: [\".jpg\", \".png\", \".gif\"]\n   *\n   * @example\n   * // Array of MIME types\n   * allowedFileTypes: [\"image/jpeg\", \"image/png\"]\n   *\n   * @example\n   * // RegExp pattern\n   * allowedFileTypes: /jpeg|jpg|png|gif/\n   */\n  allowedFileTypes?: string[] | RegExp;\n  /**\n   * Defines if this file field is required\n   *\n   * @default true\n   */\n  required?: boolean;\n  /**\n   * Open API field description\n   */\n  description?: string;\n};\n"]}
+{"version":3,"file":"upload-config.js","sourceRoot":"","sources":["../../../../../src/utils/arkos-router/types/upload-config.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ArkosFile,\n  UploadPrepare,\n  UploadPrepareFile,\n  UploadUrlPath,\n} from \"../../../types/upload\";\n\nexport type UploadConfig =\n  /**\n   * Creates middleware that processes a single file associated with the\n   * given form field.\n   *\n   * The `Request` object will be populated with a `file` object containing\n   * information about the processed file.\n   *\n   * @example\n   * uploads: {\n   *   type: \"single\",\n   *   field: \"avatar\",\n   *   uploadDir: \"/images\",\n   *   maxSize: 1024 * 1024 * 5 // 5MB\n   * }\n   */\n  | ({\n      type: \"single\";\n      /** Name of the multipart form field to process. Supports bracket notation, including nested array paths (e.g. \"banners[][image]\") */\n      field: string;\n    } & ArkosRouterBaseUploadConfig)\n  /**\n   * Returns middleware that processes multiple files sharing the same field\n   * name.\n   *\n   * The `Request` object will be populated with a `files` array containing\n   * an information object for each processed file.\n   *\n   * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName`\n   *\n   * @example\n   * uploads: {\n   *   type: \"array\",\n   *   field: \"gallery\",\n   *   maxCount: 10,\n   *   minCount: 1,\n   *   uploadDir: \"/images\"\n   * }\n   */\n  | ({\n      type: \"array\";\n      /** Shared name of the multipart form fields to process. Supports bracket notation, including nested array paths (e.g. \"banners[][images]\") */\n      field: string;\n      /** Maximum number of files to process (defaults to framework config) */\n      maxCount?: number;\n      /** Minimum number of files required */\n      minCount?: number;\n    } & ArkosRouterBaseUploadConfig)\n  /**\n   * Creates middleware that processes multiple files associated with the\n   * given form fields.\n   *\n   * The `Request` object will be populated with a `files` object which\n   * maps each field name to an array of the associated file information\n   * objects.\n   *\n   * Each field entry is a full single or array upload config with a `name`\n   * property. Field names support bracket notation, including nested array\n   * paths (e.g. \"banners[][images]\").\n   *\n   * @example\n   * uploads: {\n   *   type: \"fields\",\n   *   fields: [\n   *     { name: \"avatar\", type: \"single\", uploadDir: \"/images\" },\n   *     { name: \"resume\", type: \"single\", uploadDir: \"/documents\" },\n   *     { name: \"banners[][images]\", type: \"array\", maxCount: 5, uploadDir: \"/banners\" }\n   *   ]\n   * }\n   */\n  | ({\n      type: \"fields\";\n      /** Array of field configurations describing multipart form fields to process */\n      fields: UploadConfigFieldEntry[];\n    } & Pick<\n      ArkosRouterBaseUploadConfig,\n      | \"deleteOnError\"\n      | \"image\"\n      | \"uploadDir\"\n      | \"urlPath\"\n      | \"serve\"\n      | \"prepare\"\n      | \"prepareFile\"\n      | \"overwrite\"\n    >)\n  | ({\n      type: \"fields\";\n      /** Array of field configurations describing multipart form fields to process */\n      fields: {\n        /** Name of the form field */\n        name: string;\n        /** Maximum number of files for this field (defaults to framework config) */\n        maxCount?: number;\n        // /** Minimum number of files required for this field */\n        minCount?: number;\n      }[];\n    } & ArkosRouterBaseUploadConfig);\n\n/**\n * A single field entry inside a `fields` upload config.\n * Each entry is a full single or array upload config with an additional\n * `name` property identifying the form field.\n *\n * Field names support bracket notation, including nested array paths\n * (e.g. \"banners[][images]\"). For nested array paths, multer validation\n * is bypassed and constraints (allowedFileTypes, maxSize, minCount, maxCount)\n * are enforced per group after upload.\n */\nexport type UploadConfigFieldEntry =\n  /**\n   * A single-file field entry.\n   *\n   * @example\n   * { name: \"avatar\", type: \"single\", uploadDir: \"/images\", required: true }\n   *\n   * @example\n   * // nested array path — one image per banner\n   * { name: \"banners[][image]\", type: \"single\", uploadDir: \"/banners\" }\n   */\n  | ({\n      /** Name of the form field. Supports bracket notation including nested array paths. */\n      name: string;\n      type: \"single\";\n    } & Omit<ArkosRouterBaseUploadConfig, \"deleteOnError\">)\n  /**\n   * A multi-file field entry.\n   *\n   * @example\n   * { name: \"gallery\", type: \"array\", maxCount: 6, uploadDir: \"/gallery\" }\n   *\n   * @example\n   * // nested array path — multiple images per banner, min 1 max 5\n   * { name: \"banners[][images]\", type: \"array\", minCount: 1, maxCount: 5, uploadDir: \"/banners\" }\n   */\n  | ({\n      /** Name of the form field. Supports bracket notation including nested array paths. */\n      name: string;\n      type?: \"array\";\n      /** Maximum number of files for this field (defaults to framework config) */\n      maxCount?: number;\n      /** Minimum number of files required for this field */\n      minCount?: number;\n    } & Omit<ArkosRouterBaseUploadConfig, \"deleteOnError\">); /**\n\n/**\n * Base configuration options for file uploads.\n * These settings can override framework-level defaults for specific routes.\n */\nexport type ArkosRouterBaseUploadConfig = {\n  /**\n   * Directory category where files will be stored.\n   * Each category has its own default restrictions defined in framework config.\n   *\n   * @remarks Do not include the `baseUploadDir` defined under your arkos config\n   * @default Depends on the file type which is descovered by the file mimetype, otherwise falls to files.\n   */\n  uploadDir?: string;\n  /**\n   * Public URL for the uploaded files, relative to the file upload `baseRoute`.\n   *\n   * A string is a folder: the stored filename is appended. An object with\n   * `exact` is the complete public path relative to `baseRoute`: nothing is\n   * appended, and the path must be static.\n   *\n   * Requires `uploadDir` to be set.\n   *\n   * @since 1.8.0-rc\n   *\n   * @example\n   * // Files stored in uploads/storage/acme but served at /api/uploads/private/files\n   * uploadDir: \"/storage/acme\",\n   * urlPath: \"/private/files\"\n   *\n   * @example\n   * // The response URL is always /api/uploads/users/me/photo\n   * uploadDir: \"/users/:userId/photo\",\n   * urlPath: { exact: \"/users/me/photo\" }\n   */\n  urlPath?: UploadUrlPath;\n  /**\n   * Resolves the disk parameters for this upload folder. Required for every\n   * dynamic folder (`:param` in `uploadDir`). It may be async and may throw to\n   * deny the request.\n   *\n   * URL parameters are merged into the disk parameter map, with values\n   * returned by `prepare` taking precedence.\n   *\n   * @since 1.8.0-rc\n   */\n  prepare?: UploadPrepare;\n  /**\n   * Resolves per-file data before the file is written. Only `filename` is\n   * consumed. The returned filename is treated as a base name: the final\n   * saved extension is always preserved.\n   *\n   * May be async.\n   *\n   * @since 1.8.0-rc\n   */\n  prepareFile?: UploadPrepareFile;\n  /**\n   * Whether a file with the same target name may be replaced.\n   *\n   * @default true\n   * @since 1.8.0-rc\n   */\n  overwrite?: boolean;\n  /**\n   * Set to `false` to opt this upload directory out of the startup coverage\n   * check when `fileUpload.serving` is `\"registered\"`.\n   *\n   * Only `false` has meaning.\n   *\n   * @since 1.8.0-rc\n   */\n  serve?: boolean;\n  /**\n   * Whether to automatically delete uploaded files if an error occurs during request processing.\n   * Cleanup happens when errors are thrown and not caught within the route handler.\n   *\n   * @default false\n   */\n  deleteOnError?: boolean;\n  /**\n   * How to attach file information to req.body for easier access in handlers and validation.\n   * - \"pathname\": Just the relative path (e.g., \"images/avatar-123.jpg\")\n   * - \"url\": Complete URL (e.g., \"https://api.com/uploads/images/avatar-123.jpg\")\n   * - \"file\": The complete Multer file object with all metadata\n   *\n   * @default \"pathname\"\n   *\n   * @remarks\n   * When using validation, the attached format will be available in your validated body.\n   * For array/fields uploads, an array of the specified format will be attached.\n   */\n  attachToBody?:\n    | \"pathname\"\n    | \"url\"\n    | \"file\"\n    | false\n    | ((file: ArkosFile) => any);\n  /**\n   * Maximum file size in bytes.\n   * Overrides the framework-level default for this uploadDir category.\n   *\n   * @example\n   * maxSize: 1024 * 1024 * 5 // 5MB\n   * maxSize: 1024 * 1024 * 50 // 50MB\n   */\n  maxSize?: number;\n  /**\n   * Allowed file types/extensions.\n   * Can be an array of extensions/MIME types or a RegExp pattern.\n   * Overrides the framework-level default for this uploadDir category.\n   *\n   * @example\n   * // Array of extensions\n   * allowedFileTypes: [\".jpg\", \".png\", \".gif\"]\n   *\n   * @example\n   * // Array of MIME types\n   * allowedFileTypes: [\"image/jpeg\", \"image/png\"]\n   *\n   * @example\n   * // RegExp pattern\n   * allowedFileTypes: /jpeg|jpg|png|gif/\n   */\n  allowedFileTypes?: string[] | RegExp;\n  /**\n   * Defines if this file field is required\n   *\n   * @default true\n   */\n  required?: boolean;\n  /**\n   * Image optimization options applied through Sharp for image uploads.\n   * When omitted, images fall back to the framework defaults (webp conversion).\n   *\n   * @example\n   * image: { resizeTo: 1200, quality: 80 }\n   * image: { format: \"png\", width: 800 }\n   * image: { optimize: false } // store original bytes untouched\n   */\n  image?: {\n    /**\n     * Set to `false` to skip optimization entirely and store the original\n     * bytes as-is, e.g. to let users upload an image \"as a document\".\n     *\n     * @default true\n     */\n    optimize?: boolean;\n    /** Output format, defaults to `webp` */\n    format?: string;\n    /** Output quality (1-100) for lossy formats (webp, jpeg, avif) */\n    quality?: number;\n    /** Target width, keeping aspect ratio */\n    width?: number;\n    /** Target height, keeping aspect ratio */\n    height?: number;\n    /** Target size to fit within, keeping aspect ratio */\n    resizeTo?: number;\n    /** Resize strategy, defaults to `inside` */\n    fit?: \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n    /** Prevent upscaling images smaller than the requested dimensions */\n    withoutEnlargement?: boolean;\n  };\n  /**\n   * Open API field description\n   */\n  description?: string;\n};\n"]}

package/dist/esm/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.js

@@ -0,0 +1,198 @@
+import RouteConfigValidator from "../../route-config-validator.js";
+import { applyPrefix, getMiddlewareStack } from "./index.js";
+import { getUserFileExtension } from "../../../helpers/fs.helpers.js";
+import RouteConfigRegistry from "../../route-config-registry.js";
+import { catchAsync } from "../../../../exports/error-handler/index.js";
+import deepmerge from "../../../helpers/deepmerge.helper.js";
+import ExitError from "../../../helpers/exit-error.js";
+import uploadManager from "./upload-manager.js";
+import loadableRegistry from "../../../../components/arkos-loadable-registry/index.js";
+import { state } from "../../../../app.js";
+import { docsLink } from "../../../../app.js";
+import { isUsingAuthentication, getArkosConfig } from "../../../helpers/arkos-config.helpers.js";
+const flattenHandlers = (arr) => {
+    return arr.reduce((flat, item) => {
+        return flat.concat(Array.isArray(item) ? flattenHandlers(item) : item);
+    }, []);
+};
+export function applyArkosRouterProxy(target, options, component = "router") {
+    target._arkos = {
+        options,
+        routes: [],
+    };
+    target.load = (...items) => {
+        if (state !== "idle")
+            throw ExitError(`app.load() must be called before app.${state === "listening" ? "listen" : "build"}(), see ${docsLink}`);
+        if (Array.isArray(items[0]))
+            items = items[0];
+        items = Array.isArray(items) ? items : [items];
+        items.forEach((item) => loadableRegistry.register(item));
+        return target;
+    };
+    return new Proxy(target, {
+        get(target, prop, receiver) {
+            const originalMethod = Reflect.get(target, prop, receiver);
+            const httpMethods = [
+                "get",
+                "post",
+                "put",
+                "patch",
+                "delete",
+                "all",
+                "head",
+                "trace",
+                "options",
+            ];
+            if (prop === "use") {
+                return function (config, ...handlers) {
+                    if (typeof config === "function" || Array.isArray(config)) {
+                        handlers = [config, ...handlers];
+                        config = {};
+                    }
+                    else if (!config ||
+                        typeof config !== "object" ||
+                        typeof config === "string" ||
+                        config instanceof RegExp) {
+                        throw ExitError(`First argument of ${component}.use() must be a valid ArkosRouteConfig object or a middleware function, but received ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}.`);
+                    }
+                    if (config.disabled)
+                        return;
+                    const useConfig = config;
+                    const path = applyPrefix(options?.prefix, useConfig.path ?? "/");
+                    const arkosConfig = getArkosConfig();
+                    const authenticationConfig = arkosConfig.authentication;
+                    handlers.forEach((h) => {
+                        if (h && typeof h === "function" && h._arkos) {
+                            h._arkos.options = {
+                                ...h._arkos.options,
+                                prefix: path,
+                            };
+                        }
+                    });
+                    if (useConfig.authentication && !authenticationConfig?.mode)
+                        throw ExitError(`Trying to authenticate route ${path ? `${path}` : ""} without choosing an authentication mode under arkos.config.${getUserFileExtension()}
+
+For further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`);
+                    const flatHandlers = flattenHandlers(handlers);
+                    handlers = flatHandlers.map((handler) => {
+                        if (!handler || typeof handler !== "function")
+                            throw ExitError(`Wrong value for handler in route ${path}, recevied ${handler}.`);
+                        return "param" in handler
+                            ? handler
+                            : catchAsync(handler, {
+                                type: handler.length > 3 ? "error" : "normal",
+                            });
+                    });
+                    const middlewareStack = getMiddlewareStack(useConfig);
+                    const allHandlers = [...middlewareStack, ...handlers];
+                    return originalMethod.call(target, path, ...allHandlers);
+                };
+            }
+            if (prop === "route") {
+                return function (path) {
+                    const routeChain = {};
+                    httpMethods.forEach((method) => {
+                        routeChain[method] = function (config, ...handlers) {
+                            if (typeof config === "function" || Array.isArray(config))
+                                throw ExitError(`First argument of ${component}.route("${path}").${method}() must be a valid ArkosRouteConfig object without path field, but received ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
+                            const fullConfig = {
+                                ...config,
+                                path,
+                                authentication: config.authentication === undefined && isUsingAuthentication() ? true : config.authentication
+                            };
+                            receiver[method](fullConfig, ...handlers);
+                            return routeChain;
+                        };
+                    });
+                    return routeChain;
+                };
+            }
+            if (httpMethods.includes(prop)) {
+                return function (config, ...handlers) {
+                    if (!config || !RouteConfigValidator.isArkosRouteConfig(config))
+                        throw ExitError(`First argument of ${component}.${prop}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === "object" ? JSON.stringify(config, null, 2) : config}`);
+                    if (config?.disabled)
+                        return;
+                    const path = applyPrefix(options?.prefix, config.path);
+                    config = {
+                        authentication: config?.authentication === undefined && isUsingAuthentication() ? true : config?.authentication,
+                        ...config,
+                        ...(options?.openapi
+                            ? {
+                                experimental: {
+                                    ...config?.experimental,
+                                    openapi: deepmerge(options.openapi || {}, config?.experimental?.openapi || {}),
+                                },
+                            }
+                            : {}),
+                        path,
+                    };
+                    config = {
+                        ...config,
+                        ...(options?.uploads
+                            ? {
+                                experimental: {
+                                    ...config?.experimental,
+                                    ...(config?.experimental?.uploads
+                                        ? {
+                                            uploads: deepmerge(options.uploads, config.experimental.uploads),
+                                        }
+                                        : {}),
+                                },
+                            }
+                            : {}),
+                        path,
+                    };
+                    if ([null, undefined].includes(path))
+                        throw new Error("Please pass valid value for path field to use in your route");
+                    const method = prop;
+                    const UndefinedHandlerError = (handler) => ExitError(`Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`);
+                    if (handlers.length > 0) {
+                        const flatHandlers = flattenHandlers(handlers);
+                        handlers = flatHandlers.map((handler) => {
+                            if (!handler || typeof handler !== "function")
+                                throw UndefinedHandlerError(handler);
+                            return catchAsync(handler, {
+                                type: handler.length > 3 ? "error" : "normal",
+                            });
+                        });
+                        const finalHandler = handlers[handlers.length - 1];
+                        RouteConfigRegistry.register(finalHandler, config, method);
+                        target._arkos.routes.push({
+                            handler: finalHandler,
+                            config,
+                            method,
+                        });
+                    }
+                    const arkosConfig = getArkosConfig();
+                    const validationConfig = arkosConfig.validation;
+                    const authenticationConfig = arkosConfig.authentication;
+                    const strictValidation = validationConfig?.strict;
+                    const route = `${method.toUpperCase()} ${path}`;
+                    if (strictValidation &&
+                        (!("validation" in config) ||
+                            ("validation" in config &&
+                                !config.validation &&
+                                config.validation !== undefined)))
+                        throw ExitError("When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.");
+                    if (!validationConfig?.resolver &&
+                        Object.keys(config.validation || {}).length > 0)
+                        throw ExitError(`Trying to pass validators into route ${route} config validation option without choosing a validation resolver under configuration as defineConfig({ validation: { resolver: '' } })`);
+                    if (config.authentication && !isUsingAuthentication())
+                        throw ExitError(`Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${getUserFileExtension()}
+
+For further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`);
+                    handlers = [...getMiddlewareStack(config), ...handlers];
+                    if (handlers.length === 0)
+                        throw ExitError(`No handlers provided for route ${method.toUpperCase()} ${path}.`);
+                    if (config.experimental?.uploads &&
+                        config.experimental.uploads.deleteOnError !== false)
+                        handlers.push(catchAsync(uploadManager.handleFileCleanup(config.experimental.uploads), { type: "error" }));
+                    return originalMethod.call(target, path, ...handlers);
+                };
+            }
+            return originalMethod;
+        },
+    });
+}
+//# sourceMappingURL=apply-arkos-router-proxy.js.map

package/dist/esm/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-arkos-router-proxy.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/apply-arkos-router-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import { IRouter, RouterOptions } from \"express\";\nimport {\n  ArkosRouteConfig,\n  ArkosUseConfig,\n  IArkosRoute,\n  IArkosRouter,\n  InternalIArkosRouter,\n  PathParams,\n} from \"../../types\";\nimport RouteConfigValidator from \"../../route-config-validator\";\nimport { applyPrefix, getMiddlewareStack } from \".\";\nimport { getUserFileExtension } from \"../../../helpers/fs.helpers\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\nimport deepmerge from \"../../../helpers/deepmerge.helper\";\nimport ExitError from \"../../../helpers/exit-error\";\nimport uploadManager from \"./upload-manager\";\nimport { ArkosAnyRequestHandler } from \"../../../../types\";\nimport { ArkosRouterOptions } from \"../..\";\nimport { UploadConfig } from \"../../types/upload-config\";\nimport { Arkos, ArkosLoadable } from \"../../../../types/arkos\";\nimport { Express } from \"express\";\nimport loadableRegistry from \"../../../../components/arkos-loadable-registry\";\nimport { state } from \"../../../../app\";\nimport { docsLink } from \"../../../../app\";\nimport { isUsingAuthentication, getArkosConfig } from \"../../../helpers/arkos-config.helpers\";\n\nconst flattenHandlers = (arr: any[]): ArkosAnyRequestHandler[] => {\n  return arr.reduce((flat, item) => {\n    return flat.concat(Array.isArray(item) ? flattenHandlers(item) : item);\n  }, []);\n};\n\nexport function applyArkosRouterProxy<T extends Express | IRouter>(\n  target: T,\n  options?: RouterOptions & ArkosRouterOptions,\n  component: \"app\" | \"router\" = \"router\"\n): T extends Express ? Arkos : IArkosRouter {\n  (target as InternalIArkosRouter)._arkos = {\n    options,\n    routes: [],\n  };\n\n  (target as any).load = (...items: ArkosLoadable[]) => {\n    if (state !== \"idle\")\n      throw ExitError(\n        `app.load() must be called before app.${state === \"listening\" ? \"listen\" : \"build\"}(), see ${docsLink}`\n      );\n\n    if (Array.isArray(items[0])) items = items[0];\n    items = Array.isArray(items) ? items : [items];\n\n    items.forEach((item) => loadableRegistry.register(item));\n    return target;\n  };\n\n  return new Proxy(target as any, {\n    get(target, prop, receiver) {\n      const originalMethod = Reflect.get(target, prop, receiver) as Function;\n\n      const httpMethods = [\n        \"get\",\n        \"post\",\n        \"put\",\n        \"patch\",\n        \"delete\",\n        \"all\",\n        \"head\",\n        \"trace\",\n        \"options\",\n      ] as const;\n\n      if (prop === \"use\") {\n        return function(\n          config: ArkosUseConfig | PathParams | ArkosAnyRequestHandler,\n          ...handlers: (ArkosAnyRequestHandler | IArkosRouter)[]\n        ) {\n          // normalize function/router to ArkosUseConfig\n          if (typeof config === \"function\" || Array.isArray(config)) {\n            handlers = [config as ArkosAnyRequestHandler, ...handlers];\n            config = {} as ArkosUseConfig;\n          } else if (\n            !config ||\n            typeof config !== \"object\" ||\n            typeof config === \"string\" ||\n            config instanceof RegExp\n          ) {\n            throw ExitError(\n              `First argument of ${component}.use() must be a valid ArkosRouteConfig object or a middleware function, but received ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}.`\n            );\n          }\n\n          if ((config as ArkosUseConfig).disabled) return;\n\n          const useConfig = config as ArkosUseConfig;\n          const path = applyPrefix(options?.prefix, useConfig.path ?? \"/\");\n\n          const arkosConfig = getArkosConfig();\n          const authenticationConfig = arkosConfig.authentication;\n\n          // This is done because of Express v5 no longer\n          // contains layer.regexp so we gotta build\n          // the route reverse feature from ground up\n          handlers.forEach((h: any) => {\n            if (h && typeof h === \"function\" && h._arkos) {\n              h._arkos.options = {\n                ...h._arkos.options,\n                prefix: path,\n              };\n            }\n          });\n\n          if (useConfig.authentication && !authenticationConfig?.mode)\n            throw ExitError(\n              `Trying to authenticate route ${path ? `${path}` : \"\"} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          const flatHandlers = flattenHandlers(handlers);\n\n          handlers = flatHandlers.map((handler: ArkosAnyRequestHandler) => {\n            if (!handler || typeof handler !== \"function\")\n              throw ExitError(\n                `Wrong value for handler in route ${path}, recevied ${handler}.`\n              );\n\n            return \"param\" in handler\n              ? handler\n              : catchAsync(handler, {\n                type: handler.length > 3 ? \"error\" : \"normal\",\n              });\n          });\n\n          const middlewareStack = getMiddlewareStack(useConfig);\n          const allHandlers = [...middlewareStack, ...handlers];\n\n          return originalMethod.call(target, path, ...allHandlers);\n        };\n      }\n\n      if (prop === \"route\") {\n        return function(path: PathParams) {\n          const routeChain: any = {};\n\n          httpMethods.forEach((method) => {\n            routeChain[method] = function(\n              config: ArkosAnyRequestHandler | Omit<ArkosRouteConfig, \"path\">,\n              ...handlers: ArkosAnyRequestHandler[]\n            ) {\n              if (typeof config === \"function\" || Array.isArray(config))\n                throw ExitError(\n                  `First argument of ${component}.route(\"${path}\").${method}() must be a valid ArkosRouteConfig object without path field, but received ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}`\n                );\n\n\n              const fullConfig: ArkosRouteConfig = {\n                ...config,\n                path,\n                authentication: config.authentication === undefined && isUsingAuthentication() ? true : config.authentication\n              };\n\n              receiver[method](fullConfig, ...handlers);\n              return routeChain as IArkosRoute;\n            };\n          });\n\n          return routeChain;\n        };\n      }\n\n      if (httpMethods.includes(prop as any)) {\n        return function(\n          config: ArkosRouteConfig,\n          ...handlers: ArkosAnyRequestHandler[]\n        ) {\n          if (!config || !RouteConfigValidator.isArkosRouteConfig(config))\n            throw ExitError(\n              `First argument of ${component}.${prop as string}() must be a valid ArkosRouteConfig object with path field, but recevied ${typeof config === \"object\" ? JSON.stringify(config, null, 2) : config}`\n            );\n\n          if (config?.disabled) return;\n\n          const path = applyPrefix(options?.prefix, config.path);\n\n          config = {\n            authentication: config?.authentication === undefined && isUsingAuthentication() ? true : config?.authentication,\n            ...config,\n            ...(options?.openapi\n              ? {\n                experimental: {\n                  ...config?.experimental,\n                  openapi: deepmerge(\n                    options.openapi || {},\n                    config?.experimental?.openapi || {}\n                  ),\n                },\n              }\n              : {}),\n            path,\n          };\n\n          config = {\n            ...config,\n            ...(options?.uploads\n              ? {\n                experimental: {\n                  ...config?.experimental,\n                  ...((config?.experimental?.uploads\n                    ? {\n                      uploads: deepmerge(\n                        options.uploads,\n                        config.experimental.uploads\n                      ),\n                    }\n                    : {}) as UploadConfig),\n                },\n              }\n              : {}),\n            path,\n          };\n\n          if ([null, undefined].includes(path as any))\n            throw new Error(\n              \"Please pass valid value for path field to use in your route\"\n            );\n\n          const method = prop as string;\n          const UndefinedHandlerError = (handler: any) =>\n            ExitError(\n              `Wrong value for handler in route ${method.toUpperCase()} ${path}, recevied ${handler}.`\n            );\n\n          if (handlers.length > 0) {\n            const flatHandlers = flattenHandlers(handlers);\n\n            handlers = flatHandlers.map((handler: ArkosAnyRequestHandler) => {\n              if (!handler || typeof handler !== \"function\")\n                throw UndefinedHandlerError(handler);\n\n              return catchAsync(handler, {\n                type: handler.length > 3 ? \"error\" : \"normal\",\n              });\n            });\n\n            const finalHandler = handlers[handlers.length - 1];\n            RouteConfigRegistry.register(finalHandler, config, method);\n            (target as InternalIArkosRouter)._arkos.routes.push({\n              handler: finalHandler,\n              config,\n              method,\n            });\n          }\n\n          const arkosConfig = getArkosConfig();\n          const validationConfig = arkosConfig.validation;\n          const authenticationConfig = arkosConfig.authentication;\n          const strictValidation = validationConfig?.strict;\n          const route = `${method.toUpperCase()} ${path}`;\n\n          if (\n            strictValidation &&\n            (!(\"validation\" in config) ||\n              (\"validation\" in config &&\n                !config.validation &&\n                config.validation !== undefined))\n          )\n            throw ExitError(\n              \"When using strict validation you must either pass { validation: false } in order to explicitly tell that no input will be received, or pass `undefined` for each input type e.g { validation: { query: undefined } } in order to deny the input of given request input.\"\n            );\n\n          if (\n            !validationConfig?.resolver &&\n            Object.keys(config.validation || {}).length > 0\n          )\n            throw ExitError(\n              `Trying to pass validators into route ${route} config validation option without choosing a validation resolver under configuration as defineConfig({ validation: { resolver: '' } })`\n            );\n\n          if (config.authentication && !isUsingAuthentication())\n            throw ExitError(\n              `Trying to authenticate route ${route} without choosing an authentication mode under arkos.config.${getUserFileExtension()}\n\nFor further help see https://www.arkosjs.com/docs/core-concepts/authentication/setup.`\n            );\n\n          handlers = [...getMiddlewareStack(config), ...handlers];\n\n          if (handlers.length === 0)\n            throw ExitError(\n              `No handlers provided for route ${method.toUpperCase()} ${path}.`\n            );\n\n          if (\n            config.experimental?.uploads &&\n            config.experimental.uploads.deleteOnError !== false\n          )\n            handlers.push(\n              catchAsync(\n                uploadManager.handleFileCleanup(config.experimental.uploads),\n                { type: \"error\" }\n              )\n            );\n\n          return originalMethod.call(target, path, ...handlers);\n        };\n      }\n\n      return originalMethod;\n    },\n  });\n}\n"]}

package/dist/esm/utils/arkos-router/utils/helpers/index.js

@@ -1,59 +1,115 @@
 import rateLimit from "express-rate-limit";
 import authService from "../../../../modules/auth/auth.service.js";
 import { validateRequestInputs } from "../../../../modules/base/base.middlewares.js";
-import RouteConfigRegistry from "../../route-config-registry.js";
 import express from "express";
 import compression from "compression";
 import { queryParser } from "../../../helpers/query-parser.helpers.js";
 import uploadManager from "./upload-manager.js";
 import multer from "multer";
 import { catchAsync } from "../../../../exports/error-handler/index.js";
-export function extractArkosRoutes(app, basePath = "") {
+import RouteConfigRegistry from "../../route-config-registry.js";
+export function extractArkosRoutes(app, basePath = "", inheritedRouteOptions) {
+    if (inheritedRouteOptions &&
+        Object.keys(inheritedRouteOptions).length === 0)
+        inheritedRouteOptions = undefined;
     const routes = [];
-    function extractFromStack(stack, prefix = "") {
-        stack.forEach((layer) => {
+    function extractFromStack(stack, prefix = "", inheritedRouteOptions) {
+        if (!stack || !Array.isArray(stack))
+            return;
+        for (const layer of stack) {
             if (layer.route) {
-                const fullPath = prefix + layer.route.path;
-                const methods = Object.keys(layer.route.methods);
-                methods.forEach((method) => {
+                const fullPath = joinPaths(prefix, layer.route.path);
+                const methods = Object.keys(layer.route.methods || {});
+                for (const method of methods) {
                     const handlers = layer.route.stack || [];
-                    let config;
+                    let routeConfig = null;
+                    let routeOptions = inheritedRouteOptions;
                     for (const handler of handlers) {
-                        const foundConfig = RouteConfigRegistry.get(handler.handle);
-                        if (foundConfig) {
-                            config = foundConfig;
+                        const registryConfig = RouteConfigRegistry.get(handler.handle);
+                        if (registryConfig) {
+                            routeConfig = registryConfig;
                             routes.push({
                                 path: fullPath,
                                 method: method.toUpperCase(),
-                                config,
+                                routeOptions,
+                                config: routeConfig || {
+                                    method: method.toUpperCase(),
+                                    path: layer.route.path,
+                                },
                             });
                             break;
                         }
+                        const arkosMeta = handler.handle?._arkos || handler._arkos;
+                        if (arkosMeta) {
+                            routeOptions = arkosMeta.options || routeOptions;
+                        }
                     }
-                });
+                }
             }
-            else if (layer.name === "router" && layer.handle?.stack) {
+            else if (layer.name === "router" ||
+                layer.name === "bound dispatch" ||
+                layer.handle?.stack) {
                 let nestedPrefix = prefix;
-                if (layer.regexp) {
-                    const match = layer.regexp
-                        .toString()
-                        .match(/\/\^?(\\\/[^?]+|\/[^?]+)/);
-                    if (match) {
-                        nestedPrefix = prefix + "/" + match[1].replace(/\\\//g, "/");
-                        nestedPrefix = nestedPrefix
-                            .replace(/\/\//g, "/")
-                            .replace(/\/$/, "");
-                    }
+                const arkosPrefix = layer.handle?._arkos?.options?.prefix;
+                if (arkosPrefix) {
+                    nestedPrefix = joinPaths(prefix, arkosPrefix);
+                }
+                else if (layer.path) {
+                    nestedPrefix = joinPaths(prefix, layer.path);
+                }
+                else if (layer.regexp) {
+                    nestedPrefix = joinPaths(prefix, extractLayerPath(layer));
+                }
+                const routerStack = layer.handle?.stack || layer.handle?._router?.stack;
+                if (routerStack) {
+                    const currentOptions = layer.handle?._arkos?.options?.openapi
+                        ? layer.handle._arkos.options
+                        : inheritedRouteOptions;
+                    extractFromStack(routerStack, nestedPrefix, currentOptions);
                 }
-                extractFromStack(layer.handle.stack, nestedPrefix);
             }
-        });
+        }
     }
-    const stack = app._router?.stack || app.stack;
+    const stack = app._router?.stack || app.router?.stack || app.stack;
     if (stack)
-        extractFromStack(stack, basePath);
+        extractFromStack(stack, basePath, app._arkos?.options);
     return routes;
 }
+function joinPaths(prefix, path) {
+    if (!path)
+        return prefix || "";
+    if (!prefix) {
+        return path.startsWith("/") ? path : `/${path}`;
+    }
+    return `${prefix.replace(/\/$/, "")}/${path.replace(/^\//, "")}`.replace(/\/+/g, "/");
+}
+export function extractLayerPath(layer) {
+    if (layer.path && typeof layer.path === "string")
+        return layer.path;
+    if (layer.path) {
+        const source = layer.path;
+        if (source === "^\\/?(?=\\/|$)")
+            return "";
+        let cleaned = source
+            .replace(/^\^\\?\//, "/")
+            .replace(/^\^/, "")
+            .replace(/\\\/\?\(\?=\\\/\|\$\)/g, "")
+            .replace(/\(\?=\\\/\|\$\)/g, "")
+            .replace(/\\\//g, "/")
+            .replace(/\(\?:\\\/\?\)?/g, "")
+            .replace(/\(\?:\(\[\^\\\/\]\+\?\)\)/g, ":param")
+            .replace(/\/\?\$?$/, "")
+            .replace(/\$$/, "")
+            .replace(/\/+\/+/g, "/");
+        if (cleaned && !cleaned.startsWith("/"))
+            cleaned = "/" + cleaned;
+        if (cleaned.includes("?") || cleaned.includes("(") || cleaned.includes(")")) {
+            return typeof layer.path === "string" ? layer.path : "";
+        }
+        return cleaned;
+    }
+    return "";
+}
 export function getMiddlewareStack(config) {
     const middlewares = [];
     if (config.authentication)
@@ -61,7 +117,7 @@ export function getMiddlewareStack(config) {
     if (typeof config.authentication === "object" &&
         config.authentication.action &&
         config.authentication.resource)
-        middlewares.push(authService.handleAccessControl(config.authentication.action, config.authentication.resource, { [config.authentication.action]: config.authentication?.rule }));
+        middlewares.push(authService.authorize(config.authentication.action, config.authentication.resource, config.authentication?.rule));
     if (config.rateLimit)
         middlewares.push(rateLimit(config.rateLimit));
     if (config.compression)
@@ -82,6 +138,7 @@ export function getMiddlewareStack(config) {
     }
     if (config.experimental?.uploads) {
         const uploadConfig = config.experimental.uploads;
+        uploadManager.registerUploadConfig(uploadConfig, String(config.path ?? ""));
         middlewares.push(uploadManager.handleUpload(uploadConfig));
         middlewares.push(uploadManager.validateRequiredFiles(uploadConfig));
         middlewares.push(validateRequestInputs(config));
@@ -96,6 +153,12 @@ export function extractPathParams(path) {
     const segments = path.split("/");
     for (const segment of segments) {
         if (segment.startsWith(":")) {
+            params.push(segment.substring(1).replace(/\(.*\)$/, ""));
+        }
+        if (segment.startsWith("{*") && segment.endsWith("}")) {
+            params.push(segment.slice(2, -1));
+        }
+        if (segment.startsWith("*")) {
             params.push(segment.substring(1));
         }
     }

package/dist/esm/utils/arkos-router/utils/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/index.ts"],"names":[],"mappings":"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","sourcesContent":["import rateLimit from \"express-rate-limit\";\nimport authService from \"../../../../modules/auth/auth.service\";\nimport { validateRequestInputs } from \"../../../../modules/base/base.middlewares\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\nimport { ArkosRouteConfig } from \"../../types\";\nimport express from \"express\";\nimport compression from \"compression\";\nimport { queryParser } from \"../../../helpers/query-parser.helpers\";\nimport uploadManager from \"./upload-manager\";\nimport multer from \"multer\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\n\nexport function extractArkosRoutes(\n  app: any,\n  basePath = \"\"\n): Array<{\n  path: string;\n  method: string;\n  config?: ArkosRouteConfig;\n}> {\n  const routes: Array<{\n    path: string;\n    method: string;\n    config?: ArkosRouteConfig;\n  }> = [];\n\n  function extractFromStack(stack: any[], prefix = \"\") {\n    stack.forEach((layer: any) => {\n      if (layer.route) {\n        const fullPath = prefix + layer.route.path;\n        const methods = Object.keys(layer.route.methods);\n\n        methods.forEach((method) => {\n          const handlers = layer.route.stack || [];\n          let config: ArkosRouteConfig | undefined;\n\n          for (const handler of handlers) {\n            const foundConfig = RouteConfigRegistry.get(handler.handle);\n\n            if (foundConfig) {\n              config = foundConfig;\n              routes.push({\n                path: fullPath,\n                method: method.toUpperCase(),\n                config,\n              });\n\n              break;\n            }\n          }\n        });\n      } else if (layer.name === \"router\" && layer.handle?.stack) {\n        let nestedPrefix = prefix;\n\n        if (layer.regexp) {\n          const match = layer.regexp\n            .toString()\n            .match(/\\/\\^?(\\\\\\/[^?]+|\\/[^?]+)/);\n          if (match) {\n            nestedPrefix = prefix + \"/\" + match[1].replace(/\\\\\\//g, \"/\");\n            nestedPrefix = nestedPrefix\n              .replace(/\\/\\//g, \"/\")\n              .replace(/\\/$/, \"\");\n          }\n        }\n\n        extractFromStack(layer.handle.stack, nestedPrefix);\n      }\n    });\n  }\n\n  const stack = app._router?.stack || app.stack;\n  if (stack) extractFromStack(stack, basePath);\n\n  return routes;\n}\n\nexport function getMiddlewareStack(config: ArkosRouteConfig) {\n  const middlewares = [];\n\n  if (config.authentication) middlewares.push(authService.authenticate);\n\n  if (\n    typeof config.authentication === \"object\" &&\n    config.authentication.action &&\n    config.authentication.resource\n  )\n    middlewares.push(\n      authService.handleAccessControl(\n        config.authentication.action,\n        config.authentication.resource,\n        { [config.authentication.action]: config.authentication?.rule }\n      )\n    );\n\n  if (config.rateLimit) middlewares.push(rateLimit(config.rateLimit));\n  if (config.compression) middlewares.push(compression(config.compression));\n  if (config.queryParser) middlewares.push(queryParser(config.queryParser));\n\n  if (config?.bodyParser) {\n    const parsers = Array.isArray(config.bodyParser)\n      ? config.bodyParser\n      : [config.bodyParser];\n\n    parsers.forEach((parser) => {\n      if (typeof parser === \"object\" && parser.parser)\n        if (parser.parser !== \"multipart\")\n          middlewares.push(catchAsync(express[parser.parser](parser.options)));\n        else if (parser.parser === \"multipart\")\n          middlewares.push(\n            catchAsync(multer({ limits: parser.options }).none())\n          );\n    });\n  }\n\n  if (config.experimental?.uploads) {\n    const uploadConfig = config.experimental.uploads;\n    middlewares.push(uploadManager.handleUpload(uploadConfig));\n    middlewares.push(uploadManager.validateRequiredFiles(uploadConfig));\n\n    middlewares.push(validateRequestInputs(config));\n\n    middlewares.push(\n      uploadManager.handlePostUpload(config.experimental.uploads)\n    );\n  } else middlewares.push(validateRequestInputs(config));\n\n  return middlewares;\n}\n\n/**\n * Extracts path parameters from an Express route path\n *\n * @param path - Express route path with :param syntax\n * @returns Array of parameter names\n *\n * @example\n * extractPathParams('/api/users/:userId/posts/:postId')\n * // => ['userId', 'postId']\n *\n */\nexport function extractPathParams(path: string): string[] {\n  const params: string[] = [];\n  const segments = path.split(\"/\");\n\n  for (const segment of segments) {\n    if (segment.startsWith(\":\")) {\n      params.push(segment.substring(1));\n    }\n  }\n\n  return params;\n}\n\ntype PathLike = string | RegExp;\ntype PathInput = PathLike | PathLike[];\n\nexport function applyPrefix(\n  prefix: PathInput = \"\",\n  path: PathInput\n): PathInput {\n  if (!prefix) return path;\n\n  const prefixArr = Array.isArray(prefix) ? prefix : [prefix];\n  const pathArr = Array.isArray(path) ? path : [path];\n\n  const result: PathLike[] = [];\n\n  for (const pfx of prefixArr) {\n    for (const pth of pathArr) {\n      result.push(applySinglePrefix(pfx, pth));\n    }\n  }\n\n  return result.length === 1 ? result[0] : result;\n}\n\nfunction applySinglePrefix(prefix: PathLike, path: PathLike): PathLike {\n  const isPrefixRegex = prefix instanceof RegExp;\n  const isPathRegex = path instanceof RegExp;\n\n  if (typeof prefix === \"string\" && typeof path === \"string\") {\n    const normalizedPrefix = prefix.endsWith(\"/\")\n      ? prefix.slice(0, -1)\n      : prefix;\n\n    return `${normalizedPrefix}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n  }\n\n  if (typeof prefix === \"string\" && isPathRegex) {\n    const escapedPrefix = prefix\n      .replace(/\\/$/, \"\")\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const source = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    return new RegExp(`^${escapedPrefix}${source}`, path.flags);\n  }\n\n  if (isPrefixRegex && typeof path === \"string\") {\n    const escapedPath = path.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    return new RegExp(`^${prefixSource}${escapedPath}`, prefix.flags);\n  }\n\n  if (isPrefixRegex && isPathRegex) {\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    const pathSource = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    const flags = Array.from(new Set([...prefix.flags, ...path.flags])).join(\n      \"\"\n    );\n\n    return new RegExp(`^${prefixSource}${pathSource}`, flags);\n  }\n\n  throw new TypeError(\"Invalid prefix or path\");\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/utils/arkos-router/utils/helpers/index.ts"],"names":[],"mappings":"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","sourcesContent":["import rateLimit from \"express-rate-limit\";\nimport authService from \"../../../../modules/auth/auth.service\";\nimport { validateRequestInputs } from \"../../../../modules/base/base.middlewares\";\nimport { ArkosRouteConfig } from \"../../types\";\nimport express from \"express\";\nimport compression from \"compression\";\nimport { queryParser } from \"../../../helpers/query-parser.helpers\";\nimport uploadManager from \"./upload-manager\";\nimport multer from \"multer\";\nimport { catchAsync } from \"../../../../exports/error-handler\";\nimport { ArkosRouterOptions } from \"../..\";\nimport RouteConfigRegistry from \"../../route-config-registry\";\n\nexport function extractArkosRoutes(\n  app: any,\n  basePath = \"\",\n  inheritedRouteOptions?: ArkosRouterOptions\n) {\n  if (\n    inheritedRouteOptions &&\n    Object.keys(inheritedRouteOptions).length === 0\n  )\n    inheritedRouteOptions = undefined;\n\n\n  const routes: any[] = [];\n\n  function extractFromStack(\n    stack: any[],\n    prefix = \"\",\n    inheritedRouteOptions?: ArkosRouterOptions\n  ) {\n    if (!stack || !Array.isArray(stack)) return;\n\n    for (const layer of stack) {\n      if (layer.route) {\n        const fullPath = joinPaths(prefix, layer.route.path);\n        const methods = Object.keys(layer.route.methods || {});\n\n        for (const method of methods) {\n          const handlers = layer.route.stack || [];\n          let routeConfig = null;\n          let routeOptions = inheritedRouteOptions;\n\n          for (const handler of handlers) {\n            const registryConfig = RouteConfigRegistry.get(handler.handle);\n            if (registryConfig) {\n              routeConfig = registryConfig;\n              routes.push({\n                path: fullPath,\n                method: method.toUpperCase(),\n                routeOptions,\n                config: routeConfig || {\n                  method: method.toUpperCase(),\n                  path: layer.route.path,\n                },\n              })\n              break;\n            }\n\n            const arkosMeta = handler.handle?._arkos || handler._arkos;\n            if (arkosMeta) {\n              routeOptions = arkosMeta.options || routeOptions;\n            }\n          }\n        }\n      } else if (\n        layer.name === \"router\" ||\n        layer.name === \"bound dispatch\" ||\n        layer.handle?.stack\n      ) {\n        let nestedPrefix = prefix;\n        const arkosPrefix = layer.handle?._arkos?.options?.prefix;\n\n        if (arkosPrefix) {\n          nestedPrefix = joinPaths(prefix, arkosPrefix);\n        } else if (layer.path) {\n          nestedPrefix = joinPaths(prefix, layer.path);\n        } else if (layer.regexp) {\n          nestedPrefix = joinPaths(prefix, extractLayerPath(layer));\n        }\n\n        const routerStack = layer.handle?.stack || layer.handle?._router?.stack;\n        if (routerStack) {\n          const currentOptions =\n            layer.handle?._arkos?.options?.openapi\n              ? layer.handle._arkos.options\n              : inheritedRouteOptions;\n\n          extractFromStack(routerStack, nestedPrefix, currentOptions);\n        }\n      }\n    }\n  }\n\n  const stack = app._router?.stack || app.router?.stack || app.stack;\n\n  if (stack)\n    extractFromStack(stack, basePath, app._arkos?.options);\n\n\n  return routes;\n}\n\nfunction joinPaths(prefix: string, path: string | undefined): string {\n  if (!path) return prefix || \"\";\n\n  if (!prefix) {\n    return path.startsWith(\"/\") ? path : `/${path}`;\n  }\n\n  return `${prefix.replace(/\\/$/, \"\")}/${path.replace(/^\\//, \"\")}`.replace(\n    /\\/+/g,\n    \"/\"\n  );\n}\n\nexport function extractLayerPath(layer: any): string {\n  if (layer.path && typeof layer.path === \"string\") return layer.path;\n\n  if (layer.path) {\n    const source = layer.path;\n\n    if (source === \"^\\\\/?(?=\\\\/|$)\")\n      return \"\";\n\n\n    let cleaned = source\n      .replace(/^\\^\\\\?\\//, \"/\")\n      .replace(/^\\^/, \"\")\n      .replace(/\\\\\\/\\?\\(\\?=\\\\\\/\\|\\$\\)/g, \"\")\n      .replace(/\\(\\?=\\\\\\/\\|\\$\\)/g, \"\")\n      .replace(/\\\\\\//g, \"/\")\n      .replace(/\\(\\?:\\\\\\/\\?\\)?/g, \"\")\n      .replace(/\\(\\?:\\(\\[\\^\\\\\\/\\]\\+\\?\\)\\)/g, \":param\")\n      .replace(/\\/\\?\\$?$/, \"\")\n      .replace(/\\$$/, \"\")\n      .replace(/\\/+\\/+/g, \"/\");\n\n    if (cleaned && !cleaned.startsWith(\"/\"))\n      cleaned = \"/\" + cleaned;\n\n\n    if (cleaned.includes(\"?\") || cleaned.includes(\"(\") || cleaned.includes(\")\")) {\n      return typeof layer.path === \"string\" ? layer.path : \"\";\n    }\n\n    return cleaned;\n  }\n\n  return \"\";\n}\n\nexport function getMiddlewareStack(\n  config: ArkosRouteConfig | Omit<ArkosRouteConfig, \"path\">\n) {\n  const middlewares = [];\n\n  if (config.authentication) middlewares.push(authService.authenticate);\n\n  if (\n    typeof config.authentication === \"object\" &&\n    config.authentication.action &&\n    config.authentication.resource\n  )\n    middlewares.push(\n      authService.authorize(\n        config.authentication.action,\n        config.authentication.resource,\n        config.authentication?.rule\n      )\n    );\n\n  if (config.rateLimit) middlewares.push(rateLimit(config.rateLimit));\n  if (config.compression) middlewares.push(compression(config.compression));\n  if (config.queryParser) middlewares.push(queryParser(config.queryParser));\n\n  if (config?.bodyParser) {\n    const parsers = Array.isArray(config.bodyParser)\n      ? config.bodyParser\n      : [config.bodyParser];\n\n    parsers.forEach((parser) => {\n      if (typeof parser === \"object\" && parser.parser)\n        if (parser.parser !== \"multipart\")\n          middlewares.push(catchAsync(express[parser.parser](parser.options)));\n        else if (parser.parser === \"multipart\")\n          middlewares.push(\n            catchAsync(multer({ limits: parser.options }).none())\n          );\n    });\n  }\n\n  if (config.experimental?.uploads) {\n    const uploadConfig = config.experimental.uploads;\n    uploadManager.registerUploadConfig(\n      uploadConfig,\n      String((config as any).path ?? \"\")\n    );\n    middlewares.push(uploadManager.handleUpload(uploadConfig));\n    middlewares.push(uploadManager.validateRequiredFiles(uploadConfig));\n\n    middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n    middlewares.push(\n      uploadManager.handlePostUpload(config.experimental.uploads)\n    );\n  } else middlewares.push(validateRequestInputs(config as ArkosRouteConfig));\n\n  return middlewares;\n}\n\n/**\n * Extracts path parameters from an Express route path\n *\n * @param path - Express route path with :param syntax\n * @returns Array of parameter names\n *\n * @example\n * extractPathParams('/api/users/:userId/posts/:postId')\n * // => ['userId', 'postId']\n *\n */\nexport function extractPathParams(path: string): string[] {\n  const params: string[] = [];\n\n  const segments = path.split(\"/\");\n\n  for (const segment of segments) {\n    if (segment.startsWith(\":\")) {\n      params.push(segment.substring(1).replace(/\\(.*\\)$/, \"\"));\n    }\n\n    if (segment.startsWith(\"{*\") && segment.endsWith(\"}\")) {\n      params.push(segment.slice(2, -1));\n    }\n\n    if (segment.startsWith(\"*\")) {\n      params.push(segment.substring(1));\n    }\n  }\n\n  return params;\n}\ntype PathLike = string | RegExp;\ntype PathInput = PathLike | PathLike[];\n\nexport function applyPrefix(\n  prefix: PathInput = \"\",\n  path: PathInput\n): PathInput {\n  if (!prefix) return path;\n\n  const prefixArr = Array.isArray(prefix) ? prefix : [prefix];\n  const pathArr = Array.isArray(path) ? path : [path];\n\n  const result: PathLike[] = [];\n\n  for (const pfx of prefixArr) {\n    for (const pth of pathArr) {\n      result.push(applySinglePrefix(pfx, pth));\n    }\n  }\n\n  return result.length === 1 ? result[0] : result;\n}\n\nfunction applySinglePrefix(prefix: PathLike, path: PathLike): PathLike {\n  const isPrefixRegex = prefix instanceof RegExp;\n  const isPathRegex = path instanceof RegExp;\n\n  if (typeof prefix === \"string\" && typeof path === \"string\") {\n    const normalizedPrefix = prefix.endsWith(\"/\")\n      ? prefix.slice(0, -1)\n      : prefix;\n\n    return `${normalizedPrefix}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n  }\n\n  if (typeof prefix === \"string\" && isPathRegex) {\n    const escapedPrefix = prefix\n      .replace(/\\/$/, \"\")\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const source = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    return new RegExp(`^${escapedPrefix}${source}`, path.flags);\n  }\n\n  if (isPrefixRegex && typeof path === \"string\") {\n    const escapedPath = path.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    return new RegExp(`^${prefixSource}${escapedPath}`, prefix.flags);\n  }\n\n  if (isPrefixRegex && isPathRegex) {\n    const prefixSource = prefix.source.endsWith(\"$\")\n      ? prefix.source.slice(0, -1)\n      : prefix.source;\n\n    const pathSource = path.source.startsWith(\"^\")\n      ? path.source.slice(1)\n      : path.source;\n\n    const flags = Array.from(new Set([...prefix.flags, ...path.flags])).join(\n      \"\"\n    );\n\n    return new RegExp(`^${prefixSource}${pathSource}`, flags);\n  }\n\n  throw new TypeError(\"Invalid prefix or path\");\n}\n"]}