@insitue/sdk 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -1,49 +1,76 @@
 import { IssueDraft, CaptureBundle } from '@insitue/capture-core';
-export { InSitueOptions, mountInSitue } from './overlay.js';
+import { CaptureSink } from './capture-only.js';
 export { CaptureOnlyOptions, mountCaptureOnly } from './capture-only.js';
 
-interface InSitueProps {
-    /** Companion loopback port (default 5747). */
-    port?: number;
-}
-declare function InSitue({ port }: InSitueProps): null;
 interface InSitueCaptureProps {
     /**
      * Publishable project key (e.g. `pk_…`). When set, captures POST
      * to the InSitue cloud automatically. Origin-pinned + quota-gated
-     * server-side, so safe to ship in your production bundle.
+     * server-side, so safe to ship in your production bundle. Auto-
+     * selects `sink: { kind: "cloud" }` unless `sink` is set
+     * explicitly.
      */
     projectKey?: string;
-    /** Override the ingest endpoint (default = InSitue cloud). */
+    /** Override the ingest endpoint (cloud sink). */
     endpoint?: string;
     /**
-     * Take over delivery yourself. Wins over `projectKey`. Default
-     * (neither set): console + JSON download + `window.__insitu_capture__`.
+     * Take over delivery yourself. Wins over `projectKey` AND
+     * `sink`. Default (none set + no companion reachable): console +
+     * JSON download + `window.__insitu_capture__`.
      */
     onCapture?: (draft: IssueDraft, bundle: CaptureBundle) => void;
+    /**
+     * Explicit sink override. Most callers leave this undefined and
+     * rely on auto-detection (projectKey → cloud, otherwise →
+     * companion).
+     */
+    sink?: CaptureSink;
     /**
      * Default the user's "Always pixel-perfect screenshots" setting
-     * to `true` on mount — every capture uses the `getDisplayMedia`
-     * OS-compositor path, paying a one-time tab-share permission per
-     * session in exchange for screenshots that are pixel-accurate
-     * across any content (next/image, video, canvas, cross-origin).
+     * to `true` on mount — every capture uses `getDisplayMedia`,
+     * paying a one-time tab-share permission per session in exchange
+     * for screenshots that are pixel-accurate across any content
+     * (next/image, video, canvas, cross-origin).
      *
-     * Recommended for dev / dogfood, where capture quality matters
-     * more than the permission UX. Not the default — production
-     * end-users shouldn't see a permission dialog they didn't ask for.
+     * Recommended for dev / dogfood; not for production end-users.
      */
     defaultPixelPerfect?: boolean;
 }
 /**
- * `<InSitueCapture />` — the prod capture-only path. UNLIKE
- * `<InSitue />` it does NOT bail in a production build: capture-only
- * is exactly what prod runs (no companion to refuse). It never touches
- * fs/agent/WS; the same bundle just flows to the configured sink.
+ * The canonical InSitue widget. Use this for both prod (with
+ * `projectKey`) and dev (without). One mount, one component, the
+ * UI and theme adapt to the sink.
+ */
+declare function InSitueCapture({ projectKey, endpoint, onCapture, sink, defaultPixelPerfect, }: InSitueCaptureProps): null;
+interface InSitueProps {
+    /**
+     * Companion loopback port (default 5747). Only meaningful when
+     * not also passing `projectKey` — when `projectKey` is set, the
+     * widget ships to the cloud sink and this is ignored.
+     */
+    port?: number;
+}
+/**
+ * `<InSitue />` — backward-compat dev alias.
+ *
+ * Equivalent to `<InSitueCapture sink={{ kind: "companion", port }} />`.
+ * Kept so existing `<InSitue />` mounts (callers that imported the
+ * pre-0.3.0 chat overlay) keep compiling. The behaviour is the
+ * unified widget, NOT the removed chat overlay — the in-overlay
+ * thread, diff display, and SESSION history are gone in 0.3.0.
+ *
+ * For new code, prefer `<InSitueCapture />`.
+ */
+declare function InSitue({ port }: InSitueProps): null;
+
+/**
+ * `@insitue/sdk` — the InSitue capture widget for browser apps.
  *
- * The simplest path: set `projectKey` and the SDK POSTs captures to
- * the InSitue cloud automatically.
+ * One component, two sinks. `<InSitueCapture />` is the canonical
+ * mount; `<InSitue />` is a backward-compat dev alias (companion
+ * sink). The chat-style overlay that existed pre-0.3.0 has been
+ * removed in favour of the unified widget.
  */
-declare function InSitueCapture({ projectKey, endpoint, onCapture, defaultPixelPerfect, }: InSitueCaptureProps): null;
 
 /** Build-time-inlined version of `@insitue/sdk` (from package.json).
  *  Exposed so the host app can self-verify which SDK build is loaded
@@ -51,4 +78,4 @@ declare function InSitueCapture({ projectKey, endpoint, onCapture, defaultPixelP
  *  the capture widget footer so a screenshot proves the build. */
 declare const SDK_VERSION: string;
 
-export { InSitue, InSitueCapture, type InSitueCaptureProps, type InSitueProps, SDK_VERSION };
+export { CaptureSink, InSitue, InSitueCapture, type InSitueCaptureProps, type InSitueProps, SDK_VERSION };

package/dist/index.js

@@ -1,45 +1,47 @@
 import {
   mountCaptureOnly
-} from "./chunk-ZV3AVYBI.js";
-import {
-  mountInSitue
-} from "./chunk-VRINS2SK.js";
-import "./chunk-62N4L6RA.js";
+} from "./chunk-BCKDBCPG.js";
 
 // src/InSitue.tsx
 import { useEffect } from "react";
-function InSitue({ port }) {
+function InSitueCapture({
+  projectKey,
+  endpoint,
+  onCapture,
+  sink,
+  defaultPixelPerfect
+}) {
   useEffect(() => {
-    const nodeEnv = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
-    if (nodeEnv === "production") return;
     let active = true;
     let dispose;
-    void import("./overlay.js").then((m) => {
-      if (active) dispose = m.mountInSitue(port === void 0 ? {} : { port });
+    void import("./capture-only.js").then((m) => {
+      if (active) {
+        dispose = m.mountCaptureOnly({
+          ...projectKey ? { projectKey } : {},
+          ...endpoint ? { endpoint } : {},
+          ...onCapture ? { onCapture } : {},
+          ...sink ? { sink } : {},
+          ...defaultPixelPerfect === true ? { defaultPixelPerfect } : {}
+        });
+      }
     });
     return () => {
       active = false;
       dispose?.();
     };
-  }, [port]);
+  }, [projectKey, endpoint, onCapture, sink, defaultPixelPerfect]);
   return null;
 }
-function InSitueCapture({
-  projectKey,
-  endpoint,
-  onCapture,
-  defaultPixelPerfect
-}) {
+function InSitue({ port }) {
   useEffect(() => {
+    const nodeEnv = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
+    if (nodeEnv === "production") return;
     let active = true;
     let dispose;
     void import("./capture-only.js").then((m) => {
       if (active) {
         dispose = m.mountCaptureOnly({
-          projectKey,
-          endpoint,
-          onCapture,
-          defaultPixelPerfect
+          sink: port === void 0 ? { kind: "companion" } : { kind: "companion", port }
         });
       }
     });
@@ -47,16 +49,15 @@ function InSitueCapture({
       active = false;
       dispose?.();
     };
-  }, [projectKey, endpoint, onCapture, defaultPixelPerfect]);
+  }, [port]);
   return null;
 }
 
 // src/index.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.3.1";
 export {
   InSitue,
   InSitueCapture,
   SDK_VERSION,
-  mountCaptureOnly,
-  mountInSitue
+  mountCaptureOnly
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insitue/sdk",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "InSitue capture SDK — drop one snippet into your deployed app; your users point at a bug, InSitue opens a verified pull request.",
   "license": "MIT",
   "type": "module",
@@ -13,11 +13,6 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./overlay": {
-      "types": "./dist/overlay.d.ts",
-      "import": "./dist/overlay.js",
-      "default": "./dist/overlay.js"
-    },
     "./capture-only": {
       "types": "./dist/capture-only.d.ts",
       "import": "./dist/capture-only.js",