@resistdesign/voltra 3.0.0-alpha.32 → 3.0.0-alpha.34

package/README.md

@@ -131,8 +131,10 @@ EasyLayout now has:
 - Client routing: `examples/routing/app-routing.ts`
 - Backend API routing: `examples/api/backend-routing.ts`
 - Forms: `examples/forms/`
+  - `examples/forms/auto-form-validation-customization.tsx`
 - Layout: `examples/layout/`
 - Common types: `examples/common/types.ts`
+  - `examples/common/typeinfo-validation.ts`
 - Build-time parsing: `examples/build/type-parsing.ts`
 
 ### Template syntax
@@ -191,12 +193,13 @@ const coords = layout.computeNativeCoords({
 
 ## Routing (Web + Native)
 
-Voltra routing is unified under `@resistdesign/voltra/app`.
+Voltra routing uses the same `Route` API across app/web/native.
+Use the platform barrel for root `Route` so runtime mechanics are auto-wired.
 
 Reference example: `examples/routing/app-routing.ts`
 
 ```tsx
-import { Route } from "@resistdesign/voltra/app";
+import { Route } from "@resistdesign/voltra/web";
 
 <Route>
   <Route path="/" exact>
@@ -211,6 +214,16 @@ import { Route } from "@resistdesign/voltra/app";
 </Route>;
 ```
 
+```tsx
+import { Route } from "@resistdesign/voltra/native";
+
+<Route>
+  <Route path="/" exact>
+    <HomeScreen />
+  </Route>
+</Route>;
+```
+
 How it works:
 
 - Root `<Route>` (no `path`) is provider mode.
@@ -311,6 +324,63 @@ Renderers emit actions via:
 
 Use these to wire modals, selectors, or editors without baking UI into the core engine.
 
+### Centralized Validation
+
+All TypeInfo data-item validation can be run directly from `@resistdesign/voltra/common`:
+
+```ts
+import { validateTypeInfoDataItem } from "@resistdesign/voltra/common";
+```
+
+`validateTypeInfoDataItem` supports:
+
+- field-level `customValidatorMap` callbacks that return `ErrorDescriptor`
+- `tags.validation` field options:
+  - `validateHidden`
+  - `validateReadonly`
+  - `emptyArrayIsValid`
+
+AutoForm passes validation through the same centralized logic and supports:
+
+- `customValidatorMap` for app-specific rules
+- `translateValidationErrorCode` for UI-facing messages
+- multiple value-level errors per field
+- per-index array item errors for array fields
+
+Validation error maps can include both value-level errors and array item errors:
+
+```ts
+{
+  errorMap: {
+    title: [
+      { code: "MISSING_FIELD_VALUE" },
+      { code: "VALUE_DOES_NOT_MATCH_PATTERN" }
+    ],
+    tags: [
+      { code: "INVALID_TYPE" },
+      {
+        itemErrorMap: {
+          0: [{ code: "NOT_A_STRING" }],
+          2: [
+            { code: "NOT_A_STRING" },
+            { code: "INVALID_CUSTOM_TYPE" }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+- Field-level multiple errors are represented by multiple `ErrorDescriptor` entries in the field array.
+- Array item errors are represented by `itemErrorMap[index] = ErrorDescriptor[]`.
+
+Error-code constants are split by purpose:
+
+- `PRIMITIVE_ERROR_MESSAGE_CONSTANTS` keys follow `typeof` (`string`, `number`, `boolean`)
+- `DENIED_TYPE_OPERATIONS` keys follow `TypeOperation` (`CREATE`, `READ`, `UPDATE`, `DELETE`)
+- `ERROR_MESSAGE_CONSTANTS` exposes canonical code-keyed entries (for example `NOT_A_STRING`, `DENIED_TYPE_OPERATION_CREATE`)
+
 ## Docs Site
 
 The docs site is both reference documentation and a canonical usage example.

package/api/Indexing/fulltext/FullTextDdbBackend.d.ts

@@ -1,7 +1,7 @@
 import type { DocId, DocTokenKey, DocumentRecord, TokenStats } from "../Types";
 import type { SearchTrace } from "../Trace";
 import type { DynamoBatchWriter, DynamoQueryClient, WriteRequest } from "../ddb/Types";
-export type { BatchGetItemInput, BatchGetItemOutput, BatchWriteItemInput, BatchWriteItemOutput, DynamoBatchWriter, DynamoQueryClient, GetItemInput, GetItemOutput, KeysAndAttributes, QueryInput, QueryOutput, WriteRequest, } from "../ddb/Types";
+export * from "../ddb/Types";
 /**
  * Deployment-specific DynamoDB table names required for fulltext storage.
  */
@@ -82,7 +82,7 @@ export type FullTextDdbBackendConfig = FullTextDdbWriterConfig & {
 /**
  * Page of lossy postings results.
  */
-export type LossyPostingsPage = {
+type LossyPostingsPage = {
     /**
      * Document ids in the page.
      */
@@ -95,7 +95,7 @@ export type LossyPostingsPage = {
 /**
  * Paging options for lossy postings queries.
  */
-export type LossyPostingsPageOptions = {
+type LossyPostingsPageOptions = {
     /**
      * Exclusive starting doc id for paging.
      */
@@ -208,3 +208,5 @@ export declare class FullTextDdbBackend extends FullTextDdbWriter {
      */
     loadTokenStats(token: string, indexField: string): Promise<TokenStats | undefined>;
 }
+export type FullTextLossyPostingsPage = LossyPostingsPage;
+export type FullTextLossyPostingsPageOptions = LossyPostingsPageOptions;

package/api/Indexing/index.d.ts

@@ -28,7 +28,7 @@ export * from "./exact/ExactDdb";
 export * from "./exact/ExactIndex";
 export * from "./exact/ExactS3";
 export * from "./fulltext/FullTextMemoryBackend";
-export { FullTextDdbBackend, FullTextDdbWriter, type FullTextTableNames, } from "./fulltext/FullTextDdbBackend";
+export * from "./fulltext/FullTextDdbBackend";
 export * from "./fulltext/Schema";
 export * from "./lossy/LossyDdb";
 export * from "./lossy/LossyIndex";
@@ -36,10 +36,10 @@ export * from "./lossy/LossyS3";
 export * from "./rel/RelationalInMemoryBackend";
 export * from "./rel/RelationalDdb";
 export * from "./rel/Cursor";
-export { handler as relHandler, setRelationalHandlerDependencies, type EdgePutEvent, type EdgeRemoveEvent, type EdgeQueryEvent, type RelationalHandlerDependencies, type RelationalHandlerEvent, type LambdaResponse as RelLambdaResponse, } from "./rel/Handlers";
+export * from "./rel/Handlers";
 export * from "./rel/Types";
 export * from "./structured/index";
 export * from "./tokenize";
 export * from "./Types";
 export * from "./Trace";
-export type { ResolvedSearchLimits } from "./Handler/Config";
+export * from "./Handler/Config";

package/api/Indexing/rel/Handlers.d.ts

@@ -107,7 +107,7 @@ export type RelationalHandlerDependencies<TMetadata extends EdgeMetadata = EdgeM
 /**
  * Lambda-style response payload.
  */
-export type LambdaResponse = {
+export type RelLambdaResponse = {
     /**
      * HTTP status code for the response.
      */
@@ -139,5 +139,6 @@ value: RelationalHandlerDependencies): void;
  * @param event Handler event describing the operation to execute.
  * @returns Lambda response with status and body payload.
  */
-export declare function handler(event: RelationalHandlerEvent): Promise<LambdaResponse>;
+export declare function handler(event: RelationalHandlerEvent): Promise<RelLambdaResponse>;
+export declare const relHandler: typeof handler;
 export {};

package/api/ORM/drivers/index.d.ts

@@ -5,4 +5,4 @@ export * from "./InMemoryItemRelationshipDBDriver";
 export * from "./InMemoryFileItemDBDriver";
 export * from "./IndexingRelationshipDriver";
 export * from "./common";
-export type { S3SpecificConfig } from "./S3FileItemDBDriver/ConfigTypes";
+export * from "./S3FileItemDBDriver/ConfigTypes";

package/api/ORM/index.d.ts

@@ -5,14 +5,5 @@ export * from "./drivers";
 export * from "./TypeInfoORMService";
 export * from "./DACUtils";
 export * from "./ORMRouteMap";
-/**
- * @category api
- * @group Type Dependencies
- */
-export type { BaseDACRole, DACAccessResult, DACConstraint, DACDataItemResourceAccessResultMap, DACRole, } from "../DataAccessControl";
-export { DACConstraintType } from "../DataAccessControl";
-/**
- * @category api
- * @group Type Dependencies
- */
-export type { AuthInfo, NormalizedCloudFunctionEventData, Route, RouteAuthConfig, RouteHandler, RouteMap, } from "../Router/Types";
+export * from "../DataAccessControl";
+export * from "../Router/Types";

package/api/index.js

@@ -1,7 +1,5 @@
-import '../chunk-MUCSL3UR.js';
-import { ERROR_MESSAGE_CONSTANTS, validateTypeOperationAllowed, getValidityValue, validateTypeInfoValue, validateTypeInfoFieldValue } from '../chunk-LGM75I6P.js';
-import { ITEM_RELATIONSHIP_DAC_RESOURCE_NAME } from '../chunk-HVY7POTD.js';
-import '../chunk-IWRHGGGH.js';
+import { ITEM_RELATIONSHIP_DAC_RESOURCE_NAME, ComparisonOperators } from '../chunk-7AMEFPPP.js';
+import { getNoErrorDescriptor, getErrorDescriptor, ERROR_MESSAGE_CONSTANTS, validateTypeOperationAllowed, getValidityValue, validateTypeInfoValue, validateTypeInfoFieldValue } from '../chunk-WTD5BBJP.js';
 import { mergeStringPaths, getPathString, getPathArray } from '../chunk-GYWRAW3Y.js';
 import '../chunk-I2KLQ2HA.js';
 import { QueryCommand, GetItemCommand, BatchGetItemCommand, BatchWriteItemCommand, DynamoDBClient, PutItemCommand, UpdateItemCommand, DeleteItemCommand, ScanCommand } from '@aws-sdk/client-dynamodb';
@@ -9,8 +7,6 @@ import { marshall, unmarshall } from '@aws-sdk/util-dynamodb';
 import { S3, PutObjectCommand, HeadObjectCommand, CopyObjectCommand, GetObjectCommand, DeleteObjectCommand, ListObjectsV2Command } from '@aws-sdk/client-s3';
 import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
 import { v4 } from 'uuid';
-import Path from 'path';
-import { fileURLToPath } from 'url';
 
 // src/api/Indexing/Cursor.ts
 var textEncoder = new TextEncoder();
@@ -212,6 +208,44 @@ var SEARCH_DEFAULTS = {
   maxCandidatesVerified: 200,
   softTimeBudgetMs: 150
 };
+var SEARCH_CAPS = {
+  maxTokens: Number.POSITIVE_INFINITY,
+  maxPostingsPages: Number.POSITIVE_INFINITY,
+  maxCandidatesVerified: Number.POSITIVE_INFINITY,
+  softTimeBudgetMs: Number.POSITIVE_INFINITY
+};
+function clampLimit(value, fallback, cap) {
+  if (!Number.isFinite(value)) {
+    return Math.min(fallback, cap);
+  }
+  const safeValue = Math.max(0, value);
+  return Math.min(safeValue, cap);
+}
+function resolveSearchLimits(limits) {
+  const requested = { ...SEARCH_DEFAULTS, ...limits };
+  return {
+    maxTokens: clampLimit(
+      requested.maxTokens,
+      SEARCH_DEFAULTS.maxTokens,
+      SEARCH_CAPS.maxTokens
+    ),
+    maxPostingsPages: clampLimit(
+      requested.maxPostingsPages,
+      SEARCH_DEFAULTS.maxPostingsPages,
+      SEARCH_CAPS.maxPostingsPages
+    ),
+    maxCandidatesVerified: clampLimit(
+      requested.maxCandidatesVerified,
+      SEARCH_DEFAULTS.maxCandidatesVerified,
+      SEARCH_CAPS.maxCandidatesVerified
+    ),
+    softTimeBudgetMs: clampLimit(
+      requested.softTimeBudgetMs,
+      SEARCH_DEFAULTS.softTimeBudgetMs,
+      SEARCH_CAPS.softTimeBudgetMs
+    )
+  };
+}
 
 // src/api/Indexing/hashUniversal.ts
 var textEncoder2 = new TextEncoder();
@@ -800,7 +834,7 @@ async function searchLossy({
     setBackendTrace(reader, void 0);
   }
 }
-async function hasExactPhrase(reader, docId, indexField, phraseTokens, docTokenChecker, positionsLoader) {
+async function hasExactPhrase(docId, phraseTokens, docTokenChecker, positionsLoader) {
   if (phraseTokens.length === 0) {
     return false;
   }
@@ -902,9 +936,7 @@ async function searchExact({
           continue;
         }
         if (await hasExactPhrase(
-          reader,
           docId,
-          indexField,
           exactTokens,
           docTokenChecker,
           positionsLoader
@@ -943,9 +975,7 @@ async function searchExact({
     const verifyCandidate = async (docId) => {
       lastProcessedDocId = docId;
       return hasExactPhrase(
-        reader,
         docId,
-        indexField,
         exactTokens,
         docTokenChecker,
         positionsLoader
@@ -2989,6 +3019,7 @@ async function handler(event) {
       };
   }
 }
+var relHandler = handler;
 
 // src/api/Indexing/structured/Cursor.ts
 function encodeBase64Url2(value) {
@@ -4275,57 +4306,30 @@ var S3FileDriver = class {
   };
 };
 
-// src/common/SearchTypes.ts
-var ComparisonOperators = /* @__PURE__ */ ((ComparisonOperators2) => {
-  ComparisonOperators2["EQUALS"] = "EQUALS";
-  ComparisonOperators2["NOT_EQUALS"] = "NOT_EQUALS";
-  ComparisonOperators2["GREATER_THAN"] = "GREATER_THAN";
-  ComparisonOperators2["GREATER_THAN_OR_EQUAL"] = "GREATER_THAN_OR_EQUAL";
-  ComparisonOperators2["LESS_THAN"] = "LESS_THAN";
-  ComparisonOperators2["LESS_THAN_OR_EQUAL"] = "LESS_THAN_OR_EQUAL";
-  ComparisonOperators2["IN"] = "IN";
-  ComparisonOperators2["NOT_IN"] = "NOT_IN";
-  ComparisonOperators2["LIKE"] = "LIKE";
-  ComparisonOperators2["NOT_LIKE"] = "NOT_LIKE";
-  ComparisonOperators2["EXISTS"] = "EXISTS";
-  ComparisonOperators2["NOT_EXISTS"] = "NOT_EXISTS";
-  ComparisonOperators2["IS_NOT_EMPTY"] = "IS_NOT_EMPTY";
-  ComparisonOperators2["IS_EMPTY"] = "IS_EMPTY";
-  ComparisonOperators2["BETWEEN"] = "BETWEEN";
-  ComparisonOperators2["NOT_BETWEEN"] = "NOT_BETWEEN";
-  ComparisonOperators2["CONTAINS"] = "CONTAINS";
-  ComparisonOperators2["NOT_CONTAINS"] = "NOT_CONTAINS";
-  ComparisonOperators2["STARTS_WITH"] = "STARTS_WITH";
-  ComparisonOperators2["ENDS_WITH"] = "ENDS_WITH";
-  ComparisonOperators2["DOES_NOT_START_WITH"] = "DOES_NOT_START_WITH";
-  ComparisonOperators2["DOES_NOT_END_WITH"] = "DOES_NOT_END_WITH";
-  return ComparisonOperators2;
-})(ComparisonOperators || {});
-
 // src/common/SearchUtils.ts
 var COMPARATORS = {
-  ["EQUALS" /* EQUALS */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue === criterionValue,
-  ["NOT_EQUALS" /* NOT_EQUALS */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue !== criterionValue,
-  ["GREATER_THAN" /* GREATER_THAN */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue > criterionValue,
-  ["GREATER_THAN_OR_EQUAL" /* GREATER_THAN_OR_EQUAL */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue >= criterionValue,
-  ["LESS_THAN" /* LESS_THAN */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue < criterionValue,
-  ["LESS_THAN_OR_EQUAL" /* LESS_THAN_OR_EQUAL */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue <= criterionValue,
-  ["IN" /* IN */]: (criterionValue, criterionValueOptions, fieldValue) => Array.isArray(criterionValueOptions) && criterionValueOptions.includes(fieldValue),
-  ["NOT_IN" /* NOT_IN */]: (criterionValue, criterionValueOptions, fieldValue) => !Array.isArray(criterionValueOptions) || !criterionValueOptions.includes(fieldValue),
-  ["LIKE" /* LIKE */]: (criterionValue, criterionValueOptions, fieldValue) => `${fieldValue}`.includes(`${criterionValue}`),
-  ["NOT_LIKE" /* NOT_LIKE */]: (criterionValue, criterionValueOptions, fieldValue) => !`${fieldValue}`.includes(`${criterionValue}`),
-  ["EXISTS" /* EXISTS */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue !== void 0 && fieldValue !== null,
-  ["NOT_EXISTS" /* NOT_EXISTS */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue === void 0 || fieldValue === null,
-  ["IS_NOT_EMPTY" /* IS_NOT_EMPTY */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue !== void 0 && fieldValue !== null && fieldValue !== "",
-  ["IS_EMPTY" /* IS_EMPTY */]: (criterionValue, criterionValueOptions, fieldValue) => fieldValue === void 0 || fieldValue === null || fieldValue === "",
-  ["BETWEEN" /* BETWEEN */]: (criterionValue, criterionValueOptions, fieldValue) => Array.isArray(criterionValueOptions) && fieldValue >= criterionValueOptions[0] && fieldValue <= criterionValueOptions[1],
-  ["NOT_BETWEEN" /* NOT_BETWEEN */]: (criterionValue, criterionValueOptions, fieldValue) => !Array.isArray(criterionValueOptions) || fieldValue < criterionValueOptions[0] || fieldValue > criterionValueOptions[1],
-  ["CONTAINS" /* CONTAINS */]: (criterionValue, criterionValueOptions, fieldValue) => Array.isArray(fieldValue) && fieldValue.includes(criterionValue),
-  ["NOT_CONTAINS" /* NOT_CONTAINS */]: (criterionValue, criterionValueOptions, fieldValue) => !Array.isArray(fieldValue) || !fieldValue.includes(criterionValue),
-  ["STARTS_WITH" /* STARTS_WITH */]: (criterionValue, criterionValueOptions, fieldValue) => `${fieldValue}`.startsWith(`${criterionValue}`),
-  ["ENDS_WITH" /* ENDS_WITH */]: (criterionValue, criterionValueOptions, fieldValue) => `${fieldValue}`.endsWith(`${criterionValue}`),
-  ["DOES_NOT_START_WITH" /* DOES_NOT_START_WITH */]: (criterionValue, criterionValueOptions, fieldValue) => !`${fieldValue}`.startsWith(`${criterionValue}`),
-  ["DOES_NOT_END_WITH" /* DOES_NOT_END_WITH */]: (criterionValue, criterionValueOptions, fieldValue) => !`${fieldValue}`.endsWith(`${criterionValue}`)
+  ["EQUALS" /* EQUALS */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue === criterionValue,
+  ["NOT_EQUALS" /* NOT_EQUALS */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue !== criterionValue,
+  ["GREATER_THAN" /* GREATER_THAN */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue > criterionValue,
+  ["GREATER_THAN_OR_EQUAL" /* GREATER_THAN_OR_EQUAL */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue >= criterionValue,
+  ["LESS_THAN" /* LESS_THAN */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue < criterionValue,
+  ["LESS_THAN_OR_EQUAL" /* LESS_THAN_OR_EQUAL */]: (criterionValue, _criterionValueOptions, fieldValue) => fieldValue <= criterionValue,
+  ["IN" /* IN */]: (_criterionValue, criterionValueOptions, fieldValue) => Array.isArray(criterionValueOptions) && criterionValueOptions.includes(fieldValue),
+  ["NOT_IN" /* NOT_IN */]: (_criterionValue, criterionValueOptions, fieldValue) => !Array.isArray(criterionValueOptions) || !criterionValueOptions.includes(fieldValue),
+  ["LIKE" /* LIKE */]: (criterionValue, _criterionValueOptions, fieldValue) => `${fieldValue}`.includes(`${criterionValue}`),
+  ["NOT_LIKE" /* NOT_LIKE */]: (criterionValue, _criterionValueOptions, fieldValue) => !`${fieldValue}`.includes(`${criterionValue}`),
+  ["EXISTS" /* EXISTS */]: (_criterionValue, _criterionValueOptions, fieldValue) => fieldValue !== void 0 && fieldValue !== null,
+  ["NOT_EXISTS" /* NOT_EXISTS */]: (_criterionValue, _criterionValueOptions, fieldValue) => fieldValue === void 0 || fieldValue === null,
+  ["IS_NOT_EMPTY" /* IS_NOT_EMPTY */]: (_criterionValue, _criterionValueOptions, fieldValue) => fieldValue !== void 0 && fieldValue !== null && fieldValue !== "",
+  ["IS_EMPTY" /* IS_EMPTY */]: (_criterionValue, _criterionValueOptions, fieldValue) => fieldValue === void 0 || fieldValue === null || fieldValue === "",
+  ["BETWEEN" /* BETWEEN */]: (_criterionValue, criterionValueOptions, fieldValue) => Array.isArray(criterionValueOptions) && fieldValue >= criterionValueOptions[0] && fieldValue <= criterionValueOptions[1],
+  ["NOT_BETWEEN" /* NOT_BETWEEN */]: (_criterionValue, criterionValueOptions, fieldValue) => !Array.isArray(criterionValueOptions) || fieldValue < criterionValueOptions[0] || fieldValue > criterionValueOptions[1],
+  ["CONTAINS" /* CONTAINS */]: (criterionValue, _criterionValueOptions, fieldValue) => Array.isArray(fieldValue) && fieldValue.includes(criterionValue),
+  ["NOT_CONTAINS" /* NOT_CONTAINS */]: (criterionValue, _criterionValueOptions, fieldValue) => !Array.isArray(fieldValue) || !fieldValue.includes(criterionValue),
+  ["STARTS_WITH" /* STARTS_WITH */]: (criterionValue, _criterionValueOptions, fieldValue) => `${fieldValue}`.startsWith(`${criterionValue}`),
+  ["ENDS_WITH" /* ENDS_WITH */]: (criterionValue, _criterionValueOptions, fieldValue) => `${fieldValue}`.endsWith(`${criterionValue}`),
+  ["DOES_NOT_START_WITH" /* DOES_NOT_START_WITH */]: (criterionValue, _criterionValueOptions, fieldValue) => !`${fieldValue}`.startsWith(`${criterionValue}`),
+  ["DOES_NOT_END_WITH" /* DOES_NOT_END_WITH */]: (criterionValue, _criterionValueOptions, fieldValue) => !`${fieldValue}`.endsWith(`${criterionValue}`)
 };
 var compare = (fieldCriterion, fieldValue) => {
   const {
@@ -4356,6 +4360,9 @@ var getFilterTypeInfoDataItemsBySearchCriteria = (searchCriteria, items, typeInf
   for (const currentItem of items) {
     if (typeof currentItem === "object" && currentItem !== null) {
       let meetsCriteria = true;
+      if (logicalOperator === "OR" /* OR */ && fieldCriteria.length > 0) {
+        meetsCriteria = false;
+      }
       for (const fieldCriterion of fieldCriteria) {
         const { fieldName } = fieldCriterion;
         const { array: isArrayType, typeReference } = fields[fieldName] || {};
@@ -5600,7 +5607,6 @@ var ConfigTypeInfoMap_default2 = {
 };
 
 // src/api/ORM/drivers/DynamoDBDataItemDBDriver.ts
-typeof __dirname === "string" ? __dirname : Path.dirname(fileURLToPath(import.meta.url));
 var DynamoDBOperatorMappings = {
   ["EQUALS" /* EQUALS */]: (fieldName) => `#${fieldName} = :${fieldName}`,
   ["NOT_EQUALS" /* NOT_EQUALS */]: (fieldName) => `#${fieldName} <> :${fieldName}`,
@@ -5889,7 +5895,6 @@ var ConfigTypeInfoMap_default3 = {
 };
 
 // src/api/ORM/drivers/InMemoryDataItemDBDriver.ts
-typeof __dirname === "string" ? __dirname : Path.dirname(fileURLToPath(import.meta.url));
 var decodeCursor2 = (cursor) => {
   if (!cursor) {
     return 0;
@@ -6100,7 +6105,6 @@ var ConfigTypeInfoMap_default4 = {
 };
 
 // src/api/ORM/drivers/InMemoryFileItemDBDriver.ts
-typeof __dirname === "string" ? __dirname : Path.dirname(fileURLToPath(import.meta.url));
 var decodeCursor3 = (cursor) => {
   if (!cursor) {
     return 0;
@@ -6475,7 +6479,7 @@ var validateSearchFields = (typeInfoName, typeInfoMap, searchFields = [], disall
   const results = {
     typeName: typeInfoName,
     valid: true,
-    error: "",
+    error: getNoErrorDescriptor(),
     errorMap: {}
   };
   if (typeInfo) {
@@ -6485,7 +6489,7 @@ var validateSearchFields = (typeInfoName, typeInfoMap, searchFields = [], disall
       if (!customOperator && (!operator || !Object.values(ComparisonOperators).includes(operator))) {
         results.valid = false;
         results.errorMap[fieldName] = [
-          SEARCH_VALIDATION_ERRORS.INVALID_OPERATOR
+          getErrorDescriptor(SEARCH_VALIDATION_ERRORS.INVALID_OPERATOR)
         ];
       } else {
         const tIF = fields[fieldName];
@@ -6495,12 +6499,14 @@ var validateSearchFields = (typeInfoName, typeInfoMap, searchFields = [], disall
           if (denyRead) {
             results.valid = false;
             results.errorMap[fieldName] = [
-              SEARCH_VALIDATION_ERRORS.INVALID_FIELD
+              getErrorDescriptor(SEARCH_VALIDATION_ERRORS.INVALID_FIELD)
             ];
           } else if (typeReference) {
             results.valid = false;
             results.errorMap[fieldName] = [
-              SEARCH_VALIDATION_ERRORS.RELATIONAL_FIELDS_NOT_ALLOWED
+              getErrorDescriptor(
+                SEARCH_VALIDATION_ERRORS.RELATIONAL_FIELDS_NOT_ALLOWED
+              )
             ];
           } else {
             if (operator && OPERATORS_WITHOUT_VALUES.has(operator)) {
@@ -6512,7 +6518,7 @@ var validateSearchFields = (typeInfoName, typeInfoMap, searchFields = [], disall
                 tVO,
                 tIF,
                 typeInfoMap,
-                false,
+                true,
                 true,
                 customValidators,
                 "READ" /* READ */,
@@ -6530,14 +6536,14 @@ var validateSearchFields = (typeInfoName, typeInfoMap, searchFields = [], disall
         } else {
           results.valid = false;
           results.errorMap[fieldName] = [
-            SEARCH_VALIDATION_ERRORS.INVALID_FIELD
+            getErrorDescriptor(SEARCH_VALIDATION_ERRORS.INVALID_FIELD)
           ];
         }
       }
     }
   } else {
     results.valid = false;
-    results.error = SEARCH_VALIDATION_ERRORS.INVALID_TYPE_INFO;
+    results.error = getErrorDescriptor(SEARCH_VALIDATION_ERRORS.INVALID_TYPE_INFO);
   }
   return results;
 };
@@ -6553,7 +6559,7 @@ var validateRelationshipItem = (relationshipItem, omitFields) => {
   const results = {
     typeName: fromTypeName,
     valid: true,
-    error: "",
+    error: getNoErrorDescriptor(),
     errorMap: {}
   };
   if (typeof relationshipItem === "object" && relationshipItem !== null) {
@@ -6566,24 +6572,34 @@ var validateRelationshipItem = (relationshipItem, omitFields) => {
         universalRKV in relationshipItem && typeof relationshipItem[universalRKV] !== "string" || omitRKV && universalRKV in relationshipItem
       ) {
         results.valid = false;
-        results.error = TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM;
+        results.error = getErrorDescriptor(
+          TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM
+        );
         results.errorMap[rKV] = [
-          TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM_FIELD
+          getErrorDescriptor(
+            TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM_FIELD
+          )
         ];
       } else if (
         // Missing Field
         !omitRKV && (!(universalRKV in relationshipItem) || !relationshipItem[universalRKV])
       ) {
         results.valid = false;
-        results.error = TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM;
+        results.error = getErrorDescriptor(
+          TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM
+        );
         results.errorMap[rKV] = [
-          TYPE_INFO_ORM_RELATIONSHIP_ERRORS.MISSING_RELATIONSHIP_ITEM_FIELD
+          getErrorDescriptor(
+            TYPE_INFO_ORM_RELATIONSHIP_ERRORS.MISSING_RELATIONSHIP_ITEM_FIELD
+          )
         ];
       }
     }
   } else {
     results.valid = false;
-    results.error = TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM;
+    results.error = getErrorDescriptor(
+      TYPE_INFO_ORM_RELATIONSHIP_ERRORS.INVALID_RELATIONSHIP_ITEM
+    );
   }
   return results;
 };
@@ -6592,13 +6608,7 @@ var validateRelationshipItem = (relationshipItem, omitFields) => {
 var removeNonexistentFieldsFromSelectedFields = (typeInfo = {}, selectedFields) => {
   if (Array.isArray(selectedFields)) {
     const { fields = {} } = typeInfo;
-    const cleanSelectFields = [];
-    for (const tIF in fields) {
-      if (selectedFields.includes(tIF)) {
-        cleanSelectFields.push(tIF);
-      }
-    }
-    return cleanSelectFields;
+    return selectedFields.filter((field) => Boolean(fields[field]));
   } else {
     return selectedFields;
   }
@@ -6606,14 +6616,10 @@ var removeNonexistentFieldsFromSelectedFields = (typeInfo = {}, selectedFields)
 var removeTypeReferenceFieldsFromSelectedFields = (typeInfo = {}, selectedFields) => {
   if (Array.isArray(selectedFields)) {
     const { fields = {} } = typeInfo;
-    const cleanSelectFields = [];
-    for (const tIF in fields) {
-      const { typeReference } = fields[tIF];
-      if (typeof typeReference === "undefined" && selectedFields.includes(tIF)) {
-        cleanSelectFields.push(tIF);
-      }
-    }
-    return cleanSelectFields;
+    return selectedFields.filter((field) => {
+      const typeInfoField = fields[field];
+      return typeInfoField && typeof typeInfoField.typeReference === "undefined";
+    });
   } else {
     return selectedFields;
   }
@@ -7581,7 +7587,7 @@ var TypeInfoORMService = class {
     const results = {
       typeName,
       valid: !!typeInfo,
-      error: !!typeInfo ? "" : ERROR_MESSAGE_CONSTANTS.TYPE_DOES_NOT_EXIST,
+      error: !!typeInfo ? getNoErrorDescriptor() : getErrorDescriptor(ERROR_MESSAGE_CONSTANTS.TYPE_DOES_NOT_EXIST),
       errorMap: {}
     };
     const {
@@ -7600,7 +7606,7 @@ var TypeInfoORMService = class {
       const existingError = results.errorMap[oE] ?? [];
       results.errorMap[oE] = existingError ? [...existingError, ...operationErrorMap[oE]] : operationErrorMap[oE];
     }
-    if (!operationValid && operationError) {
+    if (!operationValid && operationError.code !== ERROR_MESSAGE_CONSTANTS.NONE) {
       results.error = operationError;
     }
     if (!results.valid) {
@@ -7699,7 +7705,7 @@ var TypeInfoORMService = class {
         const relationshipValidationResults = {
           typeName: fromTypeName,
           valid: false,
-          error: "INVALID_RELATIONSHIP" /* INVALID_RELATIONSHIP */,
+          error: getErrorDescriptor("INVALID_RELATIONSHIP" /* INVALID_RELATIONSHIP */),
           errorMap: {}
         };
         throw relationshipValidationResults;
@@ -8109,7 +8115,9 @@ var TypeInfoORMService = class {
       const validationResults = {
         typeName,
         valid: false,
-        error: "NO_PRIMARY_FIELD_VALUE_SUPPLIED" /* NO_PRIMARY_FIELD_VALUE_SUPPLIED */,
+        error: getErrorDescriptor(
+          "NO_PRIMARY_FIELD_VALUE_SUPPLIED" /* NO_PRIMARY_FIELD_VALUE_SUPPLIED */
+        ),
         errorMap: {}
       };
       throw validationResults;
@@ -8458,6 +8466,13 @@ var getHeadersWithCORS = (origin = "", corsPatterns = []) => {
 };
 
 // src/common/Logging/Utils.ts
+var stringifyForLog = (value) => {
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch (error) {
+    return "[Unserializable]";
+  }
+};
 var logFunctionCall = async (label, args, functionRef, enabled) => {
   if (enabled) {
     console.log(
@@ -8465,7 +8480,7 @@ var logFunctionCall = async (label, args, functionRef, enabled) => {
       "INPUT" /* INPUT */,
       label,
       ":",
-      JSON.stringify(args, null, 2)
+      stringifyForLog(args)
     );
   }
   try {
@@ -8476,7 +8491,7 @@ var logFunctionCall = async (label, args, functionRef, enabled) => {
         "OUTPUT" /* OUTPUT */,
         label,
         ":",
-        JSON.stringify(result, null, 2)
+        stringifyForLog(result)
       );
     }
     return result;
@@ -8722,7 +8737,7 @@ var getTypeInfoORMRouteMap = (config, dacConfig, getAccessingRoleId, authConfig)
     authConfig: defaultAuthConfig,
     handlerFactory
   });
-  const createHandlerFactory = (eventData) => orm.create;
+  const createHandlerFactory = (_eventData) => orm.create;
   const createHandlerFactoryWithDAC = (eventData) => {
     resolveContext(eventData);
     return orm.create;
@@ -8824,4 +8839,4 @@ var getContextFromEventData = (eventData, dacConfig, getAccessingRoleId) => {
   return { accessingRoleId };
 };
 
-export { AWS, DACConstraintType, DATA_ITEM_DB_DRIVER_ERRORS, DynamoDBDataItemDBDriver, DynamoDBSupportedDataItemDBDriverEntry, ExactIndex, FullTextDdbBackend, FullTextDdbWriter, FullTextMemoryBackend, InMemoryDataItemDBDriver, InMemoryFileItemDBDriver, InMemoryFileSupportedDataItemDBDriverEntry, InMemoryItemRelationshipDBDriver, InMemorySupportedDataItemDBDriverEntry, IndexingRelationshipDriver, LossyIndex, RelationalDdbBackend, RelationalInMemoryBackend, S3FileItemDBDriver, S3SupportedFileItemDBDriverEntry, SUPPORTED_TYPE_INFO_ORM_DB_DRIVERS, StructuredDdbBackend, StructuredDdbReader, StructuredDdbWriter, StructuredInMemoryBackend, StructuredInMemoryIndex, SupportedTypeInfoORMDBDriverNames, TYPE_INFO_ORM_API_PATH_METHOD_NAME_MAP, TYPE_INFO_ORM_ROUTE_MAP_ERRORS, TypeInfoORMService, WILDCARD_SIGNIFIER_PROTOTYPE, addRouteMapToRouteMap, addRouteToRouteMap, addRoutesToRouteMap, batchWriteWithRetry, buildExactDdbItem, buildExactDdbKey, buildExactS3Key, buildLossyDdbKey, buildLossyS3Key, buildRelationEdgeDdbItem, buildRelationEdgeDdbKey, buildStructuredDocFieldsItem, buildStructuredRangeItem, buildStructuredRangeKey, buildStructuredTermItem, buildStructuredTermKey, cleanRelationshipItem, createAwsSdkV3DynamoClient, createRelationEdgesDdbDependencies, createSearchTrace, decodeExactCursor, decodeLossyCursor, decodeRelationalCursor, decodeStructuredCursor, docTokenPositionsSchema, docTokensSchema, encodeDocKey, encodeDocMirrorKey, encodeDocTokenPositionSortKey, encodeDocTokenSortKey, encodeExactCursor, encodeLossyCursor, encodeRelationEdgePartitionKey, encodeRelationalCursor, encodeStructuredCursor, encodeTokenDocSortKey, encodeTokenKey, exactDdbSchema, exactPostingsSchema, fullTextDocMirrorSchema, fullTextKeyPrefixes, fullTextTokenStatsSchema, getDACPathsMatch, getDACRoleHasAccessToDataItem, getDataItemDACResourcePath, getDataItemFieldValueDACResourcePath, getDriverMethodWithModifiedError, getFlattenedDACConstraints, getFullORMDACRole, getItemRelationshipDACResourcePath, getItemRelationshipOriginDACConstraint, getItemRelationshipOriginDACResourcePath, getItemRelationshipOriginDACRole, getItemTypeDACConstraint, getItemTypeDACResourcePath, getItemTypeDACRole, getORMDACResourcePath, getResourceAccessByDACRole, getTypeInfoORMRouteMap, getValueIsWildcardSignifier, handleCloudFunctionEvent, indexDocument, loadExactPositions, loadLossyIndex, lossyDdbSchema, lossyPostingsSchema, mergeDACAccessResults, mergeDACDataItemResourceAccessResultMaps, qualifyIndexField, handler as relHandler, relationEdgesSchema, removeDocument, replaceFullTextDocument, searchExact, searchLossy, searchStructured, serializeStructuredValue, setIndexBackend, setRelationalHandlerDependencies, setStructuredHandlerDependencies, storeExactPositions, storeLossyIndex, structuredDocFieldsSchema, structuredHandler, structuredRangeIndexSchema, structuredTermIndexSchema, tokenize, tokenizeLossyTrigrams };
+export { AWS, DACConstraintType, DATA_ITEM_DB_DRIVER_ERRORS, DynamoDBDataItemDBDriver, DynamoDBSupportedDataItemDBDriverEntry, ExactIndex, FullTextDdbBackend, FullTextDdbWriter, FullTextMemoryBackend, InMemoryDataItemDBDriver, InMemoryFileItemDBDriver, InMemoryFileSupportedDataItemDBDriverEntry, InMemoryItemRelationshipDBDriver, InMemorySupportedDataItemDBDriverEntry, IndexingRelationshipDriver, LossyIndex, RelationalDdbBackend, RelationalInMemoryBackend, S3FileItemDBDriver, S3SupportedFileItemDBDriverEntry, SEARCH_CAPS, SEARCH_DEFAULTS, SUPPORTED_TYPE_INFO_ORM_DB_DRIVERS, StructuredDdbBackend, StructuredDdbReader, StructuredDdbWriter, StructuredInMemoryBackend, StructuredInMemoryIndex, SupportedTypeInfoORMDBDriverNames, TYPE_INFO_ORM_API_PATH_METHOD_NAME_MAP, TYPE_INFO_ORM_ROUTE_MAP_ERRORS, TypeInfoORMService, WILDCARD_SIGNIFIER_PROTOTYPE, addRouteMapToRouteMap, addRouteToRouteMap, addRoutesToRouteMap, batchWriteWithRetry, buildExactDdbItem, buildExactDdbKey, buildExactS3Key, buildLossyDdbKey, buildLossyS3Key, buildRelationEdgeDdbItem, buildRelationEdgeDdbKey, buildStructuredDocFieldsItem, buildStructuredRangeItem, buildStructuredRangeKey, buildStructuredTermItem, buildStructuredTermKey, cleanRelationshipItem, createAwsSdkV3DynamoClient, createRelationEdgesDdbDependencies, createSearchTrace, decodeExactCursor, decodeLossyCursor, decodeRelationalCursor, decodeStructuredCursor, docTokenPositionsSchema, docTokensSchema, encodeDocKey, encodeDocMirrorKey, encodeDocTokenPositionSortKey, encodeDocTokenSortKey, encodeExactCursor, encodeLossyCursor, encodeRelationEdgePartitionKey, encodeRelationalCursor, encodeStructuredCursor, encodeTokenDocSortKey, encodeTokenKey, exactDdbSchema, exactPostingsSchema, fullTextDocMirrorSchema, fullTextKeyPrefixes, fullTextTokenStatsSchema, getDACPathsMatch, getDACRoleHasAccessToDataItem, getDataItemDACResourcePath, getDataItemFieldValueDACResourcePath, getDriverMethodWithModifiedError, getFlattenedDACConstraints, getFullORMDACRole, getItemRelationshipDACResourcePath, getItemRelationshipOriginDACConstraint, getItemRelationshipOriginDACResourcePath, getItemRelationshipOriginDACRole, getItemTypeDACConstraint, getItemTypeDACResourcePath, getItemTypeDACRole, getORMDACResourcePath, getResourceAccessByDACRole, getTypeInfoORMRouteMap, getValueIsWildcardSignifier, handleCloudFunctionEvent, handler, indexDocument, loadExactPositions, loadLossyIndex, lossyDdbSchema, lossyPostingsSchema, mergeDACAccessResults, mergeDACDataItemResourceAccessResultMaps, qualifyIndexField, relHandler, relationEdgesSchema, removeDocument, replaceFullTextDocument, resolveSearchLimits, searchExact, searchLossy, searchStructured, serializeStructuredValue, setIndexBackend, setRelationalHandlerDependencies, setStructuredHandlerDependencies, storeExactPositions, storeLossyIndex, structuredDocFieldsSchema, structuredHandler, structuredRangeIndexSchema, structuredTermIndexSchema, tokenize, tokenizeLossyTrigrams };