@mushi-mushi/web 0.2.0 → 0.3.0

package/README.md

@@ -2,6 +2,10 @@
 
 Browser SDK for Mushi Mushi — embeddable bug reporting widget with Shadow DOM isolation.
 
+> **One-command setup:** `npx mushi-mushi` installs this package for vanilla-JS apps (or alongside the framework SDK for Vue, Svelte, Angular).
+>
+> **Framework SDKs:** [`@mushi-mushi/react`](https://npmjs.com/package/@mushi-mushi/react) (Next.js / React) · [`@mushi-mushi/vue`](https://npmjs.com/package/@mushi-mushi/vue) (Nuxt / Vue) · [`@mushi-mushi/svelte`](https://npmjs.com/package/@mushi-mushi/svelte) (SvelteKit / Svelte) · [`@mushi-mushi/angular`](https://npmjs.com/package/@mushi-mushi/angular) · [`@mushi-mushi/react-native`](https://npmjs.com/package/@mushi-mushi/react-native) · [`@mushi-mushi/capacitor`](https://npmjs.com/package/@mushi-mushi/capacitor)
+
 ## Features
 
 - Shadow DOM widget with full CSS isolation from host page

package/dist/index.cjs

@@ -1545,6 +1545,7 @@ function createInstance(config) {
     }
     const scrubbedDescription = piiScrubber.scrub(preFilter.truncate(description));
     const sentryCtx = config.sentry ? captureSentryContext(config.sentry) : void 0;
+    const fingerprintHash = await core.getDeviceFingerprintHash().catch(() => null);
     const report = {
       id: crypto.randomUUID?.() ?? `mushi_${Date.now()}_${Math.random().toString(36).slice(2)}`,
       projectId: config.projectId,
@@ -1564,6 +1565,7 @@ function createInstance(config) {
       },
       sessionId: core.getSessionId(),
       reporterToken: core.getReporterToken(),
+      ...fingerprintHash ? { fingerprintHash } : {},
       appVersion: config.integrations?.vercel?.analyticsId,
       proactiveTrigger: pendingProactiveTrigger ?? void 0,
       sentryEventId: sentryCtx?.eventId,
@@ -1640,6 +1642,58 @@ function createInstance(config) {
       listeners.clear();
       instance = null;
       log.debug("Destroyed");
+    },
+    // Wave G4 — unified `captureEvent` API for programmatic/adapter-driven
+    // reports. Skips the widget, runs the same PII scrub + rate limit +
+    // offline-queue path as `submit()`, and returns the server report id.
+    async captureEvent(input) {
+      if (!rateLimiter.tryConsume()) {
+        log.warn("captureEvent throttled \u2014 rate limit exceeded");
+        return null;
+      }
+      const description = piiScrubber.scrub(preFilter.truncate(input.description));
+      const category = input.category ?? "bug";
+      const report = {
+        id: crypto.randomUUID?.() ?? `mushi_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+        projectId: config.projectId,
+        category,
+        description,
+        environment: core.captureEnvironment(),
+        metadata: {
+          ...input.metadata ?? {},
+          ...userInfo ? { user: userInfo } : {},
+          ...input.tags ? { tags: input.tags } : {},
+          ...input.error ? { error: input.error } : {},
+          ...input.severity ? { severity: input.severity } : {},
+          ...input.component ? { component: input.component } : {},
+          ...input.source ? { source: input.source } : { source: "captureEvent" }
+        },
+        sessionId: core.getSessionId(),
+        reporterToken: core.getReporterToken(),
+        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      emit("report:submitted", { reportId: report.id });
+      if (typeof navigator !== "undefined" && !navigator.onLine) {
+        await offlineQueue.enqueue(report);
+        emit("report:queued", { reportId: report.id });
+        return null;
+      }
+      const res = await apiClient.submitReport(report);
+      if (res.ok) {
+        emit("report:sent", { reportId: res.data?.reportId });
+        return res.data?.reportId ?? null;
+      }
+      await offlineQueue.enqueue(report);
+      emit("report:failed", { reportId: report.id, error: res.error });
+      return null;
+    },
+    identify(userId, traits) {
+      userInfo = { id: userId, ...traits?.email ? { email: traits.email } : {}, ...traits?.name ? { name: traits.name } : {} };
+      if (traits) {
+        for (const [k, v] of Object.entries(traits)) {
+          if (k !== "email" && k !== "name") customMetadata[`user.${k}`] = v;
+        }
+      }
     }
   };
   return sdk;
@@ -1661,6 +1715,9 @@ function createNoopInstance() {
     },
     destroy: () => {
       instance = null;
+    },
+    captureEvent: async () => null,
+    identify: () => {
     }
   };
 }