@putdotio/cli 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) put.io
+
+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,132 @@
+<div align="center">
+  <p>
+    <img src="https://static.put.io/images/putio-boncuk.png" width="72">
+  </p>
+
+  <h1>putio-cli</h1>
+
+  <p>Agent-first CLI for the put.io API</p>
+  <p>Built for deterministic automation first, with readable terminal output when humans are driving.</p>
+
+  <p>
+    <a href="https://github.com/putdotio/putio-cli/actions/workflows/ci.yml?query=branch%3Amain" style="text-decoration:none;"><img src="https://img.shields.io/github/actions/workflow/status/putdotio/putio-cli/ci.yml?branch=main&style=flat&label=ci&colorA=000000&colorB=000000" alt="CI"></a>
+  </p>
+</div>
+
+## Install
+
+Choose the install path that fits your environment.
+
+Install with the macOS/Linux helper script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | sh
+```
+
+The installer downloads the latest release binary, verifies the matching `.sha256` file, and installs `putio` into `~/.local/bin` by default.
+
+Useful overrides:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | INSTALL_DIR=/usr/local/bin sh
+curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh | PUTIO_CLI_VERSION=1.0.0 sh
+```
+
+Install with npm if you already want the package through Node.js:
+
+```bash
+npm install --global @putdotio/cli
+```
+
+This path requires Node `24.14+`.
+
+Install manually from GitHub Releases if you prefer to handle the binary yourself or you are on Windows:
+
+1. Download the matching asset from [GitHub Releases](https://github.com/putdotio/putio-cli/releases/latest).
+2. Download the matching `.sha256` file for that asset.
+3. Verify the checksum.
+4. Mark the binary executable on macOS/Linux and place it on your `PATH`.
+
+Example asset names:
+
+- `putio-darwin-arm64`
+- `putio-linux-x64`
+- `putio-win32-x64.exe`
+
+Verify a release binary on macOS or Linux:
+
+```bash
+shasum -a 256 -c putio-linux-x64.sha256
+chmod +x putio-linux-x64
+mv putio-linux-x64 /usr/local/bin/putio
+```
+
+Verify a release binary on Windows PowerShell:
+
+```powershell
+$expected = (Get-Content .\putio-win32-x64.exe.sha256).Split()[0]
+$actual = (Get-FileHash .\putio-win32-x64.exe -Algorithm SHA256).Hash.ToLower()
+if ($actual -ne $expected) { throw "Checksum mismatch" }
+```
+
+Confirm the installed CLI:
+
+```bash
+putio version
+```
+
+## Quick Start
+
+Inspect the machine-readable command surface before guessing flags or payloads:
+
+```bash
+putio describe
+```
+
+Start the device-link login flow:
+
+```bash
+putio auth login --open
+```
+
+Then confirm the linked account:
+
+```bash
+putio whoami --output json
+```
+
+List a small structured file result:
+
+```bash
+putio files list --per-page 5 --fields files,total --output json
+```
+
+For larger reads, prefer streamed output:
+
+```bash
+putio transfers list --page-all --output ndjson
+```
+
+## Usage Notes
+
+- Use `--output json` when you want a stable machine-readable contract for scripts, agents, and automation.
+- Use `--output ndjson` for large or continuous read workflows.
+- Use `--fields` to keep structured responses small.
+- Use `--dry-run` before mutating commands.
+- Set `PUTIO_CLI_TOKEN` when you want fully headless auth.
+- Use `PUTIO_CLI_CONFIG_PATH` to override the default config location.
+- `putio auth login` always prints the approval URL and code, so it still works in headless and remote environments.
+
+## Docs
+
+- [Architecture](./docs/ARCHITECTURE.md)
+- [Contributing](./CONTRIBUTING.md)
+- [Security](./SECURITY.md)
+
+## Contributing
+
+Contributor setup, development workflow, and validation live in [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+This project is available under the MIT license. See [LICENSE](./LICENSE).

package/dist/bin.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+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-C1rESM1p.mjs";
+import { Cause, Console, Effect, Layer } from "effect";
+import { Command } from "@effect/cli";
+import { NodeContext, NodeRuntime } from "@effect/platform-node";
+import * as NodeTerminal from "@effect/platform-node/NodeTerminal";
+//#region src/cli.ts
+const authCommand = makeAuthCommand();
+const describeCommand = Command.make("describe", {}, () => Console.log(renderJson(describeCli())));
+const command = Command.make("putio", {}, () => Console.log(translate("cli.root.help"))).pipe(Command.withSubcommands([
+	describeCommand,
+	brandCommand,
+	versionCommand,
+	authCommand,
+	whoamiCommand,
+	downloadLinksCommand,
+	eventsCommand,
+	filesCommand,
+	searchCommand,
+	transfersCommand
+]));
+function runCli(args) {
+	return Command.run(command, {
+		name: "putio",
+		version: `v${version}`
+	})(args);
+}
+//#endregion
+//#region src/internal/app-layer.ts
+const makeCliAppLayer = (runtime) => {
+	const runtimeLayer = runtime ? Layer.succeed(CliRuntime, runtime) : CliRuntimeLive;
+	return Layer.mergeAll(NodeContext.layer, NodeTerminal.layer, runtimeLayer, CliOutputLive.pipe(Layer.provide(runtimeLayer)), CliConfigLive.pipe(Layer.provide(runtimeLayer)), CliSdkLive, CliStateLive);
+};
+//#endregion
+//#region src/bin.ts
+NodeRuntime.runMain(Effect.scoped(Effect.flatMap(CliRuntime, (runtime) => runCli(runtime.argv)).pipe(Effect.catchAllCause((cause) => Effect.gen(function* () {
+	const cliOutput = yield* CliOutput;
+	const runtime = yield* CliRuntime;
+	const outputMode = detectOutputModeFromArgv(runtime.argv, runtime.isInteractiveTerminal);
+	yield* cliOutput.error(cliOutput.formatError(Cause.squash(cause), outputMode));
+	yield* runtime.setExitCode(1);
+})), Effect.provide(makeCliAppLayer()))));
+//#endregion
+export {};

package/dist/index.mjs

@@ -0,0 +1,2 @@
+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-C1rESM1p.mjs";
+export { AuthStateError, AuthStatusSchema, CliState, CliStateLive, PutioCliConfigSchema, ResolvedAuthStateSchema, clearPersistedState, describeCli, getAuthStatus, loadPersistedState, resolveAuthState, savePersistedState };