@vxrn/utils 2.0.0-beta.99.1 → 2.6.0

package/src/nativeAppManifest.test.ts

@@ -1,5 +1,9 @@
 import { describe, expect, test } from 'vitest'
-import { validateNativeApp, type NativeAppManifest } from './nativeAppManifest'
+import {
+  expoClientFromNativeApp,
+  validateNativeApp,
+  type NativeAppManifest,
+} from './nativeAppManifest'
 
 const app = {
   name: 'MyApp',
@@ -42,6 +46,17 @@ describe('native.app manifest', () => {
         icon: { source: '', backgroundColor: '#000000' },
       })
     ).toThrow(/icon/)
+    expect(() => validateNativeApp({
+      ...app, ios: { ...app.ios, alternateIcons: {
+        TestAlternate: { source: 'alternate.svg', backgroundColor: '#123456' },
+      } },
+    })).toThrow(/requires a primary icon/)
+    expect(() => validateNativeApp({
+      ...app, icon: { source: 'primary.svg', backgroundColor: '#123456' },
+      ios: { ...app.ios, alternateIcons: {
+        AppIcon: { source: 'alternate.svg', backgroundColor: '#123456' },
+      } },
+    })).toThrow(/other than AppIcon/)
     expect(() =>
       validateNativeApp({
         ...app,
@@ -62,6 +77,76 @@ describe('native.app manifest', () => {
     ).toThrow(/splash/)
   })
 
+  test('requires both speech usage strings', () => {
+    const speech = { recognition: 'Dictate messages.', microphone: 'Dictate messages.' }
+    expect(() => validateNativeApp({ ...app, speech })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, speech: { ...speech, microphone: ' ' } })).toThrow(
+      /speech\.recognition and speech\.microphone/
+    )
+  })
+
+  test('accepts the brightness system flag', () => {
+    expect(() => validateNativeApp({ ...app, brightness: true })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, brightness: 'yes' as any })).toThrow(/brightness/)
+  })
+
+  test('requires a pedometer motion prompt', () => {
+    expect(() =>
+      validateNativeApp({ ...app, pedometer: { usage: 'Count your steps.' } })
+    ).not.toThrow()
+    expect(() => validateNativeApp({ ...app, pedometer: { usage: ' ' } })).toThrow(
+      /pedometer\.usage/
+    )
+  })
+
+  test('requires an audio recording prompt', () => {
+    expect(() => validateNativeApp({ ...app, audio: { microphone: 'Record notes.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, audio: { background: true } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, audio: {} })).toThrow(/audio must configure/)
+    expect(() => validateNativeApp({ ...app, audio: { background: 'yes' } as any })).toThrow(
+      /audio\.background/
+    )
+    expect(() => validateNativeApp({ ...app, audio: { microphone: ' ' } })).toThrow(
+      /audio\.microphone/
+    )
+  })
+
+  test('requires a Photos purpose string for each configured access level', () => {
+    expect(() => validateNativeApp({ ...app, photoLibrary: { addOnly: 'Save edits.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, photoLibrary: { readWrite: 'Browse photos.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, photoLibrary: {} })).toThrow(
+      /photoLibrary must configure/
+    )
+    expect(() => validateNativeApp({ ...app, photoLibrary: null } as any)).toThrow(
+      /photoLibrary must configure/
+    )
+    expect(() => validateNativeApp({ ...app, photoLibrary: { addOnly: ' ' } })).toThrow(
+      /photoLibrary\.addOnly/
+    )
+    expect(() => validateNativeApp({ ...app, photoLibrary: { readWrite: ' ' } })).toThrow(
+      /photoLibrary\.readWrite/
+    )
+  })
+
+  test('requires a Contacts purpose string', () => {
+    expect(() => validateNativeApp({ ...app, contacts: { usage: 'Find people.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, contacts: null } as any)).toThrow(/contacts\.usage/)
+    expect(() => validateNativeApp({ ...app, contacts: { usage: ' ' } })).toThrow(
+      /contacts\.usage/
+    )
+  })
+
+  test('requires a Calendar purpose string', () => {
+    expect(() => validateNativeApp({ ...app, calendar: { usage: 'Show events.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, calendar: { remindersUsage: 'Manage tasks.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, calendar: {} })).toThrow(/calendar\.usage/)
+    expect(() => validateNativeApp({ ...app, calendar: null } as any)).toThrow(/calendar\.usage/)
+    expect(() => validateNativeApp({ ...app, calendar: { usage: ' ' } })).toThrow(/calendar\.usage/)
+    expect(() => validateNativeApp({ ...app, calendar: { remindersUsage: ' ' } })).toThrow(
+      /calendar\.remindersUsage/
+    )
+  })
+
   test('accepts a camera permission string and rejects empty ones', () => {
     expect(() => validateNativeApp({ ...app, imagePicker: undefined })).not.toThrow()
     expect(() => validateNativeApp({ ...app, imagePicker: { camera: '' } })).toThrow(
@@ -72,6 +157,25 @@ describe('native.app manifest', () => {
     )
   })
 
+  test('requires a non-empty foreground location usage string', () => {
+    expect(() => validateNativeApp({ ...app, location: { whenInUse: 'Find me.' } })).not.toThrow()
+    expect(() => validateNativeApp({ ...app, location: { whenInUse: 'Find me.', background: true } })).not.toThrow()
+    expect(() =>
+      validateNativeApp({
+        ...app,
+        location: { whenInUse: 'Find me.', alwaysAndWhenInUse: 'Track regions.' },
+      })
+    ).not.toThrow()
+    expect(() => validateNativeApp({ ...app, location: { whenInUse: 'Find me.', background: 'yes' } } as any)).toThrow(/location\.background/)
+    expect(() =>
+      validateNativeApp({ ...app, location: { whenInUse: 'Find me.', alwaysAndWhenInUse: ' ' } })
+    ).toThrow(/location\.alwaysAndWhenInUse/)
+    expect(() => validateNativeApp({ ...app, location: null } as any)).toThrow(/location\.whenInUse/)
+    expect(() => validateNativeApp({ ...app, location: { whenInUse: ' ' } })).toThrow(
+      /location\.whenInUse/
+    )
+  })
+
   test('validates the iOS widget target and App Group before prebuild', () => {
     const widgets = {
       appGroup: 'group.dev.one.myapp',
@@ -102,6 +206,22 @@ describe('native.app manifest', () => {
     ).toThrow(/appGroup/)
   })
 
+  test('validates static App Intent identifiers and shortcut phrases', () => {
+    const first = {
+      id: 'dev.one.myapp.echo',
+      title: 'Echo text',
+      textParameterTitle: 'Text',
+      shortcutPhrase: 'Echo text in {app}',
+    }
+    const withActions = (actions: Array<typeof first>) =>
+      ({ ...app, ios: { ...app.ios, appIntents: { actions } } })
+    expect(() => validateNativeApp(withActions([first]))).not.toThrow()
+    expect(() => validateNativeApp(withActions([first, { ...first }]))).toThrow(/duplicated/)
+    expect(() => validateNativeApp(withActions([{ ...first, shortcutPhrase: 'Echo text' }]))).toThrow(/shortcu\w*Phrase/)
+    expect(() => validateNativeApp(withActions([{ ...first, shortcutPhrase: '{app} in {app}' }]))).toThrow(/shortcu\w*Phrase/)
+    expect(() => validateNativeApp(withActions([{ ...first, textParameterTitle: ' ' }]))).toThrow(/textParameterTitle/)
+  })
+
   test('rejects missing platform ids and out-of-range platform values', () => {
     expect(() => validateNativeApp({ name: 'MyApp' } as any)).toThrow(/bundleId/)
     expect(() =>
@@ -193,6 +313,65 @@ describe('native.app manifest', () => {
     ).toThrow(/googleMapsApiKey/)
   })
 
+  test('accepts updates with a runtime version and an optional url', () => {
+    expect(() => validateNativeApp({ ...app, updates: undefined })).not.toThrow()
+    expect(() =>
+      validateNativeApp({
+        ...app,
+        updates: { url: 'https://updates.example.com', runtimeVersion: 'test-1' },
+      })
+    ).not.toThrow()
+    expect(() =>
+      validateNativeApp({ ...app, updates: { runtimeVersion: 'test-1' } })
+    ).not.toThrow()
+    expect(() => validateNativeApp({ ...app, updates: {} } as any)).toThrow(
+      /updates\.runtimeVersion/
+    )
+    expect(() =>
+      validateNativeApp({ ...app, updates: { runtimeVersion: '  ' } })
+    ).toThrow(/updates\.runtimeVersion/)
+    expect(() =>
+      validateNativeApp({ ...app, updates: { url: '', runtimeVersion: 'test-1' } })
+    ).toThrow(/updates\.url/)
+  })
+
+  // prebuild writes no UIUserInterfaceStyle for an unset style, so the built
+  // app follows the system; an expo client reads a missing style as light.
+  test('the dev manifest states the interface style the built app has', () => {
+    expect(expoClientFromNativeApp(app).userInterfaceStyle).toBe('automatic')
+    expect(
+      expoClientFromNativeApp({ ...app, userInterfaceStyle: 'dark' }).userInterfaceStyle
+    ).toBe('dark')
+  })
+
+  test('the dev manifest carries both native launch background images', () => {
+    const client = expoClientFromNativeApp({
+      ...app,
+      splash: {
+        source: './assets/mark.png',
+        backgroundImage: './assets/launch-light.png',
+        backgroundColor: '#ffffff',
+        dark: {
+          source: './assets/mark-dark.png',
+          backgroundImage: './assets/launch-dark.png',
+          backgroundColor: '#000000',
+        },
+      },
+    })
+    expect(client.splash).toEqual({
+      image: './assets/mark.png',
+      backgroundImage: './assets/launch-light.png',
+      backgroundColor: '#ffffff',
+      imageWidth: undefined,
+      resizeMode: undefined,
+      dark: {
+        image: './assets/mark-dark.png',
+        backgroundImage: './assets/launch-dark.png',
+        backgroundColor: '#000000',
+      },
+    })
+  })
+
   test('platform scope skips the other platform requirement', () => {
     expect(() =>
       validateNativeApp({ name: 'MyApp', android: app.android } as any, 'android')