@shopify/app-bridge-react 2.0.24 → 2.0.25

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.25](https://github.com/Shopify/app-bridge/compare/v2.0.24...v2.0.25) (2022-04-20)
+
+
+### Bug Fixes
+
+* **app-bridge-react:** prevent Resource Picker from sending unecessary updates ([62abe7f](https://github.com/Shopify/app-bridge/commit/62abe7f4116bf4c78934b8eb86e9a74fc0ea03d5))
+* refactor useFeaturesAvailable to always return state ([2634016](https://github.com/Shopify/app-bridge/commit/2634016ccc9b883dd979c82585833b0fdf73d6d0))
+* **app-bridge-react:** ensure useAppState only modifies the state when it has actually changed ([0a2f017](https://github.com/Shopify/app-bridge/commit/0a2f017c35e7d5dda8642eb68801d25158cb7539))
+
+
+### Features
+
+* Add optional router prop to Provider ([4d032b1](https://github.com/Shopify/app-bridge/commit/4d032b1e0cc940ab02a07339ed48cc23e21e26ae))
+* **app-bridge-react:** add useFeatureRequest hook ([adc03c9](https://github.com/Shopify/app-bridge/commit/adc03c9c4d1b2b9e3a2ea44a9ed2eaf4b75b99bf))
+* useFeature hook, refactor React playground ([e1b7c71](https://github.com/Shopify/app-bridge/commit/e1b7c71a4e3f3fb3a6b0373ea6aedc05a34baaea))
+
+
+
+
+
 ## [2.0.24](https://github.com/Shopify/app-bridge/compare/v2.0.23...v2.0.24) (2022-04-08)
 
 

package/components/Provider/Provider.d.ts

@@ -1,5 +1,7 @@
-import React from 'react';
+import React, { PropsWithChildren } from 'react';
 import type { AppConfigV2, DispatchActionHook } from '@shopify/app-bridge/client';
+import type { History } from '../ClientRouter';
+import type { LocationOrHref } from '../RoutePropagator';
 /**
  * Provider props
  *
@@ -10,26 +12,70 @@ export interface Props {
     config: AppConfigV2;
     /** The child elements to render. */
     children?: React.ReactNode;
+    /**
+     * Option to set up client routing and route propagation automatically.
+     * Passing in a router will allow you to bypass setting these
+     * utilities up yourself.
+     *
+     * If you are using React Router, ensure that the Provider is a child
+     * of the router component. For example:
+     *
+     * import {useMemo} from 'react';
+     * import {useLocation, useNavigate, BrowserRouter} from 'react-router-dom';
+     * import {Provider} from '@shopify/app-bridge-react';
+     * import Routes from './Routes';
+     *
+     * export function App() {
+     *   const navigate = useNavigate();
+     *   const location = useLocation();
+     *   const history = useMemo(
+     *     () => ({replace: (path: string) => navigate(path, {replace: true})}),
+     *     [navigate],
+     *   );
+     *   const router = useMemo(
+     *     () => ({
+     *       location,
+     *       history,
+     *     }),
+     *     [location, navigate],
+     *   );
+     *   return (
+     *     <Provider
+     *       apiKey={{
+     *         apiKey: 'API key from Shopify Partner Dashboard',
+     *         host: host,
+     *       }}
+     *       router={router}
+     *     >
+     *       <Routes />
+     *     </Provider>
+     *   );
+     * }
+     *
+     * export default function AppWrapper() {
+     *   return (
+     *     <BrowserRouter>
+     *       <App />
+     *     </BrowserRouter>
+     *   );
+     * }
+     */
+    router?: {
+        location: LocationOrHref;
+        history: History;
+    };
 }
 /**
  * Create an App Bridge client application from a config and pass it as the
  * value to the context provider.
  *
- * @remarks
- * You'll probably want something a little more robust than storing the current
- * app instance in a module-level global.
- *
  * @public
  */
-declare class Provider extends React.Component<Props> {
-    private app;
-    private get appInstance();
-    render(): JSX.Element;
-}
-export default Provider;
+declare function Provider({ config, router, children }: PropsWithChildren<Props>): JSX.Element;
 /**
  * Augment actions with clientInterface metadata, identifying use of this library
  *
  * @internal
  */
 export declare const setClientInterfaceHook: DispatchActionHook;
+export default Provider;

package/components/Provider/Provider.js

@@ -1,19 +1,4 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
@@ -33,52 +18,34 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setClientInterfaceHook = void 0;
-var react_1 = __importDefault(require("react"));
+var react_1 = __importStar(require("react"));
 var app_bridge_1 = __importStar(require("@shopify/app-bridge"));
 var context_1 = require("../../context");
+var ClientRouter_1 = require("../ClientRouter");
+var RoutePropagator_1 = require("../RoutePropagator");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 var packageJson = require('../../package.json');
 /**
  * Create an App Bridge client application from a config and pass it as the
  * value to the context provider.
  *
- * @remarks
- * You'll probably want something a little more robust than storing the current
- * app instance in a module-level global.
- *
  * @public
  */
-var Provider = /** @class */ (function (_super) {
-    __extends(Provider, _super);
-    function Provider() {
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.app = _this.appInstance;
-        return _this;
-    }
-    Object.defineProperty(Provider.prototype, "appInstance", {
-        get: function () {
-            if (!this.app) {
-                this.app = app_bridge_1.default(this.props.config);
-                if (this.app && this.app.hooks) {
-                    this.app.hooks.set(app_bridge_1.LifecycleHook.DispatchAction, exports.setClientInterfaceHook);
-                }
-            }
-            return this.app;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Provider.prototype.render = function () {
-        return (react_1.default.createElement(context_1.AppBridgeContext.Provider, { value: this.appInstance }, this.props.children));
-    };
-    return Provider;
-}(react_1.default.Component));
-exports.default = Provider;
+function Provider(_a) {
+    var config = _a.config, router = _a.router, children = _a.children;
+    var app = react_1.useMemo(function () { return app_bridge_1.default(config); }, [JSON.stringify(config)]);
+    react_1.useEffect(function () {
+        if (app === null || app === void 0 ? void 0 : app.hooks) {
+            app.hooks.set(app_bridge_1.LifecycleHook.DispatchAction, exports.setClientInterfaceHook);
+        }
+    }, [app]);
+    var routerMarkup = (router === null || router === void 0 ? void 0 : router.history) && (router === null || router === void 0 ? void 0 : router.location) ? (react_1.default.createElement(Router, { history: router.history, location: router.location })) : null;
+    return (react_1.default.createElement(context_1.AppBridgeContext.Provider, { value: app },
+        routerMarkup,
+        children));
+}
 /**
  * Augment actions with clientInterface metadata, identifying use of this library
  *
@@ -94,3 +61,10 @@ var setClientInterfaceHook = function (next) {
     };
 };
 exports.setClientInterfaceHook = setClientInterfaceHook;
+function Router(_a) {
+    var history = _a.history, location = _a.location;
+    ClientRouter_1.useClientRouting(history);
+    RoutePropagator_1.useRoutePropagation(location);
+    return null;
+}
+exports.default = Provider;

package/components/ResourcePicker/ResourcePicker.d.ts

@@ -1,11 +1,10 @@
-import React from 'react';
-import { ResourcePicker as AppBridgeResourcePicker } from '@shopify/app-bridge/actions';
-import { BaseResource } from '@shopify/app-bridge/actions/ResourcePicker';
+import { ActionVerb, ResourceType } from '@shopify/app-bridge/actions/ResourcePicker';
+import type { BaseResource, Options, ResourceSelection, ProductOptions } from '@shopify/app-bridge/actions/ResourcePicker';
 export interface SelectPayload {
     /** The selected resources
      * @see {@link https://help.shopify.com/en/api/embedded-apps/app-bridge/actions/resourcepicker|resource picker documentation} for more information
      */
-    selection: AppBridgeResourcePicker.ResourceSelection[];
+    selection: ResourceSelection[];
 }
 interface BaseProps {
     /** Whether the picker is open or not */
@@ -26,7 +25,7 @@ interface BaseProps {
     /** Whether to allow selection of multiple items, or the maximum number of selected items */
     selectMultiple?: boolean | number;
     /** Override default action verb `Add`. The actionVerb appears in the title `<actionVerb>` `<resourceType>` and as the primary action of the resource picker. */
-    actionVerb?: AppBridgeResourcePicker.ActionVerb;
+    actionVerb?: ActionVerb;
     /** Callback when a selection has been made */
     onSelection?(selectPayload: SelectPayload): void;
     /** Callback when the picker is closed without selection */
@@ -63,15 +62,7 @@ export declare type Props = ProductPickerProps | ProductVariantProps | Collectio
  *
  * @public
  */
-declare class ResourcePicker extends React.PureComponent<Props, never> {
-    static contextType: React.Context<import("../../context").IAppBridgeContext>;
-    static ActionVerb: typeof AppBridgeResourcePicker.ActionVerb;
-    private focusReturnPoint;
-    private picker;
-    componentDidMount(): void;
-    componentDidUpdate(prevProps: Props): void;
-    componentWillUnmount(): void;
-    render(): null;
-    getActionOptions(): AppBridgeResourcePicker.Options | AppBridgeResourcePicker.ProductOptions;
-}
+declare function ResourcePicker(props: Props): null;
 export default ResourcePicker;
+export type { BaseResource, Options, ProductOptions };
+export { ActionVerb, ResourceType };

package/components/ResourcePicker/ResourcePicker.js

@@ -1,19 +1,4 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 var __assign = (this && this.__assign) || function () {
     __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
@@ -25,13 +10,13 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = __importDefault(require("react"));
-var actions_1 = require("@shopify/app-bridge/actions");
-var context_1 = require("../../context");
+exports.ResourceType = exports.ActionVerb = void 0;
+var react_1 = require("react");
+var ResourcePicker_1 = require("@shopify/app-bridge/actions/ResourcePicker");
+Object.defineProperty(exports, "ActionVerb", { enumerable: true, get: function () { return ResourcePicker_1.ActionVerb; } });
+Object.defineProperty(exports, "ResourceType", { enumerable: true, get: function () { return ResourcePicker_1.ResourceType; } });
+var useAppBridge_1 = require("../../useAppBridge");
 /**
  * ResourcePicker component
  *
@@ -40,92 +25,90 @@ var context_1 = require("../../context");
  *
  * @public
  */
-var ResourcePicker = /** @class */ (function (_super) {
-    __extends(ResourcePicker, _super);
-    function ResourcePicker() {
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.focusReturnPoint = null;
-        return _this;
-    }
-    ResourcePicker.prototype.componentDidMount = function () {
-        var _a = this.props, open = _a.open, resourceType = _a.resourceType, onSelection = _a.onSelection, onCancel = _a.onCancel;
-        var app = this.context;
-        this.picker = actions_1.ResourcePicker.create(app, {
-            resourceType: actions_1.ResourcePicker.ResourceType[resourceType],
-            options: this.getActionOptions(),
+function ResourcePicker(props) {
+    var app = useAppBridge_1.useAppBridge();
+    var focusReturnPoint = react_1.useRef(null);
+    var resourceType = props.resourceType, onSelection = props.onSelection, onCancel = props.onCancel, open = props.open;
+    // Initialize with open: false so the open action will dispatch on initial load
+    var prevProps = react_1.useRef({ open: false });
+    var picker = react_1.useMemo(function () {
+        return ResourcePicker_1.create(app, {
+            resourceType: ResourcePicker_1.ResourceType[resourceType],
+            options: getActionOptions(props),
         });
-        if (onSelection != null) {
-            this.picker.subscribe(actions_1.ResourcePicker.Action.SELECT, onSelection);
-        }
-        if (onCancel != null) {
-            this.picker.subscribe(actions_1.ResourcePicker.Action.CANCEL, onCancel);
-        }
-        if (open) {
-            this.focusReturnPoint = document.activeElement;
-            this.picker.dispatch(actions_1.ResourcePicker.Action.OPEN);
-        }
-    };
-    ResourcePicker.prototype.componentDidUpdate = function (prevProps) {
-        var wasOpen = prevProps.open;
-        var _a = this.props, open = _a.open, onCancel = _a.onCancel, onSelection = _a.onSelection;
-        this.picker.unsubscribe();
-        this.picker.set(this.getActionOptions());
-        if (onSelection != null) {
-            this.picker.subscribe(actions_1.ResourcePicker.Action.SELECT, onSelection);
-        }
-        if (onCancel != null) {
-            this.picker.subscribe(actions_1.ResourcePicker.Action.CANCEL, onCancel);
-        }
+        // We purposely want to reuse the same picker instance
+        // and use a useEffect to call `picker.set` when needed
+    }, [app]);
+    react_1.useEffect(function () {
+        var _a;
+        var wasOpen = (_a = prevProps.current) === null || _a === void 0 ? void 0 : _a.open;
         if (wasOpen !== open) {
             if (open) {
-                this.picker.dispatch(actions_1.ResourcePicker.Action.OPEN);
+                picker.dispatch(ResourcePicker_1.Action.OPEN);
             }
             else {
-                this.picker.dispatch(actions_1.ResourcePicker.Action.CLOSE);
+                picker.dispatch(ResourcePicker_1.Action.CLOSE);
             }
         }
         if (!wasOpen && open) {
-            this.focusReturnPoint = document.activeElement;
+            focusReturnPoint.current = document.activeElement;
         }
         else if (wasOpen &&
             !open &&
-            this.focusReturnPoint != null &&
-            document.contains(this.focusReturnPoint)) {
-            this.focusReturnPoint.focus();
-            this.focusReturnPoint = null;
+            focusReturnPoint.current != null &&
+            document.contains(focusReturnPoint.current)) {
+            focusReturnPoint.current.focus();
+            focusReturnPoint.current = null;
         }
-    };
-    ResourcePicker.prototype.componentWillUnmount = function () {
-        this.picker.unsubscribe();
-    };
-    ResourcePicker.prototype.render = function () {
-        return null;
-    };
-    ResourcePicker.prototype.getActionOptions = function () {
-        var _a = this.props, initialQuery = _a.initialQuery, initialSelectionIds = _a.initialSelectionIds, showHidden = _a.showHidden, allowMultiple = _a.allowMultiple, selectMultiple = _a.selectMultiple, actionVerb = _a.actionVerb;
-        var sharedOptions = {
-            initialQuery: initialQuery,
-            initialSelectionIds: initialSelectionIds,
-            showHidden: showHidden,
-            selectMultiple: selectMultiple !== null && selectMultiple !== void 0 ? selectMultiple : allowMultiple,
-            actionVerb: actionVerb,
+    }, [open]);
+    react_1.useEffect(function () {
+        var unsubscribeList = [];
+        if (onSelection != null) {
+            unsubscribeList.push(picker.subscribe(ResourcePicker_1.Action.SELECT, onSelection));
+        }
+        if (onCancel != null) {
+            unsubscribeList.push(picker.subscribe(ResourcePicker_1.Action.CANCEL, onCancel));
+        }
+        return function () {
+            var unsubscribe = unsubscribeList.pop();
+            while (unsubscribe) {
+                unsubscribe();
+                unsubscribe = unsubscribeList.pop();
+            }
         };
-        var result = sharedOptions;
-        if (this.props.resourceType === 'Product') {
-            var _b = this.props, showVariants = _b.showVariants, showDraft = _b.showDraft, showArchived = _b.showArchived, showDraftBadge = _b.showDraftBadge, showArchivedBadge = _b.showArchivedBadge;
-            var productSpecificOptions = {
-                showVariants: showVariants,
-                showDraft: showDraft,
-                showArchived: showArchived,
-                showDraftBadge: showDraftBadge,
-                showArchivedBadge: showArchivedBadge,
-            };
-            result = __assign(__assign({}, sharedOptions), productSpecificOptions);
+    }, [onSelection, onCancel]);
+    react_1.useEffect(function () {
+        var shouldUpdate = JSON.stringify(__assign(__assign({}, prevProps.current), { open: undefined })) !==
+            JSON.stringify(__assign(__assign({}, props), { open: undefined }));
+        if (!shouldUpdate) {
+            return;
         }
-        return result;
+        picker.set(getActionOptions(props));
+        prevProps.current = props;
+    }, [props]);
+    return null;
+}
+function getActionOptions(props) {
+    var initialQuery = props.initialQuery, initialSelectionIds = props.initialSelectionIds, showHidden = props.showHidden, allowMultiple = props.allowMultiple, selectMultiple = props.selectMultiple, actionVerb = props.actionVerb;
+    var sharedOptions = {
+        initialQuery: initialQuery,
+        initialSelectionIds: initialSelectionIds,
+        showHidden: showHidden,
+        selectMultiple: selectMultiple !== null && selectMultiple !== void 0 ? selectMultiple : allowMultiple,
+        actionVerb: actionVerb,
     };
-    ResourcePicker.contextType = context_1.AppBridgeContext;
-    ResourcePicker.ActionVerb = actions_1.ResourcePicker.ActionVerb;
-    return ResourcePicker;
-}(react_1.default.PureComponent));
+    var result = sharedOptions;
+    if (props.resourceType === 'Product') {
+        var showVariants = props.showVariants, showDraft = props.showDraft, showArchived = props.showArchived, showDraftBadge = props.showDraftBadge, showArchivedBadge = props.showArchivedBadge;
+        var productSpecificOptions = {
+            showVariants: showVariants,
+            showDraft: showDraft,
+            showArchived: showArchived,
+            showDraftBadge: showDraftBadge,
+            showArchivedBadge: showArchivedBadge,
+        };
+        result = __assign(__assign({}, sharedOptions), productSpecificOptions);
+    }
+    return result;
+}
 exports.default = ResourcePicker;

package/components/TitleBar/TitleBar.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { ActionProps, ActionGroupProps, Target } from '../../types';
 export interface Breadcrumb {
     /** Content the action displays */
@@ -16,8 +15,8 @@ export interface Breadcrumb {
 export interface Props {
     /** TitleBar title */
     title: string;
-    /** Collection of breadcrumbs */
-    breadcrumbs?: Breadcrumb[];
+    /** The current breadcrumb; only displays the last item in array */
+    breadcrumbs?: Breadcrumb | Breadcrumb[];
     /** Primary TitleBar action */
     primaryAction?: ActionProps;
     /** Collection of secondary TitleBar actions */
@@ -25,14 +24,4 @@ export interface Props {
     /** Collection of TitleBar groups of secondary actions */
     actionGroups?: ActionGroupProps[];
 }
-declare class TitleBar extends React.PureComponent<Props, never> {
-    static contextType: React.Context<import("../../context").IAppBridgeContext>;
-    private titleBar;
-    componentDidMount(): void;
-    componentDidUpdate(): void;
-    componentWillUnmount(): void;
-    render(): null;
-    private transformProps;
-    private transformBreadcrumbs;
-}
-export default TitleBar;
+export default function TitleBar(props: Props): null;

package/components/TitleBar/TitleBar.js

@@ -1,80 +1,55 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = __importDefault(require("react"));
-var actions_1 = require("@shopify/app-bridge/actions");
+var react_1 = require("react");
+var Button_1 = require("@shopify/app-bridge/actions/Button");
+var TitleBar_1 = require("@shopify/app-bridge/actions/TitleBar");
 var transformers_1 = require("../../utilities/transformers");
-var context_1 = require("../../context");
-var TitleBar = /** @class */ (function (_super) {
-    __extends(TitleBar, _super);
-    function TitleBar() {
-        return _super !== null && _super.apply(this, arguments) || this;
-    }
-    TitleBar.prototype.componentDidMount = function () {
-        var app = this.context;
-        this.titleBar = actions_1.TitleBar.create(app, this.transformProps());
-    };
-    TitleBar.prototype.componentDidUpdate = function () {
-        this.titleBar.unsubscribe();
-        this.titleBar.set(this.transformProps());
-    };
-    TitleBar.prototype.componentWillUnmount = function () {
-        this.titleBar.unsubscribe();
-    };
-    TitleBar.prototype.render = function () {
-        return null;
-    };
-    TitleBar.prototype.transformProps = function () {
-        var app = this.context;
-        var _a = this.props, title = _a.title, primaryAction = _a.primaryAction, secondaryActions = _a.secondaryActions, actionGroups = _a.actionGroups;
-        return {
-            title: title,
-            buttons: transformers_1.transformActions(app, {
-                primaryAction: primaryAction,
-                secondaryActions: secondaryActions,
-                actionGroups: actionGroups,
-            }),
-            breadcrumbs: this.transformBreadcrumbs(),
-        };
-    };
-    TitleBar.prototype.transformBreadcrumbs = function () {
-        var app = this.context;
-        var breadcrumbs = this.props.breadcrumbs;
-        if (breadcrumbs == null || breadcrumbs.length === 0) {
-            return undefined;
-        }
-        var breadcrumb = breadcrumbs[breadcrumbs.length - 1];
-        var url = breadcrumb.url, onAction = breadcrumb.onAction, target = breadcrumb.target, content = breadcrumb.content;
-        var button = actions_1.Button.create(app, {
-            label: content || '',
-        });
-        var redirect = transformers_1.generateRedirect(app, url, target);
-        if (redirect != null) {
-            button.subscribe(actions_1.Button.Action.CLICK, redirect);
+var useAppBridge_1 = require("../../useAppBridge");
+function TitleBar(props) {
+    var app = useAppBridge_1.useAppBridge();
+    var titleBar = react_1.useMemo(function () {
+        return TitleBar_1.create(app, transformProps(app, props));
+    }, [app]);
+    var currentProps = react_1.useRef(props);
+    react_1.useEffect(function () {
+        var propsChanged = JSON.stringify(currentProps.current) !== JSON.stringify(props);
+        if (propsChanged) {
+            currentProps.current = props;
         }
-        if (onAction != null) {
-            button.subscribe(actions_1.Button.Action.CLICK, onAction);
-        }
-        return button;
-    };
-    TitleBar.contextType = context_1.AppBridgeContext;
-    return TitleBar;
-}(react_1.default.PureComponent));
+        titleBar.set(transformProps(app, props), propsChanged);
+    }, [titleBar, props]);
+    react_1.useEffect(function () {
+        return function () {
+            titleBar.unsubscribe();
+        };
+    }, [titleBar]);
+    return null;
+}
 exports.default = TitleBar;
+function transformProps(app, _a) {
+    var actionGroups = _a.actionGroups, breadcrumbs = _a.breadcrumbs, primaryAction = _a.primaryAction, secondaryActions = _a.secondaryActions, title = _a.title;
+    var breadcrumb = Array.isArray(breadcrumbs) ? breadcrumbs[breadcrumbs.length - 1] : breadcrumbs;
+    return {
+        title: title,
+        buttons: transformers_1.transformActions(app, {
+            primaryAction: primaryAction,
+            secondaryActions: secondaryActions,
+            actionGroups: actionGroups,
+        }),
+        breadcrumbs: breadcrumb ? transformBreadcrumb(app, breadcrumb) : undefined,
+    };
+}
+function transformBreadcrumb(app, breadcrumb) {
+    var url = breadcrumb.url, onAction = breadcrumb.onAction, target = breadcrumb.target, content = breadcrumb.content;
+    var button = Button_1.create(app, {
+        label: content || '',
+    });
+    var redirect = transformers_1.generateRedirect(app, url, target);
+    if (redirect) {
+        button.subscribe(Button_1.Action.CLICK, redirect);
+    }
+    if (onAction) {
+        button.subscribe(Button_1.Action.CLICK, onAction);
+    }
+    return button;
+}

package/hooks/index.d.ts

@@ -1,4 +1,7 @@
 export { useContextualSaveBar } from './useContextualSaveBar';
+export { useFeaturesAvailable } from './useFeaturesAvailable';
+export { useFeatureRequest } from './useFeatureRequest';
+export type { FeaturesAvailable } from './useFeaturesAvailable';
 export { useNavigationHistory } from './useNavigationHistory';
 export { useToast } from './useToast';
 export { useAppBridgeState } from './useAppBridgeState';

package/hooks/index.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useNavigate = exports.useAppBridgeState = exports.useToast = exports.useNavigationHistory = exports.useContextualSaveBar = void 0;
+exports.useNavigate = exports.useAppBridgeState = exports.useToast = exports.useNavigationHistory = exports.useFeatureRequest = exports.useFeaturesAvailable = exports.useContextualSaveBar = void 0;
 var useContextualSaveBar_1 = require("./useContextualSaveBar");
 Object.defineProperty(exports, "useContextualSaveBar", { enumerable: true, get: function () { return useContextualSaveBar_1.useContextualSaveBar; } });
+var useFeaturesAvailable_1 = require("./useFeaturesAvailable");
+Object.defineProperty(exports, "useFeaturesAvailable", { enumerable: true, get: function () { return useFeaturesAvailable_1.useFeaturesAvailable; } });
+var useFeatureRequest_1 = require("./useFeatureRequest");
+Object.defineProperty(exports, "useFeatureRequest", { enumerable: true, get: function () { return useFeatureRequest_1.useFeatureRequest; } });
 var useNavigationHistory_1 = require("./useNavigationHistory");
 Object.defineProperty(exports, "useNavigationHistory", { enumerable: true, get: function () { return useNavigationHistory_1.useNavigationHistory; } });
 var useToast_1 = require("./useToast");