@antelopejs/api 1.0.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

@@ -1,8 +1,10 @@
-import { type RouteHandler } from "@antelopejs/interface-api";
+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;

package/dist/implementations/api/index.js

@@ -3,6 +3,8 @@ 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");
@@ -38,6 +40,12 @@ async function GetControllerInstance(controllerClass, context) {
 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);

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

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

package/dist/index.d.ts

@@ -1,31 +1,13 @@
-import * as http from "node:http";
-import * as https from "node:https";
+import type { CorsConfig } from "@antelopejs/interface-api";
+import type { DevServerEndpoint } from "@antelopejs/interface-core/runtime";
+import { type Config } from "./server-config";
 import "./middlewares/cors";
-interface ServerNetworkConfig {
-    host?: string;
-    port?: number;
-}
-interface HTTPConfig extends http.ServerOptions, ServerNetworkConfig {
-    protocol: "http";
-}
-interface HTTPSConfig extends https.ServerOptions, ServerNetworkConfig {
-    protocol: "https";
-}
-type ServerConfig = HTTPConfig | HTTPSConfig;
-type AllowedOrigin = string | RegExp | Array<string | RegExp>;
-interface CorsConfig {
-    allowedOrigins?: AllowedOrigin;
-    allowedMethods?: string[];
-}
-interface Config {
-    servers?: ServerConfig[];
-    cors?: CorsConfig;
-    autoListen?: boolean;
-}
 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 getListeningEndpoints(): DevServerEndpoint[];
 export declare function listenServers(): Promise<void>;
-export declare function stop(): void;
-export {};
+export declare function stop(): Promise<void>;

package/dist/index.js

@@ -34,118 +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("node:http"));
-const https = __importStar(require("node:https"));
 const interface_core_1 = require("@antelopejs/interface-core");
-const server_1 = require("./server");
-require("./middlewares/cors");
 const logging_1 = require("@antelopejs/interface-core/logging");
-const DEFAULT_HTTP_PORT = 80;
-const DEFAULT_HOST = "localhost";
-const DEFAULT_SERVER_CONFIG = {
-    protocol: "http",
-    port: DEFAULT_HTTP_PORT,
-};
-const SERVER_FACTORY_BY_PROTOCOL = {
-    http: (config) => createHTTPServer(config),
-    https: (config) => createHTTPSServer(config),
-};
+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");
 let conf = {
     servers: [],
 };
 let servers = [];
 let listening = false;
-function createHTTPServer(config) {
-    const server = http.createServer(config);
-    attachServerListeners(server, "http", "ws");
-    return server;
-}
-function createHTTPSServer(config) {
-    const server = https.createServer(config);
-    attachServerListeners(server, "https", "wss");
-    return server;
-}
-function attachServerListeners(server, protocol, socketProtocol) {
-    server.on("request", (req, res) => void (0, server_1.requestListener)(req, res, protocol));
-    server.on("upgrade", (req, socket, head) => void (0, server_1.upgradeListener)(req, socket, head, socketProtocol));
-}
-function resolveServers(config) {
-    if (config.servers && config.servers.length > 0) {
-        return config.servers;
-    }
-    return [DEFAULT_SERVER_CONFIG];
-}
-function createConfiguredServer(config) {
-    const serverFactory = SERVER_FACTORY_BY_PROTOCOL[config.protocol];
-    return serverFactory(config);
-}
-function listenServer(server, config) {
-    if (server.listening) {
-        return Promise.resolve();
-    }
-    return new Promise((resolve, reject) => {
-        const onListening = () => {
-            cleanup();
-            logging_1.Logging.Info(`Server started, listening on ${config.protocol}://${config.host ?? DEFAULT_HOST}:${config.port}`);
-            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(config.port, config.host);
-    });
-}
 function getConfig() {
     return conf;
 }
-async function construct(config) {
+function configure(config) {
     conf = {
         ...config,
-        servers: resolveServers(config),
+        servers: (0, server_config_1.resolveServers)(config),
     };
+}
+function setCorsConfig(cors) {
+    conf = { ...conf, cors };
+}
+async function construct(config) {
+    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 start() {
-    servers = (conf.servers ?? []).map((serverConfig) => createConfiguredServer(serverConfig));
+function closeServers() {
+    const closing = servers.map((server) => new Promise((resolve) => {
+        server.close(() => resolve());
+    }));
+    servers = [];
     listening = false;
+    return Promise.all(closing).then(() => undefined);
+}
+function start() {
+    const serversClosed = closeServers();
+    servers = (conf.servers ?? []).map((serverConfig) => (0, server_factory_1.createConfiguredServer)(serverConfig));
     if (conf.autoListen !== false) {
-        void listenServers().catch((error) => {
+        void serversClosed
+            .then(() => listenServers())
+            .catch((error) => {
             const message = error instanceof Error ? error.message : String(error);
-            logging_1.Logging.Info(`Unable to start listening servers: ${message}`);
+            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 {
-        await Promise.all((conf.servers ?? []).map((serverConfig, index) => listenServer(servers[index], serverConfig)));
+        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() {
-    for (const server of servers) {
-        server.close();
-    }
-    servers = [];
-    listening = false;
+    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":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/middlewares/cors.js

@@ -17,8 +17,9 @@ const interface_api_1 = require("@antelopejs/interface-api");
 const __1 = require("..");
 const DEFAULT_ALLOWED_METHODS = "GET,HEAD,PUT,PATCH,POST,DELETE";
 const FALSE_ORIGIN = "false";
-const TRUE_CREDENTIALS = "true";
+const CREDENTIALS_ENABLED_VALUE = "true";
 const NO_BODY_LENGTH = "0";
+const DEFAULT_CREDENTIALS = true;
 function isString(value) {
     return typeof value === "string" || value instanceof String;
 }
@@ -40,40 +41,61 @@ function isOriginAllowed(origin, allowedOrigin) {
     }
     return Boolean(allowedOrigin);
 }
-function addPreflightHeaders(response, requestContext, allowedOriginHeader) {
-    const config = (0, __1.getConfig)();
-    const allowedMethods = config.cors?.allowedMethods?.join(",") ?? DEFAULT_ALLOWED_METHODS;
-    const requestedHeaders = toHeaderValue(requestContext.rawRequest.headers["access-control-request-headers"]);
+function isCredentialsEnabled(cors) {
+    return cors.credentials ?? DEFAULT_CREDENTIALS;
+}
+function addCredentialsHeader(response, cors) {
+    if (isCredentialsEnabled(cors)) {
+        response.addHeader("Access-Control-Allow-Credentials", CREDENTIALS_ENABLED_VALUE);
+    }
+}
+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);
-    response.addHeader("Access-Control-Allow-Credentials", TRUE_CREDENTIALS);
-    response.addHeader("Access-Control-Allow-Headers", requestedHeaders);
-    response.addHeader("Vary", "Access-Control-Request-Headers");
+    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) {
+function addStandardCorsHeaders(requestContext, allowedOriginHeader, cors) {
     requestContext.response.addHeader("Access-Control-Allow-Origin", allowedOriginHeader);
     requestContext.response.addHeader("Vary", "Origin");
-    requestContext.response.addHeader("Access-Control-Allow-Credentials", TRUE_CREDENTIALS);
+    addCredentialsHeader(requestContext.response, cors);
 }
 class Cors extends (0, interface_api_1.Controller)("") {
     cors(requestContext) {
-        const config = (0, __1.getConfig)();
-        if (!config.cors) {
+        const cors = (0, __1.getConfig)().cors;
+        if (!cors) {
             return undefined;
         }
         const requestOrigin = requestContext.rawRequest.headers.origin;
         const isAllowed = requestOrigin
-            ? isOriginAllowed(requestOrigin, config.cors.allowedOrigins)
+            ? 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);
+            addPreflightHeaders(response, requestContext, allowedOriginHeader, cors);
             return response;
         }
-        addStandardCorsHeaders(requestContext, allowedOriginHeader);
+        addStandardCorsHeaders(requestContext, allowedOriginHeader, cors);
         return undefined;
     }
 }

package/dist/middlewares/cors.js.map

@@ -1 +1 @@
-{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../src/middlewares/cors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DAOmC;AACnC,0BAA+B;AAM/B,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AACjE,MAAM,YAAY,GAAG,OAAO,CAAC;AAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CACtB,MAAc,EACd,aAA6B;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,KAAK,aAAa,CAAC;IAClC,CAAC;IAED,IAAI,aAAa,YAAY,MAAM,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAoB,EACpB,cAA8B,EAC9B,mBAA2B;IAE3B,MAAM,MAAM,GAAG,IAAA,aAAS,GAAE,CAAC;IAC3B,MAAM,cAAc,GAClB,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,uBAAuB,CAAC;IACpE,MAAM,gBAAgB,GAAG,aAAa,CACpC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,gCAAgC,CAAC,CACpE,CAAC;IAEF,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,mBAAmB,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;IACnE,QAAQ,CAAC,SAAS,CAAC,kCAAkC,EAAE,gBAAgB,CAAC,CAAC;IACzE,QAAQ,CAAC,SAAS,CAAC,8BAA8B,EAAE,gBAAgB,CAAC,CAAC;IACrE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,sBAAsB,CAC7B,cAA8B,EAC9B,mBAA2B;IAE3B,cAAc,CAAC,QAAQ,CAAC,SAAS,CAC/B,6BAA6B,EAC7B,mBAAmB,CACpB,CAAC;IACF,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,cAAc,CAAC,QAAQ,CAAC,SAAS,CAC/B,kCAAkC,EAClC,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED,MAAa,IAAK,SAAQ,IAAA,0BAAU,EAAC,EAAE,CAAC;IAEtC,IAAI,CAAY,cAA8B;QAC5C,MAAM,MAAM,GAAG,IAAA,aAAS,GAAE,CAAC;QAE3B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/D,MAAM,SAAS,GAAG,aAAa;YAC7B,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC;QACV,MAAM,mBAAmB,GACvB,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;QAE5D,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,0BAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3C,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAC;YACnE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,sBAAsB,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAzBD,oBAyBC;AAvBC;IADC,IAAA,sBAAM,EAAC,KAAK,EAAE,GAAG,EAAE,+BAAe,CAAC,OAAO,CAAC;IACtC,WAAA,IAAA,uBAAO,GAAE,CAAA;;;;gCAsBd"}
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../src/middlewares/cors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DASmC;AACnC,0BAA+B;AAI/B,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AACjE,MAAM,YAAY,GAAG,OAAO,CAAC;AAC7B,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CACtB,MAAc,EACd,aAA6B;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,KAAK,aAAa,CAAC;IAClC,CAAC;IAED,IAAI,aAAa,YAAY,MAAM,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAgB;IAC5C,OAAO,IAAI,CAAC,WAAW,IAAI,mBAAmB,CAAC;AACjD,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAoB,EAAE,IAAgB;IAClE,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,SAAS,CAChB,kCAAkC,EAClC,yBAAyB,CAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAgB;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAgB,EAChB,cAA8B;IAE9B,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,aAAa,CAClB,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,gCAAgC,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAoB,EACpB,cAA8B,EAC9B,mBAA2B,EAC3B,IAAgB;IAEhB,MAAM,cAAc,GAClB,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,uBAAuB,CAAC;IAE5D,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,mBAAmB,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;IACnE,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,CAChB,8BAA8B,EAC9B,qBAAqB,CAAC,IAAI,EAAE,cAAc,CAAC,CAC5C,CAAC;IACF,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,sBAAsB,CAC7B,cAA8B,EAC9B,mBAA2B,EAC3B,IAAgB;IAEhB,cAAc,CAAC,QAAQ,CAAC,SAAS,CAC/B,6BAA6B,EAC7B,mBAAmB,CACpB,CAAC;IACF,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,oBAAoB,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAa,IAAK,SAAQ,IAAA,0BAAU,EAAC,EAAE,CAAC;IAEtC,IAAI,CAAY,cAA8B;QAC5C,MAAM,IAAI,GAAG,IAAA,aAAS,GAAE,CAAC,IAAI,CAAC;QAE9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/D,MAAM,SAAS,GAAG,aAAa;YAC7B,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC;YACrD,CAAC,CAAC,KAAK,CAAC;QACV,MAAM,mBAAmB,GACvB,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;QAE5D,IAAI,cAAc,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,0BAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC3C,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;YACzE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,sBAAsB,CAAC,cAAc,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAzBD,oBAyBC;AAvBC;IADC,IAAA,sBAAM,EAAC,KAAK,EAAE,GAAG,EAAE,+BAAe,CAAC,OAAO,CAAC;IACtC,WAAA,IAAA,uBAAO,GAAE,CAAA;;;;gCAsBd"}

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 {};

package/dist/server-config.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RANDOM_PORT = exports.DEFAULT_HOST = exports.DEFAULT_HTTP_PORT = void 0;
+exports.resolveServers = resolveServers;
+exports.DEFAULT_HTTP_PORT = 80;
+exports.DEFAULT_HOST = "localhost";
+exports.RANDOM_PORT = 0;
+const DEFAULT_SERVER_CONFIG = {
+    protocol: "http",
+    port: exports.DEFAULT_HTTP_PORT,
+};
+function resolveServers(config) {
+    if (config.servers && config.servers.length > 0) {
+        return config.servers;
+    }
+    return [DEFAULT_SERVER_CONFIG];
+}
+//# sourceMappingURL=server-config.js.map

package/dist/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":";;;AAsCA,wCAMC;AAfY,QAAA,iBAAiB,GAAG,EAAE,CAAC;AACvB,QAAA,YAAY,GAAG,WAAW,CAAC;AAC3B,QAAA,WAAW,GAAG,CAAC,CAAC;AAE7B,MAAM,qBAAqB,GAAe;IACxC,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,yBAAiB;CACxB,CAAC;AAEF,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,qBAAqB,CAAC,CAAC;AACjC,CAAC"}

package/dist/server-factory.d.ts

@@ -0,0 +1,3 @@
+import type * as net from "node:net";
+import type { ServerConfig } from "./server-config";
+export declare function createConfiguredServer(config: ServerConfig): net.Server;

package/dist/server-factory.js

@@ -0,0 +1,61 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfiguredServer = createConfiguredServer;
+const http = __importStar(require("node:http"));
+const https = __importStar(require("node:https"));
+const server_1 = require("./server");
+function attachServerListeners(server, protocol, socketProtocol) {
+    server.on("request", (req, res) => void (0, server_1.requestListener)(req, res, protocol));
+    server.on("upgrade", (req, socket, head) => void (0, server_1.upgradeListener)(req, socket, head, socketProtocol));
+}
+function createHTTPServer(config) {
+    const server = http.createServer(config);
+    attachServerListeners(server, "http", "ws");
+    return server;
+}
+function createHTTPSServer(config) {
+    const server = https.createServer(config);
+    attachServerListeners(server, "https", "wss");
+    return server;
+}
+const SERVER_FACTORY_BY_PROTOCOL = {
+    http: (config) => createHTTPServer(config),
+    https: (config) => createHTTPSServer(config),
+};
+function createConfiguredServer(config) {
+    return SERVER_FACTORY_BY_PROTOCOL[config.protocol](config);
+}
+//# sourceMappingURL=server-factory.js.map

package/dist/server-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-factory.js","sourceRoot":"","sources":["../src/server-factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,wDAEC;AAnDD,gDAAkC;AAClC,kDAAoC;AAGpC,qCAA4D;AAW5D,SAAS,qBAAqB,CAC5B,MAAkB,EAClB,QAAwB,EACxB,cAA8B;IAE9B,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,GAAwB,EAAE,EAAE,CACtD,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAC3C,CAAC;IACF,MAAM,CAAC,EAAE,CACP,SAAS,EACT,CAAC,GAAyB,EAAE,MAAqB,EAAE,IAAY,EAAE,EAAE,CACjE,KAAK,IAAA,wBAAe,EAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAkB;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,0BAA0B,GAA0C;IACxE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAoB,CAAC;IACxD,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAqB,CAAC;CAC5D,CAAC;AAEF,SAAgB,sBAAsB,CAAC,MAAoB;IACzD,OAAO,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,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": "1.0.0",
+  "version": "1.1.0",
   "description": "A flexible API module that implements the API interfaces of antelopejs with HTTP and WebSocket support",
   "keywords": [
     "antelopejs",
@@ -30,7 +30,7 @@
     "lint": "biome check .",
     "prepack": "pnpm run build",
     "release": "pnpm run lint && pnpm run test && pnpm run prepack && release-it",
-    "test": "ajs module test ."
+    "test": "pnpm run build && ajs module test ."
   },
   "antelopeJs": {
     "implements": [
@@ -49,21 +49,22 @@
     }
   },
   "dependencies": {
-    "@antelopejs/interface-api": "^0.0.2",
+    "@antelopejs/interface-api": "^0.0.4",
     "@antelopejs/interface-api-util": "^0.0.2",
-    "@antelopejs/interface-core": "^0.0.2",
+    "@antelopejs/interface-core": "^0.0.5",
     "reflect-metadata": "^0.2.2",
-    "ws": "^8.18.1"
+    "ws": "^8.20.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.2",
-    "@types/node": "^22.14.1",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.19.15",
     "@types/sinon": "^21.0.0",
     "@types/ws": "^8.18.1",
     "release-it": "^19.2.4",
     "release-it-changelogen": "^0.1.0",
-    "rimraf": "^6.0.1",
+    "rimraf": "^6.1.3",
     "sinon": "^21.0.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }