metal-orm 1.0.79 → 1.0.81

package/dist/index.cjs

@@ -59,6 +59,7 @@ __export(index_exports, {
   HasMany: () => HasMany,
   HasOne: () => HasOne,
   InsertQueryBuilder: () => InsertQueryBuilder,
+  InterceptorPipeline: () => InterceptorPipeline,
   MySqlDialect: () => MySqlDialect,
   Orm: () => Orm,
   OrmSession: () => OrmSession,
@@ -95,6 +96,7 @@ __export(index_exports, {
   bitOr: () => bitOr,
   bitXor: () => bitXor,
   bootstrapEntities: () => bootstrapEntities,
+  buildFilterParameters: () => buildFilterParameters,
   caseWhen: () => caseWhen,
   cast: () => cast,
   cbrt: () => cbrt,
@@ -156,6 +158,7 @@ __export(index_exports, {
   exists: () => exists,
   exp: () => exp,
   extract: () => extract,
+  extractSchema: () => extractSchema,
   firstValue: () => firstValue,
   floor: () => floor,
   fromUnixTime: () => fromUnixTime,
@@ -166,6 +169,7 @@ __export(index_exports, {
   getDecoratorMetadata: () => getDecoratorMetadata,
   getSchemaIntrospector: () => getSchemaIntrospector,
   getTableDefFromEntity: () => getTableDefFromEntity,
+  getTemporalFormat: () => getTemporalFormat,
   greatest: () => greatest,
   groupConcat: () => groupConcat,
   gt: () => gt,
@@ -221,6 +225,8 @@ __export(index_exports, {
   lt: () => lt,
   lte: () => lte,
   ltrim: () => ltrim,
+  mapColumnType: () => mapColumnType,
+  mapRelationType: () => mapRelationType,
   materializeAs: () => materializeAs,
   max: () => max,
   md5: () => md5,
@@ -266,6 +272,7 @@ __export(index_exports, {
   rowsToQueryResult: () => rowsToQueryResult,
   rpad: () => rpad,
   rtrim: () => rtrim,
+  schemaToJson: () => schemaToJson,
   second: () => second,
   sel: () => sel,
   selectFrom: () => selectFrom,
@@ -2545,6 +2552,9 @@ var PostgresDialect = class extends SqlDialectBase {
   quoteIdentifier(id) {
     return `"${id}"`;
   }
+  formatPlaceholder(index) {
+    return `$${index}`;
+  }
   /**
    * Compiles JSON path expression using PostgreSQL syntax
    * @param node - JSON path node
@@ -6940,6 +6950,744 @@ var SelectRelationFacet = class {
   }
 };
 
+// src/openapi/type-mappers.ts
+var mapColumnType = (column, options = {}) => {
+  const resolved = resolveColumnOptions(options);
+  const sqlType = normalizeType(column.type);
+  const baseSchema = mapSqlTypeToBaseSchema(sqlType, column);
+  const schema = {
+    ...baseSchema
+  };
+  if (resolved.includeDescriptions && column.comment) {
+    schema.description = column.comment;
+  }
+  if (resolved.includeNullable) {
+    schema.nullable = !column.notNull && !column.primary;
+  }
+  if ((sqlType === "varchar" || sqlType === "char") && column.args) {
+    schema.maxLength = column.args[0];
+  }
+  if ((sqlType === "decimal" || sqlType === "float") && column.args) {
+    if (column.args.length >= 1) {
+      schema.minimum = -(10 ** column.args[0]);
+    }
+  }
+  if (!resolved.includeEnums) {
+    delete schema.enum;
+  } else if (sqlType === "enum" && column.args && column.args.length > 0) {
+    schema.enum = column.args;
+  }
+  if (resolved.includeDefaults && column.default !== void 0) {
+    schema.default = column.default;
+  }
+  return schema;
+};
+var normalizeType = (type) => {
+  return type.toLowerCase();
+};
+var mapSqlTypeToBaseSchema = (sqlType, column) => {
+  const type = normalizeType(sqlType);
+  const hasCustomTsType = column.tsType !== void 0;
+  switch (type) {
+    case "int":
+    case "integer":
+    case "bigint":
+      return {
+        type: hasCustomTsType ? inferTypeFromTsType(column.tsType) : "integer",
+        format: type === "bigint" ? "int64" : "int32",
+        minimum: column.autoIncrement ? 1 : void 0
+      };
+    case "decimal":
+    case "float":
+    case "double":
+      return {
+        type: hasCustomTsType ? inferTypeFromTsType(column.tsType) : "number"
+      };
+    case "varchar":
+      return {
+        type: "string",
+        minLength: column.notNull ? 1 : void 0,
+        maxLength: column.args?.[0]
+      };
+    case "text":
+      return {
+        type: "string",
+        minLength: column.notNull ? 1 : void 0
+      };
+    case "char":
+      return {
+        type: "string",
+        minLength: column.notNull ? column.args?.[0] || 1 : void 0,
+        maxLength: column.args?.[0]
+      };
+    case "boolean":
+      return {
+        type: "boolean"
+      };
+    case "json":
+      return {
+        anyOf: [
+          { type: "object" },
+          { type: "array" }
+        ]
+      };
+    case "blob":
+    case "binary":
+    case "varbinary":
+      return {
+        type: "string",
+        format: "base64"
+      };
+    case "date":
+      return {
+        type: "string",
+        format: "date"
+      };
+    case "datetime":
+    case "timestamp":
+      return {
+        type: "string",
+        format: "date-time"
+      };
+    case "timestamptz":
+      return {
+        type: "string",
+        format: "date-time"
+      };
+    case "uuid":
+      return {
+        type: "string",
+        format: "uuid",
+        pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+      };
+    case "enum":
+      return {
+        type: "string",
+        enum: column.args || []
+      };
+    default:
+      if (column.dialectTypes?.postgres && column.dialectTypes.postgres === "bytea") {
+        return {
+          type: "string",
+          format: "base64"
+        };
+      }
+      return {
+        type: "string"
+      };
+  }
+};
+var inferTypeFromTsType = (tsType) => {
+  if (typeof tsType === "string") {
+    if (tsType === "number") return "number";
+    if (tsType === "string") return "string";
+    if (tsType === "boolean") return "boolean";
+  }
+  if (typeof tsType === "function") {
+    const typeStr = tsType.name?.toLowerCase();
+    if (typeStr === "number") return "number";
+    if (typeStr === "string") return "string";
+    if (typeStr === "boolean") return "boolean";
+    if (typeStr === "array") return "array";
+    if (typeStr === "object") return "object";
+  }
+  return "string";
+};
+var resolveColumnOptions = (options) => ({
+  includeDescriptions: options.includeDescriptions ?? false,
+  includeEnums: options.includeEnums ?? true,
+  includeExamples: options.includeExamples ?? false,
+  includeDefaults: options.includeDefaults ?? true,
+  includeNullable: options.includeNullable ?? true
+});
+var mapRelationType = (relationType) => {
+  switch (relationType) {
+    case "HAS_MANY":
+    case "BELONGS_TO_MANY":
+      return { type: "array", isNullable: false };
+    case "HAS_ONE":
+    case "BELONGS_TO":
+      return { type: "object", isNullable: true };
+    default:
+      return { type: "object", isNullable: true };
+  }
+};
+var getTemporalFormat = (sqlType) => {
+  const type = normalizeType(sqlType);
+  switch (type) {
+    case "date":
+      return "date";
+    case "datetime":
+    case "timestamp":
+    case "timestamptz":
+      return "date-time";
+    default:
+      return void 0;
+  }
+};
+
+// src/openapi/schema-extractor.ts
+var DEFAULT_MAX_DEPTH = 5;
+var extractSchema = (table, plan, projectionNodes, options = {}) => {
+  const outputOptions = resolveOutputOptions(options);
+  const outputContext = createContext(outputOptions.maxDepth ?? DEFAULT_MAX_DEPTH);
+  const output = extractOutputSchema(table, plan, projectionNodes, outputContext, outputOptions);
+  const inputOptions = resolveInputOptions(options);
+  if (!inputOptions) {
+    return { output };
+  }
+  const inputContext = createContext(inputOptions.maxDepth ?? DEFAULT_MAX_DEPTH);
+  const input = extractInputSchema(table, inputContext, inputOptions);
+  return { output, input };
+};
+var resolveOutputOptions = (options) => ({
+  mode: options.mode ?? "full",
+  includeDescriptions: options.includeDescriptions,
+  includeEnums: options.includeEnums,
+  includeExamples: options.includeExamples,
+  includeDefaults: options.includeDefaults,
+  includeNullable: options.includeNullable,
+  maxDepth: options.maxDepth ?? DEFAULT_MAX_DEPTH
+});
+var resolveInputOptions = (options) => {
+  if (options.input === false) return void 0;
+  const input = options.input ?? {};
+  const mode = input.mode ?? "create";
+  return {
+    mode,
+    includeRelations: input.includeRelations ?? true,
+    relationMode: input.relationMode ?? "mixed",
+    includeDescriptions: input.includeDescriptions ?? options.includeDescriptions,
+    includeEnums: input.includeEnums ?? options.includeEnums,
+    includeExamples: input.includeExamples ?? options.includeExamples,
+    includeDefaults: input.includeDefaults ?? options.includeDefaults,
+    includeNullable: input.includeNullable ?? options.includeNullable,
+    maxDepth: input.maxDepth ?? options.maxDepth ?? DEFAULT_MAX_DEPTH,
+    omitReadOnly: input.omitReadOnly ?? true,
+    excludePrimaryKey: input.excludePrimaryKey ?? false,
+    requirePrimaryKey: input.requirePrimaryKey ?? mode === "update"
+  };
+};
+var createContext = (maxDepth) => ({
+  visitedTables: /* @__PURE__ */ new Set(),
+  schemaCache: /* @__PURE__ */ new Map(),
+  depth: 0,
+  maxDepth
+});
+var extractOutputSchema = (table, plan, projectionNodes, context, options) => {
+  const mode = options.mode ?? "full";
+  const hasComputedFields = projectionNodes && projectionNodes.some(
+    (node) => node.type !== "Column"
+  );
+  if (hasComputedFields) {
+    return extractFromProjectionNodes(table, projectionNodes, context, options);
+  }
+  if (mode === "selected" && plan) {
+    return extractSelectedSchema(table, plan, context, options);
+  }
+  return extractFullTableSchema(table, context, options);
+};
+var extractInputSchema = (table, context, options) => {
+  const cacheKey = `${table.name}:${options.mode ?? "create"}`;
+  if (context.schemaCache.has(cacheKey)) {
+    return context.schemaCache.get(cacheKey);
+  }
+  if (context.visitedTables.has(cacheKey) && context.depth > 0) {
+    return buildCircularReferenceSchema(table.name, "input");
+  }
+  context.visitedTables.add(cacheKey);
+  const properties = {};
+  const required = [];
+  const primaryKey = findPrimaryKey(table);
+  for (const [columnName, column] of Object.entries(table.columns)) {
+    const isPrimary = columnName === primaryKey || column.primary;
+    if (options.excludePrimaryKey && isPrimary) continue;
+    if (options.omitReadOnly && isReadOnlyColumn(column)) continue;
+    properties[columnName] = mapColumnType(column, options);
+    if (options.mode === "create" && isRequiredForCreate(column)) {
+      required.push(columnName);
+    }
+    if (options.mode === "update" && options.requirePrimaryKey && isPrimary) {
+      required.push(columnName);
+    }
+  }
+  if (options.includeRelations && context.depth < context.maxDepth) {
+    for (const [relationName, relation] of Object.entries(table.relations)) {
+      properties[relationName] = extractInputRelationSchema(
+        relation,
+        { ...context, depth: context.depth + 1 },
+        options
+      );
+    }
+  }
+  const schema = {
+    type: "object",
+    properties,
+    required
+  };
+  context.schemaCache.set(cacheKey, schema);
+  return schema;
+};
+var isReadOnlyColumn = (column) => Boolean(column.autoIncrement || column.generated === "always");
+var isRequiredForCreate = (column) => {
+  if (isReadOnlyColumn(column)) return false;
+  if (column.default !== void 0) return false;
+  return Boolean(column.notNull || column.primary);
+};
+var buildPrimaryKeySchema = (table, options) => {
+  const primaryKey = findPrimaryKey(table);
+  const column = table.columns[primaryKey];
+  if (!column) {
+    return {
+      anyOf: [
+        { type: "string" },
+        { type: "number" },
+        { type: "integer" }
+      ]
+    };
+  }
+  return mapColumnType(column, options);
+};
+var extractInputRelationSchema = (relation, context, options) => {
+  const { type: relationType, isNullable } = mapRelationType(relation.type);
+  const relationMode = options.relationMode ?? "mixed";
+  const allowIds = relationMode !== "objects";
+  const allowObjects = relationMode !== "ids";
+  const variants = [];
+  if (allowIds) {
+    variants.push(buildPrimaryKeySchema(relation.target, options));
+  }
+  if (allowObjects) {
+    const targetSchema = extractInputSchema(relation.target, context, options);
+    variants.push(targetSchema);
+  }
+  const itemSchema = variants.length === 1 ? variants[0] : { anyOf: variants };
+  if (relationType === "array") {
+    return {
+      type: "array",
+      items: itemSchema,
+      nullable: isNullable
+    };
+  }
+  return {
+    ...itemSchema,
+    nullable: isNullable
+  };
+};
+var extractFromProjectionNodes = (table, projectionNodes, context, options) => {
+  const properties = {};
+  const required = [];
+  const includeDescriptions = Boolean(options.includeDescriptions);
+  for (const node of projectionNodes) {
+    if (!node || typeof node !== "object") continue;
+    const projection = node;
+    const propertyName = projection.alias ?? "";
+    if (!propertyName) continue;
+    if (projection.type === "Column") {
+      const columnNode4 = node;
+      const column = table.columns[columnNode4.name];
+      if (!column) continue;
+      const property = mapColumnType(column, options);
+      properties[propertyName] = property;
+      if (column.notNull || column.primary) {
+        required.push(propertyName);
+      }
+    } else if (projection.type === "Function" || projection.type === "WindowFunction") {
+      const fnNode = node;
+      const functionName = fnNode.fn?.toUpperCase() ?? fnNode.name?.toUpperCase() ?? "";
+      const propertySchema = projection.type === "Function" ? mapFunctionNodeToSchema(functionName, includeDescriptions) : mapWindowFunctionToSchema(functionName, includeDescriptions);
+      properties[propertyName] = propertySchema;
+      const isCountFunction = functionName === "COUNT";
+      const isWindowRankFunction = functionName === "ROW_NUMBER" || functionName === "RANK";
+      if (isCountFunction || isWindowRankFunction) {
+        required.push(propertyName);
+      }
+    } else if (projection.type === "CaseExpression") {
+      const propertySchema = {
+        type: "string",
+        nullable: true
+      };
+      if (includeDescriptions) {
+        propertySchema.description = "Computed CASE expression";
+      }
+      properties[propertyName] = propertySchema;
+    } else if (projection.type === "ScalarSubquery") {
+      const propertySchema = {
+        type: "object",
+        nullable: true
+      };
+      if (includeDescriptions) {
+        propertySchema.description = "Subquery result";
+      }
+      properties[propertyName] = propertySchema;
+    } else if (projection.type === "CastExpression") {
+      const propertySchema = {
+        type: "string",
+        nullable: true
+      };
+      if (includeDescriptions) {
+        propertySchema.description = "CAST expression result";
+      }
+      properties[propertyName] = propertySchema;
+    }
+  }
+  return {
+    type: "object",
+    properties,
+    required
+  };
+};
+var mapFunctionNodeToSchema = (functionName, includeDescriptions) => {
+  const upperName = functionName.toUpperCase();
+  switch (upperName) {
+    case "COUNT":
+    case "SUM":
+    case "AVG":
+    case "MIN":
+    case "MAX":
+      return withOptionalDescription({
+        type: "number",
+        nullable: false
+      }, includeDescriptions, `${upperName} aggregate function result`);
+    case "GROUP_CONCAT":
+    case "STRING_AGG":
+    case "ARRAY_AGG":
+      return withOptionalDescription({
+        type: "string",
+        nullable: true
+      }, includeDescriptions, `${upperName} aggregate function result`);
+    case "JSON_ARRAYAGG":
+    case "JSON_OBJECTAGG":
+      return withOptionalDescription({
+        type: "object",
+        nullable: true
+      }, includeDescriptions, `${upperName} aggregate function result`);
+    default:
+      return withOptionalDescription({
+        type: "string",
+        nullable: true
+      }, includeDescriptions, `Unknown function: ${functionName}`);
+  }
+};
+var mapWindowFunctionToSchema = (functionName, includeDescriptions) => {
+  const upperName = functionName.toUpperCase();
+  switch (upperName) {
+    case "ROW_NUMBER":
+    case "RANK":
+    case "DENSE_RANK":
+    case "NTILE":
+      return withOptionalDescription({
+        type: "integer",
+        nullable: false
+      }, includeDescriptions, `${upperName} window function result`);
+    case "LAG":
+    case "LEAD":
+    case "FIRST_VALUE":
+    case "LAST_VALUE":
+      return withOptionalDescription({
+        type: "string",
+        nullable: true
+      }, includeDescriptions, `${upperName} window function result`);
+    default:
+      return withOptionalDescription({
+        type: "string",
+        nullable: true
+      }, includeDescriptions, `Unknown window function: ${functionName}`);
+  }
+};
+var withOptionalDescription = (schema, includeDescriptions, description) => {
+  if (includeDescriptions) {
+    return { ...schema, description };
+  }
+  return schema;
+};
+var extractSelectedSchema = (table, plan, context, options) => {
+  const properties = {};
+  const required = [];
+  plan.rootColumns.forEach((columnName) => {
+    const column = table.columns[columnName];
+    if (!column) return;
+    properties[columnName] = mapColumnType(column, options);
+    if (column.notNull || column.primary) {
+      required.push(columnName);
+    }
+  });
+  plan.relations.forEach((relationPlan) => {
+    const relation = table.relations[relationPlan.name];
+    if (!relation) return;
+    const relationSchema = extractRelationSchema(
+      relation,
+      relationPlan,
+      relationPlan.columns,
+      context,
+      options
+    );
+    properties[relationPlan.name] = relationSchema;
+    const { isNullable } = mapRelationType(relation.type);
+    if (!isNullable && relationPlan.name) {
+      required.push(relationPlan.name);
+    }
+  });
+  return {
+    type: "object",
+    properties,
+    required
+  };
+};
+var extractFullTableSchema = (table, context, options) => {
+  const cacheKey = table.name;
+  if (context.schemaCache.has(cacheKey)) {
+    return context.schemaCache.get(cacheKey);
+  }
+  if (context.visitedTables.has(cacheKey) && context.depth > 0) {
+    return buildCircularReferenceSchema(table.name, "output");
+  }
+  context.visitedTables.add(cacheKey);
+  const properties = {};
+  const required = [];
+  Object.entries(table.columns).forEach(([columnName, column]) => {
+    properties[columnName] = mapColumnType(column, options);
+    if (column.notNull || column.primary) {
+      required.push(columnName);
+    }
+  });
+  Object.entries(table.relations).forEach(([relationName, relation]) => {
+    if (context.depth >= context.maxDepth) {
+      return;
+    }
+    const relationSchema = extractRelationSchema(
+      relation,
+      void 0,
+      [],
+      { ...context, depth: context.depth + 1 },
+      options
+    );
+    properties[relationName] = relationSchema;
+    const { isNullable } = mapRelationType(relation.type);
+    if (!isNullable) {
+      required.push(relationName);
+    }
+  });
+  const schema = {
+    type: "object",
+    properties,
+    required
+  };
+  context.schemaCache.set(cacheKey, schema);
+  return schema;
+};
+var extractRelationSchema = (relation, relationPlan, selectedColumns, context, options) => {
+  const targetTable = relation.target;
+  const { type: relationType, isNullable } = mapRelationType(relation.type);
+  let targetSchema;
+  if (relationPlan && selectedColumns.length > 0) {
+    const plan = {
+      rootTable: targetTable.name,
+      rootPrimaryKey: relationPlan.targetPrimaryKey,
+      rootColumns: selectedColumns,
+      relations: []
+    };
+    targetSchema = extractSelectedSchema(targetTable, plan, context, options);
+  } else {
+    targetSchema = extractFullTableSchema(targetTable, context, options);
+  }
+  if (relationType === "array") {
+    return {
+      type: "array",
+      items: targetSchema,
+      nullable: isNullable
+    };
+  }
+  return {
+    type: "object",
+    properties: targetSchema.properties,
+    required: targetSchema.required,
+    nullable: isNullable,
+    description: targetSchema.description
+  };
+};
+var buildCircularReferenceSchema = (tableName, kind) => ({
+  type: "object",
+  properties: {
+    _ref: {
+      type: "string",
+      description: `Circular ${kind} reference to ${tableName}`
+    }
+  },
+  required: []
+});
+var schemaToJson = (schema, pretty = false) => {
+  return JSON.stringify(schema, null, pretty ? 2 : 0);
+};
+
+// src/openapi/query-parameters.ts
+var FILTER_PARAM_NAME = "filter";
+var buildRootTableNames = (table, from) => {
+  const names = /* @__PURE__ */ new Set([table.name]);
+  if (from?.type === "Table") {
+    names.add(from.name);
+    if (from.alias) names.add(from.alias);
+  }
+  return names;
+};
+var collectFilterColumns = (expr, table, rootTables) => {
+  const columns = /* @__PURE__ */ new Set();
+  const recordColumn = (node) => {
+    if (!rootTables.has(node.table)) return;
+    if (node.name in table.columns) {
+      columns.add(node.name);
+    }
+  };
+  const visitOrderingTerm = (term) => {
+    if (!term || typeof term !== "object") return;
+    if (isOperandNode(term)) {
+      visitOperand2(term);
+      return;
+    }
+    if ("type" in term) {
+      visitExpression2(term);
+    }
+  };
+  const visitOrderBy = (orderBy) => {
+    if (!orderBy) return;
+    orderBy.forEach((node) => visitOrderingTerm(node.term));
+  };
+  const visitOperand2 = (node) => {
+    switch (node.type) {
+      case "Column":
+        recordColumn(node);
+        return;
+      case "Function": {
+        const fn8 = node;
+        fn8.args?.forEach(visitOperand2);
+        visitOrderBy(fn8.orderBy);
+        if (fn8.separator) visitOperand2(fn8.separator);
+        return;
+      }
+      case "JsonPath": {
+        const jp = node;
+        recordColumn(jp.column);
+        return;
+      }
+      case "ScalarSubquery":
+        return;
+      case "CaseExpression": {
+        const cs = node;
+        cs.conditions.forEach((condition) => {
+          visitExpression2(condition.when);
+          visitOperand2(condition.then);
+        });
+        if (cs.else) visitOperand2(cs.else);
+        return;
+      }
+      case "Cast": {
+        const cast2 = node;
+        visitOperand2(cast2.expression);
+        return;
+      }
+      case "WindowFunction": {
+        const windowFn = node;
+        windowFn.args?.forEach(visitOperand2);
+        windowFn.partitionBy?.forEach(recordColumn);
+        visitOrderBy(windowFn.orderBy);
+        return;
+      }
+      case "ArithmeticExpression": {
+        const arith = node;
+        visitOperand2(arith.left);
+        visitOperand2(arith.right);
+        return;
+      }
+      case "BitwiseExpression": {
+        const bitwise = node;
+        visitOperand2(bitwise.left);
+        visitOperand2(bitwise.right);
+        return;
+      }
+      case "Collate": {
+        const collate2 = node;
+        visitOperand2(collate2.expression);
+        return;
+      }
+      case "AliasRef":
+      case "Literal":
+        return;
+      default:
+        return;
+    }
+  };
+  const visitExpression2 = (node) => {
+    switch (node.type) {
+      case "BinaryExpression":
+        visitOperand2(node.left);
+        visitOperand2(node.right);
+        if (node.escape) visitOperand2(node.escape);
+        return;
+      case "LogicalExpression":
+        node.operands.forEach(visitExpression2);
+        return;
+      case "NullExpression":
+        visitOperand2(node.left);
+        return;
+      case "InExpression":
+        visitOperand2(node.left);
+        if (Array.isArray(node.right)) {
+          node.right.forEach(visitOperand2);
+        }
+        return;
+      case "ExistsExpression":
+        return;
+      case "BetweenExpression":
+        visitOperand2(node.left);
+        visitOperand2(node.lower);
+        visitOperand2(node.upper);
+        return;
+      case "ArithmeticExpression":
+        visitOperand2(node.left);
+        visitOperand2(node.right);
+        return;
+      case "BitwiseExpression":
+        visitOperand2(node.left);
+        visitOperand2(node.right);
+        return;
+      default:
+        return;
+    }
+  };
+  visitExpression2(expr);
+  return columns;
+};
+var buildFilterParameters = (table, where, from, options = {}) => {
+  if (!where) return [];
+  const rootTables = buildRootTableNames(table, from);
+  const columnNames = collectFilterColumns(where, table, rootTables);
+  let schema;
+  if (columnNames.size) {
+    const properties = {};
+    for (const name of columnNames) {
+      const column = table.columns[name];
+      if (!column) continue;
+      properties[name] = mapColumnType(column, options);
+    }
+    schema = {
+      type: "object",
+      properties
+    };
+  } else {
+    schema = {
+      type: "object",
+      additionalProperties: true
+    };
+  }
+  return [{
+    name: FILTER_PARAM_NAME,
+    in: "query",
+    style: "deepObject",
+    explode: true,
+    schema
+  }];
+};
+
 // src/query-builder/select.ts
 var SelectQueryBuilder = class _SelectQueryBuilder {
   env;
@@ -7749,7 +8497,7 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
     return this.compile(dialect).sql;
   }
   /**
-   * Gets the hydration plan for the query
+   * Gets hydration plan for query
    * @returns Hydration plan or undefined if none exists
    * @example
    * const plan = qb.include('posts').getHydrationPlan();
@@ -7758,6 +8506,28 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
   getHydrationPlan() {
     return this.context.hydration.getPlan();
   }
+  /**
+   * Gets OpenAPI 3.1 JSON Schemas for query output and optional input payloads
+   * @param options - Schema generation options
+   * @returns OpenAPI 3.1 JSON Schemas for query output and input payloads
+   * @example
+   * const { output } = qb.select('id', 'title', 'author').getSchema();
+   * console.log(JSON.stringify(output, null, 2));
+   */
+  getSchema(options) {
+    const plan = this.context.hydration.getPlan();
+    const bundle = extractSchema(this.env.table, plan, this.context.state.ast.columns, options);
+    const parameters = buildFilterParameters(
+      this.env.table,
+      this.context.state.ast.where,
+      this.context.state.ast.from,
+      options ?? {}
+    );
+    if (parameters.length) {
+      return { ...bundle, parameters };
+    }
+    return bundle;
+  }
   /**
    * Gets the Abstract Syntax Tree (AST) representation of the query
    * @returns Query AST with hydration applied
@@ -8787,14 +9557,14 @@ var buildAddColumnSql = (table, colName, dialect) => {
   const rendered = renderColumnDefinition(table, column, dialect);
   return `ALTER TABLE ${dialect.formatTableName(table)} ADD ${rendered.sql};`;
 };
-var normalizeType = (value) => (value || "").toLowerCase().replace(/\s+/g, " ").trim();
+var normalizeType2 = (value) => (value || "").toLowerCase().replace(/\s+/g, " ").trim();
 var normalizeDefault = (value) => {
   if (value === void 0 || value === null) return void 0;
   return String(value).trim();
 };
 var diffColumn = (expected, actual, dialect) => {
-  const expectedType = normalizeType(dialect.renderColumnType(expected));
-  const actualType = normalizeType(actual.type);
+  const expectedType = normalizeType2(dialect.renderColumnType(expected));
+  const actualType = normalizeType2(actual.type);
   const expectedDefault = expected.default !== void 0 ? normalizeDefault(dialect.renderDefault(expected.default, expected)) : void 0;
   const actualDefault = normalizeDefault(actual.default);
   return {
@@ -11373,6 +12143,7 @@ var UnitOfWork = class {
     const compiled = builder.compile(this.dialect);
     const results = await this.executeCompiled(compiled);
     this.applyReturningResults(tracked, results);
+    this.applyInsertId(tracked, results);
     tracked.status = "managed" /* Managed */;
     tracked.original = this.createSnapshot(tracked.table, tracked.entity);
     tracked.pk = this.getPrimaryKeyValue(tracked);
@@ -11498,6 +12269,16 @@ var UnitOfWork = class {
       tracked.entity[columnName] = row[i];
     }
   }
+  applyInsertId(tracked, results) {
+    if (this.dialect.supportsReturning()) return;
+    if (tracked.pk != null) return;
+    const pkName = findPrimaryKey(tracked.table);
+    const pkColumn = tracked.table.columns[pkName];
+    if (!pkColumn?.autoIncrement) return;
+    const insertId = results.find((result) => typeof result.insertId === "number")?.insertId;
+    if (insertId == null) return;
+    tracked.entity[pkName] = insertId;
+  }
   /**
    * Normalizes a column name by removing quotes and table prefixes.
    * @param column - The column name to normalize
@@ -13014,7 +13795,9 @@ function createMysqlExecutor(client) {
     async executeSql(sql, params) {
       const [rows] = await client.query(sql, params);
       if (!Array.isArray(rows)) {
-        return [{ columns: [], values: [] }];
+        const insertId = rows?.insertId;
+        const normalized = typeof insertId === "number" && insertId > 0 ? insertId : void 0;
+        return [{ columns: [], values: [], insertId: normalized }];
       }
       const result = rowsToQueryResult(
         rows
@@ -13276,6 +14059,7 @@ function createPooledExecutorFactory(opts) {
   HasMany,
   HasOne,
   InsertQueryBuilder,
+  InterceptorPipeline,
   MySqlDialect,
   Orm,
   OrmSession,
@@ -13312,6 +14096,7 @@ function createPooledExecutorFactory(opts) {
   bitOr,
   bitXor,
   bootstrapEntities,
+  buildFilterParameters,
   caseWhen,
   cast,
   cbrt,
@@ -13373,6 +14158,7 @@ function createPooledExecutorFactory(opts) {
   exists,
   exp,
   extract,
+  extractSchema,
   firstValue,
   floor,
   fromUnixTime,
@@ -13383,6 +14169,7 @@ function createPooledExecutorFactory(opts) {
   getDecoratorMetadata,
   getSchemaIntrospector,
   getTableDefFromEntity,
+  getTemporalFormat,
   greatest,
   groupConcat,
   gt,
@@ -13438,6 +14225,8 @@ function createPooledExecutorFactory(opts) {
   lt,
   lte,
   ltrim,
+  mapColumnType,
+  mapRelationType,
   materializeAs,
   max,
   md5,
@@ -13483,6 +14272,7 @@ function createPooledExecutorFactory(opts) {
   rowsToQueryResult,
   rpad,
   rtrim,
+  schemaToJson,
   second,
   sel,
   selectFrom,