@schorts/shared-kernel 8.11.0 → 9.0.0-beta.0

package/README.md

@@ -14,7 +14,6 @@ npm install @schorts/shared-kernel --save
 
 - **AuthProvider:** Abstract interface for authentication strategies.
 - **IdentityProvider:** Contract for external identity services (e.g., Firebase, Auth0, Cognito). Defines methods for registering users, authenticating credentials, verifying tokens, and retrieving user profiles in a vendor‑agnostic way.
-- **RequireAuthDecorator:** Method-level decorator for enforcing authentication.
 
 ### 🛡️ RBAC (Role-Based Access Control)
 - **RBACPolicy:** Abstract base class for defining role-based permission logic. Supports wildcard actions (manage) and resources (*), ownership checks, and composable access control strategies.

package/dist/cjs/aggregates/aggregate-root.js

@@ -4,19 +4,69 @@ exports.AggregateRoot = void 0;
 class AggregateRoot {
     id;
     domainEvents = [];
-    constructor(id) {
+    _version = 0;
+    _uncommittedChanges = false;
+    constructor(id, version = 0) {
         this.id = id;
+        this._version = version;
+    }
+    get version() {
+        return this._version;
+    }
+    incrementVersion() {
+        this._version++;
+        this._uncommittedChanges = true;
+    }
+    get hasUncommittedChanges() {
+        return this._uncommittedChanges;
+    }
+    markChangesCommitted() {
+        this._uncommittedChanges = false;
     }
     pullDomainEvents() {
-        const domainEvents = [...this.domainEvents];
+        const domainEvents = this.domainEvents.map((event, index) => {
+            const sequencedEvent = Object.assign(event, {
+                sequenceNumber: this._version - this.domainEvents.length + index + 1,
+            });
+            return sequencedEvent;
+        });
         this.domainEvents = [];
         return domainEvents;
     }
     recordDomainEvent(domainEvent) {
         this.domainEvents.push(domainEvent);
+        this.incrementVersion();
+    }
+    equals(other) {
+        return this.id.equals(other.id);
+    }
+    validateInvariants() { }
+    validate() {
+        this.validateInvariants();
+    }
+    static fromPrimitives(model) {
+        const { id, version = 0, ...data } = model;
+        const instance = new this(id, version);
+        if (instance.restoreFromPrimitives) {
+            instance.restoreFromPrimitives(data);
+        }
+        return instance;
+    }
+    restoreFromPrimitives(_data) { }
+    toSnapshot() {
+        return {
+            id: this.id,
+            version: this._version,
+            data: this.toPrimitives(),
+        };
     }
-    static fromPrimitives(_model) {
-        throw new Error("AggregateRoot reconstruction not implemented.");
+    static fromSnapshot(snapshot) {
+        const instance = new this(snapshot.id, snapshot.version);
+        if (instance.restoreFromPrimitives) {
+            instance.restoreFromPrimitives(snapshot.data);
+        }
+        instance.markChangesCommitted();
+        return instance;
     }
 }
 exports.AggregateRoot = AggregateRoot;

package/dist/cjs/aggregates/aggregate-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-root.js","sourceRoot":"","sources":["../../../src/aggregates/aggregate-root.ts"],"names":[],"mappings":";;;AAGA,MAAsB,aAAa;IAGZ;IAFb,YAAY,GAAuB,EAAE,CAAC;IAE9C,YAAqB,EAAW;QAAX,OAAE,GAAF,EAAE,CAAS;IAAG,CAAC;IAEpC,gBAAgB;QACd,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAEvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,iBAAiB,CAAC,WAAwB;QACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAID,MAAM,CAAC,cAAc,CAAoC,MAAa;QACpE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;CACF;AArBD,sCAqBC"}
+{"version":3,"file":"aggregate-root.js","sourceRoot":"","sources":["../../../src/aggregates/aggregate-root.ts"],"names":[],"mappings":";;;AAGA,MAAsB,aAAa;IAKZ;IAJb,YAAY,GAAuB,EAAE,CAAC;IACtC,QAAQ,GAAW,CAAC,CAAC;IACrB,mBAAmB,GAAY,KAAK,CAAC;IAE7C,YAAqB,EAAW,EAAE,UAAkB,CAAC;QAAhC,OAAE,GAAF,EAAE,CAAS;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAES,gBAAgB;QACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAClC,CAAC;IAED,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,oBAAoB;QAClB,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC;IACnC,CAAC;IAED,gBAAgB;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC1D,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC1C,cAAc,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC;aACrE,CAAC,CAAC;YACH,OAAO,cAAc,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAEvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,iBAAiB,CAAC,WAAwB;QACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAA6B;QAClC,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAES,kBAAkB,KAAU,CAAC;IAE7B,QAAQ;QAChB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAID,MAAM,CAAC,cAAc,CAEnB,KAA4C;QAE5C,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAEvC,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;YAClC,QAAgB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAES,qBAAqB,CAAE,KAA0B,IAAS,CAAC;IAErE,UAAU;QACR,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAEjB,QAAiE;QAEjE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;YAClC,QAAgB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA5FD,sCA4FC"}

package/dist/cjs/auth/exceptions/authentication-error.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticationError = void 0;
+/**
+ * Error thrown when authentication fails
+ */
+class AuthenticationError extends Error {
+    code;
+    details;
+    constructor(message, code = "AUTHENTICATION_FAILED", details) {
+        super(message);
+        this.name = "AuthenticationError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+//# sourceMappingURL=authentication-error.js.map

package/dist/cjs/auth/exceptions/authentication-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication-error.js","sourceRoot":"","sources":["../../../../src/auth/exceptions/authentication-error.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAAS;IACb,OAAO,CAAkC;IAElD,YACE,OAAe,EACf,OAAe,uBAAuB,EACtC,OAA6B;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAdD,kDAcC"}

package/dist/cjs/auth/exceptions/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequireAuthNotImplementedCorrectly = exports.NotAuthenticated = void 0;
+exports.AuthenticationError = exports.RequireAuthNotImplementedCorrectly = exports.NotAuthenticated = void 0;
 var not_authenticated_1 = require("./not-authenticated");
 Object.defineProperty(exports, "NotAuthenticated", { enumerable: true, get: function () { return not_authenticated_1.NotAuthenticated; } });
 var require_auth_not_implemented_correctly_1 = require("./require-auth-not-implemented-correctly");
 Object.defineProperty(exports, "RequireAuthNotImplementedCorrectly", { enumerable: true, get: function () { return require_auth_not_implemented_correctly_1.RequireAuthNotImplementedCorrectly; } });
+var authentication_error_1 = require("./authentication-error");
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return authentication_error_1.AuthenticationError; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/auth/exceptions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/auth/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,mGAA8F;AAArF,4JAAA,kCAAkC,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/auth/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,mGAA8F;AAArF,4JAAA,kCAAkC,OAAA;AAC3C,+DAA6D;AAApD,2HAAA,mBAAmB,OAAA"}

package/dist/cjs/auth/index.js

@@ -14,8 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequireAuth = void 0;
-var require_auth_decorator_1 = require("./require-auth.decorator");
-Object.defineProperty(exports, "RequireAuth", { enumerable: true, get: function () { return require_auth_decorator_1.RequireAuth; } });
 __exportStar(require("./exceptions"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,mEAAuD;AAA9C,qHAAA,WAAW,OAAA;AACpB,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,+CAA6B"}

package/dist/cjs/converters/exceptions/conversion-error.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversionError = void 0;
+class ConversionError extends Error {
+    code;
+    details;
+    constructor(message, code = "CONVERSION_FAILED", details) {
+        super(message);
+        this.name = "ConversionError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.ConversionError = ConversionError;
+//# sourceMappingURL=conversion-error.js.map

package/dist/cjs/converters/exceptions/conversion-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-error.js","sourceRoot":"","sources":["../../../../src/converters/exceptions/conversion-error.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,OAAO,CAAkC;IAElD,YACE,OAAe,EACf,OAAe,mBAAmB,EAClC,OAA6B;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAdD,0CAcC"}

package/dist/cjs/converters/exceptions/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversionError = void 0;
+var conversion_error_1 = require("./conversion-error");
+Object.defineProperty(exports, "ConversionError", { enumerable: true, get: function () { return conversion_error_1.ConversionError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/converters/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/converters/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA"}

package/dist/cjs/converters/index.js

@@ -1,6 +1,21 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoteFileToBase64 = void 0;
 var remote_file_to_base64_1 = require("./remote-file-to-base64");
 Object.defineProperty(exports, "RemoteFileToBase64", { enumerable: true, get: function () { return remote_file_to_base64_1.RemoteFileToBase64; } });
+__exportStar(require("./exceptions"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/converters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/converters/index.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/converters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA;AAE3B,+CAA6B"}

package/dist/cjs/converters/remote-file-to-base64.js

@@ -1,20 +1,125 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoteFileToBase64 = void 0;
+const exceptions_1 = require("./exceptions");
 class RemoteFileToBase64 {
     httpProvider;
+    conversionCache = new Map();
+    DEFAULT_MAX_SIZE = 10 * 1024 * 1024;
     constructor(httpProvider) {
         this.httpProvider = httpProvider;
     }
-    async convert(url) {
-        const blob = await this.httpProvider.get(url);
+    async convert(url, options = {}) {
+        const { maxSize = this.DEFAULT_MAX_SIZE, signal = undefined, cache = false, expectedMimeTypes = undefined, timeout = undefined, } = options;
+        const cacheKey = url.toString();
+        if (cache && this.conversionCache.has(cacheKey)) {
+            return { ...this.conversionCache.get(cacheKey), cached: true };
+        }
+        if (signal?.aborted) {
+            throw new exceptions_1.ConversionError("Conversion aborted before starting", "CONVERSION_ABORTED");
+        }
+        try {
+            let timeoutId;
+            const timeoutPromise = timeout
+                ? new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        reject(new exceptions_1.ConversionError(`Conversion timeout after ${timeout}ms`, "CONVERSION_TIMEOUT"));
+                    }, timeout);
+                })
+                : null;
+            const blobPromise = this.httpProvider.get(url);
+            const blob = timeoutPromise
+                ? await Promise.race([blobPromise, timeoutPromise])
+                : await blobPromise;
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (!(blob instanceof Blob)) {
+                throw new exceptions_1.ConversionError("Response is not a valid Blob", "INVALID_BLOB", { receivedType: typeof blob });
+            }
+            if (blob.size > maxSize) {
+                throw new exceptions_1.ConversionError(`File size (${blob.size} bytes) exceeds maximum allowed (${maxSize} bytes)`, "FILE_TOO_LARGE", { fileSize: blob.size, maxSize });
+            }
+            if (expectedMimeTypes && expectedMimeTypes.length > 0) {
+                const mimeType = blob.type || "application/octet-stream";
+                const isValidMime = expectedMimeTypes.some(expected => this.mimeTypeMatches(mimeType, expected));
+                if (!isValidMime) {
+                    throw new exceptions_1.ConversionError(`MIME type '${blob.type}' not in expected types: ${expectedMimeTypes.join(", ")}`, "INVALID_MIME_TYPE", { receivedMimeType: blob.type, expectedMimeTypes });
+                }
+            }
+            const base64 = await this.blobToBase64(blob, signal);
+            const result = {
+                base64,
+                mimeType: blob.type || "application/octet-stream",
+                size: blob.size,
+                cached: false,
+            };
+            if (cache) {
+                this.conversionCache.set(cacheKey, result);
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new exceptions_1.ConversionError("Conversion aborted", "CONVERSION_ABORTED");
+            }
+            if (error instanceof exceptions_1.ConversionError) {
+                throw error;
+            }
+            throw new exceptions_1.ConversionError(`Failed to convert remote file: ${error instanceof Error ? error.message : String(error)}`, "CONVERSION_FAILED", { originalError: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    clearCache() {
+        this.conversionCache.clear();
+    }
+    getCacheSize() {
+        return this.conversionCache.size;
+    }
+    removeCacheEntry(url) {
+        return this.conversionCache.delete(url.toString());
+    }
+    blobToBase64(blob, signal) {
         return new Promise((resolve, reject) => {
             const reader = new FileReader();
+            const abortListener = () => {
+                reader.abort();
+                reject(new DOMException("Aborted", "AbortError"));
+            };
+            if (signal) {
+                signal.addEventListener("abort", abortListener);
+            }
             reader.readAsDataURL(blob);
-            reader.onload = () => resolve(reader.result);
-            reader.onerror = (error) => reject(error);
+            reader.onload = () => {
+                if (signal) {
+                    signal.removeEventListener("abort", abortListener);
+                }
+                resolve(reader.result);
+            };
+            reader.onerror = () => {
+                if (signal) {
+                    signal.removeEventListener("abort", abortListener);
+                }
+                reject(new exceptions_1.ConversionError("FileReader failed to read blob", "FILEREADER_ERROR", { error: reader.error?.message }));
+            };
+            reader.onabort = () => {
+                if (signal) {
+                    signal.removeEventListener("abort", abortListener);
+                }
+                reject(new DOMException("Aborted", "AbortError"));
+            };
         });
     }
+    mimeTypeMatches(actual, expected) {
+        if (expected === "*/*")
+            return true;
+        if (actual === expected)
+            return true;
+        const [expectedType, expectedSubtype] = expected.split("/");
+        const [actualType] = actual.split("/");
+        if (expectedSubtype === "*") {
+            return actualType === expectedType;
+        }
+        return false;
+    }
 }
 exports.RemoteFileToBase64 = RemoteFileToBase64;
 //# sourceMappingURL=remote-file-to-base64.js.map

package/dist/cjs/converters/remote-file-to-base64.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-file-to-base64.js","sourceRoot":"","sources":["../../../src/converters/remote-file-to-base64.ts"],"names":[],"mappings":";;;AAEA,MAAa,kBAAkB;IAEV;IADnB,YACmB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAO,GAAG,CAAC,CAAC;QAEpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAEhC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAgB,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAhBD,gDAgBC"}
+{"version":3,"file":"remote-file-to-base64.js","sourceRoot":"","sources":["../../../src/converters/remote-file-to-base64.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cqrs/command-handler.js

@@ -1,3 +1,111 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractCommandHandler = void 0;
+const exceptions_1 = require("./exceptions");
+class AbstractCommandHandler {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            logging: false,
+            metrics: false,
+            maxRetries: 0,
+            idempotent: false,
+            publishEvents: false,
+            ...options,
+        };
+    }
+    async handle(command, context) {
+        const startTime = new Date();
+        const correlationId = command.getMetadata().correlationId;
+        const handlerContext = {
+            metadata: command.getMetadata.bind(command),
+            options: this.options,
+            startTime,
+            correlationId,
+            events: [],
+            ...context,
+        };
+        let lastError = null;
+        let retryCount = 0;
+        while (retryCount <= (this.options.maxRetries ?? 0)) {
+            try {
+                await this.validate(command);
+                await this.authorize(command);
+                if (this.options.idempotent) {
+                    const idempotencyKey = this.getIdempotencyKey?.(command);
+                    if (idempotencyKey) {
+                        // TODO: Check if command was already processed
+                    }
+                }
+                const result = await this.execute(command, handlerContext);
+                if (this.options.idempotent) {
+                    const idempotencyKey = this.getIdempotencyKey?.(command);
+                    if (idempotencyKey) {
+                        // TODO: Store execution result
+                    }
+                }
+                if (this.options.logging) {
+                    this.logCommand(command, result, startTime);
+                }
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                if (retryCount < (this.options.maxRetries ?? 0) && this.canRetry?.(command, lastError)) {
+                    retryCount++;
+                    if (this.options.logging) {
+                        console.warn(`[CommandHandler] ${command.getType()} retry attempt ${retryCount}`, {
+                            correlationId,
+                            error: lastError instanceof Error ? lastError.message : String(lastError),
+                        });
+                    }
+                    continue;
+                }
+                if (retryCount > 0 && retryCount >= (this.options.maxRetries ?? 0)) {
+                    if (this.options.logging) {
+                        this.logError(command, lastError, startTime);
+                    }
+                    throw new exceptions_1.CommandMaxRetriesExceeded(`Command execution failed after ${retryCount} retries`, retryCount, lastError);
+                }
+                if (this.options.logging) {
+                    this.logError(command, lastError, startTime);
+                }
+                if (lastError instanceof exceptions_1.CommandValidationError ||
+                    lastError instanceof exceptions_1.CommandAuthorizationError ||
+                    lastError instanceof exceptions_1.CommandExecutionError) {
+                    throw lastError;
+                }
+                throw new exceptions_1.CommandExecutionError(`Command execution failed: ${lastError instanceof Error ? lastError.message : String(lastError)}`, "COMMAND_EXECUTION_FAILED", { originalError: lastError });
+            }
+        }
+        throw lastError || new exceptions_1.CommandExecutionError("Command execution failed with unknown error", "COMMAND_EXECUTION_FAILED");
+    }
+    getOptions() {
+        return this.options;
+    }
+    async validate(_) { }
+    async authorize(_) { }
+    getIdempotencyKey(command) {
+        return `${command.getType()}:${JSON.stringify(command.toPrimitives?.() ?? {})}`;
+    }
+    canRetry(_, error) {
+        return error instanceof exceptions_1.CommandExecutionError;
+    }
+    logCommand(command, result, startTime) {
+        const duration = Date.now() - startTime.getTime();
+        console.log(`[CommandHandler] ${command.getType()} completed in ${duration}ms`, {
+            correlationId: command.getMetadata().correlationId,
+            userId: command.getMetadata().userId,
+        });
+    }
+    logError(command, error, startTime) {
+        const duration = Date.now() - startTime.getTime();
+        console.error(`[CommandHandler] ${command.getType()} failed after ${duration}ms`, {
+            correlationId: command.getMetadata().correlationId,
+            userId: command.getMetadata().userId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+exports.AbstractCommandHandler = AbstractCommandHandler;
 //# sourceMappingURL=command-handler.js.map

package/dist/cjs/cqrs/command-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../../src/cqrs/command-handler.ts"],"names":[],"mappings":""}
+{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../../src/cqrs/command-handler.ts"],"names":[],"mappings":";;;AAEA,6CAKsB;AAuCtB,MAAsB,sBAAsB;IAGvB,OAAO,CAAwB;IAElD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG;YACb,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,KAAK;YACpB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAU,EAAE,OAA+B;QACtD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,aAAa,CAAC;QAC1D,MAAM,cAAc,GAA0B;YAC5C,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;YAC3C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS;YACT,aAAa;YACb,MAAM,EAAE,EAAE;YACV,GAAG,OAAO;SACX,CAAC;QACF,IAAI,SAAS,GAAiB,IAAI,CAAC;QACnC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,OAAO,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAE9B,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;oBAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC;oBACzD,IAAI,cAAc,EAAE,CAAC;wBACnB,+CAA+C;oBACjD,CAAC;gBACH,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBAE3D,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;oBAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC;oBAEzD,IAAI,cAAc,EAAE,CAAC;wBACnB,+BAA+B;oBACjC,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACzB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC9C,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAc,CAAC;gBAE3B,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;oBACvF,UAAU,EAAE,CAAC;oBAEb,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;wBACzB,OAAO,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,kBAAkB,UAAU,EAAE,EAAE;4BAChF,aAAa;4BACb,KAAK,EAAE,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;yBAC1E,CAAC,CAAC;oBACL,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC;oBACnE,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;wBACzB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;oBAC/C,CAAC;oBAED,MAAM,IAAI,sCAAyB,CACjC,kCAAkC,UAAU,UAAU,EACtD,UAAU,EACV,SAAS,CACV,CAAC;gBACJ,CAAC;gBAED,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACzB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC/C,CAAC;gBAED,IAAI,SAAS,YAAY,mCAAsB;oBAC3C,SAAS,YAAY,sCAAyB;oBAC9C,SAAS,YAAY,kCAAqB,EAAE,CAAC;oBAC/C,MAAM,SAAS,CAAC;gBAClB,CAAC;gBAED,MAAM,IAAI,kCAAqB,CAC7B,6BAA6B,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EACjG,0BAA0B,EAC1B,EAAE,aAAa,EAAE,SAAS,EAAE,CAC7B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,kCAAqB,CAC1C,6CAA6C,EAC7C,0BAA0B,CAC3B,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,CAAI,IAAkB,CAAC;IAEtC,KAAK,CAAC,SAAS,CAAC,CAAI,IAAkB,CAAC;IAI9C,iBAAiB,CAAC,OAAU;QAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,QAAQ,CAAC,CAAI,EAAE,KAAY;QACzB,OAAO,KAAK,YAAY,kCAAqB,CAAC;IAChD,CAAC;IAEO,UAAU,CAAC,OAAU,EAAE,MAAS,EAAE,SAAe;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,iBAAiB,QAAQ,IAAI,EAAE;YAC9E,aAAa,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,aAAa;YAClD,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM;SACrC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,OAAU,EAAE,KAAU,EAAE,SAAe;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAElD,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,iBAAiB,QAAQ,IAAI,EAAE;YAChF,aAAa,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,aAAa;YAClD,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM;YACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;CACF;AA/ID,wDA+IC"}

package/dist/cjs/cqrs/command-metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-metadata.js.map

package/dist/cjs/cqrs/command-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-metadata.js","sourceRoot":"","sources":["../../../src/cqrs/command-metadata.ts"],"names":[],"mappings":""}

package/dist/cjs/cqrs/command.js

@@ -1,3 +1,66 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractCommand = void 0;
+class AbstractCommand {
+    metadata;
+    constructor(correlationId, customMetadata) {
+        const generateId = () => `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        this.metadata = {
+            id: customMetadata?.id ?? generateId(),
+            createdAt: customMetadata?.createdAt ?? new Date(),
+            correlationId: customMetadata?.correlationId ?? correlationId,
+            causationId: customMetadata?.causationId,
+            requestId: customMetadata?.requestId,
+            version: customMetadata?.version ?? 1,
+            userId: customMetadata?.userId,
+            tenantId: customMetadata?.tenantId,
+            headers: customMetadata?.headers,
+            context: customMetadata?.context,
+        };
+    }
+    getMetadata() {
+        return this.metadata;
+    }
+    toPrimitives() {
+        return {
+            id: this.metadata.id,
+            type: this.getType(),
+            created_at: this.metadata.createdAt.toISOString(),
+            correlation_id: this.metadata.correlationId,
+            causation_id: this.metadata.causationId,
+            request_id: this.metadata.requestId,
+            version: this.metadata.version,
+            user_id: this.metadata.userId,
+            tenant_id: this.metadata.tenantId,
+            payload: {},
+            headers: this.metadata.headers,
+            context: this.metadata.context,
+        };
+    }
+    setCorrelationId(correlationId) {
+        this.metadata.correlationId = correlationId;
+    }
+    setCausationId(causationId) {
+        this.metadata.causationId = causationId;
+    }
+    setUserId(userId) {
+        this.metadata.userId = userId;
+    }
+    setTenantId(tenantId) {
+        this.metadata.tenantId = tenantId;
+    }
+    addHeaders(headers) {
+        this.metadata.headers = {
+            ...(this.metadata.headers ?? {}),
+            ...headers,
+        };
+    }
+    addContext(key, value) {
+        this.metadata.context = {
+            ...(this.metadata.context ?? {}),
+            [key]: value,
+        };
+    }
+}
+exports.AbstractCommand = AbstractCommand;
 //# sourceMappingURL=command.js.map

package/dist/cjs/cqrs/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/cqrs/command.ts"],"names":[],"mappings":""}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/cqrs/command.ts"],"names":[],"mappings":";;;AAUA,MAAsB,eAAe;IAChB,QAAQ,CAAkB;IAE7C,YAAY,aAAqB,EAAE,cAAyC;QAC1E,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAE7D,IAAI,CAAC,QAAQ,GAAG;YACd,EAAE,EAAE,cAAc,EAAE,EAAE,IAAI,UAAU,EAAE;YACtC,SAAS,EAAE,cAAc,EAAE,SAAS,IAAI,IAAI,IAAI,EAAE;YAClD,aAAa,EACX,cAAc,EAAE,aAAa,IAAI,aAAa;YAChD,WAAW,EAAE,cAAc,EAAE,WAAW;YACxC,SAAS,EAAE,cAAc,EAAE,SAAS;YACpC,OAAO,EAAE,cAAc,EAAE,OAAO,IAAI,CAAC;YACrC,MAAM,EAAE,cAAc,EAAE,MAAM;YAC9B,QAAQ,EAAE,cAAc,EAAE,QAAQ;YAClC,OAAO,EAAE,cAAc,EAAE,OAAO;YAChC,OAAO,EAAE,cAAc,EAAE,OAAO;SACjC,CAAC;IACJ,CAAC;IAID,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,YAAY;QACV,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACpB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;YACpB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE;YACjD,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;YAC3C,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;YACvC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;YACnC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YACjC,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SAC/B,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,aAAqB;QACnC,IAAI,CAAC,QAAgB,CAAC,aAAa,GAAG,aAAa,CAAC;IACvD,CAAC;IAED,cAAc,CAAC,WAAmB;QAC/B,IAAI,CAAC,QAAgB,CAAC,WAAW,GAAG,WAAW,CAAC;IACnD,CAAC;IAED,SAAS,CAAC,MAAc;QACrB,IAAI,CAAC,QAAgB,CAAC,MAAM,GAAG,MAAM,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,QAAgB;QACzB,IAAI,CAAC,QAAgB,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7C,CAAC;IAED,UAAU,CAAC,OAA+B;QACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG;YACtB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,KAAU;QAChC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG;YACtB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,CAAC,GAAG,CAAC,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;CACF;AA1ED,0CA0EC"}

package/dist/cjs/cqrs/exceptions/command-handler-errors.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandMaxRetriesExceeded = exports.CommandAlreadyProcessing = exports.CommandExecutionError = exports.CommandAuthorizationError = exports.CommandValidationError = void 0;
+class CommandValidationError extends Error {
+    code;
+    context;
+    constructor(message, code = "COMMAND_VALIDATION_ERROR", context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "CommandValidationError";
+        Object.setPrototypeOf(this, CommandValidationError.prototype);
+    }
+}
+exports.CommandValidationError = CommandValidationError;
+class CommandAuthorizationError extends Error {
+    code;
+    context;
+    constructor(message, code = "COMMAND_AUTHORIZATION_ERROR", context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "CommandAuthorizationError";
+        Object.setPrototypeOf(this, CommandAuthorizationError.prototype);
+    }
+}
+exports.CommandAuthorizationError = CommandAuthorizationError;
+class CommandExecutionError extends Error {
+    code;
+    context;
+    constructor(message, code = "COMMAND_EXECUTION_ERROR", context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "CommandExecutionError";
+        Object.setPrototypeOf(this, CommandExecutionError.prototype);
+    }
+}
+exports.CommandExecutionError = CommandExecutionError;
+class CommandAlreadyProcessing extends Error {
+    idempotencyKey;
+    code;
+    constructor(message, idempotencyKey, code = "COMMAND_ALREADY_PROCESSING") {
+        super(message);
+        this.idempotencyKey = idempotencyKey;
+        this.code = code;
+        this.name = "CommandAlreadyProcessing";
+        Object.setPrototypeOf(this, CommandAlreadyProcessing.prototype);
+    }
+}
+exports.CommandAlreadyProcessing = CommandAlreadyProcessing;
+class CommandMaxRetriesExceeded extends Error {
+    retryCount;
+    lastError;
+    code;
+    constructor(message, retryCount, lastError, code = "COMMAND_MAX_RETRIES_EXCEEDED") {
+        super(message);
+        this.retryCount = retryCount;
+        this.lastError = lastError;
+        this.code = code;
+        this.name = "CommandMaxRetriesExceeded";
+        Object.setPrototypeOf(this, CommandMaxRetriesExceeded.prototype);
+    }
+}
+exports.CommandMaxRetriesExceeded = CommandMaxRetriesExceeded;
+//# sourceMappingURL=command-handler-errors.js.map

package/dist/cjs/cqrs/exceptions/command-handler-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler-errors.js","sourceRoot":"","sources":["../../../../src/cqrs/exceptions/command-handler-errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,sBAAuB,SAAQ,KAAK;IAG7B;IACA;IAHlB,YACE,OAAe,EACC,OAAe,0BAA0B,EACzC,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAqC;QACzC,YAAO,GAAP,OAAO,CAAsB;QAI7C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QAErC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAZD,wDAYC;AAED,MAAa,yBAA0B,SAAQ,KAAK;IAGhC;IACA;IAHlB,YACE,OAAe,EACC,OAAe,6BAA6B,EAC5C,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAwC;QAC5C,YAAO,GAAP,OAAO,CAAsB;QAI7C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QAExC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF;AAZD,8DAYC;AAED,MAAa,qBAAsB,SAAQ,KAAK;IAG5B;IACA;IAHlB,YACE,OAAe,EACC,OAAe,yBAAyB,EACxC,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAoC;QACxC,YAAO,GAAP,OAAO,CAAsB;QAI7C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QAEpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAZD,sDAYC;AAED,MAAa,wBAAyB,SAAQ,KAAK;IAG/B;IACA;IAHlB,YACE,OAAe,EACC,cAAsB,EACtB,OAAe,4BAA4B;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,mBAAc,GAAd,cAAc,CAAQ;QACtB,SAAI,GAAJ,IAAI,CAAuC;QAI3D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QAEvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAZD,4DAYC;AAED,MAAa,yBAA0B,SAAQ,KAAK;IAGhC;IACA;IACA;IAJlB,YACE,OAAe,EACC,UAAkB,EAClB,SAAgB,EAChB,OAAe,8BAA8B;QAE7D,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAO;QAChB,SAAI,GAAJ,IAAI,CAAyC;QAI7D,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QAExC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF;AAbD,8DAaC"}