@phystack/analytics-publisher 4.3.40-dev

package/dist/factories/AdapterFactory.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterFactory = void 0;
+const EventHubAdapter_1 = __importDefault(require("../adapters/event-hub/EventHubAdapter"));
+const KafkaAdapter_1 = __importDefault(require("../adapters/kafka/KafkaAdapter"));
+class AdapterFactory {
+    static async create(type, config) {
+        if (type === 'eventHub') {
+            return new EventHubAdapter_1.default(config);
+        }
+        else if (type === 'kafka') {
+            const kafkaAdapter = new KafkaAdapter_1.default(config);
+            await kafkaAdapter.init();
+            return kafkaAdapter;
+        }
+        else {
+            throw new Error(`Unknown adapter type: ${type}`);
+        }
+    }
+}
+exports.AdapterFactory = AdapterFactory;
+//# sourceMappingURL=AdapterFactory.js.map

package/dist/factories/AdapterFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterFactory.js","sourceRoot":"","sources":["../../src/factories/AdapterFactory.ts"],"names":[],"mappings":";;;;;;AAAA,4FAAiF;AAEjF,kFAA0D;AAG1D,MAAa,cAAc;IACzB,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAiB,EACjB,MAA2C;QAE3C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO,IAAI,yBAAQ,CAAC,MAAwB,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,IAAI,sBAAY,CAAC,MAA4B,CAAC,CAAC;YACpE,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;YAC1B,OAAO,YAAY,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAfD,wCAeC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { AnalyticsClient } from './client/AnalyticsClient';
+export { default as PublishCommand } from './commands/PublishCommand';
+export { default as BasePublisher } from './publishers/BasePublisher';
+export { default as SessionPublisher } from './publishers/SessionPublisher';
+export { default as EventPublisher } from './publishers/EventPublisher';
+export { default as ClientPublisher } from './publishers/ClientPublisher';
+export { default as RetryDecorator } from './decorators/RetryDecorator';
+export { AdapterFactory } from './factories/AdapterFactory';
+export { default as MetricsObserver, IAnalyticsObserver } from './observers/MetricsObserver';
+export { default as ITransportAdapter } from './adapters/ITransportAdapter';
+export { default as KafkaAdapter } from './adapters/kafka/KafkaAdapter';
+export type { KafkaConfig, SaslMechanism, KafkaCredentials } from './adapters/kafka';
+export { default as EventHub } from './adapters/event-hub/EventHubAdapter';
+export type { ICommand } from './commands/PublishCommand';
+export type { Event, Session, Client, AdapterType } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAC3E,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventHub = exports.KafkaAdapter = exports.MetricsObserver = exports.AdapterFactory = exports.RetryDecorator = exports.ClientPublisher = exports.EventPublisher = exports.SessionPublisher = exports.BasePublisher = exports.PublishCommand = exports.AnalyticsClient = void 0;
+var AnalyticsClient_1 = require("./client/AnalyticsClient");
+Object.defineProperty(exports, "AnalyticsClient", { enumerable: true, get: function () { return AnalyticsClient_1.AnalyticsClient; } });
+var PublishCommand_1 = require("./commands/PublishCommand");
+Object.defineProperty(exports, "PublishCommand", { enumerable: true, get: function () { return __importDefault(PublishCommand_1).default; } });
+var BasePublisher_1 = require("./publishers/BasePublisher");
+Object.defineProperty(exports, "BasePublisher", { enumerable: true, get: function () { return __importDefault(BasePublisher_1).default; } });
+var SessionPublisher_1 = require("./publishers/SessionPublisher");
+Object.defineProperty(exports, "SessionPublisher", { enumerable: true, get: function () { return __importDefault(SessionPublisher_1).default; } });
+var EventPublisher_1 = require("./publishers/EventPublisher");
+Object.defineProperty(exports, "EventPublisher", { enumerable: true, get: function () { return __importDefault(EventPublisher_1).default; } });
+var ClientPublisher_1 = require("./publishers/ClientPublisher");
+Object.defineProperty(exports, "ClientPublisher", { enumerable: true, get: function () { return __importDefault(ClientPublisher_1).default; } });
+var RetryDecorator_1 = require("./decorators/RetryDecorator");
+Object.defineProperty(exports, "RetryDecorator", { enumerable: true, get: function () { return __importDefault(RetryDecorator_1).default; } });
+var AdapterFactory_1 = require("./factories/AdapterFactory");
+Object.defineProperty(exports, "AdapterFactory", { enumerable: true, get: function () { return AdapterFactory_1.AdapterFactory; } });
+var MetricsObserver_1 = require("./observers/MetricsObserver");
+Object.defineProperty(exports, "MetricsObserver", { enumerable: true, get: function () { return __importDefault(MetricsObserver_1).default; } });
+var KafkaAdapter_1 = require("./adapters/kafka/KafkaAdapter");
+Object.defineProperty(exports, "KafkaAdapter", { enumerable: true, get: function () { return __importDefault(KafkaAdapter_1).default; } });
+var EventHubAdapter_1 = require("./adapters/event-hub/EventHubAdapter");
+Object.defineProperty(exports, "EventHub", { enumerable: true, get: function () { return __importDefault(EventHubAdapter_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA2D;AAAlD,kHAAA,eAAe,OAAA;AACxB,4DAAsE;AAA7D,iIAAA,OAAO,OAAkB;AAClC,4DAAsE;AAA7D,+HAAA,OAAO,OAAiB;AACjC,kEAA4E;AAAnE,qIAAA,OAAO,OAAoB;AACpC,8DAAwE;AAA/D,iIAAA,OAAO,OAAkB;AAClC,gEAA0E;AAAjE,mIAAA,OAAO,OAAmB;AACnC,8DAAwE;AAA/D,iIAAA,OAAO,OAAkB;AAClC,6DAA4D;AAAnD,gHAAA,cAAc,OAAA;AACvB,+DAA6F;AAApF,mIAAA,OAAO,OAAmB;AAEnC,8DAAwE;AAA/D,6HAAA,OAAO,OAAgB;AAEhC,wEAA2E;AAAlE,4HAAA,OAAO,OAAY"}

package/dist/observers/MetricsObserver.d.ts

@@ -0,0 +1,11 @@
+export interface IAnalyticsObserver {
+    onPublishSuccess(topic: string, messageCount: number): void;
+    onPublishError(topic: string, error: Error): void;
+    onBatchFull(batchSize: number): void;
+}
+export default class MetricsObserver implements IAnalyticsObserver {
+    onPublishSuccess(topic: string, messageCount: number): void;
+    onPublishError(topic: string, error: Error): void;
+    onBatchFull(batchSize: number): void;
+}
+//# sourceMappingURL=MetricsObserver.d.ts.map

package/dist/observers/MetricsObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsObserver.d.ts","sourceRoot":"","sources":["../../src/observers/MetricsObserver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAClD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,kBAAkB;IAChE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI3D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAIjD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAGrC"}

package/dist/observers/MetricsObserver.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class MetricsObserver {
+    onPublishSuccess(topic, messageCount) {
+        console.log(`Published ${messageCount} messages to ${topic}`);
+    }
+    onPublishError(topic, error) {
+        console.error(`Failed to publish to ${topic}:`, error);
+    }
+    onBatchFull(batchSize) {
+        console.log(`Batch full with ${batchSize} messages, flushing...`);
+    }
+}
+exports.default = MetricsObserver;
+//# sourceMappingURL=MetricsObserver.js.map

package/dist/observers/MetricsObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsObserver.js","sourceRoot":"","sources":["../../src/observers/MetricsObserver.ts"],"names":[],"mappings":";;AAMA,MAAqB,eAAe;IAClC,gBAAgB,CAAC,KAAa,EAAE,YAAoB;QAClD,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,gBAAgB,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,KAAY;QACxC,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,OAAO,CAAC,GAAG,CAAC,mBAAmB,SAAS,wBAAwB,CAAC,CAAC;IACpE,CAAC;CACF;AAZD,kCAYC"}

package/dist/publishers/BasePublisher.d.ts

@@ -0,0 +1,15 @@
+import ITransportAdapter from '../adapters/ITransportAdapter';
+import { IAnalyticsObserver } from '../observers/MetricsObserver';
+import { AnalyticsData } from '../types';
+export default abstract class BasePublisher {
+    protected adapter: ITransportAdapter;
+    protected observers: IAnalyticsObserver[];
+    constructor(adapter: ITransportAdapter);
+    addObserver(observer: IAnalyticsObserver): void;
+    publish(topic: string, key: string, message: AnalyticsData): Promise<void>;
+    protected beforePublish(message: AnalyticsData): Promise<void>;
+    protected afterPublish(_message: AnalyticsData): Promise<void>;
+    protected onPublishError(topic: string, _error: Error): Promise<void>;
+    protected abstract validateMessage(message: unknown): void;
+}
+//# sourceMappingURL=BasePublisher.d.ts.map

package/dist/publishers/BasePublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePublisher.d.ts","sourceRoot":"","sources":["../../src/publishers/BasePublisher.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,aAAa;IACzC,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACrC,SAAS,CAAC,SAAS,EAAE,kBAAkB,EAAE,CAAM;gBAEnC,OAAO,EAAE,iBAAiB;IAKtC,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAKzC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cA8BhE,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAOpD,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;cAKpD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAC3D"}

package/dist/publishers/BasePublisher.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class BasePublisher {
+    constructor(adapter) {
+        this.observers = [];
+        this.adapter = adapter;
+        console.log('BasePublisher: Initialized with adapter:', adapter.constructor.name);
+    }
+    addObserver(observer) {
+        this.observers.push(observer);
+        console.log('BasePublisher: Observer added:', observer.constructor.name);
+    }
+    async publish(topic, key, message) {
+        console.log(`BasePublisher: Publishing message to topic "${topic}" with key "${key}"`);
+        console.log('BasePublisher: Message content:', message);
+        try {
+            console.log('BasePublisher: Running beforePublish hooks');
+            await this.beforePublish(message);
+            console.log('BasePublisher: Sending message through adapter');
+            await this.adapter.publish(topic, key, message);
+            console.log('BasePublisher: Running afterPublish hooks');
+            await this.afterPublish(message);
+            console.log(`BasePublisher: Message published successfully to topic "${topic}"`);
+            this.observers.forEach(obs => {
+                obs.onPublishSuccess(topic, 1);
+                console.log('BasePublisher: Notified observer of success:', obs.constructor.name);
+            });
+        }
+        catch (error) {
+            console.error(`BasePublisher: Error publishing message to topic "${topic}":`, error);
+            await this.onPublishError(topic, error);
+            this.observers.forEach(obs => {
+                obs.onPublishError(topic, error);
+                console.log('BasePublisher: Notified observer of error:', obs.constructor.name);
+            });
+            throw error;
+        }
+    }
+    async beforePublish(message) {
+        console.log('BasePublisher: Validating message');
+        this.validateMessage(message);
+        console.log('BasePublisher: Message validation complete');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async afterPublish(_message) {
+        // Can add logs here if needed
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async onPublishError(topic, _error) {
+        console.log(`BasePublisher: Handling publish error for topic "${topic}"`);
+    }
+}
+exports.default = BasePublisher;
+//# sourceMappingURL=BasePublisher.js.map

package/dist/publishers/BasePublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePublisher.js","sourceRoot":"","sources":["../../src/publishers/BasePublisher.ts"],"names":[],"mappings":";;AAIA,MAA8B,aAAa;IAIzC,YAAY,OAA0B;QAF5B,cAAS,GAAyB,EAAE,CAAC;QAG7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,0CAA0C,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpF,CAAC;IAED,WAAW,CAAC,QAA4B;QACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,GAAW,EAAE,OAAsB;QAC9D,OAAO,CAAC,GAAG,CAAC,+CAA+C,KAAK,eAAe,GAAG,GAAG,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAElC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAEhD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAEjC,OAAO,CAAC,GAAG,CAAC,2DAA2D,KAAK,GAAG,CAAC,CAAC;YACjF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC3B,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,8CAA8C,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACpF,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qDAAqD,KAAK,IAAI,EAAE,KAAK,CAAC,CAAC;YACrF,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAc,CAAC,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBAC3B,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,KAAc,CAAC,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,4CAA4C,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAES,KAAK,CAAC,aAAa,CAAC,OAAsB;QAClD,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,6DAA6D;IACnD,KAAK,CAAC,YAAY,CAAC,QAAuB;QAClD,8BAA8B;IAChC,CAAC;IAED,6DAA6D;IACnD,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,MAAa;QACzD,OAAO,CAAC,GAAG,CAAC,oDAAoD,KAAK,GAAG,CAAC,CAAC;IAC5E,CAAC;CAGF;AA7DD,gCA6DC"}

package/dist/publishers/ClientPublisher.d.ts

@@ -0,0 +1,6 @@
+import { Client } from '../types';
+import BasePublisher from './BasePublisher';
+export default class ClientPublisher extends BasePublisher {
+    protected validateMessage(message: Client): void;
+}
+//# sourceMappingURL=ClientPublisher.d.ts.map

package/dist/publishers/ClientPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientPublisher.d.ts","sourceRoot":"","sources":["../../src/publishers/ClientPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAa;IACxD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAwBjD"}

package/dist/publishers/ClientPublisher.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BasePublisher_1 = __importDefault(require("./BasePublisher"));
+class ClientPublisher extends BasePublisher_1.default {
+    validateMessage(message) {
+        if (!message.clientId || !message.tenantId || !message.captureId) {
+            throw new Error('Client message missing required fields: clientId, tenantId, or captureId');
+        }
+        if (!message.clientCreated || !message.clientIp || !message.clientUserAgent) {
+            throw new Error('Client message missing required client fields: clientCreated, clientIp, or clientUserAgent');
+        }
+        if (!message.dataResidency || !message.country) {
+            throw new Error('Client message missing required location fields: dataResidency or country');
+        }
+        if (typeof message.clientScreenWidth !== 'number' ||
+            typeof message.clientScreenHeight !== 'number' ||
+            typeof message.clientScreenColorDepth !== 'number' ||
+            typeof message.clientScreenPixelDepth !== 'number') {
+            throw new Error('Client message missing or invalid screen properties');
+        }
+    }
+}
+exports.default = ClientPublisher;
+//# sourceMappingURL=ClientPublisher.js.map

package/dist/publishers/ClientPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientPublisher.js","sourceRoot":"","sources":["../../src/publishers/ClientPublisher.ts"],"names":[],"mappings":";;;;;AACA,oEAA4C;AAE5C,MAAqB,eAAgB,SAAQ,uBAAa;IAC9C,eAAe,CAAC,OAAe;QACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QAED,IACE,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ;YAC7C,OAAO,OAAO,CAAC,kBAAkB,KAAK,QAAQ;YAC9C,OAAO,OAAO,CAAC,sBAAsB,KAAK,QAAQ;YAClD,OAAO,OAAO,CAAC,sBAAsB,KAAK,QAAQ,EAClD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AAzBD,kCAyBC"}

package/dist/publishers/EventPublisher.d.ts

@@ -0,0 +1,6 @@
+import { Event } from '../types';
+import BasePublisher from './BasePublisher';
+export default class EventPublisher extends BasePublisher {
+    protected validateMessage(message: Event): void;
+}
+//# sourceMappingURL=EventPublisher.d.ts.map

package/dist/publishers/EventPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventPublisher.d.ts","sourceRoot":"","sources":["../../src/publishers/EventPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAa;IACvD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI;CAKhD"}

package/dist/publishers/EventPublisher.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BasePublisher_1 = __importDefault(require("./BasePublisher"));
+class EventPublisher extends BasePublisher_1.default {
+    validateMessage(message) {
+        if (!message.captureId) {
+            throw new Error('Invalid message type: expected Event');
+        }
+    }
+}
+exports.default = EventPublisher;
+//# sourceMappingURL=EventPublisher.js.map

package/dist/publishers/EventPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventPublisher.js","sourceRoot":"","sources":["../../src/publishers/EventPublisher.ts"],"names":[],"mappings":";;;;;AACA,oEAA4C;AAE5C,MAAqB,cAAe,SAAQ,uBAAa;IAC7C,eAAe,CAAC,OAAc;QACtC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAND,iCAMC"}

package/dist/publishers/SessionPublisher.d.ts

@@ -0,0 +1,6 @@
+import { Session } from '../types';
+import BasePublisher from './BasePublisher';
+export default class SessionPublisher extends BasePublisher {
+    protected validateMessage(message: Session): void;
+}
+//# sourceMappingURL=SessionPublisher.d.ts.map

package/dist/publishers/SessionPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPublisher.d.ts","sourceRoot":"","sources":["../../src/publishers/SessionPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,aAAa;IACzD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAKlD"}

package/dist/publishers/SessionPublisher.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BasePublisher_1 = __importDefault(require("./BasePublisher"));
+class SessionPublisher extends BasePublisher_1.default {
+    validateMessage(message) {
+        if (!message.sessionId || !message.tenantId) {
+            throw new Error('Session message missing required fields');
+        }
+    }
+}
+exports.default = SessionPublisher;
+//# sourceMappingURL=SessionPublisher.js.map

package/dist/publishers/SessionPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPublisher.js","sourceRoot":"","sources":["../../src/publishers/SessionPublisher.ts"],"names":[],"mappings":";;;;;AACA,oEAA4C;AAE5C,MAAqB,gBAAiB,SAAQ,uBAAa;IAC/C,eAAe,CAAC,OAAgB;QACxC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;CACF;AAND,mCAMC"}

package/dist/types/index.d.ts

@@ -0,0 +1,85 @@
+export interface Event {
+    captureId: string;
+    tenantId: string;
+    spaceId: string;
+    sessionId: string;
+    clientId: string;
+    eventType: string;
+    eventTime: string | Date;
+    interaction: boolean;
+    ip: string;
+    dataResidency: string;
+    productId?: string;
+    categoryId?: string;
+    int1?: number;
+    int2?: number;
+    int3?: number;
+    int4?: number;
+    int5?: number;
+    str1?: string;
+    str2?: string;
+    str3?: string;
+    str4?: string;
+    str5?: string;
+}
+export interface Session {
+    tenantId: string;
+    sessionId: string;
+    sessionCreated: string | Date;
+    environment: string;
+    dataResidency: string;
+    country: string;
+    spaceId: string;
+    appId: string;
+    appVersion?: string;
+    installationVersion?: string;
+    installationId: string;
+    deviceId?: string;
+    clientId: string;
+    ip: string;
+    locationAccuracy: number;
+    latitude: number;
+    longitude: number;
+    captureId: string;
+}
+export interface Client {
+    captureId: string;
+    tenantId: string;
+    clientId: string;
+    clientCreated: string | Date;
+    clientIp: string;
+    clientUserAgent: string;
+    dataResidency: string;
+    country: string;
+    locationAccuracy: number;
+    latitude: number;
+    longitude: number;
+    clientScreenWidth: number;
+    clientScreenHeight: number;
+    clientScreenColorDepth: number;
+    clientScreenPixelDepth: number;
+    clientDeviceVendor: string;
+    clientDeviceModel: string;
+    clientDeviceType: string;
+    clientOsName: string;
+    clientOsVersion: string;
+    clientBrowserName: string;
+    clientBrowserVersion: string;
+    clientBrowserMajor: string;
+    clientBrowserEngine: string;
+    clientBrowserEngineVersion: string;
+    clientCpuArchitecture: string;
+}
+export type AnalyticsData = Event | Session | Client;
+export declare enum Topic {
+    ANALYTICS_SESSION = "sessions",
+    ANALYTICS_EVENT = "events",
+    ANALYTICS_CLIENT = "clients"
+}
+export declare enum EventType {
+    ANALYTICS_SESSION = "sessions",
+    ANALYTICS_EVENT = "events",
+    ANALYTICS_CLIENT = "clients"
+}
+export type AdapterType = 'eventHub' | 'kafka';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventType = exports.Topic = void 0;
+var Topic;
+(function (Topic) {
+    Topic["ANALYTICS_SESSION"] = "sessions";
+    Topic["ANALYTICS_EVENT"] = "events";
+    Topic["ANALYTICS_CLIENT"] = "clients";
+})(Topic || (exports.Topic = Topic = {}));
+var EventType;
+(function (EventType) {
+    EventType["ANALYTICS_SESSION"] = "sessions";
+    EventType["ANALYTICS_EVENT"] = "events";
+    EventType["ANALYTICS_CLIENT"] = "clients";
+})(EventType || (exports.EventType = EventType = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA4EA,IAAY,KAIX;AAJD,WAAY,KAAK;IACf,uCAA8B,CAAA;IAC9B,mCAA0B,CAAA;IAC1B,qCAA4B,CAAA;AAC9B,CAAC,EAJW,KAAK,qBAAL,KAAK,QAIhB;AAED,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,2CAA8B,CAAA;IAC9B,uCAA0B,CAAA;IAC1B,yCAA4B,CAAA;AAC9B,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB"}

package/examples/eventhub.ts

@@ -0,0 +1,188 @@
+/**
+ * EventHub Usage Example
+ *
+ * This example demonstrates how to use the AnalyticsClient with EventHub adapter.
+ * Run this with: npm run example:eventhub
+ */
+
+import { EventHubConfig } from '../src/adapters/event-hub/EventHubAdapter';
+import { AnalyticsClient } from '../src/client/AnalyticsClient';
+
+async function main() {
+  console.log('🚀 Starting EventHub Analytics Client Example...');
+
+  // EventHub adapter configuration
+  const eventHubAnalytics = new AnalyticsClient({
+    adapter: 'eventHub',
+    adapterConfig: {
+      dataResidency: {
+        EU: {
+          events:
+            'Endpoint=sb://example-eu-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-event;SharedAccessKey=FAKE_KEY_EU_EVENTS_1234567890abcdef;EntityPath=signals-event',
+          sessions:
+            'Endpoint=sb://example-eu-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-session;SharedAccessKey=FAKE_KEY_EU_SESSIONS_1234567890abcdef;EntityPath=signals-session',
+          clients:
+            'Endpoint=sb://example-eu-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-client;SharedAccessKey=FAKE_KEY_EU_CLIENTS_1234567890abcdef;EntityPath=signals-client',
+        },
+        US: {
+          events:
+            'Endpoint=sb://example-us-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-event;SharedAccessKey=FAKE_KEY_US_EVENTS_1234567890abcdef;EntityPath=signals-event',
+          sessions:
+            'Endpoint=sb://example-us-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-session;SharedAccessKey=FAKE_KEY_US_SESSIONS_1234567890abcdef;EntityPath=signals-session',
+          clients:
+            'Endpoint=sb://example-us-eventhub.servicebus.windows.net/;SharedAccessKeyName=signals-client;SharedAccessKey=FAKE_KEY_US_CLIENTS_1234567890abcdef;EntityPath=signals-client',
+        },
+      },
+    } as EventHubConfig,
+    bufferSize: 50,
+    flushIntervalMs: 3000,
+    maxRetries: 3,
+    enableMetricsLogging: true,
+  });
+
+  try {
+    console.log('🔧 Initializing EventHub analytics client...');
+    await eventHubAnalytics.init();
+    console.log('✅ EventHub analytics client initialized');
+
+    console.log('☁️ Publishing sample events to EventHub...');
+
+    // Publish Event
+    await eventHubAnalytics.publishEvent({
+      captureId: 'capture-456',
+      tenantId: 'company-y',
+      spaceId: 'space-456',
+      sessionId: 'session_456',
+      clientId: 'client-789',
+      eventType: 'page_view',
+      eventTime: new Date().toDateString(),
+      interaction: false,
+      ip: '192.168.1.200',
+      dataResidency: 'EU',
+      str1: '/dashboard',
+      str2: 'user-portal',
+    });
+
+    console.log('✅ Event published to EventHub successfully');
+
+    // Publish Session
+    await eventHubAnalytics.publishSession({
+      sessionId: 'session_456',
+      tenantId: 'company-y',
+      sessionCreated: new Date().toISOString(),
+      environment: 'staging',
+      dataResidency: 'EU',
+      country: 'Germany',
+      spaceId: 'space-456',
+      appId: 'mobile-app',
+      appVersion: '2.0.0',
+      installationVersion: '2.0.0',
+      installationId: 'install-789',
+      deviceId: 'device-456',
+      clientId: 'client-789',
+      ip: '192.168.1.200',
+      locationAccuracy: 15,
+      latitude: 52.52,
+      longitude: 13.405,
+      captureId: 'capture-456',
+    });
+
+    console.log('✅ Session published to EventHub successfully');
+
+    // Publish Client
+    await eventHubAnalytics.publishClient({
+      clientId: 'client-789',
+      tenantId: 'company-y',
+      clientCreated: new Date().toISOString(),
+      clientUserAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+      clientScreenWidth: 1920,
+      clientScreenHeight: 1080,
+      clientScreenColorDepth: 24,
+      clientScreenPixelDepth: 24,
+      clientIp: '192.168.1.200',
+      dataResidency: 'EU',
+      country: 'Germany',
+      latitude: 52.52,
+      longitude: 13.405,
+      locationAccuracy: 15,
+      captureId: 'capture-456',
+      clientDeviceVendor: 'Microsoft',
+      clientDeviceModel: 'Surface Pro',
+      clientDeviceType: 'tablet',
+      clientOsName: 'Windows',
+      clientOsVersion: '10.0',
+      clientBrowserName: 'Chrome',
+      clientBrowserVersion: '120.0.0.0',
+      clientBrowserMajor: '120',
+      clientBrowserEngine: 'Blink',
+      clientBrowserEngineVersion: '120.0.0.0',
+      clientCpuArchitecture: 'x64',
+    });
+
+    console.log('✅ Client published to EventHub successfully');
+
+    // Batch publishing example
+    const events = [
+      {
+        captureId: 'capture-456',
+        tenantId: 'company-y',
+        spaceId: 'space-456',
+        sessionId: 'session_456',
+        clientId: 'client-789',
+        eventType: 'page_view',
+        eventTime: new Date().toISOString(),
+        interaction: false,
+        ip: '192.168.1.200',
+        dataResidency: 'EU',
+        str1: '/products',
+      },
+      {
+        captureId: 'capture-456',
+        tenantId: 'company-y',
+        spaceId: 'space-456',
+        sessionId: 'session_456',
+        clientId: 'client-789',
+        eventType: 'product_view',
+        eventTime: new Date().toISOString(),
+        interaction: true,
+        ip: '192.168.1.200',
+        dataResidency: 'EU',
+        productId: 'product-456',
+        str1: 'electronics',
+      },
+      {
+        captureId: 'capture-456',
+        tenantId: 'company-y',
+        spaceId: 'space-456',
+        sessionId: 'session_456',
+        clientId: 'client-789',
+        eventType: 'add_to_cart',
+        eventTime: new Date().toISOString(),
+        interaction: true,
+        ip: '192.168.1.200',
+        dataResidency: 'EU',
+        productId: 'product-456',
+        int1: 2,
+        str1: 'electronics',
+      },
+    ];
+
+    console.log('📦 Publishing batch events to EventHub...');
+    for (const event of events) {
+      await eventHubAnalytics.publishEvent(event);
+    }
+
+    console.log('✅ Multiple events published to EventHub (batched)');
+
+    console.log('⏳ Waiting for batch flush...');
+    await new Promise(resolve => setTimeout(resolve, 4000));
+  } catch (error) {
+    console.error('❌ Error publishing analytics:', error);
+  } finally {
+    console.log('🔒 Closing EventHub analytics client...');
+    await eventHubAnalytics.close();
+    console.log('✅ EventHub analytics client closed');
+  }
+}
+
+main().catch(console.error);