@expo/entity 0.40.0 → 0.42.0

package/build/internal/EntityLoadInterfaces.d.ts

@@ -0,0 +1,104 @@
+import EntityConfiguration from '../EntityConfiguration';
+import { ISerializable, SerializableKeyMap } from '../utils/collections/SerializableKeyMap';
+/**
+ * Load method type identifier of a load key. Used for keying data loaders and identification in metrics.
+ */
+export declare enum EntityLoadMethodType {
+    /**
+     * Load method type for loading entities by single fieldName and fieldValue(s).
+     */
+    SINGLE = "single",
+    /**
+     * Load method type for loading entities by composite field.
+     */
+    COMPOSITE = "composite"
+}
+/**
+ * Interface responsible for defining how the key and corresponding load values behave in the data manager, cache adapter,
+ * and database adapter during entity field loading.
+ */
+export interface IEntityLoadKey<TFields extends Record<string, any>, TIDField extends keyof TFields, TSerializedLoadValue, TLoadValue extends IEntityLoadValue<TSerializedLoadValue>> {
+    toString(): string;
+    /**
+     * Vends a new empty load value map with a key type corresponding to the load value type of this load key.
+     *
+     * @returns A new empty load value map.
+     */
+    vendNewLoadValueMap<V>(): LoadValueMap<TSerializedLoadValue, TLoadValue, V>;
+    /**
+     * Determines if this key is cacheable in cache adapters according to the entity configuration.
+     *
+     * @param entityConfiguration - The entity configuration to check.
+     * @returns Boolean indicating whether this key is cacheable.
+     */
+    isCacheable(entityConfiguration: EntityConfiguration<TFields, TIDField>): boolean;
+    /**
+     * Creates cache key parts for this key and a load value given an entity configuration.
+     * These parts will be included as part of the cache key.
+     *
+     * @param entityConfiguration - The entity configuration used to derive cache key parts.
+     * @param value - The load value for which to create cache key parts for.
+     * @returns An object containing the cache key type and parts.
+     */
+    createCacheKeyPartsForLoadValue(entityConfiguration: EntityConfiguration<TFields, TIDField>, value: TLoadValue): readonly string[];
+    /**
+     * Gets the load method type of this key. Used as part of cache keys and data loader keys.
+     */
+    getLoadMethodType(): EntityLoadMethodType;
+    /**
+     * Gets the data loader key for this key. For single field keys, this is the field name. For composite keys, this is a
+     * unique identifier for the composite key.
+     */
+    getDataManagerDataLoaderKey(): string;
+    /**
+     * Serialize a load value for use in the data manager data loader as the dataloader value key.
+     */
+    serializeLoadValue(value: TLoadValue): TSerializedLoadValue;
+    /**
+     * Deserialize a load value for use in the data manager data loader as the dataloader value key.
+     */
+    deserializeLoadValue(value: TSerializedLoadValue): TLoadValue;
+    /**
+     * Validate that that the load values adhere to the typescript types at runtime in order to
+     * prevent inadvertently passing invalid values to the data loader, cache adapter, or database adapter.
+     * @param values - The load values to validate.
+     * @param entityClassName - The name of the entity class to which the load values belong (for error message only).
+     */
+    validateRuntimeLoadValuesForDataManagerDataLoader(values: readonly TLoadValue[], entityClassName: string): void;
+    /**
+     * Get the database columns for this key given an entity configuration.
+     *
+     * @param entityConfiguration - The entity configuration.
+     * @returns An array of database column names.
+     */
+    getDatabaseColumns(entityConfiguration: EntityConfiguration<TFields, TIDField>): readonly string[];
+    /**
+     * Get the database values corresponding to the database columns for this key for a load value.
+     *
+     * @param value - The load value.
+     * @returns An array of database values.
+     */
+    getDatabaseValues(value: TLoadValue): readonly any[];
+    /**
+     * Get the load value for an entity fields object from the database.
+     *
+     * @param object - The entity fields object.
+     * @returns The load value for the object or null if the load value would be invalid for the object (for example, if the value is null).
+     */
+    getLoadValueForObject(object: Readonly<TFields>): TLoadValue | null;
+}
+/**
+ * Interface for a load value corresponding to a load key.
+ */
+export interface IEntityLoadValue<TSerialized> extends ISerializable<TSerialized> {
+    toString(): string;
+}
+/**
+ * Map from load value interface to value.
+ */
+export declare abstract class LoadValueMap<TSerialized, TLoadValue extends IEntityLoadValue<TSerialized>, V> extends SerializableKeyMap<TSerialized, TLoadValue, V> {
+}
+/**
+ * Load pair type for a load key and load value.
+ */
+export type LoadPair<TFields extends Record<string, any>, TIDField extends keyof TFields, TLoadKey extends IEntityLoadKey<TFields, TIDField, TSerializedLoadValue, TLoadValue>, TSerializedLoadValue, TLoadValue extends IEntityLoadValue<TSerializedLoadValue>> = readonly [TLoadKey, TLoadValue];

package/build/internal/EntityLoadInterfaces.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadValueMap = exports.EntityLoadMethodType = void 0;
+const SerializableKeyMap_1 = require("../utils/collections/SerializableKeyMap");
+/**
+ * Load method type identifier of a load key. Used for keying data loaders and identification in metrics.
+ */
+var EntityLoadMethodType;
+(function (EntityLoadMethodType) {
+    /**
+     * Load method type for loading entities by single fieldName and fieldValue(s).
+     */
+    EntityLoadMethodType["SINGLE"] = "single";
+    /**
+     * Load method type for loading entities by composite field.
+     */
+    EntityLoadMethodType["COMPOSITE"] = "composite";
+})(EntityLoadMethodType || (exports.EntityLoadMethodType = EntityLoadMethodType = {}));
+/**
+ * Map from load value interface to value.
+ */
+class LoadValueMap extends SerializableKeyMap_1.SerializableKeyMap {
+}
+exports.LoadValueMap = LoadValueMap;
+//# sourceMappingURL=EntityLoadInterfaces.js.map

package/build/internal/EntityLoadInterfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLoadInterfaces.js","sourceRoot":"","sources":["../../src/internal/EntityLoadInterfaces.ts"],"names":[],"mappings":";;;AACA,gFAA4F;AAE5F;;GAEG;AACH,IAAY,oBAUX;AAVD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,yCAAiB,CAAA;IAEjB;;OAEG;IACH,+CAAuB,CAAA;AACzB,CAAC,EAVW,oBAAoB,oCAApB,oBAAoB,QAU/B;AA4GD;;GAEG;AACH,MAAsB,YAIpB,SAAQ,uCAA8C;CAAG;AAJ3D,oCAI2D"}

package/build/internal/EntityTableDataCoordinator.d.ts

@@ -11,12 +11,12 @@ import IEntityMetricsAdapter from '../metrics/IEntityMetricsAdapter';
  * table. Note that one instance is shared amongst all entities that read from
  * the table to ensure cross-entity data consistency.
  */
-export default class EntityTableDataCoordinator<TFields extends Record<string, any>> {
-    readonly entityConfiguration: EntityConfiguration<TFields>;
+export default class EntityTableDataCoordinator<TFields extends Record<string, any>, TIDField extends keyof TFields> {
+    readonly entityConfiguration: EntityConfiguration<TFields, TIDField>;
     private readonly queryContextProvider;
-    readonly databaseAdapter: EntityDatabaseAdapter<TFields>;
-    readonly cacheAdapter: IEntityCacheAdapter<TFields>;
-    readonly dataManager: EntityDataManager<TFields>;
-    constructor(entityConfiguration: EntityConfiguration<TFields>, databaseAdapterProvider: IEntityDatabaseAdapterProvider, cacheAdapterProvider: IEntityCacheAdapterProvider, queryContextProvider: EntityQueryContextProvider, metricsAdapter: IEntityMetricsAdapter, entityClassName: string);
+    readonly databaseAdapter: EntityDatabaseAdapter<TFields, TIDField>;
+    readonly cacheAdapter: IEntityCacheAdapter<TFields, TIDField>;
+    readonly dataManager: EntityDataManager<TFields, TIDField>;
+    constructor(entityConfiguration: EntityConfiguration<TFields, TIDField>, databaseAdapterProvider: IEntityDatabaseAdapterProvider, cacheAdapterProvider: IEntityCacheAdapterProvider, queryContextProvider: EntityQueryContextProvider, metricsAdapter: IEntityMetricsAdapter, entityClassName: string);
     getQueryContextProvider(): EntityQueryContextProvider;
 }

package/build/internal/EntityTableDataCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityTableDataCoordinator.js","sourceRoot":"","sources":["../../src/internal/EntityTableDataCoordinator.ts"],"names":[],"mappings":";;;;;AAAA,4EAAoD;AACpD,sFAA8D;AAS9D;;;;GAIG;AACH,MAAqB,0BAA0B;IAMlC;IAGQ;IARV,eAAe,CAAiC;IAChD,YAAY,CAA+B;IAC3C,WAAW,CAA6B;IAEjD,YACW,mBAAiD,EAC1D,uBAAuD,EACvD,oBAAiD,EAChC,oBAAgD,EACjE,cAAqC,EACrC,eAAuB;QALd,wBAAmB,GAAnB,mBAAmB,CAA8B;QAGzC,yBAAoB,GAApB,oBAAoB,CAA4B;QAIjE,IAAI,CAAC,eAAe,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;QACvF,IAAI,CAAC,YAAY,GAAG,oBAAoB,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAC9E,IAAI,CAAC,WAAW,GAAG,IAAI,2BAAiB,CACtC,IAAI,CAAC,eAAe,EACpB,IAAI,gCAAsB,CAAC,mBAAmB,EAAE,IAAI,CAAC,YAAY,CAAC,EAClE,oBAAoB,EACpB,cAAc,EACd,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;CACF;AA3BD,6CA2BC"}
+{"version":3,"file":"EntityTableDataCoordinator.js","sourceRoot":"","sources":["../../src/internal/EntityTableDataCoordinator.ts"],"names":[],"mappings":";;;;;AAAA,4EAAoD;AACpD,sFAA8D;AAS9D;;;;GAIG;AACH,MAAqB,0BAA0B;IASlC;IAGQ;IARV,eAAe,CAA2C;IAC1D,YAAY,CAAyC;IACrD,WAAW,CAAuC;IAE3D,YACW,mBAA2D,EACpE,uBAAuD,EACvD,oBAAiD,EAChC,oBAAgD,EACjE,cAAqC,EACrC,eAAuB;QALd,wBAAmB,GAAnB,mBAAmB,CAAwC;QAGnD,yBAAoB,GAApB,oBAAoB,CAA4B;QAIjE,IAAI,CAAC,eAAe,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;QACvF,IAAI,CAAC,YAAY,GAAG,oBAAoB,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAC9E,IAAI,CAAC,WAAW,GAAG,IAAI,2BAAiB,CACtC,IAAI,CAAC,eAAe,EACpB,IAAI,gCAAsB,CAAC,mBAAmB,EAAE,IAAI,CAAC,YAAY,CAAC,EAClE,oBAAoB,EACpB,cAAc,EACd,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;CACF;AA9BD,6CA8BC"}

package/build/internal/ReadThroughEntityCache.d.ts

@@ -1,11 +1,12 @@
 import EntityConfiguration from '../EntityConfiguration';
 import IEntityCacheAdapter from '../IEntityCacheAdapter';
+import { IEntityLoadKey, IEntityLoadValue } from './EntityLoadInterfaces';
 export declare enum CacheStatus {
     HIT = 0,
     MISS = 1,
     NEGATIVE = 2
 }
-export type CacheLoadResult<TFields> = {
+export type CacheLoadResult<TFields extends Record<string, any>> = {
     status: CacheStatus.HIT;
     item: Readonly<TFields>;
 } | {
@@ -17,33 +18,33 @@ export type CacheLoadResult<TFields> = {
  * A read-through entity cache is responsible for coordinating EntityDatabaseAdapter and
  * EntityCacheAdapter within the EntityDataManager.
  */
-export default class ReadThroughEntityCache<TFields extends Record<string, any>> {
+export default class ReadThroughEntityCache<TFields extends Record<string, any>, TIDField extends keyof TFields> {
     private readonly entityConfiguration;
     private readonly entityCacheAdapter;
-    constructor(entityConfiguration: EntityConfiguration<TFields>, entityCacheAdapter: IEntityCacheAdapter<TFields>);
-    private isFieldCacheable;
+    constructor(entityConfiguration: EntityConfiguration<TFields, TIDField>, entityCacheAdapter: IEntityCacheAdapter<TFields, TIDField>);
+    private isLoadKeyCacheable;
     /**
      * Read-through cache function. Steps:
      *
-     * 1. Check for cached (fieldName, fieldValue) objects
-     * 2. Query the fetcher for fieldValues not in the cache
+     * 1. Check for cached (key, value) objects
+     * 2. Query the fetcher for values not in the cache
      * 3. Cache the results from the fetcher
      * 4. Negatively cache anything missing from the fetcher
      * 5. Return the full set of data for the query.
      *
-     * If cache is not applicable for fieldName, return results from fetcher.
+     * If cache is not applicable for key, return results from fetcher.
      *
-     * @param fieldName - object field being queried
-     * @param fieldValues - fieldName field values being queried
-     * @param fetcher - closure used to provide underlying data source objects for fieldName and fetcherFieldValues
-     * @returns map from fieldValue to objects that match the query for that fieldValue
+     * @param key - load key being queried
+     * @param values - load values being queried
+     * @param fetcher - closure used to provide underlying data source objects for key and fetcherValues
+     * @returns map from value to objects that match the query for that value
      */
-    readManyThroughAsync<N extends keyof TFields>(fieldName: N, fieldValues: readonly NonNullable<TFields[N]>[], fetcher: (fetcherFieldValues: readonly NonNullable<TFields[N]>[]) => Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly Readonly<TFields>[]>>): Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly Readonly<TFields>[]>>;
+    readManyThroughAsync<TLoadKey extends IEntityLoadKey<TFields, TIDField, TSerializedLoadValue, TLoadValue>, TSerializedLoadValue, TLoadValue extends IEntityLoadValue<TSerializedLoadValue>>(key: TLoadKey, values: readonly TLoadValue[], fetcher: (fetcherValues: readonly TLoadValue[]) => Promise<ReadonlyMap<TLoadValue, readonly Readonly<TFields>[]>>): Promise<ReadonlyMap<TLoadValue, readonly Readonly<TFields>[]>>;
     /**
-     * Invalidate the cache for objects cached by (fieldName, fieldValue).
+     * Invalidate the cache for objects cached by (key, value).
      *
-     * @param fieldName - object field being queried
-     * @param fieldValues - fieldName field values to be invalidated
+     * @param key - load key to be invalidated
+     * @param values - load values to be invalidated for key
      */
-    invalidateManyAsync<N extends keyof TFields>(fieldName: N, fieldValues: readonly NonNullable<TFields[N]>[]): Promise<void>;
+    invalidateManyAsync<TLoadKey extends IEntityLoadKey<TFields, TIDField, TSerializedLoadValue, TLoadValue>, TSerializedLoadValue, TLoadValue extends IEntityLoadValue<TSerializedLoadValue>>(key: TLoadKey, values: readonly TLoadValue[]): Promise<void>;
 }

package/build/internal/ReadThroughEntityCache.js

@@ -23,81 +23,81 @@ class ReadThroughEntityCache {
         this.entityConfiguration = entityConfiguration;
         this.entityCacheAdapter = entityCacheAdapter;
     }
-    isFieldCacheable(fieldName) {
-        return this.entityConfiguration.cacheableKeys.has(fieldName);
+    isLoadKeyCacheable(key) {
+        return key.isCacheable(this.entityConfiguration);
     }
     /**
      * Read-through cache function. Steps:
      *
-     * 1. Check for cached (fieldName, fieldValue) objects
-     * 2. Query the fetcher for fieldValues not in the cache
+     * 1. Check for cached (key, value) objects
+     * 2. Query the fetcher for values not in the cache
      * 3. Cache the results from the fetcher
      * 4. Negatively cache anything missing from the fetcher
      * 5. Return the full set of data for the query.
      *
-     * If cache is not applicable for fieldName, return results from fetcher.
+     * If cache is not applicable for key, return results from fetcher.
      *
-     * @param fieldName - object field being queried
-     * @param fieldValues - fieldName field values being queried
-     * @param fetcher - closure used to provide underlying data source objects for fieldName and fetcherFieldValues
-     * @returns map from fieldValue to objects that match the query for that fieldValue
+     * @param key - load key being queried
+     * @param values - load values being queried
+     * @param fetcher - closure used to provide underlying data source objects for key and fetcherValues
+     * @returns map from value to objects that match the query for that value
      */
-    async readManyThroughAsync(fieldName, fieldValues, fetcher) {
-        // return normal fetch when cache by fieldName not supported
-        if (!this.isFieldCacheable(fieldName)) {
-            return await fetcher(fieldValues);
+    async readManyThroughAsync(key, values, fetcher) {
+        // return normal fetch when cache by key not supported
+        if (!this.isLoadKeyCacheable(key)) {
+            return await fetcher(values);
         }
-        const cacheLoadResults = await this.entityCacheAdapter.loadManyAsync(fieldName, fieldValues);
-        (0, invariant_1.default)(cacheLoadResults.size === fieldValues.length, `${this.constructor.name} loadMany should return a result for each fieldValue`);
-        const fieldValuesToFetchFromDB = Array.from((0, maps_1.filterMap)(cacheLoadResults, (cacheLoadResult) => cacheLoadResult.status === CacheStatus.MISS).keys());
+        const cacheLoadResults = await this.entityCacheAdapter.loadManyAsync(key, values);
+        (0, invariant_1.default)(cacheLoadResults.size === values.length, `${this.constructor.name} loadMany should return a result for each value`);
+        const valuesToFetchFromDB = Array.from((0, maps_1.filterMap)(cacheLoadResults, (cacheLoadResult) => cacheLoadResult.status === CacheStatus.MISS).keys());
         // put transformed cache hits in result map
-        const results = new Map();
-        cacheLoadResults.forEach((cacheLoadResult, fieldValue) => {
+        const results = key.vendNewLoadValueMap();
+        cacheLoadResults.forEach((cacheLoadResult, value) => {
             if (cacheLoadResult.status === CacheStatus.HIT) {
-                results.set(fieldValue, [cacheLoadResult.item]);
+                results.set(value, [cacheLoadResult.item]);
             }
         });
         // fetch any misses from DB, add DB objects to results, cache DB results, inform cache of any missing DB results
-        if (fieldValuesToFetchFromDB.length > 0) {
-            const dbFetchResults = await fetcher(fieldValuesToFetchFromDB);
-            const fieldValueDBMisses = fieldValuesToFetchFromDB.filter((fv) => {
+        if (valuesToFetchFromDB.length > 0) {
+            const dbFetchResults = await fetcher(valuesToFetchFromDB);
+            const valueDBMisses = valuesToFetchFromDB.filter((fv) => {
                 const objectsFromFulfillerForFv = dbFetchResults.get(fv);
                 return !objectsFromFulfillerForFv || objectsFromFulfillerForFv.length === 0;
             });
-            const objectsToCache = new Map();
-            for (const [fieldValue, objects] of dbFetchResults.entries()) {
+            const objectsToCache = key.vendNewLoadValueMap();
+            for (const [value, objects] of dbFetchResults.entries()) {
                 if (objects.length > 1) {
                     // multiple objects received for what was supposed to be a unique query, don't add to return map nor cache
                     // TODO(wschurman): emit or throw here since console may not be available
                     // eslint-disable-next-line no-console
-                    console.warn(`unique key ${String(fieldName)} in ${this.entityConfiguration.tableName} returned multiple rows for ${fieldValue}`);
+                    console.warn(`unique key ${key} in table ${this.entityConfiguration.tableName} returned multiple rows for ${value}`);
                     continue;
                 }
                 const uniqueObject = objects[0];
                 if (uniqueObject) {
-                    objectsToCache.set(fieldValue, uniqueObject);
-                    results.set(fieldValue, [uniqueObject]);
+                    objectsToCache.set(value, uniqueObject);
+                    results.set(value, [uniqueObject]);
                 }
             }
             await Promise.all([
-                this.entityCacheAdapter.cacheManyAsync(fieldName, objectsToCache),
-                this.entityCacheAdapter.cacheDBMissesAsync(fieldName, fieldValueDBMisses),
+                this.entityCacheAdapter.cacheManyAsync(key, objectsToCache),
+                this.entityCacheAdapter.cacheDBMissesAsync(key, valueDBMisses),
             ]);
         }
         return results;
     }
     /**
-     * Invalidate the cache for objects cached by (fieldName, fieldValue).
+     * Invalidate the cache for objects cached by (key, value).
      *
-     * @param fieldName - object field being queried
-     * @param fieldValues - fieldName field values to be invalidated
+     * @param key - load key to be invalidated
+     * @param values - load values to be invalidated for key
      */
-    async invalidateManyAsync(fieldName, fieldValues) {
-        // no-op when cache by fieldName not supported
-        if (!this.isFieldCacheable(fieldName)) {
+    async invalidateManyAsync(key, values) {
+        // no-op when cache by key not supported
+        if (!this.isLoadKeyCacheable(key)) {
             return;
         }
-        await this.entityCacheAdapter.invalidateManyAsync(fieldName, fieldValues);
+        await this.entityCacheAdapter.invalidateManyAsync(key, values);
     }
 }
 exports.default = ReadThroughEntityCache;

package/build/internal/ReadThroughEntityCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadThroughEntityCache.js","sourceRoot":"","sources":["../../src/internal/ReadThroughEntityCache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReadThroughEntityCache.js","sourceRoot":"","sources":["../../src/internal/ReadThroughEntityCache.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAkC;AAKlC,oDAAsD;AAEtD,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,2CAAG,CAAA;IACH,6CAAI,CAAA;IACJ,qDAAQ,CAAA;AACV,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAcD;;;GAGG;AACH,MAAqB,sBAAsB;IAKtB;IACA;IAFnB,YACmB,mBAA2D,EAC3D,kBAA0D;QAD1D,wBAAmB,GAAnB,mBAAmB,CAAwC;QAC3D,uBAAkB,GAAlB,kBAAkB,CAAwC;IAC1E,CAAC;IAEI,kBAAkB,CAIxB,GAAa;QACb,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,KAAK,CAAC,oBAAoB,CAK/B,GAAa,EACb,MAA6B,EAC7B,OAEmE;QAEnE,sDAAsD;QACtD,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAElF,IAAA,mBAAS,EACP,gBAAgB,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EACvC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,iDAAiD,CAC1E,CAAC;QAEF,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CACpC,IAAA,gBAAS,EACP,gBAAgB,EAChB,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,CACjE,CAAC,IAAI,EAAE,CACT,CAAC;QAEF,2CAA2C;QAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,mBAAmB,EAAgC,CAAC;QACxE,gBAAgB,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE;YAClD,IAAI,eAAe,CAAC,MAAM,KAAK,WAAW,CAAC,GAAG,EAAE,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,gHAAgH;QAChH,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAE1D,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;gBACtD,MAAM,yBAAyB,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzD,OAAO,CAAC,yBAAyB,IAAI,yBAAyB,CAAC,MAAM,KAAK,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,GAAG,CAAC,mBAAmB,EAAqB,CAAC;YACpE,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,0GAA0G;oBAC1G,yEAAyE;oBACzE,sCAAsC;oBACtC,OAAO,CAAC,IAAI,CACV,cAAc,GAAG,aACf,IAAI,CAAC,mBAAmB,CAAC,SAC3B,+BAA+B,KAAK,EAAE,CACvC,CAAC;oBACF,SAAS;gBACX,CAAC;gBACD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChC,IAAI,YAAY,EAAE,CAAC;oBACjB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;oBACxC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC;gBAC3D,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,EAAE,aAAa,CAAC;aAC/D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,mBAAmB,CAI9B,GAAa,EAAE,MAA6B;QAC5C,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;CACF;AA/HD,yCA+HC"}

package/build/internal/SingleFieldHolder.d.ts

@@ -0,0 +1,34 @@
+import EntityConfiguration from '../EntityConfiguration';
+import { EntityLoadMethodType, IEntityLoadKey, IEntityLoadValue, LoadValueMap } from './EntityLoadInterfaces';
+/**
+ * A load key that represents a single field (fieldName) on an entity.
+ */
+export declare class SingleFieldHolder<TFields extends Record<string, any>, TIDField extends keyof TFields, N extends keyof TFields> implements IEntityLoadKey<TFields, TIDField, NonNullable<TFields[N]>, SingleFieldValueHolder<TFields, N>> {
+    readonly fieldName: N;
+    constructor(fieldName: N);
+    toString(): string;
+    isCacheable(entityConfiguration: EntityConfiguration<TFields, TIDField>): boolean;
+    getDatabaseColumns(entityConfiguration: EntityConfiguration<TFields, TIDField>): string[];
+    getDatabaseValues(value: SingleFieldValueHolder<TFields, N>): readonly any[];
+    getLoadValueForObject(object: Readonly<TFields>): SingleFieldValueHolder<TFields, N> | null;
+    createCacheKeyPartsForLoadValue(entityConfiguration: EntityConfiguration<TFields, TIDField>, value: SingleFieldValueHolder<TFields, N>): readonly string[];
+    getLoadMethodType(): EntityLoadMethodType;
+    getDataManagerDataLoaderKey(): string;
+    serializeLoadValue(value: SingleFieldValueHolder<TFields, N>): NonNullable<TFields[N]>;
+    deserializeLoadValue(value: NonNullable<TFields[N]>): SingleFieldValueHolder<TFields, N>;
+    validateRuntimeLoadValuesForDataManagerDataLoader(values: readonly SingleFieldValueHolder<TFields, N>[], entityClassName: string): void;
+    vendNewLoadValueMap<V>(): LoadValueMap<NonNullable<TFields[N]>, SingleFieldValueHolder<TFields, N>, V>;
+}
+/**
+ * A load value for a SingleFieldHolder.
+ */
+export declare class SingleFieldValueHolder<TFields extends Record<string, any>, N extends keyof TFields> implements IEntityLoadValue<NonNullable<TFields[N]>> {
+    readonly fieldValue: NonNullable<TFields[N]>;
+    constructor(fieldValue: NonNullable<TFields[N]>);
+    toString(): string;
+    serialize(): NonNullable<TFields[N]>;
+    static deserialize<TFields extends Record<string, any>, N extends keyof TFields>(fieldValue: NonNullable<TFields[N]>): SingleFieldValueHolder<TFields, N>;
+}
+export declare class SingleFieldValueHolderMap<TFields extends Record<string, any>, N extends keyof TFields, V> extends LoadValueMap<NonNullable<TFields[N]>, SingleFieldValueHolder<TFields, N>, V> {
+    protected deserializeKey(serializedKey: NonNullable<TFields[N]>): SingleFieldValueHolder<TFields, N>;
+}

package/build/internal/SingleFieldHolder.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SingleFieldValueHolderMap = exports.SingleFieldValueHolder = exports.SingleFieldHolder = void 0;
+const invariant_1 = __importDefault(require("invariant"));
+const EntityFieldTransformationUtils_1 = require("./EntityFieldTransformationUtils");
+const EntityLoadInterfaces_1 = require("./EntityLoadInterfaces");
+/**
+ * A load key that represents a single field (fieldName) on an entity.
+ */
+class SingleFieldHolder {
+    fieldName;
+    constructor(fieldName) {
+        this.fieldName = fieldName;
+    }
+    toString() {
+        return `SingleField(${String(this.fieldName)})`;
+    }
+    isCacheable(entityConfiguration) {
+        return entityConfiguration.cacheableKeys.has(this.fieldName);
+    }
+    getDatabaseColumns(entityConfiguration) {
+        return [(0, EntityFieldTransformationUtils_1.getDatabaseFieldForEntityField)(entityConfiguration, this.fieldName)];
+    }
+    getDatabaseValues(value) {
+        return [value.fieldValue];
+    }
+    getLoadValueForObject(object) {
+        const value = object[this.fieldName];
+        if (value === null || value === undefined) {
+            return null;
+        }
+        return new SingleFieldValueHolder(value);
+    }
+    createCacheKeyPartsForLoadValue(entityConfiguration, value) {
+        const columnName = entityConfiguration.entityToDBFieldsKeyMapping.get(this.fieldName);
+        (0, invariant_1.default)(columnName, `database field mapping missing for ${String(this.fieldName)}`);
+        return [columnName, String(value.fieldValue)];
+    }
+    getLoadMethodType() {
+        return EntityLoadInterfaces_1.EntityLoadMethodType.SINGLE;
+    }
+    getDataManagerDataLoaderKey() {
+        return this.fieldName;
+    }
+    serializeLoadValue(value) {
+        return value.serialize();
+    }
+    deserializeLoadValue(value) {
+        return SingleFieldValueHolder.deserialize(value);
+    }
+    validateRuntimeLoadValuesForDataManagerDataLoader(values, entityClassName) {
+        const nullOrUndefinedValueIndex = values.findIndex((value) => value.fieldValue === null || value.fieldValue === undefined);
+        if (nullOrUndefinedValueIndex >= 0) {
+            throw new Error(`Invalid load: ${entityClassName} (${String(this.fieldName)} = ${values[nullOrUndefinedValueIndex]?.fieldValue})`);
+        }
+    }
+    vendNewLoadValueMap() {
+        return new SingleFieldValueHolderMap();
+    }
+}
+exports.SingleFieldHolder = SingleFieldHolder;
+/**
+ * A load value for a SingleFieldHolder.
+ */
+class SingleFieldValueHolder {
+    fieldValue;
+    constructor(fieldValue) {
+        this.fieldValue = fieldValue;
+    }
+    toString() {
+        return `SingleFieldValue(${String(this.fieldValue)})`;
+    }
+    serialize() {
+        return this.fieldValue;
+    }
+    static deserialize(fieldValue) {
+        return new SingleFieldValueHolder(fieldValue);
+    }
+}
+exports.SingleFieldValueHolder = SingleFieldValueHolder;
+class SingleFieldValueHolderMap extends EntityLoadInterfaces_1.LoadValueMap {
+    deserializeKey(serializedKey) {
+        return SingleFieldValueHolder.deserialize(serializedKey);
+    }
+}
+exports.SingleFieldValueHolderMap = SingleFieldValueHolderMap;
+//# sourceMappingURL=SingleFieldHolder.js.map

package/build/internal/SingleFieldHolder.js.map

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

package/build/metrics/EntityMetricsUtils.d.ts

@@ -1,4 +1,5 @@
 import IEntityMetricsAdapter, { EntityMetricsLoadType, EntityMetricsMutationType } from './IEntityMetricsAdapter';
+import { IEntityLoadValue } from '../internal/EntityLoadInterfaces';
 export declare const timeAndLogLoadEventAsync: (metricsAdapter: IEntityMetricsAdapter, loadType: EntityMetricsLoadType, entityClassName: string) => <TFields>(promise: Promise<readonly Readonly<TFields>[]>) => Promise<readonly Readonly<TFields>[]>;
-export declare const timeAndLogLoadMapEventAsync: (metricsAdapter: IEntityMetricsAdapter, loadType: EntityMetricsLoadType, entityClassName: string) => <TFields, N extends keyof TFields>(promise: Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly Readonly<TFields>[]>>) => Promise<ReadonlyMap<NonNullable<TFields[N]>, readonly Readonly<TFields>[]>>;
+export declare const timeAndLogLoadMapEventAsync: (metricsAdapter: IEntityMetricsAdapter, loadType: EntityMetricsLoadType, entityClassName: string) => <TFields extends Record<string, any>, TSerializedLoadValue, TLoadValue extends IEntityLoadValue<TSerializedLoadValue>>(promise: Promise<ReadonlyMap<TLoadValue, readonly Readonly<TFields>[]>>) => Promise<ReadonlyMap<TLoadValue, readonly Readonly<TFields>[]>>;
 export declare const timeAndLogMutationEventAsync: (metricsAdapter: IEntityMetricsAdapter, mutationType: EntityMetricsMutationType, entityClassName: string) => <T>(promise: Promise<T>) => Promise<T>;

package/build/metrics/EntityMetricsUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityMetricsUtils.js","sourceRoot":"","sources":["../../src/metrics/EntityMetricsUtils.ts"],"names":[],"mappings":";;;AAIA,oDAAsD;AAE/C,MAAM,wBAAwB,GACnC,CACE,cAAqC,EACrC,QAA+B,EAC/B,eAAuB,EACvB,EAAE,CACJ,KAAK,EAAW,OAA8C,EAAE,EAAE;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,QAAQ;QACd,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBS,QAAA,wBAAwB,4BAmBjC;AAEG,MAAM,2BAA2B,GACtC,CACE,cAAqC,EACrC,QAA+B,EAC/B,eAAuB,EACvB,EAAE,CACJ,KAAK,EACH,OAAoF,EACpF,EAAE;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,IAAA,gBAAS,EAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE/D,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,QAAQ;QACd,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;QAC7B,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAvBS,QAAA,2BAA2B,+BAuBpC;AAEG,MAAM,4BAA4B,GACvC,CACE,cAAqC,EACrC,YAAuC,EACvC,eAAuB,EACvB,EAAE,CACJ,KAAK,EAAK,OAAmB,EAAE,EAAE;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,YAAY;QAClB,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAlBS,QAAA,4BAA4B,gCAkBrC"}
+{"version":3,"file":"EntityMetricsUtils.js","sourceRoot":"","sources":["../../src/metrics/EntityMetricsUtils.ts"],"names":[],"mappings":";;;AAKA,oDAAsD;AAE/C,MAAM,wBAAwB,GACnC,CACE,cAAqC,EACrC,QAA+B,EAC/B,eAAuB,EACvB,EAAE,CACJ,KAAK,EAAW,OAA8C,EAAE,EAAE;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,QAAQ;QACd,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;QAC7B,KAAK,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAnBS,QAAA,wBAAwB,4BAmBjC;AAEG,MAAM,2BAA2B,GACtC,CACE,cAAqC,EACrC,QAA+B,EAC/B,eAAuB,EACvB,EAAE,CACJ,KAAK,EAKH,OAAuE,EACvE,EAAE;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,IAAA,gBAAS,EAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE/D,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,QAAQ;QACd,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;QAC7B,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AA3BS,QAAA,2BAA2B,+BA2BpC;AAEG,MAAM,4BAA4B,GACvC,CACE,cAAqC,EACrC,YAAuC,EACvC,eAAuB,EACvB,EAAE,CACJ,KAAK,EAAK,OAAmB,EAAE,EAAE;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,cAAc,CAAC,uBAAuB,CAAC;QACrC,IAAI,EAAE,YAAY;QAClB,eAAe;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAlBS,QAAA,4BAA4B,gCAkBrC"}

package/build/metrics/IEntityMetricsAdapter.d.ts

@@ -1,4 +1,5 @@
 import { EntityAuthorizationAction, EntityPrivacyPolicyEvaluationMode } from '../EntityPrivacyPolicy';
+import { EntityLoadMethodType } from '../internal/EntityLoadInterfaces';
 export declare enum EntityMetricsLoadType {
     LOAD_MANY = 0,
     LOAD_MANY_EQUALITY_CONJUNCTION = 1,
@@ -67,6 +68,10 @@ export interface IncrementLoadCountEvent {
      * Type of this event.
      */
     type: IncrementLoadCountEventType;
+    /**
+     * Load method type for this event.
+     */
+    loadType: EntityLoadMethodType;
     /**
      * Number of field values being loaded for this call.
      */

package/build/metrics/IEntityMetricsAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"IEntityMetricsAdapter.js","sourceRoot":"","sources":["../../src/metrics/IEntityMetricsAdapter.ts"],"names":[],"mappings":";;;AAKA,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,2EAAS,CAAA;IACT,qHAA8B,CAAA;IAC9B,mFAAa,CAAA;AACf,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AA2BD,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACnC,6EAAM,CAAA;IACN,6EAAM,CAAA;IACN,6EAAM,CAAA;AACR,CAAC,EAJW,yBAAyB,yCAAzB,yBAAyB,QAIpC;AAmBD,IAAY,2BAgBX;AAhBD,WAAY,2BAA2B;IACrC;;;OAGG;IACH,yFAAU,CAAA;IAEV;;OAEG;IACH,+EAAK,CAAA;IAEL;;OAEG;IACH,qFAAQ,CAAA;AACV,CAAC,EAhBW,2BAA2B,2CAA3B,2BAA2B,QAgBtC;AAsBD,IAAY,gCAGX;AAHD,WAAY,gCAAgC;IAC1C,uFAAI,CAAA;IACJ,yFAAK,CAAA;AACP,CAAC,EAHW,gCAAgC,gDAAhC,gCAAgC,QAG3C"}
+{"version":3,"file":"IEntityMetricsAdapter.js","sourceRoot":"","sources":["../../src/metrics/IEntityMetricsAdapter.ts"],"names":[],"mappings":";;;AAMA,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,2EAAS,CAAA;IACT,qHAA8B,CAAA;IAC9B,mFAAa,CAAA;AACf,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AA2BD,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACnC,6EAAM,CAAA;IACN,6EAAM,CAAA;IACN,6EAAM,CAAA;AACR,CAAC,EAJW,yBAAyB,yCAAzB,yBAAyB,QAIpC;AAmBD,IAAY,2BAgBX;AAhBD,WAAY,2BAA2B;IACrC;;;OAGG;IACH,yFAAU,CAAA;IAEV;;OAEG;IACH,+EAAK,CAAA;IAEL;;OAEG;IACH,qFAAQ,CAAA;AACV,CAAC,EAhBW,2BAA2B,2CAA3B,2BAA2B,QAgBtC;AA2BD,IAAY,gCAGX;AAHD,WAAY,gCAAgC;IAC1C,uFAAI,CAAA;IACJ,yFAAK,CAAA;AACP,CAAC,EAHW,gCAAgC,gDAAhC,gCAAgC,QAG3C"}

package/build/rules/AlwaysAllowPrivacyPolicyRule.d.ts

@@ -6,6 +6,6 @@ import ViewerContext from '../ViewerContext';
 /**
  * Privacy policy rule that always allows.
  */
-export default class AlwaysAllowPrivacyPolicyRule<TFields extends object, TID extends NonNullable<TFields[TSelectedFields]>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields> extends PrivacyPolicyRule<TFields, TID, TViewerContext, TEntity, TSelectedFields> {
-    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
+export default class AlwaysAllowPrivacyPolicyRule<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 PrivacyPolicyRule<TFields, TIDField, TViewerContext, TEntity, TSelectedFields> {
+    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
 }

package/build/rules/AlwaysAllowPrivacyPolicyRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AlwaysAllowPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysAllowPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,4BAMnB,SAAQ,2BAAyE;IACjF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,KAAK,CAAC;IACpC,CAAC;CACF;AArBD,+CAqBC"}
+{"version":3,"file":"AlwaysAllowPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysAllowPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,4BAMnB,SAAQ,2BAA8E;IACtF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,KAAK,CAAC;IACpC,CAAC;CACF;AArBD,+CAqBC"}

package/build/rules/AlwaysDenyPrivacyPolicyRule.d.ts

@@ -6,6 +6,6 @@ import ViewerContext from '../ViewerContext';
 /**
  * Privacy policy rule that always denies.
  */
-export default class AlwaysDenyPrivacyPolicyRule<TFields extends object, TID extends NonNullable<TFields[TSelectedFields]>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields> extends PrivacyPolicyRule<TFields, TID, TViewerContext, TEntity, TSelectedFields> {
-    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
+export default class AlwaysDenyPrivacyPolicyRule<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 PrivacyPolicyRule<TFields, TIDField, TViewerContext, TEntity, TSelectedFields> {
+    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
 }

package/build/rules/AlwaysDenyPrivacyPolicyRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AlwaysDenyPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysDenyPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,2BAMnB,SAAQ,2BAAyE;IACjF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,IAAI,CAAC;IACnC,CAAC;CACF;AArBD,8CAqBC"}
+{"version":3,"file":"AlwaysDenyPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysDenyPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,2BAMnB,SAAQ,2BAA8E;IACtF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,IAAI,CAAC;IACnC,CAAC;CACF;AArBD,8CAqBC"}

package/build/rules/AlwaysSkipPrivacyPolicyRule.d.ts

@@ -6,6 +6,6 @@ import ViewerContext from '../ViewerContext';
 /**
  * A no-op policy rule that always skips.
  */
-export default class AlwaysSkipPrivacyPolicyRule<TFields extends object, TID extends NonNullable<TFields[TSelectedFields]>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields> extends PrivacyPolicyRule<TFields, TID, TViewerContext, TEntity, TSelectedFields> {
-    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
+export default class AlwaysSkipPrivacyPolicyRule<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 PrivacyPolicyRule<TFields, TIDField, TViewerContext, TEntity, TSelectedFields> {
+    evaluateAsync(_viewerContext: TViewerContext, _queryContext: EntityQueryContext, _evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, _entity: TEntity): Promise<RuleEvaluationResult>;
 }

package/build/rules/AlwaysSkipPrivacyPolicyRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AlwaysSkipPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysSkipPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,2BAMnB,SAAQ,2BAAyE;IACjF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,IAAI,CAAC;IACnC,CAAC;CACF;AArBD,8CAqBC"}
+{"version":3,"file":"AlwaysSkipPrivacyPolicyRule.js","sourceRoot":"","sources":["../../src/rules/AlwaysSkipPrivacyPolicyRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yEAA8E;AAM9E;;GAEG;AACH,MAAqB,2BAMnB,SAAQ,2BAA8E;IACtF,KAAK,CAAC,aAAa,CACjB,cAA8B,EAC9B,aAAiC,EACjC,kBAMC,EACD,OAAgB;QAEhB,OAAO,wCAAoB,CAAC,IAAI,CAAC;IACnC,CAAC;CACF;AArBD,8CAqBC"}

package/build/rules/PrivacyPolicyRule.d.ts

@@ -32,6 +32,6 @@ export declare enum RuleEvaluationResult {
  * - Blocking. For example, a user blocks another user from seeing their posts, and the rule
  *   would be named something like `DenyIfViewerHasBeenBlockedPrivacyPolicyRule`.
  */
-export default abstract class PrivacyPolicyRule<TFields extends object, TID extends NonNullable<TFields[TSelectedFields]>, TViewerContext extends ViewerContext, TEntity extends ReadonlyEntity<TFields, TID, TViewerContext, TSelectedFields>, TSelectedFields extends keyof TFields = keyof TFields> {
-    abstract evaluateAsync(viewerContext: TViewerContext, queryContext: EntityQueryContext, evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TID, TViewerContext, TEntity, TSelectedFields>, entity: TEntity): Promise<RuleEvaluationResult>;
+export default abstract class PrivacyPolicyRule<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> {
+    abstract evaluateAsync(viewerContext: TViewerContext, queryContext: EntityQueryContext, evaluationContext: EntityPrivacyPolicyEvaluationContext<TFields, TIDField, TViewerContext, TEntity, TSelectedFields>, entity: TEntity): Promise<RuleEvaluationResult>;
 }