@visulima/storage 1.0.9 → 1.0.11

package/dist/storage/vercel-blob/index.d.ts

@@ -1,104 +1,105 @@
-import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-CEM1upWM.js";
+import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-D9PBfkn6.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
 import { copy, del, list, put } from '@vercel/blob';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 interface VercelBlobStorageOptions extends BaseStorageOptions {
   /**
-  * Visibility for uploaded blobs. Vercel Blob currently exposes only
-  * `"public"` in its SDK, but this option is here so callers can pass
-  * through any future value without forking. Defaults to `"public"`.
-  */
+   * Visibility for uploaded blobs. Vercel Blob currently exposes only
+   * `"public"` in its SDK, but this option is here so callers can pass
+   * through any future value without forking. Defaults to `"public"`.
+   */
   access?: "public";
   /**
-  * Configure metafiles storage
-  * @example
-  * Using local metafiles
-  * ```ts
-  * const storage = new VercelBlobStorage({
-  *   token: process.env.BLOB_READ_WRITE_TOKEN,
-  *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-  * })
-  * ```
-  */
+   * Configure metafiles storage
+   * @example
+   * Using local metafiles
+   * ```ts
+   * const storage = new VercelBlobStorage({
+   *   token: process.env.BLOB_READ_WRITE_TOKEN,
+   *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+   * })
+   * ```
+   */
   metaStorageConfig?: LocalMetaStorageOptions;
   /**
-  * Enable multipart uploads for large files
-  * Can be a boolean to always use multipart, or a number (in bytes) as threshold
-  * @default false
-  * @example
-  * // Always use multipart uploads
-  * multipart: true
-  * // Use multipart for files larger than 100MB
-  * multipart: 100 * 1024 * 1024
-  */
+   * Enable multipart uploads for large files
+   * Can be a boolean to always use multipart, or a number (in bytes) as threshold
+   * @default false
+   * @example
+   * // Always use multipart uploads
+   * multipart: true
+   * // Use multipart for files larger than 100MB
+   * multipart: 100 * 1024 * 1024
+   */
   multipart?: boolean | number;
   /**
-  * Vercel OIDC token (`VERCEL_OIDC_TOKEN`). Short-lived, auto-rotated, and the
-  * recommended auth path for projects running on Vercel. Must be paired with
-  * {@link VercelBlobStorageOptions.storeId} (or `BLOB_STORE_ID` env). Provide
-  * explicitly for runtimes that don't expose `process.env` (e.g. Vite).
-  * @see https://vercel.com/docs/vercel-blob/using-blob-sdk#oidc-tokens-recommended
-  */
+   * Vercel OIDC token (`VERCEL_OIDC_TOKEN`). Short-lived, auto-rotated, and the
+   * recommended auth path for projects running on Vercel. Must be paired with
+   * {@link VercelBlobStorageOptions.storeId} (or `BLOB_STORE_ID` env). Provide
+   * explicitly for runtimes that don't expose `process.env` (e.g. Vite).
+   * @see https://vercel.com/docs/vercel-blob/using-blob-sdk#oidc-tokens-recommended
+   */
   oidcToken?: string;
   /**
-  * Vercel Blob store ID (`BLOB_STORE_ID`). Accepted in either `store_{id}`
-  * or `{id}` form — the `store_` prefix is stripped automatically. Required
-  * when authenticating via {@link VercelBlobStorageOptions.oidcToken}.
-  */
+   * Vercel Blob store ID (`BLOB_STORE_ID`). Accepted in either `store_{id}`
+   * or `{id}` form — the `store_` prefix is stripped automatically. Required
+   * when authenticating via {@link VercelBlobStorageOptions.oidcToken}.
+   */
   storeId?: string;
   /**
-  * Vercel Blob read-write token (`BLOB_READ_WRITE_TOKEN`). Long-lived; prefer
-  * {@link VercelBlobStorageOptions.oidcToken} on Vercel. Always wins over OIDC
-  * when both are supplied.
-  */
+   * Vercel Blob read-write token (`BLOB_READ_WRITE_TOKEN`). Long-lived; prefer
+   * {@link VercelBlobStorageOptions.oidcToken} on Vercel. Always wins over OIDC
+   * when both are supplied.
+   */
   token?: string;
 }
 declare class VercelBlobFile extends File {
   /**
-  * The blob's public URL
-  */
+   * The blob's public URL
+   */
   url?: string;
   /**
-  * The blob's download URL (may be different from url for private blobs)
-  */
+   * The blob's download URL (may be different from url for private blobs)
+   */
   downloadUrl?: string;
   /**
-  * The blob's pathname within the store
-  */
+   * The blob's pathname within the store
+   */
   pathname?: string;
 }
 declare class VercelBlobMetaStorage extends LocalMetaStorage {
   constructor(config?: LocalMetaStorageOptions);
 }
 /**
-* Vercel Blob storage based backend.
-* @example
-* ```ts
-* const storage = new VercelBlobStorage({
-*   token: process.env.BLOB_READ_WRITE_TOKEN,
-*   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-* });
-* ```
-* @remarks
-* ## Supported Operations
-* - ✅ create, write, delete, get, copy, move
-* - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
-* - ✅ exists: Implemented (checks metadata and Vercel Blob)
-* - ❌ getStream: Not implemented (use get() for file retrieval)
-* - ❌ list: Not implemented (Vercel Blob API doesn't support listing)
-* - ❌ update: Not implemented (Vercel Blob API doesn't support metadata updates)
-* - ❌ getUrl: Not implemented (Vercel Blob URLs available via Vercel Blob API)
-* - ❌ getUploadUrl: Not implemented (Vercel Blob upload URLs handled internally)
-* - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
-*/
+ * Vercel Blob storage based backend.
+ * @example
+ * ```ts
+ * const storage = new VercelBlobStorage({
+ *   token: process.env.BLOB_READ_WRITE_TOKEN,
+ *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+ * });
+ * ```
+ * @remarks
+ * ## Supported Operations
+ * - ✅ create, write, delete, get, copy, move
+ * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
+ * - ✅ exists: Implemented (checks metadata and Vercel Blob)
+ * - ❌ getStream: Not implemented (use get() for file retrieval)
+ * - ❌ list: Not implemented (Vercel Blob API doesn't support listing)
+ * - ❌ update: Not implemented (Vercel Blob API doesn't support metadata updates)
+ * - ❌ getUrl: Not implemented (Vercel Blob URLs available via Vercel Blob API)
+ * - ❌ getUploadUrl: Not implemented (Vercel Blob upload URLs handled internally)
+ * - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
+ */
 /**
-* Auth credentials resolved at construction and forwarded verbatim to every
-* `@vercel/blob` SDK call. Mirrors the SDK's `BlobCommandOptions` shape so
-* env-based auto-pickup is never required.
-*/
+ * Auth credentials resolved at construction and forwarded verbatim to every
+ * `@vercel/blob` SDK call. Mirrors the SDK's `BlobCommandOptions` shape so
+ * env-based auto-pickup is never required.
+ */
 type VercelBlobCredentials = {
   oidcToken: string;
   storeId: string;
@@ -124,66 +125,60 @@ declare class VercelBlobStorage extends BaseStorage<VercelBlobFile> {
   private readonly access;
   constructor(config: VercelBlobStorageOptions);
   /**
-  * Resolves auth credentials in the same precedence as `@vercel/blob`:
-  *
-  * 1. Explicit `token` (RW or client token) — always wins.
-  * 2. OIDC pair (`oidcToken` + `storeId`), from options or env.
-  * 3. `BLOB_READ_WRITE_TOKEN` / `VERCEL_BLOB_TOKEN` env.
-  *
-  * Throws if no credentials are found, or if OIDC config is partial (one of
-  * the two values present without the other) so callers fail loudly instead
-  * of silently dropping to anonymous calls that 401 at runtime.
-  */
+   * Resolves auth credentials in the same precedence as `@vercel/blob`:
+   *
+   * 1. Explicit `token` (RW or client token) — always wins.
+   * 2. OIDC pair (`oidcToken` + `storeId`), from options or env.
+   * 3. `BLOB_READ_WRITE_TOKEN` / `VERCEL_BLOB_TOKEN` env.
+   *
+   * Throws if no credentials are found, or if OIDC config is partial (one of
+   * the two values present without the other) so callers fail loudly instead
+   * of silently dropping to anonymous calls that 401 at runtime.
+   */
   private static resolveCredentials;
   create(config: FileInit, _options?: OperationOptions): Promise<VercelBlobFile>;
   write(part: FilePart | FileQuery | VercelBlobFile, options?: OperationOptions): Promise<VercelBlobFile>;
   /**
-  * Deletes an upload and its metadata.
-  * @param query File query containing the file ID to delete.
-  * @param query.id File ID to delete.
-  * @returns Promise resolving to the deleted file object with status: "deleted".
-  * @throws {UploadError} If the file metadata cannot be found.
-  */
-  delete({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<VercelBlobFile>;
+   * Deletes an upload and its metadata.
+   * @param query File query containing the file ID to delete.
+   * @param query.id File ID to delete.
+   * @returns Promise resolving to the deleted file object with status: "deleted".
+   * @throws {UploadError} If the file metadata cannot be found.
+   */
+  delete({ id }: FileQuery, options?: OperationOptions): Promise<VercelBlobFile>;
   /**
-  * Checks if a file exists by verifying both metadata and the actual Vercel Blob.
-  * Returns true only if both the metadata and the blob exist.
-  * @param query File query containing the file ID to check.
-  * @returns Promise resolving to true if both metadata and blob exist, false otherwise.
-  */
-  override exists({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<boolean>;
-  get({
-    id
-  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+   * Checks if a file exists by verifying both metadata and the actual Vercel Blob.
+   * Returns true only if both the metadata and the blob exist.
+   * @param query File query containing the file ID to check.
+   * @returns Promise resolving to true if both metadata and blob exist, false otherwise.
+   */
+  override exists({ id }: FileQuery, options?: OperationOptions): Promise<boolean>;
+  get({ id }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   /**
-  * Copies an upload file to a new location.
-  * @param name Source file name/ID.
-  * @param destination Destination file name/ID.
-  * @returns Promise resolving to the copied file object.
-  * @throws {UploadError} If the source file cannot be found.
-  */
+   * Copies an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the copied file object.
+   * @throws {UploadError} If the source file cannot be found.
+   */
   copy(name: string, destination: string, options?: OperationOptions & {
     storageClass?: string;
   }): Promise<VercelBlobFile>;
   /**
-  * Moves an upload file to a new location.
-  * @param name Source file name/ID.
-  * @param destination Destination file name/ID.
-  * @returns Promise resolving to the moved file object.
-  * @throws {UploadError} If the source file cannot be found.
-  */
+   * Moves an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the moved file object.
+   * @throws {UploadError} If the source file cannot be found.
+   */
   move(name: string, destination: string, options?: OperationOptions): Promise<VercelBlobFile>;
   override list(limit?: number, options?: OperationOptions): Promise<VercelBlobFile[]>;
   private internalOnComplete;
   /**
-  * Determines if multipart upload should be used for the given file.
-  * @param file File object to check.
-  * @returns True if multipart upload should be used, false otherwise.
-  */
+   * Determines if multipart upload should be used for the given file.
+   * @param file File object to check.
+   * @returns True if multipart upload should be used, false otherwise.
+   */
   private shouldUseMultipart;
 }
 export { VercelBlobFile, VercelBlobMetaStorage, VercelBlobStorage, type VercelBlobStorageOptions };

package/dist/storage/vercel-blob/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/VercelBlobFile-CVQwKlZk.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-BSn6Qfnf.js";import{default as f}from"../../packem_shared/VercelBlobStorage-CsRyPfw3.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};
+import{default as r}from"../../packem_shared/VercelBlobFile-CVQwKlZk.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-CJsyeQ63.js";import{default as f}from"../../packem_shared/VercelBlobStorage-DDNEofR3.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};

package/dist/transformer/audio-transformer.d.ts

@@ -1,130 +1,131 @@
-import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-CEM1upWM.js";
-import { A as AudioTransformerConfig, b as AudioTransformResult, c as AudioResampleOptions, d as AudioChannelMixOptions, e as AudioTransformOptions, f as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-CrUWY4On.js";
+import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-DwdJrArF.js";
+import { A as AudioTransformerConfig, b as AudioTransformResult, c as AudioResampleOptions, d as AudioChannelMixOptions, e as AudioTransformOptions, f as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-BEUv414z.js";
 import 'node:stream';
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 /**
-* Audio transformer that uses storage backends and Mediabunny to retrieve and transform audio files
-*
-* Supports audio transformations with query parameters for on-demand audio processing.
-* @example
-* ```ts
-* const transformer = new AudioTransformer(storage, {
-*   maxAudioSize: 50 * 1024 * 1024, // 50MB
-*   cache: new Map()
-* });
-*
-* // Programmatic usage - resample audio
-* const result = await transformer.resample('audio-id', {
-*   sampleRate: 44100
-* });
-*
-* // URL-based transformations
-* // GET /files/audio-id?sampleRate=48000&codec=aac&bitrate=128000
-* // GET /files/audio-id?numberOfChannels=1&format=mp3
-* ```
-*
-* ## Supported Query Parameters
-*
-* - `sampleRate`: Sample rate in Hz (Number)
-* - `numberOfChannels`: Number of channels (Number)
-* - `codec`: Audio codec - aac/opus/mp3/vorbis/flac
-* - `bitrate`: Audio bitrate in bits per second (Number)
-* - `format`: Output format - mp3/wav/ogg/aac/flac
-*/
+ * Audio transformer that uses storage backends and Mediabunny to retrieve and transform audio files
+ *
+ * Supports audio transformations with query parameters for on-demand audio processing.
+ * @example
+ * ```ts
+ * const transformer = new AudioTransformer(storage, {
+ *   maxAudioSize: 50 * 1024 * 1024, // 50MB
+ *   cache: new Map()
+ * });
+ *
+ * // Programmatic usage - resample audio
+ * const result = await transformer.resample('audio-id', {
+ *   sampleRate: 44100
+ * });
+ *
+ * // URL-based transformations
+ * // GET /files/audio-id?sampleRate=48000&codec=aac&bitrate=128000
+ * // GET /files/audio-id?numberOfChannels=1&format=mp3
+ * ```
+ *
+ * ## Supported Query Parameters
+ *
+ * - `sampleRate`: Sample rate in Hz (Number)
+ * - `numberOfChannels`: Number of channels (Number)
+ * - `codec`: Audio codec - aac/opus/mp3/vorbis/flac
+ * - `bitrate`: Audio bitrate in bits per second (Number)
+ * - `format`: Output format - mp3/wav/ogg/aac/flac
+ */
 declare class AudioTransformer<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> extends BaseTransformer<AudioTransformerConfig, AudioTransformResult<TFileReturn>, TFile, TFileReturn> {
   /**
-  * Creates a new AudioTransformer instance.
-  * @param storage The storage backend for retrieving and storing audio files.
-  * @param config Configuration options for audio transformation including cache settings, codec defaults, and size limits.
-  */
+   * Creates a new AudioTransformer instance.
+   * @param storage The storage backend for retrieving and storing audio files.
+   * @param config Configuration options for audio transformation including cache settings, codec defaults, and size limits.
+   */
   constructor(storage: BaseStorage<TFile, TFileReturn>, config?: AudioTransformerConfig);
   /**
-  * Resamples audio to different sample rate.
-  * @param fileId Unique identifier of the audio file to resample.
-  * @param options Resample options including target sample rate.
-  * @returns Promise resolving to transformed audio result.
-  */
+   * Resamples audio to different sample rate.
+   * @param fileId Unique identifier of the audio file to resample.
+   * @param options Resample options including target sample rate.
+   * @returns Promise resolving to transformed audio result.
+   */
   resample(fileId: string, options: AudioResampleOptions): Promise<AudioTransformResult<TFileReturn>>;
   /**
-  * Changes number of channels (up/downmixing).
-  * @param fileId Unique identifier of the audio file to process.
-  * @param options Channel mix options including target number of channels.
-  * @returns Promise resolving to transformed audio result.
-  */
+   * Changes number of channels (up/downmixing).
+   * @param fileId Unique identifier of the audio file to process.
+   * @param options Channel mix options including target number of channels.
+   * @returns Promise resolving to transformed audio result.
+   */
   mixChannels(fileId: string, options: AudioChannelMixOptions): Promise<AudioTransformResult<TFileReturn>>;
   /**
-  * Converts audio format or codec.
-  * @param fileId Unique identifier of the audio file to convert.
-  * @param format Target audio format (e.g., "mp3", "wav", "ogg").
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed audio result.
-  */
+   * Converts audio format or codec.
+   * @param fileId Unique identifier of the audio file to convert.
+   * @param format Target audio format (e.g., "mp3", "wav", "ogg").
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed audio result.
+   */
   convertFormat(fileId: string, format: string, options?: AudioTransformOptions): Promise<AudioTransformResult<TFileReturn>>;
   /**
-  * Transcodes audio to different codec.
-  * @param fileId Unique identifier of the audio file to transcode.
-  * @param codec Target audio codec (e.g., "aac", "opus", "mp3").
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed audio result.
-  */
+   * Transcodes audio to different codec.
+   * @param fileId Unique identifier of the audio file to transcode.
+   * @param codec Target audio codec (e.g., "aac", "opus", "mp3").
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed audio result.
+   */
   transcode(fileId: string, codec: AudioTransformOptions["codec"], options?: Omit<AudioTransformOptions, "codec">): Promise<AudioTransformResult<TFileReturn>>;
   /**
-  * Applies a custom transformation pipeline to an audio file.
-  * @param fileId Unique identifier of the audio file to transform.
-  * @param steps Array of transformation steps to apply in sequence.
-  * @returns Promise resolving to transformed audio result.
-  */
+   * Applies a custom transformation pipeline to an audio file.
+   * @param fileId Unique identifier of the audio file to transform.
+   * @param steps Array of transformation steps to apply in sequence.
+   * @returns Promise resolving to transformed audio result.
+   */
   transform(fileId: string, steps: AudioTransformationStep[]): Promise<AudioTransformResult<TFileReturn>>;
   /**
-  * Apply multiple transformations in sequence using Mediabunny
-  */
+   * Apply multiple transformations in sequence using Mediabunny
+   */
   private applyTransformations;
   /**
-  * Convert transformation steps to Mediabunny audio options
-  * @param steps Array of audio transformation steps to convert
-  * @returns Mediabunny audio options object for conversion
-  * @private
-  */
+   * Convert transformation steps to Mediabunny audio options
+   * @param steps Array of audio transformation steps to convert
+   * @returns Mediabunny audio options object for conversion
+   * @private
+   */
   private stepsToAudioOptions;
   /**
-  * Determine output format based on transformation steps
-  * @param steps Array of audio transformation steps
-  * @returns Mediabunny output format instance (defaults to MP3)
-  * @private
-  */
+   * Determine output format based on transformation steps
+   * @param steps Array of audio transformation steps
+   * @returns Mediabunny output format instance (defaults to MP3)
+   * @private
+   */
   private determineOutputFormat;
   /**
-  * Convert format string to Mediabunny output format
-  * @param format Audio format string (aac, flac, mp3, ogg, wav)
-  * @returns Mediabunny output format instance
-  * @private
-  */
+   * Convert format string to Mediabunny output format
+   * @param format Audio format string (aac, flac, mp3, ogg, wav)
+   * @returns Mediabunny output format instance
+   * @private
+   */
   private formatStringToOutputFormat;
   /**
-  * Validate that the file is a supported audio file
-  * @param file The file to validate
-  * @returns Promise that resolves if validation passes
-  * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid audio
-  * @private
-  */
+   * Validate that the file is a supported audio file
+   * @param file The file to validate
+   * @returns Promise that resolves if validation passes
+   * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid audio
+   * @private
+   */
   private validateAudio;
   /**
-  * Create transformation result with metadata
-  * @param buffer The transformed audio buffer
-  * @param originalFile The original file information
-  * @returns Audio transformation result with metadata
-  * @private
-  */
+   * Create transformation result with metadata
+   * @param buffer The transformed audio buffer
+   * @param originalFile The original file information
+   * @returns Audio transformation result with metadata
+   * @private
+   */
   private createTransformResult;
   /**
-  * Generate cache key for transformation
-  * @param fileId The file identifier
-  * @param steps Array of transformation steps
-  * @returns Unique cache key string
-  * @private
-  */
+   * Generate cache key for transformation
+   * @param fileId The file identifier
+   * @param steps Array of transformation steps
+   * @returns Unique cache key string
+   * @private
+   */
   private generateCacheKey;
 }
 export { AudioTransformer as default };