# Pulsbase — The Autonomous Edge Database Where Your Data Thinks

> Pulsbase is an HTTP-native, serverless, globally distributed SQLite database engine powered by the proprietary Pulsbase Global Edge Engine, enhanced with native AI for vector embeddings, full-text derivation, and natural language SQL generation.

## 🌟 Flagship Superpowers & Capabilities
- **Global Anycast Read Replication & Regional Data Residency**: Zero-config, globally replicated databases verified across worldwide Anycast nodes with target 4ms p50 read latency without connection pooling. Choose your Data Jurisdiction (`global`, `eu` [weur], `us-east` [enam], `us-west` [wnam], `apac`) during database creation or branching to guarantee that primary SQLite write disks and backup snapshots strictly remain inside your chosen regional border (GDPR, EU Data Boundary, US East/West residency). Note: Formal enterprise certifications (`FedRAMP`, `HIPAA`) are planned on our Phase 3 enterprise roadmap.
- **Pulse AI Context-Aware Support & Pre-Sales Assistant**: Built-in autonomous engineering assistant connected to live Pulsbase Anycast database schemas, indexes, and usage quotas. Provides instant SQL/TypeScript code and schema optimization without answering out-of-context or unrelated queries.
- **Autonomous Edge Query Self-Healing & Real-Time Auto-Fix**: Plain English to SQL co-pilot (`text-to-sql`) with real-time syntax error detection, diagnostics, and one-click AI query self-healing. In production APIs, pass `"autoHeal": true` (or header `X-Pulsbase-Auto-Heal: true`) to `POST /v1/sql` to let edge workers automatically intercept schema drift crashes in `<50ms`, repair SQL via Pulsbase Edge AI, execute the fixed query, and return data without throwing 500 server errors!
- **Automatic Semantic Indexing & Hybrid Search**: Text columns are embedded automatically on every INSERT/UPDATE via Pulsbase Native AI Embeddings. Combines BM25 full-text keyword matching with 768-dimensional vector cosine similarity in a single query (tunable `alpha` parameter).
- **AI Virtual Columns**: Attach computed columns (e.g., `sentiment_score`) derived from English prompts. Evaluated dynamically via background edge workers without stalling customer transactions.
- **Prompt-to-Function & Serverless Trigger Hooks**: Describe business logic in plain English; Pulsbase AI compiles it into TypeScript Edge code executing in V8 isolates with 0ms cold start latency. Attach triggers `BEFORE` or `AFTER` database mutations or on UTC cron schedules.
- **3-Tier Agent Memory Lake**: Structured memory hierarchy for autonomous AI agents:
  1. Working Memory (`_pb_sessions`): Relational session store for immediate checkpointer state.
  2. Archival Vector Lake (`_pb_archival`): Long-term semantic memory lake summarized and vectorized automatically.
  3. Temporal Knowledge Graph (`_pb_entities`): Tracks evolving user facts and entity relationships.
- **Instant Copy-on-Write Cluster Branching**: Instantly clone up to 100GB production replica clusters (`pb_...`) in under 200ms with zero storage duplication tax for idle branches ($0.00 storage duplication tax until data diverges).
- **Engine Snapshots & Time Travel**: Point-in-time recovery (PITR) to roll back cluster state to any exact millisecond within a 30-day retention window.
- **Attached Spotlight Search (`Cmd / Ctrl + K`)**: Instant black glassmorphism dropdown search across live database clusters, API keys, tables, and studios directly underneath the top navbar.
- **International SaaS Standard Security & MFA Studio**: RFC 6238 TOTP two-factor authentication, IP allowlisting and firewall rules, active browser session monitoring with instant one-click revocation, and immutable WORM audit trails.
- **SaaS Standard In-Dashboard Stepper Onboarding**: Interactive 4-step stepper correlated 100% with visible workspace elements (zero pre-dashboard interruption; state persisted in browser storage).

## 💎 Transparent Developer Pricing
- **Hobby Plan ($0 / forever)**: 5 databases, 500MB storage, full semantic vector search, and 10 natural-language-to-SQL queries/day. The most generous free tier in the industry with built-in AI.
- **Pro Plan ($9 / month)**: Netflix-level conversion tier designed for developers and growing apps needing higher quotas and dedicated anycast replicas.
- **Business Plan ($29 / month)**: 200 databases, 100GB cluster storage, unlimited copy-on-write branching, 30-day point-in-time time travel, and full AI vector + self-healing capabilities. Beating competitors on pricing, speed, and native AI integration.

## 🏗️ BaaS Platform Studios
- **Zero-Config Dev Auth Studio (34 OAuth Providers Supported)**: Comprehensive identity suite covering 8 Zero-Config Dev Mode providers (`google`, `github`, `microsoft`, `x`, `discord`, `linkedin`, `gitlab`, `slack`) and 26 BYOC encrypted providers (`apple`, `facebook`, `instagram`, `spotify`, `twitch`, `tiktok`, `reddit`, `pinterest`, `yahoo`, `bitbucket`, `notion`, `figma`, `atlassian`, `shopify`, `zoom`, `dropbox`, `amazon`, `stripe`, `line`, `kakao`, `steam`, `patreon`, `box`, `salesforce`, `hubspot`, `vercel`). Custom client secrets are AES-GCM encrypted in D1 (`auth_providers` table). End users authenticate via `https://api.pulsbase.com/v1/baas/auth/oauth/{provider}/authorize?db={dbId}` and are automatically upserted into the developer's target D1 `_pulsbase_users` table on callback (`/callback`). Supports anonymous guest sessions and WebAuthn hardware biometric passkeys (FaceID, TouchID, Windows Hello).
- **S3 Global Object Lake**: Unstructured file storage with $0.00 bandwidth egress tax and strict MIME validation (10MB max per payload).
- **Real-Time WebSocket Stream**: Subscribe to atomic table mutations (`INSERT`, `UPDATE`, `DELETE`) over persistent bi-directional WebSockets via Anycast Mesh Rooms.
- **API Keys & Webhooks**: HMAC-SHA256 verified secret server tokens (`sk_live_...`) and publishable read-only SDK keys (`pk_live_...`). Per-table webhook delivery with exponential backoff retries.

## 🤖 Universal AI Agent & Framework Compatibility
Pulsbase is framework-agnostic and provides native connectors for all major orchestration loops:
- **Model Context Protocol (MCP)**: Universal connector (`npx -y @pulsbase/mcp-server@latest`) for Claude Desktop, Cursor IDE, Windsurf, and custom MCP clients.
- **LangChain & LangGraph (`@pulsbase/langchain`)**: Durable session checkpointer (`PulsbaseMemoryStore`) and vector retriever.
- **Vercel AI SDK (`@pulsbase/ai`)**: Stream and generate text callbacks with automated conversation checkpointing.
- **LlamaIndex (`pulsbase`)**: High-performance `PulsbaseVectorStore` indexer for RAG applications.
- **CrewAI & Autogen (`pulsbase.crew`)**: Shared collaborative memory pools for multi-agent autonomous teams.
- **Universal REST / JSON-RPC**: Direct HTTP and WebSocket endpoints compatible with Python, Go, Rust, Ruby, C#, or custom agent loops.

## ⚡ HTTP API Quickstart
Base URL: `https://api.query.pulsbase.com/v1`
Authentication: `X-API-Key: sk_live_...` or `pk_live_...`

### Execute SQL Query (with Autonomous Self-Healing)
```bash
curl -X POST https://api.query.pulsbase.com/v1/sql \
  -H "X-API-Key: sk_live_your_secret_token" \
  -H "X-Pulsbase-Auto-Heal: true" \
  -H "Content-Type: application/json" \
  -d '{
    "clusterId": "pb_primary_cluster_9182",
    "query": "SELECT * FROM users WHERE status = ?",
    "params": ["ACTIVE"],
    "autoHeal": true
  }'
```

### Hybrid Semantic + Keyword Search
```bash
curl -X POST https://api.query.pulsbase.com/v1/search \
  -H "X-API-Key: sk_live_your_secret_token" \
  -H "Content-Type: application/json" \
  -d '{
    "clusterId": "pb_primary_cluster_9182",
    "table": "support_tickets",
    "query": "biometric authentication errors on Apple devices",
    "hybrid": true,
    "alpha": 0.7,
    "limit": 5
  }'
```

### AI Auto-Fix SQL Query
```bash
curl -X POST https://api.query.pulsbase.com/v1/ai/sql-fix \
  -H "X-API-Key: sk_live_your_secret_token" \
  -H "Content-Type: application/json" \
  -d '{
    "clusterId": "pb_primary_cluster_9182",
    "query": "SELECT * FROM usr WHERE stat = 'ACTIVE'",
    "error": "no such table: usr"
  }'
```

## 📚 Documentation Links
- [Flagship Features & Superpowers](https://docs.pulsbase.com/flagship-features)
- [Pulse AI Support Assistant](https://docs.pulsbase.com/pulse-ai)
- [BaaS Platform Studios](https://docs.pulsbase.com/baas-platform)
- [API Reference](https://docs.pulsbase.com/api-reference)
- [MCP Server Integration](https://docs.pulsbase.com/mcp-server)
- [Core Concepts & Architecture](https://docs.pulsbase.com/core-concepts)