@ketrics/sdk-backend 0.3.0 → 0.5.0

package/dist/messages-errors.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Ketrics SDK - Messages Error Classes
+ *
+ * Provides error class definitions for the Messages SDK.
+ * These classes are used for error handling in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * try {
+ *   await ketrics.Messages.sendToGroup({
+ *     groupCode: 'engineering-team',
+ *     type: 'TEAM_UPDATE',
+ *     subject: 'Sprint planning',
+ *     body: '...'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof ketrics.MessageValidationError) {
+ *     console.log('Invalid message parameters:', error.message);
+ *   } else if (error instanceof ketrics.GroupNotFoundError) {
+ *     console.log('Group not found:', error.message);
+ *   } else if (error instanceof ketrics.TenantGrantPermissionDeniedError) {
+ *     console.log('Missing permissions:', error.missingPermissions);
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantGrantPermissionDeniedError = exports.GroupNotFoundError = exports.MessageValidationError = exports.MessageError = void 0;
+exports.isMessageError = isMessageError;
+exports.isMessageErrorType = isMessageErrorType;
+// ============================================================================
+// Base Message Error
+// ============================================================================
+/**
+ * Base error class for message-related errors
+ */
+class MessageError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.name = 'MessageError';
+        this.code = code ?? 'MESSAGE_ERROR';
+    }
+}
+exports.MessageError = MessageError;
+// ============================================================================
+// Specific Message Errors
+// ============================================================================
+/**
+ * Error thrown when message validation fails
+ */
+class MessageValidationError extends MessageError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR');
+        this.name = 'MessageValidationError';
+    }
+}
+exports.MessageValidationError = MessageValidationError;
+/**
+ * Error thrown when group is not found
+ */
+class GroupNotFoundError extends MessageError {
+    constructor(groupCode) {
+        super(`Group not found: ${groupCode}`, 'GROUP_NOT_FOUND');
+        this.name = 'GroupNotFoundError';
+    }
+}
+exports.GroupNotFoundError = GroupNotFoundError;
+/**
+ * Error thrown when application IAM-data permission is missing
+ *
+ * This error is thrown when an application tries to access tenant data
+ * (users, groups, group memberships) without having the required
+ * IAM-data permissions assigned via its role.
+ */
+class TenantGrantPermissionDeniedError extends MessageError {
+    constructor(message, code) {
+        super(message, code ?? 'PERMISSION_DENIED');
+        this.name = 'TenantGrantPermissionDeniedError';
+        // Parse missing permissions from message if it follows the standard format
+        const match = message.match(/permissions: (.+)/);
+        this.missingPermissions = match ? match[1].split(', ') : [];
+    }
+    /**
+     * Factory method to create error with permissions list
+     */
+    static withPermissions(permissions) {
+        return new TenantGrantPermissionDeniedError(`Application is missing required IAM-data permissions: ${permissions.join(', ')}. ` +
+            `Assign a role with these permissions to the application.`);
+    }
+}
+exports.TenantGrantPermissionDeniedError = TenantGrantPermissionDeniedError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a MessageError
+ */
+function isMessageError(error) {
+    return error instanceof MessageError;
+}
+/**
+ * Type guard to check if an error is a specific MessageError type
+ */
+function isMessageErrorType(error, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=messages-errors.js.map

package/dist/messages-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-errors.js","sourceRoot":"","sources":["../src/messages-errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AA+EH,wCAEC;AAKD,gDAMC;AA1FD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGrC,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,eAAe,CAAC;IACtC,CAAC;CACF;AARD,oCAQC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAa,sBAAuB,SAAQ,YAAY;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,SAAiB;QAC3B,KAAK,CAAC,oBAAoB,SAAS,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED;;;;;;GAMG;AACH,MAAa,gCAAiC,SAAQ,YAAY;IAGhE,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;QAC/C,2EAA2E;QAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAqB;QAC1C,OAAO,IAAI,gCAAgC,CACzC,yDAAyD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACjF,0DAA0D,CAC7D,CAAC;IACJ,CAAC;CACF;AApBD,4EAoBC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,KAAc;AACd,8DAA8D;AAC9D,UAAqC;IAErC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Ketrics SDK - Messages Interfaces and Types
+ *
+ * Provides type definitions for the Messages SDK that allows
+ * tenant applications to send messages to users.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Send single message
+ * const result = await ketrics.Messages.send({
+ *   userId: 'user-123',
+ *   type: 'ORDER_SHIPPED',
+ *   subject: 'Your order has shipped!',
+ *   body: 'Track your package...',
+ *   priority: 'HIGH'
+ * });
+ *
+ * // Send to multiple users
+ * const bulk = await ketrics.Messages.sendBulk({
+ *   userIds: ['user-1', 'user-2'],
+ *   type: 'ANNOUNCEMENT',
+ *   subject: 'Important update',
+ *   body: '...'
+ * });
+ *
+ * // Send to a group (requires IAM-data permissions via application role)
+ * const group = await ketrics.Messages.sendToGroup({
+ *   groupCode: 'engineering-team',
+ *   type: 'TEAM_UPDATE',
+ *   subject: 'Sprint planning tomorrow',
+ *   body: '...'
+ * });
+ * ```
+ *
+ * Key Distinction:
+ * - Messages: Content sent by apps to users, stored in their inbox
+ * - Notifications: Alerts (push) that tell users about new messages
+ */
+/**
+ * Message priority level
+ */
+export type MessagePriorityLevel = 'LOW' | 'MEDIUM' | 'HIGH';
+/**
+ * Channel configuration for message delivery
+ */
+export interface MessageChannelConfig {
+    /** Store in user's inbox (always enabled) */
+    inbox: boolean;
+    /** Send push notification alert */
+    push: boolean;
+}
+/**
+ * Parameters for Messages.send()
+ */
+export interface SendMessageParams {
+    /** Recipient user ID */
+    userId: string;
+    /** Application-defined message type */
+    type: string;
+    /** Message subject/title (max 200 chars) */
+    subject: string;
+    /** Message body (max 10,000 chars, markdown supported) */
+    body: string;
+    /** Priority level (default: MEDIUM) */
+    priority?: MessagePriorityLevel;
+    /** Optional channel overrides */
+    channels?: Partial<MessageChannelConfig>;
+    /** Optional action URL for deep linking */
+    actionUrl?: string;
+    /** Optional custom data for app use */
+    data?: Record<string, unknown>;
+    /** Optional expiration timestamp (ISO) */
+    expiresAt?: string;
+}
+/**
+ * Parameters for Messages.sendBulk()
+ */
+export interface SendBulkMessageParams {
+    /** Array of user IDs to message */
+    userIds: string[];
+    /** Message content (same for all recipients) */
+    type: string;
+    subject: string;
+    body: string;
+    priority?: MessagePriorityLevel;
+    channels?: Partial<MessageChannelConfig>;
+    actionUrl?: string;
+    data?: Record<string, unknown>;
+    expiresAt?: string;
+}
+/**
+ * Parameters for Messages.sendToGroup()
+ */
+export interface SendGroupMessageParams {
+    /** Group code to send message to */
+    groupCode: string;
+    /** Message content (same for all group members) */
+    type: string;
+    subject: string;
+    body: string;
+    priority?: MessagePriorityLevel;
+    channels?: Partial<MessageChannelConfig>;
+    actionUrl?: string;
+    data?: Record<string, unknown>;
+    expiresAt?: string;
+}
+/**
+ * Result of sending a single message
+ */
+export interface SendMessageResult {
+    messageId: string;
+    userId: string;
+    status: 'sent' | 'failed';
+    error?: string;
+}
+/**
+ * Result of sending bulk messages
+ */
+export interface SendBulkMessageResult {
+    total: number;
+    sent: number;
+    failed: number;
+    results: SendMessageResult[];
+}
+/**
+ * Messages SDK module interface
+ *
+ * Provides methods for sending messages to users in tenant applications.
+ */
+export interface MessagesManager {
+    /**
+     * Send message to a single user
+     * No TenantGrant required (userId is explicit)
+     *
+     * @param params - Message parameters
+     * @returns Result with messageId and status
+     * @throws MessageValidationError if parameters are invalid
+     */
+    send(params: SendMessageParams): Promise<SendMessageResult>;
+    /**
+     * Send message to multiple users
+     * No TenantGrant required (userIds are explicit)
+     *
+     * @param params - Bulk message parameters
+     * @returns Results with counts and individual statuses
+     * @throws MessageValidationError if parameters are invalid
+     */
+    sendBulk(params: SendBulkMessageParams): Promise<SendBulkMessageResult>;
+    /**
+     * Send message to all members of a group
+     *
+     * Requires IAM-data permissions: iam:GetGroupData + iam:GetMembershipData
+     * These permissions must be assigned to the application via its role.
+     *
+     * @param params - Group message parameters
+     * @returns Results with counts and individual statuses
+     * @throws MessageValidationError if parameters are invalid
+     * @throws GroupNotFoundError if group doesn't exist
+     * @throws TenantGrantPermissionDeniedError if IAM-data permissions are missing
+     */
+    sendToGroup(params: SendGroupMessageParams): Promise<SendBulkMessageResult>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

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

package/dist/messages.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Ketrics SDK - Messages Interfaces and Types
+ *
+ * Provides type definitions for the Messages SDK that allows
+ * tenant applications to send messages to users.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Send single message
+ * const result = await ketrics.Messages.send({
+ *   userId: 'user-123',
+ *   type: 'ORDER_SHIPPED',
+ *   subject: 'Your order has shipped!',
+ *   body: 'Track your package...',
+ *   priority: 'HIGH'
+ * });
+ *
+ * // Send to multiple users
+ * const bulk = await ketrics.Messages.sendBulk({
+ *   userIds: ['user-1', 'user-2'],
+ *   type: 'ANNOUNCEMENT',
+ *   subject: 'Important update',
+ *   body: '...'
+ * });
+ *
+ * // Send to a group (requires IAM-data permissions via application role)
+ * const group = await ketrics.Messages.sendToGroup({
+ *   groupCode: 'engineering-team',
+ *   type: 'TEAM_UPDATE',
+ *   subject: 'Sprint planning tomorrow',
+ *   body: '...'
+ * });
+ * ```
+ *
+ * Key Distinction:
+ * - Messages: Content sent by apps to users, stored in their inbox
+ * - Notifications: Alerts (push) that tell users about new messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

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"}