@visulima/storage 1.0.0-alpha.9 → 1.0.0

package/dist/packem_shared/media-transformer.d-Quf4ai47.d.ts

@@ -0,0 +1,331 @@
+import { F as File, g as FileReturn, B as BaseStorage } from "./storage.d-CEM1upWM.js";
+import { M as MediaTransformerConfig, a as MediaTransformResult } from "./types.d-CrUWY4On.js";
+/**
+* Unified media transformer that automatically detects media type and routes to appropriate transformer.
+* @template TFile The file type used by this transformer.
+* @template TFileReturn The return type for file retrieval operations.
+*
+* Supports transformations via query parameters for on-demand media processing across all supported formats.
+* @example
+* // eslint-disable-next-line jsdoc/match-description
+* ```ts
+* const transformer = new MediaTransformer(storage, {
+*   maxImageSize: 10 * 1024 * 1024, // 10MB
+*   maxVideoSize: 100 * 1024 * 1024, // 100MB
+*   maxAudioSize: 50 * 1024 * 1024, // 50MB
+*   cache: new MapCache(), // In-memory caching
+*   saveTransformedFiles: true // Persist transformed files to storage
+* });
+*
+* // Handle transformation via query parameters
+* const result = await transformer.handle('file-id', {
+*   width: 800,
+*   height: 600,
+*   fit: 'cover',
+*   format: 'webp',
+*   quality: 80
+* });
+*
+* // Fetch with URL query string
+* const result = await transformer.fetch('file-id', 'width=1280&height=720&codec=avc&bitrate=2000000');
+*
+* // Clear all cached transformed files
+* transformer.clearSavedTransformedFiles();
+* ```
+*
+* ## Configuration Options
+*
+* - `saveTransformedFiles`: Persist transformed files to storage for reuse (default: false)
+* - `cache`: Cache instance for in-memory caching (optional)
+* - `maxImageSize/maxVideoSize/maxAudioSize`: Size limits for processing
+* - `cacheTtl`: Cache time-to-live in seconds
+*
+* ## Supported Query Parameters
+*
+* ### Common Parameters
+* - `format`: Output format (jpeg/png/webp/avif/mp4/webm/mkv/mp3/wav/ogg/aac/flac)
+* - `quality`: Quality for images (0-100), bitrate for video/audio
+*
+* ### Image Parameters
+* - `width`: Width in pixels
+* - `height`: Height in pixels
+* - `fit`: Resize fit mode - cover/contain/fill/inside/outside
+* - `position`: Position for cover/contain fits
+* - `withoutEnlargement`: Avoid enlarging smaller images (boolean)
+* - `withoutReduction`: Avoid reducing larger images (boolean)
+* - `kernel`: Resize kernel - nearest/cubic/mitchell/lanczos2/lanczos3
+* - `fastShrinkOnLoad`: Fast shrink on load (boolean)
+* - `left/top/cropWidth/cropHeight`: Crop parameters
+* - `angle`: Rotation angle in degrees (any number, but angles other than 90°/180°/270° use interpolation and may affect quality)
+* - `background`: Background color for rotation
+* - `blur`: Apply blur effect (boolean)
+* - `sharpen`: Apply sharpening (boolean)
+* - `median`: Apply median filter with size (number)
+* // eslint-disable-next-line jsdoc/match-description
+* - `clahe`: Apply CLAHE (Contrast Limited Adaptive Histogram Equalization) (boolean)
+* - `threshold`: Apply thresholding with value (0-255)
+* - `gamma`: Apply gamma correction (boolean)
+* - `negate`: Negate (invert) the image (boolean)
+* - `normalise/normalize`: Normalise the image (boolean)
+* - `flatten`: Flatten alpha channel (boolean)
+* - `unflatten`: Unflatten alpha channel (boolean)
+* - `flip`: Flip image vertically (boolean)
+* - `flop`: Flop image horizontally (boolean)
+* - `greyscale/grayscale`: Convert to greyscale (boolean)
+* - `modulate`: Apply modulation effects (boolean)
+* - `brightness`: Brightness multiplier for modulation (number)
+* - `saturation`: Saturation multiplier for modulation (number)
+* - `hue`: Hue rotation in degrees for modulation (number)
+* // eslint-disable-next-line jsdoc/match-description
+* - `lightness`: Lightness adjustment for modulation (number)
+* - `tint`: Apply tinting (boolean)
+* - `colourspace`: Convert colourspace - srgb/rgb/cmyk/lab/b-w
+*
+* ### Video Parameters
+* - `width/height/fit`: Same as images
+* - `codec`: Video codec - avc/hevc/vp8/vp9/av1
+* - `bitrate`: Video bitrate in bits per second
+* - `frameRate`: Frame rate in Hz
+* - `keyFrameInterval`: Key frame interval in seconds
+* - `angle`: Rotation angle in degrees (any number, but angles other than 90°/180°/270° use interpolation and may affect quality)
+* - `background`: Background color for rotation
+*
+* ### Audio Parameters
+* - `sampleRate`: Sample rate in Hz
+* - `numberOfChannels`: Number of channels
+* - `codec`: Audio codec - aac/opus/mp3/vorbis/flac
+* - `bitrate`: Audio bitrate in bits per second
+*
+* ## File Persistence
+*
+* When `saveTransformedFiles` is enabled, transformed files are automatically saved to storage
+* with deterministic IDs based on the original file and transformation parameters. Subsequent
+* requests for the same transformation will serve the cached file directly, improving performance
+* and reducing processing costs.
+*/
+declare class MediaTransformer<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> {
+  private readonly storage;
+  private readonly imageTransformer?;
+  private readonly videoTransformer?;
+  private readonly audioTransformer?;
+  private readonly config;
+  private readonly logger;
+  /**
+  * Creates a new MediaTransformer instance.
+  * @param storage The storage backend for retrieving and storing media files.
+  * @param config Configuration options for the media transformer including transformer classes and settings.
+  * @throws Error if no transformer classes are provided in the configuration.
+  */
+  constructor(storage: BaseStorage<TFile, TFileReturn>, config?: MediaTransformerConfig<TFile, TFileReturn>);
+  supportedFormats(): string[];
+  /**
+  * Handles media transformation based on query parameters.
+  * @param fileId File identifier.
+  * @param query Query parameters for transformation.
+  * @returns Unified transformation result.
+  */
+  handle(fileId: string, query: Record<string, string | undefined> | URLSearchParams | string): Promise<MediaTransformResult>;
+  /**
+  * Fetches media transformation with URL query string support.
+  * @param fileId File identifier.
+  * @param queryString URL query string (e.g., "width=800&amp;height=600&amp;format=webp").
+  * @returns Unified transformation result.
+  */
+  fetch(fileId: string, queryString: string): Promise<MediaTransformResult>;
+  /**
+  * Clears cache for a specific file across all transformers.
+  * @param fileId Optional file identifier to clear cache for. If omitted, clears all cache.
+  */
+  clearCache(fileId?: string): void;
+  /**
+  * Clears all saved transformed files from storage.
+  * @remarks This is a maintenance operation and may take time for large numbers of files.
+  */
+  clearSavedTransformedFiles(): Promise<void>;
+  /**
+  * Clears saved transformed files for a specific original file.
+  * @param originalFileId Original file identifier to clear transformed files for.
+  */
+  clearSavedTransformedFilesForFile(originalFileId: string): Promise<void>;
+  /**
+  * Gets cache statistics (combined from all transformers).
+  * @returns Cache statistics for audio, image, and video transformers.
+  */
+  getCacheStats(): {
+    audio?: {
+      maxSize: number;
+      size: number;
+    };
+    image?: {
+      maxSize: number;
+      size: number;
+    };
+    video?: {
+      maxSize: number;
+      size: number;
+    };
+  };
+  /**
+  * Validates query parameters for the given media type.
+  * @param query The query parameters to validate.
+  * @param mediaType The media type being validated ('image', 'video', or 'audio').
+  * @throws {ValidationError} When invalid parameters are provided.
+  */
+  private validateQueryParameters;
+  /**
+  * Validates query parameters for image transformations. Checks for invalid video/audio-only parameters, invalid fit values, invalid rotation angles, invalid formats, and incomplete crop parameter sets.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateImageQueryParameters;
+  /**
+  * Validates query parameters for video transformations. Checks for invalid audio-only parameters, invalid fit values, invalid rotation angles, invalid codecs, invalid formats, incomplete crop parameter sets, and invalid numeric values.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateVideoQueryParameters;
+  /**
+  * Generates a unique ID for transformed files based on original file and transformations.
+  * @param originalFileId The original file identifier.
+  * @param query The transformation query parameters.
+  * @param mediaType The media type (image, video, audio).
+  * @returns Unique deterministic identifier for the transformed file.
+  * @private
+  */
+  private generateTransformedFileId;
+  /**
+  * Checks if the query contains any transformations.
+  * @param query The transformation query parameters.
+  * @returns True if any transformations are requested.
+  * @private
+  */
+  private hasTransformations;
+  /**
+  * Creates a MediaTransformResult from a stored transformed file.
+  * @param storedFile The stored transformed file.
+  * @param mediaType The media type (image, video, audio).
+  * @param originalFile The original file information.
+  * @returns Media transformation result with metadata.
+  * @private
+  */
+  private createMediaTransformResult;
+  /**
+  * Extracts format from content type.
+  * @param contentType MIME content type string.
+  * @returns Format string extracted from content type.
+  * @private
+  */
+  private getFormatFromContentType;
+  /**
+  * Saves transformed file to storage.
+  * @param result The transformation result to save.
+  * @param originalFileId The original file identifier.
+  * @param query The transformation query parameters.
+  * @param mediaType The media type (image, video, audio).
+  * @returns Promise that resolves when file is saved.
+  * @private
+  */
+  private saveTransformedFile;
+  /**
+  * Validates query parameters for audio transformations. Checks for invalid video-only parameters, invalid codecs, invalid formats, and invalid numeric values.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateAudioQueryParameters;
+  /**
+  * Handles image transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleImageTransformation;
+  /**
+  * Handles video transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleVideoTransformation;
+  /**
+  * Handles audio transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleAudioTransformation;
+  /**
+  * Parses query parameters from various input formats.
+  * @param query Query parameters in various formats.
+  * @returns Normalized MediaTransformQuery object.
+  * @private
+  */
+  private parseQuery;
+  /**
+  * Parses boolean parameter from string.
+  * @param value String value to parse.
+  * @returns Boolean value or undefined.
+  * @private
+  */
+  private parseBooleanParameter;
+  /**
+  * Parses URLSearchParams into MediaTransformQuery.
+  * @param parameters URL search parameters object.
+  * @returns MediaTransformQuery object with parsed parameters.
+  * @private
+  */
+  private parseURLSearchParams;
+  /**
+  * Detects media type from MIME type.
+  * @param contentType MIME content type string.
+  * @returns Detected media type.
+  * @throws Error if content type is missing or unsupported.
+  * @private
+  */
+  private detectMediaType;
+  /**
+  * Checks if query has image transformations.
+  * @param query The transformation query parameters.
+  * @returns True if image transformations are requested.
+  * @private
+  */
+  private hasImageTransformations;
+  /**
+  * Checks if query has video transformations.
+  * @param query The transformation query parameters.
+  * @returns True if video transformations are requested.
+  * @private
+  */
+  private hasVideoTransformations;
+  /**
+  * Checks if query has audio transformations.
+  * @param query The transformation query parameters.
+  * @returns True if audio transformations are requested.
+  * @private
+  */
+  private hasAudioTransformations;
+  /**
+  * Converts ImageTransformer result to unified format.
+  * @param result The image transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertImageResult;
+  /**
+  * Converts VideoTransformer result to unified format.
+  * @param result The video transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertVideoResult;
+  /**
+  * Converts AudioTransformer result to unified format.
+  * @param result The audio transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertAudioResult;
+}
+export { MediaTransformer as M };

package/dist/packem_shared/memory-storage.d-4EU1cMt1.d.ts

@@ -0,0 +1,101 @@
+import { Readable } from 'node:stream';
+import { F as File, k as MetaStorageOptions, M as MetaStorage, l as BaseStorageOptions, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "./storage.d-CEM1upWM.js";
+/**
+* Map-backed metadata storage used by {@link MemoryStorage}. Holds a deep-copied
+* snapshot of each `File` so callers can mutate the returned object without leaking
+* back into the backing store.
+*/
+declare class MemoryMetaStorage<T extends File = File> extends MetaStorage<T> {
+  private readonly store;
+  constructor(config?: MetaStorageOptions & {
+    store?: Map<string, T>;
+  });
+  override save(id: string, file: T): Promise<T>;
+  override get(id: string): Promise<T>;
+  override delete(id: string): Promise<void>;
+  override touch(id: string, file: T): Promise<T>;
+  /** Reset the in-memory metadata. Test/reset helper. */
+  clear(): void;
+}
+/**
+* Public options for {@link MemoryStorage}. The `initial` record lets tests seed the
+* store with a few key→bytes pairs; pass `metaStorage` to share metadata with another
+* `Files` instance (rarely needed — the memory adapter is meant to be ephemeral).
+*/
+interface MemoryStorageOptions<T extends File = File> extends BaseStorageOptions<T> {
+  /** Pre-populate the store with these key → bytes entries. */
+  initial?: Record<string, Buffer | Uint8Array | string>;
+  metaStorageConfig?: MetaStorageOptions;
+}
+/**
+* Stored entry in the backing {@link Map}. `bytes` is the raw payload; `meta` is a
+* lightweight per-key metadata snapshot so {@link MemoryStorage.list} and
+* `head` can answer without dragging the file class around.
+*/
+interface MemoryEntry {
+  bytes: Buffer;
+  contentType: string;
+  createdAt: string;
+  eTag: string;
+  metadata: Record<string, unknown>;
+  modifiedAt: string;
+}
+/**
+* In-memory storage adapter backed by a {@link Map}.
+*
+* Implements the full {@link BaseStorage} surface without touching disk or any
+* external service — useful for tests, ephemeral environments, and as a
+* reference implementation. `raw` returns the backing map so tests can inspect
+* or reset state directly:
+*
+* ```ts
+* const storage = new MemoryStorage({ initial: { "users/1.json": '{"id":1}' } });
+* storage.raw.clear();
+* ```
+*
+* Metadata is shallow-cloned on both write and read so callers never share a
+* mutable object with the store.
+*/
+declare class MemoryStorage<TFile extends File = File> extends BaseStorage<TFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  override readonly supportsRange: boolean;
+  meta: MemoryMetaStorage<TFile>;
+  private readonly store;
+  constructor(config?: MemoryStorageOptions<TFile>);
+  override get raw(): Map<string, MemoryEntry>;
+  create(fileInit: FileInit, _options?: OperationOptions): Promise<TFile>;
+  write(part: FilePart | FileQuery, _options?: OperationOptions): Promise<TFile>;
+  get({
+    id
+  }: FileQuery, _options?: OperationOptions & {
+    range?: {
+      end?: number;
+      start: number;
+    };
+  }): Promise<FileReturn>;
+  override getStream({
+    id
+  }: FileQuery, _options?: OperationOptions & {
+    range?: {
+      end?: number;
+      start: number;
+    };
+  }): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  override exists({
+    id
+  }: FileQuery): Promise<boolean>;
+  delete({
+    id
+  }: FileQuery): Promise<TFile>;
+  copy(source: string, destination: string): Promise<TFile>;
+  move(source: string, destination: string): Promise<TFile>;
+  override list(): Promise<TFile[]>;
+  override getReadUrl(key: string): Promise<string>;
+  override getUploadUrl(key: string): Promise<string>;
+}
+export { MemoryMetaStorage as M, MemoryStorage as a, MemoryStorageOptions as b };

package/dist/packem_shared/minio-NKquuBfS.js

@@ -0,0 +1 @@
+const o=e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.MINIO_ACCESS_KEY_ID??process.env.MINIO_ACCESS_KEY,r=e?.endpoint??process.env.AWS_ENDPOINT??process.env.MINIO_ENDPOINT,c=e?.region??process.env.AWS_REGION??process.env.MINIO_REGION,n=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.MINIO_SECRET_ACCESS_KEY??process.env.MINIO_SECRET_KEY;if(!c||!s||!n||!r)throw new Error("Missing required parameters for Minio client.");return{credentials:{accessKeyId:s,secretAccessKey:n},endpoint:r,forcePathStyle:!0,region:c}};export{o as default};

package/dist/packem_shared/multipart-base-BOzY19lb.js

@@ -0,0 +1 @@
+import{n as c}from"./headers-BAiAKekR.js";class p{async handlePost(e,s,n){const i={contentType:e.mediaType||"application/octet-stream",metadata:{},originalName:e.filename,size:e.size};for(const t of s)if(!t.isFile&&t.name){let o={};if(t.name==="metadata"&&t.text)try{o=JSON.parse(t.text)}catch{}else t.name&&(o={[t.name]:t.text});Object.assign(i.metadata,o)}const d=await this.storage.create(i),l=this.createStreamFromBytes(e.bytes),r=await this.storage.write({body:l,contentLength:e.size,id:d.id,start:0});let a=r;if(Object.keys(i.metadata).length>0){const t={...r.metadata,...i.metadata};a={...await this.storage.update({id:r.id},{metadata:t}),status:r.status}}const m=this.buildFileUrl(n,a);return{...a,headers:{Location:m,...a.expiredAt===void 0?{}:{"X-Upload-Expires":a.expiredAt.toString()},...a.ETag===void 0?{}:{ETag:a.ETag}},statusCode:200}}async handleDelete(e){const s=await this.storage.delete({id:e});if(s.status===void 0)throw c(404,"File not found");return{...s,headers:{},statusCode:204}}get storage(){throw new Error("storage must be implemented")}buildFileUrl(e,s){throw new Error("buildFileUrl must be implemented")}}export{p};

package/dist/packem_shared/oauth-refresh-EdGzlcOZ.js

@@ -0,0 +1 @@
+const k=e=>{let o,s;const r=e.leewayMs??6e4,a=async()=>{const c=Date.now(),n=await fetch(e.tokenUrl,{body:e.buildBody(),headers:{"Content-Type":"application/x-www-form-urlencoded"},method:"POST"});if(!n.ok){const i=await n.text().catch(()=>"");throw new Error(`${e.provider}: token exchange failed (${n.status}): ${i||n.statusText}`)}const t=await n.json();if(!t.access_token)throw new Error(`${e.provider}: token response missing access_token`);return o={expiresOnMs:c+(t.expires_in??3600)*1e3,token:t.access_token},e.onRefresh?.(t.access_token),t.refresh_token&&e.onRefreshToken?.(t.refresh_token),t.access_token};return{getAccessToken:async()=>o&&o.expiresOnMs-r>Date.now()?o.token:s||(s=a().finally(()=>{s=void 0}),s)}};export{k as c};

package/dist/packem_shared/oracleCloud-DslqNpn6.js

@@ -0,0 +1 @@
+const o=e=>{const c=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.ORACLE_CLOUD_ACCESS_KEY_ID??process.env.ORACLE_CLOUD_ACCESS_KEY,r=e?.namespace??process.env.ORACLE_CLOUD_NAMESPACE,s=e?.region??process.env.ORACLE_CLOUD_REGION,C=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.ORACLE_CLOUD_SECRET_ACCESS_KEY??process.env.ORACLE_CLOUD_SECRET_KEY;if(!r||!s||!c||!C)throw new Error("Missing required parameters for Oracle Cloud Object Storage client.");return{credentials:{accessKeyId:c,secretAccessKey:C},endpoint:`https://${r}.compat.objectstorage.${s}.oraclecloud.com`,forcePathStyle:!0,region:s}};export{o as default};

package/dist/packem_shared/ovhCloud-CMHE6uLV.js

@@ -0,0 +1 @@
+const t=e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.OVHCLOUD_ACCESS_KEY_ID??process.env.OVHCLOUD_ACCESS_KEY,n=e?.endpoint??process.env.OVHCLOUD_ENDPOINT,r=e?.region??process.env.OVHCLOUD_REGION,c=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.OVHCLOUD_SECRET_ACCESS_KEY??process.env.OVHCLOUD_SECRET_KEY;if(!r||!s||!c)throw new Error("Missing required parameters for OVHcloud Object Storage client.");const o=r.toLowerCase();return{credentials:{accessKeyId:s,secretAccessKey:c},endpoint:n??`https://s3.${o}.io.cloud.ovh.net`,forcePathStyle:!1,region:o}};export{t as default};

package/dist/packem_shared/part-match-D-9dGX42.js

@@ -0,0 +1 @@
+const e=(i,s)=>i.size!==void 0&&s.size!==void 0&&i.size>0&&s.size>0&&i.size>s.size?!1:s.size===void 0?!0:(i.start||0)+(i.contentLength||0)<=s.size;export{e as i};

package/dist/packem_shared/path-0oTTdkvl-BVg7lYf5.js

@@ -0,0 +1 @@
+const g=/^[A-Z]:\//i,a=(e="")=>e&&e.replaceAll("\\","/").replace(g,l=>l.toUpperCase()),$=/^[/\\]{2}/,u=/^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^[A-Z]:[/\\]/i,p=/^[A-Z]:$/i,A=(e,l)=>{let t="",n=0,f=-1,c=0,r;for(let s=0;s<=e.length;++s){if(s<e.length)r=e[s];else{if(r==="/")break;r="/"}if(r==="/"){if(!(f===s-1||c===1))if(c===2){if(t.length<2||n!==2||!t.endsWith(".")||t.at(-2)!=="."){if(t.length>2){const h=t.lastIndexOf("/");h===-1?(t="",n=0):(t=t.slice(0,h),n=t.length-1-t.lastIndexOf("/")),f=s,c=0;continue}else if(t.length>0){t="",n=0,f=s,c=0;continue}}l&&(t+=t.length>0?"/..":"..",n=2)}else t.length>0?t+=`/${e.slice(f+1,s)}`:t=e.slice(f+1,s),n=s-f-1;f=s,c=0}else r==="."&&c!==-1?++c:c=-1}return t},o=e=>u.test(e),d=function(e){if(e.length===0)return".";e=a(e);const l=$.exec(e),t=o(e),n=e.at(-1)==="/";return e=A(e,!t),e.length===0?t?"/":n?"./":".":(n&&(e+="/"),p.test(e)&&(e+="/"),l?t?`//${e}`:`//./${e}`:t&&!o(e)?`/${e}`:e)},x=(...e)=>{let l="";for(const t of e)if(t)if(l.length>0){const n=l.at(-1)==="/",f=t[0]==="/";n&&f?l+=t.slice(1):l+=n||f?t:`/${t}`}else l+=t;return d(l)};export{o as A,d as W,x as m};

package/dist/packem_shared/posix-dirname-CfpH5wZi.js

@@ -0,0 +1 @@
+const s=async e=>{const t=[];for await(const r of e)t.push(Buffer.from(r));return Buffer.concat(t)},n=e=>{let t=0,r=e.length;for(;t<r&&e[t]==="/";)t+=1;for(;r>t&&e[r-1]==="/";)r-=1;return t===0&&r===e.length?e:e.slice(t,r)},o=e=>{const t=n(e),r=t.lastIndexOf("/");return r<=0?e.startsWith("/")&&r===0?"/":"":e.startsWith("/")?`/${t.slice(0,r)}`:t.slice(0,r)};export{o as e,n as r,s as t};

package/dist/packem_shared/response-builder-CbSA8qPa.js

@@ -0,0 +1 @@
+import"mime";const d=(t,i={},e=200)=>({...t,headers:i,statusCode:e}),o=(t,i,e={})=>({Location:i,...t.expiredAt===void 0?{}:{"X-Upload-Expires":t.expiredAt.toString()},...t.ETag===void 0?{}:{ETag:t.ETag},...e}),n=(t,i)=>{const e=t.metadata||{},r={"x-chunked-upload":"true","x-upload-complete":i?"true":"false","x-upload-offset":String(t.bytesWritten||0)};return Array.isArray(e._chunks)&&e._chunks.length>0&&(r["x-received-chunks"]=JSON.stringify(e._chunks)),r},s=t=>({"Content-Length":String(t.size||0),"Content-Type":t.contentType,...t.expiredAt===void 0?{}:{"X-Upload-Expires":t.expiredAt.toString()},...t.modifiedAt===void 0?{}:{"Last-Modified":t.modifiedAt.toString()},...t.ETag===void 0?{}:{ETag:t.ETag}}),p=t=>{const i={};for(const[e,r]of Object.entries(t))i[e]=Array.isArray(r)?r.join(", "):String(r);return i};export{o as a,d as b,n as c,s as d,p as e};

package/dist/packem_shared/rest-base-CynUg0mH.js

@@ -0,0 +1 @@
+import{n as d}from"./headers-BAiAKekR.js";import{hasBody as _}from"type-is";import{b as h}from"./base-handler-core-EeV8gZck.js";import{ERRORS as E}from"./ERRORS-BIBxE2oR.js";import{b as g,a as C,c as S,d as X}from"./response-builder-CbSA8qPa.js";const M=(a,t={})=>{const e=h(a,"x-file-metadata",!0);if(!e)return t;try{return{...t,...JSON.parse(e)}}catch{return t}},v=a=>{if(!a)return;const t=2e3,e=a.length>t?a.slice(0,Math.max(0,t)):a,r=e.toLowerCase().indexOf("filename");if(r===-1)return;let s=r+8;for(;s<e.length&&(e[s]==="*"||e[s]===" "||e[s]==="	");)s++;if(s>=e.length||e[s]!=="=")return;for(s++;s<e.length&&(e[s]===" "||e[s]==="	");)s++;if(s>=e.length)return;let n=s,i;const o=e[s];return o==='"'||o==="'"?(n=s+1,i=e.indexOf(o,n),i===-1&&(i=e.indexOf(";",n),i===-1&&(i=e.length))):(i=e.indexOf(";",n),i===-1&&(i=e.length)),n>=i?void 0:e.substring(n,i).trim()||void 0},A=a=>{const t=h(a,"content-disposition",!0);return v(t)},L=a=>{const t=h(a,"x-chunked-upload",!0)==="true",e=h(a,"x-chunk-offset",!0),r=h(a,"x-total-size",!0),s={isChunkedUpload:t};if(e){const n=Number.parseInt(e,10);!Number.isNaN(n)&&n>=0&&(s.chunkOffset=n)}if(r){const n=Number.parseInt(r,10);!Number.isNaN(n)&&n>0&&(s.totalSize=n)}return s},P=(a,t=!1)=>{const e=h(a,"x-chunked-upload",!0)==="true";if(!(t&&e)){if(!_(a))throw d(400,"Request body is required");if(Number.parseInt(h(a,"content-length")||"0",10)===0&&!e)throw d(400,"Content-Length is required and must be greater than 0")}},B=(a,t=!1,e)=>{const r=h(a,"x-chunked-upload",!0)==="true",s=Number.parseInt(h(a,"content-length")||"0",10);if(!t&&!r&&s===0)throw d(400,"Content-Length is required and must be greater than 0");if(e!==void 0&&s>e)throw d(413,`File size exceeds maximum allowed size of ${e} bytes`);return s},W=(a,t,e="application/octet-stream")=>{const r=A(a),s=M(a),{isChunkedUpload:n,totalSize:i}=L(a),o=n&&i?i:t;return n&&i&&(s._chunkedUpload=!0,s._chunks=[],s._totalSize=i),{contentType:e,metadata:s,originalName:r,size:o}},x=(a,t)=>{if(a.length===0)return!1;const e=[...a].toSorted((n,i)=>n.offset-i.offset),r=e[0];if(r?.offset!==0)return!1;let s=r.length;for(let n=1;n<e.length;n+=1){const i=e[n];if(i){if(i.offset>s)return!1;s=Math.max(s,i.offset+i.length)}}return s>=t},T=(a,t,e,r)=>{if(Number.isNaN(a)||a<0)throw new Error("Chunk offset must be a valid non-negative number");if(t<=0)throw new Error("Chunk length must be greater than 0");if(t>r)throw new Error(`Chunk size exceeds maximum allowed size of ${r} bytes`);if(a+t>e)throw new Error(`Chunk exceeds file size. Offset: ${a}, Size: ${t}, Total: ${e}`)},D=(a,t)=>{const e=a.find(r=>r.offset===t.offset&&r.length===t.length);return e?t.checksum&&e.checksum!==t.checksum?a.map(r=>r.offset===t.offset?{...r,checksum:t.checksum}:r):a:[...a,t]},U=a=>(a.metadata||{})._chunkedUpload===!0,y=a=>{const t=a.metadata||{};if(t._chunkedUpload===!0&&typeof t._totalSize=="number")return t._totalSize};class j{async deleteSingle(t){const e=await this.storage.delete({id:t});if(e.status===void 0)throw d(404,"File not found");return{...e,headers:{},statusCode:204}}async handlePost(t,e,r,s,n){if(e&&t.size!==void 0){const l=typeof t.size=="number"?t.size:Number.parseInt(String(t.size),10);if(l>0&&l>this.storage.maxUploadSize)throw d(413,`File size exceeds maximum allowed size of ${this.storage.maxUploadSize} bytes`)}const i=await this.storage.create(t);if(e){const l=this.buildFileUrl(r,i);return g(i,{...C(i,l),"X-Chunked-Upload":"true","X-Upload-ID":i.id},201)}const o=await this.storage.write({body:s,contentLength:n,id:i.id,start:0}),c=this.buildFileUrl(r,o);return g(o,C(o,c),201)}async handlePut(t,e,r,s,n,i){let o,c=!1;try{await this.storage.getMeta(t),c=!0,i&&await this.storage.update({id:t},{metadata:i}),o=await this.storage.write({body:s,contentLength:n,id:t,start:0})}catch(f){const k=f;if(k.UploadErrorCode===E.FILE_NOT_FOUND||k.code==="ENOENT")try{const p=await this.storage.create(e);o=await this.storage.write({body:s,contentLength:n,id:p.id,start:0})}catch(p){throw p}else throw f}const l=this.buildFileUrl(r,o);return g(o,C(o,l),c?200:201)}async handlePatch(t,e,r,s,n,i){let o=await this.storage.getMeta(t);const c=o.metadata||{},l=U(o);if(l){const u=y(o);u&&o.size!==u&&(o={...o,size:u})}const f=typeof c._totalSize=="number"?c._totalSize:o.size||0;if(!l)throw d(400,"File is not a chunked upload. Use POST or PUT for full file uploads.");const k=100*1024*1024;try{T(e,r,f,k)}catch(u){throw u instanceof Error&&u.message.includes("exceeds maximum")?d(413,u.message):d(400,u instanceof Error?u.message:String(u))}if(o.status==="completed"){const u=this.buildFileUrl(n,o);return g(o,{...C(o,u),"X-Upload-Complete":"true"},200)}const p=await this.storage.withLock(`chunks:${t}`,async()=>{const u=(await this.storage.getMeta(t)).metadata??{},O=Array.isArray(u._chunks)?u._chunks:[],z=D(O,{checksum:s,length:r,offset:e});return await this.storage.update({id:t},{metadata:{...u,_chunks:z}}),z});let m=await this.storage.write({body:i,contentLength:r,id:t,start:e}),w=m.bytesWritten>=f;l&&(w=x(p,f),m.status==="completed"&&!w&&(await this.storage.update({id:t},{status:"part"}),m={...m,status:"part"}));const b=w&&m.bytesWritten!==f?{...m,bytesWritten:f}:m,N=this.buildFileUrl(n,b),F={...C(b,N),...S(b,w),"x-upload-offset":String(b.bytesWritten||0)};return g(b,F,w?200:202)}async handleHead(t){let e=await this.storage.getMeta(t);const r=U(e);if(r){const n=y(e);n&&e.size!==n&&(e={...e,size:n})}const s={...X(e)};if(r){const n=e.metadata||{},i=y(e)||e.size||0,o=Array.isArray(n._chunks)?n._chunks:[],c=x(o,i);Object.assign(s,S(e,c))}return g(e,s,200)}handleOptions(t,e){return{headers:{"Access-Control-Allow-Headers":"Authorization, Content-Type, Content-Length, Content-Disposition, X-File-Metadata, X-Chunked-Upload, X-Total-Size, X-Chunk-Offset, X-Chunk-Checksum","Access-Control-Allow-Methods":t.map(r=>r.toUpperCase()).join(", "),"Access-Control-Max-Age":86400,"X-Max-Upload-Size":String(e)},statusCode:204}}async deleteBatch(t){const e=await this.storage.deleteBatch(t);if(e.successfulCount===0&&e.failedCount>0){const r=e.failed.map(s=>s.id).join(", ");throw d(404,`Failed to delete files: ${r}`)}return{data:e.successful,headers:e.failedCount>0?{"X-Delete-Errors":JSON.stringify(e.failed),"X-Delete-Failed":String(e.failedCount),"X-Delete-Successful":String(e.successfulCount)}:{"X-Delete-Successful":String(e.successfulCount)},statusCode:e.successfulCount===t.length?204:207}}get storage(){throw new Error("storage must be implemented")}buildFileUrl(t,e){throw new Error("buildFileUrl must be implemented")}}export{j as X,B as a,A as b,L as c,W as e,v as p,P as v};

package/dist/packem_shared/restOpenApiSpec-Csv513qf.js

@@ -0,0 +1 @@
+import{createHash as n}from"node:crypto";import{createPaginationMetaSchemaObject as d,createPaginationSchemaObject as p}from"@visulima/pagination";import{sharedFileMetaSchemaObject as c,sharedErrorSchemaObject as l,sharedFileMetaExampleObject as m,sharedGetList as u,sharedGet as h,sharedGetMeta as f}from"./sharedErrorSchemaObject-YN65aAKj.js";const U=(a,e,i)=>{const{supportedTransformerFormat:o,tags:t,transformer:r}={tags:["REST"],transformer:!1,...i},s=n("sha256").update(e).digest("base64");return{components:{examples:m,parameters:{UploadIDinPath:{description:"Upload ID",in:"path",name:"id",schema:{type:"string"}}},responses:{404:{content:{"application/json":{example:{error:{code:"FileNotFound",message:"Not found"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"}},schemas:{"X-Chunk-Checksum":{description:"SHA256 checksum of the chunk data for validation. Format: 'sha256 <base64-encoded-checksum>'.",type:"string"},"X-Chunk-Offset":{description:"Byte offset for the chunk being uploaded. Required for PATCH requests in chunked uploads.",type:"integer"},"X-Chunked-Upload":{description:"Header to indicate chunked upload initialization. Set to 'true' to initialize a chunked upload session.",enum:["true"],type:"string"},"X-Chunked-Upload-Response":{description:"Indicates this is a chunked upload session. Returned in HEAD responses.",enum:["true"],type:"string"},"X-Received-Chunks":{description:"JSON array of received chunk offsets. Used for resumable uploads.",type:"string"},"X-Total-Size":{description:"Total size of the file in bytes for chunked uploads. Required when X-Chunked-Upload is 'true'.",type:"integer"},"X-Upload-Complete":{description:"Indicates if the upload is complete. Set to 'true' when all chunks have been uploaded.",enum:["true","false"],type:"string"},"X-Upload-Offset":{description:"Current upload offset in bytes. Returned in responses for chunked uploads.",type:"integer"},...p("FileMetaPagination",{$ref:"#/components/schemas/PaginationMeta"},"#/components/schemas/PaginationMeta"),...d("PaginationMeta"),...l,...c}},paths:{[`${e.replace(/\/$/,"")}/{id}/metadata`]:{get:f(`${s}RestGetFileMeta`,t)},[`${e.replace(/\/$/,"")}/{id}`]:{delete:{description:"Delete a single file",operationId:`${s}RestDeleteFile`,parameters:[{$ref:"#/components/parameters/UploadIDinPath"}],responses:{204:{description:"No Content - File deleted successfully"},404:{$ref:"#/components/responses/404"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Delete file",tags:t},get:h(`${s}RestGetFile`,t,r,o),head:{description:"Get file metadata and upload progress. For chunked uploads, returns progress information including current offset and completion status.",operationId:`${s}RestHeadFile`,parameters:[{$ref:"#/components/parameters/UploadIDinPath"}],responses:{200:{description:"OK",headers:{"Content-Length":{description:"File size in bytes",schema:{type:"integer"}},"Content-Type":{description:"MIME type of the file",schema:{type:"string"}},ETag:{description:"Entity tag for caching",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},"Last-Modified":{description:"Last modified date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}},"X-Chunked-Upload":{description:"Indicates this is a chunked upload session",schema:{$ref:"#/components/schemas/X-Chunked-Upload-Response"}},"X-Received-Chunks":{description:"JSON array of received chunk offsets (chunked uploads only)",schema:{$ref:"#/components/schemas/X-Received-Chunks"}},"X-Upload-Complete":{description:"Indicates if upload is complete (chunked uploads only)",schema:{$ref:"#/components/schemas/X-Upload-Complete"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}},"X-Upload-Offset":{description:"Current upload offset in bytes (chunked uploads only)",schema:{$ref:"#/components/schemas/X-Upload-Offset"}}}},404:{$ref:"#/components/responses/404"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Get file metadata",tags:t},patch:{description:"Upload a chunk for chunked uploads. Requires X-Chunk-Offset header and chunk data in the request body.",operationId:`${s}RestPatchChunk`,parameters:[{$ref:"#/components/parameters/UploadIDinPath"},{description:"Byte offset for this chunk",in:"header",name:"X-Chunk-Offset",required:!0,schema:{$ref:"#/components/schemas/X-Chunk-Offset"}},{description:"SHA256 checksum of the chunk (optional)",in:"header",name:"X-Chunk-Checksum",required:!1,schema:{$ref:"#/components/schemas/X-Chunk-Checksum"}}],requestBody:{content:{"application/octet-stream":{description:"Chunk data as raw binary",schema:{format:"binary",type:"string"}}},description:"Chunk data",required:!0},responses:{200:{description:"Chunk uploaded successfully",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Complete":{description:"Indicates if upload is complete",schema:{$ref:"#/components/schemas/X-Upload-Complete"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}},"X-Upload-Offset":{description:"Current upload offset after this chunk",schema:{$ref:"#/components/schemas/X-Upload-Offset"}}}},201:{description:"Upload completed (all chunks received)",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Complete":{description:"Upload is complete",schema:{enum:["true"],type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},400:{content:{"application/json":{example:{error:{code:"BadRequest",message:"X-Chunk-Offset header is required"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Bad Request"},404:{content:{"application/json":{example:{error:{code:"FileNotFound",message:"Upload session not found"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"},413:{content:{"application/json":{example:{error:{code:"RequestEntityTooLarge",message:"Chunk size exceeds maximum allowed size of 104857600 bytes"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Request Entity Too Large"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Upload chunk",tags:t},put:{description:"Create or update a file. Requires file ID in the URL path. If file exists, it will be overwritten.",operationId:`${s}RestPutFile`,parameters:[{$ref:"#/components/parameters/UploadIDinPath"}],requestBody:{content:{"application/octet-stream":{description:"File data as raw binary",schema:{format:"binary",type:"string"}}},description:"File data",required:!0},responses:{200:{description:"File updated successfully",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},201:{description:"File created successfully",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},400:{content:{"application/json":{example:{error:{code:"BadRequest",message:"Request body is required"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Bad Request"},413:{content:{"application/json":{example:{error:{code:"RequestEntityTooLarge",message:"File size exceeds maximum allowed size"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Request Entity Too Large"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Create or update file",tags:t}},[e.trimEnd()]:{delete:{description:'Delete multiple files. Supports batch delete via query parameter (?ids=id1,id2,id3) or JSON body ({ids: ["id1", "id2"]} or ["id1", "id2"]).',operationId:`${s}RestBatchDelete`,parameters:[{description:"Comma-separated list of file IDs to delete",in:"query",name:"ids",required:!1,schema:{example:"id1,id2,id3",type:"string"}}],requestBody:{content:{"application/json":{schema:{oneOf:[{properties:{ids:{description:"Array of file IDs to delete",items:{type:"string"},type:"array"}},required:["ids"],type:"object"},{description:"Array of file IDs to delete",items:{type:"string"},type:"array"}]}}},description:"File IDs to delete (optional if using query parameter)",required:!1},responses:{204:{description:"All files deleted successfully"},207:{description:"Multi-Status - Some files deleted successfully",headers:{"X-Delete-Errors":{description:"JSON array of deletion errors",schema:{type:"string"}},"X-Delete-Failed":{description:"Number of files that failed to delete",schema:{type:"integer"}},"X-Delete-Successful":{description:"Number of files successfully deleted",schema:{type:"integer"}}}},400:{content:{"application/json":{example:{error:{code:"BadRequest",message:"No file IDs provided"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Bad Request"},404:{content:{"application/json":{example:{error:{code:"FileNotFound",message:"Failed to delete files: id1, id2"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Batch delete files",tags:t},get:u(`${s}RestGetList`,t),post:{description:"Upload a file with raw binary data or initialize a chunked upload session. For chunked uploads, set X-Chunked-Upload: true and X-Total-Size headers.",operationId:`${s}RestPostFile`,parameters:[{description:"Set to 'true' to initialize a chunked upload session",in:"header",name:"X-Chunked-Upload",required:!1,schema:{$ref:"#/components/schemas/X-Chunked-Upload"}},{description:"Total size of the file in bytes (required for chunked uploads)",in:"header",name:"X-Total-Size",required:!1,schema:{$ref:"#/components/schemas/X-Total-Size"}},{description:"Optional filename",in:"header",name:"Content-Disposition",required:!1,schema:{example:'attachment; filename="photo.jpg"',type:"string"}},{description:"Optional JSON metadata",in:"header",name:"X-File-Metadata",required:!1,schema:{example:'{"description":"My photo"}',type:"string"}}],requestBody:{content:{"application/octet-stream":{description:"File data as raw binary. For chunked upload initialization, body can be empty.",schema:{format:"binary",type:"string"}}},description:"File data (optional for chunked upload initialization)",required:!1},responses:{200:{description:"The file already exists, send a resume request",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},201:{description:"File uploaded successfully or chunked upload session initialized",headers:{ETag:{description:"Upload ETag",schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},Location:{description:"File URL or chunked upload session URL",schema:{example:`${a}${e}/file-id`,format:"uri",type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},400:{content:{"application/json":{example:{error:{code:"BadRequest",message:"Request body is required for non-chunked uploads"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Bad Request"},413:{content:{"application/json":{example:{error:{code:"RequestEntityTooLarge",message:"File size exceeds maximum allowed size"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Request Entity Too Large"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Upload file or initialize chunked upload",tags:t}}}}};export{U as default};

package/dist/packem_shared/s3-base-storage-DXZYN24h.js

@@ -0,0 +1 @@
+import{Readable as w}from"node:stream";import{C,B as M,X as U,c as O}from"./storage-Cyy73Y6r.js";import{d as T}from"./detect-file-type-BA7UBLKA.js";import{throwErrorCode as m,ERRORS as y}from"./ERRORS-BIBxE2oR.js";import{createRetryWrapper as A}from"./createRetryWrapper-CxgiV_hH.js";import{y as k}from"./local-meta-storage-C2T92TYb.js";import{t as x}from"./update-size-DuNuLyxj.js";import{i as I}from"./part-match-D-9dGX42.js";import{e as R}from"./has-content-50BsqrWw.js";import{t as S}from"./get-file-status-y3wTtDQs.js";const z=(u,t)=>{const i={};return Object.keys(u).forEach(e=>{i[e]=t(u[e])}),i},v=u=>u===Number(u)?u:(C(u)??0)/1e3,B=5*1024*1024,L=16*1024*1024,N=u=>{if(u)return`bytes=${Math.max(0,u.start)}-${u.end===void 0?"":u.end}`};class b extends M{checksumTypes=["md5","crc32","crc32c","sha1","sha256"];supportsRange=!0;supportsDelimiter=!0;bucket;meta;MAX_PARTS=1e4;partSize;retry;resolvedRetryConfig;constructor(t){if(super(t),this.bucket=t.bucket,this.partSize=typeof t.partSize=="string"?U(t.partSize):t.partSize||L,this.partSize<B)throw new Error("Minimum allowed partSize value is 5MB");const i={backoffMultiplier:2,initialDelay:1e3,maxDelay:3e4,maxRetries:3,retryableStatusCodes:[408,429,500,502,503,504],shouldRetry:a=>{const s=a;return s.statusCode&&[408,429,500,502,503,504].includes(s.statusCode)?!0:s.retryable??!1},...t.retryConfig};this.retry=A(i),this.resolvedRetryConfig=i;const{metaStorage:e,metaStorageConfig:r}=t;if(e)this.meta=e;else{const a={...t,...r,logger:this.logger};"directory"in a?(this.logger?.debug("Using local meta storage"),this.meta=new k(a)):this.meta=new k(a)}this.isReady=!1,this.accessCheck().then(()=>{this.isReady=!0}).catch(a=>{this.logger?.error("Storage access check failed: %O",a)})}getRetryConfig(){return this.resolvedRetryConfig}async create(t,i){return this.instrumentOperation("create",async()=>{const e={...t};if(t.ttl){const n=typeof t.ttl=="string"?O(t.ttl):t.ttl;n!==void 0&&(e.expiredAt=Date.now()+n)}const r=new(this.getFileClass())(e);r.name=this.namingFunction(r),await this.validate(r);try{const n=await this.getMeta(r.id);if(n.bytesWritten>=0)return n}catch{}const a=this.getS3Api();let s;try{s=await this.runOperation(i,n=>a.createMultipartUpload({ACL:this.getAcl(),Bucket:this.bucket,ContentType:r.contentType,Key:r.name,Metadata:z({originalName:r.originalName,...r.metadata},o=>encodeURI(String(o)))},{signal:n}))}catch{return m(y.FILE_ERROR,"s3 create upload error")}const{UploadId:c}=s||{};return c?(r.UploadId=c,r.bytesWritten=0,this.config.clientDirectUpload&&(r.partSize??=this.partSize),await this.saveMeta(r),r.status="created",await this.onCreate(r),this.config.clientDirectUpload?this.buildPresigned(r):r):m(y.FILE_ERROR,"s3 create upload error")})}async write(t,i){return this.instrumentOperation("write",async()=>{let e;if("contentType"in t&&"metadata"in t&&!("body"in t)&&!("start"in t)?e=t:(e=await this.getMeta(t.id),await this.checkIfExpired(e)),e.status==="completed")return e;if(typeof t.size=="number"&&t.size>0&&x(e,t.size),!I(t,e))return m(y.FILE_CONFLICT);if(this.config.clientDirectUpload)return this.buildPresigned(e);e.Parts??=await this.getParts(e),e.bytesWritten=e.Parts.map(a=>a.Size||0).reduce((a,s)=>a+s,0);const r=await this.lock(t.id);try{if(R(t)){if(this.isUnsupportedChecksum(t.checksumAlgorithm))return m(y.UNSUPPORTED_CHECKSUM_ALGORITHM);if(e.Parts.length===0&&(!e.contentType||e.contentType==="application/octet-stream"))try{const d=t.body instanceof w?t.body:w.fromWeb(t.body),{fileType:g,stream:f}=await T(d);g?.mime&&(e.contentType=g.mime),t.body=f}catch{}if(e.Parts.length>this.MAX_PARTS)throw new Error(`Exceeded ${this.MAX_PARTS} as part of the upload to ${this.bucket}.`);const a=e.Parts.length+1,s=this.getS3Api(),c=e.UploadId;if(!c)throw new Error("UploadId is required");const n=t.body,o=n instanceof Uint8Array,{ETag:l}=await this.runOperation(i,d=>s.uploadPart({Body:n,Bucket:this.bucket,ContentLength:t.contentLength||0,Key:e.name,PartNumber:a,UploadId:c,...t.checksumAlgorithm==="md5"?{ContentMD5:t.checksum}:{}},{signal:d}),{replayable:o}),p={ETag:l,PartNumber:a,Size:t.contentLength};e.Parts=[...e.Parts,p],e.bytesWritten+=t.contentLength||0}if(this.cache.set(e.id,e),e.status=S(e),e.status==="completed"){const[a]=await this.internalOnComplete(e);delete e.Parts,e.uri=a.Location,e.ETag=a.ETag}}finally{await this.unlock(t.id,r)}return e})}async delete({id:t},i){return this.instrumentOperation("delete",async()=>{const e=await this.getMeta(t);e.status="deleted",await this.abortMultipartUpload(e,i),await this.deleteMeta(e.id);const r={...e};return await this.onDelete(r),r})}async copy(t,i,e){return this.instrumentOperation("copy",async()=>{b.assertSafeId(t),b.assertSafeId(i);const r=await this.getMeta(t),a=`${this.bucket}/${t}`,s=this.bucket,c=i,n=this.getS3Api();return await this.runOperation(e,o=>n.copyObject({Bucket:s,CopySource:a,Key:c,...e?.storageClass&&{StorageClass:e.storageClass}},{signal:o})),{...r,id:c,name:c}})}async move(t,i,e){return this.instrumentOperation("move",async()=>{await this.copy(t,i,e);const r=this.getS3Api();return await this.runOperation(e,a=>r.deleteObject({Bucket:this.bucket,Key:t},{signal:a})),await this.getMeta(i)})}async list(t=1e3,i){return this.instrumentOperation("list",async()=>{const e=this.getS3Api(),r=Math.min(t,1e3);let a={Bucket:this.bucket,MaxKeys:r};const s=[];let c=!0;for(;c&&s.length<t;)try{const n=await this.runOperation(i,o=>e.listObjectsV2(a,{signal:o}));for(const{Key:o,LastModified:l}of n?.Contents||[]){if(s.length>=t)break;o!==void 0&&s.push({id:o,...l&&{createdAt:l}})}c=n.IsTruncated||!1,c&&n.NextContinuationToken&&s.length<t&&(a={...a,ContinuationToken:n.NextContinuationToken,MaxKeys:Math.min(r,t-s.length)})}catch(n){const o=this.normalizeError(n instanceof Error?n:new Error(String(n)));throw await this.onError(o),n}return s},{limit:t})}async listDirectory(t){return this.instrumentOperation("listDirectory",async()=>{const i=this.getS3Api(),e=t?.limit??1e3,r=Math.min(e,1e3);let a={Bucket:this.bucket,Delimiter:t?.delimiter,MaxKeys:r,...t?.prefix!==void 0&&{Prefix:t.prefix}};const s=[],c=new Set;let n=!0;for(;n&&s.length<e;)try{const o=await this.runOperation(t,l=>i.listObjectsV2(a,{signal:l}));for(const{Prefix:l}of o?.CommonPrefixes||[])l!==void 0&&c.add(l);for(const{Key:l,LastModified:p}of o?.Contents||[]){if(s.length>=e)break;l!==void 0&&s.push({id:l,...p&&{createdAt:p}})}n=o.IsTruncated||!1,n&&o.NextContinuationToken&&s.length<e&&(a={...a,ContinuationToken:o.NextContinuationToken,MaxKeys:Math.min(r,e-s.length)})}catch(o){const l=this.normalizeError(o instanceof Error?o:new Error(String(o)));throw await this.onError(l),o}return{files:s,prefixes:[...c]}},{limit:t?.limit??1e3})}async exists({id:t},i){return this.instrumentOperation("exists",async()=>{try{await this.getMeta(t);const e=this.getS3Api();return await this.runOperation(i,r=>e.headObject({Bucket:this.bucket,Key:t},{signal:r})),!0}catch{return!1}})}async get({id:t},i){return this.instrumentOperation("get",async()=>{const e=this.getS3Api(),r=N(i?.range),{Body:a,ContentLength:s,ContentType:c,ETag:n,Expires:o,LastModified:l,Metadata:p}=await this.runOperation(i,h=>e.getObject({Bucket:this.bucket,Key:t,...r!==void 0&&{Range:r}},{signal:h}));await this.checkIfExpired({expiredAt:o});const d=[];if(a)if(a instanceof w)for await(const h of a)d.push(h instanceof Uint8Array?h:new Uint8Array(h));else{const h=a.getReader();try{for(;;){const{done:P,value:E}=await h.read();if(P)break;d.push(E)}}finally{h.releaseLock()}}const{originalName:g,...f}=p||{};return{content:Buffer.concat(d),contentType:c,ETag:n,expiredAt:o,id:t,metadata:f,modifiedAt:l,name:t,originalName:g||t,size:Number(s)}})}async buildPresigned(t){const i=t;if(i.Parts?.length||(i.Parts=await this.getParts(t)),i.bytesWritten=i.Parts.map(e=>e.Size||0).reduce((e,r)=>e+r,0),t.status=S(i),i.partsUrls?.length||(i.partsUrls=await this.getPartsPresignedUrls(t)),t.status==="completed"){const[e]=await this.internalOnComplete(t);return delete i.Parts,i.uri=e.Location,t}return t}async getPartsPresignedUrls(t){t.partSize??=this.partSize;const i=t.UploadId;if(!i)throw new Error("UploadId is required for getting presigned URLs");const e=Math.trunc(t.size/this.partSize)+1,r=[],a=Math.trunc(v(this.config.expiration?.maxAge||"6hrs")),s=this.getS3Api();for(let c=0;c<e;c++)r.push(s.getPresignedUrl({Bucket:this.bucket,expiresIn:a,Key:t.name,PartNumber:c+1,UploadId:i}));return Promise.all(r)}async getParts(t){const i=this.getS3Api(),e=t.UploadId;if(!e)throw new Error("UploadId is required");const{Parts:r=[]}=await this.runOperation(void 0,a=>i.listParts({Bucket:this.bucket,Key:t.name,UploadId:e},{signal:a}));return r}completeMultipartUpload(t){const i=this.getS3Api(),e=t.UploadId;if(!e)throw new Error("UploadId is required");const r=t.Parts?.map(({ETag:a,PartNumber:s})=>{if(!a||!s)throw new Error("ETag and PartNumber are required");return{ETag:a,PartNumber:s}})||[];return this.runOperation(void 0,a=>i.completeMultipartUpload({Bucket:this.bucket,Key:t.name,Parts:r,UploadId:e},{signal:a}))}async abortMultipartUpload(t,i){if(t.status!=="completed")try{const e=this.getS3Api(),r=t.UploadId;if(!r)return;await this.runOperation(i,a=>e.abortMultipartUpload({Bucket:this.bucket,Key:t.name,UploadId:r},{signal:a}))}catch(e){this.logger?.error("abortMultipartUploadError: ",e);const r=this.normalizeError(e instanceof Error?e:new Error(String(e)));await this.onError(r)}}internalOnComplete=async t=>{const[i]=await Promise.all([this.completeMultipartUpload(t),this.deleteMeta(t.id)]);return[i,t]}}export{b as S,N as b};