@ankhorage/contracts 7.1.0 → 7.3.0

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgJA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAGpE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,iBAAiB;IACjB,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,CAAU,CAAC;AAIxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,CAAU,CAAC;AAIxD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAGvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAG/D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,CAAU,CAAC;AAInD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AAGrD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,CAAU,CAAC;AAIpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,wBAAwB;IAC3B,WAAW;IACX,UAAU;IACV,aAAa;IACb,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,YAAY,CAAU,CAAC;AAG3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC","sourcesContent":["import type { ColorHarmony } from '@ankhorage/color-theory';\n\nimport type { AuthFlowConfig, AuthIdentifierKind, AuthOAuthConfig, AuthSignUpField } from './auth';\nimport type {\n  BindingValueSource,\n  ComponentDataBindingRegistry,\n  ScreenDataLoaderDefinition,\n} from './bindings';\nimport type { DataSourceRegistry, GeneratedApiRegistry } from './data';\nimport type { ScreenRequirements } from './requirements';\nimport type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme';\n\nexport interface ThemeModeConfig {\n  primaryColor: string;\n  harmony: ColorHarmony;\n}\n\nexport interface ThemeConfig {\n  id: string;\n  name: string;\n  light: ThemeModeConfig;\n  dark: ThemeModeConfig;\n  /** Theme-global authored token overrides shared by light and dark mode. */\n  tokens?: ThemeGlobalTokenOverrides;\n  /** Component/pattern recipe override values; recipe schemas remain package-owned metadata. */\n  recipes?: ThemeRecipeOverrides;\n}\n\nexport type ActionType =\n  | 'navigate'\n  | 'alert'\n  | 'console'\n  | 'toggleDarkMode'\n  | 'setLanguage'\n  | 'search'\n  | 'filter';\n\nexport interface NavigateAction {\n  type: 'navigate';\n  payload: {\n    route: string;\n    params?: Record<string, number | string>;\n  };\n}\n\nexport interface AlertAction {\n  type: 'alert';\n  payload?: {\n    message?: string;\n  };\n}\n\nexport interface ConsoleAction {\n  type: 'console';\n  payload?: Record<string, unknown>;\n}\n\nexport interface ToggleDarkModeAction {\n  type: 'toggleDarkMode';\n  payload?: never;\n}\n\nexport interface SetLanguageAction {\n  type: 'setLanguage';\n  payload: {\n    locale: string;\n  };\n}\n\nexport interface SearchAction {\n  type: 'search';\n  payload: {\n    query: string;\n    scope?: string;\n  };\n}\n\nexport interface FilterAction {\n  type: 'filter';\n  payload: {\n    filterKey: string;\n    filterValue: string;\n  };\n}\n\nexport type Action =\n  | AlertAction\n  | ConsoleAction\n  | FilterAction\n  | NavigateAction\n  | SearchAction\n  | SetLanguageAction\n  | ToggleDarkModeAction;\n\nexport type ManifestValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly ManifestValue[]\n  | { readonly [key: string]: ManifestValue };\n\nexport type ComponentEventPayloadValue = ManifestValue;\n\nexport interface ComponentEventDto<\n  TType extends string = string,\n  TPayload extends object = Record<string, ComponentEventPayloadValue>,\n> {\n  readonly type: TType;\n  readonly sourceNodeId: string;\n  readonly payload: TPayload;\n}\n\nexport type FormSubmitValues = Record<string, ComponentEventPayloadValue>;\n\nexport type FormSubmitEventDto = ComponentEventDto<\n  'form.submit',\n  {\n    readonly values: FormSubmitValues;\n  }\n>;\n\nexport type ButtonPressEventDto = ComponentEventDto<'button.press', Record<string, never>>;\n\nexport interface CollectionItemPressPayload {\n  readonly itemId: string | number;\n  readonly item: Record<string, ComponentEventPayloadValue>;\n}\n\nexport type CollectionItemPressEventDto = ComponentEventDto<\n  'collection.itemPress',\n  CollectionItemPressPayload\n>;\n\nexport type ComponentEventDtoKind =\n  | ButtonPressEventDto['type']\n  | CollectionItemPressEventDto['type']\n  | FormSubmitEventDto['type'];\n\nexport type KnownComponentEventDto =\n  | ButtonPressEventDto\n  | CollectionItemPressEventDto\n  | FormSubmitEventDto;\n\nexport const NAVIGATOR_TYPES = ['stack', 'tabs', 'drawer'] as const;\nexport type NavigatorType = (typeof NAVIGATOR_TYPES)[number];\n\nexport const APP_CATEGORIES = [\n  'books_reading',\n  'business_productivity',\n  'developer_tools',\n  'education_learning',\n  'entertainment_media',\n  'finance_money',\n  'food_drink',\n  'games',\n  'graphics_design',\n  'health_fitness',\n  'kids_family',\n  'lifestyle',\n  'medical',\n  'music_audio',\n  'navigation_travel',\n  'news_magazines',\n  'photo_video',\n  'reference',\n  'shopping_commerce',\n  'social_community',\n  'sports',\n  'utilities_tools',\n  'weather',\n] as const;\nexport type AppCategory = (typeof APP_CATEGORIES)[number];\n\nexport const DEPLOYMENT_TARGETS = ['minikube'] as const;\nexport type KnownDeploymentTarget = (typeof DEPLOYMENT_TARGETS)[number];\nexport type DeploymentTarget = KnownDeploymentTarget | (string & {});\n\nexport const DATABASE_PROVIDERS = ['supabase'] as const;\nexport type KnownDatabaseProvider = (typeof DATABASE_PROVIDERS)[number];\nexport type DatabaseProvider = KnownDatabaseProvider | (string & {});\n\nexport const DATABASE_TIERS = ['dev', 'prod'] as const;\nexport type DatabaseTier = (typeof DATABASE_TIERS)[number];\n\nexport const STORAGE_PROVIDERS = ['auto', 's3', 'r2'] as const;\nexport type StorageProvider = (typeof STORAGE_PROVIDERS)[number];\n\nexport const STATE_PROVIDERS = ['legend'] as const;\nexport type KnownStateProvider = (typeof STATE_PROVIDERS)[number];\nexport type StateProvider = KnownStateProvider | (string & {});\n\nexport const STATE_PERSISTENCE_MODES = ['none', 'local', 'secure', 'database'] as const;\nexport type StatePersistenceMode = (typeof STATE_PERSISTENCE_MODES)[number];\n\nexport const AUTHZ_KINDS = ['RBAC', 'ABAC'] as const;\nexport type AuthzKind = (typeof AUTHZ_KINDS)[number];\n\nexport const AUTHZ_ENGINES = ['cerbos', 'native'] as const;\nexport type AuthzEngine = (typeof AUTHZ_ENGINES)[number];\n\nexport const AUTH_SCOPES = ['global', 'none', 'integrated'] as const;\nexport type AuthScope = (typeof AUTH_SCOPES)[number];\n\nexport const AUTH_PROVIDERS = ['supabase'] as const;\nexport type KnownAuthProvider = (typeof AUTH_PROVIDERS)[number];\nexport type AuthProvider = KnownAuthProvider | (string & {});\n\nexport const AUTH_SIGN_IN_IDENTIFIERS = ['email', 'username', 'phone'] as const;\nexport type AuthSignInIdentifier = AuthIdentifierKind;\n\nexport const AUTH_SIGN_UP_POLICIES = ['autoSignIn', 'requireVerification'] as const;\nexport type AuthSignUpPolicy = (typeof AUTH_SIGN_UP_POLICIES)[number];\n\nexport const AUTH_PROFILE_FIELDS = [\n  ...AUTH_SIGN_IN_IDENTIFIERS,\n  'firstName',\n  'lastName',\n  'displayName',\n  'avatarUrl',\n] as const;\nexport type KnownAuthProfileField = (typeof AUTH_PROFILE_FIELDS)[number];\nexport type AuthProfileField = KnownAuthProfileField | (string & {});\n\nexport const AUTH_PROFILE_PRIMARY_KEY_STRATEGIES = ['authUserId'] as const;\nexport type AuthProfilePrimaryKeyStrategy = (typeof AUTH_PROFILE_PRIMARY_KEY_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_CREATE_STRATEGIES = ['trigger', 'api', 'app'] as const;\nexport type AuthProfileCreateStrategy = (typeof AUTH_PROFILE_CREATE_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_UPDATE_STRATEGIES = ['api', 'app'] as const;\nexport type AuthProfileUpdateStrategy = (typeof AUTH_PROFILE_UPDATE_STRATEGIES)[number];\n\nexport interface IconSpec {\n  name: string;\n  provider?: string;\n  size?: number | string;\n  color?: string;\n}\n\nexport interface UiNodeRepeatSpec {\n  source: BindingValueSource;\n  itemAlias?: string;\n  keyPath?: string;\n  empty?: readonly UiNode[];\n}\n\nexport interface UiNode {\n  id: string;\n  type: string;\n  alias?: string;\n  props?: Record<string, unknown>;\n  children?: UiNode[];\n  style?: Record<string, number | string>;\n  repeat?: UiNodeRepeatSpec;\n}\n\nexport interface ScreenSpec {\n  id: string;\n  name: string;\n  title?: string;\n  description?: string;\n  root: UiNode;\n  dataLoaders?: readonly ScreenDataLoaderDefinition[];\n  requires?: ScreenRequirements;\n}\n\nexport interface NavigatorSpec {\n  type: NavigatorType;\n  initialRouteName?: string;\n  routes: RouteDefinition[];\n  options?: Record<string, unknown>;\n}\n\nexport interface RouteDefinition {\n  name: string;\n  path?: string;\n  label?: string;\n  icon?: IconSpec;\n  /**\n   * Whether this route appears in Tabs and Drawer primary navigation.\n   *\n   * Omitted routes are visible by default. Setting this to `false` hides the\n   * route from primary navigation without making it unnavigable. Stack\n   * navigators preserve the value but do not present primary navigation.\n   */\n  showInPrimaryNavigation?: boolean;\n  guards?: string[];\n  screenId?: string;\n  navigator?: NavigatorSpec;\n}\n\nexport type SplashScreenResizeMode = 'contain' | 'cover' | 'native';\n\nexport interface SplashScreenAssetSpec {\n  readonly image?: string;\n  readonly imageWidth?: number;\n  readonly resizeMode?: SplashScreenResizeMode;\n}\n\nexport interface SplashScreenModeSpec extends SplashScreenAssetSpec {\n  readonly backgroundColor?: string;\n}\n\nexport interface SplashScreenSpec extends SplashScreenModeSpec {\n  readonly dark?: SplashScreenModeSpec;\n}\n\nexport interface DeploymentSpec {\n  target: DeploymentTarget;\n  monitoring: boolean;\n}\n\nexport interface DatabaseSpec {\n  provider: DatabaseProvider;\n  tier: DatabaseTier;\n}\n\nexport interface StorageSpec {\n  provider: StorageProvider;\n  buckets: string[];\n}\n\nexport interface StateSpec {\n  readonly provider: StateProvider;\n  readonly persistence?: StatePersistenceMode;\n}\n\nexport interface AuthzSpec {\n  kind: AuthzKind;\n  engine: AuthzEngine;\n}\n\nexport interface AuthSignInSpec {\n  identifiers: AuthSignInIdentifier[];\n}\n\nexport interface AuthSignUpSpec {\n  requiredFields: AuthSignUpField[];\n  optionalFields?: AuthSignUpField[];\n  signUpPolicy?: AuthSignUpPolicy;\n}\n\nexport interface AuthProfileSpec {\n  fields: AuthProfileField[];\n  table?: string;\n  primaryKey?: AuthProfilePrimaryKeyStrategy;\n  createStrategy?: AuthProfileCreateStrategy;\n  updateStrategy?: AuthProfileUpdateStrategy;\n}\n\nexport interface AuthSpec {\n  scope: AuthScope;\n  provider: AuthProvider;\n  authorization?: AuthzSpec;\n  flow?: AuthFlowConfig;\n  signIn?: AuthSignInSpec;\n  signUp?: AuthSignUpSpec;\n  oauth?: AuthOAuthConfig;\n  profile?: AuthProfileSpec;\n}\n\nexport interface NetworkingSpec {\n  domain?: string;\n  cdn: boolean;\n}\n\nexport interface InfraManifest {\n  deployment?: DeploymentSpec;\n  auth?: AuthSpec;\n  database?: DatabaseSpec;\n  storage?: StorageSpec;\n  state?: StateSpec;\n  networking?: NetworkingSpec;\n  modules: string[];\n  modulesConfig?: Record<string, unknown>;\n}\n\nexport interface AppSettings {\n  apiBaseUrl?: string;\n  localization: {\n    defaultLocale: string;\n    locales: string[];\n  };\n}\n\nexport interface AppManifest {\n  metadata: {\n    name: string;\n    slug: string;\n    version: string;\n    category: AppCategory;\n    themeId: string;\n    created?: string;\n    updated?: string;\n  };\n  themes: ThemeConfig[];\n  activeThemeId: string;\n  activeThemeMode?: 'dark' | 'light';\n  splashScreen?: SplashScreenSpec;\n  infra: InfraManifest;\n  navigator: NavigatorSpec;\n  screens: Record<string, ScreenSpec>;\n  generatedApis?: GeneratedApiRegistry;\n  dataSources?: DataSourceRegistry;\n  dataBindings?: ComponentDataBindingRegistry;\n  settings: AppSettings;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiJA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAGpE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,uBAAuB;IACvB,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,iBAAiB;IACjB,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,CAAU,CAAC;AAIxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,CAAU,CAAC;AAIxD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAGvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAG/D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,CAAU,CAAC;AAInD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AAGrD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,CAAU,CAAC;AAIpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,qBAAqB,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,wBAAwB;IAC3B,WAAW;IACX,UAAU;IACV,aAAa;IACb,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,YAAY,CAAU,CAAC;AAG3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC","sourcesContent":["import type { ColorHarmony } from '@ankhorage/color-theory';\n\nimport type { AuthFlowConfig, AuthIdentifierKind, AuthOAuthConfig, AuthSignUpField } from './auth';\nimport type {\n  BindingValueSource,\n  ComponentDataBindingRegistry,\n  ScreenDataLoaderDefinition,\n} from './bindings';\nimport type { DataSourceRegistry, GeneratedApiRegistry } from './data';\nimport type { MediaManifest } from './media';\nimport type { ScreenRequirements } from './requirements';\nimport type { ThemeGlobalTokenOverrides, ThemeRecipeOverrides } from './theme';\n\nexport interface ThemeModeConfig {\n  primaryColor: string;\n  harmony: ColorHarmony;\n}\n\nexport interface ThemeConfig {\n  id: string;\n  name: string;\n  light: ThemeModeConfig;\n  dark: ThemeModeConfig;\n  /** Theme-global authored token overrides shared by light and dark mode. */\n  tokens?: ThemeGlobalTokenOverrides;\n  /** Component/pattern recipe override values; recipe schemas remain package-owned metadata. */\n  recipes?: ThemeRecipeOverrides;\n}\n\nexport type ActionType =\n  | 'navigate'\n  | 'alert'\n  | 'console'\n  | 'toggleDarkMode'\n  | 'setLanguage'\n  | 'search'\n  | 'filter';\n\nexport interface NavigateAction {\n  type: 'navigate';\n  payload: {\n    route: string;\n    params?: Record<string, number | string>;\n  };\n}\n\nexport interface AlertAction {\n  type: 'alert';\n  payload?: {\n    message?: string;\n  };\n}\n\nexport interface ConsoleAction {\n  type: 'console';\n  payload?: Record<string, unknown>;\n}\n\nexport interface ToggleDarkModeAction {\n  type: 'toggleDarkMode';\n  payload?: never;\n}\n\nexport interface SetLanguageAction {\n  type: 'setLanguage';\n  payload: {\n    locale: string;\n  };\n}\n\nexport interface SearchAction {\n  type: 'search';\n  payload: {\n    query: string;\n    scope?: string;\n  };\n}\n\nexport interface FilterAction {\n  type: 'filter';\n  payload: {\n    filterKey: string;\n    filterValue: string;\n  };\n}\n\nexport type Action =\n  | AlertAction\n  | ConsoleAction\n  | FilterAction\n  | NavigateAction\n  | SearchAction\n  | SetLanguageAction\n  | ToggleDarkModeAction;\n\nexport type ManifestValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly ManifestValue[]\n  | { readonly [key: string]: ManifestValue };\n\nexport type ComponentEventPayloadValue = ManifestValue;\n\nexport interface ComponentEventDto<\n  TType extends string = string,\n  TPayload extends object = Record<string, ComponentEventPayloadValue>,\n> {\n  readonly type: TType;\n  readonly sourceNodeId: string;\n  readonly payload: TPayload;\n}\n\nexport type FormSubmitValues = Record<string, ComponentEventPayloadValue>;\n\nexport type FormSubmitEventDto = ComponentEventDto<\n  'form.submit',\n  {\n    readonly values: FormSubmitValues;\n  }\n>;\n\nexport type ButtonPressEventDto = ComponentEventDto<'button.press', Record<string, never>>;\n\nexport interface CollectionItemPressPayload {\n  readonly itemId: string | number;\n  readonly item: Record<string, ComponentEventPayloadValue>;\n}\n\nexport type CollectionItemPressEventDto = ComponentEventDto<\n  'collection.itemPress',\n  CollectionItemPressPayload\n>;\n\nexport type ComponentEventDtoKind =\n  | ButtonPressEventDto['type']\n  | CollectionItemPressEventDto['type']\n  | FormSubmitEventDto['type'];\n\nexport type KnownComponentEventDto =\n  | ButtonPressEventDto\n  | CollectionItemPressEventDto\n  | FormSubmitEventDto;\n\nexport const NAVIGATOR_TYPES = ['stack', 'tabs', 'drawer'] as const;\nexport type NavigatorType = (typeof NAVIGATOR_TYPES)[number];\n\nexport const APP_CATEGORIES = [\n  'books_reading',\n  'business_productivity',\n  'developer_tools',\n  'education_learning',\n  'entertainment_media',\n  'finance_money',\n  'food_drink',\n  'games',\n  'graphics_design',\n  'health_fitness',\n  'kids_family',\n  'lifestyle',\n  'medical',\n  'music_audio',\n  'navigation_travel',\n  'news_magazines',\n  'photo_video',\n  'reference',\n  'shopping_commerce',\n  'social_community',\n  'sports',\n  'utilities_tools',\n  'weather',\n] as const;\nexport type AppCategory = (typeof APP_CATEGORIES)[number];\n\nexport const DEPLOYMENT_TARGETS = ['minikube'] as const;\nexport type KnownDeploymentTarget = (typeof DEPLOYMENT_TARGETS)[number];\nexport type DeploymentTarget = KnownDeploymentTarget | (string & {});\n\nexport const DATABASE_PROVIDERS = ['supabase'] as const;\nexport type KnownDatabaseProvider = (typeof DATABASE_PROVIDERS)[number];\nexport type DatabaseProvider = KnownDatabaseProvider | (string & {});\n\nexport const DATABASE_TIERS = ['dev', 'prod'] as const;\nexport type DatabaseTier = (typeof DATABASE_TIERS)[number];\n\nexport const STORAGE_PROVIDERS = ['auto', 's3', 'r2'] as const;\nexport type StorageProvider = (typeof STORAGE_PROVIDERS)[number];\n\nexport const STATE_PROVIDERS = ['legend'] as const;\nexport type KnownStateProvider = (typeof STATE_PROVIDERS)[number];\nexport type StateProvider = KnownStateProvider | (string & {});\n\nexport const STATE_PERSISTENCE_MODES = ['none', 'local', 'secure', 'database'] as const;\nexport type StatePersistenceMode = (typeof STATE_PERSISTENCE_MODES)[number];\n\nexport const AUTHZ_KINDS = ['RBAC', 'ABAC'] as const;\nexport type AuthzKind = (typeof AUTHZ_KINDS)[number];\n\nexport const AUTHZ_ENGINES = ['cerbos', 'native'] as const;\nexport type AuthzEngine = (typeof AUTHZ_ENGINES)[number];\n\nexport const AUTH_SCOPES = ['global', 'none', 'integrated'] as const;\nexport type AuthScope = (typeof AUTH_SCOPES)[number];\n\nexport const AUTH_PROVIDERS = ['supabase'] as const;\nexport type KnownAuthProvider = (typeof AUTH_PROVIDERS)[number];\nexport type AuthProvider = KnownAuthProvider | (string & {});\n\nexport const AUTH_SIGN_IN_IDENTIFIERS = ['email', 'username', 'phone'] as const;\nexport type AuthSignInIdentifier = AuthIdentifierKind;\n\nexport const AUTH_SIGN_UP_POLICIES = ['autoSignIn', 'requireVerification'] as const;\nexport type AuthSignUpPolicy = (typeof AUTH_SIGN_UP_POLICIES)[number];\n\nexport const AUTH_PROFILE_FIELDS = [\n  ...AUTH_SIGN_IN_IDENTIFIERS,\n  'firstName',\n  'lastName',\n  'displayName',\n  'avatarUrl',\n] as const;\nexport type KnownAuthProfileField = (typeof AUTH_PROFILE_FIELDS)[number];\nexport type AuthProfileField = KnownAuthProfileField | (string & {});\n\nexport const AUTH_PROFILE_PRIMARY_KEY_STRATEGIES = ['authUserId'] as const;\nexport type AuthProfilePrimaryKeyStrategy = (typeof AUTH_PROFILE_PRIMARY_KEY_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_CREATE_STRATEGIES = ['trigger', 'api', 'app'] as const;\nexport type AuthProfileCreateStrategy = (typeof AUTH_PROFILE_CREATE_STRATEGIES)[number];\n\nexport const AUTH_PROFILE_UPDATE_STRATEGIES = ['api', 'app'] as const;\nexport type AuthProfileUpdateStrategy = (typeof AUTH_PROFILE_UPDATE_STRATEGIES)[number];\n\nexport interface IconSpec {\n  name: string;\n  provider?: string;\n  size?: number | string;\n  color?: string;\n}\n\nexport interface UiNodeRepeatSpec {\n  source: BindingValueSource;\n  itemAlias?: string;\n  keyPath?: string;\n  empty?: readonly UiNode[];\n}\n\nexport interface UiNode {\n  id: string;\n  type: string;\n  alias?: string;\n  props?: Record<string, unknown>;\n  children?: UiNode[];\n  style?: Record<string, number | string>;\n  repeat?: UiNodeRepeatSpec;\n}\n\nexport interface ScreenSpec {\n  id: string;\n  name: string;\n  title?: string;\n  description?: string;\n  root: UiNode;\n  dataLoaders?: readonly ScreenDataLoaderDefinition[];\n  requires?: ScreenRequirements;\n}\n\nexport interface NavigatorSpec {\n  type: NavigatorType;\n  initialRouteName?: string;\n  routes: RouteDefinition[];\n  options?: Record<string, unknown>;\n}\n\nexport interface RouteDefinition {\n  name: string;\n  path?: string;\n  label?: string;\n  icon?: IconSpec;\n  /**\n   * Whether this route appears in Tabs and Drawer primary navigation.\n   *\n   * Omitted routes are visible by default. Setting this to `false` hides the\n   * route from primary navigation without making it unnavigable. Stack\n   * navigators preserve the value but do not present primary navigation.\n   */\n  showInPrimaryNavigation?: boolean;\n  guards?: string[];\n  screenId?: string;\n  navigator?: NavigatorSpec;\n}\n\nexport type SplashScreenResizeMode = 'contain' | 'cover' | 'native';\n\nexport interface SplashScreenAssetSpec {\n  readonly image?: string;\n  readonly imageWidth?: number;\n  readonly resizeMode?: SplashScreenResizeMode;\n}\n\nexport interface SplashScreenModeSpec extends SplashScreenAssetSpec {\n  readonly backgroundColor?: string;\n}\n\nexport interface SplashScreenSpec extends SplashScreenModeSpec {\n  readonly dark?: SplashScreenModeSpec;\n}\n\nexport interface DeploymentSpec {\n  target: DeploymentTarget;\n  monitoring: boolean;\n}\n\nexport interface DatabaseSpec {\n  provider: DatabaseProvider;\n  tier: DatabaseTier;\n}\n\nexport interface StorageSpec {\n  provider: StorageProvider;\n  buckets: string[];\n}\n\nexport interface StateSpec {\n  readonly provider: StateProvider;\n  readonly persistence?: StatePersistenceMode;\n}\n\nexport interface AuthzSpec {\n  kind: AuthzKind;\n  engine: AuthzEngine;\n}\n\nexport interface AuthSignInSpec {\n  identifiers: AuthSignInIdentifier[];\n}\n\nexport interface AuthSignUpSpec {\n  requiredFields: AuthSignUpField[];\n  optionalFields?: AuthSignUpField[];\n  signUpPolicy?: AuthSignUpPolicy;\n}\n\nexport interface AuthProfileSpec {\n  fields: AuthProfileField[];\n  table?: string;\n  primaryKey?: AuthProfilePrimaryKeyStrategy;\n  createStrategy?: AuthProfileCreateStrategy;\n  updateStrategy?: AuthProfileUpdateStrategy;\n}\n\nexport interface AuthSpec {\n  scope: AuthScope;\n  provider: AuthProvider;\n  authorization?: AuthzSpec;\n  flow?: AuthFlowConfig;\n  signIn?: AuthSignInSpec;\n  signUp?: AuthSignUpSpec;\n  oauth?: AuthOAuthConfig;\n  profile?: AuthProfileSpec;\n}\n\nexport interface NetworkingSpec {\n  domain?: string;\n  cdn: boolean;\n}\n\nexport interface InfraManifest {\n  deployment?: DeploymentSpec;\n  auth?: AuthSpec;\n  database?: DatabaseSpec;\n  storage?: StorageSpec;\n  state?: StateSpec;\n  networking?: NetworkingSpec;\n  modules: string[];\n  modulesConfig?: Record<string, unknown>;\n}\n\nexport interface AppSettings {\n  apiBaseUrl?: string;\n  localization: {\n    defaultLocale: string;\n    locales: string[];\n  };\n}\n\nexport interface AppManifest {\n  metadata: {\n    name: string;\n    slug: string;\n    version: string;\n    category: AppCategory;\n    themeId: string;\n    created?: string;\n    updated?: string;\n  };\n  themes: ThemeConfig[];\n  activeThemeId: string;\n  activeThemeMode?: 'dark' | 'light';\n  splashScreen?: SplashScreenSpec;\n  /** Studio-managed authoring media. Runtime/user uploads are intentionally separate. */\n  media?: MediaManifest;\n  infra: InfraManifest;\n  navigator: NavigatorSpec;\n  screens: Record<string, ScreenSpec>;\n  generatedApis?: GeneratedApiRegistry;\n  dataSources?: DataSourceRegistry;\n  dataBindings?: ComponentDataBindingRegistry;\n  settings: AppSettings;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "7.1.0",
+  "version": "7.3.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -64,6 +64,10 @@
     "./ui": {
       "types": "./dist/ui.d.ts",
       "default": "./dist/ui.js"
+    },
+    "./media": {
+      "types": "./dist/media.d.ts",
+      "default": "./dist/media.js"
     }
   },
   "description": "Serializable app, action, theme, auth, and secret-store contracts for Ankhorage.",
@@ -76,7 +80,9 @@
     "secrets",
     "secret-store",
     "storage",
-    "adapter"
+    "adapter",
+    "media",
+    "assets"
   ],
   "files": [
     "dist",

package/src/appManifest/bindings.ts

@@ -0,0 +1,135 @@
+import { isManifestValue, isOptionalString, isRecord } from './shared';
+
+export function isComponentDataBindingRegistry(value: unknown): boolean {
+  return isRecord(value) && Object.values(value).every(isComponentDataBinding);
+}
+
+export function isBindingValueSource(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.kind === 'string' &&
+    ['context', 'event', 'literal', 'operation', 'state'].includes(value.kind) &&
+    (value.kind === 'literal'
+      ? isManifestValue(value.value)
+      : value.kind === 'operation'
+        ? isBindingOperationRef(value.operation) && isOptionalString(value.path)
+        : typeof value.path === 'string')
+  );
+}
+
+export function isScreenDataLoaderDefinition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    value.kind === 'operation' &&
+    isOptionalString(value.id) &&
+    isBindingOperationRef(value.operation) &&
+    (value.input === undefined || isBindingInputMap(value.input))
+  );
+}
+
+function isComponentDataBinding(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.componentId === 'string' &&
+    isOptionalString(value.componentType) &&
+    (value.props === undefined ||
+      (isRecord(value.props) && Object.values(value.props).every(isPropBinding))) &&
+    (value.events === undefined ||
+      (isRecord(value.events) &&
+        Object.values(value.events).every(
+          (bindings) => Array.isArray(bindings) && bindings.every(isEventBinding),
+        )))
+  );
+}
+
+function isPropBinding(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isBindingValueSource(value.source) &&
+    (value.fallback === undefined || isBindingFallback(value.fallback)) &&
+    (value.loading === undefined || isBindingLifecycleBehavior(value.loading)) &&
+    (value.error === undefined || isBindingLifecycleBehavior(value.error)) &&
+    (value.empty === undefined || isBindingLifecycleBehavior(value.empty)) &&
+    isOptionalBindingTransforms(value.transforms)
+  );
+}
+
+function isEventBinding(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isEventBindingTarget(value.target) &&
+    (value.input === undefined || isBindingInputMap(value.input)) &&
+    (value.when === undefined || isBindingCondition(value.when))
+  );
+}
+
+function isEventBindingTarget(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    ((value.kind === 'action' && typeof value.type === 'string') ||
+      (value.kind === 'operation' && isBindingOperationRef(value.operation)))
+  );
+}
+
+function isBindingCondition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isBindingValueSource(value.source) &&
+    ['eq', 'exists', 'neq', 'notExists'].includes(String(value.operator)) &&
+    (value.value === undefined || isManifestValue(value.value))
+  );
+}
+
+function isBindingOperationRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.dataSourceId === 'string' &&
+    typeof value.operationId === 'string' &&
+    isOptionalString(value.endpointId)
+  );
+}
+
+function isBindingFallback(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    (value.value === undefined || isManifestValue(value.value)) &&
+    (value.source === undefined || isBindingValueSource(value.source))
+  );
+}
+
+function isBindingLifecycleBehavior(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.state === 'string' &&
+    ['empty', 'error', 'loading'].includes(value.state) &&
+    (value.fallback === undefined || isBindingFallback(value.fallback)) &&
+    isOptionalString(value.message)
+  );
+}
+
+function isOptionalBindingTransforms(value: unknown): boolean {
+  return (
+    value === undefined ||
+    (Array.isArray(value) &&
+      value.every((transform) => ['lowercase', 'trim', 'uppercase'].includes(String(transform))))
+  );
+}
+
+function isBindingInputMap(value: unknown): boolean {
+  return isRecord(value) && Object.values(value).every(isBindingInputValue);
+}
+
+function isBindingInputValue(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.kind === 'string' &&
+    ((value.kind === 'array' &&
+      Array.isArray(value.items) &&
+      value.items.every(isBindingInputValue)) ||
+      (value.kind === 'literal' && isManifestValue(value.value)) ||
+      (value.kind === 'object' && isBindingInputMap(value.fields)) ||
+      (value.kind === 'source' &&
+        isBindingValueSource(value.source) &&
+        isOptionalBindingTransforms(value.transforms)))
+  );
+}

package/src/appManifest/dataSources.ts

@@ -0,0 +1,175 @@
+import { isManifestValue, isOptionalBoolean, isOptionalString, isRecord } from './shared';
+
+export function isDataSourceRegistry(value: unknown): boolean {
+  return isRecord(value) && Object.values(value).every(isDataSourceConfig);
+}
+
+function isDataSourceConfig(value: unknown): boolean {
+  if (!hasBaseDataSourceShape(value)) return false;
+  if (value.kind === 'database') return isDatabaseDataSource(value);
+  if (value.origin === 'generated') return isGeneratedDataSource(value);
+  if (value.origin !== 'external') return false;
+  return isExternalDataSource(value);
+}
+
+function hasBaseDataSourceShape(value: unknown): value is Record<string, unknown> {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    (value.kind === 'api' || value.kind === 'database') &&
+    isOptionalString(value.name) &&
+    isOptionalString(value.description) &&
+    (value.credential === undefined || isCredentialRef(value.credential)) &&
+    isDataEndpointRegistry(value.endpoints) &&
+    (value.schemas === undefined || isRecord(value.schemas)) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isDatabaseDataSource(value: Record<string, unknown>): boolean {
+  return (
+    isRecord(value.adapter) && value.adapter.kind === 'database' && isAdapterRef(value.adapter)
+  );
+}
+
+function isGeneratedDataSource(value: Record<string, unknown>): boolean {
+  return (
+    value.protocol === 'rest' &&
+    typeof value.generatedApiId === 'string' &&
+    isRecord(value.adapter) &&
+    value.adapter.kind === 'database' &&
+    isAdapterRef(value.adapter)
+  );
+}
+
+function isExternalDataSource(value: Record<string, unknown>): boolean {
+  if (value.protocol === 'rest') {
+    return (
+      typeof value.baseUrl === 'string' &&
+      (value.openApi === undefined || isOpenApiDocumentRef(value.openApi))
+    );
+  }
+
+  if (value.protocol === 'graphql') {
+    return (
+      typeof value.endpointUrl === 'string' &&
+      (value.introspection === undefined || isGraphQlIntrospection(value.introspection))
+    );
+  }
+
+  return false;
+}
+
+function isOpenApiDocumentRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isOptionalString(value.url) &&
+    isOptionalString(value.documentId) &&
+    isOptionalString(value.version)
+  );
+}
+
+function isGraphQlIntrospection(value: unknown): boolean {
+  return (
+    isRecord(value) && typeof value.enabled === 'boolean' && isOptionalString(value.schemaVersion)
+  );
+}
+
+function isDataEndpointRegistry(value: unknown): boolean {
+  return isRecord(value) && Object.values(value).every(isDataEndpointConfig);
+}
+
+function isDataEndpointConfig(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    typeof value.kind === 'string' &&
+    isOptionalString(value.name) &&
+    isOptionalString(value.description) &&
+    isOptionalString(value.baseUrl) &&
+    isOptionalString(value.path) &&
+    (value.credential === undefined || isCredentialRef(value.credential)) &&
+    isRecord(value.operations) &&
+    Object.values(value.operations).every(isDataOperationConfig) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isDataOperationConfig(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    isOptionalString(value.endpointId) &&
+    isOptionalString(value.name) &&
+    isOptionalString(value.description) &&
+    typeof value.protocol === 'string' &&
+    typeof value.intent === 'string' &&
+    ['action', 'create', 'delete', 'read', 'update'].includes(value.intent) &&
+    isOptionalString(value.method) &&
+    isOptionalString(value.path) &&
+    (value.request === undefined || isDataOperationRequest(value.request)) &&
+    (value.response === undefined || isDataOperationResponse(value.response)) &&
+    (value.pagination === undefined || isRecord(value.pagination)) &&
+    (value.credential === undefined || isCredentialRef(value.credential)) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isDataOperationRequest(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isDataSchemaSlot(value) &&
+    (value.parameters === undefined ||
+      (Array.isArray(value.parameters) && value.parameters.every(isDataOperationParameter)))
+  );
+}
+
+function isDataOperationParameter(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isDataSchemaSlot(value) &&
+    typeof value.name === 'string' &&
+    typeof value.location === 'string' &&
+    ['body', 'cookie', 'header', 'path', 'query'].includes(value.location) &&
+    isOptionalBoolean(value.required) &&
+    isOptionalString(value.description) &&
+    (value.default === undefined || isManifestValue(value.default))
+  );
+}
+
+function isDataOperationResponse(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isDataSchemaSlot(value) &&
+    (value.status === undefined ||
+      typeof value.status === 'string' ||
+      typeof value.status === 'number') &&
+    isOptionalString(value.contentType) &&
+    isOptionalString(value.description)
+  );
+}
+
+function isDataSchemaSlot(value: unknown): boolean {
+  return isRecord(value) && (value.schema === undefined || isRecord(value.schema));
+}
+
+function isCredentialRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    typeof value.kind === 'string' &&
+    isOptionalString(value.label) &&
+    isOptionalString(value.scope)
+  );
+}
+
+function isAdapterRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    typeof value.kind === 'string' &&
+    isOptionalString(value.packageName) &&
+    isOptionalString(value.exportName) &&
+    (value.config === undefined || isManifestValue(value.config))
+  );
+}

package/src/appManifest/generatedApis.ts

@@ -0,0 +1,122 @@
+import {
+  isManifestValue,
+  isOptionalBoolean,
+  isOptionalString,
+  isRecord,
+  isStringArray,
+} from './shared';
+
+export function isGeneratedApiRegistry(value: unknown): boolean {
+  return isRecord(value) && Object.values(value).every(isGeneratedApiDefinition);
+}
+
+function isGeneratedApiDefinition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    value.protocol === 'rest' &&
+    isOptionalString(value.name) &&
+    isOptionalString(value.description) &&
+    typeof value.basePath === 'string' &&
+    isDatabaseAdapterRef(value.database) &&
+    Array.isArray(value.resources) &&
+    value.resources.every(isGeneratedApiResourceDefinition) &&
+    (value.auth === undefined || isGeneratedApiAuthRequirement(value.auth)) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isDatabaseAdapterRef(value: unknown): boolean {
+  return isRecord(value) && value.kind === 'database' && isAdapterRef(value);
+}
+
+function isGeneratedApiAuthRequirement(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    isOptionalBoolean(value.required) &&
+    (value.roles === undefined || isStringArray(value.roles)) &&
+    (value.permissions === undefined || isStringArray(value.permissions)) &&
+    isOptionalString(value.policy) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isGeneratedApiResourceDefinition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    isOptionalString(value.name) &&
+    isOptionalString(value.description) &&
+    typeof value.path === 'string' &&
+    isDbCollectionDefinition(value.collection) &&
+    Array.isArray(value.operations) &&
+    value.operations.every(isGeneratedApiCrudOperation) &&
+    (value.seed === undefined || isSeedRecords(value.seed)) &&
+    (value.policies === undefined ||
+      (Array.isArray(value.policies) && value.policies.every(isGeneratedApiPolicyRef))) &&
+    (value.metadata === undefined || isManifestValue(value.metadata))
+  );
+}
+
+function isSeedRecords(value: unknown): boolean {
+  return (
+    Array.isArray(value) &&
+    value.every((record) => isRecord(record) && Object.values(record).every(isManifestValue))
+  );
+}
+
+function isGeneratedApiCrudOperation(value: unknown): boolean {
+  return ['create', 'delete', 'list', 'read', 'update'].includes(String(value));
+}
+
+function isGeneratedApiPolicyRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    (value.operation === undefined || isGeneratedApiCrudOperation(value.operation))
+  );
+}
+
+function isDbCollectionDefinition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.name === 'string' &&
+    isOptionalString(value.schema) &&
+    Array.isArray(value.fields) &&
+    value.fields.every(isDbFieldDefinition) &&
+    isOptionalString(value.primaryKey)
+  );
+}
+
+function isDbFieldDefinition(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.name === 'string' &&
+    typeof value.type === 'string' &&
+    ['text', 'number', 'boolean', 'datetime', 'json', 'uuid'].includes(value.type) &&
+    isOptionalBoolean(value.required) &&
+    isOptionalBoolean(value.unique) &&
+    isDbDefaultValue(value.defaultValue)
+  );
+}
+
+function isDbDefaultValue(value: unknown): boolean {
+  return (
+    value === undefined ||
+    value === null ||
+    typeof value === 'boolean' ||
+    typeof value === 'number' ||
+    typeof value === 'string'
+  );
+}
+
+function isAdapterRef(value: unknown): boolean {
+  return (
+    isRecord(value) &&
+    typeof value.id === 'string' &&
+    typeof value.kind === 'string' &&
+    isOptionalString(value.packageName) &&
+    isOptionalString(value.exportName) &&
+    (value.config === undefined || isManifestValue(value.config))
+  );
+}