@wandelbots/nova-js/dist/lib/v2/index.cjs.map

Official JS client for the Wandelbots API

{"version":3,"sources":["../../../src/lib/v2/index.ts","../../../src/lib/v2/ConnectedMotionGroup.ts","../../../src/lib/converters.ts","../../../src/lib/v2/motionStateUpdate.ts","../../../src/lib/v2/vectorUtils.ts","../../../src/lib/v2/JoggerConnection.ts","../../../src/lib/v2/MotionStreamConnection.ts","../../../src/lib/v2/NovaCellAPIClient.ts","../../../src/lib/v2/NovaClient.ts","../../../src/LoginWithAuth0.ts","../../../src/lib/AutoReconnectingWebsocket.ts","../../../src/lib/availableStorage.ts","../../../src/lib/v2/mock/MockNovaInstance.ts","../../../src/lib/v2/ProgramStateConnection.ts"],"sourcesContent":["export * from \"@wandelbots/nova-api/v2\"\nexport * from \"./ConnectedMotionGroup\"\nexport * from \"./JoggerConnection\"\nexport * from \"./MotionStreamConnection\"\nexport * from \"./NovaCellAPIClient\"\nexport * from \"./NovaClient\"\nexport * from \"./ProgramStateConnection\"\n","import type {\n  Controller,\n  MotionGroupPhysical,\n  MotionGroupSpecification,\n  MotionGroupState,\n  RobotTcp,\n  SafetySetup,\n} from \"@wandelbots/nova-api/v2\"\nimport { AxiosError } from \"axios\"\nimport { makeAutoObservable, runInAction } from \"mobx\"\nimport type { AutoReconnectingWebsocket } from \"../AutoReconnectingWebsocket\"\nimport { tryParseJson } from \"../converters\"\nimport { jointValuesEqual, tcpPoseEqual } from \"./motionStateUpdate\"\nimport type { NovaClient } from \"./NovaClient\"\n\nconst MOTION_DELTA_THRESHOLD = 0.0001\n\nexport type MotionGroupOption = {\n  selectionId: string\n} & MotionGroupPhysical\n\n/**\n * Store representing the current state of a connected motion group.\n */\nexport class ConnectedMotionGroup {\n  static async connect(\n    nova: NovaClient,\n    motionGroupId: string,\n    controllers: Controller[],\n  ) {\n    const [_motionGroupIndex, controllerId] = motionGroupId.split(\"@\") as [\n      string,\n      string,\n    ]\n    const controller = controllers.find((c) => c.controller === controllerId)\n    const motionGroup = controller?.motion_groups.find(\n      (mg) => mg.motion_group === motionGroupId,\n    )\n    if (!controller || !motionGroup) {\n      throw new Error(\n        `Controller ${controllerId} or motion group ${motionGroupId} not found`,\n      )\n    }\n\n    const motionStateSocket = nova.openReconnectingWebsocket(\n      `/motion-groups/${motionGroupId}/state-stream`,\n    )\n\n    // Wait for the first message to get the initial state\n    const firstMessage = await motionStateSocket.firstMessage()\n    const initialMotionState = tryParseJson(firstMessage.data)\n      ?.result as MotionGroupState\n\n    if (!initialMotionState) {\n      throw new Error(\n        `Unable to parse initial motion state message ${firstMessage.data}`,\n      )\n    }\n\n    console.log(\n      `Connected motion state websocket to motion group ${motionGroup.motion_group}. Initial state:\\n  `,\n      initialMotionState,\n    )\n\n    // This is used to determine if the robot is virtual or physical\n    let isVirtual = false\n    try {\n      const opMode =\n        await nova.api.virtualRobotMode.getOperationMode(controllerId)\n\n      if (opMode) isVirtual = true\n    } catch (err) {\n      if (err instanceof AxiosError) {\n        console.log(\n          `Received ${err.status} from getOperationMode, concluding that ${controllerId} is physical`,\n        )\n      } else {\n        throw err\n      }\n    }\n\n    // Find out what TCPs this motion group has (we need it for jogging)\n    const { tcps } = await nova.api.motionGroupInfos.listTcps(motionGroupId)\n\n    const motionGroupSpecification =\n      await nova.api.motionGroupInfos.getMotionGroupSpecification(motionGroupId)\n\n    const safetySetup =\n      await nova.api.motionGroupInfos.getSafetySetup(motionGroupId)\n\n    return new ConnectedMotionGroup(\n      nova,\n      controller,\n      motionGroup,\n      initialMotionState,\n      motionStateSocket,\n      isVirtual,\n      tcps!,\n      motionGroupSpecification,\n      safetySetup,\n    )\n  }\n\n  connectedJoggingCartesianSocket: WebSocket | null = null\n  connectedJoggingJointsSocket: WebSocket | null = null\n  planData: any | null // tmp\n  joggingVelocity: number = 10\n\n  // Not mobx-observable as this changes very fast; should be observed\n  // using animation frames\n  rapidlyChangingMotionState: MotionGroupState\n\n  constructor(\n    readonly nova: NovaClient,\n    readonly controller: Controller,\n    readonly motionGroup: MotionGroupPhysical,\n    readonly initialMotionState: MotionGroupState,\n    readonly motionStateSocket: AutoReconnectingWebsocket,\n    readonly isVirtual: boolean,\n    readonly tcps: RobotTcp[],\n    readonly motionGroupSpecification: MotionGroupSpecification,\n    readonly safetySetup: SafetySetup,\n  ) {\n    this.rapidlyChangingMotionState = initialMotionState\n\n    motionStateSocket.addEventListener(\"message\", (event) => {\n      const motionStateResponse = tryParseJson(event.data)?.result as\n        | MotionGroupState\n        | undefined\n\n      if (!motionStateResponse) {\n        throw new Error(\n          `Failed to get motion state for ${this.motionGroupId}: ${event.data}`,\n        )\n      }\n\n      // handle motionState message\n      if (\n        !jointValuesEqual(\n          this.rapidlyChangingMotionState.joint_position.joints,\n          motionStateResponse.joint_position.joints,\n          MOTION_DELTA_THRESHOLD,\n        )\n      ) {\n        runInAction(() => {\n          this.rapidlyChangingMotionState = motionStateResponse\n        })\n      }\n\n      // handle tcpPose message\n      if (\n        !tcpPoseEqual(\n          this.rapidlyChangingMotionState.tcp_pose,\n          motionStateResponse.tcp_pose,\n          MOTION_DELTA_THRESHOLD,\n        )\n      ) {\n        runInAction(() => {\n          this.rapidlyChangingMotionState.tcp_pose =\n            motionStateResponse.tcp_pose\n        })\n      }\n    })\n    makeAutoObservable(this)\n  }\n\n  get motionGroupId() {\n    return this.motionGroup.motion_group\n  }\n\n  get controllerId() {\n    return this.controller.controller\n  }\n\n  get modelFromController() {\n    return this.motionGroup.model_from_controller\n  }\n\n  get wandelscriptIdentifier() {\n    const num = this.motionGroupId.split(\"@\")[0]\n    return `${this.controllerId.replaceAll(\"-\", \"_\")}_${num}`\n  }\n\n  /** Jogging velocity in radians for rotation and joint movement */\n  get joggingVelocityRads() {\n    return (this.joggingVelocity * Math.PI) / 180\n  }\n\n  get joints() {\n    return this.initialMotionState.joint_position.joints.map((_, i) => {\n      return {\n        index: i,\n      }\n    })\n  }\n\n  get dhParameters() {\n    return this.motionGroupSpecification.dh_parameters\n  }\n\n  get safetyZones() {\n    return this.safetySetup.safety_zones\n  }\n\n  dispose() {\n    this.motionStateSocket.close()\n    if (this.connectedJoggingCartesianSocket)\n      this.connectedJoggingCartesianSocket.close()\n    if (this.connectedJoggingJointsSocket)\n      this.connectedJoggingJointsSocket.close()\n  }\n\n  setJoggingVelocity(velocity: number) {\n    this.joggingVelocity = velocity\n  }\n}\n","import type { Pose } from \"@wandelbots/nova-api/v1\"\n\n/** Try to parse something as JSON; return undefined if we can't */\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 * Convert a Pose object representing a motion group position\n * into a string which represents that pose in Wandelscript.\n */\nexport function poseToWandelscriptString(\n  pose: Pick<Pose, \"position\" | \"orientation\">,\n) {\n  const position = [pose.position.x, pose.position.y, pose.position.z]\n  const orientation = [\n    pose.orientation?.x ?? 0,\n    pose.orientation?.y ?? 0,\n    pose.orientation?.z ?? 0,\n  ]\n\n  const positionValues = position.map((v) => v.toFixed(1))\n  // Rotation needs more precision since it's in radians\n  const rotationValues = orientation.map((v) => v.toFixed(4))\n\n  return `(${positionValues.concat(rotationValues).join(\", \")})`\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","import type { TcpPose } from \"@wandelbots/nova-api/v2\"\n\nexport function jointValuesEqual(\n  oldJointValues: number[],\n  newJointValues: number[],\n  changeDeltaThreshold: number,\n): boolean {\n  if (newJointValues.length !== oldJointValues.length) {\n    return true\n  }\n\n  for (let jointIndex = 0; jointIndex < newJointValues.length; jointIndex++) {\n    if (\n      Math.abs(newJointValues[jointIndex]! - oldJointValues[jointIndex]!) >\n      changeDeltaThreshold\n    ) {\n      return false\n    }\n  }\n\n  return true\n}\n\nexport function tcpPoseEqual(\n  oldTcp: TcpPose | undefined,\n  newTcp: TcpPose | undefined,\n  changeDeltaThreshold: number,\n): boolean {\n  // undefined -> defined (+reverse) transition\n  if ((oldTcp === undefined && newTcp) || (oldTcp && newTcp === undefined)) {\n    return false\n  }\n\n  // the typechecker cannot resolve states to \"!= undefined\" if \"&&\" is used\n  if (oldTcp === undefined || newTcp === undefined) {\n    return true\n  }\n\n  let changedDelta = 0\n  changedDelta += Math.abs(oldTcp.orientation[0] - newTcp.orientation[0])\n  changedDelta += Math.abs(oldTcp.orientation[1] - newTcp.orientation[1])\n  changedDelta += Math.abs(oldTcp.orientation[2] - newTcp.orientation[2])\n  changedDelta += Math.abs(oldTcp.position[0] - newTcp.position[0])\n  changedDelta += Math.abs(oldTcp.position[1] - newTcp.position[1])\n  changedDelta += Math.abs(oldTcp.position[2] - newTcp.position[2])\n\n  if (changedDelta > changeDeltaThreshold) {\n    return false\n  }\n\n  return (\n    oldTcp.coordinate_system === newTcp.coordinate_system &&\n    oldTcp.tcp === newTcp.tcp\n  )\n}\n","import * as THREE from \"three\"\n\n// Vector used by api endpoints\nexport type Vector3d = [number, number, number]\n\nexport function axisToIndex(axis: \"x\" | \"y\" | \"z\"): number {\n  switch (axis) {\n    case \"x\":\n      return 0\n    case \"y\":\n      return 1\n    case \"z\":\n      return 2\n  }\n}\n\nexport function indexToAxis(index: number): \"x\" | \"y\" | \"z\" | null {\n  switch (index) {\n    case 0:\n      return \"x\"\n    case 1:\n      return \"y\"\n    case 2:\n      return \"z\"\n    default:\n      return null\n  }\n}\n\nexport function vector3FromArray(vector: Vector3d): THREE.Vector3 {\n  return new THREE.Vector3(vector[0], vector[1], vector[2])\n}\n\nexport function vector3ToArray(vector: THREE.Vector3): Vector3d {\n  return [vector.x, vector.y, vector.z]\n}\n","import type {\n  InitializeJoggingRequest,\n  JoggingResponse,\n  JointVelocityRequest,\n  MotionGroupState,\n  TcpVelocityRequest,\n} from \"@wandelbots/nova-api/v2\"\nimport type { AutoReconnectingWebsocket } from \"../AutoReconnectingWebsocket\"\nimport { tryParseJson } from \"../converters\"\nimport type { NovaClient } from \"./NovaClient\"\nimport { axisToIndex } from \"./vectorUtils\"\n\nexport type JoggerConnectionOpts = {\n  /**\n   * When an error message is received from the jogging websocket, it\n   * will be passed here. If this handler is not provided, the error will\n   * instead be thrown as an unhandled error.\n   */\n  onError?: (err: unknown) => void\n} & Omit<InitializeJoggingRequest, \"message_type\">\n\nexport class JoggerConnection {\n  // Currently a separate websocket is needed for each mode, pester API people\n  // to merge these for simplicity\n  joggingWebsocket: AutoReconnectingWebsocket | null = null\n  lastVelocityRequest: JointVelocityRequest | TcpVelocityRequest | null = null\n  lastResponse: JoggingResponse | null = null\n\n  static async open(\n    nova: NovaClient,\n    cell: string,\n    motionGroupId: string,\n    opts: JoggerConnectionOpts,\n  ) {\n    const motionGroupState =\n      await nova.api.motionGroupInfos.getCurrentMotionGroupState(motionGroupId)\n\n    return new JoggerConnection(\n      nova,\n      cell,\n      motionGroupId,\n      motionGroupState,\n      opts,\n    )\n  }\n\n  constructor(\n    readonly nova: NovaClient,\n    readonly cell: string,\n    readonly motionGroupId: string,\n    readonly motionGroupState: MotionGroupState,\n    readonly opts: JoggerConnectionOpts,\n  ) {\n    this.joggingWebsocket = nova.openReconnectingWebsocket(\n      `/cells/${cell}/execution/jogging`,\n    )\n    this.joggingWebsocket.addEventListener(\"message\", (ev: MessageEvent) => {\n      const data = tryParseJson(ev.data) as JoggingResponse\n      if (data && \"error\" in data) {\n        if (this.opts.onError) {\n          this.opts.onError(ev.data)\n        } else {\n          throw new Error(ev.data)\n        }\n      }\n    })\n\n    this.joggingWebsocket.addEventListener(\"message\", (ev: MessageEvent) => {\n      const data = tryParseJson(ev.data)\n      if (data && \"error\" in data) {\n        if (this.opts.onError) {\n          this.opts.onError(ev.data)\n        } else {\n          throw new Error(ev.data)\n        }\n      }\n    })\n  }\n\n  get jointCount() {\n    return this.motionGroupState.joint_current?.joints.length\n  }\n\n  get activeWebsocket() {\n    return this.joggingWebsocket\n  }\n\n  async stop() {\n    // Why not call the stopJogging API endpoint?\n    // Because this results in the websocket closing and we\n    // would like to keep it open for now.\n    if (!this.joggingWebsocket) {\n      return\n    }\n\n    if (this.lastVelocityRequest?.message_type === \"JointVelocityRequest\") {\n      this.joggingWebsocket.sendJson({\n        message_type: \"JointVelocityRequest\",\n        velocity: {\n          joints: Array.from(new Array(this.jointCount).keys()).map(() => 0),\n        },\n      } as JointVelocityRequest)\n    }\n\n    if (this.lastVelocityRequest?.message_type === \"TcpVelocityRequest\") {\n      this.joggingWebsocket.sendJson({\n        message_type: \"TcpVelocityRequest\",\n        rotation: [0, 0, 0],\n        translation: [0, 0, 0],\n      } as TcpVelocityRequest)\n    }\n  }\n\n  dispose() {\n    if (this.joggingWebsocket) {\n      this.joggingWebsocket.dispose()\n    }\n  }\n\n  /**\n   * Start rotation of a single robot joint at the specified velocity\n   */\n  async startJointRotation({\n    joint,\n    velocityRadsPerSec,\n  }: {\n    /** Index of the joint to rotate */\n    joint: number\n    /** Speed of the rotation in radians per second */\n    velocityRadsPerSec: number\n  }) {\n    if (!this.joggingWebsocket) {\n      throw new Error(\n        \"Joint jogging websocket not connected. Wait for reconnect or open new jogging connection\",\n      )\n    }\n\n    const jointVelocities = new Array(this.jointCount).fill(0)\n    jointVelocities[joint] = velocityRadsPerSec\n\n    this.joggingWebsocket.sendJson({\n      message_type: \"JointVelocityRequest\",\n      velocity: {\n        joints: jointVelocities,\n      },\n    } as JointVelocityRequest)\n  }\n\n  /**\n   * Start the TCP moving along a specified axis at a given velocity\n   */\n  async startTCPTranslation({\n    axis,\n    velocityMmPerSec,\n    useToolCoordinateSystem,\n  }: {\n    axis: \"x\" | \"y\" | \"z\"\n    velocityMmPerSec: number\n    useToolCoordinateSystem: boolean\n  }) {\n    if (!this.joggingWebsocket) {\n      throw new Error(\n        \"Cartesian jogging websocket not connected. Wait for reconnect or open new jogging connection\",\n      )\n    }\n\n    const joggingVector = [0, 0, 0]\n    joggingVector[axisToIndex(axis)] = velocityMmPerSec\n\n    this.joggingWebsocket.sendJson({\n      message_type: \"TcpVelocityRequest\",\n\n      translation: joggingVector,\n      rotation: [0, 0, 0],\n      use_tool_coordinate_system: useToolCoordinateSystem,\n    } as TcpVelocityRequest)\n  }\n\n  /**\n   * Start the TCP rotating around a specified axis at a given velocity\n   */\n  async startTCPRotation({\n    axis,\n    velocityRadsPerSec,\n    useToolCoordinateSystem,\n  }: {\n    axis: \"x\" | \"y\" | \"z\"\n    velocityRadsPerSec: number\n    useToolCoordinateSystem: boolean\n  }) {\n    if (!this.joggingWebsocket) {\n      throw new Error(\n        \"Cartesian jogging websocket not connected. Wait for reconnect or open new jogging connection\",\n      )\n    }\n\n    const joggingVector = [0, 0, 0]\n    joggingVector[axisToIndex(axis)] = velocityRadsPerSec\n\n    this.joggingWebsocket.sendJson({\n      message_type: \"TcpVelocityRequest\",\n      rotation: joggingVector,\n      translation: [0, 0, 0],\n      use_tool_coordinate_system: useToolCoordinateSystem,\n    } as TcpVelocityRequest)\n  }\n}\n","import type {\n  Controller,\n  MotionGroupPhysical,\n  MotionGroupState,\n} from \"@wandelbots/nova-api/v2\"\nimport { makeAutoObservable, runInAction } from \"mobx\"\nimport * as THREE from \"three\"\nimport type { AutoReconnectingWebsocket } from \"../AutoReconnectingWebsocket\"\nimport { tryParseJson } from \"../converters\"\nimport { jointValuesEqual, tcpPoseEqual } from \"./motionStateUpdate\"\nimport type { NovaClient } from \"./NovaClient\"\nimport { Vector3d, vector3ToArray } from \"./vectorUtils\"\n\nconst MOTION_DELTA_THRESHOLD = 0.0001\n\nfunction unwrapRotationVector(\n  newRotationVectorApi: Vector3d,\n  currentRotationVectorApi: Vector3d,\n): Vector3d {\n  const currentRotationVector = new THREE.Vector3(\n    currentRotationVectorApi[0],\n    currentRotationVectorApi[1],\n    currentRotationVectorApi[2],\n  )\n\n  const newRotationVector = new THREE.Vector3(\n    newRotationVectorApi[0],\n    newRotationVectorApi[1],\n    newRotationVectorApi[2],\n  )\n\n  const currentAngle = currentRotationVector.length()\n  const currentAxis = currentRotationVector.normalize()\n\n  let newAngle = newRotationVector.length()\n  let newAxis = newRotationVector.normalize()\n\n  // Align rotation axes\n  if (newAxis.dot(currentAxis) < 0) {\n    newAngle = -newAngle\n    newAxis = newAxis.multiplyScalar(-1.0)\n  }\n\n  // Shift rotation angle close to previous one to extend domain of rotation angles beyond [0, pi]\n  // - this simplifies interpolation and prevents abruptly changing signs of the rotation angles\n  let angleDifference = newAngle - currentAngle\n  angleDifference -=\n    2.0 * Math.PI * Math.floor((angleDifference + Math.PI) / (2.0 * Math.PI))\n\n  newAngle = currentAngle + angleDifference\n\n  return vector3ToArray(newAxis.multiplyScalar(newAngle))\n}\n\n/**\n * Store representing the current state of a connected motion group.\n */\nexport class MotionStreamConnection {\n  static async open(nova: NovaClient, motionGroupId: string) {\n    const { controllers: controllers } =\n      await nova.api.controller.listControllers()\n\n    const [_motionGroupIndex, controllerId] = motionGroupId.split(\"@\") as [\n      string,\n      string,\n    ]\n    const controller = controllers.find((c) => c.controller === controllerId)\n    const motionGroup = controller?.motion_groups.find(\n      (mg) => mg.motion_group === motionGroupId,\n    )\n    if (!controller || !motionGroup) {\n      throw new Error(\n        `Controller ${controllerId} or motion group ${motionGroupId} not found`,\n      )\n    }\n\n    const motionStateSocket = nova.openReconnectingWebsocket(\n      `/motion-groups/${motionGroupId}/state-stream`,\n    )\n\n    // Wait for the first message to get the initial state\n    const firstMessage = await motionStateSocket.firstMessage()\n    console.log(\"got first message\", firstMessage)\n    const initialMotionState = tryParseJson(firstMessage.data)\n      ?.result as MotionGroupState\n\n    if (!initialMotionState) {\n      throw new Error(\n        `Unable to parse initial motion state message ${firstMessage.data}`,\n      )\n    }\n\n    console.log(\n      `Connected motion state websocket to motion group ${motionGroup.motion_group}. Initial state:\\n  `,\n      initialMotionState,\n    )\n\n    return new MotionStreamConnection(\n      nova,\n      controller,\n      motionGroup,\n      initialMotionState,\n      motionStateSocket,\n    )\n  }\n\n  // Not mobx-observable as this changes very fast; should be observed\n  // using animation frames\n  rapidlyChangingMotionState: MotionGroupState\n\n  constructor(\n    readonly nova: NovaClient,\n    readonly controller: Controller,\n    readonly motionGroup: MotionGroupPhysical,\n    readonly initialMotionState: MotionGroupState,\n    readonly motionStateSocket: AutoReconnectingWebsocket,\n  ) {\n    this.rapidlyChangingMotionState = initialMotionState\n\n    motionStateSocket.addEventListener(\"message\", (event) => {\n      const motionState = tryParseJson(event.data)?.result as\n        | MotionGroupState\n        | undefined\n\n      if (!motionState) {\n        throw new Error(\n          `Failed to get motion state for ${this.motionGroupId}: ${event.data}`,\n        )\n      }\n\n      // handle motionState message\n      if (\n        !jointValuesEqual(\n          this.rapidlyChangingMotionState.joint_position.joints,\n          motionState.joint_position.joints,\n          MOTION_DELTA_THRESHOLD,\n        )\n      ) {\n        runInAction(() => {\n          this.rapidlyChangingMotionState = motionState\n        })\n      }\n\n      // handle tcpPose message\n      if (\n        !tcpPoseEqual(\n          this.rapidlyChangingMotionState.tcp_pose,\n          motionState.tcp_pose,\n          MOTION_DELTA_THRESHOLD,\n        )\n      ) {\n        runInAction(() => {\n          if (this.rapidlyChangingMotionState.tcp_pose == undefined) {\n            this.rapidlyChangingMotionState.tcp_pose = motionState.tcp_pose\n          } else {\n            this.rapidlyChangingMotionState.tcp_pose = {\n              position: motionState.tcp_pose!.position,\n              orientation: unwrapRotationVector(\n                motionState.tcp_pose!.orientation as Vector3d,\n                this.rapidlyChangingMotionState.tcp_pose!\n                  .orientation as Vector3d,\n              ),\n              tcp: motionState.tcp_pose!.tcp,\n              coordinate_system: motionState.tcp_pose!.coordinate_system,\n            }\n          }\n        })\n      }\n    })\n    makeAutoObservable(this)\n  }\n\n  get motionGroupId() {\n    return this.motionGroup.motion_group\n  }\n\n  get controllerId() {\n    return this.controller.controller\n  }\n\n  get modelFromController() {\n    return this.motionGroup.model_from_controller\n  }\n\n  get wandelscriptIdentifier() {\n    const num = this.motionGroupId.split(\"@\")[0]\n    return `${this.controllerId.replaceAll(\"-\", \"_\")}_${num}`\n  }\n\n  get joints() {\n    return this.initialMotionState.joint_position.joints.map((_, i) => {\n      return {\n        index: i,\n      }\n    })\n  }\n\n  dispose() {\n    this.motionStateSocket.close()\n  }\n}\n","import type { Configuration as BaseConfiguration } from \"@wandelbots/nova-api/v2\"\nimport {\n  ApplicationApi,\n  CellApi,\n  ControllerApi,\n  ControllerInputsOutputsApi,\n  CoordinateSystemsApi,\n  JoggingApi,\n  MotionGroupApi,\n  MotionGroupInfoApi,\n  MotionGroupKinematicsApi,\n  ProgramApi,\n  ProgramOperatorApi,\n  StoreCollisionComponentsApi,\n  StoreCollisionScenesApi,\n  StoreObjectApi,\n  SystemApi,\n  TrajectoryExecutionApi,\n  TrajectoryPlanningApi,\n  VirtualRobotApi,\n  VirtualRobotBehaviorApi,\n  VirtualRobotModeApi,\n  VirtualRobotSetupApi,\n} from \"@wandelbots/nova-api/v2\"\nimport type { BaseAPI } from \"@wandelbots/nova-api/v2/base\"\nimport type { AxiosInstance } from \"axios\"\nimport axios from \"axios\"\n\ntype OmitFirstArg<F> = F extends (x: any, ...args: infer P) => infer R\n  ? (...args: P) => R\n  : never\n\ntype UnwrapAxiosResponseReturn<T> = T extends (...a: any) => any\n  ? (\n      ...a: Parameters<T>\n    ) => Promise<Awaited<ReturnType<T>> extends { data: infer D } ? D : never>\n  : never\n\nexport type WithCellId<T> = {\n  [P in keyof T]: UnwrapAxiosResponseReturn<OmitFirstArg<T[P]>>\n}\n\nexport type WithUnwrappedAxiosResponse<T> = {\n  [P in keyof T]: UnwrapAxiosResponseReturn<T[P]>\n}\n\n/**\n * API client providing type-safe access to all the Nova API REST endpoints\n * associated with a specific cell id.\n */\nexport class NovaCellAPIClient {\n  constructor(\n    readonly cellId: string,\n    readonly opts: BaseConfiguration & {\n      axiosInstance?: AxiosInstance\n      mock?: boolean\n    },\n  ) {}\n\n  /**\n   * Some TypeScript sorcery which alters the API class methods so you don't\n   * have to pass the cell id to every single one, and de-encapsulates the\n   * response data\n   */\n  private withCellId<T extends BaseAPI>(\n    ApiConstructor: new (\n      config: BaseConfiguration,\n      basePath: string,\n      axios: AxiosInstance,\n    ) => T,\n  ) {\n    const apiClient = new ApiConstructor(\n      {\n        ...this.opts,\n        isJsonMime: (mime: string) => {\n          return mime === \"application/json\"\n        },\n      },\n      this.opts.basePath ?? \"\",\n      this.opts.axiosInstance ?? axios.create(),\n    ) as {\n      [key: string | symbol]: any\n    }\n\n    for (const key of Reflect.ownKeys(Reflect.getPrototypeOf(apiClient)!)) {\n      if (key !== \"constructor\" && typeof apiClient[key] === \"function\") {\n        const originalFunction = apiClient[key]\n        apiClient[key] = (...args: any[]) => {\n          return originalFunction\n            .apply(apiClient, [this.cellId, ...args])\n            .then((res: any) => res.data)\n        }\n      }\n    }\n\n    return apiClient as WithCellId<T>\n  }\n\n  /**\n   * As withCellId, but only does the response unwrapping\n   */\n  private withUnwrappedResponsesOnly<T extends BaseAPI>(\n    ApiConstructor: new (\n      config: BaseConfiguration,\n      basePath: string,\n      axios: AxiosInstance,\n    ) => T,\n  ) {\n    const apiClient = new ApiConstructor(\n      {\n        ...this.opts,\n        isJsonMime: (mime: string) => {\n          return mime === \"application/json\"\n        },\n      },\n      this.opts.basePath ?? \"\",\n      this.opts.axiosInstance ?? axios.create(),\n    ) as {\n      [key: string | symbol]: any\n    }\n\n    for (const key of Reflect.ownKeys(Reflect.getPrototypeOf(apiClient)!)) {\n      if (key !== \"constructor\" && typeof apiClient[key] === \"function\") {\n        const originalFunction = apiClient[key]\n        apiClient[key] = (...args: any[]) => {\n          return originalFunction\n            .apply(apiClient, args)\n            .then((res: any) => res.data)\n        }\n      }\n    }\n\n    return apiClient as WithUnwrappedAxiosResponse<T>\n  }\n\n  readonly system = this.withUnwrappedResponsesOnly(SystemApi)\n  readonly cell = this.withUnwrappedResponsesOnly(CellApi)\n\n  readonly motionGroup = this.withCellId(MotionGroupApi)\n  readonly motionGroupInfos = this.withCellId(MotionGroupInfoApi)\n\n  readonly controller = this.withCellId(ControllerApi)\n\n  readonly program = this.withCellId(ProgramApi)\n  readonly programOperator = this.withCellId(ProgramOperatorApi)\n\n  readonly controllerIOs = this.withCellId(ControllerInputsOutputsApi)\n\n  readonly motionGroupKinematic = this.withCellId(MotionGroupKinematicsApi)\n  readonly trajectoryPlanning = this.withCellId(TrajectoryPlanningApi)\n  readonly trajectoryExecution = this.withCellId(TrajectoryExecutionApi)\n\n  readonly coordinateSystems = this.withCellId(CoordinateSystemsApi)\n\n  readonly application = this.withCellId(ApplicationApi)\n  readonly applicationGlobal = this.withUnwrappedResponsesOnly(ApplicationApi)\n\n  readonly jogging = this.withCellId(JoggingApi)\n\n  readonly virtualRobot = this.withCellId(VirtualRobotApi)\n  readonly virtualRobotSetup = this.withCellId(VirtualRobotSetupApi)\n  readonly virtualRobotMode = this.withCellId(VirtualRobotModeApi)\n  readonly virtualRobotBehavior = this.withCellId(VirtualRobotBehaviorApi)\n\n  readonly storeObject = this.withCellId(StoreObjectApi)\n  readonly storeCollisionComponents = this.withCellId(\n    StoreCollisionComponentsApi,\n  )\n  readonly storeCollisionScenes = this.withCellId(StoreCollisionScenesApi)\n}\n","import type { Configuration as BaseConfiguration } from \"@wandelbots/nova-api/v2\"\nimport type { AxiosRequestConfig } from \"axios\"\nimport axios, { isAxiosError } from \"axios\"\nimport urlJoin from \"url-join\"\nimport { loginWithAuth0 } from \"../../LoginWithAuth0\"\nimport { AutoReconnectingWebsocket } from \"../AutoReconnectingWebsocket\"\nimport { availableStorage } from \"../availableStorage\"\nimport { ConnectedMotionGroup } from \"./ConnectedMotionGroup\"\nimport { MockNovaInstance } from \"./mock/MockNovaInstance\"\nimport { MotionStreamConnection } from \"./MotionStreamConnection\"\nimport { NovaCellAPIClient } from \"./NovaCellAPIClient\"\n\nexport type NovaClientConfig = {\n  /**\n   * Url of the deployed Nova instance to connect to\n   * e.g. https://saeattii.instance.wandelbots.io\n   */\n  instanceUrl: string | \"https://mock.example.com\"\n\n  /**\n   * Identifier of the cell on the Nova instance to connect this client to.\n   * If omitted, the default identifier \"cell\" is used.\n   **/\n  cellId?: string\n\n  /**\n   * Username for basic auth to the Nova instance.\n   * @deprecated use accessToken instead\n   */\n  username?: string\n\n  /**\n   * Password for basic auth to the Nova instance.\n   * @deprecated use accessToken instead\n   */\n  password?: string\n\n  /**\n   * Access token for Bearer authentication.\n   */\n  accessToken?: string\n} & Omit<BaseConfiguration, \"isJsonMime\" | \"basePath\">\n\ntype NovaClientConfigWithDefaults = NovaClientConfig & { cellId: string }\n\n/**\n * EXPERIMENTAL\n *\n * This client provides a starting point to migrate NOVA api v2.\n * As v2 is still in development, this client has to be considered unstable\n *\n * Client for connecting to a Nova instance and controlling robots.\n */\nexport class NovaClient {\n  readonly api: NovaCellAPIClient\n  readonly config: NovaClientConfigWithDefaults\n  readonly mock?: MockNovaInstance\n  authPromise: Promise<string | null> | null = null\n  accessToken: string | null = null\n\n  constructor(config: NovaClientConfig) {\n    console.warn(\"Using experimental NOVA v2 client\")\n    const cellId = config.cellId ?? \"cell\"\n    this.config = {\n      cellId,\n      ...config,\n    }\n    this.accessToken =\n      config.accessToken ||\n      availableStorage.getString(\"wbjs.access_token\") ||\n      null\n\n    if (this.config.instanceUrl === \"https://mock.example.com\") {\n      this.mock = new MockNovaInstance()\n    }\n\n    // Set up Axios instance with interceptor for token fetching\n    const axiosInstance = axios.create({\n      baseURL: urlJoin(this.config.instanceUrl, \"/api/v2\"),\n      // TODO - backend needs to set proper CORS headers for this\n      headers:\n        typeof window !== \"undefined\" &&\n        window.location.origin.includes(\"localhost\")\n          ? {}\n          : {\n              // Identify the client to the backend for logging purposes\n              \"X-Wandelbots-Client\": \"Wandelbots-Nova-JS-SDK\",\n            },\n    })\n\n    axiosInstance.interceptors.request.use(async (request) => {\n      if (!request.headers.Authorization) {\n        if (this.accessToken) {\n          request.headers.Authorization = `Bearer ${this.accessToken}`\n        } else if (this.config.username && this.config.password) {\n          request.headers.Authorization = `Basic ${btoa(config.username + \":\" + config.password)}`\n        }\n      }\n      return request\n    })\n\n    if (typeof window !== \"undefined\") {\n      axiosInstance.interceptors.response.use(\n        (r) => r,\n        async (error) => {\n          if (isAxiosError(error)) {\n            if (error.response?.status === 401) {\n              // If we hit a 401, attempt to login the user and retry with\n              // a new access token\n              try {\n                await this.renewAuthentication()\n\n                if (error.config) {\n                  if (this.accessToken) {\n                    error.config.headers.Authorization = `Bearer ${this.accessToken}`\n                  } else {\n                    delete error.config.headers.Authorization\n                  }\n                  return axiosInstance.request(error.config)\n                }\n              } catch (err) {\n                return Promise.reject(err)\n              }\n            } else if (error.response?.status === 503) {\n              // Check if the server as a whole is down\n              const res = await fetch(window.location.href)\n              if (res.status === 503) {\n                // Go to 503 page\n                window.location.reload()\n              }\n            }\n          }\n\n          return Promise.reject(error)\n        },\n      )\n    }\n\n    this.api = new NovaCellAPIClient(cellId, {\n      ...config,\n      basePath: urlJoin(this.config.instanceUrl, \"/api/v1\"),\n      isJsonMime: (mime: string) => {\n        return mime === \"application/json\"\n      },\n      baseOptions: {\n        ...(this.mock\n          ? ({\n              adapter: (config) => {\n                return this.mock!.handleAPIRequest(config)\n              },\n            } satisfies AxiosRequestConfig)\n          : {}),\n        ...config.baseOptions,\n      },\n      axiosInstance,\n    })\n  }\n\n  async renewAuthentication(): Promise<void> {\n    if (this.authPromise) {\n      // Don't double up\n      return\n    }\n\n    this.authPromise = loginWithAuth0(this.config.instanceUrl)\n    try {\n      this.accessToken = await this.authPromise\n      if (this.accessToken) {\n        // Cache access token so we don't need to log in every refresh\n        availableStorage.setString(\"wbjs.access_token\", this.accessToken)\n      } else {\n        availableStorage.delete(\"wbjs.access_token\")\n      }\n    } finally {\n      this.authPromise = null\n    }\n  }\n\n  makeWebsocketURL(path: string): string {\n    const url = new URL(\n      urlJoin(\n        this.config.instanceUrl,\n        `/api/v1/cells/${this.config.cellId}`,\n        path,\n      ),\n    )\n    url.protocol = url.protocol.replace(\"http\", \"ws\")\n    url.protocol = url.protocol.replace(\"https\", \"wss\")\n\n    // If provided, add basic auth credentials to the URL\n    // NOTE - basic auth is deprecated on websockets and doesn't work in Safari\n    // use tokens instead\n    if (this.accessToken) {\n      url.searchParams.append(\"token\", this.accessToken)\n    } else if (this.config.username && this.config.password) {\n      url.username = this.config.username\n      url.password = this.config.password\n    }\n\n    return url.toString()\n  }\n\n  /**\n   * Retrieve an AutoReconnectingWebsocket to the given path on the Nova instance.\n   * If you explicitly want to reconnect an existing websocket, call `reconnect`\n   * on the returned object.\n   */\n  openReconnectingWebsocket(path: string) {\n    return new AutoReconnectingWebsocket(this.makeWebsocketURL(path), {\n      mock: this.mock,\n    })\n  }\n\n  /**\n   * Connect to the motion state websocket(s) for a given motion group\n   */\n  async connectMotionStream(motionGroupId: string) {\n    return await MotionStreamConnection.open(this, motionGroupId)\n  }\n\n  async connectMotionGroups(\n    motionGroupIds: string[],\n  ): Promise<ConnectedMotionGroup[]> {\n    const { controllers } = await this.api.controller.listControllers()\n\n    return Promise.all(\n      motionGroupIds.map((motionGroupId) =>\n        ConnectedMotionGroup.connect(this, motionGroupId, controllers),\n      ),\n    )\n  }\n\n  async connectMotionGroup(\n    motionGroupId: string,\n  ): Promise<ConnectedMotionGroup> {\n    const motionGroups = await this.connectMotionGroups([motionGroupId])\n    return motionGroups[0]!\n  }\n}\n","const DOMAIN_SUFFIX = \"wandelbots.io\"\n\n/** Mapping of stages to Auth0 configurations */\nconst auth0ConfigMap = {\n  dev: {\n    domain: `https://auth.portal.dev.${DOMAIN_SUFFIX}`,\n    clientId: process.env.NOVA_AUTH0_DEV_CLIENT_ID,\n  },\n  stg: {\n    domain: `https://auth.portal.stg.${DOMAIN_SUFFIX}`,\n    clientId: process.env.NOVA_AUTH0_STG_CLIENT_ID,\n  },\n  prod: {\n    domain: `https://auth.portal.${DOMAIN_SUFFIX}`,\n    clientId: process.env.NOVA_AUTH0_PROD_CLIENT_ID,\n  },\n}\n\n/** Determine which Auth0 configuration to use based on instance URL  */\nconst getAuth0Config = (instanceUrl: string) => {\n  if (instanceUrl.includes(`dev.${DOMAIN_SUFFIX}`)) return auth0ConfigMap.dev\n  if (instanceUrl.includes(`stg.${DOMAIN_SUFFIX}`)) return auth0ConfigMap.stg\n  if (instanceUrl.includes(DOMAIN_SUFFIX)) return auth0ConfigMap.prod\n  throw new Error(\n    \"Unsupported instance URL. Cannot determine Auth0 configuration.\",\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: string,\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  const auth0Config = getAuth0Config(instanceUrl)\n\n  if (new URL(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 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","import ReconnectingWebSocket, { type ErrorEvent } from \"reconnecting-websocket\"\nimport * as v2 from \"./v2/mock/MockNovaInstance\"\nimport * as v1 from \"./v1/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: any) {\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","import type {\n  ControllersList,\n  MotionGroupSpecification,\n  MotionGroupState,\n  RobotController,\n  SafetySetup,\n} from \"@wandelbots/nova-api/v2\"\nimport type { AxiosResponse, InternalAxiosRequestConfig } from \"axios\"\nimport { AxiosError } from \"axios\"\nimport * as pathToRegexp from \"path-to-regexp\"\nimport type { AutoReconnectingWebsocket } from \"../../AutoReconnectingWebsocket\"\n\n/**\n * EXPERIMENTAL\n * Ultra-simplified mock Nova server for testing stuff\n */\nexport class MockNovaInstance {\n  readonly connections: AutoReconnectingWebsocket[] = []\n\n  async handleAPIRequest(\n    config: InternalAxiosRequestConfig,\n  ): Promise<AxiosResponse> {\n    const apiHandlers = [\n      {\n        method: \"GET\",\n        path: \"/cells/:cellId/controllers\",\n        handle() {\n          return {\n            controllers: [\n              {\n                controller: \"mock-ur5e\",\n                model_name: \"UniversalRobots::Controller\",\n                host: \"mock-ur5e\",\n                allow_software_install_on_controller: true,\n                motion_groups: [\n                  {\n                    motion_group: \"0@mock-ur5e\",\n                    name_from_controller: \"UR5e\",\n                    active: false,\n                    model_from_controller: \"UniversalRobots_UR5e\",\n                  },\n                ],\n                has_error: false,\n                error_details: \"\",\n              },\n            ],\n          } satisfies ControllersList\n        },\n      },\n      {\n        method: \"GET\",\n        path: \"/cells/:cellId/controllers/:controllerId\",\n        handle() {\n          return {\n            configuration: {\n              kind: \"VirtualController\",\n              manufacturer: \"universalrobots\",\n              position: \"[0,-1.571,-1.571,-1.571,1.571,-1.571,0]\",\n              type: \"universalrobots-ur5e\",\n            },\n            name: \"mock-ur5\",\n          } satisfies RobotController\n        },\n      },\n      {\n        method: \"GET\",\n        path: \"/cells/:cellId/motion-groups/:motionGroupId/specification\",\n        handle() {\n          return {\n            dh_parameters: [\n              {\n                alpha: 1.5707963267948966,\n                theta: 0,\n                a: 0,\n                d: 162.25,\n                reverse_rotation_direction: false,\n              },\n              {\n                alpha: 0,\n                theta: 0,\n                a: -425,\n                d: 0,\n                reverse_rotation_direction: false,\n              },\n              {\n                alpha: 0,\n                theta: 0,\n                a: -392.2,\n                d: 0,\n                reverse_rotation_direction: false,\n              },\n              {\n                alpha: 1.5707963267948966,\n                theta: 0,\n                a: 0,\n                d: 133.3,\n                reverse_rotation_direction: false,\n              },\n              {\n                alpha: -1.5707963267948966,\n                theta: 0,\n                a: 0,\n                d: 99.7,\n                reverse_rotation_direction: false,\n              },\n              {\n                alpha: 0,\n                theta: 0,\n                a: 0,\n                d: 99.6,\n                reverse_rotation_direction: false,\n              },\n            ],\n            mechanical_joint_limits: [\n              {\n                joint: \"JOINTNAME_AXIS_1\",\n                lower_limit: -6.335545063018799,\n                upper_limit: 6.335545063018799,\n                unlimited: false,\n              },\n              {\n                joint: \"JOINTNAME_AXIS_2\",\n                lower_limit: -6.335545063018799,\n                upper_limit: 6.335545063018799,\n                unlimited: false,\n              },\n              {\n                joint: \"JOINTNAME_AXIS_3\",\n                lower_limit: -6.335545063018799,\n                upper_limit: 6.335545063018799,\n                unlimited: false,\n              },\n              {\n                joint: \"JOINTNAME_AXIS_4\",\n                lower_limit: -6.335545063018799,\n                upper_limit: 6.335545063018799,\n                unlimited: false,\n