@yanit/jsondb 0.1.1

package/dist/src/Schema.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Schema 验证模块
+ * 提供数据验证功能
+ */
+/**
+ * 验证结果接口
+ */
+interface ValidationResult {
+    valid: boolean;
+    message?: string;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Schema 选项接口
+ */
+interface SchemaOptions {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    enum?: string[];
+    values?: string[];
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    items?: SchemaDefinition;
+    properties?: Record<string, SchemaDefinition>;
+    validate?: (value: unknown) => boolean | string;
+    default?: unknown;
+    strict?: boolean;
+    _additional?: boolean;
+    type?: string;
+}
+/**
+ * Schema 定义接口
+ */
+interface SchemaDefinition {
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * 验证器类型
+ */
+export declare const validators: Record<string, (value: unknown, options?: SchemaOptions) => ValidationResult>;
+/**
+ * Schema 类
+ */
+export declare class Schema {
+    properties: Record<string, SchemaDefinition>;
+    options: {
+        strict: boolean;
+        [key: string]: unknown;
+    };
+    constructor(properties: Record<string, SchemaDefinition>, options?: {
+        strict?: boolean;
+        [key: string]: unknown;
+    });
+    /**
+     * 验证对象
+     */
+    validate(obj: Record<string, unknown>): ValidationResult;
+    /**
+     * 验证并抛出异常
+     */
+    validateOrThrow(obj: Record<string, unknown>): void;
+    /**
+     * 清理对象（移除额外字段）
+     */
+    sanitize(obj: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * 应用默认值
+     */
+    applyDefaults(obj: Record<string, unknown>): Record<string, unknown>;
+}
+/**
+ * 创建 Schema
+ */
+export declare function createSchema(properties: Record<string, SchemaDefinition>, options?: {
+    strict?: boolean;
+    [key: string]: unknown;
+}): Schema;
+/**
+ * 验证中间件工厂
+ */
+export declare function createValidator(schema: Schema): (doc: Record<string, unknown>) => Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=Schema.d.ts.map

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

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

package/dist/src/Schema.js

@@ -0,0 +1,253 @@
+/**
+ * Schema 验证模块
+ * 提供数据验证功能
+ */
+/**
+ * 验证器类型
+ */
+export const validators = {
+    /**
+     * 字符串验证
+     */
+    string: (value, options = {}) => {
+        if (typeof value !== 'string') {
+            return { valid: false, message: '必须是字符串' };
+        }
+        if (options.minLength && value.length < options.minLength) {
+            return { valid: false, message: `最小长度为 ${options.minLength}` };
+        }
+        if (options.maxLength && value.length > options.maxLength) {
+            return { valid: false, message: `最大长度为 ${options.maxLength}` };
+        }
+        if (options.pattern && !options.pattern.test(value)) {
+            return { valid: false, message: '格式不匹配' };
+        }
+        if (options.enum && !options.enum.includes(value)) {
+            return { valid: false, message: '值不在枚举列表中' };
+        }
+        return { valid: true };
+    },
+    /**
+     * 数字验证
+     */
+    number: (value, options = {}) => {
+        if (typeof value !== 'number') {
+            return { valid: false, message: '必须是数字' };
+        }
+        if (options.min !== undefined && value < options.min) {
+            return { valid: false, message: `最小值为 ${options.min}` };
+        }
+        if (options.max !== undefined && value > options.max) {
+            return { valid: false, message: `最大值为 ${options.max}` };
+        }
+        if (options.integer && !Number.isInteger(value)) {
+            return { valid: false, message: '必须是整数' };
+        }
+        return { valid: true };
+    },
+    /**
+     * 布尔值验证
+     */
+    boolean: (value) => {
+        if (typeof value !== 'boolean') {
+            return { valid: false, message: '必须是布尔值' };
+        }
+        return { valid: true };
+    },
+    /**
+     * 日期验证
+     */
+    date: (value) => {
+        if (!(value instanceof Date) || isNaN(value.getTime())) {
+            return { valid: false, message: '必须是有效的日期' };
+        }
+        return { valid: true };
+    },
+    /**
+     * 数组验证
+     */
+    array: (value, options = {}) => {
+        if (!Array.isArray(value)) {
+            return { valid: false, message: '必须是数组' };
+        }
+        if (options.minLength && value.length < options.minLength) {
+            return { valid: false, message: `最小长度为 ${options.minLength}` };
+        }
+        if (options.maxLength && value.length > options.maxLength) {
+            return { valid: false, message: `最大长度为 ${options.maxLength}` };
+        }
+        if (options.items) {
+            for (let i = 0; i < value.length; i++) {
+                const result = validateValue(value[i], options.items);
+                if (!result.valid) {
+                    return { valid: false, message: `索引 ${i}: ${result.message}` };
+                }
+            }
+        }
+        return { valid: true };
+    },
+    /**
+     * 对象验证
+     */
+    object: (value, options = {}) => {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return { valid: false, message: '必须是对象' };
+        }
+        if (options.properties) {
+            return validateObject(value, options.properties);
+        }
+        return { valid: true };
+    },
+    /**
+     * 枚举验证
+     */
+    enum: (value, options = {}) => {
+        if (!options.values || !options.values.includes(value)) {
+            return { valid: false, message: '值不在允许的列表中' };
+        }
+        return { valid: true };
+    },
+    /**
+     * 自定义验证
+     */
+    custom: (value, options = {}) => {
+        if (typeof options.validate !== 'function') {
+            return { valid: false, message: '验证函数无效' };
+        }
+        try {
+            const result = options.validate(value);
+            return result === true ? { valid: true } : { valid: false, message: result || '验证失败' };
+        }
+        catch (e) {
+            return { valid: false, message: e.message };
+        }
+    }
+};
+/**
+ * 验证单个值
+ */
+function validateValue(value, schema) {
+    if (!schema || !schema.type) {
+        return { valid: true };
+    }
+    const validator = validators[schema.type];
+    if (!validator) {
+        return { valid: false, message: `未知的类型：${schema.type}` };
+    }
+    // 检查是否允许 null
+    if (value === null || value === undefined) {
+        if (schema.required) {
+            return { valid: false, message: '此字段不能为空' };
+        }
+        return { valid: true };
+    }
+    return validator(value, schema);
+}
+/**
+ * 验证对象
+ */
+function validateObject(obj, properties) {
+    const errors = [];
+    // 检查必填字段
+    for (const [key, schema] of Object.entries(properties)) {
+        if (schema.required && (obj[key] === undefined || obj[key] === null)) {
+            errors.push({ field: key, message: '此字段不能为空' });
+            continue;
+        }
+        if (obj[key] !== undefined && obj[key] !== null) {
+            const result = validateValue(obj[key], schema);
+            if (!result.valid) {
+                errors.push({ field: key, message: result.message });
+            }
+        }
+    }
+    // 检查额外字段
+    if (properties._additional === false) {
+        const allowedKeys = Object.keys(properties);
+        for (const key of Object.keys(obj)) {
+            if (!allowedKeys.includes(key)) {
+                errors.push({ field: key, message: '不允许的字段' });
+            }
+        }
+    }
+    return errors.length === 0
+        ? { valid: true }
+        : { valid: false, errors };
+}
+/**
+ * Schema 类
+ */
+export class Schema {
+    properties;
+    options;
+    constructor(properties, options = {}) {
+        this.properties = properties;
+        this.options = {
+            strict: options.strict || false,
+            ...options
+        };
+    }
+    /**
+     * 验证对象
+     */
+    validate(obj) {
+        if (this.options.strict) {
+            this.properties._additional = false;
+        }
+        return validateObject(obj, this.properties);
+    }
+    /**
+     * 验证并抛出异常
+     */
+    validateOrThrow(obj) {
+        const result = this.validate(obj);
+        if (!result.valid) {
+            const error = new Error(`验证失败：${result.errors.map(e => `${e.field}: ${e.message}`).join(', ')}`);
+            error.errors = result.errors;
+            throw error;
+        }
+    }
+    /**
+     * 清理对象（移除额外字段）
+     */
+    sanitize(obj) {
+        const result = {};
+        for (const key of Object.keys(this.properties)) {
+            if (obj[key] !== undefined) {
+                result[key] = obj[key];
+            }
+        }
+        return result;
+    }
+    /**
+     * 应用默认值
+     */
+    applyDefaults(obj) {
+        const result = { ...obj };
+        for (const [key, schema] of Object.entries(this.properties)) {
+            if (result[key] === undefined && schema.default !== undefined) {
+                result[key] = schema.default;
+            }
+        }
+        return result;
+    }
+}
+/**
+ * 创建 Schema
+ */
+export function createSchema(properties, options) {
+    return new Schema(properties, options);
+}
+/**
+ * 验证中间件工厂
+ */
+export function createValidator(schema) {
+    return async (doc) => {
+        const result = schema.validate(doc);
+        if (!result.valid) {
+            throw new Error(`验证失败：${result.errors.map(e => `${e.field}: ${e.message}`).join(', ')}`);
+        }
+        return doc;
+    };
+}
+//# sourceMappingURL=Schema.js.map

package/dist/src/Schema.js.map

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

package/dist/src/Transaction.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 简单事务模块
+ * 提供多操作的原子性保证
+ */
+import type { Collection } from './Collection.js';
+/**
+ * 事务状态
+ */
+export declare const TransactionStatus: {
+    ACTIVE: string;
+    COMMITTED: string;
+    ROLLED_BACK: string;
+    FAILED: string;
+};
+/**
+ * 操作类型
+ */
+export declare const OperationType: {
+    INSERT: string;
+    UPDATE: string;
+    DELETE: string;
+};
+/**
+ * 事务状态类型
+ */
+export type TransactionStatusType = typeof TransactionStatus[keyof typeof TransactionStatus];
+/**
+ * 操作类型类型
+ */
+export type OperationTypeType = typeof OperationType[keyof typeof OperationType];
+/**
+ * 数据备份接口
+ */
+interface DataBackup {
+    documents: Array<Record<string, unknown>>;
+    indexes: Record<string, unknown>;
+    meta: Record<string, unknown>;
+}
+/**
+ * 操作接口
+ */
+interface Operation {
+    type: OperationTypeType;
+    collection: Collection;
+    docs?: Array<Record<string, unknown>>;
+    query?: Record<string, unknown>;
+    update?: Record<string, unknown>;
+    options?: Record<string, unknown>;
+}
+/**
+ * 事务类
+ */
+export declare class Transaction {
+    collections: Collection[];
+    operations: Operation[];
+    status: TransactionStatusType;
+    backup: Map<string, DataBackup>;
+    results: Array<Record<string, unknown>>;
+    constructor(collections: Collection | Collection[]);
+    /**
+     * 备份集合数据
+     */
+    private _backup;
+    /**
+     * 恢复集合数据
+     */
+    private _restore;
+    /**
+     * 添加插入操作
+     */
+    insert(collection: Collection, docs: Record<string, unknown> | Array<Record<string, unknown>>): Transaction;
+    /**
+     * 添加更新操作
+     */
+    update(collection: Collection, query: Record<string, unknown>, update: Record<string, unknown>, options?: Record<string, unknown>): Transaction;
+    /**
+     * 添加删除操作
+     */
+    delete(collection: Collection, query: Record<string, unknown>): Transaction;
+    /**
+     * 提交事务
+     */
+    commit(): Promise<{
+        success: boolean;
+        operations?: Array<Record<string, unknown>>;
+        error?: string;
+    }>;
+    /**
+     * 执行单个操作
+     */
+    private _executeOperation;
+    /**
+     * 回滚事务
+     */
+    rollback(): Promise<void>;
+    /**
+     * 获取事务状态
+     */
+    getStatus(): TransactionStatusType;
+    /**
+     * 获取操作数量
+     */
+    getOperationCount(): number;
+}
+/**
+ * 创建事务
+ */
+export declare function createTransaction(collections: Collection | Collection[]): Transaction;
+/**
+ * 执行事务（快捷方式）
+ */
+export declare function withTransaction(collections: Collection[], fn: (tx: Transaction) => Promise<void>): Promise<{
+    success: boolean;
+    operations?: Array<Record<string, unknown>>;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=Transaction.d.ts.map

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

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