@dismissible/nestjs-hooks 2.0.2-canary.2913ba8.0 → 2.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dismissible/nestjs-hooks",
-  "version": "2.0.2-canary.2913ba8.0",
+  "version": "2.0.3",
   "description": "Lifecycle hooks interfaces for Dismissible applications",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -17,8 +17,8 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@dismissible/nestjs-item": "2.0.2-canary.2913ba8.0",
-    "@dismissible/nestjs-request": "2.0.2-canary.2913ba8.0"
+    "@dismissible/nestjs-item": "^2.0.3",
+    "@dismissible/nestjs-request": "^2.0.3"
   },
   "keywords": [
     "nestjs",
@@ -36,4 +36,4 @@
     "access": "public"
   },
   "type": "commonjs"
-}
+}

package/src/lifecycle-hook.interface.d.ts

@@ -26,6 +26,28 @@ export interface IHookResult {
     /** Optional mutations to apply */
     mutations?: IHookMutations;
 }
+/**
+ * Mutations that can be applied by batch pre-hooks.
+ */
+export interface IBatchHookMutations {
+    /** Mutated item IDs (can filter or transform the array) */
+    itemIds?: string[];
+    /** Mutated user ID */
+    userId?: string;
+    /** Mutated request context */
+    context?: Partial<IRequestContext>;
+}
+/**
+ * Result returned by batch pre-hooks.
+ */
+export interface IBatchHookResult {
+    /** Whether the operation should proceed */
+    proceed: boolean;
+    /** Optional reason if the operation is blocked */
+    reason?: string;
+    /** Optional mutations to apply */
+    mutations?: IBatchHookMutations;
+}
 /**
  * Interface for lifecycle hooks that can intercept dismissible operations.
  */
@@ -81,4 +103,35 @@ export interface IDismissibleLifecycleHook {
      * Called after restoring an item.
      */
     onAfterRestore?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called at the start of any batch operation.
+     * Use for global concerns like authentication, rate limiting, request validation.
+     * Can filter or transform the itemIds array via mutations.
+     */
+    onBeforeBatchRequest?(itemIds: string[], userId: string, context?: IRequestContext): Promise<IBatchHookResult> | IBatchHookResult;
+    /**
+     * Called at the end of any batch operation.
+     * Use for global concerns like audit logging, metrics, cleanup.
+     */
+    onAfterBatchRequest?(items: DismissibleItemDto[], userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before returning existing items in a batch operation.
+     * Only called when items exist in storage.
+     * Use for access control based on item state.
+     */
+    onBeforeBatchGet?(itemIds: string[], items: DismissibleItemDto[], userId: string, context?: IRequestContext): Promise<IBatchHookResult> | IBatchHookResult;
+    /**
+     * Called after returning existing items in a batch operation.
+     */
+    onAfterBatchGet?(items: DismissibleItemDto[], userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before creating new items in a batch operation.
+     * Only receives IDs for items that don't exist yet.
+     * Use for plan limits, quota checks, etc.
+     */
+    onBeforeBatchCreate?(itemIds: string[], userId: string, context?: IRequestContext): Promise<IBatchHookResult> | IBatchHookResult;
+    /**
+     * Called after creating new items in a batch operation.
+     */
+    onAfterBatchCreate?(items: DismissibleItemDto[], userId: string, context?: IRequestContext): Promise<void> | void;
 }