@karmaniverous/entity-manager 6.14.0 → 6.14.2

package/dist/mjs/EntityManager/encodeGeneratedProperty.js

@@ -28,7 +28,7 @@ function encodeGeneratedProperty(entityManager, property, item) {
             ...(sharded
                 ? [item[entityManager.config.hashKey]]
                 : []),
-            ...elementMap.map(([element, value]) => [element, (value ?? '').toString()].join(entityManager.config.generatedValueDelimiter)),
+            ...elementMap.map(([element, value]) => [element, `${value ?? ''}`].join(entityManager.config.generatedValueDelimiter)),
         ].join(entityManager.config.generatedKeyDelimiter);
         entityManager.logger.debug('encoded generated property', {
             property,

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/dist/mjs/EntityManager/rehydratePageKeyMap.js

@@ -45,7 +45,9 @@ function rehydratePageKeyMap(entityManager, entityToken, indexTokens, item, dehy
         if (hashKeys.length > 1)
             throw new Error('inconsistent hashKeys');
         const [hashKeyToken] = hashKeys;
-        indexTokens.map((index) => validateIndexToken(entityManager, index));
+        indexTokens.map((index) => {
+            validateIndexToken(entityManager, index);
+        });
         // Shortcut empty dehydrated.
         if (dehydrated && !dehydrated.length)
             return [hashKeyToken, {}];

package/dist/mjs/EntityManager/removeKeys.js

@@ -15,14 +15,16 @@ function removeKeys(entityManager, entityToken, item) {
     try {
         // Validate params.
         validateEntityToken(entityManager, entityToken);
-        // Delete hash & range keys.
-        const newItem = { ...item };
-        delete newItem[entityManager.config.hashKey];
-        delete newItem[entityManager.config.rangeKey];
-        // Delete generated properties.
-        const { sharded, unsharded } = entityManager.config.generatedProperties;
-        for (const property in { ...sharded, ...unsharded })
-            delete newItem[property];
+        // Build a set of keys to strip (hash, range, and all generated properties).
+        const { hashKey, rangeKey, generatedProperties: { sharded, unsharded }, } = entityManager.config;
+        const keysToStrip = new Set([
+            hashKey,
+            rangeKey,
+            ...Object.keys(sharded),
+            ...Object.keys(unsharded),
+        ]);
+        // Create a shallow copy of item omitting the keys above (no delete operator).
+        const newItem = Object.fromEntries(Object.entries(item).filter(([key]) => !keysToStrip.has(key)));
         entityManager.logger.debug('stripped entity item generated properties', {
             entityToken,
             item,

package/dist/mjs/EntityManager/updateItemHashKey.js

@@ -40,12 +40,15 @@ function updateItemHashKey(entityManager, entityToken, item, overwrite = false)
         if (chars) {
             // Radix is the numerical base of the shardKey.
             const radix = 2 ** charBits;
+            // Compute the full shard space for this bump. Use radix ** chars to ensure
+            // all placeholders are utilized (e.g., chars=2, charBits=2 => 16 combos).
+            const space = radix ** chars;
             // Get item unique property & validate.
             const uniqueId = item[entityManager.config.entities[entityToken]
                 .uniqueProperty];
             if (isNil(uniqueId))
                 throw new Error(`missing item unique property`);
-            hashKey += (stringHash(uniqueId.toString()) % (chars * radix))
+            hashKey += (stringHash(uniqueId) % space)
                 .toString(radix)
                 .padStart(chars, '0');
         }

package/package.json

@@ -5,58 +5,52 @@
   },
   "dependencies": {
     "@karmaniverous/batch-process": "^0.1.0",
-    "@karmaniverous/entity-tools": "^0.6.8",
+    "@karmaniverous/entity-tools": "^0.6.9",
     "@karmaniverous/string-utilities": "^0.2.1",
     "lz-string": "^1.5.0",
-    "radash": "^12.1.0",
+    "radash": "^12.1.1",
     "string-hash": "^1.1.3",
-    "zod": "^3.23.8"
+    "zod": "^4.1.12"
   },
   "description": "Rational indexing & cross-shard querying at scale in your NoSQL database so you can focus on your application logic.",
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.23.0",
-    "@eslint/js": "^9.14.0",
-    "@faker-js/faker": "^9.2.0",
-    "@karmaniverous/mock-db": "^0.3.4",
-    "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.1",
+    "@dotenvx/dotenvx": "^1.51.1",
+    "@eslint/js": "^9.39.1",
+    "@faker-js/faker": "^10.1.0",
+    "@karmaniverous/mock-db": "^0.3.5",
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^15.3.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-strip": "^3.0.4",
-    "@rollup/plugin-typescript": "^12.1.1",
-    "@types/chai": "^5.0.1",
-    "@types/eslint__js": "^8.42.3",
-    "@types/eslint-config-prettier": "^6.11.3",
-    "@types/eslint-plugin-mocha": "^10.4.0",
-    "@types/mocha": "^10.0.9",
-    "@types/node": "^22.9.0",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^24.10.0",
     "@types/string-hash": "^1.1.3",
     "auto-changelog": "^2.5.0",
-    "chai": "^5.1.2",
-    "eslint": "^9.14.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-mocha": "^10.5.0",
+    "cross-env": "^10.1.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-tsdoc": "^0.3.0",
-    "jsdom-global": "^3.0.2",
-    "knip": "^5.37.0",
-    "lefthook": "^1.8.2",
-    "mocha": "^10.8.2",
-    "nyc": "^17.1.0",
-    "prettier": "^3.3.3",
-    "release-it": "^17.10.0",
-    "rimraf": "^6.0.1",
-    "rollup": "^4.26.0",
-    "rollup-plugin-dts": "^6.1.1",
-    "source-map-support": "^0.5.21",
-    "ts-node": "^10.9.2",
+    "eslint-plugin-tsdoc": "^0.4.0",
+    "knip": "^5.67.1",
+    "lefthook": "^2.0.2",
+    "prettier": "^3.6.2",
+    "release-it": "^19.0.5",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.52.5",
+    "rollup-plugin-dts": "^6.2.3",
+    "tsd": "^0.33.0",
     "tslib": "^2.8.1",
-    "typedoc": "^0.26.11",
-    "typedoc-plugin-mdn-links": "^3.3.7",
-    "typedoc-plugin-replace-text": "^4.0.0",
-    "typedoc-plugin-zod": "^1.2.1",
-    "typescript": "^5.6.3",
-    "typescript-eslint": "^8.14.0"
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-mdn-links": "^5.0.10",
+    "typedoc-plugin-replace-text": "^4.2.0",
+    "typedoc-plugin-zod": "^1.4.3",
+    "@vitest/coverage-v8": "^4.0.6",
+    "@vitest/eslint-plugin": "^1.4.0",
+    "vitest": "^4.0.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.3"
   },
   "exports": {
     ".": {
@@ -122,15 +116,20 @@
   },
   "scripts": {
     "build": "rimraf dist && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "changelog": "auto-changelog",
     "docs": "typedoc",
     "knip": "knip",
-    "lint": "eslint src/** && prettier -c src",
-    "lint:fix": "eslint --fix src/** && prettier --write src",
+    "lint": "eslint .",
+    "lint:fix": "npm run lint -- --fix .",
     "release": "dotenvx run -f .env.local -- release-it",
-    "release:pre": "dotenvx run -f .env.local -- release-it --no-git.requireBranch --github.prerelease --preRelease",
-    "test": "dotenvx run --quiet --log-level=LOG_LEVEL=debug -- nyc mocha"
+    "release:pre": "npm run release -- --no-git.requireBranch --github.prerelease --preRelease",
+    "test": "vitest --run --silent",
+    "typecheck": "tsc && tsd"
+  },
+  "tsd": {
+    "directory": "test/types"
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "6.14.0"
+  "version": "6.14.2"
 }