finan-code-push 1.0.0

package/bin/script/management-sdk.js

@@ -0,0 +1,445 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const Q = require("q");
+const superagent = require("superagent");
+const recursiveFs = require("recursive-fs");
+const yazl = require("yazl");
+const slash = require("slash");
+var Promise = Q.Promise;
+const hashUtils = require("./hash-utils");
+const packageJson = require("../../package.json");
+// A template string tag function that URL encodes the substituted values
+function urlEncode(strings, ...values) {
+    let result = "";
+    for (let i = 0; i < strings.length; i++) {
+        result += strings[i];
+        if (i < values.length) {
+            result += encodeURIComponent(values[i]);
+        }
+    }
+    return result;
+}
+class AccountManager {
+    static AppPermission = {
+        OWNER: "Owner",
+        COLLABORATOR: "Collaborator",
+    };
+    static SERVER_URL = "http://localhost:3000";
+    static API_VERSION = 2;
+    static ERROR_GATEWAY_TIMEOUT = 504; // Used if there is a network error
+    static ERROR_INTERNAL_SERVER = 500;
+    static ERROR_NOT_FOUND = 404;
+    static ERROR_CONFLICT = 409; // Used if the resource already exists
+    static ERROR_UNAUTHORIZED = 401;
+    _accessKey;
+    _serverUrl;
+    _customHeaders;
+    constructor(accessKey, customHeaders, serverUrl) {
+        if (!accessKey)
+            throw new Error("An access key must be specified.");
+        this._accessKey = accessKey;
+        this._customHeaders = customHeaders;
+        this._serverUrl = serverUrl || AccountManager.SERVER_URL;
+    }
+    get accessKey() {
+        return this._accessKey;
+    }
+    isAuthenticated(throwIfUnauthorized) {
+        return Promise((resolve, reject, notify) => {
+            const request = superagent.get(`${this._serverUrl}${urlEncode(["/authenticated"])}`);
+            this.attachCredentials(request);
+            request.end((err, res) => {
+                const status = this.getErrorStatus(err, res);
+                if (err && status !== AccountManager.ERROR_UNAUTHORIZED) {
+                    reject(this.getCodePushError(err, res));
+                    return;
+                }
+                const authenticated = status === 200;
+                if (!authenticated && throwIfUnauthorized) {
+                    reject(this.getCodePushError(err, res));
+                    return;
+                }
+                resolve(authenticated);
+            });
+        });
+    }
+    addAccessKey(friendlyName, ttl) {
+        if (!friendlyName) {
+            throw new Error("A name must be specified when adding an access key.");
+        }
+        const accessKeyRequest = {
+            createdBy: os.hostname(),
+            friendlyName,
+            ttl,
+        };
+        return this.post(urlEncode(["/accessKeys/"]), JSON.stringify(accessKeyRequest), /*expectResponseBody=*/ true).then((response) => {
+            return {
+                createdTime: response.body.accessKey.createdTime,
+                expires: response.body.accessKey.expires,
+                key: response.body.accessKey.name,
+                name: response.body.accessKey.friendlyName,
+            };
+        });
+    }
+    getAccessKey(accessKeyName) {
+        return this.get(urlEncode([`/accessKeys/${accessKeyName}`])).then((res) => {
+            return {
+                createdTime: res.body.accessKey.createdTime,
+                expires: res.body.accessKey.expires,
+                name: res.body.accessKey.friendlyName,
+            };
+        });
+    }
+    getAccessKeys() {
+        return this.get(urlEncode(["/accessKeys"])).then((res) => {
+            const accessKeys = [];
+            res.body.accessKeys.forEach((serverAccessKey) => {
+                !serverAccessKey.isSession &&
+                    accessKeys.push({
+                        createdTime: serverAccessKey.createdTime,
+                        expires: serverAccessKey.expires,
+                        name: serverAccessKey.friendlyName,
+                    });
+            });
+            return accessKeys;
+        });
+    }
+    getSessions() {
+        return this.get(urlEncode(["/accessKeys"])).then((res) => {
+            // A machine name might be associated with multiple session keys,
+            // but we should only return one per machine name.
+            const sessionMap = {};
+            const now = new Date().getTime();
+            res.body.accessKeys.forEach((serverAccessKey) => {
+                if (serverAccessKey.isSession && serverAccessKey.expires > now) {
+                    sessionMap[serverAccessKey.createdBy] = {
+                        loggedInTime: serverAccessKey.createdTime,
+                        machineName: serverAccessKey.createdBy,
+                    };
+                }
+            });
+            const sessions = Object.keys(sessionMap).map((machineName) => sessionMap[machineName]);
+            return sessions;
+        });
+    }
+    patchAccessKey(oldName, newName, ttl) {
+        const accessKeyRequest = {
+            friendlyName: newName,
+            ttl,
+        };
+        return this.patch(urlEncode([`/accessKeys/${oldName}`]), JSON.stringify(accessKeyRequest)).then((res) => {
+            return {
+                createdTime: res.body.accessKey.createdTime,
+                expires: res.body.accessKey.expires,
+                name: res.body.accessKey.friendlyName,
+            };
+        });
+    }
+    removeAccessKey(name) {
+        return this.del(urlEncode([`/accessKeys/${name}`])).then(() => null);
+    }
+    removeSession(machineName) {
+        return this.del(urlEncode([`/sessions/${machineName}`])).then(() => null);
+    }
+    // Account
+    getAccountInfo() {
+        return this.get(urlEncode(["/account"])).then((res) => res.body.account);
+    }
+    // Apps
+    getApps() {
+        return this.get(urlEncode(["/apps"])).then((res) => res.body.apps);
+    }
+    getApp(appName) {
+        return this.get(urlEncode([`/apps/${appName}`])).then((res) => res.body.app);
+    }
+    addApp(appName) {
+        const app = { name: appName };
+        return this.post(urlEncode(["/apps/"]), JSON.stringify(app), /*expectResponseBody=*/ false).then(() => app);
+    }
+    removeApp(appName) {
+        return this.del(urlEncode([`/apps/${appName}`])).then(() => null);
+    }
+    renameApp(oldAppName, newAppName) {
+        return this.patch(urlEncode([`/apps/${oldAppName}`]), JSON.stringify({ name: newAppName })).then(() => null);
+    }
+    transferApp(appName, email) {
+        return this.post(urlEncode([`/apps/${appName}/transfer/${email}`]), /*requestBody=*/ null, /*expectResponseBody=*/ false).then(() => null);
+    }
+    // Collaborators
+    getCollaborators(appName) {
+        return this.get(urlEncode([`/apps/${appName}/collaborators`])).then((res) => res.body.collaborators);
+    }
+    addCollaborator(appName, email) {
+        return this.post(urlEncode([`/apps/${appName}/collaborators/${email}`]), 
+        /*requestBody=*/ null, 
+        /*expectResponseBody=*/ false).then(() => null);
+    }
+    removeCollaborator(appName, email) {
+        return this.del(urlEncode([`/apps/${appName}/collaborators/${email}`])).then(() => null);
+    }
+    // Deployments
+    addDeployment(appName, deploymentName, deploymentKey) {
+        const deployment = { name: deploymentName, key: deploymentKey };
+        return this.post(urlEncode([`/apps/${appName}/deployments/`]), JSON.stringify(deployment), /*expectResponseBody=*/ true).then((res) => res.body.deployment);
+    }
+    clearDeploymentHistory(appName, deploymentName) {
+        return this.del(urlEncode([`/apps/${appName}/deployments/${deploymentName}/history`])).then(() => null);
+    }
+    getDeployments(appName) {
+        return this.get(urlEncode([`/apps/${appName}/deployments/`])).then((res) => res.body.deployments);
+    }
+    getDeployment(appName, deploymentName) {
+        return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}`])).then((res) => res.body.deployment);
+    }
+    renameDeployment(appName, oldDeploymentName, newDeploymentName) {
+        return this.patch(urlEncode([`/apps/${appName}/deployments/${oldDeploymentName}`]), JSON.stringify({ name: newDeploymentName })).then(() => null);
+    }
+    removeDeployment(appName, deploymentName) {
+        return this.del(urlEncode([`/apps/${appName}/deployments/${deploymentName}`])).then(() => null);
+    }
+    getDeploymentMetrics(appName, deploymentName) {
+        return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}/metrics`])).then((res) => res.body.metrics);
+    }
+    getDeploymentHistory(appName, deploymentName) {
+        return this.get(urlEncode([`/apps/${appName}/deployments/${deploymentName}/history`])).then((res) => res.body.history);
+    }
+    release(appName, deploymentName, filePath, targetBinaryVersion, updateMetadata, uploadProgressCallback) {
+        return Promise((resolve, reject, notify) => {
+            updateMetadata.appVersion = targetBinaryVersion;
+            this.packageFileFromPath(filePath)
+                .then((packageFile) => {
+                // Compute package hash from the zip file
+                hashUtils.generatePackageManifestFromZip(packageFile.path)
+                    .then((manifest) => {
+                    let hashPromise;
+                    if (manifest) {
+                        hashPromise = manifest.computePackageHash();
+                    }
+                    else {
+                        // If not a valid zip, hash the file directly
+                        hashPromise = hashUtils.hashFile(packageFile.path);
+                    }
+                    return hashPromise.then((packageHash) => {
+                        // Step 1: Get pre-signed upload URL from server
+                        const uploadUrlEndpoint = urlEncode([`/apps/${appName}/deployments/${deploymentName}/upload-url`]);
+                        return this.post(uploadUrlEndpoint, JSON.stringify({ packageInfo: updateMetadata }), true)
+                            .then((response) => {
+                            const { uploadUrl, blobId } = response.body;
+                            // Step 2: Upload directly to S3 using pre-signed URL
+                            const fileBuffer = fs.readFileSync(packageFile.path);
+                            const fileSize = fileBuffer.length;
+                            const uploadRequest = superagent
+                                .put(uploadUrl)
+                                .set("Content-Type", "application/octet-stream")
+                                .set("Content-Length", fileSize.toString())
+                                .send(fileBuffer);
+                            uploadRequest.on("progress", (event) => {
+                                if (uploadProgressCallback && event && event.total > 0) {
+                                    const currentProgress = (event.loaded / event.total) * 100;
+                                    uploadProgressCallback(currentProgress);
+                                }
+                            });
+                            uploadRequest.end((err, res) => {
+                                if (packageFile.isTemporary) {
+                                    fs.unlinkSync(packageFile.path);
+                                }
+                                if (err) {
+                                    reject({
+                                        message: `Failed to upload to S3: ${err.message}`,
+                                        statusCode: err.status || AccountManager.ERROR_GATEWAY_TIMEOUT,
+                                    });
+                                    return;
+                                }
+                                // Step 3: Finalize release on server with computed hash
+                                const finalizeEndpoint = urlEncode([`/apps/${appName}/deployments/${deploymentName}/finalize-release`]);
+                                const finalizeBody = JSON.stringify({
+                                    blobId,
+                                    packageInfo: updateMetadata,
+                                    packageSize: fileSize,
+                                    packageHash: packageHash,
+                                });
+                                this.post(finalizeEndpoint, finalizeBody, false)
+                                    .then(() => {
+                                    resolve(null);
+                                })
+                                    .catch((finalizeErr) => {
+                                    reject(finalizeErr);
+                                });
+                            });
+                        });
+                    });
+                })
+                    .catch((hashErr) => {
+                    if (packageFile.isTemporary) {
+                        fs.unlinkSync(packageFile.path);
+                    }
+                    reject({
+                        message: `Failed to compute package hash: ${hashErr.message}`,
+                        statusCode: AccountManager.ERROR_INTERNAL_SERVER,
+                    });
+                });
+            })
+                .catch((err) => {
+                reject({
+                    message: err.message,
+                    statusCode: AccountManager.ERROR_INTERNAL_SERVER,
+                });
+            });
+        });
+    }
+    patchRelease(appName, deploymentName, label, updateMetadata) {
+        updateMetadata.label = label;
+        const requestBody = JSON.stringify({ packageInfo: updateMetadata });
+        return this.patch(urlEncode([`/apps/${appName}/deployments/${deploymentName}/release`]), requestBody, 
+        /*expectResponseBody=*/ false).then(() => null);
+    }
+    promote(appName, sourceDeploymentName, destinationDeploymentName, updateMetadata) {
+        const requestBody = JSON.stringify({ packageInfo: updateMetadata });
+        return this.post(urlEncode([`/apps/${appName}/deployments/${sourceDeploymentName}/promote/${destinationDeploymentName}`]), requestBody, 
+        /*expectResponseBody=*/ false).then(() => null);
+    }
+    rollback(appName, deploymentName, targetRelease) {
+        return this.post(urlEncode([`/apps/${appName}/deployments/${deploymentName}/rollback/${targetRelease || ``}`]), 
+        /*requestBody=*/ null, 
+        /*expectResponseBody=*/ false).then(() => null);
+    }
+    packageFileFromPath(filePath) {
+        let getPackageFilePromise;
+        if (fs.lstatSync(filePath).isDirectory()) {
+            getPackageFilePromise = Promise((resolve, reject) => {
+                const directoryPath = filePath;
+                recursiveFs.readdirr(directoryPath, (error, directories, files) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    const baseDirectoryPath = path.dirname(directoryPath);
+                    const fileName = this.generateRandomFilename(15) + ".zip";
+                    const zipFile = new yazl.ZipFile();
+                    const writeStream = fs.createWriteStream(fileName);
+                    zipFile.outputStream
+                        .pipe(writeStream)
+                        .on("error", (error) => {
+                        reject(error);
+                    })
+                        .on("close", () => {
+                        filePath = path.join(process.cwd(), fileName);
+                        resolve({ isTemporary: true, path: filePath });
+                    });
+                    for (let i = 0; i < files.length; ++i) {
+                        const file = files[i];
+                        // yazl does not like backslash (\) in the metadata path.
+                        const relativePath = slash(path.relative(baseDirectoryPath, file));
+                        zipFile.addFile(file, relativePath);
+                    }
+                    zipFile.end();
+                });
+            });
+        }
+        else {
+            getPackageFilePromise = Q({ isTemporary: false, path: filePath });
+        }
+        return getPackageFilePromise;
+    }
+    generateRandomFilename(length) {
+        let filename = "";
+        const validChar = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+        for (let i = 0; i < length; i++) {
+            filename += validChar.charAt(Math.floor(Math.random() * validChar.length));
+        }
+        return filename;
+    }
+    get(endpoint, expectResponseBody = true) {
+        return this.makeApiRequest("get", endpoint, /*requestBody=*/ null, expectResponseBody, /*contentType=*/ null);
+    }
+    post(endpoint, requestBody, expectResponseBody, contentType = "application/json;charset=UTF-8") {
+        return this.makeApiRequest("post", endpoint, requestBody, expectResponseBody, contentType);
+    }
+    patch(endpoint, requestBody, expectResponseBody = false, contentType = "application/json;charset=UTF-8") {
+        return this.makeApiRequest("patch", endpoint, requestBody, expectResponseBody, contentType);
+    }
+    del(endpoint, expectResponseBody = false) {
+        return this.makeApiRequest("del", endpoint, /*requestBody=*/ null, expectResponseBody, /*contentType=*/ null);
+    }
+    makeApiRequest(method, endpoint, requestBody, expectResponseBody, contentType) {
+        return Promise((resolve, reject, notify) => {
+            let request = superagent[method](this._serverUrl + endpoint);
+            this.attachCredentials(request);
+            if (requestBody) {
+                if (contentType) {
+                    request = request.set("Content-Type", contentType);
+                }
+                request = request.send(requestBody);
+            }
+            request.end((err, res) => {
+                if (err) {
+                    reject(this.getCodePushError(err, res));
+                    return;
+                }
+                let body;
+                try {
+                    body = JSON.parse(res.text);
+                }
+                catch (err) { }
+                if (res.ok) {
+                    if (expectResponseBody && !body) {
+                        reject({
+                            message: `Could not parse response: ${res.text}`,
+                            statusCode: AccountManager.ERROR_INTERNAL_SERVER,
+                        });
+                    }
+                    else {
+                        resolve({
+                            headers: res.header,
+                            body: body,
+                        });
+                    }
+                }
+                else {
+                    if (body) {
+                        reject({
+                            message: body.message,
+                            statusCode: this.getErrorStatus(err, res),
+                        });
+                    }
+                    else {
+                        reject({
+                            message: res.text,
+                            statusCode: this.getErrorStatus(err, res),
+                        });
+                    }
+                }
+            });
+        });
+    }
+    getCodePushError(error, response) {
+        if (error.syscall === "getaddrinfo") {
+            error.message = `Unable to connect to the CodePush server. Are you offline, or behind a firewall or proxy?\n(${error.message})`;
+        }
+        return {
+            message: this.getErrorMessage(error, response),
+            statusCode: this.getErrorStatus(error, response),
+        };
+    }
+    getErrorStatus(error, response) {
+        return (error && error.status) || (response && response.status) || AccountManager.ERROR_GATEWAY_TIMEOUT;
+    }
+    getErrorMessage(error, response) {
+        return response && response.text ? response.text : error.message;
+    }
+    attachCredentials(request) {
+        if (this._customHeaders) {
+            for (const headerName in this._customHeaders) {
+                request.set(headerName, this._customHeaders[headerName]);
+            }
+        }
+        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);
+    }
+}
+module.exports = AccountManager;