paymongo-cli 1.4.9 → 1.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.4.11] - 2026-03-08
11
+
12
+ ### Changed
13
+
14
+ - **README Positioning** - Reframed the project around its core developer use case: local webhook testing, payment intent workflows, and PayMongo integration debugging.
15
+ - **Quick Start** - Added a `payments attach` example to the README to reflect the current Payment Intent workflow exposed by the CLI.
16
+ - **Repository Metadata** - Updated the GitHub repository description to match the CLI's actual product positioning and primary use cases.
17
+
18
+ ## [1.4.10] - 2026-03-08
19
+
20
+ ### Changed
21
+
22
+ - **Official API Alignment** - Updated webhook management to use disable/enable semantics instead of hard delete, while keeping the old delete command as a compatibility alias.
23
+ - **Payment Intent Flow** - Switched the payment intent action path to PayMongo's current attach flow and updated the CLI to expose `payments attach` with `confirm` retained as an alias.
24
+ - **Webhook Signing** - Aligned local webhook signature parsing, trigger signing, and generated webhook handler templates with PayMongo's documented `Paymongo-Signature` header format for test and live signatures.
25
+
26
+ ### Fixed
27
+
28
+ - **Developer UX** - Updated command help text, user documentation, troubleshooting guidance, and CLI examples so the surfaced behavior matches the current PayMongo documentation and the CLI implementation.
29
+ - **Regression Coverage** - Expanded unit coverage for webhook disable/enable behavior, payment intent attachment, dev-server signature verification, and compatibility aliases.
30
+
10
31
  ## [1.4.9] - 2026-03-08
11
32
 
12
33
  ### Fixed
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # PayMongo CLI
2
2
 
3
- > **A developer-first CLI for PayMongo integration with local webhook forwarding.**
3
+ > **A developer CLI for PayMongo local webhook testing, payment intent workflows, and integration debugging.**
4
4
 
5
- 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**.
5
+ PayMongo CLI is a terminal-first tool for developers integrating PayMongo. It is built to shorten the feedback loop around **local webhook testing**, **payment intent workflows**, and **integration debugging** without living in the dashboard.
6
6
 
7
7
  [![npm version](https://img.shields.io/npm/v/paymongo-cli.svg)](https://www.npmjs.com/package/paymongo-cli)
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -13,11 +13,11 @@ PayMongo CLI is the official-feel command-line tool designed to streamline your
13
13
  ## Key Features
14
14
 
15
15
  - **Local Webhook Forwarding**: Seamlessly receive PayMongo webhooks on your localhost using integrated `ngrok` tunneling.
16
+ - **Webhook Triggering and Replay**: Simulate and inspect PayMongo webhook events during development.
17
+ - **Payment Intent Workflows**: Create intents, attach payment methods, capture authorized payments, and create refunds from the terminal.
16
18
  - **Zero-Config Setup**: Get started in seconds with `paymongo init`.
17
- - **Payment Testing**: Create and monitor payment intents and payments directly from your terminal.
18
19
  - **Real-time Monitoring**: Watch webhook events as they happen with formatted terminal logs.
19
20
  - **Privacy-First Analytics**: Optional local webhook event tracking to improve your development workflow (opt-in only).
20
- - **Team Collaboration**: Share API key bundles with teammates for test/live environments.
21
21
  - **Bulk Operations**: Import/export payments and webhooks for easy migration between environments.
22
22
  - **Rate Limiting Protection**: Built-in API abuse prevention with configurable limits and automatic backoff.
23
23
  - **Secure Management**: Local credential encryption for stored login sessions.
@@ -79,6 +79,14 @@ In another terminal, simulate a successful payment:
79
79
  paymongo trigger --event payment.paid
80
80
  ```
81
81
 
82
+ ### 4. Attach a Payment Method to an Intent
83
+
84
+ Attach a real payment method, or use the built-in simulation flow during development:
85
+
86
+ ```bash
87
+ paymongo payments attach pi_123 --simulate --method gcash
88
+ ```
89
+
82
90
  ---
83
91
 
84
92
  ## Rate Limiting Protection
@@ -170,7 +178,6 @@ Analytics data helps you:
170
178
  | `paymongo config` | View and modify CLI configuration. |
171
179
  | `paymongo config analytics` | Configure webhook analytics settings. |
172
180
  | `paymongo config rate-limit` | Configure rate limiting settings. |
173
- | `paymongo team` | Share API key bundles with your team. |
174
181
  | `paymongo trigger` | Simulate webhook events locally for testing. |
175
182
 
176
183
  > Use `paymongo <command> --help` for detailed information on any command.
@@ -187,9 +194,15 @@ Analytics data helps you:
187
194
 
188
195
  ---
189
196
 
190
- ## Built for Filipino Developers
197
+ ## Use Case
198
+
199
+ PayMongo CLI is intended for developers working on PayMongo-powered applications in local, QA, and staging environments. It is most useful when you need to:
191
200
 
192
- PayMongo CLI is crafted to empower Filipino developers building the next generation of fintech solutions.
201
+ - receive PayMongo webhooks on localhost
202
+ - validate webhook signature handling
203
+ - test payment intent attachment and capture flows
204
+ - inspect payments and refunds without leaving the terminal
205
+ - debug PayMongo integrations faster than a dashboard-only workflow
193
206
 
194
207
  ## License
195
208