@better-s3/server 2.3.1 → 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +209 -59
- package/dist/adapters/next.js +2 -2
- package/dist/adapters/next.js.map +1 -1
- package/dist/api.d.ts +23 -1
- package/dist/helpers.d.ts +10 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +104 -16
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# @better-s3/server
|
|
1
|
+
# @better-s3/server
|
|
2
2
|
|
|
3
3
|
Framework-agnostic S3 server handlers — presigned uploads, downloads, deletes, and multipart operations. Works with any `Request`/`Response` runtime (Next.js, Hono, Bun, Deno, Cloudflare Workers, etc).
|
|
4
4
|
|
|
@@ -10,10 +10,8 @@ pnpm add @better-s3/server @aws-sdk/client-s3
|
|
|
10
10
|
|
|
11
11
|
## Quick Start
|
|
12
12
|
|
|
13
|
-
### Next.js App Router
|
|
14
|
-
|
|
15
13
|
```ts
|
|
16
|
-
// app/api/s3/[...s3]/route.ts
|
|
14
|
+
// app/api/s3/[...s3]/route.ts (Next.js App Router)
|
|
17
15
|
import { S3Client } from "@aws-sdk/client-s3";
|
|
18
16
|
import { createRouteHandler } from "@better-s3/server/next";
|
|
19
17
|
|
|
@@ -21,104 +19,256 @@ const handler = createRouteHandler({
|
|
|
21
19
|
s3: new S3Client({ region: "us-east-1" }),
|
|
22
20
|
defaultBucket: "my-bucket",
|
|
23
21
|
basePath: "/api/s3",
|
|
22
|
+
|
|
23
|
+
// Enable only the features your app needs. All are disabled by default.
|
|
24
|
+
features: {
|
|
25
|
+
upload: true,
|
|
26
|
+
download: true,
|
|
27
|
+
delete: true,
|
|
28
|
+
// multipart: true, // enable only if you explicitly need multipart support
|
|
29
|
+
},
|
|
24
30
|
});
|
|
25
31
|
|
|
26
32
|
export { handler as GET, handler as POST, handler as DELETE };
|
|
27
33
|
```
|
|
28
34
|
|
|
29
|
-
|
|
35
|
+
Other frameworks via `createRouter` from `@better-s3/server`:
|
|
30
36
|
|
|
31
37
|
```ts
|
|
32
|
-
import { S3Client } from "@aws-sdk/client-s3";
|
|
33
|
-
import { createRouter } from "@better-s3/server";
|
|
34
|
-
|
|
35
38
|
const router = createRouter({
|
|
36
|
-
s3: new S3Client({ region: "us-east-1" }),
|
|
37
|
-
defaultBucket: "my-bucket",
|
|
38
|
-
basePath: "/api/s3",
|
|
39
|
-
});
|
|
40
|
-
|
|
41
|
-
// Hono
|
|
42
|
-
app.all("/api/s3/*", (c) => router(c.req.raw));
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## Server Hooks
|
|
46
|
-
|
|
47
|
-
Run server-side logic at key points — auth, logging, database writes. Every hook has access to the `Request` object.
|
|
48
|
-
|
|
49
|
-
```ts
|
|
50
|
-
createRouteHandler({
|
|
51
39
|
s3,
|
|
52
40
|
defaultBucket: "my-bucket",
|
|
53
41
|
basePath: "/api/s3",
|
|
42
|
+
features: { upload: true, download: true, delete: true, multipart: true },
|
|
54
43
|
hooks: {
|
|
55
44
|
guard: async ({ request }) => {
|
|
56
|
-
|
|
57
|
-
if (!session) throw new Error("Unauthorized");
|
|
45
|
+
console.log("[guard]", request.method, request.url);
|
|
58
46
|
},
|
|
47
|
+
|
|
59
48
|
upload: {
|
|
60
|
-
|
|
61
|
-
|
|
49
|
+
guard: async ({ key, bucket, contentType, fileSize }) => {
|
|
50
|
+
console.log("[upload.guard]", { key, bucket, contentType, fileSize });
|
|
51
|
+
},
|
|
52
|
+
onPresigned: async ({ key, url, expiresIn }) => {
|
|
53
|
+
console.log("[upload.onPresigned]", { key, url, expiresIn });
|
|
62
54
|
},
|
|
63
|
-
|
|
64
|
-
|
|
55
|
+
onUploaded: async ({ key, contentType, contentLength, eTag }) => {
|
|
56
|
+
console.log("[upload.onUploaded]", {
|
|
57
|
+
key,
|
|
58
|
+
contentType,
|
|
59
|
+
contentLength,
|
|
60
|
+
eTag,
|
|
61
|
+
});
|
|
65
62
|
},
|
|
66
63
|
},
|
|
64
|
+
|
|
65
|
+
download: {
|
|
66
|
+
guard: async ({ key, bucket, fileName }) => {
|
|
67
|
+
console.log("[download.guard]", { key, bucket, fileName });
|
|
68
|
+
},
|
|
69
|
+
onPresigned: async ({ key, url, expiresIn }) => {
|
|
70
|
+
console.log("[download.onPresigned]", { key, url, expiresIn });
|
|
71
|
+
},
|
|
72
|
+
},
|
|
73
|
+
|
|
67
74
|
delete: {
|
|
68
|
-
guard: async ({
|
|
69
|
-
|
|
75
|
+
guard: async ({ key, bucket }) => {
|
|
76
|
+
console.log("[delete.guard]", { key, bucket });
|
|
70
77
|
},
|
|
71
|
-
|
|
72
|
-
|
|
78
|
+
onDeleted: async ({ key, bucket }) => {
|
|
79
|
+
console.log("[delete.onDeleted]", { key, bucket });
|
|
73
80
|
},
|
|
74
81
|
},
|
|
82
|
+
|
|
75
83
|
multipart: {
|
|
76
|
-
|
|
77
|
-
|
|
84
|
+
guard: async ({ key, bucket, fileSize }) => {
|
|
85
|
+
console.log("[multipart.guard]", { key, bucket, fileSize });
|
|
86
|
+
},
|
|
87
|
+
onInit: async ({ key, uploadId, contentType, fileSize }) => {
|
|
88
|
+
console.log("[multipart.onInit]", {
|
|
89
|
+
key,
|
|
90
|
+
uploadId,
|
|
91
|
+
contentType,
|
|
92
|
+
fileSize,
|
|
93
|
+
});
|
|
78
94
|
},
|
|
79
|
-
onComplete: async ({ key, uploadId }) => {
|
|
80
|
-
|
|
95
|
+
onComplete: async ({ key, uploadId, contentLength, eTag }) => {
|
|
96
|
+
console.log("[multipart.onComplete]", {
|
|
97
|
+
key,
|
|
98
|
+
uploadId,
|
|
99
|
+
contentLength,
|
|
100
|
+
eTag,
|
|
101
|
+
});
|
|
81
102
|
},
|
|
82
103
|
onAbort: async ({ key, uploadId }) => {
|
|
83
|
-
|
|
104
|
+
console.log("[multipart.onAbort]", { key, uploadId });
|
|
84
105
|
},
|
|
85
106
|
},
|
|
86
107
|
},
|
|
87
108
|
});
|
|
109
|
+
|
|
110
|
+
app.all("/api/s3/*", (c) => router(c.req.raw)); // Hono example
|
|
88
111
|
```
|
|
89
112
|
|
|
90
|
-
|
|
113
|
+
## Features
|
|
91
114
|
|
|
92
|
-
|
|
115
|
+
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)).
|
|
93
116
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
117
|
+
```ts
|
|
118
|
+
features: {
|
|
119
|
+
upload: true, // POST /presign/upload + POST /presign/upload/confirm
|
|
120
|
+
download: true, // GET /presign/download
|
|
121
|
+
delete: true, // DELETE /delete
|
|
122
|
+
multipart: true, // POST /presign/multipart/{init,part,complete,abort}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
> Disabled endpoints respond with `404 Not Found`.
|
|
127
|
+
|
|
128
|
+
| Upload mode | Enforcement |
|
|
129
|
+
| ----------- | --------------------------------------------------------------------------------------------------------------- |
|
|
130
|
+
| Simple | S3 enforces exact size via `content-length-range` in the signed POST policy — tamperproof |
|
|
131
|
+
| Multipart | `HeadObject` after complete verifies the final object size; no per-part enforcement at the S3 level (see below) |
|
|
104
132
|
|
|
105
|
-
|
|
133
|
+
> 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).
|
|
106
134
|
|
|
107
|
-
|
|
135
|
+
## Server Hooks
|
|
136
|
+
|
|
137
|
+
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.
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
Simple: upload.guard → upload.onPresigned → [S3] → upload.onUploaded
|
|
141
|
+
Multipart: multipart.guard(init) → multipart.onInit
|
|
142
|
+
multipart.guard(part) → [S3]
|
|
143
|
+
multipart.guard(complete) → HeadObject → multipart.onComplete
|
|
144
|
+
multipart.guard(abort) → multipart.onAbort
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
### Authentication
|
|
108
148
|
|
|
109
149
|
```ts
|
|
110
|
-
|
|
150
|
+
hooks: {
|
|
151
|
+
guard: async ({ request }) => {
|
|
152
|
+
const session = await getSession(request);
|
|
153
|
+
if (!session) throw Object.assign(new Error("Unauthorized"), { status: 401 });
|
|
154
|
+
},
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
### Quota check
|
|
159
|
+
|
|
160
|
+
`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.
|
|
161
|
+
|
|
162
|
+
```ts
|
|
163
|
+
hooks: {
|
|
164
|
+
upload: {
|
|
165
|
+
guard: async ({ request, fileSize }) => {
|
|
166
|
+
const { userId } = await getSession(request);
|
|
167
|
+
const used = await db.storage.getUsed(userId);
|
|
168
|
+
if (fileSize && used + fileSize > QUOTA)
|
|
169
|
+
throw Object.assign(new Error("Quota exceeded"), { status: 403 });
|
|
170
|
+
},
|
|
171
|
+
},
|
|
172
|
+
}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Multipart cost attacks
|
|
176
|
+
|
|
177
|
+
S3 presigned `UploadPart` URLs cannot enforce per-part size. A malicious client can upload oversized parts — the post-complete `HeadObject` check will catch and delete the final object, but temporary part storage still accumulates cost. Without completion, orphaned parts stay on AWS S3 indefinitely (R2 cleans up after 7 days).
|
|
178
|
+
|
|
179
|
+
**Mitigation: track uploads in a database + cron cleanup**
|
|
180
|
+
|
|
181
|
+
```ts
|
|
182
|
+
hooks: {
|
|
183
|
+
multipart: {
|
|
184
|
+
// Guard runs on init, part, complete, and abort.
|
|
185
|
+
// fileSize is only present during init — use it to limit open sessions.
|
|
186
|
+
guard: async ({ request, fileSize }) => {
|
|
187
|
+
if (!fileSize) return;
|
|
188
|
+
const { userId } = await getSession(request);
|
|
189
|
+
const pending = await db.upload.count({ where: { userId, status: "pending" } });
|
|
190
|
+
if (pending >= 3)
|
|
191
|
+
throw Object.assign(new Error("Too many pending uploads"), { status: 429 });
|
|
192
|
+
},
|
|
111
193
|
|
|
112
|
-
|
|
194
|
+
onInit: async ({ request, key, uploadId, contentType, fileSize }) => {
|
|
195
|
+
const { userId } = await getSession(request);
|
|
196
|
+
await db.upload.create({
|
|
197
|
+
data: { key, userId, uploadId, contentType, declaredSize: fileSize, status: "pending" },
|
|
198
|
+
});
|
|
199
|
+
},
|
|
200
|
+
|
|
201
|
+
onComplete: async ({ key, contentLength, contentType, eTag }) => {
|
|
202
|
+
await db.upload.update({
|
|
203
|
+
where: { key },
|
|
204
|
+
data: { status: "complete", verifiedSize: contentLength, contentType, eTag },
|
|
205
|
+
});
|
|
206
|
+
},
|
|
113
207
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
208
|
+
onAbort: async ({ key }) => {
|
|
209
|
+
await db.upload.update({ where: { key }, data: { status: "aborted" } });
|
|
210
|
+
},
|
|
211
|
+
},
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
**Cron job** — abort stale uploads and release S3 part storage:
|
|
216
|
+
|
|
217
|
+
```ts
|
|
218
|
+
// Runs every hour
|
|
219
|
+
const stale = await db.upload.findMany({
|
|
220
|
+
where: {
|
|
221
|
+
status: "pending",
|
|
222
|
+
createdAt: { lt: new Date(Date.now() - 3_600_000) },
|
|
223
|
+
},
|
|
117
224
|
});
|
|
118
|
-
const
|
|
119
|
-
await
|
|
225
|
+
for (const upload of stale) {
|
|
226
|
+
await s3
|
|
227
|
+
.send(
|
|
228
|
+
new AbortMultipartUploadCommand({
|
|
229
|
+
Bucket: defaultBucket,
|
|
230
|
+
Key: upload.key,
|
|
231
|
+
UploadId: upload.uploadId,
|
|
232
|
+
}),
|
|
233
|
+
)
|
|
234
|
+
.catch(() => {});
|
|
235
|
+
await db.upload.update({
|
|
236
|
+
where: { key: upload.key },
|
|
237
|
+
data: { status: "expired" },
|
|
238
|
+
});
|
|
239
|
+
}
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
**S3 lifecycle rule** — safety net for anything the cron misses (e.g. crash before `onInit`):
|
|
243
|
+
|
|
244
|
+
```json
|
|
245
|
+
{
|
|
246
|
+
"Rules": [
|
|
247
|
+
{
|
|
248
|
+
"ID": "abort-incomplete-multipart",
|
|
249
|
+
"Status": "Enabled",
|
|
250
|
+
"Filter": { "Prefix": "" },
|
|
251
|
+
"AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 1 }
|
|
252
|
+
}
|
|
253
|
+
]
|
|
254
|
+
}
|
|
120
255
|
```
|
|
121
256
|
|
|
257
|
+
> Also rate-limit `/presign/multipart/part` per user/IP at the application layer.
|
|
258
|
+
|
|
259
|
+
## API Routes
|
|
260
|
+
|
|
261
|
+
| Method | Path | Description |
|
|
262
|
+
| -------- | ----------------------------- | -------------------------------- |
|
|
263
|
+
| `POST` | `/presign/upload` | Presigned POST for direct upload |
|
|
264
|
+
| `POST` | `/presign/upload/confirm` | Confirm upload via HeadObject |
|
|
265
|
+
| `GET` | `/presign/download` | Presigned download URL |
|
|
266
|
+
| `DELETE` | `/delete` | Delete object |
|
|
267
|
+
| `POST` | `/presign/multipart/init` | Init multipart upload |
|
|
268
|
+
| `POST` | `/presign/multipart/part` | Sign a part URL |
|
|
269
|
+
| `POST` | `/presign/multipart/complete` | Complete + verify |
|
|
270
|
+
| `POST` | `/presign/multipart/abort` | Abort multipart |
|
|
271
|
+
|
|
122
272
|
## License
|
|
123
273
|
|
|
124
274
|
MIT
|
package/dist/adapters/next.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export{
|
|
1
|
+
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)}
|
|
2
|
+
export{Oe as createRouteHandler};//# sourceMappingURL=next.js.map
|
|
3
3
|
//# sourceMappingURL=next.js.map
|
|
@@ -1 +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":["parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","createUploadHandler","config","key","bucket","expiresIn","acl","guardResult","url","getSignedUrl","PutObjectCommand","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","fileName","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","Location","ETag","CompleteMultipartUploadCommand","createMultipartAbortHandler","AbortMultipartUploadCommand","createHandlers","createRouter","handlers","base","subpath","method","createRouteHandler"],"mappings":"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","file":"next.js","sourcesContent":["export 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 { PutObjectCommand } 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 contentType?: string;\n metadata?: Record<string, string>;\n bucket?: string;\n expiresIn?: number;\n acl?: \"private\" | \"public-read\";\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\n const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n\n const guardResult = await runHook(config.hooks?.upload?.guard, {\n request,\n key,\n bucket,\n contentType: body.contentType,\n metadata: body.metadata,\n acl,\n });\n if (guardResult) return guardResult;\n\n const url = await getSignedUrl(\n config.s3,\n new PutObjectCommand({\n Bucket: bucket,\n Key: key,\n ContentType: body.contentType,\n Metadata: body.metadata,\n ACL: acl,\n }),\n { 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, 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 ResponseContentDisposition: `attachment${fileName ? `; filename=\"${fileName}\"` : \"\"}`,\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 runHook,\n withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n key: string;\n bucket?: string;\n contentType?: string;\n metadata?: Record<string, string>;\n acl?: \"private\" | \"public-read\";\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\n const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\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 { UploadId } = await config.s3.send(\n new CreateMultipartUploadCommand({\n Bucket: bucket,\n Key: key,\n ContentType: body.contentType,\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 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 } 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 const { Location, ETag } = await config.s3.send(\n new CompleteMultipartUploadCommand({\n Bucket: bucket,\n Key: key,\n UploadId: uploadId,\n MultipartUpload: { Parts: parts },\n }),\n );\n\n await config.hooks?.multipart?.onComplete?.({\n request,\n key,\n bucket,\n uploadId,\n });\n\n return Response.json({\n bucket,\n key,\n uploadId,\n location: Location,\n eTag: ETag,\n });\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"]}
|
|
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","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/api.d.ts
CHANGED
|
@@ -4,6 +4,13 @@ export type PresignResponse = {
|
|
|
4
4
|
url: string;
|
|
5
5
|
expiresIn: number;
|
|
6
6
|
};
|
|
7
|
+
export type PresignedPostResponse = {
|
|
8
|
+
key: string;
|
|
9
|
+
bucket: string;
|
|
10
|
+
url: string;
|
|
11
|
+
fields: Record<string, string>;
|
|
12
|
+
expiresIn: number;
|
|
13
|
+
};
|
|
7
14
|
export type MultipartInitResponse = {
|
|
8
15
|
key: string;
|
|
9
16
|
bucket: string;
|
|
@@ -27,10 +34,18 @@ export type S3Api = {
|
|
|
27
34
|
upload: (payload: {
|
|
28
35
|
key: string;
|
|
29
36
|
contentType?: string;
|
|
37
|
+
/**
|
|
38
|
+
* Exact byte size of the file. When provided the presigned POST policy
|
|
39
|
+
* locks `content-length-range` to `[fileSize, fileSize]` so S3 rejects
|
|
40
|
+
* uploads of any other size at the storage layer.
|
|
41
|
+
*/
|
|
42
|
+
fileSize?: number;
|
|
30
43
|
metadata?: Record<string, string>;
|
|
31
44
|
bucket?: string;
|
|
32
45
|
acl?: "private" | "public-read";
|
|
33
|
-
|
|
46
|
+
/** Original file name. Stored as `Content-Disposition` on the S3 object. */
|
|
47
|
+
fileName?: string;
|
|
48
|
+
}) => Promise<PresignedPostResponse>;
|
|
34
49
|
confirm: (payload: {
|
|
35
50
|
key: string;
|
|
36
51
|
bucket?: string;
|
|
@@ -50,9 +65,13 @@ export type S3Api = {
|
|
|
50
65
|
init: (payload: {
|
|
51
66
|
key: string;
|
|
52
67
|
contentType?: string;
|
|
68
|
+
/** Declared total byte size of the file. Used for quota/guard checks and stored in `onInit` context. */
|
|
69
|
+
fileSize?: number;
|
|
53
70
|
metadata?: Record<string, string>;
|
|
54
71
|
bucket?: string;
|
|
55
72
|
acl?: "private" | "public-read";
|
|
73
|
+
/** Original file name. Stored as `Content-Disposition` on the S3 object. */
|
|
74
|
+
fileName?: string;
|
|
56
75
|
}) => Promise<MultipartInitResponse>;
|
|
57
76
|
signPart: (payload: {
|
|
58
77
|
key: string;
|
|
@@ -72,6 +91,9 @@ export type S3Api = {
|
|
|
72
91
|
key: string;
|
|
73
92
|
bucket: string;
|
|
74
93
|
uploadId: string;
|
|
94
|
+
contentLength: number;
|
|
95
|
+
contentType?: string;
|
|
96
|
+
eTag?: string;
|
|
75
97
|
}>;
|
|
76
98
|
abort: (payload: {
|
|
77
99
|
key: string;
|
package/dist/helpers.d.ts
CHANGED
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Builds a RFC 6266 `Content-Disposition` value for a file attachment.
|
|
3
|
+
* Includes both the ASCII-safe `filename` fallback and the RFC 5987
|
|
4
|
+
* `filename*` parameter for full Unicode support.
|
|
5
|
+
*
|
|
6
|
+
* @example
|
|
7
|
+
* buildContentDisposition("résumé finale.pdf")
|
|
8
|
+
* // → 'attachment; filename="resume finale.pdf"; filename*=UTF-8\'\'r%C3%A9sum%C3%A9%20finale.pdf'
|
|
9
|
+
*/
|
|
10
|
+
export declare function buildContentDisposition(fileName: string): string;
|
|
1
11
|
export declare function parseBody<T extends Record<string, unknown>>(request: Request): Promise<T | null>;
|
|
2
12
|
export declare function requireString(value: unknown, name: string): string | Response;
|
|
3
13
|
export declare function normalizeExpiresIn(value: unknown): number;
|
package/dist/index.d.ts
CHANGED
|
@@ -8,7 +8,7 @@ export { createMultipartInitHandler } from "./handlers/multipart/init";
|
|
|
8
8
|
export { createMultipartPartHandler } from "./handlers/multipart/part";
|
|
9
9
|
export { createMultipartCompleteHandler } from "./handlers/multipart/complete";
|
|
10
10
|
export { createMultipartAbortHandler } from "./handlers/multipart/abort";
|
|
11
|
-
export { createS3Api, type S3Api, type PresignResponse, type MultipartInitResponse, type MultipartPartResponse, type UploadConfirmResponse, } from "./api";
|
|
11
|
+
export { createS3Api, type S3Api, type PresignResponse, type PresignedPostResponse, type MultipartInitResponse, type MultipartPartResponse, type UploadConfirmResponse, } from "./api";
|
|
12
12
|
export { createS3Api as createPresignApi, type S3Api as PresignApi, } from "./api";
|
|
13
13
|
export { validateFile } from "./validate";
|
|
14
14
|
export type { S3HandlerConfig, S3RouteHandlerConfig, S3Handler, S3Handlers, S3ServerHooks, HookContext, UploadHookContext, UploadSuccessContext, UploadCompleteContext, DownloadHookContext, DownloadSuccessContext, DeleteHookContext, MultipartHookContext, MultipartInitSuccessContext, MultipartCompleteSuccessContext, } from "./types";
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import {PutObjectCommand,HeadObjectCommand,GetObjectCommand,DeleteObjectCommand,CreateMultipartUploadCommand,UploadPartCommand,CompleteMultipartUploadCommand,AbortMultipartUploadCommand}from'@aws-sdk/client-s3';import {getSignedUrl}from'@aws-sdk/s3-request-presigner';async function d(t){try{let n=await t.json();return n&&typeof n=="object"?n:null}catch{return null}}function l(t,n){let r=typeof t=="string"?t.trim():"";return r||Response.json({message:`${n} is required`},{status:400})}function c(t){let n=Number(t);return Number.isFinite(n)&&n>0?Math.floor(n):600}function u(t){return async n=>{try{return await t(n)}catch(r){let e=r instanceof Error?r.message:"Internal server error";return console.error("[S3 API]",e),Response.json({message:e},{status:500})}}}async function p(t,n){if(!t)return null;try{return await t(n),null}catch(r){let e=r instanceof Error?r.message:"Forbidden",a=typeof r?.status=="number"?r.status:403;return Response.json({message:e},{status:a})}}function k(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=r.bucket?.trim()||t.defaultBucket,s=c(r.expiresIn),o=r.acl==="public-read"?"public-read":"private",i=await p(t.hooks?.upload?.guard,{request:n,key:e,bucket:a,contentType:r.contentType,metadata:r.metadata,acl:o});if(i)return i;let m=await getSignedUrl(t.s3,new PutObjectCommand({Bucket:a,Key:e,ContentType:r.contentType,Metadata:r.metadata,ACL:o}),{expiresIn:s});return await t.hooks?.upload?.onSuccess?.({request:n,key:e,bucket:a,contentType:r.contentType,metadata:r.metadata,acl:o,url:m,expiresIn:s}),Response.json({bucket:a,key:e,url:m,expiresIn:s})})}function b(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=r.bucket?.trim()||t.defaultBucket,s=await p(t.hooks?.upload?.guard,{request:n,key:e,bucket:a});if(s)return s;let o=await t.s3.send(new HeadObjectCommand({Bucket:a,Key:e})),i={request:n,key:e,bucket:a,contentType:o.ContentType,contentLength:o.ContentLength??0,eTag:o.ETag?.replace(/"/g,""),metadata:o.Metadata};return await t.hooks?.upload?.onComplete?.(i),Response.json({key:e,bucket:a,contentType:i.contentType,contentLength:i.contentLength,eTag:i.eTag})})}function R(t){return u(async n=>{let{searchParams:r}=new URL(n.url),e=r.get("key")?.trim();if(!e)return Response.json({message:"key query parameter is required"},{status:400});let a=r.get("bucket")?.trim()||t.defaultBucket,s=c(r.get("expiresIn")),o=r.get("fileName")?.trim(),i=await p(t.hooks?.download?.guard,{request:n,key:e,bucket:a,fileName:o||void 0});if(i)return i;let m=await getSignedUrl(t.s3,new GetObjectCommand({Bucket:a,Key:e,ResponseContentDisposition:`attachment${o?`; filename="${o}"`:""}`}),{expiresIn:s});return await t.hooks?.download?.onSuccess?.({request:n,key:e,bucket:a,fileName:o||void 0,url:m,expiresIn:s}),Response.json({bucket:a,key:e,url:m,expiresIn:s})})}function w(t){return u(async n=>{let{searchParams:r}=new URL(n.url),e=r.get("key")?.trim();if(!e)return Response.json({message:"key query parameter is required"},{status:400});let a=r.get("bucket")?.trim()||t.defaultBucket,s=await p(t.hooks?.delete?.guard,{request:n,key:e,bucket:a});if(s)return s;try{await t.s3.send(new HeadObjectCommand({Bucket:a,Key:e}));}catch{return Response.json({message:`Object "${e}" not found`},{status:404})}return await t.s3.send(new DeleteObjectCommand({Bucket:a,Key:e})),await t.hooks?.delete?.onSuccess?.({request:n,key:e,bucket:a}),Response.json({success:!0,bucket:a,key:e})})}function S(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=r.bucket?.trim()||t.defaultBucket,s=r.acl==="public-read"?"public-read":"private",o=await p(t.hooks?.multipart?.guard,{request:n,key:e,bucket:a});if(o)return o;let{UploadId:i}=await t.s3.send(new CreateMultipartUploadCommand({Bucket:a,Key:e,ContentType:r.contentType,Metadata:r.metadata,ACL:s}));return await t.hooks?.multipart?.onInit?.({request:n,key:e,bucket:a,uploadId:i,contentType:r.contentType,metadata:r.metadata,acl:s}),Response.json({bucket:a,key:e,uploadId:i},{status:201})})}function H(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=l(r.uploadId,"uploadId");if(a instanceof Response)return a;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()||t.defaultBucket,i=c(r.expiresIn),m=await p(t.hooks?.multipart?.guard,{request:n,key:e,bucket:o});if(m)return m;let y=await getSignedUrl(t.s3,new UploadPartCommand({Bucket:o,Key:e,UploadId:a,PartNumber:s}),{expiresIn:i});return Response.json({presignedUrl:y,partNumber:s,uploadId:a,bucket:o,expiresIn:i})})}function x(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=l(r.uploadId,"uploadId");if(a instanceof Response)return a;let s=(Array.isArray(r.parts)?r.parts:[]).map(({partNumber:g,eTag:f})=>({PartNumber:Number(g),ETag:String(f)})).filter(g=>Number.isInteger(g.PartNumber)&&g.ETag).sort((g,f)=>g.PartNumber-f.PartNumber);if(!s.length)return Response.json({message:"At least one valid part is required"},{status:400});let o=r.bucket?.trim()||t.defaultBucket,i=await p(t.hooks?.multipart?.guard,{request:n,key:e,bucket:o});if(i)return i;let{Location:m,ETag:y}=await t.s3.send(new CompleteMultipartUploadCommand({Bucket:o,Key:e,UploadId:a,MultipartUpload:{Parts:s}}));return await t.hooks?.multipart?.onComplete?.({request:n,key:e,bucket:o,uploadId:a}),Response.json({bucket:o,key:e,uploadId:a,location:m,eTag:y})})}function P(t){return u(async n=>{let r=await d(n);if(!r)return Response.json({message:"Invalid JSON payload"},{status:400});let e=l(r.key,"key");if(e instanceof Response)return e;let a=l(r.uploadId,"uploadId");if(a instanceof Response)return a;let s=r.bucket?.trim()||t.defaultBucket,o=await p(t.hooks?.multipart?.guard,{request:n,key:e,bucket:s});return o||(await t.s3.send(new AbortMultipartUploadCommand({Bucket:s,Key:e,UploadId:a})),await t.hooks?.multipart?.onAbort?.({request:n,key:e,bucket:s,uploadId:a}),Response.json({bucket:s,key:e,uploadId:a,aborted:!0}))})}function C(t){return {presign:{upload:k(t),confirm:b(t),download:R(t)},multipart:{init:S(t),part:H(t),complete:x(t),abort:P(t)},delete:w(t)}}function L(t){let n=C(t),r=t.basePath.replace(/\/$/,"");return async e=>{let a=await p(t.hooks?.guard,{request:e});if(a)return a;let o=new URL(e.url).pathname.slice(r.length).replace(/^\//,""),i=e.method;return i==="POST"&&o==="presign/upload"?n.presign.upload(e):i==="POST"&&o==="presign/upload/confirm"?n.presign.confirm(e):i==="GET"&&o==="presign/download"?n.presign.download(e):i==="DELETE"&&o==="delete"?n.delete(e):i==="POST"&&o==="presign/multipart/init"?n.multipart.init(e):i==="POST"&&o==="presign/multipart/part"?n.multipart.part(e):i==="POST"&&o==="presign/multipart/complete"?n.multipart.complete(e):i==="POST"&&o==="presign/multipart/abort"?n.multipart.abort(e):Response.json({message:"Not Found"},{status:404})}}function h(t="/api/s3"){let n=t.replace(/\/$/,""),r=async(a,s)=>{let o=await fetch(a,s);if(!o.ok){let i=await o.json().catch(()=>({}));throw new Error(i.message??o.statusText)}return o.json()},e=(a,s)=>r(a,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});return {upload(a){return e(`${n}/presign/upload`,a)},confirm(a){return e(`${n}/presign/upload/confirm`,a)},download(a,s){let o=new URLSearchParams({key:a});if(s?.fileName){let i=s.fileName.replace(/["\\\r\n]/g,"_");o.set("fileName",i);}return s?.bucket&&o.set("bucket",s.bucket),r(`${n}/presign/download?${o}`)},delete(a,s){let o=new URLSearchParams({key:a});return s?.bucket&&o.set("bucket",s.bucket),r(`${n}/delete?${o}`,{method:"DELETE"})},multipart:{init(a){return e(`${n}/presign/multipart/init`,a)},signPart(a){return e(`${n}/presign/multipart/part`,a)},complete(a){return e(`${n}/presign/multipart/complete`,a)},abort(a){return e(`${n}/presign/multipart/abort`,a)}}}}function F(t,n){if(n.accept?.length&&!n.accept.some(e=>e.startsWith(".")?t.name.toLowerCase().endsWith(e.toLowerCase()):e.endsWith("/*")?t.type.startsWith(e.replace("/*","/")):t.type===e)){let e=t.name.includes(".")?t.name.split(".").pop():null;return `File type "${e?`.${e}`:t.type||"unknown"}" is not allowed`}return t.size===0?"File is empty":n.maxFileSize&&t.size>n.maxFileSize?`File size exceeds ${(n.maxFileSize/1048576).toFixed(1)} MB limit`:null}
|
|
2
|
-
export{
|
|
1
|
+
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}
|
|
2
|
+
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
|
|
3
3
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +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":["parseBody","request","body","requireString","value","name","trimmed","normalizeExpiresIn","withS3ErrorHandler","handler","err","message","runHook","hook","context","status","createUploadHandler","config","key","bucket","expiresIn","acl","guardResult","url","getSignedUrl","PutObjectCommand","createConfirmHandler","head","HeadObjectCommand","createDownloadHandler","searchParams","fileName","GetObjectCommand","createDeleteHandler","DeleteObjectCommand","createMultipartInitHandler","UploadId","CreateMultipartUploadCommand","createMultipartPartHandler","uploadId","partNumber","presignedUrl","UploadPartCommand","createMultipartCompleteHandler","parts","eTag","p","a","b","Location","ETag","CompleteMultipartUploadCommand","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":["export 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 { PutObjectCommand } 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 contentType?: string;\n metadata?: Record<string, string>;\n bucket?: string;\n expiresIn?: number;\n acl?: \"private\" | \"public-read\";\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\n const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\n\n const guardResult = await runHook(config.hooks?.upload?.guard, {\n request,\n key,\n bucket,\n contentType: body.contentType,\n metadata: body.metadata,\n acl,\n });\n if (guardResult) return guardResult;\n\n const url = await getSignedUrl(\n config.s3,\n new PutObjectCommand({\n Bucket: bucket,\n Key: key,\n ContentType: body.contentType,\n Metadata: body.metadata,\n ACL: acl,\n }),\n { 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, 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 ResponseContentDisposition: `attachment${fileName ? `; filename=\"${fileName}\"` : \"\"}`,\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 runHook,\n withS3ErrorHandler,\n} from \"../../helpers\";\n\ntype Payload = {\n key: string;\n bucket?: string;\n contentType?: string;\n metadata?: Record<string, string>;\n acl?: \"private\" | \"public-read\";\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\n const acl = body.acl === \"public-read\" ? \"public-read\" : \"private\";\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 { UploadId } = await config.s3.send(\n new CreateMultipartUploadCommand({\n Bucket: bucket,\n Key: key,\n ContentType: body.contentType,\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 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 } 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 const { Location, ETag } = await config.s3.send(\n new CompleteMultipartUploadCommand({\n Bucket: bucket,\n Key: key,\n UploadId: uploadId,\n MultipartUpload: { Parts: parts },\n }),\n );\n\n await config.hooks?.multipart?.onComplete?.({\n request,\n key,\n bucket,\n uploadId,\n });\n\n return Response.json({\n bucket,\n key,\n uploadId,\n location: Location,\n eTag: ETag,\n });\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 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 metadata?: Record<string, string>;\n bucket?: string;\n acl?: \"private\" | \"public-read\";\n }) => Promise<PresignResponse>;\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 metadata?: Record<string, string>;\n bucket?: string;\n acl?: \"private\" | \"public-read\";\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<{ key: string; bucket: string; uploadId: string }>;\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<PresignResponse>(`${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<{ key: string; bucket: string; uploadId: string }>(\n `${base}/presign/multipart/complete`,\n payload,\n );\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"]}
|
|
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","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
CHANGED
|
@@ -6,6 +6,8 @@ export type UploadHookContext = HookContext & {
|
|
|
6
6
|
key: string;
|
|
7
7
|
bucket: string;
|
|
8
8
|
contentType?: string;
|
|
9
|
+
/** Declared byte size of the file the client intends to upload. */
|
|
10
|
+
fileSize?: number;
|
|
9
11
|
metadata?: Record<string, string>;
|
|
10
12
|
acl?: "private" | "public-read";
|
|
11
13
|
};
|
|
@@ -37,55 +39,141 @@ export type DeleteHookContext = HookContext & {
|
|
|
37
39
|
export type MultipartHookContext = HookContext & {
|
|
38
40
|
key: string;
|
|
39
41
|
bucket: string;
|
|
42
|
+
/**
|
|
43
|
+
* Declared byte size of the file — available during `init` only.
|
|
44
|
+
* Undefined during `part`, `complete`, and `abort` operations.
|
|
45
|
+
*/
|
|
46
|
+
fileSize?: number;
|
|
40
47
|
};
|
|
41
48
|
export type MultipartInitSuccessContext = MultipartHookContext & {
|
|
42
49
|
uploadId: string;
|
|
43
50
|
contentType?: string;
|
|
51
|
+
/** Declared byte size of the file (as provided by the client). */
|
|
52
|
+
fileSize?: number;
|
|
44
53
|
metadata?: Record<string, string>;
|
|
45
54
|
acl?: "private" | "public-read";
|
|
46
55
|
};
|
|
47
56
|
export type MultipartCompleteSuccessContext = MultipartHookContext & {
|
|
48
57
|
uploadId: string;
|
|
58
|
+
contentLength: number;
|
|
59
|
+
contentType?: string;
|
|
60
|
+
eTag?: string;
|
|
49
61
|
};
|
|
50
62
|
export type S3ServerHooks = {
|
|
51
|
-
/**
|
|
63
|
+
/**
|
|
64
|
+
* Runs before every request. Throw to reject (`403` by default).
|
|
65
|
+
*/
|
|
52
66
|
guard?: (context: HookContext) => Promise<void> | void;
|
|
53
67
|
upload?: {
|
|
54
|
-
/**
|
|
68
|
+
/**
|
|
69
|
+
* Runs before the presigned URL is generated.
|
|
70
|
+
* `fileSize` is client-declared — treat as untrusted.
|
|
71
|
+
* Throw to reject (`403` by default).
|
|
72
|
+
*/
|
|
55
73
|
guard?: (context: UploadHookContext) => Promise<void> | void;
|
|
56
|
-
/**
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
74
|
+
/**
|
|
75
|
+
* Fires after the presigned URL is issued. The file has not been uploaded yet.
|
|
76
|
+
*/
|
|
77
|
+
onPresigned?: (context: UploadSuccessContext) => Promise<void> | void;
|
|
78
|
+
/**
|
|
79
|
+
* Fires after `POST /presign/upload/confirm`. The server verifies the object via
|
|
80
|
+
* `HeadObject`, so `contentLength` and `eTag` are the actual S3 values.
|
|
81
|
+
*/
|
|
82
|
+
onUploaded?: (context: UploadCompleteContext) => Promise<void> | void;
|
|
60
83
|
};
|
|
61
84
|
download?: {
|
|
62
|
-
/**
|
|
85
|
+
/**
|
|
86
|
+
* Runs before the presigned download URL is generated.
|
|
87
|
+
* Throw to reject (`403` by default).
|
|
88
|
+
*/
|
|
63
89
|
guard?: (context: DownloadHookContext) => Promise<void> | void;
|
|
64
|
-
/**
|
|
65
|
-
|
|
90
|
+
/**
|
|
91
|
+
* Fires after the presigned download URL is issued. The file has not been downloaded yet.
|
|
92
|
+
*/
|
|
93
|
+
onPresigned?: (context: DownloadSuccessContext) => Promise<void> | void;
|
|
66
94
|
};
|
|
67
95
|
delete?: {
|
|
68
|
-
/**
|
|
96
|
+
/**
|
|
97
|
+
* Runs before the object is deleted from S3.
|
|
98
|
+
* Throw to reject (`403` by default).
|
|
99
|
+
*/
|
|
69
100
|
guard?: (context: DeleteHookContext) => Promise<void> | void;
|
|
70
|
-
/**
|
|
71
|
-
|
|
101
|
+
/**
|
|
102
|
+
* Fires after the object is successfully deleted from S3.
|
|
103
|
+
*/
|
|
104
|
+
onDeleted?: (context: DeleteHookContext) => Promise<void> | void;
|
|
72
105
|
};
|
|
73
106
|
multipart?: {
|
|
74
|
-
/**
|
|
107
|
+
/**
|
|
108
|
+
* Runs before every multipart operation (`init`, `part`, `complete`, `abort`).
|
|
109
|
+
* `fileSize` is only present during `init`.
|
|
110
|
+
* Throw to reject (`403` by default).
|
|
111
|
+
*/
|
|
75
112
|
guard?: (context: MultipartHookContext) => Promise<void> | void;
|
|
76
|
-
/**
|
|
113
|
+
/**
|
|
114
|
+
* Fires after `CreateMultipartUpload`. Use to record the pending session in your database.
|
|
115
|
+
*/
|
|
77
116
|
onInit?: (context: MultipartInitSuccessContext) => Promise<void> | void;
|
|
78
|
-
/**
|
|
117
|
+
/**
|
|
118
|
+
* Fires after `CompleteMultipartUpload`. The server runs `HeadObject` first,
|
|
119
|
+
* so `contentLength` and `eTag` are the actual S3 values.
|
|
120
|
+
*/
|
|
79
121
|
onComplete?: (context: MultipartCompleteSuccessContext) => Promise<void> | void;
|
|
80
|
-
/**
|
|
122
|
+
/**
|
|
123
|
+
* Fires after `AbortMultipartUpload`. S3 releases all stored parts on success.
|
|
124
|
+
*/
|
|
81
125
|
onAbort?: (context: MultipartHookContext & {
|
|
82
126
|
uploadId: string;
|
|
83
127
|
}) => Promise<void> | void;
|
|
84
128
|
};
|
|
85
129
|
};
|
|
130
|
+
export type S3Features = {
|
|
131
|
+
/**
|
|
132
|
+
* Enable presigned upload endpoints (`POST /presign/upload` and
|
|
133
|
+
* `POST /presign/upload/confirm`).
|
|
134
|
+
* @default false
|
|
135
|
+
*/
|
|
136
|
+
upload?: boolean;
|
|
137
|
+
/**
|
|
138
|
+
* Enable the presigned download endpoint (`GET /presign/download`).
|
|
139
|
+
* @default false
|
|
140
|
+
*/
|
|
141
|
+
download?: boolean;
|
|
142
|
+
/**
|
|
143
|
+
* Enable the delete endpoint (`DELETE /delete`).
|
|
144
|
+
* @default false
|
|
145
|
+
*/
|
|
146
|
+
delete?: boolean;
|
|
147
|
+
/**
|
|
148
|
+
* Enable all multipart upload endpoints (`/presign/multipart/*`).
|
|
149
|
+
* Keep disabled unless you explicitly need multipart support — see the
|
|
150
|
+
* multipart cost-attack section in the README.
|
|
151
|
+
* @default false
|
|
152
|
+
*/
|
|
153
|
+
multipart?: boolean;
|
|
154
|
+
};
|
|
86
155
|
export type S3HandlerConfig = {
|
|
156
|
+
/** The S3 client instance used to communicate with your bucket. */
|
|
87
157
|
s3: S3Client;
|
|
158
|
+
/** Default bucket used when no `bucket` is specified in the request payload. */
|
|
88
159
|
defaultBucket: string;
|
|
160
|
+
/**
|
|
161
|
+
* Controls which API endpoints are active.
|
|
162
|
+
* **All features are disabled by default** — you must opt in to each one.
|
|
163
|
+
*
|
|
164
|
+
* ```ts
|
|
165
|
+
* features: { upload: true, download: true, delete: true }
|
|
166
|
+
* // multipart stays off unless you explicitly enable it
|
|
167
|
+
* ```
|
|
168
|
+
*/
|
|
169
|
+
features: S3Features;
|
|
170
|
+
/**
|
|
171
|
+
* Maximum file size in bytes. If set and the client declares a `fileSize` that
|
|
172
|
+
* exceeds this value, the request is rejected before any presigned URL is
|
|
173
|
+
* generated. Applies to both simple upload and multipart init.
|
|
174
|
+
*/
|
|
175
|
+
maxFileSize?: number;
|
|
176
|
+
/** Optional lifecycle hooks for authentication, logging, and side effects. */
|
|
89
177
|
hooks?: S3ServerHooks;
|
|
90
178
|
};
|
|
91
179
|
export type S3RouteHandlerConfig = S3HandlerConfig & {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@better-s3/server",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.1.0",
|
|
4
4
|
"description": "Framework-agnostic S3 server handlers — presigned uploads, downloads, deletes, and multipart operations",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"s3",
|
|
@@ -38,6 +38,7 @@
|
|
|
38
38
|
"dist"
|
|
39
39
|
],
|
|
40
40
|
"dependencies": {
|
|
41
|
+
"@aws-sdk/s3-presigned-post": "^3.1032.0",
|
|
41
42
|
"@aws-sdk/s3-request-presigner": "^3.1032.0"
|
|
42
43
|
},
|
|
43
44
|
"peerDependencies": {
|
|
@@ -45,6 +46,7 @@
|
|
|
45
46
|
},
|
|
46
47
|
"devDependencies": {
|
|
47
48
|
"@aws-sdk/client-s3": "^3.1032.0",
|
|
49
|
+
"@aws-sdk/s3-presigned-post": "^3.1032.0",
|
|
48
50
|
"@aws-sdk/s3-request-presigner": "^3.1029.0",
|
|
49
51
|
"tsup": "^8.5.1",
|
|
50
52
|
"typescript": "^6.0.3"
|