@visulima/storage 1.0.0-alpha.15 → 1.0.0-alpha.17

package/dist/storage/gcs/index.js

@@ -1,4 +1,4 @@
 export { default as GCSConfig } from '../../packem_shared/GCSConfig-vPP22kN6.js';
 export { default as GCSFile } from '../../packem_shared/GCSFile-DaDiCKE2.js';
-export { G as GCSMetaStorage } from '../../packem_shared/gcs-meta-storage-DBeGn2ix.js';
-export { default as GCStorage } from '../../packem_shared/GCStorage-BnsSAjdW.js';
+export { G as GCSMetaStorage } from '../../packem_shared/gcs-meta-storage-8FovEDbW.js';
+export { default as GCStorage } from '../../packem_shared/GCStorage-4hSx_bN1.js';

package/dist/storage/local/index.d.ts

@@ -1,4 +1,7 @@
-export { default as DiskStorage } from "./disk-storage.d.ts";
-export { default as DiskStorageWithChecksum } from "./disk-storage-with-checksum.d.ts";
-export type { LocalMetaStorageOptions } from "./local-meta-storage.d.ts";
-export { default as LocalMetaStorage } from "./local-meta-storage.d.ts";
+export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-hEoe2ugb.js";
+export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
+export { type L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-BOMUJD96.js";
+import 'node:stream';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';

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

@@ -1,4 +1,142 @@
-export { default as NetlifyBlobFile } from "./netlify-blob-file.d.ts";
-export { default as NetlifyBlobMetaStorage } from "./netlify-blob-meta-storage.d.ts";
-export { default as NetlifyBlobStorage } from "./netlify-blob-storage.d.ts";
-export type { NetlifyBlobStorageOptions } from "./types.d.ts";
+import { F as File, L as LocalMetaStorageOptions, k as BaseStorageOptions, M as MetaStorage, b as FileInit, d as FilePart, e as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-BOMUJD96.js";
+import 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class NetlifyBlobFile extends File {
+  /**
+  * The blob's public URL
+  */
+  url?: string;
+  /**
+  * The blob's pathname within the store
+  */
+  pathname?: string;
+}
+declare class NetlifyBlobMetaStorage extends LocalMetaStorage {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface NetlifyBlobStorageOptions extends BaseStorageOptions {
+  /**
+  * Configure metafiles storage
+  * @example
+  * Using local metafiles
+  * ```ts
+  * const storage = new NetlifyBlobStorage({
+  *   storeName: 'uploads',
+  *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+  * })
+  * ```
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * Netlify site ID (optional, used for explicit store access)
+  */
+  siteID?: string;
+  /**
+  * Netlify Blob store name
+  * @default 'default'
+  */
+  storeName?: string;
+  /**
+  * Netlify API token (optional, can use environment variable NETLIFY_TOKEN)
+  */
+  token?: string;
+}
+/**
+* Netlify Blob storage based backend.
+* @example
+* ```ts
+* const storage = new NetlifyBlobStorage({
+*   storeName: 'uploads',
+*   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
+* });
+* ```
+* @remarks
+* ## Supported Operations
+* - ✅ create, write, delete, get, list, copy, move
+* - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
+* - ✅ exists: Implemented (checks metadata and Netlify Blob)
+* - ✅ update: Implemented (updates metadata file, Netlify Blob API doesn't support blob metadata updates)
+* - ❌ getStream: Not implemented (use get() for file retrieval)
+* - ❌ getUrl: Not implemented (Netlify Blob URLs available via Netlify Blob API)
+* - ❌ getUploadUrl: Not implemented (Netlify Blob upload URLs handled internally)
+*/
+declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage;
+  private readonly storeName;
+  private readonly siteID?;
+  private readonly token?;
+  private store;
+  private readonly retry;
+  constructor(config: NetlifyBlobStorageOptions);
+  create(config: FileInit): Promise<NetlifyBlobFile>;
+  write(part: FilePart | FileQuery | NetlifyBlobFile): Promise<NetlifyBlobFile>;
+  /**
+  * 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): Promise<NetlifyBlobFile>;
+  /**
+  * Checks if a file exists by verifying both metadata and the actual Netlify 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): Promise<boolean>;
+  get({
+    id
+  }: FileQuery): 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): Promise<NetlifyBlobFile>;
+  /**
+  * 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): Promise<NetlifyBlobFile>;
+  /**
+  * Updates file metadata with user-provided key-value pairs.
+  * Updates the metadata file (overwrites it) but does not update Netlify Blob metadata
+  * since the Netlify Blob API doesn't support metadata updates.
+  * @param query File query containing the file ID to update.
+  * @param query.id File ID to update.
+  * @param metadata Partial file object containing fields to update.
+  * @returns Promise resolving to the updated file object.
+  * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND).
+  * @remarks
+  * Supports TTL (time-to-live) option: if metadata contains a 'ttl' field,
+  * it will be converted to an 'expiredAt' timestamp.
+  * TTL can be a number (milliseconds) or string (e.g., "1h", "30m", "7d").
+  */
+  override update({
+    id
+  }: FileQuery, metadata: Partial<NetlifyBlobFile>): Promise<NetlifyBlobFile>;
+  override list(limit?: number): Promise<NetlifyBlobFile[]>;
+  private internalOnComplete;
+  /**
+  * Generate a URL for a blob in Netlify Blob store
+  * Note: Netlify Blob doesn't provide direct public URLs like Vercel Blob
+  * In production, you would typically serve these through Netlify Functions or Edge Functions
+  */
+  private getBlobUrl;
+}
+export { NetlifyBlobFile, NetlifyBlobMetaStorage, NetlifyBlobStorage, type NetlifyBlobStorageOptions };

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

@@ -1,4 +1,129 @@
-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, k as BaseStorageOptions, F as File, M as MetaStorage, b as FileInit, d as FilePart, e as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-BOMUJD96.js";
+import 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+interface VercelBlobStorageOptions extends BaseStorageOptions {
+  /**
+  * 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 Blob read-write token
+  */
+  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)
+*/
+declare class VercelBlobStorage extends BaseStorage<VercelBlobFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage;
+  private readonly token;
+  private readonly multipart;
+  constructor(config: VercelBlobStorageOptions);
+  create(config: FileInit): Promise<VercelBlobFile>;
+  write(part: FilePart | FileQuery | VercelBlobFile): 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): 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): Promise<boolean>;
+  get({
+    id
+  }: FileQuery): 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): 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): Promise<VercelBlobFile>;
+  override list(limit?: number): 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/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-BOMUJD96.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-DBjmJvIT.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 };