paymongo-cli 1.0.0

package/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,33 @@
+---
+name: Bug Report
+about: Report a bug or issue with the PayMongo CLI
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+1. Run command: `paymongo ...`
+2. Expected behavior: ...
+3. Actual behavior: ...
+
+## Environment
+
+- OS: [e.g., Windows 10, macOS 12.1, Ubuntu 20.04]
+- Node.js version: [e.g., 18.12.0]
+- CLI version: [e.g., 1.0.0]
+- PayMongo environment: [test/live]
+
+## Additional Context
+
+Add any other context about the problem here, such as:
+
+- Error messages
+- Screenshots
+- Configuration files
+- API responses

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,30 @@
+## Description
+
+Brief description of the changes made.
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation update
+- [ ] Refactoring
+- [ ] Test addition
+
+## Testing
+
+- [ ] Unit tests pass
+- [ ] Integration tests pass
+- [ ] Manual testing completed
+
+## Checklist
+
+- [ ] Code follows existing patterns
+- [ ] Tests added for new functionality
+- [ ] Documentation updated
+- [ ] Breaking changes documented
+- [ ] Commit messages are clear
+
+## Additional Notes
+
+Any additional context or screenshots.

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

@@ -0,0 +1,88 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node-version: [18, 20]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run type checking
+        run: npm run build
+
+      - name: Run tests
+        run: npm test -- --coverage --passWithNoTests
+        continue-on-error: true # Allow Windows file locking issues
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v3
+        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '18'
+        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

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Run linter
+      run: npm run lint
+
+    - name: Run tests
+      run: npm test
+
+    - name: Build project
+      run: npm run build
+
+    - name: Run build tests
+      run: |
+        # Test CLI help commands
+        node bin/paymongo.js --help
+        node bin/paymongo.js init --help
+        node bin/paymongo.js dev --help
+        node bin/paymongo.js login --help
+        node bin/paymongo.js config --help
+        node bin/paymongo.js webhooks --help

package/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js 20.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+        cache: 'npm'
+        registry-url: 'https://registry.npmjs.org'
+
+    - name: Install dependencies
+      run: npm ci
+
+    - name: Run tests
+      run: npm test
+
+    - name: Build project
+      run: npm run build
+
+    - name: Publish to npm
+      run: npm publish
+      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: ${{ github.ref }}
+        release_name: Release ${{ github.ref }}
+        body: |
+          ## Changes
+
+          See [CHANGELOG.md](https://github.com/leodyver/paymongo-cli/blob/main/CHANGELOG.md) for details.
+
+          ## Installation
+
+          ```bash
+          npm install -g paymongo-cli
+          ```
+        draft: false
+        prerelease: false

package/LICENSE

@@ -0,0 +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
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# PayMongo CLI
+
+> **A developer-first CLI for PayMongo integration with local webhook forwarding.**
+
+PayMongo CLI is the official-feel command-line tool designed to streamline your development process with PayMongo. It solves the biggest pain point in payment integration: **testing webhooks locally**.
+
+[![npm version](https://img.shields.io/npm/v/paymongo-cli.svg)](https://www.npmjs.com/package/paymongo-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+---
+
+## Key Features
+
+- **Local Webhook Forwarding**: Seamlessly receive PayMongo webhooks on your localhost using integrated `ngrok` tunneling.
+- **Zero-Config Setup**: Get started in seconds with `paymongo init`.
+- **Payment Testing**: Create and monitor payment intents and payments directly from your terminal.
+- **Real-time Monitoring**: Watch webhook events as they happen with formatted logs or a web-based GUI.
+- **Team Collaboration**: Sync configurations across your team using GitHub integration.
+- **Web Dashboard**: Use `paymongo gui` for a premium visual monitoring experience.
+- **Secure Management**: Encrypted storage for your API keys.
+
+---
+
+## Installation
+
+### Prerequisites
+
+- **Node.js**: v18.0.0 or higher
+- **ngrok account**: Required for webhook forwarding (free tier works great!)
+
+### Install via npm (Recommended)
+
+```bash
+npm install -g paymongo-cli
+```
+
+### Setup ngrok Authtoken
+
+To use the `dev` server with webhook forwarding, you need an ngrok authtoken:
+
+1. Sign up at [ngrok.com](https://ngrok.com)
+2. Copy your authtoken from the [ngrok dashboard](https://dashboard.ngrok.com/get-started/your-authtoken)
+3. Configure it in the CLI:
+
+```bash
+paymongo config set ngrok.authtoken YOUR_AUTHTOKEN
+```
+
+---
+
+## Quick Start
+
+### 1. Initialize Project
+
+```bash
+mkdir my-paymongo-app
+cd my-paymongo-app
+paymongo init
+```
+
+### 2. Start Development Server
+
+This command sets up a tunnel and starts forwarding webhooks to your local app.
+
+```bash
+paymongo dev --port 3000
+```
+
+### 3. Trigger a Test Webhook
+
+In another terminal, simulate a successful payment:
+
+```bash
+paymongo trigger --event payment.paid
+```
+
+---
+
+## Commands Reference
+
+| Command             | Description                                             |
+| :------------------ | :------------------------------------------------------ |
+| `paymongo init`     | Initialize a new project and set up credentials.        |
+| `paymongo dev`      | Start local development server with webhook forwarding. |
+| `paymongo payments` | Manage payments and payment intents.                    |
+| `paymongo webhooks` | List, create, and manage PayMongo webhooks.             |
+| `paymongo config`   | View and modify CLI configuration.                      |
+| `paymongo team`     | Sync configurations with your team via GitHub.          |
+| `paymongo gui`      | Launch the web-based monitoring dashboard.              |
+| `paymongo trigger`  | Simulate webhook events locally for testing.            |
+
+> Use `paymongo <command> --help` for detailed information on any command.
+
+---
+
+## Documentation
+
+- **[Installation Guide](INSTALLATION.md)** - Platform-specific setup instructions.
+- **[User Guide](USER_GUIDE.md)** - Detailed step-by-step instructions.
+- **[API Reference](API_REFERENCE.md)** - Complete command and option reference.
+- **[Troubleshooting](TROUBLESHOOTING.md)** - Solutions to common issues.
+- **[Contributing](CONTRIBUTING.md)** - Help improve the PayMongo CLI.
+
+---
+
+## Built for Filipino Developers
+
+PayMongo CLI is crafted to empower Filipino developers building the next generation of fintech solutions.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/bin/paymongo.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index.js');