@esri/solution-deployer 4.1.0 → 4.1.2-alpha.0

package/dist/cjs/deploySolutionFromTemplate.d.ts

@@ -0,0 +1,48 @@
+/** @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";
+export declare function deploySolutionFromTemplate(templateSolutionId: string, solutionTemplateBase: any, solutionTemplateData: any, authentication: common.UserSession, options: common.IDeploySolutionOptions): Promise<string>;
+/**
+ * Add source-id to items/groups typeKeywords
+ *
+ * @param template the array of solution data templates
+ * @private
+ */
+export declare function _addSourceId(templates: common.IItemTemplate[]): common.IItemTemplate[];
+/**
+ * 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 declare function _applySourceToDeployOptions(deployOptions: common.IDeploySolutionOptions, solutionTemplateBase: any, templateDictionary: any, authentication: common.UserSession): common.IDeploySolutionOptions;
+export declare function _replaceParamVariables(solutionTemplateData: any, templateDictionary: any): void;
+export declare function _updateProp(template: common.IItemTemplate, path: string, lookup: string, templateDictionary: any): common.IItemTemplate;
+export declare function _checkedReplaceAll(template: string, oldValue: string, newValue: string): string;
+export declare function _getPortalBaseUrl(portalResponse: common.IPortal, authentication: common.UserSession): string;
+export declare function _updateGroupReferences(itemTemplates: any[], templateDictionary: any): any[];
+export declare function _purgeTemplateProperties(itemTemplate: any): any;
+/**
+ * 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 declare function _getNewItemId(id: string, templateDictionary: any): string;

package/dist/cjs/deploySolutionFromTemplate.js

@@ -0,0 +1,332 @@
+"use strict";
+/** @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._getNewItemId = exports._purgeTemplateProperties = exports._updateGroupReferences = exports._getPortalBaseUrl = exports._checkedReplaceAll = exports._updateProp = exports._replaceParamVariables = exports._applySourceToDeployOptions = exports._addSourceId = exports.deploySolutionFromTemplate = void 0;
+const tslib_1 = require("tslib");
+const common = tslib_1.__importStar(require("@esri/solution-common"));
+const deployItems = tslib_1.__importStar(require("./deploySolutionItems"));
+const hub_common_1 = require("@esri/hub-common");
+const portal = tslib_1.__importStar(require("@esri/arcgis-rest-portal"));
+const post_process_1 = require("./helpers/post-process");
+const sortTemplates_1 = require("./helpers/sortTemplates");
+const solution_common_1 = require("@esri/solution-common");
+// NOTE: Moved to separate file to allow stubbing in main deploySolution tests
+function deploySolutionFromTemplate(templateSolutionId, solutionTemplateBase, solutionTemplateData, authentication, options) {
+    options.storageVersion = common.extractSolutionVersion(solutionTemplateData);
+    return new Promise((resolve, reject) => {
+        // 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 ?? {};
+        let deployedFolderId;
+        let deployedSolutionId;
+        _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
+        Promise.all([
+            common.getPortal("", authentication),
+            common.getUser(authentication),
+            common.getFoldersAndGroups(authentication),
+            thumbDef
+        ])
+            .then(responses => {
+            const [portalResponse, userResponse, foldersAndGroupsResponse, thumbnailFile] = responses;
+            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.portalBaseUrl = _getPortalBaseUrl(portalResponse, authentication);
+            templateDictionary.user = userResponse;
+            templateDictionary.user.folders = foldersAndGroupsResponse.folders;
+            templateDictionary.user.groups = foldersAndGroupsResponse.groups.filter((group) => group.owner === templateDictionary.user.username);
+            // 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
+            return Promise.all([folderPromise, extentsPromise, trackingOwnerPromise]);
+        })
+            .then(responses => {
+            const [folderResponse, wgs84Extent, trackingOwnerResponse] = responses;
+            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) {
+                (0, solution_common_1.setCreateProp)(templateDictionary, "locationTracking.userIsOwner", trackingOwnerResponse);
+            }
+            // Create a deployed Solution item
+            const createSolutionItemBase = {
+                ...common.sanitizeJSONAndReportChanges(solutionTemplateBase),
+                type: "Solution",
+                typeKeywords: ["Solution"]
+            };
+            if (options.additionalTypeKeywords) {
+                createSolutionItemBase.typeKeywords = ["Solution"].concat(options.additionalTypeKeywords);
+            }
+            // Create deployed solution item
+            createSolutionItemBase.thumbnail = options.thumbnail;
+            return common.createItemWithData(createSolutionItemBase, {}, authentication, deployedFolderId);
+        })
+            .then(createSolutionResponse => {
+            deployedSolutionId = createSolutionResponse.id;
+            // Protect the solution item
+            const protectOptions = {
+                id: deployedSolutionId,
+                authentication
+            };
+            return portal.protectItem(protectOptions);
+        })
+            .then(() => {
+            // 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
+            return deployItems.deploySolutionItems(storageAuthentication.portal, templateSolutionId, solutionTemplateData.templates, storageAuthentication, templateDictionary, deployedSolutionId, authentication, options);
+        })
+            .then((clonedSolutionsResponse) => {
+            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) => (0, hub_common_1.getWithDefault)(templateDictionary, `${id}.itemId`, id));
+                return itemTemplate;
+            });
+            // Sort the templates into build order, which is provided by clonedSolutionsResponse
+            (0, sortTemplates_1.sortTemplates)(solutionTemplateData.templates, clonedSolutionsResponse.map(response => response.id));
+            // Wrap up with post-processing, in which we deal with groups and cycle remnants
+            return (0, post_process_1.postProcess)(deployedSolutionId, solutionTemplateData.templates, clonedSolutionsResponse, authentication, templateDictionary);
+        })
+            .then(() => {
+            // 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));
+            solutionTemplateData.templates = _updateGroupReferences(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;
+            }
+            return common.updateItem(solutionTemplateBase, authentication, deployedFolderId);
+        })
+            .then(() => resolve(solutionTemplateBase.id), reject);
+    });
+}
+exports.deploySolutionFromTemplate = deploySolutionFromTemplate;
+/**
+ * Add source-id to items/groups typeKeywords
+ *
+ * @param template the array of solution data templates
+ * @private
+ */
+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;
+    });
+}
+exports._addSourceId = _addSourceId;
+/**
+ * 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
+ */
+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;
+}
+exports._applySourceToDeployOptions = _applySourceToDeployOptions;
+//???
+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;
+    });
+}
+exports._replaceParamVariables = _replaceParamVariables;
+//???
+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;
+}
+exports._updateProp = _updateProp;
+//???
+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;
+}
+exports._checkedReplaceAll = _checkedReplaceAll;
+//???
+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", "");
+}
+exports._getPortalBaseUrl = _getPortalBaseUrl;
+//???
+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;
+}
+exports._updateGroupReferences = _updateGroupReferences;
+//???
+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;
+}
+exports._purgeTemplateProperties = _purgeTemplateProperties;
+/**
+ * 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
+ */
+function _getNewItemId(id, templateDictionary) {
+    return common.getProp(templateDictionary, id + ".itemId") ?? id;
+}
+exports._getNewItemId = _getNewItemId;
+//# sourceMappingURL=deploySolutionFromTemplate.js.map

package/dist/cjs/deploySolutionFromTemplate.js.map

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

package/dist/cjs/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>>;