@acorex-platform/framework-server 0.0.15 → 0.0.20

package/observability/providers/src/lib/http/correlation.middleware.js

@@ -45,11 +45,13 @@ let CorrelationMiddleware = class CorrelationMiddleware {
             req[correlation_fields_util_1.AXP_REQUEST_CORRELATION_KEY] = enriched;
             this.observabilityContext.assign(trace);
         };
-        this.observabilityContext.run(seed, () => {
-            enrichTrace();
-            process.nextTick(enrichTrace);
-            next();
-        });
+        // enterWith (not run-wrapping next): Nest schedules the route handler after
+        // middleware returns; ALS.run(() => next()) exits too early and drops nested
+        // entity-storage enterWith — visibility then sees no session.
+        this.observabilityContext.enterWith(seed);
+        enrichTrace();
+        process.nextTick(enrichTrace);
+        next();
     }
 };
 exports.CorrelationMiddleware = CorrelationMiddleware;

package/observability/providers/src/lib/http/correlation.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"correlation.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/http/correlation.middleware.ts"],"names":[],"mappings":";;;;AAAA,6CAAyC;AACzC,2CAAoE;AAEpE,uFAMkE;AAClE,oFAAiF;AACjF,gFAG4C;AAE5C,+CAA+C;AAGxC,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAEmB,oBAA6C,EACX,MAA8B;QADhE,yBAAoB,GAApB,oBAAoB,CAAyB;QACX,WAAM,GAAN,MAAM,CAAwB;IAChF,CAAC;IAEJ,GAAG,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,SAAS,GACb,OAAO,iBAAiB,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC1E,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE;YAC1B,CAAC,CAAC,IAAA,wBAAU,GAAE,CAAC;QAEnB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;QACxC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAI,GAAgC,CAAC,kCAAuB,CAAC,CAAC;QAC3E,MAAM,gBAAgB,GAAG,IAAA,qDAAyB,GAAE,CAAC;QACrD,MAAM,IAAI,GAAG;YACX,SAAS;YACT,OAAO,EAAE,gBAAgB,EAAE,OAAO;YAClC,MAAM,EAAE,gBAAgB,EAAE,MAAM;YAChC,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,aAAa,EAAE,OAAO,EAAE,aAAa;SACtC,CAAC;QAED,GAAgC,CAAC,qDAA2B,CAAC,GAAG,IAAI,CAAC;QAEtE,MAAM,WAAW,GAAG,GAAS,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAA,qDAAyB,GAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YACtC,GAAgC,CAAC,qDAA2B,CAAC,GAAG,QAAQ,CAAC;YAC1E,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE;YACvC,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAGR,mBAAA,IAAA,eAAM,EAAC,oCAAyB,CAAC,CAAA;IAEjC,mBAAA,IAAA,eAAM,EAAC,mCAAwB,CAAC,CAAA;;GAJxB,qBAAqB,CAqDjC;AAED,YAAY"}
+{"version":3,"file":"correlation.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/observability/providers/src/lib/http/correlation.middleware.ts"],"names":[],"mappings":";;;;AAAA,6CAAyC;AACzC,2CAAoE;AAEpE,uFAMkE;AAClE,oFAAiF;AACjF,gFAG4C;AAE5C,+CAA+C;AAGxC,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAEmB,oBAA6C,EACX,MAA8B;QADhE,yBAAoB,GAApB,oBAAoB,CAAyB;QACX,WAAM,GAAN,MAAM,CAAwB;IAChF,CAAC;IAEJ,GAAG,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,SAAS,GACb,OAAO,iBAAiB,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC1E,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE;YAC1B,CAAC,CAAC,IAAA,wBAAU,GAAE,CAAC;QAEnB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;QACxC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAI,GAAgC,CAAC,kCAAuB,CAAC,CAAC;QAC3E,MAAM,gBAAgB,GAAG,IAAA,qDAAyB,GAAE,CAAC;QACrD,MAAM,IAAI,GAAG;YACX,SAAS;YACT,OAAO,EAAE,gBAAgB,EAAE,OAAO;YAClC,MAAM,EAAE,gBAAgB,EAAE,MAAM;YAChC,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,aAAa,EAAE,OAAO,EAAE,aAAa;SACtC,CAAC;QAED,GAAgC,CAAC,qDAA2B,CAAC,GAAG,IAAI,CAAC;QAEtE,MAAM,WAAW,GAAG,GAAS,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAA,qDAAyB,GAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YACtC,GAAgC,CAAC,qDAA2B,CAAC,GAAG,QAAQ,CAAC;YAC1E,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,4EAA4E;QAC5E,6EAA6E;QAC7E,8DAA8D;QAC9D,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC9B,IAAI,EAAE,CAAC;IACT,CAAC;CACF,CAAA;AAvDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAGR,mBAAA,IAAA,eAAM,EAAC,oCAAyB,CAAC,CAAA;IAEjC,mBAAA,IAAA,eAAM,EAAC,mCAAwB,CAAC,CAAA;;GAJxB,qBAAqB,CAuDjC;AAED,YAAY"}

package/observability/providers/src/lib/observability.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.module.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/observability/providers/src/lib/observability.module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAMd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAUL,KAAK,sBAAsB,EAC5B,MAAM,0DAA0D,CAAC;AAkBlE,MAAM,WAAW,0BAA2B,SAAQ,OAAO,CAAC,sBAAsB,CAAC;CAAG;AAetF,qBAEa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa;IAUvE,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyBnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAoCnC"}
+{"version":3,"file":"observability.module.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/observability/providers/src/lib/observability.module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAMd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAYL,KAAK,sBAAsB,EAC5B,MAAM,0DAA0D,CAAC;AAsBlE,MAAM,WAAW,0BAA2B,SAAQ,OAAO,CAAC,sBAAsB,CAAC;CAAG;AAetF,qBAEa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa;IAUvE,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8BnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAyCnC"}

package/observability/providers/src/lib/observability.module.js

@@ -9,6 +9,7 @@ const nestjs_pino_1 = require("nestjs-pino");
 const abstract_1 = require("@acorex-platform/framework-server/observability/abstract");
 const observability_config_resolve_1 = require("./config/observability-config.resolve");
 const als_observability_context_1 = require("./context/als-observability-context");
+const execution_trace_recorder_service_1 = require("./execution-trace/execution-trace-recorder.service");
 const correlation_middleware_1 = require("./http/correlation.middleware");
 const observability_middleware_routes_1 = require("./http/observability-middleware.routes");
 const http_metrics_interceptor_1 = require("./http/http-metrics.interceptor");
@@ -47,19 +48,24 @@ let ObservabilityModule = ObservabilityModule_1 = class ObservabilityModule {
             imports: [ObservabilityCorrelationModule],
             providers: [
                 { provide: abstract_1.AXP_OBSERVABILITY_CONFIG, useValue: config },
+                { provide: abstract_1.AXP_EXECUTION_TRACING_CONFIG, useValue: config.executionTracing },
                 { provide: abstract_1.AXP_LOGGER, useClass: abstract_1.NoopLoggerAdapter },
                 { provide: abstract_1.AXP_TRACER, useClass: abstract_1.NoopTracerAdapter },
                 { provide: abstract_1.AXP_METRICS, useClass: abstract_1.NoopMetricsAdapter },
                 { provide: abstract_1.AXP_OBSERVABILITY_CONTEXT, useClass: abstract_1.NoopObservabilityContextAdapter },
+                execution_trace_recorder_service_1.NoopExecutionTraceRecorderService,
+                { provide: abstract_1.AXP_EXECUTION_TRACE_RECORDER, useExisting: execution_trace_recorder_service_1.NoopExecutionTraceRecorderService },
                 correlation_middleware_1.CorrelationMiddleware,
                 observability_service_1.ObservabilityService,
             ],
             exports: [
                 abstract_1.AXP_OBSERVABILITY_CONFIG,
+                abstract_1.AXP_EXECUTION_TRACING_CONFIG,
                 abstract_1.AXP_LOGGER,
                 abstract_1.AXP_TRACER,
                 abstract_1.AXP_METRICS,
                 abstract_1.AXP_OBSERVABILITY_CONTEXT,
+                abstract_1.AXP_EXECUTION_TRACE_RECORDER,
                 observability_service_1.ObservabilityService,
             ],
         };
@@ -67,6 +73,7 @@ let ObservabilityModule = ObservabilityModule_1 = class ObservabilityModule {
     static createEnabledModule(config) {
         const providers = [
             { provide: abstract_1.AXP_OBSERVABILITY_CONFIG, useValue: config },
+            { provide: abstract_1.AXP_EXECUTION_TRACING_CONFIG, useValue: config.executionTracing },
             als_observability_context_1.AlsObservabilityContext,
             { provide: abstract_1.AXP_OBSERVABILITY_CONTEXT, useExisting: als_observability_context_1.AlsObservabilityContext },
             pino_logger_adapter_1.PinoLoggerAdapter,
@@ -75,6 +82,8 @@ let ObservabilityModule = ObservabilityModule_1 = class ObservabilityModule {
             { provide: abstract_1.AXP_TRACER, useExisting: otel_tracer_adapter_1.OpenTelemetryTracerAdapter },
             otel_metrics_adapter_1.OpenTelemetryMetricsAdapter,
             { provide: abstract_1.AXP_METRICS, useExisting: otel_metrics_adapter_1.OpenTelemetryMetricsAdapter },
+            execution_trace_recorder_service_1.ExecutionTraceRecorderService,
+            { provide: abstract_1.AXP_EXECUTION_TRACE_RECORDER, useExisting: execution_trace_recorder_service_1.ExecutionTraceRecorderService },
             observability_service_1.ObservabilityService,
             correlation_middleware_1.CorrelationMiddleware,
             { provide: core_1.APP_INTERCEPTOR, useClass: observability_context_interceptor_1.ObservabilityContextInterceptor },
@@ -90,10 +99,12 @@ let ObservabilityModule = ObservabilityModule_1 = class ObservabilityModule {
             providers,
             exports: [
                 abstract_1.AXP_OBSERVABILITY_CONFIG,
+                abstract_1.AXP_EXECUTION_TRACING_CONFIG,
                 abstract_1.AXP_LOGGER,
                 abstract_1.AXP_TRACER,
                 abstract_1.AXP_METRICS,
                 abstract_1.AXP_OBSERVABILITY_CONTEXT,
+                abstract_1.AXP_EXECUTION_TRACE_RECORDER,
                 observability_service_1.ObservabilityService,
                 nestjs_pino_1.LoggerModule,
             ],

package/observability/providers/src/lib/observability.module.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex-platform/framework-server",
-  "version": "0.0.15",
+  "version": "0.0.20",
   "type": "commonjs",
   "exports": {
     "./package.json": "./package.json",
@@ -116,6 +116,10 @@
       "types": "./observability/providers/src/init.d.ts",
       "default": "./observability/providers/src/init.js"
     },
+    "./print/abstract": {
+      "types": "./print/abstract/src/index.d.ts",
+      "default": "./print/abstract/src/index.js"
+    },
     "./realtime": {
       "types": "./realtime/src/index.d.ts",
       "default": "./realtime/src/index.js"
@@ -148,13 +152,25 @@
       "types": "./swagger/src/index.d.ts",
       "default": "./swagger/src/index.js"
     },
+    "./tracing/abstract": {
+      "types": "./tracing/abstract/src/index.d.ts",
+      "default": "./tracing/abstract/src/index.js"
+    },
+    "./tracing/middleware": {
+      "types": "./tracing/middleware/src/index.d.ts",
+      "default": "./tracing/middleware/src/index.js"
+    },
+    "./tracing/providers": {
+      "types": "./tracing/providers/src/index.d.ts",
+      "default": "./tracing/providers/src/index.js"
+    },
     "./workflow": {
       "types": "./workflow/src/index.d.ts",
       "default": "./workflow/src/index.js"
     }
   },
   "peerDependencies": {
-    "@nestjs/common": "^11.0.0",
-    "@acorex-platform/framework-shared": "0.0.15"
+    "@acorex-platform/framework-shared": "0.0.20",
+    "@nestjs/common": "^11.0.0"
   }
 }

package/print/abstract/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from './lib/html-to-pdf.types';
+export * from './lib/html-to-pdf-engine.interface';
+export * from './lib/html-to-pdf.tokens';
+export * from './lib/html-to-pdf.service';
+export * from './lib/html-to-pdf.module';
+export * from './lib/extract-print-page-regions.util';
+//# sourceMappingURL=index.d.ts.map

package/print/abstract/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/print/abstract/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC"}

package/print/abstract/src/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/html-to-pdf.types"), exports);
+tslib_1.__exportStar(require("./lib/html-to-pdf-engine.interface"), exports);
+tslib_1.__exportStar(require("./lib/html-to-pdf.tokens"), exports);
+tslib_1.__exportStar(require("./lib/html-to-pdf.service"), exports);
+tslib_1.__exportStar(require("./lib/html-to-pdf.module"), exports);
+tslib_1.__exportStar(require("./lib/extract-print-page-regions.util"), exports);
+//# sourceMappingURL=index.js.map

package/print/abstract/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/print/abstract/src/index.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,6EAAmD;AACnD,mEAAyC;AACzC,oEAA0C;AAC1C,mEAAyC;AACzC,gFAAsD"}

package/print/abstract/src/lib/extract-print-page-regions.util.d.ts

@@ -0,0 +1,23 @@
+/** Attribute authors set on chrome that should repeat on every PDF page. */
+export declare const AXP_PRINT_PAGE_REGION_ATTR: "data-print-region";
+export declare const AXP_PRINT_PAGE_REGION: {
+    readonly header: "header";
+    readonly footer: "footer";
+};
+export type AxpPrintPageRegionName = (typeof AXP_PRINT_PAGE_REGION)[keyof typeof AXP_PRINT_PAGE_REGION];
+export interface AxpExtractedPrintPageRegions {
+    /** Document HTML with header/footer regions removed. */
+    bodyHtml: string;
+    headerHtml?: string;
+    footerHtml?: string;
+}
+/**
+ * Pulls marked header/footer out of print HTML so a Chromium engine can pass
+ * them as repeating `headerTemplate` / `footerTemplate`.
+ *
+ * Authors mark chrome with `data-print-region="header"` or `"footer"`
+ * (optional class `__print-page-header` / `__print-page-footer`).
+ * Multiple header/footer regions are stacked (company master, then child).
+ */
+export declare function extractPrintPageRegions(html: string): AxpExtractedPrintPageRegions;
+//# sourceMappingURL=extract-print-page-regions.util.d.ts.map

package/print/abstract/src/lib/extract-print-page-regions.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-print-page-regions.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/extract-print-page-regions.util.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,EAAG,mBAA4B,CAAC;AAEvE,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAExG,MAAM,WAAW,4BAA4B;IAC3C,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,4BAA4B,CAwBlF"}

package/print/abstract/src/lib/extract-print-page-regions.util.js

@@ -0,0 +1,57 @@
+"use strict";
+//#region ---- Print page header / footer regions ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_PRINT_PAGE_REGION = exports.AXP_PRINT_PAGE_REGION_ATTR = void 0;
+exports.extractPrintPageRegions = extractPrintPageRegions;
+/** Attribute authors set on chrome that should repeat on every PDF page. */
+exports.AXP_PRINT_PAGE_REGION_ATTR = 'data-print-region';
+exports.AXP_PRINT_PAGE_REGION = {
+    header: 'header',
+    footer: 'footer',
+};
+/**
+ * Pulls marked header/footer out of print HTML so a Chromium engine can pass
+ * them as repeating `headerTemplate` / `footerTemplate`.
+ *
+ * Authors mark chrome with `data-print-region="header"` or `"footer"`
+ * (optional class `__print-page-header` / `__print-page-footer`).
+ * Multiple header/footer regions are stacked (company master, then child).
+ */
+function extractPrintPageRegions(html) {
+    let bodyHtml = html ?? '';
+    const headers = [];
+    const footers = [];
+    let header = takeRegion(bodyHtml, exports.AXP_PRINT_PAGE_REGION.header);
+    while (header.inner) {
+        headers.push(header.inner);
+        bodyHtml = header.rest;
+        header = takeRegion(bodyHtml, exports.AXP_PRINT_PAGE_REGION.header);
+    }
+    let footer = takeRegion(bodyHtml, exports.AXP_PRINT_PAGE_REGION.footer);
+    while (footer.inner) {
+        footers.push(footer.inner);
+        bodyHtml = footer.rest;
+        footer = takeRegion(bodyHtml, exports.AXP_PRINT_PAGE_REGION.footer);
+    }
+    return {
+        bodyHtml,
+        ...(headers.length ? { headerHtml: headers.join('') } : {}),
+        ...(footers.length ? { footerHtml: footers.join('') } : {}),
+    };
+}
+function takeRegion(html, name) {
+    const attrPattern = new RegExp(`<([a-z][a-z0-9]*)\\b[^>]*\\b${exports.AXP_PRINT_PAGE_REGION_ATTR}\\s*=\\s*["']${name}["'][^>]*>([\\s\\S]*?)</\\1>`, 'i');
+    const className = name === exports.AXP_PRINT_PAGE_REGION.header ? '__print-page-header' : '__print-page-footer';
+    const classPattern = new RegExp(`<([a-z][a-z0-9]*)\\b[^>]*\\bclass\\s*=\\s*["'][^"']*\\b${className}\\b[^"']*["'][^>]*>([\\s\\S]*?)</\\1>`, 'i');
+    const match = html.match(attrPattern) ?? html.match(classPattern);
+    if (!match?.[0]) {
+        return { rest: html };
+    }
+    const inner = (match[2] ?? '').trim();
+    return {
+        ...(inner ? { inner } : {}),
+        rest: html.replace(match[0], ''),
+    };
+}
+//#endregion
+//# sourceMappingURL=extract-print-page-regions.util.js.map

package/print/abstract/src/lib/extract-print-page-regions.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-print-page-regions.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/extract-print-page-regions.util.ts"],"names":[],"mappings":";AAAA,sDAAsD;;;AA2BtD,0DAwBC;AAjDD,4EAA4E;AAC/D,QAAA,0BAA0B,GAAG,mBAA4B,CAAC;AAE1D,QAAA,qBAAqB,GAAG;IACnC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAWX;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,IAAI,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,6BAAqB,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,6BAAqB,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,6BAAqB,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,6BAAqB,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAAY,EACZ,IAA4B;IAE5B,MAAM,WAAW,GAAG,IAAI,MAAM,CAC5B,+BAA+B,kCAA0B,gBAAgB,IAAI,8BAA8B,EAC3G,GAAG,CACJ,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,KAAK,6BAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACxG,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,0DAA0D,SAAS,uCAAuC,EAC1G,GAAG,CACJ,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,YAAY"}

package/print/abstract/src/lib/html-to-pdf-engine.interface.d.ts

@@ -0,0 +1,6 @@
+import type { HtmlToPdfRequest, HtmlToPdfResult } from './html-to-pdf.types';
+/** Replaceable print engine (Chromium, Gotenberg, …). */
+export interface HtmlToPdfEngine {
+    render(request: HtmlToPdfRequest): Promise<HtmlToPdfResult>;
+}
+//# sourceMappingURL=html-to-pdf-engine.interface.d.ts.map

package/print/abstract/src/lib/html-to-pdf-engine.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf-engine.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf-engine.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI7E,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7D"}

package/print/abstract/src/lib/html-to-pdf-engine.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=html-to-pdf-engine.interface.js.map

package/print/abstract/src/lib/html-to-pdf-engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf-engine.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf-engine.interface.ts"],"names":[],"mappings":";;AASA,YAAY"}

package/print/abstract/src/lib/html-to-pdf.module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provides {@link HtmlToPdfService}. The engine token is supplied by an
+ * extension module (Chromium, Gotenberg, …).
+ */
+export declare class HtmlToPdfModule {
+}
+//# sourceMappingURL=html-to-pdf.module.d.ts.map

package/print/abstract/src/lib/html-to-pdf.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.module.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.module.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAIa,eAAe;CAAG"}

package/print/abstract/src/lib/html-to-pdf.module.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlToPdfModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const html_to_pdf_service_1 = require("./html-to-pdf.service");
+//#region ---- HTML-to-PDF facade module ----
+/**
+ * Provides {@link HtmlToPdfService}. The engine token is supplied by an
+ * extension module (Chromium, Gotenberg, …).
+ */
+let HtmlToPdfModule = class HtmlToPdfModule {
+};
+exports.HtmlToPdfModule = HtmlToPdfModule;
+exports.HtmlToPdfModule = HtmlToPdfModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [html_to_pdf_service_1.HtmlToPdfService],
+        exports: [html_to_pdf_service_1.HtmlToPdfService],
+    })
+], HtmlToPdfModule);
+//#endregion
+//# sourceMappingURL=html-to-pdf.module.js.map

package/print/abstract/src/lib/html-to-pdf.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,+DAAyD;AAEzD,6CAA6C;AAE7C;;;GAGG;AAKI,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAJ3B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,sCAAgB,CAAC;QAC7B,OAAO,EAAE,CAAC,sCAAgB,CAAC;KAC5B,CAAC;GACW,eAAe,CAAG;AAE/B,YAAY"}

package/print/abstract/src/lib/html-to-pdf.service.d.ts

@@ -0,0 +1,13 @@
+import type { HtmlToPdfEngine } from './html-to-pdf-engine.interface';
+import type { HtmlToPdfRequest, HtmlToPdfResult } from './html-to-pdf.types';
+export declare const HTML_TO_PDF_ENGINE_MISSING_MESSAGE = "No HTML-to-PDF engine is registered. Import a print engine extension (for example ChromiumPrintExtensionServerModule).";
+/**
+ * Module-facing print facade. Injects the active {@link HtmlToPdfEngine}.
+ * Assessment, reports, and dashboards call this — never Playwright or Gotenberg.
+ */
+export declare class HtmlToPdfService {
+    private readonly engine?;
+    constructor(engine?: HtmlToPdfEngine | undefined);
+    render(request: HtmlToPdfRequest): Promise<HtmlToPdfResult>;
+}
+//# sourceMappingURL=html-to-pdf.service.d.ts.map

package/print/abstract/src/lib/html-to-pdf.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI7E,eAAO,MAAM,kCAAkC,2HAC2E,CAAC;AAE3H;;;GAGG;AACH,qBACa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAP,MAAM,CAAC,EAAE,eAAe,YAAA;IAGrC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CASlE"}

package/print/abstract/src/lib/html-to-pdf.service.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlToPdfService = exports.HTML_TO_PDF_ENGINE_MISSING_MESSAGE = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const html_to_pdf_tokens_1 = require("./html-to-pdf.tokens");
+//#region ---- HTML-to-PDF facade ----
+exports.HTML_TO_PDF_ENGINE_MISSING_MESSAGE = 'No HTML-to-PDF engine is registered. Import a print engine extension (for example ChromiumPrintExtensionServerModule).';
+/**
+ * Module-facing print facade. Injects the active {@link HtmlToPdfEngine}.
+ * Assessment, reports, and dashboards call this — never Playwright or Gotenberg.
+ */
+let HtmlToPdfService = class HtmlToPdfService {
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async render(request) {
+        if (!this.engine) {
+            throw new Error(exports.HTML_TO_PDF_ENGINE_MISSING_MESSAGE);
+        }
+        if (!request?.html || !String(request.html).trim()) {
+            throw new Error('HTML is required to render a PDF.');
+        }
+        return this.engine.render(request);
+    }
+};
+exports.HtmlToPdfService = HtmlToPdfService;
+exports.HtmlToPdfService = HtmlToPdfService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Optional)()),
+    tslib_1.__param(0, (0, common_1.Inject)(html_to_pdf_tokens_1.HTML_TO_PDF_ENGINE)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], HtmlToPdfService);
+//#endregion
+//# sourceMappingURL=html-to-pdf.service.js.map

package/print/abstract/src/lib/html-to-pdf.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA8D;AAE9D,6DAA0D;AAG1D,sCAAsC;AAEzB,QAAA,kCAAkC,GAC7C,wHAAwH,CAAC;AAE3H;;;GAGG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAGmB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0CAAkC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACF,CAAA;AAhBY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;IAGR,mBAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,mBAAA,IAAA,eAAM,EAAC,uCAAkB,CAAC,CAAA;;GAHlB,gBAAgB,CAgB5B;AAED,YAAY"}

package/print/abstract/src/lib/html-to-pdf.tokens.d.ts

@@ -0,0 +1,3 @@
+/** Active {@link HtmlToPdfEngine} implementation. */
+export declare const HTML_TO_PDF_ENGINE: unique symbol;
+//# sourceMappingURL=html-to-pdf.tokens.d.ts.map

package/print/abstract/src/lib/html-to-pdf.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.tokens.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.tokens.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,eAA+B,CAAC"}

package/print/abstract/src/lib/html-to-pdf.tokens.js

@@ -0,0 +1,8 @@
+"use strict";
+//#region ---- HTML-to-PDF DI tokens ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTML_TO_PDF_ENGINE = void 0;
+/** Active {@link HtmlToPdfEngine} implementation. */
+exports.HTML_TO_PDF_ENGINE = Symbol('HTML_TO_PDF_ENGINE');
+//#endregion
+//# sourceMappingURL=html-to-pdf.tokens.js.map

package/print/abstract/src/lib/html-to-pdf.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.tokens.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.tokens.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;AAEzC,qDAAqD;AACxC,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D,YAAY"}

package/print/abstract/src/lib/html-to-pdf.types.d.ts

@@ -0,0 +1,35 @@
+export type HtmlToPdfPageFormat = 'A4' | 'Letter' | 'Legal';
+export interface HtmlToPdfMargin {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+}
+/**
+ * Document-shaped print request. Callers supply print-safe HTML.
+ * Engines must not require questionnaire, report, or dashboard types.
+ */
+export interface HtmlToPdfRequest {
+    html: string;
+    /** PDF document title (viewer tab / file metadata). Falls back to HTML `<title>`. */
+    title?: string;
+    /** Chromium header snippet. CSS Paged Media engines may ignore this. */
+    headerHtml?: string;
+    /** Chromium footer snippet. CSS Paged Media engines may ignore this. */
+    footerHtml?: string;
+    format?: HtmlToPdfPageFormat;
+    landscape?: boolean;
+    margin?: HtmlToPdfMargin;
+    /**
+     * Origins used to absolutize relative image URLs (logo `/assets/...`,
+     * `/api/v1/file-storage/download/...`) before Chromium prints.
+     */
+    resourceBaseUrls?: string[];
+    /** Forwarded when the engine fetches those images (cookie / authorization). */
+    resourceHeaders?: Record<string, string>;
+}
+export interface HtmlToPdfResult {
+    pdf: Buffer;
+    contentType: 'application/pdf';
+}
+//# sourceMappingURL=html-to-pdf.types.d.ts.map

package/print/abstract/src/lib/html-to-pdf.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,iBAAiB,CAAC;CAChC"}

package/print/abstract/src/lib/html-to-pdf.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- HTML-to-PDF request / result ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=html-to-pdf.types.js.map

package/print/abstract/src/lib/html-to-pdf.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-pdf.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/print/abstract/src/lib/html-to-pdf.types.ts"],"names":[],"mappings":";AAAA,gDAAgD;;AAwChD,YAAY"}

package/realtime/src/index.d.ts

@@ -2,8 +2,10 @@ export * from './lib/realtime.module';
 export * from './lib/realtime-redis.config';
 export * from './lib/ports/realtime-publisher.port';
 export * from './lib/ports/realtime-transport.port';
+export * from './lib/ports/realtime-delivery.port';
 export * from './lib/ports/realtime-conversation-membership.port';
 export * from './lib/ports/realtime-conversation-membership.registry';
+export * from './lib/delivery/socket-io-realtime.delivery';
 export * from './lib/topics/realtime-topics';
 export * from './lib/types/realtime.types';
 export * from './lib/rooms/realtime-rooms.util';
@@ -12,4 +14,9 @@ export * from './lib/entity-bridge/realtime-entity-bridge.tokens';
 export * from './lib/entity-bridge/realtime-entity-bridge.registry';
 export * from './lib/services/realtime-publisher.service';
 export * from './lib/gateway/realtime.gateway';
+export * from './lib/presence/user-presence.types';
+export * from './lib/presence/user-presence.constants';
+export * from './lib/presence/user-presence-tracker.service';
+export * from './lib/presence/user-presence-history.port';
+export * from './lib/presence/user-presence-history.registry';
 //# sourceMappingURL=index.d.ts.map

package/realtime/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/realtime/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mDAAmD,CAAC;AAClE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kDAAkD,CAAC;AACjE,cAAc,mDAAmD,CAAC;AAClE,cAAc,qDAAqD,CAAC;AACpE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/realtime/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mDAAmD,CAAC;AAClE,cAAc,uDAAuD,CAAC;AACtE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kDAAkD,CAAC;AACjE,cAAc,mDAAmD,CAAC;AAClE,cAAc,qDAAqD,CAAC;AACpE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC"}

package/realtime/src/index.js

@@ -5,8 +5,10 @@ tslib_1.__exportStar(require("./lib/realtime.module"), exports);
 tslib_1.__exportStar(require("./lib/realtime-redis.config"), exports);
 tslib_1.__exportStar(require("./lib/ports/realtime-publisher.port"), exports);
 tslib_1.__exportStar(require("./lib/ports/realtime-transport.port"), exports);
+tslib_1.__exportStar(require("./lib/ports/realtime-delivery.port"), exports);
 tslib_1.__exportStar(require("./lib/ports/realtime-conversation-membership.port"), exports);
 tslib_1.__exportStar(require("./lib/ports/realtime-conversation-membership.registry"), exports);
+tslib_1.__exportStar(require("./lib/delivery/socket-io-realtime.delivery"), exports);
 tslib_1.__exportStar(require("./lib/topics/realtime-topics"), exports);
 tslib_1.__exportStar(require("./lib/types/realtime.types"), exports);
 tslib_1.__exportStar(require("./lib/rooms/realtime-rooms.util"), exports);
@@ -15,4 +17,9 @@ tslib_1.__exportStar(require("./lib/entity-bridge/realtime-entity-bridge.tokens"
 tslib_1.__exportStar(require("./lib/entity-bridge/realtime-entity-bridge.registry"), exports);
 tslib_1.__exportStar(require("./lib/services/realtime-publisher.service"), exports);
 tslib_1.__exportStar(require("./lib/gateway/realtime.gateway"), exports);
+tslib_1.__exportStar(require("./lib/presence/user-presence.types"), exports);
+tslib_1.__exportStar(require("./lib/presence/user-presence.constants"), exports);
+tslib_1.__exportStar(require("./lib/presence/user-presence-tracker.service"), exports);
+tslib_1.__exportStar(require("./lib/presence/user-presence-history.port"), exports);
+tslib_1.__exportStar(require("./lib/presence/user-presence-history.registry"), exports);
 //# sourceMappingURL=index.js.map

package/realtime/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/realtime/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,sEAA4C;AAC5C,8EAAoD;AACpD,8EAAoD;AACpD,4FAAkE;AAClE,gGAAsE;AACtE,uEAA6C;AAC7C,qEAA2C;AAC3C,0EAAgD;AAChD,2FAAiE;AACjE,4FAAkE;AAClE,8FAAoE;AACpE,oFAA0D;AAC1D,yEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/realtime/src/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,sEAA4C;AAC5C,8EAAoD;AACpD,8EAAoD;AACpD,6EAAmD;AACnD,4FAAkE;AAClE,gGAAsE;AACtE,qFAA2D;AAC3D,uEAA6C;AAC7C,qEAA2C;AAC3C,0EAAgD;AAChD,2FAAiE;AACjE,4FAAkE;AAClE,8FAAoE;AACpE,oFAA0D;AAC1D,yEAA+C;AAC/C,6EAAmD;AACnD,iFAAuD;AACvD,uFAA6D;AAC7D,oFAA0D;AAC1D,wFAA8D"}

package/realtime/src/lib/delivery/socket-io-realtime.delivery.d.ts

@@ -0,0 +1,14 @@
+import type { Server } from 'socket.io';
+import { RealtimeDeliveryPort } from '../ports/realtime-delivery.port';
+import type { AXPRealtimeEnvelope } from '../types/realtime.types';
+/**
+ * Built-in client delivery via Socket.IO rooms.
+ * The gateway attaches the namespace {@link Server} after init.
+ */
+export declare class SocketIoRealtimeDelivery extends RealtimeDeliveryPort {
+    private readonly logger;
+    private server;
+    attachServer(server: Server): void;
+    deliver(envelope: AXPRealtimeEnvelope): void;
+}
+//# sourceMappingURL=socket-io-realtime.delivery.d.ts.map

package/realtime/src/lib/delivery/socket-io-realtime.delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-realtime.delivery.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/delivery/socket-io-realtime.delivery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE;;;GAGG;AACH,qBACa,wBAAyB,SAAQ,oBAAoB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IACpE,OAAO,CAAC,MAAM,CAAuB;IAErC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKlC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;CAc7C"}

package/realtime/src/lib/delivery/socket-io-realtime.delivery.js

@@ -0,0 +1,43 @@
+"use strict";
+var SocketIoRealtimeDelivery_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocketIoRealtimeDelivery = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const realtime_delivery_port_1 = require("../ports/realtime-delivery.port");
+const realtime_rooms_util_1 = require("../rooms/realtime-rooms.util");
+const realtime_topics_1 = require("../topics/realtime-topics");
+//#region ---- Socket.IO delivery (built-in) ----
+/**
+ * Built-in client delivery via Socket.IO rooms.
+ * The gateway attaches the namespace {@link Server} after init.
+ */
+let SocketIoRealtimeDelivery = SocketIoRealtimeDelivery_1 = class SocketIoRealtimeDelivery extends realtime_delivery_port_1.RealtimeDeliveryPort {
+    constructor() {
+        super(...arguments);
+        this.logger = new common_1.Logger(SocketIoRealtimeDelivery_1.name);
+        this.server = null;
+    }
+    attachServer(server) {
+        this.server = server;
+        this.logger.debug('Socket.IO realtime delivery attached');
+    }
+    deliver(envelope) {
+        if (!this.server || !envelope.tenantId?.trim() || !envelope.topic?.trim()) {
+            return;
+        }
+        const rooms = (0, realtime_rooms_util_1.resolveRealtimeRooms)(envelope.tenantId, envelope.audience);
+        if (!rooms.length) {
+            return;
+        }
+        for (const room of rooms) {
+            this.server.to(room).emit(realtime_topics_1.AXP_REALTIME_SOCKET_EVENT, envelope);
+        }
+    }
+};
+exports.SocketIoRealtimeDelivery = SocketIoRealtimeDelivery;
+exports.SocketIoRealtimeDelivery = SocketIoRealtimeDelivery = SocketIoRealtimeDelivery_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], SocketIoRealtimeDelivery);
+//#endregion
+//# sourceMappingURL=socket-io-realtime.delivery.js.map

package/realtime/src/lib/delivery/socket-io-realtime.delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-realtime.delivery.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/delivery/socket-io-realtime.delivery.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AAEpD,4EAAuE;AACvE,sEAAoE;AACpE,+DAAsE;AAGtE,iDAAiD;AAEjD;;;GAGG;AAEI,IAAM,wBAAwB,gCAA9B,MAAM,wBAAyB,SAAQ,6CAAoB;IAA3D;;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,0BAAwB,CAAC,IAAI,CAAC,CAAC;QAC5D,WAAM,GAAkB,IAAI,CAAC;IAqBvC,CAAC;IAnBC,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,QAA6B;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,0CAAoB,EAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2CAAyB,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF,CAAA;AAvBY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;GACA,wBAAwB,CAuBpC;AAED,YAAY"}