peachsim 0.1.939 → 0.1.1399

package/src/native-app-identity.ts

@@ -3,15 +3,29 @@
 // against the Xcode Release build settings, or `android/app/build.gradle`), so
 // a simulator tenant reports the same identity the native Release build does.
 //
-// the values travel in a bundle footer or a response header bound to unchanged
-// artifact bytes. tenant boot validates both before evaluation and clears the
-// realm store when neither carries identity.
+// identity travels in a bundle footer or response header. the one updates
+// receipt travels only in the response header so publisher JavaScript stays
+// unchanged. tenant boot validates both before evaluation and clears the realm
+// store when neither carries identity.
+
+import { parseOpenStepPlist } from './openstep-plist'
 
 export type NativeAppIdentityPlatform = 'ios' | 'android'
 
+export interface NativeOneUpdatesReceipt {
+  enabled: boolean
+  url: string | null
+  runtimeVersion: string | null
+  embeddedManifestJson: string | null
+}
+
 export interface NativeAppIdentity {
   // the user-facing name (CFBundleDisplayName, else CFBundleName).
   applicationName: string | null
+  // the literal CFBundleDisplayName, without a bundle-name fallback.
+  applicationDisplayName?: string
+  // the processed ARGB integer from RCTRootViewBackgroundColor.
+  rootViewBackgroundColor?: number
   // CFBundleName, which CFNetwork stamps into the default User-Agent and iOS's
   // own prompts use (the ASWebAuthenticationSession consent alert); distinct
   // from the display name. absent in footers built before it was carried.
@@ -23,6 +37,16 @@ export interface NativeAppIdentity {
   permissionUsageDescriptions?: Readonly<Record<string, unknown>>
   urlQuerySchemes?: readonly unknown[]
   appIntentIdentifiers?: readonly string[]
+  backgroundTaskIdentifiers?: readonly string[]
+  backgroundModes?: readonly string[]
+  supportedInterfaceOrientations?: readonly string[]
+  ipadSupportedInterfaceOrientations?: readonly string[]
+  defaultScreenOrientationMask?: string
+  shareIntoAppGroupId?: string
+  alternateIconNames?: readonly string[]
+  // one updates configuration travels only in response metadata, never in guest
+  // code or inferred from JavaScript build flags.
+  oneUpdates?: NativeOneUpdatesReceipt
 }
 
 export type NativeAppIdentityFiles = Record<string, string>
@@ -46,6 +70,24 @@ function nonEmptyString(value: unknown): string | null {
 
 export function isNativeAppIdentity(value: unknown): value is NativeAppIdentity {
   if (!isRecord(value)) return false
+  const oneUpdates = value.oneUpdates
+  if (
+    oneUpdates !== undefined &&
+    (!isRecord(oneUpdates) ||
+      typeof oneUpdates.enabled !== 'boolean' ||
+      (oneUpdates.url !== null && typeof oneUpdates.url !== 'string') ||
+      (oneUpdates.runtimeVersion !== null &&
+        typeof oneUpdates.runtimeVersion !== 'string') ||
+      (oneUpdates.embeddedManifestJson !== null &&
+        typeof oneUpdates.embeddedManifestJson !== 'string') ||
+      (oneUpdates.enabled &&
+        (typeof oneUpdates.url !== 'string' ||
+          oneUpdates.url.length === 0 ||
+          typeof oneUpdates.runtimeVersion !== 'string' ||
+          oneUpdates.runtimeVersion.length === 0)))
+  ) {
+    return false
+  }
   const descriptions = value.permissionUsageDescriptions
   if (descriptions !== undefined && !isRecord(descriptions)) return false
   if (value.urlQuerySchemes !== undefined && !Array.isArray(value.urlQuerySchemes))
@@ -56,7 +98,59 @@ export function isNativeAppIdentity(value: unknown): value is NativeAppIdentity
       !value.appIntentIdentifiers.every((identifier) => typeof identifier === 'string'))
   )
     return false
+  if (
+    value.backgroundTaskIdentifiers !== undefined &&
+    (!Array.isArray(value.backgroundTaskIdentifiers) ||
+      !value.backgroundTaskIdentifiers.every(
+        (identifier) => typeof identifier === 'string',
+      ))
+  )
+    return false
+  if (
+    value.backgroundModes !== undefined &&
+    (!Array.isArray(value.backgroundModes) ||
+      !value.backgroundModes.every((mode) => typeof mode === 'string'))
+  )
+    return false
+  if (
+    value.shareIntoAppGroupId !== undefined &&
+    typeof value.shareIntoAppGroupId !== 'string'
+  )
+    return false
+  if (
+    value.applicationDisplayName !== undefined &&
+    typeof value.applicationDisplayName !== 'string'
+  )
+    return false
+  if (
+    value.rootViewBackgroundColor !== undefined &&
+    (typeof value.rootViewBackgroundColor !== 'number' ||
+      !Number.isInteger(value.rootViewBackgroundColor))
+  )
+    return false
+  for (const orientations of [
+    value.supportedInterfaceOrientations,
+    value.ipadSupportedInterfaceOrientations,
+  ]) {
+    if (
+      orientations !== undefined &&
+      (!Array.isArray(orientations) ||
+        !orientations.every((orientation) => typeof orientation === 'string'))
+    )
+      return false
+  }
+  if (
+    value.defaultScreenOrientationMask !== undefined &&
+    typeof value.defaultScreenOrientationMask !== 'string'
+  )
+    return false
   const platform = value.platform
+  if (
+    value.alternateIconNames !== undefined &&
+    (!Array.isArray(value.alternateIconNames) ||
+      !value.alternateIconNames.every((name) => typeof name === 'string'))
+  )
+    return false
   if (platform !== 'ios' && platform !== 'android') return false
   const applicationName = value.applicationName
   if (applicationName !== null && nonEmptyString(applicationName) === null) return false
@@ -79,11 +173,20 @@ export function readNativeAppIdentity(value: unknown): NativeAppIdentity | null
   }
   return {
     applicationName: value.applicationName,
+    ...(value.applicationDisplayName === undefined
+      ? {}
+      : { applicationDisplayName: value.applicationDisplayName }),
+    ...(value.rootViewBackgroundColor === undefined
+      ? {}
+      : { rootViewBackgroundColor: value.rootViewBackgroundColor }),
     ...(value.bundleName === undefined ? {} : { bundleName: value.bundleName }),
     appVersion: value.appVersion,
     buildVersion: value.buildVersion,
     bundleIdentifier: value.bundleIdentifier,
     platform: value.platform,
+    ...(value.alternateIconNames === undefined
+      ? {}
+      : { alternateIconNames: [...value.alternateIconNames] }),
     ...(value.permissionUsageDescriptions === undefined
       ? {}
       : {
@@ -92,9 +195,43 @@ export function readNativeAppIdentity(value: unknown): NativeAppIdentity | null
     ...(value.appIntentIdentifiers === undefined
       ? {}
       : { appIntentIdentifiers: [...value.appIntentIdentifiers] }),
+    ...(value.backgroundTaskIdentifiers === undefined
+      ? {}
+      : { backgroundTaskIdentifiers: [...value.backgroundTaskIdentifiers] }),
+    ...(value.supportedInterfaceOrientations === undefined
+      ? {}
+      : {
+          supportedInterfaceOrientations: [...value.supportedInterfaceOrientations],
+        }),
+    ...(value.ipadSupportedInterfaceOrientations === undefined
+      ? {}
+      : {
+          ipadSupportedInterfaceOrientations: [
+            ...value.ipadSupportedInterfaceOrientations,
+          ],
+        }),
+    ...(value.defaultScreenOrientationMask === undefined
+      ? {}
+      : { defaultScreenOrientationMask: value.defaultScreenOrientationMask }),
+    ...(value.backgroundModes === undefined
+      ? {}
+      : { backgroundModes: [...value.backgroundModes] }),
+    ...(value.shareIntoAppGroupId === undefined
+      ? {}
+      : { shareIntoAppGroupId: value.shareIntoAppGroupId }),
     ...(value.urlQuerySchemes === undefined
       ? {}
       : { urlQuerySchemes: [...value.urlQuerySchemes] }),
+    ...(value.oneUpdates === undefined
+      ? {}
+      : {
+          oneUpdates: {
+            enabled: value.oneUpdates.enabled,
+            url: value.oneUpdates.url,
+            runtimeVersion: value.oneUpdates.runtimeVersion,
+            embeddedManifestJson: value.oneUpdates.embeddedManifestJson,
+          },
+        }),
   }
 }
 
@@ -135,7 +272,10 @@ export function readNativeAppIdentityFromBundle(
   }
   const identity = readNativeAppIdentity(value)
   if (!identity) throw new Error('native app identity response header is malformed')
-  if (footer && !equalIdentityValues(identity, readNativeAppIdentity(footer))) {
+  const footerIdentity = footer ? readNativeAppIdentity(footer) : null
+  const headerBase = { ...identity, oneUpdates: undefined }
+  const footerBase = footerIdentity && { ...footerIdentity, oneUpdates: undefined }
+  if (footerIdentity && !equalIdentityValues(headerBase, footerBase)) {
     throw new Error('native app identity response header conflicts with bundle footer')
   }
   return identity
@@ -158,7 +298,10 @@ export function getAppliedNativeAppIdentity(): NativeAppIdentity | null {
 // one line, so the footer survives a bundle whose last statement is the Metro
 // module identity footer and can be found again by reading the text.
 export function createNativeAppIdentityFooter(identity: NativeAppIdentity): string {
-  const payload = JSON.stringify(identity)
+  const footerIdentity = { ...identity }
+  // native update configuration belongs to response metadata, never guest code.
+  delete footerIdentity.oneUpdates
+  const payload = JSON.stringify(footerIdentity)
     .replace(/\u2028/g, '\\u2028')
     .replace(/\u2029/g, '\\u2029')
     .replace(/<\//g, '<\\/')
@@ -186,6 +329,9 @@ export function readNativeAppIdentityFooter(source: string): NativeAppIdentity |
   if (!isNativeAppIdentity(parsed)) {
     throw new Error('native app identity footer is malformed')
   }
+  if (parsed.oneUpdates !== undefined) {
+    throw new Error('native app identity footer cannot contain one updates receipt')
+  }
   return parsed
 }
 
@@ -362,39 +508,162 @@ function appTargetReleaseSettings(
 function nativeAppIdentityFromIos(
   files: NativeAppIdentityFiles,
   parseInfoPlist: (source: string) => unknown,
+  iosTarget?: string,
 ): NativeAppIdentity | null {
-  const pbxprojPath = Object.keys(files).find((path) =>
-    /(?:^|\/)ios\/[^/]+\.xcodeproj\/project\.pbxproj$/.test(path),
-  )
+  const pbxprojPath =
+    Object.keys(files).find((path) =>
+      /(?:^|\/)ios\/[^/]+\.xcodeproj\/project\.pbxproj$/.test(path),
+    ) ??
+    Object.keys(files).find((path) =>
+      /(?:^|\/)[^/]+\.xcodeproj\/project\.pbxproj$/.test(path),
+    ) ??
+    Object.keys(files).find((path) => /(?:^|\/)project\.pbxproj$/.test(path))
   if (!pbxprojPath) return null
   const pbxproj = files[pbxprojPath]
-  // the installed app is the target Xcode builds as an application. an App
-  // Clip or extension carries its own AppDelegate and Info.plist, so a target
-  // directory alone cannot say which binary is the app.
-  const applicationTargets = new Set(
-    [
-      ...pbxproj.matchAll(
-        /isa = PBXNativeTarget;[^}]*?name = "?([^";]+)"?;[^}]*?productType = "com\.apple\.product-type\.application";/g,
-      ),
-    ].map((match) => match[1]),
+
+  let objects: Record<string, unknown> = {}
+  try {
+    const parsed = parseOpenStepPlist(pbxproj)
+    if (isRecord(parsed)) {
+      objects = isRecord(parsed.objects) ? parsed.objects : parsed
+    }
+  } catch {
+    // fallback if unparseable
+  }
+
+  interface NativeTargetSummary {
+    id: string
+    name: string
+    productType?: string
+    buildConfigurationList?: string
+  }
+  const targets: NativeTargetSummary[] = []
+  for (const [id, obj] of Object.entries(objects)) {
+    if (isRecord(obj) && obj.isa === 'PBXNativeTarget' && typeof obj.name === 'string') {
+      targets.push({
+        id,
+        name: obj.name,
+        productType: typeof obj.productType === 'string' ? obj.productType : undefined,
+        buildConfigurationList:
+          typeof obj.buildConfigurationList === 'string'
+            ? obj.buildConfigurationList
+            : undefined,
+      })
+    }
+  }
+  const applicationTargetNames = new Set(
+    targets
+      .filter((t) => t.productType === 'com.apple.product-type.application')
+      .map((t) => t.name),
   )
-  const appDelegatePattern = /(?:^|\/)ios\/([^/]+)\/AppDelegate\.(?:swift|mm|m)$/
-  const targetName =
-    Object.keys(files)
+  if (applicationTargetNames.size === 0) {
+    for (const match of pbxproj.matchAll(
+      /isa = PBXNativeTarget;[^}]*?name = "?([^";]+)"?;[^}]*?productType = "com\.apple\.product-type\.application";/g,
+    )) {
+      applicationTargetNames.add(match[1])
+    }
+  }
+
+  let targetName: string | null = null
+  if (iosTarget) {
+    if (applicationTargetNames.has(iosTarget)) {
+      targetName = iosTarget
+    } else {
+      return null
+    }
+  } else if (applicationTargetNames.size === 1) {
+    targetName = [...applicationTargetNames][0]!
+  } else if (applicationTargetNames.size > 1) {
+    const appDelegatePattern = /(?:^|\/)ios\/([^/]+)\/AppDelegate\.(?:swift|mm|m)$/
+    const delegateTargets = Object.keys(files)
       .filter((path) => !path.includes('/Pods/'))
       .map((path) => path.match(appDelegatePattern)?.[1])
-      .find((name) => name !== undefined && applicationTargets.has(name)) ?? null
-  if (!targetName) return null
+      .filter(
+        (name): name is string =>
+          typeof name === 'string' && applicationTargetNames.has(name),
+      )
+    if (delegateTargets.length === 1) {
+      targetName = delegateTargets[0]!
+    } else {
+      return null
+    }
+  } else {
+    return null
+  }
 
-  const plist = files[`ios/${targetName}/Info.plist`]
-  if (!plist) return null
+  const selectedTarget = targets.find((t) => t.name === targetName)
+  const settings: Record<string, string> = {
+    TARGET_NAME: targetName,
+    PRODUCT_NAME: targetName,
+  }
+  for (const obj of Object.values(objects)) {
+    if (
+      isRecord(obj) &&
+      obj.isa === 'PBXProject' &&
+      typeof obj.buildConfigurationList === 'string'
+    ) {
+      const listObj = objects[obj.buildConfigurationList]
+      if (isRecord(listObj) && Array.isArray(listObj.buildConfigurations)) {
+        for (const configId of listObj.buildConfigurations) {
+          if (typeof configId === 'string') {
+            const configObj = objects[configId]
+            if (
+              isRecord(configObj) &&
+              configObj.name === 'Release' &&
+              isRecord(configObj.buildSettings)
+            ) {
+              for (const [k, v] of Object.entries(configObj.buildSettings)) {
+                if (typeof v === 'string') settings[k] = v
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  if (selectedTarget?.buildConfigurationList) {
+    const listObj = objects[selectedTarget.buildConfigurationList]
+    if (isRecord(listObj) && Array.isArray(listObj.buildConfigurations)) {
+      for (const configId of listObj.buildConfigurations) {
+        if (typeof configId === 'string') {
+          const configObj = objects[configId]
+          if (
+            isRecord(configObj) &&
+            configObj.name === 'Release' &&
+            isRecord(configObj.buildSettings)
+          ) {
+            for (const [k, v] of Object.entries(configObj.buildSettings)) {
+              if (typeof v === 'string') settings[k] = v
+            }
+          }
+        }
+      }
+    }
+  } else {
+    const legacy = appTargetReleaseSettings(
+      pbxproj,
+      targetName,
+      `${targetName}/Info.plist`,
+    )
+    if (legacy) Object.assign(settings, legacy)
+  }
 
-  const settings = appTargetReleaseSettings(
-    pbxproj,
-    targetName,
-    `${targetName}/Info.plist`,
-  )
-  if (!settings) return null
+  let plist: string | undefined
+  const infoPlistPath = settings.INFOPLIST_FILE
+  if (infoPlistPath) {
+    const normalized = infoPlistPath.replace(/^"|"$/g, '')
+    plist =
+      files[`ios/${normalized}`] ??
+      files[normalized] ??
+      Object.entries(files).find(([k]) => k.endsWith(`/${normalized}`))?.[1]
+  }
+  if (!plist) {
+    plist =
+      files[`ios/${targetName}/Info.plist`] ??
+      files[`${targetName}/Info.plist`] ??
+      Object.entries(files).find(([k]) => k.endsWith(`/${targetName}/Info.plist`))?.[1]
+  }
+  if (!plist) return null
 
   const bundleIdentifier = identityFieldFrom(
     settings,
@@ -434,12 +703,87 @@ function nativeAppIdentityFromIos(
   // with the build-side parser; the browser transport has no XML dependency.
   const dictionary = parseInfoPlist(plist)
   if (!isRecord(dictionary)) throw new Error('native app Info.plist is not a dictionary')
+  const declaredDisplayName = dictionary.CFBundleDisplayName
+  const applicationDisplayName =
+    typeof declaredDisplayName === 'string'
+      ? resolveBuildSetting(declaredDisplayName, settings)
+      : undefined
+  if (applicationDisplayName === null)
+    throw new Error('native app Info.plist CFBundleDisplayName is unresolved')
+  const declaredBackgroundColor = dictionary.RCTRootViewBackgroundColor
+  const rootViewBackgroundColor =
+    typeof declaredBackgroundColor === 'number' &&
+    Number.isInteger(declaredBackgroundColor)
+      ? declaredBackgroundColor
+      : undefined
+  const icons = dictionary.CFBundleIcons
+  const alternates = isRecord(icons) ? icons.CFBundleAlternateIcons : undefined
+  const alternateIconNames = new Set<string>()
+  for (const name of isRecord(alternates) ? Object.keys(alternates) : []) {
+    const resolved = resolveBuildSetting(name, settings)
+    if (resolved === null) throw new Error('native alternate icon name is unresolved')
+    alternateIconNames.add(resolved)
+  }
+  // xcode writes the declared asset catalog names into the compiled plist.
+  const alternateSetting = resolveBuildSetting(
+    settings.ASSETCATALOG_COMPILER_ALTERNATE_APPICON_NAMES ?? '',
+    settings,
+  )
+  if (alternateSetting === null)
+    throw new Error('native alternate icon setting is unresolved')
+  for (const match of alternateSetting
+    .replace(/\\"/g, '"')
+    .matchAll(/"([^"]*)"|([^\s(),]+)/g)) {
+    alternateIconNames.add(match[1] ?? match[2])
+  }
   // swift casts the whole configured value to [String]; a mixed array grants none.
   const intentIds = dictionary.OneAppIntentIdentifiers
   const appIntentIdentifiers =
     Array.isArray(intentIds) && intentIds.every((value) => typeof value === 'string')
       ? intentIds.map((value: string) => resolveBuildSetting(value, settings))
       : []
+  const backgroundIds = dictionary.BGTaskSchedulerPermittedIdentifiers
+  const backgroundTaskIdentifiers =
+    Array.isArray(backgroundIds) &&
+    backgroundIds.every((value) => typeof value === 'string')
+      ? backgroundIds.map((value: string) => resolveBuildSetting(value, settings))
+      : []
+  const declaredModes = dictionary.UIBackgroundModes
+  const backgroundModes =
+    Array.isArray(declaredModes) &&
+    declaredModes.every((value) => typeof value === 'string')
+      ? declaredModes.map((value: string) => resolveBuildSetting(value, settings))
+      : []
+  // the root orientation controller casts each plist list as a whole [String].
+  const screenOrientationLists = [
+    'UISupportedInterfaceOrientations',
+    'UISupportedInterfaceOrientations~ipad',
+  ].map((key) => {
+    const list = dictionary[key]
+    if (!Array.isArray(list) || !list.every((value) => typeof value === 'string'))
+      return []
+    return list.map((value: string) => {
+      const resolved = resolveBuildSetting(value, settings)
+      if (resolved === null) throw new Error(`native app Info.plist ${key} is unresolved`)
+      return resolved
+    })
+  })
+  const [supportedInterfaceOrientations, ipadSupportedInterfaceOrientations] =
+    screenOrientationLists
+  const declaredDefaultOrientationMask = dictionary.EXDefaultScreenOrientationMask
+  const defaultScreenOrientationMask =
+    typeof declaredDefaultOrientationMask === 'string'
+      ? resolveBuildSetting(declaredDefaultOrientationMask, settings)
+      : undefined
+  if (defaultScreenOrientationMask === null)
+    throw new Error('native app Info.plist EXDefaultScreenOrientationMask is unresolved')
+  const declaredShareGroup = dictionary.ExpoShareIntoAppGroupId
+  const shareIntoAppGroupId =
+    typeof declaredShareGroup === 'string'
+      ? resolveBuildSetting(declaredShareGroup, settings)
+      : undefined
+  if (shareIntoAppGroupId === null)
+    throw new Error('native app Info.plist ExpoShareIntoAppGroupId is unresolved')
   const querySchemes = dictionary.LSApplicationQueriesSchemes
   if (querySchemes !== undefined && !Array.isArray(querySchemes)) {
     throw new Error('native app Info.plist LSApplicationQueriesSchemes is not an array')
@@ -453,7 +797,11 @@ function nativeAppIdentityFromIos(
   })
   const permissionUsageDescriptions: Record<string, unknown> = {}
   for (const [key, value] of Object.entries(dictionary)) {
-    if (!/^NS.*UsageDescription$/.test(key)) continue
+    if (
+      !/^NS.*UsageDescription$/.test(key) &&
+      key !== 'NSLocationTemporaryUsageDescriptionDictionary'
+    )
+      continue
     // retain non-string plist values: the native factory checks key presence.
     if (typeof value !== 'string') {
       permissionUsageDescriptions[key] = value
@@ -479,13 +827,28 @@ function nativeAppIdentityFromIos(
 
   return {
     applicationName,
+    ...(applicationDisplayName === undefined ? {} : { applicationDisplayName }),
+    ...(rootViewBackgroundColor === undefined ? {} : { rootViewBackgroundColor }),
     bundleName,
     appVersion,
     buildVersion,
     bundleIdentifier,
     platform: 'ios',
+    supportedInterfaceOrientations,
+    ipadSupportedInterfaceOrientations,
+    ...(defaultScreenOrientationMask === undefined
+      ? {}
+      : { defaultScreenOrientationMask }),
+    alternateIconNames: [...alternateIconNames],
     permissionUsageDescriptions,
     urlQuerySchemes,
+    ...(shareIntoAppGroupId === undefined ? {} : { shareIntoAppGroupId }),
+    backgroundTaskIdentifiers: backgroundTaskIdentifiers.every((value) => value !== null)
+      ? backgroundTaskIdentifiers
+      : [],
+    backgroundModes: backgroundModes.every((value) => value !== null)
+      ? backgroundModes
+      : [],
     appIntentIdentifiers: appIntentIdentifiers.every((value) => value !== null)
       ? appIntentIdentifiers
       : [],
@@ -504,13 +867,14 @@ export function canExtractNativeAppIdentity(platform: unknown): platform is 'ios
 // read the identity a bundle builder transports. files are project-relative
 // paths to their text, so both a checked-out app directory and a stored
 // project file map resolve identically. null when the project carries no
-// resolvable native config — the builder then ships no footer.
+// resolvable native config.
 export function extractNativeAppIdentityFromFiles(
   files: NativeAppIdentityFiles,
-  platform: NativeAppIdentityPlatform,
+  platform: unknown,
   parseInfoPlist: (source: string) => unknown,
+  iosTarget?: string,
 ): NativeAppIdentity | null {
   return canExtractNativeAppIdentity(platform)
-    ? nativeAppIdentityFromIos(files, parseInfoPlist)
+    ? nativeAppIdentityFromIos(files, parseInfoPlist, iosTarget)
     : null
 }