@esri/solutions-components 1.0.0-next.20250521.1 → 1.0.0-next.20250527

package/dist/chunks/cardFetchingUtils.js

@@ -0,0 +1,476 @@
+import * as c from "@esri/solution-common";
+import "@arcgis/core/intl";
+import { B as M } from "./interfaces.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/1.0/esri/copyright.txt for details.
+v1.0.0-next.20250527 */
+/**
+ * @license
+ * Copyright 2025 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.
+ */
+function y(o, e) {
+  const t = [];
+  return o.forEach((s) => {
+    e.has(s.id) && t.push(s);
+  }), t;
+}
+function g(o, e, t) {
+  if (e < 1 || o.length < e)
+    return {
+      cards: [],
+      paging: {
+        start: e,
+        num: 0,
+        nextStart: -1,
+        total: o.length
+      }
+    };
+  const s = Math.min(e + t, o.length + 1), r = s < o.length ? s : -1;
+  return {
+    cards: o.slice(e - 1, s - 1),
+    paging: {
+      start: e,
+      num: s - e,
+      nextStart: r,
+      total: o.length
+    }
+  };
+}
+function B(o, e) {
+  const t = T(o);
+  return V(t, e);
+}
+function V(o, e) {
+  let t = [];
+  return e.forEach(
+    (s) => {
+      const r = b(s);
+      r && o.indexOf(r) >= 0 && s.relatedSolutions && (t = t.concat(s.relatedSolutions));
+    }
+  ), new Set(t);
+}
+function b(o) {
+  const e = "solutionid-", t = o.typeKeywords.filter(
+    (r) => r.startsWith(e)
+  );
+  let s = null;
+  return Array.isArray(t) && t.length > 0 && (s = t[0].substring(e.length)), s;
+}
+function T(o) {
+  let e = [];
+  return o.forEach(
+    (t) => {
+      const s = b(t);
+      s && e.push(s);
+    }
+  ), e = Array.from(new Set(e)), e;
+}
+function P(o, e, t) {
+  let s;
+  const r = t === "asc" ? 1 : -1;
+  switch (e) {
+    case "created":
+      s = (a, i) => r * (a.createdMs < i.createdMs ? -1 : a.createdMs > i.createdMs ? 1 : 0);
+      break;
+    case "numviews":
+      s = (a, i) => r * (a.numViews < i.numViews ? -1 : a.numViews > i.numViews ? 1 : 0);
+      break;
+    case "title":
+      s = (a, i) => r * (a.title.toLowerCase() < i.title.toLowerCase() ? -1 : a.title.toLowerCase() > i.title.toLowerCase() ? 1 : 0);
+      break;
+    default:
+      s = () => 0;
+      break;
+  }
+  return o.sort(s), o;
+}
+/**
+ * @license
+ * Copyright 2025 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.
+ */
+function j(o) {
+  return o ? c.getVelocityUrlBase(o, {}).then((e) => Promise.resolve(!!e)) : Promise.resolve(!1);
+}
+function x(o) {
+  if (o) {
+    const e = o.trim();
+    return e ? "<div>" + e + "</div>" : "";
+  } else
+    return "";
+}
+function E(o) {
+  let e = "", t = "?";
+  return o.forEach((s) => {
+    s.k && s.v && (e += t + s.k + "=" + s.v, t = "&");
+  }), e;
+}
+function L(o, e, t, s) {
+  let r = "";
+  return e ? r = s + "/sharing/rest/content/items/" + o + "/info/" + e + E([{ k: "w", v: "400" }]) : r = t, r;
+}
+function I(o, e = "en") {
+  return new Intl.DateTimeFormat(e, {
+    year: "numeric",
+    month: "long",
+    day: "numeric"
+  }).format(o);
+}
+function D(o, e) {
+  let t = "";
+  return o.some((s) => s.startsWith(e) ? (t = s.substring(e.length), !0) : !1), t;
+}
+/**
+ * @license
+ * Copyright 2025 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.
+ */
+class z {
+  /**
+   * Constructor
+   *
+   * @param orgUrl URL of organization, e.g., "http://myOrg.maps.arcgis.com"
+   * @param portalUrl URL of portal, e.g., "https://www.arcgis.com"
+   * @param userSession Authentication
+   */
+  constructor(e, t, s) {
+    this.cMissingImageDataURI = "https://static.arcgis.com/images/solution.png", this.cardCache = [], this.cardCacheParams = {
+      q: "",
+      categoriesAsStr: "[]",
+      sortField: "title",
+      sortOrder: "asc"
+    }, this.locale = e, this.orgUrl = t, this.portalUrl = s, this.anonAgolSession = new c.UserSession({}), this.agolPortalUrl = "https://www.arcgis.com";
+  }
+  /**
+   * Adds a card to the cache to keep cache fresh between full refreshes.
+   *
+   * @param card Card to add
+   */
+  addToCache(e) {
+    this.cardCache.push(e);
+  }
+  /**
+   * Returns the current cache.
+   *
+   * @returns Cards in the cache
+   */
+  getCache() {
+    return this.cardCache;
+  }
+  /**
+   * Removes a card to the cache to keep cache fresh between full refreshes.
+   *
+   * @param id Id of card to remove
+   */
+  removeFromCache(e) {
+    this.cardCache = this.cardCache.filter((t) => t.id !== e);
+  }
+  /**
+   * Fetches cards for availale Solutions from the server.
+   *
+   * @param query AGO query terms and options
+   * @param primarySolutionsGroupId Id of a group that's the primary source of Solutions for AGO or Enterprise
+   * @param agoBasedEnterpriseSolutionsGroupId Id of an AGO-based set of Enterprise Solutions
+   * @param userSession Authentication for thumbnailUrl
+   * @param pagingParams Parameters for how the request is to be batched
+   * @param acceptableIds A set of item ids that the results must be a part of; if not defined, then there's no restriction
+   * @returns A promise resolving to a collection of available Solutions as cards as well as paging information about
+   * where those cards came from in the fetcher cache; in case of failure, the promise resolves to an error message
+   */
+  requestAvailableSolutionCards(e, t, s, r, a, i) {
+    const d = a?.start ? a.start : 1, h = a?.num ? a.num : 24, u = this.portalUrl + "/sharing/rest", m = this.agolPortalUrl + "/sharing/rest", R = this.anonAgolSession, w = JSON.stringify(e.categories);
+    if (this.cardCacheParams.q !== e.q || this.cardCacheParams.categoriesAsStr !== w || e.sortField === "relevance" ? (this.cardCache = [], this.cardCacheParams = {
+      q: e.q,
+      categoriesAsStr: w,
+      sortField: e.sortField,
+      sortOrder: e.sortOrder
+    }) : (this.cardCacheParams.sortField !== e.sortField || this.cardCacheParams.sortOrder !== e.sortOrder) && (this.cardCacheParams.sortField = e.sortField, this.cardCacheParams.sortOrder = e.sortOrder, this.cardCache = P(
+      this.cardCache,
+      this.cardCacheParams.sortField,
+      this.cardCacheParams.sortOrder
+    )), this.cardCache.length > 0) {
+      let n;
+      if (i && i.size > 0) {
+        const l = y(this.cardCache, i);
+        n = g(l, d, h);
+      } else
+        n = g(this.cardCache, d, h);
+      return Promise.resolve(n);
+    }
+    const U = {
+      filter: e.filter,
+      sortField: e.sortField,
+      sortOrder: e.sortOrder,
+      categories: e?.categories ? this.convertSearchCategories(e.categories) : ""
+    }, C = [];
+    if (t) {
+      const n = r || new c.UserSession({});
+      C.push(
+        c.searchGroupAllContents(
+          t,
+          e.q,
+          n,
+          U,
+          u
+        )
+      );
+    }
+    return s && C.push(
+      c.searchGroupAllContents(
+        s,
+        e.q,
+        R,
+        U,
+        m
+      )
+    ), Promise.allSettled(C).then((n) => {
+      const l = [];
+      n.forEach((f, k) => {
+        const O = !!t && k === 0;
+        if (f.status === "fulfilled") {
+          const F = f.value;
+          let S = "", v = !1;
+          O ? S = this.portalUrl : (S = this.agolPortalUrl, v = !0), F.results.forEach((A) => {
+            A.sourcePortalUrl = S, A.knownToBePublicSource = v;
+          }), l.push(F);
+        } else if (f.status === "rejected")
+          throw new Error(
+            O ? f.reason.message : "enterpriseCannotAccessAGO"
+          );
+      }), l.length === 0 ? this.cardCache = [] : l.length === 1 ? this.cardCache = this.getCardsFromResponse(l[0]) : this.cardCache = P(
+        this.getCardsFromResponse(this.mergeResponses(l)),
+        this.cardCacheParams.sortField,
+        this.cardCacheParams.sortOrder
+      );
+      let p;
+      if (i && i.size > 0) {
+        const f = y(this.cardCache, i);
+        p = g(f, d, h);
+      } else
+        p = g(this.cardCache, d, h);
+      return Promise.resolve(p);
+    }).catch((n) => Promise.reject(new Error(n.message)));
+  }
+  /**
+   * Fetches cards for deployed Solutions from the server.
+   *
+   * @param query AGO query terms and options
+   * @param userSession Authentication for thumbnailUrl
+   * @returns A collection of deployed Solutions as cards; the paging information shows that all of the cards
+   * are returned
+   */
+  requestDeployedSolutionCards(e, t) {
+    const s = this.portalUrl + "/sharing/rest";
+    if (this.cardCacheParams.q !== e.q || e.sortField === "relevance" ? (this.cardCache = [], this.cardCacheParams = {
+      q: e.q,
+      categoriesAsStr: "[]",
+      sortField: e.sortField,
+      sortOrder: e.sortOrder
+    }) : (this.cardCacheParams.sortField !== e.sortField || this.cardCacheParams.sortOrder !== e.sortOrder) && (this.cardCacheParams.sortField = e.sortField, this.cardCacheParams.sortOrder = e.sortOrder, this.cardCache = P(
+      this.cardCache,
+      this.cardCacheParams.sortField,
+      this.cardCacheParams.sortOrder
+    )), this.cardCache.length > 0) {
+      const a = g(this.cardCache, 1, this.cardCache.length);
+      return Promise.resolve(a);
+    }
+    const r = {
+      q: e.q,
+      filter: e.filter,
+      sortField: e.sortField,
+      sortOrder: e.sortOrder,
+      authentication: t,
+      portal: s,
+      categories: e?.categories ? JSON.stringify(e.categories) : ""
+    };
+    return c.searchAllItems(r).then((a) => {
+      this.cardCache = this.getCardsFromResponse(a);
+      const i = g(this.cardCache, 1, this.cardCache.length);
+      return Promise.resolve(i);
+    }).catch((a) => Promise.reject(new Error(a)));
+  }
+  // ---------------------------------------------------------------------------------------------------------------- //
+  /**
+   * Stringifies categories for search.
+   *
+   * @param categories AGO item categories, e.g., "/Categories/Conservation"
+   * or ["/Categories/Conservation", "/Categories/Pipeline"]
+   * @returns Categories where each element is a stringified array of categories
+   */
+  convertSearchCategories(e) {
+    return e && (Array.isArray(e) ? e = e.map(
+      (t) => JSON.stringify(Array.isArray(t) ? t : [t])
+      // force to an array to allow categories with commas
+    ) : e = JSON.stringify([e])), e;
+  }
+  /**
+   * Constructs Solution cards from a Solution-query response.
+   *
+   * @param response Response from a query
+   * @returns Solution information as cards
+   */
+  getCardsFromResponse(e) {
+    return e.results.length > 0 ? c.sanitizeJSON(e.results).map(
+      (r) => {
+        const a = {
+          id: r.id,
+          title: r.title,
+          snippet: r.snippet || "",
+          description: r.description || "",
+          url: r.url || "",
+          itemUrl: this.orgUrl + "/home/item.html" + E([{ k: "id", v: r.id }]) || "",
+          thumbnailFilename: r.thumbnail,
+          thumbnailUrl: L(
+            r.id,
+            r.thumbnail,
+            this.cMissingImageDataURI,
+            r.sourcePortalUrl ? r.sourcePortalUrl : this.portalUrl
+          ),
+          tryitUrl: r.url || "",
+          typeKeywords: r.typeKeywords,
+          learnMoreUrl: r.properties?.learnMoreUrl || "",
+          createdMs: r.created,
+          created: I(r.created, this.locale),
+          modified: I(r.modified, this.locale),
+          numViews: r.numViews,
+          tags: r.tags,
+          categories: r.groupCategories && r.groupCategories.length > 0 ? r.groupCategories : r.categories || [],
+          licenseInfo: x(r.licenseInfo),
+          deployCommonId: D(r.typeKeywords || [], "solutionid-"),
+          deployVersion: D(r.typeKeywords || [], "solutionversion-"),
+          canDelete: r.created > 16183314e5,
+          // Only solutions deployed after April 13, 2021 at 9:30PM can be deleted (9.1 release)
+          canDeploy: (r.typeKeywords || []).indexOf("Display Only") < 0,
+          preview: this.preparePreviewImageUrls(
+            r.id,
+            r.properties?.preview,
+            r.sourcePortalUrl ? r.sourcePortalUrl : this.portalUrl
+          ),
+          sourcePortalUrl: r.sourcePortalUrl || "",
+          knownToBePublicSource: r.knownToBePublicSource || !1,
+          waitId: "",
+          relatedSolutions: c.getProp(r, "properties.relatedSolutions") || [],
+          owner: r.owner
+        };
+        return a.deployCommonId !== "" && a.deployVersion !== "" ? a : null;
+      }
+    ).filter((r) => r != null) : [];
+  }
+  /**
+   * Merge a set of search responses into a single response item.
+   *
+   * @param responseSet Array of search results
+   * @returns A response item that takes its query from the first item in the set and sets the other properties
+   * as if all of the responses are the result of one, large query that's independent of AGO's 100-item limit.
+   */
+  mergeResponses(e) {
+    let t = 0;
+    e.forEach((r) => t += r.total);
+    let s = [];
+    return e.forEach((r) => s = s.concat(r.results)), {
+      query: e[0].query,
+      start: 1,
+      num: t,
+      nextStart: -1,
+      total: t,
+      results: s
+    };
+  }
+  /**
+   * Converts image preview information into a URL pointing to that image; returns non-image previews unchanged.
+   *
+   * @param id Item id to insert into URL
+   * @param preview List of previews to modify
+   * @returns Copy of previews with iamge previews modified
+   */
+  preparePreviewImageUrls(e, t, s) {
+    return t ? t.map(
+      (r) => (r.format === "image" && (r.name = s + "/sharing/rest/content/items/" + e + "/resources/" + r.name), r)
+    ) : [];
+  }
+}
+/**
+ * @license
+ * Copyright 2025 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.
+ */
+async function Q(o, e, t, s, r = M, a = "created", i = "desc", d = !1, h = [], u = []) {
+  if (!o?.SignedIn)
+    return;
+  const m = {
+    q: r,
+    filter: "type:Solution",
+    sortField: a,
+    sortOrder: i,
+    delay: d,
+    categories: h
+  };
+  return m.q += K(o), await J(
+    e,
+    m,
+    s,
+    u
+  );
+}
+function K(o) {
+  let e = "";
+  const t = o.PortalUserOrg, s = o.PortalUserName;
+  return t && (e += " orgid:" + t), s && (e += " owner:" + s), e;
+}
+async function J(o, e, t, s) {
+  const r = await t.requestDeployedSolutionCards(e, o), a = B(r.cards, s);
+  return {
+    cards: r.cards,
+    relatedSolutions: a
+  };
+}
+export {
+  z as C,
+  j as c,
+  Q as g
+};

package/dist/chunks/common.js

@@ -1,7 +1,7 @@
 import "@esri/solution-common";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/1.0/esri/copyright.txt for details.
-v1.0.0-next.20250521.1 */
+v1.0.0-next.20250527 */
 /**
  * @license
  * Copyright 2025 Esri

package/dist/chunks/deployAppContexts.js

@@ -1,7 +1,7 @@
 import { createContext as t } from "@lit/context";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/1.0/esri/copyright.txt for details.
-v1.0.0-next.20250521.1 */
+v1.0.0-next.20250527 */
 /**
  * @license
  * Copyright 2025 Esri

package/dist/chunks/downloadUtils.js

@@ -6,7 +6,7 @@ import { Sanitizer as G } from "@esri/arcgis-html-sanitizer";
 import * as I from "@esri/solution-common";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/1.0/esri/copyright.txt for details.
-v1.0.0-next.20250521.1 */
+v1.0.0-next.20250527 */
 /**
  * @license
  * Copyright 2025 Esri