@cicctencent/agent-server 0.1.1 → 0.2.0

package/dist/cjs/spi/index.js

@@ -0,0 +1,227 @@
+"use strict";
+// ============================================================
+// SPI 模块导出
+// ============================================================
+/**
+ * # agent-server SPI (Service Provider Interface)
+ *
+ * ## 核心设计原则
+ *
+ * 1. **接口优先**：agent-server 核心只定义能力接口，不依赖具体实现
+ * 2. **参考实现可选**：提供常见框架的参考实现，业务层可选择使用或自己实现
+ * 3. **业务层自主**：完全控制实现细节，不受 agent-server 限制
+ *
+ * ## 使用方式
+ *
+ * ### 方式 1：直接使用参考实现（最简单）
+ *
+ * ```typescript
+ * import { KoaSSEAdapter, createAgentServer } from '@cicctencent/agent-server';
+ *
+ * const server = createAgentServer({ llmProvider: myProvider });
+ *
+ * // MidwayJS/Koa 项目
+ * @Get('/chat/stream')
+ * async chatStream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   await server.runAgentStream(adapter, { content: 'Hello' });
+ * }
+ * ```
+ *
+ * ### 方式 2：实现 SPI 接口（自定义存储）
+ *
+ * ```typescript
+ * import {
+ *   createAgentServer,
+ *   type ChatStoreProvider,
+ *   type BaseThreadEntity,
+ *   type BaseMessageEntity,
+ * } from '@cicctencent/agent-server';
+ *
+ * // 定义你的实体类型（可以自定义字段）
+ * interface MyThread extends BaseThreadEntity {
+ *   userId: string;
+ *   applicationId: number;
+ * }
+ *
+ * // 实现 ChatStoreProvider 接口
+ * class MyChatStore implements ChatStoreProvider<MyThread, MyMessage> {
+ *   async getThreads(userId?: string): Promise<MyThread[]> {
+ *     // 使用任意存储技术：TypeORM / Prisma / Mongoose / ...
+ *     return this.database.query('SELECT * FROM threads WHERE userId = ?', [userId]);
+ *   }
+ *
+ *   // ... 实现其他方法
+ * }
+ *
+ * // 注入自定义实现
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   chatStoreProvider: new MyChatStore(),
+ * });
+ * ```
+ *
+ * ### 方式 3：只使用组件（不使用工厂）
+ *
+ * ```typescript
+ * import {
+ *   KoaSSEAdapter,
+ *   writeSSE,
+ *   createBuiltinTools,
+ *   MemoryService,
+ * } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件，不依赖 createAgentServer
+ * const tools = createBuiltinTools();
+ * const memoryService = new MemoryService('./data');
+ *
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ *
+ * ## 完整文档
+ *
+ * 详见 [README.md](./README.md)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomSSEAdapter = exports.adaptRequest = exports.KoaRequestAdapter = exports.ExpressRequestAdapter = exports.adaptSSE = exports.NativeHttpSSEAdapter = exports.FastifySSEAdapter = exports.KoaSSEAdapter = exports.ExpressSSEAdapter = exports.createInMemoryStorage = exports.createJsonFileStorage = exports.DatabaseListStorage = exports.InMemoryListStorage = exports.InMemoryKVStorage = exports.JsonFileListStorage = exports.JsonFileKVStorage = void 0;
+// ---- 存储适配器（参考实现） ----
+var storage_ts_1 = require("./storage.js");
+// JSON 文件存储（默认实现）
+Object.defineProperty(exports, "JsonFileKVStorage", { enumerable: true, get: function () { return storage_ts_1.JsonFileKVStorage; } });
+Object.defineProperty(exports, "JsonFileListStorage", { enumerable: true, get: function () { return storage_ts_1.JsonFileListStorage; } });
+// 内存存储（测试用）
+Object.defineProperty(exports, "InMemoryKVStorage", { enumerable: true, get: function () { return storage_ts_1.InMemoryKVStorage; } });
+Object.defineProperty(exports, "InMemoryListStorage", { enumerable: true, get: function () { return storage_ts_1.InMemoryListStorage; } });
+// 数据库存储基类（业务层继承）
+Object.defineProperty(exports, "DatabaseListStorage", { enumerable: true, get: function () { return storage_ts_1.DatabaseListStorage; } });
+// 工厂函数
+Object.defineProperty(exports, "createJsonFileStorage", { enumerable: true, get: function () { return storage_ts_1.createJsonFileStorage; } });
+Object.defineProperty(exports, "createInMemoryStorage", { enumerable: true, get: function () { return storage_ts_1.createInMemoryStorage; } });
+// ---- 框架适配器（参考实现） ----
+var adapters_ts_1 = require("./adapters.js");
+// SSE 适配器
+Object.defineProperty(exports, "ExpressSSEAdapter", { enumerable: true, get: function () { return adapters_ts_1.ExpressSSEAdapter; } });
+Object.defineProperty(exports, "KoaSSEAdapter", { enumerable: true, get: function () { return adapters_ts_1.KoaSSEAdapter; } });
+Object.defineProperty(exports, "FastifySSEAdapter", { enumerable: true, get: function () { return adapters_ts_1.FastifySSEAdapter; } });
+Object.defineProperty(exports, "NativeHttpSSEAdapter", { enumerable: true, get: function () { return adapters_ts_1.NativeHttpSSEAdapter; } });
+Object.defineProperty(exports, "adaptSSE", { enumerable: true, get: function () { return adapters_ts_1.adaptSSE; } });
+// 请求适配器
+Object.defineProperty(exports, "ExpressRequestAdapter", { enumerable: true, get: function () { return adapters_ts_1.ExpressRequestAdapter; } });
+Object.defineProperty(exports, "KoaRequestAdapter", { enumerable: true, get: function () { return adapters_ts_1.KoaRequestAdapter; } });
+Object.defineProperty(exports, "adaptRequest", { enumerable: true, get: function () { return adapters_ts_1.adaptRequest; } });
+// 自定义适配器基类
+Object.defineProperty(exports, "CustomSSEAdapter", { enumerable: true, get: function () { return adapters_ts_1.CustomSSEAdapter; } });
+// ============================================================
+// SPI 使用指南
+// ============================================================
+/**
+ * ## SPI 使用示例
+ *
+ * ### 1. 使用默认 JSON 文件存储
+ *
+ * ```typescript
+ * import { createAgentServer } from '@cicctencent/agent-server';
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   dataDir: './data', // 使用默认 JSON 文件存储
+ * });
+ * ```
+ *
+ * ### 2. 自定义存储（数据库）
+ *
+ * ```typescript
+ * import { createAgentServer, DatabaseListStorage, type ChatStoreProvider } from '@cicctencent/agent-server';
+ *
+ * // 实现数据库存储
+ * class TypeORMThreadStorage extends DatabaseListStorage<ThreadEntity> {
+ *   constructor(private repository: Repository<ThreadEntity>) {
+ *     super();
+ *   }
+ *   async list() { return this.repository.find(); }
+ *   async findById(id) { return this.repository.findOne({ where: { id } }); }
+ *   async add(entity) { return this.repository.save(entity); }
+ *   // ...
+ * }
+ *
+ * // 实现 ChatStoreProvider
+ * class TypeORMChatStoreProvider implements ChatStoreProvider {
+ *   constructor(private threadRepo: Repository<ThreadEntity>, private msgRepo: Repository<MessageEntity>) {}
+ *   getThreads() { return this.threadRepo.find(); }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   chatStoreProvider: new TypeORMChatStoreProvider(threadRepo, msgRepo),
+ * });
+ * ```
+ *
+ * ### 3. 自定义框架适配（MidwayJS）
+ *
+ * ```typescript
+ * import { createAgentServer, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * @Provide()
+ * @Scope(ScopeEnum.Singleton)
+ * export class AgentService {
+ *   private server: AgentServer;
+ *
+ *   @Init()
+ *   async init() {
+ *     this.server = createAgentServer({
+ *       llmProvider: await this.createProvider(),
+ *       // 使用 Koa 适配器
+ *       createSSEResponseAdapter: (ctx) => new KoaSSEAdapter(ctx),
+ *     });
+ *   }
+ *
+ *   @Get('/chat/stream')
+ *   async chatStream(@Ctx() ctx: Context) {
+ *     const adapter = new KoaSSEAdapter(ctx);
+ *     await this.server.runAgentStream(adapter, { content: ctx.query.message });
+ *   }
+ * }
+ * ```
+ *
+ * ### 4. 自定义 Prompt 构建
+ *
+ * ```typescript
+ * import { createAgentServer, type PromptBuilderProvider } from '@cicctencent/agent-server';
+ *
+ * class CustomPromptBuilder implements PromptBuilderProvider {
+ *   buildDefaultPrompt(profile, tools, memory) {
+ *     // 自定义 Prompt 构建逻辑
+ *     return `你是一个专业的 BI 分析助手...\n${memory || ''}`;
+ *   }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   promptBuilder: new CustomPromptBuilder(),
+ * });
+ * ```
+ *
+ * ### 5. 组件级使用（不使用工厂）
+ *
+ * ```typescript
+ * import { MemoryService, writeSSE, createBuiltinTools, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件，不依赖 createAgentServer
+ * const memoryService = new MemoryService('./data');
+ * const tools = createBuiltinTools();
+ *
+ * // 在 MidwayJS 中使用 SSE
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ */ 
+//# sourceMappingURL=index.js.map

package/dist/cjs/spi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spi/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;;;AAsCH,wBAAwB;AACxB,2CAesB;AAdpB,kBAAkB;AAClB,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AAEnB,YAAY;AACZ,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AAEnB,iBAAiB;AACjB,iHAAA,mBAAmB,OAAA;AAEnB,OAAO;AACP,mHAAA,qBAAqB,OAAA;AACrB,mHAAA,qBAAqB,OAAA;AAGvB,wBAAwB;AACxB,6CAeuB;AAdrB,UAAU;AACV,gHAAA,iBAAiB,OAAA;AACjB,4GAAA,aAAa,OAAA;AACb,gHAAA,iBAAiB,OAAA;AACjB,mHAAA,oBAAoB,OAAA;AACpB,uGAAA,QAAQ,OAAA;AAER,QAAQ;AACR,oHAAA,qBAAqB,OAAA;AACrB,gHAAA,iBAAiB,OAAA;AACjB,2GAAA,YAAY,OAAA;AAEZ,WAAW;AACX,+GAAA,gBAAgB,OAAA;AAGlB,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG"}

package/dist/cjs/spi/storage.d.ts

@@ -0,0 +1,109 @@
+import type { KVStorageAdapter, ListStorageAdapter, QueryOptions } from './types.js';
+/**
+ * JSON 文件键值存储
+ * 适用于小型应用、本地开发
+ */
+export declare class JsonFileKVStorage implements KVStorageAdapter {
+    private filePath;
+    private cache;
+    constructor(filePath: string);
+    private load;
+    private save;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    keys(prefix?: string): Promise<string[]>;
+    /** 清除缓存（用于重新加载） */
+    clearCache(): void;
+}
+/**
+ * JSON 文件列表存储
+ * 支持实体 CRUD 操作
+ */
+export declare class JsonFileListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    private filePath;
+    private data;
+    constructor(filePath: string);
+    private load;
+    private save;
+    list(): Promise<T[]>;
+    findById(id: number | string): Promise<T | null>;
+    add(entity: T): Promise<T>;
+    update(id: number | string, data: Partial<T>): Promise<T | null>;
+    remove(id: number | string): Promise<boolean>;
+    batch(operations: Array<{
+        type: 'add' | 'update' | 'delete';
+        data: T | Partial<T>;
+        id?: number | string;
+    }>): Promise<void>;
+    /** 获取最大 ID */
+    maxId(): number;
+    /** 清除缓存 */
+    clearCache(): void;
+    /** 获取文件路径 */
+    getPath(): string;
+}
+/**
+ * 内存键值存储
+ * 适用于测试、临时数据
+ */
+export declare class InMemoryKVStorage implements KVStorageAdapter {
+    private data;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    keys(prefix?: string): Promise<string[]>;
+    /** 清空所有数据 */
+    clear(): void;
+}
+/**
+ * 内存列表存储
+ */
+export declare class InMemoryListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    private data;
+    list(): Promise<T[]>;
+    findById(id: number | string): Promise<T | null>;
+    add(entity: T): Promise<T>;
+    update(id: number | string, data: Partial<T>): Promise<T | null>;
+    remove(id: number | string): Promise<boolean>;
+    /** 清空所有数据 */
+    clear(): void;
+}
+/**
+ * 数据库存储基类
+ * 应用层继承并实现具体的数据库操作（TypeORM / Prisma / Sequelize 等）
+ */
+export declare abstract class DatabaseListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    abstract list(): Promise<T[]>;
+    abstract findById(id: number | string): Promise<T | null>;
+    abstract add(entity: T): Promise<T>;
+    abstract update(id: number | string, data: Partial<T>): Promise<T | null>;
+    abstract remove(id: number | string): Promise<boolean>;
+    /** 扩展：带查询条件的列表 */
+    query(options: QueryOptions): Promise<{
+        items: T[];
+        total: number;
+        hasMore: boolean;
+    }>;
+}
+/**
+ * 创建 JSON 文件存储
+ */
+export declare function createJsonFileStorage(filePath: string, type: 'kv' | 'list'): KVStorageAdapter | ListStorageAdapter<{
+    id: number | string;
+}>;
+/**
+ * 创建内存存储
+ */
+export declare function createInMemoryStorage(type: 'kv' | 'list'): KVStorageAdapter | ListStorageAdapter<{
+    id: number | string;
+}>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/cjs/spi/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/spi/storage.ts"],"names":[],"mappings":"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"}

package/dist/cjs/spi/storage.js

@@ -0,0 +1,344 @@
+"use strict";
+// ============================================================
+// 存储适配器实现 — 应用层可替换底层存储
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseListStorage = exports.InMemoryListStorage = exports.InMemoryKVStorage = exports.JsonFileListStorage = exports.JsonFileKVStorage = void 0;
+exports.createJsonFileStorage = createJsonFileStorage;
+exports.createInMemoryStorage = createInMemoryStorage;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================
+// JSON 文件存储（默认实现）
+// ============================================================
+/**
+ * JSON 文件键值存储
+ * 适用于小型应用、本地开发
+ */
+class JsonFileKVStorage {
+    filePath;
+    cache = null;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    load() {
+        if (this.cache)
+            return this.cache;
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const data = JSON.parse(fs.readFileSync(this.filePath, 'utf-8'));
+                this.cache = new Map(Object.entries(data));
+            }
+            else {
+                this.cache = new Map();
+            }
+        }
+        catch {
+            this.cache = new Map();
+        }
+        return this.cache;
+    }
+    save() {
+        if (!this.cache)
+            return;
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.filePath, JSON.stringify(Object.fromEntries(this.cache), null, 2));
+    }
+    async get(key) {
+        const data = this.load();
+        return data.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.load().set(key, value);
+        this.save();
+    }
+    async delete(key) {
+        this.load().delete(key);
+        this.save();
+    }
+    async exists(key) {
+        return this.load().has(key);
+    }
+    async keys(prefix) {
+        const allKeys = Array.from(this.load().keys());
+        if (prefix)
+            return allKeys.filter(k => k.startsWith(prefix));
+        return allKeys;
+    }
+    /** 清除缓存（用于重新加载） */
+    clearCache() {
+        this.cache = null;
+    }
+}
+exports.JsonFileKVStorage = JsonFileKVStorage;
+/**
+ * JSON 文件列表存储
+ * 支持实体 CRUD 操作
+ */
+class JsonFileListStorage {
+    filePath;
+    data = null;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    load() {
+        if (this.data)
+            return this.data;
+        try {
+            if (fs.existsSync(this.filePath)) {
+                this.data = JSON.parse(fs.readFileSync(this.filePath, 'utf-8'));
+            }
+            else {
+                this.data = [];
+            }
+        }
+        catch {
+            this.data = [];
+        }
+        return this.data;
+    }
+    save() {
+        if (!this.data)
+            return;
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.filePath, JSON.stringify(this.data, null, 2));
+    }
+    async list() {
+        return [...this.load()];
+    }
+    async findById(id) {
+        const item = this.load().find(item => item.id === id);
+        return item ?? null;
+    }
+    async add(entity) {
+        this.load().push(entity);
+        this.save();
+        return entity;
+    }
+    async update(id, data) {
+        const items = this.load();
+        const idx = items.findIndex(item => item.id === id);
+        if (idx === -1)
+            return null;
+        items[idx] = { ...items[idx], ...data };
+        this.save();
+        return items[idx];
+    }
+    async remove(id) {
+        const items = this.load();
+        const idx = items.findIndex(item => item.id === id);
+        if (idx === -1)
+            return false;
+        items.splice(idx, 1);
+        this.save();
+        return true;
+    }
+    async batch(operations) {
+        const items = this.load();
+        for (const op of operations) {
+            if (op.type === 'add') {
+                items.push(op.data);
+            }
+            else if (op.type === 'update' && op.id) {
+                const idx = items.findIndex(item => item.id === op.id);
+                if (idx !== -1)
+                    items[idx] = { ...items[idx], ...op.data };
+            }
+            else if (op.type === 'delete' && op.id) {
+                const idx = items.findIndex(item => item.id === op.id);
+                if (idx !== -1)
+                    items.splice(idx, 1);
+            }
+        }
+        this.save();
+    }
+    /** 获取最大 ID */
+    maxId() {
+        const items = this.load();
+        if (items.length === 0)
+            return 0;
+        const ids = items.map(item => typeof item.id === 'number' ? item.id : parseInt(String(item.id), 10) || 0);
+        return Math.max(...ids);
+    }
+    /** 清除缓存 */
+    clearCache() {
+        this.data = null;
+    }
+    /** 获取文件路径 */
+    getPath() {
+        return this.filePath;
+    }
+}
+exports.JsonFileListStorage = JsonFileListStorage;
+// ============================================================
+// 内存存储（测试用）
+// ============================================================
+/**
+ * 内存键值存储
+ * 适用于测试、临时数据
+ */
+class InMemoryKVStorage {
+    data = new Map();
+    async get(key) {
+        return this.data.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.data.set(key, value);
+    }
+    async delete(key) {
+        this.data.delete(key);
+    }
+    async exists(key) {
+        return this.data.has(key);
+    }
+    async keys(prefix) {
+        const allKeys = Array.from(this.data.keys());
+        if (prefix)
+            return allKeys.filter(k => k.startsWith(prefix));
+        return allKeys;
+    }
+    /** 清空所有数据 */
+    clear() {
+        this.data.clear();
+    }
+}
+exports.InMemoryKVStorage = InMemoryKVStorage;
+/**
+ * 内存列表存储
+ */
+class InMemoryListStorage {
+    data = [];
+    async list() {
+        return [...this.data];
+    }
+    async findById(id) {
+        const item = this.data.find(item => item.id === id);
+        return item ?? null;
+    }
+    async add(entity) {
+        this.data.push(entity);
+        return entity;
+    }
+    async update(id, data) {
+        const idx = this.data.findIndex(item => item.id === id);
+        if (idx === -1)
+            return null;
+        this.data[idx] = { ...this.data[idx], ...data };
+        return this.data[idx];
+    }
+    async remove(id) {
+        const idx = this.data.findIndex(item => item.id === id);
+        if (idx === -1)
+            return false;
+        this.data.splice(idx, 1);
+        return true;
+    }
+    /** 清空所有数据 */
+    clear() {
+        this.data = [];
+    }
+}
+exports.InMemoryListStorage = InMemoryListStorage;
+// ============================================================
+// 数据库存储抽象（应用层实现）
+// ============================================================
+/**
+ * 数据库存储基类
+ * 应用层继承并实现具体的数据库操作（TypeORM / Prisma / Sequelize 等）
+ */
+class DatabaseListStorage {
+    /** 扩展：带查询条件的列表 */
+    async query(options) {
+        const all = await this.list();
+        let filtered = all;
+        // 应用过滤器
+        if (options.filter) {
+            filtered = filtered.filter(item => {
+                for (const [key, value] of Object.entries(options.filter)) {
+                    if (item[key] !== value)
+                        return false;
+                }
+                return true;
+            });
+        }
+        // 排序
+        if (options.orderBy) {
+            filtered.sort((a, b) => {
+                const aVal = a[options.orderBy];
+                const bVal = b[options.orderBy];
+                if (aVal < bVal)
+                    return options.orderDirection === 'desc' ? 1 : -1;
+                if (aVal > bVal)
+                    return options.orderDirection === 'desc' ? -1 : 1;
+                return 0;
+            });
+        }
+        // 分页
+        const total = filtered.length;
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? 50;
+        const items = filtered.slice(offset, offset + limit);
+        const hasMore = offset + items.length < total;
+        return { items, total, hasMore };
+    }
+}
+exports.DatabaseListStorage = DatabaseListStorage;
+// ============================================================
+// 存储工厂函数
+// ============================================================
+/**
+ * 创建 JSON 文件存储
+ */
+function createJsonFileStorage(filePath, type) {
+    if (type === 'kv') {
+        return new JsonFileKVStorage(filePath);
+    }
+    return new JsonFileListStorage(filePath);
+}
+/**
+ * 创建内存存储
+ */
+function createInMemoryStorage(type) {
+    if (type === 'kv') {
+        return new InMemoryKVStorage();
+    }
+    return new InMemoryListStorage();
+}
+//# sourceMappingURL=storage.js.map