@salesforce/plugin-data-seeding 1.1.3

package/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (c) 2024, Salesforce.com, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,294 @@
+**NOTE: This template for sf plugins is not yet official. Please consult with the Platform CLI team before using this template.**
+
+# plugin-data-seeding
+
+[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-data-seeding.svg?label=@salesforce/plugin-data-seeding)](https://www.npmjs.com/package/@salesforce/plugin-data-seeding) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-data-seeding.svg)](https://npmjs.org/package/@salesforce/plugin-data-seeding) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/salesforcecli/plugin-data-seeding/main/LICENSE.txt)
+
+## Using the template
+
+This repository provides a template for creating a plugin for the Salesforce CLI. To convert this template to a working plugin:
+
+1. Please get in touch with the Platform CLI team. We want to help you develop your plugin.
+2. Generate your plugin:
+
+   ```
+   sf plugins install dev
+   sf dev generate plugin
+
+   git init -b main
+   git add . && git commit -m "chore: initial commit"
+   ```
+
+3. Create your plugin's repo in the salesforcecli github org
+4. When you're ready, replace the contents of this README with the information you want.
+
+## Learn about `sf` plugins
+
+Salesforce CLI plugins are based on the [oclif plugin framework](https://oclif.io/docs/introduction). Read the [plugin developer guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_plugins.meta/sfdx_cli_plugins/cli_plugins_architecture_sf_cli.htm) to learn about Salesforce CLI plugin development.
+
+This repository contains a lot of additional scripts and tools to help with general Salesforce node development and enforce coding standards. You should familiarize yourself with some of the [node developer packages](#tooling) used by Salesforce. There is also a default circleci config using the [release management orb](https://github.com/forcedotcom/npm-release-management-orb) standards.
+
+Additionally, there are some additional tests that the Salesforce CLI will enforce if this plugin is ever bundled with the CLI. These test are included by default under the `posttest` script and it is required to keep these tests active in your plugin if you plan to have it bundled.
+
+### Tooling
+
+- [@salesforce/core](https://github.com/forcedotcom/sfdx-core)
+- [@salesforce/kit](https://github.com/forcedotcom/kit)
+- [@salesforce/sf-plugins-core](https://github.com/salesforcecli/sf-plugins-core)
+- [@salesforce/ts-types](https://github.com/forcedotcom/ts-types)
+- [@salesforce/ts-sinon](https://github.com/forcedotcom/ts-sinon)
+- [@salesforce/dev-config](https://github.com/forcedotcom/dev-config)
+- [@salesforce/dev-scripts](https://github.com/forcedotcom/dev-scripts)
+
+# Everything past here is only a suggestion as to what should be in your specific plugin's description
+
+This plugin is bundled with the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli). For more information on the CLI, read the [getting started guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm).
+
+We always recommend using the latest version of these commands bundled with the CLI, however, you can install a specific version or tag if needed.
+
+## Install
+
+```bash
+sf plugins install @salesforce/plugin-data-seeding@x.y.z
+```
+
+## Issues
+
+Please report any issues at https://github.com/forcedotcom/cli/issues
+
+## Contributing
+
+1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)
+2. Create a new issue before starting your project so that we can keep track of
+   what you are trying to add/fix. That way, we can also offer suggestions or
+   let you know if there is already an effort in progress.
+3. Fork this repository.
+4. [Build the plugin locally](#build)
+5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.
+6. Edit the code in your fork.
+7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.
+8. Sign CLA (see [CLA](#cla) below).
+9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.
+
+### CLA
+
+External contributors will be required to sign a Contributor's License
+Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
+
+### Build
+
+To build the plugin locally, make sure to have yarn installed and run the following commands:
+
+```bash
+# Clone the repository
+git clone git@github.com:salesforcecli/plugin-data-seeding
+
+# Install the dependencies and compile
+yarn && yarn build
+```
+
+To use your plugin, run using the local `./bin/dev.js` or `./bin/dev.cmd` file.
+
+```bash
+# Run using local run file.
+./bin/dev.js data-seeding generate
+```
+
+There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.
+
+```bash
+# Link your plugin to the sf cli
+sf plugins link .
+# To verify
+sf plugins
+```
+
+## Commands
+
+<!-- commands -->
+
+- [`sf data-seeding generate`](#sf-data-seeding-generate)
+- [`sf data-seeding generate report`](#sf-data-seeding-generate-report)
+- [`sf data-seeding migrate`](#sf-data-seeding-migrate)
+- [`sf data-seeding migrate report`](#sf-data-seeding-migrate-report)
+
+## `sf data-seeding generate`
+
+Generate synthetic org data that mimics existing data in a source org, and then load it into a separate target org.
+
+```
+USAGE
+  $ sf data-seeding generate -o <value> -s <value> -f <value> [--json] [--flags-dir <value>] [-w <value> | --async]
+
+FLAGS
+  -f, --config-file=<value>  (required) Path to the data seeding JSON configuration file.
+  -o, --target-org=<value>   (required) Username or alias of the target org into which the generated data will be
+                             loaded.
+  -s, --source-org=<value>   (required) Username or alias of the source org that contains the data that AI will mimic.
+  -w, --wait=<value>         [default: 33 minutes] Number of minutes to wait for the command to complete; when reached,
+                             the command completes asynchronously if necessary.
+      --async                Run the command asynchronously and immediately return control of the terminal.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Generate synthetic org data that mimics existing data in a source org, and then load it into a separate target org.
+
+  This command uses AI to generate synthetic (or "fake") data that has a similar format to selected data in a source
+  org. The command uses a JSON configuration file to define the characteristics of the synthetic data. For example, the
+  configuration file might specify the number of records to generate for one or more Salesforce objects, along with the
+  subset of fields to include. Once generated, the data is automatically loaded into the specified target org. You must
+  be authenticated to both the source and target orgs before running this command.
+
+  By default, this command runs synchronously and outputs the job ID, along with a running status of each execution
+  phase, such as querying the source org or generating the data. If you prefer, you can run the command asynchronously
+  by specifying the --async flag so that the control of the terminal is immediately returned to you. Then use the job ID
+  to run the "data-seeding generate report" command to view the status.
+
+EXAMPLES
+  Generate synthetic data similar to existing data in the org with alias "mySourceOrg" then load it into the org with
+  alias "myTargetOrg"; use the specified config file to determine the format of the generated data:
+
+    $ sf data-seeding generate --source-org mySourceOrg --target-org myTargetOrg --config-file \
+      ./config/seed-config.json
+
+  Generate synthetic data using org usernames and run the command asynchronously:
+
+    $ sf data-seeding generate --source-org source@org.com" --target-org target@org.com" --config-file \
+      ./config/seed-config.json --async
+
+  Generate synthetic data using org aliases; if after 5 minutes the command hasn't finished, it completes
+  asynchronously:
+
+    $ sf data-seeding generate --source-org source@org.com" --target-org target@org.com" --config-file \
+      ./config/seed-config.json --wait 5
+```
+
+_See code: [src/commands/data-seeding/generate/index.ts](https://github.com/salesforcecli/plugin-data-seeding/blob/1.1.3/src/commands/data-seeding/generate/index.ts)_
+
+## `sf data-seeding generate report`
+
+Display the status of a data-seeding generate job.
+
+```
+USAGE
+  $ sf data-seeding generate report [--json] [--flags-dir <value>] [-i <value>] [-r]
+
+FLAGS
+  -i, --job-id=<value>   ID of a specific execution of the "data-seeding generate" command.
+  -r, --use-most-recent  View the status of the most recently run "data-seeding generate" command.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Display the status of a data-seeding generate job.
+
+  This command displays the status of a previously initiated or completed execution of the "data-seeding generate"
+  command. Run this command by either passing it the job ID returned by "data-seeding generate", or use the
+  --use-most-recent flag to view the status of the most recently run "data-seeding generate" command.
+
+EXAMPLES
+  Display the status of a specific execution of the "data-seeding generate" command:
+
+    $ sf data-seeding generate report --job-id 1234-5678-AAAA-BBBB
+
+  Display the status of the most recently run "data-seeding generate" command:
+
+    $ sf data-seeding generate report --use-most-recent
+```
+
+_See code: [src/commands/data-seeding/generate/report.ts](https://github.com/salesforcecli/plugin-data-seeding/blob/1.1.3/src/commands/data-seeding/generate/report.ts)_
+
+## `sf data-seeding migrate`
+
+Migrate data from one org to another.
+
+```
+USAGE
+  $ sf data-seeding migrate -o <value> -s <value> -f <value> [--json] [--flags-dir <value>] [-w <value> | --async]
+
+FLAGS
+  -f, --config-file=<value>  (required) Path to the data migration JSON configuration file.
+  -o, --target-org=<value>   (required) Username or alias of the target org into which the migrated data is loaded.
+  -s, --source-org=<value>   (required) Username or alias of the source org that contains the data to be migrated.
+  -w, --wait=<value>         [default: 33 minutes] Number of minutes to wait for the command to complete; when reached,
+                             the command completes asynchronously if necessary.
+      --async                Run the command asynchronously and immediately return control of the terminal.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Migrate data from one org to another.
+
+  This command migrates selected data from a source org and loads it into a target org. The command uses a JSON
+  configuration file that defines the characteristics of the data. For example, the configuration file might specify a
+  number of records from one or more Salesforce objects to migrate, along with the subset of fields to include. You must
+  be authenticated to both the source and target orgs before running this command.
+
+  By default, this command runs synchronously and outputs a job ID along with a running status of each execution phase,
+  such as querying the source org or loading into the target. If you prefer, you can run the command asynchronously by
+  specifying the --async flag so that the control of the terminal is immediately returned to you. Then use the job ID to
+  run the "data-seeding migrate report" command to view the status.
+
+EXAMPLES
+  Migrate data from the org with alias "mySourceOrg" to the org with alias "myTargetOrg"; use the specified
+  configuration file to determine the data to migrate:
+
+    $ sf data-seeding migrate --source-org mySourceOrg --target-org myTargetOrg --config-file \
+      ./config/data-seed.json
+
+  Migrate data by specifying usernames for the source and target orgs, and run the command asynchronously:
+
+    $ sf data-seeding migrate --source-org source@org.com --target-org target@org.com \
+      --config-file=./config/data-seed.json --async
+
+  Migrate data using org aliases; if after 5 minutes the command hasn't finished, it completes asynchronously:
+
+    $ sf data-seeding migrate --source-org mySourceOrg --target-org myTargetOrg --config-file \
+      ./config/data-seed.json --wait 5
+```
+
+_See code: [src/commands/data-seeding/migrate/index.ts](https://github.com/salesforcecli/plugin-data-seeding/blob/1.1.3/src/commands/data-seeding/migrate/index.ts)_
+
+## `sf data-seeding migrate report`
+
+Display the status of a data-seeding migrate job.
+
+```
+USAGE
+  $ sf data-seeding migrate report [--json] [--flags-dir <value>] [-i <value>] [-r]
+
+FLAGS
+  -i, --job-id=<value>   ID of a specific execution of the "data-seeding migrate" command.
+  -r, --use-most-recent  View the status of the most recently run "data-seeding migrate" command.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Display the status of a data-seeding migrate job.
+
+  This command displays the status of a previously initiated or completed execution of the "data-seeding migrate"
+  command. Run this command by either passing it the job ID returned by "data-seeding migrate", or use the
+  --use-most-recent flag to view the status of the most recently run "data-seeding migrate" command.
+
+EXAMPLES
+  Display the status of a specific execution of the "data-seeding migrate" command:
+
+    $ sf data-seeding migrate report --job-id 1234-5678-AAAA-BBBB
+
+  Display the status of the most recently run "data-seeding migrate" command:
+
+    $ sf data-seeding migrate report --use-most-recent
+```
+
+_See code: [src/commands/data-seeding/migrate/report.ts](https://github.com/salesforcecli/plugin-data-seeding/blob/1.1.3/src/commands/data-seeding/migrate/report.ts)_
+
+<!-- commandsstop -->

package/lib/commands/data-seeding/generate/index.d.ts

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Duration } from '@salesforce/kit';
+import { DataSeedingGenerateResult } from '../../../utils/types.js';
+export default class DataSeedingGenerate extends SfCommand<DataSeedingGenerateResult> {
+    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>;
+        'source-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'config-file': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").OptionFlag<Duration, import("@oclif/core/interfaces").CustomOptions>;
+        async: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DataSeedingGenerateResult>;
+}

package/lib/commands/data-seeding/generate/index.js

@@ -0,0 +1,146 @@
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, PollingClient, SfError } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+import { initiateDataSeed, pollSeedStatus, initiateJWTMint } from '../../../utils/api.js';
+import { getSeedGenerateMso, getSeedGenerateStage as getStage } from '../../../utils/mso.js';
+import { GenerateRequestCache } from '../../../utils/cache.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-data-seeding', 'data-seeding.generate');
+export default class DataSeedingGenerate extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        // TODO: The org flags will need to use Flags.requiredOrg() once auth is finalized
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        'source-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.source-org.summary'),
+            char: 's',
+            required: true,
+        }),
+        'config-file': Flags.file({
+            summary: messages.getMessage('flags.config-file.summary'),
+            char: 'f',
+            required: true,
+            exists: true,
+        }),
+        wait: Flags.duration({
+            summary: messages.getMessage('flags.wait.summary'),
+            char: 'w',
+            unit: 'minutes',
+            defaultValue: 33,
+            min: 1,
+            exclusive: ['async'],
+        }),
+        async: Flags.boolean({
+            summary: messages.getMessage('flags.async.summary'),
+            exclusive: ['wait'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DataSeedingGenerate);
+        const { async, 'config-file': configFile, 'source-org': srcOrgObj, 'target-org': tgtOrgObj, wait } = flags;
+        const sourceOrg = srcOrgObj.getOrgId();
+        const srcAccessToken = srcOrgObj.getConnection().accessToken;
+        const srcOrgInstUrl = srcOrgObj.getConnection().instanceUrl;
+        const targetOrg = tgtOrgObj.getOrgId();
+        const tgtAccessToken = tgtOrgObj.getConnection().accessToken;
+        const tgtOrgInstUrl = tgtOrgObj.getConnection().instanceUrl;
+        // Fetch Valid JWT with Data Seed Org Perm
+        const { jwt: jwtValue } = await initiateJWTMint(srcOrgInstUrl, srcAccessToken, tgtOrgInstUrl, tgtAccessToken);
+        const { request_id: jobId } = await initiateDataSeed(configFile, 'data-generation', jwtValue, srcOrgInstUrl, srcAccessToken, tgtOrgInstUrl, tgtAccessToken, sourceOrg);
+        const reportMessage = messages.getMessage('report.suggestion', [jobId]);
+        if (!jobId)
+            throw new Error('Failed to receive job id');
+        const baseData = { jobId, sourceOrg, targetOrg };
+        await (await GenerateRequestCache.create()).createCacheEntry(jobId);
+        const buildResponse = (response) => ({
+            dataSeedingJob: 'generate',
+            startTime: response?.execution_start_time,
+            endTime: response?.execution_end_time,
+            status: response.status,
+            ...baseData,
+        });
+        if (wait && !async) {
+            const mso = getSeedGenerateMso({ jsonEnabled: this.jsonEnabled() });
+            mso.updateData(baseData);
+            const completedStatus = ['Completed', 'Partially Completed', 'Failed'];
+            const options = {
+                poll: async () => {
+                    const { jwt: jwtValueNew } = await initiateJWTMint(srcOrgInstUrl, srcAccessToken, tgtOrgInstUrl, tgtAccessToken);
+                    const response = await pollSeedStatus(jobId, jwtValueNew);
+                    mso.goto(getStage(response.step), {
+                        startTime: response.execution_start_time,
+                        endTime: response.execution_end_time,
+                        status: response.status,
+                    });
+                    return {
+                        completed: completedStatus.includes(response.status),
+                        payload: response,
+                    };
+                },
+                frequency: Duration.seconds(1),
+                timeout: wait,
+            };
+            try {
+                const client = await PollingClient.create(options);
+                const pollResult = await client.subscribe();
+                switch (pollResult.status) {
+                    case 'Completed':
+                        mso.stop();
+                        break;
+                    case 'Failed':
+                        mso.error();
+                        throw new SfError(`Data seeding job failed on step: ${pollResult.step}\nLog Text: ${pollResult.log_text}`);
+                    case 'Partially Completed':
+                        mso.stop('warning');
+                        this.log(`Process partially completed: ${pollResult.log_text}`);
+                        break;
+                    default:
+                        mso.stop('current');
+                }
+                return buildResponse(pollResult);
+            }
+            catch (e) {
+                const err = SfError.wrap(e);
+                if (err.message.includes('The client has timed out')) {
+                    mso.updateData({ status: 'Client Timeout' });
+                    err.actions = [reportMessage];
+                    mso.stop('current');
+                }
+                else {
+                    mso.error();
+                }
+                throw err;
+            }
+        }
+        else {
+            const { jwt: jwtValueNew } = await initiateJWTMint(srcOrgInstUrl, srcAccessToken, tgtOrgInstUrl, tgtAccessToken);
+            const response = await pollSeedStatus(jobId, jwtValueNew);
+            const mso = getSeedGenerateMso({
+                jsonEnabled: this.jsonEnabled(),
+                showElapsedTime: false,
+                showStageTime: false,
+            });
+            mso.goto(getStage(response.step), {
+                ...baseData,
+                startTime: response.execution_start_time,
+                status: 'Initiated',
+            });
+            mso.stop('async');
+            this.log(reportMessage);
+            return buildResponse(response);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/commands/data-seeding/generate/index.js.map

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

package/lib/commands/data-seeding/generate/report.d.ts

@@ -0,0 +1,12 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { DataSeedingReportResult } from '../../../utils/types.js';
+export default class DataSeedingGenerateReport extends SfCommand<DataSeedingReportResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'job-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'use-most-recent': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DataSeedingReportResult>;
+}

package/lib/commands/data-seeding/generate/report.js

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2023, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import { pollSeedStatus } from '../../../utils/api.js';
+import { getSeedGenerateMso, getSeedGenerateStage as getStage } from '../../../utils/mso.js';
+import { GenerateRequestCache } from '../../../utils/cache.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-data-seeding', 'data-seeding.generate.report');
+// TEMP failure (Querying Source Org): 9258aae5-e9b0-4c73-a340-962d299b71bd
+// TEMP failure (Populating Target Org): 0aab5c70-069d-48f5-aa0d-157f745c5dfe
+export default class DataSeedingGenerateReport extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'job-id': Flags.string({
+            summary: messages.getMessage('flags.job-id.summary'),
+            char: 'i',
+            exactlyOne: ['job-id', 'use-most-recent'],
+        }),
+        'use-most-recent': Flags.boolean({
+            summary: messages.getMessage('flags.use-most-recent.summary'),
+            char: 'r',
+            exactlyOne: ['job-id', 'use-most-recent'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DataSeedingGenerateReport);
+        const jobId = flags['job-id'] ?? (await GenerateRequestCache.create()).resolveFromCache().jobId;
+        if (!jobId)
+            throw new SfError('No job ID provided or found in cache');
+        const response = await pollSeedStatus(jobId, '');
+        const data = {
+            jobId,
+            startTime: response.execution_start_time,
+            endTime: response.execution_end_time,
+            status: response.status,
+        };
+        const mso = getSeedGenerateMso({
+            jsonEnabled: this.jsonEnabled(),
+            showElapsedTime: false,
+            showStageTime: false,
+        });
+        mso.goto(getStage(response.step), data);
+        switch (response.status) {
+            case 'In Progress':
+                mso.stop('current');
+                break;
+            case 'Partially Completed':
+                mso.stop('warning');
+                this.log(`Process partially completed: ${response.log_text}`);
+                break;
+            case 'Failed':
+                mso.error();
+                throw new SfError(`Failed on step: ${response.step}\nLog Text: ${response.log_text}`);
+            default:
+                mso.stop();
+        }
+        return {
+            dataSeedingJob: 'generate',
+            ...data,
+        };
+    }
+}
+//# sourceMappingURL=report.js.map

package/lib/commands/data-seeding/generate/report.js.map

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

package/lib/commands/data-seeding/migrate/index.d.ts

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Duration } from '@salesforce/kit';
+import { DataSeedingMigrateResult } from '../../../utils/types.js';
+export default class DataSeedingMigrate extends SfCommand<DataSeedingMigrateResult> {
+    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>;
+        'source-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'config-file': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").OptionFlag<Duration, import("@oclif/core/interfaces").CustomOptions>;
+        async: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DataSeedingMigrateResult>;
+}