sheetlink 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,84 @@
+# sheetlink
+
+CLI for SheetLink — sync your bank transactions to any destination.
+
+```
+npm install -g sheetlink
+```
+
+Requires a [SheetLink](https://sheetlink.app) account on the **PRO** or **MAX** tier.
+
+---
+
+## Commands
+
+### `sheetlink auth`
+Authenticate with SheetLink.
+
+```bash
+sheetlink auth                        # OAuth login (PRO)
+sheetlink auth --api-key sl_...       # API key (MAX — for automation)
+```
+
+### `sheetlink sync`
+Sync transactions from all connected banks.
+
+```bash
+sheetlink sync                                        # JSON to stdout (default)
+sheetlink sync | jq '.items[].transactions | length'  # Pipe to jq
+sheetlink sync --output csv                           # CSV snapshot
+sheetlink sync --output csv --file ~/finances.csv     # CSV to custom path
+sheetlink sync --output postgres://localhost/mydb     # Upsert to Postgres (MAX)
+sheetlink sync --output sqlite:///~/finance.db        # Upsert to SQLite (MAX)
+sheetlink sync --item <item_id>                       # One bank only
+```
+
+### `sheetlink items`
+List connected bank accounts.
+
+```bash
+sheetlink items
+```
+
+### `sheetlink config`
+View or update CLI configuration.
+
+```bash
+sheetlink config                          # Show current config
+sheetlink config --set default_output=csv # Set default output
+```
+
+**Settable keys:**
+- `default_output` — `json`, `csv`, `postgres://...`, `sqlite://...`
+- `api_url` — Backend URL (default: `https://api.sheetlink.app`)
+
+**Environment variable overrides:**
+- `SHEETLINK_API_KEY` — API key (MAX tier)
+- `SHEETLINK_OUTPUT` — Default output destination
+- `SHEETLINK_API_URL` — Backend URL
+
+---
+
+## Tiers
+
+| Feature | PRO | MAX |
+|---|---|---|
+| JSON / CSV output | ✅ | ✅ |
+| Postgres output | — | ✅ |
+| SQLite output | — | ✅ |
+| API key auth (unattended/cron) | — | ✅ |
+
+[View pricing →](https://sheetlink.app/pricing)
+
+---
+
+## Requirements
+
+- Node.js 18+
+- A SheetLink account with at least one connected bank ([sheetlink.app/dashboard](https://sheetlink.app/dashboard))
+
+---
+
+## License
+
+MIT © [SheetLink](https://sheetlink.app)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheetlink",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI for SheetLink — sync your bank transactions to any destination",
   "type": "module",
   "bin": {
@@ -36,6 +36,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/sheetlink/sheetlink-client"
+    "url": "https://github.com/sheetlink/cli"
   }
 }

package/src/commands/auth.js

@@ -16,7 +16,7 @@
 import http from 'http';
 import { randomBytes } from 'crypto';
 import { writeConfig, getApiUrl } from '../config.js';
-import { getTierStatus } from '../api.js';
+import { getTierStatus, listItems } from '../api.js';
 
 const GOOGLE_CLIENT_ID = '967710910027-qq2tuel7vsi2i06h4h096hbvok8kfmhk.apps.googleusercontent.com';
 const REDIRECT_PORT = 9876;
@@ -41,14 +41,10 @@ export async function cmdAuth(options) {
     console.log('API key saved to ~/.sheetlink/config.json');
     console.log('');
 
-    // Verify it works
+    // Verify it works by hitting an API-key-aware endpoint
     try {
-      const status = await getTierStatus();
-      if (status.subscription_tier !== 'max') {
-        console.error(`Warning: This key belongs to a ${status.subscription_tier} account. MAX tier is required for API key auth.`);
-        process.exit(1);
-      }
-      console.log(`Authenticated as ${status.email} (${status.subscription_tier} tier)`);
+      const { items } = await listItems();
+      console.log(`Authenticated. ${items.length} bank${items.length !== 1 ? 's' : ''} connected.`);
     } catch (e) {
       console.error(`Could not verify key: ${e.message}`);
       process.exit(1);