sheetlink 0.1.12 → 0.1.14

package/README.md

@@ -16,23 +16,27 @@ Requires a [SheetLink](https://sheetlink.app) account on the **PRO** or **MAX**
 Authenticate with SheetLink.
 
 ```bash
-sheetlink auth                        # OAuth login (PRO)
+sheetlink auth                        # OAuth login (PRO) — opens browser, JWT valid for ~1 hour
 sheetlink auth --api-key sl_...       # API key (MAX — for automation)
 ```
 
+> **Security note:** Avoid passing `--api-key` directly in commands — it may appear in your shell history. Use the `SHEETLINK_API_KEY` environment variable instead.
+
 ### `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                           # CSV snapshot (overwrites each run)
 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
 ```
 
+> **Note:** CSV output overwrites the file on every run. For an append/dedup history, use Postgres or SQLite.
+
 ### `sheetlink items`
 List connected bank accounts.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheetlink",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "CLI for SheetLink — sync your bank transactions to any destination",
   "type": "module",
   "bin": {

package/src/adapters/csv.js

@@ -41,5 +41,5 @@ function formatRow(txn) {
 export function writeCsv(transactions, filePath = './sheetlink-transactions.csv') {
   const lines = [HEADERS.join(','), ...transactions.map(formatRow)];
   fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
-  console.error(`Wrote ${transactions.length} transactions to ${filePath}`);
+  console.log(`Wrote ${transactions.length} transactions to ${filePath}`);
 }

package/src/adapters/postgres.js

@@ -91,7 +91,7 @@ export async function writePostgres(transactions, accounts, connectionString) {
       ]);
     }
 
-    console.error(`Synced ${transactions.length} transactions and ${accounts.length} accounts to Postgres`);
+    console.log(`Synced ${transactions.length} transactions and ${accounts.length} accounts to Postgres`);
   } finally {
     await client.end();
   }

package/src/adapters/sqlite.js

@@ -91,5 +91,5 @@ export async function writeSQLite(transactions, accounts, dbPath) {
   accBatch(accounts);
   db.close();
 
-  console.error(`Synced ${transactions.length} transactions and ${accounts.length} accounts to ${dbPath}`);
+  console.log(`Synced ${transactions.length} transactions and ${accounts.length} accounts to ${dbPath}`);
 }

package/src/commands/auth.js

@@ -38,13 +38,12 @@ export async function cmdAuth(options) {
     console.error('  export SHEETLINK_API_KEY=sl_...');
     console.error('');
 
-    writeConfig({ api_key: options.apiKey, jwt: null });
-    console.log('API key saved to ~/.sheetlink/config.json');
-    console.log('');
-
-    // Verify it works by hitting an API-key-aware endpoint
+    // Verify before saving
     try {
       const { items } = await listItems();
+      writeConfig({ api_key: options.apiKey, jwt: null });
+      console.log('API key saved to ~/.sheetlink/config.json');
+      console.log('');
       console.log(`Authenticated. ${items.length} bank${items.length !== 1 ? 's' : ''} connected.`);
     } catch (e) {
       console.error(`Could not verify key: ${e.message}`);
@@ -119,7 +118,13 @@ async function googleOAuthFlow() {
       }
     });
 
-    server.on('error', reject);
+    server.on('error', (err) => {
+      if (err.code === 'EADDRINUSE') {
+        reject(new Error(`Port ${REDIRECT_PORT} is already in use. Close any other process using it and try again.`));
+      } else {
+        reject(err);
+      }
+    });
     const timeout = setTimeout(() => { server.closeAllConnections?.(); server.close(); reject(new Error('OAuth timeout (2 minutes)')); }, 120_000);
     server.on('close', () => clearTimeout(timeout));
   });

package/src/commands/sync.js

@@ -39,16 +39,23 @@ export async function cmdSync(options) {
   const allAccounts = [];
   const results = [];
 
+  const spinnerFrames = ['⠋','⠙','⠹','⠸','⠼','⠴','⠦','⠧','⠇','⠏'];
+
   for (const id of itemIds) {
-    process.stderr.write(`Syncing ${id}...`);
+    let i = 0;
+    const spinner = setInterval(() => {
+      process.stderr.write(`\r${spinnerFrames[i++ % spinnerFrames.length]} Syncing ${id}...`);
+    }, 80);
     try {
       const result = await syncItem(id);
       allTransactions.push(...(result.transactions || []));
       allAccounts.push(...(result.accounts || []));
       results.push({ item_id: id, ...result });
-      process.stderr.write(` ${result.transactions?.length ?? 0} transactions\n`);
+      clearInterval(spinner);
+      process.stderr.write(`\r✓ Synced ${id} — ${result.transactions?.length ?? 0} transactions\n`);
     } catch (e) {
-      process.stderr.write(` error: ${e.message}\n`);
+      clearInterval(spinner);
+      process.stderr.write(`\r✗ ${id} — ${e.message}\n`);
     }
   }