@rotateprotocol/sdk 1.0.0

package/dist/platform.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Rotate Platform Manager — Merchant Onboarding & Platform Administration
+ *
+ * A high-level SDK layer for platform operators to onboard merchants,
+ * manage their accounts, and monitor platform-wide activity.
+ *
+ * The platform admin wallet is the signer — merchants don't need to
+ * interact with the SDK directly. The platform creates merchant accounts
+ * on their behalf, and merchants just receive payments to their wallet.
+ *
+ * @example
+ * ```ts
+ * import { RotateSDK, RotatePlatformManager } from '@rotateprotocol/sdk';
+ *
+ * const sdk = new RotateSDK({ connection, wallet });
+ *
+ * // Create a platform first (one-time setup)
+ * const { platformId } = await sdk.createPlatform({ feeBps: 500, wallet: adminWallet });
+ *
+ * // Then use the manager for ongoing operations
+ * const platform = new RotatePlatformManager(sdk, { platformId });
+ *
+ * // Onboard a single merchant
+ * const merchant = await platform.onboardMerchant({
+ *   wallet: new PublicKey('merchant-wallet-address'),
+ *   name: 'Coffee Shop',
+ * });
+ * console.log(`Merchant created: #${merchant.merchantId}`);
+ *
+ * // Bulk onboard merchants
+ * const results = await platform.onboardMerchants([
+ *   { wallet: walletA, name: 'Store A' },
+ *   { wallet: walletB, name: 'Store B' },
+ *   { wallet: walletC, name: 'Store C' },
+ * ]);
+ *
+ * // Get all merchants on the platform
+ * const merchants = await platform.getMerchants();
+ *
+ * // Get platform stats
+ * const stats = await platform.getStats();
+ * console.log(`Total merchants: ${stats.merchantCount}`);
+ * console.log(`Fee revenue: $${stats.feeRevenue.toFixed(2)}`);
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { PublicKey } from '@solana/web3.js';
+import RotateSDK, { Platform } from './index';
+/** Configuration for the platform manager */
+export interface PlatformManagerConfig {
+    /** Your platform ID (from createPlatform) */
+    platformId: number;
+}
+/** Input for onboarding a single merchant */
+export interface OnboardMerchantInput {
+    /** The merchant's Solana wallet address (where they receive payments) */
+    wallet: PublicKey;
+    /** Optional display name for the merchant (stored locally, not on-chain) */
+    name?: string;
+    /** Optional metadata (e.g. email, store URL, category) */
+    metadata?: Record<string, string>;
+}
+/** Result of onboarding a merchant */
+export interface OnboardMerchantResult {
+    /** The assigned on-chain merchant ID */
+    merchantId: number;
+    /** Transaction signature */
+    tx: string;
+    /** The merchant's wallet address */
+    wallet: PublicKey;
+    /** Display name (if provided) */
+    name?: string;
+    /** Metadata (if provided) */
+    metadata?: Record<string, string>;
+}
+/** Result of a bulk onboarding operation */
+export interface BulkOnboardResult {
+    /** Successfully onboarded merchants */
+    succeeded: OnboardMerchantResult[];
+    /** Failed onboardings */
+    failed: Array<{
+        input: OnboardMerchantInput;
+        error: string;
+    }>;
+}
+/** Merchant info with on-chain and local data */
+export interface MerchantInfo {
+    /** On-chain merchant ID */
+    merchantId: number;
+    /** Platform ID this merchant belongs to */
+    platformId: number;
+    /** Merchant wallet address */
+    wallet: PublicKey;
+    /** Whether the merchant is active */
+    active: boolean;
+    /** Display name (local only) */
+    name?: string;
+    /** Metadata (local only) */
+    metadata?: Record<string, string>;
+}
+/** Platform-wide statistics */
+export interface PlatformStats {
+    /** Platform ID */
+    platformId: number;
+    /** Platform fee in basis points */
+    feeBps: number;
+    /** Platform fee as percentage string (e.g. "5.0%") */
+    feePercent: string;
+    /** Total merchants on the platform */
+    merchantCount: number;
+    /** Platform admin wallet */
+    adminWallet: PublicKey;
+    /** Platform payment wallet */
+    paymentWallet: PublicKey;
+    /** Whether the platform is active */
+    active: boolean;
+    /** Total payment links created (across all merchants tracked locally) */
+    totalLinks: number;
+    /** Total volume (USD) across tracked merchants */
+    totalVolume: number;
+    /** Estimated platform fee revenue */
+    feeRevenue: number;
+    /** Protocol fee (always 3%) */
+    protocolFeeBps: number;
+}
+export declare class RotatePlatformManager {
+    private sdk;
+    private platformId;
+    /** Local merchant directory (name + metadata). Persists only in memory. */
+    private merchantDirectory;
+    constructor(sdk: RotateSDK, config: PlatformManagerConfig);
+    /**
+     * Onboard a single merchant onto the platform.
+     *
+     * The platform admin's wallet signs the transaction and pays the account
+     * creation fee (~0.001 SOL). The merchant just needs a wallet address.
+     *
+     * @param input - Merchant wallet and optional name/metadata
+     * @returns The created merchant's ID, tx, and details
+     */
+    onboardMerchant(input: OnboardMerchantInput): Promise<OnboardMerchantResult>;
+    /**
+     * Bulk onboard multiple merchants in sequence.
+     *
+     * Each merchant gets its own transaction. If one fails, the rest continue.
+     * Returns both succeeded and failed results so the caller can handle retries.
+     *
+     * @param inputs - Array of merchant onboarding inputs
+     * @param options - Optional configuration
+     * @returns Succeeded and failed results
+     */
+    onboardMerchants(inputs: OnboardMerchantInput[], options?: {
+        /** Called after each merchant (for progress tracking) */
+        onProgress?: (completed: number, total: number, latest: OnboardMerchantResult | null) => void;
+        /** Stop on first failure */
+        stopOnError?: boolean;
+    }): Promise<BulkOnboardResult>;
+    /**
+     * Get on-chain info for a specific merchant.
+     */
+    getMerchant(merchantId: number): Promise<MerchantInfo | null>;
+    /**
+     * Fetch all merchants belonging to this platform.
+     *
+     * Uses `getProgramAccounts` with a `memcmp` filter on `platform_id`
+     * for efficient single-RPC retrieval instead of scanning every merchant
+     * PDA sequentially.
+     *
+     * @param options - Optional filters
+     * @returns Array of merchant info
+     */
+    getMerchants(options?: {
+        /** Only return active merchants */
+        activeOnly?: boolean;
+        /** Maximum number of merchants to return */
+        limit?: number;
+    }): Promise<MerchantInfo[]>;
+    /**
+     * Update the local directory entry for a merchant (name/metadata).
+     * Does NOT modify on-chain data.
+     */
+    setMerchantInfo(merchantId: number, info: {
+        name?: string;
+        metadata?: Record<string, string>;
+    }): void;
+    /**
+     * Get the on-chain platform account data.
+     */
+    getPlatform(): Promise<Platform | null>;
+    /**
+     * Update platform fee rate and/or active status.
+     * Only the platform admin wallet can call this.
+     *
+     * @param feeBps - New fee in basis points (0-600)
+     * @param active - Whether the platform is active
+     * @param newWallet - Optional new wallet for fee collection (defaults to current)
+     */
+    updatePlatform(feeBps: number, active?: boolean, newWallet?: PublicKey): Promise<string>;
+    /**
+     * Get platform-wide statistics.
+     *
+     * Uses `getProgramAccounts` for efficient merchant counting instead of
+     * scanning every merchant ID sequentially.
+     */
+    getStats(): Promise<PlatformStats>;
+    /**
+     * Generate a checkout URL for a merchant's payment link.
+     */
+    getCheckoutUrl(linkId: number): string;
+    /**
+     * Get the platform ID.
+     */
+    getPlatformId(): number;
+    /**
+     * Export the local merchant directory as JSON.
+     * Use this to persist merchant names/metadata to your database.
+     */
+    exportDirectory(): Array<{
+        merchantId: number;
+        name?: string;
+        metadata?: Record<string, string>;
+    }>;
+    /**
+     * Import a previously exported merchant directory.
+     */
+    importDirectory(entries: Array<{
+        merchantId: number;
+        name?: string;
+        metadata?: Record<string, string>;
+    }>): void;
+}
+export default RotatePlatformManager;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

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

package/dist/platform.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Rotate Platform Manager — Merchant Onboarding & Platform Administration
+ *
+ * A high-level SDK layer for platform operators to onboard merchants,
+ * manage their accounts, and monitor platform-wide activity.
+ *
+ * The platform admin wallet is the signer — merchants don't need to
+ * interact with the SDK directly. The platform creates merchant accounts
+ * on their behalf, and merchants just receive payments to their wallet.
+ *
+ * @example
+ * ```ts
+ * import { RotateSDK, RotatePlatformManager } from '@rotateprotocol/sdk';
+ *
+ * const sdk = new RotateSDK({ connection, wallet });
+ *
+ * // Create a platform first (one-time setup)
+ * const { platformId } = await sdk.createPlatform({ feeBps: 500, wallet: adminWallet });
+ *
+ * // Then use the manager for ongoing operations
+ * const platform = new RotatePlatformManager(sdk, { platformId });
+ *
+ * // Onboard a single merchant
+ * const merchant = await platform.onboardMerchant({
+ *   wallet: new PublicKey('merchant-wallet-address'),
+ *   name: 'Coffee Shop',
+ * });
+ * console.log(`Merchant created: #${merchant.merchantId}`);
+ *
+ * // Bulk onboard merchants
+ * const results = await platform.onboardMerchants([
+ *   { wallet: walletA, name: 'Store A' },
+ *   { wallet: walletB, name: 'Store B' },
+ *   { wallet: walletC, name: 'Store C' },
+ * ]);
+ *
+ * // Get all merchants on the platform
+ * const merchants = await platform.getMerchants();
+ *
+ * // Get platform stats
+ * const stats = await platform.getStats();
+ * console.log(`Total merchants: ${stats.merchantCount}`);
+ * console.log(`Fee revenue: $${stats.feeRevenue.toFixed(2)}`);
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RotatePlatformManager = void 0;
+const index_1 = require("./index");
+// ==================== PLATFORM MANAGER ====================
+class RotatePlatformManager {
+    constructor(sdk, config) {
+        /** Local merchant directory (name + metadata). Persists only in memory. */
+        this.merchantDirectory = new Map();
+        this.sdk = sdk;
+        this.platformId = config.platformId;
+    }
+    // ==================== MERCHANT ONBOARDING ====================
+    /**
+     * Onboard a single merchant onto the platform.
+     *
+     * The platform admin's wallet signs the transaction and pays the account
+     * creation fee (~0.001 SOL). The merchant just needs a wallet address.
+     *
+     * @param input - Merchant wallet and optional name/metadata
+     * @returns The created merchant's ID, tx, and details
+     */
+    async onboardMerchant(input) {
+        const { tx, merchantId } = await this.sdk.createMerchant({
+            platformId: this.platformId,
+            wallet: input.wallet,
+        });
+        // Store local directory info
+        if (input.name || input.metadata) {
+            this.merchantDirectory.set(merchantId, {
+                name: input.name,
+                metadata: input.metadata,
+            });
+        }
+        return {
+            merchantId,
+            tx,
+            wallet: input.wallet,
+            name: input.name,
+            metadata: input.metadata,
+        };
+    }
+    /**
+     * Bulk onboard multiple merchants in sequence.
+     *
+     * Each merchant gets its own transaction. If one fails, the rest continue.
+     * Returns both succeeded and failed results so the caller can handle retries.
+     *
+     * @param inputs - Array of merchant onboarding inputs
+     * @param options - Optional configuration
+     * @returns Succeeded and failed results
+     */
+    async onboardMerchants(inputs, options) {
+        const succeeded = [];
+        const failed = [];
+        for (let i = 0; i < inputs.length; i++) {
+            try {
+                const result = await this.onboardMerchant(inputs[i]);
+                succeeded.push(result);
+                options?.onProgress?.(i + 1, inputs.length, result);
+            }
+            catch (err) {
+                const errorMsg = err?.message || String(err);
+                failed.push({ input: inputs[i], error: errorMsg });
+                options?.onProgress?.(i + 1, inputs.length, null);
+                if (options?.stopOnError)
+                    break;
+            }
+        }
+        return { succeeded, failed };
+    }
+    // ==================== MERCHANT MANAGEMENT ====================
+    /**
+     * Get on-chain info for a specific merchant.
+     */
+    async getMerchant(merchantId) {
+        const merchant = await this.sdk.getMerchant(merchantId);
+        if (!merchant)
+            return null;
+        const local = this.merchantDirectory.get(merchantId);
+        return {
+            merchantId: merchant.id,
+            platformId: merchant.platformId,
+            wallet: merchant.wallet,
+            active: merchant.active,
+            name: local?.name,
+            metadata: local?.metadata,
+        };
+    }
+    /**
+     * Fetch all merchants belonging to this platform.
+     *
+     * Uses `getProgramAccounts` with a `memcmp` filter on `platform_id`
+     * for efficient single-RPC retrieval instead of scanning every merchant
+     * PDA sequentially.
+     *
+     * @param options - Optional filters
+     * @returns Array of merchant info
+     */
+    async getMerchants(options) {
+        const onChainMerchants = await this.sdk.getMerchantsByPlatform(this.platformId, options?.activeOnly ?? false);
+        let results = onChainMerchants.map((merchant) => {
+            const local = this.merchantDirectory.get(merchant.id);
+            return {
+                merchantId: merchant.id,
+                platformId: merchant.platformId,
+                wallet: merchant.wallet,
+                active: merchant.active,
+                name: local?.name,
+                metadata: local?.metadata,
+            };
+        });
+        if (options?.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    /**
+     * Update the local directory entry for a merchant (name/metadata).
+     * Does NOT modify on-chain data.
+     */
+    setMerchantInfo(merchantId, info) {
+        const existing = this.merchantDirectory.get(merchantId) || {};
+        this.merchantDirectory.set(merchantId, {
+            name: info.name ?? existing.name,
+            metadata: info.metadata ?? existing.metadata,
+        });
+    }
+    // ==================== PLATFORM INFO ====================
+    /**
+     * Get the on-chain platform account data.
+     */
+    async getPlatform() {
+        return this.sdk.getPlatform(this.platformId);
+    }
+    /**
+     * Update platform fee rate and/or active status.
+     * Only the platform admin wallet can call this.
+     *
+     * @param feeBps - New fee in basis points (0-600)
+     * @param active - Whether the platform is active
+     * @param newWallet - Optional new wallet for fee collection (defaults to current)
+     */
+    async updatePlatform(feeBps, active = true, newWallet) {
+        const platform = await this.getPlatform();
+        if (!platform)
+            throw new Error(`Platform #${this.platformId} not found`);
+        return this.sdk.updatePlatform({
+            platformId: this.platformId,
+            feeBps,
+            active,
+            newWallet: newWallet || platform.wallet,
+        });
+    }
+    /**
+     * Get platform-wide statistics.
+     *
+     * Uses `getProgramAccounts` for efficient merchant counting instead of
+     * scanning every merchant ID sequentially.
+     */
+    async getStats() {
+        const platform = await this.getPlatform();
+        if (!platform)
+            throw new Error(`Platform #${this.platformId} not found`);
+        // Single RPC call to get all merchants on this platform
+        const merchants = await this.sdk.getMerchantsByPlatform(this.platformId);
+        return {
+            platformId: this.platformId,
+            feeBps: platform.feeBps,
+            feePercent: (platform.feeBps / 100).toFixed(1) + '%',
+            merchantCount: merchants.length,
+            adminWallet: platform.admin,
+            paymentWallet: platform.wallet,
+            active: platform.active,
+            totalLinks: 0, // Would require scanning all links; 0 as placeholder
+            totalVolume: 0,
+            feeRevenue: 0,
+            protocolFeeBps: index_1.PROTOCOL_FEE_BPS,
+        };
+    }
+    // ==================== CONVENIENCE METHODS ====================
+    /**
+     * Generate a checkout URL for a merchant's payment link.
+     */
+    getCheckoutUrl(linkId) {
+        return this.sdk.getPaymentUrl(linkId);
+    }
+    /**
+     * Get the platform ID.
+     */
+    getPlatformId() {
+        return this.platformId;
+    }
+    // ==================== DIRECTORY PERSISTENCE ====================
+    /**
+     * Export the local merchant directory as JSON.
+     * Use this to persist merchant names/metadata to your database.
+     */
+    exportDirectory() {
+        const entries = [];
+        for (const [merchantId, info] of this.merchantDirectory) {
+            entries.push({ merchantId, ...info });
+        }
+        return entries;
+    }
+    /**
+     * Import a previously exported merchant directory.
+     */
+    importDirectory(entries) {
+        for (const entry of entries) {
+            this.merchantDirectory.set(entry.merchantId, {
+                name: entry.name,
+                metadata: entry.metadata,
+            });
+        }
+    }
+}
+exports.RotatePlatformManager = RotatePlatformManager;
+// ==================== EXPORTS ====================
+exports.default = RotatePlatformManager;
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/react.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Rotate Protocol React Hooks
+ *
+ * React hooks for easy integration with Solana wallet adapters.
+ *
+ * @packageDocumentation
+ */
+import { PublicKey } from '@solana/web3.js';
+import RotateSDK, { PaymentLink, Platform, Merchant, Protocol, calculateFees, generateSampleId, isValidId, getLinkDescription, MEMO_PROGRAM_ID, Network, MIN_RANDOM_ID, MAX_RANDOM_ID } from './index';
+export interface UseRotateOptions {
+    network?: Network;
+    rpcEndpoint?: string;
+}
+export interface PaymentStatus {
+    linkId: number;
+    status: PaymentLink['status'];
+    amountPaid: bigint;
+    amountTotal: bigint;
+    isPaid: boolean;
+    isExpired: boolean;
+}
+/**
+ * Main hook for Rotate Protocol
+ */
+export declare function useRotate(options?: UseRotateOptions): {
+    sdk: RotateSDK;
+    protocol: Protocol | null;
+    loading: boolean;
+    error: string | null;
+    connected: boolean;
+    publicKey: PublicKey | null;
+    signTransaction: (<T extends import("@solana/web3.js").Transaction | import("@solana/web3.js").VersionedTransaction>(transaction: T) => Promise<T>) | undefined;
+};
+/**
+ * Hook for working with a specific payment link
+ */
+export declare function usePaymentLink(linkId: number, options?: UseRotateOptions): {
+    link: PaymentLink | null;
+    status: PaymentStatus | null;
+    loading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    startPolling: (intervalMs?: number) => void;
+    stopPolling: () => void;
+    isPolling: boolean;
+    paymentUrl: string;
+};
+/**
+ * Hook for merchant operations
+ */
+export declare function useMerchant(merchantId: number, options?: UseRotateOptions): {
+    merchant: Merchant | null;
+    platform: Platform | null;
+    loading: boolean;
+    error: string | null;
+    getFees: (amountUsd: number) => {
+        amount: number;
+        protocolFee: number;
+        platformFee: number;
+        totalFees: number;
+        buyerFeeShare: number;
+        sellerFeeShare: number;
+        buyerPays: number;
+        merchantReceives: number;
+    };
+};
+/**
+ * Hook for SOL price.
+ * `priceApiUrl` can be overridden to use a custom price feed (default: CoinGecko).
+ */
+export declare function useSolPrice(refreshIntervalMs?: number, priceApiUrl?: string): {
+    price: number | null;
+    loading: boolean;
+    refresh: () => Promise<void>;
+    usdToSol: (usd: number) => number | null;
+    solToUsd: (sol: number) => number | null;
+};
+/**
+ * Hook for token balances
+ */
+export declare function useTokenBalances(options?: UseRotateOptions): {
+    balances: {
+        sol: number;
+        usdc: number;
+        usdt: number;
+    };
+    loading: boolean;
+    refresh: () => Promise<void>;
+    hasEnough: (amount: number, currency: "SOL" | "USDC" | "USDT") => boolean;
+};
+/**
+ * Complete payment flow hook
+ */
+export declare function usePaymentFlow(linkId: number, options?: UseRotateOptions): {
+    link: PaymentLink | null;
+    status: PaymentStatus | null;
+    connected: boolean;
+    publicKey: PublicKey | null;
+    selectedCurrency: "SOL" | "USDC" | "USDT";
+    setSelectedCurrency: import("react").Dispatch<import("react").SetStateAction<"SOL" | "USDC" | "USDT">>;
+    amountInCurrency: number | null;
+    canPay: boolean;
+    paying: boolean;
+    paymentError: string | null;
+    refresh: () => Promise<void>;
+    startPolling: (intervalMs?: number) => void;
+    stopPolling: () => void;
+    balances: {
+        sol: number;
+        usdc: number;
+        usdt: number;
+    };
+    solPrice: number | null;
+};
+/**
+ * Hook for creating platforms and merchants with random IDs
+ */
+export declare function useCreateEntities(options?: UseRotateOptions): {
+    createPlatform: (feeBps: number, wallet: PublicKey) => Promise<{
+        tx: string;
+        platformId: number;
+    }>;
+    createMerchant: (platformId: number, wallet: PublicKey) => Promise<{
+        tx: string;
+        merchantId: number;
+    }>;
+    creating: boolean;
+    error: string | null;
+    generateSampleId: typeof generateSampleId;
+    isValidId: typeof isValidId;
+    MIN_RANDOM_ID: number;
+    MAX_RANDOM_ID: number;
+};
+export { useProducts, useCart, useMarketplace, useMarketplaceCart } from './hooks';
+export type { UseProductsReturn, UseCartReturn, UseMarketplaceReturn, UseMarketplaceCartReturn } from './hooks';
+export { RotateSDK, calculateFees, generateSampleId, isValidId, getLinkDescription, MEMO_PROGRAM_ID, MIN_RANDOM_ID, MAX_RANDOM_ID, };
+export { RotateStore, RotateCart } from './store';
+export { RotateMarketplace, MarketplaceCart } from './marketplace';
+export { RotatePlatformManager } from './platform';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,SAAS,EAAE,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,OAAO,EACP,aAAa,EACb,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;EAuCvD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;;;;;;gCA4B7B,MAAM;;;;EAqCrD;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;;;;;yBA2BpC,MAAM;;;;;;;;;;EAW/C;AAID;;;GAGG;AACH,wBAAgB,WAAW,CACzB,iBAAiB,GAAE,MAAc,EACjC,WAAW,GAAE,MAAqF;;;;oBAuB/D,MAAM;oBAKN,MAAM;EAY1C;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,gBAAqB;;aAMtD,MAAM;cACL,MAAM;cACN,MAAM;;;;wBAqCQ,MAAM,YAAY,KAAK,GAAG,MAAM,GAAG,MAAM;EAOhE;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;;;;;;;;;;;;gCAtM7B,MAAM;;;aAiJ7C,MAAM;cACL,MAAM;cACN,MAAM;;;EA8Gf;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB;6BAKZ,MAAM,UAAU,SAAS;;;;iCAiBrB,MAAM,UAAU,SAAS;;;;;;;;;;EA2BhF;AAKD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAIhH,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,GACd,CAAC;AAGF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}