@runhuman/sensor 0.1.3 → 0.2.1

package/dist/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

@@ -93,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"),
   // ============================================
@@ -138,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) */
@@ -181,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) */
@@ -276,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"),
   // ============================================
@@ -457,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"),
   // ============================================
@@ -517,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
@@ -548,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}`;
   }
@@ -817,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();
@@ -824,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
@@ -835,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();
@@ -846,7 +895,7 @@ var SessionManager = class {
       this.pollTimer = null;
     }
     if (this.state === "polling") {
-      this.state = "idle";
+      this.setState("idle");
       this.log("Polling stopped");
     }
   }
@@ -883,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();
@@ -896,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,
@@ -915,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;
@@ -937,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;
@@ -1028,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,
@@ -1104,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}`);