@runhuman/sensor 0.2.5 → 0.3.1

package/dist/index.d.mts

@@ -52,6 +52,7 @@ interface SessionManagerConfig {
 }
 declare class SessionManager {
     private state;
+    private _disabled;
     private sessionId;
     private activeJobId;
     private pollTimer;
@@ -66,6 +67,8 @@ declare class SessionManager {
     getSnapshot(): SessionState;
     getSessionId(): string | null;
     getActiveJobId(): string | null;
+    /** True when the API rejected the session (e.g. subscription tier). Hides the overlay. */
+    isDisabled(): boolean;
     /**
      * Subscribe to state changes. Returns an unsubscribe function.
      * Compatible with React's useSyncExternalStore.
@@ -168,20 +171,40 @@ declare class Runhuman {
      * After calling destroy(), you can call init() again.
      */
     destroy(): Promise<void>;
-    /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+    /** Access the session manager (used by <RunhumanProvider /> for reactive state) */
     getSessionManager(): SessionManager;
-    /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+    /** Access the API client (used by <RunhumanProvider /> for short code resolution) */
     getApiClient(): ApiClient;
     private log;
 }
 
 type OverlayPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-interface RunhumanOverlayProps {
+interface RunhumanProviderProps {
     children: React.ReactNode;
+    /** API key for authentication (e.g., 'rh_...') */
+    apiKey: string;
+    /** Set to false to disable the sensor entirely (e.g., in production). Default: true */
+    enabled?: boolean;
     /** Corner for the overlay UI (default: 'bottom-right') */
     position?: OverlayPosition;
+    /** Base URL of the Runhuman API (defaults to production) */
+    baseUrl?: string;
+    /** Job ID if known upfront (e.g., from deep link params at app launch) */
+    jobId?: string;
+    /** Target platform (defaults to 'react-native') */
+    platform?: TelemetryPlatform;
+    /** How often to flush buffered events in ms (default: 5000) */
+    flushIntervalMs?: number;
+    /** How often to poll for job status in ms (default: 10000) */
+    pollIntervalMs?: number;
+    /** Max events in the ring buffer before FIFO eviction (default: 1000) */
+    maxBufferSize?: number;
+    /** Enable deep link activation (default: true) */
+    enableDeepLinks?: boolean;
+    /** Log debug info to console (default: false) */
+    debug?: boolean;
 }
-declare function RunhumanOverlay({ children, position }: RunhumanOverlayProps): react_jsx_runtime.JSX.Element;
+declare function RunhumanProvider({ children, apiKey, enabled, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * React hook for subscribing to sensor state changes.
@@ -192,6 +215,7 @@ interface SensorState {
     state: SessionState;
     activeJobId: string | null;
     sessionId: string | null;
+    disabled: boolean;
 }
 /**
  * Subscribe to the sensor's session state.
@@ -199,4 +223,4 @@ interface SensorState {
  */
 declare function useSensorState(): SensorState;
 
-export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanOverlay, type RunhumanOverlayProps, type SensorState, type SessionState, useSensorState };
+export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanProvider, type RunhumanProviderProps, type SensorState, type SessionState, useSensorState };

package/dist/index.d.ts

@@ -52,6 +52,7 @@ interface SessionManagerConfig {
 }
 declare class SessionManager {
     private state;
+    private _disabled;
     private sessionId;
     private activeJobId;
     private pollTimer;
@@ -66,6 +67,8 @@ declare class SessionManager {
     getSnapshot(): SessionState;
     getSessionId(): string | null;
     getActiveJobId(): string | null;
+    /** True when the API rejected the session (e.g. subscription tier). Hides the overlay. */
+    isDisabled(): boolean;
     /**
      * Subscribe to state changes. Returns an unsubscribe function.
      * Compatible with React's useSyncExternalStore.
@@ -168,20 +171,40 @@ declare class Runhuman {
      * After calling destroy(), you can call init() again.
      */
     destroy(): Promise<void>;
-    /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+    /** Access the session manager (used by <RunhumanProvider /> for reactive state) */
     getSessionManager(): SessionManager;
-    /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+    /** Access the API client (used by <RunhumanProvider /> for short code resolution) */
     getApiClient(): ApiClient;
     private log;
 }
 
 type OverlayPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-interface RunhumanOverlayProps {
+interface RunhumanProviderProps {
     children: React.ReactNode;
+    /** API key for authentication (e.g., 'rh_...') */
+    apiKey: string;
+    /** Set to false to disable the sensor entirely (e.g., in production). Default: true */
+    enabled?: boolean;
     /** Corner for the overlay UI (default: 'bottom-right') */
     position?: OverlayPosition;
+    /** Base URL of the Runhuman API (defaults to production) */
+    baseUrl?: string;
+    /** Job ID if known upfront (e.g., from deep link params at app launch) */
+    jobId?: string;
+    /** Target platform (defaults to 'react-native') */
+    platform?: TelemetryPlatform;
+    /** How often to flush buffered events in ms (default: 5000) */
+    flushIntervalMs?: number;
+    /** How often to poll for job status in ms (default: 10000) */
+    pollIntervalMs?: number;
+    /** Max events in the ring buffer before FIFO eviction (default: 1000) */
+    maxBufferSize?: number;
+    /** Enable deep link activation (default: true) */
+    enableDeepLinks?: boolean;
+    /** Log debug info to console (default: false) */
+    debug?: boolean;
 }
-declare function RunhumanOverlay({ children, position }: RunhumanOverlayProps): react_jsx_runtime.JSX.Element;
+declare function RunhumanProvider({ children, apiKey, enabled, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * React hook for subscribing to sensor state changes.
@@ -192,6 +215,7 @@ interface SensorState {
     state: SessionState;
     activeJobId: string | null;
     sessionId: string | null;
+    disabled: boolean;
 }
 /**
  * Subscribe to the sensor's session state.
@@ -199,4 +223,4 @@ interface SensorState {
  */
 declare function useSensorState(): SensorState;
 
-export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanOverlay, type RunhumanOverlayProps, type SensorState, type SessionState, useSensorState };
+export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanProvider, type RunhumanProviderProps, type SensorState, type SessionState, useSensorState };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,13 +17,21 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
   Runhuman: () => Runhuman,
-  RunhumanOverlay: () => RunhumanOverlay,
+  RunhumanProvider: () => RunhumanProvider,
   useSensorState: () => useSensorState
 });
 module.exports = __toCommonJS(index_exports);
@@ -185,6 +195,10 @@ var apiRoutes = {
   jobs: defineRoute("/jobs"),
   /** Get/update/delete specific job */
   job: defineRoute("/jobs/:jobId"),
+  /** Cancel a job */
+  jobCancel: defineRoute("/jobs/:jobId/cancel"),
+  /** Create a GitHub issue from an extracted finding (user-initiated) */
+  jobCreateIssue: defineRoute("/jobs/:jobId/create-issue"),
   /** Get job status (for polling) */
   jobStatus: defineRoute("/jobs/:jobId/status"),
   /** Get individual job artifact by type */
@@ -303,6 +317,8 @@ var apiRoutes = {
   githubLink: defineRoute("/github/link"),
   /** List issues for a repo (by owner/repo) */
   githubIssuesByRepo: defineRoute("/github/issues/:owner/:repo"),
+  /** Get a single issue for a repo (by owner/repo/issueNumber) */
+  githubIssueByRepo: defineRoute("/github/issues/:owner/:repo/:issueNumber"),
   /** List issues (by projectId query param) */
   githubIssues: defineRoute("/github/issues"),
   /** Get a single issue */
@@ -457,8 +473,10 @@ var apiRoutes = {
   organizationJobs: defineRoute("/organizations/:organizationId/jobs"),
   /** Transfer organization ownership */
   organizationTransferOwnership: defineRoute("/organizations/:organizationId/transfer-ownership"),
-  /** Create organization API key */
+  /** List/create organization API keys */
   organizationApiKeys: defineRoute("/organizations/:organizationId/api-keys"),
+  /** Get/revoke/delete a specific organization API key */
+  organizationApiKey: defineRoute("/organizations/:organizationId/api-keys/:keyId"),
   /** Get GitHub installations for an organization */
   organizationGitHubInstallations: defineRoute("/organizations/:organizationId/github/installations"),
   /** Get/delete specific GitHub installation for an organization */
@@ -567,7 +585,7 @@ var ApiClient = class {
     return this.get(apiRoutes.telemetrySessionStatus.build({ jobId }));
   }
   async resolveShortCode(code) {
-    const normalized = code.replace(/^RH-/i, "").toUpperCase();
+    const normalized = code.toUpperCase().trim();
     try {
       return await this.get(
         apiRoutes.telemetryShortCodeResolve.build({ code: normalized })
@@ -842,6 +860,7 @@ var InterceptorManager = class {
 var SessionManager = class {
   constructor(config) {
     this.state = "idle";
+    this._disabled = false;
     this.sessionId = null;
     this.activeJobId = null;
     this.pollTimer = null;
@@ -864,6 +883,10 @@ var SessionManager = class {
   getActiveJobId() {
     return this.activeJobId;
   }
+  /** True when the API rejected the session (e.g. subscription tier). Hides the overlay. */
+  isDisabled() {
+    return this._disabled;
+  }
   /**
    * Subscribe to state changes. Returns an unsubscribe function.
    * Compatible with React's useSyncExternalStore.
@@ -948,12 +971,22 @@ var SessionManager = class {
   async startSession() {
     this.setState("active");
     const now = /* @__PURE__ */ new Date();
-    const response = await this.config.apiClient.createSession({
-      jobId: this.activeJobId,
-      platform: this.config.platform,
-      sdkVersion: this.config.sdkVersion,
-      clientStartTime: now.toISOString()
-    });
+    let response;
+    try {
+      response = await this.config.apiClient.createSession({
+        jobId: this.activeJobId,
+        platform: this.config.platform,
+        sdkVersion: this.config.sdkVersion,
+        clientStartTime: now.toISOString()
+      });
+    } catch (error) {
+      const is403 = error instanceof Error && error.message.includes("403");
+      this.log(is403 ? "Subscription not eligible \u2014 disabling sensor" : "Session creation failed", { error });
+      if (is403) this._disabled = true;
+      this.activeJobId = null;
+      this.setState("idle");
+      return;
+    }
     this.sessionId = response.sessionId;
     const sessionStartTime = now.getTime();
     this.log("Session started", {
@@ -1161,11 +1194,11 @@ var Runhuman = class _Runhuman {
     _Runhuman.instance = null;
     this.log("Destroyed");
   }
-  /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+  /** Access the session manager (used by <RunhumanProvider /> for reactive state) */
   getSessionManager() {
     return this.sessionManager;
   }
-  /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+  /** Access the API client (used by <RunhumanProvider /> for short code resolution) */
   getApiClient() {
     return this.apiClient;
   }
@@ -1176,13 +1209,14 @@ var Runhuman = class _Runhuman {
   }
 };
 
-// src/overlay/RunhumanOverlay.tsx
+// src/overlay/RunhumanProvider.tsx
+var import_react5 = require("react");
 var import_react_native4 = require("react-native");
 
 // src/overlay/use-sensor-state.ts
 var import_react = require("react");
 var import_react2 = require("react");
-var IDLE_STATE = { state: "idle", activeJobId: null, sessionId: null };
+var IDLE_STATE = { state: "idle", activeJobId: null, sessionId: null, disabled: false };
 function tryGetInstance() {
   try {
     return Runhuman.getInstance();
@@ -1218,11 +1252,12 @@ function useSensorState() {
     const state = sm.getSnapshot();
     const activeJobId = sm.getActiveJobId();
     const sessionId = sm.getSessionId();
+    const disabled = sm.isDisabled();
     const prev = cached.current;
-    if (prev.state === state && prev.activeJobId === activeJobId && prev.sessionId === sessionId) {
+    if (prev.state === state && prev.activeJobId === activeJobId && prev.sessionId === sessionId && prev.disabled === disabled) {
       return prev;
     }
-    cached.current = { state, activeJobId, sessionId };
+    cached.current = { state, activeJobId, sessionId, disabled };
     return cached.current;
   }, []);
   return (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
@@ -1263,6 +1298,11 @@ var overlayStyles = import_react_native.StyleSheet.create({
     fontWeight: "600",
     marginBottom: 8
   },
+  inputRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 6
+  },
   input: {
     backgroundColor: "rgba(255, 255, 255, 0.1)",
     borderRadius: 8,
@@ -1276,9 +1316,25 @@ var overlayStyles = import_react_native.StyleSheet.create({
     padding: 10,
     textAlign: "center"
   },
+  inputFlex: {
+    flex: 1
+  },
   inputError: {
     borderColor: BRAND_RED
   },
+  pasteButton: {
+    backgroundColor: "rgba(255, 255, 255, 0.1)",
+    borderRadius: 8,
+    borderWidth: 1,
+    borderColor: OVERLAY_BORDER,
+    paddingVertical: 10,
+    paddingHorizontal: 8
+  },
+  pasteButtonText: {
+    color: "rgba(255, 255, 255, 0.6)",
+    fontSize: 11,
+    fontWeight: "600"
+  },
   submitButton: {
     backgroundColor: BRAND_BLUE,
     borderRadius: 8,
@@ -1345,6 +1401,14 @@ var overlayStyles = import_react_native.StyleSheet.create({
   }
 });
 
+// src/overlay/clipboard.ts
+var ReactNative = __toESM(require("react-native"));
+var RN = ReactNative;
+var clipboard = RN["Clipboard"];
+async function getClipboardText() {
+  return clipboard.getString();
+}
+
 // src/overlay/CodeEntryPanel.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function CodeEntryPanel({ position }) {
@@ -1357,38 +1421,55 @@ function CodeEntryPanel({ position }) {
     if (!trimmed) return;
     setResolving(true);
     setError(null);
-    const instance = Runhuman.getInstance();
-    const result = await instance.getApiClient().resolveShortCode(trimmed);
-    if (result) {
-      instance.activate(result.jobId);
-    } else {
-      setError("Invalid or expired code");
+    try {
+      const instance = Runhuman.getInstance();
+      const result = await instance.getApiClient().resolveShortCode(trimmed);
+      if (result) {
+        await instance.activate(result.jobId);
+      } else {
+        setError("Invalid or expired code");
+        setResolving(false);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Activation failed";
+      setError(message);
       setResolving(false);
     }
   };
+  const handlePaste = async () => {
+    const text = await getClipboardText();
+    const trimmed = text.trim().toUpperCase().slice(0, 6);
+    if (trimmed) {
+      setCode(trimmed);
+      setError(null);
+    }
+  };
   if (minimized) {
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Pressable, { style: [overlayStyles.fab, overlayStyles[position]], onPress: () => setMinimized(false), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.fabText, children: "RH" }) });
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native2.View, { style: [overlayStyles.panel, overlayStyles[position]], children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Pressable, { style: overlayStyles.minimizeButton, onPress: () => setMinimized(true), children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.minimizeText, children: "-" }) }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.panelTitle, children: "Runhuman Sensor" }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      import_react_native2.TextInput,
-      {
-        style: error ? { ...overlayStyles.input, ...overlayStyles.inputError } : overlayStyles.input,
-        value: code,
-        onChangeText: (text) => {
-          setCode(text.toUpperCase());
-          setError(null);
-        },
-        placeholder: "RH-XXXX",
-        placeholderTextColor: "rgba(255,255,255,0.3)",
-        autoCapitalize: "characters",
-        maxLength: 10,
-        editable: !resolving,
-        onSubmitEditing: handleSubmit
-      }
-    ),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native2.View, { style: overlayStyles.inputRow, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        import_react_native2.TextInput,
+        {
+          style: [error ? { ...overlayStyles.input, ...overlayStyles.inputError } : overlayStyles.input, overlayStyles.inputFlex],
+          value: code,
+          onChangeText: (text) => {
+            setCode(text.toUpperCase());
+            setError(null);
+          },
+          placeholder: "XXXX",
+          placeholderTextColor: "rgba(255,255,255,0.3)",
+          autoCapitalize: "characters",
+          maxLength: 6,
+          editable: !resolving,
+          onSubmitEditing: handleSubmit
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Pressable, { style: overlayStyles.pasteButton, onPress: handlePaste, disabled: resolving, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.pasteButtonText, children: "Paste" }) })
+    ] }),
     error ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.errorText, children: error }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       import_react_native2.Pressable,
@@ -1431,7 +1512,7 @@ function ActiveIndicator({ state, position }) {
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Animated.View, { style: [overlayStyles.indicator, overlayStyles[position], colorStyle, { opacity: pulse }] });
 }
 
-// src/overlay/RunhumanOverlay.tsx
+// src/overlay/RunhumanProvider.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var positionMap = {
   "top-left": "topLeft",
@@ -1439,13 +1520,48 @@ var positionMap = {
   "bottom-left": "bottomLeft",
   "bottom-right": "bottomRight"
 };
-function RunhumanOverlay({ children, position = "bottom-right" }) {
-  const { state, activeJobId } = useSensorState();
+function RunhumanProvider({
+  children,
+  apiKey,
+  enabled = true,
+  position = "bottom-right",
+  baseUrl,
+  jobId,
+  platform,
+  flushIntervalMs,
+  pollIntervalMs,
+  maxBufferSize,
+  enableDeepLinks,
+  debug
+}) {
+  const initializedRef = (0, import_react5.useRef)(false);
+  (0, import_react5.useEffect)(() => {
+    if (!enabled || initializedRef.current) return;
+    initializedRef.current = true;
+    const config = {
+      apiKey,
+      baseUrl,
+      jobId,
+      platform,
+      flushIntervalMs,
+      pollIntervalMs,
+      maxBufferSize,
+      enableDeepLinks,
+      debug
+    };
+    Runhuman.init(config);
+    return () => {
+      initializedRef.current = false;
+      Runhuman.getInstance().destroy();
+    };
+  }, [enabled]);
+  const { state, activeJobId, disabled } = useSensorState();
+  const showOverlay = enabled && !disabled;
   const posKey = positionMap[position];
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native4.View, { style: styles.container, children: [
     children,
-    state === "idle" && !activeJobId ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(CodeEntryPanel, { position: posKey }) : null,
-    state !== "idle" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ActiveIndicator, { state, position: posKey }) : null
+    showOverlay && state === "idle" && !activeJobId ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(CodeEntryPanel, { position: posKey }) : null,
+    showOverlay && state !== "idle" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ActiveIndicator, { state, position: posKey }) : null
   ] });
 }
 var styles = import_react_native4.StyleSheet.create({
@@ -1456,7 +1572,7 @@ var styles = import_react_native4.StyleSheet.create({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Runhuman,
-  RunhumanOverlay,
+  RunhumanProvider,
   useSensorState
 });
 //# sourceMappingURL=index.js.map