@cheqi/sdk 0.1.1

package/dist/http/client.js

@@ -0,0 +1,199 @@
+import { CheqiApiError, ErrorCodes } from "../errors.js";
+import { NoopLogger } from "../logger.js";
+import { normalizeValue, serializeJson } from "../utils.js";
+import { Endpoints } from "./endpoints.js";
+import { RetryHandler } from "./retry.js";
+// read version at module load; falls back gracefully
+const SDK_VERSION = (() => {
+    try {
+        // Dynamic import not needed — we just embed the constant at build time.
+        return "0.1.0";
+    }
+    catch {
+        return "unknown";
+    }
+})();
+function mapErrorCode(status) {
+    if (status === 401)
+        return ErrorCodes.AUTHENTICATION_FAILED;
+    if (status === 403)
+        return ErrorCodes.AUTHORIZATION_FAILED;
+    if (status === 404)
+        return ErrorCodes.RECEIPT_NOT_FOUND;
+    if (status === 429)
+        return ErrorCodes.RATE_LIMITED;
+    if (status >= 500)
+        return ErrorCodes.SERVER_ERROR;
+    return ErrorCodes.UNKNOWN_ERROR;
+}
+/**
+ * Default HTTP implementation of {@link CheqiApiClient}.
+ *
+ * Uses the global `fetch` (or an injected implementation) with automatic
+ * retry, bearer-token auth, and structured logging.
+ */
+export class DefaultCheqiApiClient {
+    config;
+    fetchImpl;
+    retryHandler;
+    userAgent;
+    logger;
+    constructor(config, fetchImpl = globalThis.fetch) {
+        this.config = config;
+        this.fetchImpl = fetchImpl;
+        if (!config) {
+            throw new Error("CheqiSDKConfig is required");
+        }
+        this.logger = config.logger ?? new NoopLogger();
+        this.retryHandler = new RetryHandler({ maxRetries: config.maxRetries, logger: this.logger });
+        this.userAgent = `CheqiSDK-TypeScript/${SDK_VERSION}`;
+    }
+    async generateReceiptTemplate(request, accessToken) {
+        return this.request("POST", Endpoints.TEMPLATE_ENDPOINT, {
+            body: normalizeValue(request),
+            accessToken,
+            operation: "generateReceiptTemplate"
+        });
+    }
+    async generateCreditNoteTemplate(request, accessToken) {
+        return this.request("POST", Endpoints.CREDIT_NOTE_TEMPLATE_ENDPOINT, {
+            body: normalizeValue(request),
+            accessToken,
+            operation: "generateCreditNoteTemplate"
+        });
+    }
+    async matchCustomer(request, accessToken) {
+        return this.request("POST", Endpoints.CUSTOMER_MATCH_ENDPOINT, {
+            body: normalizeValue(request),
+            accessToken,
+            operation: "matchCustomer"
+        });
+    }
+    async sendEncryptedReceipts(matchId, encryptedReceipts, templateHash, accessToken) {
+        return this.request("POST", Endpoints.ENCRYPTED_RECEIPT_ENDPOINT, {
+            body: {
+                matchId,
+                encryptedReceiptRequests: encryptedReceipts.map((receipt) => normalizeValue(receipt)),
+                templateHash
+            },
+            accessToken,
+            operation: "sendEncryptedReceipts"
+        });
+    }
+    async sendEncryptedCreditNotes(matchId, parentCheqiReceiptId, encryptedCreditNotes, templateHash, accessToken) {
+        return this.request("POST", Endpoints.ENCRYPTED_CREDIT_NOTE_ENDPOINT, {
+            body: {
+                matchId,
+                parentCheqiReceiptId,
+                encryptedCreditNotes: encryptedCreditNotes.map((creditNote) => normalizeValue(creditNote)),
+                templateHash
+            },
+            accessToken,
+            operation: "sendEncryptedCreditNotes"
+        });
+    }
+    async sendReceiptViaEmail(customerEmail, receipt, accessToken) {
+        await this.request("POST", Endpoints.EMAIL_RECEIPT_ENDPOINT, {
+            body: {
+                customerEmail,
+                cheqiReceipt: typeof receipt === "string" ? JSON.parse(receipt) : receipt
+            },
+            accessToken,
+            operation: "sendReceiptViaEmail"
+        });
+    }
+    async provisionCompany(request) {
+        return this.request("POST", Endpoints.COMPANY_PROVISION_ENDPOINT, {
+            body: normalizeValue(request),
+            operation: "provisionCompany"
+        });
+    }
+    async createStore(companyId, request, accessToken) {
+        return this.request("POST", Endpoints.COMPANY_STORES_ENDPOINT(companyId), {
+            body: normalizeValue(request),
+            accessToken,
+            operation: "createStore"
+        });
+    }
+    async getStores(companyId, activeOnly, accessToken) {
+        return this.request("GET", Endpoints.COMPANY_STORES_ENDPOINT(companyId), {
+            params: { activeOnly },
+            accessToken,
+            operation: "getStores"
+        });
+    }
+    async getStore(companyId, storeId, accessToken) {
+        return this.request("GET", Endpoints.COMPANY_STORE_ENDPOINT(companyId, storeId), {
+            accessToken,
+            operation: "getStore"
+        });
+    }
+    async updateStore(companyId, storeId, request, accessToken) {
+        return this.request("PUT", Endpoints.COMPANY_STORE_ENDPOINT(companyId, storeId), {
+            body: normalizeValue(request),
+            accessToken,
+            operation: "updateStore"
+        });
+    }
+    async deleteStore(companyId, storeId, accessToken) {
+        await this.request("DELETE", Endpoints.COMPANY_STORE_ENDPOINT(companyId, storeId), { accessToken, operation: "deleteStore" });
+    }
+    async activateStore(companyId, storeId, accessToken) {
+        await this.request("POST", Endpoints.COMPANY_STORE_ACTIVATE_ENDPOINT(companyId, storeId), { body: {}, accessToken, operation: "activateStore" });
+    }
+    async deactivateStore(companyId, storeId, accessToken) {
+        await this.request("POST", Endpoints.COMPANY_STORE_DEACTIVATE_ENDPOINT(companyId, storeId), { body: {}, accessToken, operation: "deactivateStore" });
+    }
+    // ---------- internals ----------
+    authHeaders(accessToken) {
+        const token = accessToken ?? this.config.apiKey;
+        if (!token) {
+            throw new CheqiApiError("No authentication token available", {
+                errorCode: ErrorCodes.AUTHENTICATION_FAILED,
+                httpStatusCode: 401
+            });
+        }
+        return {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            "User-Agent": this.userAgent
+        };
+    }
+    async request(method, path, { body, params, accessToken, operation }) {
+        const url = new URL(path, this.config.apiEndpoint);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        this.logger.debug(`${operation} ${method} ${url.pathname}`);
+        const response = await this.retryHandler.executeWithRetry(() => this.fetchImpl(url, {
+            method,
+            headers: this.authHeaders(accessToken),
+            body: body === undefined ? undefined : typeof body === "string" ? body : serializeJson(body),
+            signal: AbortSignal.timeout(this.config.timeoutSeconds * 1000)
+        }), operation);
+        if (response.status >= 400) {
+            const responseText = await response.text();
+            const correlationId = response.headers.get("x-correlation-id");
+            this.logger.error(`${operation} failed: status=${response.status}, correlationId=${correlationId ?? "none"}, body=${responseText.slice(0, 500)}`);
+            throw new CheqiApiError(`${operation} failed with status ${response.status}: ${responseText}`, {
+                errorCode: mapErrorCode(response.status),
+                httpStatusCode: response.status,
+                correlationId
+            });
+        }
+        this.logger.debug(`${operation} completed: status=${response.status}`);
+        if (response.status === 204) {
+            return undefined;
+        }
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/http/client.js.map

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

package/dist/http/endpoints.d.ts

@@ -0,0 +1,13 @@
+export declare const Endpoints: {
+    readonly TEMPLATE_ENDPOINT: "/receipt/template";
+    readonly CUSTOMER_MATCH_ENDPOINT: "/recipient/resolve";
+    readonly ENCRYPTED_RECEIPT_ENDPOINT: "/receipt/encrypted";
+    readonly ENCRYPTED_CREDIT_NOTE_ENDPOINT: "/credit-note/encrypted";
+    readonly CREDIT_NOTE_TEMPLATE_ENDPOINT: "/credit-note/template";
+    readonly EMAIL_RECEIPT_ENDPOINT: "/receipt/email";
+    readonly COMPANY_PROVISION_ENDPOINT: "/company/provision";
+    readonly COMPANY_STORES_ENDPOINT: (companyId: string) => string;
+    readonly COMPANY_STORE_ENDPOINT: (companyId: string, storeId: string) => string;
+    readonly COMPANY_STORE_ACTIVATE_ENDPOINT: (companyId: string, storeId: string) => string;
+    readonly COMPANY_STORE_DEACTIVATE_ENDPOINT: (companyId: string, storeId: string) => string;
+};

package/dist/http/endpoints.js

@@ -0,0 +1,14 @@
+export const Endpoints = {
+    TEMPLATE_ENDPOINT: "/receipt/template",
+    CUSTOMER_MATCH_ENDPOINT: "/recipient/resolve",
+    ENCRYPTED_RECEIPT_ENDPOINT: "/receipt/encrypted",
+    ENCRYPTED_CREDIT_NOTE_ENDPOINT: "/credit-note/encrypted",
+    CREDIT_NOTE_TEMPLATE_ENDPOINT: "/credit-note/template",
+    EMAIL_RECEIPT_ENDPOINT: "/receipt/email",
+    COMPANY_PROVISION_ENDPOINT: "/company/provision",
+    COMPANY_STORES_ENDPOINT: (companyId) => `/company/${companyId}/stores`,
+    COMPANY_STORE_ENDPOINT: (companyId, storeId) => `/company/${companyId}/stores/${storeId}`,
+    COMPANY_STORE_ACTIVATE_ENDPOINT: (companyId, storeId) => `/company/${companyId}/stores/${storeId}/activate`,
+    COMPANY_STORE_DEACTIVATE_ENDPOINT: (companyId, storeId) => `/company/${companyId}/stores/${storeId}/deactivate`
+};
+//# sourceMappingURL=endpoints.js.map

package/dist/http/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/http/endpoints.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB,EAAE,mBAAmB;IACtC,uBAAuB,EAAE,oBAAoB;IAC7C,0BAA0B,EAAE,oBAAoB;IAChD,8BAA8B,EAAE,wBAAwB;IACxD,6BAA6B,EAAE,uBAAuB;IACtD,sBAAsB,EAAE,gBAAgB;IACxC,0BAA0B,EAAE,oBAAoB;IAChD,uBAAuB,EAAE,CAAC,SAAiB,EAAU,EAAE,CAAC,YAAY,SAAS,SAAS;IACtF,sBAAsB,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAU,EAAE,CAAC,YAAY,SAAS,WAAW,OAAO,EAAE;IACjH,+BAA+B,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAU,EAAE,CAAC,YAAY,SAAS,WAAW,OAAO,WAAW;IACnI,iCAAiC,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAU,EAAE,CAAC,YAAY,SAAS,WAAW,OAAO,aAAa;CAC/H,CAAC"}

package/dist/http/retry.d.ts

@@ -0,0 +1,30 @@
+import type { Logger } from "../logger.js";
+/** Options for configuring the retry handler. */
+export interface RetryOptions {
+    /** Maximum number of retries (default 3). */
+    maxRetries?: number;
+    /** Base delay in ms for non-429 retries (default 1000). */
+    baseDelayMs?: number;
+    /** Base delay in ms for 429 rate-limit retries (default 5000). */
+    rateLimitDelayMs?: number;
+    /** Maximum backoff delay in ms (default 30 000). */
+    maxBackoffMs?: number;
+    /** Logger instance. */
+    logger?: Logger;
+}
+/**
+ * Executes an HTTP operation with exponential back-off and jitter.
+ *
+ * Retries on network errors and on responses whose status code is in
+ * {@link DEFAULT_RETRYABLE_STATUS_CODES}.
+ */
+export declare class RetryHandler {
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly rateLimitDelayMs;
+    private readonly maxBackoffMs;
+    private readonly logger;
+    constructor(opts?: RetryOptions | number);
+    executeWithRetry(operation: () => Promise<Response>, operationName: string): Promise<Response>;
+    private calculateBackoff;
+}

package/dist/http/retry.js

@@ -0,0 +1,74 @@
+import { CheqiApiError, ErrorCodes } from "../errors.js";
+import { NoopLogger } from "../logger.js";
+import { sleep } from "../utils.js";
+/** Default status codes that trigger a retry. */
+const DEFAULT_RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
+/**
+ * Executes an HTTP operation with exponential back-off and jitter.
+ *
+ * Retries on network errors and on responses whose status code is in
+ * {@link DEFAULT_RETRYABLE_STATUS_CODES}.
+ */
+export class RetryHandler {
+    maxRetries;
+    baseDelayMs;
+    rateLimitDelayMs;
+    maxBackoffMs;
+    logger;
+    constructor(opts = {}) {
+        // backwards-compat: accept bare number for maxRetries
+        const options = typeof opts === "number" ? { maxRetries: opts } : opts;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.baseDelayMs = options.baseDelayMs ?? 1000;
+        this.rateLimitDelayMs = options.rateLimitDelayMs ?? 5000;
+        this.maxBackoffMs = options.maxBackoffMs ?? 30_000;
+        this.logger = options.logger ?? new NoopLogger();
+    }
+    async executeWithRetry(operation, operationName) {
+        let attempt = 0;
+        let lastError = null;
+        while (attempt <= this.maxRetries) {
+            try {
+                const response = await operation();
+                if (DEFAULT_RETRYABLE_STATUS_CODES.has(response.status) && attempt < this.maxRetries) {
+                    const delay = this.calculateBackoff(attempt, response.status, response.headers.get("Retry-After"));
+                    this.logger.warn(`${operationName} returned ${response.status}, retrying in ${delay}ms (attempt ${attempt + 1}/${this.maxRetries})`);
+                    await sleep(delay);
+                    attempt += 1;
+                    continue;
+                }
+                if (attempt > 0) {
+                    this.logger.info(`${operationName} succeeded after ${attempt + 1} attempts`);
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= this.maxRetries) {
+                    break;
+                }
+                const delay = this.calculateBackoff(attempt, 0, null);
+                this.logger.warn(`${operationName} network error: ${error.message}, retrying in ${delay}ms (attempt ${attempt + 1}/${this.maxRetries})`);
+                await sleep(delay);
+                attempt += 1;
+            }
+        }
+        this.logger.error(`${operationName} failed after ${attempt + 1} attempts`);
+        throw new CheqiApiError(`Network error: ${String(lastError?.message ?? operationName)}`, {
+            errorCode: ErrorCodes.NETWORK_ERROR,
+            cause: lastError
+        });
+    }
+    calculateBackoff(attempt, statusCode, retryAfter) {
+        if (retryAfter) {
+            const parsed = Number(retryAfter);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return Math.min(parsed * 1000, this.maxBackoffMs);
+            }
+        }
+        const baseDelay = statusCode === 429 ? this.rateLimitDelayMs : this.baseDelayMs;
+        const jitter = 0.75 + Math.random() * 0.5;
+        return Math.min(Math.trunc(baseDelay * (2 ** attempt) * jitter), this.maxBackoffMs);
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/http/retry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { CheqiSDK, CheqiSDKBuilder } from "./cheqi-sdk.js";
+export { Environment, CheqiSDKConfig } from "./config.js";
+export * from "./errors.js";
+export type { Logger } from "./logger.js";
+export { ConsoleLogger, NoopLogger } from "./logger.js";
+export * from "./models/index.js";
+export { DefaultCheqiApiClient } from "./http/client.js";
+export { Endpoints } from "./http/endpoints.js";
+export { RetryHandler } from "./http/retry.js";
+export type { RetryOptions } from "./http/retry.js";
+export { EncryptionService } from "./services/encryption.js";
+export { DecryptionService } from "./services/decryption.js";
+export { MatchingService } from "./services/matching.js";
+export { ReceiptService } from "./services/receipt.js";
+export { CreditNoteService } from "./services/credit-note.js";
+export { VerificationService } from "./services/verification.js";
+export { CompanyService } from "./services/company.js";
+export { StoreService } from "./services/store.js";
+export { canonicalizeJson } from "./rfc8785.js";
+export { canonicalizeXml } from "./xml.js";
+export type { CheqiApiClient, CheqiSDKOptions, CreditNoteEnvelope, DecryptedDeliveredCreditNote, EncryptedReceipt, FetchLike, JsonObject, JsonPrimitive, JsonValue, Nullable, RequestOptions } from "./types.js";

package/dist/index.js

@@ -0,0 +1,19 @@
+export { CheqiSDK, CheqiSDKBuilder } from "./cheqi-sdk.js";
+export { Environment, CheqiSDKConfig } from "./config.js";
+export * from "./errors.js";
+export { ConsoleLogger, NoopLogger } from "./logger.js";
+export * from "./models/index.js";
+export { DefaultCheqiApiClient } from "./http/client.js";
+export { Endpoints } from "./http/endpoints.js";
+export { RetryHandler } from "./http/retry.js";
+export { EncryptionService } from "./services/encryption.js";
+export { DecryptionService } from "./services/decryption.js";
+export { MatchingService } from "./services/matching.js";
+export { ReceiptService } from "./services/receipt.js";
+export { CreditNoteService } from "./services/credit-note.js";
+export { VerificationService } from "./services/verification.js";
+export { CompanyService } from "./services/company.js";
+export { StoreService } from "./services/store.js";
+export { canonicalizeJson } from "./rfc8785.js";
+export { canonicalizeXml } from "./xml.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Logger interface for the Cheqi SDK. Compatible with console, pino, winston, bunyan, etc.
+ * Supply your own implementation via {@link CheqiSDKBuilder.logger} or use the built-in
+ * {@link ConsoleLogger} (default) / {@link NoopLogger}.
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Default logger that writes to the console. Used when no custom logger is supplied.
+ */
+export declare class ConsoleLogger implements Logger {
+    private readonly prefix;
+    constructor(prefix?: string);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Silent logger that discards all messages. Useful for tests or when logging is unwanted.
+ */
+export declare class NoopLogger implements Logger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}

package/dist/logger.js

@@ -0,0 +1,31 @@
+/**
+ * Default logger that writes to the console. Used when no custom logger is supplied.
+ */
+export class ConsoleLogger {
+    prefix;
+    constructor(prefix = "CheqiSDK") {
+        this.prefix = prefix;
+    }
+    debug(message, ...args) {
+        console.debug(`[${this.prefix}] ${message}`, ...args);
+    }
+    info(message, ...args) {
+        console.info(`[${this.prefix}] ${message}`, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(`[${this.prefix}] ${message}`, ...args);
+    }
+    error(message, ...args) {
+        console.error(`[${this.prefix}] ${message}`, ...args);
+    }
+}
+/**
+ * Silent logger that discards all messages. Useful for tests or when logging is unwanted.
+ */
+export class NoopLogger {
+    debug() { }
+    info() { }
+    warn() { }
+    error() { }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,SAAiB,UAAU;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IAE5D,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAU;IACrB,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACjB"}