@expo/entity 0.38.0 → 0.40.0

package/src/EntityAssociationLoader.ts

@@ -1,7 +1,6 @@
-import { Result, result } from '@expo/results';
-
+import AuthorizationResultBasedEntityAssociationLoader from './AuthorizationResultBasedEntityAssociationLoader';
+import EnforcingEntityAssociationLoader from './EnforcingEntityAssociationLoader';
 import { IEntityClass } from './Entity';
-import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
 import ReadonlyEntity from './ReadonlyEntity';
 import ViewerContext from './ViewerContext';
@@ -18,507 +17,51 @@ export default class EntityAssociationLoader<
   TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>,
   TSelectedFields extends keyof TFields,
 > {
-  constructor(private readonly entity: TEntity) {}
-
-  /**
-   * Load an associated entity identified by a field value of this entity. In a relational database,
-   * the field in this entity is a foreign key to the ID of the associated entity.
-   * @param fieldIdentifyingAssociatedEntity - field of this entity containing the ID of the associated entity
-   * @param associatedEntityClass - class of the associated entity
-   * @param queryContext - query context in which to perform the load
-   */
-  async loadAssociatedEntityAsync<
-    TIdentifyingField extends keyof Pick<TFields, TSelectedFields>,
-    TAssociatedFields extends object,
-    TAssociatedID extends NonNullable<TAssociatedFields[TAssociatedSelectedFields]>,
-    TAssociatedEntity extends ReadonlyEntity<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedPrivacyPolicy extends EntityPrivacyPolicy<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedSelectedFields extends keyof TAssociatedFields = keyof TAssociatedFields,
-  >(
-    fieldIdentifyingAssociatedEntity: TIdentifyingField,
-    associatedEntityClass: IEntityClass<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedPrivacyPolicy,
-      TAssociatedSelectedFields
-    >,
-    queryContext: EntityQueryContext = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getQueryContextProvider()
-      .getQueryContext(),
-  ): Promise<
-    Result<null extends TFields[TIdentifyingField] ? TAssociatedEntity | null : TAssociatedEntity>
-  > {
-    const associatedEntityID = this.entity.getField(fieldIdentifyingAssociatedEntity);
-    if (!associatedEntityID) {
-      return result(null) as Result<
-        null extends TFields[TIdentifyingField] ? TAssociatedEntity | null : TAssociatedEntity
-      >;
-    }
-
-    const loader = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getLoaderFactory()
-      .forLoad(queryContext, { previousValue: null, cascadingDeleteCause: null });
-
-    return (await loader
-      .withAuthorizationResults()
-      .loadByIDAsync(associatedEntityID as unknown as TAssociatedID)) as Result<
-      null extends TFields[TIdentifyingField] ? TAssociatedEntity | null : TAssociatedEntity
-    >;
-  }
-
-  /**
-   * Load many entities associated with this entity, often referred to as entites belonging
-   * to this entity. In a relational database, the field in the foreign entity is a
-   * foreign key to the ID of this entity. Also commonly referred to as a has many relationship,
-   * where this entity has many associated entities.
-   * @param associatedEntityClass - class of the associated entities
-   * @param associatedEntityFieldContainingThisID - field of associated entity which contains the ID of this entity
-   * @param queryContext - query context in which to perform the load
-   */
-  async loadManyAssociatedEntitiesAsync<
-    TAssociatedFields extends object,
-    TAssociatedID extends NonNullable<TAssociatedFields[TAssociatedSelectedFields]>,
-    TAssociatedEntity extends ReadonlyEntity<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedPrivacyPolicy extends EntityPrivacyPolicy<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedSelectedFields extends keyof TAssociatedFields = keyof TAssociatedFields,
-  >(
-    associatedEntityClass: IEntityClass<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedPrivacyPolicy,
-      TAssociatedSelectedFields
-    >,
-    associatedEntityFieldContainingThisID: keyof Pick<TAssociatedFields, TAssociatedSelectedFields>,
-    queryContext: EntityQueryContext = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getQueryContextProvider()
-      .getQueryContext(),
-  ): Promise<readonly Result<TAssociatedEntity>[]> {
-    const thisID = this.entity.getID();
-    const loader = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getLoaderFactory()
-      .forLoad(queryContext, { previousValue: null, cascadingDeleteCause: null });
-    return await loader
-      .withAuthorizationResults()
-      .loadManyByFieldEqualingAsync(associatedEntityFieldContainingThisID, thisID as any);
-  }
-
-  /**
-   * Load an associated entity identified by a field value of this entity. In a relational database,
-   * the field in this entity is a foreign key to a unique field of the associated entity.
-   * @param fieldIdentifyingAssociatedEntity - field of this entity containing the value with which to look up associated entity
-   * @param associatedEntityClass - class of the associated entity
-   * @param associatedEntityLookupByField - field of associated entity with which to look up the associated entity
-   * @param queryContext - query context in which to perform the load
-   */
-  async loadAssociatedEntityByFieldEqualingAsync<
-    TAssociatedFields extends object,
-    TAssociatedID extends NonNullable<TAssociatedFields[TAssociatedSelectedFields]>,
-    TAssociatedEntity extends ReadonlyEntity<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedPrivacyPolicy extends EntityPrivacyPolicy<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedSelectedFields extends keyof TAssociatedFields = keyof TAssociatedFields,
-  >(
-    fieldIdentifyingAssociatedEntity: keyof Pick<TFields, TSelectedFields>,
-    associatedEntityClass: IEntityClass<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedPrivacyPolicy,
-      TAssociatedSelectedFields
-    >,
-    associatedEntityLookupByField: keyof Pick<TAssociatedFields, TAssociatedSelectedFields>,
-    queryContext: EntityQueryContext = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getQueryContextProvider()
-      .getQueryContext(),
-  ): Promise<Result<TAssociatedEntity> | null> {
-    const associatedFieldValue = this.entity.getField(fieldIdentifyingAssociatedEntity);
-    if (!associatedFieldValue) {
-      return null;
-    }
-    const loader = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getLoaderFactory()
-      .forLoad(queryContext, { previousValue: null, cascadingDeleteCause: null });
-    return await loader
-      .withAuthorizationResults()
-      .loadByFieldEqualingAsync(associatedEntityLookupByField, associatedFieldValue as any);
-  }
-
-  /**
-   * Load many associated entities identified by a field value of this entity. In a relational database,
-   * the field in this entity refers to a field of the associated entity.
-   * @param fieldIdentifyingAssociatedEntity - field of this entity containing the value with which to look up associated entities
-   * @param associatedEntityClass - class of the associated entities
-   * @param associatedEntityLookupByField - field of associated entities with which to look up the associated entities
-   * @param queryContext - query context in which to perform the load
-   */
-  async loadManyAssociatedEntitiesByFieldEqualingAsync<
-    TAssociatedFields extends object,
-    TAssociatedID extends NonNullable<TAssociatedFields[TAssociatedSelectedFields]>,
-    TAssociatedEntity extends ReadonlyEntity<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedPrivacyPolicy extends EntityPrivacyPolicy<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedSelectedFields
-    >,
-    TAssociatedSelectedFields extends keyof TAssociatedFields = keyof TAssociatedFields,
-  >(
-    fieldIdentifyingAssociatedEntity: keyof Pick<TFields, TSelectedFields>,
-    associatedEntityClass: IEntityClass<
-      TAssociatedFields,
-      TAssociatedID,
-      TViewerContext,
-      TAssociatedEntity,
-      TAssociatedPrivacyPolicy,
-      TAssociatedSelectedFields
-    >,
-    associatedEntityLookupByField: keyof Pick<TAssociatedFields, TAssociatedSelectedFields>,
-    queryContext: EntityQueryContext = this.entity
+  constructor(
+    private readonly entity: TEntity,
+    private readonly queryContext: EntityQueryContext = entity
       .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
+      .getViewerScopedEntityCompanionForClass(
+        entity.constructor as IEntityClass<
+          TFields,
+          TID,
+          TViewerContext,
+          TEntity,
+          any,
+          TSelectedFields
+        >,
+      )
       .getQueryContextProvider()
       .getQueryContext(),
-  ): Promise<readonly Result<TAssociatedEntity>[]> {
-    const associatedFieldValue = this.entity.getField(fieldIdentifyingAssociatedEntity);
-    if (!associatedFieldValue) {
-      return [];
-    }
-
-    const loader = this.entity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(associatedEntityClass)
-      .getLoaderFactory()
-      .forLoad(queryContext, { previousValue: null, cascadingDeleteCause: null });
-    return await loader
-      .withAuthorizationResults()
-      .loadManyByFieldEqualingAsync(associatedEntityLookupByField, associatedFieldValue as any);
-  }
-
-  /**
-   * Load an associated entity by folding a sequence of EntityLoadThroughDirective. At each
-   * fold step, load an associated entity identified by a field value of the current fold value.
-   * @param loadDirectives - associated entity load directives instructing each step of the fold
-   * @param queryContext - query context in which to perform the loads
-   */
-  async loadAssociatedEntityThroughAsync<
-    TFields2 extends object,
-    TID2 extends NonNullable<TFields2[TSelectedFields2]>,
-    TEntity2 extends ReadonlyEntity<TFields2, TID2, TViewerContext, TSelectedFields2>,
-    TPrivacyPolicy2 extends EntityPrivacyPolicy<
-      TFields2,
-      TID2,
-      TViewerContext,
-      TEntity2,
-      TSelectedFields2
-    >,
-    TSelectedFields2 extends keyof TFields2 = keyof TFields2,
-  >(
-    loadDirectives: [
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields,
-        TFields2,
-        TID2,
-        TEntity2,
-        TPrivacyPolicy2,
-        TSelectedFields,
-        TSelectedFields2
-      >,
-    ],
-    queryContext?: EntityQueryContext,
-  ): Promise<Result<TEntity2> | null>;
-
-  /**
-   * Load an associated entity by folding a sequence of EntityLoadThroughDirective. At each
-   * fold step, load an associated entity identified by a field value of the current fold value.
-   * @param loadDirectives - associated entity load directives instructing each step of the fold
-   * @param queryContext - query context in which to perform the loads
-   */
-  async loadAssociatedEntityThroughAsync<
-    TFields2 extends object,
-    TID2 extends NonNullable<TFields2[TSelectedFields2]>,
-    TEntity2 extends ReadonlyEntity<TFields2, TID2, TViewerContext, TSelectedFields2>,
-    TPrivacyPolicy2 extends EntityPrivacyPolicy<
-      TFields2,
-      TID2,
-      TViewerContext,
-      TEntity2,
-      TSelectedFields2
-    >,
-    TFields3 extends object,
-    TID3 extends NonNullable<TFields3[TSelectedFields3]>,
-    TEntity3 extends ReadonlyEntity<TFields3, TID3, TViewerContext, TSelectedFields3>,
-    TPrivacyPolicy3 extends EntityPrivacyPolicy<
-      TFields3,
-      TID3,
-      TViewerContext,
-      TEntity3,
-      TSelectedFields3
-    >,
-    TSelectedFields2 extends keyof TFields2 = keyof TFields2,
-    TSelectedFields3 extends keyof TFields3 = keyof TFields3,
-  >(
-    loadDirectives: [
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields,
-        TFields2,
-        TID2,
-        TEntity2,
-        TPrivacyPolicy2,
-        TSelectedFields,
-        TSelectedFields2
-      >,
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields2,
-        TFields3,
-        TID3,
-        TEntity3,
-        TPrivacyPolicy3,
-        TSelectedFields2,
-        TSelectedFields3
-      >,
-    ],
-    queryContext?: EntityQueryContext,
-  ): Promise<Result<TEntity3> | null>;
+  ) {}
 
   /**
-   * Load an associated entity by folding a sequence of EntityLoadThroughDirective. At each
-   * fold step, load an associated entity identified by a field value of the current fold value.
-   * @param loadDirectives - associated entity load directives instructing each step of the fold
-   * @param queryContext - query context in which to perform the loads
+   * Enforcing entity association 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.
    */
-  async loadAssociatedEntityThroughAsync<
-    TFields2 extends object,
-    TID2 extends NonNullable<TFields2[TSelectedFields2]>,
-    TEntity2 extends ReadonlyEntity<TFields2, TID2, TViewerContext, TSelectedFields2>,
-    TPrivacyPolicy2 extends EntityPrivacyPolicy<
-      TFields2,
-      TID2,
-      TViewerContext,
-      TEntity2,
-      TSelectedFields2
-    >,
-    TFields3 extends object,
-    TID3 extends NonNullable<TFields3[TSelectedFields3]>,
-    TEntity3 extends ReadonlyEntity<TFields3, TID3, TViewerContext, TSelectedFields3>,
-    TPrivacyPolicy3 extends EntityPrivacyPolicy<
-      TFields3,
-      TID3,
-      TViewerContext,
-      TEntity3,
-      TSelectedFields3
-    >,
-    TFields4 extends object,
-    TID4 extends NonNullable<TFields4[TSelectedFields4]>,
-    TEntity4 extends ReadonlyEntity<TFields4, TID4, TViewerContext, TSelectedFields4>,
-    TPrivacyPolicy4 extends EntityPrivacyPolicy<
-      TFields4,
-      TID4,
-      TViewerContext,
-      TEntity4,
-      TSelectedFields4
-    >,
-    TSelectedFields2 extends keyof TFields2 = keyof TFields2,
-    TSelectedFields3 extends keyof TFields3 = keyof TFields3,
-    TSelectedFields4 extends keyof TFields4 = keyof TFields4,
-  >(
-    loadDirectives: [
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields,
-        TFields2,
-        TID2,
-        TEntity2,
-        TPrivacyPolicy2,
-        TSelectedFields,
-        TSelectedFields2
-      >,
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields2,
-        TFields3,
-        TID3,
-        TEntity3,
-        TPrivacyPolicy3,
-        TSelectedFields2,
-        TSelectedFields3
-      >,
-      EntityLoadThroughDirective<
-        TViewerContext,
-        TFields3,
-        TFields4,
-        TID4,
-        TEntity4,
-        TPrivacyPolicy4,
-        TSelectedFields3,
-        TSelectedFields4
-      >,
-    ],
-    queryContext?: EntityQueryContext,
-  ): Promise<Result<TEntity4> | null>;
-
-  /**
-   * Load an associated entity by folding a sequence of EntityLoadThroughDirective. At each
-   * fold step, load an associated entity identified by a field value of the current fold value.
-   * @param loadDirectives - associated entity load directives instructing each step of the fold
-   * @param queryContext - query context in which to perform the loads
-   */
-  async loadAssociatedEntityThroughAsync(
-    loadDirectives: EntityLoadThroughDirective<TViewerContext, any, any, any, any, any, any, any>[],
-    queryContext?: EntityQueryContext,
-  ): Promise<Result<ReadonlyEntity<any, any, any, any>> | null>;
-
-  async loadAssociatedEntityThroughAsync(
-    loadDirectives: EntityLoadThroughDirective<TViewerContext, any, any, any, any, any, any, any>[],
-    queryContext?: EntityQueryContext,
-  ): Promise<Result<ReadonlyEntity<any, any, any, any>> | null> {
-    let currentEntity: ReadonlyEntity<any, any, any, any> = this.entity;
-    for (const loadDirective of loadDirectives) {
-      const {
-        associatedEntityClass,
-        fieldIdentifyingAssociatedEntity,
-        associatedEntityLookupByField,
-      } = loadDirective;
-      let associatedEntityResult: Result<ReadonlyEntity<any, any, any, any>> | null;
-      if (associatedEntityLookupByField) {
-        associatedEntityResult = await currentEntity
-          .associationLoader()
-          .loadAssociatedEntityByFieldEqualingAsync(
-            fieldIdentifyingAssociatedEntity,
-            associatedEntityClass,
-            associatedEntityLookupByField,
-            queryContext,
-          );
-      } else {
-        const associatedEntityResultLocal = await currentEntity
-          .associationLoader()
-          .loadAssociatedEntityAsync(
-            fieldIdentifyingAssociatedEntity,
-            associatedEntityClass,
-            queryContext,
-          );
-
-        if (associatedEntityResultLocal.ok && associatedEntityResultLocal.value === null) {
-          associatedEntityResult = null;
-        } else {
-          associatedEntityResult = associatedEntityResultLocal;
-        }
-      }
-
-      if (!associatedEntityResult) {
-        return null;
-      }
-
-      if (!associatedEntityResult.ok) {
-        return result(associatedEntityResult.reason);
-      }
-      currentEntity = associatedEntityResult.value;
-    }
-    return result(currentEntity);
+  enforcing(): EnforcingEntityAssociationLoader<
+    TFields,
+    TID,
+    TViewerContext,
+    TEntity,
+    TSelectedFields
+  > {
+    return new EnforcingEntityAssociationLoader(this.withAuthorizationResults());
   }
-}
 
-/**
- * Instruction for each step of a load-associated-through method.
- */
-export interface EntityLoadThroughDirective<
-  TViewerContext extends ViewerContext,
-  TFields,
-  TAssociatedFields extends object,
-  TAssociatedID extends NonNullable<TAssociatedFields[TAssociatedSelectedFields]>,
-  TAssociatedEntity extends ReadonlyEntity<
-    TAssociatedFields,
-    TAssociatedID,
-    TViewerContext,
-    TAssociatedSelectedFields
-  >,
-  TAssociatedPrivacyPolicy extends EntityPrivacyPolicy<
-    TAssociatedFields,
-    TAssociatedID,
-    TViewerContext,
-    TAssociatedEntity,
-    TAssociatedSelectedFields
-  >,
-  TSelectedFields extends keyof TFields = keyof TFields,
-  TAssociatedSelectedFields extends keyof TAssociatedFields = keyof TAssociatedFields,
-> {
   /**
-   * Class of entity to load at this step.
+   * Authorization-result-based entity loader. All loads through this
+   * loader are results, where an unsuccessful result
+   * means an authorization error or entity construction error occurred. Other errors are thrown.
    */
-  associatedEntityClass: IEntityClass<
-    TAssociatedFields,
-    TAssociatedID,
+  withAuthorizationResults(): AuthorizationResultBasedEntityAssociationLoader<
+    TFields,
+    TID,
     TViewerContext,
-    TAssociatedEntity,
-    TAssociatedPrivacyPolicy,
-    TAssociatedSelectedFields
-  >;
-
-  /**
-   * Field of the current entity with which to load an instance of associatedEntityClass.
-   */
-  fieldIdentifyingAssociatedEntity: keyof Pick<TFields, TSelectedFields>;
-
-  /**
-   * Field by which to load the instance of associatedEntityClass. If not provided, the
-   * associatedEntityClass instance is fetched by its ID.
-   */
-  associatedEntityLookupByField?: keyof Pick<TAssociatedFields, TAssociatedSelectedFields>;
+    TEntity,
+    TSelectedFields
+  > {
+    return new AuthorizationResultBasedEntityAssociationLoader(this.entity, this.queryContext);
+  }
 }

package/src/EntityCompanionProvider.ts

@@ -143,11 +143,14 @@ export default class EntityCompanionProvider {
    */
   constructor(
     public readonly metricsAdapter: IEntityMetricsAdapter,
-    private databaseAdapterFlavors: ReadonlyMap<
+    private readonly databaseAdapterFlavors: ReadonlyMap<
       DatabaseAdapterFlavor,
       DatabaseAdapterFlavorDefinition
     >,
-    private cacheAdapterFlavors: ReadonlyMap<CacheAdapterFlavor, CacheAdapterFlavorDefinition>,
+    private readonly cacheAdapterFlavors: ReadonlyMap<
+      CacheAdapterFlavor,
+      CacheAdapterFlavorDefinition
+    >,
     readonly globalMutationTriggers: EntityMutationTriggerConfiguration<
       any,
       any,

package/src/EntityCreator.ts

@@ -0,0 +1,73 @@
+import { AuthorizationResultBasedCreateMutator } from './AuthorizationResultBasedEntityMutator';
+import EnforcingEntityCreator from './EnforcingEntityCreator';
+import { IEntityClass } from './Entity';
+import EntityPrivacyPolicy from './EntityPrivacyPolicy';
+import { EntityQueryContext } from './EntityQueryContext';
+import ReadonlyEntity from './ReadonlyEntity';
+import ViewerContext from './ViewerContext';
+
+/**
+ * The primary interface for creating entities.
+ */
+export default class EntityCreator<
+  TFields extends object,
+  TID extends NonNullable<TFields[TSelectedFields]>,
+  TViewerContext extends ViewerContext,
+  TViewerContext2 extends TViewerContext,
+  TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>,
+  TPrivacyPolicy extends EntityPrivacyPolicy<
+    TFields,
+    TID,
+    TViewerContext,
+    TEntity,
+    TSelectedFields
+  >,
+  TSelectedFields extends keyof TFields,
+> {
+  constructor(
+    private readonly viewerContext: TViewerContext2,
+    private readonly queryContext: EntityQueryContext,
+    private readonly entityClass: IEntityClass<
+      TFields,
+      TID,
+      TViewerContext,
+      TEntity,
+      TPrivacyPolicy,
+      TSelectedFields
+    >,
+  ) {}
+
+  /**
+   * Enforcing entity creator. All creates through this creator are
+   * guaranteed to be successful and will throw otherwise.
+   */
+  enforcing(): EnforcingEntityCreator<
+    TFields,
+    TID,
+    TViewerContext,
+    TEntity,
+    TPrivacyPolicy,
+    TSelectedFields
+  > {
+    return new EnforcingEntityCreator(this.withAuthorizationResults());
+  }
+
+  /**
+   * Authorization-result-based entity creator. All creates through this
+   * creator are results, where an unsuccessful result means an authorization
+   * error or entity construction error occurred. Other errors are thrown.
+   */
+  withAuthorizationResults(): AuthorizationResultBasedCreateMutator<
+    TFields,
+    TID,
+    TViewerContext,
+    TEntity,
+    TPrivacyPolicy,
+    TSelectedFields
+  > {
+    return this.viewerContext
+      .getViewerScopedEntityCompanionForClass(this.entityClass)
+      .getMutatorFactory()
+      .forCreate(this.queryContext);
+  }
+}