@acorex-platform/framework-server 0.0.18 → 0.0.20

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"}

package/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-entity-bridge.listener.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAKjF,qBACa,4BAA4B;IAIrC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;gBAGrD,SAAS,EAAE,qBAAqB,EAChC,QAAQ,EAAE,4BAA4B;IAInD,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAsClE"}
+{"version":3,"file":"realtime-entity-bridge.listener.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAKjF,qBACa,4BAA4B;IAIrC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;gBAGrD,SAAS,EAAE,qBAAqB,EAChC,QAAQ,EAAE,4BAA4B;IAInD,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0ClE"}

package/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.js

@@ -18,6 +18,9 @@ let RealtimeEntityBridgeListener = RealtimeEntityBridgeListener_1 = class Realti
         this.logger = new common_1.Logger(RealtimeEntityBridgeListener_1.name);
     }
     async onEntityMutation(event) {
+        if ((0, core_1.isBulkRealtimeSuppressActive)()) {
+            return;
+        }
         const entityName = event.entityName?.trim() || '';
         if (!entityName || realtime_entity_bridge_tokens_1.REALTIME_ENTITY_BRIDGE_EXCLUSIONS.has(entityName)) {
             return;

package/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime-entity-bridge.listener.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,yDAAgD;AAChD,iEAGgD;AAChD,8EAAyE;AACzE,+DAA+E;AAE/E,uFAAiF;AACjF,mFAAoF;AAEpF,qDAAqD;AAG9C,IAAM,4BAA4B,oCAAlC,MAAM,4BAA4B;IAGvC,YACmB,SAAgC,EAChC,QAAsC;QADtC,cAAS,GAAT,SAAS,CAAuB;QAChC,aAAQ,GAAR,QAAQ,CAA8B;QAJxC,WAAM,GAAG,IAAI,eAAM,CAAC,8BAA4B,CAAC,IAAI,CAAC,CAAC;IAKrE,CAAC;IAGE,AAAN,KAAK,CAAC,gBAAgB,CAAC,KAA0B;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,IAAI,iEAAiC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,YAAY,EAAE,QAAQ,IAAI,QAAQ,CAAC;QAExD,MAAM,OAAO,GAAqC;YAChD,UAAU;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;SACb,CAAC;QAEF,MAAM,QAAQ,GACZ,YAAY,KAAK,QAAQ;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE;YAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC3B,KAAK,EAAE,oDAAkC;gBACzC,QAAQ;gBACR,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;CACF,CAAA;AA/CY,oEAA4B;AASjC;IADL,IAAA,uBAAO,EAAC,qCAA8B,CAAC;;;;oEAsCvC;uCA9CU,4BAA4B;IADxC,IAAA,mBAAU,GAAE;6CAKmB,+CAAqB;QACtB,8DAA4B;GAL9C,4BAA4B,CA+CxC;AAED,YAAY"}
+{"version":3,"file":"realtime-entity-bridge.listener.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bridge.listener.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,yDAAgD;AAChD,iEAIgD;AAChD,8EAAyE;AACzE,+DAA+E;AAE/E,uFAAiF;AACjF,mFAAoF;AAEpF,qDAAqD;AAG9C,IAAM,4BAA4B,oCAAlC,MAAM,4BAA4B;IAGvC,YACmB,SAAgC,EAChC,QAAsC;QADtC,cAAS,GAAT,SAAS,CAAuB;QAChC,aAAQ,GAAR,QAAQ,CAA8B;QAJxC,WAAM,GAAG,IAAI,eAAM,CAAC,8BAA4B,CAAC,IAAI,CAAC,CAAC;IAKrE,CAAC;IAGE,AAAN,KAAK,CAAC,gBAAgB,CAAC,KAA0B;QAC/C,IAAI,IAAA,mCAA4B,GAAE,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,IAAI,iEAAiC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,YAAY,EAAE,QAAQ,IAAI,QAAQ,CAAC;QAExD,MAAM,OAAO,GAAqC;YAChD,UAAU;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;SACb,CAAC;QAEF,MAAM,QAAQ,GACZ,YAAY,KAAK,QAAQ;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE;YAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC3B,KAAK,EAAE,oDAAkC;gBACzC,QAAQ;gBACR,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;CACF,CAAA;AAnDY,oEAA4B;AASjC;IADL,IAAA,uBAAO,EAAC,qCAA8B,CAAC;;;;oEA0CvC;uCAlDU,4BAA4B;IADxC,IAAA,mBAAU,GAAE;6CAKmB,+CAAqB;QACtB,8DAA4B;GAL9C,4BAA4B,CAmDxC;AAED,YAAY"}

package/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.d.ts

@@ -0,0 +1,11 @@
+import { type EntityBulkMutationCompletedEvent } from '@acorex-platform/framework-server/core';
+import { RealtimePublisherPort } from '../ports/realtime-publisher.port';
+import { RealtimeEntityBridgeRegistry } from './realtime-entity-bridge.registry';
+export declare class RealtimeEntityBulkBridgeListener {
+    private readonly publisher;
+    private readonly registry;
+    private readonly logger;
+    constructor(publisher: RealtimePublisherPort, registry: RealtimeEntityBridgeRegistry);
+    onBulkCompleted(event: EntityBulkMutationCompletedEvent): Promise<void>;
+}
+//# sourceMappingURL=realtime-entity-bulk-bridge.listener.d.ts.map

package/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-entity-bulk-bridge.listener.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAKjF,qBACa,gCAAgC;IAIzC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;gBAGzD,SAAS,EAAE,qBAAqB,EAChC,QAAQ,EAAE,4BAA4B;IAInD,eAAe,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC9E"}

package/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.js

@@ -0,0 +1,69 @@
+"use strict";
+var RealtimeEntityBulkBridgeListener_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeEntityBulkBridgeListener = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const core_1 = require("@acorex-platform/framework-server/core");
+const realtime_publisher_port_1 = require("../ports/realtime-publisher.port");
+const realtime_topics_1 = require("../topics/realtime-topics");
+const realtime_entity_bridge_registry_1 = require("./realtime-entity-bridge.registry");
+const realtime_entity_bridge_tokens_1 = require("./realtime-entity-bridge.tokens");
+//#region ---- Bulk entity mutation → realtime bridge ----
+let RealtimeEntityBulkBridgeListener = RealtimeEntityBulkBridgeListener_1 = class RealtimeEntityBulkBridgeListener {
+    constructor(publisher, registry) {
+        this.publisher = publisher;
+        this.registry = registry;
+        this.logger = new common_1.Logger(RealtimeEntityBulkBridgeListener_1.name);
+    }
+    async onBulkCompleted(event) {
+        const entityName = event.entityName?.trim() || '';
+        if (!entityName || realtime_entity_bridge_tokens_1.REALTIME_ENTITY_BRIDGE_EXCLUSIONS.has(entityName)) {
+            return;
+        }
+        const tenantId = event.tenantId?.trim() || '';
+        const actorUserId = event.userId?.trim() || '';
+        if (!tenantId || !actorUserId) {
+            return;
+        }
+        const registration = this.registry.get(entityName);
+        const audienceMode = registration?.audience ?? 'tenant';
+        const payload = {
+            entityName,
+            operation: event.operation,
+            bulk: true,
+            count: event.succeeded,
+            bulkExecutionId: event.bulkExecutionId,
+        };
+        const audience = audienceMode === 'tenant'
+            ? { tenant: true }
+            : { userIds: [actorUserId] };
+        try {
+            await this.publisher.publish({
+                topic: realtime_topics_1.AXP_REALTIME_TOPIC_ENTITY_MUTATION,
+                tenantId,
+                audience,
+                payload,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to publish bulk entity.mutation for ${event.entityName}: ${message}`);
+        }
+    }
+};
+exports.RealtimeEntityBulkBridgeListener = RealtimeEntityBulkBridgeListener;
+tslib_1.__decorate([
+    (0, event_emitter_1.OnEvent)(core_1.ENTITY_BULK_MUTATION_COMPLETED),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RealtimeEntityBulkBridgeListener.prototype, "onBulkCompleted", null);
+exports.RealtimeEntityBulkBridgeListener = RealtimeEntityBulkBridgeListener = RealtimeEntityBulkBridgeListener_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [realtime_publisher_port_1.RealtimePublisherPort,
+        realtime_entity_bridge_registry_1.RealtimeEntityBridgeRegistry])
+], RealtimeEntityBulkBridgeListener);
+//#endregion
+//# sourceMappingURL=realtime-entity-bulk-bridge.listener.js.map

package/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-entity-bulk-bridge.listener.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/entity-bridge/realtime-entity-bulk-bridge.listener.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,yDAAgD;AAChD,iEAGgD;AAChD,8EAAyE;AACzE,+DAA+E;AAE/E,uFAAiF;AACjF,mFAAoF;AAEpF,0DAA0D;AAGnD,IAAM,gCAAgC,wCAAtC,MAAM,gCAAgC;IAG3C,YACmB,SAAgC,EAChC,QAAsC;QADtC,cAAS,GAAT,SAAS,CAAuB;QAChC,aAAQ,GAAR,QAAQ,CAA8B;QAJxC,WAAM,GAAG,IAAI,eAAM,CAAC,kCAAgC,CAAC,IAAI,CAAC,CAAC;IAKzE,CAAC;IAGE,AAAN,KAAK,CAAC,eAAe,CAAC,KAAuC;QAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,IAAI,iEAAiC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,YAAY,EAAE,QAAQ,IAAI,QAAQ,CAAC;QAExD,MAAM,OAAO,GAAqC;YAChD,UAAU;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,CAAC,SAAS;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC;QAEF,MAAM,QAAQ,GACZ,YAAY,KAAK,QAAQ;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE;YAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC3B,KAAK,EAAE,oDAAkC;gBACzC,QAAQ;gBACR,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;CACF,CAAA;AAjDY,4EAAgC;AASrC;IADL,IAAA,uBAAO,EAAC,qCAA8B,CAAC;;;;uEAwCvC;2CAhDU,gCAAgC;IAD5C,IAAA,mBAAU,GAAE;6CAKmB,+CAAqB;QACtB,8DAA4B;GAL9C,gCAAgC,CAiD5C;AAED,YAAY"}

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

@@ -1,20 +1,33 @@
 import { OnGatewayConnection, OnGatewayDisconnect, OnGatewayInit } from '@nestjs/websockets';
 import { AuthService, TokenResolverService } from '@acorex-platform/framework-server/security';
 import type { Server, Socket } from 'socket.io';
+import { SocketIoRealtimeDelivery } from '../delivery/socket-io-realtime.delivery';
 import { RealtimeConversationMembershipRegistry } from '../ports/realtime-conversation-membership.registry';
 import { RealtimeTransportPort } from '../ports/realtime-transport.port';
+import { RealtimePublisherPort } from '../ports/realtime-publisher.port';
+import { UserPresenceTrackerService } from '../presence/user-presence-tracker.service';
+import type { AXPUserPresenceSetResult, AXPUserPresenceSubscribeResult } from '../presence/user-presence.types';
+/**
+ * Built-in Socket.IO namespace for always-on app signals.
+ * Delivery is delegated to {@link SocketIoRealtimeDelivery}.
+ */
 export declare class RealtimeGateway implements OnGatewayInit, OnGatewayConnection, OnGatewayDisconnect {
     private readonly transport;
+    private readonly delivery;
     private readonly tokenResolver;
     private readonly authService;
     private readonly membership;
+    private readonly presence;
+    private readonly publisher;
     private readonly logger;
+    private touchTimer;
     server: Server;
     private readonly onEnvelope;
-    constructor(transport: RealtimeTransportPort, tokenResolver: TokenResolverService, authService: AuthService, membership: RealtimeConversationMembershipRegistry);
+    constructor(transport: RealtimeTransportPort, delivery: SocketIoRealtimeDelivery, tokenResolver: TokenResolverService, authService: AuthService, membership: RealtimeConversationMembershipRegistry, presence: UserPresenceTrackerService, publisher: RealtimePublisherPort);
     afterInit(): void;
     handleConnection(socket: Socket): void;
     handleDisconnect(socket: Socket): void;
+    private touchConnectedSockets;
     subscribeConversation(socket: Socket, body: {
         conversationId?: string;
     }): Promise<{
@@ -26,6 +39,27 @@ export declare class RealtimeGateway implements OnGatewayInit, OnGatewayConnecti
     }): Promise<{
         ok: boolean;
     }>;
-    private deliver;
+    subscribePresence(socket: Socket, body: {
+        userIds?: string[];
+    }): Promise<AXPUserPresenceSubscribeResult>;
+    unsubscribePresence(socket: Socket, body: {
+        userIds?: string[];
+    }): Promise<{
+        ok: boolean;
+    }>;
+    leavePresence(socket: Socket): {
+        ok: boolean;
+    };
+    emitTyping(socket: Socket, body: {
+        conversationId?: string;
+        active?: boolean;
+    }): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+    setPresence(socket: Socket, body: {
+        status?: string;
+        source?: string;
+    }): Promise<AXPUserPresenceSetResult>;
 }
 //# sourceMappingURL=realtime.gateway.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"realtime.gateway.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/gateway/realtime.gateway.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,sCAAsC,EAAE,MAAM,oDAAoD,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAiCzE,qBAca,eAAgB,YAAW,aAAa,EAAE,mBAAmB,EAAE,mBAAmB;IAW3F,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAb7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAG3D,MAAM,EAAG,MAAM,CAAC;IAEhB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAEzB;gBAGiB,SAAS,EAAE,qBAAqB,EAChC,aAAa,EAAE,oBAAoB,EACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,sCAAsC;IAGrE,SAAS,IAAI,IAAI;IAKjB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBtC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC,qBAAqB,CACN,MAAM,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBtC,uBAAuB,CACR,MAAM,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAU3B,OAAO,CAAC,OAAO;CAchB"}
+{"version":3,"file":"realtime.gateway.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/gateway/realtime.gateway.ts"],"names":[],"mappings":"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"}