@ocoda/event-sourcing-mariadb 4.0.0-next.1 → 4.0.0

package/README.md

@@ -21,24 +21,29 @@
 
 ## About this library
 
-This is a complementing module for `@ocoda/event-sourcing`, a powerful library designed to simplify the implementation of advanced architectural patterns in your [**NestJS**](https://nestjs.com/) application. It provides essential building blocks to help you implement Domain-Driven Design (DDD), CQRS and leverage Event Sourcing to tackle the complexities of modern systems.
+This is a store integration for `@ocoda/event-sourcing`, a library for [**NestJS**](https://nestjs.com/) with the building blocks for Domain-Driven Design (DDD), CQRS and Event Sourcing.
 
-This store-driver library uses [MariaDB](https://mariadb.com/) as an underlying driver for event- and snapshot-stores, and needs to be installed together with the core module `@ocoda/event-sourcing` in order to get started.
+It provides the `MariaDBEventStore` and `MariaDBSnapshotStore`, on InnoDB: they keep events and snapshots in [MariaDB](https://mariadb.com/), with a global position per pool for `readAll()`. It is tested on MariaDB 10.11, 11.4, 11.8 and 12.3, and the newest rolling release.
 
 ## Installation
-The `mariadb` driver is a peer dependency, so install it next to the core module:
+The `mariadb` driver (`^3.5.3`) is a peer dependency, so install it next to the core module:
 ```bash
 npm install @ocoda/event-sourcing @ocoda/event-sourcing-mariadb mariadb
 ```
 
-Requires Node.js 22.12 or later and NestJS 12. The package is ESM-only; CommonJS applications load it through `require()`, which Node.js supports for ES modules since 22.12.
+Requires Node.js 22.12 or later and NestJS 12. The package is ESM-only; CommonJS applications load it through `require()`, which Node.js supports for ES modules since 22.12. Keep it on the same version as `@ocoda/event-sourcing`.
+
+## Upgrading from 3.x
+4.0 stores events and snapshots in a new schema (schema v2), and refuses a 3.x event table until it is migrated. Migrate it once, offline, with `migrate()`, after a dry run: see the [runbook](https://ocoda.github.io/event-sourcing/integrations/mariadb#runbook) and [Migrating from 3.x to 4.0](https://ocoda.github.io/event-sourcing/upgrading/v4).
 
 ## Documentation 📗
-Ready to dive right in? Visit [the documentation](https://ocoda.github.io/event-sourcing) to find out how to get started.
+- [MariaDB](https://ocoda.github.io/event-sourcing/integrations/mariadb): the configuration, the schema, the privileges and the migration from 3.x.
+- [The documentation](https://ocoda.github.io/event-sourcing) starts with the [installation](https://ocoda.github.io/event-sourcing/start/install). The 3.x documentation is at [ocoda.github.io/event-sourcing/v3](https://ocoda.github.io/event-sourcing/v3/).
+- [Versioning and support](https://ocoda.github.io/event-sourcing/upgrading/versioning) and the [changelog](https://github.com/ocoda/event-sourcing/blob/master/packages/integration/mariadb/CHANGELOG.md).
 
 ## Contact
 dries@drieshooghe.com
  
 
 ## Acknowledgments
-This library is inspired by [@nestjs/cqrs](https://github.com/nestjs/cqrs)
+This library is inspired by [@nestjs/cqrs](https://github.com/nestjs/cqrs)

package/dist/interfaces/mariadb-event-entity.d.ts

@@ -1,4 +1,7 @@
-import type { IEvent, IEventPayload } from '@ocoda/event-sourcing';
+import type { EventHeaders, IEvent, IEventPayload } from '@ocoda/event-sourcing';
+/**
+ * A row of an event table (schema v2), as the store reads it: `global_position` and `occurred_on` as text.
+ */
 export type MariaDBEventEntity = {
     stream_id: string;
     version: number;
@@ -6,8 +9,13 @@ export type MariaDBEventEntity = {
     payload: IEventPayload<IEvent>;
     event_id: string;
     aggregate_id: string;
-    occurred_on: Date;
+    /** UTC wall time, `YYYY-MM-DD HH:MM:SS.mmm`. */
+    occurred_on: string;
     correlation_id: string | null;
     causation_id: string | null;
+    /** A decimal integer. */
+    global_position: string;
+    headers: EventHeaders | null;
+    event_version: number | null;
 };
 //# sourceMappingURL=mariadb-event-entity.d.ts.map

package/dist/interfaces/mariadb-event-entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mariadb-event-entity.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-event-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,IAAI,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC"}
+{"version":3,"file":"mariadb-event-entity.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-event-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yBAAyB;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC"}

package/dist/interfaces/mariadb-event-store-config.d.ts

@@ -1,8 +1,12 @@
 import type { Type } from '@nestjs/common';
-import type { EventStoreConfig } from '@ocoda/event-sourcing';
+import type { EventStoreConfig, SchemaOptions } from '@ocoda/event-sourcing';
 import type { PoolConfig } from 'mariadb';
 import type { MariaDBEventStore } from '../mariadb.event-store.js';
-export interface MariaDBEventStoreConfig extends EventStoreConfig, PoolConfig {
+/**
+ * The configuration of a `MariaDBEventStore`: the `mariadb` pool options, and `ddl`, which says whether the store may
+ * create its tables (`'auto'`, the default) or only checks them (`'none'`).
+ */
+export interface MariaDBEventStoreConfig extends EventStoreConfig, PoolConfig, SchemaOptions {
     driver: Type<MariaDBEventStore>;
 }
 //# sourceMappingURL=mariadb-event-store-config.d.ts.map

package/dist/interfaces/mariadb-event-store-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mariadb-event-store-config.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-event-store-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB,EAAE,UAAU;IAC5E,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;CAChC"}
+{"version":3,"file":"mariadb-event-store-config.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-event-store-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB,EAAE,UAAU,EAAE,aAAa;IAC3F,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;CAChC"}

package/dist/interfaces/mariadb-snapshot-entity.d.ts

@@ -1,12 +1,16 @@
 import type { AggregateRoot, ISnapshot } from '@ocoda/event-sourcing';
+/**
+ * A row of a snapshot table. `registered_on` is read as UTC wall time text from a schema v2 table, and as a `Date`
+ * (through the connector, like 3.x) from a 3.x table.
+ */
 export type MariaDBSnapshotEntity<A extends AggregateRoot> = {
     stream_id: string;
     version: number;
     payload: ISnapshot<A>;
     snapshot_id: string;
     aggregate_id: string;
-    registered_on: Date;
+    registered_on: string | Date;
     aggregate_name: string;
-    latest?: string;
+    latest?: string | null;
 };
 //# sourceMappingURL=mariadb-snapshot-entity.d.ts.map

package/dist/interfaces/mariadb-snapshot-entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mariadb-snapshot-entity.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-snapshot-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,aAAa,IAAI;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"mariadb-snapshot-entity.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-snapshot-entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,aAAa,IAAI;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC"}

package/dist/interfaces/mariadb-snapshot-store-config.d.ts

@@ -1,8 +1,12 @@
 import type { Type } from '@nestjs/common';
-import type { SnapshotStoreConfig } from '@ocoda/event-sourcing';
+import type { SchemaOptions, SnapshotStoreConfig } from '@ocoda/event-sourcing';
 import type { PoolConfig } from 'mariadb';
 import type { MariaDBSnapshotStore } from '../mariadb.snapshot-store.js';
-export interface MariaDBSnapshotStoreConfig extends SnapshotStoreConfig, PoolConfig {
+/**
+ * The configuration of a `MariaDBSnapshotStore`: the `mariadb` pool options, and `ddl`, which says whether the store
+ * may create its tables (`'auto'`, the default) or only checks them (`'none'`).
+ */
+export interface MariaDBSnapshotStoreConfig extends SnapshotStoreConfig, PoolConfig, SchemaOptions {
     driver: Type<MariaDBSnapshotStore>;
 }
 //# sourceMappingURL=mariadb-snapshot-store-config.d.ts.map

package/dist/interfaces/mariadb-snapshot-store-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mariadb-snapshot-store-config.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-snapshot-store-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB,EAAE,UAAU;IAClF,MAAM,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;CACnC"}
+{"version":3,"file":"mariadb-snapshot-store-config.d.ts","sourceRoot":"","sources":["../../lib/interfaces/mariadb-snapshot-store-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB,EAAE,UAAU,EAAE,aAAa;IACjG,MAAM,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;CACnC"}

package/dist/mariadb.event-store.d.ts

@@ -1,20 +1,77 @@
-import { EventEnvelope, EventStore, type EventStream, type IAllEventsFilter, type IEvent, type IEventCollection, type IEventCollectionFilter, type IEventFilter, type IEventPool } from '@ocoda/event-sourcing';
+import { EventEnvelope, EventStore, type EventStoreCapabilities, type EventStream, type IEventCollection, type IEventCollectionFilter, type IEventFilter, type IEventPool, type IReadAllFilter, type MigrationOptions, type MigrationReport, type PersistOutcome, type PersistTarget } from '@ocoda/event-sourcing';
 import type { MariaDBEventStoreConfig } from './interfaces/index.js';
+/**
+ * An event store on MariaDB (InnoDB), with schema v2 (ADR 0002 §3).
+ *
+ * - Every pool has a table, `events` or `<pool>-events`, registered in the `event_sourcing_collections` catalog, whose
+ *   row counts the pool's global positions.
+ * - An append takes its positions from that counter, as the first write of its transaction, so appends to a pool
+ *   commit in the order of their positions, and a reader never skips one (`globalOrder: 'gap-safe'`).
+ * - `ensureCollection` creates the tables (`ddl: 'auto'`) or checks them (`ddl: 'none'`), and refuses 3.x tables:
+ *   migrate them with `MariaDBEventStore.migrate()`.
+ */
 export declare class MariaDBEventStore extends EventStore<MariaDBEventStoreConfig> {
+    /**
+     * Final once `connect()` resolved: a Galera cluster (`wsrep_on`) orders the positions per node only, so it gets
+     * `'best-effort'`.
+     */
+    readonly capabilities: EventStoreCapabilities;
     private pool;
+    /**
+     * Migrates the event tables of a 3.x store to schema v2, without a NestJS application: inspects every table (or the
+     * tables of `options.pools`), plans, and, unless `dryRun`, migrates them one by one. Stop every 3.x instance first.
+     */
+    static migrate(config: Omit<MariaDBEventStoreConfig, 'driver'>, options?: MigrationOptions): Promise<MigrationReport>;
+    /**
+     * Migrates the event tables of this store's database to schema v2, on a connection of its own; see the static
+     * `MariaDBEventStore.migrate()`.
+     */
+    migrate(options?: MigrationOptions): Promise<MigrationReport>;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
+    /**
+     * Creates the table of a pool and registers it in the catalog (`ddl: 'auto'`), or checks and registers it
+     * (`ddl: 'none'`). Registering heals the pool's position counter: it becomes at least the highest position stored.
+     * @throws EventStoreSchemaException when the table has the 3.x schema, or, with `ddl: 'none'`, doesn't exist
+     */
     ensureCollection(pool?: IEventPool): Promise<IEventCollection>;
+    /**
+     * Lists the event collections of the catalog, in binary order. 3.x tables are not listed: they aren't registered.
+     */
     listCollections(filter?: IEventCollectionFilter): AsyncGenerator<IEventCollection[]>;
-    getEvents({ streamId }: EventStream, filter?: IEventFilter): AsyncGenerator<IEvent[]>;
-    getEvent({ streamId }: EventStream, version: number, pool?: IEventPool): Promise<IEvent>;
-    appendEvents(stream: EventStream, aggregateVersion: number, events: IEvent[] | EventEnvelope[], pool?: IEventPool): Promise<EventEnvelope[]>;
+    getStreamVersion({ streamId }: EventStream, pool?: IEventPool): Promise<number>;
     getEnvelope({ streamId }: EventStream, version: number, pool?: IEventPool): Promise<EventEnvelope>;
     getEnvelopes({ streamId }: EventStream, filter?: IEventFilter): AsyncGenerator<EventEnvelope[]>;
-    getAllEnvelopes(filter: IAllEventsFilter): AsyncGenerator<EventEnvelope[]>;
     /**
-     * Best effort lookup of the latest version of a stream, used to report a conflict.
+     * Reads the envelopes of a pool in the order of their global positions, one statement per batch.
+     *
+     * InnoDB builds a read view from a walk over the active transactions that isn't atomic, so a batch can, rarely, show
+     * a position without an earlier one that committed just before it. A batch is therefore delivered only as far as its
+     * positions are contiguous from where the read is. At a gap, the reader reads the counter with a shared lock, which
+     * waits for the append that holds it: every position up to it is committed and visible then, and a gap below it is
+     * permanent (a deleted event, or a pool that was dropped and created again).
+     *
+     * Both reads must reach the server the appends run on: behind a proxy that sends plain reads to a replica, a gap of
+     * the replica's lag would pass for a permanent one.
+     */
+    readAll(filter?: IReadAllFilter): AsyncGenerator<EventEnvelope[]>;
+    /**
+     * Stores the envelopes of an append in one transaction, whose first write takes their positions from the pool's
+     * counter in the catalog. The counter's row lock serializes the appends to a pool until they commit.
+     */
+    protected persistEvents(envelopes: readonly EventEnvelope[], { stream, collection, pool }: PersistTarget): Promise<PersistOutcome>;
+    /**
+     * What a failed append before its commit means: another append took the (stream, version) key (a conflict), or
+     * nothing was stored.
+     */
+    private classifyFailure;
+    private readPositions;
+    /**
+     * The last position of the pool's counter, read with a shared lock: it waits until the append that holds the counter
+     * committed or rolled back, and every transaction that took a position up to it has left the set of active
+     * transactions before it returns (InnoDB deregisters a committing transaction before it releases its locks).
      */
-    private getLatestVersion;
+    private readHighWaterMark;
+    private connected;
 }
 //# sourceMappingURL=mariadb.event-store.d.ts.map

package/dist/mariadb.event-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mariadb.event-store.d.ts","sourceRoot":"","sources":["../lib/mariadb.event-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,aAAa,EAGb,UAAU,EAIV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,UAAU,EAEf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAsB,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGzF,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,uBAAuB,CAAC;IACzE,OAAO,CAAC,IAAI,CAAO;IAEN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpC;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvC;IAEY,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB1E;IAEa,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAgBjG;IAEM,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAkC3F;IAEK,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7F;IAEK,YAAY,CACjB,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,EAClC,IAAI,CAAC,EAAE,UAAU,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CA6F1B;IAEK,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBvG;IAEM,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC,CAgDrG;IAEM,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC,CA4ChF;IAED;;OAEG;YACW,gBAAgB;CAe9B"}
+{"version":3,"file":"mariadb.event-store.d.ts","sourceRoot":"","sources":["../lib/mariadb.event-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,aAAa,EAIb,UAAU,EACV,KAAK,sBAAsB,EAI3B,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAIlB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAsB,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAqCzF;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,uBAAuB,CAAC;IACzE;;;OAGG;IACH,SAAkB,YAAY,EAAE,sBAAsB,CAIpD;IAEF,OAAO,CAAC,IAAI,CAAmB;IAE/B;;;OAGG;IACH,MAAM,CAAC,OAAO,CACb,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,EAC/C,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAE1B;IAED;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5D;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBpC;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvC;IAED;;;;OAIG;IACU,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2C1E;IAED;;OAEG;IACW,eAAe,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAyBjG;IAEY,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAW3F;IAEY,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAiB9G;IAEa,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC,CA6B5G;IAED;;;;;;;;;;;OAWG;IACW,OAAO,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC,CAoC9E;IAED;;;OAGG;IACH,UAAgB,aAAa,CAC5B,SAAS,EAAE,SAAS,aAAa,EAAE,EACnC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,aAAa,GACzC,OAAO,CAAC,cAAc,CAAC,CAsFzB;IAED;;;OAGG;IACH,OAAO,CAAC,eAAe;YAoBT,aAAa;IAoB3B;;;;OAIG;YACW,iBAAiB;IAgB/B,OAAO,CAAC,SAAS;CAMjB"}