@visulima/storage 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/packem_shared/s3-base-storage.d-CczjSe98.d.ts

@@ -0,0 +1,251 @@
+import { Readable } from 'node:stream';
+import { F as File, M as MetaStorage, c as createRetryWrapper, b as FileInit, B as BaseStorage, R as RetryConfig, d as FilePart, e as FileQuery, a as FileReturn } from "./storage.d-BOMUJD96.js";
+/**
+* Part interface for multipart uploads.
+*/
+interface Part {
+  ETag?: string;
+  PartNumber: number;
+  Size?: number;
+}
+/**
+* Base file type for S3-compatible storage.
+*/
+interface S3CompatibleFile extends File {
+  Parts?: Part[];
+  partSize?: number;
+  partsUrls?: string[];
+  UploadId?: string;
+  uri?: string;
+}
+/**
+* S3 API operations interface that must be implemented by concrete storage classes.
+*/
+interface S3ApiOperations {
+  abortMultipartUpload: (params: {
+    Bucket: string;
+    Key: string;
+    UploadId: string;
+  }) => Promise<void>;
+  checkBucketAccess: (params: {
+    Bucket: string;
+  }) => Promise<void>;
+  completeMultipartUpload: (params: {
+    Bucket: string;
+    Key: string;
+    Parts: {
+      ETag: string;
+      PartNumber: number;
+    }[];
+    UploadId: string;
+  }) => Promise<{
+    ETag?: string;
+    Location: string;
+  }>;
+  copyObject: (params: {
+    Bucket: string;
+    CopySource: string;
+    Key: string;
+    StorageClass?: string;
+  }) => Promise<void>;
+  createMultipartUpload: (params: {
+    ACL?: string;
+    Bucket: string;
+    ContentType?: string;
+    Key: string;
+    Metadata?: Record<string, string>;
+  }) => Promise<{
+    UploadId: string;
+  }>;
+  deleteObject: (params: {
+    Bucket: string;
+    Key: string;
+  }) => Promise<void>;
+  getObject: (params: {
+    Bucket: string;
+    Key: string;
+  }) => Promise<{
+    Body?: ReadableStream | Readable;
+    ContentLength?: number;
+    ContentType?: string;
+    ETag?: string;
+    Expires?: Date;
+    LastModified?: Date;
+    Metadata?: Record<string, string>;
+  }>;
+  getPresignedUrl: (params: {
+    Bucket: string;
+    expiresIn: number;
+    Key: string;
+    PartNumber: number;
+    UploadId: string;
+  }) => Promise<string>;
+  headObject: (params: {
+    Bucket: string;
+    Key: string;
+  }) => Promise<{
+    ContentLength?: number;
+    ContentType?: string;
+    ETag?: string;
+    Expires?: Date;
+    LastModified?: Date;
+    Metadata?: Record<string, string>;
+  }>;
+  listObjectsV2: (params: {
+    Bucket: string;
+    ContinuationToken?: string;
+    MaxKeys?: number;
+  }) => Promise<{
+    Contents?: {
+      Key?: string;
+      LastModified?: Date;
+    }[];
+    IsTruncated?: boolean;
+    NextContinuationToken?: string;
+  }>;
+  listParts: (params: {
+    Bucket: string;
+    Key: string;
+    UploadId: string;
+  }) => Promise<{
+    Parts?: Part[];
+  }>;
+  uploadPart: (params: {
+    Body: Readable | ReadableStream | Uint8Array;
+    Bucket: string;
+    ContentLength?: number;
+    ContentMD5?: string;
+    Key: string;
+    PartNumber: number;
+    UploadId: string;
+  }) => Promise<{
+    ETag: string;
+  }>;
+}
+/**
+* Base class for S3-compatible storage implementations.
+* Contains all shared business logic for S3 operations.
+* @template TFile The file type used by this storage backend.
+*/
+declare abstract class S3BaseStorage<TFile extends S3CompatibleFile = S3CompatibleFile> extends BaseStorage<TFile> {
+  override checksumTypes: string[];
+  protected bucket: string;
+  protected meta: MetaStorage<TFile>;
+  /**
+  * S3 multipart upload does not allow more than 10000 parts.
+  */
+  protected readonly MAX_PARTS = 1e4;
+  protected readonly partSize: number;
+  protected readonly retry: ReturnType<typeof createRetryWrapper>;
+  /**
+  * Abstract method to get S3 API operations implementation.
+  */
+  protected abstract getS3Api(): S3ApiOperations;
+  /**
+  * Abstract method to get the file class constructor.
+  */
+  protected abstract getFileClass(): new (config: FileInit) => TFile;
+  /**
+  * Abstract method to get ACL value.
+  */
+  protected abstract getAcl(): string | undefined;
+  /**
+  * Abstract method for access check.
+  */
+  protected abstract accessCheck(maxWaitTime?: number): Promise<void>;
+  constructor(config: {
+    bucket: string;
+    clientDirectUpload?: boolean;
+    expiration?: {
+      maxAge?: string;
+    };
+    filename?: (file: TFile) => string;
+    logger?: BaseStorage<TFile>["logger"];
+    metaStorage?: MetaStorage<TFile>;
+    metaStorageConfig?: unknown;
+    partSize?: number | string;
+    retryConfig?: RetryConfig;
+  });
+  /**
+  * Creates a new S3 multipart upload.
+  */
+  create(config: FileInit): Promise<TFile>;
+  /**
+  * Writes data to an S3 multipart upload.
+  */
+  write(part: FilePart | FileQuery | TFile): Promise<TFile>;
+  /**
+  * Deletes an upload and its metadata.
+  */
+  delete({
+    id
+  }: FileQuery): Promise<TFile>;
+  /**
+  * Copies an upload file to a new location.
+  */
+  copy(name: string, destination: string, options?: {
+    storageClass?: string;
+  }): Promise<TFile>;
+  /**
+  * Moves an upload file to a new location.
+  */
+  move(name: string, destination: string): Promise<TFile>;
+  /**
+  * Lists files in the bucket.
+  */
+  override list(limit?: number): Promise<TFile[]>;
+  /**
+  * Checks if a file exists by verifying both metadata and the actual S3 object.
+  * Returns true only if both the metadata and the S3 object exist.
+  * @param query File query containing the file ID to check.
+  * @returns Promise resolving to true if both metadata and S3 object exist, false otherwise.
+  */
+  override exists({
+    id
+  }: FileQuery): Promise<boolean>;
+  /**
+  * Gets an uploaded file by ID.
+  */
+  get({
+    id
+  }: FileQuery): Promise<FileReturn>;
+  /**
+  * Gets file stream (abstract - must be implemented by subclasses due to stream differences).
+  */
+  abstract override getStream(query: FileQuery): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  /**
+  * Builds presigned URLs for client uploads.
+  */
+  protected buildPresigned(file: TFile): Promise<TFile>;
+  /**
+  * Gets presigned URLs for all parts.
+  */
+  protected getPartsPresignedUrls(file: TFile): Promise<string[]>;
+  /**
+  * Gets parts for a multipart upload.
+  */
+  protected getParts(file: TFile): Promise<Part[]>;
+  /**
+  * Completes a multipart upload.
+  */
+  protected completeMultipartUpload(file: TFile): Promise<{
+    ETag?: string;
+    Location: string;
+  }>;
+  /**
+  * Aborts a multipart upload.
+  */
+  protected abortMultipartUpload(file: TFile): Promise<void>;
+  /**
+  * Internal onComplete handler.
+  */
+  protected internalOnComplete: (file: TFile) => Promise<[{
+    ETag?: string;
+    Location: string;
+  }, TFile]>;
+}
+export { Part as P, S3ApiOperations as S, S3BaseStorage as a };

package/dist/packem_shared/sharedGet-Ce7WGAsc.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var d=(e,t)=>g(e,"name",{value:t,configurable:!0});var y=Object.defineProperty,r=d((e,t)=>y(e,"name",{value:t,configurable:!0}),"a");const l={value:{createdAt:"2022-12-16T10:35:17.466Z",id:"391c9157ec481ac6-f72b2d884632d7e6-cdeb2056546033e3",modifiedAt:"2022-12-16T10:35:17.470Z"}},s=r((e,t)=>e.map(i=>({...i,description:`[${t}] ${i.description}`,"x-group":t})),"createParameterGroup"),u=r((e,t=["jpeg","png","webp","avif","tiff","gif","mp4","webm","mkv","ogg","mp3","wav","aac","flac"])=>{if(!e)return[];const i=s([{description:"Output format for the transformed media",in:"query",name:"format",schema:{enum:t,type:"string"}},{description:"Quality setting (0-100 for images, affects compression)",in:"query",name:"quality",schema:{maximum:100,minimum:1,type:"integer"}}],"Common"),n=s([{description:"Desired width in pixels",in:"query",name:"width",schema:{minimum:1,type:"integer"}},{description:"Desired height in pixels",in:"query",name:"height",schema:{minimum:1,type:"integer"}},{description:"Resize fit mode",in:"query",name:"fit",schema:{enum:["cover","contain","fill","inside","outside"],type:"string"}},{description:"Position for cover/contain fits",in:"query",name:"position",schema:{oneOf:[{enum:["top","right","bottom","left","center"],type:"string"},{minimum:0,type:"integer"}]}},{description:"Avoid enlarging images smaller than specified dimensions",in:"query",name:"withoutEnlargement",schema:{type:"boolean"}},{description:"Avoid reducing images larger than specified dimensions",in:"query",name:"withoutReduction",schema:{type:"boolean"}},{description:"Resize kernel algorithm",in:"query",name:"kernel",schema:{enum:["nearest","cubic","mitchell","lanczos2","lanczos3"],type:"string"}},{description:"Fast shrink on load for large images",in:"query",name:"fastShrinkOnLoad",schema:{type:"boolean"}},{description:"Crop area left offset",in:"query",name:"left",schema:{minimum:0,type:"integer"}},{description:"Crop area top offset",in:"query",name:"top",schema:{minimum:0,type:"integer"}},{description:"Crop area width",in:"query",name:"cropWidth",schema:{minimum:1,type:"integer"}},{description:"Crop area height",in:"query",name:"cropHeight",schema:{minimum:1,type:"integer"}},{description:"Rotation angle in degrees. Note: angles other than 90°, 180°, and 270° require interpolation and may affect quality",in:"query",name:"angle",schema:{type:"number"}},{description:"Background color for rotation (hex, rgb, or color name)",in:"query",name:"background",schema:{type:"string"}},{description:"Apply blur effect",in:"query",name:"blur",schema:{type:"boolean"}},{description:"Apply sharpening",in:"query",name:"sharpen",schema:{type:"boolean"}},{description:"Apply median filter with specified size",in:"query",name:"median",schema:{minimum:1,type:"integer"}},{description:"Apply CLAHE (Contrast Limited Adaptive Histogram Equalization)",in:"query",name:"clahe",schema:{type:"boolean"}},{description:"Apply thresholding with specified value (0-255)",in:"query",name:"threshold",schema:{maximum:255,minimum:0,type:"integer"}},{description:"Apply gamma correction",in:"query",name:"gamma",schema:{type:"boolean"}},{description:"Negate (invert) the image",in:"query",name:"negate",schema:{type:"boolean"}},{description:"Normalise the image",in:"query",name:"normalise",schema:{type:"boolean"}},{description:"Flatten alpha channel",in:"query",name:"flatten",schema:{type:"boolean"}},{description:"Unflatten alpha channel",in:"query",name:"unflatten",schema:{type:"boolean"}},{description:"Flip image vertically",in:"query",name:"flip",schema:{type:"boolean"}},{description:"Flop image horizontally",in:"query",name:"flop",schema:{type:"boolean"}},{description:"Convert to greyscale",in:"query",name:"greyscale",schema:{type:"boolean"}},{description:"Apply modulation effects",in:"query",name:"modulate",schema:{type:"boolean"}},{description:"Brightness multiplier for modulation",in:"query",name:"brightness",schema:{type:"number"}},{description:"Saturation multiplier for modulation",in:"query",name:"saturation",schema:{type:"number"}},{description:"Hue rotation in degrees for modulation",in:"query",name:"hue",schema:{type:"integer"}},{description:"Lightness adjustment for modulation",in:"query",name:"lightness",schema:{type:"integer"}},{description:"Apply tinting",in:"query",name:"tint",schema:{type:"boolean"}},{description:"Convert colourspace",in:"query",name:"colourspace",schema:{enum:["srgb","rgb","cmyk","lab","b-w"],type:"string"}},{description:"Apply affine transformation",in:"query",name:"affine",schema:{type:"boolean"}},{description:"Apply dilation",in:"query",name:"dilate",schema:{type:"boolean"}},{description:"Apply erosion",in:"query",name:"erode",schema:{type:"boolean"}},{description:"Set pipeline colourspace",in:"query",name:"pipelineColourspace",schema:{type:"boolean"}},{description:"Convert to colourspace",in:"query",name:"toColourspace",schema:{type:"boolean"}},{description:"Remove alpha channel",in:"query",name:"removeAlpha",schema:{type:"boolean"}},{description:"Ensure alpha channel",in:"query",name:"ensureAlpha",schema:{type:"boolean"}}],"Image"),m=s([{description:"Desired width in pixels",in:"query",name:"width",schema:{minimum:1,type:"integer"}},{description:"Desired height in pixels",in:"query",name:"height",schema:{minimum:1,type:"integer"}},{description:"Video frame rate in Hz",in:"query",name:"frameRate",schema:{minimum:1,type:"number"}},{description:"Video key frame interval in seconds",in:"query",name:"keyFrameInterval",schema:{minimum:.1,type:"number"}}],"Video"),o=s([{description:"Target bitrate in bits per second",in:"query",name:"bitrate",schema:{minimum:1,type:"integer"}},{description:"Video or audio codec",in:"query",name:"codec",schema:{enum:["avc","hevc","vp8","vp9","av1","aac","opus","mp3","vorbis","flac"],type:"string"}}],"Video/Audio"),h=s([{description:"Audio channel count",in:"query",name:"numberOfChannels",schema:{enum:[1,2,3,4,5,6,7,8],type:"integer"}},{description:"Audio sample rate in Hz",in:"query",name:"sampleRate",schema:{enum:[8e3,11025,16e3,22050,32e3,44100,48e3,88200,96e3,192e3],type:"integer"}}],"Audio");let a=[];a=[...a,...i],(e===!0||e==="image")&&(a=[...a,...n]),(e===!0||e==="video")&&(a=[...a,...m]),(e===!0||e==="video"||e==="audio")&&(a=[...a,...o]),(e===!0||e==="audio")&&(a=[...a,...h]);const p=new Set;return a.filter(c=>p.has(c.name)?!1:(p.add(c.name),!0))},"getTransformationParameters"),q=r((e,t=["jpeg","png","webp","avif","tiff","gif","mp4","webm","mkv","ogg","mp3","wav","aac","flac"])=>{const i=u(e,t),n={};return i.forEach(m=>{const o=m["x-group"]||"Other";n[o]||(n[o]=[]),n[o].push(m.name)}),{groups:n,parameters:i}},"getOrganizedTransformationParameters"),f=r(e=>e?{"X-Media-Type":{description:"Type of media (image/video/audio)",schema:{enum:["image","video","audio"],type:"string"}},"X-Original-Format":{description:"Original file format",schema:{type:"string"}},"X-Transformed-Format":{description:"Transformed file format",schema:{type:"string"}}}:{},"getTransformationHeaders"),b=r(e=>e?{400:{content:{"application/json":{examples:{ValidationError:{value:{error:{code:"INVALID_PARAMS_FOR_IMAGE",details:{invalidParams:["codec","bitrate"],mediaType:"image",validParams:["format","quality","width","height","fit","position","withoutEnlargement","withoutReduction","kernel","fastShrinkOnLoad","left","top","cropWidth","cropHeight","angle","background","blur","sharpen","median","clahe","threshold","gamma","negate","normalise","flatten","unflatten","flip","flop","greyscale","modulate","brightness","saturation","hue","lightness","tint","colourspace","affine","dilate","erode","pipelineColourspace","toColourspace","removeAlpha","ensureAlpha"]},message:"Invalid query parameters for image transformation: codec, bitrate. Images support: format, quality, width, height, fit, position, withoutEnlargement, withoutReduction, kernel, fastShrinkOnLoad, left, top, cropWidth, cropHeight, angle, background, blur, sharpen, median, clahe, threshold, gamma, negate, normalise, flatten, unflatten, flip, flop, greyscale, modulate, brightness, saturation, hue, lightness, tint, colourspace, affine, dilate, erode, pipelineColourspace, toColourspace, removeAlpha, ensureAlpha. Video/audio parameters (codec, bitrate) are not supported for images.",name:"ValidationError"}}}},schema:{$ref:"#/components/schemas/ValidationError"}}},description:"Invalid transformation parameters"},413:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"File too large for transformation"},415:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Unsupported media type for transformation"}}:{},"getTransformationErrorResponses"),I=r((e,t,i,n)=>({description:"Get the uploaded file with optional media transformation support",operationId:e,parameters:[{in:"path",name:"id",required:!0,schema:{type:"string"}},...u(i,n)],responses:{200:{content:{"*/*":{schema:{description:i?"Transformed file content":"File content",format:"binary",type:"string"}}},description:i?"File retrieved and transformed successfully":"File retrieved successfully",headers:{"Content-Type":{description:`MIME type of the file${i?" (or transformed file)":""}`,schema:{type:"string"}},ETag:{description:`Upload ETag${i?" (or transformed file ETag)":""}`,schema:{example:"d41d8cd98f00b204e9800998ecf8427e",type:"string"}},"Last-Modified":{description:"Upload last modified date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}},...f(i),"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},...b(i),404:{content:{"application/json":{example:{error:{code:"FileNotFound",message:"Not found"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Get the uploaded file",tags:t}),"sharedGet"),v=r((e,t)=>({description:"Get the uploaded file metadata",operationId:e,parameters:[{in:"path",name:"id",required:!0,schema:{type:"string"}}],responses:{200:{content:{"application/json":{schema:{$ref:"#/components/schemas/FileMeta"}}},description:"OK",headers:{"Last-Modified":{description:"Upload last modified date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}},"X-Upload-Expires":{description:"Upload expiration date",schema:{example:"2021-08-25T11:12:26.635Z",format:"date-time",type:"string"}}}},404:{content:{"application/json":{example:{error:{code:"FileNotFound",message:"File metadata not found"}},schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Get the uploaded file metadata",tags:t}),"sharedGetMeta"),E={Error:{description:"Error",properties:{error:{properties:{code:{minLength:1,type:"string"},message:{minLength:1,type:"string"},name:{minLength:3,type:"string"}},required:["message"],type:"object"}},required:["error"],type:"object"},ValidationError:{description:"Validation error response",properties:{code:{enum:["INVALID_PARAMS_FOR_IMAGE","INVALID_PARAMS_FOR_VIDEO","INVALID_PARAMS_FOR_AUDIO","INVALID_FIT_VALUE","INVALID_ANGLE_VALUE","INVALID_FORMAT","INCOMPLETE_CROP_PARAMS","INVALID_VIDEO_CODEC","INVALID_VIDEO_FORMAT","INVALID_WIDTH","INVALID_HEIGHT","INVALID_BITRATE","INVALID_FRAME_RATE","INVALID_KEY_FRAME_INTERVAL","INVALID_AUDIO_CODEC","INVALID_AUDIO_FORMAT","INVALID_CHANNEL_COUNT","INVALID_SAMPLE_RATE"],type:"string"},details:{properties:{invalidParams:{items:{type:"string"},type:"array"},mediaType:{enum:["image","video","audio"],type:"string"},suggestions:{items:{type:"string"},type:"array"},validParams:{items:{type:"string"},type:"array"}},required:["invalidParams","validParams","mediaType"],type:"object"},message:{type:"string"},name:{enum:["ValidationError"],type:"string"}},required:["code","details","message","name"],type:"object"}},L={FileMeta:{description:"File meta",properties:{bytesWritten:{type:"integer"},contentType:{type:"string"},createdAt:{format:"date-time",type:"string"},id:{minLength:1,type:"string"},metadata:{type:"object"},name:{minLength:1,type:"string"},originalName:{minLength:1,type:"string"},status:{enum:["completed","part","deleted","created"],type:"string"}},type:"object"}},_={FileMeta:{value:[l]},FileMetaPagination:{value:{data:[l.value],meta:{firstPage:1,firstPageUrl:"/?page=1",lastPage:1,lastPageUrl:"/?page=10",nextPageUrl:"/?page=2",page:1,perPage:1,previousPageUrl:void 0,total:1}}}},F=r((e,t)=>({description:"List upload",operationId:e,parameters:[{description:"Maximum number of elements to retrieve.",in:"query",name:"limit",schema:{nullable:!0,type:"integer"}},{description:"Page number. Use only for pagination.",in:"query",name:"page",schema:{nullable:!0,type:"integer"}}],responses:{200:{content:{"application/json":{examples:{Default:{$ref:"#/components/examples/FileMeta"},Pagination:{$ref:"#/components/examples/FileMetaPagination"}},schema:{$ref:"#/components/schemas/FileMeta"}}},description:"OK"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"List upload",tags:t}),"sharedGetList");export{q as getOrganizedTransformationParameters,E as sharedErrorSchemaObject,_ as sharedFileMetaExampleObject,L as sharedFileMetaSchemaObject,I as sharedGet,F as sharedGetList,v as sharedGetMeta};

package/dist/packem_shared/storage-m_Cxgiih.js

@@ -0,0 +1 @@
+var Z=Object.defineProperty;var y=(t,e)=>Z(t,"name",{value:e,configurable:!0});import{Readable as q}from"node:stream";import{setInterval as W}from"node:timers";import{inspect as X}from"node:util";import{L as H,O as j}from"./path-D7rMc9nq-B718mbm6.js";import J from"type-is";import Q from"./NoOpMetrics-Dky06sf1.js";import{N as ee}from"./cache-qV_5Umeq.js";import{ErrorMap as T,throwErrorCode as M,ERRORS as N}from"./ERRORS-B9jkvKwx.js";import{LRUCache as te}from"lru-cache";import{V as re}from"./validator-DK41xp8N.js";import{o as oe}from"./is-expired-1JuZjDtb.js";var se=Object.defineProperty,ae=y((t,e)=>se(t,"name",{value:e,configurable:!0}),"y$2"),ie=Object.defineProperty,ne=ae((t,e)=>ie(t,"name",{value:e,configurable:!0}),"y"),ce=Object.defineProperty,O=ne((t,e)=>ce(t,"name",{value:e,configurable:!0}),"i");const le=/^(?<value>-?\d+(?:[.,]\d+)*) *(?<type>[a-z]+)?$/i,ue=/^KIBI/,me=/^MIBI/,ge=/^GIBI/,pe=/^TEBI/,he=/^PEBI/,de=/^EXBI/,fe=/^ZEBI/,ye=/^YIBI/,be=/^(.)IB$/,U={iec:[{long:"Bytes",short:"B"},{long:"Kibibytes",short:"KiB"},{long:"Mebibytes",short:"MiB"},{long:"Gibibytes",short:"GiB"},{long:"Tebibytes",short:"TiB"},{long:"Pebibytes",short:"PiB"},{long:"Exbibytes",short:"EiB"},{long:"Zebibytes",short:"ZiB"},{long:"Yobibytes",short:"YiB"}],iec_octet:[{long:"Octets",short:"o"},{long:"Kibioctets",short:"Kio"},{long:"Mebioctets",short:"Mio"},{long:"Gibioctets",short:"Gio"},{long:"Tebioctets",short:"Tio"},{long:"Pebioctets",short:"Pio"},{long:"Exbioctets",short:"Eio"},{long:"Zebioctets",short:"Zio"},{long:"Yobioctets",short:"Yio"}],metric:[{long:"Bytes",short:"Bytes"},{long:"Kilobytes",short:"KB"},{long:"Megabytes",short:"MB"},{long:"Gigabytes",short:"GB"},{long:"Terabytes",short:"TB"},{long:"Petabytes",short:"PB"},{long:"Exabytes",short:"EB"},{long:"Zettabytes",short:"ZB"},{long:"Yottabytes",short:"YB"}],metric_octet:[{long:"Octets",short:"o"},{long:"Kilo-octets",short:"ko"},{long:"Mega-octets",short:"Mo"},{long:"Giga-octets",short:"Go"},{long:"Tera-octets",short:"To"},{long:"Peta-octets",short:"Po"},{long:"Exa-octets",short:"Eo"},{long:"Zetta-octets",short:"Zo"},{long:"Yotta-octets",short:"Yo"}]},we=O((t,e)=>{const r=new Intl.NumberFormat(e).format(11111).replaceAll(new RegExp("\\p{Number}","gu"),""),o=new Intl.NumberFormat(e).format(1.1).replaceAll(new RegExp("\\p{Number}","gu"),"");return Number.parseFloat(t.replaceAll(new RegExp(`\\${r}`,"g"),"").replace(new RegExp(`\\${o}`),"."))},"parseLocalizedNumber"),_=O(t=>{switch(t){case 2:return 1024;case 10:return 1e3;default:throw new Error("Unsupported base.")}},"fromBase"),D=O((t,e)=>{const r={base:2,locale:"en-US",units:"metric",...e};if(typeof t!="string"||t.length===0)throw new TypeError("Value is not a string or is empty.");if(t.length>100)throw new TypeError("Value exceeds the maximum length of 100 characters.");const o=le.exec(t)?.groups;if(!o)return Number.NaN;const i=we(o.value,r.locale),a=(o.type??"Bytes").toUpperCase().replace(ue,"KILO").replace(me,"MEGA").replace(ge,"GIGA").replace(pe,"TERA").replace(he,"PETA").replace(de,"EXA").replace(fe,"ZETTA").replace(ye,"YOTTA").replace(be,"$1B"),n=U[r.units].findIndex(c=>c.short[0].toUpperCase()===a[0]),l=_(r.base);return i*l**n},"parseBytes");O((t,e)=>{if(typeof t!="number"||!Number.isFinite(t))throw new TypeError("Bytesize is not a number.");const{base:r,decimals:o,locale:i,long:a,unit:n,units:l,...c}={base:2,decimals:0,locale:"en-US",long:!1,units:"metric",...e},s=_(r),m=Math.abs(t),u=e?.space??!0?" ":"",g=U[l],p=g.findIndex(w=>w.short===n);if(t===0){const w=Math.min(0,Math.max(p,g.length-1));return"0"+u+g[w][a?"long":"short"]}const f=p===-1?Math.min(Math.floor(Math.log(m)/Math.log(s)),g.length-1):p,$=g[f][a?"long":"short"],x=t/s**f,v=o<0?void 0:o;return new Intl.NumberFormat(i,{maximumFractionDigits:v,minimumFractionDigits:v,...c}).format(x)+u+$},"formatBytes");var ve=Object.defineProperty,Ee=y((t,e)=>ve(t,"name",{value:e,configurable:!0}),"u$1"),$e=Object.defineProperty,xe=Ee((t,e)=>$e(t,"name",{value:e,configurable:!0}),"v"),Me=Object.defineProperty,Ne=xe((t,e)=>Me(t,"name",{value:e,configurable:!0}),"D");const Se=Ne((t,e,r,o,i,a,n,l,c,s,m,u,g,p)=>{const f={d:o,h:i,m:a,mo:e,ms:l,s:n,w:r,y:t};return c!==void 0&&(f.future=c),s!==void 0&&(f.past=s),m!==void 0&&(f.decimal=m),u!==void 0&&(f.unitMap=u),g!==void 0&&(f.groupSeparator=g),p!==void 0&&(f.placeholderSeparator=p),f},"createDurationLanguage"),k={d:"d",day:"d",days:"d",h:"h",hour:"h",hours:"h",hr:"h",hrs:"h",m:"m",millisecond:"ms",milliseconds:"ms",min:"m",mins:"m",minute:"m",minutes:"m",mo:"mo",month:"mo",months:"mo",ms:"ms",s:"s",sec:"s",second:"s",seconds:"s",secs:"s",w:"w",week:"w",weeks:"w",y:"y",year:"y",years:"y",yr:"y",yrs:"y"},Be=Se(t=>`year${t===1?"":"s"}`,t=>`month${t===1?"":"s"}`,t=>`week${t===1?"":"s"}`,t=>`day${t===1?"":"s"}`,t=>`hour${t===1?"":"s"}`,t=>`minute${t===1?"":"s"}`,t=>`second${t===1?"":"s"}`,t=>`millisecond${t===1?"":"s"}`,"in %s","%s ago",".",k,",","_");var Oe=Object.defineProperty,Te=y((t,e)=>Oe(t,"name",{value:e,configurable:!0}),"o$1"),Pe=Object.defineProperty,Ce=Te((t,e)=>Pe(t,"name",{value:e,configurable:!0}),"o"),Ae=Object.defineProperty,Ie=Ce((t,e)=>Ae(t,"name",{value:e,configurable:!0}),"o");const ze=Ie(t=>{const e=["y","mo","w","d","h","m","s","ms","future","past"];for(const o of e)if(!Object.hasOwn(t,o))throw new TypeError(`Missing required property: ${o}`);if(typeof t.future!="string"||typeof t.past!="string")throw new TypeError("Properties future and past must be of type string");const r=["y","mo","w","d","h","m","s","ms"];for(const o of r)if(typeof t[o]!="string"&&typeof t[o]!="function")throw new TypeError(`Property ${o} must be of type string or function`);if(t.decimal&&typeof t.decimal!="string")throw new TypeError("Property decimal must be of type string");if(t.delimiter&&typeof t.delimiter!="string")throw new TypeError("Property delimiter must be of type string");if(t._digitReplacements&&!Array.isArray(t._digitReplacements))throw new TypeError("Property _digitReplacements must be an array");if(t._numberFirst&&typeof t._numberFirst!="boolean")throw new TypeError("Property _numberFirst must be of type boolean");if(t.unitMap&&typeof t.unitMap!="object")throw new TypeError("Property unitMap must be an object");if(t.unitMap&&Object.values(t.unitMap).some(o=>typeof o!="string"))throw new TypeError("All values in unitMap must be of type string")},"validateDurationLanguage");var De=Object.defineProperty,Fe=y((t,e)=>De(t,"name",{value:e,configurable:!0}),"w"),je=Object.defineProperty,Ue=Fe((t,e)=>je(t,"name",{value:e,configurable:!0}),"S"),_e=Object.defineProperty,ke=Ue((t,e)=>_e(t,"name",{value:e,configurable:!0}),"h");const F={d:864e5,h:36e5,m:6e4,mo:2629746e3,ms:1,s:1e3,w:6048e5,y:31556952e3},S=/[-/\\^$*+?.()|[\]{}]/g,Re=/^PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?$/i,Le=/^(?:(\d+):)?(?:(\d+):)?(\d+)$/,Ge=/^[+-]?\d+(?:\.\d+)?$/,Ve=/^[-+]/,Ye=ke((t,e)=>{if(typeof t!="string"||t.length===0)return;const{defaultUnit:r="ms",language:o=Be}=e??{};ze(o);const i=o.decimal??".",a=o.groupSeparator??",",n=o.placeholderSeparator??"_",l=i.replaceAll(S,String.raw`\$&`),c=a.replaceAll(S,String.raw`\$&`),s=n.replaceAll(S,String.raw`\$&`),m=o.unitMap??k;let u=t.replaceAll(new RegExp(String.raw`(\d)[${s}${c}](\d)`,"g"),"$1$2");if(i!=="."&&(u=u.replace(l,".")),Ge.test(t)){const h=Number.parseFloat(u.trim());if(!Number.isNaN(h)){const d=m[r];if(d!==void 0)return h*F[d]}return}const g=Re.exec(t);if(g){const h=Number.parseInt(g[1]??"0",10),d=Number.parseInt(g[2]??"0",10),E=Number.parseInt(g[3]??"0",10);return h*36e5+d*6e4+E*1e3}const p=Le.exec(t);if(p){let h=0,d=0;p[2]!==void 0?(h=Number.parseInt(p[1]??"0",10),d=Number.parseInt(p[2],10)):p[1]!==void 0&&(d=Number.parseInt(p[1],10));const E=Number.parseInt(p[3]??"0",10);return h*36e5+d*6e4+E*1e3}const f=Object.keys(m).toSorted((h,d)=>d.length-h.length).map(h=>h.replaceAll(S,String.raw`\$&`)).join("|"),$=new RegExp(String.raw`(-?\d*\.?\d+)\s*(${f})`,"gi");let x=0,v,w=!1,C=-1,A=0;for($.lastIndex=0;(v=$.exec(u))!==null;){w||(C=v.index),w=!0;const h=v[1],d=v[2];if(!h||!d)continue;const E=h.trim(),V=E.startsWith("-")?-1:1,Y=E.replace(Ve,""),I=Number.parseFloat(Y),z=m[d.toLowerCase()];if(z===void 0)continue;const K=F[z];if(Number.isNaN(I))return;x+=V*I*K,A=$.lastIndex}const L=u.slice(0,C).trim(),G=u.slice(A).trim();if(!(w&&(L.length>0||G.length>0))&&w)return x},"parseDuration");var Ke=Object.defineProperty,Ze=y((t,e)=>Ke(t,"name",{value:e,configurable:!0}),"e");const B=Ze(t=>{if(t===Number(t))return t;if(!t)return;const e=Ye(t);if(e!==void 0)return e},"toMilliseconds");var qe=Object.defineProperty,We=y((t,e)=>qe(t,"name",{value:e,configurable:!0}),"r");class Xe extends te{static{y(this,"o")}static{We(this,"Locker")}constructor(e){super({ttl:1e3,ttlAutopurge:!0,...e})}lock(e){if(this.get(e))throw new Error(`${e} is locked`);return this.set(e,e),e}unlock(e){this.delete(e)}}var He=Object.defineProperty,P=y((t,e)=>He(t,"name",{value:e,configurable:!0}),"i");const Je=P(t=>{if(typeof t.name=="string")return t.name;if(typeof t.title=="string")return t.title;if(typeof t.originalName=="string")return t.originalName;if(typeof t.filename=="string")return t.filename},"extractOriginalName"),R=P((t,e)=>{const r={...t};return Object.keys(e).forEach(o=>{const i=e[o];if(i!==null&&typeof i=="object"&&!Array.isArray(i)){const a=r[o],n=a&&typeof a=="object"&&!Array.isArray(a)?a:{};r[o]=R(n,i)}else r[o]=i}),r},"deepMerge"),Qe=P((t,e)=>{const r=R(t,e);Object.assign(t,r),t.originalName=Je(t.metadata)||t.originalName},"updateMetadata");var et=Object.defineProperty,b=y((t,e)=>et(t,"name",{value:e,configurable:!0}),"g");const tt={allowMIME:["*/*"],filename:b(({id:t})=>t,"filename"),maxMetadataSize:"8MB",maxUploadSize:"5TB",onComplete:b(()=>{},"onComplete"),onCreate:b(()=>{},"onCreate"),onDelete:b(()=>{},"onDelete"),onError:b(()=>{},"onError"),onUpdate:b(()=>{},"onUpdate"),useRelativeLocation:!1,validation:{}},rt=b(t=>!t||t.length<3||t.length>255||j(t)?!1:!(t.toUpperCase().includes("../")||t.includes("\0")),"defaultCloudStorageFileNameValidation"),dt=b(t=>{if(!t||t.length<3||t.length>255||j(t))return!1;const e=t.toUpperCase();return!['"',"*",":","<",">","?","\\","|","../","\0"].some(r=>e.includes(r))},"defaultFilesystemFileNameValidation");class ft{static{y(this,"BaseStorage")}static{b(this,"BaseStorage")}onCreate;onUpdate;onComplete;onDelete;onError;isReady=!0;errorResponses={};cache;logger;metrics;genericConfig;maxMetadataSize;checksumTypes=[];maxUploadSize;expiration;locker;namingFunction;validation=new re;assetFolder=void 0;concurrency;constructor(e){const r={...tt,...e};this.onCreate=r.onCreate,this.onUpdate=r.onUpdate,this.onComplete=r.onComplete,this.onDelete=r.onDelete,this.onError=r.onError,this.namingFunction=r.filename,this.maxUploadSize=typeof r.maxUploadSize=="string"?D(r.maxUploadSize):r.maxUploadSize,this.maxMetadataSize=typeof r.maxMetadataSize=="string"?D(r.maxMetadataSize):r.maxMetadataSize,this.expiration=r.expiration,this.genericConfig=r,r.assetFolder!==void 0&&(this.assetFolder=H(r.assetFolder)),this.locker=new Xe({max:1e3,ttl:3e4,ttlAutopurge:!0}),this.cache=r.cache??new ee,this.logger=r.logger,this.metrics=r.metrics??new Q,this.logger?.debug(`${this.constructor.name} config: ${X({...e,logger:this.logger.constructor})}`);const o=B(r.expiration?.purgeInterval);o&&this.startAutoPurge(o);const i={isValid(c){if(c.size===void 0)return!0;const s=c.size;if(s==null)return!1;const m=typeof s=="number"?s:Number(s);if(Number.isNaN(m)||m<0)return!1;const u=typeof this.value=="number"?this.value:Number(this.value);return!Number.isNaN(u)&&m<=u},response:T.RequestEntityTooLarge,value:this.maxUploadSize},a={isValid(c){return!!J.is(c.contentType,this.value)},response:T.UnsupportedMediaType,value:r.allowMIME},n=r.fileNameValidation??rt,l={isValid(c){return n(c.name)},response:T.InvalidFileName};this.validation.add({filename:l,mime:a,size:i}),this.validation.add({...r.validation})}get tusExtension(){const e=["creation","creation-with-upload","termination","checksum","creation-defer-length","concatenation"];return this.expiration&&e.push("expiration"),e}async validate(e){await this.validation.verify(e)}async exists(e){return this.instrumentOperation("exists",async()=>{try{return await this.getMeta(e.id),!0}catch{return!1}})}normalizeError(e){const r={code:e.name,message:e.message,name:e.name,statusCode:500};return{...r,message:`[${this.constructor.name}] ${r.message}`}}get config(){return this.genericConfig}async saveMeta(e){return this.updateTimestamps(e),this.cache.set(e.id,e),this.meta.save(e.id,e)}async deleteMeta(e){return this.cache.delete(e),this.meta.delete(e)}async getMeta(e){try{const r=await this.meta.get(e);return this.cache.set(r.id,r),{...r}}catch(r){const o=this.normalizeError(r instanceof Error?r:new Error(String(r)));return await this.onError(o),M(N.FILE_NOT_FOUND)}}async checkIfExpired(e){return oe(e)?(this.delete(e).catch(()=>{}),this.deleteMeta(e.id).catch(()=>{}),M(N.GONE)):e}async purge(e){return this.instrumentOperation("purge",async()=>{const r=B(e||this.expiration?.maxAge),o={items:[],maxAgeMs:r};if(r){const i=Date.now()-r,a=(await this.list()).filter(n=>Number(new Date(this.expiration?.rolling&&n.modifiedAt||n.createdAt))<i);for await(const{id:n,...l}of a)try{const c=await this.delete({id:n});o.items.push({...c,...l})}catch(c){this.logger?.warn(`Failed to delete file ${n} during purge: ${c instanceof Error?c.message:String(c)}`)}o.items.length>0&&(this.logger?.info(`Purge: removed ${o.items.length} uploads`),this.metrics.gauge("storage.operations.purge.items_count",o.items.length,{storage:this.constructor.name.toLowerCase().replace("storage","")}))}return o})}async getStream({id:e}){return this.instrumentOperation("getStream",async()=>{const r=await this.get({id:e}),o=q.from(r.content);return{headers:{"Content-Length":String(r.size),"Content-Type":r.contentType,...r.ETag&&{ETag:r.ETag},...r.modifiedAt&&{"Last-Modified":r.modifiedAt.toString()}},size:typeof r.size=="number"?r.size:void 0,stream:o}})}async list(e=1e3){return this.instrumentOperation("list",async()=>{throw new Error("Not implemented")})}async update({id:e},r){return this.instrumentOperation("update",async()=>{const o=await this.getMeta(e),i={...r};if("ttl"in i&&i.ttl!==void 0){const n=i.ttl,l=typeof n=="string"?B(n):n;l!==void 0&&(i.expiredAt=Date.now()+l),delete i.ttl}Qe(o,i),await this.saveMeta(o);const a={...o,status:"updated"};return await this.onUpdate(a),a})}async deleteBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.delete.count",1,{batch_size:e.length,storage:o});const i=[],a=[],n=e.map(async s=>{try{return{file:await this.delete({id:s}),id:s,success:!0}}catch(m){const u=m instanceof Error?m.message:"Delete failed";return this.metrics.increment("storage.operations.delete.error.count",1,{error:u,storage:o}),{error:u,id:s,success:!1}}}),l=await Promise.allSettled(n);for(const s of l)s.status==="fulfilled"?s.value.success?i.push(s.value.file):a.push({error:s.value.error,id:s.value.id}):a.push({error:s.reason?.message||"Delete failed",id:""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.delete.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.delete.success_count",i.length,{storage:o}),this.metrics.gauge("storage.operations.batch.delete.failed_count",a.length,{storage:o}),{failed:a,failedCount:a.length,successful:i,successfulCount:i.length}}async copyBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.copy.count",1,{batch_size:e.length,storage:o});const i=[],a=[],n=e.map(async({destination:s,options:m,source:u})=>{try{return{file:await this.copy(u,s,m),id:s,success:!0}}catch(g){const p=g instanceof Error?g.message:"Copy failed";return this.metrics.increment("storage.operations.copy.error.count",1,{error:p,storage:o}),{error:p,id:s,success:!1}}}),l=await Promise.allSettled(n);for(const s of l)s.status==="fulfilled"?s.value.success&&s.value.file?i.push(s.value.file):a.push({error:s.value.error||"Copy failed",id:s.value.id}):a.push({error:s.reason?.message||"Copy failed",id:""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.copy.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.copy.success_count",i.length,{storage:o}),this.metrics.gauge("storage.operations.batch.copy.failed_count",a.length,{storage:o}),{failed:a,failedCount:a.length,successful:i,successfulCount:i.length}}async moveBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.move.count",1,{batch_size:e.length,storage:o});const i=[],a=[],n=e.map(async({destination:s,source:m})=>{try{return{file:await this.move(m,s),id:s,success:!0}}catch(u){const g=u instanceof Error?u.message:"Move failed";return this.metrics.increment("storage.operations.move.error.count",1,{error:g,storage:o}),{error:g,id:s,success:!1}}}),l=await Promise.allSettled(n);for(const s of l)s.status==="fulfilled"?s.value.success&&s.value.file?i.push(s.value.file):a.push({error:s.value.error||"Move failed",id:s.value.id}):a.push({error:s.reason?.message||"Move failed",id:s.reason?.id||""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.move.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.move.success_count",i.length,{storage:o}),this.metrics.gauge("storage.operations.batch.move.failed_count",a.length,{storage:o}),{failed:a,failedCount:a.length,successful:i,successfulCount:i.length}}async lock(e){const r=[...this.locker.keys()];return r.includes(e)?M(N.FILE_LOCKED):this.config.concurrency&&typeof this.config.concurrency=="number"&&this.config.concurrency<r.length?M(N.STORAGE_BUSY):(this.locker.set(e,e),e)}async unlock(e){this.locker.unlock(e)}isUnsupportedChecksum(e=""){return!!e&&!this.checksumTypes.includes(e)}startAutoPurge(e){if(e>=2147483647)throw new Error("“purgeInterval” must be less than 2147483647 ms");W(()=>{this.purge().catch(r=>this.logger?.error(r))},e)}updateTimestamps(e){e.createdAt??=new Date().toISOString();const r=B(this.expiration?.maxAge);return r&&!e.expiredAt&&(e.expiredAt=this.expiration?.rolling?Date.now()+r:+new Date(e.createdAt)+r),e}async instrumentOperation(e,r,o){const i=Date.now(),a={storage:this.constructor.name.toLowerCase().replace("storage",""),...o};try{this.metrics.increment(`storage.operations.${e}.count`,1,a);const n=await r(),l=Date.now()-i;return this.metrics.timing(`storage.operations.${e}.duration`,l,a),n&&typeof n=="object"&&"size"in n&&typeof n.size=="number"&&this.metrics.gauge("storage.files.size",n.size,{...a,operation:e}),n}catch(n){const l=Date.now()-i,c=n instanceof Error?n.message:"Unknown error";throw this.metrics.timing(`storage.operations.${e}.duration`,l,{...a,error:"true"}),this.metrics.increment(`storage.operations.${e}.error.count`,1,{...a,error:c}),n}}}export{D as $,ft as B,dt as a,rt as d,B as t,Qe as u,Ye as z};