@liquidcommerce/elements-sdk 2.6.0-beta.124 → 2.6.0-beta.125

package/dist/types/core/api/api-client.service.d.ts

@@ -15,8 +15,8 @@ export declare class ApiClientService {
     setPersistedStore(userDeviceId: string, data: IPersistedStore): Promise<ApiResult<IPersistedStoreAction>>;
     getPersistedStore(userDeviceId: string): Promise<ApiResult<IPersistedStore>>;
     deletePersistedStore(userDeviceId: string): Promise<ApiResult<IPersistedStoreAction>>;
-    getAddressSuggestions(input: string): Promise<ApiResult<IAddressAutocompleteResult[]>>;
-    getAddressDetails(id: string): Promise<ApiResult<IAddressDetailsResult>>;
+    getAddressSuggestions(input: string, sessionToken?: string): Promise<ApiResult<IAddressAutocompleteResult[]>>;
+    getAddressDetails(id: string, sessionToken?: string): Promise<ApiResult<IAddressDetailsResult>>;
     getProductsData(identifier: string[], location?: ILocation): Promise<ApiResult<IProductAvailabilityResponse>>;
     productListSearch(params: IProductSearchParams): Promise<ApiResult<IProductSearchResponse>>;
     getProductAvailabilityByState(identifiers: string[], state?: string): Promise<ApiResult<IProductAvailabilityResponse>>;

package/dist/types/core/client/actions/client-address-action.service.d.ts

@@ -1,7 +1,7 @@
 import type { IAddressAddress, IAddressCoordinates, IAddressData } from '@/interfaces/api/address.interface';
 import { BaseActionService } from './base-action.service';
 export interface IAddressActions {
-    setAddressByPlacesId: (placesId: string) => Promise<void>;
+    setAddressByPlacesId: (placesId: string, sessionToken?: string) => Promise<void>;
     setAddressManually: (address: IAddressAddress, coordinates: IAddressCoordinates) => Promise<void>;
     clear: () => Promise<void>;
     getDetails: () => IAddressData | null;

package/dist/types/modules/address/address-input.component.d.ts

@@ -12,6 +12,7 @@ export declare class AddressInputComponent extends BaseComponent<IAddressInputCo
     private selectedAddress;
     private searchTimeout?;
     private minSearchLength;
+    private placesSessionToken;
     private inputElement;
     private suggestionsContainer;
     private errorContainer;

package/dist/types/modules/address/address.command.d.ts

@@ -5,8 +5,8 @@ export declare class AddressCommands extends BaseCommand {
     private cartCommands;
     constructor();
     static getInstance(): AddressCommands;
-    searchAddresses(query: string): Promise<IAddressAutocompleteResult[]>;
-    getAddressDetails(addressId: string): Promise<IAddressDetailsResult | null>;
+    searchAddresses(query: string, sessionToken?: string): Promise<IAddressAutocompleteResult[]>;
+    getAddressDetails(addressId: string, sessionToken?: string): Promise<IAddressDetailsResult | null>;
     setSelectedAddress(addressData: IAddressData): Promise<void>;
     setAddressManually(address: IAddressAddress, coordinates: IAddressCoordinates): Promise<void>;
     clearSelectedAddress(): Promise<void>;

package/dist/types/utils/places-session-token.d.ts

@@ -0,0 +1 @@
+export declare function createPlacesSessionToken(): string;

package/docs/v1/api/actions/address-actions.md

@@ -9,7 +9,7 @@ Set address using a Google Places ID.
 ### Signature
 
 ```typescript
-setAddressByPlacesId(placesId: string): Promise<void>
+setAddressByPlacesId(placesId: string, sessionToken?: string): Promise<void>
 ```
 
 ### Parameters
@@ -17,6 +17,7 @@ setAddressByPlacesId(placesId: string): Promise<void>
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `placesId` | string | Yes | Google Places ID |
+| `sessionToken` | string | No | Google Places session token of the autocomplete requests that returned `placesId`. The details request ends that session, so Google bills the autocomplete requests as one session instead of per request. Applies only when the autocomplete requests used an API key in the same Google Cloud project as LiquidCommerce's address service. |
 
 ### Example
 
@@ -24,6 +25,9 @@ setAddressByPlacesId(placesId: string): Promise<void>
 await window.LiquidCommerce.elements.actions.address.setAddressByPlacesId(
   'ChIJOwg_06VPwokRYv534QaPC8g'
 );
+
+// With the session token your own Places Autocomplete requests used
+await window.LiquidCommerce.elements.actions.address.setAddressByPlacesId(placesId, sessionToken);
 ```
 
 ### How to Get Places ID

package/docs/v1/guides/address-component.md

@@ -56,6 +56,12 @@ The recommended method - provides accurate geocoding:
 await window.LiquidCommerce.elements.actions.address.setAddressByPlacesId('ChIJOwg_06VPwokRYv534QaPC8g');
 ```
 
+If you run Google Places Autocomplete yourself with a [session token](https://developers.google.com/maps/documentation/places/web-service/session-tokens), pass the same token as the second argument. The details request then ends your session, and Google bills the autocomplete requests as one session instead of per request. Google only groups requests whose API keys belong to the same Google Cloud project, so this applies only when your autocomplete requests used the same project as LiquidCommerce's address service; a token from autocomplete requests made with an API key in another project doesn't change billing:
+
+```javascript
+await window.LiquidCommerce.elements.actions.address.setAddressByPlacesId(placesId, sessionToken);
+```
+
 **How to get a Places ID:**
 
 Visit [Google Place IDs](https://developers.google.com/maps/documentation/places/web-service/place-id#find-id) for details on obtaining a Places ID.

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.6.0-beta.124",
+  "version": "2.6.0-beta.125",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",