@karmaniverous/entity-manager 6.11.2 → 6.11.4

package/dist/cjs/EntityManager.js

@@ -54,7 +54,7 @@ class EntityManager {
      * @param item - {@link EntityItem | `EntityItem`} object.
      * @param overwrite - Overwrite existing properties (default `false`).
      *
-     * @returns Shallow clone of `item` with updated properties.
+     * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
      *
      * @throws `Error` if `entityToken` is invalid.
      */
@@ -79,12 +79,12 @@ class EntityManager {
             : addKeys.addKeys(this, entityToken, item, overwrite), [this.config.hashKey, this.config.rangeKey]);
     }
     /**
-     * Strips generated properties, hash key, and range key from an {@link EntityItem | `EntityItem`} object.
+     * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
      *
      * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityItem | `EntityItem`} object.
+     * @param item - {@link EntityRecord | `EntityRecord`} object.
      *
-     * @returns Shallow clone of `item` without generated properties, hash key or range key.
+     * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
      *
      * @throws `Error` if `entityToken` is invalid.
      */

package/dist/cjs/addKeys.js

@@ -14,7 +14,7 @@ var validateEntityToken = require('./validateEntityToken.js');
  * @param item - {@link EntityItem | `EntityItem`} object.
  * @param overwrite - Overwrite existing properties (default `false`).
  *
- * @returns Shallow clone of `item` with updated properties.
+ * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
  *
  * @throws `Error` if `entityToken` is invalid.
  */

package/dist/cjs/removeKeys.js

@@ -3,13 +3,13 @@
 var validateEntityToken = require('./validateEntityToken.js');
 
 /**
- * Strips generated properties, hash key, and range key from an {@link ItemMap | `ItemMap`} object.
+ * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
  * @param entityToken - {@link Config.entities | `entityManager.config.entities`} key.
- * @param item - {@link ItemMap | `ItemMap`} object.
+ * @param item - {@link EntityRecord | `EntityRecord`} object.
  *
- * @returns Shallow clone of `item` without generated properties, hash key or range key.
+ * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
  *
  * @throws `Error` if `entityToken` is invalid.
  */

package/dist/index.d.ts

@@ -96,6 +96,16 @@ type EntityItem<C extends BaseConfigMap> = Partial<FlattenEntityMap<C['EntityMap
  */
 type EntityKey<C extends BaseConfigMap> = Record<C['HashKey'] | C['RangeKey'], string>;
 
+/**
+ * Database-facing record type from a {@link BaseConfigMap | `ConfigMap`} with required hash & range keys.
+ *
+ * @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 EntityRecord<C extends BaseConfigMap> = EntityItem<C> & EntityKey<C>;
+
 /**
  * Extracts entity tokens from a {@link ConfigMap | `ConfigMap`}.
  *
@@ -538,11 +548,11 @@ declare class EntityManager<C extends BaseConfigMap> {
      * @param item - {@link EntityItem | `EntityItem`} object.
      * @param overwrite - Overwrite existing properties (default `false`).
      *
-     * @returns Shallow clone of `item` with updated properties.
+     * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
      *
      * @throws `Error` if `entityToken` is invalid.
      */
-    addKeys(entityToken: EntityToken<C>, item: EntityItem<C>, overwrite?: boolean): EntityItem<C>;
+    addKeys(entityToken: EntityToken<C>, item: EntityItem<C>, overwrite?: boolean): EntityRecord<C>;
     /**
      * Convert an {@link EntityItem | `EntityItem`} into an {@link EntityKey | `EntityKey`}.
      *
@@ -556,16 +566,16 @@ declare class EntityManager<C extends BaseConfigMap> {
      */
     getPrimaryKey(entityToken: EntityToken<C>, item: EntityItem<C>, overwrite?: boolean): EntityKey<C>;
     /**
-     * Strips generated properties, hash key, and range key from an {@link EntityItem | `EntityItem`} object.
+     * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
      *
      * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityItem | `EntityItem`} object.
+     * @param item - {@link EntityRecord | `EntityRecord`} object.
      *
-     * @returns Shallow clone of `item` without generated properties, hash key or range key.
+     * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
      *
      * @throws `Error` if `entityToken` is invalid.
      */
-    removeKeys(entityToken: EntityToken<C>, item: EntityItem<C>): EntityItem<C>;
+    removeKeys(entityToken: EntityToken<C>, item: EntityRecord<C>): EntityItem<C>;
     /**
      * Query a database entity across shards in a provider-generic fashion.
      *
@@ -736,14 +746,4 @@ type ConfigMap<M extends Partial<BaseConfigMap> = Partial<BaseConfigMap>> = Vali
     TranscodeMap: 'TranscodeMap' extends keyof M ? NonNullable<M['TranscodeMap']> : DefaultTranscodeMap;
 }>;
 
-/**
- * Database-facing record type from a {@link BaseConfigMap | `ConfigMap`} with required hash & range keys.
- *
- * @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 EntityRecord<C extends BaseConfigMap> = EntityItem<C> & EntityKey<C>;
-
 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 };

package/dist/mjs/EntityManager.js

@@ -52,7 +52,7 @@ class EntityManager {
      * @param item - {@link EntityItem | `EntityItem`} object.
      * @param overwrite - Overwrite existing properties (default `false`).
      *
-     * @returns Shallow clone of `item` with updated properties.
+     * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
      *
      * @throws `Error` if `entityToken` is invalid.
      */
@@ -77,12 +77,12 @@ class EntityManager {
             : addKeys(this, entityToken, item, overwrite), [this.config.hashKey, this.config.rangeKey]);
     }
     /**
-     * Strips generated properties, hash key, and range key from an {@link EntityItem | `EntityItem`} object.
+     * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
      *
      * @param entityToken - {@link Config | `Config`} `entities` key.
-     * @param item - {@link EntityItem | `EntityItem`} object.
+     * @param item - {@link EntityRecord | `EntityRecord`} object.
      *
-     * @returns Shallow clone of `item` without generated properties, hash key or range key.
+     * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
      *
      * @throws `Error` if `entityToken` is invalid.
      */

package/dist/mjs/addKeys.js

@@ -12,7 +12,7 @@ import { validateEntityToken } from './validateEntityToken.js';
  * @param item - {@link EntityItem | `EntityItem`} object.
  * @param overwrite - Overwrite existing properties (default `false`).
  *
- * @returns Shallow clone of `item` with updated properties.
+ * @returns {@link EntityRecord | `EntityRecord`} object with updated properties.
  *
  * @throws `Error` if `entityToken` is invalid.
  */

package/dist/mjs/removeKeys.js

@@ -1,13 +1,13 @@
 import { validateEntityToken } from './validateEntityToken.js';
 
 /**
- * Strips generated properties, hash key, and range key from an {@link ItemMap | `ItemMap`} object.
+ * Strips generated properties, hash key, and range key from an {@link EntityRecord | `EntityRecord`} object.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
  * @param entityToken - {@link Config.entities | `entityManager.config.entities`} key.
- * @param item - {@link ItemMap | `ItemMap`} object.
+ * @param item - {@link EntityRecord | `EntityRecord`} object.
  *
- * @returns Shallow clone of `item` without generated properties, hash key or range key.
+ * @returns {@link EntityItem | `EntityItem`} with generated properties, hash key & range key removed.
  *
  * @throws `Error` if `entityToken` is invalid.
  */

package/package.json

@@ -132,5 +132,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "6.11.2"
+  "version": "6.11.4"
 }