@takaro/email 0.0.1

package/dist/config.d.ts

@@ -0,0 +1,49 @@
+import { Config, IBaseConfig } from '@takaro/config';
+export interface IMailConfig extends IBaseConfig {
+    mail: {
+        host: string;
+        port: number;
+        secure: boolean;
+        auth: {
+            user: string;
+            pass: string;
+        };
+    };
+}
+export declare const configSchema: {
+    mail: {
+        host: {
+            doc: string;
+            format: StringConstructor;
+            default: string;
+            env: string;
+        };
+        port: {
+            doc: string;
+            format: NumberConstructor;
+            default: number;
+            env: string;
+        };
+        secure: {
+            doc: string;
+            format: BooleanConstructor;
+            default: boolean;
+            env: string;
+        };
+        auth: {
+            user: {
+                doc: string;
+                format: StringConstructor;
+                default: string;
+                env: string;
+            };
+            pass: {
+                doc: string;
+                format: StringConstructor;
+                default: string;
+                env: string;
+            };
+        };
+    };
+};
+export declare const config: Config<IMailConfig>;

package/dist/config.js

@@ -0,0 +1,39 @@
+import { Config } from '@takaro/config';
+export const configSchema = {
+    mail: {
+        host: {
+            doc: 'The host of the mail server.',
+            format: String,
+            default: 'mailhog',
+            env: 'MAIL_HOST',
+        },
+        port: {
+            doc: 'The port of the mail server.',
+            format: Number,
+            default: 1025,
+            env: 'MAIL_PORT',
+        },
+        secure: {
+            doc: 'Whether to use TLS or not.',
+            format: Boolean,
+            default: false,
+            env: 'MAIL_SECURE',
+        },
+        auth: {
+            user: {
+                doc: 'The username to use for authentication.',
+                format: String,
+                default: 'test',
+                env: 'MAIL_USER',
+            },
+            pass: {
+                doc: 'The password to use for authentication.',
+                format: String,
+                default: 'test',
+                env: 'MAIL_PASS',
+            },
+        },
+    },
+};
+export const config = new Config([configSchema]);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,MAAM,gBAAgB,CAAC;AAcrD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,GAAG,EAAE,8BAA8B;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,SAAS;YAClB,GAAG,EAAE,WAAW;SACjB;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,8BAA8B;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,WAAW;SACjB;QACD,MAAM,EAAE;YACN,GAAG,EAAE,4BAA4B;YACjC,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,aAAa;SACnB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,GAAG,EAAE,yCAAyC;gBAC9C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,MAAM;gBACf,GAAG,EAAE,WAAW;aACjB;YACD,IAAI,EAAE;gBACJ,GAAG,EAAE,yCAAyC;gBAC9C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,MAAM;gBACf,GAAG,EAAE,WAAW;aACjB;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAc,CAAC,YAAY,CAAC,CAAC,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export { send } from './send.js';
+export { EMAIL_TEMPLATES } from './templates.js';

package/dist/main.js

@@ -0,0 +1,3 @@
+export { send } from './send.js';
+export { EMAIL_TEMPLATES } from './templates.js';
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/send.d.ts

@@ -0,0 +1,8 @@
+import { EMAIL_TEMPLATES } from './templates.js';
+export interface ISendOptions {
+    address: string;
+    template: keyof typeof EMAIL_TEMPLATES;
+    data: Record<string, unknown>;
+}
+export declare const transporter: import("nodemailer").Transporter<import("nodemailer/lib/smtp-transport/index.js").SentMessageInfo>;
+export declare function send(opts: ISendOptions): Promise<import("nodemailer/lib/smtp-transport/index.js").SentMessageInfo>;

package/dist/send.js

@@ -0,0 +1,23 @@
+import { errors, logger } from '@takaro/util';
+import { createTransport } from 'nodemailer';
+import { EMAIL_TEMPLATES } from './templates.js';
+import { config } from './config.js';
+const log = logger('email:send');
+export const transporter = createTransport(config.get('mail'));
+export async function send(opts) {
+    const template = EMAIL_TEMPLATES[opts.template];
+    if (!template) {
+        log.error(`Template ${opts.template} does not exist`);
+        throw new errors.InternalServerError();
+    }
+    const html = template.body(opts.data);
+    const result = await transporter.sendMail({
+        from: '"noreply@takaro.io" <noreply@takaro.io>',
+        to: opts.address,
+        subject: template.subject,
+        html,
+    });
+    log.info('Sent an email', { ...opts });
+    return result;
+}
+//# sourceMappingURL=send.js.map

package/dist/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAkB;IAC3C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,QAAQ,iBAAiB,CAAC,CAAC;QACtD,MAAM,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC;QACxC,IAAI,EAAE,yCAAyC;QAC/C,EAAE,EAAE,IAAI,CAAC,OAAO;QAChB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI;KACL,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/templates.d.ts

@@ -0,0 +1,7 @@
+import ejs from 'ejs';
+export declare const EMAIL_TEMPLATES: {
+    invite: {
+        subject: string;
+        body: ejs.TemplateFunction;
+    };
+};

package/dist/templates.js

@@ -0,0 +1,12 @@
+import ejs from 'ejs';
+export const EMAIL_TEMPLATES = {
+    invite: {
+        subject: 'You have been invited to Takaro',
+        body: ejs.compile(`
+      <h1>You have been invited to Takaro.</h1>
+      
+      <p>Click <a href="<%= inviteLink %>">here</a> to sign up.</p>
+      `),
+    },
+};
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE;QACN,OAAO,EAAE,iCAAiC;QAC1C,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC;;;;OAIf,CAAC;KACL;CACF,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@takaro/email",
+  "version": "0.0.1",
+  "description": "",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "type": "module",
+  "scripts": {
+    "start:dev": "tsc --watch --preserveWatchOutput -p ./tsconfig.build.json",
+    "build": "tsc -p ./tsconfig.build.json",
+    "test": "npm run test:unit --if-present && npm run test:integration --if-present",
+    "test:unit": "echo 'No tests (yet :))'",
+    "test:integration": "echo 'No tests (yet :))'"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@takaro/config": "0.0.1",
+    "@takaro/util": "0.0.1",
+    "ejs": "^3.1.9",
+    "nodemailer": "^6.9.3"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.2",
+    "@types/nodemailer": "^6.4.8"
+  }
+}

package/src/config.ts

@@ -0,0 +1,52 @@
+import { Config, IBaseConfig } from '@takaro/config';
+
+export interface IMailConfig extends IBaseConfig {
+  mail: {
+    host: string;
+    port: number;
+    secure: boolean;
+    auth: {
+      user: string;
+      pass: string;
+    };
+  };
+}
+
+export const configSchema = {
+  mail: {
+    host: {
+      doc: 'The host of the mail server.',
+      format: String,
+      default: 'mailhog',
+      env: 'MAIL_HOST',
+    },
+    port: {
+      doc: 'The port of the mail server.',
+      format: Number,
+      default: 1025,
+      env: 'MAIL_PORT',
+    },
+    secure: {
+      doc: 'Whether to use TLS or not.',
+      format: Boolean,
+      default: false,
+      env: 'MAIL_SECURE',
+    },
+    auth: {
+      user: {
+        doc: 'The username to use for authentication.',
+        format: String,
+        default: 'test',
+        env: 'MAIL_USER',
+      },
+      pass: {
+        doc: 'The password to use for authentication.',
+        format: String,
+        default: 'test',
+        env: 'MAIL_PASS',
+      },
+    },
+  },
+};
+
+export const config = new Config<IMailConfig>([configSchema]);

package/src/main.ts

@@ -0,0 +1,3 @@
+export { send } from './send.js';
+
+export { EMAIL_TEMPLATES } from './templates.js';

package/src/send.ts

@@ -0,0 +1,35 @@
+import { errors, logger } from '@takaro/util';
+import { createTransport } from 'nodemailer';
+import { EMAIL_TEMPLATES } from './templates.js';
+
+import { config } from './config.js';
+
+export interface ISendOptions {
+  address: string;
+  template: keyof typeof EMAIL_TEMPLATES;
+  data: Record<string, unknown>;
+}
+
+const log = logger('email:send');
+export const transporter = createTransport(config.get('mail'));
+
+export async function send(opts: ISendOptions) {
+  const template = EMAIL_TEMPLATES[opts.template];
+
+  if (!template) {
+    log.error(`Template ${opts.template} does not exist`);
+    throw new errors.InternalServerError();
+  }
+
+  const html = template.body(opts.data);
+
+  const result = await transporter.sendMail({
+    from: '"noreply@takaro.io" <noreply@takaro.io>',
+    to: opts.address,
+    subject: template.subject,
+    html,
+  });
+
+  log.info('Sent an email', { ...opts });
+  return result;
+}

package/src/templates.ts

@@ -0,0 +1,12 @@
+import ejs from 'ejs';
+
+export const EMAIL_TEMPLATES = {
+  invite: {
+    subject: 'You have been invited to Takaro',
+    body: ejs.compile(`
+      <h1>You have been invited to Takaro.</h1>
+      
+      <p>Click <a href="<%= inviteLink %>">here</a> to sign up.</p>
+      `),
+  },
+};

package/tsconfig.build.json

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

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.esm.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}

package/typedoc.json

@@ -0,0 +1,3 @@
+{
+  "entryPoints": ["src/main.ts"]
+}