@liquidcommerce/elements-sdk 2.7.39 → 2.7.40

package/dist/types/auto-initialize/shared-utils.d.ts

@@ -19,6 +19,7 @@ export declare const SHARED_ATTR: {
         readonly PROMO_CODE_PARAM: "data-promo-code-param";
         readonly CHECKOUT_PARAM: "data-checkout-param";
         readonly CHECKOUT_URL: "data-checkout-url";
+        readonly GTM_GATEWAY_URL: "data-gtm-gateway-url";
     };
     readonly ELEMENT: {
         readonly CHECKOUT: "data-lce-checkout";

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

@@ -1,5 +1,5 @@
 import { type DebugMode, type ElementsEnv } from '@/enums';
-import type { IClientCustomThemeConfig, IElementsProxyConfig, ILiquidCommerceElementsCheckoutConfig } from '@/interfaces/config.interface';
+import type { IClientCustomThemeConfig, IElementsGTMConfig, IElementsProxyConfig, ILiquidCommerceElementsCheckoutConfig } from '@/interfaces/config.interface';
 import type { IPromoTicker } from '@/interfaces/configs';
 export type DeviceType = 'desktop' | 'tablet' | 'mobile';
 export interface IClientConfigs {
@@ -12,6 +12,7 @@ export interface IClientConfigs {
     partnerName?: string;
     customTheme: IClientCustomThemeConfig | null;
     proxy: IElementsProxyConfig | null;
+    gtm: IElementsGTMConfig | null;
     deviceType: DeviceType;
     userDeviceId?: string;
     localStorageKeyPrefix?: string;
@@ -31,6 +32,7 @@ export interface IClientConfigInput {
     debugMode?: DebugMode;
     customTheme?: IClientCustomThemeConfig;
     proxy?: IElementsProxyConfig;
+    gtm?: IElementsGTMConfig;
     promoTicker?: IPromoTicker[];
     development?: {
         customApiUrl?: string;

package/dist/types/core/google-tag-manager.service.d.ts

@@ -51,6 +51,7 @@ export declare class GoogleTagManagerService {
     private partnerName?;
     private partnerCode?;
     private partnerGTMId?;
+    private partnerGatewayUrl?;
     private liquidCommerceGTMId?;
     private enablePartnerGTM;
     private enableLiquidCommerceGTM;
@@ -67,6 +68,12 @@ export declare class GoogleTagManagerService {
     private waitForDOMReady;
     private isGTMAlreadyLoaded;
     private isContainerLoaded;
+    private isGatewayScriptForContainer;
+    private getPartnerGatewayScripts;
+    private parseScriptUrl;
+    private resolveGatewayUrl;
+    private getContainerRegistry;
+    private isContainerRegistered;
     private isContainerInitialized;
     private loadGTMScript;
     private waitForContainerInit;

package/dist/types/interfaces/config.interface.d.ts

@@ -7,6 +7,9 @@ export interface IElementsProxyConfig {
     baseUrl: string;
     headers?: Record<string, string>;
 }
+export interface IElementsGTMConfig {
+    gatewayUrl?: string;
+}
 export interface ILiquidCommerceElementsDevelopmentConfig {
     customApiUrl?: string;
     openShadowDom?: boolean;
@@ -30,6 +33,7 @@ export interface ILiquidCommerceElementsBaseConfig {
     debugMode?: DebugMode;
     checkout?: ILiquidCommerceElementsCheckoutConfig;
     proxy?: IElementsProxyConfig;
+    gtm?: IElementsGTMConfig;
     development?: ILiquidCommerceElementsDevelopmentConfig;
 }
 export interface ILiquidCommerceElementsBuilderConfig extends ILiquidCommerceElementsBaseConfig {

package/dist/types/modules/checkout/components/checkout-prop65-warning.component.d.ts

@@ -4,5 +4,5 @@ export declare class CheckoutProp65WarningComponent extends BaseComponent<null,
     constructor();
     get hostClasses(): string[];
     private colorMode;
-    protected template(): HTMLElement;
+    protected template(): HTMLElement | HTMLElement[];
 }

package/dist/types/ssr/stub.d.ts

@@ -3,7 +3,7 @@ export type { CartEventLevel, CartEventType, CheckoutEventLevel, CheckoutEventTy
 export { CART_EVENT_LEVEL, CART_EVENT_TYPE, CHECKOUT_EVENT_LEVEL, CHECKOUT_EVENT_TYPE, COMPONENT_TYPE, DEBUG_MODE, DISPLAY_MODE, ELEMENTS_ACTIONS_EVENT, ELEMENTS_ENV, ELEMENTS_FORM, FULFILLMENT_TYPE, NAVIGATION_SOURCE, } from '../enums/core.enum';
 export type { ILiquidCommerceElementsActions, ILiquidCommerceElementsBuilderClient, ILiquidCommerceElementsClient, } from '../interfaces/client.interface';
 export type { IInjectedComponent } from '../interfaces/component.interface';
-export type { IElementsProxyConfig, ILiquidCommerceElementsBuilderConfig, ILiquidCommerceElementsCheckoutConfig, ILiquidCommerceElementsConfig, ILiquidCommerceElementsDevelopmentConfig, } from '../interfaces/config.interface';
+export type { IElementsGTMConfig, IElementsProxyConfig, ILiquidCommerceElementsBuilderConfig, ILiquidCommerceElementsCheckoutConfig, ILiquidCommerceElementsConfig, ILiquidCommerceElementsDevelopmentConfig, } from '../interfaces/config.interface';
 export type * from '../interfaces/configs';
 export type { IBuilderInjectElementParams, IInjectCheckoutBuilderParams, IInjectCheckoutParams, IInjectProductElement, IInjectProductListFiltersParams, IInjectProductListParams, IInjectProductListSearchParams, ProductListFilterType, } from '../interfaces/injection.interface';
 export declare function Elements(..._args: any[]): Promise<null>;

package/docs/v1/api/client.md

@@ -108,6 +108,7 @@ interface ILiquidCommerceElementsConfig {
   customTheme?: IClientCustomThemeConfig;
   promoTicker?: IPromoTicker[];
   proxy?: IElementsProxyConfig;
+  gtm?: IElementsGTMConfig;
   checkout?: ILiquidCommerceElementsCheckoutConfig;
   development?: ILiquidCommerceElementsDevelopmentConfig;
 }
@@ -192,6 +193,24 @@ proxy: {
 
 See [Proxy Setup Guide](../integration/proxy-setup.md) for implementation.
 
+#### GTM Configuration
+
+```typescript
+interface IElementsGTMConfig {
+  gatewayUrl?: string;
+}
+```
+
+**Example:**
+
+```javascript
+gtm: {
+  gatewayUrl: 'https://www.yoursite.com/metrics/'
+}
+```
+
+Set this when your site serves its own GTM container through Google tag gateway. See [Analytics → Google tag gateway](../reference/analytics.md#google-tag-gateway).
+
 #### Checkout Configuration
 
 ```typescript

package/docs/v1/api/configuration.md

@@ -16,6 +16,7 @@ interface ILiquidCommerceElementsConfig {
   debugMode?: DebugMode;
   checkout?: ILiquidCommerceElementsCheckoutConfig;
   proxy?: IElementsProxyConfig;
+  gtm?: IElementsGTMConfig;
   development?: ILiquidCommerceElementsDevelopmentConfig;
 }
 ```
@@ -28,6 +29,7 @@ interface ILiquidCommerceElementsConfig {
 | `debugMode` | `'none' \| 'console' \| 'panel'` | No | Debug output mode |
 | `checkout` | `ILiquidCommerceElementsCheckoutConfig` | No | Checkout behavior settings |
 | `proxy` | `IElementsProxyConfig` | No | Proxy configuration for API requests |
+| `gtm` | `IElementsGTMConfig` | No | Google tag gateway URL of your own GTM container |
 | `development` | `ILiquidCommerceElementsDevelopmentConfig` | No | Development/testing options |
 
 > **Note:** `debugMode` (`'console'` or `'panel'`) is **ignored in production** -- it is forced off when `env` is `'production'`. It only takes effect outside production (`'staging'`).
@@ -530,6 +532,22 @@ See [Proxy Setup Guide](../integration/proxy-setup.md) for implementation detail
 
 ---
 
+## GTM Configuration
+
+### IElementsGTMConfig
+
+```typescript
+interface IElementsGTMConfig {
+  gatewayUrl?: string;
+}
+```
+
+If your site loads its own GTM container through Google tag gateway for advertisers, set `gatewayUrl` to that first-party path (e.g. `'https://www.yoursite.com/metrics/'` or `'/metrics/'`) so the SDK recognizes the container instead of treating the page as having none. Declarative equivalent: `data-gtm-gateway-url`. An empty or non-string value drops the whole `gtm` config with a console warning.
+
+See [Analytics → Google tag gateway](../reference/analytics.md#google-tag-gateway).
+
+---
+
 ## Development Configuration
 
 ### ILiquidCommerceElementsDevelopmentConfig

package/docs/v1/api/typescript-types.md

@@ -99,6 +99,7 @@ interface ILiquidCommerceElementsConfig {
   debugMode?: DebugMode;
   checkout?: ILiquidCommerceElementsCheckoutConfig;
   proxy?: IElementsProxyConfig;
+  gtm?: IElementsGTMConfig;
   development?: ILiquidCommerceElementsDevelopmentConfig;
 }
 ```
@@ -133,6 +134,16 @@ interface IElementsProxyConfig {
 }
 ```
 
+### IElementsGTMConfig
+
+```typescript
+interface IElementsGTMConfig {
+  gatewayUrl?: string;
+}
+```
+
+`gatewayUrl` is the Google tag gateway path your own GTM container is served from (see [Analytics → Google tag gateway](../reference/analytics.md#google-tag-gateway)).
+
 ### ILiquidCommerceElementsDevelopmentConfig
 
 ```typescript

package/docs/v1/getting-started/installation.md

@@ -47,6 +47,7 @@ The path segment selects which bundle is served:
 | `data-liquid-commerce-elements` | Yes | Identifies this as the Elements SDK script |
 | `data-token` | Yes | Your LiquidCommerce API key |
 | `data-env` | No | Environment: `staging` or `production`. Defaults to `production` if omitted. |
+| `data-gtm-gateway-url` | No | Google tag gateway path your own GTM container is served from (e.g. `/metrics/`). See [Analytics → Google tag gateway](../reference/analytics.md#google-tag-gateway). |
 | `defer` | Recommended | Allows non-blocking script loading |
 
 ### Where to Place the Script
@@ -269,6 +270,7 @@ const client = await Elements('YOUR_API_KEY', {
   customTheme: { /* ... */ },   // Optional: Theme customization
   promoTicker: [ /* ... */ ],   // Optional: Promo ticker configuration
   proxy: { /* ... */ },         // Optional: Proxy configuration
+  gtm: { /* ... */ },           // Optional: Google tag gateway URL of your own GTM container
   checkout: { /* ... */ },      // Optional: Checkout configuration
   development: { /* ... */ }    // Optional: Development/testing options
 });

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

@@ -454,16 +454,16 @@ window.addEventListener('lce:actions.checkout_product_add_failed', (event) => {
 
 ## California Proposition 65 Warning
 
-The order summary shows a panel directly above the place-order button reading **Adult signature
-(21+) required at delivery.** When the shipping address is in California, the panel adds
+When the shipping address is in California, the order summary shows a panel directly above the
+place-order button reading **Adult signature (21+) required at delivery.** followed by
 **CA WARNING · California Proposition 65 information for these products**, so the warning is
 presented before the purchase completes. The text links to the OEHHA alcohol page,
 [www.P65Warnings.ca.gov/alcohol](https://www.p65warnings.ca.gov/alcohol), in a new tab. The full
 27 CCR § 25607.4 text is on the product element.
 
 The panel appears in the drawer checkout, the hosted checkout and the checkout-only build. The
-adult-signature notice is always shown; the Prop 65 line follows the shipping address's state and
-updates when the address changes. Neither can be turned off or reworded by configuration. Its colours follow `global.layout.poweredByMode` — the same
+whole panel, adult-signature notice included, is shown only for a California shipping address; it
+appears or disappears when the address changes, and nothing renders in its place otherwise. Neither can be turned off or reworded by configuration. Its colours follow `global.layout.poweredByMode` — the same
 light/dark switch the Stripe payment form uses — as a fixed pair so the copy is always legible:
 `light` is `#18181B` on `#F5F3EE`, `dark` is `#F5F3EE` on `#2A2824`. The font and corner radius come
 from your theme. If your checkout is dark, set `poweredByMode: 'dark'`.

package/docs/v1/reference/analytics.md

@@ -48,7 +48,21 @@ Events fired before GTM finishes initializing are queued (up to 100, oldest drop
 
 ## Coexisting With Your Own GTM
 
-The SDK detects an already-present partner/host GTM container rather than replacing it. When a host GTM install (an existing `gtag` function or an existing `googletagmanager.com/gtm.js` script tag) is detected, the SDK integrates with it.
+The SDK detects an already-present partner/host GTM container rather than replacing it. When a host GTM install (an existing `gtag` function, an existing `googletagmanager.com/gtm.js` script tag, or a script served from your configured Google tag gateway) is detected, the SDK integrates with it. A container that has booted is also recognized through GTM's own `window.google_tag_manager[containerId]` registry, whichever host served it.
+
+### Google tag gateway
+
+If your site loads its own GTM container first-party through [Google tag gateway for advertisers](https://developers.google.com/tag-platform/tag-manager/gateway/get-started) (e.g. `https://www.yoursite.com/metrics/` instead of `https://www.googletagmanager.com/gtm.js?id=GTM-XXXX`), tell the SDK where that path is so it recognizes your container:
+
+```javascript
+const client = await Elements('YOUR_API_KEY', {
+  gtm: { gatewayUrl: 'https://www.yoursite.com/metrics/' }, // or '/metrics/'
+});
+```
+
+Or declaratively, on the script tag: `data-gtm-gateway-url="/metrics/"`.
+
+A gateway script URL usually carries no container ID, so without this setting the SDK cannot match the script tag to your partner container. A script with the same origin whose path starts with that value is matched to your partner container by container ID: an `id=` query parameter must equal your partner container ID, and a script without one counts only once GTM's `window.google_tag_manager` registry lists your container ID (or while no container has booted yet). A gateway serving a different container or a GA4/Ads tag is therefore never taken for yours. Relative values resolve against the current page. The setting affects detection only — the SDK never loads your container, and the LiquidCommerce container still loads from `googletagmanager.com`.
 
 When both the LiquidCommerce container and a partner container are initialized, events are sent to both using GA4's `send_to` targeting (a dual-container send). Only containers that are actually initialized are added to `send_to`, so events are never routed to a container that failed to load.
 

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.7.39",
+  "version": "2.7.40",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -122,22 +122,22 @@
     "@semantic-release/changelog": "^7.0.0",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^11.0.1",
-    "@semantic-release/github": "^12.0.9",
-    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/github": "^12.0.10",
+    "@semantic-release/npm": "^13.2.0",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.3",
     "conventional-changelog": "8.1.3",
     "husky": "^9.1.7",
-    "jsdom": "30.1.0",
+    "jsdom": "30.1.1",
     "process": "^0.11.10",
-    "rollup": "^4.63.4",
+    "rollup": "^4.63.5",
     "rollup-obfuscator": "^4.1.1",
     "rollup-plugin-typescript2": "^0.37.0",
     "semantic-release": "^25.0.9",
     "ts-node": "^10.9.2",
     "typescript": "6.0.3",
-    "vitest": "5.0.1"
+    "vitest": "5.0.2"
   },
   "engines": {
     "node": ">=22"