@wandelbots/nova-js 3.7.0-pr.267.2d2af4c → 3.7.0-pr.276.de5eb8e

package/README.md

@@ -5,7 +5,7 @@
 [![Release](https://github.com/wandelbotsgmbh/nova-js/actions/workflows/release.yml/badge.svg)](https://github.com/wandelbotsgmbh/nova-js/actions/workflows/release.yml)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/wandelbotsgmbh/nova-js)
 
-This library provides an idiomatic TypeScript client for working with the Wandelbots NOVA API.
+This library provides an idiomatic TypeScript client for working with the [Wandelbots NOVA](https://docs.wandelbots.io) robotics software platform API.
 
 ```bash
 npm install @wandelbots/nova-js
@@ -19,18 +19,12 @@ If you develop a React application we also provide a set of [React components](h
 - [API calls](#api-calls)
 - [API version support](#api-version-support)
 - [Opening websockets](#opening-websockets)
-- [Execute Wandelscript (V1)](#execute-wandelscript-v1)
 
 ## Basic usage
 
-The core of this package is the `NovaClient`, which represents a connection to a configured robot cell on a given Nova instance:
+The core of this package is the `NovaClient`, which represents a connection to a configured robot cell on a given NOVA instance:
 
 ```ts
-// Please make sure you import NovaClient from "@wandelbots/nova-js/v2"
-//
-// The NovaClient from "@wandelbots/nova-js" is still API v1,
-// but it will be removed in the future, use "@wandelbots/nova-js/v1" if
-// you need the API v1 client
 import { NovaClient } from "@wandelbots/nova-js/v2"
 
 const nova = new NovaClient({
@@ -54,31 +48,6 @@ const controllerIds = await nova.api.controller.listRobotControllers()
 
 Documentation for the various API endpoints is available on your Nova instance at `/api/v2/ui` or on [portal.wandelbots.io](https://portal.wandelbots.io/docs/api/v2/ui/)
 
-
-## API version support
-
-This library supports **Nova API v1** and **v2**. Please note that except for Wandelscript execution, usage of **API v1** is deprecated and not recommended.
-
-V1 usage:
-
-```ts
-// The NovaClient from "@wandelbots/nova-js" is still API v1,
-// but it will be removed in the future, use "@wandelbots/nova-js/v1" if
-// you need the API v1 client
-import { NovaClient } from "@wandelbots/nova-js/v1"
-
-const nova = new NovaClient({
-  instanceUrl: "https://example.instance.wandelbots.io",
-  cellId: "cell",
-  accessToken: "...",
-})
-
-// Deprecated API version is still callable
-const { instances } = await nova.api.controller.listControllers()
-```
-
-*Please note*: When using the v1 client, please make sure to add `"three"` to your package.json, since it will be moved to peer dependency in *v4.0* of this library.
-
 ## Opening websockets
 
 `NovaClient` has various convenience features for websocket handling in general. Use `openReconnectingWebsocket` to get a persistent socket for a given Nova streaming endpoint that will handle unexpected closes with exponential backoff:
@@ -91,7 +60,7 @@ this.programStateSocket.addEventListener("message", (ev) => {
 })
 ```
 
-Websockets on a given Nova client are deduplicated by path, so if you call `openReconnectingWebsocket` twice with the same path you'll get the same object. The exception is if you called `dispose`, which you may do to permanently clean up a reconnecting websocket and free its resources:
+Websockets on a given NOVA client are deduplicated by path, so if you call `openReconnectingWebsocket` twice with the same path you'll get the same object. The exception is if you called `dispose`, which you may do to permanently clean up a reconnecting websocket and free its resources:
 
 ```ts
 programStateSocket.dispose()
@@ -99,18 +68,6 @@ programStateSocket.dispose()
 
 The reconnecting websocket interface is fairly low-level and you won't get type safety on the messages. So when available, you'll likely want to use one of the following endpoint-specific abstractions instead which are built on top!
 
-## Execute Wandelscript (V1)
-
-The `ProgramStateConnection` provides an object which allows to execute and stop a given Wandelscript.
-
-```ts
-import script from "./example.ws"
-...
-programRunner.executeProgram(script)
-```
-
-You can `stop` the current execution or listen to state updates of your wandelscript code by observing the `programRunner.executionState`.
-
 ## Contributing
 
 If you would like to contribute a change to this repository, see [CONTRIBUTING.md](CONTRIBUTING.md).

package/dist/AutoReconnectingWebsocket-9Of5_BJe.d.cts

@@ -0,0 +1,68 @@
+import ReconnectingWebSocket from "reconnecting-websocket";
+import { AxiosResponse, InternalAxiosRequestConfig } from "axios";
+
+//#region src/lib/v1/mock/MockNovaInstance.d.ts
+/**
+ * Ultra-simplified mock Nova server for testing stuff
+ */
+declare class MockNovaInstance$1 {
+  readonly connections: AutoReconnectingWebsocket[];
+  handleAPIRequest(config: InternalAxiosRequestConfig): Promise<AxiosResponse>;
+  handleWebsocketConnection(socket: AutoReconnectingWebsocket): void;
+  handleWebsocketMessage(socket: AutoReconnectingWebsocket, message: string): void;
+}
+//#endregion
+//#region src/lib/v2/mock/MockNovaInstance.d.ts
+/**
+ * Ultra-simplified mock Nova server for testing stuff
+ */
+declare class MockNovaInstance {
+  readonly connections: AutoReconnectingWebsocket[];
+  handleAPIRequest(config: InternalAxiosRequestConfig): Promise<AxiosResponse>;
+  handleWebsocketConnection(socket: AutoReconnectingWebsocket): void;
+  handleWebsocketMessage(socket: AutoReconnectingWebsocket, message: string): void;
+}
+//#endregion
+//#region src/lib/AutoReconnectingWebsocket.d.ts
+declare class AutoReconnectingWebsocket extends ReconnectingWebSocket {
+  readonly opts: {
+    mock?: MockNovaInstance$1 | MockNovaInstance;
+    onDispose?: () => void;
+  };
+  receivedFirstMessage?: MessageEvent;
+  targetUrl: string;
+  disposed: boolean;
+  constructor(targetUrl: string, opts?: {
+    mock?: MockNovaInstance$1 | MockNovaInstance;
+    onDispose?: () => void;
+  });
+  changeUrl(targetUrl: string): void;
+  sendJson(data: unknown): void;
+  /**
+   * Permanently close this websocket and indicate that
+   * this object should not be used again.
+   **/
+  dispose(): void;
+  /**
+   * Returns a promise that resolves once the websocket
+   * is in the OPEN state. */
+  opened(): Promise<void>;
+  /**
+   * Returns a promise that resolves once the websocket
+   * is in the CLOSED state. */
+  closed(): Promise<void>;
+  /**
+   * Returns a promise that resolves when the first message
+   * is received from the websocket. Resolves immediately if
+   * the first message has already been received.
+   */
+  firstMessage(): Promise<MessageEvent<any>>;
+  /**
+   * Returns a promise that resolves when the next message
+   * is received from the websocket.
+   */
+  nextMessage(): Promise<MessageEvent<any>>;
+}
+//#endregion
+export { MockNovaInstance as n, MockNovaInstance$1 as r, AutoReconnectingWebsocket as t };
+//# sourceMappingURL=AutoReconnectingWebsocket-9Of5_BJe.d.cts.map

package/dist/AutoReconnectingWebsocket-9Of5_BJe.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoReconnectingWebsocket-9Of5_BJe.d.cts","names":[],"sources":["../src/lib/v1/mock/MockNovaInstance.ts","../src/lib/v2/mock/MockNovaInstance.ts","../src/lib/AutoReconnectingWebsocket.ts"],"mappings":";;;;;;AAeA;cAAa,kBAAA;EAAA,SACF,WAAA,EAAa,yBAAA;EAEhB,gBAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,aAAA;EAg8BX,yBAAA,CAA0B,MAAA,EAAQ,yBAAA;EAkOlC,sBAAA,CAAuB,MAAA,EAAQ,yBAAA,EAA2B,OAAA;AAAA;;;;;AAvqC5D;cCAa,gBAAA;EAAA,SACF,WAAA,EAAa,yBAAA;EAEhB,gBAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,aAAA;EAyCX,yBAAA,CAA0B,MAAA,EAAQ,yBAAA;EA+BlC,sBAAA,CAAuB,MAAA,EAAQ,yBAAA,EAA2B,OAAA;AAAA;;;cCxF/C,yBAAA,SAAkC,qBAAA;EAAA,SAOlC,IAAA;IACP,IAAA,GAAO,kBAAA,GAAsB,gBAAA;IAC7B,SAAA;EAAA;EARJ,oBAAA,GAAuB,YAAA;EACvB,SAAA;EACA,QAAA;cAGE,SAAA,UACS,IAAA;IACP,IAAA,GAAO,kBAAA,GAAsB,gBAAA;IAC7B,SAAA;EAAA;EA4CJ,SAAA,CAAU,SAAA;EAMV,QAAA,CAAS,IAAA;EF7CH;;;;EEyDN,OAAA,CAAA;EFy4BA;;;EE93BM,MAAA,CAAA,GAAM,OAAA;EFgmCmB;;;EEllCzB,MAAA,CAAA,GAAM,OAAA;EFklC6D;;;;ACvqC3E;ECqGQ,YAAA,CAAA,GAAY,OAAA,CAAA,YAAA;;;;;EA4BZ,WAAA,CAAA,GAAW,OAAA,CAAA,YAAA;AAAA"}

package/dist/LoginWithAuth0-oZFpwe7m.cjs

@@ -0,0 +1,409 @@
+//#region \0rolldown/runtime.js
+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 __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let reconnecting_websocket = require("reconnecting-websocket");
+reconnecting_websocket = __toESM(reconnecting_websocket, 1);
+//#region src/lib/AutoReconnectingWebsocket.ts
+var AutoReconnectingWebsocket = class extends reconnecting_websocket.default {
+	constructor(targetUrl, opts = {}) {
+		console.log("Opening websocket to", targetUrl);
+		super(() => this.targetUrl || targetUrl, void 0, { startClosed: true });
+		this.opts = opts;
+		this.disposed = false;
+		Object.defineProperty(this, "url", { get() {
+			return this.targetUrl;
+		} });
+		this.targetUrl = targetUrl;
+		this.addEventListener("open", () => {
+			console.log(`Websocket to ${this.url} opened`);
+		});
+		this.addEventListener("message", (ev) => {
+			if (!this.receivedFirstMessage) this.receivedFirstMessage = ev;
+		});
+		this.addEventListener("close", () => {
+			console.log(`Websocket to ${this.url} closed`);
+		});
+		const origReconnect = this.reconnect;
+		this.reconnect = () => {
+			if (this.opts.mock) this.opts.mock.handleWebsocketConnection(this);
+			else origReconnect.apply(this);
+		};
+		this.reconnect();
+	}
+	changeUrl(targetUrl) {
+		this.receivedFirstMessage = void 0;
+		this.targetUrl = targetUrl;
+		this.reconnect();
+	}
+	sendJson(data) {
+		if (this.opts.mock) this.opts.mock.handleWebsocketMessage(this, JSON.stringify(data));
+		else this.send(JSON.stringify(data));
+	}
+	/**
+	* Permanently close this websocket and indicate that
+	* this object should not be used again.
+	**/
+	dispose() {
+		this.close();
+		this.disposed = true;
+		if (this.opts.onDispose) this.opts.onDispose();
+	}
+	/**
+	* Returns a promise that resolves once the websocket
+	* is in the OPEN state. */
+	async opened() {
+		return new Promise((resolve, reject) => {
+			if (this.readyState === WebSocket.OPEN) resolve();
+			else {
+				this.addEventListener("open", () => resolve());
+				this.addEventListener("error", reject);
+			}
+		});
+	}
+	/**
+	* Returns a promise that resolves once the websocket
+	* is in the CLOSED state. */
+	async closed() {
+		return new Promise((resolve, reject) => {
+			if (this.readyState === WebSocket.CLOSED) resolve();
+			else {
+				this.addEventListener("close", () => resolve());
+				this.addEventListener("error", reject);
+			}
+		});
+	}
+	/**
+	* Returns a promise that resolves when the first message
+	* is received from the websocket. Resolves immediately if
+	* the first message has already been received.
+	*/
+	async firstMessage() {
+		if (this.receivedFirstMessage) return this.receivedFirstMessage;
+		return new Promise((resolve, reject) => {
+			const onMessage = (ev) => {
+				this.receivedFirstMessage = ev;
+				this.removeEventListener("message", onMessage);
+				this.removeEventListener("error", onError);
+				resolve(ev);
+			};
+			const onError = (ev) => {
+				this.removeEventListener("message", onMessage);
+				this.removeEventListener("error", onError);
+				reject(ev);
+			};
+			this.addEventListener("message", onMessage);
+			this.addEventListener("error", onError);
+		});
+	}
+	/**
+	* Returns a promise that resolves when the next message
+	* is received from the websocket.
+	*/
+	async nextMessage() {
+		return new Promise((resolve, reject) => {
+			const onMessage = (ev) => {
+				this.removeEventListener("message", onMessage);
+				this.removeEventListener("error", onError);
+				resolve(ev);
+			};
+			const onError = (ev) => {
+				this.removeEventListener("message", onMessage);
+				this.removeEventListener("error", onError);
+				reject(ev);
+			};
+			this.addEventListener("message", onMessage);
+			this.addEventListener("error", onError);
+		});
+	}
+};
+//#endregion
+//#region src/lib/availableStorage.ts
+/**
+* Safety wrapper around browser localStorage providing context availability
+* checks and JSON parsing
+*/
+var AvailableStorage = class {
+	constructor() {
+		this.available = typeof window !== "undefined" && !!window.localStorage;
+	}
+	getJSON(key) {
+		if (!this.available) return null;
+		const result = window.localStorage.getItem(key);
+		if (result === null) return null;
+		try {
+			return JSON.parse(result);
+		} catch (err) {
+			return null;
+		}
+	}
+	setJSON(key, obj) {
+		if (!this.available) return null;
+		window.localStorage.setItem(key, JSON.stringify(obj));
+	}
+	delete(key) {
+		if (!this.available) return null;
+		window.localStorage.removeItem(key);
+	}
+	setString(key, value) {
+		if (!this.available) return null;
+		window.localStorage.setItem(key, value);
+	}
+	getString(key) {
+		if (!this.available) return null;
+		return window.localStorage.getItem(key);
+	}
+};
+const availableStorage = new AvailableStorage();
+//#endregion
+//#region src/lib/converters.ts
+/**
+* Parse a string as a URL, with options to enforce or default the scheme.
+*/
+function parseUrl(url, options = {}) {
+	const { scheme, defaultScheme } = options;
+	const schemeRegex = /^[a-zA-Z]+:\/\//;
+	if (scheme) {
+		url = url.replace(schemeRegex, "");
+		url = `${scheme}://${url}`;
+	} else if (defaultScheme && !schemeRegex.test(url)) url = `${defaultScheme}://${url}`;
+	return new URL(url);
+}
+/**
+* Attempt to parse a string as a URL; return undefined if we can't
+*/
+function tryParseUrl(url, options = {}) {
+	try {
+		return parseUrl(url, options);
+	} catch {
+		return;
+	}
+}
+/**
+* Permissively parse a NOVA instance URL from a config variable.
+* If scheme is not specified, defaults to https for *.wandelbots.io hosts,
+* and http otherwise.
+* Throws an error if a valid URL could not be determined.
+*/
+function parseNovaInstanceUrl(url) {
+	if (tryParseUrl(url, { defaultScheme: "http" })?.host.endsWith(".wandelbots.io")) return parseUrl(url, { defaultScheme: "https" });
+	else return parseUrl(url, { defaultScheme: "http" });
+}
+/** Try to parse something as JSON; return undefined if we can't */
+function tryParseJson(json) {
+	try {
+		return JSON.parse(json);
+	} catch {
+		return;
+	}
+}
+/** Try to turn something into JSON; return undefined if we can't */
+function tryStringifyJson(json) {
+	try {
+		return JSON.stringify(json);
+	} catch {
+		return;
+	}
+}
+/**
+* Converts object parameters to query string.
+* e.g. { a: "1", b: "2" } => "?a=1&b=2"
+*      {} => ""
+*/
+function makeUrlQueryString(obj) {
+	const str = new URLSearchParams(obj).toString();
+	return str ? `?${str}` : "";
+}
+/** Convert radians to degrees */
+function radiansToDegrees(radians) {
+	return radians * (180 / Math.PI);
+}
+/** Convert degrees to radians */
+function degreesToRadians(degrees) {
+	return degrees * (Math.PI / 180);
+}
+/**
+* Check for coordinate system id equivalence, accounting for the "world" default
+* on empty/undefined values.
+*/
+function isSameCoordinateSystem(firstCoordSystem, secondCoordSystem) {
+	if (!firstCoordSystem) firstCoordSystem = "world";
+	if (!secondCoordSystem) secondCoordSystem = "world";
+	return firstCoordSystem === secondCoordSystem;
+}
+/**
+* Helpful const for converting {x, y, z} to [x, y, z] and vice versa
+*/
+const XYZ_TO_VECTOR = {
+	x: 0,
+	y: 1,
+	z: 2
+};
+//#endregion
+//#region src/LoginWithAuth0.ts
+/**
+* Mapping of stages to Auth0 configurations.
+* The client ids are public identifiers for a specific auth0 application
+* and are safe to include in client-side code.
+* https://auth0.com/docs/get-started/applications/application-settings
+*/
+const auth0ConfigMap = {
+	dev: {
+		domain: `https://auth.portal.dev.wandelbots.io`,
+		clientId: "fLbJD0RLp5r2Dpucm5j8BjwMR6Hunfha"
+	},
+	stg: {
+		domain: `https://auth.portal.stg.wandelbots.io`,
+		clientId: "joVDeD9e786WzFNSGCqoVq7HNkWt5j6s"
+	},
+	prod: {
+		domain: `https://auth.portal.wandelbots.io`,
+		clientId: "J7WJUi38xVQdJAEBNRT9Xw1b0fXDb4J2"
+	}
+};
+/** Determine which Auth0 configuration to use based on instance URL */
+const getAuth0Config = (instanceUrl) => {
+	if (instanceUrl.host.endsWith(".dev.wandelbots.io")) return auth0ConfigMap.dev;
+	if (instanceUrl.host.endsWith(".stg.wandelbots.io")) return auth0ConfigMap.stg;
+	if (instanceUrl.host.endsWith(".wandelbots.io")) return auth0ConfigMap.prod;
+	throw new Error(`Unable to authenticate with NOVA instance "${instanceUrl}". Auth0 login is only supported for cloud instances with hosts of the form "**.wandelbots.io".`);
+};
+/**
+* Initializes Auth0 login process using redirect if necessary and retrieves an access token.
+* Returns null when an access token should not be needed to authenticate (i.e. cookie auth
+* when deployed on the instance domain)
+*/
+const loginWithAuth0 = async (instanceUrl) => {
+	if (typeof window === "undefined") throw new Error(`Access token must be set to use NovaClient when not in a browser environment.`);
+	if (instanceUrl.origin === window.location.origin) {
+		window.location.reload();
+		throw new Error("Failed to reload page to get auth details, please refresh manually");
+	}
+	const { Auth0Client } = await import("@auth0/auth0-spa-js");
+	const auth0Config = getAuth0Config(instanceUrl);
+	const auth0Client = new Auth0Client({
+		domain: auth0Config.domain,
+		clientId: auth0Config.clientId ?? "",
+		useRefreshTokens: false,
+		authorizationParams: {
+			audience: "nova-api",
+			redirect_uri: window.location.origin
+		}
+	});
+	if (window.location.search.includes("code=") && window.location.search.includes("state=")) {
+		const { appState } = await auth0Client.handleRedirectCallback();
+		window.history.replaceState({}, document.title, appState?.returnTo || window.location.pathname);
+	} else await auth0Client.loginWithRedirect();
+	return await auth0Client.getTokenSilently();
+};
+//#endregion
+Object.defineProperty(exports, "AutoReconnectingWebsocket", {
+	enumerable: true,
+	get: function() {
+		return AutoReconnectingWebsocket;
+	}
+});
+Object.defineProperty(exports, "XYZ_TO_VECTOR", {
+	enumerable: true,
+	get: function() {
+		return XYZ_TO_VECTOR;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "availableStorage", {
+	enumerable: true,
+	get: function() {
+		return availableStorage;
+	}
+});
+Object.defineProperty(exports, "degreesToRadians", {
+	enumerable: true,
+	get: function() {
+		return degreesToRadians;
+	}
+});
+Object.defineProperty(exports, "getAuth0Config", {
+	enumerable: true,
+	get: function() {
+		return getAuth0Config;
+	}
+});
+Object.defineProperty(exports, "isSameCoordinateSystem", {
+	enumerable: true,
+	get: function() {
+		return isSameCoordinateSystem;
+	}
+});
+Object.defineProperty(exports, "loginWithAuth0", {
+	enumerable: true,
+	get: function() {
+		return loginWithAuth0;
+	}
+});
+Object.defineProperty(exports, "makeUrlQueryString", {
+	enumerable: true,
+	get: function() {
+		return makeUrlQueryString;
+	}
+});
+Object.defineProperty(exports, "parseNovaInstanceUrl", {
+	enumerable: true,
+	get: function() {
+		return parseNovaInstanceUrl;
+	}
+});
+Object.defineProperty(exports, "parseUrl", {
+	enumerable: true,
+	get: function() {
+		return parseUrl;
+	}
+});
+Object.defineProperty(exports, "radiansToDegrees", {
+	enumerable: true,
+	get: function() {
+		return radiansToDegrees;
+	}
+});
+Object.defineProperty(exports, "tryParseJson", {
+	enumerable: true,
+	get: function() {
+		return tryParseJson;
+	}
+});
+Object.defineProperty(exports, "tryParseUrl", {
+	enumerable: true,
+	get: function() {
+		return tryParseUrl;
+	}
+});
+Object.defineProperty(exports, "tryStringifyJson", {
+	enumerable: true,
+	get: function() {
+		return tryStringifyJson;
+	}
+});
+
+//# sourceMappingURL=LoginWithAuth0-oZFpwe7m.cjs.map

package/dist/LoginWithAuth0-oZFpwe7m.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoginWithAuth0-oZFpwe7m.cjs","names":["ReconnectingWebSocket"],"sources":["../src/lib/AutoReconnectingWebsocket.ts","../src/lib/availableStorage.ts","../src/lib/converters.ts","../src/LoginWithAuth0.ts"],"sourcesContent":["import ReconnectingWebSocket, { type ErrorEvent } from \"reconnecting-websocket\"\nimport type * as v1 from \"./v1/mock/MockNovaInstance\"\nimport type * as v2 from \"./v2/mock/MockNovaInstance\"\n\nexport class AutoReconnectingWebsocket extends ReconnectingWebSocket {\n  receivedFirstMessage?: MessageEvent\n  targetUrl: string\n  disposed = false\n\n  constructor(\n    targetUrl: string,\n    readonly opts: {\n      mock?: v1.MockNovaInstance | v2.MockNovaInstance\n      onDispose?: () => void\n    } = {},\n  ) {\n    console.log(\"Opening websocket to\", targetUrl)\n\n    super(() => this.targetUrl || targetUrl, undefined, {\n      startClosed: true,\n    })\n\n    // Reconnecting websocket doesn't set this properly with startClosed\n    Object.defineProperty(this, \"url\", {\n      get() {\n        return this.targetUrl\n      },\n    })\n\n    this.targetUrl = targetUrl\n\n    this.addEventListener(\"open\", () => {\n      console.log(`Websocket to ${this.url} opened`)\n    })\n\n    this.addEventListener(\"message\", (ev) => {\n      if (!this.receivedFirstMessage) {\n        this.receivedFirstMessage = ev\n      }\n    })\n\n    this.addEventListener(\"close\", () => {\n      console.log(`Websocket to ${this.url} closed`)\n    })\n\n    const origReconnect = this.reconnect\n    this.reconnect = () => {\n      if (this.opts.mock) {\n        this.opts.mock.handleWebsocketConnection(this)\n      } else {\n        origReconnect.apply(this)\n      }\n    }\n\n    this.reconnect()\n  }\n\n  changeUrl(targetUrl: string) {\n    this.receivedFirstMessage = undefined\n    this.targetUrl = targetUrl\n    this.reconnect()\n  }\n\n  sendJson(data: unknown) {\n    if (this.opts.mock) {\n      this.opts.mock.handleWebsocketMessage(this, JSON.stringify(data))\n    } else {\n      this.send(JSON.stringify(data))\n    }\n  }\n\n  /**\n   * Permanently close this websocket and indicate that\n   * this object should not be used again.\n   **/\n  dispose() {\n    this.close()\n    this.disposed = true\n    if (this.opts.onDispose) {\n      this.opts.onDispose()\n    }\n  }\n\n  /**\n   * Returns a promise that resolves once the websocket\n   * is in the OPEN state. */\n  async opened() {\n    return new Promise<void>((resolve, reject) => {\n      if (this.readyState === WebSocket.OPEN) {\n        resolve()\n      } else {\n        this.addEventListener(\"open\", () => resolve())\n        this.addEventListener(\"error\", reject)\n      }\n    })\n  }\n\n  /**\n   * Returns a promise that resolves once the websocket\n   * is in the CLOSED state. */\n  async closed() {\n    return new Promise<void>((resolve, reject) => {\n      if (this.readyState === WebSocket.CLOSED) {\n        resolve()\n      } else {\n        this.addEventListener(\"close\", () => resolve())\n        this.addEventListener(\"error\", reject)\n      }\n    })\n  }\n\n  /**\n   * Returns a promise that resolves when the first message\n   * is received from the websocket. Resolves immediately if\n   * the first message has already been received.\n   */\n  async firstMessage() {\n    if (this.receivedFirstMessage) {\n      return this.receivedFirstMessage\n    }\n\n    return new Promise<MessageEvent>((resolve, reject) => {\n      const onMessage = (ev: MessageEvent) => {\n        this.receivedFirstMessage = ev\n        this.removeEventListener(\"message\", onMessage)\n        this.removeEventListener(\"error\", onError)\n        resolve(ev)\n      }\n\n      const onError = (ev: ErrorEvent) => {\n        this.removeEventListener(\"message\", onMessage)\n        this.removeEventListener(\"error\", onError)\n        reject(ev)\n      }\n\n      this.addEventListener(\"message\", onMessage)\n      this.addEventListener(\"error\", onError)\n    })\n  }\n\n  /**\n   * Returns a promise that resolves when the next message\n   * is received from the websocket.\n   */\n  async nextMessage() {\n    return new Promise<MessageEvent>((resolve, reject) => {\n      const onMessage = (ev: MessageEvent) => {\n        this.removeEventListener(\"message\", onMessage)\n        this.removeEventListener(\"error\", onError)\n        resolve(ev)\n      }\n\n      const onError = (ev: ErrorEvent) => {\n        this.removeEventListener(\"message\", onMessage)\n        this.removeEventListener(\"error\", onError)\n        reject(ev)\n      }\n\n      this.addEventListener(\"message\", onMessage)\n      this.addEventListener(\"error\", onError)\n    })\n  }\n}\n","/**\n * Safety wrapper around browser localStorage providing context availability\n * checks and JSON parsing\n */\nclass AvailableStorage {\n  available = typeof window !== \"undefined\" && !!window.localStorage\n\n  getJSON<T>(key: string): Partial<T> | null {\n    if (!this.available) return null\n\n    const result = window.localStorage.getItem(key)\n    if (result === null) return null\n\n    try {\n      return JSON.parse(result)\n    } catch (err) {\n      return null\n    }\n  }\n\n  setJSON(key: string, obj: unknown) {\n    if (!this.available) return null\n\n    window.localStorage.setItem(key, JSON.stringify(obj))\n  }\n\n  delete(key: string) {\n    if (!this.available) return null\n\n    window.localStorage.removeItem(key)\n  }\n\n  setString(key: string, value: string) {\n    if (!this.available) return null\n\n    window.localStorage.setItem(key, value)\n  }\n\n  getString(key: string): string | null {\n    if (!this.available) return null\n\n    return window.localStorage.getItem(key)\n  }\n}\n\nexport const availableStorage = new AvailableStorage()\n","export type URLParseOptions = {\n  /**\n   * Ignore any scheme in the input string and force this scheme instead.\n   */\n  scheme?: \"http\" | \"https\"\n  /**\n   * If the input string does not include a scheme, use this as the default\n   * scheme.\n   */\n  defaultScheme?: \"http\" | \"https\"\n}\n\n/**\n * Parse a string as a URL, with options to enforce or default the scheme.\n */\nexport function parseUrl(url: string, options: URLParseOptions = {}): URL {\n  const { scheme, defaultScheme } = options\n\n  const schemeRegex = /^[a-zA-Z]+:\\/\\//\n\n  if (scheme) {\n    // Force the scheme by removing any existing scheme and prepending the desired one\n    url = url.replace(schemeRegex, \"\")\n    url = `${scheme}://${url}`\n  } else if (defaultScheme && !schemeRegex.test(url)) {\n    // No scheme is present, add the default one\n    url = `${defaultScheme}://${url}`\n  }\n\n  return new URL(url)\n}\n\n/**\n * Attempt to parse a string as a URL; return undefined if we can't\n */\nexport function tryParseUrl(\n  url: string,\n  options: URLParseOptions = {},\n): URL | undefined {\n  try {\n    return parseUrl(url, options)\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Permissively parse a NOVA instance URL from a config variable.\n * If scheme is not specified, defaults to https for *.wandelbots.io hosts,\n * and http otherwise.\n * Throws an error if a valid URL could not be determined.\n */\nexport function parseNovaInstanceUrl(url: string): URL {\n  const testUrl = tryParseUrl(url, { defaultScheme: \"http\" })\n  if (testUrl?.host.endsWith(\".wandelbots.io\")) {\n    return parseUrl(url, { defaultScheme: \"https\" })\n  } else {\n    return parseUrl(url, { defaultScheme: \"http\" })\n  }\n}\n\n/** Try to parse something as JSON; return undefined if we can't */\n// biome-ignore lint/suspicious/noExplicitAny: it's json\nexport function tryParseJson(json: unknown): any {\n  try {\n    return JSON.parse(json as string)\n  } catch {\n    return undefined\n  }\n}\n\n/** Try to turn something into JSON; return undefined if we can't */\nexport function tryStringifyJson(json: unknown): string | undefined {\n  try {\n    return JSON.stringify(json)\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Converts object parameters to query string.\n * e.g. { a: \"1\", b: \"2\" } => \"?a=1&b=2\"\n *      {} => \"\"\n */\nexport function makeUrlQueryString(obj: Record<string, string>): string {\n  const str = new URLSearchParams(obj).toString()\n  return str ? `?${str}` : \"\"\n}\n\n/** Convert radians to degrees */\nexport function radiansToDegrees(radians: number): number {\n  return radians * (180 / Math.PI)\n}\n\n/** Convert degrees to radians */\nexport function degreesToRadians(degrees: number): number {\n  return degrees * (Math.PI / 180)\n}\n\n/**\n * Check for coordinate system id equivalence, accounting for the \"world\" default\n * on empty/undefined values.\n */\nexport function isSameCoordinateSystem(\n  firstCoordSystem: string | undefined,\n  secondCoordSystem: string | undefined,\n) {\n  if (!firstCoordSystem) firstCoordSystem = \"world\"\n  if (!secondCoordSystem) secondCoordSystem = \"world\"\n\n  return firstCoordSystem === secondCoordSystem\n}\n\n/**\n * Helpful const for converting {x, y, z} to [x, y, z] and vice versa\n */\nexport const XYZ_TO_VECTOR = { x: 0, y: 1, z: 2 }\n","/**\n * Mapping of stages to Auth0 configurations.\n * The client ids are public identifiers for a specific auth0 application\n * and are safe to include in client-side code.\n * https://auth0.com/docs/get-started/applications/application-settings\n */\nconst auth0ConfigMap = {\n  dev: {\n    domain: `https://auth.portal.dev.wandelbots.io`,\n    clientId: \"fLbJD0RLp5r2Dpucm5j8BjwMR6Hunfha\",\n  },\n  stg: {\n    domain: `https://auth.portal.stg.wandelbots.io`,\n    clientId: \"joVDeD9e786WzFNSGCqoVq7HNkWt5j6s\",\n  },\n  prod: {\n    domain: `https://auth.portal.wandelbots.io`,\n    clientId: \"J7WJUi38xVQdJAEBNRT9Xw1b0fXDb4J2\",\n  },\n}\n\n/** Determine which Auth0 configuration to use based on instance URL */\nexport const getAuth0Config = (instanceUrl: URL) => {\n  if (instanceUrl.host.endsWith(\".dev.wandelbots.io\")) return auth0ConfigMap.dev\n  if (instanceUrl.host.endsWith(\".stg.wandelbots.io\")) return auth0ConfigMap.stg\n  if (instanceUrl.host.endsWith(\".wandelbots.io\")) return auth0ConfigMap.prod\n  throw new Error(\n    `Unable to authenticate with NOVA instance \"${instanceUrl}\". Auth0 login is only supported for cloud instances with hosts of the form \"**.wandelbots.io\".`,\n  )\n}\n\n/**\n * Initializes Auth0 login process using redirect if necessary and retrieves an access token.\n * Returns null when an access token should not be needed to authenticate (i.e. cookie auth\n * when deployed on the instance domain)\n */\nexport const loginWithAuth0 = async (\n  instanceUrl: URL,\n): Promise<string | null> => {\n  if (typeof window === \"undefined\") {\n    throw new Error(\n      `Access token must be set to use NovaClient when not in a browser environment.`,\n    )\n  }\n\n  if (instanceUrl.origin === window.location.origin) {\n    // When deployed on the instance itself, our auth is handled by cookies\n    // and no access token is needed-- just need to reload the page and it'll\n    // login again / set cookie as needed\n    window.location.reload()\n    throw new Error(\n      \"Failed to reload page to get auth details, please refresh manually\",\n    )\n  }\n\n  // If we're on localhost or another domain, we need to do the full oauth flow\n  // Note this will ONLY work for origins which are whitelisted as a redirect_uri\n  // in the auth0 config, currently\n  const { Auth0Client } = await import(\"@auth0/auth0-spa-js\")\n\n  const auth0Config = getAuth0Config(instanceUrl)\n\n  const auth0Client = new Auth0Client({\n    domain: auth0Config.domain,\n    clientId: auth0Config.clientId ?? \"\",\n    useRefreshTokens: false,\n    authorizationParams: {\n      audience: \"nova-api\",\n      redirect_uri: window.location.origin,\n    },\n  })\n\n  // If the URL includes a redirect result, handle it\n  if (\n    window.location.search.includes(\"code=\") &&\n    window.location.search.includes(\"state=\")\n  ) {\n    const { appState } = await auth0Client.handleRedirectCallback()\n    // Return to the URL the user was originally on before the redirect\n    window.history.replaceState(\n      {},\n      document.title,\n      appState?.returnTo || window.location.pathname,\n    )\n  } else {\n    // Initiate login with redirect\n    await auth0Client.loginWithRedirect()\n  }\n\n  // Once logged in, retrieve the access token silently\n  const accessToken = await auth0Client.getTokenSilently()\n  return accessToken\n}\n"],"mappings":"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"}