@expo/entity 0.39.0 → 0.41.0

package/build/EntityMutatorFactory.d.ts

@@ -1,3 +1,4 @@
+import { AuthorizationResultBasedCreateMutator, AuthorizationResultBasedUpdateMutator, AuthorizationResultBasedDeleteMutator } from './AuthorizationResultBasedEntityMutator';
 import Entity, { IEntityClass } from './Entity';
 import EntityCompanionProvider from './EntityCompanionProvider';
 import EntityConfiguration from './EntityConfiguration';
@@ -5,7 +6,6 @@ import EntityDatabaseAdapter from './EntityDatabaseAdapter';
 import EntityLoaderFactory from './EntityLoaderFactory';
 import EntityMutationTriggerConfiguration from './EntityMutationTriggerConfiguration';
 import EntityMutationValidator from './EntityMutationValidator';
-import { CreateMutator, UpdateMutator, DeleteMutator } from './EntityMutator';
 import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
 import ViewerContext from './ViewerContext';
@@ -30,18 +30,18 @@ export default class EntityMutatorFactory<TFields extends object, TID extends No
      * @param queryContext - query context in which to perform the create
      * @returns mutator for creating an entity
      */
-    forCreate(viewerContext: TViewerContext, queryContext: EntityQueryContext): CreateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forCreate(viewerContext: TViewerContext, queryContext: EntityQueryContext): AuthorizationResultBasedCreateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
     /**
      * Vend mutator for updating an existing entity in given query context.
      * @param existingEntity - entity to update
      * @param queryContext - query context in which to perform the update
      * @returns mutator for updating existingEntity
      */
-    forUpdate(existingEntity: TEntity, queryContext: EntityQueryContext): UpdateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forUpdate(existingEntity: TEntity, queryContext: EntityQueryContext): AuthorizationResultBasedUpdateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
     /**
      * Delete an existing entity in given query context.
      * @param existingEntity - entity to delete
      * @param queryContext - query context in which to perform the delete
      */
-    forDelete(existingEntity: TEntity, queryContext: EntityQueryContext): DeleteMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forDelete(existingEntity: TEntity, queryContext: EntityQueryContext): AuthorizationResultBasedDeleteMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
 }

package/build/EntityMutatorFactory.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const EntityMutator_1 = require("./EntityMutator");
+const AuthorizationResultBasedEntityMutator_1 = require("./AuthorizationResultBasedEntityMutator");
 /**
  * The primary interface for creating, mutating, and deleting entities.
  */
@@ -32,7 +32,7 @@ class EntityMutatorFactory {
      * @returns mutator for creating an entity
      */
     forCreate(viewerContext, queryContext) {
-        return new EntityMutator_1.CreateMutator(this.entityCompanionProvider, viewerContext, queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter);
+        return new AuthorizationResultBasedEntityMutator_1.AuthorizationResultBasedCreateMutator(this.entityCompanionProvider, viewerContext, queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter);
     }
     /**
      * Vend mutator for updating an existing entity in given query context.
@@ -41,7 +41,7 @@ class EntityMutatorFactory {
      * @returns mutator for updating existingEntity
      */
     forUpdate(existingEntity, queryContext) {
-        return new EntityMutator_1.UpdateMutator(this.entityCompanionProvider, existingEntity.getViewerContext(), queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter, existingEntity);
+        return new AuthorizationResultBasedEntityMutator_1.AuthorizationResultBasedUpdateMutator(this.entityCompanionProvider, existingEntity.getViewerContext(), queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter, existingEntity);
     }
     /**
      * Delete an existing entity in given query context.
@@ -49,7 +49,7 @@ class EntityMutatorFactory {
      * @param queryContext - query context in which to perform the delete
      */
     forDelete(existingEntity, queryContext) {
-        return new EntityMutator_1.DeleteMutator(this.entityCompanionProvider, existingEntity.getViewerContext(), queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter, existingEntity);
+        return new AuthorizationResultBasedEntityMutator_1.AuthorizationResultBasedDeleteMutator(this.entityCompanionProvider, existingEntity.getViewerContext(), queryContext, this.entityConfiguration, this.entityClass, this.privacyPolicy, this.mutationValidators, this.mutationTriggers, this.entityLoaderFactory, this.databaseAdapter, this.metricsAdapter, existingEntity);
     }
 }
 exports.default = EntityMutatorFactory;

package/build/EntityMutatorFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityMutatorFactory.js","sourceRoot":"","sources":["../src/EntityMutatorFactory.ts"],"names":[],"mappings":";;AAOA,mDAA8E;AAM9E;;GAEG;AACH,MAAqB,oBAAoB;IAepB;IACA;IACA;IAQA;IACA;IAOA;IAOA;IAQA;IACA;IAnCnB,YACmB,uBAAgD,EAChD,mBAAiD,EACjD,WAOhB,EACgB,aAA6B,EAC7B,kBAMd,EACc,gBAMhB,EACgB,mBAOhB,EACgB,eAA+C,EAC/C,cAAqC;QAlCrC,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,wBAAmB,GAAnB,mBAAmB,CAA8B;QACjD,gBAAW,GAAX,WAAW,CAO3B;QACgB,kBAAa,GAAb,aAAa,CAAgB;QAC7B,uBAAkB,GAAlB,kBAAkB,CAMhC;QACc,qBAAgB,GAAhB,gBAAgB,CAMhC;QACgB,wBAAmB,GAAnB,mBAAmB,CAOnC;QACgB,oBAAe,GAAf,eAAe,CAAgC;QAC/C,mBAAc,GAAd,cAAc,CAAuB;IACrD,CAAC;IAEJ;;;;;OAKG;IACH,SAAS,CACP,aAA6B,EAC7B,YAAgC;QAEhC,OAAO,IAAI,6BAAa,CACtB,IAAI,CAAC,uBAAuB,EAC5B,aAAa,EACb,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,SAAS,CACP,cAAuB,EACvB,YAAgC;QAEhC,OAAO,IAAI,6BAAa,CACtB,IAAI,CAAC,uBAAuB,EAC5B,cAAc,CAAC,gBAAgB,EAAE,EACjC,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,cAAc,CACf,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS,CACP,cAAuB,EACvB,YAAgC;QAEhC,OAAO,IAAI,6BAAa,CACtB,IAAI,CAAC,uBAAuB,EAC5B,cAAc,CAAC,gBAAgB,EAAE,EACjC,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,cAAc,CACf,CAAC;IACJ,CAAC;CACF;AA/HD,uCA+HC"}
+{"version":3,"file":"EntityMutatorFactory.js","sourceRoot":"","sources":["../src/EntityMutatorFactory.ts"],"names":[],"mappings":";;AAAA,mGAIiD;AAajD;;GAEG;AACH,MAAqB,oBAAoB;IAepB;IACA;IACA;IAQA;IACA;IAOA;IAOA;IAQA;IACA;IAnCnB,YACmB,uBAAgD,EAChD,mBAAiD,EACjD,WAOhB,EACgB,aAA6B,EAC7B,kBAMd,EACc,gBAMhB,EACgB,mBAOhB,EACgB,eAA+C,EAC/C,cAAqC;QAlCrC,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,wBAAmB,GAAnB,mBAAmB,CAA8B;QACjD,gBAAW,GAAX,WAAW,CAO3B;QACgB,kBAAa,GAAb,aAAa,CAAgB;QAC7B,uBAAkB,GAAlB,kBAAkB,CAMhC;QACc,qBAAgB,GAAhB,gBAAgB,CAMhC;QACgB,wBAAmB,GAAnB,mBAAmB,CAOnC;QACgB,oBAAe,GAAf,eAAe,CAAgC;QAC/C,mBAAc,GAAd,cAAc,CAAuB;IACrD,CAAC;IAEJ;;;;;OAKG;IACH,SAAS,CACP,aAA6B,EAC7B,YAAgC;QAShC,OAAO,IAAI,6EAAqC,CAC9C,IAAI,CAAC,uBAAuB,EAC5B,aAAa,EACb,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,SAAS,CACP,cAAuB,EACvB,YAAgC;QAShC,OAAO,IAAI,6EAAqC,CAC9C,IAAI,CAAC,uBAAuB,EAC5B,cAAc,CAAC,gBAAgB,EAAE,EACjC,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,cAAc,CACf,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS,CACP,cAAuB,EACvB,YAAgC;QAShC,OAAO,IAAI,6EAAqC,CAC9C,IAAI,CAAC,uBAAuB,EAC5B,cAAc,CAAC,gBAAgB,EAAE,EACjC,YAAY,EACZ,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,cAAc,CACf,CAAC;IACJ,CAAC;CACF;AApJD,uCAoJC"}

package/build/EntitySecondaryCacheLoader.d.ts

@@ -1,5 +1,5 @@
 import { Result } from '@expo/results';
-import EntityLoader from './EntityLoader';
+import AuthorizationResultBasedEntityLoader from './AuthorizationResultBasedEntityLoader';
 import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import ReadonlyEntity from './ReadonlyEntity';
 import ViewerContext from './ViewerContext';
@@ -35,8 +35,8 @@ export interface ISecondaryEntityCache<TFields, TLoadParams> {
  */
 export default abstract class EntitySecondaryCacheLoader<TLoadParams, 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 = keyof TFields> {
     private readonly secondaryEntityCache;
-    protected readonly entityLoader: EntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
-    constructor(secondaryEntityCache: ISecondaryEntityCache<TFields, TLoadParams>, entityLoader: EntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>);
+    protected readonly entityLoader: AuthorizationResultBasedEntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    constructor(secondaryEntityCache: ISecondaryEntityCache<TFields, TLoadParams>, entityLoader: AuthorizationResultBasedEntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>);
     /**
      * Load many by load params objects
      *

package/build/EntitySecondaryCacheLoader.js

@@ -27,9 +27,7 @@ class EntitySecondaryCacheLoader {
     async loadManyAsync(loadParamsArray) {
         const loadParamsToFieldObjects = await this.secondaryEntityCache.loadManyThroughAsync(loadParamsArray, this.fetchObjectsFromDatabaseAsync.bind(this));
         // convert value to and from array to reuse complex code
-        const entitiesMap = await this.entityLoader
-            .utils()
-            .constructAndAuthorizeEntitiesAsync((0, maps_1.mapMap)(loadParamsToFieldObjects, (fieldObject) => (fieldObject ? [fieldObject] : [])));
+        const entitiesMap = await this.entityLoader.utils.constructAndAuthorizeEntitiesAsync((0, maps_1.mapMap)(loadParamsToFieldObjects, (fieldObject) => (fieldObject ? [fieldObject] : [])));
         return (0, maps_1.mapMap)(entitiesMap, (fieldObjects) => fieldObjects[0] ?? null);
     }
     /**

package/build/EntitySecondaryCacheLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntitySecondaryCacheLoader.js","sourceRoot":"","sources":["../src/EntitySecondaryCacheLoader.ts"],"names":[],"mappings":";;AAMA,mDAAkD;AA4BlD;;;;;;;;;;GAUG;AACH,MAA8B,0BAA0B;IAgBnC;IACE;IAFrB,YACmB,oBAAiE,EAC/D,YAOlB;QARgB,yBAAoB,GAApB,oBAAoB,CAA6C;QAC/D,iBAAY,GAAZ,YAAY,CAO9B;IACA,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,aAAa,CACxB,eAAiD;QAEjD,MAAM,wBAAwB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CACnF,eAAe,EACf,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9C,CAAC;QAEF,wDAAwD;QACxD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY;aACxC,KAAK,EAAE;aACP,kCAAkC,CACjC,IAAA,aAAM,EAAC,wBAAwB,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CACtF,CAAC;QACJ,OAAO,IAAA,aAAM,EAAC,WAAW,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,mBAAmB,CAC9B,eAAiD;QAEjD,MAAM,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACvE,CAAC;CAUF;AApED,6CAoEC"}
+{"version":3,"file":"EntitySecondaryCacheLoader.js","sourceRoot":"","sources":["../src/EntitySecondaryCacheLoader.ts"],"names":[],"mappings":";;AAMA,mDAAkD;AA4BlD;;;;;;;;;;GAUG;AACH,MAA8B,0BAA0B;IAgBnC;IACE;IAFrB,YACmB,oBAAiE,EAC/D,YAOlB;QARgB,yBAAoB,GAApB,oBAAoB,CAA6C;QAC/D,iBAAY,GAAZ,YAAY,CAO9B;IACA,CAAC;IAEJ;;;;OAIG;IACI,KAAK,CAAC,aAAa,CACxB,eAAiD;QAEjD,MAAM,wBAAwB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CACnF,eAAe,EACf,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9C,CAAC;QAEF,wDAAwD;QACxD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,kCAAkC,CAClF,IAAA,aAAM,EAAC,wBAAwB,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CACtF,CAAC;QACF,OAAO,IAAA,aAAM,EAAC,WAAW,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,mBAAmB,CAC9B,eAAiD;QAEjD,MAAM,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACvE,CAAC;CAUF;AAlED,6CAkEC"}

package/build/EntityUpdater.d.ts

@@ -0,0 +1,27 @@
+import { AuthorizationResultBasedUpdateMutator } from './AuthorizationResultBasedEntityMutator';
+import EnforcingEntityUpdater from './EnforcingEntityUpdater';
+import { IEntityClass } from './Entity';
+import EntityPrivacyPolicy from './EntityPrivacyPolicy';
+import { EntityQueryContext } from './EntityQueryContext';
+import ReadonlyEntity from './ReadonlyEntity';
+import ViewerContext from './ViewerContext';
+/**
+ * The primary interface for updating entities.
+ */
+export default class EntityUpdater<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 existingEntity;
+    private readonly queryContext;
+    private readonly entityClass;
+    constructor(existingEntity: TEntity, queryContext: EntityQueryContext, entityClass: IEntityClass<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>);
+    /**
+     * Enforcing entity updater. All updates through this updater are
+     * guaranteed to be successful and will throw otherwise.
+     */
+    enforcing(): EnforcingEntityUpdater<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    /**
+     * Authorization-result-based entity updater. All updates through this
+     * updater are results, where an unsuccessful result means an authorization
+     * error or entity construction error occurred. Other errors are thrown.
+     */
+    withAuthorizationResults(): AuthorizationResultBasedUpdateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+}

package/build/EntityUpdater.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const EnforcingEntityUpdater_1 = __importDefault(require("./EnforcingEntityUpdater"));
+/**
+ * The primary interface for updating entities.
+ */
+class EntityUpdater {
+    existingEntity;
+    queryContext;
+    entityClass;
+    constructor(existingEntity, queryContext, entityClass) {
+        this.existingEntity = existingEntity;
+        this.queryContext = queryContext;
+        this.entityClass = entityClass;
+    }
+    /**
+     * Enforcing entity updater. All updates through this updater are
+     * guaranteed to be successful and will throw otherwise.
+     */
+    enforcing() {
+        return new EnforcingEntityUpdater_1.default(this.withAuthorizationResults());
+    }
+    /**
+     * Authorization-result-based entity updater. All updates through this
+     * updater are results, where an unsuccessful result means an authorization
+     * error or entity construction error occurred. Other errors are thrown.
+     */
+    withAuthorizationResults() {
+        return this.existingEntity
+            .getViewerContext()
+            .getViewerScopedEntityCompanionForClass(this.entityClass)
+            .getMutatorFactory()
+            .forUpdate(this.existingEntity, this.queryContext);
+    }
+}
+exports.default = EntityUpdater;
+//# sourceMappingURL=EntityUpdater.js.map

package/build/EntityUpdater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityUpdater.js","sourceRoot":"","sources":["../src/EntityUpdater.ts"],"names":[],"mappings":";;;;;AACA,sFAA8D;AAO9D;;GAEG;AACH,MAAqB,aAAa;IAeb;IACA;IACA;IAHnB,YACmB,cAAuB,EACvB,YAAgC,EAChC,WAOhB;QATgB,mBAAc,GAAd,cAAc,CAAS;QACvB,iBAAY,GAAZ,YAAY,CAAoB;QAChC,gBAAW,GAAX,WAAW,CAO3B;IACA,CAAC;IAEJ;;;OAGG;IACH,SAAS;QAQP,OAAO,IAAI,gCAAsB,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,wBAAwB;QAQtB,OAAO,IAAI,CAAC,cAAc;aACvB,gBAAgB,EAAE;aAClB,sCAAsC,CAAC,IAAI,CAAC,WAAW,CAAC;aACxD,iBAAiB,EAAE;aACnB,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;CACF;AA7DD,gCA6DC"}

package/build/ReadonlyEntity.d.ts

@@ -1,6 +1,9 @@
+import AuthorizationResultBasedEntityAssociationLoader from './AuthorizationResultBasedEntityAssociationLoader';
+import AuthorizationResultBasedEntityLoader from './AuthorizationResultBasedEntityLoader';
+import EnforcingEntityAssociationLoader from './EnforcingEntityAssociationLoader';
+import EnforcingEntityLoader from './EnforcingEntityLoader';
 import { IEntityClass } from './Entity';
-import EntityAssociationLoader from './EntityAssociationLoader';
-import EntityLoader from './EntityLoader';
+import EntityLoaderUtils from './EntityLoaderUtils';
 import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
 import ViewerContext from './ViewerContext';
@@ -48,9 +51,13 @@ export default abstract class ReadonlyEntity<TFields extends object, TID extends
      */
     getID(): TID;
     /**
-     * @returns EntityAssociationLoader for this entity
+     * @returns EnforcingEntityAssociationLoader for this entity
      */
-    associationLoader(): EntityAssociationLoader<TFields, TID, TViewerContext, this, TSelectedFields>;
+    associationLoader(queryContext?: EntityQueryContext): EnforcingEntityAssociationLoader<TFields, TID, TViewerContext, this, TSelectedFields>;
+    /**
+     * @returns AuthorizationResultBasedEntityAssociationLoader for this entity
+     */
+    associationLoaderWithAuthorizationResults(queryContext?: EntityQueryContext): AuthorizationResultBasedEntityAssociationLoader<TFields, TID, TViewerContext, this, TSelectedFields>;
     /**
      * Get a underlying field from this entity's data
      * @param fieldName - the field to get
@@ -70,5 +77,17 @@ export default abstract class ReadonlyEntity<TFields extends object, TID extends
      * @param viewerContext - viewer context of loading user
      * @param queryContext - query context in which to perform the load
      */
-    static loader<TMFields extends object, TMID extends NonNullable<TMFields[TMSelectedFields]>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMID, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMID, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): EntityLoader<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+    static loader<TMFields extends object, TMID extends NonNullable<TMFields[TMSelectedFields]>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMID, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMID, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): EnforcingEntityLoader<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+    /**
+     * Vend loader for loading an entity in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static loaderWithAuthorizationResults<TMFields extends object, TMID extends NonNullable<TMFields[TMSelectedFields]>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMID, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMID, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): AuthorizationResultBasedEntityLoader<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
+    /**
+     * Vend loader for loading an entity in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static loaderUtils<TMFields extends object, TMID extends NonNullable<TMFields[TMSelectedFields]>, TMViewerContext extends ViewerContext, TMViewerContext2 extends TMViewerContext, TMEntity extends ReadonlyEntity<TMFields, TMID, TMViewerContext, TMSelectedFields>, TMPrivacyPolicy extends EntityPrivacyPolicy<TMFields, TMID, TMViewerContext, TMEntity, TMSelectedFields>, TMSelectedFields extends keyof TMFields = keyof TMFields>(this: IEntityClass<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>, viewerContext: TMViewerContext2, queryContext?: EntityQueryContext): EntityLoaderUtils<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields>;
 }

package/build/ReadonlyEntity.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const invariant_1 = __importDefault(require("invariant"));
 const EntityAssociationLoader_1 = __importDefault(require("./EntityAssociationLoader"));
+const EntityLoader_1 = __importDefault(require("./EntityLoader"));
 /**
  * A readonly entity exposes only the read functionality of an Entity. Used as the base
  * type for most entity operations excluding mutations.
@@ -58,10 +59,16 @@ class ReadonlyEntity {
         return this.id;
     }
     /**
-     * @returns EntityAssociationLoader for this entity
+     * @returns EnforcingEntityAssociationLoader for this entity
      */
-    associationLoader() {
-        return new EntityAssociationLoader_1.default(this);
+    associationLoader(queryContext) {
+        return new EntityAssociationLoader_1.default(this, queryContext).enforcing();
+    }
+    /**
+     * @returns AuthorizationResultBasedEntityAssociationLoader for this entity
+     */
+    associationLoaderWithAuthorizationResults(queryContext) {
+        return new EntityAssociationLoader_1.default(this, queryContext).withAuthorizationResults();
     }
     /**
      * Get a underlying field from this entity's data
@@ -92,10 +99,29 @@ class ReadonlyEntity {
         .getViewerScopedEntityCompanionForClass(this)
         .getQueryContextProvider()
         .getQueryContext()) {
-        return viewerContext
-            .getViewerScopedEntityCompanionForClass(this)
-            .getLoaderFactory()
-            .forLoad(queryContext, { previousValue: null, cascadingDeleteCause: null });
+        return new EntityLoader_1.default(viewerContext, queryContext, this).enforcing();
+    }
+    /**
+     * Vend loader for loading an entity in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static loaderWithAuthorizationResults(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return new EntityLoader_1.default(viewerContext, queryContext, this).withAuthorizationResults();
+    }
+    /**
+     * Vend loader for loading an entity in a given query context.
+     * @param viewerContext - viewer context of loading user
+     * @param queryContext - query context in which to perform the load
+     */
+    static loaderUtils(viewerContext, queryContext = viewerContext
+        .getViewerScopedEntityCompanionForClass(this)
+        .getQueryContextProvider()
+        .getQueryContext()) {
+        return new EntityLoader_1.default(viewerContext, queryContext, this).utils();
     }
 }
 exports.default = ReadonlyEntity;

package/build/ReadonlyEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadonlyEntity.js","sourceRoot":"","sources":["../src/ReadonlyEntity.ts"],"names":[],"mappings":";;;;;AAAA,0DAAkC;AAGlC,wFAAgE;AAMhE;;;;;;;GAOG;AACH,MAA8B,cAAc;IAMzB,aAAa,CAAiB;IAC9B,EAAE,CAAM;IACR,cAAc,CAAoB;IAClC,cAAc,CAA2C;IAE1E;;;;;;;;;;;;;OAaG;IACH,YAAY,EACV,aAAa,EACb,EAAE,EACF,cAAc,EACd,cAAc,GAMf;QACC,IAAA,mBAAS,EAAC,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAElE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;IACrD,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,iBAAiB;QAOf,OAAO,IAAI,iCAAuB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,SAAY;QAEZ,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAuBX,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QAEpB,OAAO,aAAa;aACjB,sCAAsC,CAAC,IAAI,CAAC;aAC5C,gBAAgB,EAAE;aAClB,OAAO,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AA/ID,iCA+IC"}
+{"version":3,"file":"ReadonlyEntity.js","sourceRoot":"","sources":["../src/ReadonlyEntity.ts"],"names":[],"mappings":";;;;;AAAA,0DAAkC;AAOlC,wFAAgE;AAChE,kEAA0C;AAM1C;;;;;;;GAOG;AACH,MAA8B,cAAc;IAMzB,aAAa,CAAiB;IAC9B,EAAE,CAAM;IACR,cAAc,CAAoB;IAClC,cAAc,CAA2C;IAE1E;;;;;;;;;;;;;OAaG;IACH,YAAY,EACV,aAAa,EACb,EAAE,EACF,cAAc,EACd,cAAc,GAMf;QACC,IAAA,mBAAS,EAAC,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAElE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;IACrD,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,YAAiC;QAEjC,OAAO,IAAI,iCAAuB,CAChC,IAAI,EACJ,YAAY,CACb,CAAC,SAAS,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,yCAAyC,CACvC,YAAiC;QAQjC,OAAO,IAAI,iCAAuB,CAChC,IAAI,EACJ,YAAY,CACb,CAAC,wBAAwB,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,SAAY;QAEZ,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAuBX,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAI,sBAAY,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,8BAA8B,CAuBnC,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAI,sBAAY,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,wBAAwB,EAAE,CAAC;IACxF,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAuBhB,aAA+B,EAC/B,eAAmC,aAAa;SAC7C,sCAAsC,CAAC,IAAI,CAAC;SAC5C,uBAAuB,EAAE;SACzB,eAAe,EAAE;QASpB,OAAO,IAAI,sBAAY,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACrE,CAAC;CACF;AA5PD,iCA4PC"}

package/build/ViewerScopedEntityLoaderFactory.d.ts

@@ -1,4 +1,4 @@
-import EntityLoader from './EntityLoader';
+import AuthorizationResultBasedEntityLoader from './AuthorizationResultBasedEntityLoader';
 import EntityLoaderFactory from './EntityLoaderFactory';
 import EntityPrivacyPolicy, { EntityPrivacyPolicyEvaluationContext } from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
@@ -11,5 +11,5 @@ export default class ViewerScopedEntityLoaderFactory<TFields extends object, TID
     private readonly entityLoaderFactory;
     private readonly viewerContext;
     constructor(entityLoaderFactory: EntityLoaderFactory<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, viewerContext: TViewerContext);
-    forLoad(queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>): EntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forLoad(queryContext: EntityQueryContext, privacyPolicyEvaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>): AuthorizationResultBasedEntityLoader<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
 }

package/build/ViewerScopedEntityLoaderFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewerScopedEntityLoaderFactory.js","sourceRoot":"","sources":["../src/ViewerScopedEntityLoaderFactory.ts"],"names":[],"mappings":";;AAOA;;GAEG;AACH,MAAqB,+BAA+B;IAe/B;IAQA;IATnB,YACmB,mBAOhB,EACgB,aAA6B;QAR7B,wBAAmB,GAAnB,mBAAmB,CAOnC;QACgB,kBAAa,GAAb,aAAa,CAAgB;IAC7C,CAAC;IAEJ,OAAO,CACL,YAAgC,EAChC,8BAMC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CACrC,IAAI,CAAC,aAAa,EAClB,YAAY,EACZ,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AA1CD,kDA0CC"}
+{"version":3,"file":"ViewerScopedEntityLoaderFactory.js","sourceRoot":"","sources":["../src/ViewerScopedEntityLoaderFactory.ts"],"names":[],"mappings":";;AAOA;;GAEG;AACH,MAAqB,+BAA+B;IAe/B;IAQA;IATnB,YACmB,mBAOhB,EACgB,aAA6B;QAR7B,wBAAmB,GAAnB,mBAAmB,CAOnC;QACgB,kBAAa,GAAb,aAAa,CAAgB;IAC7C,CAAC;IAEJ,OAAO,CACL,YAAgC,EAChC,8BAMC;QASD,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CACrC,IAAI,CAAC,aAAa,EAClB,YAAY,EACZ,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAjDD,kDAiDC"}

package/build/ViewerScopedEntityMutatorFactory.d.ts

@@ -1,4 +1,4 @@
-import { CreateMutator, UpdateMutator, DeleteMutator } from './EntityMutator';
+import { AuthorizationResultBasedCreateMutator, AuthorizationResultBasedUpdateMutator, AuthorizationResultBasedDeleteMutator } from './AuthorizationResultBasedEntityMutator';
 import EntityMutatorFactory from './EntityMutatorFactory';
 import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
@@ -11,7 +11,7 @@ export default class ViewerScopedEntityMutatorFactory<TFields extends object, TI
     private readonly entityMutatorFactory;
     private readonly viewerContext;
     constructor(entityMutatorFactory: EntityMutatorFactory<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, viewerContext: TViewerContext);
-    forCreate(queryContext: EntityQueryContext): CreateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
-    forUpdate(existingEntity: TEntity, queryContext: EntityQueryContext): UpdateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
-    forDelete(existingEntity: TEntity, queryContext: EntityQueryContext): DeleteMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forCreate(queryContext: EntityQueryContext): AuthorizationResultBasedCreateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forUpdate(existingEntity: TEntity, queryContext: EntityQueryContext): AuthorizationResultBasedUpdateMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    forDelete(existingEntity: TEntity, queryContext: EntityQueryContext): AuthorizationResultBasedDeleteMutator<TFields, TID, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
 }

package/build/ViewerScopedEntityMutatorFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewerScopedEntityMutatorFactory.js","sourceRoot":"","sources":["../src/ViewerScopedEntityMutatorFactory.ts"],"names":[],"mappings":";;AAOA;;GAEG;AACH,MAAqB,gCAAgC;IAehC;IAQA;IATnB,YACmB,oBAOhB,EACgB,aAA6B;QAR7B,yBAAoB,GAApB,oBAAoB,CAOpC;QACgB,kBAAa,GAAb,aAAa,CAAgB;IAC7C,CAAC;IAEJ,SAAS,CACP,YAAgC;QAEhC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC/E,CAAC;IAED,SAAS,CACP,cAAuB,EACvB,YAAgC;QAEhC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,CACP,cAAuB,EACvB,YAAgC;QAEhC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;CACF;AA7CD,mDA6CC"}
+{"version":3,"file":"ViewerScopedEntityMutatorFactory.js","sourceRoot":"","sources":["../src/ViewerScopedEntityMutatorFactory.ts"],"names":[],"mappings":";;AAWA;;GAEG;AACH,MAAqB,gCAAgC;IAehC;IAQA;IATnB,YACmB,oBAOhB,EACgB,aAA6B;QAR7B,yBAAoB,GAApB,oBAAoB,CAOpC;QACgB,kBAAa,GAAb,aAAa,CAAgB;IAC7C,CAAC;IAEJ,SAAS,CACP,YAAgC;QAShC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC/E,CAAC;IAED,SAAS,CACP,cAAuB,EACvB,YAAgC;QAShC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,CACP,cAAuB,EACvB,YAAgC;QAShC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;CACF;AAlED,mDAkEC"}

package/build/__tests__/AuthorizationResultBasedEntityAssociationLoader-test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/AuthorizationResultBasedEntityAssociationLoader-test.js

@@ -0,0 +1,242 @@
+"use strict";
+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 uuid_1 = require("uuid");
+const AuthorizationResultBasedEntityAssociationLoader_1 = __importDefault(require("../AuthorizationResultBasedEntityAssociationLoader"));
+const entityUtils_1 = require("../entityUtils");
+const TestEntity_1 = __importDefault(require("../testfixtures/TestEntity"));
+const TestEntity2_1 = __importDefault(require("../testfixtures/TestEntity2"));
+const TestViewerContext_1 = __importDefault(require("../testfixtures/TestViewerContext"));
+const createUnitTestEntityCompanionProvider_1 = require("../utils/testing/createUnitTestEntityCompanionProvider");
+describe(AuthorizationResultBasedEntityAssociationLoader_1.default, () => {
+    describe('loadAssociatedEntityAsync', () => {
+        it('loads associated entities by ID and correctly handles a null value', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testOtherEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testOtherEntity.getID())
+                .createAsync());
+            const loadedOther = await (0, results_1.enforceAsyncResult)(testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityAsync('stringField', TestEntity_1.default));
+            expect(loadedOther.getID()).toEqual(testOtherEntity.getID());
+            const loadedOther2 = await (0, results_1.enforceAsyncResult)(testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityAsync('nullableField', TestEntity_1.default));
+            expect(loadedOther2).toBeNull();
+        });
+    });
+    describe('loadManyAssociatedEntitiesAsync', () => {
+        it('loads many associated entities referencing this entity', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const testOtherEntity1 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testEntity.getID())
+                .createAsync());
+            const testOtherEntity2 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testEntity.getID())
+                .createAsync());
+            const loaded = await (0, entityUtils_1.enforceResultsAsync)(testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadManyAssociatedEntitiesAsync(TestEntity_1.default, 'stringField'));
+            expect(loaded).toHaveLength(2);
+            expect(loaded.find((e) => e.getID() === testOtherEntity1.getID())).not.toBeUndefined();
+            expect(loaded.find((e) => e.getID() === testOtherEntity2.getID())).not.toBeUndefined();
+        });
+    });
+    describe('loadAssociatedEntityByFieldEqualingAsync', () => {
+        it('loads associated entity by field equaling', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testOtherEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testOtherEntity.getID())
+                .createAsync());
+            const loadedOtherResult = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityByFieldEqualingAsync('stringField', TestEntity_1.default, 'customIdField');
+            expect(loadedOtherResult?.enforceValue().getID()).toEqual(testOtherEntity.getID());
+        });
+        it('returns null when loading associated entities by field equaling a non existent association', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', (0, uuid_1.v4)())
+                .createAsync());
+            const loadedOtherResult = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityByFieldEqualingAsync('stringField', TestEntity_1.default, 'customIdField');
+            expect(loadedOtherResult).toBeNull();
+        });
+        it('returns null when load-by field is null', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', 'blah')
+                .createAsync());
+            const loadedOtherResult = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityByFieldEqualingAsync('nullableField', TestEntity_1.default, 'customIdField');
+            expect(loadedOtherResult).toBeNull();
+        });
+    });
+    describe('loadManyAssociatedEntitiesByFieldEqualingAsync', () => {
+        it('loads many associated entities by field equaling', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const testOtherEntity1 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testEntity.getID())
+                .createAsync());
+            const testOtherEntity2 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', testEntity.getID())
+                .createAsync());
+            const loaded = await (0, entityUtils_1.enforceResultsAsync)(testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadManyAssociatedEntitiesByFieldEqualingAsync('customIdField', TestEntity_1.default, 'stringField'));
+            expect(loaded).toHaveLength(2);
+            expect(loaded.find((e) => e.getID() === testOtherEntity1.getID())).not.toBeUndefined();
+            expect(loaded.find((e) => e.getID() === testOtherEntity2.getID())).not.toBeUndefined();
+        });
+        it('returns empty results when field being queried by is null', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const loaded = await (0, entityUtils_1.enforceResultsAsync)(testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadManyAssociatedEntitiesByFieldEqualingAsync('nullableField', TestEntity_1.default, 'stringField'));
+            expect(loaded).toHaveLength(0);
+        });
+    });
+    describe('loadAssociatedEntityThroughAsync', () => {
+        it('chain loads associated entities', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity4 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext).createAsync());
+            const testEntity3 = await (0, results_1.enforceAsyncResult)(TestEntity2_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('foreignKey', testEntity4.getID())
+                .createAsync());
+            const testEntity2 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('testIndexedField', testEntity3.getID())
+                .createAsync());
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity2_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('foreignKey', testEntity2.getID())
+                .createAsync());
+            const loaded2Result = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                },
+            ]);
+            expect(loaded2Result?.enforceValue().getID()).toEqual(testEntity2.getID());
+            const loaded3Result = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                },
+                {
+                    associatedEntityClass: TestEntity2_1.default,
+                    fieldIdentifyingAssociatedEntity: 'testIndexedField',
+                },
+            ]);
+            expect(loaded3Result?.enforceValue().getID()).toEqual(testEntity3.getID());
+            const loaded4Result = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                },
+                {
+                    associatedEntityClass: TestEntity2_1.default,
+                    fieldIdentifyingAssociatedEntity: 'testIndexedField',
+                },
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                },
+            ]);
+            expect(loaded4Result?.enforceValue().getID()).toEqual(testEntity4.getID());
+        });
+        it('fails when chain loading associated entity fails', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity2_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('foreignKey', (0, uuid_1.v4)())
+                .createAsync());
+            const loadResult = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                },
+            ]);
+            expect(loadResult?.ok).toBe(false);
+        });
+        it('supports chain loading by field equality', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const fieldValue = (0, uuid_1.v4)();
+            const testEntity2 = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('stringField', fieldValue)
+                .createAsync());
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity2_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('foreignKey', fieldValue)
+                .createAsync());
+            const loaded2Result = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                    associatedEntityLookupByField: 'stringField',
+                },
+            ]);
+            expect(loaded2Result?.enforceValue().getID()).toEqual(testEntity2.getID());
+        });
+        it('returns null when chain loading by field equality returns null', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity2_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('foreignKey', (0, uuid_1.v4)())
+                .createAsync());
+            const loaded2Result = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'foreignKey',
+                    associatedEntityLookupByField: 'stringField',
+                },
+            ]);
+            expect(loaded2Result).toBeNull();
+        });
+        it('returns null when chain loading by field is null', async () => {
+            const companionProvider = (0, createUnitTestEntityCompanionProvider_1.createUnitTestEntityCompanionProvider)();
+            const viewerContext = new TestViewerContext_1.default(companionProvider);
+            const testEntity = await (0, results_1.enforceAsyncResult)(TestEntity_1.default.creatorWithAuthorizationResults(viewerContext)
+                .setField('nullableField', null)
+                .createAsync());
+            const loadedResult = await testEntity
+                .associationLoaderWithAuthorizationResults()
+                .loadAssociatedEntityThroughAsync([
+                {
+                    associatedEntityClass: TestEntity_1.default,
+                    fieldIdentifyingAssociatedEntity: 'nullableField',
+                },
+            ]);
+            expect(loadedResult).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=AuthorizationResultBasedEntityAssociationLoader-test.js.map