> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# InsForge TypeScript 和 JavaScript SDK

> 在 Node、浏览器和边缘运行时中安装和初始化官方 InsForge TypeScript SDK，以使用身份验证、数据库、存储和实时功能。

InsForge TypeScript SDK 为 JavaScript 和 TypeScript 应用程序提供了一个类型安全的客户端，用于与 InsForge 服务交互。

## 安装

<CodeGroup>
  ```bash npm theme={null}
  npm install @insforge/sdk@latest
  ```

  ```bash yarn theme={null}
  yarn add @insforge/sdk@latest
  ```

  ```bash pnpm theme={null}
  pnpm add @insforge/sdk@latest
  ```
</CodeGroup>

```javascript theme={null}
import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-app.insforge.app',
  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
});
```

Find the anon key with `npx @insforge/cli secrets get ANON_KEY`, or in the dashboard: click **Install** and open **API Keys**.

## 快速开始

```typescript theme={null}
import { createClient } from '@insforge/sdk';

const insforge = createClient({
  baseUrl: 'https://your-app.insforge.app',
  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
});
```

## 功能

* **Database** - 使用 PostgREST 进行类型安全的 CRUD 操作
* **Authentication** - 电子邮件/密码和 OAuth 身份验证
* **Storage** - 文件上传、下载和管理
* **Functions** - 调用无服务器边缘函数
* **AI** - 聊天完成和图像生成
* **Realtime** - 基于 WebSocket 的 pub/sub 消息传递
* **Payments** - 提供商特定的 Stripe 和 Razorpay 支付助手

## SDK 参考

<CardGroup cols={2}>
  <Card title="数据库" icon="database" href="/sdks/typescript/database">
    CRUD 操作、筛选和查询
  </Card>

  <Card title="身份验证" icon="lock" href="/sdks/typescript/auth">
    注册、登录、OAuth 和用户管理
  </Card>

  <Card title="存储" icon="cloud-arrow-up" href="/sdks/typescript/storage">
    文件上传、下载和管理
  </Card>

  <Card title="函数" icon="bolt" href="/sdks/typescript/functions">
    调用无服务器边缘函数
  </Card>

  <Card title="AI" icon="brain" href="/sdks/typescript/ai">
    聊天完成和图像生成
  </Card>

  <Card title="实时" icon="signal-stream" href="/sdks/typescript/realtime">
    WebSocket pub/sub 消息传递
  </Card>

  <Card title="支付" icon="credit-card" href="/sdks/typescript/payments">
    提供商特定的 Stripe 和 Razorpay 支付助手
  </Card>
</CardGroup>