@ketrics/sdk-backend 0.2.0 → 0.4.0

package/dist/job-errors.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Ketrics SDK - Job Error Classes
+ *
+ * Provides typed errors for background job operations in tenant applications.
+ *
+ * Error Hierarchy:
+ * - JobError (base)
+ *   - JobNotFoundError
+ *   - InvalidFunctionError
+ *   - CrossAppPermissionError
+ *   - JobExecutionError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobExecutionError = exports.CrossAppPermissionError = exports.InvalidFunctionError = exports.JobNotFoundError = exports.JobError = void 0;
+exports.isJobError = isJobError;
+exports.isJobErrorType = isJobErrorType;
+// ============================================================================
+// Base Error Class
+// ============================================================================
+/**
+ * Base error class for all Job errors
+ *
+ * All Job errors extend this class and include:
+ * - jobId: The job ID that caused the error (if applicable)
+ * - operation: The operation that failed
+ * - timestamp: When the error occurred
+ */
+class JobError extends Error {
+    constructor(message, operation, jobId) {
+        super(message);
+        this.name = this.constructor.name;
+        this.operation = operation;
+        this.jobId = jobId;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serialize error for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            jobId: this.jobId,
+            operation: this.operation,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+exports.JobError = JobError;
+// ============================================================================
+// Specific Error Classes
+// ============================================================================
+/**
+ * Error thrown when a job is not found
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const status = await ketrics.Job.getStatus('invalid-job-id');
+ * } catch (error) {
+ *   if (error instanceof ketrics.JobNotFoundError) {
+ *     console.log(`Job '${error.jobId}' not found`);
+ *   }
+ * }
+ * ```
+ */
+class JobNotFoundError extends JobError {
+    constructor(jobId) {
+        super(`Job '${jobId}' not found. Verify the job ID is correct and the job exists.`, 'getStatus', jobId);
+    }
+}
+exports.JobNotFoundError = JobNotFoundError;
+/**
+ * Error thrown when function name is invalid or missing
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: '' });
+ * } catch (error) {
+ *   if (error instanceof ketrics.InvalidFunctionError) {
+ *     console.log(`Invalid function: ${error.functionName}`);
+ *   }
+ * }
+ * ```
+ */
+class InvalidFunctionError extends JobError {
+    constructor(functionName) {
+        super(`Invalid function name '${functionName}'. Function name must be a non-empty string.`, 'runInBackground');
+        this.functionName = functionName;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            functionName: this.functionName,
+        };
+    }
+}
+exports.InvalidFunctionError = InvalidFunctionError;
+/**
+ * Error thrown when cross-app job lacks required permission
+ *
+ * This error occurs when attempting to create a job in another application
+ * without a valid application grant that includes background job permission.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({
+ *     application: 'other-app',
+ *     function: 'processData',
+ *   });
+ * } catch (error) {
+ *   if (error instanceof ketrics.CrossAppPermissionError) {
+ *     console.log(`Cannot create job from '${error.sourceApp}' to '${error.targetApp}'`);
+ *   }
+ * }
+ * ```
+ */
+class CrossAppPermissionError extends JobError {
+    constructor(sourceApp, targetApp) {
+        super(`Cross-app job permission denied. Application '${sourceApp}' does not have background job permission for '${targetApp}'.`, 'runInBackground');
+        this.sourceApp = sourceApp;
+        this.targetApp = targetApp;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            sourceApp: this.sourceApp,
+            targetApp: this.targetApp,
+        };
+    }
+}
+exports.CrossAppPermissionError = CrossAppPermissionError;
+/**
+ * Error thrown when job execution fails
+ *
+ * This error wraps runtime errors that occur during job execution.
+ *
+ * @example
+ * ```typescript
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'failed' && status.error) {
+ *   console.log(`Job failed with code ${status.error.code}: ${status.error.message}`);
+ * }
+ * ```
+ */
+class JobExecutionError extends JobError {
+    constructor(jobId, errorCode, message) {
+        super(`Job '${jobId}' execution failed: ${message}`, 'execute', jobId);
+        this.errorCode = errorCode;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            errorCode: this.errorCode,
+        };
+    }
+}
+exports.JobExecutionError = JobExecutionError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a JobError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a JobError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: 'myFunc' });
+ * } catch (error) {
+ *   if (isJobError(error)) {
+ *     console.log(`Job error during ${error.operation}: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+function isJobError(error) {
+    return error instanceof JobError;
+}
+/**
+ * Type guard to check if an error is a specific JobError type
+ *
+ * @param error - The error to check
+ * @param errorClass - The error class to check against
+ * @returns True if the error is an instance of the specified class
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.getStatus('invalid-id');
+ * } catch (error) {
+ *   if (isJobErrorType(error, JobNotFoundError)) {
+ *     console.log('Job not found');
+ *   } else if (isJobErrorType(error, CrossAppPermissionError)) {
+ *     console.log('Permission denied');
+ *   }
+ * }
+ * ```
+ */
+function isJobErrorType(error, errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=job-errors.js.map

package/dist/job-errors.js.map

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

package/dist/job.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Ketrics SDK - Job Interfaces and Types
+ *
+ * Provides type definitions for background job execution
+ * in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Queue a background job
+ * const jobId = await ketrics.Job.runInBackground({
+ *   function: 'generateReport',
+ *   payload: { year: 2024 },
+ *   options: { timeout: 600000 }
+ * });
+ *
+ * // Check job status
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'completed') {
+ *   console.log('Job completed at:', status.completedAt);
+ * }
+ *
+ * // List pending jobs
+ * const result = await ketrics.Job.list({ status: 'pending', limit: 10 });
+ * for (const job of result.jobs) {
+ *   console.log(job.jobId, job.functionName);
+ * }
+ * ```
+ */
+/**
+ * Job status string literal type
+ */
+export type JobStatusValue = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * Options for background job execution
+ */
+export interface RunInBackgroundOptions {
+    /**
+     * Execution timeout in milliseconds
+     *
+     * @default 300000 (5 minutes)
+     * @max 900000 (15 minutes)
+     */
+    timeout?: number;
+    /**
+     * Idempotency key to prevent duplicate job creation
+     *
+     * If a job with the same idempotency key already exists,
+     * the existing job ID will be returned instead of creating a new job.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * Parameters for Job.runInBackground()
+ */
+export interface RunInBackgroundParams {
+    /**
+     * Target application code (optional)
+     *
+     * If specified, creates a cross-app job that executes in another application.
+     * Requires a valid application grant with background job permission.
+     * If omitted, the job executes in the current application.
+     */
+    application?: string;
+    /**
+     * Function name to execute
+     *
+     * Must be an exported function in the target application.
+     */
+    function: string;
+    /**
+     * Payload to pass to the function
+     *
+     * This object will be passed as the first argument to the function.
+     */
+    payload?: Record<string, unknown>;
+    /**
+     * Execution options
+     */
+    options?: RunInBackgroundOptions;
+}
+/**
+ * Job error details
+ */
+export interface JobErrorDetails {
+    /**
+     * Error code
+     *
+     * Common codes:
+     * - 'TIMEOUT': Job exceeded execution timeout
+     * - 'RUNTIME_ERROR': Unhandled exception in function
+     * - 'FUNCTION_NOT_FOUND': Target function does not exist
+     */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Job status returned from getStatus() and list()
+ */
+export interface JobStatus {
+    /** Job UUID */
+    jobId: string;
+    /** Application UUID where the job runs */
+    applicationId: string;
+    /** Application code where the job runs */
+    applicationCode: string;
+    /** Function name being executed */
+    functionName: string;
+    /** Current job status */
+    status: JobStatusValue;
+    /** ISO timestamp when the job was created */
+    createdAt: string;
+    /** ISO timestamp when the job started execution (optional) */
+    startedAt?: string;
+    /** ISO timestamp when the job completed (optional) */
+    completedAt?: string;
+    /** Error details if the job failed (optional) */
+    error?: JobErrorDetails;
+}
+/**
+ * Parameters for Job.list()
+ */
+export interface JobListParams {
+    /**
+     * Filter by job status
+     *
+     * If omitted, returns jobs of all statuses.
+     */
+    status?: JobStatusValue;
+    /**
+     * Maximum number of results to return
+     *
+     * @default 20
+     * @max 100
+     */
+    limit?: number;
+    /**
+     * Pagination cursor from previous response
+     *
+     * Pass the `cursor` from a previous JobListResult to fetch the next page.
+     */
+    cursor?: string;
+}
+/**
+ * Result from Job.list()
+ */
+export interface JobListResult {
+    /** Array of job status objects */
+    jobs: JobStatus[];
+    /**
+     * Pagination cursor for fetching the next page
+     *
+     * If present, more results are available. Pass this value as
+     * the `cursor` parameter in the next call to get the next page.
+     */
+    cursor?: string;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,MAAM,EAAE,cAAc,CAAC;IAEvB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,SAAS,EAAE,CAAC;IAElB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/job.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Ketrics SDK - Job Interfaces and Types
+ *
+ * Provides type definitions for background job execution
+ * in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Queue a background job
+ * const jobId = await ketrics.Job.runInBackground({
+ *   function: 'generateReport',
+ *   payload: { year: 2024 },
+ *   options: { timeout: 600000 }
+ * });
+ *
+ * // Check job status
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'completed') {
+ *   console.log('Job completed at:', status.completedAt);
+ * }
+ *
+ * // List pending jobs
+ * const result = await ketrics.Job.list({ status: 'pending', limit: 10 });
+ * for (const job of result.jobs) {
+ *   console.log(job.jobId, job.functionName);
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/pdf-errors.d.ts

@@ -0,0 +1,77 @@
+/**
+ * PDF SDK Error Classes
+ *
+ * Error types for PDF operations in tenant applications.
+ */
+/**
+ * Base error for all PDF operations
+ *
+ * All PDF-related errors inherit from this class, providing
+ * consistent context and structure for error handling.
+ */
+export declare abstract class PdfError extends Error {
+    /** Operation that caused the error */
+    readonly operation: string;
+    /** Timestamp when the error occurred */
+    readonly timestamp: Date;
+    constructor(operation: string, message: string);
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error parsing PDF file
+ *
+ * Thrown when a PDF file cannot be parsed due to invalid format,
+ * corrupted data, or unsupported features.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const doc = await ketrics.Pdf.read(buffer);
+ * } catch (error) {
+ *   if (error instanceof ketrics.PdfParseError) {
+ *     console.log('Failed to parse PDF file:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class PdfParseError extends PdfError {
+    /** The reason for the parse failure */
+    readonly reason: string;
+    constructor(reason: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error writing PDF file
+ *
+ * Thrown when a PDF file cannot be written due to invalid data
+ * or other write errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const buffer = await doc.toBuffer();
+ * } catch (error) {
+ *   if (error instanceof ketrics.PdfWriteError) {
+ *     console.log('Failed to write PDF file:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class PdfWriteError extends PdfError {
+    /** The reason for the write failure */
+    readonly reason: string;
+    constructor(reason: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Type guard to check if an error is a PdfError
+ */
+export declare function isPdfError(error: unknown): error is PdfError;
+/**
+ * Type guard to check if an error is a specific PDF error type
+ */
+export declare function isPdfErrorType<T extends PdfError>(error: unknown, errorClass: new (...args: never[]) => T): error is T;
+//# sourceMappingURL=pdf-errors.d.ts.map

package/dist/pdf-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-errors.d.ts","sourceRoot":"","sources":["../src/pdf-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;GAKG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;gBAEb,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAc9C;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAK1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAK1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GACtC,KAAK,IAAI,CAAC,CAEZ"}

package/dist/pdf-errors.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * PDF SDK Error Classes
+ *
+ * Error types for PDF operations in tenant applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfWriteError = exports.PdfParseError = exports.PdfError = void 0;
+exports.isPdfError = isPdfError;
+exports.isPdfErrorType = isPdfErrorType;
+// ============================================================================
+// Base PDF Error
+// ============================================================================
+/**
+ * Base error for all PDF operations
+ *
+ * All PDF-related errors inherit from this class, providing
+ * consistent context and structure for error handling.
+ */
+class PdfError extends Error {
+    constructor(operation, message) {
+        super(message);
+        this.name = this.constructor.name;
+        this.operation = operation;
+        this.timestamp = new Date();
+        // Maintain proper stack trace in V8 environments
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (Error.captureStackTrace) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to JSON-serializable object
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            operation: this.operation,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+exports.PdfError = PdfError;
+// ============================================================================
+// PDF Parse Error
+// ============================================================================
+/**
+ * Error parsing PDF file
+ *
+ * Thrown when a PDF file cannot be parsed due to invalid format,
+ * corrupted data, or unsupported features.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const doc = await ketrics.Pdf.read(buffer);
+ * } catch (error) {
+ *   if (error instanceof ketrics.PdfParseError) {
+ *     console.log('Failed to parse PDF file:', error.message);
+ *   }
+ * }
+ * ```
+ */
+class PdfParseError extends PdfError {
+    constructor(reason) {
+        super('read', `Failed to parse PDF file: ${reason}`);
+        this.reason = reason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            reason: this.reason,
+        };
+    }
+}
+exports.PdfParseError = PdfParseError;
+// ============================================================================
+// PDF Write Error
+// ============================================================================
+/**
+ * Error writing PDF file
+ *
+ * Thrown when a PDF file cannot be written due to invalid data
+ * or other write errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const buffer = await doc.toBuffer();
+ * } catch (error) {
+ *   if (error instanceof ketrics.PdfWriteError) {
+ *     console.log('Failed to write PDF file:', error.message);
+ *   }
+ * }
+ * ```
+ */
+class PdfWriteError extends PdfError {
+    constructor(reason) {
+        super('write', `Failed to write PDF file: ${reason}`);
+        this.reason = reason;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            reason: this.reason,
+        };
+    }
+}
+exports.PdfWriteError = PdfWriteError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a PdfError
+ */
+function isPdfError(error) {
+    return error instanceof PdfError;
+}
+/**
+ * Type guard to check if an error is a specific PDF error type
+ */
+function isPdfErrorType(error, errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=pdf-errors.js.map

package/dist/pdf-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-errors.js","sourceRoot":"","sources":["../src/pdf-errors.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAiIH,gCAEC;AAKD,wCAKC;AA3ID,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAsB,QAAS,SAAQ,KAAK;IAO1C,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,iDAAiD;QACjD,8DAA8D;QAC9D,IAAK,KAAa,CAAC,iBAAiB,EAAE,CAAC;YACrC,8DAA8D;YAC7D,KAAa,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;SACxC,CAAC;IACJ,CAAC;CACF;AAhCD,4BAgCC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,aAAc,SAAQ,QAAQ;IAIzC,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,EAAE,6BAA6B,MAAM,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAfD,sCAeC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,aAAc,SAAQ,QAAQ;IAIzC,YAAY,MAAc;QACxB,KAAK,CAAC,OAAO,EAAE,6BAA6B,MAAM,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAfD,sCAeC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAC5B,KAAc,EACd,UAAuC;IAEvC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC"}