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

package/build/src/PaginationStrategy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Search strategy for SQL-based pagination.
+ */
+export declare enum PaginationStrategy {
+    /**
+     * Standard pagination with ORDER BY. Results are ordered by the specified orderBy fields, with ID field automatically included for stable pagination if not already present.
+     */
+    STANDARD = "standard",
+    /**
+     * Case-insensitive pattern matching search using SQL ILIKE operator.
+     * Results are ordered by the fields being searched within in the order specified, then by ID for tie-breaking and stable pagination.
+     */
+    ILIKE_SEARCH = "ilike-search",
+    /**
+     * Similarity search using PostgreSQL trigram similarity. Results are ordered by exact match priority, then by similarity score, then by specified extra order by fields if provided, then by ID for tie-breaking and stable pagination.
+     *
+     * Performance considerations:
+     * - Trigram search can be significantly slower than ILIKE search, especially on large datasets without appropriate indexes.
+     * - Consider using ILIKE search for smaller datasets or when exact substring matching is sufficient
+     * - For larger datasets, ensure proper indexing or consider dedicated full-text search solutions.
+     * - For optimal performance, create GIN or GIST indexes on searchable columns:
+     * ```sql
+     *   CREATE EXTENSION IF NOT EXISTS pg_trgm;
+     *   CREATE INDEX idx_table_field_trigram ON table_name USING gin(field_name gin_trgm_ops);
+     *   -- Or for multiple columns:
+     *   CREATE INDEX idx_table_search ON table_name USING gin((field1 || ' ' || field2) gin_trgm_ops);
+     * ```
+     */
+    TRIGRAM_SEARCH = "trigram"
+}

package/build/src/PaginationStrategy.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaginationStrategy = void 0;
+/**
+ * Search strategy for SQL-based pagination.
+ */
+var PaginationStrategy;
+(function (PaginationStrategy) {
+    /**
+     * Standard pagination with ORDER BY. Results are ordered by the specified orderBy fields, with ID field automatically included for stable pagination if not already present.
+     */
+    PaginationStrategy["STANDARD"] = "standard";
+    /**
+     * Case-insensitive pattern matching search using SQL ILIKE operator.
+     * Results are ordered by the fields being searched within in the order specified, then by ID for tie-breaking and stable pagination.
+     */
+    PaginationStrategy["ILIKE_SEARCH"] = "ilike-search";
+    /**
+     * Similarity search using PostgreSQL trigram similarity. Results are ordered by exact match priority, then by similarity score, then by specified extra order by fields if provided, then by ID for tie-breaking and stable pagination.
+     *
+     * Performance considerations:
+     * - Trigram search can be significantly slower than ILIKE search, especially on large datasets without appropriate indexes.
+     * - Consider using ILIKE search for smaller datasets or when exact substring matching is sufficient
+     * - For larger datasets, ensure proper indexing or consider dedicated full-text search solutions.
+     * - For optimal performance, create GIN or GIST indexes on searchable columns:
+     * ```sql
+     *   CREATE EXTENSION IF NOT EXISTS pg_trgm;
+     *   CREATE INDEX idx_table_field_trigram ON table_name USING gin(field_name gin_trgm_ops);
+     *   -- Or for multiple columns:
+     *   CREATE INDEX idx_table_search ON table_name USING gin((field1 || ' ' || field2) gin_trgm_ops);
+     * ```
+     */
+    PaginationStrategy["TRIGRAM_SEARCH"] = "trigram";
+})(PaginationStrategy || (exports.PaginationStrategy = PaginationStrategy = {}));
+//# sourceMappingURL=PaginationStrategy.js.map

package/build/src/PaginationStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaginationStrategy.js","sourceRoot":"","sources":["../../src/PaginationStrategy.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,kBA4BX;AA5BD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,2CAAqB,CAAA;IAErB;;;OAGG;IACH,mDAA6B,CAAA;IAE7B;;;;;;;;;;;;;;OAcG;IACH,gDAA0B,CAAA;AAC5B,CAAC,EA5BW,kBAAkB,kCAAlB,kBAAkB,QA4B7B"}

package/build/src/PostgresEntity.d.ts

@@ -0,0 +1,25 @@
+import { Entity, EntityPrivacyPolicy, EntityQueryContext, IEntityClass, ReadonlyEntity, ViewerContext } from '@expo/entity';
+import { AuthorizationResultBasedKnexEntityLoader } from './AuthorizationResultBasedKnexEntityLoader';
+import { EnforcingKnexEntityLoader } from './EnforcingKnexEntityLoader';
+/**
+ * Abstract base class for mutable entities backed by Postgres.
+ * Provides `knexLoader` and `knexLoaderWithAuthorizationResults` as inherited static methods,
+ * in addition to the mutation methods inherited from `Entity`.
+ */
+export declare abstract class PostgresEntity<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TSelectedFields extends keyof TFields = keyof TFields> extends Entity<TFields, TIDField, TViewerContext, TSelectedFields> {
+    /**
+     * Vend knex loader for loading entities via knex-specific methods in a given query context.
+     *
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static 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>(this: 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 knex-specific methods in a given query context.
+     * Returns authorization results instead of throwing on authorization errors.
+     *
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static 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>(this: IEntityClass<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): AuthorizationResultBasedKnexEntityLoader<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+}

package/build/src/PostgresEntity.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresEntity = void 0;
+const entity_1 = require("@expo/entity");
+const knexLoader_1 = require("./knexLoader");
+/**
+ * Abstract base class for mutable entities backed by Postgres.
+ * Provides `knexLoader` and `knexLoaderWithAuthorizationResults` as inherited static methods,
+ * in addition to the mutation methods inherited from `Entity`.
+ */
+class PostgresEntity extends entity_1.Entity {
+    /**
+     * Vend knex loader for loading entities via knex-specific methods in a given query context.
+     *
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoader(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return (0, knexLoader_1.knexLoader)(this, viewerContext, queryContext);
+    }
+    /**
+     * Vend knex loader for loading entities via knex-specific methods in a given query context.
+     * Returns authorization results instead of throwing on authorization errors.
+     *
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoaderWithAuthorizationResults(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return (0, knexLoader_1.knexLoaderWithAuthorizationResults)(this, viewerContext, queryContext);
+    }
+}
+exports.PostgresEntity = PostgresEntity;
+//# sourceMappingURL=PostgresEntity.js.map

package/build/src/PostgresEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresEntity.js","sourceRoot":"","sources":["../../src/PostgresEntity.ts"],"names":[],"mappings":";;;AAAA,yCAOsB;AAItB,6CAGsB;AAEtB;;;;GAIG;AACH,MAAsB,cAKpB,SAAQ,eAA0D;IAClE;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAuBf,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAA,uBAAY,EAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,kCAAkC,CAuBvC,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAA,+CAAoC,EAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACjF,CAAC;CACF;AAhGD,wCAgGC"}

package/build/src/PostgresEntityDatabaseAdapter.d.ts

@@ -1,12 +1,19 @@
-import { EntityDatabaseAdapter, FieldTransformerMap, TableFieldMultiValueEqualityCondition, TableFieldSingleValueEqualityCondition, TableQuerySelectionModifiers, TableQuerySelectionModifiersWithOrderByRaw } from '@expo/entity';
+import { EntityConfiguration, FieldTransformerMap } from '@expo/entity';
 import { Knex } from 'knex';
-export declare class PostgresEntityDatabaseAdapter<TFields extends Record<string, any>, TIDField extends keyof TFields> extends EntityDatabaseAdapter<TFields, TIDField> {
+import { BasePostgresEntityDatabaseAdapter, TableFieldMultiValueEqualityCondition, TableFieldSingleValueEqualityCondition, TableQuerySelectionModifiers } from './BasePostgresEntityDatabaseAdapter';
+import { PostgresEntityDatabaseAdapterConfiguration } from './PostgresEntityDatabaseAdapterProvider';
+import { SQLFragment } from './SQLOperator';
+export declare class PostgresEntityDatabaseAdapter<TFields extends Record<string, any>, TIDField extends keyof TFields> extends BasePostgresEntityDatabaseAdapter<TFields, TIDField> {
+    private readonly adapterConfiguration;
+    constructor(entityConfiguration: EntityConfiguration<TFields, TIDField>, adapterConfiguration?: PostgresEntityDatabaseAdapterConfiguration);
+    get paginationMaxPageSize(): number | undefined;
     protected getFieldTransformerMap(): FieldTransformerMap;
     protected fetchManyWhereInternalAsync(queryInterface: Knex, tableName: string, tableColumns: readonly string[], tableTuples: any[][]): Promise<object[]>;
-    private applyQueryModifiersToQueryOrderByRaw;
+    protected fetchOneWhereInternalAsync(queryInterface: Knex, tableName: string, tableColumns: readonly string[], tableTuple: readonly any[]): Promise<object | null>;
     private applyQueryModifiersToQuery;
-    protected fetchManyByFieldEqualityConjunctionInternalAsync(queryInterface: Knex, tableName: string, tableFieldSingleValueEqualityOperands: TableFieldSingleValueEqualityCondition[], tableFieldMultiValueEqualityOperands: TableFieldMultiValueEqualityCondition[], querySelectionModifiers: TableQuerySelectionModifiers): Promise<object[]>;
-    protected fetchManyByRawWhereClauseInternalAsync(queryInterface: Knex, tableName: string, rawWhereClause: string, bindings: object | any[], querySelectionModifiers: TableQuerySelectionModifiersWithOrderByRaw): Promise<object[]>;
+    protected fetchManyByFieldEqualityConjunctionInternalAsync(queryInterface: Knex, tableName: string, tableFieldSingleValueEqualityOperands: TableFieldSingleValueEqualityCondition[], tableFieldMultiValueEqualityOperands: TableFieldMultiValueEqualityCondition[], querySelectionModifiers: TableQuerySelectionModifiers<TFields>): Promise<object[]>;
+    protected fetchManyByRawWhereClauseInternalAsync(queryInterface: Knex, tableName: string, rawWhereClause: string, bindings: object | any[], querySelectionModifiers: TableQuerySelectionModifiers<TFields>): Promise<object[]>;
+    protected fetchManyBySQLFragmentInternalAsync(queryInterface: Knex, tableName: string, sqlFragment: SQLFragment<TFields>, querySelectionModifiers: TableQuerySelectionModifiers<TFields>): Promise<object[]>;
     protected insertInternalAsync(queryInterface: Knex, tableName: string, object: object): Promise<object[]>;
     protected updateInternalAsync(queryInterface: Knex, tableName: string, tableIdField: string, id: any, object: object): Promise<object[]>;
     protected deleteInternalAsync(queryInterface: Knex, tableName: string, tableIdField: string, id: any): Promise<number>;

package/build/src/PostgresEntityDatabaseAdapter.js

@@ -2,9 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresEntityDatabaseAdapter = void 0;
 const entity_1 = require("@expo/entity");
+const BasePostgresEntityDatabaseAdapter_1 = require("./BasePostgresEntityDatabaseAdapter");
 const EntityFields_1 = require("./EntityFields");
 const wrapNativePostgresCallAsync_1 = require("./errors/wrapNativePostgresCallAsync");
-class PostgresEntityDatabaseAdapter extends entity_1.EntityDatabaseAdapter {
+class PostgresEntityDatabaseAdapter extends BasePostgresEntityDatabaseAdapter_1.BasePostgresEntityDatabaseAdapter {
+    adapterConfiguration;
+    constructor(entityConfiguration, adapterConfiguration = {}) {
+        super(entityConfiguration);
+        this.adapterConfiguration = adapterConfiguration;
+    }
+    get paginationMaxPageSize() {
+        return this.adapterConfiguration.paginationMaxPageSize;
+    }
     getFieldTransformerMap() {
         return new Map([
             [
@@ -62,20 +71,27 @@ class PostgresEntityDatabaseAdapter extends entity_1.EntityDatabaseAdapter {
         }
         return await (0, wrapNativePostgresCallAsync_1.wrapNativePostgresCallAsync)(() => queryInterface.select().from(tableName).whereIn(tableColumns, tableTuples));
     }
-    applyQueryModifiersToQueryOrderByRaw(query, querySelectionModifiers) {
-        let ret = this.applyQueryModifiersToQuery(query, querySelectionModifiers);
-        const { orderByRaw } = querySelectionModifiers;
-        if (orderByRaw !== undefined) {
-            ret = ret.orderByRaw(orderByRaw);
-        }
-        return ret;
+    async fetchOneWhereInternalAsync(queryInterface, tableName, tableColumns, tableTuple) {
+        const results = await this.fetchManyByFieldEqualityConjunctionInternalAsync(queryInterface, tableName, tableColumns.map((column, index) => ({
+            tableField: column,
+            tableValue: tableTuple[index],
+        })), [], { limit: 1, orderBy: undefined, offset: undefined });
+        return results[0] ?? null;
     }
     applyQueryModifiersToQuery(query, querySelectionModifiers) {
         const { orderBy, offset, limit } = querySelectionModifiers;
         let ret = query;
         if (orderBy !== undefined) {
             for (const orderBySpecification of orderBy) {
-                ret = ret.orderBy(orderBySpecification.columnName, orderBySpecification.order);
+                if ('columnName' in orderBySpecification) {
+                    ret = ret.orderBy(orderBySpecification.columnName, orderBySpecification.order, orderBySpecification.nulls);
+                }
+                else {
+                    const nullsSuffix = orderBySpecification.nulls
+                        ? ` NULLS ${orderBySpecification.nulls === BasePostgresEntityDatabaseAdapter_1.NullsOrdering.FIRST ? 'FIRST' : 'LAST'}`
+                        : '';
+                    ret = ret.orderByRaw(`(${orderBySpecification.columnFragment.sql}) ${orderBySpecification.order}${nullsSuffix}`, orderBySpecification.columnFragment.getKnexBindings((fieldName) => (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, fieldName)));
+                }
             }
         }
         if (offset !== undefined) {
@@ -120,11 +136,16 @@ class PostgresEntityDatabaseAdapter extends entity_1.EntityDatabaseAdapter {
         return await (0, wrapNativePostgresCallAsync_1.wrapNativePostgresCallAsync)(() => query);
     }
     async fetchManyByRawWhereClauseInternalAsync(queryInterface, tableName, rawWhereClause, bindings, querySelectionModifiers) {
+        let query = queryInterface.select().from(tableName).whereRaw(rawWhereClause, bindings);
+        query = this.applyQueryModifiersToQuery(query, querySelectionModifiers);
+        return await (0, wrapNativePostgresCallAsync_1.wrapNativePostgresCallAsync)(() => query);
+    }
+    async fetchManyBySQLFragmentInternalAsync(queryInterface, tableName, sqlFragment, querySelectionModifiers) {
         let query = queryInterface
             .select()
             .from(tableName)
-            .whereRaw(rawWhereClause, bindings);
-        query = this.applyQueryModifiersToQueryOrderByRaw(query, querySelectionModifiers);
+            .whereRaw(sqlFragment.sql, sqlFragment.getKnexBindings((fieldName) => (0, entity_1.getDatabaseFieldForEntityField)(this.entityConfiguration, fieldName)));
+        query = this.applyQueryModifiersToQuery(query, querySelectionModifiers);
         return await (0, wrapNativePostgresCallAsync_1.wrapNativePostgresCallAsync)(() => query);
     }
     async insertInternalAsync(queryInterface, tableName, object) {

package/build/src/PostgresEntityDatabaseAdapter.js.map

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

package/build/src/PostgresEntityDatabaseAdapterProvider.d.ts

@@ -1,4 +1,13 @@
 import { EntityConfiguration, EntityDatabaseAdapter, IEntityDatabaseAdapterProvider } from '@expo/entity';
+export interface PostgresEntityDatabaseAdapterConfiguration {
+    /**
+     * Maximum page size for pagination (first/last parameters).
+     * If not specified, no limit is enforced.
+     */
+    paginationMaxPageSize?: number;
+}
 export declare class PostgresEntityDatabaseAdapterProvider implements IEntityDatabaseAdapterProvider {
+    private readonly configuration;
+    constructor(configuration?: PostgresEntityDatabaseAdapterConfiguration);
     getDatabaseAdapter<TFields extends Record<string, any>, TIDField extends keyof TFields>(entityConfiguration: EntityConfiguration<TFields, TIDField>): EntityDatabaseAdapter<TFields, TIDField>;
 }

package/build/src/PostgresEntityDatabaseAdapterProvider.js

@@ -3,8 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresEntityDatabaseAdapterProvider = void 0;
 const PostgresEntityDatabaseAdapter_1 = require("./PostgresEntityDatabaseAdapter");
 class PostgresEntityDatabaseAdapterProvider {
+    configuration;
+    constructor(configuration = {}) {
+        this.configuration = configuration;
+    }
     getDatabaseAdapter(entityConfiguration) {
-        return new PostgresEntityDatabaseAdapter_1.PostgresEntityDatabaseAdapter(entityConfiguration);
+        return new PostgresEntityDatabaseAdapter_1.PostgresEntityDatabaseAdapter(entityConfiguration, this.configuration);
     }
 }
 exports.PostgresEntityDatabaseAdapterProvider = PostgresEntityDatabaseAdapterProvider;

package/build/src/PostgresEntityDatabaseAdapterProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostgresEntityDatabaseAdapterProvider.js","sourceRoot":"","sources":["../../src/PostgresEntityDatabaseAdapterProvider.ts"],"names":[],"mappings":";;;AAMA,mFAAgF;AAEhF,MAAa,qCAAqC;IAChD,kBAAkB,CAChB,mBAA2D;QAE3D,OAAO,IAAI,6DAA6B,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC;CACF;AAND,sFAMC"}
+{"version":3,"file":"PostgresEntityDatabaseAdapterProvider.js","sourceRoot":"","sources":["../../src/PostgresEntityDatabaseAdapterProvider.ts"],"names":[],"mappings":";;;AAMA,mFAAgF;AAUhF,MAAa,qCAAqC;IACnB;IAA7B,YAA6B,gBAA4D,EAAE;QAA9D,kBAAa,GAAb,aAAa,CAAiD;IAAG,CAAC;IAE/F,kBAAkB,CAChB,mBAA2D;QAE3D,OAAO,IAAI,6DAA6B,CAAC,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACpF,CAAC;CACF;AARD,sFAQC"}

package/build/src/ReadonlyPostgresEntity.d.ts

@@ -0,0 +1,25 @@
+import { EntityPrivacyPolicy, EntityQueryContext, IEntityClass, ReadonlyEntity, ViewerContext } from '@expo/entity';
+import { AuthorizationResultBasedKnexEntityLoader } from './AuthorizationResultBasedKnexEntityLoader';
+import { EnforcingKnexEntityLoader } from './EnforcingKnexEntityLoader';
+/**
+ * Abstract base class for readonly entities backed by Postgres.
+ * Provides `knexLoader` and `knexLoaderWithAuthorizationResults` as inherited static methods.
+ *
+ * Entities that should not be mutated (e.g., representing SQL views or immutable tables)
+ * can extend this class instead of `ReadonlyEntity` to get knex loader ergonomics.
+ */
+export declare abstract class ReadonlyPostgresEntity<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TSelectedFields extends keyof TFields = keyof TFields> extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields> {
+    /**
+     * Vend knex loader for loading entities via non-data-loader methods in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoader<TMFields extends object, TMIDField extends keyof NonNullable<Pick<TMFields, TMSelectedFields>>, TMViewerContext extends ViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMIDField, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMIDField, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext, 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 viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoaderWithAuthorizationResults<TMFields extends object, TMIDField extends keyof NonNullable<Pick<TMFields, TMSelectedFields>>, TMViewerContext extends ViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMIDField, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMIDField, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext, queryContext?: EntityQueryContext): AuthorizationResultBasedKnexEntityLoader<TMFields, TMIDField, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+}

package/build/src/ReadonlyPostgresEntity.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadonlyPostgresEntity = void 0;
+const entity_1 = require("@expo/entity");
+const knexLoader_1 = require("./knexLoader");
+/**
+ * Abstract base class for readonly entities backed by Postgres.
+ * Provides `knexLoader` and `knexLoaderWithAuthorizationResults` as inherited static methods.
+ *
+ * Entities that should not be mutated (e.g., representing SQL views or immutable tables)
+ * can extend this class instead of `ReadonlyEntity` to get knex loader ergonomics.
+ */
+class ReadonlyPostgresEntity extends entity_1.ReadonlyEntity {
+    /**
+     * Vend knex loader for loading entities via non-data-loader methods in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoader(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return (0, knexLoader_1.knexLoader)(this, viewerContext, queryContext);
+    }
+    /**
+     * 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 viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static knexLoaderWithAuthorizationResults(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return (0, knexLoader_1.knexLoaderWithAuthorizationResults)(this, viewerContext, queryContext);
+    }
+}
+exports.ReadonlyPostgresEntity = ReadonlyPostgresEntity;
+//# sourceMappingURL=ReadonlyPostgresEntity.js.map

package/build/src/ReadonlyPostgresEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadonlyPostgresEntity.js","sourceRoot":"","sources":["../../src/ReadonlyPostgresEntity.ts"],"names":[],"mappings":";;;AAAA,yCAMsB;AAItB,6CAGsB;AAEtB;;;;;;GAMG;AACH,MAAsB,sBAKpB,SAAQ,uBAAkE;IAC1E;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAsBf,aAA8B,EAC9B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAA,uBAAY,EAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,kCAAkC,CAsBvC,aAA8B,EAC9B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAA,+CAAoC,EAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACjF,CAAC;CACF;AA5FD,wDA4FC"}