@lifestreamdynamics/vault-cli 1.0.0 → 1.0.1

package/README.md

@@ -3,7 +3,7 @@
 A powerful command-line interface for Lifestream Vault - the multi-user Markdown document storage service with WebDAV sync, search, and collaboration features.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://img.shields.io/npm/v/@lifestream-vault/cli.svg)](https://www.npmjs.com/package/@lifestream-vault/cli)
+[![npm version](https://img.shields.io/npm/v/@lifestreamdynamics/vault-cli.svg)](https://www.npmjs.com/package/@lifestreamdynamics/vault-cli)
 
 ## 📖 Table of Contents
 
@@ -49,14 +49,14 @@ A powerful command-line interface for Lifestream Vault - the multi-user Markdown
 - **🛡️ Admin Tools** - User management, system stats, and audit logs (admin only)
 - **⚙️ Flexible Configuration** - Multiple profiles, environment variable support, and configurable sync behavior
 - **🌐 Offline Support** - Work offline and sync when reconnected
-- **📦 TypeScript SDK** - Built on `@lifestream-vault/sdk` with full type safety
+- **📦 TypeScript SDK** - Built on `@lifestreamdynamics/vault-sdk` with full type safety
 
 ## 📦 Installation
 
 ### Global Installation (Recommended)
 
 ```bash
-npm install -g @lifestream-vault/cli
+npm install -g @lifestreamdynamics/vault-cli
 ```
 
 After installation, the `lsvault` command will be available globally:
@@ -68,7 +68,7 @@ lsvault --help
 ### Local Installation (Project-Specific)
 
 ```bash
-npm install @lifestream-vault/cli
+npm install @lifestreamdynamics/vault-cli
 
 # Run with npx
 npx lsvault --help
@@ -98,7 +98,7 @@ lsvault auth login --api-key lsv_k_your_api_key_here
 lsvault auth login --email user@example.com
 
 # Set a custom API URL (optional)
-lsvault auth login --api-key lsv_k_your_key --api-url https://vault.example.com
+lsvault auth login --api-key lsv_k_your_key --api-url https://vault.lifestreamdynamics.com
 ```
 
 ### 2. List Your Vaults
@@ -474,12 +474,14 @@ The CLI stores configuration in `~/.lsvault/config.json`:
 
 ```json
 {
-  "apiUrl": "http://localhost:4660"
+  "apiUrl": "https://vault.lifestreamdynamics.com"
 }
 ```
 
 **Note:** Credentials are stored securely in the system keychain (or encrypted file fallback), not in the plaintext config file.
 
+> **Self-hosting?** Replace `https://vault.lifestreamdynamics.com` with your server's URL, or set the `LSVAULT_API_URL` environment variable.
+
 ### Configuration Profiles
 
 Manage multiple configurations with profiles:
@@ -489,13 +491,13 @@ Manage multiple configurations with profiles:
 lsvault config profiles
 
 # Create a profile
-lsvault config create-profile production --api-url https://vault.example.com
+lsvault config create-profile production --api-url https://vault.lifestreamdynamics.com
 
 # Switch profiles
 lsvault config use production
 
 # Set config values
-lsvault config set apiUrl https://vault.example.com
+lsvault config set apiUrl https://vault.lifestreamdynamics.com
 
 # Get config values
 lsvault config get apiUrl
@@ -522,14 +524,14 @@ Sync configurations are stored per vault in `~/.lsvault/sync/`:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `LSVAULT_API_URL` | API server base URL | `http://localhost:4660` |
+| `LSVAULT_API_URL` | API server base URL | `https://vault.lifestreamdynamics.com` |
 | `LSVAULT_API_KEY` | API key for authentication | - |
 | `LSVAULT_CONFIG_DIR` | Configuration directory | `~/.lsvault` |
 | `LSVAULT_PROFILE` | Active configuration profile | `default` |
 
 **Example:**
 ```bash
-export LSVAULT_API_URL=https://vault.example.com
+export LSVAULT_API_URL=https://vault.lifestreamdynamics.com
 export LSVAULT_API_KEY=lsv_k_your_key_here
 lsvault vaults list
 ```
@@ -718,7 +720,7 @@ lsvault auth migrate
 1. Verify API URL is correct: `lsvault config get apiUrl`
 2. Test connectivity: `curl <API_URL>/api/v1/health`
 3. Check firewall/proxy settings
-4. Use custom API URL: `lsvault auth login --api-url https://vault.example.com`
+4. Use custom API URL: `lsvault auth login --api-url https://vault.lifestreamdynamics.com`
 
 ### Output Format Issues
 
@@ -733,9 +735,9 @@ lsvault docs get vault_abc123 /path.md --quiet > output.md
 
 ## 🔗 Related Packages
 
-- **[@lifestream-vault/sdk](https://npmjs.com/package/@lifestream-vault/sdk)** - TypeScript SDK for Lifestream Vault API
-- **[@lifestream-vault/api](https://github.com/lifestreamdynamics/lifestream-vault)** - Backend API server
-- **[@lifestream-vault/web](https://github.com/lifestreamdynamics/lifestream-vault)** - Web frontend
+- **[@lifestreamdynamics/vault-sdk](https://npmjs.com/package/@lifestreamdynamics/vault-sdk)** - TypeScript SDK for Lifestream Vault API
+- **[@lifestreamdynamics/vault-api](https://github.com/lifestreamdynamics/lifestream-vault)** - Backend API server
+- **[@lifestreamdynamics/vault-web](https://github.com/lifestreamdynamics/lifestream-vault)** - Web frontend
 
 ## 📄 Documentation
 

package/dist/commands/admin.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatBytes, formatUptime } from '../utils/format.js';
@@ -12,7 +12,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching system stats...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const data = await client.admin.getStats();
             out.stopSpinner();
             out.record({
@@ -41,7 +41,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching timeseries data...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const data = await client.admin.getTimeseries(String(_opts.metric), String(_opts.period));
             out.stopSpinner();
             if (flags.output === 'text') {
@@ -79,7 +79,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching users...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.admin.listUsers({
                 page: _opts.page,
                 limit: _opts.limit,
@@ -125,7 +125,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching user...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const user = await client.admin.getUser(userId);
             out.stopSpinner();
             out.record({
@@ -169,7 +169,7 @@ export function registerAdminCommands(program) {
         }
         out.startSpinner('Updating user...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const updated = await client.admin.updateUser(userId, params);
             out.success(`User updated: ${chalk.cyan(updated.email)} -- ${chalk.magenta(updated.role)} -- ${updated.isActive ? chalk.green('active') : chalk.red('inactive')}`, {
                 email: updated.email,
@@ -190,7 +190,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching activity...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const activity = await client.admin.getActivity(_opts.limit);
             out.stopSpinner();
             out.list(activity.map(a => ({
@@ -224,7 +224,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching subscription summary...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const summary = await client.admin.getSubscriptionSummary();
             out.stopSpinner();
             out.record({
@@ -246,7 +246,7 @@ export function registerAdminCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Checking system health...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const health = await client.admin.getHealth();
             out.stopSpinner();
             out.record({

package/dist/commands/auth.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { LifestreamVaultClient } from '@lifestreamdynamics/vault-sdk';
 import { loadConfigAsync, getCredentialManager } from '../config.js';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { migrateCredentials, hasPlaintextCredentials, checkAndPromptMigration } from '../lib/migration.js';
 export function registerAuthCommands(program) {
     const auth = program.command('auth').description('Authentication and credential management');
@@ -11,7 +11,7 @@ export function registerAuthCommands(program) {
         .option('--api-key <key>', 'API key (lsv_k_... prefix)')
         .option('--email <email>', 'Email address for password login')
         .option('--password <password>', 'Password (prompts interactively if omitted)')
-        .option('--api-url <url>', 'API server URL (default: http://localhost:4660)')
+        .option('--api-url <url>', 'API server URL (default: https://vault.lifestreamdynamics.com)')
         .addHelpText('after', `
 EXAMPLES
   lsvault auth login --api-key lsv_k_abc123
@@ -179,7 +179,7 @@ EXAMPLES
         if (config.apiKey || config.accessToken) {
             const spinner = ora('Fetching user info...').start();
             try {
-                const client = getClient();
+                const client = await getClientAsync();
                 const user = await client.user.me();
                 spinner.stop();
                 console.log(`User:    ${chalk.cyan(user.email)}`);

package/dist/commands/connectors.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerConnectorCommands(program) {
@@ -12,7 +12,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching connectors...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const connectorList = await client.connectors.list(_opts.vault);
             out.stopSpinner();
             out.list(connectorList.map(c => ({
@@ -48,7 +48,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const c = await client.connectors.get(connectorId);
             out.stopSpinner();
             out.record({
@@ -81,7 +81,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Creating connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const connector = await client.connectors.create({
                 provider: provider,
                 name,
@@ -109,7 +109,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Updating connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.name)
                 params.name = _opts.name;
@@ -133,7 +133,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Deleting connector...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.connectors.delete(connectorId);
             out.success('Connector deleted.', { id: connectorId, deleted: true });
         }
@@ -149,7 +149,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Testing connection...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.connectors.test(connectorId);
             if (result.success) {
                 out.success('Connection test passed.', { success: true });
@@ -174,7 +174,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Triggering sync...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.connectors.sync(connectorId);
             out.success(result.message, { message: result.message });
         }
@@ -190,7 +190,7 @@ export function registerConnectorCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching sync logs...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const logs = await client.connectors.logs(connectorId);
             out.stopSpinner();
             out.list(logs.map(log => ({

package/dist/commands/docs.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { createCredentialManager } from '../lib/credential-manager.js';
@@ -18,7 +18,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching documents...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const documents = await client.documents.list(vaultId, _opts.dir);
             out.stopSpinner();
             out.list(documents.map(doc => ({
@@ -62,7 +62,7 @@ EXAMPLES
         const flags = resolveFlags(_opts);
         const out = createOutput(flags);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.documents.get(vaultId, docPath);
             // Auto-decrypt if the document is encrypted
             if (result.document.encrypted && !_opts.meta) {
@@ -119,7 +119,7 @@ EXAMPLES
                 process.stdin.on('end', () => resolve(data));
             });
             out.startSpinner('Uploading document...');
-            const client = getClient();
+            const client = await getClientAsync();
             // Check if vault is encrypted and auto-encrypt
             const vault = await client.vaults.get(vaultId);
             let doc;
@@ -157,7 +157,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Deleting document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.delete(vaultId, docPath);
             out.success(`Deleted: ${chalk.cyan(docPath)}`, { path: docPath, deleted: true });
         }
@@ -180,7 +180,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Moving document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const result = await client.documents.move(vaultId, source, dest, _opts.overwrite);
             out.success(`Moved: ${chalk.cyan(result.source)} -> ${chalk.cyan(result.destination)}`, {
                 source: result.source,

package/dist/commands/hooks.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerHookCommands(program) {
@@ -12,7 +12,7 @@ export function registerHookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching hooks...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const hookList = await client.hooks.list(vaultId);
             out.stopSpinner();
             out.list(hookList.map(hook => ({
@@ -76,7 +76,7 @@ export function registerHookCommands(program) {
         }
         out.startSpinner('Creating hook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 name,
                 triggerEvent: String(_opts.trigger),
@@ -106,7 +106,7 @@ export function registerHookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Deleting hook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.hooks.delete(vaultId, hookId);
             out.success('Hook deleted successfully', { id: hookId, deleted: true });
         }
@@ -123,7 +123,7 @@ export function registerHookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching executions...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const executions = await client.hooks.listExecutions(vaultId, hookId);
             out.stopSpinner();
             out.list(executions.map(exec => ({

package/dist/commands/keys.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerKeyCommands(program) {
@@ -11,7 +11,7 @@ export function registerKeyCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching API keys...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const apiKeys = await client.apiKeys.list();
             out.stopSpinner();
             out.list(apiKeys.map(key => ({
@@ -54,7 +54,7 @@ export function registerKeyCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching API key...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const key = await client.apiKeys.get(keyId);
             out.stopSpinner();
             out.record({
@@ -89,7 +89,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating API key...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 name,
                 scopes: String(_opts.scopes || 'read,write').split(',').map((s) => s.trim()),
@@ -131,7 +131,7 @@ EXAMPLES
         }
         out.startSpinner('Updating API key...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.name)
                 params.name = String(_opts.name);
@@ -154,7 +154,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Revoking API key...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.apiKeys.delete(keyId);
             out.success('API key revoked successfully', { id: keyId, revoked: true });
         }

package/dist/commands/publish.js

@@ -1,4 +1,4 @@
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import chalk from 'chalk';
@@ -12,7 +12,7 @@ export function registerPublishCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching published documents...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const docs = await client.publish.listMine(vaultId);
             out.stopSpinner();
             out.list(docs.map(doc => ({
@@ -60,7 +60,7 @@ export function registerPublishCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Publishing document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 slug: String(_opts.slug),
             };
@@ -96,7 +96,7 @@ export function registerPublishCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Updating published document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 slug: String(_opts.slug),
             };
@@ -127,7 +127,7 @@ export function registerPublishCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Unpublishing document...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.publish.delete(vaultId, docPath);
             out.success('Document unpublished successfully', { path: docPath, unpublished: true });
         }

package/dist/commands/search.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerSearchCommands(program) {
@@ -19,7 +19,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Searching...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const response = await client.search.search({
                 q: query,
                 vault: _opts.vault,

package/dist/commands/shares.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerShareCommands(program) {
@@ -13,7 +13,7 @@ export function registerShareCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching share links...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const links = await client.shares.list(vaultId, docPath);
             out.stopSpinner();
             out.list(links.map(link => ({
@@ -63,7 +63,7 @@ export function registerShareCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Creating share link...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.permission)
                 params.permission = String(_opts.permission);
@@ -110,7 +110,7 @@ export function registerShareCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Revoking share link...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.shares.revoke(vaultId, shareId);
             out.success('Share link revoked successfully', { id: shareId, revoked: true });
         }

package/dist/commands/subscription.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatBytes } from '../utils/format.js';
@@ -12,7 +12,7 @@ export function registerSubscriptionCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching subscription...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const data = await client.subscription.get();
             out.stopSpinner();
             if (flags.output === 'json') {
@@ -49,7 +49,7 @@ export function registerSubscriptionCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching plans...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const plans = await client.subscription.listPlans();
             out.stopSpinner();
             out.list(plans.map(p => ({ name: p.name, tier: p.tier, ...p.limits })), {
@@ -85,7 +85,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating checkout session...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const session = await client.subscription.createCheckoutSession(tier, String(_opts.returnUrl));
             out.success('Checkout session created', { url: session.url });
             if (flags.output === 'text') {
@@ -104,7 +104,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Cancelling subscription...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.subscription.cancel(_opts.reason);
             out.success('Subscription cancelled', { cancelled: true });
         }
@@ -120,7 +120,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating portal session...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const portal = await client.subscription.createPortalSession(String(_opts.returnUrl));
             out.success('Portal session created', { url: portal.url });
             if (flags.output === 'text') {
@@ -138,7 +138,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching invoices...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const invoices = await client.subscription.listInvoices();
             out.stopSpinner();
             out.list(invoices.map(inv => ({

package/dist/commands/sync.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatUptime } from '../utils/format.js';
@@ -30,7 +30,7 @@ export function registerSyncCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Initializing sync...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.vaults.get(vaultId);
             const absPath = path.resolve(localPath);
             const mode = _opts.mode ?? 'sync';
@@ -144,7 +144,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning local files...');
@@ -220,7 +220,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning local files...');
@@ -296,7 +296,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const lastState = loadSyncState(config.id);
             out.startSpinner('Scanning...');
@@ -373,7 +373,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const ignorePatterns = resolveIgnorePatterns(config.ignore, config.localPath);
             const pollInterval = parseInt(String(_opts.pollInterval ?? '30000'), 10);
             out.status(`Watching sync ${chalk.cyan(syncId.slice(0, 8))}...`);
@@ -447,7 +447,7 @@ export function registerSyncCommands(program) {
                 process.exitCode = 1;
                 return;
             }
-            const client = getClient();
+            const client = await getClientAsync();
             const localFile = path.join(config.localPath, docPath);
             const state = loadSyncState(config.id);
             if (useVersion === 'local') {

package/dist/commands/teams.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerTeamCommands(program) {
@@ -12,7 +12,7 @@ export function registerTeamCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching teams...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const teamList = await client.teams.list();
             out.stopSpinner();
             out.list(teamList.map(t => ({ name: t.name, id: t.id, description: t.description || 'No description' })), {
@@ -37,7 +37,7 @@ export function registerTeamCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.get(teamId);
             out.stopSpinner();
             out.record({
@@ -66,7 +66,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.create({ name, description: _opts.description });
             out.success(`Team created: ${chalk.cyan(team.name)} (${team.id})`, { id: team.id, name: team.name });
         }
@@ -84,7 +84,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Updating team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const team = await client.teams.update(teamId, {
                 name: _opts.name,
                 description: _opts.description,
@@ -103,7 +103,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Deleting team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.delete(teamId);
             out.success('Team deleted.', { id: teamId, deleted: true });
         }
@@ -121,7 +121,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching members...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const memberList = await client.teams.listMembers(teamId);
             out.stopSpinner();
             out.list(memberList.map(m => ({
@@ -154,7 +154,7 @@ EXAMPLES
         const role = String(_opts.role);
         out.startSpinner('Updating member role...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const member = await client.teams.updateMemberRole(teamId, userId, role);
             out.success(`Role updated to ${chalk.magenta(member.role)} for ${member.user.email}`, {
                 userId,
@@ -175,7 +175,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Removing member...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.removeMember(teamId, userId);
             out.success('Member removed.', { teamId, userId, removed: true });
         }
@@ -191,7 +191,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Leaving team...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.leave(teamId);
             out.success('Left the team.', { teamId, left: true });
         }
@@ -209,7 +209,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching invitations...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const invitationList = await client.teams.listInvitations(teamId);
             out.stopSpinner();
             out.list(invitationList.map(inv => ({
@@ -242,7 +242,7 @@ EXAMPLES
         const role = String(_opts.role);
         out.startSpinner('Sending invitation...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const invitation = await client.teams.inviteMember(teamId, email, role);
             out.success(`Invited ${chalk.cyan(invitation.email)} as ${chalk.magenta(invitation.role)}`, {
                 id: invitation.id,
@@ -263,7 +263,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Revoking invitation...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.teams.revokeInvitation(teamId, invitationId);
             out.success('Invitation revoked.', { id: invitationId, revoked: true });
         }
@@ -281,7 +281,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching team vaults...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vaultList = await client.teams.listVaults(teamId);
             out.stopSpinner();
             out.list(vaultList.map(v => ({ name: String(v.name), slug: String(v.slug), description: String(v.description) || 'No description' })), {
@@ -308,7 +308,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating team vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.teams.createVault(teamId, { name, description: _opts.description });
             out.success(`Team vault created: ${chalk.cyan(String(vault.name))}`, {
                 name: String(vault.name),

package/dist/commands/user.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { formatBytes } from '../utils/format.js';
@@ -12,7 +12,7 @@ export function registerUserCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching storage usage...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const storage = await client.user.getStorage();
             out.stopSpinner();
             if (flags.output === 'json') {

package/dist/commands/vaults.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 import { generateVaultKey } from '@lifestreamdynamics/vault-sdk';
@@ -13,7 +13,7 @@ export function registerVaultCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching vaults...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vaultList = await client.vaults.list();
             out.stopSpinner();
             out.list(vaultList.map(v => ({ name: v.name, slug: v.slug, encrypted: v.encryptionEnabled ? 'yes' : 'no', description: v.description || 'No description', id: v.id })), {
@@ -43,7 +43,7 @@ export function registerVaultCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const vault = await client.vaults.get(vaultId);
             out.stopSpinner();
             out.record({
@@ -75,7 +75,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Creating vault...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const isEncrypted = _opts.encrypted === true;
             const vault = await client.vaults.create({
                 name,

package/dist/commands/versions.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerVersionCommands(program) {
@@ -16,7 +16,7 @@ EXAMPLES
         const out = createOutput(flags);
         out.startSpinner('Fetching versions...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const versionList = await client.documents.listVersions(vaultId, docPath);
             out.stopSpinner();
             out.list(versionList.map(v => ({
@@ -65,7 +65,7 @@ EXAMPLES
             return;
         }
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const version = await client.documents.getVersion(vaultId, docPath, versionNum);
             if (version.content === null) {
                 out.error('Version content is no longer available (expired or pruned)');
@@ -99,7 +99,7 @@ EXAMPLES
         }
         out.startSpinner('Computing diff...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const diff = await client.documents.diffVersions(vaultId, docPath, from, to);
             out.stopSpinner();
             if (flags.output === 'json') {
@@ -143,7 +143,7 @@ EXAMPLES
         }
         out.startSpinner(`Restoring to version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const doc = await client.documents.restoreVersion(vaultId, docPath, versionNum);
             out.success(`Restored ${chalk.cyan(docPath)} to version ${versionNum}`, {
                 path: doc.path,
@@ -173,7 +173,7 @@ EXAMPLES
         }
         out.startSpinner(`Pinning version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.pinVersion(vaultId, docPath, versionNum);
             out.success(`Pinned version ${versionNum} of ${chalk.cyan(docPath)}`, {
                 path: docPath,
@@ -204,7 +204,7 @@ EXAMPLES
         }
         out.startSpinner(`Unpinning version ${versionNum}...`);
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.documents.unpinVersion(vaultId, docPath, versionNum);
             out.success(`Unpinned version ${versionNum} of ${chalk.cyan(docPath)}`, {
                 path: docPath,

package/dist/commands/webhooks.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { getClient } from '../client.js';
+import { getClientAsync } from '../client.js';
 import { addGlobalFlags, resolveFlags } from '../utils/flags.js';
 import { createOutput, handleError } from '../utils/output.js';
 export function registerWebhookCommands(program) {
@@ -12,7 +12,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching webhooks...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const webhookList = await client.webhooks.list(vaultId);
             out.stopSpinner();
             out.list(webhookList.map(wh => ({
@@ -50,7 +50,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Creating webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {
                 url,
                 events: String(_opts.events || 'create,update,delete').split(',').map((e) => e.trim()),
@@ -95,7 +95,7 @@ export function registerWebhookCommands(program) {
         }
         out.startSpinner('Updating webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const params = {};
             if (_opts.url)
                 params.url = String(_opts.url);
@@ -125,7 +125,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Deleting webhook...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             await client.webhooks.delete(vaultId, webhookId);
             out.success('Webhook deleted successfully', { id: webhookId, deleted: true });
         }
@@ -142,7 +142,7 @@ export function registerWebhookCommands(program) {
         const out = createOutput(flags);
         out.startSpinner('Fetching deliveries...');
         try {
-            const client = getClient();
+            const client = await getClientAsync();
             const deliveries = await client.webhooks.listDeliveries(vaultId, webhookId);
             out.stopSpinner();
             out.list(deliveries.map(d => ({

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 import { type CredentialManager } from './lib/credential-manager.js';
+export declare const DEFAULT_API_URL = "https://vault.lifestreamdynamics.com";
 export interface CliConfig {
     apiUrl: string;
     apiKey?: string;

package/dist/config.js

@@ -4,6 +4,7 @@ import os from 'node:os';
 import { createCredentialManager } from './lib/credential-manager.js';
 const CONFIG_DIR = path.join(os.homedir(), '.lsvault');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export const DEFAULT_API_URL = 'https://vault.lifestreamdynamics.com';
 // Singleton credential manager
 let _credentialManager;
 export function getCredentialManager() {
@@ -25,7 +26,7 @@ export function setCredentialManager(cm) {
  */
 export function loadConfig() {
     const config = {
-        apiUrl: process.env.LSVAULT_API_URL || 'http://localhost:4660',
+        apiUrl: process.env.LSVAULT_API_URL || DEFAULT_API_URL,
     };
     if (process.env.LSVAULT_API_KEY) {
         config.apiKey = process.env.LSVAULT_API_KEY;
@@ -48,7 +49,7 @@ export async function loadConfigAsync() {
     const cm = getCredentialManager();
     const secureCreds = await cm.getCredentials();
     const config = {
-        apiUrl: secureCreds.apiUrl || process.env.LSVAULT_API_URL || 'http://localhost:4660',
+        apiUrl: secureCreds.apiUrl || process.env.LSVAULT_API_URL || DEFAULT_API_URL,
     };
     // Load JWT tokens if available
     if (secureCreds.accessToken) {

package/dist/lib/keychain.js

@@ -1,6 +1,8 @@
 const SERVICE_NAME = 'lifestream-vault-cli';
 const ACCOUNT_API_KEY = 'api-key';
 const ACCOUNT_API_URL = 'api-url';
+const ACCOUNT_ACCESS_TOKEN = 'access-token';
+const ACCOUNT_REFRESH_TOKEN = 'refresh-token';
 /**
  * Dynamically loads keytar. Returns null if unavailable (not installed or
  * native module fails to load, e.g. missing libsecret on Linux).
@@ -48,6 +50,12 @@ export function createKeychainBackend() {
                 const apiUrl = await kt.getPassword(SERVICE_NAME, ACCOUNT_API_URL);
                 if (apiUrl)
                     result.apiUrl = apiUrl;
+                const accessToken = await kt.getPassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN);
+                if (accessToken)
+                    result.accessToken = accessToken;
+                const refreshToken = await kt.getPassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN);
+                if (refreshToken)
+                    result.refreshToken = refreshToken;
             }
             catch {
                 // Keychain access failed silently
@@ -64,6 +72,12 @@ export function createKeychainBackend() {
             if (config.apiUrl) {
                 await kt.setPassword(SERVICE_NAME, ACCOUNT_API_URL, config.apiUrl);
             }
+            if (config.accessToken) {
+                await kt.setPassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN, config.accessToken);
+            }
+            if (config.refreshToken) {
+                await kt.setPassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN, config.refreshToken);
+            }
         },
         async clearCredentials() {
             const kt = await getKeytar();
@@ -77,6 +91,14 @@ export function createKeychainBackend() {
                 await kt.deletePassword(SERVICE_NAME, ACCOUNT_API_URL);
             }
             catch { /* ignore */ }
+            try {
+                await kt.deletePassword(SERVICE_NAME, ACCOUNT_ACCESS_TOKEN);
+            }
+            catch { /* ignore */ }
+            try {
+                await kt.deletePassword(SERVICE_NAME, ACCOUNT_REFRESH_TOKEN);
+            }
+            catch { /* ignore */ }
         },
     };
 }

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@lifestreamdynamics/vault-cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Command-line interface for Lifestream Vault",
+  "engines": {
+    "node": ">=20"
+  },
   "type": "module",
   "bin": {
     "lsvault": "./dist/index.js"
@@ -53,10 +56,10 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^2.0.0",
-    "@vitest/ui": "^2.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
-    "vitest": "^2.0.0"
+    "vitest": "^4.0.18"
   }
 }