@yydb/light-db 0.0.18 → 0.1.2

package/dist/api/database.js

@@ -1,149 +0,0 @@
-// ---------------------------------------------------------------------------
-// Pure-TS Database (StorageEngine wrapper — browser-friendly, no WASM)
-// ---------------------------------------------------------------------------
-import { StorageEngine } from '../core/engine.js';
-import { LightDbError, LightDbErrorCodes } from '../errors/index.js';
-import { isOpfsAvailable, OpfsStorageAdapterFactory } from '../storage/opfs/OpfsStorageAdapter.js';
-import { decodeSchema, encodeSchema, parseSchemaDocument, RESERVED_KEY_PREFIX, SCHEMA_KEY } from './schema.js';
-import { Transaction } from './transaction.js';
-/** 数据库名最大长度 */
-const MAX_DATABASE_NAME_LENGTH = 128;
-/**
- * 浏览器可用的纯 TS 数据库实现。
- *
- * 与 Node 侧 `@yydb/yydb` 的 {@link Database} 同构：宿主靠 import 来源区分：
- *
- * ```ts
- * import { Database } from '@yydb/yydb';       // Node 原生
- * import { Database } from '@yydb/light-db';   // 浏览器纯 TS（本文件）
- * ```
- *
- * 完全不依赖 WASM；OPFS 持久化、WAL 恢复、检查点、事务都在 TypeScript 内完成。
- *
- * 默认后端是 `OpfsStorageAdapterFactory`；通过 `options.storage` 可以显式指定。
- */
-export class Database {
-    /** 数据库名 */
-    name;
-    engine;
-    transaction;
-    constructor(name, engine) {
-        this.name = name;
-        this.engine = engine;
-        this.transaction = new Transaction(engine);
-    }
-    /**
-     * 打开数据库
-     * @param name 数据库名
-     * @param options 打开选项
-     */
-    static async open(name, options = {}) {
-        if (name.trim().length === 0 || name.length > MAX_DATABASE_NAME_LENGTH) {
-            throw new LightDbError(LightDbErrorCodes.unsupported, `database name must be 1-${MAX_DATABASE_NAME_LENGTH} characters`, {
-                operation: 'open',
-            });
-        }
-        const storage = resolveStorageFactory(options);
-        const engineOptions = {};
-        if (options.pageSize !== undefined)
-            engineOptions.pageSize = options.pageSize;
-        if (options.walThreshold !== undefined)
-            engineOptions.walThreshold = options.walThreshold;
-        if (options.autoCheckpoint !== undefined)
-            engineOptions.autoCheckpoint = options.autoCheckpoint;
-        if (options.lease !== undefined)
-            engineOptions.lease = options.lease;
-        const engine = await StorageEngine.open(name, storage, engineOptions);
-        return new Database(name, engine);
-    }
-    /** 读取已持久化的 schema */
-    async schema() {
-        const value = await this.engine.get(SCHEMA_KEY);
-        return value ? decodeSchema(value) : null;
-    }
-    /**
-     * 声明 schema 文档
-     *
-     * 文档是唯一真相：首次写入后，重复调用必须传入完全相同的文档。
-     */
-    async ensureSchema(document) {
-        const version = parseSchemaDocument(document);
-        const existing = await this.schema();
-        if (existing) {
-            if (existing.document !== document) {
-                throw new LightDbError(LightDbErrorCodes.schemaConflict, `schema document conflict: stored version ${existing.version}, incoming version ${version}`, { operation: 'ensureSchema' });
-            }
-            return;
-        }
-        await this.engine.put(SCHEMA_KEY, encodeSchema({ version, document }));
-        this.engine.notifySchemaChange();
-    }
-    /** 读取键 */
-    async get(key) {
-        return this.engine.get(this.assertUserKey(key, 'kvGet'));
-    }
-    /** 写入键 */
-    async put(key, value) {
-        await this.engine.put(this.assertUserKey(key, 'kvPut'), value);
-    }
-    /** 删除键 */
-    async delete(key) {
-        return this.engine.delete(this.assertUserKey(key, 'kvDelete'));
-    }
-    /** 开始事务 */
-    async begin() {
-        await this.transaction.begin();
-    }
-    /** 提交事务 */
-    async commit() {
-        await this.transaction.commit();
-    }
-    /** 回滚事务 */
-    async rollback() {
-        await this.transaction.rollback();
-    }
-    /** 执行检查点 */
-    async checkpoint() {
-        return this.engine.checkpoint();
-    }
-    /** 统计信息 */
-    stats() {
-        return this.engine.getStats();
-    }
-    /** 关闭数据库 */
-    async close() {
-        if (this.transaction.isActive) {
-            await this.transaction.rollback();
-        }
-        await this.engine.close();
-    }
-    /**
-     * 校验用户键
-     */
-    assertUserKey(key, operation) {
-        if (key.length === 0) {
-            throw new LightDbError(LightDbErrorCodes.unsupported, 'key must not be empty', { operation });
-        }
-        if (key.startsWith(RESERVED_KEY_PREFIX)) {
-            throw new LightDbError(LightDbErrorCodes.unsupported, `key prefix "${RESERVED_KEY_PREFIX}" is reserved for the database`, {
-                operation,
-            });
-        }
-        return key;
-    }
-}
-/**
- * 解析存储后端
- */
-function resolveStorageFactory(options) {
-    if (options.storage) {
-        return options.storage;
-    }
-    if (!isOpfsAvailable()) {
-        throw new LightDbError(LightDbErrorCodes.unsupported, 'OPFS is unavailable, pass an explicit storage adapter', {
-            operation: 'open',
-        });
-    }
-    return new OpfsStorageAdapterFactory();
-}
-//# sourceMappingURL=database.js.map

package/dist/api/database.js.map

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

package/dist/api/schema.d.ts

@@ -1,33 +0,0 @@
-/**
- * Schema 语义
- *
- * 与 `@yydb/yydb` 的 Rust 实现同构：Schema 文档是唯一真相，
- * 版本由文档前导注释 `// @yydb-schema-version: <n>` 决定，默认 1。
- */
-import type { SchemaVersion } from './types';
-/** Schema 记录在数据库中的保留键 */
-export declare const SCHEMA_KEY = "__yydb__/schema";
-/** 用户键禁止使用的内部前缀 */
-export declare const RESERVED_KEY_PREFIX = "__yydb__/";
-/**
- * 从文档中提取版本
- * @param document Schema 文档
- */
-export declare function documentVersion(document: string): number;
-/**
- * 校验 Schema 文档
- * @param document Schema 文档
- * @returns 文档声明的版本
- */
-export declare function parseSchemaDocument(document: string): number;
-/**
- * 编码 Schema 记录
- * @param schema Schema 版本与文档
- */
-export declare function encodeSchema(schema: SchemaVersion): Uint8Array;
-/**
- * 解码 Schema 记录
- * @param value 记录值
- */
-export declare function decodeSchema(value: Uint8Array): SchemaVersion;
-//# sourceMappingURL=schema.d.ts.map

package/dist/api/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/api/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,yBAAyB;AACzB,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,mBAAmB;AACnB,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAkB7D"}

package/dist/api/schema.js

@@ -1,80 +0,0 @@
-/**
- * Schema 语义
- *
- * 与 `@yydb/yydb` 的 Rust 实现同构：Schema 文档是唯一真相，
- * 版本由文档前导注释 `// @yydb-schema-version: <n>` 决定，默认 1。
- */
-import { BinaryUtils } from '../codec';
-import { LightDbError, LightDbErrorCodes } from '../errors';
-/** Schema 记录在数据库中的保留键 */
-export const SCHEMA_KEY = '__yydb__/schema';
-/** 用户键禁止使用的内部前缀 */
-export const RESERVED_KEY_PREFIX = '__yydb__/';
-/** 版本声明注释 */
-const VERSION_PRAGMA = /^\s*\/\/\s*@yydb-schema-version:\s*(\d+)\s*$/m;
-/**
- * 从文档中提取版本
- * @param document Schema 文档
- */
-export function documentVersion(document) {
-    const match = VERSION_PRAGMA.exec(document);
-    if (!match) {
-        return 1;
-    }
-    const version = Number.parseInt(match[1], 10);
-    return Number.isFinite(version) && version > 0 ? version : 1;
-}
-/**
- * 校验 Schema 文档
- * @param document Schema 文档
- * @returns 文档声明的版本
- */
-export function parseSchemaDocument(document) {
-    if (document.trim().length === 0) {
-        throw new LightDbError(LightDbErrorCodes.schemaInvalid, 'schema document must not be empty', {
-            operation: 'ensureSchema',
-        });
-    }
-    return documentVersion(document);
-}
-/**
- * 编码 Schema 记录
- * @param schema Schema 版本与文档
- */
-export function encodeSchema(schema) {
-    return BinaryUtils.encode(JSON.stringify(schema));
-}
-/**
- * 解码 Schema 记录
- * @param value 记录值
- */
-export function decodeSchema(value) {
-    let parsed;
-    try {
-        parsed = JSON.parse(BinaryUtils.decode(value));
-    }
-    catch (error) {
-        throw new LightDbError(LightDbErrorCodes.corrupt, 'persisted schema record is not valid JSON', {
-            operation: 'schema',
-            cause: error,
-        });
-    }
-    if (!isSchemaVersion(parsed)) {
-        throw new LightDbError(LightDbErrorCodes.corrupt, 'persisted schema record has an unexpected shape', {
-            operation: 'schema',
-        });
-    }
-    return parsed;
-}
-/**
- * 判断值是否为 Schema 记录
- * @param value 待判断值
- */
-function isSchemaVersion(value) {
-    if (typeof value !== 'object' || value === null) {
-        return false;
-    }
-    const record = value;
-    return typeof record.version === 'number' && typeof record.document === 'string';
-}
-//# sourceMappingURL=schema.js.map

package/dist/api/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/api/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG5D,yBAAyB;AACzB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE5C,mBAAmB;AACnB,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,aAAa;AACb,MAAM,cAAc,GAAG,+CAA+C,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,CAAC;IACb,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAChD,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,EAAE,mCAAmC,EAAE;YACzF,SAAS,EAAE,cAAc;SAC5B,CAAC,CAAC;IACP,CAAC;IACD,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAC9C,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC1C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,OAAO,EAAE,2CAA2C,EAAE;YAC3F,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,KAAK;SACf,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,OAAO,EAAE,iDAAiD,EAAE;YACjG,SAAS,EAAE,QAAQ;SACtB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,KAAkD,CAAC;IAClE,OAAO,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACrF,CAAC"}

package/dist/api/transaction.d.ts

@@ -1,26 +0,0 @@
-/**
- * 事务作者面
- *
- * 事务语义由 `core/engine` 维护，本层只提供异步调用形态与状态跟踪。
- */
-import type { StorageEngine } from '../core/engine';
-export type { TransactionState } from '../core/engine';
-/**
- * 事务句柄
- *
- * 一个数据库同时只允许一个写事务；重复开始会得到 `yydb.unsupported`。
- */
-export declare class Transaction {
-    private readonly engine;
-    private active;
-    constructor(engine: StorageEngine);
-    /** 是否处于事务中 */
-    get isActive(): boolean;
-    /** 开始事务 */
-    begin(): Promise<void>;
-    /** 提交事务，失败时事务仍视为结束 */
-    commit(): Promise<void>;
-    /** 回滚事务 */
-    rollback(): Promise<void>;
-}
-//# sourceMappingURL=transaction.d.ts.map

package/dist/api/transaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/api/transaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,aAAa;IAIjC,cAAc;IACd,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,WAAW;IACE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,sBAAsB;IACT,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC,WAAW;IACE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWzC"}

package/dist/api/transaction.js

@@ -1,52 +0,0 @@
-/**
- * 事务作者面
- *
- * 事务语义由 `core/engine` 维护，本层只提供异步调用形态与状态跟踪。
- */
-import { LightDbError, LightDbErrorCodes } from '../errors';
-/**
- * 事务句柄
- *
- * 一个数据库同时只允许一个写事务；重复开始会得到 `yydb.unsupported`。
- */
-export class Transaction {
-    engine;
-    active = false;
-    constructor(engine) {
-        this.engine = engine;
-    }
-    /** 是否处于事务中 */
-    get isActive() {
-        return this.active;
-    }
-    /** 开始事务 */
-    async begin() {
-        this.engine.begin();
-        this.active = true;
-    }
-    /** 提交事务，失败时事务仍视为结束 */
-    async commit() {
-        if (!this.active) {
-            throw new LightDbError(LightDbErrorCodes.unsupported, 'no active transaction', { operation: 'commit' });
-        }
-        try {
-            await this.engine.commit();
-        }
-        finally {
-            this.active = false;
-        }
-    }
-    /** 回滚事务 */
-    async rollback() {
-        if (!this.active) {
-            throw new LightDbError(LightDbErrorCodes.unsupported, 'no active transaction', { operation: 'rollback' });
-        }
-        try {
-            this.engine.rollback();
-        }
-        finally {
-            this.active = false;
-        }
-    }
-}
-//# sourceMappingURL=transaction.js.map

package/dist/api/transaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/api/transaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAI5D;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACH,MAAM,CAAgB;IAC/B,MAAM,GAAY,KAAK,CAAC;IAEhC,YAAY,MAAqB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,cAAc;IACd,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,WAAW;IACJ,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,sBAAsB;IACf,KAAK,CAAC,MAAM;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,WAAW,EAAE,uBAAuB,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5G,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;IAED,WAAW;IACJ,KAAK,CAAC,QAAQ;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,WAAW,EAAE,uBAAuB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9G,CAAC;QAED,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;CACJ"}

package/dist/codec/binary.d.ts

@@ -1,196 +0,0 @@
-/**
- * 浏览器原生二进制编解码
- *
- * 公共类型只用 `Uint8Array`，不依赖 Node `Buffer`。
- */
-/**
- * 二进制辅助方法
- */
-export declare class BinaryUtils {
-    /**
-     * 分配初始化为零的字节数组
-     * @param size 大小
-     */
-    static alloc(size: number): Uint8Array;
-    /**
-     * 拼接多个字节数组
-     * @param parts 字节数组列表
-     */
-    static concat(parts: readonly Uint8Array[]): Uint8Array;
-    /**
-     * 计算字符串的 UTF-8 字节长度
-     * @param value 字符串
-     */
-    static byteLength(value: string): number;
-    /**
-     * 编码字符串为 UTF-8 字节
-     * @param value 字符串
-     */
-    static encode(value: string): Uint8Array;
-    /**
-     * 解码 UTF-8 字节为字符串
-     * @param data 字节
-     * @param offset 起始偏移量
-     * @param length 长度
-     */
-    static decode(data: Uint8Array, offset?: number, length?: number): string;
-    /**
-     * 判断两个字节数组内容是否相同
-     * @param a 第一个数组
-     * @param b 第二个数组
-     */
-    static equals(a: Uint8Array, b: Uint8Array): boolean;
-    /**
-     * 复制字节数组
-     * @param source 源数组
-     */
-    static copy(source: Uint8Array): Uint8Array;
-}
-/**
- * 顺序字节写入器
- *
- * 容量不足时自动扩展，写入 `data` 时返回已写区间视图。
- */
-export declare class ByteWriter {
-    private buffer;
-    private view;
-    private offset;
-    /**
-     * 创建写入器
-     * @param size 初始容量
-     */
-    constructor(size?: number);
-    /** 当前写入位置 */
-    get position(): number;
-    /** 已写入的数据视图 */
-    get data(): Uint8Array;
-    /**
-     * 确保容量
-     * @param additional 需要的额外字节数
-     */
-    private ensureCapacity;
-    /**
-     * 写入 8 位无符号整数
-     * @param value 值
-     */
-    writeUInt8(value: number): this;
-    /**
-     * 写入 16 位无符号整数（小端）
-     * @param value 值
-     */
-    writeUInt16LE(value: number): this;
-    /**
-     * 写入 32 位无符号整数（小端）
-     * @param value 值
-     */
-    writeUInt32LE(value: number): this;
-    /**
-     * 写入 64 位无符号整数（小端）
-     * @param value 值
-     */
-    writeBigUInt64LE(value: bigint): this;
-    /**
-     * 写入原始字节
-     * @param value 字节
-     */
-    writeBytes(value: Uint8Array): this;
-    /**
-     * 写入带 32 位长度前缀的字节
-     * @param value 字节
-     */
-    writeBytesWithLength(value: Uint8Array): this;
-    /**
-     * 写入不带长度前缀的 UTF-8 字符串
-     * @param value 字符串
-     */
-    writeStringRaw(value: string): this;
-    /**
-     * 写入带 32 位长度前缀的 UTF-8 字符串
-     * @param value 字符串
-     */
-    writeString(value: string): this;
-    /**
-     * 写入从 `startOffset` 到当前位置的 CRC32 校验和
-     * @param startOffset 校验范围起点
-     */
-    writeChecksum(startOffset?: number): this;
-}
-/**
- * 顺序字节读取器
- */
-export declare class ByteReader {
-    private readonly buffer;
-    private readonly view;
-    private offset;
-    /**
-     * 创建读取器
-     * @param buffer 数据
-     * @param startOffset 起始偏移量
-     */
-    constructor(buffer: Uint8Array, startOffset?: number);
-    /** 当前读取位置 */
-    get position(): number;
-    /** 设置读取位置 */
-    set position(value: number);
-    /** 剩余可读字节数 */
-    get remaining(): number;
-    /**
-     * 是否有足够的可读数据
-     * @param required 需要的字节数
-     */
-    hasRemaining(required: number): boolean;
-    /**
-     * 读取 8 位无符号整数
-     */
-    readUInt8(): number;
-    /**
-     * 读取 16 位无符号整数（小端）
-     */
-    readUInt16LE(): number;
-    /**
-     * 读取 32 位无符号整数（小端）
-     */
-    readUInt32LE(): number;
-    /**
-     * 读取 64 位无符号整数（小端）
-     */
-    readBigUInt64LE(): bigint;
-    /**
-     * 读取指定长度的字节视图
-     * @param length 长度
-     */
-    readBytes(length: number): Uint8Array;
-    /**
-     * 读取带 32 位长度前缀的字节
-     */
-    readBytesWithLength(): Uint8Array;
-    /**
-     * 读取带 32 位长度前缀的 UTF-8 字符串
-     */
-    readString(): string;
-    /**
-     * 读取 32 位校验和并校验 `[startOffset, 校验和之前)` 的区间
-     * @param startOffset 校验范围起点
-     */
-    readAndVerifyChecksum(startOffset: number): number;
-    /**
-     * 跳过指定字节数
-     * @param bytes 字节数
-     */
-    skip(bytes: number): this;
-}
-/**
- * 校验和不匹配
- *
- * codec 层不依赖具体错误模型，由上层转换成稳定错误码。
- */
-export declare class ChecksumMismatchError extends Error {
-    /** 期望的校验和 */
-    readonly expected: number;
-    /** 实际计算出的校验和 */
-    readonly actual: number;
-    /** 校验区间起点 */
-    readonly position: number;
-    constructor(expected: number, actual: number, position: number);
-}
-//# sourceMappingURL=binary.d.ts.map

package/dist/codec/binary.d.ts.map

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