@seaverse/conversation-sdk 0.2.0

package/README.md

@@ -0,0 +1,284 @@
+# @seaverse/conversation-sdk
+
+SeaVerse Conversation SDK - 用于对话（Conversations）和消息（Messages）管理的函数式 SDK。
+
+## 安装
+
+```bash
+npm install @seaverse/conversation-sdk
+# 或
+pnpm add @seaverse/conversation-sdk
+```
+
+## 快速开始
+
+### 初始化 SDK
+
+```typescript
+import { initConversationSdk } from '@seaverse/conversation-sdk';
+
+const sdk = initConversationSdk({
+  environment: 'prod', // 'dev' | 'prod'
+  token: 'your-access-token'
+});
+```
+
+### 获取 Apps 及其会话列表
+
+```typescript
+// 获取所有 apps,每个 app 返回消息数最多的一个会话
+const result = await sdk.getAppsWithConversationsList({
+  page: 1,
+  pageSize: 20
+});
+
+console.log(result.apps);     // AppWithConversations[]
+console.log(result.hasMore);  // boolean - 是否有下一页
+
+// 获取指定 app
+const appResult = await sdk.getAppsWithConversationsList({
+  appId: 'app-123',
+  page: 1,
+  pageSize: 20
+});
+```
+
+### 获取消息列表
+
+```typescript
+// 获取指定会话的消息列表（倒序,最新的在前）
+const result = await sdk.getMessagesList('conversation-id', {
+  page: 1,
+  pageSize: 50
+});
+
+console.log(result.messages);  // Message[]
+console.log(result.hasMore);   // boolean - 是否有下一页
+```
+
+## API 参考
+
+### initConversationSdk(config)
+
+初始化 Conversation SDK 并返回函数式 API。
+
+**参数**:
+```typescript
+{
+  environment: 'dev' | 'prod';        // 环境配置
+  token: string;                      // 访问令牌
+  getToken?: () => Promise<string>;   // 动态获取令牌（可选）
+  fetch?: typeof fetch;               // 自定义 fetch 实现（可选）
+  timeout?: number;                   // 请求超时时间，默认 30000ms（可选）
+}
+```
+
+**返回**: 包含以下方法的对象
+
+### getAppsWithConversationsList(options?)
+
+获取 Apps 列表,每个 app 只返回消息数最多的那一个会话。
+
+**参数**:
+```typescript
+{
+  appId?: string;      // 可选,按应用 ID 过滤
+  page?: number;       // 页码,默认 1
+  pageSize?: number;   // 每页数量,默认 20
+}
+```
+
+**返回**:
+```typescript
+Promise<{
+  apps: AppWithConversations[];
+  hasMore: boolean;  // 是否有下一页
+}>
+```
+
+### getMessagesList(conversationId, options?)
+
+获取指定会话的消息列表（按时间倒序,最新消息在前）。
+
+**参数**:
+- `conversationId`: `string` - 会话 ID（必需）
+- `options?`: 可选查询选项
+  ```typescript
+  {
+    page?: number;       // 页码,默认 1
+    pageSize?: number;   // 每页数量,默认 100
+  }
+  ```
+
+**返回**:
+```typescript
+Promise<{
+  messages: Message[];
+  hasMore: boolean;  // 是否有下一页
+}>
+```
+
+## 类型定义
+
+### Message
+
+```typescript
+interface Message {
+  id: string;
+  role?: 'user' | 'assistant' | 'system';  // tips 消息无 role
+  content?: string;                         // tips 消息不返回此字段
+  timestamp: number;                        // 秒级时间戳
+  type?: 'text' | 'conversation_tips' | string;
+  tips?: string[];                          // conversation_tips 类型专有
+  toolCalls?: ToolCall[];                   // 工具调用信息
+}
+```
+
+**Tips 消息格式**:
+```typescript
+{
+  id: string;
+  conversation_id: string;  // 仅 tips 消息有此字段
+  timestamp: number;
+  type: "conversation_tips";
+  tips: string[];
+  // 注意: tips 消息没有 content 和 role 字段
+}
+```
+
+### ToolCall
+
+```typescript
+interface ToolCall {
+  id: string;
+  toolName: string;
+  toolInput: Record<string, unknown>;
+  isCompleted: boolean;
+}
+```
+
+### Conversation
+
+```typescript
+interface Conversation {
+  id: string;
+  title: string;
+  appId: string | null;
+  userId: string;
+  createdAt: number;        // 毫秒时间戳
+  updatedAt: number;        // 毫秒时间戳
+  lastActiveAt: number;     // 毫秒时间戳
+  messageCount?: number;    // 消息计数
+}
+```
+
+### AppWithConversations
+
+```typescript
+interface AppWithConversations {
+  app: App;
+  conversations: Conversation[];  // 只有一个元素(消息数最多的会话)
+}
+```
+
+### App
+
+```typescript
+interface App {
+  id: string;
+  name: string;
+  displayName: string;
+  description: string;
+  thumbnailUrls: string[];
+  userName: string;
+  version: string;
+  tags: string[] | null;
+  status: 'draft' | 'published' | 'archived';
+  positiveCount: number;
+  forkCount: number;
+  commentCount: number;
+  createdAt: number;        // 毫秒时间戳
+  updatedAt: number;        // 毫秒时间戳
+}
+```
+
+## 错误处理
+
+SDK 提供了几种错误类型：
+
+```typescript
+import {
+  BaseError,
+  NetworkError,
+  AuthError,
+  TimeoutError,
+  ProtocolError
+} from '@seaverse/conversation-sdk';
+
+try {
+  const result = await sdk.getAppsWithConversationsList();
+} catch (error) {
+  if (error instanceof AuthError) {
+    console.error('认证失败:', error.message);
+  } else if (error instanceof NetworkError) {
+    console.error('网络错误:', error.message);
+  } else if (error instanceof TimeoutError) {
+    console.error('请求超时:', error.message);
+  } else {
+    console.error('未知错误:', error);
+  }
+}
+```
+
+## 完整示例
+
+```typescript
+import { initConversationSdk } from '@seaverse/conversation-sdk';
+
+// 初始化 SDK
+const sdk = initConversationSdk({
+  environment: 'prod',
+  token: 'your-access-token'
+});
+
+// 1. 获取所有 apps 及其热门会话
+const appsResult = await sdk.getAppsWithConversationsList({
+  page: 1,
+  pageSize: 20
+});
+
+console.log('Apps:', appsResult.apps);
+console.log('有下一页:', appsResult.hasMore);
+
+// 2. 获取某个会话的消息
+const conversationId = appsResult.apps[0]?.conversations[0]?.id;
+if (conversationId) {
+  const messagesResult = await sdk.getMessagesList(conversationId, {
+    page: 1,
+    pageSize: 50
+  });
+
+  console.log('消息列表:', messagesResult.messages);
+  console.log('有更多消息:', messagesResult.hasMore);
+
+  // 处理不同类型的消息
+  messagesResult.messages.forEach(msg => {
+    if (msg.type === 'conversation_tips') {
+      console.log('Tips:', msg.tips);
+    } else {
+      console.log('消息:', msg.content);
+    }
+  });
+}
+```
+
+## 环境配置
+
+SDK 会根据 `environment` 参数自动选择对应的服务端点：
+
+- `'dev'`: 开发环境
+- `'prod'`: 生产环境
+
+## 许可证
+
+MIT

package/dist/aggregated/apps-with-conversations.d.ts

@@ -0,0 +1,47 @@
+import type { DbClient } from '../data/DbClient.js';
+import type { ListAppsWithConversationsResult } from '../types/index.js';
+/**
+ * Configuration for aggregated query
+ */
+export interface ListAppsWithConversationsConfig {
+    /**
+     * Optional app ID to filter by
+     */
+    appId?: string;
+    /**
+     * Page number (1-based)
+     * @default 1
+     */
+    page?: number;
+    /**
+     * Page size
+     * @default 20
+     */
+    pageSize?: number;
+    /**
+     * Database client
+     */
+    db: DbClient;
+}
+/**
+ * List apps with their conversations (aggregated query)
+ * Each app returns only ONE conversation - the one with the most messages.
+ *
+ * Implementation: Real-time message counting
+ * - Queries all conversations
+ * - Counts messages for each conversation from messages table
+ * - Selects the conversation with highest message count per app
+ *
+ * This ensures accuracy even if message_count field is not maintained.
+ *
+ * Replaces `/api/apps/with-conversations` endpoint
+ *
+ * @example
+ * const result = await listAppsWithConversations({
+ *   db: dbClient,
+ *   getUrlSessionToken,
+ *   accessToken: 'user-token',
+ * });
+ */
+export declare function listAppsWithConversations(config: ListAppsWithConversationsConfig): Promise<ListAppsWithConversationsResult>;
+//# sourceMappingURL=apps-with-conversations.d.ts.map

package/dist/aggregated/apps-with-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-with-conversations.d.ts","sourceRoot":"","sources":["../../src/aggregated/apps-with-conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAGV,+BAA+B,EAChC,MAAM,mBAAmB,CAAC;AAM3B;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,EAAE,EAAE,QAAQ,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,+BAA+B,CAAC,CA2F1C"}

package/dist/aggregated/apps-with-conversations.js

@@ -0,0 +1,90 @@
+import { transformConversation } from '../transforms/conversation.transform.js';
+import { transformApp } from '../transforms/app.transform.js';
+import { pageToOffset } from '../types/pagination.types.js';
+/**
+ * List apps with their conversations (aggregated query)
+ * Each app returns only ONE conversation - the one with the most messages.
+ *
+ * Implementation: Real-time message counting
+ * - Queries all conversations
+ * - Counts messages for each conversation from messages table
+ * - Selects the conversation with highest message count per app
+ *
+ * This ensures accuracy even if message_count field is not maintained.
+ *
+ * Replaces `/api/apps/with-conversations` endpoint
+ *
+ * @example
+ * const result = await listAppsWithConversations({
+ *   db: dbClient,
+ *   getUrlSessionToken,
+ *   accessToken: 'user-token',
+ * });
+ */
+export async function listAppsWithConversations(config) {
+    const { appId, page = 1, pageSize = 20, db, } = config;
+    // Calculate pagination params
+    const { limit, offset } = pageToOffset(page, pageSize);
+    // Parallel requests to avoid waterfall
+    const [dbApps, dbConversations] = await Promise.all([
+        // Get apps with pagination
+        db.get('apps', appId
+            ? { filter: { app_id: `eq.${appId}` }, limit, offset, count: 'exact' }
+            : { limit, offset, count: 'exact' }),
+        // Get conversations (all conversations to find max message_count per app)
+        db.get('conversations', appId ? { filter: { app_id: `eq.${appId}` } } : {}),
+    ]);
+    // Extract all conversation IDs for message counting
+    const conversationIds = dbConversations.data
+        .map((conv) => conv.conversation_id || conv.id)
+        .filter(Boolean);
+    // Fetch all messages for these conversations and count them
+    let realMessageCounts = new Map();
+    if (conversationIds.length > 0) {
+        // Query all messages for these conversations
+        const dbMessages = await db.get('messages', {
+            filter: { conversation_id: `in.(${conversationIds.join(',')})` },
+            select: 'conversation_id',
+        });
+        // Count messages per conversation
+        for (const msg of dbMessages.data) {
+            const count = realMessageCounts.get(msg.conversation_id) || 0;
+            realMessageCounts.set(msg.conversation_id, count + 1);
+        }
+    }
+    // Group conversations by appId and select the one with highest REAL message count
+    const topConversationByAppId = new Map();
+    for (const dbConv of dbConversations.data) {
+        const conv = transformConversation(dbConv);
+        const convId = dbConv.conversation_id || dbConv.id;
+        // Use real message count instead of db field
+        const realCount = realMessageCounts.get(convId) || 0;
+        // Only process conversations with appId (skip global conversations)
+        if (conv.appId) {
+            const existing = topConversationByAppId.get(conv.appId);
+            const existingCount = existing?.messageCount || 0;
+            // Only keep the conversation with highest REAL message count
+            if (!existing || realCount > existingCount) {
+                // Update messageCount with real count
+                conv.messageCount = realCount;
+                topConversationByAppId.set(conv.appId, conv);
+            }
+        }
+    }
+    // Build response (each app has at most 1 conversation - the one with highest message_count)
+    const appsWithConversations = dbApps.data.map((dbApp) => {
+        const topConv = topConversationByAppId.get((dbApp.app_id || dbApp.id));
+        return {
+            app: transformApp(dbApp),
+            conversations: topConv ? [topConv] : [],
+        };
+    });
+    // Calculate hasMore (是否还有下一页)
+    const total = dbApps.count || 0;
+    const hasMore = page * pageSize < total;
+    return {
+        apps: appsWithConversations,
+        hasMore,
+    };
+}
+//# sourceMappingURL=apps-with-conversations.js.map

package/dist/aggregated/apps-with-conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-with-conversations.js","sourceRoot":"","sources":["../../src/aggregated/apps-with-conversations.ts"],"names":[],"mappings":"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"}

package/dist/aggregated/index.d.ts

@@ -0,0 +1,3 @@
+export { listAppsWithConversations } from './apps-with-conversations.js';
+export type { ListAppsWithConversationsConfig } from './apps-with-conversations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/aggregated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregated/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/aggregated/index.js

@@ -0,0 +1,2 @@
+export { listAppsWithConversations } from './apps-with-conversations.js';
+//# sourceMappingURL=index.js.map

package/dist/aggregated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aggregated/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/client/ConversationClient.d.ts

@@ -0,0 +1,24 @@
+import type { ConversationClientConfig } from '../types/config.types.js';
+import { ConversationsResource } from '../resources/ConversationsResource.js';
+import { MessagesResource } from '../resources/MessagesResource.js';
+import { AppsResource } from '../resources/AppsResource.js';
+/**
+ * Conversation SDK 客户端
+ */
+export declare class ConversationClient {
+    private readonly config;
+    private readonly db;
+    readonly conversations: ConversationsResource;
+    readonly messages: MessagesResource;
+    readonly apps: AppsResource;
+    constructor(config: ConversationClientConfig);
+    /**
+     * 获取 URL session token
+     */
+    getUrlSessionToken(): Promise<string | null>;
+}
+/**
+ * 创建 Conversation SDK 客户端（工厂函数）
+ */
+export declare function createClient(config: ConversationClientConfig): ConversationClient;
+//# sourceMappingURL=ConversationClient.d.ts.map

package/dist/client/ConversationClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationClient.d.ts","sourceRoot":"","sources":["../../src/client/ConversationClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IACF,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAG9B,SAAgB,aAAa,EAAE,qBAAqB,CAAC;IACrD,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAC3C,SAAgB,IAAI,EAAE,YAAY,CAAC;gBAEvB,MAAM,EAAE,wBAAwB;IA6B5C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAUnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAEjF"}

package/dist/client/ConversationClient.js

@@ -0,0 +1,56 @@
+import { createHttpClient } from '../transport/index.js';
+import { DbClient } from '../data/DbClient.js';
+import { getUrlSessionToken as getToken } from '../session/session-token.js';
+import { getEnvironmentConfig } from './EnvironmentConfig.js';
+import { ConversationsResource } from '../resources/ConversationsResource.js';
+import { MessagesResource } from '../resources/MessagesResource.js';
+import { AppsResource } from '../resources/AppsResource.js';
+/**
+ * Conversation SDK 客户端
+ */
+export class ConversationClient {
+    constructor(config) {
+        // 环境配置解析
+        const envConfig = getEnvironmentConfig(config.environment);
+        this.config = {
+            environment: config.environment,
+            token: config.token,
+            getToken: config.getToken || (() => config.token),
+            fetch: config.fetch || globalThis.fetch,
+            timeout: config.timeout || 30000,
+            urls: envConfig,
+        };
+        // 创建底层客户端
+        const http = createHttpClient({
+            baseUrl: this.config.urls.postgrest,
+            fetch: this.config.fetch,
+            getAuthToken: this.config.getToken,
+            timeoutMs: this.config.timeout,
+        });
+        this.db = new DbClient(http);
+        // 初始化资源
+        this.conversations = new ConversationsResource(this.db);
+        this.messages = new MessagesResource(this.db);
+        this.apps = new AppsResource(this.db);
+    }
+    /**
+     * 获取 URL session token
+     */
+    async getUrlSessionToken() {
+        const token = await this.config.getToken();
+        if (!token)
+            return null;
+        return getToken({
+            authBaseUrl: this.config.urls.auth,
+            accessToken: token,
+            fetch: this.config.fetch,
+        });
+    }
+}
+/**
+ * 创建 Conversation SDK 客户端（工厂函数）
+ */
+export function createClient(config) {
+    return new ConversationClient(config);
+}
+//# sourceMappingURL=ConversationClient.js.map

package/dist/client/ConversationClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationClient.js","sourceRoot":"","sources":["../../src/client/ConversationClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAW7B,YAAY,MAAgC;QAC1C,SAAS;QACT,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE3D,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,IAAI,EAAE,SAAS;SAChB,CAAC;QAEF,UAAU;QACV,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;YACnC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAClC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE7B,QAAQ;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,OAAO,QAAQ,CAAC;YACd,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YAClC,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/client/ConversationsClient.d.ts

@@ -0,0 +1,31 @@
+import type { DbClient } from '../data/DbClient.js';
+import type { QueryOptions, MutationOptions } from '../data/query.types.js';
+import type { Conversation } from '../types/index.js';
+/**
+ * Client for conversation operations
+ */
+export declare class ConversationsClient {
+    private readonly db;
+    constructor(db: DbClient);
+    /**
+     * List conversations
+     */
+    list(options?: QueryOptions): Promise<Conversation[]>;
+    /**
+     * Get a single conversation by ID
+     */
+    get(id: string): Promise<Conversation | null>;
+    /**
+     * Create a new conversation
+     */
+    create(data: Partial<Conversation>, options?: MutationOptions): Promise<Conversation>;
+    /**
+     * Update a conversation
+     */
+    update(id: string, data: Partial<Conversation>, options?: MutationOptions): Promise<Conversation>;
+    /**
+     * Delete a conversation
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=ConversationsClient.d.ts.map

package/dist/client/ConversationsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationsClient.d.ts","sourceRoot":"","sources":["../../src/client/ConversationsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK3D;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMnD;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC;IAQxB;;OAEG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC;IAaxB;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/client/ConversationsClient.js

@@ -0,0 +1,50 @@
+/**
+ * Client for conversation operations
+ */
+export class ConversationsClient {
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * List conversations
+     */
+    async list(options) {
+        const result = await this.db.get('conversations', options);
+        return result.data;
+    }
+    /**
+     * Get a single conversation by ID
+     */
+    async get(id) {
+        return this.db.getOne('conversations', {
+            filter: { id: `eq.${id}` },
+        });
+    }
+    /**
+     * Create a new conversation
+     */
+    async create(data, options) {
+        const results = await this.db.post('conversations', data, {
+            returning: 'representation',
+            ...options,
+        });
+        return results[0];
+    }
+    /**
+     * Update a conversation
+     */
+    async update(id, data, options) {
+        const results = await this.db.patch('conversations', { id: `eq.${id}` }, data, {
+            returning: 'representation',
+            ...options,
+        });
+        return results[0];
+    }
+    /**
+     * Delete a conversation
+     */
+    async delete(id) {
+        await this.db.delete('conversations', { id: `eq.${id}` });
+    }
+}
+//# sourceMappingURL=ConversationsClient.js.map

package/dist/client/ConversationsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationsClient.js","sourceRoot":"","sources":["../../src/client/ConversationsClient.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YAA6B,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAsB;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAe,eAAe,EAAE,OAAO,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAe,eAAe,EAAE;YACnD,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,IAA2B,EAC3B,OAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAe,eAAe,EAAE,IAAI,EAAE;YACtE,SAAS,EAAE,gBAAgB;YAC3B,GAAG,OAAO;SACX,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,EAAU,EACV,IAA2B,EAC3B,OAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACjC,eAAe,EACf,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAClB,IAAI,EACJ;YACE,SAAS,EAAE,gBAAgB;YAC3B,GAAG,OAAO;SACX,CACF,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/client/EnvironmentConfig.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 环境 URL 配置
+ */
+export interface EnvironmentUrls {
+    postgrest: string;
+    auth: string;
+}
+/**
+ * 获取环境配置
+ */
+export declare function getEnvironmentConfig(env: 'dev' | 'prod'): EnvironmentUrls;
+//# sourceMappingURL=EnvironmentConfig.d.ts.map

package/dist/client/EnvironmentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentConfig.d.ts","sourceRoot":"","sources":["../../src/client/EnvironmentConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,GAAG,eAAe,CAEzE"}

package/dist/client/EnvironmentConfig.js

@@ -0,0 +1,21 @@
+/**
+ * 环境配置映射
+ */
+const ENV_CONFIGS = {
+    dev: {
+        // 开发/测试环境：用于浏览器联调的 PostgREST / Auth
+        postgrest: 'https://postgrest.sg.seaverse.dev',
+        auth: 'https://auth.sg.seaverse.dev',
+    },
+    prod: {
+        postgrest: 'https://db.seaverse.ai',
+        auth: 'https://auth.sg.seaverse.dev',
+    },
+};
+/**
+ * 获取环境配置
+ */
+export function getEnvironmentConfig(env) {
+    return ENV_CONFIGS[env];
+}
+//# sourceMappingURL=EnvironmentConfig.js.map

package/dist/client/EnvironmentConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentConfig.js","sourceRoot":"","sources":["../../src/client/EnvironmentConfig.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,GAA4C;IAC3D,GAAG,EAAE;QACH,oCAAoC;QACpC,SAAS,EAAE,mCAAmC;QAC9C,IAAI,EAAE,8BAA8B;KACrC;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,wBAAwB;QACnC,IAAI,EAAE,8BAA8B;KACrC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAmB;IACtD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}