@salesforce/core/lib/scratchOrgInfoGenerator.d.ts

Core libraries to interact with SFDX projects, orgs, and APIs.

import { Org } from './org';
import { SfdxProjectJson } from './sfdxProject';
import { ScratchOrgInfo } from './scratchOrgInfoApi';
declare type PartialScratchOrgInfo = Pick<ScratchOrgInfo, 'ConnectedAppConsumerKey' | 'AuthCode' | 'Snapshot' | 'Status' | 'LoginUrl' | 'SignupEmail' | 'SignupUsername' | 'SignupInstance' | 'Username'>;
export interface ScratchOrgInfoPayload extends PartialScratchOrgInfo {
    orgName: string;
    package2AncestorIds: string;
    features: string | string[];
    connectedAppConsumerKey: string;
    namespace: string;
    connectedAppCallbackUrl: string;
}
/**
 * Generates the package2AncestorIds scratch org property
 *
 * @param scratchOrgInfo - the scratchOrgInfo passed in by the user
 * @param projectJson - sfdxProjectJson
 * @param hubOrg - the hub org, in case we need to do queries
 */
export declare const getAncestorIds: (scratchOrgInfo: ScratchOrgInfoPayload, projectJson: SfdxProjectJson, hubOrg: Org) => Promise<string>;
/**
 * Takes in a scratchOrgInfo and fills in the missing fields
 *
 * @param hubOrg the environment hub org
 * @param scratchOrgInfoPayload - the scratchOrgInfo passed in by the user
 * @param nonamespace create the scratch org with no namespace
 * @param ignoreAncestorIds true if the sfdx-project.json ancestorId keys should be ignored
 */
export declare const generateScratchOrgInfo: ({ hubOrg, scratchOrgInfoPayload, nonamespace, ignoreAncestorIds, }: {
    hubOrg: Org;
    scratchOrgInfoPayload: ScratchOrgInfoPayload;
    nonamespace?: boolean | undefined;
    ignoreAncestorIds?: boolean | undefined;
}) => Promise<ScratchOrgInfoPayload>;
/**
 * Returns a valid signup json
 *
 * @param definitionjson org definition in JSON format
 * @param definitionfile path to an org definition file
 * @param connectedAppConsumerKey The connected app consumer key. May be null for JWT OAuth flow.
 * @param durationdays duration of the scratch org (in days) (default:1, min:1, max:30)
 * @param nonamespace create the scratch org with no namespace
 * @param noancestors do not include second-generation package ancestors in the scratch org
 * @param orgConfig overrides definitionjson
 * @returns scratchOrgInfoPayload: ScratchOrgInfoPayload;
            ignoreAncestorIds: boolean;
            warnings: string[];
 */
export declare const getScratchOrgInfoPayload: (options: {
    definitionjson?: string;
    definitionfile?: string;
    connectedAppConsumerKey?: string;
    durationDays: number;
    nonamespace?: boolean;
    noancestors?: boolean;
    orgConfig?: Record<string, unknown>;
}) => Promise<{
    scratchOrgInfoPayload: ScratchOrgInfoPayload;
    ignoreAncestorIds: boolean;
    warnings: string[];
}>;
export {};