fdb2 1.0.27 → 1.0.31

package/dist/server/cli/parse.d.ts

@@ -0,0 +1,18 @@
+export type OptType = 'bool' | 'string' | 'int' | 'list' | 'json';
+export interface OptDef {
+    name: string;
+    alias?: string;
+    type: OptType;
+}
+export interface Parsed {
+    pos: string[];
+    values: Record<string, any>;
+}
+/** 全局通用选项（每个命令都可用） */
+export declare const GLOBAL_DEFS: OptDef[];
+export declare function parseArgs(argv: string[], extraDefs?: OptDef[]): Parsed;
+/** k=v 列表解析 */
+export declare function parseKvList(list: string[]): Record<string, any>;
+/** csv 拆分（--select a,b） */
+export declare function splitCsv(s?: string): string[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/server/cli/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../server/cli/parse.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,sBAAsB;AACtB,eAAO,MAAM,WAAW,EAAE,MAAM,EA0B/B,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,MAAM,CAqE1E;AAED,eAAe;AACf,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAU/D;AAED,2BAA2B;AAC3B,wBAAgB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAM7C"}

package/dist/server/cli/parse.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_DEFS = void 0;
+exports.parseArgs = parseArgs;
+exports.parseKvList = parseKvList;
+exports.splitCsv = splitCsv;
+/**
+ * 轻量参数解析器（零依赖）
+ * 支持：--k v、--k=v、-a v；可重复 list 参数（--filter a --filter b）
+ */
+const errors_1 = require("../core/errors");
+/** 全局通用选项（每个命令都可用） */
+exports.GLOBAL_DEFS = [
+    { name: 'json', type: 'bool' },
+    { name: 'quiet', type: 'bool' },
+    { name: 'yes', type: 'bool' },
+    { name: 'write', type: 'bool' },
+    { name: 'dry-run', alias: 'dry', type: 'bool' },
+    { name: 'confirm', type: 'string' },
+    { name: 'force', type: 'bool' },
+    { name: 'conn', type: 'string' },
+    { name: 'db', type: 'string' },
+    { name: 'limit', type: 'int' },
+    { name: 'offset', type: 'int' },
+    { name: 'count', type: 'bool' },
+    { name: 'out', type: 'string' },
+    // 连接参数
+    { name: 'name', type: 'string' },
+    { name: 'type', type: 'string' },
+    { name: 'host', type: 'string' },
+    { name: 'port', type: 'int' },
+    { name: 'database', type: 'string' },
+    { name: 'username', type: 'string' },
+    { name: 'password', type: 'string' },
+    { name: 'password-stdin', type: 'bool' },
+    { name: 'ssl', type: 'bool' },
+    { name: 'option', type: 'list' },
+    { name: 'enabled', type: 'string' }
+];
+function parseArgs(argv, extraDefs = []) {
+    const defs = extraDefs.concat(exports.GLOBAL_DEFS);
+    const index = {};
+    for (const d of defs) {
+        index['--' + d.name] = d;
+        if (d.alias)
+            index['-' + d.alias] = d;
+    }
+    const pos = [];
+    const values = {};
+    let i = 0;
+    const setVal = (def, rawVal, hasEq) => {
+        if (def.type === 'bool') {
+            values[def.name] = hasEq ? !(rawVal === 'false' || rawVal === '0') : true;
+            return;
+        }
+        if (rawVal === null || rawVal === undefined) {
+            throw new errors_1.AppError('PARAM_ERROR', `选项 --${def.name} 缺少值`);
+        }
+        if (def.type === 'int') {
+            const n = Math.floor(Number(rawVal));
+            if (!Number.isFinite(n))
+                throw new errors_1.AppError('PARAM_ERROR', `选项 --${def.name} 需要整数，收到: ${rawVal}`);
+            values[def.name] = n;
+        }
+        else if (def.type === 'list') {
+            if (!values[def.name])
+                values[def.name] = [];
+            values[def.name].push(rawVal);
+        }
+        else if (def.type === 'json') {
+            try {
+                values[def.name] = JSON.parse(rawVal);
+            }
+            catch (e) {
+                throw new errors_1.AppError('PARAM_ERROR', `选项 --${def.name} 需要合法 JSON，收到: ${rawVal}`);
+            }
+        }
+        else {
+            values[def.name] = rawVal;
+        }
+    };
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token === '--') {
+            pos.push(...argv.slice(i + 1));
+            break;
+        }
+        if (token.startsWith('--') || (token.startsWith('-') && token.length > 1 && !/^-\d/.test(token))) {
+            const eq = token.indexOf('=');
+            const key = eq > 0 ? token.slice(0, eq) : token;
+            const def = index[key];
+            if (!def) {
+                throw new errors_1.AppError('PARAM_ERROR', `未知选项: ${token}`, { hint: `可用选项: ${Object.keys(index).join(' ')}` });
+            }
+            if (eq > 0) {
+                setVal(def, token.slice(eq + 1), true);
+                i++;
+            }
+            else if (def.type === 'bool') {
+                setVal(def, null, false);
+                i++;
+            }
+            else {
+                const next = argv[i + 1];
+                if (next === undefined)
+                    throw new errors_1.AppError('PARAM_ERROR', `选项 --${def.name} 缺少值`);
+                setVal(def, next, false);
+                i += 2;
+            }
+        }
+        else {
+            pos.push(token);
+            i++;
+        }
+    }
+    return { pos, values };
+}
+/** k=v 列表解析 */
+function parseKvList(list) {
+    const out = {};
+    for (const item of list || []) {
+        const eq = item.indexOf('=');
+        if (eq <= 0)
+            throw new errors_1.AppError('PARAM_ERROR', `选项格式应为 k=v，收到: ${item}`);
+        const k = item.slice(0, eq).trim();
+        const v = item.slice(eq + 1).trim();
+        out[k] = coerceOptValue(v);
+    }
+    return out;
+}
+/** csv 拆分（--select a,b） */
+function splitCsv(s) {
+    if (!s)
+        return [];
+    return String(s)
+        .split(',')
+        .map((x) => x.trim())
+        .filter(Boolean);
+}
+function coerceOptValue(v) {
+    if (v === 'true')
+        return true;
+    if (v === 'false')
+        return false;
+    const n = Number(v);
+    if (v !== '' && !Number.isNaN(n) && String(v).trim() !== '')
+        return n;
+    return v;
+}
+//# sourceMappingURL=parse.js.map

package/dist/server/cli/parse.js.map

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

package/dist/server/cli/parse.ts

@@ -0,0 +1,148 @@
+/**
+ * 轻量参数解析器（零依赖）
+ * 支持：--k v、--k=v、-a v；可重复 list 参数（--filter a --filter b）
+ */
+import { AppError } from '../core/errors';
+
+export type OptType = 'bool' | 'string' | 'int' | 'list' | 'json';
+
+export interface OptDef {
+  name: string;
+  alias?: string;
+  type: OptType;
+}
+
+export interface Parsed {
+  pos: string[];
+  values: Record<string, any>;
+}
+
+/** 全局通用选项（每个命令都可用） */
+export const GLOBAL_DEFS: OptDef[] = [
+  { name: 'json', type: 'bool' },
+  { name: 'quiet', type: 'bool' },
+  { name: 'yes', type: 'bool' },
+  { name: 'write', type: 'bool' },
+  { name: 'dry-run', alias: 'dry', type: 'bool' },
+  { name: 'confirm', type: 'string' },
+  { name: 'force', type: 'bool' },
+  { name: 'conn', type: 'string' },
+  { name: 'db', type: 'string' },
+  { name: 'limit', type: 'int' },
+  { name: 'offset', type: 'int' },
+  { name: 'count', type: 'bool' },
+  { name: 'out', type: 'string' },
+  // 连接参数
+  { name: 'name', type: 'string' },
+  { name: 'type', type: 'string' },
+  { name: 'host', type: 'string' },
+  { name: 'port', type: 'int' },
+  { name: 'database', type: 'string' },
+  { name: 'username', type: 'string' },
+  { name: 'password', type: 'string' },
+  { name: 'password-stdin', type: 'bool' },
+  { name: 'ssl', type: 'bool' },
+  { name: 'option', type: 'list' },
+  { name: 'enabled', type: 'string' }
+];
+
+export function parseArgs(argv: string[], extraDefs: OptDef[] = []): Parsed {
+  const defs = extraDefs.concat(GLOBAL_DEFS);
+  const index: Record<string, OptDef> = {};
+  for (const d of defs) {
+    index['--' + d.name] = d;
+    if (d.alias) index['-' + d.alias] = d;
+  }
+
+  const pos: string[] = [];
+  const values: Record<string, any> = {};
+  let i = 0;
+
+  const setVal = (def: OptDef, rawVal: string | null, hasEq: boolean) => {
+    if (def.type === 'bool') {
+      values[def.name] = hasEq ? !(rawVal === 'false' || rawVal === '0') : true;
+      return;
+    }
+    if (rawVal === null || rawVal === undefined) {
+      throw new AppError('PARAM_ERROR', `选项 --${def.name} 缺少值`);
+    }
+    if (def.type === 'int') {
+      const n = Math.floor(Number(rawVal));
+      if (!Number.isFinite(n)) throw new AppError('PARAM_ERROR', `选项 --${def.name} 需要整数，收到: ${rawVal}`);
+      values[def.name] = n;
+    } else if (def.type === 'list') {
+      if (!values[def.name]) values[def.name] = [];
+      values[def.name].push(rawVal);
+    } else if (def.type === 'json') {
+      try {
+        values[def.name] = JSON.parse(rawVal);
+      } catch (e) {
+        throw new AppError('PARAM_ERROR', `选项 --${def.name} 需要合法 JSON，收到: ${rawVal}`);
+      }
+    } else {
+      values[def.name] = rawVal;
+    }
+  };
+
+  while (i < argv.length) {
+    const token = argv[i];
+    if (token === '--') {
+      pos.push(...argv.slice(i + 1));
+      break;
+    }
+    if (token.startsWith('--') || (token.startsWith('-') && token.length > 1 && !/^-\d/.test(token))) {
+      const eq = token.indexOf('=');
+      const key = eq > 0 ? token.slice(0, eq) : token;
+      const def = index[key];
+      if (!def) {
+        throw new AppError('PARAM_ERROR', `未知选项: ${token}`, { hint: `可用选项: ${Object.keys(index).join(' ')}` });
+      }
+      if (eq > 0) {
+        setVal(def, token.slice(eq + 1), true);
+        i++;
+      } else if (def.type === 'bool') {
+        setVal(def, null, false);
+        i++;
+      } else {
+        const next = argv[i + 1];
+        if (next === undefined) throw new AppError('PARAM_ERROR', `选项 --${def.name} 缺少值`);
+        setVal(def, next, false);
+        i += 2;
+      }
+    } else {
+      pos.push(token);
+      i++;
+    }
+  }
+  return { pos, values };
+}
+
+/** k=v 列表解析 */
+export function parseKvList(list: string[]): Record<string, any> {
+  const out: Record<string, any> = {};
+  for (const item of list || []) {
+    const eq = item.indexOf('=');
+    if (eq <= 0) throw new AppError('PARAM_ERROR', `选项格式应为 k=v，收到: ${item}`);
+    const k = item.slice(0, eq).trim();
+    const v = item.slice(eq + 1).trim();
+    out[k] = coerceOptValue(v);
+  }
+  return out;
+}
+
+/** csv 拆分（--select a,b） */
+export function splitCsv(s?: string): string[] {
+  if (!s) return [];
+  return String(s)
+    .split(',')
+    .map((x) => x.trim())
+    .filter(Boolean);
+}
+
+function coerceOptValue(v: string): any {
+  if (v === 'true') return true;
+  if (v === 'false') return false;
+  const n = Number(v);
+  if (v !== '' && !Number.isNaN(n) && String(v).trim() !== '') return n;
+  return v;
+}

package/dist/server/core/column-spec.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 列定义 DSL：name:type[:约束...]
+ * 约束: primary | auto_increment | not_null | null | unique
+ *       default=<v> | comment=<str> | len=<n> | precision=<p[,s]>
+ * 示例: id:int:primary:auto_increment
+ *       name:varchar:len=64:not_null
+ *       amount:decimal:precision=10,2:default=0
+ */
+export interface ParsedColumn {
+    name: string;
+    /** 类型全名（含长度），如 varchar(64) */
+    type: string;
+    /** 基础类型，如 varchar */
+    baseType: string;
+    nullable: boolean;
+    isPrimary: boolean;
+    isAutoIncrement: boolean;
+    unique: boolean;
+    defaultValue?: any;
+    hasDefault: boolean;
+    comment?: string;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    /** 原始 spec 字符串 */
+    raw: string;
+}
+export declare function parseColumnSpec(spec: string): ParsedColumn;
+//# sourceMappingURL=column-spec.d.ts.map

package/dist/server/core/column-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-spec.d.ts","sourceRoot":"","sources":["../../../server/core/column-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA0E1D"}

package/dist/server/core/column-spec.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * 列定义 DSL：name:type[:约束...]
+ * 约束: primary | auto_increment | not_null | null | unique
+ *       default=<v> | comment=<str> | len=<n> | precision=<p[,s]>
+ * 示例: id:int:primary:auto_increment
+ *       name:varchar:len=64:not_null
+ *       amount:decimal:precision=10,2:default=0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseColumnSpec = parseColumnSpec;
+function parseColumnSpec(spec) {
+    if (!spec || typeof spec !== 'string')
+        throw new Error('列定义不能为空');
+    const parts = splitColon(spec);
+    if (parts.length < 2) {
+        throw new Error(`列定义格式应为 "名称:类型[:约束...]"，收到: ${spec}`);
+    }
+    const name = parts[0].trim();
+    const typeRaw = parts[1].trim();
+    if (!name || !typeRaw)
+        throw new Error(`列定义无效: ${spec}`);
+    const col = {
+        name,
+        type: typeRaw,
+        baseType: typeRaw.split('(')[0].trim().toLowerCase(),
+        nullable: true,
+        isPrimary: false,
+        isAutoIncrement: false,
+        unique: false,
+        hasDefault: false,
+        raw: spec
+    };
+    // 提取类型长度
+    const lenMatch = /\((\d+)(?:,\s*(\d+))?\)/.exec(typeRaw);
+    if (lenMatch) {
+        col.length = parseInt(lenMatch[1], 10);
+        if (lenMatch[2])
+            col.precision = parseInt(lenMatch[2], 10);
+        if (lenMatch[2])
+            col.scale = parseInt(lenMatch[2], 10);
+        col.type = typeRaw; // 保持原样
+    }
+    else {
+        // 无长度时按基础类型输出
+        col.type = col.baseType;
+    }
+    for (const rawMod of parts.slice(2)) {
+        const mod = rawMod.trim();
+        const lower = mod.toLowerCase();
+        if (lower === 'primary') {
+            col.isPrimary = true;
+        }
+        else if (lower === 'auto_increment' || lower === 'ai') {
+            col.isAutoIncrement = true;
+            col.isPrimary = true;
+        }
+        else if (lower === 'not_null' || lower === 'notnull') {
+            col.nullable = false;
+        }
+        else if (lower === 'null' || lower === 'nullable') {
+            col.nullable = true;
+        }
+        else if (lower === 'unique') {
+            col.unique = true;
+        }
+        else if (lower.startsWith('default=')) {
+            col.hasDefault = true;
+            col.defaultValue = parseDefault(mod.slice('default='.length));
+        }
+        else if (lower.startsWith('comment=')) {
+            col.comment = unquote(mod.slice('comment='.length));
+        }
+        else if (lower.startsWith('len=')) {
+            col.length = parseInt(mod.slice('len='.length), 10);
+            col.type = `${col.baseType}(${col.length})`;
+        }
+        else if (lower.startsWith('length=')) {
+            col.length = parseInt(mod.slice('length='.length), 10);
+            col.type = `${col.baseType}(${col.length})`;
+        }
+        else if (lower.startsWith('precision=')) {
+            const pv = mod.slice('precision='.length).split(',');
+            col.precision = parseInt(pv[0], 10);
+            if (pv[1] !== undefined) {
+                col.scale = parseInt(pv[1], 10);
+                col.type = `${col.baseType}(${col.precision},${col.scale})`;
+            }
+            else {
+                col.type = `${col.baseType}(${col.precision})`;
+            }
+        }
+        else {
+            throw new Error(`列 "${name}" 的约束无效: ${mod}`);
+        }
+    }
+    return col;
+}
+function splitColon(spec) {
+    // 用 '\' 转义冒号
+    const parts = [];
+    let current = '';
+    let escaped = false;
+    for (const ch of spec) {
+        if (escaped) {
+            current += ch;
+            escaped = false;
+        }
+        else if (ch === '\\') {
+            escaped = true;
+        }
+        else if (ch === ':') {
+            parts.push(current);
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (escaped)
+        current += '\\';
+    parts.push(current);
+    return parts;
+}
+function unquote(s) {
+    const t = s.trim();
+    if ((t.startsWith("'") && t.endsWith("'")) || (t.startsWith('"') && t.endsWith('"'))) {
+        return t.slice(1, -1);
+    }
+    return t;
+}
+function parseDefault(raw) {
+    const v = raw.trim();
+    const up = v.toUpperCase();
+    if (up === 'NULL')
+        return null;
+    if (up === 'TRUE')
+        return true;
+    if (up === 'FALSE')
+        return false;
+    if (up === 'CURRENT_TIMESTAMP' || up === 'NOW()' || up === 'CURRENT_DATE')
+        return up;
+    // 数字
+    if (/^-?\d+(\.\d+)?$/.test(v))
+        return Number(v);
+    return unquote(v);
+}
+//# sourceMappingURL=column-spec.js.map

package/dist/server/core/column-spec.js.map

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

package/dist/server/core/column-spec.ts

@@ -0,0 +1,147 @@
+/**
+ * 列定义 DSL：name:type[:约束...]
+ * 约束: primary | auto_increment | not_null | null | unique
+ *       default=<v> | comment=<str> | len=<n> | precision=<p[,s]>
+ * 示例: id:int:primary:auto_increment
+ *       name:varchar:len=64:not_null
+ *       amount:decimal:precision=10,2:default=0
+ */
+
+export interface ParsedColumn {
+  name: string;
+  /** 类型全名（含长度），如 varchar(64) */
+  type: string;
+  /** 基础类型，如 varchar */
+  baseType: string;
+  nullable: boolean;
+  isPrimary: boolean;
+  isAutoIncrement: boolean;
+  unique: boolean;
+  defaultValue?: any;
+  hasDefault: boolean;
+  comment?: string;
+  length?: number;
+  precision?: number;
+  scale?: number;
+  /** 原始 spec 字符串 */
+  raw: string;
+}
+
+export function parseColumnSpec(spec: string): ParsedColumn {
+  if (!spec || typeof spec !== 'string') throw new Error('列定义不能为空');
+  const parts = splitColon(spec);
+  if (parts.length < 2) {
+    throw new Error(`列定义格式应为 "名称:类型[:约束...]"，收到: ${spec}`);
+  }
+  const name = parts[0].trim();
+  const typeRaw = parts[1].trim();
+  if (!name || !typeRaw) throw new Error(`列定义无效: ${spec}`);
+
+  const col: ParsedColumn = {
+    name,
+    type: typeRaw,
+    baseType: typeRaw.split('(')[0].trim().toLowerCase(),
+    nullable: true,
+    isPrimary: false,
+    isAutoIncrement: false,
+    unique: false,
+    hasDefault: false,
+    raw: spec
+  };
+
+  // 提取类型长度
+  const lenMatch = /\((\d+)(?:,\s*(\d+))?\)/.exec(typeRaw);
+  if (lenMatch) {
+    col.length = parseInt(lenMatch[1], 10);
+    if (lenMatch[2]) col.precision = parseInt(lenMatch[2], 10);
+    if (lenMatch[2]) col.scale = parseInt(lenMatch[2], 10);
+    col.type = typeRaw; // 保持原样
+  } else {
+    // 无长度时按基础类型输出
+    col.type = col.baseType;
+  }
+
+  for (const rawMod of parts.slice(2)) {
+    const mod = rawMod.trim();
+    const lower = mod.toLowerCase();
+    if (lower === 'primary') {
+      col.isPrimary = true;
+    } else if (lower === 'auto_increment' || lower === 'ai') {
+      col.isAutoIncrement = true;
+      col.isPrimary = true;
+    } else if (lower === 'not_null' || lower === 'notnull') {
+      col.nullable = false;
+    } else if (lower === 'null' || lower === 'nullable') {
+      col.nullable = true;
+    } else if (lower === 'unique') {
+      col.unique = true;
+    } else if (lower.startsWith('default=')) {
+      col.hasDefault = true;
+      col.defaultValue = parseDefault(mod.slice('default='.length));
+    } else if (lower.startsWith('comment=')) {
+      col.comment = unquote(mod.slice('comment='.length));
+    } else if (lower.startsWith('len=')) {
+      col.length = parseInt(mod.slice('len='.length), 10);
+      col.type = `${col.baseType}(${col.length})`;
+    } else if (lower.startsWith('length=')) {
+      col.length = parseInt(mod.slice('length='.length), 10);
+      col.type = `${col.baseType}(${col.length})`;
+    } else if (lower.startsWith('precision=')) {
+      const pv = mod.slice('precision='.length).split(',');
+      col.precision = parseInt(pv[0], 10);
+      if (pv[1] !== undefined) {
+        col.scale = parseInt(pv[1], 10);
+        col.type = `${col.baseType}(${col.precision},${col.scale})`;
+      } else {
+        col.type = `${col.baseType}(${col.precision})`;
+      }
+    } else {
+      throw new Error(`列 "${name}" 的约束无效: ${mod}`);
+    }
+  }
+
+  return col;
+}
+
+function splitColon(spec: string): string[] {
+  // 用 '\' 转义冒号
+  const parts: string[] = [];
+  let current = '';
+  let escaped = false;
+  for (const ch of spec) {
+    if (escaped) {
+      current += ch;
+      escaped = false;
+    } else if (ch === '\\') {
+      escaped = true;
+    } else if (ch === ':') {
+      parts.push(current);
+      current = '';
+    } else {
+      current += ch;
+    }
+  }
+  if (escaped) current += '\\';
+  parts.push(current);
+  return parts;
+}
+
+function unquote(s: string): string {
+  const t = s.trim();
+  if ((t.startsWith("'") && t.endsWith("'")) || (t.startsWith('"') && t.endsWith('"'))) {
+    return t.slice(1, -1);
+  }
+  return t;
+}
+
+function parseDefault(raw: string): any {
+  const v = raw.trim();
+  const up = v.toUpperCase();
+  if (up === 'NULL') return null;
+  if (up === 'TRUE') return true;
+  if (up === 'FALSE') return false;
+  if (up === 'CURRENT_TIMESTAMP' || up === 'NOW()' || up === 'CURRENT_DATE') return up;
+  // 数字
+  if (/^-?\d+(\.\d+)?$/.test(v)) return Number(v);
+  return unquote(v);
+}