code-push-itspar 1.0.0

package/LICENSE.txt

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Dream Sports Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,174 @@
+# CodePush CLI
+
+The **CodePush CLI** is a Node.js application that allows users to deploy and manage over-the-air updates for React Native applications.
+
+## Installation & Usage
+
+### Global Installation
+```bash
+npm install -g code-push-itspar
+```
+
+Or using yarn:
+```bash
+yarn global add code-push-itspar
+```
+
+After global installation, you can use the CLI directly:
+```bash
+code-push-itspar <command>
+```
+
+### Project Installation
+```bash
+# Using npm
+npm install --save-dev code-push-itspar
+
+# Using yarn
+yarn add --dev code-push-itspar
+```
+After project installation, you can use the CLI through npm/yarn:
+```bash
+# Using npm
+npm run code-push-itspar <command>
+
+# Using yarn
+yarn code-push-itspar <command>
+
+# Using npx
+npx code-push-itspar <command>
+```
+
+## Authentication
+
+Most commands require authentication. You'll need an access key and server URL to use the CLI.
+
+### Login
+```bash
+# Login with access key and server URL
+code-push-itspar login --accessKey <your-access-key> <server-url>
+
+# Example
+code-push-itspar login --accessKey abc123xyz https://codepush.jaswantdhayal.com
+
+# Check login status
+code-push-itspar whoami
+
+# Logout
+code-push-itspar logout
+```
+
+To get an access key:
+
+1. Visit your CodePush Dashboard
+2. Go to Settings → Generate New Token
+3. Generate a new access key
+
+## Release Management
+
+The `release` command allows you to deploy updates to your app. There are two types of updates you can release:
+
+1. Full Bundle (sending fully updated bundle)
+2. Patch Bundle (sending only the diff)
+
+### Command Structure
+```bash
+code-push-itspar release <appName> <updateContents> <targetBinaryVersion>
+[--deploymentName <deploymentName>]
+[--description <description>]
+[--disabled <disabled>]
+[--mandatory]
+[--noDuplicateReleaseError]
+[--rollout <rolloutPercentage>]
+[--isPatch <true|false>] # Default false. Specify true in case sending patch bundle.
+[--compression <'deflate' | 'brotli'>] # 'deflate' (default) or 'brotli' (better compression)
+```
+
+Parameters:
+
+Required Parameters:
+- `appName`: Name of your app (e.g., "MyApp-iOS")
+- `updateContents`: Path to your update files (bundle/assets)
+- `targetBinaryVersion`: App store version this update is for. Can be:
+  - Exact version: "1.0.0"
+  - Range: "^1.0.0" (compatible with 1.x.x)
+  - Wildcard: "*" (all versions)
+
+Optional Parameters:
+- `--deploymentName` or `-d`: Target deployment ("Staging" or "Production", defaults to "Staging")
+- `--description` or `-des`: Release notes or changelog
+- `--disabled`: Prevents update from being downloaded (useful for staged rollouts)
+- `--mandatory`: Forces users to accept this update
+- `--noDuplicateReleaseError`: Shows warning instead of error if releasing same content
+- `--rollout`: Percentage of users who should receive this update (1-100)
+- `--isPatch`: Whether this is a patch update
+  - `false` (default): Full bundle update
+  - `true`: Patch update (requires patch bundle)
+- `--compression`: Compression algorithm to use
+  - `deflate` (default): Standard compression
+  - `brotli`: Better compression, smaller bundle size
+
+### Full Bundle Release
+Release a complete new bundle:
+```bash
+# Release to staging with deflate compression (default)
+code-push-itspar release MyApp-iOS ./codepush 1.0.0 \
+  --deploymentName Staging \
+  --description "New features" \
+  --isPatch false
+
+# Release with brotli compression (better compression)
+code-push-itspar release MyApp-iOS ./dist/bundle "^1.0.0" \
+  --deploymentName Production \
+  --mandatory \
+  --isPatch false \
+  --compression brotli
+```
+
+> Note about compression: Brotli typically achieves better compression ratios than deflate (e.g., 23.1MB → 8.14MB with Brotli vs 11.04MB with deflate).
+
+### Patch Bundle Release
+For smaller updates, first create a patch and then release it:
+
+1. Create patch between old and new bundles:
+```bash
+code-push-itspar create-patch \
+  ./old-bundle \
+  ./new-bundle \
+  ./.codepush/patches
+```
+
+2. Release the patch:
+```bash
+# Release patch with brotli compression
+code-push-itspar release MyApp-iOS ./.codeupush/patches "1.0.0" \
+  --deploymentName Staging \
+  --description "Bug fixes" \
+  --isPatch true \
+  --compression brotli
+```
+
+> Note about patches: Patch updates significantly reduce the update size as they only contain the changes between versions. Always use `--isPatch true` when releasing a patch bundle.
+
+_Note: Make sure to upload assets alongwith patch bundle._
+
+For more details about the binary diff implementation, see [bsdiff/README.md](./bsdiff/README.md).
+
+### Promote Updates
+After testing in staging, promote to production:
+```bash
+# Basic promotion
+code-push-itspar promote MyApp-iOS Staging Production
+
+# Promotion with options
+code-push-itspar promote MyApp-iOS Staging Production \
+  --rollout 25 \                    # Release to 25% of users
+    --description "Verified update"    # Update description
+```
+
+## Contributing
+
+For information about contributing to CodePush CLI, please see our [Contributing Guide](./CONTRIBUTING.md).
+
+---
+**Note:** For additional commands and advanced features, see our [Advanced Usage Guide](./CLI_REFERENCE.md).

package/bin/script/acquisition-sdk.js

@@ -0,0 +1,178 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcquisitionManager = exports.AcquisitionStatus = void 0;
+class AcquisitionStatus {
+    static DeploymentSucceeded = "DeploymentSucceeded";
+    static DeploymentFailed = "DeploymentFailed";
+}
+exports.AcquisitionStatus = AcquisitionStatus;
+class AcquisitionManager {
+    _appVersion;
+    _clientUniqueId;
+    _deploymentKey;
+    _httpRequester;
+    _ignoreAppVersion;
+    _serverUrl;
+    constructor(httpRequester, configuration) {
+        this._httpRequester = httpRequester;
+        this._serverUrl = configuration.serverUrl;
+        if (this._serverUrl.slice(-1) !== "/") {
+            this._serverUrl += "/";
+        }
+        this._appVersion = configuration.appVersion;
+        this._clientUniqueId = configuration.clientUniqueId;
+        this._deploymentKey = configuration.deploymentKey;
+        this._ignoreAppVersion = configuration.ignoreAppVersion;
+    }
+    queryUpdateWithCurrentPackage(currentPackage, callback) {
+        if (!currentPackage || !currentPackage.appVersion) {
+            throw new Error("Calling common acquisition SDK with incorrect package"); // Unexpected; indicates error in our implementation
+        }
+        const updateRequest = {
+            deploymentKey: this._deploymentKey,
+            appVersion: currentPackage.appVersion,
+            packageHash: currentPackage.packageHash,
+            isCompanion: this._ignoreAppVersion,
+            label: currentPackage.label,
+            clientUniqueId: this._clientUniqueId,
+        };
+        const requestUrl = this._serverUrl + "updateCheck?" + queryStringify(updateRequest);
+        this._httpRequester.request(0 /* Http.Verb.GET */, requestUrl, (error, response) => {
+            if (error) {
+                callback(error, /*remotePackage=*/ null);
+                return;
+            }
+            if (response.statusCode !== 200) {
+                callback(new Error(response.statusCode + ": " + response.body), /*remotePackage=*/ null);
+                return;
+            }
+            let updateInfo;
+            try {
+                const responseObject = JSON.parse(response.body);
+                updateInfo = responseObject.updateInfo;
+            }
+            catch (error) {
+                callback(error, /*remotePackage=*/ null);
+                return;
+            }
+            if (!updateInfo) {
+                callback(error, /*remotePackage=*/ null);
+                return;
+            }
+            else if (updateInfo.updateAppVersion) {
+                callback(/*error=*/ null, {
+                    updateAppVersion: true,
+                    appVersion: updateInfo.appVersion,
+                });
+                return;
+            }
+            else if (!updateInfo.isAvailable) {
+                callback(/*error=*/ null, /*remotePackage=*/ null);
+                return;
+            }
+            const remotePackage = {
+                deploymentKey: this._deploymentKey,
+                description: updateInfo.description,
+                label: updateInfo.label,
+                appVersion: updateInfo.appVersion,
+                isMandatory: updateInfo.isMandatory,
+                packageHash: updateInfo.packageHash,
+                packageSize: updateInfo.packageSize,
+                downloadUrl: updateInfo.downloadURL,
+            };
+            callback(/*error=*/ null, remotePackage);
+        });
+    }
+    reportStatusDeploy(deployedPackage, status, previousLabelOrAppVersion, previousDeploymentKey, callback) {
+        const url = this._serverUrl + "reportStatus/deploy";
+        const body = {
+            appVersion: this._appVersion,
+            deploymentKey: this._deploymentKey,
+        };
+        if (this._clientUniqueId) {
+            body.clientUniqueId = this._clientUniqueId;
+        }
+        if (deployedPackage) {
+            body.label = deployedPackage.label;
+            body.appVersion = deployedPackage.appVersion;
+            switch (status) {
+                case AcquisitionStatus.DeploymentSucceeded:
+                case AcquisitionStatus.DeploymentFailed:
+                    body.status = status;
+                    break;
+                default:
+                    if (callback) {
+                        if (!status) {
+                            callback(new Error("Missing status argument."), /*not used*/ null);
+                        }
+                        else {
+                            callback(new Error('Unrecognized status "' + status + '".'), /*not used*/ null);
+                        }
+                    }
+                    return;
+            }
+        }
+        if (previousLabelOrAppVersion) {
+            body.previousLabelOrAppVersion = previousLabelOrAppVersion;
+        }
+        if (previousDeploymentKey) {
+            body.previousDeploymentKey = previousDeploymentKey;
+        }
+        callback = typeof arguments[arguments.length - 1] === "function" && arguments[arguments.length - 1];
+        this._httpRequester.request(2 /* Http.Verb.POST */, url, JSON.stringify(body), (error, response) => {
+            if (callback) {
+                if (error) {
+                    callback(error, /*not used*/ null);
+                    return;
+                }
+                if (response.statusCode !== 200) {
+                    callback(new Error(response.statusCode + ": " + response.body), /*not used*/ null);
+                    return;
+                }
+                callback(/*error*/ null, /*not used*/ null);
+            }
+        });
+    }
+    reportStatusDownload(downloadedPackage, callback) {
+        const url = this._serverUrl + "reportStatus/download";
+        const body = {
+            clientUniqueId: this._clientUniqueId,
+            deploymentKey: this._deploymentKey,
+            label: downloadedPackage.label,
+        };
+        this._httpRequester.request(2 /* Http.Verb.POST */, url, JSON.stringify(body), (error, response) => {
+            if (callback) {
+                if (error) {
+                    callback(error, /*not used*/ null);
+                    return;
+                }
+                if (response.statusCode !== 200) {
+                    callback(new Error(response.statusCode + ": " + response.body), /*not used*/ null);
+                    return;
+                }
+                callback(/*error*/ null, /*not used*/ null);
+            }
+        });
+    }
+}
+exports.AcquisitionManager = AcquisitionManager;
+function queryStringify(object) {
+    let queryString = "";
+    let isFirst = true;
+    for (const property in object) {
+        if (object.hasOwnProperty(property)) {
+            const value = object[property];
+            if (!isFirst) {
+                queryString += "&";
+            }
+            queryString += encodeURIComponent(property) + "=";
+            if (value !== null && typeof value !== "undefined") {
+                queryString += encodeURIComponent(value);
+            }
+            isFirst = false;
+        }
+    }
+    return queryString;
+}

package/bin/script/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+const parser = require("./command-parser");
+const execute = require("./command-executor");
+const chalk = require("chalk");
+function run() {
+    const command = parser.createCommand();
+    if (!command) {
+        parser.showHelp(/*showRootDescription*/ false);
+        return;
+    }
+    execute
+        .execute(command)
+        .catch((error) => {
+        console.error(chalk.red(`[Error]  ${error.message}`));
+        process.exit(1);
+    })
+        .done();
+}
+run();