@karmaniverous/entity-manager 6.13.0 → 6.13.2

package/dist/cjs/EntityManager.js

@@ -111,11 +111,14 @@ class EntityManager {
      *
      * @param hashKeyToken - Index hash key.
      * @param rangeKeyToken - Index range key.
+     * @param suppressError - Suppress error if no match found.
      *
      * @returns  Index token if found.
+     *
+     * @throws `Error` if no match found and `suppressError` is not `true`.
      */
-    findIndexToken(hashKeyToken, rangeKeyToken) {
-        return findIndexToken.findIndexToken(this, hashKeyToken, rangeKeyToken);
+    findIndexToken(hashKeyToken, rangeKeyToken, suppressError) {
+        return findIndexToken.findIndexToken(this, hashKeyToken, rangeKeyToken, suppressError);
     }
     /**
      * Query a database entity across shards in a provider-generic fashion.

package/dist/cjs/ParsedConfig.js

@@ -103,7 +103,10 @@ const configSchema = zod.z
         .record(zod.z.object({
         hashKey: zod.z.string().min(1),
         rangeKey: zod.z.string().min(1),
-        projections: componentArray.optional(),
+        projections: zod.z
+            .array(zod.z.string().min(1))
+            .superRefine(validateArrayUnique)
+            .optional(),
     }))
         .optional()
         .default({}),

package/dist/cjs/findIndexToken.js

@@ -6,11 +6,17 @@
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
  * @param hashKeyToken - Index hash key.
  * @param rangeKeyToken - Index range key.
+ * @param suppressError - Suppress error if no match found.
  *
  * @returns  Index token if found.
+ *
+ * @throws `Error` if no match found and `suppressError` is not `true`.
  */
-function findIndexToken(entityManager, hashKeyToken, rangeKeyToken) {
-    return Object.entries(entityManager.config.indexes).find(([, index]) => index.hashKey === hashKeyToken && index.rangeKey === rangeKeyToken)?.[0];
+function findIndexToken(entityManager, hashKeyToken, rangeKeyToken, suppressError) {
+    const indexToken = Object.entries(entityManager.config.indexes).find(([, index]) => index.hashKey === hashKeyToken && index.rangeKey === rangeKeyToken)?.[0];
+    if (!indexToken && !suppressError)
+        throw new Error(`No index token found for hashKey '${hashKeyToken}' & rangeKey '${rangeKeyToken}'.`);
+    return indexToken;
 }
 
 exports.findIndexToken = findIndexToken;

package/dist/index.d.ts

@@ -194,15 +194,15 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     indexes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         hashKey: z.ZodString;
         rangeKey: z.ZodString;
-        projections: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "atleastone">, [string, ...string[]], [string, ...string[]]>>;
+        projections: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
     }, "strip", z.ZodTypeAny, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }>>>>;
     generatedKeyDelimiter: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     generatedValueDelimiter: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -241,7 +241,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     indexes: Record<string, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }>;
     generatedKeyDelimiter: string;
     generatedValueDelimiter: string;
@@ -273,7 +273,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     indexes?: Record<string, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }> | undefined;
     generatedKeyDelimiter?: string | undefined;
     generatedValueDelimiter?: string | undefined;
@@ -305,7 +305,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     indexes: Record<string, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }>;
     generatedKeyDelimiter: string;
     generatedValueDelimiter: string;
@@ -337,7 +337,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     indexes?: Record<string, {
         hashKey: string;
         rangeKey: string;
-        projections?: [string, ...string[]] | undefined;
+        projections?: string[] | undefined;
     }> | undefined;
     generatedKeyDelimiter?: string | undefined;
     generatedValueDelimiter?: string | undefined;
@@ -592,10 +592,13 @@ declare class EntityManager<C extends BaseConfigMap> {
      *
      * @param hashKeyToken - Index hash key.
      * @param rangeKeyToken - Index range key.
+     * @param suppressError - Suppress error if no match found.
      *
      * @returns  Index token if found.
+     *
+     * @throws `Error` if no match found and `suppressError` is not `true`.
      */
-    findIndexToken(hashKeyToken: string, rangeKeyToken: string): string | undefined;
+    findIndexToken(hashKeyToken: string, rangeKeyToken: string, suppressError?: boolean): string | undefined;
     /**
      * Query a database entity across shards in a provider-generic fashion.
      *

package/dist/mjs/EntityManager.js

@@ -109,11 +109,14 @@ class EntityManager {
      *
      * @param hashKeyToken - Index hash key.
      * @param rangeKeyToken - Index range key.
+     * @param suppressError - Suppress error if no match found.
      *
      * @returns  Index token if found.
+     *
+     * @throws `Error` if no match found and `suppressError` is not `true`.
      */
-    findIndexToken(hashKeyToken, rangeKeyToken) {
-        return findIndexToken(this, hashKeyToken, rangeKeyToken);
+    findIndexToken(hashKeyToken, rangeKeyToken, suppressError) {
+        return findIndexToken(this, hashKeyToken, rangeKeyToken, suppressError);
     }
     /**
      * Query a database entity across shards in a provider-generic fashion.

package/dist/mjs/ParsedConfig.js

@@ -101,7 +101,10 @@ const configSchema = z
         .record(z.object({
         hashKey: z.string().min(1),
         rangeKey: z.string().min(1),
-        projections: componentArray.optional(),
+        projections: z
+            .array(z.string().min(1))
+            .superRefine(validateArrayUnique)
+            .optional(),
     }))
         .optional()
         .default({}),

package/dist/mjs/findIndexToken.js

@@ -4,11 +4,17 @@
  * @param entityManager - {@link EntityManager | `EntityManager`} instance.
  * @param hashKeyToken - Index hash key.
  * @param rangeKeyToken - Index range key.
+ * @param suppressError - Suppress error if no match found.
  *
  * @returns  Index token if found.
+ *
+ * @throws `Error` if no match found and `suppressError` is not `true`.
  */
-function findIndexToken(entityManager, hashKeyToken, rangeKeyToken) {
-    return Object.entries(entityManager.config.indexes).find(([, index]) => index.hashKey === hashKeyToken && index.rangeKey === rangeKeyToken)?.[0];
+function findIndexToken(entityManager, hashKeyToken, rangeKeyToken, suppressError) {
+    const indexToken = Object.entries(entityManager.config.indexes).find(([, index]) => index.hashKey === hashKeyToken && index.rangeKey === rangeKeyToken)?.[0];
+    if (!indexToken && !suppressError)
+        throw new Error(`No index token found for hashKey '${hashKeyToken}' & rangeKey '${rangeKeyToken}'.`);
+    return indexToken;
 }
 
 export { findIndexToken };

package/package.json

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