@artu-ai/compliance-sdk 0.0.6 → 0.2.0

package/dist/exports/mexico/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @artu/compliance-sdk/mexico
+ *
+ * Mexico-scoped SDK entry point.
+ * Import from here for Mexico-specific compliance workflows.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   ComplianceSDK,
+ *   ActividadVulnerable,
+ *   Enums,
+ *   Validators,
+ *   Models,
+ *   Resources,
+ *   TypeGuards,
+ * } from "@artu/compliance-sdk/mexico";
+ *
+ * const sdk = new ComplianceSDK({
+ *   apiKey: process.env.COMPLIANCE_API_KEY!,
+ *   jurisdiction: "MX",
+ * });
+ *
+ * // Access Mexico-specific enums directly
+ * Enums.ActividadEconomica.Comercio
+ * Enums.DocumentType.INE
+ *
+ * // Validate Mexican identifiers
+ * Validators.Rfc.validate("GOAP820528H00")
+ *
+ * // Actividad Vulnerable namespace for AML compliance
+ * ActividadVulnerable.AVI.Enums.TipoOperacion.Buy
+ * ```
+ */
+import { MexicoComplianceSDKScoped, type MexicoScopedSDKOptions } from "../../sdk/mex";
+/** Options for Mexico-scoped SDK */
+export type ComplianceSDKOptions = MexicoScopedSDKOptions;
+/** Mexico-scoped ComplianceSDK - re-exported from sdk */
+export { MexicoComplianceSDKScoped as ComplianceSDK };
+export { Enums, Validators, Models, Resources, TypeGuards, type Types, } from "../../namespaces/mexico";
+export { ActividadVulnerable, AVI, JYS, TSC } from "../../namespaces/mexico";
+export type { MexJurisdictionData, MexPersonJurisdictionData, MexCompanyJurisdictionData, MexTrustJurisdictionData, ActividadVulnerableClientData, MexBankAccountData, MexDocument, CreateMexDocumentInput, UpdateMexDocumentInput, IneFrontFields, IneBackFields, CurpDocumentFields, RfcConstanciaFields, AddressProofFields, ActaConstitutivaFields, PoderNotarialFields, CreateMexIneFrontInput, CreateMexIneBackInput, CreateMexPassportInput, CreateMexCurpInput, CreateMexRfcConstanciaInput, CreateMexAddressProofInput, CreateMexActaConstitutivaInput, CreateMexPoderNotarialInput, UpdateMexIneFrontInput, UpdateMexIneBackInput, UpdateMexPassportInput, UpdateMexCurpInput, UpdateMexRfcConstanciaInput, UpdateMexAddressProofInput, UpdateMexActaConstitutivaInput, UpdateMexPoderNotarialInput, } from "../../namespaces/mexico";
+export { MexClient as Client, MexTransaction as Transaction, MexBankAccount as BankAccount, MexAddress as Address, MexReport as Report, MexReportItem as ReportItem, MexDocument as Document, MexIneFrontDocument as IneFrontDocument, MexIneBackDocument as IneBackDocument, MexPassportDocument as PassportDocument, MexCurpDocument as CurpDocument, MexRfcConstanciaDocument as RfcConstanciaDocument, MexAddressProofDocument as AddressProofDocument, MexActaConstitutivaDocument as ActaConstitutivaDocument, MexPoderNotarialDocument as PoderNotarialDocument, type MexClientData as ClientData, type MexTransactionData as TransactionData, type MexBankAccountData as BankAccountData, type MexAddressData as AddressData, type MexReportData as ReportData, type MexReportItemData as ReportItemData, } from "../../models";
+export { MexClientsResource as ClientsResource, MexTransactionsResource as TransactionsResource, MexBankAccountsResource as BankAccountsResource, MexReportsResource as ReportsResource, EBRResource, type EBRResourceContext, type EBRPresetsResource, type EBRWeightsResource, type EBRThresholdsResource, type EBRRiskLevelResource, type WeightPreset, type PresetConfidence, } from "../../resources";
+export { isMexClient as isClient, isMexTransaction as isTransaction, isMexBankAccount as isBankAccount, isMexAddress as isAddress, isMexReport as isReport, isMexReportItem as isReportItem, isMexDocument as isDocument, isMexIneFront as isIneFront, isMexIneBack as isIneBack, isMexPassport as isPassport, isMexCurp as isCurp, isMexRfcConstancia as isRfcConstancia, isMexAddressProof as isAddressProof, isMexActaConstitutiva as isActaConstitutiva, isMexPoderNotarial as isPoderNotarial, } from "../../models";
+export type { CreateMexClientInput as CreateClientInput, UpdateMexClientInput as UpdateClientInput, CreateMexTransactionInput as CreateTransactionInput, UpdateMexTransactionInput as UpdateTransactionInput, CreateMexReportInput as CreateReportInput, UpdateMexReportInput as UpdateReportInput, CreateMexReportItemInput as CreateReportItemInput, UpdateMexReportItemInput as UpdateReportItemInput, ReportValidationError, ValidationSummary, ValidationResult, GenerateResult, SubmissionResult, CreateMexBankAccountInput as CreateBankAccountInput, UpdateMexBankAccountInput as UpdateBankAccountInput, } from "@artu-ai/shared";
+export * from "../base";
+//# sourceMappingURL=index.d.ts.map

package/dist/exports/mexico/index.d.ts.map

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

package/dist/exports/mexico/index.js

@@ -0,0 +1,70 @@
+/**
+ * @artu/compliance-sdk/mexico
+ *
+ * Mexico-scoped SDK entry point.
+ * Import from here for Mexico-specific compliance workflows.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   ComplianceSDK,
+ *   ActividadVulnerable,
+ *   Enums,
+ *   Validators,
+ *   Models,
+ *   Resources,
+ *   TypeGuards,
+ * } from "@artu/compliance-sdk/mexico";
+ *
+ * const sdk = new ComplianceSDK({
+ *   apiKey: process.env.COMPLIANCE_API_KEY!,
+ *   jurisdiction: "MX",
+ * });
+ *
+ * // Access Mexico-specific enums directly
+ * Enums.ActividadEconomica.Comercio
+ * Enums.DocumentType.INE
+ *
+ * // Validate Mexican identifiers
+ * Validators.Rfc.validate("GOAP820528H00")
+ *
+ * // Actividad Vulnerable namespace for AML compliance
+ * ActividadVulnerable.AVI.Enums.TipoOperacion.Buy
+ * ```
+ */
+// ===========================
+// SDK
+// ===========================
+import { MexicoComplianceSDKScoped, } from "../../sdk/mex";
+/** Mexico-scoped ComplianceSDK - re-exported from sdk */
+export { MexicoComplianceSDKScoped as ComplianceSDK };
+// ===========================
+// Mexico Namespace Contents (flat exports)
+// ===========================
+export { Enums, Validators, Models, Resources, TypeGuards, } from "../../namespaces/mexico";
+// ===========================
+// Actividad Vulnerable Namespace
+// ===========================
+export { ActividadVulnerable, AVI, JYS, TSC } from "../../namespaces/mexico";
+// ===========================
+// Models (Mexico scoped) - direct exports
+// ===========================
+export { MexClient as Client, MexTransaction as Transaction, MexBankAccount as BankAccount, MexAddress as Address, MexReport as Report, MexReportItem as ReportItem, 
+// Document models
+MexDocument as Document, MexIneFrontDocument as IneFrontDocument, MexIneBackDocument as IneBackDocument, MexPassportDocument as PassportDocument, MexCurpDocument as CurpDocument, MexRfcConstanciaDocument as RfcConstanciaDocument, MexAddressProofDocument as AddressProofDocument, MexActaConstitutivaDocument as ActaConstitutivaDocument, MexPoderNotarialDocument as PoderNotarialDocument, } from "../../models";
+// ===========================
+// Resources (Mexico scoped) - direct exports
+// ===========================
+export { MexClientsResource as ClientsResource, MexTransactionsResource as TransactionsResource, MexBankAccountsResource as BankAccountsResource, MexReportsResource as ReportsResource, 
+// EBR (Evaluación Basada en Riesgos) resource
+EBRResource, } from "../../resources";
+// ===========================
+// TypeGuards (Mexico scoped) - direct exports
+// ===========================
+export { isMexClient as isClient, isMexTransaction as isTransaction, isMexBankAccount as isBankAccount, isMexAddress as isAddress, isMexReport as isReport, isMexReportItem as isReportItem, 
+// Document guards
+isMexDocument as isDocument, isMexIneFront as isIneFront, isMexIneBack as isIneBack, isMexPassport as isPassport, isMexCurp as isCurp, isMexRfcConstancia as isRfcConstancia, isMexAddressProof as isAddressProof, isMexActaConstitutiva as isActaConstitutiva, isMexPoderNotarial as isPoderNotarial, } from "../../models";
+// ===========================
+// Base Exports (errors, utilities, base models/resources)
+// ===========================
+export * from "../base";

package/dist/models/Address.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Address Model
+ *
+ * Physical or mailing address for a client.
+ */
+import { AddressType, type Address as AddressSchema, type CountryIso2 } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+/**
+ * Address data structure from the API
+ */
+export interface AddressData extends AddressSchema {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Address Model.
+ *
+ * Provides typed accessors for address data with formatting helpers.
+ *
+ * @example
+ * ```typescript
+ * const addresses = await sdk.addresses.listByClient("client_123");
+ * for (const addr of addresses) {
+ *   console.log(addr.formatted);
+ *   console.log(`Primary: ${addr.isPrimary}`);
+ * }
+ * ```
+ */
+export declare class Address extends BaseModel<AddressData> {
+    /**
+     * Unique address identifier
+     */
+    get id(): string;
+    /**
+     * ID of the client this address belongs to
+     */
+    get clientId(): string;
+    /**
+     * Address type (home, business, mailing, legal, other)
+     */
+    get type(): AddressType;
+    /**
+     * Whether this is the primary address
+     */
+    get isPrimary(): boolean;
+    /**
+     * Street address line
+     */
+    get street(): string;
+    /**
+     * City name
+     */
+    get city(): string;
+    /**
+     * State or province
+     */
+    get state(): string;
+    /**
+     * Postal/ZIP code
+     */
+    get postalCode(): string;
+    /**
+     * Country code (ISO 3166-1 alpha-2)
+     */
+    get country(): CountryIso2;
+    /**
+     * Jurisdiction-scoped data
+     * (e.g., Mexico: exteriorNumber, neighborhood)
+     */
+    get jurisdictions(): AddressSchema["jurisdictions"];
+    /**
+     * External ID
+     */
+    get externalId(): string | undefined;
+    /**
+     * Additional metadata
+     */
+    get metadata(): Record<string, unknown> | undefined;
+    /**
+     * When the address was created
+     */
+    get createdAt(): Date;
+    /**
+     * When the address was last updated
+     */
+    get updatedAt(): Date;
+    /**
+     * Whether this is a home address
+     */
+    get isHome(): boolean;
+    /**
+     * Whether this is a business address
+     */
+    get isBusiness(): boolean;
+    /**
+     * Whether this is a mailing address
+     */
+    get isMailing(): boolean;
+    /**
+     * Whether this is a legal address
+     */
+    get isLegal(): boolean;
+    /**
+     * Returns a formatted single-line address string
+     */
+    get formatted(): string;
+    /**
+     * Returns a formatted multi-line address string
+     */
+    get formattedMultiLine(): string;
+    toString(): string;
+}
+/**
+ * Check if value is any type of Address model
+ */
+export declare function isAddress(value: unknown): value is Address;
+//# sourceMappingURL=Address.d.ts.map

package/dist/models/Address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Address.d.ts","sourceRoot":"","sources":["../../src/models/Address.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,KAAK,OAAO,IAAI,aAAa,EAC7B,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAQ,SAAQ,SAAS,CAAC,WAAW,CAAC;IAKjD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAMD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,CAEzB;IAMD;;;OAGG;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC,CAElD;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAOtB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAO/B;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/models/Address.js

@@ -0,0 +1,187 @@
+/**
+ * Address Model
+ *
+ * Physical or mailing address for a client.
+ */
+import { AddressType, } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+// ===========================
+// Address Model
+// ===========================
+/**
+ * Address Model.
+ *
+ * Provides typed accessors for address data with formatting helpers.
+ *
+ * @example
+ * ```typescript
+ * const addresses = await sdk.addresses.listByClient("client_123");
+ * for (const addr of addresses) {
+ *   console.log(addr.formatted);
+ *   console.log(`Primary: ${addr.isPrimary}`);
+ * }
+ * ```
+ */
+export class Address extends BaseModel {
+    // ─────────────────────────────────────────────────────────────────
+    // Core Properties
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Unique address identifier
+     */
+    get id() {
+        return this._data.id;
+    }
+    /**
+     * ID of the client this address belongs to
+     */
+    get clientId() {
+        return this._data.clientId;
+    }
+    /**
+     * Address type (home, business, mailing, legal, other)
+     */
+    get type() {
+        return this._data.type;
+    }
+    /**
+     * Whether this is the primary address
+     */
+    get isPrimary() {
+        return this._data.isPrimary ?? false;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Address Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Street address line
+     */
+    get street() {
+        return this._data.street;
+    }
+    /**
+     * City name
+     */
+    get city() {
+        return this._data.city;
+    }
+    /**
+     * State or province
+     */
+    get state() {
+        return this._data.state;
+    }
+    /**
+     * Postal/ZIP code
+     */
+    get postalCode() {
+        return this._data.postalCode;
+    }
+    /**
+     * Country code (ISO 3166-1 alpha-2)
+     */
+    get country() {
+        return this._data.country;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Jurisdictions & Metadata
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Jurisdiction-scoped data
+     * (e.g., Mexico: exteriorNumber, neighborhood)
+     */
+    get jurisdictions() {
+        return this._data.jurisdictions;
+    }
+    /**
+     * External ID
+     */
+    get externalId() {
+        return this._data.externalId;
+    }
+    /**
+     * Additional metadata
+     */
+    get metadata() {
+        return this._data.metadata;
+    }
+    /**
+     * When the address was created
+     */
+    get createdAt() {
+        return new Date(this._data.createdAt);
+    }
+    /**
+     * When the address was last updated
+     */
+    get updatedAt() {
+        return new Date(this._data.updatedAt);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Type Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Whether this is a home address
+     */
+    get isHome() {
+        return this.type === AddressType.Home;
+    }
+    /**
+     * Whether this is a business address
+     */
+    get isBusiness() {
+        return this.type === AddressType.Business;
+    }
+    /**
+     * Whether this is a mailing address
+     */
+    get isMailing() {
+        return this.type === AddressType.Mailing;
+    }
+    /**
+     * Whether this is a legal address
+     */
+    get isLegal() {
+        return this.type === AddressType.Legal;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Formatting
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Returns a formatted single-line address string
+     */
+    get formatted() {
+        const parts = [
+            this.street,
+            `${this.city}, ${this.state} ${this.postalCode}`,
+            this.country,
+        ].filter(Boolean);
+        return parts.join(", ");
+    }
+    /**
+     * Returns a formatted multi-line address string
+     */
+    get formattedMultiLine() {
+        const lines = [
+            this.street,
+            `${this.city}, ${this.state} ${this.postalCode}`,
+            this.country,
+        ].filter(Boolean);
+        return lines.join("\n");
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `Address(${this.id}, ${this.type}, ${this.city})`;
+    }
+}
+// ===========================
+// Type Guards
+// ===========================
+/**
+ * Check if value is any type of Address model
+ */
+export function isAddress(value) {
+    return value instanceof Address;
+}

package/dist/models/BankAccount.d.ts

@@ -0,0 +1,124 @@
+/**
+ * BankAccount Model
+ *
+ * Bank account information for a client.
+ * Uses discriminated union based on `country` field.
+ */
+import { BankAccountType, type BankAccount as BankAccountSchema, type CurrencyCode } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+/**
+ * Bank account data structure from the API (discriminated union)
+ */
+export type BankAccountData = BankAccountSchema;
+/**
+ * BankAccount Model.
+ *
+ * Base class for bank account data. The concrete type depends on
+ * the `country` field:
+ * - `country === "MX"` → MexBankAccount with clabe, codigoBanco, codigoPlaza
+ * - Other countries → GenericBankAccount
+ *
+ * @example
+ * ```typescript
+ * const account = await sdk.bankAccounts.retrieve(id);
+ *
+ * // Check country for type narrowing
+ * if (account.country === "MX") {
+ *   console.log(account.clabe); // MexBankAccount
+ * }
+ * ```
+ */
+export declare class BankAccount extends BaseModel<BankAccountData> {
+    /**
+     * Unique bank account identifier
+     */
+    get id(): string;
+    /**
+     * ID of the client this bank account belongs to
+     */
+    get clientId(): string;
+    /**
+     * Account number
+     */
+    get accountNumber(): string;
+    /**
+     * Bank name
+     */
+    get bankName(): string;
+    /**
+     * Bank code (e.g., SWIFT, routing number)
+     */
+    get bankCode(): string | undefined;
+    /**
+     * Country where the bank account is held (ISO 3166-1 alpha-2)
+     *
+     * This is the discriminator field - determines which fields are available.
+     */
+    get country(): string;
+    /**
+     * Account type (checking, savings, investment, other)
+     */
+    get type(): BankAccountType;
+    /**
+     * Account currency (ISO 4217 code)
+     */
+    get currency(): CurrencyCode;
+    /**
+     * Whether this is the primary bank account
+     */
+    get isPrimary(): boolean;
+    /**
+     * Whether this account is active
+     */
+    get isActive(): boolean;
+    /**
+     * Optional label (e.g., "Personal Checking")
+     */
+    get label(): string | undefined;
+    /**
+     * External ID
+     */
+    get externalId(): string | undefined;
+    /**
+     * Additional metadata
+     */
+    get metadata(): Record<string, unknown> | undefined;
+    /**
+     * When the bank account was created
+     */
+    get createdAt(): Date;
+    /**
+     * When the bank account was last updated
+     */
+    get updatedAt(): Date;
+    /**
+     * Whether this is a checking account
+     */
+    get isChecking(): boolean;
+    /**
+     * Whether this is a savings account
+     */
+    get isSavings(): boolean;
+    /**
+     * Whether this is an investment account
+     */
+    get isInvestment(): boolean;
+    /**
+     * Whether this is a Mexican bank account
+     */
+    get isMexican(): boolean;
+    /**
+     * Returns a masked account number (shows last 4 digits)
+     */
+    get maskedAccountNumber(): string;
+    /**
+     * Returns a display string with bank name and masked account
+     */
+    get display(): string;
+    toString(): string;
+}
+/**
+ * Check if value is any type of BankAccount model
+ */
+export declare function isBankAccount(value: unknown): value is BankAccount;
+//# sourceMappingURL=BankAccount.d.ts.map

package/dist/models/BankAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BankAccount.d.ts","sourceRoot":"","sources":["../../src/models/BankAccount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,WAAW,IAAI,iBAAiB,EACrC,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAMhD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,eAAe,CAAC;IAKzD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;;;OAIG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAMD;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAGhC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAMQ,QAAQ,IAAI,MAAM;CAG5B;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}