@runhuman/sensor 0.3.0 → 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.
@@ -180,6 +183,8 @@ 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) */
@@ -199,7 +204,7 @@ interface RunhumanProviderProps {
     /** Log debug info to console (default: false) */
     debug?: boolean;
 }
-declare function RunhumanProvider({ children, apiKey, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): 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.
@@ -210,6 +215,7 @@ interface SensorState {
     state: SessionState;
     activeJobId: string | null;
     sessionId: string | null;
+    disabled: boolean;
 }
 /**
  * Subscribe to the sensor's session state.

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.
@@ -180,6 +183,8 @@ 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) */
@@ -199,7 +204,7 @@ interface RunhumanProviderProps {
     /** Log debug info to console (default: false) */
     debug?: boolean;
 }
-declare function RunhumanProvider({ children, apiKey, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): 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.
@@ -210,6 +215,7 @@ interface SensorState {
     state: SessionState;
     activeJobId: string | null;
     sessionId: string | null;
+    disabled: boolean;
 }
 /**
  * Subscribe to the sensor's session state.

package/dist/index.js

@@ -197,6 +197,8 @@ var apiRoutes = {
   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 */
@@ -858,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;
@@ -880,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.
@@ -964,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", {
@@ -1199,7 +1216,7 @@ 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();
@@ -1235,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);
@@ -1403,12 +1421,18 @@ 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);
     }
   };
@@ -1499,6 +1523,7 @@ var positionMap = {
 function RunhumanProvider({
   children,
   apiKey,
+  enabled = true,
   position = "bottom-right",
   baseUrl,
   jobId,
@@ -1511,7 +1536,7 @@ function RunhumanProvider({
 }) {
   const initializedRef = (0, import_react5.useRef)(false);
   (0, import_react5.useEffect)(() => {
-    if (initializedRef.current) return;
+    if (!enabled || initializedRef.current) return;
     initializedRef.current = true;
     const config = {
       apiKey,
@@ -1529,13 +1554,14 @@ function RunhumanProvider({
       initializedRef.current = false;
       Runhuman.getInstance().destroy();
     };
-  }, []);
-  const { state, activeJobId } = useSensorState();
+  }, [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({