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

package/src/api/use-cases/get-or-create/get-or-create.controller.spec.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts_jest_mocker_1 = require("ts-jest-mocker");
+const get_or_create_controller_1 = require("./get-or-create.controller");
+const dismissible_service_1 = require("../../../core/dismissible.service");
+const dismissible_item_mapper_1 = require("../../dismissible-item.mapper");
+const factories_1 = require("../../../testing/factories");
+const response_1 = require("../../../response");
+describe('GetOrCreateController', () => {
+    let controller;
+    let mockService;
+    let mockResponseService;
+    let mapper;
+    beforeEach(() => {
+        mockService = (0, ts_jest_mocker_1.mock)(dismissible_service_1.DismissibleService);
+        mockResponseService = (0, ts_jest_mocker_1.mock)(response_1.ResponseService, { failIfMockNotProvided: false });
+        mockResponseService.success.mockImplementation((data) => ({ data }));
+        mapper = new dismissible_item_mapper_1.DismissibleItemMapper();
+        controller = new get_or_create_controller_1.GetOrCreateController(mockService, mapper, mockResponseService);
+    });
+    describe('getOrCreate', () => {
+        it('should return item with created flag wrapped in data', async () => {
+            const item = (0, factories_1.createTestItem)({ id: 'test-item' });
+            const context = (0, factories_1.createTestContext)();
+            mockService.getOrCreate.mockResolvedValue({ item, created: true });
+            const result = await controller.getOrCreate('test-user-id', 'test-item', context, undefined);
+            expect(result.data.itemId).toBe('test-item');
+            expect(mockResponseService.success).toHaveBeenCalled();
+        });
+        it('should parse metadata from query params', async () => {
+            const item = (0, factories_1.createTestItem)({ id: 'test-item' });
+            const context = (0, factories_1.createTestContext)();
+            mockService.getOrCreate.mockResolvedValue({ item, created: true });
+            await controller.getOrCreate('test-user-id', 'test-item', context, [
+                'version:2',
+                'category:test',
+            ]);
+            expect(mockService.getOrCreate).toHaveBeenCalledWith('test-item', 'test-user-id', expect.objectContaining({
+                metadata: { version: 2, category: 'test' },
+            }), context);
+        });
+        it('should handle single metadata value', async () => {
+            const item = (0, factories_1.createTestItem)({ id: 'test-item' });
+            const context = (0, factories_1.createTestContext)();
+            mockService.getOrCreate.mockResolvedValue({ item, created: true });
+            await controller.getOrCreate('test-user-id', 'test-item', context, 'version:2');
+            expect(mockService.getOrCreate).toHaveBeenCalledWith('test-item', 'test-user-id', expect.objectContaining({
+                metadata: { version: 2 },
+            }), context);
+        });
+    });
+});
+//# sourceMappingURL=get-or-create.controller.spec.js.map

package/src/api/use-cases/get-or-create/get-or-create.controller.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-create.controller.spec.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/get-or-create/get-or-create.controller.spec.ts"],"names":[],"mappings":"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"}

package/src/api/use-cases/get-or-create/get-or-create.request.dto.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Query parameters for creating a dismissible item.
+ */
+export declare class CreateDismissibleItemQueryDto {
+    metadata?: Record<string, string | number>;
+}

package/src/api/use-cases/get-or-create/get-or-create.request.dto.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateDismissibleItemQueryDto = void 0;
+const tslib_1 = require("tslib");
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Query parameters for creating a dismissible item.
+ */
+class CreateDismissibleItemQueryDto {
+}
+exports.CreateDismissibleItemQueryDto = CreateDismissibleItemQueryDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Optional metadata to attach to the item',
+        example: { key: 'value' },
+        type: 'object',
+        additionalProperties: true,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    tslib_1.__metadata("design:type", Object)
+], CreateDismissibleItemQueryDto.prototype, "metadata", void 0);
+//# sourceMappingURL=get-or-create.request.dto.js.map

package/src/api/use-cases/get-or-create/get-or-create.request.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-create.request.dto.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/get-or-create/get-or-create.request.dto.ts"],"names":[],"mappings":";;;;AAAA,6CAAsD;AACtD,qDAAuD;AAEvD;;GAEG;AACH,MAAa,6BAA6B;CAUzC;AAVD,sEAUC;AADC;IARC,IAAA,6BAAmB,EAAC;QACnB,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;QACzB,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,IAAI;KAC3B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;+DACgC"}

package/src/api/use-cases/get-or-create/get-or-create.response.dto.d.ts

@@ -0,0 +1,12 @@
+import { DismissibleItemResponseDto } from '../../dismissible-item-response.dto';
+declare const GetOrCreateResponseDto_base: {
+    new (): {
+        data: DismissibleItemResponseDto;
+    };
+};
+/**
+ * Response DTO for the getOrCreate operation.
+ */
+export declare class GetOrCreateResponseDto extends GetOrCreateResponseDto_base {
+}
+export {};

package/src/api/use-cases/get-or-create/get-or-create.response.dto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOrCreateResponseDto = void 0;
+const success_response_dto_1 = require("../../../response/dtos/success-response.dto");
+const dismissible_item_response_dto_1 = require("../../dismissible-item-response.dto");
+/**
+ * Response DTO for the getOrCreate operation.
+ */
+class GetOrCreateResponseDto extends (0, success_response_dto_1.SuccessResponseDto)(dismissible_item_response_dto_1.DismissibleItemResponseDto) {
+}
+exports.GetOrCreateResponseDto = GetOrCreateResponseDto;
+//# sourceMappingURL=get-or-create.response.dto.js.map

package/src/api/use-cases/get-or-create/get-or-create.response.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-create.response.dto.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/get-or-create/get-or-create.response.dto.ts"],"names":[],"mappings":";;;AAAA,sFAAiF;AACjF,uFAAiF;AAEjF;;GAEG;AACH,MAAa,sBAAuB,SAAQ,IAAA,yCAAkB,EAAC,0DAA0B,CAAC;CAAG;AAA7F,wDAA6F"}

package/src/api/use-cases/get-or-create/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-or-create.request.dto';
+export * from './get-or-create.response.dto';
+export * from './get-or-create.controller';

package/src/api/use-cases/get-or-create/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./get-or-create.request.dto"), exports);
+tslib_1.__exportStar(require("./get-or-create.response.dto"), exports);
+tslib_1.__exportStar(require("./get-or-create.controller"), exports);
+//# sourceMappingURL=index.js.map

package/src/api/use-cases/get-or-create/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/get-or-create/index.ts"],"names":[],"mappings":";;;AAAA,sEAA4C;AAC5C,uEAA6C;AAC7C,qEAA2C"}

package/src/api/use-cases/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-or-create';
+export * from './dismiss';
+export * from './restore';

package/src/api/use-cases/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./get-or-create"), exports);
+tslib_1.__exportStar(require("./dismiss"), exports);
+tslib_1.__exportStar(require("./restore"), exports);
+//# sourceMappingURL=index.js.map

package/src/api/use-cases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/dismissible/src/api/use-cases/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,oDAA0B;AAC1B,oDAA0B"}

package/src/api/use-cases/restore/index.d.ts

@@ -0,0 +1,2 @@
+export * from './restore.response.dto';
+export * from './restore.controller';

package/src/api/use-cases/restore/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./restore.response.dto"), exports);
+tslib_1.__exportStar(require("./restore.controller"), exports);
+//# sourceMappingURL=index.js.map

package/src/api/use-cases/restore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/restore/index.ts"],"names":[],"mappings":";;;AAAA,iEAAuC;AACvC,+DAAqC"}

package/src/api/use-cases/restore/restore.controller.d.ts

@@ -0,0 +1,16 @@
+import { DismissibleService } from '../../../core/dismissible.service';
+import { DismissibleItemMapper } from '../../dismissible-item.mapper';
+import { IRequestContext } from '../../../request/request-context.interface';
+import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
+import { RestoreResponseDto } from './restore.response.dto';
+import { ResponseService } from '../../../response/response.service';
+/**
+ * Controller for restore dismissible item operations.
+ */
+export declare class RestoreController {
+    private readonly dismissibleService;
+    private readonly mapper;
+    private readonly responseService;
+    constructor(dismissibleService: DismissibleService<BaseMetadata>, mapper: DismissibleItemMapper, responseService: ResponseService);
+    restore(userId: string, itemId: string, context: IRequestContext): Promise<RestoreResponseDto>;
+}

package/src/api/use-cases/restore/restore.controller.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestoreController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const dismissible_service_1 = require("../../../core/dismissible.service");
+const dismissible_item_mapper_1 = require("../../dismissible-item.mapper");
+const request_context_decorator_1 = require("../../../request/request-context.decorator");
+const restore_response_dto_1 = require("./restore.response.dto");
+const response_service_1 = require("../../../response/response.service");
+const http_exception_filter_1 = require("../../../response/http-exception-filter");
+const api_tags_constants_1 = require("../api-tags.constants");
+/**
+ * Controller for restore dismissible item operations.
+ */
+let RestoreController = class RestoreController {
+    constructor(dismissibleService, mapper, responseService) {
+        this.dismissibleService = dismissibleService;
+        this.mapper = mapper;
+        this.responseService = responseService;
+    }
+    async restore(userId, itemId, context) {
+        const result = await this.dismissibleService.restore(itemId, userId, context);
+        return this.responseService.success(this.mapper.toResponseDto(result.item));
+    }
+};
+exports.RestoreController = RestoreController;
+tslib_1.__decorate([
+    (0, common_1.Post)(':itemId'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Restore a dismissed item',
+        description: 'Restores a previously dismissed item.',
+    }),
+    (0, swagger_1.ApiParam)({
+        name: 'userId',
+        description: 'User identifier',
+        example: 'user-123',
+    }),
+    (0, swagger_1.ApiParam)({
+        name: 'itemId',
+        description: 'Unique identifier for the dismissible item',
+        example: 'welcome-banner-v2',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'The restored item',
+        type: restore_response_dto_1.RestoreResponseDto,
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 400,
+        description: 'Item not found or not dismissed',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 403,
+        description: 'Operation blocked by lifecycle hook',
+    }),
+    (0, common_1.UseFilters)(http_exception_filter_1.HttpExceptionFilter),
+    tslib_1.__param(0, (0, common_1.Param)('userId')),
+    tslib_1.__param(1, (0, common_1.Param)('itemId')),
+    tslib_1.__param(2, (0, request_context_decorator_1.RequestContext)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RestoreController.prototype, "restore", null);
+exports.RestoreController = RestoreController = tslib_1.__decorate([
+    (0, swagger_1.ApiTags)(api_tags_constants_1.API_TAG_DISMISSIBLE),
+    (0, common_1.Controller)('v1/user/:userId/dismissible-item'),
+    tslib_1.__metadata("design:paramtypes", [dismissible_service_1.DismissibleService,
+        dismissible_item_mapper_1.DismissibleItemMapper,
+        response_service_1.ResponseService])
+], RestoreController);
+//# sourceMappingURL=restore.controller.js.map

package/src/api/use-cases/restore/restore.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.controller.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/restore/restore.controller.ts"],"names":[],"mappings":";;;;AAAA,2CAAqE;AACrE,6CAA+E;AAC/E,2EAAuE;AACvE,2EAAsE;AACtE,0FAA4E;AAG5E,iEAA4D;AAC5D,yEAAqE;AACrE,mFAA8E;AAC9E,8DAA4D;AAE5D;;GAEG;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,kBAAoD,EACpD,MAA6B,EAC7B,eAAgC;QAFhC,uBAAkB,GAAlB,kBAAkB,CAAkC;QACpD,WAAM,GAAN,MAAM,CAAuB;QAC7B,oBAAe,GAAf,eAAe,CAAiB;IAChD,CAAC;IA+BE,AAAN,KAAK,CAAC,OAAO,CACM,MAAc,EACd,MAAc,EACb,OAAwB;QAE1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAE9E,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;CACF,CAAA;AA7CY,8CAAiB;AAoCtB;IA7BL,IAAA,aAAI,EAAC,SAAS,CAAC;IACf,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,uCAAuC;KACrD,CAAC;IACD,IAAA,kBAAQ,EAAC;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,UAAU;KACpB,CAAC;IACD,IAAA,kBAAQ,EAAC;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,mBAAmB;KAC7B,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,yCAAkB;KACzB,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,iCAAiC;KAC/C,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,qCAAqC;KACnD,CAAC;IACD,IAAA,mBAAU,EAAC,2CAAmB,CAAC;IAE7B,mBAAA,IAAA,cAAK,EAAC,QAAQ,CAAC,CAAA;IACf,mBAAA,IAAA,cAAK,EAAC,QAAQ,CAAC,CAAA;IACf,mBAAA,IAAA,0CAAc,GAAE,CAAA;;;;gDAKlB;4BA5CU,iBAAiB;IAF7B,IAAA,iBAAO,EAAC,wCAAmB,CAAC;IAC5B,IAAA,mBAAU,EAAC,kCAAkC,CAAC;6CAGN,wCAAkB;QAC9B,+CAAqB;QACZ,kCAAe;GAJxC,iBAAiB,CA6C7B"}

package/src/api/use-cases/restore/restore.controller.spec.d.ts

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

package/src/api/use-cases/restore/restore.controller.spec.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts_jest_mocker_1 = require("ts-jest-mocker");
+const restore_controller_1 = require("./restore.controller");
+const dismissible_service_1 = require("../../../core/dismissible.service");
+const dismissible_item_mapper_1 = require("../../dismissible-item.mapper");
+const factories_1 = require("../../../testing/factories");
+const response_1 = require("../../../response");
+describe('RestoreController', () => {
+    let controller;
+    let mockService;
+    let mockResponseService;
+    let mapper;
+    beforeEach(() => {
+        mockService = (0, ts_jest_mocker_1.mock)(dismissible_service_1.DismissibleService);
+        mockResponseService = (0, ts_jest_mocker_1.mock)(response_1.ResponseService, { failIfMockNotProvided: false });
+        mockResponseService.success.mockImplementation((data) => ({ data }));
+        mapper = new dismissible_item_mapper_1.DismissibleItemMapper();
+        controller = new restore_controller_1.RestoreController(mockService, mapper, mockResponseService);
+    });
+    describe('restore', () => {
+        it('should return restored item wrapped in data', async () => {
+            const item = (0, factories_1.createTestItem)({ id: 'test-item' });
+            const previousItem = (0, factories_1.createTestItem)({
+                id: 'test-item',
+                dismissedAt: new Date(),
+            });
+            const context = (0, factories_1.createTestContext)();
+            mockService.restore.mockResolvedValue({ item, previousItem });
+            const result = await controller.restore('test-user-id', 'test-item', context);
+            expect(result.data.itemId).toBe('test-item');
+            expect(mockService.restore).toHaveBeenCalledWith('test-item', 'test-user-id', context);
+            expect(mockResponseService.success).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=restore.controller.spec.js.map

package/src/api/use-cases/restore/restore.controller.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.controller.spec.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/restore/restore.controller.spec.ts"],"names":[],"mappings":";;AAAA,mDAAsC;AACtC,6DAAyD;AACzD,2EAAuE;AACvE,2EAAsE;AAEtE,0DAA+E;AAC/E,gDAAoD;AAEpD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,UAA6B,CAAC;IAClC,IAAI,WAA0D,CAAC;IAC/D,IAAI,mBAAiD,CAAC;IACtD,IAAI,MAA6B,CAAC;IAElC,UAAU,CAAC,GAAG,EAAE;QACd,WAAW,GAAG,IAAA,qBAAI,EAAC,wCAAkB,CAAC,CAAC;QACvC,mBAAmB,GAAG,IAAA,qBAAI,EAAC,0BAAe,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,mBAAmB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,GAAG,IAAI,+CAAqB,EAAE,CAAC;QAErC,UAAU,GAAG,IAAI,sCAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,IAAI,GAAG,IAAA,0BAAc,EAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,IAAA,0BAAc,EAAC;gBAClC,EAAE,EAAE,WAAW;gBACf,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,6BAAiB,GAAE,CAAC;YAEpC,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAE9E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YACvF,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/api/use-cases/restore/restore.response.dto.d.ts

@@ -0,0 +1,12 @@
+import { DismissibleItemResponseDto } from '../../dismissible-item-response.dto';
+declare const RestoreResponseDto_base: {
+    new (): {
+        data: DismissibleItemResponseDto;
+    };
+};
+/**
+ * Response DTO for the restore operation.
+ */
+export declare class RestoreResponseDto extends RestoreResponseDto_base {
+}
+export {};

package/src/api/use-cases/restore/restore.response.dto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestoreResponseDto = void 0;
+const success_response_dto_1 = require("../../../response/dtos/success-response.dto");
+const dismissible_item_response_dto_1 = require("../../dismissible-item-response.dto");
+/**
+ * Response DTO for the restore operation.
+ */
+class RestoreResponseDto extends (0, success_response_dto_1.SuccessResponseDto)(dismissible_item_response_dto_1.DismissibleItemResponseDto) {
+}
+exports.RestoreResponseDto = RestoreResponseDto;
+//# sourceMappingURL=restore.response.dto.js.map

package/src/api/use-cases/restore/restore.response.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.response.dto.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/restore/restore.response.dto.ts"],"names":[],"mappings":";;;AAAA,sFAAiF;AACjF,uFAAiF;AAEjF;;GAEG;AACH,MAAa,kBAAmB,SAAQ,IAAA,yCAAkB,EAAC,0DAA0B,CAAC;CAAG;AAAzF,gDAAyF"}

package/src/core/create-options.d.ts

@@ -0,0 +1,8 @@
+import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
+/**
+ * Options for creating a new dismissible item.
+ */
+export interface ICreateItemOptions<TMetadata extends BaseMetadata = BaseMetadata> {
+    /** Optional metadata to attach to the item */
+    metadata?: TMetadata;
+}

package/src/core/create-options.js

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

package/src/core/create-options.js.map

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

package/src/core/dismissible-core.service.d.ts

@@ -0,0 +1,44 @@
+import { IDismissibleStorage } from '@dismissible/nestjs-storage';
+import { IGetOrCreateServiceResponse, IDismissServiceResponse, IRestoreServiceResponse } from './service-responses.interface';
+import { DismissibleHelper } from '../utils/dismissible.helper';
+import { DateService } from '../utils/date/date.service';
+import { IDismissibleLogger } from '@dismissible/nestjs-logger';
+import { ValidationService } from '@dismissible/nestjs-validation';
+import { BaseMetadata, DismissibleItemFactory } from '@dismissible/nestjs-dismissible-item';
+import { ICreateItemOptions } from './create-options';
+/**
+ * Core business logic service for dismissible operations.
+ * Handles pure CRUD operations without side effects (hooks, events).
+ */
+export declare class DismissibleCoreService<TMetadata extends BaseMetadata = BaseMetadata> {
+    private readonly storage;
+    private readonly dateService;
+    private readonly logger;
+    private readonly itemFactory;
+    private readonly validationService;
+    private readonly dismissibleHelper;
+    constructor(storage: IDismissibleStorage<TMetadata>, dateService: DateService, logger: IDismissibleLogger, itemFactory: DismissibleItemFactory, validationService: ValidationService, dismissibleHelper: DismissibleHelper);
+    /**
+     * Get an existing item or create a new one.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @param options Optional creation options (metadata)
+     */
+    getOrCreate(itemId: string, userId: string, options?: ICreateItemOptions<TMetadata>): Promise<IGetOrCreateServiceResponse<TMetadata>>;
+    /**
+     * Dismiss an item.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @throws ItemNotFoundException if item doesn't exist
+     * @throws ItemAlreadyDismissedException if item is already dismissed
+     */
+    dismiss(itemId: string, userId: string): Promise<IDismissServiceResponse<TMetadata>>;
+    /**
+     * Restore a dismissed item.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @throws ItemNotFoundException if item doesn't exist
+     * @throws ItemNotDismissedException if item is not dismissed
+     */
+    restore(itemId: string, userId: string): Promise<IRestoreServiceResponse<TMetadata>>;
+}

package/src/core/dismissible-core.service.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissibleCoreService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const nestjs_storage_1 = require("@dismissible/nestjs-storage");
+const dismissible_helper_1 = require("../utils/dismissible.helper");
+const date_service_1 = require("../utils/date/date.service");
+const nestjs_logger_1 = require("@dismissible/nestjs-logger");
+const exceptions_1 = require("../exceptions");
+const nestjs_validation_1 = require("@dismissible/nestjs-validation");
+const nestjs_dismissible_item_1 = require("@dismissible/nestjs-dismissible-item");
+/**
+ * Core business logic service for dismissible operations.
+ * Handles pure CRUD operations without side effects (hooks, events).
+ */
+let DismissibleCoreService = class DismissibleCoreService {
+    constructor(storage, dateService, logger, itemFactory, validationService, dismissibleHelper) {
+        this.storage = storage;
+        this.dateService = dateService;
+        this.logger = logger;
+        this.itemFactory = itemFactory;
+        this.validationService = validationService;
+        this.dismissibleHelper = dismissibleHelper;
+    }
+    /**
+     * Get an existing item or create a new one.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @param options Optional creation options (metadata)
+     */
+    async getOrCreate(itemId, userId, options) {
+        this.logger.debug(`Looking up item in storage`, { itemId, userId });
+        const existingItem = await this.storage.get(userId, itemId);
+        if (existingItem) {
+            this.logger.debug(`Found existing item`, { itemId, userId });
+            return {
+                item: existingItem,
+                created: false,
+            };
+        }
+        this.logger.debug(`Creating new item`, {
+            itemId,
+            userId,
+            hasMetadata: !!options?.metadata,
+        });
+        // Create new item
+        const now = this.dateService.getNow();
+        const newItem = this.itemFactory.create({
+            id: itemId,
+            createdAt: now,
+            userId,
+            metadata: options?.metadata,
+        });
+        // Validate the item before storage
+        await this.validationService.validateInstance(newItem);
+        const createdItem = await this.storage.create(newItem);
+        this.logger.info(`Created new dismissible item`, { itemId, userId });
+        return {
+            item: createdItem,
+            created: true,
+        };
+    }
+    /**
+     * Dismiss an item.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @throws ItemNotFoundException if item doesn't exist
+     * @throws ItemAlreadyDismissedException if item is already dismissed
+     */
+    async dismiss(itemId, userId) {
+        this.logger.debug(`Attempting to dismiss item`, { itemId, userId });
+        const existingItem = await this.storage.get(userId, itemId);
+        if (!existingItem) {
+            this.logger.warn(`Cannot dismiss: item not found`, { itemId, userId });
+            throw new exceptions_1.ItemNotFoundException(itemId);
+        }
+        if (this.dismissibleHelper.isDismissed(existingItem)) {
+            this.logger.warn(`Cannot dismiss: item already dismissed`, { itemId, userId });
+            throw new exceptions_1.ItemAlreadyDismissedException(itemId);
+        }
+        const previousItem = this.itemFactory.clone(existingItem);
+        const dismissedItem = this.itemFactory.createDismissed(existingItem, this.dateService.getNow());
+        // Validate the item before storage
+        await this.validationService.validateInstance(dismissedItem);
+        const updatedItem = await this.storage.update(dismissedItem);
+        this.logger.info(`Item dismissed`, { itemId, userId });
+        return {
+            item: updatedItem,
+            previousItem,
+        };
+    }
+    /**
+     * Restore a dismissed item.
+     * @param itemId The item identifier
+     * @param userId The user identifier (required)
+     * @throws ItemNotFoundException if item doesn't exist
+     * @throws ItemNotDismissedException if item is not dismissed
+     */
+    async restore(itemId, userId) {
+        this.logger.debug(`Attempting to restore item`, { itemId, userId });
+        const existingItem = await this.storage.get(userId, itemId);
+        if (!existingItem) {
+            this.logger.warn(`Cannot restore: item not found`, { itemId, userId });
+            throw new exceptions_1.ItemNotFoundException(itemId);
+        }
+        if (!this.dismissibleHelper.isDismissed(existingItem)) {
+            this.logger.warn(`Cannot restore: item not dismissed`, { itemId, userId });
+            throw new exceptions_1.ItemNotDismissedException(itemId);
+        }
+        const previousItem = this.itemFactory.clone(existingItem);
+        const restoredItem = this.itemFactory.createRestored(existingItem);
+        // Validate the item before storage
+        await this.validationService.validateInstance(restoredItem);
+        const updatedItem = await this.storage.update(restoredItem);
+        this.logger.info(`Item restored`, { itemId, userId });
+        return {
+            item: updatedItem,
+            previousItem,
+        };
+    }
+};
+exports.DismissibleCoreService = DismissibleCoreService;
+exports.DismissibleCoreService = DismissibleCoreService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(nestjs_storage_1.DISMISSIBLE_STORAGE_ADAPTER)),
+    tslib_1.__param(2, (0, common_1.Inject)(nestjs_logger_1.DISMISSIBLE_LOGGER)),
+    tslib_1.__metadata("design:paramtypes", [Object, date_service_1.DateService, Object, nestjs_dismissible_item_1.DismissibleItemFactory,
+        nestjs_validation_1.ValidationService,
+        dismissible_helper_1.DismissibleHelper])
+], DismissibleCoreService);
+//# sourceMappingURL=dismissible-core.service.js.map

package/src/core/dismissible-core.service.js.map

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

package/src/core/dismissible-core.service.spec.d.ts

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