@thirdweb-dev/service-utils 0.6.1-nightly-69b1ee9176a34211eb8877d97f06a602b676635d-20250123000320 → 0.7.0

package/dist/cjs/cf-worker/usageV2.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendUsageV2Events = sendUsageV2Events;
+/**
+ * Send events to Kafka.
+ * This method may throw. To call this non-blocking:
+ *
+ * ```ts
+ * void sendUsageV2Events(events, {
+ *   environment: "production",
+ *   serviceKey: "..."
+ * }).catch(console.error)
+ * ```
+ *
+ * @param events - The events to send.
+ * @param options.environment - The environment the service is running in.
+ * @param options.serviceKey - The service key required for authentication.
+ */
+async function sendUsageV2Events(events, options) {
+    const baseUrl = options.environment === "production"
+        ? "https://u.thirdweb.com"
+        : "https://u.thirdweb-dev.com";
+    const resp = await fetch(`${baseUrl}/usage-v2/raw-events`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-service-api-key": options.serviceKey,
+        },
+        body: JSON.stringify({ events }),
+    });
+    if (!resp.ok) {
+        throw new Error(`[UsageV2] unexpected response ${resp.status}: ${await resp.text()}`);
+    }
+    resp.body?.cancel();
+}
+//# sourceMappingURL=usageV2.js.map

package/dist/cjs/cf-worker/usageV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/cf-worker/usageV2.ts"],"names":[],"mappings":";;AAiBA,8CA2BC;AA1CD;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,OAGC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,KAAK,YAAY;QAClC,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,4BAA4B,CAAC;IAEnC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,sBAAsB,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,mBAAmB,EAAE,OAAO,CAAC,UAAU;SACxC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AACtB,CAAC"}

package/dist/cjs/core/usageV2.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=usageV2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":""}

package/dist/cjs/node/usageV2.js

@@ -0,0 +1,115 @@
+"use strict";
+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 TOPIC_USAGE_V2 = "usage_v2.raw_events";
+/**
+ * Creates a UsageV2Producer which opens a persistent TCP connection.
+ * This class is thread-safe so your service should re-use one instance.
+ *
+ * Example:
+ * ```ts
+ * usageV2 = new UsageV2Producer(..)
+ * await usageV2.init()
+ * await usageV2.sendEvents(events)
+ * // Non-blocking:
+ * // void usageV2.sendEvents(events).catch(console.error)
+ * ```
+ */
+class UsageV2Producer {
+    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
+        });
+        this.kafka = new kafkajs_1.Kafka({
+            clientId: `${config.producerName}-${config.environment}`,
+            brokers: config.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: config.username,
+                password: config.password,
+            },
+        });
+    }
+    /**
+     * Connect the producer.
+     * This must be called before calling `sendEvents()`.
+     */
+    async init() {
+        this.producer = this.kafka.producer({
+            allowAutoTopicCreation: false,
+        });
+        await this.producer.connect();
+    }
+    /**
+     * 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.
+     */
+    async sendEvents(events) {
+        if (!this.producer) {
+            throw new Error("Producer not initialized. Call `init()` first.");
+        }
+        const parsedEvents = events.map((event) => {
+            return {
+                id: event.id ?? (0, node_crypto_1.randomUUID)(),
+                created_at: event.created_at ?? new Date(),
+                source: event.source,
+                action: event.action,
+                // Remove the "team_" prefix, if any.
+                team_id: event.team_id.startsWith("team_")
+                    ? event.team_id.slice(5)
+                    : event.team_id,
+                client_id: event.client_id,
+                sdk_name: event.sdk_name,
+                sdk_platform: event.sdk_platform,
+                sdk_version: event.sdk_version,
+                sdk_os: event.sdk_os,
+                product_name: event.product_name,
+                product_version: event.product_version,
+                data: JSON.stringify(event.data),
+            };
+        });
+        await this.producer.send({
+            topic: TOPIC_USAGE_V2,
+            messages: parsedEvents.map((event) => ({
+                value: JSON.stringify(event),
+            })),
+        });
+    }
+    /**
+     * 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;
+        }
+    }
+}
+exports.UsageV2Producer = UsageV2Producer;
+//# sourceMappingURL=usageV2.js.map

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

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

package/dist/esm/cf-worker/usageV2.js

@@ -0,0 +1,33 @@
+/**
+ * Send events to Kafka.
+ * This method may throw. To call this non-blocking:
+ *
+ * ```ts
+ * void sendUsageV2Events(events, {
+ *   environment: "production",
+ *   serviceKey: "..."
+ * }).catch(console.error)
+ * ```
+ *
+ * @param events - The events to send.
+ * @param options.environment - The environment the service is running in.
+ * @param options.serviceKey - The service key required for authentication.
+ */
+export async function sendUsageV2Events(events, options) {
+    const baseUrl = options.environment === "production"
+        ? "https://u.thirdweb.com"
+        : "https://u.thirdweb-dev.com";
+    const resp = await fetch(`${baseUrl}/usage-v2/raw-events`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-service-api-key": options.serviceKey,
+        },
+        body: JSON.stringify({ events }),
+    });
+    if (!resp.ok) {
+        throw new Error(`[UsageV2] unexpected response ${resp.status}: ${await resp.text()}`);
+    }
+    resp.body?.cancel();
+}
+//# sourceMappingURL=usageV2.js.map

package/dist/esm/cf-worker/usageV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/cf-worker/usageV2.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,OAGC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,KAAK,YAAY;QAClC,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,4BAA4B,CAAC;IAEnC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,sBAAsB,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,mBAAmB,EAAE,OAAO,CAAC,UAAU;SACxC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AACtB,CAAC"}

package/dist/esm/core/usageV2.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usageV2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.js","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":""}

package/dist/esm/node/usageV2.js

@@ -0,0 +1,111 @@
+import { randomUUID } from "node:crypto";
+import { checkServerIdentity } from "node:tls";
+import { Kafka } from "kafkajs";
+const TOPIC_USAGE_V2 = "usage_v2.raw_events";
+/**
+ * Creates a UsageV2Producer which opens a persistent TCP connection.
+ * This class is thread-safe so your service should re-use one instance.
+ *
+ * Example:
+ * ```ts
+ * usageV2 = new UsageV2Producer(..)
+ * await usageV2.init()
+ * await usageV2.sendEvents(events)
+ * // Non-blocking:
+ * // void usageV2.sendEvents(events).catch(console.error)
+ * ```
+ */
+export class UsageV2Producer {
+    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
+        });
+        this.kafka = new Kafka({
+            clientId: `${config.producerName}-${config.environment}`,
+            brokers: config.environment === "production"
+                ? ["warpstream.thirdweb.xyz:9092"]
+                : ["warpstream-dev.thirdweb.xyz:9092"],
+            ssl: {
+                checkServerIdentity(hostname, cert) {
+                    return checkServerIdentity(hostname.toLowerCase(), cert);
+                },
+            },
+            sasl: {
+                mechanism: "plain",
+                username: config.username,
+                password: config.password,
+            },
+        });
+    }
+    /**
+     * Connect the producer.
+     * This must be called before calling `sendEvents()`.
+     */
+    async init() {
+        this.producer = this.kafka.producer({
+            allowAutoTopicCreation: false,
+        });
+        await this.producer.connect();
+    }
+    /**
+     * 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.
+     */
+    async sendEvents(events) {
+        if (!this.producer) {
+            throw new Error("Producer not initialized. Call `init()` first.");
+        }
+        const parsedEvents = events.map((event) => {
+            return {
+                id: event.id ?? randomUUID(),
+                created_at: event.created_at ?? new Date(),
+                source: event.source,
+                action: event.action,
+                // Remove the "team_" prefix, if any.
+                team_id: event.team_id.startsWith("team_")
+                    ? event.team_id.slice(5)
+                    : event.team_id,
+                client_id: event.client_id,
+                sdk_name: event.sdk_name,
+                sdk_platform: event.sdk_platform,
+                sdk_version: event.sdk_version,
+                sdk_os: event.sdk_os,
+                product_name: event.product_name,
+                product_version: event.product_version,
+                data: JSON.stringify(event.data),
+            };
+        });
+        await this.producer.send({
+            topic: TOPIC_USAGE_V2,
+            messages: parsedEvents.map((event) => ({
+                value: JSON.stringify(event),
+            })),
+        });
+    }
+    /**
+     * 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;
+        }
+    }
+}
+//# sourceMappingURL=usageV2.js.map

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

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

package/dist/types/cf-worker/usageV2.d.ts

@@ -0,0 +1,21 @@
+import type { UsageV2Event } from "../core/usageV2.js";
+/**
+ * Send events to Kafka.
+ * This method may throw. To call this non-blocking:
+ *
+ * ```ts
+ * void sendUsageV2Events(events, {
+ *   environment: "production",
+ *   serviceKey: "..."
+ * }).catch(console.error)
+ * ```
+ *
+ * @param events - The events to send.
+ * @param options.environment - The environment the service is running in.
+ * @param options.serviceKey - The service key required for authentication.
+ */
+export declare function sendUsageV2Events(events: UsageV2Event[], options: {
+    environment: "development" | "production";
+    serviceKey: string;
+}): Promise<void>;
+//# sourceMappingURL=usageV2.d.ts.map

package/dist/types/cf-worker/usageV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/cf-worker/usageV2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE;IACP,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,IAAI,CAAC,CAqBf"}

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

@@ -0,0 +1,57 @@
+export interface UsageV2Event {
+    /**
+     * A unique identifier for the event. Defaults to a random UUID.
+     * Useful if your service retries sending events.
+     */
+    id?: `${string}-${string}-${string}-${string}-${string}`;
+    /**
+     * The event timestamp. Defaults to now().
+     */
+    created_at?: Date;
+    /**
+     * The source of the event. Example: "storage"
+     */
+    source: string;
+    /**
+     * The action of the event. Example: "upload"
+     */
+    action: string;
+    /**
+     * The team ID.
+     */
+    team_id: string;
+    /**
+     * The client ID, if available.
+     */
+    client_id?: string;
+    /**
+     * The SDK name, if available.
+     */
+    sdk_name?: string;
+    /**
+     * The SDK platform, if available.
+     */
+    sdk_platform?: string;
+    /**
+     * The SDK version, if available.
+     */
+    sdk_version?: string;
+    /**
+     * The SDK OS, if available.
+     */
+    sdk_os?: string;
+    /**
+     * The product name, if available.
+     */
+    product_name?: string;
+    /**
+     * The product version, if available.
+     */
+    product_version?: string;
+    /**
+     * An object of service-specific data. Example: "file_size_bytes"
+     * It is safe to pass any new JSON-serializable data here before updating the usageV2 schema.
+     */
+    data: Record<string, unknown>;
+}
+//# sourceMappingURL=usageV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/core/usageV2.ts"],"names":[],"mappings":"AAAA,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,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;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,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

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

@@ -0,0 +1,52 @@
+import type { UsageV2Event } 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.
+ *
+ * Example:
+ * ```ts
+ * usageV2 = new UsageV2Producer(..)
+ * await usageV2.init()
+ * await usageV2.sendEvents(events)
+ * // Non-blocking:
+ * // void usageV2.sendEvents(events).catch(console.error)
+ * ```
+ */
+export declare class UsageV2Producer {
+    private kafka;
+    private producer;
+    constructor(config: {
+        /**
+         * A descriptive name for your service. Example: "storage-server"
+         */
+        producerName: string;
+        /**
+         * The environment the service is running in.
+         */
+        environment: "development" | "production";
+        username: string;
+        password: string;
+    });
+    /**
+     * Connect the producer.
+     * This must be called before calling `sendEvents()`.
+     */
+    init(): 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.
+     */
+    sendEvents(events: UsageV2Event[]): Promise<void>;
+    /**
+     * Disconnects UsageV2Producer.
+     * Useful when shutting down the service to flush in-flight events.
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=usageV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageV2.d.ts","sourceRoot":"","sources":["../../../src/node/usageV2.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,MAAM,EAAE;QAClB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QACrB;;WAEG;QACH,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC;QAE1C,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAoBD;;;OAGG;IACG,IAAI;IAOV;;;;;;;;;OASG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCvD;;;OAGG;IACG,UAAU;CAMjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdweb-dev/service-utils",
-  "version": "0.6.1-nightly-69b1ee9176a34211eb8877d97f06a602b676635d-20250123000320",
+  "version": "0.7.0",
   "type": "module",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -46,6 +46,7 @@
   "sideEffects": false,
   "dependencies": {
     "aws4fetch": "1.0.20",
+    "kafkajs": "2.2.4",
     "zod": "3.24.1"
   },
   "devDependencies": {