prodlysfcli 1.3.2 → 1.4.1

package/lib/commands/prodly/releases.js

@@ -0,0 +1,77 @@
+import { Messages, SfError } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { getReleases } from '../../services/release-configurations.js';
+import { postReleases } from '../../services/releases.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const commandMessages = Messages.loadMessages('prodlysfcli', 'prodly.releases');
+const prodlyMessages = Messages.loadMessages('prodlysfcli', 'prodly');
+export default class ProdlyReleases extends SfCommand {
+    static summary = commandMessages.getMessage('summary');
+    static description = prodlyMessages.getMessage('descriptionReleasesCommand');
+    static examples = commandMessages.getMessages('examples');
+    static flags = {
+        'api-version': Flags.orgApiVersion(),
+        'target-dev-hub': Flags.requiredHub(),
+        'deactivate-all-events': Flags.boolean({
+            char: 'a',
+            relationships: [{ type: 'some', flags: ['deploy'] }],
+            summary: prodlyMessages.getMessage('deactivateAllReleaseEventsFlagDescription'),
+        }),
+        'release-id': Flags.string({
+            char: 'r',
+            relationships: [{ type: 'some', flags: ['deploy'] }],
+            summary: prodlyMessages.getMessage('releaseIdFlagDescription'),
+        }),
+        deploy: Flags.boolean({
+            char: 'd',
+            dependsOn: ['instance', 'release-id'],
+            exactlyOne: ['list'],
+            summary: prodlyMessages.getMessage('deployReleaseFlagDescription'),
+        }),
+        instance: Flags.string({ char: 'i', summary: prodlyMessages.getMessage('instanceFlagDescription') }),
+        list: Flags.boolean({
+            char: 'l',
+            exactlyOne: ['deploy'],
+            exclusive: ['deploy', 'release-id'],
+            summary: prodlyMessages.getMessage('listReleasesFlagDescription'),
+        }),
+        validation: Flags.boolean({
+            char: 'n',
+            relationships: [{ type: 'some', flags: ['deploy'] }],
+            summary: prodlyMessages.getMessage('validationFlagDescription'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProdlyReleases);
+        const { list } = flags;
+        const hubOrg = flags['target-dev-hub'];
+        const hubConn = hubOrg.getConnection(flags['api-version']);
+        if (list) {
+            const releases = await getReleases({ hubConn });
+            if (!releases)
+                throw new SfError('No releases found');
+            releases.forEach((release) => this.logRelease(release));
+            return releases;
+        }
+        const { jobId } = await postReleases({
+            body: {
+                deactivateAllEvents: flags['deactivate-all-events'],
+                releaseId: flags['release-id'],
+                targetManagedInstanceId: flags.instance,
+                validation: flags.validation,
+            },
+            hubConn,
+        });
+        this.log(`Release launched with Job ID: ${jobId}`);
+        return { jobId, message: 'Release launched' };
+    }
+    logRelease(release) {
+        this.log('Name:', release.PDRI__Release_Name__c);
+        this.log('ID:', release.Id);
+        this.log('Description:', release?.PDRI__Description__c ?? '');
+        this.log('Status:', release?.PDRI__Status__c);
+        this.log('Created Date:', new Date(release.CreatedDate).toLocaleString());
+        this.log('Created By:', `${release['CreatedBy.Name'] ?? ''}\n`);
+    }
+}
+//# sourceMappingURL=releases.js.map

package/lib/commands/prodly/releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.js","sourceRoot":"","sources":["../../../src/commands/prodly/releases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,eAAe,GAAG,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAChF,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAEtE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAqB;IACxD,MAAM,CAAU,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,CAAU,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACtF,MAAM,CAAU,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAEnE,MAAM,CAAU,KAAK,GAAG;QAC7B,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;QACpC,gBAAgB,EAAE,KAAK,CAAC,WAAW,EAAE;QACrC,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC;YACrC,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,2CAA2C,CAAC;SAChF,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,0BAA0B,CAAC;SAC/D,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,SAAS,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;YACrC,UAAU,EAAE,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,8BAA8B,CAAC;SACnE,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACpG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,UAAU,EAAE,CAAC,QAAQ,CAAC;YACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;YACnC,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,6BAA6B,CAAC;SAClE,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,2BAA2B,CAAC;SAChE,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEnD,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAE3D,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;YACtD,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC;YACnC,IAAI,EAAE;gBACJ,mBAAmB,EAAE,KAAK,CAAC,uBAAuB,CAAC;gBACnD,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;gBAC9B,uBAAuB,EAAE,KAAK,CAAC,QAAQ;gBACvC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B;YACD,OAAO;SACR,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAChD,CAAC;IAEO,UAAU,CAAC,OAA6B;QAC9C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC"}

package/lib/services/release-configurations.d.ts

@@ -0,0 +1,6 @@
+import { Connection } from '@salesforce/core';
+import { ReleaseConfiguration } from '../types/prodly.js';
+export type GetReleasesFn = ({ hubConn }: {
+    hubConn: Connection;
+}) => Promise<ReleaseConfiguration[] | undefined>;
+export declare const getReleases: GetReleasesFn;

package/lib/services/release-configurations.js

@@ -0,0 +1,7 @@
+const BASE_PATH = '/services/apexrest/PDRI/v1/release-configurations';
+export const getReleases = async ({ hubConn }) => {
+    const res = await hubConn.request(`${hubConn.instanceUrl}${BASE_PATH}`);
+    const responseData = JSON.parse(res);
+    return responseData.data;
+};
+//# sourceMappingURL=release-configurations.js.map

package/lib/services/release-configurations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-configurations.js","sourceRoot":"","sources":["../../src/services/release-configurations.ts"],"names":[],"mappings":"AAGA,MAAM,SAAS,GAAG,mDAAmD,CAAC;AAItE,MAAM,CAAC,MAAM,WAAW,GAAkB,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAC9D,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,EAAE,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC,CAAC;IACzE,OAAO,YAAY,CAAC,IAAI,CAAC;AAC3B,CAAC,CAAC"}

package/lib/services/releases.d.ts

@@ -0,0 +1,10 @@
+import { Connection } from '@salesforce/core';
+export type PostReleasesFn = ({ body, hubConn, }: {
+    body: {
+        [key: string]: unknown;
+    };
+    hubConn: Connection;
+}) => Promise<{
+    jobId: string;
+}>;
+export declare const postReleases: PostReleasesFn;

package/lib/services/releases.js

@@ -0,0 +1,16 @@
+import { SfError } from '@salesforce/core';
+const BASE_PATH = '/services/apexrest/PDRI/v1/releases';
+export const postReleases = async ({ body, hubConn }) => {
+    const request = {
+        body: JSON.stringify(body),
+        method: 'POST',
+        url: BASE_PATH,
+    };
+    const res = await hubConn.request(request);
+    const jobWrapper = JSON.parse(res);
+    const jobId = jobWrapper.id;
+    if (!jobId)
+        throw new SfError('No job ID returned.');
+    return { jobId };
+};
+//# sourceMappingURL=releases.js.map

package/lib/services/releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.js","sourceRoot":"","sources":["../../src/services/releases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,SAAS,GAAG,qCAAqC,CAAC;AASxD,MAAM,CAAC,MAAM,YAAY,GAAmB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;IACtE,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,MAAe;QACvB,GAAG,EAAE,SAAS;KACf,CAAC;IACF,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC"}

package/lib/types/prodly.d.ts

@@ -93,3 +93,47 @@ export type NameAndId = {
     id: string;
     name: string;
 };
+export type WorkItem = {
+    Id: string;
+    Name: string;
+    PDRI__Name__c: string;
+    PDRI__Description__c: string;
+    PDRI__Issue_Type__c: string;
+    PDRI__Link__c: string;
+    PDRI__Work_Item_ID__c: string;
+    PDRI__Work_Item_Key__c: string;
+    PDRI__Work_Item_Type__c: string;
+};
+export type Bundle = {
+    workItems: WorkItem[];
+    Id: string;
+    PDRI__Deployment_Bundle_Name__c: string;
+    PDRI__Deployment_Bundle_Type__c: string;
+    PDRI__Metadata_Rollback_On_Failure__c: string;
+    PDRI__Skip_Data_On_Metadata_Failure__c: string;
+    PDRI__Test_Level__c: string;
+};
+export type BundleRelationship = {
+    bundle: Bundle;
+    Id: string;
+    PDRI__Deployment_Order__c: number;
+};
+export type ReleaseConfiguration = {
+    releaseBundleRelationships?: BundleRelationship[];
+    Id: string;
+    Name: string;
+    PDRI__Release_Name__c: string;
+    PDRI__Description__c?: string;
+    PDRI__Status__c: string;
+    CreatedDate: string;
+    LastModifiedDate: string;
+    'CreatedBy.Name': string;
+    'CreatedBy.Username': string;
+    'CreatedBy.Id': string;
+    'LastModifiedBy.Name': string;
+    'LastModifiedBy.Username': string;
+    'LastModifiedBy.Id': string;
+};
+export type ReleasesResponse = {
+    id: string;
+};

package/messages/prodly.json

@@ -8,24 +8,29 @@
   "createFromChangeTypeUsernameFlagDescription": "username to use for the scratch org",
   "dataSetFlagDescription": "name or record ID of the data set to deploy",
   "deactivateFlagDescription": "deactivate all events for the deployment",
+  "deactivateAllReleaseEventsFlagDescription": "deactivate all events for the release",
   "deplomentNameFlagDescription": "name for the deployment",
   "deploymentPlanFlagDescription": "name or record ID of the deployment plan to deploy",
   "destinationFlagDescription": "destination managed instance ID",
+  "deployReleaseFlagDescription": "deploy a release",
   "instanceFlagDescription": "managed instance ID on which to perform the action",
   "instanceNameFlagDescription": "connection and managed instance name",
   "jobIdFlagSummary": "Prodly Job ID",
   "listChangeTypesFlagDescription": "list all change types or specific change type",
   "listFlagDescription": "list all managed instances",
+  "listReleasesFlagDescription": "list all releases",
   "manageFlagDescription": "manage a new instance",
   "newBranchFlagSummary": "if provided it creates a new branch based on the source branch that will be used for version control",
   "notesFlagDescription": "notes for the deployment",
   "printFlagDescription": "print the managed instances in a standard format in addition to returning structured data",
   "queryFilterFlagDescription": "query filter override for a data set deployment",
+  "releaseIdFlagDescription": "release Id to deploy",
   "simulationFlagDescription": "perform a data simulation",
   "sourceBranchFlagSummary": "the version control branch or the base for the new branch (if provided)",
   "sourceFlagDescription": "source managed instance ID",
   "unlinkBranchFlagDescription": "unlink the branch from the managed instance",
   "unmanageFlagDescription": "unmanage the specified instance",
+  "validationFlagDescription": "perform a data/metadata validation",
   "versionFlagDescription": "version the new managed instance, branch created and data deployed to the org",
 
   "errorDatasetAndPlanFlags": "Specify either the data set or deployment plan parameter, but not both.",
@@ -55,5 +60,6 @@
   "descriptionDeployCommand": "Deploy data from one Salesforce environment directly to another Salesforce environment.",
   "descriptionJobsCommand": " Check the job status.",
   "descriptionManageCommand": "Authorize (or unauthorize) a Salesforce environment (not already added to the Environments page in Release tab) for use by the plugin.",
+  "descriptionReleasesCommand": "List all releases and deploy a release.",
   "descriptionVersionCommand": "Adds version control to a managed environment."
 }

package/messages/prodly.releases.md

@@ -0,0 +1,12 @@
+# summary
+
+prodly:releases command
+
+# examples
+
+- <%= config.bin %> prodly:releases --target-dev-hub jsmith@acme.com -l
+  Lists all the releases
+
+- <%= config.bin %> prodly:releases --target-dev-hub jsmith@acme.com -d -i "f50616b6-57b1-4941-802f-ee0e2506f217" -r "a5H6e0000024xKUEAY"
+  Creates a release given a release id and a destination instance id
+  The instance should be managed by the Prodly account associated with the default DevHub control org.