@karmaniverous/entity-manager 6.13.3 → 6.14.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { EntityMap, TranscodeMap, ConditionalProperty, Exactify, PropertiesOfType, TranscodableProperties, FlattenEntityMap, Transcodes, SortOrder, MutuallyExclusive, NotNever, DefaultTranscodeMap } from '@karmaniverous/entity-tools';
-import { BatchProcessOptions } from '@karmaniverous/batch-process';
+import { EntityMap, TranscodeMap, ConditionalProperty, Exactify, PropertiesOfType, TranscodableProperties, FlattenEntityMap, Transcodes, MutuallyExclusive, NotNever, DefaultTranscodeMap, SortOrder } from '@karmaniverous/entity-tools';
 import { z } from 'zod';
+import { BatchProcessOptions } from '@karmaniverous/batch-process';
 
 /**
  * Default type parameter for {@link ConfigMap | `ConfigMap`}.
@@ -76,6 +76,47 @@ type Config<C extends BaseConfigMap = BaseConfigMap> = ConditionalProperty<'enti
     throttle?: number;
 };
 
+/**
+ * Validates a type derived from {@link BaseConfigMap | `BaseConfigMap`} to ensure HashKey and RangeKey are both defined and that all sets of special keys are mutually exclusive.
+ *
+ * @typeParam C - {@link ConfigMap | `ConfigMap`} that defines an {@link Config | `EntityManager configuration`}'s {@link EntityMap | `EntityMap`}, key properties, and {@link TranscodeMap | `TranscodeMap`}. If omitted, defaults to {@link BaseConfigMap | `BaseConfigMap`}.
+ *
+ * @category EntityManager
+ * @protected
+ */
+type ValidateConfigMap<C extends BaseConfigMap> = MutuallyExclusive<[
+    C['HashKey'],
+    C['RangeKey'],
+    C['ShardedKeys'],
+    C['UnshardedKeys'],
+    keyof FlattenEntityMap<C['EntityMap']>
+]> extends true ? NotNever<C, ['HashKey' | 'RangeKey']> extends true ? C : Exclude<NotNever<C, ['HashKey' | 'RangeKey']>, true> : Exclude<MutuallyExclusive<[
+    C['HashKey'],
+    C['RangeKey'],
+    C['ShardedKeys'],
+    C['UnshardedKeys'],
+    keyof FlattenEntityMap<C['EntityMap']>
+]>, true>;
+
+/**
+ * Generates & validates the map defining defines an {@link EntityManager | `EntityManager`} configuration's {@link EntityMap | `EntityMap`}, key properties, and {@link TranscodeMap | `TranscodeMap`}.
+ *
+ * Unspecified properties will default to those defined in {@link BaseConfigMap | `BaseConfigMap`}.
+ *
+ * @typeParam M - {@link BaseConfigMap | `BaseConfigMap`} extension. If omitted, defaults to {@link BaseConfigMap | `BaseConfigMap`}.
+ *
+ * @category EntityManager
+ */
+type ConfigMap<M extends Partial<BaseConfigMap> = Partial<BaseConfigMap>> = ValidateConfigMap<{
+    EntityMap: 'EntityMap' extends keyof M ? NonNullable<M['EntityMap']> : Record<string, never>;
+    HashKey: 'HashKey' extends keyof M ? NonNullable<M['HashKey']> : 'hashKey';
+    RangeKey: 'RangeKey' extends keyof M ? NonNullable<M['RangeKey']> : 'rangeKey';
+    ShardedKeys: 'ShardedKeys' extends keyof M ? NonNullable<M['ShardedKeys']> : never;
+    UnshardedKeys: 'UnshardedKeys' extends keyof M ? NonNullable<M['UnshardedKeys']> : never;
+    TranscodedProperties: 'TranscodedProperties' extends keyof M ? NonNullable<M['TranscodedProperties']> : never;
+    TranscodeMap: 'TranscodeMap' extends keyof M ? NonNullable<M['TranscodeMap']> : DefaultTranscodeMap;
+}>;
+
 /**
  * Extracts a database-facing partial item type from a {@link BaseConfigMap | `ConfigMap`}.
  *
@@ -116,39 +157,15 @@ type EntityRecord<C extends BaseConfigMap> = EntityItem<C> & EntityKey<C>;
  */
 type EntityToken<C extends BaseConfigMap> = keyof Exactify<C['EntityMap']> & string;
 
-declare const configSchema: z.ZodEffects<z.ZodObject<{
+declare const configSchema: z.ZodObject<{
     entities: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         defaultLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         defaultPageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        shardBumps: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        shardBumps: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
             timestamp: z.ZodNumber;
             charBits: z.ZodNumber;
             chars: z.ZodNumber;
-        }, "strict", z.ZodTypeAny, {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }, {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }>, "many">>>, {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[], {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[] | undefined>, {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[], {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[] | undefined>, {
+        }, z.core.$strict>>>>, z.ZodTransform<{
             timestamp: number;
             charBits: number;
             chars: number;
@@ -156,54 +173,20 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
             timestamp: number;
             charBits: number;
             chars: number;
-        }[] | undefined>;
+        }[]>>;
         timestampProperty: z.ZodString;
         uniqueProperty: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        defaultLimit: number;
-        defaultPageSize: number;
-        shardBumps: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[];
-        timestampProperty: string;
-        uniqueProperty: string;
-    }, {
-        timestampProperty: string;
-        uniqueProperty: string;
-        defaultLimit?: number | undefined;
-        defaultPageSize?: number | undefined;
-        shardBumps?: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[] | undefined;
-    }>>>>;
+    }, z.core.$strict>>>>;
     generatedProperties: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        sharded: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodArray<z.ZodString, "atleastone">, [string, ...string[]], [string, ...string[]]>>>>;
-        unsharded: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodArray<z.ZodString, "atleastone">, [string, ...string[]], [string, ...string[]]>>>>;
-    }, "strip", z.ZodTypeAny, {
-        sharded: Record<string, [string, ...string[]]>;
-        unsharded: Record<string, [string, ...string[]]>;
-    }, {
-        sharded?: Record<string, [string, ...string[]]> | undefined;
-        unsharded?: Record<string, [string, ...string[]]> | undefined;
-    }>>>;
+        sharded: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+        unsharded: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+    }, z.core.$strip>>>;
     hashKey: z.ZodString;
     indexes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         hashKey: z.ZodString;
         rangeKey: z.ZodString;
-        projections: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
-    }, "strip", z.ZodTypeAny, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }>>>>;
+        projections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>>;
     generatedKeyDelimiter: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     generatedValueDelimiter: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     propertyTranscodes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
@@ -211,144 +194,10 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     shardKeyDelimiter: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     throttle: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     transcodes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        encode: z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodString>;
-        decode: z.ZodFunction<z.ZodTuple<[z.ZodString], z.ZodUnknown>, z.ZodAny>;
-    }, "strict", z.ZodTypeAny, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }>>>>;
-}, "strict", z.ZodTypeAny, {
-    hashKey: string;
-    rangeKey: string;
-    entities: Record<string, {
-        defaultLimit: number;
-        defaultPageSize: number;
-        shardBumps: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[];
-        timestampProperty: string;
-        uniqueProperty: string;
-    }>;
-    generatedProperties: {
-        sharded: Record<string, [string, ...string[]]>;
-        unsharded: Record<string, [string, ...string[]]>;
-    };
-    indexes: Record<string, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }>;
-    generatedKeyDelimiter: string;
-    generatedValueDelimiter: string;
-    propertyTranscodes: Record<string, string>;
-    shardKeyDelimiter: string;
-    throttle: number;
-    transcodes: Record<string, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }>;
-}, {
-    hashKey: string;
-    rangeKey: string;
-    entities?: Record<string, {
-        timestampProperty: string;
-        uniqueProperty: string;
-        defaultLimit?: number | undefined;
-        defaultPageSize?: number | undefined;
-        shardBumps?: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[] | undefined;
-    }> | undefined;
-    generatedProperties?: {
-        sharded?: Record<string, [string, ...string[]]> | undefined;
-        unsharded?: Record<string, [string, ...string[]]> | undefined;
-    } | undefined;
-    indexes?: Record<string, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }> | undefined;
-    generatedKeyDelimiter?: string | undefined;
-    generatedValueDelimiter?: string | undefined;
-    propertyTranscodes?: Record<string, string> | undefined;
-    shardKeyDelimiter?: string | undefined;
-    throttle?: number | undefined;
-    transcodes?: Record<string, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }> | undefined;
-}>, {
-    hashKey: string;
-    rangeKey: string;
-    entities: Record<string, {
-        defaultLimit: number;
-        defaultPageSize: number;
-        shardBumps: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[];
-        timestampProperty: string;
-        uniqueProperty: string;
-    }>;
-    generatedProperties: {
-        sharded: Record<string, [string, ...string[]]>;
-        unsharded: Record<string, [string, ...string[]]>;
-    };
-    indexes: Record<string, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }>;
-    generatedKeyDelimiter: string;
-    generatedValueDelimiter: string;
-    propertyTranscodes: Record<string, string>;
-    shardKeyDelimiter: string;
-    throttle: number;
-    transcodes: Record<string, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }>;
-}, {
-    hashKey: string;
-    rangeKey: string;
-    entities?: Record<string, {
-        timestampProperty: string;
-        uniqueProperty: string;
-        defaultLimit?: number | undefined;
-        defaultPageSize?: number | undefined;
-        shardBumps?: {
-            timestamp: number;
-            charBits: number;
-            chars: number;
-        }[] | undefined;
-    }> | undefined;
-    generatedProperties?: {
-        sharded?: Record<string, [string, ...string[]]> | undefined;
-        unsharded?: Record<string, [string, ...string[]]> | undefined;
-    } | undefined;
-    indexes?: Record<string, {
-        hashKey: string;
-        rangeKey: string;
-        projections?: string[] | undefined;
-    }> | undefined;
-    generatedKeyDelimiter?: string | undefined;
-    generatedValueDelimiter?: string | undefined;
-    propertyTranscodes?: Record<string, string> | undefined;
-    shardKeyDelimiter?: string | undefined;
-    throttle?: number | undefined;
-    transcodes?: Record<string, {
-        encode: (args_0: any, ...args: unknown[]) => string;
-        decode: (args_0: string, ...args: unknown[]) => any;
-    }> | undefined;
-}>;
+        encode: z.ZodCustom<unknown, unknown>;
+        decode: z.ZodCustom<unknown, unknown>;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>;
 /**
  * Simplified type taken on by a {@link Config | `Config`} object after parsing in the {@link EntityManager | `EntityManager`} constructor.
  *
@@ -521,6 +370,7 @@ interface QueryResult<C extends BaseConfigMap> {
  */
 declare class EntityManager<C extends BaseConfigMap> {
     #private;
+    /** Logger object (defaults to `console`, must support `debug` & `error` methods). */
     readonly logger: Pick<Console, 'debug' | 'error'>;
     /**
      * Create an EntityManager instance.
@@ -544,12 +394,12 @@ declare class EntityManager<C extends BaseConfigMap> {
     /**
      * Encode a generated property value. Returns a string or undefined if atomicity requirement of sharded properties not met.
      *
-     * @param property - {@link Config.generatedProperties | Generated property} key.
+     * @param property - {@link Config | Config} `generatedProperties` key.
      * @param item - {@link EntityItem | `EntityItem`} object.
      *
      * @returns Encoded generated property value.
      *
-     * @throws `Error` if `property` is not a {@link Config.generatedProperties | generated property}.
+     * @throws `Error` if `property` is not a {@link Config | Config} `generatedProperties` key.
      */
     encodeGeneratedProperty<C extends BaseConfigMap>(property: C['ShardedKeys'] | C['UnshardedKeys'], item: EntityItem<C>): string | undefined;
     /**
@@ -562,8 +412,24 @@ declare class EntityManager<C extends BaseConfigMap> {
      * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
      *
      * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
      */
     addKeys(entityToken: EntityToken<C>, item: EntityItem<C>, overwrite?: boolean): EntityRecord<C>;
+    /**
+     * Update generated properties, hash key, and range key on an array of {@link EntityItem | `EntityItem`} objects.
+     *
+     * @param entityToken - {@link Config | `Config`} `entities` key.
+     * @param item - Array of {@link EntityItem | `EntityItem`} objects.
+     * @param overwrite - Overwrite existing properties (default `false`).
+     *
+     * @returns An array of {@link EntityRecord | `EntityRecord`} objects with updated properties.
+     *
+     * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
+     */
+    addKeys(entityToken: EntityToken<C>, item: EntityItem<C>[], overwrite?: boolean): EntityRecord<C>[];
     /**
      * Convert an {@link EntityItem | `EntityItem`} into an {@link EntityKey | `EntityKey`}.
      *
@@ -574,8 +440,24 @@ declare class EntityManager<C extends BaseConfigMap> {
      * @returns {@link EntityKey | `EntityKey`} extracted from shallow clone of `item` with updated properties.
      *
      * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
      */
     getPrimaryKey(entityToken: EntityToken<C>, item: EntityItem<C>, overwrite?: boolean): EntityKey<C>;
+    /**
+     * Convert an array of {@link EntityItem | `EntityItem`} objects into {@link EntityKey | `EntityKey`} objects.
+     *
+     * @param entityToken - {@link Config | `Config`} `entities` key.
+     * @param items - Array of {@link EntityItem | `EntityItem`} objects.
+     * @param overwrite - Overwrite existing properties (default `false`).
+     *
+     * @returns An array of {@link EntityKey | `EntityKey`} objects extracted from shallow clone of each `item` with updated properties.
+     *
+     * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
+     */
+    getPrimaryKey(entityToken: EntityToken<C>, items: EntityItem<C>[], overwrite?: boolean): EntityKey<C>[];
     /**
      * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
      *
@@ -585,8 +467,23 @@ declare class EntityManager<C extends BaseConfigMap> {
      * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
      *
      * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
      */
     removeKeys(entityToken: EntityToken<C>, item: EntityRecord<C>): EntityItem<C>;
+    /**
+     * Strips generated properties, hash key, and range key from an array of {@link EntityRecord | `EntityRecord`} objects.
+     *
+     * @param entityToken - {@link Config | `Config`} `entities` key.
+     * @param items - Array of {@link EntityRecord | `EntityRecord`} objects.
+     *
+     * @returns Array of {@link EntityItem | `EntityItem`} objects with generated properties, hash key & range key removed.
+     *
+     * @throws `Error` if `entityToken` is invalid.
+     *
+     * @overload
+     */
+    removeKeys(entityToken: EntityToken<C>, items: EntityRecord<C>[]): EntityItem<C>[];
     /**
      * Find an index token in a {@link Config | `Config`} object based on the index `hashKey` and `rangeKey`.
      *
@@ -728,45 +625,5 @@ declare abstract class BaseQueryBuilder<C extends BaseConfigMap, EntityClient ex
     query(options: QueryBuilderQueryOptions<C>): Promise<QueryResult<C>>;
 }
 
-/**
- * Validates a type derived from {@link BaseConfigMap | `BaseConfigMap`} to ensure HashKey and RangeKey are both defined and that all sets of special keys are mutually exclusive.
- *
- * @typeParam C - {@link ConfigMap | `ConfigMap`} that defines an {@link Config | `EntityManager configuration`}'s {@link EntityMap | `EntityMap`}, key properties, and {@link TranscodeMap | `TranscodeMap`}. If omitted, defaults to {@link BaseConfigMap | `BaseConfigMap`}.
- *
- * @category EntityManager
- * @protected
- */
-type ValidateConfigMap<C extends BaseConfigMap> = MutuallyExclusive<[
-    C['HashKey'],
-    C['RangeKey'],
-    C['ShardedKeys'],
-    C['UnshardedKeys'],
-    keyof FlattenEntityMap<C['EntityMap']>
-]> extends true ? NotNever<C, ['HashKey' | 'RangeKey']> extends true ? C : Exclude<NotNever<C, ['HashKey' | 'RangeKey']>, true> : Exclude<MutuallyExclusive<[
-    C['HashKey'],
-    C['RangeKey'],
-    C['ShardedKeys'],
-    C['UnshardedKeys'],
-    keyof FlattenEntityMap<C['EntityMap']>
-]>, true>;
-
-/**
- * Generates & validates the map defining defines an {@link EntityManager | `EntityManager`} configuration's {@link EntityMap | `EntityMap`}, key properties, and {@link TranscodeMap | `TranscodeMap`}.
- *
- * Unspecified properties will default to those defined in {@link BaseConfigMap | `BaseConfigMap`}.
- *
- * @typeParam M - {@link BaseConfigMap | `BaseConfigMap`} extension. If omitted, defaults to {@link BaseConfigMap | `BaseConfigMap`}.
- *
- * @category EntityManager
- */
-type ConfigMap<M extends Partial<BaseConfigMap> = Partial<BaseConfigMap>> = ValidateConfigMap<{
-    EntityMap: 'EntityMap' extends keyof M ? NonNullable<M['EntityMap']> : Record<string, never>;
-    HashKey: 'HashKey' extends keyof M ? NonNullable<M['HashKey']> : 'hashKey';
-    RangeKey: 'RangeKey' extends keyof M ? NonNullable<M['RangeKey']> : 'rangeKey';
-    ShardedKeys: 'ShardedKeys' extends keyof M ? NonNullable<M['ShardedKeys']> : never;
-    UnshardedKeys: 'UnshardedKeys' extends keyof M ? NonNullable<M['UnshardedKeys']> : never;
-    TranscodedProperties: 'TranscodedProperties' extends keyof M ? NonNullable<M['TranscodedProperties']> : never;
-    TranscodeMap: 'TranscodeMap' extends keyof M ? NonNullable<M['TranscodeMap']> : DefaultTranscodeMap;
-}>;
-
-export { type BaseConfigMap, BaseEntityClient, type BaseEntityClientOptions, BaseQueryBuilder, type BaseQueryBuilderOptions, type Config, type ConfigMap, type EntityItem, type EntityKey, EntityManager, type EntityRecord, type EntityToken, type PageKey, type ParsedConfig, type QueryBuilderQueryOptions, type QueryOptions, type QueryResult, type ShardBump, type ShardQueryFunction, type ShardQueryMap, type ShardQueryResult, type ValidateConfigMap };
+export { BaseEntityClient, BaseQueryBuilder, EntityManager, configSchema };
+export type { BaseConfigMap, BaseEntityClientOptions, BaseQueryBuilderOptions, Config, ConfigMap, EntityItem, EntityKey, EntityRecord, EntityToken, PageKey, ParsedConfig, QueryBuilderQueryOptions, QueryOptions, QueryResult, ShardBump, ShardQueryFunction, ShardQueryMap, ShardQueryResult, ValidateConfigMap };

package/dist/mjs/{EntityManager.js → EntityManager/EntityManager.js}

@@ -1,8 +1,8 @@
 import { __classPrivateFieldSet, __classPrivateFieldGet } from 'tslib';
-import { pick } from 'radash';
 import { addKeys } from './addKeys.js';
 import { encodeGeneratedProperty } from './encodeGeneratedProperty.js';
 import { findIndexToken } from './findIndexToken.js';
+import { getPrimaryKey } from './getPrimaryKey.js';
 import { configSchema } from './ParsedConfig.js';
 import { query } from './query.js';
 import { removeKeys } from './removeKeys.js';
@@ -50,59 +50,33 @@ class EntityManager {
     /**
      * Encode a generated property value. Returns a string or undefined if atomicity requirement of sharded properties not met.
      *
-     * @param property - {@link Config.generatedProperties | Generated property} key.
+     * @param property - {@link Config | Config} `generatedProperties` key.
      * @param item - {@link EntityItem | `EntityItem`} object.
      *
      * @returns Encoded generated property value.
      *
-     * @throws `Error` if `property` is not a {@link Config.generatedProperties | generated property}.
+     * @throws `Error` if `property` is not a {@link Config | Config} `generatedProperties` key.
      */
     encodeGeneratedProperty(property, item) {
         return encodeGeneratedProperty(this, property, item);
     }
-    /**
-     * Update generated properties, hash key, and range key on an {@link EntityItem | `EntityItem`} object.
-     *
-     * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityItem | `EntityItem`} object.
-     * @param overwrite - Overwrite existing properties (default `false`).
-     *
-     * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
-     *
-     * @throws `Error` if `entityToken` is invalid.
-     */
-    addKeys(entityToken, item, overwrite = false) {
-        return addKeys(this, entityToken, item, overwrite);
+    addKeys(entityToken, i, overwrite = false) {
+        if (Array.isArray(i)) {
+            return i.map((item) => addKeys(this, entityToken, item, overwrite));
+        }
+        return addKeys(this, entityToken, i, overwrite);
     }
-    /**
-     * Convert an {@link EntityItem | `EntityItem`} into an {@link EntityKey | `EntityKey`}.
-     *
-     * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityItem | `EntityItem`} object.
-     * @param overwrite - Overwrite existing properties (default `false`).
-     *
-     * @returns {@link EntityKey | `EntityKey`} extracted from shallow clone of `item` with updated properties.
-     *
-     * @throws `Error` if `entityToken` is invalid.
-     */
-    getPrimaryKey(entityToken, item, overwrite = false) {
-        const { hashKey, rangeKey } = this.config;
-        return pick(!overwrite && item[hashKey] && item[rangeKey]
-            ? item
-            : addKeys(this, entityToken, item, overwrite), [this.config.hashKey, this.config.rangeKey]);
+    getPrimaryKey(entityToken, i, overwrite = false) {
+        if (Array.isArray(i)) {
+            return i.map((item) => getPrimaryKey(this, entityToken, item, overwrite));
+        }
+        return getPrimaryKey(this, entityToken, i, overwrite);
     }
-    /**
-     * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
-     *
-     * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityRecord | `EntityRecord`} object.
-     *
-     * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
-     *
-     * @throws `Error` if `entityToken` is invalid.
-     */
-    removeKeys(entityToken, item) {
-        return removeKeys(this, entityToken, item);
+    removeKeys(entityToken, i) {
+        if (Array.isArray(i)) {
+            return i.map((item) => removeKeys(this, entityToken, item));
+        }
+        return removeKeys(this, entityToken, i);
     }
     /**
      * Find an index token in a {@link Config | `Config`} object based on the index `hashKey` and `rangeKey`.