@technomoron/mail-magic-client 1.0.23 → 1.0.25

package/CHANGES

@@ -1,3 +1,8 @@
+Version 1.0.25 (2026-02-07)
+
+- `sendFormMessage()` now requires `domain` when sending by `formid`, and also
+  supports sending by `form_key`.
+
 Version 1.0.23 (2026-01-31)
 
 - Fixed the per-package release script name and tag format used to trigger

package/dist/cjs/mail-magic-client.d.ts

@@ -1,3 +1,8 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type RequestBody = JsonValue | object;
 interface templateData {
     template: string;
     domain: string;
@@ -22,18 +27,19 @@ interface sendTemplateData {
     rcpt: string;
     domain: string;
     locale?: string;
-    vars?: object;
+    vars?: Record<string, unknown>;
     replyTo?: string;
     headers?: Record<string, string>;
     attachments?: AttachmentInput[];
 }
 interface sendFormData {
-    formid: string;
+    formid?: string;
+    form_key?: string;
     secret?: string;
     recipient?: string;
     domain?: string;
     locale?: string;
-    vars?: object;
+    vars?: Record<string, unknown>;
     replyTo?: string;
     fields?: Record<string, unknown>;
     attachments?: AttachmentInput[];
@@ -57,11 +63,11 @@ declare class templateClient {
     private baseURL;
     private apiKey;
     constructor(baseURL: string, apiKey: string);
-    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', command: string, body?: any): Promise<T>;
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', command: string, body?: RequestBody): Promise<T>;
     get<T>(command: string): Promise<T>;
-    post<T>(command: string, body: any): Promise<T>;
-    put<T>(command: string, body: any): Promise<T>;
-    delete<T>(command: string, body?: any): Promise<T>;
+    post<T>(command: string, body: RequestBody): Promise<T>;
+    put<T>(command: string, body: RequestBody): Promise<T>;
+    delete<T>(command: string, body?: RequestBody): Promise<T>;
     validateEmails(list: string): {
         valid: string[];
         invalid: string[];
@@ -71,12 +77,12 @@ declare class templateClient {
     private createAttachmentPayload;
     private appendFields;
     private postFormData;
-    storeTemplate(td: templateData): Promise<any>;
-    sendTemplate(std: sendTemplateData): Promise<any>;
-    storeTxTemplate(td: templateData): Promise<any>;
-    sendTxMessage(std: sendTemplateData): Promise<any>;
-    storeFormTemplate(data: formTemplateData): Promise<any>;
-    sendFormMessage(data: sendFormData): Promise<any>;
-    uploadAssets(data: uploadAssetsData): Promise<any>;
+    storeTemplate(td: templateData): Promise<unknown>;
+    sendTemplate(std: sendTemplateData): Promise<unknown>;
+    storeTxTemplate(td: templateData): Promise<unknown>;
+    sendTxMessage(std: sendTemplateData): Promise<unknown>;
+    storeFormTemplate(data: formTemplateData): Promise<unknown>;
+    sendFormMessage(data: sendFormData): Promise<unknown>;
+    uploadAssets(data: uploadAssetsData): Promise<unknown>;
 }
 export default templateClient;

package/dist/cjs/mail-magic-client.js

@@ -71,7 +71,7 @@ class templateClient {
     validateTemplate(template) {
         try {
             const env = new nunjucks_1.default.Environment(new nunjucks_1.default.FileSystemLoader(['./templates']));
-            const t = env.renderString(template, {});
+            env.renderString(template, {});
         }
         catch (error) {
             if (error instanceof Error) {
@@ -168,7 +168,7 @@ class templateClient {
         if (!std.name || !std.rcpt) {
             throw new Error('Invalid request body; name/rcpt required');
         }
-        const { valid, invalid } = this.validateEmails(std.rcpt);
+        const { invalid } = this.validateEmails(std.rcpt);
         if (invalid.length > 0) {
             throw new Error('Invalid email address(es): ' + invalid.join(','));
         }
@@ -218,12 +218,16 @@ class templateClient {
         return this.post('/api/v1/form/template', data);
     }
     async sendFormMessage(data) {
-        if (!data.formid) {
-            throw new Error('Invalid request body; formid required');
+        if (!data.form_key && !data.formid) {
+            throw new Error('Invalid request body; formid or form_key required');
+        }
+        if (!data.form_key && !data.domain) {
+            throw new Error('Invalid request body; domain required when sending by formid');
         }
         const fields = data.fields || {};
         const baseFields = {
             formid: data.formid,
+            form_key: data.form_key,
             secret: data.secret,
             recipient: data.recipient,
             domain: data.domain,
@@ -236,6 +240,7 @@ class templateClient {
             const { formData } = this.createAttachmentPayload(data.attachments);
             this.appendFields(formData, {
                 formid: data.formid,
+                form_key: data.form_key,
                 secret: data.secret,
                 recipient: data.recipient,
                 domain: data.domain,

package/dist/cli.js

@@ -66,6 +66,24 @@ const getTemplateData = async () => {
         return await readStdin();
     }
 };
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const parseVarsOption = (input) => {
+    if (!input) {
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(input);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid JSON for --vars: ${message}`);
+    }
+    if (!isPlainObject(parsed)) {
+        throw new Error('--vars must be a JSON object');
+    }
+    return parsed;
+};
 program
     .command('template')
     .description('Store a template on the server')
@@ -82,7 +100,7 @@ program
             domain: program.opts().domain,
             part: !!program.opts().part
         };
-        const result = await client.storeTemplate(templateData);
+        await client.storeTemplate(templateData);
         console.log('Template updated');
     }
     catch (error) {
@@ -101,8 +119,7 @@ program
     .action(async () => {
     const client = new mail_magic_client_1.default(program.opts().api, program.opts().token);
     try {
-        const template = await getTemplateData();
-        const vars = program.opts().vars ? JSON.parse(program.opts().vars) : '{}';
+        const vars = parseVarsOption(program.opts().vars);
         const templateData = {
             name: program.opts().name,
             rcpt: program.opts().rcpt,
@@ -110,7 +127,7 @@ program
             locale: program.opts().locale,
             vars
         };
-        const result = await client.sendTemplate(templateData);
+        await client.sendTemplate(templateData);
         console.log('Template sent');
     }
     catch (error) {
@@ -126,7 +143,7 @@ program
 program
     .command('version')
     .description('Show current client version')
-    .action(async (cmdOptions) => {
+    .action(async () => {
     console.log('1.0.19');
 });
 program

package/dist/esm/mail-magic-client.js

@@ -66,7 +66,7 @@ class templateClient {
     validateTemplate(template) {
         try {
             const env = new nunjucks.Environment(new nunjucks.FileSystemLoader(['./templates']));
-            const t = env.renderString(template, {});
+            env.renderString(template, {});
         }
         catch (error) {
             if (error instanceof Error) {
@@ -163,7 +163,7 @@ class templateClient {
         if (!std.name || !std.rcpt) {
             throw new Error('Invalid request body; name/rcpt required');
         }
-        const { valid, invalid } = this.validateEmails(std.rcpt);
+        const { invalid } = this.validateEmails(std.rcpt);
         if (invalid.length > 0) {
             throw new Error('Invalid email address(es): ' + invalid.join(','));
         }
@@ -213,12 +213,16 @@ class templateClient {
         return this.post('/api/v1/form/template', data);
     }
     async sendFormMessage(data) {
-        if (!data.formid) {
-            throw new Error('Invalid request body; formid required');
+        if (!data.form_key && !data.formid) {
+            throw new Error('Invalid request body; formid or form_key required');
+        }
+        if (!data.form_key && !data.domain) {
+            throw new Error('Invalid request body; domain required when sending by formid');
         }
         const fields = data.fields || {};
         const baseFields = {
             formid: data.formid,
+            form_key: data.form_key,
             secret: data.secret,
             recipient: data.recipient,
             domain: data.domain,
@@ -231,6 +235,7 @@ class templateClient {
             const { formData } = this.createAttachmentPayload(data.attachments);
             this.appendFields(formData, {
                 formid: data.formid,
+                form_key: data.form_key,
                 secret: data.secret,
                 recipient: data.recipient,
                 domain: data.domain,

package/dist/mail-magic-client.js

@@ -71,7 +71,7 @@ class templateClient {
     validateTemplate(template) {
         try {
             const env = new nunjucks_1.default.Environment(new nunjucks_1.default.FileSystemLoader(['./templates']));
-            const t = env.renderString(template, {});
+            env.renderString(template, {});
         }
         catch (error) {
             if (error instanceof Error) {
@@ -168,7 +168,7 @@ class templateClient {
         if (!std.name || !std.rcpt) {
             throw new Error('Invalid request body; name/rcpt required');
         }
-        const { valid, invalid } = this.validateEmails(std.rcpt);
+        const { invalid } = this.validateEmails(std.rcpt);
         if (invalid.length > 0) {
             throw new Error('Invalid email address(es): ' + invalid.join(','));
         }
@@ -218,12 +218,16 @@ class templateClient {
         return this.post('/api/v1/form/template', data);
     }
     async sendFormMessage(data) {
-        if (!data.formid) {
-            throw new Error('Invalid request body; formid required');
+        if (!data.form_key && !data.formid) {
+            throw new Error('Invalid request body; formid or form_key required');
+        }
+        if (!data.form_key && !data.domain) {
+            throw new Error('Invalid request body; domain required when sending by formid');
         }
         const fields = data.fields || {};
         const baseFields = {
             formid: data.formid,
+            form_key: data.form_key,
             secret: data.secret,
             recipient: data.recipient,
             domain: data.domain,
@@ -236,6 +240,7 @@ class templateClient {
             const { formData } = this.createAttachmentPayload(data.attachments);
             this.appendFields(formData, {
                 formid: data.formid,
+                form_key: data.form_key,
                 secret: data.secret,
                 recipient: data.recipient,
                 domain: data.domain,

package/dist/preprocess.js

@@ -55,7 +55,6 @@ class PreprocessExtension {
     constructor() {
         this.tags = ['process_layout'];
     }
-    // types from nunjucks are not exported for parser/nodes; use any
     parse(parser, nodes) {
         const token = parser.nextToken();
         const args = parser.parseSignature(null, true);
@@ -114,8 +113,8 @@ function process_template(tplname, writeOutput = true) {
                 // decodeEntities: false
             });
             // <container> -> <table>
-            $('container').each(function () {
-                const $container = $(this);
+            $('container').each((_index, element) => {
+                const $container = $(element);
                 const $table = $('<table/>').attr({
                     align: 'center',
                     class: $container.attr('class') || '',
@@ -130,8 +129,8 @@ function process_template(tplname, writeOutput = true) {
                 $container.replaceWith($table);
             });
             // <row> -> <tr>
-            $('row').each(function () {
-                const $row = $(this);
+            $('row').each((_index, element) => {
+                const $row = $(element);
                 const background = $row.attr('background') || '';
                 const $tr = $('<tr/>').attr({ class: $row.attr('class') || '' });
                 if (background)
@@ -140,8 +139,8 @@ function process_template(tplname, writeOutput = true) {
                 $row.replaceWith($tr);
             });
             // <columns> -> <td>
-            $('columns').each(function () {
-                const $columns = $(this);
+            $('columns').each((_index, element) => {
+                const $columns = $(element);
                 const padding = $columns.attr('padding') || '0';
                 const $td = $('<td/>').attr({
                     class: $columns.attr('class') || '',
@@ -151,8 +150,8 @@ function process_template(tplname, writeOutput = true) {
                 $columns.replaceWith($td);
             });
             // <button> -> <a>
-            $('button').each(function () {
-                const $button = $(this);
+            $('button').each((_index, element) => {
+                const $button = $(element);
                 const href = $button.attr('href') || '#';
                 const buttonClass = $button.attr('class') || '';
                 const $a = $('<a/>').attr({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@technomoron/mail-magic-client",
-	"version": "1.0.23",
+	"version": "1.0.25",
 	"description": "Client library for mail-magic",
 	"main": "dist/cjs/mail-magic-client.js",
 	"types": "dist/cjs/mail-magic-client.d.ts",
@@ -17,11 +17,11 @@
 		"build": "npm run build:cjs && npm run build:esm && npm run build:cli",
 		"test": "vitest run",
 		"test:watch": "vitest",
-		"lint": "eslint --ext .js,.ts,.vue ./src",
-		"lintfix": "eslint --fix --ext .js,.ts,.vue,.json ./src",
+		"lint": "node ../../node_modules/eslint/bin/eslint.js --config ../../eslint.config.mjs --no-error-on-unmatched-pattern --ext .js,.cjs,.mjs,.ts,.mts,.tsx,.vue,.json ./src",
+		"lintfix": "node ../../node_modules/eslint/bin/eslint.js --config ../../eslint.config.mjs --fix --no-error-on-unmatched-pattern --ext .js,.cjs,.mjs,.ts,.mts,.tsx,.vue,.json ./src",
 		"format": "npm run lintfix && npm run pretty",
-		"pretty": "prettier --write \"**/*.{js,ts,vue,json,css,scss,md}\"",
-		"cleanbuild": "rm -rf ./dist/ && npm run lintfix && npm run format && npm run build"
+		"pretty": "node ../../node_modules/prettier/bin/prettier.cjs --config ../../.prettierrc --write \"**/*.{js,ts,vue,json,css,scss,md}\"",
+		"cleanbuild": "rm -rf ./dist/ && npm run format && npm run build"
 	},
 	"repository": {
 		"type": "git",
@@ -40,30 +40,13 @@
 		"cheerio": "^1.1.2",
 		"commander": "^10.0.1",
 		"email-addresses": "^5.0.0",
-		"foundation-emails": "^2.4.0",
-		"inky": "^0.1.0",
 		"juice": "^11.0.1",
-		"node-fetch": "^3.3.2",
 		"nunjucks": "^3.2.4"
 	},
 	"devDependencies": {
-		"@types/cheerio": "^1.0.0",
 		"@types/node": "^20.19.11",
 		"@types/nunjucks": "^3.2.6",
-		"@typescript-eslint/eslint-plugin": "^8.30.1",
-		"@typescript-eslint/parser": "^8.30.1",
-		"@vue/eslint-config-prettier": "^10.2.0",
-		"@vue/eslint-config-typescript": "^14.5.0",
-		"eslint": "^9.34.0",
-		"eslint-config-prettier": "^10.1.5",
-		"eslint-import-resolver-alias": "^1.1.2",
-		"eslint-plugin-import": "^2.31.0",
-		"eslint-plugin-nuxt": "^4.0.0",
-		"eslint-plugin-prettier": "^5.4.1",
-		"eslint-plugin-vue": "^10.0.0",
-		"prettier": "^3.5.3",
 		"typescript": "^5.9.2",
-		"vitest": "^4.0.16",
-		"vue-eslint-parser": "^10.1.3"
+		"vitest": "^4.0.16"
 	}
 }