@technomoron/mail-magic 1.0.4

package/dist/store/envloader.js

@@ -0,0 +1,116 @@
+import { defineEnvOptions } from '@technomoron/env-loader';
+export const envOptions = defineEnvOptions({
+    NODE_ENV: {
+        description: 'Specifies the environment in which the app is running',
+        options: ['development', 'production', 'staging'],
+        default: 'development'
+    },
+    API_PORT: {
+        description: 'Defines the port on which the app listens. Default 3780',
+        default: '3776',
+        type: 'number'
+    },
+    API_HOST: {
+        description: 'Sets the local IP address for the API to listen at',
+        default: '0.0.0.0'
+    },
+    DB_AUTO_RELOAD: {
+        description: 'Reload init-data.db automatically on change',
+        type: 'boolean',
+        default: true
+    },
+    DB_FORCE_SYNC: {
+        description: 'Whether to force sync on table definitions (ALTER TABLE)',
+        type: 'boolean',
+        default: false
+    },
+    API_URL: {
+        description: 'Sets the public URL for the API (i.e. https://ml.example.com:3790)',
+        default: 'http://localhost:3776'
+    },
+    CONFIG_PATH: {
+        description: 'Path to directory where config files are located',
+        default: './config/'
+    },
+    /*
+    SWAGGER_ENABLE: {
+        description: 'Enable Swagger API docs',
+        default: 'false',
+        type: 'boolean'
+    },
+    SWAGGER_PATH: {
+        description: 'Path for swagger api docs',
+        default: '/api-docs'
+    },
+    */
+    /*
+    JWT_SECRET: {
+        description: 'Secret key for generating JWT access tokens',
+        required: true
+    },
+    JWT_REFRESH: {
+        description: 'Secret key for generating JWT refresh tokens',
+        required: true
+    },
+    */
+    DB_USER: {
+        description: 'Database username for API database'
+    },
+    DB_PASS: {
+        description: 'Password for API database'
+    },
+    DB_NAME: {
+        description: 'Name of API database. Filename for sqlite3, database name for others',
+        default: 'maildata'
+    },
+    DB_HOST: {
+        description: 'Host of API database',
+        default: 'localhost'
+    },
+    DB_TYPE: {
+        description: 'Database type of WP database',
+        options: ['sqlite'],
+        default: 'sqlite'
+    },
+    DB_LOG: {
+        description: 'Log SQL statements',
+        default: 'false',
+        type: 'boolean'
+    },
+    DEBUG: {
+        description: 'Enable debug output, including nodemailer and API',
+        default: false,
+        type: 'boolean'
+    },
+    SMTP_HOST: {
+        description: 'Hostname of SMTP sending host',
+        default: 'localhost'
+    },
+    SMTP_PORT: {
+        description: 'SMTP host server port',
+        default: 587,
+        type: 'number'
+    },
+    SMTP_SECURE: {
+        description: 'Use secure connection to SMTP host (SSL/TSL)',
+        default: false,
+        type: 'boolean'
+    },
+    SMTP_TLS_REJECT: {
+        description: 'Reject bad cert/TLS connection to SMTP host',
+        default: false,
+        type: 'boolean'
+    },
+    SMTP_USER: {
+        description: 'Username for SMTP host',
+        default: ''
+    },
+    SMTP_PASSWORD: {
+        description: 'Password for SMTP host',
+        default: ''
+    },
+    UPLOAD_PATH: {
+        description: 'Path for attached files',
+        default: './uploads/'
+    }
+});

package/dist/store/store.js

@@ -0,0 +1,85 @@
+import fs from 'fs';
+import path from 'path';
+import { EnvLoader } from '@technomoron/env-loader';
+import { createTransport } from 'nodemailer';
+import { connect_api_db } from '../models/db.js';
+import { importData } from '../models/init.js';
+import { envOptions } from './envloader.js';
+function create_mail_transport(env) {
+    const args = {
+        host: env.SMTP_HOST,
+        port: env.SMTP_PORT,
+        secure: env.SMTP_SECURE,
+        tls: {
+            rejectUnauthorized: env.SMTP_TLS_REJECT
+        },
+        requireTLS: true,
+        logger: env.DEBUG,
+        debug: env.DEBUG
+    };
+    const user = env.SMTP_USER;
+    const pass = env.SMTP_PASSWORD;
+    if (user && pass) {
+        args.auth = { user, pass };
+    }
+    // console.log(JSON.stringify(args, undefined, 2));
+    const mailer = createTransport({
+        ...args
+    });
+    if (!mailer) {
+        throw new Error('Unable to create mailer');
+    }
+    return mailer;
+}
+export class mailStore {
+    env;
+    transport;
+    api_db = null;
+    keys = {};
+    configpath = '';
+    print_debug(msg) {
+        if (this.env.DEBUG) {
+            console.log(msg);
+        }
+    }
+    config_filename(name) {
+        return path.resolve(path.join(this.configpath, name));
+    }
+    async load_api_keys(cfgpath) {
+        const keyfile = path.resolve(cfgpath, 'api-keys.json');
+        if (fs.existsSync(keyfile)) {
+            const raw = fs.readFileSync(keyfile, 'utf-8');
+            const jsonData = JSON.parse(raw);
+            this.print_debug(`API Key Database loaded from ${keyfile}`);
+            return jsonData;
+        }
+        this.print_debug(`No api-keys.json file found: tried ${keyfile}`);
+        return {};
+    }
+    async init() {
+        const env = (this.env = await EnvLoader.createConfigProxy(envOptions, { debug: true }));
+        EnvLoader.genTemplate(envOptions, '.env-dist');
+        const p = env.CONFIG_PATH;
+        this.configpath = path.isAbsolute(p) ? p : path.join(process.cwd(), p);
+        console.log(`Config path is ${this.configpath}`);
+        // this.keys = await this.load_api_keys(this.configpath);
+        this.transport = await create_mail_transport(env);
+        this.api_db = await connect_api_db(this);
+        if (this.env.DB_AUTO_RELOAD) {
+            this.print_debug('Enabling auto reload of init-data.json');
+            fs.watchFile(this.config_filename('init-data.json'), { interval: 2000 }, () => {
+                this.print_debug('Config file changed, reloading...');
+                try {
+                    importData(this);
+                }
+                catch (err) {
+                    this.print_debug(`Failed to reload config: ${err}`);
+                }
+            });
+        }
+        return this;
+    }
+    get_api_key(key) {
+        return this.keys[key] || null;
+    }
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/util.js

@@ -0,0 +1,94 @@
+import { api_domain } from './models/domain.js';
+import { api_user } from './models/user.js';
+/**
+ * Normalize a string into a safe identifier for slugs, filenames, etc.
+ *
+ * - Lowercases all characters
+ * - Replaces any character that is not `a-z`, `0-9`, `-`, '.' or `_` with `-`
+ * - Collapses multiple consecutive dashes into one
+ * - Trims leading and trailing dashes
+ *
+ * Examples:
+ *   normalizeSlug("Hello World!")    -> "hello-world"
+ *   normalizeSlug("  Áccêntš  ")     -> "ccnt"
+ *   normalizeSlug("My--Slug__Test")  -> "my-slug__test"
+ */
+export function normalizeSlug(input) {
+    if (!input) {
+        return '';
+    }
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-_\.]/g, '-')
+        .replace(/--+/g, '-') // collapse multiple dashes
+        .replace(/^-+|-+$/g, ''); // trim leading/trailing dashes
+}
+export async function user_and_domain(domain_id) {
+    const domain = await api_domain.findByPk(domain_id);
+    if (!domain) {
+        throw new Error(`Unable to look up domain ${domain_id}`);
+    }
+    const user = await api_user.findByPk(domain.user_id);
+    if (!user) {
+        throw new Error(`Unable to look up user ${domain.user_id}`);
+    }
+    return { user, domain };
+}
+function collectHeaderIps(header) {
+    if (!header) {
+        return [];
+    }
+    if (Array.isArray(header)) {
+        return header
+            .join(',')
+            .split(',')
+            .map((ip) => ip.trim())
+            .filter(Boolean);
+    }
+    return header
+        .split(',')
+        .map((ip) => ip.trim())
+        .filter(Boolean);
+}
+function resolveHeader(headers, key) {
+    const direct = headers[key];
+    const alt = headers[key.toLowerCase()];
+    const value = direct ?? alt;
+    if (typeof value === 'string' || Array.isArray(value)) {
+        return value;
+    }
+    return undefined;
+}
+export function buildRequestMeta(rawReq) {
+    const req = (rawReq ?? {});
+    const headers = req.headers ?? {};
+    const ips = [];
+    ips.push(...collectHeaderIps(resolveHeader(headers, 'x-forwarded-for')));
+    const realIp = resolveHeader(headers, 'x-real-ip');
+    if (typeof realIp === 'string' && realIp.trim()) {
+        ips.push(realIp.trim());
+    }
+    const cfIp = resolveHeader(headers, 'cf-connecting-ip');
+    if (typeof cfIp === 'string' && cfIp.trim()) {
+        ips.push(cfIp.trim());
+    }
+    const fastlyIp = resolveHeader(headers, 'fastly-client-ip');
+    if (typeof fastlyIp === 'string' && fastlyIp.trim()) {
+        ips.push(fastlyIp.trim());
+    }
+    if (req.ip && req.ip.trim()) {
+        ips.push(req.ip.trim());
+    }
+    const remoteAddress = req.socket?.remoteAddress;
+    if (remoteAddress) {
+        ips.push(remoteAddress);
+    }
+    const uniqueIps = ips.filter((ip, index) => ips.indexOf(ip) === index);
+    const clientIp = uniqueIps[0] || '';
+    return {
+        client_ip: clientIp,
+        received_at: new Date().toISOString(),
+        ip_chain: uniqueIps
+    };
+}

package/ecosystem.config.cjs

@@ -0,0 +1,42 @@
+const tplsrv = 'mail-magic';
+
+module.exports = {
+	apps: [
+		{
+			name: tplsrv,
+			script: 'npm',
+			args: 'run start',
+			cwd: `/root/deploy/${tplsrv}/source`,
+			env: {
+				NODE_ENV: 'production'
+			}
+		},
+		{
+			name: 'listmonk',
+			script: './listmonk',
+			cwd: '/var/www/ml.yesmedia.no',
+			exec_mode: 'fork',
+			instances: 1,
+			autorestart: true,
+			watch: false,
+			max_memory_restart: '1G',
+			user: 'listmonk',
+			group: 'listmonk',
+			env: {
+				NODE_ENV: 'production'
+			}
+		}
+	],
+	deploy: {
+		'mail-magic': {
+			user: 'root',
+			host: 'localhost',
+			ref: 'origin/main',
+			path: `/root/deploy/${tplsrv}`,
+			repo: `git@github.com:technomoron/${tplsrv}`,
+			'pre-deploy-local': '',
+			'pre-setup': '',
+			'post-deploy': `cd /root/deploy/${tplsrv}/source && pnpm install && pnpm upgrade && pnpm run build && pm2 start /root/deploy/ecosystem.config.cjs`
+		}
+	}
+};

package/eslint.config.mjs

@@ -0,0 +1,104 @@
+import tsParser from '@typescript-eslint/parser';
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript';
+import pluginImport from 'eslint-plugin-import';
+import pluginPrettier from 'eslint-plugin-prettier';
+import pluginVue from 'eslint-plugin-vue';
+import jsoncParser from 'jsonc-eslint-parser';
+
+export default [
+	{
+		ignores: [
+			'node_modules',
+			'dist',
+			'.output',
+			'.nuxt',
+			'coverage',
+			'**/*.d.ts',
+			'configure-eslint.js',
+			'*.config.js',
+			'*.config.ts',
+			'public'
+		]
+	},
+	...defineConfigWithVueTs(vueTsConfigs.recommended),
+	{
+		files: ['**/*.vue'],
+		plugins: {
+			vue: pluginVue,
+			prettier: pluginPrettier
+		},
+		rules: {
+			'prettier/prettier': 'error', // Enforce Prettier rules
+			'vue/html-indent': 'off', // Let Prettier handle indentation
+			'vue/max-attributes-per-line': 'off', // Let Prettier handle line breaks
+			'vue/first-attribute-linebreak': 'off', // Let Prettier handle attribute positioning
+			'vue/singleline-html-element-content-newline': 'off',
+			'vue/html-self-closing': [
+				'error',
+				{
+					html: {
+						void: 'always',
+						normal: 'always',
+						component: 'always'
+					}
+				}
+			],
+			'vue/multi-word-component-names': 'off', // Disable multi-word name restriction
+			'vue/attribute-hyphenation': ['error', 'always']
+		}
+	},
+	{
+		files: ['*.json'],
+		languageOptions: {
+			parser: jsoncParser
+		},
+		plugins: {
+			prettier: pluginPrettier
+		},
+		rules: {
+			quotes: ['error', 'double'], // Enforce double quotes in JSON
+			'prettier/prettier': 'error',
+			'@typescript-eslint/no-unused-expressions': 'off',
+			'@typescript-eslint/no-unused-vars': 'off'
+		}
+	},
+	{
+		files: ['**/*.{ts,mts,tsx,js,mjs,cjs}'],
+		languageOptions: {
+			parser: tsParser,
+			parserOptions: {
+				ecmaVersion: 2023,
+				sourceType: 'module',
+				extraFileExtensions: ['.vue']
+			},
+			globals: {
+				RequestInit: 'readonly',
+				process: 'readonly',
+				Capacitor: 'readonly',
+				chrome: 'readonly'
+			}
+		},
+		plugins: {
+			prettier: pluginPrettier,
+			import: pluginImport
+		},
+		rules: {
+			indent: ['error', 'tab', { SwitchCase: 1 }], // Use tabs for JS/TS
+			quotes: ['warn', 'single', { avoidEscape: true }], // Prefer single quotes
+			semi: ['error', 'always'], // Enforce semicolons
+			'comma-dangle': 'off', // Disable trailing commas
+			'prettier/prettier': 'error', // Enforce Prettier rules
+			'import/order': [
+				'error',
+				{
+					groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index', 'object', 'type'],
+					'newlines-between': 'always',
+					alphabetize: { order: 'asc', caseInsensitive: true }
+				}
+			],
+			'@typescript-eslint/no-explicit-any': ['warn'],
+			'@typescript-eslint/no-unused-vars': ['warn'],
+			'@typescript-eslint/no-require-imports': 'off'
+		}
+	}
+];

package/package.json

@@ -0,0 +1,67 @@
+{
+	"name": "@technomoron/mail-magic",
+	"version": "1.0.4",
+	"main": "dist/index.js",
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/technomoron/mail-magic.git"
+	},
+	"scripts": {
+		"start": "node dist/index.js",
+		"dev": "NODE_ENV=development nodemon --watch 'src/**/*.ts' --watch 'config/**/*.*' --watch '.env' --exec 'tsx' src/index.ts",
+		"run": "NODE_ENV=production npm run start",
+		"build": "tsc",
+		"scrub": "rm -rf ./node_modules/ ./dist/ pnpm-lock.yaml",
+		"lint": "eslint --ext .js,.cjs,.mjs,.ts,.mts,.tsx,.vue ./",
+		"lintfix": "eslint --fix --ext .js,.cjs,.mjs,.ts,.mts,.tsx,.vue ./",
+		"pretty": "prettier --write \"**/*.{js,jsx,cjs,mjs,ts,tsx,mts,vue,json,css,scss,md}\"",
+		"format": "npm run lintfix && npm run pretty",
+		"cleanbuild": "rm -rf ./dist/ && npm run lintfix && npm run format && npm run build"
+	},
+	"keywords": [],
+	"author": "Bjørn Erik Jacobsen",
+	"license": "MIT",
+	"copyright": "Copyright (c) 2025 Bjørn Erik Jacobsen",
+	"bugs": {
+		"url": "https://github.com/technomoron/mail-magic/issues"
+	},
+	"dependencies": {
+		"@technomoron/api-server-base": "^1.0.40",
+		"@technomoron/env-loader": "^1.0.8",
+		"@technomoron/unyuck": "^1.0.4",
+		"bcryptjs": "^3.0.2",
+		"email-addresses": "^5.0.0",
+		"html-to-text": "^9.0.5",
+		"nodemailer": "^6.10.1",
+		"nunjucks": "^3.2.4",
+		"sequelize": "^6.37.7",
+		"sqlite3": "^5.1.7",
+		"swagger-jsdoc": "^6.2.8",
+		"swagger-ui-express": "^5.0.1",
+		"zod": "^4.1.5"
+	},
+	"devDependencies": {
+		"@types/html-to-text": "^9.0.4",
+		"@types/nodemailer": "^6.4.19",
+		"@types/nunjucks": "^3.2.6",
+		"@typescript-eslint/eslint-plugin": "8.44.1",
+		"@typescript-eslint/parser": "8.44.1",
+		"@vue/eslint-config-prettier": "10.2.0",
+		"@vue/eslint-config-typescript": "^14.6.0",
+		"eslint": "9.36.0",
+		"eslint-config-prettier": "10.1.8",
+		"eslint-import-resolver-alias": "1.1.2",
+		"eslint-plugin-import": "2.32.0",
+		"eslint-plugin-nuxt": "4.0.0",
+		"eslint-plugin-prettier": "5.5.4",
+		"eslint-plugin-vue": "^10.5.0",
+		"jsonc-eslint-parser": "^2.4.1",
+		"nodemon": "^3.1.10",
+		"prettier": "3.6.2",
+		"tsx": "^4.20.5",
+		"typescript": "^5.9.2",
+		"vue-eslint-parser": "^10.2.0"
+	},
+	"homepage": "https://github.com/technomoron/mail-magic#readme"
+}