@seaverse/conversation-sdk 0.2.0

package/dist/client/MessagesClient.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessagesClient.d.ts","sourceRoot":"","sources":["../../src/client/MessagesClient.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,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEzC;;OAEG;IACG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAS9E;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAMrD;;OAEG;IACG,GAAG,CACP,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC;IAenB;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC;IAanB;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/client/MessagesClient.js

@@ -0,0 +1,57 @@
+/**
+ * Client for message operations
+ */
+export class MessagesClient {
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * List messages for a conversation
+     */
+    async list(conversationId, options) {
+        const result = await this.db.get('messages', {
+            filter: { conversation_id: `eq.${conversationId}` },
+            order: 'created_at.asc',
+            ...options,
+        });
+        return result.data;
+    }
+    /**
+     * Get a single message by ID
+     */
+    async get(messageId) {
+        return this.db.getOne('messages', {
+            filter: { id: `eq.${messageId}` },
+        });
+    }
+    /**
+     * Add a new message to a conversation
+     */
+    async add(conversationId, data, options) {
+        const results = await this.db.post('messages', {
+            conversation_id: conversationId,
+            ...data,
+        }, {
+            returning: 'representation',
+            ...options,
+        });
+        return results[0];
+    }
+    /**
+     * Update a message
+     */
+    async update(messageId, data, options) {
+        const results = await this.db.patch('messages', { id: `eq.${messageId}` }, data, {
+            returning: 'representation',
+            ...options,
+        });
+        return results[0];
+    }
+    /**
+     * Delete a message
+     */
+    async delete(messageId) {
+        await this.db.delete('messages', { id: `eq.${messageId}` });
+    }
+}
+//# sourceMappingURL=MessagesClient.js.map

package/dist/client/MessagesClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagesClient.js","sourceRoot":"","sources":["../../src/client/MessagesClient.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB,YAA6B,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,cAAsB,EAAE,OAAsB;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAU,UAAU,EAAE;YACpD,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,cAAc,EAAE,EAAE;YACnD,KAAK,EAAE,gBAAgB;YACvB,GAAG,OAAO;SACX,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAU,UAAU,EAAE;YACzC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,SAAS,EAAE,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,cAAsB,EACtB,IAAsB,EACtB,OAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAChC,UAAU,EACV;YACE,eAAe,EAAE,cAAc;YAC/B,GAAG,IAAI;SACR,EACD;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,CACV,SAAiB,EACjB,IAAsB,EACtB,OAAyB;QAEzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACjC,UAAU,EACV,EAAE,EAAE,EAAE,MAAM,SAAS,EAAE,EAAE,EACzB,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,SAAiB;QAC5B,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationsClient } from './ConversationsClient.js';
+export { MessagesClient } from './MessagesClient.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { ConversationsClient } from './ConversationsClient.js';
+export { MessagesClient } from './MessagesClient.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/data/DbClient.d.ts

@@ -0,0 +1,76 @@
+import type { HttpClient } from '../transport/HttpClient.js';
+import type { QueryOptions, MutationOptions } from './query.types.js';
+/**
+ * 带总数的查询结果
+ */
+export interface QueryResultWithCount<T> {
+    data: T[];
+    count: number | null;
+}
+/**
+ * Simple PostgREST database client
+ */
+export declare class DbClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get multiple rows from a table
+     *
+     * @example
+     * const conversations = await db.get('conversations', {
+     *   filter: { user_id: 'eq.123' },
+     *   order: 'created_at.desc',
+     *   limit: 10
+     * });
+     *
+     * @example
+     * // With count
+     * const result = await db.get('conversations', {
+     *   filter: { user_id: 'eq.123' },
+     *   limit: 10,
+     *   count: 'exact'
+     * });
+     * console.log(result.count); // Total count
+     * console.log(result.data); // Page data
+     */
+    get<T = unknown>(table: string, options?: QueryOptions): Promise<QueryResultWithCount<T>>;
+    /**
+     * Get a single row from a table
+     *
+     * @example
+     * const conversation = await db.getOne('conversations', {
+     *   filter: { id: 'eq.123' }
+     * });
+     */
+    getOne<T = unknown>(table: string, options?: QueryOptions): Promise<T | null>;
+    /**
+     * Insert one or more rows into a table
+     *
+     * @example
+     * const newConversation = await db.post('conversations', {
+     *   app_id: 'xxx',
+     *   user_id: 'yyy'
+     * }, {
+     *   returning: 'representation'
+     * });
+     */
+    post<T = unknown>(table: string, data: unknown, options?: MutationOptions): Promise<T[]>;
+    /**
+     * Update rows in a table
+     *
+     * @example
+     * const updated = await db.patch('conversations',
+     *   { id: 'eq.123' },
+     *   { title: 'New Title' }
+     * );
+     */
+    patch<T = unknown>(table: string, filter: Record<string, string>, data: unknown, options?: MutationOptions): Promise<T[]>;
+    /**
+     * Delete rows from a table
+     *
+     * @example
+     * await db.delete('conversations', { id: 'eq.123' });
+     */
+    delete(table: string, filter: Record<string, string>): Promise<void>;
+}
+//# sourceMappingURL=DbClient.d.ts.map

package/dist/data/DbClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbClient.d.ts","sourceRoot":"","sources":["../../src/data/DbClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAyBnC;;;;;;;OAOG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IASpB;;;;;;;;;;OAUG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAQf;;;;;;;;OAQG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IASf;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/data/DbClient.js

@@ -0,0 +1,107 @@
+import { buildPostgrestHeaders, buildQueryString } from './postgrest-headers.js';
+/**
+ * Simple PostgREST database client
+ */
+export class DbClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get multiple rows from a table
+     *
+     * @example
+     * const conversations = await db.get('conversations', {
+     *   filter: { user_id: 'eq.123' },
+     *   order: 'created_at.desc',
+     *   limit: 10
+     * });
+     *
+     * @example
+     * // With count
+     * const result = await db.get('conversations', {
+     *   filter: { user_id: 'eq.123' },
+     *   limit: 10,
+     *   count: 'exact'
+     * });
+     * console.log(result.count); // Total count
+     * console.log(result.data); // Page data
+     */
+    async get(table, options = {}) {
+        const query = buildQueryString(options);
+        const headers = buildPostgrestHeaders(options);
+        const response = await this.http.get(`/${table}${query}`, { headers });
+        // 解析 Content-Range header 获取总数
+        // Format: "0-9/total" or "0-9/*" (if no count requested)
+        let count = null;
+        const contentRange = response.headers.get('Content-Range');
+        if (contentRange && options.count) {
+            const match = contentRange.match(/\/(\d+)$/);
+            if (match) {
+                count = parseInt(match[1], 10);
+            }
+        }
+        return {
+            // PostgREST：当 offset 超出范围时，可能返回 416（Range Not Satisfiable）。
+            // 在这种情况下，上层分页应得到空数组，而不是抛异常。
+            data: response.status === 416 ? [] : response.data,
+            count,
+        };
+    }
+    /**
+     * Get a single row from a table
+     *
+     * @example
+     * const conversation = await db.getOne('conversations', {
+     *   filter: { id: 'eq.123' }
+     * });
+     */
+    async getOne(table, options = {}) {
+        const results = await this.get(table, {
+            ...options,
+            limit: 1,
+        });
+        return results.data[0] || null;
+    }
+    /**
+     * Insert one or more rows into a table
+     *
+     * @example
+     * const newConversation = await db.post('conversations', {
+     *   app_id: 'xxx',
+     *   user_id: 'yyy'
+     * }, {
+     *   returning: 'representation'
+     * });
+     */
+    async post(table, data, options = {}) {
+        const headers = buildPostgrestHeaders(options);
+        const response = await this.http.post(`/${table}`, data, { headers });
+        return response.data;
+    }
+    /**
+     * Update rows in a table
+     *
+     * @example
+     * const updated = await db.patch('conversations',
+     *   { id: 'eq.123' },
+     *   { title: 'New Title' }
+     * );
+     */
+    async patch(table, filter, data, options = {}) {
+        const query = buildQueryString({ filter });
+        const headers = buildPostgrestHeaders(options);
+        const response = await this.http.patch(`/${table}${query}`, data, { headers });
+        return response.data;
+    }
+    /**
+     * Delete rows from a table
+     *
+     * @example
+     * await db.delete('conversations', { id: 'eq.123' });
+     */
+    async delete(table, filter) {
+        const query = buildQueryString({ filter });
+        await this.http.delete(`/${table}${query}`);
+    }
+}
+//# sourceMappingURL=DbClient.js.map

package/dist/data/DbClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DbClient.js","sourceRoot":"","sources":["../../src/data/DbClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAUjF;;GAEG;AACH,MAAM,OAAO,QAAQ;IACnB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,GAAG,CACP,KAAa,EACb,UAAwB,EAAE;QAE1B,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAM,IAAI,KAAK,GAAG,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5E,+BAA+B;QAC/B,yDAAyD;QACzD,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO;YACL,4DAA4D;YAC5D,4BAA4B;YAC5B,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;YAClD,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,UAAwB,EAAE;QAE1B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAI,KAAK,EAAE;YACvC,GAAG,OAAO;YACV,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CACR,KAAa,EACb,IAAa,EACb,UAA2B,EAAE;QAE7B,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAM,IAAI,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3E,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CACT,KAAa,EACb,MAA8B,EAC9B,IAAa,EACb,UAA2B,EAAE;QAE7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAM,IAAI,KAAK,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEpF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,MAA8B;QAE9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/data/index.d.ts

@@ -0,0 +1,2 @@
+export type { QueryOptions, MutationOptions } from './query.types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":""}

package/dist/data/postgrest-headers.d.ts

@@ -0,0 +1,10 @@
+import type { QueryOptions, MutationOptions } from './query.types.js';
+/**
+ * Build PostgREST headers from query options
+ */
+export declare function buildPostgrestHeaders(options?: QueryOptions | MutationOptions): Record<string, string>;
+/**
+ * Build query string from filter options
+ */
+export declare function buildQueryString(options?: QueryOptions): string;
+//# sourceMappingURL=postgrest-headers.d.ts.map

package/dist/data/postgrest-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgrest-headers.d.ts","sourceRoot":"","sources":["../../src/data/postgrest-headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,YAAY,GAAG,eAAoB,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAgCnE"}

package/dist/data/postgrest-headers.js

@@ -0,0 +1,58 @@
+/**
+ * Build PostgREST headers from query options
+ */
+export function buildPostgrestHeaders(options = {}) {
+    const headers = {};
+    // Count preference
+    if ('count' in options && options.count) {
+        headers['Prefer'] = `count=${options.count}`;
+    }
+    // Mutation preferences
+    if ('returning' in options) {
+        const prefer = [];
+        if (options.returning) {
+            prefer.push(`return=${options.returning}`);
+        }
+        if (options.resolution) {
+            prefer.push(`resolution=${options.resolution}`);
+        }
+        if (options.missing) {
+            prefer.push(`missing=${options.missing}`);
+        }
+        if (prefer.length > 0) {
+            headers['Prefer'] = prefer.join(',');
+        }
+    }
+    return headers;
+}
+/**
+ * Build query string from filter options
+ */
+export function buildQueryString(options = {}) {
+    const params = new URLSearchParams();
+    // Select columns
+    if (options.select) {
+        params.set('select', options.select);
+    }
+    // Filters
+    if (options.filter) {
+        for (const [key, value] of Object.entries(options.filter)) {
+            params.set(key, value);
+        }
+    }
+    // Order
+    if (options.order) {
+        params.set('order', options.order);
+    }
+    // Limit
+    if (options.limit !== undefined) {
+        params.set('limit', String(options.limit));
+    }
+    // Offset
+    if (options.offset !== undefined) {
+        params.set('offset', String(options.offset));
+    }
+    const query = params.toString();
+    return query ? `?${query}` : '';
+}
+//# sourceMappingURL=postgrest-headers.js.map

package/dist/data/postgrest-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgrest-headers.js","sourceRoot":"","sources":["../../src/data/postgrest-headers.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA0C,EAAE;IAE5C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,mBAAmB;IACnB,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,uBAAuB;IACvB,IAAI,WAAW,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAwB,EAAE;IACzD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,iBAAiB;IACjB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,QAAQ;IACR,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;IACR,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS;IACT,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/data/query.types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PostgREST query options
+ */
+export interface QueryOptions {
+    /**
+     * Columns to select (default: *)
+     * @example "id,name,created_at"
+     * @example "*,conversations(*)"
+     */
+    select?: string;
+    /**
+     * Filter conditions
+     * @example { id: "eq.123", status: "neq.deleted" }
+     */
+    filter?: Record<string, string>;
+    /**
+     * Order by clause
+     * @example "created_at.desc"
+     * @example "name.asc,created_at.desc"
+     */
+    order?: string;
+    /**
+     * Limit number of results
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: number;
+    /**
+     * Count mode
+     * - "exact": Return exact count in Content-Range header
+     * - "planned": Return estimated count
+     * - "estimated": Return estimated count
+     */
+    count?: 'exact' | 'planned' | 'estimated';
+}
+/**
+ * PostgREST insert/update options
+ */
+export interface MutationOptions {
+    /**
+     * What to return after mutation
+     * - "representation": Return the modified rows
+     * - "minimal": Return nothing
+     * - "headers-only": Return only headers
+     */
+    returning?: 'representation' | 'minimal' | 'headers-only';
+    /**
+     * Resolution strategy for conflicts
+     * - "merge-duplicates": Merge duplicate rows
+     * - "ignore-duplicates": Ignore conflicts
+     */
+    resolution?: 'merge-duplicates' | 'ignore-duplicates';
+    /**
+     * Missing columns
+     * - "default": Use default values
+     * - "null": Use null values
+     */
+    missing?: 'default' | 'null';
+}
+//# sourceMappingURL=query.types.d.ts.map

package/dist/data/query.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.types.d.ts","sourceRoot":"","sources":["../../src/data/query.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,GAAG,cAAc,CAAC;IAE1D;;;;OAIG;IACH,UAAU,CAAC,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;IAEtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B"}

package/dist/data/query.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query.types.js.map

package/dist/data/query.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.types.js","sourceRoot":"","sources":["../../src/data/query.types.ts"],"names":[],"mappings":""}

package/dist/errors/AuthError.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Authentication and authorization errors
+ */
+export declare class AuthError extends BaseError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+//# sourceMappingURL=AuthError.d.ts.map

package/dist/errors/AuthError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthError.d.ts","sourceRoot":"","sources":["../../src/errors/AuthError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,EAAE,OAAO,CAAC,EAAE,OAAO;CAGzE"}

package/dist/errors/AuthError.js

@@ -0,0 +1,10 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Authentication and authorization errors
+ */
+export class AuthError extends BaseError {
+    constructor(message, statusCode = 401, details) {
+        super(message, 'AUTH_ERROR', statusCode, details);
+    }
+}
+//# sourceMappingURL=AuthError.js.map

package/dist/errors/AuthError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthError.js","sourceRoot":"","sources":["../../src/errors/AuthError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC,YAAY,OAAe,EAAE,aAAqB,GAAG,EAAE,OAAiB;QACtE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/errors/BaseError.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Base error class for all SeaLink SDK errors
+ */
+export declare class BaseError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly details?: unknown;
+    constructor(message: string, code: string, statusCode?: number, details?: unknown);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        statusCode: number | undefined;
+        details: unknown;
+    };
+}
+//# sourceMappingURL=BaseError.d.ts.map

package/dist/errors/BaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.d.ts","sourceRoot":"","sources":["../../src/errors/BaseError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO;IAcnB,MAAM;;;;;;;CASP"}

package/dist/errors/BaseError.js

@@ -0,0 +1,26 @@
+/**
+ * Base error class for all SeaLink SDK errors
+ */
+export class BaseError extends Error {
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            details: this.details,
+        };
+    }
+}
+//# sourceMappingURL=BaseError.js.map

package/dist/errors/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.js","sourceRoot":"","sources":["../../src/errors/BaseError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAKlC,YACE,OAAe,EACf,IAAY,EACZ,UAAmB,EACnB,OAAiB;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/errors/NetworkError.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Network-related errors (connection, DNS, etc.)
+ */
+export declare class NetworkError extends BaseError {
+    constructor(message: string, details?: unknown);
+}
+//# sourceMappingURL=NetworkError.d.ts.map

package/dist/errors/NetworkError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkError.d.ts","sourceRoot":"","sources":["../../src/errors/NetworkError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C"}

package/dist/errors/NetworkError.js

@@ -0,0 +1,10 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Network-related errors (connection, DNS, etc.)
+ */
+export class NetworkError extends BaseError {
+    constructor(message, details) {
+        super(message, 'NETWORK_ERROR', undefined, details);
+    }
+}
+//# sourceMappingURL=NetworkError.js.map

package/dist/errors/NetworkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkError.js","sourceRoot":"","sources":["../../src/errors/NetworkError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzC,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/errors/ProtocolError.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Protocol-level errors (invalid response format, etc.)
+ */
+export declare class ProtocolError extends BaseError {
+    constructor(message: string, details?: unknown);
+}
+//# sourceMappingURL=ProtocolError.d.ts.map

package/dist/errors/ProtocolError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolError.d.ts","sourceRoot":"","sources":["../../src/errors/ProtocolError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C"}

package/dist/errors/ProtocolError.js

@@ -0,0 +1,10 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Protocol-level errors (invalid response format, etc.)
+ */
+export class ProtocolError extends BaseError {
+    constructor(message, details) {
+        super(message, 'PROTOCOL_ERROR', undefined, details);
+    }
+}
+//# sourceMappingURL=ProtocolError.js.map

package/dist/errors/ProtocolError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolError.js","sourceRoot":"","sources":["../../src/errors/ProtocolError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/errors/TimeoutError.d.ts

@@ -0,0 +1,8 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Request timeout errors
+ */
+export declare class TimeoutError extends BaseError {
+    constructor(message?: string, timeoutMs?: number);
+}
+//# sourceMappingURL=TimeoutError.d.ts.map

package/dist/errors/TimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutError.d.ts","sourceRoot":"","sources":["../../src/errors/TimeoutError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,GAAE,MAA0B,EAAE,SAAS,CAAC,EAAE,MAAM;CAGpE"}

package/dist/errors/TimeoutError.js

@@ -0,0 +1,10 @@
+import { BaseError } from './BaseError.js';
+/**
+ * Request timeout errors
+ */
+export class TimeoutError extends BaseError {
+    constructor(message = 'Request timeout', timeoutMs) {
+        super(message, 'TIMEOUT_ERROR', 408, { timeoutMs });
+    }
+}
+//# sourceMappingURL=TimeoutError.js.map