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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@dismissible/nestjs-dismissible",
+  "version": "0.1.0-canary.4b708a5.0",
+  "description": "Dismissible state management library for NestJS applications",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.mjs",
+      "require": "./src/index.js",
+      "types": "./src/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@nestjs/event-emitter": "^3.0.0",
+    "uuid": "^11.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@dismissible/nestjs-dismissible-item": "^0.0.1",
+    "@dismissible/nestjs-storage": "^0.0.1",
+    "class-validator": "^0.14.0",
+    "class-transformer": "^0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": false
+    },
+    "@nestjs/core": {
+      "optional": false
+    },
+    "@nestjs/swagger": {
+      "optional": false
+    },
+    "dismissible/nestjs-dismissible-item": {
+      "optional": false
+    },
+    "@dismissible/nestjs-storage": {
+      "optional": false
+    },
+    "class-validator": {
+      "optional": false
+    },
+    "class-transformer": {
+      "optional": false
+    }
+  },
+  "keywords": [
+    "nestjs",
+    "dismissible",
+    "state-management",
+    "feature-flags",
+    "dismissals"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "type": "commonjs"
+}

package/src/api/dismissible-item-response.dto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Response DTO for a dismissible item.
+ */
+export declare class DismissibleItemResponseDto {
+    itemId: string;
+    userId: string;
+    createdAt: string;
+    dismissedAt?: string;
+    metadata?: Record<string, unknown>;
+}

package/src/api/dismissible-item-response.dto.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissibleItemResponseDto = void 0;
+const tslib_1 = require("tslib");
+const swagger_1 = require("@nestjs/swagger");
+/**
+ * Response DTO for a dismissible item.
+ */
+class DismissibleItemResponseDto {
+}
+exports.DismissibleItemResponseDto = DismissibleItemResponseDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Unique identifier for the item',
+        example: 'welcome-banner-v2',
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleItemResponseDto.prototype, "itemId", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'User identifier who created the item',
+        example: 'user-123',
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleItemResponseDto.prototype, "userId", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'When the item was created (ISO 8601)',
+        example: '2024-01-15T10:30:00.000Z',
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleItemResponseDto.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'When the item was dismissed (ISO 8601)',
+        example: '2024-01-15T12:00:00.000Z',
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleItemResponseDto.prototype, "dismissedAt", void 0);
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Optional metadata associated with the item',
+        example: { version: 2, category: 'promotional' },
+        type: 'object',
+        additionalProperties: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], DismissibleItemResponseDto.prototype, "metadata", void 0);
+//# sourceMappingURL=dismissible-item-response.dto.js.map

package/src/api/dismissible-item-response.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-item-response.dto.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/api/dismissible-item-response.dto.ts"],"names":[],"mappings":";;;;AAAA,6CAAmE;AAEnE;;GAEG;AACH,MAAa,0BAA0B;CAgCtC;AAhCD,gEAgCC;AA3BC;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,mBAAmB;KAC7B,CAAC;;0DACc;AAMhB;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,UAAU;KACpB,CAAC;;0DACc;AAMhB;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,0BAA0B;KACpC,CAAC;;6DACiB;AAMnB;IAJC,IAAA,6BAAmB,EAAC;QACnB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,0BAA0B;KACpC,CAAC;;+DACmB;AAQrB;IANC,IAAA,6BAAmB,EAAC;QACnB,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE;QAChD,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,IAAI;KAC3B,CAAC;;4DACiC"}

package/src/api/dismissible-item.mapper.d.ts

@@ -0,0 +1,12 @@
+import { BaseMetadata, DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
+import { DismissibleItemResponseDto } from './dismissible-item-response.dto';
+/**
+ * Mapper for converting domain objects to DTOs.
+ */
+export declare class DismissibleItemMapper {
+    /**
+     * Convert a dismissible item to a response DTO.
+     * Converts Date objects to ISO 8601 strings.
+     */
+    toResponseDto<TMetadata extends BaseMetadata>(item: DismissibleItemDto<TMetadata>): DismissibleItemResponseDto;
+}

package/src/api/dismissible-item.mapper.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissibleItemMapper = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const dismissible_item_response_dto_1 = require("./dismissible-item-response.dto");
+/**
+ * Mapper for converting domain objects to DTOs.
+ */
+let DismissibleItemMapper = class DismissibleItemMapper {
+    /**
+     * Convert a dismissible item to a response DTO.
+     * Converts Date objects to ISO 8601 strings.
+     */
+    toResponseDto(item) {
+        const dto = new dismissible_item_response_dto_1.DismissibleItemResponseDto();
+        dto.itemId = item.id;
+        dto.userId = item.userId;
+        dto.createdAt = item.createdAt.toISOString();
+        if (item.dismissedAt) {
+            dto.dismissedAt = item.dismissedAt.toISOString();
+        }
+        if (item.metadata) {
+            dto.metadata = item.metadata;
+        }
+        return dto;
+    }
+};
+exports.DismissibleItemMapper = DismissibleItemMapper;
+exports.DismissibleItemMapper = DismissibleItemMapper = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], DismissibleItemMapper);
+//# sourceMappingURL=dismissible-item.mapper.js.map

package/src/api/dismissible-item.mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-item.mapper.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/api/dismissible-item.mapper.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAE5C,mFAA6E;AAE7E;;GAEG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC;;;OAGG;IACH,aAAa,CACX,IAAmC;QAEnC,MAAM,GAAG,GAAG,IAAI,0DAA0B,EAAE,CAAC;QAE7C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACrB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAmC,CAAC;QAC1D,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAA;AAxBY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;GACA,qBAAqB,CAwBjC"}

package/src/api/dismissible-item.mapper.spec.d.ts

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

package/src/api/dismissible-item.mapper.spec.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const dismissible_item_mapper_1 = require("./dismissible-item.mapper");
+const factories_1 = require("../testing/factories");
+describe('DismissibleItemMapper', () => {
+    let mapper;
+    beforeEach(() => {
+        mapper = new dismissible_item_mapper_1.DismissibleItemMapper();
+    });
+    describe('toResponseDto', () => {
+        it('should convert basic item to DTO', () => {
+            const item = (0, factories_1.createTestItem)({
+                id: 'test-item',
+                userId: 'test-user-id',
+                createdAt: new Date('2024-01-15T10:00:00.000Z'),
+            });
+            const dto = mapper.toResponseDto(item);
+            expect(dto.itemId).toBe('test-item');
+            expect(dto.userId).toBe('test-user-id');
+            expect(dto.createdAt).toBe('2024-01-15T10:00:00.000Z');
+            expect(dto.dismissedAt).toBeUndefined();
+            expect(dto.metadata).toBeUndefined();
+        });
+        it('should convert dates to ISO strings', () => {
+            const item = (0, factories_1.createDismissedTestItem)({
+                id: 'test-item',
+                createdAt: new Date('2024-01-15T10:00:00.000Z'),
+                dismissedAt: new Date('2024-01-15T12:00:00.000Z'),
+            });
+            const dto = mapper.toResponseDto(item);
+            expect(dto.createdAt).toBe('2024-01-15T10:00:00.000Z');
+            expect(dto.dismissedAt).toBe('2024-01-15T12:00:00.000Z');
+        });
+        it('should include userId in DTO', () => {
+            const item = (0, factories_1.createTestItem)({
+                id: 'test-item',
+                userId: 'user-123',
+            });
+            const dto = mapper.toResponseDto(item);
+            expect(dto.userId).toBe('user-123');
+        });
+        it('should include metadata when present', () => {
+            const item = (0, factories_1.createTestItem)({
+                id: 'test-item',
+                metadata: { version: 2, category: 'test' },
+            });
+            const dto = mapper.toResponseDto(item);
+            expect(dto.metadata).toEqual({ version: 2, category: 'test' });
+        });
+    });
+});
+//# sourceMappingURL=dismissible-item.mapper.spec.js.map

package/src/api/dismissible-item.mapper.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-item.mapper.spec.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/api/dismissible-item.mapper.spec.ts"],"names":[],"mappings":";;AAAA,uEAAkE;AAClE,oDAA+E;AAE/E,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,IAAI,MAA6B,CAAC;IAElC,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAI,+CAAqB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,IAAI,GAAG,IAAA,0BAAc,EAAC;gBAC1B,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,cAAc;gBACtB,SAAS,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;aAChD,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,IAAI,GAAG,IAAA,mCAAuB,EAAC;gBACnC,EAAE,EAAE,WAAW;gBACf,SAAS,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;gBAC/C,WAAW,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;aAClD,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,IAAI,GAAG,IAAA,0BAAc,EAAC;gBAC1B,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,IAAI,GAAG,IAAA,0BAAc,EAAC;gBAC1B,EAAE,EAAE,WAAW;gBACf,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE;aAC3C,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/api/index.d.ts

@@ -0,0 +1,4 @@
+export * from './use-cases';
+export * from '../request/request-context.decorator';
+export * from './dismissible-item.mapper';
+export * from './dismissible-item-response.dto';

package/src/api/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Use cases
+tslib_1.__exportStar(require("./use-cases"), exports);
+// Cross-cutting
+tslib_1.__exportStar(require("../request/request-context.decorator"), exports);
+tslib_1.__exportStar(require("./dismissible-item.mapper"), exports);
+tslib_1.__exportStar(require("./dismissible-item-response.dto"), exports);
+//# sourceMappingURL=index.js.map

package/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/api/index.ts"],"names":[],"mappings":";;;AAAA,YAAY;AACZ,sDAA4B;AAE5B,gBAAgB;AAChB,+EAAqD;AACrD,oEAA0C;AAC1C,0EAAgD"}

package/src/api/use-cases/api-tags.constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * API tag constants for Swagger/OpenAPI documentation.
+ */
+export declare const API_TAG_DISMISSIBLE = "Dismissible";

package/src/api/use-cases/api-tags.constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_TAG_DISMISSIBLE = void 0;
+/**
+ * API tag constants for Swagger/OpenAPI documentation.
+ */
+exports.API_TAG_DISMISSIBLE = 'Dismissible';
+//# sourceMappingURL=api-tags.constants.js.map

package/src/api/use-cases/api-tags.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-tags.constants.js","sourceRoot":"","sources":["../../../../../../libs/dismissible/src/api/use-cases/api-tags.constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,mBAAmB,GAAG,aAAa,CAAC"}

package/src/api/use-cases/dismiss/dismiss.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 { DismissResponseDto } from './dismiss.response.dto';
+import { ResponseService } from '../../../response/response.service';
+/**
+ * Controller for dismiss dismissible item operations.
+ */
+export declare class DismissController {
+    private readonly dismissibleService;
+    private readonly mapper;
+    private readonly responseService;
+    constructor(dismissibleService: DismissibleService<BaseMetadata>, mapper: DismissibleItemMapper, responseService: ResponseService);
+    dismiss(userId: string, itemId: string, context: IRequestContext): Promise<DismissResponseDto>;
+}

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissController = 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 dismiss_response_dto_1 = require("./dismiss.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 dismiss dismissible item operations.
+ */
+let DismissController = class DismissController {
+    constructor(dismissibleService, mapper, responseService) {
+        this.dismissibleService = dismissibleService;
+        this.mapper = mapper;
+        this.responseService = responseService;
+    }
+    async dismiss(userId, itemId, context) {
+        const result = await this.dismissibleService.dismiss(itemId, userId, context);
+        return this.responseService.success(this.mapper.toResponseDto(result.item));
+    }
+};
+exports.DismissController = DismissController;
+tslib_1.__decorate([
+    (0, common_1.Delete)(':itemId'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Dismiss an item',
+        description: 'Marks a dismissible item as dismissed.',
+    }),
+    (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 dismissed item',
+        type: dismiss_response_dto_1.DismissResponseDto,
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 400,
+        description: 'Item not found or already 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)
+], DismissController.prototype, "dismiss", null);
+exports.DismissController = DismissController = 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])
+], DismissController);
+//# sourceMappingURL=dismiss.controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.controller.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/dismiss/dismiss.controller.ts"],"names":[],"mappings":";;;;AAAA,2CAAuE;AACvE,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,eAAM,EAAC,SAAS,CAAC;IACjB,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,wCAAwC;KACtD,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,oBAAoB;QACjC,IAAI,EAAE,yCAAkB;KACzB,CAAC;IACD,IAAA,qBAAW,EAAC;QACX,MAAM,EAAE,GAAG;QACX,WAAW,EAAE,qCAAqC;KACnD,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/dismiss/dismiss.controller.spec.d.ts

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

package/src/api/use-cases/dismiss/dismiss.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 dismiss_controller_1 = require("./dismiss.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('DismissController', () => {
+    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 dismiss_controller_1.DismissController(mockService, mapper, mockResponseService);
+    });
+    describe('dismiss', () => {
+        it('should return dismissed item wrapped in data', async () => {
+            const item = (0, factories_1.createTestItem)({
+                id: 'test-item',
+                dismissedAt: new Date(),
+            });
+            const previousItem = (0, factories_1.createTestItem)({ id: 'test-item' });
+            const context = (0, factories_1.createTestContext)();
+            mockService.dismiss.mockResolvedValue({ item, previousItem });
+            const result = await controller.dismiss('test-user-id', 'test-item', context);
+            expect(result.data.itemId).toBe('test-item');
+            expect(mockService.dismiss).toHaveBeenCalledWith('test-item', 'test-user-id', context);
+            expect(mockResponseService.success).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=dismiss.controller.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.controller.spec.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/dismiss/dismiss.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,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,IAAI,GAAG,IAAA,0BAAc,EAAC;gBAC1B,EAAE,EAAE,WAAW;gBACf,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,IAAA,0BAAc,EAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACzD,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/dismiss/dismiss.response.dto.d.ts

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

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissResponseDto = 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 dismiss operation.
+ */
+class DismissResponseDto extends (0, success_response_dto_1.SuccessResponseDto)(dismissible_item_response_dto_1.DismissibleItemResponseDto) {
+}
+exports.DismissResponseDto = DismissResponseDto;
+//# sourceMappingURL=dismiss.response.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.response.dto.js","sourceRoot":"","sources":["../../../../../../../libs/dismissible/src/api/use-cases/dismiss/dismiss.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/api/use-cases/dismiss/index.d.ts

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

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

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

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

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

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

@@ -0,0 +1,21 @@
+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 { GetOrCreateResponseDto } from './get-or-create.response.dto';
+import { ResponseService } from '../../../response/response.service';
+/**
+ * Controller for get-or-create dismissible item operations.
+ */
+export declare class GetOrCreateController {
+    private readonly dismissibleService;
+    private readonly mapper;
+    private readonly responseService;
+    constructor(dismissibleService: DismissibleService<BaseMetadata>, mapper: DismissibleItemMapper, responseService: ResponseService);
+    getOrCreate(userId: string, itemId: string, context: IRequestContext, metadataRaw?: string | string[]): Promise<GetOrCreateResponseDto>;
+    /**
+     * Parse metadata from query parameter format.
+     * Supports: `?metadata=key1:value1&metadata=key2:value2`
+     */
+    private parseMetadata;
+}

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

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOrCreateController = 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 get_or_create_response_dto_1 = require("./get-or-create.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 get-or-create dismissible item operations.
+ */
+let GetOrCreateController = class GetOrCreateController {
+    constructor(dismissibleService, mapper, responseService) {
+        this.dismissibleService = dismissibleService;
+        this.mapper = mapper;
+        this.responseService = responseService;
+    }
+    async getOrCreate(userId, itemId, context, metadataRaw) {
+        // Parse metadata from query params
+        const metadata = this.parseMetadata(metadataRaw);
+        const result = await this.dismissibleService.getOrCreate(itemId, userId, {
+            metadata: metadata,
+        }, context);
+        return this.responseService.success(this.mapper.toResponseDto(result.item));
+    }
+    /**
+     * Parse metadata from query parameter format.
+     * Supports: `?metadata=key1:value1&metadata=key2:value2`
+     */
+    parseMetadata(raw) {
+        if (!raw) {
+            return undefined;
+        }
+        const items = Array.isArray(raw) ? raw : [raw];
+        const metadata = {};
+        for (const item of items) {
+            const colonIndex = item.indexOf(':');
+            if (colonIndex > 0) {
+                const key = item.substring(0, colonIndex);
+                const value = item.substring(colonIndex + 1);
+                // Try to parse as number if possible
+                const numValue = Number(value);
+                metadata[key] = isNaN(numValue) ? value : numValue;
+            }
+        }
+        return Object.keys(metadata).length > 0 ? metadata : undefined;
+    }
+};
+exports.GetOrCreateController = GetOrCreateController;
+tslib_1.__decorate([
+    (0, common_1.Get)(':itemId'),
+    (0, swagger_1.ApiOperation)({
+        summary: 'Get or create a dismissible item',
+        description: 'Retrieves an existing dismissible item by ID, or creates a new one if it does not exist.',
+    }),
+    (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.ApiQuery)({
+        name: 'metadata',
+        description: 'Optional metadata as key:value pairs (can be repeated)',
+        required: false,
+        isArray: true,
+        type: String,
+        example: 'version:2',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'The dismissible item (retrieved or created)',
+        type: get_or_create_response_dto_1.GetOrCreateResponseDto,
+    }),
+    (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.__param(3, (0, common_1.Query)('metadata')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], GetOrCreateController.prototype, "getOrCreate", null);
+exports.GetOrCreateController = GetOrCreateController = 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])
+], GetOrCreateController);
+//# sourceMappingURL=get-or-create.controller.js.map

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

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

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

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