@ddd-ts-kit/testing 0.10.0 → 0.12.0

package/README.md

@@ -200,6 +200,24 @@ givenEvents((id, history) => AttendanceRecord.rehydrate(id, history), [opened, n
 aggregate: for every version of the history, the aggregate rebuilt from the snapshot its policy
 would store and the events after it has the state and the version of the full replay.
 
+## Process steps
+
+```ts
+import { givenProcess } from '@ddd-ts-kit/testing';
+
+givenProcess<DeadlineState>(undefined)
+  .when((current) => deadlines.requested(booked, current))
+  .thenState({ appointmentId: 'appointment-1', confirmBefore: '2026-03-01T12:00:00.000Z' })
+  .thenTimeouts([{ name: 'deadline', at: deadline }])
+  .thenCommands([]);
+```
+
+A step of a process manager is a function of its state and of what happened: `givenProcess(state)`
+(or `undefined` for an instance that does not exist) runs it and asserts its decision without a
+store, a queue or a bus. `thenIgnored()`, `thenState(state)`, `thenCommands([...])` (each by its
+class or by the properties that matter), `thenTimeouts([...])`, `thenCancelled([...])` and
+`thenEnded()` chain; a failure is an `AssertionError` that says what differs.
+
 ## Refusals
 
 A business refusal is known by its code, and carries its facts as data: a test asserts both,
@@ -454,7 +472,10 @@ repositoryContract(runner, { ...options, name: 'DrizzleOrderRepository', createR
 | `processedEventStoreContract` | any `ProcessedEventStore`: once per consumer and event, also under concurrent deliveries |
 | `eventStoreContract` | any `EventStore`: a stream created at version 0 and read back in order, numbered from 1, with its type, shape version, data, metadata and instant; an append at a version the stream no longer has (behind or ahead) refused with `CONCURRENCY_CONFLICT` and nothing kept of it; one of two appends at the same version through; streams numbered apart; the whole store read in the order of the appends, positions rising from 1, after a position and within a limit; `head()` |
 | `eventStoreUnitOfWorkContract` | a transactional `EventStore` with the outbox of its database under one `UnitOfWork`: the stream and the outbox records published for its events commit together; nothing left in the outbox for an append rolled back, nor for one refused by a concurrency conflict. `createSubject()` answers `{ unitOfWork, store, outbox }` |
+| `processStoreContract` | any `ProcessStore` of process managers: an instance as saved (JSON state, armed timeouts, end), a version that is not the next one refused with `CONCURRENCY_CONFLICT`, one of two first saves winning, and with `unitOfWork` nothing left by a rolled back save |
+| `jobStoreContract` | any `JobStore` of background jobs: due jobs earliest first and each to one claim, delayed jobs, idempotency keys scoped by tenant (two tenants never share one), the tenant and the subject `find` shows, the lease and its heartbeats, reports heard only from the attempt that holds the job (progress, checkpoint handed to the next attempt, success, retry, dead and revived, release), cancellation of a waiting and of a running job, purge. With `unitOfWork` (over the same context as the store just created), a job added, cancelled or revived in a unit of work that rolls back is left as it was, and one that commits is added, cancelled or revived. The claims ask for a lease of 30 s |
 | `cacheContract` | any `Cache`: round trip of every shape of value, isolation of entries, deletion, time to live |
+| `cachePurgerContract` | any `CachePurger` with its shared cache (`store`, `holds`): a tag purges what it names and nothing else, a kind reaches each element, the tenants stay apart, purging is idempotent |
 | `lockContract` | any `Lock`: one holder at a time also under concurrent requests, release, expiry, a late release ignored, growing fencing token, `waitMs` |
 | `jobSchedulerContract` | any `JobScheduler`: registration and description, a duplicate name and an unreadable schedule refused, `runNow` (also for a disabled job, an unknown name rejected), nothing by time before `start` or after `stop`, no overlap by default, a failing job answered `failed` with its code while the others go on, the execution context of a run |
 | `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 |

package/dist/contracts/cache-purger-contract.d.ts

@@ -0,0 +1,19 @@
+import { type CachePurger } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+/** A shared cache with its purger: answers are filed under tags through the cache itself, then purged. */
+export interface CachePurgerUnderContract {
+    readonly purger: CachePurger;
+    /** Has the cache keep an answer under `key`, filed under `tags`. */
+    store(key: string, tags: readonly string[]): Awaitable<void>;
+    /** Whether the cache still serves the answer under `key` without asking the application. */
+    holds(key: string): Awaitable<boolean>;
+}
+export interface CachePurgerContractOptions {
+    readonly name: string;
+    /** A cache holding nothing yet, or nothing under the keys of the test; called before each test. */
+    createCache(): Awaitable<CachePurgerUnderContract>;
+}
+/** What every adapter of the kernel `CachePurger` port guarantees, the in-memory one included. */
+export declare function cachePurgerContract(runner: ContractRunner, options: CachePurgerContractOptions): void;
+//# sourceMappingURL=cache-purger-contract.d.ts.map

package/dist/contracts/cache-purger-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-purger-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/cache-purger-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,0GAA0G;AAC1G,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7D,4FAA4F;IAC5F,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,WAAW,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;CACpD;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAErG"}

package/dist/contracts/cache-purger-contract.js

@@ -0,0 +1,69 @@
+import { cacheTag, tenantCacheTags } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `CachePurger` port guarantees, the in-memory one included. */
+export function cachePurgerContract(runner, options) {
+    new CachePurgerSuite(runner, options).describe(`${options.name} (cache purger contract)`);
+}
+const MONDAY = cacheTag('calendar', 'c-1');
+const TUESDAY = cacheTag('calendar', 'c-2');
+const EVERY_CALENDAR = cacheTag('calendar');
+class CachePurgerSuite extends ContractSuite {
+    constructor(runner, options) {
+        super(runner, () => options.createCache());
+    }
+    tests() {
+        this.purgesWhatATagNames();
+        this.keepsWhatItDoesNotName();
+        this.isIdempotent();
+    }
+    purgesWhatATagNames() {
+        this.it('purges the answers filed under a tag, and only those', async () => {
+            await this.subject.store('/calendars/c-1', [MONDAY, EVERY_CALENDAR]);
+            await this.subject.store('/calendars/c-2', [TUESDAY, EVERY_CALENDAR]);
+            await this.subject.purger.purge([MONDAY]);
+            this.expect(await this.subject.holds('/calendars/c-1')).toBe(false);
+            this.expect(await this.subject.holds('/calendars/c-2')).toBe(true);
+        });
+        this.it('purges the answers filed under any of several tags, a kind reaching each of its elements', async () => {
+            await this.subject.store('/calendars/c-1', [MONDAY, EVERY_CALENDAR]);
+            await this.subject.store('/calendars/c-2', [TUESDAY, EVERY_CALENDAR]);
+            await this.subject.store('/calendars', [EVERY_CALENDAR]);
+            await this.subject.purger.purge([EVERY_CALENDAR]);
+            this.expect(await this.subject.holds('/calendars/c-1')).toBe(false);
+            this.expect(await this.subject.holds('/calendars/c-2')).toBe(false);
+            this.expect(await this.subject.holds('/calendars')).toBe(false);
+        });
+    }
+    keepsWhatItDoesNotName() {
+        this.it('purges a tag written with the characters of a pattern, and nothing the pattern would match', async () => {
+            const written = cacheTag('calendar', 'c.1(a)');
+            await this.subject.store('/calendars/written', [written]);
+            await this.subject.store('/calendars/matched', [cacheTag('calendar', 'cx1a')]);
+            await this.subject.purger.purge([written]);
+            this.expect(await this.subject.holds('/calendars/written')).toBe(false);
+            this.expect(await this.subject.holds('/calendars/matched')).toBe(true);
+        });
+        this.it('keeps the answers of another tenant', async () => {
+            const [ofAcme = MONDAY, ofGlobex = MONDAY] = [
+                ...tenantCacheTags([MONDAY], 'acme'),
+                ...tenantCacheTags([MONDAY], 'globex'),
+            ];
+            await this.subject.store('/acme/calendars/c-1', [ofAcme]);
+            await this.subject.store('/globex/calendars/c-1', [ofGlobex]);
+            await this.subject.purger.purge([ofAcme]);
+            this.expect(await this.subject.holds('/acme/calendars/c-1')).toBe(false);
+            this.expect(await this.subject.holds('/globex/calendars/c-1')).toBe(true);
+        });
+    }
+    isIdempotent() {
+        this.it('purges nothing for a tag nothing is filed under, an empty list, or a second time', async () => {
+            await this.subject.store('/calendars/c-2', [TUESDAY]);
+            await this.subject.purger.purge([cacheTag('calendar', 'unknown')]);
+            await this.subject.purger.purge([]);
+            await this.subject.purger.purge([MONDAY]);
+            await this.subject.purger.purge([MONDAY]);
+            this.expect(await this.subject.holds('/calendars/c-2')).toBe(true);
+        });
+    }
+}
+//# sourceMappingURL=cache-purger-contract.js.map

package/dist/contracts/cache-purger-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-purger-contract.js","sourceRoot":"","sources":["../../src/contracts/cache-purger-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAoB,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiBpD,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,MAAsB,EAAE,OAAmC;IAC7F,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,0BAA0B,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC5C,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE5C,MAAM,gBAAiB,SAAQ,aAAuC;IACpE,YAAY,MAAsB,EAAE,OAAmC;QACrE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IAES,KAAK;QACb,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACzE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YAEtE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,0FAA0F,EAAE,KAAK,IAAI,EAAE;YAC7G,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;YAEzD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;YAElD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,sBAAsB;QAC5B,IAAI,CAAC,EAAE,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;YAC/G,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAE/C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAE/E,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAE3C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC,GAAG;gBAC3C,GAAG,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACpC,GAAG,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;aACvC,CAAC;YAEF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE9D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;YACrG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAEtD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YACnE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/contracts/job-store/a-job.d.ts

@@ -0,0 +1,24 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+export interface JobOverrides {
+    readonly name?: string;
+    readonly queue?: string;
+    readonly runAt?: Date;
+    readonly idempotencyKey?: string;
+    readonly payload?: unknown;
+    /** The tenant of the work that enqueues it: `tenant-3` by default, `null` for none. */
+    readonly tenantId?: string | null;
+    readonly subject?: string;
+}
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export declare function aJob(id: string, overrides?: JobOverrides): {
+    id: string;
+    name: string;
+    queue: string;
+    payload: {};
+    enqueuedBy: EnqueuedBy;
+    enqueuedAt: Date;
+    runAt: Date;
+    idempotencyKey?: string;
+    subject?: string;
+};
+//# sourceMappingURL=a-job.d.ts.map

package/dist/contracts/job-store/a-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+FAA+F;AAC/F,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,YAAiB;;;;;;;;;;EAc5D"}

package/dist/contracts/job-store/a-job.js

@@ -0,0 +1,28 @@
+import { NOW, QUEUE } from './job-fixtures.js';
+const TENANT = 'tenant-3';
+const TRACEPARENT = '00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01';
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export function aJob(id, overrides = {}) {
+    const { name = 'billing.compile-statements', queue = QUEUE, runAt = NOW, idempotencyKey, subject } = overrides;
+    return {
+        id,
+        name,
+        queue,
+        payload: overrides.payload ?? { month: '2026-02', customers: ['c-1', 'c-2'], draft: false, total: 12.5 },
+        enqueuedBy: enqueuedBy(overrides.tenantId === undefined ? TENANT : overrides.tenantId),
+        enqueuedAt: NOW,
+        runAt,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+        ...(subject === undefined ? {} : { subject }),
+    };
+}
+function enqueuedBy(tenantId) {
+    const tenant = tenantId === null ? {} : { tenantId };
+    return {
+        correlationId: 'corr-1',
+        actor: { id: 'user-7', type: 'user', ...tenant, roles: ['accountant'], attributes: {} },
+        ...tenant,
+        traceparent: TRACEPARENT,
+    };
+}
+//# sourceMappingURL=a-job.js.map

package/dist/contracts/job-store/a-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.js","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,MAAM,WAAW,GAAG,yDAAyD,CAAC;AAa9E,+FAA+F;AAC/F,MAAM,UAAU,IAAI,CAAC,EAAU,EAAE,SAAS,GAAiB,EAAE;IAC3D,MAAM,EAAE,IAAI,GAAG,4BAA4B,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAE/G,OAAO;QACL,EAAE;QACF,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QACxG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACtF,UAAU,EAAE,GAAG;QACf,KAAK;QACL,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAAuB;IACzC,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;IAErD,OAAO;QACL,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QACvF,GAAG,MAAM;QACT,WAAW,EAAE,WAAW;KACzB,CAAC;AACJ,CAAC"}

package/dist/contracts/job-store/claim-suite.d.ts

@@ -0,0 +1,15 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export declare class ClaimSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private handsOutWhatWasAdded;
+    private respectsTheInstant;
+    private dropsDuplicates;
+    private keepsTheKeysOfTenantsApart;
+    private leasesWhatItHandsOut;
+    private addMany;
+    private claim;
+    private claimedIds;
+}
+//# sourceMappingURL=claim-suite.d.ts.map

package/dist/contracts/job-store/claim-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/claim-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,6GAA6G;AAC7G,qBAAa,UAAW,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IAClE,SAAS,CAAC,KAAK,IAAI,IAAI,CAMtB;IAED,OAAO,CAAC,oBAAoB;IAsC5B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,oBAAoB;YA+Bd,OAAO;IAMrB,OAAO,CAAC,KAAK;YAIC,UAAU;CAGzB"}

package/dist/contracts/job-store/claim-suite.js

@@ -0,0 +1,126 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export class ClaimSuite extends ContractSuite {
+    tests() {
+        this.handsOutWhatWasAdded();
+        this.respectsTheInstant();
+        this.dropsDuplicates();
+        this.keepsTheKeysOfTenantsApart();
+        this.leasesWhatItHandsOut();
+    }
+    handsOutWhatWasAdded() {
+        this.it('starts empty', async () => {
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 0, dead: 0 });
+            this.expect(await this.claimedIds(10, NOW)).toEqual([]);
+            this.expect(await this.subject.find('unknown')).toBe(undefined);
+        });
+        this.it('hands out the job exactly as added, the attempt counted, and shows it running', async () => {
+            const added = await this.subject.add(aJob('job-1'));
+            const [claimed] = await this.claim(10, NOW);
+            const { enqueuedBy, payload, name } = aJob('job-1');
+            this.expect(added).toEqual({ id: 'job-1', duplicate: false });
+            this.expect(claimed).toEqual({
+                id: 'job-1',
+                name,
+                queue: QUEUE,
+                payload,
+                enqueuedBy,
+                enqueuedAt: NOW,
+                attempt: 1,
+            });
+            this.expect((await this.subject.find('job-1'))?.status).toBe('running');
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 1, dead: 0 });
+        });
+        this.it('hands out the earliest first and only the jobs of the queue asked', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(-1_000) }));
+            await this.subject.add(aJob('job-2', { runAt: later(-3_000) }));
+            await this.subject.add(aJob('job-3', { name: 'audit.verify-chain', queue: 'audit' }));
+            await this.subject.add(aJob('job-4', { runAt: later(-1_000) }));
+            this.expect(await this.claimedIds(10, NOW)).toEqual(['job-2', 'job-1', 'job-4']);
+        });
+    }
+    respectsTheInstant() {
+        this.it('keeps a job due later until its instant', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.claimedIds(10, later(59_999))).toEqual([]);
+            this.expect(await this.claimedIds(10, later(60_000))).toEqual(['job-1']);
+        });
+        this.it('honours the limit and leaves the rest to the next claim', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-1', 'job-2']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-3']);
+        });
+    }
+    dropsDuplicates() {
+        this.it('answers the job already kept for the same name and idempotency key, and adds nothing', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const again = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb' }));
+            const otherName = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', name: 'billing.send-statements' }));
+            this.expect(again).toEqual({ id: 'job-1', duplicate: true });
+            this.expect(otherName).toEqual({ id: 'job-3', duplicate: false });
+            this.expect(await this.subject.find('job-2')).toBe(undefined);
+        });
+    }
+    keepsTheKeysOfTenantsApart() {
+        this.it('keeps the idempotency keys of two tenants, and of work without a tenant, apart', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const otherTenant = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb', tenantId: 'tenant-4' }));
+            const noTenant = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', tenantId: null }));
+            const noTenantAgain = await this.subject.add(aJob('job-4', { idempotencyKey: 'feb', tenantId: null }));
+            this.expect([otherTenant, noTenant, noTenantAgain]).toEqual([
+                { id: 'job-2', duplicate: false },
+                { id: 'job-3', duplicate: false },
+                { id: 'job-3', duplicate: true },
+            ]);
+        });
+        this.it('shows the tenant and the subject of a job, never its payload', async () => {
+            await this.subject.add(aJob('job-1', { subject: 'customer-9' }));
+            await this.subject.add(aJob('job-2', { tenantId: null }));
+            const [first, second] = [await this.subject.find('job-1'), await this.subject.find('job-2')];
+            this.expect([first?.tenantId, first?.subject, first !== undefined && 'payload' in first]).toEqual([
+                'tenant-3',
+                'customer-9',
+                false,
+            ]);
+            this.expect([second?.tenantId, second?.subject]).toEqual([undefined, undefined]);
+        });
+    }
+    leasesWhatItHandsOut() {
+        this.it('hides a claimed job until its lease ends, then hands it out again, one attempt more', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.claimedIds(10, later(LEASE_MS - 1))).toEqual([]);
+            const [again] = await this.claim(10, later(LEASE_MS));
+            this.expect(again?.attempt).toBe(2);
+        });
+        this.it('keeps a job hidden while its heartbeats extend the lease', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS * 2))).toBe(true);
+            this.expect(await this.claimedIds(10, later(LEASE_MS))).toEqual([]);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 2 }, later(LEASE_MS * 3))).toBe(false);
+        });
+        this.it('never hands the same job to two concurrent claims', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3', 'job-4', 'job-5', 'job-6']);
+            const batches = await Promise.all([this.claimedIds(4, NOW), this.claimedIds(4, NOW)]);
+            const ids = batches.flat();
+            this.expect(ids.length).toBe(6);
+            this.expect(new Set(ids).size).toBe(6);
+        });
+    }
+    async addMany(ids) {
+        for (const id of ids) {
+            await this.subject.add(aJob(id));
+        }
+    }
+    claim(limit, now) {
+        return this.subject.claim({ queue: QUEUE, limit, now, leaseMs: LEASE_MS });
+    }
+    async claimedIds(limit, now) {
+        return (await this.claim(limit, now)).map((job) => job.id);
+    }
+}
+//# sourceMappingURL=claim-suite.js.map

package/dist/contracts/job-store/claim-suite.js.map

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

package/dist/contracts/job-store/job-fixtures.d.ts

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export declare const NOW: Date;
+export declare const LEASE_MS = 30000;
+export declare const QUEUE = "billing";
+//# sourceMappingURL=job-fixtures.d.ts.map

package/dist/contracts/job-store/job-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,GAAG,MAAuC,CAAC;AAExD,eAAO,MAAM,QAAQ,QAAS,CAAC;AAE/B,eAAO,MAAM,KAAK,YAAY,CAAC"}

package/dist/contracts/job-store/job-fixtures.js

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export const NOW = new Date('2026-03-01T10:00:00.000Z');
+export const LEASE_MS = 30_000;
+export const QUEUE = 'billing';
+//# sourceMappingURL=job-fixtures.js.map

package/dist/contracts/job-store/job-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.js","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC"}

package/dist/contracts/job-store/job-store-under-contract.d.ts

@@ -0,0 +1,61 @@
+import type { EnqueuedBy, EnqueuedJob, JobProgress, QueuedJob } from '@ddd-ts-kit/kernel';
+interface Lease {
+    readonly id: string;
+    readonly attempt: number;
+}
+interface Claimed {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: unknown;
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    readonly attempt: number;
+    readonly checkpoint?: unknown;
+}
+/**
+ * The job store port of `@ddd-ts-kit/scheduling`, restated structurally so that this package
+ * does not depend on it. Any `JobStore` fits.
+ */
+export interface JobStoreUnderContract {
+    add(job: {
+        readonly id: string;
+        readonly name: string;
+        readonly queue: string;
+        readonly payload: unknown;
+        readonly enqueuedBy: EnqueuedBy;
+        readonly enqueuedAt: Date;
+        readonly runAt: Date;
+        readonly idempotencyKey?: string;
+        readonly subject?: string;
+    }): Promise<EnqueuedJob>;
+    claim(request: {
+        queue: string;
+        limit: number;
+        now: Date;
+        leaseMs: number;
+    }): Promise<Claimed[]>;
+    heartbeat(lease: Lease, leaseUntil: Date): Promise<boolean>;
+    update(lease: Lease, update: {
+        progress?: JobProgress;
+        checkpoint?: unknown;
+    }, leaseUntil: Date): Promise<boolean>;
+    complete(lease: Lease, at: Date): Promise<boolean>;
+    fail(lease: Lease, failure: {
+        errorCode: string;
+        retryAt: Date | null;
+        at: Date;
+    }): Promise<boolean>;
+    release(lease: Lease, runAt: Date): Promise<boolean>;
+    cancel(id: string, at: Date): Promise<boolean>;
+    find(id: string): Promise<QueuedJob | undefined>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgeFinished(before: Date): Promise<number>;
+    stats(queue: string): Promise<{
+        readonly waiting: number;
+        readonly running: number;
+        readonly dead: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=job-store-under-contract.d.ts.map

package/dist/contracts/job-store/job-store-under-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-store-under-contract.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/job-store-under-contract.ts"],"names":[],"mappings":"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"}

package/dist/contracts/job-store/job-store-under-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=job-store-under-contract.js.map

package/dist/contracts/job-store/job-store-under-contract.js.map

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

package/dist/contracts/job-store/keep-suite.d.ts

@@ -0,0 +1,11 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** Cancellation and housekeeping. */
+export declare class KeepSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private cancels;
+    private purges;
+    private finished;
+    private claim;
+}
+//# sourceMappingURL=keep-suite.d.ts.map

package/dist/contracts/job-store/keep-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/keep-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,qCAAqC;AACrC,qBAAa,SAAU,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACjE,SAAS,CAAC,KAAK,IAAI,IAAI,CAGtB;IAED,OAAO,CAAC,OAAO;IA+Bf,OAAO,CAAC,MAAM;YAcA,QAAQ;IAMtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/contracts/job-store/keep-suite.js

@@ -0,0 +1,55 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** Cancellation and housekeeping. */
+export class KeepSuite extends ContractSuite {
+    tests() {
+        this.cancels();
+        this.purges();
+    }
+    cancels() {
+        this.it('cancels a waiting job: it is never handed out', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            const job = await this.subject.find('job-1');
+            this.expect([job?.status, job?.finishedAt]).toEqual(['cancelled', NOW]);
+            this.expect(await this.claim(later(60_000))).toEqual([]);
+        });
+        this.it('cancels a running job: its next report is refused', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS))).toBe(false);
+            this.expect(await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW)).toBe(false);
+        });
+        this.it('cannot cancel what is over or unknown', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(false);
+            this.expect(await this.subject.cancel('unknown', NOW)).toBe(false);
+        });
+    }
+    purges() {
+        this.it('purges what succeeded or was cancelled before the instant, and keeps the dead', async () => {
+            await this.finished('job-1', (lease) => this.subject.complete(lease, NOW));
+            await this.finished('job-2', (lease) => this.subject.fail(lease, { errorCode: 'X', retryAt: null, at: NOW }));
+            await this.subject.add(aJob('job-3', { runAt: later(60_000) }));
+            await this.subject.cancel('job-3', later(1_000));
+            this.expect(await this.subject.purgeFinished(NOW)).toBe(0);
+            this.expect(await this.subject.purgeFinished(later(1_001))).toBe(2);
+            this.expect(await this.subject.find('job-1')).toBe(undefined);
+            this.expect((await this.subject.find('job-2'))?.status).toBe('dead');
+        });
+    }
+    async finished(id, finish) {
+        await this.subject.add(aJob(id));
+        await this.claim(NOW);
+        await finish({ id, attempt: 1 });
+    }
+    claim(now) {
+        return this.subject.claim({ queue: QUEUE, limit: 10, now, leaseMs: LEASE_MS });
+    }
+}
+//# sourceMappingURL=keep-suite.js.map

package/dist/contracts/job-store/keep-suite.js.map

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

package/dist/contracts/job-store/later.d.ts

@@ -0,0 +1,3 @@
+/** That many milliseconds after `NOW`. */
+export declare function later(ms: number): Date;
+//# sourceMappingURL=later.d.ts.map

package/dist/contracts/job-store/later.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"later.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/later.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtC"}

package/dist/contracts/job-store/later.js

@@ -0,0 +1,6 @@
+import { NOW } from './job-fixtures.js';
+/** That many milliseconds after `NOW`. */
+export function later(ms) {
+    return new Date(NOW.getTime() + ms);
+}
+//# sourceMappingURL=later.js.map

package/dist/contracts/job-store/later.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"later.js","sourceRoot":"","sources":["../../../src/contracts/job-store/later.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,0CAA0C;AAC1C,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/contracts/job-store/report-suite.d.ts

@@ -0,0 +1,12 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** What a worker reports of an attempt: progress and checkpoint, success, failure, release. Only the attempt that holds the job is heard. */
+export declare class ReportSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private progressAndOutcomes;
+    private deadAndRevived;
+    private releasedAndStale;
+    private claimFirst;
+    private claim;
+}
+//# sourceMappingURL=report-suite.d.ts.map

package/dist/contracts/job-store/report-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/report-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAI3E,6IAA6I;AAC7I,qBAAa,WAAY,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACnE,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,mBAAmB;IA6C3B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,gBAAgB;YAsBV,UAAU;IAKxB,OAAO,CAAC,KAAK;CAGd"}