@esri/solutions-components 0.5.3 → 0.5.4

package/dist/solutions-components/utils/test/solution-store.spec.js

@@ -0,0 +1,439 @@
+/** @license
+ * Copyright 2022 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 testUtils from "./testUtils";
+import solution_734164 from "./solution_734164.json";
+import solution_ca924c from "./solution_ca924c.json";
+import state from "../solution-store";
+import { EUpdateType } from '../interfaces';
+let MOCK_USER_SESSION;
+jest.setTimeout(30000);
+beforeEach(() => {
+    MOCK_USER_SESSION = testUtils.createRuntimeMockUserSession();
+    state._testAccess("_emptyTheStore");
+});
+afterEach(() => {
+    jest.restoreAllMocks();
+});
+let itemEdit;
+describe("solution-store", () => {
+    it("creates store", () => {
+        expect(state.getStoreInfo("solutionItemId")).toEqual("");
+    });
+    it("loads a solution", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => solution_ca924c);
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        expect(state.getStoreInfo("solutionItemId")).toEqual("ca924c6db7d247b9a31fa30532fb5913");
+    });
+    it("loads a solution, and then another one", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => solution_ca924c);
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        expect(state.getStoreInfo("solutionItemId")).toEqual("ca924c6db7d247b9a31fa30532fb5913");
+        // Replace the solution with a different one
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => solution_734164);
+        await state.loadSolution("7341644e455e4a068eba58f1939caac4", MOCK_USER_SESSION);
+        expect(state.getStoreInfo("solutionItemId")).toEqual("7341644e455e4a068eba58f1939caac4");
+        expect(state.getStoreInfo("solutionData").templates.length).toEqual(12);
+    });
+    describe("replaceItemThumbnail", () => {
+        beforeEach(() => {
+            itemEdit = testUtils.getSampleItemEdit();
+        });
+        it("queues a thumbnail for replacement", () => {
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb1");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Check that the previous thumbnail is marked for removal and the new one is queued for adding
+            expect(itemEdit.resourceFilePaths.length).toEqual(3);
+            expect(itemEdit.resourceFilePaths[0].filename).toEqual("qc.project.json");
+            expect(itemEdit.resourceFilePaths[0].updateType).toEqual(3);
+            expect(itemEdit.resourceFilePaths[1].filename).toEqual("esri_133.png");
+            expect(itemEdit.resourceFilePaths[1].updateType).toEqual(2);
+            expect(itemEdit.resourceFilePaths[2].filename).toEqual("thumb1");
+            expect(itemEdit.resourceFilePaths[2].updateType).toEqual(0);
+        });
+        it("twice queues thumbnails for replacement", () => {
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb1");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb2");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Check that the previous thumbnail is marked for removal and the new one is queued for adding
+            expect(itemEdit.resourceFilePaths.length).toEqual(3);
+            expect(itemEdit.resourceFilePaths[0].filename).toEqual("qc.project.json");
+            expect(itemEdit.resourceFilePaths[0].updateType).toEqual(3);
+            expect(itemEdit.resourceFilePaths[1].filename).toEqual("esri_133.png");
+            expect(itemEdit.resourceFilePaths[1].updateType).toEqual(2);
+            expect(itemEdit.resourceFilePaths[2].filename).toEqual("thumb2");
+            expect(itemEdit.resourceFilePaths[2].updateType).toEqual(0);
+        });
+        it("thrice queues thumbnails for replacement", () => {
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb1");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb2");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Set a new thumbnail
+            itemEdit.thumbnail = testUtils.getSampleImageAsFile("thumb3");
+            // Register it in the store
+            state.replaceItemThumbnail(itemEdit);
+            // Check that the previous thumbnail is marked for removal and the new one is queued for adding
+            expect(itemEdit.resourceFilePaths.length).toEqual(3);
+            expect(itemEdit.resourceFilePaths[0].filename).toEqual("qc.project.json");
+            expect(itemEdit.resourceFilePaths[0].updateType).toEqual(3);
+            expect(itemEdit.resourceFilePaths[1].filename).toEqual("esri_133.png");
+            expect(itemEdit.resourceFilePaths[1].updateType).toEqual(2);
+            expect(itemEdit.resourceFilePaths[2].filename).toEqual("thumb3");
+            expect(itemEdit.resourceFilePaths[2].updateType).toEqual(0);
+        });
+    });
+    it("fails to find an item when fetching its value", async () => {
+        const item = state.getItemInfo("79036430a6274e17ae915d0278b8569c");
+        expect(item).toBeUndefined();
+    });
+    it("changes an item's value", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        expect(state.getStoreInfo("solutionData").templates.length).toEqual(25);
+        const item = state.getItemInfo("9c1311d827f44fdc9680651420a63484");
+        expect(item.item.description).toEqual("An ArcGIS Survey123 form used by operations managers and yard supervisors to report materials used by each vehicle during winter weather operations.");
+        // Change the item's description
+        item.item.description = "Nullam ac urna mattis, maximus urna sit amet.";
+        state.setItemInfo(item);
+        const updatedItem = state.getItemInfo("9c1311d827f44fdc9680651420a63484");
+        expect(updatedItem.item.description).toEqual("Nullam ac urna mattis, maximus urna sit amet.");
+    });
+    it("changes a store value", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        const origDefaultWkid = state.getStoreInfo("defaultWkid");
+        expect(origDefaultWkid).toBeUndefined();
+        state.setStoreInfo("defaultWkid", "2865");
+        const modifiedDefaultWkid = state.getStoreInfo("defaultWkid");
+        expect(modifiedDefaultWkid).toEqual("2865");
+    });
+    describe("saveSolution", () => {
+        it("saves a solution with a custom spatial reference", async () => {
+            jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => {
+                return Object.assign(Object.assign({}, JSON.parse(JSON.stringify(solution_ca924c))), { "params": {
+                        "wkid": {
+                            "label": "Spatial Reference",
+                            "default": 102100,
+                            "valueType": "spatialReference",
+                            "attributes": {
+                                "required": "true"
+                            }
+                        }
+                    } });
+            });
+            const updateSpy = jest.spyOn(common, "updateItem").mockImplementation((itemInfo, _authentication, _folderId) => {
+                expect(itemInfo.id).toEqual("ca924c6db7d247b9a31fa30532fb5913");
+                return Promise.resolve(null);
+            });
+            await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+            await state.saveSolution();
+            expect(updateSpy).toHaveBeenCalled();
+        });
+        it("saves a solution without a custom spatial reference", async () => {
+            jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+            const updateSpy = jest.spyOn(common, "updateItem").mockImplementation((itemInfo, _authentication, _folderId) => {
+                expect(itemInfo.id).toEqual("ca924c6db7d247b9a31fa30532fb5913");
+                return Promise.resolve(null);
+            });
+            await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+            await state.saveSolution();
+            expect(updateSpy).toHaveBeenCalled();
+        });
+    });
+    it("directly empties the store", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        expect(state.getStoreInfo("solutionItemId")).toEqual("ca924c6db7d247b9a31fa30532fb5913");
+        state._testAccess("_emptyTheStore");
+        expect(state.getStoreInfo("solutionItemId")).toEqual("");
+    });
+    it("gets feature services", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        const result = state._testAccess("_getFeatureServices", state.getStoreInfo("solutionData").templates);
+        expect(result.length).toEqual(5);
+        expect(result[0].name).toEqual("Driver_Activity"); // name fetched from `name` prop because `title` empty
+        expect(result[0].enabled).toBeFalsy();
+        expect(result[1].name).toEqual("OperationsManagement"); // name fetched from higher-priority `title` prop
+    });
+    it("gets items shared with a group", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        const result = state._testAccess("_getItemsSharedWithThisGroup", state.getStoreInfo("solutionData").templates[0], state.getStoreInfo("solutionData").templates);
+        expect(result.length).toEqual(23);
+        expect(result[0]).toEqual({
+            "id": "9c1311d827f44fdc9680651420a63484",
+            "title": "Material_Use_Reporting.zip",
+            "isShared": false,
+            "shareItem": false,
+            "type": "Form",
+            "typeKeywords": [
+                "Form",
+                "Survey123",
+                "Survey123 Connect",
+                "xForm"
+            ]
+        });
+    });
+    it("gets resource file paths", async () => {
+        jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+        await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+        const result = state._testAccess("_getResourceFilePaths", "ca924c6db7d247b9a31fa30532fb5913", state.getStoreInfo("solutionData").templates[0], MOCK_USER_SESSION.portal);
+        expect(result.length).toEqual(2);
+        expect(result[0]).toEqual({
+            "url": "https://myorg.maps.arcgis.com/sharing/rest/content/items/ca924c6db7d247b9a31fa30532fb5913/resources/79036430a6274e17ae915d0278b8569c_info_metadata/metadata.xml",
+            "type": 2,
+            "folder": "",
+            "filename": "metadata.xml",
+            "updateType": 3
+        });
+    });
+    it("gets resource storage name", async () => {
+        const resourcePaths = [
+            { type: common.EFileType.Data, filename: "def.txt" },
+            { type: common.EFileType.Data, filename: "def.doc" },
+            { type: common.EFileType.Info, filename: "def" },
+            { type: common.EFileType.Metadata, filename: "def" },
+            { type: common.EFileType.Resource, filename: "def" },
+            { type: common.EFileType.Thumbnail, filename: "def" }
+        ];
+        const storageNames = resourcePaths.map((path) => state._testAccess("_getResourceStorageName", "abc", path));
+        expect(storageNames).toEqual([
+            "abc_info_data/def.txt",
+            "abc_info_dataz/def.doc.zip",
+            "abc_info/def",
+            "abc_info_metadata/def",
+            "abc/def",
+            "abc_info_thumbnail/def"
+        ]);
+    });
+    describe("_getSpatialReferenceInfo", () => {
+        it("gets spatial reference info using a string wkid", async () => {
+            jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+            await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+            const featureServices = state._testAccess("_getFeatureServices", state.getStoreInfo("solutionData").templates);
+            const result = await state._testAccess("_getSpatialReferenceInfo", featureServices, "2865");
+            expect(result).toEqual({
+                "enabled": true,
+                "services": {
+                    "Driver_Activity": false,
+                    "OperationsManagement": false,
+                    "SnowRoutes": false,
+                    "ServiceAreas": true,
+                    "Requests": true
+                },
+                "spatialReference": "2865"
+            });
+        });
+        it("gets spatial reference info using a numeric wkid", async () => {
+            jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+            await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+            const featureServices = state._testAccess("_getFeatureServices", state.getStoreInfo("solutionData").templates);
+            const result = await state._testAccess("_getSpatialReferenceInfo", featureServices, 2865);
+            expect(result).toEqual({
+                "enabled": true,
+                "services": {
+                    "Driver_Activity": false,
+                    "OperationsManagement": false,
+                    "SnowRoutes": false,
+                    "ServiceAreas": true,
+                    "Requests": true
+                },
+                "spatialReference": 2865
+            });
+        });
+        it("gets spatial reference info using no wkid", async () => {
+            jest.spyOn(common, "getItemDataAsJson").mockImplementation(() => JSON.parse(JSON.stringify(solution_ca924c)));
+            await state.loadSolution("ca924c6db7d247b9a31fa30532fb5913", MOCK_USER_SESSION);
+            const featureServices = state._testAccess("_getFeatureServices", state.getStoreInfo("solutionData").templates);
+            const result = await state._testAccess("_getSpatialReferenceInfo", featureServices);
+            expect(result).toEqual({
+                "enabled": false,
+                "services": {
+                    "Driver_Activity": false,
+                    "OperationsManagement": false,
+                    "SnowRoutes": false,
+                    "ServiceAreas": true,
+                    "Requests": true
+                },
+                "spatialReference": undefined
+            });
+        });
+    });
+    it("prepares a solution for editing", async () => {
+        // Get the templates; parse+stringify seems only working way to avoid modifying data file
+        const solutionData = JSON.parse(JSON.stringify(solution_ca924c));
+        // Provide thumbnail images for the templates
+        const sampleImageFile = testUtils.getSampleImageAsFile();
+        jest.spyOn(common, "getThumbnailFromStorageItem").mockResolvedValue(sampleImageFile);
+        await state._testAccess("_prepareSolutionItemsForEditing", "ca924c6db7d247b9a31fa30532fb5913", solutionData.templates, MOCK_USER_SESSION);
+        // Check that the augmentation has been added to each template
+        expect(solutionData.templates.filter(t => t.hasOwnProperty("resourceFilePaths")).length).toEqual(solutionData.templates.length);
+        expect(solutionData.templates.filter(t => t.hasOwnProperty("thumbnail")).length).toEqual(solutionData.templates.length);
+        expect(solutionData.templates.filter(t => t.hasOwnProperty("groupDetails")).length).toEqual(solutionData.templates.length);
+    });
+    describe("_prepareSolutionItemsForStorage", () => {
+        const originalConsoleLog = console.log;
+        beforeEach(() => {
+            console.log = jest.fn();
+        });
+        afterEach(() => {
+            console.log = originalConsoleLog;
+        });
+        it("prepares a solution for storage", async () => {
+            // Get the templates; parse+stringify seems only working way to avoid modifying data file
+            const solutionData = JSON.parse(JSON.stringify(solution_ca924c));
+            // Provide thumbnail images for the templates and prepare the templates for editing
+            const sampleImageFile = testUtils.getSampleImageAsFile();
+            jest.spyOn(common, "getThumbnailFromStorageItem").mockResolvedValue(sampleImageFile);
+            await state._testAccess("_prepareSolutionItemsForEditing", "ca924c6db7d247b9a31fa30532fb5913", solutionData.templates, MOCK_USER_SESSION);
+            // Provide some resource mods
+            const template = solutionData.templates[0];
+            template.resourceFilePaths.push({
+                blob: sampleImageFile,
+                filename: sampleImageFile.name,
+                type: common.EFileType.Resource,
+                updateType: EUpdateType.Add
+            });
+            template.resourceFilePaths.push({
+                blob: sampleImageFile,
+                filename: template.resourceFilePaths[1].filename,
+                type: common.EFileType.Thumbnail,
+                updateType: EUpdateType.Update
+            });
+            template.resourceFilePaths.push({
+                filename: template.resourceFilePaths[0].filename,
+                type: common.EFileType.Metadata,
+                updateType: EUpdateType.Remove
+            });
+            // Run the prep
+            jest.spyOn(common, "copyFilesToStorageItem").mockResolvedValue([template.itemId + "_info_dataz/" + sampleImageFile.name]);
+            jest.spyOn(common, "removeItemResourceFile").mockResolvedValue({ success: true });
+            jest.spyOn(common, "updateItemResourceFile").mockResolvedValue({ success: true, itemId: "abc", owner: "def", folder: "ghi" });
+            expect(template.resourceFilePaths.length).toEqual(5);
+            await state._testAccess("_prepareSolutionItemsForStorage", "ca924c6db7d247b9a31fa30532fb5913", solutionData.templates, MOCK_USER_SESSION);
+            expect(template.resources).toEqual([
+                "79036430a6274e17ae915d0278b8569c_info_thumbnail/thumbnail.JPEG",
+                "79036430a6274e17ae915d0278b8569c/" + sampleImageFile.name
+            ]);
+            // Check that the augmentation has been removed from each template
+            expect(solutionData.templates.some(t => t.hasOwnProperty("resourceFilePaths"))).toBeFalsy();
+            expect(solutionData.templates.some(t => t.hasOwnProperty("thumbnail"))).toBeFalsy();
+            expect(solutionData.templates.some(t => t.hasOwnProperty("groupDetails"))).toBeFalsy();
+        });
+        it("catches errors updating or removing resources while preparing a solution for storage", async () => {
+            jest.spyOn(console, "log").mockImplementation(() => { });
+            // Get the templates; parse+stringify seems only working way to avoid modifying data file
+            const solutionData = JSON.parse(JSON.stringify(solution_ca924c));
+            // Provide thumbnail images for the templates and prepare the templates for editing
+            const sampleImageFile = testUtils.getSampleImageAsFile();
+            jest.spyOn(common, "getThumbnailFromStorageItem").mockResolvedValue(sampleImageFile);
+            await state._testAccess("_prepareSolutionItemsForEditing", "ca924c6db7d247b9a31fa30532fb5913", solutionData.templates, MOCK_USER_SESSION);
+            // Provide some resource mods
+            const template = solutionData.templates[0];
+            template.resourceFilePaths.push({
+                blob: sampleImageFile,
+                filename: template.resourceFilePaths[1].filename,
+                type: common.EFileType.Thumbnail,
+                updateType: EUpdateType.Update
+            });
+            template.resourceFilePaths.push({
+                filename: template.resourceFilePaths[0].filename,
+                type: common.EFileType.Metadata,
+                updateType: EUpdateType.Remove
+            });
+            // Run the prep
+            jest.spyOn(console, "log").mockImplementation(() => { }); // hide error messages from _prepareSolutionItemsForStorage
+            jest.spyOn(common, "removeItemResourceFile").mockImplementation(() => { throw new Error("Item does not exist or is inaccessible."); });
+            jest.spyOn(common, "updateItemResourceFile").mockImplementation(() => { throw new Error("Item does not exist or is inaccessible."); });
+            expect(template.resourceFilePaths.length).toEqual(4);
+            await state._testAccess("_prepareSolutionItemsForStorage", "ca924c6db7d247b9a31fa30532fb5913", solutionData.templates, MOCK_USER_SESSION);
+            expect(template.resources).toEqual([
+                "79036430a6274e17ae915d0278b8569c_info_metadata/metadata.xml",
+                "79036430a6274e17ae915d0278b8569c_info_thumbnail/thumbnail.JPEG"
+            ]);
+            // Check that the augmentation has been removed from each template
+            expect(solutionData.templates.some(t => t.hasOwnProperty("resourceFilePaths"))).toBeFalsy();
+            expect(solutionData.templates.some(t => t.hasOwnProperty("thumbnail"))).toBeFalsy();
+            expect(solutionData.templates.some(t => t.hasOwnProperty("groupDetails"))).toBeFalsy();
+        });
+    });
+    describe("_setSpatialReferenceInfo", () => {
+        it("handles an enabled custom spatial reference", () => {
+            jest.spyOn(common, "setCreateProp").mockImplementation(() => { });
+            const spatialReferenceInfo = {
+                enabled: true,
+                services: {
+                    "Driver_Activity": false,
+                    "OperationsManagement": true,
+                    "Requests": false,
+                    "ServiceAreas": true,
+                    "SnowRoutes": false // has "wkid": 4326
+                },
+                spatialReference: 2865
+            };
+            const solutionTemplates = JSON.parse(JSON.stringify(solution_ca924c)).templates;
+            const updatedWkid = state._testAccess("_setSpatialReferenceInfo", spatialReferenceInfo, solutionTemplates);
+            expect(updatedWkid).toEqual(2865);
+        });
+        it("handles a disabled custom spatial reference", () => {
+            jest.spyOn(common, "setCreateProp").mockImplementation(() => { });
+            const spatialReferenceInfo = {
+                enabled: false,
+                services: {
+                    "Driver_Activity": false,
+                    "OperationsManagement": true,
+                    "Requests": false,
+                    "ServiceAreas": true,
+                    "SnowRoutes": false // has "wkid": 4326
+                },
+                spatialReference: 2865
+            };
+            const solutionTemplates = JSON.parse(JSON.stringify(solution_ca924c)).templates;
+            const updatedWkid = state._testAccess("_setSpatialReferenceInfo", spatialReferenceInfo, solutionTemplates);
+            expect(updatedWkid).toBeUndefined();
+        });
+    });
+    describe("_splitFilename", () => {
+        it("handles filename without prefix", () => {
+            const { prefix, suffix } = state._testAccess("_splitFilename", "sample.txt");
+            expect(prefix).toBeUndefined();
+            expect(suffix).toEqual("sample.txt");
+        });
+        it("handles filename with single prefix", () => {
+            const { prefix, suffix } = state._testAccess("_splitFilename", "folder/sample.txt");
+            expect(prefix).toEqual("folder");
+            expect(suffix).toEqual("sample.txt");
+        });
+        it("handles filename with multiple prefixes", () => {
+            const { prefix, suffix } = state._testAccess("_splitFilename", "folder/subfolder/sample.txt");
+            expect(prefix).toEqual("folder/subfolder");
+            expect(suffix).toEqual("sample.txt");
+        });
+    });
+});

package/dist/solutions-components/utils/test/testUtils.js

@@ -0,0 +1,135 @@
+/** @license
+ * Copyright 2022 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 const PORTAL_URL = "https://myorg.maps.arcgis.com";
+/**
+ * Creates a mock UserSession.
+ *
+ * @param now Time for token; defaults to Date.now
+ * @param portalUrl Portal for token; defaults to "https://myorg.maps.arcgis.com"
+ *
+ * @returns Mock UserSession
+ */
+export function createRuntimeMockUserSession(now, portalUrl) {
+    if (now === undefined) {
+        now = Date.now();
+    }
+    const tomorrow = new Date(now + 86400000);
+    return new common.UserSession({
+        clientId: "clientId",
+        redirectUri: "https://example-app.com/redirect-uri",
+        token: "fake-token",
+        tokenExpires: tomorrow,
+        refreshToken: "refreshToken",
+        refreshTokenExpires: tomorrow,
+        refreshTokenTTL: 1440,
+        username: "casey",
+        password: "123456",
+        portal: (portalUrl || PORTAL_URL) + "/sharing/rest"
+    });
+}
+/**
+ * Creates a mock image file.
+ *
+ * @param filename Name to give file; defaults to "sampleImage"
+ *
+ * @returns Buffer usable as a File
+ */
+export function getSampleImageAsFile(filename = "sampleImage.png") {
+    const pseudoFile = Buffer.from(_imageAsDataUri(), 'base64');
+    pseudoFile.name = filename;
+    return pseudoFile;
+}
+export function getSampleItemEdit(itemId = "bd4a2dafd7584253a1bc772f2dd510c4") {
+    let itemEdit = {
+        "itemId": "bd4a2dafd7584253a1bc772f2dd510c4",
+        "type": "QuickCapture Project",
+        "key": "i7t8659n",
+        "resources": [
+            "bd4a2dafd7584253a1bc772f2dd510c4/qc.project.json",
+            "bd4a2dafd7584253a1bc772f2dd510c4_info_thumbnail/esri_133.png"
+        ],
+        "dependencies": ["79036430a6274e17ae915d0278b8569c"],
+        "groups": ["90766e8ee450438fb507d7d2cd03df20"],
+        "estimatedDeploymentCostFactor": 2,
+        "relatedItems": [],
+        "data": {},
+        "item": {
+            "id": "{{bd4a2dafd7584253a1bc772f2dd510c4.itemId}}",
+            "type": "QuickCapture Project",
+            "accessInformation": "Esri",
+            "categories": [],
+            "culture": "en-us",
+            "description": "An ArcGIS QuickCapture project description",
+            "extent": [],
+            "licenseInfo": "Copyright 2022 Esri",
+            "name": null,
+            "properties": null,
+            "snippet": "An ArcGIS QuickCapture project snippet",
+            "tags": [],
+            "thumbnail": null,
+            "title": "Status Reporter",
+            "typeKeywords": [
+                "QuickCapture",
+                "QuickCapture Project"
+            ],
+            "url": null,
+            "created": 1645216385000,
+            "modified": 1645219985000
+        },
+        "properties": {},
+        "resourceFilePaths": [{
+                "url": "https://www.arcgis.com/sharing/rest/content/items/ca924c6db7d247b9a31fa30532fb5913/resources/bd4a2dafd7584253a1bc772f2dd510c4/qc.project.json",
+                "type": 3,
+                "folder": "",
+                "filename": "qc.project.json",
+                "updateType": 3
+            }, {
+                "url": "https://www.arcgis.com/sharing/rest/content/items/ca924c6db7d247b9a31fa30532fb5913/resources/bd4a2dafd7584253a1bc772f2dd510c4_info_thumbnail/esri_133.png",
+                "type": 4,
+                "folder": "",
+                "filename": "esri_133.png",
+                "updateType": 3
+            }],
+        "thumbnail": null
+    };
+    if (itemId !== "bd4a2dafd7584253a1bc772f2dd510c4") {
+        itemEdit = JSON.parse(JSON.stringify(itemEdit).replace(/bd4a2dafd7584253a1bc772f2dd510c4/g, itemId));
+    }
+    return itemEdit;
+}
+//--------------------------------------------------------------------------------------------------------------------//
+function _imageAsDataUri() {
+    return "\
+iVBORw0KGgoAAAANSUhEUgAAABEAAAARCAYAAAA7bUf6AAADKklEQVQ4T6XUf1DMeRzH8edu\
+53ZVZ6vLxmo2Q0Y7rtJZJT8abQmdysjETVEWMxgGOzF2/IhkCqNT8qPyo8PE6fzIj/y4qYlU\
+E6MfIottFcLmRyIq1Ne4neGa+ufG57/354/H+/3H6/0WCYIg8J1P1BNSkJ/PpXO5tLa187q5\
+mTFqL6ZFzMRxgEuP7boh00JCcbB3IGZfFuM8f8PbfSD1IyIR3byI8uFVJoxRk5C4uQvWBfHx\
+VHO44jKqcC0/BKgQ7tbzIS0LhvhDX3d400DkSAUFZ3MwPXyAVCr9F/uKhAaHkpqbQkhGEAa9\
+EZeRcmpVOlCFQVwMbvqpLPA/QoruHnYSV+4V1tHS/vYbcqv6Fv4af6zVtsismnB0FmM9qQZB\
+ZsuNljdMtttN+fIEtMcm0NgqJmtZGevnJmGqqCNxc6JlktjYWNKT9zIxU463jxKjIYmm65ex\
+cfWi7Nga+nSWUV4k4DxchlQuobbCzJYjyRxYkEVVTZUFCZsShlTexnXvEXgN30RHzjZyk1cQ\
+vjIV57FP6a/4B5NBoOxsI+rFbhhN7yjfaGC0Us3pvDMWJDI8gvczPTgVfwOeVhC8NJ7G0nME\
+xf1JbWsREg5gZ99E9qxiNJl+PGn7xP3974myH8WGTXEWZFKAhqZ+7lzLTsX6xB1G/dSbj49f\
+U5O9lbeD1Xy4dAGxqB7pCwMSNwc6nKywFfkSoXDmj107LUjE1BCkwToO7dEzPuoFbn5OFCWZ\
+uX28FqavA1UgWDkhM6+gQ2agRTkam5SXaAa1czrvogUpLb5Kys59/BXox4+rtIhteuM51xUH\
+p07Op6nhdz20ixHJVyMUXIEwHZq8Z8wJ+oWoGO23nPj+6kGgLo0E7Xysx5pxiffl1RMfzGsr\
+Yag7PKgGaQnUP2f8koU4ltSRcz6va9i+VErHPizKNaDfmApt2yFwPuwogcZyWFsFvQpZKDFy\
+91Qlh/4+ikKh6I58+fH2GIZXgIbS6mKq8+8jOfiIwXWFPDu5C130DNYtm8ejhoavQJfY/3ej\
+blZWkpGegclk5FPzc2ztfqa1o5OoWdFEzo7utsk9noL/e14+AxP0YqryqgPxAAAAAElFTkSu\
+QmCC";
+}

package/dist/solutions-components/utils/types.js

@@ -0,0 +1,14 @@
+/*
+ *   Copyright (c) 2022 Esri
+ *   All rights reserved.
+ *   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.
+ */
+export {};

package/dist/solutions-components_commit.txt

@@ -0,0 +1,7 @@
+Built 05/09/2023 13:06:02.97 
+HEAD
+commit 4408542c7be6277df4563d0a40f84246e37656db
+Author: John Hauck <jhauck@esri.com>
+Date:   Fri May 5 17:28:29 2023 -0600
+
+    update version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esri/solutions-components",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Web Components for Esri's Solutions Applications",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@esri/eslint-plugin-calcite-components": "^0.2.2",
-    "@esri/solution-common": "1.5.3",
+    "@esri/solution-common": "3.0.1",
     "@stencil/postcss": "^2.1.0",
     "@stencil/sass": "^2.0.0",
     "@stencil/store": "^2.0.1",
@@ -66,6 +66,10 @@
     "typescript": "^4.8.4"
   },
   "dependencies": {
+    "@esri/hub-common": "^12.37.1",
+    "@esri/hub-initiatives": "^12.4.1",
+    "@esri/hub-sites": "^12.6.0",
+    "@esri/hub-teams": "^12.4.1",
     "@pdf-lib/fontkit": "^1.1.1",
     "@stencil/core": "^2.20.0",
     "focus-trap": "7.2.0",
@@ -79,11 +83,7 @@
     "@esri/arcgis-rest-portal": "^3.4.2",
     "@esri/arcgis-rest-request": "^3.4.2",
     "@esri/arcgis-rest-service-admin": "^3.4.2",
-    "@esri/calcite-components": "^1.0.7",
-    "@esri/hub-common": "9.29.0",
-    "@esri/hub-initiatives": "9.29.0",
-    "@esri/hub-sites": "9.29.0",
-    "@esri/hub-teams": "9.29.0"
+    "@esri/calcite-components": "^1.0.7"
   },
   "repository": {
     "type": "git",