@flintpay/cli 0.3.0 → 0.4.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.
- package/README.md +7 -5
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Every command maps to a documented `/v1` route, so anything you can do over HTTP
|
|
|
10
10
|
npm install -g @flintpay/cli
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
On macOS and Linux, run `flint upgrade` to update the global package and its platform binary to the latest stable release. On Windows, the command prints the exact npm update to run after closing the CLI.
|
|
13
|
+
On macOS and Linux, run `flint upgrade` (or its alias `flint update`) to update the global package and its platform binary to the latest stable release. On Windows, the command prints the exact npm update to run after closing the CLI.
|
|
14
14
|
|
|
15
15
|
This package resolves a prebuilt binary for your platform. Node `>=18` is required to run the installer. On macOS and Linux you can install with Homebrew instead:
|
|
16
16
|
|
|
@@ -29,7 +29,9 @@ flint doctor
|
|
|
29
29
|
|
|
30
30
|
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.
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
If browser login is unavailable, use `flint auth import` instead.
|
|
33
|
+
|
|
34
|
+
Browser login grants baseline permissions for common development workflows. Some command groups, including subscriptions, payouts, reports, risk, and advanced commerce operations, require additional access. Add scopes to the active context with `flint reauth --scope SCOPE`; repeat `--scope` when an operation requires multiple scopes. The browser may approve only part of a request, and the CLI reports what was approved. Known command requirements are checked before a request is sent.
|
|
33
35
|
|
|
34
36
|
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.
|
|
35
37
|
|
|
@@ -37,7 +39,7 @@ Access tokens refresh automatically as needed. `flint auth logout --confirm` rev
|
|
|
37
39
|
|
|
38
40
|
### Sessions and contexts
|
|
39
41
|
|
|
40
|
-
|
|
42
|
+
Approve access to selected merchants, sandboxes, and live contexts once in the browser, then select where commands run:
|
|
41
43
|
|
|
42
44
|
```sh
|
|
43
45
|
flint login
|
|
@@ -51,13 +53,13 @@ flint reauth # change browser-approved access
|
|
|
51
53
|
|
|
52
54
|
`flint login` reuses a valid saved OAuth session and starts browser approval again when the server confirms that the session expired or was revoked. Temporary connection failures or loss of access to one context do not automatically replace the session. Use `flint login --new-session` to replace it after browser approval; the CLI then attempts to revoke the previous session. `flint logout --confirm` revokes the entire session across its contexts.
|
|
53
55
|
|
|
54
|
-
Manage and revoke sessions on the [CLI sessions page](https://app.withflintpay.com/developers/cli).
|
|
56
|
+
Manage and revoke sessions on the [CLI sessions page](https://app.withflintpay.com/developers/cli).
|
|
55
57
|
|
|
56
58
|
Context selection uses `--context ID`, then a project's `.flint/config.json` `context` field, then the profile default. For example, `{"context":"ctx_development"}` pins a project. Switching changes the profile default, not a project pin. Each running command retains its starting context. Access tokens remain restricted to one context and refresh automatically. LIVE contexts are labeled in the selector and command diagnostics; selected multi-context sessions do not need `--live` on every command, while sensitive/destructive operations still require confirmation.
|
|
57
59
|
|
|
58
60
|
Environment credentials (`FLINT_API_KEY`, `FLINT_ACCESS_TOKEN`, or `FLINT_CHECKOUT_SESSION_SECRET`) override configured browser-session contexts. An explicit `--context` cannot be combined with these overrides. Merchant and sandbox guards still apply.
|
|
59
61
|
|
|
60
|
-
|
|
62
|
+
If `flint context list` reports that contexts are unavailable, your existing login remains usable and keeps its live-mode safeguards. Run `flint reauth` later to authorize multiple contexts.
|
|
61
63
|
|
|
62
64
|
### API keys and automation
|
|
63
65
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@flintpay/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.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.
|
|
20
|
-
"@flintpay/cli-darwin-amd64": "0.
|
|
21
|
-
"@flintpay/cli-linux-arm64": "0.
|
|
22
|
-
"@flintpay/cli-linux-amd64": "0.
|
|
23
|
-
"@flintpay/cli-windows-amd64": "0.
|
|
19
|
+
"@flintpay/cli-darwin-arm64": "0.4.0",
|
|
20
|
+
"@flintpay/cli-darwin-amd64": "0.4.0",
|
|
21
|
+
"@flintpay/cli-linux-arm64": "0.4.0",
|
|
22
|
+
"@flintpay/cli-linux-amd64": "0.4.0",
|
|
23
|
+
"@flintpay/cli-windows-amd64": "0.4.0"
|
|
24
24
|
},
|
|
25
25
|
"repository": {
|
|
26
26
|
"type": "git",
|