@objectstack/cli 3.0.6 → 3.0.8

package/dist/commands/validate.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Validate extends Command {
+    static description: string;
+    static args: {
+        config: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        strict: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAiBnD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,OAAgB,WAAW,SAAoE;IAE/F,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+G3B"}

package/dist/commands/validate.js

@@ -0,0 +1,115 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Args, Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+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 description = 'Validate ObjectStack configuration against the protocol schema';
+    static args = {
+        config: Args.string({ description: 'Configuration file path', required: false }),
+    };
+    static flags = {
+        strict: Flags.boolean({ description: 'Treat warnings as errors' }),
+        json: Flags.boolean({ description: 'Output results as JSON' }),
+    };
+    async run() {
+        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);
+            const result = ObjectStackDefinitionSchema.safeParse(normalized);
+            if (!result.success) {
+                if (flags.json) {
+                    console.log(JSON.stringify({
+                        valid: false,
+                        errors: result.error.issues,
+                        duration: timer.elapsed(),
+                    }, null, 2));
+                    this.exit(1);
+                }
+                console.log('');
+                printError('Validation failed');
+                formatZodErrors(result.error);
+                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 = [];
+            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) {
+            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);
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/index.d.ts

@@ -1,114 +1,15 @@
-import { Command } from 'commander';
-
-declare const compileCommand: Command;
-
-declare const validateCommand: Command;
-
-declare const infoCommand: Command;
-
-declare const initCommand: Command;
-
-declare const generateCommand: Command;
-
-declare const templates: {
-    plugin: {
-        description: string;
-        files: {
-            'package.json': (name: string) => {
-                name: string;
-                version: string;
-                description: string;
-                main: string;
-                types: string;
-                scripts: {
-                    build: string;
-                    dev: string;
-                    test: string;
-                };
-                keywords: string[];
-                author: string;
-                license: string;
-                dependencies: {
-                    '@objectstack/spec': string;
-                    zod: string;
-                };
-                devDependencies: {
-                    '@types/node': string;
-                    typescript: string;
-                    vitest: string;
-                };
-            };
-            'tsconfig.json': () => {
-                extends: string;
-                compilerOptions: {
-                    outDir: string;
-                    rootDir: string;
-                };
-                include: string[];
-            };
-            'src/index.ts': (name: string) => string;
-            'README.md': (name: string) => string;
-        };
-    };
-    example: {
-        description: string;
-        files: {
-            'package.json': (name: string) => {
-                name: string;
-                version: string;
-                private: boolean;
-                description: string;
-                scripts: {
-                    build: string;
-                    dev: string;
-                    test: string;
-                };
-                dependencies: {
-                    '@objectstack/spec': string;
-                    '@objectstack/cli': string;
-                    zod: string;
-                };
-                devDependencies: {
-                    '@types/node': string;
-                    tsx: string;
-                    typescript: string;
-                    vitest: string;
-                };
-            };
-            'objectstack.config.ts': (name: string) => string;
-            'README.md': (name: string) => string;
-            'tsconfig.json': () => {
-                extends: string;
-                compilerOptions: {
-                    outDir: string;
-                    rootDir: string;
-                };
-                include: string[];
-            };
-        };
-    };
-};
-declare const createCommand: Command;
-
-declare const pluginCommand: Command;
-
-declare const devCommand: Command;
-
-declare const serveCommand: Command;
-
-declare const testCommand: Command;
-
-declare const doctorCommand: Command;
-
-/**
- * Discover CLI command contributions from installed plugins.
- *
- * Scans the project's `objectstack.config.ts` for plugins that declare
- * `contributes.commands` in their manifest, then dynamically imports
- * those plugin modules to register Commander.js commands.
- *
- * @param program - The root Commander.js program to register commands on
- */
-declare function loadPluginCommands(program: Command): Promise<void>;
-
-export { compileCommand, createCommand, devCommand, doctorCommand, generateCommand, infoCommand, initCommand, loadPluginCommands, pluginCommand, serveCommand, templates, testCommand, validateCommand };
+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';
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}