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

package/lib/base/cuneiform-command.js.map

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

package/lib/commands/cuneiform/compatibility/check.d.ts

@@ -0,0 +1,43 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { type CompatibilityResult } from '../../../operations/CompatibilityCheckOperation.js';
+/** Result type returned for `--json` output. */
+export type CompatibilityCheckResult = CompatibilityResult;
+/**
+ * Reports the Cuneiform For Salesforce app version required by this CLI build,
+ * and (when `--target-org` is supplied) verifies whether the target org has a
+ * compatible version installed.
+ *
+ * Two-mode UX:
+ * - No flag: prints the required app version and CLI version. No auth.
+ * - With `--target-org <alias>`: queries the org for the installed `pnova` package via Tooling API, computes compatibility state, exits non-zero on mismatch.
+ *
+ * Exit codes:
+ * - `0` for default mode, `installed-match`, `installed-newer`
+ * - `1` for `installed-older`, `not-installed`, runtime errors
+ *
+ * Extends `SfCommand` directly (not `CuneiformCommand`): the compatibility check
+ * is a meta query that runs without authentication in default mode and bypasses
+ * the access gate even when an org is supplied — knowing whether you can run
+ * Cuneiform commands is the very thing this command answers.
+ *
+ * @example Local-only readout: `sf cuneiform compatibility check`
+ * @example Verify a target org: `sf cuneiform compatibility check --target-org myOrg`
+ * @example Machine-readable: `sf cuneiform compatibility check --target-org myOrg --json`
+ */
+export default class CompatibilityCheck extends SfCommand<CompatibilityCheckResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CompatibilityCheckResult>;
+    /**
+     * Render the compatibility check result to the user.
+     *
+     * Default mode (no installed): prints the required app version and CLI version.
+     * Org-checked mode: adds the installed version and a state line with an indicator.
+     */
+    private displayResult;
+}

package/lib/commands/cuneiform/compatibility/check.js

@@ -0,0 +1,114 @@
+/*
+ * 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 { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { createAdapterStack } from '../../../base/cuneiform-command.js';
+import { createConnectionFacade } from '../../../adapters/connection-facade.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { CompatibilityService } from '../../../services/CompatibilityService.js';
+import { CompatibilityCheckOperation, } from '../../../operations/CompatibilityCheckOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'compatibility.check');
+/**
+ * Reports the Cuneiform For Salesforce app version required by this CLI build,
+ * and (when `--target-org` is supplied) verifies whether the target org has a
+ * compatible version installed.
+ *
+ * Two-mode UX:
+ * - No flag: prints the required app version and CLI version. No auth.
+ * - With `--target-org <alias>`: queries the org for the installed `pnova` package via Tooling API, computes compatibility state, exits non-zero on mismatch.
+ *
+ * Exit codes:
+ * - `0` for default mode, `installed-match`, `installed-newer`
+ * - `1` for `installed-older`, `not-installed`, runtime errors
+ *
+ * Extends `SfCommand` directly (not `CuneiformCommand`): the compatibility check
+ * is a meta query that runs without authentication in default mode and bypasses
+ * the access gate even when an org is supplied — knowing whether you can run
+ * Cuneiform commands is the very thing this command answers.
+ *
+ * @example Local-only readout: `sf cuneiform compatibility check`
+ * @example Verify a target org: `sf cuneiform compatibility check --target-org myOrg`
+ * @example Machine-readable: `sf cuneiform compatibility check --target-org myOrg --json`
+ */
+export default class CompatibilityCheck extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.optionalOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            char: 'a',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CompatibilityCheck);
+        const compatibilityService = new CompatibilityService();
+        const operation = new CompatibilityCheckOperation(compatibilityService);
+        const targetOrg = flags['target-org'];
+        let orgInfoService;
+        if (targetOrg) {
+            const connection = targetOrg.getConnection(flags['api-version']);
+            const facade = createConnectionFacade(connection);
+            const { soqlAdapter, restAdapter, toolingAdapter } = createAdapterStack(facade);
+            orgInfoService = new OrgInfoService({
+                connectionFacade: facade,
+                soqlAdapter,
+                restAdapter,
+                toolingAdapter,
+            });
+        }
+        const operationResult = await operation.execute(orgInfoService ? { orgInfoService } : undefined);
+        if (!operationResult.success) {
+            this.error(operationResult.message ?? messages.getMessage('errors.manifestInvalid'), {
+                code: operationResult.errorCode,
+            });
+        }
+        const result = operationResult.data;
+        this.displayResult(result);
+        // CLI-3118: return result (not throw) so --json includes the structured result object.
+        if (result.installed &&
+            (result.installed.state === 'installed-older' || result.installed.state === 'not-installed')) {
+            process.exitCode = 1;
+        }
+        return result;
+    }
+    /**
+     * Render the compatibility check result to the user.
+     *
+     * Default mode (no installed): prints the required app version and CLI version.
+     * Org-checked mode: adds the installed version and a state line with an indicator.
+     */
+    displayResult(data) {
+        this.log(`CLI version:     ${data.cliVersion}`);
+        this.log(`App name:        ${data.appName}`);
+        this.log(`Required:        ${data.requiredAppVersion}`);
+        if (!data.installed)
+            return;
+        const installedDisplay = data.installed.version ??
+            (data.installed.state === 'installed-version-unknown' ? '(detected via namespace)' : '(not installed)');
+        this.log(`Installed:       ${installedDisplay}`);
+        const stateLine = messages.getMessage(`state.${data.installed.state}`);
+        const passingStates = new Set([
+            'installed-match',
+            'installed-newer',
+            'installed-version-unknown',
+        ]);
+        if (passingStates.has(data.installed.state)) {
+            this.log(stateLine);
+        }
+        else {
+            this.warn(stateLine);
+        }
+    }
+}
+//# sourceMappingURL=check.js.map

package/lib/commands/cuneiform/compatibility/check.js.map

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

package/lib/commands/cuneiform/definition/create.d.ts

@@ -0,0 +1,119 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { type ObjectResult } from '../../../operations/DefinitionCreateOperation.js';
+import { type AvailabilityGrid } from '../../../services/DataAvailabilityService.js';
+/**
+ * Command result type for JSON output.
+ */
+export type DefinitionCreateResult = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Number of definitions created */
+    created: number;
+    /** Number of definitions that failed to create */
+    failed: number;
+    /** Number of objects skipped (already have definitions) */
+    skipped: number;
+    /** Total number of objects processed */
+    total: number;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** List of creation failures with details */
+    failures: Array<{
+        objectName: string;
+        error: string;
+        errorCode: string;
+    }>;
+    /** Per-definition results with status indicators */
+    results: ObjectResult[];
+    /** Data availability grid (present when --method comparative/recordtype/full) */
+    availabilityGrid?: AvailabilityGrid;
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Creates profiling definitions for Salesforce objects.
+ */
+export default class DefinitionCreate extends CuneiformCommand<DefinitionCreateResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        objects: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<"standard" | "custom" | "all", import("@oclif/core/interfaces").CustomOptions>;
+        pattern: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        namespace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        classification: import("@oclif/core/interfaces").OptionFlag<"all" | "customer" | "internal", import("@oclif/core/interfaces").CustomOptions>;
+        'with-records': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'without-records': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'with-record-types': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'min-records': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        method: import("@oclif/core/interfaces").OptionFlag<"metadata" | "historical" | "comparative" | "recordtype" | "outcome" | "full", import("@oclif/core/interfaces").CustomOptions>;
+        recordtype: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'record-type-status': import("@oclif/core/interfaces").OptionFlag<"active" | "inactive" | "all", import("@oclif/core/interfaces").CustomOptions>;
+        year: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        depth: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-value-frequency': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'use-prior': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'lifetime-primary': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'date-literal': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-field': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profiled: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-prompt': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        logs: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'name-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'name-suffix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'time-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'segment-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        origin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Determines the effective --with-records value.
+     *
+     * When --method full is used and no explicit scope/filter flags are supplied by the user,
+     * defaults withRecords to true so the default scope is "customer objects with records."
+     * This prevents full profiling from targeting empty or system-only objects.
+     *
+     * Scope flags that suppress the default: --with-records, --without-records, --filter (non-default),
+     * --objects, --pattern.
+     */
+    private static resolveWithRecords;
+    /**
+     * Executes the create command.
+     *
+     * @returns DefinitionCreateResult with success status and creation statistics
+     */
+    run(): Promise<DefinitionCreateResult>;
+    /**
+     * Two-stage confirmation: summary then detailed preview table.
+     */
+    private handlePreviewReady;
+    /**
+     * Handles operation failure by translating error codes to user-friendly messages.
+     */
+    private handleOperationFailure;
+    /**
+     * Handles post-creation actions: --profile, --open, --logs.
+     */
+    private handlePostCreationActions;
+    /**
+     * Triggers fire-and-forget profiling for successfully created definitions.
+     */
+    private triggerProfiling;
+    /**
+     * Opens the first created definition in the default browser.
+     */
+    private openInBrowser;
+    /**
+     * Writes session logs to a timestamped directory.
+     */
+    private writeSessionLogs;
+}