@bjornpagen/bumbledb-log 0.20.0 → 0.20.2

package/dist/store.js

@@ -0,0 +1,577 @@
+/**
+ * The object-store capability: exactly five verbs, outcomes as sums,
+ * infrastructure failures on the ErrStore channel. `fsStore` is tier-1,
+ * not a dev double — deployment case 5's production backend.
+ *
+ * The one on-disk protocol, shared with the Rust driver and pinned by
+ * the `lease/` corpus goldens: create-only publishes an exclusive
+ * synced temp (under the reserved `~tmp` namespace) with link(2), where
+ * EEXIST is the honest exists; the etag is the blake3 of the content,
+ * lowercase hex, computed on every read and never stored. The mutation
+ * lock is a fenced CAS lease: a versioned `LEASE/1` body whose identity
+ * is a monotonic token file `{root}/~lease/{key}/{n}`, with `~head`
+ * naming the current token. A contender mints the next token iff the
+ * current lease's own bytes are expired — expiry is the only break.
+ * Release rewrites the held token with an already-expired body so the
+ * next acquirer does not wait us out. `created` and `swapped` resolve
+ * only after fsync of the object file and its parent directory,
+ * including newly created ancestors. Stale temps are swept at open.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { internalBlake3 } from "@bjornpagen/bumbledb";
+import * as errors from "@superbuilders/errors";
+import { regex } from "arkregex";
+import { bytesEqual, toHex, U64_MAX } from "#bytes.ts";
+import { wrapStore } from "#errors.ts";
+import { LEASE_NAMESPACE, reservedLease, reservedTemp, TEMP_NAMESPACE } from "#keys.ts";
+function etag(raw) {
+    return raw;
+}
+/** Ceiling of the jittered wait between probes of an unexpired lease. */
+const LOCK_RETRY_MS = 10;
+/** How long a mutation lease stays current, in milliseconds. */
+const MUTATION_TTL_MS = 5_000;
+/** A live temp under `~tmp` exists only for write-then-link. Anything
+ *  older than this is crash litter the open sweep deletes. */
+const TEMP_STALE_MS = 30_000;
+/** `~head` is not a StoreKey. It names the current token so a
+ *  successor reads `{dir}/{n}` without listing. */
+const HEAD = "~head";
+function ourHolder() {
+    return BigInt(process.pid);
+}
+function contentEtag(bytes) {
+    return etag(toHex(new Uint8Array(internalBlake3(bytes))));
+}
+function codeOf(error) {
+    return error.code;
+}
+/** The lease body's magic first line. Version 1 of the one lock protocol. */
+const LEASE_MAGIC = "LEASE/1";
+function encodeLease(lease) {
+    return new TextEncoder().encode(`${LEASE_MAGIC}\n${lease.holder}\n${lease.token}\n${lease.expires}\n`);
+}
+const U64_DECIMAL = regex("^\\d+$");
+function u64Line(line) {
+    if (!U64_DECIMAL.test(line)) {
+        return null;
+    }
+    const value = BigInt(line);
+    if (value > U64_MAX) {
+        return null;
+    }
+    return value;
+}
+/** Lines as Rust `str::lines`: split on `\n`, one trailing terminator
+ *  unyielded, a trailing `\r` stripped per line. */
+function leaseLines(raw) {
+    const parts = raw.split("\n");
+    if (parts.length > 0 && parts[parts.length - 1] === "") {
+        parts.pop();
+    }
+    return parts.map((line) => (line.endsWith("\r") ? line.slice(0, -1) : line));
+}
+/** The `LEASE/1` body: magic line, then holder, token, expires as
+ *  decimal u64 lines, and nothing after. Anything else is not a lease
+ *  and never breakable. */
+function parseLease(raw) {
+    const lines = leaseLines(raw);
+    if (lines.length !== 4) {
+        return null;
+    }
+    const [magic, holderLine, tokenLine, expiresLine] = lines;
+    if (magic !== LEASE_MAGIC || holderLine === undefined || tokenLine === undefined || expiresLine === undefined) {
+        return null;
+    }
+    const holder = u64Line(holderLine);
+    const token = u64Line(tokenLine);
+    const expires = u64Line(expiresLine);
+    if (holder === null || token === null || expires === null) {
+        return null;
+    }
+    return { holder, token, expires };
+}
+/** Expiry of the lease's own bytes: the only break. */
+function leaseExpired(lease, nowMs) {
+    return lease.expires <= BigInt(nowMs);
+}
+function isUnproved(error) {
+    const code = codeOf(error);
+    return code === "EIO" || code === "EINTR" || code === "ETIMEDOUT" || code === "EAGAIN" || code === "EBUSY";
+}
+/** A temp or parent that vanished mid-link is not Exists and not Created. */
+function isVanished(error) {
+    return codeOf(error) === "ENOENT";
+}
+async function fsyncDir(dir) {
+    const handle = await fs.open(dir, "r");
+    const synced = await errors.try(handle.sync());
+    await handle.close();
+    if (synced.error) {
+        throw errors.wrap(synced.error, `fsync directory ${dir}`);
+    }
+}
+async function ensureParent(target, root) {
+    const dir = path.dirname(target);
+    const resolvedRoot = path.resolve(root);
+    const ancestors = [];
+    let cursor = dir;
+    while (cursor.startsWith(resolvedRoot) && cursor !== resolvedRoot) {
+        ancestors.push(cursor);
+        cursor = path.dirname(cursor);
+    }
+    const missing = [];
+    for (const ancestor of ancestors.reverse()) {
+        const st = await errors.try(fs.stat(ancestor));
+        if (st.error) {
+            if (codeOf(st.error) === "ENOENT") {
+                missing.push(ancestor);
+                continue;
+            }
+            throw st.error;
+        }
+    }
+    await fs.mkdir(dir, { recursive: true });
+    for (const created of missing) {
+        await fsyncDir(path.dirname(created));
+    }
+}
+let tempSeq = 0;
+/** Write `bytes` to a fresh `wx` temp under `{root}/~tmp` and fsync it.
+ *  The caller publishes the synced temp atomically. */
+async function syncedTemp(root, bytes) {
+    tempSeq += 1;
+    const temp = path.join(root, ...reservedTemp(process.pid, tempSeq).split("/"));
+    await fs.mkdir(path.dirname(temp), { recursive: true });
+    const handle = await fs.open(temp, "wx");
+    const written = await errors.try((async function writeAll() {
+        await handle.writeFile(bytes);
+        await handle.sync();
+    })());
+    await handle.close();
+    if (written.error) {
+        await fs.rm(temp, { force: true });
+        throw errors.wrap(written.error, `write temp for ${root}`);
+    }
+    return temp;
+}
+/** link(2) is the exclusivity primitive: rename replaces an existing
+ *  destination, so it cannot arbitrate create-only, while link fails
+ *  atomically with EEXIST across processes — exactly the
+ *  If-None-Match: * contract. */
+async function publishLink(temp, dest) {
+    const linked = await errors.try(fs.link(temp, dest));
+    if (linked.error === undefined) {
+        return "linked";
+    }
+    if (codeOf(linked.error) === "EEXIST") {
+        return "occupied";
+    }
+    throw linked.error;
+}
+/** The lease directory for `key`: `{root}/~lease/{key}`. */
+function leaseDir(root, key) {
+    return path.join(root, LEASE_NAMESPACE, ...key.split("/"));
+}
+function tokenPath(dir, token) {
+    return path.join(dir, String(token));
+}
+function headPath(dir) {
+    return path.join(dir, HEAD);
+}
+async function readHead(dir) {
+    const read = await errors.try(fs.readFile(headPath(dir), "utf8"));
+    if (read.error) {
+        if (codeOf(read.error) === "ENOENT") {
+            return null;
+        }
+        throw read.error;
+    }
+    const token = u64Line(read.data.trim());
+    if (token === null || token < 1n) {
+        return null;
+    }
+    return token;
+}
+async function writeHead(root, dir, token) {
+    const dest = headPath(dir);
+    const temp = await syncedTemp(root, new TextEncoder().encode(String(token)));
+    const replaced = await errors.try(fs.rename(temp, dest));
+    if (replaced.error) {
+        await fs.rm(temp, { force: true });
+        throw replaced.error;
+    }
+    await fsyncDir(dir);
+}
+/** Removes `{dir}/{1..=current-1}` after `~head` names `current`. */
+async function forgetPredecessors(dir, current) {
+    for (let token = current - 1n; token >= 1n; token -= 1n) {
+        await fs.rm(tokenPath(dir, token), { force: true });
+    }
+}
+function probeFrom(dir, start) {
+    return (async function probe() {
+        let best = null;
+        let token = start;
+        while (token <= U64_MAX) {
+            const read = await errors.try(fs.readFile(tokenPath(dir, token), "utf8"));
+            if (read.error) {
+                if (codeOf(read.error) === "ENOENT") {
+                    break;
+                }
+                token += 1n;
+                continue;
+            }
+            const lease = parseLease(read.data);
+            if (lease !== null) {
+                best = { token, lease };
+            }
+            token += 1n;
+        }
+        return best;
+    })();
+}
+/** The current lease is `{dir}/{n}` for the token `~head` names, or
+ *  the highest `{dir}/{n}` at or after that hint. A mint past a stale
+ *  head is still visible: the probe opens `n`, `n+1`, … until a gap. */
+async function currentLease(dir) {
+    const start = (await readHead(dir)) ?? 1n;
+    const found = await probeFrom(dir, start);
+    if (found === null && start > 1n) {
+        return await probeFrom(dir, 1n);
+    }
+    return found;
+}
+async function tryMint(root, dir, key, token, holder, ttlMs) {
+    await fs.mkdir(dir, { recursive: true });
+    const body = encodeLease({ holder, token, expires: BigInt(Date.now() + ttlMs) });
+    const dest = path.join(root, ...reservedLease(key, token).split("/"));
+    const temp = await syncedTemp(root, body);
+    const published = await errors.try(publishLink(temp, dest));
+    await fs.rm(temp, { force: true });
+    if (published.error) {
+        throw published.error;
+    }
+    if (published.data === "occupied") {
+        return false;
+    }
+    await fsyncDir(dir);
+    const headed = await errors.try(writeHead(root, dir, token));
+    if (headed.error === undefined) {
+        await forgetPredecessors(dir, token);
+    }
+    return true;
+}
+/** Acquire the fenced lease on `{root}/~lease/{key}`: mint the next
+ *  monotonic token iff the current lease's own bytes are expired.
+ *  `wait` sleeps out a live holder; `refuse` throws. */
+async function acquireFsLease(root, key, ttlMs, contend = "wait") {
+    const dir = leaseDir(root, key);
+    const holder = ourHolder();
+    for (;;) {
+        const current = await currentLease(dir);
+        if (current !== null && !leaseExpired(current.lease, Date.now())) {
+            if (contend === "refuse") {
+                throw errors.new("replica directory has an owner");
+            }
+            await new Promise(function later(resolve) {
+                setTimeout(resolve, Math.random() * LOCK_RETRY_MS);
+            });
+            continue;
+        }
+        const token = current === null ? 1n : current.token + 1n;
+        const minted = await tryMint(root, dir, key, token, holder, ttlMs);
+        if (!minted) {
+            continue;
+        }
+        return { root, dir, holder, token, path: tokenPath(dir, token) };
+    }
+}
+/** True iff this token is still the max — a stale holder lost the CAS
+ *  and must not publish. */
+async function stillCurrent(held) {
+    const current = await currentLease(held.dir);
+    return current !== null && current.token === held.token;
+}
+/** Release by rewriting the held token with an already-expired body so
+ *  the next acquirer does not wait us out. */
+async function releaseFsLease(held) {
+    const body = encodeLease({ holder: held.holder, token: held.token, expires: 0n });
+    const wrote = await errors.try(syncedTemp(held.root, body));
+    if (wrote.error) {
+        return;
+    }
+    const replaced = await errors.try(fs.rename(wrote.data, held.path));
+    if (replaced.error) {
+        await fs.rm(wrote.data, { force: true });
+        return;
+    }
+    const synced = await errors.try(fsyncDir(held.dir));
+    if (synced.error) {
+        return;
+    }
+}
+async function sweepStaleTemps(dir) {
+    const listed = await errors.try(fs.readdir(dir, { withFileTypes: true }));
+    if (listed.error) {
+        if (codeOf(listed.error) === "ENOENT") {
+            return;
+        }
+        throw listed.error;
+    }
+    const now = Date.now();
+    for (const entry of listed.data) {
+        if (!entry.isFile()) {
+            continue;
+        }
+        const full = path.join(dir, entry.name);
+        const st = await errors.try(fs.stat(full));
+        if (st.error) {
+            continue;
+        }
+        if (now - st.data.mtimeMs > TEMP_STALE_MS) {
+            await fs.rm(full, { force: true });
+        }
+    }
+}
+/** Sweep crash litter: stale temps under `~tmp`, and superseded tokens
+ *  directly under `~lease` once `~head` names the current one. */
+async function sweepReserved(root) {
+    await sweepStaleTemps(path.join(root, TEMP_NAMESPACE));
+    const dir = path.join(root, LEASE_NAMESPACE);
+    const current = await currentLease(dir);
+    if (current !== null) {
+        await forgetPredecessors(dir, current.token);
+    }
+}
+async function resolveAmbiguousCreate(store, key, attempted) {
+    const fetched = await store.get(key);
+    if (fetched === null) {
+        return { tag: "absent" };
+    }
+    if (bytesEqual(fetched.bytes, attempted)) {
+        return { tag: "landed", etag: fetched.etag };
+    }
+    return { tag: "lost", fetched };
+}
+async function resolveAmbiguousSwap(store, key, attempted) {
+    const fetched = await store.get(key);
+    if (fetched === null) {
+        return { tag: "absent" };
+    }
+    if (bytesEqual(fetched.bytes, attempted)) {
+        return { tag: "landed", etag: fetched.etag };
+    }
+    return { tag: "lost", fetched };
+}
+function cloneFetched(fetched) {
+    return { bytes: new Uint8Array(fetched.bytes), etag: fetched.etag };
+}
+/** The five verbs over one local directory. One machine is load-bearing. */
+function fsStore(root) {
+    const rootPath = path.resolve(root);
+    const swept = (async function open() {
+        await sweepReserved(rootPath);
+        await fs.mkdir(path.join(rootPath, TEMP_NAMESPACE), { recursive: true });
+        await fs.mkdir(path.join(rootPath, LEASE_NAMESPACE), { recursive: true });
+    })();
+    function objectPath(key) {
+        return path.join(rootPath, ...key.split("/"));
+    }
+    async function readFetched(target) {
+        const read = await errors.try(fs.readFile(target));
+        if (read.error) {
+            if (codeOf(read.error) === "ENOENT") {
+                return null;
+            }
+            throw read.error;
+        }
+        const bytes = new Uint8Array(read.data);
+        return { bytes, etag: contentEtag(bytes) };
+    }
+    async function withKeyLease(key, body) {
+        const held = await acquireFsLease(rootPath, key, MUTATION_TTL_MS);
+        const ran = await errors.try(body(held));
+        await releaseFsLease(held);
+        if (ran.error) {
+            throw ran.error;
+        }
+        return ran.data;
+    }
+    return {
+        async get(key) {
+            await swept;
+            const target = objectPath(key);
+            const read = await errors.try(readFetched(target));
+            if (read.error) {
+                throw wrapStore(read.error, `get ${key}`);
+            }
+            return read.data;
+        },
+        async getIfChanged(key, etag) {
+            await swept;
+            const target = objectPath(key);
+            const read = await errors.try(readFetched(target));
+            if (read.error) {
+                throw wrapStore(read.error, `getIfChanged ${key}`);
+            }
+            if (read.data === null) {
+                throw wrapStore(errors.new("poll target absent"), `getIfChanged ${key}`);
+            }
+            if (read.data.etag === etag) {
+                return { tag: "unchanged" };
+            }
+            return { tag: "changed", fetched: read.data };
+        },
+        async putCreate(key, bytes) {
+            await swept;
+            const target = objectPath(key);
+            const ran = await errors.try((async function createBody() {
+                return await withKeyLease(key, async function underLease(held) {
+                    if (!(await stillCurrent(held))) {
+                        return { tag: "ambiguous" };
+                    }
+                    await ensureParent(target, rootPath);
+                    const temp = await syncedTemp(rootPath, bytes);
+                    const published = await errors.try(publishLink(temp, target));
+                    await fs.rm(temp, { force: true });
+                    if (published.error) {
+                        if (isUnproved(published.error) || isVanished(published.error)) {
+                            return { tag: "ambiguous" };
+                        }
+                        throw published.error;
+                    }
+                    if (published.data === "occupied") {
+                        const st = await errors.try(fs.stat(target));
+                        if (st.error) {
+                            if (codeOf(st.error) === "ENOENT" || isUnproved(st.error)) {
+                                return { tag: "ambiguous" };
+                            }
+                            throw st.error;
+                        }
+                        if (st.data.isDirectory()) {
+                            throw errors.new("key path is a directory");
+                        }
+                        return { tag: "exists" };
+                    }
+                    const synced = await errors.try(fsyncDir(path.dirname(target)));
+                    if (synced.error) {
+                        return { tag: "ambiguous" };
+                    }
+                    return { tag: "created", etag: contentEtag(bytes) };
+                });
+            })());
+            if (ran.error) {
+                if (isUnproved(ran.error) || isVanished(ran.error)) {
+                    return { tag: "ambiguous" };
+                }
+                throw wrapStore(ran.error, `putCreate ${key}`);
+            }
+            return ran.data;
+        },
+        async putSwap(key, bytes, etag) {
+            await swept;
+            const target = objectPath(key);
+            const ran = await errors.try((async function swapBody() {
+                return await withKeyLease(key, async function underLease(held) {
+                    if (!(await stillCurrent(held))) {
+                        return { tag: "ambiguous" };
+                    }
+                    const current = await readFetched(target);
+                    if (current === null || current.etag !== etag) {
+                        return { tag: "moved" };
+                    }
+                    const temp = await syncedTemp(rootPath, bytes);
+                    const renamed = await errors.try(fs.rename(temp, target));
+                    if (renamed.error) {
+                        await fs.rm(temp, { force: true });
+                        if (isUnproved(renamed.error)) {
+                            return { tag: "ambiguous" };
+                        }
+                        throw renamed.error;
+                    }
+                    const synced = await errors.try(fsyncDir(path.dirname(target)));
+                    if (synced.error) {
+                        return { tag: "ambiguous" };
+                    }
+                    return { tag: "swapped", etag: contentEtag(bytes) };
+                });
+            })());
+            if (ran.error) {
+                if (isUnproved(ran.error)) {
+                    return { tag: "ambiguous" };
+                }
+                throw wrapStore(ran.error, `putSwap ${key}`);
+            }
+            return ran.data;
+        },
+        async delete(key) {
+            await swept;
+            const target = objectPath(key);
+            const ran = await errors.try((async function deleteBody() {
+                await withKeyLease(key, async function underLease(held) {
+                    if (!(await stillCurrent(held))) {
+                        return;
+                    }
+                    await fs.rm(target, { force: true });
+                    await fsyncDir(path.dirname(target));
+                });
+            })());
+            if (ran.error) {
+                throw wrapStore(ran.error, `delete ${key}`);
+            }
+        }
+    };
+}
+/**
+ * The five verbs over one in-process Map. Single-process only: tests
+ * and ephemeral dev inside this process, no persistence, no
+ * cross-process claim, no configuration. Third `Etag` producer beside
+ * `fsStore` and `s3Store`: blake3 of the content, `fsStore`'s mint,
+ * carried as the same opaque brand. Every read returns a fresh buffer.
+ */
+function memStore() {
+    const objects = new Map();
+    return {
+        async get(key) {
+            const current = objects.get(key);
+            return current === undefined ? null : cloneFetched(current);
+        },
+        async getIfChanged(key, etag) {
+            const current = objects.get(key);
+            if (current === undefined) {
+                throw wrapStore(errors.new("poll target absent"), `getIfChanged ${key}`);
+            }
+            if (current.etag === etag) {
+                return { tag: "unchanged" };
+            }
+            return { tag: "changed", fetched: cloneFetched(current) };
+        },
+        async putCreate(key, bytes) {
+            if (objects.has(key)) {
+                return { tag: "exists" };
+            }
+            const copy = new Uint8Array(bytes);
+            const tag = contentEtag(copy);
+            objects.set(key, { bytes: copy, etag: tag });
+            return { tag: "created", etag: tag };
+        },
+        async putSwap(key, bytes, etag) {
+            const current = objects.get(key);
+            if (current === undefined || current.etag !== etag) {
+                return { tag: "moved" };
+            }
+            const copy = new Uint8Array(bytes);
+            const tag = contentEtag(copy);
+            objects.set(key, { bytes: copy, etag: tag });
+            return { tag: "swapped", etag: tag };
+        },
+        async delete(key) {
+            objects.delete(key);
+        }
+    };
+}
+export { s3Store } from "#store-s3.ts";
+export { acquireFsLease, encodeLease, etag, fsStore, MUTATION_TTL_MS, memStore, parseLease, releaseFsLease, resolveAmbiguousCreate, resolveAmbiguousSwap, sweepStaleTemps, syncedTemp };
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tenants.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Per-tenant replicas (50, case 4): an LRU of replicas keyed by tenant
+ * id — a tenant is a prefix (`<root>/t/<tenant>`), eviction closes and
+ * deletes the local dir (the disposable law), and `t/_shared` is
+ * pinned. Braids shard within a tenant; tenants shard the world. A
+ * tenant id is one StoreKey segment. `get` returns a live handle whose
+ * refcount pins it against eviction for the duration of the borrow
+ * (findings 38, 71) — the pin outlives `get` and drops only on
+ * `release`; a disposed handle is a distinct type. One fenced lease
+ * owns each replica directory and is CAS-renewed while the slot is
+ * open, so a second live replica on that dir is unrepresentable
+ * (findings 39, 48).
+ */
+import type { Schema, SchemaRelations } from "@bjornpagen/bumbledb";
+import type { Replica } from "./replica.js";
+import type { ObjectStore } from "./store.js";
+interface OpenTenantsOptions<Rels extends SchemaRelations> {
+    readonly store: ObjectStore;
+    readonly root: string;
+    readonly dir: string;
+    readonly theory: Schema<Rels>;
+    /** 50's 400 MB gate: checkpoint + working set per instance. Advisory,
+     *  measured once at each tenant's open — a replica that grows after
+     *  admission is not re-weighed until it is evicted and re-opened. */
+    readonly budgetBytes?: number;
+    readonly maxOpen?: number;
+    /** Directory-lease TTL. Renewed at one-third this value while the
+     *  replica is open. Default 300_000. */
+    readonly dirLeaseMs?: number;
+}
+declare const liveHandleBrand: unique symbol;
+declare const disposedHandleBrand: unique symbol;
+type LiveHandle<Rels extends SchemaRelations> = Replica<Rels> & {
+    readonly [liveHandleBrand]: typeof liveHandleBrand;
+    /** Drop one borrow. LRU and `evict` become legal only when `refs`
+     *  reaches 0 — not when `get` returns. */
+    release(): void;
+};
+/** A handle whose replica is gone. Every verb is a compile-time
+ *  refusal — there is no replica field to call, so `waitFor` into a
+ *  disposed replica is a type error. */
+type DisposedHandle = {
+    readonly [disposedHandleBrand]: typeof disposedHandleBrand;
+};
+interface Tenants<Rels extends SchemaRelations> extends AsyncDisposable {
+    get(tenant: string): Promise<LiveHandle<Rels>>;
+    /** Evicts one tenant: closes the replica and deletes its directory.
+     *  `_shared` and a still-pinned borrow refuse by doing nothing. */
+    evict(tenant: string): Promise<DisposedHandle | null>;
+    /** Drop one `get` borrow for `tenant`. */
+    release(tenant: string): void;
+}
+declare function openTenants<Rels extends SchemaRelations>(options: OpenTenantsOptions<Rels>): Tenants<Rels>;
+export type { OpenTenantsOptions, Tenants };
+export { openTenants };
+//# sourceMappingURL=tenants.d.ts.map

package/dist/tenants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../src/tenants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAInE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,WAAW,CAAA;AAWrD,UAAU,kBAAkB,CAAC,IAAI,SAAS,eAAe;IACxD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7B;;yEAEqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;4CACwC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,QAAA,MAAM,eAAe,EAAE,OAAO,MAA6B,CAAA;AAC3D,QAAA,MAAM,mBAAmB,EAAE,OAAO,MAAiC,CAAA;AAEnE,KAAK,UAAU,CAAC,IAAI,SAAS,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG;IAC/D,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,OAAO,eAAe,CAAA;IAClD;8CAC0C;IAC1C,OAAO,IAAI,IAAI,CAAA;CACf,CAAA;AAED;;wCAEwC;AACxC,KAAK,cAAc,GAAG;IACrB,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,OAAO,mBAAmB,CAAA;CAC1D,CAAA;AAED,UAAU,OAAO,CAAC,IAAI,SAAS,eAAe,CAAE,SAAQ,eAAe;IACtE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9C;uEACmE;IACnE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACrD,0CAA0C;IAC1C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAwFD,iBAAS,WAAW,CAAC,IAAI,SAAS,eAAe,EAAE,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA0PnG;AAED,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,CAAA"}