@jterrats/smart-deployment 1.0.3

package/lib/parsers/permission-set-parser.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Permission Set Parser
+ * Parses Salesforce Permission Set metadata files (.permissionset-meta.xml)
+ *
+ * @ac AC-1: Parse permission set metadata files
+ * @ac AC-2: Extract object permissions (CRUD + modify/view all)
+ * @ac AC-3: Extract field-level security (FLS) permissions
+ * @ac AC-4: Extract Apex class access permissions
+ * @ac AC-5: Extract Visualforce page access permissions
+ * @ac AC-6: Extract custom permission references
+ * @ac AC-7: Extract application visibility settings
+ * @ac AC-8: Extract tab visibility settings
+ * @ac AC-9: Identify all dependent metadata types
+ *
+ * @issue #22
+ */
+/**
+ * Result of parsing a Permission Set file
+ */
+export type PermissionSetParseResult = {
+    /** Name of the permission set (from filename) */
+    name: string;
+    /** Permission set label */
+    label: string;
+    /** Description */
+    description?: string;
+    /** Whether activation is required */
+    hasActivationRequired?: boolean;
+    /** License type (e.g., 'Salesforce', 'SalesforcePlatform') */
+    license?: string;
+    /** Objects with permissions granted */
+    objectPermissions: string[];
+    /** Fields with FLS permissions granted */
+    fieldPermissions: string[];
+    /** Apex classes with access granted */
+    apexClassAccesses: string[];
+    /** Visualforce pages with access granted */
+    visualforcePageAccesses: string[];
+    /** Custom permissions granted */
+    customPermissions: string[];
+    /** Applications with visibility settings */
+    applicationVisibilities: string[];
+    /** Tabs with visibility settings */
+    tabSettings: string[];
+    /** Custom Metadata Types with access */
+    customMetadataTypeAccesses: string[];
+    /** Flows with access */
+    flowAccesses: string[];
+    /** External data sources with access */
+    externalDataSourceAccesses: string[];
+    /** Custom settings with access */
+    customSettingAccesses: string[];
+    /** User permissions granted */
+    userPermissions: string[];
+    /** All dependencies extracted from this permission set */
+    dependencies: {
+        objects: string[];
+        fields: string[];
+        apexClasses: string[];
+        visualforcePages: string[];
+        customPermissions: string[];
+        applications: string[];
+        tabs: string[];
+        customMetadataTypes: string[];
+        flows: string[];
+        externalDataSources: string[];
+        customSettings: string[];
+        recordTypes: string[];
+    };
+};
+/**
+ * Parse a Permission Set metadata XML file
+ *
+ * @param filePath - Path to the .permissionset-meta.xml file
+ * @param permissionSetName - Name of the permission set (typically from filename)
+ * @returns Parsed permission set metadata with dependencies
+ *
+ * @example
+ * const result = await parsePermissionSet(
+ *   'force-app/main/default/permissionsets/Sales_User.permissionset-meta.xml',
+ *   'Sales_User'
+ * );
+ * console.log(result.objectPermissions); // ['Account', 'Contact', 'Opportunity']
+ * console.log(result.dependencies.apexClasses); // ['AccountService', 'OpportunityHandler']
+ */
+export declare function parsePermissionSet(filePath: string, permissionSetName: string): Promise<PermissionSetParseResult>;

package/lib/parsers/permission-set-parser.js

@@ -0,0 +1,152 @@
+/**
+ * Permission Set Parser
+ * Parses Salesforce Permission Set metadata files (.permissionset-meta.xml)
+ *
+ * @ac AC-1: Parse permission set metadata files
+ * @ac AC-2: Extract object permissions (CRUD + modify/view all)
+ * @ac AC-3: Extract field-level security (FLS) permissions
+ * @ac AC-4: Extract Apex class access permissions
+ * @ac AC-5: Extract Visualforce page access permissions
+ * @ac AC-6: Extract custom permission references
+ * @ac AC-7: Extract application visibility settings
+ * @ac AC-8: Extract tab visibility settings
+ * @ac AC-9: Identify all dependent metadata types
+ *
+ * @issue #22
+ */
+import { readFile } from 'node:fs/promises';
+import { XMLParser } from 'fast-xml-parser';
+/**
+ * Normalize value to array (handles XML parser returning single object vs array)
+ */
+function normalizeArray(value) {
+    if (!value)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+/**
+ * Parse a Permission Set metadata XML file
+ *
+ * @param filePath - Path to the .permissionset-meta.xml file
+ * @param permissionSetName - Name of the permission set (typically from filename)
+ * @returns Parsed permission set metadata with dependencies
+ *
+ * @example
+ * const result = await parsePermissionSet(
+ *   'force-app/main/default/permissionsets/Sales_User.permissionset-meta.xml',
+ *   'Sales_User'
+ * );
+ * console.log(result.objectPermissions); // ['Account', 'Contact', 'Opportunity']
+ * console.log(result.dependencies.apexClasses); // ['AccountService', 'OpportunityHandler']
+ */
+export async function parsePermissionSet(filePath, permissionSetName) {
+    // Read and parse XML
+    const xmlContent = await readFile(filePath, 'utf-8');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        parseAttributeValue: true,
+        trimValues: true,
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(xmlContent);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse Permission Set XML at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Type assertion with validation
+    const root = parsed;
+    if (!root.PermissionSet) {
+        throw new Error(`Invalid Permission Set XML structure at ${filePath}: missing PermissionSet root element`);
+    }
+    const metadata = root.PermissionSet;
+    // Normalize arrays
+    const objectPermissions = normalizeArray(metadata.objectPermissions);
+    const fieldPermissions = normalizeArray(metadata.fieldPermissions);
+    const classAccesses = normalizeArray(metadata.classAccesses);
+    const pageAccesses = normalizeArray(metadata.pageAccesses);
+    const customPermissions = normalizeArray(metadata.customPermissions);
+    const applicationVisibilities = normalizeArray(metadata.applicationVisibilities);
+    const tabSettings = normalizeArray(metadata.tabSettings);
+    const customMetadataTypeAccesses = normalizeArray(metadata.customMetadataTypeAccesses);
+    const flowAccesses = normalizeArray(metadata.flowAccesses);
+    const externalDataSourceAccesses = normalizeArray(metadata.externalDataSourceAccesses);
+    const customSettingAccesses = normalizeArray(metadata.customSettingAccesses);
+    const userPermissions = normalizeArray(metadata.userPermissions);
+    const recordTypeVisibilities = normalizeArray(metadata.recordTypeVisibilities);
+    // Extract object names
+    const objectNames = objectPermissions.map((perm) => perm.object);
+    // Extract field names (format: ObjectName.FieldName)
+    const fieldNames = fieldPermissions.map((perm) => perm.field);
+    // Extract Apex class names
+    const apexClassNames = classAccesses.map((access) => access.apexClass);
+    // Extract Visualforce page names
+    const visualforcePageNames = pageAccesses.map((access) => access.apexPage);
+    // Extract custom permission names
+    const customPermissionNames = customPermissions
+        .filter((perm) => perm.enabled)
+        .map((perm) => perm.name);
+    // Extract application names
+    const applicationNames = applicationVisibilities.map((app) => app.application);
+    // Extract tab names
+    const tabNames = tabSettings.map((tab) => tab.tab);
+    // Extract custom metadata type names
+    const customMetadataTypeNames = customMetadataTypeAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.name);
+    // Extract flow names
+    const flowNames = flowAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.flow);
+    // Extract external data source names
+    const externalDataSourceNames = externalDataSourceAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.externalDataSource);
+    // Extract custom setting names
+    const customSettingNames = customSettingAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.name);
+    // Extract user permission names
+    const userPermissionNames = userPermissions
+        .filter((perm) => perm.enabled)
+        .map((perm) => perm.name);
+    // Extract record type names
+    const recordTypeNames = recordTypeVisibilities
+        .filter((rt) => rt.visible)
+        .map((rt) => rt.recordType);
+    // Build result
+    return {
+        name: permissionSetName,
+        label: metadata.label,
+        description: metadata.description,
+        hasActivationRequired: metadata.hasActivationRequired,
+        license: metadata.license,
+        objectPermissions: objectNames,
+        fieldPermissions: fieldNames,
+        apexClassAccesses: apexClassNames,
+        visualforcePageAccesses: visualforcePageNames,
+        customPermissions: customPermissionNames,
+        applicationVisibilities: applicationNames,
+        tabSettings: tabNames,
+        customMetadataTypeAccesses: customMetadataTypeNames,
+        flowAccesses: flowNames,
+        externalDataSourceAccesses: externalDataSourceNames,
+        customSettingAccesses: customSettingNames,
+        userPermissions: userPermissionNames,
+        dependencies: {
+            objects: objectNames,
+            fields: fieldNames,
+            apexClasses: apexClassNames,
+            visualforcePages: visualforcePageNames,
+            customPermissions: customPermissionNames,
+            applications: applicationNames,
+            tabs: tabNames,
+            customMetadataTypes: customMetadataTypeNames,
+            flows: flowNames,
+            externalDataSources: externalDataSourceNames,
+            customSettings: customSettingNames,
+            recordTypes: recordTypeNames,
+        },
+    };
+}
+//# sourceMappingURL=permission-set-parser.js.map

package/lib/parsers/permission-set-parser.js.map

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

package/lib/parsers/profile-parser.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Profile Parser
+ * Parses Salesforce Profile metadata files (.profile-meta.xml)
+ *
+ * @ac US-020-AC-1: Extract object permissions (CRUD + modify/view all)
+ * @ac US-020-AC-2: Extract field-level security (FLS) permissions
+ * @ac US-020-AC-3: Extract Apex class access permissions
+ * @ac US-020-AC-4: Extract page layout assignments
+ * @ac US-020-AC-5: Extract record type visibility
+ * @ac US-020-AC-6: Extract application assignments
+ * @ac US-020-AC-7: Link to all dependent metadata
+ *
+ * @issue #20
+ */
+/**
+ * Result of parsing a Profile file
+ */
+export type ProfileParseResult = {
+    /** Name of the profile (from filename) */
+    name: string;
+    /** Whether this is a custom profile */
+    custom: boolean;
+    /** Description */
+    description?: string;
+    /** User license */
+    userLicense?: string;
+    /** Objects with permissions granted */
+    objectPermissions: string[];
+    /** Fields with FLS permissions granted */
+    fieldPermissions: string[];
+    /** Apex classes with access granted */
+    apexClassAccesses: string[];
+    /** Visualforce pages with access granted */
+    visualforcePageAccesses: string[];
+    /** Page layout assignments */
+    layoutAssignments: string[];
+    /** Record types with visibility */
+    recordTypeVisibilities: string[];
+    /** Applications assigned */
+    applicationVisibilities: string[];
+    /** Tabs with visibility settings */
+    tabVisibilities: string[];
+    /** Custom permissions granted */
+    customPermissions: string[];
+    /** Custom Metadata Types with access */
+    customMetadataTypeAccesses: string[];
+    /** Flows with access */
+    flowAccesses: string[];
+    /** User permissions granted */
+    userPermissions: string[];
+    /** All dependencies extracted from this profile */
+    dependencies: {
+        objects: string[];
+        fields: string[];
+        apexClasses: string[];
+        visualforcePages: string[];
+        layouts: string[];
+        recordTypes: string[];
+        applications: string[];
+        tabs: string[];
+        customPermissions: string[];
+        customMetadataTypes: string[];
+        flows: string[];
+    };
+};
+/**
+ * Parse a Profile metadata XML file
+ *
+ * @param filePath - Path to the .profile-meta.xml file
+ * @param profileName - Name of the profile (typically from filename)
+ * @returns Parsed profile metadata with dependencies
+ *
+ * @example
+ * const result = await parseProfile(
+ *   'force-app/main/default/profiles/Admin.profile-meta.xml',
+ *   'Admin'
+ * );
+ * console.log(result.objectPermissions); // ['Account', 'Contact', 'Opportunity']
+ * console.log(result.dependencies.apexClasses); // ['AccountService', 'OpportunityHandler']
+ */
+export declare function parseProfile(filePath: string, profileName: string): Promise<ProfileParseResult>;

package/lib/parsers/profile-parser.js

@@ -0,0 +1,141 @@
+/**
+ * Profile Parser
+ * Parses Salesforce Profile metadata files (.profile-meta.xml)
+ *
+ * @ac US-020-AC-1: Extract object permissions (CRUD + modify/view all)
+ * @ac US-020-AC-2: Extract field-level security (FLS) permissions
+ * @ac US-020-AC-3: Extract Apex class access permissions
+ * @ac US-020-AC-4: Extract page layout assignments
+ * @ac US-020-AC-5: Extract record type visibility
+ * @ac US-020-AC-6: Extract application assignments
+ * @ac US-020-AC-7: Link to all dependent metadata
+ *
+ * @issue #20
+ */
+import { readFile } from 'node:fs/promises';
+import { XMLParser } from 'fast-xml-parser';
+/**
+ * Normalize value to array (handles XML parser returning single object vs array)
+ */
+function normalizeArray(value) {
+    if (!value)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+/**
+ * Parse a Profile metadata XML file
+ *
+ * @param filePath - Path to the .profile-meta.xml file
+ * @param profileName - Name of the profile (typically from filename)
+ * @returns Parsed profile metadata with dependencies
+ *
+ * @example
+ * const result = await parseProfile(
+ *   'force-app/main/default/profiles/Admin.profile-meta.xml',
+ *   'Admin'
+ * );
+ * console.log(result.objectPermissions); // ['Account', 'Contact', 'Opportunity']
+ * console.log(result.dependencies.apexClasses); // ['AccountService', 'OpportunityHandler']
+ */
+export async function parseProfile(filePath, profileName) {
+    // Read and parse XML
+    const xmlContent = await readFile(filePath, 'utf-8');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        parseAttributeValue: true,
+        trimValues: true,
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(xmlContent);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse Profile XML at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Type assertion with validation
+    const root = parsed;
+    if (!root.Profile) {
+        throw new Error(`Invalid Profile XML structure at ${filePath}: missing Profile root element`);
+    }
+    const metadata = root.Profile;
+    // Normalize arrays
+    const objectPermissions = normalizeArray(metadata.objectPermissions);
+    const fieldPermissions = normalizeArray(metadata.fieldPermissions);
+    const classAccesses = normalizeArray(metadata.classAccesses);
+    const pageAccesses = normalizeArray(metadata.pageAccesses);
+    const layoutAssignments = normalizeArray(metadata.layoutAssignments);
+    const recordTypeVisibilities = normalizeArray(metadata.recordTypeVisibilities);
+    const applicationVisibilities = normalizeArray(metadata.applicationVisibilities);
+    const tabVisibilities = normalizeArray(metadata.tabVisibilities);
+    const customPermissions = normalizeArray(metadata.customPermissions);
+    const customMetadataTypeAccesses = normalizeArray(metadata.customMetadataTypeAccesses);
+    const flowAccesses = normalizeArray(metadata.flowAccesses);
+    const userPermissions = normalizeArray(metadata.userPermissions);
+    // Extract object names
+    const objectNames = objectPermissions.map((perm) => perm.object);
+    // Extract field names (format: ObjectName.FieldName)
+    const fieldNames = fieldPermissions.map((perm) => perm.field);
+    // Extract Apex class names
+    const apexClassNames = classAccesses.map((access) => access.apexClass);
+    // Extract Visualforce page names
+    const visualforcePageNames = pageAccesses.map((access) => access.apexPage);
+    // Extract layout names
+    const layoutNames = layoutAssignments.map((assignment) => assignment.layout);
+    // Extract record type names
+    const recordTypeNames = recordTypeVisibilities
+        .filter((rt) => rt.visible)
+        .map((rt) => rt.recordType);
+    // Extract application names
+    const applicationNames = applicationVisibilities.map((app) => app.application);
+    // Extract tab names
+    const tabNames = tabVisibilities.map((tab) => tab.tab);
+    // Extract custom permission names
+    const customPermissionNames = customPermissions
+        .filter((perm) => perm.enabled)
+        .map((perm) => perm.name);
+    // Extract custom metadata type names
+    const customMetadataTypeNames = customMetadataTypeAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.name);
+    // Extract flow names
+    const flowNames = flowAccesses
+        .filter((access) => access.enabled)
+        .map((access) => access.flow);
+    // Extract user permission names
+    const userPermissionNames = userPermissions
+        .filter((perm) => perm.enabled)
+        .map((perm) => perm.name);
+    // Build result
+    return {
+        name: profileName,
+        custom: metadata.custom ?? false,
+        description: metadata.description,
+        userLicense: metadata.userLicense,
+        objectPermissions: objectNames,
+        fieldPermissions: fieldNames,
+        apexClassAccesses: apexClassNames,
+        visualforcePageAccesses: visualforcePageNames,
+        layoutAssignments: layoutNames,
+        recordTypeVisibilities: recordTypeNames,
+        applicationVisibilities: applicationNames,
+        tabVisibilities: tabNames,
+        customPermissions: customPermissionNames,
+        customMetadataTypeAccesses: customMetadataTypeNames,
+        flowAccesses: flowNames,
+        userPermissions: userPermissionNames,
+        dependencies: {
+            objects: objectNames,
+            fields: fieldNames,
+            apexClasses: apexClassNames,
+            visualforcePages: visualforcePageNames,
+            layouts: layoutNames,
+            recordTypes: recordTypeNames,
+            applications: applicationNames,
+            tabs: tabNames,
+            customPermissions: customPermissionNames,
+            customMetadataTypes: customMetadataTypeNames,
+            flows: flowNames,
+        },
+    };
+}
+//# sourceMappingURL=profile-parser.js.map

package/lib/parsers/profile-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-parser.js","sourceRoot":"","sources":["../../src/parsers/profile-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAuD5C;;GAEG;AACH,SAAS,cAAc,CAAI,KAA0B;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,WAAmB;IAEnB,qBAAqB;IACrB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,IAAI;QACzB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxG,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,IAAI,GAAG,MAAuC,CAAC;IACrD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,gCAAgC,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IAE9B,mBAAmB;IACnB,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC/E,MAAM,uBAAuB,GAAG,cAAc,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IACjF,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjE,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,0BAA0B,GAAG,cAAc,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IACvF,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEjE,uBAAuB;IACvB,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,qDAAqD;IACrD,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9D,2BAA2B;IAC3B,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEvE,iCAAiC;IACjC,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3E,uBAAuB;IACvB,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7E,4BAA4B;IAC5B,MAAM,eAAe,GAAG,sBAAsB;SAC3C,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC;SAC1B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAE9B,4BAA4B;IAC5B,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE/E,oBAAoB;IACpB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEvD,kCAAkC;IAClC,MAAM,qBAAqB,GAAG,iBAAiB;SAC5C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5B,qCAAqC;IACrC,MAAM,uBAAuB,GAAG,0BAA0B;SACvD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;SAClC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,qBAAqB;IACrB,MAAM,SAAS,GAAG,YAAY;SAC3B,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;SAClC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,gCAAgC;IAChC,MAAM,mBAAmB,GAAG,eAAe;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5B,eAAe;IACf,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,KAAK;QAChC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,UAAU;QAC5B,iBAAiB,EAAE,cAAc;QACjC,uBAAuB,EAAE,oBAAoB;QAC7C,iBAAiB,EAAE,WAAW;QAC9B,sBAAsB,EAAE,eAAe;QACvC,uBAAuB,EAAE,gBAAgB;QACzC,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,qBAAqB;QACxC,0BAA0B,EAAE,uBAAuB;QACnD,YAAY,EAAE,SAAS;QACvB,eAAe,EAAE,mBAAmB;QACpC,YAAY,EAAE;YACZ,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,cAAc;YAC3B,gBAAgB,EAAE,oBAAoB;YACtC,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,eAAe;YAC5B,YAAY,EAAE,gBAAgB;YAC9B,IAAI,EAAE,QAAQ;YACd,iBAAiB,EAAE,qBAAqB;YACxC,mBAAmB,EAAE,uBAAuB;YAC5C,KAAK,EAAE,SAAS;SACjB;KACF,CAAC;AACJ,CAAC"}

package/lib/parsers/visualforce-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Visualforce dependency types
+ */
+export type VisualforceDependencyType = 'apex_controller' | 'apex_extension' | 'vf_component' | 'standard_controller' | 'custom_component';
+/**
+ * Represents a dependency found in a Visualforce page/component
+ */
+export type VisualforceDependency = {
+    type: VisualforceDependencyType;
+    name: string;
+    namespace?: string;
+};
+/**
+ * Result of parsing a Visualforce page/component
+ */
+export type VisualforceParseResult = {
+    name: string;
+    type: 'page' | 'component';
+    apexController?: string;
+    apexExtensions: string[];
+    standardController?: string;
+    recordSetVar?: string;
+    components: string[];
+    dependencies: VisualforceDependency[];
+};
+/**
+ * Parse a Visualforce page or component and extract dependencies
+ *
+ * @param fileName - Name of the Visualforce file (with extension)
+ * @param vfContent - Content of the Visualforce file
+ * @returns VisualforceParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the file cannot be parsed or has invalid extension
+ *
+ * @ac US-018-AC-5: Parse both pages and components
+ * @ac US-018-AC-6: Validate file extension (.page or .component)
+ * @ac US-018-AC-7: Handle namespace prefixes in controllers and components
+ *
+ * @example
+ * ```typescript
+ * const result = parseVisualforce('MyPage.page', vfContent);
+ * console.log(result.apexController); // 'MyController'
+ * console.log(result.components); // ['c:MyComponent']
+ * console.log(result.standardController); // 'Account'
+ * ```
+ */
+export declare function parseVisualforce(fileName: string, vfContent: string): VisualforceParseResult;