@dismissible/nestjs-dismissible 0.1.0-canary.4b708a5.0

package/src/core/hook-runner.service.d.ts

@@ -0,0 +1,72 @@
+import { IDismissibleLifecycleHook } from './lifecycle-hook.interface';
+import { IDismissibleLogger } from '@dismissible/nestjs-logger';
+import { BaseMetadata, DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
+import { IRequestContext } from '../request/request-context.interface';
+/**
+ * Result from running pre-hooks.
+ */
+export interface IHookRunResult {
+    /** Whether the operation should proceed */
+    proceed: boolean;
+    /** The (potentially mutated) item ID */
+    id: string;
+    /** The (potentially mutated) user ID */
+    userId: string;
+    /** The (potentially mutated) request context */
+    context?: IRequestContext;
+    /** Reason for blocking (if proceed is false) */
+    reason?: string;
+}
+/**
+ * Service responsible for running lifecycle hooks.
+ */
+export declare class HookRunner<TMetadata extends BaseMetadata = BaseMetadata> {
+    private readonly logger;
+    private readonly sortedHooks;
+    constructor(hooks: IDismissibleLifecycleHook<TMetadata>[], logger: IDismissibleLogger);
+    /**
+     * Run pre-getOrCreate hooks.
+     */
+    runPreGetOrCreate(itemId: string, userId: string, context?: IRequestContext): Promise<IHookRunResult>;
+    /**
+     * Run post-getOrCreate hooks.
+     */
+    runPostGetOrCreate(itemId: string, item: DismissibleItemDto<TMetadata>, userId: string, context?: IRequestContext): Promise<void>;
+    /**
+     * Run pre-create hooks.
+     */
+    runPreCreate(itemId: string, userId: string, context?: IRequestContext): Promise<IHookRunResult>;
+    /**
+     * Run post-create hooks.
+     */
+    runPostCreate(itemId: string, item: DismissibleItemDto<TMetadata>, userId: string, context?: IRequestContext): Promise<void>;
+    /**
+     * Run pre-dismiss hooks.
+     */
+    runPreDismiss(itemId: string, userId: string, context?: IRequestContext): Promise<IHookRunResult>;
+    /**
+     * Run post-dismiss hooks.
+     */
+    runPostDismiss(itemId: string, item: DismissibleItemDto<TMetadata>, userId: string, context?: IRequestContext): Promise<void>;
+    /**
+     * Run pre-restore hooks.
+     */
+    runPreRestore(itemId: string, userId: string, context?: IRequestContext): Promise<IHookRunResult>;
+    /**
+     * Run post-restore hooks.
+     */
+    runPostRestore(itemId: string, item: DismissibleItemDto<TMetadata>, userId: string, context?: IRequestContext): Promise<void>;
+    /**
+     * Internal method to run pre-hooks.
+     */
+    private runPreHooks;
+    /**
+     * Internal method to run post-hooks.
+     * Post-hooks run in reverse priority order.
+     */
+    private runPostHooks;
+    /**
+     * Throw ForbiddenException if the hook result indicates the operation was blocked.
+     */
+    static throwIfBlocked(result: IHookRunResult): void;
+}

package/src/core/hook-runner.service.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookRunner = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const lifecycle_hook_interface_1 = require("./lifecycle-hook.interface");
+const nestjs_logger_1 = require("@dismissible/nestjs-logger");
+/**
+ * Service responsible for running lifecycle hooks.
+ */
+let HookRunner = class HookRunner {
+    constructor(hooks = [], logger) {
+        this.logger = logger;
+        // Sort hooks by priority (lower numbers first)
+        this.sortedHooks = [...hooks].sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+    }
+    /**
+     * Run pre-getOrCreate hooks.
+     */
+    async runPreGetOrCreate(itemId, userId, context) {
+        return this.runPreHooks('onBeforeGetOrCreate', itemId, userId, context);
+    }
+    /**
+     * Run post-getOrCreate hooks.
+     */
+    async runPostGetOrCreate(itemId, item, userId, context) {
+        await this.runPostHooks('onAfterGetOrCreate', itemId, item, userId, context);
+    }
+    /**
+     * Run pre-create hooks.
+     */
+    async runPreCreate(itemId, userId, context) {
+        return this.runPreHooks('onBeforeCreate', itemId, userId, context);
+    }
+    /**
+     * Run post-create hooks.
+     */
+    async runPostCreate(itemId, item, userId, context) {
+        await this.runPostHooks('onAfterCreate', itemId, item, userId, context);
+    }
+    /**
+     * Run pre-dismiss hooks.
+     */
+    async runPreDismiss(itemId, userId, context) {
+        return this.runPreHooks('onBeforeDismiss', itemId, userId, context);
+    }
+    /**
+     * Run post-dismiss hooks.
+     */
+    async runPostDismiss(itemId, item, userId, context) {
+        await this.runPostHooks('onAfterDismiss', itemId, item, userId, context);
+    }
+    /**
+     * Run pre-restore hooks.
+     */
+    async runPreRestore(itemId, userId, context) {
+        return this.runPreHooks('onBeforeRestore', itemId, userId, context);
+    }
+    /**
+     * Run post-restore hooks.
+     */
+    async runPostRestore(itemId, item, userId, context) {
+        await this.runPostHooks('onAfterRestore', itemId, item, userId, context);
+    }
+    /**
+     * Internal method to run pre-hooks.
+     */
+    async runPreHooks(hookName, itemId, userId, context) {
+        let currentId = itemId;
+        let currentUserId = userId;
+        let currentContext = context ? { ...context } : undefined;
+        for (const hook of this.sortedHooks) {
+            const hookFn = hook[hookName];
+            if (hookFn) {
+                try {
+                    const result = await hookFn.call(hook, currentId, currentUserId, currentContext);
+                    if (!result.proceed) {
+                        this.logger.debug(`Hook ${hook.constructor.name}.${hookName} blocked operation`, {
+                            itemId: currentId,
+                            userId: currentUserId,
+                            reason: result.reason,
+                        });
+                        return {
+                            proceed: false,
+                            id: currentId,
+                            userId: currentUserId,
+                            context: currentContext,
+                            reason: result.reason,
+                        };
+                    }
+                    // Apply mutations if present
+                    if (result.mutations) {
+                        if (result.mutations.id !== undefined) {
+                            currentId = result.mutations.id;
+                        }
+                        if (result.mutations.userId !== undefined) {
+                            currentUserId = result.mutations.userId;
+                        }
+                        if (result.mutations.context && currentContext) {
+                            currentContext = { ...currentContext, ...result.mutations.context };
+                        }
+                    }
+                }
+                catch (error) {
+                    this.logger.error(`Error in hook ${hook.constructor.name}.${hookName}`, error instanceof Error ? error : new Error(String(error)), {
+                        itemId: currentId,
+                        userId: currentUserId,
+                    });
+                    throw error;
+                }
+            }
+        }
+        return {
+            proceed: true,
+            id: currentId,
+            userId: currentUserId,
+            context: currentContext,
+        };
+    }
+    /**
+     * Internal method to run post-hooks.
+     * Post-hooks run in reverse priority order.
+     */
+    async runPostHooks(hookName, itemId, item, userId, context) {
+        // Run in reverse order for post-hooks
+        const reversedHooks = [...this.sortedHooks].reverse();
+        for (const hook of reversedHooks) {
+            const hookFn = hook[hookName];
+            if (hookFn) {
+                try {
+                    await hookFn.call(hook, itemId, item, userId, context);
+                }
+                catch (error) {
+                    this.logger.error(`Error in hook ${hook.constructor.name}.${hookName}`, error instanceof Error ? error : new Error(String(error)), {
+                        itemId,
+                        userId,
+                    });
+                    // Post-hooks errors are logged but don't block the operation
+                }
+            }
+        }
+    }
+    /**
+     * Throw ForbiddenException if the hook result indicates the operation was blocked.
+     */
+    static throwIfBlocked(result) {
+        if (!result.proceed) {
+            throw new common_1.ForbiddenException(result.reason ?? 'Operation blocked by lifecycle hook');
+        }
+    }
+};
+exports.HookRunner = HookRunner;
+exports.HookRunner = HookRunner = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Optional)()),
+    tslib_1.__param(0, (0, common_1.Inject)(lifecycle_hook_interface_1.DISMISSIBLE_HOOKS)),
+    tslib_1.__param(1, (0, common_1.Inject)(nestjs_logger_1.DISMISSIBLE_LOGGER)),
+    tslib_1.__metadata("design:paramtypes", [Array, Object])
+], HookRunner);
+//# sourceMappingURL=hook-runner.service.js.map

package/src/core/hook-runner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.service.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/core/hook-runner.service.ts"],"names":[],"mappings":"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"}

package/src/core/hook-runner.service.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/src/core/hook-runner.service.spec.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts_jest_mocker_1 = require("ts-jest-mocker");
+const common_1 = require("@nestjs/common");
+const hook_runner_service_1 = require("./hook-runner.service");
+const factories_1 = require("../testing/factories");
+describe('HookRunner', () => {
+    let hookRunner;
+    let mockLogger;
+    const testUserId = 'test-user-id';
+    beforeEach(() => {
+        mockLogger = (0, ts_jest_mocker_1.mock)({ failIfMockNotProvided: false });
+    });
+    describe('with no hooks', () => {
+        beforeEach(() => {
+            hookRunner = new hook_runner_service_1.HookRunner([], mockLogger);
+        });
+        it('should return proceed: true for pre-getOrCreate', async () => {
+            const context = (0, factories_1.createTestContext)();
+            const result = await hookRunner.runPreGetOrCreate('test-id', testUserId, context);
+            expect(result.proceed).toBe(true);
+            expect(result.id).toBe('test-id');
+            expect(result.userId).toBe(testUserId);
+            expect(result.context).toEqual(context);
+        });
+        it('should complete post-getOrCreate without error', async () => {
+            const item = (0, factories_1.createTestItem)();
+            const context = (0, factories_1.createTestContext)();
+            await expect(hookRunner.runPostGetOrCreate('test-id', item, testUserId, context)).resolves.not.toThrow();
+        });
+    });
+    describe('with hooks', () => {
+        it('should execute hooks in priority order (low to high) for pre-hooks', async () => {
+            const executionOrder = [];
+            const hook1 = {
+                priority: 10,
+                onBeforeGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(10);
+                    return { proceed: true };
+                }),
+            };
+            const hook2 = {
+                priority: 5,
+                onBeforeGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(5);
+                    return { proceed: true };
+                }),
+            };
+            const hook3 = {
+                priority: 15,
+                onBeforeGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(15);
+                    return { proceed: true };
+                }),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([hook1, hook2, hook3], mockLogger);
+            await hookRunner.runPreGetOrCreate('test-id', testUserId, (0, factories_1.createTestContext)());
+            expect(executionOrder).toEqual([5, 10, 15]);
+        });
+        it('should execute hooks in reverse priority order for post-hooks', async () => {
+            const executionOrder = [];
+            const hook1 = {
+                priority: 10,
+                onAfterGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(10);
+                }),
+            };
+            const hook2 = {
+                priority: 5,
+                onAfterGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(5);
+                }),
+            };
+            const hook3 = {
+                priority: 15,
+                onAfterGetOrCreate: jest.fn(async () => {
+                    executionOrder.push(15);
+                }),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([hook1, hook2, hook3], mockLogger);
+            await hookRunner.runPostGetOrCreate('test-id', (0, factories_1.createTestItem)(), testUserId, (0, factories_1.createTestContext)());
+            expect(executionOrder).toEqual([15, 10, 5]);
+        });
+        it('should block operation when pre-hook returns proceed: false', async () => {
+            const blockingHook = {
+                onBeforeGetOrCreate: jest.fn(async () => ({
+                    proceed: false,
+                    reason: 'Rate limit exceeded',
+                })),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([blockingHook], mockLogger);
+            const result = await hookRunner.runPreGetOrCreate('test-id', testUserId, (0, factories_1.createTestContext)());
+            expect(result.proceed).toBe(false);
+            expect(result.reason).toBe('Rate limit exceeded');
+        });
+        it('should apply mutations from pre-hooks', async () => {
+            const mutatingHook = {
+                onBeforeGetOrCreate: jest.fn(async () => ({
+                    proceed: true,
+                    mutations: {
+                        id: 'mutated-id',
+                        userId: 'mutated-user',
+                    },
+                })),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([mutatingHook], mockLogger);
+            const result = await hookRunner.runPreGetOrCreate('original-id', testUserId, (0, factories_1.createTestContext)());
+            expect(result.id).toBe('mutated-id');
+            expect(result.userId).toBe('mutated-user');
+        });
+        it('should pass mutations through multiple hooks', async () => {
+            const hook1 = {
+                priority: 1,
+                onBeforeGetOrCreate: jest.fn(async (itemId) => ({
+                    proceed: true,
+                    mutations: { id: `${itemId}-hook1` },
+                })),
+            };
+            const hook2 = {
+                priority: 2,
+                onBeforeGetOrCreate: jest.fn(async (itemId) => ({
+                    proceed: true,
+                    mutations: { id: `${itemId}-hook2` },
+                })),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([hook1, hook2], mockLogger);
+            const result = await hookRunner.runPreGetOrCreate('original', testUserId, (0, factories_1.createTestContext)());
+            expect(result.id).toBe('original-hook1-hook2');
+        });
+    });
+    describe('error handling', () => {
+        it('should throw error from pre-hook', async () => {
+            const errorHook = {
+                onBeforeGetOrCreate: jest.fn(async () => {
+                    throw new Error('Hook error');
+                }),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([errorHook], mockLogger);
+            await expect(hookRunner.runPreGetOrCreate('test-id', testUserId, (0, factories_1.createTestContext)())).rejects.toThrow('Hook error');
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+        it('should log but not throw errors from post-hooks', async () => {
+            const errorHook = {
+                onAfterGetOrCreate: jest.fn(async () => {
+                    throw new Error('Post-hook error');
+                }),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([errorHook], mockLogger);
+            await expect(hookRunner.runPostGetOrCreate('test-id', (0, factories_1.createTestItem)(), testUserId, (0, factories_1.createTestContext)())).resolves.not.toThrow();
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+    });
+    describe('throwIfBlocked', () => {
+        it('should throw ForbiddenException when blocked', () => {
+            expect(() => hook_runner_service_1.HookRunner.throwIfBlocked({
+                proceed: false,
+                id: 'test',
+                userId: testUserId,
+                context: (0, factories_1.createTestContext)(),
+                reason: 'Not allowed',
+            })).toThrow(common_1.ForbiddenException);
+        });
+        it('should not throw when not blocked', () => {
+            expect(() => hook_runner_service_1.HookRunner.throwIfBlocked({
+                proceed: true,
+                id: 'test',
+                userId: testUserId,
+                context: (0, factories_1.createTestContext)(),
+            })).not.toThrow();
+        });
+    });
+    describe('all hook methods', () => {
+        let allMethodsHook;
+        beforeEach(() => {
+            allMethodsHook = {
+                priority: 0,
+                onBeforeGetOrCreate: jest.fn().mockResolvedValue({ proceed: true }),
+                onAfterGetOrCreate: jest.fn(),
+                onBeforeCreate: jest.fn().mockResolvedValue({ proceed: true }),
+                onAfterCreate: jest.fn(),
+                onBeforeDismiss: jest.fn().mockResolvedValue({ proceed: true }),
+                onAfterDismiss: jest.fn(),
+                onBeforeRestore: jest.fn().mockResolvedValue({ proceed: true }),
+                onAfterRestore: jest.fn(),
+            };
+            hookRunner = new hook_runner_service_1.HookRunner([allMethodsHook], mockLogger);
+        });
+        it('should run pre and post create hooks', async () => {
+            const context = (0, factories_1.createTestContext)();
+            const item = (0, factories_1.createTestItem)();
+            await hookRunner.runPreCreate('test-id', testUserId, context);
+            await hookRunner.runPostCreate('test-id', item, testUserId, context);
+            expect(allMethodsHook.onBeforeCreate).toHaveBeenCalledWith('test-id', testUserId, context);
+            expect(allMethodsHook.onAfterCreate).toHaveBeenCalledWith('test-id', item, testUserId, context);
+        });
+        it('should run pre and post dismiss hooks', async () => {
+            const context = (0, factories_1.createTestContext)();
+            const item = (0, factories_1.createTestItem)();
+            await hookRunner.runPreDismiss('test-id', testUserId, context);
+            await hookRunner.runPostDismiss('test-id', item, testUserId, context);
+            expect(allMethodsHook.onBeforeDismiss).toHaveBeenCalledWith('test-id', testUserId, context);
+            expect(allMethodsHook.onAfterDismiss).toHaveBeenCalledWith('test-id', item, testUserId, context);
+        });
+        it('should run pre and post restore hooks', async () => {
+            const context = (0, factories_1.createTestContext)();
+            const item = (0, factories_1.createTestItem)();
+            await hookRunner.runPreRestore('test-id', testUserId, context);
+            await hookRunner.runPostRestore('test-id', item, testUserId, context);
+            expect(allMethodsHook.onBeforeRestore).toHaveBeenCalledWith('test-id', testUserId, context);
+            expect(allMethodsHook.onAfterRestore).toHaveBeenCalledWith('test-id', item, testUserId, context);
+        });
+    });
+});
+//# sourceMappingURL=hook-runner.service.spec.js.map

package/src/core/hook-runner.service.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.service.spec.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/core/hook-runner.service.spec.ts"],"names":[],"mappings":"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"}

package/src/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lifecycle-hook.interface';
+export * from './service-responses.interface';
+export * from './dismissible-core.service';
+export * from './hook-runner.service';
+export * from './dismissible.service';
+export * from './create-options';

package/src/core/index.js

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

package/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/core/index.ts"],"names":[],"mappings":";;;AAAA,qEAA2C;AAC3C,wEAA8C;AAC9C,qEAA2C;AAC3C,gEAAsC;AACtC,gEAAsC;AACtC,2DAAiC"}

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

@@ -0,0 +1,70 @@
+import { BaseMetadata, DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
+import { IRequestContext } from '../request/request-context.interface';
+/**
+ * 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<TMetadata extends BaseMetadata = BaseMetadata> {
+    /**
+     * Priority for hook execution (lower numbers run first).
+     * Default is 0.
+     */
+    readonly priority?: number;
+    /**
+     * Called before getOrCreate operation.
+     */
+    onBeforeGetOrCreate?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after getOrCreate operation.
+     */
+    onAfterGetOrCreate?(itemId: string, item: DismissibleItemDto<TMetadata>, userId: string, context?: IRequestContext): Promise<void> | void;
+    /**
+     * Called before creating a new item.
+     */
+    onBeforeCreate?(itemId: string, userId: string, context?: IRequestContext): Promise<IHookResult> | IHookResult;
+    /**
+     * Called after creating a new item.
+     */
+    onAfterCreate?(itemId: string, item: DismissibleItemDto<TMetadata>, 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<TMetadata>, 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<TMetadata>, userId: string, context?: IRequestContext): Promise<void> | void;
+}

package/src/core/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/core/lifecycle-hook.interface.js.map

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

package/src/core/service-responses.interface.d.ts

@@ -0,0 +1,28 @@
+import { BaseMetadata, DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
+/**
+ * Response from getOrCreate operation.
+ */
+export interface IGetOrCreateServiceResponse<TMetadata extends BaseMetadata = BaseMetadata> {
+    /** The item (either retrieved or created) */
+    item: DismissibleItemDto<TMetadata>;
+    /** Whether the item was newly created */
+    created: boolean;
+}
+/**
+ * Response from dismiss operation.
+ */
+export interface IDismissServiceResponse<TMetadata extends BaseMetadata = BaseMetadata> {
+    /** The dismissed item */
+    item: DismissibleItemDto<TMetadata>;
+    /** The item state before dismissal */
+    previousItem: DismissibleItemDto<TMetadata>;
+}
+/**
+ * Response from restore operation.
+ */
+export interface IRestoreServiceResponse<TMetadata extends BaseMetadata = BaseMetadata> {
+    /** The restored item */
+    item: DismissibleItemDto<TMetadata>;
+    /** The item state before restoration */
+    previousItem: DismissibleItemDto<TMetadata>;
+}

package/src/core/service-responses.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=service-responses.interface.js.map

package/src/core/service-responses.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-responses.interface.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/core/service-responses.interface.ts"],"names":[],"mappings":""}

package/src/dismissible.module.d.ts

@@ -0,0 +1,14 @@
+import { DynamicModule, Type } from '@nestjs/common';
+import { IDismissibleLifecycleHook } from './core/lifecycle-hook.interface';
+import { IDismissibleLoggerModuleOptions } from '@dismissible/nestjs-logger';
+import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
+import { IDismissibleStorageModuleOptions } from '@dismissible/nestjs-storage';
+/**
+ * Module configuration options.
+ */
+export type IDismissibleModuleOptions<TMetadata extends BaseMetadata = BaseMetadata> = IDismissibleLoggerModuleOptions & IDismissibleStorageModuleOptions & {
+    hooks?: Type<IDismissibleLifecycleHook<TMetadata>>[];
+};
+export declare class DismissibleModule {
+    static forRoot<TMetadata extends BaseMetadata = BaseMetadata>(options: IDismissibleModuleOptions<TMetadata>): DynamicModule;
+}