create-better-t-stack 3.17.1 → 3.19.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { o as createBtsCli } from "./src-D5L84uxt.mjs";
+import { l as createBtsCli } from "./src-_XtvURoM.mjs";
 
 //#region src/cli.ts
 createBtsCli().run();

package/dist/index.d.mts

@@ -1,13 +1,129 @@
 #!/usr/bin/env node
 import * as _orpc_server0 from "@orpc/server";
+import * as better_result0 from "better-result";
+import { Result, Result as Result$1 } from "better-result";
 import * as trpc_cli0 from "trpc-cli";
 import z from "zod";
-import { EMBEDDED_TEMPLATES, GeneratorOptions, GeneratorResult, TEMPLATE_COUNT, VirtualDirectory, VirtualFile, VirtualFileSystem, VirtualFileTree, VirtualFileTree as VirtualFileTree$1, VirtualNode, generateVirtualProject } from "@better-t-stack/template-generator";
+import { EMBEDDED_TEMPLATES, GeneratorError, GeneratorError as GeneratorError$1, GeneratorOptions, TEMPLATE_COUNT, VirtualDirectory, VirtualFile, VirtualFileSystem, VirtualFileTree, VirtualFileTree as VirtualFileTree$1, VirtualNode, generate } from "@better-t-stack/template-generator";
 
 //#region src/types.d.ts
 
 import * as import__better_t_stack_types from "@better-t-stack/types";
 //#endregion
+//#region src/helpers/core/command-handlers.d.ts
+/**
+ * Result type for project creation
+ */
+interface CreateProjectResult {
+  success: boolean;
+  projectConfig: types_d_exports.ProjectConfig;
+  reproducibleCommand: string;
+  timeScaffolded: string;
+  elapsedTimeMs: number;
+  projectDirectory: string;
+  relativePath: string;
+  error?: string;
+}
+//#endregion
+//#region src/helpers/core/add-handler.d.ts
+interface AddResult {
+  success: boolean;
+  addedAddons: types_d_exports.Addons[];
+  projectDir: string;
+  error?: string;
+}
+//#endregion
+//#region src/utils/errors.d.ts
+declare const UserCancelledError_base: better_result0.TaggedErrorClass<"UserCancelledError", {
+  message: string;
+}>;
+/**
+ * User cancelled the operation (e.g., Ctrl+C in prompts)
+ */
+declare class UserCancelledError extends UserCancelledError_base {
+  constructor(args?: {
+    message?: string;
+  });
+}
+declare const CLIError_base: better_result0.TaggedErrorClass<"CLIError", {
+  message: string;
+  cause?: unknown;
+}>;
+/**
+ * General CLI error for validation failures, invalid flags, etc.
+ */
+declare class CLIError extends CLIError_base {}
+declare const ValidationError_base: better_result0.TaggedErrorClass<"ValidationError", {
+  field?: string;
+  value?: unknown;
+  message: string;
+}>;
+/**
+ * Validation error for config/flag validation failures
+ */
+declare class ValidationError extends ValidationError_base {
+  constructor(args: {
+    field?: string;
+    value?: unknown;
+    message: string;
+  });
+}
+declare const CompatibilityError_base: better_result0.TaggedErrorClass<"CompatibilityError", {
+  options: string[];
+  message: string;
+}>;
+/**
+ * Compatibility error for incompatible option combinations
+ */
+declare class CompatibilityError extends CompatibilityError_base {
+  constructor(args: {
+    options: string[];
+    message: string;
+  });
+}
+declare const DirectoryConflictError_base: better_result0.TaggedErrorClass<"DirectoryConflictError", {
+  directory: string;
+  message: string;
+}>;
+/**
+ * Directory conflict error when target directory exists and is not empty
+ */
+declare class DirectoryConflictError extends DirectoryConflictError_base {
+  constructor(args: {
+    directory: string;
+  });
+}
+declare const ProjectCreationError_base: better_result0.TaggedErrorClass<"ProjectCreationError", {
+  phase: string;
+  message: string;
+  cause?: unknown;
+}>;
+/**
+ * Project creation error for failures during scaffolding
+ */
+declare class ProjectCreationError extends ProjectCreationError_base {
+  constructor(args: {
+    phase: string;
+    message: string;
+    cause?: unknown;
+  });
+}
+declare const DatabaseSetupError_base: better_result0.TaggedErrorClass<"DatabaseSetupError", {
+  provider: string;
+  message: string;
+  cause?: unknown;
+}>;
+/**
+ * Database setup error for failures during database configuration
+ */
+declare class DatabaseSetupError extends DatabaseSetupError_base {
+  constructor(args: {
+    provider: string;
+    message: string;
+    cause?: unknown;
+  });
+}
+//#endregion
 //#region src/index.d.ts
 declare const router: {
   create: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, z.ZodTuple<[z.ZodOptional<z.ZodString>, z.ZodObject<{
@@ -72,6 +188,7 @@ declare const router: {
       oxlint: "oxlint";
       opentui: "opentui";
       wxt: "wxt";
+      skills: "skills";
     }>>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodEnum<{
       none: "none";
@@ -133,95 +250,54 @@ declare const router: {
     renderTitle: z.ZodOptional<z.ZodBoolean>;
     disableAnalytics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     manualDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  }, z.core.$strip>], null>, _orpc_server0.Schema<{
-    success: boolean;
-    projectConfig: {
-      projectName: string;
-      projectDir: string;
-      relativePath: string;
-      database: "none" | "sqlite" | "postgres" | "mysql" | "mongodb";
-      orm: "none" | "drizzle" | "prisma" | "mongoose";
-      backend: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self";
-      runtime: "none" | "bun" | "node" | "workers";
-      frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro")[];
-      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
-      examples: ("none" | "todo" | "ai")[];
-      auth: "none" | "better-auth" | "clerk";
-      payments: "none" | "polar";
-      git: boolean;
-      packageManager: "bun" | "npm" | "pnpm";
-      install: boolean;
-      dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "d1" | "docker";
-      api: "none" | "trpc" | "orpc";
-      webDeploy: "none" | "cloudflare";
-      serverDeploy: "none" | "cloudflare";
-    };
-    reproducibleCommand: string;
-    timeScaffolded: string;
-    elapsedTimeMs: number;
-    projectDirectory: string;
-    relativePath: string;
-    error?: undefined;
-  } | {
-    success: boolean;
-    error: string;
-    projectConfig: types_d_exports.ProjectConfig;
-    reproducibleCommand: string;
-    timeScaffolded: string;
-    elapsedTimeMs: number;
-    projectDirectory: string;
-    relativePath: string;
-  } | undefined, {
-    success: boolean;
-    projectConfig: {
-      projectName: string;
-      projectDir: string;
-      relativePath: string;
-      database: "none" | "sqlite" | "postgres" | "mysql" | "mongodb";
-      orm: "none" | "drizzle" | "prisma" | "mongoose";
-      backend: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self";
-      runtime: "none" | "bun" | "node" | "workers";
-      frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro")[];
-      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
-      examples: ("none" | "todo" | "ai")[];
-      auth: "none" | "better-auth" | "clerk";
-      payments: "none" | "polar";
-      git: boolean;
-      packageManager: "bun" | "npm" | "pnpm";
-      install: boolean;
-      dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "d1" | "docker";
-      api: "none" | "trpc" | "orpc";
-      webDeploy: "none" | "cloudflare";
-      serverDeploy: "none" | "cloudflare";
-    };
-    reproducibleCommand: string;
-    timeScaffolded: string;
-    elapsedTimeMs: number;
-    projectDirectory: string;
-    relativePath: string;
-    error?: undefined;
-  } | {
-    success: boolean;
-    error: string;
-    projectConfig: types_d_exports.ProjectConfig;
-    reproducibleCommand: string;
-    timeScaffolded: string;
-    elapsedTimeMs: number;
-    projectDirectory: string;
-    relativePath: string;
-  } | undefined>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+  }, z.core.$strip>], null>, _orpc_server0.Schema<CreateProjectResult | undefined, CreateProjectResult | undefined>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
   sponsors: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, _orpc_server0.Schema<unknown, unknown>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
   docs: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, _orpc_server0.Schema<unknown, unknown>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
   builder: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, _orpc_server0.Schema<unknown, unknown>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+  add: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, z.ZodObject<{
+    addons: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      none: "none";
+      pwa: "pwa";
+      tauri: "tauri";
+      starlight: "starlight";
+      biome: "biome";
+      lefthook: "lefthook";
+      husky: "husky";
+      ruler: "ruler";
+      turborepo: "turborepo";
+      fumadocs: "fumadocs";
+      ultracite: "ultracite";
+      oxlint: "oxlint";
+      opentui: "opentui";
+      wxt: "wxt";
+      skills: "skills";
+    }>>>;
+    install: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    packageManager: z.ZodOptional<z.ZodEnum<{
+      bun: "bun";
+      npm: "npm";
+      pnpm: "pnpm";
+    }>>;
+    projectDir: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+  history: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    clear: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    json: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, z.core.$strip>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
 };
 declare function createBtsCli(): trpc_cli0.TrpcCli;
+/**
+ * Error types that can be returned from create/createVirtual
+ */
+type CreateError = UserCancelledError | CLIError | ProjectCreationError;
 /**
  * Programmatic API to create a new Better-T-Stack project.
- * Returns pure JSON - no console output, no interactive prompts.
+ * Returns a Result type - no console output, no interactive prompts.
  *
  * @example
  * ```typescript
- * import { create } from "create-better-t-stack";
+ * import { create, Result } from "create-better-t-stack";
  *
  * const result = await create("my-app", {
  *   frontend: ["tanstack-router"],
@@ -231,23 +307,27 @@ declare function createBtsCli(): trpc_cli0.TrpcCli;
  *   orm: "drizzle",
  * });
  *
- * if (result.success) {
- *   console.log(`Project created at: ${result.projectDirectory}`);
- * }
+ * result.match({
+ *   ok: (data) => console.log(`Project created at: ${data.projectDirectory}`),
+ *   err: (error) => console.error(`Failed: ${error.message}`),
+ * });
+ *
+ * // Or use unwrapOr for a default value
+ * const data = result.unwrapOr(null);
  * ```
  */
-declare function create(projectName?: string, options?: Partial<types_d_exports.CreateInput>): Promise<types_d_exports.InitResult>;
+declare function create(projectName?: string, options?: Partial<types_d_exports.CreateInput>): Promise<Result$1<types_d_exports.InitResult, CreateError>>;
 declare function sponsors(): Promise<void>;
 declare function docs(): Promise<void>;
 declare function builder(): Promise<void>;
 /**
  * Programmatic API to generate a project in-memory (virtual filesystem).
- * Returns a VirtualFileTree without writing to disk.
+ * Returns a Result with a VirtualFileTree without writing to disk.
  * Useful for web previews and testing.
  *
  * @example
  * ```typescript
- * import { createVirtual, EMBEDDED_TEMPLATES } from "create-better-t-stack";
+ * import { createVirtual, EMBEDDED_TEMPLATES, Result } from "create-better-t-stack";
  *
  * const result = await createVirtual({
  *   frontend: ["tanstack-router"],
@@ -257,16 +337,36 @@ declare function builder(): Promise<void>;
  *   orm: "drizzle",
  * });
  *
- * if (result.success) {
- *   console.log(`Generated ${result.tree.fileCount} files`);
+ * result.match({
+ *   ok: (tree) => console.log(`Generated ${tree.fileCount} files`),
+ *   err: (error) => console.error(`Failed: ${error.message}`),
+ * });
+ * ```
+ */
+declare function createVirtual(options: Partial<Omit<types_d_exports.ProjectConfig, "projectDir" | "relativePath">>): Promise<Result$1<VirtualFileTree$1, GeneratorError$1>>;
+/**
+ * Programmatic API to add addons to an existing Better-T-Stack project.
+ *
+ * @example
+ * ```typescript
+ * import { add } from "create-better-t-stack";
+ *
+ * const result = await add({
+ *   addons: ["biome", "husky"],
+ *   install: true,
+ * });
+ *
+ * if (result?.success) {
+ *   console.log(`Added: ${result.addedAddons.join(", ")}`);
  * }
  * ```
  */
-declare function createVirtual(options: Partial<Omit<types_d_exports.ProjectConfig, "projectDir" | "relativePath">>): Promise<{
-  success: boolean;
-  tree?: VirtualFileTree$1;
-  error?: string;
-}>;
+declare function add(options?: {
+  addons?: types_d_exports.Addons[];
+  install?: boolean;
+  packageManager?: types_d_exports.PackageManager;
+  projectDir?: string;
+}): Promise<AddResult | undefined>;
 type API = import__better_t_stack_types.API;
 type Addons = import__better_t_stack_types.Addons;
 type Auth = import__better_t_stack_types.Auth;
@@ -286,4 +386,4 @@ type Runtime = import__better_t_stack_types.Runtime;
 type ServerDeploy = import__better_t_stack_types.ServerDeploy;
 type Template = import__better_t_stack_types.Template;
 type WebDeploy = import__better_t_stack_types.WebDeploy;
-export { type API, type Addons, type Auth, type Backend, type BetterTStackConfig, type CreateInput, type Database, type DatabaseSetup, type DirectoryConflict, EMBEDDED_TEMPLATES, type Examples, type Frontend, type GeneratorOptions, type GeneratorResult, type InitResult, type ORM, type PackageManager, type Payments, type Runtime, type ServerDeploy, TEMPLATE_COUNT, type Template, type VirtualDirectory, type VirtualFile, VirtualFileSystem, type VirtualFileTree, type VirtualNode, type WebDeploy, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };
+export { type API, type AddResult, type Addons, type Auth, type Backend, type BetterTStackConfig, CLIError, CompatibilityError, CreateError, type CreateInput, type Database, type DatabaseSetup, DatabaseSetupError, type DirectoryConflict, DirectoryConflictError, EMBEDDED_TEMPLATES, type Examples, type Frontend, GeneratorError, type GeneratorOptions, type InitResult, type ORM, type PackageManager, type Payments, ProjectCreationError, Result, type Runtime, type ServerDeploy, TEMPLATE_COUNT, type Template, UserCancelledError, ValidationError, type VirtualDirectory, type VirtualFile, VirtualFileSystem, type VirtualFileTree, type VirtualNode, type WebDeploy, add, builder, create, createBtsCli, createVirtual, docs, generate, router, sponsors };

package/dist/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as create, c as docs, d as sponsors, i as builder, l as generateVirtualProject, n as TEMPLATE_COUNT, o as createBtsCli, r as VirtualFileSystem, s as createVirtual, t as EMBEDDED_TEMPLATES, u as router } from "./src-D5L84uxt.mjs";
+import { _ as DatabaseSetupError, a as VirtualFileSystem, b as UserCancelledError, c as create, d as docs, f as generate, g as CompatibilityError, h as CLIError, i as TEMPLATE_COUNT, l as createBtsCli, m as sponsors, n as GeneratorError, o as add, p as router, r as Result, s as builder, t as EMBEDDED_TEMPLATES, u as createVirtual, v as DirectoryConflictError, x as ValidationError, y as ProjectCreationError } from "./src-_XtvURoM.mjs";
 
-export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };
+export { CLIError, CompatibilityError, DatabaseSetupError, DirectoryConflictError, EMBEDDED_TEMPLATES, GeneratorError, ProjectCreationError, Result, TEMPLATE_COUNT, UserCancelledError, ValidationError, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generate, router, sponsors };