peakurl 0.0.2 → 0.1.0

package/README.md

@@ -2,112 +2,87 @@
 
 `peakurl` is the official command-line interface for PeakURL.
 
+It gives you a fast way to create, inspect, list, and remove short links from the terminal while keeping default output readable for humans and optional `--json` output friendly for scripts.
+
 ## Install
 
+Requirements: Node.js 20 or later.
+
 ```bash
 npm install -g peakurl
 ```
 
-The npm package name is unscoped and the executable is also `peakurl`.
-
-## Authentication
-
-The CLI uses a PeakURL API key and validates it with `GET /api/v1/users/me` before storing it.
-PeakURL API keys are opaque 48-character hex bearer tokens, for example `0123456789abcdef0123456789abcdef0123456789abcdef`.
-The CLI accepts either the site root URL such as `https://peakurl.org` or the dashboard-exposed API base URL such as `https://peakurl.org/api/v1`.
+## Quick Start
 
 ```bash
 peakurl login --base-url https://peakurl.org --api-key 0123456789abcdef0123456789abcdef0123456789abcdef
+peakurl create https://example.com/articles/launch --alias launch --title "Launch Post"
+peakurl list
+peakurl whoami
 ```
 
-You can also provide credentials through environment variables, which is useful in CI:
+## Authentication
+
+The CLI uses PeakURL bearer API keys and validates them with `GET /api/v1/users/me` before storing them.
+
+- `--base-url` accepts either the site root such as `https://peakurl.org` or the API base URL such as `https://peakurl.org/api/v1`
+- API keys are opaque 48-character hex tokens
+- credentials are stored in the standard per-user config location for `peakurl`
+
+For CI and automation, you can also use environment variables:
 
 ```bash
 export PEAKURL_BASE_URL=https://peakurl.org
 export PEAKURL_API_KEY=0123456789abcdef0123456789abcdef0123456789abcdef
 ```
 
-Stored credentials live in the OS-standard per-user config directory for `peakurl`.
-
 ## Commands
 
-### `peakurl login`
+| Command                        | Description                                 |
+| ------------------------------ | ------------------------------------------- |
+| `peakurl login`                | Validate and save your PeakURL credentials. |
+| `peakurl whoami`               | Show the current authenticated account.     |
+| `peakurl create <url>`         | Create a new short link.                    |
+| `peakurl list`                 | List links in your account.                 |
+| `peakurl get <id-or-alias>`    | Fetch a single link by ID or alias.         |
+| `peakurl delete <id-or-alias>` | Delete a link by ID or alias.               |
 
-```bash
-peakurl login --base-url https://peakurl.org --api-key 0123456789abcdef0123456789abcdef0123456789abcdef
-```
+## Common Flags
 
-### `peakurl whoami`
+- `--json` prints machine-readable JSON output
+- `--quiet` minimizes output for scripts
 
-```bash
-peakurl whoami
-peakurl whoami --json
-```
+## Examples
 
-### `peakurl create <url>`
+Create a short link:
 
 ```bash
-peakurl create https://example.com/articles/launch --alias launch --title "Launch Post"
-peakurl create https://example.com --json
+peakurl create https://example.com --alias example --title "Example"
 ```
 
-### `peakurl list`
+List links as JSON:
 
 ```bash
-peakurl list
-peakurl list --search launch --limit 10 --json
+peakurl list --limit 10 --json
 ```
 
-### `peakurl get <id-or-alias>`
+Inspect a link:
 
 ```bash
-peakurl get launch
-peakurl get 681f3b63e7e44c0a1e83aa11 --json
+peakurl get example
 ```
 
-### `peakurl delete <id-or-alias>`
+Delete a link:
 
 ```bash
-peakurl delete launch
-peakurl delete 681f3b63e7e44c0a1e83aa11 --quiet
+peakurl delete example
 ```
 
-When you pass an alias or short code to `delete`, the CLI resolves it to the
-stable PeakURL row ID first because the current backend delete route operates on
-IDs.
-
-## Flags
-
-Common flags:
+When `delete` receives an alias or short code, the CLI resolves it to the underlying PeakURL row ID before deleting it.
 
-- `--json` prints machine-readable output.
-- `--quiet` prints minimal output for scripts.
+## Links
 
-Create flags:
-
-- `--alias`
-- `--title`
-- `--password`
-- `--status`
-- `--expires-at`
-- `--utm-source`
-- `--utm-medium`
-- `--utm-campaign`
-- `--utm-term`
-- `--utm-content`
-
-List flags:
-
-- `--page`
-- `--limit`
-- `--search`
-- `--sort-by`
-- `--sort-order`
-
-## Development
-
-```bash
-npm install
-npm run typecheck
-npm test
-```
+- Website: https://peakurl.org/
+- API docs: https://peakurl.org/docs/api
+- npm package: https://www.npmjs.com/package/peakurl
+- Issues: https://github.com/PeakURL/PeakURL-CLI/issues

package/package.json

@@ -1,26 +1,34 @@
 {
     "name": "peakurl",
-    "version": "0.0.2",
+    "version": "0.1.0",
     "description": "PeakURL command-line interface",
+    "homepage": "https://peakurl.org/",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/PeakURL/PeakURL-CLI.git"
+    },
     "type": "module",
     "bin": {
-        "peakurl": "dist/index.js"
+        "peakurl": "bin/peakurl.js"
     },
     "files": [
-        "dist"
+        "bin"
     ],
     "engines": {
         "node": ">=20"
     },
     "scripts": {
-        "build": "tsup src/index.ts --format esm --target node20 --clean",
+        "build": "tsup --config tsup.config.ts",
         "dev": "tsx src/index.ts",
         "format": "prettier --write .",
         "format:check": "prettier --check .",
-        "test": "tsx --test test/**/*.test.ts",
+        "test": "tsx --test test/*.test.ts",
         "typecheck": "tsc --noEmit",
         "prepare": "npm run build"
     },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/"
+    },
     "dependencies": {
         "commander": "^14.0.0",
         "env-paths": "^3.0.0"