dotdo 0.0.1 → 0.1.0

package/cli/commands/do-ops.ts

@@ -0,0 +1,314 @@
+/**
+ * DO Command
+ *
+ * Operations for managing Durable Objects:
+ * - list: List all DO instances
+ * - show: Show DO state
+ * - save: Create snapshot
+ * - restore: Restore from snapshot
+ * - clone: Clone DO instance
+ * - delete: Delete DO instance
+ */
+
+import { Command } from 'commander'
+import { createDB } from '../runtime/embedded-db'
+import { createLogger } from '../utils/logger'
+
+const logger = createLogger('do')
+
+/**
+ * Format timestamp for display
+ */
+function formatTime(ts: number): string {
+  return new Date(ts * 1000).toLocaleString()
+}
+
+/**
+ * Format state for display
+ */
+function formatState(state: Record<string, unknown>, indent = 2): string {
+  return JSON.stringify(state, null, indent)
+}
+
+export const doCommand = new Command('do')
+  .description('Durable Object operations')
+
+/**
+ * do:list - List all DO instances
+ */
+doCommand
+  .command('list')
+  .alias('ls')
+  .description('List all Durable Object instances')
+  .option('-c, --class <name>', 'Filter by class name')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const instances = await db.list(options.class)
+
+      if (options.json) {
+        console.log(JSON.stringify(instances, null, 2))
+        return
+      }
+
+      if (instances.length === 0) {
+        logger.info('No Durable Objects found')
+        return
+      }
+
+      console.log()
+      console.log(`Found ${instances.length} Durable Object(s):`)
+      console.log()
+
+      for (const instance of instances) {
+        console.log(`  ${instance.id}`)
+        console.log(`    Class:   ${instance.className}`)
+        console.log(`    Created: ${formatTime(instance.createdAt)}`)
+        console.log(`    Updated: ${formatTime(instance.updatedAt)}`)
+        console.log()
+      }
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:show - Show DO state
+ */
+doCommand
+  .command('show <id>')
+  .description('Show Durable Object state')
+  .option('--json', 'Output as JSON')
+  .option('--storage', 'Include storage data')
+  .action(async (id, options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const instance = await db.get(id)
+
+      if (!instance) {
+        logger.error(`Durable Object not found: ${id}`)
+        process.exit(1)
+      }
+
+      if (options.json) {
+        console.log(JSON.stringify(instance, null, 2))
+        return
+      }
+
+      console.log()
+      console.log(`Durable Object: ${instance.id}`)
+      console.log('─'.repeat(40))
+      console.log(`  Class:   ${instance.className}`)
+      console.log(`  Created: ${formatTime(instance.createdAt)}`)
+      console.log(`  Updated: ${formatTime(instance.updatedAt)}`)
+      console.log()
+      console.log('State:')
+      console.log(formatState(instance.state))
+
+      if (options.storage) {
+        console.log()
+        console.log('Storage:')
+        console.log(formatState(instance.storage))
+      }
+      console.log()
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:save - Create snapshot
+ */
+doCommand
+  .command('save <id>')
+  .description('Create a snapshot of a Durable Object')
+  .option('-l, --label <label>', 'Label for the snapshot')
+  .action(async (id, options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const instance = await db.get(id)
+
+      if (!instance) {
+        logger.error(`Durable Object not found: ${id}`)
+        process.exit(1)
+      }
+
+      const snapshotId = await db.snapshot(id, options.label)
+      logger.success(`Snapshot created: ${snapshotId}`)
+
+      if (options.label) {
+        console.log(`  Label: ${options.label}`)
+      }
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:restore - Restore from snapshot
+ */
+doCommand
+  .command('restore <id> <snapshot>')
+  .description('Restore a Durable Object from a snapshot')
+  .option('-f, --force', 'Force restore without confirmation')
+  .action(async (id, snapshotId, options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const instance = await db.get(id)
+
+      if (!instance) {
+        logger.error(`Durable Object not found: ${id}`)
+        process.exit(1)
+      }
+
+      // List snapshots if snapshot ID is 'list'
+      if (snapshotId === 'list') {
+        const snapshots = await db.listSnapshots(id)
+
+        if (snapshots.length === 0) {
+          logger.info('No snapshots found')
+          return
+        }
+
+        console.log()
+        console.log(`Snapshots for ${id}:`)
+        console.log()
+
+        for (const snap of snapshots) {
+          console.log(`  ${snap.id}`)
+          console.log(`    Created: ${formatTime(snap.createdAt)}`)
+          if (snap.label) {
+            console.log(`    Label:   ${snap.label}`)
+          }
+          console.log()
+        }
+        return
+      }
+
+      if (!options.force) {
+        logger.warn('This will overwrite current state.')
+        logger.info('Use --force to confirm')
+        process.exit(1)
+      }
+
+      await db.restore(id, snapshotId)
+      logger.success(`Restored ${id} from snapshot ${snapshotId}`)
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:clone - Clone DO instance
+ */
+doCommand
+  .command('clone <source> <target>')
+  .description('Clone a Durable Object instance')
+  .action(async (sourceId, targetId) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const source = await db.get(sourceId)
+
+      if (!source) {
+        logger.error(`Source Durable Object not found: ${sourceId}`)
+        process.exit(1)
+      }
+
+      const existing = await db.get(targetId)
+      if (existing) {
+        logger.error(`Target already exists: ${targetId}`)
+        logger.info('Delete it first or choose a different ID')
+        process.exit(1)
+      }
+
+      await db.clone(sourceId, targetId)
+      logger.success(`Cloned ${sourceId} to ${targetId}`)
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:delete - Delete DO instance
+ */
+doCommand
+  .command('delete <id>')
+  .alias('rm')
+  .description('Delete a Durable Object instance')
+  .option('-f, --force', 'Force delete without confirmation')
+  .action(async (id, options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const instance = await db.get(id)
+
+      if (!instance) {
+        logger.error(`Durable Object not found: ${id}`)
+        process.exit(1)
+      }
+
+      if (!options.force) {
+        logger.warn(`This will permanently delete ${id} and all its snapshots.`)
+        logger.info('Use --force to confirm')
+        process.exit(1)
+      }
+
+      await db.delete(id)
+      logger.success(`Deleted ${id}`)
+    } finally {
+      db.close()
+    }
+  })
+
+/**
+ * do:snapshots - List snapshots
+ */
+doCommand
+  .command('snapshots <id>')
+  .description('List snapshots for a Durable Object')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options) => {
+    const db = createDB()
+    await db.init()
+
+    try {
+      const snapshots = await db.listSnapshots(id)
+
+      if (options.json) {
+        console.log(JSON.stringify(snapshots, null, 2))
+        return
+      }
+
+      if (snapshots.length === 0) {
+        logger.info(`No snapshots found for ${id}`)
+        return
+      }
+
+      console.log()
+      console.log(`Snapshots for ${id} (${snapshots.length}):`)
+      console.log()
+
+      for (const snap of snapshots) {
+        const label = snap.label ? ` (${snap.label})` : ''
+        console.log(`  ${snap.id}${label}`)
+        console.log(`    Created: ${formatTime(snap.createdAt)}`)
+        console.log()
+      }
+    } finally {
+      db.close()
+    }
+  })
+
+export default doCommand

package/cli/commands/index.ts

@@ -0,0 +1,100 @@
+/**
+ * CLI Command Registry
+ *
+ * Exports all available CLI commands.
+ */
+
+import { run as introspectRun } from './introspect'
+
+// Service commands (cli.do)
+import { run as callRun } from '../src/commands/call'
+import { run as textRun } from '../src/commands/text'
+import { run as emailRun } from '../src/commands/email'
+import { run as chargeRun } from '../src/commands/charge'
+import { run as queueRun } from '../src/commands/queue'
+import { run as llmRun } from '../src/commands/llm'
+import { run as configRun } from '../src/commands/config'
+
+export type CommandHandler = (args: string[]) => Promise<void> | void
+
+export interface Command {
+  run: CommandHandler
+  description?: string
+}
+
+/** Command registry object */
+export const commands: Record<string, Command> = {
+  // Auth commands
+  login: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Log in to your account',
+  },
+  logout: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Log out of your account',
+  },
+
+  // Dev commands
+  dev: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Start development server',
+  },
+  build: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Build the project',
+  },
+  deploy: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Deploy to production',
+  },
+  init: {
+    run: async (_args: string[]) => {
+      // Placeholder - will be implemented
+    },
+    description: 'Initialize a new project',
+  },
+  introspect: {
+    run: introspectRun,
+    description: 'Generate .do/types.d.ts from DB.mdx schemas',
+  },
+
+  // Service commands (cli.do)
+  call: {
+    run: callRun,
+    description: 'Make voice calls via calls.do',
+  },
+  text: {
+    run: textRun,
+    description: 'Send SMS/MMS via texts.do',
+  },
+  email: {
+    run: emailRun,
+    description: 'Send emails via emails.do',
+  },
+  charge: {
+    run: chargeRun,
+    description: 'Create charges via payments.do',
+  },
+  queue: {
+    run: queueRun,
+    description: 'Queue operations via queue.do',
+  },
+  llm: {
+    run: llmRun,
+    description: 'LLM requests via llm.do',
+  },
+  config: {
+    run: configRun,
+    description: 'Manage CLI configuration',
+  },
+}

package/cli/commands/init.ts

@@ -0,0 +1,247 @@
+/**
+ * Init Command
+ *
+ * Scaffolds a new dotdo project with the proper structure.
+ *
+ * Usage:
+ *   npx dotdo init my-startup    # Create new project directory
+ *   npx dotdo init .             # Initialize in current directory
+ */
+
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+
+// ============================================================================
+// Command Metadata
+// ============================================================================
+
+export const name = 'init'
+export const description = 'Initialize a new dotdo project'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface InitOptions {
+  /** Working directory (defaults to process.cwd()) */
+  cwd?: string
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Convert kebab-case or snake_case to PascalCase
+ */
+function toPascalCase(str: string): string {
+  return str
+    .split(/[-_]/)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('')
+}
+
+/**
+ * Validate project name
+ */
+function validateProjectName(name: string): void {
+  // Allow "." for current directory
+  if (name === '.') return
+
+  // Check for valid npm package name (simplified)
+  const validNamePattern = /^[a-z][a-z0-9-]*$/
+
+  if (!validNamePattern.test(name)) {
+    throw new Error(`Invalid project name: "${name}". Must start with a letter and contain only lowercase letters, numbers, and hyphens.`)
+  }
+}
+
+// ============================================================================
+// Templates
+// ============================================================================
+
+/**
+ * Generate src/index.ts content
+ */
+function generateIndexTs(className: string): string {
+  return `/**
+ * ${className} - A dotdo Startup
+ *
+ * Build your 1-Person Unicorn.
+ */
+
+import { DO } from 'dotdo'
+
+export class ${className} extends DO {
+  static readonly $type = '${className}'
+}
+
+// Re-export the simple worker as default
+export { default } from 'dotdo/workers/simple'
+`
+}
+
+/**
+ * Generate wrangler.jsonc content
+ */
+function generateWranglerJsonc(projectName: string, className: string): string {
+  return `{
+  "$schema": "https://raw.githubusercontent.com/cloudflare/workers-sdk/main/packages/wrangler/config-schema.json",
+  "name": "${projectName}",
+  "main": "src/index.ts",
+  "compatibility_date": "2024-12-01",
+  "compatibility_flags": ["nodejs_compat"],
+
+  // Durable Objects
+  "durable_objects": {
+    "bindings": [
+      {
+        "name": "DO",
+        "class_name": "${className}",
+        "script_name": "${projectName}"
+      }
+    ]
+  },
+
+  "migrations": [
+    {
+      "tag": "v1",
+      "new_sqlite_classes": ["${className}"]
+    }
+  ]
+}
+`
+}
+
+/**
+ * Generate package.json content
+ */
+function generatePackageJson(projectName: string): string {
+  const pkg = {
+    name: projectName,
+    version: '0.0.1',
+    private: true,
+    type: 'module',
+    scripts: {
+      dev: 'wrangler dev',
+      deploy: 'wrangler deploy',
+      typecheck: 'tsc --noEmit',
+    },
+    dependencies: {
+      dotdo: '^0.1.0',
+    },
+    devDependencies: {
+      '@cloudflare/workers-types': '^4.20241230.0',
+      typescript: '^5.7.0',
+      wrangler: '^3.99.0',
+    },
+  }
+  return JSON.stringify(pkg, null, 2) + '\n'
+}
+
+/**
+ * Generate tsconfig.json content
+ */
+function generateTsconfig(): string {
+  const config = {
+    compilerOptions: {
+      target: 'ES2022',
+      module: 'ESNext',
+      moduleResolution: 'bundler',
+      strict: true,
+      skipLibCheck: true,
+      esModuleInterop: true,
+      resolveJsonModule: true,
+      isolatedModules: true,
+      noEmit: true,
+      lib: ['ES2022'],
+      types: ['@cloudflare/workers-types'],
+    },
+    include: ['src/**/*'],
+    exclude: ['node_modules'],
+  }
+  return JSON.stringify(config, null, 2) + '\n'
+}
+
+// ============================================================================
+// Main Command
+// ============================================================================
+
+/**
+ * Run the init command
+ */
+export async function run(args: string[], options: InitOptions = {}): Promise<void> {
+  const cwd = options.cwd ?? process.cwd()
+
+  // Get project name from args
+  const projectName = args[0]
+
+  if (!projectName) {
+    throw new Error('Please provide a project name: npx dotdo init <project-name>')
+  }
+
+  // Validate project name
+  validateProjectName(projectName)
+
+  // Determine project directory and name for files
+  let projectDir: string
+  let actualProjectName: string
+
+  if (projectName === '.') {
+    // Initialize in current directory
+    projectDir = cwd
+    actualProjectName = path.basename(cwd)
+  } else {
+    // Create new directory
+    projectDir = path.join(cwd, projectName)
+    actualProjectName = projectName
+
+    // Check if directory already exists
+    if (fs.existsSync(projectDir)) {
+      throw new Error(`Directory "${projectName}" already exists. Please choose a different name or remove the existing directory.`)
+    }
+
+    // Create project directory
+    fs.mkdirSync(projectDir, { recursive: true })
+  }
+
+  // Derive class name from project name
+  const className = toPascalCase(actualProjectName)
+
+  // Create src directory
+  const srcDir = path.join(projectDir, 'src')
+  fs.mkdirSync(srcDir, { recursive: true })
+
+  // Write files
+  fs.writeFileSync(
+    path.join(srcDir, 'index.ts'),
+    generateIndexTs(className)
+  )
+
+  fs.writeFileSync(
+    path.join(projectDir, 'wrangler.jsonc'),
+    generateWranglerJsonc(actualProjectName, className)
+  )
+
+  fs.writeFileSync(
+    path.join(projectDir, 'package.json'),
+    generatePackageJson(actualProjectName)
+  )
+
+  fs.writeFileSync(
+    path.join(projectDir, 'tsconfig.json'),
+    generateTsconfig()
+  )
+
+  // Print success message
+  console.log(`\nProject "${actualProjectName}" created successfully!\n`)
+  console.log('Next steps:')
+
+  if (projectName !== '.') {
+    console.log(`  cd ${projectName}`)
+  }
+
+  console.log('  npm install')
+  console.log('  npm run dev')
+  console.log('')
+}