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

package/dist/packem_shared/storj-CVA9mM-7.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var o=(e,s)=>c(e,"name",{value:s,configurable:!0});var n=Object.defineProperty,S=o((e,s)=>n(e,"name",{value:s,configurable:!0}),"r");const a=S(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.STORJ_ACCESS_KEY_ID??process.env.STORJ_ACCESS_KEY,t=e?.endpoint??process.env.STORJ_ENDPOINT,r=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.STORJ_SECRET_ACCESS_KEY??process.env.STORJ_SECRET_KEY;if(!s||!r)throw new Error("Missing required parameters for Storj client.");return{credentials:{accessKeyId:s,secretAccessKey:r},endpoint:t??"https://gateway.storjshare.io",forcePathStyle:!1,region:"global"}},"storj");export{a as default};

package/dist/packem_shared/tencent-CAcAGaIW.js

@@ -0,0 +1 @@
+var t=Object.defineProperty;var n=(e,s)=>t(e,"name",{value:s,configurable:!0});var E=Object.defineProperty,a=n((e,s)=>E(e,"name",{value:s,configurable:!0}),"c");const T=a(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.TENCENT_SECRET_ID,o=e?.endpoint??process.env.TENCENT_ENDPOINT,r=e?.region??process.env.TENCENT_REGION,c=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.TENCENT_SECRET_KEY;if(!r||!s||!c)throw new Error("Missing required parameters for Tencent Cloud COS client.");return{credentials:{accessKeyId:s,secretAccessKey:c},endpoint:o??`https://cos.${r}.myqcloud.com`,forcePathStyle:!1,region:r}},"tencent");export{T as default};

package/dist/packem_shared/tigris-wmhjfsH2.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var t=(e,s)=>n(e,"name",{value:s,configurable:!0});var o=Object.defineProperty,S=t((e,s)=>o(e,"name",{value:s,configurable:!0}),"r");const _=S(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.TIGRIS_ACCESS_KEY_ID??process.env.TIGRIS_ACCESS_KEY,c=e?.endpoint??process.env.TIGRIS_ENDPOINT,r=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.TIGRIS_SECRET_ACCESS_KEY??process.env.TIGRIS_SECRET_KEY;if(!s||!r)throw new Error("Missing required parameters for Tigris client.");return{credentials:{accessKeyId:s,secretAccessKey:r},endpoint:c??"https://t3.storage.dev",forcePathStyle:!1,region:"auto"}},"tigris");export{_ as default};

package/dist/packem_shared/transformOpenApiSpec-C0vEbDTO.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var n=(e,t)=>a(e,"name",{value:t,configurable:!0});import{createHash as i}from"node:crypto";import{createPaginationMetaSchemaObject as o,createPaginationSchemaObject as s}from"@visulima/pagination";import{sharedFileMetaSchemaObject as p,sharedErrorSchemaObject as m,sharedFileMetaExampleObject as c}from"./sharedGet-Ce7WGAsc.js";var d=Object.defineProperty,l=n((e,t)=>d(e,"name",{value:t,configurable:!0}),"n");const g=l((e="/",t=["Transform"])=>{const r=i("sha256").update(e).digest("base64");return{components:{examples:c,parameters:{Affine:{description:"Apply affine transformation",in:"query",name:"affine",schema:{type:"boolean"}},Angle:{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"}},Background:{description:"Background color for rotation (hex, rgb, or color name)",in:"query",name:"background",schema:{type:"string"}},Bitrate:{description:"Target bitrate in bits per second",in:"query",name:"bitrate",schema:{minimum:1,type:"integer"}},Blur:{description:"Apply blur effect",in:"query",name:"blur",schema:{type:"boolean"}},Brightness:{description:"Brightness multiplier for modulation",in:"query",name:"brightness",schema:{type:"number"}},Clahe:{description:"Apply CLAHE (Contrast Limited Adaptive Histogram Equalization)",in:"query",name:"clahe",schema:{type:"boolean"}},Codec:{description:"Video or audio codec",in:"query",name:"codec",schema:{enum:["avc","hevc","vp8","vp9","av1","aac","opus","mp3","vorbis","flac"],type:"string"}},Colourspace:{description:"Convert colourspace",in:"query",name:"colourspace",schema:{enum:["srgb","rgb","cmyk","lab","b-w"],type:"string"}},CropHeight:{description:"Crop area height",in:"query",name:"cropHeight",schema:{minimum:1,type:"integer"}},CropWidth:{description:"Crop area width",in:"query",name:"cropWidth",schema:{minimum:1,type:"integer"}},Dilate:{description:"Apply dilation",in:"query",name:"dilate",schema:{type:"boolean"}},EnsureAlpha:{description:"Ensure alpha channel",in:"query",name:"ensureAlpha",schema:{type:"boolean"}},Erode:{description:"Apply erosion",in:"query",name:"erode",schema:{type:"boolean"}},FastShrinkOnLoad:{description:"Fast shrink on load for large images",in:"query",name:"fastShrinkOnLoad",schema:{type:"boolean"}},FileID:{description:"File identifier",in:"path",name:"id",required:!0,schema:{type:"string"}},Fit:{description:"Resize fit mode",in:"query",name:"fit",schema:{enum:["cover","contain","fill","inside","outside"],type:"string"}},Flatten:{description:"Flatten alpha channel",in:"query",name:"flatten",schema:{type:"boolean"}},Flip:{description:"Flip image vertically",in:"query",name:"flip",schema:{type:"boolean"}},Flop:{description:"Flop image horizontally",in:"query",name:"flop",schema:{type:"boolean"}},Format:{description:"Output format for the transformed media",in:"query",name:"format",schema:{enum:["jpeg","png","webp","avif","tiff","gif","mp4","webm","mkv","ogg","mp3","wav","aac","flac"],type:"string"}},FrameRate:{description:"Video frame rate in Hz",in:"query",name:"frameRate",schema:{minimum:1,type:"number"}},Gamma:{description:"Apply gamma correction",in:"query",name:"gamma",schema:{type:"boolean"}},Greyscale:{description:"Convert to greyscale",in:"query",name:"greyscale",schema:{type:"boolean"}},Height:{description:"Desired height in pixels",in:"query",name:"height",schema:{minimum:1,type:"integer"}},Hue:{description:"Hue rotation in degrees for modulation",in:"query",name:"hue",schema:{type:"integer"}},Kernel:{description:"Resize kernel algorithm",in:"query",name:"kernel",schema:{enum:["nearest","cubic","mitchell","lanczos2","lanczos3"],type:"string"}},KeyFrameInterval:{description:"Video key frame interval in seconds",in:"query",name:"keyFrameInterval",schema:{minimum:.1,type:"number"}},Left:{description:"Crop area left offset",in:"query",name:"left",schema:{minimum:0,type:"integer"}},Lightness:{description:"Lightness adjustment for modulation",in:"query",name:"lightness",schema:{type:"integer"}},Median:{description:"Apply median filter with specified size",in:"query",name:"median",schema:{minimum:1,type:"integer"}},Modulate:{description:"Apply modulation effects",in:"query",name:"modulate",schema:{type:"boolean"}},Negate:{description:"Negate (invert) the image",in:"query",name:"negate",schema:{type:"boolean"}},Normalise:{description:"Normalise the image",in:"query",name:"normalise",schema:{type:"boolean"}},NumberOfChannels:{description:"Audio channel count",in:"query",name:"numberOfChannels",schema:{enum:[1,2,3,4,5,6,7,8],type:"integer"}},PipelineColourspace:{description:"Set pipeline colourspace",in:"query",name:"pipelineColourspace",schema:{type:"boolean"}},Position:{description:"Position for cover/contain fits",in:"query",name:"position",schema:{oneOf:[{enum:["top","right","bottom","left","center"],type:"string"},{minimum:0,type:"integer"}]}},Quality:{description:"Quality setting (0-100 for images, affects compression)",in:"query",name:"quality",schema:{maximum:100,minimum:1,type:"integer"}},RemoveAlpha:{description:"Remove alpha channel",in:"query",name:"removeAlpha",schema:{type:"boolean"}},SampleRate:{description:"Audio sample rate in Hz",in:"query",name:"sampleRate",schema:{enum:[8e3,11025,16e3,22050,32e3,44100,48e3,88200,96e3,192e3],type:"integer"}},Saturation:{description:"Saturation multiplier for modulation",in:"query",name:"saturation",schema:{type:"number"}},Sharpen:{description:"Apply sharpening",in:"query",name:"sharpen",schema:{type:"boolean"}},Threshold:{description:"Apply thresholding with specified value (0-255)",in:"query",name:"threshold",schema:{maximum:255,minimum:0,type:"integer"}},Tint:{description:"Apply tinting",in:"query",name:"tint",schema:{type:"boolean"}},ToColourspace:{description:"Convert to colourspace",in:"query",name:"toColourspace",schema:{type:"boolean"}},Top:{description:"Crop area top offset",in:"query",name:"top",schema:{minimum:0,type:"integer"}},Unflatten:{description:"Unflatten alpha channel",in:"query",name:"unflatten",schema:{type:"boolean"}},Width:{description:"Desired width in pixels",in:"query",name:"width",schema:{minimum:1,type:"integer"}},WithoutEnlargement:{description:"Avoid enlarging images smaller than specified dimensions",in:"query",name:"withoutEnlargement",schema:{type:"boolean"}},WithoutReduction:{description:"Avoid reducing images larger than specified dimensions",in:"query",name:"withoutReduction",schema:{type:"boolean"}}},responses:{404:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"}},schemas:{...s("FileMetaPagination",{$ref:"#/components/schemas/PaginationMeta"},"#/components/schemas/PaginationMeta"),...o("PaginationMeta"),...m,...p,MediaTransformResult:{description:"Result of media transformation",properties:{bitrate:{description:"Bitrate for video/audio (bits per second)",type:"integer"},buffer:{description:"Binary data buffer (not included in JSON response)",type:"string"},duration:{description:"Duration for video/audio in seconds",type:"number"},format:{description:"Output format",type:"string"},height:{description:"Height for image/video in pixels",type:"integer"},mediaType:{description:"Type of media",enum:["image","video","audio"],type:"string"},numberOfChannels:{description:"Audio channel count",type:"integer"},originalFile:{$ref:"#/components/schemas/FileMeta"},sampleRate:{description:"Audio sample rate in Hz",type:"integer"},size:{description:"File size in bytes",type:"integer"},width:{description:"Width for image/video in pixels",type:"integer"}},required:["format","mediaType","originalFile","size"],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"}}},paths:{[`${e.replace(/\/$/,"")}/{id}/transform`]:{get:{description:"Get transformation metadata for a file without downloading. Returns information about supported transformations and current file properties.",operationId:`${r}TransformGetMetadata`,parameters:[{$ref:"#/components/parameters/FileID"}],responses:{200:{content:{"application/json":{schema:{description:"File transformation metadata",properties:{bitrate:{description:"Current bitrate for video/audio",type:"integer"},dimensions:{description:"Dimensions for image/video",properties:{height:{type:"integer"},width:{type:"integer"}},type:"object"},duration:{description:"Duration for video/audio in seconds",type:"number"},mediaType:{description:"Detected media type",enum:["image","video","audio"],type:"string"},numberOfChannels:{description:"Current channel count for audio",type:"integer"},originalFormat:{description:"Original file format",type:"string"},sampleRate:{description:"Current sample rate for audio",type:"integer"},supportedFormats:{description:"Supported output formats for this media type",items:{type:"string"},type:"array"},supportedParameters:{description:"Supported transformation parameters",items:{type:"string"},type:"array"}},required:["mediaType","supportedFormats","supportedParameters"],type:"object"}}},description:"Transformation metadata"},404:{$ref:"#/components/responses/404"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Get transformation metadata",tags:t}},[`${e.replace(/\/$/,"")}/{id}`]:{get:{description:"Retrieve and transform a file with optional media transformations. Supports resizing, cropping, format conversion, and codec changes based on query parameters.",operationId:`${r}TransformGetFile`,parameters:[{$ref:"#/components/parameters/FileID"},{$ref:"#/components/parameters/Format"},{$ref:"#/components/parameters/Quality"},{$ref:"#/components/parameters/Width"},{$ref:"#/components/parameters/Height"},{$ref:"#/components/parameters/Fit"},{$ref:"#/components/parameters/Position"},{$ref:"#/components/parameters/WithoutEnlargement"},{$ref:"#/components/parameters/WithoutReduction"},{$ref:"#/components/parameters/Left"},{$ref:"#/components/parameters/Top"},{$ref:"#/components/parameters/CropWidth"},{$ref:"#/components/parameters/CropHeight"},{$ref:"#/components/parameters/Angle"},{$ref:"#/components/parameters/Background"},{$ref:"#/components/parameters/Kernel"},{$ref:"#/components/parameters/FastShrinkOnLoad"},{$ref:"#/components/parameters/Blur"},{$ref:"#/components/parameters/Sharpen"},{$ref:"#/components/parameters/Median"},{$ref:"#/components/parameters/Clahe"},{$ref:"#/components/parameters/Threshold"},{$ref:"#/components/parameters/Gamma"},{$ref:"#/components/parameters/Negate"},{$ref:"#/components/parameters/Normalise"},{$ref:"#/components/parameters/Flatten"},{$ref:"#/components/parameters/Unflatten"},{$ref:"#/components/parameters/Flip"},{$ref:"#/components/parameters/Flop"},{$ref:"#/components/parameters/Greyscale"},{$ref:"#/components/parameters/Modulate"},{$ref:"#/components/parameters/Brightness"},{$ref:"#/components/parameters/Saturation"},{$ref:"#/components/parameters/Hue"},{$ref:"#/components/parameters/Lightness"},{$ref:"#/components/parameters/Tint"},{$ref:"#/components/parameters/Colourspace"},{$ref:"#/components/parameters/Affine"},{$ref:"#/components/parameters/Dilate"},{$ref:"#/components/parameters/Erode"},{$ref:"#/components/parameters/PipelineColourspace"},{$ref:"#/components/parameters/ToColourspace"},{$ref:"#/components/parameters/RemoveAlpha"},{$ref:"#/components/parameters/EnsureAlpha"},{$ref:"#/components/parameters/Codec"},{$ref:"#/components/parameters/Bitrate"},{$ref:"#/components/parameters/FrameRate"},{$ref:"#/components/parameters/KeyFrameInterval"},{$ref:"#/components/parameters/NumberOfChannels"},{$ref:"#/components/parameters/SampleRate"}],responses:{200:{content:{"*/*":{schema:{description:"Transformed media file",format:"binary",type:"string"}}},description:"Transformed file returned successfully",headers:{"Content-Type":{description:"MIME type of the transformed file",schema:{type:"string"}},ETag:{description:"ETag of the transformed file",schema:{type:"string"}},"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"}}}},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","left","top","cropWidth","cropHeight","angle","background"]},message:"Invalid query parameters for image transformation: codec, bitrate. Images support: format, quality, width, height, fit, position, withoutEnlargement, withoutReduction, left, top, cropWidth, cropHeight, angle, background. Video/audio parameters (codec, bitrate) are not supported for images.",name:"ValidationError"}}}},schema:{$ref:"#/components/schemas/ValidationError"}}},description:"Invalid transformation parameters"},404:{$ref:"#/components/responses/404"},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"},default:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Error"}},summary:"Transform and retrieve file",tags:t}}}}},"swaggerSpec");export{g as default};

package/dist/packem_shared/tus-base.d-CygntIPM.d.ts

@@ -0,0 +1,99 @@
+import { EventEmitter } from 'node:events';
+import { U as UploadFile, j as ResponseBodyType, B as BaseStorage, k as ErrorResponses } from "./storage.d-RteRC-cG.js";
+import 'node:stream';
+import { M as MediaTransformer } from "./media-transformer.d-C3QvECD7.js";
+import { U as UploadOptions } from "./types.d-cI_cMxcZ.js";
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+import '@visulima/pagination';
+/**
+* Core base class containing shared business logic for all handlers.
+* This class is platform-agnostic and contains no Node.js or Web API specific code.
+* @template TFile The file type used by this handler.
+*/
+declare abstract class BaseHandlerCore<TFile extends UploadFile> extends EventEmitter {
+  /**
+  * Response body type for the handler.
+  */
+  responseType: ResponseBodyType;
+  /**
+  * Storage instance for file operations.
+  */
+  storage: BaseStorage<TFile>;
+  /**
+  * Optional media transformer for image/video processing.
+  */
+  mediaTransformer?: MediaTransformer;
+  /**
+  * Whether to disable termination for finished uploads.
+  */
+  disableTerminationForFinishedUploads?: boolean;
+  /**
+  * Logger instance for debugging and error reporting.
+  */
+  protected logger?: Console;
+  /**
+  * Gets the logger instance.
+  * @returns Logger instance or undefined.
+  */
+  get loggerInstance(): Console | undefined;
+  /**
+  * Internal error responses configuration.
+  */
+  protected internalErrorResponses: ErrorResponses;
+  /**
+  * Gets the error responses configuration.
+  * @returns Error responses configuration.
+  */
+  get errorResponses(): ErrorResponses;
+  constructor({
+    disableTerminationForFinishedUploads,
+    mediaTransformer,
+    storage
+  }: UploadOptions<TFile>);
+  /**
+  * Sets custom error responses.
+  * @param value Partial error responses to override defaults.
+  */
+  set errorResponses(value: Partial<ErrorResponses>);
+  /**
+  * Assemble error responses by merging defaults with custom overrides.
+  * @param customErrors Custom error responses to override defaults
+  */
+  assembleErrors: (customErrors?: {}) => void;
+  /**
+  * Parses HTTP Range header and returns start/end byte positions for partial content requests.
+  * @param rangeHeader HTTP Range header value (e.g., "bytes=0-1023").
+  * @param fileSize Total size of the file in bytes.
+  * @returns Object with start and end positions, or undefined if range is invalid.
+  */
+  parseRangeHeader(rangeHeader: string | undefined, fileSize: number): {
+    end: number;
+    start: number;
+  } | undefined;
+  /**
+  * Build file URL from request and file data.
+  * Platform-agnostic version that accepts URL string.
+  * @param requestUrl Request URL string
+  * @param file File object containing ID and content type
+  * @returns Constructed file URL with extension based on content type
+  */
+  protected buildFileUrlFromString(requestUrl: string, file: TFile): string;
+  /**
+  * Negotiates content type based on Accept header and supported formats.
+  * Platform-agnostic version that accepts header string.
+  * @param acceptHeader Accept header value
+  * @param supportedTypes Array of supported MIME types to match against
+  * @returns Best matching content type or undefined if no match found
+  */
+  negotiateContentTypeFromHeader(acceptHeader: string | undefined, supportedTypes: string[]): string | undefined;
+  /**
+  * Check for undefined ID or path errors and throw appropriate HTTP errors.
+  * @param error The error to check
+  */
+  protected checkForUndefinedIdOrPath(error: unknown): void;
+}
+declare const TUS_RESUMABLE: string;
+declare const TUS_VERSION: string;
+export { BaseHandlerCore as B, TUS_RESUMABLE as T, TUS_VERSION as a };

package/dist/packem_shared/tusOpenApiSpec-DF0-hlWV.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var o=(t,a)=>c(t,"name",{value:a,configurable:!0});import{createHash as d}from"node:crypto";import{createPaginationMetaSchemaObject as m,createPaginationSchemaObject as p}from"@visulima/pagination";import{sharedGet as u,sharedFileMetaSchemaObject as l,sharedErrorSchemaObject as f,sharedFileMetaExampleObject as T,sharedGetList as b,sharedGetMeta as r}from"./sharedGet-Ce7WGAsc.js";var U=Object.defineProperty,g=o((t,a)=>U(t,"name",{value:a,configurable:!0}),"o");const R=g((t,a)=>{const{supportedTransformerFormat:i,tags:e,transformer:h}={tags:["Tus"],transformer:!1,...a},s=d("sha256").update(t).digest("base64"),n=u(`${s}TusGetFile`,e,h,i);return{components:{examples:T,responses:{404:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Not Found"}},schemas:{"Tus-Checksum-Algorithm":{description:"Added by the checksum extension. The Tus-Checksum-Algorithm response header MUST be a comma-separated list of the checksum algorithms supported by the server.",type:"string"},"Tus-Extension":{description:"The Tus-Extension response header MUST be a comma-separated list of the extensions supported by the Server. If no extensions are supported, the Tus-Extension header MUST be omitted.",type:"string"},"Tus-Max-Size":{description:"The Tus-Max-Size response header MUST be a non-negative integer indicating the maximum allowed size of an entire upload in bytes. The Server SHOULD set this header if there is a known hard limit.",type:"integer"},"Tus-Resumable":{description:"Protocol version",enum:["1.0.0"],type:"string"},"Tus-Version":{description:"The Tus-Version response header MUST be a comma-separated list of protocol versions supported by the Server. The list MUST be sorted by Server's preference where the first one is the most preferred one.",type:"string"},"Upload-Checksum":{description:"Added by the checksum extension. The Upload-Checksum request header contains information about the checksum of the current body payload. The header MUST consist of the name of the used checksum algorithm and the Base64 encoded checksum separated by a space.",type:"string"},"Upload-Length":{description:"The Upload-Length request and response header indicates the size of the entire upload in bytes. The value MUST be a non-negative integer. In the concatenation extension, the Client MUST NOT include the Upload-Length header in the final upload creation",type:"integer"},"Upload-Offset":{description:"The Upload-Offset request and response header indicates a byte offset within a resource. The value MUST be a non-negative integer.",type:"integer"},...p("FileMetaPagination",{$ref:"#/components/schemas/PaginationMeta"},"#/components/schemas/PaginationMeta"),...m("PaginationMeta"),...f,...l}},paths:{[`${t.replace(/\/$/,"")}/{id}/metadata`]:{get:{...r(`${s}TusGetFileMeta`,e),parameters:[...r(`${s}TusGetFileMeta`,e).parameters,{description:"Version of the protocol supported by the client",in:"header",name:"Tus-Resumable",required:!0,schema:{$ref:"#/components/schemas/Tus-Resumable"}}]}},[`${t.replace(/\/$/,"")}/{id}`]:{delete:{description:"When receiving a DELETE request for an existing upload the Server SHOULD free associated resources and MUST respond with the 204 No Content status confirming that the upload was terminated. For all future requests to this URL, the Server SHOULD respond with the 404 Not Found or 410 Gone status.",operationId:`${s}TusFilesDelete`,parameters:[{in:"path",name:"id",required:!0,schema:{type:"string"}},{in:"header",name:"Tus-Resumable",required:!0,schema:{$ref:"#/components/schemas/Tus-Resumable"}}],responses:{204:{description:"Upload was terminated",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},412:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Precondition Failed",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Tus-Version":{schema:{$ref:"#/components/schemas/Tus-Version"}}}}},summary:"Added by the Termination extension.",tags:e},get:{...n,parameters:[...n.parameters,{description:"Version of the protocol supported by the client",in:"header",name:"Tus-Resumable",required:!0,schema:{$ref:"#/components/schemas/Tus-Resumable"}}]},head:{description:"Used to determine the offset at which the upload should be continued.",operationId:`${s}TusFilesHead`,parameters:[{in:"path",name:"id",required:!0,schema:{type:"string"}},{in:"header",name:"Tus-Resumable",required:!0,schema:{$ref:"#/components/schemas/Tus-Resumable"}}],responses:{200:{description:"Returns offset",headers:{"Cache-Control":{schema:{enum:["no-store"],type:"string"}},"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Upload-Length":{schema:{$ref:"#/components/schemas/Upload-Length"}},"Upload-Offset":{schema:{$ref:"#/components/schemas/Upload-Offset"}}}},403:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"If the resource is not found, the Server SHOULD return either the 404 Not Found, 410 Gone or 403 Forbidden status without the Upload-Offset header.",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},404:{$ref:"#/components/responses/404"},410:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"If the resource is not found, the Server SHOULD return either the 404 Not Found, 410 Gone or 403 Forbidden status without the Upload-Offset header.",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},412:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Precondition Failed",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Tus-Version":{schema:{$ref:"#/components/schemas/Tus-Version"}}}}},summary:"Used to determine the offset at which the upload should be continued.",tags:e},patch:{description:"The Server SHOULD accept PATCH requests against any upload URL and apply the bytes contained in the message at the given offset specified by the Upload-Offset header. All PATCH requests MUST use Content-Type: application/offset+octet-stream, otherwise the server SHOULD return a 415 Unsupported Media Type status.",operationId:`${s}TusFilePatch`,parameters:[{in:"path",name:"id",required:!0,schema:{type:"string"}},{in:"header",name:"Tus-Resumable",required:!0,schema:{$ref:"#/components/schemas/Tus-Resumable"}},{description:"Length of the body of this request",in:"header",name:"Content-Length",required:!0,schema:{type:"integer"}},{in:"header",name:"Upload-Offset",required:!0,schema:{$ref:"#/components/schemas/Upload-Offset"}},{in:"header",name:"Upload-Checksum",schema:{$ref:"#/components/schemas/Upload-Checksum"}}],requestBody:{content:{"application/offset+octet-stream":{schema:{type:"string"}}},description:"Remaining (possibly partial) content of the file. Required if Content-Length > 0.",required:!1},responses:{204:{description:"Upload offset was updated",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Upload-Expires":{description:"Added by the expiration extension. The Upload-Expires response header indicates the time after which the unfinished upload expires. A Server MAY wish to remove incomplete upload after a given period of time to prevent abandoned upload from taking up extra storage. The Client SHOULD use this header to determine if an upload is still valid before attempting to resume the upload. This header MUST be included in every PATCH response if the upload is going to expire. If the expiration is known at the creation, the Upload-Expires header MUST be included in the response to the initial POST request. Its value MAY change over time. If a Client does attempt to resume an upload which has since been removed by the Server, the Server SHOULD respond with the 404 Not Found or 410 Gone status. The latter one SHOULD be used if the Server is keeping track of expired upload. In both cases the Client SHOULD start a new upload. The value of the Upload-Expires header MUST be in RFC 7231 datetime format.",schema:{type:"string"}},"Upload-Offset":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},400:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Added by the checksum extension. The checksum algorithm is not supported by the server",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},403:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"In the concatenation extension, the Server MUST respond with the 403 Forbidden status to PATCH requests against a final upload URL and MUST NOT modify the final or its partial upload.",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},404:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"PATCH request against a non-existent resource",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},409:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"PATCH request with Upload-Offset unequal to the offset of the resource on the server. The Upload-Offset header's value MUST be equal to the current offset of the resource.",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},410:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"PATCH request against a non-existent resource",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},412:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Precondition Failed",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Tus-Version":{schema:{$ref:"#/components/schemas/Tus-Version"}}}},415:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Content-Type was not application/offset+octet-stream",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},460:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Added by the checksum extension. Checksums mismatch",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}}},summary:"Used to resume the upload",tags:e}},[t.trimEnd()]:{get:b(`${s}TusGetList`,e),options:{operationId:`${s}TusOptions`,responses:{204:{description:"Success",headers:{"Tus-Checksum-Algorithm":{schema:{$ref:"#/components/schemas/Tus-Checksum-Algorithm"}},"Tus-Extension":{schema:{$ref:"#/components/schemas/Tus-Extension"}},"Tus-Max-Size":{schema:{$ref:"#/components/schemas/Tus-Max-Size"}},"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Tus-Version":{schema:{$ref:"#/components/schemas/Tus-Version"}}}}},summary:"Request to gather information about the Server's current configuration",tags:e},post:{description:"Endpoint for the Creation extension. Modified by the Creation With Upload extension.",operationId:`${s}TusCreate`,parameters:[{description:"Must be 0 for creation extension. May be a positive number for Creation With Upload extension.",in:"header",name:"Content-Length",schema:{type:"integer"}},{in:"header",name:"Upload-Length",schema:{$ref:"#/components/schemas/Upload-Length"}},{in:"header",name:"Tus-Resumable",schema:{$ref:"#/components/schemas/Tus-Resumable"}},{description:"Added by the Creation extension. The Upload-Metadata request and response header MUST consist of one or more comma-separated key-value pairs. The key and value MUST be separated by a space. The key MUST NOT contain spaces and commas and MUST NOT be empty. The key SHOULD be ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique. The value MAY be empty. In these cases, the space, which would normally separate the key and the value, MAY be left out. Since metadata can contain arbitrary binary values, Servers SHOULD carefully validate metadata values or sanitize them before using them as header values to avoid header smuggling.",in:"header",name:"Upload-Metadata",schema:{type:"string"}},{description:"Added by the Concatenation extension. The Upload-Concat request and response header MUST be set in both partial and final upload creation requests. It indicates whether the upload is either a partial or final upload. If the upload is a partial one, the header value MUST be partial. In the case of a final upload, its value MUST be final followed by a semicolon and a space-separated list of partial upload URLs that will be concatenated. The partial upload URLs MAY be absolute or relative and MUST NOT contain spaces as defined in RFC 3986.",in:"header",name:"Upload-Concat",schema:{type:"string"}},{description:"Added by the Creation Defer Length extension. The Upload-Defer-Length request and response header indicates that the size of the upload is not known currently and will be transferred later. Its value MUST be 1. If the length of an upload is not deferred, this header MUST be omitted.",in:"header",name:"Upload-Defer-Length",schema:{enum:[1],type:"integer"}},{in:"header",name:"Upload-Offset",schema:{$ref:"#/components/schemas/Upload-Offset"}},{in:"header",name:"Upload-Checksum",schema:{$ref:"#/components/schemas/Upload-Checksum"}}],requestBody:{content:{"application/offset+octet-stream":{schema:{type:"string"}}},description:"(Possibly partial) content of the file. Required if Content-Length > 0.",required:!1},responses:{201:{description:"Created",headers:{Location:{description:"Url of the created resource.",schema:{type:"string"}},"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Upload-Expires":{description:"Added by the Creation With Upload Extension in combination with the expiration extension. The Upload-Expires response header indicates the time after which the unfinished upload expires. A Server MAY wish to remove incomplete upload after a given period of time to prevent abandoned upload from taking up extra storage. The Client SHOULD use this header to determine if an upload is still valid before attempting to resume the upload. This header MUST be included in every PATCH response if the upload is going to expire. If the expiration is known at the creation, the Upload-Expires header MUST be included in the response to the initial POST request. Its value MAY change over time. If a Client does attempt to resume an upload which has since been removed by the Server, the Server SHOULD respond with the 404 Not Found or 410 Gone status. The latter one SHOULD be used if the Server is keeping track of expired upload. In both cases the Client SHOULD start a new upload. The value of the Upload-Expires header MUST be in RFC 7231 datetime format.",schema:{type:"string"}},"Upload-Offset":{schema:{$ref:"#/components/schemas/Upload-Offset"}}}},400:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Added by the Creation With Upload Extension in combination with the checksum extension. The checksum algorithm is not supported by the server",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},412:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Precondition Failed",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}},"Tus-Version":{schema:{$ref:"#/components/schemas/Tus-Version"}}}},413:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"If the length of the upload exceeds the maximum, which MAY be specified using the Tus-Max-Size header, the Server MUST respond with the 413 Request Entity Too Large status.",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},415:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Added by the Creation With Upload Extension. Content-Type was not application/offset+octet-stream",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}},460:{content:{"application/json":{schema:{$ref:"#/components/schemas/Error"}}},description:"Added by the Creation With Upload Extension in combination with the checksum extension. Checksums mismatch",headers:{"Tus-Resumable":{schema:{$ref:"#/components/schemas/Tus-Resumable"}}}}},summary:"An empty POST request is used to create a new upload resource. The Upload-Length header indicates the size of the entire upload in bytes. If the Creation With Upload extension is available, the Client MAY include parts of the upload in the initial Creation request",tags:e}}}}},"swaggerSpec");export{R as default};

package/dist/packem_shared/types.d-ChNXbbHG.d.ts

@@ -0,0 +1,104 @@
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions } from "./storage.d-RteRC-cG.js";
+import 'node:stream';
+import { Client } from '@microsoft/microsoft-graph-client';
+declare class OneDriveFile extends File {
+  driveItemId?: string;
+  eTag?: string;
+  webUrl?: string;
+}
+interface OneDriveClientCredentialsAuth {
+  /**
+  * Microsoft Entra (Azure AD) application (client) ID.
+  */
+  clientId: string;
+  /**
+  * Application (client) secret.
+  */
+  clientSecret: string;
+  /**
+  * Microsoft Entra tenant ID (GUID or domain name).
+  */
+  tenantId: string;
+}
+interface OneDriveOAuthRefreshAuth {
+  /**
+  * Microsoft Entra application (client) ID.
+  */
+  clientId: string;
+  /**
+  * Application client secret. Required for confidential clients (default).
+  * Public clients may omit it if the app registration allows.
+  */
+  clientSecret?: string;
+  /**
+  * OAuth2 refresh token obtained from an interactive sign-in flow.
+  */
+  refreshToken: string;
+  /**
+  * Tenant ID — `"common"`, `"consumers"`, `"organizations"`, or a tenant
+  * GUID/domain. Defaults to `"common"`.
+  */
+  tenantId?: string;
+}
+interface OneDriveStorageOptions extends BaseStorageOptions {
+  /**
+  * Static or dynamic access token. Pass a string for a one-shot token, or
+  * a function returning a fresh token on each call.
+  */
+  accessToken?: string | (() => string | Promise<string>);
+  /**
+  * Pre-built `@microsoft/microsoft-graph-client` `Client`. Escape hatch for
+  * callers that wire up their own `AuthenticationProvider` (e.g. with
+  * `@azure/identity` or `@azure/msal-node`).
+  */
+  client?: Client;
+  /**
+  * Client-credentials auth — for app-only / daemon scenarios.
+  * Cannot be used with `/me/drive`; you must target via `driveId`,
+  * `siteId`, or `userId`.
+  */
+  clientCredentials?: OneDriveClientCredentialsAuth;
+  /**
+  * Timeout, in milliseconds, for polling the async-copy monitor URL.
+  * Defaults to 60_000 (60s).
+  */
+  copyTimeoutMs?: number;
+  /**
+  * Target drive by ID. Mutually exclusive with `siteId` and `userId`.
+  */
+  driveId?: string;
+  /**
+  * Configure metafiles storage. Defaults to local tmp directory.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * OAuth2 refresh-token auth — for delegated user scenarios. Exchanges
+  * the refresh token at the Microsoft identity platform and caches the
+  * resulting access token until ~60s before expiry.
+  */
+  oauth?: OneDriveOAuthRefreshAuth;
+  /**
+  * When `true`, `getReadUrl` creates an anonymous shared link with
+  * `view` permission. Otherwise it returns the short-lived pre-authenticated
+  * `@microsoft.graph.downloadUrl` from the item metadata.
+  */
+  publicByDefault?: boolean;
+  /**
+  * Logical "bucket root" — virtual keys live under this folder path within
+  * the target drive. Must already exist; the adapter does not create
+  * folders. Defaults to drive root.
+  */
+  rootFolderPath?: string;
+  /**
+  * Target a SharePoint site's default drive. Mutually exclusive with
+  * `driveId` and `userId`.
+  */
+  siteId?: string;
+  /**
+  * Target a specific user's drive. Mutually exclusive with `driveId` and
+  * `siteId`. Required when using `clientCredentials` auth (Graph does not
+  * accept `/me/drive` for app-only tokens).
+  */
+  userId?: string;
+}
+export { OneDriveFile as O, OneDriveStorageOptions as a, OneDriveClientCredentialsAuth as b, OneDriveOAuthRefreshAuth as c };