mcp-server-sfmc 0.4.3 → 1.0.0

package/dist/conversion-rules.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Shared conversion rules for SSJS ↔ AMPscript and MCN rewriting.
+ *
+ * Single source of truth for mapping tables and deterministic transformation
+ * logic used by:
+ *   - rewrite_for_mcn tool
+ *   - convertSsjsToAmpscript tool
+ *   - convertAmpscriptToSsjs tool
+ */
+export interface ChangeEntry {
+    line: number;
+    description: string;
+}
+export interface FlaggedSection {
+    line: number;
+    code: string;
+    reason: string;
+}
+export interface ConversionResult {
+    convertedCode: string;
+    changes: ChangeEntry[];
+    flaggedSections: FlaggedSection[];
+}
+/**
+ * Maps a Platform.Function.X name (lowercase) to the equivalent AMPscript
+ * canonical function name. Only functions with a direct 1:1 equivalent are
+ * included.
+ */
+export declare const PLATFORM_FUNCTION_TO_AMP: Readonly<Record<string, string>>;
+/**
+ * Maps an AMPscript function name (lowercase) to its SSJS Platform.Function
+ * equivalent name (the part after "Platform.Function.").
+ */
+export declare const AMP_TO_PLATFORM_FUNCTION: Readonly<Record<string, string>>;
+/**
+ * Ordered list of [RegExp, replacement] pairs to convert .NET format specifiers
+ * in FormatDate() calls to Java SimpleDateFormat equivalents.
+ * Applied sequentially so more specific patterns match before general ones.
+ */
+export declare const DOTNET_TO_JAVA_FORMAT_REPLACEMENTS: ReadonlyArray<[RegExp, string]>;
+/**
+ * Set of .NET standard format shorthands that have no direct Java equivalent
+ * and must be replaced with an explicit pattern.
+ */
+export declare const DOTNET_STANDARD_SHORTHANDS: ReadonlySet<string>;
+/**
+ * Set of AMPscript function names (lowercase) that are available only in
+ * CloudPages / web content context and are not supported in Marketing Cloud Next.
+ */
+export declare const CLOUDPAGES_ONLY_FUNCTIONS: ReadonlySet<string>;
+/**
+ * Patterns in SSJS code that indicate constructs with no AMPscript equivalent.
+ * Any SSJS block containing these patterns is classified as "Not migratable"
+ * in check_mcn_compatibility and marked MANUAL_REWRITE_REQUIRED in rewriting tools.
+ */
+export declare const NON_MIGRATABLE_SSJS_PATTERNS: ReadonlyArray<{
+    pattern: RegExp;
+    reason: string;
+}>;
+/**
+ * Convert a SSJS code block to equivalent AMPscript using deterministic rules.
+ *
+ * Handles:
+ * - `Platform.Function.X(args)` → `X(args)`
+ * - `Platform.Variable.GetValue("name")` → `\@name`
+ * - `Platform.Variable.SetValue("name", val)` → `SET \@name = val`
+ * - `Platform.Response.Write(expr)` → `OutputLine(expr)`
+ * - `var x = expr;` → `SET \@x = expr`
+ * - `var x;` → `VAR \@x`
+ * - Control flow: if/else if/else/} → IF/ELSEIF/ELSE/ENDIF
+ * - `for (var i = start; i <= end; i++) {` → `FOR \@i = start TO end DO`
+ *
+ * Flags non-migratable constructs as MANUAL_REWRITE_REQUIRED.
+ * @param code - SSJS source code (may include `<script runat="server">` tags).
+ * @returns {ConversionResult} Conversion result with converted code, change log, and flagged sections.
+ */
+export declare function ssjsToAmpscript(code: string): ConversionResult;
+/**
+ * Convert AMPscript code to equivalent SSJS using deterministic rules.
+ *
+ * Handles:
+ * - `%%[ SET \@x = expr ]%%` → `var x = expr;`
+ * - `%%[ VAR \@x, \@y ]%%` → `var x, y;`
+ * - `%%[ IF cond THEN / ELSEIF / ELSE / ENDIF ]%%` → JS control flow
+ * - `%%[ FOR \@i = start TO end DO / NEXT \@i ]%%` → for loop
+ * - `%%=Output(\@x)=%%` / `%%=OutputLine(\@x)=%%` → `Platform.Response.Write(x)`
+ * - `%%=FunctionName(args)=%%` → `Platform.Response.Write(Platform.Function.FunctionName(args))`
+ * - Known AMPscript functions → Platform.Function.X equivalents
+ * - `\@variable` references → bare variable names
+ * @param code - AMPscript source code.
+ * @returns {ConversionResult} Conversion result with converted SSJS, change log, and flagged sections.
+ */
+export declare function ampscriptToSsjs(code: string): ConversionResult;
+/**
+ * Strip `@` prefix from AMPscript variable references in an expression.
+ * @param expr - Expression possibly containing `@varName` references.
+ * @returns {string} Expression with `@` prefixes removed.
+ */
+export declare function stripAmpVars(expr: string): string;
+export interface McnRewriteOptions {
+    /** Function to check if an AMPscript function is MCN-supported */
+    isMcnSupportedFn: (name: string) => boolean;
+    /** Function to get MCN behavioral notes for a function */
+    getMcnNotesFn: (name: string) => string | null;
+}
+export interface McnRewriteResult {
+    rewrittenCode: string;
+    changes: Array<{
+        line: number;
+        type: string;
+        description: string;
+    }>;
+    nonMigratableItems: Array<{
+        line: number;
+        code: string;
+        reason: string;
+    }>;
+    difficulty: 'ready' | 'minor' | 'significant' | 'not-migratable';
+    summary: string;
+}
+/**
+ * Rewrite AMPscript code to be compatible with Marketing Cloud Next.
+ *
+ * Performs deterministic rewrites:
+ * - FormatDate(StringToDate(x), fmt) → FormatDate(x, fmt)
+ * - .NET → Java SimpleDateFormat format string conversions in FormatDate()
+ * - Lookup with odd arg count → annotated with comment
+ * - MCE-only functions → marked with %%-- NOT SUPPORTED IN MCN --%% annotation
+ * @param code - AMPscript source code to rewrite.
+ * @param options - Functions for MCN support checking and note retrieval.
+ * @returns {McnRewriteResult} Rewrite result with rewritten code, change log, and difficulty assessment.
+ */
+export declare function rewriteAmpForMcn(code: string, options: McnRewriteOptions): McnRewriteResult;
+/**
+ * Count the number of top-level comma-separated arguments in a function
+ * argument string (respects nested parentheses).
+ * @param argsStr - The argument string (contents between outer parens).
+ * @returns {number} Number of top-level arguments.
+ */
+export declare function countArgs(argsStr: string): number;
+/**
+ * Determine whether a SSJS code block contains only patterns that can be
+ * automatically converted to AMPscript. Returns true when no non-migratable
+ * patterns are found.
+ * @param blockCode - SSJS block code (without `<script>` tags).
+ * @returns {boolean} True when the block is likely convertible.
+ */
+export declare function isSsjsBlockConvertible(blockCode: string): boolean;
+//# sourceMappingURL=conversion-rules.d.ts.map

package/dist/conversion-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-rules.d.ts","sourceRoot":"","sources":["../src/conversion-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,cAAc,EAAE,CAAC;CACrC;AAMD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiDrE,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0CrE,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAG9E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAezD,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CASxD,CAAC;AAMH;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAmC3F,CAAC;AAMF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6J9D;AAsBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqG9D;AA+LD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD,MAAM,WAAW,iBAAiB;IAC9B,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,0DAA0D;IAC1D,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAiL3F;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQjE"}