@mailmodo/cli 0.0.51-beta.pr54.83 → 0.0.52-beta.pr55.85

package/dist/commands/deploy/index.js

@@ -2,7 +2,7 @@ import { Flags } from '@oclif/core';
 import { confirm, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
+import { API_ENDPOINTS, DEFAULT_BRAND_COLOR, SDK_IMPORT_SNIPPET, SDK_INSTALL_COMMAND, } from '../../lib/constants.js';
 import { ERRORS, INFO, pauseAlready, pauseSuccess, PROMPTS, resumeAlready, resumeSuccess, SEPARATOR, } from '../../lib/messages.js';
 import { loadTemplate, } from '../../lib/yaml-config.js';
 export default class Deploy extends BaseCommand {
@@ -286,8 +286,8 @@ export default class Deploy extends BaseCommand {
         this.log(`  ${SEPARATOR}`);
         this.log(`  ${chalk.bold('ADD THIS TO YOUR APP (one-time only):')}`);
         this.log(`  ${SEPARATOR}\n`);
-        this.log(`  ${chalk.cyan(sdkSnippet.install ?? 'npm install @mailmodo/sdk')}\n`);
-        this.log(`  ${chalk.dim("import { track, identify } from '@mailmodo/sdk'")}\n`);
+        this.log(`  ${chalk.cyan(sdkSnippet.install ?? SDK_INSTALL_COMMAND)}\n`);
+        this.log(`  ${chalk.dim(SDK_IMPORT_SNIPPET)}\n`);
         if (sdkSnippet.examples) {
             this.log(`  ${chalk.dim('// Example usage:')}`);
             this.log(`  ${chalk.dim(sdkSnippet.examples.track)}`);

package/dist/commands/init/index.js

@@ -4,14 +4,7 @@ import chalk from 'chalk';
 import { BaseCommand } from '../../lib/base-command.js';
 import { API_ENDPOINTS, DEFAULT_BRAND_COLOR } from '../../lib/constants.js';
 import { loadYaml, saveTemplate, saveYaml, } from '../../lib/yaml-config.js';
-function isValidUrl(value) {
-    try {
-        return Boolean(new URL(value));
-    }
-    catch {
-        return false;
-    }
-}
+import { isValidUrl, normalizeTrigger } from '../../lib/utils.js';
 /**
  * Prints the human-readable analysis summary using the provided line writer.
  * Use stderr when `--json` is set so stdout stays free for machine-readable JSON.
@@ -124,7 +117,7 @@ export default class Init extends BaseCommand {
             return {
                 delay: rec.delay || '0',
                 id: rec.id,
-                trigger: rec.trigger,
+                trigger: normalizeTrigger(rec.trigger, analysisPayload.productName),
                 ...(rec.condition ? { condition: rec.condition } : {}),
                 subject: generated?.subject || `Email for ${rec.id}`,
                 template: `mailmodo/${rec.id}.html`,

package/dist/commands/sdk/index.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class Sdk extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'sequence-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private renderSnippets;
+    private renderSequenceBlock;
+    private renderCallBlock;
+}

package/dist/commands/sdk/index.js

@@ -0,0 +1,74 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { BaseCommand } from '../../lib/base-command.js';
+import { API_ENDPOINTS, SDK_IMPORT_SNIPPET, SDK_INSTALL_COMMAND, } from '../../lib/constants.js';
+import { SEPARATOR } from '../../lib/messages.js';
+export default class Sdk extends BaseCommand {
+    static description = 'Show the SDK track() / identify() reference for deployed sequences';
+    static examples = [
+        '<%= config.bin %> sdk',
+        '<%= config.bin %> sdk --sequence-id a1b2c3d4',
+        '<%= config.bin %> sdk --json',
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'sequence-id': Flags.string({
+            description: 'Limit output to a single active sequence by ID (default: all active sequences)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Sdk);
+        await this.ensureAuth();
+        const params = flags['sequence-id']
+            ? { sequenceId: flags['sequence-id'] }
+            : undefined;
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Loading SDK reference...' }, () => this.apiClient.get(API_ENDPOINTS.SEQUENCES_SDK, params));
+        if (!response.ok) {
+            this.handleApiError(response);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response.data, null, 2));
+            return;
+        }
+        this.renderSnippets(response.data);
+    }
+    renderSnippets(data) {
+        const snippets = data.sdkSnippets ?? [];
+        if (snippets.length === 0) {
+            this.log(`\n  ${chalk.dim('No active deployed sequences.')}`);
+            this.log(`  Run ${chalk.cyan('mailmodo deploy')} to deploy one.\n`);
+            return;
+        }
+        this.log(`\n  ${chalk.bold(String(snippets.length))} active ${snippets.length === 1 ? 'sequence' : 'sequences'}:\n`);
+        this.log(`  ${SEPARATOR}`);
+        this.log(`  ${chalk.bold('SDK EVENT REFERENCE')}`);
+        this.log(`  ${SEPARATOR}\n`);
+        this.log(`  ${chalk.cyan(SDK_INSTALL_COMMAND)}\n`);
+        this.log(`  ${chalk.dim(SDK_IMPORT_SNIPPET)}\n`);
+        for (const [index, snippet] of snippets.entries()) {
+            this.renderSequenceBlock(snippet);
+            if (index < snippets.length - 1)
+                this.log('');
+        }
+        this.log(`  ${SEPARATOR}\n`);
+    }
+    renderSequenceBlock(snippet) {
+        const productName = snippet.productName || 'Unnamed sequence';
+        this.log(`  ${chalk.bold(productName)} ${chalk.dim(`(${snippet.sequenceId})`)}`);
+        const trackCalls = [...new Set(snippet.sdkSnippet?.trackCalls ?? [])];
+        const identifyCalls = [...new Set(snippet.sdkSnippet?.identifyCalls ?? [])];
+        this.renderCallBlock('// track() calls', trackCalls);
+        this.renderCallBlock('// identify() calls', identifyCalls);
+        if (trackCalls.length === 0 && identifyCalls.length === 0) {
+            this.log(`  ${chalk.dim('No track() or identify() calls available.')}`);
+        }
+    }
+    renderCallBlock(label, calls) {
+        if (calls.length === 0)
+            return;
+        this.log(`  ${chalk.dim(label)}`);
+        for (const call of calls) {
+            this.log(`  ${chalk.dim(call)}`);
+        }
+    }
+}

package/dist/commands/settings/index.js

@@ -7,6 +7,7 @@ import { resolve } from 'node:path';
 import { BaseCommand, FREE_TIER } from '../../lib/base-command.js';
 import { API_ENDPOINTS } from '../../lib/constants.js';
 import { INFO } from '../../lib/messages.js';
+import { settingKeyToProp } from '../../lib/utils.js';
 import { saveYaml } from '../../lib/yaml-config.js';
 const SETTINGS_GROUPS = Object.freeze({
     billing: ['monthly_cap'],
@@ -20,16 +21,6 @@ const SETUP_HINTS = {
     domain: "'mailmodo domain'",
     monthlyCap: "'mailmodo billing --cap <n>'",
 };
-/**
- * Converts a user-facing snake_case YAML setting key to its
- * corresponding camelCase TypeScript property name.
- *
- * @param {string} key - A snake_case setting key (e.g., "brand_color").
- * @returns {string} The camelCase property name (e.g., "brandColor").
- */
-function settingKeyToProp(key) {
-    return key.replaceAll(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-}
 export default class Settings extends BaseCommand {
     static description = 'View and update project settings';
     static examples = [

package/dist/lib/constants.d.ts

@@ -26,6 +26,7 @@ export declare const API_ENDPOINTS: Readonly<{
     PREVIEW: "/preview";
     SEQUENCES: "/sequences";
     SEQUENCES_DEPLOY: "/sequences/deploy";
+    SEQUENCES_SDK: "/sequences/sdk";
     SEQUENCES_VALIDATE: "/sequences/validate";
 }>;
 export declare const LOGIN_URL = "https://app-vertex-debug.azurewebsites.net/signup.html";
@@ -33,3 +34,6 @@ export declare const PREVIEW_PORT = 3421;
 export declare const DEFAULT_BRAND_COLOR = "#1A56DB";
 export declare const TEMPLATES_DIR = "mailmodo";
 export declare const YAML_FILE = "mailmodo.yaml";
+export declare const SDK_PACKAGE_NAME = "@mailmodo/sdk";
+export declare const SDK_INSTALL_COMMAND = "npm install @mailmodo/sdk";
+export declare const SDK_IMPORT_SNIPPET = "import { track, identify } from '@mailmodo/sdk'";

package/dist/lib/constants.js

@@ -32,6 +32,7 @@ export const API_ENDPOINTS = Object.freeze({
     PREVIEW: '/preview',
     SEQUENCES: '/sequences',
     SEQUENCES_DEPLOY: '/sequences/deploy',
+    SEQUENCES_SDK: '/sequences/sdk',
     SEQUENCES_VALIDATE: '/sequences/validate',
 });
 const DEV_LOGIN_URL = 'https://app-vertex-debug.azurewebsites.net/signup.html';
@@ -44,3 +45,6 @@ export const PREVIEW_PORT = 3421;
 export const DEFAULT_BRAND_COLOR = '#1A56DB';
 export const TEMPLATES_DIR = 'mailmodo';
 export const YAML_FILE = 'mailmodo.yaml';
+export const SDK_PACKAGE_NAME = '@mailmodo/sdk';
+export const SDK_INSTALL_COMMAND = `npm install ${SDK_PACKAGE_NAME}`;
+export const SDK_IMPORT_SNIPPET = `import { track, identify } from '${SDK_PACKAGE_NAME}'`;

package/dist/lib/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts a user-facing snake_case YAML setting key to its
+ * corresponding camelCase TypeScript property name.
+ *
+ * @param {string} key - A snake_case setting key (e.g., "brand_color").
+ * @returns {string} The camelCase property name (e.g., "brandColor").
+ */
+export declare function settingKeyToProp(key: string): string;
+export declare function generateTriggerPrefix(productName: string): string;
+export declare function normalizeTrigger(trigger: string, productName: string): string;
+export declare function isValidUrl(value: string): boolean;

package/dist/lib/utils.js

@@ -0,0 +1,40 @@
+/**
+ * Converts a user-facing snake_case YAML setting key to its
+ * corresponding camelCase TypeScript property name.
+ *
+ * @param {string} key - A snake_case setting key (e.g., "brand_color").
+ * @returns {string} The camelCase property name (e.g., "brandColor").
+ */
+export function settingKeyToProp(key) {
+    return key.replaceAll(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function toCamelCaseAlnum(input) {
+    const parts = input
+        .trim()
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean);
+    if (parts.length === 0)
+        return '';
+    return (parts[0].toLowerCase() +
+        parts
+            .slice(1)
+            .map((p) => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase())
+            .join(''));
+}
+export function generateTriggerPrefix(productName) {
+    return `${toCamelCaseAlnum(productName)}$`;
+}
+export function normalizeTrigger(trigger, productName) {
+    const prefix = generateTriggerPrefix(productName);
+    const dollarIdx = trigger.indexOf('$');
+    const eventName = dollarIdx === -1 ? trigger : trigger.slice(dollarIdx + 1);
+    return prefix + eventName;
+}
+export function isValidUrl(value) {
+    try {
+        return Boolean(new URL(value));
+    }
+    catch {
+        return false;
+    }
+}

package/oclif.manifest.json

@@ -426,6 +426,45 @@
         "index.js"
       ]
     },
+    "login": {
+      "aliases": [],
+      "args": {},
+      "description": "Authenticate with Mailmodo using your API key",
+      "examples": [
+        "<%= config.bin %> login",
+        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "login",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "login",
+        "index.js"
+      ]
+    },
     "logout": {
       "aliases": [],
       "args": {},
@@ -534,13 +573,19 @@
         "index.js"
       ]
     },
-    "login": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "Authenticate with Mailmodo using your API key",
+      "args": {
+        "id": {
+          "description": "Email template ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> login",
-        "MAILMODO_API_KEY=YOUR_API_KEY <%= config.bin %> login"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -555,11 +600,24 @@
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
+        },
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "text": {
+          "description": "Output plain text version (for AI agents)",
+          "name": "text",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "login",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -569,23 +627,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "login",
+        "preview",
         "index.js"
       ]
     },
-    "preview": {
+    "sdk": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email template ID to preview",
-          "name": "id"
-        }
-      },
-      "description": "Preview an email in browser, as text, or send a test",
+      "args": {},
+      "description": "Show the SDK track() / identify() reference for deployed sequences",
       "examples": [
-        "<%= config.bin %> preview welcome",
-        "<%= config.bin %> preview welcome --text",
-        "<%= config.bin %> preview welcome --send me@example.com"
+        "<%= config.bin %> sdk",
+        "<%= config.bin %> sdk --sequence-id a1b2c3d4",
+        "<%= config.bin %> sdk --json"
       ],
       "flags": {
         "json": {
@@ -601,23 +654,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "send": {
-          "description": "Send test email to this address",
-          "name": "send",
+        "sequence-id": {
+          "description": "Limit output to a single active sequence by ID (default: all active sequences)",
+          "name": "sequence-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "text": {
-          "description": "Output plain text version (for AI agents)",
-          "name": "text",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preview",
+      "id": "sdk",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -627,7 +674,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "preview",
+        "sdk",
         "index.js"
       ]
     },
@@ -718,5 +765,5 @@
       ]
     }
   },
-  "version": "0.0.51-beta.pr54.83"
+  "version": "0.0.52-beta.pr55.85"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.51-beta.pr54.83",
+  "version": "0.0.52-beta.pr55.85",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"