mixpeek 0.81.1

package/dist/models/batch-error-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-error-detail.d.ts","sourceRoot":"","sources":["../../models/batch-error-detail.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,YAAY,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;CACxC"}

package/dist/models/batch-model.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { BatchProgress } from './batch-progress';
+import type { BatchType } from './batch-type';
+import type { TaskStatusEnum } from './task-status-enum';
+import type { TierTaskInfo } from './tier-task-info';
+/**
+ * Model representing a batch of objects for processing through collections.  A batch groups bucket objects together for processing through one or more collections. Batches support multi-tier processing where collections are processed in dependency order (e.g., bucket → chunks → frames → scenes). Each tier has independent task tracking.  Use Cases:     - Process multiple objects through collections in a single batch     - Track progress of multi-tier decomposition pipelines     - Monitor and retry individual processing tiers     - Query batch status and tier-specific task information  Lifecycle:     1. Created in DRAFT status with object_ids     2. Submitted for processing → status changes to PENDING     3. Each tier processes sequentially (tier 0 → tier 1 → ... → tier N)     4. Batch completes when all tiers finish (status=COMPLETED) or any tier fails (status=FAILED)  Multi-Tier Processing:     - Tier 0: Bucket objects → Collections (bucket as source)     - Tier N (N > 0): Collection documents → Collections (upstream collection as source)     - Each tier gets independent task tracking via tier_tasks array     - Processing proceeds tier-by-tier with automatic chaining  Requirements:     - batch_id: OPTIONAL (auto-generated if not provided)     - bucket_id: REQUIRED     - status: OPTIONAL (defaults to DRAFT)     - object_ids: REQUIRED for processing (must have at least 1 object)     - collection_ids: OPTIONAL (discovered via DAG resolution)     - tier_tasks: OPTIONAL (populated during processing)     - current_tier: OPTIONAL (set during processing)     - total_tiers: OPTIONAL (defaults to 1, set during DAG resolution)     - dag_tiers: OPTIONAL (populated during DAG resolution)
+ * @export
+ * @interface BatchModel
+ */
+export interface BatchModel {
+    /**
+     * OPTIONAL (auto-generated if not provided). Unique identifier for this batch. Format: \'btch_\' prefix followed by 12-character secure token. Generated using generate_secure_token() from shared.utilities.helpers. Used to query batch status and track processing across tiers. Immutable after creation.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'batch_id'?: string;
+    /**
+     * REQUIRED. Unique identifier of the bucket containing the objects to process. Must be a valid bucket ID that exists in the system. All object_ids must belong to this bucket. Format: Bucket ID as defined when bucket was created.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'bucket_id': string;
+    /**
+     * OPTIONAL (defaults to DRAFT). Current processing status of the batch. Lifecycle: DRAFT → PENDING → IN_PROGRESS → COMPLETED/FAILED. DRAFT: Batch created but not yet submitted. PENDING: Batch submitted and queued for processing. IN_PROGRESS: Batch currently processing (one or more tiers active). COMPLETED: All tiers successfully completed. FAILED: One or more tiers failed. Aggregated from tier_tasks statuses during multi-tier processing.
+     * @type {TaskStatusEnum}
+     * @memberof BatchModel
+     */
+    'status'?: TaskStatusEnum;
+    /**
+     * List of object IDs to include in this batch. All objects must exist in the specified bucket_id. These objects are the source data for tier 0 processing. Collection-sourced batches may have empty object_ids. Objects are processed in parallel within each tier.
+     * @type {Array<string>}
+     * @memberof BatchModel
+     */
+    'object_ids'?: Array<string>;
+    /**
+     * OPTIONAL. List of all collection IDs involved in this batch\'s processing. Automatically populated during DAG resolution from dag_tiers. Includes collections from all tiers (flattened view of dag_tiers). Used for quick lookups without traversing tier structure. Format: List of collection IDs across all tiers.
+     * @type {Array<string>}
+     * @memberof BatchModel
+     */
+    'collection_ids'?: Array<string>;
+    /**
+     * OPTIONAL. Legacy error message field for backward compatibility. None if batch succeeded or is still processing. Contains human-readable error description from first failed tier. DEPRECATED: Use tier_tasks[].errors for detailed error information. For multi-tier batches, typically contains the error from the first failed tier. Check tier_tasks array for tier-specific error details and error_summary for aggregation.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'error'?: string;
+    /**
+     * OPTIONAL. Human-readable explanation of why the batch failed. None if batch succeeded, is still processing, or is in DRAFT/PENDING state. Populated automatically when a batch transitions to FAILED status. Provides a concise, actionable summary of the root cause. Common reasons include: Ray job failure (spot preemption, OOM, code errors), 0 documents written (processing completed but produced no output), processing stall (no activity detected for extended period), or Celery task exception (submission/validation failures). Use this field for user-facing error displays and alerting.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'failure_reason'?: string;
+    /**
+     * OPTIONAL. Aggregated summary of errors across ALL tiers in the batch. None if batch succeeded or is still processing. Maps error_type (category) to total count of affected documents across all tiers. Provides quick batch-wide overview of error distribution. Example: {\'dependency\': 15, \'authentication\': 25, \'validation\': 5} means across all tiers, 15 documents failed with dependency errors, 25 with auth errors, 5 with validation errors. Automatically aggregated from tier_tasks[].error_summary. Used for batch health dashboard and error trend analysis.
+     * @type {{ [key: string]: number; }}
+     * @memberof BatchModel
+     */
+    'error_summary'?: {
+        [key: string]: number;
+    };
+    /**
+     * OPTIONAL (defaults to BUCKET). Type of batch. BUCKET: Standard batch processing bucket objects through collections. COLLECTION: Reserved for future collection-only batch processing. Currently only BUCKET type is supported.
+     * @type {BatchType}
+     * @memberof BatchModel
+     */
+    'type'?: BatchType;
+    /**
+     * OPTIONAL. S3 key where the batch manifest is stored. Contains metadata and row data (Parquet) for Engine processing. For tier 0, points to bucket object manifest. For tier N+, points to collection document manifest. Format: S3 path (e.g., \'namespace_id/internal_id/manifests/tier_0.parquet\'). Generated during batch submission.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'manifest_key'?: string;
+    /**
+     * OPTIONAL. Primary task ID for the batch (typically tier 0 task). Used for backward compatibility with single-tier batch tracking. For multi-tier batches, prefer querying tier_tasks array for granular tracking. Format: Task ID as generated for tier 0.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'task_id'?: string;
+    /**
+     * OPTIONAL. List of object IDs that were successfully validated and loaded into the batch. Subset of object_ids that passed validation. Used to track which objects are ready for processing. None if batch hasn\'t been validated yet.
+     * @type {Array<string>}
+     * @memberof BatchModel
+     */
+    'loaded_object_ids'?: Array<string>;
+    /**
+     * OPTIONAL. Internal engine/job metadata for system use. May contain: job_id (provider-specific), engine_version, processing hints, last_health_check. last_health_check: Most recent health check results with health_status, enriched_documents, vector_populated_count, stall_duration_seconds, recommendations, missing_features. Populated asynchronously via Celery task (non-blocking, best-effort). Used for troubleshooting batch processing issues via API. NOTE: In MongoDB, this is stored under \'_internal.processing\' path.
+     * @type {{ [key: string]: any; }}
+     * @memberof BatchModel
+     */
+    'internal_metadata'?: {
+        [key: string]: any;
+    };
+    /**
+     * OPTIONAL. User-defined metadata for the batch. Arbitrary key-value pairs for user tracking and organization. Persisted with the batch and returned in API responses. Not used by the system for processing logic. Examples: campaign_id, user_email, processing_notes.
+     * @type {{ [key: string]: any; }}
+     * @memberof BatchModel
+     */
+    'metadata'?: {
+        [key: string]: any;
+    };
+    /**
+     * OPTIONAL. List of tier task tracking information for multi-tier processing. Each element represents one tier in the processing pipeline. Empty array for simple single-tier batches. Populated during batch submission with tier 0 info, then appended as tiers progress. Each TierTaskInfo contains: tier_num, task_id, status, collection_ids, timestamps. Used for granular monitoring: \'Show me status of tier 2\' or \'Retry tier 1\'. Array index typically matches tier_num (tier_tasks[0] = tier 0, tier_tasks[1] = tier 1, etc.).
+     * @type {Array<TierTaskInfo>}
+     * @memberof BatchModel
+     */
+    'tier_tasks'?: Array<TierTaskInfo>;
+    /**
+     * OPTIONAL. Zero-based index of the currently processing tier. None if batch hasn\'t started processing (status=DRAFT or PENDING). Updated as batch progresses through tiers. Used to show processing progress: \'Processing tier 2 of 5\'. Set to last tier number when batch completes. Example: If processing tier 1 (frames), current_tier=1.
+     * @type {number}
+     * @memberof BatchModel
+     */
+    'current_tier'?: number;
+    /**
+     * OPTIONAL (defaults to 1). Total number of tiers in the collection DAG. Minimum 1 (tier 0 only = bucket → collection). Set during DAG resolution when batch is submitted. Equals len(dag_tiers) if dag_tiers is populated. Used to calculate progress: current_tier / total_tiers. Example: 5-tier pipeline (bucket → chunks → frames → scenes → summaries) has total_tiers=5.
+     * @type {number}
+     * @memberof BatchModel
+     */
+    'total_tiers'?: number;
+    /**
+     * OPTIONAL. Complete DAG tier structure for this batch. List of tiers, where each tier is a list of collection IDs to process at that stage. Tier 0 = bucket-sourced collections. Tier N (N > 0) = collection-sourced collections. Collections within same tier have no dependencies (can run in parallel). Collections in tier N+1 depend on collections in tier N. Populated during DAG resolution at batch submission. Used for tier-by-tier processing orchestration. Example: [[\'col_chunks\'], [\'col_frames\', \'col_objects\'], [\'col_scenes\']] = 3 tiers where frames and objects run in parallel at tier 1.
+     * @type {Array<Array<string>>}
+     * @memberof BatchModel
+     */
+    'dag_tiers'?: Array<Array<string>>;
+    /**
+     * OPTIONAL (auto-set on creation). ISO 8601 timestamp when batch was created. Set using current_time() from shared.utilities.helpers. Immutable after creation. Used for batch age tracking and cleanup of old batches.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'created_at'?: string;
+    /**
+     * OPTIONAL. Live progress snapshot updated approximately every 10 seconds while the batch is IN_PROGRESS. Written by the Ray ProgressActor inside the engine job. None when status is DRAFT or PENDING (job not started), or after COMPLETED/FAILED. Use this to show real-time progress bars: processed/total objects, percent complete, throughput (items_per_second), and estimated time remaining (eta_seconds).
+     * @type {BatchProgress}
+     * @memberof BatchModel
+     */
+    'progress'?: BatchProgress;
+    /**
+     * OPTIONAL. Computed health status for actively processing batches. Only populated when status is PROCESSING or IN_PROGRESS. Values: \'healthy\' (recent activity detected), \'stalled\' (no activity for 5+ minutes), \'unknown\' (no heartbeat data yet). Computed from tier_tasks[].last_activity_at and updated_at. Use this to detect stuck batches before the internal stall detector kills them.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'health'?: string;
+    /**
+     * OPTIONAL. Timestamp of the most recent activity across all tier tasks. Aggregated from tier_tasks[].last_activity_at — the latest heartbeat from any tier. Updated approximately every 10 seconds by the BatchJobPoller while processing. A stale value (minutes old) while status is PROCESSING indicates the batch may be stalled. None for batches that have not started processing or have no heartbeat data.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'last_activity_at'?: string;
+    /**
+     * OPTIONAL (defaults to 0). Number of times this batch has been auto-retried due to transient infrastructure failures (spot node preemption, OOM, actor death). Incremented each time the batch is automatically requeued after a retryable failure. User-facing: lets users see that retries happened transparently.
+     * @type {number}
+     * @memberof BatchModel
+     */
+    'retry_count'?: number;
+    /**
+     * OPTIONAL (defaults to 3). Maximum number of automatic retries for transient failures. When retry_count reaches max_retries, the batch stays in FAILED state. Only transient/infrastructure failures trigger retries — validation and data errors do not.
+     * @type {number}
+     * @memberof BatchModel
+     */
+    'max_retries'?: number;
+    /**
+     * OPTIONAL. ISO 8601 timestamp of the most recent auto-retry attempt. None if the batch has never been retried. Used to calculate exponential backoff for subsequent retries.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'last_retry_at'?: string;
+    /**
+     * OPTIONAL. Human-readable reason for the most recent auto-retry. None if the batch has never been retried. Describes the transient failure that triggered the retry (e.g., \'Spot node preempted\', \'Ray actor died\', \'OOM killed\').
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'retry_reason'?: string;
+    /**
+     * OPTIONAL. URL to receive an HTTP POST notification when the batch reaches a terminal state (COMPLETED, FAILED, or CANCELED). Set at submit time via SubmitBatchRequest. The webhook is fire-and-forget: delivery failures are logged but never affect batch processing.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'webhook_url'?: string;
+    /**
+     * OPTIONAL (auto-updated). ISO 8601 timestamp when batch was last modified. Updated using current_time() whenever batch status or tier_tasks change. Used to track batch activity and identify stale batches.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'updated_at'?: string;
+    /**
+     * COMPUTED. Human-readable description of the current batch state. Examples: \'Processing 724/50,000 objects (1.4%)\', \'Queued — 2 batches ahead\', \'Completed in 5m 23s\', \'Loading model (stage 1/3)\'. Computed on read, not stored in the database.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'status_message'?: string;
+    /**
+     * COMPUTED. Estimated completion timestamp based on current throughput. Derived from progress.eta_seconds + now. None if throughput data is unavailable. Computed on read, not stored in the database.
+     * @type {string}
+     * @memberof BatchModel
+     */
+    'estimated_completion'?: string;
+}
+//# sourceMappingURL=batch-model.d.ts.map

package/dist/models/batch-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-model.d.ts","sourceRoot":"","sources":["../../models/batch-model.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KAAE,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/models/batch-options.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Options for batch processing in migration.
+ * @export
+ * @interface BatchOptions
+ */
+export interface BatchOptions {
+    /**
+     * Documents per batch
+     * @type {number}
+     * @memberof BatchOptions
+     */
+    'batch_size'?: number;
+    /**
+     * Maximum parallel workers
+     * @type {number}
+     * @memberof BatchOptions
+     */
+    'max_workers'?: number;
+    /**
+     * Retry failed batches
+     * @type {boolean}
+     * @memberof BatchOptions
+     */
+    'retry_failed'?: boolean;
+}
+//# sourceMappingURL=batch-options.d.ts.map

package/dist/models/batch-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-options.d.ts","sourceRoot":"","sources":["../../models/batch-options.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/models/batch-progress.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { BatchStageInfo } from './batch-stage-info';
+/**
+ * Live progress snapshot written by ProgressPoller every ~10 seconds while a batch is IN_PROGRESS.  Populated by the Ray ProgressActor running inside the engine job. None when the batch has not started processing yet (DRAFT/PENDING) or if the engine image pre-dates this field.
+ * @export
+ * @interface BatchProgress
+ */
+export interface BatchProgress {
+    /**
+     * Number of objects fully processed so far.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'processed'?: number;
+    /**
+     * Total objects to process. None until the dataset is loaded by the engine.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'total'?: number;
+    /**
+     * Completion percentage (0–100). None until total is known.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'percent'?: number;
+    /**
+     * Current throughput. Averaged over elapsed time since job start.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'items_per_second'?: number;
+    /**
+     * Estimated seconds remaining. None until both total and throughput are known.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'eta_seconds'?: number;
+    /**
+     * Number of Ray map_batch micro-batches completed.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'batch_count'?: number;
+    /**
+     * Number of items that errored during processing.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'errors'?: number;
+    /**
+     * Current processing stage as reported by the Ray engine. Populated once the engine begins work (may lag by ~10s). Useful to distinguish \'loading model\' from \'no activity\' during early processing.
+     * @type {BatchStageInfo}
+     * @memberof BatchProgress
+     */
+    'current_stage'?: BatchStageInfo;
+    /**
+     * 1-based position in the Ray job submission queue. Non-null only while the batch is waiting for a concurrency slot. Once a slot is acquired (job submitted to Ray), this becomes null.
+     * @type {number}
+     * @memberof BatchProgress
+     */
+    'queue_position'?: number;
+}
+//# sourceMappingURL=batch-progress.d.ts.map

package/dist/models/batch-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-progress.d.ts","sourceRoot":"","sources":["../../models/batch-progress.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/models/batch-stage-info.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Current processing stage reported by the Ray engine.  Stages progress from \"loading\" (model init) → \"processing\" (inference) → \"writing\" (Qdrant). The stage name resets the stall timer, so users can see *what* the job is doing even when processed=0 (e.g., waiting for a 3.5 GB model to load).
+ * @export
+ * @interface BatchStageInfo
+ */
+export interface BatchStageInfo {
+    /**
+     * Stage name: \'loading\', \'processing\', \'writing\', or a custom extractor stage.
+     * @type {string}
+     * @memberof BatchStageInfo
+     */
+    'name': string;
+    /**
+     * 1-based stage index within the current job.
+     * @type {number}
+     * @memberof BatchStageInfo
+     */
+    'index': number;
+    /**
+     * Total stages in the current job.
+     * @type {number}
+     * @memberof BatchStageInfo
+     */
+    'total': number;
+    /**
+     * Seconds spent in this stage so far.
+     * @type {number}
+     * @memberof BatchStageInfo
+     */
+    'stage_elapsed_seconds': number;
+}
+//# sourceMappingURL=batch-stage-info.d.ts.map

package/dist/models/batch-stage-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-stage-info.d.ts","sourceRoot":"","sources":["../../models/batch-stage-info.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACnC"}

package/dist/models/batch-statistics.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Statistics about batches in a bucket.
+ * @export
+ * @interface BatchStatistics
+ */
+export interface BatchStatistics {
+    /**
+     * Total number of batches in this bucket
+     * @type {number}
+     * @memberof BatchStatistics
+     */
+    'total'?: number;
+    /**
+     * Number of batches that are not completed (DRAFT, PENDING, IN_PROGRESS, PROCESSING)
+     * @type {number}
+     * @memberof BatchStatistics
+     */
+    'active'?: number;
+    /**
+     * Number of completed batches
+     * @type {number}
+     * @memberof BatchStatistics
+     */
+    'completed'?: number;
+    /**
+     * Number of failed batches
+     * @type {number}
+     * @memberof BatchStatistics
+     */
+    'failed'?: number;
+}
+//# sourceMappingURL=batch-statistics.d.ts.map

package/dist/models/batch-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-statistics.d.ts","sourceRoot":"","sources":["../../models/batch-statistics.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/models/batch-type.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * The type of batch.
+ * @export
+ * @enum {string}
+ */
+export declare const BatchType: {
+    readonly Bucket: "BUCKET";
+    readonly Collection: "COLLECTION";
+};
+export type BatchType = typeof BatchType[keyof typeof BatchType];
+//# sourceMappingURL=batch-type.d.ts.map

package/dist/models/batch-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-type.d.ts","sourceRoot":"","sources":["../../models/batch-type.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AAEH,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/models/batch-update-documents-request.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { BatchDocumentUpdate } from './batch-document-update';
+import type { LogicalOperatorInput } from './logical-operator-input';
+/**
+ * Request model for batch updating multiple documents by explicit IDs or filters.  Supports TWO modes: 1. Explicit IDs mode: Provide \'updates\' array with document_id + update_data for each 2. Filter mode: Provide \'filters\' + \'update_data\' to update all matching documents  Key difference from BulkUpdateDocumentsRequest: - Batch (this): Can apply DIFFERENT updates to SPECIFIC documents by ID - Bulk: Applies SAME update to ALL documents matching filters  Use Cases:     - Update 5 specific documents with different metadata values     - Update documents by IDs with per-document update control     - Combine with filters for targeted batch updates  Requirements:     - EITHER \'updates\' (explicit mode) OR \'filters\' + \'update_data\' (filter mode)     - NOT BOTH modes simultaneously
+ * @export
+ * @interface BatchUpdateDocumentsRequest
+ */
+export interface BatchUpdateDocumentsRequest {
+    /**
+     * OPTIONAL. List of document updates with explicit document IDs. Each entry specifies document_id and update_data. Use this mode when you know exact document IDs and want per-document control. Mutually exclusive with filters + update_data mode. Maximum 1000 documents per batch request.
+     * @type {Array<BatchDocumentUpdate>}
+     * @memberof BatchUpdateDocumentsRequest
+     */
+    'updates'?: Array<BatchDocumentUpdate>;
+    /**
+     * OPTIONAL. Filter conditions to match documents for update. Must be used with \'update_data\' field. Mutually exclusive with \'updates\' array. If provided, applies same update_data to all matching documents.
+     * @type {LogicalOperatorInput}
+     * @memberof BatchUpdateDocumentsRequest
+     */
+    'filters'?: LogicalOperatorInput;
+    /**
+     * OPTIONAL. Update data to apply when using filters mode. Must be used with \'filters\' field. All matched documents receive the same updates. Can update any document field except vectors.
+     * @type {{ [key: string]: any; }}
+     * @memberof BatchUpdateDocumentsRequest
+     */
+    'update_data'?: {
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=batch-update-documents-request.d.ts.map

package/dist/models/batch-update-documents-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-update-documents-request.d.ts","sourceRoot":"","sources":["../../models/batch-update-documents-request.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;CAC3C"}

package/dist/models/batch-update-documents-response.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { BatchDocumentUpdateResult } from './batch-document-update-result';
+/**
+ * Response model for batch document update operation.  Provides detailed per-document results showing success/failure for each update.
+ * @export
+ * @interface BatchUpdateDocumentsResponse
+ */
+export interface BatchUpdateDocumentsResponse {
+    /**
+     * Total number of documents successfully updated
+     * @type {number}
+     * @memberof BatchUpdateDocumentsResponse
+     */
+    'updated_count': number;
+    /**
+     * Total number of documents that failed to update
+     * @type {number}
+     * @memberof BatchUpdateDocumentsResponse
+     */
+    'failed_count'?: number;
+    /**
+     * Detailed per-document results. Each entry shows document_id, success status, and error message (if failed). Empty list when using filter mode (only counts returned).
+     * @type {Array<BatchDocumentUpdateResult>}
+     * @memberof BatchUpdateDocumentsResponse
+     */
+    'results'?: Array<BatchDocumentUpdateResult>;
+    /**
+     * Summary message of the operation
+     * @type {string}
+     * @memberof BatchUpdateDocumentsResponse
+     */
+    'message'?: string;
+}
+//# sourceMappingURL=batch-update-documents-response.d.ts.map

package/dist/models/batch-update-documents-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-update-documents-response.d.ts","sourceRoot":"","sources":["../../models/batch-update-documents-response.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IACzC;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/models/batch-upload-request.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { CreateUploadRequest } from './create-upload-request';
+/**
+ * Request to generate multiple presigned URLs in a single request.
+ * @export
+ * @interface BatchUploadRequest
+ */
+export interface BatchUploadRequest {
+    /**
+     * List of upload requests (max 100)
+     * @type {Array<CreateUploadRequest>}
+     * @memberof BatchUploadRequest
+     */
+    'uploads': Array<CreateUploadRequest>;
+    /**
+     * Metadata to apply to all uploads (merged with individual metadata)
+     * @type {{ [key: string]: any; }}
+     * @memberof BatchUploadRequest
+     */
+    'shared_metadata'?: {
+        [key: string]: any;
+    };
+    /**
+     * Object metadata to apply to all uploads (merged with individual)
+     * @type {{ [key: string]: any; }}
+     * @memberof BatchUploadRequest
+     */
+    'shared_object_metadata'?: {
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=batch-upload-request.d.ts.map

package/dist/models/batch-upload-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-upload-request.d.ts","sourceRoot":"","sources":["../../models/batch-upload-request.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACtC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;IAC5C;;;;OAIG;IACH,wBAAwB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAAE,CAAC;CACtD"}

package/dist/models/batch-upload-response.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Mixpeek API
+ * This is the Mixpeek API, providing access to various endpoints for data processing and retrieval.
+ *
+ * The version of the OpenAPI document: 0.81.1
+ * Contact: info@mixpeek.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { UploadResponse } from './upload-response';
+/**
+ * Response from batch upload request.
+ * @export
+ * @interface BatchUploadResponse
+ */
+export interface BatchUploadResponse {
+    /**
+     * Generated uploads with presigned URLs
+     * @type {Array<UploadResponse>}
+     * @memberof BatchUploadResponse
+     */
+    'uploads': Array<UploadResponse>;
+    /**
+     * Total number of uploads created
+     * @type {number}
+     * @memberof BatchUploadResponse
+     */
+    'total': number;
+}
+//# sourceMappingURL=batch-upload-response.d.ts.map

package/dist/models/batch-upload-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-upload-response.d.ts","sourceRoot":"","sources":["../../models/batch-upload-response.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB"}