@nestica/cli 0.4.0 → 0.5.0

package/README.md

@@ -1,54 +1,44 @@
-# nestica-cli
+# nestica
 
-Command-line client for the Nestica REST API (`nestica-api`): full CRUD
-over `profiles`, `accounts`, `contacts`, `transactions` and `yields`,
-plus session management (`login`, `logout`, `whoami`, `set-profile`).
+Command-line client for the Nestica REST API: full CRUD over `profiles`,
+`accounts`, `contacts`, `transactions` and `yields`, plus session
+management (`login`, `logout`, `whoami`, `set-profile`).
 
 ## Install
 
-Published package: `npm install -g @nestica/cli` (zero runtime
-dependencies — everything is bundled into the `nestica` binary).
-
-From this repository:
-
 ```sh
-pnpm install
-pnpm --filter @nestica/cli build
-pnpm exec nestica --help
+npm install -g @nestica/cli
 ```
 
-The CLI talks to the deployed API by default
-(`https://api-tjnuhxmzkq-uc.a.run.app/api/v1.0`); point it elsewhere
-with `--base-url` or `NESTICA_BASE_URL`.
+Zero runtime dependencies — everything is bundled into the `nestica`
+binary. Requires Node.js >= 22.12. The CLI talks to the deployed API
+by default.
 
 ## Sessions
 
-State lives in one JSON file with owner-only permissions:
-`${XDG_CONFIG_HOME:-~/.config}/nestica/config.json` (override the whole
-path with `NESTICA_CONFIG`). It stores the connection settings, the
-Firebase tokens and the default profile. Precedence for every setting:
-**flag > environment > session file > default**.
+```sh
+nestica login --email dev@example.com   # prompts for the password
+nestica login --google --google-client-id <id>   # in the browser
 
-| Setting | Flag | Environment | Default |
-| --- | --- | --- | --- |
-| API base URL | `-H, --base-url` | `NESTICA_BASE_URL` | deployed API |
-| Firebase web API key | `--api-key` | `FIREBASE_API_KEY` | the Nestica project's web key |
-| Google OAuth client id | `--google-client-id` | `GOOGLE_CLIENT_ID` | — |
-| Google OAuth client secret | `--google-client-secret` | `GOOGLE_CLIENT_SECRET` | — |
-| Auth emulator | — | `FIREBASE_AUTH_EMULATOR_HOST` | inferred from a localhost base URL |
+nestica whoami
+nestica set-profile
+nestica logout
+```
 
-Expired ID tokens refresh automatically before requests; when the
-refresh token itself is rejected the CLI says so and asks for a new
-`login`.
+The session (connection settings, Firebase tokens, default profile)
+lives in one JSON file with owner-only permissions:
+`${XDG_CONFIG_HOME:-~/.config}/nestica/config.json`.
+
+`set-profile` lists the profiles and asks which one to make the
+default; `nestica set-profile <uuid>` stores a specific one and
+`--clear` removes it. The API would otherwise default to the first
+profile created. `logout` deletes the session file; running `login`
+while already signed in just reports the current session — `logout`
+first to switch accounts.
 
 ## Commands
 
 ```
-nestica login [--email <email>] [--password <pw>] [--google] ...
-nestica logout
-nestica whoami
-nestica set-profile [<id>] [--clear]
-
 nestica <resource> list [--page <n>] [--page-size <n>] [--profile <uuid>]
 nestica <resource> get <id>
 nestica <resource> create [field flags] [--data <json|->]
@@ -61,35 +51,14 @@ yields`. Scoped resources send the stored default profile (or an
 explicit `--profile`) as the `profileId` query parameter; `transactions
 list` also takes `--type expense|income`.
 
-Global flags: `-H/--base-url`, `--api-key`, `--profile`,
-`-F/--format pretty|json|table` (default `pretty`), `--no-color`
-(or `NO_COLOR`; color is also off when stdout is not a TTY).
-
-### login
-
-- Email/password (prompted when omitted; the password is not echoed):
-  `nestica login --email dev@example.com` (the Firebase web API key
-  defaults to the Nestica project's own key)
-- Google, in the browser (OAuth + PKCE against a loopback redirect;
-  needs the Firebase project's web OAuth client id):
-  `nestica login --google --google-client-id <id> --api-key <key>`
-
-`logout` deletes the session file. Running `login` while already
-signed in just reports the current session — `logout` first to switch
-accounts (ID tokens refresh automatically, so re-login is never needed
-to renew them).
-
-### set-profile
-
-`nestica set-profile` lists the profiles and asks which one to make the
-default; `nestica set-profile <uuid>` stores a specific one and
-`--clear` removes it. The API would otherwise default to the first
-profile created.
+Global flags: `--profile`, `-F/--format pretty|json|table` (default
+`pretty`), `--no-color` (or `NO_COLOR`; color is also off when stdout
+is not a TTY).
 
 ### Field flags
 
 Create/update bodies come from typed flags — identical rules to the
-API, validated locally with `@nestica/models` — plus `--data` (or
+API, validated locally before the request is sent — plus `--data` (or
 `--json`) to merge a raw JSON body over them (`-` reads stdin):
 
 ```sh
@@ -124,37 +93,3 @@ print nothing at all.
 ### Exit codes
 
 `0` success · `1` API/runtime errors · `2` usage errors.
-
-## Smoke test against the emulators
-
-```sh
-pnpm --filter nestica-api serve      # functions :5001, firestore :8080, auth :9099
-# create a user once in the Auth UI at http://localhost:4000
-
-export FIREBASE_AUTH_EMULATOR_HOST=localhost:9099
-pnpm exec nestica login \
-  --base-url http://localhost:5001/nestica-finances/us-central1/api/api/v1.0 \
-  --api-key demo --email dev@example.com
-
-pnpm exec nestica profiles create --name Gary --country CO \
-  --timezone America/Bogota --currency COP --default-currency COP
-pnpm exec nestica set-profile
-pnpm exec nestica accounts create --name Bancolombia --label bank
-pnpm exec nestica transactions create --type expense --amount 42.5 \
-  --currency COP --date 2026-08-22T12:00:00Z --status settled --label groceries
-pnpm exec nestica transactions list --type expense --format table
-pnpm exec nestica whoami
-pnpm exec nestica logout
-```
-
-Note: the Google flow always talks to the real Google endpoints — use
-email/password with the emulators.
-
-## Tests
-
-```sh
-pnpm --filter @nestica/cli test
-```
-
-Unit tests only (mocked `fetch`, temporary session files); the
-repository-wide `pnpm test` runs them through Nx.

package/dist/cli.js

@@ -3380,7 +3380,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@nestica/cli",
-  version: "0.4.0",
+  version: "0.5.0",
   type: "module",
   description: "Command-line client for the Nestica REST API",
   license: "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestica/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Command-line client for the Nestica REST API",
   "license": "MIT",