@agent-foundry/studio 1.0.0 → 1.0.2

package/dist/bff/client.js

@@ -0,0 +1,288 @@
+/**
+ * BFF API Client
+ *
+ * Client for interacting with the BFF Studio API endpoints.
+ * All write operations (create, update, delete) should go through this client.
+ *
+ * The BFF uses SQLAlchemy with service_role credentials, which bypasses RLS.
+ * This is the secure and recommended way to perform write operations.
+ *
+ * @example
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/Users/me/projects/my-app',
+ * });
+ * ```
+ */
+/**
+ * Error thrown by BFF API client
+ */
+export class BFFAPIError extends Error {
+    constructor(message, status, detail, code) {
+        super(message);
+        this.status = status;
+        this.detail = detail;
+        this.code = code;
+        this.name = 'BFFAPIError';
+    }
+}
+/**
+ * Projects API client
+ */
+export class ProjectsAPI {
+    constructor(baseUrl, authToken, timeout) {
+        this.baseUrl = baseUrl;
+        this.authToken = authToken;
+        this.timeout = timeout;
+    }
+    get headers() {
+        return {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.authToken}`,
+        };
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: this.headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let detail;
+                let code;
+                try {
+                    const error = await response.json();
+                    detail = error.detail;
+                    code = error.code;
+                }
+                catch {
+                    detail = await response.text();
+                }
+                throw new BFFAPIError(`BFF API error: ${response.status}`, response.status, detail, code);
+            }
+            // Handle 204 No Content
+            if (response.status === 204) {
+                return undefined;
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Create a new project
+     */
+    async create(input) {
+        const request = {
+            name: input.name,
+            slug: input.slug,
+            description: input.description,
+            rootPath: input.rootPath,
+            framework: input.framework,
+            config: input.config,
+            parentProjectId: input.parentProjectId,
+        };
+        return this.request('POST', '/studio/projects', request);
+    }
+    /**
+     * Get a project by ID
+     */
+    async get(id) {
+        return this.request('GET', `/studio/projects/${id}`);
+    }
+    /**
+     * List all projects with optional pagination
+     */
+    async list(options) {
+        const params = new URLSearchParams();
+        if (options?.page)
+            params.set('page', String(options.page));
+        if (options?.pageSize)
+            params.set('pageSize', String(options.pageSize));
+        if (options?.framework)
+            params.set('framework', options.framework);
+        if (options?.search)
+            params.set('search', options.search);
+        const query = params.toString();
+        const path = query ? `/studio/projects?${query}` : '/studio/projects';
+        return this.request('GET', path);
+    }
+    /**
+     * Update a project
+     */
+    async update(id, input) {
+        const request = {
+            name: input.name,
+            description: input.description,
+            config: input.config,
+        };
+        return this.request('PUT', `/studio/projects/${id}`, request);
+    }
+    /**
+     * Delete a project
+     */
+    async delete(id) {
+        return this.request('DELETE', `/studio/projects/${id}`);
+    }
+    /**
+     * Fork a project
+     */
+    async fork(id, options) {
+        const request = {
+            newSlug: options.newSlug,
+            newRootPath: options.newRootPath,
+            newName: options.newName,
+        };
+        return this.request('POST', `/studio/projects/${id}/fork`, request);
+    }
+    /**
+     * Publish a project to Feed
+     */
+    async publish(id, options) {
+        return this.request('POST', `/studio/projects/${id}/publish`, options ?? {});
+    }
+}
+/**
+ * Deployments API client
+ */
+export class DeploymentsAPI {
+    constructor(baseUrl, authToken, timeout) {
+        this.baseUrl = baseUrl;
+        this.authToken = authToken;
+        this.timeout = timeout;
+    }
+    get headers() {
+        return {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.authToken}`,
+        };
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: this.headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let detail;
+                let code;
+                try {
+                    const error = await response.json();
+                    detail = error.detail;
+                    code = error.code;
+                }
+                catch {
+                    detail = await response.text();
+                }
+                throw new BFFAPIError(`BFF API error: ${response.status}`, response.status, detail, code);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Start a new deployment (creates deployment record and returns STS credentials)
+     */
+    async start(input) {
+        const request = {
+            projectId: input.projectId,
+            version: input.version,
+            metadata: input.metadata,
+        };
+        return this.request('POST', '/studio/deployments/start', request);
+    }
+    /**
+     * Get a deployment by ID
+     */
+    async get(id) {
+        return this.request('GET', `/studio/deployments/${id}`);
+    }
+    /**
+     * List deployments for a project
+     */
+    async list(projectId, limit) {
+        const params = new URLSearchParams();
+        if (limit)
+            params.set('limit', String(limit));
+        const query = params.toString();
+        const path = query
+            ? `/studio/projects/${projectId}/deployments?${query}`
+            : `/studio/projects/${projectId}/deployments`;
+        return this.request('GET', path);
+    }
+    /**
+     * Update deployment status
+     */
+    async updateStatus(id, input) {
+        return this.request('PUT', `/studio/deployments/${id}/status`, input);
+    }
+    /**
+     * Mark deployment as complete (after successful OSS upload)
+     */
+    async complete(id, input) {
+        return this.request('POST', `/studio/deployments/${id}/complete`, input);
+    }
+    /**
+     * Mark deployment as failed
+     */
+    async fail(id, input) {
+        return this.request('POST', `/studio/deployments/${id}/fail`, input);
+    }
+}
+/**
+ * Create a new BFF client
+ *
+ * @param config - Client configuration
+ * @returns BFFClient instance
+ *
+ * @example
+ * ```typescript
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/Users/me/projects/my-app',
+ * });
+ *
+ * // Start a deployment
+ * const deployment = await client.deployments.start({
+ *   projectId: project.id,
+ * });
+ * ```
+ */
+export function createBFFClient(config) {
+    const timeout = config.timeout ?? 30000;
+    return {
+        projects: new ProjectsAPI(config.baseUrl, config.authToken, timeout),
+        deployments: new DeploymentsAPI(config.baseUrl, config.authToken, timeout),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/bff/client.js.map

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

package/dist/bff/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * BFF module - API client for BFF Studio endpoints
+ *
+ * Use this for all write operations (create, update, delete).
+ * The BFF uses SQLAlchemy with service_role credentials, which bypasses RLS.
+ *
+ * @example
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project (write operation via BFF)
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/path/to/project',
+ * });
+ * ```
+ */
+export * from './types';
+export { createBFFClient, BFFAPIError, ProjectsAPI, DeploymentsAPI, } from './client';
+export type { BFFClient } from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/bff/index.js

@@ -0,0 +1,26 @@
+/**
+ * BFF module - API client for BFF Studio endpoints
+ *
+ * Use this for all write operations (create, update, delete).
+ * The BFF uses SQLAlchemy with service_role credentials, which bypasses RLS.
+ *
+ * @example
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const client = createBFFClient({
+ *   baseUrl: 'http://localhost:11001',
+ *   authToken: 'your-supabase-jwt',
+ * });
+ *
+ * // Create a project (write operation via BFF)
+ * const project = await client.projects.create({
+ *   name: 'My App',
+ *   slug: 'my-app',
+ *   rootPath: '/path/to/project',
+ * });
+ * ```
+ */
+export * from './types';
+export { createBFFClient, BFFAPIError, ProjectsAPI, DeploymentsAPI, } from './client';
+//# sourceMappingURL=index.js.map

package/dist/bff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/bff/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * BFF API Types
+ *
+ * Response types from the BFF Studio API endpoints.
+ * These match the Pydantic models in services/bff/app/models/studio.py
+ */
+import type { StudioProject, ProjectConfig, ProjectFramework } from '../types/project';
+import type { DeploymentStatus, DeploymentMetadata, AppManifest } from '../types/deployment';
+/**
+ * Request body for creating a project via BFF
+ */
+export interface CreateProjectRequest {
+    name: string;
+    slug: string;
+    description?: string;
+    rootPath: string;
+    framework?: ProjectFramework;
+    config?: ProjectConfig;
+    parentProjectId?: string;
+}
+/**
+ * Request body for updating a project via BFF
+ */
+export interface UpdateProjectRequest {
+    name?: string;
+    description?: string;
+    config?: Partial<ProjectConfig>;
+}
+/**
+ * Request body for forking a project via BFF
+ */
+export interface ForkProjectRequest {
+    newSlug: string;
+    newRootPath: string;
+    newName?: string;
+}
+/**
+ * Project response from BFF API
+ */
+export interface ProjectResponse extends StudioProject {
+    latestDeployment?: DeploymentSummary;
+}
+/**
+ * Paginated project list response
+ */
+export interface ProjectListResponse {
+    projects: ProjectResponse[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/**
+ * Deployment summary (for lists)
+ */
+export interface DeploymentSummary {
+    id: string;
+    version: string;
+    status: DeploymentStatus;
+    ossUrl?: string;
+    bundleSizeBytes?: number;
+    createdAt: string;
+    publishedAt?: string;
+}
+/**
+ * Request body for starting a deployment
+ */
+export interface StartDeploymentRequest {
+    projectId: string;
+    version?: string;
+    metadata?: Partial<DeploymentMetadata>;
+}
+/**
+ * STS credentials for OSS upload
+ */
+export interface STSCredentials {
+    accessKeyId: string;
+    accessKeySecret: string;
+    securityToken: string;
+    expiration: string;
+}
+/**
+ * Response from starting a deployment
+ */
+export interface StartDeploymentResponse {
+    deploymentId: string;
+    credentials: STSCredentials;
+    bucket: string;
+    region: string;
+    keyPrefix: string;
+}
+/**
+ * Request body for updating deployment status
+ */
+export interface UpdateDeploymentStatusRequest {
+    status: DeploymentStatus;
+    buildLog?: string;
+    errorMessage?: string;
+    metadata?: Partial<DeploymentMetadata>;
+}
+/**
+ * Request body for completing a deployment
+ */
+export interface CompleteDeploymentRequest {
+    bucket: string;
+    keyPrefix: string;
+    ossUrl: string;
+    totalBytes: number;
+    fileCount: number;
+}
+/**
+ * Response from completing a deployment
+ */
+export interface CompleteDeploymentResponse {
+    deploymentId: string;
+    ossUrl: string;
+    version: string;
+}
+/**
+ * Request body for failing a deployment
+ */
+export interface FailDeploymentRequest {
+    errorMessage: string;
+    buildLog?: string;
+}
+/**
+ * Deployment list response
+ */
+export interface DeploymentListResponse {
+    deployments: DeploymentSummary[];
+    total: number;
+}
+/**
+ * Request body for publishing to Feed
+ */
+export interface PublishRequest {
+    deploymentId?: string;
+    manifest?: AppManifest;
+    status?: 'canary' | 'stable';
+}
+/**
+ * Response from publishing to Feed
+ */
+export interface PublishResponse {
+    appId: string;
+    artifactId: string;
+    deploymentId: string;
+    shareUrl: string;
+    entryUrl: string;
+}
+/**
+ * API error response
+ */
+export interface APIError {
+    detail: string;
+    code?: string;
+}
+/**
+ * BFF client configuration
+ */
+export interface BFFClientConfig {
+    /** BFF base URL (e.g., "http://localhost:11001") */
+    baseUrl: string;
+    /** Supabase JWT token for authentication */
+    authToken: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/bff/types.js

@@ -0,0 +1,8 @@
+/**
+ * BFF API Types
+ *
+ * Response types from the BFF Studio API endpoints.
+ * These match the Pydantic models in services/bff/app/models/studio.py
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bff/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/db/deployments.d.ts

@@ -1,7 +1,38 @@
 /**
  * Deployments Repository
  *
- * CRUD operations for studio_deployments table.
+ * Provides access to studio_deployments table via Supabase client.
+ *
+ * ## Important: Hybrid Access Pattern
+ *
+ * Due to RLS (Row Level Security) restrictions, this repository should
+ * primarily be used for **read operations only**.
+ *
+ * **For write operations, use the BFF client or DirectUploader:**
+ *
+ * ```typescript
+ * import { DirectUploader } from '@agent-foundry/studio/oss';
+ *
+ * // DirectUploader handles the complete deployment workflow via BFF
+ * const uploader = new DirectUploader({
+ *   bffBaseUrl: 'http://localhost:11001',
+ *   authToken: 'your-jwt-token',
+ * });
+ *
+ * const result = await uploader.upload({
+ *   projectId: 'project-uuid',
+ *   files: distFiles,
+ * });
+ * ```
+ *
+ * Or use the BFF client directly:
+ *
+ * ```typescript
+ * import { createBFFClient } from '@agent-foundry/studio/bff';
+ *
+ * const bff = createBFFClient({ ... });
+ * const deployment = await bff.deployments.start({ projectId: '...' });
+ * ```
  */
 import { SupabaseClient } from '@supabase/supabase-js';
 import type { Deployment, CreateDeploymentInput, UpdateDeploymentInput, DeploymentListFilters } from '../types/deployment';
@@ -14,6 +45,12 @@ export declare class DeploymentsRepository {
     constructor(supabase: SupabaseClient);
     /**
      * Create a new deployment
+     *
+     * @deprecated Use `DirectUploader.upload()` or `createBFFClient().deployments.start()` instead.
+     *
+     * This method may fail with RLS errors. The recommended workflow is:
+     * 1. Use DirectUploader which handles the complete deployment lifecycle
+     * 2. Or use BFF client's deployments.start() to get STS credentials
      */
     create(input: CreateDeploymentInput): Promise<Deployment>;
     /**
@@ -26,18 +63,28 @@ export declare class DeploymentsRepository {
     list(filters?: DeploymentListFilters): Promise<Deployment[]>;
     /**
      * Update a deployment
+     *
+     * @deprecated Use `createBFFClient().deployments.updateStatus()` instead.
+     *
+     * This method may fail with RLS errors. Use BFF client for write operations.
      */
     update(id: string, input: UpdateDeploymentInput): Promise<Deployment>;
     /**
      * Mark deployment as building
+     *
+     * @deprecated Use `createBFFClient().deployments.updateStatus()` instead.
      */
     markBuilding(id: string): Promise<Deployment>;
     /**
      * Mark deployment as uploading
+     *
+     * @deprecated Use `createBFFClient().deployments.updateStatus()` instead.
      */
     markUploading(id: string): Promise<Deployment>;
     /**
      * Mark deployment as published
+     *
+     * @deprecated Use `createBFFClient().deployments.complete()` instead.
      */
     markPublished(id: string, ossInfo: {
         bucket: string;
@@ -47,6 +94,8 @@ export declare class DeploymentsRepository {
     }): Promise<Deployment>;
     /**
      * Mark deployment as failed
+     *
+     * @deprecated Use `createBFFClient().deployments.fail()` instead.
      */
     markFailed(id: string, errorMessage: string, buildLog?: string): Promise<Deployment>;
     /**
@@ -55,11 +104,28 @@ export declare class DeploymentsRepository {
     getLatestPublished(projectId: string): Promise<Deployment | null>;
     /**
      * Delete a deployment
+     *
+     * @deprecated Deployment deletion should be handled server-side.
+     * This method may fail with RLS errors.
      */
     delete(id: string): Promise<void>;
     /**
      * Append to build log
+     *
+     * @deprecated Use `createBFFClient().deployments.updateStatus()` with buildLog field.
+     * This method may fail with RLS errors.
      */
     appendBuildLog(id: string, logLine: string): Promise<void>;
+    /**
+     * Link deployment to an artifact (called after publishing to Feed)
+     *
+     * @deprecated This is handled automatically by BFF's publish workflow.
+     * Use `createBFFClient().projects.publish()` instead.
+     */
+    linkToArtifact(id: string, artifactId: string): Promise<Deployment>;
+    /**
+     * Get deployment by artifact ID
+     */
+    getByArtifactId(artifactId: string): Promise<Deployment | null>;
 }
 //# sourceMappingURL=deployments.d.ts.map

package/dist/db/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/db/deployments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AAyD7B;;GAEG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAEjB,QAAQ,EAAE,cAAc;IAErD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B/D;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiBrD;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoCtE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkD3E;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAInD;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD;;OAEG;IACG,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,UAAU,CAAC;IAWtB;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ1F;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAoBvE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjE"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/db/deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AA2D7B;;GAEG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAEjB,QAAQ,EAAE,cAAc;IAErD;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B/D;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiBrD;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoCtE;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkD3E;;;;OAIG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAInD;;;;OAIG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD;;;;OAIG;IACG,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,UAAU,CAAC;IAWtB;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ1F;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAoBvE;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC;;;;;OAKG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;;;;OAKG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAezE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAgBtE"}