@uploadista/core 0.2.0 → 1.0.0-beta.3

package/dist/upload-strategy-negotiator-CEnlfVgJ.d.mts

@@ -0,0 +1,455 @@
+import { n as UploadistaError } from "./uploadista-error-LtiZn-R_.mjs";
+import { B as DataStoreCapabilities, G as StreamingConfig, O as WebSocketConnection, Y as UploadStrategy, at as UploadFileKVStore, j as UploadEvent, jn as UploadFile, o as InputFile, q as UploadFileDataStores, rt as KvStore, t as Middleware, w as UploadEventEmitter, x as EventEmitter, z as DataStore } from "./middleware-CYizzAhP.mjs";
+import { a as GenerateIdShape, t as GenerateId } from "./generate-id-DuZwLm4m.mjs";
+import { Context, Effect, Layer, Stream } from "effect";
+
+//#region src/upload/mime.d.ts
+/**
+ * Detect MIME type from buffer using magic bytes (file signatures).
+ * Supports a wide range of common file types including images, videos, audio, documents, and archives.
+ *
+ * @param buffer - File content as Uint8Array
+ * @param filename - Optional filename for extension-based fallback
+ * @returns Detected MIME type or "application/octet-stream" if unknown
+ */
+declare const detectMimeType: (buffer: Uint8Array, filename?: string) => string;
+/**
+ * Compare two MIME types with lenient matching.
+ * Matches on major type (e.g., "image/*") to allow for minor variations.
+ *
+ * @param declared - MIME type provided by client
+ * @param detected - MIME type detected from file content
+ * @returns true if MIME types are compatible
+ *
+ * @example
+ * compareMimeTypes("image/png", "image/apng") // true
+ * compareMimeTypes("image/jpeg", "image/png") // true (both images)
+ * compareMimeTypes("image/png", "application/pdf") // false
+ */
+declare function compareMimeTypes(declared: string, detected: string): boolean;
+//#endregion
+//#region src/upload/upload-engine.d.ts
+/**
+ * Legacy configuration options for UploadEngine.
+ *
+ * @deprecated Use Effect Layers instead of this configuration object.
+ * This type is kept for backward compatibility.
+ *
+ * @property dataStore - DataStore instance or factory function
+ * @property kvStore - KV store for upload metadata
+ * @property eventEmitter - Event emitter for upload progress
+ * @property generateId - Optional ID generator (defaults to UUID)
+ * @property middlewares - Optional request middlewares
+ * @property withTracing - Enable Effect tracing for debugging
+ */
+type UploadEngineOptions = {
+  dataStore: ((storageId: string) => Promise<DataStore<UploadFile>>) | DataStore<UploadFile>;
+  kvStore: KvStore<UploadFile>;
+  eventEmitter: EventEmitter<UploadEvent>;
+  generateId?: GenerateIdShape;
+  middlewares?: Middleware[];
+  withTracing?: boolean;
+};
+/**
+ * UploadEngine service interface.
+ *
+ * This is the core upload handling service that provides all file upload operations.
+ * It manages upload lifecycle, resumable uploads, progress tracking, and storage integration.
+ *
+ * All operations return Effect types for composable, type-safe error handling.
+ *
+ * @property createUpload - Initiates a new upload and returns metadata
+ * @property uploadChunk - Uploads a chunk of data for an existing upload
+ * @property getCapabilities - Returns storage backend capabilities
+ * @property upload - Complete upload in one operation (create + upload data)
+ * @property uploadFromUrl - Uploads a file from a remote URL
+ * @property getUpload - Retrieves upload metadata by ID
+ * @property read - Reads the complete uploaded file data
+ * @property delete - Deletes an upload and its data
+ * @property subscribeToUploadEvents - Subscribes WebSocket to upload progress events
+ * @property unsubscribeFromUploadEvents - Unsubscribes from upload events
+ *
+ * @example
+ * ```typescript
+ * // Basic upload flow
+ * const program = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *
+ *   // 1. Create upload
+ *   const inputFile: InputFile = {
+ *     storageId: "s3-production",
+ *     size: 1024000,
+ *     type: "image/jpeg",
+ *     fileName: "photo.jpg"
+ *   };
+ *   const upload = yield* server.createUpload(inputFile, "client123");
+ *
+ *   // 2. Upload chunks
+ *   const chunk = new ReadableStream(...);
+ *   const updated = yield* server.uploadChunk(upload.id, "client123", chunk);
+ *
+ *   // 3. Read the uploaded file
+ *   const data = yield* server.read(upload.id, "client123");
+ *
+ *   return upload;
+ * });
+ *
+ * // Upload with WebSocket progress tracking
+ * const uploadWithProgress = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *
+ *   // Subscribe to progress events
+ *   yield* server.subscribeToUploadEvents(uploadId, websocket);
+ *
+ *   // Upload (events will be emitted automatically)
+ *   const result = yield* server.upload(inputFile, clientId, stream);
+ *
+ *   // Unsubscribe when done
+ *   yield* server.unsubscribeFromUploadEvents(uploadId);
+ *
+ *   return result;
+ * });
+ *
+ * // Upload from URL
+ * const urlUpload = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *
+ *   const inputFile: InputFile = {
+ *     storageId: "s3-production",
+ *     size: 0, // Unknown initially
+ *     type: "image/png",
+ *     fileName: "remote-image.png"
+ *   };
+ *
+ *   const upload = yield* server.uploadFromUrl(
+ *     inputFile,
+ *     "client123",
+ *     "https://example.com/image.png"
+ *   );
+ *
+ *   return upload;
+ * });
+ * ```
+ */
+type UploadEngineShape = {
+  createUpload: (inputFile: InputFile, clientId: string | null) => Effect.Effect<UploadFile, UploadistaError>;
+  uploadChunk: (uploadId: string, clientId: string | null, chunk: ReadableStream) => Effect.Effect<UploadFile, UploadistaError>;
+  getCapabilities: (storageId: string, clientId: string | null) => Effect.Effect<DataStoreCapabilities, UploadistaError>;
+  upload: (file: InputFile, clientId: string | null, stream: ReadableStream) => Effect.Effect<UploadFile, UploadistaError>;
+  uploadFromUrl: (inputFile: InputFile, clientId: string | null, url: string) => Effect.Effect<UploadFile, UploadistaError>;
+  getUpload: (uploadId: string) => Effect.Effect<UploadFile, UploadistaError>;
+  /**
+   * Reads the complete uploaded file data as bytes (buffered mode).
+   * For large files, consider using readStream() for memory efficiency.
+   */
+  read: (uploadId: string, clientId: string | null) => Effect.Effect<Uint8Array, UploadistaError>;
+  /**
+   * Reads file content as a stream of chunks for memory-efficient processing.
+   * Falls back to buffered read if the underlying DataStore doesn't support streaming.
+   *
+   * @param uploadId - The unique identifier of the upload to read
+   * @param clientId - Client identifier for multi-tenant routing
+   * @param config - Optional streaming configuration (chunk size)
+   * @returns An Effect that resolves to a Stream of byte chunks
+   *
+   * @example
+   * ```typescript
+   * const server = yield* UploadEngine;
+   * const stream = yield* server.readStream(uploadId, clientId, { chunkSize: 65536 });
+   * // Process stream chunk by chunk with bounded memory
+   * yield* Stream.runForEach(stream, (chunk) => processChunk(chunk));
+   * ```
+   */
+  readStream: (uploadId: string, clientId: string | null, config?: StreamingConfig) => Effect.Effect<Stream.Stream<Uint8Array, UploadistaError>, UploadistaError>;
+  /**
+   * Uploads file content from a stream with unknown final size.
+   * Creates upload with deferred length, streams content to storage,
+   * and updates the upload record with final size when complete.
+   *
+   * Falls back to buffered upload if the underlying DataStore
+   * doesn't support streaming writes.
+   *
+   * @param file - Input file configuration (size is optional)
+   * @param clientId - Client identifier for multi-tenant routing
+   * @param stream - Effect Stream of byte chunks to upload
+   * @returns The completed UploadFile with final size
+   *
+   * @example
+   * ```typescript
+   * const server = yield* UploadEngine;
+   * const result = yield* server.uploadStream(
+   *   {
+   *     storageId: "s3-production",
+   *     type: "image/webp",
+   *     uploadLengthDeferred: true,
+   *     fileName: "optimized.webp",
+   *   },
+   *   clientId,
+   *   transformedStream,
+   * );
+   * console.log(`Uploaded ${result.size} bytes`);
+   * ```
+   */
+  uploadStream: (file: Omit<InputFile, "size"> & {
+    size?: number;
+    sizeHint?: number;
+  }, clientId: string | null, stream: Stream.Stream<Uint8Array, UploadistaError>) => Effect.Effect<UploadFile, UploadistaError>;
+  delete: (uploadId: string, clientId: string | null) => Effect.Effect<void, UploadistaError>;
+  subscribeToUploadEvents: (uploadId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError>;
+  unsubscribeFromUploadEvents: (uploadId: string) => Effect.Effect<void, UploadistaError>;
+};
+declare const UploadEngine_base: Context.TagClass<UploadEngine, "UploadEngine", UploadEngineShape>;
+/**
+ * Effect-TS context tag for the UploadEngine service.
+ *
+ * Use this tag to access the UploadEngine in an Effect context.
+ * The server must be provided via a Layer or dependency injection.
+ *
+ * @example
+ * ```typescript
+ * // Access UploadEngine in an Effect
+ * const uploadEffect = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *   const upload = yield* server.createUpload(inputFile, clientId);
+ *   return upload;
+ * });
+ *
+ * // Provide UploadEngine layer
+ * const program = uploadEffect.pipe(
+ *   Effect.provide(uploadEngine),
+ *   Effect.provide(uploadFileKvStore),
+ *   Effect.provide(dataStoreLayer),
+ *   Effect.provide(eventEmitterLayer)
+ * );
+ * ```
+ */
+declare class UploadEngine extends UploadEngine_base {}
+/**
+ * Creates the UploadEngine implementation.
+ *
+ * This function constructs the UploadEngine service by composing all required
+ * dependencies (KV store, data stores, event emitter, ID generator). It implements
+ * all upload operations defined in UploadEngineShape.
+ *
+ * The server automatically handles:
+ * - Upload lifecycle management (create, resume, complete)
+ * - Progress tracking and event emission
+ * - Storage backend routing based on storageId
+ * - Error handling with proper UploadistaError types
+ *
+ * @returns An Effect that yields the UploadEngineShape implementation
+ *
+ * @example
+ * ```typescript
+ * // Create a custom UploadEngine layer
+ * const myUploadEngine = Layer.effect(
+ *   UploadEngine,
+ *   createUploadEngine()
+ * );
+ *
+ * // Use in a program
+ * const program = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *   // Use server operations...
+ * }).pipe(Effect.provide(myUploadEngine));
+ * ```
+ */
+declare function createUploadEngine(): Effect.Effect<{
+  upload: (inputFile: InputFile, clientId: string | null, stream: ReadableStream) => Effect.Effect<UploadFile, UploadistaError, never>;
+  uploadFromUrl: (inputFile: InputFile, clientId: string | null, url: string) => Effect.Effect<UploadFile, UploadistaError, never>;
+  createUpload: (inputFile: InputFile, clientId: string | null) => Effect.Effect<UploadFile, UploadistaError, never>;
+  uploadChunk: (uploadId: string, clientId: string | null, chunk: ReadableStream) => Effect.Effect<UploadFile, UploadistaError, never>;
+  getUpload: (uploadId: string) => Effect.Effect<UploadFile, UploadistaError, never>;
+  read: (uploadId: string, clientId: string | null) => Effect.Effect<Uint8Array<ArrayBufferLike>, UploadistaError, never>;
+  readStream: (uploadId: string, clientId: string | null, config?: StreamingConfig) => Effect.Effect<Stream.Stream<Uint8Array<ArrayBufferLike>, UploadistaError, never>, UploadistaError, never>;
+  uploadStream: (file: Omit<InputFile, "size"> & {
+    size?: number;
+    sizeHint?: number;
+  }, clientId: string | null, stream: Stream.Stream<Uint8Array, UploadistaError>) => Effect.Effect<UploadFile, UploadistaError, never>;
+  delete: (uploadId: string, clientId: string | null) => Effect.Effect<void, UploadistaError, never>;
+  getCapabilities: (storageId: string, clientId: string | null) => Effect.Effect<DataStoreCapabilities, UploadistaError, never>;
+  subscribeToUploadEvents: (uploadId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError, never>;
+  unsubscribeFromUploadEvents: (uploadId: string) => Effect.Effect<void, UploadistaError, never>;
+}, never, UploadFileDataStores | UploadFileKVStore | UploadEventEmitter | GenerateId>;
+/**
+ * Pre-built UploadEngine Effect Layer.
+ *
+ * This layer provides a ready-to-use UploadEngine implementation that can be
+ * composed with other layers to build a complete upload system.
+ *
+ * Required dependencies:
+ * - UploadFileKVStore: For storing upload metadata
+ * - UploadFileDataStores: For routing to storage backends
+ * - UploadEventEmitter: For progress events
+ * - GenerateId: For creating upload IDs
+ *
+ * @example
+ * ```typescript
+ * // Compose a complete upload system
+ * const fullUploadSystem = Layer.mergeAll(
+ *   uploadEngine,
+ *   uploadFileKvStore,
+ *   dataStoreLayer,
+ *   uploadEventEmitter,
+ *   generateIdLayer
+ * );
+ *
+ * // Use in application
+ * const app = Effect.gen(function* () {
+ *   const server = yield* UploadEngine;
+ *   // Perform uploads...
+ * }).pipe(Effect.provide(fullUploadSystem));
+ * ```
+ */
+declare const uploadEngine: Layer.Layer<UploadEngine, never, UploadFileDataStores | UploadFileKVStore | UploadEventEmitter | GenerateId>;
+//#endregion
+//#region src/upload/upload-strategy-negotiator.d.ts
+/**
+ * Configuration options for upload strategy negotiation.
+ *
+ * @property fileSize - Size of the file to be uploaded in bytes
+ * @property preferredStrategy - Preferred upload strategy (single, parallel, resumable)
+ * @property preferredChunkSize - Preferred chunk size in bytes
+ * @property parallelUploads - Number of parallel upload connections
+ * @property minChunkSizeForParallel - Minimum file size to consider parallel uploads
+ */
+type UploadStrategyOptions = {
+  fileSize: number;
+  preferredStrategy?: UploadStrategy;
+  preferredChunkSize?: number;
+  parallelUploads?: number;
+  minChunkSizeForParallel?: number;
+};
+/**
+ * Result of upload strategy negotiation.
+ *
+ * @property strategy - The negotiated upload strategy
+ * @property chunkSize - The negotiated chunk size in bytes
+ * @property parallelUploads - The negotiated number of parallel uploads
+ * @property reasoning - Array of reasoning strings explaining the decisions
+ * @property warnings - Array of warning messages about adjustments made
+ */
+type NegotiatedStrategy = {
+  strategy: UploadStrategy;
+  chunkSize: number;
+  parallelUploads: number;
+  reasoning: string[];
+  warnings: string[];
+};
+/**
+ * Negotiates the optimal upload strategy based on data store capabilities and file characteristics.
+ *
+ * This class analyzes data store capabilities, file size, and user preferences to determine
+ * the best upload strategy (single, parallel, resumable) and optimal parameters like chunk size
+ * and parallel connection count.
+ *
+ * The negotiator considers:
+ * - Data store capabilities (parallel uploads, resumable uploads, concatenation)
+ * - File size and chunk size constraints
+ * - User preferences and requirements
+ * - Performance optimization opportunities
+ *
+ * @example
+ * ```typescript
+ * // Create negotiator for S3 data store
+ * const negotiator = new UploadStrategyNegotiator(
+ *   s3Capabilities,
+ *   (strategy) => s3Capabilities.supportsStrategy(strategy)
+ * );
+ *
+ * // Negotiate strategy for large file
+ * const result = negotiator.negotiateStrategy({
+ *   fileSize: 100_000_000, // 100MB
+ *   preferredStrategy: "parallel",
+ *   preferredChunkSize: 5_000_000, // 5MB chunks
+ *   parallelUploads: 4
+ * });
+ *
+ * console.log(result.strategy); // "parallel"
+ * console.log(result.chunkSize); // 5_000_000
+ * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
+ * ```
+ */
+declare class UploadStrategyNegotiator {
+  private capabilities;
+  private validateUploadStrategy;
+  /**
+   * Creates a new upload strategy negotiator.
+   *
+   * @param capabilities - Data store capabilities and constraints
+   * @param validateUploadStrategy - Function to validate if a strategy is supported
+   */
+  constructor(capabilities: DataStoreCapabilities, validateUploadStrategy: (strategy: UploadStrategy) => boolean);
+  /**
+   * Negotiates the optimal upload strategy based on options and data store capabilities.
+   *
+   * This method analyzes the provided options and data store capabilities to determine
+   * the best upload strategy, chunk size, and parallel upload settings. It considers
+   * user preferences, file size, and data store constraints to make optimal decisions.
+   *
+   * The negotiation process:
+   * 1. Validates preferred strategy against data store capabilities
+   * 2. Automatically selects strategy based on file size and capabilities
+   * 3. Adjusts chunk size to fit within data store constraints
+   * 4. Validates parallel upload settings
+   * 5. Ensures final strategy is supported by the data store
+   *
+   * @param options - Upload strategy options including file size and preferences
+   * @returns Negotiated strategy with reasoning and warnings
+   *
+   * @example
+   * ```typescript
+   * const result = negotiator.negotiateStrategy({
+   *   fileSize: 50_000_000, // 50MB
+   *   preferredStrategy: "parallel",
+   *   preferredChunkSize: 5_000_000, // 5MB
+   *   parallelUploads: 3
+   * });
+   *
+   * console.log(result.strategy); // "parallel"
+   * console.log(result.chunkSize); // 5_000_000
+   * console.log(result.parallelUploads); // 3
+   * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
+   * console.log(result.warnings); // [] (no warnings)
+   * ```
+   */
+  negotiateStrategy(options: UploadStrategyOptions): NegotiatedStrategy;
+  /**
+   * Gets the data store capabilities used by this negotiator.
+   *
+   * @returns The data store capabilities and constraints
+   */
+  getDataStoreCapabilities(): DataStoreCapabilities;
+  /**
+   * Validates upload strategy configuration against data store capabilities.
+   *
+   * This method checks if the provided configuration is valid for the current
+   * data store capabilities without performing the actual negotiation. It's
+   * useful for pre-validation before attempting to negotiate a strategy.
+   *
+   * @param options - Upload strategy options to validate
+   * @returns Validation result with validity flag and error messages
+   *
+   * @example
+   * ```typescript
+   * const validation = negotiator.validateConfiguration({
+   *   fileSize: 10_000_000,
+   *   preferredStrategy: "parallel",
+   *   preferredChunkSize: 1_000_000,
+   *   parallelUploads: 5
+   * });
+   *
+   * if (!validation.valid) {
+   *   console.log("Configuration errors:", validation.errors);
+   *   // Handle validation errors
+   * }
+   * ```
+   */
+  validateConfiguration(options: UploadStrategyOptions): {
+    valid: boolean;
+    errors: string[];
+  };
+}
+//#endregion
+export { UploadEngineOptions as a, uploadEngine as c, UploadEngine as i, compareMimeTypes as l, UploadStrategyNegotiator as n, UploadEngineShape as o, UploadStrategyOptions as r, createUploadEngine as s, NegotiatedStrategy as t, detectMimeType as u };
+//# sourceMappingURL=upload-strategy-negotiator-CEnlfVgJ.d.mts.map

package/dist/upload-strategy-negotiator-CEnlfVgJ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-strategy-negotiator-CEnlfVgJ.d.mts","names":[],"sources":["../src/upload/mime.ts","../src/upload/upload-engine.ts","../src/upload/upload-strategy-negotiator.ts"],"mappings":"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"}

package/dist/{uploadista-error-B-geDgi8.cjs → uploadista-error-CZx1JU_L.cjs}

@@ -1,4 +1,4 @@
-require(`./websocket-Avz4T8YB.cjs`);let e=require(`effect`);const t={MISSING_OFFSET:{status:403,body:`Upload-Offset header required
+require(`./websocket-Br0ijEZA.cjs`);let e=require(`effect`);const t={MISSING_OFFSET:{status:403,body:`Upload-Offset header required
 `},ABORTED:{status:400,body:`Request aborted due to lock acquired`},INVALID_TERMINATION:{status:400,body:`Cannot terminate an already completed upload`},ERR_LOCK_TIMEOUT:{status:500,body:`failed to acquire lock before timeout`},INVALID_CONTENT_TYPE:{status:403,body:`Content-Type header required
 `},DATASTORE_NOT_FOUND:{status:500,body:`The datastore was not found
 `},UPLOAD_ID_NOT_FOUND:{status:500,body:`The upload id was not found
@@ -52,4 +52,6 @@ require(`./websocket-Avz4T8YB.cjs`);let e=require(`effect`);const t={MISSING_OFF
 `},PDF_CORRUPTED:{status:400,body:`The PDF file is corrupted or malformed
 `},PAGE_RANGE_INVALID:{status:400,body:`The specified page range is invalid
 `},CIRCUIT_BREAKER_OPEN:{status:503,body:`Circuit breaker is open - service temporarily unavailable
+`},QUEUE_ITEM_NOT_FOUND:{status:404,body:`The queue item was not found
+`},QUEUE_ITEM_ALREADY_RUNNING:{status:409,body:`Cannot cancel a queue item that is already running
 `}};var n=class n extends e.Data.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.message=n,this.details=i,r&&(this.cause=r)}static fromCode(e,r){let i=t[e];return new n({code:e,status:r?.status??i.status,body:r?.body??i.body,details:r?.details,cause:r?.cause})}toEffect(){return e.Effect.fail(this)}};function r(e){return e instanceof n}function i(e,t){return n.fromCode(e,t).toEffect()}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});

package/dist/{uploadista-error-Fsfvr2Bb.mjs → uploadista-error-DQ7V1FlX.mjs}

@@ -52,5 +52,7 @@ import{Data as e,Effect as t}from"effect";const n={MISSING_OFFSET:{status:403,bo
 `},PDF_CORRUPTED:{status:400,body:`The PDF file is corrupted or malformed
 `},PAGE_RANGE_INVALID:{status:400,body:`The specified page range is invalid
 `},CIRCUIT_BREAKER_OPEN:{status:503,body:`Circuit breaker is open - service temporarily unavailable
+`},QUEUE_ITEM_NOT_FOUND:{status:404,body:`The queue item was not found
+`},QUEUE_ITEM_ALREADY_RUNNING:{status:409,body:`Cannot cancel a queue item that is already running
 `}};var r=class r extends e.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.message=n,this.details=i,r&&(this.cause=r)}static fromCode(e,t){let i=n[e];return new r({code:e,status:t?.status??i.status,body:t?.body??i.body,details:t?.details,cause:t?.cause})}toEffect(){return t.fail(this)}};function i(e){return e instanceof r}function a(e,t){return r.fromCode(e,t).toEffect()}export{i,r as n,a as r,n as t};
-//# sourceMappingURL=uploadista-error-Fsfvr2Bb.mjs.map
+//# sourceMappingURL=uploadista-error-DQ7V1FlX.mjs.map

package/dist/uploadista-error-DQ7V1FlX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadista-error-DQ7V1FlX.mjs","names":[],"sources":["../src/errors/uploadista-error.ts"],"sourcesContent":["import { Data, Effect } from \"effect\";\n\n/**\n * Union type of all possible error codes in the Uploadista system.\n *\n * Each error code corresponds to a specific error condition with predefined\n * HTTP status codes and messages in the ERROR_CATALOG.\n */\nexport type UploadistaErrorCode =\n  | \"MISSING_OFFSET\"\n  | \"ABORTED\"\n  | \"INVALID_TERMINATION\"\n  | \"ERR_LOCK_TIMEOUT\"\n  | \"INVALID_CONTENT_TYPE\"\n  | \"FLOW_STRUCTURE_ERROR\"\n  | \"FLOW_CYCLE_ERROR\"\n  | \"FLOW_NODE_NOT_FOUND\"\n  | \"FLOW_NODE_ERROR\"\n  | \"FLOW_NOT_AUTHORIZED\"\n  | \"FLOW_NOT_FOUND\"\n  | \"FLOW_PAUSED\"\n  | \"FLOW_CANCELLED\"\n  | \"FILE_READ_ERROR\"\n  | \"FLOW_JOB_NOT_FOUND\"\n  | \"FLOW_JOB_ERROR\"\n  | \"DATASTORE_NOT_FOUND\"\n  | \"FILE_NOT_FOUND\"\n  | \"UPLOAD_CANCELLED\"\n  | \"INVALID_OFFSET\"\n  | \"FILE_NO_LONGER_EXISTS\"\n  | \"ERR_SIZE_EXCEEDED\"\n  | \"ERR_MAX_SIZE_EXCEEDED\"\n  | \"INVALID_LENGTH\"\n  | \"INVALID_METADATA\"\n  | \"VALIDATION_ERROR\"\n  | \"STORAGE_NOT_AUTHORIZED\"\n  | \"UNKNOWN_ERROR\"\n  | \"FILE_WRITE_ERROR\"\n  | \"UPLOAD_ID_NOT_FOUND\"\n  | \"FLOW_OUTPUT_VALIDATION_ERROR\"\n  | \"FLOW_INPUT_VALIDATION_ERROR\"\n  | \"CHECKSUM_MISMATCH\"\n  | \"MIMETYPE_MISMATCH\"\n  | \"UNSUPPORTED_CHECKSUM_ALGORITHM\"\n  | \"VIDEO_PROCESSING_FAILED\"\n  | \"INVALID_VIDEO_FORMAT\"\n  | \"CODEC_NOT_SUPPORTED\"\n  | \"VIDEO_METADATA_EXTRACTION_FAILED\"\n  | \"FFMPEG_NOT_INSTALLED\"\n  | \"INVALID_NODE_TYPE\"\n  | \"TYPE_CATEGORY_MISMATCH\"\n  | \"INVALID_INPUT_TYPE\"\n  | \"INVALID_OUTPUT_TYPE\"\n  | \"OUTPUT_NOT_FOUND\"\n  | \"MULTIPLE_OUTPUTS_FOUND\"\n  | \"VIRUS_SCAN_FAILED\"\n  | \"VIRUS_DETECTED\"\n  | \"CLAMAV_NOT_INSTALLED\"\n  | \"VIRUS_DEFINITIONS_OUTDATED\"\n  | \"SCAN_TIMEOUT\"\n  | \"DOCUMENT_PROCESSING_FAILED\"\n  | \"INVALID_DOCUMENT_FORMAT\"\n  | \"OCR_FAILED\"\n  | \"PDF_ENCRYPTED\"\n  | \"PDF_CORRUPTED\"\n  | \"PAGE_RANGE_INVALID\"\n  | \"CIRCUIT_BREAKER_OPEN\"\n  | \"QUEUE_ITEM_NOT_FOUND\"\n  | \"QUEUE_ITEM_ALREADY_RUNNING\";\n\n/**\n * Catalog of all predefined errors in the Uploadista system.\n *\n * Maps error codes to their HTTP status codes and default error messages.\n * This centralized catalog ensures consistent error handling across all\n * Uploadista packages and adapters.\n *\n * Each error entry contains:\n * - `status`: HTTP status code (400-500 range)\n * - `body`: Human-readable error message\n *\n * @example\n * ```typescript\n * // Access a specific error definition\n * const fileNotFound = ERROR_CATALOG.FILE_NOT_FOUND;\n * console.log(fileNotFound.status); // 404\n * console.log(fileNotFound.body);   // \"The file for this url was not found\\n\"\n *\n * // Use with UploadistaError\n * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n * ```\n */\nexport const ERROR_CATALOG: Readonly<\n  Record<UploadistaErrorCode, { status: number; body: string }>\n> = {\n  MISSING_OFFSET: { status: 403, body: \"Upload-Offset header required\\n\" },\n  ABORTED: { status: 400, body: \"Request aborted due to lock acquired\" },\n  INVALID_TERMINATION: {\n    status: 400,\n    body: \"Cannot terminate an already completed upload\",\n  },\n  ERR_LOCK_TIMEOUT: {\n    status: 500,\n    body: \"failed to acquire lock before timeout\",\n  },\n  INVALID_CONTENT_TYPE: {\n    status: 403,\n    body: \"Content-Type header required\\n\",\n  },\n  DATASTORE_NOT_FOUND: {\n    status: 500,\n    body: \"The datastore was not found\\n\",\n  },\n  UPLOAD_ID_NOT_FOUND: {\n    status: 500,\n    body: \"The upload id was not found\\n\",\n  },\n  FILE_NOT_FOUND: {\n    status: 404,\n    body: \"The file for this url was not found\\n\",\n  },\n  UPLOAD_CANCELLED: {\n    status: 410,\n    body: \"The upload was cancelled\\n\",\n  },\n  FLOW_NOT_AUTHORIZED: {\n    status: 401,\n    body: \"The flow is not authorized\\n\",\n  },\n  FLOW_NOT_FOUND: {\n    status: 404,\n    body: \"The flow was not found\\n\",\n  },\n  FLOW_PAUSED: {\n    status: 409,\n    body: \"The flow execution was paused by user\\n\",\n  },\n  FLOW_CANCELLED: {\n    status: 409,\n    body: \"The flow execution was cancelled by user\\n\",\n  },\n  FLOW_STRUCTURE_ERROR: {\n    status: 500,\n    body: \"The flow structure is invalid\\n\",\n  },\n  FLOW_CYCLE_ERROR: {\n    status: 500,\n    body: \"The flow contains a cycle\\n\",\n  },\n  FLOW_NODE_NOT_FOUND: {\n    status: 500,\n    body: \"The flow node was not found\\n\",\n  },\n  FLOW_NODE_ERROR: {\n    status: 500,\n    body: \"The flow node failed\\n\",\n  },\n  FLOW_JOB_NOT_FOUND: {\n    status: 404,\n    body: \"The flow job was not found\\n\",\n  },\n  FLOW_JOB_ERROR: {\n    status: 500,\n    body: \"The flow job failed\\n\",\n  },\n  FLOW_INPUT_VALIDATION_ERROR: {\n    status: 500,\n    body: \"The flow input validation failed\\n\",\n  },\n  FLOW_OUTPUT_VALIDATION_ERROR: {\n    status: 500,\n    body: \"The flow output validation failed\\n\",\n  },\n  INVALID_OFFSET: { status: 409, body: \"Upload-Offset conflict\\n\" },\n  FILE_NO_LONGER_EXISTS: {\n    status: 410,\n    body: \"The file for this url no longer exists\\n\",\n  },\n  FILE_READ_ERROR: {\n    status: 500,\n    body: \"Something went wrong reading the file\\n\",\n  },\n  ERR_SIZE_EXCEEDED: { status: 413, body: \"upload's size exceeded\\n\" },\n  ERR_MAX_SIZE_EXCEEDED: { status: 413, body: \"Maximum size exceeded\\n\" },\n  INVALID_LENGTH: {\n    status: 400,\n    body: \"Upload-Length or Upload-Defer-Length header required\\n\",\n  },\n  INVALID_METADATA: {\n    status: 400,\n    body: \"Upload-Metadata is invalid. It MUST consist of one or more comma-separated key-value pairs. The key and value MUST be separated by a space. The key MUST NOT contain spaces and commas and MUST NOT be empty. The key SHOULD be ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique\",\n  },\n  VALIDATION_ERROR: {\n    status: 400,\n    body: \"Validation failed\\n\",\n  },\n  STORAGE_NOT_AUTHORIZED: {\n    status: 401,\n    body: \"The storage is not authorized\\n\",\n  },\n  UNKNOWN_ERROR: {\n    status: 500,\n    body: \"Something went wrong with that request\\n\",\n  },\n  FILE_WRITE_ERROR: {\n    status: 500,\n    body: \"Something went wrong receiving the file\\n\",\n  },\n  CHECKSUM_MISMATCH: {\n    status: 400,\n    body: \"The file checksum does not match the provided checksum\\n\",\n  },\n  MIMETYPE_MISMATCH: {\n    status: 400,\n    body: \"The file MIME type does not match the declared type\\n\",\n  },\n  UNSUPPORTED_CHECKSUM_ALGORITHM: {\n    status: 400,\n    body: \"The specified checksum algorithm is not supported\\n\",\n  },\n  VIDEO_PROCESSING_FAILED: {\n    status: 500,\n    body: \"Video processing operation failed\\n\",\n  },\n  INVALID_VIDEO_FORMAT: {\n    status: 400,\n    body: \"The video format is not supported\\n\",\n  },\n  CODEC_NOT_SUPPORTED: {\n    status: 400,\n    body: \"The specified video codec is not supported\\n\",\n  },\n  VIDEO_METADATA_EXTRACTION_FAILED: {\n    status: 500,\n    body: \"Failed to extract video metadata\\n\",\n  },\n  FFMPEG_NOT_INSTALLED: {\n    status: 500,\n    body: \"FFmpeg is not installed or not available in PATH\\n\",\n  },\n  INVALID_NODE_TYPE: {\n    status: 500,\n    body: \"The specified node type is not registered\\n\",\n  },\n  TYPE_CATEGORY_MISMATCH: {\n    status: 500,\n    body: \"Node type category does not match the node configuration\\n\",\n  },\n  INVALID_INPUT_TYPE: {\n    status: 500,\n    body: \"The input type is not registered\\n\",\n  },\n  INVALID_OUTPUT_TYPE: {\n    status: 500,\n    body: \"The output type is not registered\\n\",\n  },\n  OUTPUT_NOT_FOUND: {\n    status: 404,\n    body: \"No output of the specified type was found\\n\",\n  },\n  MULTIPLE_OUTPUTS_FOUND: {\n    status: 409,\n    body: \"Multiple outputs of the specified type found, expected single output\\n\",\n  },\n  VIRUS_SCAN_FAILED: {\n    status: 500,\n    body: \"Virus scanning operation failed\\n\",\n  },\n  VIRUS_DETECTED: {\n    status: 400,\n    body: \"Virus or malware detected in file\\n\",\n  },\n  CLAMAV_NOT_INSTALLED: {\n    status: 500,\n    body: \"ClamAV is not installed or not available\\n\",\n  },\n  VIRUS_DEFINITIONS_OUTDATED: {\n    status: 500,\n    body: \"Virus definitions are outdated and should be updated\\n\",\n  },\n  SCAN_TIMEOUT: {\n    status: 500,\n    body: \"Virus scan exceeded timeout limit\\n\",\n  },\n  DOCUMENT_PROCESSING_FAILED: {\n    status: 500,\n    body: \"Document processing operation failed\\n\",\n  },\n  INVALID_DOCUMENT_FORMAT: {\n    status: 400,\n    body: \"The document format is not supported\\n\",\n  },\n  OCR_FAILED: {\n    status: 500,\n    body: \"OCR operation failed\\n\",\n  },\n  PDF_ENCRYPTED: {\n    status: 400,\n    body: \"The PDF is password-protected and cannot be processed\\n\",\n  },\n  PDF_CORRUPTED: {\n    status: 400,\n    body: \"The PDF file is corrupted or malformed\\n\",\n  },\n  PAGE_RANGE_INVALID: {\n    status: 400,\n    body: \"The specified page range is invalid\\n\",\n  },\n  CIRCUIT_BREAKER_OPEN: {\n    status: 503,\n    body: \"Circuit breaker is open - service temporarily unavailable\\n\",\n  },\n  QUEUE_ITEM_NOT_FOUND: {\n    status: 404,\n    body: \"The queue item was not found\\n\",\n  },\n  QUEUE_ITEM_ALREADY_RUNNING: {\n    status: 409,\n    body: \"Cannot cancel a queue item that is already running\\n\",\n  },\n} as const;\n\n/**\n * Standard error class for all Uploadista operations.\n *\n * UploadistaError provides a consistent error handling approach across the entire\n * Uploadista ecosystem. Each error has:\n * - A typed error code from the ERROR_CATALOG\n * - An HTTP-compatible status code\n * - A human-readable error message (body)\n * - Optional additional details and cause information\n *\n * This class integrates with Effect-TS for functional error handling and can be\n * easily converted to an Effect that fails.\n *\n * @example\n * ```typescript\n * // Create from error code\n * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n *\n * // Create with custom details\n * const customError = UploadistaError.fromCode(\"FLOW_NODE_ERROR\", {\n *   body: \"Failed to process image\",\n *   cause: originalError,\n *   details: { nodeId: \"resize-1\", fileId: \"abc123\" }\n * });\n *\n * // Use with Effect\n * const effect = customError.toEffect<void>();\n *\n * // In an Effect pipeline\n * return Effect.gen(function* () {\n *   const file = yield* getFile(id);\n *   if (!file) {\n *     return yield* UploadistaError.fromCode(\"FILE_NOT_FOUND\").toEffect();\n *   }\n *   return file;\n * });\n * ```\n */\nexport class UploadistaError extends Data.TaggedError(\"UploadistaError\") {\n  readonly code: string;\n  readonly status: number;\n  // Keep legacy property names for backward compatibility\n  readonly status_code: number;\n  readonly body: string;\n  readonly details?: unknown;\n\n  constructor({\n    code,\n    status,\n    body,\n    cause,\n    details,\n  }: {\n    code: UploadistaErrorCode | string;\n    status: number;\n    body: string;\n    cause?: unknown;\n    details?: unknown;\n  }) {\n    super();\n    this.name = \"UploadistaError\";\n    this.code = code;\n    this.status = status;\n    this.status_code = status; // legacy alias\n    this.body = body;\n    // Set message property from body so it's serializable to JSON\n    (this as unknown as { message: string }).message = body;\n    this.details = details;\n    if (cause) (this as unknown as { cause?: unknown }).cause = cause;\n  }\n\n  /**\n   * Creates an UploadistaError from a predefined error code.\n   *\n   * This is the primary way to create errors in the Uploadista system. Each error code\n   * has a default status and message defined in ERROR_CATALOG, but these can be overridden\n   * for specific use cases.\n   *\n   * @param code - One of the predefined error codes from UploadistaErrorCode\n   * @param overrides - Optional overrides for the default error properties\n   * @param overrides.status - Custom HTTP status code (overrides the default)\n   * @param overrides.body - Custom error message (overrides the default)\n   * @param overrides.details - Additional structured data about the error\n   * @param overrides.cause - The underlying error that caused this error (for error chaining)\n   *\n   * @returns A new UploadistaError instance\n   *\n   * @example\n   * ```typescript\n   * // Use default error\n   * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n   *\n   * // Override message\n   * const customError = UploadistaError.fromCode(\"FILE_NOT_FOUND\", {\n   *   body: `File with ID ${fileId} was not found in storage`\n   * });\n   *\n   * // Include cause and details\n   * const detailedError = UploadistaError.fromCode(\"DATASTORE_NOT_FOUND\", {\n   *   cause: storageException,\n   *   details: { storageId: \"s3-prod\", region: \"us-east-1\" }\n   * });\n   * ```\n   */\n  static fromCode(\n    code: UploadistaErrorCode,\n    overrides?: Partial<Pick<UploadistaError, \"status\" | \"body\">> & {\n      details?: unknown;\n      cause?: unknown;\n    },\n  ): UploadistaError {\n    const base = ERROR_CATALOG[code];\n    return new UploadistaError({\n      code,\n      status: overrides?.status ?? base.status,\n      body: overrides?.body ?? base.body,\n      details: overrides?.details,\n      cause: overrides?.cause,\n    });\n  }\n\n  /**\n   * Converts this error to an Effect that immediately fails.\n   *\n   * This method integrates UploadistaError with Effect-TS's error handling system,\n   * allowing errors to be used in Effect pipelines with proper type checking.\n   *\n   * @template T - The success type of the Effect (defaults to never since it always fails)\n   * @returns An Effect that fails with this UploadistaError\n   *\n   * @example\n   * ```typescript\n   * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n   *\n   * // Use in an Effect pipeline\n   * return Effect.gen(function* () {\n   *   const file = yield* kvStore.get(fileId);\n   *   if (!file) {\n   *     return yield* error.toEffect();\n   *   }\n   *   return file;\n   * });\n   * ```\n   */\n  toEffect<T = never>(): Effect.Effect<T, UploadistaError> {\n    return Effect.fail(this);\n  }\n}\n\n/**\n * Type guard to check if an unknown value is an UploadistaError.\n *\n * Useful for error handling when catching errors that might be from\n * different sources or libraries.\n *\n * @param error - The value to check\n * @returns True if the value is an UploadistaError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   if (isUploadistaError(error)) {\n *     console.log(`Uploadista error: ${error.code} (${error.status})`);\n *     console.log(error.body);\n *   } else {\n *     console.error(\"Unknown error:\", error);\n *   }\n * }\n * ```\n */\nexport function isUploadistaError(error: unknown): error is UploadistaError {\n  return error instanceof UploadistaError;\n}\n\n/**\n * Creates an Effect that immediately fails with an UploadistaError.\n *\n * This is a convenience function that combines error creation with Effect conversion.\n * It's equivalent to calling `UploadistaError.fromCode(code, overrides).toEffect()`.\n *\n * @param code - One of the predefined error codes from UploadistaErrorCode\n * @param overrides - Optional overrides for the default error properties\n * @param overrides.status - Custom HTTP status code\n * @param overrides.body - Custom error message\n * @param overrides.details - Additional structured data about the error\n * @param overrides.cause - The underlying error that caused this error\n *\n * @returns An Effect that immediately fails with the created UploadistaError\n *\n * @example\n * ```typescript\n * // In an Effect pipeline\n * return Effect.gen(function* () {\n *   const file = yield* kvStore.get(fileId);\n *   if (!file) {\n *     return yield* httpFailure(\"FILE_NOT_FOUND\", {\n *       details: { fileId }\n *     });\n *   }\n *   return file;\n * });\n * ```\n */\nexport function httpFailure(\n  code: UploadistaErrorCode,\n  overrides?: Partial<Pick<UploadistaError, \"status\" | \"body\">> & {\n    details?: unknown;\n    cause?: unknown;\n  },\n): Effect.Effect<never, UploadistaError> {\n  return UploadistaError.fromCode(code, overrides).toEffect();\n}\n"],"mappings":"0CA4FA,MAAa,EAET,CACF,eAAgB,CAAE,OAAQ,IAAK,KAAM;EAAmC,CACxE,QAAS,CAAE,OAAQ,IAAK,KAAM,uCAAwC,CACtE,oBAAqB,CACnB,OAAQ,IACR,KAAM,+CACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM,wCACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,YAAa,CACX,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,gBAAiB,CACf,OAAQ,IACR,KAAM;EACP,CACD,mBAAoB,CAClB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,4BAA6B,CAC3B,OAAQ,IACR,KAAM;EACP,CACD,6BAA8B,CAC5B,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CAAE,OAAQ,IAAK,KAAM;EAA4B,CACjE,sBAAuB,CACrB,OAAQ,IACR,KAAM;EACP,CACD,gBAAiB,CACf,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CAAE,OAAQ,IAAK,KAAM;EAA4B,CACpE,sBAAuB,CAAE,OAAQ,IAAK,KAAM;EAA2B,CACvE,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM,8SACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,uBAAwB,CACtB,OAAQ,IACR,KAAM;EACP,CACD,cAAe,CACb,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,+BAAgC,CAC9B,OAAQ,IACR,KAAM;EACP,CACD,wBAAyB,CACvB,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,iCAAkC,CAChC,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,uBAAwB,CACtB,OAAQ,IACR,KAAM;EACP,CACD,mBAAoB,CAClB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,uBAAwB,CACtB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,2BAA4B,CAC1B,OAAQ,IACR,KAAM;EACP,CACD,aAAc,CACZ,OAAQ,IACR,KAAM;EACP,CACD,2BAA4B,CAC1B,OAAQ,IACR,KAAM;EACP,CACD,wBAAyB,CACvB,OAAQ,IACR,KAAM;EACP,CACD,WAAY,CACV,OAAQ,IACR,KAAM;EACP,CACD,cAAe,CACb,OAAQ,IACR,KAAM;EACP,CACD,cAAe,CACb,OAAQ,IACR,KAAM;EACP,CACD,mBAAoB,CAClB,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,2BAA4B,CAC1B,OAAQ,IACR,KAAM;EACP,CACF,CAwCD,IAAa,EAAb,MAAa,UAAwB,EAAK,YAAY,kBAAkB,AAAC,CACvE,KACA,OAEA,YACA,KACA,QAEA,YAAY,CACV,OACA,SACA,OACA,QACA,WAOC,CACD,OAAO,CACP,KAAK,KAAO,kBACZ,KAAK,KAAO,EACZ,KAAK,OAAS,EACd,KAAK,YAAc,EACnB,KAAK,KAAO,EAEX,KAAwC,QAAU,EACnD,KAAK,QAAU,EACX,IAAQ,KAAwC,MAAQ,GAoC9D,OAAO,SACL,EACA,EAIiB,CACjB,IAAM,EAAO,EAAc,GAC3B,OAAO,IAAI,EAAgB,CACzB,OACA,OAAQ,GAAW,QAAU,EAAK,OAClC,KAAM,GAAW,MAAQ,EAAK,KAC9B,QAAS,GAAW,QACpB,MAAO,GAAW,MACnB,CAAC,CA0BJ,UAAyD,CACvD,OAAO,EAAO,KAAK,KAAK,GA2B5B,SAAgB,EAAkB,EAA0C,CAC1E,OAAO,aAAiB,EAgC1B,SAAgB,EACd,EACA,EAIuC,CACvC,OAAO,EAAgB,SAAS,EAAM,EAAU,CAAC,UAAU"}

package/dist/{uploadista-error-BragVhIs.d.mts → uploadista-error-LtiZn-R_.d.mts}

@@ -9,7 +9,7 @@ import * as effect_Cause0 from "effect/Cause";
  * Each error code corresponds to a specific error condition with predefined
  * HTTP status codes and messages in the ERROR_CATALOG.
  */
-type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FLOW_PAUSED" | "FLOW_CANCELLED" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "UPLOAD_CANCELLED" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM" | "VIDEO_PROCESSING_FAILED" | "INVALID_VIDEO_FORMAT" | "CODEC_NOT_SUPPORTED" | "VIDEO_METADATA_EXTRACTION_FAILED" | "FFMPEG_NOT_INSTALLED" | "INVALID_NODE_TYPE" | "TYPE_CATEGORY_MISMATCH" | "INVALID_INPUT_TYPE" | "INVALID_OUTPUT_TYPE" | "OUTPUT_NOT_FOUND" | "MULTIPLE_OUTPUTS_FOUND" | "VIRUS_SCAN_FAILED" | "VIRUS_DETECTED" | "CLAMAV_NOT_INSTALLED" | "VIRUS_DEFINITIONS_OUTDATED" | "SCAN_TIMEOUT" | "DOCUMENT_PROCESSING_FAILED" | "INVALID_DOCUMENT_FORMAT" | "OCR_FAILED" | "PDF_ENCRYPTED" | "PDF_CORRUPTED" | "PAGE_RANGE_INVALID" | "CIRCUIT_BREAKER_OPEN";
+type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FLOW_PAUSED" | "FLOW_CANCELLED" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "UPLOAD_CANCELLED" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM" | "VIDEO_PROCESSING_FAILED" | "INVALID_VIDEO_FORMAT" | "CODEC_NOT_SUPPORTED" | "VIDEO_METADATA_EXTRACTION_FAILED" | "FFMPEG_NOT_INSTALLED" | "INVALID_NODE_TYPE" | "TYPE_CATEGORY_MISMATCH" | "INVALID_INPUT_TYPE" | "INVALID_OUTPUT_TYPE" | "OUTPUT_NOT_FOUND" | "MULTIPLE_OUTPUTS_FOUND" | "VIRUS_SCAN_FAILED" | "VIRUS_DETECTED" | "CLAMAV_NOT_INSTALLED" | "VIRUS_DEFINITIONS_OUTDATED" | "SCAN_TIMEOUT" | "DOCUMENT_PROCESSING_FAILED" | "INVALID_DOCUMENT_FORMAT" | "OCR_FAILED" | "PDF_ENCRYPTED" | "PDF_CORRUPTED" | "PAGE_RANGE_INVALID" | "CIRCUIT_BREAKER_OPEN" | "QUEUE_ITEM_NOT_FOUND" | "QUEUE_ITEM_ALREADY_RUNNING";
 /**
  * Catalog of all predefined errors in the Uploadista system.
  *
@@ -217,4 +217,4 @@ declare function httpFailure(code: UploadistaErrorCode, overrides?: Partial<Pick
 }): Effect.Effect<never, UploadistaError>;
 //#endregion
 export { isUploadistaError as a, httpFailure as i, UploadistaError as n, UploadistaErrorCode as r, ERROR_CATALOG as t };
-//# sourceMappingURL=uploadista-error-BragVhIs.d.mts.map
+//# sourceMappingURL=uploadista-error-LtiZn-R_.d.mts.map

package/dist/{uploadista-error-BragVhIs.d.mts.map → uploadista-error-LtiZn-R_.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"uploadista-error-BragVhIs.d.mts","names":[],"sources":["../src/errors/uploadista-error.ts"],"mappings":";;;;;;;;;AAQA;;KAAY,mBAAA;;;AAkFZ;;;;;;;;;;;;;;;AA4NW;;;;;cA5NE,aAAA,EAAe,QAAA,CAC1B,MAAA,CAAO,mBAAA;EAAuB,MAAA;EAAgB,IAAA;AAAA;AAAA,cA2NrC,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwCX;;;;;;;;;;;;;;;;;cAAa,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;EAAA,SACA,MAAA;EAAA,SAEA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;;IAGP,IAAA;IACA,MAAA;IACA,IAAA;IACA,KAAA;IACA;EAAA;IAEA,IAAA,EAAM,mBAAA;IACN,MAAA;IACA,IAAA;IACA,KAAA;IACA,OAAA;EAAA;EATA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4HJ;;EA5HI,OAwDK,QAAA,CACL,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;IACvB,OAAA;IACA,KAAA;EAAA,IAED,eAAA;EA8DuD;;;AAiC5D;;;;;;;;;;;;;;;;;;;;EA7DE,QAAA,WAAA,CAAA,GAAuB,MAAA,CAAO,MAAA,CAAO,CAAA,EAAG,eAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,CAAkB,KAAA,YAAiB,KAAA,IAAS,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,CACd,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;EACvB,OAAA;EACA,KAAA;AAAA,IAED,MAAA,CAAO,MAAA,QAAc,eAAA"}
+{"version":3,"file":"uploadista-error-LtiZn-R_.d.mts","names":[],"sources":["../src/errors/uploadista-error.ts"],"mappings":";;;;;;;;;AAQA;;KAAY,mBAAA;;;AAoFZ;;;;;;;;;;;;;;;AAoOW;;;;;cApOE,aAAA,EAAe,QAAA,CAC1B,MAAA,CAAO,mBAAA;EAAuB,MAAA;EAAgB,IAAA;AAAA;AAAA,cAmOrC,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwCX;;;;;;;;;;;;;;;;;cAAa,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;EAAA,SACA,MAAA;EAAA,SAEA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;;IAGP,IAAA;IACA,MAAA;IACA,IAAA;IACA,KAAA;IACA;EAAA;IAEA,IAAA,EAAM,mBAAA;IACN,MAAA;IACA,IAAA;IACA,KAAA;IACA,OAAA;EAAA;EATA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4HJ;;EA5HI,OAwDK,QAAA,CACL,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;IACvB,OAAA;IACA,KAAA;EAAA,IAED,eAAA;EA8DuD;;;AAiC5D;;;;;;;;;;;;;;;;;;;;EA7DE,QAAA,WAAA,CAAA,GAAuB,MAAA,CAAO,MAAA,CAAO,CAAA,EAAG,eAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,CAAkB,KAAA,YAAiB,KAAA,IAAS,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,CACd,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;EACvB,OAAA;EACA,KAAA;AAAA,IAED,MAAA,CAAO,MAAA,QAAc,eAAA"}

package/dist/{uploadista-error-Cj_pAFck.d.cts → uploadista-error-eZtG4iyf.d.cts}

@@ -9,7 +9,7 @@ import { Effect } from "effect";
  * Each error code corresponds to a specific error condition with predefined
  * HTTP status codes and messages in the ERROR_CATALOG.
  */
-type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FLOW_PAUSED" | "FLOW_CANCELLED" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "UPLOAD_CANCELLED" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM" | "VIDEO_PROCESSING_FAILED" | "INVALID_VIDEO_FORMAT" | "CODEC_NOT_SUPPORTED" | "VIDEO_METADATA_EXTRACTION_FAILED" | "FFMPEG_NOT_INSTALLED" | "INVALID_NODE_TYPE" | "TYPE_CATEGORY_MISMATCH" | "INVALID_INPUT_TYPE" | "INVALID_OUTPUT_TYPE" | "OUTPUT_NOT_FOUND" | "MULTIPLE_OUTPUTS_FOUND" | "VIRUS_SCAN_FAILED" | "VIRUS_DETECTED" | "CLAMAV_NOT_INSTALLED" | "VIRUS_DEFINITIONS_OUTDATED" | "SCAN_TIMEOUT" | "DOCUMENT_PROCESSING_FAILED" | "INVALID_DOCUMENT_FORMAT" | "OCR_FAILED" | "PDF_ENCRYPTED" | "PDF_CORRUPTED" | "PAGE_RANGE_INVALID" | "CIRCUIT_BREAKER_OPEN";
+type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FLOW_PAUSED" | "FLOW_CANCELLED" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "UPLOAD_CANCELLED" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM" | "VIDEO_PROCESSING_FAILED" | "INVALID_VIDEO_FORMAT" | "CODEC_NOT_SUPPORTED" | "VIDEO_METADATA_EXTRACTION_FAILED" | "FFMPEG_NOT_INSTALLED" | "INVALID_NODE_TYPE" | "TYPE_CATEGORY_MISMATCH" | "INVALID_INPUT_TYPE" | "INVALID_OUTPUT_TYPE" | "OUTPUT_NOT_FOUND" | "MULTIPLE_OUTPUTS_FOUND" | "VIRUS_SCAN_FAILED" | "VIRUS_DETECTED" | "CLAMAV_NOT_INSTALLED" | "VIRUS_DEFINITIONS_OUTDATED" | "SCAN_TIMEOUT" | "DOCUMENT_PROCESSING_FAILED" | "INVALID_DOCUMENT_FORMAT" | "OCR_FAILED" | "PDF_ENCRYPTED" | "PDF_CORRUPTED" | "PAGE_RANGE_INVALID" | "CIRCUIT_BREAKER_OPEN" | "QUEUE_ITEM_NOT_FOUND" | "QUEUE_ITEM_ALREADY_RUNNING";
 /**
  * Catalog of all predefined errors in the Uploadista system.
  *
@@ -217,4 +217,4 @@ declare function httpFailure(code: UploadistaErrorCode, overrides?: Partial<Pick
 }): Effect.Effect<never, UploadistaError>;
 //#endregion
 export { isUploadistaError as a, httpFailure as i, UploadistaError as n, UploadistaErrorCode as r, ERROR_CATALOG as t };
-//# sourceMappingURL=uploadista-error-Cj_pAFck.d.cts.map
+//# sourceMappingURL=uploadista-error-eZtG4iyf.d.cts.map

package/dist/{uploadista-error-Cj_pAFck.d.cts.map → uploadista-error-eZtG4iyf.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"uploadista-error-Cj_pAFck.d.cts","names":[],"sources":["../src/errors/uploadista-error.ts"],"mappings":";;;;;;;;;AAQA;;KAAY,mBAAA;;;AAkFZ;;;;;;;;;;;;;;;AA4NW;;;;;cA5NE,aAAA,EAAe,QAAA,CAC1B,MAAA,CAAO,mBAAA;EAAuB,MAAA;EAAgB,IAAA;AAAA;AAAA,cA2NrC,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwCX;;;;;;;;;;;;;;;;;cAAa,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;EAAA,SACA,MAAA;EAAA,SAEA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;;IAGP,IAAA;IACA,MAAA;IACA,IAAA;IACA,KAAA;IACA;EAAA;IAEA,IAAA,EAAM,mBAAA;IACN,MAAA;IACA,IAAA;IACA,KAAA;IACA,OAAA;EAAA;EATA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4HJ;;EA5HI,OAwDK,QAAA,CACL,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;IACvB,OAAA;IACA,KAAA;EAAA,IAED,eAAA;EA8DuD;;;AAiC5D;;;;;;;;;;;;;;;;;;;;EA7DE,QAAA,WAAA,CAAA,GAAuB,MAAA,CAAO,MAAA,CAAO,CAAA,EAAG,eAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,CAAkB,KAAA,YAAiB,KAAA,IAAS,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,CACd,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;EACvB,OAAA;EACA,KAAA;AAAA,IAED,MAAA,CAAO,MAAA,QAAc,eAAA"}
+{"version":3,"file":"uploadista-error-eZtG4iyf.d.cts","names":[],"sources":["../src/errors/uploadista-error.ts"],"mappings":";;;;;;;;;AAQA;;KAAY,mBAAA;;;AAoFZ;;;;;;;;;;;;;;;AAoOW;;;;;cApOE,aAAA,EAAe,QAAA,CAC1B,MAAA,CAAO,mBAAA;EAAuB,MAAA;EAAgB,IAAA;AAAA;AAAA,cAmOrC,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;AAwCX;;;;;;;;;;;;;;;;;cAAa,eAAA,SAAwB,oBAAA;EAAA,SAC1B,IAAA;EAAA,SACA,MAAA;EAAA,SAEA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA;;IAGP,IAAA;IACA,MAAA;IACA,IAAA;IACA,KAAA;IACA;EAAA;IAEA,IAAA,EAAM,mBAAA;IACN,MAAA;IACA,IAAA;IACA,KAAA;IACA,OAAA;EAAA;EATA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4HJ;;EA5HI,OAwDK,QAAA,CACL,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;IACvB,OAAA;IACA,KAAA;EAAA,IAED,eAAA;EA8DuD;;;AAiC5D;;;;;;;;;;;;;;;;;;;;EA7DE,QAAA,WAAA,CAAA,GAAuB,MAAA,CAAO,MAAA,CAAO,CAAA,EAAG,eAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,CAAkB,KAAA,YAAiB,KAAA,IAAS,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,CACd,IAAA,EAAM,mBAAA,EACN,SAAA,GAAY,OAAA,CAAQ,IAAA,CAAK,eAAA;EACvB,OAAA;EACA,KAAA;AAAA,IAED,MAAA,CAAO,MAAA,QAAc,eAAA"}

package/dist/utils/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../uploadista-error-B-geDgi8.cjs`);const e=require(`../checksum-B7RDiO7V.cjs`),t=require(`../throttle-KnkRgZPi.cjs`);exports.GenerateId=e.r,exports.GenerateIdLive=e.i,exports.GenerateIdRandom=e.a,exports.GenerateIdService=e.o,exports.GenerateIdTimestamp=e.s,exports.Md5=t.a,exports.OnceEffect=t.r,exports.ThrottleEffect=t.t,exports.computeChecksum=e.t,exports.isSupportedAlgorithm=e.n,exports.once=t.i,exports.throttle=t.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../uploadista-error-CZx1JU_L.cjs`);const e=require(`../checksum-BrjQ8GJL.cjs`),t=require(`../throttle-Dp59f37i.cjs`);exports.GenerateId=e.r,exports.GenerateIdLive=e.i,exports.GenerateIdRandom=e.a,exports.GenerateIdService=e.o,exports.GenerateIdTimestamp=e.s,exports.Md5=t.a,exports.OnceEffect=t.r,exports.ThrottleEffect=t.t,exports.computeChecksum=e.t,exports.isSupportedAlgorithm=e.n,exports.once=t.i,exports.throttle=t.n;

package/dist/utils/index.d.cts

@@ -1,2 +1,3 @@
-import { a as Md5, c as isSupportedAlgorithm, d as GenerateIdRandom, f as GenerateIdService, i as once, l as GenerateId, m as GenerateIdTimestamp, n as throttle, o as ChecksumAlgorithm, p as GenerateIdShape, r as OnceEffect, s as computeChecksum, t as ThrottleEffect, u as GenerateIdLive } from "../throttle-Da0OA8JT.cjs";
+import { a as GenerateIdShape, i as GenerateIdService, n as GenerateIdLive, o as GenerateIdTimestamp, r as GenerateIdRandom, t as GenerateId } from "../generate-id-BAMRQzMr.cjs";
+import { a as Md5, c as isSupportedAlgorithm, i as once, n as throttle, o as ChecksumAlgorithm, r as OnceEffect, s as computeChecksum, t as ThrottleEffect } from "../throttle-BlH27EGu.cjs";
 export { ChecksumAlgorithm, GenerateId, GenerateIdLive, GenerateIdRandom, GenerateIdService, GenerateIdShape, GenerateIdTimestamp, Md5, OnceEffect, ThrottleEffect, computeChecksum, isSupportedAlgorithm, once, throttle };

package/dist/utils/index.d.mts

@@ -1,3 +1,4 @@
-import "../uploadista-error-BragVhIs.mjs";
-import { a as Md5, c as isSupportedAlgorithm, d as GenerateIdRandom, f as GenerateIdService, i as once, l as GenerateId, m as GenerateIdTimestamp, n as throttle, o as ChecksumAlgorithm, p as GenerateIdShape, r as OnceEffect, s as computeChecksum, t as ThrottleEffect, u as GenerateIdLive } from "../throttle-ibiT6E4U.mjs";
+import "../uploadista-error-LtiZn-R_.mjs";
+import { a as GenerateIdShape, i as GenerateIdService, n as GenerateIdLive, o as GenerateIdTimestamp, r as GenerateIdRandom, t as GenerateId } from "../generate-id-DuZwLm4m.mjs";
+import { a as Md5, c as isSupportedAlgorithm, i as once, n as throttle, o as ChecksumAlgorithm, r as OnceEffect, s as computeChecksum, t as ThrottleEffect } from "../throttle-3FRcr7MU.mjs";
 export { ChecksumAlgorithm, GenerateId, GenerateIdLive, GenerateIdRandom, GenerateIdService, GenerateIdShape, GenerateIdTimestamp, Md5, OnceEffect, ThrottleEffect, computeChecksum, isSupportedAlgorithm, once, throttle };

package/dist/utils/index.mjs

@@ -1 +1 @@
-import"../uploadista-error-Fsfvr2Bb.mjs";import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"../checksum-BjP9nb5b.mjs";import{a as s,i as c,n as l,r as u,t as d}from"../throttle-CnDa3v1k.mjs";export{i as GenerateId,t as GenerateIdLive,e as GenerateIdRandom,r as GenerateIdService,a as GenerateIdTimestamp,s as Md5,u as OnceEffect,d as ThrottleEffect,o as computeChecksum,n as isSupportedAlgorithm,c as once,l as throttle};
+import"../uploadista-error-DQ7V1FlX.mjs";import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"../checksum-BRjFmTRk.mjs";import{a as s,i as c,n as l,r as u,t as d}from"../throttle-TFY-V41R.mjs";export{i as GenerateId,t as GenerateIdLive,e as GenerateIdRandom,r as GenerateIdService,a as GenerateIdTimestamp,s as Md5,u as OnceEffect,d as ThrottleEffect,o as computeChecksum,n as isSupportedAlgorithm,c as once,l as throttle};