@dismissible/nestjs-dismissible 0.0.2-canary.8976e84.0 → 0.0.2-canary.a611bd3.0

package/README.md

@@ -6,14 +6,16 @@ A powerful NestJS library for managing dismissible state in your applications. P
 
 ## Features
 
-- 🚀 **Simple API** - Easy-to-use service methods for get-or-create, dismiss, and restore operations
-- 💾 **Flexible Storage** - Default in-memory storage with support for custom storage adapters (PostgreSQL, Redis, etc.)
-- 🔌 **Lifecycle Hooks** - Intercept and customize operations with pre/post hooks
-- 📡 **Event-Driven** - Built-in event emission for all operations
-- 🎯 **Type-Safe** - Full TypeScript support with generic metadata types
-- 🛡️ **Validation** - Automatic validation of dismissible items
-- 📝 **Swagger Integration** - Auto-generated API documentation
-- ⚛️ **React Client** - Works out of the box with [@dismissible/react-client](https://www.npmjs.com/package/@dismissible/react-client)
+- **Simple API** - Easy-to-use service methods for get-or-create, dismiss, and restore operations
+- **High Performance** - Built on Fastify for maximum throughput
+- **Flexible Storage** - Default in-memory storage with support for custom storage adapters (PostgreSQL, Redis, etc.)
+- **Lifecycle Hooks** - Intercept and customize operations with pre/post hooks
+- **JWT Authentication** - Optional JWT auth hook for securing endpoints with OIDC providers
+- **Event-Driven** - Built-in event emission for all operations
+- **Type-Safe** - Full TypeScript support
+- **Validation** - Automatic validation of dismissible items
+- **Swagger Integration** - Auto-generated API documentation
+- **React Client** - Works out of the box with [@dismissible/react-client](https://www.npmjs.com/package/@dismissible/react-client)
 
 ## Installation
 
@@ -41,21 +43,21 @@ export class AppModule {}
 
 The module automatically registers REST endpoints for all operations:
 
-- `GET /v1/user/:userId/dismissible-item/:itemId` - Get or create an item
-- `DELETE /v1/user/:userId/dismissible-item/:itemId` - Dismiss an item
-- `POST /v1/user/:userId/dismissible-item/:itemId` - Restore a dismissed item
+- `GET /v1/users/:userId/items/:itemId` - Get or create an item
+- `DELETE /v1/users/:userId/items/:itemId` - Dismiss an item
+- `POST /v1/users/:userId/items/:itemId` - Restore a dismissed item
 
 Example request:
 
 ```bash
 # Get or create an item
-curl http://localhost:3000/v1/user/user-123/dismissible-item/welcome-banner?metadata=version:2&metadata=category:onboarding
+curl http://localhost:3000/v1/users/user-123/items/welcome-banner
 
 # Dismiss an item
-curl -X DELETE http://localhost:3000/v1/user/user-123/dismissible-item/welcome-banner
+curl -X DELETE http://localhost:3000/v1/users/user-123/items/welcome-banner
 
 # Restore a dismissed item
-curl -X POST http://localhost:3000/v1/user/user-123/dismissible-item/welcome-banner
+curl -X POST http://localhost:3000/v1/users/user-123/items/welcome-banner
 ```
 
 ### React Client Integration
@@ -156,9 +158,6 @@ export class FeaturesController {
     const result = await this.dismissibleService.getOrCreate(
       itemId,
       userId,
-      {
-        metadata: { version: '1.0', category: 'onboarding' },
-      },
       undefined, // optional request context
     );
 
@@ -182,6 +181,33 @@ export class FeaturesController {
 }
 ```
 
+### JWT Authentication
+
+Secure your API endpoints using the JWT Auth Hook with any OIDC-compliant identity provider:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { DismissibleModule } from '@dismissible/nestjs-dismissible';
+import { JwtAuthHookModule, JwtAuthHook } from '@dismissible/nestjs-jwt-auth-hook';
+
+@Module({
+  imports: [
+    JwtAuthHookModule.forRoot({
+      enabled: true,
+      wellKnownUrl: 'https://auth.example.com/.well-known/openid-configuration',
+      issuer: 'https://auth.example.com',
+      audience: 'my-api',
+    }),
+    DismissibleModule.forRoot({
+      hooks: [JwtAuthHook],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+See the [@dismissible/nestjs-jwt-auth-hook](https://www.npmjs.com/package/@dismissible/nestjs-jwt-auth-hook) package for detailed configuration options.
+
 ### Custom Lifecycle Hooks
 
 Lifecycle hooks allow you to intercept operations and add custom logic, validation, or mutations:
@@ -189,10 +215,8 @@ Lifecycle hooks allow you to intercept operations and add custom logic, validati
 ```typescript
 import { Injectable } from '@nestjs/common';
 import { IDismissibleLifecycleHook, IHookResult } from '@dismissible/nestjs-dismissible';
-import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
-
 @Injectable()
-export class AuditHook implements IDismissibleLifecycleHook<BaseMetadata> {
+export class AuditHook implements IDismissibleLifecycleHook {
   // Lower priority runs first (default is 0)
   readonly priority = 10;
 
@@ -215,7 +239,7 @@ export class AuditHook implements IDismissibleLifecycleHook<BaseMetadata> {
 
   async onAfterCreate(
     itemId: string,
-    item: DismissibleItemDto<BaseMetadata>,
+    item: DismissibleItemDto,
     userId: string,
     context?: IRequestContext,
   ): Promise<void> {
@@ -293,42 +317,6 @@ export class AnalyticsService {
 }
 ```
 
-### Custom Metadata Types
-
-Define custom metadata types for type-safe item properties:
-
-```typescript
-import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
-
-interface OnboardingMetadata extends BaseMetadata {
-  step: number;
-  completedAt?: string;
-  skipped: boolean;
-}
-
-// Use in your service
-@Injectable()
-export class OnboardingService {
-  constructor(private readonly dismissibleService: DismissibleService<OnboardingMetadata>) {}
-
-  async trackStep(userId: string, step: number) {
-    const result = await this.dismissibleService.getOrCreate(
-      `onboarding-step-${step}`,
-      userId,
-      {
-        metadata: {
-          step,
-          skipped: false,
-        },
-      },
-      undefined,
-    );
-
-    return result.item;
-  }
-}
-```
-
 ### Custom Logger
 
 Provide a custom logger implementation:
@@ -376,17 +364,15 @@ The main service for interacting with dismissible items.
 
 #### Methods
 
-**`getOrCreate(itemId, userId, options?, context?)`**
+**`getOrCreate(itemId, userId, context?)`**
 
 Retrieves an existing item or creates a new one if it doesn't exist.
 
 - `itemId: string` - Unique identifier for the item
 - `userId: string` - User identifier (required)
-- `options?: ICreateItemOptions<TMetadata>` - Optional creation options
-  - `metadata?: TMetadata` - Custom metadata to attach to the item
 - `context?: IRequestContext` - Optional request context for tracing
 
-Returns: `Promise<IGetOrCreateServiceResponse<TMetadata>>`
+Returns: `Promise<IGetOrCreateServiceResponse>`
 
 **`dismiss(itemId, userId, context?)`**
 
@@ -396,7 +382,7 @@ Marks an item as dismissed.
 - `userId: string` - User identifier
 - `context?: IRequestContext` - Optional request context
 
-Returns: `Promise<IDismissServiceResponse<TMetadata>>`
+Returns: `Promise<IDismissServiceResponse>`
 
 **`restore(itemId, userId, context?)`**
 
@@ -406,12 +392,12 @@ Restores a previously dismissed item.
 - `userId: string` - User identifier
 - `context?: IRequestContext` - Optional request context
 
-Returns: `Promise<IRestoreServiceResponse<TMetadata>>`
+Returns: `Promise<IRestoreServiceResponse>`
 
 ### Module Configuration
 
 ```typescript
-interface IDismissibleModuleOptions<TMetadata extends BaseMetadata> {
+interface IDismissibleModuleOptions {
   // Custom storage module (defaults to in-memory storage)
   storage?: DynamicModule | Type<any>;
 
@@ -419,7 +405,7 @@ interface IDismissibleModuleOptions<TMetadata extends BaseMetadata> {
   logger?: Type<IDismissibleLogger>;
 
   // Lifecycle hooks to register
-  hooks?: Type<IDismissibleLifecycleHook<TMetadata>>[];
+  hooks?: Type<IDismissibleLifecycleHook>[];
 }
 ```
 
@@ -435,13 +421,13 @@ The library emits the following events:
 All events include:
 
 - `id: string` - The item identifier
-- `item: DismissibleItemDto<TMetadata>` - The current item state
+- `item: DismissibleItemDto` - The current item state
 - `userId: string` - The user identifier
 - `context?: IRequestContext` - Optional request context
 
 Dismiss and restore events also include:
 
-- `previousItem: DismissibleItemDto<TMetadata>` - The item state before the operation
+- `previousItem: DismissibleItemDto` - The item state before the operation
 
 ## Lifecycle Hooks
 
@@ -481,21 +467,19 @@ Implement the `IDismissibleStorage` interface to create a custom storage adapter
 ```typescript
 import { Injectable } from '@nestjs/common';
 import { IDismissibleStorage } from '@dismissible/nestjs-storage';
-import { DismissibleItemDto, BaseMetadata } from '@dismissible/nestjs-dismissible-item';
+import { DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
 
 @Injectable()
-export class RedisStorageAdapter<
-  TMetadata extends BaseMetadata,
-> implements IDismissibleStorage<TMetadata> {
-  async get(userId: string, itemId: string): Promise<DismissibleItemDto<TMetadata> | null> {
+export class RedisStorageAdapter implements IDismissibleStorage {
+  async get(userId: string, itemId: string): Promise<DismissibleItemDto | null> {
     // Your implementation
   }
 
-  async create(userId: string, item: DismissibleItemDto<TMetadata>): Promise<void> {
+  async create(userId: string, item: DismissibleItemDto): Promise<void> {
     // Your implementation
   }
 
-  async update(userId: string, item: DismissibleItemDto<TMetadata>): Promise<void> {
+  async update(userId: string, item: DismissibleItemDto): Promise<void> {
     // Your implementation
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dismissible/nestjs-dismissible",
-  "version": "0.0.2-canary.8976e84.0",
+  "version": "0.0.2-canary.a611bd3.0",
   "description": "Dismissible state management library for NestJS applications",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -11,18 +11,25 @@
       "types": "./src/index.d.ts"
     }
   },
+  "files": [
+    "src",
+    "README.md"
+  ],
   "dependencies": {
-    "@nestjs/event-emitter": "^3.0.0",
-    "uuid": "^11.0.0"
+    "@nestjs/event-emitter": "3.0.1",
+    "@dismissible/nestjs-dismissible-hooks": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-dismissible-item": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-dismissible-request": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-storage": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-logger": "0.0.2-canary.a611bd3.0",
+    "@dismissible/nestjs-validation": "0.0.2-canary.a611bd3.0"
   },
   "peerDependencies": {
-    "@nestjs/common": "^11.0.0",
-    "@nestjs/core": "^11.0.0",
-    "@nestjs/swagger": "^11.0.0",
-    "@dismissible/nestjs-dismissible-item": "^0.0.2-canary.8976e84.0",
-    "@dismissible/nestjs-storage": "^0.0.2-canary.8976e84.0",
-    "class-validator": "^0.14.0",
-    "class-transformer": "^0.5.0"
+    "@nestjs/common": "10.0.0 || ^11.0.0",
+    "@nestjs/core": "10.0.0 || ^11.0.0",
+    "@nestjs/swagger": "10.0.0 || ^11.0.0",
+    "class-validator": "0.14.0",
+    "class-transformer": "0.5.0"
   },
   "peerDependenciesMeta": {
     "@nestjs/common": {
@@ -34,12 +41,6 @@
     "@nestjs/swagger": {
       "optional": false
     },
-    "dismissible/nestjs-dismissible-item": {
-      "optional": false
-    },
-    "@dismissible/nestjs-storage": {
-      "optional": false
-    },
     "class-validator": {
       "optional": false
     },
@@ -62,5 +63,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "type": "commonjs"
 }

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

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

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

@@ -0,0 +1,40 @@
+"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);
+//# 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;CAwBtC;AAxBD,gEAwBC;AAnBC;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"}

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

@@ -0,0 +1,12 @@
+import { 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(item: DismissibleItemDto): DismissibleItemResponseDto;
+}

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

@@ -0,0 +1,30 @@
+"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();
+        }
+        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,CAAC,IAAwB;QACpC,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,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAA;AAlBY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;GACA,qBAAqB,CAkBjC"}

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

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

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

@@ -0,0 +1,43 @@
+"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();
+        });
+        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');
+        });
+    });
+});
+//# 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;QAC1C,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;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/api/{index.ts → index.d.ts}

@@ -1,7 +1,4 @@
-// Use cases
 export * from './use-cases';
-
-// Cross-cutting
-export * from '../request/request-context.decorator';
+export * from './validation';
 export * from './dismissible-item.mapper';
 export * from './dismissible-item-response.dto';

package/src/api/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./use-cases"), exports);
+tslib_1.__exportStar(require("./validation"), 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,sDAA4B;AAE5B,uDAA6B;AAE7B,oEAA0C;AAC1C,0EAAgD"}

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

@@ -1,4 +1,4 @@
 /**
  * API tag constants for Swagger/OpenAPI documentation.
  */
-export const API_TAG_DISMISSIBLE = 'Dismissible';
+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,15 @@
+import { DismissibleService } from '../../../core/dismissible.service';
+import { DismissibleItemMapper } from '../../dismissible-item.mapper';
+import { IRequestContext } from '@dismissible/nestjs-dismissible-request';
+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, 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,74 @@
+"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 nestjs_dismissible_request_1 = require("@dismissible/nestjs-dismissible-request");
+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");
+const validation_1 = require("../../validation");
+/**
+ * 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 (max length: 32 characters)',
+        example: 'user-123',
+    }),
+    (0, swagger_1.ApiParam)({
+        name: 'itemId',
+        description: 'Unique identifier for the dismissible item (max length: 32 characters)',
+        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, validation_1.UserId)()),
+    tslib_1.__param(1, (0, validation_1.ItemId)()),
+    tslib_1.__param(2, (0, nestjs_dismissible_request_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/users/:userId/items'),
+    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,2CAAgE;AAChE,6CAA+E;AAC/E,2EAAuE;AACvE,2EAAsE;AACtE,wFAA0F;AAC1F,iEAA4D;AAC5D,yEAAqE;AACrE,mFAA8E;AAC9E,8DAA4D;AAC5D,iDAAkD;AAElD;;GAEG;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,kBAAsC,EACtC,MAA6B,EAC7B,eAAgC;QAFhC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,WAAM,GAAN,MAAM,CAAuB;QAC7B,oBAAe,GAAf,eAAe,CAAiB;IAChD,CAAC;IA+BE,AAAN,KAAK,CAAC,OAAO,CACD,MAAc,EACd,MAAc,EACN,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,6CAA6C;QAC1D,OAAO,EAAE,UAAU;KACpB,CAAC;IACD,IAAA,kBAAQ,EAAC;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wEAAwE;QACrF,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,mBAAM,GAAE,CAAA;IACR,mBAAA,IAAA,mBAAM,GAAE,CAAA;IACR,mBAAA,IAAA,2CAAc,GAAE,CAAA;;;;gDAKlB;4BA5CU,iBAAiB;IAF7B,IAAA,iBAAO,EAAC,wCAAmB,CAAC;IAC5B,IAAA,mBAAU,EAAC,wBAAwB,CAAC;6CAGI,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