untitledui 0.1.1

package/dist/commands/init.js

@@ -0,0 +1,436 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.program = void 0;
+const async_retry_1 = __importDefault(require("async-retry"));
+const chalk_1 = __importDefault(require("chalk"));
+const commander_1 = require("commander");
+const execa_1 = require("execa");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const fs_1 = __importDefault(require("fs"));
+const ora_1 = __importDefault(require("ora"));
+const os_1 = __importDefault(require("os"));
+const path = __importStar(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
+const ts_morph_1 = require("ts-morph");
+const download_tar_api_1 = require("../helper/download-tar-api");
+const find_css_file_1 = require("../helper/find-css-file");
+const get_config_1 = require("../helper/get-config");
+const get_package_info_1 = require("../helper/get-package-info");
+const get_pkg_manager_1 = require("../helper/get-pkg-manager");
+const get_project_1 = require("../helper/get-project");
+const install_template_1 = require("../helper/install-template");
+const update_color_css_1 = require("../helper/update-color-css");
+const CONFIG_DIR = path.join(os_1.default.homedir(), ".untitledui");
+const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
+const DEFAULT_TEMPLATE = "default";
+const PRIVATE_TEMPLATES = ["with-stripe", "otp", "magic-link"];
+// Directory where the project will be initialized
+let projectPath = "";
+let promptOptions = {
+    template: "",
+    color: "",
+};
+if (fs_1.default.existsSync(CONFIG_PATH)) {
+    const config = JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
+    promptOptions.license = config.license;
+}
+const onPromptState = (state) => {
+    if (state.aborted) {
+        // If we don't re-enable the terminal cursor before exiting
+        // the program, the cursor will remain hidden
+        process.stdout.write("\x1B[?25h");
+        process.stdout.write("\n");
+        process.exit(1);
+    }
+};
+exports.program = new commander_1.Command()
+    .name("init")
+    .description("initialize a new project")
+    .argument("[directory]")
+    .usage("[directory] [options]")
+    .helpOption("-h, --help", "Display this help message.")
+    .option("-t, --template <starter-kit>", "Specify a template for the project.")
+    .option("-c, --color <color-name>", "Specify a color for the project.")
+    .option("-o, --overwrite", "Overwrite existing files.", false)
+    .option("-l, --license <license-key>", "Add a license key to download the repository.")
+    .action((name, options) => __awaiter(void 0, void 0, void 0, function* () {
+    if (name) {
+        projectPath = name;
+    }
+    if (options) {
+        promptOptions.color = options.color;
+        promptOptions.template = options.template;
+        promptOptions.overwrite = options.overwrite;
+        promptOptions.license = options.license || promptOptions.license;
+    }
+    try {
+        yield run(options);
+    }
+    catch (e) {
+        console.error(chalk_1.default.red(e));
+    }
+}));
+function run(opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const cwd = process.cwd();
+        const isExistingProject = fs_1.default.existsSync(path.resolve(cwd, "package.json"));
+        // Src dir in main repo where styles and plugins folder are located
+        const stylesFolder = path.join(path.resolve(__dirname, "../../../../"));
+        // Get `theme.css` file from the src/styles directory
+        const cssFilePath = (0, find_css_file_1.findCssFile)(stylesFolder);
+        // Extract color variables from the theme.css file
+        const colors = (0, update_color_css_1.extractColorVariables)(cssFilePath !== null && cssFilePath !== void 0 ? cssFilePath : "");
+        // Get unique prefixes from the color variables
+        const prefixes = Array.from(new Set(Object.keys(colors).map((varName) => varName.split("--color-")[1].replace(/-\d{1,3}/, ""))));
+        const spinner = (0, ora_1.default)().start();
+        // Get the project configuration and check if it is a Next.js project
+        const info = yield (0, get_project_1.getNextjsProjectConfig)(cwd);
+        if (promptOptions.license) {
+            const isValidKey = yield (0, download_tar_api_1.checkLicenseKey)(promptOptions.license);
+            if (!isValidKey) {
+                spinner.fail("Invalid license key");
+                process.exit(0);
+            }
+            // Save the license key to the config file
+            if (!fs_1.default.existsSync(CONFIG_PATH)) {
+                const dirs = path.dirname(CONFIG_PATH);
+                fs_1.default.mkdirSync(dirs, { recursive: true });
+                fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify({ license: promptOptions.license }, null, 2));
+            }
+            const config = JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, "utf-8"));
+            if (config.license !== promptOptions.license) {
+                fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify({ license: promptOptions.license }, null, 2));
+            }
+        }
+        if (!isExistingProject) {
+            spinner.stop();
+            // If user didn't provide a project name, ask for it
+            if (!projectPath) {
+                const res = yield (0, prompts_1.default)({
+                    onState: onPromptState,
+                    type: "text",
+                    name: "path",
+                    message: "What is your project named?",
+                    initial: "untitled-ui",
+                });
+                if (typeof res.path === "string") {
+                    projectPath = res.path.trim();
+                }
+            }
+            // If the directory with the project name already exists,
+            // show an error message
+            if (fs_1.default.existsSync(path.resolve(projectPath))) {
+                spinner.fail(chalk_1.default.red("Directory already exists!"));
+                process.exit(1);
+            }
+            // If user didn't provide a template kit to start with, ask for it
+            if (!promptOptions.template) {
+                const res = yield (0, prompts_1.default)({
+                    type: "select",
+                    name: "template",
+                    onState: onPromptState,
+                    message: `Which ${chalk_1.default.cyan("starter kit")} would you like to use?`,
+                    choices: [
+                        {
+                            title: "default-template",
+                            value: DEFAULT_TEMPLATE,
+                        },
+                        {
+                            title: "basic-form",
+                            value: "basic-form",
+                        },
+                        {
+                            title: "magic-link",
+                            value: "magic-link",
+                        },
+                        {
+                            title: "next-intl",
+                            value: "next-intl",
+                        },
+                        {
+                            title: "otp",
+                            value: "otp",
+                        },
+                        {
+                            title: "react-hook-form",
+                            value: "react-hook-form",
+                        },
+                        {
+                            title: "with-stripe",
+                            value: "with-stripe",
+                        },
+                    ],
+                });
+                promptOptions.template = res.template;
+                if (PRIVATE_TEMPLATES.includes(promptOptions.template) && !promptOptions.license) {
+                    const res = yield (0, prompts_1.default)({
+                        type: "text",
+                        name: "license",
+                        onState: onPromptState,
+                        message: `Enter the license key to download the ${chalk_1.default.cyan(promptOptions.template)} template:`,
+                    });
+                    promptOptions.license = res.license;
+                    const isValidKey = yield (0, download_tar_api_1.checkLicenseKey)(res.license);
+                    if (!isValidKey) {
+                        spinner.fail("Invalid license key");
+                        process.exit(0);
+                    }
+                }
+            }
+            spinner.succeed("Template is selected: " + chalk_1.default.green(promptOptions.template));
+            // If project exists, but it's not a Next.js project, show an error message
+        }
+        else if ((info === null || info === void 0 ? void 0 : info.framework) === "other") {
+            spinner.fail("Unsupported project framework");
+            console.log(`Please refer to the documentation ${chalk_1.default.cyan("https://untitled.xyz/docs")} for supported frameworks or proceed with manual installation.`);
+            process.exit(1);
+        }
+        else {
+            spinner.succeed(chalk_1.default.yellow("Detected Next.js project, proceeding with the setup..."));
+        }
+        // If user didn't provide a color, ask for it
+        if (!promptOptions.color) {
+            const res = yield (0, prompts_1.default)({
+                type: "select",
+                name: "color",
+                onState: onPromptState,
+                initial: (_a = opts.color) !== null && _a !== void 0 ? _a : "",
+                message: `Which ${chalk_1.default.cyan("color")} would you like to use as the ${chalk_1.default.cyanBright("brand")} color?`,
+                choices: prefixes.map((prefix) => ({
+                    title: prefix,
+                    value: prefix,
+                })),
+            });
+            promptOptions.color = res.color;
+        }
+        // If the project is not an existing project, download the starter kit
+        if (projectPath && !isExistingProject) {
+            const appPath = path.resolve(projectPath);
+            console.log(`\nCreating a new project in ${chalk_1.default.blue(projectPath)}`);
+            const spinner = (0, ora_1.default)("Downloading and extracting the repository...").start();
+            try {
+                // Create the project directory
+                fs_1.default.mkdirSync(appPath, { recursive: true });
+                if (promptOptions.template === DEFAULT_TEMPLATE) {
+                    // Template folder path
+                    const templatePath = path.resolve(path.join(__dirname, "../../templates/", promptOptions.template));
+                    // Copy the template files to the project directory
+                    (0, install_template_1.copyTemplateFiles)(templatePath, appPath);
+                }
+                else {
+                    // Download and extract the repository, retry 2 times before failing
+                    // Always use the API-based download for both public and private repositories
+                    yield (0, async_retry_1.default)(() => (0, download_tar_api_1.downloadAndExtractRepoFromApi)(appPath, {
+                        username: "a-peak-works",
+                        repo: "starter-kits",
+                        branch: "master",
+                        template: promptOptions.template,
+                        key: promptOptions.license,
+                    }), {
+                        retries: 2,
+                    });
+                }
+                spinner.succeed("Files are downloaded and extracted successfully!");
+                const dependencies = (0, ora_1.default)({ text: "Installing dependencies..." }).start();
+                // Update the theme.css file with the selected color
+                // Starter kits always have the theme.css file in the
+                // src/styles directory
+                const newCssFilePath = fast_glob_1.default.sync(["**/styles/theme.css"], { cwd: appPath, absolute: true, onlyFiles: true })[0];
+                (0, update_color_css_1.updateCssFile)("brand", promptOptions.color, newCssFilePath);
+                // Install dependencies and initialize git, retry once if there is a peer dependency conflict
+                yield (0, async_retry_1.default)(() => (0, execa_1.execa)("sh", ["-c", `cd ${projectPath} && ${(0, get_pkg_manager_1.getPkgManager)()} install && git init`]).catch((e) => __awaiter(this, void 0, void 0, function* () {
+                    if (e.message.includes("peer")) {
+                        dependencies.warn("Dependency conflict detected. Retrying with --legacy-peer-deps...");
+                        dependencies.start("Installing dependencies with --legacy-peer-deps flag");
+                        // Retry with the --legacy-peer-deps flag
+                        yield (0, execa_1.execa)("sh", [
+                            "-c",
+                            `cd ${projectPath} && ${(0, get_pkg_manager_1.getPkgManager)() === "npm" ? "npm --legacy-peer-deps" : (0, get_pkg_manager_1.getPkgManager)()} install && git init`,
+                        ]);
+                    }
+                })), {
+                    retries: 1,
+                });
+                dependencies.succeed("Dependencies installed");
+                console.log(`\nYour project is ready, to get staretd run the following commands:\n\n cd ${chalk_1.default.cyan(projectPath)}\n ${chalk_1.default.cyan((0, get_pkg_manager_1.getPkgManager)())} run dev`);
+                process.exit(1);
+            }
+            catch (error) {
+                spinner.fail(chalk_1.default.red("\nFailed to download and extract the repository"));
+                // If there is an error, show the error message and exit the process
+                if (error instanceof Error) {
+                    console.error(error.message);
+                }
+                else {
+                    console.error("\n");
+                }
+                // Remove the project directory if the download and extraction fails
+                fs_1.default.rmdirSync(appPath, { recursive: true });
+                process.exit(0);
+            }
+        }
+        else {
+            const existingFiles = [];
+            const configFiles = (0, get_config_1.resolveConfigPaths)(cwd);
+            // Src dir in main repo where styles and plugins folder are located
+            const srcDir = path.join(path.resolve(__dirname, "../../../../"));
+            // Get all the files in the styles, plugins and public/fonts directories
+            const styleFiles = fast_glob_1.default.sync(["**/{styles,plugins}/**", "postcss.config.*", "**/public/fonts/**"], {
+                cwd: srcDir,
+                onlyFiles: true,
+                ignore: get_project_1.PROJECT_SHARED_IGNORE.filter((ignore) => !ignore.includes("public")),
+            });
+            // Get dependencies from the package.json file in the main repo
+            // and with the specified versions
+            const dependencies = (0, get_package_info_1.getDependenciesFromPackageJson)({
+                cwd: srcDir,
+                dependencies: [
+                    "tailwindcss",
+                    "tailwindcss-animate",
+                    "@tailwindcss/typography",
+                    "tailwindcss-react-aria-components",
+                    "@designbycode/tailwindcss-mask-image",
+                ],
+                devDependencies: ["@tailwindcss/postcss", "postcss"],
+            });
+            styleFiles.forEach((file) => {
+                // Filter out postcss and font files as they are one level above
+                // the src directory `root`/ and public/
+                const isPostCSSOrFont = file.includes("postcss.config") || file.includes("fonts");
+                const newFile = path.resolve(process.cwd(), isPostCSSOrFont ? file : `${(info === null || info === void 0 ? void 0 : info.isSrcDir) ? "src" : ""}/${file}`);
+                if (fs_1.default.existsSync(newFile)) {
+                    // Overwrite public/fonts files or if the user has specified to overwrite
+                    if (newFile.includes("public/fonts") || (promptOptions === null || promptOptions === void 0 ? void 0 : promptOptions.overwrite)) {
+                        fs_1.default.copyFileSync(path.resolve(srcDir, file), newFile);
+                    }
+                    else {
+                        existingFiles.push(path.relative(process.cwd(), newFile));
+                    }
+                    return;
+                }
+                // Create the directory if it doesn't exist
+                fs_1.default.mkdirSync(path.dirname(newFile), { recursive: true });
+                // Create an empty file
+                fs_1.default.writeFileSync(newFile, "");
+                // Copy the file from the main repo to the project directory
+                fs_1.default.copyFileSync(path.resolve(srcDir, file), newFile);
+            });
+            // If the files already exist in the project directory, show the user
+            // which files exist
+            if (existingFiles.length && !(promptOptions === null || promptOptions === void 0 ? void 0 : promptOptions.overwrite)) {
+                console.log("\n");
+                spinner.fail(`Following files already exist in the directory. Use ${chalk_1.default.cyan("--overwrite")} or ${chalk_1.default.cyan("-o")} to overwrite existing files, or refer to the documentation ${chalk_1.default.cyan("https://untitled.xyz/docs")} for manual installation.`);
+                existingFiles.forEach((file) => {
+                    console.log(`- ${chalk_1.default.green(file)}`);
+                });
+                process.exit(0);
+            }
+            // If tailwind config file exists, show the user how to add it to the globals.css file
+            if (configFiles === null || configFiles === void 0 ? void 0 : configFiles.tailwindFile) {
+                console.log("\nTailwind config file exists in the project directory. You can add it to your globals.css as follows:");
+                console.log(`\n${chalk_1.default.cyan(`@config "../${(info === null || info === void 0 ? void 0 : info.isSrcDir) && "../"}${path.relative(process.cwd(), configFiles.tailwindFile)}";`)}\n`);
+            }
+            // Main file in the project directory, it's either layout.tsx or _app.tsx
+            const mainFile = (configFiles === null || configFiles === void 0 ? void 0 : configFiles.layoutFile) || (configFiles === null || configFiles === void 0 ? void 0 : configFiles.appFile) || "";
+            // Create a new project instance with the tsconfig file
+            const project = new ts_morph_1.Project({
+                tsConfigFilePath: path.resolve((configFiles === null || configFiles === void 0 ? void 0 : configFiles.tsConfig) || ""),
+            });
+            const sourceFile = project.addSourceFileAtPath(path.resolve(mainFile));
+            // Remove the existing import declarations for the style files
+            // to avoid conflicts when updating the alias pathes
+            const stylesToRemove = ["colors.css", "globals.css", "inter.css", "text-styles.css", "theme.css", "typography.css"];
+            // If style files already exist, remove them to avoid conflicts
+            // when updating alias pathes
+            sourceFile
+                .getImportDeclarations()
+                .filter((importDeclaration) => stylesToRemove.includes(importDeclaration.getModuleSpecifierValue()))
+                .forEach((importDeclaration) => importDeclaration.remove());
+            //If not src alis path is used, we will update it to the correct path
+            // using dots
+            const pathsDeep = path.relative(path.resolve(process.cwd(), `${(info === null || info === void 0 ? void 0 : info.isSrcDir) && "src"}`), mainFile).split("/").length;
+            // Add the import declarations for the style files with the
+            // updated alias pathes
+            sourceFile.addImportDeclarations(styleFiles
+                .filter((file) => file.includes("styles"))
+                .map((file) => {
+                var _a, _b, _c;
+                return ({
+                    moduleSpecifier: `${((_a = info === null || info === void 0 ? void 0 : info.aliasPrefix) === null || _a === void 0 ? void 0 : _a.stylesPrefix) || ((_b = info === null || info === void 0 ? void 0 : info.aliasPrefix) === null || _b === void 0 ? void 0 : _b.srcPrefix) || "../".repeat(pathsDeep - 1)}${((_c = info === null || info === void 0 ? void 0 : info.aliasPrefix) === null || _c === void 0 ? void 0 : _c.stylesPrefix) ? file === null || file === void 0 ? void 0 : file.split("styles/")[1] : file}`,
+                });
+            }));
+            // Save the source file
+            sourceFile.saveSync();
+            const dependencySpinner = (0, ora_1.default)();
+            // Get the theme.css file from the project directory
+            const themeCssFile = fast_glob_1.default.sync(["**/styles/theme.css"], { cwd, absolute: true, onlyFiles: true, ignore: get_project_1.PROJECT_SHARED_IGNORE });
+            // If the theme.css file doesn't exist, show an error message
+            if (!(themeCssFile === null || themeCssFile === void 0 ? void 0 : themeCssFile.length))
+                return spinner.fail("Failed to copy theme.css file");
+            // Update the theme.css file with the selected color
+            (0, update_color_css_1.updateCssFile)("brand", promptOptions.color, (_b = themeCssFile[0]) !== null && _b !== void 0 ? _b : "");
+            // Install dependencies from the package.json file in the main repo
+            if (!dependencies) {
+                dependencySpinner.fail("Failed to get dependencies from package.json");
+                process.exit(1);
+            }
+            dependencySpinner.start("Installing dependencies");
+            // Run the package manager install command to install the dependencies
+            // and devDependencies
+            yield (0, execa_1.execa)((0, get_pkg_manager_1.getPkgManager)(), [(0, get_pkg_manager_1.getPkgManager)() === "npm" ? "install" : "add", ...dependencies.dependencies], {});
+            yield (0, execa_1.execa)((0, get_pkg_manager_1.getPkgManager)(), [(0, get_pkg_manager_1.getPkgManager)() === "npm" ? "install" : "add", "-D", ...dependencies.devDependencies], {});
+            dependencySpinner.succeed("Dependencies installed");
+            spinner.succeed(chalk_1.default.green("Files are extracted successfully!"));
+            console.log("\nYour project is ready, you can now start adding components.");
+            // Exit the process with a success status code
+            process.exit(1);
+        }
+    });
+}

package/dist/helper/download-tar-api.js

@@ -0,0 +1,129 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAndExtractRepoFromApi = downloadAndExtractRepoFromApi;
+exports.downloadTarStream = downloadTarStream;
+exports.checkLicenseKey = checkLicenseKey;
+const node_path_1 = require("node:path");
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
+const tar_1 = require("tar");
+const config_json_1 = __importDefault(require("../res/config.json"));
+/**
+ * Downloads and extracts the tarball from the returned tarball stream
+ * @param root - The main root directory where the tarball should be extracted
+ * @param info - The repository information required for downloading the tarball
+ */
+function downloadAndExtractRepoFromApi(root, info) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // Convert the web ReadableStream to a Node.js ReadableStream
+            const stream = yield downloadTarStream(info);
+            yield (0, promises_1.pipeline)(stream, (0, tar_1.x)({
+                cwd: root, // directory to extract files into
+                strip: 2, // how many path segments to remove (depends on the tar structure)
+                filter: (p) => {
+                    // Normalize paths to POSIX format for consistency
+                    const posixPath = p.split(node_path_1.sep).join(node_path_1.posix.sep);
+                    // Extract only files that include the specified template name
+                    return posixPath.includes(info.template || "basic-form");
+                },
+            }));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                // Provide more context about the error
+                throw new Error(`Failed to download or extract repository from API: ${error.message}`);
+            }
+            throw error;
+        }
+    });
+}
+/**
+ * Fetches the tarball from api endpoint and returns a readable stream of the tarball contents.
+ * Works for both public and private repositories, using a license key when provided.
+ *
+ * @param info - The repository information required for downloading the tarball.
+ * @returns A readable stream of the tarball contents.
+ * @throws Will throw an error if the fetch request fails or if there is no response body.
+ */
+function downloadTarStream(info) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Construct the endpoint with the license
+        const apiUrl = `${config_json_1.default.api_url}/download-repo`;
+        try {
+            // Create a copy of the info to send to the API
+            const requestInfo = Object.assign({}, info);
+            // Fetch the tar.gz from the server's /download route
+            const response = yield fetch(apiUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "application/octet-stream",
+                },
+                body: JSON.stringify(requestInfo),
+            });
+            // Throw an error if authentication failed (only relevant when a license key is provided)
+            if (response.status === 403 || response.status === 404) {
+                throw new Error(info.key ? "License key is invalid or expired" : "Repository not found");
+            }
+            // Throw an error if the response isn't OK
+            if (!response.ok) {
+                throw new Error(`Failed to download from API. Status: ${response.status} ${response.statusText}`);
+            }
+            // Throw an error if there's no body
+            if (!response.body) {
+                throw new Error("Response body is empty");
+            }
+            // Verify content type if available
+            const contentType = response.headers.get("content-type");
+            if (contentType &&
+                !contentType.includes("application/x-gzip") &&
+                !contentType.includes("application/octet-stream") &&
+                !contentType.includes("application/tar+gzip")) {
+                console.warn(`Warning: Unexpected content type: ${contentType}. Expected tar/gzip related content.`);
+            }
+            // Convert the web ReadableStream to a Node.js ReadableStream
+            return node_stream_1.Readable.fromWeb(response.body);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error("Unknown error occurred while downloading the tarball");
+        }
+    });
+}
+/**
+ * Checks if the license key is valid by sending a request to the server.
+ *
+ * @param key - The license key to be validated by the server
+ * @returns A boolean indicating whether the license key is valid
+ */
+function checkLicenseKey(key) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const apiUrl = `${config_json_1.default.api_url}/validate-key?key=${key}`;
+        try {
+            // Fetch the tar.gz from the server's /download route
+            const response = yield fetch(apiUrl);
+            if (response.status !== 200) {
+                return false;
+            }
+            return true;
+        }
+        catch (e) {
+            return false;
+        }
+    });
+}

package/dist/helper/download-tar.js

@@ -0,0 +1,81 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAndExtractRepo = downloadAndExtractRepo;
+exports.downloadTarStream = downloadTarStream;
+const node_path_1 = require("node:path");
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
+const tar_1 = require("tar");
+/**
+ * Downloads and extracts a GitHub repository tarball to the specified directory.
+ *
+ * @param root - The local directory where the repository should be extracted.
+ * @param repoInfo - An object containing repository details such as username, name, and branch.
+ * @throws Will throw an error if the download fails.
+ */
+function downloadAndExtractRepo(root_1, _a) {
+    return __awaiter(this, arguments, void 0, function* (root, { username, repo, branch, template = "basic-form" }) {
+        try {
+            const url = `https://codeload.github.com/${username}/${repo}/tar.gz/${branch}`;
+            const stream = yield downloadTarStream(url);
+            yield (0, promises_1.pipeline)(
+            // Fetch and stream the tar.gz archive from GitHub
+            stream, 
+            // Extract only the necessary files matching the template name
+            (0, tar_1.x)({
+                cwd: root, // Extract into the specified root directory
+                strip: 2, // Remove first two path segments to keep only relevant files
+                filter: (p) => {
+                    // Normalize paths to POSIX format for consistency
+                    const posixPath = p.split(node_path_1.sep).join(node_path_1.posix.sep);
+                    // Extract only files that include the specified template name
+                    return posixPath.includes(template);
+                },
+            }));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                // Provide more context about the error
+                throw new Error(`Failed to download or extract repository: ${error.message}`);
+            }
+            throw error;
+        }
+    });
+}
+/**
+ * Downloads a repository tarball as a readable stream from a given URL.
+ *
+ * @param url - The URL to the tarball file.
+ * @returns A readable stream of the tarball contents.
+ * @throws Will throw an error if the fetch request fails or if there is no response body.
+ */
+function downloadTarStream(url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Fetch the tarball file from GitHub
+        const res = yield fetch(url);
+        // Check if the response is successful
+        if (!res.ok) {
+            throw new Error(`Failed to download: ${url} - Status: ${res.status} ${res.statusText}`);
+        }
+        // Ensure the response body exists before proceeding
+        if (!res.body) {
+            throw new Error(`Failed to download: ${url} - No response body`);
+        }
+        // Verify content type if available
+        const contentType = res.headers.get("content-type");
+        if (contentType && !contentType.includes("application/x-gzip") && !contentType.includes("application/octet-stream")) {
+            console.warn(`Warning: Unexpected content type: ${contentType}. Expected application/x-gzip or application/octet-stream.`);
+        }
+        // Convert the web ReadableStream to a Node.js ReadableStream
+        return node_stream_1.Readable.fromWeb(res.body);
+    });
+}

package/dist/helper/find-css-file.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findCssFile = findCssFile;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const get_project_1 = require("./get-project");
+/**
+ * Searches for a CSS file named `theme.css` in the project directory and
+ * returns it.
+ *
+ * @param cwd - The current working directory where the search should begin.
+ * @returns The absolute path of the `theme.css` file if found, otherwise `null`.
+ */
+function findCssFile(cwd) {
+    const files = fast_glob_1.default.sync("**/**/theme.css", { onlyFiles: true, absolute: true, cwd, ignore: get_project_1.PROJECT_SHARED_IGNORE });
+    return files.length ? files[0] : null;
+}