@shopify/shopify-app-remix 2.6.0 → 2.7.0

package/build/ts/server/authenticate/public/appProxy/authenticate.public.app-proxy.doc.js

@@ -16,6 +16,19 @@ var data = {
             type: 'AuthenticateAppProxy',
         },
     ],
+    defaultExample: {
+        description: 'Authenticate and fetch product information',
+        codeblock: {
+            title: 'Authenticate and fetch product information',
+            tabs: [
+                {
+                    title: '/app/routes/**.ts',
+                    language: 'typescript',
+                    code: './authenticate.public.app-proxy.doc.example.ts',
+                },
+            ],
+        },
+    },
     jsDocTypeExamples: ['AppProxyContextWithSession'],
     related: [
         {
@@ -28,6 +41,12 @@ var data = {
             subtitle: 'Interact with the Storefront API.',
             url: '/docs/api/shopify-app-remix/apis/storefront-api',
         },
+        {
+            name: 'Liquid reference',
+            subtitle: "Use the shop's theme to render a template.",
+            url: '/docs/api/liquid',
+            type: 'liquid',
+        },
     ],
 };
 exports.default = data;

package/build/ts/server/authenticate/public/appProxy/authenticate.public.app-proxy.doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate.public.app-proxy.doc.js","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/appProxy/authenticate.public.app-proxy.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,yHAAyH;QACzH,8IAA8I;QAC9I,kIAAkI;IACpI,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,oEAAoE;YACtE,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,iBAAiB,EAAE,CAAC,4BAA4B,CAAC;IACjD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,8BAA8B;YACxC,GAAG,EAAE,4CAA4C;SAClD;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,QAAQ,EAAE,mCAAmC;YAC7C,GAAG,EAAE,iDAAiD;SACvD;KACF;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"authenticate.public.app-proxy.doc.js","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/appProxy/authenticate.public.app-proxy.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,yHAAyH;QACzH,8IAA8I;QAC9I,kIAAkI;IACpI,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,oEAAoE;YACtE,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,cAAc,EAAE;QACd,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE;YACT,KAAK,EAAE,4CAA4C;YACnD,IAAI,EAAE;gBACJ;oBACE,KAAK,EAAE,mBAAmB;oBAC1B,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,gDAAgD;iBACvD;aACF;SACF;KACF;IACD,iBAAiB,EAAE,CAAC,4BAA4B,CAAC;IACjD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,8BAA8B;YACxC,GAAG,EAAE,4CAA4C;SAClD;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,QAAQ,EAAE,mCAAmC;YAC7C,GAAG,EAAE,iDAAiD;SACvD;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,4CAA4C;YACtD,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,QAAQ;SACf;KACF;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/build/ts/server/authenticate/public/appProxy/types.d.ts

@@ -14,7 +14,7 @@ interface Context {
      *
      * @example
      * <caption>Rendering liquid content.</caption>
-     * <description>Use the `liquid` helper to render a `Response` with Liquid content using the shop's theme.</description>
+     * <description>Use the `liquid` helper to render a `Response` with Liquid content using the shop's theme. See the [Liquid reference](https://shopify.dev/docs/api/liquid) for all the features it enables.</description>
      * ```ts
      * // app/routes/**\/.ts
      * import {authenticate} from "~/shopify.server"
@@ -82,10 +82,13 @@ export interface AppProxyContextWithSession<Resources extends ShopifyRestResourc
      *
      * export const loader = async ({ request }) => {
      *   // Get the session for the shop that initiated the request to the app proxy.
-     *   const { session } = await authenticate.public.appProxy(request);
+     *   const { session } =
+     *     await authenticate.public.appProxy(request);
      *
      *   // Use the session data to make to queries to your database or additional requests.
-     *   return json(await getMyAppModelData({shop: session.shop));
+     *   return json(
+     *     await getMyAppModelData({shop: session.shop})
+     *   );
      * };
      * ```
      */
@@ -113,7 +116,11 @@ export interface AppProxyContextWithSession<Resources extends ShopifyRestResourc
      *         }
      *       }
      *     }`,
-     *     { variables: { input: { title: "Product Name" } } }
+     *     {
+     *       variables: {
+     *         input: { title: "Product Name" }
+     *       }
+     *     }
      *   );
      *
      *   const productData = await response.json();
@@ -136,7 +143,18 @@ export interface AppProxyContextWithSession<Resources extends ShopifyRestResourc
      * export async function action({ request }: ActionFunctionArgs) {
      *   const { storefront } = await authenticate.public.appProxy(request);
      *
-     *   const response = await storefront.graphql(`{blogs(first: 10) { edges { node { id } } } }`);
+     *   const response = await storefront.graphql(
+     *     `#graphql
+     *     query blogIds {
+     *       blogs(first: 10) {
+     *         edges {
+     *           node {
+     *             id
+     *           }
+     *         }
+     *       }
+     *     }`
+     *   );
      *
      *   return json(await response.json());
      * }

package/build/ts/server/authenticate/public/appProxy/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/appProxy/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAC,eAAe,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,eAAe,GAAG,0BAA0B,CAAC,CAAC;AAE3D,UAAU,OAAO;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,KAC/C,QAAQ,CAAC;AAEd,UAAU,OAAO;IACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C;;;;OAIG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B,CACzC,SAAS,SAAS,oBAAoB,GAAG,oBAAoB,CAC7D,SAAQ,OAAO;IACf;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAElC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,EAAE,iBAAiB,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/appProxy/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAC,eAAe,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,eAAe,GAAG,0BAA0B,CAAC,CAAC;AAE3D,UAAU,OAAO;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,KAC/C,QAAQ,CAAC;AAEd,UAAU,OAAO;IACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C;;;;OAIG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B,CACzC,SAAS,SAAS,oBAAoB,GAAG,oBAAoB,CAC7D,SAAQ,OAAO;IACf;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,UAAU,EAAE,iBAAiB,CAAC;CAC/B"}

package/build/ts/server/authenticate/public/checkout/authenticate.public.checkout.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate.public.checkout.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/checkout/authenticate.public.checkout.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAkBX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"authenticate.public.checkout.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/checkout/authenticate.public.checkout.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAoCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/server/authenticate/public/checkout/authenticate.public.checkout.doc.js

@@ -14,6 +14,24 @@ var data = {
             type: 'AuthenticateCheckout',
         },
     ],
+    defaultExample: {
+        description: 'Authenticate and return offers for the shop',
+        codeblock: {
+            title: 'Authenticate and return offers for the shop',
+            tabs: [
+                {
+                    title: '/app/routes/**.ts',
+                    language: 'typescript',
+                    code: './authenticate.public.checkout.doc.example.ts',
+                },
+                {
+                    title: '/app/offers.server.ts',
+                    language: 'typescript',
+                    code: './authenticate.public.checkout.doc.example.offers.ts',
+                },
+            ],
+        },
+    },
     jsDocTypeExamples: ['CheckoutContext'],
     related: [],
 };

package/build/ts/server/authenticate/public/checkout/authenticate.public.checkout.doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate.public.checkout.doc.js","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/checkout/authenticate.public.checkout.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,wKAAwK;IAC1K,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,iEAAiE;YACnE,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,iBAAiB,EAAE,CAAC,iBAAiB,CAAC;IACtC,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"authenticate.public.checkout.doc.js","sourceRoot":"","sources":["../../../../../../src/server/authenticate/public/checkout/authenticate.public.checkout.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,wKAAwK;IAC1K,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,iEAAiE;YACnE,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,cAAc,EAAE;QACd,WAAW,EAAE,6CAA6C;QAC1D,SAAS,EAAE;YACT,KAAK,EAAE,6CAA6C;YACpD,IAAI,EAAE;gBACJ;oBACE,KAAK,EAAE,mBAAmB;oBAC1B,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,+CAA+C;iBACtD;gBACD;oBACE,KAAK,EAAE,uBAAuB;oBAC9B,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,sDAAsD;iBAC7D;aACF;SACF;KACF;IACD,iBAAiB,EAAE,CAAC,iBAAiB,CAAC;IACtC,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/build/ts/server/authenticate/webhooks/authenticate.webhooks.doc.d.ts.map

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

package/build/ts/server/authenticate/webhooks/authenticate.webhooks.doc.js

@@ -14,6 +14,19 @@ var data = {
             type: 'AuthenticateWebhook',
         },
     ],
+    defaultExample: {
+        description: 'Update a metafield when a product is updated',
+        codeblock: {
+            title: 'Update a metafield when a product is updated',
+            tabs: [
+                {
+                    title: '/app/routes/**.ts',
+                    language: 'typescript',
+                    code: './authenticate.webhooks.doc.example.ts',
+                },
+            ],
+        },
+    },
     jsDocTypeExamples: ['WebhookContextWithSession'],
     related: [
         {

package/build/ts/server/authenticate/webhooks/authenticate.webhooks.doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate.webhooks.doc.js","sourceRoot":"","sources":["../../../../../src/server/authenticate/webhooks/authenticate.webhooks.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EACT,oDAAoD;QACpD,4NAA4N;IAC9N,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,qBAAqB;SAC5B;KACF;IACD,iBAAiB,EAAE,CAAC,2BAA2B,CAAC;IAChD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,8BAA8B;YACxC,GAAG,EAAE,4CAA4C;SAClD;KACF;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"authenticate.webhooks.doc.js","sourceRoot":"","sources":["../../../../../src/server/authenticate/webhooks/authenticate.webhooks.doc.ts"],"names":[],"mappings":";;AAEA,IAAM,IAAI,GAAkC;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EACT,oDAAoD;QACpD,4NAA4N;IAC9N,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE;QACX;YACE,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,qBAAqB;SAC5B;KACF;IACD,cAAc,EAAE;QACd,WAAW,EAAE,8CAA8C;QAC3D,SAAS,EAAE;YACT,KAAK,EAAE,8CAA8C;YACrD,IAAI,EAAE;gBACJ;oBACE,KAAK,EAAE,mBAAmB;oBAC1B,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,wCAAwC;iBAC/C;aACF;SACF;KACF;IACD,iBAAiB,EAAE,CAAC,2BAA2B,CAAC;IAChD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,8BAA8B;YACxC,GAAG,EAAE,4CAA4C;SAClD;KACF;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

package/build/ts/server/authenticate/webhooks/types.d.ts

@@ -1,5 +1,4 @@
 import { Session, Shopify, ShopifyRestResources } from '@shopify/shopify-api';
-import type { JSONValue } from '../../types';
 import type { AdminApiContext } from '../../clients';
 import type { FeatureEnabled, FutureFlagOptions } from '../../future/flags';
 export interface RegisterWebhooksOptions {
@@ -17,10 +16,10 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the API version used for webhook request.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { apiVersion } = await authenticate.webhook(request);
      *   return new Response();
      * };
@@ -35,10 +34,10 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the shop that triggered a webhook.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { shop } = await authenticate.webhook(request);
      *   return new Response();
      * };
@@ -53,10 +52,10 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the event topic for the webhook.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { topic } = await authenticate.webhook(request);
      *
      *   switch (topic) {
@@ -78,10 +77,10 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the webhook ID.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { webhookId } = await authenticate.webhook(request);
      *   return new Response();
      * };
@@ -96,16 +95,16 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the request's POST payload.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { payload } = await authenticate.webhook(request);
      *   return new Response();
      * };
      * ```
      */
-    payload: JSONValue;
+    payload: Record<string, any>;
     /**
      * The sub-topic of the webhook. This is only available for certain webhooks.
      *
@@ -114,10 +113,10 @@ interface Context<Topics = string | number | symbol> {
      * <description>Get the webhook sub-topic.</description>
      * ```ts
      * // /app/routes/webhooks.tsx
-     * import { ActionFunction } from "@remix-run/node";
+     * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export const action: ActionFunction = async ({ request }) => {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { subTopic } = await authenticate.webhook(request);
      *   return new Response();
      * };

package/build/ts/server/authenticate/webhooks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/authenticate/webhooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IACjD;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,EAAE,SAAS,CAAC;IACnB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAC7E,SAAQ,OAAO,CAAC,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B,CAC3C,SAAS,SAAS,oBAAoB;IAEtC,qBAAqB;IACrB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3D,wBAAwB;IACxB,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,IAEtC,cAAc,CAAC,MAAM,EAAE,wBAAwB,CAAC,SAAS,IAAI,GACzD,eAAe,CAAC,SAAS,CAAC,GAC1B,4BAA4B,CAAC,SAAS,CAAC,CAAC;AAE9C,MAAM,WAAW,yBAAyB,CACxC,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CACjC,SAAQ,OAAO,CAAC,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,KAAK,EAAE,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAE/B,4BAA4B,CAAC,MAAM,CAAC,GACpC,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAC/B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/authenticate/webhooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IACjD;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAC7E,SAAQ,OAAO,CAAC,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B,CAC3C,SAAS,SAAS,oBAAoB;IAEtC,qBAAqB;IACrB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3D,wBAAwB;IACxB,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,IAEtC,cAAc,CAAC,MAAM,EAAE,wBAAwB,CAAC,SAAS,IAAI,GACzD,eAAe,CAAC,SAAS,CAAC,GAC1B,4BAA4B,CAAC,SAAS,CAAC,CAAC;AAE9C,MAAM,WAAW,yBAAyB,CACxC,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CACjC,SAAQ,OAAO,CAAC,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,KAAK,EAAE,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAE/B,4BAA4B,CAAC,MAAM,CAAC,GACpC,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,iBAAiB,EAChC,SAAS,SAAS,oBAAoB,EACtC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAC/B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/build/ts/server/clients/admin/types.d.ts

@@ -31,12 +31,17 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * import { authenticate } from "../shopify.server";
      *
      * export const loader = async ({ request }: LoaderFunctionArgs) => {
-     *   const { admin, session } = await authenticate.admin(request);
-     *   return json(admin.rest.resources.Order.count({ session }));
+     *   const {
+     *     admin,
+     *     session,
+     *   } = await authenticate.admin(request);
+     *
+     *   return json(
+     *     admin.rest.resources.Order.count({ session }),
+     *   );
      * };
      * ```
      *
-     *
      * ```ts
      * // /app/shopify.server.ts
      * import { shopifyApp } from "@shopify/shopify-app-remix/server";
@@ -50,7 +55,6 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * export const authenticate = shopify.authenticate;
      * ```
      *
-     *
      * @example
      * <caption>Performing a GET request to the REST API.</caption>
      * <description>Use `admin.rest.get` to make custom requests to make a request to to the `customer/count` endpoint</description>
@@ -61,9 +65,16 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * import { authenticate } from "../shopify.server";
      *
      * export const loader = async ({ request }: LoaderFunctionArgs) => {
-     *   const { admin, session } = await authenticate.admin(request);
-     *   const response = await admin.rest.get({ path: "/customers/count.json" });
+     *   const {
+     *     admin,
+     *     session,
+     *   } = await authenticate.admin(request);
+     *
+     *   const response = await admin.rest.get({
+     *     path: "/customers/count.json",
+     *   });
      *   const customers = await response.json();
+     *
      *   return json({ customers });
      * };
      * ```
@@ -80,6 +91,7 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * export default shopify;
      * export const authenticate = shopify.authenticate;
      * ```
+     *
      * @example
      * <caption>Performing a POST request to the REST API.</caption>
      * <description>Use `admin.rest.post` to make custom requests to make a request to to the `customers.json` endpoint to send a welcome email</description>
@@ -89,7 +101,11 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * import { authenticate } from "../shopify.server";
      *
      * export const loader = async ({ request }: LoaderFunctionArgs) => {
-     *   const { admin, session } = await authenticate.admin(request);
+     *   const {
+     *     admin,
+     *     session,
+     *   } = await authenticate.admin(request);
+     *
      *   const response = admin.rest.post({
      *     path: "customers/7392136888625/send_invite.json",
      *     body: {
@@ -101,7 +117,8 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      *         custom_message: "My awesome new store",
      *       },
      *     },
-     * });
+     *   });
+     *
      *   const customerInvite = await response.json();
      *   return json({ customerInvite });
      * };
@@ -131,10 +148,11 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * <caption>Querying the GraphQL API.</caption>
      * <description>Use `admin.graphql` to make query / mutation requests.</description>
      * ```ts
+     * // /app/routes/**\/*.ts
      * import { ActionFunctionArgs } from "@remix-run/node";
      * import { authenticate } from "../shopify.server";
      *
-     * export async function action({ request }: ActionFunctionArgs) {
+     * export const action = async ({ request }: ActionFunctionArgs) => {
      *   const { admin } = await authenticate.admin(request);
      *
      *   const response = await admin.graphql(
@@ -146,11 +164,17 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      *         }
      *       }
      *     }`,
-     *     { variables: { input: { title: "Product Name" } } }
+     *     {
+     *       variables: {
+     *         input: { title: "Product Name" },
+     *       },
+     *     },
      *   );
      *
      *   const productData = await response.json();
-     *   return json({ data: productData.data });
+     *   return json({
+     *     productId: productData.data?.productCreate?.product?.id,
+     *   });
      * }
      * ```
      *
@@ -159,11 +183,58 @@ export interface AdminApiContext<Resources extends ShopifyRestResources = Shopif
      * import { shopifyApp } from "@shopify/shopify-app-remix/server";
      *
      * const shopify = shopifyApp({
-     *   restResources,
-     *   // ...etc
+     *   // ...
      * });
      * export default shopify;
-     * export const unauthenticated = shopify.unauthenticated;
+     * export const authenticate = shopify.authenticate;
+     * ```
+     *
+     * @example
+     * <caption>Handling GraphQL errors.</caption>
+     * <description>Catch `GraphqlQueryError` errors to see error messages from the API.</description>
+     * ```ts
+     * // /app/routes/**\/*.ts
+     * import { ActionFunctionArgs } from "@remix-run/node";
+     * import { authenticate } from "../shopify.server";
+     *
+     * export const action = async ({ request }: ActionFunctionArgs) => {
+     *   const { admin } = await authenticate.admin(request);
+     *
+     *   try {
+     *     const response = await admin.graphql(
+     *       `#graphql
+     *       query incorrectQuery {
+     *         products(first: 10) {
+     *           nodes {
+     *             not_a_field
+     *           }
+     *         }
+     *       }`,
+     *     );
+     *
+     *     return json({ data: await response.json() });
+     *   } catch (error) {
+     *     if (error instanceof GraphqlQueryError) {
+     *       // error.body.errors:
+     *       // { graphQLErrors: [
+     *       //   { message: "Field 'not_a_field' doesn't exist on type 'Product'" }
+     *       // ] }
+     *       return json({ errors: error.body?.errors }, { status: 500 });
+     *     }
+     *     return json({ message: "An error occurred" }, { status: 500 });
+     *   }
+     * }
+     * ```
+     *
+     * ```ts
+     * // /app/shopify.server.ts
+     * import { shopifyApp } from "@shopify/shopify-app-remix/server";
+     *
+     * const shopify = shopifyApp({
+     *   // ...
+     * });
+     * export default shopify;
+     * export const authenticate = shopify.authenticate;
      * ```
      */
     graphql: GraphQLClient<AdminOperations>;

package/build/ts/server/clients/admin/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/clients/admin/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,QAAQ,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CAC5C;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE;IACzC,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,oBAAoB,GAAG,oBAAoB;IAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyGG;IACH,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/clients/admin/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,QAAQ,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CAC5C;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE;IACzC,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,oBAAoB,GAAG,oBAAoB;IAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0HG;IACH,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkGG;IACH,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACzC"}

package/build/ts/server/clients/storefront/types.d.ts

@@ -24,6 +24,53 @@ export interface StorefrontContext {
      *   return json(await response.json());
      * }
      * ```
+     *
+     * @example
+     * <caption>Handling GraphQL errors.</caption>
+     * <description>Catch `GraphqlQueryError` errors to see error messages from the API.</description>
+     * ```ts
+     * // /app/routes/**\/*.ts
+     * import { ActionFunctionArgs } from "@remix-run/node";
+     * import { authenticate } from "../shopify.server";
+     *
+     * export const action = async ({ request }: ActionFunctionArgs) => {
+     *   const { storefront } = await authenticate.public.appProxy(request);
+     *
+     *   try {
+     *     const response = await storefront.graphql(
+     *       `#graphql
+     *       query incorrectQuery {
+     *         products(first: 10) {
+     *           nodes {
+     *             not_a_field
+     *           }
+     *         }
+     *       }`,
+     *     );
+     *
+     *     return json({ data: await response.json() });
+     *   } catch (error) {
+     *     if (error instanceof GraphqlQueryError) {
+     *       // { errors: { graphQLErrors: [
+     *       //   { message: "Field 'not_a_field' doesn't exist on type 'Product'" }
+     *       // ] } }
+     *       return json({ errors: error.body?.errors }, { status: 500 });
+     *     }
+     *     return json({ message: "An error occurred" }, { status: 500 });
+     *   }
+     * }
+     * ```
+     *
+     * ```ts
+     * // /app/shopify.server.ts
+     * import { shopifyApp } from "@shopify/shopify-app-remix/server";
+     *
+     * const shopify = shopifyApp({
+     *   // ...
+     * });
+     * export default shopify;
+     * export const authenticate = shopify.authenticate;
+     * ```
      */
     graphql: GraphQLClient<StorefrontOperations>;
 }

package/build/ts/server/clients/storefront/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/clients/storefront/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/server/clients/storefront/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsEG;IACH,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C"}

package/build/ts/server/clients/types.d.ts

@@ -1,10 +1,23 @@
 import type { AllOperations, ReturnData, FetchResponseBody, ApiClientRequestOptions, ResponseWithType } from '@shopify/admin-api-client';
 import { ApiVersion } from '@shopify/shopify-api';
 export interface GraphQLQueryOptions<Operation extends keyof Operations, Operations extends AllOperations> {
+    /**
+     * The variables to pass to the operation.
+     */
     variables?: ApiClientRequestOptions<Operation, Operations>['variables'];
+    /**
+     * The version of the API to use for the request.
+     */
     apiVersion?: ApiVersion;
+    /**
+     * Additional headers to include in the request.
+     */
     headers?: Record<string, any>;
+    /**
+     * The total number of times to try the request if it fails.
+     */
     tries?: number;
 }
-export type GraphQLClient<Operations extends AllOperations> = <Operation extends keyof Operations>(query: Operation, options?: GraphQLQueryOptions<Operation, Operations>) => Promise<ResponseWithType<FetchResponseBody<ReturnData<Operation, Operations>>>>;
+export type GraphQLResponse<Operation extends keyof Operations, Operations extends AllOperations> = ResponseWithType<FetchResponseBody<ReturnData<Operation, Operations>>>;
+export type GraphQLClient<Operations extends AllOperations> = <Operation extends keyof Operations>(query: Operation, options?: GraphQLQueryOptions<Operation, Operations>) => Promise<GraphQLResponse<Operation, Operations>>;
 //# sourceMappingURL=types.d.ts.map

package/build/ts/server/clients/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/clients/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAEhD,MAAM,WAAW,mBAAmB,CAClC,SAAS,SAAS,MAAM,UAAU,EAClC,UAAU,SAAS,aAAa;IAEhC,SAAS,CAAC,EAAE,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACxE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,aAAa,IAAI,CAC5D,SAAS,SAAS,MAAM,UAAU,EAElC,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,KACjD,OAAO,CACV,gBAAgB,CAAC,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CACvE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/clients/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAEhD,MAAM,WAAW,mBAAmB,CAClC,SAAS,SAAS,MAAM,UAAU,EAClC,UAAU,SAAS,aAAa;IAEhC;;OAEG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACxE;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,CACzB,SAAS,SAAS,MAAM,UAAU,EAClC,UAAU,SAAS,aAAa,IAC9B,gBAAgB,CAAC,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,aAAa,IAAI,CAC5D,SAAS,SAAS,MAAM,UAAU,EAElC,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,KACjD,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC"}

package/build/ts/server/future/flags.d.ts

@@ -1,4 +1,5 @@
-import type { ConfigParams, ShopifyRestResources } from '@shopify/shopify-api';
+import type { ConfigParams, Shopify, ShopifyRestResources } from '@shopify/shopify-api';
+import { AppConfig } from '../config-types';
 export interface FutureFlags {
     /**
      * When enabled, returns the same `admin` context (`AdminApiContext`) from `authenticate.webhook` that is returned from `authenticate.admin`.
@@ -32,4 +33,5 @@ export interface ApiFutureFlags<Future extends FutureFlagOptions> {
 export type ApiConfigWithFutureFlags<Future extends FutureFlagOptions> = ConfigParams<ShopifyRestResources, ApiFutureFlags<Future>>;
 export type FutureFlagOptions = FutureFlags | undefined;
 export type FeatureEnabled<Future extends FutureFlagOptions, Flag extends keyof FutureFlags> = Future extends FutureFlags ? Future[Flag] extends true ? true : false : false;
+export declare function logDisabledFutureFlags(config: AppConfig, logger: Shopify['logger']): void;
 //# sourceMappingURL=flags.d.ts.map

package/build/ts/server/future/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/server/future/flags.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAG7E,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;CAC5C;AAID,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,iBAAiB;IAC9D,mBAAmB,EAAE,MAAM,SAAS,WAAW,GAC3C,MAAM,CAAC,oBAAoB,CAAC,GAC5B,KAAK,CAAC;CACX;AAED,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,iBAAiB,IACnE,YAAY,CAAC,oBAAoB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC;AAExD,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,iBAAiB,EAChC,IAAI,SAAS,MAAM,WAAW,IAC5B,MAAM,SAAS,WAAW,GAC1B,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,GACvB,IAAI,GACJ,KAAK,GACP,KAAK,CAAC"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../../src/server/future/flags.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAG1C,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;CAC5C;AAID,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,iBAAiB;IAC9D,mBAAmB,EAAE,MAAM,SAAS,WAAW,GAC3C,MAAM,CAAC,oBAAoB,CAAC,GAC5B,KAAK,CAAC;CACX;AAED,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,iBAAiB,IACnE,YAAY,CAAC,oBAAoB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC;AAExD,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,iBAAiB,EAChC,IAAI,SAAS,MAAM,WAAW,IAC5B,MAAM,SAAS,WAAW,GAC1B,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,GACvB,IAAI,GACJ,KAAK,GACP,KAAK,CAAC;AAEV,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,QAiC1B"}

package/build/ts/server/future/flags.js

@@ -1,4 +1,24 @@
 "use strict";
 // When adding new flags, you should also add them to the `TEST_FUTURE_FLAGS` object in `test-config.ts` to ensure that
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.logDisabledFutureFlags = void 0;
+function logDisabledFutureFlags(config, logger) {
+    var logFlag = function (flag, message) {
+        return logger.info("Future flag ".concat(flag, " is disabled.\n\n  ").concat(message, "\n"));
+    };
+    if (!config.future.v3_authenticatePublic) {
+        logFlag('v3_authenticatePublic', 'Enable this flag to allow appProxy and checkout in `shopify.authenticate.public`.');
+    }
+    if (!config.future.v3_lineItemBilling) {
+        logFlag('v3_lineItemBilling', 'Enable this flag to allow billing plans with multiple line items.');
+    }
+    if (!config.future.v3_webhookAdminContext) {
+        logFlag('v3_webhookAdminContext', 'Enable this flag to use the standard Admin context when calling `shopify.authenticate.webhook`.');
+    }
+    if (!config.future.unstable_newEmbeddedAuthStrategy) {
+        logFlag('unstable_newEmbeddedAuthStrategy', 'Enable this to use OAuth token exchange instead of auth code to generate API access tokens.' +
+            '\n  Your app must be using Shopify managed install: https://shopify.dev/docs/apps/auth/installation');
+    }
+}
+exports.logDisabledFutureFlags = logDisabledFutureFlags;
 //# sourceMappingURL=flags.js.map

package/build/ts/server/future/flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../../src/server/future/flags.ts"],"names":[],"mappings":";AAAA,uHAAuH"}
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../../src/server/future/flags.ts"],"names":[],"mappings":";AAAA,uHAAuH;;;AAgEvH,SAAgB,sBAAsB,CACpC,MAAiB,EACjB,MAAyB;IAEzB,IAAM,OAAO,GAAG,UAAC,IAAY,EAAE,OAAe;QAC5C,OAAA,MAAM,CAAC,IAAI,CAAC,sBAAe,IAAI,gCAAsB,OAAO,OAAI,CAAC;IAAjE,CAAiE,CAAC;IAEpE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACzC,OAAO,CACL,uBAAuB,EACvB,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACtC,OAAO,CACL,oBAAoB,EACpB,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAC1C,OAAO,CACL,wBAAwB,EACxB,iGAAiG,CAClG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,gCAAgC,EAAE,CAAC;QACpD,OAAO,CACL,kCAAkC,EAClC,6FAA6F;YAC3F,qGAAqG,CACxG,CAAC;IACJ,CAAC;AACH,CAAC;AAnCD,wDAmCC"}

package/build/ts/server/shopify-app.d.ts

@@ -25,5 +25,5 @@ import { FutureFlagOptions } from './future/flags';
  * export default shopify;
  * ```
  */
-export declare function shopifyApp<Config extends AppConfigArg<Resources, Storage, Future>, Resources extends ShopifyRestResources, Storage extends SessionStorage, Future extends FutureFlagOptions = Config['future']>(appConfig: Config): ShopifyApp<Config>;
+export declare function shopifyApp<Config extends AppConfigArg<Resources, Storage, Future>, Resources extends ShopifyRestResources, Storage extends SessionStorage, Future extends FutureFlagOptions = Config['future']>(appConfig: Readonly<Config>): ShopifyApp<Config>;
 //# sourceMappingURL=shopify-app.d.ts.map

package/build/ts/server/shopify-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shopify-app.d.ts","sourceRoot":"","sources":["../../../src/server/shopify-app.ts"],"names":[],"mappings":"AAAA,OAAO,uCAAuC,CAAC;AAC/C,OAAO,EAIL,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,cAAc,EAAC,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EAAiB,KAAK,YAAY,EAAC,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAIL,KAAK,UAAU,EAKhB,MAAM,SAAS,CAAC;AAejB,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,MAAM,SAAS,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EACvD,SAAS,SAAS,oBAAoB,EACtC,OAAO,SAAS,cAAc,EAC9B,MAAM,SAAS,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,EACnD,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAiDvC"}
+{"version":3,"file":"shopify-app.d.ts","sourceRoot":"","sources":["../../../src/server/shopify-app.ts"],"names":[],"mappings":"AAAA,OAAO,uCAAuC,CAAC;AAC/C,OAAO,EAIL,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,cAAc,EAAC,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EAAiB,KAAK,YAAY,EAAC,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAIL,KAAK,UAAU,EAKhB,MAAM,SAAS,CAAC;AAgBjB,OAAO,EAAC,iBAAiB,EAAyB,MAAM,gBAAgB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,MAAM,SAAS,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EACvD,SAAS,SAAS,oBAAoB,EACtC,OAAO,SAAS,cAAc,EAC9B,MAAM,SAAS,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,EACnD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAqDjD"}