@newpeak/barista-cli 0.1.0 → 0.1.2

package/CONTRIBUTING.md

@@ -1,291 +0,0 @@
-# Contributing to Barista CLI
-
-Thank you for your interest in contributing to Barista CLI! This document provides guidelines and instructions for contributing.
-
-## Development Setup
-
-### Prerequisites
-
-- Node.js 18+
-- npm 9+
-
-### Initial Setup
-
-```bash
-# Clone the repository
-git clone https://gitlab.newpeaksh.com/coffee/coffee-barista-cli.git
-cd coffee-barista-cli
-
-# Install dependencies
-npm install
-
-# Link CLI for local development
-npm link
-
-# Verify installation
-barista --version
-```
-
-### VS Code Setup
-
-Recommended extensions:
-- ESLint
-- Prettier
-- TypeScript Vue Plugin (Volar)
-
-## Development Workflow
-
-### ⚠️ IMPORTANT: Design First, Code Later
-
-**Before writing ANY code, you MUST complete the design phase.**
-
-Skipping design leads to:
-- Wrong API endpoints (like Arabica register using `/api/member/user/register` instead of `/member/user/register`)
-- Missing required parameters
-- Inconsistent command structures
-- Rework and wasted time
-
-### 1. Design Phase (MANDATORY)
-
-1. Read `docs/COMMAND_DESIGN_SPEC.md`
-2. Find backend Controller:
-   ```bash
-   # Example: Find the register endpoint
-   grep -r "register" --include="*.java" ../coffee-arabica-end/facade/
-   ```
-3. Document the command design:
-   - API endpoint and HTTP method
-   - All parameters (required vs optional)
-   - Request/Response DTOs
-   - Error codes and handling
-4. Create design document: `docs/commands/{service}/{resource}/{action}/index.md`
-5. **Get design reviewed** before coding
-
-### 2. Create a Branch
-
-```bash
-git checkout -b feature/my-feature
-# or
-git checkout -b fix/bug-description
-```
-
-### 3. Implement Changes (After Design Approved)
-
-- Write TypeScript code following the approved design
-- Follow existing command patterns
-- Add or update tests
-- Update documentation if needed
-
-### 4. Run Tests
-
-```bash
-# Run all tests
-npm test
-
-# Run unit tests only
-npm run test:unit
-
-# Run tests in watch mode
-npm test -- --watch
-```
-
-### 5. Lint and Format
-
-```bash
-# Check code style
-npm run lint
-
-# Auto-fix linting issues
-npm run lint -- --fix
-
-# Format code with Prettier
-npm run format
-```
-
-### 6. Build
-
-```bash
-# Build TypeScript
-npm run build
-
-# Watch mode for development
-npm run dev
-```
-
-### 7. Commit Changes
-
-Follow commit message conventions (see below).
-
-### 8. Push and Create PR
-
-```bash
-git push origin feature/my-feature
-# Then create PR via GitLab UI
-```
-
-## Code Style
-
-We use ESLint and Prettier for code formatting:
-
-- **TypeScript**: Strict mode enabled
-- **ESM**: All code uses ES modules with `.js` extensions in imports
-- **Semicolons**: Required
-- **Quotes**: Single quotes for strings
-- **Indentation**: 2 spaces
-
-### Import Order
-
-```typescript
-// 1. Node.js built-ins
-import fs from 'fs';
-import path from 'path';
-
-// 2. External packages
-import chalk from 'chalk';
-import { Command } from 'commander';
-
-// 3. Internal packages (relative)
-import { configManager } from '../core/config/manager.js';
-import { tokenManager } from '../core/auth/token-manager.js';
-import type { Context, Config } from '../types/index.js';
-```
-
-## Commit Message Conventions
-
-We follow [Conventional Commits](https://www.conventionalcommits.org/):
-
-```
-<type>(<scope>): <subject>
-
-[optional body]
-
-[optional footer]
-```
-
-### Types
-
-| Type | Description |
-|------|-------------|
-| feat | New feature |
-| fix | Bug fix |
-| docs | Documentation changes |
-| style | Formatting, missing semicolons, etc. |
-| refactor | Code refactoring |
-| test | Adding tests |
-| chore | Maintenance tasks |
-
-### Examples
-
-```bash
-# Feature
-git commit -m "feat(liberica): add orders cancel command"
-
-# Bug fix
-git commit -m "fix(auth): handle token expiration gracefully"
-
-# Documentation
-git commit -m "docs: update README with new command examples"
-
-# Refactoring
-git commit -m "refactor(config): extract environment validation"
-```
-
-## Testing
-
-### Test Structure
-
-```typescript
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-
-describe('module name', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('should do something specific', () => {
-    // Arrange
-    const input = 'test';
-
-    // Act
-    const result = functionUnderTest(input);
-
-    // Assert
-    expect(result).toBe('expected');
-  });
-});
-```
-
-### Running Specific Tests
-
-```bash
-# Run tests matching a pattern
-npm test -- orders
-
-# Run with coverage
-npm test -- --coverage
-
-# Run in watch mode for specific file
-npm test -- src/commands/context.test.ts --watch
-```
-
-## Project Structure
-
-```
-coffee-barista-cli/
-├── bin/
-│   └── barista              # CLI entry point
-├── src/
-│   ├── index.ts             # Main entry
-│   ├── commands/            # Command implementations
-│   │   ├── context.ts
-│   │   ├── auth.ts
-│   │   ├── liberica/
-│   │   │   ├── orders.ts
-│   │   │   ├── products.ts
-│   │   │   └── index.ts
-│   │   └── arabica/
-│   │       └── index.ts
-│   ├── core/                # Core functionality
-│   │   ├── config/
-│   │   │   └── manager.ts
-│   │   └── auth/
-│   │       └── token-manager.ts
-│   ├── types/
-│   │   └── index.ts
-│   └── utils/
-├── tests/
-│   ├── unit/               # Unit tests
-│   ├── integration/        # Integration tests
-│   └── fixtures/           # Test fixtures
-├── docs/                   # Documentation
-└── package.json
-```
-
-## Documentation
-
-When adding new features, update relevant docs:
-
-- **New command**: 
-  1. **必须先**阅读 [命令设计规范](./docs/COMMAND_DESIGN_SPEC.md)
-  2. 编写设计文档（按规范模板）
-  3. 更新 `docs/COMMANDS.md`
-- **Architecture changes**: Update `docs/ARCHITECTURE.md`
-- **README.md**: Update if CLI interface changes
-
-## Pull Request Checklist
-
-- [ ] Code follows style guidelines (lint passes)
-- [ ] Tests added/updated and passing
-- [ ] Documentation updated
-- [ ] Commit messages follow conventions
-- [ ] Build succeeds (`npm run build`)
-
-## Questions?
-
-For questions or discussions:
-- Open an issue in the repository
-- Contact the development team
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

package/tests/unit/commands/arabica/auth.test.ts

@@ -1,230 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-
-vi.mock('chalk', () => ({
-  default: {
-    bold: vi.fn((text) => text),
-    green: vi.fn((text) => text),
-    red: vi.fn((text) => text),
-    gray: vi.fn((text) => text),
-  },
-}));
-
-vi.mock('inquirer', () => ({
-  default: {
-    prompt: vi.fn(),
-  },
-}));
-
-vi.mock('../../../../src/core/config/manager.js', () => ({
-  configManager: {
-    getCurrentContext: vi.fn(() => ({
-      environment: 'dev' as const,
-      service: 'arabica' as const,
-    })),
-  },
-}));
-
-vi.mock('../../../../src/core/auth/token-manager.js', () => ({
-  tokenManager: {
-    getToken: vi.fn(),
-    setToken: vi.fn(),
-    deleteToken: vi.fn(),
-    findAllTokens: vi.fn(() => []),
-  },
-}));
-
-vi.mock('../../../../src/core/api/client.js', () => ({
-  apiClient: {
-    loginArabica: vi.fn(),
-    registerArabica: vi.fn(),
-  },
-}));
-
-import { createArabicaAuthCommand } from '../../../../src/commands/arabica/auth/index.js';
-
-describe('createArabicaAuthCommand', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('should create command with name "auth"', () => {
-    const command = createArabicaAuthCommand();
-    expect(command.name()).toBe('auth');
-  });
-
-  it('should have description "Manage Arabica authentication"', () => {
-    const command = createArabicaAuthCommand();
-    expect(command.description()).toBe('Manage Arabica authentication');
-  });
-
-  describe('login subcommand', () => {
-    it('should exist', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      expect(loginCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      expect(loginCmd?.description()).toBe('Login to Arabica');
-    });
-
-    it('should have --env option', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const envOption = loginCmd?.options.find((opt) => opt.short === '-e' || opt.long === '--env');
-      expect(envOption).toBeDefined();
-    });
-
-    it('should have --account option', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const accountOption = loginCmd?.options.find((opt) => opt.long === '--account');
-      expect(accountOption).toBeDefined();
-    });
-
-    it('should have --password option', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const passwordOption = loginCmd?.options.find((opt) => opt.long === '--password');
-      expect(passwordOption).toBeDefined();
-    });
-
-    it('should have --remember option', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const rememberOption = loginCmd?.options.find((opt) => opt.long === '--remember');
-      expect(rememberOption).toBeDefined();
-    });
-
-    it('should NOT have --tenant option', () => {
-      const command = createArabicaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const tenantOption = loginCmd?.options.find((opt) => opt.long === '--tenant');
-      expect(tenantOption).toBeUndefined();
-    });
-  });
-
-  describe('register subcommand', () => {
-    it('should exist', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      expect(registerCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      expect(registerCmd?.description()).toBe('Register new Arabica account');
-    });
-
-    it('should have --env option', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      const envOption = registerCmd?.options.find((opt) => opt.long === '--env');
-      expect(envOption).toBeDefined();
-    });
-
-    it('should have --email option', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      const emailOption = registerCmd?.options.find((opt) => opt.long === '--email');
-      expect(emailOption).toBeDefined();
-    });
-
-    it('should have --password option', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      const passwordOption = registerCmd?.options.find((opt) => opt.long === '--password');
-      expect(passwordOption).toBeDefined();
-    });
-
-    it('should have --phone option', () => {
-      const command = createArabicaAuthCommand();
-      const registerCmd = command.commands.find((cmd) => cmd.name() === 'register');
-      const phoneOption = registerCmd?.options.find((opt) => opt.long === '--phone');
-      expect(phoneOption).toBeDefined();
-    });
-  });
-
-  describe('status subcommand', () => {
-    it('should exist', () => {
-      const command = createArabicaAuthCommand();
-      const statusCmd = command.commands.find((cmd) => cmd.name() === 'status');
-      expect(statusCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createArabicaAuthCommand();
-      const statusCmd = command.commands.find((cmd) => cmd.name() === 'status');
-      expect(statusCmd?.description()).toBe('Check Arabica authentication status');
-    });
-
-    it('should have no options', () => {
-      const command = createArabicaAuthCommand();
-      const statusCmd = command.commands.find((cmd) => cmd.name() === 'status');
-      expect(statusCmd?.options).toHaveLength(0);
-    });
-  });
-
-  describe('logout subcommand', () => {
-    it('should exist', () => {
-      const command = createArabicaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      expect(logoutCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createArabicaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      expect(logoutCmd?.description()).toBe('Logout from Arabica and clear token');
-    });
-
-    it('should have --env option', () => {
-      const command = createArabicaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      const envOption = logoutCmd?.options.find((opt) => opt.long === '--env');
-      expect(envOption).toBeDefined();
-    });
-
-    it('should have --all option', () => {
-      const command = createArabicaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      const allOption = logoutCmd?.options.find((opt) => opt.long === '--all');
-      expect(allOption).toBeDefined();
-    });
-  });
-});
-
-describe('auth command integration', () => {
-  it('should call apiClient.loginArabica with correct parameters on login', async () => {
-    const { apiClient } = await import('../../../../src/core/api/client.js');
-    expect(apiClient.loginArabica).toBeDefined();
-  });
-
-  it('should call apiClient.registerArabica with correct parameters on register', async () => {
-    const { apiClient } = await import('../../../../src/core/api/client.js');
-    expect(apiClient.registerArabica).toBeDefined();
-  });
-
-  it('should call tokenManager.setToken after successful login', async () => {
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-    expect(tokenManager.setToken).toBeDefined();
-  });
-
-  it('should call tokenManager.getToken for status check', async () => {
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-    expect(tokenManager.getToken).toBeDefined();
-  });
-
-  it('should call tokenManager.deleteToken on logout', async () => {
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-    expect(tokenManager.deleteToken).toBeDefined();
-  });
-
-  it('should call tokenManager.findAllTokens on logout --all', async () => {
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-    expect(tokenManager.findAllTokens).toBeDefined();
-  });
-});

package/tests/unit/commands/liberica/auth.test.ts

@@ -1,175 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-
-vi.mock('chalk', () => ({
-  default: {
-    bold: vi.fn((text) => text),
-    green: vi.fn((text) => text),
-    red: vi.fn((text) => text),
-    gray: vi.fn((text) => text),
-  },
-}));
-
-vi.mock('inquirer', () => ({
-  default: {
-    prompt: vi.fn(),
-  },
-}));
-
-vi.mock('../../../../src/core/config/manager.js', () => ({
-  configManager: {
-    getCurrentContext: vi.fn(() => ({
-      environment: 'dev' as const,
-      service: 'liberica' as const,
-      tenant: 'test-tenant',
-    })),
-    setTenant: vi.fn(),
-  },
-}));
-
-vi.mock('../../../../src/core/auth/token-manager.js', () => ({
-  tokenManager: {
-    getToken: vi.fn(),
-    setToken: vi.fn(),
-    deleteToken: vi.fn(),
-    findAllTokens: vi.fn(() => []),
-  },
-}));
-
-vi.mock('../../../../src/core/api/client.js', () => ({
-  apiClient: {
-    login: vi.fn(),
-  },
-}));
-
-import { createLibericaAuthCommand } from '../../../../src/commands/liberica/auth/index.js';
-
-describe('createLibericaAuthCommand', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('should create command with name "auth"', () => {
-    const command = createLibericaAuthCommand();
-    expect(command.name()).toBe('auth');
-  });
-
-  it('should have description "Manage Liberica authentication"', () => {
-    const command = createLibericaAuthCommand();
-    expect(command.description()).toBe('Manage Liberica authentication');
-  });
-
-  describe('login subcommand', () => {
-    it('should exist', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      expect(loginCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      expect(loginCmd?.description()).toBe('Login to Liberica');
-    });
-
-    it('should have --env option', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const envOption = loginCmd?.options.find((opt) => opt.short === '-e' || opt.long === '--env');
-      expect(envOption).toBeDefined();
-    });
-
-    it('should have --tenant option', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const tenantOption = loginCmd?.options.find((opt) => opt.long === '--tenant');
-      expect(tenantOption).toBeDefined();
-    });
-
-    it('should have --username option', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const usernameOption = loginCmd?.options.find((opt) => opt.long === '--username');
-      expect(usernameOption).toBeDefined();
-    });
-
-    it('should have --password option', () => {
-      const command = createLibericaAuthCommand();
-      const loginCmd = command.commands.find((cmd) => cmd.name() === 'login');
-      const passwordOption = loginCmd?.options.find((opt) => opt.long === '--password');
-      expect(passwordOption).toBeDefined();
-    });
-  });
-
-  describe('status subcommand', () => {
-    it('should exist', () => {
-      const command = createLibericaAuthCommand();
-      const statusCmd = command.commands.find((cmd) => cmd.name() === 'status');
-      expect(statusCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createLibericaAuthCommand();
-      const statusCmd = command.commands.find((cmd) => cmd.name() === 'status');
-      expect(statusCmd?.description()).toBe('Check Liberica authentication status');
-    });
-  });
-
-  describe('logout subcommand', () => {
-    it('should exist', () => {
-      const command = createLibericaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      expect(logoutCmd).toBeDefined();
-    });
-
-    it('should have correct description', () => {
-      const command = createLibericaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      expect(logoutCmd?.description()).toBe('Logout from Liberica and clear token');
-    });
-
-    it('should have --env option', () => {
-      const command = createLibericaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      const envOption = logoutCmd?.options.find((opt) => opt.long === '--env');
-      expect(envOption).toBeDefined();
-    });
-
-    it('should have --all option', () => {
-      const command = createLibericaAuthCommand();
-      const logoutCmd = command.commands.find((cmd) => cmd.name() === 'logout');
-      const allOption = logoutCmd?.options.find((opt) => opt.long === '--all');
-      expect(allOption).toBeDefined();
-    });
-  });
-});
-
-describe('auth command integration', () => {
-  it('should call apiClient.login with correct parameters on login', async () => {
-    const { apiClient } = await import('../../../../src/core/api/client.js');
-    const { configManager } = await import('../../../../src/core/config/manager.js');
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-
-    (apiClient.login as ReturnType<typeof vi.fn>).mockResolvedValue({
-      success: true,
-      data: { token: 'test-token', expiresAt: '2024-12-31' },
-    });
-
-    (configManager.getCurrentContext as ReturnType<typeof vi.fn>).mockReturnValue({
-      environment: 'dev',
-      service: 'liberica',
-      tenant: 'test-tenant',
-    });
-
-    expect(apiClient.login).toBeDefined();
-  });
-
-  it('should call tokenManager.setToken after successful login', async () => {
-    const { tokenManager } = await import('../../../../src/core/auth/token-manager.js');
-    expect(tokenManager.setToken).toBeDefined();
-  });
-
-  it('should call configManager.setTenant after successful login', async () => {
-    const { configManager } = await import('../../../../src/core/config/manager.js');
-    expect(configManager.setTenant).toBeDefined();
-  });
-});