@esri/hub-common 14.26.1 → 14.27.0

package/dist/esm/templates/_internal/TemplateBusinessRules.js

@@ -0,0 +1,82 @@
+/**
+ * Default features for a Template. These are the features
+ * that can be enabled / disabled by the entity owner
+ */
+export const TemplateDefaultFeatures = {};
+/**
+ * @private
+ * Template permissions: these define the requirements
+ * any user must meet to perform related actions
+ */
+export const TemplatePermissions = [
+    "hub:template",
+    "hub:template:create",
+    "hub:template:delete",
+    "hub:template:edit",
+    "hub:template:manage",
+    "hub:template:view",
+    "hub:template:workspace:overview",
+    "hub:template:workspace:details",
+    "hub:template:workspace:dashboard",
+    "hub:template:workspace:collaborators",
+    "hub:template:workspace:settings",
+];
+/**
+ * @private
+ * Template permission policies
+ */
+export const TemplatePermissionPolicies = [
+    {
+        permission: "hub:template",
+        availability: ["alpha"],
+        services: ["portal"],
+    },
+    {
+        permission: "hub:template:create",
+        dependencies: ["hub:template"],
+        authenticated: true,
+        privileges: ["portal:user:createItem"],
+    },
+    {
+        permission: "hub:template:delete",
+        dependencies: ["hub:template"],
+        authenticated: true,
+        entityOwner: true,
+    },
+    {
+        permission: "hub:template:view",
+        dependencies: ["hub:template"],
+    },
+    {
+        permission: "hub:template:edit",
+        dependencies: ["hub:template"],
+        authenticated: true,
+        entityEdit: true,
+    },
+    {
+        permission: "hub:template:manage",
+        dependencies: ["hub:template:edit"],
+    },
+    {
+        permission: "hub:template:workspace:overview",
+        dependencies: ["hub:template:view"],
+    },
+    {
+        permission: "hub:template:workspace:details",
+        dependencies: ["hub:template:manage"],
+    },
+    {
+        permission: "hub:template:workspace:dashboard",
+        dependencies: ["hub:template:manage"],
+    },
+    {
+        permission: "hub:template:workspace:collaborators",
+        dependencies: ["hub:template:manage"],
+    },
+    {
+        permission: "hub:template:workspace:settings",
+        dependencies: ["hub:template:manage"],
+        entityOwner: true,
+    },
+];
+//# sourceMappingURL=TemplateBusinessRules.js.map

package/dist/esm/templates/_internal/TemplateBusinessRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateBusinessRules.js","sourceRoot":"","sources":["../../../../src/templates/_internal/TemplateBusinessRules.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkB,EAAE,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,cAAc;IACd,qBAAqB;IACrB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,iCAAiC;IACjC,gCAAgC;IAChC,kCAAkC;IAClC,sCAAsC;IACtC,iCAAiC;CACzB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAwB;IAC7D;QACE,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,CAAC,OAAO,CAAC;QACvB,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD;QACE,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,CAAC,wBAAwB,CAAC;KACvC;IACD;QACE,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;KAClB;IACD;QACE,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,CAAC,cAAc,CAAC;KAC/B;IACD;QACE,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;KACjB;IACD;QACE,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,CAAC,mBAAmB,CAAC;KACpC;IACD;QACE,UAAU,EAAE,iCAAiC;QAC7C,YAAY,EAAE,CAAC,mBAAmB,CAAC;KACpC;IACD;QACE,UAAU,EAAE,gCAAgC;QAC5C,YAAY,EAAE,CAAC,qBAAqB,CAAC;KACtC;IACD;QACE,UAAU,EAAE,kCAAkC;QAC9C,YAAY,EAAE,CAAC,qBAAqB,CAAC;KACtC;IACD;QACE,UAAU,EAAE,sCAAsC;QAClD,YAAY,EAAE,CAAC,qBAAqB,CAAC;KACtC;IACD;QACE,UAAU,EAAE,iCAAiC;QAC7C,YAAY,EAAE,CAAC,qBAAqB,CAAC;QACrC,WAAW,EAAE,IAAI;KAClB;CACF,CAAC"}

package/dist/esm/templates/_internal/TemplateSchema.js

@@ -0,0 +1,8 @@
+import { HubItemEntitySchema } from "../../core/schemas/shared/HubItemEntitySchema";
+export const TemplateEditorTypes = ["hub:template:edit"];
+export const TemplateSchema = Object.assign(Object.assign({}, HubItemEntitySchema), { properties: Object.assign(Object.assign({}, HubItemEntitySchema.properties), { previewUrl: {
+            type: "string",
+            if: { minLength: 1 },
+            then: { format: "uri" },
+        } }) });
+//# sourceMappingURL=TemplateSchema.js.map

package/dist/esm/templates/_internal/TemplateSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateSchema.js","sourceRoot":"","sources":["../../../../src/templates/_internal/TemplateSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAIpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,mBAAmB,CAAU,CAAC;AAElE,MAAM,CAAC,MAAM,cAAc,GAAyB,gCAC/C,mBAAmB,KACtB,UAAU,kCACL,mBAAmB,CAAC,UAAU,KACjC,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;YACpB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;SACxB,MAEoB,CAAC"}

package/dist/esm/templates/_internal/TemplateUiSchemaEdit.js

@@ -0,0 +1,97 @@
+import { UiSchemaMessageTypes } from "../../core/schemas/types";
+/**
+ * @private
+ * constructs the complete edit uiSchema for Hub Templates.
+ * This defines how the schema properties should be rendered
+ * in the template editing experience.
+ *
+ * @param i18nScope
+ * @param entity
+ * @param context
+ * @returns
+ */
+export const buildUiSchema = async (i18nScope, entity, context) => {
+    return {
+        type: "Layout",
+        elements: [
+            {
+                type: "Section",
+                labelKey: `${i18nScope}.sections.basicInfo.label`,
+                elements: [
+                    {
+                        type: "Control",
+                        scope: "/properties/name",
+                        labelKey: `${i18nScope}.fields.name.label`,
+                        options: {
+                            messages: [
+                                {
+                                    type: UiSchemaMessageTypes.error,
+                                    keyword: "required",
+                                    icon: true,
+                                    labelKey: `${i18nScope}.fields.name.requiredError`,
+                                },
+                            ],
+                        },
+                    },
+                    {
+                        type: "Control",
+                        scope: "/properties/previewUrl",
+                        labelKey: `${i18nScope}.fields.previewUrl.label`,
+                        options: {
+                            helperText: {
+                                labelKey: `${i18nScope}.fields.previewUrl.helperText`,
+                            },
+                            messages: [
+                                {
+                                    type: "ERROR",
+                                    keyword: "if",
+                                    hidden: true,
+                                },
+                            ],
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields.summary.label`,
+                        scope: "/properties/summary",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-input",
+                            type: "textarea",
+                            helperText: {
+                                labelKey: `${i18nScope}.fields.summary.helperText`,
+                            },
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields.description.label`,
+                        scope: "/properties/description",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-input",
+                            type: "textarea",
+                            helperText: {
+                                labelKey: `${i18nScope}.fields.description.helperText`,
+                            },
+                        },
+                    },
+                    {
+                        labelKey: `${i18nScope}.fields.thumbnail.label`,
+                        scope: "/properties/_thumbnail",
+                        type: "Control",
+                        options: {
+                            control: "hub-field-input-image-picker",
+                            imgSrc: entity.thumbnailUrl,
+                            maxWidth: 727,
+                            maxHeight: 484,
+                            aspectRatio: 1.5,
+                            helperText: {
+                                labelKey: `${i18nScope}.fields.thumbnail.helperText`,
+                            },
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+};
+//# sourceMappingURL=TemplateUiSchemaEdit.js.map

package/dist/esm/templates/_internal/TemplateUiSchemaEdit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateUiSchemaEdit.js","sourceRoot":"","sources":["../../../../src/templates/_internal/TemplateUiSchemaEdit.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG3E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,SAAiB,EACjB,MAAoB,EACpB,OAAuB,EACH,EAAE;IACtB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,GAAG,SAAS,2BAA2B;gBACjD,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,kBAAkB;wBACzB,QAAQ,EAAE,GAAG,SAAS,oBAAoB;wBAC1C,OAAO,EAAE;4BACP,QAAQ,EAAE;gCACR;oCACE,IAAI,EAAE,oBAAoB,CAAC,KAAK;oCAChC,OAAO,EAAE,UAAU;oCACnB,IAAI,EAAE,IAAI;oCACV,QAAQ,EAAE,GAAG,SAAS,4BAA4B;iCACnD;6BACF;yBACF;qBACF;oBACD;wBACE,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,wBAAwB;wBAC/B,QAAQ,EAAE,GAAG,SAAS,0BAA0B;wBAChD,OAAO,EAAE;4BACP,UAAU,EAAE;gCACV,QAAQ,EAAE,GAAG,SAAS,+BAA+B;6BACtD;4BACD,QAAQ,EAAE;gCACR;oCACE,IAAI,EAAE,OAAO;oCACb,OAAO,EAAE,IAAI;oCACb,MAAM,EAAE,IAAI;iCACb;6BACF;yBACF;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,uBAAuB;wBAC7C,KAAK,EAAE,qBAAqB;wBAC5B,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,uBAAuB;4BAChC,IAAI,EAAE,UAAU;4BAChB,UAAU,EAAE;gCACV,QAAQ,EAAE,GAAG,SAAS,4BAA4B;6BACnD;yBACF;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,2BAA2B;wBACjD,KAAK,EAAE,yBAAyB;wBAChC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,uBAAuB;4BAChC,IAAI,EAAE,UAAU;4BAChB,UAAU,EAAE;gCACV,QAAQ,EAAE,GAAG,SAAS,gCAAgC;6BACvD;yBACF;qBACF;oBACD;wBACE,QAAQ,EAAE,GAAG,SAAS,yBAAyB;wBAC/C,KAAK,EAAE,wBAAwB;wBAC/B,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE;4BACP,OAAO,EAAE,8BAA8B;4BACvC,MAAM,EAAE,MAAM,CAAC,YAAY;4BAC3B,QAAQ,EAAE,GAAG;4BACb,SAAS,EAAE,GAAG;4BACd,WAAW,EAAE,GAAG;4BAChB,UAAU,EAAE;gCACV,QAAQ,EAAE,GAAG,SAAS,8BAA8B;6BACrD;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/templates/_internal/computeLinks.js

@@ -0,0 +1,26 @@
+import { getItemHomeUrl } from "../../urls";
+import { getItemIdentifier } from "../../items";
+import { getHubRelativeUrl } from "../../content/_internal/internalContentUtils";
+import { getRelativeWorkspaceUrl } from "../../core/getRelativeWorkspaceUrl";
+import { getItemThumbnailUrl } from "../../resources/get-item-thumbnail-url";
+/**
+ * Compute the links that get appended to a Hub Template
+ * search result and entity
+ *
+ * @param item
+ * @param requestOptions
+ */
+export function computeLinks(item, requestOptions) {
+    let token;
+    if (requestOptions.authentication) {
+        const session = requestOptions.authentication;
+        token = session.token;
+    }
+    return {
+        self: getItemHomeUrl(item.id, requestOptions),
+        siteRelative: getHubRelativeUrl(item.type, getItemIdentifier(item), item.typeKeywords),
+        workspaceRelative: getRelativeWorkspaceUrl(item.type, getItemIdentifier(item)),
+        thumbnail: getItemThumbnailUrl(item, requestOptions, token),
+    };
+}
+//# sourceMappingURL=computeLinks.js.map

package/dist/esm/templates/_internal/computeLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeLinks.js","sourceRoot":"","sources":["../../../../src/templates/_internal/computeLinks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAW,EACX,cAA+B;IAE/B,IAAI,KAAa,CAAC;IAClB,IAAI,cAAc,CAAC,cAAc,EAAE;QACjC,MAAM,OAAO,GAAgB,cAAc,CAAC,cAA6B,CAAC;QAC1E,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;KACvB;IAED,OAAO;QACL,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC;QAC7C,YAAY,EAAE,iBAAiB,CAC7B,IAAI,CAAC,IAAI,EACT,iBAAiB,CAAC,IAAI,CAAC,EACvB,IAAI,CAAC,YAAY,CAClB;QACD,iBAAiB,EAAE,uBAAuB,CACxC,IAAI,CAAC,IAAI,EACT,iBAAiB,CAAC,IAAI,CAAC,CACxB;QACD,SAAS,EAAE,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/esm/templates/_internal/computeProps.js

@@ -0,0 +1,36 @@
+import { isDiscussable } from "../../discussions/utils";
+import { processEntityFeatures } from "../../permissions/_internal/processEntityFeatures";
+import { TemplateDefaultFeatures } from "./TemplateBusinessRules";
+import { computeLinks } from "./computeLinks";
+import { getProp } from "../../objects";
+import { getDeployedTemplateType } from "../utils";
+/**
+ * @private
+ * Given a model and a template, set various computed
+ * properties on the template that can't be directly
+ * mapped from the model
+ * @param model
+ * @param template
+ * @param requestOptions
+ */
+export function computeProps(model, template, requestOptions) {
+    // 1. compute relevant template links
+    template.links = computeLinks(model.item, requestOptions);
+    // 2. append the template's thumbnail url at the top-level
+    template.thumbnailUrl = template.links.thumbnail;
+    // 3. compute relevant template dates
+    template.createdDate = new Date(model.item.created);
+    template.createdDateSource = "item.created";
+    template.updatedDate = new Date(model.item.modified);
+    template.updatedDateSource = "item.modified";
+    // 4. determine whether the template is discussable
+    template.isDiscussable = isDiscussable(template);
+    // 5. process features that can be disabled by the entity owner
+    template.features = processEntityFeatures(getProp(model, "data.settings.features") || {}, TemplateDefaultFeatures);
+    // 6. compute additional template-specific properties
+    template.isDeployed = (getProp(model, "item.typeKeywords") || []).includes("Deployed");
+    template.deployedType = getDeployedTemplateType(model.item);
+    // 7. cast b/c this takes a partial but returns a full template
+    return template;
+}
+//# sourceMappingURL=computeProps.js.map

package/dist/esm/templates/_internal/computeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeProps.js","sourceRoot":"","sources":["../../../../src/templates/_internal/computeProps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAE1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,QAA+B,EAC/B,cAA+B;IAE/B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAE1D,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;IAEjD,qCAAqC;IACrC,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,iBAAiB,GAAG,cAAc,CAAC;IAC5C,QAAQ,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,QAAQ,CAAC,iBAAiB,GAAG,eAAe,CAAC;IAE7C,mDAAmD;IACnD,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEjD,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,GAAG,qBAAqB,CACvC,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,EAC9C,uBAAuB,CACxB,CAAC;IAEF,qDAAqD;IACrD,QAAQ,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CACxE,UAAU,CACX,CAAC;IACF,QAAQ,CAAC,YAAY,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5D,+DAA+D;IAC/D,OAAO,QAAwB,CAAC;AAClC,CAAC"}

package/dist/esm/templates/_internal/getPropertyMap.js

@@ -0,0 +1,14 @@
+import { getBasePropertyMap } from "../../core/_internal/getBasePropertyMap";
+/**
+ * @private
+ * Returns an Array of IPropertyMap objects that
+ * define the projection of properties from an
+ * IModel to an IHubTemplate
+ */
+export function getPropertyMap() {
+    const map = getBasePropertyMap();
+    // IHubTemplate specific mappings
+    map.push({ entityKey: "previewUrl", storeKey: "item.properties.previewUrl" });
+    return map;
+}
+//# sourceMappingURL=getPropertyMap.js.map

package/dist/esm/templates/_internal/getPropertyMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPropertyMap.js","sourceRoot":"","sources":["../../../../src/templates/_internal/getPropertyMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IAEjC,iCAAiC;IACjC,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAE9E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/templates/defaults.js

@@ -0,0 +1,40 @@
+import { TemplateDefaultFeatures } from "./_internal/TemplateBusinessRules";
+/**
+ * NOTE: this file provides default values for new
+ * Hub Template creation; however, we have no immediate
+ * plans to allow template creation from the context of
+ * our application. Scaffolding these defaults for
+ * potential future implementation
+ */
+export const HUB_TEMPLATE_ITEM_TYPE = "Solution";
+/** Default values for a new IHubTemplate */
+export const DEFAULT_TEMPLATE = {
+    schemaVersion: 1,
+    catalog: { schemaVersion: 0 },
+    name: "",
+    tags: [],
+    typeKeywords: [HUB_TEMPLATE_ITEM_TYPE],
+    view: {},
+    permissions: [],
+    features: TemplateDefaultFeatures,
+};
+/** Default values for a new HubTemplate Model (backing item) */
+export const DEFAULT_TEMPLATE_MODEL = {
+    item: {
+        type: HUB_TEMPLATE_ITEM_TYPE,
+        title: "",
+        description: "",
+        snippet: "",
+        tags: [],
+        typeKeywords: [HUB_TEMPLATE_ITEM_TYPE],
+        properties: {
+            slug: "",
+            schemaVersion: 1,
+        },
+    },
+    data: {
+        permissions: [],
+        view: {},
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/esm/templates/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/templates/defaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;IAC7B,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,YAAY,EAAE,CAAC,sBAAsB,CAAC;IACtC,IAAI,EAAE,EAAE;IACR,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,uBAAuB;CAClC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAW;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,CAAC,sBAAsB,CAAC;QACtC,UAAU,EAAE;YACV,IAAI,EAAE,EAAE;YACR,aAAa,EAAE,CAAC;SACjB;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,EAAE;KACT;CACmB,CAAC"}

package/dist/esm/templates/edit.js

@@ -0,0 +1,76 @@
+import { getUniqueSlug } from "../items/slugs";
+import { setDiscussableKeyword } from "../discussions";
+import { PropertyMapper } from "../core/_internal/PropertyMapper";
+import { cloneObject } from "../util";
+import { getModel, updateModel } from "../models";
+import { getPropertyMap } from "./_internal/getPropertyMap";
+import { computeProps } from "./_internal/computeProps";
+import { removeItem, } from "@esri/arcgis-rest-portal";
+/**
+ * @private
+ * Creates a Hub Template's backing Solution item and returns
+ * the created entity
+ *
+ * NOTE: We have no immediate plans to allow template creation
+ * from the context of the Hub application, but scaffolding
+ * this util for potential future implementation. For now,
+ * we will throw an error
+ * @param partialTemplate
+ * @param requestOptions
+ */
+export function createTemplate(partialTemplate, requestOptions) {
+    throw new Error("Template creation is not currently supported from the context of Hub");
+}
+/**
+ * @private
+ * Updates a Hub Template's backing item and returns
+ * the updated entity
+ * @param template
+ * @param requestOptions
+ */
+export async function updateTemplate(template, requestOptions) {
+    // 1. Verify the slug is unique, excluding the current template
+    template.slug = await getUniqueSlug({ slug: template.slug, existingId: template.id }, requestOptions);
+    // 2. Update relevant typeKeywords
+    template.typeKeywords = setDiscussableKeyword(template.typeKeywords, template.isDiscussable);
+    // 3. Fetch the backing model (item + data)
+    const model = await getModel(template.id, requestOptions);
+    // 4. Create a property mapper between the template
+    // object and item model
+    const mapper = new PropertyMapper(getPropertyMap());
+    // 5. Create item model from updated template object, using
+    // the existing model as a starting point
+    const modelToUpdate = mapper.entityToStore(template, model);
+    // 6. Update the backing item
+    const updatedModel = await updateModel(modelToUpdate, requestOptions);
+    // 7. Map the item back into an IHubTemplate
+    const updatedTemplate = mapper.storeToEntity(updatedModel, template);
+    // 8. Compute + set various properties on the IHubTemplate
+    // that cannot be directly mapped from the item
+    template = computeProps(model, updatedTemplate, requestOptions);
+    return updatedTemplate;
+}
+/**
+ * Convert an IHubTemplateEditor back into a IHubTemplate
+ * @param editor
+ * @param portal
+ */
+export function editorToTemplate(editor, portal) {
+    // 1. cast editor to IHubTemplate
+    const template = cloneObject(editor);
+    // 2. ensure there's an org url key
+    template.orgUrlKey = editor.orgUrlKey ? editor.orgUrlKey : portal.urlKey;
+    return template;
+}
+/**
+ * @private
+ * Remove a Hub Template's backing item
+ * @param id
+ * @param requestOptions
+ */
+export async function deleteTemplate(id, requestOptions) {
+    const ro = Object.assign(Object.assign({}, requestOptions), { id });
+    await removeItem(ro);
+    return;
+}
+//# sourceMappingURL=edit.js.map

package/dist/esm/templates/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/templates/edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAGL,UAAU,GACX,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,eAAsC,EACtC,cAAmC;IAEnC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAsB,EACtB,cAAmC;IAEnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,GAAG,MAAM,aAAa,CACjC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,EAChD,cAAc,CACf,CAAC;IAEF,kCAAkC;IAClC,QAAQ,CAAC,YAAY,GAAG,qBAAqB,CAC3C,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,aAAa,CACvB,CAAC;IAEF,2CAA2C;IAC3C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;IAE1D,mDAAmD;IACnD,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,cAAc,EAAE,CACjB,CAAC;IAEF,2DAA2D;IAC3D,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAEtE,4CAA4C;IAC5C,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAErE,0DAA0D;IAC1D,+CAA+C;IAC/C,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IAEhE,OAAO,eAA+B,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA0B,EAC1B,MAAe;IAEf,iCAAiC;IACjC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAiB,CAAC;IAErD,mCAAmC;IACnC,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAEzE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAU,EACV,cAAmC;IAEnC,MAAM,EAAE,GAAG,gCAAK,cAAc,GAAK,EAAE,EAAE,EAAE,CAAsB,CAAC;IAChE,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;IAErB,OAAO;AACT,CAAC"}

package/dist/esm/templates/fetch.js

@@ -0,0 +1,108 @@
+import { isGuid, mapBy } from "../utils";
+import { getItem } from "@esri/arcgis-rest-portal";
+import { getItemBySlug } from "../items/slugs";
+import { fetchModelFromItem } from "../models";
+import { PropertyMapper } from "../core/_internal/PropertyMapper";
+import { getPropertyMap } from "./_internal/getPropertyMap";
+import { computeProps } from "./_internal/computeProps";
+import { getFamily } from "../content/get-family";
+import { unique } from "../util";
+import { parseInclude } from "../search/_internal/parseInclude";
+import { fetchItemEnrichments } from "../items/_enrichments";
+import { getProp } from "../objects";
+import { computeLinks } from "./_internal/computeLinks";
+import { getDeployedTemplateType } from "./utils";
+/**
+ * @private
+ * Fetch a Hub Template backing item by id or slug
+ * @param identifier item id or slug
+ * @param requestOptions
+ */
+export async function fetchTemplate(identifier, requestOptions) {
+    let getPrms;
+    if (isGuid(identifier)) {
+        getPrms = getItem(identifier, requestOptions);
+    }
+    else {
+        getPrms = getItemBySlug(identifier, requestOptions);
+    }
+    return getPrms.then((item) => {
+        if (!item)
+            return null;
+        return convertItemToTemplate(item, requestOptions);
+    });
+}
+/**
+ * @private
+ * Convert a Solution Item into a Hub Template, fetching
+ * any additional information that may be required
+ * @param item
+ * @param auth
+ */
+export async function convertItemToTemplate(item, requestOptions) {
+    const model = await fetchModelFromItem(item, requestOptions);
+    // 1. Create a property mapper between the the template
+    // object and item model
+    const mapper = new PropertyMapper(getPropertyMap());
+    // 2. Map the item into an IHubTemplate
+    const template = mapper.storeToEntity(model, {});
+    // 3. Compute + set various properties on the IHubTemplate
+    // that cannot be directly mapped from the item
+    return computeProps(model, template, requestOptions);
+}
+/**
+ * @private
+ * Fetch template specific enrichments
+ * @param item
+ * @param include
+ * @param requestOptions
+ */
+export async function enrichTemplateSearchResult(item, include, requestOptions) {
+    const result = {
+        access: item.access,
+        id: item.id,
+        type: item.type,
+        name: item.title,
+        owner: item.owner,
+        typeKeywords: item.typeKeywords,
+        tags: item.tags,
+        categories: item.categories,
+        summary: item.snippet || item.description,
+        createdDate: new Date(item.created),
+        createdDateSource: "item.created",
+        updatedDate: new Date(item.modified),
+        updatedDateSource: "item.modified",
+        family: getFamily(item.type),
+        links: {
+            self: "not-implemented",
+            siteRelative: "not-implemented",
+            thumbnail: "not-implemented",
+            workspaceRelative: "not-implemented",
+        },
+    };
+    // 1. optionally enrich the template item with
+    // well-known item enrichments
+    const DEFAULTS = [];
+    // merge default and provided "include" enrichments
+    include = [...DEFAULTS, ...include].filter(unique);
+    // Parse the includes into a valid set of enrichments
+    const specs = include.map(parseInclude);
+    // Extract out the low-level enrichments needed
+    const enrichments = mapBy("enrichment", specs).filter(unique);
+    // fetch the enrichments
+    let enriched = {};
+    if (enrichments.length) {
+        enriched = await fetchItemEnrichments(item, enrichments, requestOptions);
+    }
+    // map the enriched props onto the result
+    specs.forEach((spec) => {
+        result[spec.prop] = getProp(enriched, spec.path);
+    });
+    // 2. append relevant links onto the search result - these
+    // are the same links that get appended to the template entity
+    result.links = computeLinks(item, requestOptions);
+    // 3. append additional template-specific properties
+    result.deployedType = getDeployedTemplateType(item);
+    return result;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/esm/templates/fetch.js.map

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

package/dist/esm/templates/index.js

@@ -0,0 +1,5 @@
+export * from "./HubTemplate";
+export * from "./view";
+export * from "./fetch";
+export * from "./edit";
+//# sourceMappingURL=index.js.map

package/dist/esm/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/esm/templates/utils.js

@@ -0,0 +1,37 @@
+import { dasherize } from "../utils";
+import { capitalize } from "../util";
+/**
+ * We do our best to glean what the solution template
+ * is supposed to become when deployed. This util
+ * extracts the expected item type from the
+ * hubSolutionType typeKeyword on the solution item
+ *
+ * We use this in various UIs to show the expected
+ * type rather than "Solution"
+ *
+ * @param template
+ */
+export const getDeployedTemplateType = (template) => {
+    let deployedType = "Solution";
+    // 1. Extract the camelCase item type from the
+    // hubSolutionType|<camel-case-item-type> typeKeyword
+    const hubSolutionTypeKeyword = template.typeKeywords.find((keyword) => keyword.startsWith("hubSolutionType|"));
+    // 2. Attempt to de-camelize the item type
+    if (hubSolutionTypeKeyword) {
+        const camelizedType = hubSolutionTypeKeyword.split("|")[1];
+        deployedType = dasherize(camelizedType)
+            .split("-")
+            .map((str) => capitalize(str))
+            .join(" ");
+        // some item types need to be handled separately
+        // because they don't follow the standard pattern
+        const exceptionMap = {
+            storyMap: "StoryMap",
+        };
+        if (exceptionMap[camelizedType]) {
+            deployedType = exceptionMap[camelizedType];
+        }
+    }
+    return deployedType;
+};
+//# sourceMappingURL=utils.js.map

package/dist/esm/templates/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/templates/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAe,EAAU,EAAE;IACjE,IAAI,YAAY,GAAG,UAAU,CAAC;IAC9B,8CAA8C;IAC9C,qDAAqD;IACrD,MAAM,sBAAsB,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAC5E,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CACvC,CAAC;IAEF,0CAA0C;IAC1C,IAAI,sBAAsB,EAAE;QAC1B,MAAM,aAAa,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC;aACpC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,gDAAgD;QAChD,iDAAiD;QACjD,MAAM,YAAY,GAA2B;YAC3C,QAAQ,EAAE,UAAU;SAErB,CAAC;QAEF,IAAI,YAAY,CAAC,aAAa,CAAC,EAAE;YAC/B,YAAY,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;SAC5C;KACF;IAED,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}