fix(api): typed OpenAPI query params and not-found messages that hide private projects

- Query DTO properties with a default value (limit, offset, days, perColumn,
  assignedToMe, search, archived, requiresReason, force) were documented as
  `object` in openapi.json, which broke generated clients. They now declare
  their type explicitly.
- Reading a private project, ticket, release or its comments without access
  answered "Project <internal id> not found", confirming the project exists.
  ReadAccess now reports what the caller asked for (e2e covered).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

libs/api/identity/presenters/src/lib/http/users.controller.ts

@@ -48,13 +48,17 @@ export class MeDto extends UserDto {
 }
 
 export class UserSearchQueryDto {
-  @ApiPropertyOptional({ description: 'Name or email', default: '' })
+  @ApiPropertyOptional({
+    type: String,
+    description: 'Name or email',
+    default: '',
+  })
   @IsOptional()
   @IsString()
   @MaxLength(100)
   search = '';
 
-  @ApiPropertyOptional({ default: 20, minimum: 1, maximum: 100 })
+  @ApiPropertyOptional({ type: Number, default: 20, minimum: 1, maximum: 100 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()

libs/api/tracker/application/src/lib/queries/get-comments.query-handler.ts

@@ -21,7 +21,10 @@ export class GetCommentsQueryHandler
       'Issue',
       query.issueId,
     );
-    await this.access.assertCanView(issue.projectId, query.viewerId);
+    await this.access.assertCanView(issue.projectId, query.viewerId, {
+      entity: 'Issue',
+      ref: query.issueId,
+    });
     return this.findComments.findByIssue(
       issue.id,
       Math.min(query.limit, 200),

libs/api/tracker/application/src/lib/queries/get-issue.query-handler.ts

@@ -18,7 +18,10 @@ export class GetIssueQueryHandler
       ? await this.findIssues.findById(query.idOrKey)
       : await this.findIssues.findByKey(query.idOrKey.toUpperCase());
     const found = this.access.assertFound(issue, 'Issue', query.idOrKey);
-    await this.access.assertCanView(found.projectId, query.viewerId);
+    await this.access.assertCanView(found.projectId, query.viewerId, {
+      entity: 'Issue',
+      ref: query.idOrKey,
+    });
     return found;
   }
 }

libs/api/tracker/application/src/lib/queries/get-project.query-handler.ts

@@ -18,7 +18,10 @@ export class GetProjectQueryHandler
       ? await this.findProjects.findById(query.idOrKey)
       : await this.findProjects.findByKey(query.idOrKey.toUpperCase());
     const found = this.access.assertFound(project, 'Project', query.idOrKey);
-    await this.access.assertCanView(found.id, query.viewerId);
+    await this.access.assertCanView(found.id, query.viewerId, {
+      entity: 'Project',
+      ref: query.idOrKey,
+    });
     return found;
   }
 }

libs/api/tracker/application/src/lib/queries/get-release-burnup.query-handler.ts

@@ -24,7 +24,10 @@ export class GetReleaseBurnupQueryHandler
       'Release',
       query.releaseId,
     );
-    await this.access.assertCanView(release.projectId, query.viewerId);
+    await this.access.assertCanView(release.projectId, query.viewerId, {
+      entity: 'Release',
+      ref: query.releaseId,
+    });
     const [issues, timeline] = await Promise.all([
       this.findIssues.findByProject(release.projectId),
       this.findTimeline.findByProject(release.projectId),

libs/api/tracker/application/src/lib/queries/get-release-progress.query-handler.ts

@@ -23,7 +23,10 @@ export class GetReleaseProgressQueryHandler
       'Release',
       query.releaseId,
     );
-    await this.access.assertCanView(release.projectId, query.viewerId);
+    await this.access.assertCanView(release.projectId, query.viewerId, {
+      entity: 'Release',
+      ref: query.releaseId,
+    });
     return this.findIssues.releaseProgress(release.id);
   }
 }

libs/api/tracker/application/src/lib/queries/get-release.query-handler.ts

@@ -19,7 +19,10 @@ export class GetReleaseQueryHandler
       'Release',
       query.releaseId,
     );
-    await this.access.assertCanView(release.projectId, query.viewerId);
+    await this.access.assertCanView(release.projectId, query.viewerId, {
+      entity: 'Release',
+      ref: query.releaseId,
+    });
     return release;
   }
 }

libs/api/tracker/application/src/lib/queries/read-access.ts

@@ -12,10 +12,18 @@ import { FindProjectsRepository } from '../ports/find-projects.repository';
 export class ReadAccess {
   constructor(private readonly findProjects: FindProjectsRepository) {}
 
-  /** The viewer's role, or null when they read a public project as an outsider. */
+  /**
+   * The viewer's role, or null when they read a public project as an outsider.
+   * `asked` is what the caller looked for: the error names it, never the
+   * project behind it (that would confirm a private project exists).
+   */
   async assertCanView(
     projectId: string,
     viewerId: string | null,
+    asked: { entity: string; ref: string } = {
+      entity: 'Project',
+      ref: projectId,
+    },
   ): Promise<ProjectRole | null> {
     const role = viewerId
       ? await this.findProjects.findRole(projectId, viewerId)
@@ -23,7 +31,7 @@ export class ReadAccess {
     if (role) return role;
     const project = await this.findProjects.findById(projectId);
     // Same answer for "doesn't exist" and "not yours": don't leak projects.
-    if (!project?.isPublic) throw new NotFoundError('Project', projectId);
+    if (!project?.isPublic) throw new NotFoundError(asked.entity, asked.ref);
     return null;
   }
 

libs/api/tracker/presenters/src/lib/http/dto/requests.dto.ts

@@ -132,11 +132,11 @@ export class WorkflowStatusBodyDto {
   @ApiProperty({ enum: SETTING_COLORS, enumName: 'SettingColor' })
   @IsIn(SETTING_COLORS)
   color!: string;
-  @ApiPropertyOptional({ default: false })
+  @ApiPropertyOptional({ type: Boolean, default: false })
   @IsOptional()
   @IsBoolean()
   requiresReason = false;
-  @ApiPropertyOptional({ default: false })
+  @ApiPropertyOptional({ type: Boolean, default: false })
   @IsOptional()
   @IsBoolean()
   archived = false;
@@ -164,7 +164,7 @@ export class IssueTypeOptionBodyDto {
   @ApiProperty({ enum: SETTING_COLORS, enumName: 'SettingColor' })
   @IsIn(SETTING_COLORS)
   color!: string;
-  @ApiPropertyOptional({ default: false })
+  @ApiPropertyOptional({ type: Boolean, default: false })
   @IsOptional()
   @IsBoolean()
   archived = false;
@@ -177,7 +177,7 @@ export class AreaOptionBodyDto {
   @MinLength(1)
   @MaxLength(40)
   name!: string;
-  @ApiPropertyOptional({ default: false })
+  @ApiPropertyOptional({ type: Boolean, default: false })
   @IsOptional()
   @IsBoolean()
   archived = false;
@@ -218,7 +218,7 @@ export class ProjectSettingsBodyDto {
 }
 
 export class AnalyticsQueryDto {
-  @ApiPropertyOptional({ default: 90, minimum: 7, maximum: 365 })
+  @ApiPropertyOptional({ type: Number, default: 90, minimum: 7, maximum: 365 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -249,7 +249,7 @@ export class BoardQueryDto {
   @Matches(SETTING_ID)
   area?: string;
 
-  @ApiPropertyOptional({ default: 50, minimum: 1, maximum: 200 })
+  @ApiPropertyOptional({ type: Number, default: 50, minimum: 1, maximum: 200 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -264,7 +264,7 @@ export class ActivityQueryDto {
   @IsString()
   issueId?: string;
 
-  @ApiPropertyOptional({ default: 50, minimum: 1, maximum: 200 })
+  @ApiPropertyOptional({ type: Number, default: 50, minimum: 1, maximum: 200 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -282,7 +282,7 @@ export class ActivityQueryDto {
 }
 
 export class PageQueryDto {
-  @ApiPropertyOptional({ default: 50, minimum: 1, maximum: 200 })
+  @ApiPropertyOptional({ type: Number, default: 50, minimum: 1, maximum: 200 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -290,7 +290,7 @@ export class PageQueryDto {
   @Max(200)
   limit = 50;
 
-  @ApiPropertyOptional({ default: 0, minimum: 0 })
+  @ApiPropertyOptional({ type: Number, default: 0, minimum: 0 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -302,6 +302,7 @@ export class PageQueryDto {
 
 export class MyIssuesQueryDto extends PageQueryDto {
   @ApiPropertyOptional({
+    type: Boolean,
     default: true,
     description:
       'true: tickets assigned to me. false: any ticket of my projects (e.g. ?assignedToMe=false&category=QA)',
@@ -333,7 +334,7 @@ export class MyIssuesQueryDto extends PageQueryDto {
 }
 
 export class UpcomingReleasesQueryDto {
-  @ApiPropertyOptional({ default: 10, minimum: 1, maximum: 50 })
+  @ApiPropertyOptional({ type: Number, default: 10, minimum: 1, maximum: 50 })
   @IsOptional()
   @Type(() => Number)
   @IsInt()
@@ -613,6 +614,7 @@ export class UpdateReleaseDto extends PartialType(CreateReleaseDto) {}
 
 export class PublishReleaseDto {
   @ApiPropertyOptional({
+    type: Boolean,
     default: false,
     description: 'Publish even with unfinished tickets',
   })