@acorex-platform/framework-server 0.0.10 → 0.0.14

package/observability/abstract/src/lib/runtime-log-buffer.d.ts

@@ -0,0 +1,66 @@
+/** OpenTelemetry LogRecord severity number (TRACE=1 … FATAL=21). */
+export type OtelSeverityNumber = 1 | 5 | 9 | 13 | 17 | 21;
+export interface RuntimeLogRecord {
+    id: string;
+    /** Event time (OTel Timestamp). */
+    timestamp: string;
+    /** Severity text / log level (OTel SeverityText). */
+    level: string;
+    /** OTel SeverityNumber for consistent filtering/sorting. */
+    severityNumber?: OtelSeverityNumber;
+    /** Log body (OTel Body). */
+    message: string;
+    serviceName?: string;
+    requestId?: string;
+    traceId?: string;
+    spanId?: string;
+    userId?: string;
+    tenantId?: string;
+    applicationId?: string;
+    module?: string;
+    entity?: string;
+    operation?: string;
+    method?: string;
+    url?: string;
+    statusCode?: number;
+    duration?: number;
+    source?: string;
+    /** Additional attributes (OTel Attributes + resource extras). */
+    properties?: Record<string, unknown>;
+}
+export interface RuntimeLogSearchQuery {
+    skip?: number;
+    take?: number;
+    levels?: string[];
+    serviceName?: string;
+    requestId?: string;
+    traceId?: string;
+    spanId?: string;
+    module?: string;
+    entity?: string;
+    operation?: string;
+    quickSearch?: string;
+    tenantId?: string;
+    applicationId?: string;
+    userId?: string;
+    hasHttpAccess?: boolean;
+    minDuration?: number;
+}
+export declare function mapPinoRecordToRuntimeLog(raw: Record<string, unknown>): RuntimeLogRecord;
+export declare function appendRuntimeLog(raw: Record<string, unknown>): RuntimeLogRecord;
+export declare function onRuntimeLogAppended(listener: (record: RuntimeLogRecord) => void): () => void;
+export declare function clearRuntimeLogs(query?: RuntimeLogSearchQuery): number;
+export declare function searchRuntimeLogs(query?: RuntimeLogSearchQuery): {
+    items: RuntimeLogRecord[];
+    total: number;
+};
+export declare function purgeRuntimeLogsBefore(beforeTimestamp: string): number;
+export declare function getRuntimeLogById(id: string): RuntimeLogRecord | null;
+export declare function aggregateRuntimeLogs(query: RuntimeLogSearchQuery, groupBy: string): {
+    buckets: Array<{
+        key: string;
+        count: number;
+    }>;
+    total: number;
+};
+//# sourceMappingURL=runtime-log-buffer.d.ts.map

package/observability/abstract/src/lib/runtime-log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-log-buffer.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/observability/abstract/src/lib/runtime-log-buffer.ts"],"names":[],"mappings":"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"}

package/observability/abstract/src/lib/runtime-log-buffer.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapPinoRecordToRuntimeLog = mapPinoRecordToRuntimeLog;
+exports.appendRuntimeLog = appendRuntimeLog;
+exports.onRuntimeLogAppended = onRuntimeLogAppended;
+exports.clearRuntimeLogs = clearRuntimeLogs;
+exports.searchRuntimeLogs = searchRuntimeLogs;
+exports.purgeRuntimeLogsBefore = purgeRuntimeLogsBefore;
+exports.getRuntimeLogById = getRuntimeLogById;
+exports.aggregateRuntimeLogs = aggregateRuntimeLogs;
+const node_crypto_1 = require("node:crypto");
+const MAX_ENTRIES = 10_000;
+const buffer = [];
+const listeners = new Set();
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+const PINO_LEVEL_LABELS = {
+    10: 'trace',
+    20: 'debug',
+    30: 'info',
+    40: 'warn',
+    50: 'error',
+    60: 'fatal',
+};
+/** Map severity text → OpenTelemetry SeverityNumber. */
+const SEVERITY_NUMBER_BY_LEVEL = {
+    trace: 1,
+    debug: 5,
+    info: 9,
+    warn: 13,
+    warning: 13,
+    error: 17,
+    fatal: 21,
+    critical: 21,
+};
+function readLogLevel(value) {
+    const asString = readString(value);
+    if (asString) {
+        return asString.toLowerCase();
+    }
+    const asNumber = readNumber(value);
+    if (asNumber != null) {
+        return PINO_LEVEL_LABELS[asNumber] ?? String(asNumber);
+    }
+    return 'info';
+}
+function toSeverityNumber(level) {
+    return SEVERITY_NUMBER_BY_LEVEL[level.toLowerCase()] ?? 9;
+}
+function mapPinoRecordToRuntimeLog(raw) {
+    const time = readNumber(raw['time']);
+    const timestamp = time != null ? new Date(time).toISOString() : new Date().toISOString();
+    const requestId = readString(raw['requestId']) ?? readString(raw['reqId']);
+    const traceId = readString(raw['traceId']);
+    const spanId = readString(raw['spanId']);
+    const id = readString(raw['id']) ??
+        (requestId && traceId ? `${requestId}:${traceId}` : undefined) ??
+        `${timestamp}:${(0, node_crypto_1.randomUUID)()}`;
+    const level = readLogLevel(raw['level']);
+    const explicitSeverity = readNumber(raw['severityNumber']);
+    return {
+        id,
+        timestamp,
+        level,
+        severityNumber: explicitSeverity != null && Number.isFinite(explicitSeverity)
+            ? explicitSeverity
+            : toSeverityNumber(level),
+        message: readString(raw['msg']) ?? readString(raw['message']) ?? '',
+        serviceName: readString(raw['serviceName']) ??
+            readString(process.env['OTEL_SERVICE_NAME']) ??
+            'demo-api',
+        requestId,
+        traceId,
+        spanId,
+        userId: readString(raw['userId']),
+        tenantId: readString(raw['tenantId']),
+        applicationId: readString(raw['applicationId']),
+        module: readString(raw['module']),
+        entity: readString(raw['entity']),
+        operation: readString(raw['operation']),
+        method: readString(raw['method']),
+        url: readString(raw['url']),
+        statusCode: readNumber(raw['statusCode']),
+        duration: readNumber(raw['duration']) ?? readNumber(raw['responseTime']),
+        source: 'runtime',
+        properties: raw,
+    };
+}
+function appendRuntimeLog(raw) {
+    const record = mapPinoRecordToRuntimeLog(raw);
+    buffer.unshift(record);
+    if (buffer.length > MAX_ENTRIES) {
+        buffer.length = MAX_ENTRIES;
+    }
+    for (const listener of listeners) {
+        listener(record);
+    }
+    return record;
+}
+function onRuntimeLogAppended(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+function matchesScope(record, query) {
+    if (query.tenantId && record.tenantId && record.tenantId !== query.tenantId)
+        return false;
+    if (query.applicationId && record.applicationId && record.applicationId !== query.applicationId)
+        return false;
+    if (query.userId && record.userId && record.userId !== query.userId)
+        return false;
+    return true;
+}
+function matchesRuntimeLogQuery(record, query) {
+    if (!matchesScope(record, query)) {
+        return false;
+    }
+    if (query.hasHttpAccess) {
+        if (record.method == null || record.url == null) {
+            return false;
+        }
+    }
+    if (query.levels?.length && !query.levels.includes(record.level)) {
+        return false;
+    }
+    if (query.serviceName && record.serviceName !== query.serviceName) {
+        return false;
+    }
+    if (query.requestId && record.requestId !== query.requestId) {
+        return false;
+    }
+    if (query.traceId && record.traceId !== query.traceId) {
+        return false;
+    }
+    if (query.spanId && record.spanId !== query.spanId) {
+        return false;
+    }
+    if (query.module && record.module !== query.module) {
+        return false;
+    }
+    if (query.entity && record.entity !== query.entity) {
+        return false;
+    }
+    if (query.operation && record.operation !== query.operation) {
+        return false;
+    }
+    if (query.minDuration != null && (record.duration ?? 0) < query.minDuration) {
+        return false;
+    }
+    if (query.quickSearch) {
+        const term = query.quickSearch.toLowerCase();
+        const matchesText = record.message.toLowerCase().includes(term) ||
+            (record.url?.toLowerCase().includes(term) ?? false) ||
+            (record.method?.toLowerCase().includes(term) ?? false);
+        if (!matchesText) {
+            return false;
+        }
+    }
+    return true;
+}
+function clearRuntimeLogs(query = {}) {
+    const remaining = buffer.filter((record) => !matchesRuntimeLogQuery(record, query));
+    const deleted = buffer.length - remaining.length;
+    buffer.length = 0;
+    buffer.push(...remaining);
+    return deleted;
+}
+function searchRuntimeLogs(query = {}) {
+    let items = buffer.filter((record) => matchesRuntimeLogQuery(record, query));
+    const skip = query.skip ?? 0;
+    const take = query.take ?? 20;
+    return { items: items.slice(skip, skip + take), total: items.length };
+}
+function purgeRuntimeLogsBefore(beforeTimestamp) {
+    const cutoff = Date.parse(beforeTimestamp);
+    if (!Number.isFinite(cutoff)) {
+        return 0;
+    }
+    const remaining = buffer.filter((record) => Date.parse(record.timestamp) >= cutoff);
+    const deleted = buffer.length - remaining.length;
+    buffer.length = 0;
+    buffer.push(...remaining);
+    return deleted;
+}
+function getRuntimeLogById(id) {
+    return buffer.find((record) => record.id === id) ?? null;
+}
+function aggregateRuntimeLogs(query, groupBy) {
+    const { items: allItems, total } = searchRuntimeLogs({ ...query, skip: 0, take: MAX_ENTRIES });
+    const counts = new Map();
+    for (const record of allItems) {
+        const key = String(record[groupBy] ?? 'unknown');
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    return {
+        buckets: [...counts.entries()].map(([key, count]) => ({ key, count })),
+        total,
+    };
+}
+//#endregion
+//# sourceMappingURL=runtime-log-buffer.js.map

package/observability/abstract/src/lib/runtime-log-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-log-buffer.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/observability/abstract/src/lib/runtime-log-buffer.ts"],"names":[],"mappings":"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"}

package/observability/abstract/src/lib/tracer/axp-tracer.interface.d.ts

@@ -0,0 +1,17 @@
+export type AxpSpanStatus = 'ok' | 'error';
+export interface AxpSpan {
+    setAttribute(key: string, value: string | number | boolean): void;
+    recordError(error: unknown): void;
+    setStatus(status: AxpSpanStatus): void;
+    end(): void;
+}
+export interface AxpActiveTraceContext {
+    traceId: string;
+    spanId: string;
+}
+export interface AxpTracer {
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): AxpSpan;
+    withSpan<T>(name: string, fn: (span: AxpSpan) => T | Promise<T>, attributes?: Record<string, string | number | boolean>): Promise<T>;
+    getActiveContext(): AxpActiveTraceContext | undefined;
+}
+//# sourceMappingURL=axp-tracer.interface.d.ts.map

package/observability/abstract/src/lib/tracer/axp-tracer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axp-tracer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/abstract/src/lib/tracer/axp-tracer.interface.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;IACzF,QAAQ,CAAC,CAAC,EACR,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,gBAAgB,IAAI,qBAAqB,GAAG,SAAS,CAAC;CACvD"}

package/observability/abstract/src/lib/tracer/axp-tracer.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- Tracer abstraction ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=axp-tracer.interface.js.map

package/observability/abstract/src/lib/tracer/axp-tracer.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axp-tracer.interface.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/abstract/src/lib/tracer/axp-tracer.interface.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AA0BtC,YAAY"}

package/observability/providers/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from './lib/config/observability-config.resolve';
+export * from './lib/context/correlation-fields.util';
+export * from './lib/http/http-exception-log.util';
+export * from './lib/http/register-express-observability.middleware';
+export * from './lib/observability.bootstrap';
+export * from './lib/observability.module';
+export * from './lib/observability.service';
+//# sourceMappingURL=index.d.ts.map

package/observability/providers/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/observability/providers/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sDAAsD,CAAC;AACrE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/observability/providers/src/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/config/observability-config.resolve"), exports);
+tslib_1.__exportStar(require("./lib/context/correlation-fields.util"), exports);
+tslib_1.__exportStar(require("./lib/http/http-exception-log.util"), exports);
+tslib_1.__exportStar(require("./lib/http/register-express-observability.middleware"), exports);
+tslib_1.__exportStar(require("./lib/observability.bootstrap"), exports);
+tslib_1.__exportStar(require("./lib/observability.module"), exports);
+tslib_1.__exportStar(require("./lib/observability.service"), exports);
+//# sourceMappingURL=index.js.map

package/observability/providers/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/observability/providers/src/index.ts"],"names":[],"mappings":";;;AAAA,oFAA0D;AAC1D,gFAAsD;AACtD,6EAAmD;AACnD,+FAAqE;AACrE,wEAA8C;AAC9C,qEAA2C;AAC3C,sEAA4C"}

package/observability/providers/src/init.d.ts

@@ -0,0 +1,2 @@
+export { initObservability } from './lib/observability.bootstrap';
+//# sourceMappingURL=init.d.ts.map

package/observability/providers/src/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/observability/providers/src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/observability/providers/src/init.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initObservability = void 0;
+var observability_bootstrap_1 = require("./lib/observability.bootstrap");
+Object.defineProperty(exports, "initObservability", { enumerable: true, get: function () { return observability_bootstrap_1.initObservability; } });
+//# sourceMappingURL=init.js.map

package/observability/providers/src/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/observability/providers/src/init.ts"],"names":[],"mappings":";;;AAAA,yEAAkE;AAAzD,4HAAA,iBAAiB,OAAA"}

package/observability/providers/src/lib/config/observability-config.resolve.d.ts

@@ -0,0 +1,4 @@
+import type { AxpObservabilityConfig } from '@acorex-platform/framework-server/observability/abstract';
+export declare function resolveObservabilityConfigFromEnv(env?: NodeJS.ProcessEnv): AxpObservabilityConfig;
+export declare function mergeObservabilityConfig(base: AxpObservabilityConfig, overrides?: Partial<AxpObservabilityConfig>): AxpObservabilityConfig;
+//# sourceMappingURL=observability-config.resolve.d.ts.map

package/observability/providers/src/lib/config/observability-config.resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.resolve.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/config/observability-config.resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AA0BvG,wBAAgB,iCAAiC,CAC/C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAcxB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,sBAAsB,CAKxB"}

package/observability/providers/src/lib/config/observability-config.resolve.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveObservabilityConfigFromEnv = resolveObservabilityConfigFromEnv;
+exports.mergeObservabilityConfig = mergeObservabilityConfig;
+//#region ---- Environment parsing helpers ----
+function parseBooleanEnv(value, defaultValue) {
+    if (value === undefined || value.trim() === '') {
+        return defaultValue;
+    }
+    const normalized = value.trim().toLowerCase();
+    return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+}
+function parseNumberEnv(value, defaultValue) {
+    if (value === undefined || value.trim() === '') {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+//#endregion
+//#region ---- Observability config resolution ----
+function resolveObservabilityConfigFromEnv(env = process.env) {
+    const nodeEnv = env['NODE_ENV'] ?? 'development';
+    const isProduction = nodeEnv === 'production';
+    return {
+        enabled: parseBooleanEnv(env['OBSERVABILITY_ENABLED'], true),
+        logLevel: env['LOG_LEVEL'] ?? (isProduction ? 'info' : 'debug'),
+        logPretty: parseBooleanEnv(env['LOG_PRETTY'], !isProduction),
+        serviceName: env['OTEL_SERVICE_NAME'] ?? 'demo-api',
+        otlpEndpoint: (env['OTEL_EXPORTER_OTLP_ENDPOINT'] ?? 'http://localhost:4318').replace(/\/$/, ''),
+        tracesEnabled: parseBooleanEnv(env['OTEL_TRACES_ENABLED'], true),
+        metricsEnabled: parseBooleanEnv(env['OTEL_METRICS_ENABLED'], true),
+        tracesSamplerRatio: parseNumberEnv(env['OTEL_TRACES_SAMPLER_RATIO'], 1),
+    };
+}
+function mergeObservabilityConfig(base, overrides = {}) {
+    return {
+        ...base,
+        ...overrides,
+    };
+}
+//#endregion
+//# sourceMappingURL=observability-config.resolve.js.map

package/observability/providers/src/lib/config/observability-config.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.resolve.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/config/observability-config.resolve.ts"],"names":[],"mappings":";;AA0BA,8EAgBC;AAED,4DAQC;AAlDD,+CAA+C;AAE/C,SAAS,eAAe,CAAC,KAAyB,EAAE,YAAqB;IACvE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;AACpG,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB,EAAE,YAAoB;IACrE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;AACzD,CAAC;AAED,YAAY;AAEZ,mDAAmD;AAEnD,SAAgB,iCAAiC,CAC/C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,KAAK,YAAY,CAAC;IAE9C,OAAO;QACL,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAC;QAC5D,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/D,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC;QAC5D,WAAW,EAAE,GAAG,CAAC,mBAAmB,CAAC,IAAI,UAAU;QACnD,YAAY,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAChG,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;QAChE,cAAc,EAAE,eAAe,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC;QAClE,kBAAkB,EAAE,cAAc,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CACtC,IAA4B,EAC5B,YAA6C,EAAE;IAE/C,OAAO;QACL,GAAG,IAAI;QACP,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,YAAY"}

package/observability/providers/src/lib/context/als-observability-context.d.ts

@@ -0,0 +1,11 @@
+import type { AxpCorrelation, AxpObservabilityContext } from '@acorex-platform/framework-server/observability/abstract';
+/** Read current correlation without DI (used by pino mixin). */
+export declare function getObservabilityCorrelation(): AxpCorrelation | undefined;
+/** Read active OpenTelemetry trace/span ids without DI (used by pino mixin). */
+export declare function getActiveTraceCorrelation(): Pick<AxpCorrelation, 'traceId' | 'spanId'> | undefined;
+export declare class AlsObservabilityContext implements AxpObservabilityContext {
+    current(): AxpCorrelation | undefined;
+    run<T>(seed: AxpCorrelation, fn: () => T): T;
+    assign(partial: Partial<AxpCorrelation>): void;
+}
+//# sourceMappingURL=als-observability-context.d.ts.map

package/observability/providers/src/lib/context/als-observability-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"als-observability-context.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/context/als-observability-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACxB,MAAM,0DAA0D,CAAC;AAMlE,gEAAgE;AAChE,wBAAgB,2BAA2B,IAAI,cAAc,GAAG,SAAS,CAExE;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,IAAI,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG,SAAS,CAelG;AAED,qBACa,uBAAwB,YAAW,uBAAuB;IACrE,OAAO,IAAI,cAAc,GAAG,SAAS;IAIrC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI5C,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;CAQ/C"}

package/observability/providers/src/lib/context/als-observability-context.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlsObservabilityContext = void 0;
+exports.getObservabilityCorrelation = getObservabilityCorrelation;
+exports.getActiveTraceCorrelation = getActiveTraceCorrelation;
+const tslib_1 = require("tslib");
+const node_async_hooks_1 = require("node:async_hooks");
+const common_1 = require("@nestjs/common");
+const api_1 = require("@opentelemetry/api");
+//#region ---- ALS-backed observability context ----
+const storage = new node_async_hooks_1.AsyncLocalStorage();
+/** Read current correlation without DI (used by pino mixin). */
+function getObservabilityCorrelation() {
+    return storage.getStore();
+}
+/** Read active OpenTelemetry trace/span ids without DI (used by pino mixin). */
+function getActiveTraceCorrelation() {
+    const span = api_1.trace.getSpan(api_1.context.active());
+    if (!span) {
+        return undefined;
+    }
+    const spanContext = span.spanContext();
+    if (!spanContext.traceId) {
+        return undefined;
+    }
+    return {
+        traceId: spanContext.traceId,
+        spanId: spanContext.spanId,
+    };
+}
+let AlsObservabilityContext = class AlsObservabilityContext {
+    current() {
+        return storage.getStore();
+    }
+    run(seed, fn) {
+        return storage.run(seed, fn);
+    }
+    assign(partial) {
+        const current = storage.getStore();
+        if (!current) {
+            return;
+        }
+        Object.assign(current, partial);
+    }
+};
+exports.AlsObservabilityContext = AlsObservabilityContext;
+exports.AlsObservabilityContext = AlsObservabilityContext = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], AlsObservabilityContext);
+//#endregion
+//# sourceMappingURL=als-observability-context.js.map

package/observability/providers/src/lib/context/als-observability-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"als-observability-context.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/context/als-observability-context.ts"],"names":[],"mappings":";;;AAaA,kEAEC;AAGD,8DAeC;;AAjCD,uDAAqD;AACrD,2CAA4C;AAC5C,4CAAoD;AAMpD,oDAAoD;AAEpD,MAAM,OAAO,GAAG,IAAI,oCAAiB,EAAkB,CAAC;AAExD,gEAAgE;AAChE,SAAgB,2BAA2B;IACzC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,gFAAgF;AAChF,SAAgB,yBAAyB;IACvC,MAAM,IAAI,GAAG,WAAK,CAAC,OAAO,CAAC,aAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,MAAM,EAAE,WAAW,CAAC,MAAM;KAC3B,CAAC;AACJ,CAAC;AAGM,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,OAAO;QACL,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,GAAG,CAAI,IAAoB,EAAE,EAAW;QACtC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,OAAgC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACF,CAAA;AAjBY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;GACA,uBAAuB,CAiBnC;AAED,YAAY"}

package/observability/providers/src/lib/context/correlation-fields.util.d.ts

@@ -0,0 +1,13 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { ACX_REQUEST_SESSION_KEY, type AxpCorrelation, type AxpRequestSession } from '@acorex-platform/framework-server/observability/abstract';
+/** Express request key for correlation snapshot (survives ALS scope). */
+export declare const AXP_REQUEST_CORRELATION_KEY = "axpCorrelation";
+/** Minimal request shape for correlation (Express Request or Node IncomingMessage). */
+export type CorrelationRequestSource = Pick<IncomingMessage, 'headers' | 'method' | 'url'> & {
+    [ACX_REQUEST_SESSION_KEY]?: AxpRequestSession;
+    [AXP_REQUEST_CORRELATION_KEY]?: Partial<AxpCorrelation>;
+};
+export declare function readRequestSession(req: CorrelationRequestSource): AxpRequestSession | undefined;
+export declare function buildCorrelationFields(req?: CorrelationRequestSource, overrides?: Partial<AxpCorrelation>): Partial<AxpCorrelation>;
+export declare function buildHttpAccessLogFields(req: CorrelationRequestSource, res: ServerResponse, durationMs: number): Record<string, unknown>;
+//# sourceMappingURL=correlation-fields.util.d.ts.map

package/observability/providers/src/lib/context/correlation-fields.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-fields.util.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/context/correlation-fields.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,0DAA0D,CAAC;AAKlE,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAE5D,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,GAAG;IAC3F,CAAC,uBAAuB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAC9C,CAAC,2BAA2B,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACzD,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,wBAAwB,GAC5B,iBAAiB,GAAG,SAAS,CAE/B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,CAAC,EAAE,wBAAwB,EAC9B,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GACtC,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,wBAAwB,EAC7B,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/observability/providers/src/lib/context/correlation-fields.util.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_REQUEST_CORRELATION_KEY = void 0;
+exports.readRequestSession = readRequestSession;
+exports.buildCorrelationFields = buildCorrelationFields;
+exports.buildHttpAccessLogFields = buildHttpAccessLogFields;
+const abstract_1 = require("@acorex-platform/framework-server/observability/abstract");
+const als_observability_context_1 = require("./als-observability-context");
+//#region ---- Correlation field helpers ----
+/** Express request key for correlation snapshot (survives ALS scope). */
+exports.AXP_REQUEST_CORRELATION_KEY = 'axpCorrelation';
+function readRequestSession(req) {
+    return req[abstract_1.ACX_REQUEST_SESSION_KEY];
+}
+function buildCorrelationFields(req, overrides = {}) {
+    const stored = (0, als_observability_context_1.getObservabilityCorrelation)();
+    const trace = (0, als_observability_context_1.getActiveTraceCorrelation)();
+    const session = req ? readRequestSession(req) : undefined;
+    const reqCorrelation = req?.[exports.AXP_REQUEST_CORRELATION_KEY];
+    const headerRequestId = req?.headers['x-request-id'];
+    const requestId = overrides.requestId ??
+        stored?.requestId ??
+        reqCorrelation?.requestId ??
+        (typeof headerRequestId === 'string' ? headerRequestId : undefined);
+    return {
+        requestId,
+        traceId: overrides.traceId ?? trace?.traceId ?? stored?.traceId ?? reqCorrelation?.traceId,
+        spanId: overrides.spanId ?? trace?.spanId ?? stored?.spanId ?? reqCorrelation?.spanId,
+        userId: overrides.userId ?? stored?.userId ?? reqCorrelation?.userId ?? session?.userId,
+        username: overrides.username ?? stored?.username ?? reqCorrelation?.username ?? session?.username,
+        tenantId: overrides.tenantId ?? stored?.tenantId ?? reqCorrelation?.tenantId ?? session?.tenantId,
+        applicationId: overrides.applicationId ??
+            stored?.applicationId ??
+            reqCorrelation?.applicationId ??
+            session?.applicationId,
+    };
+}
+function buildHttpAccessLogFields(req, res, durationMs) {
+    return {
+        ...buildCorrelationFields(req),
+        method: req.method,
+        url: req.url,
+        statusCode: res.statusCode,
+        duration: durationMs,
+        responseTime: durationMs,
+    };
+}
+//#endregion
+//# sourceMappingURL=correlation-fields.util.js.map

package/observability/providers/src/lib/context/correlation-fields.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-fields.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/context/correlation-fields.util.ts"],"names":[],"mappings":";;;AAmBA,gDAIC;AAED,wDA4BC;AAED,4DAaC;AAnED,uFAIkE;AAClE,2EAAqG;AAErG,6CAA6C;AAE7C,yEAAyE;AAC5D,QAAA,2BAA2B,GAAG,gBAAgB,CAAC;AAQ5D,SAAgB,kBAAkB,CAChC,GAA6B;IAE7B,OAAO,GAAG,CAAC,kCAAuB,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,sBAAsB,CACpC,GAA8B,EAC9B,YAAqC,EAAE;IAEvC,MAAM,MAAM,GAAG,IAAA,uDAA2B,GAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAA,qDAAyB,GAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,mCAA2B,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,SAAS,GACb,SAAS,CAAC,SAAS;QACnB,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,SAAS;QACzB,CAAC,OAAO,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEtE,OAAO;QACL,SAAS;QACT,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,KAAK,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,cAAc,EAAE,OAAO;QAC1F,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM;QACrF,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,MAAM,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM;QACvF,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,MAAM,EAAE,QAAQ,IAAI,cAAc,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ;QACjG,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,MAAM,EAAE,QAAQ,IAAI,cAAc,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ;QACjG,aAAa,EACX,SAAS,CAAC,aAAa;YACvB,MAAM,EAAE,aAAa;YACrB,cAAc,EAAE,aAAa;YAC7B,OAAO,EAAE,aAAa;KACzB,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CACtC,GAA6B,EAC7B,GAAmB,EACnB,UAAkB;IAElB,OAAO;QACL,GAAG,sBAAsB,CAAC,GAAG,CAAC;QAC9B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,UAAU;KACzB,CAAC;AACJ,CAAC;AAED,YAAY"}

package/observability/providers/src/lib/http/correlation.middleware.d.ts

@@ -0,0 +1,10 @@
+import { NestMiddleware } from '@nestjs/common';
+import type { NextFunction, Request, Response } from 'express';
+import { type AxpObservabilityConfig, type AxpObservabilityContext } from '@acorex-platform/framework-server/observability/abstract';
+export declare class CorrelationMiddleware implements NestMiddleware {
+    private readonly observabilityContext;
+    private readonly config;
+    constructor(observabilityContext: AxpObservabilityContext, config: AxpObservabilityConfig);
+    use(req: Request, res: Response, next: NextFunction): void;
+}
+//# sourceMappingURL=correlation.middleware.d.ts.map

package/observability/providers/src/lib/http/correlation.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/http/correlation.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,0DAA0D,CAAC;AASlE,qBACa,qBAAsB,YAAW,cAAc;IAGxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADxC,oBAAoB,EAAE,uBAAuB,EACX,MAAM,EAAE,sBAAsB;IAGnF,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;CA8C3D"}