@hashtree/nostr 0.1.3 → 0.1.5

package/README.md

@@ -22,10 +22,20 @@ const store = new WebRTCStore({
   decrypt,
   localStore,
   relays: ['wss://relay.example.com'],
+  requestSelectionStrategy: 'titForTat',
+  requestFairnessEnabled: true,
+  requestDispatch: {
+    initialFanout: 2,
+    hedgeFanout: 1,
+    maxFanout: 8,
+    hedgeIntervalMs: 120,
+  },
 });
 
 await store.start();
+await store.loadPeerMetadata(); // optional warm start
 const data = await store.get(hash);
+await store.persistPeerMetadata(); // optional shutdown/save step
 ```
 
 ## Nostr Ref Resolver
@@ -72,6 +82,47 @@ const resolver = createNostrRefResolver({
 const root = await resolver.resolve('npub1.../myfiles');
 ```
 
+## Signed Tree Snapshots
+
+For immutable permalinks, store a copy of the signed kind `30078` root event as a plain hashtree blob. The snapshot gives you one signed root even when relays do not answer, and you can still watch for newer events later.
+
+```typescript
+import {
+  storeTreeEventSnapshot,
+  readTreeEventSnapshot,
+  fetchLatestTreeEventSnapshot,
+  watchLatestTreeEventSnapshot,
+} from '@hashtree/nostr';
+import { HashTree } from '@hashtree/core';
+
+const hashTree = new HashTree({ store });
+
+const snapshot = await storeTreeEventSnapshot(hashTree, nip19, signedRootEvent);
+const sameSnapshot = snapshot
+  ? await readTreeEventSnapshot(hashTree, nip19, snapshot.snapshotCid)
+  : null;
+
+const latest = await fetchLatestTreeEventSnapshot(
+  { snapshotTarget: hashTree, nip19, fetchEvents },
+  'npub1...owner',
+  'videos/demo',
+);
+
+const stop = watchLatestTreeEventSnapshot(
+  { snapshotTarget: hashTree, nip19, fetchEvents, subscribeEvents },
+  'npub1...owner',
+  'videos/demo',
+  (nextSnapshot) => {
+    console.log(nextSnapshot.snapshotNhash, nextSnapshot.rootCid);
+  },
+);
+
+// later
+stop();
+```
+
+The library does not keep a global snapshot cache for you. It provides stateless helpers plus a live watcher; route caching and reuse policy stay with the app. Pass a `HashTree` when you already have one controlling write policy, or a raw `Store` when the default wrapper is enough.
+
 ## License
 
 MIT

package/dist/events.d.ts

@@ -0,0 +1,66 @@
+import { type CID, type Store } from '@hashtree/core';
+export interface StoredNostrEvent {
+    id: string;
+    pubkey: string;
+    created_at: number;
+    kind: number;
+    tags: string[][];
+    content: string;
+    sig: string;
+}
+export interface NostrEventManifest {
+    byId: CID | null;
+    byAuthorTime: CID | null;
+    byAuthorKindTime: CID | null;
+    byKindTime: CID | null;
+    byTime: CID | null;
+    byTag: CID | null;
+    replaceable: CID | null;
+    parameterizedReplaceable: CID | null;
+}
+export interface ListEventsOptions {
+    limit?: number;
+    since?: number;
+    until?: number;
+}
+export declare class NostrEventStore {
+    private readonly tree;
+    private readonly index;
+    constructor(store: Store);
+    encodeEvent(event: StoredNostrEvent): Uint8Array;
+    decodeEvent(data: Uint8Array): StoredNostrEvent;
+    add(root: CID | null, event: StoredNostrEvent): Promise<CID>;
+    build(root: CID | null, events: StoredNostrEvent[]): Promise<CID | null>;
+    getById(root: CID | null, eventId: string): Promise<StoredNostrEvent | null>;
+    listByAuthor(root: CID | null, pubkey: string, options?: ListEventsOptions): Promise<StoredNostrEvent[]>;
+    listByAuthorAndKind(root: CID | null, pubkey: string, kind: number, options?: ListEventsOptions): Promise<StoredNostrEvent[]>;
+    getReplaceable(root: CID | null, pubkey: string, kind: number): Promise<StoredNostrEvent | null>;
+    listRecent(root: CID | null, options?: ListEventsOptions): Promise<StoredNostrEvent[]>;
+    listByTag(root: CID | null, tagName: string, tagValue: string, options?: ListEventsOptions): Promise<StoredNostrEvent[]>;
+    getParameterizedReplaceable(root: CID | null, pubkey: string, kind: number, dTag: string): Promise<StoredNostrEvent | null>;
+    getManifest(root: CID | null): Promise<NostrEventManifest>;
+    listByKind(root: CID | null, kind: number, options?: ListEventsOptions): Promise<StoredNostrEvent[]>;
+    private collectEvents;
+    private readStoredEvent;
+    private upsertWinner;
+    private writeManifest;
+    private authorTimeKey;
+    private authorKindTimeKey;
+    private kindTimeKey;
+    private timeKey;
+    private createdAtFromIndexKey;
+    private tagKeys;
+    private tagPrefix;
+    private normalizeTagName;
+    private normalizeTagValue;
+    private replaceableKey;
+    private parameterizedReplaceableKey;
+    private validateEventShape;
+    private validateEvent;
+    private validateHex64;
+    private validateHex128;
+    private validateCreatedAt;
+    private validateKind;
+    private validateContent;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,426 @@
+import { decode, encode } from '@msgpack/msgpack';
+import { HashTree, LinkType, toHex, sha256 } from '@hashtree/core';
+import { BTree } from '@hashtree/index';
+const EVENT_ENVELOPE_VERSION = 1;
+const MAX_U64 = (1n << 64n) - 1n;
+const HEX_64 = /^[0-9a-f]{64}$/;
+const HEX_128 = /^[0-9a-f]{128}$/;
+const MANIFEST_BY_ID = 'by-id';
+const MANIFEST_BY_AUTHOR_TIME = 'by-author-time';
+const MANIFEST_BY_AUTHOR_KIND_TIME = 'by-author-kind-time';
+const MANIFEST_BY_KIND_TIME = 'by-kind-time';
+const MANIFEST_BY_TIME = 'by-time';
+const MANIFEST_BY_TAG = 'by-tag';
+const MANIFEST_REPLACEABLE = 'replaceable';
+const MANIFEST_PARAMETERIZED_REPLACEABLE = 'parameterized-replaceable';
+function canonicalEventIdPayload(event) {
+    return JSON.stringify([0, event.pubkey, event.created_at, event.kind, event.tags, event.content]);
+}
+async function computeCanonicalEventId(event) {
+    const payload = canonicalEventIdPayload(event);
+    return toHex(await sha256(new TextEncoder().encode(payload)));
+}
+function padKind(kind) {
+    return kind.toString(16).padStart(8, '0');
+}
+function reverseTimestamp(createdAt) {
+    return (MAX_U64 - BigInt(createdAt)).toString(16).padStart(16, '0');
+}
+function isReplaceableKind(kind) {
+    return kind === 0 || kind === 3 || (kind >= 10_000 && kind < 20_000);
+}
+function isParameterizedReplaceableKind(kind) {
+    return kind >= 30_000 && kind < 40_000;
+}
+function getDTag(event) {
+    for (const tag of event.tags) {
+        if (tag[0] === 'd' && typeof tag[1] === 'string' && tag[1].length > 0) {
+            return tag[1];
+        }
+    }
+    return null;
+}
+function compareEvents(a, b) {
+    if (a.created_at !== b.created_at) {
+        return a.created_at - b.created_at;
+    }
+    return a.id.localeCompare(b.id);
+}
+function assertStringArray(tags) {
+    if (!Array.isArray(tags)) {
+        throw new Error('Nostr event tags must be an array');
+    }
+    for (const tag of tags) {
+        if (!Array.isArray(tag) || tag.some(value => typeof value !== 'string')) {
+            throw new Error('Nostr event tags must be an array of string arrays');
+        }
+    }
+}
+export class NostrEventStore {
+    tree;
+    index;
+    constructor(store) {
+        this.tree = new HashTree({ store });
+        this.index = new BTree(store);
+    }
+    encodeEvent(event) {
+        const normalized = this.validateEventShape(event);
+        return encode([
+            EVENT_ENVELOPE_VERSION,
+            normalized.id,
+            normalized.pubkey,
+            normalized.created_at,
+            normalized.kind,
+            normalized.tags,
+            normalized.content,
+            normalized.sig,
+        ]);
+    }
+    decodeEvent(data) {
+        const decoded = decode(data);
+        if (!Array.isArray(decoded) || decoded.length !== 8) {
+            throw new Error('Invalid Nostr event envelope');
+        }
+        const [version, id, pubkey, createdAt, kind, tags, content, sig,] = decoded;
+        if (version !== EVENT_ENVELOPE_VERSION) {
+            throw new Error(`Unsupported Nostr event envelope version: ${String(version)}`);
+        }
+        if (typeof id !== 'string' || typeof pubkey !== 'string' || typeof content !== 'string' || typeof sig !== 'string') {
+            throw new Error('Invalid Nostr event envelope fields');
+        }
+        if (typeof createdAt !== 'number' || !Number.isInteger(createdAt) || createdAt < 0) {
+            throw new Error('Invalid Nostr event created_at');
+        }
+        if (typeof kind !== 'number' || !Number.isInteger(kind) || kind < 0) {
+            throw new Error('Invalid Nostr event kind');
+        }
+        assertStringArray(tags);
+        return this.validateEventShape({
+            id,
+            pubkey,
+            created_at: createdAt,
+            kind,
+            tags,
+            content,
+            sig,
+        });
+    }
+    async add(root, event) {
+        const normalized = await this.validateEvent(event);
+        const manifest = await this.getManifest(root);
+        const eventBytes = this.encodeEvent(normalized);
+        const { cid: eventCid } = await this.tree.putFile(eventBytes);
+        const nextManifest = {
+            byId: await this.index.insertLink(manifest.byId, normalized.id, eventCid),
+            byAuthorTime: await this.index.insertLink(manifest.byAuthorTime, this.authorTimeKey(normalized), eventCid),
+            byAuthorKindTime: await this.index.insertLink(manifest.byAuthorKindTime, this.authorKindTimeKey(normalized), eventCid),
+            byKindTime: await this.index.insertLink(manifest.byKindTime, this.kindTimeKey(normalized), eventCid),
+            byTime: await this.index.insertLink(manifest.byTime, this.timeKey(normalized), eventCid),
+            byTag: manifest.byTag,
+            replaceable: manifest.replaceable,
+            parameterizedReplaceable: manifest.parameterizedReplaceable,
+        };
+        for (const tagKey of this.tagKeys(normalized)) {
+            nextManifest.byTag = await this.index.insertLink(nextManifest.byTag, tagKey, eventCid);
+        }
+        if (isReplaceableKind(normalized.kind)) {
+            nextManifest.replaceable = await this.upsertWinner(manifest.replaceable, this.replaceableKey(normalized.pubkey, normalized.kind), normalized, eventCid);
+        }
+        if (isParameterizedReplaceableKind(normalized.kind)) {
+            const dTag = getDTag(normalized);
+            if (dTag) {
+                nextManifest.parameterizedReplaceable = await this.upsertWinner(manifest.parameterizedReplaceable, this.parameterizedReplaceableKey(normalized.pubkey, normalized.kind, dTag), normalized, eventCid);
+            }
+        }
+        const manifestRoot = await this.writeManifest(nextManifest);
+        if (!manifestRoot) {
+            throw new Error('Failed to create Nostr event manifest');
+        }
+        return manifestRoot;
+    }
+    async build(root, events) {
+        const normalized = await Promise.all(events.map(event => this.validateEvent(event)));
+        normalized.sort(compareEvents);
+        let current = root;
+        for (const event of normalized) {
+            current = await this.add(current, event);
+        }
+        return current;
+    }
+    async getById(root, eventId) {
+        if (!HEX_64.test(eventId)) {
+            throw new Error('Event id must be a lowercase 64-character hex string');
+        }
+        const manifest = await this.getManifest(root);
+        if (!manifest.byId) {
+            return null;
+        }
+        const eventCid = await this.index.getLink(manifest.byId, eventId);
+        if (!eventCid) {
+            return null;
+        }
+        return this.readStoredEvent(eventCid);
+    }
+    async listByAuthor(root, pubkey, options = {}) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.byAuthorTime) {
+            return [];
+        }
+        return this.collectEvents(manifest.byAuthorTime, `${this.validateHex64(pubkey, 'pubkey')}:`, options);
+    }
+    async listByAuthorAndKind(root, pubkey, kind, options = {}) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.byAuthorKindTime) {
+            return [];
+        }
+        return this.collectEvents(manifest.byAuthorKindTime, `${this.validateHex64(pubkey, 'pubkey')}:${padKind(this.validateKind(kind))}:`, options);
+    }
+    async getReplaceable(root, pubkey, kind) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.replaceable) {
+            return null;
+        }
+        const eventCid = await this.index.getLink(manifest.replaceable, this.replaceableKey(this.validateHex64(pubkey, 'pubkey'), this.validateKind(kind)));
+        return eventCid ? this.readStoredEvent(eventCid) : null;
+    }
+    async listRecent(root, options = {}) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.byTime) {
+            return [];
+        }
+        return this.collectEvents(manifest.byTime, '', options);
+    }
+    async listByTag(root, tagName, tagValue, options = {}) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.byTag) {
+            return [];
+        }
+        return this.collectEvents(manifest.byTag, this.tagPrefix(tagName, tagValue), options);
+    }
+    async getParameterizedReplaceable(root, pubkey, kind, dTag) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.parameterizedReplaceable) {
+            return null;
+        }
+        if (dTag.length === 0) {
+            throw new Error('Parameterized replaceable events require a non-empty d tag');
+        }
+        const eventCid = await this.index.getLink(manifest.parameterizedReplaceable, this.parameterizedReplaceableKey(this.validateHex64(pubkey, 'pubkey'), this.validateKind(kind), dTag));
+        return eventCid ? this.readStoredEvent(eventCid) : null;
+    }
+    async getManifest(root) {
+        if (!root) {
+            return {
+                byId: null,
+                byAuthorTime: null,
+                byAuthorKindTime: null,
+                byKindTime: null,
+                byTime: null,
+                byTag: null,
+                replaceable: null,
+                parameterizedReplaceable: null,
+            };
+        }
+        const entries = await this.tree.listDirectory(root);
+        const getCid = (name) => entries.find(entry => entry.name === name)?.cid ?? null;
+        return {
+            byId: getCid(MANIFEST_BY_ID),
+            byAuthorTime: getCid(MANIFEST_BY_AUTHOR_TIME),
+            byAuthorKindTime: getCid(MANIFEST_BY_AUTHOR_KIND_TIME),
+            byKindTime: getCid(MANIFEST_BY_KIND_TIME),
+            byTime: getCid(MANIFEST_BY_TIME),
+            byTag: getCid(MANIFEST_BY_TAG),
+            replaceable: getCid(MANIFEST_REPLACEABLE),
+            parameterizedReplaceable: getCid(MANIFEST_PARAMETERIZED_REPLACEABLE),
+        };
+    }
+    async listByKind(root, kind, options = {}) {
+        const manifest = await this.getManifest(root);
+        if (!manifest.byKindTime) {
+            return [];
+        }
+        return this.collectEvents(manifest.byKindTime, `${padKind(this.validateKind(kind))}:`, options);
+    }
+    async collectEvents(root, prefix, options = {}) {
+        const events = [];
+        const entries = prefix.length === 0
+            ? this.index.linksEntries(root)
+            : this.index.prefixLinks(root, prefix);
+        for await (const [key, eventCid] of entries) {
+            const createdAt = this.createdAtFromIndexKey(key);
+            if (options.until !== undefined && createdAt > options.until) {
+                continue;
+            }
+            if (options.since !== undefined && createdAt < options.since) {
+                break;
+            }
+            events.push(await this.readStoredEvent(eventCid));
+            if (options.limit !== undefined && events.length >= options.limit) {
+                break;
+            }
+        }
+        return events;
+    }
+    async readStoredEvent(eventCid) {
+        const data = await this.tree.readFile(eventCid);
+        if (!data) {
+            throw new Error('Stored Nostr event blob is missing');
+        }
+        return this.decodeEvent(data);
+    }
+    async upsertWinner(root, key, event, eventCid) {
+        const existingCid = root ? await this.index.getLink(root, key) : null;
+        if (!existingCid) {
+            return this.index.insertLink(root, key, eventCid);
+        }
+        const existingEvent = await this.readStoredEvent(existingCid);
+        if (compareEvents(event, existingEvent) > 0) {
+            return this.index.insertLink(root, key, eventCid);
+        }
+        return root;
+    }
+    async writeManifest(manifest) {
+        const entries = [];
+        if (manifest.byId) {
+            entries.push({ name: MANIFEST_BY_ID, cid: manifest.byId, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.byAuthorTime) {
+            entries.push({ name: MANIFEST_BY_AUTHOR_TIME, cid: manifest.byAuthorTime, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.byAuthorKindTime) {
+            entries.push({ name: MANIFEST_BY_AUTHOR_KIND_TIME, cid: manifest.byAuthorKindTime, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.byKindTime) {
+            entries.push({ name: MANIFEST_BY_KIND_TIME, cid: manifest.byKindTime, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.byTime) {
+            entries.push({ name: MANIFEST_BY_TIME, cid: manifest.byTime, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.byTag) {
+            entries.push({ name: MANIFEST_BY_TAG, cid: manifest.byTag, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.replaceable) {
+            entries.push({ name: MANIFEST_REPLACEABLE, cid: manifest.replaceable, size: 0, type: LinkType.Dir });
+        }
+        if (manifest.parameterizedReplaceable) {
+            entries.push({
+                name: MANIFEST_PARAMETERIZED_REPLACEABLE,
+                cid: manifest.parameterizedReplaceable,
+                size: 0,
+                type: LinkType.Dir,
+            });
+        }
+        if (entries.length === 0) {
+            return null;
+        }
+        const { cid } = await this.tree.putDirectory(entries);
+        return cid;
+    }
+    authorTimeKey(event) {
+        return `${event.pubkey}:${reverseTimestamp(event.created_at)}:${event.id}`;
+    }
+    authorKindTimeKey(event) {
+        return `${event.pubkey}:${padKind(event.kind)}:${reverseTimestamp(event.created_at)}:${event.id}`;
+    }
+    kindTimeKey(event) {
+        return `${padKind(event.kind)}:${reverseTimestamp(event.created_at)}:${event.id}`;
+    }
+    timeKey(event) {
+        return `${reverseTimestamp(event.created_at)}:${event.id}`;
+    }
+    createdAtFromIndexKey(key) {
+        const parts = key.split(':');
+        if (parts.length < 2) {
+            throw new Error(`Invalid Nostr index key: ${key}`);
+        }
+        const reversed = parts[parts.length - 2];
+        const reversedTimestamp = BigInt(`0x${reversed}`);
+        const createdAt = MAX_U64 - reversedTimestamp;
+        if (createdAt > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new Error(`Created_at exceeds safe integer range in Nostr index key: ${key}`);
+        }
+        return Number(createdAt);
+    }
+    tagKeys(event) {
+        return event.tags.flatMap((tag) => {
+            const [name, value] = tag;
+            if (!name || !value) {
+                return [];
+            }
+            const normalizedName = name.toLowerCase();
+            const normalizedValue = this.normalizeTagValue(normalizedName, value);
+            return [`${normalizedName}:${normalizedValue}:${reverseTimestamp(event.created_at)}:${event.id}`];
+        });
+    }
+    tagPrefix(tagName, tagValue) {
+        const normalizedName = this.normalizeTagName(tagName);
+        return `${normalizedName}:${this.normalizeTagValue(normalizedName, tagValue)}:`;
+    }
+    normalizeTagName(tagName) {
+        if (tagName.length === 0) {
+            throw new Error('tag name must be non-empty');
+        }
+        return tagName.toLowerCase();
+    }
+    normalizeTagValue(tagName, tagValue) {
+        return tagName === 't' ? tagValue.toLowerCase() : tagValue;
+    }
+    replaceableKey(pubkey, kind) {
+        return `${pubkey}:${padKind(kind)}`;
+    }
+    parameterizedReplaceableKey(pubkey, kind, dTag) {
+        return `${pubkey}:${padKind(kind)}:${dTag}`;
+    }
+    validateEventShape(event) {
+        const normalized = {
+            id: this.validateHex64(event.id, 'event id'),
+            pubkey: this.validateHex64(event.pubkey, 'pubkey'),
+            created_at: this.validateCreatedAt(event.created_at),
+            kind: this.validateKind(event.kind),
+            tags: event.tags,
+            content: this.validateContent(event.content),
+            sig: this.validateHex128(event.sig, 'signature'),
+        };
+        assertStringArray(normalized.tags);
+        return normalized;
+    }
+    async validateEvent(event) {
+        const normalized = this.validateEventShape(event);
+        const computedId = await computeCanonicalEventId(normalized);
+        if (computedId !== normalized.id) {
+            throw new Error(`Event id mismatch: expected ${computedId}, got ${normalized.id}`);
+        }
+        return normalized;
+    }
+    validateHex64(value, label) {
+        if (!HEX_64.test(value)) {
+            throw new Error(`${label} must be a lowercase 64-character hex string`);
+        }
+        return value;
+    }
+    validateHex128(value, label) {
+        if (!HEX_128.test(value)) {
+            throw new Error(`${label} must be a lowercase 128-character hex string`);
+        }
+        return value;
+    }
+    validateCreatedAt(value) {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new Error('created_at must be a non-negative integer');
+        }
+        return value;
+    }
+    validateKind(value) {
+        if (!Number.isInteger(value) || value < 0) {
+            throw new Error('kind must be a non-negative integer');
+        }
+        return value;
+    }
+    validateContent(value) {
+        if (typeof value !== 'string') {
+            throw new Error('content must be a string');
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAwB,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAChC,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAClC,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AACjD,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAC3D,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAC7C,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACjC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAC3C,MAAM,kCAAkC,GAAG,2BAA2B,CAAC;AA6BvE,SAAS,uBAAuB,CAAC,KAA2C;IAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,KAAoC;IACzE,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,MAAM,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,8BAA8B,CAAC,IAAY;IAClD,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,GAAG,MAAM,CAAC;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,KAAuB;IACtC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,CAAmB,EAAE,CAAmB;IAC7D,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,eAAe;IACT,IAAI,CAAW;IACf,KAAK,CAAQ;IAE9B,YAAY,KAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,KAAuB;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;YACZ,sBAAsB;YACtB,UAAU,CAAC,EAAE;YACb,UAAU,CAAC,MAAM;YACjB,UAAU,CAAC,UAAU;YACrB,UAAU,CAAC,IAAI;YACf,UAAU,CAAC,IAAI;YACf,UAAU,CAAC,OAAO;YAClB,UAAU,CAAC,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,IAAgB;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,CACJ,OAAO,EACP,EAAE,EACF,MAAM,EACN,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,GAAG,EACJ,GAAG,OAAO,CAAC;QAEZ,IAAI,OAAO,KAAK,sBAAsB,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnH,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExB,OAAO,IAAI,CAAC,kBAAkB,CAAC;YAC7B,EAAE;YACF,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,IAAI;YACJ,IAAI;YACJ,OAAO;YACP,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAgB,EAAE,KAAuB;QACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE9D,MAAM,YAAY,GAAuB;YACvC,IAAI,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC;YACzE,YAAY,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CACvC,QAAQ,CAAC,YAAY,EACrB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAC9B,QAAQ,CACT;YACD,gBAAgB,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAC3C,QAAQ,CAAC,gBAAgB,EACzB,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAClC,QAAQ,CACT;YACD,UAAU,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CACrC,QAAQ,CAAC,UAAU,EACnB,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAC5B,QAAQ,CACT;YACD,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;YACxF,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB;SAC5D,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,YAAY,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,YAAY,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAChD,QAAQ,CAAC,WAAW,EACpB,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EACvD,UAAU,EACV,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,IAAI,8BAA8B,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,IAAI,EAAE,CAAC;gBACT,YAAY,CAAC,wBAAwB,GAAG,MAAM,IAAI,CAAC,YAAY,CAC7D,QAAQ,CAAC,wBAAwB,EACjC,IAAI,CAAC,2BAA2B,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,EAC1E,UAAU,EACV,QAAQ,CACT,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAgB,EAAE,MAA0B;QACtD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrF,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE/B,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,OAAe;QAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAgB,EAAE,MAAc,EAAE,UAA6B,EAAE;QAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,IAAgB,EAChB,MAAc,EACd,IAAY,EACZ,UAA6B,EAAE;QAE/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CACvB,QAAQ,CAAC,gBAAgB,EACzB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAC9E,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAgB,EAAE,MAAc,EAAE,IAAY;QACjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACvC,QAAQ,CAAC,WAAW,EACpB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CACnF,CAAC;QAEF,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAgB,EAAE,UAA6B,EAAE;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,SAAS,CACb,IAAgB,EAChB,OAAe,EACf,QAAgB,EAChB,UAA6B,EAAE;QAE/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,2BAA2B,CAC/B,IAAgB,EAChB,MAAc,EACd,IAAY,EACZ,IAAY;QAEZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACvC,QAAQ,CAAC,wBAAwB,EACjC,IAAI,CAAC,2BAA2B,CAC9B,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EACvB,IAAI,CACL,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAgB;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,YAAY,EAAE,IAAI;gBAClB,gBAAgB,EAAE,IAAI;gBACtB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,IAAI;gBACjB,wBAAwB,EAAE,IAAI;aAC/B,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;QAErG,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC;YAC5B,YAAY,EAAE,MAAM,CAAC,uBAAuB,CAAC;YAC7C,gBAAgB,EAAE,MAAM,CAAC,4BAA4B,CAAC;YACtD,UAAU,EAAE,MAAM,CAAC,qBAAqB,CAAC;YACzC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,eAAe,CAAC;YAC9B,WAAW,EAAE,MAAM,CAAC,oBAAoB,CAAC;YACzC,wBAAwB,EAAE,MAAM,CAAC,kCAAkC,CAAC;SACrE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAgB,EAChB,IAAY,EACZ,UAA6B,EAAE;QAE/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CACvB,QAAQ,CAAC,UAAU,EACnB,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EACtC,OAAO,CACR,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAS,EACT,MAAc,EACd,UAA6B,EAAE;QAE/B,MAAM,MAAM,GAAuB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC;YAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEzC,IAAI,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC7D,SAAS;YACX,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC7D,MAAM;YACR,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClE,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,QAAa;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,IAAgB,EAChB,GAAW,EACX,KAAuB,EACvB,QAAa;QAEb,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,QAA4B;QACtD,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,GAAG,EAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,GAAG,EAAE,QAAQ,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,QAAQ,CAAC,wBAAwB,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,kCAAkC;gBACxC,GAAG,EAAE,QAAQ,CAAC,wBAAwB;gBACtC,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ,CAAC,GAAG;aACnB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,aAAa,CAAC,KAAuB;QAC3C,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IAC7E,CAAC;IAEO,iBAAiB,CAAC,KAAuB;QAC/C,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IACpG,CAAC;IAEO,WAAW,CAAC,KAAuB;QACzC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IACpF,CAAC;IAEO,OAAO,CAAC,KAAuB;QACrC,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IAC7D,CAAC;IAEO,qBAAqB,CAAC,GAAW;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,GAAG,iBAAiB,CAAC;QAC9C,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,6DAA6D,GAAG,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAEO,OAAO,CAAC,KAAuB;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAChC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC;YAC1B,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,cAAc,IAAI,eAAe,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACpG,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,QAAgB;QACjD,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO,GAAG,cAAc,IAAI,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC;IAClF,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC;IAEO,iBAAiB,CAAC,OAAe,EAAE,QAAgB;QACzD,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,CAAC;IAEO,cAAc,CAAC,MAAc,EAAE,IAAY;QACjD,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACtC,CAAC;IAEO,2BAA2B,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY;QAC5E,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9C,CAAC;IAEO,kBAAkB,CAAC,KAAuB;QAChD,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC;YAC5C,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;YAClD,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;YACpD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5C,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC;SACjD,CAAC;QAEF,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAuB;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,UAAU,KAAK,UAAU,CAAC,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,+BAA+B,UAAU,SAAS,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,aAAa,CAAC,KAAa,EAAE,KAAa;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8CAA8C,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,cAAc,CAAC,KAAa,EAAE,KAAa;QACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,eAAe,CAAC,KAAa;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/index.d.ts

@@ -3,6 +3,9 @@
  *
  * Provides WebRTC P2P storage and Nostr ref resolver
  */
-export { WebRTCStore, DEFAULT_RELAYS, Peer, PeerId, generateUuid, MAX_HTL, MSG_TYPE_REQUEST, MSG_TYPE_RESPONSE, FRAGMENT_SIZE, encodeRequest, encodeResponse, parseMessage, createRequest, createResponse, createFragmentResponse, hashToKey, verifyHash, generatePeerHTLConfig, decrementHTL, shouldForward, type SignalingMessage, type WebRTCStoreConfig, type PeerStatus, type WebRTCStoreEvent, type WebRTCStoreEventHandler, type EventSigner, type EventEncrypter, type EventDecrypter, type GiftWrapper, type GiftUnwrapper, type SignedEvent, type PeerPool, type PeerClassifier, type PoolConfig, type WebRTCStats, type BandwidthSample, type DataRequest, type DataResponse, type PeerHTLConfig, type PendingRequest, } from './webrtc/index.js';
+export { WebRTCStore, DEFAULT_RELAYS, Peer, PeerSelector, PeerId, generateUuid, MAX_HTL, MSG_TYPE_REQUEST, MSG_TYPE_RESPONSE, FRAGMENT_SIZE, encodeRequest, encodeResponse, parseMessage, createRequest, createResponse, createFragmentResponse, hashToKey, verifyHash, generatePeerHTLConfig, decrementHTLWithPolicy, decrementHTL, shouldForwardHTL, peerPrincipal, normalizeDispatchConfig, buildHedgedWavePlan, syncSelectorPeers, shouldForward, type SignalingMessage, type WebRTCStoreConfig, type PeerStatus, type WebRTCStoreEvent, type WebRTCStoreEventHandler, type EventSigner, type EventEncrypter, type EventDecrypter, type GiftWrapper, type GiftUnwrapper, type SignedEvent, type PeerPool, type PeerClassifier, type PoolConfig, type SelectionStrategy, type RequestDispatchConfig, type PersistedPeerMetadata, type PeerMetadataSnapshot, type MeshStats, type WebRTCStats, type BandwidthSample, type DataRequest, type DataResponse, type PeerHTLConfig, type PendingRequest, } from './webrtc/index.js';
 export { createNostrRefResolver, createNostrRefResolver as createNostrRootResolver, type NostrRefResolverConfig, type NostrRefResolverConfig as NostrRootResolverConfig, type NostrEvent, type NostrFilter, type Nip19Like, type VisibilityCallbacks, type ParsedTreeVisibility, } from './resolver/index.js';
+export { NostrEventStore, type StoredNostrEvent, type NostrEventManifest, type ListEventsOptions, } from './events.js';
+export { encodeSignedNostrEventJson, decodeSignedNostrEventJson, storeSignedNostrEventSnapshot, readSignedNostrEventSnapshot, parseHashtreeRootEvent, type ParsedHashtreeRootEvent, type SnapshotTreeLike, type SnapshotTarget, } from './snapshot.js';
+export { storeTreeEventSnapshot, readTreeEventSnapshot, fetchLatestTreeEventSnapshot, watchLatestTreeEventSnapshot, compareTreeEventSnapshots, isNewerTreeEventSnapshot, snapshotMatchesRootCid, resolveSnapshotRootCid, type TreeEventSnapshotInfo, type TreeEventSnapshotQuery, type FetchLatestTreeEventSnapshotConfig, type WatchTreeEventSnapshotsConfig, } from './treeEventSnapshots.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EAEtB,sBAAsB,IAAI,uBAAuB,EACjD,KAAK,sBAAsB,EAE3B,KAAK,sBAAsB,IAAI,uBAAuB,EACtD,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EAEtB,sBAAsB,IAAI,uBAAuB,EACjD,KAAK,sBAAsB,EAE3B,KAAK,sBAAsB,IAAI,uBAAuB,EACtD,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,GACnC,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -4,11 +4,15 @@
  * Provides WebRTC P2P storage and Nostr ref resolver
  */
 // WebRTC P2P store
-export { WebRTCStore, DEFAULT_RELAYS, Peer, PeerId, generateUuid, MAX_HTL, MSG_TYPE_REQUEST, MSG_TYPE_RESPONSE, FRAGMENT_SIZE, 
+export { WebRTCStore, DEFAULT_RELAYS, Peer, PeerSelector, PeerId, generateUuid, MAX_HTL, MSG_TYPE_REQUEST, MSG_TYPE_RESPONSE, FRAGMENT_SIZE, 
 // Protocol functions
-encodeRequest, encodeResponse, parseMessage, createRequest, createResponse, createFragmentResponse, hashToKey, verifyHash, generatePeerHTLConfig, decrementHTL, shouldForward, } from './webrtc/index.js';
+encodeRequest, encodeResponse, parseMessage, createRequest, createResponse, createFragmentResponse, hashToKey, verifyHash, generatePeerHTLConfig, decrementHTLWithPolicy, decrementHTL, shouldForwardHTL, peerPrincipal, normalizeDispatchConfig, buildHedgedWavePlan, syncSelectorPeers, shouldForward, } from './webrtc/index.js';
 // Ref resolvers
 export { createNostrRefResolver, 
 // Legacy alias
 createNostrRefResolver as createNostrRootResolver, } from './resolver/index.js';
+// Event storage and indexing
+export { NostrEventStore, } from './events.js';
+export { encodeSignedNostrEventJson, decodeSignedNostrEventJson, storeSignedNostrEventSnapshot, readSignedNostrEventSnapshot, parseHashtreeRootEvent, } from './snapshot.js';
+export { storeTreeEventSnapshot, readTreeEventSnapshot, fetchLatestTreeEventSnapshot, watchLatestTreeEventSnapshot, compareTreeEventSnapshots, isNewerTreeEventSnapshot, snapshotMatchesRootCid, resolveSnapshotRootCid, } from './treeEventSnapshots.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,aAAa;AACb,qBAAqB;AACrB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,GAqBd,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EACL,sBAAsB;AACtB,eAAe;AACf,sBAAsB,IAAI,uBAAuB,GASlD,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,cAAc,EACd,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,aAAa;AACb,qBAAqB;AACrB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GA0Bd,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EACL,sBAAsB;AACtB,eAAe;AACf,sBAAsB,IAAI,uBAAuB,GASlD,MAAM,qBAAqB,CAAC;AAE7B,6BAA6B;AAC7B,OAAO,EACL,eAAe,GAIhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,GAIvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GAKvB,MAAM,yBAAyB,CAAC"}

package/dist/resolver/nostr.d.ts

@@ -36,6 +36,8 @@ export interface NostrFilter {
 export interface ParsedTreeVisibility {
     hash: string;
     visibility: TreeVisibility;
+    /** All l-tags attached to the tree event */
+    labels?: string[];
     /** Plaintext key (for public trees) */
     key?: string;
     /** Encrypted key (for link-visible trees) - decrypt with link key */