@revopush/code-push-cli 0.0.7 → 0.0.8-rc.0

package/bin/script/command-executor.js

@@ -236,11 +236,12 @@ function deploymentHistoryClear(command) {
 const deploymentList = (command, showPackage = true) => {
     throwForInvalidOutputFormat(command.format);
     let deployments;
+    const DEPLOYMENTS_MAX_LENGTH = 10; // do not take metrics if number of deployment higher than this
     return exports.sdk
         .getDeployments(command.appName)
         .then((retrievedDeployments) => {
         deployments = retrievedDeployments;
-        if (showPackage) {
+        if (showPackage && deployments.length < DEPLOYMENTS_MAX_LENGTH) {
             const metricsPromises = deployments.map((deployment) => {
                 if (deployment.package) {
                     return exports.sdk.getDeploymentMetrics(command.appName, deployment.name).then((metrics) => {
@@ -269,7 +270,10 @@ const deploymentList = (command, showPackage = true) => {
 };
 exports.deploymentList = deploymentList;
 function deploymentRemove(command) {
-    return (0, exports.confirm)("Are you sure you want to remove this deployment? Note that its deployment key will be PERMANENTLY unrecoverable.").then((wasConfirmed) => {
+    const confirmation = command.isForce
+        ? Q.resolve(true)
+        : (0, exports.confirm)("Are you sure you want to remove this deployment? Note that its deployment key will be PERMANENTLY unrecoverable.");
+    return confirmation.then((wasConfirmed) => {
         if (wasConfirmed) {
             return exports.sdk.removeDeployment(command.appName, command.deploymentName).then(() => {
                 (0, exports.log)('Successfully removed the "' + command.deploymentName + '" deployment from the "' + command.appName + '" app.');
@@ -969,49 +973,16 @@ function patch(command) {
     throw new Error("At least one property must be specified to patch a release.");
 }
 const release = (command) => {
-    if ((0, file_utils_1.isBinaryOrZip)(command.package)) {
-        throw new Error("It is unnecessary to package releases in a .zip or binary file. Please specify the direct path to the update content's directory (e.g. /platforms/ios/www) or file (e.g. main.jsbundle).");
-    }
-    throwForInvalidSemverRange(command.appStoreVersion);
-    const filePath = command.package;
-    let isSingleFilePackage = true;
-    if (fs.lstatSync(filePath).isDirectory()) {
-        isSingleFilePackage = false;
-    }
-    let lastTotalProgress = 0;
-    const progressBar = new progress("Upload progress:[:bar] :percent :etas", {
-        complete: "=",
-        incomplete: " ",
-        width: 50,
-        total: 100,
-    });
-    const uploadProgress = (currentProgress) => {
-        progressBar.tick(currentProgress - lastTotalProgress);
-        lastTotalProgress = currentProgress;
-    };
+    // for initial release we explicitly define release as optional, disabled, without rollout, with a special description
     const updateMetadata = {
-        description: command.description,
-        isDisabled: command.disabled,
-        isMandatory: command.mandatory,
-        rollout: command.rollout,
+        description: command.initial ? `Zero release for v${command.appStoreVersion}` : command.description,
+        isDisabled: command.initial ? true : command.disabled,
+        isMandatory: command.initial ? false : command.mandatory,
+        isInitial: command.initial,
+        rollout: command.initial ? undefined : command.rollout,
+        appVersion: command.appStoreVersion,
     };
-    return exports.sdk
-        .isAuthenticated(true)
-        .then((isAuth) => {
-        return exports.sdk.release(command.appName, command.deploymentName, filePath, command.appStoreVersion, updateMetadata, uploadProgress);
-    })
-        .then(() => {
-        (0, exports.log)('Successfully released an update containing the "' +
-            command.package +
-            '" ' +
-            (isSingleFilePackage ? "file" : "directory") +
-            ' to the "' +
-            command.deploymentName +
-            '" deployment of the "' +
-            command.appName +
-            '" app.');
-    })
-        .catch((err) => releaseErrorHandler(err, command));
+    return doRelease(command, updateMetadata);
 };
 exports.release = release;
 const releaseReact = (command) => {
@@ -1019,6 +990,7 @@ const releaseReact = (command) => {
     let entryFile = command.entryFile;
     const outputFolder = command.outputDir || path.join(os.tmpdir(), "CodePush");
     const sourcemapOutputFolder = command.sourcemapOutput || path.join(os.tmpdir(), "CodePushSourceMap");
+    const baseReleaseTmpFolder = path.join(os.tmpdir(), "CodePushBaseRelease");
     const platform = (command.platform = command.platform.toLowerCase());
     const releaseCommand = command;
     // Check for app and deployment exist before releasing an update.
@@ -1026,7 +998,6 @@ const releaseReact = (command) => {
     return (exports.sdk
         .getDeployment(command.appName, command.deploymentName)
         .then(async () => {
-        releaseCommand.package = outputFolder;
         switch (platform) {
             case "android":
             case "ios":
@@ -1038,6 +1009,9 @@ const releaseReact = (command) => {
             default:
                 throw new Error('Platform must be either "android", "ios" or "windows".');
         }
+        releaseCommand.package = outputFolder;
+        releaseCommand.outputDir = outputFolder;
+        releaseCommand.bundleName = bundleName;
         let projectName;
         try {
             const projectPackageJson = require(path.join(process.cwd(), "package.json"));
@@ -1089,8 +1063,10 @@ const releaseReact = (command) => {
         .then(async () => {
         const isHermes = await (0, react_native_utils_1.isHermesEnabled)(command, platform);
         if (isHermes) {
+            await (0, exports.createEmptyTempReleaseFolder)(baseReleaseTmpFolder);
+            const baseBytecode = await (0, react_native_utils_1.takeHermesBaseBytecode)(command, baseReleaseTmpFolder, outputFolder, bundleName);
             (0, exports.log)(chalk.cyan("\nRunning hermes compiler...\n"));
-            await (0, react_native_utils_1.runHermesEmitBinaryCommand)(command, bundleName, outputFolder, sourcemapOutputFolder, command.extraHermesFlags, command.gradleFile);
+            await (0, react_native_utils_1.runHermesEmitBinaryCommand)(command, bundleName, outputFolder, sourcemapOutputFolder, command.extraHermesFlags, command.gradleFile, baseBytecode);
         }
     })
         .then(async () => {
@@ -1104,7 +1080,7 @@ const releaseReact = (command) => {
     })
         .then(() => {
         (0, exports.log)(chalk.cyan("\nReleasing update contents to CodePush:\n"));
-        return (0, exports.release)(releaseCommand);
+        return releaseReactNative(releaseCommand);
     })
         .then(async () => {
         if (!command.outputDir) {
@@ -1113,12 +1089,66 @@ const releaseReact = (command) => {
         if (!command.sourcemapOutput) {
             await deleteFolder(sourcemapOutputFolder);
         }
+        await deleteFolder(baseReleaseTmpFolder);
     })
         .catch(async (err) => {
         throw err;
     }));
 };
 exports.releaseReact = releaseReact;
+const releaseReactNative = (command) => {
+    // for initial release we explicitly define release as optional, disabled, without rollout, with a special description
+    const updateMetadata = {
+        description: command.initial ? `Zero release for v${command.appStoreVersion}` : command.description,
+        isDisabled: command.initial ? true : command.disabled,
+        isMandatory: command.initial ? false : command.mandatory,
+        isInitial: command.initial,
+        bundleName: command.bundleName,
+        outputDir: command.outputDir,
+        rollout: command.initial ? undefined : command.rollout,
+        appVersion: command.appStoreVersion,
+    };
+    return doRelease(command, updateMetadata);
+};
+const doRelease = (command, updateMetadata) => {
+    if ((0, file_utils_1.isBinaryOrZip)(command.package)) {
+        throw new Error("It is unnecessary to package releases in a .zip or binary file. Please specify the direct path to the update content's directory (e.g. /platforms/ios/www) or file (e.g. main.jsbundle).");
+    }
+    throwForInvalidSemverRange(command.appStoreVersion);
+    const filePath = command.package;
+    let isSingleFilePackage = true;
+    if (fs.lstatSync(filePath).isDirectory()) {
+        isSingleFilePackage = false;
+    }
+    let lastTotalProgress = 0;
+    const progressBar = new progress("Upload progress:[:bar] :percent :etas", {
+        complete: "=",
+        incomplete: " ",
+        width: 50,
+        total: 100,
+    });
+    const uploadProgress = (currentProgress) => {
+        progressBar.tick(currentProgress - lastTotalProgress);
+        lastTotalProgress = currentProgress;
+    };
+    return exports.sdk
+        .isAuthenticated(true)
+        .then((isAuth) => {
+        return exports.sdk.release(command.appName, command.deploymentName, filePath, updateMetadata, uploadProgress);
+    })
+        .then(() => {
+        (0, exports.log)('Successfully released an update containing the "' +
+            command.package +
+            '" ' +
+            (isSingleFilePackage ? "file" : "directory") +
+            ' to the "' +
+            command.deploymentName +
+            '" deployment of the "' +
+            command.appName +
+            '" app.');
+    })
+        .catch((err) => releaseErrorHandler(err, command));
+};
 function rollback(command) {
     return (0, exports.confirm)().then((wasConfirmed) => {
         if (!wasConfirmed) {

package/bin/script/command-parser.js

@@ -203,7 +203,13 @@ function deploymentRemove(commandName, yargs) {
     yargs
         .usage(USAGE_PREFIX + " deployment " + commandName + " <appName> <deploymentName>")
         .demand(/*count*/ 2, /*max*/ 2) // Require exactly two non-option arguments
-        .example("deployment " + commandName + " MyApp MyDeployment", 'Removes deployment "MyDeployment" from app "MyApp"');
+        .example("deployment " + commandName + " MyApp MyDeployment", 'Removes deployment "MyDeployment" from app "MyApp"')
+        .option("force", {
+        default: false,
+        demand: false,
+        description: "Bypass confirmation when removing deployments",
+        type: "boolean",
+    });
     addCommonConfiguration(yargs);
 }
 function deploymentHistory(commandName, yargs) {
@@ -616,6 +622,13 @@ yargs
         default: null,
         demand: false,
         description: "Path to the gradle file which specifies the binary version you want to target this release at (android only).",
+    })
+        .option("initial", {
+        alias: "i",
+        default: false,
+        demand: false,
+        description: "Specifies whether release is initial (base) for given targetBinaryVersion.",
+        type: "boolean",
     })
         .option("mandatory", {
         alias: "m",
@@ -933,6 +946,7 @@ function createCommand() {
                             const deploymentRemoveCommand = cmd;
                             deploymentRemoveCommand.appName = arg2;
                             deploymentRemoveCommand.deploymentName = arg3;
+                            deploymentRemoveCommand.isForce = argv["force"];
                         }
                         break;
                     case "rename":
@@ -1039,6 +1053,7 @@ function createCommand() {
                     releaseReactCommand.entryFile = argv["entryFile"];
                     releaseReactCommand.gradleFile = argv["gradleFile"];
                     releaseReactCommand.mandatory = argv["mandatory"];
+                    releaseReactCommand.initial = argv["initial"];
                     releaseReactCommand.noDuplicateReleaseError = argv["noDuplicateReleaseError"];
                     releaseReactCommand.plistFile = argv["plistFile"];
                     releaseReactCommand.plistFilePrefix = argv["plistFilePrefix"];

package/bin/script/management-sdk.js

@@ -195,6 +195,9 @@ class AccountManager {
     getDeployment(appName, deploymentName) {
         return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}`])).then((res) => res.body.deployment);
     }
+    getBaseRelease(appName, deploymentName, appVerison) {
+        return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}/basebundle?appVersion=${appVerison}`])).then((res) => res.body.basebundle);
+    }
     renameDeployment(appName, oldDeploymentName, newDeploymentName) {
         return this.patch(urlEncode([`/apps/${appName}/deployments/${oldDeploymentName}`]), JSON.stringify({ name: newDeploymentName })).then(() => null);
     }
@@ -207,9 +210,8 @@ class AccountManager {
     getDeploymentHistory(appName, deploymentName) {
         return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}/history`])).then((res) => res.body.history);
     }
-    release(appName, deploymentName, filePath, targetBinaryVersion, updateMetadata, uploadProgressCallback) {
+    release(appName, deploymentName, filePath, updateMetadata, uploadProgressCallback) {
         return Promise((resolve, reject, notify) => {
-            updateMetadata.appVersion = targetBinaryVersion;
             const request = superagent.post(this._serverUrl + urlEncode([`/apps/${appName}/deployments/${deploymentName}/release`]));
             this.attachCredentials(request);
             const getPackageFilePromise = Q.Promise((resolve, reject) => {
@@ -414,7 +416,7 @@ class AccountManager {
         }
         request.set("Accept", `application/vnd.code-push.v${AccountManager.API_VERSION}+json`);
         request.set("Authorization", `Bearer ${this._accessKey}`);
-        request.set("X-CodePush-SDK-Version", packageJson.version);
+        request.set("X-CodePush-SDK-Version", packageJson.version); // TODO get version differently without require("../../package.json");
     }
 }
 module.exports = AccountManager;

package/bin/script/react-native-utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getReactNativeVersion = exports.directoryExistsSync = exports.getReactNativePackagePath = exports.isHermesEnabled = exports.getMinifyParams = exports.getXcodeDotEnvValue = exports.runHermesEmitBinaryCommand = exports.getBundleSourceMapOutput = exports.isValidVersion = void 0;
+exports.getReactNativeVersion = exports.directoryExistsSync = exports.getReactNativePackagePath = exports.isHermesEnabled = exports.getMinifyParams = exports.getXcodeDotEnvValue = exports.runHermesEmitBinaryCommand = exports.takeHermesBaseBytecode = exports.getBundleSourceMapOutput = exports.isValidVersion = void 0;
 const fs = require("fs");
 const chalk = require("chalk");
 const path = require("path");
@@ -8,6 +8,7 @@ const childProcess = require("child_process");
 const semver_1 = require("semver");
 const file_utils_1 = require("./utils/file-utils");
 const dotenv = require("dotenv");
+const command_executor_1 = require("./command-executor");
 const g2js = require("gradle-to-js/lib/parser");
 function isValidVersion(version) {
     return !!(0, semver_1.valid)(version) || /^\d+\.\d+$/.test(version);
@@ -44,7 +45,22 @@ async function getBundleSourceMapOutput(command, bundleName, sourcemapOutputFold
     return bundleSourceMapOutput;
 }
 exports.getBundleSourceMapOutput = getBundleSourceMapOutput;
-async function runHermesEmitBinaryCommand(command, bundleName, outputFolder, sourcemapOutputFolder, extraHermesFlags, gradleFile) {
+async function takeHermesBaseBytecode(command, baseReleaseTmpFolder, outputFolder, bundleName) {
+    const { bundleBlobUrl } = await command_executor_1.sdk.getBaseRelease(command.appName, command.deploymentName, command.appStoreVersion);
+    if (!bundleBlobUrl) {
+        return null;
+    }
+    const baseReleaseArchive = await (0, file_utils_1.downloadBlob)(bundleBlobUrl, baseReleaseTmpFolder);
+    await (0, file_utils_1.extract)(baseReleaseArchive, baseReleaseTmpFolder);
+    const baseReleaseBundle = path.join(baseReleaseTmpFolder, path.basename(outputFolder), bundleName);
+    if (!fs.existsSync(baseReleaseBundle)) {
+        (0, command_executor_1.log)(chalk.cyan("\nNo base release available...\n"));
+        return null;
+    }
+    return baseReleaseBundle;
+}
+exports.takeHermesBaseBytecode = takeHermesBaseBytecode;
+async function runHermesEmitBinaryCommand(command, bundleName, outputFolder, sourcemapOutputFolder, extraHermesFlags, gradleFile, baseBytecode) {
     const hermesArgs = [];
     const envNodeArgs = process.env.CODE_PUSH_NODE_ARGS;
     if (typeof envNodeArgs !== "undefined") {
@@ -61,6 +77,9 @@ async function runHermesEmitBinaryCommand(command, bundleName, outputFolder, sou
     if (sourcemapOutputFolder) {
         hermesArgs.push("-output-source-map");
     }
+    if (baseBytecode) {
+        hermesArgs.push("-base-bytecode", baseBytecode);
+    }
     console.log(chalk.cyan("Converting JS bundle to byte code via Hermes, running command:\n"));
     const hermesCommand = await getHermesCommand(gradleFile);
     const hermesProcess = childProcess.spawn(hermesCommand, hermesArgs);

package/bin/script/utils/file-utils.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePath = exports.fileDoesNotExistOrIsDirectory = exports.copyFileToTmpDir = exports.fileExists = exports.isDirectory = exports.isBinaryOrZip = void 0;
+exports.extract = exports.downloadBlob = exports.normalizePath = exports.fileDoesNotExistOrIsDirectory = exports.copyFileToTmpDir = exports.fileExists = exports.isDirectory = exports.isBinaryOrZip = void 0;
 const fs = require("fs");
 const path = require("path");
 const rimraf = require("rimraf");
 const temp = require("temp");
+const unzipper = require("unzipper");
+const superagent = require("superagent");
 function isBinaryOrZip(path) {
     return path.search(/\.zip$/i) !== -1 || path.search(/\.apk$/i) !== -1 || path.search(/\.ipa$/i) !== -1;
 }
@@ -22,7 +24,6 @@ function fileExists(file) {
     }
 }
 exports.fileExists = fileExists;
-;
 function copyFileToTmpDir(filePath) {
     if (!isDirectory(filePath)) {
         const outputFolderPath = temp.mkdirSync("code-push");
@@ -48,3 +49,27 @@ function normalizePath(filePath) {
     return filePath.replace(/\\/g, "/");
 }
 exports.normalizePath = normalizePath;
+async function downloadBlob(url, folder, filename = "blob.zip") {
+    const destination = path.join(folder, filename);
+    const writeStream = fs.createWriteStream(destination);
+    return new Promise((resolve, reject) => {
+        writeStream.on("finish", () => resolve(destination));
+        writeStream.on("error", reject);
+        superagent
+            .get(url)
+            .ok((res) => res.status < 400)
+            .on("error", (err) => {
+            writeStream.destroy();
+            reject(err);
+        })
+            .pipe(writeStream);
+    });
+}
+exports.downloadBlob = downloadBlob;
+async function extract(zipPath, extractTo) {
+    const extractStream = unzipper.Extract({ path: extractTo });
+    await new Promise((resolve, reject) => {
+        fs.createReadStream(zipPath).pipe(extractStream).on("close", resolve).on("error", reject);
+    });
+}
+exports.extract = extract;

package/bin/test/management-sdk.js

@@ -154,6 +154,13 @@ describe("Management SDK", () => {
             done();
         }, rejectHandler);
     });
+    it("getBaseBundle handles JSON response", (done) => {
+        mockReturn(JSON.stringify({ basebundle: { bundleBlobUrl: "https://test.test/release.zip" } }), 200, {});
+        manager.getBaseRelease("appName", "deploymentName", "1.2.3").done((obj) => {
+            assert.ok(obj);
+            done();
+        }, rejectHandler);
+    });
     it("getDeployments handles JSON response", (done) => {
         mockReturn(JSON.stringify({ deployments: [] }), 200, {});
         manager.getDeployments("appName").done((obj) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revopush/code-push-cli",
-  "version": "0.0.7",
+  "version": "0.0.8-rc.0",
   "description": "Management CLI for the CodePush service",
   "main": "./script/cli.js",
   "scripts": {
@@ -45,6 +45,7 @@
     "slash": "1.0.0",
     "superagent": "^8.0.9",
     "temp": "^0.9.4",
+    "unzipper": "^0.12.3",
     "which": "^1.2.7",
     "wordwrap": "1.0.0",
     "xcode": "^3.0.1",
@@ -59,6 +60,7 @@
     "@types/node": "^20.3.1",
     "@types/q": "^1.5.8",
     "@types/sinon": "^10.0.15",
+    "@types/unzipper": "^0.10.11",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
     "eslint": "^8.45.0",
@@ -68,8 +70,8 @@
     "prettier": "^2.8.8",
     "sinon": "15.1.2",
     "superagent-mock": "^4.0.0",
-    "typescript": "^5.1.3",
     "ts-node": "^10.9.2",
+    "typescript": "^5.1.3",
     "which": "^3.0.1"
   }
 }

package/script/command-executor.ts

@@ -34,12 +34,14 @@ import {
   isHermesEnabled,
   isValidVersion,
   runHermesEmitBinaryCommand,
+  takeHermesBaseBytecode,
 } from "./react-native-utils";
 import { fileDoesNotExistOrIsDirectory, fileExists, isBinaryOrZip } from "./utils/file-utils";
 
 import AccountManager = require("./management-sdk");
 import wordwrap = require("wordwrap");
 import Promise = Q.Promise;
+import { ReactNativePackageInfo } from "./types/rest-definitions";
 
 const g2js = require("gradle-to-js/lib/parser");
 
@@ -364,9 +366,11 @@ export const deploymentList = (command: cli.IDeploymentListCommand, showPackage:
 };
 
 function deploymentRemove(command: cli.IDeploymentRemoveCommand): Promise<void> {
-  return confirm(
-    "Are you sure you want to remove this deployment? Note that its deployment key will be PERMANENTLY unrecoverable."
-  ).then((wasConfirmed: boolean): Promise<void> => {
+  const confirmation = command.isForce
+    ? Q.resolve(true)
+    : confirm("Are you sure you want to remove this deployment? Note that its deployment key will be PERMANENTLY unrecoverable.");
+
+  return confirmation.then((wasConfirmed: boolean): Promise<void> => {
     if (wasConfirmed) {
       return sdk.removeDeployment(command.appName, command.deploymentName).then((): void => {
         log('Successfully removed the "' + command.deploymentName + '" deployment from the "' + command.appName + '" app.');
@@ -1206,59 +1210,17 @@ function patch(command: cli.IPatchCommand): Promise<void> {
 }
 
 export const release = (command: cli.IReleaseCommand): Promise<void> => {
-  if (isBinaryOrZip(command.package)) {
-    throw new Error(
-      "It is unnecessary to package releases in a .zip or binary file. Please specify the direct path to the update content's directory (e.g. /platforms/ios/www) or file (e.g. main.jsbundle)."
-    );
-  }
-
-  throwForInvalidSemverRange(command.appStoreVersion);
-  const filePath: string = command.package;
-  let isSingleFilePackage: boolean = true;
-
-  if (fs.lstatSync(filePath).isDirectory()) {
-    isSingleFilePackage = false;
-  }
-
-  let lastTotalProgress = 0;
-  const progressBar = new progress("Upload progress:[:bar] :percent :etas", {
-    complete: "=",
-    incomplete: " ",
-    width: 50,
-    total: 100,
-  });
-
-  const uploadProgress = (currentProgress: number): void => {
-    progressBar.tick(currentProgress - lastTotalProgress);
-    lastTotalProgress = currentProgress;
-  };
-
+  // for initial release we explicitly define release as optional, disabled, without rollout, with a special description
   const updateMetadata: PackageInfo = {
-    description: command.description,
-    isDisabled: command.disabled,
-    isMandatory: command.mandatory,
-    rollout: command.rollout,
+    description: command.initial ? `Zero release for v${command.appStoreVersion}` : command.description,
+    isDisabled: command.initial ? true : command.disabled,
+    isMandatory: command.initial ? false : command.mandatory,
+    isInitial: command.initial,
+    rollout: command.initial ? undefined : command.rollout,
+    appVersion: command.appStoreVersion,
   };
 
-  return sdk
-    .isAuthenticated(true)
-    .then((isAuth: boolean): Promise<void> => {
-      return sdk.release(command.appName, command.deploymentName, filePath, command.appStoreVersion, updateMetadata, uploadProgress);
-    })
-    .then((): void => {
-      log(
-        'Successfully released an update containing the "' +
-          command.package +
-          '" ' +
-          (isSingleFilePackage ? "file" : "directory") +
-          ' to the "' +
-          command.deploymentName +
-          '" deployment of the "' +
-          command.appName +
-          '" app.'
-      );
-    })
-    .catch((err: CodePushError) => releaseErrorHandler(err, command));
+  return doRelease(command, updateMetadata);
 };
 
 export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> => {
@@ -1266,16 +1228,15 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
   let entryFile: string = command.entryFile;
   const outputFolder: string = command.outputDir || path.join(os.tmpdir(), "CodePush");
   const sourcemapOutputFolder: string = command.sourcemapOutput || path.join(os.tmpdir(), "CodePushSourceMap");
+  const baseReleaseTmpFolder: string = path.join(os.tmpdir(), "CodePushBaseRelease");
   const platform: string = (command.platform = command.platform.toLowerCase());
-  const releaseCommand: cli.IReleaseCommand = <any>command;
+  const releaseCommand: cli.IReleaseReactCommand = <any>command;
   // Check for app and deployment exist before releasing an update.
   // This validation helps to save about 1 minute or more in case user has typed wrong app or deployment name.
   return (
     sdk
       .getDeployment(command.appName, command.deploymentName)
       .then(async () => {
-        releaseCommand.package = outputFolder;
-
         switch (platform) {
           case "android":
           case "ios":
@@ -1289,6 +1250,10 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
             throw new Error('Platform must be either "android", "ios" or "windows".');
         }
 
+        releaseCommand.package = outputFolder;
+        releaseCommand.outputDir = outputFolder;
+        releaseCommand.bundleName = bundleName;
+
         let projectName: string;
 
         try {
@@ -1358,6 +1323,9 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
         const isHermes = await isHermesEnabled(command, platform);
 
         if (isHermes) {
+          await createEmptyTempReleaseFolder(baseReleaseTmpFolder);
+          const baseBytecode = await takeHermesBaseBytecode(command, baseReleaseTmpFolder, outputFolder, bundleName);
+
           log(chalk.cyan("\nRunning hermes compiler...\n"));
           await runHermesEmitBinaryCommand(
             command,
@@ -1365,7 +1333,8 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
             outputFolder,
             sourcemapOutputFolder,
             command.extraHermesFlags,
-            command.gradleFile
+            command.gradleFile,
+            baseBytecode
           );
         }
       })
@@ -1379,7 +1348,7 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
       })
       .then(() => {
         log(chalk.cyan("\nReleasing update contents to CodePush:\n"));
-        return release(releaseCommand);
+        return releaseReactNative(releaseCommand);
       })
       .then(async () => {
         if (!command.outputDir) {
@@ -1389,6 +1358,8 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
         if (!command.sourcemapOutput) {
           await deleteFolder(sourcemapOutputFolder);
         }
+
+        await deleteFolder(baseReleaseTmpFolder);
       })
       .catch(async (err: Error) => {
         throw err;
@@ -1396,6 +1367,71 @@ export const releaseReact = (command: cli.IReleaseReactCommand): Promise<void> =
   );
 };
 
+const releaseReactNative = (command: cli.IReleaseReactCommand): Promise<void> => {
+  // for initial release we explicitly define release as optional, disabled, without rollout, with a special description
+  const updateMetadata: ReactNativePackageInfo = {
+    description: command.initial ? `Zero release for v${command.appStoreVersion}` : command.description,
+    isDisabled: command.initial ? true : command.disabled,
+    isMandatory: command.initial ? false : command.mandatory,
+    isInitial: command.initial,
+    bundleName: command.bundleName,
+    outputDir: command.outputDir,
+    rollout: command.initial ? undefined : command.rollout,
+    appVersion: command.appStoreVersion,
+  };
+
+  return doRelease(command, updateMetadata);
+};
+
+const doRelease = (command: cli.IReleaseCommand | cli.IReleaseReactCommand, updateMetadata: PackageInfo): Promise<void> => {
+  if (isBinaryOrZip(command.package)) {
+    throw new Error(
+      "It is unnecessary to package releases in a .zip or binary file. Please specify the direct path to the update content's directory (e.g. /platforms/ios/www) or file (e.g. main.jsbundle)."
+    );
+  }
+
+  throwForInvalidSemverRange(command.appStoreVersion);
+  const filePath: string = command.package;
+  let isSingleFilePackage: boolean = true;
+
+  if (fs.lstatSync(filePath).isDirectory()) {
+    isSingleFilePackage = false;
+  }
+
+  let lastTotalProgress = 0;
+  const progressBar = new progress("Upload progress:[:bar] :percent :etas", {
+    complete: "=",
+    incomplete: " ",
+    width: 50,
+    total: 100,
+  });
+
+  const uploadProgress = (currentProgress: number): void => {
+    progressBar.tick(currentProgress - lastTotalProgress);
+    lastTotalProgress = currentProgress;
+  };
+
+  return sdk
+    .isAuthenticated(true)
+    .then((isAuth: boolean): Promise<void> => {
+      return sdk.release(command.appName, command.deploymentName, filePath, updateMetadata, uploadProgress);
+    })
+    .then((): void => {
+      log(
+        'Successfully released an update containing the "' +
+          command.package +
+          '" ' +
+          (isSingleFilePackage ? "file" : "directory") +
+          ' to the "' +
+          command.deploymentName +
+          '" deployment of the "' +
+          command.appName +
+          '" app.'
+      );
+    })
+    .catch((err: CodePushError) => releaseErrorHandler(err, command));
+};
+
 function rollback(command: cli.IRollbackCommand): Promise<void> {
   return confirm().then((wasConfirmed: boolean) => {
     if (!wasConfirmed) {

package/script/command-parser.ts

@@ -247,7 +247,13 @@ function deploymentRemove(commandName: string, yargs: yargs.Argv): void {
   yargs
     .usage(USAGE_PREFIX + " deployment " + commandName + " <appName> <deploymentName>")
     .demand(/*count*/ 2, /*max*/ 2) // Require exactly two non-option arguments
-    .example("deployment " + commandName + " MyApp MyDeployment", 'Removes deployment "MyDeployment" from app "MyApp"');
+    .example("deployment " + commandName + " MyApp MyDeployment", 'Removes deployment "MyDeployment" from app "MyApp"')
+    .option("force", {
+      default: false,
+      demand: false,
+      description: "Bypass confirmation when removing deployments",
+      type: "boolean",
+    });
 
   addCommonConfiguration(yargs);
 }
@@ -732,6 +738,13 @@ yargs
         demand: false,
         description: "Path to the gradle file which specifies the binary version you want to target this release at (android only).",
       })
+      .option("initial", {
+        alias: "i",
+        default: false,
+        demand: false,
+        description: "Specifies whether release is initial (base) for given targetBinaryVersion.",
+        type: "boolean",
+      })
       .option("mandatory", {
         alias: "m",
         default: false,
@@ -844,8 +857,7 @@ yargs
         alias: "eo",
         default: [],
         demand: false,
-        description:
-          "Option that gets passed to react-native bundler. Can be specified multiple times.",
+        description: "Option that gets passed to react-native bundler. Can be specified multiple times.",
         type: "array",
       })
       .check((argv: any, aliases: { [aliases: string]: string }): any => {
@@ -1107,6 +1119,7 @@ export function createCommand(): cli.ICommand {
 
               deploymentRemoveCommand.appName = arg2;
               deploymentRemoveCommand.deploymentName = arg3;
+              deploymentRemoveCommand.isForce = argv["force"] as any;
             }
             break;
 
@@ -1240,6 +1253,7 @@ export function createCommand(): cli.ICommand {
           releaseReactCommand.entryFile = argv["entryFile"] as any;
           releaseReactCommand.gradleFile = argv["gradleFile"] as any;
           releaseReactCommand.mandatory = argv["mandatory"] as any;
+          releaseReactCommand.initial = argv["initial"] as any;
           releaseReactCommand.noDuplicateReleaseError = argv["noDuplicateReleaseError"] as any;
           releaseReactCommand.plistFile = argv["plistFile"] as any;
           releaseReactCommand.plistFilePrefix = argv["plistFilePrefix"] as any;

package/script/management-sdk.ts

@@ -26,6 +26,7 @@ import {
   PackageInfo,
   ServerAccessKey,
   Session,
+  BaseRelease,
 } from "./types";
 
 const packageJson = require("../../package.json");
@@ -273,6 +274,12 @@ class AccountManager {
     return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}`])).then((res: JsonResponse) => res.body.deployment);
   }
 
+  public getBaseRelease(appName: string, deploymentName: string, appVerison: string): Promise<BaseRelease> {
+    return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}/basebundle?appVersion=${appVerison}`])).then(
+      (res: JsonResponse) => res.body.basebundle
+    );
+  }
+
   public renameDeployment(appName: string, oldDeploymentName: string, newDeploymentName: string): Promise<void> {
     return this.patch(
       urlEncode([`/apps/${appName}/deployments/${oldDeploymentName}`]),
@@ -300,12 +307,10 @@ class AccountManager {
     appName: string,
     deploymentName: string,
     filePath: string,
-    targetBinaryVersion: string,
     updateMetadata: PackageInfo,
     uploadProgressCallback?: (progress: number) => void
   ): Promise<void> {
     return Promise<void>((resolve, reject, notify) => {
-      updateMetadata.appVersion = targetBinaryVersion;
       const request: superagent.Request<any> = superagent.post(
         this._serverUrl + urlEncode([`/apps/${appName}/deployments/${deploymentName}/release`])
       );
@@ -569,7 +574,7 @@ class AccountManager {
 
     request.set("Accept", `application/vnd.code-push.v${AccountManager.API_VERSION}+json`);
     request.set("Authorization", `Bearer ${this._accessKey}`);
-    request.set("X-CodePush-SDK-Version", packageJson.version);
+    request.set("X-CodePush-SDK-Version", packageJson.version); // TODO get version differently without require("../../package.json");
   }
 }
 

package/script/react-native-utils.ts

@@ -3,10 +3,11 @@ import * as chalk from "chalk";
 import * as path from "path";
 import * as childProcess from "child_process";
 import { coerce, compare, valid } from "semver";
-import { fileDoesNotExistOrIsDirectory } from "./utils/file-utils";
+import { downloadBlob, extract, fileDoesNotExistOrIsDirectory } from "./utils/file-utils";
 import * as dotenv from "dotenv";
 import { DotenvParseOutput } from "dotenv";
 import * as cli from "../script/types/cli";
+import { log, sdk } from "./command-executor";
 
 const g2js = require("gradle-to-js/lib/parser");
 
@@ -47,13 +48,37 @@ export async function getBundleSourceMapOutput(command: cli.IReleaseReactCommand
   return bundleSourceMapOutput;
 }
 
+export async function takeHermesBaseBytecode(
+  command: cli.IReleaseReactCommand,
+  baseReleaseTmpFolder: string,
+  outputFolder: string,
+  bundleName: string
+): Promise<string | null> {
+  const { bundleBlobUrl } = await sdk.getBaseRelease(command.appName, command.deploymentName, command.appStoreVersion);
+  if (!bundleBlobUrl) {
+    return null;
+  }
+
+  const baseReleaseArchive = await downloadBlob(bundleBlobUrl, baseReleaseTmpFolder);
+  await extract(baseReleaseArchive, baseReleaseTmpFolder);
+  const baseReleaseBundle = path.join(baseReleaseTmpFolder, path.basename(outputFolder), bundleName);
+
+  if (!fs.existsSync(baseReleaseBundle)) {
+    log(chalk.cyan("\nNo base release available...\n"));
+    return null;
+  }
+
+  return baseReleaseBundle;
+}
+
 export async function runHermesEmitBinaryCommand(
   command: cli.IReleaseReactCommand,
   bundleName: string,
   outputFolder: string,
   sourcemapOutputFolder: string,
   extraHermesFlags: string[],
-  gradleFile: string
+  gradleFile: string,
+  baseBytecode?: string
 ): Promise<void> {
   const hermesArgs: string[] = [];
   const envNodeArgs: string = process.env.CODE_PUSH_NODE_ARGS;
@@ -75,6 +100,10 @@ export async function runHermesEmitBinaryCommand(
     hermesArgs.push("-output-source-map");
   }
 
+  if (baseBytecode) {
+    hermesArgs.push("-base-bytecode", baseBytecode);
+  }
+
   console.log(chalk.cyan("Converting JS bundle to byte code via Hermes, running command:\n"));
   const hermesCommand = await getHermesCommand(gradleFile);
   const hermesProcess = childProcess.spawn(hermesCommand, hermesArgs);
@@ -416,7 +445,7 @@ function getComposeSourceMapsPath(): string {
 }
 
 function getNodeModulesPath(reactNativePath: string): string {
- const nodeModulesPath = path.dirname(reactNativePath)
+  const nodeModulesPath = path.dirname(reactNativePath);
   if (directoryExistsSync(nodeModulesPath)) {
     return nodeModulesPath;
   }

package/script/types/cli.ts

@@ -132,6 +132,7 @@ export interface IDeploymentListCommand extends ICommand {
 export interface IDeploymentRemoveCommand extends ICommand {
   appName: string;
   deploymentName: string;
+  isForce?: boolean;
 }
 
 export interface IDeploymentRenameCommand extends ICommand {
@@ -156,6 +157,7 @@ export interface IPackageInfo {
   disabled?: boolean;
   mandatory?: boolean;
   rollout?: number;
+  initial?: boolean;
 }
 
 export interface IPatchCommand extends ICommand, IPackageInfo {
@@ -190,6 +192,7 @@ export interface IReleaseCommand extends IReleaseBaseCommand {
 }
 
 export interface IReleaseReactCommand extends IReleaseBaseCommand {
+  package?: string;
   bundleName?: string;
   development?: boolean;
   entryFile?: string;

package/script/types/rest-definitions.ts

@@ -49,11 +49,18 @@ export interface PackageInfo {
   description?: string;
   isDisabled?: boolean;
   isMandatory?: boolean;
+  isInitial?: boolean;
   /*generated*/ label?: string;
   /*generated*/ packageHash?: string;
   rollout?: number;
 }
 
+/*inout*/
+export interface ReactNativePackageInfo extends PackageInfo {
+  bundleName?: string;
+  outputDir?: string;
+}
+
 /*out*/
 export interface UpdateCheckResponse extends PackageInfo {
   target_binary_range?: string;
@@ -126,6 +133,11 @@ export interface Deployment {
   /*generated*/ package?: Package;
 }
 
+/*inout*/
+export interface BaseRelease {
+  bundleBlobUrl?: string;
+}
+
 /*out*/
 export interface BlobInfo {
   size: number;

package/script/types.ts

@@ -13,6 +13,7 @@ export {
   PackageInfo,
   AccessKey as ServerAccessKey,
   UpdateMetrics,
+  BaseRelease,
 } from "../script/types/rest-definitions";
 
 export interface CodePushError {

package/script/utils/file-utils.ts

@@ -2,6 +2,9 @@ import * as fs from "fs";
 import * as path from "path";
 import * as rimraf from "rimraf";
 import * as temp from "temp";
+import * as unzipper from "unzipper";
+
+import superagent = require("superagent");
 
 export function isBinaryOrZip(path: string): boolean {
   return path.search(/\.zip$/i) !== -1 || path.search(/\.apk$/i) !== -1 || path.search(/\.ipa$/i) !== -1;
@@ -17,7 +20,7 @@ export function fileExists(file: string): boolean {
   } catch (e) {
     return false;
   }
-};
+}
 
 export function copyFileToTmpDir(filePath: string): string {
   if (!isDirectory(filePath)) {
@@ -44,3 +47,29 @@ export function normalizePath(filePath: string): string {
   //replace all backslashes coming from cli running on windows machines by slashes
   return filePath.replace(/\\/g, "/");
 }
+
+export async function downloadBlob(url: string, folder: string, filename: string = "blob.zip"): Promise<string> {
+  const destination = path.join(folder, filename);
+  const writeStream = fs.createWriteStream(destination);
+
+  return new Promise((resolve, reject) => {
+    writeStream.on("finish", () => resolve(destination));
+    writeStream.on("error", reject);
+
+    superagent
+      .get(url)
+      .ok((res) => res.status < 400)
+      .on("error", (err) => {
+        writeStream.destroy();
+        reject(err);
+      })
+      .pipe(writeStream);
+  });
+}
+
+export async function extract(zipPath: string, extractTo: string) {
+  const extractStream = unzipper.Extract({ path: extractTo });
+  await new Promise<void>((resolve, reject) => {
+    fs.createReadStream(zipPath).pipe(extractStream).on("close", resolve).on("error", reject);
+  });
+}

package/test/management-sdk.ts

@@ -196,6 +196,15 @@ describe("Management SDK", () => {
     }, rejectHandler);
   });
 
+  it("getBaseBundle handles JSON response", (done: Mocha.Done) => {
+    mockReturn(JSON.stringify({ basebundle: { bundleBlobUrl: "https://test.test/release.zip" } }), 200, {});
+
+    manager.getBaseRelease("appName", "deploymentName", "1.2.3").done((obj: any) => {
+      assert.ok(obj);
+      done();
+    }, rejectHandler);
+  });
+
   it("getDeployments handles JSON response", (done: Mocha.Done) => {
     mockReturn(JSON.stringify({ deployments: [] }), 200, {});