@1api/engine 0.1.0

package/dist/metadata.js

@@ -0,0 +1,129 @@
+import {} from 'kysely';
+import {} from '@1api/shared';
+import { readTableSchema } from './schema-reader.js';
+function rowToMeta(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        label: row.label,
+        primaryKey: row.primary_key,
+        fields: JSON.parse(row.fields),
+        isPublished: row.is_published === 1,
+        isEditable: row.is_editable === 1,
+        note: row.note,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export class MetadataStore {
+    systemDb;
+    businessRaw;
+    cache = new Map(); // 按 name 索引
+    constructor(systemDb, businessRaw) {
+        this.systemDb = systemDb;
+        this.businessRaw = businessRaw;
+    }
+    /** 预热：启动时加载全部 table_meta 到缓存 */
+    async warmup() {
+        const rows = await this.systemDb.selectFrom('table_meta').selectAll().execute();
+        this.cache.clear();
+        for (const r of rows) {
+            const meta = rowToMeta(r);
+            this.cache.set(meta.name, meta);
+        }
+    }
+    async listMetas() {
+        return [...this.cache.values()];
+    }
+    async getMeta(id) {
+        for (const m of this.cache.values())
+            if (m.id === id)
+                return m;
+        return undefined;
+    }
+    async getMetaByName(name) {
+        return this.cache.get(name);
+    }
+    async createMeta(input) {
+        const now = Date.now();
+        const inserted = await this.systemDb
+            .insertInto('table_meta')
+            .values({
+            name: input.name,
+            label: input.label,
+            primary_key: input.primaryKey,
+            fields: JSON.stringify(input.fields),
+            is_published: input.isPublished === false ? 0 : 1,
+            is_editable: input.isEditable === false ? 0 : 1,
+            note: input.note ?? null,
+            created_at: now,
+            updated_at: now,
+        })
+            .returningAll()
+            .executeTakeFirstOrThrow();
+        const meta = rowToMeta(inserted);
+        this.cache.set(meta.name, meta);
+        return meta;
+    }
+    async updateMeta(id, patch) {
+        const now = Date.now();
+        const sets = { updated_at: now };
+        if (patch.label !== undefined)
+            sets['label'] = patch.label;
+        if (patch.note !== undefined)
+            sets['note'] = patch.note;
+        if (patch.isPublished !== undefined)
+            sets['is_published'] = patch.isPublished ? 1 : 0;
+        if (patch.isEditable !== undefined)
+            sets['is_editable'] = patch.isEditable ? 1 : 0;
+        if (patch.fields !== undefined)
+            sets['fields'] = JSON.stringify(patch.fields);
+        if (patch.primaryKey !== undefined)
+            sets['primary_key'] = patch.primaryKey;
+        const updated = await this.systemDb
+            .updateTable('table_meta')
+            .set(sets)
+            .where('id', '=', id)
+            .returningAll()
+            .executeTakeFirst();
+        if (updated) {
+            const meta = rowToMeta(updated);
+            this.cache.set(meta.name, meta);
+        }
+    }
+    async deleteMeta(id) {
+        const meta = await this.getMeta(id);
+        await this.systemDb.deleteFrom('table_meta').where('id', '=', id).execute();
+        if (meta)
+            this.cache.delete(meta.name);
+    }
+    /** 重新反射业务库 → diff → 保留用户标记（label/isHidden/isReadonly/enumValues）→ 更新 fields */
+    async refreshMeta(id) {
+        const current = await this.getMeta(id);
+        if (!current)
+            throw new Error(`meta ${id} not found`);
+        const { fields: reflected, primaryKey } = readTableSchema(this.businessRaw, current.name);
+        // 按 name 索引旧字段，保留用户标记
+        const oldByName = new Map(current.fields.map((fld) => [fld.name, fld]));
+        const merged = reflected.map((rf) => {
+            const old = oldByName.get(rf.name);
+            if (!old)
+                return rf; // 新字段：纯反射结果（label 默认 = name）
+            // 保留用户标记，结构用反射最新值
+            const mergedField = {
+                ...rf,
+                label: old.label,
+                isHidden: old.isHidden,
+                isReadonly: old.isReadonly,
+            };
+            // exactOptionalPropertyTypes：仅在显式提供时挂载 enumValues
+            if (old.enumValues !== undefined)
+                mergedField.enumValues = old.enumValues;
+            return mergedField;
+        });
+        await this.updateMeta(id, { fields: merged, primaryKey });
+        const after = await this.getMeta(id);
+        return after;
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/schema-ddl.d.ts

@@ -0,0 +1,9 @@
+import type Database from 'better-sqlite3';
+import { type CreateModelOptions, type FieldMeta, type FieldMetaInput } from '@1api/shared';
+/** FieldMetaInput（建模输入）→ FieldMeta（完整），补齐 sqliteType 与默认标记 */
+export declare function inputToField(input: FieldMetaInput): FieldMeta;
+/** CREATE TABLE（含主键约定 + 可选时间戳），执行后由调用方反射读回 */
+export declare function createTable(db: Database.Database, opts: CreateModelOptions): void;
+/** ALTER TABLE ... ADD COLUMN（标识符双引号包裹，支持非 snake_case） */
+export declare function addColumn(db: Database.Database, tableName: string, field: FieldMeta): void;
+//# sourceMappingURL=schema-ddl.d.ts.map

package/dist/schema-ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-ddl.d.ts","sourceRoot":"","sources":["../src/schema-ddl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAiB7D;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAkBjF;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAK1F"}

package/dist/schema-ddl.js

@@ -0,0 +1,47 @@
+import { buildCreateColumnSql, jsonTypeToSqliteType, } from '@1api/shared';
+/** FieldMetaInput（建模输入）→ FieldMeta（完整），补齐 sqliteType 与默认标记 */
+export function inputToField(input) {
+    const sqliteType = jsonTypeToSqliteType(input.jsonType);
+    const field = {
+        name: input.name,
+        label: input.label ?? input.name,
+        sqliteType,
+        jsonType: input.jsonType,
+        nullable: input.nullable ?? true,
+        defaultValue: input.defaultValue ?? null,
+        isPrimary: input.isPrimary ?? false,
+        isAutoIncrement: input.isAutoIncrement ?? false,
+        isHidden: input.isHidden ?? false,
+        isReadonly: input.isReadonly ?? false,
+    };
+    // exactOptionalPropertyTypes：仅在显式提供时挂载 enumValues
+    if (input.enumValues !== undefined)
+        field.enumValues = input.enumValues;
+    return field;
+}
+/** CREATE TABLE（含主键约定 + 可选时间戳），执行后由调用方反射读回 */
+export function createTable(db, opts) {
+    const cols = [];
+    const hasExplicitPk = opts.fields.some((f) => f.isPrimary);
+    // 默认主键：id INTEGER PRIMARY KEY AUTOINCREMENT
+    if (!hasExplicitPk) {
+        cols.push('"id" INTEGER PRIMARY KEY AUTOINCREMENT');
+    }
+    for (const input of opts.fields) {
+        cols.push(buildCreateColumnSql(inputToField(input)));
+    }
+    if (opts.autoTimestamps) {
+        cols.push('"created_at" INTEGER');
+        cols.push('"updated_at" INTEGER');
+    }
+    const sql = `CREATE TABLE "${opts.name}" (${cols.join(', ')})`;
+    db.exec(sql);
+}
+/** ALTER TABLE ... ADD COLUMN（标识符双引号包裹，支持非 snake_case） */
+export function addColumn(db, tableName, field) {
+    const colSql = buildCreateColumnSql(field);
+    // ADD COLUMN 不支持 PRIMARY KEY/AUTOINCREMENT，剥离
+    const colSafe = colSql.replace(/\s+PRIMARY KEY(\s+AUTOINCREMENT)?/i, '');
+    db.exec(`ALTER TABLE "${tableName}" ADD COLUMN ${colSafe}`);
+}
+//# sourceMappingURL=schema-ddl.js.map

package/dist/schema-ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-ddl.js","sourceRoot":"","sources":["../src/schema-ddl.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAIrB,MAAM,cAAc,CAAC;AAEtB,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,KAAK,GAAc;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI;QAChC,UAAU;QACV,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACxC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;QACnC,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,KAAK;QAC/C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;QACjC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK;KACtC,CAAC;IACF,kDAAkD;IAClD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,EAAqB,EAAE,IAAwB;IACzE,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,4CAA4C;IAC5C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,GAAG,GAAG,iBAAiB,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC/D,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,SAAS,CAAC,EAAqB,EAAE,SAAiB,EAAE,KAAgB;IAClF,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,8CAA8C;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;IACzE,EAAE,CAAC,IAAI,CAAC,gBAAgB,SAAS,gBAAgB,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/schema-reader.d.ts

@@ -0,0 +1,10 @@
+import type Database from 'better-sqlite3';
+import { type FieldMeta } from '@1api/shared';
+/** 列出业务库所有用户表（排除 sqlite_ 内部表） */
+export declare function listTables(db: Database.Database): string[];
+/** 反射单表 → FieldMeta[] + 主键 */
+export declare function readTableSchema(db: Database.Database, tableName: string): {
+    fields: FieldMeta[];
+    primaryKey: string;
+};
+//# sourceMappingURL=schema-reader.d.ts.map

package/dist/schema-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-reader.d.ts","sourceRoot":"","sources":["../src/schema-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAU,KAAK,SAAS,EAAkC,MAAM,cAAc,CAAC;AAatF,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,EAAE,CAK1D;AAuCD,8BAA8B;AAC9B,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA6B7C"}

package/dist/schema-reader.js

@@ -0,0 +1,98 @@
+import { Errors } from '@1api/shared';
+const DATETIME_NAME_RE = /(^|_)(at|time)$/i;
+/** 列出业务库所有用户表（排除 sqlite_ 内部表） */
+export function listTables(db) {
+    const rows = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
+        .all();
+    return rows.map((r) => r.name);
+}
+/** 主键策略：只接受单主键 */
+function resolvePrimaryKey(rows, tableName) {
+    const pkRows = rows.filter((r) => r.pk > 0);
+    if (pkRows.length === 0)
+        throw Errors.tableNoPrimaryKey(tableName);
+    if (pkRows.length > 1)
+        throw Errors.tableCompositePrimaryKey(tableName);
+    return { pkField: pkRows[0].name };
+}
+/** SQLite 原生类型串归一为五类之一 */
+function normalizeSqliteType(raw) {
+    const t = raw.toUpperCase();
+    if (t === '')
+        return 'BLOB'; // 无类型声明 → BLOB 亲和
+    if (t.includes('INT'))
+        return 'INTEGER';
+    if (t.includes('CHAR') || t.includes('CLOB') || t.includes('TEXT'))
+        return 'TEXT';
+    if (t.includes('BLOB'))
+        return 'BLOB';
+    if (t.includes('REAL') || t.includes('FLOA') || t.includes('DOUB'))
+        return 'REAL';
+    return 'NUMERIC';
+}
+/** jsonType 推断（含命名启发式） */
+function inferJsonType(sqliteType, colName, defaultValue) {
+    const lower = colName.toLowerCase();
+    const isBooleanish = (lower.startsWith('is_') || lower.startsWith('has_')) && sqliteType === 'INTEGER';
+    if (isBooleanish && (defaultValue === '0' || defaultValue === '1'))
+        return 'boolean';
+    if (sqliteType === 'INTEGER')
+        return 'integer';
+    if (sqliteType === 'REAL' || sqliteType === 'NUMERIC')
+        return 'number';
+    if (sqliteType === 'BLOB')
+        return 'string'; // BLOB 作为 string 读取（不接受输入由上层校验）
+    // TEXT
+    if (DATETIME_NAME_RE.test(lower))
+        return 'datetime';
+    return 'string';
+}
+/** 反射单表 → FieldMeta[] + 主键 */
+export function readTableSchema(db, tableName) {
+    const rows = db.prepare(`PRAGMA table_info(${JSON.stringify(tableName)})`).all();
+    if (rows.length === 0)
+        throw Errors.tableNotFound(tableName);
+    const { pkField } = resolvePrimaryKey(rows, tableName);
+    const fields = rows
+        .sort((a, b) => a.cid - b.cid)
+        .map((r) => {
+        const sqliteType = normalizeSqliteType(r.type);
+        const jsonType = inferJsonType(sqliteType, r.name, r.dflt_value);
+        const isPrimary = r.name === pkField;
+        const lower = r.name.toLowerCase();
+        const isReadonly = jsonType === 'datetime' && (lower === 'created_at' || lower === 'updated_at');
+        return {
+            name: r.name,
+            label: r.name,
+            sqliteType,
+            jsonType,
+            nullable: r.notnull === 0,
+            defaultValue: parseDefaultValue(r.dflt_value, jsonType),
+            isPrimary,
+            isAutoIncrement: isPrimary && sqliteType === 'INTEGER',
+            isHidden: false,
+            isReadonly,
+        };
+    });
+    return { fields, primaryKey: pkField };
+}
+/** 解析 PRAGMA 的 dflt_value 字符串为合适的 JS 值 */
+function parseDefaultValue(raw, jsonType) {
+    if (raw === null)
+        return null;
+    const v = raw;
+    if (jsonType === 'boolean')
+        return v === '1' ? true : v === '0' ? false : null;
+    if (jsonType === 'integer') {
+        const n = Number.parseInt(v, 10);
+        return Number.isFinite(n) ? n : null;
+    }
+    if (jsonType === 'number') {
+        const n = Number.parseFloat(v);
+        return Number.isFinite(n) ? n : null;
+    }
+    // string / datetime：去掉外层单引号（SQLite 默认值字符串以 'xxx' 形式存储）
+    return v.replace(/^'|'$/g, '').replace(/''/g, "'");
+}
+//# sourceMappingURL=schema-reader.js.map

package/dist/schema-reader.js.map

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

package/dist/schema-service.d.ts

@@ -0,0 +1,25 @@
+import type Database from 'better-sqlite3';
+import { type FieldMetaInput, type TableMeta } from '@1api/shared';
+import { MetadataStore } from './metadata.js';
+export declare class SchemaService {
+    private readonly businessRaw;
+    private readonly store;
+    constructor(businessRaw: Database.Database, store: MetadataStore);
+    /** 导入已有表：listTables 确认 → readTableSchema（无/复合主键透传）→ createMeta（label 留空）。表名不强制正则。 */
+    importExisting(name: string): Promise<TableMeta>;
+    /** 新建模型：name 强制正则 + 非保留字 → createTable → readTableSchema（读回真实结构）→ createMeta */
+    createModel(opts: {
+        name: string;
+        label: string;
+        fields: FieldMetaInput[];
+        note?: string | null;
+        autoTimestamps?: boolean;
+    }): Promise<TableMeta>;
+    /** 追加字段：field.name 强制正则 → addColumn（DDL）→ refreshMeta */
+    addField(table: string, field: FieldMetaInput): Promise<TableMeta>;
+    /** 刷新元数据（重新反射 + diff） */
+    refresh(table: string): Promise<TableMeta>;
+    /** 新建模型/字段用的严格名称校验：正则 + 保留字 */
+    private assertCreatableName;
+}
+//# sourceMappingURL=schema-service.d.ts.map

package/dist/schema-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-service.d.ts","sourceRoot":"","sources":["../src/schema-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAuC,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxG,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAC9B,KAAK,EAAE,aAAa;IAGvC,qFAAqF;IAC/E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAStD,gFAAgF;IAC1E,WAAW,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBtB,yDAAyD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAWxE,yBAAyB;IACnB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAMhD,+BAA+B;IAC/B,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/schema-service.js

@@ -0,0 +1,72 @@
+import { Errors, isReservedName, isValidName } from '@1api/shared';
+import { addColumn, createTable, inputToField } from './schema-ddl.js';
+import { listTables, readTableSchema } from './schema-reader.js';
+import { MetadataStore } from './metadata.js';
+export class SchemaService {
+    businessRaw;
+    store;
+    constructor(businessRaw, store) {
+        this.businessRaw = businessRaw;
+        this.store = store;
+    }
+    /** 导入已有表：listTables 确认 → readTableSchema（无/复合主键透传）→ createMeta（label 留空）。表名不强制正则。 */
+    async importExisting(name) {
+        const tables = listTables(this.businessRaw);
+        if (!tables.includes(name))
+            throw Errors.tableNotFound(name);
+        if (await this.store.getMetaByName(name))
+            throw Errors.tableAlreadyExists(name);
+        const { fields, primaryKey } = readTableSchema(this.businessRaw, name); // 主键策略在此抛错并透传
+        return this.store.createMeta({ name, label: '', primaryKey, fields });
+    }
+    /** 新建模型：name 强制正则 + 非保留字 → createTable → readTableSchema（读回真实结构）→ createMeta */
+    async createModel(opts) {
+        this.assertCreatableName(opts.name);
+        if (await this.store.getMetaByName(opts.name))
+            throw Errors.tableAlreadyExists(opts.name);
+        if (listTables(this.businessRaw).includes(opts.name)) {
+            throw Errors.tableAlreadyExists(opts.name);
+        }
+        createTable(this.businessRaw, opts);
+        const { fields, primaryKey } = readTableSchema(this.businessRaw, opts.name); // 读回真实结构
+        // exactOptionalPropertyTypes：仅在显式提供时挂载 note
+        const createInput = {
+            name: opts.name,
+            label: opts.label,
+            primaryKey,
+            fields,
+        };
+        if (opts.note !== undefined)
+            createInput.note = opts.note;
+        return this.store.createMeta(createInput);
+    }
+    /** 追加字段：field.name 强制正则 → addColumn（DDL）→ refreshMeta */
+    async addField(table, field) {
+        this.assertCreatableName(field.name);
+        const meta = await this.store.getMetaByName(table);
+        if (!meta)
+            throw Errors.tableNotFound(table);
+        if (meta.fields.some((f) => f.name === field.name)) {
+            throw Errors.validationFail(`字段已存在: ${field.name}`);
+        }
+        addColumn(this.businessRaw, table, inputToField(field));
+        return this.store.refreshMeta(meta.id);
+    }
+    /** 刷新元数据（重新反射 + diff） */
+    async refresh(table) {
+        const meta = await this.store.getMetaByName(table);
+        if (!meta)
+            throw Errors.tableNotFound(table);
+        return this.store.refreshMeta(meta.id);
+    }
+    /** 新建模型/字段用的严格名称校验：正则 + 保留字 */
+    assertCreatableName(name) {
+        if (!isValidName(name)) {
+            // 区分：保留字 vs 非法格式（保留字本身符合小写开头，归 RESERVED_NAME）
+            if (isReservedName(name) && /^[a-z]/.test(name))
+                throw Errors.reservedName(name);
+            throw Errors.invalidName(name);
+        }
+    }
+}
+//# sourceMappingURL=schema-service.js.map

package/dist/schema-service.js.map

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

package/dist/system-db.d.ts

@@ -0,0 +1,24 @@
+import type { Generated } from 'kysely';
+/** table_meta 行（系统库，snake_case） */
+export interface TableMetaRow {
+    id: Generated<number>;
+    name: string;
+    label: string;
+    primary_key: string;
+    fields: string;
+    is_published: number;
+    is_editable: number;
+    note: string | null;
+    created_at: number;
+    updated_at: number;
+}
+/**
+ * 系统库类型。Phase 1 只覆盖 table_meta（engine 唯一接入的系统表）。
+ * admin / api_token 属鉴权层，Phase 2 扩展。
+ */
+export interface SystemDB {
+    table_meta: TableMetaRow;
+}
+/** 系统库建表 SQL（Phase 1 仅 table_meta） */
+export declare const SYSTEM_DB_MIGRATIONS: readonly ["CREATE TABLE IF NOT EXISTS table_meta (\n     id           INTEGER PRIMARY KEY AUTOINCREMENT,\n     name         TEXT NOT NULL UNIQUE,\n     label        TEXT NOT NULL,\n     primary_key  TEXT NOT NULL,\n     fields       TEXT NOT NULL,\n     is_published INTEGER NOT NULL DEFAULT 1,\n     is_editable  INTEGER NOT NULL DEFAULT 1,\n     note         TEXT,\n     created_at   INTEGER NOT NULL,\n     updated_at   INTEGER NOT NULL\n   )"];
+//# sourceMappingURL=system-db.d.ts.map

package/dist/system-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-db.d.ts","sourceRoot":"","sources":["../src/system-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED,sCAAsC;AACtC,eAAO,MAAM,oBAAoB,icAavB,CAAC"}

package/dist/system-db.js

@@ -0,0 +1,16 @@
+/** 系统库建表 SQL（Phase 1 仅 table_meta） */
+export const SYSTEM_DB_MIGRATIONS = [
+    `CREATE TABLE IF NOT EXISTS table_meta (
+     id           INTEGER PRIMARY KEY AUTOINCREMENT,
+     name         TEXT NOT NULL UNIQUE,
+     label        TEXT NOT NULL,
+     primary_key  TEXT NOT NULL,
+     fields       TEXT NOT NULL,
+     is_published INTEGER NOT NULL DEFAULT 1,
+     is_editable  INTEGER NOT NULL DEFAULT 1,
+     note         TEXT,
+     created_at   INTEGER NOT NULL,
+     updated_at   INTEGER NOT NULL
+   )`,
+];
+//# sourceMappingURL=system-db.js.map

package/dist/system-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-db.js","sourceRoot":"","sources":["../src/system-db.ts"],"names":[],"mappings":"AAwBA,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;;;;;;;;;;KAWG;CACK,CAAC"}

package/dist/test-helpers.d.ts

@@ -0,0 +1,15 @@
+import Database from 'better-sqlite3';
+import { Kysely } from 'kysely';
+import type { SystemDB } from './system-db.js';
+export interface TestDbs {
+    businessDbPath: string;
+    systemDbPath: string;
+    businessRaw: Database.Database;
+    businessDb: Kysely<Record<string, never>>;
+    systemRaw: Database.Database;
+    systemDb: Kysely<SystemDB>;
+    cleanup: () => Promise<void>;
+}
+/** 创建临时业务库 + 系统库（每次唯一路径），返回句柄与 cleanup。 */
+export declare function createTestDbs(): Promise<TestDbs>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAIA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1C,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAID,2CAA2C;AAC3C,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CA8BtD"}

package/dist/test-helpers.js

@@ -0,0 +1,37 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import Database from 'better-sqlite3';
+import { Kysely, SqliteDialect } from 'kysely';
+let counter = 0;
+/** 创建临时业务库 + 系统库（每次唯一路径），返回句柄与 cleanup。 */
+export async function createTestDbs() {
+    const dir = mkdtempSync(join(tmpdir(), `1api-${randomBytes(4).toString('hex')}-`));
+    const businessDbPath = join(dir, `biz-${counter}.db`);
+    const systemDbPath = join(dir, `sys-${counter}.db`);
+    counter += 1;
+    const businessRaw = new Database(businessDbPath);
+    businessRaw.pragma('journal_mode = WAL');
+    const systemRaw = new Database(systemDbPath);
+    const businessDb = new Kysely({
+        dialect: new SqliteDialect({ database: businessRaw }),
+    });
+    const systemDb = new Kysely({
+        dialect: new SqliteDialect({ database: systemRaw }),
+    });
+    return {
+        businessDbPath,
+        systemDbPath,
+        businessRaw,
+        businessDb,
+        systemRaw,
+        systemDb,
+        cleanup: async () => {
+            await businessDb.destroy();
+            await systemDb.destroy();
+            rmSync(dir, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAa/C,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,OAAO,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,OAAO,KAAK,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,CAAC;IAEb,MAAM,WAAW,GAAG,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjD,WAAW,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,MAAM,CAAwB;QACnD,OAAO,EAAE,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAW;QACpC,OAAO,EAAE,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO;QACL,cAAc;QACd,YAAY;QACZ,WAAW;QACX,UAAU;QACV,SAAS;QACT,QAAQ;QACR,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@1api/engine",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "description": "one-api 纯逻辑数据引擎（元数据驱动 + 动态 SQL，无 HTTP/UI）",
+  "license": "MIT",
+  "author": "Yourtion <yourtion@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourtion/one-api.git",
+    "directory": "packages/engine"
+  },
+  "homepage": "https://github.com/yourtion/one-api#readme",
+  "bugs": {
+    "url": "https://github.com/yourtion/one-api/issues"
+  },
+  "keywords": [
+    "one-api",
+    "ai-native",
+    "database",
+    "engine",
+    "sqlite",
+    "kysely"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.0.0",
+    "kysely": "^0.29.0",
+    "@1api/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@vitest/coverage-v8": "^3",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}