@tinybirdco/sdk 0.0.1

package/dist/api/branches.js

@@ -0,0 +1,203 @@
+/**
+ * Tinybird Branch (Environment) API client
+ * Uses the /v1/environments endpoints (Forward API)
+ */
+/**
+ * Error thrown by branch API operations
+ */
+export class BranchApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "BranchApiError";
+    }
+}
+/**
+ * Poll a job until it completes
+ *
+ * @param config - API configuration
+ * @param jobId - Job ID to poll
+ * @param maxAttempts - Maximum polling attempts (default: 120, i.e. 2 minutes)
+ * @param intervalMs - Polling interval in milliseconds (default: 1000)
+ * @returns Job status when complete
+ */
+async function pollJob(config, jobId, maxAttempts = 120, intervalMs = 1000) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const url = new URL(`/v0/jobs/${jobId}`, config.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${config.token}`,
+            },
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new BranchApiError(`Failed to poll job '${jobId}': ${response.status} ${response.statusText}\nAPI response: ${body}`, response.status, body);
+        }
+        const jobStatus = (await response.json());
+        if (jobStatus.status === "done") {
+            return jobStatus;
+        }
+        if (jobStatus.status === "error") {
+            throw new BranchApiError(`Job '${jobId}' failed: ${jobStatus.error ?? "Unknown error"}`, 500, jobStatus);
+        }
+        // Wait before next poll
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+    throw new BranchApiError(`Job '${jobId}' timed out after ${maxAttempts} attempts`, 408);
+}
+/**
+ * Create a new branch
+ * POST /v1/environments?name={name}
+ *
+ * This is an async operation that returns a job. We poll the job until
+ * it completes, then fetch the branch with its token.
+ *
+ * @param config - API configuration
+ * @param name - Branch name to create
+ * @returns The created branch with token
+ */
+export async function createBranch(config, name) {
+    const url = new URL("/v1/environments", config.baseUrl);
+    url.searchParams.set("name", name);
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        // Provide helpful error message for common cases, but include raw response for debugging
+        let message = `Failed to create branch '${name}': ${response.status} ${response.statusText}`;
+        if (response.status === 403) {
+            message = `Permission denied creating branch '${name}'. ` +
+                `Make sure TINYBIRD_TOKEN is a workspace admin token (not a branch token). ` +
+                `Branch tokens cannot create new branches.\n` +
+                `API response: ${body}`;
+        }
+        else if (response.status === 409) {
+            message = `Branch '${name}' already exists.`;
+        }
+        else {
+            message += `\nAPI response: ${body}`;
+        }
+        throw new BranchApiError(message, response.status, body);
+    }
+    // Parse the job response
+    const jobResponse = (await response.json());
+    if (!jobResponse.job?.id) {
+        throw new BranchApiError(`Unexpected response from branch creation: no job ID returned`, 500, jobResponse);
+    }
+    // Poll the job until it completes
+    await pollJob(config, jobResponse.job.id);
+    // Now fetch the branch with its token using the branch name
+    const branch = await getBranch(config, name);
+    return branch;
+}
+/**
+ * List all branches in the workspace
+ * GET /v1/environments
+ *
+ * @param config - API configuration
+ * @returns Array of branches
+ */
+export async function listBranches(config) {
+    const url = new URL("/v1/environments", config.baseUrl);
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new BranchApiError(`Failed to list branches: ${response.status} ${response.statusText}`, response.status, body);
+    }
+    const data = (await response.json());
+    return data.environments ?? [];
+}
+/**
+ * Get a branch by name with its token
+ * GET /v0/environments/{name}?with_token=true
+ *
+ * @param config - API configuration
+ * @param name - Branch name
+ * @returns Branch with token
+ */
+export async function getBranch(config, name) {
+    const url = new URL(`/v0/environments/${encodeURIComponent(name)}`, config.baseUrl);
+    url.searchParams.set("with_token", "true");
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new BranchApiError(`Failed to get branch '${name}': ${response.status} ${response.statusText}`, response.status, body);
+    }
+    const data = (await response.json());
+    return data;
+}
+/**
+ * Delete a branch
+ * DELETE /v1/environments/{name}
+ *
+ * @param config - API configuration
+ * @param name - Branch name to delete
+ */
+export async function deleteBranch(config, name) {
+    const url = new URL(`/v1/environments/${encodeURIComponent(name)}`, config.baseUrl);
+    const response = await fetch(url.toString(), {
+        method: "DELETE",
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new BranchApiError(`Failed to delete branch '${name}': ${response.status} ${response.statusText}`, response.status, body);
+    }
+}
+/**
+ * Check if a branch exists
+ *
+ * @param config - API configuration
+ * @param name - Branch name to check
+ * @returns true if branch exists, false if not
+ * @throws BranchApiError on API/network/auth failures
+ */
+export async function branchExists(config, name) {
+    const branches = await listBranches(config);
+    return branches.some((b) => b.name === name);
+}
+/**
+ * Get or create a branch
+ * If the branch exists, returns it with token.
+ * If it doesn't exist, creates it.
+ *
+ * @param config - API configuration
+ * @param name - Branch name
+ * @returns Branch with token
+ */
+export async function getOrCreateBranch(config, name) {
+    // First try to get the existing branch
+    try {
+        const branch = await getBranch(config, name);
+        return { ...branch, wasCreated: false };
+    }
+    catch (error) {
+        // If it's a 404, create the branch
+        if (error instanceof BranchApiError && error.status === 404) {
+            const branch = await createBranch(config, name);
+            return { ...branch, wasCreated: true };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=branches.js.map

package/dist/api/branches.js.map

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

package/dist/api/branches.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=branches.test.d.ts.map

package/dist/api/branches.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branches.test.d.ts","sourceRoot":"","sources":["../../src/api/branches.test.ts"],"names":[],"mappings":""}

package/dist/api/branches.test.js

@@ -0,0 +1,286 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { BranchApiError, createBranch, listBranches, getBranch, deleteBranch, branchExists, getOrCreateBranch, } from "./branches.js";
+// Mock fetch globally
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+describe("Branch API client", () => {
+    const config = {
+        baseUrl: "https://api.tinybird.co",
+        token: "p.test-token",
+    };
+    beforeEach(() => {
+        mockFetch.mockReset();
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe("createBranch", () => {
+        it("creates a branch and returns it", async () => {
+            const mockBranch = {
+                id: "branch-123",
+                name: "my-feature",
+                token: "p.branch-token",
+                created_at: "2024-01-01T00:00:00Z",
+            };
+            // 1. POST to /v1/environments returns a job
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({
+                    job: { id: "job-123", status: "waiting" },
+                    workspace: { id: "ws-123" },
+                }),
+            });
+            // 2. Poll job - returns done
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-123", status: "done" }),
+            });
+            // 3. Get branch with token
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockBranch),
+            });
+            const result = await createBranch(config, "my-feature");
+            expect(mockFetch).toHaveBeenCalledTimes(3);
+            expect(mockFetch).toHaveBeenNthCalledWith(1, "https://api.tinybird.co/v1/environments?name=my-feature", {
+                method: "POST",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+            expect(mockFetch).toHaveBeenNthCalledWith(2, "https://api.tinybird.co/v0/jobs/job-123", {
+                method: "GET",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+            expect(mockFetch).toHaveBeenNthCalledWith(3, "https://api.tinybird.co/v0/environments/my-feature?with_token=true", {
+                method: "GET",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+            expect(result).toEqual(mockBranch);
+        });
+        it("polls job until done", async () => {
+            const mockBranch = {
+                id: "branch-123",
+                name: "my-feature",
+                token: "p.branch-token",
+                created_at: "2024-01-01T00:00:00Z",
+            };
+            // 1. POST to /v1/environments returns a job
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({
+                    job: { id: "job-123", status: "waiting" },
+                    workspace: { id: "ws-123" },
+                }),
+            });
+            // 2. Poll job - waiting
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-123", status: "waiting" }),
+            });
+            // 3. Poll job - working
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-123", status: "working" }),
+            });
+            // 4. Poll job - done
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-123", status: "done" }),
+            });
+            // 5. Get branch with token
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockBranch),
+            });
+            // Start the async operation
+            const promise = createBranch(config, "my-feature");
+            // Advance timers and run all pending promises
+            await vi.runAllTimersAsync();
+            const result = await promise;
+            expect(mockFetch).toHaveBeenCalledTimes(5);
+            expect(result).toEqual(mockBranch);
+        });
+        it("throws BranchApiError on job error", async () => {
+            // 1. POST to /v1/environments returns a job
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({
+                    job: { id: "job-123", status: "waiting" },
+                }),
+            });
+            // 2. Poll job - error
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-123", status: "error", error: "Something went wrong" }),
+            });
+            await expect(createBranch(config, "my-feature")).rejects.toThrow(BranchApiError);
+        });
+        it("throws BranchApiError on failure", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                statusText: "Bad Request",
+                text: () => Promise.resolve("Branch already exists"),
+            });
+            await expect(createBranch(config, "existing")).rejects.toThrow(BranchApiError);
+        });
+    });
+    describe("listBranches", () => {
+        it("returns array of branches", async () => {
+            const mockBranches = [
+                { id: "1", name: "feature-a", created_at: "2024-01-01T00:00:00Z" },
+                { id: "2", name: "feature-b", created_at: "2024-01-02T00:00:00Z" },
+            ];
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ environments: mockBranches }),
+            });
+            const result = await listBranches(config);
+            expect(mockFetch).toHaveBeenCalledWith("https://api.tinybird.co/v1/environments", {
+                method: "GET",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+            expect(result).toEqual(mockBranches);
+        });
+        it("returns empty array when no branches", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ environments: undefined }),
+            });
+            const result = await listBranches(config);
+            expect(result).toEqual([]);
+        });
+    });
+    describe("getBranch", () => {
+        it("returns branch with token", async () => {
+            const mockBranch = {
+                id: "branch-123",
+                name: "my-feature",
+                token: "p.branch-token",
+                created_at: "2024-01-01T00:00:00Z",
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockBranch),
+            });
+            const result = await getBranch(config, "my-feature");
+            expect(mockFetch).toHaveBeenCalledWith("https://api.tinybird.co/v0/environments/my-feature?with_token=true", {
+                method: "GET",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+            expect(result).toEqual(mockBranch);
+        });
+        it("throws BranchApiError when branch not found", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 404,
+                statusText: "Not Found",
+                text: () => Promise.resolve("Branch not found"),
+            });
+            await expect(getBranch(config, "nonexistent")).rejects.toThrow(BranchApiError);
+        });
+    });
+    describe("deleteBranch", () => {
+        it("deletes a branch successfully", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+            });
+            await deleteBranch(config, "my-feature");
+            expect(mockFetch).toHaveBeenCalledWith("https://api.tinybird.co/v1/environments/my-feature", {
+                method: "DELETE",
+                headers: {
+                    Authorization: "Bearer p.test-token",
+                },
+            });
+        });
+    });
+    describe("branchExists", () => {
+        it("returns true when branch exists", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({
+                    environments: [
+                        { id: "1", name: "my-feature", created_at: "2024-01-01" },
+                    ],
+                }),
+            });
+            const result = await branchExists(config, "my-feature");
+            expect(result).toBe(true);
+        });
+        it("returns false when branch does not exist", async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ environments: [] }),
+            });
+            const result = await branchExists(config, "nonexistent");
+            expect(result).toBe(false);
+        });
+        it("throws on API error", async () => {
+            mockFetch.mockRejectedValueOnce(new Error("Network error"));
+            await expect(branchExists(config, "any")).rejects.toThrow("Network error");
+        });
+    });
+    describe("getOrCreateBranch", () => {
+        it("returns existing branch if found", async () => {
+            const mockBranch = {
+                id: "branch-123",
+                name: "existing-feature",
+                token: "p.branch-token",
+                created_at: "2024-01-01T00:00:00Z",
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockBranch),
+            });
+            const result = await getOrCreateBranch(config, "existing-feature");
+            expect(result).toEqual({ ...mockBranch, wasCreated: false });
+        });
+        it("creates branch if not found", async () => {
+            const newBranch = {
+                id: "branch-456",
+                name: "new-feature",
+                token: "p.new-token",
+                created_at: "2024-01-02T00:00:00Z",
+            };
+            // 1. getBranch returns 404
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 404,
+                statusText: "Not Found",
+                text: () => Promise.resolve("Not found"),
+            });
+            // 2. createBranch: POST to /v1/environments returns a job
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({
+                    job: { id: "job-456", status: "waiting" },
+                    workspace: { id: "ws-456" },
+                }),
+            });
+            // 3. Poll job - done
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ id: "job-456", status: "done" }),
+            });
+            // 4. Get branch with token
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(newBranch),
+            });
+            const result = await getOrCreateBranch(config, "new-feature");
+            expect(result).toEqual({ ...newBranch, wasCreated: true });
+            expect(mockFetch).toHaveBeenCalledTimes(4);
+        });
+    });
+});
+//# sourceMappingURL=branches.test.js.map

package/dist/api/branches.test.js.map

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

package/dist/api/build.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Build and deploy resources to Tinybird API
+ * Uses the /v1/build endpoint to deploy all resources at once
+ */
+import type { GeneratedResources } from "../generator/index.js";
+/**
+ * Configuration for building/deploying to Tinybird
+ */
+export interface BuildConfig {
+    /** Tinybird API base URL */
+    baseUrl: string;
+    /** API token for authentication */
+    token: string;
+}
+/**
+ * Resource info in the build response
+ */
+export interface ResourceInfo {
+    name: string;
+    type: string;
+}
+/**
+ * Error details from the build endpoint
+ */
+export interface BuildError {
+    filename?: string;
+    type?: string;
+    error: string;
+}
+/**
+ * Build response from the /v1/build endpoint
+ */
+export interface BuildResponse {
+    /** Result status */
+    result: "success" | "failed" | "no_changes";
+    /** Error message if failed (simple error) */
+    error?: string;
+    /** Array of errors if multiple (validation errors) */
+    errors?: BuildError[];
+    /** Build details */
+    build?: {
+        id: string;
+        datasources?: ResourceInfo[];
+        pipes?: ResourceInfo[];
+        /** Names of pipes that were changed in this build */
+        changed_pipe_names?: string[];
+        /** Names of newly created pipes in this build */
+        new_pipe_names?: string[];
+        /** Names of pipes that were deleted in this build */
+        deleted_pipe_names?: string[];
+        /** Names of datasources that were changed in this build */
+        changed_datasource_names?: string[];
+        /** Names of newly created datasources in this build */
+        new_datasource_names?: string[];
+        /** Names of datasources that were deleted in this build */
+        deleted_datasource_names?: string[];
+    };
+}
+/**
+ * Resource changes in a build
+ */
+export interface ResourceChanges {
+    /** Names of resources that were changed */
+    changed: string[];
+    /** Names of newly created resources */
+    created: string[];
+    /** Names of resources that were deleted */
+    deleted: string[];
+}
+/**
+ * Build result with additional metadata
+ */
+export interface BuildApiResult {
+    /** Whether the build was successful */
+    success: boolean;
+    /** Result status from API */
+    result: "success" | "failed" | "no_changes";
+    /** Error message if failed */
+    error?: string;
+    /** Number of datasources deployed */
+    datasourceCount: number;
+    /** Number of pipes deployed */
+    pipeCount: number;
+    /** Build ID if successful */
+    buildId?: string;
+    /** Pipe changes in this build */
+    pipes?: ResourceChanges;
+    /** Datasource changes in this build */
+    datasources?: ResourceChanges;
+    /** @deprecated Use pipes.changed instead */
+    changedPipeNames?: string[];
+    /** @deprecated Use pipes.created instead */
+    newPipeNames?: string[];
+}
+/**
+ * Build and deploy generated resources to Tinybird API
+ *
+ * Uses the /v1/build endpoint which accepts all resources in a single
+ * multipart form request.
+ *
+ * @param config - Build configuration with API URL and token
+ * @param resources - Generated resources to deploy
+ * @returns Build result
+ *
+ * @example
+ * ```ts
+ * const result = await buildToTinybird(
+ *   {
+ *     baseUrl: 'https://api.tinybird.co',
+ *     token: 'p.xxx',
+ *   },
+ *   {
+ *     datasources: [{ name: 'events', content: '...' }],
+ *     pipes: [{ name: 'top_events', content: '...' }],
+ *   }
+ * );
+ *
+ * if (result.success) {
+ *   console.log('Build deployed successfully!');
+ * }
+ * ```
+ */
+export declare function buildToTinybird(config: BuildConfig, resources: GeneratedResources, options?: {
+    debug?: boolean;
+}): Promise<BuildApiResult>;
+/**
+ * Validate that the configuration is complete
+ */
+export declare function validateBuildConfig(config: Partial<BuildConfig>): asserts config is BuildConfig;
+//# sourceMappingURL=build.d.ts.map

package/dist/api/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/api/build.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC5C,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,oBAAoB;IACpB,KAAK,CAAC,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;QAC7B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,qDAAqD;QACrD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,iDAAiD;QACjD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,qDAAqD;QACrD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,2DAA2D;QAC3D,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;QACpC,uDAAuD;QACvD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,2DAA2D;QAC3D,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;KACrC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC5C,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAuHzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAO/F"}