devflare 0.0.0 → 1.0.0-next.0

package/dist/cloudflare/types.d.ts

@@ -0,0 +1,161 @@
+export interface CloudflareAccount {
+    id: string;
+    name: string;
+    type: 'standard' | 'enterprise' | string;
+    settings?: {
+        enforce_twofactor?: boolean;
+        use_account_custom_ns_by_default?: boolean;
+    };
+    created_on?: string;
+}
+export interface AccountInfo {
+    id: string;
+    name: string;
+    type: string;
+    createdOn?: Date;
+}
+export type CloudflareService = 'workers' | 'kv' | 'd1' | 'r2' | 'ai' | 'vectorize' | 'durable_objects' | 'queues' | 'hyperdrive' | 'browser';
+export interface ServiceStatus {
+    service: CloudflareService;
+    available: boolean;
+    count?: number;
+    details?: Record<string, unknown>;
+}
+export interface WorkerScript {
+    id: string;
+    name?: string;
+    created_on: string;
+    modified_on: string;
+    etag?: string;
+}
+export interface WorkerInfo {
+    name: string;
+    createdOn: Date;
+    modifiedOn: Date;
+}
+export interface KVNamespace {
+    id: string;
+    title: string;
+    supports_url_encoding?: boolean;
+}
+export interface KVNamespaceInfo {
+    id: string;
+    name: string;
+}
+export interface D1Database {
+    uuid: string;
+    name: string;
+    version: string;
+    num_tables?: number;
+    file_size?: number;
+    created_at?: string;
+}
+export interface D1DatabaseInfo {
+    id: string;
+    name: string;
+    version: string;
+    tableCount?: number;
+    sizeBytes?: number;
+}
+export interface R2Bucket {
+    name: string;
+    creation_date: string;
+    location?: string;
+}
+export interface R2BucketInfo {
+    name: string;
+    createdOn: Date;
+    location?: string;
+}
+export interface VectorizeIndex {
+    name: string;
+    description?: string;
+    config: {
+        dimensions: number;
+        metric: 'cosine' | 'euclidean' | 'dot-product';
+    };
+    created_on?: string;
+    modified_on?: string;
+}
+export interface VectorizeIndexInfo {
+    name: string;
+    dimensions: number;
+    metric: string;
+    description?: string;
+}
+export interface AIModel {
+    id: string;
+    name: string;
+    description?: string;
+    task?: {
+        id: string;
+        name: string;
+        description?: string;
+    };
+    properties?: Array<{
+        property_id: string;
+        value: string;
+    }>;
+}
+export interface AIModelInfo {
+    id: string;
+    name: string;
+    task?: string;
+    description?: string;
+}
+export interface UsageRecord {
+    service: CloudflareService;
+    /** ISO date string (YYYY-MM-DD) */
+    date: string;
+    /** Usage count (requests, tokens, bytes, etc.) */
+    count: number;
+    /** Last updated timestamp */
+    updatedAt: string;
+}
+export interface UsageLimits {
+    /** Daily limit for AI tokens (across all models) */
+    aiTokensPerDay?: number;
+    /** Daily limit for AI requests */
+    aiRequestsPerDay?: number;
+    /** Daily limit for Vectorize operations */
+    vectorizeOpsPerDay?: number;
+    /** Whether limits are enabled */
+    enabled: boolean;
+}
+export interface UsageSummary {
+    service: CloudflareService;
+    today: number;
+    limit?: number;
+    withinLimit: boolean;
+    percentUsed?: number;
+}
+export interface CloudflareAPIResponse<T> {
+    success: boolean;
+    errors: Array<{
+        code: number;
+        message: string;
+    }>;
+    messages: Array<{
+        code: number;
+        message: string;
+    }>;
+    result: T;
+    result_info?: {
+        page: number;
+        per_page: number;
+        total_pages: number;
+        count: number;
+        total_count: number;
+    };
+}
+export interface WranglerAuth {
+    /** OAuth token from wrangler config */
+    oauthToken?: string;
+    /** API token (if explicitly set) */
+    apiToken?: string;
+    /** Refresh token for OAuth */
+    refreshToken?: string;
+    /** Token expiry time */
+    expiresAt?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cloudflare/types.d.ts.map

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

package/dist/cloudflare/usage.d.ts

@@ -0,0 +1,77 @@
+import type { CloudflareService, UsageLimits, UsageRecord, UsageSummary } from './types';
+/**
+ * Get usage for a specific service on a specific date
+ */
+export declare function getUsage(accountId: string, service: CloudflareService, date?: string): Promise<UsageRecord | null>;
+/**
+ * Record usage for a service
+ */
+export declare function recordUsage(accountId: string, service: CloudflareService, count?: number): Promise<UsageRecord>;
+/**
+ * Reset usage for a service (typically called when limits are adjusted)
+ */
+export declare function resetUsage(accountId: string, service: CloudflareService): Promise<void>;
+/**
+ * Get the current usage limits
+ */
+export declare function getLimits(accountId: string): Promise<UsageLimits>;
+/**
+ * Update usage limits
+ */
+export declare function setLimits(accountId: string, limits: Partial<UsageLimits>): Promise<UsageLimits>;
+/**
+ * Enable or disable limits enforcement
+ */
+export declare function setLimitsEnabled(accountId: string, enabled: boolean): Promise<UsageLimits>;
+/**
+ * Check if usage is within limits for a service
+ */
+export declare function isWithinLimits(accountId: string, service: CloudflareService): Promise<boolean>;
+/**
+ * Get usage summary for a service
+ */
+export declare function getUsageSummary(accountId: string, service: CloudflareService): Promise<UsageSummary>;
+/**
+ * Get usage summary for all tracked services
+ */
+export declare function getAllUsageSummaries(accountId: string): Promise<UsageSummary[]>;
+/**
+ * Check if we can proceed with testing for a specific service
+ * Returns true if within limits, false if limits exceeded
+ *
+ * Use this before running tests that use remote bindings
+ */
+export declare function canProceedWithTest(accountId: string, service: CloudflareService): Promise<{
+    allowed: boolean;
+    reason?: string;
+}>;
+/**
+ * Record that a test used a remote service
+ * Call this after successful test execution
+ */
+export declare function recordTestUsage(accountId: string, service: CloudflareService, count?: number): Promise<void>;
+/**
+ * Check if tests for a service should be skipped
+ *
+ * Returns `true` if tests should be SKIPPED (service not available)
+ * Returns `false` if tests can proceed
+ *
+ * Automatically logs the skip reason to console.
+ *
+ * NOTE: This function is read-only and catches all errors gracefully.
+ * If Cloudflare is unreachable, auth fails, or limits can't be checked,
+ * it will return true (skip) with an appropriate message.
+ *
+ * Usage:
+ * ```ts
+ * import { account } from 'devflare/cloudflare'
+ *
+ * const skipAI = await account.shouldSkip('ai')
+ *
+ * describe.skipIf(skipAI)('AI tests', () => {
+ *   // ...
+ * })
+ * ```
+ */
+export declare function shouldSkip(service: CloudflareService): Promise<boolean>;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cloudflare/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cloudflare/usage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,YAAY,EAEZ,MAAM,SAAS,CAAA;AA+DhB;;GAEG;AACH,wBAAsB,QAAQ,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiB7B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,GAAE,MAAU,GACf,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAaf;AAMD;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAavE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,CAEtB;AAMD;;GAEG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAMrF;AAMD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBhD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,GAAE,MAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAWD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAsC7E"}

package/dist/config/compiler.d.ts

@@ -0,0 +1,146 @@
+import { type DevflareConfig } from './schema';
+/**
+ * Wrangler config type — represents the output format for wrangler.jsonc
+ */
+export interface WranglerConfig {
+    name: string;
+    account_id?: string;
+    main?: string;
+    compatibility_date: string;
+    compatibility_flags?: string[];
+    kv_namespaces?: Array<{
+        binding: string;
+        id: string;
+    }>;
+    d1_databases?: Array<{
+        binding: string;
+        database_id: string;
+    }>;
+    r2_buckets?: Array<{
+        binding: string;
+        bucket_name: string;
+    }>;
+    durable_objects?: {
+        bindings: Array<{
+            name: string;
+            class_name: string;
+            script_name?: string;
+        }>;
+    };
+    queues?: {
+        producers?: Array<{
+            binding: string;
+            queue: string;
+        }>;
+        consumers?: Array<{
+            queue: string;
+            max_batch_size?: number;
+            max_batch_timeout?: number;
+            max_retries?: number;
+            dead_letter_queue?: string;
+            max_concurrency?: number;
+            retry_delay?: number;
+        }>;
+    };
+    services?: Array<{
+        binding: string;
+        service: string;
+        environment?: string;
+    }>;
+    ai?: {
+        binding: string;
+    };
+    vectorize?: Array<{
+        binding: string;
+        index_name: string;
+    }>;
+    hyperdrive?: Array<{
+        binding: string;
+        id: string;
+    }>;
+    browser?: {
+        binding: string;
+    };
+    analytics_engine_datasets?: Array<{
+        binding: string;
+        dataset: string;
+    }>;
+    triggers?: {
+        crons?: string[];
+    };
+    vars?: Record<string, string>;
+    routes?: Array<{
+        pattern: string;
+        zone_name?: string;
+        zone_id?: string;
+        custom_domain?: boolean;
+    }>;
+    assets?: {
+        directory: string;
+        binding?: string;
+    };
+    observability?: {
+        enabled?: boolean;
+        head_sampling_rate?: number;
+    };
+    limits?: {
+        cpu_ms?: number;
+    };
+    migrations?: Array<{
+        tag: string;
+        new_classes?: string[];
+        renamed_classes?: Array<{
+            from: string;
+            to: string;
+        }>;
+        deleted_classes?: string[];
+        new_sqlite_classes?: string[];
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Compile DevflareConfig to WranglerConfig
+ *
+ * @param config - The devflare configuration
+ * @param environment - Optional environment name for env-specific overrides
+ * @returns Wrangler-compatible configuration object
+ */
+export declare function compileConfig(config: DevflareConfig, environment?: string): WranglerConfig;
+/**
+ * Compile DevflareConfig to programmatic config for @cloudflare/vite-plugin
+ * This is used instead of wrangler.jsonc in dev mode
+ *
+ * @param config - The devflare configuration
+ * @param environment - Optional environment name for env-specific overrides
+ * @returns Config object compatible with cloudflare({ config: ... })
+ */
+export declare function compileToProgrammaticConfig(config: DevflareConfig, environment?: string): Record<string, unknown>;
+/**
+ * Convert WranglerConfig to JSONC string with comments
+ */
+export declare function stringifyConfig(config: WranglerConfig): string;
+/**
+ * Write wrangler.jsonc file to the specified directory
+ *
+ * @param cwd - Working directory to write to
+ * @param config - Wrangler configuration to write
+ * @param filename - Optional filename (default: 'wrangler.jsonc')
+ * @returns Path to the written file
+ */
+export declare function writeWranglerConfig(cwd: string, config: WranglerConfig, filename?: string): Promise<string>;
+/**
+ * Compile DO Worker config from DevflareConfig
+ * This creates a separate worker config that exports the DO classes
+ *
+ * @param config - The devflare configuration
+ * @param doWorkerEntry - Path to the DO worker entry file (e.g., 'src/workers/do-worker.ts')
+ * @param options - Additional options
+ * @param options.absoluteMain - If true, resolve main to absolute path using cwd
+ * @param options.cwd - Working directory for resolving absolute paths
+ * @returns Wrangler config for the DO worker, or null if no DOs configured
+ */
+export declare function compileDOWorkerConfig(config: DevflareConfig, doWorkerEntry: string, options?: {
+    absoluteMain?: boolean;
+    cwd?: string;
+}): WranglerConfig | null;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/config/compiler.d.ts.map

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

package/dist/config/define.d.ts

@@ -0,0 +1,44 @@
+import type { DevflareConfigInput } from './schema';
+/**
+ * Input type for defineConfig - can be object, function, or async function
+ * Uses the Zod input type so optional fields with defaults are truly optional
+ */
+export type DefineConfigInput = DevflareConfigInput | (() => DevflareConfigInput) | (() => Promise<DevflareConfigInput>);
+/**
+ * Configuration with entrypoints type attached for ref() type inference.
+ * This is used by ref() to provide autocomplete for entrypoint names.
+ */
+export interface TypedConfig<TEntrypoints extends string = string> extends DevflareConfigInput {
+    /** @internal Type marker for entrypoint names - used by ref() for autocomplete */
+    readonly __entrypoints?: TEntrypoints;
+}
+/**
+ * Type-safe helper for defining devflare configuration.
+ *
+ * @typeParam TEntrypoints - Union of valid entrypoint names (from generated types)
+ *
+ * @example
+ * // Basic usage (entrypoints default to string)
+ * export default defineConfig({
+ *   name: 'my-worker'
+ * })
+ *
+ * @example
+ * // With generated entrypoints type (after `devflare types`)
+ * // env.d.ts exports: type Entrypoints = 'AdminEntrypoint' | 'OtherEntrypoint'
+ * export default defineConfig<import('./env').Entrypoints>({
+ *   name: 'my-worker',
+ *   files: { fetch: 'worker.ts' }
+ * })
+ *
+ * @example
+ * // Function config
+ * export default defineConfig(() => ({
+ *   name: process.env.WORKER_NAME ?? 'my-worker',
+ *   compatibilityDate: '2025-01-07'
+ * }))
+ */
+export declare function defineConfig<TEntrypoints extends string = string>(config: DevflareConfigInput): TypedConfig<TEntrypoints>;
+export declare function defineConfig<TEntrypoints extends string = string>(config: () => DevflareConfigInput): TypedConfig<TEntrypoints>;
+export declare function defineConfig<TEntrypoints extends string = string>(config: () => Promise<DevflareConfigInput>): Promise<TypedConfig<TEntrypoints>>;
+//# sourceMappingURL=define.d.ts.map

package/dist/config/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAC1B,mBAAmB,GACnB,CAAC,MAAM,mBAAmB,CAAC,GAC3B,CAAC,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAA;AAEvC;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,mBAAmB;IAC7F,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,EAChE,MAAM,EAAE,mBAAmB,GACzB,WAAW,CAAC,YAAY,CAAC,CAAA;AAC5B,wBAAgB,YAAY,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,EAChE,MAAM,EAAE,MAAM,mBAAmB,GAC/B,WAAW,CAAC,YAAY,CAAC,CAAA;AAC5B,wBAAgB,YAAY,CAAC,YAAY,SAAS,MAAM,GAAG,MAAM,EAChE,MAAM,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GACxC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAA"}

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export { defineConfig } from './define';
+export { configSchema, normalizeDOBinding, type DevflareConfig, type DevflareConfigInput, type DevflareEnvConfig, type DurableObjectBinding, type NormalizedDOBinding, type QueueConsumer, type QueuesConfig, type ServiceBinding, type RouteConfig, type WsRouteConfig, type AssetsConfig, type BuildConfig, type MigrationConfig } from './schema';
+export { compileConfig, stringifyConfig, writeWranglerConfig, type WranglerConfig } from './compiler';
+export { loadConfig, resolveConfigPath, ConfigNotFoundError, ConfigValidationError, type LoadConfigOptions } from './loader';
+export { ref, resolveRef, serviceBinding, type RefResult, type WorkerBinding, type WorkerBindingAccessor, type DOBindingRef } from './ref';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AACrG,OAAO,EACN,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACN,GAAG,EACH,UAAU,EACV,cAAc,EACd,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,MAAM,OAAO,CAAA"}

package/dist/config/loader.d.ts

@@ -0,0 +1,52 @@
+import { type DevflareConfig } from './schema';
+/**
+ * Options for loading config
+ */
+export interface LoadConfigOptions {
+    /** Working directory to search for config */
+    cwd?: string;
+    /** Custom config file name */
+    configFile?: string;
+    /** Environment name for env-specific overrides */
+    environment?: string;
+}
+/**
+ * Resolve the config file path in a directory
+ *
+ * @param cwd - Directory to search in
+ * @returns Path to config file or undefined
+ */
+export declare function resolveConfigPath(cwd: string): Promise<string | undefined>;
+/**
+ * Load and validate devflare configuration
+ *
+ * @param options - Loading options
+ * @returns Validated DevflareConfig
+ * @throws When config file not found or validation fails
+ */
+export declare function loadConfig(options?: LoadConfigOptions): Promise<DevflareConfig>;
+/**
+ * Error thrown when config file is not found
+ */
+export declare class ConfigNotFoundError extends Error {
+    readonly cwd: string;
+    readonly configFile: string;
+    readonly code = "CONFIG_NOT_FOUND";
+    constructor(cwd: string, configFile: string);
+}
+/**
+ * Error thrown when config validation fails
+ */
+export declare class ConfigValidationError extends Error {
+    readonly issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>;
+    readonly configFile: string;
+    readonly code = "CONFIG_VALIDATION_ERROR";
+    constructor(issues: Array<{
+        path: (string | number)[];
+        message: string;
+    }>, configFile: string);
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAYD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQhF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BzF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAI5B,GAAG,EAAE,MAAM;aACX,UAAU,EAAE,MAAM;IAJnC,QAAQ,CAAC,IAAI,sBAAqB;IAElC,YACiB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAQlC;CACD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAI9B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;aAC7D,UAAU,EAAE,MAAM;IAJnC,QAAQ,CAAC,IAAI,6BAA4B;IAEzC,YACiB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7D,UAAU,EAAE,MAAM,EAUlC;CACD"}