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

package/src/validation/dismissible-input.dto.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DismissibleInputDto = exports.VALIDATION_CONSTANTS = void 0;
+const tslib_1 = require("tslib");
+const class_validator_1 = require("class-validator");
+/**
+ * Validation constants for dismissible input fields.
+ */
+exports.VALIDATION_CONSTANTS = {
+    /** Maximum length for userId and itemId */
+    ID_MAX_LENGTH: 64,
+    /** Minimum length for userId and itemId */
+    ID_MIN_LENGTH: 1,
+    /** Pattern for valid userId and itemId (alphanumeric, dash, underscore) */
+    ID_PATTERN: /^[a-zA-Z0-9_-]+$/,
+    /** Human-readable description of the ID pattern */
+    ID_PATTERN_MESSAGE: 'must contain only alphanumeric characters, dashes, and underscores',
+};
+/**
+ * DTO for validating dismissible input parameters (userId and itemId).
+ * Used at both controller and service layers for defense in depth.
+ */
+class DismissibleInputDto {
+}
+exports.DismissibleInputDto = DismissibleInputDto;
+tslib_1.__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'itemId is required' }),
+    (0, class_validator_1.MinLength)(exports.VALIDATION_CONSTANTS.ID_MIN_LENGTH, {
+        message: `itemId must be at least ${exports.VALIDATION_CONSTANTS.ID_MIN_LENGTH} character`,
+    }),
+    (0, class_validator_1.MaxLength)(exports.VALIDATION_CONSTANTS.ID_MAX_LENGTH, {
+        message: `itemId must be at most ${exports.VALIDATION_CONSTANTS.ID_MAX_LENGTH} characters`,
+    }),
+    (0, class_validator_1.Matches)(exports.VALIDATION_CONSTANTS.ID_PATTERN, {
+        message: `itemId ${exports.VALIDATION_CONSTANTS.ID_PATTERN_MESSAGE}`,
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleInputDto.prototype, "itemId", void 0);
+tslib_1.__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'userId is required' }),
+    (0, class_validator_1.MinLength)(exports.VALIDATION_CONSTANTS.ID_MIN_LENGTH, {
+        message: `userId must be at least ${exports.VALIDATION_CONSTANTS.ID_MIN_LENGTH} character`,
+    }),
+    (0, class_validator_1.MaxLength)(exports.VALIDATION_CONSTANTS.ID_MAX_LENGTH, {
+        message: `userId must be at most ${exports.VALIDATION_CONSTANTS.ID_MAX_LENGTH} characters`,
+    }),
+    (0, class_validator_1.Matches)(exports.VALIDATION_CONSTANTS.ID_PATTERN, {
+        message: `userId ${exports.VALIDATION_CONSTANTS.ID_PATTERN_MESSAGE}`,
+    }),
+    tslib_1.__metadata("design:type", String)
+], DismissibleInputDto.prototype, "userId", void 0);
+//# sourceMappingURL=dismissible-input.dto.js.map

package/src/validation/dismissible-input.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-input.dto.js","sourceRoot":"","sources":["../../../../../libs/dismissible/src/validation/dismissible-input.dto.ts"],"names":[],"mappings":";;;;AAAA,qDAAsF;AAEtF;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,2CAA2C;IAC3C,aAAa,EAAE,EAAE;IACjB,2CAA2C;IAC3C,aAAa,EAAE,CAAC;IAChB,2EAA2E;IAC3E,UAAU,EAAE,kBAAkB;IAC9B,mDAAmD;IACnD,kBAAkB,EAAE,oEAAoE;CAChF,CAAC;AAEX;;;GAGG;AACH,MAAa,mBAAmB;CA0B/B;AA1BD,kDA0BC;AAdC;IAXC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,EAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC7C,IAAA,2BAAS,EAAC,4BAAoB,CAAC,aAAa,EAAE;QAC7C,OAAO,EAAE,2BAA2B,4BAAoB,CAAC,aAAa,YAAY;KACnF,CAAC;IACD,IAAA,2BAAS,EAAC,4BAAoB,CAAC,aAAa,EAAE;QAC7C,OAAO,EAAE,0BAA0B,4BAAoB,CAAC,aAAa,aAAa;KACnF,CAAC;IACD,IAAA,yBAAO,EAAC,4BAAoB,CAAC,UAAU,EAAE;QACxC,OAAO,EAAE,UAAU,4BAAoB,CAAC,kBAAkB,EAAE;KAC7D,CAAC;;mDACa;AAaf;IAXC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,EAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC7C,IAAA,2BAAS,EAAC,4BAAoB,CAAC,aAAa,EAAE;QAC7C,OAAO,EAAE,2BAA2B,4BAAoB,CAAC,aAAa,YAAY;KACnF,CAAC;IACD,IAAA,2BAAS,EAAC,4BAAoB,CAAC,aAAa,EAAE;QAC7C,OAAO,EAAE,0BAA0B,4BAAoB,CAAC,aAAa,aAAa;KACnF,CAAC;IACD,IAAA,yBAAO,EAAC,4BAAoB,CAAC,UAAU,EAAE;QACxC,OAAO,EAAE,UAAU,4BAAoB,CAAC,kBAAkB,EAAE;KAC7D,CAAC;;mDACa"}

package/src/validation/index.d.ts

@@ -0,0 +1 @@
+export * from './dismissible-input.dto';

package/src/validation/index.js

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

package/src/validation/index.js.map

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

package/jest.config.ts

@@ -1,29 +0,0 @@
-export default {
-  displayName: 'dismissible',
-  preset: '../../jest.preset.js',
-  testEnvironment: 'node',
-  transform: {
-    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.json' }],
-  },
-  moduleFileExtensions: ['ts', 'js', 'html'],
-  coverageDirectory: '../../coverage/libs/dismissible',
-  transformIgnorePatterns: ['node_modules/(?!(uuid)/)'],
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.spec.ts',
-    '!src/**/*.interface.ts',
-    '!src/**/*.dto.ts',
-    '!src/**/*.enum.ts',
-    '!src/**/index.ts',
-    '!src/**/*.module.ts',
-  ],
-  coverageReporters: ['text', 'text-summary', 'html'],
-  coverageThreshold: {
-    global: {
-      branches: 81,
-      functions: 84,
-      lines: 92,
-      statements: 92,
-    },
-  },
-};

package/project.json

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

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

@@ -1,38 +0,0 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-
-/**
- * Response DTO for a dismissible item.
- */
-export class DismissibleItemResponseDto {
-  @ApiProperty({
-    description: 'Unique identifier for the item',
-    example: 'welcome-banner-v2',
-  })
-  itemId!: string;
-
-  @ApiProperty({
-    description: 'User identifier who created the item',
-    example: 'user-123',
-  })
-  userId!: string;
-
-  @ApiProperty({
-    description: 'When the item was created (ISO 8601)',
-    example: '2024-01-15T10:30:00.000Z',
-  })
-  createdAt!: string;
-
-  @ApiPropertyOptional({
-    description: 'When the item was dismissed (ISO 8601)',
-    example: '2024-01-15T12:00:00.000Z',
-  })
-  dismissedAt?: string;
-
-  @ApiPropertyOptional({
-    description: 'Optional metadata associated with the item',
-    example: { version: 2, category: 'promotional' },
-    type: 'object',
-    additionalProperties: true,
-  })
-  metadata?: Record<string, unknown>;
-}

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

@@ -1,63 +0,0 @@
-import { DismissibleItemMapper } from './dismissible-item.mapper';
-import { createTestItem, createDismissedTestItem } from '../testing/factories';
-
-describe('DismissibleItemMapper', () => {
-  let mapper: DismissibleItemMapper;
-
-  beforeEach(() => {
-    mapper = new DismissibleItemMapper();
-  });
-
-  describe('toResponseDto', () => {
-    it('should convert basic item to DTO', () => {
-      const item = 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 = 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 = 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 = createTestItem({
-        id: 'test-item',
-        metadata: { version: 2, category: 'test' },
-      });
-
-      const dto = mapper.toResponseDto(item);
-
-      expect(dto.metadata).toEqual({ version: 2, category: 'test' });
-    });
-  });
-});

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

@@ -1,33 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { BaseMetadata, DismissibleItemDto } from '@dismissible/nestjs-dismissible-item';
-import { DismissibleItemResponseDto } from './dismissible-item-response.dto';
-
-/**
- * Mapper for converting domain objects to DTOs.
- */
-@Injectable()
-export 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 {
-    const dto = new 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 as Record<string, unknown>;
-    }
-
-    return dto;
-  }
-}

package/src/api/use-cases/dismiss/dismiss.controller.spec.ts

@@ -1,42 +0,0 @@
-import { mock } from 'ts-jest-mocker';
-import { DismissController } from './dismiss.controller';
-import { DismissibleService } from '../../../core/dismissible.service';
-import { DismissibleItemMapper } from '../../dismissible-item.mapper';
-import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
-import { createTestItem, createTestContext } from '../../../testing/factories';
-import { ResponseService } from '../../../response';
-
-describe('DismissController', () => {
-  let controller: DismissController;
-  let mockService: jest.Mocked<DismissibleService<BaseMetadata>>;
-  let mockResponseService: jest.Mocked<ResponseService>;
-  let mapper: DismissibleItemMapper;
-
-  beforeEach(() => {
-    mockService = mock(DismissibleService);
-    mockResponseService = mock(ResponseService, { failIfMockNotProvided: false });
-    mockResponseService.success.mockImplementation((data) => ({ data }));
-    mapper = new DismissibleItemMapper();
-
-    controller = new DismissController(mockService, mapper, mockResponseService);
-  });
-
-  describe('dismiss', () => {
-    it('should return dismissed item wrapped in data', async () => {
-      const item = createTestItem({
-        id: 'test-item',
-        dismissedAt: new Date(),
-      });
-      const previousItem = createTestItem({ id: 'test-item' });
-      const context = 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();
-    });
-  });
-});

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

@@ -1,63 +0,0 @@
-import { Controller, Delete, Param, UseFilters } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiParam, ApiResponse } from '@nestjs/swagger';
-import { DismissibleService } from '../../../core/dismissible.service';
-import { DismissibleItemMapper } from '../../dismissible-item.mapper';
-import { RequestContext } from '../../../request/request-context.decorator';
-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';
-import { HttpExceptionFilter } from '../../../response/http-exception-filter';
-import { API_TAG_DISMISSIBLE } from '../api-tags.constants';
-
-/**
- * Controller for dismiss dismissible item operations.
- */
-@ApiTags(API_TAG_DISMISSIBLE)
-@Controller('v1/user/:userId/dismissible-item')
-export class DismissController {
-  constructor(
-    private readonly dismissibleService: DismissibleService<BaseMetadata>,
-    private readonly mapper: DismissibleItemMapper,
-    private readonly responseService: ResponseService,
-  ) {}
-
-  @Delete(':itemId')
-  @ApiOperation({
-    summary: 'Dismiss an item',
-    description: 'Marks a dismissible item as dismissed.',
-  })
-  @ApiParam({
-    name: 'userId',
-    description: 'User identifier',
-    example: 'user-123',
-  })
-  @ApiParam({
-    name: 'itemId',
-    description: 'Unique identifier for the dismissible item',
-    example: 'welcome-banner-v2',
-  })
-  @ApiResponse({
-    status: 200,
-    description: 'The dismissed item',
-    type: DismissResponseDto,
-  })
-  @ApiResponse({
-    status: 400,
-    description: 'Item not found or already dismissed',
-  })
-  @ApiResponse({
-    status: 403,
-    description: 'Operation blocked by lifecycle hook',
-  })
-  @UseFilters(HttpExceptionFilter)
-  async dismiss(
-    @Param('userId') userId: string,
-    @Param('itemId') itemId: string,
-    @RequestContext() context: IRequestContext,
-  ): Promise<DismissResponseDto> {
-    const result = await this.dismissibleService.dismiss(itemId, userId, context);
-
-    return this.responseService.success(this.mapper.toResponseDto(result.item));
-  }
-}

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

@@ -1,7 +0,0 @@
-import { SuccessResponseDto } from '../../../response/dtos/success-response.dto';
-import { DismissibleItemResponseDto } from '../../dismissible-item-response.dto';
-
-/**
- * Response DTO for the dismiss operation.
- */
-export class DismissResponseDto extends SuccessResponseDto(DismissibleItemResponseDto) {}

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

@@ -1,76 +0,0 @@
-import { mock } from 'ts-jest-mocker';
-import { GetOrCreateController } from './get-or-create.controller';
-import { DismissibleService } from '../../../core/dismissible.service';
-import { DismissibleItemMapper } from '../../dismissible-item.mapper';
-import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
-import { createTestItem, createTestContext } from '../../../testing/factories';
-import { ResponseService } from '../../../response';
-
-describe('GetOrCreateController', () => {
-  let controller: GetOrCreateController;
-  let mockService: jest.Mocked<DismissibleService<BaseMetadata>>;
-  let mockResponseService: jest.Mocked<ResponseService>;
-  let mapper: DismissibleItemMapper;
-
-  beforeEach(() => {
-    mockService = mock(DismissibleService);
-    mockResponseService = mock(ResponseService, { failIfMockNotProvided: false });
-    mockResponseService.success.mockImplementation((data) => ({ data }));
-    mapper = new DismissibleItemMapper();
-
-    controller = new GetOrCreateController(mockService, mapper, mockResponseService);
-  });
-
-  describe('getOrCreate', () => {
-    it('should return item with created flag wrapped in data', async () => {
-      const item = createTestItem({ id: 'test-item' });
-      const context = 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 = createTestItem({ id: 'test-item' });
-      const context = 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 = createTestItem({ id: 'test-item' });
-      const context = 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,
-      );
-    });
-  });
-});

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

@@ -1,106 +0,0 @@
-import { Controller, Get, Param, Query, UseFilters } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiParam, ApiResponse, ApiQuery } from '@nestjs/swagger';
-import { DismissibleService } from '../../../core/dismissible.service';
-import { DismissibleItemMapper } from '../../dismissible-item.mapper';
-import { RequestContext } from '../../../request/request-context.decorator';
-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';
-import { HttpExceptionFilter } from '../../../response/http-exception-filter';
-import { API_TAG_DISMISSIBLE } from '../api-tags.constants';
-
-/**
- * Controller for get-or-create dismissible item operations.
- */
-@ApiTags(API_TAG_DISMISSIBLE)
-@Controller('v1/user/:userId/dismissible-item')
-export class GetOrCreateController {
-  constructor(
-    private readonly dismissibleService: DismissibleService<BaseMetadata>,
-    private readonly mapper: DismissibleItemMapper,
-    private readonly responseService: ResponseService,
-  ) {}
-
-  @Get(':itemId')
-  @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.',
-  })
-  @ApiParam({
-    name: 'userId',
-    description: 'User identifier',
-    example: 'user-123',
-  })
-  @ApiParam({
-    name: 'itemId',
-    description: 'Unique identifier for the dismissible item',
-    example: 'welcome-banner-v2',
-  })
-  @ApiQuery({
-    name: 'metadata',
-    description: 'Optional metadata as key:value pairs (can be repeated)',
-    required: false,
-    isArray: true,
-    type: String,
-    example: 'version:2',
-  })
-  @ApiResponse({
-    status: 200,
-    description: 'The dismissible item (retrieved or created)',
-    type: GetOrCreateResponseDto,
-  })
-  @ApiResponse({
-    status: 403,
-    description: 'Operation blocked by lifecycle hook',
-  })
-  @UseFilters(HttpExceptionFilter)
-  async getOrCreate(
-    @Param('userId') userId: string,
-    @Param('itemId') itemId: string,
-    @RequestContext() context: IRequestContext,
-    @Query('metadata') metadataRaw?: string | string[],
-  ): Promise<GetOrCreateResponseDto> {
-    // Parse metadata from query params
-    const metadata = this.parseMetadata(metadataRaw);
-
-    const result = await this.dismissibleService.getOrCreate(
-      itemId,
-      userId,
-      {
-        metadata: metadata as BaseMetadata,
-      },
-      context,
-    );
-
-    return this.responseService.success(this.mapper.toResponseDto(result.item));
-  }
-
-  /**
-   * Parse metadata from query parameter format.
-   * Supports: `?metadata=key1:value1&metadata=key2:value2`
-   */
-  private parseMetadata(raw?: string | string[]): Record<string, string | number> | undefined {
-    if (!raw) {
-      return undefined;
-    }
-
-    const items = Array.isArray(raw) ? raw : [raw];
-    const metadata: Record<string, string | number> = {};
-
-    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;
-  }
-}

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

@@ -1,17 +0,0 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { IsOptional, IsObject } from 'class-validator';
-
-/**
- * Query parameters for creating a dismissible item.
- */
-export class CreateDismissibleItemQueryDto {
-  @ApiPropertyOptional({
-    description: 'Optional metadata to attach to the item',
-    example: { key: 'value' },
-    type: 'object',
-    additionalProperties: true,
-  })
-  @IsOptional()
-  @IsObject()
-  metadata?: Record<string, string | number>;
-}

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

@@ -1,7 +0,0 @@
-import { SuccessResponseDto } from '../../../response/dtos/success-response.dto';
-import { DismissibleItemResponseDto } from '../../dismissible-item-response.dto';
-
-/**
- * Response DTO for the getOrCreate operation.
- */
-export class GetOrCreateResponseDto extends SuccessResponseDto(DismissibleItemResponseDto) {}

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

@@ -1,42 +0,0 @@
-import { mock } from 'ts-jest-mocker';
-import { RestoreController } from './restore.controller';
-import { DismissibleService } from '../../../core/dismissible.service';
-import { DismissibleItemMapper } from '../../dismissible-item.mapper';
-import { BaseMetadata } from '@dismissible/nestjs-dismissible-item';
-import { createTestItem, createTestContext } from '../../../testing/factories';
-import { ResponseService } from '../../../response';
-
-describe('RestoreController', () => {
-  let controller: RestoreController;
-  let mockService: jest.Mocked<DismissibleService<BaseMetadata>>;
-  let mockResponseService: jest.Mocked<ResponseService>;
-  let mapper: DismissibleItemMapper;
-
-  beforeEach(() => {
-    mockService = mock(DismissibleService);
-    mockResponseService = mock(ResponseService, { failIfMockNotProvided: false });
-    mockResponseService.success.mockImplementation((data) => ({ data }));
-    mapper = new DismissibleItemMapper();
-
-    controller = new RestoreController(mockService, mapper, mockResponseService);
-  });
-
-  describe('restore', () => {
-    it('should return restored item wrapped in data', async () => {
-      const item = createTestItem({ id: 'test-item' });
-      const previousItem = createTestItem({
-        id: 'test-item',
-        dismissedAt: new Date(),
-      });
-      const context = 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();
-    });
-  });
-});