@relesio/cli 0.2.6

package/README.md

@@ -0,0 +1,224 @@
+# Relesio CLI
+
+Command-line tool for [Relesio](https://relesio.com) — modern micro-frontend hosting. Upload versions, deploy to environments, and manage projects from the terminal.
+
+## Requirements
+
+- **Node.js** >= 18
+- **Bun** (recommended) or **npm** / **pnpm**
+
+## Installation
+
+### From npm
+
+```bash
+npm install -g @relesio/cli
+# or
+bun add -g @relesio/cli
+```
+
+### From source (monorepo)
+
+```bash
+cd api
+bun install
+bun run build --filter=@relesio/cli
+```
+
+Link locally:
+
+```bash
+cd apps/cli
+bun link
+```
+
+## Quick Start
+
+1. **Authenticate** with your API token:
+
+   ```bash
+   relesio auth login --token rls_your_token_here
+   ```
+
+   Or use the `RELESIO_API_TOKEN` environment variable.
+
+2. **Upload** a built frontend:
+
+   ```bash
+   relesio upload ./dist --project my-app --version 1.0.0
+   ```
+
+3. **Deploy** to an environment:
+
+   ```bash
+   relesio deploy my-app 1.0.0 --env production --yes
+   ```
+
+## Commands
+
+### Authentication
+
+| Command               | Description              |
+| --------------------- | ------------------------ |
+| `relesio auth login`  | Authenticate with token  |
+| `relesio auth status` | Show current auth state  |
+| `relesio auth logout` | Clear stored credentials |
+| `relesio whoami`      | Show current user info   |
+
+### Organizations & Projects
+
+| Command                              | Description                          |
+| ------------------------------------ | ------------------------------------ |
+| `relesio organizations list`         | List organizations                    |
+| `relesio organizations set <org-id>` | Set active organization              |
+| `relesio projects list`              | List projects in active organization |
+| `relesio team list`                  | List teams                           |
+| `relesio team get <teamId>`          | Get team details                     |
+
+### Versions & Deployment
+
+| Command                          | Description                                  |
+| -------------------------------- | -------------------------------------------- |
+| `relesio versions list <project>`| List versions for a project                  |
+| `relesio status <project>`       | Show deployment status across environments   |
+| `relesio upload [dir]`           | Upload a new version                         |
+| `relesio deploy [project] [ver]` | Deploy a version to an environment           |
+| `relesio rollback <project>`     | Rollback to the previous version             |
+
+## Usage Examples
+
+### Authentication
+
+```bash
+# Interactive login (prompts for token)
+relesio auth login
+
+# With token flag
+relesio auth login --token rls_...
+
+# Via environment variable
+export RELESIO_API_TOKEN=rls_...
+relesio auth status
+```
+
+### Upload
+
+```bash
+# Basic upload (default dir: dist, uses package.json for project/version)
+relesio upload
+
+# Specify directory, project, and version
+relesio upload ./build --project my-app --version 1.2.0
+
+# Require clean git working directory
+relesio upload ./dist -p my-app -v 1.0.1 --require-clean
+
+# Non-interactive (skip prompts)
+relesio upload ./dist -p my-app -v 1.0.0 -y
+```
+
+### Deploy
+
+```bash
+# Deploy specific version to production
+relesio deploy my-app 1.0.0 --env production --yes
+
+# Deploy latest version
+relesio deploy my-app --latest --env staging
+
+# Use project from package.json
+relesio deploy --env production
+```
+
+### Rollback
+
+```bash
+relesio rollback my-app --env production --yes
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable           | Description                             | Default                    |
+| ------------------ | --------------------------------------- | -------------------------- |
+| `RELESIO_API_TOKEN`| API token (starts with `rls_`)          | —                          |
+| `RELESIO_API_URL`  | API base URL                            | `https://api.relesio.com`  |
+| `RELESIO_ORG_ID`   | Override active organization            | —                          |
+| `DEBUG`            | Enable debug output                     | —                          |
+
+### Organization Context
+
+Order of precedence:
+
+1. `--org <org-id>` flag
+2. `RELESIO_ORG_ID` environment variable
+3. Active organization from session
+
+### Output Options
+
+- `--json` — Output as JSON (machine-readable)
+- `--no-color` — Disable colored output
+
+## Project & Version Inference
+
+The CLI infers values from `package.json` when possible:
+
+- **Project slug** — from `name` (slugified: lowercase, hyphens)
+- **Version** — from `version` (semver)
+
+Example: `package.json` with `"name": "@myorg/my-app"` and `"version": "1.0.0"` allows:
+
+```bash
+relesio upload ./dist
+relesio deploy --env staging
+```
+
+## File Structure
+
+```
+api/apps/cli/
+├── bin/relesio.js      # Entry shim
+├── src/
+│   ├── index.ts        # CLI root
+│   ├── commands/       # Command implementations
+│   └── lib/            # API client, config, utilities
+└── dist/               # Compiled output
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+
+# Build
+bun run build
+
+# Type check
+bun run type-check
+
+# Lint & format
+bun run lint
+bun run format
+```
+
+## Exit Codes
+
+| Code | Meaning           |
+| ---- | ----------------- |
+| 0    | Success           |
+| 1    | General error     |
+
+## Links
+
+- [Relesio](https://relesio.io)
+- [GitHub](https://github.com/relesio/relesio)
+- [Issues](https://github.com/relesio/relesio/issues)
+
+## License
+
+MIT

package/bin/relesio.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// This is a shim that loads the actual CLI from dist
+import("../dist/index.js");

package/dist/commands/auth/index.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const authCommand: Command;

package/dist/commands/auth/index.js

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { loginCommand } from "./login.js";
+import { logoutCommand } from "./logout.js";
+import { statusCommand } from "./status.js";
+export const authCommand = new Command("auth")
+    .description("Authentication commands")
+    .addCommand(loginCommand)
+    .addCommand(logoutCommand)
+    .addCommand(statusCommand);

package/dist/commands/auth/login.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const loginCommand: Command;

package/dist/commands/auth/login.js

@@ -0,0 +1,82 @@
+import { Command } from "commander";
+import inquirer from "inquirer";
+import ora from "ora";
+import chalk from "chalk";
+import { ConfigManager } from "../../lib/config/manager.js";
+import { RelesioAPIClient } from "../../lib/api/client.js";
+export const loginCommand = new Command("login")
+    .description("Authenticate with API token")
+    .option("-t, --token <token>", "API token (or use RELESIO_API_TOKEN env var)")
+    .action(async (options) => {
+    let token = options.token || process.env.RELESIO_API_TOKEN;
+    // If no token provided, prompt it
+    if (!token) {
+        const answers = await inquirer.prompt([
+            {
+                type: "password",
+                name: "token",
+                message: "Enter your API token:",
+                mask: "*",
+                validate: (input) => {
+                    if (!input || input.length === 0) {
+                        return "Token is required";
+                    }
+                    return true;
+                }
+            }
+        ]);
+        token = answers.token;
+    }
+    // Test token by making API call
+    const spinner = ora("Validating token...").start();
+    try {
+        const config = ConfigManager.load();
+        if (process.env.DEBUG) {
+            console.error(`\n[DEBUG] Login attempt:`);
+            console.error(`  API Base URL: ${config.apiBaseUrl}`);
+            console.error(`  Token (first 20 chars): ${token.substring(0, 20)}...`);
+        }
+        // Create a temporary client without auth to call /v1/api-token/me
+        const tempClient = new RelesioAPIClient(config.apiBaseUrl);
+        if (process.env.DEBUG) {
+            console.error(`\n[DEBUG] Calling /v1/api-token/me API...`);
+        }
+        // Validate API key and get full user context
+        const response = await tempClient.get("/v1/api-token/me", {
+            headers: { "x-api-key": token },
+            raw: true
+        });
+        if (process.env.DEBUG) {
+            console.error(`\n[DEBUG] /v1/api-token/me response:`, JSON.stringify(response, null, 2));
+        }
+        // Save token and user info
+        ConfigManager.save({
+            apiToken: token,
+            userId: response.data.userId,
+            userEmail: response.data.email,
+            userName: response.data.name,
+            activeOrganizationId: response.data.activeOrganizationId,
+            activeOrganizationName: response.data.activeOrganizationName,
+            activeOrganizationSlug: response.data.activeOrganizationSlug,
+            // Legacy fields for backward compatibility
+            currentOrgId: response.data.activeOrganizationId,
+            currentOrgName: response.data.activeOrganizationName
+        });
+        spinner.succeed("Authentication successful!");
+        console.log(chalk.green("✓"), `Authenticated as ${response.data.email}`);
+        if (response.data.activeOrganizationId) {
+            console.log(chalk.green("✓"), `Active organization: ${response.data.activeOrganizationName} (${response.data.activeOrganizationSlug})`);
+        }
+        else {
+            console.log(chalk.yellow("⚠"), "No active organization set. Use 'relesio organizations set <org-id>' to set one.");
+        }
+        if (response.data.organizations.length > 1) {
+            console.log(chalk.blue("ℹ"), `You belong to ${response.data.organizations.length} organizations. Use --org flag to override context.`);
+        }
+        console.log(chalk.dim("\nTip: Use 'relesio auth status' to view your authentication details"));
+    }
+    catch (error) {
+        spinner.fail("Authentication failed");
+        throw error;
+    }
+});

package/dist/commands/auth/logout.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const logoutCommand: Command;

package/dist/commands/auth/logout.js

@@ -0,0 +1,25 @@
+import { Command } from "commander";
+import inquirer from "inquirer";
+import { ConfigManager } from "../../lib/config/manager.js";
+import { formatSuccess } from "../../lib/output/colors.js";
+export const logoutCommand = new Command("logout")
+    .description("Clear authentication credentials")
+    .option("-f, --force", "Skip confirmation")
+    .action(async (options) => {
+    if (!options.force) {
+        const { confirm } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "confirm",
+                message: "Are you sure you want to logout?",
+                default: false
+            }
+        ]);
+        if (!confirm) {
+            console.log("Logout cancelled");
+            return;
+        }
+    }
+    ConfigManager.clear();
+    console.log(formatSuccess("Logged out successfully"));
+});

package/dist/commands/auth/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const statusCommand: Command;

package/dist/commands/auth/status.js

@@ -0,0 +1,35 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { ConfigManager } from "../../lib/config/manager.js";
+import { handleError } from "../../lib/errors/handler.js";
+export const statusCommand = new Command("status")
+    .description("Show current authentication status")
+    .action(async () => {
+    try {
+        const config = ConfigManager.load();
+        if (!config.apiToken) {
+            console.log(chalk.red("✗"), "Not authenticated");
+            console.log(chalk.dim("Run 'relesio auth login' to authenticate"));
+            process.exit(1);
+        }
+        console.log(chalk.green("✓"), "Authenticated");
+        console.log(chalk.dim("User:"), config.userEmail || config.userId);
+        if (config.userName) {
+            console.log(chalk.dim("Name:"), config.userName);
+        }
+        if (config.activeOrganizationId) {
+            console.log(chalk.dim("Active Organization:"), `${config.activeOrganizationName} (${config.activeOrganizationSlug})`);
+        }
+        else {
+            console.log(chalk.yellow("⚠"), "No active organization set");
+        }
+        console.log(chalk.dim("API URL:"), config.apiBaseUrl);
+        // Check env var overrides
+        if (process.env.RELESIO_ORG_ID) {
+            console.log(chalk.blue("ℹ"), `Organization override: ${process.env.RELESIO_ORG_ID} (from RELESIO_ORG_ID env var)`);
+        }
+    }
+    catch (error) {
+        handleError(error);
+    }
+});

package/dist/commands/deploy.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const deployCommand: Command;