@databricks/sdk-core 0.34.0 → 0.35.0

package/dist/apierror/apierror.d.ts

@@ -1,54 +1,57 @@
-import { Code } from './codes';
-import type { ErrorDetails } from './details';
+import { Code } from "./codes/codes.js";
+import { ErrorDetails } from "./details.js";
+
+//#region src/apierror/apierror.d.ts
 interface ApiErrorOptions {
-    code: Code;
-    message: string;
-    details: ErrorDetails;
-    httpStatusCode?: number | undefined;
-    httpHeader?: Headers | undefined;
-    httpBody?: Uint8Array | undefined;
-    cause?: unknown;
+  code: Code;
+  message: string;
+  details: ErrorDetails;
+  httpStatusCode?: number | undefined;
+  httpHeader?: Headers | undefined;
+  httpBody?: Uint8Array | undefined;
+  cause?: unknown;
 }
 /** ApiError is a transport-agnostic error representing a Databricks API error. */
-export declare class ApiError extends Error {
-    /**
-     * The error code of the error.
-     */
-    readonly code: Code;
-    /**
-     * The structured error details of the error. This is left empty if the
-     * error response is not a standard Databricks API error.
-     */
-    readonly details: ErrorDetails;
-    private readonly httpErr?;
-    /**
-     * Do not use this constructor directly. Use {@link ApiError.fromHttpError}
-     * instead. This constructor is only meant for internal and testing use.
-     * TODO: Make this constructor private.
-     *
-     * @private
-     */
-    constructor(options: ApiErrorOptions);
-    /**
-     * Returns the ApiError's HTTP status code. If the ApiError is not an HTTP
-     * error, returns -1.
-     */
-    get httpStatusCode(): number;
-    /**
-     * Returns the ApiError's HTTP headers. If the ApiError is not an HTTP
-     * error, returns undefined.
-     */
-    get httpHeader(): Headers | undefined;
-    /**
-     * Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,
-     * returns undefined.
-     */
-    get httpBody(): Uint8Array | undefined;
-    /**
-     * Parses an HTTP error response into an ApiError. Returns undefined if the
-     * status code is 2xx.
-     */
-    static fromHttpError(statusCode: number, header: Headers | undefined, body: Uint8Array | undefined): ApiError | undefined;
+declare class ApiError extends Error {
+  /**
+   * The error code of the error.
+   */
+  readonly code: Code;
+  /**
+   * The structured error details of the error. This is left empty if the
+   * error response is not a standard Databricks API error.
+   */
+  readonly details: ErrorDetails;
+  private readonly httpErr?;
+  /**
+   * Do not use this constructor directly. Use {@link ApiError.fromHttpError}
+   * instead. This constructor is only meant for internal and testing use.
+   * TODO: Make this constructor private.
+   *
+   * @private
+   */
+  constructor(options: ApiErrorOptions);
+  /**
+   * Returns the ApiError's HTTP status code. If the ApiError is not an HTTP
+   * error, returns -1.
+   */
+  get httpStatusCode(): number;
+  /**
+   * Returns the ApiError's HTTP headers. If the ApiError is not an HTTP
+   * error, returns undefined.
+   */
+  get httpHeader(): Headers | undefined;
+  /**
+   * Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,
+   * returns undefined.
+   */
+  get httpBody(): Uint8Array | undefined;
+  /**
+   * Parses an HTTP error response into an ApiError. Returns undefined if the
+   * status code is 2xx.
+   */
+  static fromHttpError(statusCode: number, header: Headers | undefined, body: Uint8Array | undefined): ApiError | undefined;
 }
-export {};
+//#endregion
+export { ApiError };
 //# sourceMappingURL=apierror.d.ts.map

package/dist/apierror/apierror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apierror.d.ts","sourceRoot":"","sources":["../../src/apierror/apierror.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,IAAI,EAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AA8B5C,UAAU,eAAe;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,qBAAa,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAG/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAIvB;IAEF;;;;;;OAMG;gBACS,OAAO,EAAE,eAAe;IAcpC;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,CAK3B;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,OAAO,GAAG,SAAS,CAKpC;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,UAAU,GAAG,SAAS,CAKrC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,IAAI,EAAE,UAAU,GAAG,SAAS,GAC3B,QAAQ,GAAG,SAAS;CAqFxB"}
+{"version":3,"file":"apierror.d.ts","names":[],"sources":["../../src/apierror/apierror.ts"],"mappings":";;;;UAiCU,eAAA;EACR,IAAA,EAAM,IAAA;EACN,OAAA;EACA,OAAA,EAAS,YAAA;EACT,cAAA;EACA,UAAA,GAAa,OAAA;EACb,QAAA,GAAW,UAAA;EACX,KAAA;AAAA;;cAIW,QAAA,SAAiB,KAAA;EAV5B;;;EAAA,SAcS,IAAA,EAAM,IAAA;EAZN;;;;EAAA,SAkBA,OAAA,EAAS,YAAA;EAAA,iBAGD,OAAA;EAjBjB;;;AAIF;;;;cA0Bc,OAAA,EAAS,eAAA;EAAA;;;;EAAA,IAkBjB,cAAA,CAAA;EAqCD;;;;EAAA,IA1BC,UAAA,CAAA,GAAc,OAAA;EAnDT;;;;EAAA,IA8DL,QAAA,CAAA,GAAY,UAAA;;;;;SAWT,aAAA,CACL,UAAA,UACA,MAAA,EAAQ,OAAA,cACR,IAAA,EAAM,UAAA,eACL,QAAA;AAAA"}

package/dist/apierror/apierror.js

@@ -1,176 +1,128 @@
-import { z } from 'zod';
-import { Code } from './codes';
-import { parseErrorDetails } from './details';
-// Reusable schema fragment for nullish string fields.
-const nullishString = z
-    .string()
-    .nullish()
-    .transform(v => v ?? '');
-// Zod schema for parsing the JSON error response body. The schema is lenient
-// to handle the various Databricks API error formats (standard, legacy, SCIM).
+import { Code } from "./codes/codes.js";
+import { parseErrorDetails } from "./details.js";
+import { z } from "zod";
+
+//#region src/apierror/apierror.ts
+const nullishString = z.string().nullish().transform((v) => v ?? "");
 const errorResponseSchema = z.object({
-    message: nullishString,
-    details: z
-        .array(z.unknown())
-        .nullish()
-        .transform(v => v ?? []),
-    // Some Databricks APIs incorrectly return the HTTP status code as an
-    // integer rather than the actual error code as a string.
-    error_code: z.unknown().optional(),
-    // Legacy Databricks APIs (e.g. version 1.2 and earlier) used "error"
-    // instead of "message".
-    error: nullishString,
-    // SCIM error fields (RFC7644 section 3.7.3).
-    // The "status" field is intentionally omitted; it duplicates HTTP status.
-    detail: nullishString,
-    scimType: nullishString,
+	message: nullishString,
+	details: z.array(z.unknown()).nullish().transform((v) => v ?? []),
+	error_code: z.unknown().optional(),
+	error: nullishString,
+	detail: nullishString,
+	scimType: nullishString
 });
 /** ApiError is a transport-agnostic error representing a Databricks API error. */
-export class ApiError extends Error {
-    /**
-     * The error code of the error.
-     */
-    code;
-    /**
-     * The structured error details of the error. This is left empty if the
-     * error response is not a standard Databricks API error.
-     */
-    details;
-    // The raw HTTP error details, undefined if this is not an HTTP error.
-    httpErr;
-    /**
-     * Do not use this constructor directly. Use {@link ApiError.fromHttpError}
-     * instead. This constructor is only meant for internal and testing use.
-     * TODO: Make this constructor private.
-     *
-     * @private
-     */
-    constructor(options) {
-        super(options.message, { cause: options.cause });
-        this.name = 'ApiError';
-        this.code = options.code;
-        this.details = options.details;
-        if (options.httpStatusCode !== undefined) {
-            this.httpErr = {
-                statusCode: options.httpStatusCode,
-                header: options.httpHeader,
-                body: options.httpBody,
-            };
-        }
-    }
-    /**
-     * Returns the ApiError's HTTP status code. If the ApiError is not an HTTP
-     * error, returns -1.
-     */
-    get httpStatusCode() {
-        if (this.httpErr === undefined) {
-            return -1;
-        }
-        return this.httpErr.statusCode;
-    }
-    /**
-     * Returns the ApiError's HTTP headers. If the ApiError is not an HTTP
-     * error, returns undefined.
-     */
-    get httpHeader() {
-        if (this.httpErr === undefined) {
-            return undefined;
-        }
-        return this.httpErr.header;
-    }
-    /**
-     * Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,
-     * returns undefined.
-     */
-    get httpBody() {
-        if (this.httpErr === undefined) {
-            return undefined;
-        }
-        return this.httpErr.body;
-    }
-    /**
-     * Parses an HTTP error response into an ApiError. Returns undefined if the
-     * status code is 2xx.
-     */
-    static fromHttpError(statusCode, header, body) {
-        if (statusCode >= 200 && statusCode < 300) {
-            return undefined;
-        }
-        const emptyDetails = { unknownDetails: [] };
-        if (body === undefined || body.length === 0) {
-            return new ApiError({
-                code: Code.UNKNOWN,
-                message: '',
-                details: emptyDetails,
-                httpStatusCode: statusCode,
-                httpHeader: header,
-                httpBody: body,
-            });
-        }
-        // Decode the body to a string for JSON parsing.
-        let parsed;
-        try {
-            parsed = JSON.parse(new TextDecoder().decode(body));
-        }
-        catch (e) {
-            // The JSON error is simply swallowed, this typically happens when the
-            // error does not come directly from a Databricks API. A typical example
-            // is when the error is returned by a proxy.
-            return new ApiError({
-                code: Code.UNKNOWN,
-                message: '',
-                details: emptyDetails,
-                httpStatusCode: statusCode,
-                httpHeader: header,
-                httpBody: body,
-                cause: e instanceof Error ? e : undefined,
-            });
-        }
-        const result = errorResponseSchema.safeParse(parsed);
-        if (!result.success) {
-            return new ApiError({
-                code: Code.UNKNOWN,
-                message: '',
-                details: emptyDetails,
-                httpStatusCode: statusCode,
-                httpHeader: header,
-                httpBody: body,
-                cause: result.error,
-            });
-        }
-        const errResp = result.data;
-        // code carries the error_code string verbatim: a canonical code (e.g.
-        // "NOT_FOUND") matches a named Code member, while a Databricks
-        // product-specific code (e.g. "CATALOG_DOES_NOT_EXIST") is an open Code
-        // value. It is Code.UNKNOWN when the response carries no string error_code
-        // (missing or an integer); the HTTP status is never used to infer a code,
-        // since it may not reflect the true error semantic, so callers fall back to
-        // httpStatusCode.
-        const code = typeof errResp.error_code === 'string' && errResp.error_code !== ''
-            ? errResp.error_code
-            : Code.UNKNOWN;
-        // Determine the error message from available fields.
-        let errorMessage = '';
-        if (errResp.message !== '') {
-            errorMessage = errResp.message;
-        }
-        else if (errResp.error !== '') {
-            errorMessage = errResp.error;
-        }
-        else if (errResp.detail !== '') {
-            errorMessage = errResp.detail;
-        }
-        else if (errResp.scimType !== '') {
-            errorMessage = errResp.scimType;
-        }
-        return new ApiError({
-            code,
-            message: errorMessage,
-            details: parseErrorDetails(errResp.details),
-            httpStatusCode: statusCode,
-            httpHeader: header,
-            httpBody: body,
-        });
-    }
-}
+var ApiError = class ApiError extends Error {
+	/**
+	* The error code of the error.
+	*/
+	code;
+	/**
+	* The structured error details of the error. This is left empty if the
+	* error response is not a standard Databricks API error.
+	*/
+	details;
+	httpErr;
+	/**
+	* Do not use this constructor directly. Use {@link ApiError.fromHttpError}
+	* instead. This constructor is only meant for internal and testing use.
+	* TODO: Make this constructor private.
+	*
+	* @private
+	*/
+	constructor(options) {
+		super(options.message, { cause: options.cause });
+		this.name = "ApiError";
+		this.code = options.code;
+		this.details = options.details;
+		if (options.httpStatusCode !== void 0) this.httpErr = {
+			statusCode: options.httpStatusCode,
+			header: options.httpHeader,
+			body: options.httpBody
+		};
+	}
+	/**
+	* Returns the ApiError's HTTP status code. If the ApiError is not an HTTP
+	* error, returns -1.
+	*/
+	get httpStatusCode() {
+		if (this.httpErr === void 0) return -1;
+		return this.httpErr.statusCode;
+	}
+	/**
+	* Returns the ApiError's HTTP headers. If the ApiError is not an HTTP
+	* error, returns undefined.
+	*/
+	get httpHeader() {
+		if (this.httpErr === void 0) return;
+		return this.httpErr.header;
+	}
+	/**
+	* Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,
+	* returns undefined.
+	*/
+	get httpBody() {
+		if (this.httpErr === void 0) return;
+		return this.httpErr.body;
+	}
+	/**
+	* Parses an HTTP error response into an ApiError. Returns undefined if the
+	* status code is 2xx.
+	*/
+	static fromHttpError(statusCode, header, body) {
+		if (statusCode >= 200 && statusCode < 300) return;
+		const emptyDetails = { unknownDetails: [] };
+		if (body === void 0 || body.length === 0) return new ApiError({
+			code: Code.UNKNOWN,
+			message: "",
+			details: emptyDetails,
+			httpStatusCode: statusCode,
+			httpHeader: header,
+			httpBody: body
+		});
+		let parsed;
+		try {
+			parsed = JSON.parse(new TextDecoder().decode(body));
+		} catch (e) {
+			return new ApiError({
+				code: Code.UNKNOWN,
+				message: "",
+				details: emptyDetails,
+				httpStatusCode: statusCode,
+				httpHeader: header,
+				httpBody: body,
+				cause: e instanceof Error ? e : void 0
+			});
+		}
+		const result = errorResponseSchema.safeParse(parsed);
+		if (!result.success) return new ApiError({
+			code: Code.UNKNOWN,
+			message: "",
+			details: emptyDetails,
+			httpStatusCode: statusCode,
+			httpHeader: header,
+			httpBody: body,
+			cause: result.error
+		});
+		const errResp = result.data;
+		const code = typeof errResp.error_code === "string" && errResp.error_code !== "" ? errResp.error_code : Code.UNKNOWN;
+		let errorMessage = "";
+		if (errResp.message !== "") errorMessage = errResp.message;
+		else if (errResp.error !== "") errorMessage = errResp.error;
+		else if (errResp.detail !== "") errorMessage = errResp.detail;
+		else if (errResp.scimType !== "") errorMessage = errResp.scimType;
+		return new ApiError({
+			code,
+			message: errorMessage,
+			details: parseErrorDetails(errResp.details),
+			httpStatusCode: statusCode,
+			httpHeader: header,
+			httpBody: body
+		});
+	}
+};
+
+//#endregion
+export { ApiError };
 //# sourceMappingURL=apierror.js.map

package/dist/apierror/apierror.js.map

@@ -1 +1 @@
-{"version":3,"file":"apierror.js","sourceRoot":"","sources":["../../src/apierror/apierror.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apierror.js","names":[],"sources":["../../src/apierror/apierror.ts"],"sourcesContent":["import {z} from 'zod';\n\nimport {Code} from './codes';\nimport type {ErrorDetails} from './details';\nimport {parseErrorDetails} from './details';\n\n// Reusable schema fragment for nullish string fields.\nconst nullishString = z\n  .string()\n  .nullish()\n  .transform(v => v ?? '');\n\n// Zod schema for parsing the JSON error response body. The schema is lenient\n// to handle the various Databricks API error formats (standard, legacy, SCIM).\nconst errorResponseSchema = z.object({\n  message: nullishString,\n  details: z\n    .array(z.unknown())\n    .nullish()\n    .transform(v => v ?? []),\n  // Some Databricks APIs incorrectly return the HTTP status code as an\n  // integer rather than the actual error code as a string.\n  error_code: z.unknown().optional(),\n  // Legacy Databricks APIs (e.g. version 1.2 and earlier) used \"error\"\n  // instead of \"message\".\n  error: nullishString,\n  // SCIM error fields (RFC7644 section 3.7.3).\n  // The \"status\" field is intentionally omitted; it duplicates HTTP status.\n  detail: nullishString,\n  scimType: nullishString,\n});\n\n// Constructor options for ApiError.\ninterface ApiErrorOptions {\n  code: Code;\n  message: string;\n  details: ErrorDetails;\n  httpStatusCode?: number | undefined;\n  httpHeader?: Headers | undefined;\n  httpBody?: Uint8Array | undefined;\n  cause?: unknown;\n}\n\n/** ApiError is a transport-agnostic error representing a Databricks API error. */\nexport class ApiError extends Error {\n  /**\n   * The error code of the error.\n   */\n  readonly code: Code;\n\n  /**\n   * The structured error details of the error. This is left empty if the\n   * error response is not a standard Databricks API error.\n   */\n  readonly details: ErrorDetails;\n\n  // The raw HTTP error details, undefined if this is not an HTTP error.\n  private readonly httpErr?: {\n    readonly statusCode: number;\n    readonly header: Headers | undefined;\n    readonly body: Uint8Array | undefined;\n  };\n\n  /**\n   * Do not use this constructor directly. Use {@link ApiError.fromHttpError}\n   * instead. This constructor is only meant for internal and testing use.\n   * TODO: Make this constructor private.\n   *\n   * @private\n   */\n  constructor(options: ApiErrorOptions) {\n    super(options.message, {cause: options.cause});\n    this.name = 'ApiError';\n    this.code = options.code;\n    this.details = options.details;\n    if (options.httpStatusCode !== undefined) {\n      this.httpErr = {\n        statusCode: options.httpStatusCode,\n        header: options.httpHeader,\n        body: options.httpBody,\n      };\n    }\n  }\n\n  /**\n   * Returns the ApiError's HTTP status code. If the ApiError is not an HTTP\n   * error, returns -1.\n   */\n  get httpStatusCode(): number {\n    if (this.httpErr === undefined) {\n      return -1;\n    }\n    return this.httpErr.statusCode;\n  }\n\n  /**\n   * Returns the ApiError's HTTP headers. If the ApiError is not an HTTP\n   * error, returns undefined.\n   */\n  get httpHeader(): Headers | undefined {\n    if (this.httpErr === undefined) {\n      return undefined;\n    }\n    return this.httpErr.header;\n  }\n\n  /**\n   * Returns the ApiError's HTTP body. If the ApiError is not an HTTP error,\n   * returns undefined.\n   */\n  get httpBody(): Uint8Array | undefined {\n    if (this.httpErr === undefined) {\n      return undefined;\n    }\n    return this.httpErr.body;\n  }\n\n  /**\n   * Parses an HTTP error response into an ApiError. Returns undefined if the\n   * status code is 2xx.\n   */\n  static fromHttpError(\n    statusCode: number,\n    header: Headers | undefined,\n    body: Uint8Array | undefined\n  ): ApiError | undefined {\n    if (statusCode >= 200 && statusCode < 300) {\n      return undefined;\n    }\n\n    const emptyDetails: ErrorDetails = {unknownDetails: []};\n\n    if (body === undefined || body.length === 0) {\n      return new ApiError({\n        code: Code.UNKNOWN,\n        message: '',\n        details: emptyDetails,\n        httpStatusCode: statusCode,\n        httpHeader: header,\n        httpBody: body,\n      });\n    }\n\n    // Decode the body to a string for JSON parsing.\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(new TextDecoder().decode(body));\n    } catch (e: unknown) {\n      // The JSON error is simply swallowed, this typically happens when the\n      // error does not come directly from a Databricks API. A typical example\n      // is when the error is returned by a proxy.\n      return new ApiError({\n        code: Code.UNKNOWN,\n        message: '',\n        details: emptyDetails,\n        httpStatusCode: statusCode,\n        httpHeader: header,\n        httpBody: body,\n        cause: e instanceof Error ? e : undefined,\n      });\n    }\n\n    const result = errorResponseSchema.safeParse(parsed);\n    if (!result.success) {\n      return new ApiError({\n        code: Code.UNKNOWN,\n        message: '',\n        details: emptyDetails,\n        httpStatusCode: statusCode,\n        httpHeader: header,\n        httpBody: body,\n        cause: result.error,\n      });\n    }\n\n    const errResp = result.data;\n\n    // code carries the error_code string verbatim: a canonical code (e.g.\n    // \"NOT_FOUND\") matches a named Code member, while a Databricks\n    // product-specific code (e.g. \"CATALOG_DOES_NOT_EXIST\") is an open Code\n    // value. It is Code.UNKNOWN when the response carries no string error_code\n    // (missing or an integer); the HTTP status is never used to infer a code,\n    // since it may not reflect the true error semantic, so callers fall back to\n    // httpStatusCode.\n    const code: Code =\n      typeof errResp.error_code === 'string' && errResp.error_code !== ''\n        ? errResp.error_code\n        : Code.UNKNOWN;\n\n    // Determine the error message from available fields.\n    let errorMessage = '';\n    if (errResp.message !== '') {\n      errorMessage = errResp.message;\n    } else if (errResp.error !== '') {\n      errorMessage = errResp.error;\n    } else if (errResp.detail !== '') {\n      errorMessage = errResp.detail;\n    } else if (errResp.scimType !== '') {\n      errorMessage = errResp.scimType;\n    }\n\n    return new ApiError({\n      code,\n      message: errorMessage,\n      details: parseErrorDetails(errResp.details),\n      httpStatusCode: statusCode,\n      httpHeader: header,\n      httpBody: body,\n    });\n  }\n}\n"],"mappings":";;;;;AAOA,MAAM,gBAAgB,EACnB,QAAQ,CACR,SAAS,CACT,WAAU,MAAK,KAAK,GAAG;AAI1B,MAAM,sBAAsB,EAAE,OAAO;CACnC,SAAS;CACT,SAAS,EACN,MAAM,EAAE,SAAS,CAAC,CAClB,SAAS,CACT,WAAU,MAAK,KAAK,EAAE,CAAC;CAG1B,YAAY,EAAE,SAAS,CAAC,UAAU;CAGlC,OAAO;CAGP,QAAQ;CACR,UAAU;CACX,CAAC;;AAcF,IAAa,WAAb,MAAa,iBAAiB,MAAM;;;;CAIlC,AAAS;;;;;CAMT,AAAS;CAGT,AAAiB;;;;;;;;CAajB,YAAY,SAA0B;AACpC,QAAM,QAAQ,SAAS,EAAC,OAAO,QAAQ,OAAM,CAAC;AAC9C,OAAK,OAAO;AACZ,OAAK,OAAO,QAAQ;AACpB,OAAK,UAAU,QAAQ;AACvB,MAAI,QAAQ,mBAAmB,OAC7B,MAAK,UAAU;GACb,YAAY,QAAQ;GACpB,QAAQ,QAAQ;GAChB,MAAM,QAAQ;GACf;;;;;;CAQL,IAAI,iBAAyB;AAC3B,MAAI,KAAK,YAAY,OACnB,QAAO;AAET,SAAO,KAAK,QAAQ;;;;;;CAOtB,IAAI,aAAkC;AACpC,MAAI,KAAK,YAAY,OACnB;AAEF,SAAO,KAAK,QAAQ;;;;;;CAOtB,IAAI,WAAmC;AACrC,MAAI,KAAK,YAAY,OACnB;AAEF,SAAO,KAAK,QAAQ;;;;;;CAOtB,OAAO,cACL,YACA,QACA,MACsB;AACtB,MAAI,cAAc,OAAO,aAAa,IACpC;EAGF,MAAM,eAA6B,EAAC,gBAAgB,EAAE,EAAC;AAEvD,MAAI,SAAS,UAAa,KAAK,WAAW,EACxC,QAAO,IAAI,SAAS;GAClB,MAAM,KAAK;GACX,SAAS;GACT,SAAS;GACT,gBAAgB;GAChB,YAAY;GACZ,UAAU;GACX,CAAC;EAIJ,IAAI;AACJ,MAAI;AACF,YAAS,KAAK,MAAM,IAAI,aAAa,CAAC,OAAO,KAAK,CAAC;WAC5C,GAAY;AAInB,UAAO,IAAI,SAAS;IAClB,MAAM,KAAK;IACX,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,YAAY;IACZ,UAAU;IACV,OAAO,aAAa,QAAQ,IAAI;IACjC,CAAC;;EAGJ,MAAM,SAAS,oBAAoB,UAAU,OAAO;AACpD,MAAI,CAAC,OAAO,QACV,QAAO,IAAI,SAAS;GAClB,MAAM,KAAK;GACX,SAAS;GACT,SAAS;GACT,gBAAgB;GAChB,YAAY;GACZ,UAAU;GACV,OAAO,OAAO;GACf,CAAC;EAGJ,MAAM,UAAU,OAAO;EASvB,MAAM,OACJ,OAAO,QAAQ,eAAe,YAAY,QAAQ,eAAe,KAC7D,QAAQ,aACR,KAAK;EAGX,IAAI,eAAe;AACnB,MAAI,QAAQ,YAAY,GACtB,gBAAe,QAAQ;WACd,QAAQ,UAAU,GAC3B,gBAAe,QAAQ;WACd,QAAQ,WAAW,GAC5B,gBAAe,QAAQ;WACd,QAAQ,aAAa,GAC9B,gBAAe,QAAQ;AAGzB,SAAO,IAAI,SAAS;GAClB;GACA,SAAS;GACT,SAAS,kBAAkB,QAAQ,QAAQ;GAC3C,gBAAgB;GAChB,YAAY;GACZ,UAAU;GACX,CAAC"}