rnxsim 0.1.393 → 0.1.395

package/src/metro-production-bundle.ts

@@ -1,4 +1,3 @@
-export const RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION = 'rnxsim'
 const RNXSIM_METRO_MODULE_PATHS_PREFIX = 'globalThis.__sootsimModulePaths='
 
 export type RNXMetroModulePathMap = Record<string, string>
@@ -7,14 +6,16 @@ export interface RNXMetroModuleIdentity {
   modulePaths: RNXMetroModulePathMap
 }
 
+// the production bundle rnx loads is the app's ORDINARY production bundle.
+// nothing about resolution changes, so these are plain Metro production
+// options and the artifact is byte-identical to what the app ships apart
+// from the identity footer the plugin's serializer appends.
 export function toRNXProductionBundleUrl(bundleUrl: string): string {
   const relative = bundleUrl.startsWith('/')
   const url = new URL(bundleUrl, 'http://rnxsim.local')
   url.searchParams.set('dev', 'false')
   url.searchParams.set('hot', 'false')
   url.searchParams.set('minify', 'true')
-  url.searchParams.set(`resolver.${RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION}`, 'true')
-  url.searchParams.set(`transform.${RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION}`, 'true')
   return relative ? `${url.pathname}${url.search}${url.hash}` : url.toString()
 }
 
@@ -49,3 +50,203 @@ export function readRNXMetroModuleIdentity(
   }
   return { source: bundleText.slice(0, footerStart), modulePaths }
 }
+
+// the exact layout Metro's baseJSBundle emits and the rnx runtime contract
+// depends on: a prelude, then one `__d(` or `__r(` statement per line, each
+// running until the next statement starts its own line. one reader owns this
+// recognition so the loader's identity validation, the source-map attribution
+// pass, and the cloud artifact producer cannot drift apart.
+export interface RNXMetroDefine {
+  kind: 'define'
+  moduleId: number
+  start: number
+  end: number
+  lineIndex: number
+  endLineIndex: number
+  /** the factory expression, between `__d(` and the module ID. */
+  factory: { start: number; end: number }
+  /** the dependency array, brackets included. */
+  dependencies: { start: number; end: number }
+}
+
+export interface RNXMetroRun {
+  kind: 'run'
+  start: number
+  end: number
+  lineIndex: number
+  endLineIndex: number
+}
+
+export type RNXMetroStatement = RNXMetroDefine | RNXMetroRun
+
+export interface RNXMetroBundleLayout {
+  /** everything before the first `__d(`/`__r(` line: prelude vars and polyfills. */
+  prelude: string
+  statements: RNXMetroStatement[]
+  /** `__d(` statements whose module ID could not be read. */
+  moduleIdFailures: number
+}
+
+interface DefineTail {
+  moduleId: number
+  factoryEnd: number
+  dependenciesStart: number
+  dependenciesEnd: number
+}
+
+// each `__d(...)` ends with `),<id>,[dep,dep,...]);?`. the dependency array can
+// be hundreds of entries long, so walk back from `end` instead of searching a
+// fixed tail window: skip trailing `;` and whitespace, consume the closing `)`,
+// balance `[...]` to find its opening bracket, then read the integer before it.
+function readDefineTail(source: string, start: number, end: number): DefineTail | null {
+  let cursor = end
+  while (
+    cursor > start &&
+    (source[cursor] === ' ' ||
+      source[cursor] === '\n' ||
+      source[cursor] === '\t' ||
+      source[cursor] === ';')
+  ) {
+    cursor--
+  }
+  if (source[cursor] !== ')') return null
+  cursor--
+  while (cursor > start && /\s/.test(source[cursor])) cursor--
+  if (source[cursor] !== ']') return null
+  const dependenciesEnd = cursor + 1
+  let depth = 1
+  cursor--
+  while (cursor > start && depth > 0) {
+    const character = source[cursor]
+    if (character === ']') depth++
+    else if (character === '[') depth--
+    if (depth === 0) break
+    cursor--
+  }
+  if (depth !== 0) return null
+  const dependenciesStart = cursor
+  let idEnd = cursor - 1
+  while (idEnd > start && /\s/.test(source[idEnd])) idEnd--
+  if (source[idEnd] !== ',') return null
+  // a minifier is free to write the module ID as `1e3` or `0x3e8`, so read the
+  // whole numeric literal rather than a run of decimal digits. the factory
+  // before it always ends in `}` or `)`, which stops this walk immediately.
+  let idStart = idEnd
+  while (idStart > start && /[0-9a-fA-FxX.+\-]/.test(source[idStart - 1])) idStart--
+  const literal = source.slice(idStart, idEnd)
+  if (!/^-?(?:0[xXbBoO][0-9a-fA-F]+|\d+(?:\.\d*)?(?:[eE][+-]?\d+)?)$/.test(literal)) {
+    return null
+  }
+  const moduleId = Number(literal)
+  if (!Number.isSafeInteger(moduleId)) return null
+  let factoryEnd = idStart - 1
+  while (factoryEnd > start && /\s/.test(source[factoryEnd])) factoryEnd--
+  if (source[factoryEnd] !== ',') return null
+  return {
+    moduleId,
+    factoryEnd,
+    dependenciesStart,
+    dependenciesEnd,
+  }
+}
+
+/** reads the canonical Metro production layout from footer-stripped source. */
+export function readRNXMetroBundleLayout(source: string): RNXMetroBundleLayout {
+  const lineOffsets = [0]
+  for (let index = 0; index < source.length; index++) {
+    if (source.charCodeAt(index) === 10) lineOffsets.push(index + 1)
+  }
+
+  const boundaries: number[] = []
+  for (let lineIndex = 0; lineIndex < lineOffsets.length; lineIndex++) {
+    const start = lineOffsets[lineIndex]
+    if (source.startsWith('__d(', start) || source.startsWith('__r(', start)) {
+      boundaries.push(lineIndex)
+    }
+  }
+
+  const statements: RNXMetroStatement[] = []
+  let moduleIdFailures = 0
+  for (let index = 0; index < boundaries.length; index++) {
+    const lineIndex = boundaries[index]
+    const start = lineOffsets[lineIndex]
+    const nextLineIndex = boundaries[index + 1]
+    const endLineIndex =
+      nextLineIndex !== undefined ? nextLineIndex - 1 : lineOffsets.length - 1
+    const end = nextLineIndex !== undefined ? lineOffsets[nextLineIndex] : source.length
+    if (!source.startsWith('__d(', start)) {
+      statements.push({ kind: 'run', start, end, lineIndex, endLineIndex })
+      continue
+    }
+    const tail = readDefineTail(source, start, end - 1)
+    if (!tail) {
+      moduleIdFailures++
+      continue
+    }
+    statements.push({
+      kind: 'define',
+      moduleId: tail.moduleId,
+      start,
+      end,
+      lineIndex,
+      endLineIndex,
+      factory: { start: start + '__d('.length, end: tail.factoryEnd },
+      dependencies: { start: tail.dependenciesStart, end: tail.dependenciesEnd },
+    })
+  }
+
+  return {
+    prelude: source.slice(
+      0,
+      boundaries.length > 0 ? lineOffsets[boundaries[0]] : source.length,
+    ),
+    statements,
+    moduleIdFailures,
+  }
+}
+
+/**
+ * validates the exact identity contract before a loader installs a Metro
+ * factory trap or a producer ships an artifact: every define carries a unique,
+ * readable module ID, and the identity map names those IDs and no others.
+ * serializers that emit another layout need an ingestion adapter that
+ * normalizes them to this format.
+ */
+export function validateRNXMetroModulePaths(
+  source: string,
+  modulePaths: RNXMetroModulePathMap,
+): void {
+  const layout = readRNXMetroBundleLayout(source)
+  if (layout.moduleIdFailures > 0) {
+    throw new Error(
+      `Metro module identity could not read ${layout.moduleIdFailures} module IDs`,
+    )
+  }
+  const definedIds = new Set<number>()
+  for (const statement of layout.statements) {
+    if (statement.kind !== 'define') continue
+    if (definedIds.has(statement.moduleId)) {
+      throw new Error(`Metro module identity has duplicate module ${statement.moduleId}`)
+    }
+    definedIds.add(statement.moduleId)
+    if (!Object.prototype.hasOwnProperty.call(modulePaths, String(statement.moduleId))) {
+      throw new Error(`Metro module identity is missing ${statement.moduleId}`)
+    }
+  }
+  if (definedIds.size === 0) {
+    throw new Error('Metro module identity found no canonical JavaScript modules')
+  }
+
+  for (const [key, modulePath] of Object.entries(modulePaths)) {
+    const moduleId = Number(key)
+    if (!Number.isSafeInteger(moduleId) || String(moduleId) !== key) {
+      throw new Error(`Metro module identity has invalid module ID ${key}`)
+    }
+    if (typeof modulePath !== 'string' || modulePath.length === 0) {
+      throw new Error(`Metro module identity has no path for ${key}`)
+    }
+    if (!definedIds.has(moduleId)) {
+      throw new Error(`Metro module identity has no module ${key}`)
+    }
+  }
+}

package/dist-lib/metro-host-modules/react-dom.js

@@ -1,6 +0,0 @@
-const name = 'react-dom'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/dist-lib/metro-host-modules/react-native-web.js

@@ -1,6 +0,0 @@
-const name = 'react-native-web'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/dist-lib/metro-host-modules/react-native.js

@@ -1,6 +0,0 @@
-const name = 'react-native'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/dist-lib/metro-host-modules/react.js

@@ -1,6 +0,0 @@
-const name = 'react'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/dist-lib/metro-host-modules/react__jsx-dev-runtime.js

@@ -1,6 +0,0 @@
-const name = 'react/jsx-dev-runtime'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/dist-lib/metro-host-modules/react__jsx-runtime.js

@@ -1,6 +0,0 @@
-const name = 'react/jsx-runtime'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react-dom.js

@@ -1,6 +0,0 @@
-const name = 'react-dom'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react-native-web.js

@@ -1,6 +0,0 @@
-const name = 'react-native-web'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react-native.js

@@ -1,6 +0,0 @@
-const name = 'react-native'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react.js

@@ -1,6 +0,0 @@
-const name = 'react'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react__jsx-dev-runtime.js

@@ -1,6 +0,0 @@
-const name = 'react/jsx-dev-runtime'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]

package/src/metro-host-modules/react__jsx-runtime.js

@@ -1,6 +0,0 @@
-const name = 'react/jsx-runtime'
-const host = globalThis.__contrastHostModules
-if (!host || !(name in host)) {
-  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
-}
-module.exports = host[name]