@eyepop.ai/eyepop 3.19.0 → 3.19.1

package/README.md

@@ -6,7 +6,7 @@ The EyePop.ai Node SDK provides JavaScript and TypeScript access to EyePop worke
 
 ### Node
 
-The SDK is tested with Node 20 LTS and newer.
+Requires Node.js 18 or newer. CI validates Node.js 22.
 
 ```shell
 npm install --save @eyepop.ai/eyepop

package/dist/eyepop.index.d.mts

@@ -1251,12 +1251,21 @@ declare class EvaluateDatasetJob {
     cancel(): void;
 }
 
+declare class EyePopDataWebSocketError extends Error {
+    readonly code = "DATA_WEBSOCKET_CONNECTION_FAILED";
+    readonly endpoint: string;
+    readonly sourceError: unknown;
+    constructor(url: string, event: unknown);
+}
 declare class DataEndpoint extends Endpoint<DataEndpoint> {
     private datasetApiUrl;
     private vlmApiUrl;
     private _accountId;
     private _ws;
     private _ws_current_reconnect_delay;
+    private _ws_reconnect_timeout;
+    private _ws_reconnect_enabled;
+    private _ws_connecting;
     private _account_event_handlers;
     private _dataset_uuid_to_event_handlers;
     constructor(options: DataOptions);
@@ -1264,6 +1273,9 @@ declare class DataEndpoint extends Endpoint<DataEndpoint> {
     disconnect(wait?: boolean): Promise<void>;
     protected reconnect(): Promise<DataEndpoint>;
     private reconnect_ws;
+    private open_ws;
+    private close_ws;
+    private schedule_ws_reconnect;
     private options;
     private request;
     listDatasets(include_stats?: boolean, modifiable_version_only?: boolean): Promise<Dataset[]>;
@@ -1551,4 +1563,4 @@ declare namespace EyePop {
     function dataEndpoint(opts?: DataOptions): DataEndpoint;
 }
 
-export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, decodeDepthMap, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth };
+export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, decodeDepthMap, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth };

package/dist/eyepop.index.d.ts

@@ -1251,12 +1251,21 @@ declare class EvaluateDatasetJob {
     cancel(): void;
 }
 
+declare class EyePopDataWebSocketError extends Error {
+    readonly code = "DATA_WEBSOCKET_CONNECTION_FAILED";
+    readonly endpoint: string;
+    readonly sourceError: unknown;
+    constructor(url: string, event: unknown);
+}
 declare class DataEndpoint extends Endpoint<DataEndpoint> {
     private datasetApiUrl;
     private vlmApiUrl;
     private _accountId;
     private _ws;
     private _ws_current_reconnect_delay;
+    private _ws_reconnect_timeout;
+    private _ws_reconnect_enabled;
+    private _ws_connecting;
     private _account_event_handlers;
     private _dataset_uuid_to_event_handlers;
     constructor(options: DataOptions);
@@ -1264,6 +1273,9 @@ declare class DataEndpoint extends Endpoint<DataEndpoint> {
     disconnect(wait?: boolean): Promise<void>;
     protected reconnect(): Promise<DataEndpoint>;
     private reconnect_ws;
+    private open_ws;
+    private close_ws;
+    private schedule_ws_reconnect;
     private options;
     private request;
     listDatasets(include_stats?: boolean, modifiable_version_only?: boolean): Promise<Dataset[]>;
@@ -1551,4 +1563,4 @@ declare namespace EyePop {
     function dataEndpoint(opts?: DataOptions): DataEndpoint;
 }
 
-export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, decodeDepthMap, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth };
+export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, decodeDepthMap, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth };

package/dist/eyepop.index.js

@@ -8677,6 +8677,7 @@ __export(index_exports, {
   EvaluationStatus: () => EvaluationStatus,
   ExportedBy: () => ExportedBy,
   EyePop: () => EyePop,
+  EyePopDataWebSocketError: () => EyePopDataWebSocketError,
   EyepopLineDecoder: () => EyepopLineDecoder,
   ForwardOperatorType: () => ForwardOperatorType,
   InferenceType: () => InferenceType,
@@ -11522,57 +11523,8 @@ if ("document" in globalThis && "implementation" in globalThis.document) {
   };
 }
 
-// ../../node_modules/url-join/lib/url-join.js
-function normalize(strArray) {
-  var resultArray = [];
-  if (strArray.length === 0) {
-    return "";
-  }
-  if (typeof strArray[0] !== "string") {
-    throw new TypeError("Url must be a string. Received " + strArray[0]);
-  }
-  if (strArray[0].match(/^[^/:]+:\/*$/) && strArray.length > 1) {
-    var first = strArray.shift();
-    strArray[0] = first + strArray[0];
-  }
-  if (strArray[0].match(/^file:\/\/\//)) {
-    strArray[0] = strArray[0].replace(/^([^/:]+):\/*/, "$1:///");
-  } else {
-    strArray[0] = strArray[0].replace(/^([^/:]+):\/*/, "$1://");
-  }
-  for (var i = 0; i < strArray.length; i++) {
-    var component = strArray[i];
-    if (typeof component !== "string") {
-      throw new TypeError("Url must be a string. Received " + component);
-    }
-    if (component === "") {
-      continue;
-    }
-    if (i > 0) {
-      component = component.replace(/^[\/]+/, "");
-    }
-    if (i < strArray.length - 1) {
-      component = component.replace(/[\/]+$/, "");
-    } else {
-      component = component.replace(/[\/]+$/, "/");
-    }
-    resultArray.push(component);
-  }
-  var str = resultArray.join("/");
-  str = str.replace(/\/(\?|&|#[^!])/g, "$1");
-  var parts = str.split("?");
-  str = parts.shift() + (parts.length > 0 ? "?" : "") + parts.join("&");
-  return str;
-}
-function urlJoin() {
-  var input;
-  if (typeof arguments[0] === "object") {
-    input = arguments[0];
-  } else {
-    input = [].slice.call(arguments);
-  }
-  return normalize(input);
-}
+// data/data_endpoint.ts
+var import_url_join = __toESM(require("url-join"));
 
 // data/data_types.ts
 var DataApiType = /* @__PURE__ */ ((DataApiType2) => {
@@ -11925,6 +11877,33 @@ var EvaluateDatasetJob = class {
 // data/data_endpoint.ts
 var WS_INITIAL_RECONNECT_DELAY = 1e3;
 var WS_MAX_RECONNECT_DELAY = 6e4;
+function ws_origin(url) {
+  try {
+    return new URL(url).origin;
+  } catch {
+    return url;
+  }
+}
+function ws_failure_reason(event, sourceError) {
+  if (sourceError instanceof Error) {
+    return sourceError.message;
+  }
+  if (typeof sourceError === "string") {
+    return sourceError;
+  }
+  return event?.message ?? "";
+}
+var EyePopDataWebSocketError = class extends Error {
+  constructor(url, event) {
+    const sourceError = event?.error ?? event;
+    const reason = ws_failure_reason(event, sourceError);
+    super(reason ? `EyePop Dataset event WebSocket connection failed: ${reason}` : "EyePop Dataset event WebSocket connection failed");
+    this.code = "DATA_WEBSOCKET_CONNECTION_FAILED";
+    this.name = "EyePopDataWebSocketError";
+    this.endpoint = ws_origin(url);
+    this.sourceError = sourceError;
+  }
+};
 function omit_nulls(_, value) {
   if (value === null) {
     return void 0;
@@ -11938,6 +11917,9 @@ var DataEndpoint = class extends Endpoint {
     this.vlmApiUrl = null;
     this._ws = null;
     this._ws_current_reconnect_delay = null;
+    this._ws_reconnect_timeout = null;
+    this._ws_reconnect_enabled = false;
+    this._ws_connecting = null;
     this._accountId = options.accountId || null;
     this._account_event_handlers = [];
     this._dataset_uuid_to_event_handlers = /* @__PURE__ */ new Map();
@@ -11961,14 +11943,15 @@ var DataEndpoint = class extends Endpoint {
     };
   }
   async disconnect(wait = true) {
+    this._ws_reconnect_enabled = false;
+    if (this._ws_reconnect_timeout) {
+      clearTimeout(this._ws_reconnect_timeout);
+      this._ws_reconnect_timeout = null;
+    }
     this.datasetApiUrl = null;
     this.vlmApiUrl = null;
     if (this._ws) {
-      try {
-        this._ws.close();
-      } catch (e) {
-        this._logger.warn("ignored exception", e);
-      }
+      this.close_ws(this._ws, "unsubscribe");
       this._ws = null;
     }
     await super.disconnect(wait);
@@ -12006,13 +11989,14 @@ var DataEndpoint = class extends Endpoint {
     const vlmApiUrl = new URL(config.vlm_api_url, this.eyepopUrl());
     this.vlmApiUrl = vlmApiUrl.toString();
     if (this.options().disableWs) {
+      this._ws_reconnect_enabled = false;
       this._logger.info("disabled ws connection");
     } else {
       await this.reconnect_ws();
     }
     if (this.options().useCookie) {
       const client = this._client;
-      const url = urlJoin(this.datasetApiUrl, "security", "check?set_cookie=true");
+      const url = (0, import_url_join.default)(this.datasetApiUrl, "security", "check?set_cookie=true");
       const headers2 = {
         Authorization: await this.authorizationHeader()
       };
@@ -12029,37 +12013,68 @@ var DataEndpoint = class extends Endpoint {
     return Promise.resolve(this);
   }
   async reconnect_ws() {
+    if (this._ws_connecting) {
+      return this._ws_connecting;
+    }
+    const connecting = this.open_ws();
+    this._ws_connecting = connecting;
+    try {
+      await connecting;
+    } finally {
+      this._ws_connecting = null;
+    }
+  }
+  async open_ws() {
     if (this._ws) {
-      this._ws.close();
+      this.close_ws(this._ws, "unsubscribe");
       this._ws = null;
     }
     const baseUrl = this.datasetApiUrl?.replace("https://", "wss://").replace("http://", "ws://");
     if (!baseUrl) {
       return;
     }
-    const ws_url = urlJoin(baseUrl, "events");
+    const ws_url = (0, import_url_join.default)(baseUrl, "events");
     this._requestLogger.debug("about to connect ws to: %s", ws_url);
     return new Promise((resolve, reject) => {
+      let settled = false;
+      const settle_ok = () => {
+        settled = true;
+        resolve();
+      };
+      const settle_err = (error) => {
+        settled = true;
+        reject(error);
+      };
       const ws = createWebSocket(ws_url);
       if (!ws) {
-        return resolve();
+        return settle_ok();
       }
       this._ws = ws;
-      ws.onopen = async () => {
-        const auth_header = await this.authorizationHeader();
-        let msg = JSON.stringify({ authorization: auth_header });
-        this._requestLogger.debug("ws send: %s", msg);
-        ws.send(msg);
-        msg = JSON.stringify({ subscribe: { account_uuid: this._accountId } });
-        this._requestLogger.debug("ws send: %s", msg);
-        ws.send(msg);
-        for (let dataset_uuid in this._dataset_uuid_to_event_handlers.keys()) {
-          const msg2 = JSON.stringify({ subscribe: { dataset_uuid } });
-          this._requestLogger.debug("ws send: %s", msg2);
-          ws.send(msg2);
-        }
-        this._ws_current_reconnect_delay = WS_INITIAL_RECONNECT_DELAY;
-        resolve();
+      ws.onopen = () => {
+        void this.authorizationHeader().then((auth_header) => {
+          if (this._ws !== ws) {
+            this.close_ws(ws, "unsubscribe");
+            settle_ok();
+            return;
+          }
+          let msg = JSON.stringify({ authorization: auth_header });
+          this._requestLogger.debug("ws send: %s", msg);
+          ws.send(msg);
+          msg = JSON.stringify({ subscribe: { account_uuid: this._accountId } });
+          this._requestLogger.debug("ws send: %s", msg);
+          ws.send(msg);
+          for (const dataset_uuid of this._dataset_uuid_to_event_handlers.keys()) {
+            const msg2 = JSON.stringify({ subscribe: { dataset_uuid } });
+            this._requestLogger.debug("ws send: %s", msg2);
+            ws.send(msg2);
+          }
+          this._ws_current_reconnect_delay = WS_INITIAL_RECONNECT_DELAY;
+          this._ws_reconnect_enabled = true;
+          settle_ok();
+        }).catch((error) => {
+          this.close_ws(ws, "authorization failed", 1011);
+          settle_err(error);
+        });
       };
       ws.onmessage = (event) => {
         const data = JSON.parse(event.data);
@@ -12070,24 +12085,54 @@ var DataEndpoint = class extends Endpoint {
       ws.onclose = (event) => {
         const { code, reason } = event;
         this._requestLogger.debug("ws closed: %d %s", code, reason);
-        if (reason !== "unsubscribe") {
-          if (!this._ws_current_reconnect_delay) {
-            this._ws_current_reconnect_delay = WS_INITIAL_RECONNECT_DELAY;
-          } else if (this._ws_current_reconnect_delay < WS_MAX_RECONNECT_DELAY) {
-            this._ws_current_reconnect_delay *= 1.5;
-          }
-          setTimeout(async () => {
-            await this.reconnect_ws();
-          }, this._ws_current_reconnect_delay);
+        if (!settled) {
+          settle_err(new EyePopDataWebSocketError(ws_url, new Error(`closed before the connection was established: ${code} ${reason}`)));
+        }
+        if (this._ws !== ws) {
+          return;
         }
+        this._ws = null;
+        this.schedule_ws_reconnect();
       };
       ws.onerror = (event) => {
-        this._logger.error(event);
-        reject(event);
+        const error = new EyePopDataWebSocketError(ws_url, event);
+        this._logger.error({ err: error }, "dataset event WebSocket connection failed");
+        settle_err(error);
         return null;
       };
     });
   }
+  close_ws(ws, reason, code = 1e3) {
+    try {
+      ws.close(code, reason);
+    } catch (e) {
+      this._logger.warn({ err: e }, "ignored exception closing the dataset event WebSocket");
+    }
+  }
+  schedule_ws_reconnect() {
+    if (!this._ws_reconnect_enabled || this._ws_reconnect_timeout) {
+      return;
+    }
+    if (!this._ws_current_reconnect_delay) {
+      this._ws_current_reconnect_delay = WS_INITIAL_RECONNECT_DELAY;
+    } else if (this._ws_current_reconnect_delay < WS_MAX_RECONNECT_DELAY) {
+      this._ws_current_reconnect_delay *= 1.5;
+    }
+    this._ws_reconnect_timeout = setTimeout(() => {
+      if (!this._ws_reconnect_enabled) {
+        this._ws_reconnect_timeout = null;
+        return;
+      }
+      void this.reconnect_ws().catch((error) => {
+        this._requestLogger.debug("dataset event WebSocket reconnect failed: %s", error);
+      }).finally(() => {
+        this._ws_reconnect_timeout = null;
+        if (!this._ws) {
+          this.schedule_ws_reconnect();
+        }
+      });
+    }, this._ws_current_reconnect_delay);
+  }
   options() {
     return this._options;
   }
@@ -12112,7 +12157,7 @@ var DataEndpoint = class extends Endpoint {
         body: options.body
       };
       this._requestLogger.debug("Request - " + ri.method + " " + path2 + " BODY: " + (ri.body ? ri.body : ""));
-      return await client.fetch(urlJoin(baseUrl ?? "", path2), ri);
+      return await client.fetch((0, import_url_join.default)(baseUrl ?? "", path2), ri);
     });
     if (response.status === 204) {
       return null;
@@ -13090,6 +13135,7 @@ var index_default = EyePop;
   EvaluationStatus,
   ExportedBy,
   EyePop,
+  EyePopDataWebSocketError,
   EyepopLineDecoder,
   ForwardOperatorType,
   InferenceType,