@flintpay/cli 0.1.1 → 0.2.0

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.
Files changed (2) hide show
  1. package/README.md +14 -9
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -16,21 +16,26 @@ This package resolves a prebuilt binary for your platform. Node `>=18` is requir
16
16
  brew install flint-pay/tap/flint
17
17
  ```
18
18
 
19
- ## Authenticate
19
+ ## Sign in (recommended)
20
20
 
21
- Create a sandbox key in the [Flint dashboard](https://app.withflintpay.com/developers/api-keys), then import it:
21
+ For local development, sign in through the Flint website:
22
22
 
23
23
  ```bash
24
- flint auth import
24
+ flint auth login
25
+ flint doctor
25
26
  ```
26
27
 
27
- The key is validated against the API and stored in your OS keychain, not in a config file. If you do not have an account yet, `flint signup` completes machine-actionable onboarding steps and stores the initial sandbox key as soon as the API makes it available.
28
+ Confirm the code shown in your terminal and approve CLI access on the website. Flint validates the OAuth session and stores its access and refresh tokens in your OS keychain. Use `--no-open` to open the printed link yourself, `--profile NAME` for an existing profile, or `--live` to explicitly request production access.
28
29
 
29
- Confirm everything works:
30
+ Browser login has been verified against Flint staging. To use staging, set `FLINT_BASE_URL=https://api.staging.withflintpay.com` for login and subsequent commands. Production rollout is separate; use `flint auth import` on servers without browser login support.
30
31
 
31
- ```bash
32
- flint doctor
33
- ```
32
+ Access tokens refresh automatically as needed. `flint auth logout --confirm` revokes the OAuth session before removing its local credentials. If the server does not confirm revocation, logout reports failure and retains the credentials for retry. Imported API-key logout still removes only the local key.
33
+
34
+ `flint login` is a shortcut for `flint auth login`. Related shortcuts: `flint logout` for `flint auth logout`, and `flint whoami` for `flint auth status`.
35
+
36
+ ### API keys and automation
37
+
38
+ For manual setup, create a key in the [Flint dashboard](https://app.withflintpay.com/developers/api-keys) and run `flint auth import`. For CI, supply `FLINT_API_KEY` through your secret store and set `FLINT_NO_INPUT=1`. `flint signup` remains available for creating an account from the terminal.
34
39
 
35
40
  ## Take a payment
36
41
 
@@ -54,7 +59,7 @@ This streams your sandbox's events to a local server with a real signature, so y
54
59
 
55
60
  ## Scripting
56
61
 
57
- For bounded commands, `--output json` prints one JSON envelope on stdout and disables every prompt. Streaming commands emit newline-delimited JSON instead. `flint listen --output json` writes one listener, webhook event, delivery result, or checkpoint object per line; use `--max-events` or `--for` to bound it. Diagnostics and progress go to stderr, so stdout stays a clean data stream.
62
+ For bounded commands, `--output json` prints one JSON envelope on stdout and disables terminal input prompts. `flint auth login` still requires approval on the website; use `FLINT_NO_INPUT=1` to prohibit browser login in automation. Streaming commands emit newline-delimited JSON instead. `flint listen --output json` writes one listener, webhook event, delivery result, or checkpoint object per line; use `--max-events` or `--for` to bound it. Diagnostics and progress go to stderr, so stdout stays a clean data stream.
58
63
 
59
64
  Exit codes are stable: `0` success, `1` API error, `2` usage error, `3` auth or config, `4` confirmation required, `5` network, `6` `--wait-for` timed out, `70` internal error.
60
65
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@flintpay/cli",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
4
  "description": "Flint Pay command-line interface",
5
5
  "mcpName": "com.withflintpay/cli",
6
6
  "license": "Apache-2.0",
@@ -16,11 +16,11 @@
16
16
  "node": ">=18"
17
17
  },
18
18
  "optionalDependencies": {
19
- "@flintpay/cli-darwin-arm64": "0.1.1",
20
- "@flintpay/cli-darwin-amd64": "0.1.1",
21
- "@flintpay/cli-linux-arm64": "0.1.1",
22
- "@flintpay/cli-linux-amd64": "0.1.1",
23
- "@flintpay/cli-windows-amd64": "0.1.1"
19
+ "@flintpay/cli-darwin-arm64": "0.2.0",
20
+ "@flintpay/cli-darwin-amd64": "0.2.0",
21
+ "@flintpay/cli-linux-arm64": "0.2.0",
22
+ "@flintpay/cli-linux-amd64": "0.2.0",
23
+ "@flintpay/cli-windows-amd64": "0.2.0"
24
24
  },
25
25
  "repository": {
26
26
  "type": "git",