@runhuman/sensor 0.2.4 → 0.3.0

package/dist/index.d.mts

@@ -168,20 +168,38 @@ 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;
     /** 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, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * React hook for subscribing to sensor state changes.
@@ -199,4 +217,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

@@ -168,20 +168,38 @@ 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;
     /** 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, position, baseUrl, jobId, platform, flushIntervalMs, pollIntervalMs, maxBufferSize, enableDeepLinks, debug, }: RunhumanProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * React hook for subscribing to sensor state changes.
@@ -199,4 +217,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,8 @@ var apiRoutes = {
   jobs: defineRoute("/jobs"),
   /** Get/update/delete specific job */
   job: defineRoute("/jobs/:jobId"),
+  /** Cancel a job */
+  jobCancel: defineRoute("/jobs/:jobId/cancel"),
   /** Get job status (for polling) */
   jobStatus: defineRoute("/jobs/:jobId/status"),
   /** Get individual job artifact by type */
@@ -303,6 +315,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 +471,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 +583,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 })
@@ -1161,11 +1177,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,7 +1192,8 @@ 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
@@ -1194,16 +1211,22 @@ function useSensorState() {
   const cached = (0, import_react.useRef)(IDLE_STATE);
   const subscribe = (0, import_react.useCallback)((onStoreChange) => {
     const instance = tryGetInstance();
-    if (!instance) {
-      const interval = setInterval(() => {
-        if (tryGetInstance()) {
-          clearInterval(interval);
-          onStoreChange();
-        }
-      }, 100);
-      return () => clearInterval(interval);
+    if (instance) {
+      return instance.getSessionManager().subscribe(onStoreChange);
     }
-    return instance.getSessionManager().subscribe(onStoreChange);
+    let unsub = null;
+    const interval = setInterval(() => {
+      const inst = tryGetInstance();
+      if (inst) {
+        clearInterval(interval);
+        unsub = inst.getSessionManager().subscribe(onStoreChange);
+        onStoreChange();
+      }
+    }, 100);
+    return () => {
+      clearInterval(interval);
+      if (unsub) unsub();
+    };
   }, []);
   const getSnapshot = (0, import_react.useCallback)(() => {
     const instance = tryGetInstance();
@@ -1257,6 +1280,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,
@@ -1270,9 +1298,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,
@@ -1339,6 +1383,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 }) {
@@ -1360,29 +1412,40 @@ function CodeEntryPanel({ position }) {
       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,
@@ -1425,7 +1488,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",
@@ -1433,7 +1496,40 @@ var positionMap = {
   "bottom-left": "bottomLeft",
   "bottom-right": "bottomRight"
 };
-function RunhumanOverlay({ children, position = "bottom-right" }) {
+function RunhumanProvider({
+  children,
+  apiKey,
+  position = "bottom-right",
+  baseUrl,
+  jobId,
+  platform,
+  flushIntervalMs,
+  pollIntervalMs,
+  maxBufferSize,
+  enableDeepLinks,
+  debug
+}) {
+  const initializedRef = (0, import_react5.useRef)(false);
+  (0, import_react5.useEffect)(() => {
+    if (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();
+    };
+  }, []);
   const { state, activeJobId } = useSensorState();
   const posKey = positionMap[position];
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_react_native4.View, { style: styles.container, children: [
@@ -1450,7 +1546,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