@adobe/exc-app 1.0.2 → 1.0.4-beta2

package/RuntimeConfiguration.d.ts

@@ -114,10 +114,18 @@ export interface RuntimeConfiguration {
      * Solution iframe src url
      */
     baseFrameUrl: string;
+    /**
+     * Base path of the baseUrl property, without tenant or URL context.
+     */
+    basePath: string;
     /**
      * Base URL
      */
     baseUrl: string;
+    /**
+     * Environment specific CDN string.
+     */
+    cdn: string;
     /**
      * List all properties changed in this configuration compared to the previous one sent
      */

package/appapi.d.ts

@@ -74,6 +74,7 @@ export declare enum AppIds {
     MARKETO_ENGAGE = "marketo",
     OFFERS = "offers",
     PEOPLE = "people",
+    PERMISSIONS = "permissionsUI",
     PLACES_SERVICE = "places",
     PRIMETIME = "primetime",
     PRIVACY_UI = "privacyui",

package/appapi.js

@@ -80,6 +80,7 @@ var AppIds;
     AppIds["MARKETO_ENGAGE"] = "marketo";
     AppIds["OFFERS"] = "offers";
     AppIds["PEOPLE"] = "people";
+    AppIds["PERMISSIONS"] = "permissionsUI";
     AppIds["PLACES_SERVICE"] = "places";
     AppIds["PRIMETIME"] = "primetime";
     AppIds["PRIVACY_UI"] = "privacyui";

package/appapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"appapi.js","sourceRoot":"","sources":["appapi.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,yCAAqC;AAiCrC,0DAA0D;AAC1D,IAAY,MA8CX;AA9CD,WAAY,MAAM;IAChB,yBAAe,CAAA;IACf,wCAA8B,CAAA;IAC9B,oDAA0C,CAAA;IAC1C,iDAAuC,CAAA;IACvC,uCAA6B,CAAA;IAC7B,iCAAuB,CAAA;IACvB,2BAAiB,CAAA;IACjB,oCAA0B,CAAA;IAC1B,8CAAoC,CAAA;IACpC,6BAAmB,CAAA;IACnB,0BAAgB,CAAA;IAChB,yCAA+B,CAAA;IAC/B,0CAAgC,CAAA;IAChC,gEAAsD,CAAA;IACtD,0DAAgD,CAAA;IAChD,kDAAwC,CAAA;IACxC,kDAAwC,CAAA;IACxC,sCAA4B,CAAA;IAC5B,+BAAqB,CAAA;IACrB,sCAA4B,CAAA;IAC5B,oDAA0C,CAAA;IAC1C,kDAAwC,CAAA;IACxC,4DAAkD,CAAA;IAClD,gDAAsC,CAAA;IACtC,sDAA4C,CAAA;IAC5C,+BAAqB,CAAA;IACrB,wCAA8B,CAAA;IAC9B,4CAAkC,CAAA;IAClC,8CAAoC,CAAA;IACpC,wCAA8B,CAAA;IAC9B,kCAAwB,CAAA;IACxB,sCAA4B,CAAA;IAC5B,oCAA0B,CAAA;IAC1B,2BAAiB,CAAA;IACjB,2BAAiB,CAAA;IACjB,mCAAyB,CAAA;IACzB,iCAAuB,CAAA;IACvB,kCAAwB,CAAA;IACxB,0CAAgC,CAAA;IAChC,6CAAmC,CAAA;IACnC,qCAA2B,CAAA;IAC3B,wDAA8C,CAAA;IAC9C,wCAA8B,CAAA;IAC9B,2BAAiB,CAAA;IACjB,+BAAqB,CAAA;AACvB,CAAC,EA9CW,MAAM,GAAN,cAAM,KAAN,cAAM,QA8CjB;AAWD,MAAM,MAAM,GAAW;IACrB,GAAG,EAAE,MAAM,CAAC,EAAE;QACZ,OAAO,gBAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;CACF,CAAC;AAEF,kBAAe,MAAM,CAAC"}
+{"version":3,"file":"appapi.js","sourceRoot":"","sources":["appapi.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,yCAAqC;AAiCrC,0DAA0D;AAC1D,IAAY,MA+CX;AA/CD,WAAY,MAAM;IAChB,yBAAe,CAAA;IACf,wCAA8B,CAAA;IAC9B,oDAA0C,CAAA;IAC1C,iDAAuC,CAAA;IACvC,uCAA6B,CAAA;IAC7B,iCAAuB,CAAA;IACvB,2BAAiB,CAAA;IACjB,oCAA0B,CAAA;IAC1B,8CAAoC,CAAA;IACpC,6BAAmB,CAAA;IACnB,0BAAgB,CAAA;IAChB,yCAA+B,CAAA;IAC/B,0CAAgC,CAAA;IAChC,gEAAsD,CAAA;IACtD,0DAAgD,CAAA;IAChD,kDAAwC,CAAA;IACxC,kDAAwC,CAAA;IACxC,sCAA4B,CAAA;IAC5B,+BAAqB,CAAA;IACrB,sCAA4B,CAAA;IAC5B,oDAA0C,CAAA;IAC1C,kDAAwC,CAAA;IACxC,4DAAkD,CAAA;IAClD,gDAAsC,CAAA;IACtC,sDAA4C,CAAA;IAC5C,+BAAqB,CAAA;IACrB,wCAA8B,CAAA;IAC9B,4CAAkC,CAAA;IAClC,8CAAoC,CAAA;IACpC,wCAA8B,CAAA;IAC9B,kCAAwB,CAAA;IACxB,sCAA4B,CAAA;IAC5B,oCAA0B,CAAA;IAC1B,2BAAiB,CAAA;IACjB,2BAAiB,CAAA;IACjB,uCAA6B,CAAA;IAC7B,mCAAyB,CAAA;IACzB,iCAAuB,CAAA;IACvB,kCAAwB,CAAA;IACxB,0CAAgC,CAAA;IAChC,6CAAmC,CAAA;IACnC,qCAA2B,CAAA;IAC3B,wDAA8C,CAAA;IAC9C,wCAA8B,CAAA;IAC9B,2BAAiB,CAAA;IACjB,+BAAqB,CAAA;AACvB,CAAC,EA/CW,MAAM,GAAN,cAAM,KAAN,cAAM,QA+CjB;AAWD,MAAM,MAAM,GAAW;IACrB,GAAG,EAAE,MAAM,CAAC,EAAE;QACZ,OAAO,gBAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;CACF,CAAC;AAEF,kBAAe,MAAM,CAAC"}

package/cache.d.ts

@@ -0,0 +1,132 @@
+/*************************************************************************
+ * Copyright 2022 Adobe
+ * All Rights Reserved.
+ *
+ * NOTICE: Adobe permits you to use, modify, and distribute this file in
+ * accordance with the terms of the Adobe license agreement accompanying
+ * it. If you have received this file from a source other than Adobe,
+ * then your use, modification, or distribution of it requires the prior
+ * written permission of Adobe.
+ **************************************************************************/
+/**
+ * @ignore
+ */
+export declare enum CacheScope {
+    /**
+     * Default - Same as USER
+     */
+    DEFAULT = "user",
+    /**
+     * Cache data at the IMS Org level.
+     */
+    ORG = "org",
+    /**
+     * Cache data at the AEP Sandbox level.
+     */
+    SANDBOX = "sandbox",
+    /**
+     * Cache data at the Sub Org level.
+     */
+    SUBORG = "suborg",
+    /**
+     * Cache data at the user level.
+     */
+    USER = "user"
+}
+/**
+ * @ignore
+ */
+export declare enum CacheTTL {
+    /**
+     * Disable caching for this value.
+     */
+    DONT_CACHE = 0,
+    /**
+     * Cache data for the duration of the current IMS session only
+     * Data will not be available once the user has logged in again.
+     */
+    IMS_SESSION = -1,
+    /**
+     * Default - One week
+     */
+    DEFAULT = 604800,
+    /**
+     * Cache data for an hour.
+     */
+    HOUR = 3600,
+    /**
+     * Cache data for a day.
+     */
+    DAY = 86400,
+    /**
+     * Cache data for a week.
+     */
+    WEEK = 604800,
+    /**
+     * Cache data for a month (30 days actual).
+     */
+    MONTH = 2592000
+}
+export declare type CacheExpiry = CacheTTL | number;
+/**
+ * Input parameters for the Cache get and delete APIs.
+ */
+export interface CacheParameters {
+    /**
+     * Cache key.
+     */
+    key: string;
+    /**
+     * Cache scope (Optional - Defaults to user).
+     */
+    scope?: CacheScope;
+}
+/**
+ * Input parameters for the Cache set API.
+ */
+export interface CacheSetParameters<T> extends CacheParameters {
+    /**
+     * Cache expiry. Can be one of the set values defined by CacheTTL, or a numeric cache ttl (in seconds).
+     * Optional - Defaults to one week.
+     */
+    expiry?: CacheExpiry;
+    /**
+     * Data to cache. Data must be serializable (JSON).
+     */
+    value: T;
+}
+/**
+ * Cache entry (Returned by the get API).
+ */
+export declare type CacheEntry<T> = {
+    createdAt: number;
+    key: string;
+    value: T;
+} & ({
+    expiresAt: number;
+} | {
+    expireBySession: true;
+});
+/**
+ * APIs for managing a client side persisted cache.
+ */
+export interface CacheApi {
+    /**
+     * Deletes a value from the cache (If available).
+     * @param params Parameters used to identify the cached item to delete.
+     */
+    delete(params: CacheParameters): Promise<void>;
+    /**
+     * Gets a value from the cache if one is available.
+     * @param params Parameters used to identify the cached item to retrieve.
+     * @returns A promise that resolves to the specified value, or undefined if none exist.
+     */
+    get<T>(params: CacheParameters): Promise<CacheEntry<T> | undefined>;
+    /**
+     * Stores a value in the cache.
+     * @param params Parameters used to identify the cached item to store and control its TTL.
+     */
+    set<T>(params: CacheSetParameters<T>): Promise<void>;
+}
+declare const cache: CacheApi;
+export default cache;

package/cache.js

@@ -0,0 +1,132 @@
+"use strict";
+/*************************************************************************
+ * Copyright 2022 Adobe
+ * All Rights Reserved.
+ *
+ * NOTICE: Adobe permits you to use, modify, and distribute this file in
+ * accordance with the terms of the Adobe license agreement accompanying
+ * it. If you have received this file from a source other than Adobe,
+ * then your use, modification, or distribution of it requires the prior
+ * written permission of Adobe.
+ **************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheTTL = exports.CacheScope = void 0;
+/**
+ * APIs for managing a client side persisted cache.
+ * Unified Shell will store the data against its own domain, which allows data caching
+ * even when the actual app runs on a domain which is 3rd party to Unified Shell's.
+ *
+ * For example, the API will work in Chrome incognito when Unified Shell runs on an adobe.com domain
+ * and the embedded applications run on the adobe.net domain.
+ *
+ * These APIs utilizes the [Browser Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache) under the hood and are all run asynchronously.
+ *
+ * If migrating from Local Storage to Cache API, make sure all the app logic is async first.
+ *
+ * NOTE: This API should not be used to cache any PII data to comply with Adobe privacy policies.
+ *
+ * To consume this API, add the following import to your code.
+ *
+ * ```typescript
+ * import cache from '@adobe/exc-app/cache';
+ * ```
+ *
+ * The default export is an object of type [CacheAPI](../interfaces/_cache_.cacheapi.md)
+ *
+ * API reference: [scroll down](#index)
+ *
+ * ### Sample code
+ *
+ * ```typescript
+ * import cache, {CacheTTL, CacheScope} from '@adobe/exc-app/cache';
+ *
+ * // By default, cached data is tied to the user and cached for a week.
+ * await cache.set<MyType>({key: 'some-cache-key', value: myTypeInstance});
+ *
+ * // Both scope and expiry can be adjusted.
+ * await cache.set<MyType>({key: 'some-cache-key', value: myTypeInstance, expiry: CacheTTL.DAY, scope: CacheScope.ORG});
+ *
+ * // It is also possible to bind cache data to the current IMS session, it will expire when the user logs out.
+ * await cache.set<MyType>({key: 'some-cache-key', value: myTypeInstance, expiry: CacheTTL.IMS_SESSION});
+ *
+ * // Cache get
+ * const myData: MyType = await cache.get<MyType>({key: 'some-cache-key'});
+ *
+ * // Get scope must be identical to the scope used for set - Always use the same scope for both.
+ * const myData2: MyType = await cache.get<MyType>({key: 'some-cache-key', scope: CacheScope.ORG});
+ *
+ * // Cache delete.
+ * await cache.delete({key: 'some-cache-key'});
+ * ```
+ * @packageDocumentation
+ * @module cache
+ */
+const Global_1 = require("./src/Global");
+/**
+ * @ignore
+ */
+var CacheScope;
+(function (CacheScope) {
+    /**
+     * Default - Same as USER
+     */
+    CacheScope["DEFAULT"] = "user";
+    /**
+     * Cache data at the IMS Org level.
+     */
+    CacheScope["ORG"] = "org";
+    /**
+     * Cache data at the AEP Sandbox level.
+     */
+    CacheScope["SANDBOX"] = "sandbox";
+    /**
+     * Cache data at the Sub Org level.
+     */
+    CacheScope["SUBORG"] = "suborg";
+    /**
+     * Cache data at the user level.
+     */
+    CacheScope["USER"] = "user";
+})(CacheScope = exports.CacheScope || (exports.CacheScope = {}));
+/**
+ * @ignore
+ */
+var CacheTTL;
+(function (CacheTTL) {
+    /**
+     * Disable caching for this value.
+     */
+    CacheTTL[CacheTTL["DONT_CACHE"] = 0] = "DONT_CACHE";
+    /**
+     * Cache data for the duration of the current IMS session only
+     * Data will not be available once the user has logged in again.
+     */
+    CacheTTL[CacheTTL["IMS_SESSION"] = -1] = "IMS_SESSION";
+    /**
+     * Default - One week
+     */
+    CacheTTL[CacheTTL["DEFAULT"] = 604800] = "DEFAULT";
+    /**
+     * Cache data for an hour.
+     */
+    CacheTTL[CacheTTL["HOUR"] = 3600] = "HOUR";
+    /**
+     * Cache data for a day.
+     */
+    CacheTTL[CacheTTL["DAY"] = 86400] = "DAY";
+    /**
+     * Cache data for a week.
+     */
+    CacheTTL[CacheTTL["WEEK"] = 604800] = "WEEK";
+    /**
+     * Cache data for a month (30 days actual).
+     */
+    CacheTTL[CacheTTL["MONTH"] = 2592000] = "MONTH";
+})(CacheTTL = exports.CacheTTL || (exports.CacheTTL = {}));
+const cache = {
+    delete: params => Global_1.getImpl('cache')().delete(params),
+    get: params => Global_1.getImpl('cache')().get(params),
+    set: params => Global_1.getImpl('cache')().set(params)
+};
+exports.default = cache;
+//# sourceMappingURL=cache.js.map

package/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["cache.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,yCAAqC;AAErC;;GAEG;AACH,IAAY,UAqBX;AArBD,WAAY,UAAU;IACpB;;OAEG;IACH,8BAAgB,CAAA;IAChB;;OAEG;IACH,yBAAW,CAAA;IACX;;OAEG;IACH,iCAAmB,CAAA;IACnB;;OAEG;IACH,+BAAiB,CAAA;IACjB;;OAEG;IACH,2BAAa,CAAA;AACf,CAAC,EArBW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAqBrB;AAED;;GAEG;AACH,IAAY,QA8BX;AA9BD,WAAY,QAAQ;IAClB;;OAEG;IACH,mDAAc,CAAA;IACd;;;OAGG;IACH,sDAAgB,CAAA;IAChB;;OAEG;IACH,kDAAuB,CAAA;IACvB;;OAEG;IACH,0CAAW,CAAA;IACX;;OAEG;IACH,yCAAe,CAAA;IACf;;OAEG;IACH,4CAAoB,CAAA;IACpB;;OAEG;IACH,+CAAsB,CAAA;AACxB,CAAC,EA9BW,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QA8BnB;AAiED,MAAM,KAAK,GAAa;IACtB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,gBAAO,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,gBAAO,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,gBAAO,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;CAC9C,CAAC;AAEF,kBAAe,KAAK,CAAC"}

package/capabilityapi.d.ts

@@ -61,6 +61,7 @@ export declare enum CapabilityNames {
     SETTINGS = "Channels",
     SOURCE = "Sources",
     SUBSCRIPTIONS = "Subscription list",
+    UNIFIEDTAGS = "UnifiedTags",
     WORKFLOW = "Workflows"
 }
 export declare enum CapabilityIds {
@@ -106,6 +107,7 @@ export declare enum CapabilityIds {
     SETTINGS = "settings",
     SOURCE = "source",
     SUBSCRIPTIONS = "subscriptions",
+    UNIFIEDTAGS = "unifiedTags",
     WORKFLOW = "workflow"
 }
 export interface CapabilityApi {

package/capabilityapi.js

@@ -87,6 +87,7 @@ var CapabilityNames;
     CapabilityNames["SETTINGS"] = "Channels";
     CapabilityNames["SOURCE"] = "Sources";
     CapabilityNames["SUBSCRIPTIONS"] = "Subscription list";
+    CapabilityNames["UNIFIEDTAGS"] = "UnifiedTags";
     CapabilityNames["WORKFLOW"] = "Workflows";
 })(CapabilityNames = exports.CapabilityNames || (exports.CapabilityNames = {}));
 // This list is dynamically generated in preBuild
@@ -134,6 +135,7 @@ var CapabilityIds;
     CapabilityIds["SETTINGS"] = "settings";
     CapabilityIds["SOURCE"] = "source";
     CapabilityIds["SUBSCRIPTIONS"] = "subscriptions";
+    CapabilityIds["UNIFIEDTAGS"] = "unifiedTags";
     CapabilityIds["WORKFLOW"] = "workflow";
 })(CapabilityIds = exports.CapabilityIds || (exports.CapabilityIds = {}));
 const capabilityapi = {

package/capabilityapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilityapi.js","sourceRoot":"","sources":["capabilityapi.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,yCAAqC;AAarC,iDAAiD;AACjD,IAAY,eA4CX;AA5CD,WAAY,eAAe;IACzB,8CAA2B,CAAA;IAC3B,2CAAwB,CAAA;IACxB,mCAAgB,CAAA;IAChB,2DAAwC,CAAA;IACxC,gDAA6B,CAAA;IAC7B,+CAA4B,CAAA;IAC5B,oCAAiB,CAAA;IACjB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,yCAAsB,CAAA;IACtB,2CAAwB,CAAA;IACxB,yCAAsB,CAAA;IACtB,uCAAoB,CAAA;IACpB,8CAA2B,CAAA;IAC3B,yDAAsC,CAAA;IACtC,+CAA4B,CAAA;IAC5B,gCAAa,CAAA;IACb,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,wCAAqB,CAAA;IACrB,iDAA8B,CAAA;IAC9B,iDAA8B,CAAA;IAC9B,wCAAqB,CAAA;IACrB,mCAAgB,CAAA;IAChB,4CAAyB,CAAA;IACzB,yCAAsB,CAAA;IACtB,mCAAgB,CAAA;IAChB,+CAA4B,CAAA;IAC5B,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,uCAAoB,CAAA;IACpB,oCAAiB,CAAA;IACjB,uCAAoB,CAAA;IACpB,wCAAqB,CAAA;IACrB,qCAAkB,CAAA;IAClB,uCAAoB,CAAA;IACpB,wDAAqC,CAAA;IACrC,uCAAoB,CAAA;IACpB,wCAAqB,CAAA;IACrB,qCAAkB,CAAA;IAClB,sDAAmC,CAAA;IACnC,yCAAsB,CAAA;AACxB,CAAC,EA5CW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QA4C1B;AAED,iDAAiD;AACjD,IAAY,aA4CX;AA5CD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,wDAAuC,CAAA;IACvC,8CAA6B,CAAA;IAC7B,4CAA2B,CAAA;IAC3B,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IACvB,sDAAqC,CAAA;IACrC,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAC7B,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAC3B,8BAAa,CAAA;IACb,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,gDAA+B,CAAA;IAC/B,kCAAiB,CAAA;IACjB,8CAA6B,CAAA;IAC7B,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,sDAAqC,CAAA;IACrC,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;AACvB,CAAC,EA5CW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QA4CxB;AAUD,MAAM,aAAa,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC,EAAE;QACZ,OAAO,gBAAO,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;CACe,CAAC;AAEnB,kBAAe,aAAa,CAAC"}
+{"version":3,"file":"capabilityapi.js","sourceRoot":"","sources":["capabilityapi.ts"],"names":[],"mappings":";AAAA;;;;;;;;;4EAS4E;;;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,yCAAqC;AAarC,iDAAiD;AACjD,IAAY,eA6CX;AA7CD,WAAY,eAAe;IACzB,8CAA2B,CAAA;IAC3B,2CAAwB,CAAA;IACxB,mCAAgB,CAAA;IAChB,2DAAwC,CAAA;IACxC,gDAA6B,CAAA;IAC7B,+CAA4B,CAAA;IAC5B,oCAAiB,CAAA;IACjB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,yCAAsB,CAAA;IACtB,2CAAwB,CAAA;IACxB,yCAAsB,CAAA;IACtB,uCAAoB,CAAA;IACpB,8CAA2B,CAAA;IAC3B,yDAAsC,CAAA;IACtC,+CAA4B,CAAA;IAC5B,gCAAa,CAAA;IACb,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,wCAAqB,CAAA;IACrB,iDAA8B,CAAA;IAC9B,iDAA8B,CAAA;IAC9B,wCAAqB,CAAA;IACrB,mCAAgB,CAAA;IAChB,4CAAyB,CAAA;IACzB,yCAAsB,CAAA;IACtB,mCAAgB,CAAA;IAChB,+CAA4B,CAAA;IAC5B,sCAAmB,CAAA;IACnB,0CAAuB,CAAA;IACvB,uCAAoB,CAAA;IACpB,oCAAiB,CAAA;IACjB,uCAAoB,CAAA;IACpB,wCAAqB,CAAA;IACrB,qCAAkB,CAAA;IAClB,uCAAoB,CAAA;IACpB,wDAAqC,CAAA;IACrC,uCAAoB,CAAA;IACpB,wCAAqB,CAAA;IACrB,qCAAkB,CAAA;IAClB,sDAAmC,CAAA;IACnC,8CAA2B,CAAA;IAC3B,yCAAsB,CAAA;AACxB,CAAC,EA7CW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QA6C1B;AAED,iDAAiD;AACjD,IAAY,aA6CX;AA7CD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,wDAAuC,CAAA;IACvC,8CAA6B,CAAA;IAC7B,4CAA2B,CAAA;IAC3B,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IACvB,sDAAqC,CAAA;IACrC,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAC7B,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,oDAAmC,CAAA;IACnC,4CAA2B,CAAA;IAC3B,8BAAa,CAAA;IACb,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;IACf,gDAA+B,CAAA;IAC/B,kCAAiB,CAAA;IACjB,8CAA6B,CAAA;IAC7B,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,sDAAqC,CAAA;IACrC,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,gDAA+B,CAAA;IAC/B,4CAA2B,CAAA;IAC3B,sCAAqB,CAAA;AACvB,CAAC,EA7CW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QA6CxB;AAUD,MAAM,aAAa,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC,EAAE;QACZ,OAAO,gBAAO,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;CACe,CAAC;AAEnB,kBAAe,aAAa,CAAC"}

package/docs/README.md

@@ -9,6 +9,7 @@
 ### Modules
 
 * [appapi](modules/appapi.md)
+* [cache](modules/cache.md)
 * [capabilityapi](modules/capabilityapi.md)
 * [helpCenter](modules/helpcenter.md)
 * [ims](modules/ims.md)

package/docs/enums/capabilityapi.capabilityids.md

@@ -50,6 +50,7 @@
 * [SETTINGS](capabilityapi.capabilityids.md#settings)
 * [SOURCE](capabilityapi.capabilityids.md#source)
 * [SUBSCRIPTIONS](capabilityapi.capabilityids.md#subscriptions)
+* [UNIFIEDTAGS](capabilityapi.capabilityids.md#unifiedtags)
 * [WORKFLOW](capabilityapi.capabilityids.md#workflow)
 
 ## Enumeration members
@@ -306,6 +307,12 @@ ___
 
 ___
 
+### UNIFIEDTAGS
+
+•  **UNIFIEDTAGS**:  = "unifiedTags"
+
+___
+
 ### WORKFLOW
 
 •  **WORKFLOW**:  = "workflow"

package/docs/enums/capabilityapi.capabilitynames.md

@@ -50,6 +50,7 @@
 * [SETTINGS](capabilityapi.capabilitynames.md#settings)
 * [SOURCE](capabilityapi.capabilitynames.md#source)
 * [SUBSCRIPTIONS](capabilityapi.capabilitynames.md#subscriptions)
+* [UNIFIEDTAGS](capabilityapi.capabilitynames.md#unifiedtags)
 * [WORKFLOW](capabilityapi.capabilitynames.md#workflow)
 
 ## Enumeration members
@@ -306,6 +307,12 @@ ___
 
 ___
 
+### UNIFIEDTAGS
+
+•  **UNIFIEDTAGS**:  = "UnifiedTags"
+
+___
+
 ### WORKFLOW
 
 •  **WORKFLOW**:  = "Workflows"

package/docs/interfaces/cache.cacheapi.md

@@ -0,0 +1,81 @@
+**[@adobe/exc-app](../README.md)**
+
+> [Globals](../README.md) / [cache](../modules/cache.md) / CacheApi
+
+# Interface: CacheApi
+
+APIs for managing a client side persisted cache.
+
+## Hierarchy
+
+* **CacheApi**
+
+## Index
+
+### Methods
+
+* [delete](cache.cacheapi.md#delete)
+* [get](cache.cacheapi.md#get)
+* [set](cache.cacheapi.md#set)
+
+## Methods
+
+### delete
+
+▸ **delete**(`params`: [CacheParameters](cache.cacheparameters.md)): Promise<void\>
+
+Deletes a value from the cache (If available).
+
+#### Parameters:
+
+Name | Type | Description |
+------ | ------ | ------ |
+`params` | [CacheParameters](cache.cacheparameters.md) | Parameters used to identify the cached item to delete.  |
+
+**Returns:** Promise<void\>
+
+___
+
+### get
+
+▸ **get**<T\>(`params`: [CacheParameters](cache.cacheparameters.md)): Promise<[CacheEntry](../modules/cache.md#cacheentry)<T\> \| undefined\>
+
+Gets a value from the cache if one is available.
+
+#### Type parameters:
+
+Name |
+------ |
+`T` |
+
+#### Parameters:
+
+Name | Type | Description |
+------ | ------ | ------ |
+`params` | [CacheParameters](cache.cacheparameters.md) | Parameters used to identify the cached item to retrieve. |
+
+**Returns:** Promise<[CacheEntry](../modules/cache.md#cacheentry)<T\> \| undefined\>
+
+A promise that resolves to the specified value, or undefined if none exist.
+
+___
+
+### set
+
+▸ **set**<T\>(`params`: [CacheSetParameters](cache.cachesetparameters.md)<T\>): Promise<void\>
+
+Stores a value in the cache.
+
+#### Type parameters:
+
+Name |
+------ |
+`T` |
+
+#### Parameters:
+
+Name | Type | Description |
+------ | ------ | ------ |
+`params` | [CacheSetParameters](cache.cachesetparameters.md)<T\> | Parameters used to identify the cached item to store and control its TTL.  |
+
+**Returns:** Promise<void\>

package/docs/interfaces/cache.cacheparameters.md

@@ -0,0 +1,36 @@
+**[@adobe/exc-app](../README.md)**
+
+> [Globals](../README.md) / [cache](../modules/cache.md) / CacheParameters
+
+# Interface: CacheParameters
+
+Input parameters for the Cache get and delete APIs.
+
+## Hierarchy
+
+* **CacheParameters**
+
+  ↳ [CacheSetParameters](cache.cachesetparameters.md)
+
+## Index
+
+### Properties
+
+* [key](cache.cacheparameters.md#key)
+* [scope](cache.cacheparameters.md#scope)
+
+## Properties
+
+### key
+
+•  **key**: string
+
+Cache key.
+
+___
+
+### scope
+
+• `Optional` **scope**: CacheScope
+
+Cache scope (Optional - Defaults to user).

package/docs/interfaces/cache.cachesetparameters.md

@@ -0,0 +1,65 @@
+**[@adobe/exc-app](../README.md)**
+
+> [Globals](../README.md) / [cache](../modules/cache.md) / CacheSetParameters
+
+# Interface: CacheSetParameters<T\>
+
+Input parameters for the Cache set API.
+
+## Type parameters
+
+Name |
+------ |
+`T` |
+
+## Hierarchy
+
+* [CacheParameters](cache.cacheparameters.md)
+
+  ↳ **CacheSetParameters**
+
+## Index
+
+### Properties
+
+* [expiry](cache.cachesetparameters.md#expiry)
+* [key](cache.cachesetparameters.md#key)
+* [scope](cache.cachesetparameters.md#scope)
+* [value](cache.cachesetparameters.md#value)
+
+## Properties
+
+### expiry
+
+• `Optional` **expiry**: [CacheExpiry](../modules/cache.md#cacheexpiry)
+
+Cache expiry. Can be one of the set values defined by CacheTTL, or a numeric cache ttl (in seconds).
+Optional - Defaults to one week.
+
+___
+
+### key
+
+•  **key**: string
+
+*Inherited from [CacheParameters](cache.cacheparameters.md).[key](cache.cacheparameters.md#key)*
+
+Cache key.
+
+___
+
+### scope
+
+• `Optional` **scope**: CacheScope
+
+*Inherited from [CacheParameters](cache.cacheparameters.md).[scope](cache.cacheparameters.md#scope)*
+
+Cache scope (Optional - Defaults to user).
+
+___
+
+### value
+
+•  **value**: T
+
+Data to cache. Data must be serializable (JSON).

package/docs/interfaces/network.apolloclientoptions.md

@@ -15,6 +15,7 @@
 * [cacheOptions](network.apolloclientoptions.md#cacheoptions)
 * [connectToDevTools](network.apolloclientoptions.md#connecttodevtools)
 * [inputApolloLink](network.apolloclientoptions.md#inputapollolink)
+* [xql](network.apolloclientoptions.md#xql)
 
 ## Properties
 
@@ -33,3 +34,9 @@ ___
 ### inputApolloLink
 
 • `Optional` **inputApolloLink**: ApolloLink
+
+___
+
+### xql
+
+• `Optional` **xql**: undefined \| false \| true

package/docs/interfaces/root.modules.md

@@ -13,6 +13,7 @@
 ### Properties
 
 * [appApi](root.modules.md#appapi)
+* [cache](root.modules.md#cache)
 * [capabilityApi](root.modules.md#capabilityapi)
 * [default](root.modules.md#default)
 * [helpCenter](root.modules.md#helpcenter)
@@ -42,6 +43,12 @@
 
 ___
 
+### cache
+
+• `Readonly` **cache**: () => [CacheApi](cache.cacheapi.md)
+
+___
+
 ### capabilityApi
 
 • `Readonly` **capabilityApi**: () => [CapabilityApi](capabilityapi.capabilityapi-1.md)

package/docs/interfaces/root.runtimeconfiguration.md

@@ -19,6 +19,7 @@ External Runtime Configuration Interface
 * [appContainer](root.runtimeconfiguration.md#appcontainer)
 * [appId](root.runtimeconfiguration.md#appid)
 * [baseFrameUrl](root.runtimeconfiguration.md#baseframeurl)
+* [basePath](root.runtimeconfiguration.md#basepath)
 * [baseUrl](root.runtimeconfiguration.md#baseurl)
 * [changedProperties](root.runtimeconfiguration.md#changedproperties)
 * [discovery](root.runtimeconfiguration.md#discovery)
@@ -100,6 +101,14 @@ Solution iframe src url
 
 ___
 
+### basePath
+
+•  **basePath**: string
+
+Base path of the baseUrl property, without tenant or URL context.
+
+___
+
 ### baseUrl
 
 •  **baseUrl**: string