notte-sdk 0.0.6 → 0.0.8

package/dist/index.mjs

@@ -5,6 +5,104 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// src/version.ts
+var SDK_VERSION = true ? "0.0.8" : "dev";
+var SDK_PACKAGE_NAME = true ? "notte-sdk" : "notte-sdk";
+
+// src/version-check.ts
+var DISABLE_ENV = "NOTTE_SDK_DISABLE_VERSION_CHECK";
+var VERSION_CHECK_TIMEOUT_MS = 1500;
+var hasStartedVersionCheck = false;
+function startVersionCheck() {
+  if (hasStartedVersionCheck || !shouldCheckVersion()) {
+    return;
+  }
+  hasStartedVersionCheck = true;
+  const timer = setTimeout(() => {
+    void checkForLatestVersion().catch(() => void 0);
+  }, 0);
+  timer.unref?.();
+}
+async function checkForLatestVersion(options = {}) {
+  const currentVersion = options.currentVersion ?? SDK_VERSION;
+  const packageName = options.packageName ?? SDK_PACKAGE_NAME;
+  const fetchFn = options.fetchFn ?? globalThis.fetch;
+  const warnFn = options.warnFn ?? console.warn;
+  const env = options.env ?? getEnv();
+  if (!shouldCheckVersion(currentVersion, fetchFn, env)) {
+    return;
+  }
+  const latestVersion = await fetchLatestVersion(packageName, fetchFn);
+  if (!latestVersion || !isVersionGreater(latestVersion, currentVersion)) {
+    return;
+  }
+  warnFn(
+    `[${packageName}] A newer version is available: ${currentVersion} -> ${latestVersion}. Update with: npm install ${packageName}@latest`
+  );
+}
+function shouldCheckVersion(currentVersion = SDK_VERSION, fetchFn = globalThis.fetch, env = getEnv()) {
+  if (!fetchFn || !env || env[DISABLE_ENV] || env.NODE_ENV === "test" || env.VITEST || env.CI) {
+    return false;
+  }
+  return isPublishedVersion(currentVersion);
+}
+async function fetchLatestVersion(packageName, fetchFn) {
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+  const timeout = controller ? setTimeout(() => controller.abort(), VERSION_CHECK_TIMEOUT_MS) : void 0;
+  timeout?.unref?.();
+  try {
+    const response = await fetchFn(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, {
+      headers: {
+        accept: "application/json"
+      },
+      signal: controller?.signal
+    });
+    if (!response.ok) {
+      return void 0;
+    }
+    const payload = await response.json();
+    return typeof payload.version === "string" ? payload.version : void 0;
+  } catch {
+    return void 0;
+  } finally {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+  }
+}
+function isPublishedVersion(version) {
+  return /^\d+\.\d+\.\d+/.test(version) && !version.includes("dev");
+}
+function isVersionGreater(candidate, current) {
+  const candidateVersion = parseSemver(candidate);
+  const currentVersion = parseSemver(current);
+  if (!candidateVersion || !currentVersion) {
+    return false;
+  }
+  for (let index = 0; index < 3; index += 1) {
+    if (candidateVersion.parts[index] > currentVersion.parts[index]) {
+      return true;
+    }
+    if (candidateVersion.parts[index] < currentVersion.parts[index]) {
+      return false;
+    }
+  }
+  return currentVersion.prerelease.length > 0 && candidateVersion.prerelease.length === 0;
+}
+function parseSemver(version) {
+  const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-([^+]+))?/);
+  if (!match) {
+    return void 0;
+  }
+  return {
+    parts: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4] ?? ""
+  };
+}
+function getEnv() {
+  return typeof process !== "undefined" ? process.env : void 0;
+}
+
 // src/lib/client/core/bodySerializer.gen.ts
 var serializeFormDataPair = (data, key, value) => {
   if (typeof value === "string" || value instanceof Blob) {
@@ -1303,6 +1401,7 @@ var scrapeFromHtml = (options) => (options.client ?? client).post({
 });
 
 // src/utils.ts
+import { spawn } from "child_process";
 function formatError(error) {
   if (typeof error === "object" && error !== null) {
     if ("message" in error && typeof error.message === "string") {
@@ -1319,6 +1418,28 @@ function formatError(error) {
   }
   return String(error);
 }
+function openBrowser(url) {
+  const platform = process.platform;
+  let command;
+  let args;
+  if (platform === "darwin") {
+    command = "open";
+    args = [url];
+  } else if (platform === "win32") {
+    command = "rundll32";
+    args = ["url.dll,FileProtocolHandler", url];
+  } else {
+    command = "xdg-open";
+    args = [url];
+  }
+  const child = spawn(command, args, {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.on("error", () => {
+  });
+  child.unref();
+}
 
 // src/session.ts
 import { z } from "zod";
@@ -1363,7 +1484,9 @@ var Session = class {
     this.isActive = false;
     this.response = null;
     this.client = client2;
-    this.options = options;
+    const { open_viewer = false, ...sessionOptions } = options;
+    this.options = sessionOptions;
+    this.openViewer = open_viewer;
   }
   /**
    * Start the session - creates a new session on the server
@@ -1372,6 +1495,7 @@ var Session = class {
     if (this.isActive) {
       throw new Error("Session is already active");
     }
+    let shouldOpenViewer = false;
     try {
       const response = await sessionStart({
         client: this.client.getClient(),
@@ -1384,9 +1508,13 @@ var Session = class {
       this.sessionId = sessionData.session_id;
       this.isActive = true;
       this.response = sessionData;
+      shouldOpenViewer = this.openViewer;
     } catch (error) {
       throw new Error(`Failed to start session: ${error instanceof Error ? error.message : String(error)}`);
     }
+    if (shouldOpenViewer) {
+      this.openViewerInBrowser();
+    }
   }
   /**
    * Stop the session - terminates the session on the server
@@ -1444,6 +1572,27 @@ var Session = class {
   getResponse() {
     return this.response;
   }
+  /**
+   * Open the live viewer for this session in the local default browser.
+   */
+  viewer() {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const viewerUrl = this.response?.viewer_url;
+    if (!viewerUrl) {
+      throw new Error("No viewer URL available for this session");
+    }
+    openBrowser(viewerUrl);
+  }
+  openViewerInBrowser() {
+    const viewerUrl = this.response?.viewer_url;
+    if (!viewerUrl) {
+      console.warn("[Session] No viewer URL available; session started without opening a viewer.");
+      return;
+    }
+    openBrowser(viewerUrl);
+  }
   /**
    * Set cookies for the session
    */
@@ -2523,9 +2672,6 @@ var NottePersona = class {
   }
 };
 
-// src/version.ts
-var SDK_VERSION = true ? "0.0.6" : "dev";
-
 // src/functions.ts
 var NotteFunction = class {
   constructor(client2, options) {
@@ -2756,6 +2902,7 @@ var NotteProxyAuthError = class extends Error {
 };
 
 // src/index.ts
+startVersionCheck();
 var createClient2 = (config) => {
   if (config?.baseUrl) {
     client.setConfig({ baseUrl: config.baseUrl });