@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.
Files changed (53) hide show
  1. package/README.md +71 -2
  2. package/ai/instructions.md +20 -0
  3. package/ai/manifest.json +10 -0
  4. package/dist/LICENSE +21 -0
  5. package/dist/bucket-provisioner.cjs +37 -0
  6. package/dist/bucket-provisioner.cjs.map +1 -0
  7. package/dist/bucket-provisioner.d.cts +16 -0
  8. package/dist/bucket-provisioner.d.ts +16 -0
  9. package/dist/bucket-provisioner.js +37 -0
  10. package/dist/bucket-provisioner.js.map +1 -0
  11. package/dist/errors.cjs +35 -0
  12. package/dist/errors.cjs.map +1 -0
  13. package/dist/errors.d.cts +17 -0
  14. package/dist/errors.d.ts +17 -0
  15. package/dist/errors.js +32 -0
  16. package/dist/errors.js.map +1 -0
  17. package/dist/images-processor.cjs +100 -0
  18. package/dist/images-processor.cjs.map +1 -0
  19. package/dist/images-processor.d.cts +15 -0
  20. package/dist/images-processor.d.ts +15 -0
  21. package/dist/images-processor.js +100 -0
  22. package/dist/images-processor.js.map +1 -0
  23. package/dist/index.cjs +28 -0
  24. package/dist/index.d.cts +9 -0
  25. package/dist/index.d.ts +9 -0
  26. package/dist/index.js +8 -0
  27. package/dist/metadata-store.cjs +69 -0
  28. package/dist/metadata-store.cjs.map +1 -0
  29. package/dist/metadata-store.d.cts +23 -0
  30. package/dist/metadata-store.d.ts +23 -0
  31. package/dist/metadata-store.js +69 -0
  32. package/dist/metadata-store.js.map +1 -0
  33. package/dist/r2-adapter.cjs +393 -0
  34. package/dist/r2-adapter.cjs.map +1 -0
  35. package/dist/r2-adapter.d.cts +40 -0
  36. package/dist/r2-adapter.d.ts +40 -0
  37. package/dist/r2-adapter.js +393 -0
  38. package/dist/r2-adapter.js.map +1 -0
  39. package/dist/s3-signer.cjs +106 -0
  40. package/dist/s3-signer.cjs.map +1 -0
  41. package/dist/s3-signer.d.cts +20 -0
  42. package/dist/s3-signer.d.ts +20 -0
  43. package/dist/s3-signer.js +105 -0
  44. package/dist/s3-signer.js.map +1 -0
  45. package/dist/types.d.cts +212 -0
  46. package/dist/types.d.ts +212 -0
  47. package/dist/utils.cjs +59 -0
  48. package/dist/utils.cjs.map +1 -0
  49. package/dist/utils.d.cts +10 -0
  50. package/dist/utils.d.ts +10 -0
  51. package/dist/utils.js +51 -0
  52. package/dist/utils.js.map +1 -0
  53. package/package.json +59 -4
@@ -0,0 +1,393 @@
1
+ const require_errors = require("./errors.cjs");
2
+ const require_utils = require("./utils.cjs");
3
+ let _puzzle_ui_media = require("@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 require_errors.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 ? require_utils.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
+ require_utils.validatePositiveInteger(this.maxSignedUrlTtlMs, "maxSignedUrlTtlMs");
33
+ require_utils.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 = require_utils.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
+ require_utils.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 require_errors.CloudflareMediaConfigurationError("The configured R2 bucket does not expose multipart upload support.");
85
+ const key = require_utils.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 require_errors.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 _puzzle_ui_media.MediaAssetConflictError("The upload session is not multipart.");
118
+ require_utils.validateExpiry(expiresInMs, "expiresInMs", this.maxSignedUrlTtlMs);
119
+ if (partNumbers.length === 0) throw new _puzzle_ui_media.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 _puzzle_ui_media.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 _puzzle_ui_media.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 _puzzle_ui_media.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 && !require_utils.checksumEquals(object.checksum, upload.session.expectedChecksum)) throw new _puzzle_ui_media.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 = require_utils.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 = require_utils.normalizeReference(object);
208
+ require_utils.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 _puzzle_ui_media.MediaNotFoundError("Media object");
211
+ const target = await this.getBucketTarget(record.object.tenantId);
212
+ if (!await target.bucket.head(record.key)) throw new _puzzle_ui_media.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 = require_utils.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
+ require_utils.validatePositiveInteger(input.first, "first");
237
+ if (input.first > this.maxListPageSize) throw new _puzzle_ui_media.MediaObjectStorageError("Object list page exceeds the configured limit.");
238
+ if (input.olderThan && !Number.isFinite(input.olderThan.getTime())) throw new _puzzle_ui_media.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) ? require_utils.cursorForObject(pageRecords.at(-1).key) : null
256
+ };
257
+ }
258
+ async listExpiredUploadSessions(before, first) {
259
+ if (!Number.isFinite(before.getTime())) throw new _puzzle_ui_media.MediaObjectStorageError("before must be a valid date.");
260
+ require_utils.validatePositiveInteger(first, "first");
261
+ if (first > this.maxListPageSize) throw new _puzzle_ui_media.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 _puzzle_ui_media.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 _puzzle_ui_media.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 require_errors.CloudflareMediaConfigurationError("The configured R2 bucket cannot resume multipart uploads.");
279
+ if (!Number.isSafeInteger(partNumber) || partNumber < 1) throw new _puzzle_ui_media.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 = require_utils.validateUploadConstraints(input);
287
+ if (this.tenantId && constraints.tenantId !== this.tenantId) throw new _puzzle_ui_media.MediaObjectStorageError("The upload tenant is outside this adapter scope.");
288
+ require_utils.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 _puzzle_ui_media.MediaNotFoundError("Upload session");
314
+ return upload;
315
+ }
316
+ assertPending(upload) {
317
+ if (upload.session.state === "completed") throw new _puzzle_ui_media.MediaAssetConflictError("The upload session is already completed.");
318
+ if (upload.session.state === "aborted") throw new _puzzle_ui_media.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 _puzzle_ui_media.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 require_errors.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 _puzzle_ui_media.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 _puzzle_ui_media.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 _puzzle_ui_media.MediaNotFoundError("Uploaded media object");
360
+ let body;
361
+ try {
362
+ const object = await bucket.get(upload.key);
363
+ if (!object) throw new _puzzle_ui_media.MediaNotFoundError("Uploaded media object");
364
+ body = new Uint8Array(await object.arrayBuffer());
365
+ } catch (error) {
366
+ if (error instanceof _puzzle_ui_media.MediaNotFoundError) throw error;
367
+ throw providerError("Unable to read the uploaded R2 object.", error);
368
+ }
369
+ if (head.size !== body.byteLength) throw new _puzzle_ui_media.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 require_utils.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 _puzzle_ui_media.MediaObjectStorageError("Object list cursor is invalid.");
389
+ }
390
+ };
391
+ exports.CloudflareR2MediaObjectStorageAdapter = CloudflareR2MediaObjectStorageAdapter;
392
+
393
+ //# sourceMappingURL=r2-adapter.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"r2-adapter.cjs","names":["CloudflareMediaProviderError","validateTenantId","createTenantObjectKey","CloudflareMediaConfigurationError","MediaAssetConflictError","MediaObjectStorageError","MediaNotFoundError","checksumEquals","MediaChecksumMismatchError","normalizeReference","cursorForObject","validateUploadConstraints","MediaUploadExpiredError","sha256"],"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,IAAIA,eAAAA,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,WAAWC,cAAAA,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,cAAA,wBAAwB,KAAK,mBAAmB,mBAAmB;EACnE,cAAA,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,MAAMC,cAAAA,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,cAAA,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,IAAIC,eAAAA,kCACR,oEACF;EAEF,MAAM,MAAMD,cAAAA,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,IAAIC,eAAAA,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,IAAIC,iBAAAA,wBAAwB,sCAAsC;EAE1E,cAAA,eAAe,aAAa,eAAe,KAAK,iBAAiB;EACjE,IAAI,YAAY,WAAW,GACzB,MAAM,IAAIC,iBAAAA,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,IAAIA,iBAAAA,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,IAAIC,iBAAAA,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,IAAID,iBAAAA,wBACR,6DACA,EACE,SAAS;GACP,cAAc,OAAO,QAAQ;GAC7B,YAAY,OAAO;EACrB,EACF,CACF;EAEF,IACE,OAAO,QAAQ,oBACf,CAACE,cAAAA,eAAe,OAAO,UAAW,OAAO,QAAQ,gBAAgB,GAEjE,MAAM,IAAIC,iBAAAA,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,YAAYC,cAAAA,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,YAAYA,cAAAA,mBAAmB,MAAM;EAC3C,cAAA,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,IAAIH,iBAAAA,mBAAmB,cAAc;EAE7C,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,OAAO,QAAQ;EAChE,IAAI,CAAE,MAAM,OAAO,OAAO,KAAK,OAAO,GAAG,GACvC,MAAM,IAAIA,iBAAAA,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,YAAYG,cAAAA,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,cAAA,wBAAwB,MAAM,OAAO,OAAO;EAC5C,IAAI,MAAM,QAAQ,KAAK,iBACrB,MAAM,IAAIJ,iBAAAA,wBAAwB,gDAAgD;EAEpF,IAAI,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,UAAU,QAAQ,CAAC,GAC/D,MAAM,IAAIA,iBAAAA,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,IAC7CK,cAAAA,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,IAAIL,iBAAAA,wBAAwB,8BAA8B;EAElE,cAAA,wBAAwB,OAAO,OAAO;EACtC,IAAI,QAAQ,KAAK,iBACf,MAAM,IAAIA,iBAAAA,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,IAAID,iBAAAA,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,IAAIA,iBAAAA,wBAAwB,sCAAsC;EAE1E,MAAM,SAAS,MAAM,KAAK,gBAAgB,OAAO,QAAQ;EACzD,MAAM,YAAY,KAAK,gBAAgB,OAAO,QAAQ,MAAM;EAC5D,IAAI,CAAC,WACH,MAAM,IAAID,eAAAA,kCACR,2DACF;EAEF,IAAI,CAAC,OAAO,cAAc,UAAU,KAAK,aAAa,GACpD,MAAM,IAAIE,iBAAAA,wBAAwB,6CAA6C;EAGjF,OAAO;GAAE;GAAY,OAAM,MADN,UAAU,WAAW,YAAY,KAAK,EAAA,CACzB;EAAK;CACzC;CAEA,mBAA2B,OAAuD;EAChF,MAAM,cAAcM,cAAAA,0BAA0B,KAAK;EACnD,IAAI,KAAK,YAAY,YAAY,aAAa,KAAK,UACjD,MAAM,IAAIN,iBAAAA,wBAAwB,kDAAkD;EAEtF,cAAA,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,IAAIC,iBAAAA,mBAAmB,gBAAgB;EAC1D,OAAO;CACT;CAEA,cAAsB,QAA4B;EAChD,IAAI,OAAO,QAAQ,UAAU,aAC3B,MAAM,IAAIF,iBAAAA,wBAAwB,0CAA0C;EAE9E,IAAI,OAAO,QAAQ,UAAU,WAC3B,MAAM,IAAIA,iBAAAA,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,IAAIQ,iBAAAA,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,IAAIT,eAAAA,kCACR,2DACF;EAEF,IAAI,YAAY;EAChB,IAAI,CAAC,aAAa,UAAU,WAC1B,YAAY,MAAM,UAAU,UAAU;EAExC,IAAI,CAAC,aAAa,UAAU,WAAW,GACrC,MAAM,IAAIC,iBAAAA,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,IAAIC,iBAAAA,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,IAAIC,iBAAAA,mBAAmB,uBAAuB;EAC/D,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,MAAM,OAAO,IAAI,OAAO,GAAG;GAC1C,IAAI,CAAC,QAAQ,MAAM,IAAIA,iBAAAA,mBAAmB,uBAAuB;GACjE,OAAO,IAAI,WAAW,MAAM,OAAO,YAAY,CAAC;EAClD,SAAS,OAAO;GACd,IAAI,iBAAiBA,iBAAAA,oBAAoB,MAAM;GAC/C,MAAM,cAAc,0CAA0C,KAAK;EACrE;EACA,IAAI,KAAK,SAAS,KAAK,YACrB,MAAM,IAAID,iBAAAA,wBACR,8DACA,EAAE,SAAS;GAAE,cAAc,KAAK;GAAM,YAAY,KAAK;EAAW,EAAE,CACtE;EAEF,MAAM,WAAW,MAAMQ,cAAAA,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,IAAIR,iBAAAA,wBAAwB,gCAAgC;CACpE;AACF"}
@@ -0,0 +1,40 @@
1
+ import { CloudflareR2MediaObjectStorageOptions } from "./types.cjs";
2
+ import { MediaMultipartCompletedPart, MediaMultipartPartTarget, MediaObjectListInput, MediaObjectPage, MediaObjectReference, MediaObjectStorageAdapter, MediaReadTarget, MediaStoredObject, MediaUploadConstraints, MediaUploadSession } from "@puzzle-ui/media";
3
+ export declare class CloudflareR2MediaObjectStorageAdapter implements MediaObjectStorageAdapter {
4
+ private readonly bucketSource;
5
+ private readonly metadataStore;
6
+ private readonly tenantId?;
7
+ private readonly bucketName?;
8
+ private readonly idFactory;
9
+ private readonly now;
10
+ private readonly maxSignedUrlTtlMs;
11
+ private readonly maxListPageSize;
12
+ private nextId;
13
+ constructor(options: CloudflareR2MediaObjectStorageOptions);
14
+ createUploadIntent(input: MediaUploadConstraints): Promise<MediaUploadSession>;
15
+ createMultipartUpload(input: MediaUploadConstraints & {
16
+ readonly partSizeBytes: number;
17
+ }): Promise<MediaUploadSession>;
18
+ createMultipartPartTargets(sessionId: string, partNumbers: readonly number[], expiresInMs: number): Promise<readonly MediaMultipartPartTarget[]>;
19
+ completeUpload(sessionId: string, parts?: readonly MediaMultipartCompletedPart[]): Promise<MediaStoredObject>;
20
+ abortUpload(sessionId: string): Promise<boolean>;
21
+ getUploadSession(sessionId: string): Promise<MediaUploadSession | null>;
22
+ getObjectMetadata(object: MediaObjectReference): Promise<MediaStoredObject | null>;
23
+ createReadTarget(object: MediaObjectReference, expiresInMs: number): Promise<MediaReadTarget>;
24
+ deleteObject(object: MediaObjectReference): Promise<boolean>;
25
+ listObjects(input: MediaObjectListInput): Promise<MediaObjectPage>;
26
+ listExpiredUploadSessions(before: Date, first: number): Promise<readonly MediaUploadSession[]>;
27
+ /** Test/local-development helper that bypasses presigned HTTP delivery. */
28
+ putForTesting(sessionId: string, bytes: Uint8Array, contentType: string): Promise<void>;
29
+ /** Test/local-development helper that bypasses presigned HTTP delivery. */
30
+ putPartForTesting(sessionId: string, partNumber: number, bytes: Uint8Array): Promise<MediaMultipartCompletedPart>;
31
+ private prepareConstraints;
32
+ private expiry;
33
+ private getBucketTarget;
34
+ private findUpload;
35
+ private requireUpload;
36
+ private assertPending;
37
+ private resumeMultipart;
38
+ private completeMultipart;
39
+ private readStoredObject;
40
+ }
@@ -0,0 +1,40 @@
1
+ import { CloudflareR2MediaObjectStorageOptions } from "./types.js";
2
+ import { MediaMultipartCompletedPart, MediaMultipartPartTarget, MediaObjectListInput, MediaObjectPage, MediaObjectReference, MediaObjectStorageAdapter, MediaReadTarget, MediaStoredObject, MediaUploadConstraints, MediaUploadSession } from "@puzzle-ui/media";
3
+ export declare class CloudflareR2MediaObjectStorageAdapter implements MediaObjectStorageAdapter {
4
+ private readonly bucketSource;
5
+ private readonly metadataStore;
6
+ private readonly tenantId?;
7
+ private readonly bucketName?;
8
+ private readonly idFactory;
9
+ private readonly now;
10
+ private readonly maxSignedUrlTtlMs;
11
+ private readonly maxListPageSize;
12
+ private nextId;
13
+ constructor(options: CloudflareR2MediaObjectStorageOptions);
14
+ createUploadIntent(input: MediaUploadConstraints): Promise<MediaUploadSession>;
15
+ createMultipartUpload(input: MediaUploadConstraints & {
16
+ readonly partSizeBytes: number;
17
+ }): Promise<MediaUploadSession>;
18
+ createMultipartPartTargets(sessionId: string, partNumbers: readonly number[], expiresInMs: number): Promise<readonly MediaMultipartPartTarget[]>;
19
+ completeUpload(sessionId: string, parts?: readonly MediaMultipartCompletedPart[]): Promise<MediaStoredObject>;
20
+ abortUpload(sessionId: string): Promise<boolean>;
21
+ getUploadSession(sessionId: string): Promise<MediaUploadSession | null>;
22
+ getObjectMetadata(object: MediaObjectReference): Promise<MediaStoredObject | null>;
23
+ createReadTarget(object: MediaObjectReference, expiresInMs: number): Promise<MediaReadTarget>;
24
+ deleteObject(object: MediaObjectReference): Promise<boolean>;
25
+ listObjects(input: MediaObjectListInput): Promise<MediaObjectPage>;
26
+ listExpiredUploadSessions(before: Date, first: number): Promise<readonly MediaUploadSession[]>;
27
+ /** Test/local-development helper that bypasses presigned HTTP delivery. */
28
+ putForTesting(sessionId: string, bytes: Uint8Array, contentType: string): Promise<void>;
29
+ /** Test/local-development helper that bypasses presigned HTTP delivery. */
30
+ putPartForTesting(sessionId: string, partNumber: number, bytes: Uint8Array): Promise<MediaMultipartCompletedPart>;
31
+ private prepareConstraints;
32
+ private expiry;
33
+ private getBucketTarget;
34
+ private findUpload;
35
+ private requireUpload;
36
+ private assertPending;
37
+ private resumeMultipart;
38
+ private completeMultipart;
39
+ private readStoredObject;
40
+ }