@reliverse/dler 1.7.91 → 1.7.93

package/bin/app/mrse/mrse-impl.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Determines if we log additional debug info.
+ * Set to `true` for verbose output.
+ */
+export declare const mrseVerbose = false;
+/**
+ * Helper to conditionally log verbose messages based on `mrseVerbose`.
+ * @param msg - The message to log.
+ * @param data - Optional additional data to log.
+ */
+export declare function logVerbose(msg: string, data?: unknown): void;
+/**
+ * Configuration data for a single project.
+ */
+export interface GenCfg {
+    projectName: string;
+    projectTemplate: string;
+    getEnvExample: boolean;
+    projectPath?: string;
+}
+/**
+ * Shape of the JSONC config file (wrapper around GenCfg[]).
+ */
+export interface GenCfgJsonc {
+    genCfg: GenCfg[];
+}
+/**
+ * Gets the path to the env cache directory (used for storing .env.example files).
+ * @returns Absolute path to the `.reliverse/envs` directory.
+ */
+export declare function getEnvCacheDir(): string;
+/**
+ * Ensures the env cache directory exists (creates if necessary).
+ * @returns The cache directory path.
+ */
+export declare function ensureEnvCacheDir(): Promise<string>;
+/**
+ * Builds the full cache file path for a repository's `.env.example` file.
+ * @param repo - Owner/repo string.
+ * @param branch - The git branch (defaults to "main").
+ * @returns The absolute path to the cached `.env.example` file.
+ */
+export declare function getEnvCachePath(repo: string, branch?: string): string;
+/**
+ * Downloads a `.env.example` file from a GitHub repository with optional caching.
+ * @param repo - The owner/repo string (e.g., "username/repo").
+ * @param filePath - The file path within the repo (usually ".env.example").
+ * @param branch - The git branch to use. Defaults to "main".
+ * @param useCache - Whether to use local caching. Defaults to true.
+ * @param useFresh - If true, bypasses existing cache. Defaults to false.
+ * @returns The file content as a string, or null if download fails.
+ */
+export declare function downloadFileFromGitHub(repo: string, filePath: string, branch?: string, useCache?: boolean, useFresh?: boolean): Promise<string | null>;

package/bin/app/mrse/mrse-impl.js

@@ -0,0 +1,132 @@
+import path from "@reliverse/pathkit";
+import fs, { ensuredir } from "@reliverse/relifso";
+import { relinka } from "@reliverse/relinka";
+import { confirmPrompt } from "@reliverse/rempts";
+import { getOrCreateRseConfig } from "../config/cfg-core.js";
+import { homeDir } from "../config/constants.js";
+import { initGithubSDK } from "../utils/instanceGithub.js";
+import { askUsernameFrontend } from "../utils/prompts/askUsernameFrontend.js";
+import { getOrCreateReliverseMemory } from "../utils/reliverseMemory.js";
+export const mrseVerbose = false;
+export function logVerbose(msg, data) {
+  if (mrseVerbose) {
+    console.log(`Debug - ${msg}`, data ?? "");
+  }
+}
+export function getEnvCacheDir() {
+  return path.join(homeDir, ".reliverse", "envs");
+}
+export async function ensureEnvCacheDir() {
+  const cacheDir = getEnvCacheDir();
+  await ensuredir(cacheDir);
+  return cacheDir;
+}
+export function getEnvCachePath(repo, branch = "main") {
+  const cacheDir = getEnvCacheDir();
+  const safeRepoName = repo.replace(/[/\\:]/g, "_");
+  return path.join(cacheDir, `${safeRepoName}_${branch}.env.example`);
+}
+export async function downloadFileFromGitHub(repo, filePath, branch = "main", useCache = true, useFresh = false) {
+  if (useCache && !useFresh) {
+    const cachePath = getEnvCachePath(repo, branch);
+    const cacheExists = await fs.pathExists(cachePath);
+    if (cacheExists) {
+      const stats = await fs.stat(cachePath);
+      const fileAge = Date.now() - stats.mtimeMs;
+      const oneDayMs = 24 * 60 * 60 * 1e3;
+      if (fileAge < oneDayMs) {
+        logVerbose(`Using cached .env.example for ${repo} (${branch}).`);
+        return fs.readFile(cachePath, "utf-8");
+      }
+    }
+  }
+  let repoOwner = "";
+  let repoName = "";
+  try {
+    if (repo.includes("/")) {
+      const repoParts = repo.split("/");
+      if (repoParts.length !== 2) {
+        throw new Error(`Invalid repository format: "${repo}". Expected format: "owner/repo".`);
+      }
+      repoOwner = repoParts[0];
+      repoName = repoParts[1];
+    }
+    const maskInput = await confirmPrompt({
+      title: "Do you want to mask secret inputs (e.g., GitHub token) in the next steps?",
+      content: "Regardless of your choice, your data will be securely stored on your device."
+    });
+    const memory = await getOrCreateReliverseMemory();
+    const { config } = await getOrCreateRseConfig({
+      projectPath: process.cwd(),
+      isDev: false,
+      overrides: {}
+    });
+    const frontendUsername = await askUsernameFrontend(config, false);
+    if (!frontendUsername) {
+      throw new Error(
+        "Failed to determine your frontend username. Please try again or notify the CLI developers."
+      );
+    }
+    const githubResult = await initGithubSDK(memory, frontendUsername, maskInput);
+    if (!githubResult) {
+      throw new Error(
+        "Failed to initialize Octokit SDK. Please notify CLI developers if the problem persists."
+      );
+    }
+    const [githubToken, githubInstance, githubUsername] = githubResult;
+    if (repoOwner !== githubUsername && repoOwner !== "") {
+      throw new Error(
+        `Private repository ${repo} owned by a different user (${repoOwner}) cannot be accessed. 
+Please use a repository you own or a public repository.`
+      );
+    }
+    if (!repoOwner || !repoName) {
+      throw new Error(`Invalid repository format: "${repo}". Expected format: "owner/repo".`);
+    }
+    logVerbose(
+      `${useFresh ? "Fresh mode - d" : "D"}ownloading file from GitHub: ${repoOwner}/${repoName}/${filePath} (branch: ${branch}).`
+    );
+    const response = await githubInstance.rest.repos.getContent({
+      owner: repoOwner,
+      repo: repoName,
+      path: filePath,
+      ref: `refs/heads/${branch}`,
+      headers: {
+        authorization: `Bearer ${githubToken}`
+      }
+    });
+    if (response.status !== 200) {
+      relinka(
+        "warn",
+        `Failed to download ${filePath} from ${repo} (${branch}): ${response.status}`
+      );
+      return null;
+    }
+    const data = response.data;
+    if (Array.isArray(data) || data.type !== "file" || !data.content || !data.encoding) {
+      relinka("warn", `Unexpected response format for ${filePath} from ${repo} (${branch}).`);
+      return null;
+    }
+    if (data.encoding !== "base64") {
+      relinka(
+        "warn",
+        `Unexpected encoding for ${filePath} from ${repo} (${branch}): ${data.encoding}.`
+      );
+      return null;
+    }
+    const decodedContent = Buffer.from(data.content, "base64").toString("utf-8");
+    if (useCache) {
+      const cachePath = getEnvCachePath(repo, branch);
+      await ensureEnvCacheDir();
+      await fs.writeFile(cachePath, decodedContent);
+      logVerbose(`Cached .env.example for ${repo} (${branch}) at ${cachePath}.`);
+    }
+    return decodedContent;
+  } catch (error) {
+    relinka(
+      "warn",
+      `Failed to download ${filePath} from ${repo} (${branch}): ${error instanceof Error ? error.message : String(error)}`
+    );
+    return null;
+  }
+}

package/bin/app/pack/cmd.js

@@ -1,11 +1,11 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
 import path from "@reliverse/pathkit";
 import { relinka } from "@reliverse/relinka";
-import { defineCommand, defineArgs } from "@reliverse/rempts";
+import { defineArgs, defineCommand } from "@reliverse/rempts";
 import { createJiti } from "jiti";
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
 import stripJsonComments from "strip-json-comments";
-import { isBinaryExt } from "../../libs/sdk/sdk-impl/utils/binary.js";
+import { isBinaryExt } from "../utils/binary.js";
 const WHITELABEL_DEFAULT = "DLER";
 const TEMPLATE_VAR = (name, whitelabel) => `${whitelabel}_TPL_${name.toUpperCase()}`;
 const TPLS_DIR = "packed";

package/bin/app/providers/better-t-stack/better-t-stack-mod.d.ts

@@ -0,0 +1,14 @@
+export declare const DLER_TEMPLATES: {
+    addons: Template;
+    api: Template;
+    auth: Template;
+    backend: Template;
+    base: Template;
+    db: Template;
+    examples: Template;
+    extras: Template;
+    frontend: Template;
+    runtime: Template;
+};
+export type DLER_TEMPLATE_NAMES = keyof typeof DLER_TEMPLATES;
+export declare const dlerTemplatesMap: Record<string, DLER_TEMPLATE_NAMES>;

package/bin/app/providers/better-t-stack/better-t-stack-mod.js

@@ -0,0 +1,35 @@
+import { DLER_TPL_ADDONS } from "./packed/addons.js";
+import { DLER_TPL_API } from "./packed/api.js";
+import { DLER_TPL_AUTH } from "./packed/auth.js";
+import { DLER_TPL_BACKEND } from "./packed/backend.js";
+import { DLER_TPL_BASE } from "./packed/base.js";
+import { DLER_TPL_DB } from "./packed/db.js";
+import { DLER_TPL_EXAMPLES } from "./packed/examples.js";
+import { DLER_TPL_EXTRAS } from "./packed/extras.js";
+import { DLER_TPL_FRONTEND } from "./packed/frontend.js";
+import { DLER_TPL_RUNTIME } from "./packed/runtime.js";
+const DLER_TEMPLATES_OBJ = {
+  addons: DLER_TPL_ADDONS,
+  api: DLER_TPL_API,
+  auth: DLER_TPL_AUTH,
+  backend: DLER_TPL_BACKEND,
+  base: DLER_TPL_BASE,
+  db: DLER_TPL_DB,
+  examples: DLER_TPL_EXAMPLES,
+  extras: DLER_TPL_EXTRAS,
+  frontend: DLER_TPL_FRONTEND,
+  runtime: DLER_TPL_RUNTIME
+};
+export const DLER_TEMPLATES = DLER_TEMPLATES_OBJ;
+export const dlerTemplatesMap = {
+  DLER_TPL_ADDONS: "addons",
+  DLER_TPL_API: "api",
+  DLER_TPL_AUTH: "auth",
+  DLER_TPL_BACKEND: "backend",
+  DLER_TPL_BASE: "base",
+  DLER_TPL_DB: "db",
+  DLER_TPL_EXAMPLES: "examples",
+  DLER_TPL_EXTRAS: "extras",
+  DLER_TPL_FRONTEND: "frontend",
+  DLER_TPL_RUNTIME: "runtime"
+};

package/bin/app/providers/better-t-stack/better-t-stack-types.d.ts

@@ -0,0 +1,21 @@
+export interface FileMetadata {
+    updatedAt?: string;
+    updatedHash?: string;
+}
+export interface TemplatesFileContent {
+    content: string | Record<string, unknown>;
+    type: "text" | "json" | "binary";
+    hasError?: boolean;
+    error?: string;
+    jsonComments?: Record<number, string>;
+    binaryHash?: string;
+    metadata?: FileMetadata;
+}
+export interface Template {
+    name: string;
+    description: string;
+    config: {
+        files: Record<string, TemplatesFileContent>;
+    };
+    updatedAt?: string;
+}

package/bin/app/providers/better-t-stack/constants.d.ts

@@ -0,0 +1,61 @@
+import type { ProjectConfig } from "./types";
+export declare const PKG_ROOT: any;
+export declare const DEFAULT_CONFIG: ProjectConfig;
+export declare const dependencyVersionMap: {
+    readonly "better-auth": "^1.2.9";
+    readonly "@better-auth/expo": "^1.2.9";
+    readonly "drizzle-orm": "^0.38.4";
+    readonly "drizzle-kit": "^0.30.5";
+    readonly "@libsql/client": "^0.14.0";
+    readonly pg: "^8.14.1";
+    readonly "@types/pg": "^8.11.11";
+    readonly mysql2: "^3.14.0";
+    readonly "@prisma/client": "^6.9.0";
+    readonly prisma: "^6.9.0";
+    readonly mongoose: "^8.14.0";
+    readonly "vite-plugin-pwa": "^0.21.2";
+    readonly "@vite-pwa/assets-generator": "^0.2.6";
+    readonly "@tauri-apps/cli": "^2.4.0";
+    readonly "@biomejs/biome": "1.9.4";
+    readonly husky: "^9.1.7";
+    readonly "lint-staged": "^15.5.0";
+    readonly "@hono/node-server": "^1.14.0";
+    readonly tsx: "^4.19.2";
+    readonly "@types/node": "^22.13.11";
+    readonly "@types/bun": "^1.2.6";
+    readonly "@elysiajs/node": "^1.2.6";
+    readonly "@elysiajs/cors": "^1.2.0";
+    readonly "@elysiajs/trpc": "^1.1.0";
+    readonly elysia: "^1.2.25";
+    readonly "@hono/trpc-server": "^0.3.4";
+    readonly hono: "^4.7.6";
+    readonly cors: "^2.8.5";
+    readonly express: "^5.1.0";
+    readonly "@types/express": "^5.0.1";
+    readonly "@types/cors": "^2.8.17";
+    readonly fastify: "^5.3.3";
+    readonly "@fastify/cors": "^11.0.1";
+    readonly turbo: "^2.5.4";
+    readonly ai: "^4.3.16";
+    readonly "@ai-sdk/google": "^1.2.3";
+    readonly "@ai-sdk/vue": "^1.2.8";
+    readonly "@ai-sdk/svelte": "^2.1.9";
+    readonly "@ai-sdk/react": "^1.2.12";
+    readonly "@prisma/extension-accelerate": "^1.3.0";
+    readonly "@orpc/server": "^1.5.0";
+    readonly "@orpc/client": "^1.5.0";
+    readonly "@orpc/tanstack-query": "^1.5.0";
+    readonly "@trpc/tanstack-react-query": "^11.0.0";
+    readonly "@trpc/server": "^11.0.0";
+    readonly "@trpc/client": "^11.0.0";
+    readonly convex: "^1.23.0";
+    readonly "@convex-dev/react-query": "^0.0.0-alpha.8";
+    readonly "convex-svelte": "^0.0.11";
+    readonly "@tanstack/svelte-query": "^5.74.4";
+    readonly "@tanstack/react-query-devtools": "^5.80.5";
+    readonly "@tanstack/react-query": "^5.80.5";
+    readonly "@tanstack/solid-query": "^5.75.0";
+    readonly "@tanstack/solid-query-devtools": "^5.75.0";
+    readonly wrangler: "^4.20.0";
+};
+export type AvailableDependencies = keyof typeof dependencyVersionMap;

package/bin/app/providers/better-t-stack/constants.js

@@ -0,0 +1,81 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getUserPkgManager } from "./utils/get-package-manager.js";
+const __filename = fileURLToPath(import.meta.url);
+const distPath = path.dirname(__filename);
+export const PKG_ROOT = path.join(distPath, "../");
+export const DEFAULT_CONFIG = {
+  projectName: "my-better-t-app",
+  projectDir: path.resolve(process.cwd(), "my-better-t-app"),
+  relativePath: "my-better-t-app",
+  frontend: ["tanstack-router"],
+  database: "sqlite",
+  orm: "drizzle",
+  auth: true,
+  addons: ["turborepo"],
+  examples: [],
+  git: true,
+  packageManager: getUserPkgManager(),
+  install: true,
+  dbSetup: "none",
+  backend: "hono",
+  runtime: "bun",
+  api: "trpc"
+};
+export const dependencyVersionMap = {
+  "better-auth": "^1.2.9",
+  "@better-auth/expo": "^1.2.9",
+  "drizzle-orm": "^0.38.4",
+  "drizzle-kit": "^0.30.5",
+  "@libsql/client": "^0.14.0",
+  pg: "^8.14.1",
+  "@types/pg": "^8.11.11",
+  mysql2: "^3.14.0",
+  "@prisma/client": "^6.9.0",
+  prisma: "^6.9.0",
+  mongoose: "^8.14.0",
+  "vite-plugin-pwa": "^0.21.2",
+  "@vite-pwa/assets-generator": "^0.2.6",
+  "@tauri-apps/cli": "^2.4.0",
+  "@biomejs/biome": "1.9.4",
+  husky: "^9.1.7",
+  "lint-staged": "^15.5.0",
+  "@hono/node-server": "^1.14.0",
+  tsx: "^4.19.2",
+  "@types/node": "^22.13.11",
+  "@types/bun": "^1.2.6",
+  "@elysiajs/node": "^1.2.6",
+  "@elysiajs/cors": "^1.2.0",
+  "@elysiajs/trpc": "^1.1.0",
+  elysia: "^1.2.25",
+  "@hono/trpc-server": "^0.3.4",
+  hono: "^4.7.6",
+  cors: "^2.8.5",
+  express: "^5.1.0",
+  "@types/express": "^5.0.1",
+  "@types/cors": "^2.8.17",
+  fastify: "^5.3.3",
+  "@fastify/cors": "^11.0.1",
+  turbo: "^2.5.4",
+  ai: "^4.3.16",
+  "@ai-sdk/google": "^1.2.3",
+  "@ai-sdk/vue": "^1.2.8",
+  "@ai-sdk/svelte": "^2.1.9",
+  "@ai-sdk/react": "^1.2.12",
+  "@prisma/extension-accelerate": "^1.3.0",
+  "@orpc/server": "^1.5.0",
+  "@orpc/client": "^1.5.0",
+  "@orpc/tanstack-query": "^1.5.0",
+  "@trpc/tanstack-react-query": "^11.0.0",
+  "@trpc/server": "^11.0.0",
+  "@trpc/client": "^11.0.0",
+  convex: "^1.23.0",
+  "@convex-dev/react-query": "^0.0.0-alpha.8",
+  "convex-svelte": "^0.0.11",
+  "@tanstack/svelte-query": "^5.74.4",
+  "@tanstack/react-query-devtools": "^5.80.5",
+  "@tanstack/react-query": "^5.80.5",
+  "@tanstack/solid-query": "^5.75.0",
+  "@tanstack/solid-query-devtools": "^5.75.0",
+  wrangler: "^4.20.0"
+};

package/bin/app/providers/better-t-stack/helpers/database-providers/mongodb-atlas-setup.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectConfig } from "../../types.js";
+export declare function setupMongoDBAtlas(config: ProjectConfig): Promise<void>;

package/bin/app/providers/better-t-stack/helpers/database-providers/mongodb-atlas-setup.js

@@ -0,0 +1,132 @@
+import path from "node:path";
+import { re } from "@reliverse/relico";
+import fs from "@reliverse/relifso";
+import { relinka } from "@reliverse/relinka";
+import { cancel, inputPrompt, isCancel, spinner } from "@reliverse/rempts";
+import { execa } from "execa";
+import {
+  addEnvVariablesToFile
+} from "../project-generation/env-setup.js";
+import { commandExists } from "../../utils/command-exists.js";
+async function checkAtlasCLI() {
+  const s = spinner({
+    text: "Checking for MongoDB Atlas CLI..."
+  });
+  s.start("Checking for MongoDB Atlas CLI...");
+  try {
+    const exists = await commandExists("atlas");
+    s.stop(exists ? "MongoDB Atlas CLI found" : re.yellow("MongoDB Atlas CLI not found"));
+    return exists;
+  } catch (_error) {
+    s.stop(re.red("Error checking MongoDB Atlas CLI"));
+    return false;
+  }
+}
+async function initMongoDBAtlas(serverDir) {
+  try {
+    const hasAtlas = await checkAtlasCLI();
+    if (!hasAtlas) {
+      relinka("error", re.red("MongoDB Atlas CLI not found."));
+      relinka(
+        "info",
+        re.yellow(
+          "Please install it from: https://www.mongodb.com/docs/atlas/cli/current/install-atlas-cli/"
+        )
+      );
+      return null;
+    }
+    relinka("info", re.blue("Running MongoDB Atlas setup..."));
+    await execa("atlas", ["deployments", "setup"], {
+      cwd: serverDir,
+      stdio: "inherit"
+    });
+    relinka("info", re.green("MongoDB Atlas deployment ready"));
+    const connectionString = await inputPrompt({
+      message: "Enter your MongoDB connection string:",
+      placeholder: "mongodb+srv://username:password@cluster.mongodb.net/database",
+      validate(value) {
+        if (!value) return "Please enter a connection string";
+        if (!value.startsWith("mongodb")) {
+          return "URL should start with mongodb:// or mongodb+srv://";
+        }
+      }
+    });
+    if (isCancel(connectionString)) {
+      cancel("MongoDB setup cancelled");
+      return null;
+    }
+    return {
+      connectionString
+    };
+  } catch (error) {
+    if (error instanceof Error) {
+      relinka("error", re.red(error.message));
+    }
+    return null;
+  }
+}
+async function writeEnvFile(projectDir, config) {
+  try {
+    const envPath = path.join(projectDir, "apps/server", ".env");
+    const variables = [
+      {
+        key: "DATABASE_URL",
+        value: config?.connectionString ?? "mongodb://localhost:27017/mydb",
+        condition: true
+      }
+    ];
+    await addEnvVariablesToFile(envPath, variables);
+  } catch (_error) {
+    relinka("error", "Failed to update environment configuration");
+  }
+}
+function displayManualSetupInstructions() {
+  relinka(
+    "info",
+    `
+${re.green("MongoDB Atlas Manual Setup Instructions:")}
+1. Install Atlas CLI:
+   ${re.blue("https://www.mongodb.com/docs/atlas/cli/stable/install-atlas-cli/")}
+2. Run the following command and follow the prompts:
+   ${re.blue("atlas deployments setup")}
+3. Get your connection string from the Atlas dashboard:
+   Format: ${re.dim("mongodb+srv://USERNAME:PASSWORD@CLUSTER.mongodb.net/DATABASE_NAME")}
+4. Add the connection string to your .env file:
+   ${re.dim('DATABASE_URL="your_connection_string"')}
+`
+  );
+}
+export async function setupMongoDBAtlas(config) {
+  const { projectDir } = config;
+  const mainSpinner = spinner({
+    text: "Setting up MongoDB Atlas..."
+  });
+  mainSpinner.start("Setting up MongoDB Atlas...");
+  const serverDir = path.join(projectDir, "apps/server");
+  try {
+    await fs.ensureDir(serverDir);
+    mainSpinner.stop("MongoDB Atlas setup ready");
+    const config2 = await initMongoDBAtlas(serverDir);
+    if (config2) {
+      await writeEnvFile(projectDir, config2);
+      relinka("success", re.green("MongoDB Atlas setup complete! Connection saved to .env file."));
+    } else {
+      relinka("warn", re.yellow("Falling back to local MongoDB configuration"));
+      await writeEnvFile(projectDir);
+      displayManualSetupInstructions();
+    }
+  } catch (error) {
+    mainSpinner.stop(re.red("MongoDB Atlas setup failed"));
+    relinka(
+      "error",
+      re.red(
+        `Error during MongoDB Atlas setup: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+    try {
+      await writeEnvFile(projectDir);
+      displayManualSetupInstructions();
+    } catch {
+    }
+  }
+}

package/bin/app/providers/better-t-stack/helpers/database-providers/neon-setup.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectConfig } from "../../types.js";
+export declare function setupNeonPostgres(config: ProjectConfig): Promise<void>;