crewly 1.20.29 → 1.20.30

package/dist/backend/backend/src/services/canva/canva.service.d.ts

@@ -0,0 +1,184 @@
+/**
+ * CanvaService — Canva Connect REST on the owner's grant.
+ *
+ * What agents can do: find designs, create a blank design (preset type or
+ * custom size, optionally from an uploaded asset), export a design
+ * (PDF / PNG / JPG / PPTX / GIF / MP4 — an async job, polled here to a
+ * download URL), and upload images / videos as assets. Video *generation*
+ * is not in the API: agents fill, duplicate and export, they do not render
+ * from scratch. Brand templates need Canva Enterprise and are not wired.
+ *
+ * @module services/canva/canva.service
+ */
+/** Token provider slice. */
+export interface CanvaTokenProvider {
+    getAccessToken(): Promise<string>;
+    clearCache(): void;
+}
+/** Service dependencies. */
+export interface CanvaApiDeps {
+    tokens: CanvaTokenProvider;
+    fetchImpl?: typeof fetch;
+    /** Sleep between job polls (injectable for tests). */
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+/** A design, trimmed. */
+export interface CanvaDesign {
+    id: string;
+    title: string;
+    editUrl?: string;
+    viewUrl?: string;
+    thumbnailUrl?: string;
+    pageCount?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** List input. */
+export interface CanvaListInput {
+    query?: string;
+    ownership?: 'any' | 'owned' | 'shared';
+    sortBy?: 'relevance' | 'modified_descending' | 'modified_ascending' | 'title_descending' | 'title_ascending';
+    limit?: number;
+    continuation?: string;
+}
+/** Create input. */
+export interface CanvaCreateInput {
+    title?: string;
+    /** `doc` | `whiteboard` | `presentation` */
+    preset?: string;
+    /** Custom size in px (40–8000) */
+    width?: number;
+    height?: number;
+    /** Start from an uploaded asset (image) */
+    assetId?: string;
+}
+/** Export input. */
+export interface CanvaExportInput {
+    designId: string;
+    format: string;
+    /** JPG quality 1–100 (default 80) */
+    quality?: number;
+    /** MP4 quality preset, e.g. `horizontal_1080p` (default) */
+    videoQuality?: string;
+    /** Page numbers (1-based) */
+    pages?: number[];
+}
+/** Export result. */
+export interface CanvaExport {
+    jobId: string;
+    status: 'success' | 'failed' | 'in_progress';
+    /** Download URLs (short-lived), one per file */
+    urls: string[];
+    error?: {
+        code?: string;
+        message?: string;
+    };
+}
+/** An uploaded asset. */
+export interface CanvaAsset {
+    id: string;
+    name: string;
+    thumbnailUrl?: string;
+    createdAt?: string;
+}
+interface WireDesign {
+    id?: string;
+    title?: string;
+    urls?: {
+        edit_url?: string;
+        view_url?: string;
+    };
+    thumbnail?: {
+        url?: string;
+    };
+    page_count?: number;
+    created_at?: number;
+    updated_at?: number;
+}
+/**
+ * Trim a Canva design resource.
+ *
+ * @param d - Wire design
+ * @returns Trimmed
+ */
+export declare function toDesign(d: WireDesign): CanvaDesign;
+/**
+ * The `format` object for an export job.
+ *
+ * @param input - Export input
+ * @returns Canva format object
+ * @throws CanvaError(400, validation) for an unknown format / bad quality
+ */
+export declare function buildExportFormat(input: CanvaExportInput): Record<string, unknown>;
+/**
+ * Canva Connect calls.
+ */
+export declare class CanvaService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider, fetch, sleep
+     */
+    constructor(deps: CanvaApiDeps);
+    /**
+     * `GET /designs` — search / list.
+     *
+     * @param input - Query, ownership, sort, limit, continuation
+     * @returns Designs + continuation token
+     */
+    listDesigns(input?: CanvaListInput): Promise<{
+        designs: CanvaDesign[];
+        continuation?: string;
+    }>;
+    /**
+     * `GET /designs/:id`.
+     *
+     * @param id - Design id
+     * @returns The design
+     */
+    getDesign(id: string): Promise<CanvaDesign>;
+    /**
+     * `POST /designs` — a new design from a preset type, a custom size, or an asset.
+     *
+     * @param input - Title + type/size/asset
+     * @returns The new design (with editUrl)
+     * @throws CanvaError(400, validation) when neither a valid preset, size nor asset is given
+     */
+    createDesign(input: CanvaCreateInput): Promise<CanvaDesign>;
+    /**
+     * `POST /exports` then poll `GET /exports/:id` until done.
+     *
+     * @param input - Design, format, options
+     * @returns Download URLs (or the failure)
+     */
+    exportDesign(input: CanvaExportInput): Promise<CanvaExport>;
+    /**
+     * `POST /asset-uploads` (binary body) then poll `GET /asset-uploads/:id`.
+     *
+     * @param name - Asset name (≤ 50 chars)
+     * @param bytes - File content
+     * @returns The asset
+     * @throws CanvaError(400, validation) for an empty/oversized file; 502 when the job fails
+     */
+    uploadAsset(name: string, bytes: Buffer): Promise<CanvaAsset>;
+    /**
+     * Poll a job until it leaves `in_progress` or the ceiling passes.
+     *
+     * @param url - Job URL
+     * @param first - The job as returned by the create call
+     * @returns The final job
+     */
+    private pollJob;
+    /**
+     * Authenticated call; 401 drops the cached token, 403/404/429 pass
+     * through, other failures fold into 502.
+     *
+     * @param url - Absolute URL
+     * @param init - Method / body / headers
+     * @returns Parsed JSON
+     */
+    private request;
+}
+export {};
+//# sourceMappingURL=canva.service.d.ts.map

package/dist/backend/backend/src/services/canva/canva.service.d.ts.map

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

package/dist/backend/backend/src/services/canva/canva.service.js

@@ -0,0 +1,274 @@
+/**
+ * CanvaService — Canva Connect REST on the owner's grant.
+ *
+ * What agents can do: find designs, create a blank design (preset type or
+ * custom size, optionally from an uploaded asset), export a design
+ * (PDF / PNG / JPG / PPTX / GIF / MP4 — an async job, polled here to a
+ * download URL), and upload images / videos as assets. Video *generation*
+ * is not in the API: agents fill, duplicate and export, they do not render
+ * from scratch. Brand templates need Canva Enterprise and are not wired.
+ *
+ * @module services/canva/canva.service
+ */
+import { CANVA_CONSTANTS } from '../../constants.js';
+import { CanvaError } from './canva-token.service.js';
+/**
+ * Trim a Canva design resource.
+ *
+ * @param d - Wire design
+ * @returns Trimmed
+ */
+export function toDesign(d) {
+    return {
+        id: d.id ?? '',
+        title: d.title ?? '',
+        ...(d.urls?.edit_url ? { editUrl: d.urls.edit_url } : {}),
+        ...(d.urls?.view_url ? { viewUrl: d.urls.view_url } : {}),
+        ...(d.thumbnail?.url ? { thumbnailUrl: d.thumbnail.url } : {}),
+        ...(d.page_count !== undefined ? { pageCount: d.page_count } : {}),
+        ...(d.created_at ? { createdAt: new Date(d.created_at * 1000).toISOString() } : {}),
+        ...(d.updated_at ? { updatedAt: new Date(d.updated_at * 1000).toISOString() } : {}),
+    };
+}
+/**
+ * The `format` object for an export job.
+ *
+ * @param input - Export input
+ * @returns Canva format object
+ * @throws CanvaError(400, validation) for an unknown format / bad quality
+ */
+export function buildExportFormat(input) {
+    const CODES = CANVA_CONSTANTS.ERROR_CODES;
+    const type = (input.format ?? '').trim().toLowerCase();
+    if (!CANVA_CONSTANTS.EXPORT_FORMATS.includes(type)) {
+        throw new CanvaError(400, CODES.VALIDATION, `format must be one of ${CANVA_CONSTANTS.EXPORT_FORMATS.join(', ')}`);
+    }
+    const pages = (input.pages ?? []).map((p) => Number(p)).filter((p) => Number.isInteger(p) && p > 0);
+    const format = { type, ...(pages.length ? { pages } : {}) };
+    if (type === 'jpg') {
+        const quality = input.quality ?? 80;
+        if (!Number.isInteger(quality) || quality < 1 || quality > 100)
+            throw new CanvaError(400, CODES.VALIDATION, 'quality must be 1–100');
+        format.quality = quality;
+    }
+    if (type === 'mp4')
+        format.quality = (input.videoQuality ?? '').trim() || 'horizontal_1080p';
+    return format;
+}
+/**
+ * Canva Connect calls.
+ */
+export class CanvaService {
+    deps;
+    base = CANVA_CONSTANTS.API_BASE;
+    /**
+     * @param deps - Token provider, fetch, sleep
+     */
+    constructor(deps) {
+        this.deps = {
+            ...deps,
+            fetchImpl: deps.fetchImpl ?? fetch,
+            sleep: deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms))),
+            now: deps.now ?? (() => Date.now()),
+        };
+    }
+    /**
+     * `GET /designs` — search / list.
+     *
+     * @param input - Query, ownership, sort, limit, continuation
+     * @returns Designs + continuation token
+     */
+    async listDesigns(input = {}) {
+        const limit = Math.min(Math.max(1, input.limit ?? CANVA_CONSTANTS.DESIGNS_DEFAULT_LIMIT), CANVA_CONSTANTS.DESIGNS_LIMIT_CEILING);
+        const url = new URL(`${this.base}/designs`);
+        url.searchParams.set('limit', String(limit));
+        if (input.query?.trim())
+            url.searchParams.set('query', input.query.trim());
+        if (input.ownership)
+            url.searchParams.set('ownership', input.ownership);
+        if (input.sortBy)
+            url.searchParams.set('sort_by', input.sortBy);
+        if (input.continuation)
+            url.searchParams.set('continuation', input.continuation);
+        const data = await this.request(url.toString());
+        return { designs: (data.items ?? []).map(toDesign), ...(data.continuation ? { continuation: data.continuation } : {}) };
+    }
+    /**
+     * `GET /designs/:id`.
+     *
+     * @param id - Design id
+     * @returns The design
+     */
+    async getDesign(id) {
+        const designId = (id ?? '').trim();
+        if (!designId)
+            throw new CanvaError(400, CANVA_CONSTANTS.ERROR_CODES.VALIDATION, '"id" is required');
+        const data = await this.request(`${this.base}/designs/${encodeURIComponent(designId)}`);
+        return toDesign(data.design ?? {});
+    }
+    /**
+     * `POST /designs` — a new design from a preset type, a custom size, or an asset.
+     *
+     * @param input - Title + type/size/asset
+     * @returns The new design (with editUrl)
+     * @throws CanvaError(400, validation) when neither a valid preset, size nor asset is given
+     */
+    async createDesign(input) {
+        const CODES = CANVA_CONSTANTS.ERROR_CODES;
+        const body = {};
+        const title = (input.title ?? '').trim();
+        if (title)
+            body.title = title.slice(0, 255);
+        const preset = (input.preset ?? '').trim().toLowerCase();
+        if (preset) {
+            if (!CANVA_CONSTANTS.PRESET_DESIGN_TYPES.includes(preset)) {
+                throw new CanvaError(400, CODES.VALIDATION, `preset must be one of ${CANVA_CONSTANTS.PRESET_DESIGN_TYPES.join(', ')} (or give width/height)`);
+            }
+            body.design_type = { type: 'preset', name: preset };
+        }
+        else if (input.width !== undefined || input.height !== undefined) {
+            const w = Number(input.width);
+            const h = Number(input.height);
+            if (![w, h].every((v) => Number.isInteger(v) && v >= 40 && v <= 8000)) {
+                throw new CanvaError(400, CODES.VALIDATION, 'width and height must be integers between 40 and 8000');
+            }
+            body.design_type = { type: 'custom', width: w, height: h };
+        }
+        if (input.assetId?.trim())
+            body.asset_id = input.assetId.trim();
+        if (!body.design_type && !body.asset_id) {
+            throw new CanvaError(400, CODES.VALIDATION, 'give a preset (doc|whiteboard|presentation), a width+height, or an assetId');
+        }
+        const data = await this.request(`${this.base}/designs`, { method: 'POST', body });
+        return toDesign(data.design ?? {});
+    }
+    /**
+     * `POST /exports` then poll `GET /exports/:id` until done.
+     *
+     * @param input - Design, format, options
+     * @returns Download URLs (or the failure)
+     */
+    async exportDesign(input) {
+        const designId = (input.designId ?? '').trim();
+        if (!designId)
+            throw new CanvaError(400, CANVA_CONSTANTS.ERROR_CODES.VALIDATION, '"designId" is required');
+        const format = buildExportFormat(input);
+        const started = await this.request(`${this.base}/exports`, { method: 'POST', body: { design_id: designId, format } });
+        const job = await this.pollJob(`${this.base}/exports/${encodeURIComponent(started.job?.id ?? '')}`, started.job);
+        return { jobId: job.id ?? '', status: job.status ?? 'failed', urls: job.urls ?? [], ...(job.error ? { error: job.error } : {}) };
+    }
+    /**
+     * `POST /asset-uploads` (binary body) then poll `GET /asset-uploads/:id`.
+     *
+     * @param name - Asset name (≤ 50 chars)
+     * @param bytes - File content
+     * @returns The asset
+     * @throws CanvaError(400, validation) for an empty/oversized file; 502 when the job fails
+     */
+    async uploadAsset(name, bytes) {
+        const CODES = CANVA_CONSTANTS.ERROR_CODES;
+        const assetName = (name ?? '').trim().slice(0, 50);
+        if (!assetName)
+            throw new CanvaError(400, CODES.VALIDATION, '"name" is required');
+        if (!bytes || bytes.length === 0)
+            throw new CanvaError(400, CODES.VALIDATION, 'file is empty');
+        if (bytes.length > CANVA_CONSTANTS.ASSET_MAX_BYTES)
+            throw new CanvaError(400, CODES.VALIDATION, `file exceeds ${CANVA_CONSTANTS.ASSET_MAX_BYTES} bytes`);
+        const started = await this.request(`${this.base}/asset-uploads`, {
+            method: 'POST',
+            rawBody: bytes,
+            headers: {
+                'Content-Type': 'application/octet-stream',
+                'Asset-Upload-Metadata': JSON.stringify({ name_base64: Buffer.from(assetName, 'utf8').toString('base64') }),
+            },
+        });
+        const job = await this.pollJob(`${this.base}/asset-uploads/${encodeURIComponent(started.job?.id ?? '')}`, started.job);
+        if (job.status !== 'success' || !job.asset) {
+            throw new CanvaError(502, CODES.CANVA_ERROR, `Asset upload failed: ${job.error?.message ?? job.error?.code ?? job.status}`);
+        }
+        return {
+            id: job.asset.id ?? '',
+            name: job.asset.name ?? assetName,
+            ...(job.asset.thumbnail?.url ? { thumbnailUrl: job.asset.thumbnail.url } : {}),
+            ...(job.asset.created_at ? { createdAt: new Date(job.asset.created_at * 1000).toISOString() } : {}),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    /**
+     * Poll a job until it leaves `in_progress` or the ceiling passes.
+     *
+     * @param url - Job URL
+     * @param first - The job as returned by the create call
+     * @returns The final job
+     */
+    async pollJob(url, first) {
+        let job = first ?? {};
+        const deadline = this.deps.now() + CANVA_CONSTANTS.JOB_POLL_TIMEOUT_MS;
+        while (job.status === 'in_progress' && this.deps.now() < deadline) {
+            await this.deps.sleep(CANVA_CONSTANTS.JOB_POLL_INTERVAL_MS);
+            job = (await this.request(url)).job ?? {};
+        }
+        if (job.status === 'in_progress') {
+            throw new CanvaError(504, CANVA_CONSTANTS.ERROR_CODES.CANVA_ERROR, `Canva job ${job.id ?? ''} is still running after ${CANVA_CONSTANTS.JOB_POLL_TIMEOUT_MS / 1000}s`);
+        }
+        return job;
+    }
+    /**
+     * Authenticated call; 401 drops the cached token, 403/404/429 pass
+     * through, other failures fold into 502.
+     *
+     * @param url - Absolute URL
+     * @param init - Method / body / headers
+     * @returns Parsed JSON
+     */
+    async request(url, init = {}) {
+        const CODES = CANVA_CONSTANTS.ERROR_CODES;
+        const token = await this.deps.tokens.getAccessToken();
+        let res;
+        try {
+            res = await this.deps.fetchImpl(url, {
+                method: init.method ?? 'GET',
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    Accept: 'application/json',
+                    ...(init.body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+                    ...(init.headers ?? {}),
+                },
+                body: init.rawBody ?? (init.body !== undefined ? JSON.stringify(init.body) : undefined),
+                signal: AbortSignal.timeout(CANVA_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (err) {
+            throw new CanvaError(502, CODES.NETWORK, `Canva unreachable: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const text = await res.text();
+        if (!res.ok) {
+            let message = `Canva request failed (${res.status})`;
+            try {
+                const parsed = JSON.parse(text);
+                message = parsed.message ?? parsed.code ?? message;
+            }
+            catch {
+                if (text)
+                    message = text.slice(0, 200);
+            }
+            if (res.status === 401) {
+                this.deps.tokens.clearCache();
+                throw new CanvaError(401, CODES.CANVA_ERROR, `Canva rejected the access token: ${message}`);
+            }
+            const passthrough = res.status === 403 || res.status === 404 || res.status === 429;
+            throw new CanvaError(passthrough ? res.status : 502, CODES.CANVA_ERROR, message);
+        }
+        if (!text)
+            return {};
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new CanvaError(502, CODES.CANVA_ERROR, 'Canva returned a non-JSON response.');
+        }
+    }
+}
+//# sourceMappingURL=canva.service.js.map

package/dist/backend/backend/src/services/canva/canva.service.js.map

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

package/dist/backend/backend/src/services/google/docs.service.d.ts

@@ -0,0 +1,117 @@
+/**
+ * DocsService — Google Docs over the owner's Workspace grant.
+ *
+ * Reads any document the owner can see (`documents.readonly` /
+ * `drive.readonly`) and creates or appends to documents Crewly created
+ * (`drive.file`). Appending to a document the owner made elsewhere needs
+ * the `documents` scope, which the grant does not carry yet; Google then
+ * answers 403 and the error says so.
+ *
+ * @module services/google/docs.service
+ */
+import { type GoogleApiDeps } from './google-api.client.js';
+/** A document, flattened. */
+export interface DocText {
+    id: string;
+    title: string;
+    /** Plain text: headings prefixed with `#`, table cells joined with ` | `. */
+    text: string;
+    webViewLink: string;
+}
+/** Create input. */
+export interface DocCreateInput {
+    title: string;
+    /** Initial body (plain text; blank lines make paragraphs). */
+    text?: string;
+}
+interface WireTextRun {
+    content?: string;
+}
+interface WireParagraph {
+    elements?: Array<{
+        textRun?: WireTextRun;
+        endIndex?: number;
+    }>;
+    paragraphStyle?: {
+        namedStyleType?: string;
+    };
+    bullet?: unknown;
+}
+interface WireStructuralElement {
+    endIndex?: number;
+    paragraph?: WireParagraph;
+    table?: {
+        tableRows?: Array<{
+            tableCells?: Array<{
+                content?: WireStructuralElement[];
+            }>;
+        }>;
+    };
+    sectionBreak?: unknown;
+}
+interface WireDocument {
+    documentId?: string;
+    title?: string;
+    body?: {
+        content?: WireStructuralElement[];
+    };
+}
+/**
+ * Flatten a document body to plain text.
+ *
+ * @param content - `body.content`
+ * @returns Lines joined with `\n`
+ */
+export declare function flattenDocBody(content: WireStructuralElement[] | undefined): string;
+/**
+ * The document's end index (where `insertText` appends).
+ *
+ * @param doc - Document
+ * @returns Index just before the final newline (Docs refuses inserts after it)
+ */
+export declare function docEndIndex(doc: WireDocument): number;
+/**
+ * Docs: read, create, append.
+ */
+export declare class DocsService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider and optional fetch override
+     */
+    constructor(deps: GoogleApiDeps);
+    /**
+     * `documents.get`, flattened to text.
+     *
+     * @param id - Document id
+     * @returns Title + text
+     */
+    read(id: string): Promise<DocText>;
+    /**
+     * `documents.create` + one `insertText` for the body.
+     *
+     * @param input - Title and optional body
+     * @returns The new document (text as written)
+     * @throws GoogleWorkspaceError(400, validation) without a title
+     */
+    create(input: DocCreateInput): Promise<DocText>;
+    /**
+     * Append text at the end of a document (`documents.get` for the end
+     * index, then `insertText`).
+     *
+     * @param id - Document id
+     * @param text - Text to append (a newline is prepended when the doc is not empty)
+     * @returns The updated document, flattened
+     * @throws GoogleWorkspaceError(400, validation) without text
+     */
+    append(id: string, text: string): Promise<DocText>;
+}
+/**
+ * Browser link for a document.
+ *
+ * @param id - Document id
+ * @returns URL
+ */
+export declare function docLink(id: string): string;
+export {};
+//# sourceMappingURL=docs.service.d.ts.map

package/dist/backend/backend/src/services/google/docs.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/google/docs.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG3E,6BAA6B;AAC7B,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AACD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,CAAC,EAAE,KAAK,CAAC;gBAAE,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC7F,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AACD,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAA;KAAE,CAAC;CAC9C;AAyBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,SAAS,GAAG,MAAM,CAanF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4C;IAEjE;;OAEG;gBACS,IAAI,EAAE,aAAa;IAI/B;;;;;OAKG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAerD;;;;;;;;OAQG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAazD;AAOD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C"}