@expo/entity-database-adapter-knex 0.55.0 → 0.57.0

package/build/src/internal/EntityKnexDataManager.js

@@ -0,0 +1,453 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityKnexDataManager = void 0;
+const entity_1 = require("@expo/entity");
+const assert_1 = __importDefault(require("assert"));
+const BasePostgresEntityDatabaseAdapter_1 = require("../BasePostgresEntityDatabaseAdapter");
+const PaginationStrategy_1 = require("../PaginationStrategy");
+const SQLOperator_1 = require("../SQLOperator");
+function isDataManagerSearchFieldSQLFragmentFnSpecification(obj) {
+    return typeof obj === 'object' && obj !== null && 'fieldConstructor' in obj;
+}
+var PaginationDirection;
+(function (PaginationDirection) {
+    PaginationDirection["FORWARD"] = "forward";
+    PaginationDirection["BACKWARD"] = "backward";
+})(PaginationDirection || (PaginationDirection = {}));
+const CURSOR_ROW_TABLE_ALIAS = 'cursor_row';
+/**
+ * A knex data manager is responsible for handling non-dataloader-based
+ * database operations.
+ *
+ * @internal
+ */
+class EntityKnexDataManager {
+    entityConfiguration;
+    databaseAdapter;
+    metricsAdapter;
+    entityClassName;
+    constructor(entityConfiguration, databaseAdapter, metricsAdapter, entityClassName) {
+        this.entityConfiguration = entityConfiguration;
+        this.databaseAdapter = databaseAdapter;
+        this.metricsAdapter = metricsAdapter;
+        this.entityClassName = entityClassName;
+    }
+    /**
+     * Loads many objects matching the conjunction of where clauses constructed from
+     * specified field equality operands.
+     *
+     * @param queryContext - query context in which to perform the load
+     * @param fieldEqualityOperands - list of field equality where clause operand specifications
+     * @param querySelectionModifiers - limit, offset, and orderBy for the query
+     * @returns array of objects matching the query
+     */
+    async loadManyByFieldEqualityConjunctionAsync(queryContext, fieldEqualityOperands, querySelectionModifiers) {
+        EntityKnexDataManager.validateOrderByClauses(querySelectionModifiers.orderBy);
+        return await (0, entity_1.timeAndLogLoadEventAsync)(this.metricsAdapter, entity_1.EntityMetricsLoadType.LOAD_MANY_EQUALITY_CONJUNCTION, this.entityClassName, queryContext)(this.databaseAdapter.fetchManyByFieldEqualityConjunctionAsync(queryContext, fieldEqualityOperands, querySelectionModifiers));
+    }
+    /**
+     * Loads many objects matching the raw WHERE clause.
+     *
+     * @param queryContext - query context in which to perform the load
+     * @param rawWhereClause - parameterized SQL WHERE clause with positional binding placeholders or named binding placeholders
+     * @param bindings - array of positional bindings or object of named bindings
+     * @param querySelectionModifiers - limit, offset, orderBy, and orderByRaw for the query
+     * @returns array of objects matching the query
+     */
+    async loadManyByRawWhereClauseAsync(queryContext, rawWhereClause, bindings, querySelectionModifiers) {
+        EntityKnexDataManager.validateOrderByClauses(querySelectionModifiers.orderBy);
+        return await (0, entity_1.timeAndLogLoadEventAsync)(this.metricsAdapter, entity_1.EntityMetricsLoadType.LOAD_MANY_RAW, this.entityClassName, queryContext)(this.databaseAdapter.fetchManyByRawWhereClauseAsync(queryContext, rawWhereClause, bindings, querySelectionModifiers));
+    }
+    async loadManyBySQLFragmentAsync(queryContext, sqlFragment, querySelectionModifiers) {
+        EntityKnexDataManager.validateOrderByClauses(querySelectionModifiers.orderBy);
+        return await (0, entity_1.timeAndLogLoadEventAsync)(this.metricsAdapter, entity_1.EntityMetricsLoadType.LOAD_MANY_SQL, this.entityClassName, queryContext)(this.databaseAdapter.fetchManyBySQLFragmentAsync(queryContext, sqlFragment, querySelectionModifiers));
+    }
+    /**
+     * Load a page of objects using cursor-based pagination with unified pagination specification.
+     *
+     * @remarks
+     *
+     * This method implements cursor-based pagination using the seek method for efficient pagination even on large datasets
+     * given appropriate indexes. Cursors are opaque and encode the necessary information to fetch the next page based on the
+     * specified pagination strategy (standard, ILIKE search, or trigram search). For this implementation in particular,
+     * the cursor encodes the ID of the last entity in the page to ensure correct pagination for all strategies, even in cases
+     * where multiple rows have the same value for all fields other than the ID. If the entity referenced by a cursor has been
+     * deleted, the load will return an empty page with `hasNextPage: false`.
+     *
+     * @param queryContext - query context in which to perform the load
+     * @param args - pagination arguments including pagination and first/after or last/before
+     * @returns connection with edges containing field objects and page info
+     */
+    async loadPageAsync(queryContext, args) {
+        const { where, pagination } = args;
+        if (pagination.strategy === PaginationStrategy_1.PaginationStrategy.STANDARD) {
+            // Standard pagination
+            EntityKnexDataManager.validateOrderByClauses(pagination.orderBy);
+            EntityKnexDataManager.validateOrderByClausesHaveConsistentDirection(pagination.orderBy);
+            const idField = this.entityConfiguration.idField;
+            const augmentedOrderByClauses = this.augmentOrderByIfNecessary(pagination.orderBy, idField);
+            const fieldsToUseInPostgresTupleCursor = augmentedOrderByClauses.map((order) => 'fieldName' in order ? order.fieldName : order.fieldFragment);
+            // Create strategy for regular pagination
+            const strategy = {
+                whereClause: where,
+                buildOrderBy: (direction) => {
+                    // For backward pagination, we flip the ORDER BY and NULLS direction to fetch records
+                    // in reverse order. This allows us to use a simple "less than" cursor comparison
+                    // instead of complex SQL. We'll reverse the results array later to restore
+                    // the original requested order.
+                    // Example: If user wants last 3 items ordered by name ASC, we:
+                    // 1. Flip to name DESC to get the last items first
+                    // 2. Apply cursor with < comparison
+                    // 3. Reverse the final array to present items in name ASC order
+                    return direction === PaginationDirection.FORWARD
+                        ? augmentedOrderByClauses
+                        : augmentedOrderByClauses.map((clause) => ({
+                            ...clause,
+                            order: clause.order === BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING
+                                ? BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING
+                                : BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING,
+                            nulls: clause.nulls
+                                ? EntityKnexDataManager.flipNullsOrderingSpread(clause.nulls)
+                                : undefined,
+                        }));
+                },
+                buildCursorCondition: (decodedCursorId, _direction, orderByClauses) => {
+                    // all clauses are guaranteed to have the same order due to validation, so we can just look at the first one for effective ordering
+                    const effectiveOrdering = orderByClauses[0]?.order ?? BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING;
+                    return this.buildCursorCondition(decodedCursorId, fieldsToUseInPostgresTupleCursor, effectiveOrdering);
+                },
+            };
+            return await this.loadPageInternalAsync(queryContext, args, strategy);
+        }
+        else {
+            // Search pagination (ILIKE or TRIGRAM)
+            const search = pagination;
+            // Validate search parameters
+            (0, assert_1.default)(search.term.length > 0, 'Search term must be a non-empty string');
+            (0, assert_1.default)(search.fields.length > 0, 'Search fields must be a non-empty array');
+            const { searchWhere, searchOrderByClauses } = this.buildSearchConditionAndOrderBy(search);
+            // Combine WHERE conditions: base where + search where
+            const whereClause = where && searchWhere ? SQLOperator_1.SQLFragmentHelpers.and(where, searchWhere) : (where ?? searchWhere);
+            const fieldsToUseInPostgresTupleCursor = search.strategy === PaginationStrategy_1.PaginationStrategy.TRIGRAM_SEARCH
+                ? // For trigram search, cursor includes extra order by fields (if specified) + ID to ensure stable ordering that matches ORDER BY clause
+                    [...(search.extraOrderByFields ?? []), this.entityConfiguration.idField]
+                : // For ILIKE search, cursor includes search fields + ID to ensure stable ordering that matches ORDER BY clause
+                    [...search.fields, this.entityConfiguration.idField];
+            // Create strategy for search pagination
+            const strategy = {
+                whereClause,
+                buildOrderBy: (direction) => {
+                    return direction === PaginationDirection.FORWARD
+                        ? searchOrderByClauses
+                        : searchOrderByClauses.map((clause) => ({
+                            ...clause,
+                            order: clause.order === BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING
+                                ? BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING
+                                : BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING,
+                        }));
+                },
+                buildCursorCondition: (decodedCursorId, direction) => search.strategy === PaginationStrategy_1.PaginationStrategy.TRIGRAM_SEARCH
+                    ? this.buildTrigramCursorCondition(search, decodedCursorId, direction)
+                    : this.buildCursorCondition(decodedCursorId, fieldsToUseInPostgresTupleCursor, 
+                    // ILIKE search always orders ASC, so effective ordering matches direction
+                    direction === PaginationDirection.FORWARD
+                        ? BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING
+                        : BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING),
+            };
+            return await this.loadPageInternalAsync(queryContext, args, strategy);
+        }
+    }
+    getCursorForEntityID(entityID) {
+        return this.encodeOpaqueCursor(entityID);
+    }
+    /**
+     * Internal method for loading a page with cursor-based pagination.
+     * Shared logic for both regular and search pagination.
+     */
+    async loadPageInternalAsync(queryContext, args, paginationProvider) {
+        const idField = this.entityConfiguration.idField;
+        // Validate pagination arguments
+        const maxPageSize = this.databaseAdapter.paginationMaxPageSize;
+        const isForward = 'first' in args && args.first !== undefined;
+        if (isForward) {
+            (0, assert_1.default)(Number.isInteger(args.first) && args.first > 0, 'first must be an integer greater than 0');
+            if (maxPageSize !== undefined) {
+                (0, assert_1.default)(args.first <= maxPageSize, `first must not exceed maximum page size of ${maxPageSize}`);
+            }
+        }
+        else {
+            (0, assert_1.default)(Number.isInteger(args.last) && args.last > 0, 'last must be an integer greater than 0');
+            if (maxPageSize !== undefined) {
+                (0, assert_1.default)(args.last <= maxPageSize, `last must not exceed maximum page size of ${maxPageSize}`);
+            }
+        }
+        const direction = isForward ? PaginationDirection.FORWARD : PaginationDirection.BACKWARD;
+        const limit = isForward ? args.first : args.last;
+        const cursor = isForward ? args.after : args.before;
+        // Decode cursor
+        const decodedExternalCursorEntityID = cursor ? this.decodeOpaqueCursor(cursor) : null;
+        // Get ordering from strategy
+        const orderByClauses = paginationProvider.buildOrderBy(direction);
+        // Build WHERE clause with cursor condition
+        const baseWhere = paginationProvider.whereClause;
+        const cursorCondition = decodedExternalCursorEntityID
+            ? paginationProvider.buildCursorCondition(decodedExternalCursorEntityID, direction, orderByClauses)
+            : null;
+        const whereClause = this.combineWhereConditions(baseWhere, cursorCondition);
+        // Determine query modifiers
+        const queryModifiers = {
+            ...(orderByClauses !== undefined && { orderBy: orderByClauses }),
+            limit: limit + 1, // Fetch data with limit + 1 to check for more pages
+        };
+        const fieldObjects = await (0, entity_1.timeAndLogLoadEventAsync)(this.metricsAdapter, entity_1.EntityMetricsLoadType.LOAD_PAGE, this.entityClassName, queryContext)(this.databaseAdapter.fetchManyBySQLFragmentAsync(queryContext, whereClause, queryModifiers));
+        // Process results
+        const hasMore = fieldObjects.length > limit;
+        const pageFieldObjects = hasMore ? fieldObjects.slice(0, limit) : [...fieldObjects];
+        if (direction === PaginationDirection.BACKWARD) {
+            // Restore the original requested order by reversing the results.
+            // We fetched with flipped ORDER BY for efficient cursor comparison,
+            // so now we reverse to match the order the user expects.
+            pageFieldObjects.reverse();
+        }
+        // Build edges with cursors
+        const edges = pageFieldObjects.map((fieldObject) => ({
+            node: fieldObject,
+            cursor: this.encodeOpaqueCursor(fieldObject[idField]),
+        }));
+        const pageInfo = {
+            hasNextPage: direction === PaginationDirection.FORWARD ? hasMore : false,
+            hasPreviousPage: direction === PaginationDirection.BACKWARD ? hasMore : false,
+            startCursor: edges[0]?.cursor ?? null,
+            endCursor: edges[edges.length - 1]?.cursor ?? null,
+        };
+        return {
+            edges,
+            pageInfo,
+        };
+    }
+    combineWhereConditions(baseWhere, cursorCondition) {
+        const conditions = [baseWhere, cursorCondition].filter((it) => !!it);
+        if (conditions.length === 0) {
+            return (0, SQLOperator_1.sql) `1 = 1`;
+        }
+        if (conditions.length === 1) {
+            return conditions[0];
+        }
+        // Wrap baseWhere in parens if combining with cursor condition
+        // We know we have exactly 2 conditions at this point
+        const [first, second] = conditions;
+        return (0, SQLOperator_1.sql) `(${first}) AND ${second}`;
+    }
+    augmentOrderByIfNecessary(orderBy, idField) {
+        const clauses = orderBy ?? [];
+        // Always ensure ID is included for stability and cursor correctness. Note that this may add a redundant order by
+        // if ID is already included as a fragment, but that is preferable to the risk of incorrect pagination behavior.
+        const hasId = clauses.some((spec) => 'fieldName' in spec && spec.fieldName === idField);
+        if (!hasId) {
+            const lastClauseOrder = clauses.length > 0 ? clauses[clauses.length - 1].order : BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING;
+            return [...clauses, { fieldName: idField, order: lastClauseOrder }];
+        }
+        return clauses;
+    }
+    static flipNullsOrderingSpread(nulls) {
+        return nulls === BasePostgresEntityDatabaseAdapter_1.NullsOrdering.FIRST ? BasePostgresEntityDatabaseAdapter_1.NullsOrdering.LAST : BasePostgresEntityDatabaseAdapter_1.NullsOrdering.FIRST;
+    }
+    static validateOrderByClauses(orderBy) {
+        if (orderBy === undefined) {
+            return;
+        }
+        for (const clause of orderBy) {
+            if ('fieldFragment' in clause) {
+                const trimmedSql = clause.fieldFragment.sql.trimEnd();
+                (0, assert_1.default)(!/\b(ASC|DESC)\s*$/i.test(trimmedSql), 'fieldFragment must not contain ASC or DESC at the end. Use the order property to specify ordering direction.');
+            }
+        }
+    }
+    /**
+     * Cursor-based pagination uses Postgres tuple comparison (e.g., (a, b) \> (x, y)) which
+     * applies a single comparison direction to all columns. Mixed ordering directions would
+     * produce incorrect pagination results.
+     */
+    static validateOrderByClausesHaveConsistentDirection(orderBy) {
+        if (orderBy === undefined || orderBy.length <= 1) {
+            return;
+        }
+        const firstOrder = orderBy[0].order;
+        (0, assert_1.default)(orderBy.every((clause) => clause.order === firstOrder), 'All orderBy clauses must have the same ordering direction. Mixed ordering directions are not supported with cursor-based pagination.');
+    }
+    encodeOpaqueCursor(idField) {
+        return Buffer.from(JSON.stringify({ id: idField })).toString('base64url');
+    }
+    decodeOpaqueCursor(cursor) {
+        let parsedCursor;
+        try {
+            const decoded = Buffer.from(cursor, 'base64url').toString();
+            parsedCursor = JSON.parse(decoded);
+        }
+        catch (e) {
+            throw new entity_1.EntityDatabaseAdapterPaginationCursorInvalidError(`Failed to decode cursor`, e instanceof Error ? e : undefined);
+        }
+        if (!('id' in parsedCursor)) {
+            throw new entity_1.EntityDatabaseAdapterPaginationCursorInvalidError(`Cursor is missing required 'id' field. Parsed cursor: ${JSON.stringify(parsedCursor)}`);
+        }
+        return parsedCursor.id;
+    }
+    resolveSearchFieldToSQLFragment(field, tableAlias) {
+        if (field instanceof SQLOperator_1.SQLFragment) {
+            return field;
+        }
+        if (isDataManagerSearchFieldSQLFragmentFnSpecification(field)) {
+            return field.fieldConstructor((fieldName) => {
+                const dbField = (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, fieldName);
+                return tableAlias
+                    ? (0, SQLOperator_1.sql) `${(0, SQLOperator_1.unsafeRaw)(tableAlias)}.${(0, SQLOperator_1.identifier)(dbField)}`
+                    : (0, SQLOperator_1.sql) `${(0, SQLOperator_1.identifier)(dbField)}`;
+            });
+        }
+        const dbField = (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, field);
+        return tableAlias
+            ? (0, SQLOperator_1.sql) `${(0, SQLOperator_1.unsafeRaw)(tableAlias)}.${(0, SQLOperator_1.identifier)(dbField)}`
+            : (0, SQLOperator_1.sql) `${(0, SQLOperator_1.identifier)(dbField)}`;
+    }
+    buildCursorCondition(decodedExternalCursorEntityID, fieldsToUseInPostgresTupleCursor, effectiveOrdering) {
+        // We build a tuple comparison for fieldsToUseInPostgresTupleCursor fields of the
+        // entity identified by the external cursor to ensure correct pagination behavior
+        // even in cases where multiple rows have the same value all fields other than id.
+        // If the cursor entity has been deleted, the subquery returns no rows and the
+        // comparison evaluates to NULL, filtering out all results (empty page).
+        const operator = effectiveOrdering === BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING ? '>' : '<';
+        const idField = (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, this.entityConfiguration.idField);
+        const tableName = this.entityConfiguration.tableName;
+        const postgresCursorFieldIdentifiers = fieldsToUseInPostgresTupleCursor.map((f) => this.resolveSearchFieldToSQLFragment(f));
+        // Build left side of comparison (current row's computed values)
+        const leftSide = SQLOperator_1.SQLFragment.joinWithCommaSeparator(...postgresCursorFieldIdentifiers);
+        // Build right side using subquery to get computed values for cursor entity.
+        // For field names, qualify with the cursor row alias. For SQL fragments,
+        // use as-is since unqualified column names resolve to the only table in the subquery.
+        const postgresCursorRowFieldIdentifiers = fieldsToUseInPostgresTupleCursor.map((f) => this.resolveSearchFieldToSQLFragment(f, CURSOR_ROW_TABLE_ALIAS));
+        // Build SELECT fields for subquery
+        const rightSideSubquery = (0, SQLOperator_1.sql) `
+      SELECT ${SQLOperator_1.SQLFragment.joinWithCommaSeparator(...postgresCursorRowFieldIdentifiers)}
+      FROM ${(0, SQLOperator_1.identifier)(tableName)} AS ${(0, SQLOperator_1.unsafeRaw)(CURSOR_ROW_TABLE_ALIAS)}
+      WHERE ${(0, SQLOperator_1.unsafeRaw)(CURSOR_ROW_TABLE_ALIAS)}.${(0, SQLOperator_1.identifier)(idField)} = ${decodedExternalCursorEntityID}
+    `;
+        return (0, SQLOperator_1.sql) `(${leftSide}) ${(0, SQLOperator_1.unsafeRaw)(operator)} (${rightSideSubquery})`;
+    }
+    buildILikeConditions(search, tableAlias) {
+        return search.fields.map((field) => {
+            const fieldFragment = this.resolveSearchFieldToSQLFragment(field, tableAlias);
+            return (0, SQLOperator_1.sql) `${fieldFragment} ILIKE ${'%' + EntityKnexDataManager.escapeILikePattern(search.term) + '%'}`;
+        });
+    }
+    buildTrigramSimilarityExpressions(search, tableAlias) {
+        return search.fields.map((field) => {
+            const fieldFragment = this.resolveSearchFieldToSQLFragment(field, tableAlias);
+            return (0, SQLOperator_1.sql) `similarity(${fieldFragment}, ${search.term})`;
+        });
+    }
+    buildTrigramExactMatchCaseExpression(search, tableAlias) {
+        const ilikeConditions = this.buildILikeConditions(search, tableAlias);
+        return (0, SQLOperator_1.sql) `CASE WHEN ${SQLOperator_1.SQLFragmentHelpers.or(...ilikeConditions)} THEN 1 ELSE 0 END`;
+    }
+    buildTrigramSimilarityGreatestExpression(search, tableAlias) {
+        const similarityExprs = this.buildTrigramSimilarityExpressions(search, tableAlias);
+        return (0, SQLOperator_1.sql) `GREATEST(${SQLOperator_1.SQLFragment.joinWithCommaSeparator(...similarityExprs)})`;
+    }
+    buildTrigramCursorCondition(search, decodedExternalCursorEntityID, direction) {
+        // For TRIGRAM search, we compute the similarity values using a subquery, similar to normal cursor.
+        // If the cursor entity has been deleted, the subquery returns no rows and the
+        // comparison evaluates to NULL, filtering out all results (empty page).
+        const operator = direction === PaginationDirection.FORWARD ? '<' : '>';
+        const idField = (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, this.entityConfiguration.idField);
+        const exactMatchExpr = this.buildTrigramExactMatchCaseExpression(search);
+        const similarityExpr = this.buildTrigramSimilarityGreatestExpression(search);
+        // Build extra order by fields
+        const extraOrderByFields = search.extraOrderByFields;
+        const extraFields = extraOrderByFields?.map((f) => this.resolveSearchFieldToSQLFragment(f)) ?? [];
+        // Build left side of comparison (current row's computed values)
+        const leftSide = SQLOperator_1.SQLFragment.joinWithCommaSeparator(exactMatchExpr, similarityExpr, ...extraFields, (0, SQLOperator_1.sql) `${(0, SQLOperator_1.identifier)(idField)}`);
+        // Build right side using subquery to get computed values for cursor entity
+        // We need to rebuild the same expressions for the cursor row
+        const cursorExactMatchExpr = this.buildTrigramExactMatchCaseExpression(search, CURSOR_ROW_TABLE_ALIAS);
+        const cursorSimilarityExpr = this.buildTrigramSimilarityGreatestExpression(search, CURSOR_ROW_TABLE_ALIAS);
+        const cursorExtraFields = extraOrderByFields?.map((f) => this.resolveSearchFieldToSQLFragment(f, CURSOR_ROW_TABLE_ALIAS)) ?? [];
+        // Build SELECT fields for subquery
+        const selectFields = [
+            cursorExactMatchExpr,
+            cursorSimilarityExpr,
+            ...cursorExtraFields,
+            (0, SQLOperator_1.sql) `${(0, SQLOperator_1.unsafeRaw)(CURSOR_ROW_TABLE_ALIAS)}.${(0, SQLOperator_1.identifier)(idField)}`,
+        ];
+        const rightSideSubquery = (0, SQLOperator_1.sql) `
+      SELECT ${SQLOperator_1.SQLFragment.joinWithCommaSeparator(...selectFields)}
+      FROM ${(0, SQLOperator_1.identifier)(this.entityConfiguration.tableName)} AS ${(0, SQLOperator_1.unsafeRaw)(CURSOR_ROW_TABLE_ALIAS)}
+      WHERE ${(0, SQLOperator_1.unsafeRaw)(CURSOR_ROW_TABLE_ALIAS)}.${(0, SQLOperator_1.identifier)(idField)} = ${decodedExternalCursorEntityID}
+    `;
+        return (0, SQLOperator_1.sql) `(${leftSide}) ${(0, SQLOperator_1.unsafeRaw)(operator)} (${rightSideSubquery})`;
+    }
+    buildSearchConditionAndOrderBy(search) {
+        switch (search.strategy) {
+            case PaginationStrategy_1.PaginationStrategy.ILIKE_SEARCH: {
+                const conditions = this.buildILikeConditions(search);
+                // Order by search fields + ID to match cursor fields
+                const searchOrderByClauses = [
+                    ...search.fields.map((field) => ({
+                        fieldFragment: this.resolveSearchFieldToSQLFragment(field),
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING,
+                    })),
+                    {
+                        fieldName: this.entityConfiguration.idField,
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.ASCENDING,
+                    },
+                ];
+                return {
+                    searchWhere: conditions.length > 0 ? SQLOperator_1.SQLFragmentHelpers.or(...conditions) : (0, SQLOperator_1.sql) `1 = 0`,
+                    searchOrderByClauses,
+                };
+            }
+            case PaginationStrategy_1.PaginationStrategy.TRIGRAM_SEARCH: {
+                // PostgreSQL trigram similarity
+                const ilikeConditions = this.buildILikeConditions(search);
+                const similarityExprs = this.buildTrigramSimilarityExpressions(search);
+                (0, assert_1.default)(search.threshold >= 0 && search.threshold <= 1, `Trigram similarity threshold must be between 0 and 1, got ${search.threshold}`);
+                const conditions = similarityExprs.map((expr) => (0, SQLOperator_1.sql) `${expr} > ${search.threshold}`);
+                // Combine exact matches (ILIKE) with similarity
+                const allConditions = [...ilikeConditions, ...conditions];
+                // Build ORDER BY clauses for trigram search:
+                // 1. Exact matches first (ILIKE)
+                // 2. Then by similarity score
+                // 3. Then by extra fields and ID field for stability
+                const searchOrderByClauses = [
+                    {
+                        fieldFragment: this.buildTrigramExactMatchCaseExpression(search),
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING,
+                    },
+                    {
+                        fieldFragment: this.buildTrigramSimilarityGreatestExpression(search),
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING,
+                    },
+                    ...(search.extraOrderByFields ?? []).map((field) => ({
+                        fieldFragment: this.resolveSearchFieldToSQLFragment(field),
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING,
+                    })),
+                    {
+                        fieldName: this.entityConfiguration.idField,
+                        order: BasePostgresEntityDatabaseAdapter_1.OrderByOrdering.DESCENDING,
+                    },
+                ];
+                return {
+                    searchWhere: SQLOperator_1.SQLFragmentHelpers.or(...allConditions),
+                    searchOrderByClauses,
+                };
+            }
+        }
+    }
+    static escapeILikePattern(term) {
+        return term.replace(/[%_\\]/g, '\\$&');
+    }
+}
+exports.EntityKnexDataManager = EntityKnexDataManager;
+//# sourceMappingURL=EntityKnexDataManager.js.map

package/build/src/internal/EntityKnexDataManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityKnexDataManager.js","sourceRoot":"","sources":["../../../src/internal/EntityKnexDataManager.ts"],"names":[],"mappings":";;;;;;AAAA,yCAQsB;AACtB,oDAA4B;AAE5B,4FAO8C;AAC9C,8DAA2D;AAC3D,gDAA6F;AAkB7F,SAAS,kDAAkD,CACzD,GAG6D;IAE7D,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,kBAAkB,IAAI,GAAG,CAAC;AAC9E,CAAC;AAsFD,IAAK,mBAGJ;AAHD,WAAK,mBAAmB;IACtB,0CAAmB,CAAA;IACnB,4CAAqB,CAAA;AACvB,CAAC,EAHI,mBAAmB,KAAnB,mBAAmB,QAGvB;AAED,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAY5C;;;;;GAKG;AACH,MAAa,qBAAqB;IAKb;IACA;IACA;IACA;IAJnB,YACmB,mBAA2D,EAC3D,eAAqE,EACrE,cAAqC,EACrC,eAAuB;QAHvB,wBAAmB,GAAnB,mBAAmB,CAAwC;QAC3D,oBAAe,GAAf,eAAe,CAAsD;QACrE,mBAAc,GAAd,cAAc,CAAuB;QACrC,oBAAe,GAAf,eAAe,CAAQ;IACvC,CAAC;IAEJ;;;;;;;;OAQG;IACH,KAAK,CAAC,uCAAuC,CAC3C,YAAgC,EAChC,qBAAoE,EACpE,uBAAiE;QAEjE,qBAAqB,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAE9E,OAAO,MAAM,IAAA,iCAAwB,EACnC,IAAI,CAAC,cAAc,EACnB,8BAAqB,CAAC,8BAA8B,EACpD,IAAI,CAAC,eAAe,EACpB,YAAY,CACb,CACC,IAAI,CAAC,eAAe,CAAC,wCAAwC,CAC3D,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,CACxB,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,6BAA6B,CACjC,YAAgC,EAChC,cAAsB,EACtB,QAAiC,EACjC,uBAAiE;QAEjE,qBAAqB,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAE9E,OAAO,MAAM,IAAA,iCAAwB,EACnC,IAAI,CAAC,cAAc,EACnB,8BAAqB,CAAC,aAAa,EACnC,IAAI,CAAC,eAAe,EACpB,YAAY,CACb,CACC,IAAI,CAAC,eAAe,CAAC,8BAA8B,CACjD,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,uBAAuB,CACxB,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,YAAgC,EAChC,WAAiC,EACjC,uBAAiE;QAEjE,qBAAqB,CAAC,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAE9E,OAAO,MAAM,IAAA,iCAAwB,EACnC,IAAI,CAAC,cAAc,EACnB,8BAAqB,CAAC,aAAa,EACnC,IAAI,CAAC,eAAe,EACpB,YAAY,CACb,CACC,IAAI,CAAC,eAAe,CAAC,2BAA2B,CAC9C,YAAY,EACZ,WAAW,EACX,uBAAuB,CACxB,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,aAAa,CACjB,YAAgC,EAChC,IAA2B;QAE3B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEnC,IAAI,UAAU,CAAC,QAAQ,KAAK,uCAAkB,CAAC,QAAQ,EAAE,CAAC;YACxD,sBAAsB;YACtB,qBAAqB,CAAC,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACjE,qBAAqB,CAAC,6CAA6C,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAExF,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;YACjD,MAAM,uBAAuB,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE5F,MAAM,gCAAgC,GACpC,uBAAuB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACpC,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAC7D,CAAC;YAEJ,yCAAyC;YACzC,MAAM,QAAQ,GAA0C;gBACtD,WAAW,EAAE,KAAK;gBAClB,YAAY,EAAE,CAAC,SAA8B,EAAE,EAAE;oBAC/C,qFAAqF;oBACrF,iFAAiF;oBACjF,2EAA2E;oBAC3E,gCAAgC;oBAChC,+DAA+D;oBAC/D,mDAAmD;oBACnD,oCAAoC;oBACpC,gEAAgE;oBAChE,OAAO,SAAS,KAAK,mBAAmB,CAAC,OAAO;wBAC9C,CAAC,CAAC,uBAAuB;wBACzB,CAAC,CAAC,uBAAuB,CAAC,GAAG,CACzB,CAAC,MAAM,EAAkC,EAAE,CAAC,CAAC;4BAC3C,GAAG,MAAM;4BACT,KAAK,EACH,MAAM,CAAC,KAAK,KAAK,mDAAe,CAAC,SAAS;gCACxC,CAAC,CAAC,mDAAe,CAAC,UAAU;gCAC5B,CAAC,CAAC,mDAAe,CAAC,SAAS;4BAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;gCACjB,CAAC,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC;gCAC7D,CAAC,CAAC,SAAS;yBACd,CAAC,CACH,CAAC;gBACR,CAAC;gBACD,oBAAoB,EAAE,CAAC,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE;oBACpE,mIAAmI;oBACnI,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,mDAAe,CAAC,SAAS,CAAC;oBAChF,OAAO,IAAI,CAAC,oBAAoB,CAC9B,eAAe,EACf,gCAAgC,EAChC,iBAAiB,CAClB,CAAC;gBACJ,CAAC;aACF,CAAC;YAEF,OAAO,MAAM,IAAI,CAAC,qBAAqB,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,MAAM,MAAM,GAAG,UAAU,CAAC;YAE1B,6BAA6B;YAC7B,IAAA,gBAAM,EAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,wCAAwC,CAAC,CAAC;YACzE,IAAA,gBAAM,EAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,yCAAyC,CAAC,CAAC;YAE5E,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;YAE1F,sDAAsD;YACtD,MAAM,WAAW,GACf,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,gCAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC;YAE7F,MAAM,gCAAgC,GACpC,MAAM,CAAC,QAAQ,KAAK,uCAAkB,CAAC,cAAc;gBACnD,CAAC,CAAC,uIAAuI;oBACvI,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC1E,CAAC,CAAC,8GAA8G;oBAC9G,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAE3D,wCAAwC;YACxC,MAAM,QAAQ,GAA0C;gBACtD,WAAW;gBACX,YAAY,EAAE,CAAC,SAAS,EAAE,EAAE;oBAC1B,OAAO,SAAS,KAAK,mBAAmB,CAAC,OAAO;wBAC9C,CAAC,CAAC,oBAAoB;wBACtB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CACtB,CAAC,MAAM,EAA6D,EAAE,CAAC,CAAC;4BACtE,GAAG,MAAM;4BACT,KAAK,EACH,MAAM,CAAC,KAAK,KAAK,mDAAe,CAAC,SAAS;gCACxC,CAAC,CAAC,mDAAe,CAAC,UAAU;gCAC5B,CAAC,CAAC,mDAAe,CAAC,SAAS;yBAChC,CAAC,CACH,CAAC;gBACR,CAAC;gBACD,oBAAoB,EAAE,CAAC,eAAe,EAAE,SAAS,EAAE,EAAE,CACnD,MAAM,CAAC,QAAQ,KAAK,uCAAkB,CAAC,cAAc;oBACnD,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC;oBACtE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CACvB,eAAe,EACf,gCAAgC;oBAChC,0EAA0E;oBAC1E,SAAS,KAAK,mBAAmB,CAAC,OAAO;wBACvC,CAAC,CAAC,mDAAe,CAAC,SAAS;wBAC3B,CAAC,CAAC,mDAAe,CAAC,UAAU,CAC/B;aACR,CAAC;YAEF,OAAO,MAAM,IAAI,CAAC,qBAAqB,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,QAA2B;QAC9C,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB,CACjC,YAAgC,EAChC,IAA2B,EAC3B,kBAAyD;QAEzD,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;QAEjD,gCAAgC;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC;QAC/D,MAAM,SAAS,GAAG,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,IAAA,gBAAM,EACJ,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAC9C,yCAAyC,CAC1C,CAAC;YACF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAA,gBAAM,EACJ,IAAI,CAAC,KAAK,IAAI,WAAW,EACzB,8CAA8C,WAAW,EAAE,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAA,gBAAM,EACJ,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAC5C,wCAAwC,CACzC,CAAC;YACF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAA,gBAAM,EACJ,IAAI,CAAC,IAAI,IAAI,WAAW,EACxB,6CAA6C,WAAW,EAAE,CAC3D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC;QACzF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAEpD,gBAAgB;QAChB,MAAM,6BAA6B,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtF,6BAA6B;QAC7B,MAAM,cAAc,GAAG,kBAAkB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAElE,2CAA2C;QAC3C,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC;QACjD,MAAM,eAAe,GAAG,6BAA6B;YACnD,CAAC,CAAC,kBAAkB,CAAC,oBAAoB,CACrC,6BAA6B,EAC7B,SAAS,EACT,cAAc,CACf;YACH,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAE5E,4BAA4B;QAC5B,MAAM,cAAc,GAA6C;YAC/D,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;YAChE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,oDAAoD;SACvE,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,IAAA,iCAAwB,EACjD,IAAI,CAAC,cAAc,EACnB,8BAAqB,CAAC,SAAS,EAC/B,IAAI,CAAC,eAAe,EACpB,YAAY,CACb,CAAC,IAAI,CAAC,eAAe,CAAC,2BAA2B,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;QAE/F,kBAAkB;QAClB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,KAAK,CAAC;QAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;QAEpF,IAAI,SAAS,KAAK,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAC/C,iEAAiE;YACjE,oEAAoE;YACpE,yDAAyD;YACzD,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;QAED,2BAA2B;QAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;SACtD,CAAC,CAAC,CAAC;QAEJ,MAAM,QAAQ,GAAa;YACzB,WAAW,EAAE,SAAS,KAAK,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACxE,eAAe,EAAE,SAAS,KAAK,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YAC7E,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI;YACrC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI;SACnD,CAAC;QAEF,OAAO;YACL,KAAK;YACL,QAAQ;SACT,CAAC;IACJ,CAAC;IAEO,sBAAsB,CAC5B,SAA2C,EAC3C,eAA4C;QAE5C,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAA,iBAAG,EAAA,OAAO,CAAC;QACpB,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC;QACxB,CAAC;QACD,8DAA8D;QAC9D,qDAAqD;QACrD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC;QACnC,OAAO,IAAA,iBAAG,EAAA,IAAI,KAAK,SAAS,MAAM,EAAE,CAAC;IACvC,CAAC;IAEO,yBAAyB,CAC/B,OAA8D,EAC9D,OAAiB;QAEjB,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAE9B,iHAAiH;QACjH,gHAAgH;QAChH,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,eAAe,GACnB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,mDAAe,CAAC,SAAS,CAAC;YACtF,OAAO,CAAC,GAAG,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,uBAAuB,CACpC,KAAgC;QAEhC,OAAO,KAAK,KAAK,iDAAa,CAAC,KAAK,CAAC,CAAC,CAAC,iDAAa,CAAC,IAAI,CAAC,CAAC,CAAC,iDAAa,CAAC,KAAK,CAAC;IAClF,CAAC;IAEO,MAAM,CAAC,sBAAsB,CACnC,OAA8D;QAE9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,eAAe,IAAI,MAAM,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACtD,IAAA,gBAAM,EACJ,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EACrC,8GAA8G,CAC/G,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,6CAA6C,CAC1D,OAA8D;QAE9D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC;QACrC,IAAA,gBAAM,EACJ,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,CAAC,EACtD,sIAAsI,CACvI,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,OAA0B;QACnD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5E,CAAC;IAEO,kBAAkB,CAAC,MAAc;QACvC,IAAI,YAAiB,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5D,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,0DAAiD,CACzD,yBAAyB,EACzB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACnC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,0DAAiD,CACzD,yDAAyD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CACxF,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CAAC,EAAE,CAAC;IACzB,CAAC;IAEO,+BAA+B,CACrC,KAG6D,EAC7D,UAA0C;QAE1C,IAAI,KAAK,YAAY,yBAAW,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,kDAAkD,CAAU,KAAK,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;gBAC1C,MAAM,OAAO,GAAG,IAAA,uCAA8B,EAAC,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;gBACpF,OAAO,UAAU;oBACf,CAAC,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAA,uBAAS,EAAC,UAAU,CAAC,IAAI,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE;oBACtD,CAAC,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YAClC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,uCAA8B,EAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAChF,OAAO,UAAU;YACf,CAAC,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAA,uBAAS,EAAC,UAAU,CAAC,IAAI,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE;YACtD,CAAC,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;IAClC,CAAC;IAEO,oBAAoB,CAC1B,6BAAgD,EAChD,gCAIG,EACH,iBAAkC;QAElC,iFAAiF;QACjF,iFAAiF;QACjF,kFAAkF;QAClF,8EAA8E;QAC9E,wEAAwE;QACxE,MAAM,QAAQ,GAAG,iBAAiB,KAAK,mDAAe,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAE7E,MAAM,OAAO,GAAG,IAAA,uCAA8B,EAC5C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,mBAAmB,CAAC,OAAO,CACjC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC;QAErD,MAAM,8BAA8B,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChF,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC,CACxC,CAAC;QAEF,gEAAgE;QAChE,MAAM,QAAQ,GAAG,yBAAW,CAAC,sBAAsB,CAAC,GAAG,8BAA8B,CAAC,CAAC;QAEvF,4EAA4E;QAC5E,yEAAyE;QACzE,sFAAsF;QACtF,MAAM,iCAAiC,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnF,IAAI,CAAC,+BAA+B,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAChE,CAAC;QAEF,mCAAmC;QACnC,MAAM,iBAAiB,GAAG,IAAA,iBAAG,EAAA;eAClB,yBAAW,CAAC,sBAAsB,CAAC,GAAG,iCAAiC,CAAC;aAC1E,IAAA,wBAAU,EAAC,SAAS,CAAC,OAAO,IAAA,uBAAS,EAAC,sBAAsB,CAAC;cAC5D,IAAA,uBAAS,EAAC,sBAAsB,CAAC,IAAI,IAAA,wBAAU,EAAC,OAAO,CAAC,MAAM,6BAA6B;KACpG,CAAC;QACF,OAAO,IAAA,iBAAG,EAAA,IAAI,QAAQ,KAAK,IAAA,uBAAS,EAAC,QAAQ,CAAC,KAAK,iBAAiB,GAAG,CAAC;IAC1E,CAAC;IAEO,oBAAoB,CAC1B,MAA+C,EAC/C,UAA0C;QAE1C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,aAAa,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC9E,OAAO,IAAA,iBAAG,EAAA,GAAG,aAAa,UAAU,GAAG,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QAC1G,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iCAAiC,CACvC,MAA+C,EAC/C,UAA0C;QAE1C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,aAAa,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAC9E,OAAO,IAAA,iBAAG,EAAA,cAAc,aAAa,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,oCAAoC,CAC1C,MAA+C,EAC/C,UAA0C;QAE1C,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACtE,OAAO,IAAA,iBAAG,EAAA,aAAa,gCAAkB,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,oBAAoB,CAAC;IACvF,CAAC;IAEO,wCAAwC,CAC9C,MAA+C,EAC/C,UAA0C;QAE1C,MAAM,eAAe,GAAG,IAAI,CAAC,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnF,OAAO,IAAA,iBAAG,EAAA,YAAY,yBAAW,CAAC,sBAAsB,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC;IAClF,CAAC;IAEO,2BAA2B,CACjC,MAAsD,EACtD,6BAAgD,EAChD,SAA8B;QAE9B,mGAAmG;QACnG,8EAA8E;QAC9E,wEAAwE;QACxE,MAAM,QAAQ,GAAG,SAAS,KAAK,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACvE,MAAM,OAAO,GAAG,IAAA,uCAA8B,EAC5C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,mBAAmB,CAAC,OAAO,CACjC,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC,oCAAoC,CAAC,MAAM,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,IAAI,CAAC,wCAAwC,CAAC,MAAM,CAAC,CAAC;QAE7E,8BAA8B;QAC9B,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;QACrD,MAAM,WAAW,GACf,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhF,gEAAgE;QAChE,MAAM,QAAQ,GAAG,yBAAW,CAAC,sBAAsB,CACjD,cAAc,EACd,cAAc,EACd,GAAG,WAAW,EACd,IAAA,iBAAG,EAAA,GAAG,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE,CAC5B,CAAC;QAEF,2EAA2E;QAC3E,6DAA6D;QAE7D,MAAM,oBAAoB,GAAG,IAAI,CAAC,oCAAoC,CACpE,MAAM,EACN,sBAAsB,CACvB,CAAC;QACF,MAAM,oBAAoB,GAAG,IAAI,CAAC,wCAAwC,CACxE,MAAM,EACN,sBAAsB,CACvB,CAAC;QAEF,MAAM,iBAAiB,GACrB,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,IAAI,CAAC,+BAA+B,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAChE,IAAI,EAAE,CAAC;QAEV,mCAAmC;QACnC,MAAM,YAAY,GAA2B;YAC3C,oBAAoB;YACpB,oBAAoB;YACpB,GAAG,iBAAiB;YACpB,IAAA,iBAAG,EAAA,GAAG,IAAA,uBAAS,EAAC,sBAAsB,CAAC,IAAI,IAAA,wBAAU,EAAC,OAAO,CAAC,EAAE;SACjE,CAAC;QAEF,MAAM,iBAAiB,GAAG,IAAA,iBAAG,EAAA;eAClB,yBAAW,CAAC,sBAAsB,CAAC,GAAG,YAAY,CAAC;aACrD,IAAA,wBAAU,EAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,IAAA,uBAAS,EAAC,sBAAsB,CAAC;cACrF,IAAA,uBAAS,EAAC,sBAAsB,CAAC,IAAI,IAAA,wBAAU,EAAC,OAAO,CAAC,MAAM,6BAA6B;KACpG,CAAC;QAEF,OAAO,IAAA,iBAAG,EAAA,IAAI,QAAQ,KAAK,IAAA,uBAAS,EAAC,QAAQ,CAAC,KAAK,iBAAiB,GAAG,CAAC;IAC1E,CAAC;IAEO,8BAA8B,CAAC,MAA+C;QAIpF,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,uCAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;gBACrC,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAErD,qDAAqD;gBACrD,MAAM,oBAAoB,GAAqC;oBAC7D,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAClB,CAAC,KAAK,EAAkC,EAAE,CAAC,CAAC;wBAC1C,aAAa,EAAE,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC;wBAC1D,KAAK,EAAE,mDAAe,CAAC,SAAS;qBACjC,CAAC,CACH;oBACD;wBACE,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO;wBAC3C,KAAK,EAAE,mDAAe,CAAC,SAAS;qBACjC;iBACF,CAAC;gBAEF,OAAO;oBACL,WAAW,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAkB,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAA,iBAAG,EAAA,OAAO;oBACtF,oBAAoB;iBACrB,CAAC;YACJ,CAAC;YAED,KAAK,uCAAkB,CAAC,cAAc,CAAC,CAAC,CAAC;gBACvC,gCAAgC;gBAChC,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;gBAEvE,IAAA,gBAAM,EACJ,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAC9C,6DAA6D,MAAM,CAAC,SAAS,EAAE,CAChF,CAAC;gBAEF,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,iBAAG,EAAA,GAAG,IAAI,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBAErF,gDAAgD;gBAChD,MAAM,aAAa,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,UAAU,CAAC,CAAC;gBAE1D,6CAA6C;gBAC7C,iCAAiC;gBACjC,8BAA8B;gBAC9B,qDAAqD;gBACrD,MAAM,oBAAoB,GAAgE;oBACxF;wBACE,aAAa,EAAE,IAAI,CAAC,oCAAoC,CAAC,MAAM,CAAC;wBAChE,KAAK,EAAE,mDAAe,CAAC,UAAU;qBAClC;oBACD;wBACE,aAAa,EAAE,IAAI,CAAC,wCAAwC,CAAC,MAAM,CAAC;wBACpE,KAAK,EAAE,mDAAe,CAAC,UAAU;qBAClC;oBACD,GAAG,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACnD,aAAa,EAAE,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC;wBAC1D,KAAK,EAAE,mDAAe,CAAC,UAAU;qBAClC,CAAC,CAAC;oBACH;wBACE,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO;wBAC3C,KAAK,EAAE,mDAAe,CAAC,UAAU;qBAClC;iBACF,CAAC;gBAEF,OAAO;oBACL,WAAW,EAAE,gCAAkB,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC;oBACpD,oBAAoB;iBACrB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,IAAY;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF;AArqBD,sDAqqBC"}

package/build/src/internal/getKnexDataManager.d.ts

@@ -0,0 +1,3 @@
+import { EntityTableDataCoordinator } from '@expo/entity';
+import { EntityKnexDataManager } from './EntityKnexDataManager';
+export declare function getKnexDataManager<TFields extends Record<string, any>, TIDField extends keyof TFields>(tableDataCoordinator: EntityTableDataCoordinator<TFields, TIDField>): EntityKnexDataManager<TFields, TIDField>;

package/build/src/internal/getKnexDataManager.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKnexDataManager = getKnexDataManager;
+const assert_1 = __importDefault(require("assert"));
+const BasePostgresEntityDatabaseAdapter_1 = require("../BasePostgresEntityDatabaseAdapter");
+const EntityKnexDataManager_1 = require("./EntityKnexDataManager");
+const weakMaps_1 = require("./weakMaps");
+const knexDataManagerCache = new WeakMap();
+function getKnexDataManager(tableDataCoordinator) {
+    return (0, weakMaps_1.computeIfAbsentInWeakMap)(knexDataManagerCache, tableDataCoordinator, (coordinator) => new EntityKnexDataManager_1.EntityKnexDataManager(coordinator.entityConfiguration, requireBasePostgresAdapter(coordinator.databaseAdapter), coordinator.metricsAdapter, coordinator.entityClassName));
+}
+function requireBasePostgresAdapter(databaseAdapter) {
+    (0, assert_1.default)(databaseAdapter instanceof BasePostgresEntityDatabaseAdapter_1.BasePostgresEntityDatabaseAdapter, `Cannot create KnexDataManager for EntityTableDataCoordinator with non-Postgres database adapter.`);
+    return databaseAdapter;
+}
+//# sourceMappingURL=getKnexDataManager.js.map

package/build/src/internal/getKnexDataManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKnexDataManager.js","sourceRoot":"","sources":["../../../src/internal/getKnexDataManager.ts"],"names":[],"mappings":";;;;;AAYA,gDAiBC;AA5BD,oDAA4B;AAE5B,4FAAyF;AACzF,mEAAgE;AAChE,yCAAsD;AAEtD,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAGrC,CAAC;AAEJ,SAAgB,kBAAkB,CAIhC,oBAAmE;IAEnE,OAAO,IAAA,mCAAwB,EAC7B,oBAAoB,EACpB,oBAAoB,EACpB,CAAC,WAAW,EAAE,EAAE,CACd,IAAI,6CAAqB,CACvB,WAAW,CAAC,mBAAmB,EAC/B,0BAA0B,CAAC,WAAW,CAAC,eAAe,CAAC,EACvD,WAAW,CAAC,cAAc,EAC1B,WAAW,CAAC,eAAe,CAC5B,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAIjC,eAAyD;IAEzD,IAAA,gBAAM,EACJ,eAAe,YAAY,qEAAiC,EAC5D,kGAAkG,CACnG,CAAC;IACF,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/build/src/internal/getKnexEntityLoaderFactory.d.ts

@@ -0,0 +1,3 @@
+import { EntityPrivacyPolicy, IEntityClass, ReadonlyEntity, ViewerContext } from '@expo/entity';
+import { KnexEntityLoaderFactory } from '../KnexEntityLoaderFactory';
+export declare function getKnexEntityLoaderFactory<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TViewerContext2 extends TViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields>(entityClass: IEntityClass<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, viewerContext: TViewerContext2): KnexEntityLoaderFactory<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;

package/build/src/internal/getKnexEntityLoaderFactory.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKnexEntityLoaderFactory = getKnexEntityLoaderFactory;
+const KnexEntityLoaderFactory_1 = require("../KnexEntityLoaderFactory");
+const getKnexDataManager_1 = require("./getKnexDataManager");
+const weakMaps_1 = require("./weakMaps");
+const knexEntityLoaderFactoryCache = new WeakMap();
+function getKnexEntityLoaderFactory(entityClass, viewerContext) {
+    return (0, weakMaps_1.computeIfAbsentInWeakMap)(knexEntityLoaderFactoryCache, viewerContext.entityCompanionProvider.getCompanionForEntity(entityClass), (companion) => new KnexEntityLoaderFactory_1.KnexEntityLoaderFactory(companion, (0, getKnexDataManager_1.getKnexDataManager)(companion.tableDataCoordinator), companion.metricsAdapter));
+}
+//# sourceMappingURL=getKnexEntityLoaderFactory.js.map

package/build/src/internal/getKnexEntityLoaderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKnexEntityLoaderFactory.js","sourceRoot":"","sources":["../../../src/internal/getKnexEntityLoaderFactory.ts"],"names":[],"mappings":";;AAiBA,gEA0CC;AAnDD,wEAAqE;AACrE,6DAA0D;AAC1D,yCAAsD;AAEtD,MAAM,4BAA4B,GAAG,IAAI,OAAO,EAG7C,CAAC;AAEJ,SAAgB,0BAA0B,CAexC,WAOC,EACD,aAA8B;IAS9B,OAAO,IAAA,mCAAwB,EAC7B,4BAA4B,EAC5B,aAAa,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,WAAW,CAAC,EACxE,CAAC,SAAS,EAAE,EAAE,CACZ,IAAI,iDAAuB,CACzB,SAAS,EACT,IAAA,uCAAkB,EAAC,SAAS,CAAC,oBAAoB,CAAC,EAClD,SAAS,CAAC,cAAc,CACzB,CACJ,CAAC;AACJ,CAAC"}

package/build/src/internal/utilityTypes.d.ts

@@ -0,0 +1,5 @@
+export type NonNullableKeys<T> = {
+    [K in keyof T]: T[K] extends NonNullable<T[K]> ? K : never;
+}[keyof T];
+export type PickNonNullable<T> = Pick<T, NonNullableKeys<T>>;
+export type DistributiveOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;

package/build/src/internal/utilityTypes.js

@@ -0,0 +1,5 @@
+"use strict";
+/* c8 ignore start - types only */
+Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop - types only */
+//# sourceMappingURL=utilityTypes.js.map

package/build/src/internal/utilityTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilityTypes.js","sourceRoot":"","sources":["../../../src/internal/utilityTypes.ts"],"names":[],"mappings":";AAAA,kCAAkC;;AAUlC,iCAAiC"}

package/build/src/internal/weakMaps.d.ts

@@ -0,0 +1,9 @@
+/**
+ * If the specified key is not already associated with a value in this weak map, computes
+ * its value using the given mapping function and enters it into this map.
+ *
+ * @param map - map from which to get the key's value or compute and associate
+ * @param key - key for which to get the value or with which the computed value is to be associated
+ * @param mappingFunction - function to compute a value for key
+ */
+export declare const computeIfAbsentInWeakMap: <K extends WeakKey, V>(map: WeakMap<K, V>, key: K, mappingFunction: (key: K) => V) => V;

package/build/src/internal/weakMaps.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeIfAbsentInWeakMap = void 0;
+/**
+ * If the specified key is not already associated with a value in this weak map, computes
+ * its value using the given mapping function and enters it into this map.
+ *
+ * @param map - map from which to get the key's value or compute and associate
+ * @param key - key for which to get the value or with which the computed value is to be associated
+ * @param mappingFunction - function to compute a value for key
+ */
+const computeIfAbsentInWeakMap = (map, key, mappingFunction) => {
+    if (!map.has(key)) {
+        const value = mappingFunction(key);
+        map.set(key, value);
+    }
+    return map.get(key);
+};
+exports.computeIfAbsentInWeakMap = computeIfAbsentInWeakMap;
+//# sourceMappingURL=weakMaps.js.map

package/build/src/internal/weakMaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weakMaps.js","sourceRoot":"","sources":["../../../src/internal/weakMaps.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,wBAAwB,GAAG,CACtC,GAAkB,EAClB,GAAM,EACN,eAA8B,EAC3B,EAAE;IACL,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACnC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;AACvB,CAAC,CAAC;AAVW,QAAA,wBAAwB,4BAUnC"}

package/build/src/knexLoader.d.ts

@@ -0,0 +1,18 @@
+import { EntityPrivacyPolicy, EntityQueryContext, IEntityClass, ReadonlyEntity, ViewerContext } from '@expo/entity';
+import { AuthorizationResultBasedKnexEntityLoader } from './AuthorizationResultBasedKnexEntityLoader';
+import { EnforcingKnexEntityLoader } from './EnforcingKnexEntityLoader';
+/**
+ * Vend knex loader for loading entities via non-data-loader methods in a given query context.
+ * @param entityClass - entity class to load
+ * @param viewerContext - viewer context of loading user
+ * @param queryContext - query context in which to perform the load
+ */
+export declare function knexLoader<TMFields extends object, TMIDField extends keyof NonNullable<Pick<TMFields, TMSelectedFields>>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMIDField, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMIDField, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(entityClass: IEntityClass<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): EnforcingKnexEntityLoader<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+/**
+ * Vend knex loader for loading entities via non-data-loader methods in a given query context.
+ * Returns authorization results instead of throwing on authorization errors.
+ * @param entityClass - entity class to load
+ * @param viewerContext - viewer context of loading user
+ * @param queryContext - query context in which to perform the load
+ */
+export declare function knexLoaderWithAuthorizationResults<TMFields extends object, TMIDField extends keyof NonNullable<Pick<TMFields, TMSelectedFields>>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMIDField, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMIDField, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(entityClass: IEntityClass<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): AuthorizationResultBasedKnexEntityLoader<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;