@fernir2/saas-kit-cli 0.1.16 → 0.1.18

package/cli/bin/index.ts

@@ -1,359 +0,0 @@
-#!/usr/bin/env node
-
-import { execSync } from "child_process";
-import { promises as fsPromises, existsSync, mkdirSync, rmSync, Stats } from "fs";
-import { fileURLToPath } from "node:url";
-import * as path from "path";
-import fs from "node:fs";
-
-import {
-    toolsFoldersToReplace,
-    additionalFoldersToCreate,
-} from "@packages/base-repo/constants/create-app-constants";
-
-import { logStringError, logInfoRaw } from "@packages/level2/fd-toolbox/logging/loggers";
-
-import { WithIndexer } from "@packages/level2/fd-toolbox-core/types/with-indexer";
-
-import { projectName } from "@packages/level2/fd-toolbox/constants/constants";
-
-import { allFilesToCopy } from "@packages/level2/npm-commands/build-npm/path";
-
-import { createError } from "@packages/level2/fd-toolbox/errors/errors";
-
-import { folders } from "@packages/base-repo/app-constants/project-paths";
-
-import { npmPackages } from "@packages/base-repo/constants/packages";
-
-import { aliasSymbols } from "@packages/base-repo/app-constants/aliases";
-
-import { isString, isWithIndexer } from "@packages/level2/fd-toolbox/types/ensure-type";
-
-interface PackageJson {
-    name?: string;
-    dependencies?: WithIndexer<string>;
-    devDependencies?: WithIndexer<string>;
-    [key: string]: unknown;
-}
-
-interface FileEntry {
-    name: string;
-    isDirectory(): boolean;
-}
-
-const requiredNodeVersion = "v18.0.0";
-
-if (process.version < requiredNodeVersion) {
-    logStringError(`Node.js ${requiredNodeVersion}+ is required`);
-    process.exit(1);
-}
-
-const filename = fileURLToPath(import.meta.url);
-const dir = path.dirname(filename);
-const repoRoot = path.resolve(dir, "..");
-const saasKitRoot = path.resolve(dir, "@../..");
-
-const envLocalPath: string = path.join(dir, `../${folders.cli}/.env`);
-const envTemplate: string = fs.readFileSync(envLocalPath, "utf8");
-
-const foldersToIgnore: string[] = [`${folders.cli}/constants`];
-
-function runCommand(command: string, cwd?: string) {
-    logInfoRaw(`Executing: ${command}`);
-
-    try {
-        execSync(command, { stdio: "inherit", cwd: cwd ?? process.cwd() });
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        logStringError(`Error executing: ${command}`);
-        logStringError(errorMessage);
-        process.exit(1);
-    }
-}
-
-function checkTargetFolder(targetDir: string) {
-    if (existsSync(targetDir)) {
-        logStringError(`Error: Folder "${path.basename(targetDir)}" already exists.`);
-        process.exit(1);
-    }
-}
-
-function getCreateNextAppVersion() {
-    const packageJsonPath: string = path.resolve(saasKitRoot, "package.json");
-    const packageJson: PackageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-
-    return String(packageJson.devDependencies?.["next"] ?? packageJson.dependencies?.["next"] ?? "latest");
-}
-
-function createNextProject(projectTitle: string, targetDir: string) {
-    logInfoRaw("Creating Next.js project...");
-
-    const createNextAppVersion = getCreateNextAppVersion();
-    const createCommand: string = [
-        `npx create-next-app@${createNextAppVersion} "${projectTitle}"`,
-        "--typescript",
-        "--tailwind",
-        "--eslint",
-        "--app",
-        "--src-dir",
-        "--turbopack",
-        "--no-import-alias",
-        "--no-git",
-    ].join(" ");
-
-    runCommand(createCommand, path.dirname(targetDir));
-    logInfoRaw("Next.js project created!");
-}
-
-async function createEnvFile(targetDir: string) {
-    logInfoRaw("Creating .env file with default values...");
-
-    const envPath: string = path.join(targetDir, ".env");
-
-    try {
-        await fsPromises.writeFile(envPath, envTemplate, "utf8");
-        logInfoRaw(".env file created with values!");
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        logStringError("Error creating .env file:");
-        logStringError(errorMessage);
-        throw error;
-    }
-}
-
-async function overridePackageJson(targetDir: string) {
-    const targetPackageJsonPath: string = path.join(targetDir, "package.json");
-    // "name" is omitted in package.json; renamed to package-template.json so NX ignores it as a project.
-    const cliPackageJsonPath: string = path.join(repoRoot, `${folders.cli}/package-template.json`);
-
-    try {
-        const targetPackageJson: PackageJson = JSON.parse(
-            await fsPromises.readFile(targetPackageJsonPath, "utf8"),
-        );
-        const name = targetPackageJson.name;
-
-        const cliPackageJson: PackageJson = JSON.parse(await fsPromises.readFile(cliPackageJsonPath, "utf8"));
-
-        const finalPackageJson: PackageJson = {
-            ...cliPackageJson,
-            name: name,
-        };
-
-        await fsPromises.writeFile(
-            targetPackageJsonPath,
-            `${JSON.stringify(finalPackageJson, null, 2)}\n`,
-            "utf8",
-        );
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        logStringError("Error overriding package.json:");
-        logStringError(errorMessage);
-        throw error;
-    }
-}
-
-function replaceImports(content: string) {
-    // Approved
-    // eslint-disable-next-line sonarjs/slow-regex
-    const importRegex = /(import\s+[^'"]*from\s+["'])([^"']+)(["'])/g;
-
-    return content.replace(importRegex, (match, p1, importPath, p3) => {
-        if (!importPath.startsWith(aliasSymbols.atSign) || importPath.startsWith(npmPackages.saasKit)) {
-            return match;
-        }
-
-        if (
-            importPath.startsWith(aliasSymbols.atSign + folders.server) ||
-            importPath.includes(`/${folders.server}/`)
-        ) {
-            return `${p1}${npmPackages.saasKitServer}${p3}`;
-        }
-
-        return `${p1}${npmPackages.saasKit}${p3}`;
-    });
-}
-
-async function copyProjectFiles(targetDir: string) {
-    logInfoRaw(`Copying ${projectName} files...`);
-
-    for (const file of allFilesToCopy) {
-        const cliFile = `${folders.cli}/${file}`;
-        const srcPath: string = path.join(repoRoot, cliFile);
-
-        const processedFile = replaceToolsFolder(file);
-
-        const destPath: string = path.join(targetDir, processedFile);
-
-        if (existsSync(srcPath)) {
-            const stats: Stats = await fsPromises.stat(srcPath);
-
-            if (stats.isDirectory()) {
-                await copyDirectoryContents(srcPath, destPath);
-            } else {
-                await copyAndProcessFile(srcPath, destPath);
-            }
-        } else {
-            logInfoRaw(`Source file not found: ${cliFile}`);
-        }
-    }
-
-    logInfoRaw("Files copied and imports updated!");
-}
-
-function replaceToolsFolder(file: string) {
-    let processedFile = file;
-
-    for (const [folderPrefix, replacements] of Object.entries(toolsFoldersToReplace)) {
-        if (processedFile.startsWith(folderPrefix) && isWithIndexer<string>(replacements)) {
-            const typedReplacements: WithIndexer<string> = replacements;
-
-            for (const key in typedReplacements) {
-                const value = typedReplacements[key];
-
-                if (isString(value)) {
-                    processedFile = processedFile.replace(key, value);
-                }
-            }
-
-            break;
-        }
-    }
-
-    return processedFile;
-}
-
-function shouldIgnorePath(filePath: string, basePath: string, isDirectory = false) {
-    const relativePath = path.relative(basePath, filePath);
-    const pathParts = relativePath.split(path.sep);
-
-    const relativeFromRepo = path.relative(repoRoot, filePath).replace(/\\/g, "/");
-
-    return (
-        (isDirectory && foldersToIgnore.includes(relativeFromRepo)) ||
-        foldersToIgnore.some((ignoreFolder) => pathParts.some((part) => part === ignoreFolder))
-    );
-}
-
-async function copyDirectoryContents(srcDir: string, destDir: string) {
-    if (!existsSync(destDir)) {
-        mkdirSync(destDir, { recursive: true });
-    }
-
-    try {
-        const entries: FileEntry[] = await fsPromises.readdir(srcDir, { withFileTypes: true });
-
-        for (const entry of entries) {
-            const srcPath: string = path.join(srcDir, entry.name);
-            const destPath: string = path.join(destDir, entry.name);
-
-            if (!shouldIgnorePath(srcPath, srcDir, entry.isDirectory())) {
-                if (entry.isDirectory()) {
-                    await copyDirectoryContents(srcPath, destPath);
-                } else {
-                    await copyAndProcessFile(srcPath, destPath);
-                }
-            }
-        }
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        logStringError(`Error reading directory ${srcDir}: ${errorMessage}`);
-        throw error;
-    }
-}
-
-async function copyAndProcessFile(srcPath: string, destPath: string) {
-    const destDir: string = path.dirname(destPath);
-
-    if (!existsSync(destDir)) {
-        mkdirSync(destDir, { recursive: true });
-    }
-
-    const stats: Stats = await fsPromises.stat(srcPath);
-
-    if (stats.isDirectory()) {
-        await copyDirectoryContents(srcPath, destPath);
-    } else {
-        const content: string = await fsPromises.readFile(srcPath, "utf8");
-        const processedContent: string = replaceImports(content);
-        await fsPromises.writeFile(destPath, processedContent, "utf8");
-    }
-}
-
-function createAdditionalFolders(targetDir: string) {
-    for (const folder of additionalFoldersToCreate) {
-        const folderPath: string = path.join(targetDir, folder);
-
-        if (!existsSync(folderPath)) {
-            mkdirSync(folderPath, { recursive: true });
-            logInfoRaw(`Created folder: ${folder}`);
-        }
-    }
-
-    logInfoRaw("Additional folders created!");
-}
-
-async function main() {
-    const args: string[] = process.argv.slice(2);
-
-    if (args.length < 1) {
-        logStringError("Error: Specify folder name. Example: npx create-saas-kit-app <folder-name>");
-        process.exit(1);
-    }
-
-    const folderName: string = args[0];
-    const targetDir: string = path.resolve(process.cwd(), folderName);
-
-    logInfoRaw(`\nCreating ${projectName} project "${folderName}"...\n`);
-
-    try {
-        checkTargetFolder(targetDir);
-        createNextProject(folderName, targetDir);
-        await copyProjectFiles(targetDir);
-        await overridePackageJson(targetDir);
-        createAdditionalFolders(targetDir);
-        await createEnvFile(targetDir);
-        await updateLayoutTitle(targetDir, folderName);
-
-        logInfoRaw(`\n${projectName} project "${folderName}" is ready!`);
-        logInfoRaw("Next steps:");
-        logInfoRaw(`  cd ${folderName}`);
-        logInfoRaw("  npm run prod");
-        logInfoRaw("  npm start");
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Unknown error";
-        logStringError("Error:");
-        logStringError(errorMessage);
-
-        if (existsSync(targetDir)) {
-            logInfoRaw("Cleaning up...");
-            rmSync(targetDir, { recursive: true, force: true });
-        }
-
-        process.exit(1);
-    }
-}
-
-async function updateLayoutTitle(targetDir: string, folderName: string) {
-    const layoutPath = path.join(targetDir, "src/app/layout.tsx");
-
-    if (!existsSync(layoutPath)) {
-        throw createError(`layout.tsx not found at ${layoutPath}, cannot update title.`);
-    }
-
-    let content = await fsPromises.readFile(layoutPath, "utf8");
-    const titleRegex = /"SaaS Kit"/g;
-
-    if (!titleRegex.test(content)) {
-        throw createError("SaaS Kit not found in layout.tsx, cannot update title.");
-    }
-
-    content = content.replace(titleRegex, `"${folderName}"`);
-    await fsPromises.writeFile(layoutPath, content, "utf8");
-}
-
-main().catch((error) => {
-    const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    logStringError("Unhandled error:");
-    logStringError(errorMessage);
-    process.exit(1);
-});

package/cli/constants/path.js

@@ -1,54 +0,0 @@
-import { projectPaths, clientPaths } from "../../packages/base-repo/app-constants/project-paths.js";
-export const filesToCopy = ["", "git"];
-export const rootFilesToCopy = [
-    ".gitignore",
-    ".gitlab-ci.yml",
-    "postcss.config.mjs",
-    "tsconfig.declaration.json",
-    "README.md",
-    ".husky",
-    "server.ts",
-];
-export const appFilesToCopy = [
-    clientPaths.styles,
-    `${projectPaths.app}/favicon.ico`,
-    `${projectPaths.app}/globals.css`,
-    `${projectPaths.app}/layout.tsx`,
-    `${projectPaths.app}/page.tsx`,
-];
-export const apiRoutesToCopy = [
-    `${projectPaths.apiV1}/searchable-resources/route.ts`,
-    `${projectPaths.apiV1}/searchresult/route.ts`,
-    `${projectPaths.apiV1}/workspace/change/route.ts`,
-    `${projectPaths.apiV1}/visible-workspace/route.ts`,
-    `${projectPaths.apiV1}/userpermission/route.ts`,
-    `${projectPaths.apiV1}/user-feature/is-enabled/route.ts`,
-    `${projectPaths.apiV1}/uimetas/route.ts`,
-    `${projectPaths.apiV1}/uimeta/route.ts`,
-    `${projectPaths.apiV1}/subscription/update/route.ts`,
-    `${projectPaths.apiV1}/subscription/create/route.ts`,
-    `${projectPaths.apiV1}/subscription/cancel/route.ts`,
-    `${projectPaths.apiV1}/sign-up/route.ts`,
-    `${projectPaths.apiV1}/sign-out/route.ts`,
-    `${projectPaths.apiV1}/sign-in/route.ts`,
-    `${projectPaths.apiV1}/preload/route.ts`,
-    `${projectPaths.apiV1}/payment/route.ts`,
-    `${projectPaths.apiV1}/payment/verify-success/route.ts`,
-    `${projectPaths.apiV1}/payment/verify-fail/route.ts`,
-    `${projectPaths.apiV1}/payment/method/route.ts`,
-    `${projectPaths.apiV1}/password/resetpassword/route.ts`,
-    `${projectPaths.apiV1}/password/forgotpassword/route.ts`,
-    `${projectPaths.apiV1}/otheruser/route.ts`,
-    `${projectPaths.apiV1}/otheruser/[id]/route.ts`,
-    `${projectPaths.apiV1}/log/route.ts`,
-    `${projectPaths.apiV1}/blob/[filename]/route.ts`,
-    `${projectPaths.apiV1}/[resourceName]/route.ts`,
-    `${projectPaths.apiV1}/[resourceName]/upsert/route.ts`,
-    `${projectPaths.apiV1}/[resourceName]/[id]/route.ts`,
-];
-export const allFilesToCopy = [
-    ...filesToCopy,
-    ...rootFilesToCopy,
-    ...appFilesToCopy,
-    ...apiRoutesToCopy,
-];

package/cli/drizzle.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from "drizzle-kit";
-import { getRequiredStringEnvSetting, generatedPaths, metaEnvSettingKeys } from "@fernir2/saas-kit";
-
-const connectionString = getRequiredStringEnvSetting(metaEnvSettingKeys.databaseConnection);
-
-export default defineConfig({
-    dialect: "postgresql",
-    schema: generatedPaths.schema,
-    dbCredentials: {
-        url: connectionString,
-    },
-});

package/cli/eslint.config.js

@@ -1,10 +0,0 @@
-import { baseConfig } from "@fernir2/saas-kit";
-
-const config = [
-    ...baseConfig,
-    {
-        ignores: ["src/models/*"],
-    },
-];
-
-export default config;

package/cli/global-setup.ts

@@ -1,25 +0,0 @@
-import { test as base, PlaywrightTestArgs, PlaywrightWorkerArgs, TestType } from "playwright/test";
-import { initInternalResourceMetasCacheFromJson } from "@fernir2/saas-kit/server";
-import { toolboxEnvSettingKeys } from "@fernir2/saas-kit";
-
-export type WorkerArgs = PlaywrightWorkerArgs & { metaInitialized: void };
-export type TestArgs = PlaywrightTestArgs;
-
-export const test: TestType<TestArgs, WorkerArgs> = base.extend({
-    metaInitialized: [
-        // Approved
-        // eslint-disable-next-line no-empty-pattern
-        async ({}, use: () => Promise<void>) => {
-            await initInternalResourceMetasCacheFromJson();
-            await use();
-        },
-        { scope: "worker", auto: true },
-    ],
-});
-
-export const expect = test.expect;
-
-export default async function globalSetup() {
-    process.env[toolboxEnvSettingKeys.appEnv] = "test";
-    await initInternalResourceMetasCacheFromJson();
-}

package/cli/next.config.js

@@ -1,55 +0,0 @@
-import { execSync } from "child_process";
-import { folders } from "@fernir2/saas-kit";
-
-const nextConfig = {
-    webpack: (config, { isServer }) => {
-        if (isServer) {
-            config.watchOptions = {
-                ignored: [
-                    `**/${folders.nodeModules}/**`,
-                    `**/${folders.next}/**`,
-                    `**/${folders.npmCommands}/**`,
-                ],
-            };
-            config.externals.push({
-                "@node-rs/argon2": "commonjs @node-rs/argon2",
-                "cloudflare:sockets": "commonjs cloudflare:sockets",
-                "node:crypto": "commonjs node:crypto",
-                "node:fs": "commonjs node:fs",
-                "node:path": "commonjs node:path",
-                "node:stream": "commonjs node:stream",
-                child_process: "commonjs2 child_process",
-            });
-            config.module.rules.push({
-                test: /\.html$/,
-                use: "raw-loader",
-            });
-        }
-        config.module.rules.push({
-            test: /\.md$/,
-            use: "ignore-loader",
-        });
-        return config;
-    },
-    async rewrites() {
-        return [
-            {
-                source: "/api/:path*",
-                destination: "/api/v1/:path*",
-            },
-        ];
-    },
-    redirects() {
-        return [
-            {
-                source: "/",
-                destination: "/sign-in",
-                permanent: false,
-            },
-        ];
-    },
-};
-
-nextConfig.cacheMaxMemorySize = 4096;
-
-export default nextConfig;

package/cli/npm-commands/gen-meta/index.ts

@@ -1,3 +0,0 @@
-import { combineMeta } from "@fernir2/saas-kit";
-
-combineMeta();

package/cli/npm-commands/gen-schema/index.ts

@@ -1,5 +0,0 @@
-import { join } from "path";
-import { generateSchema, generatedPaths } from "@fernir2/saas-kit";
-
-const schemaPath = join(process.cwd(), generatedPaths.schema).replaceAll("\\", "/");
-await generateSchema(schemaPath);

package/cli/npm-commands/migrate-db/index.ts

@@ -1,5 +0,0 @@
-import { runCommand } from "@fernir2/saas-kit";
-
-export async function migrateDb() {
-    await runCommand("migrate-db");
-}

package/cli/npm-commands/migrate-db/migrate-db.ts

@@ -1,15 +0,0 @@
-import { migrateDatabase, logInfo } from "@fernir2/saas-kit/server";
-
-async function migrate() {
-    try {
-        await migrateDatabase();
-        logInfo("Database migrations executed successfully");
-        process.exit(0);
-    } catch (err) {
-        if (err instanceof Error) console.error("Error running migrations", err);
-
-        process.exit(1);
-    }
-}
-
-migrate();

package/cli/npm-commands/seed-db/index.ts

@@ -1,5 +0,0 @@
-import { runCommand } from "@fernir2/saas-kit";
-
-export async function seedDb() {
-    await runCommand("seed-db");
-}

package/cli/npm-commands/seed-db/seed-db.ts

@@ -1,15 +0,0 @@
-import { seedDatabase, logInfo } from "@fernir2/saas-kit/server";
-
-async function seed() {
-    try {
-        await seedDatabase();
-        logInfo("Database seeded successfully");
-        process.exit(0);
-    } catch (err) {
-        if (err instanceof Error) console.error("Error seeding database", err);
-
-        process.exit(1);
-    }
-}
-
-seed();

package/cli/package-template.json

@@ -1,61 +0,0 @@
-{
-    "version": "0.1.0",
-    "private": true,
-    "type": "module",
-    "scripts": {
-        "dev": "npx tsx --tsconfig tsconfig.server.json server.ts",
-        "build": "next build && tsc --project tsconfig.server.json",
-        "lint": "eslint -c eslint.config.js",
-        "gen-schema": "npx tsx tools/npm-commands/gen-schema/index.ts",
-        "gen-meta": "npx tsx tools/npm-commands/gen-meta/index.ts",
-        "init-db": "npm run migrate-db && npm run seed-db",
-        "setup": "npm run gen-meta && npm run gen-schema && npm run init-db",
-        "start": "npm run setup && npm run dev",
-        "prod": "npm run setup && npm run build && npx tsx server.ts",
-        "migrate-db": "npx tsx tools/npm-commands/migrate-db/index.ts",
-        "seed-db": "npx tsx tools/npm-commands/seed-db/index.ts"
-    },
-    "dependencies": {
-        "@fernir2/saas-kit": "0.0.144",
-        "@node-rs/argon2": "2.0.2",
-        "drizzle-orm": "0.41.0",
-        "eslint-plugin-github": "6.0.0",
-        "eslint-plugin-import": "2.32.0",
-        "eslint-plugin-sonarjs": "3.0.5",
-        "geist": "1.3.1",
-        "next": "15.4.5",
-        "quill": "2.0.3",
-        "react": "18",
-        "react-dom": "18",
-        "socket.io-client": "4.8.1",
-        "tailwindcss-animate": "1.0.7"
-    },
-    "devDependencies": {
-        "playwright": "1.52.0",
-        "@eslint/eslintrc": "3.3.1",
-        "@eslint/js": "9.35.0",
-        "@types/node": "24.5.1",
-        "@types/react": "18",
-        "@types/react-dom": "18",
-        "@typescript-eslint/eslint-plugin": "8.43.0",
-        "@typescript-eslint/eslint-plugin-tslint": "7.0.2",
-        "@typescript-eslint/parser": "8.43.0",
-        "drizzle-kit": "0.28.1",
-        "eslint": "9.35.0",
-        "eslint-config-next": "15.5.2",
-        "eslint-config-prettier": "9.1.0",
-        "eslint-plugin-react": "7.37.5",
-        "eslint-plugin-react-compiler": "19.1.0-rc.2",
-        "eslint-plugin-react-hooks": "5.2.0",
-        "eslint-plugin-react-refresh": "0.4.20",
-        "eslint-plugin-tailwindcss": "3.18.2",
-        "husky": "9.1.7",
-        "postcss": "8",
-        "prettier": "3.6.2",
-        "prettier-plugin-tailwindcss": "0.6.14",
-        "tailwindcss": "3.4.1",
-        "tsx": "4.19.1",
-        "typescript": "5.9.2",
-        "esbuild": "0.19.12"
-    }
-}

package/cli/playwright.config.ts

@@ -1,34 +0,0 @@
-import { defineConfig, devices } from "playwright/test";
-import { getDotenvConfig } from "@fernir2/saas-kit";
-
-getDotenvConfig();
-
-const baseUrl = "http://localhost:8080/";
-
-export default defineConfig({
-    timeout: 120000,
-    testDir: "test/",
-    fullyParallel: true,
-    globalSetup: "./global-setup.ts",
-    workers: undefined,
-    reporter: "html",
-    use: {
-        baseURL: baseUrl,
-        trace: "on-first-retry",
-    },
-    projects: [
-        {
-            name: "chromium",
-            use: { ...devices["Desktop Chrome"] },
-        },
-    ],
-    webServer: {
-        command: "npm run prod",
-        url: baseUrl,
-        reuseExistingServer: true,
-        timeout: 120000,
-        env: {
-            NODE_ENV: "test",
-        },
-    },
-});

package/cli/postcss.config.mjs

@@ -1,9 +0,0 @@
-/** @type {import('postcss-load-config').Config} */
-const config = {
-    plugins: {
-        tailwindcss: {},
-        autoprefixer: {},
-    },
-};
-
-export default config;