@nvisy/sdk 0.3.0 → 0.5.0

package/dist/client-DAxwkjk3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-DAxwkjk3.d.ts","names":[],"sources":["../src/services/account.ts","../src/services/activities.ts","../src/services/api-tokens.ts","../src/services/auth.ts","../src/services/connections.ts","../src/services/files.ts","../src/services/invites.ts","../src/services/members.ts","../src/services/notifications.ts","../src/services/pipelines.ts","../src/services/policies.ts","../src/services/runs.ts","../src/services/status.ts","../src/services/webhooks.ts","../src/services/workspaces.ts","../src/client.ts"],"mappings":"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"}

package/dist/config-BRQp8Cat.d.ts

@@ -0,0 +1,83 @@
+//#region src/config.d.ts
+/**
+ * @fileoverview Configuration types and constants for the Nvisy SDK.
+ *
+ * This module provides configuration interfaces, default values, and environment
+ * variable names used throughout the SDK.
+ *
+ * @module config
+ */
+/**
+ * Current SDK version.
+ *
+ * Used in the default user agent string and for version tracking.
+ */
+declare const VERSION = "0.3.0";
+/**
+ * Configuration options for creating a Nvisy client.
+ *
+ * The `apiToken` field is required for authentication. All other fields are optional
+ * and will use sensible defaults when omitted.
+ *
+ * @example
+ * ```typescript
+ * const config: ClientConfig = {
+ *   apiToken: "your-api-token",
+ *   baseUrl: "https://api.nvisy.com",
+ *   headers: { "X-Custom-Header": "value" },
+ * };
+ * const client = new Client(config);
+ * ```
+ */
+interface ClientConfig {
+  /**
+   * API token for authentication.
+   *
+   * Tokens can be obtained from the Nvisy dashboard or via the auth endpoints.
+   */
+  apiToken: string;
+  /**
+   * Base URL for the Nvisy API.
+   *
+   * @default "https://api.nvisy.com"
+   */
+  baseUrl?: string;
+  /**
+   * Custom headers to include with every request.
+   *
+   * These headers are merged with the default headers (Content-Type, User-Agent,
+   * and Authorization). Custom headers take precedence over defaults if there
+   * are conflicts.
+   */
+  headers?: Record<string, string>;
+  /**
+   * Custom user agent string to identify your application.
+   *
+   * @default "@nvisy/sdk v.{version}"
+   */
+  userAgent?: string;
+  /**
+   * Enable logging for requests and responses.
+   *
+   * When enabled, logs request method, URL, status, and timing to console.
+   *
+   * @default false
+   */
+  withLogging?: boolean;
+}
+/**
+ * Default configuration values used when options are not explicitly provided.
+ */
+declare const DEFAULTS: {
+  /**
+   * Default base URL for the Nvisy API.
+   */
+  readonly BASE_URL: "https://api.nvisy.com";
+  /**
+   * Default user agent string.
+   */
+  readonly USER_AGENT: "@nvisy/sdk v.0.3.0";
+};
+//#endregion
+export { DEFAULTS as n, VERSION as r, ClientConfig as t };
+//# sourceMappingURL=config-BRQp8Cat.d.ts.map

package/dist/config-BRQp8Cat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-BRQp8Cat.d.ts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;;;;;;;;cAca;;;;;;;;;;;;;;;;;UAkBI;;;;;;EAMhB;;;;;;EAOA;;;;;;;;EASA,UAAU;;;;;;EAOV;;;;;;;;EASA;;;;;cAMY;;;;WAAA;;;;WAAA"}

package/dist/datatypes/index.d.ts

@@ -1,9 +1,2 @@
-export { A as Account, c as ActivitiesPage, a as Activity, b as ActivityType, d as Annotation, f as AnnotationsPage, g as ApiToken, i as ApiTokenType, h as ApiTokenWithJWT, l as ApiTokensPage, x as ArchiveFormat, af as CheckHealth, m as Comment, p as CommentsPage, u as ContentSegmentation, C as CreateAnnotation, j as CreateApiToken, n as CreateComment, q as CreateDocument, B as CreateIntegration, N as CreateInvite, ah as CreateWebhook, ap as CreateWorkspace, aa as CursorPagination, w as DeleteFiles, D as Document, s as DocumentsPage, v as DownloadFiles, F as File, y as FileFormat, z as FilesPage, O as GenerateInviteCode, I as Integration, ab as IntegrationRun, ac as IntegrationRunsPage, J as IntegrationStatus, H as IntegrationType, K as IntegrationsPage, M as Invite, Q as InviteCode, V as InviteExpiration, Z as InvitePreview, X as InviteSortField, S as InviteStatus, _ as InvitesPage, L as ListFiles, W as ListInvites, a1 as ListMembers, $ as Member, a2 as MemberSortField, a3 as MembersPage, ad as MonitorStatus, a4 as Notification, a5 as NotificationEvent, a6 as NotificationSettings, a9 as NotificationsPage, P as ProcessingStatus, R as ReplyInvite, ae as ServiceStatus, Y as SortOrder, aj as TestWebhook, T as TokenExpiration, a8 as UnreadStatus, U as UpdateAccount, e as UpdateAnnotation, k as UpdateApiToken, o as UpdateComment, r as UpdateDocument, t as UpdateFile, E as UpdateIntegration, G as UpdateIntegrationCredentials, a0 as UpdateMember, a7 as UpdateNotificationSettings, ai as UpdateWebhook, aq as UpdateWorkspace, ag as Webhook, am as WebhookEvent, ak as WebhookResult, al as WebhookStatus, an as WebhooksPage, ao as Workspace, ar as WorkspaceRole, as as WorkspacesPage } from '../workspace-BjdbMWsa.js';
-import { c as components } from '../auth-CncOz2vx.js';
-export { A as AuthToken, L as Login, S as Signup } from '../auth-CncOz2vx.js';
-
-type Schemas = components["schemas"];
-type ErrorResponse = Schemas["ErrorResponse"];
-type ValidationErrorDetail = Schemas["ValidationErrorDetail"];
-
-export type { ErrorResponse, ValidationErrorDetail };
+import { $ as InvitePreview, A as PipelineFilter, At as ApiTokensPage, B as NotificationsPage, C as PolicyAction, Ct as UpdateConnection, D as CreatePipeline, Dt as ApiToken, E as UpdatePolicy, Et as Signup, F as UpdatePipeline, Ft as Activity, G as MemberSortField, H as UpdateNotificationSettings, I as CursorPagination, It as ActivityType, J as CreateInvite, K as MembersPage, L as Notification, Lt as Account, M as PipelineSummariesPage, Mt as TokenExpiration, N as PipelineSummary, Nt as UpdateApiToken, O as Pipeline, Ot as ApiTokenType, P as PipelineTriggerType, Pt as ActivitiesPage, Q as InviteExpiration, R as NotificationEvent, Rt as PublicAccount, S as Policy, St as CreateConnection, T as PolicyRule, Tt as Login, U as ListMembers, V as UnreadStatus, W as Member, X as Invite, Y as GenerateInviteCode, Z as InviteCode, _ as PipelineRun, _t as ErrorResponse, a as WorkspacesPage, at as ReplyInvite, b as CreatePolicy, bt as ConnectionsPage, c as UpdateWebhook, ct as ComponentHealth, d as WebhookEvent, dt as File, et as InviteSent, f as WebhookResult, ft as FileFormat, g as CreatePipelineRun, gt as UpdateFile, h as AnalyzedDocument, ht as ListFiles, i as WorkspaceRole, it as ListInvites, j as PipelineStatus, jt as CreateApiToken, k as PipelineDefinition, kt as ApiTokenWithJWT, l as Webhook, lt as Health, m as WebhooksPage, mt as FilesPage, n as UpdateWorkspace, nt as InviteStatus, o as CreateWebhook, ot as SortOrder, p as WebhookStatus, pt as FileSource, q as UpdateMember, r as Workspace, rt as InvitesPage, s as TestWebhook, st as CheckHealth, t as CreateWorkspace, tt as InviteSortField, u as WebhookCreated, ut as HealthStatus, v as PipelineRunStatus, vt as ValidationErrorDetail, w as PolicyDefinition, wt as AuthToken, x as PoliciesPage, xt as ConnectionsQuery, y as PipelineRunsPage, yt as Connection, z as NotificationSettings, zt as UpdateAccount } from "../index-DfNB2LNT.js";
+export type { Account, ActivitiesPage, Activity, ActivityType, AnalyzedDocument, ApiToken, ApiTokenType, ApiTokenWithJWT, ApiTokensPage, AuthToken, CheckHealth, ComponentHealth, Connection, ConnectionsPage, ConnectionsQuery, CreateApiToken, CreateConnection, CreateInvite, CreatePipeline, CreatePipelineRun, CreatePolicy, CreateWebhook, CreateWorkspace, CursorPagination, ErrorResponse, File, FileFormat, FileSource, FilesPage, GenerateInviteCode, Health, HealthStatus, Invite, InviteCode, InviteExpiration, InvitePreview, InviteSent, InviteSortField, InviteStatus, InvitesPage, ListFiles, ListInvites, ListMembers, Login, Member, MemberSortField, MembersPage, Notification, NotificationEvent, NotificationSettings, NotificationsPage, Pipeline, PipelineDefinition, PipelineFilter, PipelineRun, PipelineRunStatus, PipelineRunsPage, PipelineStatus, PipelineSummariesPage, PipelineSummary, PipelineTriggerType, PoliciesPage, Policy, PolicyAction, PolicyDefinition, PolicyRule, PublicAccount, ReplyInvite, Signup, SortOrder, TestWebhook, TokenExpiration, UnreadStatus, UpdateAccount, UpdateApiToken, UpdateConnection, UpdateFile, UpdateMember, UpdateNotificationSettings, UpdatePipeline, UpdatePolicy, UpdateWebhook, UpdateWorkspace, ValidationErrorDetail, Webhook, WebhookCreated, WebhookEvent, WebhookResult, WebhookStatus, WebhooksPage, Workspace, WorkspaceRole, WorkspacesPage };

package/dist/datatypes/index.js

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/error-DmkKaDjI.js

@@ -0,0 +1,199 @@
+//#region src/config.ts
+/**
+* @fileoverview Configuration types and constants for the Nvisy SDK.
+*
+* This module provides configuration interfaces, default values, and environment
+* variable names used throughout the SDK.
+*
+* @module config
+*/
+/**
+* Current SDK version.
+*
+* Used in the default user agent string and for version tracking.
+*/
+const VERSION = "0.3.0";
+/**
+* Default configuration values used when options are not explicitly provided.
+*/
+const DEFAULTS = {
+	/**
+	* Default base URL for the Nvisy API.
+	*/
+	BASE_URL: "https://api.nvisy.com",
+	/**
+	* Default user agent string.
+	*/
+	USER_AGENT: `@nvisy/sdk v.${VERSION}`
+};
+
+//#endregion
+//#region src/errors.ts
+/**
+* Base error class for all Nvisy SDK errors.
+*
+* This class provides common functionality for all SDK errors.
+* It ensures proper error naming and stack traces.
+*
+* @example
+* ```typescript
+* try {
+*   const client = new Client({ apiToken: "" });
+* } catch (error) {
+*   if (error instanceof NvisyError) {
+*     console.log("SDK error:", error.message);
+*   }
+* }
+* ```
+*/
+var NvisyError = class extends Error {
+	/**
+	* The error class name.
+	*/
+	name;
+	/**
+	* Creates a new NvisyError.
+	*
+	* @param message - The error message
+	*/
+	constructor(message) {
+		super(message);
+		this.name = this.constructor.name;
+	}
+};
+/**
+* Error thrown when the Nvisy API returns an error response.
+*
+* This error class wraps the API's {@link ErrorResponse} format and adds
+* the HTTP status code. It provides helper methods to categorize errors
+* and determine if they are retryable.
+*
+* @example
+* ```typescript
+* try {
+*   await client.account.getAccount();
+* } catch (error) {
+*   if (error instanceof NvisyApiError) {
+*     console.log(`API Error: ${error.message}`);
+*     console.log(`Status: ${error.statusCode}`);
+*     if (error.isRetryable()) {
+*       // Implement retry logic
+*     }
+*   }
+* }
+* ```
+*/
+var NvisyApiError = class extends NvisyError {
+	/**
+	* The error type identifier (e.g., "ValidationError", "NotFoundError").
+	*/
+	name;
+	/**
+	* Human-readable error message safe for display to end users.
+	*/
+	message;
+	/**
+	* The resource type that the error relates to (e.g., "account", "project").
+	* May be undefined if the error is not resource-specific.
+	*/
+	resource;
+	/**
+	* A helpful suggestion for resolving the error.
+	* May be undefined if no suggestion is available.
+	*/
+	suggestion;
+	/**
+	* Field-specific validation errors.
+	* Present when the error is due to invalid input data.
+	*/
+	validation;
+	/**
+	* HTTP status code of the response (e.g., 400, 404, 500).
+	*/
+	statusCode;
+	/**
+	* Creates a new NvisyApiError from an API error response.
+	*
+	* @param response - The error response from the API
+	* @param statusCode - The HTTP status code of the response
+	*/
+	constructor(response, statusCode) {
+		super(response.message);
+		this.name = response.name;
+		this.message = response.message;
+		this.resource = response.resource;
+		this.suggestion = response.suggestion;
+		this.validation = response.validation;
+		this.statusCode = statusCode;
+	}
+	/**
+	* Checks if this is a client error (4xx status code).
+	*
+	* Client errors indicate problems with the request itself, such as
+	* invalid input, missing authentication, or accessing non-existent resources.
+	*
+	* @returns True if the status code is in the 4xx range
+	*/
+	isClientError() {
+		return this.statusCode >= 400 && this.statusCode < 500;
+	}
+	/**
+	* Checks if this is a server error (5xx status code).
+	*
+	* Server errors indicate problems on the API side. These are typically
+	* transient and may succeed if retried.
+	*
+	* @returns True if the status code is in the 5xx range
+	*/
+	isServerError() {
+		return this.statusCode >= 500;
+	}
+	/**
+	* Determines if this error is safe to retry.
+	*
+	* An error is considered retryable if it's a server error (5xx),
+	* a request timeout (408), or rate limiting (429).
+	*
+	* @returns True if the request may succeed on retry
+	*/
+	isRetryable() {
+		return this.statusCode >= 500 || this.statusCode === 408 || this.statusCode === 429;
+	}
+	/**
+	* Converts the error to a plain {@link ErrorResponse} object.
+	*
+	* Useful for serialization or logging.
+	*
+	* @returns A plain object representation of the error
+	*/
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message,
+			resource: this.resource,
+			suggestion: this.suggestion,
+			validation: this.validation
+		};
+	}
+};
+
+//#endregion
+//#region src/middleware/error.ts
+/**
+* Middleware that automatically throws NvisyApiError for error responses.
+* This replaces the need for manual checks in services.
+*/
+const errorMiddleware = {
+	async onResponse({ response }) {
+		if (!response.ok) throw new NvisyApiError(await response.clone().json(), response.status);
+		return response;
+	},
+	onError({ error }) {
+		if (error instanceof Error) throw new NvisyError(error.message);
+		throw new NvisyError("An unknown network error occurred");
+	}
+};
+
+//#endregion
+export { VERSION as a, DEFAULTS as i, NvisyApiError as n, NvisyError as r, errorMiddleware as t };
+//# sourceMappingURL=error-DmkKaDjI.js.map

package/dist/error-DmkKaDjI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-DmkKaDjI.js","names":[],"sources":["../src/config.ts","../src/errors.ts","../src/middleware/error.ts"],"sourcesContent":["/**\n * @fileoverview Configuration types and constants for the Nvisy SDK.\n *\n * This module provides configuration interfaces, default values, and environment\n * variable names used throughout the SDK.\n *\n * @module config\n */\n\n/**\n * Current SDK version.\n *\n * Used in the default user agent string and for version tracking.\n */\nexport const VERSION = \"0.3.0\";\n\n/**\n * Configuration options for creating a Nvisy client.\n *\n * The `apiToken` field is required for authentication. All other fields are optional\n * and will use sensible defaults when omitted.\n *\n * @example\n * ```typescript\n * const config: ClientConfig = {\n *   apiToken: \"your-api-token\",\n *   baseUrl: \"https://api.nvisy.com\",\n *   headers: { \"X-Custom-Header\": \"value\" },\n * };\n * const client = new Client(config);\n * ```\n */\nexport interface ClientConfig {\n\t/**\n\t * API token for authentication.\n\t *\n\t * Tokens can be obtained from the Nvisy dashboard or via the auth endpoints.\n\t */\n\tapiToken: string;\n\n\t/**\n\t * Base URL for the Nvisy API.\n\t *\n\t * @default \"https://api.nvisy.com\"\n\t */\n\tbaseUrl?: string;\n\n\t/**\n\t * Custom headers to include with every request.\n\t *\n\t * These headers are merged with the default headers (Content-Type, User-Agent,\n\t * and Authorization). Custom headers take precedence over defaults if there\n\t * are conflicts.\n\t */\n\theaders?: Record<string, string>;\n\n\t/**\n\t * Custom user agent string to identify your application.\n\t *\n\t * @default \"@nvisy/sdk v.{version}\"\n\t */\n\tuserAgent?: string;\n\n\t/**\n\t * Enable logging for requests and responses.\n\t *\n\t * When enabled, logs request method, URL, status, and timing to console.\n\t *\n\t * @default false\n\t */\n\twithLogging?: boolean;\n}\n\n/**\n * Default configuration values used when options are not explicitly provided.\n */\nexport const DEFAULTS = {\n\t/**\n\t * Default base URL for the Nvisy API.\n\t */\n\tBASE_URL: \"https://api.nvisy.com\",\n\n\t/**\n\t * Default user agent string.\n\t */\n\tUSER_AGENT: `@nvisy/sdk v.${VERSION}`,\n} as const;\n","/**\n * @fileoverview Error types for the Nvisy SDK.\n *\n * This module defines the error hierarchy used throughout the SDK:\n * - {@link NvisyError} - Base error class for all SDK errors\n * - {@link NvisyApiError} - Errors returned by the Nvisy API (4xx/5xx responses)\n *\n * @module errors\n */\n\nimport type { ErrorResponse } from \"@/datatypes/index.js\";\n\n// Re-export ErrorResponse type for convenience\nexport type { ErrorResponse } from \"@/datatypes/index.js\";\n\n/**\n * Base error class for all Nvisy SDK errors.\n *\n * This class provides common functionality for all SDK errors.\n * It ensures proper error naming and stack traces.\n *\n * @example\n * ```typescript\n * try {\n *   const client = new Client({ apiToken: \"\" });\n * } catch (error) {\n *   if (error instanceof NvisyError) {\n *     console.log(\"SDK error:\", error.message);\n *   }\n * }\n * ```\n */\nexport class NvisyError extends Error {\n\t/**\n\t * The error class name.\n\t */\n\tpublic readonly name: string;\n\n\t/**\n\t * Creates a new NvisyError.\n\t *\n\t * @param message - The error message\n\t */\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = this.constructor.name;\n\t}\n}\n\n/**\n * Error thrown when the Nvisy API returns an error response.\n *\n * This error class wraps the API's {@link ErrorResponse} format and adds\n * the HTTP status code. It provides helper methods to categorize errors\n * and determine if they are retryable.\n *\n * @example\n * ```typescript\n * try {\n *   await client.account.getAccount();\n * } catch (error) {\n *   if (error instanceof NvisyApiError) {\n *     console.log(`API Error: ${error.message}`);\n *     console.log(`Status: ${error.statusCode}`);\n *     if (error.isRetryable()) {\n *       // Implement retry logic\n *     }\n *   }\n * }\n * ```\n */\nexport class NvisyApiError extends NvisyError implements ErrorResponse {\n\t/**\n\t * The error type identifier (e.g., \"ValidationError\", \"NotFoundError\").\n\t */\n\tpublic readonly name: string;\n\n\t/**\n\t * Human-readable error message safe for display to end users.\n\t */\n\tpublic readonly message: string;\n\n\t/**\n\t * The resource type that the error relates to (e.g., \"account\", \"project\").\n\t * May be undefined if the error is not resource-specific.\n\t */\n\tpublic readonly resource?: string;\n\n\t/**\n\t * A helpful suggestion for resolving the error.\n\t * May be undefined if no suggestion is available.\n\t */\n\tpublic readonly suggestion?: string;\n\n\t/**\n\t * Field-specific validation errors.\n\t * Present when the error is due to invalid input data.\n\t */\n\tpublic readonly validation?: ErrorResponse[\"validation\"];\n\n\t/**\n\t * HTTP status code of the response (e.g., 400, 404, 500).\n\t */\n\tpublic readonly statusCode: number;\n\n\t/**\n\t * Creates a new NvisyApiError from an API error response.\n\t *\n\t * @param response - The error response from the API\n\t * @param statusCode - The HTTP status code of the response\n\t */\n\tconstructor(response: ErrorResponse, statusCode: number) {\n\t\tsuper(response.message);\n\t\tthis.name = response.name;\n\t\tthis.message = response.message;\n\t\tthis.resource = response.resource;\n\t\tthis.suggestion = response.suggestion;\n\t\tthis.validation = response.validation;\n\t\tthis.statusCode = statusCode;\n\t}\n\n\t/**\n\t * Checks if this is a client error (4xx status code).\n\t *\n\t * Client errors indicate problems with the request itself, such as\n\t * invalid input, missing authentication, or accessing non-existent resources.\n\t *\n\t * @returns True if the status code is in the 4xx range\n\t */\n\tisClientError(): boolean {\n\t\treturn this.statusCode >= 400 && this.statusCode < 500;\n\t}\n\n\t/**\n\t * Checks if this is a server error (5xx status code).\n\t *\n\t * Server errors indicate problems on the API side. These are typically\n\t * transient and may succeed if retried.\n\t *\n\t * @returns True if the status code is in the 5xx range\n\t */\n\tisServerError(): boolean {\n\t\treturn this.statusCode >= 500;\n\t}\n\n\t/**\n\t * Determines if this error is safe to retry.\n\t *\n\t * An error is considered retryable if it's a server error (5xx),\n\t * a request timeout (408), or rate limiting (429).\n\t *\n\t * @returns True if the request may succeed on retry\n\t */\n\tisRetryable(): boolean {\n\t\treturn (\n\t\t\tthis.statusCode >= 500 || // Server errors\n\t\t\tthis.statusCode === 408 || // Request timeout\n\t\t\tthis.statusCode === 429 // Rate limited\n\t\t);\n\t}\n\n\t/**\n\t * Converts the error to a plain {@link ErrorResponse} object.\n\t *\n\t * Useful for serialization or logging.\n\t *\n\t * @returns A plain object representation of the error\n\t */\n\ttoJSON(): ErrorResponse {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tmessage: this.message,\n\t\t\tresource: this.resource,\n\t\t\tsuggestion: this.suggestion,\n\t\t\tvalidation: this.validation,\n\t\t};\n\t}\n}\n","import type { Middleware } from \"openapi-fetch\";\nimport type { ErrorResponse } from \"@/datatypes/index.js\";\nimport { NvisyApiError, NvisyError } from \"@/errors.js\";\n\n/**\n * Middleware that automatically throws NvisyApiError for error responses.\n * This replaces the need for manual checks in services.\n */\nexport const errorMiddleware: Middleware = {\n\tasync onResponse({ response }) {\n\t\tif (!response.ok) {\n\t\t\tconst error = (await response.clone().json()) as ErrorResponse;\n\t\t\tthrow new NvisyApiError(error, response.status);\n\t\t}\n\t\treturn response;\n\t},\n\n\tonError({ error }) {\n\t\t// Wrap fetch errors (network failures, CORS, etc.) in NvisyError\n\t\tif (error instanceof Error) {\n\t\t\tthrow new NvisyError(error.message);\n\t\t}\n\t\tthrow new NvisyError(\"An unknown network error occurred\");\n\t},\n};\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,UAAU;;;;AA8DvB,MAAa,WAAW;;;;CAIvB,UAAU;;;;CAKV,YAAY,gBAAgB;AAC7B;;;;;;;;;;;;;;;;;;;;;ACtDA,IAAa,aAAb,cAAgC,MAAM;;;;CAIrC,AAAgB;;;;;;CAOhB,YAAY,SAAiB;EAC5B,MAAM,OAAO;EACb,KAAK,OAAO,KAAK,YAAY;CAC9B;AACD;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,gBAAb,cAAmC,WAAoC;;;;CAItE,AAAgB;;;;CAKhB,AAAgB;;;;;CAMhB,AAAgB;;;;;CAMhB,AAAgB;;;;;CAMhB,AAAgB;;;;CAKhB,AAAgB;;;;;;;CAQhB,YAAY,UAAyB,YAAoB;EACxD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO,SAAS;EACrB,KAAK,UAAU,SAAS;EACxB,KAAK,WAAW,SAAS;EACzB,KAAK,aAAa,SAAS;EAC3B,KAAK,aAAa,SAAS;EAC3B,KAAK,aAAa;CACnB;;;;;;;;;CAUA,gBAAyB;EACxB,OAAO,KAAK,cAAc,OAAO,KAAK,aAAa;CACpD;;;;;;;;;CAUA,gBAAyB;EACxB,OAAO,KAAK,cAAc;CAC3B;;;;;;;;;CAUA,cAAuB;EACtB,OACC,KAAK,cAAc,OACnB,KAAK,eAAe,OACpB,KAAK,eAAe;CAEtB;;;;;;;;CASA,SAAwB;EACvB,OAAO;GACN,MAAM,KAAK;GACX,SAAS,KAAK;GACd,UAAU,KAAK;GACf,YAAY,KAAK;GACjB,YAAY,KAAK;EAClB;CACD;AACD;;;;;;;;ACzKA,MAAa,kBAA8B;CAC1C,MAAM,WAAW,EAAE,YAAY;EAC9B,IAAI,CAAC,SAAS,IAEb,MAAM,IAAI,cAAc,MADH,SAAS,MAAM,CAAC,CAAC,KAAK,GACZ,SAAS,MAAM;EAE/C,OAAO;CACR;CAEA,QAAQ,EAAE,SAAS;EAElB,IAAI,iBAAiB,OACpB,MAAM,IAAI,WAAW,MAAM,OAAO;EAEnC,MAAM,IAAI,WAAW,mCAAmC;CACzD;AACD"}