@ollie-shop/cli 0.3.4 → 1.0.1

package/src/utils/errors.ts

@@ -1,256 +0,0 @@
-import type { ZodError } from "zod";
-import type { ErrorContext } from "../types";
-
-/**
- * Recovery action that can be suggested to users when an error occurs
- * @interface RecoveryAction
- * @property {string} description - Human-readable description of the recovery action
- * @property {string} [command] - Optional CLI command that can help resolve the issue
- */
-export interface RecoveryAction {
-  description: string;
-  command?: string;
-}
-
-/**
- * Base error class for all Ollie Shop CLI errors
- * Provides context and recovery suggestions to help users resolve issues
- *
- * @class OllieShopCLIError
- * @extends {Error}
- * @example
- * ```typescript
- * throw new OllieShopCLIError(
- *   "Component build failed",
- *   { componentId: "123", path: "./src" },
- *   [
- *     { description: "Check your TypeScript configuration" },
- *     { description: "Run validation", command: "ollieshop component validate" }
- *   ]
- * );
- * ```
- */
-export class OllieShopCLIError extends Error {
-  public readonly context: ErrorContext;
-  public readonly recoveryActions: RecoveryAction[];
-
-  /**
-   * Creates a new OllieShopCLIError instance
-   * @param {string} message - The error message
-   * @param {ErrorContext} [context={}] - Additional context about the error
-   * @param {RecoveryAction[]} [recoveryActions=[]] - Suggested actions to resolve the error
-   */
-  constructor(
-    message: string,
-    context: ErrorContext = {},
-    recoveryActions: RecoveryAction[] = [],
-  ) {
-    super(message);
-    this.name = "OllieShopCLIError";
-    this.context = context;
-    this.recoveryActions = recoveryActions;
-  }
-
-  /**
-   * Get the error context details
-   * @returns {ErrorContext} The error context object
-   */
-  get details(): ErrorContext {
-    return this.context;
-  }
-
-  /**
-   * Get suggested recovery actions
-   * @returns {RecoveryAction[]} Array of recovery actions
-   */
-  get suggestions(): RecoveryAction[] {
-    return this.recoveryActions;
-  }
-
-  /**
-   * Create an OllieShopCLIError from a Zod validation error
-   * Extracts the most relevant error message and provides validation-specific suggestions
-   *
-   * @static
-   * @param {ZodError} error - The Zod validation error
-   * @param {ErrorContext} [context={}] - Additional context to include
-   * @returns {OllieShopCLIError} A new OllieShopCLIError instance
-   * @example
-   * ```typescript
-   * try {
-   *   ComponentNameSchema.parse("Invalid Name!");
-   * } catch (error) {
-   *   if (error instanceof ZodError) {
-   *     throw OllieShopCLIError.fromZodError(error, { field: "name" });
-   *   }
-   * }
-   * ```
-   */
-  static fromZodError(
-    error: ZodError,
-    context: ErrorContext = {},
-  ): OllieShopCLIError {
-    const firstIssue = error.issues[0];
-    if (!firstIssue) {
-      return new OllieShopCLIError("Validation failed", context);
-    }
-
-    const message =
-      error.issues.length > 1
-        ? `${firstIssue.message} (and ${error.issues.length - 1} more error${error.issues.length === 2 ? "" : "s"})`
-        : firstIssue.message;
-
-    return new OllieShopCLIError(message, context, [
-      { description: "Check the command documentation for valid formats" },
-    ]);
-  }
-
-  /**
-   * Create an OllieShopCLIError from an unknown error type
-   * Safely handles any error type and converts it to OllieShopCLIError
-   *
-   * @static
-   * @param {unknown} error - Any error or value
-   * @param {ErrorContext} [context={}] - Additional context to include
-   * @returns {OllieShopCLIError} A new OllieShopCLIError instance
-   * @example
-   * ```typescript
-   * try {
-   *   // some operation
-   * } catch (error) {
-   *   throw OllieShopCLIError.fromUnknown(error, { operation: "deploy" });
-   * }
-   * ```
-   */
-  static fromUnknown(
-    error: unknown,
-    context: ErrorContext = {},
-  ): OllieShopCLIError {
-    if (error instanceof OllieShopCLIError) {
-      return error;
-    }
-
-    if (error instanceof Error) {
-      return new OllieShopCLIError(error.message, context, [
-        { description: "Check the command syntax and try again" },
-      ]);
-    }
-
-    return new OllieShopCLIError(
-      String(error) || "Unknown error occurred",
-      context,
-    );
-  }
-
-  /**
-   * Create a file not found error with helpful suggestions
-   *
-   * @static
-   * @param {string} path - The file path that was not found
-   * @param {ErrorContext} [context={}] - Additional context to include
-   * @returns {OllieShopCLIError} A new OllieShopCLIError instance with file-specific suggestions
-   * @example
-   * ```typescript
-   * if (!fs.existsSync(configPath)) {
-   *   throw OllieShopCLIError.fileNotFound(configPath, { operation: "load-config" });
-   * }
-   * ```
-   */
-  static fileNotFound(
-    path: string,
-    context: ErrorContext = {},
-  ): OllieShopCLIError {
-    return new OllieShopCLIError(
-      `File not found: ${path}`,
-      { ...context, file: path },
-      [
-        { description: "Check if the file path is correct" },
-        { description: "Ensure the file exists in the specified location" },
-      ],
-    );
-  }
-}
-
-export const CLIError = OllieShopCLIError;
-
-/**
- * Error thrown when a CLI command execution fails
- * Includes an error code for programmatic error handling
- *
- * @class CommandError
- * @extends {OllieShopCLIError}
- * @example
- * ```typescript
- * throw new CommandError(
- *   "Failed to connect to builder service",
- *   "BUILDER_CONNECTION_ERROR",
- *   { url: builderUrl, timeout: 5000 }
- * );
- * ```
- */
-export class CommandError extends OllieShopCLIError {
-  public readonly code: string;
-
-  /**
-   * Creates a new CommandError instance
-   * @param {string} message - The error message
-   * @param {string} code - A unique error code for this type of error
-   * @param {ErrorContext} [context={}] - Additional context about the error
-   */
-  constructor(message: string, code: string, context: ErrorContext = {}) {
-    super(message, context);
-    this.name = "CommandError";
-    this.code = code;
-  }
-}
-
-/**
- * Error thrown when validation fails with detailed field-level information
- * Useful for form validation and input checking scenarios
- *
- * @class ValidationError
- * @extends {OllieShopCLIError}
- * @example
- * ```typescript
- * throw new ValidationError(
- *   "Component configuration is invalid",
- *   [
- *     { field: "name", message: "Must be lowercase with hyphens" },
- *     { field: "slot", message: "Invalid slot type" }
- *   ],
- *   { componentPath: "./src/components/header" }
- * );
- * ```
- */
-export class ValidationError extends OllieShopCLIError {
-  public readonly fields: Array<{ field: string; message: string }>;
-
-  /**
-   * Creates a new ValidationError instance
-   * @param {string} message - The overall error message
-   * @param {Array<{field: string; message: string}>} [fields=[]] - Field-specific validation errors
-   * @param {ErrorContext} [context={}] - Additional context about the error
-   */
-  constructor(
-    message: string,
-    fields: Array<{ field: string; message: string }> = [],
-    context: ErrorContext = {},
-  ) {
-    super(message, context);
-    this.name = "ValidationError";
-    this.fields = fields;
-  }
-
-  /**
-   * Get error details including field-level errors
-   * @returns {ErrorContext & {fields: Array<{field: string; message: string}>}} Combined context and field errors
-   */
-  get details(): ErrorContext & {
-    fields: Array<{ field: string; message: string }>;
-  } {
-    return {
-      ...this.context,
-      fields: this.fields,
-    };
-  }
-}

package/src/utils/interactive-builder.ts

@@ -1,325 +0,0 @@
-import { ComponentSlot } from "@ollie-shop/core";
-import chalk from "chalk";
-import inquirer from "inquirer";
-import type { ComponentDeployOptions } from "../schemas/command.schema";
-import type { InteractiveChoice, MockComponent } from "../types";
-import type { CliConsole } from "./console.js";
-
-/**
- * Interactive command builder for creating CLI commands through prompts
- * Provides a wizard-like interface for complex commands
- *
- * @class InteractiveCommandBuilder
- * @example
- * ```typescript
- * const builder = new InteractiveCommandBuilder(console);
- * await builder.buildDeployComponentCommand();
- * // User is guided through deployment options
- * ```
- */
-export class InteractiveCommandBuilder {
-  /**
-   * Creates a new InteractiveCommandBuilder instance
-   * @param {CliConsole} console - Console instance for I/O operations
-   */
-  constructor(private console: CliConsole) {}
-
-  /**
-   * Build component deploy command interactively
-   * Guides user through selecting a component and deployment options
-   *
-   * @async
-   * @throws {Error} If user cancels the wizard
-   * @example
-   * ```typescript
-   * await builder.buildDeployComponentCommand();
-   * // Shows:
-   * // - List of available components
-   * // - Deployment options checkboxes
-   * // - Command preview
-   * // - Execution confirmation
-   * ```
-   */
-  async buildDeployComponentCommand(): Promise<void> {
-    this.console.log(chalk.blue.bold("\n🚀 Component Deployment Wizard\n"));
-
-    try {
-      // Get available components (mock data for now)
-      const components = await this.getAvailableComponents();
-
-      const answers = await inquirer.prompt([
-        {
-          type: "list",
-          name: "component",
-          message: "Select component to deploy:",
-          choices: components.map(
-            (c): InteractiveChoice => ({
-              name: `${c.name} (${c.slot}) - v${c.version || "1.0.0"} - ${chalk.dim(
-                `Created ${new Date(c.createdAt).toLocaleDateString()}`,
-              )}`,
-              value: c.id,
-            }),
-          ),
-        },
-        {
-          type: "checkbox",
-          name: "options",
-          message: "Deployment options:",
-          choices: [
-            { name: "Run tests before deploy", value: "test", checked: true },
-            {
-              name: "Enable verbose logging",
-              value: "verbose",
-              checked: false,
-            },
-          ],
-        },
-      ]);
-
-      // Build the command
-      let command = `ollieshop component deploy --id ${answers.component}`;
-
-      if (answers.options.includes("verbose")) {
-        command += " --verbose";
-      }
-
-      // Show preview
-      this.console.log(`\n${chalk.dim("[Preview] This will run:")}`);
-      this.console.log(chalk.cyan(`  ${command}\n`));
-
-      // Confirm execution
-      const { proceed } = await inquirer.prompt({
-        type: "confirm",
-        name: "proceed",
-        message: "Execute this command?",
-        default: true,
-      });
-
-      if (proceed) {
-        // Execute the command
-        this.console.log(chalk.dim("\nExecuting command...\n"));
-
-        // Import and execute the action directly
-        const { deployComponent } = await import(
-          "../actions/component.actions.js"
-        );
-        const deployOptions: ComponentDeployOptions = {
-          componentId: answers.component,
-          path: process.cwd(),
-        };
-        await deployComponent(deployOptions, this.console);
-      } else {
-        this.console.log(chalk.yellow("\n⚠️  Deployment cancelled"));
-      }
-    } catch (error) {
-      if (error instanceof Error && error.name === "ExitPromptError") {
-        this.console.log(chalk.yellow("\n⚠️  Wizard cancelled"));
-      } else {
-        throw error;
-      }
-    }
-  }
-
-  /**
-   * Build component create command interactively
-   * Guides user through component creation options with live validation
-   *
-   * @async
-   * @throws {Error} If user cancels the wizard
-   * @example
-   * ```typescript
-   * await builder.buildCreateComponentCommand();
-   * // Prompts for:
-   * // - Component name (with live validation)
-   * // - Component slot selection
-   * // - Language preference (TypeScript/JavaScript)
-   * // - Test file inclusion
-   * ```
-   */
-  async buildCreateComponentCommand(): Promise<void> {
-    this.console.log(chalk.blue.bold("\n🎨 Component Creation Wizard\n"));
-
-    try {
-      const answers = await inquirer.prompt([
-        {
-          type: "input",
-          name: "name",
-          message: "Component name:",
-          validate: (input: string) => {
-            if (!input) return "Component name is required";
-            if (!/^[a-z0-9-]+$/.test(input)) {
-              return "Must be lowercase with hyphens only (e.g., header-nav)";
-            }
-            return true;
-          },
-          transformer: (input: string) => {
-            // Show live validation
-            if (!/^[a-z0-9-]+$/.test(input) && input) {
-              return chalk.red(input);
-            }
-            return input;
-          },
-        },
-        {
-          type: "list",
-          name: "slot",
-          message: "Component slot:",
-          choices: ComponentSlot.options.map((slot) => ({
-            name:
-              slot.charAt(0).toUpperCase() + slot.slice(1).replace(/-/g, " "),
-            value: slot,
-          })),
-          default: "main",
-        },
-        {
-          type: "list",
-          name: "language",
-          message: "Language:",
-          choices: [
-            { name: "TypeScript (recommended)", value: "typescript" },
-            { name: "JavaScript", value: "javascript" },
-          ],
-          default: "typescript",
-        },
-        {
-          type: "confirm",
-          name: "tests",
-          message: "Include test files?",
-          default: true,
-        },
-      ]);
-
-      // Build the command
-      let command = `ollieshop component create --name ${answers.name}`;
-
-      if (answers.slot !== "main") {
-        command += ` --slot ${answers.slot}`;
-      }
-
-      if (answers.language === "javascript") {
-        command += " --no-typescript";
-      }
-
-      if (!answers.tests) {
-        command += " --no-tests";
-      }
-
-      // Show preview
-      this.console.log(`\n${chalk.dim("[Preview] This will run:")}`);
-      this.console.log(chalk.cyan(`  ${command}\n`));
-
-      // Confirm execution
-      const { proceed } = await inquirer.prompt({
-        type: "confirm",
-        name: "proceed",
-        message: "Create this component?",
-        default: true,
-      });
-
-      if (proceed) {
-        // Execute the command
-        this.console.log(chalk.dim("\nCreating component...\n"));
-
-        const { createComponent } = await import(
-          "../actions/component.actions.js"
-        );
-        await createComponent(
-          {
-            name: answers.name,
-            slot: answers.slot,
-            tests: answers.tests,
-          },
-          this.console,
-        );
-      } else {
-        this.console.log(chalk.yellow("\n⚠️  Component creation cancelled"));
-      }
-    } catch (error) {
-      if (error instanceof Error && error.name === "ExitPromptError") {
-        this.console.log(chalk.yellow("\n⚠️  Wizard cancelled"));
-      } else {
-        throw error;
-      }
-    }
-  }
-
-  /**
-   * Get available components (mock for now)
-   * TODO: Replace with actual API call to list components
-   *
-   * @private
-   * @async
-   * @returns {Promise<MockComponent[]>} Array of mock component data
-   */
-  private async getAvailableComponents(): Promise<MockComponent[]> {
-    // TODO: Replace with actual API call
-    return [
-      {
-        id: "comp_header_123",
-        name: "header-nav",
-        slot: "header",
-        version: "1.2.0",
-        enabled: true,
-        createdAt: new Date(Date.now() - 2 * 60 * 60 * 1000).toISOString(),
-        type: "ui",
-        description: "Navigation header component",
-      },
-      {
-        id: "comp_cart_456",
-        name: "shopping-cart",
-        slot: "sidebar",
-        version: "1.0.0",
-        enabled: true,
-        createdAt: new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString(),
-        type: "ui",
-        description: "Shopping cart widget",
-      },
-      {
-        id: "comp_product_789",
-        name: "product-list",
-        slot: "main",
-        version: "2.1.0",
-        enabled: true,
-        createdAt: new Date(Date.now() - 3 * 24 * 60 * 60 * 1000).toISOString(),
-        type: "ui",
-        description: "Product listing component",
-      },
-    ];
-  }
-}
-
-/**
- * Run an interactive command builder for the specified command
- * Creates a wizard-like interface based on the command type
- *
- * @async
- * @param {string} command - The command type to run interactively
- * @param {CliConsole} console - Console instance for I/O
- * @example
- * ```typescript
- * // Run deployment wizard
- * await runInteractiveCommand("deploy", console);
- *
- * // Run component creation wizard
- * await runInteractiveCommand("create", console);
- * ```
- */
-export async function runInteractiveCommand(
-  command: string,
-  console: CliConsole,
-): Promise<void> {
-  const builder = new InteractiveCommandBuilder(console);
-
-  switch (command) {
-    case "deploy":
-    case "component-deploy":
-      await builder.buildDeployComponentCommand();
-      break;
-    case "create":
-    case "component-create":
-      await builder.buildCreateComponentCommand();
-      break;
-    default:
-      console.warn(`Interactive mode not available for command: ${command}`);
-  }
-}