@dismissible/nestjs-dismissible-hooks 0.0.2-canary.585db17.0 → 0.0.2-canary.a611bd3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dismissible/nestjs-dismissible-hooks",
-  "version": "0.0.2-canary.585db17.0",
+  "version": "0.0.2-canary.a611bd3.0",
   "description": "Lifecycle hooks interfaces for Dismissible applications",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -11,9 +11,13 @@
       "types": "./src/index.d.ts"
     }
   },
+  "files": [
+    "src",
+    "README.md"
+  ],
   "dependencies": {
-    "@dismissible/nestjs-dismissible-item": "^0.0.2-canary.585db17.0",
-    "@dismissible/nestjs-dismissible-request": "^0.0.2-canary.585db17.0"
+    "@dismissible/nestjs-dismissible-item": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-dismissible-request": "0.0.2-canary.a611bd3.0"
   },
   "keywords": [
     "nestjs",
@@ -29,5 +33,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "type": "commonjs"
 }

package/src/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lifecycle-hook.interface"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/dismissible-hooks/src/index.ts"],"names":[],"mappings":";;;AAAA,qEAA2C"}

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

@@ -0,0 +1,84 @@
+import { DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
+import { IRequestContext } from '@dismissible/nestjs-dismissible-request';
+/**
+ * Injection token for lifecycle hooks.
+ */
+export declare const DISMISSIBLE_HOOKS: unique symbol;
+/**
+ * Mutations that can be applied by pre-hooks.
+ */
+export interface IHookMutations {
+    /** Mutated item ID */
+    id?: string;
+    /** Mutated user ID */
+    userId?: string;
+    /** Mutated request context */
+    context?: Partial<IRequestContext>;
+}
+/**
+ * Result returned by pre-hooks.
+ */
+export interface IHookResult {
+    /** Whether the operation should proceed */
+    proceed: boolean;
+    /** Optional reason if the operation is blocked */
+    reason?: string;
+    /** Optional mutations to apply */
+    mutations?: IHookMutations;
+}
+/**
+ * Interface for lifecycle hooks that can intercept dismissible operations.
+ */
+export interface IDismissibleLifecycleHook {
+    /**
+     * Priority for hook execution (lower numbers run first).
+     * Default is 0.
+     */
+    readonly priority?: number;
+    /**
+     * Called at the start of any operation (getOrCreate, dismiss, restore).
+     * Use for global concerns like authentication, rate limiting, request validation.
+     */
+    onBeforeRequest?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called at the end of any operation (getOrCreate, dismiss, restore).
+     * Use for global concerns like audit logging, metrics, cleanup.
+     */
+    onAfterRequest?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before returning an existing item.
+     * Only called when item exists in storage.
+     * Use for access control based on item state (e.g., block dismissed items).
+     */
+    onBeforeGet?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after returning an existing item.
+     * Only called when item exists in storage.
+     */
+    onAfterGet?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before creating a new item.
+     * Use for plan limits, quota checks, etc.
+     */
+    onBeforeCreate?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after creating a new item.
+     */
+    onAfterCreate?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before dismissing an item.
+     */
+    onBeforeDismiss?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after dismissing an item.
+     */
+    onAfterDismiss?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before restoring an item.
+     */
+    onBeforeRestore?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after restoring an item.
+     */
+    onAfterRestore?(itemId: string, item: DismissibleItemDto, userId: string, context?: IRequestContext): Promise<void> | void;
+}

package/src/lifecycle-hook.interface.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISMISSIBLE_HOOKS = void 0;
+/**
+ * Injection token for lifecycle hooks.
+ */
+exports.DISMISSIBLE_HOOKS = Symbol('DISMISSIBLE_HOOKS');
+//# sourceMappingURL=lifecycle-hook.interface.js.map

package/src/lifecycle-hook.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-hook.interface.js","sourceRoot":"","sources":["../../../../libs/dismissible-hooks/src/lifecycle-hook.interface.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/jest.config.ts

@@ -1,26 +0,0 @@
-export default {
-  displayName: 'dismissible-hooks',
-  preset: '../../jest.preset.js',
-  testEnvironment: 'node',
-  transform: {
-    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.json' }],
-  },
-  moduleFileExtensions: ['ts', 'js', 'html'],
-  coverageDirectory: '../../coverage/libs/dismissible-hooks',
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.spec.ts',
-    '!src/**/*.interface.ts',
-    '!src/**/*.dto.ts',
-    '!src/**/*.enum.ts',
-    '!src/**/index.ts',
-  ],
-  coverageThreshold: {
-    global: {
-      branches: 80,
-      functions: 80,
-      lines: 80,
-      statements: 80,
-    },
-  },
-};

package/project.json

@@ -1,42 +0,0 @@
-{
-  "name": "dismissible-hooks",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "libs/dismissible-hooks/src",
-  "projectType": "library",
-  "tags": [],
-  "targets": {
-    "build": {
-      "executor": "@nx/js:tsc",
-      "outputs": ["{options.outputPath}"],
-      "options": {
-        "outputPath": "dist/libs/dismissible-hooks",
-        "main": "libs/dismissible-hooks/src/index.ts",
-        "tsConfig": "libs/dismissible-hooks/tsconfig.lib.json",
-        "assets": ["libs/dismissible-hooks/package.json", "libs/dismissible-hooks/README.md"],
-        "generatePackageJson": true
-      }
-    },
-    "lint": {
-      "executor": "@nx/eslint:lint",
-      "outputs": ["{options.outputFile}"],
-      "options": {
-        "lintFilePatterns": ["libs/dismissible-hooks/**/*.ts"]
-      }
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "outputs": ["{workspaceRoot}/coverage/libs/dismissible-hooks"],
-      "options": {
-        "jestConfig": "libs/dismissible-hooks/jest.config.ts",
-        "passWithNoTests": true
-      }
-    },
-    "npm-publish": {
-      "executor": "nx:run-commands",
-      "options": {
-        "command": "npm publish --access public",
-        "cwd": "dist/libs/dismissible-hooks"
-      }
-    }
-  }
-}

package/src/lifecycle-hook.interface.ts

@@ -1,148 +0,0 @@
-import { DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
-import { IRequestContext } from '@dismissible/nestjs-dismissible-request';
-
-/**
- * Injection token for lifecycle hooks.
- */
-export const DISMISSIBLE_HOOKS = Symbol('DISMISSIBLE_HOOKS');
-
-/**
- * Mutations that can be applied by pre-hooks.
- */
-export interface IHookMutations {
-  /** Mutated item ID */
-  id?: string;
-
-  /** Mutated user ID */
-  userId?: string;
-
-  /** Mutated request context */
-  context?: Partial<IRequestContext>;
-}
-
-/**
- * Result returned by pre-hooks.
- */
-export interface IHookResult {
-  /** Whether the operation should proceed */
-  proceed: boolean;
-
-  /** Optional reason if the operation is blocked */
-  reason?: string;
-
-  /** Optional mutations to apply */
-  mutations?: IHookMutations;
-}
-
-/**
- * Interface for lifecycle hooks that can intercept dismissible operations.
- */
-export interface IDismissibleLifecycleHook {
-  /**
-   * Priority for hook execution (lower numbers run first).
-   * Default is 0.
-   */
-  readonly priority?: number;
-
-  /**
-   * Called at the start of any operation (getOrCreate, dismiss, restore).
-   * Use for global concerns like authentication, rate limiting, request validation.
-   */
-  onBeforeRequest?(
-    itemId: string,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<IHookResult> | IHookResult;
-
-  /**
-   * Called at the end of any operation (getOrCreate, dismiss, restore).
-   * Use for global concerns like audit logging, metrics, cleanup.
-   */
-  onAfterRequest?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<void> | void;
-
-  /**
-   * Called before returning an existing item.
-   * Only called when item exists in storage.
-   * Use for access control based on item state (e.g., block dismissed items).
-   */
-  onBeforeGet?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<IHookResult> | IHookResult;
-
-  /**
-   * Called after returning an existing item.
-   * Only called when item exists in storage.
-   */
-  onAfterGet?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<void> | void;
-
-  /**
-   * Called before creating a new item.
-   * Use for plan limits, quota checks, etc.
-   */
-  onBeforeCreate?(
-    itemId: string,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<IHookResult> | IHookResult;
-
-  /**
-   * Called after creating a new item.
-   */
-  onAfterCreate?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<void> | void;
-
-  /**
-   * Called before dismissing an item.
-   */
-  onBeforeDismiss?(
-    itemId: string,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<IHookResult> | IHookResult;
-
-  /**
-   * Called after dismissing an item.
-   */
-  onAfterDismiss?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<void> | void;
-
-  /**
-   * Called before restoring an item.
-   */
-  onBeforeRestore?(
-    itemId: string,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<IHookResult> | IHookResult;
-
-  /**
-   * Called after restoring an item.
-   */
-  onAfterRestore?(
-    itemId: string,
-    item: DismissibleItemDto,
-    userId: string,
-    context?: IRequestContext,
-  ): Promise<void> | void;
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "files": [],
-  "include": [],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    },
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ],
-  "compilerOptions": {
-    "esModuleInterop": true
-  }
-}

package/tsconfig.lib.json

@@ -1,14 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "declaration": true,
-    "module": "commonjs",
-    "types": ["node"],
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "target": "ES2021"
-  },
-  "exclude": ["node_modules", "**/*.spec.ts", "**/*.test.ts"],
-  "include": ["src/**/*.ts"]
-}

package/tsconfig.spec.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "module": "commonjs",
-    "types": ["jest", "node"]
-  },
-  "include": ["jest.config.ts", "src/**/*.test.ts", "src/**/*.spec.ts", "src/**/*.d.ts"]
-}