@scalebun/react-native 1.6.1 → 1.6.3

package/README.md

@@ -18,13 +18,20 @@ yarn add @scalebun/react-native
 cd ios && pod install
 ```
 
-To wire the AppDelegate for Direct APNs push (optional):
+Wire the AppDelegate for **OTA bundle loading** (required for OTA on iOS) and
+Direct APNs push:
 
 ```sh
 npx scalebun init ios            # patch the AppDelegate (ObjC auto-patched; Swift prints steps)
-npx scalebun init ios --check    # verify hooks exist (exit 1 if missing)
+npx scalebun init ios --check    # verify hooks + OTA bundleURL exist (exit 1 if missing)
 ```
 
+Like Android, iOS OTA needs the app's bundle resolution wired to the OTA slot
+(`bundleURL` → `ScaleBunOtaModule.getBundleURL()`), or updates install but never
+load. `init ios` auto-applies this to a standard ObjC AppDelegate and prints the
+exact snippet for Swift / custom `bundleURL` bodies. **Rebuild the native app
+afterwards.**
+
 ### Android
 
 OTA updates need one wiring step in `MainApplication` so a downloaded bundle

package/bin/lib/iosCodemod.js

@@ -35,6 +35,18 @@ const FAIL_CALL = 'ScaleBunEngage didFailToRegisterForRemoteNotificationsWithErr
 const REGISTER_SELECTOR = 'didRegisterForRemoteNotificationsWithDeviceToken';
 const FAIL_SELECTOR = 'didFailToRegisterForRemoteNotificationsWithError';
 
+// ── OTA bundle resolution (release bundleURL) ────────────────────────────────
+// The release branch of AppDelegate.bundleURL must return the OTA bundle before
+// the one baked into the .ipa, else an OTA update installs and silently never
+// loads. The exact wiring is documented on ScaleBunOtaModule.getBundleURL().
+// Unlike the push hooks (appended methods), this edits INSIDE an existing method,
+// so it is auto-applied only for the standard RN template line and instructed
+// otherwise (and always for Swift).
+const OTA_BUNDLE_CALL = 'getBundleURL';
+// The canonical release-bundle line RN templates emit (whitespace-tolerant).
+const OTA_RELEASE_LINE_RE =
+    /return\s*\[\[NSBundle mainBundle\]\s*URLForResource:@"main"\s*withExtension:@"jsbundle"\]\s*;/;
+
 // ── AppDelegate discovery ───────────────────────────────────────────────────
 
 /**
@@ -87,6 +99,9 @@ function analyzeObjc(source) {
         // does not forward to ScaleBun — we must not add a second one.
         foreignRegisterMethod: definesRegister && !s.includes(REGISTER_CALL),
         foreignFailMethod: definesFail && !s.includes(FAIL_CALL),
+        // OTA release-bundle resolution wired (either the ObjC `[... getBundleURL]`
+        // or a Swift `.getBundleURL()` form).
+        hasOtaBundleUrl: s.includes(OTA_BUNDLE_CALL),
     };
 }
 
@@ -228,9 +243,60 @@ function patchObjc(source) {
         if (needFail) summary.push('Added didFailToRegisterForRemoteNotificationsWithError: forwarding');
     }
 
+    // 5. OTA release-bundle resolution. Auto-apply only the standard template
+    //    line; otherwise instruct (never rewrite a custom bundleURL body).
+    if (!a.hasOtaBundleUrl) {
+        const ota = patchBundleUrlForOta(out);
+        if (ota.applied) {
+            out = ota.source;
+            summary.push('Wired release bundleURL → [ScaleBunOtaModule getBundleURL] (OTA)');
+        } else {
+            manual.push(otaObjcInstructions());
+        }
+    }
+
     return { changed: out !== String(source), source: out, summary, manual };
 }
 
+/**
+ * Wire the release branch of AppDelegate.bundleURL to prefer the OTA bundle.
+ * Only replaces the canonical RN template line (safe); returns applied:false with
+ * a reason when the AppDelegate has a custom bundleURL body we must not rewrite.
+ */
+function patchBundleUrlForOta(source) {
+    if (source.includes(OTA_BUNDLE_CALL)) return { source, applied: false, reason: 'present' };
+    const m = OTA_RELEASE_LINE_RE.exec(source);
+    if (!m) return { source, applied: false, reason: 'no-template-line' };
+    const lineStart = source.lastIndexOf('\n', m.index) + 1;
+    const indent = (source.slice(lineStart, m.index).match(/^\s*/) || [''])[0];
+    const replacement =
+        `NSURL *scalebunOtaURL = [ScaleBunOtaModule getBundleURL];\n` +
+        `${indent}if (scalebunOtaURL) return scalebunOtaURL;\n` +
+        `${indent}${m[0]}`;
+    return {
+        source: source.slice(0, m.index) + replacement + source.slice(m.index + m[0].length),
+        applied: true,
+    };
+}
+
+/** Exact ObjC OTA wiring when the standard template line is not found. */
+function otaObjcInstructions() {
+    return [
+        'OTA bundle resolution is not wired. In your AppDelegate bundleURL (release',
+        'branch), return the OTA bundle before the one baked into the .ipa:',
+        '',
+        '  - (NSURL *)bundleURL {',
+        '  #if DEBUG',
+        '    return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];',
+        '  #else',
+        '    NSURL *otaURL = [ScaleBunOtaModule getBundleURL];',
+        '    if (otaURL) return otaURL;',
+        '    return [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];',
+        '  #endif',
+        '  }',
+    ].join('\n');
+}
+
 /** Manual instructions for Swift AppDelegate (auto-patch not supported yet). */
 function swiftInstructions() {
     return [
@@ -251,6 +317,15 @@ function swiftInstructions() {
         '      didFailToRegisterForRemoteNotificationsWithError error: Error) {',
         '    ScaleBunEngage.didFailToRegisterForRemoteNotifications(error: error)',
         '  }',
+        '',
+        '  // OTA bundle resolution — without this, OTA updates install but never load:',
+        '  override func bundleURL() -> URL? {',
+        '    #if DEBUG',
+        '      RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")',
+        '    #else',
+        '      ScaleBunOtaModule.getBundleURL()',
+        '    #endif',
+        '  }',
     ].join('\n');
 }
 
@@ -258,9 +333,11 @@ module.exports = {
     SWIFT_HEADER,
     IMPORT_LINE,
     MANAGED_TAG,
+    OTA_BUNDLE_CALL,
     findAppDelegate,
     analyzeObjc,
     isFullyWiredObjc,
     patchObjc,
+    patchBundleUrlForOta,
     swiftInstructions,
 };

package/bin/scalebun.js

@@ -529,22 +529,26 @@ function runInitIos(argv) {
 
     // --check: verify, never write.
     if (isCheck) {
-        const wired = codemod.isFullyWiredObjc(original);
         const a = codemod.analyzeObjc(original);
+        const pushWired = codemod.isFullyWiredObjc(original);
+        const wired = pushWired && a.hasOtaBundleUrl;
         console.log('');
-        console.log(paint('Hook status', C.bold));
+        console.log(paint('Push hooks (APNs)', C.bold));
         line(a.hasImport ? OK() : FAIL(), 'ScaleBun Swift import', a.hasImport ? 'present' : null);
         line(a.hasFinishLaunchingCall ? OK() : FAIL(), 'didFinishLaunching forward', a.hasFinishLaunchingCall ? 'present' : null);
         line(a.hasRegisterForward ? OK() : FAIL(), 'didRegister...DeviceToken forward', a.hasRegisterForward ? 'present' : null);
         line(a.hasFailForward ? OK() : FAIL(), 'didFailToRegister forward', a.hasFailForward ? 'present' : null);
+        console.log('');
+        console.log(paint('OTA bundle resolution', C.bold));
+        line(a.hasOtaBundleUrl ? OK() : FAIL(), 'release bundleURL wiring', a.hasOtaBundleUrl ? 'present' : null);
         const caps = detectIosCapabilities(iosDir);
         printIosChecklist(caps);
         console.log('');
         if (wired) {
-            console.log(paint('✓ AppDelegate is fully wired for ScaleBun Direct APNs.', C.green));
+            console.log(paint('✓ AppDelegate is fully wired for ScaleBun (Direct APNs + OTA).', C.green));
             process.exit(0);
         }
-        console.log(paint('✗ AppDelegate is missing ScaleBun hooks. Run `npx scalebun init ios`.', C.red));
+        console.log(paint('✗ AppDelegate is missing ScaleBun wiring. Run `npx scalebun init ios`.', C.red));
         process.exit(1);
     }
 
@@ -909,7 +913,7 @@ function printFullHelp() {
     console.log('');
     console.log(paint('SDK setup (bundled with @scalebun/react-native):', C.bold));
     console.log('  npx scalebun doctor                  Diagnose push-notification setup');
-    console.log('  npx scalebun init ios                Wire the iOS AppDelegate for Direct APNs');
+    console.log('  npx scalebun init ios                Wire the iOS AppDelegate for Direct APNs + OTA');
     console.log('  npx scalebun init android            Wire Android MainApplication for OTA bundle loading');
     console.log(paint('    add --check to verify (exit 1 if missing) or --dry-run to preview', C.dim));
     console.log('');

package/dist/scalebun.full.js

@@ -489,7 +489,7 @@ var SDK_VERSION;
 var init_version = __esm({
   "lib/module/core/constants/version.js"() {
     "use strict";
-    SDK_VERSION = "1.6.1";
+    SDK_VERSION = "1.6.3";
   }
 });
 

package/dist/scalebun.slim.js

@@ -492,7 +492,7 @@ var SDK_VERSION;
 var init_version = __esm({
   "lib/module/core/constants/version.js"() {
     "use strict";
-    SDK_VERSION = "1.6.1";
+    SDK_VERSION = "1.6.3";
   }
 });
 

package/lib/commonjs/core/constants/version.js

@@ -9,5 +9,5 @@ exports.SDK_VERSION = void 0;
  * can attribute telemetry to the SDK build that produced it.
  * Keep in sync with package.json "version".
  */
-const SDK_VERSION = exports.SDK_VERSION = '1.6.1';
+const SDK_VERSION = exports.SDK_VERSION = '1.6.3';
 //# sourceMappingURL=version.js.map

package/lib/module/core/constants/version.js

@@ -3,5 +3,5 @@
  * can attribute telemetry to the SDK build that produced it.
  * Keep in sync with package.json "version".
  */
-export const SDK_VERSION = '1.6.1';
+export const SDK_VERSION = '1.6.3';
 //# sourceMappingURL=version.js.map

package/lib/typescript/core/constants/version.d.ts

@@ -3,5 +3,5 @@
  * can attribute telemetry to the SDK build that produced it.
  * Keep in sync with package.json "version".
  */
-export declare const SDK_VERSION = "1.6.1";
+export declare const SDK_VERSION = "1.6.3";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalebun/react-native",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "Production-grade React Native SDK for ScaleBun",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -105,7 +105,7 @@
     "@babel/runtime": "^7.25.0",
     "@jridgewell/sourcemap-codec": "1.5.5",
     "@jridgewell/trace-mapping": "0.3.31",
-    "@scalebun/cli": "^1.6.1"
+    "@scalebun/cli": "^1.6.3"
   },
   "codegenConfig": {
     "name": "ScaleBunSpec",

package/src/core/constants/version.ts

@@ -3,4 +3,4 @@
  * can attribute telemetry to the SDK build that produced it.
  * Keep in sync with package.json "version".
  */
-export const SDK_VERSION = '1.6.1';
+export const SDK_VERSION = '1.6.3';