@objectstack/cli 4.0.4 → 4.1.0

package/src/commands/validate.ts

@@ -1,143 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import { ZodError } from 'zod';
-import { ObjectStackDefinitionSchema, normalizeStackInput } from '@objectstack/spec';
-import { loadConfig } from '../utils/config.js';
-import {
-  printHeader,
-  printKV,
-  printSuccess,
-  printError,
-  printStep,
-  createTimer,
-  formatZodErrors,
-  collectMetadataStats,
-  printMetadataStats,
-} from '../utils/format.js';
-
-export default class Validate extends Command {
-  static override description = 'Validate ObjectStack configuration against the protocol schema';
-
-  static override args = {
-    config: Args.string({ description: 'Configuration file path', required: false }),
-  };
-
-  static override flags = {
-    strict: Flags.boolean({ description: 'Treat warnings as errors' }),
-    json: Flags.boolean({ description: 'Output results as JSON' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Validate);
-
-    const timer = createTimer();
-    
-    if (!flags.json) {
-      printHeader('Validate');
-    }
-
-    try {
-      // 1. Load configuration
-      if (!flags.json) printStep('Loading configuration...');
-      const { config, absolutePath, duration } = await loadConfig(args.config);
-      
-      if (!flags.json) {
-        printKV('Config', absolutePath);
-        printKV('Load time', `${duration}ms`);
-      }
-
-      // 2. Normalize map-formatted stack definition and validate against schema
-      if (!flags.json) printStep('Validating against ObjectStack Protocol...');
-      const normalized = normalizeStackInput(config as Record<string, unknown>);
-      const result = ObjectStackDefinitionSchema.safeParse(normalized);
-
-      if (!result.success) {
-        if (flags.json) {
-          console.log(JSON.stringify({
-            valid: false,
-            errors: (result.error as unknown as ZodError).issues,
-            duration: timer.elapsed(),
-          }, null, 2));
-          this.exit(1);
-        }
-
-        console.log('');
-        printError('Validation failed');
-        formatZodErrors(result.error as unknown as ZodError);
-        this.exit(1);
-      }
-
-      // 3. Collect and display stats
-      const stats = collectMetadataStats(config);
-
-      if (flags.json) {
-        console.log(JSON.stringify({
-          valid: true,
-          manifest: config.manifest,
-          stats,
-          duration: timer.elapsed(),
-        }, null, 2));
-        return;
-      }
-
-      // 4. Warnings (non-blocking)
-      const warnings: string[] = [];
-      
-      if (stats.objects === 0) {
-        warnings.push('No objects defined — this stack has no data model');
-      }
-      if (stats.apps === 0 && stats.plugins === 0) {
-        warnings.push('No apps or plugins defined — this stack may not do much');
-      }
-      if (!config.manifest?.id) {
-        warnings.push('Missing manifest.id — required for deployment');
-      }
-      if (!config.manifest?.namespace) {
-        warnings.push('Missing manifest.namespace — required for multi-app hosting');
-      }
-
-      // 5. Display results
-      console.log('');
-      printSuccess(`Validation passed ${chalk.dim(`(${timer.display()})`)}`);
-      console.log('');
-
-      if (config.manifest) {
-        console.log(`  ${chalk.bold(config.manifest.name || config.manifest.id || 'Unnamed')} ${chalk.dim(`v${config.manifest.version || '0.0.0'}`)}`);
-        if (config.manifest.description) {
-          console.log(chalk.dim(`  ${config.manifest.description}`));
-        }
-        console.log('');
-      }
-
-      printMetadataStats(stats);
-
-      if (warnings.length > 0) {
-        console.log('');
-        for (const w of warnings) {
-          console.log(chalk.yellow(`  ⚠ ${w}`));
-        }
-        if (flags.strict) {
-          console.log('');
-          printError('Strict mode: warnings treated as errors');
-          this.exit(1);
-        }
-      }
-
-      console.log('');
-    } catch (error: any) {
-      if (flags.json) {
-        console.log(JSON.stringify({
-          valid: false,
-          error: error.message,
-          duration: timer.elapsed(),
-        }, null, 2));
-        this.exit(1);
-      }
-      console.log('');
-      printError(error.message || String(error));
-      this.exit(1);
-    }
-  }
-}

package/src/index.ts

@@ -1,22 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-// ─── oclif Command Classes ──────────────────────────────────────────
-// Each command is auto-discovered by oclif from `src/commands/`.
-// These re-exports provide programmatic access for testing and integration.
-
-export { default as CompileCommand } from './commands/compile.js';
-export { default as ValidateCommand } from './commands/validate.js';
-export { default as InfoCommand } from './commands/info.js';
-export { default as InitCommand } from './commands/init.js';
-export { default as GenerateCommand } from './commands/generate.js';
-export { default as CreateCommand } from './commands/create.js';
-export { default as DevCommand } from './commands/dev.js';
-export { default as ServeCommand } from './commands/serve.js';
-export { default as TestCommand } from './commands/test.js';
-export { default as DoctorCommand } from './commands/doctor.js';
-
-// ─── Plugin topic subcommands ───────────────────────────────────────
-export { default as PluginListCommand } from './commands/plugin/list.js';
-export { default as PluginInfoCommand } from './commands/plugin/info.js';
-export { default as PluginAddCommand } from './commands/plugin/add.js';
-export { default as PluginRemoveCommand } from './commands/plugin/remove.js';

package/src/utils/api-client.ts

@@ -1,88 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { ObjectStackClient } from '@objectstack/client';
-import { readAuthConfig } from './auth-config.js';
-
-/**
- * API client configuration options for CLI commands
- */
-export interface ApiClientOptions {
-  /**
-   * Server URL (defaults to OBJECTSTACK_URL env var or http://localhost:3000)
-   */
-  url?: string;
-  /**
-   * Authentication token (defaults to stored credentials or OBJECTSTACK_TOKEN env var)
-   */
-  token?: string;
-  /**
-   * Enable debug logging
-   */
-  debug?: boolean;
-}
-
-/**
- * Result returned by createApiClient — exposes the resolved token so commands
- * can call requireAuth() without accessing private client fields.
- */
-export interface ApiClientResult {
-  client: ObjectStackClient;
-  token?: string;
-}
-
-/**
- * Create an authenticated ObjectStack API client for CLI commands.
- *
- * Resolves configuration in this priority order:
- * 1. Explicit options passed to the function
- * 2. Environment variables (OBJECTSTACK_URL, OBJECTSTACK_TOKEN)
- * 3. Stored credentials from `os auth login`
- * 4. Defaults (http://localhost:3000)
- */
-export async function createApiClient(options: ApiClientOptions = {}): Promise<ApiClientResult> {
-  // Resolve server URL (without applying defaults yet)
-  let baseUrl = options.url || process.env.OBJECTSTACK_URL;
-
-  // Resolve authentication token
-  let token = options.token || process.env.OBJECTSTACK_TOKEN;
-
-  // If URL or token is missing, try to load from stored credentials
-  if (!baseUrl || !token) {
-    try {
-      const authConfig = await readAuthConfig();
-      if (!token && authConfig.token) {
-        token = authConfig.token;
-      }
-      if (!baseUrl && authConfig.url) {
-        baseUrl = authConfig.url;
-      }
-    } catch {
-      // No stored credentials - commands will fail if auth is required
-    }
-  }
-
-  // Apply final default for baseUrl if still not resolved
-  if (!baseUrl) {
-    baseUrl = 'http://localhost:3000';
-  }
-
-  const client = new ObjectStackClient({
-    baseUrl,
-    token,
-    debug: options.debug || false,
-  });
-
-  return { client, token };
-}
-
-/**
- * Ensure authentication is present, throwing an error if not.
- * Use this in commands that require authentication.
- */
-export function requireAuth(token?: string): void {
-  if (!token) {
-    throw new Error(
-      'Authentication required. Please run `os auth login` or set OBJECTSTACK_TOKEN environment variable.'
-    );
-  }
-}

package/src/utils/auth-config.ts

@@ -1,107 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { readFile, writeFile, mkdir, chmod } from 'node:fs/promises';
-
-/**
- * Authentication configuration stored in ~/.objectstack/credentials.json
- */
-export interface AuthConfig {
-  /**
-   * Server URL (base URL for the ObjectStack instance)
-   */
-  url: string;
-  /**
-   * Authentication token (Bearer token)
-   */
-  token: string;
-  /**
-   * User email (for display purposes)
-   */
-  email?: string;
-  /**
-   * User ID
-   */
-  userId?: string;
-  /**
-   * Timestamp when credentials were created
-   */
-  createdAt: string;
-  /**
-   * Timestamp when credentials were last used
-   */
-  lastUsedAt?: string;
-}
-
-/**
- * Get the path to the credentials file
- */
-export function getCredentialsPath(): string {
-  return join(homedir(), '.objectstack', 'credentials.json');
-}
-
-/**
- * Read stored authentication configuration
- */
-export async function readAuthConfig(): Promise<AuthConfig> {
-  const path = getCredentialsPath();
-  try {
-    const content = await readFile(path, 'utf-8');
-    return JSON.parse(content) as AuthConfig;
-  } catch (error: any) {
-    if (error.code === 'ENOENT') {
-      throw new Error('No stored credentials found. Please run `os auth login` first.');
-    }
-    throw new Error(`Failed to read credentials: ${error.message}`);
-  }
-}
-
-/**
- * Write authentication configuration
- */
-export async function writeAuthConfig(config: AuthConfig): Promise<void> {
-  const path = getCredentialsPath();
-  const dir = join(homedir(), '.objectstack');
-
-  // Ensure directory exists
-  await mkdir(dir, { recursive: true });
-
-  // Write credentials file
-  await writeFile(path, JSON.stringify(config, null, 2), { mode: 0o600 });
-
-  // Explicitly enforce permissions in case the file already existed with broader perms
-  try {
-    await chmod(path, 0o600);
-  } catch {
-    // Best-effort — platforms that don't support chmod will silently continue
-  }
-}
-
-/**
- * Delete stored authentication configuration
- */
-export async function deleteAuthConfig(): Promise<void> {
-  const path = getCredentialsPath();
-  try {
-    const { unlink } = await import('node:fs/promises');
-    await unlink(path);
-  } catch (error: any) {
-    if (error.code !== 'ENOENT') {
-      throw new Error(`Failed to delete credentials: ${error.message}`);
-    }
-  }
-}
-
-/**
- * Update last used timestamp
- */
-export async function touchAuthConfig(): Promise<void> {
-  try {
-    const config = await readAuthConfig();
-    config.lastUsedAt = new Date().toISOString();
-    await writeAuthConfig(config);
-  } catch {
-    // Ignore errors - this is best-effort
-  }
-}

package/src/utils/config.ts

@@ -1,80 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import path from 'path';
-import fs from 'fs';
-import chalk from 'chalk';
-import { bundleRequire } from 'bundle-require';
-import { printError } from './format.js';
-
-export interface LoadedConfig {
-  config: any;
-  absolutePath: string;
-  duration: number;
-}
-
-/**
- * Resolve the config file path. Supports:
- * - explicit path (objectstack.config.ts)
- * - auto-detection (searches for objectstack.config.{ts,js,mjs})
- */
-export function resolveConfigPath(source?: string): string {
-  if (source) {
-    const abs = path.resolve(process.cwd(), source);
-    if (!fs.existsSync(abs)) {
-      printError(`Config file not found: ${chalk.white(abs)}`);
-      console.log('');
-      console.log(chalk.dim('  Hint: Run this command from a directory with objectstack.config.ts'));
-      console.log(chalk.dim('  Or specify the path: objectstack <command> path/to/config.ts'));
-      process.exit(1);
-    }
-    return abs;
-  }
-
-  // Auto-detect
-  const candidates = [
-    'objectstack.config.ts',
-    'objectstack.config.js',
-    'objectstack.config.mjs',
-  ];
-
-  for (const candidate of candidates) {
-    const abs = path.resolve(process.cwd(), candidate);
-    if (fs.existsSync(abs)) return abs;
-  }
-
-  printError('No objectstack.config.{ts,js,mjs} found in current directory');
-  console.log('');
-  console.log(chalk.dim('  Hint: Run `objectstack init` to create a new project'));
-  process.exit(1);
-}
-
-/**
- * Load and bundle a config file using bundle-require.
- * Returns the resolved config object and load time.
- */
-export async function loadConfig(source?: string): Promise<LoadedConfig> {
-  const absolutePath = resolveConfigPath(source);
-  const start = Date.now();
-
-  const { mod } = await bundleRequire({
-    filepath: absolutePath,
-  });
-
-  const config = mod.default || mod;
-  if (!config) {
-    throw new Error(`No default export found in ${path.basename(absolutePath)}`);
-  }
-
-  return {
-    config,
-    absolutePath,
-    duration: Date.now() - start,
-  };
-}
-
-/**
- * Check whether a file exists at the given path (relative to cwd).
- */
-export function configExists(name: string = 'objectstack.config.ts'): boolean {
-  return fs.existsSync(path.resolve(process.cwd(), name));
-}