tychat-contracts 1.0.77 → 1.0.79

package/dist/analytics/analytics-emitter.helper.d.ts

@@ -0,0 +1,40 @@
+import { EventAnalyticType } from './event-analytic.enum';
+import { CreateAnalyticEventDto } from './create-analytic-event.dto';
+import { TOPIC_ANALYTICS_EVENT } from './analytics-kafka-topics';
+/**
+ * Options for building an analytic event payload.
+ */
+export interface EmitAnalyticEventOptions {
+    tenant: string;
+    eventType: EventAnalyticType;
+    entityId?: string;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Builds the Kafka payload to be sent to the analytics service.
+ *
+ * Usage (fire-and-forget via ClientKafka.emit):
+ * ```ts
+ * this.analyticsClient.emit(
+ *   TOPIC_ANALYTICS_EVENT,
+ *   buildAnalyticEventPayload({
+ *     tenant,
+ *     eventType: 'patient.created',
+ *     entityId: patient.id,
+ *     source: 'tychat-patient-service',
+ *   }),
+ * );
+ * ```
+ */
+export declare function buildAnalyticEventPayload(options: EmitAnalyticEventOptions & {
+    source: string;
+}): {
+    tenant: string;
+    payload: CreateAnalyticEventDto;
+};
+/**
+ * Re-export for convenience so services only need one import.
+ */
+export { TOPIC_ANALYTICS_EVENT };
+//# sourceMappingURL=analytics-emitter.helper.d.ts.map

package/dist/analytics/analytics-emitter.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-emitter.helper.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-emitter.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,wBAAwB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,CAcrD;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/analytics/analytics-emitter.helper.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOPIC_ANALYTICS_EVENT = void 0;
+exports.buildAnalyticEventPayload = buildAnalyticEventPayload;
+const crypto_1 = require("crypto");
+const analytics_kafka_topics_1 = require("./analytics-kafka-topics");
+Object.defineProperty(exports, "TOPIC_ANALYTICS_EVENT", { enumerable: true, get: function () { return analytics_kafka_topics_1.TOPIC_ANALYTICS_EVENT; } });
+/**
+ * Builds the Kafka payload to be sent to the analytics service.
+ *
+ * Usage (fire-and-forget via ClientKafka.emit):
+ * ```ts
+ * this.analyticsClient.emit(
+ *   TOPIC_ANALYTICS_EVENT,
+ *   buildAnalyticEventPayload({
+ *     tenant,
+ *     eventType: 'patient.created',
+ *     entityId: patient.id,
+ *     source: 'tychat-patient-service',
+ *   }),
+ * );
+ * ```
+ */
+function buildAnalyticEventPayload(options) {
+    return {
+        tenant: options.tenant,
+        payload: {
+            eventId: (0, crypto_1.randomUUID)(),
+            tenant: options.tenant,
+            eventType: options.eventType,
+            entityId: options.entityId,
+            source: options.source,
+            userId: options.userId,
+            metadata: options.metadata,
+            occurredAt: new Date().toISOString(),
+        },
+    };
+}

package/dist/analytics/index.d.ts

@@ -2,4 +2,5 @@ export * from './event-analytic.enum';
 export * from './create-analytic-event.dto';
 export * from './analytics-query.dto';
 export * from './analytics-kafka-topics';
+export * from './analytics-emitter.helper';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/analytics/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./event-analytic.enum"), exports);
 __exportStar(require("./create-analytic-event.dto"), exports);
 __exportStar(require("./analytics-query.dto"), exports);
 __exportStar(require("./analytics-kafka-topics"), exports);
+__exportStar(require("./analytics-emitter.helper"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.77",
+  "version": "1.0.79",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/analytics/analytics-emitter.helper.ts

@@ -0,0 +1,54 @@
+import { randomUUID } from 'crypto';
+import { EventAnalyticType } from './event-analytic.enum';
+import { CreateAnalyticEventDto } from './create-analytic-event.dto';
+import { TOPIC_ANALYTICS_EVENT } from './analytics-kafka-topics';
+
+/**
+ * Options for building an analytic event payload.
+ */
+export interface EmitAnalyticEventOptions {
+  tenant: string;
+  eventType: EventAnalyticType;
+  entityId?: string;
+  userId?: string;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Builds the Kafka payload to be sent to the analytics service.
+ *
+ * Usage (fire-and-forget via ClientKafka.emit):
+ * ```ts
+ * this.analyticsClient.emit(
+ *   TOPIC_ANALYTICS_EVENT,
+ *   buildAnalyticEventPayload({
+ *     tenant,
+ *     eventType: 'patient.created',
+ *     entityId: patient.id,
+ *     source: 'tychat-patient-service',
+ *   }),
+ * );
+ * ```
+ */
+export function buildAnalyticEventPayload(
+  options: EmitAnalyticEventOptions & { source: string },
+): { tenant: string; payload: CreateAnalyticEventDto } {
+  return {
+    tenant: options.tenant,
+    payload: {
+      eventId: randomUUID(),
+      tenant: options.tenant,
+      eventType: options.eventType,
+      entityId: options.entityId,
+      source: options.source,
+      userId: options.userId,
+      metadata: options.metadata,
+      occurredAt: new Date().toISOString(),
+    },
+  };
+}
+
+/**
+ * Re-export for convenience so services only need one import.
+ */
+export { TOPIC_ANALYTICS_EVENT };

package/src/analytics/index.ts

@@ -2,3 +2,4 @@ export * from './event-analytic.enum';
 export * from './create-analytic-event.dto';
 export * from './analytics-query.dto';
 export * from './analytics-kafka-topics';
+export * from './analytics-emitter.helper';