koguma 0.6.6 → 2.0.0

package/cli/log.ts

@@ -0,0 +1,49 @@
+/**
+ * cli/log.ts — ANSI-colored logging helpers for CLI output.
+ *
+ * Used for non-interactive output (dev server runtime, file watcher logs).
+ * Interactive prompts use @clack/prompts via cli/ui.ts instead.
+ */
+
+// ── ANSI escape codes ──────────────────────────────────────────────
+// Brand colors:
+//   Teal:    #2dd4bf → RGB(45,212,191)   primary/success
+//   Red:     #ff4d4d → RGB(255,77,77)    error/accent
+//   Text:    #0f172a → RGB(15,23,42)     dark slate
+
+export const ANSI = {
+  BOLD: '\x1b[1m',
+  DIM: '\x1b[2m',
+  GREEN: '\x1b[32m',
+  YELLOW: '\x1b[33m',
+  RED: '\x1b[31m',
+  CYAN: '\x1b[36m',
+  RESET: '\x1b[0m',
+  // Brand colors (24-bit truecolor)
+  BRAND_TEAL: '\x1b[38;2;45;212;191m',
+  BRAND_RED: '\x1b[38;2;255;77;77m',
+  BRAND_TEXT: '\x1b[38;2;15;23;42m',
+  BRAND_DIM: '\x1b[38;2;113;124;149m'
+} as const;
+
+// ── Logging functions ──────────────────────────────────────────────
+
+export function log(msg: string): void {
+  console.log(`  ${msg}`);
+}
+
+export function ok(msg: string): void {
+  console.log(`  ${ANSI.BRAND_TEAL}✓${ANSI.RESET} ${msg}`);
+}
+
+export function warn(msg: string): void {
+  console.log(`  ${ANSI.YELLOW}⚠${ANSI.RESET} ${msg}`);
+}
+
+export function fail(msg: string): void {
+  console.error(`  ${ANSI.BRAND_RED}✗${ANSI.RESET} ${msg}`);
+}
+
+export function header(msg: string): void {
+  console.log(`\n${ANSI.BOLD}${ANSI.BRAND_TEAL}🐻 ${msg}${ANSI.RESET}\n`);
+}

package/cli/preflight.ts

@@ -0,0 +1,105 @@
+/**
+ * cli/preflight.ts — Composable preflight checks for CLI commands.
+ *
+ * Each command declares its requirements upfront. All checks produce
+ * clear, actionable error messages so users never see cryptic failures.
+ *
+ * Usage:
+ *   preflight(root, { needsAuth: true, needsSecret: true, needsConfig: true });
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import { fail, warn, log, ANSI } from './log.ts';
+import { CONFIG_FILE, SITE_CONFIG_FILE, KOGUMA_DIR } from './constants.ts';
+import { runCapture } from './exec.ts';
+
+export interface PreflightOptions {
+  /** Command needs wrangler login (remote D1/R2 operations) */
+  needsAuth?: boolean;
+  /** Command needs KOGUMA_SECRET in .dev.vars (remote API auth) */
+  needsSecret?: boolean;
+  /** Command needs site.config.ts (typegen, content sync) */
+  needsSiteConfig?: boolean;
+}
+
+/**
+ * Run all applicable preflight checks for a command.
+ * Exits with actionable errors on failure.
+ */
+export function preflight(root: string, opts: PreflightOptions = {}): void {
+  // koguma.toml is always required (except init which handles this itself)
+  requireKogumaToml(root);
+
+  if (opts.needsSiteConfig) {
+    requireSiteConfig(root);
+  }
+
+  if (opts.needsAuth) {
+    requireWranglerAuth(root);
+  }
+
+  if (opts.needsSecret) {
+    requireDevVarsSecret(root);
+  }
+}
+
+// ── Individual checks ──────────────────────────────────────────────
+
+function requireKogumaToml(root: string): void {
+  if (!existsSync(resolve(root, CONFIG_FILE))) {
+    fail(
+      `${CONFIG_FILE} not found in ${root}\n` +
+        `  Run ${ANSI.CYAN}koguma init${ANSI.RESET} to set up your project.`
+    );
+    process.exit(1);
+  }
+}
+
+function requireSiteConfig(root: string): void {
+  if (!existsSync(resolve(root, SITE_CONFIG_FILE))) {
+    fail(
+      `${SITE_CONFIG_FILE} not found in project root.\n` +
+        `  This file defines your content types. Run ${ANSI.CYAN}koguma init${ANSI.RESET} to scaffold one.`
+    );
+    process.exit(1);
+  }
+}
+
+function requireWranglerAuth(root: string): void {
+  try {
+    runCapture('bunx wrangler whoami', root);
+  } catch {
+    fail(
+      `Not logged in to Cloudflare.\n` +
+        `  Run ${ANSI.CYAN}bunx wrangler login${ANSI.RESET} first, ` +
+        `or ${ANSI.CYAN}koguma init${ANSI.RESET} which handles login for you.`
+    );
+    process.exit(1);
+  }
+}
+
+function requireDevVarsSecret(root: string): void {
+  // Check both .koguma/.dev.vars (generated) and project-root .dev.vars (legacy/manual)
+  const generatedPath = resolve(root, KOGUMA_DIR, '.dev.vars');
+  const legacyPath = resolve(root, '.dev.vars');
+  const devVarsPath = existsSync(generatedPath) ? generatedPath : legacyPath;
+
+  if (!existsSync(devVarsPath)) {
+    fail(
+      `KOGUMA_SECRET not configured — needed for admin authentication.\n` +
+        `  Run ${ANSI.CYAN}koguma dev${ANSI.RESET} once to auto-generate it, or create manually:\n` +
+        `  ${ANSI.DIM}echo 'KOGUMA_SECRET=your-password' > ${KOGUMA_DIR}/.dev.vars${ANSI.RESET}`
+    );
+    process.exit(1);
+  }
+
+  const content = readFileSync(devVarsPath, 'utf-8');
+  if (!content.match(/KOGUMA_SECRET=(.+)/)) {
+    fail(
+      `KOGUMA_SECRET not found in ${devVarsPath}.\n` +
+        `  Add it: ${ANSI.DIM}echo 'KOGUMA_SECRET=your-password' >> ${devVarsPath}${ANSI.RESET}`
+    );
+    process.exit(1);
+  }
+}