@shadow-corp/nearconnect 1.0.0

package/build/helpers/analytics.d.ts

@@ -0,0 +1,191 @@
+import { EventMap, Account, Network } from "../types";
+import { WalletError } from "../errors";
+/**
+ * Analytics event types that can be tracked
+ */
+export type AnalyticsEventType = "wallet_connect_started" | "wallet_connect_success" | "wallet_connect_failed" | "wallet_disconnect" | "transaction_started" | "transaction_success" | "transaction_failed" | "transaction_rejected" | "message_sign_started" | "message_sign_success" | "message_sign_failed" | "account_switched" | "account_added" | "account_removed" | "network_switched" | "session_restored" | "session_expired" | "modal_opened" | "modal_closed" | "error";
+/**
+ * Base analytics event payload
+ */
+export interface AnalyticsEvent {
+    type: AnalyticsEventType;
+    timestamp: number;
+    sessionId?: string;
+    network?: Network;
+    walletId?: string;
+    walletName?: string;
+    accountId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Wallet connect event
+ */
+export interface WalletConnectEvent extends AnalyticsEvent {
+    type: "wallet_connect_started" | "wallet_connect_success" | "wallet_connect_failed";
+    accounts?: Account[];
+    duration?: number;
+    error?: string;
+}
+/**
+ * Transaction event
+ */
+export interface TransactionEvent extends AnalyticsEvent {
+    type: "transaction_started" | "transaction_success" | "transaction_failed" | "transaction_rejected";
+    receiverId?: string;
+    methodName?: string;
+    txHash?: string;
+    gasUsed?: string;
+    deposit?: string;
+    duration?: number;
+    error?: string;
+}
+/**
+ * Analytics adapter interface - implement to send events to your analytics service
+ */
+export interface AnalyticsAdapter {
+    /**
+     * Track an analytics event
+     */
+    track(event: AnalyticsEvent): void | Promise<void>;
+    /**
+     * Identify a user (optional)
+     */
+    identify?(userId: string, traits?: Record<string, unknown>): void | Promise<void>;
+    /**
+     * Flush any pending events (optional)
+     */
+    flush?(): void | Promise<void>;
+}
+/**
+ * Console adapter for debugging
+ */
+export declare class ConsoleAnalyticsAdapter implements AnalyticsAdapter {
+    private prefix;
+    constructor(prefix?: string);
+    track(event: AnalyticsEvent): void;
+    identify(userId: string, traits?: Record<string, unknown>): void;
+}
+/**
+ * No-op adapter (default)
+ */
+export declare class NoopAnalyticsAdapter implements AnalyticsAdapter {
+    track(): void;
+    identify(): void;
+    flush(): void;
+}
+/**
+ * Batching adapter that collects events and sends them in batches
+ */
+export declare class BatchingAnalyticsAdapter implements AnalyticsAdapter {
+    private adapter;
+    private queue;
+    private batchSize;
+    private flushInterval;
+    private timer;
+    constructor(adapter: AnalyticsAdapter, options?: {
+        batchSize?: number;
+        flushInterval?: number;
+    });
+    track(event: AnalyticsEvent): void;
+    flush(): Promise<void>;
+    destroy(): void;
+}
+/**
+ * Analytics options
+ */
+export interface AnalyticsOptions {
+    adapter?: AnalyticsAdapter;
+    sessionId?: string;
+    defaultMetadata?: Record<string, unknown>;
+    enabled?: boolean;
+}
+/**
+ * Analytics manager for tracking wallet events
+ */
+export declare class Analytics {
+    private adapter;
+    private sessionId;
+    private defaultMetadata;
+    private enabled;
+    private timers;
+    constructor(options?: AnalyticsOptions);
+    private generateSessionId;
+    /**
+     * Track a generic event
+     */
+    track(type: AnalyticsEventType, data?: Partial<Omit<AnalyticsEvent, "type" | "timestamp" | "sessionId">>): void;
+    /**
+     * Start a timer for duration tracking
+     */
+    startTimer(key: string): void;
+    /**
+     * Get elapsed time and clear timer
+     */
+    endTimer(key: string): number | undefined;
+    /**
+     * Track wallet connection start
+     */
+    trackConnectStarted(walletId: string, walletName?: string, network?: Network): void;
+    /**
+     * Track successful wallet connection
+     */
+    trackConnectSuccess(walletId: string, accounts: Account[], walletName?: string, network?: Network): void;
+    /**
+     * Track failed wallet connection
+     */
+    trackConnectFailed(walletId: string, error: Error | WalletError, walletName?: string): void;
+    /**
+     * Track wallet disconnect
+     */
+    trackDisconnect(walletId?: string, accountId?: string): void;
+    /**
+     * Track transaction start
+     */
+    trackTransactionStarted(walletId: string, receiverId: string, methodName?: string, deposit?: string): void;
+    /**
+     * Track successful transaction
+     */
+    trackTransactionSuccess(walletId: string, receiverId: string, txHash?: string, methodName?: string): void;
+    /**
+     * Track failed transaction
+     */
+    trackTransactionFailed(walletId: string, receiverId: string, error: Error | WalletError, methodName?: string): void;
+    /**
+     * Track rejected transaction
+     */
+    trackTransactionRejected(walletId: string, receiverId: string, methodName?: string): void;
+    /**
+     * Track account switch
+     */
+    trackAccountSwitched(accountId: string, previousAccountId?: string | null, walletId?: string): void;
+    /**
+     * Track network switch
+     */
+    trackNetworkSwitched(network: Network, previousNetwork?: Network): void;
+    /**
+     * Track error
+     */
+    trackError(error: Error | WalletError, context?: string): void;
+    /**
+     * Identify user
+     */
+    identify(accountId: string, traits?: Record<string, unknown>): void;
+    /**
+     * Flush pending events
+     */
+    flush(): void;
+    /**
+     * Set enabled state
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Update default metadata
+     */
+    setDefaultMetadata(metadata: Record<string, unknown>): void;
+    /**
+     * Create event handlers for NearConnector events
+     */
+    createEventHandlers(): Partial<{
+        [K in keyof EventMap]: (payload: EventMap[K]) => void;
+    }>;
+}

package/build/helpers/analytics.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Analytics = exports.BatchingAnalyticsAdapter = exports.NoopAnalyticsAdapter = exports.ConsoleAnalyticsAdapter = void 0;
+const errors_1 = require("../errors");
+/**
+ * Console adapter for debugging
+ */
+class ConsoleAnalyticsAdapter {
+    prefix;
+    constructor(prefix = "[Analytics]") {
+        this.prefix = prefix;
+    }
+    track(event) {
+        console.log(this.prefix, event.type, event);
+    }
+    identify(userId, traits) {
+        console.log(this.prefix, "identify", userId, traits);
+    }
+}
+exports.ConsoleAnalyticsAdapter = ConsoleAnalyticsAdapter;
+/**
+ * No-op adapter (default)
+ */
+class NoopAnalyticsAdapter {
+    track() { }
+    identify() { }
+    flush() { }
+}
+exports.NoopAnalyticsAdapter = NoopAnalyticsAdapter;
+/**
+ * Batching adapter that collects events and sends them in batches
+ */
+class BatchingAnalyticsAdapter {
+    adapter;
+    queue = [];
+    batchSize;
+    flushInterval;
+    timer = null;
+    constructor(adapter, options = {}) {
+        this.adapter = adapter;
+        this.batchSize = options.batchSize ?? 10;
+        this.flushInterval = options.flushInterval ?? 5000;
+        if (typeof window !== "undefined") {
+            this.timer = setInterval(() => this.flush(), this.flushInterval);
+        }
+    }
+    track(event) {
+        this.queue.push(event);
+        if (this.queue.length >= this.batchSize) {
+            this.flush();
+        }
+    }
+    async flush() {
+        if (this.queue.length === 0)
+            return;
+        const events = [...this.queue];
+        this.queue = [];
+        for (const event of events) {
+            await this.adapter.track(event);
+        }
+        await this.adapter.flush?.();
+    }
+    destroy() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.flush();
+    }
+}
+exports.BatchingAnalyticsAdapter = BatchingAnalyticsAdapter;
+/**
+ * Analytics manager for tracking wallet events
+ */
+class Analytics {
+    adapter;
+    sessionId;
+    defaultMetadata;
+    enabled;
+    timers = new Map();
+    constructor(options = {}) {
+        this.adapter = options.adapter ?? new NoopAnalyticsAdapter();
+        this.sessionId = options.sessionId ?? this.generateSessionId();
+        this.defaultMetadata = options.defaultMetadata ?? {};
+        this.enabled = options.enabled ?? true;
+    }
+    generateSessionId() {
+        return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+    }
+    /**
+     * Track a generic event
+     */
+    track(type, data = {}) {
+        if (!this.enabled)
+            return;
+        const event = {
+            type,
+            timestamp: Date.now(),
+            sessionId: this.sessionId,
+            metadata: { ...this.defaultMetadata, ...data.metadata },
+            ...data,
+        };
+        this.adapter.track(event);
+    }
+    /**
+     * Start a timer for duration tracking
+     */
+    startTimer(key) {
+        this.timers.set(key, Date.now());
+    }
+    /**
+     * Get elapsed time and clear timer
+     */
+    endTimer(key) {
+        const start = this.timers.get(key);
+        if (!start)
+            return undefined;
+        this.timers.delete(key);
+        return Date.now() - start;
+    }
+    /**
+     * Track wallet connection start
+     */
+    trackConnectStarted(walletId, walletName, network) {
+        this.startTimer(`connect:${walletId}`);
+        this.track("wallet_connect_started", { walletId, walletName, network });
+    }
+    /**
+     * Track successful wallet connection
+     */
+    trackConnectSuccess(walletId, accounts, walletName, network) {
+        const duration = this.endTimer(`connect:${walletId}`);
+        this.track("wallet_connect_success", {
+            walletId,
+            walletName,
+            network,
+            accountId: accounts[0]?.accountId,
+            metadata: { accountCount: accounts.length, duration },
+        });
+    }
+    /**
+     * Track failed wallet connection
+     */
+    trackConnectFailed(walletId, error, walletName) {
+        const duration = this.endTimer(`connect:${walletId}`);
+        this.track("wallet_connect_failed", {
+            walletId,
+            walletName,
+            metadata: {
+                error: error.message,
+                errorCode: error instanceof errors_1.WalletError ? error.code : undefined,
+                duration,
+            },
+        });
+    }
+    /**
+     * Track wallet disconnect
+     */
+    trackDisconnect(walletId, accountId) {
+        this.track("wallet_disconnect", { walletId, accountId });
+    }
+    /**
+     * Track transaction start
+     */
+    trackTransactionStarted(walletId, receiverId, methodName, deposit) {
+        const key = `tx:${walletId}:${receiverId}:${methodName}`;
+        this.startTimer(key);
+        this.track("transaction_started", {
+            walletId,
+            metadata: { receiverId, methodName, deposit },
+        });
+    }
+    /**
+     * Track successful transaction
+     */
+    trackTransactionSuccess(walletId, receiverId, txHash, methodName) {
+        const key = `tx:${walletId}:${receiverId}:${methodName}`;
+        const duration = this.endTimer(key);
+        this.track("transaction_success", {
+            walletId,
+            metadata: { receiverId, methodName, txHash, duration },
+        });
+    }
+    /**
+     * Track failed transaction
+     */
+    trackTransactionFailed(walletId, receiverId, error, methodName) {
+        const key = `tx:${walletId}:${receiverId}:${methodName}`;
+        const duration = this.endTimer(key);
+        this.track("transaction_failed", {
+            walletId,
+            metadata: {
+                receiverId,
+                methodName,
+                error: error.message,
+                errorCode: error instanceof errors_1.WalletError ? error.code : undefined,
+                duration,
+            },
+        });
+    }
+    /**
+     * Track rejected transaction
+     */
+    trackTransactionRejected(walletId, receiverId, methodName) {
+        const key = `tx:${walletId}:${receiverId}:${methodName}`;
+        const duration = this.endTimer(key);
+        this.track("transaction_rejected", {
+            walletId,
+            metadata: { receiverId, methodName, duration },
+        });
+    }
+    /**
+     * Track account switch
+     */
+    trackAccountSwitched(accountId, previousAccountId, walletId) {
+        this.track("account_switched", {
+            accountId,
+            walletId,
+            metadata: { previousAccountId },
+        });
+    }
+    /**
+     * Track network switch
+     */
+    trackNetworkSwitched(network, previousNetwork) {
+        this.track("network_switched", {
+            network,
+            metadata: { previousNetwork },
+        });
+    }
+    /**
+     * Track error
+     */
+    trackError(error, context) {
+        this.track("error", {
+            metadata: {
+                error: error.message,
+                errorCode: error instanceof errors_1.WalletError ? error.code : undefined,
+                context,
+                stack: error.stack,
+            },
+        });
+    }
+    /**
+     * Identify user
+     */
+    identify(accountId, traits) {
+        if (!this.enabled)
+            return;
+        this.adapter.identify?.(accountId, traits);
+    }
+    /**
+     * Flush pending events
+     */
+    flush() {
+        this.adapter.flush?.();
+    }
+    /**
+     * Set enabled state
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Update default metadata
+     */
+    setDefaultMetadata(metadata) {
+        this.defaultMetadata = { ...this.defaultMetadata, ...metadata };
+    }
+    /**
+     * Create event handlers for NearConnector events
+     */
+    createEventHandlers() {
+        return {
+            "wallet:signIn": ({ wallet, accounts }) => {
+                this.trackConnectSuccess(wallet.manifest.id, accounts, wallet.manifest.name);
+            },
+            "wallet:signOut": () => {
+                this.trackDisconnect();
+            },
+            "wallet:error": ({ error, walletId, action }) => {
+                this.trackError(error, `${action}:${walletId}`);
+            },
+            "account:switched": ({ account, previousAccountId }) => {
+                this.trackAccountSwitched(account.accountId, previousAccountId);
+            },
+            "session:restored": ({ session }) => {
+                this.track("session_restored", {
+                    walletId: session.walletId,
+                    accountId: session.accounts[0]?.accountId,
+                    network: session.network,
+                });
+            },
+            "session:expired": ({ session }) => {
+                this.track("session_expired", {
+                    walletId: session.walletId,
+                    accountId: session.accounts[0]?.accountId,
+                });
+            },
+        };
+    }
+}
+exports.Analytics = Analytics;
+//# sourceMappingURL=analytics.js.map

package/build/helpers/analytics.js.map

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

package/build/helpers/base58.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Encodes a Uint8Array into a base58 string.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+export declare function encodeBase58(bytes: Uint8Array): string;

package/build/helpers/base58.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeBase58 = encodeBase58;
+// Base58 alphabet (Bitcoin)
+const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+/**
+ * Encodes a Uint8Array into a base58 string.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+function encodeBase58(bytes) {
+    if (bytes.length === 0)
+        return "";
+    // Count leading zeros.
+    let zeros = 0;
+    let i = 0;
+    while (i < bytes.length && bytes[i] === 0) {
+        zeros++;
+        i++;
+    }
+    // Convert byte array to base58 digits (big-endian).
+    let digits = [0];
+    for (; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = 0; j < digits.length; ++j) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = (carry / 58) | 0;
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = (carry / 58) | 0;
+        }
+    }
+    // Add leading zeros in base58.
+    while (digits.length > 0 && digits[digits.length - 1] === 0)
+        digits.pop();
+    let result = "";
+    for (let k = 0; k < zeros; k++) {
+        result += BASE58_ALPHABET[0];
+    }
+    for (let q = digits.length - 1; q >= 0; --q) {
+        result += BASE58_ALPHABET[digits[q]];
+    }
+    return result;
+}
+//# sourceMappingURL=base58.js.map

package/build/helpers/base58.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../../src/helpers/base58.ts"],"names":[],"mappings":";;AAQA,oCAqCC;AA7CD,4BAA4B;AAC5B,MAAM,eAAe,GAAG,4DAA4D,CAAC;AAErF;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAAiB;IAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,uBAAuB;IACvB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,KAAK,EAAE,CAAC;QACR,CAAC,EAAE,CAAC;IACN,CAAC;IAED,oDAAoD;IACpD,IAAI,MAAM,GAAa,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,KAAK,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACxB,KAAK,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IAE1E,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/helpers/events.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Generic event emitter class for handling typed events and their callbacks
+ * @template T Record type containing event names as keys and their payload types as values
+ */
+export declare class EventEmitter<T extends Record<string, any>> {
+    /** Internal storage for event callbacks */
+    private events;
+    /**
+     * Subscribe to an event
+     * @template K Event name type
+     * @param event Name of the event to subscribe to
+     * @param callback Function to be called when event is emitted
+     */
+    on<K extends keyof T>(event: K, callback: (payload: T[K]) => void): void;
+    /**
+     * Emit an event with payload
+     * @template K Event name type
+     * @param event Name of the event to emit
+     * @param payload Data to pass to event handlers
+     */
+    emit<K extends keyof T>(event: K, payload: T[K]): void;
+    /**
+     * Unsubscribe from an event
+     * @template K Event name type
+     * @param event Name of the event to unsubscribe from
+     * @param callback Function to remove from event handlers
+     */
+    off<K extends keyof T>(event: K, callback: (payload: T[K]) => void): void;
+    /**
+     * Subscribe to an event for a single emission
+     * @template K Event name type
+     * @param event Name of the event to subscribe to
+     * @param callback Function to be called when event is emitted
+     */
+    once<K extends keyof T>(event: K, callback: (payload: T[K]) => void): void;
+    /**
+     * Remove all event listeners
+     * @template K Event name type
+     * @param event Optional event name to remove listeners for. If not provided, removes all listeners for all events
+     */
+    removeAllListeners<K extends keyof T>(event?: K): void;
+}

package/build/helpers/events.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
+/**
+ * Generic event emitter class for handling typed events and their callbacks
+ * @template T Record type containing event names as keys and their payload types as values
+ */
+class EventEmitter {
+    /** Internal storage for event callbacks */
+    events = {};
+    /**
+     * Subscribe to an event
+     * @template K Event name type
+     * @param event Name of the event to subscribe to
+     * @param callback Function to be called when event is emitted
+     */
+    on(event, callback) {
+        if (!this.events[event])
+            this.events[event] = [];
+        this.events[event].push(callback);
+    }
+    /**
+     * Emit an event with payload
+     * @template K Event name type
+     * @param event Name of the event to emit
+     * @param payload Data to pass to event handlers
+     */
+    emit(event, payload) {
+        this.events[event]?.forEach((cb) => cb(payload));
+    }
+    /**
+     * Unsubscribe from an event
+     * @template K Event name type
+     * @param event Name of the event to unsubscribe from
+     * @param callback Function to remove from event handlers
+     */
+    off(event, callback) {
+        this.events[event] = this.events[event]?.filter((cb) => cb !== callback);
+    }
+    /**
+     * Subscribe to an event for a single emission
+     * @template K Event name type
+     * @param event Name of the event to subscribe to
+     * @param callback Function to be called when event is emitted
+     */
+    once(event, callback) {
+        const onceWrapper = (payload) => {
+            callback(payload);
+            this.off(event, onceWrapper);
+        };
+        this.on(event, onceWrapper);
+    }
+    /**
+     * Remove all event listeners
+     * @template K Event name type
+     * @param event Optional event name to remove listeners for. If not provided, removes all listeners for all events
+     */
+    removeAllListeners(event) {
+        if (event) {
+            delete this.events[event];
+        }
+        else {
+            this.events = {};
+        }
+    }
+}
+exports.EventEmitter = EventEmitter;
+//# sourceMappingURL=events.js.map

package/build/helpers/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/helpers/events.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,YAAY;IACvB,2CAA2C;IACnC,MAAM,GAA4D,EAAE,CAAC;IAE7E;;;;;OAKG;IACH,EAAE,CAAoB,KAAQ,EAAE,QAAiC;QAC/D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAoB,KAAQ,EAAE,OAAa;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAoB,KAAQ,EAAE,QAAiC;QAChE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAoB,KAAQ,EAAE,QAAiC;QACjE,MAAM,WAAW,GAAG,CAAC,OAAa,EAAE,EAAE;YACpC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAoB,KAAS;QAC7C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AA7DD,oCA6DC"}