@esri/solution-workflow 5.2.9 → 5.2.10

package/dist/cjs/index.d.ts

@@ -19,3 +19,4 @@
  * @module workflow
  */
 export * from "./workflow";
+export * from "./workflowHelpers";

package/dist/cjs/index.js

@@ -22,4 +22,5 @@ const tslib_1 = require("tslib");
  * @module workflow
  */
 tslib_1.__exportStar(require("./workflow"), exports);
+tslib_1.__exportStar(require("./workflowHelpers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH;;;;GAIG;AAEH,qDAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH;;;;GAIG;AAEH,qDAA2B;AAC3B,4DAAkC"}

package/dist/cjs/workflow.d.ts

@@ -25,6 +25,7 @@ import * as common from "@esri/solution-common";
  * @param itemInfo Info about the item
  * @param destAuthentication Credentials for requests to the destination organization
  * @param srcAuthentication Credentials for requests to source items
+ * @param {any} templateDictionary Hash of facts: folder id, org URL, adlib replacements
  * @returns A promise that will resolve when the template has been created
  */
 export declare function convertItemToTemplate(itemInfo: any, destAuthentication: common.UserSession, srcAuthentication: common.UserSession): Promise<common.IItemTemplate>;

package/dist/cjs/workflow.js

@@ -23,6 +23,7 @@ const tslib_1 = require("tslib");
  * @module workflow
  */
 const common = tslib_1.__importStar(require("@esri/solution-common"));
+const workflowHelpers = tslib_1.__importStar(require("./workflowHelpers"));
 // ------------------------------------------------------------------------------------------------------------------ //
 /**
  * Converts a workflow item into a template.
@@ -30,6 +31,7 @@ const common = tslib_1.__importStar(require("@esri/solution-common"));
  * @param itemInfo Info about the item
  * @param destAuthentication Credentials for requests to the destination organization
  * @param srcAuthentication Credentials for requests to source items
+ * @param {any} templateDictionary Hash of facts: folder id, org URL, adlib replacements
  * @returns A promise that will resolve when the template has been created
  */
 async function convertItemToTemplate(itemInfo, destAuthentication, srcAuthentication) {
@@ -57,7 +59,7 @@ async function convertItemToTemplate(itemInfo, destAuthentication, srcAuthentica
         }
     });
     // Add the templatized configuration to the template
-    itemTemplate.properties.configuration = await common.extractAndTemplatizeWorkflowFromZipFile(configZip);
+    itemTemplate.properties.configuration = await common.extractWorkflowFromZipFile(configZip);
     return Promise.resolve(itemTemplate);
 }
 exports.convertItemToTemplate = convertItemToTemplate;
@@ -85,26 +87,41 @@ async function createItemFromTemplate(template, templateDictionary, destinationA
         newItemTemplate.item.thumbnail = template.item.thumbnail;
     }
     try {
-        // Create the item, then update its URL with its new id
-        const createResponse = await common.createItemWithData(newItemTemplate.item, newItemTemplate.data, destinationAuthentication, templateDictionary.folderId);
+        const createdWorkflowItemId = await workflowHelpers.addWorkflowItem(newItemTemplate, destinationAuthentication);
+        if (!createdWorkflowItemId) {
+            throw new Error("Failed to create workflow item");
+        }
         // Interrupt process if progress callback returns `false`
-        if (!itemProgressCallback(template.itemId, common.EItemProgressStatus.Created, template.estimatedDeploymentCostFactor / 2, createResponse.id)) {
+        if (!itemProgressCallback(template.itemId, common.EItemProgressStatus.Created, template.estimatedDeploymentCostFactor / 2, createdWorkflowItemId)) {
             itemProgressCallback(template.itemId, common.EItemProgressStatus.Cancelled, 0);
-            void common.removeItem(createResponse.id, destinationAuthentication);
+            void common.removeItem(createdWorkflowItemId, destinationAuthentication);
             return Promise.resolve(common.generateEmptyCreationResponse(template.type));
         }
         // Add the new item to the settings
-        newItemTemplate.itemId = newItemTemplate.item.id = createResponse.id;
+        newItemTemplate.itemId = newItemTemplate.item.id = createdWorkflowItemId;
         templateDictionary[template.itemId] = {
-            itemId: createResponse.id
+            itemId: createdWorkflowItemId
         };
-        // Add the item's configuration properties
+        // Detempletize the workflow configuration
+        newItemTemplate.properties.configuration = common.replaceInTemplate(newItemTemplate.properties.configuration, templateDictionary);
+        // Add the item's configuration properties; throw if the configuration update fails
         const configZipFile = await common.compressWorkflowIntoZipFile(newItemTemplate.properties.configuration);
-        await common.setWorkflowConfigurationZip(configZipFile, createResponse.id, destinationAuthentication);
-        itemProgressCallback(template.itemId, common.EItemProgressStatus.Finished, template.estimatedDeploymentCostFactor / 2, createResponse.id);
+        await common.setWorkflowConfigurationZip(configZipFile, createdWorkflowItemId, destinationAuthentication);
+        // Fetch the auxiliary items
+        const itemIds = await workflowHelpers.fetchAuxiliaryItems(createdWorkflowItemId, destinationAuthentication);
+        // Move the workflow and auxiliary items to the destination
+        itemIds.push(createdWorkflowItemId);
+        const moveResults = await common.moveItemsToFolder(itemIds, templateDictionary.folderId, destinationAuthentication);
+        const hasFailure = moveResults.some(result => {
+            return !result.success;
+        });
+        if (hasFailure) {
+            throw new Error("Failed to move all workflow items");
+        }
+        itemProgressCallback(template.itemId, common.EItemProgressStatus.Finished, template.estimatedDeploymentCostFactor / 2, createdWorkflowItemId);
         return Promise.resolve({
             item: newItemTemplate,
-            id: createResponse.id,
+            id: createdWorkflowItemId,
             type: newItemTemplate.type,
             postProcess: false
         });

package/dist/cjs/workflow.js.map

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

package/dist/cjs/workflowHelpers.d.ts

@@ -0,0 +1,38 @@
+/** @license
+ * Copyright 2024 Esri
+ *
+ * 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.
+ */
+/**
+ * Manages the creation and deployment of workflow item types.
+ *
+ * @module workflow
+ */
+import * as common from "@esri/solution-common";
+/**
+ * Creates a new workflow item.
+ *
+ * @param item Item to add
+ * @param authentication Credentials for requests to the workflow manager
+ * @returns Promise resolving with new item's AGO id
+ * @throws {WorkflowJsonExceptionDTO} if request to workflow manager fails
+ */
+export declare function addWorkflowItem(item: common.IItemTemplate, authentication: common.UserSession): Promise<string>;
+/**
+ * Fetches the auxiliary items.
+ *
+ * @param workflowItemId Workflow whose auxiliary items are to be fetched
+ * @param authentication Credentials for requests to the destination organization
+ * @returns List of auxiliary item ids
+ */
+export declare function fetchAuxiliaryItems(workflowItemId: string, authentication: common.UserSession): Promise<string[]>;

package/dist/cjs/workflowHelpers.js

@@ -0,0 +1,75 @@
+"use strict";
+/** @license
+ * Copyright 2024 Esri
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAuxiliaryItems = exports.addWorkflowItem = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Manages the creation and deployment of workflow item types.
+ *
+ * @module workflow
+ */
+const common = tslib_1.__importStar(require("@esri/solution-common"));
+const restRequest = tslib_1.__importStar(require("@esri/arcgis-rest-request"));
+// ------------------------------------------------------------------------------------------------------------------ //
+/**
+ * Creates a new workflow item.
+ *
+ * @param item Item to add
+ * @param authentication Credentials for requests to the workflow manager
+ * @returns Promise resolving with new item's AGO id
+ * @throws {WorkflowJsonExceptionDTO} if request to workflow manager fails
+ */
+async function addWorkflowItem(item, authentication) {
+    const user = await authentication.getUser({ authentication });
+    // Add the workflow item
+    const workflowUrl = `https://workflow.arcgis.com/${user.orgId}/admin/createWorkflowItem?name=${item.item.title}`;
+    const requestOptions = {
+        authentication: authentication,
+        headers: {
+            Accept: "application/json",
+            Authorization: `Bearer ${authentication.token}`,
+            "Content-Type": "application/json",
+            Host: "workflow.arcgis.com",
+            "X-Esri-Authorization": `Bearer ${authentication.token}`
+        },
+        params: {
+            name: `${item.item.title}`
+        }
+    };
+    const createdWorkflowResponse = await restRequest.request(workflowUrl, requestOptions);
+    return Promise.resolve(createdWorkflowResponse.itemId);
+}
+exports.addWorkflowItem = addWorkflowItem;
+/**
+ * Fetches the auxiliary items.
+ *
+ * @param workflowItemId Workflow whose auxiliary items are to be fetched
+ * @param authentication Credentials for requests to the destination organization
+ * @returns List of auxiliary item ids
+ */
+async function fetchAuxiliaryItems(workflowItemId, authentication) {
+    const workflowItemName = `workflow_${workflowItemId}`;
+    const workflowLocationsItemName = `WorkflowLocations_${workflowItemId}`;
+    const workflowViewsItemName = `workflow_views_${workflowItemId}`;
+    const auxiliaryItemsResults = await common.searchItems({
+        q: `title:${workflowItemName} OR title:${workflowLocationsItemName} OR title:${workflowViewsItemName}`,
+        authentication: authentication
+    });
+    return Promise.resolve(auxiliaryItemsResults.results.map(item => item.id));
+}
+exports.fetchAuxiliaryItems = fetchAuxiliaryItems;
+//# sourceMappingURL=workflowHelpers.js.map

package/dist/cjs/workflowHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowHelpers.js","sourceRoot":"","sources":["../../src/workflowHelpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;AAEH;;;;GAIG;AAEH,sEAAgD;AAChD,+EAAyD;AAEzD,wHAAwH;AAExH;;;;;;;GAOG;AACI,KAAK,UAAU,eAAe,CACnC,IAA0B,EAC1B,cAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;IAE9D,wBAAwB;IACxB,MAAM,WAAW,GAAG,+BAA+B,IAAI,CAAC,KAAK,kCAAkC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACjH,MAAM,cAAc,GAAgC;QAClD,cAAc,EAAE,cAAc;QAC9B,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,UAAU,cAAc,CAAC,KAAK,EAAE;YAC/C,cAAc,EAAE,kBAAkB;YAClC,IAAI,EAAE,qBAAqB;YAC3B,sBAAsB,EAAE,UAAU,cAAc,CAAC,KAAK,EAAE;SACzD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;SAC3B;KACF,CAAC;IACF,MAAM,uBAAuB,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAEvF,OAAO,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAxBD,0CAwBC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CACvC,cAAsB,EACtB,cAAkC;IAElC,MAAM,gBAAgB,GAAG,YAAY,cAAc,EAAE,CAAC;IACtD,MAAM,yBAAyB,GAAG,qBAAqB,cAAc,EAAE,CAAC;IACxE,MAAM,qBAAqB,GAAG,kBAAkB,cAAc,EAAE,CAAC;IAEjE,MAAM,qBAAqB,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACrD,CAAC,EAAE,SAAS,gBAAgB,aAAa,yBAAyB,aAAa,qBAAqB,EAAE;QACtG,cAAc,EAAE,cAAc;KAC/B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAbD,kDAaC"}

package/dist/esm/index.d.ts

@@ -19,3 +19,4 @@
  * @module workflow
  */
 export * from "./workflow";
+export * from "./workflowHelpers";

package/dist/esm/index.js

@@ -19,4 +19,5 @@
  * @module workflow
  */
 export * from "./workflow";
+export * from "./workflowHelpers";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/esm/workflow.d.ts

@@ -25,6 +25,7 @@ import * as common from "@esri/solution-common";
  * @param itemInfo Info about the item
  * @param destAuthentication Credentials for requests to the destination organization
  * @param srcAuthentication Credentials for requests to source items
+ * @param {any} templateDictionary Hash of facts: folder id, org URL, adlib replacements
  * @returns A promise that will resolve when the template has been created
  */
 export declare function convertItemToTemplate(itemInfo: any, destAuthentication: common.UserSession, srcAuthentication: common.UserSession): Promise<common.IItemTemplate>;

package/dist/esm/workflow.js

@@ -19,6 +19,7 @@
  * @module workflow
  */
 import * as common from "@esri/solution-common";
+import * as workflowHelpers from "./workflowHelpers";
 // ------------------------------------------------------------------------------------------------------------------ //
 /**
  * Converts a workflow item into a template.
@@ -26,6 +27,7 @@ import * as common from "@esri/solution-common";
  * @param itemInfo Info about the item
  * @param destAuthentication Credentials for requests to the destination organization
  * @param srcAuthentication Credentials for requests to source items
+ * @param {any} templateDictionary Hash of facts: folder id, org URL, adlib replacements
  * @returns A promise that will resolve when the template has been created
  */
 export async function convertItemToTemplate(itemInfo, destAuthentication, srcAuthentication) {
@@ -53,7 +55,7 @@ export async function convertItemToTemplate(itemInfo, destAuthentication, srcAut
         }
     });
     // Add the templatized configuration to the template
-    itemTemplate.properties.configuration = await common.extractAndTemplatizeWorkflowFromZipFile(configZip);
+    itemTemplate.properties.configuration = await common.extractWorkflowFromZipFile(configZip);
     return Promise.resolve(itemTemplate);
 }
 /**
@@ -80,26 +82,41 @@ export async function createItemFromTemplate(template, templateDictionary, desti
         newItemTemplate.item.thumbnail = template.item.thumbnail;
     }
     try {
-        // Create the item, then update its URL with its new id
-        const createResponse = await common.createItemWithData(newItemTemplate.item, newItemTemplate.data, destinationAuthentication, templateDictionary.folderId);
+        const createdWorkflowItemId = await workflowHelpers.addWorkflowItem(newItemTemplate, destinationAuthentication);
+        if (!createdWorkflowItemId) {
+            throw new Error("Failed to create workflow item");
+        }
         // Interrupt process if progress callback returns `false`
-        if (!itemProgressCallback(template.itemId, common.EItemProgressStatus.Created, template.estimatedDeploymentCostFactor / 2, createResponse.id)) {
+        if (!itemProgressCallback(template.itemId, common.EItemProgressStatus.Created, template.estimatedDeploymentCostFactor / 2, createdWorkflowItemId)) {
             itemProgressCallback(template.itemId, common.EItemProgressStatus.Cancelled, 0);
-            void common.removeItem(createResponse.id, destinationAuthentication);
+            void common.removeItem(createdWorkflowItemId, destinationAuthentication);
             return Promise.resolve(common.generateEmptyCreationResponse(template.type));
         }
         // Add the new item to the settings
-        newItemTemplate.itemId = newItemTemplate.item.id = createResponse.id;
+        newItemTemplate.itemId = newItemTemplate.item.id = createdWorkflowItemId;
         templateDictionary[template.itemId] = {
-            itemId: createResponse.id
+            itemId: createdWorkflowItemId
         };
-        // Add the item's configuration properties
+        // Detempletize the workflow configuration
+        newItemTemplate.properties.configuration = common.replaceInTemplate(newItemTemplate.properties.configuration, templateDictionary);
+        // Add the item's configuration properties; throw if the configuration update fails
         const configZipFile = await common.compressWorkflowIntoZipFile(newItemTemplate.properties.configuration);
-        await common.setWorkflowConfigurationZip(configZipFile, createResponse.id, destinationAuthentication);
-        itemProgressCallback(template.itemId, common.EItemProgressStatus.Finished, template.estimatedDeploymentCostFactor / 2, createResponse.id);
+        await common.setWorkflowConfigurationZip(configZipFile, createdWorkflowItemId, destinationAuthentication);
+        // Fetch the auxiliary items
+        const itemIds = await workflowHelpers.fetchAuxiliaryItems(createdWorkflowItemId, destinationAuthentication);
+        // Move the workflow and auxiliary items to the destination
+        itemIds.push(createdWorkflowItemId);
+        const moveResults = await common.moveItemsToFolder(itemIds, templateDictionary.folderId, destinationAuthentication);
+        const hasFailure = moveResults.some(result => {
+            return !result.success;
+        });
+        if (hasFailure) {
+            throw new Error("Failed to move all workflow items");
+        }
+        itemProgressCallback(template.itemId, common.EItemProgressStatus.Finished, template.estimatedDeploymentCostFactor / 2, createdWorkflowItemId);
         return Promise.resolve({
             item: newItemTemplate,
-            id: createResponse.id,
+            id: createdWorkflowItemId,
             type: newItemTemplate.type,
             postProcess: false
         });

package/dist/esm/workflow.js.map

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

package/dist/esm/workflowHelpers.d.ts

@@ -0,0 +1,38 @@
+/** @license
+ * Copyright 2024 Esri
+ *
+ * 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.
+ */
+/**
+ * Manages the creation and deployment of workflow item types.
+ *
+ * @module workflow
+ */
+import * as common from "@esri/solution-common";
+/**
+ * Creates a new workflow item.
+ *
+ * @param item Item to add
+ * @param authentication Credentials for requests to the workflow manager
+ * @returns Promise resolving with new item's AGO id
+ * @throws {WorkflowJsonExceptionDTO} if request to workflow manager fails
+ */
+export declare function addWorkflowItem(item: common.IItemTemplate, authentication: common.UserSession): Promise<string>;
+/**
+ * Fetches the auxiliary items.
+ *
+ * @param workflowItemId Workflow whose auxiliary items are to be fetched
+ * @param authentication Credentials for requests to the destination organization
+ * @returns List of auxiliary item ids
+ */
+export declare function fetchAuxiliaryItems(workflowItemId: string, authentication: common.UserSession): Promise<string[]>;

package/dist/esm/workflowHelpers.js

@@ -0,0 +1,69 @@
+/** @license
+ * Copyright 2024 Esri
+ *
+ * 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.
+ */
+/**
+ * Manages the creation and deployment of workflow item types.
+ *
+ * @module workflow
+ */
+import * as common from "@esri/solution-common";
+import * as restRequest from "@esri/arcgis-rest-request";
+// ------------------------------------------------------------------------------------------------------------------ //
+/**
+ * Creates a new workflow item.
+ *
+ * @param item Item to add
+ * @param authentication Credentials for requests to the workflow manager
+ * @returns Promise resolving with new item's AGO id
+ * @throws {WorkflowJsonExceptionDTO} if request to workflow manager fails
+ */
+export async function addWorkflowItem(item, authentication) {
+    const user = await authentication.getUser({ authentication });
+    // Add the workflow item
+    const workflowUrl = `https://workflow.arcgis.com/${user.orgId}/admin/createWorkflowItem?name=${item.item.title}`;
+    const requestOptions = {
+        authentication: authentication,
+        headers: {
+            Accept: "application/json",
+            Authorization: `Bearer ${authentication.token}`,
+            "Content-Type": "application/json",
+            Host: "workflow.arcgis.com",
+            "X-Esri-Authorization": `Bearer ${authentication.token}`
+        },
+        params: {
+            name: `${item.item.title}`
+        }
+    };
+    const createdWorkflowResponse = await restRequest.request(workflowUrl, requestOptions);
+    return Promise.resolve(createdWorkflowResponse.itemId);
+}
+/**
+ * Fetches the auxiliary items.
+ *
+ * @param workflowItemId Workflow whose auxiliary items are to be fetched
+ * @param authentication Credentials for requests to the destination organization
+ * @returns List of auxiliary item ids
+ */
+export async function fetchAuxiliaryItems(workflowItemId, authentication) {
+    const workflowItemName = `workflow_${workflowItemId}`;
+    const workflowLocationsItemName = `WorkflowLocations_${workflowItemId}`;
+    const workflowViewsItemName = `workflow_views_${workflowItemId}`;
+    const auxiliaryItemsResults = await common.searchItems({
+        q: `title:${workflowItemName} OR title:${workflowLocationsItemName} OR title:${workflowViewsItemName}`,
+        authentication: authentication
+    });
+    return Promise.resolve(auxiliaryItemsResults.results.map(item => item.id));
+}
+//# sourceMappingURL=workflowHelpers.js.map

package/dist/esm/workflowHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowHelpers.js","sourceRoot":"","sources":["../../src/workflowHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,WAAW,MAAM,2BAA2B,CAAC;AAEzD,wHAAwH;AAExH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAA0B,EAC1B,cAAkC;IAElC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;IAE9D,wBAAwB;IACxB,MAAM,WAAW,GAAG,+BAA+B,IAAI,CAAC,KAAK,kCAAkC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACjH,MAAM,cAAc,GAAgC;QAClD,cAAc,EAAE,cAAc;QAC9B,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,UAAU,cAAc,CAAC,KAAK,EAAE;YAC/C,cAAc,EAAE,kBAAkB;YAClC,IAAI,EAAE,qBAAqB;YAC3B,sBAAsB,EAAE,UAAU,cAAc,CAAC,KAAK,EAAE;SACzD;QACD,MAAM,EAAE;YACN,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;SAC3B;KACF,CAAC;IACF,MAAM,uBAAuB,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAEvF,OAAO,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,cAAsB,EACtB,cAAkC;IAElC,MAAM,gBAAgB,GAAG,YAAY,cAAc,EAAE,CAAC;IACtD,MAAM,yBAAyB,GAAG,qBAAqB,cAAc,EAAE,CAAC;IACxE,MAAM,qBAAqB,GAAG,kBAAkB,cAAc,EAAE,CAAC;IAEjE,MAAM,qBAAqB,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACrD,CAAC,EAAE,SAAS,gBAAgB,aAAa,yBAAyB,aAAa,qBAAqB,EAAE;QACtG,cAAc,EAAE,cAAc;KAC/B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esri/solution-workflow",
-  "version": "5.2.9",
+  "version": "5.2.10",
   "description": "Manages the creation and deployment of Workflow item types for @esri/solution.js.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -19,12 +19,12 @@
   ],
   "devDependencies": {
     "@esri/arcgis-rest-auth": "^3.7.0",
-    "@esri/solution-common": "^5.2.9",
+    "@esri/solution-common": "^5.2.10",
     "@types/jasmine": "^5.1.4",
     "fetch-mock": "^7.7.3",
     "jasmine": "^5.1.0",
     "jasmine-core": "^5.1.0",
-    "rollup": "^4.13.0"
+    "rollup": "^4.13.2"
   },
   "dependencies": {
     "jszip": "3.10.1",
@@ -66,5 +66,5 @@
     "esri",
     "ES6"
   ],
-  "gitHead": "bc37cab732ed83b30f5a160915c5f3ed2aaa438e"
+  "gitHead": "5ad94c5c39559c3399cc7c42ba1b0075ec618bf4"
 }