@doow/track 0.1.0

package/dist/esm/tracker.js

@@ -0,0 +1,290 @@
+import { generateUUID } from './uuid.js';
+import { createDebugLogger } from './debug.js';
+import { Exporter } from './exporter.js';
+import { EventProcessor } from './event-processor.js';
+
+/**
+ * S76: DoowTracker — public API surface
+ *
+ * The customer-facing class. Four lines to start emitting:
+ *
+ *   import { DoowTracker } from '@doow/track';
+ *   const meter = new DoowTracker('dk_...');
+ *   meter.track({ metric: 'api_calls', quantity: 1, license_id: '...' });
+ *   await meter.shutdown();
+ */
+// ─── Defaults ──────────────────────────────────────────────────────────────
+const DEFAULTS = {
+    endpoint: 'https://api.doow.co',
+    enabled: true,
+    debug: false,
+    flushAt: 20,
+    flushInterval: 10000,
+    maxPayloadBytes: 450 * 1024,
+    maxQueueSize: 10000,
+    timeout: 10000,
+    retryCount: 3,
+    disableCompression: false,
+    maxConcurrentFlushes: 30,
+    shutdownTimeout: 5000,
+};
+// ─── Env var parsing ───────────────────────────────────────────────────────
+function resolveEnvOverrides(opts) {
+    const env = typeof process !== 'undefined' ? process.env : undefined;
+    // Spread opts without creating explicit undefined keys that would override DEFAULTS
+    const result = { ...opts };
+    if (env === null || env === void 0 ? void 0 : env.DOOW_TRACK_ENDPOINT)
+        result.endpoint = env.DOOW_TRACK_ENDPOINT;
+    if ((env === null || env === void 0 ? void 0 : env.DOOW_TRACK_DISABLED) === 'true')
+        result.enabled = false;
+    if ((env === null || env === void 0 ? void 0 : env.DOOW_TRACK_DEBUG) === 'true')
+        result.debug = true;
+    if ((env === null || env === void 0 ? void 0 : env.DOOW_TRACK_FLUSH_AT) !== undefined) {
+        const n = parseInt(env.DOOW_TRACK_FLUSH_AT, 10);
+        if (!isNaN(n) && n > 0)
+            result.flushAt = n;
+    }
+    if ((env === null || env === void 0 ? void 0 : env.DOOW_TRACK_FLUSH_INTERVAL) !== undefined) {
+        const n = parseInt(env.DOOW_TRACK_FLUSH_INTERVAL, 10);
+        if (!isNaN(n) && n > 0)
+            result.flushInterval = n;
+    }
+    if ((env === null || env === void 0 ? void 0 : env.DOOW_TRACK_ATTRIBUTION) !== undefined) {
+        try {
+            result.attribution = JSON.parse(env.DOOW_TRACK_ATTRIBUTION);
+        }
+        catch {
+            /* keep opts.attribution */
+        }
+    }
+    return result;
+}
+// ─── DoowTracker ───────────────────────────────────────────────────────────
+class DoowTracker {
+    constructor(apiKey, options = {}) {
+        var _a, _b, _c;
+        this._shutdownCalled = false;
+        this._sigHandlers = null;
+        // Validate API key prefix
+        const envApiKey = typeof process !== 'undefined' ? ((_a = process.env['DOOW_TRACK_API_KEY']) !== null && _a !== void 0 ? _a : apiKey) : apiKey;
+        if (!envApiKey.startsWith('dk_')) {
+            console.warn(`[doow/track] API key must start with "dk_". Got: "${envApiKey.slice(0, 10)}..."`);
+        }
+        this._apiKey = envApiKey;
+        // Merge options with env var overrides (env takes precedence)
+        const merged = resolveEnvOverrides(options);
+        // Log unknown options in debug mode
+        const knownKeys = new Set([
+            'endpoint',
+            'enabled',
+            'attribution',
+            'debug',
+            'flushAt',
+            'flushInterval',
+            'maxPayloadBytes',
+            'maxQueueSize',
+            'timeout',
+            'retryCount',
+            'disableCompression',
+            'onError',
+            'beforeSend',
+            'beforeFlush',
+            'transport',
+            'offlineStore',
+            'maxConcurrentFlushes',
+            'shutdownTimeout',
+        ]);
+        this._options = {
+            ...DEFAULTS,
+            ...merged,
+        };
+        const unknownKeys = Object.keys(options).filter((k) => !knownKeys.has(k));
+        const debugLogger = createDebugLogger((_b = this._options.debug) !== null && _b !== void 0 ? _b : false);
+        if (unknownKeys.length > 0) {
+            debugLogger.warn(`Unknown init options ignored: ${unknownKeys.join(', ')}`);
+        }
+        // If disabled — complete no-op, no buffers allocated
+        if (!this._options.enabled) {
+            debugLogger.log('SDK disabled — all operations are no-ops');
+            this._processor = null;
+            this._exporter = null;
+            return;
+        }
+        const onError = (_c = this._options.onError) !== null && _c !== void 0 ? _c : ((e) => console.warn(`[doow/track] ${e.kind}: ${e.message}`));
+        const exporterConfig = {
+            endpoint: this._options.endpoint,
+            apiKey: this._apiKey,
+            timeout: this._options.timeout,
+            retryCount: this._options.retryCount,
+            disableCompression: this._options.disableCompression,
+            maxConcurrentFlushes: this._options.maxConcurrentFlushes,
+            onError,
+            debug: debugLogger,
+        };
+        if (this._options.transport)
+            exporterConfig.transport = this._options.transport;
+        if (this._options.offlineStore)
+            exporterConfig.offlineStore = this._options.offlineStore;
+        this._exporter = new Exporter(exporterConfig);
+        const processorConfig = {
+            flushAt: this._options.flushAt,
+            flushInterval: this._options.flushInterval,
+            maxPayloadBytes: this._options.maxPayloadBytes,
+            maxQueueSize: this._options.maxQueueSize,
+            debug: debugLogger,
+        };
+        if (this._options.beforeSend)
+            processorConfig.beforeSend = this._options.beforeSend;
+        if (this._options.beforeFlush)
+            processorConfig.beforeFlush = this._options.beforeFlush;
+        this._processor = new EventProcessor(processorConfig, this._exporter);
+        if (typeof process !== 'undefined') {
+            const sigterm = () => {
+                void this.shutdown();
+            };
+            const beforeExit = () => {
+                void this.shutdown();
+            };
+            process.setMaxListeners(process.getMaxListeners() + 2);
+            process.on('SIGTERM', sigterm);
+            process.on('beforeExit', beforeExit);
+            this._sigHandlers = { sigterm, beforeExit };
+        }
+    }
+    /**
+     * Track a usage event.
+     * - Generates UUID v4 event_id at call time
+     * - Merges SDK-level attribution defaults
+     * - Enqueues to EventProcessor
+     * - No-op if SDK is disabled or stopped
+     */
+    track(event) {
+        var _a, _b, _c, _d;
+        if (!this._processor || !this._exporter)
+            return; // disabled
+        if (this._exporter.stopped)
+            return; // auth failure
+        if (this._shutdownCalled)
+            return;
+        const serialized = {
+            ...event,
+            event_id: generateUUID(),
+            timestamp: (_a = event.timestamp) !== null && _a !== void 0 ? _a : new Date().toISOString(),
+            attribution: {
+                ...((_b = this._options.attribution) !== null && _b !== void 0 ? _b : {}),
+                ...((_c = event.attribution) !== null && _c !== void 0 ? _c : {}),
+            },
+            kind: (_d = event.kind) !== null && _d !== void 0 ? _d : 'USAGE',
+        };
+        // Fire-and-forget enqueue — errors surface via onError
+        void this._processor.enqueue(serialized);
+    }
+    /**
+     * Manually flush the current buffer.
+     * Returns a Promise that resolves when the flush completes.
+     */
+    async flush() {
+        if (!this._processor)
+            return;
+        await this._processor.flush();
+    }
+    /**
+     * Drain all pending events and shut down.
+     * Registers SIGTERM + beforeExit handlers automatically.
+     * Best-effort — hard kill loses buffered events.
+     */
+    async shutdown(timeout) {
+        if (this._shutdownCalled)
+            return;
+        this._shutdownCalled = true;
+        // Remove signal handlers
+        if (this._sigHandlers && typeof process !== 'undefined') {
+            process.removeListener('SIGTERM', this._sigHandlers.sigterm);
+            process.removeListener('beforeExit', this._sigHandlers.beforeExit);
+            process.setMaxListeners(Math.max(0, process.getMaxListeners() - 2));
+            this._sigHandlers = null;
+        }
+        if (!this._processor)
+            return;
+        const timeoutMs = timeout !== null && timeout !== void 0 ? timeout : this._options.shutdownTimeout;
+        const shutdownPromise = this._processor.shutdown();
+        const timeoutPromise = new Promise((resolve) => setTimeout(resolve, timeoutMs));
+        await Promise.race([shutdownPromise, timeoutPromise]);
+    }
+    /** True if the SDK is enabled */
+    get enabled() {
+        return !!this._processor;
+    }
+    /** True if auth has failed and SDK stopped emitting */
+    get stopped() {
+        var _a, _b;
+        return (_b = (_a = this._exporter) === null || _a === void 0 ? void 0 : _a.stopped) !== null && _b !== void 0 ? _b : false;
+    }
+    /** S79: True if a per-category rate limit is currently active */
+    get rateLimited() {
+        var _a, _b;
+        return (_b = (_a = this._exporter) === null || _a === void 0 ? void 0 : _a.rateLimited) !== null && _b !== void 0 ? _b : false;
+    }
+    // ─── S81: Serverless wrappers ─────────────────────────────────────────────
+    /**
+     * Wrap an AWS Lambda handler.
+     * Sets flushAt=1 internally, calls shutdown() in a finally block.
+     *
+     * @example
+     * export const handler = meter.withLambda(async (event, context) => {
+     *   meter.track({ ... });
+     *   return { statusCode: 200 };
+     * });
+     */
+    withLambda(handler) {
+        // Override flushAt to 1 so every track() flushes immediately
+        if (this._processor) {
+            this._processor.setFlushAt(1);
+        }
+        return async (event, context) => {
+            try {
+                return await handler(event, context);
+            }
+            finally {
+                await this.flush();
+            }
+        };
+    }
+    /**
+     * Wrap a Vercel serverless function handler.
+     * Sets flushAt=1 internally, calls flush() in a finally block.
+     */
+    withVercel(handler) {
+        if (this._processor) {
+            this._processor.setFlushAt(1);
+        }
+        return async (req, res) => {
+            try {
+                await handler(req, res);
+            }
+            finally {
+                await this.flush();
+            }
+        };
+    }
+    /**
+     * Wrap an Azure Function handler.
+     * Sets flushAt=1 internally, calls flush() in a finally block.
+     */
+    withAzureFunction(handler) {
+        if (this._processor) {
+            this._processor.setFlushAt(1);
+        }
+        return async (context, input) => {
+            try {
+                return await handler(context, input);
+            }
+            finally {
+                await this.flush();
+            }
+        };
+    }
+}
+
+export { DoowTracker };
+//# sourceMappingURL=tracker.js.map

package/dist/esm/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sources":["../../../src/tracker.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;;;;;AASG;AASH;AAEA,MAAM,QAAQ,GAAG;AACf,IAAA,QAAQ,EAAE,qBAAqB;AAC/B,IAAA,OAAO,EAAE,IAAI;AACb,IAAA,KAAK,EAAE,KAAK;AACZ,IAAA,OAAO,EAAE,EAAE;AACX,IAAA,aAAa,EAAE,KAAM;IACrB,eAAe,EAAE,GAAG,GAAG,IAAI;AAC3B,IAAA,YAAY,EAAE,KAAM;AACpB,IAAA,OAAO,EAAE,KAAM;AACf,IAAA,UAAU,EAAE,CAAC;AACb,IAAA,kBAAkB,EAAE,KAAK;AACzB,IAAA,oBAAoB,EAAE,EAAE;AACxB,IAAA,eAAe,EAAE,IAAK;CACd;AAEV;AAEA,SAAS,mBAAmB,CAAC,IAAwB,EAAA;AACnD,IAAA,MAAM,GAAG,GACP,OAAO,OAAO,KAAK,WAAW,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS;;AAE1D,IAAA,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE;AAE1B,IAAA,IAAI,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,MAAA,GAAA,MAAA,GAAH,GAAG,CAAE,mBAAmB;AAAE,QAAA,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,mBAAmB;IACvE,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,uBAAH,GAAG,CAAE,mBAAmB,MAAK,MAAM;AAAE,QAAA,MAAM,CAAC,OAAO,GAAG,KAAK;IAC/D,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,uBAAH,GAAG,CAAE,gBAAgB,MAAK,MAAM;AAAE,QAAA,MAAM,CAAC,KAAK,GAAG,IAAI;IACzD,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,MAAA,GAAA,MAAA,GAAH,GAAG,CAAE,mBAAmB,MAAK,SAAS,EAAE;QAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AAAE,YAAA,MAAM,CAAC,OAAO,GAAG,CAAC;IAC5C;IACA,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,MAAA,GAAA,MAAA,GAAH,GAAG,CAAE,yBAAyB,MAAK,SAAS,EAAE;QAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AAAE,YAAA,MAAM,CAAC,aAAa,GAAG,CAAC;IAClD;IACA,IAAI,CAAA,GAAG,KAAA,IAAA,IAAH,GAAG,KAAA,MAAA,GAAA,MAAA,GAAH,GAAG,CAAE,sBAAsB,MAAK,SAAS,EAAE;AAC7C,QAAA,IAAI;YACF,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAA2B;QACvF;AAAE,QAAA,MAAM;;QAER;IACF;AAEA,IAAA,OAAO,MAAM;AACf;AAEA;MAEa,WAAW,CAAA;IAyBtB,WAAA,CAAY,MAAc,EAAE,OAAA,GAA8B,EAAE,EAAA;;QAHpD,IAAA,CAAA,eAAe,GAAG,KAAK;QACvB,IAAA,CAAA,YAAY,GAA2D,IAAI;;QAIjF,MAAM,SAAS,GACb,OAAO,OAAO,KAAK,WAAW,IAAI,CAAA,EAAA,GAAA,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,MAAM,IAAI,MAAM;QAEzF,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;AAChC,YAAA,OAAO,CAAC,IAAI,CACV,CAAA,kDAAA,EAAqD,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA,IAAA,CAAM,CAClF;QACH;AAEA,QAAA,IAAI,CAAC,OAAO,GAAG,SAAS;;AAGxB,QAAA,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC;;AAG3C,QAAA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;YACxB,UAAU;YACV,SAAS;YACT,aAAa;YACb,OAAO;YACP,SAAS;YACT,eAAe;YACf,iBAAiB;YACjB,cAAc;YACd,SAAS;YACT,YAAY;YACZ,oBAAoB;YACpB,SAAS;YACT,YAAY;YACZ,aAAa;YACb,WAAW;YACX,cAAc;YACd,sBAAsB;YACtB,iBAAiB;AAClB,SAAA,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG;AACd,YAAA,GAAG,QAAQ;AACX,YAAA,GAAG,MAAM;SACV;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEzE,QAAA,MAAM,WAAW,GAAG,iBAAiB,CAAC,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK,CAAC;AAEnE,QAAA,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;AAC1B,YAAA,WAAW,CAAC,IAAI,CAAC,CAAA,8BAAA,EAAiC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAAC;QAC7E;;AAGA,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;AAC1B,YAAA,WAAW,CAAC,GAAG,CAAC,0CAA0C,CAAC;AAC3D,YAAA,IAAI,CAAC,UAAU,GAAG,IAAI;AACtB,YAAA,IAAI,CAAC,SAAS,GAAG,IAAI;YACrB;QACF;AAEA,QAAA,MAAM,OAAO,GACX,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,IACpB,CAAC,CAAW,KAAW,OAAO,CAAC,IAAI,CAAC,CAAA,aAAA,EAAgB,CAAC,CAAC,IAAI,CAAA,EAAA,EAAK,CAAC,CAAC,OAAO,CAAA,CAAE,CAAC,CAAC;AAE/E,QAAA,MAAM,cAAc,GAAmB;AACrC,YAAA,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,MAAM,EAAE,IAAI,CAAC,OAAO;AACpB,YAAA,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;AAC9B,YAAA,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;AACpC,YAAA,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB;AACpD,YAAA,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,oBAAoB;YACxD,OAAO;AACP,YAAA,KAAK,EAAE,WAAW;SACnB;AACD,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS;YAAE,cAAc,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS;AAC/E,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY;YAAE,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY;QACxF,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,CAAC,cAAc,CAAC;AAE7C,QAAA,MAAM,eAAe,GAAoB;AACvC,YAAA,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;AAC9B,YAAA,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;AAC1C,YAAA,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe;AAC9C,YAAA,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;AACxC,YAAA,KAAK,EAAE,WAAW;SACnB;AACD,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU;YAAE,eAAe,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU;AACnF,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,eAAe,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW;AACtF,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC;AAErE,QAAA,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE;YAClC,MAAM,OAAO,GAAG,MAAW;AACzB,gBAAA,KAAK,IAAI,CAAC,QAAQ,EAAE;AACtB,YAAA,CAAC;YACD,MAAM,UAAU,GAAG,MAAW;AAC5B,gBAAA,KAAK,IAAI,CAAC,QAAQ,EAAE;AACtB,YAAA,CAAC;YAED,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AACtD,YAAA,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;AAC9B,YAAA,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;YAEpC,IAAI,CAAC,YAAY,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE;QAC7C;IACF;AAEA;;;;;;AAMG;AACH,IAAA,KAAK,CAAC,KAAiB,EAAA;;QACrB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,SAAS;AAAE,YAAA,OAAO;AAChD,QAAA,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO;AAAE,YAAA,OAAO;QACnC,IAAI,IAAI,CAAC,eAAe;YAAE;AAE1B,QAAA,MAAM,UAAU,GAAoB;AAClC,YAAA,GAAG,KAAK;YACR,QAAQ,EAAE,YAAY,EAAE;YACxB,SAAS,EAAE,CAAA,EAAA,GAAA,KAAK,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;AACtD,YAAA,WAAW,EAAE;gBACX,IAAI,MAAA,IAAI,CAAC,QAAQ,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE,CAAC;AACpC,gBAAA,IAAI,CAAA,EAAA,GAAA,KAAK,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE,CAAC;AAC7B,aAAA;AACD,YAAA,IAAI,EAAE,CAAA,EAAA,GAAA,KAAK,CAAC,IAAI,mCAAI,OAAO;SAC5B;;QAGD,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;IAC1C;AAEA;;;AAGG;AACH,IAAA,MAAM,KAAK,GAAA;QACT,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE;AACtB,QAAA,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;IAC/B;AAEA;;;;AAIG;IACH,MAAM,QAAQ,CAAC,OAAgB,EAAA;QAC7B,IAAI,IAAI,CAAC,eAAe;YAAE;AAC1B,QAAA,IAAI,CAAC,eAAe,GAAG,IAAI;;QAG3B,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE;YACvD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;YAC5D,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;AAClE,YAAA,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,YAAA,IAAI,CAAC,YAAY,GAAG,IAAI;QAC1B;QAEA,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE;AAEtB,QAAA,MAAM,SAAS,GAAG,OAAO,KAAA,IAAA,IAAP,OAAO,KAAA,MAAA,GAAP,OAAO,GAAI,IAAI,CAAC,QAAQ,CAAC,eAAe;QAE1D,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE;AAClD,QAAA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAErF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;IACvD;;AAGA,IAAA,IAAI,OAAO,GAAA;AACT,QAAA,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU;IAC1B;;AAGA,IAAA,IAAI,OAAO,GAAA;;QACT,OAAO,CAAA,EAAA,GAAA,MAAA,IAAI,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK;IACzC;;AAGA,IAAA,IAAI,WAAW,GAAA;;QACb,OAAO,CAAA,EAAA,GAAA,MAAA,IAAI,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK;IAC7C;;AAIA;;;;;;;;;AASG;AACH,IAAA,UAAU,CACR,OAA+D,EAAA;;AAG/D,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;AACnB,YAAA,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B;AACA,QAAA,OAAO,OAAO,KAAa,EAAE,OAAiB,KAAsB;AAClE,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;YACtC;oBAAU;AACR,gBAAA,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB;AACF,QAAA,CAAC;IACH;AAEA;;;AAGG;AACH,IAAA,UAAU,CACR,OAAyD,EAAA;AAEzD,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;AACnB,YAAA,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B;AACA,QAAA,OAAO,OAAO,GAAa,EAAE,GAAc,KAAmB;AAC5D,YAAA,IAAI;AACF,gBAAA,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;YACzB;oBAAU;AACR,gBAAA,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB;AACF,QAAA,CAAC;IACH;AAEA;;;AAGG;AACH,IAAA,iBAAiB,CACf,OAA+D,EAAA;AAE/D,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;AACnB,YAAA,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B;AACA,QAAA,OAAO,OAAO,OAAiB,EAAE,KAAa,KAAsB;AAClE,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;YACtC;oBAAU;AACR,gBAAA,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB;AACF,QAAA,CAAC;IACH;AACD;;;;"}

package/dist/esm/uuid.js

@@ -0,0 +1,11 @@
+import { randomUUID } from 'crypto';
+
+/**
+ * UUID v4 generation — stdlib only, no dependencies.
+ */
+function generateUUID() {
+    return randomUUID();
+}
+
+export { generateUUID };
+//# sourceMappingURL=uuid.js.map

package/dist/esm/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sources":["../../../src/uuid.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;AAEG;SAGa,YAAY,GAAA;IAC1B,OAAO,UAAU,EAAE;AACrB;;;;"}