@enbox/dwn-sdk-js 0.0.6 → 0.0.8

package/dist/esm/src/core/tenant-gate.js

@@ -1,20 +1,9 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 /**
  * A tenant gate that treats every DID as an active tenant.
  */
 export class AllowAllTenantGate {
-    isActiveTenant(_did) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return { isActiveTenant: true };
-        });
+    async isActiveTenant(_did) {
+        return { isActiveTenant: true };
     }
 }
 //# sourceMappingURL=tenant-gate.js.map

package/dist/esm/src/core/tenant-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-gate.js","sourceRoot":"","sources":["../../../../src/core/tenant-gate.ts"],"names":[],"mappings":";;;;;;;;;AAyBA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAChB,cAAc,CAAC,IAAY;;YACtC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC;KAAA;CACF"}
+{"version":3,"file":"tenant-gate.js","sourceRoot":"","sources":["../../../../src/core/tenant-gate.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACtB,KAAK,CAAC,cAAc,CAAC,IAAY;QACtC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/esm/src/dwn.js

@@ -1,18 +1,11 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { AllowAllTenantGate } from './core/tenant-gate.js';
+import { CoreProtocolRegistry } from './core/core-protocol.js';
 import { Message } from './core/message.js';
 import { messageReplyFromError } from './core/message-reply.js';
 import { MessagesReadHandler } from './handlers/messages-read.js';
 import { MessagesSubscribeHandler } from './handlers/messages-subscribe.js';
 import { MessagesSyncHandler } from './handlers/messages-sync.js';
+import { PermissionsProtocol } from './protocols/permissions.js';
 import { ProtocolsConfigureHandler } from './handlers/protocols-configure.js';
 import { ProtocolsQueryHandler } from './handlers/protocols-query.js';
 import { RecordsCountHandler } from './handlers/records-count.js';
@@ -26,75 +19,98 @@ import { StorageController } from './store/storage-controller.js';
 import { DidDht, DidJwk, DidKey, DidResolverCacheLevel, DidWeb, UniversalResolver } from '@enbox/dids';
 import { DwnInterfaceName, DwnMethodName } from './enums/dwn-interface-method.js';
 export class Dwn {
+    methodHandlers;
+    didResolver;
+    messageStore;
+    dataStore;
+    resumableTaskStore;
+    stateIndex;
+    tenantGate;
+    eventLog;
+    storageController;
+    resumableTaskManager;
+    _coreProtocols;
     constructor(config) {
         this.didResolver = config.didResolver;
         this.tenantGate = config.tenantGate;
-        this.eventStream = config.eventStream;
         this.messageStore = config.messageStore;
         this.dataStore = config.dataStore;
         this.resumableTaskStore = config.resumableTaskStore;
         this.stateIndex = config.stateIndex;
-        this.eventStream = config.eventStream;
+        this.eventLog = config.eventLog;
         this.storageController = new StorageController({
             messageStore: this.messageStore,
             dataStore: this.dataStore,
             stateIndex: this.stateIndex,
-            eventStream: this.eventStream
+            eventLog: this.eventLog
         });
         this.resumableTaskManager = new ResumableTaskManager(config.resumableTaskStore, this.storageController);
+        // Initialize the core protocol registry with built-in system protocols.
+        this._coreProtocols = new CoreProtocolRegistry();
+        this._coreProtocols.register(new PermissionsProtocol());
+        // Build the shared dependency bag once; every handler receives the same object
+        // and accesses only the dependencies it needs.
+        const deps = {
+            didResolver: this.didResolver,
+            messageStore: this.messageStore,
+            dataStore: this.dataStore,
+            stateIndex: this.stateIndex,
+            resumableTaskManager: this.resumableTaskManager,
+            coreProtocols: this._coreProtocols,
+            eventLog: this.eventLog,
+        };
         this.methodHandlers = {
-            [DwnInterfaceName.Messages + DwnMethodName.Read]: new MessagesReadHandler(this.didResolver, this.messageStore, this.dataStore),
-            [DwnInterfaceName.Messages + DwnMethodName.Subscribe]: new MessagesSubscribeHandler(this.didResolver, this.messageStore, this.eventStream),
-            [DwnInterfaceName.Messages + DwnMethodName.Sync]: new MessagesSyncHandler(this.didResolver, this.messageStore, this.stateIndex),
-            [DwnInterfaceName.Protocols + DwnMethodName.Configure]: new ProtocolsConfigureHandler(this.didResolver, this.messageStore, this.stateIndex, this.eventStream),
-            [DwnInterfaceName.Protocols + DwnMethodName.Query]: new ProtocolsQueryHandler(this.didResolver, this.messageStore, this.dataStore),
-            [DwnInterfaceName.Records + DwnMethodName.Count]: new RecordsCountHandler(this.didResolver, this.messageStore),
-            [DwnInterfaceName.Records + DwnMethodName.Delete]: new RecordsDeleteHandler(this.didResolver, this.messageStore, this.resumableTaskManager),
-            [DwnInterfaceName.Records + DwnMethodName.Query]: new RecordsQueryHandler(this.didResolver, this.messageStore, this.dataStore),
-            [DwnInterfaceName.Records + DwnMethodName.Read]: new RecordsReadHandler(this.didResolver, this.messageStore, this.dataStore),
-            [DwnInterfaceName.Records + DwnMethodName.Subscribe]: new RecordsSubscribeHandler(this.didResolver, this.messageStore, this.eventStream),
-            [DwnInterfaceName.Records + DwnMethodName.Write]: new RecordsWriteHandler(this.didResolver, this.messageStore, this.dataStore, this.stateIndex, this.eventStream)
+            [DwnInterfaceName.Messages + DwnMethodName.Read]: new MessagesReadHandler(deps),
+            [DwnInterfaceName.Messages + DwnMethodName.Subscribe]: new MessagesSubscribeHandler(deps),
+            [DwnInterfaceName.Messages + DwnMethodName.Sync]: new MessagesSyncHandler(deps),
+            [DwnInterfaceName.Protocols + DwnMethodName.Configure]: new ProtocolsConfigureHandler(deps),
+            [DwnInterfaceName.Protocols + DwnMethodName.Query]: new ProtocolsQueryHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Count]: new RecordsCountHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Delete]: new RecordsDeleteHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Query]: new RecordsQueryHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Read]: new RecordsReadHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Subscribe]: new RecordsSubscribeHandler(deps),
+            [DwnInterfaceName.Records + DwnMethodName.Write]: new RecordsWriteHandler(deps),
         };
     }
     /**
      * Creates an instance of the DWN.
      */
-    static create(config) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            (_a = config.didResolver) !== null && _a !== void 0 ? _a : (config.didResolver = new UniversalResolver({
-                didResolvers: [DidDht, DidJwk, DidKey, DidWeb],
-                cache: new DidResolverCacheLevel({ location: 'RESOLVERCACHE' }),
-            }));
-            (_b = config.tenantGate) !== null && _b !== void 0 ? _b : (config.tenantGate = new AllowAllTenantGate());
-            const dwn = new Dwn(config);
-            yield dwn.open();
-            return dwn;
+    static async create(config) {
+        config.didResolver ??= new UniversalResolver({
+            didResolvers: [DidDht, DidJwk, DidKey, DidWeb],
+            cache: new DidResolverCacheLevel({ location: 'RESOLVERCACHE' }),
         });
+        config.tenantGate ??= new AllowAllTenantGate();
+        const dwn = new Dwn(config);
+        await dwn.open();
+        return dwn;
     }
     /**
      * Initializes the DWN instance and opens the connection to it.
      */
-    open() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            yield this.messageStore.open();
-            yield this.dataStore.open();
-            yield this.resumableTaskStore.open();
-            yield this.stateIndex.open();
-            yield ((_a = this.eventStream) === null || _a === void 0 ? void 0 : _a.open());
-            yield this.resumableTaskManager.resumeTasksAndWaitForCompletion();
-        });
+    async open() {
+        await this.messageStore.open();
+        await this.dataStore.open();
+        await this.resumableTaskStore.open();
+        await this.stateIndex.open();
+        await this.eventLog?.open();
+        await this.resumableTaskManager.resumeTasksAndWaitForCompletion();
     }
-    close() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            yield ((_a = this.eventStream) === null || _a === void 0 ? void 0 : _a.close());
-            yield this.messageStore.close();
-            yield this.dataStore.close();
-            yield this.resumableTaskStore.close();
-            yield this.stateIndex.close();
-        });
+    async close() {
+        await this.eventLog?.close();
+        await this.messageStore.close();
+        await this.dataStore.close();
+        await this.resumableTaskStore.close();
+        await this.stateIndex.close();
+    }
+    /**
+     * The registry of core protocols (hardcoded, immutable, always-installed).
+     * Used by handlers and utilities that need to check whether a protocol URI
+     * belongs to a core protocol or to dispatch lifecycle hooks.
+     */
+    get coreProtocols() {
+        return this._coreProtocols;
     }
     /**
      * Returns the internal storage components for advanced operations that
@@ -107,43 +123,37 @@ export class Dwn {
         return {
             messageStore: this.messageStore,
             stateIndex: this.stateIndex,
-            eventStream: this.eventStream,
+            eventLog: this.eventLog,
         };
     }
-    processMessage(tenant_1, rawMessage_1) {
-        return __awaiter(this, arguments, void 0, function* (tenant, rawMessage, options = {}) {
-            var _a;
-            const errorMessageReply = (_a = yield this.validateTenant(tenant)) !== null && _a !== void 0 ? _a : yield this.validateMessageIntegrity(rawMessage);
-            if (errorMessageReply !== undefined) {
-                return errorMessageReply;
-            }
-            const { dataStream, subscriptionHandler } = options;
-            const handlerKey = rawMessage.descriptor.interface + rawMessage.descriptor.method;
-            const methodHandlerReply = yield this.methodHandlers[handlerKey].handle({
-                tenant,
-                message: rawMessage,
-                dataStream,
-                subscriptionHandler
-            });
-            return methodHandlerReply;
+    async processMessage(tenant, rawMessage, options = {}) {
+        const errorMessageReply = await this.validateTenant(tenant) ?? await this.validateMessageIntegrity(rawMessage);
+        if (errorMessageReply !== undefined) {
+            return errorMessageReply;
+        }
+        const { dataStream, subscriptionHandler } = options;
+        const handlerKey = rawMessage.descriptor.interface + rawMessage.descriptor.method;
+        const methodHandlerReply = await this.methodHandlers[handlerKey].handle({
+            tenant,
+            message: rawMessage,
+            dataStream,
+            subscriptionHandler
         });
+        return methodHandlerReply;
     }
     /**
      * Checks tenant gate to see if tenant is allowed.
      * @param tenant The tenant DID to route the given message to.
      * @returns GenericMessageReply if the message has an integrity error, otherwise undefined.
      */
-    validateTenant(tenant) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            const result = yield this.tenantGate.isActiveTenant(tenant);
-            if (!result.isActiveTenant) {
-                const detail = (_a = result.detail) !== null && _a !== void 0 ? _a : `DID ${tenant} is not an active tenant.`;
-                return {
-                    status: { code: 401, detail }
-                };
-            }
-        });
+    async validateTenant(tenant) {
+        const result = await this.tenantGate.isActiveTenant(tenant);
+        if (!result.isActiveTenant) {
+            const detail = result.detail ?? `DID ${tenant} is not an active tenant.`;
+            return {
+                status: { code: 401, detail }
+            };
+        }
     }
     /**
      * Validates structure of DWN message
@@ -153,26 +163,23 @@ export class Dwn {
   
      * @returns GenericMessageReply if the message has an integrity error, otherwise undefined.
      */
-    validateMessageIntegrity(rawMessage) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            // Verify interface and method
-            const dwnInterface = (_a = rawMessage === null || rawMessage === void 0 ? void 0 : rawMessage.descriptor) === null || _a === void 0 ? void 0 : _a.interface;
-            const dwnMethod = (_b = rawMessage === null || rawMessage === void 0 ? void 0 : rawMessage.descriptor) === null || _b === void 0 ? void 0 : _b.method;
-            if (dwnInterface === undefined || dwnMethod === undefined) {
-                return {
-                    status: { code: 400, detail: `Both interface and method must be present, interface: ${dwnInterface}, method: ${dwnMethod}` }
-                };
-            }
-            // validate message structure
-            try {
-                // consider to push this down to individual handlers
-                Message.validateJsonSchema(rawMessage);
-            }
-            catch (error) {
-                return messageReplyFromError(error, 400);
-            }
-        });
+    async validateMessageIntegrity(rawMessage) {
+        // Verify interface and method
+        const dwnInterface = rawMessage?.descriptor?.interface;
+        const dwnMethod = rawMessage?.descriptor?.method;
+        if (dwnInterface === undefined || dwnMethod === undefined) {
+            return {
+                status: { code: 400, detail: `Both interface and method must be present, interface: ${dwnInterface}, method: ${dwnMethod}` }
+            };
+        }
+        // validate message structure
+        try {
+            // consider to push this down to individual handlers
+            Message.validateJsonSchema(rawMessage);
+        }
+        catch (error) {
+            return messageReplyFromError(error, 400);
+        }
     }
 }
 ;

package/dist/esm/src/dwn.js.map

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

package/dist/esm/src/event-stream/event-emitter-event-log.js

@@ -0,0 +1,204 @@
+import mitt from 'mitt';
+import { FilterUtility } from '../utils/filter.js';
+import { DwnError, DwnErrorCode } from '../core/dwn-error.js';
+const EVENTS_LISTENER_CHANNEL = 'events';
+/**
+ * In-memory implementation of {@link EventLog} backed by `mitt` for in-process
+ * pub/sub and a per-tenant `Map<number, StoredEntry>` for persistence with
+ * cursor-based reads.
+ *
+ * Suitable for single-process embedded DWN instances and tests.
+ * For multi-node deployments, use a distributed implementation (NATS, Redis, etc.).
+ */
+export class EventEmitterEventLog {
+    emitter = mitt();
+    isOpen = false;
+    errorHandler = (error) => { console.error('event log error', error); };
+    maxEventsPerTenant;
+    /**
+     * Per-tenant ordered event storage.
+     * Key: tenant DID → Map of seq → StoredEntry.
+     */
+    tenantLogs = new Map();
+    /**
+     * Per-tenant monotonic sequence counter.
+     */
+    tenantSeqs = new Map();
+    constructor(config = {}) {
+        this.maxEventsPerTenant = config.maxEventsPerTenant ?? 10_000;
+        if (config.errorHandler) {
+            this.errorHandler = config.errorHandler;
+        }
+    }
+    async open() {
+        this.isOpen = true;
+    }
+    async close() {
+        this.isOpen = false;
+        this.emitter.all.clear();
+        this.tenantLogs.clear();
+        this.tenantSeqs.clear();
+    }
+    async emit(tenant, event, indexes) {
+        if (!this.isOpen) {
+            this.errorHandler(new DwnError(DwnErrorCode.EventLogNotOpenError, 'a message emitted when EventLog is closed'));
+            return '';
+        }
+        // Assign a monotonic sequence number for this tenant.
+        const prevSeq = this.tenantSeqs.get(tenant) ?? 0;
+        const seq = prevSeq + 1;
+        this.tenantSeqs.set(tenant, seq);
+        // Persist the event.
+        let log = this.tenantLogs.get(tenant);
+        if (log === undefined) {
+            log = new Map();
+            this.tenantLogs.set(tenant, log);
+        }
+        log.set(seq, { event, indexes });
+        // Evict oldest entries if the log exceeds the retention limit.
+        if (log.size > this.maxEventsPerTenant) {
+            const evictCount = log.size - this.maxEventsPerTenant;
+            let evicted = 0;
+            for (const key of log.keys()) {
+                if (evicted >= evictCount) {
+                    break;
+                }
+                log.delete(key);
+                evicted++;
+            }
+        }
+        // Notify in-process subscribers.
+        const channel = `${tenant}_${EVENTS_LISTENER_CHANNEL}`;
+        this.emitter.emit(channel, { tenant, event, indexes, seq });
+        return String(seq);
+    }
+    async read(tenant, options = {}) {
+        const { cursor, limit, filters } = options;
+        const cursorSeq = cursor !== undefined ? EventEmitterEventLog.parseCursor(cursor) : undefined;
+        const log = this.tenantLogs.get(tenant);
+        if (log === undefined || log.size === 0) {
+            return { events: [], cursor };
+        }
+        const results = [];
+        const maxResults = limit ?? Number.MAX_SAFE_INTEGER;
+        for (const [seq, entry] of log) {
+            // Skip entries at or before the cursor.
+            if (cursorSeq !== undefined && seq <= cursorSeq) {
+                continue;
+            }
+            // Apply filters if provided (OR semantics — match any filter).
+            if (filters !== undefined && filters.length > 0) {
+                if (!FilterUtility.matchAnyFilter(entry.indexes, filters)) {
+                    continue;
+                }
+            }
+            results.push({
+                seq,
+                event: entry.event,
+                indexes: entry.indexes,
+            });
+            if (results.length >= maxResults) {
+                break;
+            }
+        }
+        const lastSeq = results.length > 0 ? results[results.length - 1].seq : undefined;
+        return { events: results, cursor: lastSeq !== undefined ? String(lastSeq) : cursor };
+    }
+    /**
+     * Parse an opaque cursor string into an internal sequence number.
+     */
+    static parseCursor(cursor) {
+        const seq = Number(cursor);
+        if (Number.isNaN(seq) || seq < 0) {
+            throw new DwnError(DwnErrorCode.EventLogNotOpenError, `invalid cursor: '${cursor}'`);
+        }
+        return seq;
+    }
+    async subscribe(tenant, id, listener, options) {
+        const channel = `${tenant}_${EVENTS_LISTENER_CHANNEL}`;
+        const { cursor, filters } = options ?? {};
+        if (cursor !== undefined) {
+            // ---- Cursor mode: catch-up from stored events, then EOSE, then live ----
+            const cursorSeq = EventEmitterEventLog.parseCursor(cursor);
+            const pendingLiveEvents = [];
+            let catchUpComplete = false;
+            // Step 1: Register live listener FIRST so no events are missed during read.
+            const handler = (payload) => {
+                if (filters !== undefined && filters.length > 0) {
+                    if (!FilterUtility.matchAnyFilter(payload.indexes, filters)) {
+                        return;
+                    }
+                }
+                if (!catchUpComplete) {
+                    pendingLiveEvents.push({ event: payload.event, seq: payload.seq });
+                }
+                else {
+                    listener({ type: 'event', cursor: String(payload.seq), event: payload.event });
+                }
+            };
+            this.emitter.on(channel, handler);
+            // Step 2: Read stored events from cursor and deliver them.
+            const readResult = await this.read(tenant, { cursor, filters });
+            // The read cursor is the last event's seq (string) or the input cursor if nothing new.
+            const eoseCursor = readResult.cursor ?? cursor;
+            const lastCatchUpSeq = readResult.cursor !== undefined ? Number(readResult.cursor) : cursorSeq;
+            for (const entry of readResult.events) {
+                listener({ type: 'event', cursor: String(entry.seq), event: entry.event });
+            }
+            // Step 3: Deliver any live events that arrived during catch-up (with seq > lastCatchUpSeq).
+            catchUpComplete = true;
+            for (const liveEvent of pendingLiveEvents) {
+                if (liveEvent.seq > lastCatchUpSeq) {
+                    listener({ type: 'event', cursor: String(liveEvent.seq), event: liveEvent.event });
+                }
+            }
+            // Step 4: Send EOSE marker.
+            listener({ type: 'eose', cursor: eoseCursor });
+            return {
+                id,
+                close: async () => { this.emitter.off(channel, handler); }
+            };
+        }
+        // ---- No cursor: live events only ----
+        const handler = (payload) => {
+            if (filters !== undefined && filters.length > 0) {
+                if (!FilterUtility.matchAnyFilter(payload.indexes, filters)) {
+                    return;
+                }
+            }
+            listener({ type: 'event', cursor: String(payload.seq), event: payload.event });
+        };
+        this.emitter.on(channel, handler);
+        return {
+            id,
+            close: async () => { this.emitter.off(channel, handler); }
+        };
+    }
+    async trim(tenant, olderThan) {
+        const log = this.tenantLogs.get(tenant);
+        if (log === undefined) {
+            return;
+        }
+        if (typeof olderThan === 'number') {
+            // Trim by sequence number: delete entries with seq < olderThan.
+            for (const seq of log.keys()) {
+                if (seq < olderThan) {
+                    log.delete(seq);
+                }
+                else {
+                    break; // Map is ordered by insertion (ascending seq), safe to stop.
+                }
+            }
+        }
+        else {
+            // Trim by ISO-8601 timestamp: delete entries whose message timestamp is before the given time.
+            for (const [seq, entry] of log) {
+                const messageTimestamp = entry.indexes['messageTimestamp'] ?? '';
+                if (messageTimestamp < olderThan) {
+                    log.delete(seq);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=event-emitter-event-log.js.map

package/dist/esm/src/event-stream/event-emitter-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter-event-log.js","sourceRoot":"","sources":["../../../../src/event-stream/event-emitter-event-log.ts"],"names":[],"mappings":"AAYA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,uBAAuB,GAAG,QAAQ,CAAC;AAqCzC;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAoB;IACvB,OAAO,GAAG,IAAI,EAAiB,CAAC;IAChC,MAAM,GAAY,KAAK,CAAC;IACxB,YAAY,GAAyB,CAAC,KAAK,EAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,kBAAkB,CAAS;IAEnC;;;OAGG;IACK,UAAU,GAA0C,IAAI,GAAG,EAAE,CAAC;IAEtE;;OAEG;IACK,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEpD,YAAY,SAAqC,EAAE;QACjD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC;QAE9D,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAC1C,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,KAAmB,EAAE,OAAkB;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,IAAI,QAAQ,CAC5B,YAAY,CAAC,oBAAoB,EACjC,2CAA2C,CAC5C,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEjC,qBAAqB;QACrB,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAEjC,+DAA+D;QAC/D,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC;YACtD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7B,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;oBAAC,MAAM;gBAAC,CAAC;gBACrC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,uBAAuB,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAE5D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,UAA+B,EAAE;QACjE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,KAAK,IAAI,MAAM,CAAC,gBAAgB,CAAC;QAEpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;YAC/B,wCAAwC;YACxC,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAE9D,+DAA+D;YAC/D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;oBAAC,SAAS;gBAAC,CAAC;YAC1E,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG;gBACH,KAAK,EAAK,KAAK,CAAC,KAAK;gBACrB,OAAO,EAAG,KAAK,CAAC,OAAO;aACxB,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;gBAAC,MAAM;YAAC,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvF,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CAAC,MAAc;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,oBAAoB,EAAE,oBAAoB,MAAM,GAAG,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,MAAc,EACd,EAAU,EACV,QAA8B,EAC9B,OAAkC;QAElC,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,uBAAuB,EAAE,CAAC;QACvD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAE1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,2EAA2E;YAC3E,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAI3D,MAAM,iBAAiB,GAAoB,EAAE,CAAC;YAC9C,IAAI,eAAe,GAAG,KAAK,CAAC;YAE5B,4EAA4E;YAC5E,MAAM,OAAO,GAAG,CAAC,OAAuB,EAAQ,EAAE;gBAChD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;wBAAC,OAAO;oBAAC,CAAC;gBAC1E,CAAC;gBACD,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrB,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAElC,2DAA2D;YAC3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,uFAAuF;YACvF,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC;YAC/C,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE/F,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7E,CAAC;YAED,4FAA4F;YAC5F,eAAe,GAAG,IAAI,CAAC;YACvB,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;gBAC1C,IAAI,SAAS,CAAC,GAAG,GAAG,cAAc,EAAE,CAAC;oBACnC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;YAED,4BAA4B;YAC5B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAE/C,OAAO;gBACL,EAAE;gBACF,KAAK,EAAE,KAAK,IAAmB,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;aAC1E,CAAC;QACJ,CAAC;QAED,wCAAwC;QAExC,MAAM,OAAO,GAAG,CAAC,OAAuB,EAAQ,EAAE;YAChD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;YAC1E,CAAC;YACD,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAElC,OAAO;YACL,EAAE;YACF,KAAK,EAAE,KAAK,IAAmB,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;SAC1E,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,SAA0B;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAElC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,gEAAgE;YAChE,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7B,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;oBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,6DAA6D;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,+FAA+F;YAC/F,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC/B,MAAM,gBAAgB,GAAI,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAY,IAAI,EAAE,CAAC;gBAC7E,IAAI,gBAAgB,GAAG,SAAS,EAAE,CAAC;oBACjC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}