@shopify/shopify-app-remix 2.7.0 → 2.8.1

package/dist/esm/server/shopify-app.mjs

@@ -0,0 +1,145 @@
+import '@shopify/shopify-api/adapters/web-api';
+import { ShopifyError, shopifyApi, LATEST_API_VERSION } from '@shopify/shopify-api';
+import { AppDistribution } from './types.mjs';
+import { SHOPIFY_REMIX_LIBRARY_VERSION } from './version.mjs';
+import { registerWebhooksFactory } from './authenticate/webhooks/register.mjs';
+import { authStrategyFactory } from './authenticate/admin/authenticate.mjs';
+import { authenticateWebhookFactory } from './authenticate/webhooks/authenticate.mjs';
+import { overrideLogger } from './override-logger.mjs';
+import { addDocumentResponseHeadersFactory } from './authenticate/helpers/add-response-headers.mjs';
+import '@remix-run/server-runtime';
+import 'isbot';
+import { loginFactory } from './authenticate/login/login.mjs';
+import { unauthenticatedAdminContextFactory } from './unauthenticated/admin/factory.mjs';
+import { authenticatePublicFactory } from './authenticate/public/factory.mjs';
+import { unauthenticatedStorefrontContextFactory } from './unauthenticated/storefront/factory.mjs';
+import { AuthCodeFlowStrategy } from './authenticate/admin/strategies/auth-code-flow.mjs';
+import { TokenExchangeStrategy } from './authenticate/admin/strategies/token-exchange.mjs';
+import { IdempotentPromiseHandler } from './authenticate/helpers/idempotent-promise-handler.mjs';
+import { authenticateFlowFactory } from './authenticate/flow/authenticate.mjs';
+import { authenticateFulfillmentServiceFactory } from './authenticate/fulfillment-service/authenticate.mjs';
+import { logDisabledFutureFlags } from './future/flags.mjs';
+
+/**
+ * Creates an object your app will use to interact with Shopify.
+ *
+ * @param appConfig Configuration options for your Shopify app, such as the scopes your app needs.
+ * @returns `ShopifyApp` An object constructed using your appConfig.  It has methods for interacting with Shopify.
+ *
+ * @example
+ * <caption>The minimum viable configuration</caption>
+ * ```ts
+ * // /shopify.server.ts
+ * import { shopifyApp } from "@shopify/shopify-app-remix/server";
+ *
+ * const shopify = shopifyApp({
+ *   apiKey: process.env.SHOPIFY_API_KEY!,
+ *   apiSecretKey: process.env.SHOPIFY_API_SECRET!,
+ *   scopes: process.env.SCOPES?.split(",")!,
+ *   appUrl: process.env.SHOPIFY_APP_URL!,
+ * });
+ * export default shopify;
+ * ```
+ */
+function shopifyApp(appConfig) {
+    const api = deriveApi(appConfig);
+    const config = deriveConfig(appConfig, api.config);
+    const logger = overrideLogger(api.logger);
+    if (appConfig.webhooks) {
+        api.webhooks.addHandlers(appConfig.webhooks);
+    }
+    const params = { api, config, logger };
+    const authStrategy = authStrategyFactory({
+        ...params,
+        strategy: config.future.unstable_newEmbeddedAuthStrategy && config.isEmbeddedApp
+            ? new TokenExchangeStrategy(params)
+            : new AuthCodeFlowStrategy(params),
+    });
+    const shopify = {
+        sessionStorage: config.sessionStorage,
+        addDocumentResponseHeaders: addDocumentResponseHeadersFactory(params),
+        registerWebhooks: registerWebhooksFactory(params),
+        authenticate: {
+            admin: authStrategy,
+            flow: authenticateFlowFactory(params),
+            public: authenticatePublicFactory(params),
+            fulfillmentService: authenticateFulfillmentServiceFactory(params),
+            webhook: authenticateWebhookFactory(params),
+        },
+        unauthenticated: {
+            admin: unauthenticatedAdminContextFactory(params),
+            storefront: unauthenticatedStorefrontContextFactory(params),
+        },
+    };
+    if (isAppStoreApp(shopify, appConfig) ||
+        isSingleMerchantApp(shopify, appConfig)) {
+        shopify.login = loginFactory(params);
+    }
+    logDisabledFutureFlags(config, logger);
+    return shopify;
+}
+function isAppStoreApp(_shopify, config) {
+    return config.distribution === AppDistribution.AppStore;
+}
+function isSingleMerchantApp(_shopify, config) {
+    return config.distribution === AppDistribution.SingleMerchant;
+}
+function deriveApi(appConfig) {
+    let appUrl;
+    try {
+        appUrl = new URL(appConfig.appUrl);
+    }
+    catch (error) {
+        throw new ShopifyError('Invalid appUrl provided. Please provide a valid URL.');
+    }
+    /* eslint-disable no-process-env */
+    if (appUrl.hostname === 'localhost' && !appUrl.port && process.env.PORT) {
+        appUrl.port = process.env.PORT;
+    }
+    /* eslint-enable no-process-env */
+    appConfig.appUrl = appUrl.origin;
+    let userAgentPrefix = `Shopify Remix Library v${SHOPIFY_REMIX_LIBRARY_VERSION}`;
+    if (appConfig.userAgentPrefix) {
+        userAgentPrefix = `${appConfig.userAgentPrefix} | ${userAgentPrefix}`;
+    }
+    return shopifyApi({
+        ...appConfig,
+        hostName: appUrl.host,
+        hostScheme: appUrl.protocol.replace(':', ''),
+        userAgentPrefix,
+        isEmbeddedApp: appConfig.isEmbeddedApp ?? true,
+        apiVersion: appConfig.apiVersion ?? LATEST_API_VERSION,
+        isCustomStoreApp: appConfig.distribution === AppDistribution.ShopifyAdmin,
+        future: {
+            v10_lineItemBilling: appConfig.future?.v3_lineItemBilling,
+        },
+        _logDisabledFutureFlags: false,
+    });
+}
+function deriveConfig(appConfig, apiConfig) {
+    if (!appConfig.sessionStorage) {
+        throw new ShopifyError('Please provide a valid session storage. Refer to https://github.com/Shopify/shopify-app-js/blob/main/README.md#session-storage-options for options.');
+    }
+    const authPathPrefix = appConfig.authPathPrefix || '/auth';
+    appConfig.distribution = appConfig.distribution ?? AppDistribution.AppStore;
+    return {
+        ...appConfig,
+        ...apiConfig,
+        idempotentPromiseHandler: new IdempotentPromiseHandler(),
+        canUseLoginForm: appConfig.distribution !== AppDistribution.ShopifyAdmin,
+        useOnlineTokens: appConfig.useOnlineTokens ?? false,
+        hooks: appConfig.hooks ?? {},
+        sessionStorage: appConfig.sessionStorage,
+        future: appConfig.future ?? {},
+        auth: {
+            path: authPathPrefix,
+            callbackPath: `${authPathPrefix}/callback`,
+            patchSessionTokenPath: `${authPathPrefix}/session-token`,
+            exitIframePath: `${authPathPrefix}/exit-iframe`,
+            loginPath: `${authPathPrefix}/login`,
+        },
+    };
+}
+
+export { shopifyApp };
+//# sourceMappingURL=shopify-app.mjs.map

package/dist/esm/server/shopify-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopify-app.mjs","sources":["../../../../src/server/shopify-app.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/server/types.mjs

@@ -0,0 +1,16 @@
+// eslint-disable-next-line no-warning-comments
+// TODO: Use this enum to replace the isCustomStoreApp config option in shopify-api-js
+var AppDistribution;
+(function (AppDistribution) {
+    AppDistribution["AppStore"] = "app_store";
+    AppDistribution["SingleMerchant"] = "single_merchant";
+    AppDistribution["ShopifyAdmin"] = "shopify_admin";
+})(AppDistribution || (AppDistribution = {}));
+var LoginErrorType;
+(function (LoginErrorType) {
+    LoginErrorType["MissingShop"] = "MISSING_SHOP";
+    LoginErrorType["InvalidShop"] = "INVALID_SHOP";
+})(LoginErrorType || (LoginErrorType = {}));
+
+export { AppDistribution, LoginErrorType };
+//# sourceMappingURL=types.mjs.map

package/dist/esm/server/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sources":["../../../../src/server/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAmCA;AACA;IACY,gBAIX;AAJD,CAAA,UAAY,eAAe,EAAA;AACzB,IAAA,eAAA,CAAA,UAAA,CAAA,GAAA,WAAsB,CAAA;AACtB,IAAA,eAAA,CAAA,gBAAA,CAAA,GAAA,iBAAkC,CAAA;AAClC,IAAA,eAAA,CAAA,cAAA,CAAA,GAAA,eAA8B,CAAA;AAChC,CAAC,EAJW,eAAe,KAAf,eAAe,GAI1B,EAAA,CAAA,CAAA,CAAA;IAWW,eAGX;AAHD,CAAA,UAAY,cAAc,EAAA;AACxB,IAAA,cAAA,CAAA,aAAA,CAAA,GAAA,cAA4B,CAAA;AAC5B,IAAA,cAAA,CAAA,aAAA,CAAA,GAAA,cAA4B,CAAA;AAC9B,CAAC,EAHW,cAAc,KAAd,cAAc,GAGzB,EAAA,CAAA,CAAA;;;;"}

package/dist/esm/server/unauthenticated/admin/factory.mjs

@@ -0,0 +1,19 @@
+import { SessionNotFoundError } from '../../errors.mjs';
+import { adminClientFactory } from '../../clients/admin/factory.mjs';
+import { getOfflineSession } from '../helpers/get-offline-session.mjs';
+
+function unauthenticatedAdminContextFactory(params) {
+    return async (shop) => {
+        const session = await getOfflineSession(shop, params);
+        if (!session) {
+            throw new SessionNotFoundError(`Could not find a session for shop ${shop} when creating unauthenticated admin context`);
+        }
+        return {
+            session,
+            admin: adminClientFactory({ params, session }),
+        };
+    };
+}
+
+export { unauthenticatedAdminContextFactory };
+//# sourceMappingURL=factory.mjs.map

package/dist/esm/server/unauthenticated/admin/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","sources":["../../../../../../src/server/unauthenticated/admin/factory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AASM,SAAU,kCAAkC,CAEhD,MAAmB,EAAA;AACnB,IAAA,OAAO,OACL,IAAY,KACuC;QACnD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,MAAM,IAAI,oBAAoB,CAC5B,qCAAqC,IAAI,CAAA,4CAAA,CAA8C,CACxF,CAAC;SACH;QAED,OAAO;YACL,OAAO;YACP,KAAK,EAAE,kBAAkB,CAAY,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC;SACxD,CAAC;AACJ,KAAC,CAAC;AACJ;;;;"}

package/dist/esm/server/unauthenticated/helpers/get-offline-session.mjs

@@ -0,0 +1,8 @@
+async function getOfflineSession(shop, { api, config }) {
+    const offlineSessionId = api.session.getOfflineId(shop);
+    const session = await config.sessionStorage.loadSession(offlineSessionId);
+    return session;
+}
+
+export { getOfflineSession };
+//# sourceMappingURL=get-offline-session.mjs.map

package/dist/esm/server/unauthenticated/helpers/get-offline-session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-offline-session.mjs","sources":["../../../../../../src/server/unauthenticated/helpers/get-offline-session.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIO,eAAe,iBAAiB,CACrC,IAAY,EACZ,EAAC,GAAG,EAAE,MAAM,EAAc,EAAA;IAE1B,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAE1E,IAAA,OAAO,OAAO,CAAC;AACjB;;;;"}

package/dist/esm/server/unauthenticated/storefront/factory.mjs

@@ -0,0 +1,19 @@
+import { SessionNotFoundError } from '../../errors.mjs';
+import { storefrontClientFactory } from '../../clients/storefront/factory.mjs';
+import { getOfflineSession } from '../helpers/get-offline-session.mjs';
+
+function unauthenticatedStorefrontContextFactory(params) {
+    return async (shop) => {
+        const session = await getOfflineSession(shop, params);
+        if (!session) {
+            throw new SessionNotFoundError(`Could not find a session for shop ${shop} when creating unauthenticated storefront context`);
+        }
+        return {
+            session,
+            storefront: storefrontClientFactory({ params, session }),
+        };
+    };
+}
+
+export { unauthenticatedStorefrontContextFactory };
+//# sourceMappingURL=factory.mjs.map

package/dist/esm/server/unauthenticated/storefront/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","sources":["../../../../../../src/server/unauthenticated/storefront/factory.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAUM,SAAU,uCAAuC,CACrD,MAAmB,EAAA;AAEnB,IAAA,OAAO,OAAO,IAAY,KAA+C;QACvE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,MAAM,IAAI,oBAAoB,CAC5B,qCAAqC,IAAI,CAAA,iDAAA,CAAmD,CAC7F,CAAC;SACH;QAED,OAAO;YACL,OAAO;YACP,UAAU,EAAE,uBAAuB,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC;SACvD,CAAC;AACJ,KAAC,CAAC;AACJ;;;;"}

package/dist/esm/server/version.mjs

@@ -0,0 +1,4 @@
+const SHOPIFY_REMIX_LIBRARY_VERSION = '2.8.1';
+
+export { SHOPIFY_REMIX_LIBRARY_VERSION };
+//# sourceMappingURL=version.mjs.map

package/dist/esm/server/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sources":["../../../../src/server/version.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAO,MAAM,6BAA6B,GAAG;;;;"}

package/dist/ts/react/components/AppProvider/AppProvider.d.ts

@@ -0,0 +1,92 @@
+import { AppProviderProps as PolarisAppProviderProps } from '@shopify/polaris';
+export interface AppProviderProps extends Omit<PolarisAppProviderProps, 'linkComponent' | 'i18n'> {
+    /**
+     * The API key for your Shopify app. This is the `Client ID` from the Partner Dashboard.
+     *
+     * When using the Shopify CLI, this is the `SHOPIFY_API_KEY` environment variable. If you're using the environment
+     * variable, then you need to pass it from the loader to the component.
+     */
+    apiKey: string;
+    /**
+     * Whether the app is loaded inside the Shopify Admin. Default is `true`.
+     *
+     * {@link https://shopify.dev/docs/apps/admin/embedded-app-home}
+     */
+    isEmbeddedApp?: boolean;
+    /**
+     * The internationalization (i18n) configuration for your Polaris provider.
+     *
+     * {@link https://polaris.shopify.com/components/utilities/app-provider}
+     */
+    i18n?: PolarisAppProviderProps['i18n'];
+    /**
+     * Used internally by Shopify. You don't need to set this.
+     * @private
+     */
+    __APP_BRIDGE_URL?: string;
+}
+/**
+ * Sets up the Polaris `AppProvider` and injects the App Bridge script.
+ *
+ * This component extends the [`AppProvider`](https://polaris.shopify.com/components/utilities/app-provider) component
+ * from Polaris, and accepts all of its props except for `linkComponent`, which is overridden to use the Remix `Link`
+ * component.
+ *
+ * {@link https://polaris.shopify.com/components/utilities/app-provider}
+ * {@link https://shopify.dev/tools/app-bridge}
+ *
+ * @example
+ * <caption>Set up AppProvider.</caption>
+ * <description>Wrap your app in the `AppProvider` component and pass in your API key.</description>
+ * ```ts
+ * // /app/routes/**\/*.ts
+ * import {authenticate} from '~/shopify.server';
+ * import {AppProvider} from '@shopify/shopify-app-remix/react';
+ *
+ * export async function loader({ request }) {
+ *   await authenticate.admin(request);
+ *
+ *   return json({ apiKey: process.env.SHOPIFY_API_KEY });
+ * }
+ *
+ * export default function App() {
+ *   const { apiKey } = useLoaderData();
+ *
+ *   return (
+ *     <AppProvider isEmbeddedApp apiKey={apiKey}>
+ *       <Outlet />
+ *     </AppProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * <caption>Localize Polaris components.</caption>
+ * <description>Pass in a different locale for Polaris to translate its components.</description>
+ * ```ts
+ * // /app/routes/**\/*.ts
+ * import {authenticate} from '~/shopify.server';
+ * import {AppProvider} from '@shopify/shopify-app-remix/react';
+ *
+ * export async function loader({ request }) {
+ *   await authenticate.admin(request);
+ *
+ *   return json({
+ *     apiKey: process.env.SHOPIFY_API_KEY,
+ *     polarisTranslations: require("@shopify/polaris/locales/fr.json"),
+ *   });
+ * }
+ *
+ * export default function App() {
+ *   const { apiKey, polarisTranslations } = useLoaderData();
+ *
+ *   return (
+ *     <AppProvider apiKey={apiKey} i18n={polarisTranslations}>
+ *       <Outlet />
+ *     </AppProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AppProvider(props: AppProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AppProvider.d.ts.map

package/dist/ts/react/components/AppProvider/AppProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProvider.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProvider/AppProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,IAAI,uBAAuB,EAC5C,MAAM,kBAAkB,CAAC;AAS1B,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,MAAM,CAAC;IAC/D;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAsBlD"}

package/dist/ts/react/components/AppProxyForm/AppProxyForm.d.ts

@@ -0,0 +1,59 @@
+import { type FormProps } from '@remix-run/react';
+export interface AppProxyFormProps extends FormProps {
+    action: string;
+}
+/**
+ * Sets up a Remix `<Form>` component that works when rendered behind an app proxy.
+ *
+ * Supports any properties accepted by the `<Form>` component.
+ *
+ * @example
+ * <caption>Render a form element in a proxied route.</caption>
+ * <description>Use an `AppProxyForm` within an `AppProxy` to create a form.</description>
+ * ```ts
+ * // /app/routes/**\/*.ts
+ * import {
+ *   AppProxyProvider,
+ *   AppProxyForm,
+ * } from "@shopify/shopify-app-remix/react";
+ * import { authenticate } from "~/shopify.server";
+ *
+ * export async function loader({ request }) {
+ *   await authenticate.public.appProxy(request);
+ *
+ *   return json({ appUrl: process.env.SHOPIFY_APP_URL });
+ * }
+ *
+ * export async function action({ request }) {
+ *   await authenticate.public.appProxy(request);
+ *
+ *   const formData = await request.formData();
+ *   const field = formData.get("field")?.toString();
+ *
+ *   // Perform actions
+ *   if (field) {
+ *     console.log("Field:", field);
+ *   }
+ *
+ *   // Return JSON to the client
+ *   return json({ message: "Success!" });
+ * }
+ *
+ * export default function App() {
+ *   const { appUrl } = useLoaderData();
+ *   const data = useActionData();
+ *
+ *   return (
+ *     <AppProxyProvider appUrl={appUrl}>
+ *       <AppProxyForm action="/">
+ *         <input type="text" name="field" defaultValue={data?.field} />
+ *
+ *         <input type="submit" name="Submit" />
+ *       </AppProxyForm>
+ *     </AppProxyProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AppProxyForm(props: AppProxyFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AppProxyForm.d.ts.map

package/dist/ts/react/components/AppProxyForm/AppProxyForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyForm.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyForm/AppProxyForm.tsx"],"names":[],"mappings":"AACA,OAAO,EAAO,KAAK,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAItD,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAgBpD"}

package/dist/ts/react/components/AppProxyForm/AppProxyForm.doc.d.ts

@@ -0,0 +1,4 @@
+import { ReferenceEntityTemplateSchema } from '@shopify/generate-docs';
+declare const data: ReferenceEntityTemplateSchema;
+export default data;
+//# sourceMappingURL=AppProxyForm.doc.d.ts.map

package/dist/ts/react/components/AppProxyForm/AppProxyForm.doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyForm.doc.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyForm/AppProxyForm.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuBX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/ts/react/components/AppProxyForm/index.d.ts

@@ -0,0 +1,2 @@
+export { AppProxyForm, type AppProxyFormProps } from './AppProxyForm';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts/react/components/AppProxyForm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyForm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,KAAK,iBAAiB,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/ts/react/components/AppProxyLink/AppProxyLink.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="react" />
+export interface AppProxyLinkProps extends React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement> {
+    href: string;
+}
+/**
+ * Sets up an `<a />` HTML element that works when rendered behind an app proxy.
+ *
+ * Supports any properties accepted by the `<a />` HTML element.
+ *
+ * @example
+ * <caption>Link to a different route.</caption>
+ * <description>Use an `AppProxyLink` within an `AppProxyProvider` to link to a different proxied route.</description>
+ * ```ts
+ * // /app/routes/**\/*.ts
+ * import {authenticate} from '~/shopify.server';
+ * import {AppProxyProvider, AppProxyLink} from '@shopify/shopify-app-remix/react';
+ *
+ * export async function loader({ request }) {
+ *   await authenticate.public.appProxy(request);
+ *
+ *   return json({ appUrl: process.env.SHOPIFY_APP_URL });
+ * }
+ *
+ * export default function App() {
+ *   const { appUrl } = useLoaderData();
+ *
+ *   return (
+ *     <AppProxyProvider appUrl={appUrl}>
+ *       <AppProxyLink href="/other-proxy-route">Link to another route</AppProxyLink>
+ *     </AppProxyProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AppProxyLink(props: AppProxyLinkProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AppProxyLink.d.ts.map

package/dist/ts/react/components/AppProxyLink/AppProxyLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyLink.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyLink/AppProxyLink.tsx"],"names":[],"mappings":";AAIA,MAAM,WAAW,iBACf,SAAQ,KAAK,CAAC,iBAAiB,CAC7B,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,iBAAiB,CAClB;IACD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAgBpD"}

package/dist/ts/react/components/AppProxyLink/AppProxyLink.doc.d.ts

@@ -0,0 +1,4 @@
+import { ReferenceEntityTemplateSchema } from '@shopify/generate-docs';
+declare const data: ReferenceEntityTemplateSchema;
+export default data;
+//# sourceMappingURL=AppProxyLink.doc.d.ts.map

package/dist/ts/react/components/AppProxyLink/AppProxyLink.doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyLink.doc.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyLink/AppProxyLink.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuBX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/ts/react/components/AppProxyLink/index.d.ts

@@ -0,0 +1,2 @@
+export { AppProxyLink, type AppProxyLinkProps } from './AppProxyLink';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts/react/components/AppProxyLink/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyLink/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,KAAK,iBAAiB,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/ts/react/components/AppProxyProvider/AppProxyProvider.d.ts

@@ -0,0 +1,55 @@
+/// <reference types="react" />
+export interface AppProxyProviderProps {
+    /**
+     * The URL where the app is hosted. You can set this from the `SHOPIFY_APP_URL` environment variable.
+     */
+    appUrl: string;
+    /**
+     * The children to render.
+     */
+    children?: React.ReactNode;
+}
+type FormatUrlFunction = (url: string | undefined, addOrigin?: boolean) => string | undefined;
+interface AppProxyProviderContextProps {
+    appUrl: string;
+    formatUrl: FormatUrlFunction;
+    requestUrl?: URL;
+}
+export declare const AppProxyProviderContext: import("react").Context<AppProxyProviderContextProps | null>;
+/**
+ * Sets up a page to render behind a Shopify app proxy, enabling JavaScript and CSS to be loaded from the app.
+ *
+ * Also provides components that enable using other components such as links and forms within proxies.
+ *
+ * > Caution:
+ * Because Remix doesn't support URL rewriting, any route using this component should <b>match the pathname of the proxy
+ * URL exactly</b>, and <b>end in a trailing slash</b> (e.g., `https://<shop>/apps/proxy/`).
+ *
+ * @example
+ * <caption>Wrap a route with an AppProxyProvider component.</caption>
+ * <description>Wrap your route component in the `AppProxyProvider` component and pass in your app URL.</description>
+ * ```ts
+ * // /app/routes/**\/*.ts
+ * import {authenticate} from '~/shopify.server';
+ * import {AppProxyProvider} from '@shopify/shopify-app-remix/react';
+ *
+ * export async function loader({ request }) {
+ *   await authenticate.public.appProxy(request);
+ *
+ *   return json({ appUrl: process.env.SHOPIFY_APP_URL });
+ * }
+ *
+ * export default function App() {
+ *   const { appUrl } = useLoaderData();
+ *
+ *   return (
+ *     <AppProxyProvider appUrl={appUrl}>
+ *       Page content
+ *     </AppProxyProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AppProxyProvider(props: AppProxyProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AppProxyProvider.d.ts.map

package/dist/ts/react/components/AppProxyProvider/AppProxyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyProvider.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyProvider/AppProxyProvider.tsx"],"names":[],"mappings":";AAEA,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,KAAK,iBAAiB,GAAG,CACvB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,CAAC,EAAE,OAAO,KAChB,MAAM,GAAG,SAAS,CAAC;AAExB,UAAU,4BAA4B;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED,eAAO,MAAM,uBAAuB,8DACsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAkB5D"}

package/dist/ts/react/components/AppProxyProvider/AppProxyProvider.doc.d.ts

@@ -0,0 +1,4 @@
+import { ReferenceEntityTemplateSchema } from '@shopify/generate-docs';
+declare const data: ReferenceEntityTemplateSchema;
+export default data;
+//# sourceMappingURL=AppProxyProvider.doc.d.ts.map

package/dist/ts/react/components/AppProxyProvider/AppProxyProvider.doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppProxyProvider.doc.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyProvider/AppProxyProvider.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAmCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/ts/react/components/AppProxyProvider/index.d.ts

@@ -0,0 +1,2 @@
+export { AppProxyProvider, type AppProxyProviderProps, AppProxyProviderContext, } from './AppProxyProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts/react/components/AppProxyProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/components/AppProxyProvider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/ts/react/components/index.d.ts

@@ -0,0 +1,5 @@
+export * from './AppProvider';
+export * from './AppProxyProvider';
+export * from './AppProxyForm';
+export * from './AppProxyLink';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts/react/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/ts/server/authenticate/helpers/validate-session-token.d.ts

@@ -0,0 +1,8 @@
+import { JwtPayload } from '@shopify/shopify-api';
+import type { BasicParams } from '../../types';
+interface ValidateSessionTokenOptions {
+    checkAudience?: boolean;
+}
+export declare function validateSessionToken(params: BasicParams, request: Request, token: string, { checkAudience }?: ValidateSessionTokenOptions): Promise<JwtPayload>;
+export {};
+//# sourceMappingURL=validate-session-token.d.ts.map

package/dist/ts/server/authenticate/helpers/validate-session-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-session-token.d.ts","sourceRoot":"","sources":["../../../../../src/server/authenticate/helpers/validate-session-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAEhD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AAI7C,UAAU,2BAA2B;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,EAAC,aAAoB,EAAC,GAAE,2BAAgC,GACvD,OAAO,CAAC,UAAU,CAAC,CAkBrB"}

package/dist/ts/server/authenticate/public/appProxy/authenticate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticate.d.ts","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/appProxy/authenticate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAGL,oBAAoB,EAErB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,2BAA2B,CACzC,SAAS,SAAS,oBAAoB,EACtC,MAAM,EAAE,WAAW,GAAG,oBAAoB,CA0C3C"}