@adobe/create-ccweb-add-on 3.0.0 → 3.1.0

package/dist/validators/DirectoryValidator.js

@@ -21,5 +21,156 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ********************************************************************************/
-export {};
+import { __decorate, __metadata, __param } from "tslib";
+import { ITypes as IAnalyticsTypes } from "@adobe/ccweb-add-on-analytics";
+import { ITypes as ICoreTypes, isNullOrWhiteSpace } from "@adobe/ccweb-add-on-core";
+import fs from "fs-extra";
+import { inject, injectable } from "inversify";
+import path from "path";
+import process from "process";
+import "reflect-metadata";
+import format from "string-template";
+import validate from "validate-npm-package-name";
+import { AnalyticsErrorMarkers } from "../AnalyticsMarkers.js";
+import { PROGRAM_NAME } from "../constants.js";
+/**
+ * Directory validator implementation class to validate
+ * whether the directory can be used to create the add-on project.
+ */
+let DirectoryValidator = class DirectoryValidator {
+    _logger;
+    _analyticsService;
+    /**
+     * Instantiate {@link DirectoryValidator}.
+     * @param logger - {@link Logger} reference.
+     * @param analyticsService - {@link AnalyticsService} reference.
+     * @returns Reference to a new {@link DirectoryValidator} instance.
+     */
+    constructor(logger, analyticsService) {
+        this._logger = logger;
+        this._analyticsService = analyticsService;
+    }
+    /**
+     * Validate the Add-on name.
+     * @param addOnName - Name of the Add-on.
+     */
+    async validateAddOnName(addOnName) {
+        if (isNullOrWhiteSpace(addOnName)) {
+            this._logger.warning(LOGS.specifyAddOnName);
+            this._chooseDifferentAddOnName();
+            await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_NO_ADD_ON_NAME, LOGS.analyticsNoAddOnName, false);
+            return process.exit(0);
+        }
+        const isValid = validate(addOnName).validForNewPackages;
+        if (!isValid) {
+            this._logger.warning(format(LOGS.npmNamingRestriction, { addOnName }));
+            this._chooseDifferentAddOnName();
+            await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_INVALID_NAME_NPM, LOGS.analyticsInvalidAddOnNameNPM, false);
+            return process.exit(0);
+        }
+        const dependencies = new Set([
+            "@adobe/create-ccweb-add-on",
+            "create-ccweb-add-on",
+            "@adobe/ccweb-add-on-scripts",
+            "ccweb-add-on-scripts",
+            "@adobe/ccweb-add-on-scaffolder",
+            "ccweb-add-on-scaffolder"
+        ]);
+        if (dependencies.has(addOnName)) {
+            this._logger.warning(format(LOGS.dependencyNamingRestriction, { addOnName }));
+            this._chooseDifferentAddOnName();
+            await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_INVALID_NAME_DEP, LOGS.analyticsInvalidAddOnNameDependency, false);
+            return process.exit(0);
+        }
+    }
+    /**
+     * Validate the addOn directory.
+     * @param addOnDirectory - Root directory of the addOn.
+     * @param addOnName - Name of the addOn.
+     */
+    async validateAddOnDirectory(addOnDirectory, addOnName) {
+        fs.ensureDirSync(addOnName);
+        const validFiles = [
+            ".DS_Store",
+            ".git",
+            ".gitattributes",
+            ".gitignore",
+            ".gitlab-ci.yml",
+            ".hg",
+            ".hgcheck",
+            ".hgignore",
+            ".idea",
+            ".npmignore",
+            ".travis.yml",
+            "docs",
+            "LICENSE",
+            "README.md",
+            "mkdocs.yml",
+            "Thumbs.db"
+        ];
+        const errorLogFilePatterns = ["npm-debug.log"];
+        const isErrorLog = (file) => {
+            return errorLogFilePatterns.some(pattern => file.startsWith(pattern));
+        };
+        const existingFiles = fs.readdirSync(addOnDirectory, { withFileTypes: true });
+        const conflictingFiles = existingFiles
+            .filter(file => !validFiles.includes(file.name))
+            .filter(file => !/\.iml$/.test(file.name))
+            .filter(file => !isErrorLog(file.name));
+        if (conflictingFiles.length === 0) {
+            return;
+        }
+        this._logger.warning(format(LOGS.directoryContainsFiles, { addOnName }), {
+            postfix: LOGS.newLine
+        });
+        for (const file of conflictingFiles) {
+            try {
+                if (fs.lstatSync(path.join(addOnDirectory, file.name)).isDirectory()) {
+                    this._logger.warning(`${file.name}/`, { prefix: LOGS.tab });
+                }
+                else {
+                    this._logger.warning(`${file.name}`, { prefix: LOGS.tab });
+                }
+            }
+            catch {
+                this._logger.warning(`${file.name}`, { prefix: LOGS.tab });
+            }
+        }
+        this._logger.information(LOGS.newAddOnOrRemoveFiles, { prefix: LOGS.newLine });
+        await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_INVALID_NAME_DIR, LOGS.analyticsInvalidAddOnDir, false);
+        return process.exit(0);
+    }
+    _chooseDifferentAddOnName() {
+        this._logger.warning(format(LOGS.executeProgram, { PROGRAM_NAME }), { prefix: LOGS.tab });
+        this._logger.message(LOGS.forExample, { prefix: LOGS.newLine });
+        this._logger.information(format(LOGS.executeProgramExample, { PROGRAM_NAME }), {
+            prefix: LOGS.tab,
+            postfix: LOGS.newLine
+        });
+    }
+};
+DirectoryValidator = __decorate([
+    injectable(),
+    __param(0, inject(ICoreTypes.Logger)),
+    __param(1, inject(IAnalyticsTypes.AnalyticsService)),
+    __metadata("design:paramtypes", [Object, Function])
+], DirectoryValidator);
+export { DirectoryValidator };
+const LOGS = {
+    newLine: "\n",
+    tab: "  ",
+    specifyAddOnName: "Please specify an Add-on name",
+    executeProgram: "{PROGRAM_NAME} <add-on-name> --entrypoint <panel> --template <javascript>",
+    executeProgramExample: "{PROGRAM_NAME} my-add-on --entrypoint panel --template javascript",
+    forExample: "For example:",
+    npmNamingRestriction: "Cannot create a project named {addOnName} because of NPM naming restrictions.",
+    dependencyNamingRestriction: "Cannot create a project named {addOnName} because a dependency with the same name exists.",
+    chooseDifferentAddOnName: "Please choose a different Add-on name:",
+    directoryContainsFiles: "The directory {addOnName} contains files that could conflict:",
+    newAddOnOrRemoveFiles: "Either try using a new Add-on name, or remove the files listed above.",
+    analyticsNoAddOnName: "Add-on name was not specified",
+    analyticsInvalidAddOnNameNPM: "Invalid Add-on name. Npm name check failed",
+    analyticsInvalidAddOnNameDependency: "Invalid Add-on name. Dependency with same name exists",
+    analyticsInvalidAddOnDir: "Invalid Add-on name. Conflicting directory with same name exists"
+};
 //# sourceMappingURL=DirectoryValidator.js.map

package/dist/validators/EnvironmentValidator.d.ts

@@ -21,11 +21,26 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ********************************************************************************/
+import type { AnalyticsService } from "@adobe/ccweb-add-on-analytics";
+import type { Logger, Process } from "@adobe/ccweb-add-on-core";
+import "reflect-metadata";
 /**
- * Environment validator interface to validate
+ * Environment validator implementation class to validate
  * the system requirements required for running the app.
  */
-export interface EnvironmentValidator {
+export declare class EnvironmentValidator {
+    private readonly _process;
+    private readonly _logger;
+    private readonly _analyticsService;
+    /**
+     * Instantiate {@link EnvironmentValidator}.
+     *
+     * @param processHandler - {@link Process} reference.
+     * @param logger - {@link Logger} reference.
+     * @param analyticsService - {@link AnalyticsService} reference.
+     * @returns Reference to a new {@link EnvironmentValidator} instance.
+     */
+    constructor(processHandler: Process, logger: Logger, analyticsService: AnalyticsService);
     /**
      * Validate the node version in the user's system.
      */

package/dist/validators/EnvironmentValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentValidator.d.ts","sourceRoot":"","sources":["../../src/validators/EnvironmentValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"EnvironmentValidator.d.ts","sourceRoot":"","sources":["../../src/validators/EnvironmentValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIhE,OAAO,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,qBACa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD;;;;;;;OAOG;gBAE6B,cAAc,EAAE,OAAO,EACxB,MAAM,EAAE,MAAM,EACC,gBAAgB,EAAE,gBAAgB;IAOhF;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B1C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCzC;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;CAmClD"}

package/dist/validators/EnvironmentValidator.js

@@ -21,5 +21,153 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ********************************************************************************/
-export {};
+import { __decorate, __metadata, __param } from "tslib";
+import { ITypes as IAnalyticsTypes } from "@adobe/ccweb-add-on-analytics";
+import { ITypes as ICoreTypes } from "@adobe/ccweb-add-on-core";
+import { inject, injectable } from "inversify";
+import process from "process";
+import "reflect-metadata";
+import semver from "semver";
+import format from "string-template";
+import { AnalyticsErrorMarkers } from "../AnalyticsMarkers.js";
+import { PROGRAM_NAME } from "../constants.js";
+/**
+ * Environment validator implementation class to validate
+ * the system requirements required for running the app.
+ */
+let EnvironmentValidator = class EnvironmentValidator {
+    _process;
+    _logger;
+    _analyticsService;
+    /**
+     * Instantiate {@link EnvironmentValidator}.
+     *
+     * @param processHandler - {@link Process} reference.
+     * @param logger - {@link Logger} reference.
+     * @param analyticsService - {@link AnalyticsService} reference.
+     * @returns Reference to a new {@link EnvironmentValidator} instance.
+     */
+    constructor(processHandler, logger, analyticsService) {
+        this._process = processHandler;
+        this._logger = logger;
+        this._analyticsService = analyticsService;
+    }
+    /**
+     * Validate the node version in the user's system.
+     */
+    async validateNodeVersion() {
+        const minNode = "18.0.0";
+        try {
+            const result = this._process.executeSync("node", ["--version"]);
+            const nodeVersion = String(result?.data)?.trim();
+            const hasMinNode = semver.gte(nodeVersion, minNode);
+            if (!hasMinNode) {
+                this._logger.warning(format(LOGS.usingNodeVersion, { nodeVersion }));
+                this._logger.information(format(LOGS.requiresHigherNode, {
+                    PROGRAM_NAME,
+                    minNode
+                }));
+                this._logger.information(LOGS.updateNodeVersion);
+                await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_INVALID_NODE, format(LOGS.analyticsInvalidNode, { nodeVersion }), false);
+                return process.exit(0);
+            }
+        }
+        catch (error) {
+            this._process.handleError(error);
+        }
+    }
+    /**
+     * Validate the npm version in the user's system.
+     */
+    async validateNpmVersion() {
+        const minNpm = "10.0.0";
+        try {
+            const result = this._process.executeSync("npm", ["--version"]);
+            const npmVersion = result.data ? String(result.data)?.trim() : undefined;
+            if (!npmVersion) {
+                this._logger.warning(LOGS.notUsingNpm);
+                this._logger.information(format(LOGS.requiresHigherNpm, {
+                    PROGRAM_NAME,
+                    minNpm
+                }));
+                this._logger.information(LOGS.installNpm);
+                await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_NO_NPM, LOGS.analyticsNoNpm, false);
+                return process.exit(0);
+            }
+            const hasMinNpm = semver.gte(npmVersion, minNpm);
+            if (!hasMinNpm) {
+                this._logger.warning(format(LOGS.usingNpmVersion, { npmVersion }));
+                this._logger.information(format(LOGS.requiresHigherNpm, {
+                    PROGRAM_NAME,
+                    minNpm
+                }));
+                this._logger.information(LOGS.updateNpm);
+                await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_INVALID_NPM, format(LOGS.analyticsInvalidNpm, { npmVersion }), false);
+                return process.exit(0);
+            }
+        }
+        catch (error) {
+            this._process.handleError(error);
+        }
+    }
+    /**
+     * Validate the npm configuration in the user's system.
+     */
+    async validateNpmConfiguration() {
+        try {
+            const cwd = process.cwd();
+            const configList = this._process.executeSync("npm", ["config", "list"])?.data;
+            if (!configList) {
+                return;
+            }
+            const prefix = "; cwd = ";
+            const configLines = configList.split("\n");
+            const cwdLine = configLines.find(line => line.startsWith(prefix));
+            if (!cwdLine) {
+                return;
+            }
+            const npmCWD = cwdLine.substring(prefix.length);
+            if (npmCWD === cwd) {
+                return;
+            }
+            this._logger.warning(LOGS.couldNotStartNpmProcess);
+            this._logger.information(format(LOGS.currentDirectory, { cwd }));
+            this._logger.information(format(LOGS.newNpmProcessRunsIn, { npmCWD }));
+            this._logger.information(LOGS.misconfiguredTerminalShell);
+            await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_NPM_NOT_STARTED, LOGS.analyticsNotStartNpm, false);
+            return process.exit(0);
+        }
+        catch (error) {
+            return;
+        }
+    }
+};
+EnvironmentValidator = __decorate([
+    injectable(),
+    __param(0, inject(ICoreTypes.Process)),
+    __param(1, inject(ICoreTypes.Logger)),
+    __param(2, inject(IAnalyticsTypes.AnalyticsService)),
+    __metadata("design:paramtypes", [Object, Object, Function])
+], EnvironmentValidator);
+export { EnvironmentValidator };
+const LOGS = {
+    newLine: "\n",
+    tab: "  ",
+    usingNodeVersion: "You are using node {nodeVersion}.",
+    requiresHigherNode: "{PROGRAM_NAME} requires node {minNode} or higher.",
+    updateNodeVersion: "Please update your version of node.",
+    notUsingNpm: "You are not using npm.",
+    requiresHigherNpm: "{PROGRAM_NAME} requires npm {minNpm} or higher.",
+    installNpm: "Please install npm.",
+    usingNpmVersion: "You are using npm {npmVersion}.",
+    updateNpm: "Please update your version of npm.",
+    couldNotStartNpmProcess: "Could not start an npm process in the right directory.",
+    currentDirectory: "The current directory is: {cwd}",
+    newNpmProcessRunsIn: "However, a newly started npm process runs in: {npmCWD}",
+    misconfiguredTerminalShell: "This is probably caused by a misconfigured system terminal shell.",
+    analyticsInvalidNode: "Invalid node version: {nodeVersion}",
+    analyticsNoNpm: "npm is not present",
+    analyticsInvalidNpm: "Invalid npm version: {npmVersion}",
+    analyticsNotStartNpm: "npm process could not be started"
+};
 //# sourceMappingURL=EnvironmentValidator.js.map

package/dist/validators/index.d.ts

@@ -21,8 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ********************************************************************************/
-export * from "./AddOnDirectoryValidator.js";
 export * from "./DirectoryValidator.js";
 export * from "./EnvironmentValidator.js";
-export * from "./NodeEnvironmentValidator.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;kFAsBkF;AAElF,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}

package/dist/validators/index.js

@@ -21,8 +21,6 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  ********************************************************************************/
-export * from "./AddOnDirectoryValidator.js";
 export * from "./DirectoryValidator.js";
 export * from "./EnvironmentValidator.js";
-export * from "./NodeEnvironmentValidator.js";
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/create-ccweb-add-on",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "author": "Adobe",
   "license": "MIT",
   "description": "Create an Adobe Creative Cloud Web Add-on.",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@oclif/core": "4.2.8",
-    "@swc/helpers": "0.5.12",
+    "@swc/helpers": "0.5.17",
     "chalk": "4.1.1",
     "fs-extra": "10.0.1",
     "inversify": "6.0.1",
@@ -44,10 +44,10 @@
     "string-template": "1.0.0",
     "tslib": "2.7.0",
     "validate-npm-package-name": "3.0.0",
-    "@adobe/ccweb-add-on-core": "3.0.0",
-    "@adobe/ccweb-add-on-analytics": "3.0.0",
-    "@adobe/ccweb-add-on-manifest": "3.0.0",
-    "@adobe/ccweb-add-on-scaffolder": "3.0.0"
+    "@adobe/ccweb-add-on-analytics": "3.1.0",
+    "@adobe/ccweb-add-on-core": "3.1.0",
+    "@adobe/ccweb-add-on-manifest": "3.1.0",
+    "@adobe/ccweb-add-on-scaffolder": "3.1.0"
   },
   "devDependencies": {
     "@oclif/test": "4.1.12",
@@ -61,7 +61,7 @@
     "@types/sinon": "9.0.8",
     "@types/string-template": "1.0.2",
     "@types/validate-npm-package-name": "3.0.3",
-    "c8": "7.7.2",
+    "c8": "10.1.3",
     "chai-as-promised": "7.1.1",
     "chai": "4.3.4",
     "mocha": "10.0.0",
@@ -80,6 +80,6 @@
     "ibuild": "tsc",
     "build": "rushx clean && rushx ibuild && rushx _postbuild",
     "build:release": "rushx build",
-    "test": "c8 mocha && c8 check-coverage --lines 100 --functions 100 --branches 100"
+    "test": "c8 mocha && c8 check-coverage"
   }
 }

package/src/app/AddOnFactory.ts

@@ -22,15 +22,175 @@
  * SOFTWARE.
  ********************************************************************************/
 
+import type { AnalyticsService } from "@adobe/ccweb-add-on-analytics";
+import { ITypes as IAnalyticsTypes } from "@adobe/ccweb-add-on-analytics";
+import type { Logger, Process } from "@adobe/ccweb-add-on-core";
+import { ITypes as ICoreTypes } from "@adobe/ccweb-add-on-core";
+import type { AddOnScaffolder } from "@adobe/ccweb-add-on-scaffolder";
+import { ITypes as IScaffolderTypes, PACKAGE_JSON, ScaffolderOptions } from "@adobe/ccweb-add-on-scaffolder";
+import fs from "fs-extra";
+import { inject, injectable } from "inversify";
+import os from "os";
+import path from "path";
+import process from "process";
+import "reflect-metadata";
+import format from "string-template";
+import url from "url";
+import { AnalyticsErrorMarkers, AnalyticsSuccessMarkers } from "../AnalyticsMarkers.js";
+import { ITypes } from "../config/inversify.types.js";
+import { TEMP_TEMPLATE_PATH } from "../constants.js";
 import type { CLIOptions } from "../models/CLIOptions.js";
+import { DirectoryValidator } from "../validators/DirectoryValidator.js";
+import { EnvironmentValidator } from "../validators/EnvironmentValidator.js";
+import { PackageManager } from "./PackageManager.js";
+import { TemplateSelector } from "./TemplateSelector.js";
 
 /**
- * Factory interface for creating the Add-on project.
+ * AddOn factory implementation class.
  */
-export interface AddOnFactory {
+@injectable()
+export class AddOnFactory {
+    private readonly _directoryValidator: DirectoryValidator;
+    private readonly _environmentValidator: EnvironmentValidator;
+    private readonly _templateSelector: TemplateSelector;
+
+    private readonly _scaffolder: AddOnScaffolder;
+
+    private readonly _process: Process;
+    private readonly _logger: Logger;
+
+    private readonly _analyticsService: AnalyticsService;
+
     /**
-     * Create the Add-on.
+     * Instantiate {@link AddOnFactory}.
+     * @param directoryValidator - {@link DirectoryValidator} reference.
+     * @param environmentValidator - {@link EnvironmentValidator} reference.
+     * @param templateSelector - {@link TemplateSelector} reference.
+     * @param scaffolder - {@link AddOnScaffolder} reference.
+     * @param cliProcess - {@link Process} reference.
+     * @param logger - {@link Logger} reference.
+     * @param analyticsService - {@link AnalyticsService} reference.
+     * @returns Reference to a new {@link AddOnFactory} instance.
+     */
+    constructor(
+        @inject(ITypes.DirectoryValidator) directoryValidator: DirectoryValidator,
+        @inject(ITypes.EnvironmentValidator) environmentValidator: EnvironmentValidator,
+        @inject(ITypes.TemplateSelector) templateSelector: TemplateSelector,
+        @inject(IScaffolderTypes.AddOnScaffolder) scaffolder: AddOnScaffolder,
+        @inject(ICoreTypes.Process) cliProcess: Process,
+        @inject(ICoreTypes.Logger) logger: Logger,
+        @inject(IAnalyticsTypes.AnalyticsService) analyticsService: AnalyticsService
+    ) {
+        this._directoryValidator = directoryValidator;
+        this._environmentValidator = environmentValidator;
+        this._templateSelector = templateSelector;
+
+        this._scaffolder = scaffolder;
+
+        this._process = cliProcess;
+        this._logger = logger;
+
+        this._analyticsService = analyticsService;
+    }
+
+    /**
+     * Create the Add-on project.
      * @param options - {@link CLIOptions}.
      */
-    create(options: CLIOptions): Promise<void>;
+    async create(options: CLIOptions): Promise<void> {
+        let addOnDirectory = "";
+
+        try {
+            await this._environmentValidator.validateNodeVersion();
+            await this._environmentValidator.validateNpmVersion();
+            await this._environmentValidator.validateNpmConfiguration();
+
+            await this._directoryValidator.validateAddOnName(options.addOnName);
+            addOnDirectory = path.resolve(options.addOnName);
+            await this._directoryValidator.validateAddOnDirectory(addOnDirectory, options.addOnName);
+
+            this._logger.information(LOGS.creatingAddOn);
+            this._logger.message(LOGS.mayTakeAMinute);
+
+            const templateName = await this._templateSelector.setupTemplate(options);
+
+            const packageJson = PackageManager.getPackageJson(options.entrypointType, options.addOnName);
+            const packageJsonPath = path.join(addOnDirectory, PACKAGE_JSON);
+
+            fs.writeFileSync(packageJsonPath, packageJson.toJSON() + os.EOL);
+
+            this._copyTemplateFiles(addOnDirectory, templateName);
+
+            const rootDirectory = process.cwd();
+            process.chdir(addOnDirectory);
+
+            const devDependencyArgs = [
+                "install",
+                "--save-dev",
+                "@adobe/ccweb-add-on-scripts",
+                "@types/adobe__ccweb-add-on-sdk"
+            ];
+
+            if (options.verbose) {
+                devDependencyArgs.push("--verbose");
+            }
+
+            this._logger.information(LOGS.installingDevDependencies, { prefix: LOGS.newLine });
+            await this._process.execute("npm", devDependencyArgs, { stdio: "inherit" });
+
+            const scaffolderOptions = new ScaffolderOptions(
+                addOnDirectory,
+                options.addOnName,
+                options.entrypointType,
+                rootDirectory,
+                templateName,
+                options.verbose
+            );
+
+            this._logger.information(format(LOGS.scaffoldingProjectFromTemplate, { templateName }), {
+                prefix: LOGS.newLine
+            });
+
+            await this._scaffolder.run(scaffolderOptions);
+
+            const analyticsEventData = [
+                "--addOnName",
+                options.addOnName,
+                "--entrypointType",
+                options.entrypointType,
+                "--template",
+                templateName
+            ];
+            await this._analyticsService.postEvent(AnalyticsSuccessMarkers.SUCCESS, analyticsEventData.join(" "), true);
+        } catch (error) {
+            this._process.handleError(error);
+            this._process.removeAddOn(addOnDirectory, options.addOnName);
+            await this._analyticsService.postEvent(AnalyticsErrorMarkers.ERROR_UNKNOWN_REASON, error.message, false);
+
+            return process.exit(0);
+        }
+    }
+
+    private _copyTemplateFiles(addOnDirectory: string, templateName: string) {
+        const targetPath = path.join(addOnDirectory, TEMP_TEMPLATE_PATH);
+        fs.ensureDirSync(targetPath);
+
+        const templateDirectory = path.join(url.fileURLToPath(import.meta.url), "..", "..", "templates", templateName);
+
+        if (fs.existsSync(templateDirectory)) {
+            fs.copySync(templateDirectory, targetPath);
+        } else {
+            this._logger.error(LOGS.templateNotFound);
+            process.exit(1);
+        }
+    }
 }
+
+const LOGS = {
+    newLine: "\n",
+    creatingAddOn: "Creating a new Add-on ...",
+    mayTakeAMinute: "This may take a minute ...",
+    installingDevDependencies: "Installing dev dependencies ...",
+    scaffoldingProjectFromTemplate: "Scaffolding project from template: {templateName} ...",
+    templateNotFound: "Could not find the artifacts for the selected template."
+};

package/src/app/{AddOnPackageManager.ts → PackageManager.ts}

@@ -28,7 +28,7 @@ import type { EntrypointType } from "@adobe/ccweb-add-on-manifest";
 /**
  * Class to manage the Add-on project requirements.
  */
-export class AddOnPackageManager {
+export class PackageManager {
     /**
      * Get package.json for the Add-on project.
      * @param entrypointType - Entrypoint type of Add-on. For example: panel, command, etc.