@objectstack/cli 4.0.4 → 4.1.0

package/dist/commands/publish.js

@@ -0,0 +1,135 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { readFile } from 'node:fs/promises';
+import { resolve as resolvePath } from 'node:path';
+import { Args, Command, Flags } from '@oclif/core';
+import { printHeader, printKV, printSuccess, printError, printStep } from '../utils/format.js';
+export default class Publish extends Command {
+    static description = 'Publish a compiled artifact to ObjectStack Cloud';
+    static args = {
+        artifact: Args.string({ description: 'Path to compiled artifact (default: dist/objectstack.json)', required: false }),
+    };
+    static flags = {
+        server: Flags.string({
+            char: 's',
+            description: 'ObjectStack Cloud control-plane URL',
+            env: 'OS_CLOUD_URL',
+            default: 'http://localhost:4000',
+        }),
+        project: Flags.string({
+            char: 'p',
+            description: 'Project ID (required)',
+            env: 'OS_PROJECT_ID',
+            required: true,
+        }),
+        token: Flags.string({
+            char: 't',
+            description: 'API key for ObjectStack Cloud',
+            env: 'OS_CLOUD_API_KEY',
+        }),
+        timeout: Flags.integer({
+            description: 'Upload timeout in milliseconds (use a higher value on slow networks; 0 disables timeout)',
+            env: 'OS_CLOUD_TIMEOUT_MS',
+            default: 60_000,
+        }),
+        note: Flags.string({
+            char: 'n',
+            description: 'Optional human-readable note to attach to this revision',
+        }),
+        branch: Flags.string({
+            char: 'b',
+            description: 'Logical branch this publish belongs to (e.g. main, staging, feature-x). Default: main.',
+            env: 'OS_PUBLISH_BRANCH',
+            default: 'main',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Publish);
+        printHeader('Publish Artifact');
+        try {
+            // 1. Locate the compiled artifact
+            const artifactPath = args.artifact
+                ? resolvePath(process.cwd(), args.artifact)
+                : resolvePath(process.cwd(), 'dist/objectstack.json');
+            printStep(`Loading artifact from ${artifactPath}...`);
+            let artifactRaw;
+            try {
+                artifactRaw = await readFile(artifactPath, 'utf-8');
+            }
+            catch (err) {
+                printError(`Cannot read artifact: ${err.message}. Run \`objectstack build\` first.`);
+                this.exit(1);
+                return;
+            }
+            const artifact = JSON.parse(artifactRaw);
+            printSuccess(`Loaded artifact (${(artifactRaw.length / 1024).toFixed(1)} KB)`);
+            // 2. POST to the control-plane publish endpoint
+            const qsParams = new URLSearchParams();
+            if (flags.note)
+                qsParams.set('note', flags.note);
+            if (flags.branch)
+                qsParams.set('branch', flags.branch);
+            const qs = qsParams.toString();
+            const serverUrl = `${flags.server}/api/v1/cloud/projects/${flags.project}/metadata${qs ? `?${qs}` : ''}`;
+            printStep(`Publishing to ${serverUrl}...`);
+            const response = await (async () => {
+                const controller = new AbortController();
+                const timer = flags.timeout > 0
+                    ? setTimeout(() => controller.abort(), flags.timeout)
+                    : undefined;
+                try {
+                    return await fetch(serverUrl, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            ...(flags.token && { Authorization: `Bearer ${flags.token}` }),
+                        },
+                        body: artifactRaw,
+                        signal: controller.signal,
+                    });
+                }
+                catch (err) {
+                    if (err?.name === 'AbortError') {
+                        throw new Error(`Upload timed out after ${flags.timeout}ms. Use --timeout <ms> or set OS_CLOUD_TIMEOUT_MS to extend it (0 disables).`);
+                    }
+                    throw err;
+                }
+                finally {
+                    if (timer)
+                        clearTimeout(timer);
+                }
+            })();
+            if (!response.ok) {
+                let errMsg;
+                try {
+                    const errBody = await response.json();
+                    errMsg = errBody?.error ?? response.statusText;
+                }
+                catch {
+                    errMsg = response.statusText;
+                }
+                printError(`Publish failed (${response.status}): ${errMsg}`);
+                this.exit(1);
+                return;
+            }
+            const result = await response.json();
+            const data = result?.data ?? result;
+            console.log('');
+            printSuccess('Artifact published successfully');
+            printKV('  Project', flags.project);
+            printKV('  Branch', data?.branch ?? flags.branch);
+            if (data?.commitId)
+                printKV('  Commit', data.commitId);
+            const checksumStr = typeof data?.checksum === 'string'
+                ? data.checksum
+                : (data?.checksum?.value ?? null);
+            if (checksumStr)
+                printKV('  Checksum', String(checksumStr).slice(0, 16));
+            printKV('  Server', flags.server);
+        }
+        catch (error) {
+            printError(error.message);
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/commands/publish.js.map

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

package/dist/commands/{auth/login.d.ts → register.d.ts}

@@ -1,13 +1,14 @@
 import { Command } from '@oclif/core';
-export default class AuthLogin extends Command {
+export default class AuthRegister extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         url: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         email: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         password: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }
-//# sourceMappingURL=login.d.ts.map
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AA2D7C,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAAgD;IAE3E,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;;MAsBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmE3B"}

package/dist/commands/{auth/login.js → register.js}

@@ -1,14 +1,10 @@
 // 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 { 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) {
     if (!process.stdin.isTTY) {
         const rl = readline.createInterface({ input, output });
@@ -30,16 +26,16 @@ async function promptPassword(promptText) {
         };
         const handler = (char) => {
             switch (char) {
-                case '\u0003': // Ctrl+C
+                case '': // Ctrl+C
                     cleanup();
                     process.kill(process.pid, 'SIGINT');
                     break;
                 case '\r':
-                case '\n': // Enter
+                case '\n':
                     cleanup();
                     resolve(chars.join(''));
                     break;
-                case '\u007f': // Backspace
+                case '': // Backspace
                     if (chars.length > 0) {
                         chars.pop();
                         process.stdout.clearLine(0);
@@ -56,24 +52,28 @@ async function promptPassword(promptText) {
         process.stdin.on('data', handler);
     });
 }
-export default class AuthLogin extends Command {
-    static description = 'Authenticate and store session credentials';
+export default class AuthRegister extends Command {
+    static description = 'Create a new account and store credentials';
     static examples = [
-        '$ os auth login',
-        '$ os auth login --url https://api.example.com',
-        '$ os auth login --email user@example.com --password mypassword',
+        '$ os auth register',
+        '$ os auth register --email user@example.com --name "Jane Doe" --password mypassword',
+        '$ os auth register --url https://api.example.com',
     ];
     static flags = {
         url: Flags.string({
             char: 'u',
             description: 'Server URL',
             default: 'http://localhost:3000',
-            env: 'OBJECTSTACK_URL',
+            env: 'OS_CLOUD_URL',
         }),
         email: Flags.string({
             char: 'e',
             description: 'Email address',
         }),
+        name: Flags.string({
+            char: 'n',
+            description: 'Display name',
+        }),
         password: Flags.string({
             char: 'p',
             description: 'Password',
@@ -83,49 +83,40 @@ export default class AuthLogin extends Command {
         }),
     };
     async run() {
-        const { flags } = await this.parse(AuthLogin);
+        const { flags } = await this.parse(AuthRegister);
         try {
             if (!flags.json) {
-                printHeader('ObjectStack Login');
+                printHeader('ObjectStack Register');
                 printKV('Server', flags.url);
                 console.log('');
             }
-            // Prompt for credentials if not provided
+            const rl = readline.createInterface({ input, output });
             let email = flags.email;
+            let name = flags.name;
             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');
+            if (!email) {
+                email = await rl.question('Email: ');
             }
-            // 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');
+            if (!name) {
+                name = await rl.question('Name (optional): ');
             }
-            // Extract token - it might be in different locations depending on the auth system
-            const token = response.data?.token || response.token;
-            const user = response.data?.user;
-            if (!token) {
-                throw new Error('Login failed: No token received from server');
+            rl.close();
+            if (!password) {
+                password = await promptPassword('Password: ');
             }
-            // Store credentials
+            if (!email)
+                throw new Error('Email is required');
+            if (!password)
+                throw new Error('Password is required');
+            const client = new ObjectStackClient({ baseUrl: flags.url });
+            const registerPayload = { email, password };
+            if (name)
+                registerPayload.name = name;
+            const response = await client.auth.register(registerPayload);
+            const token = response.data?.token ?? response.token;
+            const user = response.data?.user ?? response.user;
+            if (!token)
+                throw new Error('Registration failed: No token received from server');
             await writeAuthConfig({
                 url: flags.url,
                 token,
@@ -134,18 +125,13 @@ export default class AuthLogin extends Command {
                 createdAt: new Date().toISOString(),
             });
             if (flags.json) {
-                console.log(JSON.stringify({
-                    success: true,
-                    email: user?.email || email,
-                    userId: user?.id,
-                }, null, 2));
+                console.log(JSON.stringify({ success: true, email: user?.email || email, userId: user?.id }, null, 2));
             }
             else {
-                printSuccess('Authentication successful');
+                printSuccess('Account created and logged in');
                 printKV('Email', user?.email || email);
-                if (user?.id) {
+                if (user?.id)
                     printKV('User ID', user.id);
-                }
                 console.log('');
                 console.log('  Credentials stored in ~/.objectstack/credentials.json');
                 console.log('');
@@ -153,10 +139,7 @@ export default class AuthLogin extends Command {
         }
         catch (error) {
             if (flags.json) {
-                console.log(JSON.stringify({
-                    success: false,
-                    error: error.message,
-                }, null, 2));
+                console.log(JSON.stringify({ success: false, error: error.message }, null, 2));
                 this.exit(1);
             }
             printError(error.message || String(error));
@@ -164,4 +147,4 @@ export default class AuthLogin extends Command {
         }
     }
 }
-//# sourceMappingURL=login.js.map
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

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

package/dist/commands/rollback.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Rollback extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        server: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        commit: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=rollback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/commands/rollback.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAG7C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,OAAgB,WAAW,SAAkF;IAE7G,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;;;MAuBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C3B"}

package/dist/commands/rollback.js

@@ -0,0 +1,77 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Command, Flags } from '@oclif/core';
+import { printHeader, printKV, printSuccess, printError, printStep } from '../utils/format.js';
+export default class Rollback extends Command {
+    static description = 'Activate a previously published artifact revision (rollback or roll-forward)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --commit 9ce1bd48dd70',
+        'OS_PROJECT_ID=proj_crm <%= config.bin %> <%= command.id %> --commit abcdef123456',
+    ];
+    static flags = {
+        server: Flags.string({
+            char: 's',
+            description: 'ObjectStack Cloud control-plane URL',
+            env: 'OS_CLOUD_URL',
+            default: 'http://localhost:4000',
+        }),
+        project: Flags.string({
+            char: 'p',
+            description: 'Project ID (required)',
+            env: 'OS_PROJECT_ID',
+            required: true,
+        }),
+        commit: Flags.string({
+            char: 'c',
+            description: 'Commit ID (full or 12+ char prefix) of the revision to activate',
+            required: true,
+        }),
+        token: Flags.string({
+            char: 't',
+            description: 'API key for ObjectStack Cloud',
+            env: 'OS_CLOUD_API_KEY',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Rollback);
+        printHeader('Rollback / Activate Revision');
+        try {
+            const url = `${flags.server}/api/v1/cloud/projects/${flags.project}/revisions/${flags.commit}/activate`;
+            printStep(`POST ${url}`);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(flags.token && { Authorization: `Bearer ${flags.token}` }),
+                },
+            });
+            if (!response.ok) {
+                let errMsg;
+                try {
+                    const errBody = await response.json();
+                    errMsg = errBody?.error ?? response.statusText;
+                }
+                catch {
+                    errMsg = response.statusText;
+                }
+                printError(`Activate failed (${response.status}): ${errMsg}`);
+                this.exit(1);
+                return;
+            }
+            const result = await response.json();
+            const data = result?.data ?? result;
+            console.log('');
+            printSuccess('Revision activated');
+            printKV('  Project', flags.project);
+            if (data?.commitId)
+                printKV('  Commit', data.commitId);
+            if (data?.previousCommitId)
+                printKV('  Previous', data.previousCommitId);
+            printKV('  Server', flags.server);
+        }
+        catch (error) {
+            printError(error.message);
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/commands/rollback.js.map

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

package/dist/commands/serve.d.ts

@@ -8,8 +8,30 @@ export default class Serve extends Command {
         port: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         dev: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         ui: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        console: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         server: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        prebuilt: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        preset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    /**
+     * Capabilities auto-added to every app's `requires` for every preset
+     * EXCEPT `minimal`. These form the foundation that every server-side
+     * runtime expects to exist (background work, settings persistence,
+     * transactional mail, file uploads). Apps may still list these in
+     * `requires:` explicitly — duplicates are de-duped.
+     *
+     * Opt out: `objectstack serve --preset minimal`.
+     *
+     * Mirrored on hosted objectos per-project kernels by
+     * `mountDefaultProjectPlugins()` in `@objectstack/service-cloud`.
+     */
+    static readonly ALWAYS_ON_CAPABILITIES: readonly string[];
+    /**
+     * Auto-registered plugin tiers. Plugins explicitly listed in
+     * `config.plugins` are always loaded — tiers only gate the optional
+     * auto-registration blocks below (AIService, I18n, Studio UI, etc.).
+     */
+    static readonly TIER_PRESETS: Record<string, string[]>;
     run(): Promise<void>;
 }
 //# sourceMappingURL=serve.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAkDnD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,OAAgB,WAAW,SAA8D;IAEzF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;MAKnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwV3B"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AA8DnD,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,OAAgB,WAAW,SAAkM;IAE7N,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;;;MAenB;IAEF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAEtD;IAEH;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAIpD;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAq1C3B"}