@ftisindia/create-app 0.1.3 → 0.1.5

package/template/src/modules/invitations/dto/create-invitation.dto.ts

@@ -1,6 +1,6 @@
-import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { InvitationTargetType } from "@prisma/client";
-import { Type } from "class-transformer";
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { InvitationTargetType } from '@prisma/client';
+import { Type } from 'class-transformer';
 import {
   isEmail,
   IsEnum,
@@ -16,7 +16,7 @@ import {
   ValidationArguments,
   ValidatorConstraint,
   ValidatorConstraintInterface,
-} from "class-validator";
+} from 'class-validator';
 
 const mobileTargetPattern = /^\+?[1-9]\d{6,14}$/;
 
@@ -24,10 +24,10 @@ type InvitationTargetValueObject = {
   targetType?: InvitationTargetType;
 };
 
-@ValidatorConstraint({ name: "InvitationTargetValue", async: false })
+@ValidatorConstraint({ name: 'InvitationTargetValue', async: false })
 class InvitationTargetValueConstraint implements ValidatorConstraintInterface {
   validate(value: unknown, args: ValidationArguments) {
-    if (typeof value !== "string") {
+    if (typeof value !== 'string') {
       return false;
     }
 
@@ -46,14 +46,14 @@ class InvitationTargetValueConstraint implements ValidatorConstraintInterface {
   defaultMessage(args: ValidationArguments) {
     const targetType = (args.object as InvitationTargetValueObject).targetType;
     if (targetType === InvitationTargetType.EMAIL) {
-      return "targetValue must be a valid email address when targetType is EMAIL";
+      return 'targetValue must be a valid email address when targetType is EMAIL';
     }
 
     if (targetType === InvitationTargetType.MOBILE) {
-      return "targetValue must be an E.164-style mobile number when targetType is MOBILE";
+      return 'targetValue must be an E.164-style mobile number when targetType is MOBILE';
     }
 
-    return "targetValue must match targetType";
+    return 'targetValue must match targetType';
   }
 }
 
@@ -66,9 +66,8 @@ export class CreateInvitationDto {
   targetType!: InvitationTargetType;
 
   @ApiProperty({
-    description:
-      "Email address or E.164-style mobile number matching targetType.",
-    example: "new.member@example.com",
+    description: 'Email address or E.164-style mobile number matching targetType.',
+    example: 'new.member@example.com',
     minLength: 3,
     maxLength: 320,
   })
@@ -79,14 +78,14 @@ export class CreateInvitationDto {
   targetValue!: string;
 
   @ApiProperty({
-    example: "f602c057-04f4-4ef8-8c84-1b7c62fbf8c5",
-    format: "uuid",
+    example: 'f602c057-04f4-4ef8-8c84-1b7c62fbf8c5',
+    format: 'uuid',
   })
   @IsUUID()
   roleId!: string;
 
   @ApiPropertyOptional({
-    description: "Invitation lifetime in days.",
+    description: 'Invitation lifetime in days.',
     example: 7,
     minimum: 1,
     maximum: 30,

package/template/src/modules/invitations/dto/invitation-response.dto.ts

@@ -1,22 +1,19 @@
-import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { InvitationStatus, InvitationTargetType } from "@prisma/client";
-import { MembershipResponseDto } from "../../../common/dto/membership-response.dto";
-import { RoleSummaryDto } from "../../../common/dto/role-summary.dto";
-import {
-  ActiveUserSummaryDto,
-  UserSummaryDto,
-} from "../../../common/dto/user-summary.dto";
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { InvitationStatus, InvitationTargetType } from '@prisma/client';
+import { MembershipResponseDto } from '../../../common/dto/membership-response.dto';
+import { RoleSummaryDto } from '../../../common/dto/role-summary.dto';
+import { ActiveUserSummaryDto, UserSummaryDto } from '../../../common/dto/user-summary.dto';
 
 export class InvitationResponseDto {
   @ApiProperty({
-    example: "17a21ad7-bd1b-42d8-b809-0a3892bb60c3",
-    format: "uuid",
+    example: '17a21ad7-bd1b-42d8-b809-0a3892bb60c3',
+    format: 'uuid',
   })
   id!: string;
 
   @ApiProperty({
-    example: "2c67399d-670c-4025-a5fd-1ea9a211891e",
-    format: "uuid",
+    example: '2c67399d-670c-4025-a5fd-1ea9a211891e',
+    format: 'uuid',
   })
   orgId!: string;
 
@@ -26,33 +23,33 @@ export class InvitationResponseDto {
   })
   targetType!: InvitationTargetType;
 
-  @ApiProperty({ example: "new.member@example.com" })
+  @ApiProperty({ example: 'new.member@example.com' })
   targetValue!: string;
 
-  @ApiProperty({ example: "new.member@example.com" })
+  @ApiProperty({ example: 'new.member@example.com' })
   normalizedTargetValue!: string;
 
   @ApiProperty({
-    example: "f602c057-04f4-4ef8-8c84-1b7c62fbf8c5",
-    format: "uuid",
+    example: 'f602c057-04f4-4ef8-8c84-1b7c62fbf8c5',
+    format: 'uuid',
   })
   roleId!: string;
 
   @ApiProperty({ enum: InvitationStatus, example: InvitationStatus.PENDING })
   status!: InvitationStatus;
 
-  @ApiProperty({ example: "2026-06-08T10:30:00.000Z", format: "date-time" })
+  @ApiProperty({ example: '2026-06-08T10:30:00.000Z', format: 'date-time' })
   expiresAt!: string;
 
   @ApiProperty({
-    example: "4a4f0d8a-4bd2-469f-a6a9-3e1cb6a2b456",
-    format: "uuid",
+    example: '4a4f0d8a-4bd2-469f-a6a9-3e1cb6a2b456',
+    format: 'uuid',
   })
   invitedByUserId!: string;
 
   @ApiPropertyOptional({
-    example: "7efd9a26-fbec-4511-ae37-7fb1c35e5215",
-    format: "uuid",
+    example: '7efd9a26-fbec-4511-ae37-7fb1c35e5215',
+    format: 'uuid',
     nullable: true,
   })
   acceptedByUserId?: string | null;
@@ -66,19 +63,19 @@ export class InvitationResponseDto {
   @ApiPropertyOptional({ type: UserSummaryDto, nullable: true })
   acceptedByUser?: UserSummaryDto | null;
 
-  @ApiProperty({ example: "2026-06-01T10:30:00.000Z", format: "date-time" })
+  @ApiProperty({ example: '2026-06-01T10:30:00.000Z', format: 'date-time' })
   createdAt!: string;
 
   @ApiPropertyOptional({
-    example: "2026-06-01T10:35:00.000Z",
-    format: "date-time",
+    example: '2026-06-01T10:35:00.000Z',
+    format: 'date-time',
     nullable: true,
   })
   acceptedAt?: string | null;
 
   @ApiPropertyOptional({
-    example: "2026-06-01T10:40:00.000Z",
-    format: "date-time",
+    example: '2026-06-01T10:40:00.000Z',
+    format: 'date-time',
     nullable: true,
   })
   revokedAt?: string | null;
@@ -89,13 +86,24 @@ export class InvitationWithTokenResponseDto {
   invitation!: InvitationResponseDto;
 
   @ApiProperty({
-    description:
-      "One-time invitation token. This is returned only at create/resend time.",
-    example: "k0Y7QJr7pC1r7GJrFXdN2vzmw1lYkT5YhJdORQb4Pp4",
+    description: 'One-time invitation token. This is returned only at create/resend time.',
+    example: 'k0Y7QJr7pC1r7GJrFXdN2vzmw1lYkT5YhJdORQb4Pp4',
   })
   inviteToken!: string;
 }
 
+export class InvitationListResponseDto {
+  @ApiProperty({ type: [InvitationResponseDto] })
+  items!: InvitationResponseDto[];
+
+  @ApiPropertyOptional({
+    example: '17a21ad7-bd1b-42d8-b809-0a3892bb60c3',
+    format: 'uuid',
+    nullable: true,
+  })
+  nextCursor!: string | null;
+}
+
 export class AcceptInvitationResponseDto {
   @ApiProperty({ type: InvitationResponseDto })
   invitation!: InvitationResponseDto;

package/template/src/modules/invitations/dto/invitation-token.dto.ts

@@ -1,10 +1,10 @@
-import { ApiProperty } from "@nestjs/swagger";
-import { IsString, MaxLength, MinLength } from "class-validator";
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, MaxLength, MinLength } from 'class-validator';
 
 export class InvitationTokenDto {
   @ApiProperty({
-    description: "One-time invitation token from create/resend invitation.",
-    example: "k0Y7QJr7pC1r7GJrFXdN2vzmw1lYkT5YhJdORQb4Pp4",
+    description: 'One-time invitation token from create/resend invitation.',
+    example: 'k0Y7QJr7pC1r7GJrFXdN2vzmw1lYkT5YhJdORQb4Pp4',
     minLength: 20,
     maxLength: 256,
   })

package/template/src/modules/invitations/invitations.module.ts

@@ -1,8 +1,8 @@
-import { Module } from "@nestjs/common";
-import { AuthModule } from "../auth/auth.module";
-import { MembershipsModule } from "../memberships/memberships.module";
-import { InvitationsService } from "./application/services/invitations.service";
-import { InvitationsController } from "./presentation/invitations.controller";
+import { Module } from '@nestjs/common';
+import { AuthModule } from '../auth/auth.module';
+import { MembershipsModule } from '../memberships/memberships.module';
+import { InvitationsService } from './application/services/invitations.service';
+import { InvitationsController } from './presentation/invitations.controller';
 
 @Module({
   imports: [AuthModule, MembershipsModule],

package/template/src/modules/invitations/presentation/invitations.controller.ts

@@ -1,12 +1,4 @@
-import {
-  Body,
-  Controller,
-  Get,
-  HttpCode,
-  Param,
-  Post,
-  UseGuards,
-} from "@nestjs/common";
+import { Body, Controller, Get, HttpCode, Param, Post, Query, UseGuards } from '@nestjs/common';
 import {
   ApiBearerAuth,
   ApiCreatedResponse,
@@ -14,120 +6,126 @@ import {
   ApiOperation,
   ApiParam,
   ApiTags,
-} from "@nestjs/swagger";
-import { ApiErrorResponses } from "../../../common/swagger/api-error-responses";
-import { PermissionGuard } from "../../access-control/application/services/permission.guard";
-import { RequirePermissions } from "../../access-control/presentation/permissions.decorator";
-import { JwtAuthGuard } from "../../auth/infrastructure/passport/jwt-auth.guard";
-import { CurrentUser } from "../../auth/presentation/current-user.decorator";
-import { AuthenticatedUser } from "../../auth/types/authenticated-user";
-import { OrgScopeGuard } from "../../request-context/presentation/org-scope.guard";
-import { InvitationsService } from "../application/services/invitations.service";
-import { AcceptInvitationDto } from "../dto/accept-invitation.dto";
-import { CreateInvitationDto } from "../dto/create-invitation.dto";
-import { InvitationTokenDto } from "../dto/invitation-token.dto";
+} from '@nestjs/swagger';
+import { ApiErrorResponses } from '../../../common/swagger/api-error-responses';
+import { PaginationQueryDto } from '../../../common/dto/pagination-query.dto';
+import { PermissionGuard } from '../../access-control/application/services/permission.guard';
+import { RequirePermissions } from '../../access-control/presentation/permissions.decorator';
+import { JwtAuthGuard } from '../../auth/infrastructure/passport/jwt-auth.guard';
+import { CurrentUser } from '../../auth/presentation/current-user.decorator';
+import { AuthenticatedUser } from '../../auth/types/authenticated-user';
+import { OrgScopeGuard } from '../../request-context/presentation/org-scope.guard';
+import { InvitationsService } from '../application/services/invitations.service';
+import { AcceptInvitationDto } from '../dto/accept-invitation.dto';
+import { CreateInvitationDto } from '../dto/create-invitation.dto';
+import { InvitationTokenDto } from '../dto/invitation-token.dto';
 import {
   AcceptInvitationResponseDto,
+  InvitationListResponseDto,
   InvitationResponseDto,
   InvitationWithTokenResponseDto,
-} from "../dto/invitation-response.dto";
+} from '../dto/invitation-response.dto';
 
-@ApiTags("Invitations")
+@ApiTags('Invitations')
 @Controller()
 export class InvitationsController {
   constructor(private readonly invitationsService: InvitationsService) {}
 
-  @Post("organisations/:orgId/invitations")
+  @Post('organisations/:orgId/invitations')
   @UseGuards(JwtAuthGuard, OrgScopeGuard, PermissionGuard)
-  @RequirePermissions("memberships.invite")
+  @RequirePermissions('memberships.invite')
   @ApiBearerAuth()
-  @ApiParam({ name: "orgId", description: "Organisation ID.", format: "uuid" })
+  @ApiParam({ name: 'orgId', description: 'Organisation ID.', format: 'uuid' })
   @ApiOperation({
-    summary: "Create an invitation for an email or mobile target.",
+    summary: 'Create an invitation for an email or mobile target.',
   })
   @ApiCreatedResponse({
-    description: "Invitation created. The inviteToken is shown once.",
+    description: 'Invitation created. The inviteToken is shown once.',
     type: InvitationWithTokenResponseDto,
   })
   @ApiErrorResponses(400, 401, 403, 404, 409)
   create(
     @CurrentUser() user: AuthenticatedUser,
-    @Param("orgId") orgId: string,
+    @Param('orgId') orgId: string,
     @Body() dto: CreateInvitationDto,
   ) {
     return this.invitationsService.createInvitation(user, orgId, dto);
   }
 
-  @Get("organisations/:orgId/invitations")
+  @Get('organisations/:orgId/invitations')
   @UseGuards(JwtAuthGuard, OrgScopeGuard, PermissionGuard)
-  @RequirePermissions("memberships.read")
+  @RequirePermissions('memberships.read')
   @ApiBearerAuth()
-  @ApiParam({ name: "orgId", description: "Organisation ID.", format: "uuid" })
-  @ApiOperation({ summary: "List invitations for an organisation." })
+  @ApiParam({ name: 'orgId', description: 'Organisation ID.', format: 'uuid' })
+  @ApiOperation({ summary: 'List invitations for an organisation.' })
   @ApiOkResponse({
-    description: "Organisation invitations.",
-    type: [InvitationResponseDto],
+    description: 'Organisation invitations.',
+    type: InvitationListResponseDto,
   })
   @ApiErrorResponses(400, 401, 403)
-  list(@CurrentUser() user: AuthenticatedUser, @Param("orgId") orgId: string) {
-    return this.invitationsService.listInvitations(user, orgId);
+  list(
+    @CurrentUser() user: AuthenticatedUser,
+    @Param('orgId') orgId: string,
+    @Query() query: PaginationQueryDto,
+  ) {
+    return this.invitationsService.listInvitations(user, orgId, query);
   }
 
-  @Post("organisations/:orgId/invitations/:invitationId/revoke")
+  @Post('organisations/:orgId/invitations/:invitationId/revoke')
   @HttpCode(200)
   @UseGuards(JwtAuthGuard, OrgScopeGuard, PermissionGuard)
-  @RequirePermissions("memberships.revoke")
+  @RequirePermissions('memberships.revoke')
   @ApiBearerAuth()
-  @ApiParam({ name: "orgId", description: "Organisation ID.", format: "uuid" })
+  @ApiParam({ name: 'orgId', description: 'Organisation ID.', format: 'uuid' })
   @ApiParam({
-    name: "invitationId",
-    description: "Invitation ID.",
-    format: "uuid",
+    name: 'invitationId',
+    description: 'Invitation ID.',
+    format: 'uuid',
   })
-  @ApiOperation({ summary: "Revoke a pending invitation." })
+  @ApiOperation({ summary: 'Revoke a pending invitation.' })
   @ApiOkResponse({
-    description: "Revoked invitation.",
+    description: 'Revoked invitation.',
     type: InvitationResponseDto,
   })
   @ApiErrorResponses(400, 401, 403, 404, 409, 410)
   revoke(
     @CurrentUser() user: AuthenticatedUser,
-    @Param("orgId") orgId: string,
-    @Param("invitationId") invitationId: string,
+    @Param('orgId') orgId: string,
+    @Param('invitationId') invitationId: string,
   ) {
     return this.invitationsService.revokeInvitation(user, orgId, invitationId);
   }
 
-  @Post("organisations/:orgId/invitations/:invitationId/resend")
+  @Post('organisations/:orgId/invitations/:invitationId/resend')
   @HttpCode(200)
   @UseGuards(JwtAuthGuard, OrgScopeGuard, PermissionGuard)
-  @RequirePermissions("memberships.invite")
+  @RequirePermissions('memberships.invite')
   @ApiBearerAuth()
-  @ApiParam({ name: "orgId", description: "Organisation ID.", format: "uuid" })
+  @ApiParam({ name: 'orgId', description: 'Organisation ID.', format: 'uuid' })
   @ApiParam({
-    name: "invitationId",
-    description: "Invitation ID.",
-    format: "uuid",
+    name: 'invitationId',
+    description: 'Invitation ID.',
+    format: 'uuid',
   })
-  @ApiOperation({ summary: "Resend a pending or expired invitation." })
+  @ApiOperation({ summary: 'Resend a pending or expired invitation.' })
   @ApiOkResponse({
-    description: "Invitation resent. The new inviteToken is shown once.",
+    description: 'Invitation resent. The new inviteToken is shown once.',
     type: InvitationWithTokenResponseDto,
   })
   @ApiErrorResponses(400, 401, 403, 404, 409)
   resend(
     @CurrentUser() user: AuthenticatedUser,
-    @Param("orgId") orgId: string,
-    @Param("invitationId") invitationId: string,
+    @Param('orgId') orgId: string,
+    @Param('invitationId') invitationId: string,
   ) {
     return this.invitationsService.resendInvitation(user, orgId, invitationId);
   }
 
-  @Post("invitations/accept")
+  @Post('invitations/accept')
   @HttpCode(200)
-  @ApiOperation({ summary: "Accept an invitation token." })
+  @ApiOperation({ summary: 'Accept an invitation token.' })
   @ApiOkResponse({
-    description: "Invitation accepted and membership created.",
+    description: 'Invitation accepted and membership created.',
     type: AcceptInvitationResponseDto,
   })
   @ApiErrorResponses(400, 401, 409, 410)
@@ -135,11 +133,11 @@ export class InvitationsController {
     return this.invitationsService.acceptInvitation(dto);
   }
 
-  @Post("invitations/decline")
+  @Post('invitations/decline')
   @HttpCode(200)
-  @ApiOperation({ summary: "Decline an invitation token." })
+  @ApiOperation({ summary: 'Decline an invitation token.' })
   @ApiOkResponse({
-    description: "Declined invitation.",
+    description: 'Declined invitation.',
     type: InvitationResponseDto,
   })
   @ApiErrorResponses(400, 401, 409, 410)