@runhuman/sensor 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -1,7 +1,103 @@
-import { TelemetryPlatform } from '@runhuman/shared';
+import { CreateTelemetrySessionRequest, CreateTelemetrySessionResponse, TelemetryBatchRequest, TelemetryBatchResponse, EndTelemetrySessionResponse, TelemetrySessionStatusResponse, TelemetryPlatform } from '@runhuman/shared';
 export { TelemetryPlatform } from '@runhuman/shared';
-import { S as SessionManager, A as ApiClient } from './session-manager-B6tiwEQm.mjs';
-export { a as SessionState } from './session-manager-B6tiwEQm.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+/**
+ * Telemetry API Client
+ *
+ * Thin HTTP client wrapping the 4 Phase 0 telemetry endpoints.
+ * Captures a reference to fetch at construction time — before the
+ * network interceptor patches globalThis.fetch — to avoid recursion.
+ */
+
+declare class ApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetchFn;
+    constructor(baseUrl: string, apiKey: string);
+    createSession(req: CreateTelemetrySessionRequest): Promise<CreateTelemetrySessionResponse>;
+    submitBatch(sessionId: string, req: TelemetryBatchRequest): Promise<TelemetryBatchResponse>;
+    endSession(sessionId: string): Promise<EndTelemetrySessionResponse>;
+    getSessionStatus(jobId: string): Promise<TelemetrySessionStatusResponse>;
+    resolveShortCode(code: string): Promise<{
+        jobId: string;
+    } | null>;
+    private url;
+    private post;
+    private get;
+}
+
+/**
+ * Session Manager
+ *
+ * Orchestrates the sensor lifecycle:
+ *   idle → polling → active → ending → idle
+ *
+ * - Polls the status endpoint to detect when a tester starts a job
+ * - Creates a telemetry session and installs interceptors
+ * - Periodically flushes buffered events to the API
+ * - Ends the session when the job is no longer active
+ */
+
+type SessionState = 'idle' | 'polling' | 'active' | 'ending';
+interface SessionManagerConfig {
+    apiClient: ApiClient;
+    platform: TelemetryPlatform;
+    sdkVersion: string;
+    flushIntervalMs: number;
+    pollIntervalMs: number;
+    maxBufferSize: number;
+    debug: boolean;
+}
+declare class SessionManager {
+    private state;
+    private sessionId;
+    private activeJobId;
+    private pollTimer;
+    private flushTimer;
+    private readonly buffer;
+    private readonly interceptors;
+    private readonly config;
+    private readonly listeners;
+    constructor(config: SessionManagerConfig);
+    getState(): SessionState;
+    /** Alias for getState() — named for React's useSyncExternalStore convention */
+    getSnapshot(): SessionState;
+    getSessionId(): string | null;
+    getActiveJobId(): string | null;
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     * Compatible with React's useSyncExternalStore.
+     */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    /**
+     * Start polling for job activation.
+     * The sensor calls this on init — polling continues until a job is detected
+     * or stopPolling() is called.
+     */
+    startPolling(jobId: string): void;
+    stopPolling(): void;
+    /**
+     * Activate a session immediately (e.g., from a deep link).
+     * Skips polling — goes straight to session creation.
+     */
+    activate(jobId: string): Promise<void>;
+    /**
+     * End the current session and return to idle.
+     */
+    deactivate(): Promise<void>;
+    /**
+     * Full teardown — stop everything and clean up.
+     */
+    destroy(): Promise<void>;
+    private pollOnce;
+    private startSession;
+    private endSession;
+    private flush;
+    private log;
+}
 
 /**
  * Runhuman Sensor — Public API
@@ -36,7 +132,8 @@ interface RunhumanConfig {
     debug?: boolean;
 }
 declare class Runhuman {
-    private static instance;
+    private static get instance();
+    private static set instance(value);
     private readonly apiClient;
     private readonly sessionManager;
     private readonly deepLinkHandler;
@@ -78,4 +175,33 @@ declare class Runhuman {
     private log;
 }
 
-export { ApiClient, Runhuman, type RunhumanConfig };
+type OverlayPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+interface RunhumanOverlayProps {
+    children: React.ReactNode;
+    /** Corner for the overlay UI (default: 'bottom-right') */
+    position?: OverlayPosition;
+}
+declare function RunhumanOverlay({ children, position }: RunhumanOverlayProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * React hook for subscribing to sensor state changes.
+ * Uses useSyncExternalStore for tear-safe subscriptions.
+ *
+ * Handles the case where Runhuman.init() hasn't been called yet
+ * (e.g., during first render before useEffect fires) by polling
+ * until the instance is available.
+ */
+
+interface SensorState {
+    state: SessionState;
+    activeJobId: string | null;
+    sessionId: string | null;
+}
+/**
+ * Subscribe to the sensor's session state.
+ * Safe to call before Runhuman.init() — returns idle state and
+ * polls every 100ms until the instance becomes available.
+ */
+declare function useSensorState(): SensorState;
+
+export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanOverlay, type RunhumanOverlayProps, type SensorState, type SessionState, useSensorState };

package/dist/index.d.ts

@@ -1,7 +1,103 @@
-import { TelemetryPlatform } from '@runhuman/shared';
+import { CreateTelemetrySessionRequest, CreateTelemetrySessionResponse, TelemetryBatchRequest, TelemetryBatchResponse, EndTelemetrySessionResponse, TelemetrySessionStatusResponse, TelemetryPlatform } from '@runhuman/shared';
 export { TelemetryPlatform } from '@runhuman/shared';
-import { S as SessionManager, A as ApiClient } from './session-manager-B6tiwEQm.js';
-export { a as SessionState } from './session-manager-B6tiwEQm.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+/**
+ * Telemetry API Client
+ *
+ * Thin HTTP client wrapping the 4 Phase 0 telemetry endpoints.
+ * Captures a reference to fetch at construction time — before the
+ * network interceptor patches globalThis.fetch — to avoid recursion.
+ */
+
+declare class ApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetchFn;
+    constructor(baseUrl: string, apiKey: string);
+    createSession(req: CreateTelemetrySessionRequest): Promise<CreateTelemetrySessionResponse>;
+    submitBatch(sessionId: string, req: TelemetryBatchRequest): Promise<TelemetryBatchResponse>;
+    endSession(sessionId: string): Promise<EndTelemetrySessionResponse>;
+    getSessionStatus(jobId: string): Promise<TelemetrySessionStatusResponse>;
+    resolveShortCode(code: string): Promise<{
+        jobId: string;
+    } | null>;
+    private url;
+    private post;
+    private get;
+}
+
+/**
+ * Session Manager
+ *
+ * Orchestrates the sensor lifecycle:
+ *   idle → polling → active → ending → idle
+ *
+ * - Polls the status endpoint to detect when a tester starts a job
+ * - Creates a telemetry session and installs interceptors
+ * - Periodically flushes buffered events to the API
+ * - Ends the session when the job is no longer active
+ */
+
+type SessionState = 'idle' | 'polling' | 'active' | 'ending';
+interface SessionManagerConfig {
+    apiClient: ApiClient;
+    platform: TelemetryPlatform;
+    sdkVersion: string;
+    flushIntervalMs: number;
+    pollIntervalMs: number;
+    maxBufferSize: number;
+    debug: boolean;
+}
+declare class SessionManager {
+    private state;
+    private sessionId;
+    private activeJobId;
+    private pollTimer;
+    private flushTimer;
+    private readonly buffer;
+    private readonly interceptors;
+    private readonly config;
+    private readonly listeners;
+    constructor(config: SessionManagerConfig);
+    getState(): SessionState;
+    /** Alias for getState() — named for React's useSyncExternalStore convention */
+    getSnapshot(): SessionState;
+    getSessionId(): string | null;
+    getActiveJobId(): string | null;
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     * Compatible with React's useSyncExternalStore.
+     */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    /**
+     * Start polling for job activation.
+     * The sensor calls this on init — polling continues until a job is detected
+     * or stopPolling() is called.
+     */
+    startPolling(jobId: string): void;
+    stopPolling(): void;
+    /**
+     * Activate a session immediately (e.g., from a deep link).
+     * Skips polling — goes straight to session creation.
+     */
+    activate(jobId: string): Promise<void>;
+    /**
+     * End the current session and return to idle.
+     */
+    deactivate(): Promise<void>;
+    /**
+     * Full teardown — stop everything and clean up.
+     */
+    destroy(): Promise<void>;
+    private pollOnce;
+    private startSession;
+    private endSession;
+    private flush;
+    private log;
+}
 
 /**
  * Runhuman Sensor — Public API
@@ -36,7 +132,8 @@ interface RunhumanConfig {
     debug?: boolean;
 }
 declare class Runhuman {
-    private static instance;
+    private static get instance();
+    private static set instance(value);
     private readonly apiClient;
     private readonly sessionManager;
     private readonly deepLinkHandler;
@@ -78,4 +175,33 @@ declare class Runhuman {
     private log;
 }
 
-export { ApiClient, Runhuman, type RunhumanConfig };
+type OverlayPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+interface RunhumanOverlayProps {
+    children: React.ReactNode;
+    /** Corner for the overlay UI (default: 'bottom-right') */
+    position?: OverlayPosition;
+}
+declare function RunhumanOverlay({ children, position }: RunhumanOverlayProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * React hook for subscribing to sensor state changes.
+ * Uses useSyncExternalStore for tear-safe subscriptions.
+ *
+ * Handles the case where Runhuman.init() hasn't been called yet
+ * (e.g., during first render before useEffect fires) by polling
+ * until the instance is available.
+ */
+
+interface SensorState {
+    state: SessionState;
+    activeJobId: string | null;
+    sessionId: string | null;
+}
+/**
+ * Subscribe to the sensor's session state.
+ * Safe to call before Runhuman.init() — returns idle state and
+ * polls every 100ms until the instance becomes available.
+ */
+declare function useSensorState(): SensorState;
+
+export { ApiClient, type OverlayPosition, Runhuman, type RunhumanConfig, RunhumanOverlay, type RunhumanOverlayProps, type SensorState, type SessionState, useSensorState };

package/dist/index.js

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  Runhuman: () => Runhuman
+  Runhuman: () => Runhuman,
+  RunhumanOverlay: () => RunhumanOverlay,
+  useSensorState: () => useSensorState
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1073,7 +1075,14 @@ var DeepLinkHandler = class {
 // src/runhuman.ts
 var PRODUCTION_BASE_URL = "https://qa-experiment.fly.dev";
 var SDK_VERSION = "0.1.0";
-var _Runhuman = class _Runhuman {
+var INSTANCE_KEY = "__runhuman_sensor_instance__";
+var Runhuman = class _Runhuman {
+  static get instance() {
+    return globalThis[INSTANCE_KEY] ?? null;
+  }
+  static set instance(value) {
+    globalThis[INSTANCE_KEY] = value;
+  }
   constructor(config) {
     this.debug = config.debug === true;
     this.apiClient = new ApiClient(
@@ -1166,10 +1175,277 @@ var _Runhuman = class _Runhuman {
     }
   }
 };
-_Runhuman.instance = null;
-var Runhuman = _Runhuman;
+
+// src/overlay/RunhumanOverlay.tsx
+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 };
+function tryGetInstance() {
+  try {
+    return Runhuman.getInstance();
+  } catch {
+    return null;
+  }
+}
+function useSensorState() {
+  const subscribe = (0, import_react.useCallback)((onStoreChange) => {
+    const instance = tryGetInstance();
+    if (!instance) {
+      const interval = setInterval(() => {
+        if (tryGetInstance()) {
+          clearInterval(interval);
+          onStoreChange();
+        }
+      }, 100);
+      return () => clearInterval(interval);
+    }
+    return instance.getSessionManager().subscribe(onStoreChange);
+  }, []);
+  const getSnapshot = (0, import_react.useCallback)(() => {
+    const instance = tryGetInstance();
+    if (!instance) return IDLE_STATE;
+    const sm = instance.getSessionManager();
+    return {
+      state: sm.getSnapshot(),
+      activeJobId: sm.getActiveJobId(),
+      sessionId: sm.getSessionId()
+    };
+  }, []);
+  return (0, import_react2.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+}
+
+// src/overlay/CodeEntryPanel.tsx
+var import_react3 = require("react");
+var import_react_native2 = require("react-native");
+
+// src/overlay/overlay-styles.ts
+var import_react_native = require("react-native");
+var BRAND_GREEN = "#22c55e";
+var BRAND_AMBER = "#f59e0b";
+var BRAND_RED = "#ef4444";
+var BRAND_BLUE = "#3b82f6";
+var OVERLAY_BG = "rgba(0, 0, 0, 0.85)";
+var OVERLAY_BORDER = "rgba(255, 255, 255, 0.15)";
+var overlayStyles = import_react_native.StyleSheet.create({
+  // Positioning containers
+  topLeft: { top: 60, left: 16 },
+  topRight: { top: 60, right: 16 },
+  bottomLeft: { bottom: 40, left: 16 },
+  bottomRight: { bottom: 40, right: 16 },
+  // Code entry panel
+  panel: {
+    position: "absolute",
+    zIndex: 99999,
+    backgroundColor: OVERLAY_BG,
+    borderRadius: 12,
+    borderWidth: 1,
+    borderColor: OVERLAY_BORDER,
+    padding: 16,
+    width: 220
+  },
+  panelTitle: {
+    color: "#ffffff",
+    fontSize: 13,
+    fontWeight: "600",
+    marginBottom: 8
+  },
+  input: {
+    backgroundColor: "rgba(255, 255, 255, 0.1)",
+    borderRadius: 8,
+    borderWidth: 1,
+    borderColor: OVERLAY_BORDER,
+    color: "#ffffff",
+    fontSize: 18,
+    fontFamily: "monospace",
+    fontWeight: "bold",
+    letterSpacing: 2,
+    padding: 10,
+    textAlign: "center"
+  },
+  inputError: {
+    borderColor: BRAND_RED
+  },
+  submitButton: {
+    backgroundColor: BRAND_BLUE,
+    borderRadius: 8,
+    paddingVertical: 8,
+    marginTop: 8,
+    alignItems: "center"
+  },
+  submitButtonDisabled: {
+    opacity: 0.5
+  },
+  submitButtonText: {
+    color: "#ffffff",
+    fontSize: 13,
+    fontWeight: "600"
+  },
+  errorText: {
+    color: BRAND_RED,
+    fontSize: 11,
+    marginTop: 4,
+    textAlign: "center"
+  },
+  minimizeButton: {
+    position: "absolute",
+    top: 8,
+    right: 8
+  },
+  minimizeText: {
+    color: "rgba(255, 255, 255, 0.5)",
+    fontSize: 16
+  },
+  // Minimized fab (floating action button)
+  fab: {
+    position: "absolute",
+    zIndex: 99999,
+    width: 40,
+    height: 40,
+    borderRadius: 20,
+    backgroundColor: OVERLAY_BG,
+    borderWidth: 1,
+    borderColor: OVERLAY_BORDER,
+    alignItems: "center",
+    justifyContent: "center"
+  },
+  fabText: {
+    color: "#ffffff",
+    fontSize: 16
+  },
+  // Active indicator dot
+  indicator: {
+    position: "absolute",
+    zIndex: 99999,
+    width: 12,
+    height: 12,
+    borderRadius: 6
+  },
+  indicatorActive: {
+    backgroundColor: BRAND_GREEN
+  },
+  indicatorEnding: {
+    backgroundColor: BRAND_AMBER
+  },
+  indicatorPolling: {
+    backgroundColor: BRAND_BLUE
+  }
+});
+
+// src/overlay/CodeEntryPanel.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function CodeEntryPanel({ position }) {
+  const [code, setCode] = (0, import_react3.useState)("");
+  const [error, setError] = (0, import_react3.useState)(null);
+  const [resolving, setResolving] = (0, import_react3.useState)(false);
+  const [minimized, setMinimized] = (0, import_react3.useState)(false);
+  const handleSubmit = async () => {
+    const trimmed = code.trim();
+    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");
+      setResolving(false);
+    }
+  };
+  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
+      }
+    ),
+    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,
+      {
+        style: resolving ? { ...overlayStyles.submitButton, ...overlayStyles.submitButtonDisabled } : overlayStyles.submitButton,
+        onPress: handleSubmit,
+        disabled: resolving || !code.trim(),
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: overlayStyles.submitButtonText, children: resolving ? "Activating..." : "Activate" })
+      }
+    )
+  ] });
+}
+
+// src/overlay/ActiveIndicator.tsx
+var import_react4 = require("react");
+var import_react_native3 = require("react-native");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var stateStyle = {
+  active: overlayStyles.indicatorActive,
+  ending: overlayStyles.indicatorEnding,
+  polling: overlayStyles.indicatorPolling
+};
+function ActiveIndicator({ state, position }) {
+  const pulse = (0, import_react4.useRef)(new import_react_native3.Animated.Value(1)).current;
+  (0, import_react4.useEffect)(() => {
+    if (state === "active") {
+      const animation = import_react_native3.Animated.loop(
+        import_react_native3.Animated.sequence([
+          import_react_native3.Animated.timing(pulse, { toValue: 0.3, duration: 800, useNativeDriver: true }),
+          import_react_native3.Animated.timing(pulse, { toValue: 1, duration: 800, useNativeDriver: true })
+        ])
+      );
+      animation.start();
+      return () => animation.stop();
+    }
+    pulse.setValue(1);
+  }, [state, pulse]);
+  const colorStyle = stateStyle[state];
+  if (!colorStyle) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native3.Animated.View, { style: [overlayStyles.indicator, overlayStyles[position], colorStyle, { opacity: pulse }] });
+}
+
+// src/overlay/RunhumanOverlay.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+var positionMap = {
+  "top-left": "topLeft",
+  "top-right": "topRight",
+  "bottom-left": "bottomLeft",
+  "bottom-right": "bottomRight"
+};
+function RunhumanOverlay({ children, position = "bottom-right" }) {
+  const { state, activeJobId } = useSensorState();
+  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
+  ] });
+}
+var styles = import_react_native4.StyleSheet.create({
+  container: {
+    flex: 1
+  }
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Runhuman
+  Runhuman,
+  RunhumanOverlay,
+  useSensorState
 });
 //# sourceMappingURL=index.js.map