@ankhorage/contracts 14.0.0 → 15.0.0

package/src/appManifest/apis.ts

@@ -1,6 +1,9 @@
+import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
+import { isNonEmptyString, isOptionalString } from '@ankhorage/utility/string';
+
 import type { ApiDefinition, ApiDefinitionList } from '../data';
 import { isCredentialRef, isDataEndpointRegistry, isDataSchemaRegistry } from './data';
-import { isManifestValue, isOptionalString, isRecord } from './shared';
+import { isManifestValue } from './isManifestValue';
 
 const API_BASE_KEYS = [
   'id',
@@ -13,18 +16,20 @@ const API_BASE_KEYS = [
   'schemas',
   'metadata',
 ] as const;
-const EXTERNAL_REST_KEYS = new Set([...API_BASE_KEYS, 'baseUrl', 'openApi']);
-const EXTERNAL_GRAPHQL_KEYS = new Set([...API_BASE_KEYS, 'endpointUrl', 'introspection']);
-const INTERNAL_REST_KEYS = new Set([...API_BASE_KEYS, 'basePath']);
-const OPEN_API_KEYS = new Set(['url', 'documentId', 'version']);
-const INTROSPECTION_KEYS = new Set(['enabled', 'schemaVersion']);
+const EXTERNAL_REST_KEYS = [...API_BASE_KEYS, 'baseUrl', 'openApi'] as const;
+const EXTERNAL_GRAPHQL_KEYS = [...API_BASE_KEYS, 'endpointUrl', 'introspection'] as const;
+const INTERNAL_REST_KEYS = [...API_BASE_KEYS, 'basePath'] as const;
+const OPEN_API_KEYS = ['url', 'documentId', 'version'] as const;
+const INTROSPECTION_KEYS = ['enabled', 'schemaVersion'] as const;
 
+/*** Validate API definitions and require unique API identities. */
 export function isApiDefinitionList(value: unknown): value is ApiDefinitionList {
   if (!Array.isArray(value) || !value.every(isApiDefinition)) return false;
   const ids = value.map((api) => api.id);
   return new Set(ids).size === ids.length;
 }
 
+/*** Validate one API definition against its origin and protocol branch. */
 function isApiDefinition(value: unknown): value is ApiDefinition {
   if (!isApiBaseDefinition(value)) return false;
   if (value.origin === 'external' && value.protocol === 'rest') return isExternalRestApi(value);
@@ -35,14 +40,14 @@ function isApiDefinition(value: unknown): value is ApiDefinition {
   return false;
 }
 
+/*** Validate common API identity, endpoint, schema and authored metadata fields. */
 function isApiBaseDefinition(value: unknown): value is Record<string, unknown> {
   return (
     isRecord(value) &&
     isNonEmptyString(value.id) &&
     (value.origin === 'external' || value.origin === 'internal') &&
     (value.protocol === 'graphql' || value.protocol === 'rest') &&
-    isOptionalString(value.name) &&
-    isOptionalString(value.description) &&
+    [value.name, value.description].every(isOptionalString) &&
     (value.credential === undefined || isCredentialRef(value.credential)) &&
     isDataEndpointRegistry(value.endpoints) &&
     (value.schemas === undefined || isDataSchemaRegistry(value.schemas)) &&
@@ -50,6 +55,7 @@ function isApiBaseDefinition(value: unknown): value is Record<string, unknown> {
   );
 }
 
+/*** Validate external REST endpoint and optional OpenAPI metadata. */
 function isExternalRestApi(value: Record<string, unknown>): boolean {
   return (
     hasOnlyKeys(value, EXTERNAL_REST_KEYS) &&
@@ -58,6 +64,7 @@ function isExternalRestApi(value: Record<string, unknown>): boolean {
   );
 }
 
+/*** Validate external GraphQL endpoint and optional introspection metadata. */
 function isExternalGraphQlApi(value: Record<string, unknown>): boolean {
   return (
     hasOnlyKeys(value, EXTERNAL_GRAPHQL_KEYS) &&
@@ -66,10 +73,12 @@ function isExternalGraphQlApi(value: Record<string, unknown>): boolean {
   );
 }
 
+/*** Validate the supported internal REST API configuration. */
 function isInternalRestApi(value: Record<string, unknown>): boolean {
   return hasOnlyKeys(value, INTERNAL_REST_KEYS) && isNonEmptyString(value.basePath);
 }
 
+/*** Validate optional OpenAPI document location and version fields. */
 function isOpenApiDocumentRef(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -80,6 +89,7 @@ function isOpenApiDocumentRef(value: unknown): boolean {
   );
 }
 
+/*** Validate explicit GraphQL introspection settings. */
 function isGraphQlIntrospection(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -88,11 +98,3 @@ function isGraphQlIntrospection(value: unknown): boolean {
     isOptionalString(value.schemaVersion)
   );
 }
-
-function isNonEmptyString(value: unknown): value is string {
-  return typeof value === 'string' && value.trim().length > 0;
-}
-
-function hasOnlyKeys(value: Record<string, unknown>, allowed: ReadonlySet<string>): boolean {
-  return Object.keys(value).every((key) => allowed.has(key));
-}

package/src/appManifest/bindings.ts

@@ -1,9 +1,14 @@
-import { isManifestValue, isOptionalString, isRecord } from './shared';
+import { isRecord } from '@ankhorage/utility/object';
+import { isOptionalString } from '@ankhorage/utility/string';
 
+import { isManifestValue } from './isManifestValue';
+
+/*** Validate every component binding in the authored registry. */
 export function isComponentDataBindingRegistry(value: unknown): boolean {
   return isRecord(value) && Object.values(value).every(isComponentDataBinding);
 }
 
+/*** Validate literal, operation and path-based binding sources. */
 export function isBindingValueSource(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -17,6 +22,7 @@ export function isBindingValueSource(value: unknown): boolean {
   );
 }
 
+/*** Validate a screen operation loader and its optional input mapping. */
 export function isScreenDataLoaderDefinition(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -27,6 +33,7 @@ export function isScreenDataLoaderDefinition(value: unknown): boolean {
   );
 }
 
+/*** Validate component identity and its property and event bindings. */
 function isComponentDataBinding(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -42,6 +49,7 @@ function isComponentDataBinding(value: unknown): boolean {
   );
 }
 
+/*** Validate a property binding with optional transforms and fallback behavior. */
 function isPropBinding(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -54,6 +62,7 @@ function isPropBinding(value: unknown): boolean {
   );
 }
 
+/*** Validate an event binding and its declared target. */
 function isEventBinding(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -63,6 +72,7 @@ function isEventBinding(value: unknown): boolean {
   );
 }
 
+/*** Validate the selected operation or action event target. */
 function isEventBindingTarget(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -71,6 +81,7 @@ function isEventBindingTarget(value: unknown): boolean {
   );
 }
 
+/*** Validate a binding condition and its source value. */
 function isBindingCondition(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -80,6 +91,7 @@ function isBindingCondition(value: unknown): boolean {
   );
 }
 
+/*** Validate API and operation identities with an optional endpoint reference. */
 function isBindingOperationRef(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -89,6 +101,7 @@ function isBindingOperationRef(value: unknown): boolean {
   );
 }
 
+/*** Validate authored binding fallback values. */
 function isBindingFallback(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -97,6 +110,7 @@ function isBindingFallback(value: unknown): boolean {
   );
 }
 
+/*** Validate loading, empty and error binding behavior. */
 function isBindingLifecycleBehavior(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -107,6 +121,7 @@ function isBindingLifecycleBehavior(value: unknown): boolean {
   );
 }
 
+/*** Validate optional ordered binding transformations. */
 function isOptionalBindingTransforms(value: unknown): boolean {
   return (
     value === undefined ||
@@ -115,10 +130,12 @@ function isOptionalBindingTransforms(value: unknown): boolean {
   );
 }
 
+/*** Validate every value in an operation input mapping. */
 function isBindingInputMap(value: unknown): boolean {
   return isRecord(value) && Object.values(value).every(isBindingInputValue);
 }
 
+/*** Validate recursive array, object, literal and source operation inputs. */
 function isBindingInputValue(value: unknown): boolean {
   return (
     isRecord(value) &&

package/src/appManifest/constants.ts

@@ -0,0 +1,19 @@
+import type { AppManifest } from '../types';
+
+export const APP_MANIFEST_KEY_POLICY = {
+  metadata: 'required',
+  themes: 'required',
+  activeThemeId: 'required',
+  activeThemeMode: 'optional',
+  splashScreen: 'optional',
+  media: 'optional',
+  deploy: 'optional',
+  state: 'optional',
+  infra: 'required',
+  navigator: 'required',
+  screens: 'required',
+  dataSources: 'optional',
+  dataBindings: 'optional',
+  repository: 'optional',
+  settings: 'required',
+} as const satisfies Record<keyof AppManifest, 'optional' | 'required'>;

package/src/appManifest/data.ts

@@ -1,10 +1,8 @@
-import {
-  isManifestValue,
-  isOptionalBoolean,
-  isOptionalString,
-  isRecord,
-  isStringArray,
-} from './shared';
+import { isStringArray } from '@ankhorage/utility/array';
+import { isRecord } from '@ankhorage/utility/object';
+import { isOptionalString } from '@ankhorage/utility/string';
+
+import { isManifestValue } from './isManifestValue';
 
 const DATA_SCHEMA_TYPES = new Set([
   'array',
@@ -18,14 +16,17 @@ const DATA_SCHEMA_TYPES = new Set([
 const OPERATION_INTENTS = new Set(['action', 'create', 'delete', 'read', 'update']);
 const PARAMETER_LOCATIONS = new Set(['body', 'cookie', 'header', 'path', 'query']);
 
+/*** Validate every endpoint in the data endpoint registry. */
 export function isDataEndpointRegistry(value: unknown): boolean {
   return isRecord(value) && Object.values(value).every(isDataEndpointConfig);
 }
 
+/*** Validate every schema in the data schema registry. */
 export function isDataSchemaRegistry(value: unknown): boolean {
   return isRecord(value) && Object.values(value).every(isDataSchema);
 }
 
+/*** Validate credential identity and optional descriptive metadata. */
 export function isCredentialRef(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -36,6 +37,7 @@ export function isCredentialRef(value: unknown): boolean {
   );
 }
 
+/*** Validate an adapter reference and its optional authored configuration. */
 export function isAdapterRef(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -47,6 +49,7 @@ export function isAdapterRef(value: unknown): boolean {
   );
 }
 
+/*** Validate endpoint identity, operations and optional connection metadata. */
 function isDataEndpointConfig(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -63,6 +66,7 @@ function isDataEndpointConfig(value: unknown): boolean {
   );
 }
 
+/*** Validate operation protocol, intent, request and response configuration. */
 function isDataOperationConfig(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -83,6 +87,7 @@ function isDataOperationConfig(value: unknown): boolean {
   );
 }
 
+/*** Validate request schema, parameters and optional content type. */
 function isDataOperationRequest(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -93,6 +98,7 @@ function isDataOperationRequest(value: unknown): boolean {
   );
 }
 
+/*** Validate parameter identity, location, schema and optional default value. */
 function isDataOperationParameter(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -100,12 +106,13 @@ function isDataOperationParameter(value: unknown): boolean {
     typeof value.name === 'string' &&
     typeof value.location === 'string' &&
     PARAMETER_LOCATIONS.has(value.location) &&
-    isOptionalBoolean(value.required) &&
+    (value.required === undefined || typeof value.required === 'boolean') &&
     isOptionalString(value.description) &&
     (value.default === undefined || isManifestValue(value.default))
   );
 }
 
+/*** Validate response status, schema and optional descriptive metadata. */
 function isDataOperationResponse(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -118,6 +125,7 @@ function isDataOperationResponse(value: unknown): boolean {
   );
 }
 
+/*** Validate inline schema and schema-reference fields. */
 function isDataSchemaSlot(value: Record<string, unknown>): boolean {
   return (
     (value.schema === undefined || isDataSchema(value.schema)) &&
@@ -125,6 +133,7 @@ function isDataSchemaSlot(value: Record<string, unknown>): boolean {
   );
 }
 
+/*** Validate supported schema types, constraints and compositions. */
 function isDataSchema(value: unknown): boolean {
   if (!isRecord(value) || !isDataSchemaType(value.type)) return false;
   if (!isOptionalSchemaScalars(value)) return false;
@@ -132,6 +141,7 @@ function isDataSchema(value: unknown): boolean {
   return isOptionalSchemaComposition(value);
 }
 
+/*** Validate a supported schema type or an array of supported types. */
 function isDataSchemaType(value: unknown): boolean {
   if (value === undefined) return true;
   if (typeof value === 'string') return DATA_SCHEMA_TYPES.has(value);
@@ -141,12 +151,13 @@ function isDataSchemaType(value: unknown): boolean {
   );
 }
 
+/*** Validate optional scalar schema constraints. */
 function isOptionalSchemaScalars(value: Record<string, unknown>): boolean {
   return (
     isOptionalString(value.title) &&
     isOptionalString(value.description) &&
     isOptionalString(value.format) &&
-    isOptionalBoolean(value.nullable) &&
+    (value.nullable === undefined || typeof value.nullable === 'boolean') &&
     (value.const === undefined || isManifestValue(value.const)) &&
     (value.default === undefined || isManifestValue(value.default)) &&
     (value.enum === undefined ||
@@ -155,6 +166,7 @@ function isOptionalSchemaScalars(value: Record<string, unknown>): boolean {
   );
 }
 
+/*** Validate optional schema properties, items and required fields. */
 function isOptionalSchemaCollections(value: Record<string, unknown>): boolean {
   return (
     (value.required === undefined || isStringArray(value.required)) &&
@@ -167,6 +179,7 @@ function isOptionalSchemaCollections(value: Record<string, unknown>): boolean {
   );
 }
 
+/*** Validate optional schema alternatives and intersections. */
 function isOptionalSchemaComposition(value: Record<string, unknown>): boolean {
   return ['allOf', 'anyOf', 'oneOf'].every((key) => {
     const entry = value[key];
@@ -174,6 +187,7 @@ function isOptionalSchemaComposition(value: Record<string, unknown>): boolean {
   });
 }
 
+/*** Validate a named schema reference. */
 function isDataSchemaRef(value: unknown): boolean {
   return isRecord(value) && typeof value.id === 'string';
 }

package/src/appManifest/dataSources.ts

@@ -1,12 +1,15 @@
+import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
+import { isOptionalString } from '@ankhorage/utility/string';
+
 import {
   isAdapterRef,
   isCredentialRef,
   isDataEndpointRegistry,
   isDataSchemaRegistry,
 } from './data';
-import { isManifestValue, isOptionalString, isRecord } from './shared';
+import { isManifestValue } from './isManifestValue';
 
-const DATABASE_SOURCE_KEYS = new Set([
+const DATABASE_SOURCE_KEYS = [
   'id',
   'kind',
   'name',
@@ -16,8 +19,9 @@ const DATABASE_SOURCE_KEYS = new Set([
   'endpoints',
   'schemas',
   'metadata',
-]);
+] as const;
 
+/*** Validate the supported data-source entries in the registry. */
 export function isDataSourceRegistry(value: unknown): boolean {
   return (
     isRecord(value) &&
@@ -25,6 +29,7 @@ export function isDataSourceRegistry(value: unknown): boolean {
   );
 }
 
+/*** Validate database adapter identity and supported configuration fields. */
 function isDatabaseDataSource(value: unknown): value is Record<string, unknown> {
   return (
     isRecord(value) &&
@@ -42,7 +47,3 @@ function isDatabaseDataSource(value: unknown): value is Record<string, unknown>
     (value.metadata === undefined || isManifestValue(value.metadata))
   );
 }
-
-function hasOnlyKeys(value: Record<string, unknown>, allowed: ReadonlySet<string>): boolean {
-  return Object.keys(value).every((key) => allowed.has(key));
-}

package/src/appManifest/deploy.ts

@@ -1,3 +1,6 @@
+import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
+import { isNonEmptyString } from '@ankhorage/utility/string';
+
 import type {
   AppDeployAndroidTargetConfig,
   AppDeployIosTargetConfig,
@@ -6,20 +9,21 @@ import type {
   AppDeployTargets,
   AppDeployWebTargetConfig,
 } from '../deploy';
-import { isRecord } from './shared';
 
-const DEPLOY_KEYS = new Set(['targets']);
-const TARGET_KEYS = new Set(['web', 'android', 'ios']);
-const PROVIDER_KEYS = new Set(['build', 'publish']);
-const WEB_KEYS = new Set(['enabled', 'providers']);
-const ANDROID_KEYS = new Set(['enabled', 'package', 'scheme', 'providers']);
-const IOS_KEYS = new Set(['enabled', 'bundleIdentifier', 'scheme', 'providers']);
+const DEPLOY_KEYS = ['targets'] as const;
+const TARGET_KEYS = ['web', 'android', 'ios'] as const;
+const PROVIDER_KEYS = ['build', 'publish'] as const;
+const WEB_KEYS = ['enabled', 'providers'] as const;
+const ANDROID_KEYS = ['enabled', 'package', 'scheme', 'providers'] as const;
+const IOS_KEYS = ['enabled', 'bundleIdentifier', 'scheme', 'providers'] as const;
 const URI_SCHEME_PATTERN = /^[A-Za-z][A-Za-z0-9+.-]*$/u;
 
+/*** Validate authored application deployment configuration. */
 export function isAppDeployManifest(value: unknown): value is AppDeployManifest {
   return isRecord(value) && hasOnlyKeys(value, DEPLOY_KEYS) && isAppDeployTargets(value.targets);
 }
 
+/*** Validate the optional web, Android and iOS deployment targets. */
 function isAppDeployTargets(value: unknown): value is AppDeployTargets {
   return (
     isRecord(value) &&
@@ -30,6 +34,7 @@ function isAppDeployTargets(value: unknown): value is AppDeployTargets {
   );
 }
 
+/*** Validate web deployment identity and provider selection. */
 function isWebTarget(value: unknown): value is AppDeployWebTargetConfig {
   return (
     isRecord(value) &&
@@ -39,6 +44,7 @@ function isWebTarget(value: unknown): value is AppDeployWebTargetConfig {
   );
 }
 
+/*** Validate Android deployment identity, scheme and provider selection. */
 function isAndroidTarget(value: unknown): value is AppDeployAndroidTargetConfig {
   return (
     isRecord(value) &&
@@ -50,6 +56,7 @@ function isAndroidTarget(value: unknown): value is AppDeployAndroidTargetConfig
   );
 }
 
+/*** Validate iOS deployment identity, scheme and provider selection. */
 function isIosTarget(value: unknown): value is AppDeployIosTargetConfig {
   return (
     isRecord(value) &&
@@ -61,14 +68,17 @@ function isIosTarget(value: unknown): value is AppDeployIosTargetConfig {
   );
 }
 
+/*** Accept an omitted scheme or a non-empty authored scheme. */
 function isOptionalScheme(value: unknown): value is string | undefined {
   return value === undefined || (typeof value === 'string' && URI_SCHEME_PATTERN.test(value));
 }
 
+/*** Accept omitted deployment providers or a valid provider selection. */
 function isOptionalProviders(value: unknown): value is AppDeployProviderSelection | undefined {
   return value === undefined || isProviderSelection(value);
 }
 
+/*** Validate deployment provider identities and supported selection keys. */
 function isProviderSelection(value: unknown): value is AppDeployProviderSelection {
   return (
     isRecord(value) &&
@@ -77,11 +87,3 @@ function isProviderSelection(value: unknown): value is AppDeployProviderSelectio
     (value.publish === undefined || isNonEmptyString(value.publish))
   );
 }
-
-function isNonEmptyString(value: unknown): value is string {
-  return typeof value === 'string' && value.trim().length > 0;
-}
-
-function hasOnlyKeys(value: Record<string, unknown>, allowed: ReadonlySet<string>): boolean {
-  return Object.keys(value).every((key) => allowed.has(key));
-}

package/src/appManifest/icon.ts

@@ -1,5 +1,7 @@
+import { isRecord } from '@ankhorage/utility/object';
+import { isOptionalString } from '@ankhorage/utility/string';
+
 import { isMediaAssetReference } from '../media';
-import { isOptionalString, isRecord } from './shared';
 
 /*** Validate a serializable icon as either a named font glyph or an SVG media reference. */
 export function isIconSpec(value: unknown): boolean {

package/src/appManifest/isAppManifest.ts

@@ -0,0 +1,95 @@
+import { isStringArray } from '@ankhorage/utility/array';
+import { isRecord } from '@ankhorage/utility/object';
+
+import { isInfraManifest } from '../infra/isInfraManifest';
+import type { AppManifest } from '../types';
+import { isComponentDataBindingRegistry } from './bindings';
+import { APP_MANIFEST_KEY_POLICY } from './constants';
+import { isDataSourceRegistry } from './dataSources';
+import { isAppDeployManifest } from './deploy';
+import { isAppStateSpec } from './isAppStateSpec';
+import { isMediaManifest } from './media';
+import {
+  isAppNavigatorManifest,
+  isManifestMetadata,
+  isScreenRegistry,
+  isSplashScreenSpec,
+  isThemeConfig,
+} from './screens';
+
+/*** Return whether an unknown value satisfies the canonical AppManifest shape. */
+export function isAppManifest(value: unknown): value is AppManifest {
+  return (
+    isRecord(value) &&
+    hasRequiredManifestKeys(value) &&
+    !('generatedApis' in value) &&
+    isManifestMetadata(value.metadata) &&
+    isPresentation(value) &&
+    isOptionalCapabilities(value) &&
+    isInfraManifest(value.infra) &&
+    isAppNavigatorManifest(value.navigator) &&
+    isScreenRegistry(value.screens) &&
+    isAppSettings(value.settings)
+  );
+}
+
+/*** Validate the canonical application manifest field policy. */
+function hasRequiredManifestKeys(value: Record<string, unknown>): boolean {
+  return Object.entries(APP_MANIFEST_KEY_POLICY).every(
+    ([key, policy]) => policy === 'optional' || key in value,
+  );
+}
+
+/*** Validate the canonical application manifest field policy. */
+function isActiveThemeMode(value: unknown): boolean {
+  return value === undefined || value === 'dark' || value === 'light';
+}
+
+/*** Validate the canonical application manifest field policy. */
+function isRepositoryManifest(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    value.provider === 'github' &&
+    typeof value.owner === 'string' &&
+    value.owner.length > 0 &&
+    typeof value.name === 'string' &&
+    value.name.length > 0 &&
+    typeof value.url === 'string' &&
+    value.url.length > 0 &&
+    value.defaultBranch === 'main'
+  );
+}
+
+/*** Validate the canonical application manifest field policy. */
+function isAppSettings(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    !('apiBaseUrl' in value) &&
+    isRecord(value.localization) &&
+    typeof value.localization.defaultLocale === 'string' &&
+    isStringArray(value.localization.locales)
+  );
+}
+
+/*** Validate authored appearance as one cohesive manifest concern. */
+function isPresentation(value: Record<string, unknown>): boolean {
+  return (
+    Array.isArray(value.themes) &&
+    value.themes.every(isThemeConfig) &&
+    typeof value.activeThemeId === 'string' &&
+    isActiveThemeMode(value.activeThemeMode) &&
+    (value.splashScreen === undefined || isSplashScreenSpec(value.splashScreen)) &&
+    (value.media === undefined || isMediaManifest(value.media))
+  );
+}
+
+/*** Validate independently optional application capability selections. */
+function isOptionalCapabilities(value: Record<string, unknown>): boolean {
+  return (
+    (value.deploy === undefined || isAppDeployManifest(value.deploy)) &&
+    (value.state === undefined || isAppStateSpec(value.state)) &&
+    (value.dataSources === undefined || isDataSourceRegistry(value.dataSources)) &&
+    (value.dataBindings === undefined || isComponentDataBindingRegistry(value.dataBindings)) &&
+    (value.repository === undefined || isRepositoryManifest(value.repository))
+  );
+}

package/src/appManifest/isAppStateSpec.ts

@@ -0,0 +1,13 @@
+import { isRecord } from '@ankhorage/utility/object';
+
+import type { AppStateSpec } from '../state';
+
+/*** Application state cannot claim persistence unsupported by the selected Legend adapter. */
+export function isAppStateSpec(value: unknown): value is AppStateSpec {
+  return (
+    isRecord(value) &&
+    value.provider === 'legend' &&
+    (value.persistence === undefined || value.persistence === false) &&
+    Object.keys(value).every((key) => key === 'provider' || key === 'persistence')
+  );
+}

package/src/appManifest/isManifestValue.ts

@@ -0,0 +1,19 @@
+import { isRecord } from '@ankhorage/utility/object';
+
+/*** Validate the existing recursive ManifestValue domain used by authored bindings and API metadata. */
+export function isManifestValue(value: unknown): boolean {
+  if (
+    value === null ||
+    typeof value === 'string' ||
+    typeof value === 'number' ||
+    typeof value === 'boolean'
+  ) {
+    return true;
+  }
+
+  if (Array.isArray(value)) {
+    return value.every(isManifestValue);
+  }
+
+  return isRecord(value) && Object.values(value).every(isManifestValue);
+}