@resistdesign/voltra 3.0.0-alpha.26 → 3.0.0-alpha.28

package/README.md

@@ -218,6 +218,14 @@ How it works:
 - Strategy is auto-selected:
   - DOM + History API => browser history strategy.
   - Otherwise => in-memory native strategy.
+- Native strategy automatically wires Android hardware back to route history.
+  - If Voltra can go back (`history.index > 0`), it consumes the event and navigates back.
+  - If Voltra cannot go back, the event is not consumed so OS/native container behavior continues.
+
+Optional back affordances:
+
+- `adapter.back?.()` navigates backward when supported.
+- `adapter.canGoBack?.()` reports whether back navigation is currently possible.
 
 Escape hatches (root-only):
 

package/api/index.js

@@ -1,3 +1,9 @@
+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 { 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';
 import { marshall, unmarshall } from '@aws-sdk/util-dynamodb';
 import { S3, PutObjectCommand, HeadObjectCommand, CopyObjectCommand, GetObjectCommand, DeleteObjectCommand, ListObjectsV2Command } from '@aws-sdk/client-s3';
@@ -4135,44 +4141,6 @@ function createSearchTrace() {
     ddbItemReadCalls: 0
   };
 }
-
-// src/common/Routing.ts
-var PATH_DELIMITER = "/";
-var getPotentialJSONValue = (value) => {
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    return value;
-  }
-};
-var getPathArray = (path, delimiter = PATH_DELIMITER, filterEmptyOutput = false, filterEmptyInput = true, useJson = true, uriDecodeParts = true) => path.split(delimiter).filter(filterEmptyInput ? (p) => p !== "" : () => true).map(uriDecodeParts ? decodeURIComponent : (x) => x).map(useJson ? getPotentialJSONValue : (p) => p).filter(filterEmptyOutput ? (p) => p ?? false : () => true);
-var getPathString = (parts = [], delimiter = PATH_DELIMITER, filterEmptyInput = false, useJson = true, uriEncodeParts = false) => parts.filter(filterEmptyInput ? (p) => p ?? false : () => true).map(useJson ? (p) => JSON.stringify(p) : (x) => x).map(uriEncodeParts ? encodeURIComponent : (x) => x).join(delimiter);
-var mergeStringPaths = (path1, path2, delimiter = PATH_DELIMITER, filterEmptyOutput = false, filterEmptyInput = true, useJson = true, uriEncodeParts = false) => getPathString(
-  [
-    ...getPathArray(
-      path1,
-      delimiter,
-      filterEmptyOutput,
-      filterEmptyInput,
-      useJson,
-      uriEncodeParts
-    ),
-    ...getPathArray(
-      path2,
-      delimiter,
-      filterEmptyOutput,
-      filterEmptyInput,
-      useJson,
-      uriEncodeParts
-    )
-  ],
-  delimiter,
-  filterEmptyInput,
-  useJson,
-  uriEncodeParts
-);
-
-// src/api/ORM/drivers/S3FileItemDBDriver/S3FileDriver.ts
 var S3_FILE_DRIVER_ERRORS = {
   /**
    * File path contains invalid segments.
@@ -6489,348 +6457,6 @@ var SUPPORTED_TYPE_INFO_ORM_DB_DRIVERS = {
   ["S3_FILE_ITEM" /* S3_FILE_ITEM */]: S3SupportedFileItemDBDriverEntry
 };
 
-// src/common/TypeParsing/Validation.ts
-var INVALID_CUSTOM_TYPE = "INVALID_CUSTOM_TYPE";
-var PRIMITIVE_ERROR_MESSAGE_CONSTANTS = {
-  string: "NOT_A_STRING",
-  number: "NOT_A_NUMBER",
-  boolean: "NOT_A_BOOLEAN"
-};
-var ERROR_MESSAGE_CONSTANTS = {
-  MISSING: "MISSING",
-  INVALID_OPTION: "INVALID_OPTION",
-  INVALID_FIELD: "INVALID_FIELD",
-  RELATIONSHIP_VALUES_ARE_STRICTLY_EXCLUDED: "RELATIONSHIP_VALUES_ARE_STRICTLY_EXCLUDED",
-  INVALID_TYPE: "INVALID_TYPE",
-  NO_UNION_TYPE_MATCHED: "NO_UNION_TYPE_MATCHED",
-  TYPE_DOES_NOT_EXIST: "TYPE_DOES_NOT_EXIST",
-  INVALID_PATTERN: "INVALID_PATTERN",
-  VALUE_DOES_NOT_MATCH_PATTERN: "VALUE_DOES_NOT_MATCH_PATTERN"
-};
-var DENIED_TYPE_OPERATIONS = {
-  CREATE: "DENIED_TYPE_OPERATION_CREATE",
-  READ: "DENIED_TYPE_OPERATION_READ",
-  UPDATE: "DENIED_TYPE_OPERATION_UPDATE",
-  DELETE: "DENIED_TYPE_OPERATION_DELETE"
-};
-var validateValueMatchesPattern = (typeName, value, pattern) => {
-  const results = {
-    typeName,
-    valid: true,
-    error: "",
-    errorMap: {}
-  };
-  {
-    try {
-      const regex = new RegExp(pattern);
-      const testResult = typeof value === "string" && regex.test(value);
-      if (!testResult) {
-        results.valid = false;
-        results.error = ERROR_MESSAGE_CONSTANTS.VALUE_DOES_NOT_MATCH_PATTERN;
-      }
-    } catch (e) {
-      results.valid = false;
-      results.error = ERROR_MESSAGE_CONSTANTS.INVALID_PATTERN;
-    }
-  }
-  return results;
-};
-var getValidityValue = (existing, pending) => !existing ? false : pending;
-var TYPE_KEYWORD_VALIDATORS = {
-  string: (value) => typeof value === "string",
-  number: (value) => typeof value === "number",
-  boolean: (value) => typeof value === "boolean"
-};
-var hasValue = (value) => value ?? false;
-var validateKeywordType = (value, type) => {
-  const validator = TYPE_KEYWORD_VALIDATORS[type];
-  let valid = true;
-  if (validator) {
-    valid = validator(value);
-  }
-  return valid;
-};
-var validateCustomType = (value, customType, customValidators) => {
-  let valid = true;
-  if (customValidators && customType) {
-    const validator = customValidators[customType];
-    if (validator) {
-      try {
-        valid = validator(value);
-      } catch (e) {
-        valid = false;
-      }
-    }
-  }
-  return valid;
-};
-var validateTypeInfoFieldValue = (value, typeInfoField, typeInfoMap, ignoreArray = false, strict = false, customValidators, typeOperation, relationshipValidationType = "STRICT_EXCLUDE" /* STRICT_EXCLUDE */, itemIsPartial) => {
-  const {
-    type,
-    typeReference,
-    array,
-    optional,
-    possibleValues,
-    tags: { customType, constraints: { pattern = void 0 } = {} } = {}
-  } = typeInfoField;
-  const results = {
-    typeName: typeReference ?? type,
-    valid: true,
-    error: "",
-    errorMap: {}
-  };
-  const requiredValueAllowed = !typeReference || relationshipValidationType === "INCLUDE" /* INCLUDE */;
-  const valueIsUndefined = typeof value === "undefined";
-  const valueIsNull = value === null;
-  const canSkipValidation = itemIsPartial && (valueIsUndefined || valueIsNull) || optional && valueIsUndefined;
-  if (canSkipValidation) {
-    results.valid = true;
-  } else if (requiredValueAllowed && !itemIsPartial && !optional && !hasValue(value)) {
-    results.valid = false;
-    results.error = ERROR_MESSAGE_CONSTANTS.MISSING;
-  } else if (array && !ignoreArray) {
-    const {
-      valid: validArray,
-      error: arrayError,
-      errorMap: arrayErrorMap
-    } = validateArrayOfTypeInfoFieldValues(
-      value,
-      typeInfoField,
-      typeInfoMap,
-      strict,
-      customValidators,
-      typeOperation,
-      relationshipValidationType,
-      itemIsPartial
-    );
-    results.valid = getValidityValue(results.valid, validArray);
-    results.error = arrayError;
-    results.errorMap = arrayErrorMap;
-  } else {
-    if (typeReference) {
-      if (relationshipValidationType === "INCLUDE" /* INCLUDE */) {
-        const {
-          valid: validTypeInfo,
-          error: typeInfoError,
-          errorMap: typeInfoErrorMap
-        } = validateTypeInfoValue(
-          value,
-          typeReference,
-          typeInfoMap,
-          strict,
-          customValidators,
-          typeOperation,
-          relationshipValidationType,
-          itemIsPartial
-        );
-        results.valid = getValidityValue(results.valid, validTypeInfo);
-        results.error = typeInfoError;
-        results.errorMap = typeInfoErrorMap;
-      } else if (relationshipValidationType === "STRICT_EXCLUDE" /* STRICT_EXCLUDE */) {
-        const valueSupplied = typeof value !== "undefined";
-        if (valueSupplied) {
-          results.valid = false;
-          results.error = ERROR_MESSAGE_CONSTANTS.RELATIONSHIP_VALUES_ARE_STRICTLY_EXCLUDED;
-        }
-      } else if (relationshipValidationType === "EXCLUDE" /* EXCLUDE */) {
-        results.valid = getValidityValue(results.valid, true);
-      }
-    } else if (possibleValues && !possibleValues.includes(value)) {
-      results.valid = false;
-      results.error = ERROR_MESSAGE_CONSTANTS.INVALID_OPTION;
-    } else {
-      const pendingValid = validateKeywordType(value, type);
-      const customValid = validateCustomType(
-        value,
-        customType,
-        customValidators
-      );
-      results.valid = getValidityValue(results.valid, pendingValid);
-      results.valid = getValidityValue(results.valid, customValid);
-      if (type === "string" && typeof pattern === "string") {
-        const { valid: patternValid, error: patternError } = validateValueMatchesPattern(value, pattern);
-        results.valid = getValidityValue(results.valid, patternValid);
-        results.error = patternError;
-      }
-      if (!customValid) {
-        results.error = INVALID_CUSTOM_TYPE;
-      } else if (!results.valid) {
-        results.error = results.error ? results.error : PRIMITIVE_ERROR_MESSAGE_CONSTANTS[type];
-      }
-    }
-  }
-  return results;
-};
-var validateArrayOfTypeInfoFieldValues = (values = [], typeInfoField, typeInfoMap, strict = false, customValidators, typeOperation, relationshipValidationType, itemIsPartial) => {
-  const { type, typeReference } = typeInfoField;
-  const results = {
-    typeName: typeReference ?? type,
-    valid: true,
-    error: "",
-    errorMap: {}
-  };
-  for (let i = 0; i < values.length; i++) {
-    const v = values[i];
-    const {
-      valid: indexValid,
-      error: indexError = "",
-      errorMap: indexErrorMap
-    } = validateTypeInfoFieldValue(
-      v,
-      typeInfoField,
-      typeInfoMap,
-      true,
-      strict,
-      customValidators,
-      typeOperation,
-      relationshipValidationType,
-      itemIsPartial
-    );
-    results.valid = getValidityValue(results.valid, indexValid);
-    results.errorMap[getPathString([i])] = [indexError];
-    for (const er in indexErrorMap) {
-      results.errorMap[getPathString([i, er])] = indexErrorMap[er];
-    }
-  }
-  return results;
-};
-var validateTypeInfoFieldOperationAllowed = (fieldName, fieldOperation, typeInfoField) => {
-  const results = {
-    typeName: null,
-    valid: true,
-    error: "",
-    errorMap: {}
-  };
-  if (fieldOperation && typeInfoField) {
-    const {
-      type,
-      typeReference,
-      tags = {}
-    } = typeInfoField || {};
-    const { deniedOperations: { [fieldOperation]: denied = false } = {} } = tags;
-    results.typeName = typeReference ?? type;
-    results.valid = !denied;
-    if (!results.valid) {
-      results.error = DENIED_TYPE_OPERATIONS[fieldOperation];
-      results.errorMap[fieldName] = [results.error];
-    }
-  }
-  return results;
-};
-var validateTypeOperationAllowed = (typeName, valueFields, typeOperation, typeInfo) => {
-  const results = {
-    typeName,
-    valid: true,
-    error: "",
-    errorMap: {}
-  };
-  const { fields = {}, tags = {} } = typeInfo;
-  const { deniedOperations: { [typeOperation]: denied = false } = {} } = tags;
-  if (denied) {
-    results.valid = false;
-    results.error = DENIED_TYPE_OPERATIONS[typeOperation];
-  } else {
-    for (const vF of valueFields) {
-      const vFieldInfo = fields[vF];
-      const { valid: vFValid, error: vFError } = validateTypeInfoFieldOperationAllowed(vF, typeOperation, vFieldInfo);
-      results.valid = getValidityValue(results.valid, vFValid);
-      if (!vFValid) {
-        results.errorMap[vF] = [vFError];
-      }
-    }
-  }
-  return results;
-};
-var validateTypeInfoValue = (value, typeInfoFullName, typeInfoMap, strict = false, customValidators, typeOperation, relationshipValidationType, itemIsPartial) => {
-  const typeInfo = typeInfoMap[typeInfoFullName];
-  const results = {
-    typeName: typeInfoFullName,
-    valid: !!typeInfo,
-    error: !!typeInfo ? "" : ERROR_MESSAGE_CONSTANTS.TYPE_DOES_NOT_EXIST,
-    errorMap: {}
-  };
-  if (typeInfo) {
-    const { primaryField, fields, unionFieldSets } = typeInfo;
-    if (typeOperation) {
-      const valueFields = typeof value === "object" ? Object.keys(value ?? {}) : [];
-      const {
-        valid: operationValid,
-        error: operationError,
-        errorMap: operationErrorMap
-      } = validateTypeOperationAllowed(
-        typeInfoFullName,
-        valueFields,
-        typeOperation,
-        typeInfo
-      );
-      results.valid = getValidityValue(results.valid, operationValid);
-      results.error = operationError;
-      for (const oE in operationErrorMap) {
-        const existingError = results.errorMap[oE] ?? [];
-        results.errorMap[oE] = existingError ? [...existingError, ...operationErrorMap[oE]] : operationErrorMap[oE];
-      }
-      if (!operationValid && operationError) {
-        results.error = operationError;
-      }
-    }
-    if (unionFieldSets) {
-      const valueFields = Object.keys(value || {});
-      let valid = false;
-      for (const uFS of unionFieldSets) {
-        valid = valueFields.every((vF) => uFS.includes(vF));
-        if (valid) {
-          break;
-        }
-      }
-      if (!valid) {
-        results.valid = false;
-        results.error = ERROR_MESSAGE_CONSTANTS.NO_UNION_TYPE_MATCHED;
-      }
-    } else if (strict) {
-      const knownFields = Object.keys(fields || {});
-      const valueFields = Object.keys(value || {});
-      for (const vF of valueFields) {
-        if (!knownFields.includes(vF)) {
-          results.valid = false;
-          results.errorMap[vF] = [ERROR_MESSAGE_CONSTANTS.INVALID_FIELD];
-        }
-      }
-    }
-    if (fields) {
-      for (const key in fields) {
-        if (typeOperation !== "CREATE" /* CREATE */ || typeof primaryField !== "string" || key !== primaryField) {
-          const typeInfoField = fields[key];
-          const fieldValue = value[key];
-          const {
-            valid: fieldValid,
-            error: fieldError,
-            errorMap: fieldErrorMap
-          } = validateTypeInfoFieldValue(
-            fieldValue,
-            typeInfoField,
-            typeInfoMap,
-            false,
-            strict,
-            customValidators,
-            typeOperation,
-            relationshipValidationType,
-            itemIsPartial
-          );
-          results.valid = getValidityValue(results.valid, fieldValid);
-          results.errorMap[key] = [fieldError];
-          for (const fE in fieldErrorMap) {
-            results.errorMap[getPathString([key, fE])] = fieldErrorMap[fE];
-          }
-        }
-      }
-    }
-    if (!results.valid && !results.error) {
-      results.error = ERROR_MESSAGE_CONSTANTS.INVALID_TYPE;
-    }
-  }
-  return results;
-};
-
 // src/common/SearchValidation.ts
 var SEARCH_VALIDATION_ERRORS = {
   INVALID_TYPE_INFO: "INVALID_TYPE_INFO",
@@ -6962,9 +6588,6 @@ var validateRelationshipItem = (relationshipItem, omitFields) => {
   return results;
 };
 
-// src/common/TypeInfoORM/Types.ts
-var ITEM_RELATIONSHIP_DAC_RESOURCE_NAME = "TYPE_INFO_ORM_ITEM_RELATIONSHIP";
-
 // src/common/TypeParsing/Utils.ts
 var removeNonexistentFieldsFromSelectedFields = (typeInfo = {}, selectedFields) => {
   if (Array.isArray(selectedFields)) {