@prisma-next/cli 0.5.0-dev.4 → 0.5.0-dev.5

package/dist/terminal-ui-C5k88MmW.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-ui-C5k88MmW.mjs","names":["graceTimer: ReturnType<typeof setTimeout> | undefined","shutdownSignal: AbortSignal","noop: clack.SpinnerResult","inner: clack.SpinnerResult | undefined","timer: ReturnType<typeof setTimeout> | undefined","pendingMsg: string | undefined"],"sources":["../src/utils/shutdown.ts","../src/utils/terminal-ui.ts"],"sourcesContent":["/**\n * Global shutdown controller for graceful SIGINT/SIGTERM handling.\n *\n * The CLI installs signal handlers once at startup. When a signal fires:\n * 1. The AbortController is aborted — in-flight async work (DB queries, emit) can check `signal.aborted`.\n * 2. A 3-second grace timer starts — gives `finally` blocks time to close connections.\n * 3. If the process hasn't exited by then, force-exit with code 130 (128 + SIGINT).\n * 4. A second signal during the grace period force-exits immediately.\n */\n\n/**\n * Creates a shutdown handler with its own AbortController.\n * Exposed for testing — production code uses the singleton below.\n */\nexport interface ShutdownHandler {\n  readonly signal: AbortSignal;\n  readonly isShuttingDown: () => boolean;\n  readonly onSignal: () => void;\n  readonly clearGraceTimer: () => void;\n}\n\nexport function createShutdownHandler(options?: {\n  readonly exit?: (code: number) => void;\n  readonly gracePeriodMs?: number;\n}): ShutdownHandler {\n  const exit = options?.exit ?? ((code: number) => process.exit(code));\n  const gracePeriodMs = options?.gracePeriodMs ?? 3000;\n\n  const controller = new AbortController();\n  let shuttingDown = false;\n  let graceTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const onSignal = () => {\n    if (shuttingDown) {\n      // Second signal — force exit\n      exit(130);\n      return;\n    }\n    shuttingDown = true;\n    controller.abort();\n\n    // Give finally blocks time to clean up, then force-exit\n    graceTimer = setTimeout(() => exit(130), gracePeriodMs);\n    graceTimer.unref();\n  };\n\n  return {\n    signal: controller.signal,\n    isShuttingDown: () => shuttingDown,\n    onSignal,\n    clearGraceTimer: () => {\n      if (graceTimer !== undefined) {\n        clearTimeout(graceTimer);\n        graceTimer = undefined;\n      }\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Singleton for production use\n// ---------------------------------------------------------------------------\n\nconst globalHandler = createShutdownHandler();\n\n/**\n * The global AbortSignal. Pass this to any async operation that should\n * be cancellable on Ctrl+C (e.g., DB queries, long-running emit).\n */\nexport const shutdownSignal: AbortSignal = globalHandler.signal;\n\n/**\n * Whether a shutdown has been initiated.\n */\nexport function isShuttingDown(): boolean {\n  return globalHandler.isShuttingDown();\n}\n\n/**\n * Installs SIGINT and SIGTERM handlers. Call once at CLI startup.\n *\n * - First signal: aborts the controller, starts a 3s grace timer.\n * - Second signal: force-exits immediately.\n */\nlet installed = false;\n\nexport function installShutdownHandlers(): void {\n  if (installed) return;\n  installed = true;\n  process.on('SIGINT', globalHandler.onSignal);\n  process.on('SIGTERM', globalHandler.onSignal);\n}\n","import * as clack from '@clack/prompts';\nimport { bold, cyan, dim, green, red, yellow } from 'colorette';\nimport { shutdownSignal } from './shutdown';\n\n/**\n * Composable CLI output abstraction.\n *\n * Follows the Unix convention of separating data from decoration:\n * - **stdout** — data output only (`ui.output()`). This is what scripts and pipes capture.\n * - **stderr** — all decoration (spinners, logs, notes, intro/outro). Visible in terminal, invisible in pipes.\n *\n * Rules:\n * 1. All methods except `output()` and `error()` write to stderr only in interactive mode.\n * 2. `output(data)` always writes to stdout — if a command calls it, there is data to emit.\n * 3. `error()` always writes to stderr — errors matter even when piped.\n * 4. All other decoration is suppressed when piped — `isInteractive` gates every other decoration method.\n * 5. Never write data to stderr — decoration methods are for human context only.\n * 6. Never write decoration to stdout — it breaks pipes, `$(...)` captures, and `> file` redirects.\n */\nexport class TerminalUI {\n  /**\n   * True when stdout is a TTY (interactive terminal).\n   * False when piped (e.g., `prisma-next db verify | jq`).\n   */\n  readonly isInteractive: boolean;\n\n  /**\n   * Whether color output is enabled.\n   */\n  readonly useColor: boolean;\n\n  private static readonly stderrOpts = { output: process.stderr } as const;\n\n  constructor(options?: {\n    readonly color?: boolean | undefined;\n    readonly interactive?: boolean | undefined;\n  }) {\n    // --interactive/--no-interactive override TTY detection\n    this.isInteractive = options?.interactive ?? !!process.stdout.isTTY;\n    this.useColor = options?.color ?? this.isInteractive;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Decoration → stderr (only in interactive mode)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Log a message line to stderr. No-op when piped.\n   */\n  log(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.message(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a success message to stderr. No-op when piped.\n   */\n  success(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.success(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a warning message to stderr. No-op when piped.\n   */\n  warn(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.warn(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log an error message to stderr. Always writes (errors matter even in pipes).\n   */\n  error(message: string): void {\n    clack.log.error(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log an info message to stderr. No-op when piped.\n   */\n  info(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.info(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Log a step message to stderr. No-op when piped.\n   */\n  step(message: string): void {\n    if (!this.isInteractive) return;\n    clack.log.step(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display a note box on stderr. No-op when piped.\n   */\n  note(message: string, title?: string): void {\n    if (!this.isInteractive) return;\n    clack.note(message, title, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display intro banner on stderr. No-op when piped.\n   */\n  intro(title?: string): void {\n    if (!this.isInteractive) return;\n    clack.intro(title, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Display outro banner on stderr. No-op when piped.\n   */\n  outro(message?: string): void {\n    if (!this.isInteractive) return;\n    clack.outro(message, TerminalUI.stderrOpts);\n  }\n\n  /**\n   * Create a Clack spinner on stderr with a 100ms delay threshold.\n   * The spinner only appears if the operation takes longer than the threshold,\n   * avoiding flicker for fast operations. Returns a no-op spinner when not interactive.\n   */\n  spinner(delayMs = 100): clack.SpinnerResult {\n    const noop: clack.SpinnerResult = {\n      start: () => {},\n      stop: () => {},\n      cancel: () => {},\n      error: () => {},\n      message: () => {},\n      clear: () => {},\n      get isCancelled() {\n        return false;\n      },\n    };\n\n    if (!this.isInteractive) {\n      return noop;\n    }\n\n    // Wrap the real spinner with a delay: only show it after `delayMs`\n    let inner: clack.SpinnerResult | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let pendingMsg: string | undefined;\n    let settled = false;\n\n    const ensureCleared = () => {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n    };\n\n    // Cancel the spinner if a shutdown signal fires\n    const onAbort = () => {\n      if (!settled) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.cancel('Interrupted');\n        }\n      }\n    };\n    if (!shutdownSignal.aborted) {\n      shutdownSignal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    return {\n      start(msg?: string) {\n        pendingMsg = msg;\n        timer = setTimeout(() => {\n          if (!settled) {\n            inner = clack.spinner(TerminalUI.stderrOpts);\n            inner.start(pendingMsg);\n          }\n        }, delayMs);\n      },\n      stop(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.stop(msg);\n        }\n      },\n      cancel(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.cancel(msg);\n        }\n      },\n      error(msg?: string) {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.error(msg);\n        }\n      },\n      message(msg?: string) {\n        pendingMsg = msg;\n        if (inner) {\n          inner.message(msg);\n        }\n      },\n      clear() {\n        settled = true;\n        ensureCleared();\n        if (inner) {\n          inner.clear();\n        }\n      },\n      get isCancelled() {\n        return inner?.isCancelled ?? false;\n      },\n    };\n  }\n\n  /**\n   * Prompt for yes/no confirmation on stderr. Returns true if confirmed.\n   * In non-interactive mode or when cancelled (Ctrl-C), returns false.\n   */\n  async confirm(message: string): Promise<boolean> {\n    if (!this.isInteractive) return false;\n    const result = await clack.confirm({\n      message,\n      ...TerminalUI.stderrOpts,\n    });\n    if (clack.isCancel(result)) return false;\n    return result;\n  }\n\n  /**\n   * Write a raw line to stderr. No-op when piped.\n   * Use for decoration that doesn't fit Clack's log format (e.g. styled headers).\n   */\n  stderr(message: string): void {\n    if (!this.isInteractive) return;\n    process.stderr.write(`${message}\\n`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Data → stdout (only when piped)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Write machine-readable data to stdout.\n   * Always writes — if a command calls output(), there is data to emit.\n   *\n   * This is what scripts and pipes capture: `prisma-next db verify --json | jq .ok`\n   */\n  output(data: string): void {\n    process.stdout.write(`${data}\\n`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Color helpers\n  // ---------------------------------------------------------------------------\n\n  green(text: string): string {\n    return this.useColor ? green(text) : text;\n  }\n  red(text: string): string {\n    return this.useColor ? red(text) : text;\n  }\n  cyan(text: string): string {\n    return this.useColor ? cyan(text) : text;\n  }\n  dim(text: string): string {\n    return this.useColor ? dim(text) : text;\n  }\n  bold(text: string): string {\n    return this.useColor ? bold(text) : text;\n  }\n  yellow(text: string): string {\n    return this.useColor ? yellow(text) : text;\n  }\n}\n"],"mappings":"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"}