@esri/solution-deployer 6.1.0-alpha.0 → 6.2.0-alpha.0

package/dist/esm/deploySolutionFromTemplate.js

@@ -0,0 +1,319 @@
+/** @license
+ * Copyright 2018 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.
+ */
+import * as common from "@esri/solution-common";
+import * as deployItems from "./deploySolutionItems";
+import { getWithDefault } from "@esri/hub-common";
+import { postProcess } from "./helpers/post-process";
+import { sortTemplates } from "./helpers/sortTemplates";
+// NOTE: Moved to separate file to allow stubbing in main deploySolution tests
+export async function deploySolutionFromTemplate(templateSolutionId, solutionTemplateBase, solutionTemplateData, authentication, options) {
+    options.storageVersion = common.extractSolutionVersion(solutionTemplateData);
+    // It is possible to provide a separate authentication for the source
+    const storageAuthentication = options.storageAuthentication
+        ? options.storageAuthentication
+        : authentication;
+    // Replacement dictionary and high-level deployment ids for cleanup
+    // TODO: Extract all templateDictionary prep into a separate function
+    const templateDictionary = options.templateDictionary ?? {};
+    const preProcessResponse = common.preprocessWorkflowTemplates(solutionTemplateData.templates, templateDictionary);
+    solutionTemplateData.templates = preProcessResponse.deployTemplates;
+    _applySourceToDeployOptions(options, solutionTemplateBase, templateDictionary, authentication);
+    if (options.additionalTypeKeywords) {
+        solutionTemplateBase.typeKeywords = [].concat(solutionTemplateBase.typeKeywords, options.additionalTypeKeywords);
+    }
+    // Get the thumbnail file
+    let thumbFilename = "thumbnail";
+    let thumbDef = Promise.resolve(null);
+    if (!options.thumbnail && options.thumbnailurl) {
+        // Figure out the thumbnail's filename
+        thumbFilename = common.getFilenameFromUrl(options.thumbnailurl) || thumbFilename;
+        const thumbnailurl = common.appendQueryParam(options.thumbnailurl, "w=400");
+        delete options.thumbnailurl;
+        // Fetch the thumbnail
+        thumbDef = common.getBlobAsFile(thumbnailurl, thumbFilename, storageAuthentication, [400]);
+    }
+    _replaceParamVariables(solutionTemplateData, templateDictionary);
+    // Get information about deployment environment
+    const environResponses = await Promise.all([
+        common.getPortal("", authentication),
+        common.getPortalUrls(authentication),
+        common.getUser(authentication),
+        common.getFoldersAndGroups(authentication),
+        thumbDef,
+    ]);
+    const [portalResponse, portalUrlsResponse, userResponse, foldersAndGroupsResponse, thumbnailFile] = environResponses;
+    if (!options.thumbnail && thumbnailFile) {
+        options.thumbnail = thumbnailFile;
+    }
+    // update template items with source-itemId type keyword
+    solutionTemplateData.templates = _addSourceId(solutionTemplateData.templates);
+    templateDictionary.isPortal = portalResponse.isPortal;
+    templateDictionary.organization = Object.assign(templateDictionary.organization || {}, portalResponse);
+    // TODO: Add more computed properties here
+    // portal: portalResponse
+    // orgextent as bbox for assignment onto items
+    // more info in #266 https://github.com/Esri/solution.js/issues/266
+    templateDictionary.portalUrls = portalUrlsResponse.urls;
+    templateDictionary.portalBaseUrl = _getPortalBaseUrl(portalResponse, authentication);
+    templateDictionary.user = userResponse;
+    templateDictionary.user.folders = foldersAndGroupsResponse.folders;
+    templateDictionary.user.groups = foldersAndGroupsResponse.groups.filter((group) => group.owner === templateDictionary.user.username);
+    // Add information needed for workflow manager
+    const user = await common.getUser(authentication);
+    templateDictionary.workflowBaseUrl = await common.getWorkflowBaseURL(authentication, portalResponse, user.orgId);
+    // if we have tracking views and the user is not admin or the org doesn't support tracking an error is thrown
+    common.setLocationTrackingEnabled(portalResponse, userResponse, templateDictionary, solutionTemplateData.templates);
+    const trackingOwnerPromise = common.getTackingServiceOwner(templateDictionary, authentication);
+    // Create a folder to hold the deployed solution. We use the solution name, appending a sequential
+    // suffix if the folder exists, e.g.,
+    //  * Manage Right of Way Activities
+    //  * Manage Right of Way Activities 1
+    //  * Manage Right of Way Activities 2
+    const folderPromise = common.createUniqueFolder(solutionTemplateBase.title, templateDictionary, authentication);
+    // Apply the portal extents to the solution
+    const portalExtent = portalResponse.defaultExtent;
+    const extentsPromise = common.convertExtentWithFallback(portalExtent, undefined, { wkid: 4326 }, portalResponse.helperServices.geometry.url, authentication);
+    // Await completion of async actions: folder creation & extents conversion
+    const folderExtentsResponses = await Promise.all([folderPromise, extentsPromise, trackingOwnerPromise]);
+    const [folderResponse, wgs84Extent, trackingOwnerResponse] = folderExtentsResponses;
+    const deployedFolderId = folderResponse.folder.id;
+    templateDictionary.folderId = deployedFolderId;
+    templateDictionary.solutionItemExtent =
+        wgs84Extent.xmin + "," + wgs84Extent.ymin + "," + wgs84Extent.xmax + "," + wgs84Extent.ymax;
+    // Hub Solutions depend on organization defaultExtentBBox as a nested array not a string
+    templateDictionary.organization.defaultExtentBBox = [
+        [wgs84Extent.xmin, wgs84Extent.ymin],
+        [wgs84Extent.xmax, wgs84Extent.ymax],
+    ];
+    // update templateDictionary to indicate if the user owns the tracking service
+    // this will affect how we handle group sharing
+    /* istanbul ignore else */
+    if (templateDictionary.locationTrackingEnabled) {
+        common.setCreateProp(templateDictionary, "locationTracking.userIsOwner", trackingOwnerResponse);
+    }
+    let deployedSolutionId;
+    if (!options.dontCreateSolutionItem) {
+        // Create a deployed Solution item
+        solutionTemplateBase.categories = []; // we don't want to carry over categories from the template
+        const createSolutionItemBase = {
+            ...common.sanitizeJSON(solutionTemplateBase),
+            type: "Solution",
+            typeKeywords: ["Solution"],
+        };
+        if (options.additionalTypeKeywords) {
+            createSolutionItemBase.typeKeywords = ["Solution"].concat(options.additionalTypeKeywords);
+        }
+        // Create deployed solution item
+        createSolutionItemBase.thumbnail = options.thumbnail;
+        const createSolutionResponse = await common.createItemWithData(createSolutionItemBase, {}, authentication, deployedFolderId);
+        deployedSolutionId = createSolutionResponse.id;
+        // Protect the solution item
+        const protectOptions = {
+            id: deployedSolutionId,
+            authentication,
+        };
+        await common.protectItem(protectOptions);
+        // TODO: Attach the whole solution model so we can
+        // have stuff like `{{solution.item.title}}
+        templateDictionary.solutionItemId = deployedSolutionId;
+        solutionTemplateBase.id = deployedSolutionId;
+        solutionTemplateBase.tryitUrl = _checkedReplaceAll(solutionTemplateBase.tryitUrl, templateSolutionId, deployedSolutionId);
+        solutionTemplateBase.url = _checkedReplaceAll(solutionTemplateBase.url, templateSolutionId, deployedSolutionId);
+    }
+    // Handle the contained item templates
+    const clonedSolutionsResponse = await deployItems.deploySolutionItems(storageAuthentication.portal, templateSolutionId, solutionTemplateData.templates, storageAuthentication, templateDictionary, deployedSolutionId, authentication, options);
+    solutionTemplateData.templates = solutionTemplateData.templates.map((itemTemplate) => {
+        // Update ids present in template dictionary
+        itemTemplate.itemId = common.getProp(templateDictionary, `${itemTemplate.itemId}.itemId`);
+        // Update the dependencies hash to point to the new item ids
+        itemTemplate.dependencies = itemTemplate.dependencies.map((id) => getWithDefault(templateDictionary, `${id}.itemId`, id));
+        return itemTemplate;
+    });
+    // Sort the templates into build order, which is provided by clonedSolutionsResponse
+    sortTemplates(solutionTemplateData.templates, clonedSolutionsResponse.map((response) => response.id));
+    // Wrap up with post-processing, in which we deal with groups and cycle remnants
+    await postProcess(deployedSolutionId, solutionTemplateData.templates, clonedSolutionsResponse, authentication, templateDictionary);
+    if (!options.dontCreateSolutionItem) {
+        // Update solution item using internal representation & and the updated data JSON
+        solutionTemplateBase.typeKeywords = [].concat(solutionTemplateBase.typeKeywords, ["Deployed"]);
+        const iTemplateKeyword = solutionTemplateBase.typeKeywords.indexOf("Template");
+        /* istanbul ignore else */
+        if (iTemplateKeyword >= 0) {
+            solutionTemplateBase.typeKeywords.splice(iTemplateKeyword, 1);
+        }
+        solutionTemplateData.templates = solutionTemplateData.templates.map((itemTemplate) => _purgeTemplateProperties(itemTemplate));
+        _handleWorkflowManagedTemplates(preProcessResponse, solutionTemplateData);
+        solutionTemplateData.templates = _updateGroupReferences(solutionTemplateData.templates, templateDictionary);
+        solutionTemplateData.templates = common.updateWorkflowTemplateIds(solutionTemplateData.templates, templateDictionary);
+        // Update solution items data using template dictionary, and then update the
+        // itemId & dependencies in each item template
+        solutionTemplateBase.data = common.replaceInTemplate(solutionTemplateData, templateDictionary);
+        // Write any user defined params to the solution
+        /* istanbul ignore else */
+        if (templateDictionary.params) {
+            solutionTemplateBase.data.params = templateDictionary.params;
+        }
+        await common.updateItem(solutionTemplateBase, authentication, deployedFolderId);
+    }
+    return solutionTemplateBase.id;
+}
+/**
+ * Add templates for the items that were automatically created by workflow
+ *
+ * @param preProcessResponse response from pre processing of workflow items
+ * @param solutionTemplateData the current solution template data that will be used to show item details
+ */
+export function _handleWorkflowManagedTemplates(preProcessResponse, solutionTemplateData) {
+    preProcessResponse.workflowManagedTemplates.forEach((itemTemplate) => {
+        solutionTemplateData.templates.push(_purgeTemplateProperties(itemTemplate));
+    });
+}
+/**
+ * Add source-id to items/groups typeKeywords
+ *
+ * @param template the array of solution data templates
+ * @private
+ */
+export function _addSourceId(templates) {
+    return templates.map((template) => {
+        /* istanbul ignore else */
+        if (template.item) {
+            const typeKeywords = template.item.typeKeywords || [];
+            typeKeywords.push("source-" + template.itemId);
+            template.item.typeKeywords = typeKeywords;
+        }
+        return template;
+    });
+}
+/**
+ * Update the deployOptions with the group properties
+ *
+ * @param deployOptions
+ * @param sourceInfo
+ * @param authentication
+ * @param isGroup Boolean to indicate if the files are associated with a group or item
+ * @private
+ */
+export function _applySourceToDeployOptions(deployOptions, solutionTemplateBase, templateDictionary, authentication) {
+    // Deploy a solution from the template's contents,
+    // using the template's information as defaults for the deployed solution item
+    ["title", "snippet", "description", "tags"].forEach((prop) => {
+        deployOptions[prop] = deployOptions[prop] ?? solutionTemplateBase[prop];
+        if (deployOptions[prop]) {
+            solutionTemplateBase[prop] = deployOptions[prop];
+            // carry these options forward on the templateDict
+            templateDictionary[prop] = deployOptions[prop];
+        }
+    });
+    if (!deployOptions.thumbnailurl && solutionTemplateBase.thumbnail) {
+        // Get the full path to the thumbnail
+        deployOptions.thumbnailurl = common.generateSourceThumbnailUrl(authentication.portal, solutionTemplateBase.id, solutionTemplateBase.thumbnail);
+        delete solutionTemplateBase.thumbnail;
+    }
+    return deployOptions;
+}
+//TODO: function doc
+export function _replaceParamVariables(solutionTemplateData, templateDictionary) {
+    // a custom params object can be passed in with the options to deploy a solution
+    // in most cases we can defer to the item type handlers to use these values
+    // for variable replacement
+    // for spatial reference specifically we need to replace up front so the default extent
+    // logic can execute as expected
+    solutionTemplateData.templates = solutionTemplateData.templates.map((template) => {
+        // can't do this as it causes other values that don't exist in the dict yet to revert to defaults they may have defined
+        // return common.replaceInTemplate(template, templateDictionary);
+        /* istanbul ignore else */
+        if (template.type === "Feature Service") {
+            const paramsLookup = "params.";
+            const wkidItemPath = "item.spatialReference.wkid";
+            template = _updateProp(template, wkidItemPath, paramsLookup, templateDictionary);
+            const wkidServicePath = "properties.service.spatialReference.wkid";
+            template = _updateProp(template, wkidServicePath, paramsLookup, templateDictionary);
+        }
+        return template;
+    });
+}
+//TODO: function doc
+export function _updateProp(template, path, lookup, templateDictionary) {
+    const wkid = common.getProp(template, path);
+    /* istanbul ignore else */
+    if (wkid && typeof wkid === "string" && wkid.indexOf(lookup) > -1) {
+        common.setProp(template, path, common.replaceInTemplate(wkid, templateDictionary));
+    }
+    return template;
+}
+//TODO: function doc
+export function _checkedReplaceAll(template, oldValue, newValue) {
+    let newTemplate;
+    if (template && template.indexOf(oldValue) > -1) {
+        const re = new RegExp(oldValue, "g");
+        newTemplate = template.replace(re, newValue);
+    }
+    else {
+        newTemplate = template;
+    }
+    return newTemplate;
+}
+//TODO: function doc
+export function _getPortalBaseUrl(portalResponse, authentication) {
+    // As of Spring 2020, only HTTPS (see
+    // https://www.esri.com/arcgis-blog/products/product/administration/2019-arcgis-transport-security-improvements/)
+    const scheme = "https"; // portalResponse.allSSL ? "https" : "http";
+    const urlKey = common.getProp(portalResponse, "urlKey");
+    const customBaseUrl = common.getProp(portalResponse, "customBaseUrl");
+    const enterpriseBaseUrl = common.getProp(portalResponse, "portalHostname");
+    return urlKey && customBaseUrl
+        ? `${scheme}://${urlKey}.${customBaseUrl}`
+        : enterpriseBaseUrl
+            ? `${scheme}://${enterpriseBaseUrl}`
+            : authentication.portal.replace("/sharing/rest", "");
+}
+//TODO: function doc
+export function _updateGroupReferences(itemTemplates, templateDictionary) {
+    const groupIds = itemTemplates.reduce((result, t) => {
+        if (t.type === "Group") {
+            result.push(t.itemId);
+        }
+        return result;
+    }, []);
+    Object.keys(templateDictionary).forEach((k) => {
+        const newId = templateDictionary[k].itemId;
+        if (groupIds.indexOf(newId) > -1) {
+            itemTemplates.forEach((t) => {
+                t.groups = t.groups.map((id) => (id === k ? newId : id));
+            });
+        }
+    });
+    return itemTemplates;
+}
+//TODO: function doc
+export function _purgeTemplateProperties(itemTemplate) {
+    const retainProps = ["itemId", "type", "dependencies", "groups"];
+    const deleteProps = Object.keys(itemTemplate).filter((k) => retainProps.indexOf(k) < 0);
+    common.deleteProps(itemTemplate, deleteProps);
+    return itemTemplate;
+}
+/**
+ * Returns a match of a supplied id with the suffix ".itemId" in the template dictionary.
+ *
+ * @param id Id to look for
+ * @param templateDictionary Hash mapping property names to replacement values
+ * @returns Match in template dictionary or original id
+ */
+export function _getNewItemId(id, templateDictionary) {
+    return common.getProp(templateDictionary, id + ".itemId") ?? id;
+}
+//# sourceMappingURL=deploySolutionFromTemplate.js.map

package/dist/esm/deploySolutionFromTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploySolutionFromTemplate.js","sourceRoot":"","sources":["../../src/deploySolutionFromTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,kBAA0B,EAC1B,oBAAyB,EACzB,oBAAyB,EACzB,cAAkC,EAClC,OAAsC;IAEtC,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAE7E,qEAAqE;IACrE,MAAM,qBAAqB,GAAuB,OAAO,CAAC,qBAAqB;QAC7E,CAAC,CAAC,OAAO,CAAC,qBAAqB;QAC/B,CAAC,CAAC,cAAc,CAAC;IAEnB,mEAAmE;IAEnE,qEAAqE;IACrE,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAE5D,MAAM,kBAAkB,GAAG,MAAM,CAAC,2BAA2B,CAAC,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAElH,oBAAoB,CAAC,SAAS,GAAG,kBAAkB,CAAC,eAAe,CAAC;IAEpE,2BAA2B,CAAC,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;IAE/F,IAAI,OAAO,CAAC,sBAAsB,EAAE;QAClC,oBAAoB,CAAC,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;KAClH;IAED,yBAAyB;IACzB,IAAI,aAAa,GAAG,WAAW,CAAC;IAChC,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE;QAC9C,sCAAsC;QACtC,aAAa,GAAG,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,aAAa,CAAC;QACjF,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC5E,OAAO,OAAO,CAAC,YAAY,CAAC;QAE5B,sBAAsB;QACtB,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC5F;IAED,sBAAsB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IAEjE,+CAA+C;IAC/C,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,cAAc,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;QAC9B,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC;QAC1C,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,wBAAwB,EAAE,aAAa,CAAC,GAAG,gBAAgB,CAAC;IACrH,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,aAAa,EAAE;QACvC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC;KACnC;IAED,wDAAwD;IACxD,oBAAoB,CAAC,SAAS,GAAG,YAAY,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAE9E,kBAAkB,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC;IACtD,kBAAkB,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,YAAY,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;IACvG,0CAA0C;IAC1C,yBAAyB;IACzB,8CAA8C;IAC9C,mEAAmE;IAEnE,kBAAkB,CAAC,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAExD,kBAAkB,CAAC,aAAa,GAAG,iBAAiB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAErF,kBAAkB,CAAC,IAAI,GAAG,YAAY,CAAC;IACvC,kBAAkB,CAAC,IAAI,CAAC,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC;IACnE,kBAAkB,CAAC,IAAI,CAAC,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,MAAM,CACrE,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAC3E,CAAC;IAEF,8CAA8C;IAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,kBAAkB,CAAC,eAAe,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEjH,6GAA6G;IAC7G,MAAM,CAAC,0BAA0B,CAAC,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpH,MAAM,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;IAE/F,kGAAkG;IAClG,qCAAqC;IACrC,oCAAoC;IACpC,sCAAsC;IACtC,sCAAsC;IACtC,MAAM,aAAa,GAAG,MAAM,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC;IAEhH,2CAA2C;IAC3C,MAAM,YAAY,GAAQ,cAAc,CAAC,aAAa,CAAC;IACvD,MAAM,cAAc,GAAG,MAAM,CAAC,yBAAyB,CACrD,YAAY,EACZ,SAAS,EACT,EAAE,IAAI,EAAE,IAAI,EAAE,EACd,cAAc,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,EAC1C,cAAc,CACf,CAAC;IAEF,0EAA0E;IAC1E,MAAM,sBAAsB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACxG,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,qBAAqB,CAAC,GAAG,sBAAsB,CAAC;IACpF,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IAClD,kBAAkB,CAAC,QAAQ,GAAG,gBAAgB,CAAC;IAC/C,kBAAkB,CAAC,kBAAkB;QACnC,WAAW,CAAC,IAAI,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,GAAG,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9F,wFAAwF;IACxF,kBAAkB,CAAC,YAAY,CAAC,iBAAiB,GAAG;QAClD,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;QACpC,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;KACrC,CAAC;IAEF,8EAA8E;IAC9E,+CAA+C;IAC/C,0BAA0B;IAC1B,IAAI,kBAAkB,CAAC,uBAAuB,EAAE;QAC9C,MAAM,CAAC,aAAa,CAAC,kBAAkB,EAAE,8BAA8B,EAAE,qBAAqB,CAAC,CAAC;KACjG;IAED,IAAI,kBAAkB,CAAC;IACvB,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE;QACnC,kCAAkC;QAClC,oBAAoB,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,2DAA2D;QACjG,MAAM,sBAAsB,GAAG;YAC7B,GAAG,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC;YAC5C,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE,CAAC,UAAU,CAAC;SAC3B,CAAC;QAEF,IAAI,OAAO,CAAC,sBAAsB,EAAE;YAClC,sBAAsB,CAAC,YAAY,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;SAC3F;QAED,gCAAgC;QAChC,sBAAsB,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrD,MAAM,sBAAsB,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAC5D,sBAAsB,EACtB,EAAE,EACF,cAAc,EACd,gBAAgB,CACjB,CAAC;QAEF,kBAAkB,GAAG,sBAAsB,CAAC,EAAE,CAAC;QAE/C,4BAA4B;QAC5B,MAAM,cAAc,GAA4B;YAC9C,EAAE,EAAE,kBAAkB;YACtB,cAAc;SACf,CAAC;QACF,MAAM,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAEzC,kDAAkD;QAClD,2CAA2C;QAC3C,kBAAkB,CAAC,cAAc,GAAG,kBAAkB,CAAC;QACvD,oBAAoB,CAAC,EAAE,GAAG,kBAAkB,CAAC;QAE7C,oBAAoB,CAAC,QAAQ,GAAG,kBAAkB,CAChD,oBAAoB,CAAC,QAAQ,EAC7B,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;QACF,oBAAoB,CAAC,GAAG,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;KACjH;IAED,sCAAsC;IACtC,MAAM,uBAAuB,GAA6C,MAAM,WAAW,CAAC,mBAAmB,CAC7G,qBAAqB,CAAC,MAAM,EAC5B,kBAAkB,EAClB,oBAAoB,CAAC,SAAS,EAC9B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,OAAO,CACR,CAAC;IAEF,oBAAoB,CAAC,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,YAAkC,EAAE,EAAE;QACzG,4CAA4C;QAC5C,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC;QAE1F,4DAA4D;QAC5D,YAAY,CAAC,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAU,EAAE,EAAE,CACvE,cAAc,CAAC,kBAAkB,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CACvD,CAAC;QACF,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,oFAAoF;IACpF,aAAa,CACX,oBAAoB,CAAC,SAAS,EAC9B,uBAAuB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CACvD,CAAC;IAEF,gFAAgF;IAChF,MAAM,WAAW,CACf,kBAAkB,EAClB,oBAAoB,CAAC,SAAS,EAC9B,uBAAuB,EACvB,cAAc,EACd,kBAAkB,CACnB,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE;QACnC,iFAAiF;QACjF,oBAAoB,CAAC,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/F,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/E,0BAA0B;QAC1B,IAAI,gBAAgB,IAAI,CAAC,EAAE;YACzB,oBAAoB,CAAC,YAAY,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;SAC/D;QAED,oBAAoB,CAAC,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,YAAkC,EAAE,EAAE,CACzG,wBAAwB,CAAC,YAAY,CAAC,CACvC,CAAC;QAEF,+BAA+B,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;QAE1E,oBAAoB,CAAC,SAAS,GAAG,sBAAsB,CAAC,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAE5G,oBAAoB,CAAC,SAAS,GAAG,MAAM,CAAC,yBAAyB,CAC/D,oBAAoB,CAAC,SAAS,EAC9B,kBAAkB,CACnB,CAAC;QAEF,4EAA4E;QAC5E,8CAA8C;QAC9C,oBAAoB,CAAC,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAE/F,gDAAgD;QAChD,0BAA0B;QAC1B,IAAI,kBAAkB,CAAC,MAAM,EAAE;YAC7B,oBAAoB,CAAC,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC;SAC9D;QAED,MAAM,MAAM,CAAC,UAAU,CAAC,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;KACjF;IAED,OAAO,oBAAoB,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,kBAA+D,EAC/D,oBAAyB;IAEzB,kBAAkB,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,YAAkC,EAAE,EAAE;QACzF,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiC;IAC5D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE;QACrC,0BAA0B;QAC1B,IAAI,QAAQ,CAAC,IAAI,EAAE;YACjB,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAK,CAAC,YAAY,IAAI,EAAE,CAAC;YACvD,YAAY,CAAC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;SAC3C;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,aAA4C,EAC5C,oBAAyB,EACzB,kBAAuB,EACvB,cAAkC;IAElC,kDAAkD;IAClD,8EAA8E;IAC9E,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3D,aAAa,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxE,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE;YACvB,oBAAoB,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YACjD,kDAAkD;YAClD,kBAAkB,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;SAChD;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,CAAC,YAAY,IAAI,oBAAoB,CAAC,SAAS,EAAE;QACjE,qCAAqC;QACrC,aAAa,CAAC,YAAY,GAAG,MAAM,CAAC,0BAA0B,CAC5D,cAAc,CAAC,MAAM,EACrB,oBAAoB,CAAC,EAAE,EACvB,oBAAoB,CAAC,SAAS,CAC/B,CAAC;QACF,OAAO,oBAAoB,CAAC,SAAS,CAAC;KACvC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,oBAAyB,EAAE,kBAAuB;IACvF,gFAAgF;IAChF,2EAA2E;IAC3E,2BAA2B;IAC3B,uFAAuF;IACvF,gCAAgC;IAChC,oBAAoB,CAAC,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAA8B,EAAE,EAAE;QACrG,uHAAuH;QACvH,iEAAiE;QACjE,0BAA0B;QAC1B,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,EAAE;YACvC,MAAM,YAAY,GAAW,SAAS,CAAC;YAEvC,MAAM,YAAY,GAAW,4BAA4B,CAAC;YAC1D,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;YAEjF,MAAM,eAAe,GAAW,0CAA0C,CAAC;YAC3E,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;SACrF;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,WAAW,CACzB,QAA8B,EAC9B,IAAY,EACZ,MAAc,EACd,kBAAuB;IAEvB,MAAM,IAAI,GAAQ,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,0BAA0B;IAC1B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;QACjE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC;KACpF;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB;IACrF,IAAI,WAAW,CAAC;IAChB,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE;QAC/C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;KAC9C;SAAM;QACL,WAAW,GAAG,QAAQ,CAAC;KACxB;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,iBAAiB,CAAC,cAA8B,EAAE,cAAkC;IAClG,qCAAqC;IACrC,iHAAiH;IACjH,MAAM,MAAM,GAAW,OAAO,CAAC,CAAC,4CAA4C;IAC5E,MAAM,MAAM,GAAW,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAChE,MAAM,aAAa,GAAW,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAE3E,OAAO,MAAM,IAAI,aAAa;QAC5B,CAAC,CAAC,GAAG,MAAM,MAAM,MAAM,IAAI,aAAa,EAAE;QAC1C,CAAC,CAAC,iBAAiB;YACjB,CAAC,CAAC,GAAG,MAAM,MAAM,iBAAiB,EAAE;YACpC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,aAAoB,EAAE,kBAAuB;IAClF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAgB,EAAE,CAAuB,EAAE,EAAE;QAClF,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE;YACtB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACvB;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAW,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACnD,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE;YAChC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC1B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;SACJ;IACH,CAAC,CAAC,CAAC;IACH,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,wBAAwB,CAAC,YAAiB;IACxD,MAAM,WAAW,GAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAa,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClG,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAC9C,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,kBAAuB;IAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/esm/deploySolutionItems.d.ts

@@ -0,0 +1,224 @@
+/** @license
+ * Copyright 2018 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 deployment of items via the REST API.
+ *
+ * @module deployItems
+ */
+import * as common from "@esri/solution-common";
+/**
+ * Deploys a set of items defined by templates.
+ *
+ * @param portalSharingUrl Server/sharing
+ * @param storageItemId Id of storage item
+ * @param templates A collection of AGO item templates
+ * @param storageAuthentication Credentials for the organization with the source items
+ * @param templateDictionary Hash of facts: org URL, adlib replacements
+ * @param deployedSolutionId Id of deployed Solution item
+ * @param destinationAuthentication Credentials for the destination organization
+ * @param options Options to tune deployment
+ * @returns A promise that will resolve with the list of information about the created items
+ */
+export declare function deploySolutionItems(portalSharingUrl: string, storageItemId: string, templates: common.IItemTemplate[], storageAuthentication: common.UserSession, templateDictionary: any, deployedSolutionId: string, destinationAuthentication: common.UserSession, options: common.IDeploySolutionOptions): Promise<common.ICreateItemFromTemplateResponse[]>;
+/**
+ * For each item to be patched, convert it to its cloned id and mark the item as needing post processing.
+ *
+ * @param itemsToBePatched List of items that need to have their dependencies patched
+ * @param templateDictionary Hash of facts: org URL, adlib replacements
+ * @param templates A collection of AGO item templates
+ * @private
+ */
+export declare function _flagPatchItemsForPostProcessing(itemsToBePatched: common.IKeyedListsOfStrings, templateDictionary: any, templates: common.ICreateItemFromTemplateResponse[]): void;
+/**
+ * Portal does not allow views of a single source to be created at the same time.
+ *
+ * Update view templates with an array of other view template ids that it should wait on.
+ *
+ * @param templates a collection of AGO item templates
+ *
+ * @returns An updated array of item templates
+ * @private
+ */
+export declare function _evaluateSharedViewSources(templates: common.IItemTemplate[]): common.IItemTemplate[];
+/**
+ * Add a syncViews array to each template that will hold all other view ids that
+ * have the same FS dependency.
+ * These arrays will be processed later to only contain ids that each view will need to wait on.
+ *
+ * @param templates a collection of AGO item templates
+ * @param views an array of view template details
+ *
+ * @returns An updated array of item templates
+ * @private
+ */
+export declare function _updateViewTemplates(templates: common.IItemTemplate[], views: any[]): common.IItemTemplate[];
+/**
+ * Get all view templates from the source templates collection
+ *
+ * @param views A collection of view ID and dependencies
+ *
+ * @returns an array of objects with the source FS id as the key and a list of views that are
+ * dependant upon it
+ *
+ * @private
+ */
+export declare function _getViewHash(views: any[]): any;
+/**
+ * Get all view templates from the source templates collection
+ *
+ * @param templates A collection of AGO item templates
+ *
+ * @returns an array with the view id and its dependencies
+ *
+ * @private
+ */
+export declare function _getViews(templates: common.IItemTemplate[]): any[];
+/**
+ * Search for existing items and update the templateDictionary with key details
+ *
+ * @param templates A collection of AGO item templates
+ * @param reuseItems Option to search for existing items
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param authentication Credentials for the requests
+ *
+ * @returns A Promise that will resolve once existing items have been evaluated
+ *
+ * @private
+ */
+export declare function _reuseDeployedItems(templates: common.IItemTemplate[], reuseItems: boolean, templateDictionary: any, authentication: common.UserSession): Promise<any>;
+/**
+ * Search for existing items and update the templateDictionary with key details
+ *
+ * Subtle difference between _reuseDeployedItems and _useExistingItems
+ * _reuseDeployedItems: will search all existing items based on specific type keywords
+ *   that would have been added by a previous deployment
+ * _useExistingItems: will search for an existing item that the user provided
+ *   the item id for while configuring in the deployment app.
+ *   This type of item would not necessarily have been laid down by a previous deployment and
+ *   can thus not expect that it will have the type keywords
+ *
+ * @param templates A collection of AGO item templates
+ * @param useExisting Option to search for existing items
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param authentication Credentials for the requests
+ *
+ * @returns A Promise that will resolve once existing items have been evaluated
+ *
+ * @private
+ */
+export declare function _useExistingItems(templates: common.IItemTemplate[], useExisting: boolean, templateDictionary: any, authentication: common.UserSession): Promise<any>;
+/**
+ * Verify if the existing item has the source-<itemId> typeKeyword and set it if not
+ * This allows items that did not come from deployment to be found for reuse after they
+ * have been used once via a custom itemId param
+ *
+ * @param itemDefs
+ * @param sourceIdHash key value pairs..actual itemId is the key and the source itemId is the value
+ * @param authentication credentials for the requests
+ *
+ * @returns a promise to indicate when the requests are complete
+ * @private
+ */
+export declare function _setTypekeywordForExisting(itemDefs: Array<Promise<any>>, sourceIdHash: any, authentication: common.UserSession): Promise<any>;
+/**
+ * Update the templateDictionary with key details by item type
+ *
+ * @param templates A collection of AGO item templates
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ *
+ * @private
+ */
+export declare function _updateTemplateDictionary(templates: common.IItemTemplate[], templateDictionary: any, authentication: common.UserSession): Promise<any>;
+/**
+ * Add the fields from the source layer to the template dictionary for any required replacements
+ *
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param itemId the id for the item
+ * @param layerId the id for the layer
+ * @param fields the fields to transfer
+ *
+ * @private
+ */
+export declare function _setFields(templateDictionary: any, itemId: string, layerId: string, fields: any[]): void;
+/**
+ * In some cases an item id search will return a stale item reference
+ * it will subsequently fail when we try to fetch the underlying service.
+ *
+ * We need to remove the item info that has been added to the template dictionary
+ * and treat the item as we do other items that don't already exist on deployment.
+ *
+ * @param result the service request result
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ *
+ * @private
+ */
+export declare function _updateTemplateDictionaryForError(templateDictionary: any, itemId: string): any;
+/**
+ * Optionally search by tags and then update the templateDictionary based on the search results
+ *
+ * @param existingItemsResponse response object from search by typeKeyword and type
+ * @param existingItemIds list of the template ids we have queried
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param authentication Credentials for the request
+ * @param addTagQuery Boolean to indicate if a search by tag should happen
+ * @returns IFindExistingItemsResponse object with  promise that will resolve with an array of results
+ * and an array of item ids
+ * @private
+ */
+export declare function _handleExistingItems(existingItemsResponse: any[], existingItemInfos: common.IFindExistingItemInfos[], templateDictionary: any, authentication: common.UserSession, addTagQuery: boolean): common.IFindExistingItemsResponse;
+export declare function _updateTemplateDictionaryById(templateDictionary: any, sourceId: string, itemId: string, v: any): void;
+/**
+ * Search items based on user query
+ *
+ * @param templates Templates to examine
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param authentication Credentials for the request
+ * @returns IFindExistingItemsResponse object with  promise that will resolve with an array of results
+ * and an array of item ids
+ * @private
+ */
+export declare function _findExistingItemByKeyword(templates: common.IItemTemplate[], templateDictionary: any, authentication: common.UserSession): common.IFindExistingItemsResponse;
+/**
+ * Search items based on user query
+ *
+ * @param query Query string to use
+ * @param authentication Credentials for the request
+ * @returns A promise that will resolve with an array of results
+ * @private
+ */
+export declare function _findExistingItem(query: string, authentication: common.UserSession): Promise<any>;
+/**
+ * Creates an item from a template once the item's dependencies have been created.
+ *
+ * @param template Template of item to deploy
+ * @param resourceFilePaths URL, folder, and filename for each item resource/metadata/thumbnail
+ * @param templateDictionary Hash of facts: org URL, adlib replacements, deferreds for dependencies
+ * @param userSession Options for the request
+ * @param itemProgressCallback Function for reporting progress updates from type-specific template handlers
+ * @returns A promise that will resolve with the id of the deployed item (which is simply returned if it's
+ *         already in the templates list
+ * @private
+ */
+export declare function _createItemFromTemplateWhenReady(template: common.IItemTemplate, resourceFilePaths: common.IDeployFileCopyPath[], storageAuthentication: common.UserSession, templateDictionary: any, destinationAuthentication: common.UserSession, itemProgressCallback: common.IItemProgressCallback): Promise<common.ICreateItemFromTemplateResponse>;
+/**
+ * Accumulates the estimated deployment cost of a set of templates.
+ *
+ * @param templates Templates to examine
+ * @returns Sum of estimated deployment costs
+ * @private
+ */
+export declare function _estimateDeploymentCost(templates: common.IItemTemplate[]): number;
+export declare function _getGroupUpdates(template: common.IItemTemplate, authentication: common.UserSession, templateDictionary: any): Array<Promise<any>>;