moai-adk 0.32.8__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-platform-supabase/reference.md

@@ -0,0 +1,284 @@
+---
+name: supabase-reference
+description: API reference summary for Supabase platform
+parent-skill: moai-platform-supabase
+version: 1.0.0
+updated: 2026-01-06
+---
+
+# Supabase API Reference
+
+## Client Methods
+
+### Database Operations
+
+```typescript
+// Select
+const { data, error } = await supabase.from('table').select('*')
+const { data } = await supabase.from('table').select('id, name, relation(*)').eq('id', 1)
+
+// Insert
+const { data, error } = await supabase.from('table').insert({ column: 'value' }).select()
+const { data } = await supabase.from('table').insert([...items]).select()
+
+// Update
+const { data, error } = await supabase.from('table').update({ column: 'value' }).eq('id', 1).select()
+
+// Upsert
+const { data, error } = await supabase.from('table').upsert({ id: 1, column: 'value' }).select()
+
+// Delete
+const { error } = await supabase.from('table').delete().eq('id', 1)
+```
+
+### Query Filters
+
+```typescript
+.eq('column', 'value')         // Equal
+.neq('column', 'value')        // Not equal
+.gt('column', 0)               // Greater than
+.gte('column', 0)              // Greater than or equal
+.lt('column', 100)             // Less than
+.lte('column', 100)            // Less than or equal
+.like('column', '%pattern%')   // LIKE
+.ilike('column', '%pattern%')  // ILIKE (case insensitive)
+.is('column', null)            // IS NULL
+.in('column', ['a', 'b'])      // IN
+.contains('array_col', ['a'])  // Array contains
+.containedBy('col', ['a','b']) // Array contained by
+.range('col', '[1,10)')        // Range
+.textSearch('col', 'query')    // Full-text search
+.filter('col', 'op', 'val')    // Generic filter
+```
+
+### Query Modifiers
+
+```typescript
+.order('column', { ascending: false })
+.limit(10)
+.range(0, 9)              // Pagination
+.single()                 // Expect exactly one row
+.maybeSingle()           // Expect zero or one row
+.count('exact', { head: true })  // Count only
+```
+
+### RPC (Remote Procedure Call)
+
+```typescript
+const { data, error } = await supabase.rpc('function_name', {
+  arg1: 'value1',
+  arg2: 'value2'
+})
+```
+
+## Auth Methods
+
+```typescript
+// Sign up
+await supabase.auth.signUp({ email, password })
+
+// Sign in
+await supabase.auth.signInWithPassword({ email, password })
+await supabase.auth.signInWithOAuth({ provider: 'google' })
+await supabase.auth.signInWithOtp({ email })
+
+// Session
+await supabase.auth.getUser()
+await supabase.auth.getSession()
+await supabase.auth.refreshSession()
+
+// Sign out
+await supabase.auth.signOut()
+
+// Password
+await supabase.auth.resetPasswordForEmail(email)
+await supabase.auth.updateUser({ password: newPassword })
+
+// Listener
+supabase.auth.onAuthStateChange((event, session) => {})
+```
+
+## Real-time Methods
+
+```typescript
+// Subscribe to changes
+const channel = supabase.channel('channel-name')
+  .on('postgres_changes',
+    { event: '*', schema: 'public', table: 'table_name' },
+    (payload) => {}
+  )
+  .subscribe()
+
+// Presence
+channel.on('presence', { event: 'sync' }, () => {
+  const state = channel.presenceState()
+})
+await channel.track({ user_id: 'id', online_at: new Date() })
+
+// Broadcast
+await channel.send({ type: 'broadcast', event: 'name', payload: {} })
+channel.on('broadcast', { event: 'name' }, ({ payload }) => {})
+
+// Unsubscribe
+await supabase.removeChannel(channel)
+await supabase.removeAllChannels()
+```
+
+## Storage Methods
+
+```typescript
+// Upload
+await supabase.storage.from('bucket').upload('path/file.ext', file, { cacheControl: '3600' })
+
+// Download
+await supabase.storage.from('bucket').download('path/file.ext')
+
+// Get URL
+supabase.storage.from('bucket').getPublicUrl('path/file.ext', {
+  transform: { width: 800, height: 600, resize: 'cover' }
+})
+
+// Signed URL
+await supabase.storage.from('bucket').createSignedUrl('path/file.ext', 3600)
+
+// List
+await supabase.storage.from('bucket').list('folder', { limit: 100 })
+
+// Delete
+await supabase.storage.from('bucket').remove(['path/file.ext'])
+
+// Move
+await supabase.storage.from('bucket').move('old/path', 'new/path')
+```
+
+## Edge Functions
+
+```typescript
+// Invoke
+const { data, error } = await supabase.functions.invoke('function-name', {
+  body: { key: 'value' },
+  headers: { 'Custom-Header': 'value' }
+})
+```
+
+## SQL Quick Reference
+
+### pgvector
+
+```sql
+CREATE EXTENSION vector;
+
+-- Create table with vector column
+CREATE TABLE items (
+  id UUID PRIMARY KEY,
+  embedding vector(1536)
+);
+
+-- HNSW index (recommended)
+CREATE INDEX ON items USING hnsw (embedding vector_cosine_ops);
+
+-- IVFFlat index (large datasets)
+CREATE INDEX ON items USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);
+
+-- Distance operators
+<->  -- Euclidean distance
+<=>  -- Cosine distance
+<#>  -- Negative inner product
+```
+
+### Row-Level Security
+
+```sql
+-- Enable RLS
+ALTER TABLE table_name ENABLE ROW LEVEL SECURITY;
+
+-- Create policy
+CREATE POLICY "policy_name" ON table_name
+  FOR SELECT | INSERT | UPDATE | DELETE | ALL
+  TO role_name
+  USING (expression)
+  WITH CHECK (expression);
+
+-- Auth functions
+auth.uid()                    -- Current user ID
+auth.jwt() ->> 'claim'        -- JWT claim value
+auth.role()                   -- Current role
+```
+
+### Useful Functions
+
+```sql
+gen_random_uuid()             -- Generate UUID
+uuid_generate_v4()            -- Generate UUID (requires uuid-ossp)
+NOW()                         -- Current timestamp
+CURRENT_TIMESTAMP            -- Current timestamp
+to_tsvector('english', text)  -- Full-text search vector
+plainto_tsquery('query')      -- Full-text search query
+ts_rank(vector, query)        -- Full-text search rank
+```
+
+## Environment Variables
+
+```bash
+# Public (safe for client)
+NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+
+# Private (server-only)
+SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+SUPABASE_JWT_SECRET=your-jwt-secret
+```
+
+## CLI Commands
+
+```bash
+# Project
+supabase init
+supabase start
+supabase stop
+supabase status
+
+# Database
+supabase db diff
+supabase db push
+supabase db reset
+supabase migration new migration_name
+supabase migration list
+
+# Types
+supabase gen types typescript --project-id xxx > database.types.ts
+
+# Functions
+supabase functions new function-name
+supabase functions serve function-name
+supabase functions deploy function-name
+supabase functions list
+
+# Secrets
+supabase secrets set KEY=value
+supabase secrets list
+```
+
+## Context7 Documentation Access
+
+For detailed API documentation, use Context7 MCP tools:
+
+```
+Step 1: Resolve library ID
+mcp__context7__resolve-library-id with query "supabase"
+
+Step 2: Fetch documentation
+mcp__context7__get-library-docs with:
+- context7CompatibleLibraryID: resolved ID
+- topic: "specific topic"
+- tokens: 5000-10000
+```
+
+Common topics:
+- "javascript client select insert update"
+- "auth signIn signUp oauth"
+- "realtime postgres_changes presence"
+- "storage upload download transform"
+- "edge-functions deploy invoke"
+- "row-level-security policies"
+- "pgvector similarity search"

moai_adk/templates/.claude/skills/moai-platform-vercel/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: "moai-platform-vercel"
+description: "Vercel edge deployment specialist covering Edge Functions, Next.js optimization, preview deployments, ISR, and storage solutions. Use when deploying Next.js applications, implementing edge computing, or configuring Vercel platform features."
+version: 2.0.0
+category: "platform"
+modularized: true
+tags: ['vercel', 'edge', 'nextjs', 'isr', 'preview', 'cdn', 'kv', 'blob', 'postgres']
+context7-libraries: "/vercel/next.js, /vercel/vercel"
+related-skills: "moai-platform-railway, moai-lang-typescript, moai-domain-frontend"
+updated: 2026-01-08
+status: "active"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
+---
+
+# moai-platform-vercel: Vercel Edge Deployment Specialist
+
+## Quick Reference
+
+Vercel Optimization Focus: Edge-first deployment platform with global CDN, Next.js optimized runtime, managed storage solutions, and developer-centric preview workflows.
+
+### Core Capabilities
+
+Edge Functions:
+- Global low-latency compute at 30+ edge locations
+- Sub-50ms cold start for optimal user experience
+- Geo-based routing and personalization
+- Edge middleware for request/response transformation
+
+Next.js Optimized Runtime:
+- First-class Next.js support with automatic optimizations
+- Server Components and App Router integration
+- Streaming SSR for improved TTFB
+- Built-in image optimization with next/image
+
+Preview Deployments:
+- Automatic PR-based preview URLs
+- Branch-specific environment variables
+- Comment integration for PR reviews
+- Instant rollback capabilities
+
+ISR (Incremental Static Regeneration):
+- On-demand revalidation for dynamic content
+- Stale-while-revalidate caching strategy
+- Tag-based cache invalidation
+- Background regeneration without user impact
+
+Managed Storage:
+- Vercel KV: Redis-compatible key-value store
+- Vercel Blob: Object storage for files
+- Vercel Postgres: Managed PostgreSQL database
+
+### Quick Decision Guide
+
+Choose Vercel When:
+- Next.js is primary framework
+- Edge performance is critical requirement
+- Preview deployments needed for team collaboration
+- Web Vitals monitoring is priority
+- Serverless storage solutions needed
+
+---
+
+## Module Index
+
+This skill uses modular documentation for progressive disclosure. Load modules as needed:
+
+### [Edge Functions and Middleware](modules/edge-functions.md)
+
+Covers Edge Runtime configuration, middleware patterns, geo-based content delivery, A/B testing at edge, and authentication at edge. Includes region selection, supported APIs, and cold start optimization.
+
+### [ISR and Caching Strategies](modules/isr-caching.md)
+
+Covers Incremental Static Regeneration patterns, time-based and on-demand revalidation, tag-based cache invalidation, CDN cache headers, streaming with Suspense, and cache debugging techniques.
+
+### [Deployment Configuration](modules/deployment-config.md)
+
+Covers vercel.json configuration, environment variables management, preview and production deployments, function memory and duration settings, cron jobs, monorepo setup, domain configuration, and security headers.
+
+### [Analytics and Speed Insights](modules/analytics-speed.md)
+
+Covers Vercel Analytics integration, Speed Insights for Web Vitals, custom performance monitoring, Core Web Vitals optimization, and third-party analytics integration.
+
+### [KV, Blob, and Postgres Storage](modules/kv-storage.md)
+
+Covers Vercel KV (Redis-compatible), Vercel Blob (object storage), Vercel Postgres (managed database), edge-compatible usage patterns, and common storage patterns.
+
+---
+
+## Implementation Guide
+
+### Essential Configuration
+
+Basic vercel.json:
+
+```json
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": "nextjs",
+  "regions": ["iad1", "sfo1", "fra1"],
+  "functions": {
+    "app/api/**/*.ts": {
+      "memory": 1024,
+      "maxDuration": 30
+    }
+  }
+}
+```
+
+### Edge Function Quick Start
+
+```typescript
+// app/api/edge/route.ts
+export const runtime = 'edge'
+export const preferredRegion = ['iad1', 'sfo1']
+
+export async function GET(request: Request) {
+  const country = request.geo?.country ?? 'Unknown'
+  return Response.json({ country })
+}
+```
+
+### ISR Quick Start
+
+```typescript
+// app/products/[id]/page.tsx
+export const revalidate = 60 // Revalidate every 60 seconds
+
+export default async function ProductPage({ params }: { params: { id: string } }) {
+  const product = await fetch(`https://api.example.com/products/${params.id}`, {
+    next: { tags: [`product-${params.id}`] }
+  }).then(r => r.json())
+
+  return <ProductDetail product={product} />
+}
+```
+
+### Analytics Integration
+
+```typescript
+// app/layout.tsx
+import { Analytics } from '@vercel/analytics/react'
+import { SpeedInsights } from '@vercel/speed-insights/next'
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <Analytics />
+        <SpeedInsights />
+      </body>
+    </html>
+  )
+}
+```
+
+---
+
+## Advanced Patterns
+
+### Blue-Green Deployment
+
+Deploy new version, run smoke tests on preview URL, then switch production alias using Vercel SDK for zero-downtime releases.
+
+### Monorepo with Turborepo
+
+```json
+{
+  "buildCommand": "cd ../.. && pnpm turbo build --filter=web",
+  "installCommand": "cd ../.. && pnpm install",
+  "framework": "nextjs"
+}
+```
+
+### Context7 Integration
+
+Use Context7 MCP tools for latest documentation:
+
+Step 1: Resolve library ID using mcp__context7__resolve-library-id with "vercel" or "next.js"
+
+Step 2: Fetch documentation using mcp__context7__get-library-docs with resolved ID, specific topic, and appropriate token allocation (5000-10000 tokens)
+
+---
+
+## Works Well With
+
+- `moai-platform-railway` - Container-based deployment alternative
+- `moai-lang-typescript` - TypeScript patterns for Next.js
+- `moai-domain-frontend` - React and Next.js component patterns
+- `moai-foundation-quality` - Deployment validation and testing
+- `moai-domain-database` - Database patterns for Vercel Postgres
+
+---
+
+## Additional Resources
+
+- [Reference Guide](reference.md) - Complete CLI commands and configuration options
+- [Code Examples](examples.md) - Production-ready code snippets
+
+---
+
+Status: Production Ready | Version: 2.0.0 | Updated: 2026-01-06