@wordrhyme/auto-crud-server 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -475,9 +475,10 @@ function validateColumn(columnId, allowedColumns) {
 	return allowedColumns.includes(columnId);
 }
 function createCrudRouter(config) {
-	const { table, insertSchema, updateSchema, idField = "id", filterableColumns, sortableColumns, maxBatchSize = 100, softDelete: softDeleteOption } = config;
+	const { table, insertSchema, updateSchema, idField = "id", filterableColumns, sortableColumns, maxBatchSize = 100, softDelete: softDeleteOption, hooks = {} } = config;
 	const resolved = resolveConfig(config);
 	const softDelete = resolveSoftDelete(softDeleteOption);
+	const h = hooks;
 	const getIdColumn = () => table[idField];
 	const getSoftDeleteColumn = () => softDelete ? table[softDelete.column] : null;
 	const buildWhere = (ctx, operation, additionalCondition) => {
@@ -505,49 +506,71 @@ function createCrudRouter(config) {
 	const procedures = {
 		list: resolved.procedureFactory("list").input(listInputSchema).query(async ({ ctx, input }) => {
 			await withGuard(ctx, "list");
-			const offset = (input.page - 1) * input.perPage;
-			const validatedFilters = input.filters?.filter((filter) => validateColumn(filter.id, filterableColumns));
+			let processedInput = input;
+			if (h.beforeList) {
+				const result = await h.beforeList(ctx, processedInput);
+				if (result) processedInput = result;
+			}
+			const offset = (processedInput.page - 1) * processedInput.perPage;
+			const validatedFilters = processedInput.filters?.filter((filter) => validateColumn(filter.id, filterableColumns));
 			const where = buildWhere(ctx, "list", validatedFilters?.length ? filterColumns({
 				table,
 				filters: validatedFilters,
-				joinOperator: input.joinOperator
+				joinOperator: processedInput.joinOperator
 			}) : void 0);
 			let query = ctx.db.select().from(table).$dynamic();
 			if (where) query = query.where(where);
-			if (input.sort?.length) {
-				const sortField = input.sort[0];
+			if (processedInput.sort?.length) {
+				const sortField = processedInput.sort[0];
 				if (sortField && validateColumn(sortField.id, sortableColumns)) {
 					const column = table[sortField.id];
 					if (column) query = query.orderBy(sortField.desc ? (0, drizzle_orm.desc)(column) : (0, drizzle_orm.asc)(column));
 				}
 			}
-			const data = await query.limit(input.perPage).offset(offset);
+			const data = await query.limit(processedInput.perPage).offset(offset);
 			let countQuery = ctx.db.select({ count: drizzle_orm.sql`count(*)::int` }).from(table).$dynamic();
 			if (where) countQuery = countQuery.where(where);
 			const count = (await countQuery)[0]?.count ?? 0;
-			return {
+			let listResult = {
 				data,
 				total: count,
-				page: input.page,
-				perPage: input.perPage,
-				pageCount: Math.ceil(count / input.perPage)
+				page: processedInput.page,
+				perPage: processedInput.perPage,
+				pageCount: Math.ceil(count / processedInput.perPage)
 			};
+			if (h.afterList) {
+				const result = await h.afterList(ctx, listResult);
+				if (result) listResult = result;
+			}
+			return listResult;
 		}),
 		getById: resolved.procedureFactory("get").input(zod.z.string()).query(async ({ ctx, input }) => {
 			await withGuard(ctx, "get");
+			if (h.beforeGet) await h.beforeGet(ctx, input);
 			const where = buildWhere(ctx, "get", (0, drizzle_orm.eq)(getIdColumn(), input));
 			const [item] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, item, "get");
-			return item ?? null;
+			let result = item ?? null;
+			if (h.afterGet) {
+				const hookResult = await h.afterGet(ctx, result);
+				if (hookResult !== void 0) result = hookResult;
+			}
+			return result;
 		}),
 		create: resolved.procedureFactory("create").input(insertSchema).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "create");
+			let processedData = input;
+			if (h.beforeCreate) {
+				const result = await h.beforeCreate(ctx, processedData);
+				if (result) processedData = result;
+			}
 			const injectData = resolved.getInject(ctx, "create");
 			const data = {
-				...input,
+				...processedData,
 				...injectData
 			};
 			const [created] = await ctx.db.insert(table).values(data).returning();
+			if (h.afterCreate) await h.afterCreate(ctx, created);
 			return created;
 		}),
 		update: resolved.procedureFactory("update").input(zod.z.object({
@@ -559,12 +582,18 @@ function createCrudRouter(config) {
 			const [existing] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, existing, "update");
 			if (!existing) throw new Error("Resource not found or access denied");
+			let processedData = input.data;
+			if (h.beforeUpdate) {
+				const result = await h.beforeUpdate(ctx, input.id, processedData, existing);
+				if (result) processedData = result;
+			}
 			const injectData = resolved.getInject(ctx, "update");
 			const data = {
-				...input.data,
+				...processedData,
 				...injectData
 			};
 			const [updated] = await ctx.db.update(table).set(data).where(where).returning();
+			if (h.afterUpdate) await h.afterUpdate(ctx, updated);
 			return updated;
 		}),
 		delete: resolved.procedureFactory("delete").input(zod.z.string()).mutation(async ({ ctx, input }) => {
@@ -573,31 +602,42 @@ function createCrudRouter(config) {
 			const [existing] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, existing, "delete");
 			if (!existing) throw new Error("Resource not found or access denied");
-			if (softDelete) {
-				const [deleted$1] = await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning();
-				return deleted$1;
-			}
-			const [deleted] = await ctx.db.delete(table).where(where).returning();
+			if (h.beforeDelete) await h.beforeDelete(ctx, input, existing);
+			let deleted;
+			if (softDelete) [deleted] = await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning();
+			else [deleted] = await ctx.db.delete(table).where(where).returning();
+			if (h.afterDelete) await h.afterDelete(ctx, deleted);
 			return deleted;
 		}),
 		deleteMany: resolved.procedureFactory("deleteMany").input(zod.z.array(zod.z.string()).max(maxBatchSize)).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "deleteMany");
+			if (h.beforeDeleteMany) await h.beforeDeleteMany(ctx, input);
 			const where = buildWhere(ctx, "deleteMany", (0, drizzle_orm.inArray)(getIdColumn(), input));
-			if (softDelete) return { deleted: (await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning()).length };
-			return { deleted: (await ctx.db.delete(table).where(where).returning()).length };
+			let result;
+			if (softDelete) result = { deleted: (await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning()).length };
+			else result = { deleted: (await ctx.db.delete(table).where(where).returning()).length };
+			if (h.afterDeleteMany) await h.afterDeleteMany(ctx, result);
+			return result;
 		}),
 		updateMany: resolved.procedureFactory("updateMany").input(zod.z.object({
 			ids: zod.z.array(zod.z.string()).max(maxBatchSize),
 			data: updateSchema
 		})).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "updateMany");
+			let processedData = input.data;
+			if (h.beforeUpdateMany) {
+				const result$1 = await h.beforeUpdateMany(ctx, input.ids, processedData);
+				if (result$1) processedData = result$1;
+			}
 			const where = buildWhere(ctx, "updateMany", (0, drizzle_orm.inArray)(getIdColumn(), input.ids));
 			const injectData = resolved.getInject(ctx, "update");
 			const data = {
-				...input.data,
+				...processedData,
 				...injectData
 			};
-			return { updated: (await ctx.db.update(table).set(data).where(where).returning()).length };
+			const result = { updated: (await ctx.db.update(table).set(data).where(where).returning()).length };
+			if (h.afterUpdateMany) await h.afterUpdateMany(ctx, result);
+			return result;
 		})
 	};
 	const crudRouter = router(procedures);

package/dist/index.d.cts

@@ -42,7 +42,121 @@ interface SoftDeleteConfig {
  * - SoftDeleteConfig: 完整配置
  */
 type SoftDeleteOption = string | boolean | SoftDeleteConfig;
-interface CrudRouterConfigBase {
+/**
+ * 列表查询输入类型
+ */
+interface ListInput {
+  page: number;
+  perPage: number;
+  sort?: Array<{
+    id: string;
+    desc: boolean;
+  }>;
+  filters?: Array<{
+    id: string;
+    value: string | string[];
+    variant: string;
+    operator: string;
+    filterId: string;
+  }>;
+  joinOperator: "and" | "or";
+}
+/**
+ * 列表查询结果类型
+ */
+interface ListResult<TSelect> {
+  data: TSelect[];
+  total: number;
+  page: number;
+  perPage: number;
+  pageCount: number;
+}
+/**
+ * CRUD 生命周期钩子
+ *
+ * @example
+ * hooks: {
+ *   beforeCreate: async (ctx, data) => {
+ *     // 修改数据
+ *     return { ...data, slug: slugify(data.title) };
+ *   },
+ *   afterCreate: async (ctx, created) => {
+ *     // 发送通知
+ *     await sendNotification(created);
+ *   },
+ * }
+ */
+interface CrudHooks<TContext = unknown> {
+  /**
+   * 列表查询前
+   * 可修改查询参数
+   */
+  beforeList?: (ctx: TContext, input: ListInput) => ListInput | void | Promise<ListInput | void>;
+  /**
+   * 列表查询后
+   * 可修改返回结果
+   */
+  afterList?: <TSelect>(ctx: TContext, result: ListResult<TSelect>) => ListResult<TSelect> | void | Promise<ListResult<TSelect> | void>;
+  /**
+   * 单条查询前
+   */
+  beforeGet?: (ctx: TContext, id: string) => void | Promise<void>;
+  /**
+   * 单条查询后
+   * 可修改返回结果
+   */
+  afterGet?: <TSelect>(ctx: TContext, result: TSelect | null) => TSelect | null | void | Promise<TSelect | null | void>;
+  /**
+   * 创建前
+   * 可修改输入数据，返回新数据或抛出错误阻止创建
+   */
+  beforeCreate?: <TInsert>(ctx: TContext, data: TInsert) => TInsert | void | Promise<TInsert | void>;
+  /**
+   * 创建后
+   * 用于副作用（日志、通知、同步等）
+   */
+  afterCreate?: <TSelect>(ctx: TContext, created: TSelect) => void | Promise<void>;
+  /**
+   * 更新前
+   * 可修改输入数据，existing 为更新前的记录
+   */
+  beforeUpdate?: <TUpdate, TSelect>(ctx: TContext, id: string, data: TUpdate, existing: TSelect) => TUpdate | void | Promise<TUpdate | void>;
+  /**
+   * 更新后
+   */
+  afterUpdate?: <TSelect>(ctx: TContext, updated: TSelect) => void | Promise<void>;
+  /**
+   * 删除前
+   * existing 为删除前的记录，可抛出错误阻止删除
+   */
+  beforeDelete?: <TSelect>(ctx: TContext, id: string, existing: TSelect) => void | Promise<void>;
+  /**
+   * 删除后
+   */
+  afterDelete?: <TSelect>(ctx: TContext, deleted: TSelect) => void | Promise<void>;
+  /**
+   * 批量删除前
+   */
+  beforeDeleteMany?: (ctx: TContext, ids: string[]) => void | Promise<void>;
+  /**
+   * 批量删除后
+   */
+  afterDeleteMany?: (ctx: TContext, result: {
+    deleted: number;
+  }) => void | Promise<void>;
+  /**
+   * 批量更新前
+   * 可修改输入数据
+   */
+  beforeUpdateMany?: <TUpdate>(ctx: TContext, ids: string[], data: TUpdate) => TUpdate | void | Promise<TUpdate | void>;
+  /**
+   * 批量更新后
+   */
+  afterUpdateMany?: (ctx: TContext, result: {
+    updated: number;
+  }) => void | Promise<void>;
+}
+interface CrudRouterConfigBase<TContext = unknown> {
   /** Drizzle 表定义 */
   table: PgTable;
   /** 查询返回 Schema */
@@ -77,8 +191,23 @@ interface CrudRouterConfigBase {
    * softDelete: { column: 'isDeleted', value: () => true }
    */
   softDelete?: SoftDeleteOption;
+  /**
+   * 生命周期钩子
+   * 在 CRUD 操作前后注入自定义逻辑
+   *
+   * @example
+   * hooks: {
+   *   beforeCreate: async (ctx, data) => {
+   *     return { ...data, slug: slugify(data.title) };
+   *   },
+   *   afterCreate: async (ctx, created) => {
+   *     await sendNotification(created);
+   *   },
+   * }
+   */
+  hooks?: CrudHooks<TContext>;
 }
-interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode?: "declarative";
   /**
    * 基础 procedure（认证）
@@ -118,7 +247,7 @@ interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase {
    */
   authorize?: (ctx: TContext, resource: Record<string, unknown>, operation: CrudOperation) => boolean | Promise<boolean>;
 }
-interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode: "factory";
   /**
    * Procedure 工厂函数
@@ -137,7 +266,7 @@ interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase {
    */
   inject?: (ctx: TContext, operation: WriteOperation) => Record<string, unknown>;
 }
-interface ProceduresConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface ProceduresConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode: "procedures";
   /**
    * 按操作指定不同的 procedure
@@ -206,4 +335,4 @@ declare const appRouter: _trpc_server5.TRPCBuiltRouter<{
 }, _trpc_server5.TRPCDecorateCreateRouterOptions<{}>>;
 type AppRouter = typeof appRouter;
 //#endregion
-export { type AnyProcedure, type AppRouter, type CrudOperation, type CrudRouterConfig, type DeclarativeConfig, type FactoryConfig, type ProceduresConfig, type SoftDeleteConfig, type SoftDeleteOption, type WriteOperation, appRouter, createCrudRouter, publicProcedure, router };
+export { type AnyProcedure, type AppRouter, type CrudHooks, type CrudOperation, type CrudRouterConfig, type DeclarativeConfig, type FactoryConfig, type ListInput, type ListResult, type ProceduresConfig, type SoftDeleteConfig, type SoftDeleteOption, type WriteOperation, appRouter, createCrudRouter, publicProcedure, router };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { SQL } from "drizzle-orm";
-import * as _trpc_server5 from "@trpc/server";
+import * as _trpc_server2 from "@trpc/server";
 import superjson from "superjson";
 import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import * as node_modules__trpc_server_dist_unstable_core_do_not_import_d_CjQPvBRI_mjs0 from "node_modules/@trpc/server/dist/unstable-core-do-not-import.d-CjQPvBRI.mjs";
@@ -14,13 +14,13 @@ import { PgTable } from "drizzle-orm/pg-core";
 interface Context {
   db: PostgresJsDatabase<Record<string, never>>;
 }
-declare const router: _trpc_server5.TRPCRouterBuilder<{
+declare const router: _trpc_server2.TRPCRouterBuilder<{
   ctx: Context;
   meta: object;
-  errorShape: _trpc_server5.TRPCDefaultErrorShape;
+  errorShape: _trpc_server2.TRPCDefaultErrorShape;
   transformer: true;
 }>;
-declare const publicProcedure: _trpc_server5.TRPCProcedureBuilder<Context, object, object, _trpc_server5.TRPCUnsetMarker, _trpc_server5.TRPCUnsetMarker, _trpc_server5.TRPCUnsetMarker, _trpc_server5.TRPCUnsetMarker, false>;
+declare const publicProcedure: _trpc_server2.TRPCProcedureBuilder<Context, object, object, _trpc_server2.TRPCUnsetMarker, _trpc_server2.TRPCUnsetMarker, _trpc_server2.TRPCUnsetMarker, _trpc_server2.TRPCUnsetMarker, false>;
 //#endregion
 //#region src/types/config.d.ts
 type CrudOperation = "list" | "get" | "create" | "update" | "delete" | "deleteMany" | "updateMany";
@@ -43,7 +43,121 @@ interface SoftDeleteConfig {
  * - SoftDeleteConfig: 完整配置
  */
 type SoftDeleteOption = string | boolean | SoftDeleteConfig;
-interface CrudRouterConfigBase {
+/**
+ * 列表查询输入类型
+ */
+interface ListInput {
+  page: number;
+  perPage: number;
+  sort?: Array<{
+    id: string;
+    desc: boolean;
+  }>;
+  filters?: Array<{
+    id: string;
+    value: string | string[];
+    variant: string;
+    operator: string;
+    filterId: string;
+  }>;
+  joinOperator: "and" | "or";
+}
+/**
+ * 列表查询结果类型
+ */
+interface ListResult<TSelect> {
+  data: TSelect[];
+  total: number;
+  page: number;
+  perPage: number;
+  pageCount: number;
+}
+/**
+ * CRUD 生命周期钩子
+ *
+ * @example
+ * hooks: {
+ *   beforeCreate: async (ctx, data) => {
+ *     // 修改数据
+ *     return { ...data, slug: slugify(data.title) };
+ *   },
+ *   afterCreate: async (ctx, created) => {
+ *     // 发送通知
+ *     await sendNotification(created);
+ *   },
+ * }
+ */
+interface CrudHooks<TContext = unknown> {
+  /**
+   * 列表查询前
+   * 可修改查询参数
+   */
+  beforeList?: (ctx: TContext, input: ListInput) => ListInput | void | Promise<ListInput | void>;
+  /**
+   * 列表查询后
+   * 可修改返回结果
+   */
+  afterList?: <TSelect>(ctx: TContext, result: ListResult<TSelect>) => ListResult<TSelect> | void | Promise<ListResult<TSelect> | void>;
+  /**
+   * 单条查询前
+   */
+  beforeGet?: (ctx: TContext, id: string) => void | Promise<void>;
+  /**
+   * 单条查询后
+   * 可修改返回结果
+   */
+  afterGet?: <TSelect>(ctx: TContext, result: TSelect | null) => TSelect | null | void | Promise<TSelect | null | void>;
+  /**
+   * 创建前
+   * 可修改输入数据，返回新数据或抛出错误阻止创建
+   */
+  beforeCreate?: <TInsert>(ctx: TContext, data: TInsert) => TInsert | void | Promise<TInsert | void>;
+  /**
+   * 创建后
+   * 用于副作用（日志、通知、同步等）
+   */
+  afterCreate?: <TSelect>(ctx: TContext, created: TSelect) => void | Promise<void>;
+  /**
+   * 更新前
+   * 可修改输入数据，existing 为更新前的记录
+   */
+  beforeUpdate?: <TUpdate, TSelect>(ctx: TContext, id: string, data: TUpdate, existing: TSelect) => TUpdate | void | Promise<TUpdate | void>;
+  /**
+   * 更新后
+   */
+  afterUpdate?: <TSelect>(ctx: TContext, updated: TSelect) => void | Promise<void>;
+  /**
+   * 删除前
+   * existing 为删除前的记录，可抛出错误阻止删除
+   */
+  beforeDelete?: <TSelect>(ctx: TContext, id: string, existing: TSelect) => void | Promise<void>;
+  /**
+   * 删除后
+   */
+  afterDelete?: <TSelect>(ctx: TContext, deleted: TSelect) => void | Promise<void>;
+  /**
+   * 批量删除前
+   */
+  beforeDeleteMany?: (ctx: TContext, ids: string[]) => void | Promise<void>;
+  /**
+   * 批量删除后
+   */
+  afterDeleteMany?: (ctx: TContext, result: {
+    deleted: number;
+  }) => void | Promise<void>;
+  /**
+   * 批量更新前
+   * 可修改输入数据
+   */
+  beforeUpdateMany?: <TUpdate>(ctx: TContext, ids: string[], data: TUpdate) => TUpdate | void | Promise<TUpdate | void>;
+  /**
+   * 批量更新后
+   */
+  afterUpdateMany?: (ctx: TContext, result: {
+    updated: number;
+  }) => void | Promise<void>;
+}
+interface CrudRouterConfigBase<TContext = unknown> {
   /** Drizzle 表定义 */
   table: PgTable;
   /** 查询返回 Schema */
@@ -78,8 +192,23 @@ interface CrudRouterConfigBase {
    * softDelete: { column: 'isDeleted', value: () => true }
    */
   softDelete?: SoftDeleteOption;
+  /**
+   * 生命周期钩子
+   * 在 CRUD 操作前后注入自定义逻辑
+   *
+   * @example
+   * hooks: {
+   *   beforeCreate: async (ctx, data) => {
+   *     return { ...data, slug: slugify(data.title) };
+   *   },
+   *   afterCreate: async (ctx, created) => {
+   *     await sendNotification(created);
+   *   },
+   * }
+   */
+  hooks?: CrudHooks<TContext>;
 }
-interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode?: "declarative";
   /**
    * 基础 procedure（认证）
@@ -119,7 +248,7 @@ interface DeclarativeConfig<TContext = unknown> extends CrudRouterConfigBase {
    */
   authorize?: (ctx: TContext, resource: Record<string, unknown>, operation: CrudOperation) => boolean | Promise<boolean>;
 }
-interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode: "factory";
   /**
    * Procedure 工厂函数
@@ -138,7 +267,7 @@ interface FactoryConfig<TContext = unknown> extends CrudRouterConfigBase {
    */
   inject?: (ctx: TContext, operation: WriteOperation) => Record<string, unknown>;
 }
-interface ProceduresConfig<TContext = unknown> extends CrudRouterConfigBase {
+interface ProceduresConfig<TContext = unknown> extends CrudRouterConfigBase<TContext> {
   mode: "procedures";
   /**
    * 按操作指定不同的 procedure
@@ -168,9 +297,9 @@ type CrudRouterConfig<TContext = unknown> = DeclarativeConfig<TContext> | Factor
 declare function createCrudRouter<TContext = unknown>(config: CrudRouterConfig<TContext>): node_modules__trpc_server_dist_unstable_core_do_not_import_d_CjQPvBRI_mjs0.Router<{
   ctx: Context;
   meta: object;
-  errorShape: _trpc_server5.TRPCDefaultErrorShape;
+  errorShape: _trpc_server2.TRPCDefaultErrorShape;
   transformer: true;
-}, _trpc_server5.TRPCDecorateCreateRouterOptions<{
+}, _trpc_server2.TRPCDecorateCreateRouterOptions<{
   list: any;
   getById: any;
   create: any;
@@ -178,7 +307,7 @@ declare function createCrudRouter<TContext = unknown>(config: CrudRouterConfig<T
   delete: any;
   deleteMany: any;
   updateMany: any;
-}>> & _trpc_server5.TRPCDecorateCreateRouterOptions<{
+}>> & _trpc_server2.TRPCDecorateCreateRouterOptions<{
   list: any;
   getById: any;
   create: any;
@@ -199,12 +328,12 @@ declare function createCrudRouter<TContext = unknown>(config: CrudRouterConfig<T
 };
 //#endregion
 //#region src/routers/index.d.ts
-declare const appRouter: _trpc_server5.TRPCBuiltRouter<{
+declare const appRouter: _trpc_server2.TRPCBuiltRouter<{
   ctx: Context;
   meta: object;
-  errorShape: _trpc_server5.TRPCDefaultErrorShape;
+  errorShape: _trpc_server2.TRPCDefaultErrorShape;
   transformer: true;
-}, _trpc_server5.TRPCDecorateCreateRouterOptions<{}>>;
+}, _trpc_server2.TRPCDecorateCreateRouterOptions<{}>>;
 type AppRouter = typeof appRouter;
 //#endregion
-export { type AnyProcedure, type AppRouter, type CrudOperation, type CrudRouterConfig, type DeclarativeConfig, type FactoryConfig, type ProceduresConfig, type SoftDeleteConfig, type SoftDeleteOption, type WriteOperation, appRouter, createCrudRouter, publicProcedure, router };
+export { type AnyProcedure, type AppRouter, type CrudHooks, type CrudOperation, type CrudRouterConfig, type DeclarativeConfig, type FactoryConfig, type ListInput, type ListResult, type ProceduresConfig, type SoftDeleteConfig, type SoftDeleteOption, type WriteOperation, appRouter, createCrudRouter, publicProcedure, router };

package/dist/index.js

@@ -447,9 +447,10 @@ function validateColumn(columnId, allowedColumns) {
 	return allowedColumns.includes(columnId);
 }
 function createCrudRouter(config) {
-	const { table, insertSchema, updateSchema, idField = "id", filterableColumns, sortableColumns, maxBatchSize = 100, softDelete: softDeleteOption } = config;
+	const { table, insertSchema, updateSchema, idField = "id", filterableColumns, sortableColumns, maxBatchSize = 100, softDelete: softDeleteOption, hooks = {} } = config;
 	const resolved = resolveConfig(config);
 	const softDelete = resolveSoftDelete(softDeleteOption);
+	const h = hooks;
 	const getIdColumn = () => table[idField];
 	const getSoftDeleteColumn = () => softDelete ? table[softDelete.column] : null;
 	const buildWhere = (ctx, operation, additionalCondition) => {
@@ -477,49 +478,71 @@ function createCrudRouter(config) {
 	const procedures = {
 		list: resolved.procedureFactory("list").input(listInputSchema).query(async ({ ctx, input }) => {
 			await withGuard(ctx, "list");
-			const offset = (input.page - 1) * input.perPage;
-			const validatedFilters = input.filters?.filter((filter) => validateColumn(filter.id, filterableColumns));
+			let processedInput = input;
+			if (h.beforeList) {
+				const result = await h.beforeList(ctx, processedInput);
+				if (result) processedInput = result;
+			}
+			const offset = (processedInput.page - 1) * processedInput.perPage;
+			const validatedFilters = processedInput.filters?.filter((filter) => validateColumn(filter.id, filterableColumns));
 			const where = buildWhere(ctx, "list", validatedFilters?.length ? filterColumns({
 				table,
 				filters: validatedFilters,
-				joinOperator: input.joinOperator
+				joinOperator: processedInput.joinOperator
 			}) : void 0);
 			let query = ctx.db.select().from(table).$dynamic();
 			if (where) query = query.where(where);
-			if (input.sort?.length) {
-				const sortField = input.sort[0];
+			if (processedInput.sort?.length) {
+				const sortField = processedInput.sort[0];
 				if (sortField && validateColumn(sortField.id, sortableColumns)) {
 					const column = table[sortField.id];
 					if (column) query = query.orderBy(sortField.desc ? desc(column) : asc(column));
 				}
 			}
-			const data = await query.limit(input.perPage).offset(offset);
+			const data = await query.limit(processedInput.perPage).offset(offset);
 			let countQuery = ctx.db.select({ count: sql`count(*)::int` }).from(table).$dynamic();
 			if (where) countQuery = countQuery.where(where);
 			const count = (await countQuery)[0]?.count ?? 0;
-			return {
+			let listResult = {
 				data,
 				total: count,
-				page: input.page,
-				perPage: input.perPage,
-				pageCount: Math.ceil(count / input.perPage)
+				page: processedInput.page,
+				perPage: processedInput.perPage,
+				pageCount: Math.ceil(count / processedInput.perPage)
 			};
+			if (h.afterList) {
+				const result = await h.afterList(ctx, listResult);
+				if (result) listResult = result;
+			}
+			return listResult;
 		}),
 		getById: resolved.procedureFactory("get").input(z.string()).query(async ({ ctx, input }) => {
 			await withGuard(ctx, "get");
+			if (h.beforeGet) await h.beforeGet(ctx, input);
 			const where = buildWhere(ctx, "get", eq(getIdColumn(), input));
 			const [item] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, item, "get");
-			return item ?? null;
+			let result = item ?? null;
+			if (h.afterGet) {
+				const hookResult = await h.afterGet(ctx, result);
+				if (hookResult !== void 0) result = hookResult;
+			}
+			return result;
 		}),
 		create: resolved.procedureFactory("create").input(insertSchema).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "create");
+			let processedData = input;
+			if (h.beforeCreate) {
+				const result = await h.beforeCreate(ctx, processedData);
+				if (result) processedData = result;
+			}
 			const injectData = resolved.getInject(ctx, "create");
 			const data = {
-				...input,
+				...processedData,
 				...injectData
 			};
 			const [created] = await ctx.db.insert(table).values(data).returning();
+			if (h.afterCreate) await h.afterCreate(ctx, created);
 			return created;
 		}),
 		update: resolved.procedureFactory("update").input(z.object({
@@ -531,12 +554,18 @@ function createCrudRouter(config) {
 			const [existing] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, existing, "update");
 			if (!existing) throw new Error("Resource not found or access denied");
+			let processedData = input.data;
+			if (h.beforeUpdate) {
+				const result = await h.beforeUpdate(ctx, input.id, processedData, existing);
+				if (result) processedData = result;
+			}
 			const injectData = resolved.getInject(ctx, "update");
 			const data = {
-				...input.data,
+				...processedData,
 				...injectData
 			};
 			const [updated] = await ctx.db.update(table).set(data).where(where).returning();
+			if (h.afterUpdate) await h.afterUpdate(ctx, updated);
 			return updated;
 		}),
 		delete: resolved.procedureFactory("delete").input(z.string()).mutation(async ({ ctx, input }) => {
@@ -545,31 +574,42 @@ function createCrudRouter(config) {
 			const [existing] = await ctx.db.select().from(table).where(where);
 			await withAuthorize(ctx, existing, "delete");
 			if (!existing) throw new Error("Resource not found or access denied");
-			if (softDelete) {
-				const [deleted$1] = await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning();
-				return deleted$1;
-			}
-			const [deleted] = await ctx.db.delete(table).where(where).returning();
+			if (h.beforeDelete) await h.beforeDelete(ctx, input, existing);
+			let deleted;
+			if (softDelete) [deleted] = await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning();
+			else [deleted] = await ctx.db.delete(table).where(where).returning();
+			if (h.afterDelete) await h.afterDelete(ctx, deleted);
 			return deleted;
 		}),
 		deleteMany: resolved.procedureFactory("deleteMany").input(z.array(z.string()).max(maxBatchSize)).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "deleteMany");
+			if (h.beforeDeleteMany) await h.beforeDeleteMany(ctx, input);
 			const where = buildWhere(ctx, "deleteMany", inArray(getIdColumn(), input));
-			if (softDelete) return { deleted: (await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning()).length };
-			return { deleted: (await ctx.db.delete(table).where(where).returning()).length };
+			let result;
+			if (softDelete) result = { deleted: (await ctx.db.update(table).set({ [softDelete.column]: softDelete.getValue() }).where(where).returning()).length };
+			else result = { deleted: (await ctx.db.delete(table).where(where).returning()).length };
+			if (h.afterDeleteMany) await h.afterDeleteMany(ctx, result);
+			return result;
 		}),
 		updateMany: resolved.procedureFactory("updateMany").input(z.object({
 			ids: z.array(z.string()).max(maxBatchSize),
 			data: updateSchema
 		})).mutation(async ({ ctx, input }) => {
 			await withGuard(ctx, "updateMany");
+			let processedData = input.data;
+			if (h.beforeUpdateMany) {
+				const result$1 = await h.beforeUpdateMany(ctx, input.ids, processedData);
+				if (result$1) processedData = result$1;
+			}
 			const where = buildWhere(ctx, "updateMany", inArray(getIdColumn(), input.ids));
 			const injectData = resolved.getInject(ctx, "update");
 			const data = {
-				...input.data,
+				...processedData,
 				...injectData
 			};
-			return { updated: (await ctx.db.update(table).set(data).where(where).returning()).length };
+			const result = { updated: (await ctx.db.update(table).set(data).where(where).returning()).length };
+			if (h.afterUpdateMany) await h.afterUpdateMany(ctx, result);
+			return result;
 		})
 	};
 	const crudRouter = router(procedures);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud-server",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "tRPC server utilities for auto-crud - automatic CRUD routers for Drizzle ORM",
   "author": "wordrhyme",
   "license": "MIT",
@@ -47,8 +47,8 @@
     "typescript": "^5.9.3",
     "zod": "^4.1.13",
     "@internal/eslint-config": "0.3.0",
-    "@internal/prettier-config": "0.0.1",
     "@internal/tsconfig": "0.1.0",
+    "@internal/prettier-config": "0.0.1",
     "@internal/tsdown-config": "0.1.0",
     "@internal/vitest-config": "0.1.0"
   },