snapback4-expo 0.4.9 → 0.4.11

package/README.md

@@ -59,8 +59,16 @@ runner, commands and artifact contract are in `snapback4 guide witness`
 “Proving it on an iOS simulator”. No Expo Go or Metro process supplies a
 Release witness.
 
-Own-build preparation (`witness ios --build … --smoke`) needs the updated native
-witness helper in this source revision. Its synchronous native observation hashes
+At every milestone, run `npm run export:ios` for Hermes; on a Mac with Xcode,
+`npm run native:smoke` (about 3 minutes warm). The Expo starters include both scripts.
+The smoke builds and installs your Release app, chooses its own simulator and free
+port, and keeps receipts in `artifacts/native-smoke/<timestamp>`. It proves local
+store acquisition, cold offline reopen and reconnect. Pending write replay, media
+and application assertions need the deeper scenario in `snapback4 guide witness`.
+An empty starter proves lifecycle only; export alone proves no native execution.
+
+Own-build preparation (`witness ios --build . --smoke`) uses the witness helper
+in matching current `snapback4` and `snapback4-expo` packages. Its synchronous native observation hashes
 the executable and the file selected by React Native SourceCode.scriptURL.
 Selection must resolve to the verified installed main.jsbundle; unknown, remote
 or alternate URLs fail, as do runtime __DEV__ true/unknown and launcher/updates
@@ -72,13 +80,13 @@ update selected at runtime. The JS smoke helper consumes compiler query facts
 from the driver, bound to the generation actually served. It checks every
 runs/held fact against the kept backend before querying. Stale facts fail;
 device-answerable loading fails, while server-only offline
-loading or E_OFFLINE is recorded as expected unavailability. Server-only reads
+E_OFFLINE is recorded as expected unavailability. Server-only reads
 must answer online in prime and restart. Conditional native-module queries
 require an application witness; generic smoke refuses that unsupported shape. Client semantics are unchanged.
 
-After JS/assets edits, repeat `witness ios --build . --smoke` with the same
-dedicated simulator and a fresh artifacts directory. Warm Xcode intermediates
+After JS/assets edits, repeat `npm run native:smoke`; simulator selection and
+fresh artifact directories are automatic. Warm Xcode intermediates
 are reused; each run builds the current app and seals a new receipt. Repack
-is withdrawn. Five complete warm build-plus-smoke runs on the shared M5 Pro mini
-measured 159.841 s median / 197.562 s nearest-rank p95, all passing; cold native preparation was about six minutes, with smoke and setup
-additional. See `guide witness` for pins, scope and exact invocation.
+is withdrawn. NS round 0 cohort (2026-09-30), fresh starter: **221.7 s cold**, **83.5 s warm median (3 runs)**; social **186.2 s**.
+Shared Apartment M5 Pro mini, 18 cores/64 GiB, Xcode/iOS 27; one-minute load: cold 3.61–61.41, warm 3.21–7.22, social 14.62–47.52.
+Tools/dependencies installed first. Guidance, not a promise. See `guide witness` for scope.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snapback4-expo",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "type": "module",
   "description": "Snapback 4's native module for Expo: the device in Rust (the partition in its own SQLite, the stream applied, the outbox kept, queries and predictions answered) behind one JSON call, and the opener `snapback4/native` takes.",
   "main": "src/index.ts",
@@ -8,9 +8,11 @@
   "exports": {
     ".": { "types": "./src/index.ts", "default": "./src/index.ts" },
     "./witness": { "types": "./src/witness.ts", "default": "./src/witness.ts" },
+    "./plugin": "./plugin.cjs",
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.cjs",
     "src",
     "ios",
     "expo-module.config.json",

package/plugin.cjs

@@ -0,0 +1,61 @@
+// @ref LLP 3000.030#13 — the pinned Expo starter must launch on iOS 27 without a manual migration.
+const { withAppDelegate, withInfoPlist } = require('expo/config-plugins');
+const marker = '// Snapback4 starter scene lifecycle';
+const legacy = `#if os(iOS) || os(tvOS)
+    window = UIWindow(frame: UIScreen.main.bounds)
+    factory.startReactNative(
+      withModuleName: "main",
+      in: window,
+      launchOptions: launchOptions)
+#endif`;
+const scene = `
+${marker}
+class SceneDelegate: UIResponder, UIWindowSceneDelegate {
+  var window: UIWindow?
+  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
+    guard let scene = scene as? UIWindowScene,
+      let app = UIApplication.shared.delegate as? AppDelegate,
+      let factory = app.reactNativeFactory else { return }
+    let window = UIWindow(windowScene: scene)
+    self.window = window
+    app.window = window
+    factory.startReactNative(withModuleName: "main", in: window, launchOptions: nil)
+    for context in connectionOptions.urlContexts {
+      _ = app.application(UIApplication.shared, open: context.url, options: [:])
+    }
+    for activity in connectionOptions.userActivities {
+      _ = app.application(UIApplication.shared, continue: activity, restorationHandler: { _ in })
+    }
+  }
+  func scene(_ scene: UIScene, openURLContexts contexts: Set<UIOpenURLContext>) {
+    guard let app = UIApplication.shared.delegate as? AppDelegate else { return }
+    for context in contexts { _ = app.application(UIApplication.shared, open: context.url, options: [:]) }
+  }
+  func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+    guard let app = UIApplication.shared.delegate as? AppDelegate else { return }
+    _ = app.application(UIApplication.shared, continue: userActivity, restorationHandler: { _ in })
+  }
+}
+`;
+module.exports = function withStarterScene(config) {
+  config = withAppDelegate(config, config => {
+    const mod = config.modResults;
+    if (mod.contents.includes(marker)) return config;
+    if (mod.language !== 'swift' || !mod.contents.includes(legacy) || mod.contents.includes('class SceneDelegate')) {
+      throw new Error('snapback4-expo/plugin requires the Expo 57 Swift starter; migrate custom UIScene lifecycle manually and remove this plugin');
+    }
+    mod.contents = mod.contents.replace(legacy, '') + scene;
+    return config;
+  });
+  return withInfoPlist(config, config => {
+    const manifest = { UIApplicationSupportsMultipleScenes: false, UISceneConfigurations: {
+      UIWindowSceneSessionRoleApplication: [{ UISceneConfigurationName: 'Default Configuration', UISceneDelegateClassName: '$(PRODUCT_MODULE_NAME).SceneDelegate' }],
+    } };
+    const existing = config.modResults.UIApplicationSceneManifest;
+    if (existing && JSON.stringify(existing) !== JSON.stringify(manifest)) {
+      throw new Error('snapback4-expo/plugin refuses a custom UIApplicationSceneManifest; keep its own lifecycle and remove this plugin');
+    }
+    config.modResults.UIApplicationSceneManifest = manifest;
+    return config;
+  });
+};

package/src/witness.ts

@@ -13,3 +13,11 @@ export function witness(): Witness | null {
   }
   return instance;
 }
+
+/** The starter may use normal guest sign-in during prime; never on ordinary launches. */
+export function smokeSegment(): "prime" | "offline" | "restart" | null {
+  const container = requireOptionalNativeModule<WitnessContainer>("Snapback4");
+  if (!container?.witnessLaunch) return null;
+  const config = JSON.parse(container.witnessLaunch);
+  return config.smoke === true && ["prime", "offline", "restart"].includes(config.segment) ? config.segment : null;
+}