@moonbase.sh/storefront 3.15.0 → 3.16.0

package/README.md

@@ -706,6 +706,21 @@ const { payload } = await jwtVerify(token, jwks, {
 
 Don't read the widget's `localStorage` entry yourself: it holds the refresh token as well, which must never leave the browser.
 
+## Saving the customer's address
+
+`Moonbase.updateAddress(address)` saves the signed-in customer's address and resolves to the customer as saved. Their next checkout starts from it; a checkout they have already entered billing details in keeps those. It rejects when nobody is signed in, and for an address the store can't use: it needs a known country, a street address, a city or a region, and in the US a postal code.
+
+```ts
+const user = await Moonbase.updateAddress({
+  countryCode: 'AU',
+  streetAddress1: '1 George Street',
+  streetAddress2: null,
+  locality: 'Sydney',
+  region: 'NSW',
+  postCode: '2000',
+})
+```
+
 ## Integrations
 
 The widget can forward its commerce and auth events to common marketing/analytics SDKs without any extra glue code. Enable a provider by passing its config in `integrations`:

package/dist/moonbase.d.ts

@@ -1,4 +1,5 @@
 import { ActivationRequestFulfillmentType } from '@moonbase.sh/vue';
+import { Address } from '@moonbase.sh/vue';
 import { CartItem } from '@moonbase.sh/vue';
 import { CheckoutBackdropColor } from '@moonbase.sh/vue';
 import { CheckoutBackdropOpacity } from '@moonbase.sh/vue';
@@ -288,6 +289,7 @@ declare class MoonbaseImpl implements MoonbaseInstance {
     configure(options: DeepPartial<MoonbaseOptions>): void;
     on<TEvent extends MoonbaseEvent>(eventType: TEvent, callback: (event: MoonbaseEventArgs[TEvent]) => void): void;
     getAccessToken(): Promise<string | null>;
+    updateAddress(address: Address): Promise<User>;
     private handleLocationIntent;
     sign_in(parameters?: MoonbaseIntentArgs['sign_in']): void;
     sign_up(parameters?: MoonbaseIntentArgs['sign_up']): void;
@@ -330,6 +332,14 @@ export declare type MoonbaseInstance = MoonbaseInstanceIntents & {
      * account's public key, at `/api/key/jwks` on your Moonbase address.
      */
     getAccessToken: () => Promise<string | null>;
+    /**
+     * Saves the signed-in customer's address, which their next checkout starts from, and
+     * resolves to the customer as saved. A checkout they have already entered billing details
+     * in keeps those. Rejects when nobody is signed in, and for an address the store can't
+     * use: it needs a known country, a street address, a city or a region, and in the US a
+     * postal code.
+     */
+    updateAddress: (address: Address) => Promise<User>;
 };
 
 declare type MoonbaseInstanceIntents = {