@runhuman/sensor 0.1.2 → 0.2.0

package/dist/{index.d.cts → index.d.mts}

@@ -1,5 +1,7 @@
 import { 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';
 
 /**
  * Runhuman Sensor — Public API
@@ -35,6 +37,7 @@ interface RunhumanConfig {
 }
 declare class Runhuman {
     private static instance;
+    private readonly apiClient;
     private readonly sessionManager;
     private readonly deepLinkHandler;
     private readonly debug;
@@ -68,7 +71,11 @@ declare class Runhuman {
      * After calling destroy(), you can call init() again.
      */
     destroy(): Promise<void>;
+    /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+    getSessionManager(): SessionManager;
+    /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+    getApiClient(): ApiClient;
     private log;
 }
 
-export { Runhuman, type RunhumanConfig };
+export { ApiClient, Runhuman, type RunhumanConfig };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { 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';
 
 /**
  * Runhuman Sensor — Public API
@@ -35,6 +37,7 @@ interface RunhumanConfig {
 }
 declare class Runhuman {
     private static instance;
+    private readonly apiClient;
     private readonly sessionManager;
     private readonly deepLinkHandler;
     private readonly debug;
@@ -68,7 +71,11 @@ declare class Runhuman {
      * After calling destroy(), you can call init() again.
      */
     destroy(): Promise<void>;
+    /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+    getSessionManager(): SessionManager;
+    /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+    getApiClient(): ApiClient;
     private log;
 }
 
-export { Runhuman, type RunhumanConfig };
+export { ApiClient, Runhuman, type RunhumanConfig };

package/dist/index.js

@@ -1,9 +1,28 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Runhuman: () => Runhuman
 });
+module.exports = __toCommonJS(index_exports);
 
 // ../shared/dist/routes/route-builder.js
 var API_PREFIX = "/api";
@@ -74,6 +93,8 @@ var webRoutes = {
   organizationGitHub: defineRoute("/dashboard/organizations/:organizationId/github"),
   /** Organization SSO/SAML configuration page */
   organizationSso: defineRoute("/dashboard/organizations/:organizationId/sso"),
+  /** Organization schedules overview */
+  organizationSchedules: defineRoute("/dashboard/organizations/:organizationId/schedules"),
   /** Import from GitHub page */
   organizationImportGitHub: defineRoute("/dashboard/organizations/:organizationId/import"),
   // ============================================
@@ -119,6 +140,8 @@ var webRoutes = {
   issueSession: defineRoute("/dashboard/:projectId/issue-sessions/:sessionId"),
   /** Project settings page */
   projectSettings: defineRoute("/dashboard/:projectId/settings"),
+  /** Schedules page */
+  schedules: defineRoute("/dashboard/:projectId/schedules"),
   /** Flow charts page */
   flowCharts: defineRoute("/dashboard/:projectId/flowcharts"),
   /** Single flow chart detail (embedded in dashboard - deprecated, use flowChartView) */
@@ -162,6 +185,8 @@ var apiRoutes = {
   job: defineRoute("/jobs/:jobId"),
   /** Get job status (for polling) */
   jobStatus: defineRoute("/jobs/:jobId/status"),
+  /** Get individual job artifact by type */
+  jobArtifact: defineRoute("/jobs/:jobId/artifacts/:artifactType"),
   /** Update job feedback and rating */
   jobFeedback: defineRoute("/jobs/:jobId/feedback"),
   /** Enable/disable public sharing for a job (POST = enable, DELETE = disable) */
@@ -257,6 +282,12 @@ var apiRoutes = {
   projectFlowChartChat: defineRoute("/projects/:projectId/flowcharts/:flowchartId/chat"),
   /** Enable/disable public sharing for a flow chart */
   projectFlowChartShare: defineRoute("/projects/:projectId/flowcharts/:flowchartId/share"),
+  /** List schedules for a project (GET) or create schedule (POST) */
+  projectSchedules: defineRoute("/projects/:projectId/schedules"),
+  /** Get/update/delete specific schedule */
+  projectSchedule: defineRoute("/projects/:projectId/schedules/:scheduleId"),
+  /** List execution history for a schedule */
+  projectScheduleExecutions: defineRoute("/projects/:projectId/schedules/:scheduleId/executions"),
   /** Bulk create projects from GitHub repos */
   bulkCreateProjects: defineRoute("/projects/bulk"),
   // ============================================
@@ -438,6 +469,8 @@ var apiRoutes = {
   organizationGitHubRepoCheckAccess: defineRoute("/organizations/:organizationId/github/repos/check-access"),
   /** Find deployed URL for a repo via org's GitHub installations */
   organizationGitHubRepoFindUrl: defineRoute("/organizations/:organizationId/github/repos/find-url"),
+  /** Get all schedules across projects in the organization */
+  organizationSchedules: defineRoute("/organizations/:organizationId/schedules"),
   /** Get organization billing balance (Polar) */
   organizationBilling: defineRoute("/organizations/:organizationId/billing"),
   // ============================================
@@ -498,7 +531,9 @@ var apiRoutes = {
   /** Submit telemetry event batch (POST) — SDK periodically flushes captured events */
   telemetryBatch: defineRoute("/telemetry/sessions/:sessionId/events"),
   /** Check session status for a job (GET) — SDK polls to know when to activate */
-  telemetrySessionStatus: defineRoute("/telemetry/jobs/:jobId/status")
+  telemetrySessionStatus: defineRoute("/telemetry/jobs/:jobId/status"),
+  /** Resolve a sensor short code to a jobId (GET) — SDK calls this when tester enters a code */
+  telemetryShortCodeResolve: defineRoute("/telemetry/short-codes/:code")
 };
 
 // src/api-client.ts
@@ -529,6 +564,17 @@ var ApiClient = class {
   async getSessionStatus(jobId) {
     return this.get(apiRoutes.telemetrySessionStatus.build({ jobId }));
   }
+  async resolveShortCode(code) {
+    const normalized = code.replace(/^RH-/i, "").toUpperCase();
+    try {
+      return await this.get(
+        apiRoutes.telemetryShortCodeResolve.build({ code: normalized })
+      );
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("404")) return null;
+      throw error;
+    }
+  }
   url(routePath) {
     return `${this.baseUrl}${API_PREFIX}${routePath}`;
   }
@@ -798,6 +844,7 @@ var SessionManager = class {
     this.activeJobId = null;
     this.pollTimer = null;
     this.flushTimer = null;
+    this.listeners = /* @__PURE__ */ new Set();
     this.config = config;
     this.buffer = new EventBuffer(config.maxBufferSize);
     this.interceptors = new InterceptorManager();
@@ -805,9 +852,30 @@ var SessionManager = class {
   getState() {
     return this.state;
   }
+  /** Alias for getState() — named for React's useSyncExternalStore convention */
+  getSnapshot() {
+    return this.state;
+  }
   getSessionId() {
     return this.sessionId;
   }
+  getActiveJobId() {
+    return this.activeJobId;
+  }
+  /**
+   * Subscribe to state changes. Returns an unsubscribe function.
+   * Compatible with React's useSyncExternalStore.
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  setState(newState) {
+    this.state = newState;
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
   /**
    * Start polling for job activation.
    * The sensor calls this on init — polling continues until a job is detected
@@ -816,7 +884,7 @@ var SessionManager = class {
   startPolling(jobId) {
     if (this.state !== "idle") return;
     this.activeJobId = jobId;
-    this.state = "polling";
+    this.setState("polling");
     this.log("Polling started", { jobId });
     this.pollTimer = setInterval(() => this.pollOnce(), this.config.pollIntervalMs);
     this.pollOnce();
@@ -827,7 +895,7 @@ var SessionManager = class {
       this.pollTimer = null;
     }
     if (this.state === "polling") {
-      this.state = "idle";
+      this.setState("idle");
       this.log("Polling stopped");
     }
   }
@@ -864,10 +932,9 @@ var SessionManager = class {
     if (this.state !== "polling" || !this.activeJobId) return;
     try {
       const status = await this.config.apiClient.getSessionStatus(this.activeJobId);
-      if (status.jobActive && status.sdkEnabled && status.activeSessionId) {
-        this.log("Job has active session, starting capture", {
-          jobId: this.activeJobId,
-          activeSessionId: status.activeSessionId
+      if (status.jobActive && !status.activeSessionId) {
+        this.log("Job is active, creating session", {
+          jobId: this.activeJobId
         });
         this.stopPolling();
         await this.startSession();
@@ -877,7 +944,7 @@ var SessionManager = class {
     }
   }
   async startSession() {
-    this.state = "active";
+    this.setState("active");
     const now = /* @__PURE__ */ new Date();
     const response = await this.config.apiClient.createSession({
       jobId: this.activeJobId,
@@ -896,7 +963,7 @@ var SessionManager = class {
     this.flushTimer = setInterval(() => this.flush(), this.config.flushIntervalMs);
   }
   async endSession() {
-    this.state = "ending";
+    this.setState("ending");
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
@@ -918,7 +985,7 @@ var SessionManager = class {
     this.sessionId = null;
     this.activeJobId = null;
     this.buffer.clear();
-    this.state = "idle";
+    this.setState("idle");
   }
   async flush() {
     if (!this.sessionId) return;
@@ -990,7 +1057,7 @@ var DeepLinkHandler = class {
   }
   getLinking() {
     try {
-      const { Linking } = __require("react-native");
+      const { Linking } = require("react-native");
       return Linking;
     } catch {
       return null;
@@ -1009,12 +1076,12 @@ var SDK_VERSION = "0.1.0";
 var _Runhuman = class _Runhuman {
   constructor(config) {
     this.debug = config.debug === true;
-    const apiClient = new ApiClient(
+    this.apiClient = new ApiClient(
       config.baseUrl ?? PRODUCTION_BASE_URL,
       config.apiKey
     );
     this.sessionManager = new SessionManager({
-      apiClient,
+      apiClient: this.apiClient,
       platform: config.platform ?? "react-native",
       sdkVersion: SDK_VERSION,
       flushIntervalMs: config.flushIntervalMs ?? 5e3,
@@ -1085,6 +1152,14 @@ var _Runhuman = class _Runhuman {
     _Runhuman.instance = null;
     this.log("Destroyed");
   }
+  /** Access the session manager (used by <RunhumanOverlay /> for reactive state) */
+  getSessionManager() {
+    return this.sessionManager;
+  }
+  /** Access the API client (used by <RunhumanOverlay /> for short code resolution) */
+  getApiClient() {
+    return this.apiClient;
+  }
   log(message) {
     if (this.debug) {
       console.debug(`[Runhuman] ${message}`);
@@ -1093,7 +1168,8 @@ var _Runhuman = class _Runhuman {
 };
 _Runhuman.instance = null;
 var Runhuman = _Runhuman;
-export {
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
   Runhuman
-};
+});
 //# sourceMappingURL=index.js.map