ddd-ts-kit 0.13.0 → 0.15.0

package/templates/presets/identity/context/presentation/http/invitations/accept-invitation/accept-invitation.controller.ts.tpl

@@ -0,0 +1,100 @@
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+import { AcceptInvitationCommand } from '{{alias.context}}/application/commands/accept-invitation/accept-invitation.command{{alias.ext}}';
+{{#if schemas.shared}}
+import { InvitationToken } from '{{alias.context}}/presentation/http/shared/invitation-token.schema{{alias.ext}}';
+{{/if}}
+{{#if schemas.perRoute}}
+import { AcceptInvitationBody } from '{{alias.context}}/presentation/http/invitations/accept-invitation/accept-invitation.body{{alias.ext}}';
+{{/if}}
+{{#if schemas.perRoute}}
+import { AcceptInvitationAccepted } from '{{alias.context}}/presentation/http/invitations/accept-invitation/accept-invitation.accepted{{alias.ext}}';
+{{/if}}
+import { InvitationsRoutes } from '{{alias.context}}/presentation/http/invitations.routes{{alias.ext}}';
+{{/if}}
+{{#if validation.zod}}
+{{#if schemas.perRoute}}
+import { z } from 'zod';
+{{/if}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import type { Infer } from '@ddd-ts-kit/validation';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+import { AcceptInvitationCommand } from '{{alias.context}}/application/commands/accept-invitation/accept-invitation.command{{alias.ext}}';
+{{#if schemas.shared}}
+import { invitationTokenSchema } from '{{alias.context}}/presentation/http/shared/invitation-token.schema{{alias.ext}}';
+{{/if}}
+import { InvitationsRoutes } from '{{alias.context}}/presentation/http/invitations.routes{{alias.ext}}';
+{{/if}}
+
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+const body = classSchema(InvitationToken, { shared: true });
+{{/if}}
+{{#if schemas.perRoute}}
+const body = classSchema(AcceptInvitationBody);
+{{/if}}
+{{#if schemas.perRoute}}
+const accepted = classSchema(AcceptInvitationAccepted);
+{{/if}}
+{{/if}}
+{{#if validation.zod}}
+{{#if schemas.shared}}
+const body = zodSchema(invitationTokenSchema);
+{{/if}}
+{{#if schemas.perRoute}}
+const body = zodSchema(
+  z.object({
+    token: z.string().min(1),
+  }),
+);
+{{/if}}
+
+{{#if schemas.perRoute}}
+const accepted = zodSchema(z.object({ id: z.string() }), { io: 'output' });
+{{/if}}
+{{/if}}
+
+@Controller({
+  group: InvitationsRoutes,
+  method: 'POST',
+  path: '/acceptance',
+  summary: 'Accept an invitation',
+  body,
+  response: { status: 200, description: 'Accepted; the caller is a member, the body carries the identifier of the invitation.', body: {{#if schemas.shared}}acceptedSchema{{/if}}{{#if schemas.perRoute}}accepted{{/if}} },
+  errors: [
+    'INVITATION_NOT_FOUND',
+    'ACCOUNT_NOT_FOUND',
+    'ACCOUNT_DEACTIVATED',
+    'INVITATION_NOT_PENDING',
+    'INVITATION_EXPIRED',
+    'INVITATION_ADDRESSED_TO_ANOTHER',
+    'ALREADY_MEMBER',
+  ],
+})
+export class AcceptInvitationController {
+  constructor(private readonly commands: CommandBus) {}
+
+{{#if validation.classValidator}}
+  async handle(request: HttpRequest<{ body: {{#if schemas.shared}}InvitationToken{{/if}}{{#if schemas.perRoute}}AcceptInvitationBody{{/if}} }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}AcceptInvitationAccepted{{/if}}> {
+{{/if}}
+{{#if validation.zod}}
+  async handle(request: HttpRequest<{ body: Infer<typeof body> }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}Infer<typeof accepted>{{/if}}> {
+{{/if}}
+    const id = await this.commands.execute(new AcceptInvitationCommand(request.actor, request.body.token));
+
+    return { id };
+  }
+}

package/templates/presets/identity/context/presentation/http/invitations/decline-invitation/decline-invitation.accepted.class-validator.per-route.ts.tpl

@@ -0,0 +1,6 @@
+import { IsString } from 'class-validator';
+
+export class DeclineInvitationAccepted {
+  @IsString()
+  id = '';
+}

package/templates/presets/identity/context/presentation/http/invitations/decline-invitation/decline-invitation.body.class-validator.per-route.ts.tpl

@@ -0,0 +1,8 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class DeclineInvitationBody {
+  /** The token the invitation was sent with. */
+  @IsString()
+  @IsNotEmpty()
+  token = '';
+}

package/templates/presets/identity/context/presentation/http/invitations/decline-invitation/decline-invitation.controller.ts.tpl

@@ -0,0 +1,98 @@
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+import { DeclineInvitationCommand } from '{{alias.context}}/application/commands/decline-invitation/decline-invitation.command{{alias.ext}}';
+{{#if schemas.shared}}
+import { InvitationToken } from '{{alias.context}}/presentation/http/shared/invitation-token.schema{{alias.ext}}';
+{{/if}}
+{{#if schemas.perRoute}}
+import { DeclineInvitationBody } from '{{alias.context}}/presentation/http/invitations/decline-invitation/decline-invitation.body{{alias.ext}}';
+{{/if}}
+{{#if schemas.perRoute}}
+import { DeclineInvitationAccepted } from '{{alias.context}}/presentation/http/invitations/decline-invitation/decline-invitation.accepted{{alias.ext}}';
+{{/if}}
+import { InvitationsRoutes } from '{{alias.context}}/presentation/http/invitations.routes{{alias.ext}}';
+{{/if}}
+{{#if validation.zod}}
+{{#if schemas.perRoute}}
+import { z } from 'zod';
+{{/if}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import type { Infer } from '@ddd-ts-kit/validation';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+import { DeclineInvitationCommand } from '{{alias.context}}/application/commands/decline-invitation/decline-invitation.command{{alias.ext}}';
+{{#if schemas.shared}}
+import { invitationTokenSchema } from '{{alias.context}}/presentation/http/shared/invitation-token.schema{{alias.ext}}';
+{{/if}}
+import { InvitationsRoutes } from '{{alias.context}}/presentation/http/invitations.routes{{alias.ext}}';
+{{/if}}
+
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+const body = classSchema(InvitationToken, { shared: true });
+{{/if}}
+{{#if schemas.perRoute}}
+const body = classSchema(DeclineInvitationBody);
+{{/if}}
+{{#if schemas.perRoute}}
+const accepted = classSchema(DeclineInvitationAccepted);
+{{/if}}
+{{/if}}
+{{#if validation.zod}}
+{{#if schemas.shared}}
+const body = zodSchema(invitationTokenSchema);
+{{/if}}
+{{#if schemas.perRoute}}
+const body = zodSchema(
+  z.object({
+    token: z.string().min(1),
+  }),
+);
+{{/if}}
+
+{{#if schemas.perRoute}}
+const accepted = zodSchema(z.object({ id: z.string() }), { io: 'output' });
+{{/if}}
+{{/if}}
+
+@Controller({
+  group: InvitationsRoutes,
+  method: 'POST',
+  path: '/declination',
+  summary: 'Decline an invitation',
+  body,
+  response: { status: 200, description: 'Declined; the body carries the identifier of the invitation.', body: {{#if schemas.shared}}acceptedSchema{{/if}}{{#if schemas.perRoute}}accepted{{/if}} },
+  errors: [
+    'INVITATION_NOT_FOUND',
+    'ACCOUNT_NOT_FOUND',
+    'INVITATION_NOT_PENDING',
+    'INVITATION_EXPIRED',
+    'INVITATION_ADDRESSED_TO_ANOTHER',
+  ],
+})
+export class DeclineInvitationController {
+  constructor(private readonly commands: CommandBus) {}
+
+{{#if validation.classValidator}}
+  async handle(request: HttpRequest<{ body: {{#if schemas.shared}}InvitationToken{{/if}}{{#if schemas.perRoute}}DeclineInvitationBody{{/if}} }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}DeclineInvitationAccepted{{/if}}> {
+{{/if}}
+{{#if validation.zod}}
+  async handle(request: HttpRequest<{ body: Infer<typeof body> }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}Infer<typeof accepted>{{/if}}> {
+{{/if}}
+    const id = await this.commands.execute(new DeclineInvitationCommand(request.actor, request.body.token));
+
+    return { id };
+  }
+}

package/templates/presets/identity/context/presentation/http/invitations.routes.ts.tpl

@@ -0,0 +1,5 @@
+import { Authenticated, RouteGroup } from '@ddd-ts-kit/http';
+
+/** The answers of a person to an invitation sent to them, by its token. */
+@RouteGroup({ prefix: '/invitations', tags: ['{{context.kebab}}'], guards: [Authenticated], errors: ['FORBIDDEN'] })
+export class InvitationsRoutes {}

package/templates/presets/identity/context/presentation/http/organisations/change-member-role/change-member-role.accepted.class-validator.per-route.ts.tpl

@@ -0,0 +1,6 @@
+import { IsString } from 'class-validator';
+
+export class ChangeMemberRoleAccepted {
+  @IsString()
+  id = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/change-member-role/change-member-role.body.class-validator.ts.tpl

@@ -0,0 +1,7 @@
+import { IsIn } from 'class-validator';
+import { MemberRole } from '{{alias.context}}/domain/vocabularies/member-role.vocabulary{{alias.ext}}';
+
+export class ChangeMemberRoleBody {
+  @IsIn(Object.values(MemberRole))
+  role: MemberRole = MemberRole.Member;
+}

package/templates/presets/identity/context/presentation/http/organisations/change-member-role/change-member-role.controller.ts.tpl

@@ -0,0 +1,83 @@
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+import { ChangeMemberRoleCommand } from '{{alias.context}}/application/commands/change-member-role/change-member-role.command{{alias.ext}}';
+import { ChangeMemberRoleParams } from '{{alias.context}}/presentation/http/organisations/change-member-role/change-member-role.params{{alias.ext}}';
+import { ChangeMemberRoleBody } from '{{alias.context}}/presentation/http/organisations/change-member-role/change-member-role.body{{alias.ext}}';
+{{#if schemas.perRoute}}
+import { ChangeMemberRoleAccepted } from '{{alias.context}}/presentation/http/organisations/change-member-role/change-member-role.accepted{{alias.ext}}';
+{{/if}}
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+{{#if validation.zod}}
+import { z } from 'zod';
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import type { Infer } from '@ddd-ts-kit/validation';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+import { ChangeMemberRoleCommand } from '{{alias.context}}/application/commands/change-member-role/change-member-role.command{{alias.ext}}';
+import { MemberRole } from '{{alias.context}}/domain/vocabularies/member-role.vocabulary{{alias.ext}}';
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+
+{{#if validation.classValidator}}
+const params = classSchema(ChangeMemberRoleParams);
+const body = classSchema(ChangeMemberRoleBody);
+{{#if schemas.perRoute}}
+const accepted = classSchema(ChangeMemberRoleAccepted);
+{{/if}}
+{{/if}}
+{{#if validation.zod}}
+const params = zodSchema(
+  z.object({
+    organisationId: z.string().min(1),
+    accountId: z.string().min(1),
+  }),
+);
+
+const body = zodSchema(
+  z.object({
+    role: z.enum(MemberRole),
+  }),
+);
+
+{{#if schemas.perRoute}}
+const accepted = zodSchema(z.object({ id: z.string() }), { io: 'output' });
+{{/if}}
+{{/if}}
+
+@Controller({
+  group: OrganisationsRoutes,
+  method: 'PUT',
+  path: '/:organisationId/members/:accountId/role',
+  summary: 'Change the role of a member',
+  params,
+  body,
+  response: { status: 200, description: 'Changed; the body carries the identifier of the membership.', body: {{#if schemas.shared}}acceptedSchema{{/if}}{{#if schemas.perRoute}}accepted{{/if}} },
+  errors: ['ORGANISATION_NOT_FOUND', 'MEMBER_NOT_FOUND', 'OWN_ROLE', 'ABOVE_OWN_ROLE', 'OWNERS_ONLY', 'LAST_OWNER'],
+})
+export class ChangeMemberRoleController {
+  constructor(private readonly commands: CommandBus) {}
+
+{{#if validation.classValidator}}
+  async handle(request: HttpRequest<{ params: ChangeMemberRoleParams; body: ChangeMemberRoleBody }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}ChangeMemberRoleAccepted{{/if}}> {
+{{/if}}
+{{#if validation.zod}}
+  async handle(request: HttpRequest<{ params: Infer<typeof params>; body: Infer<typeof body> }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}Infer<typeof accepted>{{/if}}> {
+{{/if}}
+    const id = await this.commands.execute(new ChangeMemberRoleCommand(request.actor, request.params.organisationId, request.params.accountId, request.body.role));
+
+    return { id };
+  }
+}

package/templates/presets/identity/context/presentation/http/organisations/change-member-role/change-member-role.params.class-validator.ts.tpl

@@ -0,0 +1,11 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class ChangeMemberRoleParams {
+  @IsString()
+  @IsNotEmpty()
+  organisationId = '';
+
+  @IsString()
+  @IsNotEmpty()
+  accountId = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/grant-delegation/grant-delegation.accepted.class-validator.per-route.ts.tpl

@@ -0,0 +1,6 @@
+import { IsString } from 'class-validator';
+
+export class GrantDelegationAccepted {
+  @IsString()
+  id = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/grant-delegation/grant-delegation.body.class-validator.ts.tpl

@@ -0,0 +1,18 @@
+import { IsArray, IsISO8601, IsIn, IsNotEmpty, IsString } from 'class-validator';
+import { MemberRight } from '{{alias.context}}/domain/vocabularies/member-right.vocabulary{{alias.ext}}';
+
+export class GrantDelegationBody {
+  @IsString()
+  @IsNotEmpty()
+  delegateId = '';
+
+  @IsArray()
+  @IsIn(Object.values(MemberRight), { each: true })
+  rights: MemberRight[] = [];
+
+  @IsISO8601()
+  startsAt = '';
+
+  @IsISO8601()
+  endsAt = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/grant-delegation/grant-delegation.controller.ts.tpl

@@ -0,0 +1,103 @@
+{{#if validation.classValidator}}
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+import { GrantDelegationCommand } from '{{alias.context}}/application/commands/grant-delegation/grant-delegation.command{{alias.ext}}';
+import { GrantDelegationParams } from '{{alias.context}}/presentation/http/organisations/grant-delegation/grant-delegation.params{{alias.ext}}';
+import { GrantDelegationBody } from '{{alias.context}}/presentation/http/organisations/grant-delegation/grant-delegation.body{{alias.ext}}';
+{{#if schemas.perRoute}}
+import { GrantDelegationAccepted } from '{{alias.context}}/presentation/http/organisations/grant-delegation/grant-delegation.accepted{{alias.ext}}';
+{{/if}}
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+{{#if validation.zod}}
+import { z } from 'zod';
+{{#if schemas.shared}}
+import { acceptedSchema, Controller, type Accepted, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+{{#if schemas.perRoute}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+{{/if}}
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import type { Infer } from '@ddd-ts-kit/validation';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+import { GrantDelegationCommand } from '{{alias.context}}/application/commands/grant-delegation/grant-delegation.command{{alias.ext}}';
+import { MemberRight } from '{{alias.context}}/domain/vocabularies/member-right.vocabulary{{alias.ext}}';
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+
+{{#if validation.classValidator}}
+const params = classSchema(GrantDelegationParams);
+const body = classSchema(GrantDelegationBody);
+{{#if schemas.perRoute}}
+const accepted = classSchema(GrantDelegationAccepted);
+{{/if}}
+{{/if}}
+{{#if validation.zod}}
+const params = zodSchema(
+  z.object({
+    organisationId: z.string().min(1),
+  }),
+);
+
+const body = zodSchema(
+  z.object({
+    delegateId: z.string().min(1),
+    rights: z.array(z.enum(MemberRight)).min(1),
+    startsAt: z.iso.datetime(),
+    endsAt: z.iso.datetime(),
+  }),
+);
+
+{{#if schemas.perRoute}}
+const accepted = zodSchema(z.object({ id: z.string() }), { io: 'output' });
+{{/if}}
+{{/if}}
+
+@Controller({
+  group: OrganisationsRoutes,
+  method: 'POST',
+  path: '/:organisationId/delegations',
+  summary: 'Lend rights to a member',
+  params,
+  body,
+  response: { status: 201, description: 'Granted; the body carries the identifier of the delegation.', body: {{#if schemas.shared}}acceptedSchema{{/if}}{{#if schemas.perRoute}}accepted{{/if}} },
+  errors: [
+    'MEMBER_NOT_FOUND',
+    'DELEGATION_TO_ONESELF',
+    'DELEGATION_WITHOUT_RIGHTS',
+    'DELEGATION_BEYOND_RIGHTS',
+    'DELEGATION_PERIOD_INVERTED',
+    'DELEGATION_TOO_LONG',
+  ],
+})
+export class GrantDelegationController {
+  constructor(private readonly commands: CommandBus) {}
+
+{{#if validation.classValidator}}
+  async handle(request: HttpRequest<{ params: GrantDelegationParams; body: GrantDelegationBody }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}GrantDelegationAccepted{{/if}}> {
+{{/if}}
+{{#if validation.zod}}
+  async handle(request: HttpRequest<{ params: Infer<typeof params>; body: Infer<typeof body> }>): Promise<{{#if schemas.shared}}Accepted{{/if}}{{#if schemas.perRoute}}Infer<typeof accepted>{{/if}}> {
+{{/if}}
+    const id = await this.commands.execute(new GrantDelegationCommand(request.actor, request.params.organisationId, termsOf(request.body)));
+
+    return { id };
+  }
+}
+
+{{#if validation.classValidator}}
+function termsOf({ delegateId, rights, startsAt, endsAt }: GrantDelegationBody): GrantDelegationCommand['terms'] {
+  return { delegateId, rights, startsAt: new Date(startsAt), endsAt: new Date(endsAt) };
+}
+{{/if}}
+{{#if validation.zod}}
+function termsOf({ delegateId, rights, startsAt, endsAt }: Infer<typeof body>): GrantDelegationCommand['terms'] {
+  return { delegateId, rights, startsAt: new Date(startsAt), endsAt: new Date(endsAt) };
+}
+{{/if}}

package/templates/presets/identity/context/presentation/http/organisations/grant-delegation/grant-delegation.params.class-validator.ts.tpl

@@ -0,0 +1,7 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class GrantDelegationParams {
+  @IsString()
+  @IsNotEmpty()
+  organisationId = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/invite-member/invite-member.accepted.class-validator.ts.tpl

@@ -0,0 +1,10 @@
+import { IsString } from 'class-validator';
+
+export class InviteMemberAccepted {
+  @IsString()
+  id = '';
+
+  /** The token to send to the person, once: only its digest is stored. */
+  @IsString()
+  token = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/invite-member/invite-member.body.class-validator.ts.tpl

@@ -0,0 +1,10 @@
+import { IsEmail, IsIn } from 'class-validator';
+import { MemberRole } from '{{alias.context}}/domain/vocabularies/member-role.vocabulary{{alias.ext}}';
+
+export class InviteMemberBody {
+  @IsEmail()
+  email = '';
+
+  @IsIn(Object.values(MemberRole))
+  role: MemberRole = MemberRole.Member;
+}

package/templates/presets/identity/context/presentation/http/organisations/invite-member/invite-member.controller.ts.tpl

@@ -0,0 +1,65 @@
+{{#if validation.classValidator}}
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+import { InviteMemberCommand } from '{{alias.context}}/application/commands/invite-member/invite-member.command{{alias.ext}}';
+import { InviteMemberParams } from '{{alias.context}}/presentation/http/organisations/invite-member/invite-member.params{{alias.ext}}';
+import { InviteMemberBody } from '{{alias.context}}/presentation/http/organisations/invite-member/invite-member.body{{alias.ext}}';
+import { InviteMemberAccepted } from '{{alias.context}}/presentation/http/organisations/invite-member/invite-member.accepted{{alias.ext}}';
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+{{#if validation.zod}}
+import { z } from 'zod';
+import { Controller, type HttpRequest } from '@ddd-ts-kit/http';
+import type { CommandBus } from '@ddd-ts-kit/kernel';
+import type { Infer } from '@ddd-ts-kit/validation';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+import { InviteMemberCommand } from '{{alias.context}}/application/commands/invite-member/invite-member.command{{alias.ext}}';
+import { MemberRole } from '{{alias.context}}/domain/vocabularies/member-role.vocabulary{{alias.ext}}';
+import { OrganisationsRoutes } from '{{alias.context}}/presentation/http/organisations.routes{{alias.ext}}';
+{{/if}}
+
+{{#if validation.classValidator}}
+const params = classSchema(InviteMemberParams);
+const body = classSchema(InviteMemberBody);
+const accepted = classSchema(InviteMemberAccepted);
+{{/if}}
+{{#if validation.zod}}
+const params = zodSchema(
+  z.object({
+    organisationId: z.string().min(1),
+  }),
+);
+
+const body = zodSchema(
+  z.object({
+    email: z.email(),
+    role: z.enum(MemberRole),
+  }),
+);
+
+const accepted = zodSchema(z.object({ id: z.string(), token: z.string() }), { io: 'output' });
+{{/if}}
+
+@Controller({
+  group: OrganisationsRoutes,
+  method: 'POST',
+  path: '/:organisationId/invitations',
+  summary: 'Invite a person to the organisation',
+  params,
+  body,
+  response: { status: 201, description: 'Issued; the body carries the token to send to the person, given once and never stored.', body: accepted },
+  errors: ['INVALID_EMAIL_ADDRESS', 'ABOVE_OWN_ROLE', 'OWNERS_ONLY'],
+})
+export class InviteMemberController {
+  constructor(private readonly commands: CommandBus) {}
+
+{{#if validation.classValidator}}
+  async handle(request: HttpRequest<{ params: InviteMemberParams; body: InviteMemberBody }>): Promise<InviteMemberAccepted> {
+{{/if}}
+{{#if validation.zod}}
+  async handle(request: HttpRequest<{ params: Infer<typeof params>; body: Infer<typeof body> }>): Promise<Infer<typeof accepted>> {
+{{/if}}
+    return this.commands.execute(new InviteMemberCommand(request.actor, request.params.organisationId, request.body));
+  }
+}

package/templates/presets/identity/context/presentation/http/organisations/invite-member/invite-member.params.class-validator.ts.tpl

@@ -0,0 +1,7 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class InviteMemberParams {
+  @IsString()
+  @IsNotEmpty()
+  organisationId = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/open-organisation/open-organisation.accepted.class-validator.per-route.ts.tpl

@@ -0,0 +1,6 @@
+import { IsString } from 'class-validator';
+
+export class OpenOrganisationAccepted {
+  @IsString()
+  id = '';
+}

package/templates/presets/identity/context/presentation/http/organisations/open-organisation/open-organisation.body.class-validator.ts.tpl

@@ -0,0 +1,12 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class OpenOrganisationBody {
+  /** Lower-case letters, digits and hyphens: the identifier of the organisation, for good. */
+  @IsString()
+  @IsNotEmpty()
+  slug = '';
+
+  @IsString()
+  @IsNotEmpty()
+  name = '';
+}