@expo/entity 0.34.0 → 0.36.0

package/build/EntityLoader.d.ts

@@ -1,8 +1,8 @@
-import { Result } from '@expo/results';
+import AuthorizationResultBasedEntityLoader from './AuthorizationResultBasedEntityLoader';
 import EnforcingEntityLoader from './EnforcingEntityLoader';
 import { IEntityClass } from './Entity';
 import EntityConfiguration from './EntityConfiguration';
-import { FieldEqualityCondition, QuerySelectionModifiers, QuerySelectionModifiersWithOrderByRaw } from './EntityDatabaseAdapter';
+import EntityLoaderUtils from './EntityLoaderUtils';
 import EntityPrivacyPolicy, { EntityPrivacyPolicyEvaluationContext } from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
 import ReadonlyEntity from './ReadonlyEntity';
@@ -23,136 +23,23 @@ export default class EntityLoader<TFields extends object, TID extends NonNullabl
     private readonly privacyPolicy;
     private readonly dataManager;
     protected readonly metricsAdapter: IEntityMetricsAdapter;
-    constructor(viewerContext: TViewerContext, queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext, entityConfiguration: EntityConfiguration<TFields>, entityClass: IEntityClass<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, entitySelectedFields: TSelectedFields[] | undefined, privacyPolicy: TPrivacyPolicy, dataManager: EntityDataManager<TFields>, metricsAdapter: IEntityMetricsAdapter);
+    private readonly utilsPrivate;
+    constructor(viewerContext: TViewerContext, queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, entityConfiguration: EntityConfiguration<TFields>, entityClass: IEntityClass<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, entitySelectedFields: TSelectedFields[] | undefined, privacyPolicy: TPrivacyPolicy, dataManager: EntityDataManager<TFields>, metricsAdapter: IEntityMetricsAdapter);
     /**
-     * Enforcing view on this entity loader. All loads through this view are
+     * Enforcing entity loader. All loads through this loader are
      * guaranteed to be the values of successful results (or null for some loader methods),
      * and will throw otherwise.
      */
     enforcing(): EnforcingEntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
     /**
-     * Load many entities where fieldName is one of fieldValues.
-     * @param fieldName - entity field being queried
-     * @param fieldValues - fieldName field values being queried
-     * @returns map from fieldValue to entity results that match the query for that fieldValue,
-     *          where result errors can be UnauthorizedError
+     * Authorization-result-based entity loader. All loads through this
+     * loader are are results (or null for some loader methods), where an unsuccessful result
+     * means an authorization error or entity construction error occurred. Other errors are thrown.
      */
-    loadManyByFieldEqualingManyAsync<N extends keyof Pick<TFields, TSelectedFields>>(fieldName: N, fieldValues: readonly NonNullable<TFields[N]>[]): Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly Result<TEntity>[]>>;
+    withAuthorizationResults(): AuthorizationResultBasedEntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
     /**
-     * Load many entities where fieldName equals fieldValue.
-     * @param fieldName - entity field being queried
-     * @param fieldValue - fieldName field value being queried
-     * @returns array of entity results that match the query for fieldValue, where result error can be UnauthorizedError
+     * Entity loader utilities for things like cache invalidation, entity construction, and authorization.
+     * Calling into these should only be necessary in rare cases.
      */
-    loadManyByFieldEqualingAsync<N extends keyof Pick<TFields, TSelectedFields>>(fieldName: N, fieldValue: NonNullable<TFields[N]>): Promise<readonly Result<TEntity>[]>;
-    /**
-     * Load an entity where fieldName equals fieldValue, or null if no entity exists.
-     * @param uniqueFieldName - entity field being queried
-     * @param fieldValue - uniqueFieldName field value being queried
-     * @returns entity result where uniqueFieldName equals fieldValue, or null if no entity matches the condition.
-     * @throws when multiple entities match the condition
-     */
-    loadByFieldEqualingAsync<N extends keyof Pick<TFields, TSelectedFields>>(uniqueFieldName: N, fieldValue: NonNullable<TFields[N]>): Promise<Result<TEntity> | null>;
-    /**
-     * Loads an entity by a specified ID.
-     * @param id - ID of the entity
-     * @returns entity result for matching ID, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    loadByIDAsync(id: TID): Promise<Result<TEntity>>;
-    /**
-     * Load an entity by a specified ID, or return null if non-existent.
-     * @param id - ID of the entity
-     * @returns entity result for matching ID, or null if no entity exists for ID.
-     */
-    loadByIDNullableAsync(id: TID): Promise<Result<TEntity> | null>;
-    /**
-     * Loads many entities for a list of IDs.
-     * @param viewerContext - viewer context of loading user
-     * @param ids - IDs of the entities to load
-     * @returns map from ID to corresponding entity result, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    loadManyByIDsAsync(ids: readonly TID[]): Promise<ReadonlyMap<TID, Result<TEntity>>>;
-    /**
-     * Loads many entities for a list of IDs, returning null for any IDs that are non-existent.
-     * @param ids - IDs of the entities to load
-     * @returns map from ID to nullable corresponding entity result, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    loadManyByIDsNullableAsync(ids: readonly TID[]): Promise<ReadonlyMap<TID, Result<TEntity> | null>>;
-    /**
-     * Loads the first entity matching the selection constructed from the conjunction of specified
-     * operands, or null if no matching entity exists. Entities loaded using this method are not
-     * batched or cached.
-     *
-     * This is a convenience method for {@link loadManyByFieldEqualityConjunctionAsync}. However, the
-     * `orderBy` option must be specified to define what "first" means. If ordering doesn't matter,
-     * explicitly pass in an empty array.
-     *
-     * @param fieldEqualityOperands - list of field equality selection operand specifications
-     * @param querySelectionModifiers - orderBy and optional offset for the query
-     * @returns the first entity results that matches the query, where result error can be
-     *  UnauthorizedError
-     */
-    loadFirstByFieldEqualityConjunctionAsync<N extends keyof Pick<TFields, TSelectedFields>>(fieldEqualityOperands: FieldEqualityCondition<TFields, N>[], querySelectionModifiers: Omit<QuerySelectionModifiers<TFields>, 'limit'> & Required<Pick<QuerySelectionModifiers<TFields>, 'orderBy'>>): Promise<Result<TEntity> | null>;
-    /**
-     * Loads many entities matching the selection constructed from the conjunction of specified operands.
-     * Entities loaded using this method are not batched or cached.
-     *
-     * @example
-     * fieldEqualityOperands:
-     * `[{fieldName: 'hello', fieldValue: 1}, {fieldName: 'world', fieldValues: [2, 3]}]`
-     * Entities returned with a SQL EntityDatabaseAdapter:
-     * `WHERE hello = 1 AND world = ANY({2, 3})`
-     *
-     * @param fieldEqualityOperands - list of field equality selection operand specifications
-     * @param querySelectionModifiers - limit, offset, and orderBy for the query
-     * @returns array of entity results that match the query, where result error can be UnauthorizedError
-     */
-    loadManyByFieldEqualityConjunctionAsync<N extends keyof Pick<TFields, TSelectedFields>>(fieldEqualityOperands: FieldEqualityCondition<TFields, N>[], querySelectionModifiers?: QuerySelectionModifiers<TFields>): Promise<readonly Result<TEntity>[]>;
-    /**
-     * Loads many entities matching the raw WHERE clause. Corresponds to the knex `whereRaw` argument format.
-     *
-     * @remarks
-     * Important notes:
-     * - Fields in clause are database column names instead of transformed entity field names.
-     * - Entities loaded using this method are not batched or cached.
-     * - Not all database adapters implement the ability to execute this method of fetching entities.
-     *
-     * @example
-     * rawWhereClause: `id = ?`
-     * bindings: `[1]`
-     * Entites returned `WHERE id = 1`
-     *
-     * http://knexjs.org/#Builder-whereRaw
-     * http://knexjs.org/#Raw-Bindings
-     *
-     * @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 entity results that match the query, where result error can be UnauthorizedError
-     * @throws Error when rawWhereClause or bindings are invalid
-     *
-     * @deprecated prefer caching loaders
-     */
-    loadManyByRawWhereClauseAsync(rawWhereClause: string, bindings: any[] | object, querySelectionModifiers?: QuerySelectionModifiersWithOrderByRaw<TFields>): Promise<readonly Result<TEntity>[]>;
-    /**
-     * Invalidate all caches for an entity's fields. Exposed primarily for internal use by EntityMutator.
-     * @param objectFields - entity data object to be invalidated
-     */
-    invalidateFieldsAsync(objectFields: Readonly<TFields>): Promise<void>;
-    /**
-     * Invalidate all caches for an entity. One potential use case would be to keep the entity
-     * framework in sync with changes made to data outside of the framework.
-     * @param entity - entity to be invalidated
-     */
-    invalidateEntityAsync(entity: TEntity): Promise<void>;
-    private tryConstructEntities;
-    constructEntity(fieldsObject: TFields): TEntity;
-    /**
-     * Construct and authorize entities from fields map, returning error results for entities that fail
-     * to construct or fail to authorize.
-     *
-     * @param map - map from an arbitrary key type to an array of entity field objects
-     */
-    constructAndAuthorizeEntitiesAsync<K>(map: ReadonlyMap<K, readonly Readonly<TFields>[]>): Promise<ReadonlyMap<K, readonly Result<TEntity>[]>>;
-    private validateFieldValues;
+    utils(): EntityLoaderUtils<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
 }

package/build/EntityLoader.js

@@ -3,20 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const results_1 = require("@expo/results");
-const invariant_1 = __importDefault(require("invariant"));
-const nullthrows_1 = __importDefault(require("nullthrows"));
+const AuthorizationResultBasedEntityLoader_1 = __importDefault(require("./AuthorizationResultBasedEntityLoader"));
 const EnforcingEntityLoader_1 = __importDefault(require("./EnforcingEntityLoader"));
-const EntityDatabaseAdapter_1 = require("./EntityDatabaseAdapter");
-const entityUtils_1 = require("./entityUtils");
-const EntityInvalidFieldValueError_1 = __importDefault(require("./errors/EntityInvalidFieldValueError"));
-const EntityNotFoundError_1 = __importDefault(require("./errors/EntityNotFoundError"));
-const maps_1 = require("./utils/collections/maps");
+const EntityLoaderUtils_1 = __importDefault(require("./EntityLoaderUtils"));
 /**
  * The primary interface for loading entities. All normal loads are batched,
  * cached, and authorized against the entity's EntityPrivacyPolicy.
  */
 class EntityLoader {
+    viewerContext;
+    queryContext;
+    privacyPolicyEvaluationContext;
+    entityConfiguration;
+    entityClass;
+    entitySelectedFields;
+    privacyPolicy;
+    dataManager;
+    metricsAdapter;
+    utilsPrivate;
     constructor(viewerContext, queryContext, privacyPolicyEvaluationContext, entityConfiguration, entityClass, entitySelectedFields, privacyPolicy, dataManager, metricsAdapter) {
         this.viewerContext = viewerContext;
         this.queryContext = queryContext;
@@ -27,249 +31,30 @@ class EntityLoader {
         this.privacyPolicy = privacyPolicy;
         this.dataManager = dataManager;
         this.metricsAdapter = metricsAdapter;
+        this.utilsPrivate = new EntityLoaderUtils_1.default(this.viewerContext, this.queryContext, this.privacyPolicyEvaluationContext, this.entityConfiguration, this.entityClass, this.entitySelectedFields, this.privacyPolicy, this.dataManager, this.metricsAdapter);
     }
     /**
-     * Enforcing view on this entity loader. All loads through this view are
+     * Enforcing entity loader. All loads through this loader are
      * guaranteed to be the values of successful results (or null for some loader methods),
      * and will throw otherwise.
      */
     enforcing() {
-        return new EnforcingEntityLoader_1.default(this);
+        return new EnforcingEntityLoader_1.default(this.withAuthorizationResults());
     }
     /**
-     * Load many entities where fieldName is one of fieldValues.
-     * @param fieldName - entity field being queried
-     * @param fieldValues - fieldName field values being queried
-     * @returns map from fieldValue to entity results that match the query for that fieldValue,
-     *          where result errors can be UnauthorizedError
+     * Authorization-result-based entity loader. All loads through this
+     * loader are are results (or null for some loader methods), where an unsuccessful result
+     * means an authorization error or entity construction error occurred. Other errors are thrown.
      */
-    async loadManyByFieldEqualingManyAsync(fieldName, fieldValues) {
-        this.validateFieldValues(fieldName, fieldValues);
-        const fieldValuesToFieldObjects = await this.dataManager.loadManyByFieldEqualingAsync(this.queryContext, fieldName, fieldValues);
-        return await this.constructAndAuthorizeEntitiesAsync(fieldValuesToFieldObjects);
+    withAuthorizationResults() {
+        return new AuthorizationResultBasedEntityLoader_1.default(this.queryContext, this.entityConfiguration, this.entityClass, this.dataManager, this.metricsAdapter, this.utilsPrivate);
     }
     /**
-     * Load many entities where fieldName equals fieldValue.
-     * @param fieldName - entity field being queried
-     * @param fieldValue - fieldName field value being queried
-     * @returns array of entity results that match the query for fieldValue, where result error can be UnauthorizedError
+     * Entity loader utilities for things like cache invalidation, entity construction, and authorization.
+     * Calling into these should only be necessary in rare cases.
      */
-    async loadManyByFieldEqualingAsync(fieldName, fieldValue) {
-        const entityResults = await this.loadManyByFieldEqualingManyAsync(fieldName, [fieldValue]);
-        const entityResultsForFieldValue = entityResults.get(fieldValue);
-        (0, invariant_1.default)(entityResultsForFieldValue !== undefined, `${fieldValue} should be guaranteed to be present in returned map of entities`);
-        return entityResultsForFieldValue;
-    }
-    /**
-     * Load an entity where fieldName equals fieldValue, or null if no entity exists.
-     * @param uniqueFieldName - entity field being queried
-     * @param fieldValue - uniqueFieldName field value being queried
-     * @returns entity result where uniqueFieldName equals fieldValue, or null if no entity matches the condition.
-     * @throws when multiple entities match the condition
-     */
-    async loadByFieldEqualingAsync(uniqueFieldName, fieldValue) {
-        const entityResults = await this.loadManyByFieldEqualingAsync(uniqueFieldName, fieldValue);
-        (0, invariant_1.default)(entityResults.length <= 1, `loadByFieldEqualing: Multiple entities of type ${this.entityClass.name} found for ${String(uniqueFieldName)}=${fieldValue}`);
-        return entityResults[0] ?? null;
-    }
-    /**
-     * Loads an entity by a specified ID.
-     * @param id - ID of the entity
-     * @returns entity result for matching ID, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    async loadByIDAsync(id) {
-        const entityResults = await this.loadManyByIDsAsync([id]);
-        const entityResult = entityResults.get(id);
-        if (entityResult === undefined) {
-            return (0, results_1.result)(new EntityNotFoundError_1.default(this.entityClass, this.entityConfiguration.idField, id));
-        }
-        return entityResult;
-    }
-    /**
-     * Load an entity by a specified ID, or return null if non-existent.
-     * @param id - ID of the entity
-     * @returns entity result for matching ID, or null if no entity exists for ID.
-     */
-    async loadByIDNullableAsync(id) {
-        return await this.loadByFieldEqualingAsync(this.entityConfiguration.idField, id);
-    }
-    /**
-     * Loads many entities for a list of IDs.
-     * @param viewerContext - viewer context of loading user
-     * @param ids - IDs of the entities to load
-     * @returns map from ID to corresponding entity result, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    async loadManyByIDsAsync(ids) {
-        const entityResults = (await this.loadManyByFieldEqualingManyAsync(this.entityConfiguration.idField, ids));
-        return (0, maps_1.mapMap)(entityResults, (entityResultsForId, id) => {
-            const entityResult = entityResultsForId[0];
-            return (entityResult ??
-                (0, results_1.result)(new EntityNotFoundError_1.default(this.entityClass, this.entityConfiguration.idField, id)));
-        });
-    }
-    /**
-     * Loads many entities for a list of IDs, returning null for any IDs that are non-existent.
-     * @param ids - IDs of the entities to load
-     * @returns map from ID to nullable corresponding entity result, where result error can be UnauthorizedError or EntityNotFoundError.
-     */
-    async loadManyByIDsNullableAsync(ids) {
-        const entityResults = (await this.loadManyByFieldEqualingManyAsync(this.entityConfiguration.idField, ids));
-        return (0, maps_1.mapMap)(entityResults, (entityResultsForId) => {
-            return entityResultsForId[0] ?? null;
-        });
-    }
-    /**
-     * Loads the first entity matching the selection constructed from the conjunction of specified
-     * operands, or null if no matching entity exists. Entities loaded using this method are not
-     * batched or cached.
-     *
-     * This is a convenience method for {@link loadManyByFieldEqualityConjunctionAsync}. However, the
-     * `orderBy` option must be specified to define what "first" means. If ordering doesn't matter,
-     * explicitly pass in an empty array.
-     *
-     * @param fieldEqualityOperands - list of field equality selection operand specifications
-     * @param querySelectionModifiers - orderBy and optional offset for the query
-     * @returns the first entity results that matches the query, where result error can be
-     *  UnauthorizedError
-     */
-    async loadFirstByFieldEqualityConjunctionAsync(fieldEqualityOperands, querySelectionModifiers) {
-        const results = await this.loadManyByFieldEqualityConjunctionAsync(fieldEqualityOperands, {
-            ...querySelectionModifiers,
-            limit: 1,
-        });
-        return results[0] ?? null;
-    }
-    /**
-     * Loads many entities matching the selection constructed from the conjunction of specified operands.
-     * Entities loaded using this method are not batched or cached.
-     *
-     * @example
-     * fieldEqualityOperands:
-     * `[{fieldName: 'hello', fieldValue: 1}, {fieldName: 'world', fieldValues: [2, 3]}]`
-     * Entities returned with a SQL EntityDatabaseAdapter:
-     * `WHERE hello = 1 AND world = ANY({2, 3})`
-     *
-     * @param fieldEqualityOperands - list of field equality selection operand specifications
-     * @param querySelectionModifiers - limit, offset, and orderBy for the query
-     * @returns array of entity results that match the query, where result error can be UnauthorizedError
-     */
-    async loadManyByFieldEqualityConjunctionAsync(fieldEqualityOperands, querySelectionModifiers = {}) {
-        for (const fieldEqualityOperand of fieldEqualityOperands) {
-            const fieldValues = (0, EntityDatabaseAdapter_1.isSingleValueFieldEqualityCondition)(fieldEqualityOperand)
-                ? [fieldEqualityOperand.fieldValue]
-                : fieldEqualityOperand.fieldValues;
-            this.validateFieldValues(fieldEqualityOperand.fieldName, fieldValues);
-        }
-        const fieldObjects = await this.dataManager.loadManyByFieldEqualityConjunctionAsync(this.queryContext, fieldEqualityOperands, querySelectionModifiers);
-        const uncheckedEntityResults = this.tryConstructEntities(fieldObjects);
-        return await Promise.all(uncheckedEntityResults.map(async (uncheckedEntityResult) => {
-            if (!uncheckedEntityResult.ok) {
-                return uncheckedEntityResult;
-            }
-            return await (0, results_1.asyncResult)(this.privacyPolicy.authorizeReadAsync(this.viewerContext, this.queryContext, this.privacyPolicyEvaluationContext, uncheckedEntityResult.value, this.metricsAdapter));
-        }));
-    }
-    /**
-     * Loads many entities matching the raw WHERE clause. Corresponds to the knex `whereRaw` argument format.
-     *
-     * @remarks
-     * Important notes:
-     * - Fields in clause are database column names instead of transformed entity field names.
-     * - Entities loaded using this method are not batched or cached.
-     * - Not all database adapters implement the ability to execute this method of fetching entities.
-     *
-     * @example
-     * rawWhereClause: `id = ?`
-     * bindings: `[1]`
-     * Entites returned `WHERE id = 1`
-     *
-     * http://knexjs.org/#Builder-whereRaw
-     * http://knexjs.org/#Raw-Bindings
-     *
-     * @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 entity results that match the query, where result error can be UnauthorizedError
-     * @throws Error when rawWhereClause or bindings are invalid
-     *
-     * @deprecated prefer caching loaders
-     */
-    async loadManyByRawWhereClauseAsync(rawWhereClause, bindings, querySelectionModifiers = {}) {
-        const fieldObjects = await this.dataManager.loadManyByRawWhereClauseAsync(this.queryContext, rawWhereClause, bindings, querySelectionModifiers);
-        const uncheckedEntityResults = this.tryConstructEntities(fieldObjects);
-        return await Promise.all(uncheckedEntityResults.map(async (uncheckedEntityResult) => {
-            if (!uncheckedEntityResult.ok) {
-                return uncheckedEntityResult;
-            }
-            return await (0, results_1.asyncResult)(this.privacyPolicy.authorizeReadAsync(this.viewerContext, this.queryContext, this.privacyPolicyEvaluationContext, uncheckedEntityResult.value, this.metricsAdapter));
-        }));
-    }
-    /**
-     * Invalidate all caches for an entity's fields. Exposed primarily for internal use by EntityMutator.
-     * @param objectFields - entity data object to be invalidated
-     */
-    async invalidateFieldsAsync(objectFields) {
-        await this.dataManager.invalidateObjectFieldsAsync(objectFields);
-    }
-    /**
-     * Invalidate all caches for an entity. One potential use case would be to keep the entity
-     * framework in sync with changes made to data outside of the framework.
-     * @param entity - entity to be invalidated
-     */
-    async invalidateEntityAsync(entity) {
-        await this.invalidateFieldsAsync(entity.getAllDatabaseFields());
-    }
-    tryConstructEntities(fieldsObjects) {
-        return fieldsObjects.map((fieldsObject) => {
-            try {
-                return (0, results_1.result)(this.constructEntity(fieldsObject));
-            }
-            catch (e) {
-                if (!(e instanceof Error)) {
-                    throw e;
-                }
-                return (0, results_1.result)(e);
-            }
-        });
-    }
-    constructEntity(fieldsObject) {
-        const idField = this.entityConfiguration.idField;
-        const id = (0, nullthrows_1.default)(fieldsObject[idField], 'must provide ID to create an entity');
-        const entitySelectedFields = this.entitySelectedFields ?? Array.from(this.entityConfiguration.schema.keys());
-        const selectedFields = (0, entityUtils_1.pick)(fieldsObject, entitySelectedFields);
-        return new this.entityClass({
-            viewerContext: this.viewerContext,
-            id: id,
-            databaseFields: fieldsObject,
-            selectedFields,
-        });
-    }
-    /**
-     * Construct and authorize entities from fields map, returning error results for entities that fail
-     * to construct or fail to authorize.
-     *
-     * @param map - map from an arbitrary key type to an array of entity field objects
-     */
-    async constructAndAuthorizeEntitiesAsync(map) {
-        const uncheckedEntityResultsMap = (0, maps_1.mapMap)(map, (fieldObjects) => this.tryConstructEntities(fieldObjects));
-        return await (0, maps_1.mapMapAsync)(uncheckedEntityResultsMap, async (uncheckedEntityResults) => {
-            return await Promise.all(uncheckedEntityResults.map(async (uncheckedEntityResult) => {
-                if (!uncheckedEntityResult.ok) {
-                    return uncheckedEntityResult;
-                }
-                return await (0, results_1.asyncResult)(this.privacyPolicy.authorizeReadAsync(this.viewerContext, this.queryContext, this.privacyPolicyEvaluationContext, uncheckedEntityResult.value, this.metricsAdapter));
-            }));
-        });
-    }
-    validateFieldValues(fieldName, fieldValues) {
-        const fieldDefinition = this.entityConfiguration.schema.get(fieldName);
-        (0, invariant_1.default)(fieldDefinition, `must have field definition for field = ${String(fieldName)}`);
-        for (const fieldValue of fieldValues) {
-            const isInputValid = fieldDefinition.validateInputValue(fieldValue);
-            if (!isInputValid) {
-                throw new EntityInvalidFieldValueError_1.default(this.entityClass, fieldName, fieldValue);
-            }
-        }
+    utils() {
+        return this.utilsPrivate;
     }
 }
 exports.default = EntityLoader;

package/build/EntityLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityLoader.js","sourceRoot":"","sources":["../src/EntityLoader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityLoader.js","sourceRoot":"","sources":["../src/EntityLoader.ts"],"names":[],"mappings":";;;;;AAAA,kHAA0F;AAC1F,oFAA4D;AAG5D,4EAAoD;AAQpD;;;GAGG;AACH,MAAqB,YAAY;IAwBZ;IACA;IACA;IAOA;IACA;IAQA;IACA;IACA;IACE;IA/BJ,YAAY,CAO3B;IAEF,YACmB,aAA6B,EAC7B,YAAgC,EAChC,8BAMhB,EACgB,mBAAiD,EACjD,WAOhB,EACgB,oBAAmD,EACnD,aAA6B,EAC7B,WAAuC,EACrC,cAAqC;QArBvC,kBAAa,GAAb,aAAa,CAAgB;QAC7B,iBAAY,GAAZ,YAAY,CAAoB;QAChC,mCAA8B,GAA9B,8BAA8B,CAM9C;QACgB,wBAAmB,GAAnB,mBAAmB,CAA8B;QACjD,gBAAW,GAAX,WAAW,CAO3B;QACgB,yBAAoB,GAApB,oBAAoB,CAA+B;QACnD,kBAAa,GAAb,aAAa,CAAgB;QAC7B,gBAAW,GAAX,WAAW,CAA4B;QACrC,mBAAc,GAAd,cAAc,CAAuB;QAExD,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAiB,CACvC,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,8BAA8B,EACnC,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS;QAQP,OAAO,IAAI,+BAAqB,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,wBAAwB;QAQtB,OAAO,IAAI,8CAAoC,CAC7C,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,KAAK;QAQV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF;AAjHD,+BAiHC"}

package/build/EntityLoaderFactory.d.ts

@@ -19,5 +19,5 @@ export default class EntityLoaderFactory<TFields extends object, TID extends Non
      * @param viewerContext - viewer context of loading user
      * @param queryContext - query context in which to perform the load
      */
-    forLoad(viewerContext: TViewerContext, queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext): EntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forLoad(viewerContext: TViewerContext, queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>): EntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
 }

package/build/EntityLoaderFactory.js

@@ -8,6 +8,9 @@ const EntityLoader_1 = __importDefault(require("./EntityLoader"));
  * The primary entry point for loading entities.
  */
 class EntityLoaderFactory {
+    entityCompanion;
+    dataManager;
+    metricsAdapter;
     constructor(entityCompanion, dataManager, metricsAdapter) {
         this.entityCompanion = entityCompanion;
         this.dataManager = dataManager;

package/build/EntityLoaderFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityLoaderFactory.js","sourceRoot":"","sources":["../src/EntityLoaderFactory.ts"],"names":[],"mappings":";;;;;AACA,kEAA0C;AAQ1C;;GAEG;AACH,MAAqB,mBAAmB;IActC,YACmB,eAOhB,EACgB,WAAuC,EACrC,cAAqC;QATvC,oBAAe,GAAf,eAAe,CAO/B;QACgB,gBAAW,GAAX,WAAW,CAA4B;QACrC,mBAAc,GAAd,cAAc,CAAuB;IACvD,CAAC;IAEJ;;;;OAIG;IACH,OAAO,CACL,aAA6B,EAC7B,YAAgC,EAChC,8BAAoE;QAEpE,OAAO,IAAI,sBAAY,CACrB,aAAa,EACb,YAAY,EACZ,8BAA8B,EAC9B,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,mBAAmB,EAClE,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,WAAW,EAC1D,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,oBAAoB,EACnE,IAAI,CAAC,eAAe,CAAC,aAAa,EAClC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;CACF;AAjDD,sCAiDC"}
+{"version":3,"file":"EntityLoaderFactory.js","sourceRoot":"","sources":["../src/EntityLoaderFactory.ts"],"names":[],"mappings":";;;;;AACA,kEAA0C;AAQ1C;;GAEG;AACH,MAAqB,mBAAmB;IAenB;IAQA;IACE;IAVrB,YACmB,eAOhB,EACgB,WAAuC,EACrC,cAAqC;QATvC,oBAAe,GAAf,eAAe,CAO/B;QACgB,gBAAW,GAAX,WAAW,CAA4B;QACrC,mBAAc,GAAd,cAAc,CAAuB;IACvD,CAAC;IAEJ;;;;OAIG;IACH,OAAO,CACL,aAA6B,EAC7B,YAAgC,EAChC,8BAMC;QAED,OAAO,IAAI,sBAAY,CACrB,aAAa,EACb,YAAY,EACZ,8BAA8B,EAC9B,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,mBAAmB,EAClE,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,WAAW,EAC1D,IAAI,CAAC,eAAe,CAAC,yBAAyB,CAAC,oBAAoB,EACnE,IAAI,CAAC,eAAe,CAAC,aAAa,EAClC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;CACF;AAvDD,sCAuDC"}

package/build/EntityLoaderUtils.d.ts

@@ -0,0 +1,58 @@
+import { Result } from '@expo/results';
+import { IEntityClass } from './Entity';
+import EntityConfiguration from './EntityConfiguration';
+import EntityPrivacyPolicy, { EntityPrivacyPolicyEvaluationContext } from './EntityPrivacyPolicy';
+import { EntityQueryContext } from './EntityQueryContext';
+import ReadonlyEntity from './ReadonlyEntity';
+import ViewerContext from './ViewerContext';
+import EntityDataManager from './internal/EntityDataManager';
+import IEntityMetricsAdapter from './metrics/IEntityMetricsAdapter';
+/**
+ * Entity loader utilities for things like invalidation, entity construction, and authorization.
+ * Methods are exposed publicly since in rare cases they may need to be called manually.
+ */
+export default class EntityLoaderUtils<TFields extends object, TID extends NonNullable<TFields[TSelectedFields]>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TID, TViewerContext, TEntity, TSelectedFields>, TSelectedFields extends keyof TFields> {
+    private readonly viewerContext;
+    private readonly queryContext;
+    private readonly privacyPolicyEvaluationContext;
+    private readonly entityConfiguration;
+    private readonly entityClass;
+    private readonly entitySelectedFields;
+    private readonly privacyPolicy;
+    private readonly dataManager;
+    protected readonly metricsAdapter: IEntityMetricsAdapter;
+    constructor(viewerContext: TViewerContext, queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, entityConfiguration: EntityConfiguration<TFields>, entityClass: IEntityClass<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, entitySelectedFields: TSelectedFields[] | undefined, privacyPolicy: TPrivacyPolicy, dataManager: EntityDataManager<TFields>, metricsAdapter: IEntityMetricsAdapter);
+    /**
+     * Invalidate all caches for an entity's fields. Exposed primarily for internal use by EntityMutator.
+     * @param objectFields - entity data object to be invalidated
+     */
+    invalidateFieldsAsync(objectFields: Readonly<TFields>): Promise<void>;
+    /**
+     * Invalidate all caches for an entity. One potential use case would be to keep the entity
+     * framework in sync with changes made to data outside of the framework.
+     * @param entity - entity to be invalidated
+     */
+    invalidateEntityAsync(entity: TEntity): Promise<void>;
+    /**
+     * Construct an entity from a fields object (applying field selection if applicable),
+     * checking that the ID field is specified.
+     *
+     * @param fieldsObject - fields object
+     */
+    constructEntity(fieldsObject: TFields): TEntity;
+    /**
+     * Construct and authorize entities from fields map, returning error results for entities that fail
+     * to construct or fail to authorize.
+     *
+     * @param map - map from an arbitrary key type to an array of entity field objects
+     */
+    constructAndAuthorizeEntitiesAsync<K>(map: ReadonlyMap<K, readonly Readonly<TFields>[]>): Promise<ReadonlyMap<K, readonly Result<TEntity>[]>>;
+    /**
+     * Construct and authorize entities from field objects array, returning error results for entities that fail
+     * to construct or fail to authorize.
+     *
+     * @param fieldObjects - array of field objects
+     */
+    constructAndAuthorizeEntitiesArrayAsync(fieldObjects: readonly Readonly<TFields>[]): Promise<readonly Result<TEntity>[]>;
+    private tryConstructEntities;
+}