arkos 2.0.0-next.2 → 2.0.0-next.21

package/dist/types/utils/helpers/global.helpers.d.ts

@@ -1,5 +1,6 @@
 export declare function getPackageJson(): any;
 export declare function isEsm(): boolean;
+export declare const userRequire: NodeJS.Require;
 export declare function importModule(modulePath: string, options?: {
     fixExtension: boolean;
 }): Promise<any>;

package/dist/types/utils/helpers/prisma.helpers.d.ts

@@ -1,4 +1,4 @@
 export declare let prismaInstance: any;
-export declare function loadPrismaModule(): Promise<import("../../generated").PrismaClient>;
+export declare function loadPrismaModule(): import("../../generated").PrismaClient;
 export declare function handlePrismaGet(target: any, prop: string, receiver: any): any;
 export declare function getPrismaInstance(): any;

package/dist/types/utils/helpers/query-parser.helpers.d.ts

@@ -8,5 +8,5 @@ export interface Options {
     parseDoubleUnderscore?: boolean;
 }
 export declare const parse: (target: ParsedQuery, options: Options) => ParsedQuery;
-export declare const queryParser: (options: Options) => (req: ArkosRequest, res: ArkosResponse, next: ArkosNextFunction) => void;
+export declare const queryParser: (options: Options) => (req: ArkosRequest, _: ArkosResponse, next: ArkosNextFunction) => void;
 export {};

package/dist/types/utils/helpers/url-helpers.d.ts

@@ -0,0 +1 @@
+export declare function lenientDecode(str: string): string;

package/dist/types/utils/initialize-app.d.ts

@@ -1,2 +1,3 @@
 import { Arkos } from "../types/arkos";
 export default function initializeApp(app: Arkos): Arkos;
+export declare function addGlobalErrorHandler(app: Arkos): Arkos;

package/dist/types/utils/prisma/prisma-json-schema-generator.d.ts

@@ -1,4 +1,4 @@
-import { JsonSchema } from "./types";
+import { PrismaModel, JsonSchema } from "./types";
 import { OperationByModule } from "../../components/arkos-route-hook/reader";
 import { ArkosModuleType } from "../../components/arkos-route-hook/types";
 export interface SchemaGenerationConfig<T extends ArkosModuleType> {
@@ -13,46 +13,28 @@ export interface GeneratedSchemas {
  */
 export declare class PrismaJsonSchemaGenerator {
     schema: import("./types").PrismaSchema;
-    /**
-     * Main method to generate all schemas for a model
-     */
-    generateModelSchemas<T extends ArkosModuleType>(config: SchemaGenerationConfig<T>): GeneratedSchemas;
-    /**
-     * Generate auth-specific schemas
-     */
-    private generateAuthSchemas;
-    /**
-     * Generate standard CRUD schemas
-     */
-    private generateCrudSchemas;
-    /**
-     * Generate create schema (excludes ID, includes relation IDs only)
-     */
-    private generateCreateSchema;
-    /**
-     * Generate update schema (all fields optional, includes relation IDs only)
-     */
-    private generateUpdateSchema;
+    private isCompositeType;
+    generateCreateSchema(model: PrismaModel): JsonSchema;
+    generateUpdateSchema(model: PrismaModel): JsonSchema;
     /**
      * Generate response schema (includes nested relations based on query options)
      */
-    private generateResponseSchema;
+    generateResponseSchema(model: PrismaModel, options: Record<string, any>): JsonSchema;
     /**
      * Generate nested relation schema
      */
     private generateNestedRelationSchema;
-    /**
-     * Auth-specific schema generators
-     */
-    private generateLoginSchema;
-    private generateSignupSchema;
-    private generateUpdateMeSchema;
-    private generateUpdatePasswordSchema;
-    private isEndpointDisabled;
     private isModelRelation;
     private convertFieldToJsonSchema;
     private mapPrismaTypeToJsonSchema;
     private isEnum;
+    /**
+     * Generate OpenAPI query filter parameters from scalar model fields.
+     * Mirrors the logic from ZodSchemaGenerator.generateQuerySchema.
+     */
+    generateQueryFilterParameters(model: PrismaModel, options?: {
+        modelFieldsOnly?: boolean;
+    }): any[];
 }
 declare const prismaJsonSchemaGenerator: PrismaJsonSchemaGenerator;
 export default prismaJsonSchemaGenerator;

package/dist/types/utils/prisma/prisma-schema-parser.d.ts

@@ -3,6 +3,7 @@ interface SchemaConfig {
     generatorProvider: string;
     datasourceProvider: string;
     datasourceUrl: string;
+    clientOutput: string;
 }
 /**
  * A parser for Prisma schema files that extracts models, enums, and their properties.
@@ -20,6 +21,7 @@ interface SchemaConfig {
  * ```
  */
 export declare class PrismaSchemaParser {
+    compositeTypes: PrismaModel[];
     /** Collection of parsed enum definitions */
     enums: PrismaEnum[];
     /** Collection of parsed model definitions */
@@ -28,6 +30,7 @@ export declare class PrismaSchemaParser {
     prismaSchemasContent: string;
     parsed: boolean;
     config: SchemaConfig;
+    warningNotLogged: boolean;
     constructor();
     /**
      * Parses the Prisma schema and extracts all models and enums.
@@ -37,6 +40,7 @@ export declare class PrismaSchemaParser {
     parse({ override }?: {
         override: boolean;
     }): PrismaSchema;
+    private extractCompositeTypes;
     /**
      * Extracts all enum definitions from the schema.
      *

package/dist/types/utils/prisma/types.d.ts

@@ -5,12 +5,13 @@ export interface PrismaField {
     isArray: boolean;
     foreignKeyField?: string;
     foreignReferenceField?: string;
-    isRelation: boolean;
+    isRelation?: boolean;
     defaultValue?: any;
     isId?: boolean;
     isUnique?: boolean;
+    isCompositeType?: boolean;
     attributes: string[];
-    rawLine: string;
+    rawLine?: string;
 }
 export interface PrismaModel {
     name: string;

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "arkos",
-  "version": "2.0.0-next.2",
+  "version": "2.0.0-next.21",
+  "type": "module",
   "description": "The Express & Prisma RESTful Framework",
-  "main": "dist/cjs/exports/index.js",
+  "main": "dist/esm/exports/index.js",
   "module": "dist/esm/exports/index.js",
   "types": "dist/types/exports/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/types/exports/index.d.ts",
       "import": "./dist/esm/exports/index.js",
-      "require": "./dist/cjs/exports/index.js"
+      "require": "./dist/esm/exports/index.js"
     },
     "./types": {
       "types": "./dist/types/exports/index.d.ts",
@@ -19,56 +20,61 @@
     "./prisma": {
       "types": "./dist/types/exports/prisma/index.d.ts",
       "import": "./dist/esm/exports/prisma/index.js",
-      "require": "./dist/cjs/exports/prisma/index.js"
+      "require": "./dist/esm/exports/prisma/index.js"
     },
     "./auth": {
       "types": "./dist/types/exports/auth/index.d.ts",
       "import": "./dist/esm/exports/auth/index.js",
-      "require": "./dist/cjs/exports/auth/index.js"
+      "require": "./dist/esm/exports/auth/index.js"
     },
     "./services": {
       "types": "./dist/types/exports/services/index.d.ts",
       "import": "./dist/esm/exports/services/index.js",
-      "require": "./dist/cjs/exports/services/index.js"
+      "require": "./dist/esm/exports/services/index.js"
     },
     "./controllers": {
       "types": "./dist/types/exports/controllers/index.d.ts",
       "import": "./dist/esm/exports/controllers/index.js",
-      "require": "./dist/cjs/exports/controllers/index.js"
+      "require": "./dist/esm/exports/controllers/index.js"
     },
     "./middlewares": {
       "types": "./dist/types/exports/middlewares/index.d.ts",
       "import": "./dist/esm/exports/middlewares/index.js",
-      "require": "./dist/cjs/exports/middlewares/index.js"
+      "require": "./dist/esm/exports/middlewares/index.js"
     },
     "./validation": {
       "types": "./dist/types/exports/validation/index.d.ts",
       "import": "./dist/esm/exports/validation/index.js",
-      "require": "./dist/cjs/exports/validation/index.js"
+      "require": "./dist/esm/exports/validation/index.js"
     },
     "./error-handler": {
       "types": "./dist/types/exports/error-handler/index.d.ts",
       "import": "./dist/esm/exports/error-handler/index.js",
-      "require": "./dist/cjs/exports/error-handler/index.js"
+      "require": "./dist/esm/exports/error-handler/index.js"
+    },
+    "./websockets": {
+      "types": "./dist/types/exports/websockets.d.ts",
+      "import": "./dist/esm/exports/websockets.js",
+      "require": "./dist/esm/exports/websockets.js"
     },
     "./utils": {
       "types": "./dist/types/exports/utils/index.d.ts",
       "import": "./dist/esm/exports/utils/index.js",
-      "require": "./dist/cjs/exports/utils/index.js"
+      "require": "./dist/esm/exports/utils/index.js"
     },
     "./config": {
       "types": "./dist/types/exports/config.d.ts",
       "import": "./dist/esm/exports/config.js",
-      "require": "./dist/cjs/exports/config.js"
+      "require": "./dist/esm/exports/config.js"
     },
     "./cli": {
       "import": "./dist/esm/utils/cli/index.js",
-      "require": "./dist/cjs/utils/cli/index.js"
+      "require": "./dist/esm/utils/cli/index.js"
     },
     "./*": {
       "types": "./dist/types/exports/*.d.ts",
       "import": "./dist/esm/exports/*.js",
-      "require": "./dist/cjs/exports/*.js"
+      "require": "./dist/esm/exports/*.js"
     }
   },
   "bin": {
@@ -76,34 +82,52 @@
   },
   "typesVersions": {
     "*": {
-      "*": ["./dist/types/exports/*/index.d.ts"],
-      "services": ["./dist/types/exports/services/index.d.ts"],
-      "validation": ["./dist/types/exports/validation/index.d.ts"],
-      "error-handler": ["./dist/types/exports/error-handler/index.d.ts"],
-      "prisma": ["./dist/types/exports/prisma/index.d.ts"],
-      "auth": ["./dist/types/exports/auth/index.d.ts"],
-      "middlewares": ["./dist/types/exports/middlewares/index.d.ts"],
-      "utils": ["./dist/types/exports/utils/index.d.ts"],
-      "config": ["./dist/types/exports/config.d.ts"]
+      "*": [
+        "./dist/types/exports/*/index.d.ts"
+      ],
+      "services": [
+        "./dist/types/exports/services/index.d.ts"
+      ],
+      "validation": [
+        "./dist/types/exports/validation/index.d.ts"
+      ],
+      "error-handler": [
+        "./dist/types/exports/error-handler/index.d.ts"
+      ],
+      "prisma": [
+        "./dist/types/exports/prisma/index.d.ts"
+      ],
+      "auth": [
+        "./dist/types/exports/auth/index.d.ts"
+      ],
+      "middlewares": [
+        "./dist/types/exports/middlewares/index.d.ts"
+      ],
+      "utils": [
+        "./dist/types/exports/utils/index.d.ts"
+      ],
+      "config": [
+        "./dist/types/exports/config.d.ts"
+      ],
+      "websockets": [
+        "./dist/types/exports/websockets.d.ts"
+      ]
     }
   },
   "scripts": {
     "build:esm": "tsc -p tsconfig.esm.json && npx tsx scripts/fix-esm-imports.ts",
     "build:types": "tsc -p tsconfig.types.json",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
-    "build": "pnpm clean -p dist && pnpm run build:cjs && pnpm run build:esm && pnpm run build:types && tsx scripts/post-build-scripts.ts",
+    "build": "pnpm clean dist && pnpm run build:esm && pnpm run build:types && tsx scripts/post-build-scripts.ts",
     "buildTsup": "tsup && tsx scripts/post-build-scripts.ts",
-    "minifyOld": "esbuild dist/cjs/**/*.js --minify --outdir=dist --allow-overwrite --log-limit=0 --define:process.env.NODE_ENV=process.env.NODE_ENV",
     "minify": "esbuild $(find dist -type f -name '*.js') --minify --outdir=dist --allow-overwrite --log-limit=0 --define:process.env.NODE_ENV=process.env.NODE_ENV",
     "clean": "tsx scripts/remove-dir-cli.ts",
     "dev": "tsx --watch",
     "lint": "eslint src --ext .ts",
     "prepublishOnly": "pnpm run build",
     "prelinkOnly": "npm run build",
-    "test": "jest",
+    "test": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=2048' jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "test:ui": "vitest --ui",
     "test:create": "tsx src/scripts/create-test.ts",
     "publish:test": "npm publish --tag test",
     "publish:beta": "npm publish --tag beta",
@@ -138,68 +162,77 @@
     "url": "https://github.com/uanela/arkos/issues"
   },
   "homepage": "https://www.arkosjs.com",
-  "files": ["dist", "cli.js", "README.md"],
+  "files": [
+    "dist",
+    "cli.js",
+    "README.md"
+  ],
   "devDependencies": {
-    "@babel/preset-typescript": "^7.27.1",
-    "@scalar/express-api-reference": "^0.8.32",
-    "@types/bcrypt": "^5.0.2",
-    "@types/body-parser": "^1.19.5",
-    "@types/compression": "^1.7.5",
-    "@types/cookie-parser": "^1.4.8",
-    "@types/cors": "^2.8.17",
-    "@types/express": "^5.0.0",
-    "@types/html-to-text": "^9.0.4",
-    "@types/jest": "^29.5.14",
-    "@types/jsonwebtoken": "^9.0.9",
-    "@types/multer": "2.0.0",
-    "@types/node": "^22.13.13",
-    "@types/nodemailer": "^6.4.17",
-    "@types/pluralize": "^0.0.33",
-    "@types/swagger-jsdoc": "^6.0.4",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "esbuild": "^0.25.1",
-    "fast-glob": "^3.3.3",
-    "jest": "^29.7.0",
-    "mimetype": "^0.0.8",
-    "openapi-types": "^12.1.3",
-    "prisma": "^6.19.2",
-    "ts-jest": "^29.3.1",
-    "tsx": "^4.20.3",
-    "type-fest": "^4.41.0",
-    "typescript": "^5.8.2",
-    "vitest": "^3.2.4"
+    "@scalar/express-api-reference": "0.10.11",
+    "@types/bcrypt": "6.0.0",
+    "@types/body-parser": "1.19.6",
+    "@types/compression": "1.8.1",
+    "@types/cookie-parser": "1.4.10",
+    "@types/cors": "2.8.19",
+    "@types/express": "5.0.6",
+    "@types/html-to-text": "9.0.4",
+    "@types/jest": "30.0.0",
+    "@types/jsonwebtoken": "9.0.10",
+    "@types/multer": "2.2.0",
+    "@types/node": "26.1.1",
+    "@types/nodemailer": "8.0.1",
+    "@types/pluralize": "0.0.33",
+    "@types/swagger-jsdoc": "6.0.4",
+    "@typescript-eslint/eslint-plugin": "8.65.0",
+    "@typescript-eslint/parser": "8.65.0",
+    "esbuild": "0.28.1",
+    "fast-glob": "3.3.3",
+    "jest": "30.4.2",
+    "knip": "6.29.0",
+    "mimetype": "0.0.8",
+    "openapi-types": "12.1.3",
+    "prisma": "7.9.0",
+    "socket.io": "^4.8.3",
+    "ts-jest": "29.4.12",
+    "ts-node": "^10.9.2",
+    "ts-prune": "0.10.3",
+    "tsx": "4.23.1",
+    "type-fest": "5.8.0",
+    "typescript": "6.0.3"
   },
   "dependencies": {
-    "chokidar": "^4.0.3",
-    "commander": "^13.1.0",
-    "pluralize": "^8.0.0"
+    "chokidar": "5.0.0",
+    "commander": "15.0.0",
+    "pluralize": "8.0.0",
+    "uuidv7": "^1.2.1"
   },
   "peerDependencies": {
-    "@prisma/client": "^6.19.2",
-    "@scalar/express-api-reference": "^0.8.35",
-    "bcryptjs": "^3.0.2",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.1",
-    "class-validator-jsonschema": "^5.0.2",
-    "compression": "^1.8.0",
-    "cookie-parser": "^1.4.7",
-    "cors": "^2.8.5",
-    "dotenv": "^16.4.7",
-    "dotenv-expand": "^12.0.3",
-    "express": "^4.22.1",
-    "express-rate-limit": "^7.5.0",
-    "html-to-text": "^9.0.5",
-    "jsonwebtoken": "^9.0.2",
-    "mimetype": "^0.0.8",
-    "multer": "2.0.2",
-    "nodemailer": "^6.10.0",
-    "sharp": "^0.33.5",
-    "swagger-jsdoc": "^6.2.8",
-    "zod": "^3.24.2",
-    "zod-to-json-schema": "^3.24.6"
+    "@prisma/client": "7.9.0",
+    "@scalar/api-reference": "1.63.0",
+    "@scalar/express-api-reference": "0.10.11",
+    "bcryptjs": "3.0.3",
+    "class-transformer": "0.5.1",
+    "class-validator": "0.15.1",
+    "class-validator-jsonschema": "5.1.0",
+    "compression": "1.8.1",
+    "cookie-parser": "1.4.7",
+    "cors": "2.8.6",
+    "dotenv": "17.4.2",
+    "dotenv-expand": "13.0.0",
+    "express": "5.2.1",
+    "express-rate-limit": "8.6.1",
+    "html-to-text": "10.0.0",
+    "jsonwebtoken": "9.0.3",
+    "mimetype": "0.0.8",
+    "multer": "2.2.0",
+    "nodemailer": "9.0.3",
+    "sharp": "0.35.3",
+    "socket.io": "^4.8.3",
+    "swagger-jsdoc": "6.2.8",
+    "zod": "4.4.3",
+    "zod-to-json-schema": "3.25.2"
   },
   "engines": {
-    "node": ">=20.16"
+    "node": ">=22.9"
   }
 }

package/dist/cjs/app.js

@@ -1,79 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.arkos = arkos;
-exports.getAppServer = getAppServer;
-require("./utils/helpers/arkos-config.helpers.js");
-const express_1 = __importDefault(require("express"));
-const setup_app_1 = __importDefault(require("./utils/setup-app.js"));
-const initialize_app_1 = __importDefault(require("./utils/initialize-app.js"));
-const server_1 = require("./server.js");
-const runtime_cli_commander_1 = __importDefault(require("./utils/cli/utils/runtime-cli-commander.js"));
-const http_1 = require("http");
-const exit_error_1 = __importDefault(require("./utils/helpers/exit-error.js"));
-const arkos_loadable_registry_1 = __importDefault(require("./components/arkos-loadable-registry/index.js"));
-let appServer;
-const docsLink = "https://www.arkosjs.com/docs/core-concepts/routing/setup#setting-up-your-app";
-let instanciated = false;
-function arkos() {
-    if (instanciated)
-        throw (0, exit_error_1.default)(`arkos() must be called only once, see ${docsLink}`);
-    const app = (0, express_1.default)();
-    (0, setup_app_1.default)(app);
-    instanciated = true;
-    let state = "idle";
-    app.load = (...items) => {
-        if (state !== "idle")
-            throw (0, exit_error_1.default)(`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) => arkos_loadable_registry_1.default.register(item));
-        return app;
-    };
-    function loadApp() {
-        const _app = (0, initialize_app_1.default)(app);
-        if (process.env.CLI_COMMAND)
-            runtime_cli_commander_1.default.handle();
-        return _app;
-    }
-    app.build = function () {
-        if (state === "built" || state === "building")
-            throw (0, exit_error_1.default)(`app.build() must only be called once, see ${docsLink}`);
-        if (state === "listening")
-            throw (0, exit_error_1.default)(`app.build() must be called before app.listen(), see ${docsLink}`);
-        state = "building";
-        const _app = loadApp();
-        state = "built";
-        return _app;
-    };
-    const originalListen = app.listen.bind(app);
-    const defaultCb = (port, host, cb) => {
-        (0, server_1.logAppStartup)(port, host);
-        return cb || function () { };
-    };
-    app.listen = async function (...args) {
-        if (state === "listening")
-            throw (0, exit_error_1.default)(`app.listen() must only be called once, see ${docsLink}`);
-        if (state === "building")
-            throw (0, exit_error_1.default)(`app.build() must be awaited before calling app.listen(), see ${docsLink}`);
-        if (state === "idle") {
-            state = "listening";
-            loadApp();
-        }
-        const port = Number(process.env.__PORT || process.env.PORT || "8000");
-        const host = process.env.__HOST || process.env.HOST || "0.0.0.0";
-        if (args?.length === 0 || typeof args[0] === "function")
-            appServer = originalListen(port, host, defaultCb(port, host, args[0]));
-        else if (args[0] instanceof http_1.Server || typeof args[0] === "object")
-            appServer = args[0].listen(port, host, defaultCb(port, host, args[1]));
-        return appServer;
-    };
-    return app;
-}
-function getAppServer() {
-    return appServer;
-}
-//# sourceMappingURL=app.js.map

package/dist/cjs/app.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"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","sourcesContent":["import \"./utils/helpers/arkos-config.helpers\";\nimport express, { Express } from \"express\";\nimport setupApp from \"./utils/setup-app\";\nimport { Arkos, ArkosLoadable } from \"./types/arkos\";\nimport initializeApp from \"./utils/initialize-app\";\nimport { logAppStartup } from \"./server\";\nimport runtimeCliCommander from \"./utils/cli/utils/runtime-cli-commander\";\nimport { IncomingMessage, Server, ServerResponse } from \"http\";\nimport ExitError from \"./utils/helpers/exit-error\";\nimport loadableRegistry from \"./components/arkos-loadable-registry\";\n\nlet appServer: Server<typeof IncomingMessage, typeof ServerResponse>;\nconst docsLink =\n  \"https://www.arkosjs.com/docs/core-concepts/routing/setup#setting-up-your-app\";\nlet instanciated = false;\n\n/**\n * Creates and configures an Arkos application instance.\n *\n * Arkos extends Express with a small set of methods for registering routers,\n * loading route/service hooks, and booting the application. All Arkos-specific\n * setup (`app.build()`) must happen before the app starts\n * accepting requests.\n *\n * @example\n * ```ts\n * // Simple setup\n * import arkos from \"arkos\";\n *\n * const app = arkos();\n *\n * app.use(reportsRouter);\n *\n * app.listen();\n * ```\n *\n * @example\n * ```ts\n * // Custom HTTP server (e.g. for WebSockets)\n * import arkos from \"arkos\";\n * import http from \"http\";\n *\n * const app = arkos();\n *\n * app.use(reportsRouter);\n *\n * async function start() {\n *  await app.build();\n *\n *  const server = http.createServer(app);\n *  app.listen(server)\n * }\n * main()\n * ```\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/routing/setup}\n */\nexport function arkos(): Arkos {\n  if (instanciated)\n    throw ExitError(`arkos() must be called only once, see ${docsLink}`);\n\n  const app = express() as any as Arkos;\n  setupApp(app);\n  instanciated = true;\n\n  type AppState = \"idle\" | \"building\" | \"built\" | \"listening\";\n  let state: AppState = \"idle\";\n\n  app.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 app;\n  };\n\n  function loadApp() {\n    const _app = initializeApp(app);\n    if (process.env.CLI_COMMAND) runtimeCliCommander.handle();\n    return _app;\n  }\n\n  app.build = function () {\n    if (state === \"built\" || state === \"building\")\n      throw ExitError(`app.build() must only be called once, see ${docsLink}`);\n    if (state === \"listening\")\n      throw ExitError(\n        `app.build() must be called before app.listen(), see ${docsLink}`\n      );\n\n    state = \"building\";\n    const _app = loadApp();\n    state = \"built\";\n    return _app;\n  };\n\n  const originalListen = app.listen.bind(app) as any as Express[\"listen\"];\n  type UserCallback = (err?: Error) => void;\n\n  const defaultCb = (\n    port: number | string,\n    host: string,\n    cb?: UserCallback\n  ) => {\n    logAppStartup(port, host);\n    return cb || function () {};\n  };\n\n  app.listen = async function (...args): Promise<Server> {\n    if (state === \"listening\")\n      throw ExitError(`app.listen() must only be called once, see ${docsLink}`);\n    if (state === \"building\")\n      throw ExitError(\n        `app.build() must be awaited before calling app.listen(), see ${docsLink}`\n      );\n\n    if (state === \"idle\") {\n      state = \"listening\";\n      loadApp();\n    }\n\n    const port = Number(process.env.__PORT || process.env.PORT || \"8000\");\n    const host = process.env.__HOST! || process.env.HOST || \"0.0.0.0\";\n\n    if ((args as any)?.length === 0 || typeof args[0] === \"function\")\n      appServer = originalListen(\n        port,\n        host,\n        defaultCb(port, host, args[0] as UserCallback)\n      );\n    else if (args[0] instanceof Server || typeof args[0] === \"object\")\n      appServer = args[0].listen(\n        port,\n        host,\n        defaultCb(port, host, args[1] as UserCallback)\n      );\n\n    return appServer;\n  };\n\n  return app;\n}\n\nexport function getAppServer() {\n  return appServer;\n}\n"]}

package/dist/cjs/components/arkos-loadable-registry/index.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArkosLoadableRegistry = void 0;
-const LOADABLES = ["ArkosRouteHook", "ArkosServiceHook"];
-class ArkosLoadableRegistry {
-    constructor() {
-        this.items = new Map();
-    }
-    register(item) {
-        const type = item.__type;
-        const moduleName = item.moduleName;
-        if (!LOADABLES.includes(type))
-            throw Error(`Invalid loadable component, expected on of ${LOADABLES.join(", ")} but received "${item}"`);
-        if (!this.items.has(type))
-            this.items.set(type, new Map());
-        this.items.get(type).set(moduleName, item);
-    }
-    getItem(loadableType, moduleName) {
-        return this.items.get(loadableType)?.get(moduleName) ?? null;
-    }
-    hasItem(loadableType, moduleName) {
-        return this.items.get(loadableType)?.has(moduleName) ?? false;
-    }
-}
-exports.ArkosLoadableRegistry = ArkosLoadableRegistry;
-const loadableRegistry = new ArkosLoadableRegistry();
-exports.default = loadableRegistry;
-//# sourceMappingURL=index.js.map

package/dist/cjs/components/arkos-loadable-registry/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/arkos-loadable-registry/index.ts"],"names":[],"mappings":";;;AAGA,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;AAMzD,MAAa,qBAAqB;IAAlC;QACmB,UAAK,GAA4C,IAAI,GAAG,EAAE,CAAC;IAuC9E,CAAC;IAjCC,QAAQ,CAAC,IAAmB;QAC1B,MAAM,IAAI,GAAI,IAAY,CAAC,MAAM,CAAC;QAClC,MAAM,UAAU,GAAI,IAAY,CAAC,UAAU,CAAC;QAE5C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,KAAK,CACT,8CAA8C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAC5F,CAAC;QAEJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAA2B;QAE3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;IAKD,OAAO,CACL,YAAmD,EACnD,UAAkB;QAElB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAChE,CAAC;CACF;AAxCD,sDAwCC;AAED,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAErD,kBAAe,gBAAgB,CAAC","sourcesContent":["import { ArkosLoadable } from \"../../types/arkos\";\nimport { ArkosModuleType } from \"../arkos-route-hook/types\";\n\nconst LOADABLES = [\"ArkosRouteHook\", \"ArkosServiceHook\"];\n\n/**\n * Registry for all items loaded via `app.load()`.\n * Instantiated once at app start and passed through the entire Arkos chain.\n */\nexport class ArkosLoadableRegistry {\n  private readonly items: Map<string, Map<string, ArkosLoadable>> = new Map();\n\n  /**\n   * Registers a loadable item into the registry.\n   * Called internally by `app.load()`.\n   */\n  register(item: ArkosLoadable): void {\n    const type = (item as any).__type;\n    const moduleName = (item as any).moduleName;\n\n    if (!LOADABLES.includes(type))\n      throw Error(\n        `Invalid loadable component, expected on of ${LOADABLES.join(\", \")} but received \"${item}\"`\n      );\n\n    if (!this.items.has(type)) this.items.set(type, new Map());\n\n    this.items.get(type)!.set(moduleName, item);\n  }\n\n  /**\n   * Returns the interceptor for the given module name, or `null` if not registered.\n   */\n  getItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: ArkosModuleType\n  ): ArkosLoadable | null {\n    return this.items.get(loadableType)?.get(moduleName) ?? null;\n  }\n\n  /**\n   * Returns true if an interceptor is registered for the given module name.\n   */\n  hasItem(\n    loadableType: \"ArkosRouteHook\" | \"ArkosServiceHook\",\n    moduleName: string\n  ): boolean {\n    return this.items.get(loadableType)?.has(moduleName) ?? false;\n  }\n}\n\nconst loadableRegistry = new ArkosLoadableRegistry();\n\nexport default loadableRegistry;\n"]}