97 lines
2.5 KiB
JavaScript
97 lines
2.5 KiB
JavaScript
// grid-db/src/index.js
|
||
// Grid-DB · 自研逻辑格点数据库 · 主入口
|
||
// PRJ-GDB-001 · Phase 0
|
||
// 版权：国作登字-2026-A-00037559
|
||
|
||
'use strict';
|
||
|
||
const path = require('path');
|
||
const fs = require('fs');
|
||
|
||
const GridCell = require('./core/grid-cell');
|
||
const WAL = require('./storage/wal');
|
||
const PageManager = require('./storage/page-manager');
|
||
const EventLog = require('./events/event-log');
|
||
const GridAPI = require('./api/grid-api');
|
||
const BTree = require('./index/btree');
|
||
const NamespaceManager = require('./core/namespace');
|
||
const RangeScanner = require('./query/scan');
|
||
const NearbyQuery = require('./query/nearby');
|
||
const SecondaryIndex = require('./index/secondary-index');
|
||
|
||
/**
|
||
* Grid-DB 初始化器
|
||
*
|
||
* 本体论锚定 [ONT-PATCH-006]：
|
||
* 笔需要纸来承载笔迹。
|
||
* Grid-DB = 纸。纸上有格子（格点），每个格子是最小寻址单元。
|
||
* 笔在格子里写字，格子记住了所有笔迹。
|
||
* 纸不属于笔，纸属于写字的人。
|
||
*/
|
||
|
||
/**
|
||
* 打开或创建一个 Grid-DB 实例
|
||
*
|
||
* @param {object} [config]
|
||
* @param {string} [config.dataDir] 数据目录（默认 grid-db/data）
|
||
* @param {number} [config.pageSize] 页大小（默认 4096）
|
||
* @returns {GridAPI}
|
||
*/
|
||
function open(config = {}) {
|
||
const dataDir = config.dataDir || path.resolve(__dirname, '../data');
|
||
|
||
if (!fs.existsSync(dataDir)) {
|
||
fs.mkdirSync(dataDir, { recursive: true });
|
||
}
|
||
|
||
return new GridAPI({
|
||
dataDir,
|
||
pageSize: config.pageSize || PageManager.DEFAULT_PAGE_SIZE
|
||
});
|
||
}
|
||
|
||
// ── CLI 入口 ──
|
||
|
||
if (require.main === module) {
|
||
const cmd = process.argv[2];
|
||
|
||
if (cmd === 'status') {
|
||
const db = open();
|
||
const status = db.stats();
|
||
// eslint-disable-next-line no-console
|
||
console.log(JSON.stringify(status, null, 2));
|
||
db.close();
|
||
} else {
|
||
// eslint-disable-next-line no-console
|
||
console.log([
|
||
'🗄️ Grid-DB v0.1.0 · PRJ-GDB-001 · Phase 0',
|
||
'',
|
||
'本体论锚定：Grid-DB = 纸 · 格点 = 格子 · WAL = 草稿本',
|
||
'',
|
||
'用法:',
|
||
' node grid-db/src/index.js status 查看数据库状态',
|
||
'',
|
||
'组件:',
|
||
' GridAPI 统一 API 接口',
|
||
' GridCell 格点数据模型',
|
||
' WAL Write-Ahead Log',
|
||
' PageManager 页管理器',
|
||
' EventLog 事件溯源日志',
|
||
].join('\n'));
|
||
}
|
||
}
|
||
|
||
module.exports = {
|
||
open,
|
||
GridAPI,
|
||
GridCell,
|
||
WAL,
|
||
PageManager,
|
||
EventLog,
|
||
BTree,
|
||
NamespaceManager,
|
||
RangeScanner,
|
||
NearbyQuery,
|
||
SecondaryIndex
|
||
};
|