@yanit/jsondb 0.1.1

package/dist/src/Collection.d.ts

@@ -0,0 +1,232 @@
+/**
+ * 集合类 - 管理文档集合
+ * 支持 async/await 异步操作
+ * 支持 JSONB 二进制存储模式
+ * 支持 Schema 验证
+ * 支持内存缓存优化
+ */
+import { Cursor } from './Cursor.js';
+import type { Database } from './Database.js';
+import type { Schema } from './Schema.js';
+import type { SQLExecutionResult } from './SQLExecutor.js';
+/**
+ * 集合统计信息接口
+ */
+interface CollectionStats {
+    ns: string;
+    count: number;
+    size: number;
+    avgObjSize: number;
+    indexes: number;
+    jsonb: boolean;
+}
+/**
+ * 索引信息接口
+ */
+export interface IndexInfo {
+    key: Record<string, number>;
+    name: string;
+    unique: boolean;
+}
+/**
+ * 集合数据接口
+ */
+interface CollectionData {
+    _meta: {
+        name: string;
+        count: number;
+        indexes: IndexInfo[];
+    };
+    _documents: Array<Record<string, unknown>>;
+    _indexes: Record<string, Record<string, string[]>>;
+}
+/**
+ * Collection 类
+ * 表示一个文档集合，提供 CRUD 操作
+ */
+export declare class Collection {
+    db: Database;
+    name: string;
+    private _filePath;
+    _data: CollectionData | null;
+    private _lock;
+    jsonb: boolean;
+    private _schema;
+    _validateOnInsert: boolean;
+    _validateOnUpdate: boolean;
+    _cache: CollectionData | null;
+    _cacheTime: number;
+    private _cacheTTL;
+    private _dirty;
+    /**
+     * @param db - 数据库实例
+     * @param name - 集合名称
+     */
+    constructor(db: Database, name: string);
+    /**
+     * 设置 Schema
+     */
+    setSchema(schema: Schema, options?: {
+        validateOnInsert?: boolean;
+        validateOnUpdate?: boolean;
+    }): Collection;
+    /**
+     * 获取 Schema
+     */
+    getSchema(): Schema | null;
+    /**
+     * 验证文档
+     */
+    _validate(doc: Record<string, unknown>): void;
+    /**
+     * 加载集合数据（带缓存）
+     */
+    _load(): Promise<void>;
+    /**
+     * 保存集合数据（带缓存失效）
+     */
+    _save(): Promise<void>;
+    /**
+     * JSONB 编码 - 将数据编码为二进制 Buffer
+     */
+    _encodeJsonb(): Buffer;
+    /**
+     * JSONB 解码 - 将二进制 Buffer 解码为数据
+     */
+    _decodeJsonb(buffer: Buffer): CollectionData;
+    /**
+     * 获取锁
+     */
+    _acquireLock(): Promise<void>;
+    /**
+     * 释放锁
+     */
+    _releaseLock(): void;
+    /**
+     * 获取所有文档
+     */
+    _getDocuments(): Promise<Array<Record<string, unknown>>>;
+    /**
+     * 插入单个文档
+     */
+    insertOne(doc: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * 插入多个文档（优化版 - 单次写入）
+     */
+    insertMany(docs: Array<Record<string, unknown>>, options?: Record<string, unknown>): Promise<{
+        acknowledged: boolean;
+        insertedCount: number;
+        insertedIds: Record<number, string>;
+    }>;
+    /**
+     * 更新索引
+     */
+    private _updateIndexes;
+    /**
+     * 查询文档
+     */
+    find(query?: Record<string, unknown>, options?: Record<string, unknown>): Cursor;
+    /**
+     * 查询单个文档
+     */
+    findOne(query?: Record<string, unknown>, options?: Record<string, unknown>): Promise<Record<string, unknown> | null>;
+    /**
+     * 更新单个文档
+     */
+    updateOne(query: Record<string, unknown>, update: Record<string, unknown>, options?: {
+        upsert?: boolean;
+    }): Promise<{
+        acknowledged: boolean;
+        matchedCount: number;
+        modifiedCount: number;
+        upsertedId?: string;
+    }>;
+    /**
+     * 更新多个文档
+     */
+    updateMany(query: Record<string, unknown>, update: Record<string, unknown>, options?: {
+        upsert?: boolean;
+    }): Promise<{
+        acknowledged: boolean;
+        matchedCount: number;
+        modifiedCount: number;
+        upsertedId?: string;
+    }>;
+    /**
+     * 替换单个文档
+     */
+    replaceOne(query: Record<string, unknown>, doc: Record<string, unknown>, options?: {
+        upsert?: boolean;
+    }): Promise<{
+        acknowledged: boolean;
+        matchedCount: number;
+        modifiedCount: number;
+        upsertedId?: string;
+    }>;
+    /**
+     * 删除单个文档
+     */
+    deleteOne(query: Record<string, unknown>): Promise<{
+        acknowledged: boolean;
+        deletedCount: number;
+    }>;
+    /**
+     * 删除多个文档
+     */
+    deleteMany(query: Record<string, unknown>): Promise<{
+        acknowledged: boolean;
+        deletedCount: number;
+    }>;
+    /**
+     * 计数文档
+     */
+    countDocuments(query?: Record<string, unknown>): Promise<number>;
+    /**
+     * 获取不同值
+     */
+    distinct(key: string, query?: Record<string, unknown>): Promise<unknown[]>;
+    /**
+     * 聚合查询
+     */
+    aggregate(pipeline: Array<Record<string, unknown>>): Promise<Array<Record<string, unknown>>>;
+    /**
+     * 应用聚合阶段
+     */
+    private _applyAggregationStage;
+    /**
+     * 应用分组
+     */
+    private _applyGroup;
+    /**
+     * 创建索引
+     */
+    createIndex(keys: Record<string, number>, options?: {
+        unique?: boolean;
+    }): Promise<IndexInfo>;
+    /**
+     * 构建索引数据
+     */
+    private _buildIndex;
+    /**
+     * 删除索引
+     */
+    dropIndex(name: string): Promise<{
+        acknowledged: boolean;
+    }>;
+    /**
+     * 列出所有索引
+     */
+    listIndexes(): Promise<IndexInfo[]>;
+    /**
+     * 获取集合统计信息
+     */
+    stats(): Promise<CollectionStats>;
+    /**
+     * 执行 SQL 语句
+     * @param sql - SQL 语句
+     * @returns SQL 执行结果
+     */
+    sql(sqlStr: string): Promise<SQLExecutionResult>;
+}
+export {};
+//# sourceMappingURL=Collection.d.ts.map

package/dist/src/Collection.d.ts.map

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