feat(drizzle-zod): add a zod .meta to pgTable fields to add OpenAPI descriptions

drizzle-orm/src/column-builder.ts

@@ -115,6 +115,7 @@ export type ColumnBuilderRuntimeConfig<TData, TRuntimeConfig extends object = ob
 	columnType: string;
 	generated: GeneratedColumnConfig<TData> | undefined;
 	generatedIdentity: GeneratedIdentityConfig | undefined;
+	meta: Record<string, unknown> | undefined;
 } & TRuntimeConfig;
 
 export interface ColumnBuilderExtraConfig {
@@ -208,6 +209,7 @@ export abstract class ColumnBuilder<
 			dataType,
 			columnType,
 			generated: undefined,
+			meta: undefined,
 		} as ColumnBuilderRuntimeConfig<T['data'], TRuntimeConfig>;
 	}
 
@@ -288,6 +290,22 @@ export abstract class ColumnBuilder<
 	 */
 	$onUpdate = this.$onUpdateFn;
 
+	/**
+	 * Adds metadata to the column definition. This can be used by external tools like drizzle-zod
+	 * to add additional information to generated schemas.
+	 *
+	 * @example
+	 * ```ts
+	 * const users = pgTable('users', {
+	 *   age: integer('age').meta({ description: 'User age in years' }),
+	 * });
+	 * ```
+	 */
+	meta(meta: Record<string, unknown>): this {
+		this.config.meta = { ...this.config.meta, ...meta };
+		return this;
+	}
+
 	/**
 	 * Adds a `primary key` clause to the column definition. This implicitly makes the column `not null`.
 	 *

drizzle-orm/src/column.ts

@@ -85,6 +85,7 @@ export abstract class Column<
 	readonly enumValues: T['enumValues'] = undefined;
 	readonly generated: GeneratedColumnConfig<T['data']> | undefined = undefined;
 	readonly generatedIdentity: GeneratedIdentityConfig | undefined = undefined;
+	readonly meta: Record<string, unknown> | undefined;
 
 	protected config: ColumnRuntimeConfig<T['data'], TRuntimeConfig>;
 
@@ -108,6 +109,7 @@ export abstract class Column<
 		this.columnType = config.columnType;
 		this.generated = config.generated;
 		this.generatedIdentity = config.generatedIdentity;
+		this.meta = config.meta;
 	}
 
 	abstract getSQLType(): string;

drizzle-zod/src/column.ts

@@ -131,6 +131,11 @@ export function columnToSchema(
 		schema = z.any();
 	}
 
+	// Apply metadata if available
+	if (column.meta && typeof column.meta === 'object') {
+		schema = schema.meta(column.meta);
+	}
+
 	return schema;
 }