@geekity/cms 0.3.0 → 0.5.0

package/dist/cache.d.ts

@@ -0,0 +1,141 @@
+import { DatabaseSync } from 'node:sqlite';
+/**
+ * The one SQLite file a site has, and the rules for opening it.
+ *
+ * Everything in it is derived (decision-9): the content index is a reading of
+ * `content/`, the followers and the inbox indexes are a reading of
+ * `content/_data/federation/`, and what is left — sessions, delivery outcomes,
+ * the relay handshake, the scheduler's watermark — is a cache a site may lose.
+ * So the file may be deleted at rest, and this module is where that promise is
+ * kept: it owns the file's name, the migration ledger both stores keep inside
+ * it, and what happens when the file that is there cannot be used.
+ */
+/** File name of the derived database inside a site's data directory. */
+export declare const DATABASE_FILE = "geekity.db";
+/**
+ * The suffixes SQLite hangs off the database in WAL mode.
+ *
+ * Deleting the database without them leaves a write-ahead log describing a
+ * file that is no longer there, which the next connection would either replay
+ * into a fresh database or refuse; all three go together or none do.
+ */
+export declare const DATABASE_SUFFIXES: readonly string[];
+/** Where the database lives under `dataDir`. */
+export declare function databaseFile(dataDir: string): string;
+/** Every file the database is spread across, whether or not it is there. */
+export declare function databaseFiles(dataDir: string): string[];
+/**
+ * Throw the database away, log and all.
+ *
+ * Silent about files that are not there, because that is the ordinary case for
+ * `-wal` and `-shm` after a clean shutdown, and because a site is entitled to
+ * delete the database itself between two boots.
+ *
+ * Nothing may hold the file open across this. An open connection keeps the
+ * inode it was given, so it would go on reading and writing a database nobody
+ * can find while the next connection creates a different one under the same
+ * name.
+ */
+export declare function discardDatabase(dataDir: string): void;
+/**
+ * A database this package cannot use and must not throw away on its own.
+ *
+ * Two things raise it. A ledger holding a version this package does not ship
+ * is a downgrade: the file was written by a later `@geekity/cms`, whose schema
+ * this one would misread. A file SQLite will not open at all is damaged. In
+ * both cases the way out is a decision only a person can make, and the message
+ * names it — which is what {@link discardDatabase} and `geekity rebuild` are.
+ */
+export declare class UnusableDatabaseError extends Error {
+    constructor(message: string);
+}
+/**
+ * A database older than the migrations this package still ships, so there is
+ * no path forward from it.
+ *
+ * Unlike {@link UnusableDatabaseError} this one is recoverable without asking
+ * anybody, and {@link withRebuiltDatabase} recovers from it: nothing in the
+ * database is anything but a reading of the files, so a version of it too old
+ * to carry forward is thrown away and read again.
+ */
+export declare class OutdatedDatabaseError extends Error {
+    constructor(message: string);
+}
+/** One schema version. */
+export interface Migration {
+    /** Its place in the order, and its entry in the ledger. */
+    version: number;
+    /** The schema change itself. */
+    sql: string;
+    /**
+     * A backfill, run in the same transaction once {@link Migration.sql} has.
+     *
+     * For a column derived from something already stored: SQL can add the column
+     * and JavaScript can then fill it with exactly what the writer will put
+     * there, rather than with a second, subtly different expression of the same
+     * rule.
+     */
+    run?: (db: DatabaseSync) => void;
+}
+/** One set of migrations and the table recording which of them have run. */
+export interface MigrationLedger {
+    /** The database file, so a refusal can name it. */
+    file: string;
+    /** The table the applied versions are recorded in. */
+    ledger: string;
+    /** Every version this package ships, in order. */
+    migrations: readonly Migration[];
+}
+/**
+ * Bring one ledger's schema up to date, or refuse to.
+ *
+ * There are two ledgers in the one file — `migrations` for the content index
+ * and `admin_migrations` for everything else — because the two stores were
+ * written apart and each ships its own versions. They share this loop, and so
+ * share what happens when the versions in the file are not the versions in the
+ * package:
+ *
+ * - **Ahead of us.** A version recorded that this package does not ship means
+ *   a newer `@geekity/cms` wrote the file. Applying our own migrations over it
+ *   would be reading somebody else's schema as if it were ours, so this
+ *   refuses, names the file and says both ways out.
+ * - **Behind what we can carry.** A newest version below the oldest migration
+ *   still shipped means the steps in between have been pruned from the package
+ *   and there is no path from that schema to this one. That is
+ *   {@link OutdatedDatabaseError}, and the caller is expected to throw the
+ *   database away rather than to stop.
+ * - **Empty.** A new database, whatever the oldest shipped version is.
+ *
+ * Applying is idempotent, and each migration is its own transaction, so a
+ * failure part-way leaves the ledger describing exactly the schema on disk.
+ */
+export declare function applyMigrations(db: DatabaseSync, ledger: MigrationLedger): void;
+/** What {@link openDatabase} needs: where the file is and which ledger to run. */
+export interface OpenDatabaseOptions extends Omit<MigrationLedger, 'file'> {
+    /** Directory the database lives in. Created if it is missing. */
+    dataDir: string;
+}
+/**
+ * Open the database under `dataDir`, creating it if it is not there, and bring
+ * one ledger up to date.
+ *
+ * A database that will not open is turned into an {@link UnusableDatabaseError}
+ * naming the file, because SQLite's own message for it ("file is not a
+ * database") says nothing about which file or what to do about it, and this is
+ * the failure a site is most likely to meet at three in the morning.
+ * {@link OutdatedDatabaseError} passes through untouched: it is the one the
+ * caller is meant to recover from.
+ */
+export declare function openDatabase(options: OpenDatabaseOptions): DatabaseSync;
+/**
+ * Open the cache, and if the only thing wrong with it is its age, throw it away
+ * and open it again.
+ *
+ * `open` has to be able to run twice, and has to have closed whatever it
+ * opened before it throws: the file cannot be deleted while a connection holds
+ * it. It is a callback rather than a database because a site's boot opens two
+ * connections against the one file, and both of them, or neither, must be over
+ * the database that survives.
+ */
+export declare function withRebuiltDatabase<T>(dataDir: string, open: () => T): T;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAyB,CAAC;AAEzE,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;CAClC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqD/E;AAED,kFAAkF;AAClF,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IACxE,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAuBvE;AAYD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAQxE"}

package/dist/cache.js

@@ -0,0 +1,207 @@
+import { mkdirSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+/**
+ * The one SQLite file a site has, and the rules for opening it.
+ *
+ * Everything in it is derived (decision-9): the content index is a reading of
+ * `content/`, the followers and the inbox indexes are a reading of
+ * `content/_data/federation/`, and what is left — sessions, delivery outcomes,
+ * the relay handshake, the scheduler's watermark — is a cache a site may lose.
+ * So the file may be deleted at rest, and this module is where that promise is
+ * kept: it owns the file's name, the migration ledger both stores keep inside
+ * it, and what happens when the file that is there cannot be used.
+ */
+/** File name of the derived database inside a site's data directory. */
+export const DATABASE_FILE = 'geekity.db';
+/**
+ * The suffixes SQLite hangs off the database in WAL mode.
+ *
+ * Deleting the database without them leaves a write-ahead log describing a
+ * file that is no longer there, which the next connection would either replay
+ * into a fresh database or refuse; all three go together or none do.
+ */
+export const DATABASE_SUFFIXES = ['', '-wal', '-shm'];
+/** Where the database lives under `dataDir`. */
+export function databaseFile(dataDir) {
+    return path.join(dataDir, DATABASE_FILE);
+}
+/** Every file the database is spread across, whether or not it is there. */
+export function databaseFiles(dataDir) {
+    return DATABASE_SUFFIXES.map((suffix) => `${databaseFile(dataDir)}${suffix}`);
+}
+/**
+ * Throw the database away, log and all.
+ *
+ * Silent about files that are not there, because that is the ordinary case for
+ * `-wal` and `-shm` after a clean shutdown, and because a site is entitled to
+ * delete the database itself between two boots.
+ *
+ * Nothing may hold the file open across this. An open connection keeps the
+ * inode it was given, so it would go on reading and writing a database nobody
+ * can find while the next connection creates a different one under the same
+ * name.
+ */
+export function discardDatabase(dataDir) {
+    for (const file of databaseFiles(dataDir))
+        rmSync(file, { force: true });
+}
+/**
+ * A database this package cannot use and must not throw away on its own.
+ *
+ * Two things raise it. A ledger holding a version this package does not ship
+ * is a downgrade: the file was written by a later `@geekity/cms`, whose schema
+ * this one would misread. A file SQLite will not open at all is damaged. In
+ * both cases the way out is a decision only a person can make, and the message
+ * names it — which is what {@link discardDatabase} and `geekity rebuild` are.
+ */
+export class UnusableDatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UnusableDatabaseError';
+    }
+}
+/**
+ * A database older than the migrations this package still ships, so there is
+ * no path forward from it.
+ *
+ * Unlike {@link UnusableDatabaseError} this one is recoverable without asking
+ * anybody, and {@link withRebuiltDatabase} recovers from it: nothing in the
+ * database is anything but a reading of the files, so a version of it too old
+ * to carry forward is thrown away and read again.
+ */
+export class OutdatedDatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OutdatedDatabaseError';
+    }
+}
+/**
+ * Bring one ledger's schema up to date, or refuse to.
+ *
+ * There are two ledgers in the one file — `migrations` for the content index
+ * and `admin_migrations` for everything else — because the two stores were
+ * written apart and each ships its own versions. They share this loop, and so
+ * share what happens when the versions in the file are not the versions in the
+ * package:
+ *
+ * - **Ahead of us.** A version recorded that this package does not ship means
+ *   a newer `@geekity/cms` wrote the file. Applying our own migrations over it
+ *   would be reading somebody else's schema as if it were ours, so this
+ *   refuses, names the file and says both ways out.
+ * - **Behind what we can carry.** A newest version below the oldest migration
+ *   still shipped means the steps in between have been pruned from the package
+ *   and there is no path from that schema to this one. That is
+ *   {@link OutdatedDatabaseError}, and the caller is expected to throw the
+ *   database away rather than to stop.
+ * - **Empty.** A new database, whatever the oldest shipped version is.
+ *
+ * Applying is idempotent, and each migration is its own transaction, so a
+ * failure part-way leaves the ledger describing exactly the schema on disk.
+ */
+export function applyMigrations(db, ledger) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS ${ledger.ledger} (
+      version    INTEGER PRIMARY KEY,
+      applied_at TEXT NOT NULL
+    )
+  `);
+    const applied = new Set(db
+        .prepare(`SELECT version FROM ${ledger.ledger}`)
+        .all()
+        .map((row) => Number(row['version'])));
+    const shipped = new Set(ledger.migrations.map((migration) => migration.version));
+    const latest = Math.max(...shipped);
+    const ahead = [...applied].filter((version) => version > latest).sort((a, b) => a - b);
+    if (ahead.length > 0) {
+        throw new UnusableDatabaseError(`${ledger.file} was written by a newer version of @geekity/cms: its ${ledger.ledger} ` +
+            `table records schema ${ahead.join(', ')}, which this version does not ship. Upgrade ` +
+            '@geekity/cms to the version that wrote it, or delete the database with `geekity ' +
+            'rebuild` — it holds nothing that is not read back from content/ and data/.');
+    }
+    const oldest = Math.min(...shipped);
+    const newest = applied.size === 0 ? undefined : Math.max(...applied);
+    if (newest !== undefined && newest < oldest - 1) {
+        throw new OutdatedDatabaseError(`${ledger.file} is at schema ${String(newest)}, and the oldest migration this version of ` +
+            `@geekity/cms ships is ${String(oldest)}, so there is no path forward from it.`);
+    }
+    const record = db.prepare(`INSERT INTO ${ledger.ledger} (version, applied_at) VALUES (?, ?)`);
+    for (const migration of ledger.migrations) {
+        if (applied.has(migration.version))
+            continue;
+        db.exec('BEGIN');
+        try {
+            db.exec(migration.sql);
+            migration.run?.(db);
+            record.run(migration.version, new Date().toISOString());
+            db.exec('COMMIT');
+        }
+        catch (error) {
+            db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+}
+/**
+ * Open the database under `dataDir`, creating it if it is not there, and bring
+ * one ledger up to date.
+ *
+ * A database that will not open is turned into an {@link UnusableDatabaseError}
+ * naming the file, because SQLite's own message for it ("file is not a
+ * database") says nothing about which file or what to do about it, and this is
+ * the failure a site is most likely to meet at three in the morning.
+ * {@link OutdatedDatabaseError} passes through untouched: it is the one the
+ * caller is meant to recover from.
+ */
+export function openDatabase(options) {
+    const file = databaseFile(options.dataDir);
+    mkdirSync(options.dataDir, { recursive: true });
+    let db;
+    try {
+        db = new DatabaseSync(file);
+        db.exec('PRAGMA journal_mode = WAL');
+        db.exec('PRAGMA foreign_keys = ON');
+    }
+    catch (error) {
+        throw unusable(file, error);
+    }
+    try {
+        applyMigrations(db, { file, ledger: options.ledger, migrations: options.migrations });
+    }
+    catch (error) {
+        db.close();
+        if (error instanceof UnusableDatabaseError || error instanceof OutdatedDatabaseError)
+            throw error;
+        throw unusable(file, error);
+    }
+    return db;
+}
+/** A SQLite failure, said in terms of the file and the way out. */
+function unusable(file, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return new UnusableDatabaseError(`${file} could not be opened as a database (${detail}). It holds nothing that is not read ` +
+        'back from content/ and data/, so the fix is to delete it: run `geekity rebuild`, or ' +
+        'remove the file and its -wal and -shm siblings and start the site again.');
+}
+/**
+ * Open the cache, and if the only thing wrong with it is its age, throw it away
+ * and open it again.
+ *
+ * `open` has to be able to run twice, and has to have closed whatever it
+ * opened before it throws: the file cannot be deleted while a connection holds
+ * it. It is a callback rather than a database because a site's boot opens two
+ * connections against the one file, and both of them, or neither, must be over
+ * the database that survives.
+ */
+export function withRebuiltDatabase(dataDir, open) {
+    try {
+        return open();
+    }
+    catch (error) {
+        if (!(error instanceof OutdatedDatabaseError))
+            throw error;
+        discardDatabase(dataDir);
+        return open();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import type { GeekityConfig } from './config.ts';
-export type Command = 'serve' | 'init' | 'sync' | 'user' | 'help' | 'version';
+export type Command = 'serve' | 'init' | 'sync' | 'rebuild' | 'user' | 'import' | 'help' | 'version';
 export interface ParsedArgs {
     command: Command;
     /** Path to the config file, relative to the working directory, if the user named one. */
@@ -11,9 +11,21 @@ export interface ParsedArgs {
      * refused by the password rules rather than by the parser.
      */
     password: string | undefined;
+    /**
+     * The email address `user add` was given, if any. `undefined` is a user with
+     * no address, which is the ordinary case: an email is optional on a user and
+     * only buys password recovery and the notices TASK-55 sends.
+     */
+    email: string | undefined;
+    /**
+     * Every other option that was given: {@link VALUE_FLAGS} as the text after
+     * them, {@link SWITCH_FLAGS} as `true`. Empty for a command that takes none.
+     */
+    flags: Readonly<Record<string, string | true>>;
     /**
      * Positional arguments after the command: the directory for `init`, the
-     * subcommand and its arguments for `user`. Flags are never in here.
+     * subcommand and its arguments for `user` and `import`. Flags are never in
+     * here.
      */
     args: readonly string[];
 }

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAK9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;OAGG;IACH,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAkCD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAiE7D;AASD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,aAAa,CAAC,CAyBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW3D;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7F;AA8KD,gEAAgE;AAChE,KAAK,aAAa,GAAG,MAAM,CAAC,cAAc,GAAG;IAC3C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CrF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,OAAO,GACjB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAyBjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;OAGG;IACH,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/C;;;;OAIG;IACH,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAmED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAsH7D;AASD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,aAAa,CAAC,CAyBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW3D;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7F;AAwhBD,gEAAgE;AAChE,KAAK,aAAa,GAAG,MAAM,CAAC,cAAc,GAAG;IAC3C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CrF"}