@antelopejs/api 0.2.0 → 1.1.0

package/dist/dev-registry.d.ts

@@ -0,0 +1,6 @@
+import type * as net from "node:net";
+import { type DevServerEndpoint } from "@antelopejs/interface-core/runtime";
+import { type Config, type ServerConfig } from "./server-config";
+export declare function shouldAllowPortFallback(config: Config): Promise<boolean>;
+export declare function collectListeningEndpoints(servers: net.Server[], configs?: ServerConfig[]): DevServerEndpoint[];
+export declare function registerDevServerEndpoints(endpoints: DevServerEndpoint[]): Promise<void>;

package/dist/dev-registry.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldAllowPortFallback = shouldAllowPortFallback;
+exports.collectListeningEndpoints = collectListeningEndpoints;
+exports.registerDevServerEndpoints = registerDevServerEndpoints;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const runtime_1 = require("@antelopejs/interface-core/runtime");
+const port_binding_1 = require("./port-binding");
+const server_config_1 = require("./server-config");
+const DEV_SERVER_NAME = "api";
+async function shouldAllowPortFallback(config) {
+    if (config.strictPort) {
+        return false;
+    }
+    const runtimeInfo = await (0, runtime_1.GetRuntimeInfo)();
+    return runtimeInfo.dev;
+}
+function buildEndpoint(server, config) {
+    if (!config || !server.listening) {
+        return null;
+    }
+    const port = (0, port_binding_1.resolveBoundPort)(server, config.port ?? server_config_1.DEFAULT_HTTP_PORT);
+    return {
+        protocol: config.protocol,
+        host: config.host ?? server_config_1.DEFAULT_HOST,
+        port,
+    };
+}
+function collectListeningEndpoints(servers, configs = []) {
+    return servers
+        .map((server, index) => buildEndpoint(server, configs[index]))
+        .filter((endpoint) => endpoint !== null);
+}
+async function registerDevServerEndpoints(endpoints) {
+    try {
+        await (0, runtime_1.RegisterDevServer)(DEV_SERVER_NAME, endpoints);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logging_1.Logging.Warn(`Unable to register dev server endpoints: ${message}`);
+    }
+}
+//# sourceMappingURL=dev-registry.js.map

package/dist/dev-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-registry.js","sourceRoot":"","sources":["../src/dev-registry.ts"],"names":[],"mappings":";;AAiBA,0DASC;AAkBD,8DAOC;AAED,gEASC;AA7DD,gEAA6D;AAC7D,gEAI4C;AAC5C,iDAAkD;AAClD,mDAKyB;AAEzB,MAAM,eAAe,GAAG,KAAK,CAAC;AAEvB,KAAK,UAAU,uBAAuB,CAC3C,MAAc;IAEd,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,IAAA,wBAAc,GAAE,CAAC;IAC3C,OAAO,WAAW,CAAC,GAAG,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CACpB,MAAkB,EAClB,MAAqB;IAErB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,+BAAgB,EAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,iCAAiB,CAAC,CAAC;IACxE,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,4BAAY;QACjC,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAgB,yBAAyB,CACvC,OAAqB,EACrB,UAA0B,EAAE;IAE5B,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,QAAQ,EAAiC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAEM,KAAK,UAAU,0BAA0B,CAC9C,SAA8B;IAE9B,IAAI,CAAC;QACH,MAAM,IAAA,2BAAiB,EAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,iBAAO,CAAC,IAAI,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+import { type CorsConfig, type RouteHandler } from "@antelopejs/interface-api";
+import type { Class } from "@antelopejs/interface-core/decorators";
+import { type RequestContext } from "../../server";
+export declare function GetControllerInstance(controllerClass: Class<unknown>, context: RequestContext): Promise<unknown>;
+export declare function Listen(): Promise<void>;
+export declare function GetCorsConfig(): CorsConfig;
+export declare function SetCorsConfig(config: CorsConfig): void;
+interface RouteInfo {
+    id: string;
+    uri: string;
+    method: string;
+    mode: "prefix" | "postfix" | "handler" | "monitor" | "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/index.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routesProxy = void 0;
+exports.GetControllerInstance = GetControllerInstance;
+exports.Listen = Listen;
+exports.GetCorsConfig = GetCorsConfig;
+exports.SetCorsConfig = SetCorsConfig;
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_core_1 = require("@antelopejs/interface-core");
+const index_1 = require("../../index");
+const server_1 = require("../../server");
+const classCacheSymbol = Symbol();
+const registeredRoutes = new Map();
+function getControllerCache(context) {
+    if (!context[classCacheSymbol]) {
+        context[classCacheSymbol] = new Map();
+    }
+    return context[classCacheSymbol];
+}
+async function applyComputedProperties(controllerInstance, controllerMetadata, context) {
+    await Promise.all(Object.entries(controllerMetadata.computed_props).map(async ([propertyKey, parameter]) => {
+        const computedValue = await (0, interface_api_1.computeParameter)(context, parameter, controllerInstance);
+        controllerInstance[propertyKey] = computedValue;
+    }));
+}
+async function GetControllerInstance(controllerClass, context) {
+    const controllerCache = getControllerCache(context);
+    const cacheKey = controllerClass.prototype;
+    const cachedController = controllerCache.get(cacheKey);
+    if (cachedController) {
+        return cachedController;
+    }
+    const typedControllerClass = controllerClass;
+    const controllerInstance = new typedControllerClass();
+    const controllerMetadata = (0, interface_core_1.GetMetadata)(typedControllerClass, interface_api_1.ControllerMeta);
+    await applyComputedProperties(controllerInstance, controllerMetadata, context);
+    controllerCache.set(cacheKey, controllerInstance);
+    return controllerInstance;
+}
+async function Listen() {
+    await (0, index_1.listenServers)();
+}
+function GetCorsConfig() {
+    return (0, index_1.getConfig)().cors ?? {};
+}
+function SetCorsConfig(config) {
+    (0, index_1.setCorsConfig)(config);
+}
+async function invokeHandler(handler, context) {
+    const controllerClass = handler.proto.constructor;
+    const controllerInstance = await GetControllerInstance(controllerClass, context);
+    const resolvedParameters = await Promise.all(handler.parameters.map((parameter) => (0, interface_api_1.computeParameter)(context, parameter, controllerInstance)));
+    return handler.callback.apply(controllerInstance, resolvedParameters);
+}
+exports.routesProxy = {
+    register: (id, handler) => {
+        registeredRoutes.set(id, handler);
+        (0, server_1.registerHandler)(`dev/${id}`, handler.mode, handler.method, handler.location, async (context) => invokeHandler(handler, context), 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=index.js.map

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

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

package/dist/index.d.ts

@@ -1,26 +1,13 @@
-import * as http from 'http';
-import * as https from 'https';
-import './middlewares/cors';
-interface HTTPConfig extends http.ServerOptions {
-    protocol: 'http';
-    host?: string;
-    port?: number;
-}
-interface HTTPSConfig extends https.ServerOptions {
-    protocol: 'https';
-    host?: string;
-    port?: number;
-}
-interface Config {
-    servers?: (HTTPConfig | HTTPSConfig)[];
-    cors?: {
-        allowedOrigins?: string | RegExp | (string | RegExp)[];
-        allowedMethods?: string[];
-    };
-}
+import type { CorsConfig } from "@antelopejs/interface-api";
+import type { DevServerEndpoint } from "@antelopejs/interface-core/runtime";
+import { type Config } from "./server-config";
+import "./middlewares/cors";
 export declare function getConfig(): Config;
+export declare function configure(config: Config): void;
+export declare function setCorsConfig(cors: CorsConfig): void;
 export declare function construct(config: Config): Promise<void>;
 export declare function destroy(): void;
 export declare function start(): void;
-export declare function stop(): void;
-export {};
+export declare function getListeningEndpoints(): DevServerEndpoint[];
+export declare function listenServers(): Promise<void>;
+export declare function stop(): Promise<void>;

package/dist/index.js

@@ -34,52 +34,82 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfig = getConfig;
+exports.configure = configure;
+exports.setCorsConfig = setCorsConfig;
 exports.construct = construct;
 exports.destroy = destroy;
 exports.start = start;
+exports.getListeningEndpoints = getListeningEndpoints;
+exports.listenServers = listenServers;
 exports.stop = stop;
-const http = __importStar(require("http"));
-const https = __importStar(require("https"));
-const beta_1 = require("@ajs/core/beta");
-const server_1 = require("./server");
+const interface_core_1 = require("@antelopejs/interface-core");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const dev_registry_1 = require("./dev-registry");
+const port_binding_1 = require("./port-binding");
+const server_config_1 = require("./server-config");
+const server_factory_1 = require("./server-factory");
 require("./middlewares/cors");
-const beta_2 = require("@ajs/logging/beta");
-let conf;
-let servers;
+let conf = {
+    servers: [],
+};
+let servers = [];
+let listening = false;
 function getConfig() {
     return conf;
 }
+function configure(config) {
+    conf = {
+        ...config,
+        servers: (0, server_config_1.resolveServers)(config),
+    };
+}
+function setCorsConfig(cors) {
+    conf = { ...conf, cors };
+}
 async function construct(config) {
-    conf = config;
-    conf.servers = conf.servers || [];
-    if (conf.servers.length === 0) {
-        conf.servers.push({ protocol: 'http', port: 80 });
-    }
-    await (0, beta_1.ImplementInterface)(Promise.resolve().then(() => __importStar(require('@ajs.local/api/beta'))), Promise.resolve().then(() => __importStar(require('./implementations/api/beta'))));
+    configure(config);
+    void (0, interface_core_1.ImplementInterface)(await Promise.resolve().then(() => __importStar(require("@antelopejs/interface-api"))), await Promise.resolve().then(() => __importStar(require("./implementations/api"))));
 }
 function destroy() { }
+function closeServers() {
+    const closing = servers.map((server) => new Promise((resolve) => {
+        server.close(() => resolve());
+    }));
+    servers = [];
+    listening = false;
+    return Promise.all(closing).then(() => undefined);
+}
 function start() {
-    servers = conf.servers.map((config) => {
-        let server;
-        switch (config.protocol) {
-            case 'http':
-                server = http.createServer(config);
-                server.on('request', (req, res) => void (0, server_1.requestListener)(req, res, 'http'));
-                server.on('upgrade', (req, sock, head) => void (0, server_1.upgradeListener)(req, sock, head, 'ws'));
-                break;
-            case 'https':
-                server = https.createServer(config);
-                server.on('request', (req, res) => void (0, server_1.requestListener)(req, res, 'https'));
-                server.on('upgrade', (req, sock, head) => void (0, server_1.upgradeListener)(req, sock, head, 'wss'));
-                break;
-        }
-        const server_listener = server.listen(config.port, config.host);
-        beta_2.Logging.Info(`Server started, listening on ${config.protocol}://${config.host || 'localhost'}:${config.port}`);
-        return server_listener;
-    });
+    const serversClosed = closeServers();
+    servers = (conf.servers ?? []).map((serverConfig) => (0, server_factory_1.createConfiguredServer)(serverConfig));
+    if (conf.autoListen !== false) {
+        void serversClosed
+            .then(() => listenServers())
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            logging_1.Logging.Error(`Unable to start listening servers: ${message}`);
+        });
+    }
+}
+function getListeningEndpoints() {
+    return (0, dev_registry_1.collectListeningEndpoints)(servers, conf.servers);
+}
+async function listenServers() {
+    if (listening || servers.length === 0) {
+        return;
+    }
+    listening = true;
+    try {
+        const allowPortFallback = await (0, dev_registry_1.shouldAllowPortFallback)(conf);
+        await Promise.all((conf.servers ?? []).map((serverConfig, index) => (0, port_binding_1.listenServer)(servers[index], serverConfig, allowPortFallback)));
+    }
+    catch (error) {
+        listening = false;
+        throw error;
+    }
+    await (0, dev_registry_1.registerDevServerEndpoints)(getListeningEndpoints());
 }
 function stop() {
-    servers.forEach((server) => server.close());
-    servers = [];
+    return closeServers();
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,8BAEC;AAED,8BAQC;AAED,0BAAkC;AAElC,sBAgCC;AAED,oBAGC;AArFD,2CAA6B;AAC7B,6CAA+B;AAG/B,yCAAoD;AACpD,qCAA4D;AAC5D,8BAA4B;AAC5B,4CAA4C;AAsB5C,IAAI,IAAY,CAAC;AACjB,IAAI,OAAqB,CAAC;AAE1B,SAAgB,SAAS;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,IAAI,GAAG,MAAM,CAAC;IACd,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,IAAA,yBAAkB,oDAAQ,qBAAqB,uDAAU,4BAA4B,IAAE,CAAC;AAChG,CAAC;AAED,SAAgB,OAAO,KAAU,CAAC;AAElC,SAAgB,KAAK;IACnB,OAAO,GAAG,IAAI,CAAC,OAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,IAAI,MAAkB,CAAC;QACvB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,MAAM;gBACT,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACnC,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,GAAwB,EAAE,EAAE,CAAC,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAChG,CAAC;gBACF,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,IAAmB,EAAE,IAAY,EAAE,EAAE,CAAC,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAC9G,CAAC;gBACF,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACpC,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,GAAwB,EAAE,EAAE,CAAC,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CACjG,CAAC;gBACF,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,IAAmB,EAAE,IAAY,EAAE,EAAE,CAC/D,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAC/C,CAAC;gBACF,MAAM;QACV,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,cAAO,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,IAAI,IAAI,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/G,OAAO,eAAe,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,IAAI;IAClB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE,CAAC;AACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/middlewares/cors.d.ts

@@ -1,6 +1,6 @@
-import { HTTPResult, RequestContext } from '@ajs.local/api/beta';
-declare const Cors_base: import("@ajs.local/api/beta").ControllerClass<object>;
+import { HTTPResult, type RequestContext } from "@antelopejs/interface-api";
+declare const Cors_base: import("@antelopejs/interface-api").ControllerClass<object>;
 export declare class Cors extends Cors_base {
-    cors(ctx: RequestContext): HTTPResult | undefined;
+    cors(requestContext: RequestContext): HTTPResult | undefined;
 }
 export {};

package/dist/middlewares/cors.js

@@ -13,62 +13,98 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cors = void 0;
-const beta_1 = require("@ajs.local/api/beta");
+const interface_api_1 = require("@antelopejs/interface-api");
 const __1 = require("..");
-function isString(s) {
-    return typeof s === 'string' || s instanceof String;
+const DEFAULT_ALLOWED_METHODS = "GET,HEAD,PUT,PATCH,POST,DELETE";
+const FALSE_ORIGIN = "false";
+const CREDENTIALS_ENABLED_VALUE = "true";
+const NO_BODY_LENGTH = "0";
+const DEFAULT_CREDENTIALS = true;
+function isString(value) {
+    return typeof value === "string" || value instanceof String;
+}
+function toHeaderValue(value) {
+    if (Array.isArray(value)) {
+        return value.join(",");
+    }
+    return value ?? "";
 }
 function isOriginAllowed(origin, allowedOrigin) {
     if (Array.isArray(allowedOrigin)) {
-        for (let i = 0; i < allowedOrigin.length; ++i) {
-            if (isOriginAllowed(origin, allowedOrigin[i])) {
-                return true;
-            }
-        }
-        return false;
+        return allowedOrigin.some((item) => isOriginAllowed(origin, item));
     }
-    else if (isString(allowedOrigin)) {
+    if (isString(allowedOrigin)) {
         return origin === allowedOrigin;
     }
-    else if (allowedOrigin instanceof RegExp) {
+    if (allowedOrigin instanceof RegExp) {
         return allowedOrigin.test(origin);
     }
-    else {
-        return !!allowedOrigin;
+    return Boolean(allowedOrigin);
+}
+function isCredentialsEnabled(cors) {
+    return cors.credentials ?? DEFAULT_CREDENTIALS;
+}
+function addCredentialsHeader(response, cors) {
+    if (isCredentialsEnabled(cors)) {
+        response.addHeader("Access-Control-Allow-Credentials", CREDENTIALS_ENABLED_VALUE);
     }
 }
-class Cors extends (0, beta_1.Controller)('') {
-    cors(ctx) {
-        const config = (0, __1.getConfig)();
-        if (!config.cors) {
-            return;
+function hasStaticAllowedHeaders(cors) {
+    return Boolean(cors.allowedHeaders && cors.allowedHeaders.length > 0);
+}
+function resolveAllowedHeaders(cors, requestContext) {
+    const { allowedHeaders } = cors;
+    if (allowedHeaders && allowedHeaders.length > 0) {
+        return allowedHeaders.join(",");
+    }
+    return toHeaderValue(requestContext.rawRequest.headers["access-control-request-headers"]);
+}
+function addPreflightHeaders(response, requestContext, allowedOriginHeader, cors) {
+    const allowedMethods = cors.allowedMethods?.join(",") ?? DEFAULT_ALLOWED_METHODS;
+    response.addHeader("Access-Control-Allow-Origin", allowedOriginHeader);
+    response.addHeader("Vary", "Origin");
+    response.addHeader("Access-Control-Allow-Methods", allowedMethods);
+    addCredentialsHeader(response, cors);
+    response.addHeader("Access-Control-Allow-Headers", resolveAllowedHeaders(cors, requestContext));
+    if (!hasStaticAllowedHeaders(cors)) {
+        response.addHeader("Vary", "Access-Control-Request-Headers");
+    }
+    if (cors.maxAge !== undefined) {
+        response.addHeader("Access-Control-Max-Age", String(cors.maxAge));
+    }
+    response.addHeader("Content-Length", NO_BODY_LENGTH);
+}
+function addStandardCorsHeaders(requestContext, allowedOriginHeader, cors) {
+    requestContext.response.addHeader("Access-Control-Allow-Origin", allowedOriginHeader);
+    requestContext.response.addHeader("Vary", "Origin");
+    addCredentialsHeader(requestContext.response, cors);
+}
+class Cors extends (0, interface_api_1.Controller)("") {
+    cors(requestContext) {
+        const cors = (0, __1.getConfig)().cors;
+        if (!cors) {
+            return undefined;
         }
-        const requestOrigin = ctx.rawRequest.headers.origin;
-        const isAllowed = isOriginAllowed(requestOrigin, config.cors?.allowedOrigins);
-        if (ctx.rawRequest.method === 'OPTIONS') {
-            const response = new beta_1.HTTPResult(204, null);
-            response.addHeader('Access-Control-Allow-Origin', isAllowed ? requestOrigin : 'false');
-            response.addHeader('Vary', 'Origin');
-            response.addHeader('Access-Control-Allow-Methods', config.cors?.allowedMethods ? config.cors?.allowedMethods.join(',') : 'GET,HEAD,PUT,PATCH,POST,DELETE');
-            response.addHeader('Access-Control-Allow-Credentials', 'true');
-            response.addHeader('Access-Control-Allow-Headers', ctx.rawRequest.headers['access-control-request-headers']);
-            response.addHeader('Vary', 'Access-Control-Request-Headers');
-            response.addHeader('Content-Length', '0');
+        const requestOrigin = requestContext.rawRequest.headers.origin;
+        const isAllowed = requestOrigin
+            ? isOriginAllowed(requestOrigin, cors.allowedOrigins)
+            : false;
+        const allowedOriginHeader = isAllowed && requestOrigin ? requestOrigin : FALSE_ORIGIN;
+        if (requestContext.rawRequest.method === "OPTIONS") {
+            const response = new interface_api_1.HTTPResult(204, null);
+            addPreflightHeaders(response, requestContext, allowedOriginHeader, cors);
             return response;
         }
-        else {
-            ctx.response?.addHeader('Access-Control-Allow-Origin', isAllowed ? requestOrigin : 'false');
-            ctx.response?.addHeader('Vary', 'Origin');
-            ctx.response?.addHeader('Access-Control-Allow-Credentials', 'true');
-        }
+        addStandardCorsHeaders(requestContext, allowedOriginHeader, cors);
+        return undefined;
     }
 }
 exports.Cors = Cors;
 __decorate([
-    (0, beta_1.Prefix)('any', '/', beta_1.HandlerPriority.HIGHEST),
-    __param(0, (0, beta_1.Context)()),
+    (0, interface_api_1.Prefix)("any", "/", interface_api_1.HandlerPriority.HIGHEST),
+    __param(0, (0, interface_api_1.Context)()),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Object)
 ], Cors.prototype, "cors", null);
 //# sourceMappingURL=cors.js.map

package/dist/middlewares/cors.js.map

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

package/dist/port-binding.d.ts

@@ -0,0 +1,4 @@
+import type * as net from "node:net";
+import { type ServerConfig } from "./server-config";
+export declare function resolveBoundPort(server: net.Server, fallbackPort: number): number;
+export declare function listenServer(server: net.Server, config: ServerConfig, allowPortFallback: boolean): Promise<void>;

package/dist/port-binding.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBoundPort = resolveBoundPort;
+exports.listenServer = listenServer;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const server_config_1 = require("./server-config");
+const MAX_PORT_FALLBACK_OFFSET = 20;
+function listenOnce(server, port, host) {
+    return new Promise((resolve, reject) => {
+        const onListening = () => {
+            cleanup();
+            resolve();
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const cleanup = () => {
+            server.off("listening", onListening);
+            server.off("error", onError);
+        };
+        server.once("listening", onListening);
+        server.once("error", onError);
+        server.listen(port, host);
+    });
+}
+function isPortInUseError(error) {
+    return error?.code === "EADDRINUSE";
+}
+function resolveBoundPort(server, fallbackPort) {
+    const address = server.address();
+    if (address && typeof address === "object") {
+        return address.port;
+    }
+    return fallbackPort;
+}
+function buildCandidatePorts(requestedPort, allowPortFallback) {
+    if (!allowPortFallback || requestedPort === server_config_1.RANDOM_PORT) {
+        return [requestedPort];
+    }
+    const sequentialPorts = Array.from({ length: MAX_PORT_FALLBACK_OFFSET + 1 }, (_, offset) => requestedPort + offset);
+    return [...sequentialPorts, server_config_1.RANDOM_PORT];
+}
+async function listenServerWithFallback(server, config, allowPortFallback) {
+    const requestedPort = config.port ?? server_config_1.DEFAULT_HTTP_PORT;
+    const candidatePorts = buildCandidatePorts(requestedPort, allowPortFallback);
+    let portInUseError = new Error(`Unable to bind ${config.protocol} server on port ${requestedPort}`);
+    for (const candidatePort of candidatePorts) {
+        try {
+            await listenOnce(server, candidatePort, config.host);
+            return resolveBoundPort(server, candidatePort);
+        }
+        catch (error) {
+            if (!isPortInUseError(error)) {
+                throw error;
+            }
+            portInUseError = error;
+        }
+    }
+    throw portInUseError;
+}
+function logServerStarted(config, requestedPort, boundPort) {
+    const serverUrl = `${config.protocol}://${config.host ?? server_config_1.DEFAULT_HOST}:${boundPort}`;
+    if (boundPort === requestedPort || requestedPort === server_config_1.RANDOM_PORT) {
+        logging_1.Logging.Info(`Server started, listening on ${serverUrl}`);
+        return;
+    }
+    logging_1.Logging.Info(`Port ${requestedPort} in use, listening on ${serverUrl} instead`);
+}
+async function listenServer(server, config, allowPortFallback) {
+    if (server.listening) {
+        return;
+    }
+    const requestedPort = config.port ?? server_config_1.DEFAULT_HTTP_PORT;
+    const boundPort = await listenServerWithFallback(server, config, allowPortFallback);
+    config.port = boundPort;
+    logServerStarted(config, requestedPort, boundPort);
+}
+//# sourceMappingURL=port-binding.js.map

package/dist/port-binding.js.map

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

package/dist/server-config.d.ts

@@ -0,0 +1,27 @@
+import type * as http from "node:http";
+import type * as https from "node:https";
+import type { CorsConfig } from "@antelopejs/interface-api";
+export type ServerProtocol = "http" | "https";
+export type SocketProtocol = "ws" | "wss";
+interface ServerNetworkConfig {
+    host?: string;
+    port?: number;
+}
+export interface HTTPConfig extends http.ServerOptions, ServerNetworkConfig {
+    protocol: "http";
+}
+export interface HTTPSConfig extends https.ServerOptions, ServerNetworkConfig {
+    protocol: "https";
+}
+export type ServerConfig = HTTPConfig | HTTPSConfig;
+export interface Config {
+    servers?: ServerConfig[];
+    cors?: CorsConfig;
+    autoListen?: boolean;
+    strictPort?: boolean;
+}
+export declare const DEFAULT_HTTP_PORT = 80;
+export declare const DEFAULT_HOST = "localhost";
+export declare const RANDOM_PORT = 0;
+export declare function resolveServers(config: Config): ServerConfig[];
+export {};