@expo/entity 0.44.0 → 0.45.0

package/build/AuthorizationResultBasedEntityLoader.js

@@ -122,7 +122,11 @@ class AuthorizationResultBasedEntityLoader {
         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)));
+                (0, results_1.result)(new EntityNotFoundError_1.default({
+                    entityClass: this.entityClass,
+                    fieldName: this.entityConfiguration.idField,
+                    fieldValue: id,
+                })));
         });
     }
     /**

package/build/AuthorizationResultBasedEntityLoader.js.map

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

package/build/errors/EntityNotFoundError.d.ts

@@ -3,8 +3,15 @@ import { IEntityClass } from '../Entity';
 import EntityPrivacyPolicy from '../EntityPrivacyPolicy';
 import ReadonlyEntity from '../ReadonlyEntity';
 import ViewerContext from '../ViewerContext';
+type EntityNotFoundOptions<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, N extends keyof TFields, TSelectedFields extends keyof TFields = keyof TFields> = {
+    entityClass: IEntityClass<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>;
+    fieldName: N;
+    fieldValue: TFields[N];
+};
 export default class EntityNotFoundError<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, N extends keyof TFields, TSelectedFields extends keyof TFields = keyof TFields> extends EntityError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_NOT_FOUND;
-    constructor(entityClass: IEntityClass<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, fieldName: N, fieldValue: TFields[N]);
+    constructor(message: string);
+    constructor(options: EntityNotFoundOptions<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, N, TSelectedFields>);
 }
+export {};

package/build/errors/EntityNotFoundError.js

@@ -37,8 +37,13 @@ const EntityError_1 = __importStar(require("./EntityError"));
 class EntityNotFoundError extends EntityError_1.default {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_NOT_FOUND;
-    constructor(entityClass, fieldName, fieldValue) {
-        super(`Entity not found: ${entityClass.name} (${String(fieldName)} = ${fieldValue})`);
+    constructor(messageOrOptions) {
+        if (typeof messageOrOptions === 'string') {
+            super(messageOrOptions);
+        }
+        else {
+            super(`Entity not found: ${messageOrOptions.entityClass.name} (${String(messageOrOptions.fieldName)} = ${messageOrOptions.fieldValue})`);
+        }
     }
 }
 exports.default = EntityNotFoundError;

package/build/errors/EntityNotFoundError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityNotFoundError.js","sourceRoot":"","sources":["../../src/errors/EntityNotFoundError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA+E;AAM/E,MAAqB,mBAcnB,SAAQ,qBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,oBAAoB,CAAC;IAE5D,YACE,WAOC,EACD,SAAY,EACZ,UAAsB;QAEtB,KAAK,CAAC,qBAAqB,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;IACxF,CAAC;CACF;AAhCD,sCAgCC"}
+{"version":3,"file":"EntityNotFoundError.js","sourceRoot":"","sources":["../../src/errors/EntityNotFoundError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA+E;AAiC/E,MAAqB,mBAcnB,SAAQ,qBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,oBAAoB,CAAC;IAe5D,YACE,gBAUK;QAEL,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;YACzC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CACH,qBAAqB,gBAAgB,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,MAAM,gBAAgB,CAAC,UAAU,GAAG,CAClI,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApDD,sCAoDC"}

package/build/index.d.ts

@@ -83,6 +83,7 @@ export { default as AlwaysDenyPrivacyPolicyRule } from './rules/AlwaysDenyPrivac
 export { default as AlwaysSkipPrivacyPolicyRule } from './rules/AlwaysSkipPrivacyPolicyRule';
 export { default as PrivacyPolicyRule } from './rules/PrivacyPolicyRule';
 export * from './rules/PrivacyPolicyRule';
+export * from './utils/EntityCreationUtils';
 export * from './utils/EntityPrivacyUtils';
 export * from './utils/mergeEntityMutationTriggerConfigurations';
 export * from './utils/collections/maps';

package/build/index.js

@@ -146,6 +146,7 @@ Object.defineProperty(exports, "AlwaysSkipPrivacyPolicyRule", { enumerable: true
 var PrivacyPolicyRule_1 = require("./rules/PrivacyPolicyRule");
 Object.defineProperty(exports, "PrivacyPolicyRule", { enumerable: true, get: function () { return __importDefault(PrivacyPolicyRule_1).default; } });
 __exportStar(require("./rules/PrivacyPolicyRule"), exports);
+__exportStar(require("./utils/EntityCreationUtils"), exports);
 __exportStar(require("./utils/EntityPrivacyUtils"), exports);
 __exportStar(require("./utils/mergeEntityMutationTriggerConfigurations"), exports);
 __exportStar(require("./utils/collections/maps"), exports);

package/build/index.js.map

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

package/build/tsconfig.build.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/authorizationresultbasedentityassociationloader.ts","../src/authorizationresultbasedentityloader.ts","../src/authorizationresultbasedentitymutator.ts","../src/composedentitycacheadapter.ts","../src/composedsecondaryentitycache.ts","../src/enforcingentityassociationloader.ts","../src/enforcingentitycreator.ts","../src/enforcingentitydeleter.ts","../src/enforcingentityloader.ts","../src/enforcingentityupdater.ts","../src/entity.ts","../src/entityassociationloader.ts","../src/entitycompanion.ts","../src/entitycompanionprovider.ts","../src/entityconfiguration.ts","../src/entitycreator.ts","../src/entitydatabaseadapter.ts","../src/entitydeleter.ts","../src/entityfielddefinition.ts","../src/entityfields.ts","../src/entityloader.ts","../src/entityloaderfactory.ts","../src/entityloaderutils.ts","../src/entitymutationinfo.ts","../src/entitymutationtriggerconfiguration.ts","../src/entitymutationvalidator.ts","../src/entitymutatorfactory.ts","../src/entityprivacypolicy.ts","../src/entityquerycontext.ts","../src/entityquerycontextprovider.ts","../src/entitysecondarycacheloader.ts","../src/entityupdater.ts","../src/genericentitycacheadapter.ts","../src/genericsecondaryentitycache.ts","../src/ientitycacheadapter.ts","../src/ientitycacheadapterprovider.ts","../src/ientitydatabaseadapterprovider.ts","../src/ientitygenericcacher.ts","../src/readonlyentity.ts","../src/viewercontext.ts","../src/viewerscopedentitycompanion.ts","../src/viewerscopedentitycompanionprovider.ts","../src/viewerscopedentityloaderfactory.ts","../src/viewerscopedentitymutatorfactory.ts","../src/entityutils.ts","../src/index.ts","../src/errors/entitycacheadaptererror.ts","../src/errors/entitydatabaseadaptererror.ts","../src/errors/entityerror.ts","../src/errors/entityinvalidfieldvalueerror.ts","../src/errors/entitynotauthorizederror.ts","../src/errors/entitynotfounderror.ts","../src/internal/compositefieldholder.ts","../src/internal/compositefieldvaluemap.ts","../src/internal/entitydatamanager.ts","../src/internal/entityfieldtransformationutils.ts","../src/internal/entityloadinterfaces.ts","../src/internal/entitytabledatacoordinator.ts","../src/internal/readthroughentitycache.ts","../src/internal/singlefieldholder.ts","../src/metrics/entitymetricsutils.ts","../src/metrics/ientitymetricsadapter.ts","../src/metrics/noopentitymetricsadapter.ts","../src/rules/alwaysallowprivacypolicyrule.ts","../src/rules/alwaysdenyprivacypolicyrule.ts","../src/rules/alwaysskipprivacypolicyrule.ts","../src/rules/privacypolicyrule.ts","../src/utils/entityprivacyutils.ts","../src/utils/mergeentitymutationtriggerconfigurations.ts","../src/utils/collections/serializablekeymap.ts","../src/utils/collections/maps.ts","../src/utils/collections/sets.ts"],"version":"5.8.3"}
+{"root":["../src/authorizationresultbasedentityassociationloader.ts","../src/authorizationresultbasedentityloader.ts","../src/authorizationresultbasedentitymutator.ts","../src/composedentitycacheadapter.ts","../src/composedsecondaryentitycache.ts","../src/enforcingentityassociationloader.ts","../src/enforcingentitycreator.ts","../src/enforcingentitydeleter.ts","../src/enforcingentityloader.ts","../src/enforcingentityupdater.ts","../src/entity.ts","../src/entityassociationloader.ts","../src/entitycompanion.ts","../src/entitycompanionprovider.ts","../src/entityconfiguration.ts","../src/entitycreator.ts","../src/entitydatabaseadapter.ts","../src/entitydeleter.ts","../src/entityfielddefinition.ts","../src/entityfields.ts","../src/entityloader.ts","../src/entityloaderfactory.ts","../src/entityloaderutils.ts","../src/entitymutationinfo.ts","../src/entitymutationtriggerconfiguration.ts","../src/entitymutationvalidator.ts","../src/entitymutatorfactory.ts","../src/entityprivacypolicy.ts","../src/entityquerycontext.ts","../src/entityquerycontextprovider.ts","../src/entitysecondarycacheloader.ts","../src/entityupdater.ts","../src/genericentitycacheadapter.ts","../src/genericsecondaryentitycache.ts","../src/ientitycacheadapter.ts","../src/ientitycacheadapterprovider.ts","../src/ientitydatabaseadapterprovider.ts","../src/ientitygenericcacher.ts","../src/readonlyentity.ts","../src/viewercontext.ts","../src/viewerscopedentitycompanion.ts","../src/viewerscopedentitycompanionprovider.ts","../src/viewerscopedentityloaderfactory.ts","../src/viewerscopedentitymutatorfactory.ts","../src/entityutils.ts","../src/index.ts","../src/errors/entitycacheadaptererror.ts","../src/errors/entitydatabaseadaptererror.ts","../src/errors/entityerror.ts","../src/errors/entityinvalidfieldvalueerror.ts","../src/errors/entitynotauthorizederror.ts","../src/errors/entitynotfounderror.ts","../src/internal/compositefieldholder.ts","../src/internal/compositefieldvaluemap.ts","../src/internal/entitydatamanager.ts","../src/internal/entityfieldtransformationutils.ts","../src/internal/entityloadinterfaces.ts","../src/internal/entitytabledatacoordinator.ts","../src/internal/readthroughentitycache.ts","../src/internal/singlefieldholder.ts","../src/metrics/entitymetricsutils.ts","../src/metrics/ientitymetricsadapter.ts","../src/metrics/noopentitymetricsadapter.ts","../src/rules/alwaysallowprivacypolicyrule.ts","../src/rules/alwaysdenyprivacypolicyrule.ts","../src/rules/alwaysskipprivacypolicyrule.ts","../src/rules/privacypolicyrule.ts","../src/utils/entitycreationutils.ts","../src/utils/entityprivacyutils.ts","../src/utils/mergeentitymutationtriggerconfigurations.ts","../src/utils/collections/serializablekeymap.ts","../src/utils/collections/maps.ts","../src/utils/collections/sets.ts"],"version":"5.8.3"}

package/build/utils/EntityCreationUtils.d.ts

@@ -0,0 +1,14 @@
+import { IEntityClass } from '../Entity';
+import EntityPrivacyPolicy from '../EntityPrivacyPolicy';
+import { EntityTransactionalQueryContext } from '../EntityQueryContext';
+import ReadonlyEntity from '../ReadonlyEntity';
+import ViewerContext from '../ViewerContext';
+/**
+ * Create an entity if it doesn't exist, or get the existing entity if it does.
+ */
+export declare function createOrGetExistingAsync<TFields extends object, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, TGetArgs, TCreateArgs, TSelectedFields extends keyof TFields = keyof TFields>(viewerContext: TViewerContext, entityClass: IEntityClass<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, getAsync: (viewerContext: TViewerContext, getArgs: TGetArgs, queryContext?: EntityTransactionalQueryContext) => Promise<TEntity | null>, getArgs: TGetArgs, createAsync: (viewerContext: TViewerContext, createArgs: TCreateArgs, queryContext?: EntityTransactionalQueryContext) => Promise<TEntity>, createArgs: TCreateArgs, queryContext?: EntityTransactionalQueryContext): Promise<TEntity>;
+/**
+ * Account for concurrent requests that may try to create the same entity.
+ * Return the existing entity if we get a Unique Constraint error.
+ */
+export declare function createWithUniqueConstraintRecoveryAsync<TFields extends object, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TPrivacyPolicy extends EntityPrivacyPolicy<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, TGetArgs, TCreateArgs, TSelectedFields extends keyof TFields = keyof TFields>(viewerContext: TViewerContext, entityClass: IEntityClass<TFields, TIDField, TViewerContext, TEntity, TPrivacyPolicy, TSelectedFields>, getAsync: (viewerContext: TViewerContext, getArgs: TGetArgs, queryContext?: EntityTransactionalQueryContext) => Promise<TEntity | null>, getArgs: TGetArgs, createAsync: (viewerContext: TViewerContext, createArgs: TCreateArgs, queryContext?: EntityTransactionalQueryContext) => Promise<TEntity>, createArgs: TCreateArgs, queryContext?: EntityTransactionalQueryContext): Promise<TEntity>;

package/build/utils/EntityCreationUtils.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOrGetExistingAsync = createOrGetExistingAsync;
+exports.createWithUniqueConstraintRecoveryAsync = createWithUniqueConstraintRecoveryAsync;
+const EntityDatabaseAdapterError_1 = require("../errors/EntityDatabaseAdapterError");
+const EntityNotFoundError_1 = __importDefault(require("../errors/EntityNotFoundError"));
+/**
+ * Create an entity if it doesn't exist, or get the existing entity if it does.
+ */
+async function createOrGetExistingAsync(viewerContext, entityClass, getAsync, getArgs, createAsync, createArgs, queryContext) {
+    if (!queryContext) {
+        const maybeEntity = await getAsync(viewerContext, getArgs);
+        if (maybeEntity) {
+            return maybeEntity;
+        }
+    }
+    else {
+        // This is done in a nested transaction since entity may negatively cache load results per-transaction (when configured).
+        // Without it, it would
+        // 1. load the entity in the current query context, negatively cache it
+        // 2. then try to create it in the nested transaction, which may fail due to a unique constraint error
+        // 3. then try to load the entity again in the current query context, which would return null due to negative cache
+        const maybeEntity = await queryContext.runInNestedTransactionAsync((nestedQueryContext) => getAsync(viewerContext, getArgs, nestedQueryContext));
+        if (maybeEntity) {
+            return maybeEntity;
+        }
+    }
+    return await createWithUniqueConstraintRecoveryAsync(viewerContext, entityClass, getAsync, getArgs, createAsync, createArgs, queryContext);
+}
+/**
+ * Account for concurrent requests that may try to create the same entity.
+ * Return the existing entity if we get a Unique Constraint error.
+ */
+async function createWithUniqueConstraintRecoveryAsync(viewerContext, entityClass, getAsync, getArgs, createAsync, createArgs, queryContext) {
+    try {
+        if (!queryContext) {
+            return await createAsync(viewerContext, createArgs);
+        }
+        return await queryContext.runInNestedTransactionAsync((nestedQueryContext) => createAsync(viewerContext, createArgs, nestedQueryContext));
+    }
+    catch (e) {
+        if (e instanceof EntityDatabaseAdapterError_1.EntityDatabaseAdapterUniqueConstraintError) {
+            const entity = await getAsync(viewerContext, getArgs, queryContext);
+            if (!entity) {
+                throw new EntityNotFoundError_1.default(`Expected entity to exist after unique constraint error: ${entityClass.name}`);
+            }
+            return entity;
+        }
+        else {
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=EntityCreationUtils.js.map

package/build/utils/EntityCreationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityCreationUtils.js","sourceRoot":"","sources":["../../src/utils/EntityCreationUtils.ts"],"names":[],"mappings":";;;;;AAWA,4DAkEC;AAMD,0FA2DC;AAzID,qFAAkG;AAClG,wFAAgE;AAEhE;;GAEG;AACI,KAAK,UAAU,wBAAwB,CAgB5C,aAA6B,EAC7B,WAOC,EACD,QAI4B,EAC5B,OAAiB,EACjB,WAIqB,EACrB,UAAuB,EACvB,YAA8C;IAE9C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,yHAAyH;QACzH,uBAAuB;QACvB,uEAAuE;QACvE,sGAAsG;QACtG,mHAAmH;QACnH,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,2BAA2B,CAAC,CAAC,kBAAkB,EAAE,EAAE,CACxF,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE,kBAAkB,CAAC,CACrD,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,uCAAuC,CAClD,aAAa,EACb,WAAW,EACX,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAU,EACV,YAAY,CACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,uCAAuC,CAgB3D,aAA6B,EAC7B,WAOC,EACD,QAI4B,EAC5B,OAAiB,EACjB,WAIqB,EACrB,UAAuB,EACvB,YAA8C;IAE9C,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,MAAM,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,MAAM,YAAY,CAAC,2BAA2B,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAC3E,WAAW,CAAC,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAC3D,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,uEAA0C,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,6BAAmB,CAC3B,2DAA2D,WAAW,CAAC,IAAI,EAAE,CAC9E,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/entity",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "A privacy-first data model",
   "files": [
     "build",
@@ -53,5 +53,5 @@
     "uuid": "^8.3.0",
     "uuidv7": "^1.0.0"
   },
-  "gitHead": "b9b09933e5a5b02037aa4688c5969705a29995c0"
+  "gitHead": "fe2d246f87adc98a13cc7c1ae57f3628769560c9"
 }

package/src/AuthorizationResultBasedEntityLoader.ts

@@ -237,7 +237,13 @@ export default class AuthorizationResultBasedEntityLoader<
       const entityResult = entityResultsForId[0];
       return (
         entityResult ??
-        result(new EntityNotFoundError(this.entityClass, this.entityConfiguration.idField, id))
+        result(
+          new EntityNotFoundError({
+            entityClass: this.entityClass,
+            fieldName: this.entityConfiguration.idField,
+            fieldValue: id,
+          }),
+        )
       );
     });
   }

package/src/errors/EntityNotFoundError.ts

@@ -4,6 +4,33 @@ import EntityPrivacyPolicy from '../EntityPrivacyPolicy';
 import ReadonlyEntity from '../ReadonlyEntity';
 import ViewerContext from '../ViewerContext';
 
+type EntityNotFoundOptions<
+  TFields extends Record<string, any>,
+  TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,
+  TViewerContext extends ViewerContext,
+  TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>,
+  TPrivacyPolicy extends EntityPrivacyPolicy<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TSelectedFields
+  >,
+  N extends keyof TFields,
+  TSelectedFields extends keyof TFields = keyof TFields,
+> = {
+  entityClass: IEntityClass<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TPrivacyPolicy,
+    TSelectedFields
+  >;
+  fieldName: N;
+  fieldValue: TFields[N];
+};
+
 export default class EntityNotFoundError<
   TFields extends Record<string, any>,
   TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,
@@ -22,18 +49,38 @@ export default class EntityNotFoundError<
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_NOT_FOUND;
 
+  constructor(message: string);
   constructor(
-    entityClass: IEntityClass<
+    options: EntityNotFoundOptions<
       TFields,
       TIDField,
       TViewerContext,
       TEntity,
       TPrivacyPolicy,
+      N,
       TSelectedFields
     >,
-    fieldName: N,
-    fieldValue: TFields[N],
+  );
+
+  constructor(
+    messageOrOptions:
+      | string
+      | EntityNotFoundOptions<
+          TFields,
+          TIDField,
+          TViewerContext,
+          TEntity,
+          TPrivacyPolicy,
+          N,
+          TSelectedFields
+        >,
   ) {
-    super(`Entity not found: ${entityClass.name} (${String(fieldName)} = ${fieldValue})`);
+    if (typeof messageOrOptions === 'string') {
+      super(messageOrOptions);
+    } else {
+      super(
+        `Entity not found: ${messageOrOptions.entityClass.name} (${String(messageOrOptions.fieldName)} = ${messageOrOptions.fieldValue})`,
+      );
+    }
   }
 }

package/src/errors/__tests__/EntityDatabaseAdapterError-test.ts

@@ -0,0 +1,26 @@
+import EntityDatabaseAdapterError, {
+  EntityDatabaseAdapterTransientError,
+  EntityDatabaseAdapterUnknownError,
+  EntityDatabaseAdapterCheckConstraintError,
+  EntityDatabaseAdapterExclusionConstraintError,
+  EntityDatabaseAdapterForeignKeyConstraintError,
+  EntityDatabaseAdapterNotNullConstraintError,
+  EntityDatabaseAdapterUniqueConstraintError,
+} from '../EntityDatabaseAdapterError';
+
+describe(EntityDatabaseAdapterError, () => {
+  // necessary for coverage within the entity package since these errors are
+  // currently only ever instantiated by database adapter implementations
+  it('instantiates all errors successfully', () => {
+    const errors = [
+      new EntityDatabaseAdapterTransientError('test'),
+      new EntityDatabaseAdapterUnknownError('test'),
+      new EntityDatabaseAdapterCheckConstraintError('test'),
+      new EntityDatabaseAdapterExclusionConstraintError('test'),
+      new EntityDatabaseAdapterForeignKeyConstraintError('test'),
+      new EntityDatabaseAdapterNotNullConstraintError('test'),
+      new EntityDatabaseAdapterUniqueConstraintError('test'),
+    ];
+    expect(errors).not.toBeFalsy();
+  });
+});

package/src/index.ts

@@ -85,6 +85,7 @@ export { default as AlwaysDenyPrivacyPolicyRule } from './rules/AlwaysDenyPrivac
 export { default as AlwaysSkipPrivacyPolicyRule } from './rules/AlwaysSkipPrivacyPolicyRule';
 export { default as PrivacyPolicyRule } from './rules/PrivacyPolicyRule';
 export * from './rules/PrivacyPolicyRule';
+export * from './utils/EntityCreationUtils';
 export * from './utils/EntityPrivacyUtils';
 export * from './utils/mergeEntityMutationTriggerConfigurations';
 export * from './utils/collections/maps';

package/src/utils/EntityCreationUtils.ts

@@ -0,0 +1,143 @@
+import { IEntityClass } from '../Entity';
+import EntityPrivacyPolicy from '../EntityPrivacyPolicy';
+import { EntityTransactionalQueryContext } from '../EntityQueryContext';
+import ReadonlyEntity from '../ReadonlyEntity';
+import ViewerContext from '../ViewerContext';
+import { EntityDatabaseAdapterUniqueConstraintError } from '../errors/EntityDatabaseAdapterError';
+import EntityNotFoundError from '../errors/EntityNotFoundError';
+
+/**
+ * Create an entity if it doesn't exist, or get the existing entity if it does.
+ */
+export async function createOrGetExistingAsync<
+  TFields extends object,
+  TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,
+  TViewerContext extends ViewerContext,
+  TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>,
+  TPrivacyPolicy extends EntityPrivacyPolicy<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TSelectedFields
+  >,
+  TGetArgs,
+  TCreateArgs,
+  TSelectedFields extends keyof TFields = keyof TFields,
+>(
+  viewerContext: TViewerContext,
+  entityClass: IEntityClass<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TPrivacyPolicy,
+    TSelectedFields
+  >,
+  getAsync: (
+    viewerContext: TViewerContext,
+    getArgs: TGetArgs,
+    queryContext?: EntityTransactionalQueryContext,
+  ) => Promise<TEntity | null>,
+  getArgs: TGetArgs,
+  createAsync: (
+    viewerContext: TViewerContext,
+    createArgs: TCreateArgs,
+    queryContext?: EntityTransactionalQueryContext,
+  ) => Promise<TEntity>,
+  createArgs: TCreateArgs,
+  queryContext?: EntityTransactionalQueryContext,
+): Promise<TEntity> {
+  if (!queryContext) {
+    const maybeEntity = await getAsync(viewerContext, getArgs);
+    if (maybeEntity) {
+      return maybeEntity;
+    }
+  } else {
+    // This is done in a nested transaction since entity may negatively cache load results per-transaction (when configured).
+    // Without it, it would
+    // 1. load the entity in the current query context, negatively cache it
+    // 2. then try to create it in the nested transaction, which may fail due to a unique constraint error
+    // 3. then try to load the entity again in the current query context, which would return null due to negative cache
+    const maybeEntity = await queryContext.runInNestedTransactionAsync((nestedQueryContext) =>
+      getAsync(viewerContext, getArgs, nestedQueryContext),
+    );
+    if (maybeEntity) {
+      return maybeEntity;
+    }
+  }
+  return await createWithUniqueConstraintRecoveryAsync(
+    viewerContext,
+    entityClass,
+    getAsync,
+    getArgs,
+    createAsync,
+    createArgs,
+    queryContext,
+  );
+}
+
+/**
+ * Account for concurrent requests that may try to create the same entity.
+ * Return the existing entity if we get a Unique Constraint error.
+ */
+export async function createWithUniqueConstraintRecoveryAsync<
+  TFields extends object,
+  TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,
+  TViewerContext extends ViewerContext,
+  TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>,
+  TPrivacyPolicy extends EntityPrivacyPolicy<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TSelectedFields
+  >,
+  TGetArgs,
+  TCreateArgs,
+  TSelectedFields extends keyof TFields = keyof TFields,
+>(
+  viewerContext: TViewerContext,
+  entityClass: IEntityClass<
+    TFields,
+    TIDField,
+    TViewerContext,
+    TEntity,
+    TPrivacyPolicy,
+    TSelectedFields
+  >,
+  getAsync: (
+    viewerContext: TViewerContext,
+    getArgs: TGetArgs,
+    queryContext?: EntityTransactionalQueryContext,
+  ) => Promise<TEntity | null>,
+  getArgs: TGetArgs,
+  createAsync: (
+    viewerContext: TViewerContext,
+    createArgs: TCreateArgs,
+    queryContext?: EntityTransactionalQueryContext,
+  ) => Promise<TEntity>,
+  createArgs: TCreateArgs,
+  queryContext?: EntityTransactionalQueryContext,
+): Promise<TEntity> {
+  try {
+    if (!queryContext) {
+      return await createAsync(viewerContext, createArgs);
+    }
+    return await queryContext.runInNestedTransactionAsync((nestedQueryContext) =>
+      createAsync(viewerContext, createArgs, nestedQueryContext),
+    );
+  } catch (e) {
+    if (e instanceof EntityDatabaseAdapterUniqueConstraintError) {
+      const entity = await getAsync(viewerContext, getArgs, queryContext);
+      if (!entity) {
+        throw new EntityNotFoundError(
+          `Expected entity to exist after unique constraint error: ${entityClass.name}`,
+        );
+      }
+      return entity;
+    } else {
+      throw e;
+    }
+  }
+}

package/src/utils/__tests__/EntityCreationUtils-test.ts

@@ -0,0 +1,354 @@
+import { EntityTransactionalQueryContext } from '../../EntityQueryContext';
+import ViewerContext from '../../ViewerContext';
+import { EntityDatabaseAdapterUniqueConstraintError } from '../../errors/EntityDatabaseAdapterError';
+import EntityNotFoundError from '../../errors/EntityNotFoundError';
+import {
+  createOrGetExistingAsync,
+  createWithUniqueConstraintRecoveryAsync,
+} from '../EntityCreationUtils';
+import SimpleTestEntity from '../__testfixtures__/SimpleTestEntity';
+import { createUnitTestEntityCompanionProvider } from '../__testfixtures__/createUnitTestEntityCompanionProvider';
+
+type TArgs = object;
+
+describe.each([true, false])('in transaction %p', (inTransaction) => {
+  describe(createOrGetExistingAsync, () => {
+    it('does not create when already exists', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const entity = await SimpleTestEntity.creator(viewerContext).createAsync();
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return entity;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (vc: ViewerContext, _args: TArgs, queryContext?: EntityTransactionalQueryContext) => {
+          return await SimpleTestEntity.creator(vc, queryContext).createAsync();
+        },
+      );
+
+      if (inTransaction) {
+        await viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+          'postgres',
+          async (queryContext) => {
+            await createOrGetExistingAsync(
+              viewerContext,
+              SimpleTestEntity,
+              getFn,
+              args,
+              createFn,
+              args,
+              queryContext,
+            );
+          },
+        );
+      } else {
+        await createOrGetExistingAsync(
+          viewerContext,
+          SimpleTestEntity,
+          getFn,
+          args,
+          createFn,
+          args,
+        );
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(1);
+      expect(createFn).toHaveBeenCalledTimes(0);
+    });
+
+    it('creates when not found', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return null;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (vc: ViewerContext, _args: TArgs, queryContext?: EntityTransactionalQueryContext) => {
+          return await SimpleTestEntity.creator(vc, queryContext).createAsync();
+        },
+      );
+
+      if (inTransaction) {
+        await viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+          'postgres',
+          async (queryContext) => {
+            await createOrGetExistingAsync(
+              viewerContext,
+              SimpleTestEntity,
+              getFn,
+              args,
+              createFn,
+              args,
+              queryContext,
+            );
+          },
+        );
+      } else {
+        await createOrGetExistingAsync(
+          viewerContext,
+          SimpleTestEntity,
+          getFn,
+          args,
+          createFn,
+          args,
+        );
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(1);
+      expect(createFn).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe(createWithUniqueConstraintRecoveryAsync, () => {
+    it('does not call get when creation succeeds', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return null;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (vc: ViewerContext, _args: TArgs, queryContext?: EntityTransactionalQueryContext) => {
+          return await SimpleTestEntity.creator(vc, queryContext).createAsync();
+        },
+      );
+
+      if (inTransaction) {
+        await viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+          'postgres',
+          async (queryContext) => {
+            await createWithUniqueConstraintRecoveryAsync(
+              viewerContext,
+              SimpleTestEntity,
+              getFn,
+              args,
+              createFn,
+              args,
+              queryContext,
+            );
+          },
+        );
+      } else {
+        await createWithUniqueConstraintRecoveryAsync(
+          viewerContext,
+          SimpleTestEntity,
+          getFn,
+          args,
+          createFn,
+          args,
+        );
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(0);
+      expect(createFn).toHaveBeenCalledTimes(1);
+    });
+
+    it('calls get when database adapter throws EntityDatabaseAdapterUniqueConstraintError', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const entity = await SimpleTestEntity.creator(viewerContext).createAsync();
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return entity;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          throw new EntityDatabaseAdapterUniqueConstraintError('wat');
+        },
+      );
+
+      if (inTransaction) {
+        await viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+          'postgres',
+          async (queryContext) => {
+            await createWithUniqueConstraintRecoveryAsync(
+              viewerContext,
+              SimpleTestEntity,
+              getFn,
+              args,
+              createFn,
+              args,
+              queryContext,
+            );
+          },
+        );
+      } else {
+        await createWithUniqueConstraintRecoveryAsync(
+          viewerContext,
+          SimpleTestEntity,
+          getFn,
+          args,
+          createFn,
+          args,
+        );
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(1);
+      expect(createFn).toHaveBeenCalledTimes(1);
+    });
+
+    it('throws an EntityNotFoundError when database adapter throws EntityDatabaseAdapterUniqueConstraintError and getFn returns null', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return null;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          throw new EntityDatabaseAdapterUniqueConstraintError('wat');
+        },
+      );
+
+      if (inTransaction) {
+        await expect(
+          viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+            'postgres',
+            async (queryContext) => {
+              return await createWithUniqueConstraintRecoveryAsync(
+                viewerContext,
+                SimpleTestEntity,
+                getFn,
+                args,
+                createFn,
+                args,
+                queryContext,
+              );
+            },
+          ),
+        ).rejects.toThrow(EntityNotFoundError);
+      } else {
+        await expect(
+          createWithUniqueConstraintRecoveryAsync(
+            viewerContext,
+            SimpleTestEntity,
+            getFn,
+            args,
+            createFn,
+            args,
+          ),
+        ).rejects.toThrow(EntityNotFoundError);
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(1);
+      expect(createFn).toHaveBeenCalledTimes(1);
+    });
+
+    it('rethrows whatever error is thrown from database adapter  if not EntityDatabaseAdapterUniqueConstraintError', async () => {
+      const companionProvider = createUnitTestEntityCompanionProvider();
+      const viewerContext = new ViewerContext(companionProvider);
+
+      const args: TArgs = {};
+
+      const getFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          return null;
+        },
+      );
+
+      const createFn = jest.fn(
+        async (
+          _vc: ViewerContext,
+          _args: TArgs,
+          _queryContext?: EntityTransactionalQueryContext,
+        ) => {
+          throw new Error('wat');
+        },
+      );
+
+      if (inTransaction) {
+        await expect(
+          viewerContext.runInTransactionForDatabaseAdaptorFlavorAsync(
+            'postgres',
+            async (queryContext) => {
+              return await createWithUniqueConstraintRecoveryAsync(
+                viewerContext,
+                SimpleTestEntity,
+                getFn,
+                args,
+                createFn,
+                args,
+                queryContext,
+              );
+            },
+          ),
+        ).rejects.toThrow('wat');
+      } else {
+        await expect(
+          createWithUniqueConstraintRecoveryAsync(
+            viewerContext,
+            SimpleTestEntity,
+            getFn,
+            args,
+            createFn,
+            args,
+          ),
+        ).rejects.toThrow('wat');
+      }
+
+      expect(getFn).toHaveBeenCalledTimes(0);
+      expect(createFn).toHaveBeenCalledTimes(1);
+    });
+  });
+});