d365fo-mcp 1.0.0

package/dist/metadata/xmlParser.d.ts

@@ -0,0 +1,232 @@
+/**
+ * X++ Metadata XML Parser
+ * Parses D365 F&O AOT XML files (AxClass, AxTable, etc.)
+ */
+import type { XppParseResult, XppClassInfo, XppTableInfo, XppViewInfo } from './types.js';
+export interface XppExtensionMembers {
+    /** Every method the extension defines. */
+    addedMethods: string[];
+    /** Subset of addedMethods that wrap a base method via `next` — the CoC hooks. */
+    cocMethods: string[];
+    /** Raw [SubscribesTo(...)] attribute text, one per subscribing method. */
+    eventSubscriptions: string[];
+}
+/**
+ * Classify the methods of an extension into added / CoC-wrapping / event-
+ * subscribing. Shared by parseExtensionFile (Ax*Extension XML) and the class
+ * extension path in extract-metadata, which reach the same X++ from different
+ * XML shapes and must classify it identically.
+ */
+export declare function extensionMembersFrom(methods: Array<{
+    name: string;
+    source: string;
+}>): XppExtensionMembers;
+export interface XppClassExtensionRecord extends XppExtensionMembers {
+    name: string;
+    baseObjectName: string;
+    /** Intrinsic kind from [ExtensionOf] — the base is not always a class. */
+    baseKind: string;
+    /** Data source / control name for the two-argument intrinsics. */
+    baseMemberName?: string;
+    sourcePath: string;
+    /** Always empty — a class extension adds neither; kept so the record shape
+     *  stays uniform with the Ax*Extension kinds that do. */
+    addedFields: string[];
+    addedIndexes: string[];
+    model: string;
+    type: 'class-extension';
+}
+/**
+ * Build the class-extension record for an AxClass carrying [ExtensionOf(...)],
+ * or null when the class is not an extension.
+ *
+ * The AOT has no AxClassExtension artifact — class extensions are ordinary
+ * AxClass files — so these records are the only source of class-extension rows
+ * in symbols/extension_metadata. Extraction writes them into the
+ * `class-extensions/` folder symbolIndex.indexExtensions already reads, in the
+ * shape parseExtensionFile emits for the other extension kinds (#693).
+ */
+export declare function buildClassExtensionRecord(classInfo: XppClassInfo, model: string): XppClassExtensionRecord | null;
+export declare class XppMetadataParser {
+    private parser;
+    private enhancedParser;
+    constructor();
+    /**
+     * Parse an X++ class file (AxClass XML)
+     */
+    parseClassFile(filePath: string, model?: string): Promise<XppParseResult<XppClassInfo>>;
+    /**
+     * Parse an X++ table file (AxTable XML)
+     */
+    parseTableFile(filePath: string, model?: string): Promise<XppParseResult<XppTableInfo>>;
+    /**
+     * Parse an X++ view/data entity file (AxView or AxDataEntityView XML)
+     */
+    parseViewFile(filePath: string, model?: string): Promise<XppParseResult<XppViewInfo>>;
+    /**
+     * Text of a CDATA-bearing element. xml2js hands back a plain string, unless
+     * the element carries an attribute (mergeAttrs) — then the text sits under
+     * `_` and the raw value is an object.
+     */
+    private cdataText;
+    private parseImplements;
+    /**
+     * The class's declaration line. Rebuilt from the parsed Declaration CDATA so
+     * it reflects what the source actually says; falls back to synthesising one
+     * from XML elements when there is no declaration to read.
+     */
+    private extractClassDeclaration;
+    private parseMethods;
+    private parseVisibility;
+    /**
+     * Parses <AxTableField i:type="AxTableFieldString"> nodes; the field type
+     * comes from the i:type XML attribute (field.$['i:type']), not an element.
+     */
+    private parseFields;
+    private parseIndexes;
+    private parseIndexFields;
+    private parseRelations;
+    private parseConstraints;
+    private parseViewFields;
+    private parseViewRelations;
+    private parseViewPrimaryKeyFields;
+    private parseViewRelationFields;
+    private extractLabelId;
+    private ensureArray;
+    /** Declaration parameters narrowed to the shape XppMethodInfo carries. */
+    private toParameterInfo;
+    /**
+     * Parse Form XML file (AxForm)
+     */
+    parseFormFile(filePath: string, model?: string): Promise<XppParseResult<any>>;
+    /**
+     * Extract form datasources
+     */
+    private extractFormDataSources;
+    /**
+     * Extract form methods
+     */
+    private extractFormMethods;
+    /**
+     * Parse EDT XML file (AxEdt)
+     */
+    parseEdtFile(filePath: string, model?: string): Promise<XppParseResult<any>>;
+    parseSecurityPrivilegeFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        sourcePath: string;
+        entryPoints: Array<{
+            name: string;
+            objectName: string;
+            objectType: string;
+            accessLevel: string;
+        }>;
+    }>>;
+    parseSecurityDutyFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        sourcePath: string;
+        privileges: string[];
+    }>>;
+    parseSecurityRoleFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        description?: string;
+        sourcePath: string;
+        duties: string[];
+    }>>;
+    parseMenuItemFile(filePath: string, itemType: 'display' | 'action' | 'output'): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        targetObject?: string;
+        targetType?: string;
+        securityPrivilege?: string;
+        sourcePath: string;
+    }>>;
+    parseExtensionFile(filePath: string, extensionType: string): Promise<XppParseResult<{
+        name: string;
+        baseObjectName: string;
+        sourcePath: string;
+        addedFields: string[];
+        addedMethods: string[];
+        addedIndexes: string[];
+        cocMethods: string[];
+        eventSubscriptions: string[];
+    }>>;
+    /**
+     * Parse an AxService file: backing class, external name, namespace, and the
+     * exposed service operations (each maps to a public method on the class).
+     */
+    parseServiceFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        serviceClass?: string;
+        externalName?: string;
+        namespace?: string;
+        sourcePath: string;
+        operations: {
+            name: string;
+            method: string;
+            idempotent: boolean;
+        }[];
+    }>>;
+    /**
+     * Parse an AxMap file: the X++ map class (methods) and its table mappings
+     * (each mapping binds the map to a table via field connections).
+     */
+    parseMapFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        extends?: string;
+        sourcePath: string;
+        methods: string[];
+        mappings: {
+            table: string;
+            fieldConnections: number;
+        }[];
+    }>>;
+    /** Parse an AxConfigurationKey file: label + parent key (feature gating tree). */
+    parseConfigurationKeyFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        parentKey?: string;
+        sourcePath: string;
+    }>>;
+    /** Parse an AxLicenseCode file: group, package, type (license-based feature gating). */
+    parseLicenseCodeFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        group?: string;
+        licensePackage?: string;
+        type?: string;
+        sourcePath: string;
+    }>>;
+    /** Parse an AxSecurityPolicy file: row-level (OLS) policy on a primary table. */
+    parseSecurityPolicyFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        label?: string;
+        primaryTable?: string;
+        query?: string;
+        operation?: string;
+        constrainedTable: boolean;
+        sourcePath: string;
+    }>>;
+    /** Parse an AxMacroDictionary file: the #define entries of a shared macro library. */
+    parseMacroFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        sourcePath: string;
+        defines: {
+            name: string;
+            value: string;
+        }[];
+    }>>;
+    /**
+     * Parse an AxServiceGroup file: member services and deployment flag.
+     */
+    parseServiceGroupFile(filePath: string): Promise<XppParseResult<{
+        name: string;
+        autoDeploy: boolean;
+        description?: string;
+        sourcePath: string;
+        services: string[];
+    }>>;
+}
+//# sourceMappingURL=xmlParser.d.ts.map

package/dist/metadata/xmlParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlParser.d.ts","sourceRoot":"","sources":["../../src/metadata/xmlParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EASZ,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iFAAiF;IACjF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,mBAAmB,CAiBrB;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB;6DACyD;IACzD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,GACZ,uBAAuB,GAAG,IAAI,CAgBhC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAoB;IAE1C,cAOC;IAED;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAkE5F;IAED;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAiC5F;IAED;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAmC1F;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,uBAAuB;IAsB/B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;IAKnB,0EAA0E;IAC1E,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAwDlF;IAED;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAiEjF;IAEK,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACzE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnG,CAAC,CAAC,CAmCF;IAEK,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACpE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC,CAqBF;IAEK,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACpE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC,CAsBF;IAEK,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GACxC,OAAO,CAAC,cAAc,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC,CA0BF;IAEK,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC,CAAC,CAqGF;IAED;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE,EAAE,CAAC;KACrE,CAAC,CAAC,CA+BF;IAED;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QAC3D,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACzD,CAAC,CAAC,CA6BF;IAED,kFAAkF;IAC5E,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACxE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC,CAaF;IAED,wFAAwF;IAClF,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACnE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC,CAoBF;IAED,iFAAiF;IAC3E,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACtE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC,CAqBF;IAED,sFAAsF;IAChF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7D,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC5C,CAAC,CAAC,CAoBF;IAED;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;QACpE,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC,CA0BF;CACF"}