@karmaniverous/entity-manager 6.14.1 → 6.14.2

package/dist/cjs/EntityManager/getHashKeySpace.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var radash = require('radash');
+var stringHash = require('string-hash');
 var encodeGeneratedProperty = require('./encodeGeneratedProperty.js');
 var validateGeneratedProperty = require('./validateGeneratedProperty.js');
 
@@ -24,6 +25,9 @@ function getHashKeySpace(entityManager, entityToken, hashKeyToken, item, timesta
         if (hashKeyToken !== entityManager.config.hashKey)
             validateGeneratedProperty.validateGeneratedProperty(entityManager, hashKeyToken, true);
         const { shardBumps } = entityManager.config.entities[entityToken];
+        // Detect presence of the entity's unique property on the item.
+        const uniqueProp = entityManager.config.entities[entityToken].uniqueProperty;
+        const uniqueValue = item[uniqueProp];
         const hashKeySpace = shardBumps
             // Filter shard bumps by timestamp range.
             .filter((bump, i) => (i === shardBumps.length - 1 ||
@@ -32,9 +36,18 @@ function getHashKeySpace(entityManager, entityToken, hashKeyToken, item, timesta
             // Generate shard key space.
             .flatMap(({ charBits, chars }) => {
             const radix = 2 ** charBits;
-            return chars
-                ? [...radash.range(0, radix ** chars - 1)].map((char) => char.toString(radix).padStart(chars, '0'))
-                : '';
+            // If the item's unique property is present, deterministically
+            // compute exactly one shard suffix for this bump. Otherwise,
+            // enumerate the full shard space for the bump.
+            if (chars) {
+                if (uniqueValue) {
+                    const space = radix ** chars;
+                    const mod = stringHash(uniqueValue) % space;
+                    return mod.toString(radix).padStart(chars, '0');
+                }
+                return [...radash.range(0, radix ** chars - 1)].map((char) => char.toString(radix).padStart(chars, '0'));
+            }
+            return '';
         })
             // Map shard keys to hash keys.
             .map((shardKey) => {

package/dist/mjs/EntityManager/getHashKeySpace.js

@@ -1,4 +1,5 @@
 import { range } from 'radash';
+import stringHash from 'string-hash';
 import { encodeGeneratedProperty } from './encodeGeneratedProperty.js';
 import { validateGeneratedProperty } from './validateGeneratedProperty.js';
 
@@ -22,6 +23,9 @@ function getHashKeySpace(entityManager, entityToken, hashKeyToken, item, timesta
         if (hashKeyToken !== entityManager.config.hashKey)
             validateGeneratedProperty(entityManager, hashKeyToken, true);
         const { shardBumps } = entityManager.config.entities[entityToken];
+        // Detect presence of the entity's unique property on the item.
+        const uniqueProp = entityManager.config.entities[entityToken].uniqueProperty;
+        const uniqueValue = item[uniqueProp];
         const hashKeySpace = shardBumps
             // Filter shard bumps by timestamp range.
             .filter((bump, i) => (i === shardBumps.length - 1 ||
@@ -30,9 +34,18 @@ function getHashKeySpace(entityManager, entityToken, hashKeyToken, item, timesta
             // Generate shard key space.
             .flatMap(({ charBits, chars }) => {
             const radix = 2 ** charBits;
-            return chars
-                ? [...range(0, radix ** chars - 1)].map((char) => char.toString(radix).padStart(chars, '0'))
-                : '';
+            // If the item's unique property is present, deterministically
+            // compute exactly one shard suffix for this bump. Otherwise,
+            // enumerate the full shard space for the bump.
+            if (chars) {
+                if (uniqueValue) {
+                    const space = radix ** chars;
+                    const mod = stringHash(uniqueValue) % space;
+                    return mod.toString(radix).padStart(chars, '0');
+                }
+                return [...range(0, radix ** chars - 1)].map((char) => char.toString(radix).padStart(chars, '0'));
+            }
+            return '';
         })
             // Map shard keys to hash keys.
             .map((shardKey) => {

package/package.json

@@ -131,5 +131,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "6.14.1"
+  "version": "6.14.2"
 }