@visulima/storage 1.0.0-alpha.33 → 1.0.0-alpha.35

package/CHANGELOG.md

@@ -1,3 +1,52 @@
+## @visulima/storage [1.0.0-alpha.35](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.34...@visulima/storage@1.0.0-alpha.35) (2026-06-13)
+
+### Bug Fixes
+
+* **storage:** fix facade key normalization and add stream/checksum gaps ([6c7da29](https://github.com/visulima/visulima/commit/6c7da29b9c86b6559a997381500498fc20ca65fa))
+
+### Styles
+
+* **storage:** reorder Transform flush before transform in detect-file-type ([ac29bc8](https://github.com/visulima/visulima/commit/ac29bc81632f867b5d12a08cb974abcb67afc78c))
+
+### Miscellaneous Chores
+
+* **storage:** apply prettier formatting to migration and test ([e680d95](https://github.com/visulima/visulima/commit/e680d95b715c66c1020da2c9269285e411ff4c57))
+
+### Code Refactoring
+
+* **storage:** split files barrel into modules ([6f26246](https://github.com/visulima/visulima/commit/6f26246bd7fd4f78cc3ff3e68f8f203a00407fa3))
+
+### Tests
+
+* **storage:** refresh openapi snapshots for pagination meta schema ([42a61cf](https://github.com/visulima/visulima/commit/42a61cf9a067c76078939b801005462b4a608d86))
+
+### Build System
+
+* **deps:** update storage dependencies ([b9a9a68](https://github.com/visulima/visulima/commit/b9a9a684d01d45b7042f3bc27d7bfa71396024c5))
+* regenerate bundled-license manifests and types ordering ([af26588](https://github.com/visulima/visulima/commit/af26588d75aaa937fd4862800560bd4070a4878c))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.14
+* **@visulima/fs:** upgraded to 5.0.0-alpha.32
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.14
+* **@visulima/path:** upgraded to 3.0.0-alpha.13
+
+## @visulima/storage [1.0.0-alpha.34](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.33...@visulima/storage@1.0.0-alpha.34) (2026-06-04)
+
+### Bug Fixes
+
+* **storage:** 4 bug fixes ([587b168](https://github.com/visulima/visulima/commit/587b16893bfd85d20ce205ac6836e83e4e3f8cdf))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.13
+* **@visulima/fs:** upgraded to 5.0.0-alpha.30
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.13
+* **@visulima/path:** upgraded to 3.0.0-alpha.12
+
 ## @visulima/storage [1.0.0-alpha.33](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.32...@visulima/storage@1.0.0-alpha.33) (2026-06-02)
 
 ### Features

package/LICENSE.md

@@ -407,6 +407,35 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > ---------------------------------------
 >
+> ## tinyglobby
+> License: MIT
+> By: Superchupu
+> Repository: git+https://github.com/SuperchupuDev/tinyglobby.git
+>
+> > MIT License
+> >
+> > Copyright (c) 2024 Madeline Gurriarán
+> >
+> > Permission is hereby granted, free of charge, to any person obtaining a copy
+> > of this software and associated documentation files (the "Software"), to deal
+> > in the Software without restriction, including without limitation the rights
+> > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> > copies of the Software, and to permit persons to whom the Software is
+> > furnished to do so, subject to the following conditions:
+> >
+> > The above copyright notice and this permission notice shall be included in all
+> > copies or substantial portions of the Software.
+> >
+> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> > SOFTWARE.
+>
+> ---------------------------------------
+>
 > ## yaml
 > License: ISC
 > By: Eemeli Aro

package/README.md

@@ -6,7 +6,7 @@
 
 </a>
 
-<h3 align="center">Visulima upload - Store files in a web-accessible location via a simplified API. Can automatically scale and rotate images. Includes S3, Azure, GCS and local filesystem-based backends with the most convenient features of each.</h3>
+<h3 align="center">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.</h3>
 
 <!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
@@ -56,6 +56,9 @@ await files.upload("avatars/abc.png", buffer, { contentType: "image/png" });
 
 const url = await files.url("avatars/abc.png", { expiresIn: 900 });
 const { body } = await files.download("avatars/abc.png");
+
+// Stream large objects without buffering the whole payload in memory:
+const { body: stream } = await files.downloadStream("avatars/abc.png");
 ```
 
 Swap the adapter to change provider — everything else stays the same:
@@ -68,7 +71,7 @@ new Files({ adapter: new DiskStorage({ directory: "./uploads" }) });
 new Files({ adapter: new BunnyStorage({ zone, accessKey, region: "de" }) });
 ```
 
-→ See the [Files facade reference](https://visulima.com/docs/packages/storage/files-facade) for the full method surface (`upload`, `download`, `head`, `exists`, `delete`, `copy`, `move`, `list`, `listAll`, `url`, `signedUploadUrl`, `.raw`) and body-type matrix. `list({ delimiter: "/" })` returns directory-style `{ files, prefixes }`; pass `{ readonly: true }` (or call `files.readonly()`) for a locked view, and read `files.capabilities` to branch on adapter support. Top-level `transfer(source, destination)` streams whole buckets between adapters; `sync(source, destination)` does an incremental, optionally-pruning mirror (with `dryRun`).
+→ See the [Files facade reference](https://visulima.com/docs/packages/storage/files-facade) for the full method surface (`upload`, `download`, `downloadStream`, `head`, `exists`, `delete`, `copy`, `move`, `list`, `listAll`, `url`, `signedUploadUrl`, `.raw`) and body-type matrix. `list({ delimiter: "/" })` returns directory-style `{ files, prefixes }`; pass `{ readonly: true }` (or call `files.readonly()`) for a locked view, and read `files.capabilities` to branch on adapter support. Top-level `transfer(source, destination)` streams whole buckets between adapters; `sync(source, destination)` does an incremental, optionally-pruning mirror (with `dryRun`).
 
 ## Building an upload server?
 

package/dist/adapter/nuxt/module.d.ts

@@ -1,11 +1,11 @@
-import { U as UploadOptions } from "../../packem_shared/types.d-CPUyyEj9.js";
-import { U as UploadFile, B as BaseStorage } from "../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadOptions } from "../../packem_shared/types.d-CggTCgXr.js";
+import { U as UploadFile, B as BaseStorage } from "../../packem_shared/storage.d-CEM1upWM.js";
 import 'node:stream';
 import 'node:events';
 import 'node:http';
 import '@visulima/pagination';
-import "../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../packem_shared/types.d-CrUWY4On.js";
 import 'node:crypto';
 import 'lru-cache';
 /**

package/dist/adapter/nuxt/module.js

@@ -1 +1 @@
-var v=Object.defineProperty;var p=(a,r)=>v(a,"name",{value:r,configurable:!0});import{defineNuxtModule as b}from"@nuxt/kit";var U=Object.defineProperty,S=p((a,r)=>U(a,"name",{value:r,configurable:!0}),"g");const i=new Map,j=b({defaults:{basePath:"/api/upload",cors:{headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:!0,rest:!0,tus:!0},meta:{compatibility:{nuxt:">=4.0.0"},configKey:"storage",name:"@visulima/storage"},async setup(a,r){const{basePath:o="/api/upload",cors:s={headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:h=!0,multipartOptions:m={},rest:g=!0,restOptions:T={},storage:n,tus:f=!0,tusOptions:H={}}=a;if(!n)throw new Error("[@visulima/storage/nuxt] Storage instance is required");const{Multipart:O,Rest:A,Tus:C}=await import("../../handler/http/node/index.js"),u=h?new O({storage:n,...m}):void 0,d=g?new A({storage:n,...T}):void 0,l=f?new C({storage:n,...H}):void 0,c=S(t=>{const e=Array.isArray(s.origin)?s.origin.join(", "):s.origin||"*";t.node.res.setHeader("Access-Control-Allow-Origin",e),s.methods&&t.node.res.setHeader("Access-Control-Allow-Methods",s.methods.join(", ")),s.headers&&t.node.res.setHeader("Access-Control-Allow-Headers",s.headers.join(", "))},"setCorsHeaders");u&&i.set(`${o}/multipart`,{handler:u,setCorsHeaders:c}),d&&i.set(`${o}/rest`,{handler:d,setCorsHeaders:c}),l&&i.set(`${o}/tus`,{handler:l,setCorsHeaders:c}),r.hook("nitro:config",t=>{const e=t.routeRules||{};u&&(e[`${o}/multipart/**`]={cors:!0}),d&&(e[`${o}/rest/**`]={cors:!0}),l&&(e[`${o}/tus/**`]={cors:!0}),t.routeRules=e}),r.hook("nitro:init",t=>{t.hooks.hook("request",async e=>{const w=e.node.req.url||"";for(const[E,{handler:P,setCorsHeaders:y}]of i.entries())if(w.startsWith(E)){y(e),await P.handle(e.node.req,e.node.res);return}})})}});export{j as default};
+import{defineNuxtModule as y}from"@nuxt/kit";const a=new Map,$=y({defaults:{basePath:"/api/upload",cors:{headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:!0,rest:!0,tus:!0},meta:{compatibility:{nuxt:">=4.0.0"},configKey:"storage",name:"@visulima/storage"},async setup(c,l){const{basePath:r="/api/upload",cors:s={headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:h=!0,multipartOptions:p={},rest:m=!0,restOptions:g={},storage:o,tus:T=!0,tusOptions:f={}}=c;if(!o)throw new Error("[@visulima/storage/nuxt] Storage instance is required");const{Multipart:A,Rest:H,Tus:O}=await import("../../handler/http/node/index.js"),n=h?new A({storage:o,...p}):void 0,i=m?new H({storage:o,...g}):void 0,u=T?new O({storage:o,...f}):void 0,d=t=>{const e=Array.isArray(s.origin)?s.origin.join(", "):s.origin||"*";t.node.res.setHeader("Access-Control-Allow-Origin",e),s.methods&&t.node.res.setHeader("Access-Control-Allow-Methods",s.methods.join(", ")),s.headers&&t.node.res.setHeader("Access-Control-Allow-Headers",s.headers.join(", "))};n&&a.set(`${r}/multipart`,{handler:n,setCorsHeaders:d}),i&&a.set(`${r}/rest`,{handler:i,setCorsHeaders:d}),u&&a.set(`${r}/tus`,{handler:u,setCorsHeaders:d}),l.hook("nitro:config",t=>{const e=t.routeRules||{};n&&(e[`${r}/multipart/**`]={cors:!0}),i&&(e[`${r}/rest/**`]={cors:!0}),u&&(e[`${r}/tus/**`]={cors:!0}),t.routeRules=e}),l.hook("nitro:init",t=>{t.hooks.hook("request",async e=>{const w=e.node.req.url||"";for(const[E,{handler:C,setCorsHeaders:P}]of a.entries())if(w.startsWith(E)){P(e),await C.handle(e.node.req,e.node.res);return}})})}});export{$ as default};

package/dist/ai/ai-sdk/index.d.ts

@@ -1,13 +1,13 @@
-import { F as Files } from "../../packem_shared/index.d-C4o9jVLx.js";
-import { C as CopyFileInput, D as DeleteFileInput, a as DownloadFileInput, G as GetFileMetadataInput, b as GetFileUrlInput, L as ListFilesInput, S as SignUploadUrlInput, U as UploadFileInput, c as FileToolName, A as ApprovalConfig, F as FileReadToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
-export { type d as FileWriteToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
-import { Tool } from 'ai';
-import { e as executors } from "../../packem_shared/executors.d-CRI3jlk4.js";
-import "../../packem_shared/storage.d-D5UN5mRz.js";
+import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+import { C as CopyFileInput, D as DeleteFileInput, a as DownloadFileInput, G as GetFileMetadataInput, b as GetFileUrlInput, L as ListFilesInput, S as SignUploadUrlInput, U as UploadFileInput, F as FileToolName, A as ApprovalConfig, c as FileReadToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export type { d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import { Tool } from 'ai';
+import { e as executors } from "../../packem_shared/executors.d-BZP2rWo3.js";
+import "../../packem_shared/storage.d-CEM1upWM.js";
 import 'zod';
 /**
 * Common options accepted by every write-tool factory.

package/dist/ai/ai-sdk/index.js

@@ -1 +1 @@
-var d=Object.defineProperty;var t=(e,l)=>d(e,"name",{value:l,configurable:!0});import{r as c}from"../../packem_shared/approval-BBeX3o4E.js";import{W as f}from"../../packem_shared/executors-MzQbS9FT.js";import{uploadFile as u,signUploadUrl as g,listFiles as v,getFileUrl as m,getFileMetadata as O,downloadFile as U,deleteFile as b,copyFile as j}from"../../packem_shared/listFiles-BNGQbV_d.js";var y=Object.defineProperty,p=t((e,l)=>y(e,"name",{value:l,configurable:!0}),"r");function T({files:e,overrides:l,readOnly:n=!1,requireApproval:F=!0}){const o=p(r=>({needsApproval:c(r,F)}),"approval"),i={copyFile:j(e,o("copyFile")),deleteFile:b(e,o("deleteFile")),downloadFile:U(e),getFileMetadata:O(e),getFileUrl:m(e),listFiles:v(e),signUploadUrl:g(e,o("signUploadUrl")),uploadFile:u(e,o("uploadFile"))};if(l){for(const[r,a]of Object.entries(l))if(r in i&&a){const s=r;Object.assign(i,{[s]:{...i[s],...a}})}}return n?Object.fromEntries(Object.entries(i).filter(([r])=>!f.has(r))):i}t(T,"createFileTools");p(T,"createFileTools");export{j as copyFile,T as createFileTools,b as deleteFile,U as downloadFile,O as getFileMetadata,m as getFileUrl,v as listFiles,g as signUploadUrl,u as uploadFile};
+import{r as d}from"../../packem_shared/approval-fVHwBp7u.js";import{W as n}from"../../packem_shared/executors-BDzMjc4y.js";import{uploadFile as F,signUploadUrl as c,listFiles as f,getFileUrl as g,getFileMetadata as U,downloadFile as m,deleteFile as u,copyFile as O}from"../../packem_shared/copyFile-49FtxXcm.js";function y({files:e,overrides:r,readOnly:s=!1,requireApproval:p=!0}){const o=l=>({needsApproval:d(l,p)}),i={copyFile:O(e,o("copyFile")),deleteFile:u(e,o("deleteFile")),downloadFile:m(e),getFileMetadata:U(e),getFileUrl:g(e),listFiles:f(e),signUploadUrl:c(e,o("signUploadUrl")),uploadFile:F(e,o("uploadFile"))};if(r){for(const[l,t]of Object.entries(r))if(l in i&&t){const a=l;Object.assign(i,{[a]:{...i[a],...t}})}}return s?Object.fromEntries(Object.entries(i).filter(([l])=>!n.has(l))):i}export{O as copyFile,y as createFileTools,u as deleteFile,m as downloadFile,U as getFileMetadata,g as getFileUrl,f as listFiles,c as signUploadUrl,F as uploadFile};

package/dist/ai/claude/index.d.ts

@@ -1,12 +1,12 @@
 import { SdkMcpToolDefinition, CanUseTool, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
-import { F as Files } from "../../packem_shared/index.d-C4o9jVLx.js";
-import { T as TOOL_SCHEMAS, c as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-3sw7wbPG.js";
-export { type F as FileReadToolName, type d as FileWriteToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
-import "../../packem_shared/storage.d-D5UN5mRz.js";
+import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+import { T as TOOL_SCHEMAS, F as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export type { c as FileReadToolName, d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import "../../packem_shared/storage.d-CEM1upWM.js";
 import 'zod';
 /**
 * MCP tool annotations as accepted by `tool()` and exposed on

package/dist/ai/claude/index.js

@@ -1 +1 @@
-var _=Object.defineProperty;var u=(l,a)=>_(l,"name",{value:a,configurable:!0});import{createSdkMcpServer as b}from"@anthropic-ai/claude-agent-sdk";import{r as h}from"../../packem_shared/approval-BBeX3o4E.js";import{W as y}from"../../packem_shared/executors-MzQbS9FT.js";import{claudeUploadFile as O,claudeSignUploadUrl as S,claudeListFiles as w,claudeGetFileUrl as A,claudeGetFileMetadata as E,claudeDownloadFile as M,claudeDeleteFile as W,claudeCopyFile as $}from"../../packem_shared/claudeListFiles-yLqM5iFS.js";var j=Object.defineProperty,o=u((l,a)=>j(l,"name",{value:a,configurable:!0}),"r");const C="files",D="1.0.0",v=o(l=>y.has(l),"isWriteTool"),I=o(({files:l,overrides:a,readOnly:m=!1,requireApproval:f=!0,serverName:s=C,serverVersion:F=D})=>{const t={copyFile:$(l),deleteFile:W(l),downloadFile:M(l),getFileMetadata:E(l),getFileUrl:A(l),listFiles:w(l),signUploadUrl:S(l),uploadFile:O(l)};if(a){for(const[e,r]of Object.entries(a))if(e in t&&r){const c=e;t[c]={...t[c],...r}}}const i=Object.entries(t).filter(([e])=>!(m&&v(e))),n=`mcp__${s}__`,T=o(e=>e.startsWith(n)?e.slice(n.length):e,"stripPrefix"),U=new Set(i.map(([e])=>e)),p=o(e=>{const r=T(e);return!U.has(r)||!v(r)?!1:h(r,f)},"needsApproval"),g=o((e,r)=>Promise.resolve(p(e)?{behavior:"deny",message:`Tool "${e}" requires approval.`}:{behavior:"allow",updatedInput:r}),"canUseTool"),d=b({name:s,tools:i.map(([,e])=>e),version:F});return{allowedTools:i.map(([e])=>`${n}${e}`),canUseTool:g,mcpServers:{[s]:d},needsApproval:p,server:d,serverName:s}},"createClaudeFileTools");export{$ as claudeCopyFile,W as claudeDeleteFile,M as claudeDownloadFile,E as claudeGetFileMetadata,A as claudeGetFileUrl,w as claudeListFiles,S as claudeSignUploadUrl,O as claudeUploadFile,I as createClaudeFileTools};
+import{createSdkMcpServer as g}from"@anthropic-ai/claude-agent-sdk";import{r as T}from"../../packem_shared/approval-fVHwBp7u.js";import{W as _}from"../../packem_shared/executors-BDzMjc4y.js";import{claudeUploadFile as h,claudeSignUploadUrl as w,claudeListFiles as S,claudeGetFileUrl as O,claudeGetFileMetadata as b,claudeDownloadFile as y,claudeDeleteFile as A,claudeCopyFile as M}from"../../packem_shared/claudeCopyFile-BX9O4ORk.js";const $="files",E="1.0.0",n=l=>_.has(l),x=({files:l,overrides:i,readOnly:m=!1,requireApproval:u=!0,serverName:a=$,serverVersion:v=E})=>{const o={copyFile:M(l),deleteFile:A(l),downloadFile:y(l),getFileMetadata:b(l),getFileUrl:O(l),listFiles:S(l),signUploadUrl:w(l),uploadFile:h(l)};if(i){for(const[e,r]of Object.entries(i))if(e in o&&r){const c=e;o[c]={...o[c],...r}}}const s=Object.entries(o).filter(([e])=>!(m&&n(e))),t=`mcp__${a}__`,F=e=>e.startsWith(t)?e.slice(t.length):e,f=new Set(s.map(([e])=>e)),d=e=>{const r=F(e);return!f.has(r)||!n(r)?!1:T(r,u)},U=(e,r)=>Promise.resolve(d(e)?{behavior:"deny",message:`Tool "${e}" requires approval.`}:{behavior:"allow",updatedInput:r}),p=g({name:a,tools:s.map(([,e])=>e),version:v});return{allowedTools:s.map(([e])=>`${t}${e}`),canUseTool:U,mcpServers:{[a]:p},needsApproval:d,server:p,serverName:a}};export{M as claudeCopyFile,A as claudeDeleteFile,y as claudeDownloadFile,b as claudeGetFileMetadata,O as claudeGetFileUrl,S as claudeListFiles,w as claudeSignUploadUrl,h as claudeUploadFile,x as createClaudeFileTools};

package/dist/ai/openai/index.d.ts

@@ -1,14 +1,14 @@
-import { T as TOOL_SCHEMAS, c as FileToolName, A as ApprovalConfig, F as FileReadToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
-export { type d as FileWriteToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
+import { T as TOOL_SCHEMAS, F as FileToolName, A as ApprovalConfig, c as FileReadToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export type { d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
 import { UnknownContext, FunctionTool } from '@openai/agents';
-import { F as Files } from "../../packem_shared/index.d-C4o9jVLx.js";
-import { e as executors } from "../../packem_shared/executors.d-CRI3jlk4.js";
-import 'zod';
-import "../../packem_shared/storage.d-D5UN5mRz.js";
+import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+import { e as executors } from "../../packem_shared/executors.d-BZP2rWo3.js";
+import 'zod';
+import "../../packem_shared/storage.d-CEM1upWM.js";
 /**
 * Per-tool overrides for `createResponsesFileTools`. `name`, `parameters`, and
 * `type` are intentionally not overridable — the contract that drives tool

package/dist/ai/openai/index.js

@@ -1 +1 @@
-import{agentsCopyFile as l,agentsDeleteFile as a,agentsDownloadFile as s,agentsGetFileMetadata as o,agentsGetFileUrl as n,agentsListFiles as i,agentsSignUploadUrl as g,agentsUploadFile as F,createAgentsFileTools as r}from"../../packem_shared/agentsListFiles-Bl2TOnMy.js";import{createResponsesFileTools as d}from"../../packem_shared/createResponsesFileTools-DFFHq35s.js";export{l as agentsCopyFile,a as agentsDeleteFile,s as agentsDownloadFile,o as agentsGetFileMetadata,n as agentsGetFileUrl,i as agentsListFiles,g as agentsSignUploadUrl,F as agentsUploadFile,r as createAgentsFileTools,d as createResponsesFileTools};
+import{agentsCopyFile as l,agentsDeleteFile as a,agentsDownloadFile as s,agentsGetFileMetadata as o,agentsGetFileUrl as n,agentsListFiles as i,agentsSignUploadUrl as g,agentsUploadFile as F,createAgentsFileTools as r}from"../../packem_shared/agentsCopyFile-Dl5iffdH.js";import{createResponsesFileTools as d}from"../../packem_shared/createResponsesFileTools-6Tvt2PNr.js";export{l as agentsCopyFile,a as agentsDeleteFile,s as agentsDownloadFile,o as agentsGetFileMetadata,n as agentsGetFileUrl,i as agentsListFiles,g as agentsSignUploadUrl,F as agentsUploadFile,r as createAgentsFileTools,d as createResponsesFileTools};

package/dist/ai/tanstack/index.d.ts

@@ -1,12 +1,12 @@
-import { F as Files } from "../../packem_shared/index.d-C4o9jVLx.js";
-import { T as TOOL_SCHEMAS, F as FileReadToolName, c as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-3sw7wbPG.js";
-export { type d as FileWriteToolName } from "../../packem_shared/approval.d-3sw7wbPG.js";
-import { ServerTool } from '@tanstack/ai';
-import "../../packem_shared/storage.d-D5UN5mRz.js";
+import { F as Files } from "../../packem_shared/files.d-CH0iLBNC.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+import { T as TOOL_SCHEMAS, c as FileReadToolName, F as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export type { d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import { ServerTool } from '@tanstack/ai';
+import "../../packem_shared/storage.d-CEM1upWM.js";
 import 'zod';
 /**
 * Common options accepted by every write-tool factory.

package/dist/ai/tanstack/index.js

@@ -1 +1 @@
-var d=Object.defineProperty;var a=(e,l)=>d(e,"name",{value:l,configurable:!0});import{r as c}from"../../packem_shared/approval-BBeX3o4E.js";import{W as f}from"../../packem_shared/executors-MzQbS9FT.js";import{uploadFile as u,signUploadUrl as g,listFiles as v,getFileUrl as m,getFileMetadata as O,downloadFile as U,deleteFile as T,copyFile as b}from"../../packem_shared/listFiles-BdBngq3i.js";var j=Object.defineProperty,n=a((e,l)=>j(e,"name",{value:l,configurable:!0}),"i");function y({files:e,overrides:l,readOnly:p=!1,requireApproval:F=!0}){const o=n(i=>({needsApproval:c(i,F)}),"approval"),r={copyFile:b(e,o("copyFile")),deleteFile:T(e,o("deleteFile")),downloadFile:U(e),getFileMetadata:O(e),getFileUrl:m(e),listFiles:v(e),signUploadUrl:g(e,o("signUploadUrl")),uploadFile:u(e,o("uploadFile"))};if(l){for(const[i,t]of Object.entries(l))if(i in r&&t){const s=i;Object.assign(r,{[s]:{...r[s],...t}})}}return p?Object.fromEntries(Object.entries(r).filter(([i])=>!f.has(i))):r}a(y,"createTanstackFileTools");n(y,"createTanstackFileTools");export{b as copyFile,y as createTanstackFileTools,T as deleteFile,U as downloadFile,O as getFileMetadata,m as getFileUrl,v as listFiles,g as signUploadUrl,u as uploadFile};
+import{r as p}from"../../packem_shared/approval-fVHwBp7u.js";import{W as d}from"../../packem_shared/executors-BDzMjc4y.js";import{uploadFile as F,signUploadUrl as c,listFiles as f,getFileUrl as g,getFileMetadata as U,downloadFile as m,deleteFile as u,copyFile as O}from"../../packem_shared/copyFile-BUPezT_c.js";function j({files:e,overrides:t,readOnly:s=!1,requireApproval:n=!0}){const o=l=>({needsApproval:p(l,n)}),i={copyFile:O(e,o("copyFile")),deleteFile:u(e,o("deleteFile")),downloadFile:m(e),getFileMetadata:U(e),getFileUrl:g(e),listFiles:f(e),signUploadUrl:c(e,o("signUploadUrl")),uploadFile:F(e,o("uploadFile"))};if(t){for(const[l,r]of Object.entries(t))if(l in i&&r){const a=l;Object.assign(i,{[a]:{...i[a],...r}})}}return s?Object.fromEntries(Object.entries(i).filter(([l])=>!d.has(l))):i}export{O as copyFile,j as createTanstackFileTools,u as deleteFile,m as downloadFile,U as getFileMetadata,g as getFileUrl,f as listFiles,c as signUploadUrl,F as uploadFile};

package/dist/handler/http/fetch/index.d.ts

@@ -1,16 +1,16 @@
-import { U as UploadFile, K as UploadResponse } from "../../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadFile, m as UploadResponse } from "../../../packem_shared/storage.d-CEM1upWM.js";
 import 'node:stream';
-import { H as Handlers, R as ResponseFile, a as ResponseList, U as UploadOptions } from "../../../packem_shared/types.d-CPUyyEj9.js";
-export { type A as AsyncHandler, type B as BaseHandler, type M as MethodHandler, type b as RequestEvent, type c as UploadErrorEvent, type d as UploadEvent } from "../../../packem_shared/types.d-CPUyyEj9.js";
-import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-D7UPhqdW.js";
-export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-D7UPhqdW.js";
+import { H as Handlers, R as ResponseFile, a as ResponseList, U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
+export type { A as AsyncHandler, B as BaseHandler, M as MethodHandler, b as RequestEvent, c as UploadErrorEvent, d as UploadEvent } from "../../../packem_shared/types.d-CggTCgXr.js";
+import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
+export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../../packem_shared/types.d-CrUWY4On.js";
 /**
 * Base handler for Web API Fetch platform (Request/Response).
 * Extends BaseHandlerCore with Fetch-specific request/response handling.

package/dist/handler/http/fetch/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/Multipart-IE3j_gAJ.js";import{default as f}from"../../../packem_shared/Rest-B_E4TrqF.js";import{Tus as p}from"../../../packem_shared/Tus-KQ8J2WF3.js";import{TUS_RESUMABLE as s,TUS_VERSION as u}from"../../../packem_shared/TUS_RESUMABLE-B7KtPVeC.js";export{o as Multipart,f as Rest,s as TUS_RESUMABLE,u as TUS_VERSION,p as Tus};
+import{default as o}from"../../../packem_shared/Multipart-CQjYqU--.js";import{default as f}from"../../../packem_shared/Rest-Cb2Ja3ny.js";import{Tus as p}from"../../../packem_shared/Tus-BvTC2OC2.js";import{TUS_RESUMABLE as s,TUS_VERSION as u}from"../../../packem_shared/TUS_RESUMABLE-D-jBomrU.js";export{o as Multipart,f as Rest,s as TUS_RESUMABLE,u as TUS_VERSION,p as Tus};

package/dist/handler/http/hono/index.d.ts

@@ -1,14 +1,14 @@
 import { Hono } from 'hono';
-import { U as UploadFile } from "../../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadFile } from "../../../packem_shared/storage.d-CEM1upWM.js";
 import 'node:stream';
-import { U as UploadOptions } from "../../../packem_shared/types.d-CPUyyEj9.js";
+import { U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../../packem_shared/types.d-CrUWY4On.js";
 /**
 * Registers upload handler routes on a Hono app instance.
 * Automatically registers all required HTTP methods for the specified handler type.

package/dist/handler/http/hono/index.js

@@ -1 +1 @@
-var d=Object.defineProperty;var c=(t,n)=>d(t,"name",{value:n,configurable:!0});import u from"../../../packem_shared/Multipart-IE3j_gAJ.js";import l from"../../../packem_shared/Rest-B_E4TrqF.js";import{Tus as p}from"../../../packem_shared/Tus-KQ8J2WF3.js";var m=Object.defineProperty,i=c((t,n)=>m(t,"name",{value:n,configurable:!0}),"a");const w=i(t=>async n=>{try{const e=n.req.raw;return await t.fetch(e)}catch(e){const a=e,s=a.statusCode||(a.status?Number.parseInt(a.status,10):void 0)||500;return Response.json({error:a.message||"Request failed"},{status:s})}},"createHandlerFunction"),k=i((t,n)=>{const{path:e,type:a,...s}=n;let o;switch(a){case"multipart":{o=new u(s);break}case"rest":{o=new l(s);break}case"tus":{o=new p(s);break}default:throw new Error(`Unknown handler type: ${String(a??"unknown")}`)}const r=w(o);switch(a){case"multipart":{t.post(e,r),t.get(`${e}/:id?/:metadata?`,r),t.delete(`${e}/:id`,r),t.on("OPTIONS",e,r);break}case"rest":{t.post(e,r),t.put(`${e}/:id`,r),t.patch(`${e}/:id`,r),t.get(`${e}/:id?`,r),t.on("HEAD",`${e}/:id`,r),t.delete(`${e}/:id?`,r),t.on("OPTIONS",e,r);break}case"tus":{t.all(e,r),t.all(`${e}/:id`,r);break}default:throw new Error(`Unknown handler type: ${String(a)}`)}},"createStorageHandler");export{k as createStorageHandler};
+import c from"../../../packem_shared/Multipart-CQjYqU--.js";import i from"../../../packem_shared/Rest-Cb2Ja3ny.js";import{Tus as d}from"../../../packem_shared/Tus-BvTC2OC2.js";const u=t=>async o=>{try{const e=o.req.raw;return await t.fetch(e)}catch(e){const a=e,s=a.statusCode||(a.status?Number.parseInt(a.status,10):void 0)||500;return Response.json({error:a.message||"Request failed"},{status:s})}},m=(t,o)=>{const{path:e,type:a,...s}=o;let n;switch(a){case"multipart":{n=new c(s);break}case"rest":{n=new i(s);break}case"tus":{n=new d(s);break}default:throw new Error(`Unknown handler type: ${String(a??"unknown")}`)}const r=u(n);switch(a){case"multipart":{t.post(e,r),t.get(`${e}/:id?/:metadata?`,r),t.delete(`${e}/:id`,r),t.on("OPTIONS",e,r);break}case"rest":{t.post(e,r),t.put(`${e}/:id`,r),t.patch(`${e}/:id`,r),t.get(`${e}/:id?`,r),t.on("HEAD",`${e}/:id`,r),t.delete(`${e}/:id?`,r),t.on("OPTIONS",e,r);break}case"tus":{t.all(e,r),t.all(`${e}/:id`,r);break}default:throw new Error(`Unknown handler type: ${String(a)}`)}};export{m as createStorageHandler};

package/dist/handler/http/nextjs/index.d.ts

@@ -1,14 +1,14 @@
 import { NextRequest, NextResponse } from 'next/server.js';
-import { U as UploadFile } from "../../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadFile } from "../../../packem_shared/storage.d-CEM1upWM.js";
 import 'node:stream';
-import { U as UploadOptions } from "../../../packem_shared/types.d-CPUyyEj9.js";
+import { U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../../packem_shared/types.d-CrUWY4On.js";
 /**
 * Configuration for Next.js handler.
 */

package/dist/handler/http/nextjs/index.js

@@ -1 +1 @@
-var c=Object.defineProperty;var a=(e,r)=>c(e,"name",{value:r,configurable:!0});import{NextResponse as i}from"next/server.js";import m from"../../../packem_shared/Multipart-IE3j_gAJ.js";import p from"../../../packem_shared/Rest-B_E4TrqF.js";import{Tus as d}from"../../../packem_shared/Tus-KQ8J2WF3.js";var l=Object.defineProperty,n=a((e,r)=>l(e,"name",{value:r,configurable:!0}),"r");const k=n(e=>{let r;switch(e.type){case"multipart":{r=new m(e);break}case"rest":{r=new p(e);break}case"tus":{r=new d(e);break}default:throw new Error(`Unknown handler type: ${String(e.type??"unknown")}`)}return n(async s=>{try{return await r.fetch(s)}catch(o){const t=o,u=t.statusCode||(t.status?Number.parseInt(t.status,10):void 0)||500;return i.json({error:t.message||"Request failed"},{status:u})}},"nextjsHandler")},"createHandler");export{k as createHandler};
+import{NextResponse as o}from"next/server.js";import u from"../../../packem_shared/Multipart-CQjYqU--.js";import c from"../../../packem_shared/Rest-Cb2Ja3ny.js";import{Tus as m}from"../../../packem_shared/Tus-BvTC2OC2.js";const d=t=>{let r;switch(t.type){case"multipart":{r=new u(t);break}case"rest":{r=new c(t);break}case"tus":{r=new m(t);break}default:throw new Error(`Unknown handler type: ${String(t.type??"unknown")}`)}return async s=>{try{return await r.fetch(s)}catch(n){const e=n,a=e.statusCode||(e.status?Number.parseInt(e.status,10):void 0)||500;return o.json({error:e.message||"Request failed"},{status:a})}}};export{d as createHandler};

package/dist/handler/http/node/index.d.ts

@@ -1,16 +1,16 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { U as UploadFile, K as UploadResponse } from "../../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadFile, m as UploadResponse } from "../../../packem_shared/storage.d-CEM1upWM.js";
 import { Readable } from 'node:stream';
-import { H as Handlers, A as AsyncHandler, U as UploadOptions, R as ResponseFile, a as ResponseList, M as MethodHandler } from "../../../packem_shared/types.d-CPUyyEj9.js";
-export { type B as BaseHandler, type b as RequestEvent, type c as UploadErrorEvent, type d as UploadEvent } from "../../../packem_shared/types.d-CPUyyEj9.js";
-import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-D7UPhqdW.js";
-export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-D7UPhqdW.js";
+import { H as Handlers, A as AsyncHandler, U as UploadOptions, R as ResponseFile, a as ResponseList, M as MethodHandler } from "../../../packem_shared/types.d-CggTCgXr.js";
+export type { B as BaseHandler, b as RequestEvent, c as UploadErrorEvent, d as UploadEvent } from "../../../packem_shared/types.d-CggTCgXr.js";
+import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
+export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
 import 'node:crypto';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../../packem_shared/types.d-CrUWY4On.js";
 /**
 * Base handler for Node.js platform (IncomingMessage/ServerResponse).
 * Extends BaseHandlerCore with Node.js-specific request/response handling.
@@ -352,7 +352,14 @@ declare class Tus<TFile extends UploadFile, NodeRequest extends IncomingMessage
   protected compose(): void;
   /**
   * Build file URL for TUS uploads (without file extension).
-  * @param requestUrl Request URL string
+  *
+  * On the Node runtime the TUS protocol chain only carries the request *path* (`requestUrl` is
+  * `request.originalUrl || request.url`), so an absolute `Location` can only be produced when that
+  * path is itself an absolute URL (e.g. an upstream proxy rewrote it). When it is just a path the
+  * `Location` is necessarily relative — the request headers are not threaded through the protocol
+  * methods. Use the fetch/hono handlers (which receive `request.url` with the origin) or set
+  * `useRelativeLocation: true` explicitly for relative URLs everywhere.
+  * @param requestUrl Request URL string (path-only on Node unless rewritten to an absolute URL).
   * @param file File object containing ID
   * @returns Constructed file URL for TUS protocol
   */

package/dist/handler/http/node/index.js

@@ -1 +1 @@
-import o from"../../../packem_shared/Multipart-UIRqOPCf.js";import m from"../../../packem_shared/Rest-DItHKz-N.js";import{Tus as f}from"../../../packem_shared/Tus-CAestp2j.js";import{TUS_RESUMABLE as S,TUS_VERSION as a}from"../../../packem_shared/TUS_RESUMABLE-B7KtPVeC.js";export{o as Multipart,m as Rest,S as TUS_RESUMABLE,a as TUS_VERSION,f as Tus};
+import o from"../../../packem_shared/Multipart-D0ok6BBy.js";import m from"../../../packem_shared/Rest-QhlT9FbR.js";import{Tus as f}from"../../../packem_shared/Tus-DdAo4aXh.js";import{TUS_RESUMABLE as S,TUS_VERSION as a}from"../../../packem_shared/TUS_RESUMABLE-D-jBomrU.js";export{o as Multipart,m as Rest,S as TUS_RESUMABLE,a as TUS_VERSION,f as Tus};

package/dist/handler/http/solid-start/index.d.ts

@@ -1,14 +1,14 @@
 import { APIEvent } from '@solidjs/start/server';
-import { U as UploadFile } from "../../../packem_shared/storage.d-D5UN5mRz.js";
+import { U as UploadFile } from "../../../packem_shared/storage.d-CEM1upWM.js";
 import 'node:stream';
-import { U as UploadOptions } from "../../../packem_shared/types.d-CPUyyEj9.js";
+import { U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-B5cQJz30.js";
-import "../../../packem_shared/types.d-BsjUOfBJ.js";
+import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
+import "../../../packem_shared/types.d-CrUWY4On.js";
 /**
 * Configuration for SolidStart handler.
 */

package/dist/handler/http/solid-start/index.js

@@ -1 +1 @@
-var i=Object.defineProperty;var a=(t,e)=>i(t,"name",{value:e,configurable:!0});import c from"../../../packem_shared/Multipart-IE3j_gAJ.js";import d from"../../../packem_shared/Rest-B_E4TrqF.js";import{Tus as l}from"../../../packem_shared/Tus-KQ8J2WF3.js";var p=Object.defineProperty,n=a((t,e)=>p(t,"name",{value:e,configurable:!0}),"s");const b=n(t=>{let e;switch(t.type){case"multipart":{e=new c(t);break}case"rest":{e=new d(t);break}case"tus":{e=new l(t);break}default:throw new Error(`Unknown handler type: ${String(t.type??"unknown")}`)}return n(async s=>{try{return await e.fetch(s.request)}catch(o){const r=o,u=r.statusCode||(r.status?Number.parseInt(r.status,10):void 0)||500;return Response.json({error:r.message||"Request failed"},{headers:{"Content-Type":"application/json"},status:u})}},"solidStartHandler")},"createSolidStartHandler");export{b as createSolidStartHandler};
+import o from"../../../packem_shared/Multipart-CQjYqU--.js";import u from"../../../packem_shared/Rest-Cb2Ja3ny.js";import{Tus as p}from"../../../packem_shared/Tus-BvTC2OC2.js";const w=t=>{let e;switch(t.type){case"multipart":{e=new o(t);break}case"rest":{e=new u(t);break}case"tus":{e=new p(t);break}default:throw new Error(`Unknown handler type: ${String(t.type??"unknown")}`)}return async n=>{try{return await e.fetch(n.request)}catch(s){const r=s,a=r.statusCode||(r.status?Number.parseInt(r.status,10):void 0)||500;return Response.json({error:r.message||"Request failed"},{headers:{"Content-Type":"application/json"},status:a})}}};export{w as createSolidStartHandler};

package/dist/index.d.ts

@@ -1,16 +1,63 @@
-export { type B as BulkDeleteResult, type a as BulkDownloadOptions, type b as BulkDownloadResult, type c as BulkError, type d as BulkExistsResult, type e as BulkHeadResult, type f as BulkMoveItem, type g as BulkMoveResult, type h as BulkOptions, type i as BulkUploadItem, type j as BulkUploadOptions, type k as BulkUploadResult, type D as DownloadOptions, type l as DownloadRange, type m as DownloadResult, type n as FileBody, type o as FileObject, F as Files, type p as FilesHooks, type q as FilesOptions, type H as HookActionType, type r as HookEvent, type L as ListAllOptions, type s as ListDirectoryResult, type t as ListOptions, type M as MultipartOptions, type S as SignedReadUrlOptions, type u as SignedUploadUrlOptions, type v as StorageCapabilities, type w as SyncOptions, type x as SyncProgress, type y as SyncResult, type T as TransferOptions, type z as TransferProgress, type A as TransferResult, U as UploadControl, type C as UploadControlState, type E as UploadControlToken, type G as UploadOptions, type I as UploadProgress, type J as UploadProgressCallback, K as sync, N as transfer } from "./packem_shared/index.d-C4o9jVLx.js";
-import { m as Metrics } from "./packem_shared/storage.d-D5UN5mRz.js";
-export { B as AbstractBaseStorage, type j as BaseStorageOptions, type n as BatchOperationResponse, type o as BatchOperationResult, type D as DiskStorageOptions, type h as DiskStorageWithChecksumOptions, E as ERRORS, p as ErrorMap, type q as ExpirationOptions, F as File, type e as FileInit, type f as FilePart, type g as FileQuery, type r as Header, type s as Headers, type H as HttpError, type t as HttpErrorBody, type I as IncomingMessageWithBody, type L as LocalMetaStorageOptions, M as MetaStorage, type i as MetaStorageOptions, u as Metadata, type v as OnComplete, type w as OnCreate, type x as OnDelete, type y as OnError, type z as OnUpdate, type P as PurgeList, type A as RangeChecksum, type C as RangeHasher, type G as ResponseBody, type k as ResponseBodyType, type J as ResponseTuple, type R as RetryConfig, b as UploadError, type c as UploadEventType, type U as UploadFile, type K as UploadResponse, type V as Validation, type N as ValidationError, type Q as ValidatorConfig, d as createRetryWrapper, S as defaultCloudStorageFileNameValidation, T as defaultFilesystemFileNameValidation, W as extractHttpStatus, X as isRetryableError, Y as isUploadError, Z as mapStatusToErrorCode, _ as retry, $ as throwErrorCode, a0 as wrapStorageError } from "./packem_shared/storage.d-D5UN5mRz.js";
+import { F as Files, S as SyncOptions, a as SyncResult, T as TransferOptions, b as TransferResult } from "./packem_shared/files.d-CH0iLBNC.js";
+export { type B as BulkDeleteResult, type c as BulkDownloadOptions, type d as BulkDownloadResult, type e as BulkError, type f as BulkExistsResult, type g as BulkHeadResult, type h as BulkMoveItem, type i as BulkMoveResult, type j as BulkOptions, type k as BulkUploadItem, type l as BulkUploadOptions, type m as BulkUploadResult, type D as DownloadOptions, type n as DownloadRange, type o as DownloadResult, type p as DownloadStreamResult, type q as FileBody, type r as FileObject, type s as FilesHooks, type t as FilesOptions, type H as HookActionType, type u as HookEvent, type L as ListAllOptions, type v as ListDirectoryResult, type w as ListOptions, type M as MultipartOptions, type x as SignedReadUrlOptions, type y as SignedUploadUrlOptions, type z as StorageCapabilities, type A as SyncProgress, type C as TransferProgress, U as UploadControl, type E as UploadControlState, type G as UploadControlToken, type I as UploadOptions, type J as UploadProgress, type K as UploadProgressCallback } from "./packem_shared/files.d-CH0iLBNC.js";
+import { n as Metrics } from "./packem_shared/storage.d-CEM1upWM.js";
+export { B as AbstractBaseStorage, type l as BaseStorageOptions, type o as BatchOperationResponse, type p as BatchOperationResult, type D as DiskStorageOptions, type j as DiskStorageWithChecksumOptions, i as ERRORS, q as ErrorMap, type r as ExpirationOptions, F as File, type d as FileInit, type e as FilePart, type f as FileQuery, type s as Header, type t as Headers, type H as HttpError, type u as HttpErrorBody, type I as IncomingMessageWithBody, type L as LocalMetaStorageOptions, M as MetaStorage, type k as MetaStorageOptions, v as Metadata, type w as OnComplete, type x as OnCreate, type y as OnDelete, type z as OnError, type A as OnUpdate, type P as PurgeList, type G as RangeChecksum, type J as RangeHasher, type K as ResponseBody, type h as ResponseBodyType, type N as ResponseTuple, type R as RetryConfig, a as UploadError, type b as UploadEventType, type U as UploadFile, type m as UploadResponse, type V as Validation, type Q as ValidationError, type S as ValidatorConfig, c as createRetryWrapper, T as defaultCloudStorageFileNameValidation, W as defaultFilesystemFileNameValidation, X as extractHttpStatus, Y as isRetryableError, Z as isUploadError, _ as mapStatusToErrorCode, $ as retry, a0 as throwErrorCode, a1 as wrapStorageError } from "./packem_shared/storage.d-CEM1upWM.js";
 import { Meter } from '@opentelemetry/api';
-export { D as DiskStorage, a as DiskStorageWithChecksum } from "./packem_shared/disk-storage-with-checksum.d-Z_Z-OQpm.js";
-export { L as LocalMetaStorage } from "./packem_shared/local-meta-storage.d-CobcjyWu.js";
-export { M as MemoryMetaStorage, a as MemoryStorage, type b as MemoryStorageOptions } from "./packem_shared/memory-storage.d-CunLnxmE.js";
+export { D as DiskStorage, a as DiskStorageWithChecksum } from "./packem_shared/disk-storage-with-checksum.d-B-VGEsfl.js";
+export { L as LocalMetaStorage } from "./packem_shared/local-meta-storage.d-D9PBfkn6.js";
+export { M as MemoryMetaStorage, a as MemoryStorage, type b as MemoryStorageOptions } from "./packem_shared/memory-storage.d-4EU1cMt1.js";
 export { type AnyWebReadableByteStreamWithFileType, type AnyWebReadableStream, type Detector, type FileTypeOptions, type FileTypeParser, type FileTypeResult, type StreamOptions, type TokenizerPositionError, fileTypeFromBlob, fileTypeFromBuffer, fileTypeFromTokenizer, supportedExtensions, supportedMimeTypes } from 'file-type';
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 /**
+* Streams every object from `source` to `destination` for cross-provider migration.
+* Built entirely on the public {@link Files} surface — no adapter implements anything new.
+*
+* Each object is downloaded and re-uploaded with bounded concurrency. By default missing
+* destination keys are uploaded and existing keys are skipped — pass `overwrite: true` to force
+* re-upload. Body, content type, and user metadata travel; `etag`/`lastModified` are
+* destination-assigned.
+*
+* Like the other bulk methods, `transfer` doesn't throw on partial failure: results come back as
+* `{ transferred, skipped, errors? }`.
+* @example
+* ```ts
+* const from = new Files({ adapter: new S3Storage({ bucket: "old", ... }) });
+* const to = new Files({ adapter: new GCSStorage({ bucket: "new", ... }) });
+*
+* const { transferred, skipped, errors } = await transfer(from, to, {
+*   prefix: "uploads/",
+*   onProgress: ({ done, key, status }) => console.log(done, key, status),
+* });
+* ```
+*/
+declare const transfer: (source: Files, destination: Files, options?: TransferOptions) => Promise<TransferResult>;
+/**
+* Incremental, optionally-pruning mirror from `source` to `destination`. Built entirely on the
+* public {@link Files} surface — no adapter implements anything new.
+*
+* Each source object is compared against its destination counterpart (by size, then etag, then
+* modification time) and only copied when missing or differing; matching objects are skipped. With
+* `prune: true`, destination keys absent from the source are deleted afterwards (full mirror).
+* Pass `dryRun: true` to compute the plan without writing.
+*
+* Like the other bulk methods, `sync` doesn't throw on partial failure: results come back as
+* `{ uploaded, updated, unchanged, deleted, errors? }`.
+* @example
+* ```ts
+* const from = new Files({ adapter: new S3Storage({ bucket: "primary", ... }) });
+* const to = new Files({ adapter: new GCSStorage({ bucket: "mirror", ... }) });
+*
+* // Preview first…
+* const plan = await sync(from, to, { prefix: "assets/", prune: true, dryRun: true });
+* // …then apply.
+* const result = await sync(from, to, { prefix: "assets/", prune: true });
+* ```
+*/
+declare const sync: (source: Files, destination: Files, options?: SyncOptions) => Promise<SyncResult>;
+/**
 * Wait for storage to be ready before handling requests.
 * This ensures storage initialization (e.g., AWS S3, GCS) completes before processing uploads.
 * @param storage Storage instance with isReady property
@@ -56,4 +103,4 @@ declare class OpenTelemetryMetrics implements Metrics {
   */
   gauge(name: string, value: number, attributes?: Record<string, string | number>): void;
 }
-export { type Metrics, NoOpMetrics, OpenTelemetryMetrics, waitForStorage };
+export { Files, type Metrics, NoOpMetrics, OpenTelemetryMetrics, type SyncOptions, type SyncResult, type TransferOptions, type TransferResult, sync, transfer, waitForStorage };

package/dist/index.js

@@ -1 +1 @@
-import{Files as o,UploadControl as t,sync as a,transfer as p}from"./packem_shared/UploadControl-Otw_5jxw.js";import{waitForStorage as f}from"./packem_shared/waitForStorage-ChSBLhLc.js";import{p as m}from"./packem_shared/disk-storage-CklneE2m.js";import{default as d}from"./packem_shared/DiskStorageWithChecksum--U7zOz-0.js";import{v as u}from"./packem_shared/local-meta-storage-Bvl0Flac.js";import{default as y}from"./packem_shared/MemoryMetaStorage-DEzfBNgL.js";import{default as M}from"./packem_shared/MemoryStorage-BuNY963D.js";import{default as E}from"./packem_shared/MetaStorage-Y4m1dWgd.js";import{B as c,d as T,a as C}from"./packem_shared/storage-z0o24zmZ.js";import{ERRORS as k,ErrorMap as B,UploadError as b,extractHttpStatus as h,isUploadError as w,mapStatusToErrorCode as N,throwErrorCode as O,wrapStorageError as U}from"./packem_shared/ERRORS-vMSqlI69.js";import{createRetryWrapper as V,isRetryableError as W,retry as v}from"./packem_shared/isRetryableError-CBZ65V6T.js";import{fileTypeFromBlob as A,fileTypeFromBuffer as H,fileTypeFromTokenizer as L,supportedExtensions as j,supportedMimeTypes as q}from"file-type";import{default as I}from"./packem_shared/File-BhfUgJjs.js";import{default as K}from"./packem_shared/NoOpMetrics-Dky06sf1.js";import{default as Q}from"./packem_shared/OpenTelemetryMetrics-9uxQMSlg.js";import{Metadata as Y}from"./packem_shared/Metadata-B6Ir0KO7.js";export{c as AbstractBaseStorage,m as DiskStorage,d as DiskStorageWithChecksum,k as ERRORS,B as ErrorMap,I as File,o as Files,u as LocalMetaStorage,y as MemoryMetaStorage,M as MemoryStorage,E as MetaStorage,Y as Metadata,K as NoOpMetrics,Q as OpenTelemetryMetrics,t as UploadControl,b as UploadError,V as createRetryWrapper,T as defaultCloudStorageFileNameValidation,C as defaultFilesystemFileNameValidation,h as extractHttpStatus,A as fileTypeFromBlob,H as fileTypeFromBuffer,L as fileTypeFromTokenizer,W as isRetryableError,w as isUploadError,N as mapStatusToErrorCode,v as retry,j as supportedExtensions,q as supportedMimeTypes,a as sync,O as throwErrorCode,p as transfer,f as waitForStorage,U as wrapStorageError};
+import{waitForStorage as o}from"./packem_shared/waitForStorage-ByQmG4xF.js";import{F as a}from"./packem_shared/disk-storage-B0Mx8dWz.js";import{default as f}from"./packem_shared/DiskStorageWithChecksum-Bs7d8vb1.js";import{y as m}from"./packem_shared/local-meta-storage-DEpVJPLI.js";import{default as i}from"./packem_shared/MemoryMetaStorage-Ksgh9pe7.js";import{default as x}from"./packem_shared/MemoryStorage-9gbWd09l.js";import{default as y}from"./packem_shared/MetaStorage-DPEUyWgN.js";import{B as g,d as F,a as M}from"./packem_shared/storage-0j5nCAUp.js";import{ERRORS as E,ErrorMap as c,UploadError as T,extractHttpStatus as C,isUploadError as R,mapStatusToErrorCode as k,throwErrorCode as B,wrapStorageError as b}from"./packem_shared/ERRORS-BIBxE2oR.js";import{createRetryWrapper as w,isRetryableError as N,retry as O}from"./packem_shared/createRetryWrapper-CxgiV_hH.js";import{fileTypeFromBlob as D,fileTypeFromBuffer as V,fileTypeFromTokenizer as W,supportedExtensions as z,supportedMimeTypes as A}from"file-type";import{default as L}from"./packem_shared/File-W8aOo15X.js";import{default as q}from"./packem_shared/NoOpMetrics-BLo6u4NY.js";import{default as G}from"./packem_shared/OpenTelemetryMetrics-DJDQsNKp.js";import{Files as J}from"./packem_shared/Files-BL-vFOMZ.js";import{Metadata as P}from"./packem_shared/Metadata-kxSBaSee.js";import{UploadControl as X}from"./packem_shared/UploadControl-DZJhI9Wh.js";import{sync as Z,transfer as _}from"./packem_shared/sync-DhR3536K.js";export{g as AbstractBaseStorage,a as DiskStorage,f as DiskStorageWithChecksum,E as ERRORS,c as ErrorMap,L as File,J as Files,m as LocalMetaStorage,i as MemoryMetaStorage,x as MemoryStorage,y as MetaStorage,P as Metadata,q as NoOpMetrics,G as OpenTelemetryMetrics,X as UploadControl,T as UploadError,w as createRetryWrapper,F as defaultCloudStorageFileNameValidation,M as defaultFilesystemFileNameValidation,C as extractHttpStatus,D as fileTypeFromBlob,V as fileTypeFromBuffer,W as fileTypeFromTokenizer,N as isRetryableError,R as isUploadError,k as mapStatusToErrorCode,O as retry,z as supportedExtensions,A as supportedMimeTypes,Z as sync,B as throwErrorCode,_ as transfer,o as waitForStorage,b as wrapStorageError};

package/dist/openapi/index.js

@@ -1 +1 @@
-import{default as t}from"../packem_shared/restOpenApiSpec-PaIVbESh.js";import{sharedErrorSchemaObject as p,sharedFileMetaExampleObject as s,sharedFileMetaSchemaObject as o,sharedGet as f,sharedGetList as c}from"../packem_shared/sharedGet-Ce7WGAsc.js";import{default as m}from"../packem_shared/transformOpenApiSpec-C0vEbDTO.js";import{default as i}from"../packem_shared/tusOpenApiSpec-DF0-hlWV.js";import{default as x}from"../packem_shared/xhrOpenApiSpec-nyoboz83.js";export{t as restOpenApiSpec,p as sharedErrorSchemaObject,s as sharedFileMetaExampleObject,o as sharedFileMetaSchemaObject,f as sharedGet,c as sharedGetList,m as transformOpenApiSpec,i as tusOpenApiSpec,x as xhrOpenApiSpec};
+import{default as t}from"../packem_shared/restOpenApiSpec-Csv513qf.js";import{sharedErrorSchemaObject as p,sharedFileMetaExampleObject as s,sharedFileMetaSchemaObject as o,sharedGet as f,sharedGetList as c}from"../packem_shared/sharedErrorSchemaObject-YN65aAKj.js";import{default as m}from"../packem_shared/transformOpenApiSpec-CIEAgpBD.js";import{default as i}from"../packem_shared/tusOpenApiSpec-D96B03t5.js";import{default as x}from"../packem_shared/xhrOpenApiSpec-DQR4h6M8.js";export{t as restOpenApiSpec,p as sharedErrorSchemaObject,s as sharedFileMetaExampleObject,o as sharedFileMetaSchemaObject,f as sharedGet,c as sharedGetList,m as transformOpenApiSpec,i as tusOpenApiSpec,x as xhrOpenApiSpec};

package/dist/packem_shared/AbstractBaseStorage-CiPEMcuo.js

@@ -0,0 +1 @@
+import"node:stream";import"node:timers";import"node:util";import{B as u,d as F,a as g}from"./storage-0j5nCAUp.js";import"./path-0oTTdkvl-DvWvbDbh.js";import"type-is";import"./NoOpMetrics-BLo6u4NY.js";import"./cache-Cw3QjoVN.js";import"./ERRORS-BIBxE2oR.js";import"./createRetryWrapper-CxgiV_hH.js";import"./is-expired-CBEk6XBi.js";export{u as BaseStorage,F as defaultCloudStorageFileNameValidation,g as defaultFilesystemFileNameValidation};

package/dist/packem_shared/AwsLightFile-CpZrubaV.js

@@ -0,0 +1 @@
+import r from"./File-W8aOo15X.js";class s extends r{Parts;UploadId;uri;partsUrls;partSize}export{s as default};

package/dist/packem_shared/AwsLightMetaStorage-C7VINc3X.js

@@ -0,0 +1 @@
+import"./MetaStorage-DPEUyWgN.js";import"./Metadata-kxSBaSee.js";import{p as i}from"./aws-light-meta-storage-rDso1apP.js";import"./is-expired-CBEk6XBi.js";export{i as default};

package/dist/packem_shared/AwsLightStorage-XTKsrWEe.js

@@ -0,0 +1 @@
+import{Readable as u}from"node:stream";import{S as m}from"./s3-base-storage-DdzBeohR.js";import{b as h,p as l}from"./aws-light-meta-storage-rDso1apP.js";import f from"./AwsLightFile-CpZrubaV.js";class b extends m{static name="aws-light";s3Api;constructor(e){const{bucket:t=process.env.S3_BUCKET||process.env.AWS_S3_BUCKET,region:r}=e;if(!t)throw new Error("S3 bucket is not defined");if(!r)throw new Error("S3 region is not defined");if(!e.accessKeyId)throw new Error("accessKeyId is required");if(!e.secretAccessKey)throw new Error("secretAccessKey is required");super({bucket:t,clientDirectUpload:e.clientDirectUpload,expiration:e.expiration?.maxAge?{maxAge:String(e.expiration.maxAge)}:void 0,filename:e.filename,logger:e.logger,metaStorage:e.metaStorage,metaStorageConfig:e.metaStorageConfig?{...e.metaStorageConfig,...e}:{...e},partSize:e.partSize,retryConfig:{...e.retryConfig,shouldRetry:n=>{const s=n;return s.statusCode&&[408,429,500,502,503,504].includes(s.statusCode)?!0:s.retryable??!1}}}),this.s3Api=new h({accessKeyId:e.accessKeyId,bucket:t,endpoint:e.endpoint,region:r,secretAccessKey:e.secretAccessKey,service:e.service,sessionToken:e.sessionToken});const{metaStorage:i,metaStorageConfig:a}=e;if(!i){const n={...e,...a,logger:this.logger};this.meta=new l(n)}}normalizeError(e){const t=e;return t.statusCode||t.code?{code:t.code||t.name,message:t.message,name:t.name,statusCode:t.statusCode||500}:super.normalizeError(e)}async update({id:e},t){if(this.config.clientDirectUpload){const r=await this.getMeta(e);return this.buildPresigned({...r,...t})}return super.update({id:e},t)}async getStream({id:e},t){return this.instrumentOperation("getStream",async()=>{const r=this.getS3Api(),{Body:i,ContentLength:a,ContentType:n,ETag:s,Expires:c,LastModified:g}=await this.runOperation(t,o=>r.getObject({Bucket:this.bucket,Key:e},{signal:o}));await this.checkIfExpired({expiredAt:c});const d=i instanceof ReadableStream?u.fromWeb(i):i,p=new u({read(){d.on("data",o=>{this.push(o)}),d.on("end",()=>{this.push(null)}),d.on("error",o=>{this.destroy(o)})}});return{headers:{"Content-Length":a?.toString()??"0","Content-Type":n,...s&&{ETag:s},...c&&{"X-Upload-Expires":c.toString()},...g&&{"Last-Modified":g.toString()}},size:Number(a),stream:p}})}get raw(){return this.s3Api.aws}getS3Api(){return this.s3Api}getFileClass(){return f}getAcl(){}async accessCheck(e=30){await this.s3Api.checkBucketAccess({Bucket:this.bucket})}}export{b as default};

package/dist/packem_shared/AzureFile-DFSaVe25.js

@@ -0,0 +1 @@
+import e from"./File-W8aOo15X.js";class t extends e{requestId;uri}export{t as default};

package/dist/packem_shared/AzureSMetaStorage-wrp-4QPg.js

@@ -0,0 +1 @@
+import"./ERRORS-BIBxE2oR.js";import"./MetaStorage-DPEUyWgN.js";import"./Metadata-kxSBaSee.js";import{c as i}from"./azure-meta-storage-DpzQG4vM.js";export{i as default};