@shakenbake/core 0.0.1

package/dist/mock-adapter.js

@@ -0,0 +1,95 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/core — MockAdapter (testing/development DestinationAdapter)
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockAdapter = void 0;
+/**
+ * A no-op DestinationAdapter that stores submitted reports in memory.
+ *
+ * Useful for:
+ * - Unit and integration tests (assert on submitted reports)
+ * - Local development without a real Linear API key
+ * - Demo / example apps
+ */
+class MockAdapter {
+    name = 'mock';
+    config;
+    submittedReports = [];
+    constructor(config) {
+        this.config = config ?? {};
+    }
+    /**
+     * Simulates uploading an image. Logs the filename and size, then returns
+     * a fake URL on mock.shakenbake.dev.
+     */
+    async uploadImage(imageData, filename) {
+        const size = imageData instanceof Blob ? imageData.size : imageData.byteLength;
+        console.log(`[MockAdapter] uploadImage: ${filename} (${size} bytes)`);
+        await this.simulateDelay();
+        const id = generateUUID();
+        return `https://mock.shakenbake.dev/images/${id}.png`;
+    }
+    /**
+     * Simulates creating an issue. Stores the report in memory and logs a
+     * summary to the console.
+     */
+    async createIssue(report) {
+        this.submittedReports.push(report);
+        console.log(`[MockAdapter] createIssue: "${report.title}" (${report.severity}/${report.category})`);
+        await this.simulateDelay();
+        const id = generateUUID();
+        return {
+            url: `https://mock.shakenbake.dev/issues/${id}`,
+            id,
+            success: true,
+        };
+    }
+    /**
+     * Always resolves to `true` -- the mock connection is always healthy.
+     */
+    async testConnection() {
+        await this.simulateDelay();
+        return true;
+    }
+    // ---------- Test helpers ----------
+    /**
+     * Returns a shallow copy of all reports submitted via `createIssue`.
+     */
+    getSubmittedReports() {
+        return [...this.submittedReports];
+    }
+    /**
+     * Clears the internal list of submitted reports.
+     */
+    clearReports() {
+        this.submittedReports = [];
+    }
+    // ---------- Internal ----------
+    async simulateDelay() {
+        const ms = this.config.delay;
+        if (ms !== undefined && ms > 0) {
+            await new Promise((resolve) => setTimeout(resolve, ms));
+        }
+    }
+}
+exports.MockAdapter = MockAdapter;
+// ---------------------------------------------------------------------------
+// Platform-agnostic UUID generator (works in Node.js AND browsers without
+// requiring a `node:crypto` import that breaks bundlers like webpack).
+// ---------------------------------------------------------------------------
+function generateUUID() {
+    // globalThis.crypto.randomUUID is available in Node 19+ and all modern browsers.
+    if (typeof globalThis !== 'undefined' &&
+        globalThis.crypto &&
+        typeof globalThis.crypto.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    // Fallback for older runtimes.
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=mock-adapter.js.map

package/dist/mock-adapter.js.map

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

package/dist/plugin-registry.d.ts

@@ -0,0 +1,36 @@
+import type { TriggerPlugin, CapturePlugin, ContextCollector, DeviceContext } from './types.js';
+/**
+ * Manages plugin lifecycle: registration, activation, and context collection.
+ *
+ * Internal storage uses Maps keyed by plugin name to prevent duplicates.
+ * Registering a plugin with the same name as an existing one overwrites it.
+ */
+export declare class PluginRegistry {
+    private readonly triggerMap;
+    private readonly captureMap;
+    private readonly collectorMap;
+    registerTrigger(plugin: TriggerPlugin): void;
+    unregisterTrigger(name: string): void;
+    getTriggers(): TriggerPlugin[];
+    activateTriggers(onTrigger: () => void): void;
+    deactivateTriggers(): void;
+    registerCapture(plugin: CapturePlugin): void;
+    unregisterCapture(name: string): void;
+    getCapture(): CapturePlugin | undefined;
+    registerCollector(collector: ContextCollector): void;
+    unregisterCollector(name: string): void;
+    getCollectors(): ContextCollector[];
+    /**
+     * Runs all registered collectors and deep-merges results into a
+     * single Partial<DeviceContext>.
+     *
+     * Each collector is wrapped in a try/catch so a single failing
+     * collector does not prevent the others from contributing.
+     */
+    collectContext(): Promise<Partial<DeviceContext>>;
+    /**
+     * Removes all registered plugins (triggers, capture, collectors).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../src/plugin-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IAIpE,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,WAAW,IAAI,aAAa,EAAE;IAI9B,gBAAgB,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI;IAM7C,kBAAkB,IAAI,IAAI;IAQ1B,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,UAAU,IAAI,aAAa,GAAG,SAAS;IAQvC,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAIpD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIvC,aAAa,IAAI,gBAAgB,EAAE;IAInC;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAmBvD;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/plugin-registry.js

@@ -0,0 +1,116 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/core — PluginRegistry
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+/**
+ * Manages plugin lifecycle: registration, activation, and context collection.
+ *
+ * Internal storage uses Maps keyed by plugin name to prevent duplicates.
+ * Registering a plugin with the same name as an existing one overwrites it.
+ */
+class PluginRegistry {
+    triggerMap = new Map();
+    captureMap = new Map();
+    collectorMap = new Map();
+    // ---- Triggers ----
+    registerTrigger(plugin) {
+        this.triggerMap.set(plugin.name, plugin);
+    }
+    unregisterTrigger(name) {
+        this.triggerMap.delete(name);
+    }
+    getTriggers() {
+        return Array.from(this.triggerMap.values());
+    }
+    activateTriggers(onTrigger) {
+        for (const trigger of this.triggerMap.values()) {
+            trigger.activate(onTrigger);
+        }
+    }
+    deactivateTriggers() {
+        for (const trigger of this.triggerMap.values()) {
+            trigger.deactivate();
+        }
+    }
+    // ---- Capture ----
+    registerCapture(plugin) {
+        this.captureMap.set(plugin.name, plugin);
+    }
+    unregisterCapture(name) {
+        this.captureMap.delete(name);
+    }
+    getCapture() {
+        // Return the first registered capture plugin (insertion order).
+        const first = this.captureMap.values().next();
+        return first.done ? undefined : first.value;
+    }
+    // ---- Context Collectors ----
+    registerCollector(collector) {
+        this.collectorMap.set(collector.name, collector);
+    }
+    unregisterCollector(name) {
+        this.collectorMap.delete(name);
+    }
+    getCollectors() {
+        return Array.from(this.collectorMap.values());
+    }
+    /**
+     * Runs all registered collectors and deep-merges results into a
+     * single Partial<DeviceContext>.
+     *
+     * Each collector is wrapped in a try/catch so a single failing
+     * collector does not prevent the others from contributing.
+     */
+    async collectContext() {
+        const results = [];
+        for (const collector of this.collectorMap.values()) {
+            try {
+                const partial = await collector.collect();
+                results.push(partial);
+            }
+            catch {
+                // Swallow error — a failing collector should not block the rest.
+            }
+        }
+        return results.reduce((acc, partial) => {
+            return deepMerge(acc, partial);
+        }, {});
+    }
+    // ---- Bulk ----
+    /**
+     * Removes all registered plugins (triggers, capture, collectors).
+     */
+    clear() {
+        this.triggerMap.clear();
+        this.captureMap.clear();
+        this.collectorMap.clear();
+    }
+}
+exports.PluginRegistry = PluginRegistry;
+// ---------------------------------------------------------------------------
+// Utility: deep-merge two plain objects (no array concat — last wins).
+// ---------------------------------------------------------------------------
+function deepMerge(target, source) {
+    const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+    const output = { ...target };
+    for (const key of Object.keys(source)) {
+        if (DANGEROUS_KEYS.has(key))
+            continue;
+        const srcVal = source[key];
+        const tgtVal = output[key];
+        if (isPlainObject(tgtVal) &&
+            isPlainObject(srcVal)) {
+            output[key] = deepMerge(tgtVal, srcVal);
+        }
+        else {
+            output[key] = srcVal;
+        }
+    }
+    return output;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugin-registry.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,13 @@
+import type { DeviceContext } from './types.js';
+/**
+ * Redact fields from a context object based on dot-path patterns.
+ *
+ * Supported patterns:
+ * - `"app.url"` — removes the `url` key from the `app` section
+ * - `"console"` — removes the entire `console` section
+ * - `"network.*"` — removes all keys in the `network` section
+ *
+ * Returns a new object; the original is not mutated.
+ */
+export declare function redactContext(context: Partial<DeviceContext>, fields: string[]): Partial<DeviceContext>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAC/B,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/dist/redact.js

@@ -0,0 +1,45 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/core — Context redaction utility
+// Removes fields from a DeviceContext partial based on dot-path patterns.
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redactContext = redactContext;
+/**
+ * Redact fields from a context object based on dot-path patterns.
+ *
+ * Supported patterns:
+ * - `"app.url"` — removes the `url` key from the `app` section
+ * - `"console"` — removes the entire `console` section
+ * - `"network.*"` — removes all keys in the `network` section
+ *
+ * Returns a new object; the original is not mutated.
+ */
+function redactContext(context, fields) {
+    if (!fields.length)
+        return context;
+    // Deep-clone to avoid mutating the original.
+    const result = JSON.parse(JSON.stringify(context));
+    for (const field of fields) {
+        const parts = field.split('.');
+        if (parts.length === 1) {
+            // Top-level key: e.g. "console" — delete entire section.
+            delete result[parts[0]];
+        }
+        else if (parts.length === 2 && parts[1] === '*') {
+            // Wildcard: e.g. "network.*" — replace section with empty object.
+            if (parts[0] in result) {
+                result[parts[0]] = {};
+            }
+        }
+        else if (parts.length === 2) {
+            // Nested key: e.g. "app.url" — delete specific field.
+            const section = result[parts[0]];
+            if (section && typeof section === 'object' && !Array.isArray(section)) {
+                delete section[parts[1]];
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,+CAA+C;AAC/C,0EAA0E;AAC1E,8EAA8E;;AAc9E,sCA8BC;AAxCD;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,OAA+B,EAC/B,MAAgB;IAEhB,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAEnC,6CAA6C;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAA4B,CAAC;IAE9E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,yDAAyD;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAClD,kEAAkE;YAClE,IAAI,KAAK,CAAC,CAAC,CAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,sDAAsD;YACtD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YAClC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtE,OAAQ,OAAmC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAgC,CAAC;AAC1C,CAAC"}

package/dist/report-builder.d.ts

@@ -0,0 +1,37 @@
+import type { BugReport, CaptureResult, DestinationAdapter, DeviceContext, ReportInput, SubmitResult } from './types.js';
+import type { PluginRegistry } from './plugin-registry.js';
+/**
+ * Orchestrates assembling a complete BugReport from user input,
+ * screenshots, optional audio, and automatically collected context.
+ */
+export declare class ReportBuilder {
+    private readonly registry;
+    private readonly adapter;
+    constructor(registry: PluginRegistry, adapter: DestinationAdapter);
+    /**
+     * Captures a screenshot using the first registered CapturePlugin.
+     * Throws ShakeNbakeError if no CapturePlugin is registered.
+     */
+    startCapture(): Promise<CaptureResult>;
+    /**
+     * Merges context from all registered ContextCollectors into a full
+     * DeviceContext (using empty defaults for missing sections).
+     *
+     * Each collector is wrapped in try/catch in the registry, so a single
+     * failing collector does not prevent the others from contributing.
+     */
+    collectContext(): Promise<DeviceContext>;
+    /**
+     * Builds a full BugReport from user-provided input and collected context.
+     * Generates a UUID via crypto.randomUUID (with Math.random fallback for
+     * older runtimes) and an ISO 8601 timestamp.
+     */
+    build(input: ReportInput, context: DeviceContext): BugReport;
+    /**
+     * Submits a BugReport via the configured DestinationAdapter.
+     * Uploads the screenshot first, then creates the issue.
+     * Wraps any adapter errors as ShakeNbakeError.
+     */
+    submit(report: BugReport): Promise<SubmitResult>;
+}
+//# sourceMappingURL=report-builder.d.ts.map

package/dist/report-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-builder.d.ts","sourceRoot":"","sources":["../src/report-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsB3D;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB;IAKjE;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAW5C;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAkB9C;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS;IAgD5D;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;CAkBvD"}

package/dist/report-builder.js

@@ -0,0 +1,147 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @shakenbake/core — ReportBuilder
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportBuilder = void 0;
+const errors_js_1 = require("./errors.js");
+/**
+ * Default (empty) DeviceContext used when no collectors are registered.
+ */
+function emptyDeviceContext() {
+    return {
+        platform: { os: 'unknown' },
+        device: {},
+        screen: { width: 0, height: 0 },
+        network: {},
+        battery: {},
+        locale: {},
+        app: {},
+        accessibility: {},
+        performance: {},
+        navigation: {},
+        console: {},
+    };
+}
+/**
+ * Orchestrates assembling a complete BugReport from user input,
+ * screenshots, optional audio, and automatically collected context.
+ */
+class ReportBuilder {
+    registry;
+    adapter;
+    constructor(registry, adapter) {
+        this.registry = registry;
+        this.adapter = adapter;
+    }
+    /**
+     * Captures a screenshot using the first registered CapturePlugin.
+     * Throws ShakeNbakeError if no CapturePlugin is registered.
+     */
+    async startCapture() {
+        const capturePlugin = this.registry.getCapture();
+        if (!capturePlugin) {
+            throw new errors_js_1.ShakeNbakeError('No CapturePlugin registered. Register a capture plugin before calling startCapture().', 'UNKNOWN');
+        }
+        return capturePlugin.capture();
+    }
+    /**
+     * Merges context from all registered ContextCollectors into a full
+     * DeviceContext (using empty defaults for missing sections).
+     *
+     * Each collector is wrapped in try/catch in the registry, so a single
+     * failing collector does not prevent the others from contributing.
+     */
+    async collectContext() {
+        const partial = await this.registry.collectContext();
+        const base = emptyDeviceContext();
+        return {
+            platform: { ...base.platform, ...partial.platform },
+            device: { ...base.device, ...partial.device },
+            screen: { ...base.screen, ...partial.screen },
+            network: { ...base.network, ...partial.network },
+            battery: { ...base.battery, ...partial.battery },
+            locale: { ...base.locale, ...partial.locale },
+            app: { ...base.app, ...partial.app },
+            accessibility: { ...base.accessibility, ...partial.accessibility },
+            performance: { ...base.performance, ...partial.performance },
+            navigation: { ...base.navigation, ...partial.navigation },
+            console: { ...base.console, ...partial.console },
+        };
+    }
+    /**
+     * Builds a full BugReport from user-provided input and collected context.
+     * Generates a UUID via crypto.randomUUID (with Math.random fallback for
+     * older runtimes) and an ISO 8601 timestamp.
+     */
+    build(input, context) {
+        if (!input.title.trim()) {
+            throw new errors_js_1.ShakeNbakeError('Report title is required.', 'UNKNOWN');
+        }
+        if (!input.annotatedScreenshot) {
+            throw new errors_js_1.ShakeNbakeError('An annotated screenshot is required.', 'UNKNOWN');
+        }
+        let id;
+        try {
+            id = globalThis.crypto.randomUUID();
+        }
+        catch {
+            // Fallback for runtimes without crypto.randomUUID
+            id = fallbackUUID();
+        }
+        const report = {
+            id,
+            timestamp: new Date().toISOString(),
+            title: input.title,
+            description: input.description,
+            severity: input.severity,
+            category: input.category,
+            screenshot: {
+                annotated: input.annotatedScreenshot,
+                original: input.originalScreenshot,
+                dimensions: { width: 0, height: 0 }, // Overwritten by caller if known
+            },
+            context,
+        };
+        if (input.audio) {
+            report.audio = {
+                data: input.audio,
+                durationMs: 0,
+                mimeType: 'audio/webm',
+            };
+        }
+        return report;
+    }
+    /**
+     * Submits a BugReport via the configured DestinationAdapter.
+     * Uploads the screenshot first, then creates the issue.
+     * Wraps any adapter errors as ShakeNbakeError.
+     */
+    async submit(report) {
+        try {
+            // Note: We do NOT call uploadImage here separately.
+            // The DestinationAdapter.createIssue() is responsible for handling
+            // screenshot uploads internally (e.g., LinearAdapter uploads then creates the issue).
+            // This avoids double-uploading when adapters handle uploads in createIssue.
+            return await this.adapter.createIssue(report);
+        }
+        catch (error) {
+            if (error instanceof errors_js_1.ShakeNbakeError) {
+                throw error;
+            }
+            throw new errors_js_1.ShakeNbakeError(error instanceof Error ? error.message : 'Failed to submit report', 'UPLOAD_FAILED', { originalError: error });
+        }
+    }
+}
+exports.ReportBuilder = ReportBuilder;
+// ---------------------------------------------------------------------------
+// Fallback UUID generator for runtimes without crypto.randomUUID
+// ---------------------------------------------------------------------------
+function fallbackUUID() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=report-builder.js.map

package/dist/report-builder.js.map

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