betterddb 0.8.0 → 0.8.2

package/dist/src/builders/get-builder.js

@@ -0,0 +1,76 @@
+/* eslint-disable no-unused-vars */
+import {} from "../betterddb.js";
+import { TransactGetCommand, GetCommand } from "@aws-sdk/lib-dynamodb";
+import {} from "@aws-sdk/client-dynamodb";
+export class GetBuilder {
+    parent;
+    key;
+    projectionExpression;
+    expressionAttributeNames = {};
+    extraTransactItems = [];
+    constructor(parent, key) {
+        this.parent = parent;
+        this.key = key;
+    }
+    /**
+     * Specify a projection by providing an array of attribute names.
+     */
+    withProjection(attributes) {
+        this.projectionExpression = attributes
+            .map((attr) => `#${String(attr)}`)
+            .join(", ");
+        for (const attr of attributes) {
+            this.expressionAttributeNames[`#${String(attr)}`] = String(attr);
+        }
+        return this;
+    }
+    async execute() {
+        if (this.extraTransactItems.length > 0) {
+            // Build our update transaction item.
+            const myTransactItem = this.toTransactGet();
+            // Combine with extra transaction items.
+            const allItems = [...this.extraTransactItems, myTransactItem];
+            await this.parent.getClient().send(new TransactGetCommand({
+                TransactItems: allItems,
+            }));
+            // After transaction, retrieve the updated item.
+            const result = await this.parent.get(this.key).execute();
+            return result;
+        }
+        else {
+            const params = {
+                TableName: this.parent.getTableName(),
+                Key: this.parent.buildKey(this.key),
+            };
+            if (this.projectionExpression) {
+                params.ProjectionExpression = this.projectionExpression;
+                params.ExpressionAttributeNames = this.expressionAttributeNames;
+            }
+            const result = await this.parent.getClient().send(new GetCommand(params));
+            if (!result.Item)
+                return null;
+            return this.parent.getSchema().parse(result.Item);
+        }
+    }
+    transactGet(ops) {
+        if (Array.isArray(ops)) {
+            this.extraTransactItems.push(...ops);
+        }
+        else {
+            this.extraTransactItems.push(ops);
+        }
+        return this;
+    }
+    toTransactGet() {
+        const getItem = {
+            TableName: this.parent.getTableName(),
+            Key: this.parent.buildKey(this.key),
+        };
+        if (this.projectionExpression) {
+            getItem.ProjectionExpression = this.projectionExpression;
+            getItem.ExpressionAttributeNames = this.expressionAttributeNames;
+        }
+        return { Get: getItem };
+    }
+}
+//# sourceMappingURL=get-builder.js.map

package/dist/src/builders/get-builder.js.map

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

package/dist/src/builders/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./batch-get-builder.js";
+export * from "./create-builder.js";
+export * from "./delete-builder.js";
+export * from "./get-builder.js";
+export * from "./query-builder.js";
+export * from "./scan-builder.js";
+export * from "./update-builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/builders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/{src/builders/index.ts → dist/src/builders/index.js}

@@ -5,3 +5,4 @@ export * from "./get-builder.js";
 export * from "./query-builder.js";
 export * from "./scan-builder.js";
 export * from "./update-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/src/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/src/builders/query-builder.d.ts

@@ -0,0 +1,29 @@
+import { type NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import { type BetterDDB } from "../betterddb.js";
+import { type Operator } from "../operator.js";
+import { type PaginatedResult } from "../types/paginated-result.js";
+export declare class QueryBuilder<T> {
+    private parent;
+    private key;
+    private keyConditions;
+    private filterConditions;
+    private expressionAttributeNames;
+    private expressionAttributeValues;
+    private index?;
+    private limit?;
+    private lastKey?;
+    private ascending;
+    constructor(parent: BetterDDB<T>, key: Partial<T>);
+    usingIndex(indexName: string): this;
+    sortAscending(): this;
+    sortDescending(): this;
+    where(operator: Operator, values: Partial<T> | [Partial<T>, Partial<T>]): this;
+    filter(attribute: keyof T, operator: Operator, values: unknown): this;
+    limitResults(limit: number): this;
+    startFrom(lastKey: Record<string, NativeAttributeValue>): this;
+    /**
+     * Executes the query and returns a Promise that resolves with an array of items.
+     */
+    execute(): Promise<PaginatedResult<T>>;
+}
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/src/builders/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,qBAAa,YAAY,CAAC,CAAC;IAWvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAXb,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,wBAAwB,CAA8B;IAC9D,OAAO,CAAC,yBAAyB,CAAuC;IACxE,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAuC;IACvD,OAAO,CAAC,SAAS,CAAQ;gBAGf,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAclB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAyBnC,aAAa,IAAI,IAAI;IAKrB,cAAc,IAAI,IAAI;IAKtB,KAAK,CACV,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5C,IAAI;IA2EA,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAgDrE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAKrE;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAgCpD"}

package/dist/src/builders/query-builder.js

@@ -0,0 +1,171 @@
+/* eslint-disable no-unused-vars */
+import { QueryCommand, } from "@aws-sdk/lib-dynamodb";
+import {} from "../betterddb.js";
+import { getOperatorExpression } from "../operator.js";
+import {} from "../types/paginated-result.js";
+export class QueryBuilder {
+    parent;
+    key;
+    keyConditions = [];
+    filterConditions = [];
+    expressionAttributeNames = {};
+    expressionAttributeValues;
+    index;
+    limit;
+    lastKey;
+    ascending = true;
+    constructor(parent, key) {
+        this.parent = parent;
+        this.key = key;
+        const keys = this.parent.getKeys();
+        const pkName = keys.primary.name;
+        const builtKey = this.parent.buildKey(this.key);
+        this.expressionAttributeNames = {
+            "#pk": pkName,
+        };
+        this.expressionAttributeValues = {
+            ":pk_value": builtKey[pkName],
+        };
+    }
+    usingIndex(indexName) {
+        if (!this.parent.getKeys().gsis) {
+            throw new Error("No global secondary indexes defined for this table");
+        }
+        if (!(indexName in this.parent.getKeys().gsis)) {
+            throw new Error("index does not exist");
+        }
+        this.index = this.parent.getKeys().gsis[indexName];
+        if (!this.index) {
+            throw new Error("Failed to get index configuration");
+        }
+        const pkName = this.index.primary.name;
+        const builtKey = this.parent.buildIndexes(this.key);
+        this.expressionAttributeNames["#pk"] = pkName;
+        this.expressionAttributeValues[":pk_value"] = builtKey[pkName];
+        return this;
+    }
+    sortAscending() {
+        this.ascending = true;
+        return this;
+    }
+    sortDescending() {
+        this.ascending = false;
+        return this;
+    }
+    where(operator, values) {
+        const keys = this.parent.getKeys();
+        // Determine the sort key name from either the index or the primary keys.
+        const sortKeyName = this.index ? this.index.sort?.name : keys.sort?.name;
+        if (!sortKeyName) {
+            throw new Error("Sort key is not defined for this table/index.");
+        }
+        const nameKey = "#sk";
+        this.expressionAttributeNames[nameKey] = sortKeyName;
+        // Enforce that a complex sort key requires an object input.
+        if (typeof values !== "object" || values === null) {
+            throw new Error(`For complex sort keys, please provide an object with all necessary properties.`);
+        }
+        if (operator === "between") {
+            if (!Array.isArray(values) || values.length !== 2) {
+                throw new Error(`For 'between' operator, values must be a tuple of two objects`);
+            }
+            const valueKeyStart = ":sk_start";
+            const valueKeyEnd = ":sk_end";
+            // Use the key definition's build function to build the key from the full object.
+            this.expressionAttributeValues[valueKeyStart] = this.index
+                ? this.parent.buildIndexes(values[0])[sortKeyName]
+                : this.parent.buildKey(values[0])[sortKeyName];
+            this.expressionAttributeValues[valueKeyEnd] = this.index
+                ? this.parent.buildIndexes(values[1])[sortKeyName]
+                : this.parent.buildKey(values[1])[sortKeyName];
+            this.keyConditions.push(`${nameKey} BETWEEN ${valueKeyStart} AND ${valueKeyEnd}`);
+        }
+        else if (operator === "begins_with") {
+            const valueKey = ":sk_value";
+            this.expressionAttributeValues[valueKey] = this.index
+                ? this.parent.buildIndexes(values)[sortKeyName]
+                : this.parent.buildKey(values)[sortKeyName];
+            this.keyConditions.push(`begins_with(${nameKey}, ${valueKey})`);
+        }
+        else {
+            // For eq, lt, lte, gt, gte:
+            const valueKey = ":sk_value";
+            this.expressionAttributeValues[valueKey] = this.index
+                ? this.parent.buildIndexes(values)[sortKeyName]
+                : this.parent.buildKey(values)[sortKeyName];
+            const condition = getOperatorExpression(operator, nameKey, valueKey);
+            this.keyConditions.push(condition);
+        }
+        return this;
+    }
+    filter(attribute, operator, values) {
+        const attrStr = String(attribute);
+        const randomString = Math.random().toString(36).substring(2, 15);
+        const placeholderName = `#attr_${attrStr}_${randomString}`;
+        this.expressionAttributeNames[placeholderName] = attrStr;
+        if (operator === "between") {
+            if (!Array.isArray(values) || values.length !== 2) {
+                throw new Error("For 'between' operator, values must be a tuple of two items");
+            }
+            const placeholderValueStart = `:val_start_${attrStr}_${randomString}`;
+            const placeholderValueEnd = `:val_end_${attrStr}_${randomString}`;
+            this.expressionAttributeValues[placeholderValueStart] =
+                values[0];
+            this.expressionAttributeValues[placeholderValueEnd] = values[1];
+            this.filterConditions.push(`${placeholderName} BETWEEN ${placeholderValueStart} AND ${placeholderValueEnd}`);
+        }
+        else if (operator === "begins_with" || operator === "contains") {
+            const placeholderValue = `:val_${attrStr}_${randomString}`;
+            this.expressionAttributeValues[placeholderValue] = values;
+            this.filterConditions.push(`${operator}(${placeholderName}, ${placeholderValue})`);
+        }
+        else {
+            const placeholderValue = `:val_${attrStr}_${randomString}`;
+            this.expressionAttributeValues[placeholderValue] = values;
+            const condition = getOperatorExpression(operator, placeholderName, placeholderValue);
+            this.filterConditions.push(condition);
+        }
+        return this;
+    }
+    limitResults(limit) {
+        this.limit = limit;
+        return this;
+    }
+    startFrom(lastKey) {
+        this.lastKey = lastKey;
+        return this;
+    }
+    /**
+     * Executes the query and returns a Promise that resolves with an array of items.
+     */
+    async execute() {
+        this.keyConditions.unshift(`#pk = :pk_value`);
+        const keyConditionExpression = this.keyConditions.join(" AND ");
+        const params = {
+            TableName: this.parent.getTableName(),
+            KeyConditionExpression: keyConditionExpression,
+            ExpressionAttributeNames: this.expressionAttributeNames,
+            ExpressionAttributeValues: this.expressionAttributeValues,
+            ScanIndexForward: this.ascending,
+            Limit: this.limit,
+            ExclusiveStartKey: this.lastKey,
+            IndexName: this.index?.name ?? undefined,
+        };
+        if (this.parent.getEntityType()) {
+            this.filterConditions.push(`#entity = :entity_value`);
+            this.expressionAttributeNames["#entity"] = "entityType";
+            this.expressionAttributeValues[":entity_value"] =
+                this.parent.getEntityType();
+        }
+        params.FilterExpression =
+            this.filterConditions.length > 0
+                ? this.filterConditions.join(" AND ")
+                : undefined;
+        const result = await this.parent.getClient().send(new QueryCommand(params));
+        return {
+            items: this.parent.getSchema().array().parse(result.Items),
+            lastKey: result.LastEvaluatedKey ?? undefined,
+        };
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/src/builders/query-builder.js.map

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

package/dist/src/builders/scan-builder.d.ts

@@ -0,0 +1,21 @@
+import { type NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import { type BetterDDB } from "../betterddb.js";
+import { type Operator } from "../operator.js";
+import { type PaginatedResult } from "../types/paginated-result.js";
+export declare class ScanBuilder<T> {
+    private parent;
+    private filters;
+    private expressionAttributeNames;
+    private expressionAttributeValues;
+    private limit?;
+    private lastKey?;
+    constructor(parent: BetterDDB<T>);
+    where(attribute: keyof T, operator: Operator, values: unknown): this;
+    limitResults(limit: number): this;
+    startFrom(lastKey: Record<string, NativeAttributeValue>): this;
+    /**
+     * Executes the scan and returns a Promise that resolves with an array of items.
+     */
+    execute(): Promise<PaginatedResult<T>>;
+}
+//# sourceMappingURL=scan-builder.d.ts.map

package/dist/src/builders/scan-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/scan-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,qBAAa,WAAW,CAAC,CAAC;IAOZ,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,wBAAwB,CAA8B;IAC9D,OAAO,CAAC,yBAAyB,CAA4C;IAC7E,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAuC;gBAEnC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAEjC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IA0CpE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAKrE;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAwBpD"}

package/dist/src/builders/scan-builder.js

@@ -0,0 +1,76 @@
+/* eslint-disable no-unused-vars */
+import { ScanCommand, } from "@aws-sdk/lib-dynamodb";
+import {} from "../betterddb.js";
+import { getOperatorExpression } from "../operator.js";
+import {} from "../types/paginated-result.js";
+export class ScanBuilder {
+    parent;
+    filters = [];
+    expressionAttributeNames = {};
+    expressionAttributeValues = {};
+    limit;
+    lastKey;
+    constructor(parent) {
+        this.parent = parent;
+    }
+    where(attribute, operator, values) {
+        const attrStr = String(attribute);
+        const nameKey = `#attr_${attrStr}`;
+        this.expressionAttributeNames[nameKey] = attrStr;
+        if (operator === "between") {
+            if (!Array.isArray(values) || values.length !== 2) {
+                throw new Error(`For 'between' operator, values must be a tuple of two items`);
+            }
+            const valueKeyStart = `:val_start_${attrStr}`;
+            const valueKeyEnd = `:val_end_${attrStr}`;
+            this.expressionAttributeValues[valueKeyStart] = values[0];
+            this.expressionAttributeValues[valueKeyEnd] = values[1];
+            this.filters.push(`${nameKey} BETWEEN ${valueKeyStart} AND ${valueKeyEnd}`);
+        }
+        else if (operator === "begins_with" || operator === "contains") {
+            const valueKey = `:val_${attrStr}`;
+            this.expressionAttributeValues[valueKey] = values;
+            this.filters.push(`${operator}(${nameKey}, ${valueKey})`);
+        }
+        else {
+            const valueKey = `:val_${attrStr}`;
+            this.expressionAttributeValues[valueKey] = values;
+            const condition = getOperatorExpression(operator, nameKey, valueKey);
+            this.filters.push(condition);
+        }
+        return this;
+    }
+    limitResults(limit) {
+        this.limit = limit;
+        return this;
+    }
+    startFrom(lastKey) {
+        this.lastKey = lastKey;
+        return this;
+    }
+    /**
+     * Executes the scan and returns a Promise that resolves with an array of items.
+     */
+    async execute() {
+        const params = {
+            TableName: this.parent.getTableName(),
+            ExpressionAttributeNames: this.expressionAttributeNames,
+            ExpressionAttributeValues: this.expressionAttributeValues,
+            Limit: this.limit,
+            ExclusiveStartKey: this.lastKey,
+        };
+        if (this.parent.getEntityType()) {
+            this.filters.push(`#entity = :entity_value`);
+            this.expressionAttributeNames["#entity"] = "entityType";
+            this.expressionAttributeValues[":entity_value"] =
+                this.parent.getEntityType();
+        }
+        params.FilterExpression = this.filters.join(" AND ");
+        const result = await this.parent.getClient().send(new ScanCommand(params));
+        return {
+            items: this.parent.getSchema().array().parse(result.Items),
+            lastKey: result.LastEvaluatedKey ?? undefined,
+        };
+    }
+}
+//# sourceMappingURL=scan-builder.js.map

package/dist/src/builders/scan-builder.js.map

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

package/dist/src/builders/update-builder.d.ts

@@ -0,0 +1,37 @@
+import { type NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import { type BetterDDB } from "../betterddb.js";
+import { type TransactWriteItem } from "@aws-sdk/client-dynamodb";
+export declare class UpdateBuilder<T> {
+    private parent;
+    private key;
+    private actions;
+    private condition?;
+    private extraTransactItems;
+    constructor(parent: BetterDDB<T>, key: Partial<T>);
+    set(attrs: Partial<T>): this;
+    remove(attrs: (keyof T)[]): this;
+    add(attrs: Partial<Record<keyof T, number | Set<NativeAttributeValue>>>): this;
+    delete(attrs: Partial<Record<keyof T, Set<NativeAttributeValue>>>): this;
+    /**
+     * Adds a condition expression to the update.
+     */
+    setCondition(expression: string, attributeValues: Record<string, NativeAttributeValue>, attributeNames: Record<string, string>): this;
+    /**
+     * Specifies additional transaction items to include when executing this update as a transaction.
+     */
+    transactWrite(ops: TransactWriteItem[] | TransactWriteItem): this;
+    /**
+     * Builds the update expression and associated maps.
+     */
+    private buildExpression;
+    /**
+     * Returns a transaction update item that can be included in a transactWrite call.
+     */
+    toTransactUpdate(newItemForIndexes?: T): Promise<TransactWriteItem>;
+    private createExpectedNewItem;
+    /**
+     * Commits the update immediately by calling the parent's update method.
+     */
+    execute(): Promise<T>;
+}
+//# sourceMappingURL=update-builder.d.ts.map

package/dist/src/builders/update-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/update-builder.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,oBAAoB,EAI1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,0BAA0B,CAAC;AASlC,qBAAa,aAAa,CAAC,CAAC;IAYxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAZb,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAC,CAIhB;IAEF,OAAO,CAAC,kBAAkB,CAA2B;gBAI3C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAIlB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAkC5B,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IAKhC,GAAG,CACR,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAClE,IAAI;IAQA,MAAM,CACX,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,GACzD,IAAI;IAKP;;OAEG;IACI,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACrD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,IAAI;IAgBP;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,IAAI;IASxE;;OAEG;IACH,OAAO,CAAC,eAAe;IAmGvB;;OAEG;IACU,gBAAgB,CAC3B,iBAAiB,CAAC,EAAE,CAAC,GACpB,OAAO,CAAC,iBAAiB,CAAC;YAmBf,qBAAqB;IA2CnC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;CAqEnC"}