@abconvert/headless 0.0.0-stage → 0.1.1

package/dist/types.d.cts

@@ -0,0 +1,302 @@
+export type AssignmentType = 'price' | 'shipping' | 'theme' | 'template' | 'url_redirect' | 'checkout' | 'offer' | 'visual_editor' | 'combined' | 'personalization';
+export type AssignmentReason = 'random_split' | 'force_assign_group' | 'preview_override' | 'url_force_assign';
+/** Why a visitor was left out of a test, for the exclusions reported as test group -1. */
+export type ReportedExclusion = 'audience_targeting_excluded' | 'force_assign_excluded';
+/** What an assignment row names as its reason: a test group the visitor counts in, or an exclusion. */
+export type ReportedReason = 'random_split' | 'force_assign_group' | ReportedExclusion;
+export interface TestGroup {
+    index: number;
+    name: string;
+    control: boolean;
+    split: number;
+    /** A feature test's values for this test group; `{}` for every other test type. */
+    variables: Record<string, string | number | boolean>;
+}
+export interface Assignment {
+    experimentId: string;
+    experimentName: string;
+    type: AssignmentType;
+    status: 'active' | 'preview';
+    testGroup: TestGroup;
+    reason: AssignmentReason;
+    /** Feature tests only. */
+    featureKey?: string;
+}
+export interface Price {
+    experimentId: string;
+    testGroup: TestGroup;
+    amount: number;
+    compareAtAmount: number | null;
+    currency: string;
+    country: string;
+    productId: string;
+    variantId: string;
+}
+export interface PriceOptions {
+    country?: string;
+    aggregate?: 'min' | 'max' | 'first';
+}
+export interface ShippingRate {
+    experimentId: string;
+    testGroup: TestGroup;
+    zone: string;
+    name: string;
+    amount: number;
+    currency: string;
+    condition: {
+        type: 'price' | 'weight';
+        minimum: number | null;
+        maximum: number | null;
+        unit: string | null;
+    } | null;
+}
+export interface FreeShippingThreshold {
+    experimentId: string;
+    testGroup: TestGroup;
+    zone: string;
+    amount: number;
+    currency: string;
+}
+export interface ShippingOptions {
+    zone?: string;
+}
+export interface Offer {
+    experimentId: string;
+    testGroup: TestGroup;
+    title: string;
+    discounts: unknown[];
+}
+export interface CartAttribute {
+    key: string;
+    value: string;
+}
+export interface CheckoutLine {
+    /** A numeric product variant ID, or a Storefront API `gid://shopify/ProductVariant/<id>`. */
+    variantId: string | number;
+    quantity: number;
+}
+export interface CheckoutUrlOptions {
+    lines: CheckoutLine[];
+    /** Opens Shop Pay checkout. */
+    payment?: 'shop_pay';
+}
+export interface Customer {
+    loggedIn?: boolean;
+    tags?: string[];
+    ordersCount?: number;
+    /** In your store currency. */
+    totalSpent?: number;
+}
+/** Anything with headers and a URL: a Fetch `Request`, or `{ headers, url }`. */
+export interface RequestLike {
+    url: string;
+    headers: {
+        get(name: string): string | null;
+    } | Record<string, string | string[] | undefined>;
+}
+export interface ABConvertOptions {
+    /** Your `myshopify.com` domain. */
+    shop: string;
+    /** A storefront key from Settings, Headless. Safe to ship in storefront code. */
+    storefrontKey: string;
+    /** The incoming request. Required on the server. */
+    request?: RequestLike;
+    /** The country your storefront shows prices for. Defaults to the store's default country. */
+    country?: string;
+    customer?: Customer;
+    /** Milliseconds to wait for your tests on a cold start. Defaults to 1000. */
+    timeout?: number;
+    /** Seconds a loaded copy of your tests stays fresh. Defaults to 60. */
+    cacheTtl?: number;
+    onError?: (error: Error) => void;
+    consent?: {
+        analytics: boolean;
+    };
+    /**
+     * Your storefront loads Shopify's Customer Privacy API, which writes the
+     * `_tracking_consent` cookie once the visitor answers: until then, track
+     * nothing. The Hydrogen entries' `createABConvert` sets it for you.
+     */
+    expectCustomerPrivacy?: boolean;
+    /** Where ABConvert runs. For ABConvert's own testing; leave unset. */
+    baseUrl?: string;
+    /**
+     * Build the client from a page key (`getPageKey()`, or the segment the
+     * `/next` middleware rewrites to) instead of a request: what a cached page
+     * renders with. It reads prices and assignments for the key's test groups
+     * and nothing about the visitor. `''` or `-` is a page no test changes.
+     * Rejects when the tests the key names cannot be loaded, so a cache never
+     * keeps your original store under a test group's key.
+     */
+    pageKey?: string;
+    /**
+     * Your product pages show no price but their own product's (no related or
+     * recently viewed products with prices): a product page's key then carries
+     * only the price tests that list it, so untested product pages stay
+     * cacheable. Leave unset otherwise, or another product's price shows
+     * without its test.
+     */
+    onlyOwnProductPrices?: boolean;
+}
+/** What `getClientState()` hands the browser so it rebuilds the same client without a fetch. */
+export interface ClientState {
+    version: 1;
+    shop: string;
+    visitorId: string;
+    sessionId: string;
+    country: string;
+    consent: {
+        analytics: boolean;
+    };
+    preview: boolean;
+    assignments: Assignment[];
+    /** The document, cut to each assigned test and its assigned test group's changes. */
+    doc: unknown;
+    pending: {
+        assignments: PendingAssignment[];
+        exposures: string[];
+    };
+    /** The locale the server formatted prices in. The browser formats in it too, so hydration matches. */
+    locale: string;
+    /** The `abconvert-state` cookie value, which the browser writes when tracking starts. */
+    stateCookie: string;
+    /** Where the server loaded the tests from, when not ABConvert's default. The browser tracks to the same place. */
+    baseUrl?: string;
+}
+/**
+ * What a page rendered from a page key hands the browser (`getPageState()`).
+ * The same for everyone in the same test groups, so it may be cached: no
+ * visitor, session, consent or pending work. The browser reads those from its
+ * cookies.
+ */
+export interface PageState {
+    version: 2;
+    shop: string;
+    pageKey: string;
+    country: string;
+    /** The key's assignments: what the page renders for. */
+    assignments: Assignment[];
+    /** The keyed tests cut to their test group's changes, and every other test without prices or audience rules. */
+    doc: unknown;
+    locale: string;
+    baseUrl?: string;
+    /**
+     * For the browser to fetch the current tests when its visitor is in one this
+     * copy predates. Safe in storefront code. Absent on a page cached
+     * before it was added.
+     */
+    storefrontKey?: string;
+}
+export interface PendingAssignment {
+    experimentId: string;
+    objectId: string;
+    /** -1 for an excluded visitor. */
+    groupIndex: number;
+    reason: ReportedReason;
+    /** The test's assignment version the decision was made under, when it has one. */
+    assignmentVersion?: number;
+    assignedAt: string;
+    snapshot: {
+        country?: string;
+        device?: string;
+        visitorType?: string;
+        trafficPlatform?: string;
+        trafficChannel?: string;
+        referralDomain?: string;
+        landingPage?: string;
+        browser?: {
+            name: string;
+            version: string;
+        };
+        os?: {
+            name: string;
+            version: string;
+        };
+        locale?: string;
+    };
+}
+export interface ABConvert {
+    getAssignment(experimentId: string | number): Assignment | null;
+    getAssignments(): Assignment[];
+    getFeature(key: string): Assignment | null;
+    getPriceByVariantId(variantId: string | number, options?: PriceOptions): Price | null;
+    getPriceByProductId(productId: string | number, options?: PriceOptions): Price | null;
+    formatPrice(amount: number, currency?: string): string;
+    getShippingRates(options?: ShippingOptions): ShippingRate[] | null;
+    getFreeShippingThreshold(options?: ShippingOptions): FreeShippingThreshold | null;
+    getOffers(): Offer[];
+    getVisitorId(): string;
+    getCountry(): string;
+    forceTestGroup(experimentId: string | number, index: number): void;
+    clearForcedTestGroup(experimentId: string | number): void;
+    getCartAttributes(): CartAttribute[];
+    getCartLineAttributes(): CartAttribute[];
+    /** A cart permalink that lands in checkout with the visitor's test groups. Build it per render; never share or cache it. */
+    getCheckoutUrl(options: CheckoutUrlOptions): string;
+    /** Server: the visitor's URL redirect destination for `url`, as a same-origin path, or null to stay. Null in the browser. */
+    getRedirectUrl(url: string): string | null;
+    getClientState(): ClientState;
+    /** The page key: the test groups this page renders for, the same for everyone in them. `''` when no test changes the page. */
+    getPageKey(): string;
+    getSetCookieHeaders(): string[];
+    refreshTests(): Promise<void>;
+    /** Browser: records `page_viewed`, `product_viewed`, `product_added_to_cart`, or a custom event by its name in ABConvert. Does nothing on the server. */
+    track(name: string, payload?: Record<string, unknown>): void;
+    /** Browser: records that the visitor saw the test, once per test per session. Does nothing on the server. */
+    trackExposure(experimentId: string | number): void;
+    /** Browser: the visitor's answer to your cookie banner. Does nothing on the server. */
+    setConsent(consent: {
+        analytics: boolean;
+    }): void;
+}
+/** A client made from a page key: `createABConvert({ pageKey })`. */
+export interface PageABConvert extends ABConvert {
+    /** What the browser rebuilds the same reads from. Cacheable: nothing about the visitor. */
+    getPageState(): PageState;
+}
+/** A client made from a request on the server: `createABConvert({ request })`. */
+export interface ServerABConvert extends ABConvert {
+    /**
+     * Whether a test can change this page for some visitor, whatever this
+     * visitor's groups: then no shared cache may keep one copy of it for everyone.
+     * True when a price test prices a product this URL shows or a URL redirect
+     * test covers it, when a read on this client returned a test's data (a
+     * tested product's price, offers or shipping rates while such a test runs,
+     * an assignment), when `getClientState()` was read, and in a preview session.
+     */
+    isPageTested(): boolean;
+    /**
+     * What the browser needs from this request, with nothing about the visitor,
+     * so a cached page can carry it: the tests this client's reads touched, as
+     * the visitor saw them, and every other test light. On Hydrogen, return it
+     * from the route loader that read the prices the route renders, and hand it
+     * to the provider; the browser reads the visitor from the cookies.
+     */
+    getPageState(): PageState;
+    /**
+     * Whether any test runs for your store: an active test, or a preview test in
+     * a preview session. On a framework that caches whole responses, any page
+     * could then show one visitor's offer, shipping bar or price.
+     */
+    isTesting(): boolean;
+}
+/** The client in the browser, from `hydrateABConvert` or a browser-only `createABConvert`: the same methods, plus what a binding needs to run it. */
+export interface BrowserABConvert extends ABConvert {
+    /** Begin tracking: report what is pending once consent allows. Idempotent. */
+    start(): void;
+    /** Stop listening for the visitor's consent. What is held stays held. */
+    stop(): void;
+    /** Called after a force changes what the reads answer. Returns the undo. */
+    subscribe(listener: () => void): () => void;
+}
+export interface HydrateOptions {
+    /** Runs once per assignment per page load, once the visitor allows analytics. Not for forced or preview assignments. */
+    onAssignment?: (assignment: Assignment) => void;
+    /**
+     * Hold all tracking, cookies included, until Shopify's Customer Privacy API
+     * loads and allows analytics, as Hydrogen does. Set it when your storefront
+     * loads that API; the Hydrogen entries set it for you. Without it, a page
+     * where the API is absent follows `setConsent` or the server's view.
+     */
+    expectCustomerPrivacy?: boolean;
+}

package/dist/types.d.ts

@@ -0,0 +1,302 @@
+export type AssignmentType = 'price' | 'shipping' | 'theme' | 'template' | 'url_redirect' | 'checkout' | 'offer' | 'visual_editor' | 'combined' | 'personalization';
+export type AssignmentReason = 'random_split' | 'force_assign_group' | 'preview_override' | 'url_force_assign';
+/** Why a visitor was left out of a test, for the exclusions reported as test group -1. */
+export type ReportedExclusion = 'audience_targeting_excluded' | 'force_assign_excluded';
+/** What an assignment row names as its reason: a test group the visitor counts in, or an exclusion. */
+export type ReportedReason = 'random_split' | 'force_assign_group' | ReportedExclusion;
+export interface TestGroup {
+    index: number;
+    name: string;
+    control: boolean;
+    split: number;
+    /** A feature test's values for this test group; `{}` for every other test type. */
+    variables: Record<string, string | number | boolean>;
+}
+export interface Assignment {
+    experimentId: string;
+    experimentName: string;
+    type: AssignmentType;
+    status: 'active' | 'preview';
+    testGroup: TestGroup;
+    reason: AssignmentReason;
+    /** Feature tests only. */
+    featureKey?: string;
+}
+export interface Price {
+    experimentId: string;
+    testGroup: TestGroup;
+    amount: number;
+    compareAtAmount: number | null;
+    currency: string;
+    country: string;
+    productId: string;
+    variantId: string;
+}
+export interface PriceOptions {
+    country?: string;
+    aggregate?: 'min' | 'max' | 'first';
+}
+export interface ShippingRate {
+    experimentId: string;
+    testGroup: TestGroup;
+    zone: string;
+    name: string;
+    amount: number;
+    currency: string;
+    condition: {
+        type: 'price' | 'weight';
+        minimum: number | null;
+        maximum: number | null;
+        unit: string | null;
+    } | null;
+}
+export interface FreeShippingThreshold {
+    experimentId: string;
+    testGroup: TestGroup;
+    zone: string;
+    amount: number;
+    currency: string;
+}
+export interface ShippingOptions {
+    zone?: string;
+}
+export interface Offer {
+    experimentId: string;
+    testGroup: TestGroup;
+    title: string;
+    discounts: unknown[];
+}
+export interface CartAttribute {
+    key: string;
+    value: string;
+}
+export interface CheckoutLine {
+    /** A numeric product variant ID, or a Storefront API `gid://shopify/ProductVariant/<id>`. */
+    variantId: string | number;
+    quantity: number;
+}
+export interface CheckoutUrlOptions {
+    lines: CheckoutLine[];
+    /** Opens Shop Pay checkout. */
+    payment?: 'shop_pay';
+}
+export interface Customer {
+    loggedIn?: boolean;
+    tags?: string[];
+    ordersCount?: number;
+    /** In your store currency. */
+    totalSpent?: number;
+}
+/** Anything with headers and a URL: a Fetch `Request`, or `{ headers, url }`. */
+export interface RequestLike {
+    url: string;
+    headers: {
+        get(name: string): string | null;
+    } | Record<string, string | string[] | undefined>;
+}
+export interface ABConvertOptions {
+    /** Your `myshopify.com` domain. */
+    shop: string;
+    /** A storefront key from Settings, Headless. Safe to ship in storefront code. */
+    storefrontKey: string;
+    /** The incoming request. Required on the server. */
+    request?: RequestLike;
+    /** The country your storefront shows prices for. Defaults to the store's default country. */
+    country?: string;
+    customer?: Customer;
+    /** Milliseconds to wait for your tests on a cold start. Defaults to 1000. */
+    timeout?: number;
+    /** Seconds a loaded copy of your tests stays fresh. Defaults to 60. */
+    cacheTtl?: number;
+    onError?: (error: Error) => void;
+    consent?: {
+        analytics: boolean;
+    };
+    /**
+     * Your storefront loads Shopify's Customer Privacy API, which writes the
+     * `_tracking_consent` cookie once the visitor answers: until then, track
+     * nothing. The Hydrogen entries' `createABConvert` sets it for you.
+     */
+    expectCustomerPrivacy?: boolean;
+    /** Where ABConvert runs. For ABConvert's own testing; leave unset. */
+    baseUrl?: string;
+    /**
+     * Build the client from a page key (`getPageKey()`, or the segment the
+     * `/next` middleware rewrites to) instead of a request: what a cached page
+     * renders with. It reads prices and assignments for the key's test groups
+     * and nothing about the visitor. `''` or `-` is a page no test changes.
+     * Rejects when the tests the key names cannot be loaded, so a cache never
+     * keeps your original store under a test group's key.
+     */
+    pageKey?: string;
+    /**
+     * Your product pages show no price but their own product's (no related or
+     * recently viewed products with prices): a product page's key then carries
+     * only the price tests that list it, so untested product pages stay
+     * cacheable. Leave unset otherwise, or another product's price shows
+     * without its test.
+     */
+    onlyOwnProductPrices?: boolean;
+}
+/** What `getClientState()` hands the browser so it rebuilds the same client without a fetch. */
+export interface ClientState {
+    version: 1;
+    shop: string;
+    visitorId: string;
+    sessionId: string;
+    country: string;
+    consent: {
+        analytics: boolean;
+    };
+    preview: boolean;
+    assignments: Assignment[];
+    /** The document, cut to each assigned test and its assigned test group's changes. */
+    doc: unknown;
+    pending: {
+        assignments: PendingAssignment[];
+        exposures: string[];
+    };
+    /** The locale the server formatted prices in. The browser formats in it too, so hydration matches. */
+    locale: string;
+    /** The `abconvert-state` cookie value, which the browser writes when tracking starts. */
+    stateCookie: string;
+    /** Where the server loaded the tests from, when not ABConvert's default. The browser tracks to the same place. */
+    baseUrl?: string;
+}
+/**
+ * What a page rendered from a page key hands the browser (`getPageState()`).
+ * The same for everyone in the same test groups, so it may be cached: no
+ * visitor, session, consent or pending work. The browser reads those from its
+ * cookies.
+ */
+export interface PageState {
+    version: 2;
+    shop: string;
+    pageKey: string;
+    country: string;
+    /** The key's assignments: what the page renders for. */
+    assignments: Assignment[];
+    /** The keyed tests cut to their test group's changes, and every other test without prices or audience rules. */
+    doc: unknown;
+    locale: string;
+    baseUrl?: string;
+    /**
+     * For the browser to fetch the current tests when its visitor is in one this
+     * copy predates. Safe in storefront code. Absent on a page cached
+     * before it was added.
+     */
+    storefrontKey?: string;
+}
+export interface PendingAssignment {
+    experimentId: string;
+    objectId: string;
+    /** -1 for an excluded visitor. */
+    groupIndex: number;
+    reason: ReportedReason;
+    /** The test's assignment version the decision was made under, when it has one. */
+    assignmentVersion?: number;
+    assignedAt: string;
+    snapshot: {
+        country?: string;
+        device?: string;
+        visitorType?: string;
+        trafficPlatform?: string;
+        trafficChannel?: string;
+        referralDomain?: string;
+        landingPage?: string;
+        browser?: {
+            name: string;
+            version: string;
+        };
+        os?: {
+            name: string;
+            version: string;
+        };
+        locale?: string;
+    };
+}
+export interface ABConvert {
+    getAssignment(experimentId: string | number): Assignment | null;
+    getAssignments(): Assignment[];
+    getFeature(key: string): Assignment | null;
+    getPriceByVariantId(variantId: string | number, options?: PriceOptions): Price | null;
+    getPriceByProductId(productId: string | number, options?: PriceOptions): Price | null;
+    formatPrice(amount: number, currency?: string): string;
+    getShippingRates(options?: ShippingOptions): ShippingRate[] | null;
+    getFreeShippingThreshold(options?: ShippingOptions): FreeShippingThreshold | null;
+    getOffers(): Offer[];
+    getVisitorId(): string;
+    getCountry(): string;
+    forceTestGroup(experimentId: string | number, index: number): void;
+    clearForcedTestGroup(experimentId: string | number): void;
+    getCartAttributes(): CartAttribute[];
+    getCartLineAttributes(): CartAttribute[];
+    /** A cart permalink that lands in checkout with the visitor's test groups. Build it per render; never share or cache it. */
+    getCheckoutUrl(options: CheckoutUrlOptions): string;
+    /** Server: the visitor's URL redirect destination for `url`, as a same-origin path, or null to stay. Null in the browser. */
+    getRedirectUrl(url: string): string | null;
+    getClientState(): ClientState;
+    /** The page key: the test groups this page renders for, the same for everyone in them. `''` when no test changes the page. */
+    getPageKey(): string;
+    getSetCookieHeaders(): string[];
+    refreshTests(): Promise<void>;
+    /** Browser: records `page_viewed`, `product_viewed`, `product_added_to_cart`, or a custom event by its name in ABConvert. Does nothing on the server. */
+    track(name: string, payload?: Record<string, unknown>): void;
+    /** Browser: records that the visitor saw the test, once per test per session. Does nothing on the server. */
+    trackExposure(experimentId: string | number): void;
+    /** Browser: the visitor's answer to your cookie banner. Does nothing on the server. */
+    setConsent(consent: {
+        analytics: boolean;
+    }): void;
+}
+/** A client made from a page key: `createABConvert({ pageKey })`. */
+export interface PageABConvert extends ABConvert {
+    /** What the browser rebuilds the same reads from. Cacheable: nothing about the visitor. */
+    getPageState(): PageState;
+}
+/** A client made from a request on the server: `createABConvert({ request })`. */
+export interface ServerABConvert extends ABConvert {
+    /**
+     * Whether a test can change this page for some visitor, whatever this
+     * visitor's groups: then no shared cache may keep one copy of it for everyone.
+     * True when a price test prices a product this URL shows or a URL redirect
+     * test covers it, when a read on this client returned a test's data (a
+     * tested product's price, offers or shipping rates while such a test runs,
+     * an assignment), when `getClientState()` was read, and in a preview session.
+     */
+    isPageTested(): boolean;
+    /**
+     * What the browser needs from this request, with nothing about the visitor,
+     * so a cached page can carry it: the tests this client's reads touched, as
+     * the visitor saw them, and every other test light. On Hydrogen, return it
+     * from the route loader that read the prices the route renders, and hand it
+     * to the provider; the browser reads the visitor from the cookies.
+     */
+    getPageState(): PageState;
+    /**
+     * Whether any test runs for your store: an active test, or a preview test in
+     * a preview session. On a framework that caches whole responses, any page
+     * could then show one visitor's offer, shipping bar or price.
+     */
+    isTesting(): boolean;
+}
+/** The client in the browser, from `hydrateABConvert` or a browser-only `createABConvert`: the same methods, plus what a binding needs to run it. */
+export interface BrowserABConvert extends ABConvert {
+    /** Begin tracking: report what is pending once consent allows. Idempotent. */
+    start(): void;
+    /** Stop listening for the visitor's consent. What is held stays held. */
+    stop(): void;
+    /** Called after a force changes what the reads answer. Returns the undo. */
+    subscribe(listener: () => void): () => void;
+}
+export interface HydrateOptions {
+    /** Runs once per assignment per page load, once the visitor allows analytics. Not for forced or preview assignments. */
+    onAssignment?: (assignment: Assignment) => void;
+    /**
+     * Hold all tracking, cookies included, until Shopify's Customer Privacy API
+     * loads and allows analytics, as Hydrogen does. Set it when your storefront
+     * loads that API; the Hydrogen entries set it for you. Without it, a page
+     * where the API is absent follows `setConsent` or the server's view.
+     */
+    expectCustomerPrivacy?: boolean;
+}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@abconvert/headless",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "ABConvert A/B tests on a custom Shopify storefront: assignment, test prices, and cart attributes on the server, edge, or browser.",
+  "keywords": ["abconvert", "shopify", "headless", "hydrogen", "nextjs", "ab-testing", "storefront-api"],
+  "homepage": "https://docs.abconvert.io/headless-sdk/overview",
+  "bugs": { "email": "support@abconvert.io" },
+  "repository": { "type": "git", "url": "git+https://github.com/ABConvert/ab-test-app.git", "directory": "packages/headless" },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    },
+    "./react": {
+      "import": { "types": "./dist/react.d.ts", "default": "./dist/react.js" },
+      "require": { "types": "./dist/react.d.cts", "default": "./dist/react.cjs" }
+    },
+    "./next": {
+      "import": { "types": "./dist/next.d.ts", "default": "./dist/next.js" },
+      "require": { "types": "./dist/next.d.cts", "default": "./dist/next.cjs" }
+    },
+    "./hydrogen": {
+      "import": { "types": "./dist/hydrogen.d.ts", "default": "./dist/hydrogen.js" },
+      "require": { "types": "./dist/hydrogen.d.cts", "default": "./dist/hydrogen.cjs" }
+    },
+    "./hydrogen/analytics-provider": {
+      "import": { "types": "./dist/hydrogen-analytics-provider.d.ts", "default": "./dist/hydrogen-analytics-provider.js" },
+      "require": { "types": "./dist/hydrogen-analytics-provider.d.cts", "default": "./dist/hydrogen-analytics-provider.cjs" }
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "react": ["./dist/react.d.ts"],
+      "next": ["./dist/next.d.ts"],
+      "hydrogen": ["./dist/hydrogen.d.ts"],
+      "hydrogen/analytics-provider": ["./dist/hydrogen-analytics-provider.d.ts"]
+    }
+  },
+  "files": ["dist", "!dist/*inputs.json", "NOTICE"],
+  "sideEffects": false,
+  "engines": { "node": ">=20" },
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "check:runtime": "node scripts/check-runtime.mjs",
+    "check": "npm run typecheck && npm test && npm run build && npm run check:runtime"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "next": ">=14",
+    "@shopify/hydrogen": ">=2024.4"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "next": { "optional": true },
+    "@shopify/hydrogen": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/react": "18.3.28",
+    "@types/react-dom": "18.3.7",
+    "esbuild": "0.27.4",
+    "jsdom": "25.0.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "4.9.5",
+    "vitest": "1.6.1"
+  }
+}