@objectstack/cli 4.0.1 → 4.0.3

package/dist/utils/output-formatter.js

@@ -0,0 +1,80 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import chalk from 'chalk';
+import yaml from 'yaml';
+/**
+ * Format and output data according to the specified format
+ */
+export function formatOutput(data, format = 'json') {
+    switch (format) {
+        case 'json':
+            console.log(JSON.stringify(data, null, 2));
+            break;
+        case 'yaml':
+            console.log(yaml.stringify(data));
+            break;
+        case 'table':
+            // For table format, handle different data structures
+            if (Array.isArray(data)) {
+                printTable(data);
+            }
+            else if (data && typeof data === 'object') {
+                // For single objects, print as key-value pairs
+                printKeyValue(data);
+            }
+            else {
+                console.log(String(data));
+            }
+            break;
+        default:
+            console.log(JSON.stringify(data, null, 2));
+    }
+}
+/**
+ * Print data as a table (for arrays of objects)
+ */
+function printTable(data) {
+    if (data.length === 0) {
+        console.log(chalk.dim('(no data)'));
+        return;
+    }
+    // Get all unique keys from all objects
+    const keys = Array.from(new Set(data.flatMap(item => Object.keys(item))));
+    // Print header
+    console.log(chalk.bold(keys.join(' | ')));
+    console.log(chalk.dim('─'.repeat(keys.join(' | ').length)));
+    // Print rows
+    for (const item of data) {
+        const values = keys.map(key => {
+            const value = item[key];
+            if (value === null || value === undefined)
+                return chalk.dim('-');
+            if (typeof value === 'object')
+                return chalk.dim('[object]');
+            return String(value);
+        });
+        console.log(values.join(' | '));
+    }
+    console.log(chalk.dim(`\n${data.length} row(s)`));
+}
+/**
+ * Print object as key-value pairs
+ */
+function printKeyValue(data, indent = 0) {
+    const prefix = '  '.repeat(indent);
+    for (const [key, value] of Object.entries(data)) {
+        if (value === null || value === undefined) {
+            console.log(`${prefix}${chalk.dim(key + ':')} ${chalk.dim('null')}`);
+        }
+        else if (typeof value === 'object' && !Array.isArray(value)) {
+            console.log(`${prefix}${chalk.bold(key + ':')}`);
+            printKeyValue(value, indent + 1);
+        }
+        else if (Array.isArray(value)) {
+            console.log(`${prefix}${chalk.dim(key + ':')} ${chalk.dim(`[${value.length} items]`)}`);
+        }
+        else {
+            console.log(`${prefix}${chalk.dim(key + ':')} ${chalk.white(String(value))}`);
+        }
+    }
+}
+//# sourceMappingURL=output-formatter.js.map

package/dist/utils/output-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.js","sourceRoot":"","sources":["../../src/utils/output-formatter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/cli",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "Command Line Interface for ObjectStack Protocol",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,30 +33,35 @@
     "topicSeparator": " "
   },
   "dependencies": {
-    "@oclif/core": "^4.10.3",
+    "@ai-sdk/gateway": "^3.0.95",
+    "@oclif/core": "^4.10.5",
     "bundle-require": "^5.1.0",
     "chalk": "^5.6.2",
     "dotenv-flow": "^4.1.0",
     "tsx": "^4.21.0",
+    "yaml": "^2.4.1",
     "zod": "^4.3.6",
-    "@objectstack/core": "4.0.1",
-    "@objectstack/driver-memory": "^4.0.1",
-    "@objectstack/objectql": "^4.0.1",
-    "@objectstack/plugin-hono-server": "4.0.1",
-    "@objectstack/rest": "4.0.1",
-    "@objectstack/runtime": "^4.0.1",
-    "@objectstack/spec": "4.0.1"
+    "@objectstack/client": "4.0.3",
+    "@objectstack/core": "4.0.3",
+    "@objectstack/driver-memory": "^4.0.3",
+    "@objectstack/objectql": "^4.0.3",
+    "@objectstack/plugin-hono-server": "4.0.3",
+    "@objectstack/plugin-setup": "4.0.3",
+    "@objectstack/rest": "4.0.3",
+    "@objectstack/runtime": "^4.0.3",
+    "@objectstack/service-ai": "4.0.3",
+    "@objectstack/spec": "4.0.3"
   },
   "peerDependencies": {
-    "@objectstack/core": "^4.0.1"
+    "@objectstack/core": "^4.0.3"
   },
   "devDependencies": {
-    "@oclif/plugin-help": "^6.2.41",
-    "@oclif/plugin-plugins": "^5.4.59",
-    "@types/node": "^25.5.0",
+    "@oclif/plugin-help": "^6.2.44",
+    "@oclif/plugin-plugins": "^5.4.60",
+    "@types/node": "^25.6.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/src/commands/auth/login.ts

@@ -0,0 +1,188 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Command, Flags } from '@oclif/core';
+import { printHeader, printSuccess, printError, printKV } from '../../utils/format.js';
+import { writeAuthConfig } from '../../utils/auth-config.js';
+import { ObjectStackClient } from '@objectstack/client';
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+/**
+ * Prompt for a password with masked input (shows * per character).
+ * Falls back to plain readline.question() in non-TTY environments.
+ */
+async function promptPassword(promptText: string): Promise<string> {
+  if (!process.stdin.isTTY) {
+    const rl = readline.createInterface({ input, output });
+    const answer = await rl.question(promptText);
+    rl.close();
+    return answer;
+  }
+
+  return new Promise((resolve) => {
+    const chars: string[] = [];
+    process.stdout.write(promptText);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    const cleanup = () => {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeListener('data', handler);
+      process.stdout.write('\n');
+    };
+
+    const handler = (char: string) => {
+      switch (char) {
+        case '\u0003': // Ctrl+C
+          cleanup();
+          process.kill(process.pid, 'SIGINT');
+          break;
+        case '\r':
+        case '\n': // Enter
+          cleanup();
+          resolve(chars.join(''));
+          break;
+        case '\u007f': // Backspace
+          if (chars.length > 0) {
+            chars.pop();
+            process.stdout.clearLine(0);
+            process.stdout.cursorTo(0);
+            process.stdout.write(promptText + '*'.repeat(chars.length));
+          }
+          break;
+        default:
+          chars.push(char);
+          process.stdout.write('*');
+          break;
+      }
+    };
+
+    process.stdin.on('data', handler);
+  });
+}
+
+export default class AuthLogin extends Command {
+  static override description = 'Authenticate and store session credentials';
+
+  static override examples = [
+    '$ os auth login',
+    '$ os auth login --url https://api.example.com',
+    '$ os auth login --email user@example.com --password mypassword',
+  ];
+
+  static override flags = {
+    url: Flags.string({
+      char: 'u',
+      description: 'Server URL',
+      default: 'http://localhost:3000',
+      env: 'OBJECTSTACK_URL',
+    }),
+    email: Flags.string({
+      char: 'e',
+      description: 'Email address',
+    }),
+    password: Flags.string({
+      char: 'p',
+      description: 'Password',
+    }),
+    json: Flags.boolean({
+      description: 'Output as JSON',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(AuthLogin);
+
+    try {
+      if (!flags.json) {
+        printHeader('ObjectStack Login');
+        printKV('Server', flags.url);
+        console.log('');
+      }
+
+      // Prompt for credentials if not provided
+      let email = flags.email;
+      let password = flags.password;
+
+      if (!email || !password) {
+        const rl = readline.createInterface({ input, output });
+
+        if (!email) {
+          email = await rl.question('Email: ');
+        }
+
+        rl.close();
+
+        if (!password) {
+          password = await promptPassword('Password: ');
+        }
+      }
+
+      if (!email || !password) {
+        throw new Error('Email and password are required');
+      }
+
+      // Create client and authenticate
+      const client = new ObjectStackClient({
+        baseUrl: flags.url,
+      });
+
+      const response = await client.auth.login({
+        type: 'email',
+        email,
+        password,
+      });
+
+      // Check if login was successful
+      if (!response.data?.token && !response.data?.user) {
+        throw new Error('Login failed: Invalid response from server');
+      }
+
+      // Extract token - it might be in different locations depending on the auth system
+      const token = response.data?.token || (response as any).token;
+      const user = response.data?.user;
+
+      if (!token) {
+        throw new Error('Login failed: No token received from server');
+      }
+
+      // Store credentials
+      await writeAuthConfig({
+        url: flags.url,
+        token,
+        email: user?.email || email,
+        userId: user?.id,
+        createdAt: new Date().toISOString(),
+      });
+
+      if (flags.json) {
+        console.log(JSON.stringify({
+          success: true,
+          email: user?.email || email,
+          userId: user?.id,
+        }, null, 2));
+      } else {
+        printSuccess('Authentication successful');
+        printKV('Email', user?.email || email);
+        if (user?.id) {
+          printKV('User ID', user.id);
+        }
+        console.log('');
+        console.log('  Credentials stored in ~/.objectstack/credentials.json');
+        console.log('');
+      }
+    } catch (error: any) {
+      if (flags.json) {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+        }, null, 2));
+        this.exit(1);
+      }
+      printError(error.message || String(error));
+      this.exit(1);
+    }
+  }
+}

package/src/commands/auth/logout.ts

@@ -0,0 +1,51 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Command, Flags } from '@oclif/core';
+import { printHeader, printSuccess, printError } from '../../utils/format.js';
+import { deleteAuthConfig } from '../../utils/auth-config.js';
+
+export default class AuthLogout extends Command {
+  static override description = 'Clear stored authentication credentials';
+
+  static override examples = [
+    '$ os auth logout',
+  ];
+
+  static override flags = {
+    json: Flags.boolean({
+      description: 'Output as JSON',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(AuthLogout);
+
+    try {
+      if (!flags.json) {
+        printHeader('ObjectStack Logout');
+      }
+
+      await deleteAuthConfig();
+
+      if (flags.json) {
+        console.log(JSON.stringify({
+          success: true,
+          message: 'Credentials cleared',
+        }, null, 2));
+      } else {
+        printSuccess('Credentials cleared');
+        console.log('');
+      }
+    } catch (error: any) {
+      if (flags.json) {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+        }, null, 2));
+        this.exit(1);
+      }
+      printError(error.message || String(error));
+      this.exit(1);
+    }
+  }
+}

package/src/commands/auth/whoami.ts

@@ -0,0 +1,85 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Command, Flags } from '@oclif/core';
+import { printHeader, printError, printKV } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+
+export default class AuthWhoami extends Command {
+  static override description = 'Show current session information';
+
+  static override examples = [
+    '$ os auth whoami',
+    '$ os auth whoami --format json',
+    '$ os auth whoami --url https://api.example.com --token <token>',
+  ];
+
+  static override flags = {
+    url: Flags.string({
+      char: 'u',
+      description: 'Server URL',
+      env: 'OBJECTSTACK_URL',
+    }),
+    token: Flags.string({
+      char: 't',
+      description: 'Authentication token',
+      env: 'OBJECTSTACK_TOKEN',
+    }),
+    format: Flags.string({
+      char: 'f',
+      description: 'Output format',
+      options: ['json', 'table', 'yaml'],
+      default: 'table',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(AuthWhoami);
+
+    try {
+      const { client, token } = await createApiClient({
+        url: flags.url,
+        token: flags.token,
+      });
+
+      requireAuth(token);
+
+      // Check if we have a token
+      // Get current session info
+      const response = await client.auth.me();
+
+      const sessionData = response.data || response;
+
+      if (flags.format === 'json') {
+        formatOutput(sessionData, 'json');
+      } else if (flags.format === 'yaml') {
+        formatOutput(sessionData, 'yaml');
+      } else {
+        printHeader('Current Session');
+
+        if (sessionData.user) {
+          printKV('User ID', sessionData.user.id || '-');
+          printKV('Email', sessionData.user.email || '-');
+          printKV('Name', sessionData.user.name || '-');
+        }
+
+        if (sessionData.session) {
+          printKV('Session ID', sessionData.session.id || '-');
+          printKV('Expires At', sessionData.session.expiresAt || '-');
+        }
+
+        console.log('');
+      }
+    } catch (error: any) {
+      if (flags.format === 'json') {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+        }, null, 2));
+        this.exit(1);
+      }
+      printError(error.message || String(error));
+      this.exit(1);
+    }
+  }
+}

package/src/commands/data/create.ts

@@ -0,0 +1,110 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Args, Command, Flags } from '@oclif/core';
+import { printError, printSuccess } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+
+export default class DataCreate extends Command {
+  static override description = 'Create a new record';
+
+  static override examples = [
+    '$ os data create project_task \'{"name":"New Task","status":"open"}\'',
+    '$ os data create project_task --data task-data.json',
+    '$ os data create project_task --data task-data.json --format json',
+  ];
+
+  static override args = {
+    object: Args.string({
+      description: 'Object name (snake_case)',
+      required: true,
+    }),
+    data: Args.string({
+      description: 'Record data as JSON string (or use --data flag for file)',
+    }),
+  };
+
+  static override flags = {
+    url: Flags.string({
+      char: 'u',
+      description: 'Server URL',
+      env: 'OBJECTSTACK_URL',
+    }),
+    token: Flags.string({
+      char: 't',
+      description: 'Authentication token',
+      env: 'OBJECTSTACK_TOKEN',
+    }),
+    data: Flags.string({
+      char: 'd',
+      description: 'Path to JSON file containing record data',
+    }),
+    format: Flags.string({
+      char: 'f',
+      description: 'Output format',
+      options: ['json', 'table', 'yaml'],
+      default: 'table',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args, flags } = await this.parse(DataCreate);
+
+    try {
+      const { client, token } = await createApiClient({
+        url: flags.url,
+        token: flags.token,
+      });
+
+      requireAuth(token);
+
+      // Parse record data
+      let recordData: any;
+
+      if (flags.data) {
+        // Read from file
+        const { readFile } = await import('node:fs/promises');
+        const fileContent = await readFile(flags.data, 'utf-8');
+        try {
+          recordData = JSON.parse(fileContent);
+        } catch (e) {
+          throw new Error(`Invalid JSON in file: ${(e as Error).message}`);
+        }
+      } else if (args.data) {
+        // Parse from argument
+        try {
+          recordData = JSON.parse(args.data);
+        } catch (e) {
+          throw new Error(`Invalid JSON: ${(e as Error).message}`);
+        }
+      } else {
+        throw new Error('Record data is required (provide JSON string or use --data flag)');
+      }
+
+      // Create the record
+      const result = await client.data.create(args.object, recordData);
+
+      if (flags.format === 'json') {
+        formatOutput(result, 'json');
+      } else if (flags.format === 'yaml') {
+        formatOutput(result, 'yaml');
+      } else {
+        printSuccess(`Record created: ${result.id}`);
+        if (result.record) {
+          console.log('');
+          formatOutput(result.record, 'table');
+        }
+      }
+    } catch (error: any) {
+      if (flags.format === 'json') {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+        }, null, 2));
+        this.exit(1);
+      }
+      printError(error.message || String(error));
+      this.exit(1);
+    }
+  }
+}

package/src/commands/data/delete.ts

@@ -0,0 +1,84 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Args, Command, Flags } from '@oclif/core';
+import { printError, printSuccess } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+
+export default class DataDelete extends Command {
+  static override description = 'Delete a record';
+
+  static override examples = [
+    '$ os data delete project_task abc123',
+    '$ os data delete project_task abc123 --format json',
+  ];
+
+  static override args = {
+    object: Args.string({
+      description: 'Object name (snake_case)',
+      required: true,
+    }),
+    id: Args.string({
+      description: 'Record ID',
+      required: true,
+    }),
+  };
+
+  static override flags = {
+    url: Flags.string({
+      char: 'u',
+      description: 'Server URL',
+      env: 'OBJECTSTACK_URL',
+    }),
+    token: Flags.string({
+      char: 't',
+      description: 'Authentication token',
+      env: 'OBJECTSTACK_TOKEN',
+    }),
+    format: Flags.string({
+      char: 'f',
+      description: 'Output format',
+      options: ['json', 'table', 'yaml'],
+      default: 'table',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args, flags } = await this.parse(DataDelete);
+
+    try {
+      const { client, token } = await createApiClient({
+        url: flags.url,
+        token: flags.token,
+      });
+
+      requireAuth(token);
+
+      // Delete the record
+      const result = await client.data.delete(args.object, args.id);
+
+      if (flags.format === 'json') {
+        console.log(JSON.stringify({
+          success: true,
+          object: result.object,
+          id: result.id,
+          deleted: result.deleted,
+        }, null, 2));
+      } else if (flags.format === 'yaml') {
+        formatOutput({ success: true, object: result.object, id: result.id, deleted: result.deleted }, 'yaml');
+      } else {
+        printSuccess(`Record deleted: ${result.id}`);
+      }
+    } catch (error: any) {
+      if (flags.format === 'json') {
+        console.log(JSON.stringify({
+          success: false,
+          error: error.message,
+        }, null, 2));
+        this.exit(1);
+      }
+      printError(error.message || String(error));
+      this.exit(1);
+    }
+  }
+}