@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.10

package/lib/commands/cuneiform/user/details.js

@@ -0,0 +1,414 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { CuneiformCommand, createAdapterStack } from '../../../base/cuneiform-command.js';
+import { createConnectionFacade } from '../../../adapters/connection-facade.js';
+import { UserReadinessService, REQUIRED_PERMISSION_SETS, REQUIRED_PERMISSION_SET_LABELS, } from '../../../services/UserReadinessService.js';
+import { UserConfigurationService } from '../../../services/UserConfigurationService.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { ProfilingRestClient } from '../../../adapters/rest/profiling-rest-client.js';
+import { ServiceErrorCodes } from '../../../adapters/errors.js';
+import { CUNEIFORM_NAMESPACE } from '../../../services/namespace-constants.js';
+import { displayOutput } from '../../../utils/formatting/user-details-display.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'user.details');
+const accessMessages = Messages.loadMessages('@peernova/cuneiform-sf', 'cuneiform.access');
+/**
+ * Displays authenticated user context and Cuneiform readiness status.
+ *
+ * Use this command to:
+ * - Verify user identity (ID, username, email, profile, role)
+ * - Check required Cuneiform permission set assignments
+ * - Validate Configuration Profile settings for API-only profiling
+ * - Diagnose readiness issues before running other Cuneiform commands
+ *
+ * @example
+ * ```bash
+ * # Display user details and readiness status
+ * sf cuneiform user details --target-org myOrg
+ *
+ * # Output as JSON for programmatic use
+ * sf cuneiform user details --target-org myOrg --json
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class Details extends CuneiformCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    // eslint-disable-next-line sf-plugin/spread-base-flags -- CuneiformCommand has no additional flags to spread
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+        }),
+        configure: Flags.boolean({
+            summary: messages.getMessage('flags.configure.summary'),
+            char: 'c',
+            default: false,
+            exclusive: ['unconfigure'],
+        }),
+        unconfigure: Flags.boolean({
+            summary: messages.getMessage('flags.unconfigure.summary'),
+            hidden: true,
+            default: false,
+            exclusive: ['configure', 'dry-run'],
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            char: 'd',
+            default: false,
+        }),
+    };
+    static skipAccessGate = true;
+    /**
+     * Builds the command result from service data.
+     */
+    static buildResult(userInfo, readiness, orgIdentity, instanceUrl) {
+        const ADMIN_PS = REQUIRED_PERMISSION_SETS[0];
+        const adminAssignment = readiness.permissionSets.assignments.find((a) => a.name === ADMIN_PS);
+        const hasAdminAccess = readiness.isCuneiformInstalled && (adminAssignment?.isAssigned ?? false);
+        // Build permission set results. `isRequired` reflects the static fact
+        // that this permset is required for the feature — not whether it is
+        // currently missing. Use `!isAssigned` to identify unmet action items.
+        const permissionSets = REQUIRED_PERMISSION_SETS.map((name) => {
+            const assignment = readiness.permissionSets.assignments.find((a) => a.name === name);
+            return {
+                apiName: `${CUNEIFORM_NAMESPACE}__${name}`,
+                label: assignment?.label ?? REQUIRED_PERMISSION_SET_LABELS[name] ?? name,
+                isAssigned: assignment?.isAssigned ?? false,
+                isRequired: true,
+            };
+        });
+        // Build config profile result
+        const configProfile = {
+            isConfigured: readiness.configProfile.isConfigured,
+            profileLabel: readiness.configProfile.profileLabel ?? null,
+            apiOnlyProfilingEnabled: readiness.configProfile.isConfigured
+                ? readiness.configProfile.apiOnlyProfilingEnabled ?? null
+                : null,
+            selfRegistrationEnabled: readiness.configProfile.isConfigured
+                ? readiness.configProfile.selfRegistrationEnabled ?? null
+                : null,
+        };
+        // Build structured resolution guidance (extracted to reduce buildResult complexity)
+        const resolutionGuidance = Details.buildResolutionGuidance(readiness);
+        // Append no-config-profile guidance last (after permission and config checks)
+        if (readiness.isCuneiformInstalled && !readiness.configProfile.isConfigured) {
+            resolutionGuidance.push({
+                issue: messages.getMessage('guidance.noConfigProfile'),
+                action: messages.getMessage('guidance.noConfigProfileAction'),
+                persona: 'admin',
+            });
+        }
+        // Build org context
+        const orgContext = {
+            orgName: orgIdentity?.organizationName ?? '(unknown)',
+            orgId: orgIdentity?.organizationId ?? '(unknown)',
+            instanceUrl,
+            isSandbox: orgIdentity?.isSandbox ?? false,
+            orgType: orgIdentity?.organizationType ?? '(unknown)',
+        };
+        // Build links
+        const links = {
+            installationGuide: messages.getMessage('links.installationGuideUrl'),
+            documentation: messages.getMessage('links.verificationDocsUrl'),
+        };
+        return {
+            orgContext,
+            user: {
+                id: userInfo.id,
+                username: userInfo.username,
+                email: userInfo.email,
+                profileName: userInfo.profileName,
+                roleName: userInfo.roleName,
+            },
+            prerequisites: {
+                cuneiformInstalled: readiness.isCuneiformInstalled,
+                adminAccessAssigned: hasAdminAccess,
+                allPassed: readiness.isCuneiformInstalled && hasAdminAccess,
+            },
+            readiness: {
+                isReady: readiness.isReady,
+                permissionSets,
+                configProfile,
+            },
+            resolutionGuidance,
+            links,
+        };
+    }
+    /**
+     * Builds resolution guidance items from readiness state.
+     * Extracted from buildResult to reduce cyclomatic complexity.
+     */
+    static buildResolutionGuidance(readiness) {
+        const guidance = [];
+        if (!readiness.isCuneiformInstalled) {
+            guidance.push({
+                issue: messages.getMessage('guidance.cuneiformNotInstalled'),
+                action: messages.getMessage('guidance.cuneiformNotInstalledAction'),
+                persona: 'admin',
+            });
+            return guidance;
+        }
+        if (readiness.permissionSets.missingRequired.length > 0) {
+            // Prefer the canonical label from the assignments array (queried live
+            // from PermissionSet), falling back to the static constant when the
+            // assignment record is unavailable — keeps guidance text aligned with
+            // the permission-set display block.
+            const labels = readiness.permissionSets.missingRequired.map((name) => {
+                const assignment = readiness.permissionSets.assignments.find((a) => a.name === name);
+                return assignment?.label ?? REQUIRED_PERMISSION_SET_LABELS[name] ?? name;
+            });
+            if (labels.length === 1) {
+                guidance.push({
+                    issue: messages.getMessage('guidance.missingPermissionSet', [labels[0]]),
+                    action: messages.getMessage('guidance.missingPermissionSetAction'),
+                    persona: 'admin',
+                });
+            }
+            else {
+                guidance.push({
+                    issue: messages.getMessage('guidance.missingPermissionSets'),
+                    detail: labels,
+                    action: messages.getMessage('guidance.missingPermissionSetsAction'),
+                    persona: 'admin',
+                });
+            }
+        }
+        if (readiness.configProfile.isConfigured && readiness.configProfile.apiOnlyProfilingEnabled === false) {
+            guidance.push({
+                issue: messages.getMessage('guidance.apiOnlyProfilingDisabled'),
+                action: messages.getMessage('guidance.apiOnlyProfilingDisabledAction'),
+                persona: 'admin',
+            });
+        }
+        // Only surface self-registration guidance when Admin PS is assigned —
+        // if the user isn't an administrator, self-registration isn't relevant yet.
+        const hasAdminPSAssigned = readiness.permissionSets.assignments.some((a) => a.name === 'Cuneiform_for_CRM_PRO_Administrative_User' && a.isAssigned);
+        if (hasAdminPSAssigned &&
+            readiness.configProfile.isConfigured &&
+            readiness.configProfile.selfRegistrationEnabled === false) {
+            guidance.push({
+                issue: messages.getMessage('guidance.selfRegistrationDisabled'),
+                action: messages.getMessage('guidance.selfRegistrationDisabledAction'),
+                persona: 'admin',
+            });
+        }
+        return guidance;
+    }
+    /**
+     * Maps the service-level UserConfigurationResult to the command-level ConfigurationResult.
+     */
+    static mapConfigurationResult(serviceResult, isDryRun) {
+        const actions = serviceResult.actions.map((action) => ({
+            type: action.type,
+            target: action.target,
+            targetLabel: action.targetLabel ?? action.target,
+            status: isDryRun ? 'planned' : action.status,
+            message: action.message,
+        }));
+        // Extract deployment job ID from action details
+        const deployAction = serviceResult.actions.find((a) => a.type === 'enableApiOnlyProfiling' && a.details?.jobId);
+        return {
+            dryRun: isDryRun,
+            // CLI-3624: surface the service-layer previousState so consumers (and the
+            // NUT phase 6 agreement assertion) can verify the CLI-3418 readiness-threading
+            // contract through the command JSON output. userId/username are intentionally
+            // not surfaced — they already live on UserDetailsResult.user.
+            previousState: {
+                hasRequiredPermissionSets: serviceResult.previousState.hasRequiredPermissionSets,
+                missingPermissionSets: serviceResult.previousState.missingPermissionSets,
+                apiOnlyProfilingEnabled: serviceResult.previousState.apiOnlyProfilingEnabled,
+                profileDeveloperName: serviceResult.previousState.profileDeveloperName,
+            },
+            actions,
+            summary: {
+                changesRequired: serviceResult.summary.changesRequired,
+                changesApplied: serviceResult.summary.changesApplied,
+                changesFailed: serviceResult.summary.changesFailed,
+            },
+            deploymentJobId: deployAction?.details?.jobId,
+        };
+    }
+    /**
+     * Executes the user details command.
+     *
+     * @returns UserDetailsResult with user identity and readiness status
+     */
+    async run() {
+        const { flags } = await this.parse(Details);
+        // --dry-run implies --configure
+        const shouldConfigure = flags.configure || flags['dry-run'];
+        const shouldUnconfigure = flags.unconfigure;
+        const isDryRun = flags['dry-run'];
+        const connection = flags['target-org'].getConnection(flags['api-version']);
+        const orgIdentifier = flags['target-org'].getUsername() ?? 'unknown';
+        const facade = createConnectionFacade(connection);
+        const userId = await this.connectToOrg(facade, orgIdentifier);
+        const { soqlAdapter, restAdapter } = createAdapterStack(facade);
+        const restClient = new ProfilingRestClient(restAdapter);
+        const userReadinessService = new UserReadinessService({ soqlAdapter, restClient });
+        const orgData = await this.fetchOrgData(facade, soqlAdapter, userReadinessService, userId, orgIdentifier);
+        const { userInfo, orgIdentity } = orgData;
+        let { readiness } = orgData;
+        // Build diagnostic result
+        const result = Details.buildResult(userInfo, readiness, orgIdentity, facade.instanceUrl ?? '');
+        // Environment gate: block configure/unconfigure in production orgs
+        if ((shouldConfigure || shouldUnconfigure) && orgIdentity) {
+            const orgType = OrgInfoService.classifyOrgType(orgIdentity.isSandbox, orgIdentity.organizationType);
+            if (!UserReadinessService.isConfigureAllowed(orgType)) {
+                const sfError = new SfError(accessMessages.getMessage('error.environmentConfigureBlocked'));
+                sfError.code = ServiceErrorCodes.ENVIRONMENT_CONFIGURE_BLOCKED;
+                throw sfError;
+            }
+        }
+        // Run configuration or unconfiguration if requested
+        if (shouldConfigure) {
+            const configData = await this.runConfigurePhase(result, facade, soqlAdapter, restAdapter, userReadinessService, userId, isDryRun, readiness);
+            result.configuration = Details.mapConfigurationResult(configData, isDryRun);
+            if (!isDryRun && configData.summary.changesApplied > 0) {
+                // Refetch readiness to show post-change state (Rec #1)
+                const updatedReadiness = await userReadinessService.checkReadiness(userId);
+                if (updatedReadiness.success) {
+                    readiness = updatedReadiness.data;
+                    const updatedResult = Details.buildResult(userInfo, readiness, orgIdentity, facade.instanceUrl ?? '');
+                    result.readiness = updatedResult.readiness;
+                    result.resolutionGuidance = updatedResult.resolutionGuidance;
+                    result.links = updatedResult.links;
+                }
+            }
+        }
+        if (shouldUnconfigure) {
+            const unconfigData = await this.runUnconfigurePhase(result, facade, soqlAdapter, restAdapter, userReadinessService, userId);
+            result.configuration = Details.mapConfigurationResult(unconfigData, false);
+            if (unconfigData.summary.changesApplied > 0) {
+                // Refetch readiness to show post-change state (Rec #1)
+                const updatedReadiness = await userReadinessService.checkReadiness(userId);
+                if (updatedReadiness.success) {
+                    readiness = updatedReadiness.data;
+                    const updatedResult = Details.buildResult(userInfo, readiness, orgIdentity, facade.instanceUrl ?? '');
+                    result.readiness = updatedResult.readiness;
+                    result.resolutionGuidance = updatedResult.resolutionGuidance;
+                    result.links = updatedResult.links;
+                }
+            }
+        }
+        // Display human-readable output (delegated to display module)
+        displayOutput(this.log.bind(this), userInfo, readiness, result);
+        return result;
+    }
+    /**
+     * Establishes connection to the Salesforce org and retrieves the current user ID.
+     * Wraps the identity call with a user-friendly error message on failure.
+     */
+    async connectToOrg(facade, orgIdentifier) {
+        try {
+            const identity = await facade.identity();
+            return identity.user_id;
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            this.error(messages.getMessage('errors.orgConnectionFailed', [orgIdentifier, orgIdentifier]) + `\n\nDetail: ${detail}`, { code: 'E2001' });
+        }
+    }
+    /**
+     * Fetches org identity, user info, and readiness in parallel.
+     * Wraps the API calls with a user-friendly error message on failure.
+     */
+    async fetchOrgData(facade, soqlAdapter, userReadinessService, userId, orgIdentifier) {
+        const orgInfoService = new OrgInfoService({ connectionFacade: facade, soqlAdapter });
+        this.spinner.start(messages.getMessage('info.fetchingOrgData'));
+        let orgIdentityResult;
+        let userInfoResult;
+        let readinessResult;
+        try {
+            [orgIdentityResult, userInfoResult, readinessResult] = await Promise.all([
+                orgInfoService.getOrgIdentity(),
+                userReadinessService.getUserInfo(userId),
+                userReadinessService.checkReadiness(userId),
+            ]);
+        }
+        catch (error) {
+            this.spinner.stop();
+            const detail = error instanceof Error ? error.message : String(error);
+            this.error(messages.getMessage('errors.orgApiFailed', [orgIdentifier, orgIdentifier, orgIdentifier]) +
+                `\n\nDetail: ${detail}`, { code: 'E3001' });
+        }
+        this.spinner.stop();
+        if (!userInfoResult.success) {
+            this.error(userInfoResult.message ?? messages.getMessage('errors.userInfoFailed'), {
+                code: userInfoResult.errorCode,
+            });
+        }
+        if (!readinessResult.success) {
+            this.error(readinessResult.message ?? messages.getMessage('errors.readinessFailed'), {
+                code: readinessResult.errorCode,
+            });
+        }
+        return {
+            userInfo: userInfoResult.data,
+            readiness: readinessResult.data,
+            orgIdentity: orgIdentityResult.success ? orgIdentityResult.data : undefined,
+        };
+    }
+    /**
+     * Runs the --configure phase: assigns permission sets and enables API-only profiling.
+     *
+     * Threads the outer-fetched `readiness` snapshot into `configure()` so the displayed
+     * readiness block and the configure `previousState` block report the same
+     * `apiOnlyProfilingEnabled` value (CLI-3418).
+     */
+    async runConfigurePhase(result, _facade, soqlAdapter, restAdapter, userReadinessService, userId, isDryRun, readiness) {
+        if (!result.prerequisites.cuneiformInstalled) {
+            this.error(messages.getMessage('errors.cuneiformNotInstalled'));
+        }
+        const configService = new UserConfigurationService({
+            soqlAdapter,
+            restApiAdapter: restAdapter,
+            userReadinessService,
+        });
+        this.spinner.start(isDryRun ? messages.getMessage('info.dryRunStart') : messages.getMessage('info.configureStart'));
+        const configResult = await configService.configure(userId, { dryRun: isDryRun, readiness });
+        this.spinner.stop();
+        if (!configResult.success) {
+            this.error(configResult.message ?? messages.getMessage('errors.configurationFailed'), {
+                code: configResult.errorCode,
+            });
+        }
+        return configResult.data;
+    }
+    /**
+     * Runs the --unconfigure phase: unassigns permission sets and disables API-only profiling.
+     */
+    async runUnconfigurePhase(result, _facade, soqlAdapter, restAdapter, userReadinessService, userId) {
+        if (!result.prerequisites.cuneiformInstalled) {
+            this.error(messages.getMessage('errors.cuneiformNotInstalled'));
+        }
+        const configService = new UserConfigurationService({
+            soqlAdapter,
+            restApiAdapter: restAdapter,
+            userReadinessService,
+        });
+        this.spinner.start(messages.getMessage('info.unconfigureStart'));
+        const unconfigResult = await configService.unconfigure(userId);
+        this.spinner.stop();
+        if (!unconfigResult.success) {
+            this.error(unconfigResult.message ?? messages.getMessage('errors.configurationFailed'), {
+                code: unconfigResult.errorCode,
+            });
+        }
+        return unconfigResult.data;
+    }
+}
+//# sourceMappingURL=details.js.map

package/lib/commands/cuneiform/user/details.js.map

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

package/lib/constants/namespace-constants.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Mapping of Salesforce namespace prefixes to product names.
+ *
+ * This map enables identification of installed Salesforce products by their
+ * namespace prefix. Managed packages use namespace prefixes on custom objects
+ * (e.g., `SBQQ__Quote__c` indicates Salesforce CPQ is installed).
+ *
+ * @see docs/knowledge/salesforce/namespaces.md for comprehensive documentation
+ *
+ * @example
+ * ```typescript
+ * const namespace = 'SBQQ__';
+ * const product = NAMESPACE_PRODUCT_MAP[namespace];
+ * console.log(product); // 'Salesforce CPQ'
+ * ```
+ */
+export declare const NAMESPACE_PRODUCT_MAP: Readonly<Record<string, string>>;
+/**
+ * Namespace-to-cloud name mapping for package-based cloud detection.
+ * Keys are namespace prefixes without trailing underscores.
+ */
+export declare const CLOUD_NAMESPACE_MAP: Readonly<Record<string, string>>;
+/**
+ * The namespace prefix used by Cuneiform for CRM.
+ */
+export declare const CUNEIFORM_NAMESPACE: "pnova";
+/**
+ * The namespace prefix with trailing underscores (for object/field references).
+ */
+export declare const CUNEIFORM_NAMESPACE_PREFIX: "pnova__";
+/**
+ * Canonical Subscriber Package names for the main Cuneiform managed package.
+ *
+ * Used to disambiguate the main package from extension packages that share the
+ * `pnova` namespace (e.g., 'Cuneiform for CRM: Data Health Reports'). Extension
+ * packages follow a `Main: Subtitle` naming convention.
+ *
+ * Includes the current marketing name and historical labels so orgs upgraded
+ * across renames continue to resolve correctly.
+ */
+export declare const CUNEIFORM_MAIN_PACKAGE_NAMES: readonly string[];
+/**
+ * Gets the product name for a given namespace prefix.
+ *
+ * @param namespace - The namespace prefix (with or without trailing underscores)
+ * @returns The product name or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * getProductName('SBQQ__');    // 'Salesforce CPQ'
+ * getProductName('SBQQ');      // 'Salesforce CPQ' (normalizes input)
+ * getProductName('Unknown__'); // undefined
+ * ```
+ */
+export declare function getProductName(namespace: string): string | undefined;
+/**
+ * Checks if a namespace belongs to Cuneiform.
+ *
+ * @param namespace - The namespace to check
+ * @returns True if the namespace is Cuneiform's namespace
+ */
+export declare function isCuneiformNamespace(namespace: string): boolean;
+/**
+ * Extracts unique namespaces from a list of object API names.
+ *
+ * @param objectNames - Array of Salesforce object API names
+ * @returns Array of unique namespace prefixes found
+ *
+ * @example
+ * ```typescript
+ * extractNamespaces(['SBQQ__Quote__c', 'Account', 'npsp__Donation__c']);
+ * // Returns: ['SBQQ__', 'npsp__']
+ * ```
+ */
+export declare function extractNamespaces(objectNames: string[]): string[];
+/**
+ * Classification categories for Salesforce namespace prefixes.
+ *
+ * - `standard` - No namespace (platform-native objects like Account, Contact)
+ * - `industry` - Salesforce Industry Cloud namespaces (Health Cloud, FSC, etc.)
+ * - `managed` - Known managed packages (CPQ, NPSP, Cuneiform, etc.)
+ * - `custom` - Unknown/unrecognized namespace prefixes
+ */
+export type NamespaceCategory = 'standard' | 'industry' | 'managed' | 'custom';
+/**
+ * Categorizes a Salesforce namespace prefix into one of four categories:
+ * standard, industry, managed, or custom.
+ *
+ * @param namespace - The namespace prefix (with or without trailing underscores).
+ * Null, undefined, or empty string indicates a standard (platform-native) object.
+ * @returns The category classification for the namespace
+ *
+ * @example
+ * ```typescript
+ * categorizeNamespace(null);              // 'standard'
+ * categorizeNamespace('');                // 'standard'
+ * categorizeNamespace('FinServ__');       // 'industry'
+ * categorizeNamespace('SBQQ__');         // 'managed'
+ * categorizeNamespace('MyCustomPkg__');  // 'custom'
+ * ```
+ */
+export declare function categorizeNamespace(namespace: string | null | undefined): NamespaceCategory;