@agile-team/mach-report 0.5.0 → 0.6.0

package/dist/sql.d.cts

@@ -1,95 +1,5 @@
-type TokenType = "literal" | "bind" | "subst" | "if" | "escape";
-interface Token {
-    type: TokenType;
-    text: string;
-    /** bind/subst 参数名；if 表达式源码 */
-    value?: string;
-    start: number;
-    end: number;
-}
-declare class SqlSyntaxError extends Error {
-    readonly position: number;
-    readonly source: string;
-    constructor(message: string, position: number, source: string);
-}
 /**
- * 扫描动态 SQL，产出 token 流：
- * - literal: 纯 SQL 文本（已反转义 \{ \}）
- * - bind:    #{name}
- * - subst:   ${name}
- * - if:      {if(expr, a, b)} —— value 为去壳后的参数串
- * - escape:  \{ 或 \}
+ * 动态 SQL 子路径入口（@agile-team/mach-report/sql）：
+ * jh4j 三语法编译 + 参数化渲染 + AST/词法双层单 SELECT 校验。
  */
-declare function tokenize(sql: string): Token[];
-/** 按顶层逗号拆分（忽略双引号内与括号/花括号内） */
-declare function splitTopLevel(input: string): string[];
-
-interface ExprContext {
-    params: Record<string, unknown>;
-}
-declare class ExprError extends Error {
-    constructor(message: string);
-}
-/**
- * 求值 jh4j 公式表达式（用于 {if(cond, a, b)} 的 cond 与操作数）：
- * - #param 引用（渲染时被替换为参数值；此实现按值求值）
- * - "..." 字符串字面量（仅双引号，与 jh4j 一致）
- * - isEmpty(x)、isNotEmpty(x)
- * - == / != 比较
- * - + 拼接
- */
-declare function evalExpr(input: string, ctx: ExprContext): unknown;
-/** {if(cond, whenTrue, whenFalse)} 的参数拆分（2 或 3 段，兼容 jh4j 三段式） */
-declare function parseIfArgs(inner: string): {
-    cond: string;
-    whenTrue: string;
-    whenFalse: string;
-};
-
-interface RenderedSql {
-    sql: string;
-    binds: unknown[];
-    warnings: string[];
-}
-interface CompiledSql {
-    original: string;
-    /** 参数名集合（bind 与 subst 并集） */
-    paramNames: string[];
-    render(params: Record<string, unknown>): RenderedSql;
-}
-declare class SqlValidationError extends Error {
-    readonly sql: string;
-    constructor(message: string, sql: string);
-}
-declare function compileDynamicSql(source: string): CompiledSql;
-/**
- * 去注释：-- 行注释、# 行注释（仅行首/空白后，且排除 #{ 绑定占位）、/* 块注释。
- * 注意：此函数用于校验口径，输出会折叠空白。
- */
-declare function stripSqlComments(sql: string): string;
-/**
- * 单 SELECT 结构校验（词法层；AST 级校验见 ast-check.ts 双保险）：
- * - 去注释后必须以 select 或 with 开头
- * - 语句内除末尾外不允许出现分号
- * - 顶层禁止 DML/DDL/调用关键字（字符串字面量内容不参与匹配）
- */
-declare function assertSingleSelect(sql: string): void;
-/** 便捷入口：编译 + 渲染 + 校验一体 */
-declare function renderDynamicSql(source: string, params: Record<string, unknown>): RenderedSql;
-
-interface AstCheckResult {
-    ok: boolean;
-    /** ast 深度校验是否执行（方言不支持时降级词法） */
-    degraded: boolean;
-    message?: string;
-}
-/**
- * AST 深度校验（双保险策略）：
- * 1. node-sql-parser（MySQL 方言，支持 ? 占位符）AST 顶层必须为 SELECT/集合运算
- * 2. AST 通过后再叠加词法校验（MySQL 方言把 SELECT INTO 解析为别名，AST 层不可见，
- *    由词法层兜底拦截）
- * AST 解析失败（方言不兼容）自动降级为纯词法校验，返回 degraded=true。
- */
-declare function assertSingleSelectAst(sql: string): AstCheckResult;
-
-export { type AstCheckResult, type CompiledSql, type ExprContext, ExprError, type RenderedSql, SqlSyntaxError, SqlValidationError, type Token, type TokenType, assertSingleSelect, assertSingleSelectAst, compileDynamicSql, evalExpr, parseIfArgs, renderDynamicSql, splitTopLevel, stripSqlComments, tokenize };
+export * from './sql/index';

package/dist/sql.d.ts

@@ -1,95 +1,5 @@
-type TokenType = "literal" | "bind" | "subst" | "if" | "escape";
-interface Token {
-    type: TokenType;
-    text: string;
-    /** bind/subst 参数名；if 表达式源码 */
-    value?: string;
-    start: number;
-    end: number;
-}
-declare class SqlSyntaxError extends Error {
-    readonly position: number;
-    readonly source: string;
-    constructor(message: string, position: number, source: string);
-}
 /**
- * 扫描动态 SQL，产出 token 流：
- * - literal: 纯 SQL 文本（已反转义 \{ \}）
- * - bind:    #{name}
- * - subst:   ${name}
- * - if:      {if(expr, a, b)} —— value 为去壳后的参数串
- * - escape:  \{ 或 \}
+ * 动态 SQL 子路径入口（@agile-team/mach-report/sql）：
+ * jh4j 三语法编译 + 参数化渲染 + AST/词法双层单 SELECT 校验。
  */
-declare function tokenize(sql: string): Token[];
-/** 按顶层逗号拆分（忽略双引号内与括号/花括号内） */
-declare function splitTopLevel(input: string): string[];
-
-interface ExprContext {
-    params: Record<string, unknown>;
-}
-declare class ExprError extends Error {
-    constructor(message: string);
-}
-/**
- * 求值 jh4j 公式表达式（用于 {if(cond, a, b)} 的 cond 与操作数）：
- * - #param 引用（渲染时被替换为参数值；此实现按值求值）
- * - "..." 字符串字面量（仅双引号，与 jh4j 一致）
- * - isEmpty(x)、isNotEmpty(x)
- * - == / != 比较
- * - + 拼接
- */
-declare function evalExpr(input: string, ctx: ExprContext): unknown;
-/** {if(cond, whenTrue, whenFalse)} 的参数拆分（2 或 3 段，兼容 jh4j 三段式） */
-declare function parseIfArgs(inner: string): {
-    cond: string;
-    whenTrue: string;
-    whenFalse: string;
-};
-
-interface RenderedSql {
-    sql: string;
-    binds: unknown[];
-    warnings: string[];
-}
-interface CompiledSql {
-    original: string;
-    /** 参数名集合（bind 与 subst 并集） */
-    paramNames: string[];
-    render(params: Record<string, unknown>): RenderedSql;
-}
-declare class SqlValidationError extends Error {
-    readonly sql: string;
-    constructor(message: string, sql: string);
-}
-declare function compileDynamicSql(source: string): CompiledSql;
-/**
- * 去注释：-- 行注释、# 行注释（仅行首/空白后，且排除 #{ 绑定占位）、/* 块注释。
- * 注意：此函数用于校验口径，输出会折叠空白。
- */
-declare function stripSqlComments(sql: string): string;
-/**
- * 单 SELECT 结构校验（词法层；AST 级校验见 ast-check.ts 双保险）：
- * - 去注释后必须以 select 或 with 开头
- * - 语句内除末尾外不允许出现分号
- * - 顶层禁止 DML/DDL/调用关键字（字符串字面量内容不参与匹配）
- */
-declare function assertSingleSelect(sql: string): void;
-/** 便捷入口：编译 + 渲染 + 校验一体 */
-declare function renderDynamicSql(source: string, params: Record<string, unknown>): RenderedSql;
-
-interface AstCheckResult {
-    ok: boolean;
-    /** ast 深度校验是否执行（方言不支持时降级词法） */
-    degraded: boolean;
-    message?: string;
-}
-/**
- * AST 深度校验（双保险策略）：
- * 1. node-sql-parser（MySQL 方言，支持 ? 占位符）AST 顶层必须为 SELECT/集合运算
- * 2. AST 通过后再叠加词法校验（MySQL 方言把 SELECT INTO 解析为别名，AST 层不可见，
- *    由词法层兜底拦截）
- * AST 解析失败（方言不兼容）自动降级为纯词法校验，返回 degraded=true。
- */
-declare function assertSingleSelectAst(sql: string): AstCheckResult;
-
-export { type AstCheckResult, type CompiledSql, type ExprContext, ExprError, type RenderedSql, SqlSyntaxError, SqlValidationError, type Token, type TokenType, assertSingleSelect, assertSingleSelectAst, compileDynamicSql, evalExpr, parseIfArgs, renderDynamicSql, splitTopLevel, stripSqlComments, tokenize };
+export * from './sql/index';