dotdo 0.0.1 → 0.1.0

package/cli/src/config.ts

@@ -0,0 +1,185 @@
+/**
+ * CLI Configuration Management
+ *
+ * Manages configuration stored in ~/.dotdo/config
+ */
+
+import { readFile, writeFile, mkdir, access } from 'fs/promises'
+import { homedir } from 'os'
+import { join } from 'path'
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const CONFIG_DIR_NAME = '.dotdo'
+const CONFIG_FILE_NAME = 'config'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface Config {
+  /** Base API URL for rpc.do gateway */
+  api_url: string
+  /** Output JSON instead of human-readable format */
+  json_output: boolean
+  /** Default LLM model */
+  default_model?: string
+  /** Default sender for calls/texts */
+  default_from?: string
+  /** Default email sender */
+  default_email_from?: string
+  /** Default currency for charges */
+  default_currency?: string
+  /** Custom headers to include in all requests */
+  custom_headers?: Record<string, string>
+}
+
+/** Available config keys for validation */
+export const configKeys = [
+  'api_url',
+  'json_output',
+  'default_model',
+  'default_from',
+  'default_email_from',
+  'default_currency',
+  'custom_headers',
+] as const
+
+export type ConfigKey = (typeof configKeys)[number]
+
+// ============================================================================
+// Default Configuration
+// ============================================================================
+
+export const defaultConfig: Config = {
+  api_url: 'https://rpc.do',
+  json_output: false,
+}
+
+// ============================================================================
+// Paths
+// ============================================================================
+
+/**
+ * Get the config directory path
+ */
+function getConfigDir(): string {
+  return join(homedir(), CONFIG_DIR_NAME)
+}
+
+/**
+ * Get the config file path
+ */
+export function getConfigPath(): string {
+  return join(getConfigDir(), CONFIG_FILE_NAME)
+}
+
+// ============================================================================
+// Config Operations
+// ============================================================================
+
+/**
+ * Read stored configuration, merging with defaults
+ */
+export async function getConfig(): Promise<Config> {
+  const configPath = getConfigPath()
+
+  try {
+    const content = await readFile(configPath, 'utf-8')
+    const stored = JSON.parse(content)
+
+    // Merge stored config with defaults
+    return {
+      ...defaultConfig,
+      ...stored,
+    }
+  } catch (error: unknown) {
+    // File doesn't exist or is malformed - return defaults
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+      return { ...defaultConfig }
+    }
+    // JSON parse error - return defaults
+    return { ...defaultConfig }
+  }
+}
+
+/**
+ * Update configuration values
+ */
+export async function setConfig(updates: Partial<Config>): Promise<void> {
+  const configDir = getConfigDir()
+  const configPath = getConfigPath()
+
+  // Ensure config directory exists
+  try {
+    await access(configDir)
+  } catch {
+    await mkdir(configDir, { recursive: true, mode: 0o700 })
+  }
+
+  // Read existing config
+  let existing: Partial<Config> = {}
+  try {
+    const content = await readFile(configPath, 'utf-8')
+    existing = JSON.parse(content)
+  } catch {
+    // No existing config
+  }
+
+  // Merge and write
+  const merged = {
+    ...existing,
+    ...updates,
+  }
+
+  await writeFile(configPath, JSON.stringify(merged, null, 2), { mode: 0o600 })
+}
+
+/**
+ * Remove a configuration key
+ */
+export async function unsetConfig(key: ConfigKey): Promise<void> {
+  const config = await getConfig()
+  // Use a type-safe delete
+  const configAny = config as unknown as Record<string, unknown>
+  delete configAny[key]
+  await setConfig(config)
+}
+
+/**
+ * Validate a config key exists
+ */
+export function isValidConfigKey(key: string): key is ConfigKey {
+  return configKeys.includes(key as ConfigKey)
+}
+
+/**
+ * Parse and validate a config value by key
+ */
+export function parseConfigValue(key: ConfigKey, value: string): unknown {
+  switch (key) {
+    case 'json_output':
+      if (value === 'true') return true
+      if (value === 'false') return false
+      throw new Error(`Invalid value for ${key}: expected 'true' or 'false'`)
+
+    case 'api_url':
+    case 'default_model':
+    case 'default_from':
+    case 'default_email_from':
+    case 'default_currency':
+      return value
+
+    case 'custom_headers':
+      try {
+        return JSON.parse(value)
+      } catch {
+        throw new Error(`Invalid value for ${key}: expected valid JSON`)
+      }
+
+    default:
+      return value
+  }
+}

package/cli/src/output.ts

@@ -0,0 +1,246 @@
+/**
+ * CLI Output Formatting
+ *
+ * Provides utilities for formatting CLI output:
+ * - JSON output for scripting
+ * - Table output for lists
+ * - Streaming output for LLM responses
+ * - Spinner for long-running operations
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface OutputOptions {
+  /** Pretty print JSON */
+  pretty?: boolean
+  /** Columns to display in table */
+  columns?: string[]
+  /** Maximum width for truncation */
+  maxWidth?: number
+}
+
+export interface Spinner {
+  /** Start the spinner animation */
+  start(): void
+  /** Stop the spinner */
+  stop(): void
+  /** Stop with success message */
+  succeed(message?: string): void
+  /** Stop with failure message */
+  fail(message?: string): void
+  /** Update spinner text */
+  text(message: string): void
+}
+
+// ============================================================================
+// JSON Formatting
+// ============================================================================
+
+/**
+ * Format data as JSON string
+ */
+export function formatJson(data: unknown, options: OutputOptions = {}): string {
+  if (options.pretty) {
+    return JSON.stringify(data, null, 2)
+  }
+  return JSON.stringify(data)
+}
+
+// ============================================================================
+// Table Formatting
+// ============================================================================
+
+/**
+ * Format array of objects as ASCII table
+ */
+export function formatTable(
+  data: Record<string, unknown>[],
+  options: OutputOptions = {}
+): string {
+  if (data.length === 0) {
+    return ''
+  }
+
+  // Determine columns
+  const columns = options.columns ?? Object.keys(data[0])
+  const maxWidth = options.maxWidth ?? 50
+
+  // Calculate column widths
+  const widths: Record<string, number> = {}
+  for (const col of columns) {
+    widths[col] = col.length
+    for (const row of data) {
+      const value = String(row[col] ?? '')
+      widths[col] = Math.max(widths[col], Math.min(value.length, maxWidth))
+    }
+  }
+
+  // Format header
+  const header = columns.map((col) => col.padEnd(widths[col])).join('  ')
+  const separator = columns.map((col) => '-'.repeat(widths[col])).join('  ')
+
+  // Format rows
+  const rows = data.map((row) => {
+    return columns
+      .map((col) => {
+        const value = String(row[col] ?? '')
+        const truncated = value.length > maxWidth ? value.slice(0, maxWidth - 3) + '...' : value
+        return truncated.padEnd(widths[col])
+      })
+      .join('  ')
+  })
+
+  return [header, separator, ...rows].join('\n')
+}
+
+// ============================================================================
+// Streaming Output
+// ============================================================================
+
+/**
+ * Async iterator for streaming response
+ */
+export async function* formatStream(
+  stream: ReadableStream<Uint8Array>
+): AsyncGenerator<string, void, unknown> {
+  const reader = stream.getReader()
+  const decoder = new TextDecoder()
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read()
+      if (done) break
+      yield decoder.decode(value, { stream: true })
+    }
+  } finally {
+    // releaseLock may not exist in all environments (e.g., mocks)
+    if (typeof reader.releaseLock === 'function') {
+      reader.releaseLock()
+    }
+  }
+}
+
+/**
+ * Parse SSE stream and extract content
+ */
+export async function* parseSSEStream(
+  stream: ReadableStream<Uint8Array>
+): AsyncGenerator<string, void, unknown> {
+  let buffer = ''
+
+  for await (const chunk of formatStream(stream)) {
+    buffer += chunk
+
+    // Process complete lines
+    const lines = buffer.split('\n')
+    buffer = lines.pop() ?? '' // Keep incomplete line in buffer
+
+    for (const line of lines) {
+      if (line.startsWith('data: ')) {
+        const data = line.slice(6)
+        if (data === '[DONE]') continue
+
+        try {
+          const parsed = JSON.parse(data)
+          if (parsed.delta) {
+            yield parsed.delta
+          } else if (parsed.content) {
+            yield parsed.content
+          } else if (parsed.choices?.[0]?.delta?.content) {
+            yield parsed.choices[0].delta.content
+          }
+        } catch {
+          // Not JSON, might be raw content
+          yield data
+        }
+      }
+    }
+  }
+
+  // Process any remaining buffer
+  if (buffer.startsWith('data: ')) {
+    const data = buffer.slice(6)
+    if (data !== '[DONE]') {
+      try {
+        const parsed = JSON.parse(data)
+        if (parsed.delta) {
+          yield parsed.delta
+        }
+      } catch {
+        yield data
+      }
+    }
+  }
+}
+
+// ============================================================================
+// Spinner
+// ============================================================================
+
+const SPINNER_FRAMES = ['|', '/', '-', '\\']
+
+/**
+ * Create a CLI spinner for long-running operations
+ */
+export function createSpinner(message: string): Spinner {
+  let intervalId: ReturnType<typeof setInterval> | null = null
+  let frameIndex = 0
+  let currentMessage = message
+
+  const render = () => {
+    const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length]
+    process.stdout.write(`\r${frame} ${currentMessage}`)
+    frameIndex++
+  }
+
+  const clear = () => {
+    process.stdout.write('\r' + ' '.repeat(currentMessage.length + 3) + '\r')
+  }
+
+  return {
+    start() {
+      if (intervalId) return
+      render()
+      intervalId = setInterval(render, 100)
+    },
+
+    stop() {
+      if (intervalId) {
+        clearInterval(intervalId)
+        intervalId = null
+      }
+      clear()
+    },
+
+    succeed(msg?: string) {
+      this.stop()
+      console.log(`\u2713 ${msg ?? currentMessage}`)
+    },
+
+    fail(msg?: string) {
+      this.stop()
+      console.log(`\u2717 ${msg ?? currentMessage}`)
+    },
+
+    text(msg: string) {
+      currentMessage = msg
+    },
+  }
+}
+
+// ============================================================================
+// Color Output (if terminal supports it)
+// ============================================================================
+
+const supportsColor = process.stdout.isTTY && process.env.TERM !== 'dumb'
+
+export const colors = {
+  red: (text: string) => (supportsColor ? `\x1b[31m${text}\x1b[0m` : text),
+  green: (text: string) => (supportsColor ? `\x1b[32m${text}\x1b[0m` : text),
+  yellow: (text: string) => (supportsColor ? `\x1b[33m${text}\x1b[0m` : text),
+  blue: (text: string) => (supportsColor ? `\x1b[34m${text}\x1b[0m` : text),
+  dim: (text: string) => (supportsColor ? `\x1b[2m${text}\x1b[0m` : text),
+  bold: (text: string) => (supportsColor ? `\x1b[1m${text}\x1b[0m` : text),
+}

package/cli/src/rpc.ts

@@ -0,0 +1,192 @@
+/**
+ * CLI RPC Client
+ *
+ * Makes authenticated requests to *.do services via rpc.do gateway.
+ */
+
+import { getConfig } from './config'
+import { getAuthHeaders, AuthError } from './auth'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface RPCError {
+  error: string
+  message?: string
+  code?: string
+}
+
+export interface RPCRequestOptions {
+  /** HTTP method */
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
+  /** Request body (will be JSON stringified) */
+  body?: unknown
+  /** Additional headers */
+  headers?: Record<string, string>
+  /** Stream the response */
+  stream?: boolean
+}
+
+export class RPCNetworkError extends Error {
+  constructor(message: string) {
+    super(`Network error: ${message}`)
+    this.name = 'RPCNetworkError'
+  }
+}
+
+export class RPCAPIError extends Error {
+  status: number
+  code?: string
+
+  constructor(message: string, status: number, code?: string) {
+    super(message)
+    this.name = 'RPCAPIError'
+    this.status = status
+    this.code = code
+  }
+}
+
+export class RPCRateLimitError extends RPCAPIError {
+  retryAfter?: number
+
+  constructor(message: string, retryAfter?: number) {
+    super(message, 429, 'rate_limit_exceeded')
+    this.name = 'RPCRateLimitError'
+    this.retryAfter = retryAfter
+  }
+}
+
+// ============================================================================
+// RPC Client
+// ============================================================================
+
+/**
+ * Make an authenticated request to a *.do service
+ */
+export async function rpcRequest<T = unknown>(
+  service: string,
+  path: string,
+  options: RPCRequestOptions = {}
+): Promise<T> {
+  const config = await getConfig()
+  const authHeaders = await getAuthHeaders()
+
+  const { method = 'GET', body, headers = {}, stream = false } = options
+
+  const url = `${config.api_url}/${service}${path}`
+
+  const requestHeaders: Record<string, string> = {
+    ...authHeaders,
+    ...headers,
+  }
+
+  // Only set Content-Type if not already provided and body is defined
+  if (body !== undefined && !requestHeaders['Content-Type']) {
+    requestHeaders['Content-Type'] = 'application/json'
+  }
+
+  let response: Response
+  try {
+    response = await fetch(url, {
+      method,
+      headers: requestHeaders,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    })
+  } catch (error) {
+    throw new RPCNetworkError((error as Error).message)
+  }
+
+  // Handle rate limiting
+  if (response.status === 429) {
+    const retryAfter = response.headers.get('Retry-After')
+    throw new RPCRateLimitError(
+      'Rate limit exceeded. Please try again later.',
+      retryAfter ? parseInt(retryAfter, 10) : undefined
+    )
+  }
+
+  // Handle errors
+  if (!response.ok) {
+    let errorData: RPCError
+    try {
+      errorData = await response.json()
+    } catch {
+      errorData = { error: 'unknown_error', message: `Request failed with status ${response.status}` }
+    }
+
+    throw new RPCAPIError(
+      errorData.message || errorData.error,
+      response.status,
+      errorData.code || errorData.error
+    )
+  }
+
+  // Stream response
+  if (stream && response.body) {
+    return response.body as unknown as T
+  }
+
+  // JSON response
+  return response.json()
+}
+
+/**
+ * Make a request to calls.do
+ */
+export async function callsRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('calls.do', path, options)
+}
+
+/**
+ * Make a request to texts.do
+ */
+export async function textsRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('texts.do', path, options)
+}
+
+/**
+ * Make a request to emails.do
+ */
+export async function emailsRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('emails.do', path, options)
+}
+
+/**
+ * Make a request to payments.do
+ */
+export async function paymentsRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('payments.do', path, options)
+}
+
+/**
+ * Make a request to queue.do
+ */
+export async function queueRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('queue.do', path, options)
+}
+
+/**
+ * Make a request to llm.do
+ */
+export async function llmRequest<T = unknown>(
+  path: string,
+  options?: RPCRequestOptions
+): Promise<T> {
+  return rpcRequest<T>('llm.do', path, options)
+}