insforge 1.3.0 → 1.4.8

package/docs/changelog.mdx

@@ -1,119 +1,212 @@
 ---
 title: "Changelog"
-description: "Latest updates and improvements to InsForge"
+description: "New features, improvements, and fixes shipped to InsForge."
 ---
 
-## December 2025
+<Update label="Dec 21, 2025" tags={["Realtime", "Auth", "Payments", "AI"]}>
+  ## Realtime Module
 
-<AccordionGroup>
-  <Accordion title="Dec 12 - Alipay & New AI Models" icon="rocket">
-    ### Alipay Payment Support
-    Added **Alipay** as an alternative payment method. Users can now pay for InsForge subscriptions without a credit card.
+  We launched a new Realtime module built on WebSockets with a pub/sub architecture. It supports channels for live updates, message history for state syncing, and RLS-based permissions out of the box—making it well suited for real-time apps, games, chat, and collaborative experiences.
 
-    <img src="/images/changelog/dec-2025/alipay-payment.webp" alt="Alipay payment method option" style={{maxWidth: '90%'}} />
+  <Frame>
+    <img src="/images/changelog/dec-2025/realtime2.png" alt="Realtime module with collaborative cursors and messaging" />
+  </Frame>
 
-    ### New AI Models
-    Expanded AI model support:
-    - **GPT 5.2** - OpenAI's latest flagship model with enhanced reasoning, longer context windows, and improved instruction following
-    - **DeepSeek V3** - Open-weight model offering strong performance at lower cost, ideal for high-volume workloads
+  ### Apple OAuth
 
-    <img src="/images/changelog/dec-2025/ai-models.webp" alt="AI Integration with new models" style={{maxWidth: '90%'}} />
-  </Accordion>
-  <Accordion title="Dec 11 - Apple Login & Realtime Module" icon="rocket">
-    ### Apple Login
-    **Sign in with Apple** is now available as an OAuth provider. Enable it in your project settings and let users authenticate with their Apple ID. Like other social providers, InsForge Cloud offers shared credentials for quick testing.
+  Apple OAuth is now available in InsForge Auth, as requested by the community. You can enable Sign in with Apple in a few clicks and ship apps with Apple login without manual OAuth setup.
 
-    <img src="/images/changelog/dec-2025/apple-login.jpg" alt="Sign in with Apple authentication" style={{maxWidth: '90%'}} />
+  <Frame>
+    <video autoPlay muted loop playsInline src="/images/changelog/dec-2025/apple-oauth.mp4" />
+  </Frame>
 
-    ### Realtime Module
-    Build apps with **realtime pub/sub messaging**. Whether you're creating a chat room, multiplayer game, or collaborative document editor, the new Realtime module handles WebSocket connections, channel subscriptions, and message delivery out of the box.
+  ### Alipay Payments
 
-    Key features include:
-    - **Channel patterns** with wildcard support (e.g., `chat:*`, `game:lobby`)
-    - **Webhook integrations** for server-side event processing
-    - **Message history** and delivery analytics
-    - **RLS-based permissions** for secure subscribe and publish operations
+  Alipay is now supported for InsForge subscriptions, so you can subscribe without a credit card. This removes a major payment barrier for users in the APAC region.
 
-    <img src="/images/changelog/dec-2025/realtime-module.jpg" alt="Realtime multiplayer chess game demo" style={{maxWidth: '90%'}} />
-  </Accordion>
-  <Accordion title="Dec 7 - AI Models, MCP Installer & Security Updates" icon="rocket">
-    ### AI Integration
-    Expanded model support with smarter defaults for different use cases.
+  ### More Models in the Model Gateway
 
-    - **Gemini 3 Pro** is now the default image generation model.
-    - **Grok 4.1 Fast** added to model selection for quicker, lightweight inference.
+  We have added more popular and state-of-the-art models to the InsForge Model Gateway so you can choose the right model for each use case:
 
-    <img src="/images/changelog/dec-2025/ai-integration.png" alt="AI Integration with new models" style={{maxWidth: '90%'}} />
+  - **GPT 5.2** - Stronger reasoning and longer context
+  - **DeepSeek V3** - High performance at a lower cost
+  - **Gemini 3 Flash** - Low latency real-time inference
 
-    ### MCP Installer
-    Updated installer experience with a new InsForge-branded startup screen and clearer next-step instructions.
+  More models are coming soon.
 
-    <img src="/images/changelog/dec-2025/mcp-installer.png" alt="MCP Installer with InsForge branding" style={{maxWidth: '90%'}} />
+  <Frame>
+    <img src="/images/changelog/dec-2025/moreModels.png" alt="AI Integration dashboard with new models" />
+  </Frame>
 
-    ### Security & Framework Updates
-    Updated Next.js version in response to a [security incident](https://nextjs.org/blog/CVE-2025-66478).
-  </Accordion>
-</AccordionGroup>
+  [View AI SDK documentation →](/core-concepts/ai/sdk)
+</Update>
 
-## November 2025
+<Update label="Dec 19, 2025" tags={["Multi Region", "Postgres Connection"]}>
+  ## Multi-Region Deployments
+  Deploy your project to the appropriate region for improved latency and compliance. We currently support `us-east`, `us-west`, `eu-central` and `ap-southeast` regions. More regions will be added based on demand.
 
-<AccordionGroup>
-  <Accordion title="Nov 30 - QuickStart, Auth Components & Dashboard Tools" icon="rocket">
-    ### QuickStart Prompts & Templates
-    Get started faster with our new quickstart prompts and templates for common apps. Builders can now start with one click and get a fullstack app running in **5 minutes**.
+  <Frame>
+    <img src="/images/changelog/dec-2025/multi-region.webp" alt="Multi-Region Deployments" />
+  </Frame>
 
+  ## Postgres Connection
+  Connect to your project's Postgres database and query it directly from your database clients. This also allows you to integrate InsForge with external services and tools like n8n.
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/postgres-connection.webp" alt="Postgres Connection" />
+  </Frame>
+</Update>
+
+<Update label="Dec 16, 2025" tags={["Email"]}>
+  ## Custom Emails (Private Preview)
+  Send custom transactional emails directly from your app using the SDK. Supports multiple recipients, CC/BCC, custom sender names, and full HTML content.
+
+  [View Email SDK documentation →](/core-concepts/email/sdk)
+</Update>
+
+<Update label="Dec 12, 2025" tags={["Payments", "AI"]}>
+  ## Alipay Payment Support
+  Added **Alipay** as an alternative payment method. Users can now pay for InsForge subscriptions without a credit card.
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/alipay-payment.webp" alt="Alipay payment method option" />
+  </Frame>
+
+  ## New AI Models
+  Expanded AI model support:
+  - **GPT-5.2** - OpenAI's latest flagship model with enhanced reasoning, longer context windows, and improved instruction following
+  - **DeepSeek V3** - Open-weight model offering strong performance at lower cost, ideal for high-volume workloads
+
+  [View AI SDK documentation →](/core-concepts/ai/sdk)
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/ai-models.webp" alt="AI Integration with new models" />
+  </Frame>
+</Update>
+
+<Update label="Dec 11, 2025" tags={["Auth", "Realtime"]}>
+  ## Apple Login
+  **Sign in with Apple** is now available as an OAuth provider. Enable it in your project settings and let users authenticate with their Apple ID. Like other social providers, InsForge Cloud offers shared credentials for quick testing.
+
+  [View Authentication docs →](/core-concepts/authentication/sdk)
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/apple-login.jpg" alt="Sign in with Apple authentication" />
+  </Frame>
+
+  ## Realtime Module
+  Build apps with **realtime pub/sub messaging**. Whether you're creating a chat room, multiplayer game, or collaborative document editor, the new Realtime module handles WebSocket connections, channel subscriptions, and message delivery out of the box.
+
+  Key features include:
+  - **Channel patterns** with wildcard support (e.g., `chat:*`, `game:lobby`)
+  - **Webhook integrations** for server-side event processing
+  - **Message history** and delivery analytics
+  - **RLS-based permissions** for secure subscribe and publish operations
+
+  [View Realtime SDK documentation →](/core-concepts/realtime/sdk)
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/realtime-module.jpg" alt="Realtime multiplayer chess game demo" />
+  </Frame>
+</Update>
+
+<Update label="Dec 7, 2025" tags={["AI", "Security"]}>
+  ## AI Integration
+  Expanded model support with smarter defaults for different use cases.
+
+  - **Gemini 3 Pro** is now the default image generation model.
+  - **Grok 4.1 Fast** added to model selection for quicker, lightweight inference.
+
+  [View AI SDK documentation →](/core-concepts/ai/sdk)
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/ai-integration.png" alt="AI Integration with new models" />
+  </Frame>
+
+  ## MCP Installer
+  Updated installer experience with a new InsForge-branded startup screen and clearer next-step instructions.
+
+  <Frame>
+    <img src="/images/changelog/dec-2025/mcp-installer.png" alt="MCP Installer with InsForge branding" />
+  </Frame>
+
+  ## Security & Framework Updates
+  Updated Next.js and React versions in response to a [security incident](https://nextjs.org/blog/CVE-2025-66478).
+</Update>
+
+<Update label="Nov 30, 2025" tags={["Dashboard", "Auth"]}>
+  ## QuickStart Prompts & Templates
+  Get started faster with our new quickstart prompts and templates for common apps. Builders can now start with one click and get a fullstack app running in **5 minutes**.
+
+  [Try the quickstart →](/quickstart)
+
+  <Frame>
     <img src="/images/changelog/nov-2025/quickstart-prompts.webp" alt="QuickStart Prompts and Templates" />
+  </Frame>
+
+  ## Auth Components
+  Drop-in prebuilt React auth components for your app. Get a working auth flow right away with social sign-on support built in by default.
 
-    ### Auth Components
-    Drop-in prebuilt React auth components for your app. Get a working auth flow right away with social sign-on support built in by default.
+  [View Auth Components docs →](/core-concepts/authentication/ui-components/react)
 
+  <Frame>
     <img src="/images/changelog/nov-2025/auth-components.webp" alt="Auth Components with Social Sign-on" />
+  </Frame>
 
-    ### Database Metadata Dashboard
-    View your RLS policies, triggers, functions, and indexes all in one place. This makes debugging and understanding your project security much easier.
+  ## Database Metadata Dashboard
+  View your RLS policies, triggers, functions, and indexes all in one place. This makes debugging and understanding your project security much easier.
 
+  <Frame>
     <img src="/images/changelog/nov-2025/database-metadata.webp" alt="Database Metadata Dashboard" />
+  </Frame>
 
-    ### SQL Editor
-    Run SQL queries directly in the InsForge dashboard. No external tools required.
+  ## SQL Editor
+  Run SQL queries directly in the InsForge dashboard. No external tools required.
 
+  <Frame>
     <img src="/images/changelog/nov-2025/sql-editor.webp" alt="SQL Editor in Dashboard" />
+  </Frame>
 
-    ### Usage Page
-    A new dashboard section that displays a clear breakdown of your resource usage and what your plan includes.
+  ## Usage Page
+  A new dashboard section that displays a clear breakdown of your resource usage and what your plan includes.
 
+  <Frame>
     <img src="/images/changelog/nov-2025/usage-page.webp" alt="Usage Page Dashboard" />
-  </Accordion>
-</AccordionGroup>
+  </Frame>
+</Update>
 
-## October 2025
+<Update label="Oct 30, 2025" tags={["Auth", "SDK"]}>
+  ## OAuth: 4 New Third-Party Providers
+  You can now enable third-party logins with **LinkedIn, Microsoft, Facebook, and Discord**. On InsForge Cloud, we provide shared credentials for developers who want to quickly test these login flows.
 
-<AccordionGroup>
-  <Accordion title="Oct 30 - OAuth Providers, SDK & Logs" icon="rocket">
-    ### OAuth: 4 New Third-Party Providers
-    You can now enable third-party logins with **LinkedIn, Microsoft, Facebook, and Discord**. On InsForge Cloud, we provide shared credentials for developers who want to quickly test these login flows.
+  After enabling, you can implement these logins directly through your agent by sending a simple prompt:
 
-    After enabling, you can implement these logins directly through your agent by sending a simple prompt:
+  ```text
+  implement Discord login
+  ```
 
-    ```text
-    implement Discord login
-    ```
+  [View Authentication docs →](/core-concepts/authentication/sdk)
 
+  <Frame>
     <img src="/images/changelog/october-2025/oauth-providers.webp" alt="OAuth Providers - LinkedIn, Microsoft, Facebook, and Discord" />
+  </Frame>
 
-    ### Import CSV to Your Table
-    You can now upload `.csv` files directly into any table from the dashboard. Perfect for bringing in sample data or migrating from other tools.
+  ## Import CSV to Your Table
+  You can now upload `.csv` files directly into any table from the dashboard. Perfect for bringing in sample data or migrating from other tools.
 
+  <Frame>
     <img src="/images/changelog/october-2025/csv-upload.webp" alt="CSV Upload to Tables Feature" />
+  </Frame>
 
-    ### InsForge.js SDK
-    We've released our **insforge-js SDK** to make it easier for developers to integrate InsForge into their workflows. Manage auth, query databases, and control your backend programmatically with a few lines of code.
+  ## InsForge.js SDK
+  We've released our **insforge-js SDK** to make it easier for developers to integrate InsForge into their workflows. Manage auth, query databases, and control your backend programmatically with a few lines of code.
 
-    **Repository:** [GitHub](https://github.com/InsForge/InsForge-sdk-js)
+  [GitHub](https://github.com/InsForge/InsForge-sdk-js) · [Database SDK →](/core-concepts/database/sdk)
 
-    ### Logs
-    The new logs page lets you monitor container logs in real time. You can watch your backend activity directly in the dashboard, or let AI coding agents query logs through the InsForge MCP to automatically debug and search for errors.
+  ## Logs
+  The new logs page lets you monitor container logs in real time. You can watch your backend activity directly in the dashboard, or let AI coding agents query logs through the InsForge MCP to automatically debug and search for errors.
 
+  <Frame>
     <img src="/images/changelog/october-2025/logs-feature.webp" alt="Real-time Logs Monitoring Feature" />
-  </Accordion>
-</AccordionGroup>
+  </Frame>
+</Update>

package/docs/core-concepts/ai/architecture.mdx

@@ -1,5 +1,5 @@
 ---
-title: Architecture
+title: AI Architecture
 description: OpenRouter integration for chat completions and image generation
 ---
 
@@ -78,28 +78,6 @@ sequenceDiagram
     InsForge-->>Client: Formatted response
 ```
 
-## Available Models
-
-### Chat Models
-
-| Provider | Model | ID | Best For |
-|----------|-------|----|---------| 
-| **Anthropic** | Claude Sonnet 4 | `anthropic/claude-sonnet-4` | Complex reasoning |
-| **Anthropic** | Claude 3.5 Haiku | `anthropic/claude-3.5-haiku` | Fast responses |
-| **Anthropic** | Claude Opus 4.1 | `anthropic/claude-opus-4.1` | Highest quality |
-| **OpenAI** | GPT-5 | `openai/gpt-5` | Most advanced |
-| **OpenAI** | GPT-5 Mini | `openai/gpt-5-mini` | Fast & efficient |
-| **OpenAI** | GPT-4o | `openai/gpt-4o` | General purpose |
-| **Google** | Gemini 2.5 Pro | `google/gemini-2.5-pro` | Advanced reasoning |
-| **xAI** | Grok 4 | `x-ai/grok-4` | Advanced reasoning |
-
-### Image Models
-
-| Provider | Model | ID | Capabilities |
-|----------|-------|----|--------------| 
-| **Google** | Gemini 2.5 Flash Image | `google/gemini-2.5-flash-image-preview` | Text-to-image generation |
-| **Google** | Gemini 3 Pro Image | `google/gemini-3-pro-image-preview` | Advanced text-to-image generation |
-
 ## Chat Completions
 
 ### Request Processing

package/docs/core-concepts/ai/sdk.mdx

@@ -14,7 +14,7 @@ Create AI chat completions with streaming support.
 ### Parameters
 
 - `model` (string, required) - AI model (e.g., 'anthropic/claude-3.5-haiku', 'openai/gpt-4'), call `mcp__insforge__get-backend-metadata` tool to get available models
-- `messages` (array, required) - Array of message objects: `{role: "user"|"system"|"assistant", content: string}`
+- `messages` (array, required) - Array of message objects with text, image, or audio content
 - `temperature` (number, optional) - Sampling temperature 0-2
 - `maxTokens` (number, optional) - Max tokens to generate
 - `topP` (number, optional) - Top-p sampling 0-1
@@ -76,6 +76,31 @@ const completion = await insforge.ai.chat.completions.create({
 console.log(completion.choices[0].message.content);
 ```
 
+### Example (with audio)
+
+```javascript
+const completion = await insforge.ai.chat.completions.create({
+  model: 'openai/gpt-4o-audio-preview',
+  messages: [
+    {
+      role: 'user',
+      content: [
+        { type: 'text', text: 'Transcribe this audio and summarize it' },
+        {
+          type: 'input_audio',
+          input_audio: {
+            data: audioBase64, // base64-encoded audio
+            format: 'wav',     // wav, mp3, aiff, aac, ogg, flac, m4a
+          },
+        },
+      ],
+    },
+  ],
+});
+
+console.log(completion.choices[0].message.content);
+```
+
 ### Output (non-streaming)
 
 ```json

package/docs/core-concepts/authentication/architecture.mdx

@@ -1,5 +1,5 @@
 ---
-title: Architecture
+title: Authentication Architecture
 description: JWT-based authentication with OAuth providers and session management
 ---
 
@@ -24,9 +24,8 @@ graph TB
     JWT --> Secret[Shared Secret]
     JWT --> Validation[Token Validation]
     
-    DB --> Accounts[_accounts Table]
-    DB --> Users[users Table]
-    DB --> OAuth[_account_providers]
+    DB --> Users[auth.users Table]
+    DB --> Providers[auth.user_providers]
     
     style Client fill:#1e293b,stroke:#475569,color:#e2e8f0
     style SDK fill:#1e40af,stroke:#3b82f6,color:#dbeafe
@@ -38,9 +37,8 @@ graph TB
     style Google fill:#4c1d95,stroke:#8b5cf6,color:#ede9fe
     style GitHub fill:#1e293b,stroke:#64748b,color:#f1f5f9
     style Validation fill:#991b1b,stroke:#ef4444,color:#fee2e2
-    style Accounts fill:#0e7490,stroke:#22d3ee,color:#cffafe
     style Users fill:#0e7490,stroke:#22d3ee,color:#cffafe
-    style OAuth fill:#0e7490,stroke:#22d3ee,color:#cffafe
+    style Providers fill:#0e7490,stroke:#22d3ee,color:#cffafe
 ```
 
 ## Core Components
@@ -207,7 +205,7 @@ InsForge supports multiple OAuth providers including Google, GitHub, Microsoft,
 2. **Signature Verification**: Validate with RSA public key
 3. **Expiry Check**: Ensure token hasn't expired
 4. **Issuer/Audience**: Verify iss and aud claims
-5. **User Lookup**: Check user exists in _accounts table
+5. **User Lookup**: Check user exists in auth.users table
 6. **User Status**: Ensure user account is active
 
 ### Middleware Flow
@@ -224,7 +222,7 @@ async function validateToken(token) {
   
   // 2. Check user exists (optional)
   const user = await db.query(
-    'SELECT * FROM _accounts WHERE id = $1',
+    'SELECT * FROM auth.users WHERE id = $1',
     [decoded.sub]
   );