@thirdweb-dev/service-utils 0.8.4 → 0.8.5-nightly-ccf6329810c1426fadc4483660e154ae38a2927b-20250205043811

package/dist/cjs/core/usageV2.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTopicName = getTopicName;
-function getTopicName(productName) {
-    return `usage_v2.raw_${productName}`;
+function getTopicName(source) {
+    return `usage_v2.raw_${source}`;
 }
 //# sourceMappingURL=usageV2.js.map

package/dist/cjs/core/usageV2.js.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":";;AAuDA,oCAEC;AAFD,SAAgB,YAAY,CAAC,WAAwB;IACnD,OAAO,gBAAgB,WAAW,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":";;AAyDA,oCAEC;AAFD,SAAgB,YAAY,CAAC,MAAqB;IAChD,OAAO,gBAAgB,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/cjs/node/kafka.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KafkaProducer = void 0;
+const node_tls_1 = require("node:tls");
+const kafkajs_1 = require("kafkajs");
+const lz4js_1 = require("lz4js");
+// CompressionCodecs is not exported properly in kafkajs. Source: https://github.com/tulios/kafkajs/issues/1391
+const kafkajs_2 = require("kafkajs");
+const { CompressionCodecs } = kafkajs_2.default;
+/**
+ * Creates a KafkaProducer which opens a persistent TCP connection.
+ * This class is thread-safe so your service should re-use one instance.
+ *
+ * Example:
+ * ```ts
+ * kafka = new KafkaProducer(...)
+ * await kafka.send(topic, events)
+ * // Non-blocking:
+ * // void kafka.send(topic, events).catch((e) => console.error(e))
+ * ```
+ */
+class KafkaProducer {
+    constructor(config) {
+        Object.defineProperty(this, "kafka", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "producer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "compression", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const { producerName, environment, shouldCompress = true, username, password, } = config;
+        this.kafka = new kafkajs_1.Kafka({
+            clientId: `${producerName}-${environment}`,
+            brokers: environment === "production"
+                ? ["warpstream.thirdweb.xyz:9092"]
+                : ["warpstream-dev.thirdweb.xyz:9092"],
+            ssl: {
+                checkServerIdentity(hostname, cert) {
+                    return (0, node_tls_1.checkServerIdentity)(hostname.toLowerCase(), cert);
+                },
+            },
+            sasl: {
+                mechanism: "plain",
+                username,
+                password,
+            },
+        });
+        if (shouldCompress) {
+            this.compression = kafkajs_1.CompressionTypes.LZ4;
+            CompressionCodecs[kafkajs_1.CompressionTypes.LZ4] = () => ({
+                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                compress: (encoder) => {
+                    const compressed = (0, lz4js_1.compress)(encoder.buffer);
+                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                    return Buffer.from(compressed);
+                },
+                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                decompress: (buffer) => {
+                    const decompressed = (0, lz4js_1.decompress)(buffer);
+                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                    return Buffer.from(decompressed);
+                },
+            });
+        }
+        else {
+            this.compression = kafkajs_1.CompressionTypes.None;
+        }
+    }
+    /**
+     * Send messages to a Kafka topic.
+     * This method may throw. To call this non-blocking:
+     * @param topic
+     * @param messages
+     * @param configOverrides
+     */
+    async send(topic, messages, 
+    /**
+     * Reference: https://kafka.js.org/docs/producing#producing-messages
+     */
+    options) {
+        if (!this.producer) {
+            this.producer = this.kafka.producer({
+                allowAutoTopicCreation: options?.allowAutoTopicCreation ?? false,
+            });
+            await this.producer.connect();
+        }
+        await this.producer.send({
+            topic,
+            messages: messages.map((m) => ({
+                value: JSON.stringify(m),
+            })),
+            compression: this.compression,
+            acks: options?.acks ?? -1, // Default: All brokers must acknowledge
+            timeout: options?.timeout ?? 10_000, // Default: 10 seconds
+        });
+    }
+    /**
+     * Disconnects KafkaProducer.
+     * Useful when shutting down the service to flush in-flight events.
+     */
+    async disconnect() {
+        if (this.producer) {
+            await this.producer.disconnect();
+            this.producer = null;
+        }
+    }
+}
+exports.KafkaProducer = KafkaProducer;
+//# sourceMappingURL=kafka.js.map

package/dist/cjs/node/kafka.js.map

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

package/dist/cjs/node/usageV2.js

@@ -2,10 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsageV2Producer = void 0;
 const node_crypto_1 = require("node:crypto");
-const node_tls_1 = require("node:tls");
-const kafkajs_1 = require("kafkajs");
-const lz4js_1 = require("lz4js");
 const usageV2_js_1 = require("../core/usageV2.js");
+const kafka_js_1 = require("./kafka.js");
 /**
  * Creates a UsageV2Producer which opens a persistent TCP connection.
  * This class is thread-safe so your service should re-use one instance.
@@ -13,136 +11,61 @@ const usageV2_js_1 = require("../core/usageV2.js");
  * Example:
  * ```ts
  * usageV2 = new UsageV2Producer(..)
- * await usageV2.init()
  * await usageV2.sendEvents(events)
  * // Non-blocking:
- * // void usageV2.sendEvents(events).catch(console.error)
+ * // void usageV2.sendEvents(events).catch((e) => console.error(e))
  * ```
  */
 class UsageV2Producer {
     constructor(config) {
-        Object.defineProperty(this, "kafka", {
+        Object.defineProperty(this, "kafkaProducer", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "producer", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
         Object.defineProperty(this, "topic", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "compression", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
+        this.kafkaProducer = new kafka_js_1.KafkaProducer({
+            producerName: config.producerName,
+            environment: config.environment,
+            shouldCompress: config.shouldCompress,
+            username: config.username,
+            password: config.password,
         });
-        const { producerName, environment, productName, shouldCompress = true, username, password, } = config;
-        this.kafka = new kafkajs_1.Kafka({
-            clientId: `${producerName}-${environment}`,
-            brokers: environment === "production"
-                ? ["warpstream.thirdweb.xyz:9092"]
-                : ["warpstream-dev.thirdweb.xyz:9092"],
-            ssl: {
-                checkServerIdentity(hostname, cert) {
-                    return (0, node_tls_1.checkServerIdentity)(hostname.toLowerCase(), cert);
-                },
-            },
-            sasl: {
-                mechanism: "plain",
-                username,
-                password,
-            },
-        });
-        this.topic = (0, usageV2_js_1.getTopicName)(productName);
-        this.compression = shouldCompress
-            ? kafkajs_1.CompressionTypes.LZ4
-            : kafkajs_1.CompressionTypes.None;
-    }
-    /**
-     * Connect the producer.
-     * This must be called before calling `sendEvents()`.
-     */
-    async init(configOverrides) {
-        if (this.compression === kafkajs_1.CompressionTypes.LZ4) {
-            kafkajs_1.CompressionCodecs[kafkajs_1.CompressionTypes.LZ4] = () => ({
-                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                compress: (encoder) => {
-                    const compressed = (0, lz4js_1.compress)(encoder.buffer);
-                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                    return Buffer.from(compressed);
-                },
-                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                decompress: (buffer) => {
-                    const decompressed = (0, lz4js_1.decompress)(buffer);
-                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                    return Buffer.from(decompressed);
-                },
-            });
-        }
-        this.producer = this.kafka.producer({
-            allowAutoTopicCreation: false,
-            ...configOverrides,
-        });
-        await this.producer.connect();
+        this.topic = (0, usageV2_js_1.getTopicName)(config.source);
     }
     /**
      * Send usageV2 events.
      * This method may throw. To call this non-blocking:
-     *
-     * ```ts
-     * usageV2 = new UsageV2Producer(...)
-     * void usageV2.sendEvents(events).catch(console.error)
-     *
-     * @param events - The events to send.
+     * @param events
      */
     async sendEvents(events, 
     /**
      * Reference: https://kafka.js.org/docs/producing#producing-messages
      */
-    configOverrides) {
-        if (!this.producer) {
-            throw new Error("Producer not initialized. Call `init()` first.");
-        }
-        const parsedEvents = events.map((event) => {
-            return {
-                ...event,
-                id: event.id ?? (0, node_crypto_1.randomUUID)(),
-                created_at: event.created_at ?? new Date(),
-                // Remove the "team_" prefix, if any.
-                team_id: event.team_id.startsWith("team_")
-                    ? event.team_id.slice(5)
-                    : event.team_id,
-            };
-        });
-        await this.producer.send({
-            topic: this.topic,
-            messages: parsedEvents.map((event) => ({
-                value: JSON.stringify(event),
-            })),
-            acks: -1, // All brokers must acknowledge
-            timeout: 10_000, // 10 seconds
-            compression: this.compression,
-            ...configOverrides,
-        });
+    options) {
+        const parsedEvents = events.map((event) => ({
+            ...event,
+            id: event.id ?? (0, node_crypto_1.randomUUID)(),
+            created_at: event.created_at ?? new Date(),
+            // Remove the "team_" prefix, if any.
+            team_id: event.team_id.startsWith("team_")
+                ? event.team_id.slice(5)
+                : event.team_id,
+        }));
+        await this.kafkaProducer.send(this.topic, parsedEvents, options);
     }
     /**
      * Disconnects UsageV2Producer.
      * Useful when shutting down the service to flush in-flight events.
      */
     async disconnect() {
-        if (this.producer) {
-            await this.producer.disconnect();
-            this.producer = null;
-        }
+        await this.kafkaProducer.disconnect();
     }
 }
 exports.UsageV2Producer = UsageV2Producer;

package/dist/cjs/node/usageV2.js.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,mDAI4B;AAC5B,yCAA2C;AAE3C;;;;;;;;;;;GAWG;AACH,MAAa,eAAe;IAI1B,YAAY,MAoBX;QAvBO;;;;;WAA6B;QAC7B;;;;;WAAc;QAuBpB,IAAI,CAAC,aAAa,GAAG,IAAI,wBAAa,CAAC;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,IAAA,yBAAY,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,MAAsB;IACtB;;OAEG;IACH,OAIC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,GAAG,KAAK;YACR,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAA,wBAAU,GAAE;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE;YAC1C,qCAAqC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;gBACxC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxB,CAAC,CAAC,KAAK,CAAC,OAAO;SAClB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;CACF;AAtED,0CAsEC"}

package/dist/esm/core/usageV2.js

@@ -1,4 +1,4 @@
-export function getTopicName(productName) {
-    return `usage_v2.raw_${productName}`;
+export function getTopicName(source) {
+    return `usage_v2.raw_${source}`;
 }
 //# sourceMappingURL=usageV2.js.map

package/dist/esm/core/usageV2.js.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":"AAuDA,MAAM,UAAU,YAAY,CAAC,WAAwB;IACnD,OAAO,gBAAgB,WAAW,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":"AAyDA,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,gBAAgB,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/esm/node/kafka.js

@@ -0,0 +1,116 @@
+import { checkServerIdentity } from "node:tls";
+import { CompressionTypes, Kafka } from "kafkajs";
+import { compress, decompress } from "lz4js";
+// CompressionCodecs is not exported properly in kafkajs. Source: https://github.com/tulios/kafkajs/issues/1391
+import KafkaJS from "kafkajs";
+const { CompressionCodecs } = KafkaJS;
+/**
+ * Creates a KafkaProducer which opens a persistent TCP connection.
+ * This class is thread-safe so your service should re-use one instance.
+ *
+ * Example:
+ * ```ts
+ * kafka = new KafkaProducer(...)
+ * await kafka.send(topic, events)
+ * // Non-blocking:
+ * // void kafka.send(topic, events).catch((e) => console.error(e))
+ * ```
+ */
+export class KafkaProducer {
+    constructor(config) {
+        Object.defineProperty(this, "kafka", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "producer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "compression", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const { producerName, environment, shouldCompress = true, username, password, } = config;
+        this.kafka = new Kafka({
+            clientId: `${producerName}-${environment}`,
+            brokers: environment === "production"
+                ? ["warpstream.thirdweb.xyz:9092"]
+                : ["warpstream-dev.thirdweb.xyz:9092"],
+            ssl: {
+                checkServerIdentity(hostname, cert) {
+                    return checkServerIdentity(hostname.toLowerCase(), cert);
+                },
+            },
+            sasl: {
+                mechanism: "plain",
+                username,
+                password,
+            },
+        });
+        if (shouldCompress) {
+            this.compression = CompressionTypes.LZ4;
+            CompressionCodecs[CompressionTypes.LZ4] = () => ({
+                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                compress: (encoder) => {
+                    const compressed = compress(encoder.buffer);
+                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                    return Buffer.from(compressed);
+                },
+                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                decompress: (buffer) => {
+                    const decompressed = decompress(buffer);
+                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
+                    return Buffer.from(decompressed);
+                },
+            });
+        }
+        else {
+            this.compression = CompressionTypes.None;
+        }
+    }
+    /**
+     * Send messages to a Kafka topic.
+     * This method may throw. To call this non-blocking:
+     * @param topic
+     * @param messages
+     * @param configOverrides
+     */
+    async send(topic, messages, 
+    /**
+     * Reference: https://kafka.js.org/docs/producing#producing-messages
+     */
+    options) {
+        if (!this.producer) {
+            this.producer = this.kafka.producer({
+                allowAutoTopicCreation: options?.allowAutoTopicCreation ?? false,
+            });
+            await this.producer.connect();
+        }
+        await this.producer.send({
+            topic,
+            messages: messages.map((m) => ({
+                value: JSON.stringify(m),
+            })),
+            compression: this.compression,
+            acks: options?.acks ?? -1, // Default: All brokers must acknowledge
+            timeout: options?.timeout ?? 10_000, // Default: 10 seconds
+        });
+    }
+    /**
+     * Disconnects KafkaProducer.
+     * Useful when shutting down the service to flush in-flight events.
+     */
+    async disconnect() {
+        if (this.producer) {
+            await this.producer.disconnect();
+            this.producer = null;
+        }
+    }
+}
+//# sourceMappingURL=kafka.js.map

package/dist/esm/node/kafka.js.map

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

package/dist/esm/node/usageV2.js

@@ -1,8 +1,6 @@
 import { randomUUID } from "node:crypto";
-import { checkServerIdentity } from "node:tls";
-import { CompressionCodecs, CompressionTypes, Kafka, } from "kafkajs";
-import { compress, decompress } from "lz4js";
-import { getTopicName } from "../core/usageV2.js";
+import { getTopicName, } from "../core/usageV2.js";
+import { KafkaProducer } from "./kafka.js";
 /**
  * Creates a UsageV2Producer which opens a persistent TCP connection.
  * This class is thread-safe so your service should re-use one instance.
@@ -10,136 +8,61 @@ import { getTopicName } from "../core/usageV2.js";
  * Example:
  * ```ts
  * usageV2 = new UsageV2Producer(..)
- * await usageV2.init()
  * await usageV2.sendEvents(events)
  * // Non-blocking:
- * // void usageV2.sendEvents(events).catch(console.error)
+ * // void usageV2.sendEvents(events).catch((e) => console.error(e))
  * ```
  */
 export class UsageV2Producer {
     constructor(config) {
-        Object.defineProperty(this, "kafka", {
+        Object.defineProperty(this, "kafkaProducer", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "producer", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
         Object.defineProperty(this, "topic", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "compression", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
+        this.kafkaProducer = new KafkaProducer({
+            producerName: config.producerName,
+            environment: config.environment,
+            shouldCompress: config.shouldCompress,
+            username: config.username,
+            password: config.password,
         });
-        const { producerName, environment, productName, shouldCompress = true, username, password, } = config;
-        this.kafka = new Kafka({
-            clientId: `${producerName}-${environment}`,
-            brokers: environment === "production"
-                ? ["warpstream.thirdweb.xyz:9092"]
-                : ["warpstream-dev.thirdweb.xyz:9092"],
-            ssl: {
-                checkServerIdentity(hostname, cert) {
-                    return checkServerIdentity(hostname.toLowerCase(), cert);
-                },
-            },
-            sasl: {
-                mechanism: "plain",
-                username,
-                password,
-            },
-        });
-        this.topic = getTopicName(productName);
-        this.compression = shouldCompress
-            ? CompressionTypes.LZ4
-            : CompressionTypes.None;
-    }
-    /**
-     * Connect the producer.
-     * This must be called before calling `sendEvents()`.
-     */
-    async init(configOverrides) {
-        if (this.compression === CompressionTypes.LZ4) {
-            CompressionCodecs[CompressionTypes.LZ4] = () => ({
-                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                compress: (encoder) => {
-                    const compressed = compress(encoder.buffer);
-                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                    return Buffer.from(compressed);
-                },
-                // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                decompress: (buffer) => {
-                    const decompressed = decompress(buffer);
-                    // biome-ignore lint/style/noRestrictedGlobals: kafkajs expects a Buffer
-                    return Buffer.from(decompressed);
-                },
-            });
-        }
-        this.producer = this.kafka.producer({
-            allowAutoTopicCreation: false,
-            ...configOverrides,
-        });
-        await this.producer.connect();
+        this.topic = getTopicName(config.source);
     }
     /**
      * Send usageV2 events.
      * This method may throw. To call this non-blocking:
-     *
-     * ```ts
-     * usageV2 = new UsageV2Producer(...)
-     * void usageV2.sendEvents(events).catch(console.error)
-     *
-     * @param events - The events to send.
+     * @param events
      */
     async sendEvents(events, 
     /**
      * Reference: https://kafka.js.org/docs/producing#producing-messages
      */
-    configOverrides) {
-        if (!this.producer) {
-            throw new Error("Producer not initialized. Call `init()` first.");
-        }
-        const parsedEvents = events.map((event) => {
-            return {
-                ...event,
-                id: event.id ?? randomUUID(),
-                created_at: event.created_at ?? new Date(),
-                // Remove the "team_" prefix, if any.
-                team_id: event.team_id.startsWith("team_")
-                    ? event.team_id.slice(5)
-                    : event.team_id,
-            };
-        });
-        await this.producer.send({
-            topic: this.topic,
-            messages: parsedEvents.map((event) => ({
-                value: JSON.stringify(event),
-            })),
-            acks: -1, // All brokers must acknowledge
-            timeout: 10_000, // 10 seconds
-            compression: this.compression,
-            ...configOverrides,
-        });
+    options) {
+        const parsedEvents = events.map((event) => ({
+            ...event,
+            id: event.id ?? randomUUID(),
+            created_at: event.created_at ?? new Date(),
+            // Remove the "team_" prefix, if any.
+            team_id: event.team_id.startsWith("team_")
+                ? event.team_id.slice(5)
+                : event.team_id,
+        }));
+        await this.kafkaProducer.send(this.topic, parsedEvents, options);
     }
     /**
      * Disconnects UsageV2Producer.
      * Useful when shutting down the service to flush in-flight events.
      */
     async disconnect() {
-        if (this.producer) {
-            await this.producer.disconnect();
-            this.producer = null;
-        }
+        await this.kafkaProducer.disconnect();
     }
 }
 //# sourceMappingURL=usageV2.js.map

package/dist/esm/node/usageV2.js.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IAI1B,YAAY,MAoBX;QAvBO;;;;;WAA6B;QAC7B;;;;;WAAc;QAuBpB,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,MAAsB;IACtB;;OAEG;IACH,OAIC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,GAAG,KAAK;YACR,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE;YAC1C,qCAAqC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;gBACxC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxB,CAAC,CAAC,KAAK,CAAC,OAAO;SAClB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/types/core/usageV2.d.ts

@@ -1,4 +1,5 @@
-import type { ServiceName } from "../node/index.js";
+import type { ServiceName } from "./services.js";
+export type UsageV2Source = ServiceName | "sdk";
 export interface UsageV2Event {
     /**
      * A unique identifier for the event. Defaults to a random UUID.
@@ -51,5 +52,5 @@ export interface UsageV2Event {
      */
     [key: string]: boolean | number | string | Date | null | undefined;
 }
-export declare function getTopicName(productName: ServiceName): string;
+export declare function getTopicName(source: UsageV2Source): string;
 //# sourceMappingURL=usageV2.d.ts.map

package/dist/types/core/usageV2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,EAAE,CAAC,EAAE,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;IACzD;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;CACpE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,UAEpD"}
+{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,EAAE,CAAC,EAAE,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;IACzD;;OAEG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;CACpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,UAEjD"}

package/dist/types/node/kafka.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Creates a KafkaProducer which opens a persistent TCP connection.
+ * This class is thread-safe so your service should re-use one instance.
+ *
+ * Example:
+ * ```ts
+ * kafka = new KafkaProducer(...)
+ * await kafka.send(topic, events)
+ * // Non-blocking:
+ * // void kafka.send(topic, events).catch((e) => console.error(e))
+ * ```
+ */
+export declare class KafkaProducer {
+    private kafka;
+    private producer;
+    private compression;
+    constructor(config: {
+        /**
+         * A descriptive name for your service. Example: "storage-server"
+         */
+        producerName: string;
+        /**
+         * The environment the service is running in.
+         */
+        environment: "development" | "production";
+        /**
+         * Whether to compress the events.
+         */
+        shouldCompress?: boolean;
+        username: string;
+        password: string;
+    });
+    /**
+     * Send messages to a Kafka topic.
+     * This method may throw. To call this non-blocking:
+     * @param topic
+     * @param messages
+     * @param configOverrides
+     */
+    send(topic: string, messages: Record<string, unknown>[], 
+    /**
+     * Reference: https://kafka.js.org/docs/producing#producing-messages
+     */
+    options?: {
+        acks?: number;
+        timeout?: number;
+        allowAutoTopicCreation?: boolean;
+    }): Promise<void>;
+    /**
+     * Disconnects KafkaProducer.
+     * Useful when shutting down the service to flush in-flight events.
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=kafka.d.ts.map

package/dist/types/node/kafka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.d.ts","sourceRoot":"","sources":["../../../src/node/kafka.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAmB;gBAE1B,MAAM,EAAE;QAClB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC;QAC1C;;WAEG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAiDD;;;;;;OAMG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,GACA,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;OAGG;IACG,UAAU;CAMjB"}

package/dist/types/node/usageV2.d.ts

@@ -1,6 +1,4 @@
-import { type ProducerConfig } from "kafkajs";
-import type { ServiceName } from "../core/services.js";
-import { type UsageV2Event } from "../core/usageV2.js";
+import { type UsageV2Event, type UsageV2Source } from "../core/usageV2.js";
 /**
  * Creates a UsageV2Producer which opens a persistent TCP connection.
  * This class is thread-safe so your service should re-use one instance.
@@ -8,17 +6,14 @@ import { type UsageV2Event } from "../core/usageV2.js";
  * Example:
  * ```ts
  * usageV2 = new UsageV2Producer(..)
- * await usageV2.init()
  * await usageV2.sendEvents(events)
  * // Non-blocking:
- * // void usageV2.sendEvents(events).catch(console.error)
+ * // void usageV2.sendEvents(events).catch((e) => console.error(e))
  * ```
  */
 export declare class UsageV2Producer {
-    private kafka;
-    private producer;
+    private kafkaProducer;
     private topic;
-    private compression;
     constructor(config: {
         /**
          * A descriptive name for your service. Example: "storage-server"
@@ -29,9 +24,9 @@ export declare class UsageV2Producer {
          */
         environment: "development" | "production";
         /**
-         * The product "source" where usage is coming from.
+         * The product where usage is coming from.
          */
-        productName: ServiceName;
+        source: UsageV2Source;
         /**
          * Whether to compress the events.
          */
@@ -39,28 +34,19 @@ export declare class UsageV2Producer {
         username: string;
         password: string;
     });
-    /**
-     * Connect the producer.
-     * This must be called before calling `sendEvents()`.
-     */
-    init(configOverrides?: ProducerConfig): Promise<void>;
     /**
      * Send usageV2 events.
      * This method may throw. To call this non-blocking:
-     *
-     * ```ts
-     * usageV2 = new UsageV2Producer(...)
-     * void usageV2.sendEvents(events).catch(console.error)
-     *
-     * @param events - The events to send.
+     * @param events
      */
     sendEvents(events: UsageV2Event[], 
     /**
      * Reference: https://kafka.js.org/docs/producing#producing-messages
      */
-    configOverrides?: {
+    options?: {
         acks?: number;
         timeout?: number;
+        allowAutoTopicCreation?: boolean;
     }): Promise<void>;
     /**
      * Disconnects UsageV2Producer.

package/dist/types/node/usageV2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAmB;gBAE1B,MAAM,EAAE;QAClB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC;QAC1C;;WAEG;QACH,WAAW,EAAE,WAAW,CAAC;QACzB;;WAEG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAkCD;;;OAGG;IACG,IAAI,CAAC,eAAe,CAAC,EAAE,cAAc;IAyB3C;;;;;;;;;OASG;IACG,UAAU,CACd,MAAM,EAAE,YAAY,EAAE;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;OAGG;IACG,UAAU;CAMjB"}
+{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE;QAClB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC;QAC1C;;WAEG;QACH,MAAM,EAAE,aAAa,CAAC;QACtB;;WAEG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAWD;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,YAAY,EAAE;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,GACA,OAAO,CAAC,IAAI,CAAC;IAahB;;;OAGG;IACG,UAAU;CAGjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdweb-dev/service-utils",
-  "version": "0.8.4",
+  "version": "0.8.5-nightly-ccf6329810c1426fadc4483660e154ae38a2927b-20250205043811",
   "type": "module",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -47,12 +47,12 @@
   "dependencies": {
     "aws4fetch": "1.0.20",
     "kafkajs": "2.2.4",
-    "lz4js": "^0.2.0",
+    "lz4js": "0.2.0",
     "zod": "3.24.1"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "4.20250129.0",
-    "@types/lz4js": "^0.2.1",
+    "@types/lz4js": "0.2.1",
     "@types/node": "22.13.0",
     "typescript": "5.7.3",
     "vitest": "3.0.4"