@sparkleideas/cli 3.1.0-alpha.19 → 3.1.0-alpha.21

package/dist/src/transfer/ipfs/client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * IPFS Client Module
+ * Low-level IPFS operations for discovery and fetching
+ *
+ * Supports multiple gateways with automatic fallback:
+ * - Pinata (recommended for pinned content)
+ * - Cloudflare IPFS
+ * - Protocol Labs ipfs.io
+ * - dweb.link (LibP2P)
+ */
+/**
+ * Available IPFS gateways in priority order
+ */
+export declare const IPFS_GATEWAYS: string[];
+/**
+ * IPNS resolvers
+ */
+export declare const IPNS_RESOLVERS: string[];
+/**
+ * Gateway configuration
+ */
+export interface GatewayConfig {
+    url: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    priority?: number;
+}
+/**
+ * Fetch result with metadata
+ */
+export interface FetchResult<T> {
+    data: T;
+    gateway: string;
+    cid: string;
+    cached: boolean;
+    latencyMs: number;
+}
+/**
+ * Resolve IPNS name to CID with fallback across multiple gateways
+ *
+ * @param ipnsName - IPNS key or DNSLink domain
+ * @param preferredGateway - Optional preferred gateway to try first
+ * @returns CID string or null if resolution fails
+ */
+export declare function resolveIPNS(ipnsName: string, preferredGateway?: string): Promise<string | null>;
+/**
+ * Fetch content from IPFS by CID with fallback across multiple gateways
+ *
+ * @param cid - Content Identifier
+ * @param preferredGateway - Optional preferred gateway to try first
+ * @returns Parsed JSON content or null if fetch fails
+ */
+export declare function fetchFromIPFS<T>(cid: string, preferredGateway?: string): Promise<T | null>;
+/**
+ * Fetch with full result metadata
+ */
+export declare function fetchFromIPFSWithMetadata<T>(cid: string, preferredGateway?: string): Promise<FetchResult<T> | null>;
+/**
+ * Check if CID is pinned/available on a gateway
+ */
+export declare function isPinned(cid: string, gateway?: string): Promise<boolean>;
+/**
+ * Check availability across multiple gateways
+ */
+export declare function checkAvailability(cid: string): Promise<{
+    available: boolean;
+    gateways: Array<{
+        url: string;
+        available: boolean;
+        latencyMs: number;
+    }>;
+}>;
+/**
+ * Get IPFS gateway URL for a CID
+ */
+export declare function getGatewayUrl(cid: string, gateway?: string): string;
+/**
+ * Get multiple gateway URLs for redundancy
+ */
+export declare function getGatewayUrls(cid: string): string[];
+/**
+ * Validate CID format (CIDv0 and CIDv1)
+ */
+export declare function isValidCID(cid: string): boolean;
+/**
+ * Validate IPNS name format
+ */
+export declare function isValidIPNS(ipnsName: string): boolean;
+/**
+ * Generate content hash for verification
+ */
+export declare function hashContent(content: Buffer | string): string;
+/**
+ * Verify Ed25519 signature (async import to avoid bundling issues)
+ */
+export declare function verifyEd25519Signature(message: string, signature: string, publicKey: string): Promise<boolean>;
+/**
+ * Parse CID to extract metadata
+ */
+export declare function parseCID(cid: string): {
+    version: 0 | 1;
+    codec: string;
+    hash: string;
+} | null;
+/**
+ * Format bytes to human readable
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/transfer/ipfs/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/transfer/ipfs/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,eAAO,MAAM,aAAa,UAMzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,UAI1B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2DxB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA2CnB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAsChC;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE,CAAC,CA6BD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAA0B,GAAG,MAAM,CAEtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IACrC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,IAAI,CAmBP;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/src/transfer/ipfs/client.js

@@ -0,0 +1,307 @@
+/**
+ * IPFS Client Module
+ * Low-level IPFS operations for discovery and fetching
+ *
+ * Supports multiple gateways with automatic fallback:
+ * - Pinata (recommended for pinned content)
+ * - Cloudflare IPFS
+ * - Protocol Labs ipfs.io
+ * - dweb.link (LibP2P)
+ */
+import * as crypto from 'crypto';
+/**
+ * Available IPFS gateways in priority order
+ */
+export const IPFS_GATEWAYS = [
+    'https://gateway.pinata.cloud',
+    'https://cloudflare-ipfs.com',
+    'https://ipfs.io',
+    'https://dweb.link',
+    'https://w3s.link', // web3.storage gateway
+];
+/**
+ * IPNS resolvers
+ */
+export const IPNS_RESOLVERS = [
+    'https://gateway.pinata.cloud',
+    'https://dweb.link',
+    'https://ipfs.io',
+];
+/**
+ * Resolve IPNS name to CID with fallback across multiple gateways
+ *
+ * @param ipnsName - IPNS key or DNSLink domain
+ * @param preferredGateway - Optional preferred gateway to try first
+ * @returns CID string or null if resolution fails
+ */
+export async function resolveIPNS(ipnsName, preferredGateway) {
+    const resolvers = preferredGateway
+        ? [preferredGateway, ...IPNS_RESOLVERS.filter(r => r !== preferredGateway)]
+        : IPNS_RESOLVERS;
+    console.log(`[IPFS] Resolving IPNS: ${ipnsName}`);
+    for (const gateway of resolvers) {
+        try {
+            const startTime = Date.now();
+            let cid = null;
+            // Method 1: DNSLink resolution for domain names
+            if (ipnsName.includes('.')) {
+                const response = await fetch(`${gateway}/api/v0/name/resolve?arg=/ipns/${ipnsName}`, {
+                    signal: AbortSignal.timeout(10000),
+                    headers: { 'Accept': 'application/json' },
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    cid = data.Path?.replace('/ipfs/', '') || null;
+                }
+            }
+            // Method 2: Direct IPNS key resolution via gateway redirect
+            if (!cid) {
+                const response = await fetch(`${gateway}/ipns/${ipnsName}`, {
+                    method: 'HEAD',
+                    signal: AbortSignal.timeout(10000),
+                    redirect: 'follow',
+                });
+                if (response.ok) {
+                    // Extract CID from the final URL after redirects
+                    const finalUrl = response.url;
+                    const cidMatch = finalUrl.match(/\/ipfs\/([a-zA-Z0-9]+)/);
+                    if (cidMatch) {
+                        cid = cidMatch[1];
+                    }
+                }
+            }
+            if (cid) {
+                const latency = Date.now() - startTime;
+                console.log(`[IPFS] Resolved ${ipnsName} -> ${cid} via ${gateway} (${latency}ms)`);
+                return cid;
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.warn(`[IPFS] Gateway ${gateway} failed: ${errorMsg}`);
+            continue;
+        }
+    }
+    console.warn(`[IPFS] IPNS resolution failed for ${ipnsName} on all gateways`);
+    return null;
+}
+/**
+ * Fetch content from IPFS by CID with fallback across multiple gateways
+ *
+ * @param cid - Content Identifier
+ * @param preferredGateway - Optional preferred gateway to try first
+ * @returns Parsed JSON content or null if fetch fails
+ */
+export async function fetchFromIPFS(cid, preferredGateway) {
+    if (!isValidCID(cid))
+        return null;
+    const gateways = preferredGateway
+        ? [preferredGateway, ...IPFS_GATEWAYS.filter(g => g !== preferredGateway)]
+        : IPFS_GATEWAYS;
+    console.log(`[IPFS] Fetching CID: ${cid}`);
+    for (const gateway of gateways) {
+        try {
+            const startTime = Date.now();
+            const url = `${gateway}/ipfs/${cid}`;
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(30000),
+                headers: {
+                    'Accept': 'application/json',
+                    'Cache-Control': 'max-age=3600',
+                },
+            });
+            if (response.ok) {
+                const data = await response.json();
+                const latency = Date.now() - startTime;
+                console.log(`[IPFS] Fetched ${cid} from ${gateway} (${latency}ms)`);
+                return data;
+            }
+            // Handle specific error codes
+            if (response.status === 504) {
+                console.warn(`[IPFS] Gateway timeout on ${gateway}, trying next...`);
+            }
+            else if (response.status === 429) {
+                console.warn(`[IPFS] Rate limited on ${gateway}, trying next...`);
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.warn(`[IPFS] Gateway ${gateway} failed: ${errorMsg}`);
+            continue;
+        }
+    }
+    console.warn(`[IPFS] Fetch failed for ${cid} on all gateways`);
+    return null;
+}
+/**
+ * Fetch with full result metadata
+ */
+export async function fetchFromIPFSWithMetadata(cid, preferredGateway) {
+    if (!isValidCID(cid))
+        return null;
+    const gateways = preferredGateway
+        ? [preferredGateway, ...IPFS_GATEWAYS.filter(g => g !== preferredGateway)]
+        : IPFS_GATEWAYS;
+    for (const gateway of gateways) {
+        try {
+            const startTime = Date.now();
+            const url = `${gateway}/ipfs/${cid}`;
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(30000),
+                headers: {
+                    'Accept': 'application/json',
+                },
+            });
+            if (response.ok) {
+                const data = await response.json();
+                const latencyMs = Date.now() - startTime;
+                const cached = response.headers.get('X-Cache')?.includes('HIT') ||
+                    response.headers.get('CF-Cache-Status') === 'HIT';
+                return {
+                    data,
+                    gateway,
+                    cid,
+                    cached,
+                    latencyMs,
+                };
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Check if CID is pinned/available on a gateway
+ */
+export async function isPinned(cid, gateway = 'https://ipfs.io') {
+    if (!isValidCID(cid))
+        return false;
+    try {
+        const response = await fetch(`${gateway}/ipfs/${cid}`, {
+            method: 'HEAD',
+            signal: AbortSignal.timeout(5000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check availability across multiple gateways
+ */
+export async function checkAvailability(cid) {
+    if (!isValidCID(cid))
+        return { available: false, gateways: [] };
+    const results = await Promise.all(IPFS_GATEWAYS.map(async (gateway) => {
+        const startTime = Date.now();
+        try {
+            const response = await fetch(`${gateway}/ipfs/${cid}`, {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(5000),
+            });
+            return {
+                url: gateway,
+                available: response.ok,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        catch {
+            return {
+                url: gateway,
+                available: false,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+    }));
+    return {
+        available: results.some(r => r.available),
+        gateways: results,
+    };
+}
+/**
+ * Get IPFS gateway URL for a CID
+ */
+export function getGatewayUrl(cid, gateway = 'https://ipfs.io') {
+    return `${gateway}/ipfs/${cid}`;
+}
+/**
+ * Get multiple gateway URLs for redundancy
+ */
+export function getGatewayUrls(cid) {
+    return IPFS_GATEWAYS.map(gateway => `${gateway}/ipfs/${cid}`);
+}
+/**
+ * Validate CID format (CIDv0 and CIDv1)
+ */
+export function isValidCID(cid) {
+    // CIDv0 starts with 'Qm' and is 46 characters (base58btc)
+    // CIDv1 starts with 'b' (base32) or 'z' (base58btc) or 'f' (base16)
+    return /^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[a-z2-7]{58,}|z[1-9A-HJ-NP-Za-km-z]{48,}|f[0-9a-f]{50,})$/i.test(cid);
+}
+/**
+ * Validate IPNS name format
+ */
+export function isValidIPNS(ipnsName) {
+    // IPNS key format (k51...) or DNSLink domain
+    return /^(k51[a-z0-9]{59,}|[a-z0-9.-]+\.[a-z]{2,})$/i.test(ipnsName);
+}
+/**
+ * Generate content hash for verification
+ */
+export function hashContent(content) {
+    const buffer = typeof content === 'string' ? Buffer.from(content) : content;
+    return crypto.createHash('sha256').update(buffer).digest('hex');
+}
+/**
+ * Verify Ed25519 signature (async import to avoid bundling issues)
+ */
+export async function verifyEd25519Signature(message, signature, publicKey) {
+    try {
+        // Dynamic import to avoid bundling @noble/ed25519 if not used
+        const ed = await import('@noble/ed25519');
+        // Handle prefixed public key (e.g., "ed25519:abc123...")
+        const pubKeyHex = publicKey.replace(/^ed25519:/, '');
+        const isValid = await ed.verifyAsync(Buffer.from(signature, 'hex'), new TextEncoder().encode(message), Buffer.from(pubKeyHex, 'hex'));
+        return isValid;
+    }
+    catch (error) {
+        console.warn('[IPFS] Signature verification failed:', error);
+        return false;
+    }
+}
+/**
+ * Parse CID to extract metadata
+ */
+export function parseCID(cid) {
+    if (!isValidCID(cid)) {
+        return null;
+    }
+    if (cid.startsWith('Qm')) {
+        return {
+            version: 0,
+            codec: 'dag-pb',
+            hash: cid,
+        };
+    }
+    // CIDv1 - simplified parsing
+    return {
+        version: 1,
+        codec: 'dag-cbor', // Most common for JSON
+        hash: cid,
+    };
+}
+/**
+ * Format bytes to human readable
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+//# sourceMappingURL=client.js.map

package/dist/src/transfer/ipfs/client.js.map

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

package/dist/src/transfer/ipfs/upload.d.ts

@@ -0,0 +1,95 @@
+/**
+ * IPFS Upload Module
+ * Real upload support via web3.storage, Pinata, or local IPFS
+ *
+ * @module @sparkleideas/cli/transfer/ipfs/upload
+ * @version 3.0.0
+ */
+import type { PinningService } from '../types.js';
+/**
+ * IPFS upload options
+ */
+export interface IPFSUploadOptions {
+    pin?: boolean;
+    pinningService?: PinningService;
+    gateway?: string;
+    name?: string;
+    wrapWithDirectory?: boolean;
+    apiKey?: string;
+    apiSecret?: string;
+}
+/**
+ * IPFS upload result
+ */
+export interface IPFSUploadResult {
+    cid: string;
+    size: number;
+    gateway: string;
+    pinnedAt?: string;
+    url: string;
+}
+/**
+ * Upload content to IPFS
+ *
+ * Supports (in order of preference):
+ * - Local/Custom IPFS node (IPFS_API_URL) - FREE, your own node
+ * - web3.storage (WEB3_STORAGE_TOKEN) - Free 5GB tier
+ * - Pinata (PINATA_API_KEY + PINATA_API_SECRET) - Free 1GB tier
+ * - Demo mode (generates deterministic CIDs when no credentials)
+ */
+export declare function uploadToIPFS(content: Buffer, options?: IPFSUploadOptions): Promise<IPFSUploadResult>;
+/**
+ * Pin content by CID
+ */
+export declare function pinContent(cid: string, options?: {
+    service?: PinningService;
+    name?: string;
+}): Promise<{
+    success: boolean;
+    pinnedAt: string;
+}>;
+/**
+ * Unpin content by CID
+ */
+export declare function unpinContent(cid: string, options?: {
+    service?: PinningService;
+}): Promise<{
+    success: boolean;
+}>;
+/**
+ * Check if content exists on IPFS
+ */
+export declare function checkContent(cid: string, gateway?: string): Promise<{
+    exists: boolean;
+    size?: number;
+}>;
+/**
+ * Get gateway URL for CID
+ */
+export declare function getGatewayURL(cid: string, gateway?: string): string;
+/**
+ * Get IPNS URL for name
+ */
+export declare function getIPNSURL(name: string, gateway?: string): string;
+/**
+ * Check if local IPFS node is available
+ */
+declare function checkLocalIPFSNode(): Promise<boolean>;
+/**
+ * Check if real IPFS credentials are available
+ */
+export declare function hasIPFSCredentials(): boolean;
+/**
+ * Get IPFS service status
+ */
+export declare function getIPFSServiceStatus(): {
+    service: 'local' | 'web3storage' | 'pinata' | 'demo';
+    configured: boolean;
+    message: string;
+    apiUrl?: string;
+};
+/**
+ * Export the local IPFS check for external use
+ */
+export { checkLocalIPFSNode };
+//# sourceMappingURL=upload.d.ts.map

package/dist/src/transfer/ipfs/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../src/transfer/ipfs/upload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAqKD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA2E3B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,cAAc,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAsCjD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,cAAc,CAAA;CAAO,GACzC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA8B/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAA2B,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAA2B,GAAG,MAAM,CAEvF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAA2B,GAAG,MAAM,CAErF;AAuDD;;GAEG;AACH,iBAAe,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAYpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAsCA;AAED;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC"}