@novacraft-engineering/pulsar-code-push 1.6.0 → 1.6.2

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.
@@ -192,8 +206,18 @@ async function notifyApplicationReadyInternal() {
   return statusReport;
 }
 
+// Report an install to the Pulsar server that delivered it. Its download links are
+// `<server>/download/...`, so the package names its own server — which matters when the native
+// config points elsewhere (an Android strings.xml that spells the key `CodePushServerURL`, the iOS
+// spelling, is ignored and falls back to the SDK's default).
+function pulsarServerFor(localPackage) {
+  const match = /^(https?:\/\/[^/?#]+)\/download\//.exec(localPackage?.downloadUrl || '');
+  return match ? match[1] : null;
+}
+
 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 +225,7 @@ async function tryReportStatus(statusReport, retryOnAppResume) {
       log(`Reporting binary update (${statusReport.appVersion})`);
 
       if (!config.deploymentKey) {
+        reportAwaitingKey = statusReport;
         throw new Error("Deployment key is missed");
       }
 
@@ -215,8 +240,9 @@ async function tryReportStatus(statusReport, retryOnAppResume) {
         await NativeCodePush.setLatestRollbackInfo(statusReport.package.packageHash);
       }
 
-      config.deploymentKey = statusReport.package.deploymentKey;
-      const sdk = getPromisifiedSdk(requestFetchAdapter, config);
+      const deliveredBy = pulsarServerFor(statusReport.package);
+      const reportConfig = {...config, deploymentKey: statusReport.package.deploymentKey, ...(deliveredBy ? {serverUrl: deliveredBy} : {})};
+      const sdk = getPromisifiedSdk(requestFetchAdapter, reportConfig);
       await sdk.reportStatusDeploy(statusReport.package, statusReport.status, previousLabelOrAppVersion, previousDeploymentKey);
     }
 

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/android/src/main/java/com/microsoft/codepush/react/CodePush.java

@@ -93,6 +93,7 @@ public class CodePush implements ReactPackage {
         if (publicKeyFromStrings != null) mPublicKey = publicKeyFromStrings;
 
         String serverUrlFromStrings = getCustomPropertyFromStringsIfExist("ServerUrl");
+        if (serverUrlFromStrings == null) serverUrlFromStrings = getCustomPropertyFromStringsIfExist("ServerURL");
         if (serverUrlFromStrings != null) mServerUrl = serverUrlFromStrings;
 
         // ignore liveReload when CodePush is initializing so that unneccessary cache could be cleared

package/ios/CodePush/CodePushConfig.m

@@ -34,7 +34,7 @@ static NSString * const PublicKeyKey = @"publicKey";
     NSString *appVersion = [infoDictionary objectForKey:@"CFBundleShortVersionString"];
     NSString *buildVersion = [infoDictionary objectForKey:(NSString *)kCFBundleVersionKey];
     NSString *deploymentKey = [infoDictionary objectForKey:@"CodePushDeploymentKey"];
-    NSString *serverURL = [infoDictionary objectForKey:@"CodePushServerURL"];
+    NSString *serverURL = [infoDictionary objectForKey:@"CodePushServerURL"] ?: [infoDictionary objectForKey:@"CodePushServerUrl"];
     NSString *publicKey = [infoDictionary objectForKey:@"CodePushPublicKey"];
 
     NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@novacraft-engineering/pulsar-code-push",
-  "version": "1.6.0",
-  "description": "Pulsar OTA client for React Native \u2014 over-the-air JavaScript updates. A CodePush-compatible client (RevoPush lineage) pointed at Pulsar.",
+  "version": "1.6.2",
+  "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",