@antelopejs/api 0.2.0 → 1.1.0

package/dist/test/antelope.test.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@antelopejs/interface-core/config").ConfigInput;
+export default _default;

package/dist/test/antelope.test.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("@antelopejs/interface-core/config");
+exports.default = (0, config_1.defineConfig)({
+    name: "api-test",
+    cacheFolder: ".antelope/cache",
+    modules: {
+        local: {
+            source: { type: "local", path: "." },
+            config: {
+                servers: [
+                    {
+                        protocol: "http",
+                        host: "127.0.0.1",
+                        port: 5010,
+                    },
+                ],
+            },
+        },
+    },
+    test: {
+        folder: "dist/test",
+    },
+});
+//# sourceMappingURL=antelope.test.js.map

package/dist/test/antelope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"antelope.test.js","sourceRoot":"","sources":["../../src/test/antelope.test.ts"],"names":[],"mappings":";;AAAA,8DAAiE;AAEjE,kBAAe,IAAA,qBAAY,EAAC;IAC1B,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,iBAAiB;IAC9B,OAAO,EAAE;QACP,KAAK,EAAE;YACL,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE;YACpC,MAAM,EAAE;gBACN,OAAO,EAAE;oBACP;wBACE,QAAQ,EAAE,MAAM;wBAChB,IAAI,EAAE,WAAW;wBACjB,IAAI,EAAE,IAAI;qBACX;iBACF;aACF;SACF;KACF;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,WAAW;KACpB;CACF,CAAC,CAAC"}

package/dist/test/cors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/cors.test.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const interface_api_1 = require("@antelopejs/interface-api");
+const api_1 = require("../implementations/api");
+const index_1 = require("../index");
+const cors_1 = require("../middlewares/cors");
+const ALLOWED_ORIGIN = "https://example.com";
+const DISALLOWED_ORIGIN = "https://evil.com";
+const REQUESTED_HEADERS = "x-custom";
+const PREFLIGHT_STATUS = 204;
+const corsController = new cors_1.Cors();
+function buildContext(method, headers) {
+    return {
+        rawRequest: { method, headers },
+        response: new interface_api_1.HTTPResult(),
+    };
+}
+function preflightHeaders(headers) {
+    const result = corsController.cors(buildContext("OPTIONS", headers));
+    node_assert_1.default.ok(result instanceof interface_api_1.HTTPResult);
+    return result.getHeaders();
+}
+describe("CORS", () => {
+    let originalConfig;
+    before(() => {
+        originalConfig = (0, index_1.getConfig)();
+    });
+    after(() => {
+        (0, index_1.configure)(originalConfig);
+    });
+    it("round-trips the configuration through the contract functions", () => {
+        (0, api_1.SetCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN, credentials: false });
+        node_assert_1.default.deepEqual((0, api_1.GetCorsConfig)(), {
+            allowedOrigins: ALLOWED_ORIGIN,
+            credentials: false,
+        });
+        node_assert_1.default.deepEqual((0, index_1.getConfig)().cors, {
+            allowedOrigins: ALLOWED_ORIGIN,
+            credentials: false,
+        });
+    });
+    it("returns an empty configuration when CORS is unset", () => {
+        (0, index_1.configure)({ servers: [] });
+        node_assert_1.default.deepEqual((0, api_1.GetCorsConfig)(), {});
+    });
+    it("skips handling when no configuration is set", () => {
+        (0, index_1.configure)({ servers: [] });
+        const context = buildContext("GET", { origin: ALLOWED_ORIGIN });
+        const result = corsController.cors(context);
+        node_assert_1.default.equal(result, undefined);
+        node_assert_1.default.deepEqual(context.response.getHeaders(), {});
+    });
+    it("adds standard headers for an allowed origin", () => {
+        (0, index_1.setCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN });
+        const context = buildContext("GET", { origin: ALLOWED_ORIGIN });
+        const result = corsController.cors(context);
+        const headers = context.response.getHeaders();
+        node_assert_1.default.equal(result, undefined);
+        node_assert_1.default.equal(headers["Access-Control-Allow-Origin"], ALLOWED_ORIGIN);
+        node_assert_1.default.equal(headers["Access-Control-Allow-Credentials"], "true");
+    });
+    it("reports a disallowed origin as false", () => {
+        (0, index_1.setCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN });
+        const context = buildContext("GET", { origin: DISALLOWED_ORIGIN });
+        corsController.cors(context);
+        node_assert_1.default.equal(context.response.getHeaders()["Access-Control-Allow-Origin"], "false");
+    });
+    it("omits the credentials header when credentials are disabled", () => {
+        (0, index_1.setCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN, credentials: false });
+        const context = buildContext("GET", { origin: ALLOWED_ORIGIN });
+        corsController.cors(context);
+        node_assert_1.default.equal(context.response.getHeaders()["Access-Control-Allow-Credentials"], undefined);
+    });
+    it("emits preflight headers with configured methods and max-age", () => {
+        (0, index_1.setCorsConfig)({
+            allowedOrigins: ALLOWED_ORIGIN,
+            allowedMethods: ["GET", "POST"],
+            maxAge: 600,
+        });
+        const result = corsController.cors(buildContext("OPTIONS", { origin: ALLOWED_ORIGIN }));
+        node_assert_1.default.ok(result instanceof interface_api_1.HTTPResult);
+        node_assert_1.default.equal(result.getStatus(), PREFLIGHT_STATUS);
+        const headers = result.getHeaders();
+        node_assert_1.default.equal(headers["Access-Control-Allow-Methods"], "GET,POST");
+        node_assert_1.default.equal(headers["Access-Control-Max-Age"], "600");
+    });
+    it("reflects the requested headers when none are configured", () => {
+        (0, index_1.setCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN });
+        const headers = preflightHeaders({
+            origin: ALLOWED_ORIGIN,
+            "access-control-request-headers": REQUESTED_HEADERS,
+        });
+        node_assert_1.default.equal(headers["Access-Control-Allow-Headers"], REQUESTED_HEADERS);
+        node_assert_1.default.equal(headers.Vary, "Access-Control-Request-Headers");
+    });
+    it("uses the configured allowed headers over the requested ones", () => {
+        (0, index_1.setCorsConfig)({
+            allowedOrigins: ALLOWED_ORIGIN,
+            allowedHeaders: ["X-A", "X-B"],
+        });
+        const headers = preflightHeaders({
+            origin: ALLOWED_ORIGIN,
+            "access-control-request-headers": REQUESTED_HEADERS,
+        });
+        node_assert_1.default.equal(headers["Access-Control-Allow-Headers"], "X-A,X-B");
+        node_assert_1.default.equal(headers.Vary, "Origin");
+    });
+    it("omits the max-age header when it is not configured", () => {
+        (0, index_1.setCorsConfig)({ allowedOrigins: ALLOWED_ORIGIN });
+        const headers = preflightHeaders({ origin: ALLOWED_ORIGIN });
+        node_assert_1.default.equal(headers["Access-Control-Max-Age"], undefined);
+    });
+});
+//# sourceMappingURL=cors.test.js.map

package/dist/test/cors.test.js.map

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

package/dist/test/listen.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/listen.test.js

@@ -0,0 +1,225 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const net = __importStar(require("node:net"));
+const coreRuntime = __importStar(require("@antelopejs/interface-core/runtime"));
+const sinon_1 = __importDefault(require("sinon"));
+const index_1 = require("../index");
+const TEST_HOST = "127.0.0.1";
+const FALLBACK_BASE_PORT = 25040;
+const EXPLICIT_FALSE_PORT = 25060;
+const STRICT_FREE_PORT = 25070;
+const STRICT_PORT = 25080;
+const PROD_PORT = 25090;
+const EXHAUSTED_BASE_PORT = 25100;
+const EXHAUSTED_RANGE_SIZE = 21;
+const MULTI_OCCUPIED_PORT = 25140;
+const MULTI_FREE_PORT = 25150;
+const RANDOM_PORT = 0;
+function occupyPort(port) {
+    return new Promise((resolve, reject) => {
+        const blocker = net.createServer();
+        blocker.once("error", reject);
+        blocker.listen(port, TEST_HOST, () => resolve(blocker));
+    });
+}
+function closeServer(server) {
+    return new Promise((resolve) => {
+        server.close(() => resolve());
+    });
+}
+function configureSingleServer(port, strictPort) {
+    (0, index_1.configure)({
+        autoListen: false,
+        strictPort,
+        servers: [{ protocol: "http", host: TEST_HOST, port }],
+    });
+    (0, index_1.start)();
+}
+function isPortInUseError(error) {
+    return error.code === "EADDRINUSE";
+}
+function stubRuntime(dev) {
+    sinon_1.default
+        .stub(coreRuntime, "GetRuntimeInfo")
+        .resolves({ dev, projectPath: "", env: "test" });
+    return sinon_1.default.stub(coreRuntime, "RegisterDevServer").resolves();
+}
+const LISTEN_POLL_INTERVAL_MS = 50;
+const LISTEN_POLL_TIMEOUT_MS = 2000;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForListening() {
+    const deadline = Date.now() + LISTEN_POLL_TIMEOUT_MS;
+    while ((0, index_1.getListeningEndpoints)().length === 0) {
+        if (Date.now() > deadline) {
+            throw new Error("Timed out waiting for servers to listen");
+        }
+        await delay(LISTEN_POLL_INTERVAL_MS);
+    }
+}
+describe("Port fallback", () => {
+    const blockers = [];
+    let originalConfig;
+    async function blockPort(port) {
+        blockers.push(await occupyPort(port));
+    }
+    before(() => {
+        originalConfig = (0, index_1.getConfig)();
+    });
+    after(async () => {
+        if (!originalConfig.servers?.length) {
+            return;
+        }
+        (0, index_1.configure)(originalConfig);
+        (0, index_1.start)();
+        if (originalConfig.autoListen !== false) {
+            await waitForListening();
+        }
+    });
+    afterEach(async () => {
+        await (0, index_1.stop)();
+        sinon_1.default.restore();
+        await Promise.all(blockers.map((blocker) => closeServer(blocker)));
+        blockers.length = 0;
+    });
+    it("falls back to the next available port in dev runtime", async () => {
+        const registerStub = stubRuntime(true);
+        await blockPort(FALLBACK_BASE_PORT);
+        configureSingleServer(FALLBACK_BASE_PORT);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.equal(endpoints[0].port, FALLBACK_BASE_PORT + 1);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[0].port, FALLBACK_BASE_PORT + 1);
+        sinon_1.default.assert.calledOnce(registerStub);
+        node_assert_1.default.deepEqual(registerStub.firstCall.args, ["api", endpoints]);
+    });
+    it("falls back to a random port when the whole range is occupied", async () => {
+        stubRuntime(true);
+        const occupiedPorts = Array.from({ length: EXHAUSTED_RANGE_SIZE }, (_, offset) => EXHAUSTED_BASE_PORT + offset);
+        await Promise.all(occupiedPorts.map((port) => blockPort(port)));
+        configureSingleServer(EXHAUSTED_BASE_PORT);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.ok(endpoints[0].port > 0);
+        node_assert_1.default.ok(!occupiedPorts.includes(endpoints[0].port));
+    });
+    it("falls back when strictPort is explicitly false in dev runtime", async () => {
+        stubRuntime(true);
+        await blockPort(EXPLICIT_FALSE_PORT);
+        configureSingleServer(EXPLICIT_FALSE_PORT, false);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.equal(endpoints[0].port, EXPLICIT_FALSE_PORT + 1);
+    });
+    it("rejects when the port is in use and strictPort is enabled", async () => {
+        stubRuntime(true);
+        await blockPort(STRICT_PORT);
+        configureSingleServer(STRICT_PORT, true);
+        await node_assert_1.default.rejects((0, index_1.listenServers)(), isPortInUseError);
+    });
+    it("binds the requested port when strictPort is enabled and the port is free", async () => {
+        stubRuntime(true);
+        configureSingleServer(STRICT_FREE_PORT, true);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.equal(endpoints[0].port, STRICT_FREE_PORT);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[0].port, STRICT_FREE_PORT);
+    });
+    it("rejects when the port is in use outside of dev runtime", async () => {
+        stubRuntime(false);
+        await blockPort(PROD_PORT);
+        configureSingleServer(PROD_PORT);
+        await node_assert_1.default.rejects((0, index_1.listenServers)(), isPortInUseError);
+    });
+    it("reports actual endpoints when listening on a random port", async () => {
+        stubRuntime(false);
+        configureSingleServer(RANDOM_PORT);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.ok(endpoints[0].port > 0);
+        node_assert_1.default.equal(endpoints[0].protocol, "http");
+        node_assert_1.default.equal(endpoints[0].host, TEST_HOST);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[0].port, endpoints[0].port);
+    });
+    it("binds a single random port when port 0 is requested in dev runtime", async () => {
+        stubRuntime(true);
+        configureSingleServer(RANDOM_PORT);
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 1);
+        node_assert_1.default.ok(endpoints[0].port > 0);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[0].port, endpoints[0].port);
+    });
+    it("falls back per server when multiple servers are configured", async () => {
+        const registerStub = stubRuntime(true);
+        await blockPort(MULTI_OCCUPIED_PORT);
+        (0, index_1.configure)({
+            autoListen: false,
+            servers: [
+                { protocol: "http", host: TEST_HOST, port: MULTI_OCCUPIED_PORT },
+                { protocol: "http", host: TEST_HOST, port: MULTI_FREE_PORT },
+            ],
+        });
+        (0, index_1.start)();
+        await (0, index_1.listenServers)();
+        const endpoints = (0, index_1.getListeningEndpoints)();
+        node_assert_1.default.equal(endpoints.length, 2);
+        node_assert_1.default.equal(endpoints[0].port, MULTI_OCCUPIED_PORT + 1);
+        node_assert_1.default.equal(endpoints[1].port, MULTI_FREE_PORT);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[0].port, MULTI_OCCUPIED_PORT + 1);
+        node_assert_1.default.equal((0, index_1.getConfig)().servers?.[1].port, MULTI_FREE_PORT);
+        sinon_1.default.assert.calledOnce(registerStub);
+        node_assert_1.default.deepEqual(registerStub.firstCall.args, ["api", endpoints]);
+    });
+    it("clears endpoints after stop", async () => {
+        stubRuntime(false);
+        configureSingleServer(RANDOM_PORT);
+        await (0, index_1.listenServers)();
+        await (0, index_1.stop)();
+        node_assert_1.default.deepEqual((0, index_1.getListeningEndpoints)(), []);
+    });
+});
+//# sourceMappingURL=listen.test.js.map

package/dist/test/listen.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/api",
-  "version": "0.2.0",
+  "version": "1.1.0",
   "description": "A flexible API module that implements the API interfaces of antelopejs with HTTP and WebSocket support",
   "keywords": [
     "antelopejs",
@@ -23,26 +23,21 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.6.5",
   "scripts": {
-    "build": "rm -rf dist && tsc",
-    "dev:prepare": "cd playground && ajs module imports install",
+    "build": "rimraf dist && tsc",
     "dev": "ajs project run -w -p playground",
-    "format": "prettier --write .",
-    "generate": "ajs module exports generate",
-    "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix",
-    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "format": "biome format --write .",
+    "lint:fix": "biome check --write .",
+    "lint": "biome check .",
     "prepack": "pnpm run build",
-    "prepare": "ajs module imports install",
     "release": "pnpm run lint && pnpm run test && pnpm run prepack && release-it",
-    "test": "ajs module test .",
-    "changelog": "changelogen"
+    "test": "pnpm run build && ajs module test ."
   },
   "antelopeJs": {
-    "exportsPath": "dist/interfaces",
-    "imports": [
-      "core@beta",
-      "logging@beta"
+    "implements": [
+      "@antelopejs/interface-api",
+      "@antelopejs/interface-api-util"
     ],
-    "importsOptional": [],
+    "test": "src/test/antelope.test.ts",
     "defaultConfig": {
       "servers": [
         {
@@ -51,36 +46,25 @@
           "port": 8080
         }
       ]
-    },
-    "test": {
-      "project": "src/test/antelope.test.json",
-      "folder": "dist/test"
     }
   },
   "dependencies": {
+    "@antelopejs/interface-api": "^0.0.4",
+    "@antelopejs/interface-api-util": "^0.0.2",
+    "@antelopejs/interface-core": "^0.0.5",
     "reflect-metadata": "^0.2.2",
-    "ws": "^8.18.1"
+    "ws": "^8.20.0"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.25.0",
-    "@types/chai": "^5.2.2",
-    "@types/express": "^5.0.1",
+    "@biomejs/biome": "2.3.2",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.14.1",
-    "@types/sinon": "^17.0.4",
+    "@types/node": "^22.19.15",
+    "@types/sinon": "^21.0.0",
     "@types/ws": "^8.18.1",
-    "chai": "^5.2.0",
-    "eslint": "^9.25.0",
-    "eslint-config-prettier": "^10.1.2",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-prettier": "^5.2.6",
-    "globals": "^16.0.0",
-    "prettier": "^3.5.3",
-    "release-it": "^19.0.2",
+    "release-it": "^19.2.4",
     "release-it-changelogen": "^0.1.0",
-    "sinon": "^20.0.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.30.1"
+    "rimraf": "^6.1.3",
+    "sinon": "^21.0.3",
+    "typescript": "^5.9.3"
   }
 }

package/dist/implementations/api/beta.d.ts

@@ -1,21 +0,0 @@
-import { RouteHandler } from '@ajs.local/api/beta';
-import { RequestContext } from '../../server';
-declare const classCacheSymbol: unique symbol;
-interface RequestContextDev extends RequestContext {
-    [classCacheSymbol]?: Map<any, any>;
-}
-export declare function GetControllerInstance(cl: any, context: RequestContextDev): Promise<any>;
-interface RouteInfo {
-    id: string;
-    uri: string;
-    method: string;
-    mode: 'prefix' | 'postfix' | 'handler' | 'websocket';
-    priority?: number;
-    callbackName: string;
-}
-export declare const routesProxy: {
-    register: (id: string, handler: RouteHandler) => void;
-    unregister: (id: string) => void;
-    getRoutes: () => RouteInfo[];
-};
-export {};

package/dist/implementations/api/beta.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.routesProxy = void 0;
-exports.GetControllerInstance = GetControllerInstance;
-const beta_1 = require("@ajs.local/api/beta");
-const server_1 = require("../../server");
-const beta_2 = require("@ajs/core/beta");
-const classCacheSymbol = Symbol();
-const registeredRoutes = new Map();
-async function GetControllerInstance(cl, context) {
-    if (!(classCacheSymbol in context)) {
-        context[classCacheSymbol] = new Map();
-    }
-    if (context[classCacheSymbol].has(cl.prototype)) {
-        return context[classCacheSymbol].get(cl.prototype);
-    }
-    const obj = new cl();
-    const meta = (0, beta_2.GetMetadata)(cl, beta_1.ControllerMeta);
-    await Promise.all(Object.entries(meta.computed_props).map(async ([key, param]) => {
-        const val = await (0, beta_1.computeParameter)(context, param, obj);
-        obj[key] = val;
-    }));
-    context[classCacheSymbol].set(cl.prototype, obj);
-    return obj;
-}
-exports.routesProxy = {
-    register: (id, handler) => {
-        registeredRoutes.set(id, handler);
-        (0, server_1.registerHandler)('dev/' + id, handler.mode, handler.method, handler.location, async (context) => {
-            const thisObj = await GetControllerInstance(handler.proto.constructor, context);
-            const params = await Promise.all(handler.parameters.map((param) => (0, beta_1.computeParameter)(context, param, thisObj)));
-            return handler.callback.apply(thisObj, params);
-        }, handler.priority);
-    },
-    unregister: (id) => {
-        registeredRoutes.delete(id);
-        (0, server_1.unregisterHandler)('dev/' + id);
-    },
-    getRoutes: () => {
-        const routes = [];
-        registeredRoutes.forEach((handler, id) => {
-            routes.push({
-                id,
-                uri: handler.location,
-                method: handler.method,
-                mode: handler.mode,
-                priority: handler.priority,
-                callbackName: handler.callback.name || 'anonymous',
-            });
-        });
-        return routes;
-    },
-};
-//# sourceMappingURL=beta.js.map

package/dist/implementations/api/beta.js.map

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