@privateaim/server-telemetry-kit 0.8.16 → 0.8.17

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.8.17](https://github.com/PrivateAIM/hub/compare/v0.8.16...v0.8.17) (2025-09-01)
+
+
+### Features
+
+* refactor domain event publisher & register amqp ([0f98ecf](https://github.com/PrivateAIM/hub/commit/0f98ecf3c24239d9050fd4a7c2e0bd6843cb3dc8))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @privateaim/kit bumped from ^0.8.16 to ^0.8.17
+    * @privateaim/server-kit bumped from ^0.8.16 to ^0.8.17
+    * @privateaim/telemetry-kit bumped from ^0.8.16 to ^0.8.17
+  * peerDependencies
+    * @privateaim/kit bumped from ^0.8.16 to ^0.8.17
+    * @privateaim/server-kit bumped from ^0.8.16 to ^0.8.17
+    * @privateaim/telemetry-kit bumped from ^0.8.16 to ^0.8.17
+
 ## [0.8.16](https://github.com/PrivateAIM/hub/compare/v0.8.15...v0.8.16) (2025-08-26)
 
 

package/dist/core/event/index.d.ts

@@ -0,0 +1,2 @@
+export * from './subscriber';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/event/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC"}

package/dist/core/event/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./subscriber"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/event/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,+CAA6B"}

package/dist/core/event/subscriber.d.ts

@@ -0,0 +1,5 @@
+import type { EntityEventHandleOptions, IEntityEventHandler } from '@privateaim/server-kit';
+export declare class EntityEventHandler implements IEntityEventHandler {
+    handle(ctx: EntityEventHandleOptions): Promise<void>;
+}
+//# sourceMappingURL=subscriber.d.ts.map

package/dist/core/event/subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["../../../src/core/event/subscriber.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAQ5F,qBAAa,kBAAmB,YAAW,mBAAmB;IACpD,MAAM,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;CA0F7D"}

package/dist/core/event/subscriber.js

@@ -0,0 +1,86 @@
+"use strict";
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityEventHandler = void 0;
+const smob_1 = require("smob");
+const server_kit_1 = require("@privateaim/server-kit");
+const telemetry_kit_1 = require("@privateaim/telemetry-kit");
+const kit_1 = require("@privateaim/kit");
+const services_1 = require("../../services");
+class EntityEventHandler {
+    async handle(ctx) {
+        if (ctx.metadata.ref_type === telemetry_kit_1.DomainType.EVENT) {
+            return;
+        }
+        const entity = {
+            ref_type: ctx.metadata.ref_type,
+            name: ctx.metadata.event,
+            scope: 'entity',
+            expiring: true,
+            expires_at: new Date(Date.now() + (1000 * 60 * 60 * 24 * 7)).toISOString(),
+        };
+        if (ctx.metadata.ref_id) {
+            entity.ref_id = ctx.metadata.ref_id;
+        }
+        const keys = [
+            'actor_id',
+            'actor_type',
+            'actor_name',
+            'request_path',
+            'request_method',
+            'request_ip_address',
+            'request_user_agent',
+        ];
+        for (let i = 0; i < keys.length; i++) {
+            if (ctx.metadata[keys[i]]) {
+                entity[keys[i]] = ctx.metadata[keys[i]];
+            }
+        }
+        if (entity.request_ip_address &&
+            entity.request_ip_address === '::1') {
+            entity.request_ip_address = '127.0.0.1';
+        }
+        const data = {};
+        if (
+        // todo: use enum
+        ctx.metadata.event === 'updated' &&
+            ctx.dataPrevious) {
+            const diff = {};
+            const keys = Object.keys(ctx.data);
+            for (let i = 0; i < keys.length; i++) {
+                const key = keys[i];
+                // skip date changes
+                if (key.endsWith('_at')) {
+                    continue;
+                }
+                if ((0, kit_1.isObject)(diff[key]) || Array.isArray(diff[key])) {
+                    continue;
+                }
+                if (!(0, smob_1.isEqual)(ctx.data[key], ctx.dataPrevious[key])) {
+                    diff[key] = {
+                        next: ctx.data[key],
+                        previous: ctx.dataPrevious[key],
+                    };
+                }
+            }
+            data.diff = diff;
+        }
+        entity.data = data;
+        if ((0, services_1.isEventComponentServiceUsable)()) {
+            const eventService = (0, services_1.useEventComponentService)();
+            await eventService.command({
+                command: 'create',
+                data: entity,
+            });
+            return;
+        }
+        (0, server_kit_1.useLogger)().debug('Event service is not available to publish events.');
+    }
+}
+exports.EntityEventHandler = EntityEventHandler;
+//# sourceMappingURL=subscriber.js.map

package/dist/core/event/subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.js","sourceRoot":"","sources":["../../../src/core/event/subscriber.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './event';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAOA,cAAc,SAAS,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./event"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,0CAAwB"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './components';
+export * from './core';
 export * from './services';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -21,5 +21,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./components"), exports);
+__exportStar(require("./core"), exports);
 __exportStar(require("./services"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,yCAAuB;AACvB,6CAA2B"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@privateaim/server-telemetry-kit",
-    "version": "0.8.16",
+    "version": "0.8.17",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "author": {
@@ -11,16 +11,19 @@
     "license": "Apache-2.0",
     "description": "This package contains server side db helpers & utilities.",
     "dependencies": {
+        "smob": "^1.5.0",
         "winston-transport": "^4.9.0"
     },
     "devDependencies": {
-        "@privateaim/server-kit": "^0.8.16",
-        "@privateaim/telemetry-kit": "^0.8.16",
+        "@privateaim/kit": "^0.8.17",
+        "@privateaim/server-kit": "^0.8.17",
+        "@privateaim/telemetry-kit": "^0.8.17",
         "singa": "^1.1.0"
     },
     "peerDependencies": {
-        "@privateaim/server-kit": "^0.8.16",
-        "@privateaim/telemetry-kit": "^0.8.16",
+        "@privateaim/kit": "^0.8.17",
+        "@privateaim/server-kit": "^0.8.17",
+        "@privateaim/telemetry-kit": "^0.8.17",
         "singa": "^1.1.0"
     },
     "scripts": {

package/src/core/event/index.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export * from './subscriber';

package/src/core/event/subscriber.ts

@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2025.
+ *  Author Peter Placzek (tada5hi)
+ *  For the full copyright and license information,
+ *  view the LICENSE file that was distributed with this source code.
+ */
+
+import { isEqual } from 'smob';
+import type { EntityEventHandleOptions, IEntityEventHandler } from '@privateaim/server-kit';
+import { useLogger } from '@privateaim/server-kit';
+import type { Event, EventData } from '@privateaim/telemetry-kit';
+import { DomainType } from '@privateaim/telemetry-kit';
+import type { ObjectDiff, ObjectLiteral } from '@privateaim/kit';
+import { isObject } from '@privateaim/kit';
+import { isEventComponentServiceUsable, useEventComponentService } from '../../services';
+
+export class EntityEventHandler implements IEntityEventHandler {
+    async handle(ctx: EntityEventHandleOptions): Promise<void> {
+        if (ctx.metadata.ref_type === DomainType.EVENT) {
+            return;
+        }
+
+        const entity : Partial<Event> = {
+            ref_type: ctx.metadata.ref_type,
+
+            name: ctx.metadata.event,
+            scope: 'entity',
+
+            expiring: true,
+            expires_at: new Date(
+                Date.now() + (1000 * 60 * 60 * 24 * 7),
+            ).toISOString(),
+        };
+
+        if (ctx.metadata.ref_id) {
+            entity.ref_id = ctx.metadata.ref_id;
+        }
+
+        const keys : (keyof Event)[] = [
+            'actor_id',
+            'actor_type',
+            'actor_name',
+            'request_path',
+            'request_method',
+            'request_ip_address',
+            'request_user_agent',
+        ];
+
+        for (let i = 0; i < keys.length; i++) {
+            if (ctx.metadata[keys[i]]) {
+                (entity as ObjectLiteral)[keys[i]] = ctx.metadata[keys[i]];
+            }
+        }
+
+        if (
+            entity.request_ip_address &&
+            entity.request_ip_address === '::1'
+        ) {
+            entity.request_ip_address = '127.0.0.1';
+        }
+
+        const data : EventData = {};
+
+        if (
+            // todo: use enum
+            ctx.metadata.event === 'updated' &&
+            ctx.dataPrevious
+        ) {
+            const diff : ObjectDiff = {};
+            const keys = Object.keys(ctx.data);
+            for (let i = 0; i < keys.length; i++) {
+                const key = keys[i];
+
+                // skip date changes
+                if (key.endsWith('_at')) {
+                    continue;
+                }
+
+                if (isObject(diff[key]) || Array.isArray(diff[key])) {
+                    continue;
+                }
+
+                if (!isEqual(ctx.data[key], ctx.dataPrevious[key])) {
+                    diff[key] = {
+                        next: ctx.data[key],
+                        previous: ctx.dataPrevious[key],
+                    };
+                }
+            }
+
+            data.diff = diff;
+        }
+
+        entity.data = data;
+
+        if (isEventComponentServiceUsable()) {
+            const eventService = useEventComponentService();
+            await eventService.command({
+                command: 'create',
+                data: entity,
+            });
+
+            return;
+        }
+
+        useLogger().debug('Event service is not available to publish events.');
+    }
+}

package/src/core/index.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2025.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export * from './event';

package/src/index.ts

@@ -6,4 +6,5 @@
  */
 
 export * from './components';
+export * from './core';
 export * from './services';