@acquis-consulting/asm 1.0.5

package/dist/utils/decomposePermissions.js

@@ -0,0 +1,188 @@
+/**
+ * Custom post-retrieve decomposition of Profile and PermissionSet XML files.
+ *
+ * Salesforce DX's built-in decompose flags (decomposeProfilesV2Beta / decomposePermissionSetBeta)
+ * are unreliable, so we replicate the decomposition ourselves after a successful retrieve.
+ *
+ * Each permission block in a monolithic .profile-meta.xml or .permissionset-meta.xml is written
+ * as its own file in a sub-directory, enabling cherry-picking in the metadata diff UI.
+ */
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { join, dirname, basename } from 'path';
+const PERMISSION_CONFIGS = {
+    fieldPermissions: { subDir: 'fieldPermissions', fileSuffix: 'fieldPermission', keyElement: 'field' },
+    objectPermissions: { subDir: 'objectPermissions', fileSuffix: 'objectPermission', keyElement: 'object' },
+    classAccesses: { subDir: 'classAccesses', fileSuffix: 'classAccess', keyElement: 'apexClass' },
+    pageAccesses: { subDir: 'pageAccesses', fileSuffix: 'pageAccess', keyElement: 'apexPage' },
+    recordTypeVisibilities: { subDir: 'recordTypeVisibilities', fileSuffix: 'recordTypeVisibility', keyElement: 'recordType' },
+    tabVisibilities: { subDir: 'tabVisibilities', fileSuffix: 'tabVisibility', keyElement: 'tab' },
+    userPermissions: { subDir: 'userPermissions', fileSuffix: 'userPermission', keyElement: 'name' },
+    applicationVisibilities: { subDir: 'applicationVisibilities', fileSuffix: 'applicationVisibility', keyElement: 'application' },
+    flowAccesses: { subDir: 'flowAccesses', fileSuffix: 'flowAccess', keyElement: 'flow' },
+    layoutAssignments: { subDir: 'layoutAssignments', fileSuffix: 'layoutAssignment', keyElement: 'layout' },
+    customPermissions: { subDir: 'customPermissions', fileSuffix: 'customPermission', keyElement: 'name' },
+};
+/**
+ * Extract all `<elementName>…</elementName>` top-level blocks from an XML string.
+ * Returns each block's raw XML content (including the wrapping tags).
+ */
+function extractBlocks(xml, elementName) {
+    const blocks = [];
+    const openTag = `<${elementName}>`;
+    const closeTag = `</${elementName}>`;
+    let pos = 0;
+    while (pos < xml.length) {
+        const start = xml.indexOf(openTag, pos);
+        if (start === -1)
+            break;
+        const end = xml.indexOf(closeTag, start);
+        if (end === -1)
+            break;
+        blocks.push(xml.slice(start, end + closeTag.length));
+        pos = end + closeTag.length;
+    }
+    return blocks;
+}
+/**
+ * Extract the text content of a named child element from an XML block.
+ */
+function extractChildValue(block, childName) {
+    const match = block.match(new RegExp(`<${childName}>([^<]+)<\/${childName}>`));
+    return match ? match[1].trim() : null;
+}
+/**
+ * Remove all occurrences of `<elementName>…</elementName>` blocks from an XML string.
+ */
+function removeBlocks(xml, elementName) {
+    const openTag = `<${elementName}>`;
+    const closeTag = `</${elementName}>`;
+    let result = xml;
+    let start;
+    while ((start = result.indexOf(openTag)) !== -1) {
+        const end = result.indexOf(closeTag, start);
+        if (end === -1)
+            break;
+        // Also eat a trailing newline if present
+        const afterEnd = end + closeTag.length;
+        const hasTrailingNewline = result[afterEnd] === '\n';
+        result = result.slice(0, start) + result.slice(afterEnd + (hasTrailingNewline ? 1 : 0));
+    }
+    return result;
+}
+/**
+ * Decompose a single monolithic profile/permission-set XML file into sub-directory files.
+ * Rewrites the original file to keep only non-permission scalar fields.
+ *
+ * @returns number of permission files written
+ */
+function decomposeFile(filePath) {
+    const xml = readFileSync(filePath, 'utf-8');
+    const parentDir = dirname(filePath);
+    // Derive the component name from the filename:
+    // "Admin.profile-meta.xml" → "Admin"
+    // "MyPermSet.permissionset-meta.xml" → "MyPermSet"
+    const fileBasename = basename(filePath);
+    const componentName = fileBasename
+        .replace(/\.profile-meta\.xml$/, '')
+        .replace(/\.permissionset-meta\.xml$/, '');
+    // Decomposed files go into profiles/<Name>/ or permissionsets/<Name>/
+    const componentDir = join(parentDir, componentName);
+    let filesWritten = 0;
+    let reducedXml = xml;
+    for (const [elementName, cfg] of Object.entries(PERMISSION_CONFIGS)) {
+        const blocks = extractBlocks(xml, elementName);
+        if (blocks.length === 0)
+            continue;
+        const subDirPath = join(componentDir, cfg.subDir);
+        mkdirSync(subDirPath, { recursive: true });
+        for (const block of blocks) {
+            const keyValue = extractChildValue(block, cfg.keyElement);
+            if (!keyValue)
+                continue;
+            // Sanitize: replace characters unsafe in filenames with underscore (/ is fine on Mac/Linux)
+            const safeName = keyValue.replace(/[<>:"|?*\\]/g, '_');
+            const fileName = `${safeName}.${cfg.fileSuffix}-meta.xml`;
+            const fileDest = join(subDirPath, fileName);
+            // Extract inner content of the block (without the wrapping element tags)
+            const innerStart = block.indexOf('>') + 1;
+            const innerEnd = block.lastIndexOf('<');
+            const innerContent = block.slice(innerStart, innerEnd);
+            const fileContent = `<?xml version="1.0" encoding="UTF-8"?>\n<${elementName}>\n${innerContent}\n</${elementName}>\n`;
+            writeFileSync(fileDest, fileContent, 'utf-8');
+            filesWritten++;
+        }
+        // Remove these blocks from the root file
+        reducedXml = removeBlocks(reducedXml, elementName);
+    }
+    if (filesWritten > 0) {
+        // Write reduced root file (scalar fields only)
+        writeFileSync(filePath, reducedXml, 'utf-8');
+    }
+    return filesWritten;
+}
+/**
+ * Walk a directory for monolithic .profile-meta.xml or .permissionset-meta.xml files.
+ * A file is "monolithic" when it lives directly in `profiles/` or `permissionsets/` (depth 1),
+ * not inside a named sub-folder (depth 2+).
+ */
+function findMonolithicFiles(taggedDir) {
+    const result = [];
+    // SF CLI DX source format writes to main/default/ within the package dir.
+    // Also check taggedDir directly for tests / alternative layouts.
+    const searchRoots = [join(taggedDir, 'main', 'default'), taggedDir];
+    for (const root of searchRoots) {
+        for (const topDir of ['profiles', 'permissionsets']) {
+            const dir = join(root, topDir);
+            let entries;
+            try {
+                entries = readdirSync(dir);
+            }
+            catch {
+                continue; // directory doesn't exist — nothing to decompose
+            }
+            for (const entry of entries) {
+                const fullPath = join(dir, entry);
+                try {
+                    const stat = statSync(fullPath);
+                    if (stat.isFile() && (entry.endsWith('.profile-meta.xml') || entry.endsWith('.permissionset-meta.xml'))) {
+                        result.push(fullPath);
+                    }
+                    // Sub-directories (already-decomposed profiles) are intentionally skipped
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Walk a tagged retrieve directory, find all monolithic profile/permission-set XML files,
+ * and decompose each into sub-directory permission files.
+ *
+ * @returns Human-readable summary string
+ */
+export function decomposeProfilesAndPermSets(taggedDir) {
+    const files = findMonolithicFiles(taggedDir);
+    if (files.length === 0)
+        return '';
+    let profileCount = 0;
+    let permSetCount = 0;
+    let totalFiles = 0;
+    for (const filePath of files) {
+        const written = decomposeFile(filePath);
+        totalFiles += written;
+        if (filePath.includes('/profiles/'))
+            profileCount++;
+        else if (filePath.includes('/permissionsets/'))
+            permSetCount++;
+    }
+    const parts = [];
+    if (profileCount > 0)
+        parts.push(`${profileCount} profile${profileCount > 1 ? 's' : ''}`);
+    if (permSetCount > 0)
+        parts.push(`${permSetCount} permission set${permSetCount > 1 ? 's' : ''}`);
+    if (parts.length === 0 || totalFiles === 0)
+        return '';
+    return `Decomposed ${parts.join(', ')} into ${totalFiles} individual permission files.`;
+}
+//# sourceMappingURL=decomposePermissions.js.map

package/dist/utils/decomposePermissions.js.map

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

package/dist/utils/dxPathMapper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Maps Salesforce DX source paths to metadata API type + component name.
+ * Used by metadataDiff to enrich git diff results with metadata context.
+ */
+interface MetadataMapping {
+    metadataType: string;
+    componentName: string;
+}
+/**
+ * Maps a DX source file path to its metadata type and component name.
+ *
+ * @param filePath Relative path within the DX project (e.g. "classes/MyClass.cls")
+ * @returns Mapping or null if path is unrecognized
+ */
+export declare function mapDxPathToMetadata(filePath: string): MetadataMapping | null;
+export {};

package/dist/utils/dxPathMapper.js

@@ -0,0 +1,217 @@
+/**
+ * Maps Salesforce DX source paths to metadata API type + component name.
+ * Used by metadataDiff to enrich git diff results with metadata context.
+ */
+// Directory-based mappings: DX folder name → metadata API type
+const SIMPLE_DIR_MAPPINGS = {
+    classes: 'ApexClass',
+    triggers: 'ApexTrigger',
+    pages: 'ApexPage',
+    components: 'ApexComponent',
+    flows: 'Flow',
+    layouts: 'Layout',
+    permissionsetgroups: 'PermissionSetGroup',
+    staticresources: 'StaticResource',
+    flexipages: 'FlexiPage',
+    tabs: 'CustomTab',
+    labels: 'CustomLabels',
+    email: 'EmailTemplate',
+    reports: 'Report',
+    dashboards: 'Dashboard',
+    documents: 'Document',
+    queues: 'Queue',
+    groups: 'Group',
+    roles: 'Role',
+    workflows: 'Workflow',
+    assignmentRules: 'AssignmentRule',
+    autoResponseRules: 'AutoResponseRule',
+    escalationRules: 'EscalationRule',
+    matchingRules: 'MatchingRule',
+    sharingRules: 'SharingRules',
+    approvalProcesses: 'ApprovalProcess',
+    globalValueSets: 'GlobalValueSet',
+    standardValueSets: 'StandardValueSet',
+    customMetadata: 'CustomMetadata',
+    platformEventChannelMembers: 'PlatformEventChannelMember',
+    connectedApps: 'ConnectedApp',
+    applications: 'CustomApplication',
+    contentassets: 'ContentAsset',
+    certs: 'Certificate',
+    cleanDataServices: 'CleanDataService',
+    customPermissions: 'CustomPermission',
+    dataSources: 'ExternalDataSource',
+    duplicateRules: 'DuplicateRule',
+    experiences: 'ExperienceBundle',
+    flowDefinitions: 'FlowDefinition',
+    homePageComponents: 'HomePageComponent',
+    homePageLayouts: 'HomePageLayout',
+    installedPackages: 'InstalledPackage',
+    letterhead: 'Letterhead',
+    namedCredentials: 'NamedCredential',
+    notificationtypes: 'CustomNotificationType',
+    objectTranslations: 'CustomObjectTranslation',
+    pathAssistants: 'PathAssistant',
+    quickActions: 'QuickAction',
+    remoteSiteSettings: 'RemoteSiteSetting',
+    settings: 'Settings',
+    siteDotComSites: 'SiteDotCom',
+    sites: 'CustomSite',
+    translations: 'Translations',
+    wave: 'WaveApplication',
+};
+// Sub-object directories: objects/<ObjName>/<subdir>/ → metadata type
+const OBJECT_SUB_MAPPINGS = {
+    fields: 'CustomField',
+    validationRules: 'ValidationRule',
+    compactLayouts: 'CompactLayout',
+    recordTypes: 'RecordType',
+    listViews: 'ListView',
+    webLinks: 'WebLink',
+    businessProcesses: 'BusinessProcess',
+    fieldSets: 'FieldSet',
+    sharingReasons: 'SharingReason',
+};
+// Profile decomposed sub-directory mappings (from custom decomposeProfilesAndPermSets utility)
+const PROFILE_SUB_MAPPINGS = {
+    fieldPermissions: 'ProfileFieldPermission',
+    objectPermissions: 'ProfileObjectPermission',
+    classAccesses: 'ProfileClassAccess',
+    pageAccesses: 'ProfilePageAccess',
+    recordTypeVisibilities: 'ProfileRecordTypeVisibility',
+    tabVisibilities: 'ProfileTabVisibility',
+    userPermissions: 'ProfileUserPermission',
+    applicationVisibilities: 'ProfileApplicationVisibility',
+    flowAccesses: 'ProfileFlowAccess',
+    layoutAssignments: 'ProfileLayoutAssignment',
+    customPermissions: 'ProfileCustomPermission',
+};
+// PermissionSet decomposed sub-directory mappings
+const PERMSET_SUB_MAPPINGS = {
+    fieldPermissions: 'PermissionSetFieldPermission',
+    objectPermissions: 'PermissionSetObjectPermission',
+    classAccesses: 'PermissionSetClassAccess',
+    pageAccesses: 'PermissionSetPageAccess',
+    recordTypeVisibilities: 'PermissionSetRecordTypeVisibility',
+    tabVisibilities: 'PermissionSetTabVisibility',
+    userPermissions: 'PermissionSetUserPermission',
+    applicationVisibilities: 'PermissionSetApplicationVisibility',
+    flowAccesses: 'PermissionSetFlowAccess',
+    customPermissions: 'PermissionSetCustomPermission',
+};
+// Bundle directories: name is the directory name, not the file name
+const BUNDLE_DIRS = new Set(['lwc', 'aura']);
+/**
+ * Maps a DX source file path to its metadata type and component name.
+ *
+ * @param filePath Relative path within the DX project (e.g. "classes/MyClass.cls")
+ * @returns Mapping or null if path is unrecognized
+ */
+export function mapDxPathToMetadata(filePath) {
+    // Normalize separators and strip leading slashes
+    const normalized = filePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    // Split into segments
+    const segments = normalized.split('/');
+    // Find the meaningful start — skip common DX prefixes like "force-app/main/default/"
+    let startIdx = 0;
+    for (let i = 0; i < segments.length; i++) {
+        if (segments[i] === 'main' && i + 1 < segments.length && segments[i + 1] === 'default') {
+            startIdx = i + 2;
+            break;
+        }
+    }
+    const meaningful = segments.slice(startIdx);
+    if (meaningful.length === 0)
+        return null;
+    const dirName = meaningful[0];
+    // Bundle directories (lwc, aura)
+    if (BUNDLE_DIRS.has(dirName)) {
+        if (meaningful.length < 2)
+            return null;
+        const bundleName = meaningful[1];
+        const metadataType = dirName === 'lwc' ? 'LightningComponentBundle' : 'AuraDefinitionBundle';
+        return { metadataType, componentName: bundleName };
+    }
+    // Objects directory — handle sub-types
+    if (dirName === 'objects') {
+        if (meaningful.length < 2)
+            return null;
+        const objectName = meaningful[1];
+        // Root object meta file: objects/Account/Account.object-meta.xml
+        if (meaningful.length === 3 && meaningful[2].endsWith('.object-meta.xml')) {
+            return { metadataType: 'CustomObject', componentName: objectName };
+        }
+        // Sub-object files: objects/Account/fields/MyField__c.field-meta.xml
+        if (meaningful.length >= 4) {
+            const subDir = meaningful[2];
+            const subType = OBJECT_SUB_MAPPINGS[subDir];
+            if (subType) {
+                const fileName = meaningful[3];
+                const componentName = stripMetaSuffix(fileName);
+                return { metadataType: subType, componentName: `${objectName}.${componentName}` };
+            }
+        }
+        // Unknown object sub-path — still tag it as related to the object
+        return { metadataType: 'CustomObject', componentName: objectName };
+    }
+    // Decomposed profiles: profiles/<Name>/<subDir>/<file> or profiles/<Name>.profile-meta.xml
+    if (dirName === 'profiles') {
+        if (meaningful.length < 2)
+            return null;
+        const profileName = meaningful[1];
+        if (meaningful.length === 2)
+            return { metadataType: 'Profile', componentName: stripMetaSuffix(profileName) };
+        // Root file inside decomposed folder: profiles/<Name>/<Name>.profile-meta.xml
+        if (meaningful.length === 3)
+            return { metadataType: 'Profile', componentName: profileName };
+        // Sub-permission file: profiles/<Name>/<subDir>/<file>
+        const subType = PROFILE_SUB_MAPPINGS[meaningful[2]];
+        if (subType)
+            return { metadataType: subType, componentName: `${profileName}/${stripMetaSuffix(meaningful[3])}` };
+        return { metadataType: 'Profile', componentName: profileName };
+    }
+    // Decomposed permission sets: permissionsets/<Name>/<subDir>/<file> or flat file
+    if (dirName === 'permissionsets') {
+        if (meaningful.length < 2)
+            return null;
+        const permSetName = meaningful[1];
+        if (meaningful.length === 2)
+            return { metadataType: 'PermissionSet', componentName: stripMetaSuffix(permSetName) };
+        if (meaningful.length === 3)
+            return { metadataType: 'PermissionSet', componentName: permSetName };
+        const subType = PERMSET_SUB_MAPPINGS[meaningful[2]];
+        if (subType)
+            return { metadataType: subType, componentName: `${permSetName}/${stripMetaSuffix(meaningful[3])}` };
+        return { metadataType: 'PermissionSet', componentName: permSetName };
+    }
+    // Simple directory mappings
+    const simpleType = SIMPLE_DIR_MAPPINGS[dirName];
+    if (simpleType) {
+        if (meaningful.length < 2)
+            return null;
+        // For email templates and other folder-based types with subdirectories
+        if (meaningful.length > 2 && (dirName === 'email' || dirName === 'reports' || dirName === 'dashboards' || dirName === 'documents')) {
+            const folder = meaningful[1];
+            const fileName = meaningful[meaningful.length - 1];
+            return { metadataType: simpleType, componentName: `${folder}/${stripMetaSuffix(fileName)}` };
+        }
+        const fileName = meaningful[1];
+        return { metadataType: simpleType, componentName: stripMetaSuffix(fileName) };
+    }
+    // Fallback: use directory name as type and file name as component name
+    if (meaningful.length >= 2) {
+        const fallbackType = dirName.charAt(0).toUpperCase() + dirName.slice(1);
+        const fileName = meaningful[meaningful.length - 1];
+        return { metadataType: fallbackType, componentName: stripMetaSuffix(fileName) };
+    }
+    return null;
+}
+/**
+ * Strip common DX meta suffixes from file names to get the component name.
+ */
+function stripMetaSuffix(fileName) {
+    return fileName
+        .replace(/\.(cls|trigger|page|component|resource|app|tab|flow|layout|profile|permissionset|permissionsetgroup|flexipage|labels|queue|group|role|workflow|object|field|validationRule|compactLayout|recordType|listView|webLink|businessProcess|fieldSet|sharingReason|fieldPermission|objectPermission|classAccess|pageAccess|recordTypeVisibility|tabVisibility|userPermission|applicationVisibility|flowAccess|layoutAssignment|customPermission)-meta\.xml$/i, '')
+        .replace(/-meta\.xml$/, '')
+        .replace(/\.(cls|trigger|page|component|resource|js|html|css|svg|xml|json)$/, '');
+}
+//# sourceMappingURL=dxPathMapper.js.map

package/dist/utils/dxPathMapper.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+export declare function formatMetadataErrors(result: any): string;
+export declare function toolResponse(text: string, isError?: boolean): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};

package/dist/utils/errors.js

@@ -0,0 +1,40 @@
+export function formatMetadataErrors(result) {
+    if (!result)
+        return 'Unknown error (no result returned)';
+    if (result.success)
+        return '';
+    const errors = [];
+    if (Array.isArray(result.errors)) {
+        for (const err of result.errors) {
+            if (typeof err === 'string') {
+                errors.push(err);
+            }
+            else if (err?.message) {
+                const fields = err.fields ? ` (fields: ${Array.isArray(err.fields) ? err.fields.join(', ') : err.fields})` : '';
+                const code = err.statusCode ? `[${err.statusCode}] ` : '';
+                errors.push(`${code}${err.message}${fields}`);
+            }
+        }
+    }
+    else if (result.errors?.message) {
+        errors.push(result.errors.message);
+    }
+    else if (typeof result.errors === 'string') {
+        errors.push(result.errors);
+    }
+    if (Array.isArray(result)) {
+        for (const item of result) {
+            const msg = formatMetadataErrors(item);
+            if (msg)
+                errors.push(msg);
+        }
+    }
+    return errors.length > 0 ? errors.join('\n') : 'Unknown error';
+}
+export function toolResponse(text, isError = false) {
+    return {
+        content: [{ type: 'text', text }],
+        isError,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,MAAW;IAC9C,IAAI,CAAC,MAAM;QAAE,OAAO,oCAAoC,CAAC;IAEzD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChH,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,GAAG;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IACxD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { createConnection } from './connection.js';
+export { formatMetadataErrors, toolResponse } from './errors.js';

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { createConnection } from './connection.js';
+export { formatMetadataErrors, toolResponse } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/oauthWebFlow.d.ts

@@ -0,0 +1,8 @@
+export declare function getOAuthWebFlowToken(): {
+    accessToken: string;
+    instanceUrl: string;
+} | null;
+export declare function setOAuthWebFlowToken(accessToken: string, instanceUrl: string): void;
+export declare function startOAuthWebFlow(loginUrl: string, clientId: string, callbackPort: number): Promise<{
+    instanceUrl: string;
+}>;