@karmaniverous/entity-manager 6.5.0 → 6.6.0

package/dist/mjs/rehydratePageKeyMap.js

@@ -1,6 +1,7 @@
 import { range, mapValues, zipToObject, cluster } from 'radash';
 import { encodeGeneratedProperty } from './encodeGeneratedProperty.js';
 import { getHashKeySpace } from './getHashKeySpace.js';
+import { getIndexComponents } from './getIndexComponents.js';
 import { rehydrateIndexItem } from './rehydrateIndexItem.js';
 import { updateItemRangeKey } from './updateItemRangeKey.js';
 import { validateEntityIndexToken } from './validateEntityIndexToken.js';
@@ -11,9 +12,9 @@ import { validateEntityIndexToken } from './validateEntityIndexToken.js';
  * Reverses the {@link EntityManager.dehydratePageKeyMap | `dehydratePageKeyMap`} method.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
- * @param dehydrated - Array of dehydrated page keys or undefined if new query.
  * @param entityToken - {@link ConfigKeys.entities | `entityManager.config.entities`} key.
  * @param indexTokens - Array of {@link ConfigEntity.indexes | `entityManager.config.entities.<entityToken>.indexes`} keys used as keys of the original {@link PageKeyMap | `PageKeyMap`}.
+ * @param dehydrated - Array of dehydrated page keys or undefined if new query.
  * @param timestampFrom - Lower timestanp limit used to generate the original {@link PageKeyMap | `PageKeyMap`}. Defaults to `0`.
  * @param timestampTo - Upper timestamp limit used to generate the original {@link PageKeyMap | `PageKeyMap`}. Defaults to `Date.now()`.
  *
@@ -24,7 +25,7 @@ import { validateEntityIndexToken } from './validateEntityIndexToken.js';
  * @throws `Error` if any `indexTokens` are invalid.
  * @throws `Error` if `dehydrated` has invalid length.
  */
-function rehydratePageKeyMap(entityManager, dehydrated, entityToken, indexTokens, timestampFrom = 0, timestampTo = Date.now()) {
+function rehydratePageKeyMap(entityManager, entityToken, indexTokens, dehydrated, timestampFrom = 0, timestampTo = Date.now()) {
     try {
         // Validate params.
         if (!indexTokens.length)
@@ -46,18 +47,17 @@ function rehydratePageKeyMap(entityManager, dehydrated, entityToken, indexTokens
                 return;
             let item = {
                 [entityManager.config.hashKey]: hashKey,
-                ...rehydrateIndexItem(entityManager, dehydratedIndexPageKeyMaps[i], entityToken, index, [entityManager.config.hashKey]),
+                ...rehydrateIndexItem(entityManager, entityToken, index, dehydratedIndexPageKeyMaps[i], [entityManager.config.hashKey]),
             };
-            item = updateItemRangeKey(entityManager, item, entityToken);
-            return zipToObject(entityManager.config.entities[entityToken].indexes[index]
-                .components, (component) => entityManager.config.entities[entityToken].generated[component]
-                ? encodeGeneratedProperty(entityManager, item, entityToken, component)
+            item = updateItemRangeKey(entityManager, entityToken, item);
+            return zipToObject(getIndexComponents(entityManager, entityToken, index), (component) => entityManager.config.entities[entityToken].generated[component]
+                ? encodeGeneratedProperty(entityManager, entityToken, component, item)
                 : item[component]);
         }));
         entityManager.logger.debug('rehydrated page key map', {
-            dehydrated,
             entityToken,
             indexTokens,
+            dehydrated,
             rehydrated,
         });
         return rehydrated;
@@ -65,9 +65,9 @@ function rehydratePageKeyMap(entityManager, dehydrated, entityToken, indexTokens
     catch (error) {
         if (error instanceof Error)
             entityManager.logger.error(error.message, {
-                dehydrated,
                 entityToken,
                 indexTokens,
+                dehydrated,
             });
         throw error;
     }

package/dist/mjs/removeKeys.js

@@ -4,14 +4,14 @@ import { validateEntityToken } from './validateEntityToken.js';
  * Strips generated properties, hash key, and range key from an {@link ItemMap | `ItemMap`} object.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
- * @param item - {@link ItemMap | `ItemMap`} object.
  * @param entityToken - {@link ConfigKeys.entities | `entityManager.config.entities`} key.
+ * @param item - {@link ItemMap | `ItemMap`} object.
  *
  * @returns Shallow clone of `item` without generated properties, hash key or range key.
  *
  * @throws `Error` if `entityToken` is invalid.
  */
-function removeKeys(entityManager, item, entityToken) {
+function removeKeys(entityManager, entityToken, item) {
     try {
         // Validate params.
         validateEntityToken(entityManager, entityToken);
@@ -23,15 +23,15 @@ function removeKeys(entityManager, item, entityToken) {
         for (const property in entityManager.config.entities[entityToken].generated)
             delete newItem[property];
         entityManager.logger.debug('stripped entity item generated properties', {
-            item,
             entityToken,
+            item,
             newItem,
         });
         return newItem;
     }
     catch (error) {
         if (error instanceof Error)
-            entityManager.logger.error(error.message, { item, entityToken });
+            entityManager.logger.error(error.message, { entityToken, item });
         throw error;
     }
 }

package/dist/mjs/unwrapIndex.js

@@ -1,4 +1,5 @@
 import { shake } from 'radash';
+import { getIndexComponents } from './getIndexComponents.js';
 import { validateEntityIndexToken } from './validateEntityIndexToken.js';
 
 /**
@@ -19,7 +20,7 @@ function unwrapIndex(entityManager, entityToken, indexToken) {
         validateEntityIndexToken(entityManager, entityToken, indexToken);
         const generated = entityManager.config.entities[entityToken].generated;
         const generatedKeys = Object.keys(shake(generated));
-        return entityManager.config.entities[entityToken].indexes[indexToken].components
+        return getIndexComponents(entityManager, entityToken, indexToken)
             .map((component) => component === entityManager.config.hashKey
             ? entityManager.config.hashKey
             : component === entityManager.config.rangeKey

package/dist/mjs/updateItemHashKey.js

@@ -7,15 +7,15 @@ import { validateEntityToken } from './validateEntityToken.js';
  * Update the hash key on a partial {@link ItemMap | `ItemMap`} object.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
- * @param item - Partial {@link ItemMap | `ItemMap`} object.
  * @param entityToken - {@link ConfigKeys.entities | `this.config.entities`} key.
+ * @param item - Partial {@link ItemMap | `ItemMap`} object.
  * @param overwrite - Overwrite existing {@link ConfigKeys.hashKey | `this.config.hashKey`} property value (default `false`).
  *
  * @returns Shallow clone of `item` with updated hash key.
  *
  * @throws `Error` if `entityToken` is invalid.
  */
-function updateItemHashKey(entityManager, item, entityToken, overwrite = false) {
+function updateItemHashKey(entityManager, entityToken, item, overwrite = false) {
     try {
         // Validate params.
         validateEntityToken(entityManager, entityToken);
@@ -59,8 +59,8 @@ function updateItemHashKey(entityManager, item, entityToken, overwrite = false)
     catch (error) {
         if (error instanceof Error)
             entityManager.logger.error(error.message, {
-                item,
                 entityToken,
+                item,
                 overwrite,
             });
         throw error;

package/dist/mjs/updateItemRangeKey.js

@@ -5,8 +5,8 @@ import { validateEntityToken } from './validateEntityToken.js';
  * Update the range key on a partial {@link ItemMap | `ItemMap`} object.
  *
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
- * @param item - Partial {@link ItemMap | `ItemMap`} object.
  * @param entityToken - {@link ConfigKeys.entities | `this.config.entities`} key.
+ * @param item - Partial {@link ItemMap | `ItemMap`} object.
  * @param overwrite - Overwrite existing {@link ConfigKeys.rangeKey | `this.config.rangeKey`} property value (default `false`).
  *
  * @returns Shallow clone of `item` with updated range key.
@@ -14,15 +14,15 @@ import { validateEntityToken } from './validateEntityToken.js';
  * @throws `Error` if `entityToken` is invalid.
  * @throws `Error` if `item` {@link ConfigEntity.uniqueProperty | `this.config.entities<entityToken>.uniqueProperty`} property value is missing.
  */
-function updateItemRangeKey(entityManager, item, entityToken, overwrite = false) {
+function updateItemRangeKey(entityManager, entityToken, item, overwrite = false) {
     try {
         // Validate params.
         validateEntityToken(entityManager, entityToken);
         // Return current item if rangeKey exists and overwrite is false.
         if (item[entityManager.config.rangeKey] && !overwrite) {
             entityManager.logger.debug('did not overwrite existing entity item range key', {
-                item,
                 entityToken,
+                item,
                 overwrite,
             });
             return { ...item };
@@ -49,8 +49,8 @@ function updateItemRangeKey(entityManager, item, entityToken, overwrite = false)
     catch (error) {
         if (error instanceof Error)
             entityManager.logger.error(error.message, {
-                item,
                 entityToken,
+                item,
                 overwrite,
             });
         throw error;

package/package.json

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