paymongo-cli 1.4.1 → 1.4.3

package/.github/copilot-instructions.md

@@ -1,95 +1,95 @@
-# PayMongo CLI - AI Agent Instructions
-
-## Project Overview
-PayMongo CLI is a TypeScript-based developer tool for PayMongo payment integration with local webhook forwarding via ngrok tunneling. It uses **ESM modules** (`"type": "module"`) with Commander.js for CLI commands.
-
-## Architecture
-
-### Code Structure
-```
-src/
-├── commands/      # CLI commands (commander.js) - one file per top-level command
-├── services/      # Core business logic
-│   ├── api/       # ApiClient - PayMongo V1 API wrapper with retries & caching
-│   ├── config/    # ConfigManager - .paymongo file handling via cosmiconfig
-│   └── web/       # Express + Socket.io for GUI dashboard
-├── types/         # TypeScript definitions + Zod schemas
-└── utils/         # Shared utilities (errors, logging, cache, validation)
-```
-
-### Key Patterns
-
-**Error Handling** - Always use custom error classes from `src/utils/errors.ts`:
-```typescript
-import { PayMongoError, NetworkError, ConfigError, ApiKeyError } from '../utils/errors.js';
-throw new PayMongoError('User-friendly message', 'ERROR_CODE', 400);
-```
-
-**Retry Logic** - Use `withRetry()` for network operations:
-```typescript
-import { withRetry } from '../utils/errors.js';
-const result = await withRetry(() => apiCall(), { maxRetries: 3, silent: true });
-```
-
-**Lazy Loading** - Import heavy dependencies inside functions to keep CLI startup fast (<100ms):
-```typescript
-// ✓ Correct - lazy load inside action
-.action(async () => {
-  const { confirm } = await import('@inquirer/prompts');
-});
-// ✗ Wrong - top-level import slows startup
-import { confirm } from '@inquirer/prompts';
-```
-
-**ESM Imports** - Always use `.js` extension for local imports:
-```typescript
-import ConfigManager from '../services/config/manager.js';
-```
-
-## Configuration
-- Project config: `.paymongo` (JSON, managed via `ConfigManager`)
-- Global credentials: `~/.paymongo/credentials.enc` (AES-256-CBC encrypted)
-- Validation: Zod schemas in `src/types/schemas.ts`
-
-## Development Workflow
-
-### Commands
-```bash
-npm run build          # Compile TypeScript
-npm run dev            # Watch mode compilation
-npm link               # Test CLI globally as 'paymongo'
-npm test               # Jest with ESM (--experimental-vm-modules)
-npm run lint:fix       # ESLint auto-fix
-```
-
-### Testing Strategy
-- **Mocking ESM**: Use `jest.unstable_mockModule()` before dynamic imports
-- Structure: `tests/unit/`, `tests/integration/`, `tests/e2e/`
-- Mock external services (axios, ngrok, filesystem)
-
-Example test pattern:
-```typescript
-jest.unstable_mockModule('axios', () => ({ default: mockAxios }));
-const { ApiClient } = await import('../../src/services/api/client.js');
-```
-
-## Code Conventions
-
-### TypeScript
-- Strict mode enabled with `noImplicitAny`, `noUncheckedIndexedAccess`
-- Avoid `any` - use proper types from `src/types/paymongo.ts`
-- Config validation via Zod: `validateConfig()` from `src/types/schemas.ts`
-
-### Commit Messages
-Follow conventional commits: `feat:`, `fix:`, `docs:`, `test:`, `refactor:`
-
-### Security
-- Never log API keys or sensitive data
-- Use `ConfigManager` for credential access
-- Keep `.paymongo` and `.env` in `.gitignore`
-
-## Key Files Reference
-- [src/services/api/client.ts](src/services/api/client.ts) - API wrapper with interceptors
-- [src/utils/errors.ts](src/utils/errors.ts) - Error classes + `withRetry()`
-- [src/types/schemas.ts](src/types/schemas.ts) - Zod validation schemas
-- [src/services/config/manager.ts](src/services/config/manager.ts) - Config file handling
+# PayMongo CLI - AI Agent Instructions
+
+## Project Overview
+PayMongo CLI is a TypeScript-based developer tool for PayMongo payment integration with local webhook forwarding via ngrok tunneling. It uses **ESM modules** (`"type": "module"`) with Commander.js for CLI commands.
+
+## Architecture
+
+### Code Structure
+```
+src/
+├── commands/      # CLI commands (commander.js) - one file per top-level command
+├── services/      # Core business logic
+│   ├── api/       # ApiClient - PayMongo V1 API wrapper with retries & caching
+│   ├── config/    # ConfigManager - .paymongo file handling via cosmiconfig
+│   └── web/       # Express + Socket.io for GUI dashboard
+├── types/         # TypeScript definitions + Zod schemas
+└── utils/         # Shared utilities (errors, logging, cache, validation)
+```
+
+### Key Patterns
+
+**Error Handling** - Always use custom error classes from `src/utils/errors.ts`:
+```typescript
+import { PayMongoError, NetworkError, ConfigError, ApiKeyError } from '../utils/errors.js';
+throw new PayMongoError('User-friendly message', 'ERROR_CODE', 400);
+```
+
+**Retry Logic** - Use `withRetry()` for network operations:
+```typescript
+import { withRetry } from '../utils/errors.js';
+const result = await withRetry(() => apiCall(), { maxRetries: 3, silent: true });
+```
+
+**Lazy Loading** - Import heavy dependencies inside functions to keep CLI startup fast (<100ms):
+```typescript
+// ✓ Correct - lazy load inside action
+.action(async () => {
+  const { confirm } = await import('@inquirer/prompts');
+});
+// ✗ Wrong - top-level import slows startup
+import { confirm } from '@inquirer/prompts';
+```
+
+**ESM Imports** - Always use `.js` extension for local imports:
+```typescript
+import ConfigManager from '../services/config/manager.js';
+```
+
+## Configuration
+- Project config: `.paymongo` (JSON, managed via `ConfigManager`)
+- Global credentials: `~/.paymongo/credentials.enc` (AES-256-CBC encrypted)
+- Validation: Zod schemas in `src/types/schemas.ts`
+
+## Development Workflow
+
+### Commands
+```bash
+npm run build          # Compile TypeScript
+npm run dev            # Watch mode compilation
+npm link               # Test CLI globally as 'paymongo'
+npm test               # Jest with ESM (--experimental-vm-modules)
+npm run lint:fix       # ESLint auto-fix
+```
+
+### Testing Strategy
+- **Mocking ESM**: Use `jest.unstable_mockModule()` before dynamic imports
+- Structure: `tests/unit/`, `tests/integration/`
+- Mock external services (axios, ngrok, filesystem)
+
+Example test pattern:
+```typescript
+jest.unstable_mockModule('axios', () => ({ default: mockAxios }));
+const { ApiClient } = await import('../../src/services/api/client.js');
+```
+
+## Code Conventions
+
+### TypeScript
+- Strict mode enabled with `noImplicitAny`, `noUncheckedIndexedAccess`
+- Avoid `any` - use proper types from `src/types/paymongo.ts`
+- Config validation via Zod: `validateConfig()` from `src/types/schemas.ts`
+
+### Commit Messages
+Follow conventional commits: `feat:`, `fix:`, `docs:`, `test:`, `refactor:`
+
+### Security
+- Never log API keys or sensitive data
+- Use `ConfigManager` for credential access
+- Keep `.paymongo` and `.env` in `.gitignore`
+
+## Key Files Reference
+- [src/services/api/client.ts](src/services/api/client.ts) - API wrapper with interceptors
+- [src/utils/errors.ts](src/utils/errors.ts) - Error classes + `withRetry()`
+- [src/types/schemas.ts](src/types/schemas.ts) - Zod validation schemas
+- [src/services/config/manager.ts](src/services/config/manager.ts) - Config file handling

package/.github/workflows/ci-cd.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        node-version: [18, 20]
+        node-version: [20, 22]
 
     steps:
       - name: Checkout code
@@ -39,50 +39,6 @@ jobs:
 
       - name: Upload coverage reports
         uses: codecov/codecov-action@v3
-        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '18'
+        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '20'
         with:
           file: ./coverage/lcov.info
-
-  release:
-    needs: test
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build project
-        run: npm run build
-
-      - name: Run tests
-        run: npm test -- --passWithNoTests
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: v${{ github.run_number }}
-          release_name: Release v${{ github.run_number }}
-          body: |
-            ## Changes
-            - Automated release from CI/CD pipeline
-            - All tests passed
-            - Code quality checks completed
-          draft: false
-          prerelease: false

package/.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x, 20.x]
+        node-version: [20.x, 22.x]
 
     steps:
     - uses: actions/checkout@v4

package/.github/workflows/release.yml

@@ -58,7 +58,7 @@ jobs:
         body: |
           ## Changes
 
-          See [CHANGELOG.md](https://github.com/leodyver/paymongo-cli/blob/main/CHANGELOG.md) for details.
+          See [CHANGELOG.md](https://github.com/leodyversemilla07/paymongo-cli/blob/main/CHANGELOG.md) for details.
 
           ## Installation
 

package/AGENTS.md

@@ -167,7 +167,6 @@ const config = validateConfig(input);
 tests/
 ├── unit/             # Unit tests (single functions/classes)
 ├── integration/      # Integration tests (command end-to-end)
-└── e2e/             # End-to-end tests (full CLI workflows)
 ```
 
 ### Mocking ESM Modules

package/CHANGELOG.md

@@ -7,12 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.3] - 2026-01-26
+
+### Added
+
+- **Enhanced Error Handling** - Improved error messages in `init`, `login`, and `env` commands with specific error types:
+  - `ApiKeyError`: Invalid or unauthorized API keys
+  - `NetworkError`: Connection and timeout issues
+  - `PayMongoError`: API-specific errors with status codes
+  - Actionable error messages with troubleshooting guidance
+
+### Changed
+
+- **Test Output Cleanup** - Suppressed verbose console output and Node.js warnings in test runs:
+  - Added `silent: true` to Jest configuration to hide CLI command output
+  - Added `NODE_NO_WARNINGS=1` to test scripts to suppress experimental VM warnings
+  - Cleaner test output focused on results rather than implementation details
+
+- **API Client Consolidation** - Merged `UndiciClient` into main `ApiClient` class:
+  - Removed separate `undici-client.ts` file
+  - Updated all imports and tests to use unified `ApiClient`
+  - Maintained all existing functionality (caching, rate limiting, error handling)
+
+### Removed
+
+- **E2E Test Suite** - Removed `tests/e2e/` folder and associated files:
+  - Deleted `tests/e2e/login.test.ts` and `tests/e2e/README.md`
+  - Removed e2e references from documentation (`CONTRIBUTING.md`, `AGENTS.md`, `.github/copilot-instructions.md`)
+  - Unit tests provide equivalent coverage without requiring real API credentials
+
+### Fixed
+
+- **Test Compatibility** - Updated test mocks to work with new error handling:
+  - Changed `validateApiKey()` from boolean return to void (throws on error)
+  - Updated test expectations for error throwing instead of boolean returns
+  - Maintained test coverage while improving error handling consistency
+
 ## [1.4.1] - 2026-01-26
 
 ### Added
 
 - **Comprehensive Test Coverage** - Added 380 unit tests across 23 test suites:
-  - Complete test coverage for 9 CLI command files (init, config, login, dev, payments, env, gui, trigger, webhooks)
+  - Complete test coverage for 8 CLI command files (init, config, login, dev, payments, env, trigger, webhooks)
   - 100% coverage for each tested command with comprehensive error handling and edge cases
   - Established testing patterns for Commander.js commands with ESM module mocking
   - Mock implementations for all external dependencies (axios, ngrok, filesystem operations)
@@ -234,6 +270,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 | Version | Release Date | Highlights                                                           |
 | ------- | ------------ | -------------------------------------------------------------------- |
+| [1.4.3] | 2026-01-26   | Enhanced error handling, test output cleanup, API client consolidation |
 | [1.4.1] | 2026-01-26   | Test coverage completion, ESLint compliance, documentation updates   |
 | [1.4.0] | 2026-01-26   | Code generation, HTTP client migration, GUI removal, performance optimization |
 | [1.3.0] | 2026-01-25   | Rate limiting protection, bulk operations, team collaboration        |
@@ -244,6 +281,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 
 ## Upgrade Guide
+### Upgrading to 1.4.3
+
+```bash
+npm install -g paymongo-cli@latest
+```
+
+**Breaking Changes:** None. This is a backward-compatible patch release.
+
+**New Features:**
+- Enhanced error handling with specific error types and actionable messages
+- Cleaner test output with suppressed console logs and warnings
+- Consolidated API client implementation
+
 ### Upgrading to 1.4.1
 
 ```bash
@@ -322,7 +372,8 @@ npm install -g paymongo-cli
 - [Issue Tracker](https://github.com/leodyversemilla07/paymongo-cli/issues)
 - [PayMongo API Documentation](https://developers.paymongo.com/)
 
-[Unreleased]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.4.1...HEAD
+[Unreleased]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.4.3...HEAD
+[1.4.3]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.4.1...v1.4.3
 [1.4.1]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.4.0...v1.4.1
 [1.4.0]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/leodyversemilla07/paymongo-cli/compare/v1.2.0...v1.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Leodyver Semilla
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Leodyver Semilla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -28,7 +28,7 @@ PayMongo CLI is the official-feel command-line tool designed to streamline your
 
 ### Prerequisites
 
-- **Node.js**: v18.0.0 or higher
+- **Node.js**: v20.0.0 or higher
 - **ngrok account**: Required for webhook forwarding (free tier works great!)
 
 ### Install via npm (Recommended)

package/TESTING.md

@@ -8,7 +8,7 @@ This document tracks the progress of improving test coverage for the PayMongo CL
 
 - **Overall Coverage**: ~65-70% statements (estimated post-all command testing completion)
 - **Target**: ≥80% statements/branches/functions/lines
-- **Progress**: API client, init command, config command, login command, dev command, env command, gui command, trigger command, webhooks command, CLI entry point, and payments command testing completed
+- **Progress**: API client, init command, config command, login command, dev command, env command, trigger command, webhooks command, CLI entry point, and payments command testing completed
 - **Total Tests**: 380 passing tests across 23 test suites
 
 ## Completed Work
@@ -107,18 +107,6 @@ This document tracks the progress of improving test coverage for the PayMongo CL
   - Resolved Commander.js testing by using `command.parseAsync()` pattern
   - All 12 tests passing, comprehensive validation and error handling covered
 
-- **GUI Command Testing**: ✅ **COMPLETED**
-  - Created comprehensive test file `tests/unit/gui-command.test.ts` with 11 test cases achieving 100% coverage
-  - Coverage improved to full coverage for src/commands/gui.ts
-  - Added tests for:
-    - GUI dashboard startup with default/custom port and host options
-    - WebServer integration and graceful shutdown handling
-    - SIGINT/SIGTERM signal handling for clean shutdown
-    - No configuration error handling
-    - Server startup error scenarios
-  - Resolved complex WebServer mocking and signal handler testing
-  - All 11 tests passing, comprehensive startup and shutdown scenarios covered
-
 - **Trigger Command Testing**: ✅ **COMPLETED**
   - Created comprehensive test file `tests/unit/trigger-command.test.ts` with 16 test cases achieving 100% coverage
   - Coverage improved to full coverage for src/commands/trigger.ts
@@ -175,7 +163,6 @@ This document tracks the progress of improving test coverage for the PayMongo CL
 | src/commands/dev.ts               | ~60%       | ~50%      | ~70%      | ~60%        | ✅ **Completed**     |
 | **src/commands/payments.ts**      | **100%**   | **100%**  | **100%**  | **100%**    | ✅ **Completed**     |
 | **src/commands/env.ts**           | **100%**   | **100%**  | **100%**  | **100%**    | ✅ **Completed**     |
-| **src/commands/gui.ts**           | **100%**   | **100%**  | **100%**  | **100%**    | ✅ **Completed**     |
 | **src/commands/trigger.ts**       | **100%**   | **100%**  | **100%**  | **100%**    | ✅ **Completed**     |
 | **src/commands/webhooks.ts**      | **100%**   | **100%**  | **100%**  | **100%**    | ✅ **Completed**     |
 | All other command files           | 0%         | 0%        | 0%        | Not started |