@bsv/dpp-overlay-topics 0.4.0-beta.1

package/dist/engineStorage.js

@@ -0,0 +1,253 @@
+import { Utils } from '@bsv/sdk';
+function toOutput(stored, beef) {
+    const output = {
+        txid: stored.txid,
+        outputIndex: stored.outputIndex,
+        outputScript: Utils.toArray(stored.outputScript, 'base64'),
+        satoshis: stored.satoshis,
+        topic: stored.topic,
+        spent: stored.spent,
+        outputsConsumed: stored.outputsConsumed,
+        consumedBy: stored.consumedBy,
+    };
+    if (stored.blockHeight != null)
+        output.blockHeight = stored.blockHeight;
+    if (stored.score != null)
+        output.score = stored.score;
+    if (beef != null)
+        output.beef = Utils.toArray(beef, 'base64');
+    return output;
+}
+function fromOutput(output) {
+    const stored = {
+        txid: output.txid,
+        outputIndex: Number(output.outputIndex),
+        outputScript: Utils.toBase64(output.outputScript),
+        satoshis: Number(output.satoshis),
+        topic: output.topic,
+        spent: output.spent,
+        outputsConsumed: output.outputsConsumed ?? [],
+        consumedBy: output.consumedBy ?? [],
+    };
+    if (output.blockHeight != null)
+        stored.blockHeight = output.blockHeight;
+    if (output.score != null)
+        stored.score = output.score;
+    return stored;
+}
+const outpointKey = (txid, outputIndex, topic) => `${txid}.${outputIndex}.${topic}`;
+/** Engine storage in memory: for tests, local runs and the offline rehearsal. */
+export class InMemoryOverlayStorage {
+    outputs = new Map();
+    transactions = new Map();
+    applied = new Set();
+    interactions = new Map();
+    async insertOutput(utxo) {
+        const key = outpointKey(utxo.txid, Number(utxo.outputIndex), utxo.topic);
+        if (!this.outputs.has(key))
+            this.outputs.set(key, fromOutput(utxo));
+        if (utxo.beef != null && !this.transactions.has(utxo.txid)) {
+            this.transactions.set(utxo.txid, Utils.toBase64(utxo.beef));
+        }
+    }
+    async findOutput(txid, outputIndex, topic, spent, includeBEEF = false) {
+        for (const stored of this.outputs.values()) {
+            if (stored.txid !== txid || stored.outputIndex !== outputIndex)
+                continue;
+            if (topic != null && stored.topic !== topic)
+                continue;
+            if (spent != null && stored.spent !== spent)
+                continue;
+            return toOutput(stored, includeBEEF ? this.transactions.get(txid) : undefined);
+        }
+        return null;
+    }
+    async findOutputsByOutpoints(outpoints, includeBEEF = false) {
+        const wanted = new Set(outpoints.map((o) => `${o.txid}.${o.outputIndex}`));
+        const found = [];
+        for (const stored of this.outputs.values()) {
+            if (!wanted.has(`${stored.txid}.${stored.outputIndex}`))
+                continue;
+            found.push(toOutput(stored, includeBEEF ? this.transactions.get(stored.txid) : undefined));
+        }
+        return found;
+    }
+    async findOutputsForTransaction(txid, includeBEEF = false) {
+        const beef = includeBEEF ? this.transactions.get(txid) : undefined;
+        return [...this.outputs.values()]
+            .filter((stored) => stored.txid === txid)
+            .map((stored) => toOutput(stored, beef));
+    }
+    async findUTXOsForTopic(topic, since, limit, includeBEEF = false) {
+        let rows = [...this.outputs.values()].filter((stored) => stored.topic === topic && !stored.spent);
+        if (since != null && since > 0)
+            rows = rows.filter((stored) => (stored.score ?? 0) >= since);
+        rows.sort((a, b) => (a.score ?? 0) - (b.score ?? 0));
+        if (limit != null && limit > 0)
+            rows = rows.slice(0, limit);
+        return rows.map((stored) => toOutput(stored, includeBEEF ? this.transactions.get(stored.txid) : undefined));
+    }
+    async deleteOutput(txid, outputIndex, _topic) {
+        for (const [key, stored] of this.outputs) {
+            if (stored.txid === txid && stored.outputIndex === outputIndex)
+                this.outputs.delete(key);
+        }
+        const remaining = [...this.outputs.values()].some((stored) => stored.txid === txid);
+        if (!remaining)
+            this.transactions.delete(txid);
+    }
+    async markUTXOAsSpent(txid, outputIndex, topic) {
+        const stored = this.outputs.get(outpointKey(txid, outputIndex, topic));
+        if (stored != null)
+            stored.spent = true;
+    }
+    async markUTXOAsUnspent(txid, outputIndex, topic) {
+        const stored = this.outputs.get(outpointKey(txid, outputIndex, topic));
+        if (stored != null)
+            stored.spent = false;
+    }
+    async updateConsumedBy(txid, outputIndex, topic, consumedBy) {
+        const stored = this.outputs.get(outpointKey(txid, outputIndex, topic));
+        if (stored != null)
+            stored.consumedBy = consumedBy;
+    }
+    async updateTransactionBEEF(txid, beef) {
+        this.transactions.set(txid, Utils.toBase64(beef));
+    }
+    async updateOutputBlockHeight(txid, outputIndex, topic, blockHeight) {
+        const stored = this.outputs.get(outpointKey(txid, outputIndex, topic));
+        if (stored != null)
+            stored.blockHeight = blockHeight;
+    }
+    async insertAppliedTransaction(tx) {
+        this.applied.add(`${tx.txid}.${tx.topic}`);
+    }
+    async doesAppliedTransactionExist(tx) {
+        return this.applied.has(`${tx.txid}.${tx.topic}`);
+    }
+    async deleteAppliedTransaction(txid, topic) {
+        this.applied.delete(`${txid}.${topic}`);
+    }
+    async updateLastInteraction(host, topic, since) {
+        this.interactions.set(`${host}.${topic}`, since);
+    }
+    async getLastInteraction(host, topic) {
+        return this.interactions.get(`${host}.${topic}`) ?? 0;
+    }
+}
+/** Engine storage on MongoDB: the hosted deployment's persistence. */
+export class MongoOverlayStorage {
+    outputs;
+    transactions;
+    applied;
+    interactions;
+    constructor(db, prefix = 'overlay') {
+        this.outputs = db.collection(`${prefix}Outputs`);
+        this.transactions = db.collection(`${prefix}Transactions`);
+        this.applied = db.collection(`${prefix}AppliedTransactions`);
+        this.interactions = db.collection(`${prefix}Interactions`);
+    }
+    /** Call once at boot; index creation is not on any request path. */
+    async ensureIndexes() {
+        await this.outputs.createIndex({ txid: 1, outputIndex: 1, topic: 1 }, { unique: true, name: 'outpoint_topic' });
+        await this.outputs.createIndex({ txid: 1, outputIndex: 1 }, { name: 'outpoint' });
+        await this.outputs.createIndex({ topic: 1, spent: 1, score: 1 }, { name: 'topic_spent_score' });
+        await this.transactions.createIndex({ txid: 1 }, { unique: true, name: 'txid' });
+        await this.applied.createIndex({ txid: 1, topic: 1 }, { unique: true, name: 'applied' });
+        await this.interactions.createIndex({ host: 1, topic: 1 }, { unique: true, name: 'host_topic' });
+    }
+    async beefFor(txids) {
+        if (txids.length === 0)
+            return new Map();
+        const rows = await this.transactions.find({ txid: { $in: txids } }).toArray();
+        return new Map(rows.map((row) => [row.txid, row.beef]));
+    }
+    async insertOutput(utxo) {
+        const stored = fromOutput(utxo);
+        // $setOnInsert only: an output already admitted is never rewritten, which
+        // is what KnexStorage does with its existence check.
+        await this.outputs.updateOne({ txid: stored.txid, outputIndex: stored.outputIndex, topic: stored.topic }, { $setOnInsert: stored }, { upsert: true });
+        if (utxo.beef != null) {
+            await this.transactions.updateOne({ txid: stored.txid }, { $setOnInsert: { txid: stored.txid, beef: Utils.toBase64(utxo.beef) } }, { upsert: true });
+        }
+    }
+    async findOutput(txid, outputIndex, topic, spent, includeBEEF = false) {
+        const filter = { txid, outputIndex };
+        if (topic != null)
+            filter.topic = topic;
+        if (spent != null)
+            filter.spent = spent;
+        const stored = await this.outputs.findOne(filter);
+        if (stored == null)
+            return null;
+        const beef = includeBEEF ? (await this.beefFor([txid])).get(txid) : undefined;
+        return toOutput(stored, beef);
+    }
+    async findOutputsByOutpoints(outpoints, includeBEEF = false) {
+        if (outpoints.length === 0)
+            return [];
+        const stored = await this.outputs
+            .find({ $or: outpoints.map((o) => ({ txid: o.txid, outputIndex: o.outputIndex })) })
+            .toArray();
+        if (!includeBEEF)
+            return stored.map((row) => toOutput(row));
+        const beef = await this.beefFor([...new Set(stored.map((row) => row.txid))]);
+        return stored.map((row) => toOutput(row, beef.get(row.txid)));
+    }
+    async findOutputsForTransaction(txid, includeBEEF = false) {
+        const stored = await this.outputs.find({ txid }).toArray();
+        const beef = includeBEEF ? (await this.beefFor([txid])).get(txid) : undefined;
+        return stored.map((row) => toOutput(row, beef));
+    }
+    async findUTXOsForTopic(topic, since, limit, includeBEEF = false) {
+        const filter = { topic, spent: false };
+        if (since != null && since > 0)
+            filter.score = { $gte: since };
+        let cursor = this.outputs.find(filter).sort({ score: 1 });
+        if (limit != null && limit > 0)
+            cursor = cursor.limit(limit);
+        const stored = await cursor.toArray();
+        if (!includeBEEF)
+            return stored.map((row) => toOutput(row));
+        const beef = await this.beefFor([...new Set(stored.map((row) => row.txid))]);
+        return stored.map((row) => toOutput(row, beef.get(row.txid)));
+    }
+    async deleteOutput(txid, outputIndex, _topic) {
+        await this.outputs.deleteMany({ txid, outputIndex });
+        const remaining = await this.outputs.countDocuments({ txid }, { limit: 1 });
+        if (remaining === 0)
+            await this.transactions.deleteOne({ txid });
+    }
+    async markUTXOAsSpent(txid, outputIndex, topic) {
+        await this.outputs.updateOne({ txid, outputIndex, topic }, { $set: { spent: true } });
+    }
+    async markUTXOAsUnspent(txid, outputIndex, topic) {
+        await this.outputs.updateOne({ txid, outputIndex, topic }, { $set: { spent: false } });
+    }
+    async updateConsumedBy(txid, outputIndex, topic, consumedBy) {
+        await this.outputs.updateOne({ txid, outputIndex, topic }, { $set: { consumedBy } });
+    }
+    async updateTransactionBEEF(txid, beef) {
+        await this.transactions.updateOne({ txid }, { $set: { beef: Utils.toBase64(beef) } }, { upsert: true });
+    }
+    async updateOutputBlockHeight(txid, outputIndex, topic, blockHeight) {
+        await this.outputs.updateOne({ txid, outputIndex, topic }, { $set: { blockHeight } });
+    }
+    async insertAppliedTransaction(tx) {
+        await this.applied.updateOne({ txid: tx.txid, topic: tx.topic }, { $setOnInsert: { txid: tx.txid, topic: tx.topic } }, { upsert: true });
+    }
+    async doesAppliedTransactionExist(tx) {
+        return (await this.applied.countDocuments({ txid: tx.txid, topic: tx.topic }, { limit: 1 })) > 0;
+    }
+    async deleteAppliedTransaction(txid, topic) {
+        await this.applied.deleteOne({ txid, topic });
+    }
+    async updateLastInteraction(host, topic, since) {
+        await this.interactions.updateOne({ host, topic }, { $set: { since } }, { upsert: true });
+    }
+    async getLastInteraction(host, topic) {
+        const row = await this.interactions.findOne({ host, topic });
+        return row?.since ?? 0;
+    }
+}
+//# sourceMappingURL=engineStorage.js.map

package/dist/engineStorage.js.map

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

package/dist/evidenceExport.d.ts

@@ -0,0 +1,189 @@
+/**
+ * The evidence package export (`spec/portable-evidence.md` section 2,
+ * `contracts/evidence-package.schema.json`): everything this node holds about
+ * one passport, as content-addressed files under a manifest the node signs.
+ *
+ * What goes in, from this node's own stores and nothing fetched: every
+ * retained state's raw transaction under `transactions/`, the BEEF it is held
+ * in under `proofs/` (the merkle path and ancestors a verifier needs, once
+ * `/arc-ingest` has delivered the proof), the publisher policy chain under
+ * `authority/` when one is configured, the spend observations under `status/`
+ * and a verification report under `reports/`. The signature says this node
+ * assembled these bytes; it says nothing about their truth, which a reader
+ * establishes from the bytes and its own header source, and nothing about
+ * completeness beyond the snapshot the manifest names.
+ *
+ * Two routes build from the same pieces. `GET /evidence-package` is the
+ * bounded package: the newest states within the cap, the rest declared
+ * absent, complete for its snapshot only when the cap was not reached. `GET
+ * /evidence-export` is the complete export: parts over one snapshot, oldest
+ * first, each a package of its own over a contiguous sequence range bounded
+ * by states and by bytes, resumed by a cursor, tiling the snapshot so a
+ * reader joins them with `joinEvidenceExport` and knows whether it holds
+ * everything the snapshot held (`contracts/evidence-export.schema.json`).
+ *
+ * The archive form is this build's own, as the standard leaves it: a JSON
+ * envelope `{ manifest, files: { "<path>": "<base64>" } }`, so a browser or a
+ * script reads it without an archive library and the file map is exactly the
+ * one `inspectEvidencePackage` takes.
+ */
+import { type ChainTracker, type PrivateKey } from '@bsv/sdk';
+import type { Storage } from '@bsv/overlay';
+import { type EvidencePackageManifest, type PackageInspection } from '@bsv/dpp-core';
+import type { HistoryPaginator } from './history.js';
+import { type PublisherPolicyConfig } from './policyConfig.js';
+/** The archive form: the manifest beside every inventoried file, base64 by path. */
+export interface EvidencePackageEnvelope {
+    manifest: EvidencePackageManifest;
+    files: Record<string, string>;
+}
+export interface EvidenceExportRequest {
+    passportId: string;
+    paginator: HistoryPaginator;
+    engineStorage: Storage;
+    /** EXPORT_SIGNING_KEY; the manifest's signer is its public key. */
+    signingKey: PrivateKey;
+    publisherPolicy?: PublisherPolicyConfig;
+    serviceIdentityKey?: string;
+    ownerConsent?: boolean | {
+        authorities: string[];
+    };
+    /** The version 2 options the node admits under (CONTROL_AUTHORITIES, ACCEPTANCE_COMMITMENT). */
+    controlAuthorities?: string[];
+    managedAcceptance?: boolean;
+    chainTracker?: ChainTracker | 'scripts only';
+    /** The export instant, injected so a test can pin it. */
+    now: Date;
+    /** What the manifest names as the exporter's software. */
+    software: string;
+}
+/** The version of the complete export's wrapper, `contracts/evidence-export.schema.json`. */
+export declare const EVIDENCE_EXPORT_VERSION = "1";
+/**
+ * The coverage record of a part: every fact a reader uses to establish that
+ * the parts of an export tile a snapshot, signed by the exporter beside the
+ * package and bound to the exact signed manifest by its digest. A wrapper
+ * field outside this record (the cursor, the package bytes) establishes
+ * nothing about coverage; a reader that trusted an unsigned `final` or range
+ * could be handed a genuine first part dressed as a whole export.
+ */
+export interface ExportCoverage {
+    exportVersion: typeof EVIDENCE_EXPORT_VERSION;
+    passportId: string;
+    snapshot: {
+        source: string;
+        id: string;
+        sequence: number;
+    };
+    part: {
+        index: number;
+        sequenceRange: {
+            from: number;
+            to: number;
+        };
+        states: number;
+    };
+    final: boolean;
+    /** SHA-256 of the canonical JSON of the part's signed package manifest, signature value included. */
+    manifestSha256: string;
+    signature: {
+        suite: 'bsv-ecdsa-der';
+        signer: string;
+    };
+}
+/** One part of the complete export, as the wire carries it: the signed coverage record, the cursor and the package. */
+export interface EvidenceExportPart extends Omit<ExportCoverage, 'signature'> {
+    nextCursor: string | null;
+    signature: {
+        suite: 'bsv-ecdsa-der';
+        signer: string;
+        value: string;
+    };
+    package: EvidencePackageEnvelope;
+}
+/** The digest the coverage record binds the package by: the manifest exactly as signed, canonical JSON, signature value included. */
+export declare function exportManifestDigest(manifest: EvidencePackageManifest): string;
+/** The coverage record a part carries: the wrapper without its cursor, its package and the signature value. */
+export declare function exportCoverageOf(part: Omit<EvidenceExportPart, 'nextCursor' | 'package'> | EvidenceExportPart): ExportCoverage;
+/** The bytes the exporter signs for a part: the coverage record in canonical JSON, UTF-8, exactly as the manifest's own preimage rule; ECDSA then runs over their SHA-256. */
+export declare function exportCoveragePreimage(part: Omit<EvidenceExportPart, 'nextCursor' | 'package'> | EvidenceExportPart): number[];
+/** The scope sentence a part's manifest carries, rendered from the coverage record so the signed manifest and the signed coverage say one thing. */
+export declare function exportScopeText(passportId: string, snapshotId: string, index: number, from: number, to: number, final: boolean): string;
+export interface ExportPartInspection {
+    /** The coverage signature verifies under the record's signer, or null when the record has no canonical form. */
+    coverageAuthentic: boolean | null;
+    /** The package manifest hashes to the digest the coverage record names, and its own signed declarations agree with the record. */
+    manifestBound: boolean;
+    /** The package on its three questions, as `inspectEvidencePackage` answers them. */
+    package: PackageInspection;
+    failures: string[];
+}
+/**
+ * Inspect one part: the coverage signature, the binding of the package to
+ * the record, the agreement of the signed manifest with the record, and the
+ * package itself. Only a part whose coverage is authentic and bound may say
+ * anything about what an export covers.
+ */
+export declare function inspectEvidenceExportPart(part: EvidenceExportPart, options?: {
+    expectedPassportId?: string;
+    expectedSigner?: string;
+}): ExportPartInspection;
+export interface EvidencePartRequest extends Omit<EvidenceExportRequest, 'chainTracker' | 'ownerConsent' | 'controlAuthorities' | 'managedAcceptance'> {
+    /** The nextCursor of the previous part; absent or empty for the first. */
+    cursor?: string | null;
+    /** The bounds of one part; the limits module's numbers unless a test narrows them. */
+    maxStates?: number;
+    maxBytes?: number;
+}
+/** The tiers this node never holds, named as the disclosure scopes name them (`spec/record-model.md` section 7). */
+export declare const WITHHELD_TIERS: string[];
+/**
+ * Build the bounded package, or return undefined when this node holds
+ * nothing for the passport, which the route answers as 404 rather than as an
+ * empty package claiming completeness over nothing.
+ */
+export declare function buildEvidencePackage(request: EvidenceExportRequest): Promise<EvidencePackageEnvelope | undefined>;
+/**
+ * Build one part of the complete export: the first when no cursor is given,
+ * which pins the snapshot, or the part the cursor names over the snapshot it
+ * carries. Returns undefined when this node holds nothing for the passport
+ * in the snapshot. A cursor of the wrong kind, for another passport, from
+ * another process or older than the TTL throws the paginator's named
+ * refusal, which the route answers as it answers a history cursor.
+ */
+export declare function buildEvidenceExportPart(request: EvidencePartRequest): Promise<EvidenceExportPart | undefined>;
+/** The envelope's file map as `inspectEvidencePackage` takes it. */
+export declare function envelopeFiles(envelope: EvidencePackageEnvelope): Map<string, number[]>;
+export interface JoinedEvidenceExport {
+    passportId?: string;
+    snapshotId?: string;
+    /** True only when every part of the snapshot is present, in order, tiling its range, each package inspecting clean, and the final part is last. */
+    complete: boolean;
+    problems: string[];
+    manifests: EvidencePackageManifest[];
+    /** Every inventoried file across the parts, by path; a path repeated across parts is admitted only with identical bytes. */
+    files: Map<string, number[]>;
+    /** The absences every part declared, by reference. */
+    absent: string[];
+}
+/**
+ * Join the parts of one complete export as a reader does. First each part on
+ * its own: the coverage signature under the exporter's key, the binding of
+ * the package to the record by digest, the agreement of the signed manifest
+ * with the record, and the package on its three questions. Only a part that
+ * passes all of that says anything about coverage; then, across the parts
+ * that do: the same passport, the same snapshot, the same exporter, indexes
+ * 1 to n with no repeat, ranges that tile the snapshot from 1 to its
+ * sequence with no gap and no overlap, and the signed final flag on the last
+ * part alone, ending at the snapshot's sequence. Anything else is a problem
+ * by sentence and `complete` is false. The join establishes what the
+ * exporter asserted it held at that snapshot and that every part of that
+ * assertion arrived; a reader still verifies every transaction, proof and
+ * signature inside, and no signature proves the exporter held everything
+ * that exists elsewhere.
+ */
+export declare function joinEvidenceExport(parts: EvidenceExportPart[], options?: {
+    expectedPassportId?: string;
+    expectedSigner?: string;
+}): JoinedEvidenceExport;
+//# sourceMappingURL=evidenceExport.d.ts.map

package/dist/evidenceExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidenceExport.d.ts","sourceRoot":"","sources":["../src/evidenceExport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAkD,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAC7G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAaL,KAAK,uBAAuB,EAG5B,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,cAAc,CAAA;AAE9D,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAG5E,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,mEAAmE;IACnE,UAAU,EAAE,UAAU,CAAA;IACtB,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,YAAY,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAClD,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAAA;IAC5C,yDAAyD;IACzD,GAAG,EAAE,IAAI,CAAA;IACT,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,6FAA6F;AAC7F,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,uBAAuB,CAAA;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACpF,KAAK,EAAE,OAAO,CAAA;IACd,qGAAqG;IACrG,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACtD;AAED,uHAAuH;AACvH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACpE,OAAO,EAAE,uBAAuB,CAAA;CACjC;AAED,qIAAqI;AACrI,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAE9E;AAED,+GAA+G;AAC/G,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,SAAS,CAAC,GAAG,kBAAkB,GAAG,cAAc,CAU9H;AAED,8KAA8K;AAC9K,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,SAAS,CAAC,GAAG,kBAAkB,GAAG,MAAM,EAAE,CAE9H;AAED,oJAAoJ;AACpJ,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvI;AAED,MAAM,WAAW,oBAAoB;IACnC,gHAAgH;IAChH,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAA;IACjC,kIAAkI;IAClI,aAAa,EAAE,OAAO,CAAA;IACtB,oFAAoF;IACpF,OAAO,EAAE,iBAAiB,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,oBAAoB,CA6ChK;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,cAAc,GAAG,cAAc,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;IACpJ,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD,oHAAoH;AACpH,eAAO,MAAM,cAAc,UAI1B,CAAA;AAkGD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAqGvH;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA4FnH;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAEtF;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mJAAmJ;IACnJ,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,uBAAuB,EAAE,CAAA;IACpC,4HAA4H;IAC5H,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5B,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,oBAAoB,CAqD5J"}