@elsikora/nestjs-crud-automator 1.18.0-dev.1 → 1.19.0-dev.1

package/dist/esm/utility/api/controller/write-dto-swagger.utility.js

@@ -20,15 +20,18 @@ import { CamelCaseString } from '../../camel-case-string.utility.js';
 import '../../../constant/utility/dto/constant.js';
 import '@nestjs/swagger';
 import '../../../external/tslib/tslib.es6.js';
+import '../../../class/utility/dto/exception/details/foreign-key-violation.class.js';
+import '../../../class/utility/dto/exception/details/unique-violation.class.js';
 import '@nestjs/common';
 import 'class-transformer';
 import 'class-validator';
 import 'lodash/random';
+import '../../../validator/must-match-one-of-schemas.validator.js';
 import '../../../constant/interface/api/property/default-string-format.constant.js';
 import '../../../validator/is-regular-expression.validator.js';
 import 'node:crypto';
+import '../../../enum/utility/exception-details/type.enum.js';
 import '../../../enum/filter-operation.enum.js';
-import '../../../validator/must-match-one-of-schemas.validator.js';
 import { DtoGenerate } from '../../dto/generate.utility.js';
 import '../../../enum/filter-order-direction.enum.js';
 import 'typeorm';

package/dist/esm/utility/api/controller/write-dto-swagger.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-dto-swagger.utility.js","sources":["../../../../../../src/utility/api/controller/write-dto-swagger.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA;;;;;;;;;;;;AAYG;AACG,SAAU,4BAA4B,CAAI,MAAc,EAAE,MAAqB,EAAE,UAAuC,EAAE,MAAqB,EAAE,WAA4D,EAAE,cAA6B,EAAA;AACjP,IAAA,MAAM,aAAa,IAAoB,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAmB;AAExH,IAAA,MAAM,UAAU,GAA8B,WAAW,CAAC,GAAG,EAAE,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AAC5N,IAAA,MAAM,QAAQ,GAA8B,WAAW,CAAC,GAAG,EAAE,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AACpN,IAAA,MAAM,OAAO,GAA8B,WAAW,CAAC,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;AAChN,IAAA,MAAM,WAAW,GAA8B,WAAW,CAAC,GAAG,EAAE,QAAQ,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;IAEhO,MAAM,OAAO,GAAqC,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC;AAE9F,IAAA,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;QAC1B,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AACxC,YAAA,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;AAEvB,YAAA,MAAM,OAAO,GAAoB,eAAe,CAAC,WAAW,EAAE;AAE9D,YAAA,MAAM,QAAQ,GAA0B,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,IAAI,iBAAiB,CAAC;AAErG,YAAA,IAAI,QAAQ;gBACX,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;AACxC,oBAAA,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,wCAAwC,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,wCAAwC,CAAC,YAAY,CAAC,EAAE,IAAI,KAAK,wBAAwB,CAAC,QAAQ,EAAE;wBACjM,MAAM,aAAa,GAA4C,MAAM,YAAY,CAAA;AAChF,4BAAA,WAAA,GAAA;AACC,gCAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;;AAEjC,oCAAA,YAAY,EAAE,IAAI;;AAElB,oCAAA,UAAU,EAAE,IAAI;AAChB,oCAAA,KAAK,EAAE,SAAS;;AAEhB,oCAAA,QAAQ,EAAE,IAAI;AACd,iCAAA,CAAC;4BACH;yBACA;AAED,wBAAA,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE;4BAC5C,KAAK,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA,EAAG,eAAe,CAAC,MAAM,CAAC,CAAA,EAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA,EAAG,GAAG,CAAA,GAAA,CAAK;AAC9G,yBAAA,CAAC;AAEF,wBAAA,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC;oBAClC;gBACD;YAED,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,gBAAgB,EAAE,aAAa,EAAE,MAAM,CAAC;QAC3E;IACD;AACD;;;;"}
+{"version":3,"file":"write-dto-swagger.utility.js","sources":["../../../../../../src/utility/api/controller/write-dto-swagger.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/api/filter-order-by-from-entity.utility.js

@@ -32,7 +32,7 @@ function FilterOrderByFromEntity(entity, entityMetadata, method, dtoType, fieldS
     const accumulator = {};
     for (const column of columns) {
         const columnType = column.options?.type || Reflect.getMetadata("design:type", entity.prototype, column.propertyName);
-        const isAllowedType = (typeof columnType === "function" && (columnType === String || columnType === Number || columnType === Date)) || (FILTER_API_INTERFACE_CONSTANT.ALLOWED_ENTITY_TO_FILTER_COLUMNS.includes(columnType) && (fieldSelector === undefined || fieldSelector[column.propertyName] !== false));
+        const isAllowedType = (typeof columnType === "function" && (columnType === String || columnType === Number || columnType === Date)) || (FILTER_API_INTERFACE_CONSTANT.ALLOWED_ENTITY_TO_FILTER_COLUMNS.includes(columnType) && fieldSelector?.[column.propertyName] !== false);
         if (isAllowedType) {
             for (const metadataColumn of entityMetadata.columns) {
                 const metadata = metadataColumn.metadata?.[PROPERTY_DESCRIBE_DECORATOR_API_CONSTANT.METADATA_KEY];

package/dist/esm/utility/api/filter-order-by-from-entity.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter-order-by-from-entity.utility.js","sources":["../../../../../src/utility/api/filter-order-by-from-entity.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAeA;;;;;;;;;;;;AAYG;AACG,SAAU,uBAAuB,CAAI,MAAqB,EAAE,cAA6B,EAAE,MAAqB,EAAE,OAAoB,EAAE,aAAmD,EAAA;AAChM,IAAA,MAAM,QAAQ,GAAwB,sBAAsB,EAAE;AAC9D,IAAA,MAAM,OAAO,GAA8B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAA0B,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IAE3H,IAAI,aAAa,EAAE;AAClB,QAAA,MAAM,YAAY,GAAgB,IAAI,GAAG,CAAS,OAAO,CAAC,GAAG,CAAC,CAAC,GAAuB,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;AAE7G,QAAA,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE;YAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AAC7B,gBAAA,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAA,+BAAA,CAAiC,CAAC;YAClE;QACD;IACD;IAEA,MAAM,WAAW,GAAqC,EAAE;AAExD,IAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC7B,MAAM,UAAU,GAAmB,MAAM,CAAC,OAAO,EAAE,IAAsB,IAAK,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,SAAmB,EAAE,MAAM,CAAC,YAAY,CAAmB;QAEnL,MAAM,aAAa,GAAY,CAAC,OAAO,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,IAAI,CAAC,MAAM,6BAA6B,CAAC,gCAAgC,CAAC,QAAQ,CAAC,UAAoB,CAAC,KAAK,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,YAAmC,CAAC,KAAK,KAAK,CAAC,CAAC;QAEvV,IAAI,aAAa,EAAE;AAClB,YAAA,KAAK,MAAM,cAAc,IAAI,cAAc,CAAC,OAAO,EAAE;gBACpD,MAAM,QAAQ,GAA0H,cAAc,CAAC,QAAQ,GAAG,wCAAwC,CAAC,YAAY,CAA0H;AAEjV,gBAAA,MAAM,WAAW,GAAY,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,kBAAkB,KAAK,KAAK;AAEpG,gBAAA,IAAI,cAAc,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,IAAI,QAAQ,IAAI,WAAW,EAAE;AAC1E,oBAAA,MAAM,cAAc,GAAW,MAAM,CAAC;;yBAEpC,KAAK,CAAC,EAAE;AACR,yBAAA,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,KAAY;AAC5C,wBAAA,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE;4BAC5E,OAAO,GAAG,GAAG,IAAI;wBAClB;AAEA,wBAAA,OAAO,IAAI;AACZ,oBAAA,CAAC;yBACA,IAAI,CAAC,EAAE;AACP,yBAAA,WAAW,EAAE;AAEf,oBAAA,WAAW,CAAC,cAAwD,CAAC,GAAG,MAAM,CAAC,YAAY;gBAC5F;YACD;QACD;IACD;AAEA,IAAA,OAAO,WAAW;AACnB;;;;"}
+{"version":3,"file":"filter-order-by-from-entity.utility.js","sources":["../../../../../src/utility/api/filter-order-by-from-entity.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAeA;;;;;;;;;;;;AAYG;AACG,SAAU,uBAAuB,CAAI,MAAqB,EAAE,cAA6B,EAAE,MAAqB,EAAE,OAAoB,EAAE,aAAmD,EAAA;AAChM,IAAA,MAAM,QAAQ,GAAwB,sBAAsB,EAAE;AAC9D,IAAA,MAAM,OAAO,GAA8B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAA0B,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IAE3H,IAAI,aAAa,EAAE;AAClB,QAAA,MAAM,YAAY,GAAgB,IAAI,GAAG,CAAS,OAAO,CAAC,GAAG,CAAC,CAAC,GAAuB,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;AAE7G,QAAA,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE;YAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AAC7B,gBAAA,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAA,+BAAA,CAAiC,CAAC;YAClE;QACD;IACD;IAEA,MAAM,WAAW,GAAqC,EAAE;AAExD,IAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC7B,MAAM,UAAU,GAAmB,MAAM,CAAC,OAAO,EAAE,IAAsB,IAAK,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,SAAmB,EAAE,MAAM,CAAC,YAAY,CAAmB;AAEnL,QAAA,MAAM,aAAa,GAAY,CAAC,OAAO,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,IAAI,CAAC,MAAM,6BAA6B,CAAC,gCAAgC,CAAC,QAAQ,CAAC,UAAoB,CAAC,IAAI,aAAa,GAAG,MAAM,CAAC,YAAmC,CAAC,KAAK,KAAK,CAAC;QAExT,IAAI,aAAa,EAAE;AAClB,YAAA,KAAK,MAAM,cAAc,IAAI,cAAc,CAAC,OAAO,EAAE;gBACpD,MAAM,QAAQ,GAA0H,cAAc,CAAC,QAAQ,GAAG,wCAAwC,CAAC,YAAY,CAA0H;AAEjV,gBAAA,MAAM,WAAW,GAAY,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,kBAAkB,KAAK,KAAK;AAEpG,gBAAA,IAAI,cAAc,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,IAAI,QAAQ,IAAI,WAAW,EAAE;AAC1E,oBAAA,MAAM,cAAc,GAAW,MAAM,CAAC;;yBAEpC,KAAK,CAAC,EAAE;AACR,yBAAA,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,KAAY;AAC5C,wBAAA,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE;4BAC5E,OAAO,GAAG,GAAG,IAAI;wBAClB;AAEA,wBAAA,OAAO,IAAI;AACZ,oBAAA,CAAC;yBACA,IAAI,CAAC,EAAE;AACP,yBAAA,WAAW,EAAE;AAEf,oBAAA,WAAW,CAAC,cAAwD,CAAC,GAAG,MAAM,CAAC,YAAY;gBAC5F;YACD;QACD;IACD;AAEA,IAAA,OAAO,WAAW;AACnB;;;;"}

package/dist/esm/utility/database/index.d.ts

@@ -0,0 +1 @@
+export * from './typeorm/index';

package/dist/esm/utility/database/typeorm/get/foreign-key-violation-details.utility.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Extracts best-effort details from a TypeORM FOREIGN KEY violation (QueryFailedError).
+ * Works best with PostgreSQL (driverError.detail / driverError.constraint).
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {{ constraint?: string; detail?: string; field?: string; referencedField?: string; referencedTable?: string; table?: string; value?: string } | undefined}
+ * Foreign key violation details, when available.
+ */
+export declare function DatabaseTypeOrmGetForeignKeyViolationDetails(error: unknown): {
+    constraint?: string;
+    detail?: string;
+    field?: string;
+    referencedField?: string;
+    referencedTable?: string;
+    table?: string;
+    value?: string;
+} | undefined;

package/dist/esm/utility/database/typeorm/get/foreign-key-violation-details.utility.js

@@ -0,0 +1,103 @@
+import { QueryFailedError } from 'typeorm';
+
+const REGEX_GROUP_1_INDEX = 1;
+const REGEX_GROUP_2_INDEX = 2;
+const REGEX_GROUP_3_INDEX = 3;
+const MYSQL_CONSTRAINT_REGEX = /CONSTRAINT `([^`]+)`/;
+const MYSQL_FOREIGN_KEY_REGEX = /FOREIGN KEY \(`([^`]+)`\) REFERENCES `([^`]+)` \(`([^`]+)`\)/;
+const POSTGRES_FOREIGN_KEY_CONSTRAINT_REGEX = /foreign key constraint "([^"]+)"/;
+const POSTGRES_ON_TABLE_REGEX = /on table "([^"]+)"/;
+const POSTGRES_REFERENCED_REGEX = /Key \(([^)]+)\)=\(([^)]+)\) is still referenced from table "([^"]+)"/;
+const POSTGRES_REFERENCED_ROW_MISSING_REGEX = /Key \(([^)]+)\)=\(([^)]+)\) is not present in table "([^"]+)"/;
+/**
+ * Extracts best-effort details from a TypeORM FOREIGN KEY violation (QueryFailedError).
+ * Works best with PostgreSQL (driverError.detail / driverError.constraint).
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {{ constraint?: string; detail?: string; field?: string; referencedField?: string; referencedTable?: string; table?: string; value?: string } | undefined}
+ * Foreign key violation details, when available.
+ */
+function DatabaseTypeOrmGetForeignKeyViolationDetails(error) {
+    const isQueryFailedError = error instanceof QueryFailedError || (error != null && typeof error === "object" && error.name === "QueryFailedError");
+    if (!isQueryFailedError) {
+        return undefined;
+    }
+    let driverError;
+    if (error != null && typeof error === "object") {
+        const driverErrorUnknown = error.driverError;
+        if (driverErrorUnknown != null && typeof driverErrorUnknown === "object") {
+            driverError = driverErrorUnknown;
+        }
+    }
+    const constraintFromDriver = typeof driverError?.constraint === "string" ? driverError.constraint : undefined;
+    const detail = typeof driverError?.detail === "string" ? driverError.detail : undefined;
+    const tableFromDriver = typeof driverError?.table === "string" ? driverError.table : undefined;
+    const driverMessage = driverError?.message;
+    let message = "";
+    if (typeof driverMessage === "string") {
+        message = driverMessage;
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (error != null && typeof error === "object" && "message" in error) {
+        const objectMessage = error.message;
+        if (typeof objectMessage === "string") {
+            message = objectMessage;
+        }
+    }
+    let field;
+    let referencedField;
+    let referencedTable;
+    let value;
+    const detailOrMessage = detail ?? message;
+    const postgresMissingMatch = POSTGRES_REFERENCED_ROW_MISSING_REGEX.exec(detailOrMessage);
+    if (postgresMissingMatch) {
+        field = postgresMissingMatch[REGEX_GROUP_1_INDEX];
+        value = postgresMissingMatch[REGEX_GROUP_2_INDEX];
+        referencedTable = postgresMissingMatch[REGEX_GROUP_3_INDEX];
+    }
+    const postgresReferencedMatch = POSTGRES_REFERENCED_REGEX.exec(detailOrMessage);
+    if (postgresReferencedMatch) {
+        field ??= postgresReferencedMatch[REGEX_GROUP_1_INDEX];
+        value ??= postgresReferencedMatch[REGEX_GROUP_2_INDEX];
+        referencedTable ??= postgresReferencedMatch[REGEX_GROUP_3_INDEX];
+    }
+    const mysqlForeignKeyMatch = MYSQL_FOREIGN_KEY_REGEX.exec(detailOrMessage);
+    if (mysqlForeignKeyMatch) {
+        field ??= mysqlForeignKeyMatch[REGEX_GROUP_1_INDEX];
+        referencedTable ??= mysqlForeignKeyMatch[REGEX_GROUP_2_INDEX];
+        referencedField ??= mysqlForeignKeyMatch[REGEX_GROUP_3_INDEX];
+    }
+    let constraint = constraintFromDriver;
+    if (!constraint) {
+        const postgresConstraintMatch = POSTGRES_FOREIGN_KEY_CONSTRAINT_REGEX.exec(message);
+        if (postgresConstraintMatch) {
+            constraint = postgresConstraintMatch[REGEX_GROUP_1_INDEX];
+        }
+        else {
+            const mysqlConstraintMatch = MYSQL_CONSTRAINT_REGEX.exec(detailOrMessage);
+            if (mysqlConstraintMatch) {
+                constraint = mysqlConstraintMatch[REGEX_GROUP_1_INDEX];
+            }
+        }
+    }
+    let table = tableFromDriver;
+    if (!table) {
+        const postgresTableMatch = POSTGRES_ON_TABLE_REGEX.exec(message);
+        if (postgresTableMatch) {
+            table = postgresTableMatch[REGEX_GROUP_1_INDEX];
+        }
+    }
+    return {
+        constraint,
+        detail,
+        field,
+        referencedField,
+        referencedTable,
+        table,
+        value,
+    };
+}
+
+export { DatabaseTypeOrmGetForeignKeyViolationDetails };
+//# sourceMappingURL=foreign-key-violation-details.utility.js.map

package/dist/esm/utility/database/typeorm/get/foreign-key-violation-details.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-violation-details.utility.js","sources":["../../../../../../../src/utility/database/typeorm/get/foreign-key-violation-details.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/database/typeorm/get/index.d.ts

@@ -0,0 +1,2 @@
+export { DatabaseTypeOrmGetForeignKeyViolationDetails } from './foreign-key-violation-details.utility';
+export { DatabaseTypeOrmGetUniqueViolationDetails } from './unique-violation-details.utility';

package/dist/esm/utility/database/typeorm/get/unique-violation-details.utility.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Extracts best-effort details from a TypeORM UNIQUE constraint violation (QueryFailedError).
+ * Works best with PostgreSQL (driverError.detail / driverError.constraint).
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {{ constraint?: string; detail?: string; field?: string; table?: string; value?: string } | undefined}
+ * Unique violation details, when available.
+ */
+export declare function DatabaseTypeOrmGetUniqueViolationDetails(error: unknown): {
+    constraint?: string;
+    detail?: string;
+    field?: string;
+    table?: string;
+    value?: string;
+} | undefined;

package/dist/esm/utility/database/typeorm/get/unique-violation-details.utility.js

@@ -0,0 +1,88 @@
+import { QueryFailedError } from 'typeorm';
+
+const REGEX_GROUP_1_INDEX = 1;
+const REGEX_GROUP_2_INDEX = 2;
+const POSTGRES_UNIQUE_CONSTRAINT_REGEX = /unique constraint "([^"]+)"/;
+const POSTGRES_ON_TABLE_REGEX = /on table "([^"]+)"/;
+const POSTGRES_UNIQUE_DETAIL_REGEX = /Key \(([^)]+)\)=\(([^)]+)\) already exists\./;
+const MYSQL_DUPLICATE_ENTRY_REGEX = /Duplicate entry '([^']+)' for key '([^']+)'/;
+/**
+ * Extracts best-effort details from a TypeORM UNIQUE constraint violation (QueryFailedError).
+ * Works best with PostgreSQL (driverError.detail / driverError.constraint).
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {{ constraint?: string; detail?: string; field?: string; table?: string; value?: string } | undefined}
+ * Unique violation details, when available.
+ */
+function DatabaseTypeOrmGetUniqueViolationDetails(error) {
+    const isQueryFailedError = error instanceof QueryFailedError || (error != null && typeof error === "object" && error.name === "QueryFailedError");
+    if (!isQueryFailedError) {
+        return undefined;
+    }
+    let driverError;
+    if (error != null && typeof error === "object") {
+        const driverErrorUnknown = error.driverError;
+        if (driverErrorUnknown != null && typeof driverErrorUnknown === "object") {
+            driverError = driverErrorUnknown;
+        }
+    }
+    const constraintFromDriver = typeof driverError?.constraint === "string" ? driverError.constraint : undefined;
+    const detail = typeof driverError?.detail === "string" ? driverError.detail : undefined;
+    const tableFromDriver = typeof driverError?.table === "string" ? driverError.table : undefined;
+    const driverMessage = driverError?.message;
+    let message = "";
+    if (typeof driverMessage === "string") {
+        message = driverMessage;
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (error != null && typeof error === "object" && "message" in error) {
+        const objectMessage = error.message;
+        if (typeof objectMessage === "string") {
+            message = objectMessage;
+        }
+    }
+    const detailOrMessage = detail ?? message;
+    let field;
+    let value;
+    const postgresDetailMatch = POSTGRES_UNIQUE_DETAIL_REGEX.exec(detailOrMessage);
+    if (postgresDetailMatch) {
+        field = postgresDetailMatch[REGEX_GROUP_1_INDEX];
+        value = postgresDetailMatch[REGEX_GROUP_2_INDEX];
+    }
+    const mysqlDuplicateMatch = MYSQL_DUPLICATE_ENTRY_REGEX.exec(detailOrMessage);
+    if (mysqlDuplicateMatch) {
+        value ??= mysqlDuplicateMatch[REGEX_GROUP_1_INDEX];
+        const key = mysqlDuplicateMatch[REGEX_GROUP_2_INDEX];
+        if (key) {
+            // Key can be "table.column" or an index name. Best-effort: split by '.' and take the last segment.
+            const segments = key.split(".");
+            const last = segments.at(-1);
+            field ??= last;
+        }
+    }
+    let constraint = constraintFromDriver;
+    if (!constraint) {
+        const postgresConstraintMatch = POSTGRES_UNIQUE_CONSTRAINT_REGEX.exec(message);
+        if (postgresConstraintMatch) {
+            constraint = postgresConstraintMatch[REGEX_GROUP_1_INDEX];
+        }
+    }
+    let table = tableFromDriver;
+    if (!table) {
+        const postgresTableMatch = POSTGRES_ON_TABLE_REGEX.exec(message);
+        if (postgresTableMatch) {
+            table = postgresTableMatch[REGEX_GROUP_1_INDEX];
+        }
+    }
+    return {
+        constraint,
+        detail,
+        field,
+        table,
+        value,
+    };
+}
+
+export { DatabaseTypeOrmGetUniqueViolationDetails };
+//# sourceMappingURL=unique-violation-details.utility.js.map

package/dist/esm/utility/database/typeorm/get/unique-violation-details.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-violation-details.utility.js","sources":["../../../../../../../src/utility/database/typeorm/get/unique-violation-details.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/database/typeorm/index.d.ts

@@ -0,0 +1,6 @@
+export { DatabaseTypeOrmGetForeignKeyViolationDetails } from './get/foreign-key-violation-details.utility';
+export { DatabaseTypeOrmGetUniqueViolationDetails } from './get/unique-violation-details.utility';
+export { DatabaseTypeOrmIsEntityMetadataNotFound } from './is/entity/metadata-not-found.utility';
+export { DatabaseTypeOrmIsEntityNotFound } from './is/entity/not-found.utility';
+export { DatabaseTypeOrmIsForeignKeyViolation } from './is/foreign-key-violation.utility';
+export { DatabaseTypeOrmIsUniqueViolation } from './is/unique-violation.utility';

package/dist/esm/utility/database/typeorm/is/entity/index.d.ts

@@ -0,0 +1,2 @@
+export { DatabaseTypeOrmIsEntityMetadataNotFound } from './metadata-not-found.utility';
+export { DatabaseTypeOrmIsEntityNotFound } from './not-found.utility';

package/dist/esm/utility/database/typeorm/is/entity/metadata-not-found.utility.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Detects whether an error is a TypeORM EntityMetadataNotFoundError.
+ * This usually indicates that an entity was not registered in the current DataSource.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like EntityMetadataNotFoundError
+ */
+export declare function DatabaseTypeOrmIsEntityMetadataNotFound(error: unknown): boolean;

package/dist/esm/utility/database/typeorm/is/entity/metadata-not-found.utility.js

@@ -0,0 +1,25 @@
+import { EntityMetadataNotFoundError } from 'typeorm';
+
+/**
+ * Detects whether an error is a TypeORM EntityMetadataNotFoundError.
+ * This usually indicates that an entity was not registered in the current DataSource.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like EntityMetadataNotFoundError
+ */
+function DatabaseTypeOrmIsEntityMetadataNotFound(error) {
+    if (error instanceof EntityMetadataNotFoundError) {
+        return true;
+    }
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    const name = error.name;
+    if (name === "EntityMetadataNotFoundError") {
+        return true;
+    }
+    const message = error.message;
+    return typeof message === "string" && message.includes("No metadata for");
+}
+
+export { DatabaseTypeOrmIsEntityMetadataNotFound };
+//# sourceMappingURL=metadata-not-found.utility.js.map

package/dist/esm/utility/database/typeorm/is/entity/metadata-not-found.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-not-found.utility.js","sources":["../../../../../../../../src/utility/database/typeorm/is/entity/metadata-not-found.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACG,SAAU,uCAAuC,CAAC,KAAc,EAAA;AACrE,IAAA,IAAI,KAAK,YAAY,2BAA2B,EAAE;AACjD,QAAA,OAAO,IAAI;IACZ;IAEA,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AACxC,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,MAAM,IAAI,GAAa,KAA4B,CAAC,IAAI;AAExD,IAAA,IAAI,IAAI,KAAK,6BAA6B,EAAE;AAC3C,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,MAAM,OAAO,GAAa,KAA+B,CAAC,OAAO;IAEjE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;AAC1E;;;;"}

package/dist/esm/utility/database/typeorm/is/entity/not-found.utility.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Detects whether an error is a TypeORM EntityNotFoundError.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like EntityNotFoundError
+ */
+export declare function DatabaseTypeOrmIsEntityNotFound(error: unknown): boolean;

package/dist/esm/utility/database/typeorm/is/entity/not-found.utility.js

@@ -0,0 +1,24 @@
+import { EntityNotFoundError } from 'typeorm';
+
+/**
+ * Detects whether an error is a TypeORM EntityNotFoundError.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like EntityNotFoundError
+ */
+function DatabaseTypeOrmIsEntityNotFound(error) {
+    if (error instanceof EntityNotFoundError) {
+        return true;
+    }
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    const name = error.name;
+    if (name === "EntityNotFoundError") {
+        return true;
+    }
+    const message = error.message;
+    return typeof message === "string" && message.includes("Could not find any entity of type");
+}
+
+export { DatabaseTypeOrmIsEntityNotFound };
+//# sourceMappingURL=not-found.utility.js.map

package/dist/esm/utility/database/typeorm/is/entity/not-found.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.utility.js","sources":["../../../../../../../../src/utility/database/typeorm/is/entity/not-found.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACG,SAAU,+BAA+B,CAAC,KAAc,EAAA;AAC7D,IAAA,IAAI,KAAK,YAAY,mBAAmB,EAAE;AACzC,QAAA,OAAO,IAAI;IACZ;IAEA,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AACxC,QAAA,OAAO,KAAK;IACb;AAEA,IAAA,MAAM,IAAI,GAAa,KAA4B,CAAC,IAAI;AAExD,IAAA,IAAI,IAAI,KAAK,qBAAqB,EAAE;AACnC,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,MAAM,OAAO,GAAa,KAA+B,CAAC,OAAO;IAEjE,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAAC;AAC5F;;;;"}

package/dist/esm/utility/database/typeorm/is/foreign-key-violation.utility.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Detects whether a TypeORM QueryFailedError is caused by a FOREIGN KEY constraint violation.
+ * Best-effort across major drivers (Postgres/MySQL/MariaDB/SQLite/MSSQL) + message fallback.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like a FOREIGN KEY constraint violation
+ */
+export declare function DatabaseTypeOrmIsForeignKeyViolation(error: unknown): boolean;

package/dist/esm/utility/database/typeorm/is/foreign-key-violation.utility.js

@@ -0,0 +1,89 @@
+import { QueryFailedError } from 'typeorm';
+
+const POSTGRES_FOREIGN_KEY_VIOLATION_CODE = "23503";
+const MYSQL_CANNOT_ADD_OR_UPDATE_CHILD_ROW_ERRNO = 1452;
+const MYSQL_CANNOT_DELETE_OR_UPDATE_PARENT_ROW_ERRNO = 1451;
+const MSSQL_FOREIGN_KEY_CONSTRAINT_ERROR_NUMBER = 547;
+/**
+ * Detects whether a TypeORM QueryFailedError is caused by a FOREIGN KEY constraint violation.
+ * Best-effort across major drivers (Postgres/MySQL/MariaDB/SQLite/MSSQL) + message fallback.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like a FOREIGN KEY constraint violation
+ */
+function DatabaseTypeOrmIsForeignKeyViolation(error) {
+    const isQueryFailedError = error instanceof QueryFailedError || (error != null && typeof error === "object" && error.name === "QueryFailedError");
+    if (!isQueryFailedError) {
+        return false;
+    }
+    const driverErrorUnknown = error != null && typeof error === "object" ? error.driverError : undefined;
+    const driverError = driverErrorUnknown != null && typeof driverErrorUnknown === "object" ? driverErrorUnknown : undefined;
+    const code = driverError?.code;
+    const errno = driverError?.errno;
+    const number = driverError?.number;
+    // PostgreSQL (SQLSTATE): foreign_key_violation
+    if (code === POSTGRES_FOREIGN_KEY_VIOLATION_CODE) {
+        return true;
+    }
+    // MySQL / MariaDB
+    if (code === "ER_NO_REFERENCED_ROW_2" || code === "ER_ROW_IS_REFERENCED_2") {
+        return true;
+    }
+    if (errno === MYSQL_CANNOT_ADD_OR_UPDATE_CHILD_ROW_ERRNO || errno === String(MYSQL_CANNOT_ADD_OR_UPDATE_CHILD_ROW_ERRNO)) {
+        return true;
+    }
+    if (errno === MYSQL_CANNOT_DELETE_OR_UPDATE_PARENT_ROW_ERRNO || errno === String(MYSQL_CANNOT_DELETE_OR_UPDATE_PARENT_ROW_ERRNO)) {
+        return true;
+    }
+    // SQLite
+    if (typeof code === "string" && code.startsWith("SQLITE_CONSTRAINT_FOREIGNKEY")) {
+        return true;
+    }
+    // MSSQL
+    if (number === MSSQL_FOREIGN_KEY_CONSTRAINT_ERROR_NUMBER) {
+        return true;
+    }
+    const driverMessage = driverError?.message;
+    let message = "";
+    if (typeof driverMessage === "string") {
+        message = driverMessage;
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (error != null && typeof error === "object" && "message" in error) {
+        const objectMessage = error.message;
+        if (typeof objectMessage === "string") {
+            message = objectMessage;
+        }
+    }
+    const messageLower = message.toLowerCase();
+    if (!messageLower) {
+        return false;
+    }
+    // Postgres
+    if (messageLower.includes("violates foreign key constraint")) {
+        return true;
+    }
+    // MySQL
+    if (messageLower.includes("a foreign key constraint fails")) {
+        return true;
+    }
+    if (messageLower.includes("cannot add or update a child row")) {
+        return true;
+    }
+    if (messageLower.includes("cannot delete or update a parent row")) {
+        return true;
+    }
+    // SQLite
+    if (messageLower.includes("foreign key constraint failed")) {
+        return true;
+    }
+    // MSSQL
+    if (messageLower.includes("conflicted with the foreign key constraint")) {
+        return true;
+    }
+    return false;
+}
+
+export { DatabaseTypeOrmIsForeignKeyViolation };
+//# sourceMappingURL=foreign-key-violation.utility.js.map

package/dist/esm/utility/database/typeorm/is/foreign-key-violation.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-key-violation.utility.js","sources":["../../../../../../../src/utility/database/typeorm/is/foreign-key-violation.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utility/database/typeorm/is/index.d.ts

@@ -0,0 +1,3 @@
+export * from './entity/index';
+export { DatabaseTypeOrmIsForeignKeyViolation } from './foreign-key-violation.utility';
+export { DatabaseTypeOrmIsUniqueViolation } from './unique-violation.utility';

package/dist/esm/utility/database/typeorm/is/unique-violation.utility.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Detects whether a TypeORM QueryFailedError is caused by a UNIQUE constraint violation.
+ * Best-effort across major drivers (Postgres/MySQL/MariaDB/SQLite/MSSQL) + message fallback.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like a UNIQUE constraint violation
+ */
+export declare function DatabaseTypeOrmIsUniqueViolation(error: unknown): boolean;

package/dist/esm/utility/database/typeorm/is/unique-violation.utility.js

@@ -0,0 +1,79 @@
+import { QueryFailedError } from 'typeorm';
+
+const MYSQL_MARIADB_DUPLICATE_ENTRY_ERRNO = 1062;
+const MSSQL_DUPLICATE_KEY_ERROR_NUMBER_1 = 2601;
+const MSSQL_DUPLICATE_KEY_ERROR_NUMBER_2 = 2627;
+/**
+ * Detects whether a TypeORM QueryFailedError is caused by a UNIQUE constraint violation.
+ * Best-effort across major drivers (Postgres/MySQL/MariaDB/SQLite/MSSQL) + message fallback.
+ * @param {unknown} error - Error thrown by TypeORM
+ * @returns {boolean} True if it looks like a UNIQUE constraint violation
+ */
+function DatabaseTypeOrmIsUniqueViolation(error) {
+    const isQueryFailedError = error instanceof QueryFailedError || (error != null && typeof error === "object" && error.name === "QueryFailedError");
+    if (!isQueryFailedError) {
+        return false;
+    }
+    const driverErrorUnknown = error != null && typeof error === "object" ? error.driverError : undefined;
+    const driverError = driverErrorUnknown != null && typeof driverErrorUnknown === "object" ? driverErrorUnknown : undefined;
+    const code = driverError?.code;
+    const errno = driverError?.errno;
+    const number = driverError?.number;
+    // PostgreSQL (SQLSTATE): unique_violation
+    if (code === "23505") {
+        return true;
+    }
+    // MySQL / MariaDB
+    if (code === "ER_DUP_ENTRY") {
+        return true;
+    }
+    if (errno === MYSQL_MARIADB_DUPLICATE_ENTRY_ERRNO || errno === String(MYSQL_MARIADB_DUPLICATE_ENTRY_ERRNO)) {
+        return true;
+    }
+    // SQLite
+    if (typeof code === "string" && code.startsWith("SQLITE_CONSTRAINT")) {
+        return true;
+    }
+    // MSSQL
+    if (number === MSSQL_DUPLICATE_KEY_ERROR_NUMBER_1 || number === MSSQL_DUPLICATE_KEY_ERROR_NUMBER_2) {
+        return true;
+    }
+    const driverMessage = driverError?.message;
+    let message = "";
+    if (typeof driverMessage === "string") {
+        message = driverMessage;
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (error != null && typeof error === "object" && "message" in error) {
+        const objectMessage = error.message;
+        if (typeof objectMessage === "string") {
+            message = objectMessage;
+        }
+    }
+    const messageLower = message.toLowerCase();
+    if (!messageLower) {
+        return false;
+    }
+    // Postgres
+    if (messageLower.includes("duplicate key value violates unique constraint")) {
+        return true;
+    }
+    // MySQL
+    if (messageLower.includes("duplicate entry")) {
+        return true;
+    }
+    // SQLite
+    if (messageLower.includes("unique constraint failed")) {
+        return true;
+    }
+    // MSSQL
+    if (messageLower.includes("cannot insert duplicate key")) {
+        return true;
+    }
+    return false;
+}
+
+export { DatabaseTypeOrmIsUniqueViolation };
+//# sourceMappingURL=unique-violation.utility.js.map

package/dist/esm/utility/database/typeorm/is/unique-violation.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-violation.utility.js","sources":["../../../../../../../src/utility/database/typeorm/is/unique-violation.utility.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,MAAM,mCAAmC,GAAW,IAAI;AACxD,MAAM,kCAAkC,GAAW,IAAI;AACvD,MAAM,kCAAkC,GAAW,IAAI;AAEvD;;;;;AAKG;AACG,SAAU,gCAAgC,CAAC,KAAc,EAAA;IAC9D,MAAM,kBAAkB,GAAY,KAAK,YAAY,gBAAgB,KAAK,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA4B,CAAC,IAAI,KAAK,kBAAkB,CAAC;IAElL,IAAI,CAAC,kBAAkB,EAAE;AACxB,QAAA,OAAO,KAAK;IACb;IAEA,MAAM,kBAAkB,GAAY,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,GAAI,KAAmC,CAAC,WAAW,GAAG,SAAS;AAC7I,IAAA,MAAM,WAAW,GAAwC,kBAAkB,IAAI,IAAI,IAAI,OAAO,kBAAkB,KAAK,QAAQ,GAAI,kBAA8C,GAAG,SAAS;AAE3L,IAAA,MAAM,IAAI,GAAY,WAAW,EAAE,IAAI;AACvC,IAAA,MAAM,KAAK,GAAY,WAAW,EAAE,KAAK;AACzC,IAAA,MAAM,MAAM,GAAY,WAAW,EAAE,MAAM;;AAG3C,IAAA,IAAI,IAAI,KAAK,OAAO,EAAE;AACrB,QAAA,OAAO,IAAI;IACZ;;AAGA,IAAA,IAAI,IAAI,KAAK,cAAc,EAAE;AAC5B,QAAA,OAAO,IAAI;IACZ;IAEA,IAAI,KAAK,KAAK,mCAAmC,IAAI,KAAK,KAAK,MAAM,CAAC,mCAAmC,CAAC,EAAE;AAC3G,QAAA,OAAO,IAAI;IACZ;;AAGA,IAAA,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE;AACrE,QAAA,OAAO,IAAI;IACZ;;IAGA,IAAI,MAAM,KAAK,kCAAkC,IAAI,MAAM,KAAK,kCAAkC,EAAE;AACnG,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,MAAM,aAAa,GAAY,WAAW,EAAE,OAAO;IACnD,IAAI,OAAO,GAAW,EAAE;AAExB,IAAA,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;QACtC,OAAO,GAAG,aAAa;IACxB;AAAO,SAAA,IAAI,KAAK,YAAY,KAAK,EAAE;AAClC,QAAA,OAAO,GAAG,KAAK,CAAC,OAAO;IACxB;AAAO,SAAA,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE;AAC5E,QAAA,MAAM,aAAa,GAAa,KAA+B,CAAC,OAAO;AAEvE,QAAA,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE;YACtC,OAAO,GAAG,aAAa;QACxB;IACD;AAEA,IAAA,MAAM,YAAY,GAAW,OAAO,CAAC,WAAW,EAAE;IAElD,IAAI,CAAC,YAAY,EAAE;AAClB,QAAA,OAAO,KAAK;IACb;;AAGA,IAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,gDAAgD,CAAC,EAAE;AAC5E,QAAA,OAAO,IAAI;IACZ;;AAGA,IAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;AAC7C,QAAA,OAAO,IAAI;IACZ;;AAGA,IAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE;AACtD,QAAA,OAAO,IAAI;IACZ;;AAGA,IAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE;AACzD,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,KAAK;AACb;;;;"}