@fogg/bug-reporter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bug-reporter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# bug-reporter
+
+`@fogg/bug-reporter` is a React 16.8+ SDK for collecting production bug reports with screenshot capture, short screen recording, diagnostics, and pluggable storage backends.
+
+## Install
+
+```bash
+npm install @fogg/bug-reporter
+```
+
+## Quickstart
+
+```tsx
+import { BugReporter } from "@fogg/bug-reporter";
+import "@fogg/bug-reporter/styles.css";
+
+export function App() {
+  return (
+    <BugReporter
+      config={{
+        apiEndpoint: "/api/bug-reports",
+        storage: {
+          mode: "local-public",
+          local: { uploadEndpoint: "/api/uploads" }
+        }
+      }}
+    />
+  );
+}
+```
+
+## Capture Console Errors and Requests
+
+Enable these flags in config to attach logs and request traces to each report:
+
+```tsx
+<BugReporter
+  config={{
+    apiEndpoint: "/api/bug-reports",
+    storage: { mode: "proxy", proxy: { uploadEndpoint: "/api/bug-assets" } },
+    features: {
+      consoleLogs: true,
+      networkInfo: true
+    },
+    diagnostics: {
+      consoleBufferSize: 200,
+      requestBufferSize: 300
+    }
+  }}
+/>
+```
+
+## Docs
+
+- `docs/quickstart.md`
+- `docs/framework-nextjs.md`
+- `docs/framework-vite.md`
+- `docs/framework-cra.md`
+- `docs/framework-remix.md`
+- `docs/backend-s3.md`
+- `docs/backend-local.md`
+- `docs/security.md`
+- `docs/browser-compatibility.md`
+- `docs/known-limitations.md`
+
+## Development
+
+```bash
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+## Local Sandbox (Vite)
+
+```bash
+npm run sandbox:vite
+```
+
+Sandbox app path: `examples/sandbox-vite`.
+
+## Publish To npm
+
+1. Login to npm:
+```bash
+npm login
+```
+2. Verify quality/build locally:
+```bash
+npm run release:verify
+```
+3. Verify package contents before publishing:
+```bash
+npm run publish:dry-run
+```
+4. Publish `@fogg/bug-reporter`:
+```bash
+npm run publish:npm
+```
+
+### Changesets workflow
+
+For versioned releases with Changesets:
+```bash
+npm run changeset
+npm run version:packages
+npm run release
+```
+
+## License
+
+MIT

package/dist/chunk-6TCI6T2U.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var react = require('react');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var react__namespace = /*#__PURE__*/_interopNamespace(react);
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/types/index.ts
+var BugReporterError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "cause");
+    this.name = "BugReporterError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+
+exports.React = react__namespace;
+exports.BugReporterError = BugReporterError;
+exports.__publicField = __publicField;
+//# sourceMappingURL=chunk-6TCI6T2U.cjs.map
+//# sourceMappingURL=chunk-6TCI6T2U.cjs.map

package/dist/chunk-6TCI6T2U.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+MO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,EAI1C,WAAA,CAAY,IAAA,EAA4B,OAAA,EAAiB,KAAA,EAAiB;AACxE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJf,IAAA,aAAA,CAAA,IAAA,EAAS,MAAA,CAAA;AACT,IAAA,aAAA,CAAA,IAAA,EAAS,OAAA,CAAA;AAIP,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF","file":"chunk-6TCI6T2U.cjs","sourcesContent":["import type { ComponentType } from \"react\";\n\nexport type StorageMode = \"s3-presigned\" | \"local-public\" | \"proxy\";\n\nexport type ReportEnvironment = \"development\" | \"staging\" | \"production\";\nexport type AssetType = \"screenshot\" | \"recording\" | \"attachment\";\nexport type FlowStep = \"describe\" | \"screenshot\" | \"recording\" | \"review\" | \"submitting\" | \"success\";\nexport type DockSide = \"left\" | \"right\" | \"top\" | \"bottom\";\nexport type LauncherPosition = \"bottom-right\" | \"bottom-left\" | \"top-right\" | \"top-left\";\nexport type ThemeMode = \"dark\" | \"light\";\n\nexport type FeatureFlags = {\n  screenshot?: boolean;\n  recording?: boolean;\n  annotations?: boolean;\n  consoleLogs?: boolean;\n  networkInfo?: boolean;\n};\n\nexport type ThemeConfig = {\n  primaryColor?: string;\n  position?: LauncherPosition;\n  zIndex?: number;\n  borderRadius?: string;\n};\n\nexport type StorageLimits = {\n  maxVideoSeconds?: number;\n  maxVideoBytes?: number;\n  maxScreenshotBytes?: number;\n};\n\nexport type UploadFile = {\n  id: string;\n  name: string;\n  type: AssetType;\n  mimeType: string;\n  size: number;\n};\n\nexport type UploadInstruction = {\n  id: string;\n  method: \"PUT\" | \"POST\";\n  uploadUrl: string;\n  headers?: Record<string, string>;\n  fields?: Record<string, string>;\n  key?: string;\n  publicUrl?: string;\n  type: AssetType;\n};\n\nexport type AssetReference = {\n  id: string;\n  type: AssetType;\n  url: string;\n  key?: string;\n  mimeType?: string;\n  size?: number;\n};\n\nexport interface StorageProvider {\n  prepareUploads(files: UploadFile[]): Promise<UploadInstruction[]>;\n  upload(instruction: UploadInstruction, blob: Blob, onProgress?: (progress: number) => void): Promise<AssetReference>;\n}\n\nexport type CapturedAsset = {\n  id: string;\n  type: AssetType;\n  blob: Blob;\n  previewUrl: string;\n  mimeType: string;\n  filename: string;\n  size: number;\n};\n\nexport type DiagnosticsSnapshot = {\n  url: string;\n  referrer: string;\n  timestamp: string;\n  timezone: string;\n  viewport: {\n    width: number;\n    height: number;\n    pixelRatio: number;\n  };\n  browser: string;\n  os: string;\n  language: string;\n  userAgent: string;\n  userAgentData?: {\n    brands?: Array<{\n      brand: string;\n      version: string;\n    }>;\n    mobile?: boolean;\n    platform?: string;\n  };\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  projectId?: string;\n  logs?: ConsoleLogEntry[];\n  requests?: NetworkRequestEntry[];\n  navigationTiming?: {\n    domComplete?: number;\n    loadEventEnd?: number;\n    responseEnd?: number;\n  };\n};\n\nexport type ConsoleLogEntry = {\n  level: \"log\" | \"info\" | \"warn\" | \"error\";\n  message: string;\n  timestamp: string;\n};\n\nexport type DiagnosticsPreview = {\n  errorLogs: ConsoleLogEntry[];\n  failedRequests: NetworkRequestEntry[];\n};\n\nexport type NetworkRequestEntry = {\n  transport: \"fetch\" | \"xhr\";\n  method: string;\n  url: string;\n  status?: number;\n  ok?: boolean;\n  durationMs: number;\n  timestamp: string;\n  error?: string;\n};\n\nexport type ReportDraft = {\n  title: string;\n  description: string;\n  stepsToReproduce: string;\n  expectedBehavior: string;\n  actualBehavior: string;\n};\n\nexport type Reporter = {\n  id?: string;\n  name?: string;\n  email?: string;\n  role?: string;\n  ip?: string;\n  anonymous: boolean;\n};\n\nexport type CustomFormProps = {\n  attributes: Record<string, unknown>;\n  setAttributes: (next: Record<string, unknown>) => void;\n  updateAttribute: (key: string, value: unknown) => void;\n};\n\nexport type CustomFormComponent = ComponentType<CustomFormProps>;\n\nexport type BugReportPayload = {\n  issue: {\n    title: string;\n    description: string;\n    projectId?: string;\n    environment?: ReportEnvironment;\n    appVersion?: string;\n    assets: AssetReference[];\n  };\n  context: {\n    url: string;\n    referrer: string;\n    timestamp: string;\n    timezone: string;\n    viewport: {\n      width: number;\n      height: number;\n      pixelRatio: number;\n    };\n    client: {\n      browser: string;\n      os: string;\n      language: string;\n      userAgent: string;\n    };\n    userAgentData?: DiagnosticsSnapshot[\"userAgentData\"];\n    performance: {\n      navigationTiming?: DiagnosticsSnapshot[\"navigationTiming\"];\n    };\n    logs?: ConsoleLogEntry[];\n    requests?: NetworkRequestEntry[];\n  };\n  reporter: Reporter;\n  attributes: Record<string, unknown>;\n};\n\nexport type BugReportResponse = {\n  id?: string;\n  message?: string;\n  [key: string]: unknown;\n};\n\nexport type BugReporterErrorCode =\n  | \"VALIDATION_ERROR\"\n  | \"CAPTURE_ERROR\"\n  | \"RECORDING_ERROR\"\n  | \"UPLOAD_ERROR\"\n  | \"SUBMIT_ERROR\"\n  | \"PERMISSION_DENIED\"\n  | \"ABORTED\";\n\nexport class BugReporterError extends Error {\n  readonly code: BugReporterErrorCode;\n  readonly cause?: unknown;\n\n  constructor(code: BugReporterErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = \"BugReporterError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\nexport type BugReporterConfig = {\n  apiEndpoint: string;\n  projectId?: string;\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  storage?: {\n    mode: StorageMode;\n    s3?: {\n      presignEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    local?: {\n      uploadEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    proxy?: {\n      uploadEndpoint: string;\n    };\n    limits?: StorageLimits;\n  };\n  auth?: {\n    headers?: Record<string, string>;\n    withCredentials?: boolean;\n  };\n  theme?: ThemeConfig;\n  features?: FeatureFlags;\n  user?: {\n    id?: string;\n    email?: string;\n    name?: string;\n    role?: string;\n    ip?: string;\n    anonymous?: boolean;\n  };\n  attributes?: Record<string, unknown>;\n  privacy?: {\n    maskSelectors?: string[];\n    redactTextPatterns?: Array<string | RegExp>;\n  };\n  diagnostics?: {\n    consoleBufferSize?: number;\n    requestBufferSize?: number;\n  };\n  hooks?: {\n    beforeSubmit?: (payload: BugReportPayload) => Promise<BugReportPayload | null> | BugReportPayload | null;\n    onSuccess?: (response: BugReportResponse) => void;\n    onError?: (error: BugReporterError) => void;\n  };\n};\n\nexport type BugReporterState = {\n  isOpen: boolean;\n  dockSide: DockSide;\n  step: FlowStep;\n  draft: ReportDraft;\n  attributes: Record<string, unknown>;\n  assets: CapturedAsset[];\n  diagnostics?: DiagnosticsSnapshot;\n  uploadProgress: number;\n  isSubmitting: boolean;\n  error?: string;\n};\n\nexport type BugReporterContextValue = {\n  config: RequiredBugReporterConfig;\n  state: BugReporterState;\n  open: () => void;\n  close: () => void;\n  reset: () => void;\n  setDockSide: (dockSide: DockSide) => void;\n  setStep: (step: FlowStep) => void;\n  updateDraft: (next: Partial<ReportDraft>) => void;\n  setAttributes: (next: Record<string, unknown>) => void;\n  updateAttribute: (key: string, value: unknown) => void;\n  setScreenshot: (asset?: CapturedAsset) => void;\n  setRecording: (asset?: CapturedAsset) => void;\n  submit: () => Promise<void>;\n  retrySubmit: () => Promise<void>;\n  getDiagnosticsPreview: () => DiagnosticsPreview;\n};\n\nexport type RequiredBugReporterConfig = {\n  apiEndpoint: string;\n  projectId?: string;\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  storage: {\n    mode: StorageMode;\n    s3?: {\n      presignEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    local?: {\n      uploadEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    proxy?: {\n      uploadEndpoint: string;\n    };\n    limits: Required<StorageLimits>;\n  };\n  auth: {\n    headers: Record<string, string>;\n    withCredentials: boolean;\n  };\n  theme: Required<ThemeConfig>;\n  features: Required<FeatureFlags>;\n  user?: {\n    id?: string;\n    email?: string;\n    name?: string;\n    role?: string;\n    ip?: string;\n    anonymous?: boolean;\n  };\n  attributes: Record<string, unknown>;\n  privacy: {\n    maskSelectors: string[];\n    redactTextPatterns: Array<string | RegExp>;\n  };\n  diagnostics: {\n    consoleBufferSize: number;\n    requestBufferSize: number;\n  };\n  hooks: {\n    beforeSubmit?: (payload: BugReportPayload) => Promise<BugReportPayload | null> | BugReportPayload | null;\n    onSuccess?: (response: BugReportResponse) => void;\n    onError?: (error: BugReporterError) => void;\n  };\n};\n"]}

package/dist/chunk-S2YRP4GT.js

@@ -0,0 +1,22 @@
+import * as react from 'react';
+export { react as React };
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/types/index.ts
+var BugReporterError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "cause");
+    this.name = "BugReporterError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+
+export { BugReporterError, __publicField };
+//# sourceMappingURL=chunk-S2YRP4GT.js.map
+//# sourceMappingURL=chunk-S2YRP4GT.js.map

package/dist/chunk-S2YRP4GT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/index.ts"],"names":[],"mappings":";;;;;;;;AA+MO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,EAI1C,WAAA,CAAY,IAAA,EAA4B,OAAA,EAAiB,KAAA,EAAiB;AACxE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJf,IAAA,aAAA,CAAA,IAAA,EAAS,MAAA,CAAA;AACT,IAAA,aAAA,CAAA,IAAA,EAAS,OAAA,CAAA;AAIP,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF","file":"chunk-S2YRP4GT.js","sourcesContent":["import type { ComponentType } from \"react\";\n\nexport type StorageMode = \"s3-presigned\" | \"local-public\" | \"proxy\";\n\nexport type ReportEnvironment = \"development\" | \"staging\" | \"production\";\nexport type AssetType = \"screenshot\" | \"recording\" | \"attachment\";\nexport type FlowStep = \"describe\" | \"screenshot\" | \"recording\" | \"review\" | \"submitting\" | \"success\";\nexport type DockSide = \"left\" | \"right\" | \"top\" | \"bottom\";\nexport type LauncherPosition = \"bottom-right\" | \"bottom-left\" | \"top-right\" | \"top-left\";\nexport type ThemeMode = \"dark\" | \"light\";\n\nexport type FeatureFlags = {\n  screenshot?: boolean;\n  recording?: boolean;\n  annotations?: boolean;\n  consoleLogs?: boolean;\n  networkInfo?: boolean;\n};\n\nexport type ThemeConfig = {\n  primaryColor?: string;\n  position?: LauncherPosition;\n  zIndex?: number;\n  borderRadius?: string;\n};\n\nexport type StorageLimits = {\n  maxVideoSeconds?: number;\n  maxVideoBytes?: number;\n  maxScreenshotBytes?: number;\n};\n\nexport type UploadFile = {\n  id: string;\n  name: string;\n  type: AssetType;\n  mimeType: string;\n  size: number;\n};\n\nexport type UploadInstruction = {\n  id: string;\n  method: \"PUT\" | \"POST\";\n  uploadUrl: string;\n  headers?: Record<string, string>;\n  fields?: Record<string, string>;\n  key?: string;\n  publicUrl?: string;\n  type: AssetType;\n};\n\nexport type AssetReference = {\n  id: string;\n  type: AssetType;\n  url: string;\n  key?: string;\n  mimeType?: string;\n  size?: number;\n};\n\nexport interface StorageProvider {\n  prepareUploads(files: UploadFile[]): Promise<UploadInstruction[]>;\n  upload(instruction: UploadInstruction, blob: Blob, onProgress?: (progress: number) => void): Promise<AssetReference>;\n}\n\nexport type CapturedAsset = {\n  id: string;\n  type: AssetType;\n  blob: Blob;\n  previewUrl: string;\n  mimeType: string;\n  filename: string;\n  size: number;\n};\n\nexport type DiagnosticsSnapshot = {\n  url: string;\n  referrer: string;\n  timestamp: string;\n  timezone: string;\n  viewport: {\n    width: number;\n    height: number;\n    pixelRatio: number;\n  };\n  browser: string;\n  os: string;\n  language: string;\n  userAgent: string;\n  userAgentData?: {\n    brands?: Array<{\n      brand: string;\n      version: string;\n    }>;\n    mobile?: boolean;\n    platform?: string;\n  };\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  projectId?: string;\n  logs?: ConsoleLogEntry[];\n  requests?: NetworkRequestEntry[];\n  navigationTiming?: {\n    domComplete?: number;\n    loadEventEnd?: number;\n    responseEnd?: number;\n  };\n};\n\nexport type ConsoleLogEntry = {\n  level: \"log\" | \"info\" | \"warn\" | \"error\";\n  message: string;\n  timestamp: string;\n};\n\nexport type DiagnosticsPreview = {\n  errorLogs: ConsoleLogEntry[];\n  failedRequests: NetworkRequestEntry[];\n};\n\nexport type NetworkRequestEntry = {\n  transport: \"fetch\" | \"xhr\";\n  method: string;\n  url: string;\n  status?: number;\n  ok?: boolean;\n  durationMs: number;\n  timestamp: string;\n  error?: string;\n};\n\nexport type ReportDraft = {\n  title: string;\n  description: string;\n  stepsToReproduce: string;\n  expectedBehavior: string;\n  actualBehavior: string;\n};\n\nexport type Reporter = {\n  id?: string;\n  name?: string;\n  email?: string;\n  role?: string;\n  ip?: string;\n  anonymous: boolean;\n};\n\nexport type CustomFormProps = {\n  attributes: Record<string, unknown>;\n  setAttributes: (next: Record<string, unknown>) => void;\n  updateAttribute: (key: string, value: unknown) => void;\n};\n\nexport type CustomFormComponent = ComponentType<CustomFormProps>;\n\nexport type BugReportPayload = {\n  issue: {\n    title: string;\n    description: string;\n    projectId?: string;\n    environment?: ReportEnvironment;\n    appVersion?: string;\n    assets: AssetReference[];\n  };\n  context: {\n    url: string;\n    referrer: string;\n    timestamp: string;\n    timezone: string;\n    viewport: {\n      width: number;\n      height: number;\n      pixelRatio: number;\n    };\n    client: {\n      browser: string;\n      os: string;\n      language: string;\n      userAgent: string;\n    };\n    userAgentData?: DiagnosticsSnapshot[\"userAgentData\"];\n    performance: {\n      navigationTiming?: DiagnosticsSnapshot[\"navigationTiming\"];\n    };\n    logs?: ConsoleLogEntry[];\n    requests?: NetworkRequestEntry[];\n  };\n  reporter: Reporter;\n  attributes: Record<string, unknown>;\n};\n\nexport type BugReportResponse = {\n  id?: string;\n  message?: string;\n  [key: string]: unknown;\n};\n\nexport type BugReporterErrorCode =\n  | \"VALIDATION_ERROR\"\n  | \"CAPTURE_ERROR\"\n  | \"RECORDING_ERROR\"\n  | \"UPLOAD_ERROR\"\n  | \"SUBMIT_ERROR\"\n  | \"PERMISSION_DENIED\"\n  | \"ABORTED\";\n\nexport class BugReporterError extends Error {\n  readonly code: BugReporterErrorCode;\n  readonly cause?: unknown;\n\n  constructor(code: BugReporterErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = \"BugReporterError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\nexport type BugReporterConfig = {\n  apiEndpoint: string;\n  projectId?: string;\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  storage?: {\n    mode: StorageMode;\n    s3?: {\n      presignEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    local?: {\n      uploadEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    proxy?: {\n      uploadEndpoint: string;\n    };\n    limits?: StorageLimits;\n  };\n  auth?: {\n    headers?: Record<string, string>;\n    withCredentials?: boolean;\n  };\n  theme?: ThemeConfig;\n  features?: FeatureFlags;\n  user?: {\n    id?: string;\n    email?: string;\n    name?: string;\n    role?: string;\n    ip?: string;\n    anonymous?: boolean;\n  };\n  attributes?: Record<string, unknown>;\n  privacy?: {\n    maskSelectors?: string[];\n    redactTextPatterns?: Array<string | RegExp>;\n  };\n  diagnostics?: {\n    consoleBufferSize?: number;\n    requestBufferSize?: number;\n  };\n  hooks?: {\n    beforeSubmit?: (payload: BugReportPayload) => Promise<BugReportPayload | null> | BugReportPayload | null;\n    onSuccess?: (response: BugReportResponse) => void;\n    onError?: (error: BugReporterError) => void;\n  };\n};\n\nexport type BugReporterState = {\n  isOpen: boolean;\n  dockSide: DockSide;\n  step: FlowStep;\n  draft: ReportDraft;\n  attributes: Record<string, unknown>;\n  assets: CapturedAsset[];\n  diagnostics?: DiagnosticsSnapshot;\n  uploadProgress: number;\n  isSubmitting: boolean;\n  error?: string;\n};\n\nexport type BugReporterContextValue = {\n  config: RequiredBugReporterConfig;\n  state: BugReporterState;\n  open: () => void;\n  close: () => void;\n  reset: () => void;\n  setDockSide: (dockSide: DockSide) => void;\n  setStep: (step: FlowStep) => void;\n  updateDraft: (next: Partial<ReportDraft>) => void;\n  setAttributes: (next: Record<string, unknown>) => void;\n  updateAttribute: (key: string, value: unknown) => void;\n  setScreenshot: (asset?: CapturedAsset) => void;\n  setRecording: (asset?: CapturedAsset) => void;\n  submit: () => Promise<void>;\n  retrySubmit: () => Promise<void>;\n  getDiagnosticsPreview: () => DiagnosticsPreview;\n};\n\nexport type RequiredBugReporterConfig = {\n  apiEndpoint: string;\n  projectId?: string;\n  appVersion?: string;\n  environment?: ReportEnvironment;\n  storage: {\n    mode: StorageMode;\n    s3?: {\n      presignEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    local?: {\n      uploadEndpoint: string;\n      publicBaseUrl?: string;\n    };\n    proxy?: {\n      uploadEndpoint: string;\n    };\n    limits: Required<StorageLimits>;\n  };\n  auth: {\n    headers: Record<string, string>;\n    withCredentials: boolean;\n  };\n  theme: Required<ThemeConfig>;\n  features: Required<FeatureFlags>;\n  user?: {\n    id?: string;\n    email?: string;\n    name?: string;\n    role?: string;\n    ip?: string;\n    anonymous?: boolean;\n  };\n  attributes: Record<string, unknown>;\n  privacy: {\n    maskSelectors: string[];\n    redactTextPatterns: Array<string | RegExp>;\n  };\n  diagnostics: {\n    consoleBufferSize: number;\n    requestBufferSize: number;\n  };\n  hooks: {\n    beforeSubmit?: (payload: BugReportPayload) => Promise<BugReportPayload | null> | BugReportPayload | null;\n    onSuccess?: (response: BugReportResponse) => void;\n    onError?: (error: BugReporterError) => void;\n  };\n};\n"]}