@zhongmiao/meta-lc-query

English | 中文文档

Package Role

query compiles platform query AST into SQL and parameter lists. It is an AST-first compiler package, not a database executor or orchestration layer.

Responsibilities

• Define query AST, compiler input, and output types.
• Build SelectQueryAst from legacy query requests for compatibility.
• Convert AST table, fields, predicates, and limit into safe SQL fragments.
• Keep SQL generation testable without a live database.

Relationship With Other Packages

• Upstream: runtime and permission.
• Downstream: none as a package dependency; runtime hands compiled SQL or compiled query requests to datasource during execution.
• runtime calls query compilation through its query compiler adapter before datasource execution.
• permission transforms query AST before final SQL compilation.
• datasource executes compiled SQL; query does not depend on datasource.
• runtime owns V2 query node shapes and adapts them into query compiler input.

Minimal Flow

flowchart LR
  Request["QueryRequest compatibility input"] --> AstBuilder["Query AST Builder"]
  AstBuilder --> Ast["SelectQueryAst"]
  Ast --> Permission["Permission AST Transform"]
  Permission --> Compiler["AST SQL Compiler"]
  Compiler --> Sql["SQL + params"]
  Sql --> Executor["Datasource adapter"]

Commands

pnpm --filter @zhongmiao/meta-lc-query build
pnpm --filter @zhongmiao/meta-lc-query test

Boundary Notes

• Do not open DB connections here.
• Must not execute SQL.
• Must not depend on datasource.
• Do not add runtime orchestration or BFF page request semantics here.
• Keep permission policy resolution outside this package; consume permission-transformed AST predicates.