@ddd-ts-kit/testing 0.7.0 → 0.9.0

package/README.md

@@ -280,12 +280,14 @@ await scoped(executionScope, anExecutionContext().as(bob).ofTenant('globex'), ()
 | Builder | Default | Says |
 |---|---|---|
 | `aSession()` | a user of its own, opened with a password at the test epoch, never expiring | `of(actor)`, `identifiedBy`, `issuedAt`, `expiringAt`, `authenticatedBy`, `withSecondFactor`, `impersonatedBy`, `inLocale`, `inTimeZone`, `withExtensions` |
-| `anExecutionContext()` | the work of a user of its own, origin `test`, correlation of its own | `as(actor)`, `inSession(session)`, `ofTenant`, `correlatedBy`, `causedBy`, `from(origin)`, `dueBy`, `inLocale`, `withExtensions` |
+| `anExecutionContext()` | the work of a user of its own, origin `test`, correlation of its own | `as(actor)`, `inSession(session)`, `ofTenant`, `elevatedOver(tenants, reason?)`, `correlatedBy`, `causedBy`, `from(origin)`, `dueBy`, `inLocale`, `withExtensions` |
 
 Both are classes on `Builder`, immutable like every builder, and accept a builder wherever an
 actor or a session is expected (`aSession().of(anActor().withRole('accountant'))` with the
 actor builder of `@ddd-ts-kit/auth/testing`). `scoped(scope, context, work)` runs a block in a
-context given as a value or as a builder, with any `ExecutionScope`.
+context given as a value or as a builder, with any `ExecutionScope`; `asTenant(scope, 'acme',
+work)` runs it as a member of a tenant, and `elevatedOver('all')` builds the context of platform
+staff under an elevation, without the audit entry `acrossTenants` writes.
 
 ## End to end
 
@@ -429,9 +431,10 @@ repositoryContract(runner, { ...options, name: 'DrizzleOrderRepository', createR
 | Suite | Holds |
 |---|---|
 | `repositoryContract` | save then find, unknown id, update, isolation of the stored copy, optimistic concurrency (any error with code `CONCURRENCY_CONFLICT`) |
-| `eventBusContract` | any `EventBus` provider: routing by type, several subscribers, unsubscribe, exact envelope round trip (`traceparent`, `correlationId`), handler failure surfaces. Redeliveries are accepted; return `settle()` from `createBus` for providers that deliver asynchronously |
+| `tenantIsolationContract` | one repository under a strategy of tenant isolation: what a tenant saved is hidden from another; another tenant saving under the same id leaves it untouched, by an update or (given `recreate(aggregate)`, a new aggregate under the same id) by an insert; platform staff elevated over every tenant write nothing, and read the other tenant's aggregate when `elevatedReads` is true (shared tables, row-level security); a write of work that names no tenant is refused (`NoCurrentTenantError`) and a read is refused or finds nothing. `createRepository(scope)` reads the tenant from the scope it is given, on storage where the tenants `acme` and `globex` exist. To prove row-level security itself, run it against a repository that writes no tenant condition |
+| `eventBusContract` | any `EventBus` provider: routing by type, several subscribers, unsubscribe, exact envelope round trip (`traceparent`, `correlationId`, `tenantId`), handler failure surfaces. Redeliveries are accepted; return `settle()` from `createBus` for providers that deliver asynchronously |
 | `unitOfWorkContract` | any `UnitOfWork`, called through `run` without a command bus: domain events wait for the end and are dispatched before the commit, so handlers see every save and what they write, the outbox included, commits with it; a failure in a save, in the work, in a handler or in the commit (a deferred constraint) leaves nothing behind; `after-commit` handlers run once the rows are committed, never otherwise. An adapter not built on `withinUnitOfWork` fails here |
-| `outboxStoreContract` | any outbox store: order, limit, lease, concurrent claims, published, failed, dead, `retryDead`, purge |
+| `outboxStoreContract` | any outbox store: order, limit, lease, concurrent claims, published, failed, dead, `retryDead`, purge; with `carriesTenant: true`, the tenant of each event kept |
 | `processedEventStoreContract` | any `ProcessedEventStore`: once per consumer and event, also under concurrent deliveries |
 | `cacheContract` | any `Cache`: round trip of every shape of value, isolation of entries, deletion, time to live |
 | `lockContract` | any `Lock`: one holder at a time also under concurrent requests, release, expiry, a late release ignored, growing fencing token, `waitMs` |
@@ -439,6 +442,7 @@ repositoryContract(runner, { ...options, name: 'DrizzleOrderRepository', createR
 | `loggerContract` | any `Logger`: every level with its message and fields of every shape, level and message that no field forges, children that add their fields and nest, fields read at each entry, an entry below the level dropped without reading a field, `isLevelEnabled` answering what is written (for a child too), no throw on a circular field or a getter that throws, at the top of the fields included; an `Error` passed as a field written as its description (`type`, `code` of a `DomainError`, `message`, own `stack`, `cause`, eight errors deep at most), its message replaced when the logger scrubs unless it is a `DomainError`; every entry in the sink once `flush()` resolves, then no throw from a log call or a second flush. `createLogger({ level, fields, scrubMessages })` answers the logger and `lines()`, what its sink received as `{ level, message, fields }`. No capability flag: `InMemoryLogger` takes the same three options and passes the whole suite |
 | `criteriaContract` | any translator of criteria, the in-memory evaluator included: a table of criteria and the ids each answers, in order, over eight fixed rows. Every operator on every type it applies to, decimals as numbers, instants to the millisecond and across zones, case and the characters a `LIKE` would trip on, nulls under each operator, `and`, `or`, `not` and what a negation does to a null, sorts with ties and nulls in both directions, offset pages with their total, every sort walked by cursor one and two rows at a time, the four kinds of access scope, and hostile values. `createReadModel(rows)` answers `{ search(scopedCriteria) }` over exactly those rows, read with `criteriaContractDefinition` |
 | `readModelStoreContract` | any `ReadModelTable` under `TableReadModelStore`: rows of every type round trip, the current row handed to a later event, an event applied once, never one older than the row, order by event id at the same instant and by version when given, concurrent writes ending on the latest, deletions that last, listing by criteria and scope, and `ProjectionRebuild`: rebuilt from the source alone, no event lost while it exports (on a row already copied and on one not yet), stale and new events after the swap, deletions during and before it, a failed export leaving the table as it was, the table still itself after two rebuilds. `createTable()` answers `{ table, unitOfWork }`; `SourceOfTruth` is the fake of the source |
+| `fileStorageContract` | any `FileStorage`: content round trip with size, media type and checksum, several mebibytes streamed, a write beyond `maxBytes` refused leaving the previous content, keys that could leave their place refused, deletion, copy, move, listing by prefix, signed download and upload links that expire, refuse a changed signature or another media type, and are never signed for more than an hour, a download served as an attachment even without a name. `follow` sends a request to a link: `fetch` by default, `followServed(storage)` for a storage the application serves |
 | `rateLimiterContract` | any `RateLimiter`: limit, `remaining` and `retryAfterMs`, refused calls not counted, sliding window, isolation of keys, concurrent calls |
 
 The cache, lock and rate limiter suites also take `elapse(ms)`, which makes time pass for the

package/dist/contracts/event-bus-contract.js

@@ -1,6 +1,6 @@
 import { ContractSuite } from './contract-suite.js';
 import { failureOf } from './failure-of.js';
-import { fullEnvelope } from './full-envelope.js';
+import { tenantEnvelope } from './tenant-envelope.js';
 /**
  * What every integration event provider guarantees. Delivery is at-least-once: the suite
  * accepts redeliveries everywhere and never relies on the order of arrival.
@@ -66,9 +66,9 @@ class EventBusSuite extends ContractSuite {
         });
     }
     handsTheEnvelopeOverUntouched() {
-        this.it('hands the envelope over exactly as published, trace and correlation included', async () => {
+        this.it('hands the envelope over exactly as published, trace, correlation and tenant included', async () => {
             const happened = this.collect(HAPPENED);
-            const published = fullEnvelope(busEvent('evt-1'));
+            const published = tenantEnvelope(busEvent('evt-1'));
             await this.publish([published]);
             this.expect(happened.events[0]).toEqual(published);
         });
@@ -78,6 +78,7 @@ class EventBusSuite extends ContractSuite {
             this.expect(happened.events[0]).toEqual(busEvent('evt-1'));
             this.expect(happened.events[0]?.traceparent).toBe(undefined);
             this.expect(happened.events[0]?.correlationId).toBe(undefined);
+            this.expect(happened.events[0]?.tenantId).toBe(undefined);
         });
     }
     survivesAFailingHandler() {

package/dist/contracts/event-bus-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus-contract.js","sourceRoot":"","sources":["../../src/contracts/event-bus-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkBlD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,OAAgC;IACvF,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,uBAAuB,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAC3C,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC,MAAM,aAAc,SAAQ,aAAoC;IAC9D,YAAY,MAAsB,EAAE,OAAgC;QAClE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IAES,KAAK;QACb,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,iCAAiC,EAAE,CAAC;QACzC,IAAI,CAAC,+BAA+B,EAAE,CAAC;QACvC,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACrC,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACjC,CAAC;IAEO,iCAAiC;QACvC,IAAI,CAAC,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAErE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEtC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEtC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAEvF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,+BAA+B;QACrC,IAAI,CAAC,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC3E,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACxC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAE9B,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,6BAA6B;QACnC,IAAI,CAAC,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;YACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAElD,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAEhC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;YACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAExC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,uBAAuB;QAC7B,IAAI,CAAC,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;YAC7F,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBAC9C,QAAQ,IAAI,CAAC,CAAC;gBAEd,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAExD,oFAAoF;YACpF,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sGAAsG;IAC9F,OAAO,CAAC,IAAY;QAC1B,MAAM,MAAM,GAAuB,EAAE,CAAC;QAEtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3F,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,MAAmC;QACvD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAExE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAE9B,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,EAAU,EAAE,IAAI,GAAG,QAAQ;IAC3C,OAAO;QACL,EAAE;QACF,IAAI;QACJ,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,0BAA0B;QACtC,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"event-bus-contract.js","sourceRoot":"","sources":["../../src/contracts/event-bus-contract.ts"],"names":[],"mappings":"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"}

package/dist/contracts/file-storage/arrangement-suite.d.ts

@@ -0,0 +1,9 @@
+import { FileStorageSuite } from './file-storage-suite.js';
+/** Files are copied, moved and listed by key, without reading them through the application. */
+export declare class ArrangementSuite extends FileStorageSuite {
+    protected tests(): void;
+    private copies;
+    private moves;
+    private lists;
+}
+//# sourceMappingURL=arrangement-suite.d.ts.map

package/dist/contracts/file-storage/arrangement-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrangement-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/arrangement-suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,+FAA+F;AAC/F,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,KAAK;CAoBd"}

package/dist/contracts/file-storage/arrangement-suite.js

@@ -0,0 +1,51 @@
+import { PDF, TEXT } from './contents.js';
+import { FileStorageSuite } from './file-storage-suite.js';
+/** Files are copied, moved and listed by key, without reading them through the application. */
+export class ArrangementSuite extends FileStorageSuite {
+    tests() {
+        this.copies();
+        this.moves();
+        this.lists();
+    }
+    copies() {
+        this.it('copies a file to another key, the original staying', async () => {
+            await this.write('staging/documents/a.pdf', PDF);
+            await this.subject.copy('staging/documents/a.pdf', 'documents/a.pdf');
+            this.expect(await this.read('documents/a.pdf')).toEqual(PDF);
+            this.expect(await this.read('staging/documents/a.pdf')).toEqual(PDF);
+            this.expect((await this.subject.stat('documents/a.pdf'))?.mediaType).toBe('application/pdf');
+        });
+        this.it('refuses to copy a file that is not there', async () => {
+            this.expect(await this.codeOf(() => this.subject.copy('documents/missing.pdf', 'documents/b.pdf'))).toBe('FILE_NOT_FOUND');
+        });
+    }
+    moves() {
+        this.it('moves a file to another key, nothing staying behind', async () => {
+            await this.write('staging/documents/a.txt', TEXT, 'text/plain');
+            await this.subject.move('staging/documents/a.txt', 'documents/a.txt');
+            this.expect(await this.read('documents/a.txt')).toEqual(TEXT);
+            this.expect((await this.subject.stat('documents/a.txt'))?.mediaType).toBe('text/plain');
+            this.expect(await this.subject.stat('staging/documents/a.txt')).toBe(undefined);
+        });
+        this.it('refuses to move a file that is not there', async () => {
+            this.expect(await this.codeOf(() => this.subject.move('documents/missing.pdf', 'documents/b.pdf'))).toBe('FILE_NOT_FOUND');
+        });
+    }
+    lists() {
+        this.it('lists the files under a prefix, nested ones included, and no other', async () => {
+            await this.write('staging/a.pdf', PDF);
+            await this.write('staging/deep/er/b.pdf', TEXT);
+            await this.write('documents/c.pdf', PDF);
+            const listed = [];
+            for await (const file of this.subject.list('staging/')) {
+                listed.push([file.key, file.size, file.lastModified instanceof Date]);
+            }
+            listed.sort((left, right) => String(left[0]).localeCompare(String(right[0])));
+            this.expect(listed).toEqual([
+                ['staging/a.pdf', PDF.length, true],
+                ['staging/deep/er/b.pdf', TEXT.length, true],
+            ]);
+        });
+    }
+}
+//# sourceMappingURL=arrangement-suite.js.map

package/dist/contracts/file-storage/arrangement-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrangement-suite.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/arrangement-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,+FAA+F;AAC/F,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IAC1C,KAAK;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,IAAI,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAEjD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;YAEtE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CACtG,gBAAgB,CACjB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,IAAI,CAAC,KAAK,CAAC,yBAAyB,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEhE,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;YAEtE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxF,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CACtG,gBAAgB,CACjB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;YACvF,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,KAAK,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAEzC,MAAM,MAAM,GAAG,EAAE,CAAC;YAElB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,YAAY,IAAI,CAAC,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAE9E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBAC1B,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;gBACnC,CAAC,uBAAuB,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;aAC7C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/contracts/file-storage/checksum-of.d.ts

@@ -0,0 +1,3 @@
+/** The checksum a connector answers, computed by the suite from what it wrote. */
+export declare function checksumOf(chunks: Iterable<Uint8Array> | AsyncIterable<Uint8Array>): Promise<string>;
+//# sourceMappingURL=checksum-of.d.ts.map

package/dist/contracts/file-storage/checksum-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum-of.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/checksum-of.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAsB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ1G"}

package/dist/contracts/file-storage/checksum-of.js

@@ -0,0 +1,10 @@
+import { createHash } from 'node:crypto';
+/** The checksum a connector answers, computed by the suite from what it wrote. */
+export async function checksumOf(chunks) {
+    const hash = createHash('sha256');
+    for await (const chunk of chunks) {
+        hash.update(chunk);
+    }
+    return `sha256:${hash.digest('hex')}`;
+}
+//# sourceMappingURL=checksum-of.js.map

package/dist/contracts/file-storage/checksum-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum-of.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/checksum-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAwD;IACvF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/contracts/file-storage/chunks-of.d.ts

@@ -0,0 +1,3 @@
+/** A content of a test as the stream a connector receives. */
+export declare function chunksOf(bytes: Uint8Array): AsyncIterable<Uint8Array>;
+//# sourceMappingURL=chunks-of.d.ts.map

package/dist/contracts/file-storage/chunks-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks-of.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/chunks-of.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAuB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAE5E"}

package/dist/contracts/file-storage/chunks-of.js

@@ -0,0 +1,5 @@
+/** A content of a test as the stream a connector receives. */
+export async function* chunksOf(bytes) {
+    yield bytes;
+}
+//# sourceMappingURL=chunks-of.js.map

package/dist/contracts/file-storage/chunks-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks-of.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/chunks-of.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAiB;IAC/C,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/contracts/file-storage/content-suite.d.ts

@@ -0,0 +1,12 @@
+import { FileStorageSuite } from './file-storage-suite.js';
+/** Content goes in and out as streams, intact, measured and refused beyond its limit; keys stay inside the storage. */
+export declare class ContentSuite extends FileStorageSuite {
+    protected tests(): void;
+    private roundTrips;
+    private streamsLarge;
+    private overwrites;
+    private limits;
+    private keys;
+    private removes;
+}
+//# sourceMappingURL=content-suite.d.ts.map

package/dist/contracts/file-storage/content-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/content-suite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAI3D,uHAAuH;AACvH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,SAAS,CAAC,KAAK,IAAI,IAAI,CAOtB;IAED,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,OAAO;CAehB"}

package/dist/contracts/file-storage/content-suite.js

@@ -0,0 +1,110 @@
+import { checksumOf } from './checksum-of.js';
+import { chunksOf } from './chunks-of.js';
+import { LARGE_SIZE, PDF, TEXT } from './contents.js';
+import { largeContent } from './large-content.js';
+import { FileStorageSuite } from './file-storage-suite.js';
+const INVALID_KEYS = ['', '../escape', '/absolute', 'a//b', '.hidden', 'a/../b', 'a/./b', 'with space', 'tail/'];
+/** Content goes in and out as streams, intact, measured and refused beyond its limit; keys stay inside the storage. */
+export class ContentSuite extends FileStorageSuite {
+    tests() {
+        this.roundTrips();
+        this.streamsLarge();
+        this.overwrites();
+        this.limits();
+        this.keys();
+        this.removes();
+    }
+    roundTrips() {
+        this.it('gives back what was written, with its size, media type and checksum', async () => {
+            const stored = await this.subject.put('documents/report.pdf', chunksOf(PDF), { mediaType: 'Application/PDF' });
+            const metadata = await this.subject.stat('documents/report.pdf');
+            const checksum = await checksumOf([PDF]);
+            this.expect(stored).toEqual({
+                key: 'documents/report.pdf',
+                size: PDF.length,
+                mediaType: 'application/pdf',
+                checksum,
+            });
+            this.expect(await this.read('documents/report.pdf')).toEqual(PDF);
+            this.expect([metadata?.key, metadata?.size, metadata?.mediaType]).toEqual([
+                'documents/report.pdf',
+                PDF.length,
+                'application/pdf',
+            ]);
+            this.expect(metadata?.checksum === undefined || metadata.checksum === checksum).toBe(true);
+            this.expect(metadata?.lastModified instanceof Date).toBe(true);
+        });
+    }
+    streamsLarge() {
+        this.it('streams a content of several mebibytes, chunk after chunk', async () => {
+            const stored = await this.subject.put('exports/large.bin', largeContent(), {
+                mediaType: 'application/octet-stream',
+            });
+            const content = await this.subject.get('exports/large.bin');
+            let read = 0;
+            for await (const chunk of content?.stream ?? []) {
+                read += Buffer.byteLength(chunk instanceof Uint8Array ? chunk : String(chunk));
+            }
+            this.expect([stored.size, stored.checksum, read]).toEqual([
+                LARGE_SIZE,
+                await checksumOf(largeContent()),
+                LARGE_SIZE,
+            ]);
+        });
+    }
+    overwrites() {
+        this.it('replaces the content written again under a key', async () => {
+            await this.write('notes/today.txt', PDF);
+            await this.write('notes/today.txt', TEXT, 'text/plain');
+            this.expect(await this.read('notes/today.txt')).toEqual(TEXT);
+            this.expect((await this.subject.stat('notes/today.txt'))?.mediaType).toBe('text/plain');
+        });
+        this.it('answers undefined for a key nothing is stored under', async () => {
+            this.expect(await this.subject.get('documents/missing.pdf')).toBe(undefined);
+            this.expect(await this.subject.stat('documents/missing.pdf')).toBe(undefined);
+        });
+    }
+    limits() {
+        this.it('refuses a content beyond its limit, and leaves what the key held before', async () => {
+            await this.write('documents/report.pdf', TEXT, 'text/plain');
+            const code = await this.codeOf(() => this.subject.put('documents/report.pdf', largeContent(), { mediaType: 'application/pdf', maxBytes: 1_000_000 }));
+            this.expect(code).toBe('FILE_TOO_LARGE');
+            this.expect(await this.read('documents/report.pdf')).toEqual(TEXT);
+        });
+        this.it('leaves nothing under a new key whose content was refused', async () => {
+            const code = await this.codeOf(() => this.subject.put('documents/new.pdf', chunksOf(PDF), { mediaType: 'application/pdf', maxBytes: 10 }));
+            this.expect(code).toBe('FILE_TOO_LARGE');
+            this.expect(await this.subject.stat('documents/new.pdf')).toBe(undefined);
+        });
+        this.it('accepts a content of exactly its limit', async () => {
+            const stored = await this.subject.put('documents/exact.pdf', chunksOf(PDF), {
+                mediaType: 'application/pdf',
+                maxBytes: PDF.length,
+            });
+            this.expect(stored.size).toBe(PDF.length);
+        });
+    }
+    keys() {
+        this.it('refuses a key that could leave its place, before touching anything', async () => {
+            for (const key of INVALID_KEYS) {
+                this.expect(await this.codeOf(() => this.write(key, PDF))).toBe('INVALID_FILE_KEY');
+                this.expect(await this.codeOf(() => this.subject.get(key))).toBe('INVALID_FILE_KEY');
+                this.expect(await this.codeOf(() => this.subject.stat(key))).toBe('INVALID_FILE_KEY');
+                this.expect(await this.codeOf(() => this.subject.delete(key))).toBe('INVALID_FILE_KEY');
+            }
+        });
+    }
+    removes() {
+        this.it('forgets a deleted file, and only that one', async () => {
+            await this.write('documents/a.pdf', PDF);
+            await this.write('documents/b.pdf', PDF);
+            await this.subject.delete('documents/a.pdf');
+            this.expect(await this.subject.stat('documents/a.pdf')).toBe(undefined);
+            this.expect(await this.read('documents/b.pdf')).toEqual(PDF);
+        });
+        this.it('accepts the deletion of a file that is not there', async () => {
+            this.expect(await this.codeOf(() => this.subject.delete('documents/missing.pdf'))).toBe('resolved');
+        });
+    }
+}
+//# sourceMappingURL=content-suite.js.map

package/dist/contracts/file-storage/content-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-suite.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/content-suite.ts"],"names":[],"mappings":"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"}

package/dist/contracts/file-storage/contents.d.ts

@@ -0,0 +1,7 @@
+/** The contents the suites write: a small PDF, a line of text, and the size of a large one. */
+export declare const PDF: Uint8Array<ArrayBuffer>;
+export declare const TEXT: Uint8Array<ArrayBuffer>;
+/** Six mebibytes, enough to cross the part size of a multipart upload. */
+export declare const LARGE_SIZE: number;
+export declare const LARGE_CHUNK = 65536;
+//# sourceMappingURL=contents.d.ts.map

package/dist/contracts/file-storage/contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/contents.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,eAAO,MAAM,GAAG,yBAAwF,CAAC;AAEzG,eAAO,MAAM,IAAI,yBAAkE,CAAC;AAEpF,0EAA0E;AAC1E,eAAO,MAAM,UAAU,QAAoB,CAAC;AAE5C,eAAO,MAAM,WAAW,QAAS,CAAC"}

package/dist/contracts/file-storage/contents.js

@@ -0,0 +1,7 @@
+/** The contents the suites write: a small PDF, a line of text, and the size of a large one. */
+export const PDF = new Uint8Array(Buffer.from('%PDF-1.7\n1 0 obj << /Type /Catalog >> endobj\n%%EOF\n'));
+export const TEXT = new Uint8Array(Buffer.from('Appointment notes, plain text.\n'));
+/** Six mebibytes, enough to cross the part size of a multipart upload. */
+export const LARGE_SIZE = 6 * 1_024 * 1_024;
+export const LARGE_CHUNK = 65_536;
+//# sourceMappingURL=contents.js.map

package/dist/contracts/file-storage/contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/contents.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC,CAAC;AAEzG,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;AAEpF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC"}

package/dist/contracts/file-storage/file-storage-contract-options.d.ts

@@ -0,0 +1,17 @@
+import type { FileStorage } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from '../awaitable.js';
+import type { FollowedResponse } from './followed-response.js';
+import type { SignedRequest } from './signed-request.js';
+export interface FileStorageContractOptions {
+    readonly name: string;
+    /** A storage that holds nothing; called before each test. */
+    createStorage(): Awaitable<FileStorage>;
+    /** Makes the time of the signed links pass: advances their clock, or really waits. */
+    elapse(ms: number): Awaitable<void>;
+    /**
+     * Sends a request to a signed link. Default: `fetch`, for a storage that answers its own links.
+     * A storage the application serves passes `followServed(storage)`.
+     */
+    follow?(request: SignedRequest): Promise<FollowedResponse>;
+}
+//# sourceMappingURL=file-storage-contract-options.d.ts.map

package/dist/contracts/file-storage/file-storage-contract-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-contract-options.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/file-storage-contract-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,aAAa,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,sFAAsF;IACtF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5D"}

package/dist/contracts/file-storage/file-storage-contract-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-storage-contract-options.js.map

package/dist/contracts/file-storage/file-storage-contract-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-contract-options.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/file-storage-contract-options.ts"],"names":[],"mappings":""}

package/dist/contracts/file-storage/file-storage-suite.d.ts

@@ -0,0 +1,14 @@
+import { type FileStorage } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import type { ContractRunner } from '../contract-runner.js';
+import type { FileStorageContractOptions } from './file-storage-contract-options.js';
+/** What the suites of the file storage contract share: the options, and reading back what was written. */
+export declare abstract class FileStorageSuite extends ContractSuite<FileStorage> {
+    protected readonly options: FileStorageContractOptions;
+    constructor(runner: ContractRunner, options: FileStorageContractOptions);
+    protected write(key: string, bytes: Uint8Array, mediaType?: string): Promise<void>;
+    protected read(key: string): Promise<Uint8Array | undefined>;
+    /** The code of the `FileError` the work rejects with, `resolved` when it does not, the message of another error. */
+    protected codeOf(work: () => Promise<unknown>): Promise<string>;
+}
+//# sourceMappingURL=file-storage-suite.d.ts.map

package/dist/contracts/file-storage/file-storage-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/file-storage-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,0GAA0G;AAC1G,8BAAsB,gBAAiB,SAAQ,aAAa,CAAC,WAAW,CAAC;IAGrE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,0BAA0B;IAFxD,YACE,MAAM,EAAE,cAAc,EACH,OAAO,EAAE,0BAA0B,EAGvD;IAED,UAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElG;IAED,UAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAIjE;IAED,oHAAoH;IACpH,UAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpE;CACF"}

package/dist/contracts/file-storage/file-storage-suite.js

@@ -0,0 +1,30 @@
+import { FileError } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { chunksOf } from './chunks-of.js';
+import { readAll } from './read-all.js';
+/** What the suites of the file storage contract share: the options, and reading back what was written. */
+export class FileStorageSuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createStorage());
+        this.options = options;
+    }
+    async write(key, bytes, mediaType = 'application/pdf') {
+        await this.subject.put(key, chunksOf(bytes), { mediaType });
+    }
+    async read(key) {
+        const content = await this.subject.get(key);
+        return content === undefined ? undefined : readAll(content.stream);
+    }
+    /** The code of the `FileError` the work rejects with, `resolved` when it does not, the message of another error. */
+    async codeOf(work) {
+        try {
+            await work();
+            return 'resolved';
+        }
+        catch (error) {
+            return FileError.is(error) ? error.code : String(error);
+        }
+    }
+}
+//# sourceMappingURL=file-storage-suite.js.map

package/dist/contracts/file-storage/file-storage-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-suite.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/file-storage-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,0GAA0G;AAC1G,MAAM,OAAgB,gBAAiB,SAAQ,aAA0B;IAGlD,OAAO;IAF5B,YACE,MAAsB,EACH,OAAmC;QAEtD,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;uBAF1B,OAAO;IAG5B,CAAC;IAES,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,KAAiB,EAAE,SAAS,GAAG,iBAAiB;QACjF,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAES,KAAK,CAAC,IAAI,CAAC,GAAW;QAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5C,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,oHAAoH;IAC1G,KAAK,CAAC,MAAM,CAAC,IAA4B;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;YAEb,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF"}

package/dist/contracts/file-storage/follow-served.d.ts

@@ -0,0 +1,9 @@
+import { type ServedFileStorage } from '@ddd-ts-kit/kernel';
+import type { FollowedResponse } from './followed-response.js';
+import type { SignedRequest } from './signed-request.js';
+/**
+ * Follows a link of a storage the application serves, without a server: the token is the `token`
+ * parameter of the query, answered the way `signedFileRoutes` of `@ddd-ts-kit/http` answers it.
+ */
+export declare function followServed(storage: ServedFileStorage): (request: SignedRequest) => Promise<FollowedResponse>;
+//# sourceMappingURL=follow-served.d.ts.map

package/dist/contracts/file-storage/follow-served.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-served.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/follow-served.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAiB9G"}

package/dist/contracts/file-storage/follow-served.js

@@ -0,0 +1,28 @@
+import { Readable } from 'node:stream';
+import { contentDisposition } from '@ddd-ts-kit/kernel';
+import { readAll } from './read-all.js';
+/**
+ * Follows a link of a storage the application serves, without a server: the token is the `token`
+ * parameter of the query, answered the way `signedFileRoutes` of `@ddd-ts-kit/http` answers it.
+ */
+export function followServed(storage) {
+    return async (request) => {
+        const token = new URL(request.url).searchParams.get('token') ?? '';
+        if (request.method === 'GET') {
+            const download = await storage.openSigned(token);
+            return download === undefined
+                ? refused()
+                : { status: 200, headers: dispositionOf(download.fileName), body: await readAll(download.stream) };
+        }
+        const body = Readable.from([Buffer.from(request.body ?? new Uint8Array())]);
+        const stored = await storage.acceptSigned(token, body, request.headers?.['content-type'] ?? '');
+        return stored === undefined ? refused() : { status: 200, headers: {}, body: new Uint8Array() };
+    };
+}
+function refused() {
+    return { status: 403, headers: {}, body: new Uint8Array() };
+}
+function dispositionOf(fileName) {
+    return { 'content-disposition': contentDisposition(fileName) };
+}
+//# sourceMappingURL=follow-served.js.map

package/dist/contracts/file-storage/follow-served.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-served.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/follow-served.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAA0B,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEnE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAEjD,OAAO,QAAQ,KAAK,SAAS;gBAC3B,CAAC,CAAC,OAAO,EAAE;gBACX,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvG,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhG,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,EAAE,CAAC;IACjG,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO;IACd,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,QAA4B;IACjD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/contracts/file-storage/follow-with-fetch.d.ts

@@ -0,0 +1,5 @@
+import type { FollowedResponse } from './followed-response.js';
+import type { SignedRequest } from './signed-request.js';
+/** Follows a link over the network: for a storage that answers its own links, an object store. */
+export declare function followWithFetch(request: SignedRequest): Promise<FollowedResponse>;
+//# sourceMappingURL=follow-with-fetch.d.ts.map

package/dist/contracts/file-storage/follow-with-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-with-fetch.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/follow-with-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,kGAAkG;AAClG,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYvF"}

package/dist/contracts/file-storage/follow-with-fetch.js

@@ -0,0 +1,14 @@
+/** Follows a link over the network: for a storage that answers its own links, an object store. */
+export async function followWithFetch(request) {
+    const response = await fetch(request.url, {
+        method: request.method,
+        headers: { ...request.headers },
+        ...(request.body === undefined ? {} : { body: request.body }),
+    });
+    return {
+        status: response.status,
+        headers: Object.fromEntries(response.headers.entries()),
+        body: new Uint8Array(await response.arrayBuffer()),
+    };
+}
+//# sourceMappingURL=follow-with-fetch.js.map

package/dist/contracts/file-storage/follow-with-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-with-fetch.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/follow-with-fetch.ts"],"names":[],"mappings":"AAGA,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAsB;IAC1D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;QAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KAC9D,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,EAAE,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/contracts/file-storage/followed-response.d.ts

@@ -0,0 +1,7 @@
+/** What a signed link answered; header names in lower case. */
+export interface FollowedResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: Uint8Array;
+}
+//# sourceMappingURL=followed-response.d.ts.map

package/dist/contracts/file-storage/followed-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followed-response.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/followed-response.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B"}

package/dist/contracts/file-storage/followed-response.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=followed-response.js.map

package/dist/contracts/file-storage/followed-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followed-response.js","sourceRoot":"","sources":["../../../src/contracts/file-storage/followed-response.ts"],"names":[],"mappings":""}

package/dist/contracts/file-storage/large-content.d.ts

@@ -0,0 +1,3 @@
+/** Six mebibytes in chunks of 64 KiB, each filled with its rank: never held whole. */
+export declare function largeContent(): AsyncIterable<Uint8Array>;
+//# sourceMappingURL=large-content.d.ts.map

package/dist/contracts/file-storage/large-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"large-content.d.ts","sourceRoot":"","sources":["../../../src/contracts/file-storage/large-content.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,wBAAuB,YAAY,IAAI,aAAa,CAAC,UAAU,CAAC,CAI/D"}

package/dist/contracts/file-storage/large-content.js

@@ -0,0 +1,8 @@
+import { LARGE_CHUNK, LARGE_SIZE } from './contents.js';
+/** Six mebibytes in chunks of 64 KiB, each filled with its rank: never held whole. */
+export async function* largeContent() {
+    for (let offset = 0; offset < LARGE_SIZE; offset += LARGE_CHUNK) {
+        yield new Uint8Array(LARGE_CHUNK).fill(offset / LARGE_CHUNK);
+    }
+}
+//# sourceMappingURL=large-content.js.map