@uploadista/client-core 0.0.3

package/dist/services/http-client.d.ts

@@ -0,0 +1,182 @@
+import type { AbortSignalLike } from "./abort-controller-service";
+/**
+ * Platform-agnostic request body type.
+ *
+ * Supports various data formats for HTTP request bodies across different platforms.
+ */
+export type RequestBody = string | Uint8Array | ArrayBuffer | null | undefined;
+/**
+ * Platform-agnostic HTTP headers interface.
+ *
+ * Provides a subset of the Web Headers API that works across platforms.
+ */
+export interface HeadersLike {
+    /** Retrieves a header value by name, or null if not found */
+    get(name: string): string | null;
+    /** Checks if a header exists */
+    has(name: string): boolean;
+    /** Iterates over all headers */
+    forEach(callback: (value: string, name: string) => void): void;
+}
+/**
+ * Options for HTTP requests.
+ *
+ * Platform-agnostic configuration for making HTTP requests with support
+ * for headers, body data, abort signals, timeouts, and credentials.
+ */
+export interface HttpRequestOptions {
+    /** HTTP method (GET, POST, PATCH, DELETE, etc.) */
+    method?: string;
+    /** Request headers as key-value pairs */
+    headers?: Record<string, string>;
+    /** Request body data */
+    body?: unknown;
+    /** Abort signal for cancelling the request */
+    signal?: AbortSignalLike;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Credentials mode for cross-origin requests */
+    credentials?: "include" | "omit" | "same-origin";
+}
+/**
+ * Platform-agnostic HTTP response interface.
+ *
+ * Provides a subset of the Web Response API that works across platforms.
+ */
+export interface HttpResponse {
+    /** HTTP status code (200, 404, 500, etc.) */
+    status: number;
+    /** HTTP status text (OK, Not Found, etc.) */
+    statusText: string;
+    /** Response headers */
+    headers: HeadersLike;
+    /** True if status is in the 200-299 range */
+    ok: boolean;
+    /** Parses response body as JSON */
+    json(): Promise<unknown>;
+    /** Reads response body as text */
+    text(): Promise<string>;
+    /** Reads response body as ArrayBuffer */
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/**
+ * Configuration for HTTP connection pooling.
+ *
+ * Controls how connections are managed, reused, and maintained for optimal
+ * upload performance. Properly configured connection pooling can significantly
+ * improve upload speeds by reusing existing connections.
+ */
+export interface ConnectionPoolConfig {
+    /** Maximum number of concurrent connections per host. Defaults to 8. */
+    maxConnectionsPerHost?: number;
+    /** Timeout for establishing new connections in milliseconds. Defaults to 20000. */
+    connectionTimeout?: number;
+    /** How long to keep idle connections alive in milliseconds. Defaults to 90000. */
+    keepAliveTimeout?: number;
+    /** Enable HTTP/2 for connection multiplexing. Defaults to true. */
+    enableHttp2?: boolean;
+    /** Automatically retry requests on connection errors. Defaults to true. */
+    retryOnConnectionError?: boolean;
+}
+/**
+ * Basic connection pool metrics.
+ *
+ * Provides insight into connection pool performance and efficiency.
+ */
+export interface ConnectionMetrics {
+    /** Number of currently active connections */
+    activeConnections: number;
+    /** Total connections created since pool initialization */
+    totalConnections: number;
+    /** Ratio of connection reuse (0-1, higher is better) */
+    reuseRate: number;
+    /** Average time to establish connections in milliseconds */
+    averageConnectionTime: number;
+}
+/**
+ * Connection pool health assessment.
+ *
+ * Provides diagnostic information about connection pool health
+ * and recommendations for optimization.
+ */
+export interface ConnectionHealth {
+    /** Overall health status */
+    status: "healthy" | "degraded" | "poor";
+    /** Health score from 0-100 (higher is better) */
+    score: number;
+    /** List of identified issues affecting performance */
+    issues: string[];
+    /** Recommendations for improving connection pool performance */
+    recommendations: string[];
+}
+/**
+ * HTTP/2 support and status information.
+ *
+ * Indicates whether HTTP/2 is available and being used,
+ * which can significantly improve upload performance through multiplexing.
+ */
+export interface Http2Info {
+    /** Whether HTTP/2 is supported by the platform */
+    supported: boolean;
+    /** Whether HTTP/2 was detected on the server */
+    detected: boolean;
+    /** HTTP version being used (e.g., "2.0", "1.1") */
+    version: string;
+    /** Whether HTTP/2 multiplexing is actively being used */
+    multiplexingActive: boolean;
+}
+/**
+ * Detailed connection pool metrics with health diagnostics.
+ *
+ * Extends basic metrics with comprehensive diagnostic information
+ * for troubleshooting performance issues.
+ */
+export interface DetailedConnectionMetrics extends ConnectionMetrics {
+    /** Connection pool health assessment */
+    health: ConnectionHealth;
+    /** Average requests per second */
+    requestsPerSecond: number;
+    /** Ratio of failed requests (0-1) */
+    errorRate: number;
+    /** Number of requests that timed out */
+    timeouts: number;
+    /** Number of requests that were retried */
+    retries: number;
+    /** Number of fast connections (likely reused) */
+    fastConnections: number;
+    /** Number of slow connections (likely new) */
+    slowConnections: number;
+    /** HTTP/2 support and usage information */
+    http2Info: Http2Info;
+}
+/**
+ * HTTP client interface that provides connection pooling capabilities
+ * for optimized upload performance.
+ */
+export interface HttpClient {
+    /**
+     * Make an HTTP request using connection pooling
+     */
+    request(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;
+    /**
+     * Get current connection pool metrics
+     */
+    getMetrics(): ConnectionMetrics;
+    /**
+     * Get detailed connection metrics with health diagnostics
+     */
+    getDetailedMetrics(): DetailedConnectionMetrics;
+    /**
+     * Reset connection pool and metrics
+     */
+    reset(): void;
+    /**
+     * Gracefully close all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Warm up connections by making preflight requests
+     */
+    warmupConnections(urls: string[]): Promise<void>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/services/http-client.d.ts.map

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

package/dist/services/http-client.js

@@ -0,0 +1 @@
+export {};

package/dist/services/id-generation-service.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Platform-agnostic ID generation service
+ */
+export interface IdGenerationService {
+    /**
+     * Generate a unique identifier
+     */
+    generate(): string;
+}
+//# sourceMappingURL=id-generation-service.d.ts.map

package/dist/services/id-generation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generation-service.d.ts","sourceRoot":"","sources":["../../src/services/id-generation-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;CACpB"}

package/dist/services/id-generation-service.js

@@ -0,0 +1 @@
+export {};

package/dist/services/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./abort-controller-service";
+export * from "./checksum-service";
+export * from "./file-reader-service";
+export * from "./fingerprint-service";
+export * from "./http-client";
+export * from "./id-generation-service";
+export * from "./platform-service";
+export * from "./service-container";
+export * from "./storage-service";
+export * from "./websocket-service";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,10 @@
+export * from "./abort-controller-service";
+export * from "./checksum-service";
+export * from "./file-reader-service";
+export * from "./fingerprint-service";
+export * from "./http-client";
+export * from "./id-generation-service";
+export * from "./platform-service";
+export * from "./service-container";
+export * from "./storage-service";
+export * from "./websocket-service";

package/dist/services/platform-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Platform-agnostic service for platform-specific APIs
+ * Provides abstraction for timer functions and platform detection
+ */
+export type Timeout = unknown;
+export interface PlatformService {
+    /**
+     * Schedule a callback to run after a delay
+     */
+    setTimeout: (callback: () => void, ms: number | undefined) => Timeout;
+    /**
+     * Cancel a scheduled callback
+     */
+    clearTimeout: (id: Timeout) => void;
+    /**
+     * Check if we're in a browser environment
+     */
+    isBrowser: () => boolean;
+    /**
+     * Check if network is online
+     */
+    isOnline: () => boolean;
+    /**
+     * Check if a value is a File-like object
+     */
+    isFileLike: (value: unknown) => boolean;
+    /**
+     * Get file name from File-like object
+     */
+    getFileName: (file: unknown) => string | undefined;
+    /**
+     * Get file type from File-like object
+     */
+    getFileType: (file: unknown) => string | undefined;
+    /**
+     * Get file size from File-like object
+     */
+    getFileSize: (file: unknown) => number | undefined;
+    /**
+     * Get file last modified timestamp from File-like object
+     */
+    getFileLastModified: (file: unknown) => number | undefined;
+}
+/**
+ * Simple async wait utility
+ */
+export declare function wait(platformService: PlatformService, ms: number): Promise<void>;
+//# sourceMappingURL=platform-service.d.ts.map

package/dist/services/platform-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-service.d.ts","sourceRoot":"","sources":["../../src/services/platform-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IAEtE;;OAEG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;IAEpC;;OAEG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAExC;;OAEG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAEnD;;OAEG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAEnD;;OAEG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAEnD;;OAEG;IACH,mBAAmB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,eAAe,EAAE,eAAe,EAChC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/services/platform-service.js

@@ -0,0 +1,10 @@
+/**
+ * Platform-agnostic service for platform-specific APIs
+ * Provides abstraction for timer functions and platform detection
+ */
+/**
+ * Simple async wait utility
+ */
+export async function wait(platformService, ms) {
+    return new Promise((resolve) => platformService.setTimeout(resolve, ms));
+}

package/dist/services/service-container.d.ts

@@ -0,0 +1,25 @@
+import type { AbortControllerFactory } from "./abort-controller-service";
+import type { ChecksumService } from "./checksum-service";
+import type { Base64Service, FileReaderService } from "./file-reader-service";
+import type { FingerprintService } from "./fingerprint-service";
+import type { HttpClient } from "./http-client";
+import type { IdGenerationService } from "./id-generation-service";
+import type { PlatformService } from "./platform-service";
+import type { StorageService } from "./storage-service";
+import type { WebSocketFactory } from "./websocket-service";
+/**
+ * Service container for dependency injection
+ */
+export interface ServiceContainer<UploadInput> {
+    storage: StorageService;
+    idGeneration: IdGenerationService;
+    httpClient: HttpClient;
+    fileReader: FileReaderService<UploadInput>;
+    base64?: Base64Service;
+    websocket: WebSocketFactory;
+    abortController: AbortControllerFactory;
+    platform: PlatformService;
+    checksumService: ChecksumService;
+    fingerprintService: FingerprintService<UploadInput>;
+}
+//# sourceMappingURL=service-container.d.ts.map

package/dist/services/service-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-container.d.ts","sourceRoot":"","sources":["../../src/services/service-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,WAAW;IAC3C,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,sBAAsB,CAAC;IACxC,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;CACrD"}

package/dist/services/service-container.js

@@ -0,0 +1 @@
+export {};

package/dist/services/storage-service.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Platform-agnostic storage service for persisting upload state
+ */
+export interface StorageService {
+    /**
+     * Get an item from storage
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * Set an item in storage
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * Remove an item from storage
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * Get all items in storage
+     */
+    findAll(): Promise<Record<string, string>>;
+    /**
+     * Find items by prefix
+     */
+    find(prefix: string): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=storage-service.d.ts.map

package/dist/services/storage-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-service.d.ts","sourceRoot":"","sources":["../../src/services/storage-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE3C;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD"}

package/dist/services/storage-service.js

@@ -0,0 +1 @@
+export {};

package/dist/services/websocket-service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Platform-agnostic WebSocket interface
+ */
+export interface WebSocketEventMap {
+    open: unknown;
+    close: unknown;
+    error: unknown;
+    message: unknown;
+}
+export interface WebSocketLike {
+    readyState: number;
+    readonly CONNECTING: number;
+    readonly OPEN: number;
+    readonly CLOSING: number;
+    readonly CLOSED: number;
+    onopen: (() => void) | null;
+    onclose: ((event: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    onerror: ((event: {
+        message: string;
+    }) => void) | null;
+    onmessage: ((event: {
+        data: string;
+    }) => void) | null;
+    send(data: string | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+}
+export interface WebSocketFactory {
+    /**
+     * Create a WebSocket connection to the given URL
+     */
+    create(url: string): WebSocketLike;
+}
+//# sourceMappingURL=websocket-service.d.ts.map

package/dist/services/websocket-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-service.d.ts","sourceRoot":"","sources":["../../src/services/websocket-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAEtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;CACpC"}

package/dist/services/websocket-service.js

@@ -0,0 +1,4 @@
+/**
+ * Platform-agnostic WebSocket interface
+ */
+export {};

package/dist/smart-chunker.d.ts

@@ -0,0 +1,72 @@
+import type { NetworkCondition, NetworkMonitor } from "./network-monitor";
+import type { ConnectionMetrics } from "./services/http-client";
+export interface ChunkingStrategy {
+    name: string;
+    minChunkSize: number;
+    maxChunkSize: number;
+    initialChunkSize: number;
+    adaptationRate: number;
+}
+export interface DatastoreConstraints {
+    minChunkSize: number;
+    maxChunkSize: number;
+    optimalChunkSize: number;
+    requiresOrderedChunks?: boolean;
+}
+export interface SmartChunkerConfig {
+    enabled?: boolean;
+    fallbackChunkSize?: number;
+    minChunkSize?: number;
+    maxChunkSize?: number;
+    initialChunkSize?: number;
+    targetUtilization?: number;
+    adaptationRate?: number;
+    conservativeMode?: boolean;
+    connectionPoolingAware?: boolean;
+    datastoreConstraints?: DatastoreConstraints;
+}
+export interface ChunkSizeDecision {
+    size: number;
+    strategy: string;
+    reason: string;
+    networkCondition: NetworkCondition;
+}
+export declare class SmartChunker {
+    private config;
+    private networkMonitor;
+    private currentChunkSize;
+    private lastDecision;
+    private consecutiveFailures;
+    private consecutiveSuccesses;
+    private connectionMetrics;
+    constructor(networkMonitor: NetworkMonitor, config?: SmartChunkerConfig);
+    private getEffectiveInitialChunkSize;
+    private applyDatastoreConstraints;
+    getNextChunkSize(remainingBytes?: number): ChunkSizeDecision;
+    recordChunkResult(size: number, duration: number, success: boolean): void;
+    getCurrentChunkSize(): number;
+    getLastDecision(): ChunkSizeDecision | null;
+    reset(): void;
+    /**
+     * Update connection metrics for connection pooling aware optimizations
+     */
+    updateConnectionMetrics(metrics: ConnectionMetrics): void;
+    /**
+     * Get insights about connection pooling impact on chunking
+     */
+    getConnectionPoolingInsights(): {
+        isOptimized: boolean;
+        reuseRate: number;
+        recommendedMinChunkSize: number;
+        connectionOverhead: number;
+    };
+    private selectStrategy;
+    /**
+     * Optimize chunking strategy based on connection pooling performance
+     */
+    private optimizeStrategyForConnectionPooling;
+    private calculateOptimalChunkSize;
+    private getTargetChunkDuration;
+    private adaptChunkSize;
+}
+//# sourceMappingURL=smart-chunker.d.ts.map

package/dist/smart-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-chunker.d.ts","sourceRoot":"","sources":["../src/smart-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAkDD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAEZ;IACF,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAkC;gBAE/C,cAAc,EAAE,cAAc,EAAE,MAAM,GAAE,kBAAuB;IAkB3E,OAAO,CAAC,4BAA4B;IAUpC,OAAO,CAAC,yBAAyB;IAUjC,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAyD5D,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBzE,mBAAmB,IAAI,MAAM;IAI7B,eAAe,IAAI,iBAAiB,GAAG,IAAI;IAI3C,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;OAEG;IACH,4BAA4B,IAAI;QAC9B,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,uBAAuB,EAAE,MAAM,CAAC;QAChC,kBAAkB,EAAE,MAAM,CAAC;KAC5B;IA4BD,OAAO,CAAC,cAAc;IAgDtB;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAwC5C,OAAO,CAAC,yBAAyB;IA0CjC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,cAAc;CAoCvB"}