@adonis-agora/media 0.28.2 → 0.29.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/CHANGELOG.md +24 -0
- package/README.md +43 -0
- package/dist/assets/spa/assets/index-x-AtgWkE.js +12 -0
- package/dist/assets/spa/assets/index-x-AtgWkE.js.map +1 -0
- package/dist/assets/spa/index.html +1 -1
- package/dist/src/media_manager.d.ts +33 -7
- package/dist/src/media_manager.d.ts.map +1 -1
- package/dist/src/media_manager.js +121 -27
- package/dist/src/media_manager.js.map +1 -1
- package/dist/src/testing/index.d.ts +2 -0
- package/dist/src/testing/index.d.ts.map +1 -1
- package/dist/src/testing/index.js +1 -0
- package/dist/src/testing/index.js.map +1 -1
- package/dist/src/testing/media_fake.d.ts +93 -0
- package/dist/src/testing/media_fake.d.ts.map +1 -0
- package/dist/src/testing/media_fake.js +150 -0
- package/dist/src/testing/media_fake.js.map +1 -0
- package/package.json +3 -3
- package/dist/assets/spa/assets/index-C7-E4B8r.js +0 -12
- package/dist/assets/spa/assets/index-C7-E4B8r.js.map +0 -1
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
rel="stylesheet"
|
|
12
12
|
/>
|
|
13
13
|
<title>Media · Agora</title>
|
|
14
|
-
<script type="module" crossorigin src="/__MEDIA_DASHBOARD__/assets/index-
|
|
14
|
+
<script type="module" crossorigin src="/__MEDIA_DASHBOARD__/assets/index-x-AtgWkE.js"></script>
|
|
15
15
|
<link rel="stylesheet" crossorigin href="/__MEDIA_DASHBOARD__/assets/index-CrdjxPM5.css">
|
|
16
16
|
</head>
|
|
17
17
|
<body>
|
|
@@ -13,6 +13,7 @@ import type { MediaStore } from './media_store.js';
|
|
|
13
13
|
import type { UploadSessionStore } from './resumable_upload.js';
|
|
14
14
|
import { ResumableUploadManager } from './resumable_upload.js';
|
|
15
15
|
import { StorageManager } from './storage_manager.js';
|
|
16
|
+
import { MediaFake, type MediaFakeOptions } from './testing/media_fake.js';
|
|
16
17
|
import type { DiskResolver, MultipartPart } from './types.js';
|
|
17
18
|
import { type AbortDirectUploadInput, type CompleteDirectUploadInput, type DirectUploadCreated, type InitiateDirectUploadInput, type ProxyUploadInput, UploadManager } from './upload_manager.js';
|
|
18
19
|
import type { UploadMode } from './upload_mode.js';
|
|
@@ -81,19 +82,44 @@ export interface MediaManagerOptions {
|
|
|
81
82
|
*/
|
|
82
83
|
export declare class MediaManager {
|
|
83
84
|
#private;
|
|
84
|
-
|
|
85
|
-
|
|
85
|
+
constructor(options: MediaManagerOptions);
|
|
86
|
+
/** Storage façade the layers resolve disks through. */
|
|
87
|
+
get storage(): StorageManager;
|
|
88
|
+
/** Owner collections + conversions. While {@link fake} is active, the recording in-memory twin. */
|
|
89
|
+
get library(): MediaLibrary;
|
|
86
90
|
/** Authorization for media: the delivery route, authorized `image()`, `authorize()`/`can()`. */
|
|
87
|
-
|
|
88
|
-
|
|
91
|
+
get access(): MediaAccess;
|
|
92
|
+
/** Column attachments. */
|
|
93
|
+
get attachments(): AttachmentManager;
|
|
89
94
|
/**
|
|
90
95
|
* The configured persistence SPI. Exposed for management/console reads (e.g. the cross-owner
|
|
91
96
|
* {@link MediaStore.list}); day-to-day writes go through {@link MediaManager.library}.
|
|
92
97
|
*/
|
|
93
|
-
|
|
98
|
+
get store(): MediaStore;
|
|
94
99
|
/** Direct-S3 upload coordinator (proxy + direct multipart modes). */
|
|
95
|
-
|
|
96
|
-
|
|
100
|
+
get uploads(): UploadManager;
|
|
101
|
+
/**
|
|
102
|
+
* Swap the whole manager onto in-memory doubles — the `drive.fake()` / `mail.fake()` of this
|
|
103
|
+
* package. Because the swap happens INSIDE the manager, code that already holds it (the
|
|
104
|
+
* `@adonis-agora/media/services/main` singleton, captured once at boot) sees the fake too.
|
|
105
|
+
*
|
|
106
|
+
* The twin runs the real {@link MediaLibrary} with this manager's collections and delivery
|
|
107
|
+
* settings over an `InMemoryMediaStore`, in-memory disks for every disk name and a
|
|
108
|
+
* `FakeImageProcessor`, so attach/list/deliver/signedUrl/delete keep their real semantics. Every
|
|
109
|
+
* `media.library` call is recorded on the returned {@link MediaFake}, which can also stub a method.
|
|
110
|
+
*
|
|
111
|
+
* Calling it again replaces the previous fake with a fresh one. Undo with {@link restore}.
|
|
112
|
+
*
|
|
113
|
+
* ```ts
|
|
114
|
+
* const fake = media.fake()
|
|
115
|
+
* // ... exercise the app ...
|
|
116
|
+
* fake.assertCalled('delete', (id) => id === record.id)
|
|
117
|
+
* media.restore()
|
|
118
|
+
* ```
|
|
119
|
+
*/
|
|
120
|
+
fake(options?: MediaFakeOptions): MediaFake;
|
|
121
|
+
/** Undo {@link fake}: the real store, disks and library are back. A no-op when not faked. */
|
|
122
|
+
restore(): void;
|
|
97
123
|
/**
|
|
98
124
|
* The resumable (TUS) upload coordinator. Throws {@link ResumableUploadsNotConfiguredError} unless
|
|
99
125
|
* a session store was configured via `uploads.resumable` in `config/media.ts`.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"media_manager.d.ts","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"media_manager.d.ts","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,6 +5,10 @@ import { MediaAccess } from './media_access.js';
|
|
|
5
5
|
import { MediaLibrary } from './media_library.js';
|
|
6
6
|
import { ResumableUploadManager } from './resumable_upload.js';
|
|
7
7
|
import { StorageManager } from './storage_manager.js';
|
|
8
|
+
import { FakeImageProcessor } from './testing/fake_image_processor.js';
|
|
9
|
+
import { InMemoryMediaStore } from './testing/in_memory_media_store.js';
|
|
10
|
+
import { InMemoryUploadSessionStore } from './testing/in_memory_upload_session_store.js';
|
|
11
|
+
import { lazyInMemoryDiskResolver, MediaFake, } from './testing/media_fake.js';
|
|
8
12
|
import { UploadManager, } from './upload_manager.js';
|
|
9
13
|
/**
|
|
10
14
|
* The singleton bound into the AdonisJS container as `MediaManager`. Composes the two layers over a
|
|
@@ -18,27 +22,26 @@ import { UploadManager, } from './upload_manager.js';
|
|
|
18
22
|
* ```
|
|
19
23
|
*/
|
|
20
24
|
export class MediaManager {
|
|
21
|
-
storage;
|
|
22
|
-
library;
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
* The configured persistence SPI. Exposed for management/console reads (e.g. the cross-owner
|
|
28
|
-
* {@link MediaStore.list}); day-to-day writes go through {@link MediaManager.library}.
|
|
29
|
-
*/
|
|
30
|
-
store;
|
|
31
|
-
/** Direct-S3 upload coordinator (proxy + direct multipart modes). */
|
|
32
|
-
uploads;
|
|
25
|
+
#storage;
|
|
26
|
+
#library;
|
|
27
|
+
#access;
|
|
28
|
+
#attachments;
|
|
29
|
+
#store;
|
|
30
|
+
#uploads;
|
|
33
31
|
/** Resumable (TUS) upload coordinator — present only when a session store is configured. */
|
|
34
32
|
#resumable;
|
|
35
33
|
/** Session-backed direct upload coordinator — present only when a session store is configured. */
|
|
36
34
|
#direct;
|
|
35
|
+
/** Kept so {@link fake} can build an in-memory twin with the same collections and settings. */
|
|
36
|
+
#options;
|
|
37
|
+
/** The in-memory twin every accessor defers to while {@link fake} is active. */
|
|
38
|
+
#fake;
|
|
37
39
|
constructor(options) {
|
|
38
|
-
this
|
|
39
|
-
this
|
|
40
|
-
this
|
|
41
|
-
|
|
40
|
+
this.#options = options;
|
|
41
|
+
this.#store = options.store;
|
|
42
|
+
this.#storage = new StorageManager({ default: options.defaultDisk, resolve: options.resolve });
|
|
43
|
+
this.#library = new MediaLibrary({
|
|
44
|
+
storage: this.#storage,
|
|
42
45
|
store: options.store,
|
|
43
46
|
...(options.collections !== undefined ? { collections: options.collections } : {}),
|
|
44
47
|
...(options.imageProcessor !== undefined ? { imageProcessor: options.imageProcessor } : {}),
|
|
@@ -58,12 +61,12 @@ export class MediaManager {
|
|
|
58
61
|
? { deliveryStreamPath: options.deliveryStreamPath }
|
|
59
62
|
: {}),
|
|
60
63
|
});
|
|
61
|
-
this
|
|
62
|
-
library: this
|
|
64
|
+
this.#access = new MediaAccess({
|
|
65
|
+
library: this.#library,
|
|
63
66
|
...(options.accessIdentity !== undefined ? { identity: options.accessIdentity } : {}),
|
|
64
67
|
});
|
|
65
|
-
this
|
|
66
|
-
storage: this
|
|
68
|
+
this.#attachments = new AttachmentManager({
|
|
69
|
+
storage: this.#storage,
|
|
67
70
|
...(options.imageProcessor !== undefined ? { imageProcessor: options.imageProcessor } : {}),
|
|
68
71
|
...(options.attachmentKeyPrefix !== undefined
|
|
69
72
|
? { keyPrefix: options.attachmentKeyPrefix }
|
|
@@ -72,8 +75,8 @@ export class MediaManager {
|
|
|
72
75
|
? { emitDiagnostics: options.emitDiagnostics }
|
|
73
76
|
: {}),
|
|
74
77
|
});
|
|
75
|
-
this
|
|
76
|
-
storage: this
|
|
78
|
+
this.#uploads = new UploadManager({
|
|
79
|
+
storage: this.#storage,
|
|
77
80
|
...(options.uploadMode !== undefined ? { mode: options.uploadMode } : {}),
|
|
78
81
|
...(options.uploadPartSize !== undefined ? { partSize: options.uploadPartSize } : {}),
|
|
79
82
|
...(options.uploadPresignTtlSeconds !== undefined
|
|
@@ -85,7 +88,7 @@ export class MediaManager {
|
|
|
85
88
|
});
|
|
86
89
|
if (options.uploadSessions !== undefined) {
|
|
87
90
|
this.#resumable = new ResumableUploadManager({
|
|
88
|
-
storage: this
|
|
91
|
+
storage: this.#storage,
|
|
89
92
|
sessions: options.uploadSessions,
|
|
90
93
|
...(options.resumableTmpPrefix !== undefined
|
|
91
94
|
? { tmpPrefix: options.resumableTmpPrefix }
|
|
@@ -100,11 +103,11 @@ export class MediaManager {
|
|
|
100
103
|
}
|
|
101
104
|
if (options.directUploadSessions !== undefined) {
|
|
102
105
|
this.#direct = new DirectUploadManager({
|
|
103
|
-
storage: this
|
|
106
|
+
storage: this.#storage,
|
|
104
107
|
sessions: options.directUploadSessions,
|
|
105
108
|
// The manager reads the whitelist from the same registry attach uses, so the initiate
|
|
106
109
|
// gate and the attach-time barrier cannot drift.
|
|
107
|
-
collections: this
|
|
110
|
+
collections: this.#library.collections,
|
|
108
111
|
...(options.directPartSize !== undefined ? { partSize: options.directPartSize } : {}),
|
|
109
112
|
...(options.directPresignTtlSeconds !== undefined
|
|
110
113
|
? { presignTtlSeconds: options.directPresignTtlSeconds }
|
|
@@ -118,11 +121,100 @@ export class MediaManager {
|
|
|
118
121
|
});
|
|
119
122
|
}
|
|
120
123
|
}
|
|
124
|
+
/** Storage façade the layers resolve disks through. */
|
|
125
|
+
get storage() {
|
|
126
|
+
return this.#fake ? this.#fake.manager.storage : this.#storage;
|
|
127
|
+
}
|
|
128
|
+
/** Owner collections + conversions. While {@link fake} is active, the recording in-memory twin. */
|
|
129
|
+
get library() {
|
|
130
|
+
return this.#fake ? this.#fake.handle.library : this.#library;
|
|
131
|
+
}
|
|
132
|
+
/** Authorization for media: the delivery route, authorized `image()`, `authorize()`/`can()`. */
|
|
133
|
+
get access() {
|
|
134
|
+
return this.#fake ? this.#fake.access : this.#access;
|
|
135
|
+
}
|
|
136
|
+
/** Column attachments. */
|
|
137
|
+
get attachments() {
|
|
138
|
+
return this.#fake ? this.#fake.manager.attachments : this.#attachments;
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* The configured persistence SPI. Exposed for management/console reads (e.g. the cross-owner
|
|
142
|
+
* {@link MediaStore.list}); day-to-day writes go through {@link MediaManager.library}.
|
|
143
|
+
*/
|
|
144
|
+
get store() {
|
|
145
|
+
return this.#fake ? this.#fake.manager.store : this.#store;
|
|
146
|
+
}
|
|
147
|
+
/** Direct-S3 upload coordinator (proxy + direct multipart modes). */
|
|
148
|
+
get uploads() {
|
|
149
|
+
return this.#fake ? this.#fake.manager.uploads : this.#uploads;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Swap the whole manager onto in-memory doubles — the `drive.fake()` / `mail.fake()` of this
|
|
153
|
+
* package. Because the swap happens INSIDE the manager, code that already holds it (the
|
|
154
|
+
* `@adonis-agora/media/services/main` singleton, captured once at boot) sees the fake too.
|
|
155
|
+
*
|
|
156
|
+
* The twin runs the real {@link MediaLibrary} with this manager's collections and delivery
|
|
157
|
+
* settings over an `InMemoryMediaStore`, in-memory disks for every disk name and a
|
|
158
|
+
* `FakeImageProcessor`, so attach/list/deliver/signedUrl/delete keep their real semantics. Every
|
|
159
|
+
* `media.library` call is recorded on the returned {@link MediaFake}, which can also stub a method.
|
|
160
|
+
*
|
|
161
|
+
* Calling it again replaces the previous fake with a fresh one. Undo with {@link restore}.
|
|
162
|
+
*
|
|
163
|
+
* ```ts
|
|
164
|
+
* const fake = media.fake()
|
|
165
|
+
* // ... exercise the app ...
|
|
166
|
+
* fake.assertCalled('delete', (id) => id === record.id)
|
|
167
|
+
* media.restore()
|
|
168
|
+
* ```
|
|
169
|
+
*/
|
|
170
|
+
fake(options = {}) {
|
|
171
|
+
this.restore();
|
|
172
|
+
const { resolve, disks } = lazyInMemoryDiskResolver(this.#options.defaultDisk, options.visibility);
|
|
173
|
+
const store = options.store ?? new InMemoryMediaStore();
|
|
174
|
+
const manager = new MediaManager({
|
|
175
|
+
...this.#options,
|
|
176
|
+
resolve,
|
|
177
|
+
store,
|
|
178
|
+
imageProcessor: options.imageProcessor ?? new FakeImageProcessor(),
|
|
179
|
+
...(this.#options.uploadSessions !== undefined
|
|
180
|
+
? { uploadSessions: new InMemoryUploadSessionStore() }
|
|
181
|
+
: {}),
|
|
182
|
+
...(this.#options.directUploadSessions !== undefined
|
|
183
|
+
? { directUploadSessions: new InMemoryUploadSessionStore() }
|
|
184
|
+
: {}),
|
|
185
|
+
});
|
|
186
|
+
const handle = new MediaFake({
|
|
187
|
+
library: manager.library,
|
|
188
|
+
store,
|
|
189
|
+
resolve,
|
|
190
|
+
disks,
|
|
191
|
+
onRestore: () => {
|
|
192
|
+
if (this.#fake?.handle === handle)
|
|
193
|
+
this.restore();
|
|
194
|
+
},
|
|
195
|
+
});
|
|
196
|
+
// Access goes through the RECORDING library, so `media.access.image/serve` calls are recorded
|
|
197
|
+
// and honour stubs, like a direct `media.library` call.
|
|
198
|
+
const access = new MediaAccess({
|
|
199
|
+
library: handle.library,
|
|
200
|
+
...(this.#options.accessIdentity !== undefined
|
|
201
|
+
? { identity: this.#options.accessIdentity }
|
|
202
|
+
: {}),
|
|
203
|
+
});
|
|
204
|
+
this.#fake = { manager, handle, access };
|
|
205
|
+
return handle;
|
|
206
|
+
}
|
|
207
|
+
/** Undo {@link fake}: the real store, disks and library are back. A no-op when not faked. */
|
|
208
|
+
restore() {
|
|
209
|
+
this.#fake = undefined;
|
|
210
|
+
}
|
|
121
211
|
/**
|
|
122
212
|
* The resumable (TUS) upload coordinator. Throws {@link ResumableUploadsNotConfiguredError} unless
|
|
123
213
|
* a session store was configured via `uploads.resumable` in `config/media.ts`.
|
|
124
214
|
*/
|
|
125
215
|
get resumable() {
|
|
216
|
+
if (this.#fake)
|
|
217
|
+
return this.#fake.manager.resumable;
|
|
126
218
|
if (!this.#resumable)
|
|
127
219
|
throw new ResumableUploadsNotConfiguredError();
|
|
128
220
|
return this.#resumable;
|
|
@@ -152,13 +244,15 @@ export class MediaManager {
|
|
|
152
244
|
* unless a session store was configured via `uploads.direct` in `config/media.ts`.
|
|
153
245
|
*/
|
|
154
246
|
get direct() {
|
|
247
|
+
if (this.#fake)
|
|
248
|
+
return this.#fake.manager.direct;
|
|
155
249
|
if (!this.#direct)
|
|
156
250
|
throw new DirectUploadsNotConfiguredError();
|
|
157
251
|
return this.#direct;
|
|
158
252
|
}
|
|
159
253
|
/** Whether session-backed direct uploads are configured (a session store is present). */
|
|
160
254
|
get hasDirect() {
|
|
161
|
-
return this.#direct !== undefined;
|
|
255
|
+
return this.#fake ? this.#fake.manager.hasDirect : this.#direct !== undefined;
|
|
162
256
|
}
|
|
163
257
|
/**
|
|
164
258
|
* Finish a session-backed direct upload and register the assembled object as a media record, in
|
|
@@ -188,7 +282,7 @@ export class MediaManager {
|
|
|
188
282
|
}
|
|
189
283
|
/** Whether resumable (TUS) uploads are configured (a session store is present). */
|
|
190
284
|
get hasResumable() {
|
|
191
|
-
return this.#resumable !== undefined;
|
|
285
|
+
return this.#fake ? this.#fake.manager.hasResumable : this.#resumable !== undefined;
|
|
192
286
|
}
|
|
193
287
|
/** Resolve a raw disk by name (escape hatch to the underlying Drive disk). */
|
|
194
288
|
disk(name) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"media_manager.js","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,+BAA+B,EAAE,kCAAkC,EAAE,MAAM,aAAa,CAAC;AAElG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"media_manager.js","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,4 +5,6 @@ export type { DiskVisibility } from './in_memory_disk.js';
|
|
|
5
5
|
export { InMemoryDisk, inMemoryDiskResolver } from './in_memory_disk.js';
|
|
6
6
|
export { InMemoryMediaStore } from './in_memory_media_store.js';
|
|
7
7
|
export { InMemoryUploadSessionStore } from './in_memory_upload_session_store.js';
|
|
8
|
+
export type { MediaFakeCall, MediaFakeCalls, MediaFakeMethod, MediaFakeOptions, MediaFakeStub, } from './media_fake.js';
|
|
9
|
+
export { lazyInMemoryDiskResolver, MEDIA_FAKE_METHODS, MediaFake } from './media_fake.js';
|
|
8
10
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
|
|
@@ -3,4 +3,5 @@ export { FakeTransformer } from './fake_transformer.js';
|
|
|
3
3
|
export { InMemoryDisk, inMemoryDiskResolver } from './in_memory_disk.js';
|
|
4
4
|
export { InMemoryMediaStore } from './in_memory_media_store.js';
|
|
5
5
|
export { InMemoryUploadSessionStore } from './in_memory_upload_session_store.js';
|
|
6
|
+
export { lazyInMemoryDiskResolver, MEDIA_FAKE_METHODS, MediaFake } from './media_fake.js';
|
|
6
7
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAQjF,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { ImageProcessor } from '../image_processor.js';
|
|
2
|
+
import type { MediaLibrary } from '../media_library.js';
|
|
3
|
+
import type { MediaStore } from '../media_store.js';
|
|
4
|
+
import { type DiskVisibility, InMemoryDisk } from './in_memory_disk.js';
|
|
5
|
+
/**
|
|
6
|
+
* The {@link MediaLibrary} methods a {@link MediaFake} records and lets you {@link MediaFake.stub}.
|
|
7
|
+
* `for(...)` is not listed: its binding calls `attach`/`attachExisting`/`list` through the fake,
|
|
8
|
+
* so those are what get recorded.
|
|
9
|
+
*/
|
|
10
|
+
export declare const MEDIA_FAKE_METHODS: readonly ['attach', 'attachExisting', 'list', 'find', 'delete', 'url', 'deliver', 'signedUrl', 'ensureConversion', 'transform'];
|
|
11
|
+
/** A {@link MediaLibrary} method name a {@link MediaFake} records. */
|
|
12
|
+
export type MediaFakeMethod = (typeof MEDIA_FAKE_METHODS)[number];
|
|
13
|
+
/** The arguments of one recorded call, typed per method (`signedUrl` → `[id, expiresIn, options?]`). */
|
|
14
|
+
export type MediaFakeCall<K extends MediaFakeMethod> = Parameters<MediaLibrary[K]>;
|
|
15
|
+
/** Every recorded call, per method, in call order. */
|
|
16
|
+
export type MediaFakeCalls = {
|
|
17
|
+
readonly [K in MediaFakeMethod]: MediaFakeCall<K>[];
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
* A replacement for one library method. May return the value or a promise of it, and may throw —
|
|
21
|
+
* a synchronous throw still surfaces as a rejected promise, like the real method.
|
|
22
|
+
*/
|
|
23
|
+
export type MediaFakeStub<K extends MediaFakeMethod> = (...args: MediaFakeCall<K>) => Awaited<ReturnType<MediaLibrary[K]>> | ReturnType<MediaLibrary[K]>;
|
|
24
|
+
/** Options for `media.fake()`. */
|
|
25
|
+
export interface MediaFakeOptions {
|
|
26
|
+
/**
|
|
27
|
+
* Visibility every in-memory disk reports — drives `delivery.mode: 'auto'` (`private` → signed
|
|
28
|
+
* redirect, `public` → public redirect, `unknown` → proxy stream). Default `private`.
|
|
29
|
+
*/
|
|
30
|
+
visibility?: DiskVisibility;
|
|
31
|
+
/** Store backing the fake. Default: a fresh `InMemoryMediaStore`. */
|
|
32
|
+
store?: MediaStore;
|
|
33
|
+
/** Image processor for conversions. Default: a fresh `FakeImageProcessor` (no sharp). */
|
|
34
|
+
imageProcessor?: ImageProcessor;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* In-memory disks created on demand for ANY name, so every disk a config or collection names
|
|
38
|
+
* resolves without listing them up front. `undefined` resolves to `defaultDisk`.
|
|
39
|
+
*/
|
|
40
|
+
export declare function lazyInMemoryDiskResolver(defaultDisk: string, visibility?: DiskVisibility): {
|
|
41
|
+
resolve: (name?: string) => InMemoryDisk;
|
|
42
|
+
disks: Record<string, InMemoryDisk>;
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* The handle `media.fake()` returns. While it is active, `media.library` (and `media.store`,
|
|
46
|
+
* `media.storage`, `media.attachments`, …) run on real library code over in-memory doubles, and
|
|
47
|
+
* every library call is recorded here.
|
|
48
|
+
*
|
|
49
|
+
* ```ts
|
|
50
|
+
* const fake = media.fake()
|
|
51
|
+
* await someCodeThatUploads()
|
|
52
|
+
* fake.assertCalled('attach', (input) => input.collection === 'avatar')
|
|
53
|
+
* assert.equal(fake.calls.signedUrl[0]?.[1], 300) // TTL
|
|
54
|
+
* fake.stub('deliver', async () => ({ kind: 'redirect', url: 'https://x.test' }))
|
|
55
|
+
* media.restore()
|
|
56
|
+
* ```
|
|
57
|
+
*
|
|
58
|
+
* Built by `MediaManager.fake()`; not meant to be constructed directly.
|
|
59
|
+
*/
|
|
60
|
+
export declare class MediaFake {
|
|
61
|
+
#private;
|
|
62
|
+
/** Recorded calls per method — the args tuple of each call, in order. Stubbed calls included. */
|
|
63
|
+
readonly calls: MediaFakeCalls;
|
|
64
|
+
/** The faked library — the very object `media.library` returns while this fake is active. */
|
|
65
|
+
readonly library: MediaLibrary;
|
|
66
|
+
/** The store backing the fake (an `InMemoryMediaStore` unless one was passed). */
|
|
67
|
+
readonly store: MediaStore;
|
|
68
|
+
/** In-memory disks created so far, by name (every name resolves; this lists the ones touched). */
|
|
69
|
+
readonly disks: Record<string, InMemoryDisk>;
|
|
70
|
+
constructor(input: {
|
|
71
|
+
library: MediaLibrary;
|
|
72
|
+
store: MediaStore;
|
|
73
|
+
resolve: (name?: string) => InMemoryDisk;
|
|
74
|
+
disks: Record<string, InMemoryDisk>;
|
|
75
|
+
onRestore: () => void;
|
|
76
|
+
});
|
|
77
|
+
/** The in-memory disk behind `name` (default disk when omitted) — inspect `.files` for bytes. */
|
|
78
|
+
disk(name?: string): InMemoryDisk;
|
|
79
|
+
/**
|
|
80
|
+
* Replace one library method for the rest of this fake (calls are still recorded). Use it to
|
|
81
|
+
* force a result or an error the in-memory library would not produce on its own.
|
|
82
|
+
*/
|
|
83
|
+
stub<K extends MediaFakeMethod>(method: K, implementation: MediaFakeStub<K>): this;
|
|
84
|
+
/** Drop a {@link stub}, so the method runs the real in-memory library again. */
|
|
85
|
+
unstub(method: MediaFakeMethod): this;
|
|
86
|
+
/** Throws unless `method` was called (and, with `predicate`, called with matching args). */
|
|
87
|
+
assertCalled<K extends MediaFakeMethod>(method: K, predicate?: (...args: MediaFakeCall<K>) => boolean): void;
|
|
88
|
+
/** Throws if `method` was called (or, with `predicate`, called with matching args). */
|
|
89
|
+
assertNotCalled<K extends MediaFakeMethod>(method: K, predicate?: (...args: MediaFakeCall<K>) => boolean): void;
|
|
90
|
+
/** Same as `media.restore()`, but a no-op once a newer fake has replaced this one. */
|
|
91
|
+
restore(): void;
|
|
92
|
+
}
|
|
93
|
+
//# sourceMappingURL=media_fake.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"media_fake.d.ts","sourceRoot":"","sources":["../../../src/testing/media_fake.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
import { AssertionError } from 'node:assert';
|
|
2
|
+
import { InMemoryDisk } from './in_memory_disk.js';
|
|
3
|
+
/**
|
|
4
|
+
* The {@link MediaLibrary} methods a {@link MediaFake} records and lets you {@link MediaFake.stub}.
|
|
5
|
+
* `for(...)` is not listed: its binding calls `attach`/`attachExisting`/`list` through the fake,
|
|
6
|
+
* so those are what get recorded.
|
|
7
|
+
*/
|
|
8
|
+
export const MEDIA_FAKE_METHODS = [
|
|
9
|
+
'attach',
|
|
10
|
+
'attachExisting',
|
|
11
|
+
'list',
|
|
12
|
+
'find',
|
|
13
|
+
'delete',
|
|
14
|
+
'url',
|
|
15
|
+
'deliver',
|
|
16
|
+
'signedUrl',
|
|
17
|
+
'ensureConversion',
|
|
18
|
+
'transform',
|
|
19
|
+
];
|
|
20
|
+
/**
|
|
21
|
+
* In-memory disks created on demand for ANY name, so every disk a config or collection names
|
|
22
|
+
* resolves without listing them up front. `undefined` resolves to `defaultDisk`.
|
|
23
|
+
*/
|
|
24
|
+
export function lazyInMemoryDiskResolver(defaultDisk, visibility = 'private') {
|
|
25
|
+
const disks = {};
|
|
26
|
+
const resolve = (name) => {
|
|
27
|
+
const key = name ?? defaultDisk;
|
|
28
|
+
disks[key] ??= new InMemoryDisk(`memory://${key}`, visibility);
|
|
29
|
+
return disks[key];
|
|
30
|
+
};
|
|
31
|
+
return { resolve, disks };
|
|
32
|
+
}
|
|
33
|
+
function isFakeMethod(prop) {
|
|
34
|
+
return typeof prop === 'string' && MEDIA_FAKE_METHODS.includes(prop);
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* The handle `media.fake()` returns. While it is active, `media.library` (and `media.store`,
|
|
38
|
+
* `media.storage`, `media.attachments`, …) run on real library code over in-memory doubles, and
|
|
39
|
+
* every library call is recorded here.
|
|
40
|
+
*
|
|
41
|
+
* ```ts
|
|
42
|
+
* const fake = media.fake()
|
|
43
|
+
* await someCodeThatUploads()
|
|
44
|
+
* fake.assertCalled('attach', (input) => input.collection === 'avatar')
|
|
45
|
+
* assert.equal(fake.calls.signedUrl[0]?.[1], 300) // TTL
|
|
46
|
+
* fake.stub('deliver', async () => ({ kind: 'redirect', url: 'https://x.test' }))
|
|
47
|
+
* media.restore()
|
|
48
|
+
* ```
|
|
49
|
+
*
|
|
50
|
+
* Built by `MediaManager.fake()`; not meant to be constructed directly.
|
|
51
|
+
*/
|
|
52
|
+
export class MediaFake {
|
|
53
|
+
/** Recorded calls per method — the args tuple of each call, in order. Stubbed calls included. */
|
|
54
|
+
calls;
|
|
55
|
+
/** The faked library — the very object `media.library` returns while this fake is active. */
|
|
56
|
+
library;
|
|
57
|
+
/** The store backing the fake (an `InMemoryMediaStore` unless one was passed). */
|
|
58
|
+
store;
|
|
59
|
+
/** In-memory disks created so far, by name (every name resolves; this lists the ones touched). */
|
|
60
|
+
disks;
|
|
61
|
+
#resolve;
|
|
62
|
+
#stubs = new Map();
|
|
63
|
+
#onRestore;
|
|
64
|
+
constructor(input) {
|
|
65
|
+
this.store = input.store;
|
|
66
|
+
this.disks = input.disks;
|
|
67
|
+
this.#resolve = input.resolve;
|
|
68
|
+
this.#onRestore = input.onRestore;
|
|
69
|
+
this.calls = Object.fromEntries(MEDIA_FAKE_METHODS.map((method) => [method, []]));
|
|
70
|
+
this.library = this.#record(input.library);
|
|
71
|
+
}
|
|
72
|
+
/** The in-memory disk behind `name` (default disk when omitted) — inspect `.files` for bytes. */
|
|
73
|
+
disk(name) {
|
|
74
|
+
return this.#resolve(name);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Replace one library method for the rest of this fake (calls are still recorded). Use it to
|
|
78
|
+
* force a result or an error the in-memory library would not produce on its own.
|
|
79
|
+
*/
|
|
80
|
+
stub(method, implementation) {
|
|
81
|
+
this.#stubs.set(method, implementation);
|
|
82
|
+
return this;
|
|
83
|
+
}
|
|
84
|
+
/** Drop a {@link stub}, so the method runs the real in-memory library again. */
|
|
85
|
+
unstub(method) {
|
|
86
|
+
this.#stubs.delete(method);
|
|
87
|
+
return this;
|
|
88
|
+
}
|
|
89
|
+
/** Throws unless `method` was called (and, with `predicate`, called with matching args). */
|
|
90
|
+
assertCalled(method, predicate) {
|
|
91
|
+
if (this.#matching(method, predicate).length > 0)
|
|
92
|
+
return;
|
|
93
|
+
throw new AssertionError({
|
|
94
|
+
message: predicate
|
|
95
|
+
? `Expected media.library.${method} to be called with matching arguments`
|
|
96
|
+
: `Expected media.library.${method} to be called`,
|
|
97
|
+
actual: this.calls[method],
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
/** Throws if `method` was called (or, with `predicate`, called with matching args). */
|
|
101
|
+
assertNotCalled(method, predicate) {
|
|
102
|
+
const matching = this.#matching(method, predicate);
|
|
103
|
+
if (matching.length === 0)
|
|
104
|
+
return;
|
|
105
|
+
throw new AssertionError({
|
|
106
|
+
message: predicate
|
|
107
|
+
? `Expected media.library.${method} not to be called with matching arguments`
|
|
108
|
+
: `Expected media.library.${method} not to be called`,
|
|
109
|
+
actual: matching,
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
/** Same as `media.restore()`, but a no-op once a newer fake has replaced this one. */
|
|
113
|
+
restore() {
|
|
114
|
+
this.#onRestore();
|
|
115
|
+
}
|
|
116
|
+
#matching(method, predicate) {
|
|
117
|
+
const calls = this.calls[method];
|
|
118
|
+
return predicate ? calls.filter((args) => predicate(...args)) : calls;
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Wrap the library so the recorded methods log their args and honour stubs. A Proxy (rather than
|
|
122
|
+
* a subclass) keeps the library's internal `this.x()` calls on the real object, so only calls
|
|
123
|
+
* made from outside — the app's — are recorded. `for()` runs against the proxy so the binding's
|
|
124
|
+
* `attach`/`list` are recorded too.
|
|
125
|
+
*/
|
|
126
|
+
#record(library) {
|
|
127
|
+
const proxy = new Proxy(library, {
|
|
128
|
+
get: (target, prop) => {
|
|
129
|
+
if (prop === 'for') {
|
|
130
|
+
return (ownerType, ownerId) => target.for.call(proxy, ownerType, ownerId);
|
|
131
|
+
}
|
|
132
|
+
if (!isFakeMethod(prop)) {
|
|
133
|
+
// Bound to the real library: its methods read private fields, which a Proxy `this` lacks
|
|
134
|
+
// (e.g. `media.access.image` calls the symbol-keyed `imageOfRecord`).
|
|
135
|
+
const value = Reflect.get(target, prop, target);
|
|
136
|
+
return typeof value === 'function' ? value.bind(target) : value;
|
|
137
|
+
}
|
|
138
|
+
return (...args) => {
|
|
139
|
+
this.calls[prop].push(args);
|
|
140
|
+
const stub = this.#stubs.get(prop);
|
|
141
|
+
if (stub)
|
|
142
|
+
return (async () => stub(...args))();
|
|
143
|
+
return target[prop].apply(target, args);
|
|
144
|
+
};
|
|
145
|
+
},
|
|
146
|
+
});
|
|
147
|
+
return proxy;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
//# sourceMappingURL=media_fake.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"media_fake.js","sourceRoot":"","sources":["../../../src/testing/media_fake.ts"],"names":[],"mappings":"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"}
|