create-forgeon 0.3.24 → 0.3.26

package/templates/module-presets/accounts-communications/packages/accounts-communications/src/pending-verification-register.handler.ts

@@ -0,0 +1,13 @@
+import { Injectable } from '@nestjs/common';
+import type { RegisterRequest, RegisterResult } from '@forgeon/accounts-contracts';
+import type { RegisterHandler } from '@forgeon/accounts-api';
+import { AuthCommunicationsService } from './auth-communications.service';
+
+@Injectable()
+export class PendingVerificationRegisterHandler implements RegisterHandler {
+  constructor(private readonly authCommunicationsService: AuthCommunicationsService) {}
+
+  execute(input: RegisterRequest): Promise<RegisterResult> {
+    return this.authCommunicationsService.registerWithPendingVerification(input);
+  }
+}

package/templates/module-presets/accounts-communications/packages/accounts-communications/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.node.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/module-presets/communications/packages/communications/src/communications-config.loader.ts

@@ -31,12 +31,13 @@ export const communicationsConfig = registerAs(
   COMMUNICATIONS_CONFIG_NAMESPACE,
   (): CommunicationsConfigValues => {
     const env = parseCommunicationsEnv(process.env as unknown as Record<string, unknown>);
+    const derivedFrom = env.COMMUNICATIONS_EMAIL_FROM || env.COMMUNICATIONS_EMAIL_SMTP_USER;
 
     return {
       templatesRoot: path.resolve(process.cwd(), env.COMMUNICATIONS_TEMPLATES_ROOT),
       email: {
         provider: env.COMMUNICATIONS_EMAIL_PROVIDER,
-        from: env.COMMUNICATIONS_EMAIL_FROM,
+        from: derivedFrom,
         replyTo: env.COMMUNICATIONS_EMAIL_REPLY_TO || null,
         subjectPrefix: env.COMMUNICATIONS_EMAIL_SUBJECT_PREFIX || null,
         smtp: {

package/templates/module-presets/communications/packages/communications/src/communications-env.schema.ts

@@ -1,19 +1,35 @@
-import { z } from 'zod';
+import { z } from 'zod';
+
+function normalizeEnvBoolean(value: unknown): unknown {
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    if (['true', '1', 'yes', 'on'].includes(normalized)) {
+      return true;
+    }
+    if (['false', '0', 'no', 'off', ''].includes(normalized)) {
+      return false;
+    }
+  }
+
+  return value;
+}
+
+const envBoolean = z.preprocess(normalizeEnvBoolean, z.boolean());
 
 export const communicationsEnvSchema = z
   .object({
     COMMUNICATIONS_TEMPLATES_ROOT: z.string().trim().min(1).default('resources/communications'),
     COMMUNICATIONS_EMAIL_PROVIDER: z.enum(['gmail-smtp']).default('gmail-smtp'),
-    COMMUNICATIONS_EMAIL_FROM: z.string().trim().min(1).default('Forgeon <no-reply@example.com>'),
+    COMMUNICATIONS_EMAIL_FROM: z.string().trim().default(''),
     COMMUNICATIONS_EMAIL_REPLY_TO: z.string().trim().default(''),
     COMMUNICATIONS_EMAIL_SUBJECT_PREFIX: z.string().trim().default('[Forgeon]'),
     COMMUNICATIONS_EMAIL_SMTP_HOST: z.string().trim().min(1).default('smtp.gmail.com'),
     COMMUNICATIONS_EMAIL_SMTP_PORT: z.coerce.number().int().min(1).max(65535).default(587),
-    COMMUNICATIONS_EMAIL_SMTP_SECURE: z.coerce.boolean().default(false),
+    COMMUNICATIONS_EMAIL_SMTP_SECURE: envBoolean.default(false),
     COMMUNICATIONS_EMAIL_SMTP_USER: z.string().trim().default(''),
     COMMUNICATIONS_EMAIL_SMTP_PASS: z.string().trim().default(''),
     COMMUNICATIONS_SMS_PROVIDER: z.enum(['stub']).default('stub'),
-    COMMUNICATIONS_PUSH_PROVIDER: z.enum(['stub']).default('stub')
+    COMMUNICATIONS_PUSH_PROVIDER: z.enum(['stub']).default('stub'),
   })
   .passthrough();
 
@@ -21,4 +37,4 @@ export type CommunicationsEnv = z.infer<typeof communicationsEnvSchema>;
 
 export function parseCommunicationsEnv(input: Record<string, unknown>): CommunicationsEnv {
   return communicationsEnvSchema.parse(input);
-}
+}

package/templates/module-presets/communications/packages/communications/src/email/providers/gmail-smtp-email.provider.ts

@@ -6,6 +6,7 @@ import type { EmailProvider, EmailProviderSendInput, EmailProviderSendResult } f
 
 const EMAIL_ERROR_CODES = {
   providerNotConfigured: 'COMMUNICATIONS_EMAIL_PROVIDER_NOT_CONFIGURED',
+  providerSendFailed: 'COMMUNICATIONS_EMAIL_PROVIDER_SEND_FAILED',
 } as const;
 
 @Injectable()
@@ -30,20 +31,33 @@ export class GmailSmtpEmailProvider implements EmailProvider {
       });
     }
 
-    const response = await this.getTransporter().sendMail({
-      from: this.configService.emailFrom,
-      to: input.to,
-      subject: input.subject,
-      html: input.html,
-      replyTo: input.replyTo ?? this.configService.emailReplyTo ?? undefined,
-    });
+    try {
+      const response = await this.getTransporter().sendMail({
+        from: this.configService.emailFrom,
+        to: input.to,
+        subject: input.subject,
+        html: input.html,
+        replyTo: input.replyTo ?? this.configService.emailReplyTo ?? undefined,
+      });
 
-    this.logger.log(`email.sent provider=${this.providerId} to=${input.to} messageId=${response.messageId ?? 'n/a'}`);
+      this.logger.log(`email.sent provider=${this.providerId} to=${input.to} messageId=${response.messageId ?? 'n/a'}`);
 
-    return {
-      status: 'sent',
-      messageId: response.messageId ?? null,
-    };
+      return {
+        status: 'sent',
+        messageId: response.messageId ?? null,
+      };
+    } catch (error) {
+      const details = this.extractErrorDetails(error);
+      this.logger.error(`email.failed provider=${this.providerId} to=${input.to} details=${JSON.stringify(details)}`);
+      throw new ServiceUnavailableException({
+        message: 'Email delivery failed',
+        details: {
+          code: EMAIL_ERROR_CODES.providerSendFailed,
+          provider: this.providerId,
+          ...details,
+        },
+      });
+    }
   }
 
   private getTransporter(): Transporter {
@@ -61,4 +75,30 @@ export class GmailSmtpEmailProvider implements EmailProvider {
 
     return this.transporter;
   }
+
+  private extractErrorDetails(error: unknown): Record<string, unknown> {
+    if (!error || typeof error !== 'object') {
+      return { raw: String(error) };
+    }
+
+    const candidate = error as {
+      code?: unknown;
+      command?: unknown;
+      response?: unknown;
+      responseCode?: unknown;
+      errno?: unknown;
+      syscall?: unknown;
+      message?: unknown;
+    };
+
+    return {
+      message: typeof candidate.message === 'string' ? candidate.message : String(error),
+      code: candidate.code ?? null,
+      command: candidate.command ?? null,
+      responseCode: candidate.responseCode ?? null,
+      response: candidate.response ?? null,
+      errno: candidate.errno ?? null,
+      syscall: candidate.syscall ?? null,
+    };
+  }
 }

package/templates/module-presets/communications/packages/communications/src/forgeon-communications.module.ts

@@ -1,4 +1,4 @@
-import { DynamicModule, Module, ModuleMetadata } from '@nestjs/common';
+import { DynamicModule, Global, Module, ModuleMetadata } from '@nestjs/common';
 import {
   COMMUNICATIONS_EMAIL_PROVIDER,
   COMMUNICATIONS_PUSH_PROVIDER,
@@ -20,6 +20,7 @@ export interface ForgeonCommunicationsModuleOptions {
   imports?: ModuleMetadata['imports'];
 }
 
+@Global()
 @Module({})
 export class ForgeonCommunicationsModule {
   static register(options: ForgeonCommunicationsModuleOptions = {}): DynamicModule {