@expo/entity 0.38.0 → 0.40.0

package/src/EnforcingEntityDeleter.ts

@@ -0,0 +1,44 @@
+import { enforceAsyncResult } from '@expo/results';
+
+import { AuthorizationResultBasedDeleteMutator } from './AuthorizationResultBasedEntityMutator';
+import EntityPrivacyPolicy from './EntityPrivacyPolicy';
+import ReadonlyEntity from './ReadonlyEntity';
+import ViewerContext from './ViewerContext';
+
+/**
+ * Enforcing entity deleter. All deletes
+ * through this deleter will throw if authorization is not successful.
+ */
+export default class EnforcingEntityDeleter<
+  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,
+> {
+  constructor(
+    private readonly entityDeleter: AuthorizationResultBasedDeleteMutator<
+      TFields,
+      TID,
+      TViewerContext,
+      TEntity,
+      TPrivacyPolicy,
+      TSelectedFields
+    >,
+  ) {}
+
+  /**
+   * Delete the entity after authorizing against delete privacy rules. The entity is invalidated in all caches.
+   * Throws when delete is not successful.
+   */
+  async deleteAsync(): Promise<void> {
+    await enforceAsyncResult(this.entityDeleter.deleteAsync());
+  }
+}

package/src/EnforcingEntityUpdater.ts

@@ -0,0 +1,55 @@
+import { enforceAsyncResult } from '@expo/results';
+
+import { AuthorizationResultBasedUpdateMutator } from './AuthorizationResultBasedEntityMutator';
+import EntityPrivacyPolicy from './EntityPrivacyPolicy';
+import ReadonlyEntity from './ReadonlyEntity';
+import ViewerContext from './ViewerContext';
+
+/**
+ * Enforcing entity updater. All updates
+ * through this updater will throw if authorization is not successful.
+ */
+export default class EnforcingEntityUpdater<
+  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,
+> {
+  constructor(
+    private readonly entityUpdater: AuthorizationResultBasedUpdateMutator<
+      TFields,
+      TID,
+      TViewerContext,
+      TEntity,
+      TPrivacyPolicy,
+      TSelectedFields
+    >,
+  ) {}
+
+  /**
+   * Set the value for entity field.
+   * @param fieldName - entity field being updated
+   * @param value - value for entity field
+   */
+  setField<K extends keyof Pick<TFields, TSelectedFields>>(fieldName: K, value: TFields[K]): this {
+    this.entityUpdater.setField(fieldName, value);
+    return this;
+  }
+
+  /**
+   * Commit the changes to the entity after authorizing against update privacy rules.
+   * Invalidates all caches for pre-update entity.
+   * @returns authorized updated entity, throws upon update failure
+   */
+  async updateAsync(): Promise<TEntity> {
+    return await enforceAsyncResult(this.entityUpdater.updateAsync());
+  }
+}

package/src/Entity.ts

@@ -1,9 +1,9 @@
-import { Result } from '@expo/results';
-
 import { EntityCompanionDefinition } from './EntityCompanionProvider';
-import { CreateMutator, UpdateMutator } from './EntityMutator';
+import EntityCreator from './EntityCreator';
+import EntityDeleter from './EntityDeleter';
 import EntityPrivacyPolicy from './EntityPrivacyPolicy';
 import { EntityQueryContext } from './EntityQueryContext';
+import EntityUpdater from './EntityUpdater';
 import ReadonlyEntity from './ReadonlyEntity';
 import ViewerContext from './ViewerContext';
 
@@ -65,11 +65,16 @@ export default abstract class Entity<
       .getViewerScopedEntityCompanionForClass(this)
       .getQueryContextProvider()
       .getQueryContext(),
-  ): CreateMutator<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields> {
-    return viewerContext
-      .getViewerScopedEntityCompanionForClass(this)
-      .getMutatorFactory()
-      .forCreate(queryContext);
+  ): EntityCreator<
+    TMFields,
+    TMID,
+    TMViewerContext,
+    TMViewerContext2,
+    TMEntity,
+    TMPrivacyPolicy,
+    TMSelectedFields
+  > {
+    return new EntityCreator(viewerContext, queryContext, this);
   }
 
   /**
@@ -106,20 +111,17 @@ export default abstract class Entity<
       .getViewerScopedEntityCompanionForClass(this)
       .getQueryContextProvider()
       .getQueryContext(),
-  ): UpdateMutator<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields> {
-    return existingEntity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(this)
-      .getMutatorFactory()
-      .forUpdate(existingEntity, queryContext);
+  ): EntityUpdater<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields> {
+    return new EntityUpdater(existingEntity, queryContext, this);
   }
 
   /**
-   * Delete an existing entity in given query context.
+   * Vend mutator for deleting an existing entity in given query context.
    * @param existingEntity - entity to delete
    * @param queryContext - query context in which to perform the delete
+   * @returns mutator for deleting existingEntity
    */
-  static deleteAsync<
+  static deleter<
     TMFields extends object,
     TMID extends NonNullable<TMFields[TMSelectedFields]>,
     TMViewerContext extends ViewerContext,
@@ -147,55 +149,8 @@ export default abstract class Entity<
       .getViewerScopedEntityCompanionForClass(this)
       .getQueryContextProvider()
       .getQueryContext(),
-  ): Promise<Result<void>> {
-    return existingEntity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(this)
-      .getMutatorFactory()
-      .forDelete(existingEntity, queryContext)
-      .deleteAsync();
-  }
-
-  /**
-   * Delete an existing entity in given query context, throwing if deletion is unsuccessful.
-   * @param existingEntity - entity to delete
-   * @param queryContext - query context in which to perform the delete
-   */
-  static enforceDeleteAsync<
-    TMFields extends object,
-    TMID extends NonNullable<TMFields[TMSelectedFields]>,
-    TMViewerContext extends ViewerContext,
-    TMEntity extends Entity<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
-    >,
-    existingEntity: TMEntity,
-    queryContext: EntityQueryContext = existingEntity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(this)
-      .getQueryContextProvider()
-      .getQueryContext(),
-  ): Promise<void> {
-    return existingEntity
-      .getViewerContext()
-      .getViewerScopedEntityCompanionForClass(this)
-      .getMutatorFactory()
-      .forDelete(existingEntity, queryContext)
-      .enforceDeleteAsync();
+  ): EntityDeleter<TMFields, TMID, TMViewerContext, TMEntity, TMPrivacyPolicy, TMSelectedFields> {
+    return new EntityDeleter(existingEntity, queryContext, this);
   }
 }