@acorex-platform/framework-server 0.0.10 → 0.0.15

package/realtime/src/lib/ports/realtime-transport.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-transport.port.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/ports/realtime-transport.port.ts"],"names":[],"mappings":";;;AAMA;;;GAGG;AACH,MAAsB,qBAAqB;CAI1C;AAJD,sDAIC;AAED,YAAY"}

package/realtime/src/lib/realtime-redis.config.d.ts

@@ -0,0 +1,13 @@
+export type RealtimeRedisConnection = {
+    host: string;
+    port: number;
+} | {
+    url: string;
+} | null;
+/**
+ * Resolves Redis for realtime pub/sub.
+ * Same environment contract as background-job (`REDIS_URL` or `REDIS_HOST`/`REDIS_PORT`).
+ * Returns null when Redis is not configured — transport falls back to in-process.
+ */
+export declare function resolveRealtimeRedisConnection(): RealtimeRedisConnection;
+//# sourceMappingURL=realtime-redis.config.d.ts.map

package/realtime/src/lib/realtime-redis.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-redis.config.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/realtime/src/lib/realtime-redis.config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,uBAAuB,CAaxE"}

package/realtime/src/lib/realtime-redis.config.js

@@ -0,0 +1,23 @@
+"use strict";
+//#region ---- Redis connection for realtime ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRealtimeRedisConnection = resolveRealtimeRedisConnection;
+/**
+ * Resolves Redis for realtime pub/sub.
+ * Same environment contract as background-job (`REDIS_URL` or `REDIS_HOST`/`REDIS_PORT`).
+ * Returns null when Redis is not configured — transport falls back to in-process.
+ */
+function resolveRealtimeRedisConnection() {
+    const url = process.env['REDIS_URL']?.trim();
+    if (url) {
+        return { url };
+    }
+    const host = process.env['REDIS_HOST']?.trim();
+    const portRaw = Number(process.env['REDIS_PORT'] ?? 6379);
+    if (host) {
+        return { host, port: Number.isFinite(portRaw) ? portRaw : 6379 };
+    }
+    return null;
+}
+//#endregion
+//# sourceMappingURL=realtime-redis.config.js.map

package/realtime/src/lib/realtime-redis.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-redis.config.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/realtime/src/lib/realtime-redis.config.ts"],"names":[],"mappings":";AAAA,iDAAiD;;AASjD,wEAaC;AAlBD;;;;GAIG;AACH,SAAgB,8BAA8B;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,YAAY"}

package/realtime/src/lib/realtime.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule } from '@nestjs/common';
+import type { RealtimeEntityBridgeRegistration } from './entity-bridge/realtime-entity-bridge.types';
+import { type RealtimeRedisConnection } from './realtime-redis.config';
+export interface RealtimeModuleOptions {
+    /** Explicit Redis connection; defaults to `REDIS_URL` / `REDIS_HOST` env vars. */
+    readonly redis?: RealtimeRedisConnection;
+    /** Optional allowlist seed; feature modules may also call {@link provideRealtimeEntityBridge}. */
+    readonly entityBridges?: readonly RealtimeEntityBridgeRegistration[];
+}
+export declare class RealtimeModule {
+    static forRoot(options?: RealtimeModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=realtime.module.d.ts.map

package/realtime/src/lib/realtime.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.module.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/realtime/src/lib/realtime.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiC,MAAM,gBAAgB,CAAC;AAI9E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAKrG,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAOjC,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IACzC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;CACtE;AAMD,qBAEa,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa;CAgDnE"}

package/realtime/src/lib/realtime.module.js

@@ -0,0 +1,73 @@
+"use strict";
+var RealtimeModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const security_1 = require("@acorex-platform/framework-server/security");
+const realtime_entity_bridge_listener_1 = require("./entity-bridge/realtime-entity-bridge.listener");
+const realtime_entity_bridge_registry_1 = require("./entity-bridge/realtime-entity-bridge.registry");
+const realtime_gateway_1 = require("./gateway/realtime.gateway");
+const realtime_conversation_membership_registry_1 = require("./ports/realtime-conversation-membership.registry");
+const realtime_publisher_port_1 = require("./ports/realtime-publisher.port");
+const realtime_transport_port_1 = require("./ports/realtime-transport.port");
+const realtime_redis_config_1 = require("./realtime-redis.config");
+const realtime_publisher_service_1 = require("./services/realtime-publisher.service");
+const in_process_transport_1 = require("./transports/in-process.transport");
+const redis_pubsub_transport_1 = require("./transports/redis-pubsub.transport");
+//#endregion
+//#region ---- Realtime module ----
+let RealtimeModule = RealtimeModule_1 = class RealtimeModule {
+    static forRoot(options = {}) {
+        const connection = options.redis !== undefined ? options.redis : (0, realtime_redis_config_1.resolveRealtimeRedisConnection)();
+        const transportProvider = connection
+            ? {
+                provide: realtime_transport_port_1.RealtimeTransportPort,
+                useFactory: () => new redis_pubsub_transport_1.RedisPubSubRealtimeTransport(connection),
+            }
+            : {
+                provide: realtime_transport_port_1.RealtimeTransportPort,
+                useClass: in_process_transport_1.InProcessRealtimeTransport,
+            };
+        const bridgeSeed = {
+            provide: 'AXP_REALTIME_ENTITY_BRIDGE_SEED',
+            useFactory: (registry) => {
+                for (const registration of options.entityBridges ?? []) {
+                    registry.register(registration);
+                }
+                return true;
+            },
+            inject: [realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry],
+        };
+        return {
+            module: RealtimeModule_1,
+            imports: [security_1.SecurityModule],
+            providers: [
+                transportProvider,
+                realtime_publisher_service_1.RealtimePublisherService,
+                {
+                    provide: realtime_publisher_port_1.RealtimePublisherPort,
+                    useExisting: realtime_publisher_service_1.RealtimePublisherService,
+                },
+                realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry,
+                realtime_conversation_membership_registry_1.RealtimeConversationMembershipRegistry,
+                bridgeSeed,
+                realtime_gateway_1.RealtimeGateway,
+                realtime_entity_bridge_listener_1.RealtimeEntityBridgeListener,
+            ],
+            exports: [
+                realtime_publisher_port_1.RealtimePublisherPort,
+                realtime_transport_port_1.RealtimeTransportPort,
+                realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry,
+                realtime_conversation_membership_registry_1.RealtimeConversationMembershipRegistry,
+            ],
+        };
+    }
+};
+exports.RealtimeModule = RealtimeModule;
+exports.RealtimeModule = RealtimeModule = RealtimeModule_1 = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], RealtimeModule);
+//#endregion
+//# sourceMappingURL=realtime.module.js.map

package/realtime/src/lib/realtime.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.module.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/realtime/src/lib/realtime.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAA8E;AAC9E,yEAA4E;AAC5E,qGAA+F;AAC/F,qGAA+F;AAE/F,iEAA6D;AAC7D,iHAA2G;AAC3G,6EAAwE;AACxE,6EAAwE;AACxE,mEAGiC;AACjC,sFAAiF;AACjF,4EAA+E;AAC/E,gFAAmF;AAWnF,YAAY;AAEZ,mCAAmC;AAI5B,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,sDAA8B,GAAE,CAAC;QAElG,MAAM,iBAAiB,GAAa,UAAU;YAC5C,CAAC,CAAC;gBACE,OAAO,EAAE,+CAAqB;gBAC9B,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,qDAA4B,CAAC,UAAU,CAAC;aAC/D;YACH,CAAC,CAAC;gBACE,OAAO,EAAE,+CAAqB;gBAC9B,QAAQ,EAAE,iDAA0B;aACrC,CAAC;QAEN,MAAM,UAAU,GAAa;YAC3B,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,CAAC,QAAsC,EAAE,EAAE;gBACrD,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;oBACvD,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAClC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,EAAE,CAAC,8DAA4B,CAAC;SACvC,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,OAAO,EAAE,CAAC,yBAAc,CAAC;YACzB,SAAS,EAAE;gBACT,iBAAiB;gBACjB,qDAAwB;gBACxB;oBACE,OAAO,EAAE,+CAAqB;oBAC9B,WAAW,EAAE,qDAAwB;iBACtC;gBACD,8DAA4B;gBAC5B,kFAAsC;gBACtC,UAAU;gBACV,kCAAe;gBACf,8DAA4B;aAC7B;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,+CAAqB;gBACrB,8DAA4B;gBAC5B,kFAAsC;aACvC;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAjDY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAiD1B;AAED,YAAY"}

package/realtime/src/lib/rooms/realtime-rooms.util.d.ts

@@ -0,0 +1,10 @@
+export declare function realtimeUserRoom(tenantId: string, userId: string): string;
+export declare function realtimeConversationRoom(tenantId: string, conversationId: string): string;
+/** All users connected under the same tenant (entity list fan-out). */
+export declare function realtimeTenantRoom(tenantId: string): string;
+export declare function resolveRealtimeRooms(tenantId: string, audience: {
+    userIds?: string[];
+    conversationId?: string;
+    tenant?: boolean;
+}): string[];
+//# sourceMappingURL=realtime-rooms.util.d.ts.map

package/realtime/src/lib/rooms/realtime-rooms.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-rooms.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/rooms/realtime-rooms.util.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1E,MAAM,EAAE,CAgBV"}

package/realtime/src/lib/rooms/realtime-rooms.util.js

@@ -0,0 +1,38 @@
+"use strict";
+//#region ---- Socket.IO room helpers ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.realtimeUserRoom = realtimeUserRoom;
+exports.realtimeConversationRoom = realtimeConversationRoom;
+exports.realtimeTenantRoom = realtimeTenantRoom;
+exports.resolveRealtimeRooms = resolveRealtimeRooms;
+// TODO(realtime): Generalize conversation-scoped rooms to refType/refId scoped rooms
+// (e.g. t:{tenantId}:{refType}:{refId}) + per-module subscription providers; see AXPRealtimeAudience.
+function realtimeUserRoom(tenantId, userId) {
+    return `t:${tenantId}:u:${userId}`;
+}
+function realtimeConversationRoom(tenantId, conversationId) {
+    return `t:${tenantId}:c:${conversationId}`;
+}
+/** All users connected under the same tenant (entity list fan-out). */
+function realtimeTenantRoom(tenantId) {
+    return `t:${tenantId}`;
+}
+function resolveRealtimeRooms(tenantId, audience) {
+    const rooms = new Set();
+    if (audience.tenant === true) {
+        rooms.add(realtimeTenantRoom(tenantId));
+    }
+    for (const userId of audience.userIds ?? []) {
+        const trimmed = userId.trim();
+        if (trimmed) {
+            rooms.add(realtimeUserRoom(tenantId, trimmed));
+        }
+    }
+    const conversationId = audience.conversationId?.trim();
+    if (conversationId) {
+        rooms.add(realtimeConversationRoom(tenantId, conversationId));
+    }
+    return Array.from(rooms);
+}
+//#endregion
+//# sourceMappingURL=realtime-rooms.util.js.map

package/realtime/src/lib/rooms/realtime-rooms.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-rooms.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/rooms/realtime-rooms.util.ts"],"names":[],"mappings":";AAAA,0CAA0C;;AAK1C,4CAEC;AAED,4DAEC;AAGD,gDAEC;AAED,oDAmBC;AAnCD,qFAAqF;AACrF,sGAAsG;AAEtG,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,MAAc;IAC/D,OAAO,KAAK,QAAQ,MAAM,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,SAAgB,wBAAwB,CAAC,QAAgB,EAAE,cAAsB;IAC/E,OAAO,KAAK,QAAQ,MAAM,cAAc,EAAE,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,OAAO,KAAK,QAAQ,EAAE,CAAC;AACzB,CAAC;AAED,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,QAA2E;IAE3E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,YAAY"}

package/realtime/src/lib/services/realtime-publisher.service.d.ts

@@ -0,0 +1,10 @@
+import { RealtimePublisherPort } from '../ports/realtime-publisher.port';
+import { RealtimeTransportPort } from '../ports/realtime-transport.port';
+import type { AXPRealtimeEnvelope, AXPRealtimePublishInput } from '../types/realtime.types';
+export declare class RealtimePublisherService extends RealtimePublisherPort {
+    private readonly transport;
+    private readonly logger;
+    constructor(transport: RealtimeTransportPort);
+    publish(input: AXPRealtimePublishInput): Promise<AXPRealtimeEnvelope>;
+}
+//# sourceMappingURL=realtime-publisher.service.d.ts.map

package/realtime/src/lib/services/realtime-publisher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-publisher.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/services/realtime-publisher.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAI5F,qBACa,wBAAyB,SAAQ,qBAAqB;IAGrD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;gBAEvC,SAAS,EAAE,qBAAqB;IAIvD,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAqC5E"}

package/realtime/src/lib/services/realtime-publisher.service.js

@@ -0,0 +1,56 @@
+"use strict";
+var RealtimePublisherService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimePublisherService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const realtime_publisher_port_1 = require("../ports/realtime-publisher.port");
+const realtime_transport_port_1 = require("../ports/realtime-transport.port");
+//#region ---- Publisher service ----
+let RealtimePublisherService = RealtimePublisherService_1 = class RealtimePublisherService extends realtime_publisher_port_1.RealtimePublisherPort {
+    constructor(transport) {
+        super();
+        this.transport = transport;
+        this.logger = new common_1.Logger(RealtimePublisherService_1.name);
+    }
+    async publish(input) {
+        const tenantId = input.tenantId?.trim() ?? '';
+        const topic = input.topic?.trim() ?? '';
+        if (!tenantId || !topic) {
+            throw new Error('Realtime publish requires tenantId and topic');
+        }
+        const audience = {
+            userIds: (input.audience.userIds ?? []).map((id) => id.trim()).filter(Boolean),
+            conversationId: input.audience.conversationId?.trim() || undefined,
+            tenant: input.audience.tenant === true,
+        };
+        if (!audience.userIds.length && !audience.conversationId && !audience.tenant) {
+            this.logger.debug(`Skipping realtime publish for topic ${topic}: empty audience`);
+            return {
+                topic,
+                tenantId,
+                audience,
+                payload: input.payload ?? {},
+                correlationId: input.correlationId,
+                emittedAt: new Date().toISOString(),
+            };
+        }
+        const envelope = {
+            topic,
+            tenantId,
+            audience,
+            payload: input.payload ?? {},
+            correlationId: input.correlationId,
+            emittedAt: new Date().toISOString(),
+        };
+        await this.transport.publish(envelope);
+        return envelope;
+    }
+};
+exports.RealtimePublisherService = RealtimePublisherService;
+exports.RealtimePublisherService = RealtimePublisherService = RealtimePublisherService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [realtime_transport_port_1.RealtimeTransportPort])
+], RealtimePublisherService);
+//#endregion
+//# sourceMappingURL=realtime-publisher.service.js.map

package/realtime/src/lib/services/realtime-publisher.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-publisher.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/services/realtime-publisher.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,8EAAyE;AACzE,8EAAyE;AAGzE,qCAAqC;AAG9B,IAAM,wBAAwB,gCAA9B,MAAM,wBAAyB,SAAQ,+CAAqB;IAGjE,YAA6B,SAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,cAAS,GAAT,SAAS,CAAuB;QAF5C,WAAM,GAAG,IAAI,eAAM,CAAC,0BAAwB,CAAC,IAAI,CAAC,CAAC;IAIpE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC9E,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,SAAS;YAClE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI;SACvC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,KAAK,kBAAkB,CAAC,CAAC;YAClF,OAAO;gBACL,KAAK;gBACL,QAAQ;gBACR,QAAQ;gBACR,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;gBAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAwB;YACpC,KAAK;YACL,QAAQ;YACR,QAAQ;YACR,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAA;AA5CY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;6CAI6B,+CAAqB;GAHlD,wBAAwB,CA4CpC;AAED,YAAY"}

package/realtime/src/lib/topics/realtime-topics.d.ts

@@ -0,0 +1,9 @@
+export declare const AXP_REALTIME_TOPIC_INBOX_REFRESH = "inbox.refresh";
+export declare const AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE = "conversation.message";
+export declare const AXP_REALTIME_TOPIC_ENTITY_MUTATION = "entity.mutation";
+export declare const AXP_REALTIME_SOCKET_EVENT = "realtime";
+export declare const AXP_REALTIME_SUBSCRIBE_CONVERSATION = "subscribe.conversation";
+export declare const AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = "unsubscribe.conversation";
+/** Redis pub/sub channel for cross-instance fan-out. */
+export declare const AXP_REALTIME_REDIS_CHANNEL = "acx:realtime:events";
+//# sourceMappingURL=realtime-topics.d.ts.map

package/realtime/src/lib/topics/realtime-topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-topics.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/topics/realtime-topics.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC,kBAAkB,CAAC;AAChE,eAAO,MAAM,uCAAuC,yBAAyB,CAAC;AAC9E,eAAO,MAAM,kCAAkC,oBAAoB,CAAC;AAEpE,eAAO,MAAM,yBAAyB,aAAa,CAAC;AACpD,eAAO,MAAM,mCAAmC,2BAA2B,CAAC;AAC5E,eAAO,MAAM,qCAAqC,6BAA6B,CAAC;AAEhF,wDAAwD;AACxD,eAAO,MAAM,0BAA0B,wBAAwB,CAAC"}

package/realtime/src/lib/topics/realtime-topics.js

@@ -0,0 +1,14 @@
+"use strict";
+//#region ---- Realtime topic constants ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_REALTIME_REDIS_CHANNEL = exports.AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = exports.AXP_REALTIME_SUBSCRIBE_CONVERSATION = exports.AXP_REALTIME_SOCKET_EVENT = exports.AXP_REALTIME_TOPIC_ENTITY_MUTATION = exports.AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE = exports.AXP_REALTIME_TOPIC_INBOX_REFRESH = void 0;
+exports.AXP_REALTIME_TOPIC_INBOX_REFRESH = 'inbox.refresh';
+exports.AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE = 'conversation.message';
+exports.AXP_REALTIME_TOPIC_ENTITY_MUTATION = 'entity.mutation';
+exports.AXP_REALTIME_SOCKET_EVENT = 'realtime';
+exports.AXP_REALTIME_SUBSCRIBE_CONVERSATION = 'subscribe.conversation';
+exports.AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = 'unsubscribe.conversation';
+/** Redis pub/sub channel for cross-instance fan-out. */
+exports.AXP_REALTIME_REDIS_CHANNEL = 'acx:realtime:events';
+//#endregion
+//# sourceMappingURL=realtime-topics.js.map

package/realtime/src/lib/topics/realtime-topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-topics.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/topics/realtime-topics.ts"],"names":[],"mappings":";AAAA,4CAA4C;;;AAE/B,QAAA,gCAAgC,GAAG,eAAe,CAAC;AACnD,QAAA,uCAAuC,GAAG,sBAAsB,CAAC;AACjE,QAAA,kCAAkC,GAAG,iBAAiB,CAAC;AAEvD,QAAA,yBAAyB,GAAG,UAAU,CAAC;AACvC,QAAA,mCAAmC,GAAG,wBAAwB,CAAC;AAC/D,QAAA,qCAAqC,GAAG,0BAA0B,CAAC;AAEhF,wDAAwD;AAC3C,QAAA,0BAA0B,GAAG,qBAAqB,CAAC;AAEhE,YAAY"}

package/realtime/src/lib/transports/in-process.transport.d.ts

@@ -0,0 +1,9 @@
+import { RealtimeTransportPort, type RealtimeEnvelopeHandler } from '../ports/realtime-transport.port';
+import type { AXPRealtimeEnvelope } from '../types/realtime.types';
+export declare class InProcessRealtimeTransport extends RealtimeTransportPort {
+    private readonly handlers;
+    publish(envelope: AXPRealtimeEnvelope): Promise<void>;
+    subscribe(handler: RealtimeEnvelopeHandler): void;
+    unsubscribe(handler: RealtimeEnvelopeHandler): void;
+}
+//# sourceMappingURL=in-process.transport.d.ts.map

package/realtime/src/lib/transports/in-process.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.transport.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/transports/in-process.transport.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,qBACa,0BAA2B,SAAQ,qBAAqB;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAEzD,OAAO,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIjD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;CAGpD"}

package/realtime/src/lib/transports/in-process.transport.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InProcessRealtimeTransport = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const realtime_transport_port_1 = require("../ports/realtime-transport.port");
+//#region ---- In-process transport ----
+let InProcessRealtimeTransport = class InProcessRealtimeTransport extends realtime_transport_port_1.RealtimeTransportPort {
+    constructor() {
+        super(...arguments);
+        this.handlers = new Set();
+    }
+    async publish(envelope) {
+        for (const handler of this.handlers) {
+            await handler(envelope);
+        }
+    }
+    subscribe(handler) {
+        this.handlers.add(handler);
+    }
+    unsubscribe(handler) {
+        this.handlers.delete(handler);
+    }
+};
+exports.InProcessRealtimeTransport = InProcessRealtimeTransport;
+exports.InProcessRealtimeTransport = InProcessRealtimeTransport = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], InProcessRealtimeTransport);
+//#endregion
+//# sourceMappingURL=in-process.transport.js.map

package/realtime/src/lib/transports/in-process.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.transport.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/transports/in-process.transport.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,8EAG0C;AAG1C,wCAAwC;AAGjC,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,+CAAqB;IAA9D;;QACY,aAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAejE,CAAC;IAbC,KAAK,CAAC,OAAO,CAAC,QAA6B;QACzC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAAgC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,WAAW,CAAC,OAAgC;QAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AAhBY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;GACA,0BAA0B,CAgBtC;AAED,YAAY"}

package/realtime/src/lib/transports/redis-pubsub.transport.d.ts

@@ -0,0 +1,18 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { RealtimeTransportPort, type RealtimeEnvelopeHandler } from '../ports/realtime-transport.port';
+import type { RealtimeRedisConnection } from '../realtime-redis.config';
+import type { AXPRealtimeEnvelope } from '../types/realtime.types';
+export declare class RedisPubSubRealtimeTransport extends RealtimeTransportPort implements OnModuleDestroy {
+    private readonly logger;
+    private readonly publisher;
+    private readonly subscriber;
+    private readonly handlers;
+    private readonly onMessage;
+    constructor(connection: Exclude<RealtimeRedisConnection, null>);
+    publish(envelope: AXPRealtimeEnvelope): Promise<void>;
+    subscribe(handler: RealtimeEnvelopeHandler): void;
+    unsubscribe(handler: RealtimeEnvelopeHandler): void;
+    onModuleDestroy(): Promise<void>;
+    private dispatch;
+}
+//# sourceMappingURL=redis-pubsub.transport.d.ts.map

package/realtime/src/lib/transports/redis-pubsub.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-pubsub.transport.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/transports/redis-pubsub.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,EACL,qBAAqB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAenE,qBACa,4BAA6B,SAAQ,qBAAsB,YAAW,eAAe;IAChG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAExB;gBAEU,UAAU,EAAE,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC;IAWxD,OAAO,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIjD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAI7C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;YAKxB,QAAQ;CAkBvB"}

package/realtime/src/lib/transports/redis-pubsub.transport.js

@@ -0,0 +1,76 @@
+"use strict";
+var RedisPubSubRealtimeTransport_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisPubSubRealtimeTransport = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
+const realtime_transport_port_1 = require("../ports/realtime-transport.port");
+const realtime_topics_1 = require("../topics/realtime-topics");
+//#region ---- Redis pub/sub transport ----
+function createRedisClient(connection) {
+    if ('url' in connection) {
+        return new ioredis_1.default(connection.url, { maxRetriesPerRequest: null });
+    }
+    return new ioredis_1.default({
+        host: connection.host,
+        port: connection.port,
+        maxRetriesPerRequest: null,
+    });
+}
+let RedisPubSubRealtimeTransport = RedisPubSubRealtimeTransport_1 = class RedisPubSubRealtimeTransport extends realtime_transport_port_1.RealtimeTransportPort {
+    constructor(connection) {
+        super();
+        this.logger = new common_1.Logger(RedisPubSubRealtimeTransport_1.name);
+        this.handlers = new Set();
+        this.onMessage = (_channel, raw) => {
+            void this.dispatch(raw);
+        };
+        this.publisher = createRedisClient(connection);
+        this.subscriber = createRedisClient(connection);
+        void this.subscriber.subscribe(realtime_topics_1.AXP_REALTIME_REDIS_CHANNEL).catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to subscribe Redis realtime channel: ${message}`);
+        });
+        this.subscriber.on('message', this.onMessage);
+    }
+    async publish(envelope) {
+        await this.publisher.publish(realtime_topics_1.AXP_REALTIME_REDIS_CHANNEL, JSON.stringify(envelope));
+    }
+    subscribe(handler) {
+        this.handlers.add(handler);
+    }
+    unsubscribe(handler) {
+        this.handlers.delete(handler);
+    }
+    async onModuleDestroy() {
+        this.subscriber.off('message', this.onMessage);
+        await Promise.allSettled([this.subscriber.quit(), this.publisher.quit()]);
+    }
+    async dispatch(raw) {
+        let envelope;
+        try {
+            envelope = JSON.parse(raw);
+        }
+        catch {
+            this.logger.warn('Ignored invalid realtime Redis payload');
+            return;
+        }
+        for (const handler of this.handlers) {
+            try {
+                await handler(envelope);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Realtime handler failed: ${message}`);
+            }
+        }
+    }
+};
+exports.RedisPubSubRealtimeTransport = RedisPubSubRealtimeTransport;
+exports.RedisPubSubRealtimeTransport = RedisPubSubRealtimeTransport = RedisPubSubRealtimeTransport_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], RedisPubSubRealtimeTransport);
+//#endregion
+//# sourceMappingURL=redis-pubsub.transport.js.map

package/realtime/src/lib/transports/redis-pubsub.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-pubsub.transport.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/transports/redis-pubsub.transport.ts"],"names":[],"mappings":"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"}

package/realtime/src/lib/types/realtime.types.d.ts

@@ -0,0 +1,40 @@
+export interface AXPRealtimeAudience {
+    userIds?: string[];
+    conversationId?: string;
+    /** When true, deliver to all connected users in the envelope tenant. */
+    tenant?: boolean;
+}
+export interface AXPRealtimeEnvelope {
+    topic: string;
+    tenantId: string;
+    audience: AXPRealtimeAudience;
+    payload: unknown;
+    correlationId?: string;
+    emittedAt: string;
+}
+export interface AXPRealtimePublishInput {
+    topic: string;
+    tenantId: string;
+    audience: AXPRealtimeAudience;
+    payload?: unknown;
+    correlationId?: string;
+}
+export interface AXPRealtimeSocketSession {
+    userId: string;
+    tenantId: string;
+    username?: string;
+}
+export interface AXPRealtimeInboxRefreshPayload {
+    deliveryId?: string;
+}
+export interface AXPRealtimeConversationMessagePayload {
+    conversationId: string;
+    messageId: string;
+    op: 'created' | 'updated' | 'deleted';
+}
+export interface AXPRealtimeEntityMutationPayload {
+    entityName: string;
+    operation: 'created' | 'updated' | 'deleted';
+    id?: string;
+}
+//# sourceMappingURL=realtime.types.d.ts.map

package/realtime/src/lib/types/realtime.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/types/realtime.types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAInB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}

package/realtime/src/lib/types/realtime.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- Realtime envelope types ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=realtime.types.js.map

package/realtime/src/lib/types/realtime.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/types/realtime.types.ts"],"names":[],"mappings":";AAAA,2CAA2C;;AAmD3C,YAAY"}

package/report/src/index.d.ts

@@ -6,3 +6,4 @@ export * from './lib/report-query.registry';
 export * from './lib/report-definition.registry';
 export * from './lib/report.util';
 export * from './lib/report-summary.util';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/report/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}

package/report/src/lib/report-definition.registry.d.ts

@@ -18,3 +18,4 @@ export declare class BackendReportDefinitionRegistry implements OnApplicationBoo
     private isDefinitionProvider;
     private upsertDefinition;
 }
+//# sourceMappingURL=report-definition.registry.d.ts.map

package/report/src/lib/report-definition.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-definition.registry.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-definition.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAaxF;;;GAGG;AACH,qBACa,+BAAgC,YAAW,sBAAsB;IAK1E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,MAAM,CAAS;gBAGJ,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,8BAA8B;IAGpD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDtC,OAAO,CAAC,0BAA0B;IAiClC,OAAO,CAAC,oBAAoB;YAKd,gBAAgB;CAsC/B"}

package/report/src/lib/report-execute.service.d.ts

@@ -12,3 +12,4 @@ export declare class ReportExecuteService {
     execute(body: ReportExecuteBodyDto): Promise<ReportExecuteResponseDto>;
     private buildQueryInput;
 }
+//# sourceMappingURL=report-execute.service.d.ts.map

package/report/src/lib/report-execute.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-execute.service.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-execute.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAMrE,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAGzB,MAAM,gBAAgB,CAAC;AAKxB;;;GAGG;AACH,qBACa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,OAAO,EAAE,8BAA8B,EACvC,aAAa,EAAE,0BAA0B;IAGtD,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA8D5E,OAAO,CAAC,eAAe;CA6CxB"}

package/report/src/lib/report-query.registry.d.ts

@@ -17,3 +17,4 @@ export declare class BackendReportQueryRegistry implements OnApplicationBootstra
     run(name: string, input: ReportQueryInput): Promise<ReportQueryResult>;
     private isQueryHandler;
 }
+//# sourceMappingURL=report-query.registry.d.ts.map

package/report/src/lib/report-query.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-query.registry.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-query.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAA6B,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIrG;;;GAGG;AACH,qBACa,0BAA2B,YAAW,sBAAsB;IAKrE,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAGtD,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,SAAS;IAGvC,sBAAsB,IAAI,IAAI;IAkC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIV,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAU5E,OAAO,CAAC,cAAc;CAIvB"}

package/report/src/lib/report-result-normalizer.d.ts

@@ -4,3 +4,4 @@
 export declare function normalizeTableResult(result: unknown): Record<string, unknown>;
 export declare function normalizeChartResult(result: unknown, mapping?: Record<string, unknown>): Record<string, unknown>;
 export declare function normalizePdfResult(result: unknown): Record<string, unknown>;
+//# sourceMappingURL=report-result-normalizer.d.ts.map

package/report/src/lib/report-result-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-result-normalizer.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-result-normalizer.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwB7E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyDhH;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB3E"}

package/report/src/lib/report-summary.util.d.ts

@@ -7,3 +7,4 @@ export interface ReportSummarySpec {
  * Computes server-side report footer totals over the full filtered dataset (before pagination).
  */
 export declare function computeReportFooterSummary(rows: Record<string, unknown>[], summaryConfig: ReportSummarySpec[] | undefined): Record<string, number | null> | undefined;
+//# sourceMappingURL=report-summary.util.d.ts.map

package/report/src/lib/report-summary.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-summary.util.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-summary.util.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,aAAa,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAa3C"}

package/report/src/lib/report.decorators.d.ts

@@ -4,3 +4,4 @@ export declare const REPORT_DEFINITION_PROVIDER_METADATA: unique symbol;
 export declare const ReportQuery: () => import("@nestjs/common").CustomDecorator<typeof REPORT_QUERY_METADATA>;
 /** Marks an injectable class as a report definition provider (implements {@link BackendReportDefinitionProvider}). */
 export declare const ReportDefinitionProvider: () => import("@nestjs/common").CustomDecorator<typeof REPORT_DEFINITION_PROVIDER_METADATA>;
+//# sourceMappingURL=report.decorators.d.ts.map

package/report/src/lib/report.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.decorators.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report.decorators.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,eAAyB,CAAC;AAC5D,eAAO,MAAM,mCAAmC,eAAuC,CAAC;AAExF,0GAA0G;AAC1G,eAAO,MAAM,WAAW,8EAAiD,CAAC;AAE1E,sHAAsH;AACtH,eAAO,MAAM,wBAAwB,4FAA+D,CAAC"}