@shopify/shopify-app-remix 4.2.0 → 4.2.1

package/src/react/components/AppProvider/AppProvider.doc.ts

@@ -1,35 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'AppProvider',
-  descriptionType: 'AppProviderGeneratedType',
-  description: '',
-  category: 'Entrypoints',
-  type: 'component',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'AppProviderProps',
-      description: 'Props for the `AppProvider` component.',
-      type: 'AppProviderProps',
-      filePath: 'src/react/components/AppProvider/AppProvider.tsx',
-    },
-  ],
-  jsDocTypeExamples: ['AppProviderGeneratedType'],
-  related: [
-    {
-      name: 'App bridge',
-      subtitle: 'Learn more about App Bridge.',
-      url: '/docs/api/app-bridge-library',
-      type: 'shopify',
-    },
-    {
-      name: 'Polaris',
-      subtitle: 'Learn more about Polaris.',
-      url: '/docs/apps/tools/polaris',
-      type: 'shopify',
-    },
-  ],
-};
-
-export default data;

package/src/react/components/AppProxyForm/AppProxyForm.doc.ts

@@ -1,28 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'AppProxyForm',
-  descriptionType: 'AppProxyFormGeneratedType',
-  description: '',
-  category: 'App proxy components',
-  type: 'component',
-  isVisualComponent: false,
-  definitions: [],
-  jsDocTypeExamples: ['AppProxyFormGeneratedType'],
-  related: [
-    {
-      name: 'authenticate.public.appProxy',
-      subtitle: 'Authenticating app proxy requests.',
-      url: '/docs/api/shopify-app-remix/authenticate/public/app-proxy',
-      type: 'remix',
-    },
-    {
-      name: 'AppProxyProvider',
-      subtitle: 'Enable JavaScript in pages loaded through app proxies.',
-      url: '/docs/api/shopify-app-remix/app-proxy-components/appproxyprovider',
-      type: 'remix',
-    },
-  ],
-};
-
-export default data;

package/src/react/components/AppProxyLink/AppProxyLink.doc.ts

@@ -1,28 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'AppProxyLink',
-  descriptionType: 'AppProxyLinkGeneratedType',
-  description: '',
-  category: 'App proxy components',
-  type: 'component',
-  isVisualComponent: false,
-  definitions: [],
-  jsDocTypeExamples: ['AppProxyLinkGeneratedType'],
-  related: [
-    {
-      name: 'authenticate.public.appProxy',
-      subtitle: 'Authenticating app proxy requests.',
-      url: '/docs/api/shopify-app-remix/authenticate/public/app-proxy',
-      type: 'remix',
-    },
-    {
-      name: 'AppProxyProvider',
-      subtitle: 'Enable JavaScript in pages loaded through app proxies.',
-      url: '/docs/api/shopify-app-remix/app-proxy-components/appproxyprovider',
-      type: 'remix',
-    },
-  ],
-};
-
-export default data;

package/src/react/components/AppProxyProvider/AppProxyProvider.doc.ts

@@ -1,40 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'AppProxyProvider',
-  descriptionType: 'AppProxyProviderGeneratedType',
-  description: '',
-  category: 'Entrypoints',
-  type: 'component',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'AppProxyProviderProps',
-      description: 'Props for the `AppProxyProvider` component.',
-      type: 'AppProxyProviderProps',
-    },
-  ],
-  jsDocTypeExamples: ['AppProxyProviderGeneratedType'],
-  related: [
-    {
-      name: 'authenticate.public.appProxy',
-      subtitle: 'Authenticate app proxy requests.',
-      url: '/docs/api/shopify-app-remix/authenticate/public/app-proxy',
-      type: 'remix',
-    },
-    {
-      name: 'AppProxyForm',
-      subtitle: 'Render form elements in proxies.',
-      url: '/docs/api/shopify-app-remix/app-proxy-components/appproxyform',
-      type: 'remix',
-    },
-    {
-      name: 'AppProxyLink',
-      subtitle: 'Render link elements in proxies.',
-      url: '/docs/api/shopify-app-remix/app-proxy-components/appproxylink',
-      type: 'remix',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/admin/authenticate.admin.doc.ts

@@ -1,51 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Admin',
-  description:
-    'Contains methods for authenticating and interacting with the Admin API.\n\nThis function can handle requests for apps embedded in the Admin, Admin extensions, or non-embedded apps.',
-  category: 'Authenticate',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.admin',
-      description:
-        'Authenticates requests coming from the Shopify admin.\n\nThe shape of the returned object changes depending on the `isEmbeddedApp` config.',
-      type: 'AuthenticateAdmin',
-    },
-  ],
-  defaultExample: {
-    description: 'Authenticate, run API mutation, and redirect',
-    codeblock: {
-      title: 'Authenticate, run API mutation, and redirect',
-      tabs: [
-        {
-          title: '/app/routes/**.ts',
-          language: 'typescript',
-          code: './authenticate.admin.doc.example.ts',
-        },
-      ],
-    },
-  },
-  jsDocTypeExamples: [
-    'EmbeddedAdminContext',
-    'AdminApiContext',
-    'BillingContext',
-    'ScopesApiContext',
-  ],
-  related: [
-    {
-      name: 'API context',
-      subtitle: 'Interact with the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/admin-api',
-    },
-    {
-      name: 'Billing context',
-      subtitle: 'Bill merchants for your app using the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/billing',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/admin/billing/authenticate.admin.billing.doc.ts

@@ -1,29 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Billing',
-  description:
-    'Contains function used to bill merchants for your app with the Billing API.\n\nThis object is returned on authenticated Admin requests.' +
-    '\n\n> Note: [Managed App Pricing](/docs/apps/launch/billing/managed-pricing) is now available. Define your app’s pricing plans directly in the Shopify Partner Dashboard, without needing to use the Billing API.',
-  category: 'APIs',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'billing',
-      description:
-        'Provides utilities that apps can use to request billing for the app using the Admin API.',
-      type: 'BillingContext',
-    },
-  ],
-  jsDocTypeExamples: ['BillingContext'],
-  related: [
-    {
-      name: 'Admin context',
-      subtitle: 'Authenticate requests from Shopify Admin.',
-      url: '/docs/api/shopify-app-remix/authenticate/admin',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/admin/scope/authenticate.admin.scopes.doc.ts

@@ -1,28 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Scopes',
-  description:
-    'Contains functions used to manage scopes for your app.\n\nThis object is returned on authenticated Admin requests.',
-  category: 'APIs',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'scopes',
-      description:
-        'Provides utilities that apps can use to [manage scopes](https://shopify.dev/docs/apps/build/authentication-authorization/app-installation/manage-access-scopes) for the app using the Admin API.',
-      type: 'ScopesApiContext',
-    },
-  ],
-  jsDocTypeExamples: ['ScopesApiContext'],
-  related: [
-    {
-      name: 'Admin context',
-      subtitle: 'Authenticate requests from Shopify Admin.',
-      url: '/docs/api/shopify-app-remix/authenticate/admin',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/flow/authenticate.flow.doc.ts

@@ -1,47 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Flow',
-  description:
-    'Contains functions for verifying Shopify Flow extensions.' +
-    '\n\nSee the [Flow documentation](https://shopify.dev/docs/apps/flow/actions/endpoints) for more information.',
-  category: 'Authenticate',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.flow',
-      description: 'Verifies requests coming from Shopify Flow extensions.',
-      type: 'AuthenticateFlow',
-    },
-  ],
-  defaultExample: {
-    description: 'Handle a flow action call',
-    codeblock: {
-      title: 'Set a metafield on a customer after a flow call',
-      tabs: [
-        {
-          title: '/app/routes/**.ts',
-          language: 'typescript',
-          code: './authenticate.flow.doc.example.ts',
-        },
-      ],
-    },
-  },
-  jsDocTypeExamples: ['FlowContext'],
-  related: [
-    {
-      name: 'Admin API context',
-      subtitle: 'Interact with the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/admin-api',
-    },
-    {
-      name: 'Flow action endpoints',
-      subtitle: 'Receive requests from Flow.',
-      url: '/docs/apps/flow/actions/endpoints',
-      type: 'shopify',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/fulfillment-service/authenticate.fulfillment-service.doc.ts

@@ -1,48 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Fulfillment Service',
-  description:
-    'Contains functions for verifying fulfillment service requests.' +
-    '\n\nSee the [fulfillment service documentation](https://shopify.dev/docs/apps/fulfillment/fulfillment-service-apps) for more information.',
-  category: 'Authenticate',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.fulfillmentService',
-      description:
-        'Verifies requests coming from Shopify to fulfillment service apps',
-      type: 'AuthenticateFulfillmentService',
-    },
-  ],
-  defaultExample: {
-    description: 'Handle a fulfillment service notification call',
-    codeblock: {
-      title: 'Consume a fulfillment service notification request',
-      tabs: [
-        {
-          title: '/app/routes/**.ts',
-          language: 'typescript',
-          code: './authenticate.fulfillment-service.doc.example.ts',
-        },
-      ],
-    },
-  },
-  jsDocTypeExamples: ['FulfillmentServiceContext'],
-  related: [
-    {
-      name: 'Admin API context',
-      subtitle: 'Interact with the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/admin-api',
-    },
-    {
-      name: 'Manage Fulfillments',
-      subtitle: 'Receive fulfillment requests and cancellations.',
-      url: '/docs/apps/fulfillment/fulfillment-service-apps/manage-fulfillments',
-      type: 'shopify',
-    },
-  ],
-};
-
-export default data;

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

@@ -1,55 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'App proxy',
-  description:
-    '[App proxies](/docs/apps/online-store/app-proxies) take requests to Shopify links, and redirect them to external links.' +
-    '\nThe `authenticate.public.appProxy` function validates requests made to app proxies, and returns a context to enable querying Shopify APIs.' +
-    '\n\n> Note: If the store has not installed the app, store-related properties such as `admin` or `storefront` will be `undefined`',
-  category: 'Authenticate',
-  subCategory: 'Public',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.public.appProxy',
-      description:
-        'Authenticates requests coming to the app from Shopify app proxies.',
-      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: [
-    {
-      name: 'Admin API context',
-      subtitle: 'Interact with the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/admin-api',
-    },
-    {
-      name: 'Storefront API context',
-      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',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/public/checkout/authenticate.public.checkout.doc.ts

@@ -1,49 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Checkout',
-  description:
-    'The `authenticate.public.checkout` function ensures that checkout extension requests are coming from Shopify, and returns helpers to respond with the correct headers.',
-  category: 'Authenticate',
-  subCategory: 'Public',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.public.checkout',
-      description:
-        'Authenticates requests coming from Shopify checkout extensions.',
-      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: [
-    {
-      name: 'Session token API',
-      subtitle:
-        'Checkout UI extension API for interacting with session tokens.',
-      url: '/docs/api/checkout-ui-extensions/latest/apis/session-token',
-      type: 'shopify',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/public/customer-account/authenticate.public.customerAccount.doc.ts

@@ -1,49 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Customer account',
-  description:
-    'The `authenticate.public.customerAccount` function ensures that customer account extension requests are coming from Shopify, and returns helpers to respond with the correct headers.',
-  category: 'Authenticate',
-  subCategory: 'Public',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.public.customerAccount',
-      description:
-        'Authenticates requests coming from Shopify customer account extensions.',
-      type: 'AuthenticateCustomerAccount',
-    },
-  ],
-  defaultExample: {
-    description: 'Authenticate and return offers for the customer',
-    codeblock: {
-      title: 'Authenticate and return offers for the customer',
-      tabs: [
-        {
-          title: '/app/routes/**.ts',
-          language: 'typescript',
-          code: './authenticate.public.customerAccount.doc.example.ts',
-        },
-        {
-          title: '/app/offers.server.ts',
-          language: 'typescript',
-          code: './authenticate.public.customerAccount.doc.example.offers.ts',
-        },
-      ],
-    },
-  },
-  jsDocTypeExamples: ['CustomerAccountContext'],
-  related: [
-    {
-      name: 'Session token API',
-      subtitle:
-        'Customer account UI extensions API for interacting with session tokens.',
-      url: '/docs/api/customer-account-ui-extensions/latest/apis/session-token',
-      type: 'shopify',
-    },
-  ],
-};
-
-export default data;

package/src/server/authenticate/webhooks/authenticate.webhooks.doc.ts

@@ -1,39 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Webhook',
-  description: 'Contains functions for verifying Shopify webhooks.',
-  category: 'Authenticate',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'authenticate.webhook',
-      description: 'Verifies requests coming from Shopify webhooks.',
-      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: [
-    {
-      name: 'Admin API context',
-      subtitle: 'Interact with the Admin API.',
-      url: '/docs/api/shopify-app-remix/apis/admin-api',
-    },
-  ],
-};
-
-export default data;

package/src/server/clients/admin/authenticate.admin.api.doc.ts

@@ -1,34 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Admin API',
-  description:
-    'Contains objects used to interact with the Admin API.' +
-    '\n\nThis object is returned as part of different contexts, such as [`admin`](/docs/api/shopify-app-remix/authenticate/admin), [`unauthenticated.admin`](/docs/api/shopify-app-remix/unauthenticated/unauthenticated-admin), and [`webhook`](/docs/api/shopify-app-remix/authenticate/webhook).',
-  category: 'APIs',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'admin',
-      description:
-        'Provides utilities that apps can use to make requests to the Admin API.',
-      type: 'AdminApiContext',
-    },
-  ],
-  jsDocTypeExamples: ['AdminApiContext'],
-  related: [
-    {
-      name: 'Authenticated context',
-      subtitle: 'Authenticate requests from Shopify Admin.',
-      url: '/docs/api/shopify-app-remix/authenticate/admin',
-    },
-    {
-      name: 'Unauthenticated context',
-      subtitle: 'Interact with the Admin API on non-Shopify requests.',
-      url: '/docs/api/shopify-app-remix/unauthenticated/unauthenticated-admin',
-    },
-  ],
-};
-
-export default data;

package/src/server/clients/storefront/authenticate.storefront.api.doc.ts

@@ -1,34 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'Storefront API',
-  description:
-    'Contains objects used to interact with the Storefront API.' +
-    '\n\nThis object is returned as part of different contexts, such as [`appProxy`](/docs/api/shopify-app-remix/authenticate/public/app-proxy), and [`unauthenticated.storefront`](/docs/api/shopify-app-remix/unauthenticated/unauthenticated-storefront).',
-  category: 'APIs',
-  type: 'object',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'storefront',
-      description:
-        'Provides utilities that apps can use to make requests to the Storefront API.',
-      type: 'StorefrontContext',
-    },
-  ],
-  jsDocTypeExamples: ['StorefrontContext'],
-  related: [
-    {
-      name: 'App proxy context',
-      subtitle: 'Authenticate requests from Shopify app proxies.',
-      url: '/docs/api/shopify-app-remix/authenticate/public/app-proxy',
-    },
-    {
-      name: 'Unauthenticated context',
-      subtitle: 'Interact with the Storefront API on non-Shopify requests.',
-      url: '/docs/api/shopify-app-remix/unauthenticated/unauthenticated-storefront',
-    },
-  ],
-};
-
-export default data;

package/src/server/shopify-app.doc.ts

@@ -1,45 +0,0 @@
-import {ReferenceEntityTemplateSchema} from '@shopify/generate-docs';
-
-const data: ReferenceEntityTemplateSchema = {
-  name: 'shopifyApp',
-  description:
-    "Returns a set of functions that can be used by the app's backend to be able to respond to all Shopify requests." +
-    '\n\nThe shape of the returned object changes depending on the value of `distribution`. If it is `AppDistribution.ShopifyAdmin`, then only `ShopifyAppBase` objects are returned, otherwise `ShopifyAppLogin` objects are included.',
-  category: 'Entrypoints',
-  type: 'function',
-  isVisualComponent: false,
-  definitions: [
-    {
-      title: 'shopifyApp',
-      description: 'Function to create a new Shopify API object.',
-      type: 'ShopifyAppGeneratedType',
-    },
-    {
-      title: 'Future flags',
-      description:
-        'Set future flags using the `future` configuration field to opt in to upcoming breaking changes.' +
-        '\n\nWith this feature, you can prepare for major releases ahead of time, as well as try out new features before they are released.',
-      type: 'FutureFlags',
-      filePath: 'src/server/future/flags.ts',
-    },
-  ],
-  jsDocTypeExamples: [
-    'ShopifyAppGeneratedType',
-    'ShopifyAppBase',
-    'ShopifyAppLogin',
-  ],
-  related: [
-    {
-      name: 'Authenticated contexts',
-      subtitle: 'Authenticate requests coming from Shopify.',
-      url: '/docs/api/shopify-app-remix/authenticate',
-    },
-    {
-      name: 'Unauthenticated contexts',
-      subtitle: 'Interact with the API on non-Shopify requests.',
-      url: '/docs/api/shopify-app-remix/unauthenticated',
-    },
-  ],
-};
-
-export default data;