@decaf-ts/for-couchdb 0.14.0 → 0.14.2

package/lib/esm/query/planner.js

@@ -0,0 +1,430 @@
+import { OrderDirection } from "@decaf-ts/core";
+import { Model } from "@decaf-ts/decorator-validation";
+import { CouchDBKeys } from "./../constants.js";
+import { CouchDBGroupOperator, CouchDBOperator } from "./constants.js";
+import { generateIndexName, generateModelIndexName, } from "./../indexes/generator.js";
+import { IndexPlanningError } from "./../errors/IndexPlanningError.js";
+const SCAN_PRONE_OPERATORS = new Set([
+    "$or",
+    "$in",
+    "$regex",
+    "$nin",
+    "$not",
+    "$ne",
+    "$nor",
+]);
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function selectorContainsOperator(node, operator) {
+    if (!node || typeof node !== "object")
+        return false;
+    if (Array.isArray(node)) {
+        return node.some((child) => selectorContainsOperator(child, operator));
+    }
+    return Object.entries(node).some(([key, value]) => key === operator || selectorContainsOperator(value, operator));
+}
+export function normalizeSortField(entry) {
+    if (typeof entry === "string") {
+        return { field: entry };
+    }
+    if (Array.isArray(entry)) {
+        return entry.length ? { field: String(entry[0]) } : undefined;
+    }
+    const [field, direction] = Object.entries(entry || {})[0] || [];
+    if (!field)
+        return undefined;
+    return {
+        field,
+        direction: String(direction || OrderDirection.ASC).toLowerCase(),
+    };
+}
+export function getSortFields(query) {
+    return (query.sort || [])
+        .map(normalizeSortField)
+        .filter(Boolean)
+        .map((entry) => entry.field);
+}
+export function getSortDirection(query) {
+    return (query.sort || [])
+        .map(normalizeSortField)
+        .find(Boolean)?.direction;
+}
+export function getEqualitySelectorFields(selector = {}) {
+    const fields = new Set();
+    const visit = (node) => {
+        if (!node || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            node.forEach(visit);
+            return;
+        }
+        if (Array.isArray(node[CouchDBGroupOperator.AND])) {
+            node[CouchDBGroupOperator.AND].forEach(visit);
+            return;
+        }
+        for (const [key, value] of Object.entries(node)) {
+            if (key === CouchDBGroupOperator.OR || key === CouchDBGroupOperator.AND) {
+                visit(value);
+                continue;
+            }
+            if (!isPlainObject(value)) {
+                fields.add(key);
+                continue;
+            }
+            if (Object.prototype.hasOwnProperty.call(value, CouchDBOperator.EQUAL)) {
+                fields.add(key);
+            }
+        }
+    };
+    visit(selector);
+    return fields;
+}
+export function getRangeSelectorFields(selector = {}) {
+    const fields = new Set();
+    const visit = (node) => {
+        if (!node || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            node.forEach(visit);
+            return;
+        }
+        if (Array.isArray(node[CouchDBGroupOperator.AND])) {
+            node[CouchDBGroupOperator.AND].forEach(visit);
+            return;
+        }
+        for (const [key, value] of Object.entries(node)) {
+            if (key === CouchDBGroupOperator.OR || key === CouchDBGroupOperator.AND) {
+                visit(value);
+                continue;
+            }
+            if (!isPlainObject(value))
+                continue;
+            if (Object.prototype.hasOwnProperty.call(value, CouchDBOperator.BIGGER) ||
+                Object.prototype.hasOwnProperty.call(value, CouchDBOperator.BIGGER_EQ) ||
+                Object.prototype.hasOwnProperty.call(value, CouchDBOperator.SMALLER) ||
+                Object.prototype.hasOwnProperty.call(value, CouchDBOperator.SMALLER_EQ)) {
+                fields.add(key);
+            }
+        }
+    };
+    visit(selector);
+    return fields;
+}
+function collectGeneratedIndexEntries(clazz) {
+    const tableName = Model.tableName(clazz);
+    const candidates = [];
+    const tableIndexName = generateIndexName([CouchDBKeys.TABLE]);
+    candidates.push({
+        name: tableIndexName,
+        ddoc: tableIndexName,
+        fields: [CouchDBKeys.TABLE],
+        source: "table",
+    });
+    let defaultQueryAttrs = [];
+    try {
+        defaultQueryAttrs = Model.defaultQueryAttributes(clazz);
+    }
+    catch {
+        defaultQueryAttrs = [];
+    }
+    for (const attr of defaultQueryAttrs) {
+        const baseName = generateIndexName([tableName, attr, "defaultQuery"]);
+        candidates.push({
+            name: baseName,
+            ddoc: baseName,
+            fields: [CouchDBKeys.TABLE, attr],
+            source: "defaultQuery",
+        });
+        for (const direction of [OrderDirection.ASC, OrderDirection.DSC]) {
+            const sortedName = generateIndexName([tableName, attr, "defaultQuery"], direction);
+            candidates.push({
+                name: sortedName,
+                ddoc: sortedName,
+                fields: [CouchDBKeys.TABLE, attr],
+                direction,
+                source: "defaultQuery",
+            });
+        }
+    }
+    const modelIndexes = Model.indexes(clazz);
+    Object.entries(modelIndexes || {}).forEach(([fieldKey, value]) => {
+        Object.values(value || {}).forEach((metadataValue) => {
+            if (!metadataValue || !isPlainObject(metadataValue))
+                return;
+            const meta = metadataValue;
+            const compositions = meta.compositions || [];
+            const directions = meta.directions || [OrderDirection.ASC];
+            const fields = [CouchDBKeys.TABLE, fieldKey, ...compositions];
+            const baseName = generateModelIndexName(tableName, fieldKey, compositions);
+            candidates.push({
+                name: baseName,
+                ddoc: baseName,
+                fields,
+                source: "index",
+            });
+            const validDirections = Array.from(new Set(directions.map((dir) => String(dir).toLowerCase()))).filter((dir) => dir === OrderDirection.ASC || dir === OrderDirection.DSC);
+            for (const direction of validDirections) {
+                const sortedName = generateModelIndexName(tableName, fieldKey, compositions, direction);
+                candidates.push({
+                    name: sortedName,
+                    ddoc: sortedName,
+                    fields,
+                    direction,
+                    source: "index",
+                });
+            }
+        });
+    });
+    return candidates;
+}
+export function buildGeneratedIndexCandidates(clazz) {
+    return collectGeneratedIndexEntries(clazz);
+}
+export function findGeneratedIndexCandidateByName(clazz, expectedName) {
+    return collectGeneratedIndexEntries(clazz).find((candidate) => candidate.name === expectedName || candidate.ddoc === expectedName);
+}
+export function resolveGeneratedIndexForQuery(clazz, query, options = {}) {
+    if (query.use_index)
+        return undefined;
+    // A single named index cannot be proven valid for selectors combining
+    // branches via $or/$nor, since CouchDB only treats an index as usable when
+    // its leading fields constrain every branch of the selector. Forcing a
+    // use_index hint here causes CouchDB to reject it as "not a valid index for
+    // this query" - so let CouchDB pick (or fall back) on its own instead.
+    if (selectorContainsOperator(query.selector, CouchDBGroupOperator.OR) ||
+        selectorContainsOperator(query.selector, "$nor")) {
+        return undefined;
+    }
+    const preserveDefaultQuery = options.preserveDefaultQuery !== false;
+    const candidates = collectGeneratedIndexEntries(clazz);
+    const equalityFields = getEqualitySelectorFields(query.selector);
+    const rangeFields = getRangeSelectorFields(query.selector);
+    const sortFields = getSortFields(query);
+    const sortDirection = getSortDirection(query);
+    equalityFields.add(CouchDBKeys.TABLE);
+    const scored = candidates
+        .map((candidate) => {
+        if (candidate.direction &&
+            sortDirection &&
+            candidate.direction !== sortDirection) {
+            return undefined;
+        }
+        if (!candidate.fields.includes(CouchDBKeys.TABLE))
+            return undefined;
+        if (candidate.fields[0] !== CouchDBKeys.TABLE)
+            return undefined;
+        const candidateFields = candidate.fields.filter((field) => field !== CouchDBKeys.TABLE);
+        const coversAllSort = sortFields.length === 0 ||
+            sortFields.every((field) => candidateFields.includes(field));
+        const coversSomeSort = sortFields.some((field) => candidateFields.includes(field));
+        const coversAllRange = rangeFields.size === 0 ||
+            Array.from(rangeFields).every((field) => candidateFields.includes(field));
+        const coversSomeRange = Array.from(rangeFields).some((field) => candidateFields.includes(field));
+        if (options.requireSortCoverage && sortFields.length && !coversAllSort) {
+            return undefined;
+        }
+        const equalityCoverage = candidateFields.filter((field) => equalityFields.has(field)).length;
+        const rangeCoverage = candidateFields.filter((field) => rangeFields.has(field)).length;
+        const sortCoverage = candidateFields.filter((field) => sortFields.includes(field)).length;
+        if (!equalityCoverage && !rangeCoverage && !sortCoverage) {
+            return undefined;
+        }
+        let score = 0;
+        if (candidate.source === "defaultQuery" && preserveDefaultQuery) {
+            score += 100;
+        }
+        if (candidate.source === "index")
+            score += 50;
+        score += equalityCoverage * 30;
+        score += rangeCoverage * 25;
+        score += sortCoverage * 20;
+        if (coversAllSort && sortFields.length)
+            score += 20;
+        if (coversAllRange && rangeFields.size)
+            score += 20;
+        if (coversSomeSort)
+            score += 5;
+        if (coversSomeRange)
+            score += 5;
+        if (candidate.direction && sortDirection)
+            score += 10;
+        return { candidate, score };
+    })
+        .filter(Boolean);
+    if (!scored.length)
+        return undefined;
+    scored.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.candidate.fields.length - b.candidate.fields.length;
+    });
+    const best = scored[0].candidate;
+    return {
+        candidate: best,
+        use_index: [best.ddoc, best.name],
+    };
+}
+export function getRequiredMangoIndexShape(clazz, query) {
+    const tableName = Model.tableName(clazz);
+    const modelName = clazz.name;
+    const equalityFields = Array.from(getEqualitySelectorFields(query.selector));
+    const rangeFields = Array.from(getRangeSelectorFields(query.selector));
+    const sortFields = getSortFields(query);
+    const sortDirection = getSortDirection(query);
+    const requiredFields = [CouchDBKeys.TABLE];
+    for (const field of equalityFields) {
+        if (field !== CouchDBKeys.TABLE && !requiredFields.includes(field)) {
+            requiredFields.push(field);
+        }
+    }
+    for (const field of rangeFields) {
+        if (field !== CouchDBKeys.TABLE && !requiredFields.includes(field)) {
+            requiredFields.push(field);
+        }
+    }
+    for (const field of sortFields) {
+        if (field !== CouchDBKeys.TABLE && !requiredFields.includes(field)) {
+            requiredFields.push(field);
+        }
+    }
+    return {
+        tableName,
+        modelName,
+        equalityFields,
+        rangeFields,
+        sortFields,
+        sortDirection,
+        requiredFields,
+    };
+}
+export function reverseRequiredShapeToIndexDeclaration(clazz, query) {
+    const shape = getRequiredMangoIndexShape(clazz, query);
+    const nonTableFields = shape.requiredFields.filter((field) => field !== CouchDBKeys.TABLE);
+    if (!nonTableFields.length) {
+        throw new IndexPlanningError("Cannot infer @index declaration for query with no model fields.", {
+            modelName: shape.modelName,
+            tableName: shape.tableName,
+            attribute: "",
+            compositions: [],
+            directions: [],
+            expectedName: "",
+            expectedDdoc: "",
+            expectedFields: [CouchDBKeys.TABLE],
+            decorator: "",
+        }, query);
+    }
+    const attribute = nonTableFields[0];
+    const compositions = nonTableFields.slice(1);
+    const direction = shape.sortDirection || OrderDirection.ASC;
+    const name = generateModelIndexName(shape.tableName, attribute, compositions, direction);
+    const fields = [
+        { [CouchDBKeys.TABLE]: direction },
+        { [attribute]: direction },
+        ...compositions.map((field) => ({ [field]: direction })),
+    ];
+    const decorator = [
+        "@index({",
+        compositions.length
+            ? `  compositions: ${JSON.stringify(compositions)},`
+            : undefined,
+        `  directions: ${JSON.stringify([direction])}`,
+        "})",
+        `${attribute}!: <type>;`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+    return {
+        attribute,
+        compositions,
+        directions: [direction],
+        name,
+        ddoc: name,
+        fields,
+        decorator,
+    };
+}
+export function attachGeneratedUseIndex(clazz, query, log, options = {}) {
+    if (!clazz || query.use_index)
+        return;
+    if (options.forceNamedIndexes === false && !options.requireIndex) {
+        return;
+    }
+    const resolved = resolveGeneratedIndexForQuery(clazz, query, {
+        preserveDefaultQuery: options.preserveDefaultQuery ?? true,
+        requireSortCoverage: options.requireSortCoverage ?? false,
+    });
+    if (resolved) {
+        query.use_index = resolved.use_index;
+        log?.debug?.(`Attached Mango use_index=${JSON.stringify(resolved.use_index)} from ${resolved.candidate.source} metadata`);
+        return;
+    }
+    if (!options.requireIndex)
+        return;
+    const reversed = reverseRequiredShapeToIndexDeclaration(clazz, query);
+    throw new IndexPlanningError([
+        "No generated CouchDB index can satisfy this Mango query.",
+        "",
+        `Model: ${clazz.name}`,
+        `Table: ${shapeTableName(clazz)}`,
+        "",
+        "To allow this query, declare the following index on the model attribute:",
+        "",
+        reversed.decorator,
+        "",
+        "Then regenerate/deploy indexes.",
+        "",
+        "Expected generated index:",
+        `  ddoc: ${reversed.ddoc}`,
+        `  name: ${reversed.name}`,
+        `  fields: ${JSON.stringify(reversed.fields)}`,
+    ].join("\n"), {
+        modelName: clazz.name,
+        tableName: shapeTableName(clazz),
+        attribute: reversed.attribute,
+        compositions: reversed.compositions,
+        directions: reversed.directions,
+        expectedName: reversed.name,
+        expectedDdoc: reversed.ddoc,
+        expectedFields: reversed.fields,
+        decorator: reversed.decorator,
+    }, query);
+}
+function shapeTableName(clazz) {
+    return Model.tableName(clazz);
+}
+export function requireGeneratedUseIndex(clazz, query, log, options = {}) {
+    attachGeneratedUseIndex(clazz, query, log, {
+        preserveDefaultQuery: true,
+        requireSortCoverage: options.requireSortCoverage ?? true,
+        requireIndex: true,
+        forceNamedIndexes: true,
+    });
+}
+export function warnScanProneMangoOperators(selector, log, path = "selector") {
+    if (!selector || typeof selector !== "object")
+        return;
+    if (Array.isArray(selector)) {
+        selector.forEach((entry, index) => warnScanProneMangoOperators(entry, log, `${path}[${index}]`));
+        return;
+    }
+    for (const [key, value] of Object.entries(selector)) {
+        if (SCAN_PRONE_OPERATORS.has(key)) {
+            log?.warn?.(`Mango query contains scan-prone operator ${key} at ${path}. This may bypass or weaken index usage and can produce slow queries.`);
+        }
+        warnScanProneMangoOperators(value, log, `${path}.${key}`);
+    }
+}
+export function ensureDeterministicSort(query, tieBreaker, direction) {
+    if (!query.sort?.length)
+        return;
+    const sortFields = getSortFields(query);
+    if (sortFields.includes(tieBreaker))
+        return;
+    const effectiveDirection = direction || getSortDirection(query) || OrderDirection.ASC;
+    query.sort = [...query.sort, { [tieBreaker]: effectiveDirection }];
+}
+export function enableMangoExecutionStats(query) {
+    query.execution_stats = true;
+}
+//# sourceMappingURL=planner.js.map

package/lib/esm/query/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../../src/query/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,0BAAqB;AAC3C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,uBAAoB;AAEpE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GACvB,kCAA6B;AAC9B,OAAO,EAAE,kBAAkB,EAAE,0CAAqC;AAwClE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,KAAK;IACL,KAAK;IACL,QAAQ;IACR,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAS,EAAE,QAAgB;IAC3D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAgB;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,OAAO;QACL,KAAK;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,WAAW,EAAoB;KACnF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,GAAG,CAAC,kBAAkB,CAAC;SACvB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAiB;IAEjB,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,GAAG,CAAC,kBAAkB,CAAC;SACvB,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,MAAM,KAAK,GAAG,CAAC,IAAS,EAAQ,EAAE;QAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO;QAE9C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,GAAG,KAAK,oBAAoB,CAAC,EAAE,IAAI,GAAG,KAAK,oBAAoB,CAAC,GAAG,EAAE,CAAC;gBACxE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,MAAM,KAAK,GAAG,CAAC,IAAS,EAAQ,EAAE;QAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO;QAE9C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,GAAG,KAAK,oBAAoB,CAAC,EAAE,IAAI,GAAG,KAAK,oBAAoB,CAAC,GAAG,EAAE,CAAC;gBACxE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,SAAS;YAEpC,IACE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC;gBACnE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC;gBACtE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC;gBACpE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,EACvE,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAkB;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,MAAM,cAAc,GAAG,iBAAiB,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,UAAU,CAAC,IAAI,CAAC;QACd,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,OAAO;KAChB,CAAC,CAAC;IAEH,IAAI,iBAAiB,GAAa,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,iBAAiB,GAAG,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAa,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QACtE,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;YACjC,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;QAEH,KAAK,MAAM,SAAS,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,UAAU,GAAG,iBAAiB,CAClC,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EACjC,SAAS,CACV,CAAC;YACF,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC;gBACjC,SAAS;gBACT,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAGvC,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QAC/D,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;YACnD,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC;gBAAE,OAAO;YAE5D,MAAM,IAAI,GAAG,aAGZ,CAAC;YACF,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAC;YAE9D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;YAC3E,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,MAAM;gBACN,MAAM,EAAE,OAAO;aAChB,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAChC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAC5D,CAAC,MAAM,CACN,CAAC,GAAG,EAAyB,EAAE,CAC7B,GAAG,KAAK,cAAc,CAAC,GAAG,IAAI,GAAG,KAAK,cAAc,CAAC,GAAG,CAC3D,CAAC;YAEF,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;gBACxC,MAAM,UAAU,GAAG,sBAAsB,CACvC,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,CACV,CAAC;gBACF,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,UAAU;oBAChB,MAAM;oBACN,SAAS;oBACT,MAAM,EAAE,OAAO;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAkB;IAElB,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAkB,EAClB,YAAoB;IAEpB,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC,IAAI,CAC7C,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAkB,EAClB,KAAiB,EACjB,UAGI,EAAE;IAEN,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEtC,sEAAsE;IACtE,2EAA2E;IAC3E,uEAAuE;IACvE,4EAA4E;IAC5E,uEAAuE;IACvE,IACE,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,CAAC;QACjE,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,EAChD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,KAAK,KAAK,CAAC;IACpE,MAAM,UAAU,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE9C,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,UAAU;SACtB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACjB,IACE,SAAS,CAAC,SAAS;YACnB,aAAa;YACb,SAAS,CAAC,SAAS,KAAK,aAAa,EACrC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACpE,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAEhE,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CACvC,CAAC;QACF,MAAM,aAAa,GACjB,UAAU,CAAC,MAAM,KAAK,CAAC;YACvB,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/C,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAChC,CAAC;QACF,MAAM,cAAc,GAClB,WAAW,CAAC,IAAI,KAAK,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7D,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAChC,CAAC;QAEF,IAAI,OAAO,CAAC,mBAAmB,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACvE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACxD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAC1B,CAAC,MAAM,CAAC;QACT,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACrD,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CACvB,CAAC,MAAM,CAAC;QACT,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACpD,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3B,CAAC,MAAM,CAAC;QAET,IAAI,CAAC,gBAAgB,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY,EAAE,CAAC;YACzD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,SAAS,CAAC,MAAM,KAAK,cAAc,IAAI,oBAAoB,EAAE,CAAC;YAChE,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO;YAAE,KAAK,IAAI,EAAE,CAAC;QAC9C,KAAK,IAAI,gBAAgB,GAAG,EAAE,CAAC;QAC/B,KAAK,IAAI,aAAa,GAAG,EAAE,CAAC;QAC5B,KAAK,IAAI,YAAY,GAAG,EAAE,CAAC;QAC3B,IAAI,aAAa,IAAI,UAAU,CAAC,MAAM;YAAE,KAAK,IAAI,EAAE,CAAC;QACpD,IAAI,cAAc,IAAI,WAAW,CAAC,IAAI;YAAE,KAAK,IAAI,EAAE,CAAC;QACpD,IAAI,cAAc;YAAE,KAAK,IAAI,CAAC,CAAC;QAC/B,IAAI,eAAe;YAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,CAAC,SAAS,IAAI,aAAa;YAAE,KAAK,IAAI,EAAE,CAAC;QAEtD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAA6D,CAAC;IAE/E,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClD,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjC,OAAO;QACL,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAkB,EAClB,KAAiB;IAEjB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IAC7B,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,SAAS;QACT,cAAc;QACd,WAAW;QACX,UAAU;QACV,aAAa;QACb,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,KAAkB,EAClB,KAAiB;IAEjB,MAAM,KAAK,GAAG,0BAA0B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAChD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,WAAW,CAAC,KAAK,CACvC,CAAC;IAEF,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAC1B,iEAAiE,EACjE;YACE,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE;YACd,YAAY,EAAE,EAAE;YAChB,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC;YACnC,SAAS,EAAE,EAAE;SACd,EACD,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,IAAI,cAAc,CAAC,GAAG,CAAC;IAC5D,MAAM,IAAI,GAAG,sBAAsB,CACjC,KAAK,CAAC,SAAS,EACf,SAAS,EACT,YAAY,EACZ,SAAS,CACV,CAAC;IACF,MAAM,MAAM,GAAmD;QAC7D,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE;QAClC,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE;QAC1B,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;KACzD,CAAC;IAEF,MAAM,SAAS,GAAG;QAChB,UAAU;QACV,YAAY,CAAC,MAAM;YACjB,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG;YACpD,CAAC,CAAC,SAAS;QACb,iBAAiB,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE;QAC9C,IAAI;QACJ,GAAG,SAAS,YAAY;KACzB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,SAAS;QACT,YAAY;QACZ,UAAU,EAAE,CAAC,SAAS,CAAC;QACvB,IAAI;QACJ,IAAI,EAAE,IAAI;QACV,MAAM;QACN,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAA8B,EAC9B,KAAiB,EACjB,GAAqB,EACrB,UAKI,EAAE;IAEN,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO;IAEtC,IAAI,OAAO,CAAC,iBAAiB,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,EAAE,KAAK,EAAE;QAC3D,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,IAAI;QAC1D,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,KAAK;KAC1D,CAAC,CAAC;IAEH,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,GAAG,EAAE,KAAK,EAAE,CACV,4BAA4B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,QAAQ,CAAC,SAAS,CAAC,MAAM,WAAW,CAC5G,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,YAAY;QAAE,OAAO;IAElC,MAAM,QAAQ,GAAG,sCAAsC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,kBAAkB,CAC1B;QACE,0DAA0D;QAC1D,EAAE;QACF,UAAU,KAAK,CAAC,IAAI,EAAE;QACtB,UAAU,cAAc,CAAC,KAAK,CAAC,EAAE;QACjC,EAAE;QACF,0EAA0E;QAC1E,EAAE;QACF,QAAQ,CAAC,SAAS;QAClB,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,2BAA2B;QAC3B,WAAW,QAAQ,CAAC,IAAI,EAAE;QAC1B,WAAW,QAAQ,CAAC,IAAI,EAAE;QAC1B,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;QAChC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,EACD,KAAK,CACN,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB;IACxC,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAkB,EAClB,KAAiB,EACjB,GAAqB,EACrB,UAEI,EAAE;IAEN,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE;QACzC,oBAAoB,EAAE,IAAI;QAC1B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,IAAI;QACxD,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAAiB,EACjB,GAAqB,EACrB,IAAI,GAAG,UAAU;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAEtD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAChC,2BAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAC7D,CAAC;QACF,OAAO;IACT,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;QAC/E,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,GAAG,EAAE,IAAI,EAAE,CACT,4CAA4C,GAAG,OAAO,IAAI,uEAAuE,CAClI,CAAC;QACJ,CAAC;QACD,2BAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAiB,EACjB,UAAkB,EAClB,SAA0B;IAE1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO;IAEhC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO;IAE5C,MAAM,kBAAkB,GACtB,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC;IAE7D,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAiB;IACzD,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;AAC/B,CAAC"}

package/lib/types/adapter.d.cts

@@ -1,7 +1,7 @@
-import { Adapter, AdapterFlags, Paginator, RawResult, ContextualArgs, PreparedModel } from "@decaf-ts/core";
+import { Adapter, Paginator, RawResult, ContextualArgs, PreparedModel } from "@decaf-ts/core";
 import { BaseError, type PrimaryKeyType } from "@decaf-ts/db-decorators";
 import { Model } from "@decaf-ts/decorator-validation";
-import { type MangoQuery, ViewResponse } from "./types.d.cts";
+import { type CouchDBFlags, type MangoQuery, ViewResponse } from "./types.d.cts";
 import { CouchDBStatement } from "./query/index.d.cts";
 import { Context } from "@decaf-ts/core";
 import { type Constructor } from "@decaf-ts/decoration";
@@ -57,7 +57,7 @@ export declare abstract class CouchDBAdapter<CONF, CONN, C extends Context<any>>
      * @template M - The model type
      * @return {CouchDBStatement<M, any>} A new CouchDBStatement instance
      */
-    Statement<M extends Model>(overrides?: Partial<AdapterFlags>): CouchDBStatement<M, Adapter<CONF, CONN, MangoQuery, C>, any>;
+    Statement<M extends Model>(overrides?: Partial<CouchDBFlags>): CouchDBStatement<M, Adapter<CONF, CONN, MangoQuery, C>, any>;
     Paginator<M extends Model>(query: MangoQuery, size: number, clazz: Constructor<M>): Paginator<M, any, MangoQuery>;
     /**
      * @description Initializes the adapter by creating indexes for all managed models

package/lib/types/adapter.d.mts

@@ -1,7 +1,7 @@
-import { Adapter, AdapterFlags, Paginator, RawResult, ContextualArgs, PreparedModel } from "@decaf-ts/core";
+import { Adapter, Paginator, RawResult, ContextualArgs, PreparedModel } from "@decaf-ts/core";
 import { BaseError, type PrimaryKeyType } from "@decaf-ts/db-decorators";
 import { Model } from "@decaf-ts/decorator-validation";
-import { type MangoQuery, ViewResponse } from "./types.d.mts";
+import { type CouchDBFlags, type MangoQuery, ViewResponse } from "./types.d.mts";
 import { CouchDBStatement } from "./query/index.d.mts";
 import { Context } from "@decaf-ts/core";
 import { type Constructor } from "@decaf-ts/decoration";
@@ -57,7 +57,7 @@ export declare abstract class CouchDBAdapter<CONF, CONN, C extends Context<any>>
      * @template M - The model type
      * @return {CouchDBStatement<M, any>} A new CouchDBStatement instance
      */
-    Statement<M extends Model>(overrides?: Partial<AdapterFlags>): CouchDBStatement<M, Adapter<CONF, CONN, MangoQuery, C>, any>;
+    Statement<M extends Model>(overrides?: Partial<CouchDBFlags>): CouchDBStatement<M, Adapter<CONF, CONN, MangoQuery, C>, any>;
     Paginator<M extends Model>(query: MangoQuery, size: number, clazz: Constructor<M>): Paginator<M, any, MangoQuery>;
     /**
      * @description Initializes the adapter by creating indexes for all managed models

package/lib/types/errors/IndexPlanningError.d.cts

@@ -0,0 +1,17 @@
+import { IndexError } from "./IndexError.d.cts";
+export type IndexPlanningSuggestion = {
+    modelName: string;
+    tableName: string;
+    attribute: string;
+    compositions: string[];
+    directions: string[];
+    expectedName: string;
+    expectedDdoc: string;
+    expectedFields: Array<string | Record<string, string>>;
+    decorator: string;
+};
+export declare class IndexPlanningError extends IndexError {
+    readonly suggestion: IndexPlanningSuggestion;
+    readonly query: unknown;
+    constructor(message: string, suggestion: IndexPlanningSuggestion, query: unknown);
+}

package/lib/types/errors/IndexPlanningError.d.mts

@@ -0,0 +1,17 @@
+import { IndexError } from "./IndexError.d.mts";
+export type IndexPlanningSuggestion = {
+    modelName: string;
+    tableName: string;
+    attribute: string;
+    compositions: string[];
+    directions: string[];
+    expectedName: string;
+    expectedDdoc: string;
+    expectedFields: Array<string | Record<string, string>>;
+    decorator: string;
+};
+export declare class IndexPlanningError extends IndexError {
+    readonly suggestion: IndexPlanningSuggestion;
+    readonly query: unknown;
+    constructor(message: string, suggestion: IndexPlanningSuggestion, query: unknown);
+}

package/lib/types/errors/index.d.cts

@@ -0,0 +1,2 @@
+export * from "./IndexError.d.cts";
+export * from "./IndexPlanningError.d.cts";

package/lib/types/errors/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./IndexError.d.mts";
+export * from "./IndexPlanningError.d.mts";

package/lib/types/index.d.cts

@@ -2,11 +2,11 @@ export * from "./indexes/index.d.cts";
 export * from "./repository.d.cts";
 export * from "./adapter.d.cts";
 export * from "./constants.d.cts";
-export * from "./errors.d.cts";
+export * from "./errors/index.d.cts";
 export * from "./metadata.d.cts";
 export * from "./decorators.d.cts";
 export * from "./types.d.cts";
-export * from "./utils.d.cts";
+export { reAuth, wrapDocumentScope, testReservedAttributes, generateIndexDoc } from "./utils.d.cts";
 export * from "./query/index.d.cts";
 export * from "./views/index.d.cts";
 /**
@@ -19,21 +19,21 @@ export * from "./views/index.d.cts";
  * @summary The version string of the for-couchdb package
  * @const VERSION
  */
-export declare const VERSION = "0.13.0";
+export declare const VERSION = "0.14.1";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "d216217";
+export declare const COMMIT = "8d4d67a";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.13.0-d216217";
+export declare const FULL_VERSION = "0.14.1-8d4d67a";
 /**
  * @description Stores the current package name
  * @summary The version string of the for-couchdb package

package/lib/types/index.d.mts

@@ -2,11 +2,11 @@ export * from "./indexes/index.d.mts";
 export * from "./repository.d.mts";
 export * from "./adapter.d.mts";
 export * from "./constants.d.mts";
-export * from "./errors.d.mts";
+export * from "./errors/index.d.mts";
 export * from "./metadata.d.mts";
 export * from "./decorators.d.mts";
 export * from "./types.d.mts";
-export * from "./utils.d.mts";
+export { reAuth, wrapDocumentScope, testReservedAttributes, generateIndexDoc } from "./utils.d.mts";
 export * from "./query/index.d.mts";
 export * from "./views/index.d.mts";
 /**
@@ -19,21 +19,21 @@ export * from "./views/index.d.mts";
  * @summary The version string of the for-couchdb package
  * @const VERSION
  */
-export declare const VERSION = "0.13.0";
+export declare const VERSION = "0.14.1";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "d216217";
+export declare const COMMIT = "8d4d67a";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.13.0-d216217";
+export declare const FULL_VERSION = "0.14.1-8d4d67a";
 /**
  * @description Stores the current package name
  * @summary The version string of the for-couchdb package

package/lib/types/indexes/generator.d.cts

@@ -1,6 +1,19 @@
+import { OrderDirection } from "@decaf-ts/core";
 import { Model } from "@decaf-ts/decorator-validation";
 import { CreateIndexRequest } from "../types.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
+/**
+ * @description Generates a name for a CouchDB index
+ * @summary Creates a standardized name for a CouchDB index by combining name parts, compositions, and direction
+ * @param {string[]} name - Array of name parts for the index
+ * @param {OrderDirection} [direction] - Optional sort direction for the index
+ * @param {string[]} [compositions] - Optional additional attributes to include in the index name
+ * @param {string} [separator=DefaultSeparator] - The separator to use between parts of the index name
+ * @return {string} The generated index name
+ * @memberOf module:for-couchdb
+ */
+export declare function generateIndexName(name: string[], direction?: OrderDirection, compositions?: string[], separator?: string): string;
+export declare function generateModelIndexName(tableName: string, fieldKey: string, compositions?: string[], direction?: OrderDirection, separator?: string): string;
 /**
  * @description Generates CouchDB index configurations for models
  * @summary Creates a set of CouchDB index configurations based on the metadata of the provided models

package/lib/types/indexes/generator.d.mts

@@ -1,6 +1,19 @@
+import { OrderDirection } from "@decaf-ts/core";
 import { Model } from "@decaf-ts/decorator-validation";
 import { CreateIndexRequest } from "../types.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
+/**
+ * @description Generates a name for a CouchDB index
+ * @summary Creates a standardized name for a CouchDB index by combining name parts, compositions, and direction
+ * @param {string[]} name - Array of name parts for the index
+ * @param {OrderDirection} [direction] - Optional sort direction for the index
+ * @param {string[]} [compositions] - Optional additional attributes to include in the index name
+ * @param {string} [separator=DefaultSeparator] - The separator to use between parts of the index name
+ * @return {string} The generated index name
+ * @memberOf module:for-couchdb
+ */
+export declare function generateIndexName(name: string[], direction?: OrderDirection, compositions?: string[], separator?: string): string;
+export declare function generateModelIndexName(tableName: string, fieldKey: string, compositions?: string[], direction?: OrderDirection, separator?: string): string;
 /**
  * @description Generates CouchDB index configurations for models
  * @summary Creates a set of CouchDB index configurations based on the metadata of the provided models