@puzzle-ui/media-cloudflare 0.0.0-stage → 0.17.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 +71 -2
- package/ai/instructions.md +20 -0
- package/ai/manifest.json +10 -0
- package/dist/LICENSE +21 -0
- package/dist/bucket-provisioner.cjs +37 -0
- package/dist/bucket-provisioner.cjs.map +1 -0
- package/dist/bucket-provisioner.d.cts +16 -0
- package/dist/bucket-provisioner.d.ts +16 -0
- package/dist/bucket-provisioner.js +37 -0
- package/dist/bucket-provisioner.js.map +1 -0
- package/dist/errors.cjs +35 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.cts +17 -0
- package/dist/errors.d.ts +17 -0
- package/dist/errors.js +32 -0
- package/dist/errors.js.map +1 -0
- package/dist/images-processor.cjs +100 -0
- package/dist/images-processor.cjs.map +1 -0
- package/dist/images-processor.d.cts +15 -0
- package/dist/images-processor.d.ts +15 -0
- package/dist/images-processor.js +100 -0
- package/dist/images-processor.js.map +1 -0
- package/dist/index.cjs +28 -0
- package/dist/index.d.cts +9 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.js +8 -0
- package/dist/metadata-store.cjs +69 -0
- package/dist/metadata-store.cjs.map +1 -0
- package/dist/metadata-store.d.cts +23 -0
- package/dist/metadata-store.d.ts +23 -0
- package/dist/metadata-store.js +69 -0
- package/dist/metadata-store.js.map +1 -0
- package/dist/r2-adapter.cjs +393 -0
- package/dist/r2-adapter.cjs.map +1 -0
- package/dist/r2-adapter.d.cts +40 -0
- package/dist/r2-adapter.d.ts +40 -0
- package/dist/r2-adapter.js +393 -0
- package/dist/r2-adapter.js.map +1 -0
- package/dist/s3-signer.cjs +106 -0
- package/dist/s3-signer.cjs.map +1 -0
- package/dist/s3-signer.d.cts +20 -0
- package/dist/s3-signer.d.ts +20 -0
- package/dist/s3-signer.js +105 -0
- package/dist/s3-signer.js.map +1 -0
- package/dist/types.d.cts +212 -0
- package/dist/types.d.ts +212 -0
- package/dist/utils.cjs +59 -0
- package/dist/utils.cjs.map +1 -0
- package/dist/utils.d.cts +10 -0
- package/dist/utils.d.ts +10 -0
- package/dist/utils.js +51 -0
- package/dist/utils.js.map +1 -0
- package/package.json +59 -4
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
import { CloudflareMediaConfigurationError, CloudflareMediaProviderError } from "./errors.js";
|
|
2
|
+
import { checksumEquals, createTenantObjectKey, cursorForObject, normalizeReference, sha256, validateExpiry, validatePositiveInteger, validateTenantId, validateUploadConstraints } from "./utils.js";
|
|
3
|
+
import { MediaAssetConflictError, MediaChecksumMismatchError, MediaNotFoundError, MediaObjectStorageError, MediaUploadExpiredError } from "@puzzle-ui/media";
|
|
4
|
+
// src/r2-adapter.ts
|
|
5
|
+
const defaultMaxTtl = 9e5;
|
|
6
|
+
const defaultPageSize = 1e3;
|
|
7
|
+
const asTarget = (target, expiresAt) => ({
|
|
8
|
+
url: target.url,
|
|
9
|
+
method: "PUT",
|
|
10
|
+
headers: target.headers ?? {},
|
|
11
|
+
expiresAt
|
|
12
|
+
});
|
|
13
|
+
const providerError = (message, cause) => new CloudflareMediaProviderError(message, cause);
|
|
14
|
+
var CloudflareR2MediaObjectStorageAdapter = class {
|
|
15
|
+
bucketSource;
|
|
16
|
+
metadataStore;
|
|
17
|
+
tenantId;
|
|
18
|
+
bucketName;
|
|
19
|
+
idFactory;
|
|
20
|
+
now;
|
|
21
|
+
maxSignedUrlTtlMs;
|
|
22
|
+
maxListPageSize;
|
|
23
|
+
nextId = 0;
|
|
24
|
+
constructor(options) {
|
|
25
|
+
this.bucketSource = options.bucket;
|
|
26
|
+
this.metadataStore = options.metadataStore;
|
|
27
|
+
this.tenantId = options.tenantId ? validateTenantId(options.tenantId) : void 0;
|
|
28
|
+
this.bucketName = options.bucketName;
|
|
29
|
+
this.now = options.now ?? (() => /* @__PURE__ */ new Date());
|
|
30
|
+
this.maxSignedUrlTtlMs = options.maxSignedUrlTtlMs ?? defaultMaxTtl;
|
|
31
|
+
this.maxListPageSize = options.maxListPageSize ?? defaultPageSize;
|
|
32
|
+
validatePositiveInteger(this.maxSignedUrlTtlMs, "maxSignedUrlTtlMs");
|
|
33
|
+
validatePositiveInteger(this.maxListPageSize, "maxListPageSize");
|
|
34
|
+
this.idFactory = options.idFactory ?? (() => {
|
|
35
|
+
this.nextId += 1;
|
|
36
|
+
return `r2-${this.nextId}`;
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
async createUploadIntent(input) {
|
|
40
|
+
const constraints = this.prepareConstraints(input);
|
|
41
|
+
const id = this.idFactory();
|
|
42
|
+
const expiresAt = this.expiry(constraints.expiresInMs);
|
|
43
|
+
const target = await this.getBucketTarget(constraints.tenantId);
|
|
44
|
+
const key = createTenantObjectKey(constraints.tenantId, id, constraints.fileName, constraints.objectPrefix);
|
|
45
|
+
const signed = await target.signer.signUpload({
|
|
46
|
+
tenantId: constraints.tenantId,
|
|
47
|
+
key,
|
|
48
|
+
contentType: constraints.contentType,
|
|
49
|
+
expiresAt,
|
|
50
|
+
...constraints.expectedSize !== void 0 ? { expectedSize: constraints.expectedSize } : {}
|
|
51
|
+
});
|
|
52
|
+
const uploadTarget = asTarget(signed, expiresAt);
|
|
53
|
+
const session = {
|
|
54
|
+
id,
|
|
55
|
+
tenantId: constraints.tenantId,
|
|
56
|
+
mode: "single",
|
|
57
|
+
state: "pending",
|
|
58
|
+
...constraints.expectedSize !== void 0 ? { expectedSize: constraints.expectedSize } : {},
|
|
59
|
+
...constraints.expectedChecksum ? { expectedChecksum: constraints.expectedChecksum } : {},
|
|
60
|
+
expiresAt,
|
|
61
|
+
uploadTarget: {
|
|
62
|
+
...uploadTarget,
|
|
63
|
+
headers: {
|
|
64
|
+
...uploadTarget.headers,
|
|
65
|
+
"content-type": constraints.contentType
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
};
|
|
69
|
+
await this.metadataStore.saveUpload({
|
|
70
|
+
session,
|
|
71
|
+
tenantId: constraints.tenantId,
|
|
72
|
+
key,
|
|
73
|
+
contentType: constraints.contentType,
|
|
74
|
+
fileName: constraints.fileName
|
|
75
|
+
});
|
|
76
|
+
return session;
|
|
77
|
+
}
|
|
78
|
+
async createMultipartUpload(input) {
|
|
79
|
+
const constraints = this.prepareConstraints(input);
|
|
80
|
+
validatePositiveInteger(input.partSizeBytes, "partSizeBytes");
|
|
81
|
+
const id = this.idFactory();
|
|
82
|
+
const expiresAt = this.expiry(constraints.expiresInMs);
|
|
83
|
+
const target = await this.getBucketTarget(constraints.tenantId);
|
|
84
|
+
if (!target.bucket.createMultipartUpload) throw new CloudflareMediaConfigurationError("The configured R2 bucket does not expose multipart upload support.");
|
|
85
|
+
const key = createTenantObjectKey(constraints.tenantId, id, constraints.fileName, constraints.objectPrefix);
|
|
86
|
+
let multipart;
|
|
87
|
+
try {
|
|
88
|
+
multipart = await target.bucket.createMultipartUpload(key, { httpMetadata: { contentType: constraints.contentType } });
|
|
89
|
+
} catch (error) {
|
|
90
|
+
throw providerError("Unable to create the R2 multipart upload.", error);
|
|
91
|
+
}
|
|
92
|
+
if (!multipart.uploadId) throw new CloudflareMediaConfigurationError("The R2 multipart binding did not return an upload ID.");
|
|
93
|
+
const session = {
|
|
94
|
+
id,
|
|
95
|
+
tenantId: constraints.tenantId,
|
|
96
|
+
mode: "multipart",
|
|
97
|
+
state: "pending",
|
|
98
|
+
...constraints.expectedSize !== void 0 ? { expectedSize: constraints.expectedSize } : {},
|
|
99
|
+
...constraints.expectedChecksum ? { expectedChecksum: constraints.expectedChecksum } : {},
|
|
100
|
+
expiresAt,
|
|
101
|
+
partSizeBytes: input.partSizeBytes
|
|
102
|
+
};
|
|
103
|
+
await this.metadataStore.saveUpload({
|
|
104
|
+
session,
|
|
105
|
+
tenantId: constraints.tenantId,
|
|
106
|
+
key,
|
|
107
|
+
contentType: constraints.contentType,
|
|
108
|
+
fileName: constraints.fileName,
|
|
109
|
+
uploadId: multipart.uploadId,
|
|
110
|
+
partSizeBytes: input.partSizeBytes
|
|
111
|
+
});
|
|
112
|
+
return session;
|
|
113
|
+
}
|
|
114
|
+
async createMultipartPartTargets(sessionId, partNumbers, expiresInMs) {
|
|
115
|
+
const upload = await this.requireUpload(sessionId);
|
|
116
|
+
this.assertPending(upload);
|
|
117
|
+
if (upload.session.mode !== "multipart" || !upload.uploadId || !upload.partSizeBytes) throw new MediaAssetConflictError("The upload session is not multipart.");
|
|
118
|
+
validateExpiry(expiresInMs, "expiresInMs", this.maxSignedUrlTtlMs);
|
|
119
|
+
if (partNumbers.length === 0) throw new MediaObjectStorageError("At least one multipart part target is required.");
|
|
120
|
+
const unique = /* @__PURE__ */ new Set();
|
|
121
|
+
const maxPart = upload.session.expectedSize === void 0 ? Number.MAX_SAFE_INTEGER : Math.ceil(upload.session.expectedSize / upload.partSizeBytes);
|
|
122
|
+
const target = await this.getBucketTarget(upload.tenantId);
|
|
123
|
+
return Promise.all(partNumbers.map(async (partNumber) => {
|
|
124
|
+
if (!Number.isSafeInteger(partNumber) || partNumber < 1 || partNumber > maxPart || unique.has(partNumber)) throw new MediaObjectStorageError("Multipart part numbers must be unique positive integers within the expected upload.");
|
|
125
|
+
unique.add(partNumber);
|
|
126
|
+
const expiresAt = new Date(Math.min(this.now().getTime() + expiresInMs, upload.session.expiresAt.getTime()));
|
|
127
|
+
const signed = await target.signer.signMultipartPart({
|
|
128
|
+
tenantId: upload.tenantId,
|
|
129
|
+
key: upload.key,
|
|
130
|
+
uploadId: upload.uploadId,
|
|
131
|
+
partNumber,
|
|
132
|
+
expiresAt
|
|
133
|
+
});
|
|
134
|
+
return {
|
|
135
|
+
partNumber,
|
|
136
|
+
url: signed.url,
|
|
137
|
+
method: "PUT",
|
|
138
|
+
headers: signed.headers ?? {},
|
|
139
|
+
expiresAt
|
|
140
|
+
};
|
|
141
|
+
}));
|
|
142
|
+
}
|
|
143
|
+
async completeUpload(sessionId, parts) {
|
|
144
|
+
const upload = await this.requireUpload(sessionId);
|
|
145
|
+
if (upload.session.state === "completed") {
|
|
146
|
+
const object = await this.metadataStore.getObject(upload.key, upload.tenantId);
|
|
147
|
+
if (object) return object.object;
|
|
148
|
+
throw new MediaNotFoundError("Completed media object");
|
|
149
|
+
}
|
|
150
|
+
this.assertPending(upload);
|
|
151
|
+
const target = await this.getBucketTarget(upload.tenantId);
|
|
152
|
+
if (upload.session.mode === "multipart") await this.completeMultipart(target.bucket, upload, parts);
|
|
153
|
+
const object = await this.readStoredObject(target.bucket, upload);
|
|
154
|
+
if (upload.session.expectedSize !== void 0 && object.size !== upload.session.expectedSize) throw new MediaObjectStorageError("The uploaded byte count does not match the declared size.", { details: {
|
|
155
|
+
expectedSize: upload.session.expectedSize,
|
|
156
|
+
actualSize: object.size
|
|
157
|
+
} });
|
|
158
|
+
if (upload.session.expectedChecksum && !checksumEquals(object.checksum, upload.session.expectedChecksum)) throw new MediaChecksumMismatchError();
|
|
159
|
+
await this.metadataStore.saveObject({
|
|
160
|
+
key: upload.key,
|
|
161
|
+
object
|
|
162
|
+
});
|
|
163
|
+
await this.metadataStore.updateUpload(sessionId, { session: {
|
|
164
|
+
...upload.session,
|
|
165
|
+
state: "completed"
|
|
166
|
+
} });
|
|
167
|
+
return object;
|
|
168
|
+
}
|
|
169
|
+
async abortUpload(sessionId) {
|
|
170
|
+
const upload = await this.findUpload(sessionId);
|
|
171
|
+
if (!upload || upload.session.state === "completed" || upload.session.state === "aborted") return false;
|
|
172
|
+
const target = await this.getBucketTarget(upload.tenantId);
|
|
173
|
+
if (upload.session.mode === "multipart" && upload.uploadId) {
|
|
174
|
+
const multipart = this.resumeMultipart(target.bucket, upload);
|
|
175
|
+
if (multipart) try {
|
|
176
|
+
await multipart.abort();
|
|
177
|
+
} catch (error) {
|
|
178
|
+
throw providerError("Unable to abort the R2 multipart upload.", error);
|
|
179
|
+
}
|
|
180
|
+
} else await target.bucket.delete(upload.key);
|
|
181
|
+
await this.metadataStore.updateUpload(sessionId, { session: {
|
|
182
|
+
...upload.session,
|
|
183
|
+
state: "aborted"
|
|
184
|
+
} });
|
|
185
|
+
return true;
|
|
186
|
+
}
|
|
187
|
+
async getUploadSession(sessionId) {
|
|
188
|
+
const upload = await this.findUpload(sessionId);
|
|
189
|
+
if (!upload) return null;
|
|
190
|
+
if (upload.session.state === "pending" && upload.session.expiresAt.getTime() <= this.now().getTime()) return (await this.metadataStore.updateUpload(sessionId, { session: {
|
|
191
|
+
...upload.session,
|
|
192
|
+
state: "expired"
|
|
193
|
+
} }))?.session ?? {
|
|
194
|
+
...upload.session,
|
|
195
|
+
state: "expired"
|
|
196
|
+
};
|
|
197
|
+
return upload.session;
|
|
198
|
+
}
|
|
199
|
+
async getObjectMetadata(object) {
|
|
200
|
+
const reference = normalizeReference(object);
|
|
201
|
+
const record = await this.metadataStore.getObject(reference.key, this.tenantId);
|
|
202
|
+
if (!record || record.object.object.versionId !== reference.versionId) return null;
|
|
203
|
+
if (!await (await this.getBucketTarget(record.object.tenantId)).bucket.head(record.key)) return null;
|
|
204
|
+
return record.object;
|
|
205
|
+
}
|
|
206
|
+
async createReadTarget(object, expiresInMs) {
|
|
207
|
+
const reference = normalizeReference(object);
|
|
208
|
+
validateExpiry(expiresInMs, "expiresInMs", this.maxSignedUrlTtlMs);
|
|
209
|
+
const record = await this.metadataStore.getObject(reference.key, this.tenantId);
|
|
210
|
+
if (!record || record.object.object.versionId !== reference.versionId) throw new MediaNotFoundError("Media object");
|
|
211
|
+
const target = await this.getBucketTarget(record.object.tenantId);
|
|
212
|
+
if (!await target.bucket.head(record.key)) throw new MediaNotFoundError("Media object");
|
|
213
|
+
const expiresAt = this.expiry(expiresInMs);
|
|
214
|
+
return {
|
|
215
|
+
url: (await target.signer.signRead({
|
|
216
|
+
tenantId: record.object.tenantId,
|
|
217
|
+
key: record.key,
|
|
218
|
+
expiresAt
|
|
219
|
+
})).url,
|
|
220
|
+
expiresAt
|
|
221
|
+
};
|
|
222
|
+
}
|
|
223
|
+
async deleteObject(object) {
|
|
224
|
+
const reference = normalizeReference(object);
|
|
225
|
+
const record = await this.metadataStore.getObject(reference.key, this.tenantId);
|
|
226
|
+
if (!record || record.object.object.versionId !== reference.versionId) return false;
|
|
227
|
+
const target = await this.getBucketTarget(record.object.tenantId);
|
|
228
|
+
try {
|
|
229
|
+
await target.bucket.delete(record.key);
|
|
230
|
+
} catch (error) {
|
|
231
|
+
throw providerError("Unable to delete the R2 object.", error);
|
|
232
|
+
}
|
|
233
|
+
return this.metadataStore.deleteObject(record.key, record.object.tenantId);
|
|
234
|
+
}
|
|
235
|
+
async listObjects(input) {
|
|
236
|
+
validatePositiveInteger(input.first, "first");
|
|
237
|
+
if (input.first > this.maxListPageSize) throw new MediaObjectStorageError("Object list page exceeds the configured limit.");
|
|
238
|
+
if (input.olderThan && !Number.isFinite(input.olderThan.getTime())) throw new MediaObjectStorageError("olderThan must be a valid date.");
|
|
239
|
+
const records = await this.metadataStore.listObjects({
|
|
240
|
+
first: input.first + 1,
|
|
241
|
+
...input.cursor ? { cursor: decodeCursor(input.cursor) } : {},
|
|
242
|
+
...input.olderThan ? { olderThan: input.olderThan } : {},
|
|
243
|
+
...this.tenantId ? { tenantId: this.tenantId } : {}
|
|
244
|
+
});
|
|
245
|
+
const pageRecords = records.slice(0, input.first);
|
|
246
|
+
return {
|
|
247
|
+
items: pageRecords.map((record) => ({
|
|
248
|
+
object: record.object.object,
|
|
249
|
+
tenantId: record.object.tenantId,
|
|
250
|
+
size: record.object.size,
|
|
251
|
+
mimeType: record.object.mimeType,
|
|
252
|
+
...record.object.checksum ? { checksum: record.object.checksum } : {},
|
|
253
|
+
createdAt: record.object.createdAt
|
|
254
|
+
})),
|
|
255
|
+
nextCursor: records.length > input.first && pageRecords.at(-1) ? cursorForObject(pageRecords.at(-1).key) : null
|
|
256
|
+
};
|
|
257
|
+
}
|
|
258
|
+
async listExpiredUploadSessions(before, first) {
|
|
259
|
+
if (!Number.isFinite(before.getTime())) throw new MediaObjectStorageError("before must be a valid date.");
|
|
260
|
+
validatePositiveInteger(first, "first");
|
|
261
|
+
if (first > this.maxListPageSize) throw new MediaObjectStorageError("Expired upload page exceeds the configured limit.");
|
|
262
|
+
return (await this.metadataStore.listExpiredUploads(before, first, this.tenantId)).map((record) => record.session);
|
|
263
|
+
}
|
|
264
|
+
/** Test/local-development helper that bypasses presigned HTTP delivery. */
|
|
265
|
+
async putForTesting(sessionId, bytes, contentType) {
|
|
266
|
+
const upload = await this.requireUpload(sessionId);
|
|
267
|
+
this.assertPending(upload);
|
|
268
|
+
if (upload.session.mode !== "single") throw new MediaAssetConflictError("The upload session is multipart.");
|
|
269
|
+
await (await this.getBucketTarget(upload.tenantId)).bucket.put(upload.key, bytes, { httpMetadata: { contentType: contentType.toLowerCase() } });
|
|
270
|
+
}
|
|
271
|
+
/** Test/local-development helper that bypasses presigned HTTP delivery. */
|
|
272
|
+
async putPartForTesting(sessionId, partNumber, bytes) {
|
|
273
|
+
const upload = await this.requireUpload(sessionId);
|
|
274
|
+
this.assertPending(upload);
|
|
275
|
+
if (upload.session.mode !== "multipart" || !upload.uploadId) throw new MediaAssetConflictError("The upload session is not multipart.");
|
|
276
|
+
const target = await this.getBucketTarget(upload.tenantId);
|
|
277
|
+
const multipart = this.resumeMultipart(target.bucket, upload);
|
|
278
|
+
if (!multipart) throw new CloudflareMediaConfigurationError("The configured R2 bucket cannot resume multipart uploads.");
|
|
279
|
+
if (!Number.isSafeInteger(partNumber) || partNumber < 1) throw new MediaObjectStorageError("partNumber must be a positive safe integer.");
|
|
280
|
+
return {
|
|
281
|
+
partNumber,
|
|
282
|
+
etag: (await multipart.uploadPart(partNumber, bytes)).etag
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
prepareConstraints(input) {
|
|
286
|
+
const constraints = validateUploadConstraints(input);
|
|
287
|
+
if (this.tenantId && constraints.tenantId !== this.tenantId) throw new MediaObjectStorageError("The upload tenant is outside this adapter scope.");
|
|
288
|
+
validateExpiry(constraints.expiresInMs, "expiresInMs", this.maxSignedUrlTtlMs);
|
|
289
|
+
return constraints;
|
|
290
|
+
}
|
|
291
|
+
expiry(ttl) {
|
|
292
|
+
return new Date(this.now().getTime() + ttl);
|
|
293
|
+
}
|
|
294
|
+
async getBucketTarget(tenantId) {
|
|
295
|
+
const source = this.bucketSource;
|
|
296
|
+
if (typeof source === "function") return source({
|
|
297
|
+
tenantId,
|
|
298
|
+
...this.bucketName ? { bucketName: this.bucketName } : {}
|
|
299
|
+
});
|
|
300
|
+
if ("resolve" in source) return source.resolve({
|
|
301
|
+
tenantId,
|
|
302
|
+
...this.bucketName ? { bucketName: this.bucketName } : {}
|
|
303
|
+
});
|
|
304
|
+
return source;
|
|
305
|
+
}
|
|
306
|
+
async findUpload(sessionId) {
|
|
307
|
+
const record = await this.metadataStore.getUpload(sessionId);
|
|
308
|
+
if (!record || this.tenantId && record.tenantId !== this.tenantId) return null;
|
|
309
|
+
return record;
|
|
310
|
+
}
|
|
311
|
+
async requireUpload(sessionId) {
|
|
312
|
+
const upload = await this.findUpload(sessionId);
|
|
313
|
+
if (!upload) throw new MediaNotFoundError("Upload session");
|
|
314
|
+
return upload;
|
|
315
|
+
}
|
|
316
|
+
assertPending(upload) {
|
|
317
|
+
if (upload.session.state === "completed") throw new MediaAssetConflictError("The upload session is already completed.");
|
|
318
|
+
if (upload.session.state === "aborted") throw new MediaAssetConflictError("The upload session has been aborted.");
|
|
319
|
+
if (upload.session.state === "expired" || upload.session.expiresAt.getTime() <= this.now().getTime()) {
|
|
320
|
+
this.metadataStore.updateUpload(upload.session.id, { session: {
|
|
321
|
+
...upload.session,
|
|
322
|
+
state: "expired"
|
|
323
|
+
} });
|
|
324
|
+
throw new MediaUploadExpiredError();
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
resumeMultipart(bucket, upload) {
|
|
328
|
+
if (!upload.uploadId || !bucket.resumeMultipartUpload) return null;
|
|
329
|
+
return bucket.resumeMultipartUpload(upload.key, upload.uploadId);
|
|
330
|
+
}
|
|
331
|
+
async completeMultipart(bucket, upload, parts) {
|
|
332
|
+
const multipart = this.resumeMultipart(bucket, upload);
|
|
333
|
+
if (!multipart) throw new CloudflareMediaConfigurationError("The configured R2 bucket cannot resume multipart uploads.");
|
|
334
|
+
let completed = parts;
|
|
335
|
+
if (!completed && multipart.listParts) completed = await multipart.listParts();
|
|
336
|
+
if (!completed || completed.length === 0) throw new MediaAssetConflictError("Multipart completion requires uploaded parts.");
|
|
337
|
+
const seen = /* @__PURE__ */ new Set();
|
|
338
|
+
const normalized = [...completed].sort((left, right) => left.partNumber - right.partNumber).map((part) => {
|
|
339
|
+
if (!Number.isSafeInteger(part.partNumber) || part.partNumber < 1 || seen.has(part.partNumber) || typeof part.etag !== "string" || part.etag.trim() === "") throw new MediaObjectStorageError("Multipart parts must have unique numbers and ETags.");
|
|
340
|
+
seen.add(part.partNumber);
|
|
341
|
+
return {
|
|
342
|
+
partNumber: part.partNumber,
|
|
343
|
+
etag: part.etag
|
|
344
|
+
};
|
|
345
|
+
});
|
|
346
|
+
try {
|
|
347
|
+
await multipart.complete(normalized);
|
|
348
|
+
} catch (error) {
|
|
349
|
+
throw providerError("Unable to complete the R2 multipart upload.", error);
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
async readStoredObject(bucket, upload) {
|
|
353
|
+
let head;
|
|
354
|
+
try {
|
|
355
|
+
head = await bucket.head(upload.key);
|
|
356
|
+
} catch (error) {
|
|
357
|
+
throw providerError("Unable to read R2 object metadata.", error);
|
|
358
|
+
}
|
|
359
|
+
if (!head) throw new MediaNotFoundError("Uploaded media object");
|
|
360
|
+
let body;
|
|
361
|
+
try {
|
|
362
|
+
const object = await bucket.get(upload.key);
|
|
363
|
+
if (!object) throw new MediaNotFoundError("Uploaded media object");
|
|
364
|
+
body = new Uint8Array(await object.arrayBuffer());
|
|
365
|
+
} catch (error) {
|
|
366
|
+
if (error instanceof MediaNotFoundError) throw error;
|
|
367
|
+
throw providerError("Unable to read the uploaded R2 object.", error);
|
|
368
|
+
}
|
|
369
|
+
if (head.size !== body.byteLength) throw new MediaObjectStorageError("The R2 metadata size does not match the downloaded object.", { details: {
|
|
370
|
+
metadataSize: head.size,
|
|
371
|
+
actualSize: body.byteLength
|
|
372
|
+
} });
|
|
373
|
+
const checksum = await sha256(body);
|
|
374
|
+
return {
|
|
375
|
+
object: { key: upload.key },
|
|
376
|
+
tenantId: upload.tenantId,
|
|
377
|
+
mimeType: (head.httpMetadata?.contentType ?? upload.contentType).toLowerCase(),
|
|
378
|
+
size: body.byteLength,
|
|
379
|
+
checksum,
|
|
380
|
+
createdAt: head.uploaded ?? this.now()
|
|
381
|
+
};
|
|
382
|
+
}
|
|
383
|
+
};
|
|
384
|
+
const decodeCursor = (cursor) => {
|
|
385
|
+
try {
|
|
386
|
+
return decodeURIComponent(cursor);
|
|
387
|
+
} catch {
|
|
388
|
+
throw new MediaObjectStorageError("Object list cursor is invalid.");
|
|
389
|
+
}
|
|
390
|
+
};
|
|
391
|
+
export { CloudflareR2MediaObjectStorageAdapter };
|
|
392
|
+
|
|
393
|
+
//# sourceMappingURL=r2-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"r2-adapter.js","names":[],"sources":["../src/r2-adapter.ts"],"sourcesContent":["import {\n MediaAssetConflictError,\n MediaChecksumMismatchError,\n MediaNotFoundError,\n MediaObjectStorageError,\n MediaUploadExpiredError,\n type MediaMultipartCompletedPart,\n type MediaMultipartPartTarget,\n type MediaObjectListInput,\n type MediaObjectPage,\n type MediaObjectReference,\n type MediaObjectStorageAdapter,\n type MediaReadTarget,\n type MediaStoredObject,\n type MediaUploadConstraints,\n type MediaUploadSession,\n} from \"@puzzle-ui/media\";\nimport {\n CloudflareMediaConfigurationError,\n CloudflareMediaProviderError,\n} from \"./errors\";\nimport type {\n CloudflareMediaBucketTarget,\n CloudflareMediaMetadataStore,\n CloudflareR2MediaObjectStorageOptions,\n CloudflareUploadRecord,\n R2BucketLike,\n R2MultipartPart,\n R2MultipartUploadLike,\n} from \"./types\";\nimport {\n checksumEquals,\n createTenantObjectKey,\n cursorForObject,\n normalizeReference,\n sha256,\n validateExpiry,\n validatePositiveInteger,\n validateTenantId,\n validateUploadConstraints,\n} from \"./utils\";\n\ntype UploadRecord = CloudflareUploadRecord;\n\nconst defaultMaxTtl = 15 * 60 * 1000;\nconst defaultPageSize = 1000;\n\nconst asTarget = (\n target: Awaited<ReturnType<CloudflareMediaBucketTarget[\"signer\"][\"signUpload\"]>>,\n expiresAt: Date,\n): {\n readonly url: string;\n readonly method: \"PUT\";\n readonly headers: Readonly<Record<string, string>>;\n readonly expiresAt: Date;\n} => ({\n url: target.url,\n method: \"PUT\",\n headers: target.headers ?? {},\n expiresAt,\n});\n\nconst providerError = (message: string, cause: unknown): CloudflareMediaProviderError =>\n new CloudflareMediaProviderError(message, cause);\n\nexport class CloudflareR2MediaObjectStorageAdapter\n implements MediaObjectStorageAdapter\n{\n private readonly bucketSource: CloudflareR2MediaObjectStorageOptions[\"bucket\"];\n private readonly metadataStore: CloudflareMediaMetadataStore;\n private readonly tenantId?: string;\n private readonly bucketName?: string;\n private readonly idFactory: () => string;\n private readonly now: () => Date;\n private readonly maxSignedUrlTtlMs: number;\n private readonly maxListPageSize: number;\n private nextId = 0;\n\n constructor(options: CloudflareR2MediaObjectStorageOptions) {\n this.bucketSource = options.bucket;\n this.metadataStore = options.metadataStore;\n this.tenantId = options.tenantId ? validateTenantId(options.tenantId) : undefined;\n this.bucketName = options.bucketName;\n this.now = options.now ?? (() => new Date());\n this.maxSignedUrlTtlMs = options.maxSignedUrlTtlMs ?? defaultMaxTtl;\n this.maxListPageSize = options.maxListPageSize ?? defaultPageSize;\n validatePositiveInteger(this.maxSignedUrlTtlMs, \"maxSignedUrlTtlMs\");\n validatePositiveInteger(this.maxListPageSize, \"maxListPageSize\");\n this.idFactory =\n options.idFactory ??\n (() => {\n this.nextId += 1;\n return `r2-${this.nextId}`;\n });\n }\n\n async createUploadIntent(input: MediaUploadConstraints): Promise<MediaUploadSession> {\n const constraints = this.prepareConstraints(input);\n const id = this.idFactory();\n const expiresAt = this.expiry(constraints.expiresInMs);\n const target = await this.getBucketTarget(constraints.tenantId);\n const key = createTenantObjectKey(\n constraints.tenantId,\n id,\n constraints.fileName,\n constraints.objectPrefix,\n );\n const signed = await target.signer.signUpload({\n tenantId: constraints.tenantId,\n key,\n contentType: constraints.contentType,\n expiresAt,\n ...(constraints.expectedSize !== undefined\n ? { expectedSize: constraints.expectedSize }\n : {}),\n });\n const uploadTarget = asTarget(signed, expiresAt);\n const session: MediaUploadSession = {\n id,\n tenantId: constraints.tenantId,\n mode: \"single\",\n state: \"pending\",\n ...(constraints.expectedSize !== undefined\n ? { expectedSize: constraints.expectedSize }\n : {}),\n ...(constraints.expectedChecksum\n ? { expectedChecksum: constraints.expectedChecksum }\n : {}),\n expiresAt,\n uploadTarget: {\n ...uploadTarget,\n headers: {\n ...uploadTarget.headers,\n \"content-type\": constraints.contentType,\n },\n },\n };\n await this.metadataStore.saveUpload({\n session,\n tenantId: constraints.tenantId,\n key,\n contentType: constraints.contentType,\n fileName: constraints.fileName,\n });\n return session;\n }\n\n async createMultipartUpload(\n input: MediaUploadConstraints & { readonly partSizeBytes: number },\n ): Promise<MediaUploadSession> {\n const constraints = this.prepareConstraints(input);\n validatePositiveInteger(input.partSizeBytes, \"partSizeBytes\");\n const id = this.idFactory();\n const expiresAt = this.expiry(constraints.expiresInMs);\n const target = await this.getBucketTarget(constraints.tenantId);\n if (!target.bucket.createMultipartUpload) {\n throw new CloudflareMediaConfigurationError(\n \"The configured R2 bucket does not expose multipart upload support.\",\n );\n }\n const key = createTenantObjectKey(\n constraints.tenantId,\n id,\n constraints.fileName,\n constraints.objectPrefix,\n );\n let multipart: R2MultipartUploadLike;\n try {\n multipart = await target.bucket.createMultipartUpload(key, {\n httpMetadata: { contentType: constraints.contentType },\n });\n } catch (error) {\n throw providerError(\"Unable to create the R2 multipart upload.\", error);\n }\n if (!multipart.uploadId) {\n throw new CloudflareMediaConfigurationError(\n \"The R2 multipart binding did not return an upload ID.\",\n );\n }\n const session: MediaUploadSession = {\n id,\n tenantId: constraints.tenantId,\n mode: \"multipart\",\n state: \"pending\",\n ...(constraints.expectedSize !== undefined\n ? { expectedSize: constraints.expectedSize }\n : {}),\n ...(constraints.expectedChecksum\n ? { expectedChecksum: constraints.expectedChecksum }\n : {}),\n expiresAt,\n partSizeBytes: input.partSizeBytes,\n };\n await this.metadataStore.saveUpload({\n session,\n tenantId: constraints.tenantId,\n key,\n contentType: constraints.contentType,\n fileName: constraints.fileName,\n uploadId: multipart.uploadId,\n partSizeBytes: input.partSizeBytes,\n });\n return session;\n }\n\n async createMultipartPartTargets(\n sessionId: string,\n partNumbers: readonly number[],\n expiresInMs: number,\n ): Promise<readonly MediaMultipartPartTarget[]> {\n const upload = await this.requireUpload(sessionId);\n this.assertPending(upload);\n if (upload.session.mode !== \"multipart\" || !upload.uploadId || !upload.partSizeBytes) {\n throw new MediaAssetConflictError(\"The upload session is not multipart.\");\n }\n validateExpiry(expiresInMs, \"expiresInMs\", this.maxSignedUrlTtlMs);\n if (partNumbers.length === 0) {\n throw new MediaObjectStorageError(\"At least one multipart part target is required.\");\n }\n const unique = new Set<number>();\n const maxPart =\n upload.session.expectedSize === undefined\n ? Number.MAX_SAFE_INTEGER\n : Math.ceil(upload.session.expectedSize / upload.partSizeBytes);\n const target = await this.getBucketTarget(upload.tenantId);\n return Promise.all(\n partNumbers.map(async (partNumber) => {\n if (\n !Number.isSafeInteger(partNumber) ||\n partNumber < 1 ||\n partNumber > maxPart ||\n unique.has(partNumber)\n ) {\n throw new MediaObjectStorageError(\n \"Multipart part numbers must be unique positive integers within the expected upload.\",\n );\n }\n unique.add(partNumber);\n const expiresAt = new Date(\n Math.min(this.now().getTime() + expiresInMs, upload.session.expiresAt.getTime()),\n );\n const signed = await target.signer.signMultipartPart({\n tenantId: upload.tenantId,\n key: upload.key,\n uploadId: upload.uploadId!,\n partNumber,\n expiresAt,\n });\n return {\n partNumber,\n url: signed.url,\n method: \"PUT\" as const,\n headers: signed.headers ?? {},\n expiresAt,\n };\n }),\n );\n }\n\n async completeUpload(\n sessionId: string,\n parts?: readonly MediaMultipartCompletedPart[],\n ): Promise<MediaStoredObject> {\n const upload = await this.requireUpload(sessionId);\n if (upload.session.state === \"completed\") {\n const object = await this.metadataStore.getObject(upload.key, upload.tenantId);\n if (object) return object.object;\n throw new MediaNotFoundError(\"Completed media object\");\n }\n this.assertPending(upload);\n const target = await this.getBucketTarget(upload.tenantId);\n if (upload.session.mode === \"multipart\") {\n await this.completeMultipart(target.bucket, upload, parts);\n }\n const object = await this.readStoredObject(target.bucket, upload);\n if (\n upload.session.expectedSize !== undefined &&\n object.size !== upload.session.expectedSize\n ) {\n throw new MediaObjectStorageError(\n \"The uploaded byte count does not match the declared size.\",\n {\n details: {\n expectedSize: upload.session.expectedSize,\n actualSize: object.size,\n },\n },\n );\n }\n if (\n upload.session.expectedChecksum &&\n !checksumEquals(object.checksum!, upload.session.expectedChecksum)\n ) {\n throw new MediaChecksumMismatchError();\n }\n await this.metadataStore.saveObject({ key: upload.key, object });\n await this.metadataStore.updateUpload(sessionId, {\n session: { ...upload.session, state: \"completed\" },\n });\n return object;\n }\n\n async abortUpload(sessionId: string): Promise<boolean> {\n const upload = await this.findUpload(sessionId);\n if (\n !upload ||\n upload.session.state === \"completed\" ||\n upload.session.state === \"aborted\"\n ) {\n return false;\n }\n const target = await this.getBucketTarget(upload.tenantId);\n if (upload.session.mode === \"multipart\" && upload.uploadId) {\n const multipart = this.resumeMultipart(target.bucket, upload);\n if (multipart) {\n try {\n await multipart.abort();\n } catch (error) {\n throw providerError(\"Unable to abort the R2 multipart upload.\", error);\n }\n }\n } else {\n await target.bucket.delete(upload.key);\n }\n await this.metadataStore.updateUpload(sessionId, {\n session: { ...upload.session, state: \"aborted\" },\n });\n return true;\n }\n\n async getUploadSession(sessionId: string): Promise<MediaUploadSession | null> {\n const upload = await this.findUpload(sessionId);\n if (!upload) return null;\n if (\n upload.session.state === \"pending\" &&\n upload.session.expiresAt.getTime() <= this.now().getTime()\n ) {\n const updated = await this.metadataStore.updateUpload(sessionId, {\n session: { ...upload.session, state: \"expired\" },\n });\n return updated?.session ?? { ...upload.session, state: \"expired\" };\n }\n return upload.session;\n }\n\n async getObjectMetadata(\n object: MediaObjectReference,\n ): Promise<MediaStoredObject | null> {\n const reference = normalizeReference(object);\n const record = await this.metadataStore.getObject(reference.key, this.tenantId);\n if (!record || record.object.object.versionId !== reference.versionId) return null;\n const target = await this.getBucketTarget(record.object.tenantId);\n if (!(await target.bucket.head(record.key))) return null;\n return record.object;\n }\n\n async createReadTarget(\n object: MediaObjectReference,\n expiresInMs: number,\n ): Promise<MediaReadTarget> {\n const reference = normalizeReference(object);\n validateExpiry(expiresInMs, \"expiresInMs\", this.maxSignedUrlTtlMs);\n const record = await this.metadataStore.getObject(reference.key, this.tenantId);\n if (!record || record.object.object.versionId !== reference.versionId) {\n throw new MediaNotFoundError(\"Media object\");\n }\n const target = await this.getBucketTarget(record.object.tenantId);\n if (!(await target.bucket.head(record.key))) {\n throw new MediaNotFoundError(\"Media object\");\n }\n const expiresAt = this.expiry(expiresInMs);\n const signed = await target.signer.signRead({\n tenantId: record.object.tenantId,\n key: record.key,\n expiresAt,\n });\n return { url: signed.url, expiresAt };\n }\n\n async deleteObject(object: MediaObjectReference): Promise<boolean> {\n const reference = normalizeReference(object);\n const record = await this.metadataStore.getObject(reference.key, this.tenantId);\n if (!record || record.object.object.versionId !== reference.versionId) return false;\n const target = await this.getBucketTarget(record.object.tenantId);\n try {\n await target.bucket.delete(record.key);\n } catch (error) {\n throw providerError(\"Unable to delete the R2 object.\", error);\n }\n return this.metadataStore.deleteObject(record.key, record.object.tenantId);\n }\n\n async listObjects(input: MediaObjectListInput): Promise<MediaObjectPage> {\n validatePositiveInteger(input.first, \"first\");\n if (input.first > this.maxListPageSize) {\n throw new MediaObjectStorageError(\"Object list page exceeds the configured limit.\");\n }\n if (input.olderThan && !Number.isFinite(input.olderThan.getTime())) {\n throw new MediaObjectStorageError(\"olderThan must be a valid date.\");\n }\n const records = await this.metadataStore.listObjects({\n first: input.first + 1,\n ...(input.cursor ? { cursor: decodeCursor(input.cursor) } : {}),\n ...(input.olderThan ? { olderThan: input.olderThan } : {}),\n ...(this.tenantId ? { tenantId: this.tenantId } : {}),\n });\n const pageRecords = records.slice(0, input.first);\n const items = pageRecords.map((record) => ({\n object: record.object.object,\n tenantId: record.object.tenantId,\n size: record.object.size,\n mimeType: record.object.mimeType,\n ...(record.object.checksum ? { checksum: record.object.checksum } : {}),\n createdAt: record.object.createdAt,\n }));\n return {\n items,\n nextCursor:\n records.length > input.first && pageRecords.at(-1)\n ? cursorForObject(pageRecords.at(-1)!.key)\n : null,\n };\n }\n\n async listExpiredUploadSessions(\n before: Date,\n first: number,\n ): Promise<readonly MediaUploadSession[]> {\n if (!Number.isFinite(before.getTime())) {\n throw new MediaObjectStorageError(\"before must be a valid date.\");\n }\n validatePositiveInteger(first, \"first\");\n if (first > this.maxListPageSize) {\n throw new MediaObjectStorageError(\"Expired upload page exceeds the configured limit.\");\n }\n const records = await this.metadataStore.listExpiredUploads(\n before,\n first,\n this.tenantId,\n );\n return records.map((record) => record.session);\n }\n\n /** Test/local-development helper that bypasses presigned HTTP delivery. */\n async putForTesting(\n sessionId: string,\n bytes: Uint8Array,\n contentType: string,\n ): Promise<void> {\n const upload = await this.requireUpload(sessionId);\n this.assertPending(upload);\n if (upload.session.mode !== \"single\") {\n throw new MediaAssetConflictError(\"The upload session is multipart.\");\n }\n const target = await this.getBucketTarget(upload.tenantId);\n await target.bucket.put(upload.key, bytes, {\n httpMetadata: { contentType: contentType.toLowerCase() },\n });\n }\n\n /** Test/local-development helper that bypasses presigned HTTP delivery. */\n async putPartForTesting(\n sessionId: string,\n partNumber: number,\n bytes: Uint8Array,\n ): Promise<MediaMultipartCompletedPart> {\n const upload = await this.requireUpload(sessionId);\n this.assertPending(upload);\n if (upload.session.mode !== \"multipart\" || !upload.uploadId) {\n throw new MediaAssetConflictError(\"The upload session is not multipart.\");\n }\n const target = await this.getBucketTarget(upload.tenantId);\n const multipart = this.resumeMultipart(target.bucket, upload);\n if (!multipart) {\n throw new CloudflareMediaConfigurationError(\n \"The configured R2 bucket cannot resume multipart uploads.\",\n );\n }\n if (!Number.isSafeInteger(partNumber) || partNumber < 1) {\n throw new MediaObjectStorageError(\"partNumber must be a positive safe integer.\");\n }\n const result = await multipart.uploadPart(partNumber, bytes);\n return { partNumber, etag: result.etag };\n }\n\n private prepareConstraints(input: MediaUploadConstraints): MediaUploadConstraints {\n const constraints = validateUploadConstraints(input);\n if (this.tenantId && constraints.tenantId !== this.tenantId) {\n throw new MediaObjectStorageError(\"The upload tenant is outside this adapter scope.\");\n }\n validateExpiry(constraints.expiresInMs, \"expiresInMs\", this.maxSignedUrlTtlMs);\n return constraints;\n }\n\n private expiry(ttl: number): Date {\n return new Date(this.now().getTime() + ttl);\n }\n\n private async getBucketTarget(tenantId: string): Promise<CloudflareMediaBucketTarget> {\n const source = this.bucketSource;\n if (typeof source === \"function\") {\n return source({ tenantId, ...(this.bucketName ? { bucketName: this.bucketName } : {}) });\n }\n if (\"resolve\" in source) {\n return source.resolve({\n tenantId,\n ...(this.bucketName ? { bucketName: this.bucketName } : {}),\n });\n }\n return source;\n }\n\n private async findUpload(sessionId: string): Promise<UploadRecord | null> {\n const record = await this.metadataStore.getUpload(sessionId);\n if (!record || (this.tenantId && record.tenantId !== this.tenantId)) return null;\n return record;\n }\n\n private async requireUpload(sessionId: string): Promise<UploadRecord> {\n const upload = await this.findUpload(sessionId);\n if (!upload) throw new MediaNotFoundError(\"Upload session\");\n return upload;\n }\n\n private assertPending(upload: UploadRecord): void {\n if (upload.session.state === \"completed\") {\n throw new MediaAssetConflictError(\"The upload session is already completed.\");\n }\n if (upload.session.state === \"aborted\") {\n throw new MediaAssetConflictError(\"The upload session has been aborted.\");\n }\n if (\n upload.session.state === \"expired\" ||\n upload.session.expiresAt.getTime() <= this.now().getTime()\n ) {\n void this.metadataStore.updateUpload(upload.session.id, {\n session: { ...upload.session, state: \"expired\" },\n });\n throw new MediaUploadExpiredError();\n }\n }\n\n private resumeMultipart(\n bucket: R2BucketLike,\n upload: UploadRecord,\n ): R2MultipartUploadLike | null {\n if (!upload.uploadId || !bucket.resumeMultipartUpload) return null;\n return bucket.resumeMultipartUpload(upload.key, upload.uploadId);\n }\n\n private async completeMultipart(\n bucket: R2BucketLike,\n upload: UploadRecord,\n parts: readonly MediaMultipartCompletedPart[] | undefined,\n ): Promise<void> {\n const multipart = this.resumeMultipart(bucket, upload);\n if (!multipart) {\n throw new CloudflareMediaConfigurationError(\n \"The configured R2 bucket cannot resume multipart uploads.\",\n );\n }\n let completed = parts;\n if (!completed && multipart.listParts) {\n completed = await multipart.listParts();\n }\n if (!completed || completed.length === 0) {\n throw new MediaAssetConflictError(\"Multipart completion requires uploaded parts.\");\n }\n const seen = new Set<number>();\n const normalized: R2MultipartPart[] = [...completed]\n .sort((left, right) => left.partNumber - right.partNumber)\n .map((part) => {\n if (\n !Number.isSafeInteger(part.partNumber) ||\n part.partNumber < 1 ||\n seen.has(part.partNumber) ||\n typeof part.etag !== \"string\" ||\n part.etag.trim() === \"\"\n ) {\n throw new MediaObjectStorageError(\"Multipart parts must have unique numbers and ETags.\");\n }\n seen.add(part.partNumber);\n return { partNumber: part.partNumber, etag: part.etag };\n });\n try {\n await multipart.complete(normalized);\n } catch (error) {\n throw providerError(\"Unable to complete the R2 multipart upload.\", error);\n }\n }\n\n private async readStoredObject(\n bucket: R2BucketLike,\n upload: UploadRecord,\n ): Promise<MediaStoredObject> {\n let head;\n try {\n head = await bucket.head(upload.key);\n } catch (error) {\n throw providerError(\"Unable to read R2 object metadata.\", error);\n }\n if (!head) throw new MediaNotFoundError(\"Uploaded media object\");\n let body;\n try {\n const object = await bucket.get(upload.key);\n if (!object) throw new MediaNotFoundError(\"Uploaded media object\");\n body = new Uint8Array(await object.arrayBuffer());\n } catch (error) {\n if (error instanceof MediaNotFoundError) throw error;\n throw providerError(\"Unable to read the uploaded R2 object.\", error);\n }\n if (head.size !== body.byteLength) {\n throw new MediaObjectStorageError(\n \"The R2 metadata size does not match the downloaded object.\",\n { details: { metadataSize: head.size, actualSize: body.byteLength } },\n );\n }\n const checksum = await sha256(body);\n return {\n object: { key: upload.key },\n tenantId: upload.tenantId,\n mimeType: (\n head.httpMetadata?.contentType ??\n upload.contentType\n ).toLowerCase(),\n size: body.byteLength,\n checksum,\n createdAt: head.uploaded ?? this.now(),\n };\n }\n}\n\nconst decodeCursor = (cursor: string): string => {\n try {\n return decodeURIComponent(cursor);\n } catch {\n throw new MediaObjectStorageError(\"Object list cursor is invalid.\");\n }\n};\n"],"mappings":";;;;AA4CA,MAAM,gBAAgB;AACtB,MAAM,kBAAkB;AAExB,MAAM,YACJ,QACA,eAMI;CACJ,KAAK,OAAO;CACZ,QAAQ;CACR,SAAS,OAAO,WAAW,CAAC;CAC5B;AACF;AAEA,MAAM,iBAAiB,SAAiB,UACtC,IAAI,6BAA6B,SAAS,KAAK;AAEjD,IAAa,wCAAb,MAEA;CACE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,SAAiB;CAEjB,YAAY,SAAgD;EAC1D,KAAK,eAAe,QAAQ;EAC5B,KAAK,gBAAgB,QAAQ;EAC7B,KAAK,WAAW,QAAQ,WAAW,iBAAiB,QAAQ,QAAQ,IAAI,KAAA;EACxE,KAAK,aAAa,QAAQ;EAC1B,KAAK,MAAM,QAAQ,8BAAc,IAAI,KAAK;EAC1C,KAAK,oBAAoB,QAAQ,qBAAqB;EACtD,KAAK,kBAAkB,QAAQ,mBAAmB;EAClD,wBAAwB,KAAK,mBAAmB,mBAAmB;EACnE,wBAAwB,KAAK,iBAAiB,iBAAiB;EAC/D,KAAK,YACH,QAAQ,oBACD;GACL,KAAK,UAAU;GACf,OAAO,MAAM,KAAK;EACpB;CACJ;CAEA,MAAM,mBAAmB,OAA4D;EACnF,MAAM,cAAc,KAAK,mBAAmB,KAAK;EACjD,MAAM,KAAK,KAAK,UAAU;EAC1B,MAAM,YAAY,KAAK,OAAO,YAAY,WAAW;EACrD,MAAM,SAAS,MAAM,KAAK,gBAAgB,YAAY,QAAQ;EAC9D,MAAM,MAAM,sBACV,YAAY,UACZ,IACA,YAAY,UACZ,YAAY,YACd;EACA,MAAM,SAAS,MAAM,OAAO,OAAO,WAAW;GAC5C,UAAU,YAAY;GACtB;GACA,aAAa,YAAY;GACzB;GACA,GAAI,YAAY,iBAAiB,KAAA,IAC7B,EAAE,cAAc,YAAY,aAAa,IACzC,CAAC;EACP,CAAC;EACD,MAAM,eAAe,SAAS,QAAQ,SAAS;EAC/C,MAAM,UAA8B;GAClC;GACA,UAAU,YAAY;GACtB,MAAM;GACN,OAAO;GACP,GAAI,YAAY,iBAAiB,KAAA,IAC7B,EAAE,cAAc,YAAY,aAAa,IACzC,CAAC;GACL,GAAI,YAAY,mBACZ,EAAE,kBAAkB,YAAY,iBAAiB,IACjD,CAAC;GACL;GACA,cAAc;IACZ,GAAG;IACH,SAAS;KACP,GAAG,aAAa;KAChB,gBAAgB,YAAY;IAC9B;GACF;EACF;EACA,MAAM,KAAK,cAAc,WAAW;GAClC;GACA,UAAU,YAAY;GACtB;GACA,aAAa,YAAY;GACzB,UAAU,YAAY;EACxB,CAAC;EACD,OAAO;CACT;CAEA,MAAM,sBACJ,OAC6B;EAC7B,MAAM,cAAc,KAAK,mBAAmB,KAAK;EACjD,wBAAwB,MAAM,eAAe,eAAe;EAC5D,MAAM,KAAK,KAAK,UAAU;EAC1B,MAAM,YAAY,KAAK,OAAO,YAAY,WAAW;EACrD,MAAM,SAAS,MAAM,KAAK,gBAAgB,YAAY,QAAQ;EAC9D,IAAI,CAAC,OAAO,OAAO,uBACjB,MAAM,IAAI,kCACR,oEACF;EAEF,MAAM,MAAM,sBACV,YAAY,UACZ,IACA,YAAY,UACZ,YAAY,YACd;EACA,IAAI;EACJ,IAAI;GACF,YAAY,MAAM,OAAO,OAAO,sBAAsB,KAAK,EACzD,cAAc,EAAE,aAAa,YAAY,YAAY,EACvD,CAAC;EACH,SAAS,OAAO;GACd,MAAM,cAAc,6CAA6C,KAAK;EACxE;EACA,IAAI,CAAC,UAAU,UACb,MAAM,IAAI,kCACR,uDACF;EAEF,MAAM,UAA8B;GAClC;GACA,UAAU,YAAY;GACtB,MAAM;GACN,OAAO;GACP,GAAI,YAAY,iBAAiB,KAAA,IAC7B,EAAE,cAAc,YAAY,aAAa,IACzC,CAAC;GACL,GAAI,YAAY,mBACZ,EAAE,kBAAkB,YAAY,iBAAiB,IACjD,CAAC;GACL;GACA,eAAe,MAAM;EACvB;EACA,MAAM,KAAK,cAAc,WAAW;GAClC;GACA,UAAU,YAAY;GACtB;GACA,aAAa,YAAY;GACzB,UAAU,YAAY;GACtB,UAAU,UAAU;GACpB,eAAe,MAAM;EACvB,CAAC;EACD,OAAO;CACT;CAEA,MAAM,2BACJ,WACA,aACA,aAC8C;EAC9C,MAAM,SAAS,MAAM,KAAK,cAAc,SAAS;EACjD,KAAK,cAAc,MAAM;EACzB,IAAI,OAAO,QAAQ,SAAS,eAAe,CAAC,OAAO,YAAY,CAAC,OAAO,eACrE,MAAM,IAAI,wBAAwB,sCAAsC;EAE1E,eAAe,aAAa,eAAe,KAAK,iBAAiB;EACjE,IAAI,YAAY,WAAW,GACzB,MAAM,IAAI,wBAAwB,iDAAiD;EAErF,MAAM,yBAAS,IAAI,IAAY;EAC/B,MAAM,UACJ,OAAO,QAAQ,iBAAiB,KAAA,IAC5B,OAAO,mBACP,KAAK,KAAK,OAAO,QAAQ,eAAe,OAAO,aAAa;EAClE,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,QAAQ;EACzD,OAAO,QAAQ,IACb,YAAY,IAAI,OAAO,eAAe;GACpC,IACE,CAAC,OAAO,cAAc,UAAU,KAChC,aAAa,KACb,aAAa,WACb,OAAO,IAAI,UAAU,GAErB,MAAM,IAAI,wBACR,qFACF;GAEF,OAAO,IAAI,UAAU;GACrB,MAAM,YAAY,IAAI,KACpB,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,aAAa,OAAO,QAAQ,UAAU,QAAQ,CAAC,CACjF;GACA,MAAM,SAAS,MAAM,OAAO,OAAO,kBAAkB;IACnD,UAAU,OAAO;IACjB,KAAK,OAAO;IACZ,UAAU,OAAO;IACjB;IACA;GACF,CAAC;GACD,OAAO;IACL;IACA,KAAK,OAAO;IACZ,QAAQ;IACR,SAAS,OAAO,WAAW,CAAC;IAC5B;GACF;EACF,CAAC,CACH;CACF;CAEA,MAAM,eACJ,WACA,OAC4B;EAC5B,MAAM,SAAS,MAAM,KAAK,cAAc,SAAS;EACjD,IAAI,OAAO,QAAQ,UAAU,aAAa;GACxC,MAAM,SAAS,MAAM,KAAK,cAAc,UAAU,OAAO,KAAK,OAAO,QAAQ;GAC7E,IAAI,QAAQ,OAAO,OAAO;GAC1B,MAAM,IAAI,mBAAmB,wBAAwB;EACvD;EACA,KAAK,cAAc,MAAM;EACzB,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,QAAQ;EACzD,IAAI,OAAO,QAAQ,SAAS,aAC1B,MAAM,KAAK,kBAAkB,OAAO,QAAQ,QAAQ,KAAK;EAE3D,MAAM,SAAS,MAAM,KAAK,iBAAiB,OAAO,QAAQ,MAAM;EAChE,IACE,OAAO,QAAQ,iBAAiB,KAAA,KAChC,OAAO,SAAS,OAAO,QAAQ,cAE/B,MAAM,IAAI,wBACR,6DACA,EACE,SAAS;GACP,cAAc,OAAO,QAAQ;GAC7B,YAAY,OAAO;EACrB,EACF,CACF;EAEF,IACE,OAAO,QAAQ,oBACf,CAAC,eAAe,OAAO,UAAW,OAAO,QAAQ,gBAAgB,GAEjE,MAAM,IAAI,2BAA2B;EAEvC,MAAM,KAAK,cAAc,WAAW;GAAE,KAAK,OAAO;GAAK;EAAO,CAAC;EAC/D,MAAM,KAAK,cAAc,aAAa,WAAW,EAC/C,SAAS;GAAE,GAAG,OAAO;GAAS,OAAO;EAAY,EACnD,CAAC;EACD,OAAO;CACT;CAEA,MAAM,YAAY,WAAqC;EACrD,MAAM,SAAS,MAAM,KAAK,WAAW,SAAS;EAC9C,IACE,CAAC,UACD,OAAO,QAAQ,UAAU,eACzB,OAAO,QAAQ,UAAU,WAEzB,OAAO;EAET,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,QAAQ;EACzD,IAAI,OAAO,QAAQ,SAAS,eAAe,OAAO,UAAU;GAC1D,MAAM,YAAY,KAAK,gBAAgB,OAAO,QAAQ,MAAM;GAC5D,IAAI,WACF,IAAI;IACF,MAAM,UAAU,MAAM;GACxB,SAAS,OAAO;IACd,MAAM,cAAc,4CAA4C,KAAK;GACvE;EAEJ,OACE,MAAM,OAAO,OAAO,OAAO,OAAO,GAAG;EAEvC,MAAM,KAAK,cAAc,aAAa,WAAW,EAC/C,SAAS;GAAE,GAAG,OAAO;GAAS,OAAO;EAAU,EACjD,CAAC;EACD,OAAO;CACT;CAEA,MAAM,iBAAiB,WAAuD;EAC5E,MAAM,SAAS,MAAM,KAAK,WAAW,SAAS;EAC9C,IAAI,CAAC,QAAQ,OAAO;EACpB,IACE,OAAO,QAAQ,UAAU,aACzB,OAAO,QAAQ,UAAU,QAAQ,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,GAKzD,QAAO,MAHe,KAAK,cAAc,aAAa,WAAW,EAC/D,SAAS;GAAE,GAAG,OAAO;GAAS,OAAO;EAAU,EACjD,CAAC,EAAA,EACe,WAAW;GAAE,GAAG,OAAO;GAAS,OAAO;EAAU;EAEnE,OAAO,OAAO;CAChB;CAEA,MAAM,kBACJ,QACmC;EACnC,MAAM,YAAY,mBAAmB,MAAM;EAC3C,MAAM,SAAS,MAAM,KAAK,cAAc,UAAU,UAAU,KAAK,KAAK,QAAQ;EAC9E,IAAI,CAAC,UAAU,OAAO,OAAO,OAAO,cAAc,UAAU,WAAW,OAAO;EAE9E,IAAI,CAAE,OAAM,MADS,KAAK,gBAAgB,OAAO,OAAO,QAAQ,EAAA,CAC7C,OAAO,KAAK,OAAO,GAAG,GAAI,OAAO;EACpD,OAAO,OAAO;CAChB;CAEA,MAAM,iBACJ,QACA,aAC0B;EAC1B,MAAM,YAAY,mBAAmB,MAAM;EAC3C,eAAe,aAAa,eAAe,KAAK,iBAAiB;EACjE,MAAM,SAAS,MAAM,KAAK,cAAc,UAAU,UAAU,KAAK,KAAK,QAAQ;EAC9E,IAAI,CAAC,UAAU,OAAO,OAAO,OAAO,cAAc,UAAU,WAC1D,MAAM,IAAI,mBAAmB,cAAc;EAE7C,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,OAAO,QAAQ;EAChE,IAAI,CAAE,MAAM,OAAO,OAAO,KAAK,OAAO,GAAG,GACvC,MAAM,IAAI,mBAAmB,cAAc;EAE7C,MAAM,YAAY,KAAK,OAAO,WAAW;EAMzC,OAAO;GAAE,MAAK,MALO,OAAO,OAAO,SAAS;IAC1C,UAAU,OAAO,OAAO;IACxB,KAAK,OAAO;IACZ;GACF,CAAC,EAAA,CACoB;GAAK;EAAU;CACtC;CAEA,MAAM,aAAa,QAAgD;EACjE,MAAM,YAAY,mBAAmB,MAAM;EAC3C,MAAM,SAAS,MAAM,KAAK,cAAc,UAAU,UAAU,KAAK,KAAK,QAAQ;EAC9E,IAAI,CAAC,UAAU,OAAO,OAAO,OAAO,cAAc,UAAU,WAAW,OAAO;EAC9E,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,OAAO,QAAQ;EAChE,IAAI;GACF,MAAM,OAAO,OAAO,OAAO,OAAO,GAAG;EACvC,SAAS,OAAO;GACd,MAAM,cAAc,mCAAmC,KAAK;EAC9D;EACA,OAAO,KAAK,cAAc,aAAa,OAAO,KAAK,OAAO,OAAO,QAAQ;CAC3E;CAEA,MAAM,YAAY,OAAuD;EACvE,wBAAwB,MAAM,OAAO,OAAO;EAC5C,IAAI,MAAM,QAAQ,KAAK,iBACrB,MAAM,IAAI,wBAAwB,gDAAgD;EAEpF,IAAI,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,UAAU,QAAQ,CAAC,GAC/D,MAAM,IAAI,wBAAwB,iCAAiC;EAErE,MAAM,UAAU,MAAM,KAAK,cAAc,YAAY;GACnD,OAAO,MAAM,QAAQ;GACrB,GAAI,MAAM,SAAS,EAAE,QAAQ,aAAa,MAAM,MAAM,EAAE,IAAI,CAAC;GAC7D,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;GACxD,GAAI,KAAK,WAAW,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACrD,CAAC;EACD,MAAM,cAAc,QAAQ,MAAM,GAAG,MAAM,KAAK;EAShD,OAAO;GACL,OATY,YAAY,KAAK,YAAY;IACzC,QAAQ,OAAO,OAAO;IACtB,UAAU,OAAO,OAAO;IACxB,MAAM,OAAO,OAAO;IACpB,UAAU,OAAO,OAAO;IACxB,GAAI,OAAO,OAAO,WAAW,EAAE,UAAU,OAAO,OAAO,SAAS,IAAI,CAAC;IACrE,WAAW,OAAO,OAAO;GAC3B,EAEM;GACJ,YACE,QAAQ,SAAS,MAAM,SAAS,YAAY,GAAG,EAAE,IAC7C,gBAAgB,YAAY,GAAG,EAAE,CAAC,CAAE,GAAG,IACvC;EACR;CACF;CAEA,MAAM,0BACJ,QACA,OACwC;EACxC,IAAI,CAAC,OAAO,SAAS,OAAO,QAAQ,CAAC,GACnC,MAAM,IAAI,wBAAwB,8BAA8B;EAElE,wBAAwB,OAAO,OAAO;EACtC,IAAI,QAAQ,KAAK,iBACf,MAAM,IAAI,wBAAwB,mDAAmD;EAOvF,QAAO,MALe,KAAK,cAAc,mBACvC,QACA,OACA,KAAK,QACP,EAAA,CACe,KAAK,WAAW,OAAO,OAAO;CAC/C;;CAGA,MAAM,cACJ,WACA,OACA,aACe;EACf,MAAM,SAAS,MAAM,KAAK,cAAc,SAAS;EACjD,KAAK,cAAc,MAAM;EACzB,IAAI,OAAO,QAAQ,SAAS,UAC1B,MAAM,IAAI,wBAAwB,kCAAkC;EAGtE,OAAM,MADe,KAAK,gBAAgB,OAAO,QAAQ,EAAA,CAC5C,OAAO,IAAI,OAAO,KAAK,OAAO,EACzC,cAAc,EAAE,aAAa,YAAY,YAAY,EAAE,EACzD,CAAC;CACH;;CAGA,MAAM,kBACJ,WACA,YACA,OACsC;EACtC,MAAM,SAAS,MAAM,KAAK,cAAc,SAAS;EACjD,KAAK,cAAc,MAAM;EACzB,IAAI,OAAO,QAAQ,SAAS,eAAe,CAAC,OAAO,UACjD,MAAM,IAAI,wBAAwB,sCAAsC;EAE1E,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,QAAQ;EACzD,MAAM,YAAY,KAAK,gBAAgB,OAAO,QAAQ,MAAM;EAC5D,IAAI,CAAC,WACH,MAAM,IAAI,kCACR,2DACF;EAEF,IAAI,CAAC,OAAO,cAAc,UAAU,KAAK,aAAa,GACpD,MAAM,IAAI,wBAAwB,6CAA6C;EAGjF,OAAO;GAAE;GAAY,OAAM,MADN,UAAU,WAAW,YAAY,KAAK,EAAA,CACzB;EAAK;CACzC;CAEA,mBAA2B,OAAuD;EAChF,MAAM,cAAc,0BAA0B,KAAK;EACnD,IAAI,KAAK,YAAY,YAAY,aAAa,KAAK,UACjD,MAAM,IAAI,wBAAwB,kDAAkD;EAEtF,eAAe,YAAY,aAAa,eAAe,KAAK,iBAAiB;EAC7E,OAAO;CACT;CAEA,OAAe,KAAmB;EAChC,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG;CAC5C;CAEA,MAAc,gBAAgB,UAAwD;EACpF,MAAM,SAAS,KAAK;EACpB,IAAI,OAAO,WAAW,YACpB,OAAO,OAAO;GAAE;GAAU,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EAAG,CAAC;EAEzF,IAAI,aAAa,QACf,OAAO,OAAO,QAAQ;GACpB;GACA,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EAC3D,CAAC;EAEH,OAAO;CACT;CAEA,MAAc,WAAW,WAAiD;EACxE,MAAM,SAAS,MAAM,KAAK,cAAc,UAAU,SAAS;EAC3D,IAAI,CAAC,UAAW,KAAK,YAAY,OAAO,aAAa,KAAK,UAAW,OAAO;EAC5E,OAAO;CACT;CAEA,MAAc,cAAc,WAA0C;EACpE,MAAM,SAAS,MAAM,KAAK,WAAW,SAAS;EAC9C,IAAI,CAAC,QAAQ,MAAM,IAAI,mBAAmB,gBAAgB;EAC1D,OAAO;CACT;CAEA,cAAsB,QAA4B;EAChD,IAAI,OAAO,QAAQ,UAAU,aAC3B,MAAM,IAAI,wBAAwB,0CAA0C;EAE9E,IAAI,OAAO,QAAQ,UAAU,WAC3B,MAAM,IAAI,wBAAwB,sCAAsC;EAE1E,IACE,OAAO,QAAQ,UAAU,aACzB,OAAO,QAAQ,UAAU,QAAQ,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,GACzD;GACA,KAAU,cAAc,aAAa,OAAO,QAAQ,IAAI,EACtD,SAAS;IAAE,GAAG,OAAO;IAAS,OAAO;GAAU,EACjD,CAAC;GACD,MAAM,IAAI,wBAAwB;EACpC;CACF;CAEA,gBACE,QACA,QAC8B;EAC9B,IAAI,CAAC,OAAO,YAAY,CAAC,OAAO,uBAAuB,OAAO;EAC9D,OAAO,OAAO,sBAAsB,OAAO,KAAK,OAAO,QAAQ;CACjE;CAEA,MAAc,kBACZ,QACA,QACA,OACe;EACf,MAAM,YAAY,KAAK,gBAAgB,QAAQ,MAAM;EACrD,IAAI,CAAC,WACH,MAAM,IAAI,kCACR,2DACF;EAEF,IAAI,YAAY;EAChB,IAAI,CAAC,aAAa,UAAU,WAC1B,YAAY,MAAM,UAAU,UAAU;EAExC,IAAI,CAAC,aAAa,UAAU,WAAW,GACrC,MAAM,IAAI,wBAAwB,+CAA+C;EAEnF,MAAM,uBAAO,IAAI,IAAY;EAC7B,MAAM,aAAgC,CAAC,GAAG,SAAS,CAAC,CACjD,MAAM,MAAM,UAAU,KAAK,aAAa,MAAM,UAAU,CAAC,CACzD,KAAK,SAAS;GACb,IACE,CAAC,OAAO,cAAc,KAAK,UAAU,KACrC,KAAK,aAAa,KAClB,KAAK,IAAI,KAAK,UAAU,KACxB,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,KAAK,MAAM,IAErB,MAAM,IAAI,wBAAwB,qDAAqD;GAEzF,KAAK,IAAI,KAAK,UAAU;GACxB,OAAO;IAAE,YAAY,KAAK;IAAY,MAAM,KAAK;GAAK;EACxD,CAAC;EACH,IAAI;GACF,MAAM,UAAU,SAAS,UAAU;EACrC,SAAS,OAAO;GACd,MAAM,cAAc,+CAA+C,KAAK;EAC1E;CACF;CAEA,MAAc,iBACZ,QACA,QAC4B;EAC5B,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,OAAO,KAAK,OAAO,GAAG;EACrC,SAAS,OAAO;GACd,MAAM,cAAc,sCAAsC,KAAK;EACjE;EACA,IAAI,CAAC,MAAM,MAAM,IAAI,mBAAmB,uBAAuB;EAC/D,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,MAAM,OAAO,IAAI,OAAO,GAAG;GAC1C,IAAI,CAAC,QAAQ,MAAM,IAAI,mBAAmB,uBAAuB;GACjE,OAAO,IAAI,WAAW,MAAM,OAAO,YAAY,CAAC;EAClD,SAAS,OAAO;GACd,IAAI,iBAAiB,oBAAoB,MAAM;GAC/C,MAAM,cAAc,0CAA0C,KAAK;EACrE;EACA,IAAI,KAAK,SAAS,KAAK,YACrB,MAAM,IAAI,wBACR,8DACA,EAAE,SAAS;GAAE,cAAc,KAAK;GAAM,YAAY,KAAK;EAAW,EAAE,CACtE;EAEF,MAAM,WAAW,MAAM,OAAO,IAAI;EAClC,OAAO;GACL,QAAQ,EAAE,KAAK,OAAO,IAAI;GAC1B,UAAU,OAAO;GACjB,WACE,KAAK,cAAc,eACnB,OAAO,YAAA,CACP,YAAY;GACd,MAAM,KAAK;GACX;GACA,WAAW,KAAK,YAAY,KAAK,IAAI;EACvC;CACF;AACF;AAEA,MAAM,gBAAgB,WAA2B;CAC/C,IAAI;EACF,OAAO,mBAAmB,MAAM;CAClC,QAAQ;EACN,MAAM,IAAI,wBAAwB,gCAAgC;CACpE;AACF"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// src/s3-signer.ts
|
|
2
|
+
const encoder = new TextEncoder();
|
|
3
|
+
const encode = (value) => encodeURIComponent(value).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
|
|
4
|
+
const hex = (bytes) => [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
5
|
+
const sha256Hex = async (value) => hex(await crypto.subtle.digest("SHA-256", encoder.encode(value)));
|
|
6
|
+
const hmac = async (key, value) => {
|
|
7
|
+
const rawKey = key instanceof Uint8Array ? key.slice().buffer : key.slice(0);
|
|
8
|
+
const cryptoKey = await crypto.subtle.importKey("raw", rawKey, {
|
|
9
|
+
name: "HMAC",
|
|
10
|
+
hash: "SHA-256"
|
|
11
|
+
}, false, ["sign"]);
|
|
12
|
+
return crypto.subtle.sign("HMAC", cryptoKey, encoder.encode(value));
|
|
13
|
+
};
|
|
14
|
+
const pathFor = (base, bucketName, key) => {
|
|
15
|
+
return `/${[
|
|
16
|
+
...base.pathname.split("/").filter(Boolean),
|
|
17
|
+
bucketName,
|
|
18
|
+
...key.split("/")
|
|
19
|
+
].map(encode).join("/")}`;
|
|
20
|
+
};
|
|
21
|
+
const formatDate = (date) => {
|
|
22
|
+
const iso = date.toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
23
|
+
return {
|
|
24
|
+
dateStamp: iso.slice(0, 10).replaceAll("-", ""),
|
|
25
|
+
amzDate: iso.replaceAll("-", "").replaceAll(":", "")
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
const canonicalQuery = (values) => Object.entries(values).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${encode(key)}=${encode(value)}`).join("&");
|
|
29
|
+
/**
|
|
30
|
+
* Worker-compatible AWS Signature Version 4 presigner for R2's
|
|
31
|
+
* S3-compatible endpoint. Credentials stay in the server/Worker that creates
|
|
32
|
+
* the signer; only the resulting short-lived target is returned to callers.
|
|
33
|
+
*/
|
|
34
|
+
var CloudflareR2S3UrlSigner = class {
|
|
35
|
+
endpoint;
|
|
36
|
+
bucketName;
|
|
37
|
+
accessKeyId;
|
|
38
|
+
secretAccessKey;
|
|
39
|
+
region;
|
|
40
|
+
now;
|
|
41
|
+
constructor(options) {
|
|
42
|
+
this.endpoint = new URL(options.endpoint);
|
|
43
|
+
if (this.endpoint.protocol !== "https:") throw new TypeError("R2 S3 endpoints must use HTTPS.");
|
|
44
|
+
if (!options.bucketName || !options.accessKeyId || !options.secretAccessKey) throw new TypeError("R2 S3 signing requires a bucket and access credentials.");
|
|
45
|
+
this.bucketName = options.bucketName;
|
|
46
|
+
this.accessKeyId = options.accessKeyId;
|
|
47
|
+
this.secretAccessKey = options.secretAccessKey;
|
|
48
|
+
this.region = options.region ?? "auto";
|
|
49
|
+
this.now = options.now ?? (() => /* @__PURE__ */ new Date());
|
|
50
|
+
}
|
|
51
|
+
signUpload(input) {
|
|
52
|
+
return this.presign("PUT", input.key, input.expiresAt, {}, input.contentType);
|
|
53
|
+
}
|
|
54
|
+
signMultipartPart(input) {
|
|
55
|
+
return this.presign("PUT", input.key, input.expiresAt, {
|
|
56
|
+
partNumber: String(input.partNumber),
|
|
57
|
+
uploadId: input.uploadId
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
signRead(input) {
|
|
61
|
+
return this.presign("GET", input.key, input.expiresAt, {});
|
|
62
|
+
}
|
|
63
|
+
async presign(method, key, expiresAt, extraQuery, contentType) {
|
|
64
|
+
const now = this.now();
|
|
65
|
+
const ttlSeconds = Math.ceil((expiresAt.getTime() - now.getTime()) / 1e3);
|
|
66
|
+
if (!Number.isInteger(ttlSeconds) || ttlSeconds < 1 || ttlSeconds > 604800) throw new RangeError("R2 signed URL expiry must be between one second and seven days.");
|
|
67
|
+
const { dateStamp, amzDate } = formatDate(now);
|
|
68
|
+
const path = pathFor(this.endpoint, this.bucketName, key);
|
|
69
|
+
const query = {
|
|
70
|
+
...extraQuery,
|
|
71
|
+
"X-Amz-Algorithm": "AWS4-HMAC-SHA256",
|
|
72
|
+
"X-Amz-Credential": `${this.accessKeyId}/${dateStamp}/${this.region}/s3/aws4_request`,
|
|
73
|
+
"X-Amz-Date": amzDate,
|
|
74
|
+
"X-Amz-Expires": String(ttlSeconds),
|
|
75
|
+
"X-Amz-SignedHeaders": "host"
|
|
76
|
+
};
|
|
77
|
+
const queryString = canonicalQuery(query);
|
|
78
|
+
const canonicalRequest = [
|
|
79
|
+
method,
|
|
80
|
+
path,
|
|
81
|
+
queryString,
|
|
82
|
+
`host:${this.endpoint.host}\n`,
|
|
83
|
+
"host",
|
|
84
|
+
"UNSIGNED-PAYLOAD"
|
|
85
|
+
].join("\n");
|
|
86
|
+
const stringToSign = [
|
|
87
|
+
"AWS4-HMAC-SHA256",
|
|
88
|
+
amzDate,
|
|
89
|
+
`${dateStamp}/${this.region}/s3/aws4_request`,
|
|
90
|
+
await sha256Hex(canonicalRequest)
|
|
91
|
+
].join("\n");
|
|
92
|
+
const dateKey = await hmac(encoder.encode(`AWS4${this.secretAccessKey}`), dateStamp);
|
|
93
|
+
const regionKey = await hmac(dateKey, this.region);
|
|
94
|
+
const serviceKey = await hmac(regionKey, "s3");
|
|
95
|
+
const signingKey = await hmac(serviceKey, "aws4_request");
|
|
96
|
+
const signature = hex(await hmac(signingKey, stringToSign));
|
|
97
|
+
return {
|
|
98
|
+
url: `${this.endpoint.origin}${path}?${queryString}&X-Amz-Signature=${signature}`,
|
|
99
|
+
...method === "PUT" && contentType ? { headers: { "content-type": contentType } } : {}
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
};
|
|
103
|
+
exports.CloudflareR2S3Signer = CloudflareR2S3UrlSigner;
|
|
104
|
+
exports.CloudflareR2S3UrlSigner = CloudflareR2S3UrlSigner;
|
|
105
|
+
|
|
106
|
+
//# sourceMappingURL=s3-signer.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"s3-signer.cjs","names":[],"sources":["../src/s3-signer.ts"],"sourcesContent":["import type {\n CloudflareMediaUrlSigner,\n CloudflareMediaUrlTarget,\n CloudflareR2S3UrlSignerOptions,\n} from \"./types\";\n\nconst encoder = new TextEncoder();\n\nconst encode = (value: string): string =>\n encodeURIComponent(value).replace(/[!'()*]/g, (character) =>\n `%${character.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n\nconst hex = (bytes: ArrayBuffer): string =>\n [...new Uint8Array(bytes)]\n .map((byte) => byte.toString(16).padStart(2, \"0\"))\n .join(\"\");\n\nconst sha256Hex = async (value: string): Promise<string> =>\n hex(await crypto.subtle.digest(\"SHA-256\", encoder.encode(value)));\n\nconst hmac = async (\n key: ArrayBuffer | Uint8Array,\n value: string,\n): Promise<ArrayBuffer> => {\n const rawKey =\n key instanceof Uint8Array ? key.slice().buffer : key.slice(0);\n const cryptoKey = await crypto.subtle.importKey(\n \"raw\",\n rawKey,\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n return crypto.subtle.sign(\"HMAC\", cryptoKey, encoder.encode(value));\n};\n\nconst pathFor = (base: URL, bucketName: string, key: string): string => {\n const segments = [\n ...base.pathname.split(\"/\").filter(Boolean),\n bucketName,\n ...key.split(\"/\"),\n ];\n return `/${segments.map(encode).join(\"/\")}`;\n};\n\nconst formatDate = (date: Date): { dateStamp: string; amzDate: string } => {\n const iso = date.toISOString().replace(/\\.\\d{3}Z$/, \"Z\");\n return {\n dateStamp: iso.slice(0, 10).replaceAll(\"-\", \"\"),\n amzDate: iso.replaceAll(\"-\", \"\").replaceAll(\":\", \"\"),\n };\n};\n\nconst canonicalQuery = (\n values: Readonly<Record<string, string>>,\n): string =>\n Object.entries(values)\n .sort(([left], [right]) => left.localeCompare(right))\n .map(([key, value]) => `${encode(key)}=${encode(value)}`)\n .join(\"&\");\n\n/**\n * Worker-compatible AWS Signature Version 4 presigner for R2's\n * S3-compatible endpoint. Credentials stay in the server/Worker that creates\n * the signer; only the resulting short-lived target is returned to callers.\n */\nexport class CloudflareR2S3UrlSigner implements CloudflareMediaUrlSigner {\n private readonly endpoint: URL;\n private readonly bucketName: string;\n private readonly accessKeyId: string;\n private readonly secretAccessKey: string;\n private readonly region: string;\n private readonly now: () => Date;\n\n constructor(options: CloudflareR2S3UrlSignerOptions) {\n this.endpoint = new URL(options.endpoint);\n if (this.endpoint.protocol !== \"https:\") {\n throw new TypeError(\"R2 S3 endpoints must use HTTPS.\");\n }\n if (!options.bucketName || !options.accessKeyId || !options.secretAccessKey) {\n throw new TypeError(\"R2 S3 signing requires a bucket and access credentials.\");\n }\n this.bucketName = options.bucketName;\n this.accessKeyId = options.accessKeyId;\n this.secretAccessKey = options.secretAccessKey;\n this.region = options.region ?? \"auto\";\n this.now = options.now ?? (() => new Date());\n }\n\n signUpload(input: Parameters<CloudflareMediaUrlSigner[\"signUpload\"]>[0]): Promise<CloudflareMediaUrlTarget> {\n return this.presign(\"PUT\", input.key, input.expiresAt, {}, input.contentType);\n }\n\n signMultipartPart(\n input: Parameters<CloudflareMediaUrlSigner[\"signMultipartPart\"]>[0],\n ): Promise<CloudflareMediaUrlTarget> {\n return this.presign(\"PUT\", input.key, input.expiresAt, {\n partNumber: String(input.partNumber),\n uploadId: input.uploadId,\n });\n }\n\n signRead(\n input: Parameters<CloudflareMediaUrlSigner[\"signRead\"]>[0],\n ): Promise<CloudflareMediaUrlTarget> {\n return this.presign(\"GET\", input.key, input.expiresAt, {});\n }\n\n private async presign(\n method: \"GET\" | \"PUT\",\n key: string,\n expiresAt: Date,\n extraQuery: Readonly<Record<string, string>>,\n contentType?: string,\n ): Promise<CloudflareMediaUrlTarget> {\n const now = this.now();\n const ttlSeconds = Math.ceil((expiresAt.getTime() - now.getTime()) / 1000);\n if (!Number.isInteger(ttlSeconds) || ttlSeconds < 1 || ttlSeconds > 604800) {\n throw new RangeError(\"R2 signed URL expiry must be between one second and seven days.\");\n }\n const { dateStamp, amzDate } = formatDate(now);\n const path = pathFor(this.endpoint, this.bucketName, key);\n const query = {\n ...extraQuery,\n \"X-Amz-Algorithm\": \"AWS4-HMAC-SHA256\",\n \"X-Amz-Credential\": `${this.accessKeyId}/${dateStamp}/${this.region}/s3/aws4_request`,\n \"X-Amz-Date\": amzDate,\n \"X-Amz-Expires\": String(ttlSeconds),\n \"X-Amz-SignedHeaders\": \"host\",\n };\n const queryString = canonicalQuery(query);\n const host = this.endpoint.host;\n const canonicalRequest = [\n method,\n path,\n queryString,\n `host:${host}\\n`,\n \"host\",\n \"UNSIGNED-PAYLOAD\",\n ].join(\"\\n\");\n const scope = `${dateStamp}/${this.region}/s3/aws4_request`;\n const stringToSign = [\n \"AWS4-HMAC-SHA256\",\n amzDate,\n scope,\n await sha256Hex(canonicalRequest),\n ].join(\"\\n\");\n const dateKey = await hmac(encoder.encode(`AWS4${this.secretAccessKey}`), dateStamp);\n const regionKey = await hmac(dateKey, this.region);\n const serviceKey = await hmac(regionKey, \"s3\");\n const signingKey = await hmac(serviceKey, \"aws4_request\");\n const signature = hex(await hmac(signingKey, stringToSign));\n return {\n url: `${this.endpoint.origin}${path}?${queryString}&X-Amz-Signature=${signature}`,\n ...(method === \"PUT\" && contentType\n ? { headers: { \"content-type\": contentType } }\n : {}),\n };\n }\n}\n\nexport { CloudflareR2S3UrlSigner as CloudflareR2S3Signer };\n"],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { CloudflareMediaUrlSigner, CloudflareMediaUrlTarget, CloudflareR2S3UrlSignerOptions } from "./types.cjs";
|
|
2
|
+
/**
|
|
3
|
+
* Worker-compatible AWS Signature Version 4 presigner for R2's
|
|
4
|
+
* S3-compatible endpoint. Credentials stay in the server/Worker that creates
|
|
5
|
+
* the signer; only the resulting short-lived target is returned to callers.
|
|
6
|
+
*/
|
|
7
|
+
export declare class CloudflareR2S3UrlSigner implements CloudflareMediaUrlSigner {
|
|
8
|
+
private readonly endpoint;
|
|
9
|
+
private readonly bucketName;
|
|
10
|
+
private readonly accessKeyId;
|
|
11
|
+
private readonly secretAccessKey;
|
|
12
|
+
private readonly region;
|
|
13
|
+
private readonly now;
|
|
14
|
+
constructor(options: CloudflareR2S3UrlSignerOptions);
|
|
15
|
+
signUpload(input: Parameters<CloudflareMediaUrlSigner["signUpload"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
16
|
+
signMultipartPart(input: Parameters<CloudflareMediaUrlSigner["signMultipartPart"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
17
|
+
signRead(input: Parameters<CloudflareMediaUrlSigner["signRead"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
18
|
+
private presign;
|
|
19
|
+
}
|
|
20
|
+
export { CloudflareR2S3UrlSigner as CloudflareR2S3Signer };
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { CloudflareMediaUrlSigner, CloudflareMediaUrlTarget, CloudflareR2S3UrlSignerOptions } from "./types.js";
|
|
2
|
+
/**
|
|
3
|
+
* Worker-compatible AWS Signature Version 4 presigner for R2's
|
|
4
|
+
* S3-compatible endpoint. Credentials stay in the server/Worker that creates
|
|
5
|
+
* the signer; only the resulting short-lived target is returned to callers.
|
|
6
|
+
*/
|
|
7
|
+
export declare class CloudflareR2S3UrlSigner implements CloudflareMediaUrlSigner {
|
|
8
|
+
private readonly endpoint;
|
|
9
|
+
private readonly bucketName;
|
|
10
|
+
private readonly accessKeyId;
|
|
11
|
+
private readonly secretAccessKey;
|
|
12
|
+
private readonly region;
|
|
13
|
+
private readonly now;
|
|
14
|
+
constructor(options: CloudflareR2S3UrlSignerOptions);
|
|
15
|
+
signUpload(input: Parameters<CloudflareMediaUrlSigner["signUpload"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
16
|
+
signMultipartPart(input: Parameters<CloudflareMediaUrlSigner["signMultipartPart"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
17
|
+
signRead(input: Parameters<CloudflareMediaUrlSigner["signRead"]>[0]): Promise<CloudflareMediaUrlTarget>;
|
|
18
|
+
private presign;
|
|
19
|
+
}
|
|
20
|
+
export { CloudflareR2S3UrlSigner as CloudflareR2S3Signer };
|