@bugspotter/sdk 0.1.0-alpha.2 → 0.1.2-alpha.5

package/dist/index.d.ts

@@ -3,6 +3,8 @@ import { type FloatingButtonOptions } from './widget/button';
 import type { eventWithTime } from '@rrweb/types';
 import { type AuthConfig, type RetryConfig } from './core/transport';
 import type { OfflineConfig } from './core/offline-queue';
+import { VERSION } from './version';
+export { VERSION };
 export declare class BugSpotter {
     private static instance;
     private config;
@@ -19,11 +21,16 @@ export declare class BugSpotter {
     /**
      * Capture bug report data
      * Note: Screenshot is captured for modal preview only (_screenshotPreview)
-     * Actual file uploads use presigned URLs (screenshotKey/replayKey set after upload)
+     * File uploads use presigned URLs returned from the backend
      */
     capture(): Promise<BugReport>;
     private handleBugReport;
-    private submitBugReport;
+    /**
+     * Submit a bug report with file uploads via presigned URLs
+     * @param payload - Bug report payload with title, description, and report data
+     * @public - Exposed for programmatic submission (bypassing modal)
+     */
+    submit(payload: BugReportPayload): Promise<void>;
     getConfig(): Readonly<BugSpotterConfig>;
     destroy(): void;
 }
@@ -31,8 +38,11 @@ export interface BugSpotterConfig {
     endpoint?: string;
     showWidget?: boolean;
     widgetOptions?: FloatingButtonOptions;
-    /** Authentication configuration */
-    auth?: AuthConfig;
+    /**
+     * Authentication configuration (required)
+     * API key authentication with project ID
+     */
+    auth: AuthConfig;
     /** Retry configuration for failed requests */
     retry?: RetryConfig;
     /** Offline queue configuration */
@@ -73,11 +83,10 @@ export interface BugSpotterConfig {
 }
 export interface BugReportPayload {
     title: string;
-    description: string;
+    description?: string;
     report: BugReport;
 }
 export interface BugReport {
-    screenshotKey?: string;
     console: Array<{
         level: string;
         message: string;
@@ -94,7 +103,6 @@ export interface BugReport {
     }>;
     metadata: BrowserMetadata;
     replay?: eventWithTime[];
-    replayKey?: string;
     _screenshotPreview?: string;
 }
 export type { BrowserMetadata } from './capture/metadata';
@@ -117,6 +125,9 @@ export type { UploadResult } from './core/uploader';
 export { compressReplayEvents, canvasToBlob, estimateCompressedReplaySize, isWithinSizeLimit, } from './core/upload-helpers';
 export { createSanitizer, Sanitizer } from './utils/sanitize';
 export type { PIIPattern, CustomPattern, SanitizeConfig } from './utils/sanitize';
+export { getApiBaseUrl, stripEndpointSuffix, InvalidEndpointError } from './utils/url-helpers';
+export { validateAuthConfig } from './utils/config-validator';
+export type { ValidationContext } from './utils/config-validator';
 export { DEFAULT_PATTERNS, PATTERN_PRESETS, PATTERN_CATEGORIES, PatternBuilder, createPatternConfig, getPattern, getPatternsByCategory, validatePattern, } from './utils/sanitize';
 export type { PIIPatternName, PatternDefinition } from './utils/sanitize';
 export { FloatingButton } from './widget/button';
@@ -124,6 +135,7 @@ export type { FloatingButtonOptions } from './widget/button';
 export { BugReportModal } from './widget/modal';
 export type { BugReportData, BugReportModalOptions, PIIDetection } from './widget/modal';
 export type { eventWithTime } from '@rrweb/types';
+export { DEFAULT_REPLAY_DURATION_SECONDS, MAX_RECOMMENDED_REPLAY_DURATION_SECONDS, } from './constants';
 /**
  * Convenience function to sanitize text with default PII patterns
  * Useful for quick sanitization without creating a Sanitizer instance

package/dist/index.esm.js

@@ -1,15 +1,32 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { ScreenshotCapture } from './capture/screenshot';
 import { ConsoleCapture } from './capture/console';
 import { NetworkCapture } from './capture/network';
 import { MetadataCapture } from './capture/metadata';
-import { compressData, estimateSize, getCompressionRatio } from './core/compress';
 import { FloatingButton } from './widget/button';
 import { BugReportModal } from './widget/modal';
 import { DOMCollector } from './collectors';
 import { createSanitizer } from './utils/sanitize';
 import { getLogger } from './utils/logger';
 import { submitWithAuth } from './core/transport';
+import { FileUploadHandler } from './core/file-upload-handler';
+import { DEFAULT_REPLAY_DURATION_SECONDS } from './constants';
+import { getApiBaseUrl } from './utils/url-helpers';
+import { validateAuthConfig } from './utils/config-validator';
+import { VERSION } from './version';
 const logger = getLogger();
+// Re-export VERSION for public API
+export { VERSION };
 export class BugSpotter {
     constructor(config) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
@@ -27,12 +44,12 @@ export class BugSpotter {
         this.console = new ConsoleCapture({ sanitizer: this.sanitizer });
         this.network = new NetworkCapture({ sanitizer: this.sanitizer });
         this.metadata = new MetadataCapture({ sanitizer: this.sanitizer });
-        // Note: DirectUploader is created per-report since it needs bugId
-        // See submitBugReport() for initialization
+        // Note: FileUploadHandler is created per-report since it needs bugId
+        // See submit() method for initialization
         // Initialize DOM collector if replay is enabled
         if (((_g = config.replay) === null || _g === void 0 ? void 0 : _g.enabled) !== false) {
             this.domCollector = new DOMCollector({
-                duration: (_j = (_h = config.replay) === null || _h === void 0 ? void 0 : _h.duration) !== null && _j !== void 0 ? _j : 15,
+                duration: (_j = (_h = config.replay) === null || _h === void 0 ? void 0 : _h.duration) !== null && _j !== void 0 ? _j : DEFAULT_REPLAY_DURATION_SECONDS,
                 sampling: (_k = config.replay) === null || _k === void 0 ? void 0 : _k.sampling,
                 sanitizer: this.sanitizer,
             });
@@ -58,7 +75,7 @@ export class BugSpotter {
     /**
      * Capture bug report data
      * Note: Screenshot is captured for modal preview only (_screenshotPreview)
-     * Actual file uploads use presigned URLs (screenshotKey/replayKey set after upload)
+     * File uploads use presigned URLs returned from the backend
      */
     async capture() {
         var _a, _b;
@@ -81,7 +98,7 @@ export class BugSpotter {
                 // Send to endpoint if configured
                 if (this.config.endpoint) {
                     try {
-                        await this.submitBugReport(Object.assign(Object.assign({}, data), { report }));
+                        await this.submit(Object.assign(Object.assign({}, data), { report }));
                         logger.log('Bug report submitted successfully');
                     }
                     catch (error) {
@@ -94,57 +111,90 @@ export class BugSpotter {
         });
         modal.show(report._screenshotPreview || '');
     }
-    async submitBugReport(payload) {
-        if (!this.config.endpoint) {
-            throw new Error('No endpoint configured for bug report submission');
-        }
+    /**
+     * Submit a bug report with file uploads via presigned URLs
+     * @param payload - Bug report payload with title, description, and report data
+     * @public - Exposed for programmatic submission (bypassing modal)
+     */
+    async submit(payload) {
+        var _a, _b, _c, _d, _e, _f;
+        validateAuthConfig({
+            endpoint: this.config.endpoint,
+            auth: this.config.auth,
+        });
+        logger.debug(`Submitting bug report to ${this.config.endpoint}`);
+        // Step 1: Create bug report and request presigned URLs
+        const { report } = payload, metadata = __rest(payload, ["report"]);
+        // Check what files we need to upload
+        const hasScreenshot = !!(report._screenshotPreview && report._screenshotPreview.startsWith('data:image/'));
+        const hasReplay = !!(report.replay && report.replay.length > 0);
+        logger.debug('File upload detection', {
+            hasScreenshot,
+            screenshotSize: ((_a = report._screenshotPreview) === null || _a === void 0 ? void 0 : _a.length) || 0,
+            hasReplay,
+            replayEventCount: ((_b = report.replay) === null || _b === void 0 ? void 0 : _b.length) || 0,
+        });
+        const createPayload = Object.assign(Object.assign({}, metadata), { report: {
+                console: report.console,
+                network: report.network,
+                metadata: report.metadata,
+                // Don't send replay events or screenshot in initial request
+            }, 
+            // Tell backend we have files so it can generate presigned URLs
+            hasScreenshot,
+            hasReplay });
         const contentHeaders = {
             'Content-Type': 'application/json',
         };
-        logger.warn(`Submitting bug report to ${this.config.endpoint}`);
-        let body;
-        try {
-            // Try to compress the payload
-            const originalSize = estimateSize(payload);
-            const compressed = await compressData(payload);
-            const compressedSize = compressed.byteLength;
-            const ratio = getCompressionRatio(originalSize, compressedSize);
-            logger.log(`Payload compression: ${(originalSize / 1024).toFixed(1)}KB → ${(compressedSize / 1024).toFixed(1)}KB (${ratio}% reduction)`);
-            // Use compression if it actually reduces size
-            if (compressedSize < originalSize) {
-                // Create a Blob from the compressed Uint8Array for proper binary upload
-                // Use Uint8Array constructor to ensure clean ArrayBuffer (no extra padding bytes)
-                body = new Blob([new Uint8Array(compressed)], { type: 'application/gzip' });
-                contentHeaders['Content-Encoding'] = 'gzip';
-                contentHeaders['Content-Type'] = 'application/gzip';
-            }
-            else {
-                body = JSON.stringify(payload);
-            }
-        }
-        catch (error) {
-            // Fallback to uncompressed if compression fails
-            logger.warn('Compression failed, sending uncompressed payload:', error);
-            body = JSON.stringify(payload);
-        }
-        // Determine auth configuration
-        const auth = this.config.auth;
-        // Submit with authentication, retry logic, and offline queue
-        const response = await submitWithAuth(this.config.endpoint, body, contentHeaders, {
-            auth,
+        const response = await submitWithAuth(this.config.endpoint, // Validated in validateAuthConfig
+        JSON.stringify(createPayload), contentHeaders, {
+            auth: this.config.auth,
             retry: this.config.retry,
             offline: this.config.offline,
         });
-        logger.warn(`${JSON.stringify(response)}`);
         if (!response.ok) {
-            const errorText = await response.text().catch(() => {
-                return 'Unknown error';
-            });
+            const errorText = await response.text().catch(() => 'Unknown error');
             throw new Error(`Failed to submit bug report: ${response.status} ${response.statusText}. ${errorText}`);
         }
-        return response.json().catch(() => {
-            return undefined;
+        const result = await response.json().catch(() => ({ success: false }));
+        logger.debug('Bug report creation response', {
+            success: result.success,
+            bugId: (_c = result.data) === null || _c === void 0 ? void 0 : _c.id,
+            hasPresignedUrls: !!((_d = result.data) === null || _d === void 0 ? void 0 : _d.presignedUrls),
+            presignedUrlKeys: ((_e = result.data) === null || _e === void 0 ? void 0 : _e.presignedUrls) ? Object.keys(result.data.presignedUrls) : [],
         });
+        if (!result.success || !((_f = result.data) === null || _f === void 0 ? void 0 : _f.id)) {
+            throw new Error('Bug report ID not returned from server');
+        }
+        const bugId = result.data.id;
+        // Step 2: Upload screenshot and replay using presigned URLs from response
+        if (!hasScreenshot && !hasReplay) {
+            logger.debug('No files to upload, bug report created successfully', { bugId });
+            return; // No files to upload, nothing more to do
+        }
+        // Validate presigned URLs were returned
+        if (!result.data.presignedUrls) {
+            logger.error('Presigned URLs not returned despite requesting file uploads', {
+                bugId,
+                hasScreenshot,
+                hasReplay,
+            });
+            throw new Error('Server did not provide presigned URLs for file uploads. Check backend configuration.');
+        }
+        // Use FileUploadHandler to handle all file upload operations
+        const apiEndpoint = getApiBaseUrl(this.config.endpoint);
+        const uploadHandler = new FileUploadHandler(apiEndpoint, this.config.auth.apiKey);
+        try {
+            await uploadHandler.uploadFiles(bugId, report, result.data.presignedUrls);
+            logger.debug('File uploads completed successfully', { bugId });
+        }
+        catch (error) {
+            logger.error('File upload failed', {
+                bugId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new Error(`Bug report created (ID: ${bugId}) but file upload failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
     getConfig() {
         return Object.assign({}, this.config);
@@ -176,11 +226,17 @@ export { DirectUploader } from './core/uploader';
 export { compressReplayEvents, canvasToBlob, estimateCompressedReplaySize, isWithinSizeLimit, } from './core/upload-helpers';
 // Export sanitization utilities
 export { createSanitizer, Sanitizer } from './utils/sanitize';
+// Export URL helpers
+export { getApiBaseUrl, stripEndpointSuffix, InvalidEndpointError } from './utils/url-helpers';
+// Export config validation
+export { validateAuthConfig } from './utils/config-validator';
 // Export pattern configuration utilities
 export { DEFAULT_PATTERNS, PATTERN_PRESETS, PATTERN_CATEGORIES, PatternBuilder, createPatternConfig, getPattern, getPatternsByCategory, validatePattern, } from './utils/sanitize';
 // Export widget components
 export { FloatingButton } from './widget/button';
 export { BugReportModal } from './widget/modal';
+// Export constants
+export { DEFAULT_REPLAY_DURATION_SECONDS, MAX_RECOMMENDED_REPLAY_DURATION_SECONDS, } from './constants';
 /**
  * Convenience function to sanitize text with default PII patterns
  * Useful for quick sanitization without creating a Sanitizer instance

package/dist/index.js

@@ -1,18 +1,34 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BugReportModal = exports.FloatingButton = exports.validatePattern = exports.getPatternsByCategory = exports.getPattern = exports.createPatternConfig = exports.PatternBuilder = exports.PATTERN_CATEGORIES = exports.PATTERN_PRESETS = exports.DEFAULT_PATTERNS = exports.Sanitizer = exports.createSanitizer = exports.isWithinSizeLimit = exports.estimateCompressedReplaySize = exports.canvasToBlob = exports.compressReplayEvents = exports.DirectUploader = exports.createLogger = exports.configureLogger = exports.getLogger = exports.clearOfflineQueue = exports.getAuthHeaders = exports.submitWithAuth = exports.getCompressionRatio = exports.estimateSize = exports.compressImage = exports.decompressData = exports.compressData = exports.CircularBuffer = exports.DOMCollector = exports.MetadataCapture = exports.NetworkCapture = exports.ConsoleCapture = exports.ScreenshotCapture = exports.BugSpotter = void 0;
+exports.MAX_RECOMMENDED_REPLAY_DURATION_SECONDS = exports.DEFAULT_REPLAY_DURATION_SECONDS = exports.BugReportModal = exports.FloatingButton = exports.validatePattern = exports.getPatternsByCategory = exports.getPattern = exports.createPatternConfig = exports.PatternBuilder = exports.PATTERN_CATEGORIES = exports.PATTERN_PRESETS = exports.DEFAULT_PATTERNS = exports.validateAuthConfig = exports.InvalidEndpointError = exports.stripEndpointSuffix = exports.getApiBaseUrl = exports.Sanitizer = exports.createSanitizer = exports.isWithinSizeLimit = exports.estimateCompressedReplaySize = exports.canvasToBlob = exports.compressReplayEvents = exports.DirectUploader = exports.createLogger = exports.configureLogger = exports.getLogger = exports.clearOfflineQueue = exports.getAuthHeaders = exports.submitWithAuth = exports.getCompressionRatio = exports.estimateSize = exports.compressImage = exports.decompressData = exports.compressData = exports.CircularBuffer = exports.DOMCollector = exports.MetadataCapture = exports.NetworkCapture = exports.ConsoleCapture = exports.ScreenshotCapture = exports.BugSpotter = exports.VERSION = void 0;
 exports.sanitize = sanitize;
 const screenshot_1 = require("./capture/screenshot");
 const console_1 = require("./capture/console");
 const network_1 = require("./capture/network");
 const metadata_1 = require("./capture/metadata");
-const compress_1 = require("./core/compress");
 const button_1 = require("./widget/button");
 const modal_1 = require("./widget/modal");
 const collectors_1 = require("./collectors");
 const sanitize_1 = require("./utils/sanitize");
 const logger_1 = require("./utils/logger");
 const transport_1 = require("./core/transport");
+const file_upload_handler_1 = require("./core/file-upload-handler");
+const constants_1 = require("./constants");
+const url_helpers_1 = require("./utils/url-helpers");
+const config_validator_1 = require("./utils/config-validator");
+const version_1 = require("./version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
 const logger = (0, logger_1.getLogger)();
 class BugSpotter {
     constructor(config) {
@@ -31,12 +47,12 @@ class BugSpotter {
         this.console = new console_1.ConsoleCapture({ sanitizer: this.sanitizer });
         this.network = new network_1.NetworkCapture({ sanitizer: this.sanitizer });
         this.metadata = new metadata_1.MetadataCapture({ sanitizer: this.sanitizer });
-        // Note: DirectUploader is created per-report since it needs bugId
-        // See submitBugReport() for initialization
+        // Note: FileUploadHandler is created per-report since it needs bugId
+        // See submit() method for initialization
         // Initialize DOM collector if replay is enabled
         if (((_g = config.replay) === null || _g === void 0 ? void 0 : _g.enabled) !== false) {
             this.domCollector = new collectors_1.DOMCollector({
-                duration: (_j = (_h = config.replay) === null || _h === void 0 ? void 0 : _h.duration) !== null && _j !== void 0 ? _j : 15,
+                duration: (_j = (_h = config.replay) === null || _h === void 0 ? void 0 : _h.duration) !== null && _j !== void 0 ? _j : constants_1.DEFAULT_REPLAY_DURATION_SECONDS,
                 sampling: (_k = config.replay) === null || _k === void 0 ? void 0 : _k.sampling,
                 sanitizer: this.sanitizer,
             });
@@ -62,7 +78,7 @@ class BugSpotter {
     /**
      * Capture bug report data
      * Note: Screenshot is captured for modal preview only (_screenshotPreview)
-     * Actual file uploads use presigned URLs (screenshotKey/replayKey set after upload)
+     * File uploads use presigned URLs returned from the backend
      */
     async capture() {
         var _a, _b;
@@ -85,7 +101,7 @@ class BugSpotter {
                 // Send to endpoint if configured
                 if (this.config.endpoint) {
                     try {
-                        await this.submitBugReport(Object.assign(Object.assign({}, data), { report }));
+                        await this.submit(Object.assign(Object.assign({}, data), { report }));
                         logger.log('Bug report submitted successfully');
                     }
                     catch (error) {
@@ -98,57 +114,90 @@ class BugSpotter {
         });
         modal.show(report._screenshotPreview || '');
     }
-    async submitBugReport(payload) {
-        if (!this.config.endpoint) {
-            throw new Error('No endpoint configured for bug report submission');
-        }
+    /**
+     * Submit a bug report with file uploads via presigned URLs
+     * @param payload - Bug report payload with title, description, and report data
+     * @public - Exposed for programmatic submission (bypassing modal)
+     */
+    async submit(payload) {
+        var _a, _b, _c, _d, _e, _f;
+        (0, config_validator_1.validateAuthConfig)({
+            endpoint: this.config.endpoint,
+            auth: this.config.auth,
+        });
+        logger.debug(`Submitting bug report to ${this.config.endpoint}`);
+        // Step 1: Create bug report and request presigned URLs
+        const { report } = payload, metadata = __rest(payload, ["report"]);
+        // Check what files we need to upload
+        const hasScreenshot = !!(report._screenshotPreview && report._screenshotPreview.startsWith('data:image/'));
+        const hasReplay = !!(report.replay && report.replay.length > 0);
+        logger.debug('File upload detection', {
+            hasScreenshot,
+            screenshotSize: ((_a = report._screenshotPreview) === null || _a === void 0 ? void 0 : _a.length) || 0,
+            hasReplay,
+            replayEventCount: ((_b = report.replay) === null || _b === void 0 ? void 0 : _b.length) || 0,
+        });
+        const createPayload = Object.assign(Object.assign({}, metadata), { report: {
+                console: report.console,
+                network: report.network,
+                metadata: report.metadata,
+                // Don't send replay events or screenshot in initial request
+            }, 
+            // Tell backend we have files so it can generate presigned URLs
+            hasScreenshot,
+            hasReplay });
         const contentHeaders = {
             'Content-Type': 'application/json',
         };
-        logger.warn(`Submitting bug report to ${this.config.endpoint}`);
-        let body;
-        try {
-            // Try to compress the payload
-            const originalSize = (0, compress_1.estimateSize)(payload);
-            const compressed = await (0, compress_1.compressData)(payload);
-            const compressedSize = compressed.byteLength;
-            const ratio = (0, compress_1.getCompressionRatio)(originalSize, compressedSize);
-            logger.log(`Payload compression: ${(originalSize / 1024).toFixed(1)}KB → ${(compressedSize / 1024).toFixed(1)}KB (${ratio}% reduction)`);
-            // Use compression if it actually reduces size
-            if (compressedSize < originalSize) {
-                // Create a Blob from the compressed Uint8Array for proper binary upload
-                // Use Uint8Array constructor to ensure clean ArrayBuffer (no extra padding bytes)
-                body = new Blob([new Uint8Array(compressed)], { type: 'application/gzip' });
-                contentHeaders['Content-Encoding'] = 'gzip';
-                contentHeaders['Content-Type'] = 'application/gzip';
-            }
-            else {
-                body = JSON.stringify(payload);
-            }
-        }
-        catch (error) {
-            // Fallback to uncompressed if compression fails
-            logger.warn('Compression failed, sending uncompressed payload:', error);
-            body = JSON.stringify(payload);
-        }
-        // Determine auth configuration
-        const auth = this.config.auth;
-        // Submit with authentication, retry logic, and offline queue
-        const response = await (0, transport_1.submitWithAuth)(this.config.endpoint, body, contentHeaders, {
-            auth,
+        const response = await (0, transport_1.submitWithAuth)(this.config.endpoint, // Validated in validateAuthConfig
+        JSON.stringify(createPayload), contentHeaders, {
+            auth: this.config.auth,
             retry: this.config.retry,
             offline: this.config.offline,
         });
-        logger.warn(`${JSON.stringify(response)}`);
         if (!response.ok) {
-            const errorText = await response.text().catch(() => {
-                return 'Unknown error';
-            });
+            const errorText = await response.text().catch(() => 'Unknown error');
             throw new Error(`Failed to submit bug report: ${response.status} ${response.statusText}. ${errorText}`);
         }
-        return response.json().catch(() => {
-            return undefined;
+        const result = await response.json().catch(() => ({ success: false }));
+        logger.debug('Bug report creation response', {
+            success: result.success,
+            bugId: (_c = result.data) === null || _c === void 0 ? void 0 : _c.id,
+            hasPresignedUrls: !!((_d = result.data) === null || _d === void 0 ? void 0 : _d.presignedUrls),
+            presignedUrlKeys: ((_e = result.data) === null || _e === void 0 ? void 0 : _e.presignedUrls) ? Object.keys(result.data.presignedUrls) : [],
         });
+        if (!result.success || !((_f = result.data) === null || _f === void 0 ? void 0 : _f.id)) {
+            throw new Error('Bug report ID not returned from server');
+        }
+        const bugId = result.data.id;
+        // Step 2: Upload screenshot and replay using presigned URLs from response
+        if (!hasScreenshot && !hasReplay) {
+            logger.debug('No files to upload, bug report created successfully', { bugId });
+            return; // No files to upload, nothing more to do
+        }
+        // Validate presigned URLs were returned
+        if (!result.data.presignedUrls) {
+            logger.error('Presigned URLs not returned despite requesting file uploads', {
+                bugId,
+                hasScreenshot,
+                hasReplay,
+            });
+            throw new Error('Server did not provide presigned URLs for file uploads. Check backend configuration.');
+        }
+        // Use FileUploadHandler to handle all file upload operations
+        const apiEndpoint = (0, url_helpers_1.getApiBaseUrl)(this.config.endpoint);
+        const uploadHandler = new file_upload_handler_1.FileUploadHandler(apiEndpoint, this.config.auth.apiKey);
+        try {
+            await uploadHandler.uploadFiles(bugId, report, result.data.presignedUrls);
+            logger.debug('File uploads completed successfully', { bugId });
+        }
+        catch (error) {
+            logger.error('File upload failed', {
+                bugId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new Error(`Bug report created (ID: ${bugId}) but file upload failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
     getConfig() {
         return Object.assign({}, this.config);
@@ -178,12 +227,12 @@ Object.defineProperty(exports, "DOMCollector", { enumerable: true, get: function
 var buffer_1 = require("./core/buffer");
 Object.defineProperty(exports, "CircularBuffer", { enumerable: true, get: function () { return buffer_1.CircularBuffer; } });
 // Export compression utilities
-var compress_2 = require("./core/compress");
-Object.defineProperty(exports, "compressData", { enumerable: true, get: function () { return compress_2.compressData; } });
-Object.defineProperty(exports, "decompressData", { enumerable: true, get: function () { return compress_2.decompressData; } });
-Object.defineProperty(exports, "compressImage", { enumerable: true, get: function () { return compress_2.compressImage; } });
-Object.defineProperty(exports, "estimateSize", { enumerable: true, get: function () { return compress_2.estimateSize; } });
-Object.defineProperty(exports, "getCompressionRatio", { enumerable: true, get: function () { return compress_2.getCompressionRatio; } });
+var compress_1 = require("./core/compress");
+Object.defineProperty(exports, "compressData", { enumerable: true, get: function () { return compress_1.compressData; } });
+Object.defineProperty(exports, "decompressData", { enumerable: true, get: function () { return compress_1.decompressData; } });
+Object.defineProperty(exports, "compressImage", { enumerable: true, get: function () { return compress_1.compressImage; } });
+Object.defineProperty(exports, "estimateSize", { enumerable: true, get: function () { return compress_1.estimateSize; } });
+Object.defineProperty(exports, "getCompressionRatio", { enumerable: true, get: function () { return compress_1.getCompressionRatio; } });
 // Export transport and authentication
 var transport_2 = require("./core/transport");
 Object.defineProperty(exports, "submitWithAuth", { enumerable: true, get: function () { return transport_2.submitWithAuth; } });
@@ -205,6 +254,14 @@ Object.defineProperty(exports, "isWithinSizeLimit", { enumerable: true, get: fun
 var sanitize_2 = require("./utils/sanitize");
 Object.defineProperty(exports, "createSanitizer", { enumerable: true, get: function () { return sanitize_2.createSanitizer; } });
 Object.defineProperty(exports, "Sanitizer", { enumerable: true, get: function () { return sanitize_2.Sanitizer; } });
+// Export URL helpers
+var url_helpers_2 = require("./utils/url-helpers");
+Object.defineProperty(exports, "getApiBaseUrl", { enumerable: true, get: function () { return url_helpers_2.getApiBaseUrl; } });
+Object.defineProperty(exports, "stripEndpointSuffix", { enumerable: true, get: function () { return url_helpers_2.stripEndpointSuffix; } });
+Object.defineProperty(exports, "InvalidEndpointError", { enumerable: true, get: function () { return url_helpers_2.InvalidEndpointError; } });
+// Export config validation
+var config_validator_2 = require("./utils/config-validator");
+Object.defineProperty(exports, "validateAuthConfig", { enumerable: true, get: function () { return config_validator_2.validateAuthConfig; } });
 // Export pattern configuration utilities
 var sanitize_3 = require("./utils/sanitize");
 Object.defineProperty(exports, "DEFAULT_PATTERNS", { enumerable: true, get: function () { return sanitize_3.DEFAULT_PATTERNS; } });
@@ -220,6 +277,10 @@ var button_2 = require("./widget/button");
 Object.defineProperty(exports, "FloatingButton", { enumerable: true, get: function () { return button_2.FloatingButton; } });
 var modal_2 = require("./widget/modal");
 Object.defineProperty(exports, "BugReportModal", { enumerable: true, get: function () { return modal_2.BugReportModal; } });
+// Export constants
+var constants_2 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_REPLAY_DURATION_SECONDS", { enumerable: true, get: function () { return constants_2.DEFAULT_REPLAY_DURATION_SECONDS; } });
+Object.defineProperty(exports, "MAX_RECOMMENDED_REPLAY_DURATION_SECONDS", { enumerable: true, get: function () { return constants_2.MAX_RECOMMENDED_REPLAY_DURATION_SECONDS; } });
 /**
  * Convenience function to sanitize text with default PII patterns
  * Useful for quick sanitization without creating a Sanitizer instance

package/dist/utils/config-validator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration Validation Utilities
+ * Validates BugSpotter configuration before use
+ */
+import type { AuthConfig } from '../core/transport';
+export interface ValidationContext {
+    endpoint?: string;
+    auth?: AuthConfig;
+}
+/**
+ * Validate authentication configuration
+ * @throws Error if configuration is invalid
+ */
+export declare function validateAuthConfig(context: ValidationContext): void;

package/dist/utils/config-validator.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Configuration Validation Utilities
+ * Validates BugSpotter configuration before use
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAuthConfig = validateAuthConfig;
+/**
+ * Validate authentication configuration
+ * @throws Error if configuration is invalid
+ */
+function validateAuthConfig(context) {
+    if (!context.endpoint) {
+        throw new Error('No endpoint configured for bug report submission');
+    }
+    if (!context.auth) {
+        throw new Error('API key authentication is required');
+    }
+    if (context.auth.type !== 'api-key') {
+        throw new Error('API key authentication is required');
+    }
+    if (!context.auth.apiKey) {
+        throw new Error('API key is required in auth configuration');
+    }
+    if (!context.auth.projectId) {
+        throw new Error('Project ID is required in auth configuration');
+    }
+}

package/dist/utils/url-helpers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * URL Helper Utilities
+ * Extract base API URL from endpoint configuration
+ */
+/**
+ * Custom error for invalid endpoint URLs
+ */
+export declare class InvalidEndpointError extends Error {
+    readonly endpoint: string;
+    readonly reason: string;
+    constructor(endpoint: string, reason: string);
+}
+/**
+ * Strip known endpoint suffixes from path
+ * Removes /api/v1/reports path
+ */
+export declare function stripEndpointSuffix(path: string): string;
+/**
+ * Extract base API URL from endpoint
+ * Returns scheme + host + base path (without /api/v1/reports suffix)
+ *
+ * @example
+ * getApiBaseUrl('https://api.example.com/api/v1/reports')
+ * // Returns: 'https://api.example.com'
+ *
+ * @throws InvalidEndpointError if endpoint is not a valid absolute URL
+ */
+export declare function getApiBaseUrl(endpoint: string): string;