@olane/o-node 0.7.12-alpha.5 → 0.7.12-alpha.50

package/dist/src/o-node.d.ts

@@ -3,11 +3,14 @@ import { PeerId } from '@olane/o-config';
 import { oNodeHierarchyManager } from './o-node.hierarchy-manager.js';
 import { oNodeConfig } from './interfaces/o-node.config.js';
 import { oNodeTransport } from './router/o-node.transport.js';
-import { oRequest } from '@olane/o-core';
+import { oRequest, oNotificationManager } from '@olane/o-core';
 import { oNodeAddress } from './router/o-node.address.js';
 import { oNodeConnection } from './connection/o-node-connection.js';
 import { oNodeConnectionManager } from './connection/o-node-connection.manager.js';
 import { oToolBase } from '@olane/o-tool';
+import { oConnectionHeartbeatManager } from './managers/o-connection-heartbeat.manager.js';
+import { oReconnectionManager } from './managers/o-reconnection.manager.js';
+import { oNodeConnectionConfig } from './connection/index.js';
 export declare class oNode extends oToolBase {
     peerId: PeerId;
     p2pNode: Libp2p;
@@ -15,6 +18,8 @@ export declare class oNode extends oToolBase {
     config: oNodeConfig;
     connectionManager: oNodeConnectionManager;
     hierarchyManager: oNodeHierarchyManager;
+    connectionHeartbeatManager?: oConnectionHeartbeatManager;
+    reconnectionManager?: oReconnectionManager;
     protected didRegister: boolean;
     constructor(config: oNodeConfig);
     get leader(): oNodeAddress | null;
@@ -22,11 +27,13 @@ export declare class oNode extends oToolBase {
     get parentPeerId(): string | null;
     configureTransports(): any[];
     initializeRouter(): Promise<void>;
+    protected createNotificationManager(): oNotificationManager;
     get staticAddress(): oNodeAddress;
     get parentTransports(): oNodeTransport[];
     get transports(): oNodeTransport[];
     unregister(): Promise<void>;
     registerParent(): Promise<void>;
+    registerLeader(): Promise<void>;
     register(): Promise<void>;
     extractMethod(address: oNodeAddress): string;
     start(): Promise<void>;
@@ -37,8 +44,29 @@ export declare class oNode extends oToolBase {
      */
     configure(): Promise<Libp2pConfig>;
     protected createNode(): Promise<Libp2p>;
-    connect(nextHopAddress: oNodeAddress, targetAddress: oNodeAddress): Promise<oNodeConnection>;
+    connect(config: oNodeConnectionConfig): Promise<oNodeConnection>;
+    initConnectionManager(): Promise<void>;
+    initReconnectionManager(): Promise<void>;
+    hookInitializeFinished(): Promise<void>;
+    hookStartFinished(): Promise<void>;
     initialize(): Promise<void>;
+    /**
+     * Override use() to wrap leader/registry requests with retry logic
+     */
     teardown(): Promise<void>;
+    getLeaders(): oNodeAddress[];
+    getParents(): oNodeAddress[];
+    getChildren(): oNodeAddress[];
+    removeChild(childAddress: oNodeAddress): void;
+    /**
+     * Get the total number of active streams across all connections
+     * @returns Total count of active streams
+     */
+    getStreamCount(): number;
+    /**
+     * Get libp2p metrics for this node
+     * Tool method that can be called remotely by monitoring systems
+     */
+    _tool_get_libp2p_metrics(request: oRequest): Promise<any>;
 }
 //# sourceMappingURL=o-node.d.ts.map

package/dist/src/o-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node.d.ts","sourceRoot":"","sources":["../../src/o-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EACN,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAKL,QAAQ,EAET,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC;AAI3D,qBAAa,KAAM,SAAQ,SAAS;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,OAAO,EAAG,YAAY,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAG,sBAAsB,CAAC;IAC3C,gBAAgB,EAAG,qBAAqB,CAAC;IAChD,SAAS,CAAC,WAAW,EAAE,OAAO,CAAS;gBAE3B,MAAM,EAAE,WAAW;IAK/B,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;IAED,IAAI,aAAa,IAAI,YAAY,CAKhC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAOhC;IAED,mBAAmB,IAAI,GAAG,EAAE;IAItB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IASvC,IAAI,aAAa,IAAI,YAAY,CAEhC;IAED,IAAI,gBAAgB,IAAI,cAAc,EAAE,CAEvC;IAED,IAAI,UAAU,IAAI,cAAc,EAAE,CAIjC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC/B,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAItC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAG1D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;cA0FxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvC,OAAO,CACX,cAAc,EAAE,YAAY,EAC5B,aAAa,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC;IA0BrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}
+{"version":3,"file":"o-node.d.ts","sourceRoot":"","sources":["../../src/o-node.ts"],"names":[],"mappings":"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"}

package/dist/src/o-node.js

@@ -9,6 +9,9 @@ import { oNodeConnectionManager } from './connection/o-node-connection.manager.j
 import { oNodeResolver } from './router/resolvers/o-node.resolver.js';
 import { oMethodResolver, oToolBase } from '@olane/o-tool';
 import { oLeaderResolverFallback } from './router/index.js';
+import { oNodeNotificationManager } from './o-node.notification-manager.js';
+import { oConnectionHeartbeatManager } from './managers/o-connection-heartbeat.manager.js';
+import { oReconnectionManager } from './managers/o-reconnection.manager.js';
 export class oNode extends oToolBase {
     constructor(config) {
         super(config);
@@ -43,6 +46,9 @@ export class oNode extends oToolBase {
         });
         this.router = new oNodeRouter();
     }
+    createNotificationManager() {
+        return new oNodeNotificationManager(this.p2pNode, this.hierarchyManager, this.address);
+    }
     get staticAddress() {
         return this.config.address;
     }
@@ -60,6 +66,30 @@ export class oNode extends oToolBase {
             this.logger.debug('Skipping unregistration, node is leader');
             return;
         }
+        // Notify parent we're stopping (best-effort, 2s timeout)
+        if (this.config.parent) {
+            try {
+                await Promise.race([
+                    this.use(this.config.parent, {
+                        method: 'notify',
+                        params: {
+                            eventType: 'node:stopping',
+                            eventData: {
+                                address: this.address.toString(),
+                                reason: 'graceful_shutdown',
+                                expectedDowntime: null,
+                            },
+                            source: this.address.toString(),
+                        },
+                    }),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 2000)),
+                ]);
+                this.logger.debug('Notified parent of shutdown');
+            }
+            catch (error) {
+                this.logger.warn('Failed to notify parent (will be detected by heartbeat):', error instanceof Error ? error.message : error);
+            }
+        }
         if (!this.config.leader) {
             this.logger.debug('No leader found, skipping unregistration');
             return;
@@ -72,18 +102,30 @@ export class oNode extends oToolBase {
                 peerId: this.peerId.toString(),
             },
         };
-        await this.use(address, params);
+        this.use(address, params).catch((error) => {
+            this.logger.error('Failed to unregister from network:', error);
+        });
     }
     async registerParent() {
         if (this.type === NodeType.LEADER) {
             this.logger.debug('Skipping parent registration, node is leader');
             return;
         }
+        if (!this.parent?.libp2pTransports?.length) {
+            this.logger.debug('Parent has no transports, waiting for reconnection & leader ack');
+            if (this.parent?.toString() === oAddress.leader().toString()) {
+                this.parent.setTransports(this.leader?.libp2pTransports || []);
+            }
+            else {
+                this.logger.debug('Waiting for parent and reconnecting...');
+                await this.reconnectionManager?.waitForParentAndReconnect();
+            }
+        }
         // if no parent transports, register with the parent to get them
         // TODO: should we remove the transports check to make this more consistent?
-        if (this.config.parent && this.config.parent.transports.length === 0) {
-            this.logger.debug('Registering node with parent...', this.config.parent);
-            const parentRegistration = await this.use(this.config.parent, {
+        if (this.config.parent) {
+            this.logger.debug('Registering node with parent...', this.config.parent?.toString());
+            await this.use(this.config.parent, {
                 method: 'child_register',
                 params: {
                     address: this.address.toString(),
@@ -92,11 +134,22 @@ export class oNode extends oToolBase {
                     _token: this.config.joinToken,
                 },
             });
-            const { parentTransports } = parentRegistration.result.data;
-            // update the parent transports
-            this.config.parent.setTransports(parentTransports.map((t) => new oNodeTransport(t)));
         }
     }
+    async registerLeader() {
+        const address = oAddress.registry();
+        const params = {
+            method: 'commit',
+            params: {
+                peerId: this.peerId.toString(),
+                address: this.address.toString(),
+                protocols: this.p2pNode.getProtocols(),
+                transports: this.transports,
+                staticAddress: this.staticAddress.toString(),
+            },
+        };
+        await this.use(address, params);
+    }
     async register() {
         if (this.type === NodeType.LEADER) {
             this.logger.debug('Skipping registration, node is leader');
@@ -117,18 +170,7 @@ export class oNode extends oToolBase {
             this.logger.debug('Registering node with leader...');
         }
         await this.registerParent();
-        const address = oAddress.registry();
-        const params = {
-            method: 'commit',
-            params: {
-                peerId: this.peerId.toString(),
-                address: this.address.toString(),
-                protocols: this.p2pNode.getProtocols(),
-                transports: this.transports,
-                staticAddress: this.staticAddress.toString(),
-            },
-        };
-        await this.use(address, params);
+        await this.registerLeader();
         this.logger.debug('Registration successful');
     }
     extractMethod(address) {
@@ -136,11 +178,10 @@ export class oNode extends oToolBase {
     }
     async start() {
         await super.start();
-        // await NetworkUtils.advertiseToNetwork(
-        //   this.address,
-        //   this.staticAddress,
-        //   this.p2pNode,
-        // );
+        // Start heartbeat after node is running
+        if (this.connectionHeartbeatManager) {
+            await this.connectionHeartbeatManager.start();
+        }
     }
     async validateJoinRequest(request) {
         return true;
@@ -190,12 +231,32 @@ export class oNode extends oToolBase {
             // ];
             //   // let's make sure we only allow communication through the parent transports
             params.connectionGater = {
+                denyDialPeer: (peerId) => {
+                    // we can call the leader
+                    if (this.config.leader?.libp2pTransports.some((t) => t.toPeerId() === peerId.toString())) {
+                        return false;
+                    }
+                    // we can call our parent
+                    if (this.parentPeerId === peerId.toString()) {
+                        return false;
+                    }
+                    // we can call our children
+                    if (this.hierarchyManager.children.some((c) => c.libp2pTransports.some((t) => t.toPeerId() === peerId.toString()))) {
+                        return false;
+                    }
+                    // check for standalone node
+                    if (!this.config.parent && !this.config.leader) {
+                        return false;
+                    }
+                    return true;
+                },
                 // who can call us?
                 denyInboundEncryptedConnection: (peerId, maConn) => {
                     // deny all inbound connections unless they are from a parent transport
                     if (this.parentPeerId === peerId.toString()) {
                         return false;
                     }
+                    // allow connections from children (for ping)
                     if (this.hierarchyManager.children.some((c) => c.libp2pTransports.some((t) => t.toPeerId() === peerId.toString()))) {
                         return false;
                     }
@@ -223,17 +284,13 @@ export class oNode extends oToolBase {
         this.p2pNode = await createNode(params);
         return this.p2pNode;
     }
-    async connect(nextHopAddress, targetAddress) {
+    async connect(config) {
         if (!this.connectionManager) {
             this.logger.error('Connection manager not initialized');
             throw new Error('Node is not ready to connect to other nodes');
         }
         const connection = await this.connectionManager
-            .connect({
-            address: targetAddress,
-            nextHopAddress,
-            callerAddress: this.address,
-        })
+            .connect(config)
             .catch((error) => {
             // TODO: we need to handle this better and document
             if (error.message === 'Can not dial self') {
@@ -246,6 +303,43 @@ export class oNode extends oToolBase {
         }
         return connection;
     }
+    async initConnectionManager() {
+        this.connectionManager = new oNodeConnectionManager({
+            p2pNode: this.p2pNode,
+            defaultReadTimeoutMs: this.config.connectionTimeouts?.readTimeoutMs,
+            defaultDrainTimeoutMs: this.config.connectionTimeouts?.drainTimeoutMs,
+            runOnLimitedConnection: this.config.runOnLimitedConnection ?? false,
+        });
+    }
+    async initReconnectionManager() {
+        // Initialize reconnection manager
+        if (this.config.reconnection?.enabled !== false) {
+            this.reconnectionManager = new oReconnectionManager(this, {
+                enabled: true,
+                maxAttempts: this.config.reconnection?.maxAttempts ?? 10,
+                baseDelayMs: this.config.reconnection?.baseDelayMs ?? 5000,
+                maxDelayMs: this.config.reconnection?.maxDelayMs ?? 60000,
+                useLeaderFallback: this.config.reconnection?.useLeaderFallback ?? true,
+                parentDiscoveryIntervalMs: this.config.reconnection?.parentDiscoveryIntervalMs ?? 10000,
+                parentDiscoveryMaxDelayMs: this.config.reconnection?.parentDiscoveryMaxDelayMs ?? 60000,
+            });
+        }
+    }
+    async hookInitializeFinished() { }
+    async hookStartFinished() {
+        // Initialize connection heartbeat manager
+        this.connectionHeartbeatManager = new oConnectionHeartbeatManager(this, {
+            enabled: this.config.connectionHeartbeat?.enabled ?? true,
+            intervalMs: this.config.connectionHeartbeat?.intervalMs ?? 15000,
+            timeoutMs: this.config.connectionHeartbeat?.timeoutMs ?? 15000,
+            failureThreshold: this.config.connectionHeartbeat?.failureThreshold ?? 3,
+            checkChildren: this.config.connectionHeartbeat?.checkChildren ?? false,
+            checkParent: this.config.connectionHeartbeat?.checkParent ?? true,
+            checkLeader: true,
+        });
+        this.logger.info(`Connection heartbeat config: leader=${this.connectionHeartbeatManager.getConfig().checkLeader}, ` +
+            `parent=${this.connectionHeartbeatManager.getConfig().checkParent}`);
+    }
     async initialize() {
         this.logger.debug('Initializing node...');
         if (this.p2pNode && this.state !== NodeState.STOPPED) {
@@ -256,13 +350,13 @@ export class oNode extends oToolBase {
         }
         await this.createNode();
         await this.initializeRouter();
+        // need to wait until our libpp2 node is initialized before calling super.initialize
+        await super.initialize();
         this.logger.debug('Node initialized!', this.transports.map((t) => t.toString()));
         this.address.setTransports(this.transports);
         this.peerId = this.p2pNode.peerId;
         // initialize connection manager
-        this.connectionManager = new oNodeConnectionManager({
-            p2pNode: this.p2pNode,
-        });
+        await this.initConnectionManager();
         // initialize address resolution
         this.router.addResolver(new oMethodResolver(this.address));
         this.router.addResolver(new oNodeResolver(this.address));
@@ -271,12 +365,130 @@ export class oNode extends oToolBase {
             this.logger.debug('Adding leader resolver fallback...');
             this.router.addResolver(new oLeaderResolverFallback(this.address));
         }
+        // initialize reconnection manager
+        await this.initReconnectionManager();
+        await this.hookInitializeFinished();
     }
+    /**
+     * Override use() to wrap leader/registry requests with retry logic
+     */
+    // async use(
+    //   address: oAddress,
+    //   data?: {
+    //     method?: string;
+    //     params?: { [key: string]: any };
+    //     id?: string;
+    //   },
+    //   options?: UseOptions,
+    // ): Promise<any> {
+    //   // Wrap leader/registry requests with retry logic
+    //   return super.use(address, data, options),
+    //     address,
+    //     data?.method,
+    // }
     async teardown() {
+        // Stop heartbeat before parent teardown
+        if (this.connectionHeartbeatManager) {
+            await this.connectionHeartbeatManager.stop();
+        }
         await this.unregister();
         await super.teardown();
         if (this.p2pNode) {
             await this.p2pNode.stop();
         }
     }
+    // IHeartbeatableNode interface methods
+    getLeaders() {
+        return [this.leader];
+    }
+    getParents() {
+        return this.hierarchyManager.getParents();
+    }
+    getChildren() {
+        return this.hierarchyManager.getChildren();
+    }
+    removeChild(childAddress) {
+        this.hierarchyManager.removeChild(childAddress);
+    }
+    /**
+     * Get the total number of active streams across all connections
+     * @returns Total count of active streams
+     */
+    getStreamCount() {
+        if (!this.p2pNode) {
+            return 0;
+        }
+        const connections = this.p2pNode.getConnections();
+        return connections.reduce((count, conn) => {
+            return count + (conn.streams?.length || 0);
+        }, 0);
+    }
+    /**
+     * Get libp2p metrics for this node
+     * Tool method that can be called remotely by monitoring systems
+     */
+    async _tool_get_libp2p_metrics(request) {
+        if (!this.p2pNode) {
+            return {
+                error: 'libp2p node not available',
+                available: false,
+            };
+        }
+        try {
+            // Get basic connection stats
+            const connections = this.p2pNode.getConnections();
+            const peers = await this.p2pNode.peerStore.all();
+            const inbound = connections.filter((c) => c.direction === 'inbound').length;
+            const outbound = connections.filter((c) => c.direction === 'outbound').length;
+            // Get DHT info if available
+            const services = this.p2pNode.services;
+            const dht = services?.dht;
+            const routingTable = dht?.routingTable;
+            const kBuckets = routingTable?.kb || null;
+            let routingTableSize = 0;
+            if (kBuckets) {
+                // Handle both array and object-like structures
+                if (Array.isArray(kBuckets)) {
+                    for (const bucket of kBuckets) {
+                        routingTableSize += bucket.peers?.length || 0;
+                    }
+                }
+                else if (typeof kBuckets === 'object') {
+                    // If it's an object, iterate over its values
+                    for (const bucket of Object.values(kBuckets)) {
+                        routingTableSize += bucket?.peers?.length || 0;
+                    }
+                }
+            }
+            // Calculate total stream count across all connections
+            const streamCount = connections.reduce((count, conn) => {
+                return count + (conn.streams?.length || 0);
+            }, 0);
+            return {
+                available: true,
+                timestamp: Date.now(),
+                nodeAddress: this.address.toString(),
+                peerCount: peers.length,
+                connectionCount: connections.length,
+                inboundConnections: inbound,
+                outboundConnections: outbound,
+                streamCount,
+                dhtEnabled: !!dht,
+                dhtMode: dht?.clientMode ? 'client' : 'server',
+                dhtRoutingTableSize: routingTableSize,
+                protocols: Array.from(this.p2pNode.getProtocols()),
+                selfPeerId: this.p2pNode.peerId.toString(),
+                multiaddrs: this.p2pNode
+                    .getMultiaddrs()
+                    .map((ma) => ma.toString()),
+            };
+        }
+        catch (error) {
+            return {
+                error: `Failed to collect libp2p metrics: ${error.message}`,
+                available: false,
+                nodeAddress: this.address.toString(),
+            };
+        }
+    }
 }

package/dist/src/o-node.notification-manager.d.ts

@@ -0,0 +1,52 @@
+import { Libp2p } from '@olane/o-config';
+import { oNotificationManager } from '@olane/o-core';
+import { oNodeAddress } from './router/o-node.address.js';
+import { oNodeHierarchyManager } from './o-node.hierarchy-manager.js';
+/**
+ * libp2p-specific implementation of oNotificationManager
+ * Wraps libp2p events and enriches them with Olane context
+ */
+export declare class oNodeNotificationManager extends oNotificationManager {
+    private p2pNode;
+    private hierarchyManager;
+    private address;
+    constructor(p2pNode: Libp2p, hierarchyManager: oNodeHierarchyManager, address: oNodeAddress);
+    /**
+     * Wire up libp2p event listeners
+     */
+    protected setupListeners(): void;
+    /**
+     * Handle peer connect event from libp2p
+     */
+    private handlePeerConnect;
+    /**
+     * Handle peer disconnect event from libp2p
+     */
+    private handlePeerDisconnect;
+    /**
+     * Handle peer discovery event from libp2p
+     */
+    private handlePeerDiscovery;
+    /**
+     * Handle connection open event from libp2p
+     */
+    private handleConnectionOpen;
+    /**
+     * Handle connection close event from libp2p
+     */
+    private handleConnectionClose;
+    /**
+     * Try to resolve a libp2p peer ID to an Olane address
+     * Checks hierarchy manager for known peers
+     */
+    private peerIdToAddress;
+    /**
+     * Check if an address is a direct child
+     */
+    private isChild;
+    /**
+     * Check if an address is a parent
+     */
+    private isParent;
+}
+//# sourceMappingURL=o-node.notification-manager.d.ts.map

package/dist/src/o-node.notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-node.notification-manager.d.ts","sourceRoot":"","sources":["../../src/o-node.notification-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,oBAAoB,EAQrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;IAE9D,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,OAAO;gBAFP,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,qBAAqB,EACvC,OAAO,EAAE,YAAY;IAK/B;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAgChC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,QAAQ;CAKjB"}