@open-kingdom/shared-backend-feature-email 0.0.2-10

package/.spec.swcrc

@@ -0,0 +1,22 @@
+{
+  "jsc": {
+    "target": "es2017",
+    "parser": {
+      "syntax": "typescript",
+      "decorators": true,
+      "dynamicImport": true
+    },
+    "transform": {
+      "decoratorMetadata": true,
+      "legacyDecorator": true
+    },
+    "keepClassNames": true,
+    "externalHelpers": true,
+    "loose": true
+  },
+  "module": {
+    "type": "es6"
+  },
+  "sourceMaps": true,
+  "exclude": []
+}

package/README.md

@@ -0,0 +1,11 @@
+# feature-email-integration
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build feature-email-integration` to build the library.
+
+## Running unit tests
+
+Run `nx test feature-email-integration` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { EmailModule } from './lib/email.js';
+export type { EmailModuleOptions } from './lib/email.js';
+export { EMAIL_PROVIDER } from './lib/email.types.js';
+export type { EmailProvider, EmailMessage, EmailResult, } from './lib/email.types.js';
+export { EmailService } from './lib/email.service.js';
+export { EmailController } from './lib/email.controller.js';
+export { SendEmailDto, SendEmailResponseDto } from './lib/email.dto.js';
+export { GmailProvider } from './lib/providers/index.js';
+export type { GmailProviderConfig } from './lib/providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { EmailModule } from './lib/email.js';
+export { EMAIL_PROVIDER } from './lib/email.types.js';
+export { EmailService } from './lib/email.service.js';
+export { EmailController } from './lib/email.controller.js';
+export { SendEmailDto, SendEmailResponseDto } from './lib/email.dto.js';
+export { GmailProvider } from './lib/providers/index.js';

package/dist/lib/email.controller.d.ts

@@ -0,0 +1,8 @@
+import { EmailService } from './email.service.js';
+import { SendEmailDto, SendEmailResponseDto } from './email.dto.js';
+export declare class EmailController {
+    private emailService;
+    constructor(emailService: EmailService);
+    sendEmail(dto: SendEmailDto): Promise<SendEmailResponseDto>;
+}
+//# sourceMappingURL=email.controller.d.ts.map

package/dist/lib/email.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.controller.d.ts","sourceRoot":"","sources":["../../src/lib/email.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,qBAEa,eAAe;IAEd,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IA2BxC,SAAS,CAAS,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAG1E"}

package/dist/lib/email.controller.js

@@ -0,0 +1,53 @@
+import { __decorate, __metadata, __param } from "tslib";
+import { Controller, Post, Body } from '@nestjs/common';
+import { ApiTags, ApiOperation, ApiBody, ApiResponse } from '@nestjs/swagger';
+import { EmailService } from './email.service.js';
+import { SendEmailDto, SendEmailResponseDto } from './email.dto.js';
+let EmailController = class EmailController {
+    /* c8 ignore next */
+    constructor(emailService) {
+        this.emailService = emailService;
+    }
+    /* c8 ignore next */
+    async sendEmail(dto) {
+        return this.emailService.send(dto);
+    }
+};
+__decorate([
+    ApiOperation({
+        summary: 'Send test email',
+        description: 'Send a test email via Gmail API',
+    }),
+    ApiBody({
+        type: SendEmailDto,
+        description: 'Email details',
+        examples: {
+            test: {
+                summary: 'Test email',
+                value: {
+                    to: 'test@example.com',
+                    subject: 'Test Subject',
+                    body: 'Hello, this is a test email.',
+                },
+            },
+        },
+    }),
+    ApiResponse({
+        status: 201,
+        description: 'Email sent successfully',
+        type: SendEmailResponseDto,
+    }),
+    Post('send')
+    /* c8 ignore next */
+    ,
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [SendEmailDto]),
+    __metadata("design:returntype", Promise)
+], EmailController.prototype, "sendEmail", null);
+EmailController = __decorate([
+    ApiTags('Email'),
+    Controller('email'),
+    __metadata("design:paramtypes", [EmailService])
+], EmailController);
+export { EmailController };

package/dist/lib/email.d.ts

@@ -0,0 +1,12 @@
+import { DynamicModule } from '@nestjs/common';
+import { GmailProviderConfig } from './providers/gmail.provider.js';
+export { EMAIL_PROVIDER } from './email.types.js';
+export type { EmailMessage, EmailResult, EmailProvider, } from './email.types.js';
+export type EmailModuleOptions = {
+    provider: 'gmail';
+    config: GmailProviderConfig;
+};
+export declare class EmailModule {
+    static forRoot(options: EmailModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/lib/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/lib/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAEL,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAGF,qBACa,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;CAoB3D"}

package/dist/lib/email.dto.d.ts

@@ -0,0 +1,11 @@
+export declare class SendEmailDto {
+    to: string;
+    subject: string;
+    body: string;
+}
+export declare class SendEmailResponseDto {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}
+//# sourceMappingURL=email.dto.d.ts.map

package/dist/lib/email.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.dto.d.ts","sourceRoot":"","sources":["../../src/lib/email.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAMvB,EAAE,EAAG,MAAM,CAAC;IAMZ,OAAO,EAAG,MAAM,CAAC;IAMjB,IAAI,EAAG,MAAM,CAAC;CACf;AAED,qBAAa,oBAAoB;IAK/B,OAAO,EAAG,OAAO,CAAC;IAOlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/lib/email.dto.js

@@ -0,0 +1,51 @@
+import { __decorate, __metadata } from "tslib";
+import { ApiProperty } from '@nestjs/swagger';
+export class SendEmailDto {
+}
+__decorate([
+    ApiProperty({
+        description: 'Recipient email address',
+        example: 'recipient@example.com',
+        format: 'email',
+    }),
+    __metadata("design:type", String)
+], SendEmailDto.prototype, "to", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Email subject line',
+        example: 'Test Email Subject',
+    }),
+    __metadata("design:type", String)
+], SendEmailDto.prototype, "subject", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Email body content',
+        example: 'Hello, this is a test email.',
+    }),
+    __metadata("design:type", String)
+], SendEmailDto.prototype, "body", void 0);
+export class SendEmailResponseDto {
+}
+__decorate([
+    ApiProperty({
+        description: 'Whether the email was sent successfully',
+        example: true,
+    }),
+    __metadata("design:type", Boolean)
+], SendEmailResponseDto.prototype, "success", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Gmail message ID if successful',
+        example: '18c1234567890abc',
+        required: false,
+    }),
+    __metadata("design:type", String)
+], SendEmailResponseDto.prototype, "messageId", void 0);
+__decorate([
+    ApiProperty({
+        description: 'Error message if failed',
+        example: 'Invalid recipient address',
+        required: false,
+    }),
+    __metadata("design:type", String)
+], SendEmailResponseDto.prototype, "error", void 0);

package/dist/lib/email.js

@@ -0,0 +1,35 @@
+var EmailModule_1;
+import { __decorate } from "tslib";
+import { Module } from '@nestjs/common';
+import { GmailProvider, } from './providers/gmail.provider.js';
+import { EmailService } from './email.service.js';
+import { EmailController } from './email.controller.js';
+import { EMAIL_PROVIDER } from './email.types.js';
+export { EMAIL_PROVIDER } from './email.types.js';
+// Module
+let EmailModule = EmailModule_1 = class EmailModule {
+    static forRoot(options) {
+        return {
+            module: EmailModule_1,
+            global: true,
+            controllers: [EmailController],
+            providers: [
+                {
+                    provide: EMAIL_PROVIDER,
+                    useFactory: () => {
+                        switch (options.provider) {
+                            case 'gmail':
+                                return new GmailProvider(options.config);
+                        }
+                    },
+                },
+                EmailService,
+            ],
+            exports: [EmailService],
+        };
+    }
+};
+EmailModule = EmailModule_1 = __decorate([
+    Module({})
+], EmailModule);
+export { EmailModule };

package/dist/lib/email.service.d.ts

@@ -0,0 +1,8 @@
+import type { EmailProvider } from './email.types.js';
+import { SendEmailDto, SendEmailResponseDto } from './email.dto.js';
+export declare class EmailService {
+    private readonly emailProvider;
+    constructor(emailProvider: EmailProvider);
+    send(dto: SendEmailDto): Promise<SendEmailResponseDto>;
+}
+//# sourceMappingURL=email.service.d.ts.map

package/dist/lib/email.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.d.ts","sourceRoot":"","sources":["../../src/lib/email.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,qBACa,YAAY;IAEG,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAGjE,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAY7D"}

package/dist/lib/email.service.js

@@ -0,0 +1,27 @@
+import { __decorate, __metadata, __param } from "tslib";
+import { Injectable, Inject } from '@nestjs/common';
+import { EMAIL_PROVIDER } from './email.types.js';
+let EmailService = class EmailService {
+    constructor(emailProvider) {
+        this.emailProvider = emailProvider;
+    }
+    async send(dto) {
+        try {
+            const result = await this.emailProvider.send({
+                to: [dto.to],
+                subject: dto.subject,
+                text: dto.body,
+            });
+            return { success: true, messageId: result.messageId };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+};
+EmailService = __decorate([
+    Injectable(),
+    __param(0, Inject(EMAIL_PROVIDER)),
+    __metadata("design:paramtypes", [Object])
+], EmailService);
+export { EmailService };

package/dist/lib/email.types.d.ts

@@ -0,0 +1,15 @@
+export interface EmailMessage {
+    to: string[];
+    from?: string;
+    subject: string;
+    text?: string;
+    html?: string;
+}
+export interface EmailResult {
+    messageId?: string;
+}
+export interface EmailProvider {
+    send(message: EmailMessage): Promise<EmailResult>;
+}
+export declare const EMAIL_PROVIDER: unique symbol;
+//# sourceMappingURL=email.types.d.ts.map

package/dist/lib/email.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.types.d.ts","sourceRoot":"","sources":["../../src/lib/email.types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACnD;AAGD,eAAO,MAAM,cAAc,eAA2B,CAAC"}

package/dist/lib/email.types.js

@@ -0,0 +1,2 @@
+// DI token
+export const EMAIL_PROVIDER = Symbol('EMAIL_PROVIDER');

package/dist/lib/providers/gmail.provider.d.ts

@@ -0,0 +1,15 @@
+import { EmailMessage, EmailResult, EmailProvider } from '../email.js';
+export interface GmailProviderConfig {
+    clientEmail: string;
+    privateKey: string;
+    impersonateEmail: string;
+}
+export declare class GmailProvider implements EmailProvider {
+    private client;
+    private defaultFrom;
+    constructor(config: GmailProviderConfig);
+    send(message: EmailMessage): Promise<EmailResult>;
+    private buildRawMessage;
+    private toBase64Url;
+}
+//# sourceMappingURL=gmail.provider.d.ts.map

package/dist/lib/providers/gmail.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.provider.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/gmail.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,mBAAmB;IAYjC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAWvD,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/lib/providers/gmail.provider.js

@@ -0,0 +1,43 @@
+import { gmail, auth } from '@googleapis/gmail';
+export class GmailProvider {
+    constructor(config) {
+        const jwt = new auth.JWT({
+            email: config.clientEmail,
+            key: config.privateKey.replace(/\\n/g, '\n'),
+            scopes: ['https://www.googleapis.com/auth/gmail.send'],
+            subject: config.impersonateEmail,
+        });
+        this.client = gmail({ version: 'v1', auth: jwt });
+        this.defaultFrom = config.impersonateEmail;
+    }
+    async send(message) {
+        const raw = this.buildRawMessage(message);
+        const res = await this.client.users.messages.send({
+            userId: 'me',
+            requestBody: { raw },
+        });
+        return { messageId: res.data.id || undefined };
+    }
+    buildRawMessage(message) {
+        const from = message.from || this.defaultFrom;
+        const to = message.to.join(', ');
+        const contentType = message.html ? 'text/html' : 'text/plain';
+        const body = message.html || message.text || '';
+        const headers = [
+            `From: ${from}`,
+            `To: ${to}`,
+            `Subject: ${message.subject}`,
+            'MIME-Version: 1.0',
+            `Content-Type: ${contentType}; charset=UTF-8`,
+        ].join('\r\n');
+        const rawMessage = `${headers}\r\n\r\n${body}`;
+        return this.toBase64Url(rawMessage);
+    }
+    toBase64Url(str) {
+        return Buffer.from(str)
+            .toString('base64')
+            .replace(/\+/g, '-')
+            .replace(/\//g, '_')
+            .replace(/=+$/, '');
+    }
+}

package/dist/lib/providers/index.d.ts

@@ -0,0 +1,3 @@
+export { GmailProvider } from './gmail.provider.js';
+export type { GmailProviderConfig } from './gmail.provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/providers/index.js

@@ -0,0 +1 @@
+export { GmailProvider } from './gmail.provider.js';