@expo/entity 0.47.0 → 0.49.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build/src/EntityDatabaseAdapter.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityDatabaseAdapter = exports.OrderByOrdering = void 0;
 exports.isSingleValueFieldEqualityCondition = isSingleValueFieldEqualityCondition;
 const invariant_1 = __importDefault(require("invariant"));
+const EntityDatabaseAdapterError_1 = require("./errors/EntityDatabaseAdapterError");
 const EntityFieldTransformationUtils_1 = require("./internal/EntityFieldTransformationUtils");
 function isSingleValueFieldEqualityCondition(condition) {
     return condition.fieldValue !== undefined;
@@ -106,11 +107,14 @@ class EntityDatabaseAdapter {
     async insertAsync(queryContext, object) {
         const dbObject = (0, EntityFieldTransformationUtils_1.transformFieldsToDatabaseObject)(this.entityConfiguration, this.fieldTransformerMap, object);
         const results = await this.insertInternalAsync(queryContext.getQueryInterface(), this.entityConfiguration.tableName, dbObject);
+        // These should never happen with a properly implemented database adapter unless the underlying database has weird triggers
+        // or something.
+        // These errors are exposed to help application developers detect and diagnose such issues.
         if (results.length > 1) {
-            throw new Error(`Excessive results from database adapter insert: ${this.entityConfiguration.tableName}`);
+            throw new EntityDatabaseAdapterError_1.EntityDatabaseAdapterExcessiveInsertResultError(`Excessive results from database adapter insert: ${this.entityConfiguration.tableName}`);
         }
         else if (results.length === 0) {
-            throw new Error(`Empty results from database adapter insert: ${this.entityConfiguration.tableName}`);
+            throw new EntityDatabaseAdapterError_1.EntityDatabaseAdapterEmptyInsertResultError(`Empty results from database adapter insert: ${this.entityConfiguration.tableName}`);
         }
         return (0, EntityFieldTransformationUtils_1.transformDatabaseObjectToFields)(this.entityConfiguration, this.fieldTransformerMap, results[0]);
     }
@@ -128,10 +132,13 @@ class EntityDatabaseAdapter {
         const dbObject = (0, EntityFieldTransformationUtils_1.transformFieldsToDatabaseObject)(this.entityConfiguration, this.fieldTransformerMap, object);
         const results = await this.updateInternalAsync(queryContext.getQueryInterface(), this.entityConfiguration.tableName, idColumn, id, dbObject);
         if (results.length > 1) {
-            throw new Error(`Excessive results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`);
+            // This should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+            // primary key column.
+            throw new EntityDatabaseAdapterError_1.EntityDatabaseAdapterExcessiveUpdateResultError(`Excessive results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`);
         }
         else if (results.length === 0) {
-            throw new Error(`Empty results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`);
+            // This happens when the object to update does not exist. It may have been deleted by another process.
+            throw new EntityDatabaseAdapterError_1.EntityDatabaseAdapterEmptyUpdateResultError(`Empty results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`);
         }
         return (0, EntityFieldTransformationUtils_1.transformDatabaseObjectToFields)(this.entityConfiguration, this.fieldTransformerMap, results[0]);
     }
@@ -146,7 +153,7 @@ class EntityDatabaseAdapter {
         const idColumn = (0, EntityFieldTransformationUtils_1.getDatabaseFieldForEntityField)(this.entityConfiguration, idField);
         const numDeleted = await this.deleteInternalAsync(queryContext.getQueryInterface(), this.entityConfiguration.tableName, idColumn, id);
         if (numDeleted > 1) {
-            throw new Error(`Excessive deletions from database adapter delete: ${this.entityConfiguration.tableName}(id = ${id})`);
+            throw new EntityDatabaseAdapterError_1.EntityDatabaseAdapterExcessiveDeleteResultError(`Excessive deletions from database adapter delete: ${this.entityConfiguration.tableName}(id = ${id})`);
         }
     }
     convertToTableQueryModifiersWithOrderByRaw(querySelectionModifiers) {

package/build/src/EntityDatabaseAdapter.js.map

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

package/build/src/EntityFields.d.ts

@@ -7,7 +7,9 @@ export declare class StringField<TRequireExplicitCache extends boolean> extends
 }
 /**
  * EntityFieldDefinition for a column with a JS string type.
- * Enforces that the string is a valid UUID.
+ * Enforces that the string is a valid UUID and that it is lowercase. Entity requires UUIDs to be lowercase since most
+ * databases (e.g. Postgres) treat UUIDs as case-insensitive, which can lead to unexpected entity load results if mixed-case
+ * UUIDs are used.
  */
 export declare class UUIDField<TRequireExplicitCache extends boolean> extends StringField<TRequireExplicitCache> {
     protected validateInputValueInternal(value: string): boolean;

package/build/src/EntityFields.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BufferField = exports.StrictEnumField = exports.EnumField = exports.JSONObjectField = exports.StringArrayField = exports.FloatField = exports.IntField = exports.BooleanField = exports.DateField = exports.UUIDField = exports.StringField = void 0;
 const EntityFieldDefinition_1 = require("./EntityFieldDefinition");
 // Use our own regex since the `uuid` package doesn't support validating UUIDv6/7/8 yet
-const UUID_REGEX = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/i;
+const UUID_REGEX = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;
 /**
  * EntityFieldDefinition for a column with a JS string type.
  */
@@ -15,7 +15,9 @@ class StringField extends EntityFieldDefinition_1.EntityFieldDefinition {
 exports.StringField = StringField;
 /**
  * EntityFieldDefinition for a column with a JS string type.
- * Enforces that the string is a valid UUID.
+ * Enforces that the string is a valid UUID and that it is lowercase. Entity requires UUIDs to be lowercase since most
+ * databases (e.g. Postgres) treat UUIDs as case-insensitive, which can lead to unexpected entity load results if mixed-case
+ * UUIDs are used.
  */
 class UUIDField extends StringField {
     validateInputValueInternal(value) {

package/build/src/EntityFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityFields.js","sourceRoot":"","sources":["../../src/EntityFields.ts"],"names":[],"mappings":";;;AAAA,mEAIiC;AAEjC,uFAAuF;AACvF,MAAM,UAAU,GACd,0JAA0J,CAAC;AAE7J;;GAEG;AACH,MAAa,WAAmD,SAAQ,6CAGvE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;IACnC,CAAC;CACF;AAPD,kCAOC;AAED;;;GAGG;AACH,MAAa,SAEX,SAAQ,WAAkC;IACvB,0BAA0B,CAAC,KAAa;QACzD,OAAO,KAAK,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;CACF;AAND,8BAMC;AAED;;GAEG;AACH,MAAa,SAAiD,SAAQ,6CAGrE;IACW,0BAA0B,CAAC,KAAW;QAC9C,OAAO,KAAK,YAAY,IAAI,CAAC;IAC/B,CAAC;CACF;AAPD,8BAOC;AAED;;GAEG;AACH,MAAa,YAAoD,SAAQ,6CAGxE;IACW,0BAA0B,CAAC,KAAc;QACjD,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;IACpC,CAAC;CACF;AAPD,oCAOC;AAED;;;GAGG;AACH,MAAa,QAAgD,SAAQ,6CAGpE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;CACF;AAPD,4BAOC;AAED;;;GAGG;AACH,MAAa,UAAkD,SAAQ,6CAGtE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;IACnC,CAAC;CACF;AAPD,gCAOC;AAED;;;GAGG;AACH,MAAa,gBAAwD,SAAQ,6CAG5E;IACW,0BAA0B,CAAC,KAAe;QAClD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzF,CAAC;CACF;AAPD,4CAOC;AAED;;GAEG;AACH,MAAa,eAAuD,SAAQ,6CAG3E;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;CACF;AAPD,0CAOC;AAED;;GAEG;AACH,MAAa,SAAiD,SAAQ,6CAGrE;IACW,0BAA0B,CAAC,KAAsB;QACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;IAChE,CAAC;CACF;AAPD,8BAOC;AAED;;;GAGG;AACH,MAAa,eAGX,SAAQ,SAAgC;IACvB,IAAI,CAAI;IACzB,YACE,OAE8C;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEkB,0BAA0B,CAAC,KAAsB;QAClE,OAAO,KAAK,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC;CACF;AAjBD,0CAiBC;AAED;;GAEG;AACH,MAAa,WAAmD,SAAQ,6CAGvE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AAPD,kCAOC"}
+{"version":3,"file":"EntityFields.js","sourceRoot":"","sources":["../../src/EntityFields.ts"],"names":[],"mappings":";;;AAAA,mEAIiC;AAEjC,uFAAuF;AACvF,MAAM,UAAU,GACd,yJAAyJ,CAAC;AAE5J;;GAEG;AACH,MAAa,WAAmD,SAAQ,6CAGvE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;IACnC,CAAC;CACF;AAPD,kCAOC;AAED;;;;;GAKG;AACH,MAAa,SAEX,SAAQ,WAAkC;IACvB,0BAA0B,CAAC,KAAa;QACzD,OAAO,KAAK,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;CACF;AAND,8BAMC;AAED;;GAEG;AACH,MAAa,SAAiD,SAAQ,6CAGrE;IACW,0BAA0B,CAAC,KAAW;QAC9C,OAAO,KAAK,YAAY,IAAI,CAAC;IAC/B,CAAC;CACF;AAPD,8BAOC;AAED;;GAEG;AACH,MAAa,YAAoD,SAAQ,6CAGxE;IACW,0BAA0B,CAAC,KAAc;QACjD,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;IACpC,CAAC;CACF;AAPD,oCAOC;AAED;;;GAGG;AACH,MAAa,QAAgD,SAAQ,6CAGpE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;CACF;AAPD,4BAOC;AAED;;;GAGG;AACH,MAAa,UAAkD,SAAQ,6CAGtE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;IACnC,CAAC;CACF;AAPD,gCAOC;AAED;;;GAGG;AACH,MAAa,gBAAwD,SAAQ,6CAG5E;IACW,0BAA0B,CAAC,KAAe;QAClD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzF,CAAC;CACF;AAPD,4CAOC;AAED;;GAEG;AACH,MAAa,eAAuD,SAAQ,6CAG3E;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;CACF;AAPD,0CAOC;AAED;;GAEG;AACH,MAAa,SAAiD,SAAQ,6CAGrE;IACW,0BAA0B,CAAC,KAAsB;QACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;IAChE,CAAC;CACF;AAPD,8BAOC;AAED;;;GAGG;AACH,MAAa,eAGX,SAAQ,SAAgC;IACvB,IAAI,CAAI;IACzB,YACE,OAE8C;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEkB,0BAA0B,CAAC,KAAsB;QAClE,OAAO,KAAK,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC;CACF;AAjBD,0CAiBC;AAED;;GAEG;AACH,MAAa,WAAmD,SAAQ,6CAGvE;IACW,0BAA0B,CAAC,KAAa;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AAPD,kCAOC"}

package/build/src/entityUtils.d.ts

@@ -30,10 +30,10 @@ export type PartitionArrayPredicate<T, U> = (val: T | U) => val is T;
  * @param values - array of values to partition
  * @param predicate - binary predicate to evaluate partition group of each value
  */
-export declare const partitionArray: <T, U>(values: (T | U)[], predicate: PartitionArrayPredicate<T, U>) => [T[], U[]];
+export declare const partitionArray: <T, U>(values: readonly (T | U)[], predicate: PartitionArrayPredicate<T, U>) => readonly [readonly T[], readonly U[]];
 /**
  * Partition array of values and errors into an array of values and an array of errors.
  * @param valuesAndErrors - array of values and errors
  */
-export declare const partitionErrors: <T>(valuesAndErrors: (T | Error)[]) => [T[], Error[]];
+export declare const partitionErrors: <T>(valuesAndErrors: readonly (T | Error)[]) => readonly [readonly T[], readonly Error[]];
 export declare const pick: <T extends object, U extends keyof T>(object: T, props: readonly U[]) => Pick<T, U>;

package/build/src/entityUtils.js.map

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

package/build/src/errors/EntityCacheAdapterError.d.ts

@@ -1,6 +1,13 @@
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
+/**
+ * Base class for errors thrown by the entity cache adapter.
+ */
 export declare abstract class EntityCacheAdapterError extends EntityError {
 }
+/**
+ * Error thrown when a transient error occurs in the entity cache adapter.
+ * Transient errors may succeed if retried.
+ */
 export declare class EntityCacheAdapterTransientError extends EntityCacheAdapterError {
     readonly state = EntityErrorState.TRANSIENT;
     readonly code = EntityErrorCode.ERR_ENTITY_CACHE_ADAPTER_TRANSIENT;

package/build/src/errors/EntityCacheAdapterError.js

@@ -2,9 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityCacheAdapterTransientError = exports.EntityCacheAdapterError = void 0;
 const EntityError_1 = require("./EntityError");
+/**
+ * Base class for errors thrown by the entity cache adapter.
+ */
 class EntityCacheAdapterError extends EntityError_1.EntityError {
 }
 exports.EntityCacheAdapterError = EntityCacheAdapterError;
+/**
+ * Error thrown when a transient error occurs in the entity cache adapter.
+ * Transient errors may succeed if retried.
+ */
 class EntityCacheAdapterTransientError extends EntityCacheAdapterError {
     state = EntityError_1.EntityErrorState.TRANSIENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_CACHE_ADAPTER_TRANSIENT;

package/build/src/errors/EntityCacheAdapterError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityCacheAdapterError.js","sourceRoot":"","sources":["../../../src/errors/EntityCacheAdapterError.ts"],"names":[],"mappings":";;;AAAA,+CAA+E;AAE/E,MAAsB,uBAAwB,SAAQ,yBAAW;CAAG;AAApE,0DAAoE;AAEpE,MAAa,gCAAiC,SAAQ,uBAAuB;IAC3D,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,kCAAkC,CAAC;CAC3E;AAHD,4EAGC"}
+{"version":3,"file":"EntityCacheAdapterError.js","sourceRoot":"","sources":["../../../src/errors/EntityCacheAdapterError.ts"],"names":[],"mappings":";;;AAAA,+CAA+E;AAE/E;;GAEG;AACH,MAAsB,uBAAwB,SAAQ,yBAAW;CAAG;AAApE,0DAAoE;AAEpE;;;GAGG;AACH,MAAa,gCAAiC,SAAQ,uBAAuB;IAC3D,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,kCAAkC,CAAC;CAC3E;AAHD,4EAGC"}

package/build/src/errors/EntityDatabaseAdapterError.d.ts

@@ -1,31 +1,109 @@
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
+/**
+ * Base class for all errors related to the database adapter.
+ */
 export declare abstract class EntityDatabaseAdapterError extends EntityError {
 }
+/**
+ * Thrown when a transient error occurrs within the database adapter.
+ * Transient errors may succeed if retried.
+ */
 export declare class EntityDatabaseAdapterTransientError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.TRANSIENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_TRANSIENT;
 }
+/**
+ * Thrown when an unknown error occurrs within the database adapter.
+ * This is a catch-all error class for DBMS-specific errors that do not fit into other categories.
+ */
 export declare class EntityDatabaseAdapterUnknownError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.UNKNOWN;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNKNOWN;
 }
+/**
+ * Thrown when a check constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated does not satisfy a defined data integrity constraint.
+ */
 export declare class EntityDatabaseAdapterCheckConstraintError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_CHECK_CONSTRAINT;
 }
+/**
+ * Thrown when an exclusion constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated conflicts with an existing value based on a defined exclusion constraint.
+ */
 export declare class EntityDatabaseAdapterExclusionConstraintError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCLUSION_CONSTRAINT;
 }
+/**
+ * Thrown when a foreign key constraint is violated within the database adapter.
+ * This indicates that a value being inserted, updated, or deleted references a non-existent value in a related table
+ * or is referenced in a related table.
+ */
 export declare class EntityDatabaseAdapterForeignKeyConstraintError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT;
 }
+/**
+ * Thrown when a not-null constraint is violated within the database adapter.
+ * This indicates that a null value is being inserted or updated into a column that does not allow null values.
+ */
 export declare class EntityDatabaseAdapterNotNullConstraintError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT;
 }
+/**
+ * Thrown when a unique constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated duplicates an existing value in a column or set of columns
+ * that require unique values.
+ */
 export declare class EntityDatabaseAdapterUniqueConstraintError extends EntityDatabaseAdapterError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT;
 }
+/**
+ * Thrown when an insert operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+export declare class EntityDatabaseAdapterExcessiveInsertResultError extends EntityDatabaseAdapterError {
+    readonly state = EntityErrorState.PERMANENT;
+    readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT;
+}
+/**
+ * Thrown when an insert operation returns no results. One row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+export declare class EntityDatabaseAdapterEmptyInsertResultError extends EntityDatabaseAdapterError {
+    readonly state = EntityErrorState.PERMANENT;
+    readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT;
+}
+/**
+ * Thrown when an update operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+export declare class EntityDatabaseAdapterExcessiveUpdateResultError extends EntityDatabaseAdapterError {
+    readonly state = EntityErrorState.PERMANENT;
+    readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT;
+}
+/**
+ * Thrown when an update operation returns no results. One row is expected.
+ * This most often happens when attempting to update a non-existent row, often indicating that the row
+ * was deleted by a different process between fetching and updating it in this process.
+ */
+export declare class EntityDatabaseAdapterEmptyUpdateResultError extends EntityDatabaseAdapterError {
+    readonly state = EntityErrorState.PERMANENT;
+    readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT;
+}
+/**
+ * Thrown when a delete operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+export declare class EntityDatabaseAdapterExcessiveDeleteResultError extends EntityDatabaseAdapterError {
+    readonly state = EntityErrorState.PERMANENT;
+    readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT;
+}

package/build/src/errors/EntityDatabaseAdapterError.js

@@ -1,43 +1,126 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityDatabaseAdapterUniqueConstraintError = exports.EntityDatabaseAdapterNotNullConstraintError = exports.EntityDatabaseAdapterForeignKeyConstraintError = exports.EntityDatabaseAdapterExclusionConstraintError = exports.EntityDatabaseAdapterCheckConstraintError = exports.EntityDatabaseAdapterUnknownError = exports.EntityDatabaseAdapterTransientError = exports.EntityDatabaseAdapterError = void 0;
+exports.EntityDatabaseAdapterExcessiveDeleteResultError = exports.EntityDatabaseAdapterEmptyUpdateResultError = exports.EntityDatabaseAdapterExcessiveUpdateResultError = exports.EntityDatabaseAdapterEmptyInsertResultError = exports.EntityDatabaseAdapterExcessiveInsertResultError = exports.EntityDatabaseAdapterUniqueConstraintError = exports.EntityDatabaseAdapterNotNullConstraintError = exports.EntityDatabaseAdapterForeignKeyConstraintError = exports.EntityDatabaseAdapterExclusionConstraintError = exports.EntityDatabaseAdapterCheckConstraintError = exports.EntityDatabaseAdapterUnknownError = exports.EntityDatabaseAdapterTransientError = exports.EntityDatabaseAdapterError = void 0;
 const EntityError_1 = require("./EntityError");
+/**
+ * Base class for all errors related to the database adapter.
+ */
 class EntityDatabaseAdapterError extends EntityError_1.EntityError {
 }
 exports.EntityDatabaseAdapterError = EntityDatabaseAdapterError;
+/**
+ * Thrown when a transient error occurrs within the database adapter.
+ * Transient errors may succeed if retried.
+ */
 class EntityDatabaseAdapterTransientError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.TRANSIENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_TRANSIENT;
 }
 exports.EntityDatabaseAdapterTransientError = EntityDatabaseAdapterTransientError;
+/**
+ * Thrown when an unknown error occurrs within the database adapter.
+ * This is a catch-all error class for DBMS-specific errors that do not fit into other categories.
+ */
 class EntityDatabaseAdapterUnknownError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.UNKNOWN;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNKNOWN;
 }
 exports.EntityDatabaseAdapterUnknownError = EntityDatabaseAdapterUnknownError;
+/**
+ * Thrown when a check constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated does not satisfy a defined data integrity constraint.
+ */
 class EntityDatabaseAdapterCheckConstraintError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_CHECK_CONSTRAINT;
 }
 exports.EntityDatabaseAdapterCheckConstraintError = EntityDatabaseAdapterCheckConstraintError;
+/**
+ * Thrown when an exclusion constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated conflicts with an existing value based on a defined exclusion constraint.
+ */
 class EntityDatabaseAdapterExclusionConstraintError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCLUSION_CONSTRAINT;
 }
 exports.EntityDatabaseAdapterExclusionConstraintError = EntityDatabaseAdapterExclusionConstraintError;
+/**
+ * Thrown when a foreign key constraint is violated within the database adapter.
+ * This indicates that a value being inserted, updated, or deleted references a non-existent value in a related table
+ * or is referenced in a related table.
+ */
 class EntityDatabaseAdapterForeignKeyConstraintError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT;
 }
 exports.EntityDatabaseAdapterForeignKeyConstraintError = EntityDatabaseAdapterForeignKeyConstraintError;
+/**
+ * Thrown when a not-null constraint is violated within the database adapter.
+ * This indicates that a null value is being inserted or updated into a column that does not allow null values.
+ */
 class EntityDatabaseAdapterNotNullConstraintError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT;
 }
 exports.EntityDatabaseAdapterNotNullConstraintError = EntityDatabaseAdapterNotNullConstraintError;
+/**
+ * Thrown when a unique constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated duplicates an existing value in a column or set of columns
+ * that require unique values.
+ */
 class EntityDatabaseAdapterUniqueConstraintError extends EntityDatabaseAdapterError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT;
 }
 exports.EntityDatabaseAdapterUniqueConstraintError = EntityDatabaseAdapterUniqueConstraintError;
+/**
+ * Thrown when an insert operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+class EntityDatabaseAdapterExcessiveInsertResultError extends EntityDatabaseAdapterError {
+    state = EntityError_1.EntityErrorState.PERMANENT;
+    code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT;
+}
+exports.EntityDatabaseAdapterExcessiveInsertResultError = EntityDatabaseAdapterExcessiveInsertResultError;
+/**
+ * Thrown when an insert operation returns no results. One row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+class EntityDatabaseAdapterEmptyInsertResultError extends EntityDatabaseAdapterError {
+    state = EntityError_1.EntityErrorState.PERMANENT;
+    code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT;
+}
+exports.EntityDatabaseAdapterEmptyInsertResultError = EntityDatabaseAdapterEmptyInsertResultError;
+/**
+ * Thrown when an update operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+class EntityDatabaseAdapterExcessiveUpdateResultError extends EntityDatabaseAdapterError {
+    state = EntityError_1.EntityErrorState.PERMANENT;
+    code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT;
+}
+exports.EntityDatabaseAdapterExcessiveUpdateResultError = EntityDatabaseAdapterExcessiveUpdateResultError;
+/**
+ * Thrown when an update operation returns no results. One row is expected.
+ * This most often happens when attempting to update a non-existent row, often indicating that the row
+ * was deleted by a different process between fetching and updating it in this process.
+ */
+class EntityDatabaseAdapterEmptyUpdateResultError extends EntityDatabaseAdapterError {
+    state = EntityError_1.EntityErrorState.PERMANENT;
+    code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT;
+}
+exports.EntityDatabaseAdapterEmptyUpdateResultError = EntityDatabaseAdapterEmptyUpdateResultError;
+/**
+ * Thrown when a delete operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+class EntityDatabaseAdapterExcessiveDeleteResultError extends EntityDatabaseAdapterError {
+    state = EntityError_1.EntityErrorState.PERMANENT;
+    code = EntityError_1.EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT;
+}
+exports.EntityDatabaseAdapterExcessiveDeleteResultError = EntityDatabaseAdapterExcessiveDeleteResultError;
 //# sourceMappingURL=EntityDatabaseAdapterError.js.map

package/build/src/errors/EntityDatabaseAdapterError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityDatabaseAdapterError.js","sourceRoot":"","sources":["../../../src/errors/EntityDatabaseAdapterError.ts"],"names":[],"mappings":";;;AAAA,+CAA+E;AAE/E,MAAsB,0BAA2B,SAAQ,yBAAW;CAAG;AAAvE,gEAAuE;AAEvE,MAAa,mCAAoC,SAAQ,0BAA0B;IACjE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,qCAAqC,CAAC;CAC9E;AAHD,kFAGC;AAED,MAAa,iCAAkC,SAAQ,0BAA0B;IAC/D,KAAK,GAAG,8BAAgB,CAAC,OAAO,CAAC;IACjC,IAAI,GAAG,6BAAe,CAAC,mCAAmC,CAAC;CAC5E;AAHD,8EAGC;AAED,MAAa,yCAA0C,SAAQ,0BAA0B;IACvE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,4CAA4C,CAAC;CACrF;AAHD,8FAGC;AAED,MAAa,6CAA8C,SAAQ,0BAA0B;IAC3E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,gDAAgD,CAAC;CACzF;AAHD,sGAGC;AAED,MAAa,8CAA+C,SAAQ,0BAA0B;IAC5E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,kDAAkD,CAAC;CAC3F;AAHD,wGAGC;AAED,MAAa,2CAA4C,SAAQ,0BAA0B;IACzE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,+CAA+C,CAAC;CACxF;AAHD,kGAGC;AAED,MAAa,0CAA2C,SAAQ,0BAA0B;IACxE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,6CAA6C,CAAC;CACtF;AAHD,gGAGC"}
+{"version":3,"file":"EntityDatabaseAdapterError.js","sourceRoot":"","sources":["../../../src/errors/EntityDatabaseAdapterError.ts"],"names":[],"mappings":";;;AAAA,+CAA+E;AAE/E;;GAEG;AACH,MAAsB,0BAA2B,SAAQ,yBAAW;CAAG;AAAvE,gEAAuE;AAEvE;;;GAGG;AACH,MAAa,mCAAoC,SAAQ,0BAA0B;IACjE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,qCAAqC,CAAC;CAC9E;AAHD,kFAGC;AAED;;;GAGG;AACH,MAAa,iCAAkC,SAAQ,0BAA0B;IAC/D,KAAK,GAAG,8BAAgB,CAAC,OAAO,CAAC;IACjC,IAAI,GAAG,6BAAe,CAAC,mCAAmC,CAAC;CAC5E;AAHD,8EAGC;AAED;;;GAGG;AACH,MAAa,yCAA0C,SAAQ,0BAA0B;IACvE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,4CAA4C,CAAC;CACrF;AAHD,8FAGC;AAED;;;GAGG;AACH,MAAa,6CAA8C,SAAQ,0BAA0B;IAC3E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,gDAAgD,CAAC;CACzF;AAHD,sGAGC;AAED;;;;GAIG;AACH,MAAa,8CAA+C,SAAQ,0BAA0B;IAC5E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,kDAAkD,CAAC;CAC3F;AAHD,wGAGC;AAED;;;GAGG;AACH,MAAa,2CAA4C,SAAQ,0BAA0B;IACzE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,+CAA+C,CAAC;CACxF;AAHD,kGAGC;AAED;;;;GAIG;AACH,MAAa,0CAA2C,SAAQ,0BAA0B;IACxE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,6CAA6C,CAAC;CACtF;AAHD,gGAGC;AAED;;;;GAIG;AACH,MAAa,+CAAgD,SAAQ,0BAA0B;IAC7E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,mDAAmD,CAAC;CAC5F;AAHD,0GAGC;AAED;;;;GAIG;AACH,MAAa,2CAA4C,SAAQ,0BAA0B;IACzE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,+CAA+C,CAAC;CACxF;AAHD,kGAGC;AAED;;;;GAIG;AACH,MAAa,+CAAgD,SAAQ,0BAA0B;IAC7E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,mDAAmD,CAAC;CAC5F;AAHD,0GAGC;AAED;;;;GAIG;AACH,MAAa,2CAA4C,SAAQ,0BAA0B;IACzE,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,+CAA+C,CAAC;CACxF;AAHD,kGAGC;AAED;;;;GAIG;AACH,MAAa,+CAAgD,SAAQ,0BAA0B;IAC7E,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,mDAAmD,CAAC;CAC5F;AAHD,0GAGC"}

package/build/src/errors/EntityError.d.ts

@@ -1,9 +1,15 @@
 import ES6Error from 'es6-error';
+/**
+ * The state of an entity error, indicating whether it may be transient/retryable.
+ */
 export declare enum EntityErrorState {
     UNKNOWN = 0,
     TRANSIENT = 1,
     PERMANENT = 2
 }
+/**
+ * Error code for an entity error. Each error code should map to a specific class of Entity error.
+ */
 export declare enum EntityErrorCode {
     ERR_ENTITY_NOT_AUTHORIZED = "ERR_ENTITY_NOT_AUTHORIZED",
     ERR_ENTITY_NOT_FOUND = "ERR_ENTITY_NOT_FOUND",
@@ -15,8 +21,16 @@ export declare enum EntityErrorCode {
     ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT = "ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT",
     ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT = "ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT",
     ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT = "ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT",
+    ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT",
+    ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT = "ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT",
+    ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT",
+    ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT = "ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT",
+    ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT",
     ERR_ENTITY_CACHE_ADAPTER_TRANSIENT = "ERR_ENTITY_CACHE_ADAPTER_TRANSIENT"
 }
+/**
+ * Base class for all known errors thrown by the entity system.
+ */
 export declare abstract class EntityError extends ES6Error {
     readonly cause?: Error | undefined;
     abstract readonly state: EntityErrorState;

package/build/src/errors/EntityError.js

@@ -5,12 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityError = exports.EntityErrorCode = exports.EntityErrorState = void 0;
 const es6_error_1 = __importDefault(require("es6-error"));
+/**
+ * The state of an entity error, indicating whether it may be transient/retryable.
+ */
 var EntityErrorState;
 (function (EntityErrorState) {
     EntityErrorState[EntityErrorState["UNKNOWN"] = 0] = "UNKNOWN";
     EntityErrorState[EntityErrorState["TRANSIENT"] = 1] = "TRANSIENT";
     EntityErrorState[EntityErrorState["PERMANENT"] = 2] = "PERMANENT";
 })(EntityErrorState || (exports.EntityErrorState = EntityErrorState = {}));
+/**
+ * Error code for an entity error. Each error code should map to a specific class of Entity error.
+ */
 var EntityErrorCode;
 (function (EntityErrorCode) {
     EntityErrorCode["ERR_ENTITY_NOT_AUTHORIZED"] = "ERR_ENTITY_NOT_AUTHORIZED";
@@ -23,8 +29,16 @@ var EntityErrorCode;
     EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT"] = "ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT";
     EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT"] = "ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT";
     EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT"] = "ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT";
+    EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT"] = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT";
+    EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT"] = "ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT";
+    EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT"] = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT";
+    EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT"] = "ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT";
+    EntityErrorCode["ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT"] = "ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT";
     EntityErrorCode["ERR_ENTITY_CACHE_ADAPTER_TRANSIENT"] = "ERR_ENTITY_CACHE_ADAPTER_TRANSIENT";
 })(EntityErrorCode || (exports.EntityErrorCode = EntityErrorCode = {}));
+/**
+ * Base class for all known errors thrown by the entity system.
+ */
 class EntityError extends es6_error_1.default {
     cause;
     constructor(message, cause) {

package/build/src/errors/EntityError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityError.js","sourceRoot":"","sources":["../../../src/errors/EntityError.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAiC;AAEjC,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,6DAAO,CAAA;IACP,iEAAS,CAAA;IACT,iEAAS,CAAA;AACX,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B;AAED,IAAY,eAYX;AAZD,WAAY,eAAe;IACzB,0EAAuD,CAAA;IACvD,gEAA6C,CAAA;IAC7C,oFAAiE,CAAA;IACjE,kGAA+E,CAAA;IAC/E,8FAA2E,CAAA;IAC3E,gHAA6F,CAAA;IAC7F,wHAAqG,CAAA;IACrG,4HAAyG,CAAA;IACzG,sHAAmG,CAAA;IACnG,kHAA+F,CAAA;IAC/F,4FAAyE,CAAA;AAC3E,CAAC,EAZW,eAAe,+BAAf,eAAe,QAY1B;AAED,MAAsB,WAAY,SAAQ,mBAAQ;IAMrB;IAF3B,YACE,OAAe,EACU,KAAa;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFU,UAAK,GAAL,KAAK,CAAQ;IAGxC,CAAC;CACF;AAVD,kCAUC"}
+{"version":3,"file":"EntityError.js","sourceRoot":"","sources":["../../../src/errors/EntityError.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAiC;AAEjC;;GAEG;AACH,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,6DAAO,CAAA;IACP,iEAAS,CAAA;IACT,iEAAS,CAAA;AACX,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B;AAED;;GAEG;AACH,IAAY,eAiBX;AAjBD,WAAY,eAAe;IACzB,0EAAuD,CAAA;IACvD,gEAA6C,CAAA;IAC7C,oFAAiE,CAAA;IACjE,kGAA+E,CAAA;IAC/E,8FAA2E,CAAA;IAC3E,gHAA6F,CAAA;IAC7F,wHAAqG,CAAA;IACrG,4HAAyG,CAAA;IACzG,sHAAmG,CAAA;IACnG,kHAA+F,CAAA;IAC/F,8HAA2G,CAAA;IAC3G,sHAAmG,CAAA;IACnG,8HAA2G,CAAA;IAC3G,sHAAmG,CAAA;IACnG,8HAA2G,CAAA;IAC3G,4FAAyE,CAAA;AAC3E,CAAC,EAjBW,eAAe,+BAAf,eAAe,QAiB1B;AAED;;GAEG;AACH,MAAsB,WAAY,SAAQ,mBAAQ;IAMrB;IAF3B,YACE,OAAe,EACU,KAAa;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFU,UAAK,GAAL,KAAK,CAAQ;IAGxC,CAAC;CACF;AAVD,kCAUC"}

package/build/src/errors/EntityInvalidFieldValueError.d.ts

@@ -3,6 +3,9 @@ import { EntityPrivacyPolicy } from '../EntityPrivacyPolicy';
 import { ReadonlyEntity } from '../ReadonlyEntity';
 import { ViewerContext } from '../ViewerContext';
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
+/**
+ * Error thrown when an entity field has an invalid value, either during load or mutation.
+ */
 export declare class EntityInvalidFieldValueError<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_INVALID_FIELD_VALUE;

package/build/src/errors/EntityInvalidFieldValueError.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityInvalidFieldValueError = void 0;
 const EntityError_1 = require("./EntityError");
+/**
+ * Error thrown when an entity field has an invalid value, either during load or mutation.
+ */
 class EntityInvalidFieldValueError extends EntityError_1.EntityError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_INVALID_FIELD_VALUE;

package/build/src/errors/EntityInvalidFieldValueError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityInvalidFieldValueError.js","sourceRoot":"","sources":["../../../src/errors/EntityInvalidFieldValueError.ts"],"names":[],"mappings":";;;AAIA,+CAA+E;AAE/E,MAAa,4BAcX,SAAQ,yBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,8BAA8B,CAAC;IAEtE,YACE,WAOC,EACD,SAAY,EACZ,UAAuB;QAEvB,KAAK,CAAC,2BAA2B,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;IAC9F,CAAC;CACF;AAhCD,oEAgCC"}
+{"version":3,"file":"EntityInvalidFieldValueError.js","sourceRoot":"","sources":["../../../src/errors/EntityInvalidFieldValueError.ts"],"names":[],"mappings":";;;AAIA,+CAA+E;AAE/E;;GAEG;AACH,MAAa,4BAcX,SAAQ,yBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,8BAA8B,CAAC;IAEtE,YACE,WAOC,EACD,SAAY,EACZ,UAAuB;QAEvB,KAAK,CAAC,2BAA2B,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;IAC9F,CAAC;CACF;AAhCD,oEAgCC"}

package/build/src/errors/EntityNotAuthorizedError.d.ts

@@ -2,6 +2,9 @@ import { EntityAuthorizationAction } from '../EntityPrivacyPolicy';
 import { ReadonlyEntity } from '../ReadonlyEntity';
 import { ViewerContext } from '../ViewerContext';
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
+/**
+ * Error thrown when viewer context is not authorized to perform an action on an entity.
+ */
 export declare class EntityNotAuthorizedError<TFields extends Record<string, any>, TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TIDField, TViewerContext, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields> extends EntityError {
     readonly state = EntityErrorState.PERMANENT;
     readonly code = EntityErrorCode.ERR_ENTITY_NOT_AUTHORIZED;

package/build/src/errors/EntityNotAuthorizedError.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityNotAuthorizedError = void 0;
 const EntityPrivacyPolicy_1 = require("../EntityPrivacyPolicy");
 const EntityError_1 = require("./EntityError");
+/**
+ * Error thrown when viewer context is not authorized to perform an action on an entity.
+ */
 class EntityNotAuthorizedError extends EntityError_1.EntityError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_NOT_AUTHORIZED;

package/build/src/errors/EntityNotAuthorizedError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityNotAuthorizedError.js","sourceRoot":"","sources":["../../../src/errors/EntityNotAuthorizedError.ts"],"names":[],"mappings":";;;AAAA,gEAAmE;AAGnE,+CAA+E;AAE/E,MAAa,wBAMX,SAAQ,yBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,yBAAyB,CAAC;IAEjD,eAAe,CAAS;IAExC,YACE,MAAe,EACf,aAA6B,EAC7B,MAAiC,EACjC,SAAiB;QAEjB,KAAK,CACH,0BAA0B,MAAM,cAAc,aAAa,cAAc,+CAAyB,CAAC,MAAM,CAAC,iBAAiB,SAAS,GAAG,CACxI,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;IACjD,CAAC;CACF;AAvBD,4DAuBC"}
+{"version":3,"file":"EntityNotAuthorizedError.js","sourceRoot":"","sources":["../../../src/errors/EntityNotAuthorizedError.ts"],"names":[],"mappings":";;;AAAA,gEAAmE;AAGnE,+CAA+E;AAE/E;;GAEG;AACH,MAAa,wBAMX,SAAQ,yBAAW;IACH,KAAK,GAAG,8BAAgB,CAAC,SAAS,CAAC;IACnC,IAAI,GAAG,6BAAe,CAAC,yBAAyB,CAAC;IAEjD,eAAe,CAAS;IAExC,YACE,MAAe,EACf,aAA6B,EAC7B,MAAiC,EACjC,SAAiB;QAEjB,KAAK,CACH,0BAA0B,MAAM,cAAc,aAAa,cAAc,+CAAyB,CAAC,MAAM,CAAC,iBAAiB,SAAS,GAAG,CACxI,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;IACjD,CAAC;CACF;AAvBD,4DAuBC"}

package/build/src/errors/EntityNotFoundError.d.ts

@@ -8,6 +8,9 @@ type EntityNotFoundOptions<TFields extends Record<string, any>, TIDField extends
     fieldName: N;
     fieldValue: TFields[N];
 };
+/**
+ * Error thrown when an entity is not found during certain load methods.
+ */
 export declare 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;

package/build/src/errors/EntityNotFoundError.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityNotFoundError = void 0;
 const EntityError_1 = require("./EntityError");
+/**
+ * Error thrown when an entity is not found during certain load methods.
+ */
 class EntityNotFoundError extends EntityError_1.EntityError {
     state = EntityError_1.EntityErrorState.PERMANENT;
     code = EntityError_1.EntityErrorCode.ERR_ENTITY_NOT_FOUND;

package/build/src/errors/EntityNotFoundError.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityNotFoundError.js","sourceRoot":"","sources":["../../../src/errors/EntityNotFoundError.ts"],"names":[],"mappings":";;;AAIA,+CAA+E;AA6B/E,MAAa,mBAcX,SAAQ,yBAAW;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,kDAoDC"}
+{"version":3,"file":"EntityNotFoundError.js","sourceRoot":"","sources":["../../../src/errors/EntityNotFoundError.ts"],"names":[],"mappings":";;;AAIA,+CAA+E;AA6B/E;;GAEG;AACH,MAAa,mBAcX,SAAQ,yBAAW;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,kDAoDC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/entity",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "description": "A privacy-first data model",
   "files": [
     "build",
@@ -43,5 +43,6 @@
     "typescript": "^5.8.3",
     "uuid": "^8.3.0",
     "uuidv7": "^1.0.0"
-  }
+  },
+  "gitHead": "4ab2cf1cc498f0e06bdb0f792a08aca3f49d27fc"
 }

package/src/EntityDatabaseAdapter.ts

@@ -2,6 +2,13 @@ import invariant from 'invariant';
 
 import { EntityConfiguration } from './EntityConfiguration';
 import { EntityQueryContext } from './EntityQueryContext';
+import {
+  EntityDatabaseAdapterEmptyInsertResultError,
+  EntityDatabaseAdapterEmptyUpdateResultError,
+  EntityDatabaseAdapterExcessiveDeleteResultError,
+  EntityDatabaseAdapterExcessiveInsertResultError,
+  EntityDatabaseAdapterExcessiveUpdateResultError,
+} from './errors/EntityDatabaseAdapterError';
 import {
   FieldTransformerMap,
   getDatabaseFieldForEntityField,
@@ -303,12 +310,15 @@ export abstract class EntityDatabaseAdapter<
       dbObject,
     );
 
+    // These should never happen with a properly implemented database adapter unless the underlying database has weird triggers
+    // or something.
+    // These errors are exposed to help application developers detect and diagnose such issues.
     if (results.length > 1) {
-      throw new Error(
+      throw new EntityDatabaseAdapterExcessiveInsertResultError(
         `Excessive results from database adapter insert: ${this.entityConfiguration.tableName}`,
       );
     } else if (results.length === 0) {
-      throw new Error(
+      throw new EntityDatabaseAdapterEmptyInsertResultError(
         `Empty results from database adapter insert: ${this.entityConfiguration.tableName}`,
       );
     }
@@ -356,11 +366,14 @@ export abstract class EntityDatabaseAdapter<
     );
 
     if (results.length > 1) {
-      throw new Error(
+      // This should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+      // primary key column.
+      throw new EntityDatabaseAdapterExcessiveUpdateResultError(
         `Excessive results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`,
       );
     } else if (results.length === 0) {
-      throw new Error(
+      // This happens when the object to update does not exist. It may have been deleted by another process.
+      throw new EntityDatabaseAdapterEmptyUpdateResultError(
         `Empty results from database adapter update: ${this.entityConfiguration.tableName}(id = ${id})`,
       );
     }
@@ -401,7 +414,7 @@ export abstract class EntityDatabaseAdapter<
     );
 
     if (numDeleted > 1) {
-      throw new Error(
+      throw new EntityDatabaseAdapterExcessiveDeleteResultError(
         `Excessive deletions from database adapter delete: ${this.entityConfiguration.tableName}(id = ${id})`,
       );
     }

package/src/EntityFields.ts

@@ -6,7 +6,7 @@ import {
 
 // Use our own regex since the `uuid` package doesn't support validating UUIDv6/7/8 yet
 const UUID_REGEX =
-  /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/i;
+  /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;
 
 /**
  * EntityFieldDefinition for a column with a JS string type.
@@ -22,7 +22,9 @@ export class StringField<TRequireExplicitCache extends boolean> extends EntityFi
 
 /**
  * EntityFieldDefinition for a column with a JS string type.
- * Enforces that the string is a valid UUID.
+ * Enforces that the string is a valid UUID and that it is lowercase. Entity requires UUIDs to be lowercase since most
+ * databases (e.g. Postgres) treat UUIDs as case-insensitive, which can lead to unexpected entity load results if mixed-case
+ * UUIDs are used.
  */
 export class UUIDField<
   TRequireExplicitCache extends boolean,

package/src/__tests__/EntityDatabaseAdapter-test.ts

@@ -7,6 +7,13 @@ import {
   TableFieldSingleValueEqualityCondition,
 } from '../EntityDatabaseAdapter';
 import { EntityQueryContext } from '../EntityQueryContext';
+import {
+  EntityDatabaseAdapterEmptyInsertResultError,
+  EntityDatabaseAdapterEmptyUpdateResultError,
+  EntityDatabaseAdapterExcessiveDeleteResultError,
+  EntityDatabaseAdapterExcessiveInsertResultError,
+  EntityDatabaseAdapterExcessiveUpdateResultError,
+} from '../errors/EntityDatabaseAdapterError';
 import { CompositeFieldHolder, CompositeFieldValueHolder } from '../internal/CompositeFieldHolder';
 import { FieldTransformerMap } from '../internal/EntityFieldTransformationUtils';
 import { SingleFieldHolder, SingleFieldValueHolder } from '../internal/SingleFieldHolder';
@@ -264,7 +271,7 @@ describe(EntityDatabaseAdapter, () => {
       const queryContext = instance(mock(EntityQueryContext));
       const adapter = new TestEntityDatabaseAdapter({ insertResults: [] });
       await expect(adapter.insertAsync(queryContext, {} as any)).rejects.toThrow(
-        'Empty results from database adapter insert',
+        EntityDatabaseAdapterEmptyInsertResultError,
       );
     });
 
@@ -274,7 +281,7 @@ describe(EntityDatabaseAdapter, () => {
         insertResults: [{ string_field: 'hello' }, { string_field: 'hello2' }],
       });
       await expect(adapter.insertAsync(queryContext, {} as any)).rejects.toThrow(
-        'Excessive results from database adapter insert',
+        EntityDatabaseAdapterExcessiveInsertResultError,
       );
     });
   });
@@ -292,7 +299,7 @@ describe(EntityDatabaseAdapter, () => {
       const adapter = new TestEntityDatabaseAdapter({ updateResults: [] });
       await expect(
         adapter.updateAsync(queryContext, 'customIdField', 'wat', {} as any),
-      ).rejects.toThrow('Empty results from database adapter update');
+      ).rejects.toThrow(EntityDatabaseAdapterEmptyUpdateResultError);
     });
 
     it('throws when update result count greater than 1', async () => {
@@ -302,7 +309,7 @@ describe(EntityDatabaseAdapter, () => {
       });
       await expect(
         adapter.updateAsync(queryContext, 'customIdField', 'wat', {} as any),
-      ).rejects.toThrow('Excessive results from database adapter update');
+      ).rejects.toThrow(EntityDatabaseAdapterExcessiveUpdateResultError);
     });
   });
 
@@ -311,7 +318,7 @@ describe(EntityDatabaseAdapter, () => {
       const queryContext = instance(mock(EntityQueryContext));
       const adapter = new TestEntityDatabaseAdapter({ deleteCount: 2 });
       await expect(adapter.deleteAsync(queryContext, 'customIdField', 'wat')).rejects.toThrow(
-        'Excessive deletions from database adapter delet',
+        EntityDatabaseAdapterExcessiveDeleteResultError,
       );
     });
   });

package/src/__tests__/EntityFields-test.ts

@@ -65,7 +65,7 @@ describeFieldTestCase(
     uuidv5('wat', uuidv5.DNS),
     /* UUIDv7 */ '018ebfda-dc80-782d-a891-22a0aa057d52',
   ],
-  [uuidv4().replace('-', ''), '', 'hello'],
+  [uuidv4().replace('-', ''), '', 'hello', uuidv4().toUpperCase()],
 );
 describeFieldTestCase(new DateField({ columnName: 'wat' }), [new Date()], [Date.now()]);
 describeFieldTestCase(new BooleanField({ columnName: 'wat' }), [true, false], [0, 1, '']);

package/src/entityUtils.ts

@@ -79,9 +79,9 @@ export type PartitionArrayPredicate<T, U> = (val: T | U) => val is T;
  * @param predicate - binary predicate to evaluate partition group of each value
  */
 export const partitionArray = <T, U>(
-  values: (T | U)[],
+  values: readonly (T | U)[],
   predicate: PartitionArrayPredicate<T, U>,
-): [T[], U[]] => {
+): readonly [readonly T[], readonly U[]] => {
   const ts: T[] = [];
   const us: U[] = [];
 
@@ -100,7 +100,9 @@ export const partitionArray = <T, U>(
  * Partition array of values and errors into an array of values and an array of errors.
  * @param valuesAndErrors - array of values and errors
  */
-export const partitionErrors = <T>(valuesAndErrors: (T | Error)[]): [T[], Error[]] => {
+export const partitionErrors = <T>(
+  valuesAndErrors: readonly (T | Error)[],
+): readonly [readonly T[], readonly Error[]] => {
   const [errors, values] = partitionArray<Error, T>(valuesAndErrors, isError);
   return [values, errors];
 };

package/src/errors/EntityCacheAdapterError.ts

@@ -1,7 +1,14 @@
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
 
+/**
+ * Base class for errors thrown by the entity cache adapter.
+ */
 export abstract class EntityCacheAdapterError extends EntityError {}
 
+/**
+ * Error thrown when a transient error occurs in the entity cache adapter.
+ * Transient errors may succeed if retried.
+ */
 export class EntityCacheAdapterTransientError extends EntityCacheAdapterError {
   public readonly state = EntityErrorState.TRANSIENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_CACHE_ADAPTER_TRANSIENT;

package/src/errors/EntityDatabaseAdapterError.ts

@@ -1,38 +1,121 @@
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
 
+/**
+ * Base class for all errors related to the database adapter.
+ */
 export abstract class EntityDatabaseAdapterError extends EntityError {}
 
+/**
+ * Thrown when a transient error occurrs within the database adapter.
+ * Transient errors may succeed if retried.
+ */
 export class EntityDatabaseAdapterTransientError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.TRANSIENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_TRANSIENT;
 }
 
+/**
+ * Thrown when an unknown error occurrs within the database adapter.
+ * This is a catch-all error class for DBMS-specific errors that do not fit into other categories.
+ */
 export class EntityDatabaseAdapterUnknownError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.UNKNOWN;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNKNOWN;
 }
 
+/**
+ * Thrown when a check constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated does not satisfy a defined data integrity constraint.
+ */
 export class EntityDatabaseAdapterCheckConstraintError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_CHECK_CONSTRAINT;
 }
 
+/**
+ * Thrown when an exclusion constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated conflicts with an existing value based on a defined exclusion constraint.
+ */
 export class EntityDatabaseAdapterExclusionConstraintError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCLUSION_CONSTRAINT;
 }
 
+/**
+ * Thrown when a foreign key constraint is violated within the database adapter.
+ * This indicates that a value being inserted, updated, or deleted references a non-existent value in a related table
+ * or is referenced in a related table.
+ */
 export class EntityDatabaseAdapterForeignKeyConstraintError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT;
 }
 
+/**
+ * Thrown when a not-null constraint is violated within the database adapter.
+ * This indicates that a null value is being inserted or updated into a column that does not allow null values.
+ */
 export class EntityDatabaseAdapterNotNullConstraintError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT;
 }
 
+/**
+ * Thrown when a unique constraint is violated within the database adapter.
+ * This indicates that a value being inserted or updated duplicates an existing value in a column or set of columns
+ * that require unique values.
+ */
 export class EntityDatabaseAdapterUniqueConstraintError extends EntityDatabaseAdapterError {
   public readonly state = EntityErrorState.PERMANENT;
   public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT;
 }
+
+/**
+ * Thrown when an insert operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+export class EntityDatabaseAdapterExcessiveInsertResultError extends EntityDatabaseAdapterError {
+  public readonly state = EntityErrorState.PERMANENT;
+  public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT;
+}
+
+/**
+ * Thrown when an insert operation returns no results. One row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying database has nonstandard
+ * triggers or something similar.
+ */
+export class EntityDatabaseAdapterEmptyInsertResultError extends EntityDatabaseAdapterError {
+  public readonly state = EntityErrorState.PERMANENT;
+  public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT;
+}
+
+/**
+ * Thrown when an update operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+export class EntityDatabaseAdapterExcessiveUpdateResultError extends EntityDatabaseAdapterError {
+  public readonly state = EntityErrorState.PERMANENT;
+  public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT;
+}
+
+/**
+ * Thrown when an update operation returns no results. One row is expected.
+ * This most often happens when attempting to update a non-existent row, often indicating that the row
+ * was deleted by a different process between fetching and updating it in this process.
+ */
+export class EntityDatabaseAdapterEmptyUpdateResultError extends EntityDatabaseAdapterError {
+  public readonly state = EntityErrorState.PERMANENT;
+  public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT;
+}
+
+/**
+ * Thrown when a delete operation returns more results than expected. Only one row is expected.
+ * These should never happen with a properly implemented database adapter unless the underlying table has a non-unique
+ * primary key column.
+ */
+export class EntityDatabaseAdapterExcessiveDeleteResultError extends EntityDatabaseAdapterError {
+  public readonly state = EntityErrorState.PERMANENT;
+  public readonly code = EntityErrorCode.ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT;
+}

package/src/errors/EntityError.ts

@@ -1,11 +1,17 @@
 import ES6Error from 'es6-error';
 
+/**
+ * The state of an entity error, indicating whether it may be transient/retryable.
+ */
 export enum EntityErrorState {
   UNKNOWN,
   TRANSIENT,
   PERMANENT,
 }
 
+/**
+ * Error code for an entity error. Each error code should map to a specific class of Entity error.
+ */
 export enum EntityErrorCode {
   ERR_ENTITY_NOT_AUTHORIZED = 'ERR_ENTITY_NOT_AUTHORIZED',
   ERR_ENTITY_NOT_FOUND = 'ERR_ENTITY_NOT_FOUND',
@@ -17,9 +23,17 @@ export enum EntityErrorCode {
   ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT = 'ERR_ENTITY_DATABASE_ADAPTER_FOREIGN_KEY_CONSTRAINT',
   ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT = 'ERR_ENTITY_DATABASE_ADAPTER_NOT_NULL_CONSTRAINT',
   ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT = 'ERR_ENTITY_DATABASE_ADAPTER_UNIQUE_CONSTRAINT',
+  ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT = 'ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_INSERT_RESULT',
+  ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT = 'ERR_ENTITY_DATABASE_ADAPTER_EMPTY_INSERT_RESULT',
+  ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT = 'ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_UPDATE_RESULT',
+  ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT = 'ERR_ENTITY_DATABASE_ADAPTER_EMPTY_UPDATE_RESULT',
+  ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT = 'ERR_ENTITY_DATABASE_ADAPTER_EXCESSIVE_DELETE_RESULT',
   ERR_ENTITY_CACHE_ADAPTER_TRANSIENT = 'ERR_ENTITY_CACHE_ADAPTER_TRANSIENT',
 }
 
+/**
+ * Base class for all known errors thrown by the entity system.
+ */
 export abstract class EntityError extends ES6Error {
   public abstract readonly state: EntityErrorState;
   public abstract readonly code: EntityErrorCode;

package/src/errors/EntityInvalidFieldValueError.ts

@@ -4,6 +4,9 @@ import { ReadonlyEntity } from '../ReadonlyEntity';
 import { ViewerContext } from '../ViewerContext';
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
 
+/**
+ * Error thrown when an entity field has an invalid value, either during load or mutation.
+ */
 export class EntityInvalidFieldValueError<
   TFields extends Record<string, any>,
   TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,

package/src/errors/EntityNotAuthorizedError.ts

@@ -3,6 +3,9 @@ import { ReadonlyEntity } from '../ReadonlyEntity';
 import { ViewerContext } from '../ViewerContext';
 import { EntityError, EntityErrorCode, EntityErrorState } from './EntityError';
 
+/**
+ * Error thrown when viewer context is not authorized to perform an action on an entity.
+ */
 export class EntityNotAuthorizedError<
   TFields extends Record<string, any>,
   TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,

package/src/errors/EntityNotFoundError.ts

@@ -31,6 +31,9 @@ type EntityNotFoundOptions<
   fieldValue: TFields[N];
 };
 
+/**
+ * Error thrown when an entity is not found during certain load methods.
+ */
 export class EntityNotFoundError<
   TFields extends Record<string, any>,
   TIDField extends keyof NonNullable<Pick<TFields, TSelectedFields>>,