@37signals/fizzy 0.1.0

package/dist/client.js

@@ -0,0 +1,505 @@
+/**
+ * Fizzy TypeScript SDK Client
+ *
+ * Creates a type-safe client for the Fizzy API using openapi-fetch.
+ * Includes middleware for authentication, retry with exponential backoff,
+ * ETag-based caching, and account scoping via forAccount().
+ */
+import createClient from "openapi-fetch";
+import { createRequire } from "node:module";
+import { PATH_TO_OPERATION } from "./generated/path-mapping.js";
+import { FizzyError } from "./errors.js";
+import { isLocalhost } from "./security.js";
+import { parseNextLink, resolveURL, isSameOrigin } from "./pagination-utils.js";
+import { bearerAuth } from "./auth-strategy.js";
+import { ETagCache } from "./cache/etag-cache.js";
+import { BoardsService } from "./generated/services/boards.js";
+import { CardsService } from "./generated/services/cards.js";
+import { ColumnsService } from "./generated/services/columns.js";
+import { CommentsService } from "./generated/services/comments.js";
+import { DevicesService } from "./generated/services/devices.js";
+import { IdentityService } from "./generated/services/identity.js";
+import { NotificationsService } from "./generated/services/notifications.js";
+import { PinsService } from "./generated/services/pins.js";
+import { ReactionsService } from "./generated/services/reactions.js";
+import { SessionsService } from "./generated/services/sessions.js";
+import { StepsService } from "./generated/services/steps.js";
+import { TagsService } from "./generated/services/tags.js";
+import { UploadsService } from "./generated/services/uploads.js";
+import { UsersService } from "./generated/services/users.js";
+import { WebhooksService } from "./generated/services/webhooks.js";
+import { MiscellaneousService } from "./generated/services/miscellaneous.js";
+const require = createRequire(import.meta.url);
+const metadata = require("./generated/metadata.json");
+export const VERSION = "0.1.0";
+export const API_VERSION = "2026-03-01";
+const DEFAULT_BASE_URL = "https://fizzy.do";
+const DEFAULT_USER_AGENT = `fizzy-sdk-ts/${VERSION} (api:${API_VERSION})`;
+/**
+ * Creates a type-safe Fizzy API client with built-in middleware for:
+ * - Authentication (Bearer token or Cookie session)
+ * - Retry with exponential backoff (respects Retry-After header)
+ * - ETag-based HTTP caching
+ *
+ * @example
+ * ```ts
+ * import { createFizzyClient } from "@37signals/fizzy";
+ *
+ * const client = createFizzyClient({
+ *   accessToken: process.env.FIZZY_TOKEN!,
+ * });
+ *
+ * const { data, error } = await client.GET("/boards.json");
+ * ```
+ */
+export function createFizzyClient(options) {
+    const { accountId, accessToken, auth, baseUrl: baseUrlOption, userAgent = DEFAULT_USER_AGENT, enableCache = false, enableRetry = true, requestTimeoutMs = 30000, hooks, } = options;
+    // Resolve base URL: if accountId provided, scope to that account
+    const baseUrl = baseUrlOption ??
+        (accountId ? `${DEFAULT_BASE_URL}/${accountId}` : DEFAULT_BASE_URL);
+    // Validate auth options: exactly one of auth or accessToken must be provided
+    if (auth && accessToken) {
+        throw new FizzyError("usage", "Provide either 'auth' or 'accessToken', not both");
+    }
+    if (!auth && !accessToken) {
+        throw new FizzyError("usage", "Either 'auth' or 'accessToken' is required");
+    }
+    const authStrategy = auth ?? bearerAuth(accessToken);
+    // Validate HTTPS (skip for localhost)
+    if (baseUrl) {
+        try {
+            const parsed = new URL(baseUrl);
+            if (parsed.protocol !== "https:" && !isLocalhost(parsed.hostname)) {
+                throw new FizzyError("usage", `Base URL must use HTTPS: ${baseUrl}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof FizzyError)
+                throw err;
+            throw new FizzyError("usage", `Invalid base URL: ${baseUrl}`);
+        }
+    }
+    const client = createClient({ baseUrl });
+    // Apply middleware in order: auth first, then hooks, then cache, then retry
+    client.use(createAuthMiddleware(authStrategy, userAgent, requestTimeoutMs));
+    if (hooks) {
+        client.use(createHooksMiddleware(hooks));
+    }
+    const etagCache = enableCache ? new ETagCache() : undefined;
+    if (etagCache) {
+        client.use(createCacheMiddleware(etagCache));
+    }
+    if (enableRetry) {
+        client.use(createRetryMiddleware(hooks, authStrategy));
+    }
+    const enhancedClient = client;
+    Object.defineProperty(enhancedClient, "raw", {
+        value: client,
+        writable: false,
+        enumerable: false,
+    });
+    Object.defineProperty(enhancedClient, "hooks", {
+        value: hooks,
+        writable: false,
+        enumerable: false,
+    });
+    // forAccount: creates a new client scoped to a different account
+    Object.defineProperty(enhancedClient, "forAccount", {
+        value: (newAccountId) => {
+            return createFizzyClient({
+                ...options,
+                accountId: newAccountId,
+                baseUrl: `${DEFAULT_BASE_URL}/${newAccountId}`,
+            });
+        },
+        writable: false,
+        enumerable: false,
+    });
+    // Authenticated fetchPage closure for pagination
+    const fetchPage = async (url) => {
+        const headers = new Headers({
+            "User-Agent": userAgent,
+            Accept: "application/json",
+        });
+        await authStrategy.authenticate(headers);
+        return fetch(url, { headers });
+    };
+    // Lazy-initialized service cache
+    const serviceCache = {};
+    const defineService = (name, factory) => {
+        Object.defineProperty(enhancedClient, name, {
+            get() {
+                return (serviceCache[name] ??= factory());
+            },
+            enumerable: true,
+            configurable: false,
+        });
+    };
+    // Expose fetchPage and hooks for service internals
+    enhancedClient.__fetchPage = fetchPage;
+    enhancedClient.__hooks = hooks;
+    // Register all generated services as lazy accessors
+    registerServices(defineService, enhancedClient, fetchPage, hooks);
+    return enhancedClient;
+}
+// =============================================================================
+// Auth Middleware
+// =============================================================================
+function createAuthMiddleware(authStrategy, userAgent, requestTimeoutMs) {
+    return {
+        async onRequest({ request }) {
+            await authStrategy.authenticate(request.headers);
+            request.headers.set("User-Agent", userAgent);
+            if (!request.headers.has("Content-Type")) {
+                request.headers.set("Content-Type", "application/json");
+            }
+            request.headers.set("Accept", "application/json");
+            const controller = new AbortController();
+            setTimeout(() => controller.abort(), requestTimeoutMs);
+            if (request.signal) {
+                request.signal.addEventListener("abort", () => controller.abort(), {
+                    once: true,
+                });
+            }
+            return new Request(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: request.body,
+                signal: controller.signal,
+                duplex: request.body ? "half" : undefined,
+            });
+        },
+    };
+}
+let requestIdCounter = 0;
+function createHooksMiddleware(hooks) {
+    const timings = new Map();
+    return {
+        async onRequest({ request }) {
+            const requestId = `${++requestIdCounter}`;
+            request.headers.set("X-SDK-Request-Id", requestId);
+            const attemptHeader = request.headers.get("X-Retry-Attempt");
+            const attempt = attemptHeader ? parseInt(attemptHeader, 10) + 1 : 1;
+            timings.set(requestId, { startTime: performance.now(), attempt });
+            const info = {
+                method: request.method,
+                url: request.url,
+                attempt,
+            };
+            try {
+                hooks.onRequestStart?.(info);
+            }
+            catch { /* hooks must not interrupt */ }
+            return request;
+        },
+        async onResponse({ request, response }) {
+            const requestId = request.headers.get("X-SDK-Request-Id") ?? "";
+            const timing = timings.get(requestId);
+            const durationMs = timing ? Math.round(performance.now() - timing.startTime) : 0;
+            const attempt = timing?.attempt ?? 1;
+            timings.delete(requestId);
+            const info = {
+                method: request.method,
+                url: request.url,
+                attempt,
+            };
+            const fromCacheHeader = response.headers.get("X-From-Cache");
+            const fromCache = fromCacheHeader === "1" || response.status === 304;
+            const result = {
+                statusCode: response.status,
+                durationMs,
+                fromCache,
+            };
+            try {
+                hooks.onRequestEnd?.(info, result);
+            }
+            catch { /* hooks must not interrupt */ }
+            return response;
+        },
+    };
+}
+// =============================================================================
+// Cache Middleware (ETag-based)
+// =============================================================================
+function createCacheMiddleware(cache) {
+    const cacheKeyStore = new WeakMap();
+    return {
+        async onRequest({ request }) {
+            if (request.method !== "GET")
+                return request;
+            const cacheKey = await cache.getCacheKey(request.url, request.headers.get("Authorization") ?? request.headers.get("Cookie"));
+            const etag = cache.getETag(cacheKey);
+            if (etag) {
+                request.headers.set("If-None-Match", etag);
+            }
+            cacheKeyStore.set(request, cacheKey);
+            return request;
+        },
+        async onResponse({ request, response }) {
+            if (request.method !== "GET")
+                return response;
+            const cacheKey = cacheKeyStore.get(request) ??
+                await cache.getCacheKey(request.url, request.headers.get("Authorization") ?? request.headers.get("Cookie"));
+            if (response.status === 304) {
+                const body = cache.getBody(cacheKey);
+                if (body) {
+                    const headers = new Headers(response.headers);
+                    headers.set("X-From-Cache", "1");
+                    return new Response(body, { status: 200, headers });
+                }
+            }
+            if (response.ok) {
+                const etag = response.headers.get("ETag");
+                if (etag) {
+                    const body = await response.clone().text();
+                    cache.set(cacheKey, etag, body);
+                }
+            }
+            return response;
+        },
+    };
+}
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    baseDelayMs: 1000,
+    backoff: "exponential",
+    retryOn: [429, 503],
+};
+const MAX_JITTER_MS = 100;
+/**
+ * Normalizes a URL path by replacing numeric IDs with placeholder tokens.
+ * For example: /boards/456/cards/789 -> /boards/{boardId}/cards/{cardNumber}
+ */
+export function normalizeUrlPath(url) {
+    const urlObj = new URL(url);
+    let path = urlObj.pathname;
+    const hasJsonSuffix = path.endsWith(".json");
+    if (hasJsonSuffix) {
+        path = path.slice(0, -5);
+    }
+    const segments = path.split("/").filter(Boolean);
+    const idMapping = {
+        boards: "{boardId}",
+        columns: "{columnId}",
+        cards: "{cardNumber}",
+        comments: "{commentId}",
+        steps: "{stepId}",
+        reactions: "{reactionId}",
+        notifications: "{notificationId}",
+        tags: "{tagId}",
+        users: "{userId}",
+        pins: "{pinId}",
+        webhooks: "{webhookId}",
+        sessions: "{sessionId}",
+        devices: "{deviceId}",
+    };
+    const normalized = [];
+    let prevSegment = null;
+    let isFirstSegment = true;
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i];
+        if (/^\d+$/.test(segment)) {
+            if (isFirstSegment) {
+                normalized.push("{accountId}");
+            }
+            else {
+                const placeholder = prevSegment ? idMapping[prevSegment] : undefined;
+                normalized.push(placeholder ?? "{id}");
+            }
+        }
+        else {
+            normalized.push(segment);
+        }
+        prevSegment = segment;
+        isFirstSegment = false;
+    }
+    let normalizedPath = "/" + normalized.join("/");
+    if (hasJsonSuffix) {
+        normalizedPath += ".json";
+    }
+    return normalizedPath;
+}
+function getRetryConfigForRequest(method, url) {
+    const normalizedPath = normalizeUrlPath(url);
+    const key = `${method.toUpperCase()}:${normalizedPath}`;
+    const operationName = PATH_TO_OPERATION[key];
+    if (operationName) {
+        const opMeta = metadata.operations[operationName];
+        if (opMeta?.retry) {
+            return { ...DEFAULT_RETRY_CONFIG, ...opMeta.retry };
+        }
+    }
+    return DEFAULT_RETRY_CONFIG;
+}
+function createRetryMiddleware(hooks, authStrategy) {
+    const bodyCache = new Map();
+    return {
+        async onRequest({ request }) {
+            const method = request.method.toUpperCase();
+            if (method === "POST" || method === "PUT" || method === "PATCH") {
+                const requestId = `${method}:${request.url}:${Date.now()}`;
+                request.headers.set("X-Request-Id", requestId);
+                if (request.body) {
+                    const cloned = request.clone();
+                    bodyCache.set(requestId, await cloned.arrayBuffer());
+                }
+                else {
+                    bodyCache.set(requestId, null);
+                }
+            }
+            return request;
+        },
+        async onResponse({ request, response }) {
+            const retryConfig = getRetryConfigForRequest(request.method, request.url);
+            const requestId = request.headers.get("X-Request-Id");
+            const cleanupBody = () => { if (requestId)
+                bodyCache.delete(requestId); };
+            let currentResponse = response;
+            let attempt = parseInt(request.headers.get("X-Retry-Attempt") || "0", 10);
+            if (Number.isNaN(attempt))
+                attempt = 0;
+            try {
+                while (retryConfig.retryOn.includes(currentResponse.status) &&
+                    attempt < retryConfig.maxAttempts - 1) {
+                    // Calculate delay (Retry-After for 429, backoff otherwise)
+                    let delay;
+                    if (currentResponse.status === 429) {
+                        const ra = currentResponse.headers.get("Retry-After");
+                        const sec = ra ? parseInt(ra, 10) : NaN;
+                        delay = isNaN(sec) ? calculateBackoffDelay(retryConfig, attempt) : sec * 1000;
+                    }
+                    else {
+                        delay = calculateBackoffDelay(retryConfig, attempt);
+                    }
+                    // Fire hook
+                    if (hooks?.onRetry) {
+                        const info = {
+                            method: request.method,
+                            url: request.url,
+                            attempt: attempt + 1,
+                        };
+                        try {
+                            hooks.onRetry(info, attempt + 1, new Error(`HTTP ${currentResponse.status}: ${currentResponse.statusText || "Request failed"}`), delay);
+                        }
+                        catch { /* hooks must not interrupt */ }
+                    }
+                    await sleep(delay);
+                    attempt++;
+                    // Build retry request
+                    let body = null;
+                    if (requestId && bodyCache.has(requestId)) {
+                        body = bodyCache.get(requestId) ?? null;
+                    }
+                    const retryHeaders = new Headers(request.headers);
+                    retryHeaders.set("X-Retry-Attempt", String(attempt));
+                    if (authStrategy) {
+                        await authStrategy.authenticate(retryHeaders);
+                    }
+                    currentResponse = await fetch(new Request(request.url, {
+                        method: request.method,
+                        headers: retryHeaders,
+                        body,
+                        signal: request.signal,
+                    }));
+                }
+                return currentResponse;
+            }
+            finally {
+                cleanupBody();
+            }
+        },
+    };
+}
+function calculateBackoffDelay(config, attempt) {
+    const base = config.baseDelayMs;
+    let delay;
+    switch (config.backoff) {
+        case "exponential":
+            delay = base * Math.pow(2, attempt);
+            break;
+        case "linear":
+            delay = base * (attempt + 1);
+            break;
+        case "constant":
+        default:
+            delay = base;
+    }
+    const jitter = Math.random() * MAX_JITTER_MS;
+    return delay + jitter;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// =============================================================================
+// Pagination Helpers
+// =============================================================================
+/**
+ * Fetches all pages of a paginated resource using Link header pagination.
+ */
+export async function fetchAllPages(initialResponse, parse, authHeader) {
+    const results = [];
+    let response = initialResponse;
+    while (true) {
+        const items = await parse(response.clone());
+        results.push(...items);
+        const rawNextUrl = parseNextLink(response.headers.get("Link"));
+        if (!rawNextUrl)
+            break;
+        const nextUrl = resolveURL(response.url, rawNextUrl);
+        if (!isSameOrigin(nextUrl, initialResponse.url)) {
+            throw new Error(`Pagination Link header points to different origin: ${nextUrl}`);
+        }
+        const headers = { Accept: "application/json" };
+        if (authHeader) {
+            headers["Authorization"] = authHeader;
+        }
+        response = await fetch(nextUrl, { headers });
+    }
+    return results;
+}
+/**
+ * Async generator that yields pages of results one at a time.
+ */
+export async function* paginateAll(initialResponse, parse, authHeader) {
+    let response = initialResponse;
+    while (true) {
+        const items = await parse(response.clone());
+        yield items;
+        const rawNextUrl = parseNextLink(response.headers.get("Link"));
+        if (!rawNextUrl)
+            break;
+        const nextUrl = resolveURL(response.url, rawNextUrl);
+        if (!isSameOrigin(nextUrl, initialResponse.url)) {
+            throw new Error(`Pagination Link header points to different origin: ${nextUrl}`);
+        }
+        const headers = { Accept: "application/json" };
+        if (authHeader) {
+            headers["Authorization"] = authHeader;
+        }
+        response = await fetch(nextUrl, { headers });
+    }
+}
+// Re-export pagination utilities
+export { parseNextLink, resolveURL, isSameOrigin };
+// =============================================================================
+// Service Registration
+// =============================================================================
+function registerServices(defineService, client, fetchPage, hooks) {
+    defineService("boards", () => new BoardsService(client, hooks, fetchPage));
+    defineService("cards", () => new CardsService(client, hooks, fetchPage));
+    defineService("columns", () => new ColumnsService(client, hooks, fetchPage));
+    defineService("comments", () => new CommentsService(client, hooks, fetchPage));
+    defineService("devices", () => new DevicesService(client, hooks, fetchPage));
+    defineService("identity", () => new IdentityService(client, hooks, fetchPage));
+    defineService("notifications", () => new NotificationsService(client, hooks, fetchPage));
+    defineService("pins", () => new PinsService(client, hooks, fetchPage));
+    defineService("reactions", () => new ReactionsService(client, hooks, fetchPage));
+    defineService("sessions", () => new SessionsService(client, hooks, fetchPage));
+    defineService("steps", () => new StepsService(client, hooks, fetchPage));
+    defineService("tags", () => new TagsService(client, hooks, fetchPage));
+    defineService("uploads", () => new UploadsService(client, hooks, fetchPage));
+    defineService("users", () => new UsersService(client, hooks, fetchPage));
+    defineService("webhooks", () => new WebhooksService(client, hooks, fetchPage));
+    defineService("miscellaneous", () => new MiscellaneousService(client, hooks, fetchPage));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Structured error types for the Fizzy SDK.
+ *
+ * Provides typed errors with error codes, hints, and exit codes
+ * for CLI-friendly error handling.
+ */
+/**
+ * Error codes for categorizing Fizzy API errors.
+ */
+export type ErrorCode = "auth_required" | "forbidden" | "not_found" | "rate_limit" | "validation" | "ambiguous" | "network" | "api_error" | "usage";
+/**
+ * Options for creating a FizzyError.
+ */
+export interface FizzyErrorOptions {
+    /** User-friendly hint for resolving the error */
+    hint?: string;
+    /** HTTP status code that caused the error */
+    httpStatus?: number;
+    /** Whether the operation can be retried */
+    retryable?: boolean;
+    /** Original error that caused this error */
+    cause?: Error;
+    /** Number of seconds to wait before retrying (for rate limits) */
+    retryAfter?: number;
+    /** Request ID from the server for debugging */
+    requestId?: string;
+}
+/**
+ * Structured error class for Fizzy API errors.
+ */
+export declare class FizzyError extends Error {
+    readonly code: ErrorCode;
+    readonly hint?: string;
+    readonly httpStatus?: number;
+    readonly retryable: boolean;
+    readonly retryAfter?: number;
+    readonly requestId?: string;
+    readonly cause?: Error;
+    constructor(code: ErrorCode, message: string, options?: FizzyErrorOptions);
+    get exitCode(): number;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Factory functions for creating common error types.
+ */
+export declare const Errors: {
+    auth: (hint?: string, cause?: Error) => FizzyError;
+    forbidden: (hint?: string, cause?: Error) => FizzyError;
+    notFound: (resource: string, id?: number | string) => FizzyError;
+    rateLimit: (retryAfter?: number, cause?: Error) => FizzyError;
+    validation: (message: string, hint?: string) => FizzyError;
+    ambiguous: (resource: string, matches: string[]) => FizzyError;
+    network: (message: string, cause?: Error) => FizzyError;
+    apiError: (message: string, httpStatus?: number, options?: Pick<FizzyErrorOptions, "hint" | "retryable" | "requestId" | "cause">) => FizzyError;
+};
+/**
+ * Creates a FizzyError from an HTTP response.
+ */
+export declare function errorFromResponse(response: Response, requestId?: string): Promise<FizzyError>;
+/**
+ * Type guard to check if an error is a FizzyError.
+ */
+export declare function isFizzyError(error: unknown): error is FizzyError;
+/**
+ * Type guard to check if an error is a specific type of FizzyError.
+ */
+export declare function isErrorCode(error: unknown, code: ErrorCode): error is FizzyError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,WAAW,GACX,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,SAAS,GACT,WAAW,GACX,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAiB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEnB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAmBzE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYlC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;kBACH,MAAM,UAAU,KAAK,KAAG,UAAU;uBAO7B,MAAM,UAAU,KAAK,KAAG,UAAU;yBAOhC,MAAM,OAAO,MAAM,GAAG,MAAM,KAAG,UAAU;6BAOrC,MAAM,UAAU,KAAK,KAAG,UAAU;0BASrC,MAAM,SAAS,MAAM,KAAG,UAAU;0BAMlC,MAAM,WAAW,MAAM,EAAE,KAAG,UAAU;uBAOzC,MAAM,UAAU,KAAK,KAAG,UAAU;wBAQ1C,MAAM,eACF,MAAM,YACT,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,KAC9E,UAAU;CAKd,CAAC;AAEF;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAiDrB;AAqBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,IAAI,UAAU,CAEhF"}