d365fo-mcp 1.0.0

package/dist/utils/xppConfigProvider.d.ts

@@ -0,0 +1,48 @@
+/**
+ * XPP Config Provider
+ * Reads Power Platform Tools XPP configuration files to discover
+ * custom and Microsoft package paths for UDE development.
+ */
+export interface XppEnvironmentConfig {
+    configName: string;
+    version: string;
+    customPackagesPath: string;
+    microsoftPackagesPath: string;
+    referencePackagesPaths: string[];
+    xrefDbName?: string;
+    xrefDbServer?: string;
+    description?: string;
+    fullFilename: string;
+}
+export declare class XppConfigProvider {
+    private configDir;
+    private cache;
+    constructor(configDir?: string);
+    /**
+     * Parse a config filename into name + version.
+     * Pattern: {name}___{version}.json
+     */
+    parseConfigFilename(filename: string): {
+        configName: string;
+        version: string;
+    } | null;
+    /**
+     * List all available XPP configs, sorted by modification time (newest first).
+     */
+    listConfigs(): Promise<XppEnvironmentConfig[]>;
+    /**
+     * Get the active XPP config.
+     * If configName is provided, selects that specific config.
+     * Otherwise auto-selects the newest.
+     */
+    getActiveConfig(configName?: string): Promise<XppEnvironmentConfig | null>;
+    /**
+     * Check if XPP configs exist (indicates UDE environment).
+     */
+    hasConfigs(): Promise<boolean>;
+    /**
+     * Invalidate cached config list.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=xppConfigProvider.d.ts.map

package/dist/utils/xppConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xppConfigProvider.d.ts","sourceRoot":"","sources":["../../src/utils/xppConfigProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAuC;IAEpD,YAAY,SAAS,CAAC,EAAE,MAAM,EAM7B;IAED;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAMpF;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAyDnD;IAED;;;;OAIG;IACG,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAwB/E;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAGnC;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAEjB;CACF"}

package/dist/utils/xppConfigProvider.js

@@ -0,0 +1,121 @@
+/**
+ * XPP Config Provider
+ * Reads Power Platform Tools XPP configuration files to discover
+ * custom and Microsoft package paths for UDE development.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export class XppConfigProvider {
+    configDir;
+    cache = null;
+    constructor(configDir) {
+        this.configDir = configDir ||
+            path.join(process.env.LOCALAPPDATA || path.join(process.env.USERPROFILE || '', 'AppData', 'Local'), 'Microsoft', 'Dynamics365', 'XPPConfig');
+    }
+    /**
+     * Parse a config filename into name + version.
+     * Pattern: {name}___{version}.json
+     */
+    parseConfigFilename(filename) {
+        // Version is typically dotted-numeric (e.g., 10.0.2428.63) but any non-empty
+        // string after ___ is accepted for resilience to future format changes.
+        const match = filename.match(/^(.+)___(.+)\.json$/);
+        if (!match)
+            return null;
+        return { configName: match[1], version: match[2] };
+    }
+    /**
+     * List all available XPP configs, sorted by modification time (newest first).
+     */
+    async listConfigs() {
+        if (this.cache)
+            return [...this.cache];
+        let entries;
+        try {
+            entries = await fs.readdir(this.configDir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        const jsonFiles = entries.filter(e => e.isFile() && e.name.endsWith('.json'));
+        const withStats = await Promise.all(jsonFiles.map(async (entry) => {
+            const fullPath = path.join(this.configDir, entry.name);
+            try {
+                const stat = await fs.stat(fullPath);
+                return { entry, mtime: stat.mtimeMs };
+            }
+            catch {
+                return null;
+            }
+        }));
+        const valid = withStats.filter(Boolean);
+        valid.sort((a, b) => b.mtime - a.mtime);
+        const configs = [];
+        for (const { entry } of valid) {
+            const parsed = this.parseConfigFilename(entry.name);
+            if (!parsed)
+                continue;
+            const fullPath = path.join(this.configDir, entry.name);
+            try {
+                const raw = await fs.readFile(fullPath, 'utf-8');
+                const json = JSON.parse(raw);
+                if (!json.ModelStoreFolder || !json.FrameworkDirectory)
+                    continue;
+                configs.push({
+                    configName: parsed.configName,
+                    version: parsed.version,
+                    customPackagesPath: json.ModelStoreFolder,
+                    microsoftPackagesPath: json.FrameworkDirectory,
+                    referencePackagesPaths: json.ReferencePackagesPaths ?? [],
+                    xrefDbName: json.CrossReferencesDatabaseName,
+                    xrefDbServer: json.CrossReferencesDbServerName,
+                    description: json.Description,
+                    fullFilename: entry.name.replace(/\.json$/, ''),
+                });
+            }
+            catch (err) {
+                console.warn(`[XppConfigProvider] Skipping malformed config "${entry.name}":`, err instanceof SyntaxError ? 'invalid JSON' : String(err));
+            }
+        }
+        this.cache = configs;
+        return configs;
+    }
+    /**
+     * Get the active XPP config.
+     * If configName is provided, selects that specific config.
+     * Otherwise auto-selects the newest.
+     */
+    async getActiveConfig(configName) {
+        const configs = await this.listConfigs();
+        if (configs.length === 0)
+            return null;
+        if (configName) {
+            return configs.find(c => c.fullFilename === configName ||
+                c.configName === configName) || null;
+        }
+        // Warn when multiple configs exist and none is pinned, since auto-selection
+        // can be unpredictable across multiple running server instances.
+        if (configs.length > 1) {
+            const names = configs.map(c => c.fullFilename).join(', ');
+            console.warn(`[XppConfigProvider] XPP_CONFIG_NAME is not set and ${configs.length} configs were found ` +
+                `(${names}). Auto-selecting the newest: "${configs[0].fullFilename}". ` +
+                `Set XPP_CONFIG_NAME in your .env file to pin a specific config and avoid unpredictable ` +
+                `behaviour when running multiple server instances.`);
+        }
+        return configs[0]; // already sorted by mtime desc
+    }
+    /**
+     * Check if XPP configs exist (indicates UDE environment).
+     */
+    async hasConfigs() {
+        const configs = await this.listConfigs();
+        return configs.length > 0;
+    }
+    /**
+     * Invalidate cached config list.
+     */
+    clearCache() {
+        this.cache = null;
+    }
+}
+//# sourceMappingURL=xppConfigProvider.js.map

package/dist/utils/xppConfigProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xppConfigProvider.js","sourceRoot":"","sources":["../../src/utils/xppConfigProvider.ts"],"names":[],"mappings":"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"}

package/dist/utils/xppDocGen.d.ts

@@ -0,0 +1,39 @@
+/**
+ * X++ XML documentation comment generator.
+ *
+ * D365FO best practice: every public and protected method must be documented
+ * with /// <summary>, /// <param name="…"> and /// <returns> blocks.
+ *
+ * This module auto-generates those comments when they are absent so that
+ * generated AX object XML always conforms to the standard.
+ */
+/**
+ * Ensures there is exactly one blank line between the last member-variable
+ * declaration and the closing `}` of the class body in an X++ class declaration.
+ *
+ * D365FO convention (visible in all Microsoft standard classes):
+ *   public class MyClass
+ *   {
+ *       TransDate fromDate;
+ *       str       selectedZoneIds;
+ *                                    ← blank line here
+ *   }
+ *
+ * Idempotent: already-correct declarations (and empty class bodies) are returned
+ * unchanged.
+ */
+export declare function ensureBlankLineBeforeClosingBrace(declaration: string): string;
+/**
+ * Ensures every public or protected X++ method / class declaration has a
+ * leading XML doc-comment block (/// <summary> … </summary>) including
+ * `<param>` entries for every parameter and a `<returns>` entry for non-void
+ * return types.
+ *
+ * When a doc block is already present (e.g. authored by the AI model) it is
+ * kept verbatim, but any missing `<param>` / `<returns>` elements are appended
+ * so the result always satisfies the D365FO Best Practice documentation rules.
+ * Idempotent — a complete block is returned unchanged. Private / internal
+ * methods are left as-is per D365FO convention.
+ */
+export declare function ensureXppDocComment(source: string): string;
+//# sourceMappingURL=xppDocGen.d.ts.map

package/dist/utils/xppDocGen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xppDocGen.d.ts","sourceRoot":"","sources":["../../src/utils/xppDocGen.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8TH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0C1D"}