@karmaniverous/entity-manager 6.5.0 → 6.5.1

package/dist/cjs/ParsedConfig.js

@@ -59,7 +59,8 @@ const configSchema = zod.z
         elementTranscodes: zod.z.record(zod.z.string()).optional().default({}),
         indexes: zod.z
             .record(zod.z.object({
-            components: componentArray,
+            hashKey: zod.z.string().min(1),
+            rangeKey: zod.z.string().min(1),
             projections: componentArray.optional(),
         }))
             .optional()
@@ -212,9 +213,23 @@ const configSchema = zod.z
                     });
         // validate indexes.
         const generatedProperties = Object.keys(entity.generated);
-        for (const [indexKey, index] of Object.entries(entity.indexes)) {
+        for (const [indexKey, { hashKey, rangeKey, projections },] of Object.entries(entity.indexes)) {
+            // validate index hash key is sharded
+            if (hashKey !== data.hashKey && !entity.generated[hashKey]?.sharded)
+                ctx.addIssue({
+                    code: zod.z.ZodIssueCode.custom,
+                    message: 'index hash key is not sharded',
+                    path: ['entities', entityToken, 'indexes', indexKey, 'hashKey'],
+                });
+            // validate index range key is unsharded
+            if (rangeKey !== data.rangeKey && entity.generated[rangeKey]?.sharded)
+                ctx.addIssue({
+                    code: zod.z.ZodIssueCode.custom,
+                    message: 'index range key is sharded',
+                    path: ['entities', entityToken, 'indexes', indexKey, 'rangeKey'],
+                });
             // validate all ungenerated entity index components have a corresponding entity element type
-            for (const component of index.components)
+            for (const component of [hashKey, rangeKey])
                 if (![data.hashKey, data.rangeKey, ...generatedProperties].includes(component) &&
                     !typedElements.includes(component))
                     ctx.addIssue({
@@ -230,9 +245,9 @@ const configSchema = zod.z
                         received: component,
                     });
             // validate no index projections are index components, hashKey, or rangeKey
-            if (index.projections)
-                for (const projection of index.projections) {
-                    if ([data.hashKey, data.rangeKey, ...index.components].includes(projection))
+            if (projections)
+                for (const projection of projections) {
+                    if ([data.hashKey, data.rangeKey, hashKey, rangeKey].includes(projection))
                         ctx.addIssue({
                             code: zod.z.ZodIssueCode.custom,
                             message: 'index projection is an index component, hash key, or range key',

package/dist/cjs/getIndexComponents.js

@@ -0,0 +1,25 @@
+'use strict';
+
+var radash = require('radash');
+var validateEntityIndexToken = require('./validateEntityIndexToken.js');
+
+/**
+ * Get the index components of an entity index. Adds the hash and range keys to the index components.
+ *
+ * @param entityManager - {@link EntityManager | `EntityManager`} instance.
+ * @param entityToken - {@link ConfigKeys.entities | `entityManager.config.entities`} key.
+ * @param indexToken - {@link ConfigEntity.indexes | `entityManager.config.entities.<entityToken>.indexes`} key.
+ *
+ * @returns Array of index components.
+ *
+ * @throws `Error` if `entityToken` is invalid.
+ * @throws `Error` if `indexToken` is invalid.
+ */
+function getIndexComponents(entityManager, entityToken, indexToken) {
+    validateEntityIndexToken.validateEntityIndexToken(entityManager, entityToken, indexToken);
+    const { hashKey, rangeKey, entities } = entityManager.config;
+    const { hashKey: indexHashKey, rangeKey: indexRangeKey } = entities[entityToken].indexes[indexToken];
+    return radash.unique([hashKey, rangeKey, indexHashKey, indexRangeKey]);
+}
+
+exports.getIndexComponents = getIndexComponents;

package/dist/cjs/rehydratePageKeyMap.js

@@ -3,6 +3,7 @@
 var radash = require('radash');
 var encodeGeneratedProperty = require('./encodeGeneratedProperty.js');
 var getHashKeySpace = require('./getHashKeySpace.js');
+var getIndexComponents = require('./getIndexComponents.js');
 var rehydrateIndexItem = require('./rehydrateIndexItem.js');
 var updateItemRangeKey = require('./updateItemRangeKey.js');
 var validateEntityIndexToken = require('./validateEntityIndexToken.js');
@@ -51,8 +52,7 @@ function rehydratePageKeyMap(entityManager, dehydrated, entityToken, indexTokens
                 ...rehydrateIndexItem.rehydrateIndexItem(entityManager, dehydratedIndexPageKeyMaps[i], entityToken, index, [entityManager.config.hashKey]),
             };
             item = updateItemRangeKey.updateItemRangeKey(entityManager, item, entityToken);
-            return radash.zipToObject(entityManager.config.entities[entityToken].indexes[index]
-                .components, (component) => entityManager.config.entities[entityToken].generated[component]
+            return radash.zipToObject(getIndexComponents.getIndexComponents(entityManager, entityToken, index), (component) => entityManager.config.entities[entityToken].generated[component]
                 ? encodeGeneratedProperty.encodeGeneratedProperty(entityManager, item, entityToken, component)
                 : item[component]);
         }));

package/dist/cjs/unwrapIndex.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var radash = require('radash');
+var getIndexComponents = require('./getIndexComponents.js');
 var validateEntityIndexToken = require('./validateEntityIndexToken.js');
 
 /**
@@ -21,7 +22,7 @@ function unwrapIndex(entityManager, entityToken, indexToken) {
         validateEntityIndexToken.validateEntityIndexToken(entityManager, entityToken, indexToken);
         const generated = entityManager.config.entities[entityToken].generated;
         const generatedKeys = Object.keys(radash.shake(generated));
-        return entityManager.config.entities[entityToken].indexes[indexToken].components
+        return getIndexComponents.getIndexComponents(entityManager, entityToken, indexToken)
             .map((component) => component === entityManager.config.hashKey
             ? entityManager.config.hashKey
             : component === entityManager.config.rangeKey

package/dist/index.d.ts

@@ -92,7 +92,7 @@ interface ShardBump {
  * @category Config
  * @protected
  */
-type ConfigEntityIndexComponents<EntityToken extends keyof Exactify<M>, M extends EntityMap, HashKey extends string, RangeKey extends string, T extends TranscodeMap> = (TranscodableProperties<M[EntityToken], T> | PropertiesOfType<M[EntityToken], never> | HashKey | RangeKey)[];
+type ConfigEntityIndexComponent<EntityToken extends keyof Exactify<M>, M extends EntityMap, HashKey extends string, RangeKey extends string, T extends TranscodeMap> = TranscodableProperties<M[EntityToken], T> | PropertiesOfType<M[EntityToken], never> | HashKey | RangeKey;
 /**
  * Returns a Config entity type.
  *
@@ -184,12 +184,13 @@ type ConfigEntity<EntityToken extends keyof Exactify<M>, M extends EntityMap, Ha
     /**
      * Indexes defined for the {@link Entity | `Entity`}. Should reflect the underlying database table indexes.
      *
-     * Each key is the name of an index, and each value is a non-empty array of {@link Entity | `Entity`} property names that define the index.
+     * Each key is the name of an index, and each value defines the hash key, range key, and projected properties of the index.
      *
-     * Related property types must be align with the {@link Config | `Config`} `T` type parameter. Note tha all {@link ConfigEntityGenerated | generated property} types are transcodable by definition.
+     * hashKey and rangeKey types must align with the {@link Config | `Config`} `T` type parameter. Note that all {@link ConfigEntityGenerated | generated property} types are transcodable by definition.
      */
     indexes?: Record<string, {
-        components: ConfigEntityIndexComponents<EntityToken, M, HashKey, RangeKey, T>;
+        hashKey: ConfigEntityIndexComponent<EntityToken, M, HashKey, RangeKey, T>;
+        rangeKey: ConfigEntityIndexComponent<EntityToken, M, HashKey, RangeKey, T>;
         projections?: (keyof M[EntityToken])[];
     }>;
     /**
@@ -394,13 +395,16 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         }>>>>>;
         elementTranscodes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
         indexes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            components: z.ZodEffects<z.ZodArray<z.ZodString, "atleastone">, [string, ...string[]], [string, ...string[]]>;
+            hashKey: z.ZodString;
+            rangeKey: z.ZodString;
             projections: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "atleastone">, [string, ...string[]], [string, ...string[]]>>;
         }, "strip", z.ZodTypeAny, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }>>>>;
         shardBumps: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -447,7 +451,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize: number;
         elementTranscodes: Record<string, string>;
         indexes: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }>;
         shardBumps: {
@@ -469,7 +474,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize?: number | undefined;
         elementTranscodes?: Record<string, string> | undefined;
         indexes?: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }> | undefined;
         shardBumps?: {
@@ -487,7 +493,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize: number;
         elementTranscodes: Record<string, string>;
         indexes: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }>;
         shardBumps: {
@@ -509,7 +516,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize?: number | undefined;
         elementTranscodes?: Record<string, string> | undefined;
         indexes?: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }> | undefined;
         shardBumps?: {
@@ -547,7 +555,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize: number;
         elementTranscodes: Record<string, string>;
         indexes: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }>;
         shardBumps: {
@@ -581,7 +590,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize?: number | undefined;
         elementTranscodes?: Record<string, string> | undefined;
         indexes?: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }> | undefined;
         shardBumps?: {
@@ -611,7 +621,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize: number;
         elementTranscodes: Record<string, string>;
         indexes: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }>;
         shardBumps: {
@@ -645,7 +656,8 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         defaultPageSize?: number | undefined;
         elementTranscodes?: Record<string, string> | undefined;
         indexes?: Record<string, {
-            components: [string, ...string[]];
+            hashKey: string;
+            rangeKey: string;
             projections?: [string, ...string[]] | undefined;
         }> | undefined;
         shardBumps?: {
@@ -877,4 +889,4 @@ declare class EntityManager<M extends EntityMap, HashKey extends string, RangeKe
     query<Item extends ItemMap<M, HashKey, RangeKey>[EntityToken], EntityToken extends keyof Exactify<M> & string>(options: QueryOptions<Item, EntityToken, M, HashKey, RangeKey>): Promise<QueryResult<Item, EntityToken, M, HashKey, RangeKey>>;
 }
 
-export { type Config, type ConfigEntities, type ConfigEntity, type ConfigEntityGenerated, type ConfigEntityIndexComponents, type ConfigKeys, type ConfigTranscodes, EntityManager, type EntityMap, type ExclusiveKey, type ItemMap, type ParsedConfig, type QueryOptions, type QueryResult, type ShardBump, type ShardQueryFunction, type ShardQueryMap, type ShardQueryResult, type Unwrap, conditionalize };
+export { type Config, type ConfigEntities, type ConfigEntity, type ConfigEntityGenerated, type ConfigEntityIndexComponent, type ConfigKeys, type ConfigTranscodes, EntityManager, type EntityMap, type ExclusiveKey, type ItemMap, type ParsedConfig, type QueryOptions, type QueryResult, type ShardBump, type ShardQueryFunction, type ShardQueryMap, type ShardQueryResult, type Unwrap, conditionalize };

package/dist/mjs/ParsedConfig.js

@@ -57,7 +57,8 @@ const configSchema = z
         elementTranscodes: z.record(z.string()).optional().default({}),
         indexes: z
             .record(z.object({
-            components: componentArray,
+            hashKey: z.string().min(1),
+            rangeKey: z.string().min(1),
             projections: componentArray.optional(),
         }))
             .optional()
@@ -210,9 +211,23 @@ const configSchema = z
                     });
         // validate indexes.
         const generatedProperties = Object.keys(entity.generated);
-        for (const [indexKey, index] of Object.entries(entity.indexes)) {
+        for (const [indexKey, { hashKey, rangeKey, projections },] of Object.entries(entity.indexes)) {
+            // validate index hash key is sharded
+            if (hashKey !== data.hashKey && !entity.generated[hashKey]?.sharded)
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'index hash key is not sharded',
+                    path: ['entities', entityToken, 'indexes', indexKey, 'hashKey'],
+                });
+            // validate index range key is unsharded
+            if (rangeKey !== data.rangeKey && entity.generated[rangeKey]?.sharded)
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'index range key is sharded',
+                    path: ['entities', entityToken, 'indexes', indexKey, 'rangeKey'],
+                });
             // validate all ungenerated entity index components have a corresponding entity element type
-            for (const component of index.components)
+            for (const component of [hashKey, rangeKey])
                 if (![data.hashKey, data.rangeKey, ...generatedProperties].includes(component) &&
                     !typedElements.includes(component))
                     ctx.addIssue({
@@ -228,9 +243,9 @@ const configSchema = z
                         received: component,
                     });
             // validate no index projections are index components, hashKey, or rangeKey
-            if (index.projections)
-                for (const projection of index.projections) {
-                    if ([data.hashKey, data.rangeKey, ...index.components].includes(projection))
+            if (projections)
+                for (const projection of projections) {
+                    if ([data.hashKey, data.rangeKey, hashKey, rangeKey].includes(projection))
                         ctx.addIssue({
                             code: z.ZodIssueCode.custom,
                             message: 'index projection is an index component, hash key, or range key',

package/dist/mjs/getIndexComponents.js

@@ -0,0 +1,23 @@
+import { unique } from 'radash';
+import { validateEntityIndexToken } from './validateEntityIndexToken.js';
+
+/**
+ * Get the index components of an entity index. Adds the hash and range keys to the index components.
+ *
+ * @param entityManager - {@link EntityManager | `EntityManager`} instance.
+ * @param entityToken - {@link ConfigKeys.entities | `entityManager.config.entities`} key.
+ * @param indexToken - {@link ConfigEntity.indexes | `entityManager.config.entities.<entityToken>.indexes`} key.
+ *
+ * @returns Array of index components.
+ *
+ * @throws `Error` if `entityToken` is invalid.
+ * @throws `Error` if `indexToken` is invalid.
+ */
+function getIndexComponents(entityManager, entityToken, indexToken) {
+    validateEntityIndexToken(entityManager, entityToken, indexToken);
+    const { hashKey, rangeKey, entities } = entityManager.config;
+    const { hashKey: indexHashKey, rangeKey: indexRangeKey } = entities[entityToken].indexes[indexToken];
+    return unique([hashKey, rangeKey, indexHashKey, indexRangeKey]);
+}
+
+export { getIndexComponents };

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';
@@ -49,8 +50,7 @@ function rehydratePageKeyMap(entityManager, dehydrated, entityToken, indexTokens
                 ...rehydrateIndexItem(entityManager, dehydratedIndexPageKeyMaps[i], entityToken, index, [entityManager.config.hashKey]),
             };
             item = updateItemRangeKey(entityManager, item, entityToken);
-            return zipToObject(entityManager.config.entities[entityToken].indexes[index]
-                .components, (component) => entityManager.config.entities[entityToken].generated[component]
+            return zipToObject(getIndexComponents(entityManager, entityToken, index), (component) => entityManager.config.entities[entityToken].generated[component]
                 ? encodeGeneratedProperty(entityManager, item, entityToken, component)
                 : item[component]);
         }));

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/package.json

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