@better-s3/server 3.0.0 → 3.1.0

package/README.md

@@ -19,7 +19,14 @@ const handler = createRouteHandler({
   s3: new S3Client({ region: "us-east-1" }),
   defaultBucket: "my-bucket",
   basePath: "/api/s3",
-  maxFileSize: 100 * 1024 * 1024, // (100 MB) global server limit for all uploads
+
+  // Enable only the features your app needs. All are disabled by default.
+  features: {
+    upload: true,
+    download: true,
+    delete: true,
+    // multipart: true, // enable only if you explicitly need multipart support
+  },
 });
 
 export { handler as GET, handler as POST, handler as DELETE };
@@ -32,16 +39,96 @@ const router = createRouter({
   s3,
   defaultBucket: "my-bucket",
   basePath: "/api/s3",
+  features: { upload: true, download: true, delete: true, multipart: true },
+  hooks: {
+    guard: async ({ request }) => {
+      console.log("[guard]", request.method, request.url);
+    },
+
+    upload: {
+      guard: async ({ key, bucket, contentType, fileSize }) => {
+        console.log("[upload.guard]", { key, bucket, contentType, fileSize });
+      },
+      onPresigned: async ({ key, url, expiresIn }) => {
+        console.log("[upload.onPresigned]", { key, url, expiresIn });
+      },
+      onUploaded: async ({ key, contentType, contentLength, eTag }) => {
+        console.log("[upload.onUploaded]", {
+          key,
+          contentType,
+          contentLength,
+          eTag,
+        });
+      },
+    },
+
+    download: {
+      guard: async ({ key, bucket, fileName }) => {
+        console.log("[download.guard]", { key, bucket, fileName });
+      },
+      onPresigned: async ({ key, url, expiresIn }) => {
+        console.log("[download.onPresigned]", { key, url, expiresIn });
+      },
+    },
+
+    delete: {
+      guard: async ({ key, bucket }) => {
+        console.log("[delete.guard]", { key, bucket });
+      },
+      onDeleted: async ({ key, bucket }) => {
+        console.log("[delete.onDeleted]", { key, bucket });
+      },
+    },
+
+    multipart: {
+      guard: async ({ key, bucket, fileSize }) => {
+        console.log("[multipart.guard]", { key, bucket, fileSize });
+      },
+      onInit: async ({ key, uploadId, contentType, fileSize }) => {
+        console.log("[multipart.onInit]", {
+          key,
+          uploadId,
+          contentType,
+          fileSize,
+        });
+      },
+      onComplete: async ({ key, uploadId, contentLength, eTag }) => {
+        console.log("[multipart.onComplete]", {
+          key,
+          uploadId,
+          contentLength,
+          eTag,
+        });
+      },
+      onAbort: async ({ key, uploadId }) => {
+        console.log("[multipart.onAbort]", { key, uploadId });
+      },
+    },
+  },
 });
 
 app.all("/api/s3/*", (c) => router(c.req.raw)); // Hono example
 ```
 
+## Features
+
+All endpoints are **disabled by default**. You must explicitly opt in via the `features` config — this prevents unintended exposure of expensive or sensitive operations (especially multipart, which is vulnerable to [cost attacks](#multipart-cost-attacks)).
+
+```ts
+features: {
+  upload: true,     // POST /presign/upload + POST /presign/upload/confirm
+  download: true,   // GET  /presign/download
+  delete: true,     // DELETE /delete
+  multipart: true,  // POST /presign/multipart/{init,part,complete,abort}
+}
+```
+
+> Disabled endpoints respond with `404 Not Found`.
 
-| Upload mode | Enforcement                                                                                                                                                       |
-| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Simple      | S3 enforces exact size via `content-length-range` in the signed POST policy — tamperproof                                                                         |
-| Multipart   | 1. Init rejected if `fileSize` exceeds limit · 2. Part requests capped at `ceil(maxFileSize / 5 MiB)` · 3. `HeadObject` after complete → delete + 422 if exceeded |
+| Upload mode | Enforcement                                                                                                     |
+| ----------- | --------------------------------------------------------------------------------------------------------------- |
+| Simple      | S3 enforces exact size via `content-length-range` in the signed POST policy — tamperproof                       |
+| Multipart   | `HeadObject` after complete verifies the final object size; no per-part enforcement at the S3 level (see below) |
 
 > Simple upload is inherently more secure — enforcement happens at the S3 storage layer. Multipart presigned `UploadPart` URLs cannot enforce per-part size; see [Multipart cost attacks](#multipart-cost-attacks).
 
@@ -50,7 +137,7 @@ app.all("/api/s3/*", (c) => router(c.req.raw)); // Hono example
 Run server-side logic at key points. Every hook receives the `Request` object. **Throw to reject** — returned as `{ message }` with status 403, or any status you set on the thrown error.
 
 ```
-Simple:    upload.guard → upload.onSuccess → [S3] → upload.onComplete
+Simple:    upload.guard → upload.onPresigned → [S3] → upload.onUploaded
 Multipart: multipart.guard(init) → multipart.onInit
            multipart.guard(part) → [S3]
            multipart.guard(complete) → HeadObject → multipart.onComplete
@@ -70,7 +157,7 @@ hooks: {
 
 ### Quota check
 
-`fileSize` in `upload.guard` and `multipart.guard` (init only) is **declared by the client** — use it for pre-checks. `contentLength` in `onComplete` is verified by S3.
+`fileSize` in `upload.guard` and `multipart.guard` (init only) is **declared by the client** — use it for pre-checks. `contentLength` in `onUploaded` / `multipart.onComplete` is verified by S3.
 
 ```ts
 hooks: {

package/dist/adapters/next.js

@@ -1,3 +1,3 @@
-import {createPresignedPost}from'@aws-sdk/s3-presigned-post';import {HeadObjectCommand,GetObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';function S(e){let n=e.replace(/[^\x20-\x7E]/g,"_").replace(/["\\]/g,"_"),t=encodeURIComponent(e);return `attachment; filename="${n}"; filename*=UTF-8''${t}`}async function m(e){try{let n=await e.json();return n&&typeof n=="object"?n:null}catch{return null}}function d(e,n){let t=typeof e=="string"?e.trim():"";return t||Response.json({message:`${n} is required`},{status:400})}function g(e){let n=Number(e);return Number.isFinite(n)&&n>0?Math.floor(n):600}function l(e){return async n=>{try{return await e(n)}catch(t){let r=t instanceof Error?t.message:"Internal server error";return console.error("[S3 API]",r),Response.json({message:r},{status:500})}}}async function p(e,n){if(!e)return null;try{return await e(n),null}catch(t){let r=t instanceof Error?t.message:"Forbidden",a=typeof t?.status=="number"?t.status:403;return Response.json({message:r},{status:a})}}var O=5*1024*1024*1024;function w(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=t.bucket?.trim()||e.defaultBucket,s=g(t.expiresIn),o=t.acl==="public-read"?"public-read":"private",i=t.contentType?.trim()||"application/octet-stream",u=typeof t.fileSize=="number"&&t.fileSize>0?Math.floor(t.fileSize):null;if(u!==null&&e.maxFileSize&&u>e.maxFileSize)return Response.json({message:`File size (${u} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let c=await p(e.hooks?.upload?.guard,{request:n,key:r,bucket:a,contentType:t.contentType,fileSize:u??void 0,metadata:t.metadata,acl:o});if(c)return c;let f={acl:o,"Content-Type":i};if(t.fileName&&(f["Content-Disposition"]=S(t.fileName)),t.metadata)for(let[E,B]of Object.entries(t.metadata))f[`x-amz-meta-${E}`]=B;let b=e.maxFileSize??O,y=u??1,k=u??b,{url:R,fields:N}=await createPresignedPost(e.s3,{Bucket:a,Key:r,Conditions:[["content-length-range",y,k]],Fields:f,Expires:s});return await e.hooks?.upload?.onSuccess?.({request:n,key:r,bucket:a,contentType:t.contentType,metadata:t.metadata,acl:o,url:R,expiresIn:s}),Response.json({bucket:a,key:r,url:R,fields:N,expiresIn:s})})}function H(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=t.bucket?.trim()||e.defaultBucket,s=await p(e.hooks?.upload?.guard,{request:n,key:r,bucket:a});if(s)return s;let o=await e.s3.send(new HeadObjectCommand({Bucket:a,Key:r})),i={request:n,key:r,bucket:a,contentType:o.ContentType,contentLength:o.ContentLength??0,eTag:o.ETag?.replace(/"/g,""),metadata:o.Metadata};return await e.hooks?.upload?.onComplete?.(i),Response.json({key:r,bucket:a,contentType:i.contentType,contentLength:i.contentLength,eTag:i.eTag})})}function h(e){return l(async n=>{let{searchParams:t}=new URL(n.url),r=t.get("key")?.trim();if(!r)return Response.json({message:"key query parameter is required"},{status:400});let a=t.get("bucket")?.trim()||e.defaultBucket,s=g(t.get("expiresIn")),o=t.get("fileName")?.trim(),i=await p(e.hooks?.download?.guard,{request:n,key:r,bucket:a,fileName:o||void 0});if(i)return i;let u=await getSignedUrl(e.s3,new GetObjectCommand({Bucket:a,Key:r,...o?{ResponseContentDisposition:`attachment; filename="${o}"`}:{}}),{expiresIn:s});return await e.hooks?.download?.onSuccess?.({request:n,key:r,bucket:a,fileName:o||void 0,url:u,expiresIn:s}),Response.json({bucket:a,key:r,url:u,expiresIn:s})})}function x(e){return l(async n=>{let{searchParams:t}=new URL(n.url),r=t.get("key")?.trim();if(!r)return Response.json({message:"key query parameter is required"},{status:400});let a=t.get("bucket")?.trim()||e.defaultBucket,s=await p(e.hooks?.delete?.guard,{request:n,key:r,bucket:a});if(s)return s;try{await e.s3.send(new HeadObjectCommand({Bucket:a,Key:r}));}catch{return Response.json({message:`Object "${r}" not found`},{status:404})}return await e.s3.send(new DeleteObjectCommand({Bucket:a,Key:r})),await e.hooks?.delete?.onSuccess?.({request:n,key:r,bucket:a}),Response.json({success:!0,bucket:a,key:r})})}function C(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=t.bucket?.trim()||e.defaultBucket,s=t.acl==="public-read"?"public-read":"private",o=typeof t.fileSize=="number"&&t.fileSize>0?Math.floor(t.fileSize):void 0;if(e.maxFileSize&&o===void 0)return Response.json({message:"fileSize is required when maxFileSize is configured"},{status:400});if(o!==void 0&&e.maxFileSize&&o>e.maxFileSize)return Response.json({message:`File size (${o} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let i=await p(e.hooks?.multipart?.guard,{request:n,key:r,bucket:a,fileSize:o});if(i)return i;let{UploadId:u}=await e.s3.send(new CreateMultipartUploadCommand({Bucket:a,Key:r,ContentType:t.contentType,ContentDisposition:t.fileName?S(t.fileName):void 0,Metadata:t.metadata,ACL:s}));return await e.hooks?.multipart?.onInit?.({request:n,key:r,bucket:a,uploadId:u,contentType:t.contentType,fileSize:o,metadata:t.metadata,acl:s}),Response.json({bucket:a,key:r,uploadId:u},{status:201})})}function I(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=d(t.uploadId,"uploadId");if(a instanceof Response)return a;let s=Number(t.partNumber);if(!Number.isInteger(s)||s<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let o=t.bucket?.trim()||e.defaultBucket,i=g(t.expiresIn),u=await p(e.hooks?.multipart?.guard,{request:n,key:r,bucket:o});if(u)return u;let c=await getSignedUrl(e.s3,new UploadPartCommand({Bucket:o,Key:r,UploadId:a,PartNumber:s}),{expiresIn:i});return Response.json({presignedUrl:c,partNumber:s,uploadId:a,bucket:o,expiresIn:i})})}function T(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=d(t.uploadId,"uploadId");if(a instanceof Response)return a;let s=(Array.isArray(t.parts)?t.parts:[]).map(({partNumber:y,eTag:k})=>({PartNumber:Number(y),ETag:String(k)})).filter(y=>Number.isInteger(y.PartNumber)&&y.ETag).sort((y,k)=>y.PartNumber-k.PartNumber);if(!s.length)return Response.json({message:"At least one valid part is required"},{status:400});let o=t.bucket?.trim()||e.defaultBucket,i=await p(e.hooks?.multipart?.guard,{request:n,key:r,bucket:o});if(i)return i;await e.s3.send(new CompleteMultipartUploadCommand({Bucket:o,Key:r,UploadId:a,MultipartUpload:{Parts:s}}));let u=await e.s3.send(new HeadObjectCommand({Bucket:o,Key:r})),c=u.ContentLength??0,f=u.ContentType,b=u.ETag?.replace(/"/g,"");return e.maxFileSize&&c>e.maxFileSize?(await e.s3.send(new DeleteObjectCommand({Bucket:o,Key:r})).catch(()=>{}),Response.json({message:`File size (${c} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:422})):(await e.hooks?.multipart?.onComplete?.({request:n,key:r,bucket:o,uploadId:a,contentLength:c,contentType:f,eTag:b}),Response.json({bucket:o,key:r,uploadId:a,contentLength:c,contentType:f,eTag:b}))})}function P(e){return l(async n=>{let t=await m(n);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=d(t.key,"key");if(r instanceof Response)return r;let a=d(t.uploadId,"uploadId");if(a instanceof Response)return a;let s=t.bucket?.trim()||e.defaultBucket,o=await p(e.hooks?.multipart?.guard,{request:n,key:r,bucket:s});return o||(await e.s3.send(new AbortMultipartUploadCommand({Bucket:s,Key:r,UploadId:a})),await e.hooks?.multipart?.onAbort?.({request:n,key:r,bucket:s,uploadId:a}),Response.json({bucket:s,key:r,uploadId:a,aborted:!0}))})}function j(e){return {presign:{upload:w(e),confirm:H(e),download:h(e)},multipart:{init:C(e),part:I(e),complete:T(e),abort:P(e)},delete:x(e)}}function z(e){let n=j(e),t=e.basePath.replace(/\/$/,"");return async r=>{let a=await p(e.hooks?.guard,{request:r});if(a)return a;let o=new URL(r.url).pathname.slice(t.length).replace(/^\//,""),i=r.method;return i==="POST"&&o==="presign/upload"?n.presign.upload(r):i==="POST"&&o==="presign/upload/confirm"?n.presign.confirm(r):i==="GET"&&o==="presign/download"?n.presign.download(r):i==="DELETE"&&o==="delete"?n.delete(r):i==="POST"&&o==="presign/multipart/init"?n.multipart.init(r):i==="POST"&&o==="presign/multipart/part"?n.multipart.part(r):i==="POST"&&o==="presign/multipart/complete"?n.multipart.complete(r):i==="POST"&&o==="presign/multipart/abort"?n.multipart.abort(r):Response.json({message:"Not Found"},{status:404})}}function Fe(e){return z(e)}
-export{Fe as createRouteHandler};//# sourceMappingURL=next.js.map
+import {createPresignedPost}from'@aws-sdk/s3-presigned-post';import {HeadObjectCommand,GetObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';function S(e){let a=e.replace(/[^\x20-\x7E]/g,"_").replace(/["\\]/g,"_"),t=encodeURIComponent(e);return `attachment; filename="${a}"; filename*=UTF-8''${t}`}async function m(e){try{let a=await e.json();return a&&typeof a=="object"?a:null}catch{return null}}function l(e,a){let t=typeof e=="string"?e.trim():"";return t||Response.json({message:`${a} is required`},{status:400})}function b(e){let a=Number(e);return Number.isFinite(a)&&a>0?Math.floor(a):600}function d(e){return async a=>{try{return await e(a)}catch(t){let r=t instanceof Error?t.message:"Internal server error";return console.error("[S3 API]",r),Response.json({message:r},{status:500})}}}async function p(e,a){if(!e)return null;try{return await e(a),null}catch(t){let r=t instanceof Error?t.message:"Forbidden",n=typeof t?.status=="number"?t.status:403;return Response.json({message:r},{status:n})}}var U=5*1024*1024*1024;function w(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=t.bucket?.trim()||e.defaultBucket,s=b(t.expiresIn),o=t.acl==="public-read"?"public-read":"private",u=t.contentType?.trim()||"application/octet-stream",i=typeof t.fileSize=="number"&&t.fileSize>0?Math.floor(t.fileSize):null;if(i!==null&&e.maxFileSize&&i>e.maxFileSize)return Response.json({message:`File size (${i} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let c=await p(e.hooks?.upload?.guard,{request:a,key:r,bucket:n,contentType:t.contentType,fileSize:i??void 0,metadata:t.metadata,acl:o});if(c)return c;let g={acl:o,"Content-Type":u};if(t.fileName&&(g["Content-Disposition"]=S(t.fileName)),t.metadata)for(let[E,B]of Object.entries(t.metadata))g[`x-amz-meta-${E}`]=B;let R=i??1,y=i??e.maxFileSize??U,{url:k,fields:z}=await createPresignedPost(e.s3,{Bucket:n,Key:r,Conditions:[["content-length-range",R,y]],Fields:g,Expires:s});return await e.hooks?.upload?.onPresigned?.({request:a,key:r,bucket:n,contentType:t.contentType,metadata:t.metadata,acl:o,url:k,expiresIn:s}),Response.json({bucket:n,key:r,url:k,fields:z,expiresIn:s})})}function H(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=t.bucket?.trim()||e.defaultBucket,s=await p(e.hooks?.upload?.guard,{request:a,key:r,bucket:n});if(s)return s;let o=await e.s3.send(new HeadObjectCommand({Bucket:n,Key:r})),u={request:a,key:r,bucket:n,contentType:o.ContentType,contentLength:o.ContentLength??0,eTag:o.ETag?.replace(/"/g,""),metadata:o.Metadata};return await e.hooks?.upload?.onUploaded?.(u),Response.json({key:r,bucket:n,contentType:u.contentType,contentLength:u.contentLength,eTag:u.eTag})})}function h(e){return d(async a=>{let{searchParams:t}=new URL(a.url),r=t.get("key")?.trim();if(!r)return Response.json({message:"key query parameter is required"},{status:400});let n=t.get("bucket")?.trim()||e.defaultBucket,s=b(t.get("expiresIn")),o=t.get("fileName")?.trim(),u=await p(e.hooks?.download?.guard,{request:a,key:r,bucket:n,fileName:o||void 0});if(u)return u;let i=await getSignedUrl(e.s3,new GetObjectCommand({Bucket:n,Key:r,...o?{ResponseContentDisposition:`attachment; filename="${o}"`}:{}}),{expiresIn:s});return await e.hooks?.download?.onPresigned?.({request:a,key:r,bucket:n,fileName:o||void 0,url:i,expiresIn:s}),Response.json({bucket:n,key:r,url:i,expiresIn:s})})}function C(e){return d(async a=>{let{searchParams:t}=new URL(a.url),r=t.get("key")?.trim();if(!r)return Response.json({message:"key query parameter is required"},{status:400});let n=t.get("bucket")?.trim()||e.defaultBucket,s=await p(e.hooks?.delete?.guard,{request:a,key:r,bucket:n});if(s)return s;try{await e.s3.send(new HeadObjectCommand({Bucket:n,Key:r}));}catch{return Response.json({message:`Object "${r}" not found`},{status:404})}return await e.s3.send(new DeleteObjectCommand({Bucket:n,Key:r})),await e.hooks?.delete?.onDeleted?.({request:a,key:r,bucket:n}),Response.json({success:!0,bucket:n,key:r})})}function x(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=t.bucket?.trim()||e.defaultBucket,s=t.acl==="public-read"?"public-read":"private",o=typeof t.fileSize=="number"&&t.fileSize>0?Math.floor(t.fileSize):void 0;if(o!==void 0&&e.maxFileSize&&o>e.maxFileSize)return Response.json({message:`File size (${o} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let u=await p(e.hooks?.multipart?.guard,{request:a,key:r,bucket:n,fileSize:o});if(u)return u;let{UploadId:i}=await e.s3.send(new CreateMultipartUploadCommand({Bucket:n,Key:r,ContentType:t.contentType,ContentDisposition:t.fileName?S(t.fileName):void 0,Metadata:t.metadata,ACL:s}));return await e.hooks?.multipart?.onInit?.({request:a,key:r,bucket:n,uploadId:i,contentType:t.contentType,fileSize:o,metadata:t.metadata,acl:s}),Response.json({bucket:n,key:r,uploadId:i},{status:201})})}function I(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=l(t.uploadId,"uploadId");if(n instanceof Response)return n;let s=Number(t.partNumber);if(!Number.isInteger(s)||s<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let o=t.bucket?.trim()||e.defaultBucket,u=b(t.expiresIn),i=await p(e.hooks?.multipart?.guard,{request:a,key:r,bucket:o});if(i)return i;let c=await getSignedUrl(e.s3,new UploadPartCommand({Bucket:o,Key:r,UploadId:n,PartNumber:s}),{expiresIn:u});return Response.json({presignedUrl:c,partNumber:s,uploadId:n,bucket:o,expiresIn:u})})}function P(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=l(t.uploadId,"uploadId");if(n instanceof Response)return n;let s=(Array.isArray(t.parts)?t.parts:[]).map(({partNumber:y,eTag:k})=>({PartNumber:Number(y),ETag:String(k)})).filter(y=>Number.isInteger(y.PartNumber)&&y.ETag).sort((y,k)=>y.PartNumber-k.PartNumber);if(!s.length)return Response.json({message:"At least one valid part is required"},{status:400});let o=t.bucket?.trim()||e.defaultBucket,u=await p(e.hooks?.multipart?.guard,{request:a,key:r,bucket:o});if(u)return u;await e.s3.send(new CompleteMultipartUploadCommand({Bucket:o,Key:r,UploadId:n,MultipartUpload:{Parts:s}}));let i=await e.s3.send(new HeadObjectCommand({Bucket:o,Key:r})),c=i.ContentLength??0,g=i.ContentType,R=i.ETag?.replace(/"/g,"");return e.maxFileSize&&c>e.maxFileSize?(await e.s3.send(new DeleteObjectCommand({Bucket:o,Key:r})).catch(()=>{}),Response.json({message:`File size (${c} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:422})):(await e.hooks?.multipart?.onComplete?.({request:a,key:r,bucket:o,uploadId:n,contentLength:c,contentType:g,eTag:R}),Response.json({bucket:o,key:r,uploadId:n,contentLength:c,contentType:g,eTag:R}))})}function T(e){return d(async a=>{let t=await m(a);if(!t)return Response.json({message:"Invalid JSON payload"},{status:400});let r=l(t.key,"key");if(r instanceof Response)return r;let n=l(t.uploadId,"uploadId");if(n instanceof Response)return n;let s=t.bucket?.trim()||e.defaultBucket,o=await p(e.hooks?.multipart?.guard,{request:a,key:r,bucket:s});return o||(await e.s3.send(new AbortMultipartUploadCommand({Bucket:s,Key:r,UploadId:n})),await e.hooks?.multipart?.onAbort?.({request:a,key:r,bucket:s,uploadId:n}),Response.json({bucket:s,key:r,uploadId:n,aborted:!0}))})}function j(e){return {presign:{upload:w(e),confirm:H(e),download:h(e)},multipart:{init:x(e),part:I(e),complete:P(e),abort:T(e)},delete:C(e)}}var f=()=>Response.json({message:"Not Found"},{status:404});function N(e){let a=j(e),t=e.basePath.replace(/\/$/,""),{features:r}=e;return async n=>{let s=await p(e.hooks?.guard,{request:n});if(s)return s;let u=new URL(n.url).pathname.slice(t.length).replace(/^\//,""),i=n.method;return i==="POST"&&u==="presign/upload"?r.upload?a.presign.upload(n):f():i==="POST"&&u==="presign/upload/confirm"?r.upload?a.presign.confirm(n):f():i==="GET"&&u==="presign/download"?r.download?a.presign.download(n):f():i==="DELETE"&&u==="delete"?r.delete?a.delete(n):f():i==="POST"&&u==="presign/multipart/init"?r.multipart?a.multipart.init(n):f():i==="POST"&&u==="presign/multipart/part"?r.multipart?a.multipart.part(n):f():i==="POST"&&u==="presign/multipart/complete"?r.multipart?a.multipart.complete(n):f():i==="POST"&&u==="presign/multipart/abort"?r.multipart?a.multipart.abort(n):f():Response.json({message:"Not Found"},{status:404})}}function Oe(e){return N(e)}
+export{Oe as createRouteHandler};//# sourceMappingURL=next.js.map
 //# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/helpers.ts","../../src/handlers/presign/upload.ts","../../src/handlers/presign/confirm.ts","../../src/handlers/presign/download.ts","../../src/handlers/delete.ts","../../src/handlers/multipart/init.ts","../../src/handlers/multipart/part.ts","../../src/handlers/multipart/complete.ts","../../src/handlers/multipart/abort.ts","../../src/create-handlers.ts","../../src/router.ts","../../src/adapters/next.ts"],"names":["buildContentDisposition","fileName","ascii","encoded","parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","MAX_UPLOAD_SIZE","createUploadHandler","config","key","bucket","expiresIn","acl","contentType","fileSize","guardResult","fields","k","v","maxBytes","rangeMin","rangeMax","url","signedFields","createPresignedPost","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","getSignedUrl","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","CompleteMultipartUploadCommand","contentLength","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","createRouter","handlers","base","subpath","method","createRouteHandler"],"mappings":"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","file":"next.js","sourcesContent":["/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n *\n * @example\n * buildContentDisposition(\"résumé finale.pdf\")\n * // → 'attachment; filename=\"resume finale.pdf\"; filename*=UTF-8\\'\\'r%C3%A9sum%C3%A9%20finale.pdf'\n */\nexport function buildContentDisposition(fileName: string): string {\n  const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n  const encoded = encodeURIComponent(fileName);\n  return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n\nexport async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n\n/**\n * Run a server hook. Returns a Response if the hook rejects (throws),\n * or `null` if the hook passes (or is undefined).\n */\nexport async function runHook<T>(\n  hook: ((context: T) => Promise<void> | void) | undefined,\n  context: T,\n): Promise<Response | null> {\n  if (!hook) return null;\n  try {\n    await hook(context);\n    return null;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : \"Forbidden\";\n    const status =\n      typeof (err as Record<string, unknown>)?.status === \"number\"\n        ? ((err as Record<string, unknown>).status as number)\n        : 403;\n    return Response.json({ message }, { status });\n  }\n}\n","import { createPresignedPost } from \"@aws-sdk/s3-presigned-post\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\n// 5 GiB — S3 single-object size limit\nconst MAX_UPLOAD_SIZE = 5 * 1024 * 1024 * 1024;\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  /**\n   * Exact byte size of the file the client intends to upload.\n   * When provided the presigned POST policy locks `content-length-range` to\n   * `[fileSize, fileSize]`, so S3 rejects any upload that is not exactly this\n   * size — even if the client tampers with the payload.\n   * When omitted the range is `[1, maxFileSize ?? 5 GiB]`.\n   */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const contentType = body.contentType?.trim() || \"application/octet-stream\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : null;\n\n    // Reject immediately if the declared size already exceeds the server limit,\n    // before generating any presigned URL.\n    if (\n      fileSize !== null &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      fileSize: fileSize ?? undefined,\n      metadata: body.metadata,\n      acl,\n    });\n    if (guardResult) return guardResult;\n\n    // Build presigned POST fields. Fields are embedded in the signed policy\n    // so the client cannot change them without invalidating the signature.\n    const fields: Record<string, string> = { acl, \"Content-Type\": contentType };\n\n    if (body.fileName) {\n      fields[\"Content-Disposition\"] = buildContentDisposition(body.fileName);\n    }\n\n    if (body.metadata) {\n      for (const [k, v] of Object.entries(body.metadata)) {\n        fields[`x-amz-meta-${k}`] = v;\n      }\n    }\n\n    // `content-length-range` is enforced by S3 at the storage layer —\n    // uploads outside this range are rejected before the object is stored.\n    //\n    // When the client declares fileSize: S3 locks the range to exactly that\n    // number of bytes, so uploading a different-sized file is impossible.\n    // When fileSize is not declared: falls back to [1, maxFileSize ?? 5 GiB].\n    const maxBytes = config.maxFileSize ?? MAX_UPLOAD_SIZE;\n    const rangeMin = fileSize ?? 1;\n    const rangeMax = fileSize ?? maxBytes;\n\n    const { url, fields: signedFields } = await createPresignedPost(config.s3, {\n      Bucket: bucket,\n      Key: key,\n      Conditions: [[\"content-length-range\", rangeMin, rangeMax]],\n      Fields: fields,\n      Expires: expiresIn,\n    });\n\n    await config.hooks?.upload?.onSuccess?.({\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      metadata: body.metadata,\n      acl,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, fields: signedFields, expiresIn });\n  });\n}\n","import { HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n};\n\nexport function createConfirmHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n\n    const context = {\n      request,\n      key,\n      bucket,\n      contentType: head.ContentType,\n      contentLength: head.ContentLength ?? 0,\n      eTag: head.ETag?.replace(/\"/g, \"\"),\n      metadata: head.Metadata,\n    };\n\n    await config.hooks?.upload?.onComplete?.(context);\n\n    return Response.json({\n      key,\n      bucket,\n      contentType: context.contentType,\n      contentLength: context.contentLength,\n      eTag: context.eTag,\n    });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, runHook, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const guardResult = await runHook(config.hooks?.download?.guard, {\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n    });\n    if (guardResult) return guardResult;\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ...(fileName\n          ? { ResponseContentDisposition: `attachment; filename=\"${fileName}\"` }\n          : {}),\n      }),\n      { expiresIn },\n    );\n\n    await config.hooks?.download?.onSuccess?.({\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { runHook, withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.delete?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    await config.hooks?.delete?.onSuccess?.({ request, key, bucket });\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  /** Declared total byte size of the file being uploaded. */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : undefined;\n\n    // enforce the limit at init time (before the multipart upload is created).\n    if (config.maxFileSize && fileSize === undefined) {\n      return Response.json(\n        { message: \"fileSize is required when maxFileSize is configured\" },\n        { status: 400 },\n      );\n    }\n\n    // Reject immediately if the declared size already exceeds the server limit.\n    if (\n      fileSize !== undefined &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n      fileSize,\n    });\n    if (guardResult) return guardResult;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        ContentDisposition: body.fileName\n          ? buildContentDisposition(body.fileName)\n          : undefined,\n        Metadata: body.metadata,\n        ACL: acl,\n      }),\n    );\n\n    await config.hooks?.multipart?.onInit?.({\n      request,\n      key,\n      bucket,\n      uploadId: UploadId!,\n      contentType: body.contentType,\n      fileSize,\n      metadata: body.metadata,\n      acl,\n    });\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand, HeadObjectCommand, DeleteObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    // Verify the actual uploaded object metadata via HeadObject.\n    // This is the server's only opportunity to enforce maxFileSize for\n    // multipart uploads, since individual parts bypass size checks.\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n    const contentLength = head.ContentLength ?? 0;\n    const contentType = head.ContentType;\n    const eTag = head.ETag?.replace(/\"/g, \"\");\n\n    if (config.maxFileSize && contentLength > config.maxFileSize) {\n      // Delete the object and reject the request. The client has uploaded\n      // more data than the server policy allows.\n      await config.s3\n        .send(new DeleteObjectCommand({ Bucket: bucket, Key: key }))\n        .catch(() => {});\n      return Response.json(\n        {\n          message: `File size (${contentLength} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 422 },\n      );\n    }\n\n    await config.hooks?.multipart?.onComplete?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n      contentLength,\n      contentType,\n      eTag,\n    });\n\n    return Response.json({ bucket, key, uploadId, contentLength, contentType, eTag });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    await config.hooks?.multipart?.onAbort?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n    });\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createConfirmHandler } from \"./handlers/presign/confirm\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      confirm: createConfirmHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\nimport { runHook } from \"./helpers\";\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n\n  return async (request: Request): Promise<Response> => {\n    // Global guard — runs before every request\n    const guardResult = await runHook(config.hooks?.guard, { request });\n    if (guardResult) return guardResult;\n\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return handlers.presign.upload(request);\n    if (method === \"POST\" && subpath === \"presign/upload/confirm\")\n      return handlers.presign.confirm(request);\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return handlers.presign.download(request);\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return handlers.delete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return handlers.multipart.init(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return handlers.multipart.part(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return handlers.multipart.complete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return handlers.multipart.abort(request);\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n","import { createRouter } from \"../router\";\nimport type { S3RouteHandlerConfig } from \"../types\";\n\n/**\n * Creates a Next.js App Router catch-all route handler.\n *\n * Usage in `app/api/s3/[...s3]/route.ts`:\n * ```ts\n * import { createRouteHandler } from \"@better-s3/server/next\";\n *\n * const handler = createRouteHandler({ s3, defaultBucket: \"my-bucket\", basePath: \"/api/s3\" });\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function createRouteHandler(config: S3RouteHandlerConfig) {\n  return createRouter(config);\n}\n"]}
+{"version":3,"sources":["../../src/helpers.ts","../../src/handlers/presign/upload.ts","../../src/handlers/presign/confirm.ts","../../src/handlers/presign/download.ts","../../src/handlers/delete.ts","../../src/handlers/multipart/init.ts","../../src/handlers/multipart/part.ts","../../src/handlers/multipart/complete.ts","../../src/handlers/multipart/abort.ts","../../src/create-handlers.ts","../../src/router.ts","../../src/adapters/next.ts"],"names":["buildContentDisposition","fileName","ascii","encoded","parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","n","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","MAX_UPLOAD_SIZE","createUploadHandler","config","key","bucket","expiresIn","acl","contentType","fileSize","guardResult","fields","k","v","rangeMin","rangeMax","url","signedFields","createPresignedPost","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","getSignedUrl","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","CompleteMultipartUploadCommand","contentLength","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","disabled","createRouter","handlers","base","features","subpath","method","createRouteHandler"],"mappings":"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","file":"next.js","sourcesContent":["/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n *\n * @example\n * buildContentDisposition(\"résumé finale.pdf\")\n * // → 'attachment; filename=\"resume finale.pdf\"; filename*=UTF-8\\'\\'r%C3%A9sum%C3%A9%20finale.pdf'\n */\nexport function buildContentDisposition(fileName: string): string {\n  const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n  const encoded = encodeURIComponent(fileName);\n  return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n\nexport async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n\n/**\n * Run a server hook. Returns a Response if the hook rejects (throws),\n * or `null` if the hook passes (or is undefined).\n */\nexport async function runHook<T>(\n  hook: ((context: T) => Promise<void> | void) | undefined,\n  context: T,\n): Promise<Response | null> {\n  if (!hook) return null;\n  try {\n    await hook(context);\n    return null;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : \"Forbidden\";\n    const status =\n      typeof (err as Record<string, unknown>)?.status === \"number\"\n        ? ((err as Record<string, unknown>).status as number)\n        : 403;\n    return Response.json({ message }, { status });\n  }\n}\n","import { createPresignedPost } from \"@aws-sdk/s3-presigned-post\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\n// 5 GiB — S3 single-object upload limit\nconst MAX_UPLOAD_SIZE = 5 * 1024 * 1024 * 1024;\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  /**\n   * Exact byte size of the file the client intends to upload.\n   * When provided the presigned POST policy locks `content-length-range` to\n   * `[fileSize, fileSize]`, so S3 rejects any upload that is not exactly this\n   * size — even if the client tampers with the payload.\n   * When omitted the range is `[1, maxFileSize ?? 5 GiB]`.\n   */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const contentType = body.contentType?.trim() || \"application/octet-stream\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : null;\n\n    if (\n      fileSize !== null &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      fileSize: fileSize ?? undefined,\n      metadata: body.metadata,\n      acl,\n    });\n    if (guardResult) return guardResult;\n\n    // Build presigned POST fields. Fields are embedded in the signed policy\n    // so the client cannot change them without invalidating the signature.\n    const fields: Record<string, string> = { acl, \"Content-Type\": contentType };\n\n    if (body.fileName) {\n      fields[\"Content-Disposition\"] = buildContentDisposition(body.fileName);\n    }\n\n    if (body.metadata) {\n      for (const [k, v] of Object.entries(body.metadata)) {\n        fields[`x-amz-meta-${k}`] = v;\n      }\n    }\n\n    // `content-length-range` is enforced by S3 at the storage layer —\n    // uploads outside this range are rejected before the object is stored.\n    //\n    // When the client declares fileSize: S3 locks the range to exactly that\n    // number of bytes, so uploading a different-sized file is impossible.\n    // When fileSize is not declared: falls back to [1, maxFileSize ?? 5 GiB].\n    const rangeMin = fileSize ?? 1;\n    const rangeMax = fileSize ?? config.maxFileSize ?? MAX_UPLOAD_SIZE;\n\n    const { url, fields: signedFields } = await createPresignedPost(config.s3, {\n      Bucket: bucket,\n      Key: key,\n      Conditions: [[\"content-length-range\", rangeMin, rangeMax]],\n      Fields: fields,\n      Expires: expiresIn,\n    });\n\n    await config.hooks?.upload?.onPresigned?.({\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      metadata: body.metadata,\n      acl,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, fields: signedFields, expiresIn });\n  });\n}\n","import { HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n};\n\nexport function createConfirmHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n\n    const context = {\n      request,\n      key,\n      bucket,\n      contentType: head.ContentType,\n      contentLength: head.ContentLength ?? 0,\n      eTag: head.ETag?.replace(/\"/g, \"\"),\n      metadata: head.Metadata,\n    };\n\n    await config.hooks?.upload?.onUploaded?.(context);\n\n    return Response.json({\n      key,\n      bucket,\n      contentType: context.contentType,\n      contentLength: context.contentLength,\n      eTag: context.eTag,\n    });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, runHook, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const guardResult = await runHook(config.hooks?.download?.guard, {\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n    });\n    if (guardResult) return guardResult;\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ...(fileName\n          ? { ResponseContentDisposition: `attachment; filename=\"${fileName}\"` }\n          : {}),\n      }),\n      { expiresIn },\n    );\n\n    await config.hooks?.download?.onPresigned?.({\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { runHook, withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.delete?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    await config.hooks?.delete?.onDeleted?.({ request, key, bucket });\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  /** Declared total byte size of the file being uploaded. */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : undefined;\n\n    if (\n      fileSize !== undefined &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n      fileSize,\n    });\n    if (guardResult) return guardResult;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        ContentDisposition: body.fileName\n          ? buildContentDisposition(body.fileName)\n          : undefined,\n        Metadata: body.metadata,\n        ACL: acl,\n      }),\n    );\n\n    await config.hooks?.multipart?.onInit?.({\n      request,\n      key,\n      bucket,\n      uploadId: UploadId!,\n      contentType: body.contentType,\n      fileSize,\n      metadata: body.metadata,\n      acl,\n    });\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand, HeadObjectCommand, DeleteObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    // Verify the actual uploaded object metadata via HeadObject.\n    // This is the server's only opportunity to enforce maxFileSize for\n    // multipart uploads, since individual parts bypass size checks.\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n    const contentLength = head.ContentLength ?? 0;\n    const contentType = head.ContentType;\n    const eTag = head.ETag?.replace(/\"/g, \"\");\n\n    if (config.maxFileSize && contentLength > config.maxFileSize) {\n      // Delete the object and reject the request. The client has uploaded\n      // more data than the server policy allows.\n      await config.s3\n        .send(new DeleteObjectCommand({ Bucket: bucket, Key: key }))\n        .catch(() => {});\n      return Response.json(\n        {\n          message: `File size (${contentLength} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 422 },\n      );\n    }\n\n    await config.hooks?.multipart?.onComplete?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n      contentLength,\n      contentType,\n      eTag,\n    });\n\n    return Response.json({ bucket, key, uploadId, contentLength, contentType, eTag });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    await config.hooks?.multipart?.onAbort?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n    });\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createConfirmHandler } from \"./handlers/presign/confirm\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      confirm: createConfirmHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\nimport { runHook } from \"./helpers\";\n\nconst disabled = () => Response.json({ message: \"Not Found\" }, { status: 404 });\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n  const { features } = config;\n\n  return async (request: Request): Promise<Response> => {\n    // Global guard — runs before every request\n    const guardResult = await runHook(config.hooks?.guard, { request });\n    if (guardResult) return guardResult;\n\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return features.upload ? handlers.presign.upload(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/upload/confirm\")\n      return features.upload ? handlers.presign.confirm(request) : disabled();\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return features.download\n        ? handlers.presign.download(request)\n        : disabled();\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return features.delete ? handlers.delete(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return features.multipart ? handlers.multipart.init(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return features.multipart ? handlers.multipart.part(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return features.multipart\n        ? handlers.multipart.complete(request)\n        : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return features.multipart\n        ? handlers.multipart.abort(request)\n        : disabled();\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n","import { createRouter } from \"../router\";\nimport type { S3RouteHandlerConfig } from \"../types\";\n\n/**\n * Creates a Next.js App Router catch-all route handler.\n *\n * Usage in `app/api/s3/[...s3]/route.ts`:\n * ```ts\n * import { createRouteHandler } from \"@better-s3/server/next\";\n *\n * const handler = createRouteHandler({ s3, defaultBucket: \"my-bucket\", basePath: \"/api/s3\" });\n * export { handler as GET, handler as POST, handler as DELETE };\n * ```\n */\nexport function createRouteHandler(config: S3RouteHandlerConfig) {\n  return createRouter(config);\n}\n"]}

package/dist/index.js

@@ -1,3 +1,3 @@
-import {createPresignedPost}from'@aws-sdk/s3-presigned-post';import {HeadObjectCommand,GetObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';function S(e){let n=e.replace(/[^\x20-\x7E]/g,"_").replace(/["\\]/g,"_"),r=encodeURIComponent(e);return `attachment; filename="${n}"; filename*=UTF-8''${r}`}async function m(e){try{let n=await e.json();return n&&typeof n=="object"?n:null}catch{return null}}function d(e,n){let r=typeof e=="string"?e.trim():"";return r||Response.json({message:`${n} is required`},{status:400})}function y(e){let n=Number(e);return Number.isFinite(n)&&n>0?Math.floor(n):600}function l(e){return async n=>{try{return await e(n)}catch(r){let t=r instanceof Error?r.message:"Internal server error";return console.error("[S3 API]",t),Response.json({message:t},{status:500})}}}async function u(e,n){if(!e)return null;try{return await e(n),null}catch(r){let t=r instanceof Error?r.message:"Forbidden",o=typeof r?.status=="number"?r.status:403;return Response.json({message:t},{status:o})}}var B=5*1024*1024*1024;function R(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=r.bucket?.trim()||e.defaultBucket,s=y(r.expiresIn),a=r.acl==="public-read"?"public-read":"private",i=r.contentType?.trim()||"application/octet-stream",p=typeof r.fileSize=="number"&&r.fileSize>0?Math.floor(r.fileSize):null;if(p!==null&&e.maxFileSize&&p>e.maxFileSize)return Response.json({message:`File size (${p} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let c=await u(e.hooks?.upload?.guard,{request:n,key:t,bucket:o,contentType:r.contentType,fileSize:p??void 0,metadata:r.metadata,acl:a});if(c)return c;let f={acl:a,"Content-Type":i};if(r.fileName&&(f["Content-Disposition"]=S(r.fileName)),r.metadata)for(let[M,E]of Object.entries(r.metadata))f[`x-amz-meta-${M}`]=E;let b=e.maxFileSize??B,g=p??1,k=p??b,{url:z,fields:j}=await createPresignedPost(e.s3,{Bucket:o,Key:t,Conditions:[["content-length-range",g,k]],Fields:f,Expires:s});return await e.hooks?.upload?.onSuccess?.({request:n,key:t,bucket:o,contentType:r.contentType,metadata:r.metadata,acl:a,url:z,expiresIn:s}),Response.json({bucket:o,key:t,url:z,fields:j,expiresIn:s})})}function x(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=r.bucket?.trim()||e.defaultBucket,s=await u(e.hooks?.upload?.guard,{request:n,key:t,bucket:o});if(s)return s;let a=await e.s3.send(new HeadObjectCommand({Bucket:o,Key:t})),i={request:n,key:t,bucket:o,contentType:a.ContentType,contentLength:a.ContentLength??0,eTag:a.ETag?.replace(/"/g,""),metadata:a.Metadata};return await e.hooks?.upload?.onComplete?.(i),Response.json({key:t,bucket:o,contentType:i.contentType,contentLength:i.contentLength,eTag:i.eTag})})}function w(e){return l(async n=>{let{searchParams:r}=new URL(n.url),t=r.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=r.get("bucket")?.trim()||e.defaultBucket,s=y(r.get("expiresIn")),a=r.get("fileName")?.trim(),i=await u(e.hooks?.download?.guard,{request:n,key:t,bucket:o,fileName:a||void 0});if(i)return i;let p=await getSignedUrl(e.s3,new GetObjectCommand({Bucket:o,Key:t,...a?{ResponseContentDisposition:`attachment; filename="${a}"`}:{}}),{expiresIn:s});return await e.hooks?.download?.onSuccess?.({request:n,key:t,bucket:o,fileName:a||void 0,url:p,expiresIn:s}),Response.json({bucket:o,key:t,url:p,expiresIn:s})})}function H(e){return l(async n=>{let{searchParams:r}=new URL(n.url),t=r.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let o=r.get("bucket")?.trim()||e.defaultBucket,s=await u(e.hooks?.delete?.guard,{request:n,key:t,bucket:o});if(s)return s;try{await e.s3.send(new HeadObjectCommand({Bucket:o,Key:t}));}catch{return Response.json({message:`Object "${t}" not found`},{status:404})}return await e.s3.send(new DeleteObjectCommand({Bucket:o,Key:t})),await e.hooks?.delete?.onSuccess?.({request:n,key:t,bucket:o}),Response.json({success:!0,bucket:o,key:t})})}function C(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=r.bucket?.trim()||e.defaultBucket,s=r.acl==="public-read"?"public-read":"private",a=typeof r.fileSize=="number"&&r.fileSize>0?Math.floor(r.fileSize):void 0;if(e.maxFileSize&&a===void 0)return Response.json({message:"fileSize is required when maxFileSize is configured"},{status:400});if(a!==void 0&&e.maxFileSize&&a>e.maxFileSize)return Response.json({message:`File size (${a} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let i=await u(e.hooks?.multipart?.guard,{request:n,key:t,bucket:o,fileSize:a});if(i)return i;let{UploadId:p}=await e.s3.send(new CreateMultipartUploadCommand({Bucket:o,Key:t,ContentType:r.contentType,ContentDisposition:r.fileName?S(r.fileName):void 0,Metadata:r.metadata,ACL:s}));return await e.hooks?.multipart?.onInit?.({request:n,key:t,bucket:o,uploadId:p,contentType:r.contentType,fileSize:a,metadata:r.metadata,acl:s}),Response.json({bucket:o,key:t,uploadId:p},{status:201})})}function P(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=d(r.uploadId,"uploadId");if(o instanceof Response)return o;let s=Number(r.partNumber);if(!Number.isInteger(s)||s<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let a=r.bucket?.trim()||e.defaultBucket,i=y(r.expiresIn),p=await u(e.hooks?.multipart?.guard,{request:n,key:t,bucket:a});if(p)return p;let c=await getSignedUrl(e.s3,new UploadPartCommand({Bucket:a,Key:t,UploadId:o,PartNumber:s}),{expiresIn:i});return Response.json({presignedUrl:c,partNumber:s,uploadId:o,bucket:a,expiresIn:i})})}function h(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=d(r.uploadId,"uploadId");if(o instanceof Response)return o;let s=(Array.isArray(r.parts)?r.parts:[]).map(({partNumber:g,eTag:k})=>({PartNumber:Number(g),ETag:String(k)})).filter(g=>Number.isInteger(g.PartNumber)&&g.ETag).sort((g,k)=>g.PartNumber-k.PartNumber);if(!s.length)return Response.json({message:"At least one valid part is required"},{status:400});let a=r.bucket?.trim()||e.defaultBucket,i=await u(e.hooks?.multipart?.guard,{request:n,key:t,bucket:a});if(i)return i;await e.s3.send(new CompleteMultipartUploadCommand({Bucket:a,Key:t,UploadId:o,MultipartUpload:{Parts:s}}));let p=await e.s3.send(new HeadObjectCommand({Bucket:a,Key:t})),c=p.ContentLength??0,f=p.ContentType,b=p.ETag?.replace(/"/g,"");return e.maxFileSize&&c>e.maxFileSize?(await e.s3.send(new DeleteObjectCommand({Bucket:a,Key:t})).catch(()=>{}),Response.json({message:`File size (${c} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:422})):(await e.hooks?.multipart?.onComplete?.({request:n,key:t,bucket:a,uploadId:o,contentLength:c,contentType:f,eTag:b}),Response.json({bucket:a,key:t,uploadId:o,contentLength:c,contentType:f,eTag:b}))})}function I(e){return l(async n=>{let r=await m(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let o=d(r.uploadId,"uploadId");if(o instanceof Response)return o;let s=r.bucket?.trim()||e.defaultBucket,a=await u(e.hooks?.multipart?.guard,{request:n,key:t,bucket:s});return a||(await e.s3.send(new AbortMultipartUploadCommand({Bucket:s,Key:t,UploadId:o})),await e.hooks?.multipart?.onAbort?.({request:n,key:t,bucket:s,uploadId:o}),Response.json({bucket:s,key:t,uploadId:o,aborted:!0}))})}function T(e){return {presign:{upload:R(e),confirm:x(e),download:w(e)},multipart:{init:C(e),part:P(e),complete:h(e),abort:I(e)},delete:H(e)}}function G(e){let n=T(e),r=e.basePath.replace(/\/$/,"");return async t=>{let o=await u(e.hooks?.guard,{request:t});if(o)return o;let a=new URL(t.url).pathname.slice(r.length).replace(/^\//,""),i=t.method;return i==="POST"&&a==="presign/upload"?n.presign.upload(t):i==="POST"&&a==="presign/upload/confirm"?n.presign.confirm(t):i==="GET"&&a==="presign/download"?n.presign.download(t):i==="DELETE"&&a==="delete"?n.delete(t):i==="POST"&&a==="presign/multipart/init"?n.multipart.init(t):i==="POST"&&a==="presign/multipart/part"?n.multipart.part(t):i==="POST"&&a==="presign/multipart/complete"?n.multipart.complete(t):i==="POST"&&a==="presign/multipart/abort"?n.multipart.abort(t):Response.json({message:"Not Found"},{status:404})}}function N(e="/api/s3"){let n=e.replace(/\/$/,""),r=async(o,s)=>{let a=await fetch(o,s);if(!a.ok){let i=await a.json().catch(()=>({}));throw new Error(i.message??a.statusText)}return a.json()},t=(o,s)=>r(o,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});return {upload(o){return t(`${n}/presign/upload`,o)},confirm(o){return t(`${n}/presign/upload/confirm`,o)},download(o,s){let a=new URLSearchParams({key:o});if(s?.fileName){let i=s.fileName.replace(/["\\\r\n]/g,"_");a.set("fileName",i);}return s?.bucket&&a.set("bucket",s.bucket),r(`${n}/presign/download?${a}`)},delete(o,s){let a=new URLSearchParams({key:o});return s?.bucket&&a.set("bucket",s.bucket),r(`${n}/delete?${a}`,{method:"DELETE"})},multipart:{init(o){return t(`${n}/presign/multipart/init`,o)},signPart(o){return t(`${n}/presign/multipart/part`,o)},complete(o){return t(`${n}/presign/multipart/complete`,o)},abort(o){return t(`${n}/presign/multipart/abort`,o)}}}}function X(e,n){if(n.accept?.length&&!n.accept.some(t=>t.startsWith(".")?e.name.toLowerCase().endsWith(t.toLowerCase()):t.endsWith("/*")?e.type.startsWith(t.replace("/*","/")):e.type===t)){let t=e.name.includes(".")?e.name.split(".").pop():null;return `File type "${t?`.${t}`:e.type||"unknown"}" is not allowed`}return e.size===0?"File is empty":n.maxFileSize&&e.size>n.maxFileSize?`File size exceeds ${(n.maxFileSize/1048576).toFixed(1)} MB limit`:null}
-export{x as createConfirmHandler,H as createDeleteHandler,w as createDownloadHandler,T as createHandlers,I as createMultipartAbortHandler,h as createMultipartCompleteHandler,C as createMultipartInitHandler,P as createMultipartPartHandler,N as createPresignApi,G as createRouter,N as createS3Api,R as createUploadHandler,y as normalizeExpiresIn,m as parseBody,d as requireString,u as runHook,X as validateFile,l as withS3ErrorHandler};//# sourceMappingURL=index.js.map
+import {createPresignedPost}from'@aws-sdk/s3-presigned-post';import {HeadObjectCommand,GetObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';function R(e){let a=e.replace(/[^\x20-\x7E]/g,"_").replace(/["\\]/g,"_"),r=encodeURIComponent(e);return `attachment; filename="${a}"; filename*=UTF-8''${r}`}async function m(e){try{let a=await e.json();return a&&typeof a=="object"?a:null}catch{return null}}function d(e,a){let r=typeof e=="string"?e.trim():"";return r||Response.json({message:`${a} is required`},{status:400})}function f(e){let a=Number(e);return Number.isFinite(a)&&a>0?Math.floor(a):600}function l(e){return async a=>{try{return await e(a)}catch(r){let t=r instanceof Error?r.message:"Internal server error";return console.error("[S3 API]",t),Response.json({message:t},{status:500})}}}async function u(e,a){if(!e)return null;try{return await e(a),null}catch(r){let t=r instanceof Error?r.message:"Forbidden",n=typeof r?.status=="number"?r.status:403;return Response.json({message:t},{status:n})}}var F=5*1024*1024*1024;function x(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=r.bucket?.trim()||e.defaultBucket,s=f(r.expiresIn),o=r.acl==="public-read"?"public-read":"private",i=r.contentType?.trim()||"application/octet-stream",p=typeof r.fileSize=="number"&&r.fileSize>0?Math.floor(r.fileSize):null;if(p!==null&&e.maxFileSize&&p>e.maxFileSize)return Response.json({message:`File size (${p} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let c=await u(e.hooks?.upload?.guard,{request:a,key:t,bucket:n,contentType:r.contentType,fileSize:p??void 0,metadata:r.metadata,acl:o});if(c)return c;let k={acl:o,"Content-Type":i};if(r.fileName&&(k["Content-Disposition"]=R(r.fileName)),r.metadata)for(let[M,E]of Object.entries(r.metadata))k[`x-amz-meta-${M}`]=E;let S=p??1,g=p??e.maxFileSize??F,{url:b,fields:j}=await createPresignedPost(e.s3,{Bucket:n,Key:t,Conditions:[["content-length-range",S,g]],Fields:k,Expires:s});return await e.hooks?.upload?.onPresigned?.({request:a,key:t,bucket:n,contentType:r.contentType,metadata:r.metadata,acl:o,url:b,expiresIn:s}),Response.json({bucket:n,key:t,url:b,fields:j,expiresIn:s})})}function w(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=r.bucket?.trim()||e.defaultBucket,s=await u(e.hooks?.upload?.guard,{request:a,key:t,bucket:n});if(s)return s;let o=await e.s3.send(new HeadObjectCommand({Bucket:n,Key:t})),i={request:a,key:t,bucket:n,contentType:o.ContentType,contentLength:o.ContentLength??0,eTag:o.ETag?.replace(/"/g,""),metadata:o.Metadata};return await e.hooks?.upload?.onUploaded?.(i),Response.json({key:t,bucket:n,contentType:i.contentType,contentLength:i.contentLength,eTag:i.eTag})})}function H(e){return l(async a=>{let{searchParams:r}=new URL(a.url),t=r.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let n=r.get("bucket")?.trim()||e.defaultBucket,s=f(r.get("expiresIn")),o=r.get("fileName")?.trim(),i=await u(e.hooks?.download?.guard,{request:a,key:t,bucket:n,fileName:o||void 0});if(i)return i;let p=await getSignedUrl(e.s3,new GetObjectCommand({Bucket:n,Key:t,...o?{ResponseContentDisposition:`attachment; filename="${o}"`}:{}}),{expiresIn:s});return await e.hooks?.download?.onPresigned?.({request:a,key:t,bucket:n,fileName:o||void 0,url:p,expiresIn:s}),Response.json({bucket:n,key:t,url:p,expiresIn:s})})}function P(e){return l(async a=>{let{searchParams:r}=new URL(a.url),t=r.get("key")?.trim();if(!t)return Response.json({message:"key query parameter is required"},{status:400});let n=r.get("bucket")?.trim()||e.defaultBucket,s=await u(e.hooks?.delete?.guard,{request:a,key:t,bucket:n});if(s)return s;try{await e.s3.send(new HeadObjectCommand({Bucket:n,Key:t}));}catch{return Response.json({message:`Object "${t}" not found`},{status:404})}return await e.s3.send(new DeleteObjectCommand({Bucket:n,Key:t})),await e.hooks?.delete?.onDeleted?.({request:a,key:t,bucket:n}),Response.json({success:!0,bucket:n,key:t})})}function C(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=r.bucket?.trim()||e.defaultBucket,s=r.acl==="public-read"?"public-read":"private",o=typeof r.fileSize=="number"&&r.fileSize>0?Math.floor(r.fileSize):void 0;if(o!==void 0&&e.maxFileSize&&o>e.maxFileSize)return Response.json({message:`File size (${o} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:413});let i=await u(e.hooks?.multipart?.guard,{request:a,key:t,bucket:n,fileSize:o});if(i)return i;let{UploadId:p}=await e.s3.send(new CreateMultipartUploadCommand({Bucket:n,Key:t,ContentType:r.contentType,ContentDisposition:r.fileName?R(r.fileName):void 0,Metadata:r.metadata,ACL:s}));return await e.hooks?.multipart?.onInit?.({request:a,key:t,bucket:n,uploadId:p,contentType:r.contentType,fileSize:o,metadata:r.metadata,acl:s}),Response.json({bucket:n,key:t,uploadId:p},{status:201})})}function h(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=d(r.uploadId,"uploadId");if(n instanceof Response)return n;let s=Number(r.partNumber);if(!Number.isInteger(s)||s<=0)return Response.json({message:"partNumber must be a positive integer"},{status:400});let o=r.bucket?.trim()||e.defaultBucket,i=f(r.expiresIn),p=await u(e.hooks?.multipart?.guard,{request:a,key:t,bucket:o});if(p)return p;let c=await getSignedUrl(e.s3,new UploadPartCommand({Bucket:o,Key:t,UploadId:n,PartNumber:s}),{expiresIn:i});return Response.json({presignedUrl:c,partNumber:s,uploadId:n,bucket:o,expiresIn:i})})}function I(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=d(r.uploadId,"uploadId");if(n instanceof Response)return n;let s=(Array.isArray(r.parts)?r.parts:[]).map(({partNumber:g,eTag:b})=>({PartNumber:Number(g),ETag:String(b)})).filter(g=>Number.isInteger(g.PartNumber)&&g.ETag).sort((g,b)=>g.PartNumber-b.PartNumber);if(!s.length)return Response.json({message:"At least one valid part is required"},{status:400});let o=r.bucket?.trim()||e.defaultBucket,i=await u(e.hooks?.multipart?.guard,{request:a,key:t,bucket:o});if(i)return i;await e.s3.send(new CompleteMultipartUploadCommand({Bucket:o,Key:t,UploadId:n,MultipartUpload:{Parts:s}}));let p=await e.s3.send(new HeadObjectCommand({Bucket:o,Key:t})),c=p.ContentLength??0,k=p.ContentType,S=p.ETag?.replace(/"/g,"");return e.maxFileSize&&c>e.maxFileSize?(await e.s3.send(new DeleteObjectCommand({Bucket:o,Key:t})).catch(()=>{}),Response.json({message:`File size (${c} bytes) exceeds the maximum allowed size of ${e.maxFileSize} bytes`},{status:422})):(await e.hooks?.multipart?.onComplete?.({request:a,key:t,bucket:o,uploadId:n,contentLength:c,contentType:k,eTag:S}),Response.json({bucket:o,key:t,uploadId:n,contentLength:c,contentType:k,eTag:S}))})}function T(e){return l(async a=>{let r=await m(a);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let t=d(r.key,"key");if(t instanceof Response)return t;let n=d(r.uploadId,"uploadId");if(n instanceof Response)return n;let s=r.bucket?.trim()||e.defaultBucket,o=await u(e.hooks?.multipart?.guard,{request:a,key:t,bucket:s});return o||(await e.s3.send(new AbortMultipartUploadCommand({Bucket:s,Key:t,UploadId:n})),await e.hooks?.multipart?.onAbort?.({request:a,key:t,bucket:s,uploadId:n}),Response.json({bucket:s,key:t,uploadId:n,aborted:!0}))})}function N(e){return {presign:{upload:x(e),confirm:w(e),download:H(e)},multipart:{init:C(e),part:h(e),complete:I(e),abort:T(e)},delete:P(e)}}var y=()=>Response.json({message:"Not Found"},{status:404});function G(e){let a=N(e),r=e.basePath.replace(/\/$/,""),{features:t}=e;return async n=>{let s=await u(e.hooks?.guard,{request:n});if(s)return s;let i=new URL(n.url).pathname.slice(r.length).replace(/^\//,""),p=n.method;return p==="POST"&&i==="presign/upload"?t.upload?a.presign.upload(n):y():p==="POST"&&i==="presign/upload/confirm"?t.upload?a.presign.confirm(n):y():p==="GET"&&i==="presign/download"?t.download?a.presign.download(n):y():p==="DELETE"&&i==="delete"?t.delete?a.delete(n):y():p==="POST"&&i==="presign/multipart/init"?t.multipart?a.multipart.init(n):y():p==="POST"&&i==="presign/multipart/part"?t.multipart?a.multipart.part(n):y():p==="POST"&&i==="presign/multipart/complete"?t.multipart?a.multipart.complete(n):y():p==="POST"&&i==="presign/multipart/abort"?t.multipart?a.multipart.abort(n):y():Response.json({message:"Not Found"},{status:404})}}function z(e="/api/s3"){let a=e.replace(/\/$/,""),r=async(n,s)=>{let o=await fetch(n,s);if(!o.ok){let i=await o.json().catch(()=>({}));throw new Error(i.message??o.statusText)}return o.json()},t=(n,s)=>r(n,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});return {upload(n){return t(`${a}/presign/upload`,n)},confirm(n){return t(`${a}/presign/upload/confirm`,n)},download(n,s){let o=new URLSearchParams({key:n});if(s?.fileName){let i=s.fileName.replace(/["\\\r\n]/g,"_");o.set("fileName",i);}return s?.bucket&&o.set("bucket",s.bucket),r(`${a}/presign/download?${o}`)},delete(n,s){let o=new URLSearchParams({key:n});return s?.bucket&&o.set("bucket",s.bucket),r(`${a}/delete?${o}`,{method:"DELETE"})},multipart:{init(n){return t(`${a}/presign/multipart/init`,n)},signPart(n){return t(`${a}/presign/multipart/part`,n)},complete(n){return t(`${a}/presign/multipart/complete`,n)},abort(n){return t(`${a}/presign/multipart/abort`,n)}}}}function X(e,a){if(a.accept?.length&&!a.accept.some(t=>t.startsWith(".")?e.name.toLowerCase().endsWith(t.toLowerCase()):t.endsWith("/*")?e.type.startsWith(t.replace("/*","/")):e.type===t)){let t=e.name.includes(".")?e.name.split(".").pop():null;return `File type "${t?`.${t}`:e.type||"unknown"}" is not allowed`}return e.size===0?"File is empty":a.maxFileSize&&e.size>a.maxFileSize?`File size exceeds ${(a.maxFileSize/1048576).toFixed(1)} MB limit`:null}
+export{w as createConfirmHandler,P as createDeleteHandler,H as createDownloadHandler,N as createHandlers,T as createMultipartAbortHandler,I as createMultipartCompleteHandler,C as createMultipartInitHandler,h as createMultipartPartHandler,z as createPresignApi,G as createRouter,z as createS3Api,x as createUploadHandler,f as normalizeExpiresIn,m as parseBody,d as requireString,u as runHook,X as validateFile,l as withS3ErrorHandler};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/helpers.ts","../src/handlers/presign/upload.ts","../src/handlers/presign/confirm.ts","../src/handlers/presign/download.ts","../src/handlers/delete.ts","../src/handlers/multipart/init.ts","../src/handlers/multipart/part.ts","../src/handlers/multipart/complete.ts","../src/handlers/multipart/abort.ts","../src/create-handlers.ts","../src/router.ts","../src/api.ts","../src/validate.ts"],"names":["buildContentDisposition","fileName","ascii","encoded","parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","MAX_UPLOAD_SIZE","createUploadHandler","config","key","bucket","expiresIn","acl","contentType","fileSize","guardResult","fields","k","v","maxBytes","rangeMin","rangeMax","url","signedFields","createPresignedPost","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","getSignedUrl","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","CompleteMultipartUploadCommand","contentLength","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","createRouter","handlers","base","subpath","method","createS3Api","basePath","json","init","res","post","payload","options","params","safe","validateFile","file","type","ext"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n *\n * @example\n * buildContentDisposition(\"résumé finale.pdf\")\n * // → 'attachment; filename=\"resume finale.pdf\"; filename*=UTF-8\\'\\'r%C3%A9sum%C3%A9%20finale.pdf'\n */\nexport function buildContentDisposition(fileName: string): string {\n  const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n  const encoded = encodeURIComponent(fileName);\n  return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n\nexport async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n\n/**\n * Run a server hook. Returns a Response if the hook rejects (throws),\n * or `null` if the hook passes (or is undefined).\n */\nexport async function runHook<T>(\n  hook: ((context: T) => Promise<void> | void) | undefined,\n  context: T,\n): Promise<Response | null> {\n  if (!hook) return null;\n  try {\n    await hook(context);\n    return null;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : \"Forbidden\";\n    const status =\n      typeof (err as Record<string, unknown>)?.status === \"number\"\n        ? ((err as Record<string, unknown>).status as number)\n        : 403;\n    return Response.json({ message }, { status });\n  }\n}\n","import { createPresignedPost } from \"@aws-sdk/s3-presigned-post\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\n// 5 GiB — S3 single-object size limit\nconst MAX_UPLOAD_SIZE = 5 * 1024 * 1024 * 1024;\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  /**\n   * Exact byte size of the file the client intends to upload.\n   * When provided the presigned POST policy locks `content-length-range` to\n   * `[fileSize, fileSize]`, so S3 rejects any upload that is not exactly this\n   * size — even if the client tampers with the payload.\n   * When omitted the range is `[1, maxFileSize ?? 5 GiB]`.\n   */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const contentType = body.contentType?.trim() || \"application/octet-stream\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : null;\n\n    // Reject immediately if the declared size already exceeds the server limit,\n    // before generating any presigned URL.\n    if (\n      fileSize !== null &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      fileSize: fileSize ?? undefined,\n      metadata: body.metadata,\n      acl,\n    });\n    if (guardResult) return guardResult;\n\n    // Build presigned POST fields. Fields are embedded in the signed policy\n    // so the client cannot change them without invalidating the signature.\n    const fields: Record<string, string> = { acl, \"Content-Type\": contentType };\n\n    if (body.fileName) {\n      fields[\"Content-Disposition\"] = buildContentDisposition(body.fileName);\n    }\n\n    if (body.metadata) {\n      for (const [k, v] of Object.entries(body.metadata)) {\n        fields[`x-amz-meta-${k}`] = v;\n      }\n    }\n\n    // `content-length-range` is enforced by S3 at the storage layer —\n    // uploads outside this range are rejected before the object is stored.\n    //\n    // When the client declares fileSize: S3 locks the range to exactly that\n    // number of bytes, so uploading a different-sized file is impossible.\n    // When fileSize is not declared: falls back to [1, maxFileSize ?? 5 GiB].\n    const maxBytes = config.maxFileSize ?? MAX_UPLOAD_SIZE;\n    const rangeMin = fileSize ?? 1;\n    const rangeMax = fileSize ?? maxBytes;\n\n    const { url, fields: signedFields } = await createPresignedPost(config.s3, {\n      Bucket: bucket,\n      Key: key,\n      Conditions: [[\"content-length-range\", rangeMin, rangeMax]],\n      Fields: fields,\n      Expires: expiresIn,\n    });\n\n    await config.hooks?.upload?.onSuccess?.({\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      metadata: body.metadata,\n      acl,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, fields: signedFields, expiresIn });\n  });\n}\n","import { HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n};\n\nexport function createConfirmHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n\n    const context = {\n      request,\n      key,\n      bucket,\n      contentType: head.ContentType,\n      contentLength: head.ContentLength ?? 0,\n      eTag: head.ETag?.replace(/\"/g, \"\"),\n      metadata: head.Metadata,\n    };\n\n    await config.hooks?.upload?.onComplete?.(context);\n\n    return Response.json({\n      key,\n      bucket,\n      contentType: context.contentType,\n      contentLength: context.contentLength,\n      eTag: context.eTag,\n    });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, runHook, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const guardResult = await runHook(config.hooks?.download?.guard, {\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n    });\n    if (guardResult) return guardResult;\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ...(fileName\n          ? { ResponseContentDisposition: `attachment; filename=\"${fileName}\"` }\n          : {}),\n      }),\n      { expiresIn },\n    );\n\n    await config.hooks?.download?.onSuccess?.({\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { runHook, withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.delete?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    await config.hooks?.delete?.onSuccess?.({ request, key, bucket });\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  /** Declared total byte size of the file being uploaded. */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : undefined;\n\n    // enforce the limit at init time (before the multipart upload is created).\n    if (config.maxFileSize && fileSize === undefined) {\n      return Response.json(\n        { message: \"fileSize is required when maxFileSize is configured\" },\n        { status: 400 },\n      );\n    }\n\n    // Reject immediately if the declared size already exceeds the server limit.\n    if (\n      fileSize !== undefined &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n      fileSize,\n    });\n    if (guardResult) return guardResult;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        ContentDisposition: body.fileName\n          ? buildContentDisposition(body.fileName)\n          : undefined,\n        Metadata: body.metadata,\n        ACL: acl,\n      }),\n    );\n\n    await config.hooks?.multipart?.onInit?.({\n      request,\n      key,\n      bucket,\n      uploadId: UploadId!,\n      contentType: body.contentType,\n      fileSize,\n      metadata: body.metadata,\n      acl,\n    });\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand, HeadObjectCommand, DeleteObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    // Verify the actual uploaded object metadata via HeadObject.\n    // This is the server's only opportunity to enforce maxFileSize for\n    // multipart uploads, since individual parts bypass size checks.\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n    const contentLength = head.ContentLength ?? 0;\n    const contentType = head.ContentType;\n    const eTag = head.ETag?.replace(/\"/g, \"\");\n\n    if (config.maxFileSize && contentLength > config.maxFileSize) {\n      // Delete the object and reject the request. The client has uploaded\n      // more data than the server policy allows.\n      await config.s3\n        .send(new DeleteObjectCommand({ Bucket: bucket, Key: key }))\n        .catch(() => {});\n      return Response.json(\n        {\n          message: `File size (${contentLength} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 422 },\n      );\n    }\n\n    await config.hooks?.multipart?.onComplete?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n      contentLength,\n      contentType,\n      eTag,\n    });\n\n    return Response.json({ bucket, key, uploadId, contentLength, contentType, eTag });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    await config.hooks?.multipart?.onAbort?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n    });\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createConfirmHandler } from \"./handlers/presign/confirm\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      confirm: createConfirmHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\nimport { runHook } from \"./helpers\";\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n\n  return async (request: Request): Promise<Response> => {\n    // Global guard — runs before every request\n    const guardResult = await runHook(config.hooks?.guard, { request });\n    if (guardResult) return guardResult;\n\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return handlers.presign.upload(request);\n    if (method === \"POST\" && subpath === \"presign/upload/confirm\")\n      return handlers.presign.confirm(request);\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return handlers.presign.download(request);\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return handlers.delete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return handlers.multipart.init(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return handlers.multipart.part(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return handlers.multipart.complete(request);\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return handlers.multipart.abort(request);\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n","export type PresignResponse = {\n  key: string;\n  bucket: string;\n  url: string;\n  expiresIn: number;\n};\n\nexport type PresignedPostResponse = {\n  key: string;\n  bucket: string;\n  url: string;\n  fields: Record<string, string>;\n  expiresIn: number;\n};\n\nexport type MultipartInitResponse = {\n  key: string;\n  bucket: string;\n  uploadId: string;\n};\n\nexport type MultipartPartResponse = {\n  presignedUrl: string;\n  partNumber: number;\n  uploadId: string;\n  bucket: string;\n  expiresIn: number;\n};\n\nexport type UploadConfirmResponse = {\n  key: string;\n  bucket: string;\n  contentType?: string;\n  contentLength: number;\n  eTag?: string;\n};\n\nexport type S3Api = {\n  upload: (payload: {\n    key: string;\n    contentType?: string;\n    /**\n     * Exact byte size of the file. When provided the presigned POST policy\n     * locks `content-length-range` to `[fileSize, fileSize]` so S3 rejects\n     * uploads of any other size at the storage layer.\n     */\n    fileSize?: number;\n    metadata?: Record<string, string>;\n    bucket?: string;\n    acl?: \"private\" | \"public-read\";\n    /** Original file name. Stored as `Content-Disposition` on the S3 object. */\n    fileName?: string;\n  }) => Promise<PresignedPostResponse>;\n  confirm: (payload: {\n    key: string;\n    bucket?: string;\n  }) => Promise<UploadConfirmResponse>;\n  download: (\n    key: string,\n    options?: { fileName?: string; bucket?: string },\n  ) => Promise<PresignResponse>;\n  delete: (\n    key: string,\n    options?: { bucket?: string },\n  ) => Promise<{ success: boolean; bucket: string; key: string }>;\n  multipart: {\n    init: (payload: {\n      key: string;\n      contentType?: string;\n      /** Declared total byte size of the file. Used for quota/guard checks and stored in `onInit` context. */\n      fileSize?: number;\n      metadata?: Record<string, string>;\n      bucket?: string;\n      acl?: \"private\" | \"public-read\";\n      /** Original file name. Stored as `Content-Disposition` on the S3 object. */\n      fileName?: string;\n    }) => Promise<MultipartInitResponse>;\n    signPart: (payload: {\n      key: string;\n      uploadId: string;\n      partNumber: number;\n      bucket?: string;\n    }) => Promise<MultipartPartResponse>;\n    complete: (payload: {\n      key: string;\n      uploadId: string;\n      parts: Array<{ partNumber: number; eTag: string }>;\n      bucket?: string;\n    }) => Promise<{\n      key: string;\n      bucket: string;\n      uploadId: string;\n      contentLength: number;\n      contentType?: string;\n      eTag?: string;\n    }>;\n    abort: (payload: {\n      key: string;\n      uploadId: string;\n      bucket?: string;\n    }) => Promise<{ aborted: boolean }>;\n  };\n};\n\nexport function createS3Api(basePath = \"/api/s3\"): S3Api {\n  const base = basePath.replace(/\\/$/, \"\");\n\n  const json = async <T>(url: string, init?: RequestInit): Promise<T> => {\n    const res = await fetch(url, init);\n    if (!res.ok) {\n      const body = await res.json().catch(() => ({}));\n      throw new Error((body as { message?: string }).message ?? res.statusText);\n    }\n    return res.json() as Promise<T>;\n  };\n\n  const post = <T>(url: string, body: unknown): Promise<T> =>\n    json<T>(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n\n  return {\n    upload(payload) {\n      return post<PresignedPostResponse>(`${base}/presign/upload`, payload);\n    },\n\n    confirm(payload) {\n      return post<UploadConfirmResponse>(\n        `${base}/presign/upload/confirm`,\n        payload,\n      );\n    },\n\n    download(key, options?) {\n      const params = new URLSearchParams({ key });\n      if (options?.fileName) {\n        const safe = options.fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n        params.set(\"fileName\", safe);\n      }\n      if (options?.bucket) params.set(\"bucket\", options.bucket);\n      return json<PresignResponse>(`${base}/presign/download?${params}`);\n    },\n\n    delete(key, options?) {\n      const params = new URLSearchParams({ key });\n      if (options?.bucket) params.set(\"bucket\", options.bucket);\n      return json<{ success: boolean; bucket: string; key: string }>(\n        `${base}/delete?${params}`,\n        { method: \"DELETE\" },\n      );\n    },\n\n    multipart: {\n      init(payload) {\n        return post<MultipartInitResponse>(\n          `${base}/presign/multipart/init`,\n          payload,\n        );\n      },\n\n      signPart(payload) {\n        return post<MultipartPartResponse>(\n          `${base}/presign/multipart/part`,\n          payload,\n        );\n      },\n\n      complete(payload) {\n        return post<{\n          key: string;\n          bucket: string;\n          uploadId: string;\n          contentLength: number;\n          contentType?: string;\n          eTag?: string;\n        }>(`${base}/presign/multipart/complete`, payload);\n      },\n\n      abort(payload) {\n        return post<{ aborted: boolean }>(\n          `${base}/presign/multipart/abort`,\n          payload,\n        );\n      },\n    },\n  };\n}\n","export function validateFile(\n  file: File,\n  options: { accept?: string[]; maxFileSize?: number },\n): string | null {\n  if (options.accept?.length) {\n    const allowed = options.accept.some((type) => {\n      // Extension check: \".pdf\", \".jpg\", etc.\n      if (type.startsWith(\".\")) {\n        return file.name.toLowerCase().endsWith(type.toLowerCase());\n      }\n      // Wildcard MIME: \"image/*\"\n      if (type.endsWith(\"/*\")) {\n        return file.type.startsWith(type.replace(\"/*\", \"/\"));\n      }\n      // Exact MIME: \"application/pdf\"\n      return file.type === type;\n    });\n    if (!allowed) {\n      const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n      return `File type \"${ext ? `.${ext}` : file.type || \"unknown\"}\" is not allowed`;\n    }\n  }\n\n  if (file.size === 0) {\n    return \"File is empty\";\n  }\n\n  if (options.maxFileSize && file.size > options.maxFileSize) {\n    const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n    return `File size exceeds ${maxMB} MB limit`;\n  }\n\n  return null;\n}\n"]}
+{"version":3,"sources":["../src/helpers.ts","../src/handlers/presign/upload.ts","../src/handlers/presign/confirm.ts","../src/handlers/presign/download.ts","../src/handlers/delete.ts","../src/handlers/multipart/init.ts","../src/handlers/multipart/part.ts","../src/handlers/multipart/complete.ts","../src/handlers/multipart/abort.ts","../src/create-handlers.ts","../src/router.ts","../src/api.ts","../src/validate.ts"],"names":["buildContentDisposition","fileName","ascii","encoded","parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","n","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","MAX_UPLOAD_SIZE","createUploadHandler","config","key","bucket","expiresIn","acl","contentType","fileSize","guardResult","fields","k","v","rangeMin","rangeMax","url","signedFields","createPresignedPost","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","getSignedUrl","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","CompleteMultipartUploadCommand","contentLength","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","disabled","createRouter","handlers","base","features","subpath","method","createS3Api","basePath","json","init","res","post","payload","options","params","safe","validateFile","file","type","ext"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Builds a RFC 6266 `Content-Disposition` value for a file attachment.\n * Includes both the ASCII-safe `filename` fallback and the RFC 5987\n * `filename*` parameter for full Unicode support.\n *\n * @example\n * buildContentDisposition(\"résumé finale.pdf\")\n * // → 'attachment; filename=\"resume finale.pdf\"; filename*=UTF-8\\'\\'r%C3%A9sum%C3%A9%20finale.pdf'\n */\nexport function buildContentDisposition(fileName: string): string {\n  const ascii = fileName.replace(/[^\\x20-\\x7E]/g, \"_\").replace(/[\"\\\\]/g, \"_\");\n  const encoded = encodeURIComponent(fileName);\n  return `attachment; filename=\"${ascii}\"; filename*=UTF-8''${encoded}`;\n}\n\nexport async function parseBody<T extends Record<string, unknown>>(\n  request: Request,\n): Promise<T | null> {\n  try {\n    const body = await request.json();\n    return body && typeof body === \"object\" ? (body as T) : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function requireString(value: unknown, name: string): string | Response {\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\";\n  if (!trimmed) {\n    return Response.json({ message: `${name} is required` }, { status: 400 });\n  }\n  return trimmed;\n}\n\nexport function normalizeExpiresIn(value: unknown): number {\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;\n}\n\nexport function withS3ErrorHandler(\n  handler: (request: Request) => Promise<Response>,\n) {\n  return async (request: Request) => {\n    try {\n      return await handler(request);\n    } catch (err) {\n      const message =\n        err instanceof Error ? err.message : \"Internal server error\";\n      console.error(\"[S3 API]\", message);\n      return Response.json({ message }, { status: 500 });\n    }\n  };\n}\n\n/**\n * Run a server hook. Returns a Response if the hook rejects (throws),\n * or `null` if the hook passes (or is undefined).\n */\nexport async function runHook<T>(\n  hook: ((context: T) => Promise<void> | void) | undefined,\n  context: T,\n): Promise<Response | null> {\n  if (!hook) return null;\n  try {\n    await hook(context);\n    return null;\n  } catch (err) {\n    const message = err instanceof Error ? err.message : \"Forbidden\";\n    const status =\n      typeof (err as Record<string, unknown>)?.status === \"number\"\n        ? ((err as Record<string, unknown>).status as number)\n        : 403;\n    return Response.json({ message }, { status });\n  }\n}\n","import { createPresignedPost } from \"@aws-sdk/s3-presigned-post\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\n// 5 GiB — S3 single-object upload limit\nconst MAX_UPLOAD_SIZE = 5 * 1024 * 1024 * 1024;\n\ntype Payload = {\n  key: string;\n  contentType?: string;\n  /**\n   * Exact byte size of the file the client intends to upload.\n   * When provided the presigned POST policy locks `content-length-range` to\n   * `[fileSize, fileSize]`, so S3 rejects any upload that is not exactly this\n   * size — even if the client tampers with the payload.\n   * When omitted the range is `[1, maxFileSize ?? 5 GiB]`.\n   */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  bucket?: string;\n  expiresIn?: number;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createUploadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const contentType = body.contentType?.trim() || \"application/octet-stream\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : null;\n\n    if (\n      fileSize !== null &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      fileSize: fileSize ?? undefined,\n      metadata: body.metadata,\n      acl,\n    });\n    if (guardResult) return guardResult;\n\n    // Build presigned POST fields. Fields are embedded in the signed policy\n    // so the client cannot change them without invalidating the signature.\n    const fields: Record<string, string> = { acl, \"Content-Type\": contentType };\n\n    if (body.fileName) {\n      fields[\"Content-Disposition\"] = buildContentDisposition(body.fileName);\n    }\n\n    if (body.metadata) {\n      for (const [k, v] of Object.entries(body.metadata)) {\n        fields[`x-amz-meta-${k}`] = v;\n      }\n    }\n\n    // `content-length-range` is enforced by S3 at the storage layer —\n    // uploads outside this range are rejected before the object is stored.\n    //\n    // When the client declares fileSize: S3 locks the range to exactly that\n    // number of bytes, so uploading a different-sized file is impossible.\n    // When fileSize is not declared: falls back to [1, maxFileSize ?? 5 GiB].\n    const rangeMin = fileSize ?? 1;\n    const rangeMax = fileSize ?? config.maxFileSize ?? MAX_UPLOAD_SIZE;\n\n    const { url, fields: signedFields } = await createPresignedPost(config.s3, {\n      Bucket: bucket,\n      Key: key,\n      Conditions: [[\"content-length-range\", rangeMin, rangeMax]],\n      Fields: fields,\n      Expires: expiresIn,\n    });\n\n    await config.hooks?.upload?.onPresigned?.({\n      request,\n      key,\n      bucket,\n      contentType: body.contentType,\n      metadata: body.metadata,\n      acl,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, fields: signedFields, expiresIn });\n  });\n}\n","import { HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n};\n\nexport function createConfirmHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.upload?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n\n    const context = {\n      request,\n      key,\n      bucket,\n      contentType: head.ContentType,\n      contentLength: head.ContentLength ?? 0,\n      eTag: head.ETag?.replace(/\"/g, \"\"),\n      metadata: head.Metadata,\n    };\n\n    await config.hooks?.upload?.onUploaded?.(context);\n\n    return Response.json({\n      key,\n      bucket,\n      contentType: context.contentType,\n      contentLength: context.contentLength,\n      eTag: context.eTag,\n    });\n  });\n}\n","import { GetObjectCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport { normalizeExpiresIn, runHook, withS3ErrorHandler } from \"../../helpers\";\n\nexport function createDownloadHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(searchParams.get(\"expiresIn\"));\n    const fileName = searchParams.get(\"fileName\")?.trim();\n\n    const guardResult = await runHook(config.hooks?.download?.guard, {\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n    });\n    if (guardResult) return guardResult;\n\n    const url = await getSignedUrl(\n      config.s3,\n      new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n        ...(fileName\n          ? { ResponseContentDisposition: `attachment; filename=\"${fileName}\"` }\n          : {}),\n      }),\n      { expiresIn },\n    );\n\n    await config.hooks?.download?.onPresigned?.({\n      request,\n      key,\n      bucket,\n      fileName: fileName || undefined,\n      url,\n      expiresIn,\n    });\n\n    return Response.json({ bucket, key, url, expiresIn });\n  });\n}\n","import { DeleteObjectCommand, HeadObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../types\";\nimport { runHook, withS3ErrorHandler } from \"../helpers\";\n\nexport function createDeleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const { searchParams } = new URL(request.url);\n    const key = searchParams.get(\"key\")?.trim();\n    if (!key) {\n      return Response.json(\n        { message: \"key query parameter is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = searchParams.get(\"bucket\")?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.delete?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    try {\n      await config.s3.send(new HeadObjectCommand({ Bucket: bucket, Key: key }));\n    } catch {\n      return Response.json(\n        { message: `Object \"${key}\" not found` },\n        { status: 404 },\n      );\n    }\n\n    await config.s3.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }));\n\n    await config.hooks?.delete?.onDeleted?.({ request, key, bucket });\n\n    return Response.json({ success: true, bucket, key });\n  });\n}\n","import { CreateMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  buildContentDisposition,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  bucket?: string;\n  contentType?: string;\n  /** Declared total byte size of the file being uploaded. */\n  fileSize?: number;\n  metadata?: Record<string, string>;\n  acl?: \"private\" | \"public-read\";\n  /** Original file name. Stored as `Content-Disposition: attachment; filename=\"...\"` on the S3 object. */\n  fileName?: string;\n};\n\nexport function createMultipartInitHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n    const fileSize =\n      typeof body.fileSize === \"number\" && body.fileSize > 0\n        ? Math.floor(body.fileSize)\n        : undefined;\n\n    if (\n      fileSize !== undefined &&\n      config.maxFileSize &&\n      fileSize > config.maxFileSize\n    ) {\n      return Response.json(\n        {\n          message: `File size (${fileSize} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 413 },\n      );\n    }\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n      fileSize,\n    });\n    if (guardResult) return guardResult;\n\n    const { UploadId } = await config.s3.send(\n      new CreateMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        ContentType: body.contentType,\n        ContentDisposition: body.fileName\n          ? buildContentDisposition(body.fileName)\n          : undefined,\n        Metadata: body.metadata,\n        ACL: acl,\n      }),\n    );\n\n    await config.hooks?.multipart?.onInit?.({\n      request,\n      key,\n      bucket,\n      uploadId: UploadId!,\n      contentType: body.contentType,\n      fileSize,\n      metadata: body.metadata,\n      acl,\n    });\n\n    return Response.json({ bucket, key, uploadId: UploadId }, { status: 201 });\n  });\n}\n","import { UploadPartCommand } from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  normalizeExpiresIn,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  partNumber: number;\n  bucket?: string;\n  expiresIn?: number;\n};\n\nexport function createMultipartPartHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const partNumber = Number(body.partNumber);\n    if (!Number.isInteger(partNumber) || partNumber <= 0) {\n      return Response.json(\n        { message: \"partNumber must be a positive integer\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n    const expiresIn = normalizeExpiresIn(body.expiresIn);\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    const presignedUrl = await getSignedUrl(\n      config.s3,\n      new UploadPartCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n      }),\n      { expiresIn },\n    );\n\n    return Response.json({\n      presignedUrl,\n      partNumber,\n      uploadId,\n      bucket,\n      expiresIn,\n    });\n  });\n}\n","import { CompleteMultipartUploadCommand, HeadObjectCommand, DeleteObjectCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype PartEntry = {\n  partNumber: number;\n  eTag: string;\n};\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n  parts: PartEntry[];\n};\n\nexport function createMultipartCompleteHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const parts = (Array.isArray(body.parts) ? body.parts : [])\n      .map(({ partNumber, eTag }) => ({\n        PartNumber: Number(partNumber),\n        ETag: String(eTag),\n      }))\n      .filter((p) => Number.isInteger(p.PartNumber) && p.ETag)\n      .sort((a, b) => a.PartNumber - b.PartNumber);\n\n    if (!parts.length) {\n      return Response.json(\n        { message: \"At least one valid part is required\" },\n        { status: 400 },\n      );\n    }\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: { Parts: parts },\n      }),\n    );\n\n    // Verify the actual uploaded object metadata via HeadObject.\n    // This is the server's only opportunity to enforce maxFileSize for\n    // multipart uploads, since individual parts bypass size checks.\n    const head = await config.s3.send(\n      new HeadObjectCommand({ Bucket: bucket, Key: key }),\n    );\n    const contentLength = head.ContentLength ?? 0;\n    const contentType = head.ContentType;\n    const eTag = head.ETag?.replace(/\"/g, \"\");\n\n    if (config.maxFileSize && contentLength > config.maxFileSize) {\n      // Delete the object and reject the request. The client has uploaded\n      // more data than the server policy allows.\n      await config.s3\n        .send(new DeleteObjectCommand({ Bucket: bucket, Key: key }))\n        .catch(() => {});\n      return Response.json(\n        {\n          message: `File size (${contentLength} bytes) exceeds the maximum allowed size of ${config.maxFileSize} bytes`,\n        },\n        { status: 422 },\n      );\n    }\n\n    await config.hooks?.multipart?.onComplete?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n      contentLength,\n      contentType,\n      eTag,\n    });\n\n    return Response.json({ bucket, key, uploadId, contentLength, contentType, eTag });\n  });\n}\n","import { AbortMultipartUploadCommand } from \"@aws-sdk/client-s3\";\nimport type { S3HandlerConfig } from \"../../types\";\nimport {\n  parseBody,\n  requireString,\n  runHook,\n  withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n  key: string;\n  uploadId: string;\n  bucket?: string;\n};\n\nexport function createMultipartAbortHandler(config: S3HandlerConfig) {\n  return withS3ErrorHandler(async (request: Request) => {\n    const body = await parseBody<Payload>(request);\n    if (!body) {\n      return Response.json(\n        { message: \"Invalid JSON payload\" },\n        { status: 400 },\n      );\n    }\n\n    const key = requireString(body.key, \"key\");\n    if (key instanceof Response) return key;\n\n    const uploadId = requireString(body.uploadId, \"uploadId\");\n    if (uploadId instanceof Response) return uploadId;\n\n    const bucket = body.bucket?.trim() || config.defaultBucket;\n\n    const guardResult = await runHook(config.hooks?.multipart?.guard, {\n      request,\n      key,\n      bucket,\n    });\n    if (guardResult) return guardResult;\n\n    await config.s3.send(\n      new AbortMultipartUploadCommand({\n        Bucket: bucket,\n        Key: key,\n        UploadId: uploadId,\n      }),\n    );\n\n    await config.hooks?.multipart?.onAbort?.({\n      request,\n      key,\n      bucket,\n      uploadId,\n    });\n\n    return Response.json({ bucket, key, uploadId, aborted: true });\n  });\n}\n","import type { S3HandlerConfig, S3Handlers } from \"./types\";\nimport { createUploadHandler } from \"./handlers/presign/upload\";\nimport { createConfirmHandler } from \"./handlers/presign/confirm\";\nimport { createDownloadHandler } from \"./handlers/presign/download\";\nimport { createDeleteHandler } from \"./handlers/delete\";\nimport { createMultipartInitHandler } from \"./handlers/multipart/init\";\nimport { createMultipartPartHandler } from \"./handlers/multipart/part\";\nimport { createMultipartCompleteHandler } from \"./handlers/multipart/complete\";\nimport { createMultipartAbortHandler } from \"./handlers/multipart/abort\";\n\nexport function createHandlers(config: S3HandlerConfig): S3Handlers {\n  return {\n    presign: {\n      upload: createUploadHandler(config),\n      confirm: createConfirmHandler(config),\n      download: createDownloadHandler(config),\n    },\n    multipart: {\n      init: createMultipartInitHandler(config),\n      part: createMultipartPartHandler(config),\n      complete: createMultipartCompleteHandler(config),\n      abort: createMultipartAbortHandler(config),\n    },\n    delete: createDeleteHandler(config),\n  };\n}\n","import type { S3RouteHandlerConfig } from \"./types\";\nimport { createHandlers } from \"./create-handlers\";\nimport { runHook } from \"./helpers\";\n\nconst disabled = () => Response.json({ message: \"Not Found\" }, { status: 404 });\n\nexport function createRouter(config: S3RouteHandlerConfig) {\n  const handlers = createHandlers(config);\n  const base = config.basePath.replace(/\\/$/, \"\");\n  const { features } = config;\n\n  return async (request: Request): Promise<Response> => {\n    // Global guard — runs before every request\n    const guardResult = await runHook(config.hooks?.guard, { request });\n    if (guardResult) return guardResult;\n\n    const url = new URL(request.url);\n    const subpath = url.pathname.slice(base.length).replace(/^\\//, \"\");\n    const method = request.method;\n\n    if (method === \"POST\" && subpath === \"presign/upload\")\n      return features.upload ? handlers.presign.upload(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/upload/confirm\")\n      return features.upload ? handlers.presign.confirm(request) : disabled();\n    if (method === \"GET\" && subpath === \"presign/download\")\n      return features.download\n        ? handlers.presign.download(request)\n        : disabled();\n    if (method === \"DELETE\" && subpath === \"delete\")\n      return features.delete ? handlers.delete(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/init\")\n      return features.multipart ? handlers.multipart.init(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/part\")\n      return features.multipart ? handlers.multipart.part(request) : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/complete\")\n      return features.multipart\n        ? handlers.multipart.complete(request)\n        : disabled();\n    if (method === \"POST\" && subpath === \"presign/multipart/abort\")\n      return features.multipart\n        ? handlers.multipart.abort(request)\n        : disabled();\n\n    return Response.json({ message: \"Not Found\" }, { status: 404 });\n  };\n}\n","export type PresignResponse = {\n  key: string;\n  bucket: string;\n  url: string;\n  expiresIn: number;\n};\n\nexport type PresignedPostResponse = {\n  key: string;\n  bucket: string;\n  url: string;\n  fields: Record<string, string>;\n  expiresIn: number;\n};\n\nexport type MultipartInitResponse = {\n  key: string;\n  bucket: string;\n  uploadId: string;\n};\n\nexport type MultipartPartResponse = {\n  presignedUrl: string;\n  partNumber: number;\n  uploadId: string;\n  bucket: string;\n  expiresIn: number;\n};\n\nexport type UploadConfirmResponse = {\n  key: string;\n  bucket: string;\n  contentType?: string;\n  contentLength: number;\n  eTag?: string;\n};\n\nexport type S3Api = {\n  upload: (payload: {\n    key: string;\n    contentType?: string;\n    /**\n     * Exact byte size of the file. When provided the presigned POST policy\n     * locks `content-length-range` to `[fileSize, fileSize]` so S3 rejects\n     * uploads of any other size at the storage layer.\n     */\n    fileSize?: number;\n    metadata?: Record<string, string>;\n    bucket?: string;\n    acl?: \"private\" | \"public-read\";\n    /** Original file name. Stored as `Content-Disposition` on the S3 object. */\n    fileName?: string;\n  }) => Promise<PresignedPostResponse>;\n  confirm: (payload: {\n    key: string;\n    bucket?: string;\n  }) => Promise<UploadConfirmResponse>;\n  download: (\n    key: string,\n    options?: { fileName?: string; bucket?: string },\n  ) => Promise<PresignResponse>;\n  delete: (\n    key: string,\n    options?: { bucket?: string },\n  ) => Promise<{ success: boolean; bucket: string; key: string }>;\n  multipart: {\n    init: (payload: {\n      key: string;\n      contentType?: string;\n      /** Declared total byte size of the file. Used for quota/guard checks and stored in `onInit` context. */\n      fileSize?: number;\n      metadata?: Record<string, string>;\n      bucket?: string;\n      acl?: \"private\" | \"public-read\";\n      /** Original file name. Stored as `Content-Disposition` on the S3 object. */\n      fileName?: string;\n    }) => Promise<MultipartInitResponse>;\n    signPart: (payload: {\n      key: string;\n      uploadId: string;\n      partNumber: number;\n      bucket?: string;\n    }) => Promise<MultipartPartResponse>;\n    complete: (payload: {\n      key: string;\n      uploadId: string;\n      parts: Array<{ partNumber: number; eTag: string }>;\n      bucket?: string;\n    }) => Promise<{\n      key: string;\n      bucket: string;\n      uploadId: string;\n      contentLength: number;\n      contentType?: string;\n      eTag?: string;\n    }>;\n    abort: (payload: {\n      key: string;\n      uploadId: string;\n      bucket?: string;\n    }) => Promise<{ aborted: boolean }>;\n  };\n};\n\nexport function createS3Api(basePath = \"/api/s3\"): S3Api {\n  const base = basePath.replace(/\\/$/, \"\");\n\n  const json = async <T>(url: string, init?: RequestInit): Promise<T> => {\n    const res = await fetch(url, init);\n    if (!res.ok) {\n      const body = await res.json().catch(() => ({}));\n      throw new Error((body as { message?: string }).message ?? res.statusText);\n    }\n    return res.json() as Promise<T>;\n  };\n\n  const post = <T>(url: string, body: unknown): Promise<T> =>\n    json<T>(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n    });\n\n  return {\n    upload(payload) {\n      return post<PresignedPostResponse>(`${base}/presign/upload`, payload);\n    },\n\n    confirm(payload) {\n      return post<UploadConfirmResponse>(\n        `${base}/presign/upload/confirm`,\n        payload,\n      );\n    },\n\n    download(key, options?) {\n      const params = new URLSearchParams({ key });\n      if (options?.fileName) {\n        const safe = options.fileName.replace(/[\"\\\\\\r\\n]/g, \"_\");\n        params.set(\"fileName\", safe);\n      }\n      if (options?.bucket) params.set(\"bucket\", options.bucket);\n      return json<PresignResponse>(`${base}/presign/download?${params}`);\n    },\n\n    delete(key, options?) {\n      const params = new URLSearchParams({ key });\n      if (options?.bucket) params.set(\"bucket\", options.bucket);\n      return json<{ success: boolean; bucket: string; key: string }>(\n        `${base}/delete?${params}`,\n        { method: \"DELETE\" },\n      );\n    },\n\n    multipart: {\n      init(payload) {\n        return post<MultipartInitResponse>(\n          `${base}/presign/multipart/init`,\n          payload,\n        );\n      },\n\n      signPart(payload) {\n        return post<MultipartPartResponse>(\n          `${base}/presign/multipart/part`,\n          payload,\n        );\n      },\n\n      complete(payload) {\n        return post<{\n          key: string;\n          bucket: string;\n          uploadId: string;\n          contentLength: number;\n          contentType?: string;\n          eTag?: string;\n        }>(`${base}/presign/multipart/complete`, payload);\n      },\n\n      abort(payload) {\n        return post<{ aborted: boolean }>(\n          `${base}/presign/multipart/abort`,\n          payload,\n        );\n      },\n    },\n  };\n}\n","export function validateFile(\n  file: File,\n  options: { accept?: string[]; maxFileSize?: number },\n): string | null {\n  if (options.accept?.length) {\n    const allowed = options.accept.some((type) => {\n      // Extension check: \".pdf\", \".jpg\", etc.\n      if (type.startsWith(\".\")) {\n        return file.name.toLowerCase().endsWith(type.toLowerCase());\n      }\n      // Wildcard MIME: \"image/*\"\n      if (type.endsWith(\"/*\")) {\n        return file.type.startsWith(type.replace(\"/*\", \"/\"));\n      }\n      // Exact MIME: \"application/pdf\"\n      return file.type === type;\n    });\n    if (!allowed) {\n      const ext = file.name.includes(\".\") ? file.name.split(\".\").pop() : null;\n      return `File type \"${ext ? `.${ext}` : file.type || \"unknown\"}\" is not allowed`;\n    }\n  }\n\n  if (file.size === 0) {\n    return \"File is empty\";\n  }\n\n  if (options.maxFileSize && file.size > options.maxFileSize) {\n    const maxMB = (options.maxFileSize / (1024 * 1024)).toFixed(1);\n    return `File size exceeds ${maxMB} MB limit`;\n  }\n\n  return null;\n}\n"]}

package/dist/types.d.ts

@@ -60,60 +60,120 @@ export type MultipartCompleteSuccessContext = MultipartHookContext & {
     eTag?: string;
 };
 export type S3ServerHooks = {
-    /** Runs before every request. Throw to reject. */
+    /**
+     * Runs before every request. Throw to reject (`403` by default).
+     */
     guard?: (context: HookContext) => Promise<void> | void;
     upload?: {
-        /** Runs before presigning an upload URL. Throw to reject. */
+        /**
+         * Runs before the presigned URL is generated.
+         * `fileSize` is client-declared — treat as untrusted.
+         * Throw to reject (`403` by default).
+         */
         guard?: (context: UploadHookContext) => Promise<void> | void;
-        /** Runs after a presigned upload URL is generated. */
-        onSuccess?: (context: UploadSuccessContext) => Promise<void> | void;
-        /** Runs after a simple upload is confirmed via HeadObject. */
-        onComplete?: (context: UploadCompleteContext) => Promise<void> | void;
+        /**
+         * Fires after the presigned URL is issued. The file has not been uploaded yet.
+         */
+        onPresigned?: (context: UploadSuccessContext) => Promise<void> | void;
+        /**
+         * Fires after `POST /presign/upload/confirm`. The server verifies the object via
+         * `HeadObject`, so `contentLength` and `eTag` are the actual S3 values.
+         */
+        onUploaded?: (context: UploadCompleteContext) => Promise<void> | void;
     };
     download?: {
-        /** Runs before presigning a download URL. Throw to reject. */
+        /**
+         * Runs before the presigned download URL is generated.
+         * Throw to reject (`403` by default).
+         */
         guard?: (context: DownloadHookContext) => Promise<void> | void;
-        /** Runs after a presigned download URL is generated. */
-        onSuccess?: (context: DownloadSuccessContext) => Promise<void> | void;
+        /**
+         * Fires after the presigned download URL is issued. The file has not been downloaded yet.
+         */
+        onPresigned?: (context: DownloadSuccessContext) => Promise<void> | void;
     };
     delete?: {
-        /** Runs before deleting an object. Throw to reject. */
+        /**
+         * Runs before the object is deleted from S3.
+         * Throw to reject (`403` by default).
+         */
         guard?: (context: DeleteHookContext) => Promise<void> | void;
-        /** Runs after an object is deleted. */
-        onSuccess?: (context: DeleteHookContext) => Promise<void> | void;
+        /**
+         * Fires after the object is successfully deleted from S3.
+         */
+        onDeleted?: (context: DeleteHookContext) => Promise<void> | void;
     };
     multipart?: {
-        /** Runs before any multipart operation. Throw to reject. */
+        /**
+         * Runs before every multipart operation (`init`, `part`, `complete`, `abort`).
+         * `fileSize` is only present during `init`.
+         * Throw to reject (`403` by default).
+         */
         guard?: (context: MultipartHookContext) => Promise<void> | void;
-        /** Runs after a multipart upload is initialized. */
+        /**
+         * Fires after `CreateMultipartUpload`. Use to record the pending session in your database.
+         */
         onInit?: (context: MultipartInitSuccessContext) => Promise<void> | void;
-        /** Runs after a multipart upload is completed (file fully uploaded). */
+        /**
+         * Fires after `CompleteMultipartUpload`. The server runs `HeadObject` first,
+         * so `contentLength` and `eTag` are the actual S3 values.
+         */
         onComplete?: (context: MultipartCompleteSuccessContext) => Promise<void> | void;
-        /** Runs after a multipart upload is aborted. */
+        /**
+         * Fires after `AbortMultipartUpload`. S3 releases all stored parts on success.
+         */
         onAbort?: (context: MultipartHookContext & {
             uploadId: string;
         }) => Promise<void> | void;
     };
 };
+export type S3Features = {
+    /**
+     * Enable presigned upload endpoints (`POST /presign/upload` and
+     * `POST /presign/upload/confirm`).
+     * @default false
+     */
+    upload?: boolean;
+    /**
+     * Enable the presigned download endpoint (`GET /presign/download`).
+     * @default false
+     */
+    download?: boolean;
+    /**
+     * Enable the delete endpoint (`DELETE /delete`).
+     * @default false
+     */
+    delete?: boolean;
+    /**
+     * Enable all multipart upload endpoints (`/presign/multipart/*`).
+     * Keep disabled unless you explicitly need multipart support — see the
+     * multipart cost-attack section in the README.
+     * @default false
+     */
+    multipart?: boolean;
+};
 export type S3HandlerConfig = {
+    /** The S3 client instance used to communicate with your bucket. */
     s3: S3Client;
+    /** Default bucket used when no `bucket` is specified in the request payload. */
     defaultBucket: string;
     /**
-     * Maximum file size in bytes enforced server-side.
-     * - Simple uploads: enforced via `content-length-range` in the presigned POST policy (S3 rejects oversized files).
-     * - Multipart uploads: enforced at three points:
-     *   1. Init-time rejection if the client declares a `fileSize` that exceeds this limit.
-     *   2. Part-request rejection if the requested `partNumber` exceeds the maximum number of
-     *      parts derivable from this limit (caps potential over-upload to `maxFileSize + ~5 MB`).
-     *   3. HeadObject verification after CompleteMultipartUpload; the object is deleted and a 422
-     *      is returned if the actual size still exceeds this limit.
+     * Controls which API endpoints are active.
+     * **All features are disabled by default** — you must opt in to each one.
      *
-     * Note: S3 presigned UploadPart URLs do not enforce per-part size at the S3 level.
-     * For strict enforcement, combine this setting with `requireFileSizeForMultipart`,
-     * infrastructure-level S3 lifecycle rules for incomplete multipart uploads, and
-     * rate limiting on your API endpoints.
+     * ```ts
+     * features: { upload: true, download: true, delete: true }
+     * // multipart stays off unless you explicitly enable it
+     * ```
+     */
+    features: S3Features;
+    /**
+     * Maximum file size in bytes. If set and the client declares a `fileSize` that
+     * exceeds this value, the request is rejected before any presigned URL is
+     * generated. Applies to both simple upload and multipart init.
      */
     maxFileSize?: number;
+    /** Optional lifecycle hooks for authentication, logging, and side effects. */
     hooks?: S3ServerHooks;
 };
 export type S3RouteHandlerConfig = S3HandlerConfig & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-s3/server",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Framework-agnostic S3 server handlers — presigned uploads, downloads, deletes, and multipart operations",
   "keywords": [
     "s3",