@technomoron/mail-magic-client 1.0.28 → 1.0.32

package/CHANGES

@@ -1,3 +1,32 @@
+CHANGES
+=======
+
+Unreleased (2026-02-22)
+
+- chore(release): add package-level `release:check` script and wire `release` to shared publish script.
+- chore(scripts): replace `rm -rf` cleanup scripts with `rimraf`.
+- test(logging): quiet package test output by default (silent Vitest with compact dot reporter).
+- (Changes generated/assisted by Codex (profile: chatgpt-5.3-codex/medium).)
+
+Version 1.0.32 (2026-02-22)
+
+- chore(changes): normalize this package changelog to required CHANGES format.
+- (Changes generated/assisted by Codex (profile: chatgpt-5.3-codex/medium).)
+
+Version 1.0.31 (2026-02-19)
+
+- Extract CLI implementation to dedicated `@technomoron/mail-magic-cli`
+  package; remove CLI build/bin and CLI-only dependencies from this package.
+- Replace `forEach` with `for...of` and use separate `const` declarations in
+  `validateEmails` for consistency with server-side style.
+
+Version 1.0.30 (2026-02-17)
+
+- Refactor template preprocess compilation to use per-invocation configuration
+  (remove module-level mutable config state).
+- Add regression coverage to ensure preprocess options (such as
+  `inline_includes`) do not leak between compile calls.
+
 Version 1.0.29 (2026-02-11)
 
 - Expand client coverage for mail-magic-owned endpoints:

package/README.md

@@ -1,6 +1,6 @@
 # @technomoron/mail-magic-client
 
-Client library and CLI for the mail-magic server.
+Typed client library for the mail-magic server.
 
 ## Install
 
@@ -95,73 +95,10 @@ await client.sendFormMessage({
 
 ## CLI
 
-The package ships `mm-cli`.
-
-### .mmcli-env
-
-Create `.mmcli-env` in your working directory to set defaults:
-
-```ini
-MMCLI_API=http://127.0.0.1:3776
-MMCLI_TOKEN=example-token
-MMCLI_DOMAIN=example.test
-```
-
-`MMCLI_TOKEN` is treated as the server token string. As a convenience, `MMCLI_USERNAME` + `MMCLI_PASSWORD` can be used
-to build a combined token string (for legacy setups).
-
-### Template Commands
-
-Compile a template locally:
-
-```bash
-mm-cli compile --input ./templates --output ./templates-dist
-```
-
-Push a single transactional template (compile + upload):
-
-```bash
-mm-cli push --template tx-template/en/welcome --domain example.test --input ./templates
-```
-
-Dry-run a single template upload:
-
-```bash
-mm-cli push --template tx-template/en/welcome --domain example.test --input ./templates --dry-run
-```
-
-Push an entire config-style directory:
-
-```bash
-mm-cli push-dir --input ./data --domain example.test
-mm-cli push-dir --input ./data --domain example.test --dry-run
-mm-cli push-dir --input ./data --domain example.test --skip-assets
-```
-
-### Asset Uploads
-
-Upload stand-alone domain assets:
-
-```bash
-mm-cli assets --file ./logo.png --domain example.test
-```
-
-Dry-run an asset upload:
-
-```bash
-mm-cli assets --file ./logo.png --domain example.test --dry-run
-```
-
-Upload assets scoped to a template:
-
-```bash
-mm-cli assets --file ./hero.png --domain example.test --template-type tx --template welcome --locale en --path images
-```
+The CLI is now a separate package: `@technomoron/mail-magic-cli`.
 
 ## Notes
 
-- `push-dir` expects a `init-data.json` and domain folders that match the server config layout.
-- Asset uploads use the server endpoint `POST /api/v1/assets`.
 - OpenAPI spec (when enabled): `await client.getSwaggerSpec()`
 - Public asset fetch helpers:
     - `await client.fetchPublicAsset('example.test', 'images/logo.png')` -> `/asset/{domain}/{path}`

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

@@ -3,7 +3,13 @@ type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
 };
 type RequestBody = JsonValue | object;
-interface templateData {
+export type ApiResponse<T = unknown> = {
+    Status?: string;
+    data?: T;
+    message?: string;
+    [key: string]: unknown;
+};
+export interface StoreTxTemplateInput {
     template: string;
     domain: string;
     sender?: string;
@@ -12,7 +18,7 @@ interface templateData {
     locale?: string;
     part?: boolean;
 }
-interface formTemplateData {
+export interface StoreFormTemplateInput {
     idname: string;
     domain: string;
     template: string;
@@ -26,7 +32,7 @@ interface formTemplateData {
     allowed_fields?: string[] | string;
     captcha_required?: boolean;
 }
-interface formRecipientData {
+export interface StoreFormRecipientInput {
     domain: string;
     idname: string;
     email: string;
@@ -35,7 +41,7 @@ interface formRecipientData {
     formid?: string;
     locale?: string;
 }
-interface sendTemplateData {
+export interface SendTxMessageInput {
     name: string;
     rcpt: string;
     domain: string;
@@ -45,21 +51,21 @@ interface sendTemplateData {
     headers?: Record<string, string>;
     attachments?: AttachmentInput[];
 }
-interface sendFormData {
+export interface SendFormMessageInput {
     _mm_form_key: string;
     _mm_locale?: string;
     _mm_recipients?: string[] | string;
     fields?: Record<string, unknown>;
     attachments?: AttachmentInput[];
 }
-type AttachmentInput = {
+export type AttachmentInput = {
     path: string;
     filename?: string;
     contentType?: string;
     field?: string;
 };
 type UploadAssetInput = string | AttachmentInput;
-interface uploadAssetsData {
+export interface UploadAssetsInput {
     domain: string;
     files: UploadAssetInput[];
     templateType?: 'tx' | 'form';
@@ -67,7 +73,7 @@ interface uploadAssetsData {
     locale?: string;
     path?: string;
 }
-declare class templateClient {
+declare class TemplateClient {
     private baseURL;
     private apiKey;
     constructor(baseURL: string, apiKey: string);
@@ -85,15 +91,15 @@ declare class templateClient {
     private createAttachmentPayload;
     private appendFields;
     private postFormData;
-    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>;
-    storeFormRecipient(data: formRecipientData): Promise<unknown>;
-    sendFormMessage(data: sendFormData): Promise<unknown>;
-    uploadAssets(data: uploadAssetsData): Promise<unknown>;
-    getSwaggerSpec(): Promise<unknown>;
+    storeTemplate(td: StoreTxTemplateInput): Promise<ApiResponse>;
+    sendTemplate(std: SendTxMessageInput): Promise<ApiResponse>;
+    storeTxTemplate(td: StoreTxTemplateInput): Promise<ApiResponse>;
+    sendTxMessage(std: SendTxMessageInput): Promise<ApiResponse>;
+    storeFormTemplate(data: StoreFormTemplateInput): Promise<ApiResponse>;
+    storeFormRecipient(data: StoreFormRecipientInput): Promise<ApiResponse>;
+    sendFormMessage(data: SendFormMessageInput): Promise<ApiResponse>;
+    uploadAssets(data: UploadAssetsInput): Promise<ApiResponse>;
+    getSwaggerSpec(): Promise<ApiResponse>;
     fetchPublicAsset(domain: string, assetPath: string, viaApiBase?: boolean): Promise<ArrayBuffer>;
 }
-export default templateClient;
+export default TemplateClient;

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

@@ -7,7 +7,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const email_addresses_1 = __importDefault(require("email-addresses"));
 const nunjucks_1 = __importDefault(require("nunjucks"));
-class templateClient {
+class TemplateClient {
     constructor(baseURL, apiKey) {
         this.baseURL = baseURL;
         this.apiKey = apiKey;
@@ -30,13 +30,11 @@ class templateClient {
             headers['Content-Type'] = 'application/json';
             options.body = JSON.stringify(body);
         }
-        //        console.log(JSON.stringify({ options, url }));
         const response = await fetch(url, options);
         const j = await response.json();
         if (response.ok) {
             return j;
         }
-        // console.log(JSON.stringify(j, undefined, 2));
         if (j && j.message) {
             throw new Error(`FETCH FAILED: ${response.status} ${j.message}`);
         }
@@ -57,12 +55,13 @@ class templateClient {
         return this.request('DELETE', command, body);
     }
     validateEmails(list) {
-        const valid = [], invalid = [];
+        const valid = [];
+        const invalid = [];
         const emails = list
             .split(',')
             .map((email) => email.trim())
             .filter((email) => email !== '');
-        emails.forEach((email) => {
+        for (const email of emails) {
             const parsed = email_addresses_1.default.parseOneAddress(email);
             if (parsed && parsed.address) {
                 valid.push(parsed.address);
@@ -70,15 +69,21 @@ class templateClient {
             else {
                 invalid.push(email);
             }
-        });
+        }
         return { valid, invalid };
     }
     validateTemplate(template) {
         try {
-            const env = new nunjucks_1.default.Environment(new nunjucks_1.default.FileSystemLoader(['./templates']));
-            env.renderString(template, {});
+            const env = new nunjucks_1.default.Environment(null, { autoescape: true });
+            const compiled = nunjucks_1.default.compile(template, env);
+            compiled.render({});
         }
         catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // Syntax validation should not require local template loaders.
+            if (/template not found|no loader|unable to find template/i.test(message)) {
+                return;
+            }
             if (error instanceof Error) {
                 throw new Error(`Template validation failed: ${error.message}`);
             }
@@ -144,13 +149,7 @@ class templateClient {
         throw new Error(`FETCH FAILED: ${response.status} ${response.statusText}`);
     }
     async storeTemplate(td) {
-        if (!td.template) {
-            throw new Error('No template data provided');
-        }
-        this.validateTemplate(td.template);
-        if (td.sender) {
-            this.validateSender(td.sender);
-        }
+        // Backward-compatible alias for transactional template storage.
         return this.storeTxTemplate(td);
     }
     async sendTemplate(std) {
@@ -177,7 +176,6 @@ class templateClient {
         if (invalid.length > 0) {
             throw new Error('Invalid email address(es): ' + invalid.join(','));
         }
-        // this.validateTemplate(template);
         const body = {
             name: std.name,
             rcpt: std.rcpt,
@@ -187,7 +185,6 @@ class templateClient {
             replyTo: std.replyTo,
             headers: std.headers
         };
-        // console.log(JSON.stringify(body, undefined, 2));
         if (std.attachments && std.attachments.length > 0) {
             if (std.headers) {
                 throw new Error('Headers are not supported with attachment uploads');
@@ -329,4 +326,4 @@ class templateClient {
         return response.arrayBuffer();
     }
 }
-exports.default = templateClient;
+exports.default = TemplateClient;

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

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import emailAddresses from 'email-addresses';
 import nunjucks from 'nunjucks';
-class templateClient {
+class TemplateClient {
     constructor(baseURL, apiKey) {
         this.baseURL = baseURL;
         this.apiKey = apiKey;
@@ -25,13 +25,11 @@ class templateClient {
             headers['Content-Type'] = 'application/json';
             options.body = JSON.stringify(body);
         }
-        //        console.log(JSON.stringify({ options, url }));
         const response = await fetch(url, options);
         const j = await response.json();
         if (response.ok) {
             return j;
         }
-        // console.log(JSON.stringify(j, undefined, 2));
         if (j && j.message) {
             throw new Error(`FETCH FAILED: ${response.status} ${j.message}`);
         }
@@ -52,12 +50,13 @@ class templateClient {
         return this.request('DELETE', command, body);
     }
     validateEmails(list) {
-        const valid = [], invalid = [];
+        const valid = [];
+        const invalid = [];
         const emails = list
             .split(',')
             .map((email) => email.trim())
             .filter((email) => email !== '');
-        emails.forEach((email) => {
+        for (const email of emails) {
             const parsed = emailAddresses.parseOneAddress(email);
             if (parsed && parsed.address) {
                 valid.push(parsed.address);
@@ -65,15 +64,21 @@ class templateClient {
             else {
                 invalid.push(email);
             }
-        });
+        }
         return { valid, invalid };
     }
     validateTemplate(template) {
         try {
-            const env = new nunjucks.Environment(new nunjucks.FileSystemLoader(['./templates']));
-            env.renderString(template, {});
+            const env = new nunjucks.Environment(null, { autoescape: true });
+            const compiled = nunjucks.compile(template, env);
+            compiled.render({});
         }
         catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // Syntax validation should not require local template loaders.
+            if (/template not found|no loader|unable to find template/i.test(message)) {
+                return;
+            }
             if (error instanceof Error) {
                 throw new Error(`Template validation failed: ${error.message}`);
             }
@@ -139,13 +144,7 @@ class templateClient {
         throw new Error(`FETCH FAILED: ${response.status} ${response.statusText}`);
     }
     async storeTemplate(td) {
-        if (!td.template) {
-            throw new Error('No template data provided');
-        }
-        this.validateTemplate(td.template);
-        if (td.sender) {
-            this.validateSender(td.sender);
-        }
+        // Backward-compatible alias for transactional template storage.
         return this.storeTxTemplate(td);
     }
     async sendTemplate(std) {
@@ -172,7 +171,6 @@ class templateClient {
         if (invalid.length > 0) {
             throw new Error('Invalid email address(es): ' + invalid.join(','));
         }
-        // this.validateTemplate(template);
         const body = {
             name: std.name,
             rcpt: std.rcpt,
@@ -182,7 +180,6 @@ class templateClient {
             replyTo: std.replyTo,
             headers: std.headers
         };
-        // console.log(JSON.stringify(body, undefined, 2));
         if (std.attachments && std.attachments.length > 0) {
             if (std.headers) {
                 throw new Error('Headers are not supported with attachment uploads');
@@ -324,4 +321,4 @@ class templateClient {
         return response.arrayBuffer();
     }
 }
-export default templateClient;
+export default TemplateClient;