@shopify/app-bridge-react 2.0.22 → 2.0.23

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.23](https://github.com/Shopify/app-bridge/compare/v2.0.22...v2.0.23) (2022-04-07)
+
+
+### Features
+
+* NavigationMenu component ([0205cb3](https://github.com/Shopify/app-bridge/commit/0205cb396d8b4ed679dd465348a6dc45227cedb9))
+* **app-bridge-react:** add useAppBridgeState hook ([1fc64f1](https://github.com/Shopify/app-bridge/commit/1fc64f142cbd0a72adccb75fec36d31cde1ed552))
+* **app-bridge-react:** add useLocale hook ([e17dbad](https://github.com/Shopify/app-bridge/commit/e17dbadedbded9d274744738821bef49e52eb43b))
+
+
+
+
+
 ## [2.0.22](https://github.com/Shopify/app-bridge/compare/v2.0.21...v2.0.22) (2022-03-30)
 
 

package/components/ClientRouter/ClientRouter.js

@@ -36,7 +36,7 @@ var ClientRouter = /** @class */ (function (_super) {
     }
     ClientRouter.prototype.componentDidMount = function () {
         var history = this.props.history;
-        this.unsubscribe = (0, router_1.handleRouteChange)(this.context, history);
+        this.unsubscribe = router_1.handleRouteChange(this.context, history);
     };
     ClientRouter.prototype.componentWillUnmount = function () {
         if (this.unsubscribe) {

package/components/ClientRouter/hook.js

@@ -12,9 +12,9 @@ var router_1 = require("./router");
  * @public
  */
 function useClientRouting(history) {
-    var app = (0, useAppBridge_1.useAppBridge)();
-    (0, react_1.useEffect)(function () {
-        return (0, router_1.handleRouteChange)(app, history);
+    var app = useAppBridge_1.useAppBridge();
+    react_1.useEffect(function () {
+        return router_1.handleRouteChange(app, history);
     }, [app, history]);
 }
 exports.default = useClientRouting;

package/components/ContextualSaveBar/ContextualSaveBar.js

@@ -17,10 +17,10 @@ var useAppBridge_1 = require("../../useAppBridge");
 var Action = actions_1.ContextualSaveBar.Action, create = actions_1.ContextualSaveBar.create;
 function ContextualSaveBar(_a) {
     var discardAction = _a.discardAction, saveAction = _a.saveAction, fullWidth = _a.fullWidth, leaveConfirmationDisable = _a.leaveConfirmationDisable, visible = _a.visible;
-    var app = (0, useAppBridge_1.useAppBridge)();
+    var app = useAppBridge_1.useAppBridge();
     var onSaveAction = saveAction.onAction, saveActionProps = __rest(saveAction, ["onAction"]);
     var onDiscardAction = discardAction.onAction, discardActionProps = __rest(discardAction, ["onAction"]);
-    var contextualSaveBar = (0, react_1.useMemo)(function () {
+    var contextualSaveBar = react_1.useMemo(function () {
         return create(app, {
             saveAction: saveActionProps,
             discardAction: discardActionProps,
@@ -28,7 +28,7 @@ function ContextualSaveBar(_a) {
             leaveConfirmationDisable: leaveConfirmationDisable,
         });
     }, [app]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         contextualSaveBar.set({
             saveAction: saveActionProps,
             discardAction: discardActionProps,
@@ -44,14 +44,14 @@ function ContextualSaveBar(_a) {
         leaveConfirmationDisable,
         visible,
     ]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         contextualSaveBar.subscribe(Action.DISCARD, onDiscardAction);
         contextualSaveBar.subscribe(Action.SAVE, onSaveAction);
         return function () {
             contextualSaveBar.unsubscribe();
         };
     }, [contextualSaveBar]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         if (visible) {
             contextualSaveBar.dispatch(Action.SHOW);
         }

package/components/Modal/Modal.js

@@ -116,7 +116,7 @@ var Modal = /** @class */ (function (_super) {
             }
         }
         return __assign(__assign({ title: title, message: message, size: safeSize }, srcPayload), { footer: {
-                buttons: (0, transformers_1.transformActions)(app, {
+                buttons: transformers_1.transformActions(app, {
                     primaryAction: primaryAction,
                     secondaryActions: secondaryActions,
                 }),

package/components/NavigationMenu/NavigationMenu.d.ts

@@ -0,0 +1,17 @@
+export interface NavigationLink {
+    label: string;
+    destination: string;
+}
+export interface Props {
+    /**
+     * List of links in navigation menu
+     */
+    navigationLinks: NavigationLink[];
+    /**
+     * Custom matcher to set active link.
+     * This function will be called with each link and the current location.
+     * If it returns true the current link will be set to the active link.
+     */
+    matcher?: (link: NavigationLink, location: Location) => boolean;
+}
+export default function NavigationMenu({ navigationLinks, matcher }: Props): null;

package/components/NavigationMenu/NavigationMenu.js

@@ -0,0 +1,55 @@
+"use strict";
+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]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var react_1 = require("react");
+var AppBridgeAppLinks = __importStar(require("@shopify/app-bridge/actions/Link/AppLink"));
+var AppBridgeNavigationMenu = __importStar(require("@shopify/app-bridge/actions/Menu/NavigationMenu"));
+var useAppBridge_1 = require("../../useAppBridge");
+function NavigationMenu(_a) {
+    var navigationLinks = _a.navigationLinks, matcher = _a.matcher;
+    var app = useAppBridge_1.useAppBridge();
+    var _b = react_1.useState(), activeLink = _b[0], setActiveLink = _b[1];
+    var items = react_1.useMemo(function () {
+        return navigationLinks.map(function (link) {
+            var appLink = AppBridgeAppLinks.create(app, link);
+            if ((matcher === null || matcher === void 0 ? void 0 : matcher(link, location)) || link.destination === location.pathname) {
+                setActiveLink(appLink);
+            }
+            return appLink;
+        });
+    }, [app, location.pathname, matcher, navigationLinks]);
+    var navigationMenu = react_1.useMemo(function () {
+        return AppBridgeNavigationMenu.create(app, {
+            items: items,
+            active: activeLink,
+        });
+        /* We want to reuse the same NavigationMenu instance, even when props change
+         * (so we don't include all the props in the dependency array).
+         * Instead of recreating the component on every change, we use the set method,
+         * in the useEffect block below, to dispatch updates when props change.
+         */
+    }, [app]);
+    react_1.useEffect(function () {
+        navigationMenu.set({ items: items, active: activeLink });
+    }, [activeLink, items]);
+    return null;
+}
+exports.default = NavigationMenu;

package/components/NavigationMenu/index.d.ts

@@ -0,0 +1,3 @@
+import NavigationMenu from './NavigationMenu';
+export { Props } from './NavigationMenu';
+export default NavigationMenu;

package/components/NavigationMenu/index.js

@@ -0,0 +1,7 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var NavigationMenu_1 = __importDefault(require("./NavigationMenu"));
+exports.default = NavigationMenu_1.default;

package/components/Provider/Provider.d.ts

@@ -1,6 +1,5 @@
 import React from 'react';
-import { DispatchActionHook } from '@shopify/app-bridge';
-import { AppConfigV2 } from '@shopify/app-bridge/client';
+import type { AppConfigV2, DispatchActionHook } from '@shopify/app-bridge/client';
 /**
  * Provider props
  *

package/components/Provider/Provider.js

@@ -16,11 +16,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -67,7 +63,7 @@ var Provider = /** @class */ (function (_super) {
     Object.defineProperty(Provider.prototype, "appInstance", {
         get: function () {
             if (!this.app) {
-                this.app = (0, app_bridge_1.default)(this.props.config);
+                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);
                 }

package/components/RoutePropagator/RoutePropagator.js

@@ -36,13 +36,13 @@ var RoutePropagator = /** @class */ (function (_super) {
     }
     RoutePropagator.prototype.componentDidMount = function () {
         var location = this.props.location;
-        (0, route_propagator_1.updateHistory)(this.context, location);
+        route_propagator_1.updateHistory(this.context, location);
     };
     RoutePropagator.prototype.componentDidUpdate = function (_a) {
         var prevLocation = _a.location;
         var location = this.props.location;
         if (location !== prevLocation) {
-            (0, route_propagator_1.updateHistory)(this.context, location);
+            route_propagator_1.updateHistory(this.context, location);
         }
     };
     RoutePropagator.prototype.render = function () {

package/components/RoutePropagator/globals.d.ts

@@ -1,3 +1,3 @@
 export declare function getSelfWindow(): Window & typeof globalThis;
-export declare function getTopWindow(): Window | null;
+export declare function getTopWindow(): Window;
 export declare function getOrigin(): string;

package/components/RoutePropagator/hook.js

@@ -12,9 +12,9 @@ var route_propagator_1 = require("./route-propagator");
  * @public
  */
 function useRoutePropagation(location) {
-    var app = (0, useAppBridge_1.useAppBridge)();
-    (0, react_1.useEffect)(function () {
-        (0, route_propagator_1.updateHistory)(app, location);
+    var app = useAppBridge_1.useAppBridge();
+    react_1.useEffect(function () {
+        route_propagator_1.updateHistory(app, location);
     }, [app, location]);
 }
 exports.default = useRoutePropagation;

package/components/RoutePropagator/route-propagator.js

@@ -59,8 +59,8 @@ function updateHistory(app, location) {
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    selfWindow = (0, globals_1.getSelfWindow)();
-                    topWindow = (0, globals_1.getTopWindow)();
+                    selfWindow = globals_1.getSelfWindow();
+                    topWindow = globals_1.getTopWindow();
                     renderedInTheTopWindow = selfWindow === topWindow;
                     return [4 /*yield*/, app.getState('context').then(function (context) {
                             return context === MessageTransport_1.Context.Main;
@@ -73,7 +73,7 @@ function updateHistory(app, location) {
                     normalizedLocation = getNormalizedURL(location);
                     embeddedFrameParamsToRemove.forEach(function (param) { return normalizedLocation.searchParams.delete(param); });
                     pathname = normalizedLocation.pathname, search = normalizedLocation.search, hash = normalizedLocation.hash;
-                    locationStr = "".concat(pathname).concat(search).concat(hash);
+                    locationStr = "" + pathname + search + hash;
                     actions_1.History.create(app).dispatch(actions_1.History.Action.REPLACE, locationStr);
                     return [2 /*return*/];
             }
@@ -82,10 +82,10 @@ function updateHistory(app, location) {
 }
 exports.updateHistory = updateHistory;
 function getNormalizedURL(location) {
-    var origin = (0, globals_1.getOrigin)();
+    var origin = globals_1.getOrigin();
     if (typeof location === 'string') {
         return new URL(location, origin);
     }
     var pathname = location.pathname, search = location.search, hash = location.hash;
-    return new URL("".concat(pathname).concat(search).concat(hash), origin);
+    return new URL("" + pathname + search + hash, origin);
 }

package/components/TitleBar/TitleBar.js

@@ -46,7 +46,7 @@ var TitleBar = /** @class */ (function (_super) {
         var _a = this.props, title = _a.title, primaryAction = _a.primaryAction, secondaryActions = _a.secondaryActions, actionGroups = _a.actionGroups;
         return {
             title: title,
-            buttons: (0, transformers_1.transformActions)(app, {
+            buttons: transformers_1.transformActions(app, {
                 primaryAction: primaryAction,
                 secondaryActions: secondaryActions,
                 actionGroups: actionGroups,
@@ -65,7 +65,7 @@ var TitleBar = /** @class */ (function (_super) {
         var button = actions_1.Button.create(app, {
             label: content || '',
         });
-        var redirect = (0, transformers_1.generateRedirect)(app, url, target);
+        var redirect = transformers_1.generateRedirect(app, url, target);
         if (redirect != null) {
             button.subscribe(actions_1.Button.Action.CLICK, redirect);
         }

package/components/index.d.ts

@@ -1,9 +1,10 @@
 export { default as ContextualSaveBar, Props as ContextualSaveBarProps } from './ContextualSaveBar';
-export { default as Provider, Props as ProviderProps } from './Provider';
 export { default as Loading } from './Loading';
-export { default as Toast, Props as ToastProps } from './Toast';
-export { default as TitleBar } from './TitleBar';
 export { default as Modal, Props as ModalProps, ModalContent } from './Modal';
+export { default as NavigationMenu, Props as NavigationMenuProps } from './NavigationMenu';
+export { default as Provider, Props as ProviderProps } from './Provider';
 export { default as ResourcePicker, Props as ResourcePickerProps } from './ResourcePicker';
+export { default as TitleBar } from './TitleBar';
+export { default as Toast, Props as ToastProps } from './Toast';
 export * from './RoutePropagator';
 export * from './ClientRouter';

package/components/index.js

@@ -1,11 +1,7 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -17,21 +13,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourcePicker = exports.ModalContent = exports.Modal = exports.TitleBar = exports.Toast = exports.Loading = exports.Provider = exports.ContextualSaveBar = void 0;
+exports.Toast = exports.TitleBar = exports.ResourcePicker = exports.Provider = exports.NavigationMenu = exports.ModalContent = exports.Modal = exports.Loading = exports.ContextualSaveBar = void 0;
 var ContextualSaveBar_1 = require("./ContextualSaveBar");
 Object.defineProperty(exports, "ContextualSaveBar", { enumerable: true, get: function () { return __importDefault(ContextualSaveBar_1).default; } });
-var Provider_1 = require("./Provider");
-Object.defineProperty(exports, "Provider", { enumerable: true, get: function () { return __importDefault(Provider_1).default; } });
 var Loading_1 = require("./Loading");
 Object.defineProperty(exports, "Loading", { enumerable: true, get: function () { return __importDefault(Loading_1).default; } });
-var Toast_1 = require("./Toast");
-Object.defineProperty(exports, "Toast", { enumerable: true, get: function () { return __importDefault(Toast_1).default; } });
-var TitleBar_1 = require("./TitleBar");
-Object.defineProperty(exports, "TitleBar", { enumerable: true, get: function () { return __importDefault(TitleBar_1).default; } });
 var Modal_1 = require("./Modal");
 Object.defineProperty(exports, "Modal", { enumerable: true, get: function () { return __importDefault(Modal_1).default; } });
 Object.defineProperty(exports, "ModalContent", { enumerable: true, get: function () { return Modal_1.ModalContent; } });
+var NavigationMenu_1 = require("./NavigationMenu");
+Object.defineProperty(exports, "NavigationMenu", { enumerable: true, get: function () { return __importDefault(NavigationMenu_1).default; } });
+var Provider_1 = require("./Provider");
+Object.defineProperty(exports, "Provider", { enumerable: true, get: function () { return __importDefault(Provider_1).default; } });
 var ResourcePicker_1 = require("./ResourcePicker");
 Object.defineProperty(exports, "ResourcePicker", { enumerable: true, get: function () { return __importDefault(ResourcePicker_1).default; } });
+var TitleBar_1 = require("./TitleBar");
+Object.defineProperty(exports, "TitleBar", { enumerable: true, get: function () { return __importDefault(TitleBar_1).default; } });
+var Toast_1 = require("./Toast");
+Object.defineProperty(exports, "Toast", { enumerable: true, get: function () { return __importDefault(Toast_1).default; } });
 __exportStar(require("./RoutePropagator"), exports);
 __exportStar(require("./ClientRouter"), exports);

package/context.d.ts

@@ -1,4 +1,4 @@
-import { ClientApplication } from '@shopify/app-bridge/client';
+import type { ClientApplication } from '@shopify/app-bridge/client';
 /**
  * App Bridge context consumer type.
  *

package/context.js

@@ -7,4 +7,4 @@ var react_1 = require("react");
  *
  * @public
  */
-exports.AppBridgeContext = (0, react_1.createContext)(null);
+exports.AppBridgeContext = react_1.createContext(null);

package/hooks/index.d.ts

@@ -1,3 +1,4 @@
 export { useContextualSaveBar } from './useContextualSaveBar';
 export { useNavigationHistory } from './useNavigationHistory';
 export { useToast } from './useToast';
+export { useAppBridgeState } from './useAppBridgeState';

package/hooks/index.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useToast = exports.useNavigationHistory = exports.useContextualSaveBar = void 0;
+exports.useAppBridgeState = exports.useToast = exports.useNavigationHistory = exports.useContextualSaveBar = void 0;
 var useContextualSaveBar_1 = require("./useContextualSaveBar");
 Object.defineProperty(exports, "useContextualSaveBar", { enumerable: true, get: function () { return useContextualSaveBar_1.useContextualSaveBar; } });
 var useNavigationHistory_1 = require("./useNavigationHistory");
 Object.defineProperty(exports, "useNavigationHistory", { enumerable: true, get: function () { return useNavigationHistory_1.useNavigationHistory; } });
 var useToast_1 = require("./useToast");
 Object.defineProperty(exports, "useToast", { enumerable: true, get: function () { return useToast_1.useToast; } });
+var useAppBridgeState_1 = require("./useAppBridgeState");
+Object.defineProperty(exports, "useAppBridgeState", { enumerable: true, get: function () { return useAppBridgeState_1.useAppBridgeState; } });

package/hooks/useAppBridgeState/index.d.ts

@@ -0,0 +1 @@
+export * from './useAppBridgeState';

package/hooks/useAppBridgeState/index.js

@@ -0,0 +1,13 @@
+"use strict";
+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]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useAppBridgeState"), exports);

package/hooks/useAppBridgeState/useAppBridgeState.d.ts

@@ -0,0 +1,10 @@
+import type { AppBridgeState, Path, PathValue, StateWithoutFeatures } from '@shopify/app-bridge';
+declare type Query = keyof AppBridgeState | Path<StateWithoutFeatures<AppBridgeState>>;
+declare type State<K extends Query> = K extends keyof AppBridgeState ? AppBridgeState[K] : K extends Path<StateWithoutFeatures<AppBridgeState>> ? PathValue<StateWithoutFeatures<AppBridgeState>, K> : K extends never ? AppBridgeState : never;
+interface UseAppBridgeState {
+    (): AppBridgeState | undefined;
+    <K extends Query>(query: K): State<K> | undefined;
+    <PartialState>(query: keyof AppBridgeState): PartialState | undefined;
+}
+export declare const useAppBridgeState: UseAppBridgeState;
+export {};

package/hooks/useAppBridgeState/useAppBridgeState.js

@@ -0,0 +1,75 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAppBridgeState = void 0;
+var react_1 = require("react");
+var useAppBridge_1 = require("../../useAppBridge");
+var useAppBridgeState = function (query) {
+    var app = useAppBridge_1.useAppBridge();
+    var _a = react_1.useState(), state = _a[0], setState = _a[1];
+    var refresh = react_1.useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
+        var state, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    if (!query) return [3 /*break*/, 2];
+                    return [4 /*yield*/, app.getState(query)];
+                case 1:
+                    _a = _b.sent();
+                    return [3 /*break*/, 4];
+                case 2: return [4 /*yield*/, app.getState()];
+                case 3:
+                    _a = _b.sent();
+                    _b.label = 4;
+                case 4:
+                    state = _a;
+                    setState(state);
+                    return [2 /*return*/, state];
+            }
+        });
+    }); }, [app, query]);
+    react_1.useEffect(function () {
+        refresh();
+        // Automatically check to see if the state has changed every time an action has been dispatched
+        return app.subscribe(function () {
+            refresh();
+        });
+    }, [app, refresh]);
+    return state;
+};
+exports.useAppBridgeState = useAppBridgeState;

package/hooks/useContextualSaveBar/useContextualSaveBar.js

@@ -17,7 +17,7 @@ var ContextualSaveBar_1 = require("@shopify/app-bridge/actions/ContextualSaveBar
 var useAppBridge_1 = require("../../useAppBridge");
 function useContextualSaveBar(_a) {
     var discardAction = _a.discardAction, saveAction = _a.saveAction, fullWidth = _a.fullWidth, leaveConfirmationDisable = _a.leaveConfirmationDisable, visible = _a.visible;
-    var app = (0, useAppBridge_1.useAppBridge)();
+    var app = useAppBridge_1.useAppBridge();
     var onSaveAction = saveAction.onAction, saveActionProps = __rest(saveAction, ["onAction"]);
     var onDiscardAction = discardAction.onAction, discardActionProps = __rest(discardAction, ["onAction"]);
     /* We want to reuse the same ContextualSaveBar instance, even when props change
@@ -25,15 +25,15 @@ function useContextualSaveBar(_a) {
      * Instead of recreating the component on every change, we use the set method,
      * in the useEffect block below, to dispatch updates when props change.
      */
-    var contextualSaveBar = (0, react_1.useMemo)(function () {
-        return (0, ContextualSaveBar_1.create)(app, {
+    var contextualSaveBar = react_1.useMemo(function () {
+        return ContextualSaveBar_1.create(app, {
             saveAction: saveActionProps,
             discardAction: discardActionProps,
             fullWidth: fullWidth,
             leaveConfirmationDisable: leaveConfirmationDisable,
         });
     }, [app]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         contextualSaveBar.set({
             saveAction: saveActionProps,
             discardAction: discardActionProps,
@@ -48,14 +48,14 @@ function useContextualSaveBar(_a) {
         leaveConfirmationDisable,
         visible,
     ]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         contextualSaveBar.subscribe(ContextualSaveBar_1.Action.DISCARD, onDiscardAction);
         contextualSaveBar.subscribe(ContextualSaveBar_1.Action.SAVE, onSaveAction);
         return function () {
             contextualSaveBar.unsubscribe();
         };
     }, [contextualSaveBar]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         if (visible) {
             contextualSaveBar.dispatch(ContextualSaveBar_1.Action.SHOW);
         }

package/hooks/useLocale/index.d.ts

@@ -0,0 +1 @@
+export { useLocale } from './useLocale';

package/hooks/useLocale/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocale = void 0;
+var useLocale_1 = require("./useLocale");
+Object.defineProperty(exports, "useLocale", { enumerable: true, get: function () { return useLocale_1.useLocale; } });

package/hooks/useLocale/useLocale.d.ts

@@ -0,0 +1 @@
+export declare function useLocale(): string | undefined;

package/hooks/useLocale/useLocale.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocale = void 0;
+var useAppBridgeState_1 = require("../useAppBridgeState");
+function useLocale() {
+    return useAppBridgeState_1.useAppBridgeState('staffMember.locale');
+}
+exports.useLocale = useLocale;

package/hooks/useNavigationHistory/useNavigationHistory.js

@@ -13,8 +13,8 @@ var useAppBridge_1 = require("../../useAppBridge");
  * @public
  */
 function useNavigationHistory() {
-    var app = (0, useAppBridge_1.useAppBridge)();
-    return (0, react_1.useMemo)(function () {
+    var app = useAppBridge_1.useAppBridge();
+    return react_1.useMemo(function () {
         var history = actions_1.History.create(app);
         function push(location) {
             history.dispatch(actions_1.History.Action.PUSH, location.pathname);

package/hooks/useToast/useToast.js

@@ -14,11 +14,11 @@ exports.DEFAULT_TOAST_DURATION = 5000;
  * @public
  */
 function useToast() {
-    var app = (0, useAppBridge_1.useAppBridge)();
+    var app = useAppBridge_1.useAppBridge();
     var toast;
-    var show = (0, react_1.useCallback)(function (_a) {
+    var show = react_1.useCallback(function (_a) {
         var message = _a.content, _b = _a.duration, duration = _b === void 0 ? exports.DEFAULT_TOAST_DURATION : _b, isError = _a.isError, onDismiss = _a.onDismiss;
-        toast = (0, Toast_1.create)(app, {
+        toast = Toast_1.create(app, {
             message: message,
             isError: isError,
             duration: duration,
@@ -28,7 +28,7 @@ function useToast() {
             toast.subscribe(Toast_1.Action.CLEAR, onDismiss);
         }
     }, [app]);
-    (0, react_1.useEffect)(function () {
+    react_1.useEffect(function () {
         return function () {
             toast.unsubscribe();
         };

package/index.d.ts

@@ -1,3 +1,4 @@
 export * from './components';
 export { AppBridgeContext as Context } from './context';
 export { useAppBridge } from './useAppBridge';
+export * from './hooks';

package/index.js

@@ -1,11 +1,7 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -20,3 +16,4 @@ var context_1 = require("./context");
 Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.AppBridgeContext; } });
 var useAppBridge_1 = require("./useAppBridge");
 Object.defineProperty(exports, "useAppBridge", { enumerable: true, get: function () { return useAppBridge_1.useAppBridge; } });
+__exportStar(require("./hooks"), exports);