@distilled.cloud/core 0.0.0 → 0.2.0

package/lib/client.d.ts

@@ -0,0 +1,123 @@
+/**
+ * REST API Client
+ *
+ * Provides the core API.make() factory for building typed Effect-based API operations.
+ * This is the shared client for REST/OpenAPI-style SDKs (PlanetScale, Neon, GCP).
+ *
+ * AWS and Cloudflare have their own more specialized client implementations,
+ * but they share the same OperationMethod pattern.
+ *
+ * @example
+ * ```ts
+ * import { API } from "@distilled.cloud/sdk-core/client";
+ *
+ * const listDatabases = API.make(() => ({
+ *   inputSchema: ListDatabasesInput,
+ *   outputSchema: ListDatabasesOutput,
+ *   errors: [NotFound, Forbidden] as const,
+ * }));
+ *
+ * // Direct call
+ * const result = yield* listDatabases({ organization: "my-org" });
+ *
+ * // Yield first for requirement-free function
+ * const fn = yield* listDatabases;
+ * const result = yield* fn({ organization: "my-org" });
+ * ```
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import type { PaginatedTrait } from "./pagination.ts";
+/**
+ * An operation that can be used in two ways:
+ * 1. Direct call: `yield* operation(input)` - returns Effect with requirements
+ * 2. Yield first: `const fn = yield* operation` - captures services, returns requirement-free function
+ */
+export type OperationMethod<I, A, E, R> = Effect.Effect<(input: I) => Effect.Effect<A, E, never>, never, R> & ((input: I) => Effect.Effect<A, E, R>);
+/**
+ * A paginated operation that additionally has `.pages()` and `.items()` methods.
+ */
+export type PaginatedOperationMethod<I, A, E, R> = OperationMethod<I, A, E, R> & {
+    pages: (input: I) => Stream.Stream<A, E, R>;
+    items: (input: I) => Stream.Stream<unknown, E, R>;
+};
+/**
+ * Configuration for the API client factory.
+ * SDKs provide this to customize how errors are matched and credentials are applied.
+ */
+export interface ClientConfig<Creds> {
+    /** The credentials service tag */
+    credentials: {
+        new (): Creds;
+    };
+    /** Get the base URL from credentials */
+    getBaseUrl: (creds: Creds) => string;
+    /** Get authorization header(s) from credentials */
+    getAuthHeaders: (creds: Creds) => Record<string, string>;
+    /** Match an error response body to a typed error.
+     *  Should return Effect.fail(error) for known errors,
+     *  or Effect.fail(fallbackError) for unknown errors.
+     *  The optional `errors` parameter provides per-operation typed error classes.
+     */
+    matchError: (status: number, body: unknown, errors?: readonly ApiErrorClass[]) => Effect.Effect<never, unknown>;
+    /** Parse error class for schema decode failures */
+    ParseError: new (props: {
+        body: unknown;
+        cause: unknown;
+    }) => unknown;
+    /**
+     * Optional transform applied to the response body before schema decoding.
+     * For example, Cloudflare wraps responses in `{ result: <data>, ... }`.
+     */
+    transformResponse?: (body: unknown) => unknown;
+}
+/**
+ * Base API error type - any error class with at least a _tag and message.
+ * Uses `new (...args: any[])` to accommodate error classes with extra fields (e.g. `code`).
+ */
+export type ApiErrorClass = {
+    new (...args: any[]): {
+        readonly _tag: string;
+        readonly message: string;
+    };
+};
+/**
+ * Operation configuration with optional operation-specific errors.
+ * Supports both `inputSchema`/`outputSchema` and `input`/`output` aliases.
+ */
+export interface OperationConfig<I extends Schema.Top, O extends Schema.Top, E extends readonly ApiErrorClass[] = readonly ApiErrorClass[]> {
+    inputSchema?: I;
+    outputSchema?: O;
+    /** Alias for inputSchema (used by Cloudflare/GCP generators) */
+    input?: I;
+    /** Alias for outputSchema (used by Cloudflare/GCP generators) */
+    output?: O;
+    errors?: E;
+}
+/**
+ * Paginated operation configuration.
+ */
+export interface PaginatedOperationConfig<I extends Schema.Top, O extends Schema.Top, E extends readonly ApiErrorClass[] = readonly ApiErrorClass[]> extends OperationConfig<I, O, E> {
+    pagination?: PaginatedTrait;
+}
+/**
+ * Creates an API namespace bound to a specific SDK's client configuration.
+ *
+ * @example
+ * ```ts
+ * // In planetscale-sdk/src/client.ts
+ * export const API = makeAPI({
+ *   credentials: Credentials,
+ *   getBaseUrl: (c) => c.apiBaseUrl,
+ *   getAuthHeaders: (c) => ({ Authorization: c.token }),
+ *   matchError: matchPlanetScaleError,
+ *   ParseError: PlanetScaleParseError,
+ * });
+ * ```
+ */
+export declare const makeAPI: <Creds>(config: ClientConfig<Creds>) => {
+    make: <I extends Schema.Top, O extends Schema.Top, const E extends readonly ApiErrorClass[] = readonly []>(configFn: () => OperationConfig<I, O, E>) => any;
+    makePaginated: <I extends Schema.Top, O extends Schema.Top, const E extends readonly ApiErrorClass[] = readonly []>(configFn: () => PaginatedOperationConfig<I, O, E>, paginateFn?: ((baseFn: (input: any) => Effect.Effect<any, any, any>, input: any, pagination: PaginatedTrait) => Stream.Stream<any, any, any>) | undefined) => any;
+};
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

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

package/lib/client.js

@@ -0,0 +1,268 @@
+/**
+ * REST API Client
+ *
+ * Provides the core API.make() factory for building typed Effect-based API operations.
+ * This is the shared client for REST/OpenAPI-style SDKs (PlanetScale, Neon, GCP).
+ *
+ * AWS and Cloudflare have their own more specialized client implementations,
+ * but they share the same OperationMethod pattern.
+ *
+ * @example
+ * ```ts
+ * import { API } from "@distilled.cloud/sdk-core/client";
+ *
+ * const listDatabases = API.make(() => ({
+ *   inputSchema: ListDatabasesInput,
+ *   outputSchema: ListDatabasesOutput,
+ *   errors: [NotFound, Forbidden] as const,
+ * }));
+ *
+ * // Direct call
+ * const result = yield* listDatabases({ organization: "my-org" });
+ *
+ * // Yield first for requirement-free function
+ * const fn = yield* listDatabases;
+ * const result = yield* fn({ organization: "my-org" });
+ * ```
+ */
+import * as Effect from "effect/Effect";
+import { pipeArguments } from "effect/Pipeable";
+import * as Schema from "effect/Schema";
+import * as AST from "effect/SchemaAST";
+import * as Stream from "effect/Stream";
+import * as HttpBody from "effect/unstable/http/HttpBody";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as HttpClientError from "effect/unstable/http/HttpClientError";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import { SingleShotGen } from "effect/Utils";
+import * as Traits from "./traits.js";
+import { getPath } from "./traits.js";
+// ============================================================================
+// AST Helpers
+// ============================================================================
+/**
+ * Check if a schema AST represents an array type.
+ * Follows encoding chains and Suspend wrappers.
+ */
+function isArrayAST(ast) {
+    if (ast._tag === "Arrays")
+        return true;
+    if (ast._tag === "Suspend")
+        return isArrayAST(ast.thunk());
+    if (ast.encoding && ast.encoding.length > 0)
+        return isArrayAST(ast.encoding[0].to);
+    return false;
+}
+// ============================================================================
+// Multipart FormData Builder
+// ============================================================================
+/**
+ * Check if a value is a File or Blob.
+ */
+function isFileOrBlob(value) {
+    return ((typeof File !== "undefined" && value instanceof File) ||
+        (typeof Blob !== "undefined" && value instanceof Blob));
+}
+/**
+ * Build a FormData from a record of body properties.
+ * Handles files/blobs, arrays of files, objects (as JSON blobs), and primitives.
+ *
+ * This is used for multipart operations (e.g., Cloudflare Workers script uploads)
+ * where the body contains a mix of metadata objects and file uploads.
+ */
+function buildFormData(body) {
+    const formData = new FormData();
+    for (const [key, value] of Object.entries(body)) {
+        if (value === undefined || value === null)
+            continue;
+        if (isFileOrBlob(value)) {
+            // Single file/blob
+            formData.append(key, value, value instanceof File ? value.name : key);
+        }
+        else if (Array.isArray(value) &&
+            value.length > 0 &&
+            isFileOrBlob(value[0])) {
+            // Array of files/blobs — append each individually
+            for (const file of value) {
+                if (isFileOrBlob(file)) {
+                    formData.append(file instanceof File ? file.name : key, file, file instanceof File ? file.name : undefined);
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            // Object → append as JSON blob
+            formData.append(key, new Blob([JSON.stringify(value)], { type: "application/json" }), key);
+        }
+        else {
+            // Primitive → append as string
+            formData.append(key, String(value));
+        }
+    }
+    return formData;
+}
+// ============================================================================
+// API Client Factory
+// ============================================================================
+/**
+ * Creates an API namespace bound to a specific SDK's client configuration.
+ *
+ * @example
+ * ```ts
+ * // In planetscale-sdk/src/client.ts
+ * export const API = makeAPI({
+ *   credentials: Credentials,
+ *   getBaseUrl: (c) => c.apiBaseUrl,
+ *   getAuthHeaders: (c) => ({ Authorization: c.token }),
+ *   matchError: matchPlanetScaleError,
+ *   ParseError: PlanetScaleParseError,
+ * });
+ * ```
+ */
+export const makeAPI = (config) => {
+    return {
+        make: (configFn) => {
+            const opConfig = configFn();
+            // Support both input/output and inputSchema/outputSchema aliases
+            const inputSchema = (opConfig.inputSchema ?? opConfig.input);
+            const outputSchema = (opConfig.outputSchema ?? opConfig.output);
+            // Read HTTP trait from input schema annotations
+            const httpTrait = Traits.getHttpTrait(inputSchema.ast);
+            if (!httpTrait) {
+                throw new Error("Input schema must have Http trait");
+            }
+            const method = httpTrait.method;
+            const fn = (input) => Effect.gen(function* () {
+                const creds = yield* config.credentials;
+                const client = yield* HttpClient.HttpClient;
+                const baseUrl = config.getBaseUrl(creds);
+                const authHeaders = config.getAuthHeaders(creds);
+                // Use schema-aware request builder for proper camelCase → wire_name mapping
+                const parts = Traits.buildRequestParts(inputSchema.ast, httpTrait, input, inputSchema);
+                let request = HttpClientRequest.make(method)(baseUrl + parts.path).pipe(HttpClientRequest.setHeaders(authHeaders), HttpClientRequest.setHeaders(parts.headers), HttpClientRequest.setHeader("Accept", "application/json"));
+                // Set Content-Type based on body type (skip for FormData — browser sets boundary)
+                if (!parts.isMultipart) {
+                    request = HttpClientRequest.setHeader("Content-Type", "application/json")(request);
+                }
+                if (Object.keys(parts.query).length > 0) {
+                    request = HttpClientRequest.setUrlParams(request, parts.query);
+                }
+                if (method !== "GET" && parts.body !== undefined) {
+                    if (parts.isMultipart) {
+                        // Build FormData from body properties for multipart operations
+                        const formData = buildFormData(parts.body);
+                        request = HttpClientRequest.setBody(HttpBody.formData(formData))(request);
+                    }
+                    else {
+                        request = yield* HttpClientRequest.bodyJson(parts.body)(request);
+                    }
+                }
+                else if (method === "GET" && parts.body !== undefined) {
+                    // For GET requests, remaining non-annotated fields go as query params
+                    const extraQuery = {};
+                    for (const [key, value] of Object.entries(parts.body)) {
+                        if (value !== undefined) {
+                            extraQuery[key] = String(value);
+                        }
+                    }
+                    if (Object.keys(extraQuery).length > 0) {
+                        request = HttpClientRequest.setUrlParams(request, extraQuery);
+                    }
+                }
+                const response = yield* client.execute(request).pipe(Effect.scoped);
+                if (response.status >= 400) {
+                    // Try to parse error body as JSON; fall back to text if not JSON
+                    const errorBody = yield* response.json.pipe(Effect.catchIf(() => true, () => response.text.pipe(Effect.map((text) => ({ _nonJsonError: true, body: text })), Effect.catchIf(() => true, () => Effect.succeed({
+                        _nonJsonError: true,
+                        body: `HTTP ${response.status}`,
+                    })))));
+                    return yield* config.matchError(response.status, errorBody, opConfig.errors);
+                }
+                // For void-returning operations (e.g. DELETE 204 No Content)
+                if (AST.isVoid(outputSchema.ast)) {
+                    return undefined;
+                }
+                // For 204 No Content: if schema is not Unknown, return undefined.
+                // If schema IS Unknown, return empty string (so callers get a defined value).
+                if (response.status === 204) {
+                    if (outputSchema.ast._tag === "Unknown") {
+                        return "";
+                    }
+                    return undefined;
+                }
+                // Try to parse response as JSON; fall back to text for non-JSON responses
+                // (e.g., multipart/form-data worker scripts, raw KV values)
+                const rawBody = yield* response.json.pipe(Effect.catchIf(() => true, () => response.text.pipe(Effect.map((text) => text))));
+                let responseBody = config.transformResponse
+                    ? config.transformResponse(rawBody)
+                    : rawBody;
+                // Handle Cloudflare-style paginated responses where result is
+                // { items: [...] } but the schema expects an array
+                if (isArrayAST(outputSchema.ast) &&
+                    !Array.isArray(responseBody) &&
+                    typeof responseBody === "object" &&
+                    responseBody !== null &&
+                    "items" in responseBody &&
+                    Array.isArray(responseBody.items)) {
+                    responseBody = responseBody.items;
+                }
+                return yield* Schema.decodeUnknownEffect(outputSchema)(responseBody).pipe(Effect.catchTag("SchemaError", (cause) => Effect.fail(new config.ParseError({ body: rawBody, cause }))));
+            });
+            const Proto = {
+                [Symbol.iterator]() {
+                    return new SingleShotGen(this);
+                },
+                pipe() {
+                    return pipeArguments(this.asEffect(), arguments);
+                },
+                asEffect() {
+                    return Effect.map(Effect.services(), (sm) => (input) => fn(input).pipe(Effect.provide(sm)));
+                },
+            };
+            return Object.assign(fn, Proto);
+        },
+        makePaginated: (configFn, paginateFn) => {
+            const opConfig = configFn();
+            const pagination = opConfig.pagination;
+            // Create the base operation
+            const baseFn = makeAPI(config).make(() => ({
+                inputSchema: opConfig.inputSchema ?? opConfig.input,
+                outputSchema: opConfig.outputSchema ?? opConfig.output,
+                errors: opConfig.errors,
+            }));
+            // Default pagination: token-based (works for Cloudflare/GCP style)
+            const defaultPaginateFn = (op, input, pag) => {
+                return Stream.unfold({ token: undefined, done: false }, (state) => Effect.gen(function* () {
+                    if (state.done)
+                        return undefined;
+                    const requestPayload = state.token !== undefined
+                        ? { ...input, [pag.inputToken]: state.token }
+                        : input;
+                    const response = yield* op(requestPayload);
+                    const nextToken = getPath(response, pag.outputToken);
+                    return [
+                        response,
+                        {
+                            token: nextToken,
+                            done: nextToken === undefined || nextToken === null,
+                        },
+                    ];
+                }));
+            };
+            const paginate = paginateFn ?? defaultPaginateFn;
+            // Stream all pages
+            const pagesFn = (input) => paginate(baseFn, input, pagination);
+            // Stream individual items
+            const itemsFn = (input) => pagesFn(input).pipe(Stream.flatMap((page) => {
+                if (!pagination.items)
+                    return Stream.make(page);
+                const items = getPath(page, pagination.items);
+                return Stream.fromIterable(items ?? []);
+            }));
+            const result = baseFn;
+            result.pages = pagesFn;
+            result.items = itemsFn;
+            return result;
+        },
+    };
+};
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

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

package/lib/errors.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Common error types shared across SDKs.
+ *
+ * Each SDK defines its own provider-specific errors (e.g., Unauthorized, NotFound)
+ * using the category system. This module provides base error types and utilities
+ * that are used across all SDKs.
+ */
+import * as Schema from "effect/Schema";
+import * as Category from "./category.ts";
+declare const Unauthorized_base: Schema.ErrorClass<Unauthorized, Schema.TaggedStruct<"Unauthorized", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        AuthError: true;
+    };
+});
+/**
+ * Unauthorized - Authentication failure (401).
+ */
+export declare class Unauthorized extends Unauthorized_base {
+}
+declare const Forbidden_base: Schema.ErrorClass<Forbidden, Schema.TaggedStruct<"Forbidden", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        AuthError: true;
+    };
+});
+/**
+ * Forbidden - Access denied (403).
+ */
+export declare class Forbidden extends Forbidden_base {
+}
+declare const NotFound_base: Schema.ErrorClass<NotFound, Schema.TaggedStruct<"NotFound", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        NotFoundError: true;
+    };
+});
+/**
+ * NotFound - Resource not found (404).
+ */
+export declare class NotFound extends NotFound_base {
+}
+declare const BadRequest_base: Schema.ErrorClass<BadRequest, Schema.TaggedStruct<"BadRequest", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        BadRequestError: true;
+    };
+});
+/**
+ * BadRequest - Invalid request (400).
+ */
+export declare class BadRequest extends BadRequest_base {
+}
+declare const Conflict_base: Schema.ErrorClass<Conflict, Schema.TaggedStruct<"Conflict", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ConflictError: true;
+    };
+});
+/**
+ * Conflict - Resource conflict (409).
+ */
+export declare class Conflict extends Conflict_base {
+}
+declare const UnprocessableEntity_base: Schema.ErrorClass<UnprocessableEntity, Schema.TaggedStruct<"UnprocessableEntity", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        BadRequestError: true;
+    };
+});
+/**
+ * UnprocessableEntity - Validation error (422).
+ */
+export declare class UnprocessableEntity extends UnprocessableEntity_base {
+}
+declare const TooManyRequests_base: Schema.ErrorClass<TooManyRequests, Schema.TaggedStruct<"TooManyRequests", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ThrottlingError: true;
+    };
+}) & (new (...args: any[]) => {
+    "@distilled.cloud/error/retryable": Category.RetryableInfo;
+});
+/**
+ * TooManyRequests - Rate limited (429).
+ */
+export declare class TooManyRequests extends TooManyRequests_base {
+}
+declare const Locked_base: Schema.ErrorClass<Locked, Schema.TaggedStruct<"Locked", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        LockedError: true;
+    };
+}) & (new (...args: any[]) => {
+    "@distilled.cloud/error/retryable": Category.RetryableInfo;
+});
+/**
+ * Locked - Resource locked (423).
+ */
+export declare class Locked extends Locked_base {
+}
+declare const InternalServerError_base: Schema.ErrorClass<InternalServerError, Schema.TaggedStruct<"InternalServerError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ServerError: true;
+    };
+}) & (new (...args: any[]) => {
+    "@distilled.cloud/error/retryable": Category.RetryableInfo;
+});
+/**
+ * InternalServerError - Server error (500).
+ */
+export declare class InternalServerError extends InternalServerError_base {
+}
+declare const ServiceUnavailable_base: Schema.ErrorClass<ServiceUnavailable, Schema.TaggedStruct<"ServiceUnavailable", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ServerError: true;
+    };
+}) & (new (...args: any[]) => {
+    "@distilled.cloud/error/retryable": Category.RetryableInfo;
+});
+/**
+ * ServiceUnavailable - Service unavailable (503).
+ */
+export declare class ServiceUnavailable extends ServiceUnavailable_base {
+}
+declare const ConfigError_base: Schema.ErrorClass<ConfigError, Schema.TaggedStruct<"ConfigError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ConfigurationError: true;
+    };
+});
+/**
+ * Configuration error - missing or invalid configuration.
+ */
+export declare class ConfigError extends ConfigError_base {
+}
+/**
+ * Mapping from HTTP status codes to common error classes.
+ */
+export declare const HTTP_STATUS_MAP: {
+    readonly 400: typeof BadRequest;
+    readonly 401: typeof Unauthorized;
+    readonly 403: typeof Forbidden;
+    readonly 404: typeof NotFound;
+    readonly 409: typeof Conflict;
+    readonly 422: typeof UnprocessableEntity;
+    readonly 423: typeof Locked;
+    readonly 429: typeof TooManyRequests;
+    readonly 500: typeof InternalServerError;
+    readonly 503: typeof ServiceUnavailable;
+};
+/**
+ * HTTP status codes that are considered "default" errors (always present).
+ * These are excluded from per-operation error types since they're handled globally.
+ */
+export declare const DEFAULT_ERROR_STATUSES: Set<number>;
+/**
+ * All common API error classes.
+ */
+export declare const API_ERRORS: readonly [typeof Unauthorized, typeof Forbidden, typeof NotFound, typeof BadRequest, typeof Conflict, typeof UnprocessableEntity, typeof TooManyRequests, typeof Locked, typeof InternalServerError, typeof ServiceUnavailable];
+/**
+ * Default errors that apply to ALL operations.
+ * These are infrastructure-level errors that can occur regardless of the operation.
+ */
+export declare const DEFAULT_ERRORS: readonly [typeof Unauthorized, typeof TooManyRequests, typeof InternalServerError, typeof ServiceUnavailable];
+export type DefaultErrors = InstanceType<(typeof DEFAULT_ERRORS)[number]>;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;;;;;;;;AAM1C;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAGJ;CAAG;;;;;;;;AAEjC;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAGD;CAAG;;;;;;;;AAEjC;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAEK;CAAG;;;;;;;;AAEtC;;GAEG;AACH,qBAAa,UAAW,SAAQ,eAGI;CAAG;;;;;;;;AAEvC;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAEK;CAAG;;;;;;;;AAEtC;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,wBAGL;CAAG;;;;;;;;;;AAEvC;;GAEG;AACH,qBAAa,eAAgB,SAAQ,oBAMpC;CAAG;;;;;;;;;;AAEJ;;GAEG;AACH,qBAAa,MAAO,SAAQ,WAE+B;CAAG;;;;;;;;;;AAE9D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,wBAGiB;CAAG;;;;;;;;;;AAE7D;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,uBAGkB;CAAG;;;;;;;;AAE7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,gBAGM;CAAG;AAM1C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;CAWlB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAAgC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,UAAU,iOAWb,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc,+GAKjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC"}