@esri/hub-common 14.26.2 → 14.27.0

package/dist/node/templates/view.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateResultToCardModel = exports.templateToCardModel = void 0;
+const get_family_1 = require("../content/get-family");
+const internalContentUtils_1 = require("../content/_internal/internalContentUtils");
+const getCardModelUrl_1 = require("../urls/getCardModelUrl");
+/**
+ * Convert a template entity into a card view model that can
+ * be consumed by the suite of hub gallery components
+ *
+ * @param template template entity
+ * @param context auth & portal information
+ * @param opts view model options
+ */
+exports.templateToCardModel = (template, context, opts) => {
+    const { actionLinks = [], baseUrl = "", locale = "en-US", target = "self", } = opts || {};
+    const titleUrl = getCardModelUrl_1.getCardModelUrlFromEntity(template, context, target, baseUrl);
+    return Object.assign(Object.assign(Object.assign({}, getSharedTemplateCardModel(template, locale)), { actionLinks,
+        titleUrl }), (template.thumbnailUrl && { thumbnailUrl: template.thumbnailUrl }));
+};
+/**
+ * Convert a template hub search result into a card view model
+ * that can be consumed by the suite of hub gallery components
+ *
+ * @param searchResult hub template search result
+ * @param opts view model options
+ */
+exports.templateResultToCardModel = (searchResult, opts) => {
+    const { actionLinks = [], baseUrl = "", locale = "en-US", target = "self", } = opts || {};
+    const titleUrl = getCardModelUrl_1.getCardModelUrlFromResult(searchResult, target, baseUrl);
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, getSharedTemplateCardModel(searchResult, locale)), { actionLinks }), (!isNaN(searchResult.index) && { index: searchResult.index })), { titleUrl }), (searchResult.links.thumbnail && {
+        thumbnailUrl: searchResult.links.thumbnail,
+    }));
+};
+/**
+ * Given a template entity OR hub serach result, construct the
+ * template's shared card view model properties
+ *
+ * @param entityOrSearchResult template entity or hub search result
+ * @param locale internationalization locale
+ */
+const getSharedTemplateCardModel = (entityOrSearchResult, locale) => {
+    var _a, _b;
+    const additionalInfo = [
+        {
+            i18nKey: "type",
+            value: entityOrSearchResult.type,
+        },
+        {
+            i18nKey: "dateUpdated",
+            value: entityOrSearchResult.updatedDate.toLocaleDateString(locale),
+        },
+        ...(((_a = entityOrSearchResult.tags) === null || _a === void 0 ? void 0 : _a.length) ? [
+            {
+                i18nKey: "tags",
+                value: entityOrSearchResult.tags.join(", "),
+            },
+        ]
+            : []),
+        ...(((_b = entityOrSearchResult.categories) === null || _b === void 0 ? void 0 : _b.length) ? [
+            {
+                i18nKey: "categories",
+                value: internalContentUtils_1.getShortenedCategories(entityOrSearchResult.categories).join(", "),
+            },
+        ]
+            : []),
+        {
+            i18nKey: "dateCreated",
+            value: entityOrSearchResult.createdDate.toLocaleDateString(locale),
+        },
+    ];
+    return {
+        access: entityOrSearchResult.access,
+        badges: [],
+        id: entityOrSearchResult.id,
+        family: get_family_1.getFamily(entityOrSearchResult.type),
+        source: entityOrSearchResult.owner,
+        summary: entityOrSearchResult.summary,
+        title: entityOrSearchResult.name,
+        type: entityOrSearchResult.type,
+        additionalInfo,
+    };
+};
+//# sourceMappingURL=view.js.map

package/dist/node/templates/view.js.map

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

package/dist/node/urls/getCardModelUrl.js

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCardModelUrlFromEntity = exports.getCardModelUrlFromResult = void 0;
-const getRelativeWorkspaceUrl_1 = require("../core/getRelativeWorkspaceUrl");
-const internalContentUtils_1 = require("../content/_internal/internalContentUtils");
-const get_item_home_url_1 = require("./get-item-home-url");
 /**
- * returns a gallery card's title url from a hub search result
+ * given a target and hub search result, this util
+ * returns a gallery card's title url
  *
  * @param result hub search result
  * @param target context the card should redirect to
@@ -42,7 +40,8 @@ function getCardModelUrlFromResult(result, target, baseUrl) {
 }
 exports.getCardModelUrlFromResult = getCardModelUrlFromResult;
 /**
- * returns a gallery card's title url from an entity
+ * given a target and hub entity, this util
+ * returns a gallery card's title url
  *
  * @param entity hub entity
  * @param context auth & portal information
@@ -50,6 +49,7 @@ exports.getCardModelUrlFromResult = getCardModelUrlFromResult;
  * @param baseUrl base url to work in conjunction with the target
  */
 function getCardModelUrlFromEntity(entity, context, target, baseUrl) {
+    var _a, _b, _c, _d, _e, _f;
     let titleUrl;
     if (target === "event") {
         titleUrl = "#";
@@ -61,17 +61,17 @@ function getCardModelUrlFromEntity(entity, context, target, baseUrl) {
         switch (entity.type) {
             default:
                 titleUrl = {
-                    self: get_item_home_url_1.getItemHomeUrl(entity.id, context.hubRequestOptions),
+                    self: (_a = entity.links) === null || _a === void 0 ? void 0 : _a.self,
                     siteRelative: baseUrl
-                        ? `${baseUrl}${internalContentUtils_1.getHubRelativeUrl(entity.type, entity.id)}`
-                        : internalContentUtils_1.getHubRelativeUrl(entity.type, entity.id),
+                        ? `${baseUrl}${((_b = entity.links) === null || _b === void 0 ? void 0 : _b.siteRelative) || ""}`
+                        : (_c = entity.links) === null || _c === void 0 ? void 0 : _c.siteRelative,
                     workspaceRelative: baseUrl
-                        ? `${baseUrl}${getRelativeWorkspaceUrl_1.getRelativeWorkspaceUrl(entity.type, entity.id)}`
-                        : getRelativeWorkspaceUrl_1.getRelativeWorkspaceUrl(entity.type, entity.id),
+                        ? `${baseUrl}${((_d = entity.links) === null || _d === void 0 ? void 0 : _d.workspaceRelative) || ""}`
+                        : (_e = entity.links) === null || _e === void 0 ? void 0 : _e.workspaceRelative,
                 }[target];
                 break;
             case "Hub Site Application":
-                titleUrl = get_item_home_url_1.getItemHomeUrl(entity.id, context.hubRequestOptions);
+                titleUrl = (_f = entity.links) === null || _f === void 0 ? void 0 : _f.self;
                 break;
         }
     }

package/dist/node/urls/getCardModelUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCardModelUrl.js","sourceRoot":"","sources":["../../../src/urls/getCardModelUrl.ts"],"names":[],"mappings":";;;AACA,6EAA0E;AAC1E,oFAA8E;AAI9E,2DAAqD;AAErD;;;;;;GAMG;AACH,SAAgB,yBAAyB,CACvC,MAAwB,EACxB,MAAuB,EACvB,OAAgB;;IAEhB,IAAI,QAAQ,CAAC;IAEb,IAAI,MAAM,KAAK,OAAO,EAAE;QACtB,QAAQ,GAAG,GAAG,CAAC;KAChB;SAAM,IAAI,MAAM,KAAK,MAAM,EAAE;QAC5B,QAAQ,GAAG,SAAS,CAAC;KACtB;SAAM;QACL,QAAQ,MAAM,CAAC,IAAI,EAAE;YACnB;gBACE,QAAQ,GAAG;oBACT,IAAI,QAAE,MAAM,CAAC,KAAK,0CAAE,IAAI;oBACxB,YAAY,EAAE,OAAO;wBACnB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,YAAY,KAAI,EAAE,EAAE;wBACjD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,YAAY;oBAC9B,iBAAiB,EAAE,OAAO;wBACxB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,iBAAiB,KAAI,EAAE,EAAE;wBACtD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,iBAAiB;iBACpC,CAAC,MAAM,CAAC,CAAC;gBACV,MAAM;YACR,KAAK,sBAAsB;gBACzB,QAAQ,SAAG,MAAM,CAAC,KAAK,0CAAE,IAAI,CAAC;gBAC9B,MAAM;SACT;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AA/BD,8DA+BC;AAED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,MAAiB,EACjB,OAAuB,EACvB,MAAuB,EACvB,OAAgB;IAEhB,IAAI,QAAQ,CAAC;IAEb,IAAI,MAAM,KAAK,OAAO,EAAE;QACtB,QAAQ,GAAG,GAAG,CAAC;KAChB;SAAM,IAAI,MAAM,KAAK,MAAM,EAAE;QAC5B,QAAQ,GAAG,SAAS,CAAC;KACtB;SAAM;QACL,QAAQ,MAAM,CAAC,IAAI,EAAE;YACnB;gBACE,QAAQ,GAAG;oBACT,IAAI,EAAE,kCAAc,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC;oBAC1D,YAAY,EAAE,OAAO;wBACnB,CAAC,CAAC,GAAG,OAAO,GAAG,wCAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE;wBAC1D,CAAC,CAAC,wCAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;oBAC7C,iBAAiB,EAAE,OAAO;wBACxB,CAAC,CAAC,GAAG,OAAO,GAAG,iDAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE;wBAChE,CAAC,CAAC,iDAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;iBACpD,CAAC,MAAM,CAAC,CAAC;gBACV,MAAM;YACR,KAAK,sBAAsB;gBACzB,QAAQ,GAAG,kCAAc,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBAChE,MAAM;SACT;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAhCD,8DAgCC"}
+{"version":3,"file":"getCardModelUrl.js","sourceRoot":"","sources":["../../../src/urls/getCardModelUrl.ts"],"names":[],"mappings":";;;AAMA;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,MAAwB,EACxB,MAAuB,EACvB,OAAgB;;IAEhB,IAAI,QAAQ,CAAC;IAEb,IAAI,MAAM,KAAK,OAAO,EAAE;QACtB,QAAQ,GAAG,GAAG,CAAC;KAChB;SAAM,IAAI,MAAM,KAAK,MAAM,EAAE;QAC5B,QAAQ,GAAG,SAAS,CAAC;KACtB;SAAM;QACL,QAAQ,MAAM,CAAC,IAAI,EAAE;YACnB;gBACE,QAAQ,GAAG;oBACT,IAAI,QAAE,MAAM,CAAC,KAAK,0CAAE,IAAI;oBACxB,YAAY,EAAE,OAAO;wBACnB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,YAAY,KAAI,EAAE,EAAE;wBACjD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,YAAY;oBAC9B,iBAAiB,EAAE,OAAO;wBACxB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,iBAAiB,KAAI,EAAE,EAAE;wBACtD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,iBAAiB;iBACpC,CAAC,MAAM,CAAC,CAAC;gBACV,MAAM;YACR,KAAK,sBAAsB;gBACzB,QAAQ,SAAG,MAAM,CAAC,KAAK,0CAAE,IAAI,CAAC;gBAC9B,MAAM;SACT;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AA/BD,8DA+BC;AAED;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,MAAiB,EACjB,OAAuB,EACvB,MAAuB,EACvB,OAAgB;;IAEhB,IAAI,QAAQ,CAAC;IAEb,IAAI,MAAM,KAAK,OAAO,EAAE;QACtB,QAAQ,GAAG,GAAG,CAAC;KAChB;SAAM,IAAI,MAAM,KAAK,MAAM,EAAE;QAC5B,QAAQ,GAAG,SAAS,CAAC;KACtB;SAAM;QACL,QAAQ,MAAM,CAAC,IAAI,EAAE;YACnB;gBACE,QAAQ,GAAG;oBACT,IAAI,QAAE,MAAM,CAAC,KAAK,0CAAE,IAAI;oBACxB,YAAY,EAAE,OAAO;wBACnB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,YAAY,KAAI,EAAE,EAAE;wBACjD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,YAAY;oBAC9B,iBAAiB,EAAE,OAAO;wBACxB,CAAC,CAAC,GAAG,OAAO,GAAG,OAAA,MAAM,CAAC,KAAK,0CAAE,iBAAiB,KAAI,EAAE,EAAE;wBACtD,CAAC,OAAC,MAAM,CAAC,KAAK,0CAAE,iBAAiB;iBACpC,CAAC,MAAM,CAAC,CAAC;gBACV,MAAM;YACR,KAAK,sBAAsB;gBACzB,QAAQ,SAAG,MAAM,CAAC,KAAK,0CAAE,IAAI,CAAC;gBAC9B,MAAM;SACT;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAhCD,8DAgCC"}

package/dist/types/core/schemas/types.d.ts

@@ -5,7 +5,7 @@ import Ajv from "ajv";
  * to the supported/defined uiSchema configurations
  */
 export declare type EditorType = (typeof validEditorTypes)[number];
-export declare const validEditorTypes: readonly ["hub:project:create", "hub:project:edit", "hub:content:edit", "hub:content:settings", "hub:content:discussions", "hub:initiative:edit", "hub:initiative:create", "hub:site:edit", "hub:site:create", "hub:site:followers", "hub:site:discussions", "hub:discussion:edit", "hub:discussion:create", "hub:discussion:settings", "hub:page:edit", "hub:group:edit", "hub:group:settings", "hub:group:discussions", "hub:initiativeTemplate:edit"];
+export declare const validEditorTypes: readonly ["hub:project:create", "hub:project:edit", "hub:content:edit", "hub:content:settings", "hub:content:discussions", "hub:initiative:edit", "hub:initiative:create", "hub:site:edit", "hub:site:create", "hub:site:followers", "hub:site:discussions", "hub:discussion:edit", "hub:discussion:create", "hub:discussion:settings", "hub:page:edit", "hub:template:edit", "hub:group:edit", "hub:group:settings", "hub:group:discussions", "hub:initiativeTemplate:edit"];
 export declare enum UiSchemaRuleEffects {
     SHOW = "SHOW",
     HIDE = "HIDE",

package/dist/types/core/types/HubEntity.d.ts

@@ -4,4 +4,5 @@ import { IHubProject } from "./IHubProject";
 import { IHubSite } from "./IHubSite";
 import { IHubDiscussion } from "./IHubDiscussion";
 import { IHubGroup } from "./IHubGroup";
-export declare type HubEntity = IHubSite | IHubProject | IHubDiscussion | IHubInitiative | IHubPage | IHubGroup;
+import { IHubTemplate } from "./IHubTemplate";
+export declare type HubEntity = IHubSite | IHubProject | IHubDiscussion | IHubInitiative | IHubPage | IHubGroup | IHubTemplate;

package/dist/types/core/types/HubEntityType.d.ts

@@ -1,2 +1,2 @@
-export declare const HUB_ENTITY_TYPES: readonly ["site", "project", "initiative", "initiativeTemplate", "page", "discussion", "content", "org", "group"];
+export declare const HUB_ENTITY_TYPES: readonly ["site", "project", "initiative", "initiativeTemplate", "page", "discussion", "content", "org", "group", "template"];
 export declare type HubEntityType = (typeof HUB_ENTITY_TYPES)[number];

package/dist/types/core/types/IHubTemplate.d.ts

@@ -0,0 +1,13 @@
+import { IWithSlug } from "../traits";
+import { IHubItemEntity, IHubItemEntityEditor } from "./IHubItemEntity";
+/** Defines the properties of a Hub Template entity */
+export interface IHubTemplate extends IHubItemEntity, IWithSlug {
+    previewUrl: string;
+    isDeployed: boolean;
+    deployedType: string;
+}
+/**
+ * This type redefines the IHubTemplate interface in such a way
+ * that it can be consumed by the entity editor.
+ */
+export declare type IHubTemplateEditor = IHubItemEntityEditor<IHubTemplate> & {};

package/dist/types/core/types/index.d.ts

@@ -17,6 +17,7 @@ export * from "./IHubLayout";
 export * from "./IHubLocation";
 export * from "./IHubPage";
 export * from "./IHubProject";
+export * from "./IHubTemplate";
 export * from "./IHubSite";
 export * from "./IHubSiteTheme";
 export * from "./IHubTimeline";

package/dist/types/index.d.ts

@@ -26,6 +26,7 @@ export * from "./resources";
 export * from "./search";
 export * from "./sites";
 export * from "./surveys";
+export * from "./templates";
 export * from "./types";
 export * from "./urls";
 export * from "./users";

package/dist/types/permissions/types/Permission.d.ts

@@ -7,6 +7,7 @@ import { GroupPermissions } from "../../groups/_internal/GroupBusinessRules";
 import { PagePermissions } from "../../pages/_internal/PageBusinessRules";
 import { PlatformPermissions } from "../PlatformPermissionPolicies";
 import { InitiativeTemplatePermissions } from "../../initiative-templates/_internal/InitiativeTemplateBusinessRules";
+import { TemplatePermissions } from "../../templates/_internal/TemplateBusinessRules";
 /**
  * Defines the values for Permissions
  * It's critical that the arrays defined in the modules use `as const`
@@ -16,7 +17,7 @@ declare const TempPermissions: string[];
 /**
  * Defines the possible values for Permissions
  */
-export declare type Permission = (typeof SitePermissions)[number] | (typeof ProjectPermissions)[number] | (typeof InitiativePermissions)[number] | (typeof ContentPermissions)[number] | (typeof GroupPermissions)[number] | (typeof PagePermissions)[number] | (typeof PlatformPermissions)[number] | (typeof TempPermissions)[number] | (typeof DiscussionPermissions)[number] | (typeof InitiativeTemplatePermissions)[number];
+export declare type Permission = (typeof SitePermissions)[number] | (typeof ProjectPermissions)[number] | (typeof InitiativePermissions)[number] | (typeof ContentPermissions)[number] | (typeof GroupPermissions)[number] | (typeof PagePermissions)[number] | (typeof PlatformPermissions)[number] | (typeof TempPermissions)[number] | (typeof DiscussionPermissions)[number] | (typeof InitiativeTemplatePermissions)[number] | (typeof TemplatePermissions)[number];
 /**
  * Validate a Permission
  * @param permission

package/dist/types/templates/HubTemplate.d.ts

@@ -0,0 +1,79 @@
+import { IArcGISContext } from "../ArcGISContext";
+import { IEditorConfig } from "../core/behaviors/IWithEditorBehavior";
+import { HubItemEntity } from "../core/HubItemEntity";
+import { IHubTemplate, IHubTemplateEditor } from "../core/types/IHubTemplate";
+import { TemplateEditorType } from "./_internal/TemplateSchema";
+import { IEntityEditorContext } from "../core/types";
+/**
+ * Hub Template Class - this class encapsulates the standard
+ * operations for a "Solution" item despite the Hub team not
+ * "owning" this item type. Our primary goal is to allow
+ * editing of the item's meta information, manage sharing, etc.
+ */
+export declare class HubTemplate extends HubItemEntity<IHubTemplate> {
+    /**
+     * Private constructor to allow for future
+     * template-specific logic
+     * @param template
+     * @param context
+     */
+    private constructor();
+    /**
+     * Create an HubTemplate instance from an IHubTemplate object
+     * @param json - JSON object to create a HubTemplate from
+     * @param context - ArcGIS context
+     * @returns
+     */
+    static fromJson(json: Partial<IHubTemplate>, context: IArcGISContext): HubTemplate;
+    /**
+     * Create a new HubTemplate, returning a HubTemplate instance.
+     * This does not automatically persist the Template into
+     * the backing store unless save is set to true
+     *
+     * NOTE: we have no immediate plans to allow template creation
+     * from the context of the Hub application, but scaffolding this
+     * method for potential future implementation. The underlying
+     * createTemplate function will throw an error if attempted.
+     * @param partialTemplate
+     * @param context
+     * @param save
+     */
+    static create(partialTemplate: Partial<IHubTemplate>, context: IArcGISContext, save?: boolean): Promise<HubTemplate>;
+    /**
+     * Fetch a HubTemplate from the backing store and return
+     * a HubTemplate instance
+     * @param identifier
+     * @param context
+     */
+    static fetch(identifier: string, context: IArcGISContext): Promise<HubTemplate>;
+    /**
+     * Given a partial Template, apply defaults to
+     * it to ensure that a baseline of properties are set
+     * @param partialTemplate
+     * @param context
+     */
+    private static applyDefaults;
+    getEditorConfig(i18nScope: string, type: TemplateEditorType): Promise<IEditorConfig>;
+    /**
+     * Transform template entity into an editor object
+     * @param editorContext
+     */
+    toEditor(editorContext?: IEntityEditorContext, include?: string[]): Promise<IHubTemplateEditor>;
+    /**
+     * Transform editor values into a template entity
+     * @param editor
+     */
+    fromEditor(editor: IHubTemplateEditor): Promise<IHubTemplate>;
+    /**
+     * Update the instance's internal entity state
+     * @param changes
+     */
+    update(changes: Partial<IHubTemplate>): void;
+    /** Save the HubTemplate to the backing store */
+    save(): Promise<void>;
+    /**
+     * Delete the Hub Template's backing item and set a flag
+     * indicating it's been destroyed
+     */
+    delete(): Promise<void>;
+}

package/dist/types/templates/_internal/TemplateBusinessRules.d.ts

@@ -0,0 +1,17 @@
+import { IFeatureFlags, IPermissionPolicy } from "../../permissions/types";
+/**
+ * Default features for a Template. These are the features
+ * that can be enabled / disabled by the entity owner
+ */
+export declare const TemplateDefaultFeatures: IFeatureFlags;
+/**
+ * @private
+ * Template permissions: these define the requirements
+ * any user must meet to perform related actions
+ */
+export declare const TemplatePermissions: readonly ["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 declare const TemplatePermissionPolicies: IPermissionPolicy[];

package/dist/types/templates/_internal/TemplateSchema.d.ts

@@ -0,0 +1,4 @@
+import { IConfigurationSchema } from "../../core";
+export declare type TemplateEditorType = (typeof TemplateEditorTypes)[number];
+export declare const TemplateEditorTypes: readonly ["hub:template:edit"];
+export declare const TemplateSchema: IConfigurationSchema;

package/dist/types/templates/_internal/TemplateUiSchemaEdit.d.ts

@@ -0,0 +1,15 @@
+import { IArcGISContext } from "../../ArcGISContext";
+import { IUiSchema } from "../../core/schemas/types";
+import { IHubTemplate } from "../../core/types/IHubTemplate";
+/**
+ * @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 declare const buildUiSchema: (i18nScope: string, entity: IHubTemplate, context: IArcGISContext) => Promise<IUiSchema>;

package/dist/types/templates/_internal/computeLinks.d.ts

@@ -0,0 +1,11 @@
+import { IItem } from "@esri/arcgis-rest-types";
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+import { IHubEntityLinks } from "../../core/types";
+/**
+ * Compute the links that get appended to a Hub Template
+ * search result and entity
+ *
+ * @param item
+ * @param requestOptions
+ */
+export declare function computeLinks(item: IItem, requestOptions: IRequestOptions): IHubEntityLinks;

package/dist/types/templates/_internal/computeProps.d.ts

@@ -0,0 +1,13 @@
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+import { IModel } from "../../types";
+import { IHubTemplate } from "../../core/types/IHubTemplate";
+/**
+ * @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 declare function computeProps(model: IModel, template: Partial<IHubTemplate>, requestOptions: IRequestOptions): IHubTemplate;

package/dist/types/templates/_internal/getPropertyMap.d.ts

@@ -0,0 +1,8 @@
+import { IPropertyMap } from "../../core/_internal/PropertyMapper";
+/**
+ * @private
+ * Returns an Array of IPropertyMap objects that
+ * define the projection of properties from an
+ * IModel to an IHubTemplate
+ */
+export declare function getPropertyMap(): IPropertyMap[];

package/dist/types/templates/defaults.d.ts

@@ -0,0 +1,14 @@
+import { IHubTemplate } from "../core/types/IHubTemplate";
+import { IModel } from "../types";
+/**
+ * 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 declare const HUB_TEMPLATE_ITEM_TYPE = "Solution";
+/** Default values for a new IHubTemplate */
+export declare const DEFAULT_TEMPLATE: Partial<IHubTemplate>;
+/** Default values for a new HubTemplate Model (backing item) */
+export declare const DEFAULT_TEMPLATE_MODEL: IModel;

package/dist/types/templates/edit.d.ts

@@ -0,0 +1,37 @@
+import { IUserRequestOptions } from "@esri/arcgis-rest-auth";
+import { IHubTemplate, IHubTemplateEditor } from "../core/types/IHubTemplate";
+import { IPortal } 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 declare function createTemplate(partialTemplate: Partial<IHubTemplate>, requestOptions: IUserRequestOptions): Promise<IHubTemplate>;
+/**
+ * @private
+ * Updates a Hub Template's backing item and returns
+ * the updated entity
+ * @param template
+ * @param requestOptions
+ */
+export declare function updateTemplate(template: IHubTemplate, requestOptions: IUserRequestOptions): Promise<IHubTemplate>;
+/**
+ * Convert an IHubTemplateEditor back into a IHubTemplate
+ * @param editor
+ * @param portal
+ */
+export declare function editorToTemplate(editor: IHubTemplateEditor, portal: IPortal): IHubTemplate;
+/**
+ * @private
+ * Remove a Hub Template's backing item
+ * @param id
+ * @param requestOptions
+ */
+export declare function deleteTemplate(id: string, requestOptions: IUserRequestOptions): Promise<void>;

package/dist/types/templates/fetch.d.ts

@@ -0,0 +1,28 @@
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+import { IHubTemplate } from "../core/types/IHubTemplate";
+import { IHubRequestOptions } from "../types";
+import { IItem } from "@esri/arcgis-rest-portal";
+import { IHubSearchResult } from "../search/types";
+/**
+ * @private
+ * Fetch a Hub Template backing item by id or slug
+ * @param identifier item id or slug
+ * @param requestOptions
+ */
+export declare function fetchTemplate(identifier: string, requestOptions: IRequestOptions): Promise<IHubTemplate>;
+/**
+ * @private
+ * Convert a Solution Item into a Hub Template, fetching
+ * any additional information that may be required
+ * @param item
+ * @param auth
+ */
+export declare function convertItemToTemplate(item: IItem, requestOptions: IRequestOptions): Promise<IHubTemplate>;
+/**
+ * @private
+ * Fetch template specific enrichments
+ * @param item
+ * @param include
+ * @param requestOptions
+ */
+export declare function enrichTemplateSearchResult(item: IItem, include: string[], requestOptions: IHubRequestOptions): Promise<IHubSearchResult>;

package/dist/types/templates/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./HubTemplate";
+export * from "./view";
+export * from "./fetch";
+export * from "./edit";

package/dist/types/templates/utils.d.ts

@@ -0,0 +1,13 @@
+import { IItem } from "@esri/arcgis-rest-types";
+/**
+ * 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 declare const getDeployedTemplateType: (template: IItem) => string;

package/dist/types/templates/view.d.ts

@@ -0,0 +1,19 @@
+import { IHubTemplate } from "../core/types/IHubTemplate";
+import { ResultToCardModelFn, EntityToCardModelFn } from "../core/types/IHubCardViewModel";
+/**
+ * Convert a template entity into a card view model that can
+ * be consumed by the suite of hub gallery components
+ *
+ * @param template template entity
+ * @param context auth & portal information
+ * @param opts view model options
+ */
+export declare const templateToCardModel: EntityToCardModelFn<IHubTemplate>;
+/**
+ * Convert a template hub search result into a card view model
+ * that can be consumed by the suite of hub gallery components
+ *
+ * @param searchResult hub template search result
+ * @param opts view model options
+ */
+export declare const templateResultToCardModel: ResultToCardModelFn;

package/dist/types/urls/getCardModelUrl.d.ts

@@ -3,7 +3,8 @@ import { HubEntity } from "../core/types/HubEntity";
 import { CardModelTarget } from "../core/types/IHubCardViewModel";
 import { IHubSearchResult } from "../search/types/IHubSearchResult";
 /**
- * returns a gallery card's title url from a hub search result
+ * given a target and hub search result, this util
+ * returns a gallery card's title url
  *
  * @param result hub search result
  * @param target context the card should redirect to
@@ -11,7 +12,8 @@ import { IHubSearchResult } from "../search/types/IHubSearchResult";
  */
 export declare function getCardModelUrlFromResult(result: IHubSearchResult, target: CardModelTarget, baseUrl?: string): string;
 /**
- * returns a gallery card's title url from an entity
+ * given a target and hub entity, this util
+ * returns a gallery card's title url
  *
  * @param entity hub entity
  * @param context auth & portal information

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esri/hub-common",
-  "version": "14.26.2",
+  "version": "14.27.0",
   "description": "Common TypeScript types and utility functions for @esri/hub.js.",
   "main": "dist/node/index.js",
   "module": "dist/esm/index.js",