feat: update customer account config

Signed-off-by: Frederik Bußmann <frederik@bussmann.io>

Author: freb97

bun.lock

@@ -170,7 +170,7 @@ Configure one or more API clients:
   Use mock.shop instead of your actual store - default: `false`
   :::
 
-  :::field{name="proxy" type="boolean | string"}
+  :::field{name="proxy" type="boolean | object"}
   Proxy all client-side requests through Nitro. Use `true` for default path or provide custom path - default: `true`
   :::
 
@@ -230,7 +230,23 @@ Configure one or more API clients:
   Client ID for customer account API requests
   :::
 
-  :::field{name="proxy" type="boolean | string"}
+  :::field{name="scope" type="array"}
+  OAuth scopes to request during authentication - default: `['openid', 'email', 'customer-account-api:full']`
+  :::
+
+  :::field{name="loginURL" type="string"}
+  Login URL for customer account API authentication - default: `/_auth/customer-account/callback`
+  :::
+
+  :::field{name="logoutURL" type="string"}
+  Logout URL for customer account API authentication - default: `/_auth/customer-account/logout`
+  :::
+
+  :::field{name="redirectURL" type="string"}
+  Redirect URL for customer account API authentication
+  :::
+
+  :::field{name="proxy" type="boolean | object"}
   Proxy all client-side requests through Nitro. Use `true` for default path or provide custom path - default: `true`
   :::
 
@@ -369,7 +385,9 @@ export default defineNuxtConfig({
         publicAccessToken: "YOUR_PUBLIC_ACCESS_TOKEN",
         privateAccessToken: "YOUR_PRIVATE_ACCESS_TOKEN",
         mock: false,
-        proxy: true,
+        proxy: {
+          path: "/_proxy/storefront",
+        },
         sandbox: true,
         autoImport: true,
         codegen: {
@@ -398,7 +416,12 @@ export default defineNuxtConfig({
       customerAccount: {
         apiVersion: "2026-01",
         clientId: "YOUR_CLIENT_ID",
-        proxy: true,
+        scope: ["openid", "email", "customer-account-api:full"],
+        loginURL: "/_auth/customer-account/callback",
+        logoutURL: "/_auth/customer-account/logout",
+        proxy: {
+          path: "/_proxy/customer-account",
+        },
         sandbox: true,
         autoImport: true,
         codegen: {
@@ -418,7 +441,9 @@ export default defineNuxtConfig({
         clientSecret: "YOUR_ADMIN_CLIENT_SECRET",
         accessToken: "YOUR_ADMIN_ACCESS_TOKEN",
         refreshToken: "YOUR_ADMIN_REFRESH_TOKEN",
-        tokenStorage: true,
+        tokenStorage: {
+          driver: "memory" 
+        },
         sandbox: true,
         autoImport: false,
         codegen: {

docs/content/2.essentials/2.configuration.md

@@ -62,6 +62,10 @@ function login() {
 </template>
 ```
 
+::tip
+You can change the default authentication routes in the module configuration if you want to use different URLs for the login and logout routes.
+::
+
 ### Logging out
 
 To log the user out, redirect them to `/_auth/customer-account/logout`:

docs/content/2.essentials/4.customer-account.md

@@ -115,14 +115,14 @@
     "@nuxt/eslint-config": "^1.15.2",
     "@nuxt/module-builder": "^1.0.2",
     "@nuxt/schema": "^4.4.2",
-    "@nuxt/test-utils": "^4.0.2",
+    "@nuxt/test-utils": "^4.0.3",
     "@shopify/hydrogen": "^2026.4.2",
     "@types/bun": "^1.3.13",
     "@types/node": "^25.6.0",
     "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^10.2.1",
     "happy-dom": "^20.9.0",
-    "knip": "^6.7.0",
+    "knip": "^6.8.0",
     "nuxt": "^4.4.2",
     "nuxt-auth-utils": "^0.5.29",
     "typescript": "^6.0.3",

package.json

@@ -46,6 +46,8 @@ export const customerAccountClientSchema = clientSchema.extend({
   clientId: z.string(),
   scope: z.array(z.string()).optional(),
   redirectURL: z.string().optional(),
+  loginURL: z.string().optional(),
+  logoutURL: z.string().optional(),
   proxy: z.object({
     path: z.string().optional(),
   }).or(z.boolean()).optional(),

src/schemas/config.ts

@@ -120,6 +120,9 @@ const customerAccountClientSchemaWithDefaults = clientSchemaWithDefaults.omit({
   scope: customerAccountClientSchema.shape.scope,
   redirectURL: customerAccountClientSchema.shape.redirectURL,
 
+  loginURL: customerAccountClientSchema.shape.loginURL.default('_auth/customer-account/callback'),
+  logoutURL: customerAccountClientSchema.shape.logoutURL.default('_auth/customer-account/logout'),
+
   documents: customerAccountClientSchema.shape.documents.transform(v => v ? v : defaultCustomerAccountDocuments),
   proxy: customerAccountClientSchema.shape.proxy.default({ path: '_proxy/customer-account' }).transform(v => typeof v === 'undefined' || v === true ? { path: '_proxy/customer-account' } : v),
 })

src/schemas/runtime.ts

@@ -5,7 +5,7 @@ import type { ShopifyConfig } from '../types'
 
 import { addServerHandler, addServerImports, addTemplate, addTypeTemplate, hasNuxtModule } from '@nuxt/kit'
 import defu from 'defu'
-import { withoutProtocol } from 'ufo'
+import { withLeadingSlash, withoutProtocol } from 'ufo'
 
 import { useLogger } from '../utils/log'
 import {
@@ -64,13 +64,13 @@ export default async function setupClients(nuxt: Nuxt, config: ShopifyConfig, re
 
       addServerHandler({
         method: 'get',
-        route: '/_auth/customer-account/callback',
+        route: withLeadingSlash(config.clients[clientType]?.loginURL),
         handler: resolver.resolve('./runtime/server/api/auth/customer-account/callback'),
       })
 
       addServerHandler({
         method: 'get',
-        route: '/_auth/customer-account/logout',
+        route: withLeadingSlash(config.clients[clientType]?.logoutURL),
         handler: resolver.resolve('./runtime/server/api/auth/customer-account/logout'),
       })
 

src/setup/clients.ts

@@ -82,6 +82,8 @@ describe('test module with nuxt 4', async () => {
           apiVersion: process.env.NUXT_SHOPIFY_CLIENTS_CUSTOMER_ACCOUNT_API_VERSION,
           clientId: process.env.NUXT_SHOPIFY_CLIENTS_CUSTOMER_ACCOUNT_CLIENT_ID,
           documents: expectedCustomerAccountDocuments,
+          loginURL: '_auth/customer-account/callback',
+          logoutURL: '_auth/customer-account/logout',
           proxy: {
             path: '_proxy/customer-account',
           },