@putdotio/cli 1.0.3 → 1.0.5

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 CHANGED
@@ -15,60 +15,31 @@
15
15
 
16
16
  ## Install
17
17
 
18
- Choose the install path that fits your environment.
19
-
20
- Install with the macOS/Linux helper script:
18
+ Recommended on macOS and Linux:
21
19
 
22
20
  ```bash
23
21
  curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | sh
24
22
  ```
25
23
 
26
- The installer downloads the latest release binary, verifies the matching `.sha256` file, and installs `putio` into `~/.local/bin` by default.
24
+ That installs the latest release to `~/.local/bin/putio`.
27
25
 
28
- Useful overrides:
26
+ Install somewhere else:
29
27
 
30
28
  ```bash
31
29
  curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | INSTALL_DIR=/usr/local/bin sh
32
- curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | PUTIO_CLI_VERSION=1.0.0 sh
33
30
  ```
34
31
 
35
- Install with npm if you already want the package through Node.js:
32
+ If you want npm:
36
33
 
37
34
  ```bash
38
35
  npm install --global @putdotio/cli
39
36
  ```
40
37
 
41
- This path requires Node `24.14+`.
42
-
43
- Install manually from GitHub Releases if you prefer to handle the archive yourself or you are on Windows:
44
-
45
- 1. Download the matching asset from [GitHub Releases](https://github.com/putdotio/putio-cli/releases/latest).
46
- 2. Download the matching `.sha256` file for that asset.
47
- 3. Verify the checksum.
48
- 4. Extract the archive and place `putio` on your `PATH`.
49
-
50
- Example asset names:
51
-
52
- - `putio-cli-1.0.2-darwin-arm64.tar.gz`
53
- - `putio-cli-1.0.2-linux-amd64.tar.gz`
54
- - `putio-cli-1.0.2-windows-amd64.zip`
55
-
56
- Verify a release binary on macOS or Linux:
38
+ Requires Node `24.14+`.
57
39
 
58
- ```bash
59
- shasum -a 256 -c putio-cli-1.0.2-linux-amd64.tar.gz.sha256
60
- tar -xzf putio-cli-1.0.2-linux-amd64.tar.gz
61
- chmod +x putio
62
- mv putio /usr/local/bin/putio
63
- ```
64
-
65
- Verify a release binary on Windows PowerShell:
40
+ Windows or manual install:
66
41
 
67
- ```powershell
68
- $expected = (Get-Content .\putio-cli-1.0.2-windows-amd64.zip.sha256).Split()[0]
69
- $actual = (Get-FileHash .\putio-cli-1.0.2-windows-amd64.zip -Algorithm SHA256).Hash.ToLower()
70
- if ($actual -ne $expected) { throw "Checksum mismatch" }
71
- ```
42
+ Download the matching archive from [GitHub Releases](https://github.com/putdotio/putio-cli/releases/latest), verify the `.sha256`, extract it, and put `putio` on your `PATH`.
72
43
 
73
44
  Confirm the installed CLI:
74
45
 
@@ -78,45 +49,44 @@ putio version
78
49
 
79
50
  ## Quick Start
80
51
 
81
- Inspect the machine-readable command surface before guessing flags or payloads:
52
+ Inspect the live contract:
82
53
 
83
54
  ```bash
84
55
  putio describe
85
56
  ```
86
57
 
87
- Start the device-link login flow:
58
+ Link your account:
88
59
 
89
60
  ```bash
90
61
  putio auth login --open
91
62
  ```
92
63
 
93
- Then confirm the linked account:
64
+ Check the account:
94
65
 
95
66
  ```bash
96
67
  putio whoami --output json
97
68
  ```
98
69
 
99
- List a small structured file result:
70
+ Read a small JSON result:
100
71
 
101
72
  ```bash
102
73
  putio files list --per-page 5 --fields files,total --output json
103
74
  ```
104
75
 
105
- For larger reads, prefer streamed output:
76
+ Stream larger reads:
106
77
 
107
78
  ```bash
108
79
  putio transfers list --page-all --output ndjson
109
80
  ```
110
81
 
111
- ## Usage Notes
82
+ ## Tips
112
83
 
113
84
  - Use `--output json` when you want a stable machine-readable contract for scripts, agents, and automation.
114
85
  - Use `--output ndjson` for large or continuous read workflows.
115
86
  - Use `--fields` to keep structured responses small.
116
87
  - Use `--dry-run` before mutating commands.
117
- - Set `PUTIO_CLI_TOKEN` when you want fully headless auth.
88
+ - Set `PUTIO_CLI_TOKEN` for headless auth.
118
89
  - Use `PUTIO_CLI_CONFIG_PATH` to override the default config location.
119
- - `putio auth login` always prints the approval URL and code, so it still works in headless and remote environments.
120
90
 
121
91
  ## Docs
122
92
 
@@ -124,10 +94,6 @@ putio transfers list --page-all --output ndjson
124
94
  - [Contributing](./CONTRIBUTING.md)
125
95
  - [Security](./SECURITY.md)
126
96
 
127
- ## Contributing
128
-
129
- Contributor setup, development workflow, and validation live in [CONTRIBUTING.md](./CONTRIBUTING.md).
130
-
131
97
  ## License
132
98
 
133
99
  This project is available under the MIT license. See [LICENSE](./LICENSE).
package/dist/bin.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { A as translate, C as CliOutput, D as CliConfigLive, E as renderJson, O as CliRuntime, S as CliSdkLive, T as detectOutputModeFromArgv, a as searchCommand, c as brandCommand, i as filesCommand, j as version, k as CliRuntimeLive, l as versionCommand, m as CliStateLive, n as whoamiCommand, o as eventsCommand, r as transfersCommand, s as downloadLinksCommand, t as describeCli, u as makeAuthCommand, w as CliOutputLive } from "./metadata-CzLOa5IP.mjs";
2
+ import { A as translate, C as CliOutput, D as CliConfigLive, E as renderJson, O as CliRuntime, S as CliSdkLive, T as detectOutputModeFromArgv, a as searchCommand, c as brandCommand, i as filesCommand, j as version, k as CliRuntimeLive, l as versionCommand, m as CliStateLive, n as whoamiCommand, o as eventsCommand, r as transfersCommand, s as downloadLinksCommand, t as describeCli, u as makeAuthCommand, w as CliOutputLive } from "./metadata-B3uYuYUM.mjs";
3
3
  import { Cause, Console, Effect, Layer } from "effect";
4
4
  import { Command } from "@effect/cli";
5
5
  import { NodeContext, NodeRuntime } from "@effect/platform-node";
package/dist/index.mjs CHANGED
@@ -1,2 +1,2 @@
1
- import { _ as clearPersistedState, b as resolveAuthState, d as AuthStateError, f as AuthStatusSchema, g as ResolvedAuthStateSchema, h as PutioCliConfigSchema, m as CliStateLive, p as CliState, t as describeCli, v as getAuthStatus, x as savePersistedState, y as loadPersistedState } from "./metadata-CzLOa5IP.mjs";
1
+ import { _ as clearPersistedState, b as resolveAuthState, d as AuthStateError, f as AuthStatusSchema, g as ResolvedAuthStateSchema, h as PutioCliConfigSchema, m as CliStateLive, p as CliState, t as describeCli, v as getAuthStatus, x as savePersistedState, y as loadPersistedState } from "./metadata-B3uYuYUM.mjs";
2
2
  export { AuthStateError, AuthStatusSchema, CliState, CliStateLive, PutioCliConfigSchema, ResolvedAuthStateSchema, clearPersistedState, describeCli, getAuthStatus, loadPersistedState, resolveAuthState, savePersistedState };
@@ -13,7 +13,7 @@ import * as FileSystem from "@effect/platform/FileSystem";
13
13
  import { SystemError } from "@effect/platform/Error";
14
14
  //#region package.json
15
15
  var name = "@putdotio/cli";
16
- var version = "1.0.3";
16
+ var version = "1.0.5";
17
17
  //#endregion
18
18
  //#region src/i18n/translate.ts
19
19
  const resources = { en: { translation: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@putdotio/cli",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
4
4
  "description": "Agent-first CLI for the put.io API.",
5
5
  "homepage": "https://github.com/putdotio/putio-cli#readme",
6
6
  "bugs": {