@eyepop.ai/eyepop 3.20.1 → 3.22.0

package/dist/eyepop.index.d.mts

@@ -126,9 +126,9 @@ interface Mask {
  * "unknown" included - so an absent member means a worker that predates the
  * field rather than a map that declined to say:
  *
- * - "canonical_metric" - metres = value * focal_px / 300, with focal_px scaled
+ * - "canonical_metric" - meters = value * focal_px / 300, with focal_px scaled
  *   to the map's own resolution
- * - "metric" - the value is already metres
+ * - "metric" - the value is already meters
  * - "relative" - scale- AND shift-invariant, so ordering is meaningful but
  *   distance is not. Not back-projectable: recovering a cloud from it yields a
  *   distorted scene rather than a scaled one
@@ -169,7 +169,7 @@ interface PredictedObject extends PredictedClass {
 /**
  * A point in source pixels, optionally placed in 3D.
  *
- * `worldX`/`worldY`/`worldZ` are metres, present only when the pipeline was
+ * `worldX`/`worldY`/`worldZ` are meters, present only when the pipeline was
  * asked for world coordinates - a Pop with `depthMap` and a component with
  * `toWorld` - and only in prediction v2. A point the worker could not place -
  * sky, outside the depth map, no usable map - carries none of the three rather
@@ -863,7 +863,7 @@ interface Quaternion {
     y: number;
     z: number;
 }
-/** A translation in metres. */
+/** A translation in meters. */
 interface Vector3d {
     x: number;
     y: number;
@@ -927,6 +927,11 @@ interface WorkerSession extends Session {
      * Configure transient sessions with `WorkerOptions.pop`.
      */
     readonly popId: string;
+    /**
+     * The account the compute session runs and is billed under. A worker endpoint
+     * created from this session names it when it creates a compute session.
+     */
+    readonly accountId?: string | undefined;
     readonly baseUrl: string | undefined;
     /**
      * Transient sessions may not have a pipeline until the first source is processed.
@@ -1037,6 +1042,7 @@ interface InferenceComponent extends BaseComponent {
     confidenceThreshold?: number;
     topK?: number;
     topKClasses?: number;
+    classes?: string[];
     targetFps?: string;
     videoChunkLengthSeconds?: number;
     videoChunkOverlap?: number;
@@ -1180,6 +1186,16 @@ interface ProcessParams {
      * however wrong the guess was.
      */
     camera?: Camera | undefined;
+    /**
+     * Build RTSP SETUP URLs the pre-RFC-2326 way, by appending the SDP control
+     * attribute to the stream URL. Applies to an `rtsp:` source only.
+     *
+     * Leave unset unless a camera will not open without it. The compliant
+     * construction is what a camera advertising an absolute control URL needs -
+     * Axis does - and forcing the old one gives such a camera a URL with the
+     * address in it twice, which it answers 404.
+     */
+    rtspForceNonCompliantUrl?: boolean | undefined;
 }
 interface ProcessRequest extends ProcessParams {
     source: Source;
@@ -1384,6 +1400,12 @@ interface WorkerOptions extends Options {
     popId?: string | TransientPopId | undefined;
     sessionUuid?: string | undefined;
     sessionName?: string | undefined;
+    /**
+     * The account the compute session runs and is billed under, sent to compute-api as
+     * `account_uuid`. Required when the credential does not name one account.
+     * Defaults to process.env['EYEPOP_ACCOUNT_UUID'], then the deprecated process.env['EYEPOP_ACCOUNT_ID'].
+     */
+    accountId?: string | undefined;
     pipelineImage?: string | undefined;
     pipelineVersion?: string | undefined;
     pop?: Pop | undefined;
@@ -1399,6 +1421,7 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private _popName;
     private _sessionAccessToken;
     private _sessionAccessTokenValidUntil;
+    private _accountId;
     private _pipeline;
     private _pipelineCreatePromise;
     constructor(options: WorkerOptions);
@@ -1471,7 +1494,7 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
 
 interface DataOptions extends Options {
     /**
-     * Defaults to process.env['EYEPOP_ACCOUNT_ID'].
+     * Defaults to process.env['EYEPOP_ACCOUNT_UUID'], then the deprecated process.env['EYEPOP_ACCOUNT_ID'].
      */
     accountId?: string | undefined;
     disableWs?: boolean | undefined;
@@ -1669,7 +1692,7 @@ interface CloudBox {
  * A decoded point cloud, per object or per scene.
  *
  * Create with decodePointCloud(), cloudOfObject(), cloudOfDepth() or
- * cloudsOfPrediction(). Coordinates are metres, in the frame the source's
+ * cloudsOfPrediction(). Coordinates are meters, in the frame the source's
  * camera extrinsics define (Z up, ground at Z = 0) or the OpenCV camera frame
  * when it supplied none.
  *
@@ -1709,7 +1732,7 @@ declare class PointCloud {
      */
     get placedPoints(): Vector3[];
     /**
-     * Per axis (min, max) in metres over the placed points, or undefined if none were.
+     * Per axis (min, max) in meters over the placed points, or undefined if none were.
      *
      * The counterpart to DepthMap's finiteMin/finiteMax, which are one axis
      * because a depth map has one value per pixel.
@@ -1805,6 +1828,25 @@ declare function randomMultipartBoundary(): string;
  */
 declare function encodeMultipartFormData(parts: MultipartPart[], boundary: string): ReadableStream<Uint8Array>;
 
+/**
+ * A compute-api request that failed. `status` is the HTTP status and `code` the
+ * compute-api error code (for example `VAL_001` when no account can be derived
+ * for a new session), when the response carried one. The message stays the
+ * readable one callers already see.
+ */
+declare class ComputeApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    constructor(message: string, status: number, code?: string);
+}
+/** A compute session picked by uuid runs under another account than the one configured. */
+declare class ComputeAccountMismatchError extends Error {
+    readonly sessionUuid: string;
+    readonly sessionAccountId: string | undefined;
+    readonly accountId: string;
+    constructor(sessionUuid: string, sessionAccountId: string | undefined, accountId: string);
+}
+
 type UploadBody = ReadableStream<Uint8Array> | Blob | BufferSource;
 declare class AbstractJob implements ResultStream {
     protected _getSession: () => Promise<WorkerSession>;
@@ -1930,8 +1972,8 @@ declare namespace EyePop {
      * @deprecated use workerEndpoint() instead
      */
     const endpoint: typeof workerEndpoint;
-    function workerEndpoint(opts?: WorkerOptions): WorkerEndpoint;
+    function workerEndpoint(options?: WorkerOptions): WorkerEndpoint;
     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 Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, 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 DepthSemantic, 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, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, 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, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, 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, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };
+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 Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, 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 DepthSemantic, 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, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, 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, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, 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, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };

package/dist/eyepop.index.d.ts

@@ -126,9 +126,9 @@ interface Mask {
  * "unknown" included - so an absent member means a worker that predates the
  * field rather than a map that declined to say:
  *
- * - "canonical_metric" - metres = value * focal_px / 300, with focal_px scaled
+ * - "canonical_metric" - meters = value * focal_px / 300, with focal_px scaled
  *   to the map's own resolution
- * - "metric" - the value is already metres
+ * - "metric" - the value is already meters
  * - "relative" - scale- AND shift-invariant, so ordering is meaningful but
  *   distance is not. Not back-projectable: recovering a cloud from it yields a
  *   distorted scene rather than a scaled one
@@ -169,7 +169,7 @@ interface PredictedObject extends PredictedClass {
 /**
  * A point in source pixels, optionally placed in 3D.
  *
- * `worldX`/`worldY`/`worldZ` are metres, present only when the pipeline was
+ * `worldX`/`worldY`/`worldZ` are meters, present only when the pipeline was
  * asked for world coordinates - a Pop with `depthMap` and a component with
  * `toWorld` - and only in prediction v2. A point the worker could not place -
  * sky, outside the depth map, no usable map - carries none of the three rather
@@ -863,7 +863,7 @@ interface Quaternion {
     y: number;
     z: number;
 }
-/** A translation in metres. */
+/** A translation in meters. */
 interface Vector3d {
     x: number;
     y: number;
@@ -927,6 +927,11 @@ interface WorkerSession extends Session {
      * Configure transient sessions with `WorkerOptions.pop`.
      */
     readonly popId: string;
+    /**
+     * The account the compute session runs and is billed under. A worker endpoint
+     * created from this session names it when it creates a compute session.
+     */
+    readonly accountId?: string | undefined;
     readonly baseUrl: string | undefined;
     /**
      * Transient sessions may not have a pipeline until the first source is processed.
@@ -1037,6 +1042,7 @@ interface InferenceComponent extends BaseComponent {
     confidenceThreshold?: number;
     topK?: number;
     topKClasses?: number;
+    classes?: string[];
     targetFps?: string;
     videoChunkLengthSeconds?: number;
     videoChunkOverlap?: number;
@@ -1180,6 +1186,16 @@ interface ProcessParams {
      * however wrong the guess was.
      */
     camera?: Camera | undefined;
+    /**
+     * Build RTSP SETUP URLs the pre-RFC-2326 way, by appending the SDP control
+     * attribute to the stream URL. Applies to an `rtsp:` source only.
+     *
+     * Leave unset unless a camera will not open without it. The compliant
+     * construction is what a camera advertising an absolute control URL needs -
+     * Axis does - and forcing the old one gives such a camera a URL with the
+     * address in it twice, which it answers 404.
+     */
+    rtspForceNonCompliantUrl?: boolean | undefined;
 }
 interface ProcessRequest extends ProcessParams {
     source: Source;
@@ -1384,6 +1400,12 @@ interface WorkerOptions extends Options {
     popId?: string | TransientPopId | undefined;
     sessionUuid?: string | undefined;
     sessionName?: string | undefined;
+    /**
+     * The account the compute session runs and is billed under, sent to compute-api as
+     * `account_uuid`. Required when the credential does not name one account.
+     * Defaults to process.env['EYEPOP_ACCOUNT_UUID'], then the deprecated process.env['EYEPOP_ACCOUNT_ID'].
+     */
+    accountId?: string | undefined;
     pipelineImage?: string | undefined;
     pipelineVersion?: string | undefined;
     pop?: Pop | undefined;
@@ -1399,6 +1421,7 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private _popName;
     private _sessionAccessToken;
     private _sessionAccessTokenValidUntil;
+    private _accountId;
     private _pipeline;
     private _pipelineCreatePromise;
     constructor(options: WorkerOptions);
@@ -1471,7 +1494,7 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
 
 interface DataOptions extends Options {
     /**
-     * Defaults to process.env['EYEPOP_ACCOUNT_ID'].
+     * Defaults to process.env['EYEPOP_ACCOUNT_UUID'], then the deprecated process.env['EYEPOP_ACCOUNT_ID'].
      */
     accountId?: string | undefined;
     disableWs?: boolean | undefined;
@@ -1669,7 +1692,7 @@ interface CloudBox {
  * A decoded point cloud, per object or per scene.
  *
  * Create with decodePointCloud(), cloudOfObject(), cloudOfDepth() or
- * cloudsOfPrediction(). Coordinates are metres, in the frame the source's
+ * cloudsOfPrediction(). Coordinates are meters, in the frame the source's
  * camera extrinsics define (Z up, ground at Z = 0) or the OpenCV camera frame
  * when it supplied none.
  *
@@ -1709,7 +1732,7 @@ declare class PointCloud {
      */
     get placedPoints(): Vector3[];
     /**
-     * Per axis (min, max) in metres over the placed points, or undefined if none were.
+     * Per axis (min, max) in meters over the placed points, or undefined if none were.
      *
      * The counterpart to DepthMap's finiteMin/finiteMax, which are one axis
      * because a depth map has one value per pixel.
@@ -1805,6 +1828,25 @@ declare function randomMultipartBoundary(): string;
  */
 declare function encodeMultipartFormData(parts: MultipartPart[], boundary: string): ReadableStream<Uint8Array>;
 
+/**
+ * A compute-api request that failed. `status` is the HTTP status and `code` the
+ * compute-api error code (for example `VAL_001` when no account can be derived
+ * for a new session), when the response carried one. The message stays the
+ * readable one callers already see.
+ */
+declare class ComputeApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    constructor(message: string, status: number, code?: string);
+}
+/** A compute session picked by uuid runs under another account than the one configured. */
+declare class ComputeAccountMismatchError extends Error {
+    readonly sessionUuid: string;
+    readonly sessionAccountId: string | undefined;
+    readonly accountId: string;
+    constructor(sessionUuid: string, sessionAccountId: string | undefined, accountId: string);
+}
+
 type UploadBody = ReadableStream<Uint8Array> | Blob | BufferSource;
 declare class AbstractJob implements ResultStream {
     protected _getSession: () => Promise<WorkerSession>;
@@ -1930,8 +1972,8 @@ declare namespace EyePop {
      * @deprecated use workerEndpoint() instead
      */
     const endpoint: typeof workerEndpoint;
-    function workerEndpoint(opts?: WorkerOptions): WorkerEndpoint;
+    function workerEndpoint(options?: WorkerOptions): WorkerEndpoint;
     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 Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, 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 DepthSemantic, 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, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, 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, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, 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, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };
+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 Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, 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 DepthSemantic, 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, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, 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, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, 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, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };

package/dist/eyepop.index.js

@@ -8667,6 +8667,8 @@ __export(index_exports, {
   AutoAnnotateStatus: () => AutoAnnotateStatus,
   AutoAnnotateTask: () => AutoAnnotateTask,
   ChangeType: () => ChangeType,
+  ComputeAccountMismatchError: () => ComputeAccountMismatchError,
+  ComputeApiError: () => ComputeApiError,
   ContourType: () => ContourType,
   DEFAULT_PREDICTION_VERSION: () => DEFAULT_PREDICTION_VERSION,
   DataApiType: () => DataApiType,
@@ -8778,6 +8780,9 @@ function pipelineIdFromSession(session) {
 }
 function sessionCreateBody(options) {
   const body = {};
+  if (options.accountId) {
+    body.account_uuid = options.accountId;
+  }
   if (options.sessionName) {
     body.session_name = options.sessionName;
   }
@@ -8827,6 +8832,42 @@ function pipelineErrorMessage(session) {
   }
   return null;
 }
+var ComputeApiError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "ComputeApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var ComputeAccountMismatchError = class extends Error {
+  constructor(sessionUuid, sessionAccountId, accountId) {
+    super(`Compute session ${sessionUuid} runs under account ${sessionAccountId || "(none)"}, not the configured account ${accountId}`);
+    this.name = "ComputeAccountMismatchError";
+    this.sessionUuid = sessionUuid;
+    this.sessionAccountId = sessionAccountId;
+    this.accountId = accountId;
+  }
+};
+async function computeApiError(response, action) {
+  const code = await responseErrorCode(response);
+  const message = await responseErrorMessage(response);
+  return new ComputeApiError(`Unexpected status ${response.status} ${action}: ${message}`, response.status, code);
+}
+async function responseErrorCode(response) {
+  try {
+    const parsed = normalizedJsonValue(await response.clone().json());
+    if (!parsed || typeof parsed != "object") {
+      return void 0;
+    }
+    const record = parsed;
+    const nested = normalizedJsonValue(record["error"]);
+    const code = nested && typeof nested == "object" ? nested["code"] : record["code"];
+    return typeof code == "string" && code.length > 0 ? code : void 0;
+  } catch (_) {
+    return void 0;
+  }
+}
 async function responseErrorMessage(response) {
   const contentType = response.headers.get("content-type") || "";
   if (contentType.includes("application/json")) {
@@ -8930,8 +8971,7 @@ var ComputeSessionClient = class {
       if (response.status == 404) {
         sessions = [];
       } else if (response.status != 200) {
-        const message = await responseErrorMessage(response);
-        throw new Error(`Unexpected status ${response.status} fetching compute sessions: ${message}`);
+        throw await computeApiError(response, "fetching compute sessions");
       } else {
         const response_content = await responseJson(response);
         sessions = response_content;
@@ -8939,7 +8979,7 @@ var ComputeSessionClient = class {
       if (sessions.length > 0) {
         this.options.logger?.debug(`User has ${sessions.length} sessions, inspecting for usable session`);
         for (let s of sessions) {
-          if (!SESSION_DEAD.has(s.session_status) && !s.persistent && (!this.options.sessionName || s.session_name === this.options.sessionName)) {
+          if (!SESSION_DEAD.has(s.session_status) && !s.persistent && (!this.options.sessionName || s.session_name === this.options.sessionName) && (!this.options.accountId || s.account_uuid === this.options.accountId)) {
             session = s;
             this.options.logger?.debug(`Use active session ${s.session_uuid} with pipeline ${pipelineIdFromSession(s)}`);
             break;
@@ -8964,8 +9004,7 @@ var ComputeSessionClient = class {
       const query = "wait=true";
       const response = await this.options.httpClient.fetch(`${sessionsUrl}?${query}`, request);
       if (response.status != 200) {
-        const message = await responseErrorMessage(response);
-        throw new Error(`Unexpected status ${response.status} creating a compute session: ${message}`);
+        throw await computeApiError(response, "creating a compute session");
       } else {
         sessions = await responseJson(response);
       }
@@ -8990,14 +9029,16 @@ var ComputeSessionClient = class {
       headers
     });
     if (response.status == 404) {
-      throw new Error(`Unexpected status ${response.status} compute sessions ${sessionUuid} not found`);
+      throw new ComputeApiError(`Unexpected status ${response.status} compute sessions ${sessionUuid} not found`, response.status);
     } else if (response.status != 200) {
-      const message = await responseErrorMessage(response);
-      throw new Error(`Unexpected status ${response.status} fetching compute sessions: ${message}`);
+      throw await computeApiError(response, "fetching compute sessions");
     } else {
       const response_content = await responseJson(response);
       session = response_content;
     }
+    if (this.options.accountId && session.account_uuid !== this.options.accountId) {
+      throw new ComputeAccountMismatchError(sessionUuid, session.account_uuid, this.options.accountId);
+    }
     return session;
   }
   async sessionAuthorizationHeader(session) {
@@ -10094,7 +10135,10 @@ var LoadFromJob = class extends AbstractJob {
       roi: this._params.roi,
       fps: this._params.fps,
       camera: this._params.camera,
-      version: this._version
+      version: this._version,
+      // undefined is dropped by JSON.stringify, so an unset option leaves
+      // the worker's own default to decide rather than pinning it here.
+      rtspForceNonCompliantUrl: this._params.rtspForceNonCompliantUrl
     };
     if (this._params.motionDetect) {
       Object.assign(body, this._params.motionDetect);
@@ -10848,6 +10892,7 @@ var _WorkerEndpoint = class _WorkerEndpoint extends Endpoint {
     this._popName = null;
     this._sessionAccessToken = null;
     this._sessionAccessTokenValidUntil = null;
+    this._accountId = void 0;
     this._pipeline = null;
     this._pipelineCreatePromise = null;
   }
@@ -10897,6 +10942,7 @@ var _WorkerEndpoint = class _WorkerEndpoint extends Endpoint {
       accessToken: session.accessToken,
       validUntil: session.validUntil,
       popId: this.options().popId,
+      accountId: this._accountId ?? this.options().accountId,
       baseUrl: this._baseUrl,
       pipelineId: this._pipelineId || void 0,
       authenticationHeaders: () => this._authenticationHeaders(session)
@@ -11452,6 +11498,7 @@ var _WorkerEndpoint = class _WorkerEndpoint extends Endpoint {
         authorizationHeader: () => this.computeAuthorizationHeader(),
         sessionUuid: this.options().sessionUuid,
         sessionName: this.options().sessionName,
+        accountId: this.options().accountId,
         pipelineImage: this.options().pipelineImage,
         pipelineVersion: this.options().pipelineVersion,
         pop: this.options().pop,
@@ -11466,6 +11513,7 @@ var _WorkerEndpoint = class _WorkerEndpoint extends Endpoint {
     this._sessionAccessToken = resolved.accessToken;
     this._sessionAccessTokenValidUntil = resolved.accessTokenValidUntil;
     this._baseUrl = resolved.session.session_endpoint;
+    this._accountId = resolved.session.account_uuid || void 0;
     this._pipeline = null;
     this._pipelineId = resolved.pipelineId;
     if (this.options().pop) {
@@ -13089,7 +13137,7 @@ var PointCloud = class {
     return placed;
   }
   /**
-   * Per axis (min, max) in metres over the placed points, or undefined if none were.
+   * Per axis (min, max) in meters over the placed points, or undefined if none were.
    *
    * The counterpart to DepthMap's finiteMin/finiteMax, which are one axis
    * because a depth map has one value per pixel.
@@ -13268,6 +13316,19 @@ var readEnv = (env) => {
   }
   return void 0;
 };
+var warnedAccountIdEnv = false;
+var readAccountUuidEnv = () => {
+  const accountUuid = readEnv("EYEPOP_ACCOUNT_UUID");
+  if (accountUuid !== void 0) {
+    return accountUuid;
+  }
+  const accountId = readEnv("EYEPOP_ACCOUNT_ID");
+  if (accountId !== void 0 && !warnedAccountIdEnv) {
+    warnedAccountIdEnv = true;
+    console.warn("EYEPOP_ACCOUNT_ID is deprecated, use EYEPOP_ACCOUNT_UUID instead");
+  }
+  return accountId;
+};
 var stringToBooleanSafe = (str) => {
   if (typeof str == "undefined") {
     return false;
@@ -13282,7 +13343,8 @@ var EyePop;
     apiKey: envApiKey
   } : void 0;
   EyePop2.endpoint = workerEndpoint;
-  function workerEndpoint(opts = {}) {
+  function workerEndpoint(options = {}) {
+    const opts = { ...options };
     if (opts.pop !== void 0) {
       validatePop(opts.pop);
     }
@@ -13306,6 +13368,9 @@ var EyePop;
     if (opts.sessionName === void 0) {
       opts.sessionName = readEnv("EYEPOP_SESSION_NAME");
     }
+    if (opts.accountId === void 0) {
+      opts.accountId = readAccountUuidEnv();
+    }
     if (opts.pipelineImage === void 0) {
       opts.pipelineImage = readEnv("EYEPOP_PIPELINE_IMAGE");
     }
@@ -13328,6 +13393,9 @@ var EyePop;
           if (auth.session.popId) {
             opts.popId = auth.session.popId;
           }
+          if (auth.session.accountId) {
+            opts.accountId = auth.session.accountId;
+          }
         }
       }
     }
@@ -13341,7 +13409,7 @@ var EyePop;
       throw new Error("apiKey/accessToken/session/oAuth2 option or EYEPOP_API_KEY environment variable is required");
     }
     if (opts.accountId === void 0) {
-      opts.accountId = readEnv("EYEPOP_ACCOUNT_ID");
+      opts.accountId = readAccountUuidEnv();
     }
     if (auth.session !== void 0) {
       if (auth.session !== void 0) {
@@ -13412,6 +13480,8 @@ var index_default = EyePop;
   AutoAnnotateStatus,
   AutoAnnotateTask,
   ChangeType,
+  ComputeAccountMismatchError,
+  ComputeApiError,
   ContourType,
   DEFAULT_PREDICTION_VERSION,
   DataApiType,