@onexapis/cli 1.1.8 → 1.1.10

package/README.md

@@ -19,28 +19,26 @@ Requires Node.js >= 18.
 ## Quick Start
 
 ```bash
-# Create a new theme project
-onex init my-theme
-
-# List all themes, sections, blocks, and components
-onex list
-
-# Create a section in a theme
-onex create:section hero --theme simple
+# 1. Configure credentials (one-time setup)
+onex config
 
-# Validate theme structure
-onex validate --theme simple
-
-# Build a theme
-onex build --theme simple
-
-# Upload to S3
-onex upload --theme simple
+# 2. Create a new theme project
+onex init my-theme
 
-# Clone a theme from S3
+# Or clone an existing theme
 onex clone simple
 ```
 
+```bash
+# Other useful commands
+onex list                              # List themes, sections, blocks
+onex create:section hero --theme simple  # Scaffold a section
+onex validate --theme simple           # Validate theme structure
+onex build --theme simple              # Build a theme
+onex upload --theme simple             # Upload to S3
+onex clone simple                      # Clone a theme from S3
+```
+
 ## Commands
 
 ### `onex init [project-name]`
@@ -199,54 +197,68 @@ Download a compiled theme from S3.
 
 Clone theme source code from S3.
 
-| Option                    | Description                             |
-| ------------------------- | --------------------------------------- |
-| `-v, --version <version>` | Theme version (default: `latest`)       |
-| `-o, --output <dir>`      | Output directory                        |
-| `-b, --bucket <name>`     | S3 bucket name                          |
-| `-e, --environment <env>` | Environment (`staging` or `production`) |
-| `--no-install`            | Skip running `pnpm install` after clone |
+| Option                    | Description                               |
+| ------------------------- | ----------------------------------------- |
+| `-v, --version <version>` | Theme version (default: `latest`)         |
+| `-n, --name <name>`       | New theme name (skips interactive prompt) |
+| `-o, --output <dir>`      | Output directory                          |
+| `-b, --bucket <name>`     | S3 bucket name                            |
+| `-e, --environment <env>` | Environment (`staging` or `production`)   |
+| `--no-install`            | Skip running `pnpm install` after clone   |
 
 ```bash
 onex clone simple
+onex clone simple -n my-store
 onex clone simple -v 1.0.0 -o ./my-clone --no-install
 ```
 
-## S3 Configuration
-
-The `upload`, `download`, and `clone` commands use S3 for storage. The CLI automatically loads env files in this order (first found wins):
+### `onex config`
 
-1. **Project-level**: `.env.local` and `.env` at the project root
-2. **Global**: `~/.onex/.env` (works from any directory)
-
-### Project config (recommended for teams)
+Interactive setup for CLI credentials. Saves configuration to `~/.onex/.env` so S3 commands (`clone`, `upload`, `download`) work from any directory.
 
 ```bash
-# .env.local (at project root — shared with the team via .env.example)
-BUCKET_NAME=my-bucket
-AWS_REGION=ap-southeast-1
-AWS_ACCESS_KEY_ID=your-access-key
-AWS_SECRET_ACCESS_KEY=your-secret-key
+onex config
 ```
 
-### Global config (for personal use / running outside a project)
+Prompts for:
+
+| Key                      | Description           | Required |
+| ------------------------ | --------------------- | -------- |
+| `AWS_ACCESS_KEY_ID`      | AWS Access Key ID     | Yes      |
+| `AWS_SECRET_ACCESS_KEY`  | AWS Secret Access Key | Yes      |
+| `AWS_REGION`             | AWS Region            | No       |
+| `BUCKET_NAME`            | S3 Bucket Name        | No       |
+| `NEXT_PUBLIC_API_URL`    | API URL               | No       |
+| `NEXT_PUBLIC_COMPANY_ID` | Company ID            | No       |
+
+Run this once after installing the CLI. Re-run anytime to update values.
+
+## S3 Configuration
+
+The `upload`, `download`, and `clone` commands use S3 for storage.
+
+### Recommended: use `onex config`
 
 ```bash
-# ~/.onex/.env
-BUCKET_NAME=my-bucket
-AWS_REGION=ap-southeast-1
-AWS_ACCESS_KEY_ID=your-access-key
-AWS_SECRET_ACCESS_KEY=your-secret-key
+# One-time setup — saves credentials to ~/.onex/.env
+onex config
 ```
 
-Then all S3 commands just work without extra flags:
+After running `onex config`, all S3 commands work from any directory:
 
 ```bash
+onex clone simple             # works anywhere
 onex upload --theme simple    # picks up config automatically
-onex clone simple             # works from any directory
 onex download -t simple       # same
 ```
 
+### Manual configuration
+
+The CLI loads env files in this order (first found wins):
+
+1. **Project-level**: `.env.local` and `.env` at the project root
+2. **Global**: `~/.onex/.env` (set by `onex config`, or create manually)
+
 ### Adapter Modes
 
 ```bash
@@ -315,7 +327,8 @@ packages/cli/
 │   │   ├── deploy.ts           # Deploy to API server
 │   │   ├── upload.ts           # Upload to S3
 │   │   ├── download.ts         # Download from S3
-│   │   └── clone.ts            # Clone source from S3
+│   │   ├── clone.ts            # Clone source from S3
+│   │   └── config.ts           # CLI credential setup
 │   └── utils/
 │       ├── logger.ts           # Console output utilities
 │       ├── file-helpers.ts     # File operations & project detection

package/dist/cli.js

@@ -3438,8 +3438,8 @@ function runInstall(cwd) {
   });
 }
 async function promptThemeName(originalName) {
-  const { default: inquirer5 } = await import('inquirer');
-  const { themeName } = await inquirer5.prompt([
+  const { default: inquirer6 } = await import('inquirer');
+  const { themeName } = await inquirer6.prompt([
     {
       type: "input",
       name: "themeName",
@@ -3881,6 +3881,149 @@ async function devCommand(options) {
   });
 }
 
+// src/commands/config.ts
+init_logger();
+var CONFIG_DIR = path8__default.default.join(os__default.default.homedir(), ".onex");
+var CONFIG_FILE = path8__default.default.join(CONFIG_DIR, ".env");
+var CONFIG_ENTRIES = [
+  {
+    key: "AWS_ACCESS_KEY_ID",
+    label: "AWS Access Key ID",
+    required: true
+  },
+  {
+    key: "AWS_SECRET_ACCESS_KEY",
+    label: "AWS Secret Access Key",
+    required: true,
+    secret: true
+  },
+  {
+    key: "AWS_REGION",
+    label: "AWS Region",
+    required: false,
+    defaultValue: "ap-southeast-1"
+  },
+  {
+    key: "BUCKET_NAME",
+    label: "S3 Bucket Name",
+    required: false,
+    defaultValue: "theme-s3-bucket"
+  },
+  {
+    key: "NEXT_PUBLIC_API_URL",
+    label: "API URL",
+    required: false,
+    defaultValue: "https://api-dev.onexeos.com"
+  },
+  {
+    key: "NEXT_PUBLIC_COMPANY_ID",
+    label: "Company ID",
+    required: false
+  }
+];
+function parseEnvFile(content) {
+  const result = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const value = trimmed.slice(eqIndex + 1).trim();
+    result[key] = value;
+  }
+  return result;
+}
+function serializeEnv(values) {
+  const lines = [
+    "# OneX CLI Configuration",
+    "# Generated by: onex config",
+    ""
+  ];
+  lines.push("# AWS / S3 Configuration");
+  for (const key of [
+    "AWS_ACCESS_KEY_ID",
+    "AWS_SECRET_ACCESS_KEY",
+    "AWS_REGION",
+    "BUCKET_NAME"
+  ]) {
+    if (values[key]) lines.push(`${key}=${values[key]}`);
+  }
+  lines.push("");
+  lines.push("# API Configuration");
+  for (const key of ["NEXT_PUBLIC_API_URL", "NEXT_PUBLIC_COMPANY_ID"]) {
+    if (values[key]) lines.push(`${key}=${values[key]}`);
+  }
+  const knownKeys = new Set(CONFIG_ENTRIES.map((e) => e.key));
+  const extraKeys = Object.keys(values).filter((k) => !knownKeys.has(k));
+  if (extraKeys.length > 0) {
+    lines.push("");
+    lines.push("# Other");
+    for (const key of extraKeys) {
+      lines.push(`${key}=${values[key]}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+async function configCommand() {
+  logger.header("OneX CLI Configuration");
+  let existing = {};
+  try {
+    const content = await fs__default.default.readFile(CONFIG_FILE, "utf-8");
+    existing = parseEnvFile(content);
+    logger.info(`Existing config found at: ${CONFIG_FILE}`);
+    logger.newLine();
+  } catch {
+    logger.info("No existing config found. Let's set one up.");
+    logger.newLine();
+  }
+  const answers = {};
+  for (const entry of CONFIG_ENTRIES) {
+    const currentValue = existing[entry.key] || "";
+    const defaultVal = currentValue || entry.defaultValue || "";
+    const displayDefault = entry.secret && currentValue ? currentValue.slice(0, 4) + "****" + currentValue.slice(-4) : defaultVal;
+    const { value } = await inquirer__default.default.prompt([
+      {
+        type: entry.secret ? "password" : "input",
+        name: "value",
+        message: `${entry.label}${entry.required ? " (required)" : ""}:`,
+        default: entry.secret ? void 0 : defaultVal,
+        ...entry.secret && currentValue ? {
+          suffix: ` (current: ${displayDefault}, press Enter to keep)`
+        } : {},
+        validate: (input) => {
+          if (entry.required && !input && !currentValue) {
+            return `${entry.label} is required`;
+          }
+          return true;
+        }
+      }
+    ]);
+    answers[entry.key] = value || currentValue;
+  }
+  const merged = { ...existing, ...answers };
+  for (const key of Object.keys(merged)) {
+    if (!merged[key]) delete merged[key];
+  }
+  await fs__default.default.ensureDir(CONFIG_DIR);
+  await fs__default.default.writeFile(CONFIG_FILE, serializeEnv(merged));
+  logger.newLine();
+  logger.success(`Config saved to: ${CONFIG_FILE}`);
+  logger.newLine();
+  logger.section("Configured values:");
+  for (const entry of CONFIG_ENTRIES) {
+    const val = merged[entry.key];
+    if (!val) continue;
+    const display = entry.secret ? val.slice(0, 4) + "****" + val.slice(-4) : val;
+    logger.log(`  ${entry.label}: ${display}`);
+  }
+  logger.newLine();
+  logger.info(
+    "These credentials are stored globally and used by clone, upload, and download commands."
+  );
+}
+
 // src/cli.ts
 try {
   const projectRoot = getProjectRoot();
@@ -3948,6 +4091,7 @@ program.command("clone").description("Clone theme source code from S3").argument
   "Environment (staging|production)",
   "staging"
 ).option("--no-install", "Skip running pnpm install after clone").action(cloneCommand);
+program.command("config").description("Configure OneX CLI credentials (AWS, API keys)").action(configCommand);
 program.configureOutput({
   writeErr: (str) => process.stderr.write(chalk4__default.default.red(str))
 });