@chat-js/cli 0.1.1 → 0.1.2

package/README.md

@@ -5,11 +5,15 @@ CLI to scaffold and extend ChatJS apps.
 ## Usage
 
 ```bash
-npx @chat-js/cli@latest create my-app
+npx @chat-js/cli@latest
 ```
 
-After install, the binary is available as `chat-js`:
+Or with the command alias:
 
 ```bash
-chat-js create my-app
+npx @chat-js/cli@latest create
 ```
+
+After install, the binary is:
+
+- `chat-js`

package/dist/index.js

@@ -3914,17 +3914,17 @@ var {
 // package.json
 var package_default = {
   name: "@chat-js/cli",
-  version: "0.1.1",
+  version: "0.1.2",
   description: "CLI for creating and extending ChatJS apps",
   license: "Apache-2.0",
   repository: {
     type: "git",
-    url: "https://github.com/FranciscoMoretti/chatjs.git",
+    url: "https://github.com/franciscomoretti/chat.js.git",
     directory: "packages/cli"
   },
-  homepage: "https://github.com/FranciscoMoretti/chatjs/tree/main/packages/cli",
+  homepage: "https://github.com/franciscomoretti/chat.js/tree/main/packages/cli",
   bugs: {
-    url: "https://github.com/FranciscoMoretti/chatjs/issues"
+    url: "https://github.com/franciscomoretti/chat.js/issues"
   },
   keywords: [
     "chatjs",
@@ -18727,6 +18727,37 @@ var authEnvRequirements = {
   }
 };
 
+// ../../apps/chat/lib/env-schema.ts
+var serverEnvSchema = {
+  DATABASE_URL: exports_external.string().min(1).describe("Postgres connection string"),
+  AUTH_SECRET: exports_external.string().min(1).describe("NextAuth.js secret for signing session tokens"),
+  BLOB_READ_WRITE_TOKEN: exports_external.string().optional().describe("Vercel Blob storage token for file uploads"),
+  AUTH_GOOGLE_ID: exports_external.string().optional().describe("Google OAuth client ID"),
+  AUTH_GOOGLE_SECRET: exports_external.string().optional().describe("Google OAuth client secret"),
+  AUTH_GITHUB_ID: exports_external.string().optional().describe("GitHub OAuth app client ID"),
+  AUTH_GITHUB_SECRET: exports_external.string().optional().describe("GitHub OAuth app client secret"),
+  VERCEL_APP_CLIENT_ID: exports_external.string().optional().describe("Vercel OAuth integration client ID"),
+  VERCEL_APP_CLIENT_SECRET: exports_external.string().optional().describe("Vercel OAuth integration client secret"),
+  AI_GATEWAY_API_KEY: exports_external.string().optional().describe("Vercel AI Gateway API key"),
+  VERCEL_OIDC_TOKEN: exports_external.string().optional().describe("Vercel OIDC token (auto-set on Vercel deployments)"),
+  OPENROUTER_API_KEY: exports_external.string().optional().describe("OpenRouter API key"),
+  OPENAI_COMPATIBLE_BASE_URL: exports_external.string().url().optional().describe("Base URL for OpenAI-compatible provider"),
+  OPENAI_COMPATIBLE_API_KEY: exports_external.string().optional().describe("API key for OpenAI-compatible provider"),
+  OPENAI_API_KEY: exports_external.string().optional().describe("OpenAI API key"),
+  CRON_SECRET: exports_external.string().optional().describe("Secret for cleanup cron job endpoint"),
+  REDIS_URL: exports_external.string().optional().describe("Redis URL for resumable streams"),
+  TAVILY_API_KEY: exports_external.string().optional().describe("Tavily API key for web search"),
+  EXA_API_KEY: exports_external.string().optional().describe("Exa API key for web search"),
+  FIRECRAWL_API_KEY: exports_external.string().optional().describe("Firecrawl API key for web search and URL retrieval"),
+  MCP_ENCRYPTION_KEY: exports_external.union([exports_external.string().length(44), exports_external.literal("")]).optional().describe("Encryption key for MCP server credentials (base64, 44 chars)"),
+  VERCEL_TEAM_ID: exports_external.string().optional().describe("Vercel team ID for sandbox (non-Vercel deployments)"),
+  VERCEL_PROJECT_ID: exports_external.string().optional().describe("Vercel project ID for sandbox (non-Vercel deployments)"),
+  VERCEL_TOKEN: exports_external.string().optional().describe("Vercel API token for sandbox (non-Vercel deployments)"),
+  VERCEL_SANDBOX_RUNTIME: exports_external.string().optional().describe("Vercel sandbox runtime identifier"),
+  APP_URL: exports_external.url().optional().describe("App URL for non-Vercel deployments (full URL including https://)"),
+  VERCEL_URL: exports_external.string().optional().describe("Auto-set by Vercel platform")
+};
+
 // src/types.ts
 var FEATURE_KEYS = [
   "sandbox",
@@ -18740,23 +18771,66 @@ var FEATURE_KEYS = [
 ];
 
 // src/helpers/env-checklist.ts
+function extractEnvDescriptions() {
+  const result = new Map;
+  for (const [key, schema] of Object.entries(serverEnvSchema)) {
+    const desc = schema.description;
+    if (desc) {
+      result.set(key, desc);
+    }
+  }
+  return result;
+}
+var envDescriptions = extractEnvDescriptions();
+function requirementToEntries(requirement) {
+  const oneOfGroup = requirement.options.length > 1 ? requirement.options.map((group) => group.map(String).join("+")).join("|") : undefined;
+  return requirement.options.map((group) => {
+    const description = group.map((v) => {
+      const varName = String(v);
+      return envDescriptions.get(varName) ?? varName;
+    }).join(", ");
+    return {
+      vars: group.map(String).join(" + "),
+      description: description || requirement.description,
+      oneOfGroup
+    };
+  });
+}
 function collectEnvChecklist(input) {
-  const requirements = new Set;
-  requirements.add(gatewayEnvRequirements[input.gateway].description);
+  const entries = [];
+  entries.push({
+    vars: "AUTH_SECRET",
+    description: envDescriptions.get("AUTH_SECRET") ?? "AUTH_SECRET"
+  });
+  entries.push({
+    vars: "DATABASE_URL",
+    description: envDescriptions.get("DATABASE_URL") ?? "DATABASE_URL"
+  });
+  const gwReq = gatewayEnvRequirements[input.gateway];
+  const gwEntries = requirementToEntries(gwReq);
+  entries.push(...gwEntries);
+  const featureItems = [];
+  const seen = new Set;
   for (const feature of FEATURE_KEYS) {
     if (!input.features[feature])
       continue;
     const requirement = featureEnvRequirements[feature];
-    if (requirement) {
-      requirements.add(requirement.description);
-    }
+    if (!requirement)
+      continue;
+    if (seen.has(requirement.description))
+      continue;
+    seen.add(requirement.description);
+    featureItems.push(...requirementToEntries(requirement));
   }
+  entries.push(...featureItems);
+  const authItems = [];
   for (const provider of Object.keys(authEnvRequirements)) {
     if (!input.auth[provider])
       continue;
-    requirements.add(authEnvRequirements[provider].description);
+    authItems.push(...requirementToEntries(authEnvRequirements[provider]));
   }
-  return [...requirements].sort();
+  entries.push(...authItems);
+  return entries;
 }
 
 // ../../apps/chat/lib/ai/gateway-model-defaults.ts
@@ -18994,7 +19068,6 @@ var authenticationConfigSchema = exports_external.object({
   vercel: false
 });
 var configSchema = exports_external.object({
-  githubUrl: exports_external.url().default("https://github.com/your-username/your-repo"),
   appPrefix: exports_external.string().default("chatjs"),
   appName: exports_external.string().default("My AI Chat"),
   appTitle: exports_external.string().optional().describe("Browser tab title (defaults to appName)"),
@@ -19124,7 +19197,6 @@ ${spaces}},`;
 function buildConfigTs(input) {
   const modelDefaults = GATEWAY_MODEL_DEFAULTS[input.gateway];
   const fullConfig = {
-    githubUrl: input.githubUrl,
     appPrefix: input.appPrefix,
     appName: input.appName,
     appDescription: "AI chat powered by ChatJS",
@@ -19266,42 +19338,6 @@ async function promptProjectName(targetArg, skipPrompt) {
   handleCancel(name);
   return toKebabCase(name) || "my-chat-app";
 }
-async function promptAppDetails(skipPrompt) {
-  if (skipPrompt) {
-    return {
-      appName: "My Chat App",
-      appPrefix: "chat",
-      appUrl: "http://localhost:3000",
-      githubUrl: "https://github.com/your-org/your-repo"
-    };
-  }
-  const appName = await Ze({
-    message: `What is the ${highlighter.info("display name")} of your app?`,
-    initialValue: "My Chat App"
-  });
-  handleCancel(appName);
-  const appPrefix = await Ze({
-    message: `What ${highlighter.info("prefix")} should be used?`,
-    initialValue: toKebabCase(appName) || "chat"
-  });
-  handleCancel(appPrefix);
-  const appUrl = await Ze({
-    message: `What is your ${highlighter.info("app URL")}?`,
-    initialValue: "http://localhost:3000"
-  });
-  handleCancel(appUrl);
-  const githubUrl = await Ze({
-    message: `What is your ${highlighter.info("GitHub repository URL")}?`,
-    initialValue: "https://github.com/your-org/your-repo"
-  });
-  handleCancel(githubUrl);
-  return {
-    appName: appName || "My Chat App",
-    appPrefix: appPrefix || "chat",
-    appUrl: appUrl || "http://localhost:3000",
-    githubUrl: githubUrl || "https://github.com/your-org/your-repo"
-  };
-}
 async function promptGateway(skipPrompt) {
   if (skipPrompt)
     return "vercel";
@@ -20751,6 +20787,24 @@ function spinner(text, options) {
 }
 
 // src/commands/create.ts
+function printEnvChecklist(entries) {
+  logger.info("Required for your configuration:");
+  logger.break();
+  for (let i = 0;i < entries.length; i += 1) {
+    const entry = entries[i];
+    if (!entry.oneOfGroup) {
+      logger.log(`  ${highlighter.warn("*")} ${highlighter.warn(entry.vars)} ${highlighter.dim(`- ${entry.description}`)}`);
+      continue;
+    }
+    logger.log(`  ${highlighter.warn("*")} ${highlighter.dim("One of:")}`);
+    while (i < entries.length && entries[i].oneOfGroup === entry.oneOfGroup) {
+      const option = entries[i];
+      logger.log(`    ${highlighter.warn("*")} ${highlighter.warn(option.vars)} ${highlighter.dim(`- ${option.description}`)}`);
+      i += 1;
+    }
+    i -= 1;
+  }
+}
 var createOptionsSchema = exports_external.object({
   target: exports_external.string().optional(),
   yes: exports_external.boolean(),
@@ -20769,11 +20823,13 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
     }
     const projectName = await promptProjectName(options.target, options.yes);
     const targetDir = resolve2(process.cwd(), projectName);
-    const { appName, appPrefix, appUrl, githubUrl } = await promptAppDetails(options.yes);
+    await ensureTargetEmpty(targetDir);
+    const appName = projectName.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+    const appPrefix = projectName;
+    const appUrl = "http://localhost:3000";
     const gateway = await promptGateway(options.yes);
     const features = await promptFeatures(options.yes);
     const auth = await promptAuth(options.yes);
-    await ensureTargetEmpty(targetDir);
     logger.break();
     const scaffoldSpinner = spinner("Scaffolding project...").start();
     try {
@@ -20798,7 +20854,6 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
         appName,
         appPrefix,
         appUrl,
-        githubUrl,
         gateway,
         features,
         auth
@@ -20820,19 +20875,14 @@ var create = new Command().name("create").description("scaffold a new ChatJS cha
         throw error48;
       }
     }
-    const envChecklist = collectEnvChecklist({ gateway, features, auth });
+    const envEntries = collectEnvChecklist({ gateway, features, auth });
     Le("Your ChatJS app is ready!");
     logger.info("Next steps:");
     logger.log(`  cd ${highlighter.info(projectName)}`);
+    logger.log(`  Copy ${highlighter.info(".env.example")} to ${highlighter.info(".env.local")} and fill in the values below`);
     logger.log(`  ${highlighter.info(`${packageManager} run dev`)}`);
     logger.break();
-    if (envChecklist.length > 0) {
-      logger.info("Required environment variables:");
-      for (const item of envChecklist) {
-        logger.log(`  ${highlighter.warn("*")} ${item}`);
-      }
-      logger.break();
-    }
+    printEnvChecklist(envEntries);
   } catch (error48) {
     handleError(error48);
   }

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@chat-js/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CLI for creating and extending ChatJS apps",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/FranciscoMoretti/chatjs.git",
+    "url": "https://github.com/franciscomoretti/chat.js.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/FranciscoMoretti/chatjs/tree/main/packages/cli",
+  "homepage": "https://github.com/franciscomoretti/chat.js/tree/main/packages/cli",
   "bugs": {
-    "url": "https://github.com/FranciscoMoretti/chatjs/issues"
+    "url": "https://github.com/franciscomoretti/chat.js/issues"
   },
   "keywords": [
     "chatjs",