hazo_notify 1.0.2 → 1.1.1

package/dist/template_manager/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Type definitions for the template manager service
+ *
+ * This module provides TypeScript interfaces for:
+ * - Template configuration and variable definitions
+ * - Database entity types (categories and templates)
+ * - hazo_connect integration
+ * - Service request/response types
+ */
+import type { Logger } from '../emailer/types';
+/**
+ * Definition of a template variable
+ */
+export interface TemplateVariableDefinition {
+    variable_name: string;
+    variable_description: string;
+    default_value?: string;
+}
+/**
+ * Definition of a template type with its associated variables
+ * Loaded from config: email_template_variable_types
+ */
+export interface TemplateTypeDefinition {
+    template_name: string;
+    template_label: string;
+    variables: TemplateVariableDefinition[];
+}
+/**
+ * System variable that is auto-generated (e.g., date formats)
+ */
+export interface SystemVariable {
+    variable_name: string;
+    variable_description: string;
+    resolver: () => string;
+}
+/**
+ * Configuration for the template manager
+ */
+export interface TemplateManagerConfig {
+    email_template_variable_types: TemplateTypeDefinition[];
+    system_email_template_variables: SystemVariable[];
+}
+/**
+ * Email type enum: system templates cannot be deleted
+ */
+export type EmailType = 'system' | 'user';
+/**
+ * Template category entity from hazo_notify_template_cat table
+ */
+export interface TemplateCategory {
+    id: string;
+    org_id: string;
+    root_org_id: string;
+    template_category_name: string;
+    created_at: string;
+    changed_at: string | null;
+}
+/**
+ * Input for creating a new template category
+ */
+export interface TemplateCategoryInput {
+    org_id: string;
+    root_org_id: string;
+    template_category_name: string;
+}
+/**
+ * Input for updating an existing template category
+ */
+export interface TemplateCategoryUpdate {
+    template_category_name?: string;
+}
+/**
+ * Email template entity from hazo_notify_templates table
+ */
+export interface EmailTemplate {
+    id: string;
+    org_id: string;
+    root_org_id: string;
+    template_category_id: string;
+    template_variables: Record<string, unknown>;
+    template_name: string;
+    template_html: string;
+    template_text: string;
+    email_type: EmailType;
+    created_at: string;
+    changed_at: string | null;
+}
+/**
+ * Input for creating a new email template
+ */
+export interface EmailTemplateInput {
+    org_id: string;
+    root_org_id: string;
+    template_category_id: string;
+    template_variables?: Record<string, unknown>;
+    template_name: string;
+    template_html: string;
+    template_text: string;
+    email_type?: EmailType;
+}
+/**
+ * Input for updating an existing email template
+ */
+export interface EmailTemplateUpdate {
+    template_category_id?: string;
+    template_variables?: Record<string, unknown>;
+    template_name?: string;
+    template_html?: string;
+    template_text?: string;
+}
+/**
+ * Query builder interface for hazo_connect
+ * Supports fluent chaining pattern
+ */
+export interface HazoConnectQueryBuilder {
+    from(table: string): this;
+    select(columns: string | string[]): this;
+    where(column: string, operator: string, value: unknown): this;
+    whereIn(column: string, values: unknown[]): this;
+    order(column: string, direction: 'asc' | 'desc'): this;
+    limit(n: number): this;
+    offset(n: number): this;
+}
+/**
+ * hazo_connect instance interface
+ * Consuming apps pass this to template manager functions
+ */
+export interface HazoConnectInstance {
+    /** Execute query and return list of results */
+    list<T>(query: HazoConnectQueryBuilder): Promise<T[]>;
+    /** Find a single record by ID */
+    findById<T>(table: string, id: string): Promise<T | null>;
+    /** Find records matching criteria */
+    findBy<T>(table: string, criteria: Record<string, unknown>): Promise<T[]>;
+    /** Insert a new record */
+    insert<T>(table: string, data: Partial<T>): Promise<T>;
+    /** Update a record by ID */
+    updateById<T>(table: string, id: string, patch: Partial<T>): Promise<T>;
+    /** Delete a record by ID */
+    deleteById(table: string, id: string): Promise<boolean>;
+    /** Create a new query builder */
+    query(): HazoConnectQueryBuilder;
+}
+/**
+ * Result of rendering a template
+ */
+export interface TemplateRenderResult {
+    success: boolean;
+    rendered_html?: string;
+    rendered_text?: string;
+    error?: string;
+    message?: string;
+}
+/**
+ * Generic response for template operations
+ */
+export interface TemplateOperationResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+}
+/**
+ * Attachment for template email
+ */
+export interface TemplateEmailAttachment {
+    filename: string;
+    content: string;
+    mime_type: string;
+}
+/**
+ * Options for sending a templated email
+ */
+export interface SendTemplateEmailOptions {
+    /** Name of template to use (must match a template_name in DB) */
+    template_name: string;
+    /** Variables to substitute in the template */
+    variables: Record<string, string>;
+    /** Recipient email address(es) */
+    to: string | string[];
+    /** Subject line (overrides template subject if provided) */
+    subject?: string;
+    /** Sender email address (overrides config default) */
+    from?: string;
+    /** Sender name (overrides config default) */
+    from_name?: string;
+    /** Reply-to email address */
+    reply_to?: string;
+    /** CC recipients */
+    cc?: string | string[];
+    /** BCC recipients */
+    bcc?: string | string[];
+    /** File attachments */
+    attachments?: TemplateEmailAttachment[];
+    /** Optional logger instance (compatible with hazo_logs) */
+    logger?: Logger;
+}
+/**
+ * Response from send_template_email
+ */
+export interface SendTemplateEmailResponse {
+    success: boolean;
+    message_id?: string;
+    message?: string;
+    /** Rendered HTML content (for debugging) */
+    rendered_html?: string;
+    /** Rendered text content (for debugging) */
+    rendered_text?: string;
+    raw_response?: Record<string, unknown> | string;
+    error?: string;
+}
+/**
+ * Category with its templates for UI tree display
+ */
+export interface CategoryTreeItem {
+    category: TemplateCategory;
+    templates: EmailTemplate[];
+    expanded: boolean;
+}
+/**
+ * Variable item for dropdown display
+ */
+export interface VariableItem {
+    name: string;
+    description: string;
+    type: 'user' | 'system';
+}
+/**
+ * Template reference item for dropdown display
+ */
+export interface TemplateReferenceItem {
+    category_name: string;
+    template_name: string;
+    template_id: string;
+}
+/**
+ * Manifest entry for a default template shipped with the package
+ */
+export interface DefaultTemplateManifestEntry {
+    template_name: string;
+    template_label: string;
+    category: string;
+    html_file: string;
+    text_file: string;
+    variables: TemplateVariableDefinition[];
+}
+/**
+ * Manifest file structure for default templates
+ */
+export interface DefaultTemplateManifest {
+    version: string;
+    templates: DefaultTemplateManifestEntry[];
+}
+export type { Logger };
+//# sourceMappingURL=types.d.ts.map

package/dist/template_manager/types.d.ts.map

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

package/dist/template_manager/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Type definitions for the template manager service
+ *
+ * This module provides TypeScript interfaces for:
+ * - Template configuration and variable definitions
+ * - Database entity types (categories and templates)
+ * - hazo_connect integration
+ * - Service request/response types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/template_manager/types.js.map

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

package/dist/template_manager/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utils barrel export for template manager
+ */
+export { get_system_variables, resolve_system_variables, get_system_variable_definitions, } from './system_variables';
+export { validate_template_name, validate_category_name, validate_variable_name, validate_template_html_size, validate_template_text_size, extract_variables_from_content, validate_provided_variables, validate_uuid, sanitize_template_name, } from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/template_manager/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,aAAa,EACb,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/template_manager/utils/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Utils barrel export for template manager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitize_template_name = exports.validate_uuid = exports.validate_provided_variables = exports.extract_variables_from_content = exports.validate_template_text_size = exports.validate_template_html_size = exports.validate_variable_name = exports.validate_category_name = exports.validate_template_name = exports.get_system_variable_definitions = exports.resolve_system_variables = exports.get_system_variables = void 0;
+var system_variables_1 = require("./system_variables");
+Object.defineProperty(exports, "get_system_variables", { enumerable: true, get: function () { return system_variables_1.get_system_variables; } });
+Object.defineProperty(exports, "resolve_system_variables", { enumerable: true, get: function () { return system_variables_1.resolve_system_variables; } });
+Object.defineProperty(exports, "get_system_variable_definitions", { enumerable: true, get: function () { return system_variables_1.get_system_variable_definitions; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validate_template_name", { enumerable: true, get: function () { return validation_1.validate_template_name; } });
+Object.defineProperty(exports, "validate_category_name", { enumerable: true, get: function () { return validation_1.validate_category_name; } });
+Object.defineProperty(exports, "validate_variable_name", { enumerable: true, get: function () { return validation_1.validate_variable_name; } });
+Object.defineProperty(exports, "validate_template_html_size", { enumerable: true, get: function () { return validation_1.validate_template_html_size; } });
+Object.defineProperty(exports, "validate_template_text_size", { enumerable: true, get: function () { return validation_1.validate_template_text_size; } });
+Object.defineProperty(exports, "extract_variables_from_content", { enumerable: true, get: function () { return validation_1.extract_variables_from_content; } });
+Object.defineProperty(exports, "validate_provided_variables", { enumerable: true, get: function () { return validation_1.validate_provided_variables; } });
+Object.defineProperty(exports, "validate_uuid", { enumerable: true, get: function () { return validation_1.validate_uuid; } });
+Object.defineProperty(exports, "sanitize_template_name", { enumerable: true, get: function () { return validation_1.sanitize_template_name; } });
+//# sourceMappingURL=index.js.map

package/dist/template_manager/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/template_manager/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAI4B;AAH1B,wHAAA,oBAAoB,OAAA;AACpB,4HAAA,wBAAwB,OAAA;AACxB,mIAAA,+BAA+B,OAAA;AAGjC,2CAUsB;AATpB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,yHAAA,2BAA2B,OAAA;AAC3B,yHAAA,2BAA2B,OAAA;AAC3B,4HAAA,8BAA8B,OAAA;AAC9B,yHAAA,2BAA2B,OAAA;AAC3B,2GAAA,aAAa,OAAA;AACb,oHAAA,sBAAsB,OAAA"}

package/dist/template_manager/utils/system_variables.d.ts

@@ -0,0 +1,28 @@
+/**
+ * System variables for template manager
+ *
+ * Auto-generated date format variables that can be used in templates
+ */
+import type { SystemVariable } from '../types';
+/**
+ * Get all system variables with their resolvers
+ *
+ * @returns Array of system variables that can be used in templates
+ */
+export declare function get_system_variables(): SystemVariable[];
+/**
+ * Resolve all system variables to their current values
+ *
+ * @returns Record mapping variable names to their resolved values
+ */
+export declare function resolve_system_variables(): Record<string, string>;
+/**
+ * Get system variable definitions for UI display (without resolvers)
+ *
+ * @returns Array of variable info objects suitable for UI
+ */
+export declare function get_system_variable_definitions(): Array<{
+    variable_name: string;
+    variable_description: string;
+}>;
+//# sourceMappingURL=system_variables.d.ts.map

package/dist/template_manager/utils/system_variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system_variables.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/utils/system_variables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAgE/C;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,EAAE,CAkHvD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASjE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,KAAK,CAAC;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,CAKD"}

package/dist/template_manager/utils/system_variables.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * System variables for template manager
+ *
+ * Auto-generated date format variables that can be used in templates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_system_variables = get_system_variables;
+exports.resolve_system_variables = resolve_system_variables;
+exports.get_system_variable_definitions = get_system_variable_definitions;
+/**
+ * Month names for formatting
+ */
+const MONTH_NAMES_FULL = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December',
+];
+const MONTH_NAMES_SHORT = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+const DAY_NAMES = [
+    'Sunday',
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+];
+/**
+ * Pad a number with leading zeros
+ */
+function pad_number(num, length = 2) {
+    return String(num).padStart(length, '0');
+}
+/**
+ * Format time as 12-hour with AM/PM
+ */
+function format_time_12h(date) {
+    let hours = date.getHours();
+    const minutes = pad_number(date.getMinutes());
+    const ampm = hours >= 12 ? 'PM' : 'AM';
+    hours = hours % 12;
+    hours = hours ? hours : 12; // 0 should be 12
+    return `${hours}:${minutes} ${ampm}`;
+}
+/**
+ * Get all system variables with their resolvers
+ *
+ * @returns Array of system variables that can be used in templates
+ */
+function get_system_variables() {
+    return [
+        {
+            variable_name: 'date_yyyy_mm_dd',
+            variable_description: 'Date in YYYY-MM-DD format (e.g., 2024-01-15)',
+            resolver: () => {
+                const now = new Date();
+                const year = now.getFullYear();
+                const month = pad_number(now.getMonth() + 1);
+                const day = pad_number(now.getDate());
+                return `${year}-${month}-${day}`;
+            },
+        },
+        {
+            variable_name: 'date_mmm_dd',
+            variable_description: 'Date in MMM DD format (e.g., Jan 15)',
+            resolver: () => {
+                const now = new Date();
+                const month = MONTH_NAMES_SHORT[now.getMonth()];
+                const day = now.getDate();
+                return `${month} ${day}`;
+            },
+        },
+        {
+            variable_name: 'date_mmmm_dd_yyyy',
+            variable_description: 'Date in full format (e.g., January 15, 2024)',
+            resolver: () => {
+                const now = new Date();
+                const month = MONTH_NAMES_FULL[now.getMonth()];
+                const day = now.getDate();
+                const year = now.getFullYear();
+                return `${month} ${day}, ${year}`;
+            },
+        },
+        {
+            variable_name: 'date_dd_mm_yyyy',
+            variable_description: 'Date in DD/MM/YYYY format (e.g., 15/01/2024)',
+            resolver: () => {
+                const now = new Date();
+                const day = pad_number(now.getDate());
+                const month = pad_number(now.getMonth() + 1);
+                const year = now.getFullYear();
+                return `${day}/${month}/${year}`;
+            },
+        },
+        {
+            variable_name: 'date_dd_mmm_yyyy',
+            variable_description: 'Date in DD MMM YYYY format (e.g., 15 Jan 2024)',
+            resolver: () => {
+                const now = new Date();
+                const day = now.getDate();
+                const month = MONTH_NAMES_SHORT[now.getMonth()];
+                const year = now.getFullYear();
+                return `${day} ${month} ${year}`;
+            },
+        },
+        {
+            variable_name: 'time_hh_mm',
+            variable_description: 'Time in HH:MM format (24-hour, e.g., 14:30)',
+            resolver: () => {
+                const now = new Date();
+                const hours = pad_number(now.getHours());
+                const minutes = pad_number(now.getMinutes());
+                return `${hours}:${minutes}`;
+            },
+        },
+        {
+            variable_name: 'time_hh_mm_ss',
+            variable_description: 'Time in HH:MM:SS format (24-hour, e.g., 14:30:45)',
+            resolver: () => {
+                const now = new Date();
+                const hours = pad_number(now.getHours());
+                const minutes = pad_number(now.getMinutes());
+                const seconds = pad_number(now.getSeconds());
+                return `${hours}:${minutes}:${seconds}`;
+            },
+        },
+        {
+            variable_name: 'datetime_full',
+            variable_description: 'Full datetime (e.g., January 15, 2024 at 2:30 PM)',
+            resolver: () => {
+                const now = new Date();
+                const month = MONTH_NAMES_FULL[now.getMonth()];
+                const day = now.getDate();
+                const year = now.getFullYear();
+                const time = format_time_12h(now);
+                return `${month} ${day}, ${year} at ${time}`;
+            },
+        },
+        {
+            variable_name: 'year',
+            variable_description: 'Current year (e.g., 2024)',
+            resolver: () => {
+                return String(new Date().getFullYear());
+            },
+        },
+        {
+            variable_name: 'month_name',
+            variable_description: 'Current month name (e.g., January)',
+            resolver: () => {
+                return MONTH_NAMES_FULL[new Date().getMonth()];
+            },
+        },
+        {
+            variable_name: 'day_of_week',
+            variable_description: 'Current day of week (e.g., Monday)',
+            resolver: () => {
+                return DAY_NAMES[new Date().getDay()];
+            },
+        },
+    ];
+}
+/**
+ * Resolve all system variables to their current values
+ *
+ * @returns Record mapping variable names to their resolved values
+ */
+function resolve_system_variables() {
+    const system_vars = get_system_variables();
+    const resolved = {};
+    for (const sys_var of system_vars) {
+        resolved[sys_var.variable_name] = sys_var.resolver();
+    }
+    return resolved;
+}
+/**
+ * Get system variable definitions for UI display (without resolvers)
+ *
+ * @returns Array of variable info objects suitable for UI
+ */
+function get_system_variable_definitions() {
+    return get_system_variables().map((v) => ({
+        variable_name: v.variable_name,
+        variable_description: v.variable_description,
+    }));
+}
+//# sourceMappingURL=system_variables.js.map

package/dist/template_manager/utils/system_variables.js.map

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

package/dist/template_manager/utils/validation.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Validation utilities for template manager
+ *
+ * Validates template names, category names, variables, and content
+ */
+/**
+ * Validate a template name
+ *
+ * @param name - Template name to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function validate_template_name(name: string): boolean;
+/**
+ * Validate a category name
+ *
+ * @param name - Category name to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function validate_category_name(name: string): boolean;
+/**
+ * Validate a variable name
+ *
+ * @param name - Variable name to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function validate_variable_name(name: string): boolean;
+/**
+ * Validate template HTML content size
+ *
+ * @param html - HTML content to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function validate_template_html_size(html: string): boolean;
+/**
+ * Validate template text content size
+ *
+ * @param text - Text content to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function validate_template_text_size(text: string): boolean;
+/**
+ * Extract variable names from template content
+ *
+ * @param content - Template content (HTML or text)
+ * @returns Array of variable names found in the content
+ */
+export declare function extract_variables_from_content(content: string): string[];
+/**
+ * Validate that all required variables are provided
+ *
+ * @param template_content - Template content to check
+ * @param provided_variables - Variables provided by user
+ * @param system_variable_names - Names of system variables
+ * @returns Object with validation result and missing variables
+ */
+export declare function validate_provided_variables(template_content: string, provided_variables: Record<string, string>, system_variable_names: string[]): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Validate UUID format
+ *
+ * @param uuid - String to validate as UUID
+ * @returns true if valid UUID format, false otherwise
+ */
+export declare function validate_uuid(uuid: string): boolean;
+/**
+ * Sanitize template name for safe use
+ *
+ * @param name - Template name to sanitize
+ * @returns Sanitized template name
+ */
+export declare function sanitize_template_name(name: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/template_manager/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/lib/template_manager/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiB5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgB5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAexE;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,EACxB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,qBAAqB,EAAE,MAAM,EAAE,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAWvC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY3D"}