paymongo-cli 1.4.2 → 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/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.