@acorex-platform/framework-server 0.0.18 → 0.0.20

package/realtime/src/lib/presence/user-presence.compose.d.ts

@@ -0,0 +1,6 @@
+import type { AXPUserPresenceAvailability, AXPUserPresenceOccupancy, AXPUserPresenceOverlay, AXPUserPresenceSource, AXPUserPresenceStatus } from './user-presence.types';
+export declare function composePresenceStatus(occupancy: AXPUserPresenceOccupancy, overlay: AXPUserPresenceOverlay | undefined): AXPUserPresenceStatus;
+export declare function shouldApplyAvailabilityChange(current: AXPUserPresenceOverlay | undefined, source: AXPUserPresenceSource): boolean;
+export declare function overlayAfterOffline(overlay: AXPUserPresenceOverlay | undefined): AXPUserPresenceOverlay;
+export declare function availabilityFromSetStatus(status: AXPUserPresenceStatus): AXPUserPresenceAvailability | undefined;
+//# sourceMappingURL=user-presence.compose.d.ts.map

package/realtime/src/lib/presence/user-presence.compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence.compose.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence.compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAI/B,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,wBAAwB,EACnC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,qBAAqB,CAWvB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,GAAG,SAAS,EAC3C,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAKT;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAC1C,sBAAsB,CAKxB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,GAC5B,2BAA2B,GAAG,SAAS,CAQzC"}

package/realtime/src/lib/presence/user-presence.compose.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composePresenceStatus = composePresenceStatus;
+exports.shouldApplyAvailabilityChange = shouldApplyAvailabilityChange;
+exports.overlayAfterOffline = overlayAfterOffline;
+exports.availabilityFromSetStatus = availabilityFromSetStatus;
+//#region ----- Presence compose -----
+function composePresenceStatus(occupancy, overlay) {
+    if (occupancy === 'offline') {
+        return 'offline';
+    }
+    if (overlay?.availability === 'busy') {
+        return 'busy';
+    }
+    if (overlay?.availability === 'away') {
+        return 'away';
+    }
+    return 'online';
+}
+function shouldApplyAvailabilityChange(current, source) {
+    if (source === 'manual') {
+        return true;
+    }
+    return !(current?.source === 'manual' && current.availability !== 'available');
+}
+function overlayAfterOffline(overlay) {
+    if (!overlay || overlay.source === 'auto') {
+        return { availability: 'available', source: 'auto' };
+    }
+    return overlay;
+}
+function availabilityFromSetStatus(status) {
+    if (status === 'online') {
+        return 'available';
+    }
+    if (status === 'away' || status === 'busy') {
+        return status;
+    }
+    return undefined;
+}
+//#endregion
+//# sourceMappingURL=user-presence.compose.js.map

package/realtime/src/lib/presence/user-presence.compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence.compose.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence.compose.ts"],"names":[],"mappings":";;AAUA,sDAcC;AAED,sEAQC;AAED,kDAOC;AAED,8DAUC;AA/CD,sCAAsC;AAEtC,SAAgB,qBAAqB,CACnC,SAAmC,EACnC,OAA2C;IAE3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,6BAA6B,CAC3C,OAA2C,EAC3C,MAA6B;IAE7B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,YAAY,KAAK,WAAW,CAAC,CAAC;AACjF,CAAC;AAED,SAAgB,mBAAmB,CACjC,OAA2C;IAE3C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,yBAAyB,CACvC,MAA6B;IAE7B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,YAAY"}

package/realtime/src/lib/presence/user-presence.constants.d.ts

@@ -0,0 +1,11 @@
+export declare const AXP_USER_PRESENCE_GRACE_MS = 8000;
+/** Redis key prefix for presence occupancy / overlays / watchers. */
+export declare const AXP_USER_PRESENCE_REDIS_PREFIX = "acx:presence";
+/** Client idle → Away (matches client idle service). */
+export declare const AXP_USER_PRESENCE_IDLE_MS: number;
+/**
+ * Socket membership older than this is treated as dead (crash / missed disconnect).
+ * Gateway refreshes touches while the socket stays connected.
+ */
+export declare const AXP_USER_PRESENCE_SOCKET_STALE_MS = 120000;
+//# sourceMappingURL=user-presence.constants.d.ts.map

package/realtime/src/lib/presence/user-presence.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence.constants.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAE7D,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,QAAa,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,iCAAiC,SAAU,CAAC"}

package/realtime/src/lib/presence/user-presence.constants.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_USER_PRESENCE_SOCKET_STALE_MS = exports.AXP_USER_PRESENCE_IDLE_MS = exports.AXP_USER_PRESENCE_REDIS_PREFIX = exports.AXP_USER_PRESENCE_GRACE_MS = void 0;
+exports.AXP_USER_PRESENCE_GRACE_MS = 8_000;
+/** Redis key prefix for presence occupancy / overlays / watchers. */
+exports.AXP_USER_PRESENCE_REDIS_PREFIX = 'acx:presence';
+/** Client idle → Away (matches client idle service). */
+exports.AXP_USER_PRESENCE_IDLE_MS = 5 * 60_000;
+/**
+ * Socket membership older than this is treated as dead (crash / missed disconnect).
+ * Gateway refreshes touches while the socket stays connected.
+ */
+exports.AXP_USER_PRESENCE_SOCKET_STALE_MS = 120_000;
+//# sourceMappingURL=user-presence.constants.js.map

package/realtime/src/lib/presence/user-presence.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence.constants.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG,KAAK,CAAC;AAEhD,qEAAqE;AACxD,QAAA,8BAA8B,GAAG,cAAc,CAAC;AAE7D,wDAAwD;AAC3C,QAAA,yBAAyB,GAAG,CAAC,GAAG,MAAM,CAAC;AAEpD;;;GAGG;AACU,QAAA,iCAAiC,GAAG,OAAO,CAAC"}

package/realtime/src/lib/presence/user-presence.types.d.ts

@@ -0,0 +1,33 @@
+export type AXPUserPresenceOccupancy = 'online' | 'offline';
+export type AXPUserPresenceAvailability = 'available' | 'away' | 'busy';
+export type AXPUserPresenceSource = 'auto' | 'manual';
+export type AXPUserPresenceStatus = 'online' | 'offline' | 'away' | 'busy';
+export interface AXPUserPresenceOverlay {
+    availability: AXPUserPresenceAvailability;
+    source: AXPUserPresenceSource;
+}
+export interface AXPUserPresencePayload {
+    userId: string;
+    status: AXPUserPresenceStatus;
+    lastSeen?: string;
+    since?: string;
+    source?: AXPUserPresenceSource;
+}
+export interface AXPUserPresenceSnapshotItem {
+    userId: string;
+    status: AXPUserPresenceStatus;
+    lastSeen?: string;
+    since?: string;
+    source?: AXPUserPresenceSource;
+}
+export interface AXPUserPresenceSubscribeResult {
+    ok: boolean;
+    reason?: string;
+    items?: AXPUserPresenceSnapshotItem[];
+}
+export interface AXPUserPresenceSetResult {
+    ok: boolean;
+    reason?: string;
+    item?: AXPUserPresenceSnapshotItem;
+}
+//# sourceMappingURL=user-presence.types.d.ts.map

package/realtime/src/lib/presence/user-presence.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence.types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAExE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC"}

package/realtime/src/lib/presence/user-presence.types.js

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

package/realtime/src/lib/presence/user-presence.types.js.map

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

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

@@ -1,11 +1,27 @@
-import { DynamicModule } from '@nestjs/common';
+import { DynamicModule, type Type } from '@nestjs/common';
 import type { RealtimeEntityBridgeRegistration } from './entity-bridge/realtime-entity-bridge.types';
+import { RealtimeDeliveryPort } from './ports/realtime-delivery.port';
+import { RealtimeTransportPort } from './ports/realtime-transport.port';
 import { type RealtimeRedisConnection } from './realtime-redis.config';
+/**
+ * Built-in backend = Redis|InProcess fan-out + Socket.IO delivery.
+ * Domain code always publishes through {@link RealtimePublisherPort}.
+ */
+export type RealtimeBackendKind = 'builtin';
 export interface RealtimeModuleOptions {
+    /**
+     * Realtime backend. Default `builtin` (Socket.IO + Redis/in-process).
+     * Alternate backends (e.g. LiveKit data channel) can override `transport` / `delivery` providers.
+     */
+    readonly backend?: RealtimeBackendKind;
     /** 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[];
+    /** Override cross-instance fan-out (advanced). */
+    readonly transport?: Type<RealtimeTransportPort>;
+    /** Override client delivery (advanced). */
+    readonly delivery?: Type<RealtimeDeliveryPort>;
 }
 export declare class RealtimeModule {
     static forRoot(options?: RealtimeModuleOptions): DynamicModule;

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

@@ -1 +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"}
+{"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,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAMzF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AAGrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AASjC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IACzC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACrE,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACjD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;CAChD;AAMD,qBAEa,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa;CA2EnE"}

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

@@ -5,13 +5,18 @@ 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 socket_io_realtime_delivery_1 = require("./delivery/socket-io-realtime.delivery");
 const realtime_entity_bridge_listener_1 = require("./entity-bridge/realtime-entity-bridge.listener");
+const realtime_entity_bulk_bridge_listener_1 = require("./entity-bridge/realtime-entity-bulk-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_delivery_port_1 = require("./ports/realtime-delivery.port");
 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 user_presence_tracker_service_1 = require("./presence/user-presence-tracker.service");
+const user_presence_history_registry_1 = require("./presence/user-presence-history.registry");
 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");
@@ -19,16 +24,31 @@ const redis_pubsub_transport_1 = require("./transports/redis-pubsub.transport");
 //#region ---- Realtime module ----
 let RealtimeModule = RealtimeModule_1 = class RealtimeModule {
     static forRoot(options = {}) {
+        const backend = options.backend ?? 'builtin';
+        if (backend !== 'builtin') {
+            throw new Error(`Unsupported realtime backend '${String(backend)}'. Use 'builtin' or custom transport/delivery providers.`);
+        }
         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 transportProvider = options.transport
+            ? { provide: realtime_transport_port_1.RealtimeTransportPort, useClass: options.transport }
+            : 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 deliveryClass = options.delivery ?? socket_io_realtime_delivery_1.SocketIoRealtimeDelivery;
+        const deliveryProviders = deliveryClass === socket_io_realtime_delivery_1.SocketIoRealtimeDelivery
+            ? [
+                socket_io_realtime_delivery_1.SocketIoRealtimeDelivery,
+                { provide: realtime_delivery_port_1.RealtimeDeliveryPort, useExisting: socket_io_realtime_delivery_1.SocketIoRealtimeDelivery },
+            ]
+            : [
+                { provide: realtime_delivery_port_1.RealtimeDeliveryPort, useClass: deliveryClass },
+            ];
         const bridgeSeed = {
             provide: 'AXP_REALTIME_ENTITY_BRIDGE_SEED',
             useFactory: (registry) => {
@@ -39,11 +59,13 @@ let RealtimeModule = RealtimeModule_1 = class RealtimeModule {
             },
             inject: [realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry],
         };
+        const useBuiltinGateway = deliveryClass === socket_io_realtime_delivery_1.SocketIoRealtimeDelivery;
         return {
             module: RealtimeModule_1,
             imports: [security_1.SecurityModule],
             providers: [
                 transportProvider,
+                ...deliveryProviders,
                 realtime_publisher_service_1.RealtimePublisherService,
                 {
                     provide: realtime_publisher_port_1.RealtimePublisherPort,
@@ -51,15 +73,21 @@ let RealtimeModule = RealtimeModule_1 = class RealtimeModule {
                 },
                 realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry,
                 realtime_conversation_membership_registry_1.RealtimeConversationMembershipRegistry,
+                user_presence_history_registry_1.UserPresenceHistoryRegistry,
+                user_presence_tracker_service_1.UserPresenceTrackerService,
                 bridgeSeed,
-                realtime_gateway_1.RealtimeGateway,
+                ...(useBuiltinGateway ? [realtime_gateway_1.RealtimeGateway] : []),
                 realtime_entity_bridge_listener_1.RealtimeEntityBridgeListener,
+                realtime_entity_bulk_bridge_listener_1.RealtimeEntityBulkBridgeListener,
             ],
             exports: [
                 realtime_publisher_port_1.RealtimePublisherPort,
                 realtime_transport_port_1.RealtimeTransportPort,
+                realtime_delivery_port_1.RealtimeDeliveryPort,
                 realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry,
                 realtime_conversation_membership_registry_1.RealtimeConversationMembershipRegistry,
+                user_presence_history_registry_1.UserPresenceHistoryRegistry,
+                user_presence_tracker_service_1.UserPresenceTrackerService,
             ],
         };
     }

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

@@ -1 +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"}
+{"version":3,"file":"realtime.module.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/realtime/src/lib/realtime.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAyF;AACzF,yEAA4E;AAC5E,wFAAkF;AAClF,qGAA+F;AAC/F,+GAAwG;AACxG,qGAA+F;AAE/F,iEAA6D;AAC7D,iHAA2G;AAC3G,2EAAsE;AACtE,6EAAwE;AACxE,6EAAwE;AACxE,mEAGiC;AACjC,4FAAsF;AACtF,8FAAwF;AACxF,sFAAiF;AACjF,4EAA+E;AAC/E,gFAAmF;AA0BnF,YAAY;AAEZ,mCAAmC;AAI5B,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC;QAC9H,CAAC;QAED,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,OAAO,CAAC,SAAS;YACnD,CAAC,CAAC,EAAE,OAAO,EAAE,+CAAqB,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE;YACjE,CAAC,CAAC,UAAU;gBACV,CAAC,CAAC;oBACE,OAAO,EAAE,+CAAqB;oBAC9B,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,qDAA4B,CAAC,UAAU,CAAC;iBAC/D;gBACH,CAAC,CAAC;oBACE,OAAO,EAAE,+CAAqB;oBAC9B,QAAQ,EAAE,iDAA0B;iBACrC,CAAC;QAER,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,IAAI,sDAAwB,CAAC;QACnE,MAAM,iBAAiB,GACrB,aAAa,KAAK,sDAAwB;YACxC,CAAC,CAAC;gBACE,sDAAwB;gBACxB,EAAE,OAAO,EAAE,6CAAoB,EAAE,WAAW,EAAE,sDAAwB,EAAE;aACzE;YACH,CAAC,CAAC;gBACE,EAAE,OAAO,EAAE,6CAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE;aAC3D,CAAC;QAER,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,MAAM,iBAAiB,GAAG,aAAa,KAAK,sDAAwB,CAAC;QAErE,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,OAAO,EAAE,CAAC,yBAAc,CAAC;YACzB,SAAS,EAAE;gBACT,iBAAiB;gBACjB,GAAG,iBAAiB;gBACpB,qDAAwB;gBACxB;oBACE,OAAO,EAAE,+CAAqB;oBAC9B,WAAW,EAAE,qDAAwB;iBACtC;gBACD,8DAA4B;gBAC5B,kFAAsC;gBACtC,4DAA2B;gBAC3B,0DAA0B;gBAC1B,UAAU;gBACV,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,kCAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,8DAA4B;gBAC5B,uEAAgC;aACjC;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,+CAAqB;gBACrB,6CAAoB;gBACpB,8DAA4B;gBAC5B,kFAAsC;gBACtC,4DAA2B;gBAC3B,0DAA0B;aAC3B;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA5EY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CA4E1B;AAED,YAAY"}

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

@@ -1,9 +1,17 @@
 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_CONVERSATION_TYPING = "conversation.typing";
+export declare const AXP_REALTIME_TOPIC_CONVERSATION_CALL = "conversation.call";
 export declare const AXP_REALTIME_TOPIC_ENTITY_MUTATION = "entity.mutation";
+export declare const AXP_REALTIME_TOPIC_USER_PRESENCE = "user.presence";
 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";
+export declare const AXP_REALTIME_SUBSCRIBE_PRESENCE = "subscribe.presence";
+export declare const AXP_REALTIME_UNSUBSCRIBE_PRESENCE = "unsubscribe.presence";
+export declare const AXP_REALTIME_PRESENCE_LEAVE = "presence.leave";
+export declare const AXP_REALTIME_PRESENCE_SET = "presence.set";
+export declare const AXP_REALTIME_EMIT_TYPING = "conversation.typing.emit";
 /** 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

@@ -1 +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"}
+{"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,sCAAsC,wBAAwB,CAAC;AAC5E,eAAO,MAAM,oCAAoC,sBAAsB,CAAC;AACxE,eAAO,MAAM,kCAAkC,oBAAoB,CAAC;AACpE,eAAO,MAAM,gCAAgC,kBAAkB,CAAC;AAEhE,eAAO,MAAM,yBAAyB,aAAa,CAAC;AACpD,eAAO,MAAM,mCAAmC,2BAA2B,CAAC;AAC5E,eAAO,MAAM,qCAAqC,6BAA6B,CAAC;AAChF,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AACpE,eAAO,MAAM,iCAAiC,yBAAyB,CAAC;AACxE,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAC5D,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AACxD,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,wDAAwD;AACxD,eAAO,MAAM,0BAA0B,wBAAwB,CAAC"}

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

@@ -1,13 +1,21 @@
 "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_REDIS_CHANNEL = exports.AXP_REALTIME_EMIT_TYPING = exports.AXP_REALTIME_PRESENCE_SET = exports.AXP_REALTIME_PRESENCE_LEAVE = exports.AXP_REALTIME_UNSUBSCRIBE_PRESENCE = exports.AXP_REALTIME_SUBSCRIBE_PRESENCE = exports.AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = exports.AXP_REALTIME_SUBSCRIBE_CONVERSATION = exports.AXP_REALTIME_SOCKET_EVENT = exports.AXP_REALTIME_TOPIC_USER_PRESENCE = exports.AXP_REALTIME_TOPIC_ENTITY_MUTATION = exports.AXP_REALTIME_TOPIC_CONVERSATION_CALL = exports.AXP_REALTIME_TOPIC_CONVERSATION_TYPING = 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_CONVERSATION_TYPING = 'conversation.typing';
+exports.AXP_REALTIME_TOPIC_CONVERSATION_CALL = 'conversation.call';
 exports.AXP_REALTIME_TOPIC_ENTITY_MUTATION = 'entity.mutation';
+exports.AXP_REALTIME_TOPIC_USER_PRESENCE = 'user.presence';
 exports.AXP_REALTIME_SOCKET_EVENT = 'realtime';
 exports.AXP_REALTIME_SUBSCRIBE_CONVERSATION = 'subscribe.conversation';
 exports.AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = 'unsubscribe.conversation';
+exports.AXP_REALTIME_SUBSCRIBE_PRESENCE = 'subscribe.presence';
+exports.AXP_REALTIME_UNSUBSCRIBE_PRESENCE = 'unsubscribe.presence';
+exports.AXP_REALTIME_PRESENCE_LEAVE = 'presence.leave';
+exports.AXP_REALTIME_PRESENCE_SET = 'presence.set';
+exports.AXP_REALTIME_EMIT_TYPING = 'conversation.typing.emit';
 /** Redis pub/sub channel for cross-instance fan-out. */
 exports.AXP_REALTIME_REDIS_CHANNEL = 'acx:realtime:events';
 //#endregion

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

@@ -1 +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"}
+{"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,sCAAsC,GAAG,qBAAqB,CAAC;AAC/D,QAAA,oCAAoC,GAAG,mBAAmB,CAAC;AAC3D,QAAA,kCAAkC,GAAG,iBAAiB,CAAC;AACvD,QAAA,gCAAgC,GAAG,eAAe,CAAC;AAEnD,QAAA,yBAAyB,GAAG,UAAU,CAAC;AACvC,QAAA,mCAAmC,GAAG,wBAAwB,CAAC;AAC/D,QAAA,qCAAqC,GAAG,0BAA0B,CAAC;AACnE,QAAA,+BAA+B,GAAG,oBAAoB,CAAC;AACvD,QAAA,iCAAiC,GAAG,sBAAsB,CAAC;AAC3D,QAAA,2BAA2B,GAAG,gBAAgB,CAAC;AAC/C,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAC3C,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,wDAAwD;AAC3C,QAAA,0BAA0B,GAAG,qBAAqB,CAAC;AAEhE,YAAY"}

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

@@ -26,15 +26,53 @@ export interface AXPRealtimeSocketSession {
 }
 export interface AXPRealtimeInboxRefreshPayload {
     deliveryId?: string;
+    deliveryIds?: string[];
+    /** Optional hint so clients can apply deletes/archives without a fetch. */
+    op?: 'created' | 'updated' | 'deleted' | 'archived';
 }
 export interface AXPRealtimeConversationMessagePayload {
     conversationId: string;
     messageId: string;
     op: 'created' | 'updated' | 'deleted';
+    /** Optional entity snapshot so clients can skip a follow-up GET. */
+    message?: Record<string, unknown>;
+}
+export interface AXPRealtimeConversationTypingPayload {
+    conversationId: string;
+    userId: string;
+    userName?: string;
+    active: boolean;
+}
+export type AXPRealtimeConversationCallAction = 'invite' | 'ring' | 'accept' | 'decline' | 'cancel' | 'end';
+export type AXPRealtimeConversationCallMedia = 'voice' | 'video';
+/** Built-in realtime signaling for chat calls (media joins via RTC when configured). */
+export interface AXPRealtimeConversationCallPayload {
+    conversationId: string;
+    action: AXPRealtimeConversationCallAction;
+    media: AXPRealtimeConversationCallMedia;
+    /** Caller / actor user id. */
+    fromUserId: string;
+    fromUserName?: string;
+    /** Optional call correlation id shared across invite → accept. */
+    callId?: string;
 }
 export interface AXPRealtimeEntityMutationPayload {
     entityName: string;
     operation: 'created' | 'updated' | 'deleted';
     id?: string;
+    /** True when the mutation originated from a server bulk command fan-out. */
+    bulk?: boolean;
+    /** Number of successfully mutated records in a bulk operation. */
+    count?: number;
+    bulkExecutionId?: string;
+}
+export type AXPRealtimeUserPresenceStatus = 'online' | 'offline' | 'away' | 'busy';
+export type AXPRealtimeUserPresenceSource = 'auto' | 'manual';
+export interface AXPRealtimeUserPresencePayload {
+    userId: string;
+    status: AXPRealtimeUserPresenceStatus;
+    lastSeen?: string;
+    since?: string;
+    source?: AXPRealtimeUserPresenceSource;
 }
 //# sourceMappingURL=realtime.types.d.ts.map

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

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

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

@@ -1 +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"}
+{"version":3,"file":"realtime.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/types/realtime.types.ts"],"names":[],"mappings":";AAAA,2CAA2C;;AAqG3C,YAAY"}

package/report/src/index.d.ts

@@ -1,9 +1,9 @@
 export * from './lib/report.module';
-export * from './lib/report-execute.service';
 export * from './lib/report.types';
 export * from './lib/report.decorators';
-export * from './lib/report-query.registry';
 export * from './lib/report-definition.registry';
+export * from './lib/report-definition-scope.config';
 export * from './lib/report.util';
+export * from './lib/load-report-definition.util';
 export * from './lib/report-summary.util';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/report/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC"}

package/report/src/index.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/report.module"), exports);
-tslib_1.__exportStar(require("./lib/report-execute.service"), exports);
 tslib_1.__exportStar(require("./lib/report.types"), exports);
 tslib_1.__exportStar(require("./lib/report.decorators"), exports);
-tslib_1.__exportStar(require("./lib/report-query.registry"), exports);
 tslib_1.__exportStar(require("./lib/report-definition.registry"), exports);
+tslib_1.__exportStar(require("./lib/report-definition-scope.config"), exports);
 tslib_1.__exportStar(require("./lib/report.util"), exports);
+tslib_1.__exportStar(require("./lib/load-report-definition.util"), exports);
 tslib_1.__exportStar(require("./lib/report-summary.util"), exports);
 //# sourceMappingURL=index.js.map

package/report/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/report/src/index.ts"],"names":[],"mappings":";;;AAAA,8DAAoC;AACpC,uEAA6C;AAC7C,6DAAmC;AACnC,kEAAwC;AACxC,sEAA4C;AAC5C,2EAAiD;AACjD,4DAAkC;AAClC,oEAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/report/src/index.ts"],"names":[],"mappings":";;;AAAA,8DAAoC;AACpC,6DAAmC;AACnC,kEAAwC;AACxC,2EAAiD;AACjD,+EAAqD;AACrD,4DAAkC;AAClC,4EAAkD;AAClD,oEAA0C"}

package/report/src/lib/load-report-definition.util.d.ts

@@ -0,0 +1,10 @@
+import type { EntityStorageMiddlewareService } from '@acorex-platform/framework-server/core';
+/**
+ * Loads a report definition by business id.
+ *
+ * Prefer {@link EntityStorageMiddlewareService.getOne}, then fall back to a filtered
+ * query. App-bound report rows upserted without a session tenant can pass list
+ * visibility filters while failing the stricter getOne `recordMatchesScope` check.
+ */
+export declare function loadReportDefinitionById(storage: EntityStorageMiddlewareService, reportId: string): Promise<Record<string, unknown> | null>;
+//# sourceMappingURL=load-report-definition.util.d.ts.map

package/report/src/lib/load-report-definition.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-report-definition.util.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/load-report-definition.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAK7F;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,8BAA8B,EACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAoBzC"}

package/report/src/lib/load-report-definition.util.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadReportDefinitionById = loadReportDefinitionById;
+const report_types_1 = require("./report.types");
+//#region ----- Load report definition -----
+/**
+ * Loads a report definition by business id.
+ *
+ * Prefer {@link EntityStorageMiddlewareService.getOne}, then fall back to a filtered
+ * query. App-bound report rows upserted without a session tenant can pass list
+ * visibility filters while failing the stricter getOne `recordMatchesScope` check.
+ */
+async function loadReportDefinitionById(storage, reportId) {
+    if (!reportId) {
+        return null;
+    }
+    const byGet = (await storage.getOne(report_types_1.REPORT_ENTITY, reportId));
+    if (byGet) {
+        return byGet;
+    }
+    const page = await storage.query(report_types_1.REPORT_ENTITY, {
+        skip: 0,
+        take: 1,
+        filter: {
+            logic: 'and',
+            filters: [{ field: 'id', operator: { type: 'equal' }, value: reportId }],
+        },
+    });
+    const item = page.items?.[0];
+    return item ?? null;
+}
+//#endregion
+//# sourceMappingURL=load-report-definition.util.js.map

package/report/src/lib/load-report-definition.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-report-definition.util.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/load-report-definition.util.ts"],"names":[],"mappings":";;AAYA,4DAuBC;AAlCD,iDAA+C;AAE/C,4CAA4C;AAE5C;;;;;;GAMG;AACI,KAAK,UAAU,wBAAwB,CAC5C,OAAuC,EACvC,QAAgB;IAEhB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,4BAAa,EAAE,QAAQ,CAAC,CAAmC,CAAC;IAChG,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,4BAAa,EAAE;QAC9C,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,MAAM,EAAE;YACN,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SACzE;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAwC,CAAC;IACpE,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,YAAY"}

package/report/src/lib/report-definition-scope.config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Built-in report definitions are platform-global — readable by every
+ * authenticated session via `platform-global-read` policy.
+ * Bootstrap upsert stamps empty attribute scope (`{}`).
+ */
+export declare const REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE: {};
+export type ReportDefinitionDataScope = Record<string, never>;
+/**
+ * @deprecated Built-in reports always use {@link REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE}.
+ * Argument is ignored (no product UUID / app binding).
+ */
+export declare function configureReportDefinitionDataScope(_scope?: {
+    tenantId: string;
+    applicationId: string;
+} | null): void;
+export declare function getReportDefinitionDataScope(): ReportDefinitionDataScope;
+//# sourceMappingURL=report-definition-scope.config.d.ts.map

package/report/src/lib/report-definition-scope.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-definition-scope.config.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-definition-scope.config.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,IAAc,CAAC;AAEnE,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,CAAC,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,GAAG,IAAI,CAEd;AAED,wBAAgB,4BAA4B,IAAI,yBAAyB,CAExE"}

package/report/src/lib/report-definition-scope.config.js

@@ -0,0 +1,24 @@
+"use strict";
+//#region ----- Report definition data scope (configure API) -----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE = void 0;
+exports.configureReportDefinitionDataScope = configureReportDefinitionDataScope;
+exports.getReportDefinitionDataScope = getReportDefinitionDataScope;
+/**
+ * Built-in report definitions are platform-global — readable by every
+ * authenticated session via `platform-global-read` policy.
+ * Bootstrap upsert stamps empty attribute scope (`{}`).
+ */
+exports.REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE = {};
+/**
+ * @deprecated Built-in reports always use {@link REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE}.
+ * Argument is ignored (no product UUID / app binding).
+ */
+function configureReportDefinitionDataScope(_scope) {
+    // no-op — platform-global scope is fixed for general (all-tenant) reports
+}
+function getReportDefinitionDataScope() {
+    return exports.REPORT_DEFINITION_PLATFORM_GLOBAL_SCOPE;
+}
+//#endregion
+//# sourceMappingURL=report-definition-scope.config.js.map

package/report/src/lib/report-definition-scope.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-definition-scope.config.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-definition-scope.config.ts"],"names":[],"mappings":";AAAA,kEAAkE;;;AAelE,gFAKC;AAED,oEAEC;AAtBD;;;;GAIG;AACU,QAAA,uCAAuC,GAAG,EAAW,CAAC;AAInE;;;GAGG;AACH,SAAgB,kCAAkC,CAAC,MAG3C;IACN,0EAA0E;AAC5E,CAAC;AAED,SAAgB,4BAA4B;IAC1C,OAAO,+CAAuC,CAAC;AACjD,CAAC;AAED,YAAY"}

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

@@ -3,7 +3,11 @@ import { DiscoveryService, Reflector } from '@nestjs/core';
 import { EntityStorageMiddlewareService } from '@acorex-platform/framework-server/core';
 /**
  * Discovers {@link BackendReportDefinitionProvider} classes and upserts categories
- * and report definitions into entity storage (insert only when missing).
+ * and report definitions into entity storage as **system catalog** rows
+ * (readable by all tenants / apps).
+ *
+ * Uses engine storage APIs so bootstrap (no HTTP session) does not treat
+ * rows as missing and insert duplicates.
  */
 export declare class BackendReportDefinitionRegistry implements OnApplicationBootstrap {
     private readonly discovery;
@@ -17,5 +21,6 @@ export declare class BackendReportDefinitionRegistry implements OnApplicationBoo
     private collectDefinitionProviders;
     private isDefinitionProvider;
     private upsertDefinition;
+    private listByBusinessId;
 }
 //# sourceMappingURL=report-definition.registry.d.ts.map

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

@@ -1 +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"}
+{"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;AAiBxF;;;;;;;GAOG;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;IA8DtC,OAAO,CAAC,0BAA0B;IAiClC,OAAO,CAAC,oBAAoB;YAKd,gBAAgB;YAkDhB,gBAAgB;CAiB/B"}