@woltz/rich-domain 0.2.1

package/commitlint.config.js

@@ -0,0 +1,23 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',
+        'fix',
+        'docs',
+        'style',
+        'refactor',
+        'perf',
+        'test',
+        'chore',
+        'revert',
+        'ci',
+        'build'
+      ]
+    ],
+    'subject-case': [0]
+  }
+};

package/dist/base-entity.d.ts

@@ -0,0 +1,67 @@
+import { Id } from "./id";
+import { ValidationError } from "./validation-error";
+import { IDomainEvent } from "./domain-event";
+import { BaseProps, SubscriptionConfig, HistoryEntry, DeepJsonResult, EntityHooks, EntityValidation } from "./types";
+import { DomainEventBus } from "./domain-event-bus";
+export declare abstract class BaseEntity<T extends BaseProps> {
+    private _props;
+    private proxy;
+    private proxiedProps;
+    private snapshot;
+    private validationConfig;
+    private entityHooks?;
+    private entitySchema?;
+    private domainEvents;
+    protected static validation?: EntityValidation<any>;
+    protected static hooks?: EntityHooks<any, any>;
+    constructor(props: Omit<T, "id"> & {
+        id?: Id;
+    });
+    private validateProps;
+    private extractPathKey;
+    private setupUpdateValidation;
+    private takeSnapshot;
+    private deepCloneProps;
+    get id(): Id;
+    get isNew(): boolean;
+    /**
+     * Check equality with another entity by comparing IDs
+     * Entities are equal if they have the same ID, regardless of other properties
+     *
+     * @param other - Another entity or an ID to compare with
+     * @returns true if entities have the same ID
+     */
+    equals(other: BaseEntity<T> | Id | string): boolean;
+    get props(): T;
+    /**
+     * Check if entity has validation errors (when throwOnError is false)
+     */
+    get hasValidationErrors(): boolean;
+    /**
+     * Get validation errors (when throwOnError is false)
+     */
+    get validationErrors(): ValidationError | undefined;
+    subscribe(config: SubscriptionConfig<T>): void;
+    getHistory(): HistoryEntry[];
+    clearHistory(): void;
+    /**
+     * Add a domain event to this entity
+     */
+    protected addDomainEvent(event: IDomainEvent): void;
+    dispatchAll(bus: DomainEventBus): Promise<void>;
+    /**
+     * Get all uncommitted domain events
+     */
+    getUncommittedEvents(): IDomainEvent[];
+    /**
+     * Clear all domain events (call after publishing)
+     */
+    clearEvents(): void;
+    /**
+     * Check if entity has uncommitted events
+     */
+    hasUncommittedEvents(): boolean;
+    toJson(): DeepJsonResult<T>;
+    private deepToJson;
+}
+//# sourceMappingURL=base-entity.d.ts.map

package/dist/base-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.d.ts","sourceRoot":"","sources":["../src/base-entity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,EAGX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAWpD,8BAAsB,UAAU,CAAC,CAAC,SAAS,SAAS;IAClD,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAG1C,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAEnC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,EAAE,CAAA;KAAE;IAuD9C,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,qBAAqB;IAuE7B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IAwDtB,IAAI,EAAE,IAAI,EAAE,CAEX;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,OAAO;IAuBnD,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,eAAe,GAAG,SAAS,CAElD;IAED,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAS9C,UAAU,IAAI,YAAY,EAAE;IAI5B,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAItC,WAAW,CAAC,GAAG,EAAE,cAAc;IAI5C;;OAEG;IACH,oBAAoB,IAAI,YAAY,EAAE;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC;IAI3B,OAAO,CAAC,UAAU;CAenB"}

package/dist/base-entity.js

@@ -0,0 +1,309 @@
+// ============================================================================
+// Base Entity Class with Standard Schema Validation
+// ============================================================================
+import { Id } from "./id";
+import { DeepProxy } from "./deep-proxy";
+import { ValidationError } from "./validation-error";
+import { DEFAULT_VALIDATION_CONFIG } from "./constants";
+// Helper to get static properties from constructor
+function getStaticProperty(instance, propertyName) {
+    return instance.constructor[propertyName];
+}
+export class BaseEntity {
+    constructor(props) {
+        this.snapshot = null;
+        this.domainEvents = [];
+        // Get static configuration from subclass
+        const validation = getStaticProperty(this, "validation");
+        const hooks = getStaticProperty(this, "hooks");
+        this.entityHooks = hooks;
+        if (validation?.schema) {
+            this.entitySchema = validation.schema;
+        }
+        this.validationConfig = {
+            ...DEFAULT_VALIDATION_CONFIG,
+            ...validation?.config,
+        };
+        // Apply defaultValues
+        let finalProps = { ...props };
+        // Generate ID if not provided
+        if (!finalProps.id) {
+            finalProps.id = new Id();
+        }
+        // Validate schema on creation
+        if (this.entitySchema && this.validationConfig.onCreate) {
+            this.validateProps(finalProps);
+        }
+        this._props = finalProps;
+        this.proxy = new DeepProxy(this._props);
+        this.proxiedProps = this.proxy.createProxy();
+        // Execute rules (custom validations)
+        if (hooks?.rules) {
+            hooks.rules(this);
+        }
+        // Hook onCreate
+        if (hooks?.onCreate) {
+            hooks.onCreate(this);
+        }
+        // Setup update validation
+        if (this.entitySchema && this.validationConfig.onUpdate) {
+            this.setupUpdateValidation();
+        }
+        // Take initial snapshot for onBeforeUpdate
+        this.takeSnapshot();
+    }
+    validateProps(props) {
+        if (!this.entitySchema)
+            return;
+        const result = this.entitySchema["~standard"].validate(props);
+        if (result instanceof Promise) {
+            throw new Error("Async validation not supported in constructor. Use sync validation schema.");
+        }
+        if (result.issues && result.issues.length > 0) {
+            const validationError = new ValidationError(result.issues.map((issue) => ({
+                path: issue.path?.map((p) => this.extractPathKey(p)) || [],
+                message: issue.message,
+            })));
+            if (this.validationConfig.throwOnError) {
+                throw validationError;
+            }
+            // If not throwing, store error for later retrieval
+            this._validationError = validationError;
+        }
+    }
+    extractPathKey(pathSegment) {
+        if (pathSegment === null || pathSegment === undefined) {
+            return "";
+        }
+        // Handle PropertyKey (string | number | symbol)
+        if (typeof pathSegment === "string" || typeof pathSegment === "number") {
+            return String(pathSegment);
+        }
+        if (typeof pathSegment === "symbol") {
+            return pathSegment.toString();
+        }
+        // Handle object with 'key' property (Zod's PathSegment)
+        if (typeof pathSegment === "object" && "key" in pathSegment) {
+            return String(pathSegment.key);
+        }
+        // Fallback
+        return String(pathSegment);
+    }
+    setupUpdateValidation() {
+        const self = this;
+        const validateOnChange = () => {
+            // Check onBeforeUpdate hook
+            if (self.entityHooks?.onBeforeUpdate && self.snapshot) {
+                const shouldContinue = self.entityHooks.onBeforeUpdate(self, self.snapshot);
+                if (!shouldContinue) {
+                    // Revert changes
+                    Object.assign(self._props, self.snapshot);
+                    return;
+                }
+            }
+            // Validate with schema
+            if (self.entitySchema) {
+                const result = self.entitySchema["~standard"].validate(self._props);
+                if (result instanceof Promise) {
+                    console.warn("Async validation on update not supported. Consider using sync validation.");
+                    return;
+                }
+                if (result.issues && result.issues.length > 0) {
+                    const validationError = new ValidationError(result.issues.map((issue) => ({
+                        path: issue.path?.map((p) => self.extractPathKey(p)) || [],
+                        message: issue.message,
+                    })));
+                    if (self.validationConfig.throwOnError) {
+                        // Revert changes before throwing
+                        if (self.snapshot) {
+                            Object.assign(self._props, self.snapshot);
+                        }
+                        throw validationError;
+                    }
+                    console.error("Validation failed on update:", validationError);
+                }
+            }
+            // Execute rules after schema validation
+            if (self.entityHooks?.rules) {
+                try {
+                    self.entityHooks.rules(self);
+                }
+                catch (error) {
+                    if (self.validationConfig.throwOnError) {
+                        // Revert changes before throwing
+                        if (self.snapshot) {
+                            Object.assign(self._props, self.snapshot);
+                        }
+                        throw error;
+                    }
+                    console.error("Rules validation failed on update:", error);
+                }
+            }
+            // Update snapshot after successful validation
+            self.takeSnapshot();
+        };
+        // Subscribe to all changes
+        this.proxy.subscribe("*", validateOnChange);
+    }
+    takeSnapshot() {
+        this.snapshot = this.deepCloneProps(this._props);
+    }
+    deepCloneProps(obj, seen = new WeakSet()) {
+        if (obj === null || obj === undefined)
+            return obj;
+        // Primitives
+        if (typeof obj !== "object")
+            return obj;
+        // Special cases - don't clone these, just return the reference
+        if (obj instanceof Id)
+            return obj;
+        if (obj instanceof Date)
+            return new Date(obj.getTime());
+        // Check for circular references
+        if (seen.has(obj)) {
+            return obj; // Return reference to avoid infinite loop
+        }
+        // Handle BaseEntity instances - just keep the reference
+        if (obj instanceof BaseEntity) {
+            return obj;
+        }
+        // Handle ValueObject instances - just keep the reference (they're immutable)
+        if (obj.constructor &&
+            obj.constructor.name !== "Object" &&
+            obj.constructor.name !== "Array") {
+            // Check if it has toJson method (likely a ValueObject or similar)
+            if (typeof obj.toJson === "function" &&
+                typeof obj.equals === "function") {
+                return obj; // Keep reference for ValueObjects
+            }
+        }
+        seen.add(obj);
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.deepCloneProps(item, seen));
+        }
+        // Plain objects only
+        if (obj.constructor === Object) {
+            const cloned = {};
+            for (const key in obj) {
+                if (obj.hasOwnProperty(key)) {
+                    cloned[key] = this.deepCloneProps(obj[key], seen);
+                }
+            }
+            return cloned;
+        }
+        // For other object types (custom classes), just keep the reference
+        return obj;
+    }
+    get id() {
+        return this._props.id;
+    }
+    get isNew() {
+        return this._props.id.isNew;
+    }
+    /**
+     * Check equality with another entity by comparing IDs
+     * Entities are equal if they have the same ID, regardless of other properties
+     *
+     * @param other - Another entity or an ID to compare with
+     * @returns true if entities have the same ID
+     */
+    equals(other) {
+        if (!other) {
+            return false;
+        }
+        // Compare with another entity
+        if (other instanceof BaseEntity) {
+            return this.id.equals(other.id);
+        }
+        // Compare with an ID
+        if (other instanceof Id) {
+            return this.id.equals(other);
+        }
+        // Compare with a string ID
+        if (typeof other === "string") {
+            return this.id.equals(other);
+        }
+        return false;
+    }
+    get props() {
+        return this.proxiedProps;
+    }
+    /**
+     * Check if entity has validation errors (when throwOnError is false)
+     */
+    get hasValidationErrors() {
+        return !!this._validationError;
+    }
+    /**
+     * Get validation errors (when throwOnError is false)
+     */
+    get validationErrors() {
+        return this._validationError;
+    }
+    subscribe(config) {
+        Object.keys(config).forEach((key) => {
+            const sub = config[key];
+            if (sub && "onChange" in sub) {
+                this.proxy.subscribe(key, sub.onChange);
+            }
+        });
+    }
+    getHistory() {
+        return this.proxy.getHistory();
+    }
+    clearHistory() {
+        this.proxy.clearHistory();
+    }
+    /**
+     * Add a domain event to this entity
+     */
+    addDomainEvent(event) {
+        this.domainEvents.push(event);
+    }
+    async dispatchAll(bus) {
+        await bus.publishAll(this.getUncommittedEvents());
+    }
+    /**
+     * Get all uncommitted domain events
+     */
+    getUncommittedEvents() {
+        return [...this.domainEvents];
+    }
+    /**
+     * Clear all domain events (call after publishing)
+     */
+    clearEvents() {
+        this.domainEvents = [];
+    }
+    /**
+     * Check if entity has uncommitted events
+     */
+    hasUncommittedEvents() {
+        return this.domainEvents.length > 0;
+    }
+    toJson() {
+        return this.deepToJson(this._props);
+    }
+    deepToJson(obj) {
+        if (obj === null || obj === undefined)
+            return obj;
+        if (obj instanceof Id)
+            return obj.value;
+        if (Array.isArray(obj))
+            return obj.map((item) => this.deepToJson(item));
+        if (obj instanceof BaseEntity)
+            return obj.toJson();
+        if (obj && typeof obj.toJson === "function")
+            return obj.toJson();
+        if (typeof obj === "object") {
+            const result = {};
+            for (const key in obj) {
+                if (obj.hasOwnProperty(key))
+                    result[key] = this.deepToJson(obj[key]);
+            }
+            return result;
+        }
+        return obj;
+    }
+}
+//# sourceMappingURL=base-entity.js.map

package/dist/base-entity.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+import { ValidationConfig } from ".";
+export declare const DEFAULT_VALIDATION_CONFIG: Required<ValidationConfig>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,GAAG,CAAC;AAErC,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,gBAAgB,CAIhE,CAAC"}

package/dist/constants.js

@@ -0,0 +1,6 @@
+export const DEFAULT_VALIDATION_CONFIG = {
+    onCreate: true,
+    onUpdate: true,
+    throwOnError: true,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAA+B;IACnE,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/criteria.d.ts

@@ -0,0 +1,60 @@
+import { FieldPath, Filter, FilterOperator, FilterValueFor, Order, OrderDirection, Pagination, PathValue, TypedFilter } from "./types";
+export declare class Criteria<T = unknown> {
+    private _filters;
+    private _orders;
+    private _pagination;
+    private _search?;
+    private constructor();
+    /**
+     * Create a new Criteria instance
+     */
+    static create<T = unknown>(): Criteria<T>;
+    /**
+     * Add a filter condition
+     */
+    where<K extends FieldPath<T>>(field: K, operator: FilterOperator, value?: FilterValueFor<PathValue<T, K>>): this;
+    whereEquals<K extends FieldPath<T>>(field: K, value: PathValue<T, K>): this;
+    whereContains<K extends FieldPath<T>>(field: K, value: PathValue<T, K>): this;
+    whereIn<K extends FieldPath<T>>(field: K, values: PathValue<T, K>[]): this;
+    whereBetween<K extends FieldPath<T>>(field: K, min: PathValue<T, K>, max: PathValue<T, K>): this;
+    whereNull<K extends FieldPath<T>>(field: K): this;
+    whereNotNull<K extends FieldPath<T>>(field: K): this;
+    orderBy<K extends FieldPath<T>>(field: K, direction?: OrderDirection): this;
+    orderByAsc<K extends FieldPath<T>>(field: K): this;
+    orderByDesc<K extends FieldPath<T>>(field: K): this;
+    search<K extends FieldPath<T>>(fields: K[], value: string): this;
+    hasSearch(): boolean;
+    getSearch(): {
+        fields: FieldPath<T>[];
+        value: string;
+    } | undefined;
+    paginate(page: number, limit: number): this;
+    limit(limit: number): this;
+    getFilters(): Filter[];
+    getOrders(): Order[];
+    getPagination(): Pagination;
+    hasFilters(): boolean;
+    hasOrders(): boolean;
+    hasPagination(): boolean;
+    clone(): Criteria<T>;
+    toJSON(): {
+        filters: Filter<FieldPath<T>, any>[];
+        orders: Order[];
+        pagination: Pagination;
+        search: {
+            fields: FieldPath<T>[];
+            value: string;
+        } | undefined;
+    };
+    static fromObject<T>(obj: {
+        filters?: TypedFilter<T>[];
+        orders?: Order[];
+        pagination?: Pagination;
+        search?: {
+            fields: FieldPath<T>[];
+            value: string;
+        };
+    }): Criteria<T>;
+    static fromQueryParams<T>(query: Record<string, any>): Criteria<T>;
+}
+//# sourceMappingURL=criteria.d.ts.map

package/dist/criteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.d.ts","sourceRoot":"","sources":["../src/criteria.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,MAAM,EACN,cAAc,EACd,cAAc,EACd,KAAK,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,WAAW,EACZ,MAAM,SAAS,CAAC;AAMjB,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO;IAC/B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,OAAO,CAAC,CAGd;IAEF,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC;IAIzC;;OAEG;IACH,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,cAAc,EACxB,KAAK,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACtC,IAAI;IAWP,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAI3E,aAAa,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACrB,IAAI;IAIP,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAI1E,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,IAAI;IAOP,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIjD,YAAY,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAMpD,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,SAAS,GAAE,cAAsB,GAChC,IAAI;IAQP,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIlD,WAAW,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQnD,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQhE,SAAS,IAAI,OAAO;IAIpB,SAAS;gBAtGC,SAAS,CAAC,CAAC,CAAC,EAAE;eACf,MAAM;;IA2Gf,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY3C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B,UAAU,IAAI,MAAM,EAAE;IAItB,SAAS,IAAI,KAAK,EAAE;IAIpB,aAAa,IAAI,UAAU;IAI3B,UAAU,IAAI,OAAO;IAIrB,SAAS,IAAI,OAAO;IAIpB,aAAa,IAAI,OAAO;IAMxB,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC;IAQpB,MAAM;;;;;oBAhKI,SAAS,CAAC,CAAC,CAAC,EAAE;mBACf,MAAM;;;IAwKf,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACjB,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,GAAG,QAAQ,CAAC,CAAC,CAAC;IAUf,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;CAsEnE"}