@athosjs/pro 0.1.4-alpha

package/observability.js

@@ -0,0 +1,188 @@
+import { ATHOS_STATE_KEYS } from '@athosjs/constants';
+import { ATHOS_LOGGER_TOKEN, ATHOS_TELEMETRY_SINK_TOKEN } from '@athosjs/observability';
+
+function attachProObservability(application, options = {}) {
+    if (options.enabled === false && !options.logger && !options.telemetrySink) {
+        return application;
+    }
+    const hooks = createProObservabilityHooks(application.kernel, options);
+    if (Object.keys(hooks).length === 0) {
+        return application;
+    }
+    application.hooks(hooks);
+    return application;
+}
+function createProObservabilityHooks(kernel, options = {}) {
+    const logger = resolveLogger(kernel, options);
+    const telemetrySink = resolveTelemetrySink(kernel, options);
+    if (!logger && !telemetrySink) {
+        return {};
+    }
+    const emitTelemetry = createBufferedTelemetryEmitter(telemetrySink, logger, options.maxPendingTelemetryEvents ?? 1024);
+    const logRequests = options.logRequests ?? "errors";
+    const sampleRate = normalizeSampleRate(options.sampleRate);
+    const alwaysSampleErrors = options.alwaysSampleErrors ?? true;
+    return {
+        onRequest (context) {
+            const hasLogger = logRequests === "all" && logger;
+            const willSample = sampleRate > 0 && telemetrySink;
+            if (!hasLogger && !willSample) return;
+            if (willSample && sampleRate < 1 && Math.random() > sampleRate) return;
+            const attributes = createBaseRequestAttributes(context);
+            if (willSample) {
+                emitTelemetry({
+                    name: "http.request.started",
+                    timestamp: Date.now(),
+                    attributes
+                });
+            }
+            if (hasLogger) {
+                logger.info(formatRequestLog("started", attributes));
+            }
+        },
+        onResponse (context, response) {
+            const hasLogger = logRequests === "all" && logger;
+            const willSample = sampleRate > 0 && telemetrySink;
+            if (!hasLogger && !willSample) return;
+            if (willSample && sampleRate < 1 && Math.random() > sampleRate) return;
+            const metrics = context.state.get(ATHOS_STATE_KEYS.HTTP_REQUEST_METRICS);
+            const attributes = {
+                requestId: context.request.requestId,
+                method: context.originalRequest.method,
+                path: context.originalRequest.path,
+                status: response.status
+            };
+            if (metrics) {
+                if (metrics.durationMs !== undefined) attributes.durationMs = metrics.durationMs;
+                if (metrics.bodyBytes !== undefined) attributes.bodyBytes = metrics.bodyBytes;
+                if (metrics.aborted !== undefined) attributes.aborted = metrics.aborted;
+            }
+            attributes.phase = context.execution.phase;
+            if (willSample) {
+                emitTelemetry({
+                    name: "http.request.completed",
+                    timestamp: Date.now(),
+                    attributes
+                });
+            }
+            if (hasLogger) {
+                logger.info(formatRequestLog("completed", attributes));
+            }
+        },
+        onError (context, error) {
+            const hasLogger = logRequests !== "none" && logger;
+            const willSample = sampleRate > 0 || alwaysSampleErrors;
+            if (!hasLogger && !willSample) return;
+            const havenError = error;
+            const attributes = {
+                requestId: context.request.requestId,
+                method: context.originalRequest.method,
+                path: context.originalRequest.path,
+                status: havenError?.status,
+                code: havenError?.code
+            };
+            if (willSample) {
+                const event = {
+                    name: "http.request.failed",
+                    timestamp: Date.now(),
+                    level: "error",
+                    attributes
+                };
+                if (shouldSampleEvent(event, sampleRate, alwaysSampleErrors)) {
+                    emitTelemetry(event);
+                }
+            }
+            if (hasLogger) {
+                logger.error(formatRequestLog("failed", attributes));
+            }
+        }
+    };
+}
+function normalizeSampleRate(value) {
+    if (value === undefined) {
+        return 1;
+    }
+    if (Number.isNaN(value) || value < 0) {
+        return 0;
+    }
+    if (value > 1) {
+        return 1;
+    }
+    return value;
+}
+function shouldSampleEvent(event, sampleRate, alwaysSampleErrors) {
+    if (alwaysSampleErrors && event.level === "error") {
+        return true;
+    }
+    if (sampleRate >= 1) {
+        return true;
+    }
+    if (sampleRate <= 0) {
+        return false;
+    }
+    return deterministicSample(event) < sampleRate;
+}
+function resolveLogger(kernel, options) {
+    if (options.logger) {
+        return options.logger;
+    }
+    if (kernel.services.has(ATHOS_LOGGER_TOKEN)) {
+        return kernel.services.resolve(ATHOS_LOGGER_TOKEN);
+    }
+    return undefined;
+}
+function resolveTelemetrySink(kernel, options) {
+    if (options.telemetrySink) {
+        return options.telemetrySink;
+    }
+    if (kernel.services.has(ATHOS_TELEMETRY_SINK_TOKEN)) {
+        return kernel.services.resolve(ATHOS_TELEMETRY_SINK_TOKEN);
+    }
+    return undefined;
+}
+function createBufferedTelemetryEmitter(sink, logger, maxPendingTelemetryEvents) {
+    if (!sink) {
+        return ()=>undefined;
+    }
+    return (event)=>{
+        if (sink.emitBatch) {
+            sink.emitBatch([
+                event
+            ]);
+        } else {
+            sink.emit(event);
+        }
+    };
+}
+function createBaseRequestAttributes(context) {
+    return {
+        requestId: context.request.requestId,
+        method: context.originalRequest.method,
+        path: context.originalRequest.path,
+        ...context.route?.operationId ? {
+            operationId: context.route.operationId
+        } : {},
+        phase: context.execution.phase
+    };
+}
+function formatRequestLog(stage, attributes) {
+    return `[${stage}] ${attributes.method} ${attributes.path} (${attributes.requestId})`;
+}
+function deterministicSample(event) {
+    const seed = [
+        event.name,
+        event.level ?? "info",
+        String(event.attributes?.requestId ?? ""),
+        String(event.attributes?.path ?? ""),
+        String(event.timestamp)
+    ].join("|");
+    let hash = 2166136261;
+    for(let index = 0; index < seed.length; index += 1){
+        hash ^= seed.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0) / 0xffffffff;
+}
+
+export { attachProObservability, createProObservabilityHooks };
+//# sourceMappingURL=observability.js.map

package/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sources":["../../../packages/pro/src/observability.ts"],"sourcesContent":["import { ATHOS_STATE_KEYS } from \"@athosjs/constants\";\nimport type { ApplicationKernel } from \"@athosjs/core\";\nimport type { HttpContext, HttpHooks, HttpRequestMetrics } from \"@athosjs/http\";\nimport type { HttpApplication } from \"@athosjs/http/experimental\";\nimport {\n\ttype ExecutionTelemetryEvent,\n\ttype ExecutionTelemetrySink,\n\tATHOS_LOGGER_TOKEN,\n\tATHOS_TELEMETRY_SINK_TOKEN,\n\ttype AthosLogger,\n} from \"@athosjs/observability\";\nimport type { ProObservabilityOptions } from \"@athosjs/types/pro\";\n\nexport type { ProObservabilityOptions };\n\nexport function attachProObservability(\n\tapplication: HttpApplication,\n\toptions: ProObservabilityOptions = {},\n): HttpApplication {\n\tif (options.enabled === false && !options.logger && !options.telemetrySink) {\n\t\treturn application;\n\t}\n\tconst hooks = createProObservabilityHooks(application.kernel, options);\n\tif (Object.keys(hooks).length === 0) {\n\t\treturn application;\n\t}\n\tapplication.hooks(hooks);\n\treturn application;\n}\n\nexport function createProObservabilityHooks(\n\tkernel: ApplicationKernel,\n\toptions: ProObservabilityOptions = {},\n): HttpHooks {\n\tconst logger = resolveLogger(kernel, options);\n\tconst telemetrySink = resolveTelemetrySink(kernel, options);\n\tif (!logger && !telemetrySink) {\n\t\treturn {};\n\t}\n\tconst emitTelemetry = createBufferedTelemetryEmitter(\n\t\ttelemetrySink,\n\t\tlogger,\n\t\toptions.maxPendingTelemetryEvents ?? 1024,\n\t);\n\tconst logRequests = options.logRequests ?? \"errors\";\n\tconst sampleRate = normalizeSampleRate(options.sampleRate);\n\tconst alwaysSampleErrors = options.alwaysSampleErrors ?? true;\n\n\treturn {\n\t\tonRequest(context: HttpContext): void {\n\t\t\tconst hasLogger = logRequests === \"all\" && logger;\n\t\t\tconst willSample = sampleRate > 0 && telemetrySink;\n\n\t\t\tif (!hasLogger && !willSample) return;\n\n\t\t\tif (willSample && sampleRate < 1 && Math.random() > sampleRate) return;\n\n\t\t\tconst attributes = createBaseRequestAttributes(context);\n\n\t\t\tif (willSample) {\n\t\t\t\temitTelemetry({\n\t\t\t\t\tname: \"http.request.started\",\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\tattributes,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (hasLogger) {\n\t\t\t\tlogger.info(formatRequestLog(\"started\", attributes));\n\t\t\t}\n\t\t},\n\t\tonResponse(context: HttpContext, response): void {\n\t\t\tconst hasLogger = logRequests === \"all\" && logger;\n\t\t\tconst willSample = sampleRate > 0 && telemetrySink;\n\n\t\t\tif (!hasLogger && !willSample) return;\n\n\t\t\tif (willSample && sampleRate < 1 && Math.random() > sampleRate) return;\n\n\t\t\tconst metrics = (context.state as { get<T>(k: string | symbol): T | undefined }).get<HttpRequestMetrics>(\n\t\t\t\tATHOS_STATE_KEYS.HTTP_REQUEST_METRICS,\n\t\t\t);\n\t\t\tconst attributes: Record<string, unknown> = {\n\t\t\t\trequestId: context.request.requestId,\n\t\t\t\tmethod: context.originalRequest.method,\n\t\t\t\tpath: context.originalRequest.path,\n\t\t\t\tstatus: response.status,\n\t\t\t};\n\t\t\tif (metrics) {\n\t\t\t\tif (metrics.durationMs !== undefined) attributes.durationMs = metrics.durationMs;\n\t\t\t\tif (metrics.bodyBytes !== undefined) attributes.bodyBytes = metrics.bodyBytes;\n\t\t\t\tif (metrics.aborted !== undefined) attributes.aborted = metrics.aborted;\n\t\t\t}\n\t\t\tattributes.phase = context.execution.phase;\n\n\t\t\tif (willSample) {\n\t\t\t\temitTelemetry({\n\t\t\t\t\tname: \"http.request.completed\",\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\tattributes,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (hasLogger) {\n\t\t\t\tlogger.info(formatRequestLog(\"completed\", attributes));\n\t\t\t}\n\t\t},\n\t\tonError(context: HttpContext, error: unknown): void {\n\t\t\tconst hasLogger = logRequests !== \"none\" && logger;\n\t\t\tconst willSample = sampleRate > 0 || alwaysSampleErrors;\n\n\t\t\tif (!hasLogger && !willSample) return;\n\n\t\t\tconst havenError = error as Record<string, unknown>;\n\t\t\tconst attributes = {\n\t\t\t\trequestId: context.request.requestId,\n\t\t\t\tmethod: context.originalRequest.method,\n\t\t\t\tpath: context.originalRequest.path,\n\t\t\t\tstatus: havenError?.status,\n\t\t\t\tcode: havenError?.code,\n\t\t\t};\n\n\t\t\tif (willSample) {\n\t\t\t\tconst event: ExecutionTelemetryEvent = {\n\t\t\t\t\tname: \"http.request.failed\",\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\tattributes,\n\t\t\t\t};\n\t\t\t\tif (shouldSampleEvent(event, sampleRate, alwaysSampleErrors)) {\n\t\t\t\t\temitTelemetry(event);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (hasLogger) {\n\t\t\t\tlogger.error(formatRequestLog(\"failed\", attributes));\n\t\t\t}\n\t\t},\n\t};\n}\n\nfunction normalizeSampleRate(value: number | undefined): number {\n\tif (value === undefined) {\n\t\treturn 1;\n\t}\n\n\tif (Number.isNaN(value) || value < 0) {\n\t\treturn 0;\n\t}\n\n\tif (value > 1) {\n\t\treturn 1;\n\t}\n\n\treturn value;\n}\n\nfunction shouldSampleEvent(event: ExecutionTelemetryEvent, sampleRate: number, alwaysSampleErrors: boolean): boolean {\n\tif (alwaysSampleErrors && event.level === \"error\") {\n\t\treturn true;\n\t}\n\n\tif (sampleRate >= 1) {\n\t\treturn true;\n\t}\n\n\tif (sampleRate <= 0) {\n\t\treturn false;\n\t}\n\n\treturn deterministicSample(event) < sampleRate;\n}\n\nfunction resolveLogger(kernel: ApplicationKernel, options: ProObservabilityOptions): AthosLogger | undefined {\n\tif (options.logger) {\n\t\treturn options.logger as AthosLogger;\n\t}\n\n\tif (kernel.services.has(ATHOS_LOGGER_TOKEN)) {\n\t\treturn kernel.services.resolve(ATHOS_LOGGER_TOKEN);\n\t}\n\n\treturn undefined;\n}\n\nfunction resolveTelemetrySink(\n\tkernel: ApplicationKernel,\n\toptions: ProObservabilityOptions,\n): ExecutionTelemetrySink | undefined {\n\tif (options.telemetrySink) {\n\t\treturn options.telemetrySink as ExecutionTelemetrySink;\n\t}\n\n\tif (kernel.services.has(ATHOS_TELEMETRY_SINK_TOKEN)) {\n\t\treturn kernel.services.resolve(ATHOS_TELEMETRY_SINK_TOKEN);\n\t}\n\n\treturn undefined;\n}\n\nfunction createBufferedTelemetryEmitter(\n\tsink: ExecutionTelemetrySink | undefined,\n\tlogger: AthosLogger | undefined,\n\tmaxPendingTelemetryEvents: number,\n): (event: ExecutionTelemetryEvent) => void {\n\tif (!sink) {\n\t\treturn () => undefined;\n\t}\n\n\treturn (event: ExecutionTelemetryEvent) => {\n\t\tif (sink.emitBatch) {\n\t\t\tsink.emitBatch([event]);\n\t\t} else {\n\t\t\tsink.emit(event);\n\t\t}\n\t};\n}\n\nasync function flushTelemetryQueue(\n\tsink: ExecutionTelemetrySink,\n\tevents: readonly ExecutionTelemetryEvent[],\n\tlogger?: AthosLogger,\n): Promise<void> {\n\ttry {\n\t\tif (sink.emitBatch) {\n\t\t\tawait sink.emitBatch(events);\n\t\t} else {\n\t\t\tfor (const event of events) {\n\t\t\t\tawait sink.emit(event);\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tlogger?.warn(\n\t\t\t\"Failed to flush telemetry batch.\",\n\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t`events: ${events.length}`,\n\t\t);\n\t}\n}\n\nfunction createBaseRequestAttributes(context: HttpContext): Record<string, unknown> {\n\treturn {\n\t\trequestId: context.request.requestId,\n\t\tmethod: context.originalRequest.method,\n\t\tpath: context.originalRequest.path,\n\t\t...(context.route?.operationId ? { operationId: context.route.operationId } : {}),\n\t\tphase: context.execution.phase,\n\t};\n}\n\nfunction formatRequestLog(stage: string, attributes: Record<string, unknown>): string {\n\treturn `[${stage}] ${attributes.method} ${attributes.path} (${attributes.requestId})`;\n}\n\nfunction deterministicSample(event: ExecutionTelemetryEvent): number {\n\tconst seed = [\n\t\tevent.name,\n\t\tevent.level ?? \"info\",\n\t\tString(event.attributes?.requestId ?? \"\"),\n\t\tString(event.attributes?.path ?? \"\"),\n\t\tString(event.timestamp),\n\t].join(\"|\");\n\tlet hash = 2166136261;\n\n\tfor (let index = 0; index < seed.length; index += 1) {\n\t\thash ^= seed.charCodeAt(index);\n\t\thash = Math.imul(hash, 16777619);\n\t}\n\n\treturn (hash >>> 0) / 0xffffffff;\n}\n"],"names":["attachProObservability","application","options","enabled","logger","telemetrySink","hooks","createProObservabilityHooks","kernel","Object","keys","length","resolveLogger","resolveTelemetrySink","emitTelemetry","createBufferedTelemetryEmitter","maxPendingTelemetryEvents","logRequests","sampleRate","normalizeSampleRate","alwaysSampleErrors","onRequest","context","hasLogger","willSample","Math","random","attributes","createBaseRequestAttributes","name","timestamp","Date","now","info","formatRequestLog","onResponse","response","metrics","state","get","ATHOS_STATE_KEYS","HTTP_REQUEST_METRICS","requestId","request","method","originalRequest","path","status","durationMs","undefined","bodyBytes","aborted","phase","execution","onError","error","havenError","code","event","level","shouldSampleEvent","value","Number","isNaN","deterministicSample","services","has","ATHOS_LOGGER_TOKEN","resolve","ATHOS_TELEMETRY_SINK_TOKEN","sink","emitBatch","emit","route","operationId","stage","seed","String","join","hash","index","charCodeAt","imul"],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@athosjs/pro",
+  "version": "0.1.4-alpha",
+  "private": false,
+  "type": "module",
+  "description": "Opinionated pro product assembly for Athos",
+  "homepage": "https://athosjs-3695tqux2-neversonsilvas-projects.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neverson-silva/athosjs.git"
+  },
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.js",
+      "default": "./index.js"
+    },
+    "./experimental": {
+      "types": "./experimental.d.ts",
+      "import": "./experimental.js",
+      "require": "./experimental.js",
+      "default": "./experimental.js"
+    }
+  },
+  "dependencies": {
+    "@athosjs/openapi": "0.1.4-alpha",
+    "@athosjs/http": "0.1.4-alpha",
+    "@athosjs/i18n": "0.1.4-alpha",
+    "@athosjs/core": "0.1.4-alpha",
+    "@athosjs/metadata": "0.1.4-alpha",
+    "@athosjs/runtime": "0.1.4-alpha",
+    "@athosjs/config": "0.1.4-alpha",
+    "@athosjs/observability": "0.1.4-alpha",
+    "@athosjs/constants": "0.1.4-alpha",
+    "@athosjs/di": "0.1.4-alpha",
+    "@athosjs/module": "0.1.4-alpha"
+  }
+}

package/policies.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var metadata = require('@athosjs/metadata');
+
+const USE_POLICY_METADATA_KEY = Symbol("athos:pro:usePolicy");
+/**
+ * Attaches a policy class to a route handler.
+ *
+ * The policy is resolved from the DI container and its `check()` method
+ * is called before the route handler runs.
+ *
+ * @example
+ * ```ts
+ * @Controller()
+ * export class AdminController {
+ *   @UsePolicy(AuthPolicy)
+ *   @Get("/admin")
+ *   getAdmin() { ... }
+ * }
+ * ```
+ */ function UsePolicy(policyClass) {
+    return (target, propertyKey, descriptor)=>{
+        metadata.defineMetadata(target.constructor, USE_POLICY_METADATA_KEY, policyClass, propertyKey);
+        return descriptor;
+    };
+}
+
+exports.USE_POLICY_METADATA_KEY = USE_POLICY_METADATA_KEY;
+exports.UsePolicy = UsePolicy;
+//# sourceMappingURL=policies.cjs.map

package/policies.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.cjs","sources":["../../../packages/pro/src/policies.ts"],"sourcesContent":["import { defineMetadata } from \"@athosjs/metadata\";\n\nexport const USE_POLICY_METADATA_KEY = Symbol(\"athos:pro:usePolicy\");\n\n/**\n * Attaches a policy class to a route handler.\n *\n * The policy is resolved from the DI container and its `check()` method\n * is called before the route handler runs.\n *\n * @example\n * ```ts\n * @Controller()\n * export class AdminController {\n *   @UsePolicy(AuthPolicy)\n *   @Get(\"/admin\")\n *   getAdmin() { ... }\n * }\n * ```\n */\nexport function UsePolicy(\n\tpolicyClass: new (...args: never[]) => { check(context: unknown): boolean | Promise<boolean> },\n): MethodDecorator {\n\treturn (target, propertyKey, descriptor) => {\n\t\tdefineMetadata(target.constructor, USE_POLICY_METADATA_KEY, policyClass, propertyKey);\n\t\treturn descriptor;\n\t};\n}\n"],"names":["USE_POLICY_METADATA_KEY","Symbol","UsePolicy","policyClass","target","propertyKey","descriptor","defineMetadata"],"mappings":";;;;AAEO,MAAMA,uBAAAA,GAA0BC,MAAAA,CAAO,qBAAA;AAE9C;;;;;;;;;;;;;;;IAgBO,SAASC,SAAAA,CACfC,WAA8F,EAAA;IAE9F,OAAO,CAACC,QAAQC,WAAAA,EAAaC,UAAAA,GAAAA;AAC5BC,QAAAA,uBAAAA,CAAeH,MAAAA,CAAO,WAAW,EAAEJ,uBAAAA,EAAyBG,WAAAA,EAAaE,WAAAA,CAAAA;QACzE,OAAOC,UAAAA;AACR,IAAA,CAAA;AACD;;;;;"}

package/policies.d.ts

@@ -0,0 +1,21 @@
+export declare const USE_POLICY_METADATA_KEY: unique symbol;
+/**
+ * Attaches a policy class to a route handler.
+ *
+ * The policy is resolved from the DI container and its `check()` method
+ * is called before the route handler runs.
+ *
+ * @example
+ * ```ts
+ * @Controller()
+ * export class AdminController {
+ *   @UsePolicy(AuthPolicy)
+ *   @Get("/admin")
+ *   getAdmin() { ... }
+ * }
+ * ```
+ */
+export declare function UsePolicy(policyClass: new (...args: never[]) => {
+    check(context: unknown): boolean | Promise<boolean>;
+}): MethodDecorator;
+//# sourceMappingURL=policies.d.ts.map

package/policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../../../../../packages/pro/src/policies.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,eAAgC,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CACxB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK;IAAE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GAC5F,eAAe,CAKjB"}

package/policies.js

@@ -0,0 +1,27 @@
+import { defineMetadata } from '@athosjs/metadata';
+
+const USE_POLICY_METADATA_KEY = Symbol("athos:pro:usePolicy");
+/**
+ * Attaches a policy class to a route handler.
+ *
+ * The policy is resolved from the DI container and its `check()` method
+ * is called before the route handler runs.
+ *
+ * @example
+ * ```ts
+ * @Controller()
+ * export class AdminController {
+ *   @UsePolicy(AuthPolicy)
+ *   @Get("/admin")
+ *   getAdmin() { ... }
+ * }
+ * ```
+ */ function UsePolicy(policyClass) {
+    return (target, propertyKey, descriptor)=>{
+        defineMetadata(target.constructor, USE_POLICY_METADATA_KEY, policyClass, propertyKey);
+        return descriptor;
+    };
+}
+
+export { USE_POLICY_METADATA_KEY, UsePolicy };
+//# sourceMappingURL=policies.js.map

package/policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.js","sources":["../../../packages/pro/src/policies.ts"],"sourcesContent":["import { defineMetadata } from \"@athosjs/metadata\";\n\nexport const USE_POLICY_METADATA_KEY = Symbol(\"athos:pro:usePolicy\");\n\n/**\n * Attaches a policy class to a route handler.\n *\n * The policy is resolved from the DI container and its `check()` method\n * is called before the route handler runs.\n *\n * @example\n * ```ts\n * @Controller()\n * export class AdminController {\n *   @UsePolicy(AuthPolicy)\n *   @Get(\"/admin\")\n *   getAdmin() { ... }\n * }\n * ```\n */\nexport function UsePolicy(\n\tpolicyClass: new (...args: never[]) => { check(context: unknown): boolean | Promise<boolean> },\n): MethodDecorator {\n\treturn (target, propertyKey, descriptor) => {\n\t\tdefineMetadata(target.constructor, USE_POLICY_METADATA_KEY, policyClass, propertyKey);\n\t\treturn descriptor;\n\t};\n}\n"],"names":["USE_POLICY_METADATA_KEY","Symbol","UsePolicy","policyClass","target","propertyKey","descriptor","defineMetadata"],"mappings":";;AAEO,MAAMA,uBAAAA,GAA0BC,MAAAA,CAAO,qBAAA;AAE9C;;;;;;;;;;;;;;;IAgBO,SAASC,SAAAA,CACfC,WAA8F,EAAA;IAE9F,OAAO,CAACC,QAAQC,WAAAA,EAAaC,UAAAA,GAAAA;AAC5BC,QAAAA,cAAAA,CAAeH,MAAAA,CAAO,WAAW,EAAEJ,uBAAAA,EAAyBG,WAAAA,EAAaE,WAAAA,CAAAA;QACzE,OAAOC,UAAAA;AACR,IAAA,CAAA;AACD;;;;"}

package/resilience.cjs

@@ -0,0 +1,280 @@
+'use strict';
+
+var constants = require('@athosjs/constants');
+var core = require('@athosjs/core');
+
+function createConcurrencyLimiter(options) {
+    if (options.maxConcurrency < 1) {
+        throw core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_OVERLOADED, "Concurrency limiter requires maxConcurrency to be greater than zero.");
+    }
+    const queue = [];
+    let queueOffset = 0;
+    let activeCount = 0;
+    let pendingCount = 0;
+    const pump = ()=>{
+        while(activeCount < options.maxConcurrency && pendingCount > 0){
+            const next = queue[queueOffset];
+            queue[queueOffset] = undefined;
+            queueOffset++;
+            if (!next) {
+                continue;
+            }
+            pendingCount -= 1;
+            if (queueOffset > 1000) {
+                queue.splice(0, queueOffset);
+                queueOffset = 0;
+            }
+            runEntry(next);
+        }
+    };
+    const runEntry = (entry)=>{
+        if (entry.signal && entry.abortHandler) {
+            entry.signal.removeEventListener("abort", entry.abortHandler);
+            entry.abortHandler = undefined;
+        }
+        if (entry.signal?.aborted) {
+            entry.reject(createOverloadedAbortError("Queued operation was aborted before execution."));
+            pump();
+            return;
+        }
+        activeCount += 1;
+        const result = entry.operation(entry.signal);
+        if (result instanceof Promise) {
+            result.then(entry.resolve, entry.reject).finally(()=>{
+                activeCount -= 1;
+                pump();
+            });
+        } else {
+            try {
+                entry.resolve(result);
+            } catch (e) {
+                entry.reject(e);
+            } finally{
+                activeCount -= 1;
+                pump();
+            }
+        }
+    };
+    return {
+        get activeCount () {
+            return activeCount;
+        },
+        get pendingCount () {
+            return pendingCount;
+        },
+        run (operation, runOptions = {}) {
+            if (runOptions.signal?.aborted) {
+                return Promise.reject(createOverloadedAbortError("Operation was aborted before entering the limiter."));
+            }
+            if (activeCount < options.maxConcurrency) {
+                return new Promise((resolve, reject)=>{
+                    runEntry({
+                        operation,
+                        signal: runOptions.signal,
+                        resolve,
+                        reject
+                    });
+                });
+            }
+            const maxQueueSize = options.maxQueueSize ?? Number.POSITIVE_INFINITY;
+            if (pendingCount >= maxQueueSize) {
+                return Promise.reject(core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_OVERLOADED, "Concurrency limiter queue is full.", {
+                    details: {
+                        activeCount,
+                        pendingCount,
+                        maxConcurrency: options.maxConcurrency,
+                        maxQueueSize
+                    }
+                }));
+            }
+            return new Promise((resolve, reject)=>{
+                const entry = {
+                    operation,
+                    signal: runOptions.signal,
+                    resolve,
+                    reject
+                };
+                if (runOptions.signal) {
+                    const onAbort = ()=>{
+                        const idx = queue.indexOf(entry, queueOffset);
+                        if (idx !== -1) {
+                            queue[idx] = undefined;
+                            pendingCount -= 1;
+                            runOptions.signal?.removeEventListener("abort", onAbort);
+                            entry.abortHandler = undefined;
+                            reject(createOverloadedAbortError("Queued operation was aborted."));
+                        }
+                    };
+                    entry.abortHandler = onAbort;
+                    runOptions.signal.addEventListener("abort", onAbort, {
+                        once: true
+                    });
+                }
+                queue.push(entry);
+                pendingCount += 1;
+            });
+        }
+    };
+}
+function createCircuitBreaker(options) {
+    if (options.failureThreshold < 1) {
+        throw core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_CIRCUIT_OPEN, "Circuit breaker requires failureThreshold to be greater than zero.");
+    }
+    let state = "closed";
+    let failureCount = 0;
+    let openedAt;
+    let halfOpenAttempts = 0;
+    const moveToOpen = ()=>{
+        state = "open";
+        openedAt = Date.now();
+        halfOpenAttempts = 0;
+    };
+    const moveToClosed = ()=>{
+        state = "closed";
+        failureCount = 0;
+        openedAt = undefined;
+        halfOpenAttempts = 0;
+    };
+    const moveToHalfOpenIfReady = ()=>{
+        if (state === "open" && openedAt !== undefined && Date.now() - openedAt >= options.resetAfterMs) {
+            state = "half-open";
+            halfOpenAttempts = 0;
+        }
+    };
+    return {
+        get state () {
+            moveToHalfOpenIfReady();
+            return state;
+        },
+        get failureCount () {
+            return failureCount;
+        },
+        get openedAt () {
+            return openedAt;
+        },
+        async execute (operation, runOptions = {}) {
+            moveToHalfOpenIfReady();
+            if (state === "open") {
+                throw core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_CIRCUIT_OPEN, "Circuit breaker is open.", {
+                    details: {
+                        openedAt,
+                        resetAfterMs: options.resetAfterMs
+                    }
+                });
+            }
+            if (state === "half-open") {
+                const allowedAttempts = options.halfOpenMaxAttempts ?? 1;
+                if (halfOpenAttempts >= allowedAttempts) {
+                    throw core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_CIRCUIT_OPEN, "Circuit breaker half-open probe limit reached.", {
+                        details: {
+                            openedAt,
+                            allowedAttempts
+                        }
+                    });
+                }
+                halfOpenAttempts += 1;
+            }
+            try {
+                const result = await operation(runOptions.signal);
+                moveToClosed();
+                return result;
+            } catch (error) {
+                failureCount += 1;
+                if (state === "half-open" || failureCount >= options.failureThreshold) {
+                    moveToOpen();
+                }
+                throw error;
+            }
+        }
+    };
+}
+function createResilientExecutor(options = {}) {
+    return {
+        async execute (operation, runOptions = {}) {
+            const attempt = (signal)=>{
+                const result = options.timeoutMs ? withTimeout((timeoutSignal)=>operation(timeoutSignal), options.timeoutMs, signal) : operation(signal);
+                return result instanceof Promise ? result : Promise.resolve(result);
+            };
+            const executeWithBreaker = (signal)=>{
+                if (options.circuitBreaker) {
+                    return options.circuitBreaker.execute((breakerSignal)=>attempt(breakerSignal), {
+                        ...signal === undefined ? {} : {
+                            signal
+                        }
+                    });
+                }
+                return attempt(signal);
+            };
+            if (options.limiter) {
+                return options.limiter.run((limiterSignal)=>executeWithBreaker(limiterSignal), runOptions);
+            }
+            return executeWithBreaker(runOptions.signal);
+        }
+    };
+}
+function withTimeout(operation, timeoutMs, upstreamSignal) {
+    if (timeoutMs <= 0) {
+        return Promise.reject(core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_TIMEOUT, "Operation timeout must be greater than zero."));
+    }
+    if (upstreamSignal?.aborted) {
+        return Promise.reject(upstreamSignal.reason || new Error("Aborted"));
+    }
+    const controller = new AbortController();
+    const detach = upstreamSignal ? forwardAbort(upstreamSignal, controller) : undefined;
+    return new Promise((resolve, reject)=>{
+        let settled = false;
+        const timeout = setTimeout(()=>{
+            if (settled) return;
+            settled = true;
+            controller.abort();
+            reject(core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_TIMEOUT, "Operation timed out.", {
+                details: {
+                    timeoutMs
+                }
+            }));
+        }, timeoutMs);
+        const cleanup = (err)=>{
+            if (settled) return;
+            settled = true;
+            clearTimeout(timeout);
+            if (detach) detach();
+            if (err) reject(err);
+        };
+        try {
+            const res = operation(controller.signal);
+            if (res instanceof Promise) {
+                res.then((val)=>{
+                    cleanup();
+                    resolve(val);
+                }, cleanup);
+            } else {
+                cleanup();
+                resolve(res);
+            }
+        } catch (e) {
+            cleanup(e);
+        }
+    });
+}
+function forwardAbort(signal, controller) {
+    if (!signal) {
+        return ()=>undefined;
+    }
+    if (signal.aborted) {
+        controller.abort();
+        return ()=>undefined;
+    }
+    const onAbort = ()=>controller.abort();
+    signal.addEventListener("abort", onAbort, {
+        once: true
+    });
+    return ()=>signal.removeEventListener("abort", onAbort);
+}
+function createOverloadedAbortError(message) {
+    return core.createAthosError(constants.ATHOS_ERROR_CODES.OPERATION_OVERLOADED, message);
+}
+
+exports.createCircuitBreaker = createCircuitBreaker;
+exports.createConcurrencyLimiter = createConcurrencyLimiter;
+exports.createResilientExecutor = createResilientExecutor;
+//# sourceMappingURL=resilience.cjs.map