@ctil/gql 1.0.0

package/src/builders/baseType.ts

@@ -0,0 +1,194 @@
+export type FieldInput =
+  | string
+  | { [key: string]: FieldNode };
+
+export interface FieldNode {
+  fields: FieldInput[];
+  where?: WhereInput;
+  orderBy?: Record<string, any>;
+  distinctOn?: string[];
+  limit?: number;
+  offset?: number;
+}
+
+// where条件
+export interface WhereInput {
+  _and?: WhereInput[];
+  _or?: WhereInput[];
+  _not?: WhereInput;
+  [field: string]: any;
+}
+
+
+/** 构造 where 字段，所有非变量都转成字符串 */
+export function buildWhere(where: WhereInput): string {
+  if (!where) return "";
+  const parts: string[] = [];
+  for (const key in where) {
+    const value = where[key];
+    if (key === "_and" || key === "_or") {
+      const sub = (value as WhereInput[])
+        .map(w => `{ ${buildWhere(w)} }`)
+        .filter(Boolean)
+        .join(", ");
+      if (sub) parts.push(`${key}: [${sub}]`);
+    } else if (key === "_not") {
+      const sub = buildWhere(value as WhereInput);
+      if (sub) parts.push(`${key}: { ${sub} }`);
+    } else if (typeof value === "object" && value !== null) {
+      const conds = Object.entries(value)
+        .map(([op, val]) => {
+          if (typeof val === "string" && val.startsWith("$")) return `${op}: ${val}`;
+          return `${op}: ${JSON.stringify(String(val))}`; // 强制转字符串
+        })
+        .join(", ");
+      parts.push(`${key}: { ${conds} }`);
+    } else {
+      if (typeof value === "string" && value.startsWith("$")) {
+        parts.push(`${key}: ${value}`);
+      } else {
+        parts.push(`${key}: ${JSON.stringify(String(value))}`); // 强制转字符串
+      }
+    }
+  }
+  return parts.join(", ");
+}
+
+/** 构造字段 */
+export function buildFields(fields: FieldInput[]): string {
+  return fields
+    .map(f => {
+      if (typeof f === "string") return f;
+      const [key, node] = Object.entries(f)[0];
+      const args: string[] = [];
+      if (node.where) args.push(`where: { ${buildWhere(node.where)} }`);
+      if (node.distinctOn) args.push(`distinct_on: [${node.distinctOn.map(s => `${s}`).join(" ")}]`);
+      if (node.orderBy)
+        args.push(
+          `order_by: {${Object.entries(node.orderBy)
+            .map(([k, v]) => `${k}: ${v}`) // order_by 值不加引号
+            .join(" ")}}`
+        );
+      if (node.limit !== undefined) args.push(`limit: ${node.limit}`);
+      if (node.offset !== undefined) args.push(`offset: ${node.offset}`);
+      const argsStr = args.length ? `(${args.join(" ")})` : "";
+      return `${key}${argsStr} { ${buildFields(node.fields)} }`;
+    })
+    .join(" ");
+}
+
+
+
+
+
+// =================== 返回字段类型 ===================
+
+
+/** 构建 mutation 返回字段 */
+export function buildMutationFields(fields: FieldInput[]): string {
+  return `affected_rows returning { ${buildFields(fields)} }`;
+}
+
+/** 构建对象数据为 GraphQL 参数格式 */
+export function buildDataValue(data: Record<string, any>): string {
+  // 构建嵌套对象结构
+  const parts: string[] = [];
+  for (const key in data) {
+    const value = data[key];
+    if (value === null || value === undefined) continue;
+
+    if (typeof value === 'string' && value.startsWith('$')) {
+      // 变量引用，不加引号
+      parts.push(`${key}: ${value}`);
+    } else if (typeof value === 'object' && !Array.isArray(value) && value.constructor === Object) {
+      // 嵌套对象（纯对象）
+      parts.push(`${key}: { ${buildDataValue(value as Record<string, any>)} }`);
+    } else if (Array.isArray(value)) {
+      // 数组
+      const arrStr = value
+        .map(v => {
+          if (typeof v === 'string' && v.startsWith('$')) return v;
+          if (typeof v === 'object' && v !== null && v.constructor === Object) {
+            return `{ ${buildDataValue(v as Record<string, any>)} }`;
+          }
+          return formatGraphQLValue(v);
+        })
+        .join(' ');
+      parts.push(`${key}: [${arrStr}]`);
+    } else {
+      // 基本类型
+      parts.push(`${key}: ${formatGraphQLValue(value)}`);
+    }
+  }
+  return parts.join(' ');
+}
+
+/** 格式化 GraphQL 值 */
+export function formatGraphQLValue(value: any): string {
+  if (value === null) return 'null';
+  if (typeof value === 'string') {
+    // 字符串需要加引号
+    return JSON.stringify(value);
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
+    // 数字和布尔值不加引号
+    return String(value);
+  }
+  // 其他类型转为 JSON
+  return JSON.stringify(value);
+}
+
+
+
+/**
+ * 根据 Java 命名规则生成 GraphQL 实际操作名
+ * @param entityName 实体名（首字母大写或驼峰）
+ * @param original Java 方法名（例如 "gql_insertOne"）
+ */
+export function generateOperationName(entityName: string, original: string): string {
+  const lower = original.toLowerCase();
+  const e = entityName.toLowerCase();
+
+  if (original.startsWith("gql_")) {
+    if (lower.endsWith("pagelist")) return `get${toPascalCase(entityName)}PageList`;
+    if (lower.endsWith("querylist")) return `${e}s`;
+    if (lower.endsWith("getbyid")) return `${e}_by_pk`;
+    if (lower.endsWith("aggregate")) return `${e}_aggregateount`;
+
+    if (lower.endsWith("insertone")) return `insert_${e}_one`;
+    if (lower.endsWith("batchinsert")) return `insert_${e}s`;
+
+    if (lower.endsWith("batchupdate")) return `update_${e}_many`;
+    if (lower.endsWith("updatebypk")) return `update_${e}_by_pk`;
+    if (lower.endsWith("update")) return `update_${e}`;
+
+    if (lower.endsWith("deletebyid")) return `delete_${e}_by_pk`;
+    if (lower.endsWith("delete")) return `delete_${e}`;
+  }
+  return original;
+}
+
+
+// 首字母大写函数
+export function toPascalCase(str: string): string {
+  const camel = str
+    .replace(/[-_ ]+(\w)/g, (_, c) => (c ? c.toUpperCase() : ''))
+    .replace(/^\w/, c => c.toLowerCase());
+  return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+
+
+
+// ------------------- 通用：CommonResult 选择集构建 -------------------
+export function buildCommonResultSelection(dataFields?: FieldInput[]): string {
+  if (dataFields && dataFields.length > 0) {
+    return `success code message data { ${buildFields(dataFields)} }`;
+  }
+  // data 为标量（例如 Boolean）时，不能选择子字段
+  return `success code message data`;
+}
+
+
+
+
+

package/src/builders/index.ts

@@ -0,0 +1,5 @@
+// export * from './baseType.js';
+export * from './query.ts';
+export * from './mutation.ts';
+export * from './sms.ts';
+export * from './auth.ts';

package/src/builders/mutation.ts

@@ -0,0 +1,341 @@
+import { buildWhere, buildFields, buildDataValue,formatGraphQLValue,buildMutationFields,buildCommonResultSelection } from './baseType.ts';
+import type { WhereInput, FieldInput } from './baseType.ts';
+
+// =================== 插入 ===================
+
+// 单个插入入参
+export interface InsertOneInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段
+  data: Record<string, any>; // 插入的数据
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// 批量插入入参
+export interface BatchInsertInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段
+  datas: Record<string, any>[]; // 插入的数据列表
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// =================== 修改 ===================
+
+// 根据条件更新入参
+export interface UpdateInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段
+  _set: Record<string, any>; // 更新的数据
+  where: WhereInput; // 条件（必需）
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// 批量更新入参（根据 ID）
+export interface BatchUpdateInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段
+  _set: Record<string, any>[]; // 更新的数据列表（每条必须包含 id）
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// 根据主键更新入参
+export interface UpdateByPkInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段
+  _set: Record<string, any>; // 更新的数据
+  pk_columns: string | number; // 主键ID
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// =================== 删除 ===================
+
+// 根据主键删除入参
+export interface DeleteByIdInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段（删除前的数据）
+  pk_columns: string | number; // 主键ID
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// 根据条件删除入参
+export interface DeleteInput {
+  operationName: string; // 实体名，例如 user
+  fields: FieldInput[]; // 返回字段（删除前的数据）
+  where: WhereInput; // 条件（必需）
+  variables?: Record<string, any>; // 传入的变量名和初始值
+}
+
+// =================== 返回字段类型 ===================
+
+// Mutation 返回字段
+export type MutationField = {
+  affected_rows?: boolean; // 是否返回受影响行数
+  returning?: FieldInput[]; // 返回的数据字段
+};
+
+
+
+
+// =================== 插入操作 ===================
+
+/** 生成单个插入的 GraphQL mutation */
+export function buildGraphQLMutationInsertOne(input: InsertOneInput) {
+  const { operationName, fields, data, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // 构建 data 参数（可以作为变量传入，或直接内联）
+  let dataArg: string;
+  if (variables && variables.data) {
+    dataArg = '$data';
+  } else {
+    dataArg = `{ ${buildDataValue(data)} }`;
+  }
+
+  // 更新 variables
+  const finalVariables: Record<string, any> = variables || {};
+  if (!variables || !variables.data) {
+    finalVariables.data = data;
+  }
+
+  const mutationName = `insert_${entityName}_one`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${operationName}: ${dataArg}) {
+      ${buildMutationFields(fields)}
+    }
+  }`;
+
+  return { query, variables: finalVariables };
+}
+
+/** 生成批量插入的 GraphQL mutation */
+export function buildGraphQLMutationBatchInsert(input: BatchInsertInput) {
+  const { operationName, fields, datas, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // 构建 datas 参数
+  let datasArg: string;
+  if (variables && variables.datas) {
+    datasArg = '$datas';
+  } else {
+    const datasArr = datas.map(d => `{ ${buildDataValue(d)} }`).join(' ');
+    datasArg = `[${datasArr}]`;
+  }
+
+  // 更新 variables
+  const finalVariables: Record<string, any> = variables || {};
+  if (!variables || !variables.datas) {
+    finalVariables.datas = datas;
+  }
+
+  const mutationName = `insert_${entityName}s`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${operationName}s: ${datasArg}) {
+      affected_rows
+      returning { ${buildFields(fields)} }
+    }
+  }`;
+
+  return { query, variables: finalVariables };
+}
+
+
+
+
+// =================== 修改操作 ===================
+
+/** 生成根据条件更新的 GraphQL mutation */
+export function buildGraphQLMutationUpdate(input: UpdateInput) {
+  const { operationName, fields, _set, where, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // 构建参数
+  const args: string[] = [];
+
+  // _set 参数
+  let setArg: string;
+  if (variables && variables._set) {
+    setArg = '$_set';
+  } else {
+    setArg = `{ ${buildDataValue(_set)} }`;
+  }
+  args.push(`_set: ${setArg}`);
+
+  // where 参数
+  args.push(`where: { ${buildWhere(where)} }`);
+
+  // 更新 variables
+  const finalVariables: Record<string, any> = variables || {};
+  if (!variables || !variables._set) {
+    finalVariables._set = _set;
+  }
+
+  const mutationName = `update_${entityName}`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${args.join(', ')}) {
+      ${buildMutationFields(fields)}
+    }
+  }`;
+
+  return { query, variables: finalVariables };
+}
+
+/** 生成批量更新的 GraphQL mutation（根据 ID） */
+export function buildGraphQLMutationBatchUpdate(input: BatchUpdateInput) {
+  const { operationName, fields, _set, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // 构建 _set 参数
+  let setArg: string;
+  if (variables && variables._set) {
+    setArg = '$_set';
+  } else {
+    const setsArr = _set.map(s => `{ ${buildDataValue(s)} }`).join(' ');
+    setArg = `[${setsArr}]`;
+  }
+
+  // 更新 variables
+  const finalVariables: Record<string, any> = variables || {};
+  if (!variables || !variables._set) {
+    finalVariables._set = _set;
+  }
+
+  const mutationName = `update_${entityName}_many`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(_set: ${setArg}) {
+      affected_rows
+      returning { ${buildFields(fields)} }
+    }
+  }`;
+
+  return { query, variables: finalVariables };
+}
+
+/** 生成根据主键更新的 GraphQL mutation */
+export function buildGraphQLMutationUpdateByPk(input: UpdateByPkInput) {
+  const { operationName, fields, _set, pk_columns, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // 构建参数
+  const args: string[] = [];
+
+  // _set 参数
+  let setArg: string;
+  if (variables && variables._set) {
+    setArg = '$_set';
+  } else {
+    setArg = `{ ${buildDataValue(_set)} }`;
+  }
+  args.push(`_set: ${setArg}`);
+
+  // pk_columns 参数（固定使用 Long! 类型）
+  args.push(`pk_columns: ${formatGraphQLValue(pk_columns)}`);
+
+  // 更新 variables
+  const finalVariables: Record<string, any> = variables || {};
+  if (!variables || !variables._set) {
+    finalVariables._set = _set;
+  }
+
+  const mutationName = `update_${entityName}_by_pk`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${args.join(', ')}) {
+      ${buildMutationFields(fields)}
+    }
+  }`;
+
+  return { query, variables: finalVariables };
+}
+
+
+
+// =================== 删除操作 ===================
+
+/** 生成根据主键删除的 GraphQL mutation */
+export function buildGraphQLMutationDeleteById(input: DeleteByIdInput) {
+  const { operationName, fields, pk_columns, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // pk_columns 参数（固定使用 Long! 类型）
+  const args = `pk_columns: ${formatGraphQLValue(pk_columns)}`;
+
+  const mutationName = `delete_${entityName}_by_pk`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${args}) {
+      ${buildMutationFields(fields)}
+    }
+  }`;
+
+  return { query, variables: variables || {} };
+}
+
+/** 生成根据条件删除的 GraphQL mutation */
+export function buildGraphQLMutationDelete(input: DeleteInput) {
+  const { operationName, fields, where, variables } = input;
+  const entityName = operationName.toLowerCase();
+
+  // 生成变量定义
+  const varDefs = variables
+    ? Object.keys(variables)
+      .map(k => `$${k}: String!`)
+      .join(', ')
+    : '';
+
+  // where 参数
+  const args = `where: { ${buildWhere(where)} }`;
+
+  const mutationName = `delete_${entityName}`;
+  const query = `mutation ${mutationName}${varDefs ? `(${varDefs})` : ''} {
+    ${mutationName}(${args}) {
+      affected_rows
+      returning { ${buildFields(fields)} }
+    }
+  }`;
+
+  return { query, variables: variables || {} };
+}
+
+
+
+