@visulima/storage 1.0.9 → 1.0.10

package/dist/transformer/index.d.ts

@@ -1,45 +1,45 @@
-export { type d as AudioChannelMixOptions, type c as AudioResampleOptions, type e as AudioTransformOptions, type b as AudioTransformResult, type f as AudioTransformationStep, type A as AudioTransformerConfig, B as BaseTransformer, type C as CropOptions, type h as ImageFormat, type I as ImageTransformerConfig, type U as MediaTransformQuery, type a as MediaTransformResult, type W as MediaTransformationStep, type M as MediaTransformerConfig, type R as ResizeOptions, type g as RotateOptions, type i as TransformOptions, type T as TransformResult, type z as TransformationStep, type K as VideoCropOptions, type H as VideoResizeOptions, type N as VideoRotateOptions, type O as VideoTransformOptions, type F as VideoTransformResult, type Q as VideoTransformationStep, type V as VideoTransformerConfig } from "../packem_shared/types.d-CrUWY4On.js";
-export { M as MediaTransformer } from "../packem_shared/media-transformer.d-Quf4ai47.js";
-import { g as FileReturn } from "../packem_shared/storage.d-CEM1upWM.js";
+export { type d as AudioChannelMixOptions, type c as AudioResampleOptions, type e as AudioTransformOptions, type b as AudioTransformResult, type f as AudioTransformationStep, type A as AudioTransformerConfig, B as BaseTransformer, type C as CropOptions, type h as ImageFormat, type I as ImageTransformerConfig, type U as MediaTransformQuery, type a as MediaTransformResult, type W as MediaTransformationStep, type M as MediaTransformerConfig, type R as ResizeOptions, type g as RotateOptions, type i as TransformOptions, type T as TransformResult, type z as TransformationStep, type K as VideoCropOptions, type H as VideoResizeOptions, type N as VideoRotateOptions, type O as VideoTransformOptions, type F as VideoTransformResult, type Q as VideoTransformationStep, type V as VideoTransformerConfig } from "../packem_shared/types.d-CAAzKiI6.js";
+export { M as MediaTransformer } from "../packem_shared/media-transformer.d-CvMFjINm.js";
+import { g as FileReturn } from "../packem_shared/storage.d-DIav_lF1.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 /**
-* Check if a content type is valid for a specific media type.
-* @param contentType MIME content type string to validate
-* @param expectedType Expected media type ('image', 'video', or 'audio')
-* @returns True if the content type is valid for the expected media type
-*/
+ * Check if a content type is valid for a specific media type.
+ * @param contentType MIME content type string to validate
+ * @param expectedType Expected media type ('image', 'video', or 'audio')
+ * @returns True if the content type is valid for the expected media type
+ */
 declare const isValidMediaType: (contentType: string | undefined, expectedType: "image" | "video" | "audio") => boolean;
 /**
-* Get format (extension) from content type using mime package.
-* @param contentType MIME content type string to extract format from
-* @returns Format string or undefined if not found
-*/
+ * Get format (extension) from content type using mime package.
+ * @param contentType MIME content type string to extract format from
+ * @returns Format string or undefined if not found
+ */
 declare const getFormatFromContentType: (contentType: string | undefined) => string | undefined;
 /**
-* Validate a media file for a specific type with size and format checks.
-* @param file File to validate
-* @param expectedType Expected media type ('image', 'video', or 'audio')
-* @param config Validation configuration with optional maxSize and supportedFormats
-* @param config.maxSize Maximum allowed file size in bytes
-* @param config.supportedFormats Array of supported file formats
-* @throws Error if validation fails (size exceeded, wrong type, or unsupported format)
-*/
+ * Validate a media file for a specific type with size and format checks.
+ * @param file File to validate
+ * @param expectedType Expected media type ('image', 'video', or 'audio')
+ * @param config Validation configuration with optional maxSize and supportedFormats
+ * @param config.maxSize Maximum allowed file size in bytes
+ * @param config.supportedFormats Array of supported file formats
+ * @throws Error if validation fails (size exceeded, wrong type, or unsupported format)
+ */
 declare const validateMediaFile: (file: FileReturn, expectedType: "image" | "video" | "audio", config?: {
   maxSize?: number;
   supportedFormats?: string[];
 }) => void;
 /**
-* Validate that a content type is known and supported by the mime package.
-* @param contentType MIME content type string to check
-* @returns True if the content type is known and has a registered extension
-*/
+ * Validate that a content type is known and supported by the mime package.
+ * @param contentType MIME content type string to check
+ * @returns True if the content type is known and has a registered extension
+ */
 declare const isKnownContentType: (contentType: string | undefined) => boolean;
 /**
-* Custom error class for validation failures
-*/
+ * Custom error class for validation failures
+ */
 declare class ValidationError extends Error {
   readonly code: string;
   readonly details: {
@@ -49,14 +49,14 @@ declare class ValidationError extends Error {
     validParams: string[];
   };
   /**
-  * Creates a new ValidationError instance with detailed error information.
-  * @param message Human-readable error message describing the validation failure
-  * @param code Machine-readable error code for programmatic error handling
-  * @param mediaType The media type where validation failed ('image', 'video', or 'audio')
-  * @param invalidParameters Array of parameter names that were invalid
-  * @param validParameters Array of valid parameter names or values
-  * @param suggestions Optional array of suggested corrections or valid values
-  */
+   * Creates a new ValidationError instance with detailed error information.
+   * @param message Human-readable error message describing the validation failure
+   * @param code Machine-readable error code for programmatic error handling
+   * @param mediaType The media type where validation failed ('image', 'video', or 'audio')
+   * @param invalidParameters Array of parameter names that were invalid
+   * @param validParameters Array of valid parameter names or values
+   * @param suggestions Optional array of suggested corrections or valid values
+   */
   constructor(message: string, code: string, mediaType: string, invalidParameters: string[], validParameters: string[], suggestions?: string[]);
 }
 export { ValidationError, getFormatFromContentType, isKnownContentType, isValidMediaType, validateMediaFile };

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

@@ -1,147 +1,147 @@
-import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-CEM1upWM.js";
-import { V as VideoTransformerConfig, F as VideoTransformResult, H as VideoResizeOptions, K as VideoCropOptions, N as VideoRotateOptions, O as VideoTransformOptions, Q as VideoTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-CrUWY4On.js";
+import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-DIav_lF1.js";
+import { V as VideoTransformerConfig, F as VideoTransformResult, H as VideoResizeOptions, K as VideoCropOptions, N as VideoRotateOptions, O as VideoTransformOptions, Q as VideoTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-CAAzKiI6.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 /**
-* Video transformer that uses storage backends and Mediabunny library to retrieve and transform videos.
-* @template TFile The file type used by this transformer.
-* @template TFileReturn The return type for file retrieval operations.
-*
-* Supports video transformations with query parameters for on-demand video processing.
-* @example
-* ```ts
-* const transformer = new VideoTransformer(storage, {
-*   maxVideoSize: 100 * 1024 * 1024, // 100MB
-*   cache: new Map()
-* });
-*
-* // Programmatic usage - resize a video
-* const result = await transformer.resize('video-id', {
-*   width: 1920,
-*   height: 1080,
-*   fit: 'contain'
-* });
-*
-* // URL-based transformations
-* // GET /files/video-id?width=1280&height=720&fit=cover&bitrate=2000000
-* // GET /files/video-id?codec=vp9&bitrate=1000000
-* ```
-*
-* ## Supported Query Parameters
-*
-* - `width`: Width in pixels (Number)
-* - `height`: Height in pixels (Number)
-* - `fit`: Resize fit mode - cover/contain/fill/inside/outside
-* - `codec`: Video codec - avc/hevc/vp8/vp9/av1
-* - `bitrate`: Video bitrate in bits per second (Number)
-* - `frameRate`: Frame rate in Hz (Number)
-* - `format`: Output format - mp4/webm/mkv/ogg
-*/
+ * Video transformer that uses storage backends and Mediabunny library to retrieve and transform videos.
+ * @template TFile The file type used by this transformer.
+ * @template TFileReturn The return type for file retrieval operations.
+ *
+ * Supports video transformations with query parameters for on-demand video processing.
+ * @example
+ * ```ts
+ * const transformer = new VideoTransformer(storage, {
+ *   maxVideoSize: 100 * 1024 * 1024, // 100MB
+ *   cache: new Map()
+ * });
+ *
+ * // Programmatic usage - resize a video
+ * const result = await transformer.resize('video-id', {
+ *   width: 1920,
+ *   height: 1080,
+ *   fit: 'contain'
+ * });
+ *
+ * // URL-based transformations
+ * // GET /files/video-id?width=1280&height=720&fit=cover&bitrate=2000000
+ * // GET /files/video-id?codec=vp9&bitrate=1000000
+ * ```
+ *
+ * ## Supported Query Parameters
+ *
+ * - `width`: Width in pixels (Number)
+ * - `height`: Height in pixels (Number)
+ * - `fit`: Resize fit mode - cover/contain/fill/inside/outside
+ * - `codec`: Video codec - avc/hevc/vp8/vp9/av1
+ * - `bitrate`: Video bitrate in bits per second (Number)
+ * - `frameRate`: Frame rate in Hz (Number)
+ * - `format`: Output format - mp4/webm/mkv/ogg
+ */
 declare class VideoTransformer<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> extends BaseTransformer<VideoTransformerConfig, VideoTransformResult<TFileReturn>, TFile, TFileReturn> {
   /**
-  * Creates a new VideoTransformer instance.
-  * @param storage The storage backend for retrieving and storing video files.
-  * @param config Configuration options for video transformation including cache settings, codec defaults, and size limits.
-  */
+   * Creates a new VideoTransformer instance.
+   * @param storage The storage backend for retrieving and storing video files.
+   * @param config Configuration options for video transformation including cache settings, codec defaults, and size limits.
+   */
   constructor(storage: BaseStorage<TFile, TFileReturn>, config?: VideoTransformerConfig);
   /**
-  * Resizes a video to specified dimensions with optional fit mode.
-  * @param fileId Unique identifier of the video file to resize.
-  * @param options Resize options including width, height, and fit mode.
-  * @returns Promise resolving to transformed video result.
-  */
+   * Resizes a video to specified dimensions with optional fit mode.
+   * @param fileId Unique identifier of the video file to resize.
+   * @param options Resize options including width, height, and fit mode.
+   * @returns Promise resolving to transformed video result.
+   */
   resize(fileId: string, options: VideoResizeOptions): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Crops a video to the specified region.
-  * @param fileId Unique identifier of the video file to crop.
-  * @param options Crop options including region coordinates.
-  * @returns Promise resolving to transformed video result.
-  */
+   * Crops a video to the specified region.
+   * @param fileId Unique identifier of the video file to crop.
+   * @param options Crop options including region coordinates.
+   * @returns Promise resolving to transformed video result.
+   */
   crop(fileId: string, options: VideoCropOptions): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Rotates a video by the specified angle.
-  * @param fileId Unique identifier of the video file to rotate.
-  * @param options Rotation configuration with angle in degrees and optional background color.
-  * @returns Promise resolving to transformed video result.
-  */
+   * Rotates a video by the specified angle.
+   * @param fileId Unique identifier of the video file to rotate.
+   * @param options Rotation configuration with angle in degrees and optional background color.
+   * @returns Promise resolving to transformed video result.
+   */
   rotate(fileId: string, options: VideoRotateOptions): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Converts video format or codec.
-  * @param fileId Unique identifier of the video file to convert.
-  * @param format Target video format (e.g., "mp4", "webm", "mkv").
-  * @param options Video transformation options including quality, bitrate, and codec settings.
-  * @returns Promise resolving to transformed video result with updated format metadata.
-  */
+   * Converts video format or codec.
+   * @param fileId Unique identifier of the video file to convert.
+   * @param format Target video format (e.g., "mp4", "webm", "mkv").
+   * @param options Video transformation options including quality, bitrate, and codec settings.
+   * @returns Promise resolving to transformed video result with updated format metadata.
+   */
   convertFormat(fileId: string, format: string, options?: VideoTransformOptions): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Transcodes video to different codec.
-  * @param fileId Unique identifier of the video file to transcode.
-  * @param codec Target video codec (e.g., "avc", "hevc", "vp9").
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed video result.
-  */
+   * Transcodes video to different codec.
+   * @param fileId Unique identifier of the video file to transcode.
+   * @param codec Target video codec (e.g., "avc", "hevc", "vp9").
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed video result.
+   */
   transcode(fileId: string, codec: VideoTransformOptions["codec"], options?: Omit<VideoTransformOptions, "codec">): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Applies a custom transformation pipeline to a video.
-  * @param fileId Unique identifier of the video file to transform.
-  * @param steps Array of transformation steps to apply in sequence.
-  * @returns Promise resolving to transformed video result.
-  */
+   * Applies a custom transformation pipeline to a video.
+   * @param fileId Unique identifier of the video file to transform.
+   * @param steps Array of transformation steps to apply in sequence.
+   * @returns Promise resolving to transformed video result.
+   */
   transform(fileId: string, steps: VideoTransformationStep[]): Promise<VideoTransformResult<TFileReturn>>;
   /**
-  * Applies multiple transformations in sequence using Mediabunny.
-  * @param buffer The original video buffer.
-  * @param steps Array of video transformation steps to apply.
-  * @returns Promise resolving to transformed video buffer.
-  * @private
-  */
+   * Applies multiple transformations in sequence using Mediabunny.
+   * @param buffer The original video buffer.
+   * @param steps Array of video transformation steps to apply.
+   * @returns Promise resolving to transformed video buffer.
+   * @private
+   */
   private applyTransformations;
   /**
-  * Converts transformation steps to Mediabunny video options.
-  * @param steps Array of video transformation steps to convert.
-  * @returns Mediabunny video options object for conversion.
-  * @private
-  */
+   * Converts transformation steps to Mediabunny video options.
+   * @param steps Array of video transformation steps to convert.
+   * @returns Mediabunny video options object for conversion.
+   * @private
+   */
   private stepsToVideoOptions;
   /**
-  * Determines output format based on transformation steps.
-  * @param steps Array of video transformation steps.
-  * @returns Mediabunny output format instance (defaults to MP4).
-  * @private
-  */
+   * Determines output format based on transformation steps.
+   * @param steps Array of video transformation steps.
+   * @returns Mediabunny output format instance (defaults to MP4).
+   * @private
+   */
   private determineOutputFormat;
   /**
-  * Converts format string to Mediabunny output format.
-  * @param format Video format string (mp4, webm, mkv, ogg).
-  * @returns Mediabunny output format instance.
-  * @private
-  */
+   * Converts format string to Mediabunny output format.
+   * @param format Video format string (mp4, webm, mkv, ogg).
+   * @returns Mediabunny output format instance.
+   * @private
+   */
   private formatStringToOutputFormat;
   /**
-  * Validates that the file is a supported video.
-  * @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 video.
-  * @private
-  */
+   * Validates that the file is a supported video.
+   * @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 video.
+   * @private
+   */
   private validateVideo;
   /**
-  * Creates transformation result with metadata.
-  * @param buffer The transformed video buffer.
-  * @param originalFile The original file information.
-  * @returns Video transformation result with metadata.
-  * @private
-  */
+   * Creates transformation result with metadata.
+   * @param buffer The transformed video buffer.
+   * @param originalFile The original file information.
+   * @returns Video transformation result with metadata.
+   * @private
+   */
   private createTransformResult;
   /**
-  * Generates cache key for transformation.
-  * @param fileId The file identifier.
-  * @param steps Array of transformation steps.
-  * @returns Unique cache key string.
-  * @private
-  */
+   * Generates cache key for transformation.
+   * @param fileId The file identifier.
+   * @param steps Array of transformation steps.
+   * @returns Unique cache key string.
+   * @private
+   */
   private generateCacheKey;
 }
 export { VideoTransformer as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/storage",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Server-side file-storage abstraction - store files in a web-accessible location via a simplified API. Includes S3, Azure, GCS, local filesystem and 20+ other backends with TUS/multipart/REST upload handlers and the most convenient features of each.",
   "keywords": [
     "anolilab",

package/dist/packem_shared/BoxMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/BunS3MetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/BunnyMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/CloudinaryMetaStorage-DPVnmNe5.js

@@ -1 +0,0 @@
-import{y as s}from"./local-meta-storage-iuJnu90B.js";class o extends s{constructor(r){super(r)}}export{o as default};

package/dist/packem_shared/DropboxMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/FirebaseMetaStorage-DPVnmNe5.js

@@ -1 +0,0 @@
-import{y as s}from"./local-meta-storage-iuJnu90B.js";class o extends s{constructor(r){super(r)}}export{o as default};

package/dist/packem_shared/FtpMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/GoogleDriveMetaStorage-Cbwa1CHV.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(t){super(t)}}export{o as default};

package/dist/packem_shared/NetlifyBlobMetaStorage-DPVnmNe5.js

@@ -1 +0,0 @@
-import{y as s}from"./local-meta-storage-iuJnu90B.js";class o extends s{constructor(r){super(r)}}export{o as default};

package/dist/packem_shared/OneDriveMetaStorage-Cbwa1CHV.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(t){super(t)}}export{o as default};

package/dist/packem_shared/PocketBaseMetaStorage-DOTLwVE7.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class e extends r{constructor(o){super(o)}}export{e as default};

package/dist/packem_shared/SftpMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/SharePointMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/SupabaseMetaStorage-Cbwa1CHV.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(t){super(t)}}export{o as default};

package/dist/packem_shared/UploadThingMetaStorage-DPVnmNe5.js

@@ -1 +0,0 @@
-import{y as s}from"./local-meta-storage-iuJnu90B.js";class o extends s{constructor(r){super(r)}}export{o as default};

package/dist/packem_shared/VercelBlobMetaStorage-BSn6Qfnf.js

@@ -1 +0,0 @@
-import{y as r}from"./local-meta-storage-iuJnu90B.js";class o extends r{constructor(e){super(e)}}export{o as default};

package/dist/packem_shared/disk-storage-CsQcYW3s.js

@@ -1 +0,0 @@
-import{createReadStream as _,createWriteStream as C}from"node:fs";import{truncate as P,stat as F,open as L,copyFile as A}from"node:fs/promises";import{PassThrough as W,Transform as x,pipeline as U}from"node:stream";import{y as D,d as I,z as B,l as M,V,x as Q,f as H}from"./local-meta-storage-iuJnu90B.js";import{A as G,m as K}from"./path-0oTTdkvl-DvWvbDbh.js";import{F as X}from"./index-nZWCQrSe.js";import{d as Y}from"./detect-file-type-BA7UBLKA.js";import{throwErrorCode as g,ERRORS as h,isUploadError as q}from"./ERRORS-BIBxE2oR.js";import{createHash as j}from"node:crypto";import{B as J,a as Z,c as $}from"./storage-0j5nCAUp.js";import tt from"./File-W8aOo15X.js";import{t as k}from"./get-file-status-y3wTtDQs.js";import{t as et}from"./update-size-DuNuLyxj.js";import{i as rt}from"./part-match-D-9dGX42.js";import{e as it}from"./has-content-50BsqrWw.js";class st extends x{constructor(t,e,r="base64"){super(),this.checksum=t,this.algorithm=e,this.encoding=r,this.hash=j(e)}checksum;algorithm;encoding;length=0;digest="";hash;get calculatedDigest(){return this.digest}_transform(t,e,r){this.push(t),this.hash.update(t),this.length+=t.length,r()}_flush(t){this.digest=this.hash.digest(this.encoding),this.checksum&&this.checksum!==this.digest?t(new Error("Checksum mismatch")):t()}}const at=(S,t,e="base64")=>t?new st(S,t,e):new W;class nt extends x{constructor(t=Number.POSITIVE_INFINITY){super(),this.limit=t}limit;length=0;_transform(t,e,r){const a=this.length+t.length;this.limit>=a?(this.push(t),this.length=a,r()):r(new Error("Stream length limit exceeded"))}}class w extends J{static name="disk";checksumTypes=["md5","sha1"];supportsRange=!0;get raw(){return{directory:this.directory}}directory;meta;constructor(t){const e={...t,fileNameValidation:t.fileNameValidation??Z};if(super(e),this.directory=e.directory,e.metaStorage)this.meta=e.metaStorage;else{const r={...e,...e.metaStorageConfig,logger:this.logger};this.meta=new D(r)}this.isReady=!1,this.accessCheck().then(()=>{this.isReady=!0}).catch(r=>{this.logger?.error("Storage access check failed: %O",r)})}normalizeError(t){return super.normalizeError(t)}async create(t){return this.instrumentOperation("create",async()=>{const e={...t};if(t.ttl){const i=typeof t.ttl=="string"?$(t.ttl):t.ttl;i!==void 0&&(e.expiredAt=Date.now()+i)}e.size!==void 0&&Number(e.size)<0&&g(h.REQUEST_ENTITY_TOO_LARGE,"Request entity too large");const r=new tt(e);try{const i=await this.getMeta(r.id);if(i.status==="completed")return i}catch{}r.name=this.namingFunction(r),(r.size===void 0||Number.isNaN(r.size))&&(r.size===void 0||(r.size=this.maxUploadSize)),await this.validate(r);const a=this.getFilePath(r.name);try{await I(a),r.bytesWritten=0}catch(i){const s=this.normalizeError(i instanceof Error?i:new Error(String(i)));await this.onError(s),g(h.FILE_ERROR,s.message)}return r.status=k(r),await this.saveMeta(r),await this.onCreate(r),r})}async write(t){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(t.size!==void 0&&et(e,t.size),!rt(t,e))return g(h.FILE_CONFLICT);const r=this.getFilePath(e.name),a=await this.lock(r);try{const i=t.start||0;if(await I(r),e.bytesWritten===0&&(e.bytesWritten=i),it(t)){if(this.isUnsupportedChecksum(t.checksumAlgorithm))return g(h.UNSUPPORTED_CHECKSUM_ALGORITHM);if((t.start===0||t.start===void 0)&&(e.bytesWritten===0||Number.isNaN(e.bytesWritten))&&(!e.contentType||e.contentType==="application/octet-stream"))try{const{fileType:u,stream:d}=await Y(t.body);u?.mime&&(e.contentType=u.mime),t.body=d}catch{}const s=t.signal,o={...e,...t,body:t.body};s&&(o.signal=s);const[n,m]=await this.lazyWrite(o);if(m)return await P(r,e.bytesWritten),g(m);const l=i+(t.contentLength||0);e.bytesWritten=Math.max(e.bytesWritten||0,l),e.bytesWritten=Math.max(e.bytesWritten||0,n),e.status=k(e),await this.saveMeta(e)}else await I(r),e.bytesWritten=0;return e}catch(i){if(q(i))throw i;const s=this.normalizeError(i instanceof Error?i:new Error(String(i)));return await this.onError(s),g(h.FILE_ERROR,(typeof s.message=="string"?s.message:String(i))||String(i))}finally{await this.unlock(r,a)}})}async get({id:t},e){return this.instrumentOperation("get",async()=>{const r=await this.checkIfExpired(await this.meta.get(t)),{bytesWritten:a,contentType:i,expiredAt:s,metadata:o,modifiedAt:n,name:m,originalName:l,size:u}=r,d=this.getFilePath(m),E=e?.range,b=async c=>{const y=c;if(y.code==="ENOENT"||y.code==="EPERM"){const p=this.normalizeError(c instanceof Error?c:new Error(y.message||String(c)));return await this.onError(p),g(h.FILE_NOT_FOUND,(typeof p.message=="string"?p.message:String(c))||String(c))}const f=this.normalizeError(c instanceof Error?c:new Error(String(c)));throw await this.onError(f),c};if(E){let c;try{c=await F(d)}catch(R){return b(R)}const y=c.size,f=Math.max(0,E.start),p=E.end===void 0?y-1:Math.min(y-1,E.end);if(f>p||f>=y)return g(h.BAD_REQUEST,`Invalid range ${f}-${E.end??""}`);const N=p-f+1,z=Buffer.allocUnsafe(N);let O;try{O=await L(d,"r"),await O.read(z,0,N,f)}catch(R){return b(R)}finally{await O?.close()}const v=`W/"${y.toString(16)}-${Math.trunc(c.mtimeMs).toString(16)}-${f}-${p}"`;return{content:z,contentType:i,ETag:v,expiredAt:s,id:t,metadata:o,modifiedAt:n,name:m,originalName:l,size:N}}let T;try{T=await B(d,{buffer:!0})}catch(c){return b(c)}return{content:T,contentType:i,ETag:X(T),expiredAt:s,id:t,metadata:o,modifiedAt:n,name:m,originalName:l,size:u||a}})}async exists({id:t}){return this.instrumentOperation("exists",async()=>{try{const e=await this.getMeta(t),r=this.getFilePath(e.name);return await F(r),!0}catch{return!1}})}async getStream({id:t}){return this.instrumentOperation("getStream",async()=>{try{const e=await this.checkIfExpired(await this.meta.get(t)),{bytesWritten:r,contentType:a,expiredAt:i,modifiedAt:s,name:o,size:n}=e,m=_(this.getFilePath(o));return{headers:{"Content-Length":String(n||r),"Content-Type":a,...i&&{"X-Upload-Expires":i.toString()},...s&&{"Last-Modified":s.toString()}},size:n||r,stream:m}}catch(e){const r=this.normalizeError(e instanceof Error?e:new Error(String(e)));throw await this.onError(r),g(h.FILE_NOT_FOUND,(typeof r.message=="string"?r.message:String(e))||String(e))}})}async delete({id:t}){return this.instrumentOperation("delete",async()=>{const e=await this.getMeta(t);await M(this.getFilePath(e.name)),await this.deleteMeta(t);const r={...e,status:"deleted"};return await this.onDelete(r),r})}async copy(t,e){return this.instrumentOperation("copy",async()=>{w.assertSafeId(t),w.assertSafeId(e);const r=await this.getMeta(t);return await A(this.getFilePath(r.name),this.getFilePath(e)),{...r,name:e}})}async move(t,e){return this.instrumentOperation("move",async()=>{w.assertSafeId(t),w.assertSafeId(e);const r=await this.getMeta(t),a=this.getFilePath(r.name),i=this.getFilePath(e);try{await V(a,i)}catch(s){if(s?.code==="EXDEV")await A(a,i),await M(a);else{const o=this.normalizeError(s instanceof Error?s:new Error(String(s)));throw await this.onError(o),s}}return{...r,id:r.id,name:e}})}async list(){return this.instrumentOperation("list",async()=>{const t={followSymlinks:!1,includeDirs:!1,includeFiles:!0,skip:["*.META$"]},e=[],{directory:r}=this,a=s=>s.replaceAll("\\","/"),i=a(r);for await(const s of Q(r,t)){const{suffix:o}=this.meta,{path:n}=s;if(!n.includes(o)){const{birthtime:m,ctime:l,mtime:u}=await F(n),d=a(n),E=d.startsWith(i)?d.slice(i.length):d;e.push({createdAt:m||l,id:E,modifiedAt:u})}}return e})}getFilePath(t){return w.assertSafeId(t),G(t)&&g(h.INVALID_FILE_NAME,`Invalid file id: "${t}"`),K(this.directory,t)}lazyWrite(t){return new Promise((e,r)=>{const a=C(this.getFilePath(t.name),{flags:"r+",start:t.start}),i=new nt(t.contentLength||t.size-t.start),s=at(t.checksum,t.checksumAlgorithm),o=!t.checksum,{signal:n}=t,m=()=>{a.close(),i.destroy(),s.destroy()},l=d=>{m(),e([Number.NaN,d])};if(i.on("error",()=>{l(h.FILE_CONFLICT)}),s.on("error",()=>{l(h.CHECKSUM_MISMATCH)}),t.body.on("aborted",()=>{l(o?void 0:h.REQUEST_ABORTED)}),t.body.on("error",d=>{m(),r(d)}),n?.aborted){l(o?void 0:h.REQUEST_ABORTED);return}let u;n&&(u=()=>{m(),a.destroy(),i.destroy(),s.destroy(),t.body.destroy(),e([Number.NaN,o?void 0:h.REQUEST_ABORTED])},n.addEventListener("abort",u,{once:!0})),U(t.body,i,s,a,d=>{if(n&&u&&n.removeEventListener("abort",u),d){if(m(),n?.aborted){e([Number.NaN,o?void 0:h.REQUEST_ABORTED]);return}e([Number.NaN,h.FILE_ERROR]);return}e([t.start+a.bytesWritten])})})}async accessCheck(){await H(this.directory)}}export{w as F,nt as n,at as s};

package/dist/packem_shared/disk-storage-with-checksum.d-B-VGEsfl.d.ts

@@ -1,156 +0,0 @@
-import { F as File, M as MetaStorage, D as DiskStorageOptions, H as HttpError, d as FileInit, e as FilePart, f as FileQuery, O as OperationOptions, g as FileReturn, i as ERRORS, B as BaseStorage, j as DiskStorageWithChecksumOptions } from "./storage.d-CEM1upWM.js";
-import { Readable } from 'node:stream';
-/**
-* Local disk-based storage implementation.
-* @template TFile The file type used by this storage backend.
-* @remarks
-* ## Error Handling
-* - Filesystem operations throw errors directly (no retry logic)
-* - File not found errors are thrown immediately
-* - Permission errors are propagated as-is
-*
-* ## Retry Behavior
-* - No automatic retries (filesystem operations are typically immediate)
-* - Errors are thrown directly for immediate feedback
-*
-* ## File Paths
-* - Files are stored in the configured directory
-* - Metadata files use the `.META` suffix by default
-* - File paths are resolved relative to the storage directory
-*/
-declare class DiskStorage<TFile extends File = File> extends BaseStorage<TFile> {
-  static override readonly name: string;
-  override checksumTypes: string[];
-  override readonly supportsRange: boolean;
-  override get raw(): {
-    directory: string;
-  };
-  directory: string;
-  meta: MetaStorage<TFile>;
-  constructor(config: DiskStorageOptions<TFile>);
-  /**
-  * Normalizes errors with disk storage context.
-  * @param error The error to normalize.
-  * @returns Normalized HTTP error.
-  */
-  override normalizeError(error: Error): HttpError;
-  /**
-  * Creates a new file upload and saves its metadata.
-  * @param fileInit File initialization configuration.
-  * @returns Promise resolving to the created file object.
-  * @throws {Error} If validation fails or file already exists and is completed.
-  * @remarks
-  * Supports TTL (time-to-live) option in fileInit.
-  * Creates the file on disk if it doesn't exist.
-  * Returns existing file if it's already completed.
-  */
-  create(fileInit: FileInit): Promise<TFile>;
-  /**
-  * Writes data to a file upload.
-  * @param part File part containing data to write, file query, or full file object.
-  * @returns Promise resolving to the updated file object.
-  * @throws {Error} If file is expired (ERRORS.GONE), locked (ERRORS.FILE_LOCKED), or conflicts occur (ERRORS.FILE_CONFLICT).
-  * @remarks
-  * Supports chunked uploads with start position.
-  * Automatically detects file type from stream on first chunk if contentType is not set.
-  * Validates checksum algorithms if provided.
-  * Uses file locking to prevent concurrent writes.
-  * Updates file status to "completed" when all bytes are written.
-  */
-  write(part: FilePart | FileQuery | TFile): Promise<TFile>;
-  /**
-  * Gets an uploaded file by ID.
-  * @param query File query containing the file ID to retrieve.
-  * @param query.id File ID to retrieve.
-  * @returns Promise resolving to the file data including content buffer.
-  * @throws {Error} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
-  * @remarks
-  * Loads the entire file content into memory as a Buffer.
-  * For large files, consider using getStream() instead.
-  * Includes ETag (MD5 hash) for content verification.
-  */
-  get({
-    id
-  }: FileQuery, options?: OperationOptions & {
-    range?: {
-      end?: number;
-      start: number;
-    };
-  }): Promise<FileReturn>;
-  /**
-  * Checks if a file exists by verifying both metadata and the actual filesystem file.
-  * Returns true only if both the metadata and the file exist.
-  * @param query File query containing the file ID to check.
-  * @returns Promise resolving to true if both metadata and file exist, false otherwise.
-  */
-  override exists({
-    id
-  }: FileQuery): Promise<boolean>;
-  /**
-  * Gets an uploaded file as a readable stream for efficient large file handling.
-  * @param query File query containing the file ID to stream.
-  * @param query.id File ID to stream.
-  * @returns Promise resolving to an object containing the stream, headers, and size.
-  * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
-  * @remarks Creates a readable stream directly from the file system for efficient memory usage.
-  */
-  override getStream({
-    id
-  }: FileQuery): Promise<{
-    headers?: Record<string, string>;
-    size?: number;
-    stream: Readable;
-  }>;
-  /**
-  * 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<TFile>;
-  /**
-  * 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<TFile>;
-  /**
-  * 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 {Error} If the source file cannot be found.
-  */
-  move(name: string, destination: string): Promise<TFile>;
-  /**
-  * Retrieves a list of uploaded files.
-  * @returns Promise resolving to an array of file metadata objects.
-  * @remarks Walks the storage directory and returns all files, excluding metadata files.
-  */
-  override list(): Promise<TFile[]>;
-  /**
-  * Returns the absolute on-disk path for the uploaded file, always rooted at
-  * `this.directory`. Absolute inputs and `..` traversals are rejected.
-  */
-  protected getFilePath(filename: string): string;
-  protected lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
-  private accessCheck;
-}
-/**
-* Additionally calculates checksum of the file/range.
-*/
-declare class DiskStorageWithChecksum<TFile extends File = File> extends DiskStorage<TFile> {
-  private hashes;
-  constructor(config: DiskStorageWithChecksumOptions<TFile>);
-  override delete({
-    id
-  }: FileQuery): Promise<TFile>;
-  override write(part: FilePart | FileQuery): Promise<TFile>;
-  protected override lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
-}
-export { DiskStorage as D, DiskStorageWithChecksum as a };