@visulima/storage 1.0.0-alpha.3 → 1.0.0-alpha.30

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

@@ -1,4 +1,189 @@
-export type { VercelBlobStorageOptions } from "./types.d.ts";
-export { default as VercelBlobFile } from "./vercel-blob-file.d.ts";
-export { default as VercelBlobMetaStorage } from "./vercel-blob-meta-storage.d.ts";
-export { default as VercelBlobStorage } from "./vercel-blob-storage.d.ts";
+import { L as LocalMetaStorageOptions, i as BaseStorageOptions, F as File, M as MetaStorage, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
+import { copy, del, list, put } from '@vercel/blob';
+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"`.
+  */
+  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' }
+  * })
+  * ```
+  */
+  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
+  */
+  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
+  */
+  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}.
+  */
+  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.
+  */
+  token?: string;
+}
+declare class VercelBlobFile extends File {
+  /**
+  * The blob's public URL
+  */
+  url?: string;
+  /**
+  * The blob's download URL (may be different from url for private blobs)
+  */
+  downloadUrl?: string;
+  /**
+  * 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.
+*/
+/**
+* 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;
+  token?: never;
+} | {
+  oidcToken?: never;
+  storeId?: never;
+  token: string;
+};
+declare class VercelBlobStorage extends BaseStorage<VercelBlobFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  override get raw(): {
+    copy: typeof copy;
+    credentials: VercelBlobCredentials;
+    del: typeof del;
+    list: typeof list;
+    put: typeof put;
+  };
+  protected meta: MetaStorage;
+  private readonly credentials;
+  private readonly multipart;
+  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.
+  */
+  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>;
+  /**
+  * 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.
+  */
+  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.
+  */
+  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.
+  */
+  private shouldUseMultipart;
+}
+export { VercelBlobFile, VercelBlobMetaStorage, VercelBlobStorage, type VercelBlobStorageOptions };

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

@@ -1,3 +1 @@
-export { default as VercelBlobFile } from '../../packem_shared/VercelBlobFile-BCg4aTEq.js';
-export { default as VercelBlobMetaStorage } from '../../packem_shared/VercelBlobMetaStorage-Bd9F-VFm.js';
-export { default as VercelBlobStorage } from '../../packem_shared/VercelBlobStorage-DD9LMOS6.js';
+import{default as r}from"../../packem_shared/VercelBlobFile-Cni_1qwD.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-CwaqWucZ.js";import{default as f}from"../../packem_shared/VercelBlobStorage-s260zfFo.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};

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

@@ -1,128 +1,130 @@
-import type { BaseStorage } from "../storage/storage.d.ts";
-import type { File, FileReturn } from "../storage/utils/index.d.ts";
-import BaseTransformer from "./base-transformer.d.ts";
-import type { AudioChannelMixOptions, AudioResampleOptions, AudioTransformationStep, AudioTransformerConfig, AudioTransformOptions, AudioTransformResult } from "./types.d.ts";
+import { F as File, a as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-RteRC-cG.js";
+import { A as AudioTransformerConfig, a as AudioTransformResult, b as AudioResampleOptions, c as AudioChannelMixOptions, d as AudioTransformOptions, e as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-DxonY4XS.js";
+import 'node:stream';
+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.
-     */
-    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.
-     */
-    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.
-     */
-    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.
-     */
-    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.
-     */
-    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.
-     */
-    transform(fileId: string, steps: AudioTransformationStep[]): Promise<AudioTransformResult<TFileReturn>>;
-    /**
-     * 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
-     */
-    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
-     */
-    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
-     */
-    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
-     */
-    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
-     */
-    private createTransformResult;
-    /**
-     * Generate cache key for transformation
-     * @param fileId The file identifier
-     * @param steps Array of transformation steps
-     * @returns Unique cache key string
-     * @private
-     */
-    private generateCacheKey;
+  /**
+  * 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.
+  */
+  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.
+  */
+  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.
+  */
+  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.
+  */
+  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.
+  */
+  transform(fileId: string, steps: AudioTransformationStep[]): Promise<AudioTransformResult<TFileReturn>>;
+  /**
+  * 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
+  */
+  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
+  */
+  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
+  */
+  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
+  */
+  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
+  */
+  private createTransformResult;
+  /**
+  * 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 default AudioTransformer;
+export { AudioTransformer as default };