dotdo 0.0.2 → 0.1.0

package/cli/device-auth.ts

@@ -0,0 +1,289 @@
+/**
+ * CLI Device Authorization Module
+ *
+ * Uses oauth.do/node for OAuth 2.0 Device Authorization Grant (RFC 8628)
+ *
+ * @see https://oauth.do/node
+ * @see https://datatracker.ietf.org/doc/html/rfc8628
+ */
+
+import { readFile, writeFile, unlink, mkdir, access } from 'fs/promises'
+import { homedir } from 'os'
+import { join } from 'path'
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const OAUTH_BASE_URL = 'https://oauth.do'
+const DEFAULT_CLIENT_ID = 'org.ai-cli'
+const CONFIG_DIR_NAME = '.org.ai'
+const CREDENTIALS_FILE_NAME = 'credentials.json'
+
+// ============================================================================
+// Type Exports
+// ============================================================================
+
+export interface DeviceCodeResponse {
+  device_code: string
+  user_code: string
+  verification_uri: string
+  verification_uri_complete?: string
+  expires_in: number
+  interval: number
+}
+
+export interface TokenResponse {
+  access_token: string
+  token_type: string
+  expires_in?: number
+  refresh_token?: string
+  scope?: string
+}
+
+export interface PollError extends Error {
+  code: 'authorization_pending' | 'slow_down' | 'access_denied' | 'expired_token' | 'timeout'
+}
+
+export interface PollOptions {
+  interval: number
+  maxAttempts: number
+  onProgress?: (status: { attempt: number; maxAttempts: number }) => void
+}
+
+export interface RequestDeviceCodeOptions {
+  scope?: string
+  clientId?: string
+}
+
+export interface StoredToken {
+  access_token: string
+  token_type: string
+  refresh_token?: string
+  expires_at?: number
+  scope?: string
+}
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+function createPollError(code: PollError['code'], message: string): PollError {
+  const error = new Error(message) as PollError
+  error.code = code
+  return error
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+// ============================================================================
+// Config Path
+// ============================================================================
+
+/**
+ * Get the config file path
+ */
+export function getConfigPath(): string {
+  return join(homedir(), CONFIG_DIR_NAME, CREDENTIALS_FILE_NAME)
+}
+
+/**
+ * Get the config directory path
+ */
+function getConfigDir(): string {
+  return join(homedir(), CONFIG_DIR_NAME)
+}
+
+// ============================================================================
+// Device Code Request
+// ============================================================================
+
+/**
+ * Request a device code from the OAuth server
+ */
+export async function requestDeviceCode(options?: RequestDeviceCodeOptions): Promise<DeviceCodeResponse> {
+  const clientId = options?.clientId ?? DEFAULT_CLIENT_ID
+  const scope = options?.scope ?? 'openid profile email'
+
+  const body = new URLSearchParams({
+    client_id: clientId,
+    scope: scope,
+  })
+
+  const response = await fetch(`${OAUTH_BASE_URL}/device/code`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: body.toString(),
+  })
+
+  if (!response.ok) {
+    const errorData = await response.json().catch(() => ({}))
+    const errorCode = errorData.error || 'unknown_error'
+    const errorDescription = errorData.error_description || `Request failed with status ${response.status}`
+    throw new Error(`${errorCode}: ${errorDescription}`)
+  }
+
+  return response.json()
+}
+
+// ============================================================================
+// Token Polling
+// ============================================================================
+
+/**
+ * Poll the OAuth server for a token
+ */
+export async function pollForToken(deviceCode: string, options: PollOptions): Promise<TokenResponse> {
+  const { maxAttempts, onProgress } = options
+  let interval = options.interval
+  let attempt = 0
+
+  while (attempt < maxAttempts) {
+    attempt++
+
+    // Call onProgress before attempting (for first attempt)
+    if (onProgress && attempt > 1) {
+      onProgress({ attempt: attempt - 1, maxAttempts })
+    }
+
+    const body = new URLSearchParams({
+      grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+      device_code: deviceCode,
+      client_id: DEFAULT_CLIENT_ID,
+    })
+
+    const response = await fetch(`${OAUTH_BASE_URL}/token`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded',
+      },
+      body: body.toString(),
+    })
+
+    if (response.ok) {
+      return response.json()
+    }
+
+    const errorData = await response.json().catch(() => ({ error: 'unknown_error' }))
+    const errorCode = errorData.error
+
+    if (errorCode === 'authorization_pending') {
+      // Wait and continue polling
+      await sleep(interval * 1000)
+      continue
+    }
+
+    if (errorCode === 'slow_down') {
+      // Increase interval by 5 seconds and continue polling
+      interval += 5
+      await sleep(interval * 1000)
+      continue
+    }
+
+    if (errorCode === 'access_denied') {
+      throw createPollError('access_denied', 'access_denied: User denied access')
+    }
+
+    if (errorCode === 'expired_token') {
+      throw createPollError('expired_token', 'expired_token: Device code expired')
+    }
+
+    // Unknown error
+    throw new Error(errorData.error_description || errorCode || 'Token request failed')
+  }
+
+  // Max attempts reached
+  throw createPollError('timeout', 'timeout: Polling timed out waiting for authorization')
+}
+
+// ============================================================================
+// Token Storage
+// ============================================================================
+
+/**
+ * Store a token to the local config file
+ */
+export async function storeToken(token: TokenResponse): Promise<void> {
+  const configDir = getConfigDir()
+  const configPath = getConfigPath()
+
+  // Check if directory exists, create if not
+  try {
+    await access(configDir)
+  } catch {
+    await mkdir(configDir, { recursive: true, mode: 0o700 })
+  }
+
+  // Build stored token data
+  const storedToken: StoredToken = {
+    access_token: token.access_token,
+    token_type: token.token_type,
+  }
+
+  if (token.refresh_token) {
+    storedToken.refresh_token = token.refresh_token
+  }
+
+  if (token.expires_in) {
+    storedToken.expires_at = Date.now() + token.expires_in * 1000
+  }
+
+  if (token.scope) {
+    storedToken.scope = token.scope
+  }
+
+  // Write token file with secure permissions
+  await writeFile(configPath, JSON.stringify(storedToken, null, 2), { mode: 0o600 })
+}
+
+/**
+ * Get the stored token from the local config file
+ */
+export async function getStoredToken(): Promise<StoredToken | null> {
+  const configPath = getConfigPath()
+
+  try {
+    const content = await readFile(configPath, 'utf-8')
+    const data = JSON.parse(content)
+
+    // Validate token structure
+    if (!data.access_token || !data.token_type) {
+      return null
+    }
+
+    // Check expiration (only if no refresh token available)
+    if (data.expires_at && data.expires_at < Date.now() && !data.refresh_token) {
+      return null
+    }
+
+    return data as StoredToken
+  } catch (error: unknown) {
+    // File doesn't exist or other error
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+      return null
+    }
+    // JSON parse error or other issues
+    return null
+  }
+}
+
+/**
+ * Clear the stored token
+ */
+export async function clearToken(): Promise<boolean> {
+  const configPath = getConfigPath()
+
+  try {
+    await unlink(configPath)
+    return true
+  } catch (error: unknown) {
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+      return false
+    }
+    throw error
+  }
+}

package/cli/fallback.ts

@@ -0,0 +1,12 @@
+/**
+ * AI Fallback Handler
+ *
+ * Handles unrecognized commands by passing them to AI for processing.
+ */
+
+/**
+ * Process natural language input through AI
+ */
+export async function fallback(_input: string[]): Promise<void> {
+  // Placeholder - AI integration will be implemented
+}

package/cli/index.ts

@@ -0,0 +1,121 @@
+/**
+ * CLI Router
+ *
+ * Routes CLI commands to appropriate handlers or AI fallback.
+ */
+
+import { commands } from './commands/index'
+import pkg from '../package.json'
+
+export type RouteResult =
+  | { type: 'help' }
+  | { type: 'version' }
+  | { type: 'command'; name: string; args: string[] }
+  | { type: 'fallback'; input: string[] }
+
+/** Known command names */
+const knownCommands = [
+  // Auth commands
+  'login',
+  'logout',
+  // Dev commands
+  'dev',
+  'build',
+  'deploy',
+  'init',
+  'introspect',
+  // Service commands (cli.do)
+  'call',
+  'text',
+  'email',
+  'charge',
+  'queue',
+  'llm',
+  'config',
+]
+
+/** Version from package.json */
+export const version = pkg.version
+
+/** Help text for CLI */
+export const helpText = `
+Usage: do [command] [options]
+
+Service Commands (cli.do):
+  call        Make voice calls via calls.do
+              do call +15551234567 "Your appointment is tomorrow"
+
+  text        Send SMS/MMS via texts.do
+              do text +15551234567 "Reply YES to confirm"
+
+  email       Send emails via emails.do
+              do email user@example.com --template=welcome
+
+  charge      Create charges via payments.do
+              do charge cus_123 --amount=9900
+
+  queue       Queue operations via queue.do
+              do queue publish my-queue '{"event": "user.signup"}'
+
+  llm         LLM requests via llm.do (with streaming)
+              do llm "Summarize this document" --model=claude-sonnet
+
+  config      Manage CLI configuration
+              do config set json_output true
+
+Auth Commands:
+  login       Log in to your account (id.org.ai OAuth)
+  logout      Log out of your account
+
+Dev Commands:
+  dev         Start development server
+  build       Build the project
+  deploy      Deploy to production
+  init        Initialize a new project
+  introspect  Generate .do/types.d.ts from DB.mdx schemas
+
+Options:
+  -h, --help     Show help
+  -v, --version  Show version
+  --json         Output JSON (for service commands)
+
+Any unrecognized commands will be passed to the AI fallback for natural language processing.
+`
+
+/**
+ * Parse process.argv to extract CLI arguments
+ * Strips the runtime and script path
+ */
+export function parseArgv(argv: string[]): string[] {
+  return argv.slice(2)
+}
+
+/**
+ * Route CLI input to the appropriate handler
+ */
+export function route(argv: string[]): RouteResult {
+  const [command, ...args] = argv
+
+  // No command or help flag
+  if (!command || command === '--help' || command === '-h') {
+    return { type: 'help' }
+  }
+
+  // Version flag
+  if (command === '--version' || command === '-v') {
+    return { type: 'version' }
+  }
+
+  // help command with no additional args
+  if (command === 'help' && args.length === 0) {
+    return { type: 'help' }
+  }
+
+  // Known commands
+  if (knownCommands.includes(command)) {
+    return { type: 'command', name: command, args }
+  }
+
+  // AI fallback for unknown commands
+  return { type: 'fallback', input: argv }
+}

package/cli/main.ts

@@ -0,0 +1,246 @@
+#!/usr/bin/env bun
+/**
+ * dotdo CLI Entry Point
+ *
+ * Self-contained CLI for Durable Objects development.
+ * Includes embedded runtime with full DO support for local development.
+ *
+ * Usage:
+ *   dotdo dev           - Start local development server
+ *   dotdo do:list       - List Durable Objects
+ *   dotdo deploy        - Deploy to production
+ *   dotdo tunnel        - Expose local server via CF Tunnel
+ */
+
+import { Command } from 'commander'
+import { devCommand } from './commands/dev-local'
+import { doCommand } from './commands/do-ops'
+import { tunnelCommand } from './commands/tunnel'
+import { deployCommand } from './commands/deploy-multi'
+import { createLogger } from './utils/logger'
+
+const logger = createLogger('cli')
+
+// Package info
+const pkg = {
+  name: 'dotdo',
+  version: '0.1.0',
+  description: 'Self-contained CLI for Durable Objects development',
+}
+
+const program = new Command()
+  .name('dotdo')
+  .description(pkg.description)
+  .version(pkg.version, '-v, --version', 'Show version number')
+  .option('--debug', 'Enable debug output')
+
+// Handle debug flag at parse time
+const originalParse = program.parse.bind(program)
+program.parse = function (argv?: readonly string[], options?: { from: 'node' | 'electron' | 'user' }) {
+  // Pre-parse to check for --debug flag
+  const args = argv ?? process.argv
+  if (args.includes('--debug')) {
+    process.env.DEBUG = '1'
+  }
+  return originalParse(argv, options)
+}
+
+// Add commands
+program.addCommand(devCommand)
+program.addCommand(doCommand)
+program.addCommand(tunnelCommand)
+program.addCommand(deployCommand)
+
+// Init command
+program
+  .command('init')
+  .description('Initialize a new dotdo project')
+  .option('-t, --template <template>', 'Project template', 'default')
+  .option('--no-git', 'Skip git initialization')
+  .action(async (options) => {
+    logger.info('Initializing new dotdo project...')
+
+    const fs = await import('fs')
+    const path = await import('path')
+
+    const cwd = process.cwd()
+
+    // Create basic structure
+    const dirs = ['.dotdo', 'objects', 'api']
+    for (const dir of dirs) {
+      const dirPath = path.join(cwd, dir)
+      if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true })
+        logger.debug(`Created: ${dir}/`)
+      }
+    }
+
+    // Create dotdo.config.ts
+    const configPath = path.join(cwd, 'dotdo.config.ts')
+    if (!fs.existsSync(configPath)) {
+      const configContent = `/**
+ * dotdo configuration
+ */
+
+import type { DotdoConfig } from 'dotdo/cli'
+
+export default {
+  port: 8787,
+  entryPoint: 'index.ts',
+  compatibilityDate: '2024-01-01',
+  compatibilityFlags: ['nodejs_compat'],
+} satisfies DotdoConfig
+`
+      fs.writeFileSync(configPath, configContent)
+      logger.debug('Created: dotdo.config.ts')
+    }
+
+    // Create example DO
+    const examplePath = path.join(cwd, 'objects', 'Counter.ts')
+    if (!fs.existsSync(examplePath)) {
+      const exampleContent = `/**
+ * Example Durable Object: Counter
+ */
+
+export class Counter extends DurableObject {
+  private count: number = 0
+
+  constructor(ctx: DurableObjectState, env: Env) {
+    super(ctx, env)
+  }
+
+  async fetch(request: Request): Promise<Response> {
+    const url = new URL(request.url)
+
+    if (url.pathname === '/increment') {
+      this.count++
+      await this.ctx.storage.put('count', this.count)
+      return new Response(JSON.stringify({ count: this.count }))
+    }
+
+    if (url.pathname === '/decrement') {
+      this.count--
+      await this.ctx.storage.put('count', this.count)
+      return new Response(JSON.stringify({ count: this.count }))
+    }
+
+    return new Response(JSON.stringify({ count: this.count }))
+  }
+}
+`
+      fs.writeFileSync(examplePath, exampleContent)
+      logger.debug('Created: objects/Counter.ts')
+    }
+
+    // Create index.ts
+    const indexPath = path.join(cwd, 'index.ts')
+    if (!fs.existsSync(indexPath)) {
+      const indexContent = `/**
+ * Worker entry point
+ */
+
+import { Counter } from './objects/Counter'
+
+export { Counter }
+
+export default {
+  async fetch(request: Request, env: Env): Promise<Response> {
+    const url = new URL(request.url)
+
+    // Route to Counter DO
+    if (url.pathname.startsWith('/counter')) {
+      const id = env.COUNTER.idFromName('default')
+      const counter = env.COUNTER.get(id)
+      return counter.fetch(request)
+    }
+
+    return new Response('Hello from dotdo!')
+  },
+}
+
+interface Env {
+  COUNTER: DurableObjectNamespace
+}
+`
+      fs.writeFileSync(indexPath, indexContent)
+      logger.debug('Created: index.ts')
+    }
+
+    // Initialize git
+    if (options.git) {
+      const { execSync } = await import('child_process')
+      try {
+        if (!fs.existsSync(path.join(cwd, '.git'))) {
+          execSync('git init', { cwd, stdio: 'ignore' })
+          logger.debug('Initialized git repository')
+        }
+      } catch {
+        // Git not available
+      }
+    }
+
+    console.log()
+    logger.success('Project initialized!')
+    console.log()
+    console.log('  Next steps:')
+    console.log('    1. Run: dotdo dev')
+    console.log('    2. Visit: http://localhost:8787')
+    console.log('    3. Try:   http://localhost:8787/counter/increment')
+    console.log()
+  })
+
+// Logs command
+program
+  .command('logs')
+  .description('Stream logs from deployed workers')
+  .option('-f, --follow', 'Follow log output', true)
+  .option('--format <format>', 'Output format (json, pretty)', 'pretty')
+  .action(async (options) => {
+    const { spawn } = await import('child_process')
+
+    const args = ['wrangler', 'tail']
+    if (options.format === 'json') {
+      args.push('--format', 'json')
+    }
+
+    const proc = spawn('bunx', args, {
+      stdio: 'inherit',
+    })
+
+    proc.on('error', (error) => {
+      logger.error('Failed to start wrangler tail', { error: error.message })
+      process.exit(1)
+    })
+  })
+
+// Build command
+program
+  .command('build')
+  .description('Build the project')
+  .option('-w, --watch', 'Watch for changes')
+  .action(async (options) => {
+    const { spawn } = await import('child_process')
+
+    logger.info('Building project...')
+
+    const args = ['tsc', '-p', 'tsconfig.json']
+    if (options.watch) {
+      args.push('--watch')
+    }
+
+    const proc = spawn('bunx', args, {
+      stdio: 'inherit',
+    })
+
+    proc.on('exit', (code) => {
+      if (code === 0) {
+        logger.success('Build complete')
+      } else {
+        logger.error('Build failed')
+        process.exit(code ?? 1)
+      }
+    })
+  })
+
+// Parse arguments
+program.parse()