@sfship/plugin-ship 1.0.0-beta.2

package/lib/core/tasks/org/create/scratch.js

@@ -0,0 +1,127 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve, basename, extname } from 'node:path';
+import { scratchOrgCreate, Org, ConfigAggregator, OrgConfigProperties } from '@salesforce/core';
+import { ExpectedError } from '../../../error.js';
+export default {
+    description: 'Creates a scratch org, or skips if a healthy one already exists under the same alias.',
+    outputs: [
+        { name: 'target-org', type: 'string', description: 'The alias of the created (or existing) scratch org.' },
+        {
+            name: 'created',
+            type: 'boolean',
+            description: 'True if a new scratch org was created; false if a healthy existing one was reused.',
+        },
+    ],
+    params: [
+        {
+            name: 'scratch-def',
+            type: 'string',
+            required: true,
+            description: 'Scratch org def alias (looked up in <shipDir>/orgs/) or path to a .json def file.',
+        },
+        {
+            name: 'alias',
+            type: 'string',
+            required: false,
+            description: 'Override the org alias. Defaults to the def name prefixed by the project name.',
+        },
+        { name: 'duration', type: 'number', required: false, description: 'Duration in days. Defaults to 1.' },
+        {
+            name: 'dev-hub',
+            type: 'string',
+            required: false,
+            description: 'Dev hub alias or username. Defaults to the SF CLI default target-dev-hub.',
+        },
+        {
+            name: 'set-default',
+            type: 'boolean',
+            required: false,
+            description: 'Set as default org after creation. Defaults to true.',
+        },
+        {
+            name: 'no-namespace',
+            type: 'boolean',
+            required: false,
+            description: 'Create the scratch without the project namespace. Defaults to false (inherits the sfdx-project.json namespace). Set true for orgs that install a managed package of the same namespace, e.g. feature or beta CI orgs.',
+        },
+    ],
+    async run({ flow, params, output }) {
+        const scratchDef = params['scratch-def'];
+        const definitionPath = scratchDef.endsWith('.json')
+            ? resolve(process.cwd(), scratchDef)
+            : resolve(flow.shipDir, 'orgs', `${scratchDef}.json`);
+        const orgConfig = JSON.parse(readFileSync(definitionPath, 'utf8'));
+        const defName = basename(definitionPath, extname(definitionPath));
+        const alias = params['alias'] ?? flow.orgs.resolveAlias(defName);
+        const duration = params['duration'] ?? 1;
+        let hubOrg;
+        if (params['dev-hub']) {
+            hubOrg = await Org.create({ aliasOrUsername: params['dev-hub'] });
+        }
+        else {
+            const configAggregator = await ConfigAggregator.create();
+            const devHub = configAggregator.getPropertyValue(OrgConfigProperties.TARGET_DEV_HUB);
+            if (!devHub)
+                throw new ExpectedError('No dev hub found. Pass `dev-hub` param or set a default with `sf config set target-dev-hub`.');
+            hubOrg = await Org.create({ aliasOrUsername: String(devHub) });
+        }
+        try {
+            const existingOrg = await Org.create({ aliasOrUsername: alias });
+            try {
+                await existingOrg.checkScratchOrg(hubOrg.getUsername());
+                flow.log(`Scratch org ${alias} already exists, skipping.`);
+                output.set('target-org', alias);
+                output.set('created', false);
+                return;
+            }
+            catch (healthErr) {
+                if (healthErr instanceof Error && healthErr.name === 'NoResultsError') {
+                    flow.log(`Scratch org ${alias} is expired, removing and recreating.`);
+                    await existingOrg.remove();
+                }
+                else {
+                    throw healthErr;
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name !== 'NamedOrgNotFoundError')
+                throw err;
+        }
+        // The library's auto-lookup via SfProjectJson.create({}) doesn't reliably
+        // resolve sfdx-project.json from our in-process invocation context, but it
+        // reads orgConfig.namespace before falling back to auto-lookup — so inject it.
+        const wantNoNamespace = params['no-namespace'] === true;
+        const namespace = flow.config.project.package?.namespace;
+        if (namespace && !wantNoNamespace) {
+            orgConfig.namespace = namespace;
+        }
+        const result = await scratchOrgCreate({
+            hubOrg,
+            orgConfig,
+            alias,
+            setDefault: params['set-default'] ?? true,
+            durationDays: duration,
+            nonamespace: wantNoNamespace,
+        });
+        for (const warning of result.warnings)
+            flow.log(warning);
+        flow.log(`Created scratch org: ${result.username ?? alias}`);
+        output.set('target-org', alias);
+        output.set('created', true);
+    },
+};
+//# sourceMappingURL=scratch.js.map

package/lib/core/tasks/org/create/scratch.js.map

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

package/lib/core/tasks/org/delete/scratch.d.ts

@@ -0,0 +1,12 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: {
+        name: string;
+        type: "string";
+        required: true;
+        description: string;
+    }[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/org/delete/scratch.js

@@ -0,0 +1,10 @@
+export default {
+    description: 'Deletes a scratch org by alias. Passthrough for `sf org delete scratch`.',
+    params: [{ name: 'alias', type: 'string', required: true, description: 'The scratch org alias to delete.' }],
+    async run({ flow, params }) {
+        const alias = flow.orgs.resolveAlias(params['alias']);
+        await flow.runCommand('org:delete:scratch', ['--target-org', alias, '--no-prompt']);
+        flow.log(`Deleted scratch org: ${alias}`);
+    },
+};
+//# sourceMappingURL=scratch.js.map

package/lib/core/tasks/org/delete/scratch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratch.js","sourceRoot":"","sources":["../../../../../src/core/tasks/org/delete/scratch.ts"],"names":[],"mappings":"AAeA,eAAe;IACb,WAAW,EAAE,0EAA0E;IACvF,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAC5G,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAW,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,GAAG,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;CACuB,CAAC"}

package/lib/core/tasks/package/create.d.ts

@@ -0,0 +1,36 @@
+import type { TaskContext } from '../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "string";
+        required: true;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        default: string;
+        description: string;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        description: string;
+        default?: undefined;
+    })[];
+    outputs: {
+        name: string;
+        type: "string";
+        description: string;
+    }[];
+    run({ flow, params, output }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/package/create.js

@@ -0,0 +1,93 @@
+import { resolvePassthroughArgs } from '../../task.param.js';
+import { ExpectedError } from '../../error.js';
+import { readSfdxProject, writeSfdxProject } from '../../sfdx-project.js';
+export default {
+    description: 'Registers a 2GP managed or unlocked package on the Dev Hub. Passthrough for `sf package create`. Writes the new 0Ho into sfdx-project.json packageAliases. Idempotent: skips if the package is already in packageAliases.',
+    params: [
+        {
+            name: 'name',
+            type: 'string',
+            required: false,
+            description: 'Display name for the package. Defaults to project.package.name from ship.yml.',
+        },
+        {
+            name: 'package-type',
+            type: 'string',
+            required: true,
+            description: 'Package type: Managed or Unlocked.',
+        },
+        {
+            name: 'path',
+            type: 'string',
+            required: false,
+            default: 'force-app',
+            description: 'Path to the package source directory.',
+        },
+        {
+            name: 'description',
+            type: 'string',
+            required: false,
+            description: 'Description of the package.',
+        },
+        {
+            name: 'no-namespace',
+            type: 'boolean',
+            required: false,
+            description: 'Create the package as no-namespace.',
+        },
+        {
+            name: 'target-dev-hub',
+            type: 'string',
+            required: false,
+            description: 'Dev hub alias or username. Defaults to the SF CLI default target-dev-hub.',
+        },
+        {
+            name: 'org-dependent',
+            type: 'boolean',
+            required: false,
+            description: 'Mark as org-dependent. Only valid for Unlocked package types.',
+        },
+        {
+            name: 'error-notification-username',
+            type: 'string',
+            required: false,
+            description: 'Username to receive package upload failure notifications.',
+        },
+    ],
+    outputs: [
+        {
+            name: 'package-id',
+            type: 'string',
+            description: 'The 0Ho Package2Id of the created (or already-registered) package.',
+        },
+    ],
+    async run({ flow, params, output }) {
+        const name = params['name'] ?? flow.config.project.package?.name;
+        if (!name) {
+            throw new ExpectedError('No package name. Pass `name` param or set project.package.name in ship.yml.');
+        }
+        const existing = readSfdxProject(flow.projectDir).packageAliases ?? {};
+        if (existing[name]) {
+            flow.log(`Package "${name}" already registered as ${existing[name]} — skipping.`);
+            output.set('package-id', existing[name]);
+            return;
+        }
+        const argv = resolvePassthroughArgs(params, {
+            '--name': name,
+        });
+        // Disable sf's sfdx-project.json autoupdate. We write the alias ourselves below.
+        // https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_dev_cli_env_variables.htm
+        process.env.SF_PROJECT_AUTOUPDATE_DISABLE_FOR_PACKAGE_CREATE = 'true';
+        flow.log(`Creating package "${name}"...`);
+        const result = (await flow.runCommand('package:create', argv));
+        if (!result.Id) {
+            throw new ExpectedError('Package create completed without a Package2Id.');
+        }
+        const sfdxProject = readSfdxProject(flow.projectDir);
+        sfdxProject.packageAliases = { ...sfdxProject.packageAliases, [name]: result.Id };
+        writeSfdxProject(flow.projectDir, sfdxProject);
+        flow.log(`Created package ${result.Id} and wrote alias "${name}" to sfdx-project.json.`);
+        output.set('package-id', result.Id);
+    },
+};
+//# sourceMappingURL=create.js.map

package/lib/core/tasks/package/create.js.map

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

package/lib/core/tasks/package/dependencies/lock.d.ts

@@ -0,0 +1,6 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    run({ flow }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/package/dependencies/lock.js

@@ -0,0 +1,35 @@
+import { resolveDependencies } from '../../../package.dependencies.js';
+import { readSfdxProject, writeSfdxProject, defaultPackageDirectory } from '../../../sfdx-project.js';
+import { ExpectedError } from '../../../error.js';
+export default {
+    description: 'Resolves the dependencies declared in ship.yml and writes them into sfdx-project.json so a validated `package version create` can compile against them. Run whenever your dependencies change and commit the diff — that diff is your record of which dependency versions a release builds against.',
+    async run({ flow }) {
+        const deps = flow.config.project.package?.dependencies ?? [];
+        const steps = (await resolveDependencies(deps)).filter((s) => s.kind === 'package-id');
+        const project = readSfdxProject(flow.projectDir);
+        const packageDir = defaultPackageDirectory(project);
+        if (!packageDir?.package) {
+            throw new ExpectedError('No package registered in sfdx-project.json (the default packageDirectory has no "package"). Run `sf ship flow run create/package` first.');
+        }
+        // Reference each named dependency through a packageAlias so the diff stays readable;
+        // fall back to the raw 04t for dependencies that declare no name in ship.yml.
+        const aliases = { ...project.packageAliases };
+        const dependencies = steps.map((step) => {
+            if (step.name) {
+                aliases[step.name] = step.versionId;
+                return { package: step.name };
+            }
+            return { package: step.versionId };
+        });
+        if (dependencies.length)
+            packageDir.dependencies = dependencies;
+        else
+            delete packageDir.dependencies;
+        project.packageAliases = aliases;
+        writeSfdxProject(flow.projectDir, project);
+        flow.log(dependencies.length
+            ? `Wrote ${dependencies.length} dependenc${dependencies.length === 1 ? 'y' : 'ies'} to sfdx-project.json.`
+            : 'No dependencies in ship.yml — cleared sfdx-project.json dependencies.');
+    },
+};
+//# sourceMappingURL=lock.js.map

package/lib/core/tasks/package/dependencies/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../../../src/core/tasks/package/dependencies/lock.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAe;IACb,WAAW,EACT,qSAAqS;IACvS,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAe;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAE3G,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,aAAa,CACrB,0IAA0I,CAC3I,CAAC;QACJ,CAAC;QAED,qFAAqF;QACrF,8EAA8E;QAC9E,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACtC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;gBACpC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,IAAI,YAAY,CAAC,MAAM;YAAE,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC;;YAC3D,OAAO,UAAU,CAAC,YAAY,CAAC;QACpC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC;QAEjC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,GAAG,CACN,YAAY,CAAC,MAAM;YACjB,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,aAAa,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,wBAAwB;YAC1G,CAAC,CAAC,uEAAuE,CAC5E,CAAC;IACJ,CAAC;CACuB,CAAC"}

package/lib/core/tasks/package/dependencies/verify.d.ts

@@ -0,0 +1,6 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    run({ flow }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/package/dependencies/verify.js

@@ -0,0 +1,44 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { StandardColors } from '@salesforce/sf-plugins-core';
+import { resolveDependencies, computeDrift } from '../../../package.dependencies.js';
+import { readSfdxProject } from '../../../sfdx-project.js';
+import { ExpectedError } from '../../../error.js';
+export default {
+    description: 'Verifies that the dependencies declared in ship.yml match what is committed in sfdx-project.json, failing if they have drifted. Guards a release build against stale or unsynced dependencies.',
+    async run({ flow }) {
+        const deps = flow.config.project.package?.dependencies ?? [];
+        const steps = (await resolveDependencies(deps)).filter((s) => s.kind === 'package-id');
+        const { missing, stale, names } = computeDrift(steps, readSfdxProject(flow.projectDir));
+        if (missing.length || stale.length) {
+            const label = (id) => {
+                const name = names.get(id);
+                return name ? `${name} (${id})` : id;
+            };
+            const width = Math.max(...[...missing, ...stale].map((id) => label(id).length));
+            throw new ExpectedError([
+                StandardColors.error('Dependencies are out of sync.'),
+                `${StandardColors.info('ship.yml')} resolves to a different set than ${StandardColors.info('sfdx-project.json')} declares:`,
+                '',
+                ...missing.map((id) => `    ${StandardColors.success('+')} ${label(id).padEnd(width)}  in ship.yml, missing from sfdx-project.json`),
+                ...stale.map((id) => `    ${StandardColors.error('-')} ${label(id).padEnd(width)}  in sfdx-project.json, dropped from ship.yml`),
+                '',
+                `${StandardColors.info('→ To fix, run this and commit the change:')}`,
+                `    ${StandardColors.success('sf ship flow run dependencies/lock')}`,
+            ].join('\n'));
+        }
+        flow.log(`Dependencies in sync (${steps.length} package${steps.length === 1 ? '' : 's'}).`);
+    },
+};
+//# sourceMappingURL=verify.js.map

package/lib/core/tasks/package/dependencies/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../../../src/core/tasks/package/dependencies/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAsB,MAAM,kCAAkC,CAAC;AACzG,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAe;IACb,WAAW,EACT,gMAAgM;IAClM,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAe;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAC3G,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAExF,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE;gBACnC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAChF,MAAM,IAAI,aAAa,CACrB;gBACE,cAAc,CAAC,KAAK,CAAC,+BAA+B,CAAC;gBACrD,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,qCAAqC,cAAc,CAAC,IAAI,CACxF,mBAAmB,CACpB,YAAY;gBACb,EAAE;gBACF,GAAG,OAAO,CAAC,GAAG,CACZ,CAAC,EAAE,EAAE,EAAE,CACL,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CACpD,KAAK,CACN,+CAA+C,CACnD;gBACD,GAAG,KAAK,CAAC,GAAG,CACV,CAAC,EAAE,EAAE,EAAE,CACL,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAC7G;gBACD,EAAE;gBACF,GAAG,cAAc,CAAC,IAAI,CAAC,2CAA2C,CAAC,EAAE;gBACrE,OAAO,cAAc,CAAC,OAAO,CAAC,oCAAoC,CAAC,EAAE;aACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9F,CAAC;CACuB,CAAC"}

package/lib/core/tasks/package/install/dependencies.d.ts

@@ -0,0 +1,22 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: "number";
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        description: string;
+    })[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/package/install/dependencies.js

@@ -0,0 +1,43 @@
+import { installDependencies } from '../../../package.installer.js';
+export default {
+    description: 'Resolves and installs all dependencies declared in ship.yml in topological order. ' +
+        'Package versions already installed in the target org are skipped unless `force` is set.',
+    params: [
+        {
+            name: 'target-org',
+            type: 'string',
+            required: false,
+            description: 'Org alias or username to install packages into. Defaults to the SF CLI default target-org.',
+        },
+        {
+            name: 'wait',
+            type: 'number',
+            required: false,
+            description: 'Minutes to wait per package installation. Defaults to 10.',
+        },
+        {
+            name: 'dry-run',
+            type: 'boolean',
+            required: false,
+            description: 'When true, resolves and logs dependency steps without installing.',
+        },
+        {
+            name: 'force',
+            type: 'boolean',
+            required: false,
+            description: 'Reinstall package versions even if the target org already has them installed.',
+        },
+    ],
+    async run({ flow, params }) {
+        await installDependencies(flow.config.project.package?.dependencies ?? [], {
+            alias: flow.orgs.resolveAlias(params['target-org']),
+            wait: params['wait'] ?? 10,
+            dryRun: params['dry-run'] === true,
+            force: params['force'] === true,
+            shipDir: flow.shipDir,
+            log: flow.log,
+            runCommand: flow.runCommand,
+        });
+    },
+};
+//# sourceMappingURL=dependencies.js.map

package/lib/core/tasks/package/install/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../../../src/core/tasks/package/install/dependencies.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,eAAe;IACb,WAAW,EACT,oFAAoF;QACpF,yFAAyF;IAC3F,MAAM,EAAE;QACN;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,4FAA4F;SAC1G;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,2DAA2D;SACzE;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,mEAAmE;SACjF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,+EAA+E;SAC7F;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,EAAE;YACzE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAuB,CAAC;YACzE,IAAI,EAAG,MAAM,CAAC,MAAM,CAAwB,IAAI,EAAE;YAClD,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI;YAClC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;CACuB,CAAC"}

package/lib/core/tasks/package/install/index.d.ts

@@ -0,0 +1,25 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "string";
+        required: true;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "number";
+        required: false;
+        default: number;
+        description: string;
+    })[];
+    run({ flow, params }: TaskContext): Promise<void>;
+};
+export default _default;

package/lib/core/tasks/package/install/index.js

@@ -0,0 +1,37 @@
+import { resolvePassthroughArgs } from '../../../task.param.js';
+export default {
+    description: 'Installs a package version into a Salesforce org. Passthrough for `sf package install`.',
+    params: [
+        {
+            name: 'version-id',
+            type: 'string',
+            required: true,
+            description: 'The 04t package version ID to install.',
+        },
+        {
+            name: 'target-org',
+            type: 'string',
+            required: false,
+            description: 'Org alias or username to install the package into. Defaults to the SF CLI default target-org.',
+        },
+        {
+            name: 'wait',
+            type: 'number',
+            required: false,
+            default: 10,
+            description: 'Minutes to wait for installation to complete. Defaults to 10.',
+        },
+    ],
+    async run({ flow, params }) {
+        const versionId = params['version-id'];
+        const alias = flow.orgs.resolveAlias(params['target-org']);
+        const argv = resolvePassthroughArgs(params, {
+            '--target-org': alias ?? null,
+            '--package': versionId,
+            '--version-id': null,
+        });
+        await flow.runCommand('package:install', argv);
+        flow.log(`Package ${versionId} installed successfully.`);
+    },
+};
+//# sourceMappingURL=index.js.map

package/lib/core/tasks/package/install/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/tasks/package/install/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,eAAe;IACb,WAAW,EAAE,yFAAyF;IACtG,MAAM,EAAE;QACN;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,wCAAwC;SACtD;QACD;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,+FAA+F;SAC7G;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,+DAA+D;SAC7E;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAe;QACrC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAW,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAuB,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,EAAE;YAC1C,cAAc,EAAE,KAAK,IAAI,IAAI;YAC7B,WAAW,EAAE,SAAS;YACtB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,WAAW,SAAS,0BAA0B,CAAC,CAAC;IAC3D,CAAC;CACuB,CAAC"}

package/lib/core/tasks/package/version/create.d.ts

@@ -0,0 +1,36 @@
+import type { TaskContext } from '../../../task.definition.schema.js';
+declare const _default: {
+    description: string;
+    params: ({
+        name: string;
+        type: "string";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "number";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        description: string;
+        default?: undefined;
+    } | {
+        name: string;
+        type: "boolean";
+        required: false;
+        default: true;
+        description: string;
+    })[];
+    outputs: {
+        name: string;
+        type: "string";
+        description: string;
+    }[];
+    run({ flow, params, output }: TaskContext): Promise<void>;
+};
+export default _default;