connectbase-client 0.5.1 → 0.6.0

package/README.md

@@ -443,6 +443,158 @@ await cb.database.updateData('table-id', 'data-id', {
 await cb.database.deleteData('table-id', 'data-id')
 ```
 
+#### Aggregation (MongoDB-style Pipeline)
+
+```typescript
+const result = await cb.database.aggregate('table-id', [
+  { match: { status: 'active' } },
+  { group: { _id: '$category', total: { $sum: '$price' }, count: { $sum: 1 } } },
+  { sort: { total: -1 } },
+  { limit: 10 }
+])
+console.log(result.results) // [{ _id: 'electronics', total: 5000, count: 12 }, ...]
+```
+
+#### Full-Text Search
+
+```typescript
+// Fuzzy search with highlighting
+const results = await cb.database.search('table-id', 'smrt phone', ['name', 'description'], {
+  fuzzy: true,
+  fuzzy_distance: 2,
+  highlight: true,
+  limit: 10
+})
+
+results.results.forEach(item => {
+  console.log(item.data.name, item.score, item.highlights)
+})
+
+// Autocomplete
+const suggestions = await cb.database.autocomplete('table-id', 'sma', 'name', { limit: 5 })
+```
+
+#### Geo Queries
+
+```typescript
+// Find locations within 5km radius
+const nearby = await cb.database.geoQuery('table-id', 'location', {
+  near: {
+    center: { latitude: 37.5665, longitude: 126.9780 },
+    max_distance: 5000
+  }
+}, { limit: 20 })
+
+nearby.results.forEach(place => {
+  console.log(place.data.name, `${place.distance}m away`)
+})
+```
+
+#### Batch & Transactions
+
+```typescript
+// Batch: atomic multi-table operations
+await cb.database.batch([
+  { type: 'create', table: 'orders', data: { product: 'A', qty: 1 } },
+  { type: 'update', table: 'inventory', doc_id: 'item-a', operators: {
+    qty: { type: 'increment', value: -1 }
+  }},
+  { type: 'update', table: 'stats', doc_id: 'daily', operators: {
+    order_count: { type: 'increment', value: 1 },
+    last_order: { type: 'serverTimestamp' }
+  }}
+])
+
+// Transaction: read-then-write with ACID guarantees
+await cb.database.transaction(
+  [{ table: 'accounts', doc_id: 'user-1', alias: 'sender' }],
+  [{ type: 'update', table: 'accounts', doc_id: 'user-1', operators: {
+    balance: { type: 'increment', value: -100 }
+  }}]
+)
+```
+
+#### Populate (Relation Query / JOIN)
+
+```typescript
+// Query with related data populated
+const posts = await cb.database.getDataWithPopulate('posts-table', {
+  limit: 10,
+  populate: [
+    { field: 'author_id', from: 'users', as: 'author', select: ['name', 'avatar'] },
+    { field: 'id', from: 'comments', as: 'comments', limit: 5, orderBy: 'created_at', order: 'desc' }
+  ]
+})
+```
+
+#### Security Rules (RLS)
+
+```typescript
+// Set row-level security rules
+await cb.database.createSecurityRule('app-id', {
+  table_name: 'posts',
+  rules: {
+    read: 'true',                              // Anyone can read
+    create: 'auth.member_id != null',          // Only authenticated users
+    update: 'auth.member_id == data.author_id', // Only author
+    delete: 'auth.member_id == data.author_id'
+  }
+})
+
+// List rules
+const rules = await cb.database.listSecurityRules('app-id')
+```
+
+#### Indexes
+
+```typescript
+// Create unique index
+await cb.database.createIndex('app-id', 'table-id', {
+  name: 'idx_email_unique',
+  fields: ['email'],
+  unique: true
+})
+
+// Analyze and get recommendations
+const analysis = await cb.database.analyzeIndexes('app-id', 'table-id')
+analysis.recommendations.forEach(rec => {
+  console.log(`Recommended: ${rec.fields.join(', ')} — ${rec.reason}`)
+})
+```
+
+#### Triggers
+
+```typescript
+// Auto-execute function on data change
+await cb.database.createTrigger('app-id', {
+  name: 'on-order-created',
+  table_name: 'orders',
+  event: 'create',
+  handler_type: 'function',
+  handler_id: 'send-notification-fn-id'
+})
+```
+
+#### Lifecycle (TTL / Retention)
+
+```typescript
+// Auto-delete expired sessions
+await cb.database.setTTL('app-id', {
+  table_name: 'sessions',
+  field: 'expires_at',
+  enabled: true
+})
+
+// Archive old logs after 90 days
+await cb.database.setRetentionPolicy('app-id', {
+  table_name: 'logs',
+  retention_days: 90,
+  action: 'archive',
+  archive_table: 'archived_logs',
+  enabled: true
+})
+```
+
 ### Storage
 
 ```typescript

package/dist/cli.js

@@ -375,6 +375,11 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `);
   success(".connectbaserc \uC0DD\uC131 \uC644\uB8CC");
   addToGitignore(".connectbaserc");
   addDeployScript(deployDir);
+  const setupClaude = await prompt(`
+${colors.blue}?${colors.reset} Claude Code \uC124\uC815\uC744 \uCD94\uAC00\uD560\uAE4C\uC694? (CLAUDE.md, MCP \uC124\uC815) (Y/n): `);
+  if (setupClaude.toLowerCase() !== "n") {
+    await setupClaudeCode(apiKey);
+  }
   log(`
 ${colors.green}\uCD08\uAE30\uD654 \uC644\uB8CC!${colors.reset}
 `);
@@ -432,6 +437,157 @@ function addDeployScript(deployDir) {
     warn("package.json \uC218\uC815\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4");
   }
 }
+async function setupClaudeCode(apiKey) {
+  const claudeDir = path.join(process.cwd(), ".claude");
+  const claudeMdPath = path.join(claudeDir, "CLAUDE.md");
+  const mcpConfigPath = path.join(process.cwd(), ".mcp.json");
+  if (!fs.existsSync(claudeDir)) {
+    fs.mkdirSync(claudeDir, { recursive: true });
+  }
+  const claudeMdContent = `# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Connect Base SDK
+
+\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 Connect Base SDK\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.
+
+### \uC124\uCE58
+
+\`\`\`bash
+npm install connectbase-client
+\`\`\`
+
+### \uAE30\uBCF8 \uC0AC\uC6A9\uBC95
+
+\`\`\`typescript
+import ConnectBase from 'connectbase-client'
+
+const cb = new ConnectBase({
+    apiKey: 'YOUR_API_KEY'
+})
+\`\`\`
+
+### Database API
+
+\`\`\`typescript
+// \uB370\uC774\uD130 \uC870\uD68C
+const { data, total } = await cb.database.getData('table-id', {
+    limit: 20,
+    offset: 0,
+    select: ['id', 'name', 'thumbnail'],  // \uD2B9\uC815 \uD544\uB4DC\uB9CC \uC870\uD68C
+    exclude: ['html_content']              // \uD2B9\uC815 \uD544\uB4DC \uC81C\uC678
+})
+
+// \uC870\uAC74\uBD80 \uCFFC\uB9AC
+const result = await cb.database.queryData('table-id', {
+    where: { field: 'status', operator: 'eq', value: 'active' },
+    orderBy: 'created_at',
+    orderDirection: 'desc'
+})
+
+// \uB370\uC774\uD130 \uC0DD\uC131
+const newItem = await cb.database.createData('table-id', {
+    data: { name: 'John', email: 'john@example.com' }
+})
+
+// \uB370\uC774\uD130 \uC218\uC815
+await cb.database.updateData('table-id', 'data-id', {
+    data: { name: 'Jane' }
+})
+
+// \uB370\uC774\uD130 \uC0AD\uC81C
+await cb.database.deleteData('table-id', 'data-id')
+\`\`\`
+
+### Storage API
+
+\`\`\`typescript
+// \uD30C\uC77C \uC5C5\uB85C\uB4DC
+const result = await cb.storage.uploadFile(file)
+
+// \uD30C\uC77C \uBAA9\uB85D \uC870\uD68C
+const files = await cb.storage.listFiles()
+\`\`\`
+
+### Auth API
+
+\`\`\`typescript
+// \uD68C\uC6D0\uAC00\uC785
+await cb.auth.signUp({ email, password })
+
+// \uB85C\uADF8\uC778
+const { member, tokens } = await cb.auth.signIn({ email, password })
+
+// \uB85C\uADF8\uC544\uC6C3
+await cb.auth.signOut()
+\`\`\`
+
+### Functions API
+
+\`\`\`typescript
+// Serverless \uD568\uC218 \uD638\uCD9C
+const result = await cb.functions.invoke('function-name', {
+    param1: 'value1'
+})
+\`\`\`
+
+### Realtime API
+
+\`\`\`typescript
+// WebSocket \uC5F0\uACB0
+cb.realtime.connect()
+
+// \uCC44\uB110 \uAD6C\uB3C5
+cb.realtime.subscribe('channel-name', (message) => {
+    console.log('\uBC1B\uC740 \uBA54\uC2DC\uC9C0:', message)
+})
+
+// \uBA54\uC2DC\uC9C0 \uC804\uC1A1
+cb.realtime.send('channel-name', { text: 'Hello!' })
+\`\`\`
+
+## Where \uC5F0\uC0B0\uC790
+
+| \uC5F0\uC0B0\uC790 | \uC124\uBA85 |
+|--------|------|
+| \`eq\` | \uAC19\uC74C (=) |
+| \`neq\` | \uAC19\uC9C0 \uC54A\uC74C (!=) |
+| \`gt\` | \uD07C (>) |
+| \`gte\` | \uD06C\uAC70\uB098 \uAC19\uC74C (>=) |
+| \`lt\` | \uC791\uC74C (<) |
+| \`lte\` | \uC791\uAC70\uB098 \uAC19\uC74C (<=) |
+| \`like\` | \uBD80\uBD84 \uC77C\uCE58 |
+| \`in\` | \uBC30\uC5F4\uC5D0 \uD3EC\uD568 |
+| \`nin\` | \uBC30\uC5F4\uC5D0 \uBBF8\uD3EC\uD568 |
+| \`between\` | \uBC94\uC704 \uB0B4 |
+| \`is_null\` | NULL \uCCB4\uD06C |
+| \`regex\` | \uC815\uADDC\uC2DD \uB9E4\uCE6D |
+| \`array_contains\` | \uBC30\uC5F4 \uD544\uB4DC\uC5D0 \uAC12 \uD3EC\uD568 |
+
+## \uBC30\uD3EC
+
+\`\`\`bash
+npm run deploy
+\`\`\`
+`;
+  fs.writeFileSync(claudeMdPath, claudeMdContent);
+  success(".claude/CLAUDE.md \uC0DD\uC131 \uC644\uB8CC");
+  const mcpConfig = {
+    mcpServers: {
+      connectbase: {
+        url: "https://mcp.connectbase.world/mcp",
+        headers: {
+          Authorization: `Bearer ${apiKey}`
+        }
+      }
+    }
+  };
+  fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  success(".mcp.json \uC0DD\uC131 \uC644\uB8CC");
+  addToGitignore(".mcp.json");
+  info("Claude Code\uC5D0\uC11C MCP \uC11C\uBC84\uB97C \uC0AC\uC6A9\uD558\uB824\uBA74 .mcp.json \uD30C\uC77C\uC774 \uD544\uC694\uD569\uB2C8\uB2E4");
+}
 function createWsTextFrame(payload) {
   const data = Buffer.from(payload, "utf-8");
   const len = data.length;