@novacraft-engineering/pulsar-code-push 1.5.5 → 1.6.1

package/CodePush.js

@@ -9,6 +9,12 @@ import { setTargetingInfo, getTargetingInfo } from "./targeting";
 let NativeCodePush = require("react-native").NativeModules.CodePush;
 const PackageMixins = require("./package-mixins")(NativeCodePush);
 
+// Apps that choose their deployment key in JS (per environment) leave the native one empty, so the
+// launch-time status report has no key. Fall back to the first key the app checks with (its primary
+// backend) and send a report that was held for want of one as soon as that key is known.
+let fallbackDeployment = null;
+let reportAwaitingKey = null;
+
 async function checkForUpdate(deploymentKey = null, handleBinaryVersionMismatchCallback = null, serverUrl = null) {
   /*
    * Before we ask the server if an update exists, we
@@ -39,6 +45,14 @@ async function checkForUpdate(deploymentKey = null, handleBinaryVersionMismatchC
     ...(deploymentKey ? { deploymentKey } : {}),
     ...(serverUrl ? { serverUrl } : {}),
   };
+  if (config.deploymentKey && !fallbackDeployment) {
+    fallbackDeployment = { deploymentKey: config.deploymentKey, serverUrl: config.serverUrl };
+    if (reportAwaitingKey) {
+      const heldReport = reportAwaitingKey;
+      reportAwaitingKey = null;
+      tryReportStatus(heldReport);
+    }
+  }
   const sdk = getPromisifiedSdk(requestFetchAdapter, config);
 
   // Use dynamically overridden getCurrentPackage() during tests.
@@ -193,7 +207,8 @@ async function notifyApplicationReadyInternal() {
 }
 
 async function tryReportStatus(statusReport, retryOnAppResume) {
-  const config = await getConfiguration();
+  const nativeConfig = await getConfiguration();
+  const config = nativeConfig.deploymentKey || !fallbackDeployment ? nativeConfig : { ...nativeConfig, ...fallbackDeployment };
   const previousLabelOrAppVersion = statusReport.previousLabelOrAppVersion;
   const previousDeploymentKey = statusReport.previousDeploymentKey || config.deploymentKey;
   try {
@@ -201,6 +216,7 @@ async function tryReportStatus(statusReport, retryOnAppResume) {
       log(`Reporting binary update (${statusReport.appVersion})`);
 
       if (!config.deploymentKey) {
+        reportAwaitingKey = statusReport;
         throw new Error("Deployment key is missed");
       }
 

package/README.md

@@ -1,6 +1,6 @@
 # @novacraft-engineering/pulsar-code-push
 
-The React Native client for [Pulsar](https://pulsar.novacraft.africa) — over-the-air JavaScript updates for your app, no app-store review.
+The React Native client for [Pulsar](https://usepulsar.dev) — **over-the-air JavaScript updates** for your app, no app-store review. A free, self-hostable **CodePush alternative** for React Native.
 
 This is a full CodePush client (native iOS + Android modules), not a wrapper. It is a fork of
 [`@revopush/react-native-code-push`](https://github.com/revopush/react-native-code-push) — itself the
@@ -8,6 +8,13 @@ New-Architecture-maintained continuation of Microsoft's original
 [`react-native-code-push`](https://github.com/microsoft/react-native-code-push) (archived March 2025).
 It speaks the CodePush protocol, so it works against any CodePush-compatible server; it defaults to Pulsar.
 
+## Why
+
+Microsoft App Center CodePush shut down in March 2025 and Expo's EAS Update only covers Expo-managed
+projects. Pulsar keeps the CodePush protocol every bare React Native app already knows, adds staged
+rollouts, instant rollback, differential updates and per-release health metrics, and can be self-hosted.
+Read the full comparison at [usepulsar.dev/codepush-alternative](https://usepulsar.dev/codepush-alternative).
+
 ## Install
 
 ```bash
@@ -25,7 +32,7 @@ Autolinking registers the native module on both platforms (RN 0.70+, New Archite
 <key>CodePushDeploymentKey</key>
 <string>YOUR_DEPLOYMENT_KEY</string>
 <key>CodePushServerURL</key>
-<string>https://api.pulsar.novacraft.africa</string>
+<string>https://api.usepulsar.dev</string>
 ```
 
 **Android** — `android/app/src/main/res/values/strings.xml`:
@@ -33,7 +40,7 @@ Autolinking registers the native module on both platforms (RN 0.70+, New Archite
 ```xml
 <resources>
   <string moduleConfig="true" name="CodePushDeploymentKey">YOUR_DEPLOYMENT_KEY</string>
-  <string moduleConfig="true" name="CodePushServerURL">https://api.pulsar.novacraft.africa</string>
+  <string moduleConfig="true" name="CodePushServerURL">https://api.usepulsar.dev</string>
 </resources>
 ```
 
@@ -56,14 +63,31 @@ The full CodePush API is available — `codePush.sync()`, `codePush.checkForUpda
 `InstallMode`, `CheckFrequency`, `notifyAppReady()`, rollout %, mandatory updates, binary-version
 targeting, differential updates, automatic rollback, and download/install telemetry (reported to Pulsar).
 
+## Migrating from CodePush or RevoPush
+
+Swap the import and point `CodePushServerURL` at Pulsar — the native modules, the JS API and the
+package-hash algorithm are unchanged, so devices already running your current bundle correctly
+report "up to date" instead of re-downloading it.
+
+```diff
+-import codePush from 'react-native-code-push';
++import codePush from '@novacraft-engineering/pulsar-code-push';
+```
+
 ## Releasing
 
 Use the Pulsar CLI ([`@novacraft-engineering/pulsar-cli`](https://github.com/Novacraft-Africa/pulsar-cli)):
 
 ```bash
-npx pulsar release MyApp Staging --platform ios --target 1.0.0
+npx @novacraft-engineering/pulsar-cli release MyApp Staging --platform ios --target 1.0.0
 ```
 
+## Related
+
+- [Pulsar vs CodePush vs RevoPush](https://usepulsar.dev/blog/codepush-vs-revopush-vs-pulsar)
+- [Microsoft CodePush shutdown: what to move to](https://usepulsar.dev/blog/microsoft-codepush-shutdown-alternatives)
+- [How React Native OTA updates actually work](https://usepulsar.dev/blog/how-react-native-ota-updates-work)
+
 ## License
 
 MIT. Original CodePush © Microsoft; RevoPush fork © Revopush; this Pulsar distribution © Novacraft Engineering.

package/ios/CodePush/CodePush.m

@@ -570,19 +570,11 @@ static NSString *const LatestRollbackCountKey = @"count";
         } else {
             CPLog(@"Attempted to perform a rollback when there is no current update");
         }
-        // Nothing to roll back to. This happens when a pending update was
-        // recorded before a binary update: bundleURL clears the packages
-        // because the app version changed, but CODE_PUSH_PENDING_UPDATE lives
-        // in NSUserDefaults and survives. Reloading here re-enters this same
-        // path on the new bridge, so the app reload-loops on a blank screen
-        // until it is killed. Drop the stale flag and keep the loaded bundle.
-        [CodePush removePendingUpdate];
-        return;
+    } else {
+        // Write the current package's metadata to the "failed list"
+        [self saveFailedUpdate:failedPackage];
     }
 
-    // Write the current package's metadata to the "failed list"
-    [self saveFailedUpdate:failedPackage];
-
     // Rollback to the previous version and de-register the new update
     [CodePushPackage rollbackPackage];
     [CodePush removePendingUpdate];

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@novacraft-engineering/pulsar-code-push",
-  "version": "1.5.5",
+  "version": "1.6.1",
   "description": "Pulsar OTA client for React Native — over-the-air JavaScript updates. A CodePush-compatible client (RevoPush lineage) pointed at Pulsar.",
   "main": "CodePush.js",
   "typings": "typings/react-native-code-push.d.ts",
-  "homepage": "https://pulsar.novacraft.africa",
+  "homepage": "https://usepulsar.dev",
   "keywords": [
-    "react-native",
     "code-push",
     "codepush",
-    "pulsar",
+    "codepush-alternative",
+    "hot-update",
     "ota",
+    "ota-updates",
     "over-the-air",
-    "hot-update"
+    "pulsar",
+    "react-native",
+    "react-native-ota"
   ],
   "author": "Novacraft Engineering",
   "license": "MIT",

package/request-fetch-adapter.js

@@ -1,6 +1,17 @@
+const { Platform } = require("react-native");
 const packageJson = require("./package.json");
 const { getTargetingInfo } = require("./targeting");
 
+// React Native's default agent carries no usable platform detail — iOS sends a Darwin/CFNetwork
+// string with no "iPhone OS x_y", and Android goes out through OkHttp as bare "okhttp/4.x". Both
+// left the server guessing (Android was filed as "unknown" entirely, OS version was always empty),
+// so state it explicitly instead.
+function userAgent() {
+  const os = Platform.OS === "ios" ? "iOS" : Platform.OS === "android" ? "Android" : Platform.OS;
+  const version = Platform.Version === undefined || Platform.Version === null ? "" : String(Platform.Version);
+  return `Pulsar/${packageJson.version} (${os}${version ? " " + version : ""})`;
+}
+
 module.exports = {
   async request(verb, url, requestBody, callback) {
     if (typeof requestBody === "function") {
@@ -9,18 +20,32 @@ module.exports = {
     }
 
     // Scope the update-check to a specific device model / user id when the host app has set them.
-    // Only the GET update_check request is augmented; report_status is untouched.
+    const { userId, deviceModel } = getTargetingInfo();
     if (verb === 0 && url.indexOf("update_check") !== -1) {
-      const { userId, deviceModel } = getTargetingInfo();
       const extra = [];
       if (deviceModel) extra.push("device_model=" + encodeURIComponent(deviceModel));
       if (userId) extra.push("user_id=" + encodeURIComponent(userId));
       if (extra.length) url += (url.indexOf("?") === -1 ? "?" : "&") + extra.join("&");
     }
 
+    // Status reports carry the same identity. update_check only records a device when an update is
+    // actually served, so without this the device/user targeting lists never fill on a quiet app.
+    // The acquisition SDK hands us an already-stringified body here, so parse before augmenting.
+    if (url.indexOf("report_status") !== -1 && requestBody && (deviceModel || userId)) {
+      try {
+        const parsed = typeof requestBody === "string" ? JSON.parse(requestBody) : requestBody;
+        if (deviceModel && !parsed.device_model) parsed.device_model = deviceModel;
+        if (userId && !parsed.user_id) parsed.user_id = userId;
+        requestBody = parsed;
+      } catch (err) {
+        // A body we can't parse is left exactly as-is — reporting must never fail over telemetry.
+      }
+    }
+
     const headers = {
       "Accept": "application/json",
       "Content-Type": "application/json",
+      "User-Agent": userAgent(),
       "X-CodePush-Plugin-Name": packageJson.name,
       "X-CodePush-Plugin-Version": packageJson.version,
       "X-CodePush-SDK-Version": packageJson.dependencies["code-push"]