@adobe/ccweb-add-on-ssl 0.1.0

package/dist/app/SetupCommandExecutor.js

@@ -0,0 +1,243 @@
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+import { __decorate, __metadata, __param } from "tslib";
+import { ITypes as IAnalyticsTypes } from "@adobe/ccweb-add-on-analytics";
+import { ITypes as ICoreTypes, isFile } from "@adobe/ccweb-add-on-core";
+import chalk from "chalk";
+import devcert from "@adobe/ccweb-add-on-devcert";
+import { inject, injectable } from "inversify";
+import path from "path";
+import process from "process";
+import prompts from "prompts";
+import "reflect-metadata";
+import format from "string-template";
+import { AnalyticsErrorMarkers, AnalyticsSuccessMarkers } from "../AnalyticsMarkers.js";
+import { ITypes } from "../config/inversify.types.js";
+import { SSLRemoveOption, SSLSetupOption } from "../models/Types.js";
+const MAX_PROMPT_RETRIES = 3;
+/**
+ * Setup command execution implementation class.
+ */
+let SetupCommandExecutor = class SetupCommandExecutor {
+    _preferences;
+    _sslReader;
+    _analyticsService;
+    _logger;
+    /**
+     * Instantiate {@link SetupCommandExecutor}.
+     * @param preferences - {@link Preferences} reference.
+     * @param sslReader - {@link SSLReader} reference.
+     * @param analyticsService - {@link AnalyticsService} reference.
+     * @param logger - {@link Logger} reference.
+     * @returns Reference to a new {@link SetupCommandExecutor} instance.
+     */
+    constructor(preferences, sslReader, analyticsService, logger) {
+        this._preferences = preferences;
+        this._sslReader = sslReader;
+        this._analyticsService = analyticsService;
+        this._logger = logger;
+    }
+    /**
+     * Setup self-signed SSL certificate and key by checking if user defined preferences
+     * have SSL config data or if the user has already setup the certificates last time.
+     * Otherwise prompt the user to setup the SSL themselves by providing paths as the input or
+     * by allowing the CLI to setup the certificates on user's behalf.
+     * @param options - Command arguments provided by user represented as {@link SetupCommandOptions}.
+     * @returns Promise.
+     */
+    async execute(options) {
+        if (!(await this._shouldSetupNewSSL(options))) {
+            return;
+        }
+        const response = await prompts.prompt({
+            type: "select",
+            name: "sslSetupType",
+            message: this._promptMessage(LOGS.setupSSL),
+            choices: [
+                { title: this._promptMessageOption(LOGS.automatically), value: SSLSetupOption.Automatically },
+                { title: this._promptMessageOption(LOGS.manually), value: SSLSetupOption.Manually }
+            ],
+            initial: 0
+        });
+        if (!response || !response.sslSetupType) {
+            this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_SSL_SETUP, LOGS.sslSetupOptionNotSpecified, false);
+            return process.exit(1);
+        }
+        if (response.sslSetupType === SSLSetupOption.Manually) {
+            await this._setupSSLManually(options.hostname);
+            this._analyticsService.postEvent(AnalyticsSuccessMarkers.SUCCESSFUL_SSL_MANUAL_SETUP, options.hostname, true);
+        }
+        else {
+            await this._setupSSLAutomatically(options.hostname);
+            this._analyticsService.postEvent(AnalyticsSuccessMarkers.SUCCESSFUL_SSL_AUTOMATIC_SETUP, options.hostname, true);
+        }
+    }
+    async _shouldSetupNewSSL(options) {
+        const isCustomSSL = this._sslReader.isCustomSSL(options.hostname);
+        const isWxpSSL = this._sslReader.isWxpSSL(options.hostname);
+        const doesSSLExist = isCustomSSL || isWxpSSL;
+        // When SSL is not configured, set up a new SSL.
+        if (!doesSSLExist) {
+            this._logger.warning(format(LOGS.sslRequired, { hostname: options.hostname }), { prefix: LOGS.newLine });
+            return true;
+        }
+        // When SSL is configured and the option to use existing is passed, do not set up a new SSL.
+        if (options.useExisting) {
+            console.log();
+            return false;
+        }
+        // Prompt the user about the existing SSL and
+        // check if the user wants to remove the existing to create a new one.
+        this._logger.warning(format(LOGS.sslAlreadyConfigured, { hostname: options.hostname }), {
+            prefix: LOGS.newLine
+        });
+        // Consider updating the signature of `_removeExistingSSL` to accept only `options`
+        // when we introduce the @oclf command to `remove` an existing SSL.
+        return await this._removeExistingSSL(options, isCustomSSL, isWxpSSL);
+    }
+    async _setupSSLManually(hostname) {
+        const certificatePath = await this._promptUserForPath("certificate");
+        const keyPath = await this._promptUserForPath("key");
+        const userPreference = this._preferences.get();
+        if (userPreference.ssl === undefined) {
+            userPreference.ssl = new Map();
+        }
+        userPreference.ssl.set(hostname, { certificatePath, keyPath });
+        this._preferences.set(userPreference);
+        this._logger.success(LOGS.preferencesSaved, { prefix: LOGS.newLine, postfix: LOGS.newLine });
+    }
+    async _setupSSLAutomatically(hostname) {
+        this._logger.information(LOGS.settingUpSSL, { prefix: LOGS.newLine });
+        this._logger.message(LOGS.requireSystemPassword);
+        this._logger.message(LOGS.requireSystemPasswordReason);
+        this._logger.message(LOGS.retryRunningIfTakingLonger);
+        const sslData = await devcert.certificateFor(hostname, { getCaPath: true });
+        this._logger.success(LOGS.sslSetupComplete, { prefix: LOGS.newLine });
+        if (sslData?.caPath) {
+            const sslDirectory = path.resolve(sslData.caPath, "..", "..", "domains", hostname);
+            this._logger.information(format(LOGS.findSSLCertificate, { sslDirectory }), { postfix: LOGS.newLine });
+        }
+    }
+    async _removeExistingSSL(options, isCustomSSL, isWxpSSL) {
+        const response = await prompts.prompt({
+            type: "select",
+            name: "shouldRemove",
+            message: this._promptMessage(LOGS.removeExistingSSL),
+            choices: [
+                { title: this._promptMessageOption(LOGS.removeSSL), value: SSLRemoveOption.Remove },
+                { title: this._promptMessageOption(LOGS.keepSSL), value: SSLRemoveOption.Keep }
+            ],
+            initial: 0
+        });
+        // If no response is obtained, which indicates something has gone wrong, then exit.
+        if (!response || !response.shouldRemove) {
+            this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_SSL_REMOVE, LOGS.sslRemoveOptionNotSpecified, false);
+            return process.exit(1);
+        }
+        // If the user chooses to keep the existing SSL, do not set up a new SSL.
+        if (response.shouldRemove === SSLRemoveOption.Keep) {
+            console.log();
+            return false;
+        }
+        // Remove the existing SSL based on how it was set up earlier.
+        if (isCustomSSL) {
+            const userPreference = this._preferences.get();
+            userPreference.ssl.delete(options.hostname);
+            this._preferences.set(userPreference);
+            this._analyticsService.postEvent(AnalyticsSuccessMarkers.SUCCESSFUL_SSL_MANUAL_REMOVE, options.hostname, true);
+        }
+        if (isWxpSSL) {
+            await devcert.removeDomain(options.hostname);
+            this._analyticsService.postEvent(AnalyticsSuccessMarkers.SUCCESSFUL_SSL_AUTOMATIC_REMOVE, options.hostname, true);
+        }
+        this._logger.success(LOGS.removed, { postfix: LOGS.newLine });
+        return true;
+    }
+    async _promptUserForPath(asset) {
+        const promptData = {
+            certificate: {
+                type: "text",
+                name: "sslPath",
+                message: this._promptMessage(LOGS.specifyCertificatePath)
+            },
+            key: {
+                type: "text",
+                name: "sslPath",
+                message: this._promptMessage(LOGS.specifyKeyPath)
+            }
+        };
+        let maxTries = MAX_PROMPT_RETRIES;
+        /* eslint-disable no-await-in-loop -- Retry logic */
+        while (maxTries > 0) {
+            const { sslPath } = await prompts.prompt(promptData[asset]);
+            if (isFile(sslPath)) {
+                return sslPath;
+            }
+            maxTries--;
+            this._logger.error(format(LOGS.invalidPathSpecified, { asset }));
+        }
+        this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_SSL_SETUP, format(LOGS.invalidPathSpecified, { asset }), false);
+        return process.exit(1);
+    }
+    _promptMessage(message) {
+        return chalk.hex("#E59400")(message);
+    }
+    _promptMessageOption(message) {
+        return chalk.green.bold(message);
+    }
+};
+SetupCommandExecutor = __decorate([
+    injectable(),
+    __param(0, inject(ICoreTypes.Preferences)),
+    __param(1, inject(ITypes.SSLReader)),
+    __param(2, inject(IAnalyticsTypes.AnalyticsService)),
+    __param(3, inject(ICoreTypes.Logger)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object])
+], SetupCommandExecutor);
+export { SetupCommandExecutor };
+const LOGS = {
+    newLine: "\n",
+    sslRequired: "The Add-on requires a trusted SSL certificate in order to run on https://{hostname}",
+    sslAlreadyConfigured: "A trusted SSL certificate is already configured for the Add-on to run on https://{hostname}",
+    removeExistingSSL: "Do you want to remove your existing SSL certificate to set up a new one",
+    removeSSL: "Yes, remove the existing SSL certificate",
+    keepSSL: "No, keep my existing SSL certificate",
+    setupSSL: "How do you want to set up your SSL certificate",
+    automatically: "Automatically, set it up for me",
+    manually: "Manually, I already have an SSL certificate and key",
+    settingUpSSL: "Setting up self-signed SSL certificate ...",
+    requireSystemPassword: "This is only a one time step and may require you to enter your system's password",
+    requireSystemPasswordReason: "so that the SSL certificate can be added to your system's trusted certificate path.",
+    retryRunningIfTakingLonger: "[If this takes longer than expected, please break and retry]",
+    sslSetupComplete: "SSL setup complete!",
+    preferencesSaved: "Your preferences have been saved.",
+    findSSLCertificate: "You can find the SSL certificate in {sslDirectory}.",
+    specifyCertificatePath: "Please enter the path of your SSL certificate file",
+    specifyKeyPath: "Please enter the path of your SSL key file",
+    invalidPathSpecified: "Invalid {asset} path specified.",
+    sslSetupOptionNotSpecified: "SSL setup option is not specified.",
+    sslRemoveOptionNotSpecified: "SSL remove option is not specified.",
+    removed: "Removed."
+};
+//# sourceMappingURL=SetupCommandExecutor.js.map

package/dist/app/WxpSSLReader.d.ts

@@ -0,0 +1,60 @@
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+import type { Logger, Preferences } from "@adobe/ccweb-add-on-core";
+import "reflect-metadata";
+import type { SSLData } from "../models/index.js";
+/**
+ * Implementation class for reading the SSL artifacts.
+ */
+export declare class WxpSSLReader {
+    private readonly _preferences;
+    private readonly _logger;
+    /**
+     * Instantiate {@link WxpSSLReader}.
+     * @param Preferences - {@link Preferences} reference.
+     * @param logger - {@link Logger} reference.
+     * @returns Reference to a new {@link WxpSSLReader} instance.
+     */
+    constructor(preferences: Preferences, logger: Logger);
+    /**
+     * Is SSL set up manually by the user.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Boolean value representing whether SSL is set up manually.
+     */
+    isCustomSSL(hostname: string): boolean;
+    /**
+     * Is SSL set up automatically by the tool.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Boolean value representing whether SSL is set up automatically.
+     */
+    isWxpSSL(hostname: string): boolean;
+    /**
+     * Read the SSL artifacts.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Promise of {@link SSLData}.
+     */
+    read(hostname: string): Promise<SSLData>;
+    private _getUserDefinedSSL;
+}
+//# sourceMappingURL=WxpSSLReader.d.ts.map

package/dist/app/WxpSSLReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WxpSSLReader.d.ts","sourceRoot":"","sources":["../../src/app/WxpSSLReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAe,MAAM,0BAA0B,CAAC;AAKjF,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,qBACa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;;OAKG;gBACyC,WAAW,EAAE,WAAW,EAA6B,MAAM,EAAE,MAAM;IAK/G;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAInC;;;;OAIG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B9C,OAAO,CAAC,kBAAkB;CAQ7B"}

package/dist/app/WxpSSLReader.js

@@ -0,0 +1,113 @@
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+import { __decorate, __metadata, __param } from "tslib";
+import { ITypes as ICoreTypes, isFile } from "@adobe/ccweb-add-on-core";
+import devcert from "@adobe/ccweb-add-on-devcert";
+import fs from "fs-extra";
+import { inject, injectable } from "inversify";
+import "reflect-metadata";
+/**
+ * Implementation class for reading the SSL artifacts.
+ */
+let WxpSSLReader = class WxpSSLReader {
+    _preferences;
+    _logger;
+    /**
+     * Instantiate {@link WxpSSLReader}.
+     * @param Preferences - {@link Preferences} reference.
+     * @param logger - {@link Logger} reference.
+     * @returns Reference to a new {@link WxpSSLReader} instance.
+     */
+    constructor(preferences, logger) {
+        this._preferences = preferences;
+        this._logger = logger;
+    }
+    /**
+     * Is SSL set up manually by the user.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Boolean value representing whether SSL is set up manually.
+     */
+    isCustomSSL(hostname) {
+        return this._getUserDefinedSSL(hostname) !== undefined;
+    }
+    /**
+     * Is SSL set up automatically by the tool.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Boolean value representing whether SSL is set up automatically.
+     */
+    isWxpSSL(hostname) {
+        return devcert.hasCertificateFor(hostname);
+    }
+    /**
+     * Read the SSL artifacts.
+     * @param hostname - Hostname in the SSL certificate.
+     * @returns Promise of {@link SSLData}.
+     */
+    async read(hostname) {
+        const sslSettings = this._getUserDefinedSSL(hostname);
+        // When SSL is set up manuually by the `user`.
+        if (sslSettings !== undefined) {
+            const { certificatePath, keyPath } = sslSettings;
+            if (!certificatePath || !isFile(certificatePath)) {
+                this._logger.error(LOGS.invalidCertificatePath);
+                return process.exit(1);
+            }
+            if (!keyPath || !isFile(keyPath)) {
+                this._logger.error(LOGS.invalidKeyPath);
+                return process.exit(1);
+            }
+            return {
+                cert: fs.readFileSync(certificatePath),
+                key: fs.readFileSync(keyPath)
+            };
+        }
+        // When SSL is set up automatically by `devcert`.
+        if (this.isWxpSSL(hostname)) {
+            return await devcert.certificateFor(hostname);
+        }
+        this._logger.error(LOGS.noSSLDataFound, { postfix: LOGS.newLine });
+        return process.exit(1);
+    }
+    _getUserDefinedSSL(hostname) {
+        const { ssl } = this._preferences.get();
+        if (ssl === undefined) {
+            return undefined;
+        }
+        return ssl.get(hostname);
+    }
+};
+WxpSSLReader = __decorate([
+    injectable(),
+    __param(0, inject(ICoreTypes.Preferences)),
+    __param(1, inject(ICoreTypes.Logger)),
+    __metadata("design:paramtypes", [Object, Object])
+], WxpSSLReader);
+export { WxpSSLReader };
+const LOGS = {
+    newLine: "\n",
+    invalidCertificatePath: "Invalid SSL certificate file path.",
+    invalidKeyPath: "Invalid SSL key file path.",
+    noSSLDataFound: "No SSL related certificate or key files were found. Please retry after setting them up."
+};
+//# sourceMappingURL=WxpSSLReader.js.map

package/dist/app/index.d.ts

@@ -0,0 +1,28 @@
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+export * from "./CommandExecutor.js";
+export * from "./SSLReader.js";
+export * from "./SetupCommandExecutor.js";
+export * from "./WxpSSLReader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}

package/dist/app/index.js

@@ -0,0 +1,28 @@
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+export * from "./CommandExecutor.js";
+export * from "./SSLReader.js";
+export * from "./SetupCommandExecutor.js";
+export * from "./WxpSSLReader.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/setup.d.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+import type { Config } from "@oclif/core";
+import { Command } from "@oclif/core";
+import "reflect-metadata";
+/**
+ * SSL Setup command.
+ */
+export declare class Setup extends Command {
+    private readonly _accountService;
+    private readonly _analyticsConsent;
+    private readonly _analyticsService;
+    private readonly _commandValidator;
+    private readonly _commandExecutor;
+    static description: string;
+    static args: {};
+    static flags: {
+        hostname: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        useExisting: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        login: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        analytics: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        verbose: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    constructor(argv: string[], config: Config);
+    run(): Promise<void>;
+    catch(error: {
+        message: string;
+    }): Promise<void>;
+    private _seekTermsOfUseConsent;
+    private _seekAnalyticsConsent;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAOlF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,OAAO,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,qBAAa,KAAM,SAAQ,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IAErD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IAEnD,MAAM,CAAC,WAAW,SAA4D;IAE9E,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,KAAK;;;;;;MA+BV;gBAEU,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM;IAepC,GAAG;IAmBH,KAAK,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAKxB,sBAAsB;YAQtB,qBAAqB;CAOtC"}

package/dist/commands/setup.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/********************************************************************************
+ * MIT License
+
+ * © Copyright 2023 Adobe. All rights reserved.
+
+ * 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.
+ ********************************************************************************/
+import { CLIProgram, ITypes as IAnalyticsTypes } from "@adobe/ccweb-add-on-analytics";
+import { UncaughtExceptionHandler } from "@adobe/ccweb-add-on-core";
+import { ITypes as IDeveloperTermsTypes } from "@adobe/ccweb-add-on-developer-terms";
+import { Command, Flags } from "@oclif/core";
+import process from "process";
+import "reflect-metadata";
+import { AnalyticsErrorMarkers } from "../AnalyticsMarkers.js";
+import { IContainer, ITypes } from "../config/index.js";
+import { PROGRAM_NAME } from "../constants.js";
+import { SetupCommandOptions } from "../models/SetupCommandOptions.js";
+/**
+ * SSL Setup command.
+ */
+export class Setup extends Command {
+    _accountService;
+    _analyticsConsent;
+    _analyticsService;
+    _commandValidator;
+    _commandExecutor;
+    static description = "Setup a trusted SSL certificate for hosting an add-on.";
+    static args = {};
+    static flags = {
+        hostname: Flags.string({
+            char: "h",
+            description: "Hostname in the SSL certificate.",
+            required: true
+        }),
+        useExisting: Flags.boolean({
+            char: "e",
+            description: "Use existing SSL if present.",
+            required: false,
+            default: false,
+            hidden: true
+        }),
+        login: Flags.boolean({
+            char: "l",
+            description: "Force login.",
+            required: false,
+            default: false
+        }),
+        analytics: Flags.string({
+            char: "a",
+            description: "Turn on/off sending analytics to Adobe.",
+            options: ["on", "off"],
+            required: false
+        }),
+        verbose: Flags.boolean({
+            char: "v",
+            description: "Print detailed logs.",
+            required: false,
+            default: false
+        })
+    };
+    constructor(argv, config) {
+        super(argv, config);
+        this._accountService = IContainer.get(IDeveloperTermsTypes.AccountService);
+        this._analyticsConsent = IContainer.get(IAnalyticsTypes.AnalyticsConsent);
+        this._analyticsService = IContainer.get(IAnalyticsTypes.AnalyticsService);
+        this._analyticsService.program = new CLIProgram(PROGRAM_NAME, this.config.name + "@" + this.config.version);
+        this._analyticsService.startTime = Date.now();
+        this._commandValidator = IContainer.getNamed(ITypes.CommandValidator, "setup");
+        this._commandExecutor = IContainer.getNamed(ITypes.CommandExecutor, "setup");
+    }
+    async run() {
+        UncaughtExceptionHandler.registerExceptionHandler(PROGRAM_NAME);
+        const rootDirectory = process.cwd();
+        process.chdir(rootDirectory);
+        const { flags: { hostname, useExisting, login, analytics, verbose } } = await this.parse(Setup);
+        await this._seekTermsOfUseConsent(login, verbose);
+        await this._seekAnalyticsConsent(analytics);
+        const options = new SetupCommandOptions(hostname, useExisting, verbose);
+        await this._commandValidator.validate(options);
+        await this._commandExecutor.execute(options);
+    }
+    async catch(error) {
+        this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_SSL_SETUP, error.message, false);
+        throw error;
+    }
+    async _seekTermsOfUseConsent(login, verbose) {
+        if (login) {
+            await this._accountService.invalidateToken(verbose);
+        }
+        await this._accountService.seekTermsOfUseConsent();
+    }
+    async _seekAnalyticsConsent(analytics) {
+        if (analytics === undefined) {
+            await this._analyticsConsent.get();
+        }
+        else {
+            await this._analyticsConsent.set(analytics === "on");
+        }
+    }
+}
+//# sourceMappingURL=setup.js.map