B2B-88: add starter kit structure and elements

packages/mailers/core/README.md

@@ -0,0 +1,3 @@
+# Mailers - @kit/mailers
+
+This package provides a proxy to use the registered mailer in the application.

packages/mailers/core/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/mailers/core/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/mailers/core/node_modules/@kit/mailers-shared

@@ -0,0 +1 @@
+../../../shared

packages/mailers/core/node_modules/@kit/nodemailer

@@ -0,0 +1 @@
+../../../nodemailer

packages/mailers/core/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/mailers/core/node_modules/@kit/resend

@@ -0,0 +1 @@
+../../../resend

packages/mailers/core/node_modules/@kit/shared

@@ -0,0 +1 @@
+../../../../shared

packages/mailers/core/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/mailers/core/node_modules/@types/node

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+node@22.15.30/node_modules/@types/node

packages/mailers/core/node_modules/zod

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/zod@3.25.56/node_modules/zod

packages/mailers/core/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@kit/mailers",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "devDependencies": {
+    "@kit/eslint-config": "workspace:*",
+    "@kit/mailers-shared": "workspace:*",
+    "@kit/nodemailer": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/resend": "workspace:*",
+    "@kit/shared": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/node": "^22.15.18",
+    "zod": "^3.24.4"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/mailers/core/src/index.ts

@@ -0,0 +1,12 @@
+import { MAILER_PROVIDER } from './provider-enum';
+import { mailerRegistry } from './registry';
+
+/**
+ * @name getMailer
+ * @description Get the mailer based on the environment variable using the registry internally.
+ */
+export function getMailer() {
+  return mailerRegistry.get(MAILER_PROVIDER);
+}
+
+export { MAILER_PROVIDER };

packages/mailers/core/src/provider-enum.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+const MAILER_PROVIDERS = [
+  'nodemailer',
+  'resend',
+  // add more providers here
+] as const;
+
+const MAILER_PROVIDER = z
+  .enum(MAILER_PROVIDERS)
+  .default('nodemailer')
+  .parse(process.env.MAILER_PROVIDER);
+
+export { MAILER_PROVIDER };
+
+export type MailerProvider = (typeof MAILER_PROVIDERS)[number];

packages/mailers/core/src/registry.ts

@@ -0,0 +1,26 @@
+import { Mailer } from '@kit/mailers-shared';
+import { createRegistry } from '@kit/shared/registry';
+
+import { MailerProvider } from './provider-enum';
+
+const mailerRegistry = createRegistry<Mailer, MailerProvider>();
+
+mailerRegistry.register('nodemailer', async () => {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    const { createNodemailerService } = await import('@kit/nodemailer');
+
+    return createNodemailerService();
+  } else {
+    throw new Error(
+      'Nodemailer is not available on the edge runtime. Please use another mailer.',
+    );
+  }
+});
+
+mailerRegistry.register('resend', async () => {
+  const { createResendMailer } = await import('@kit/resend');
+
+  return createResendMailer();
+});
+
+export { mailerRegistry };

packages/mailers/core/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}