@elevateab/sdk 1.3.0 → 1.3.1

package/README.md

@@ -18,6 +18,22 @@ npm install @elevateab/sdk
 
 ## Hydrogen Setup
 
+### 1. Add the Vite Plugin
+
+```ts
+// vite.config.ts
+import {elevate} from '@elevateab/sdk/vite';
+
+export default defineConfig({
+  plugins: [hydrogen(), oxygen(), elevate(), reactRouter(), tsconfigPaths()],
+  // ...
+});
+```
+
+The `elevate()` plugin configures Vite's SSR bundling so the SDK works correctly with Hydrogen's analytics during development (HMR). **This is required for Hydrogen stores.**
+
+### 2. Add the Provider
+
 Hydrogen uses automatic analytics tracking via Shopify's `useAnalytics()` hook.
 
 ```tsx

package/dist/vite.cjs

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var s=(t,e)=>{for(var r in e)a(t,r,{get:e[r],enumerable:!0})},v=(t,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of o(e))!u.call(t,n)&&n!==r&&a(t,n,{get:()=>e[n],enumerable:!(i=l(e,n))||i.enumerable});return t};var f=t=>v(a({},"__esModule",{value:!0}),t);var m={};s(m,{elevate:()=>g});module.exports=f(m);function g(){return{name:"elevateab-sdk",config(){return{ssr:{noExternal:["@elevateab/sdk"]}}}}}0&&(module.exports={elevate});
+//# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["/**\n * Vite plugin for @elevateab/sdk\n *\n * Automatically configures Vite's SSR settings so the Elevate SDK\n * works correctly with Shopify Hydrogen (and other Vite-based SSR frameworks).\n *\n * Without this plugin, the SDK is externalized during SSR by default,\n * which causes \"Cannot redefine property: Shopify\" errors during HMR\n * in development. The plugin tells Vite to bundle the SDK into the\n * server build, giving Vite proper control over module evaluation\n * and hot-reload lifecycle.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { elevate } from '@elevateab/sdk/vite';\n *\n * export default defineConfig({\n *   plugins: [hydrogen(), oxygen(), elevate(), reactRouter(), tsconfigPaths()],\n * });\n * ```\n */\n\nimport type { Plugin } from 'vite';\n\nexport function elevate(): Plugin {\n  return {\n    name: 'elevateab-sdk',\n    config() {\n      return {\n        ssr: {\n          noExternal: ['@elevateab/sdk'],\n        },\n      };\n    },\n  };\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAyBO,SAASE,GAAkB,CAChC,MAAO,CACL,KAAM,gBACN,QAAS,CACP,MAAO,CACL,IAAK,CACH,WAAY,CAAC,gBAAgB,CAC/B,CACF,CACF,CACF,CACF","names":["vite_exports","__export","elevate","__toCommonJS"]}

package/dist/vite.d.cts

@@ -0,0 +1,28 @@
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin for @elevateab/sdk
+ *
+ * Automatically configures Vite's SSR settings so the Elevate SDK
+ * works correctly with Shopify Hydrogen (and other Vite-based SSR frameworks).
+ *
+ * Without this plugin, the SDK is externalized during SSR by default,
+ * which causes "Cannot redefine property: Shopify" errors during HMR
+ * in development. The plugin tells Vite to bundle the SDK into the
+ * server build, giving Vite proper control over module evaluation
+ * and hot-reload lifecycle.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { elevate } from '@elevateab/sdk/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [hydrogen(), oxygen(), elevate(), reactRouter(), tsconfigPaths()],
+ * });
+ * ```
+ */
+
+declare function elevate(): Plugin;
+
+export { elevate };

package/dist/vite.d.ts

@@ -0,0 +1,28 @@
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin for @elevateab/sdk
+ *
+ * Automatically configures Vite's SSR settings so the Elevate SDK
+ * works correctly with Shopify Hydrogen (and other Vite-based SSR frameworks).
+ *
+ * Without this plugin, the SDK is externalized during SSR by default,
+ * which causes "Cannot redefine property: Shopify" errors during HMR
+ * in development. The plugin tells Vite to bundle the SDK into the
+ * server build, giving Vite proper control over module evaluation
+ * and hot-reload lifecycle.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { elevate } from '@elevateab/sdk/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [hydrogen(), oxygen(), elevate(), reactRouter(), tsconfigPaths()],
+ * });
+ * ```
+ */
+
+declare function elevate(): Plugin;
+
+export { elevate };

package/dist/vite.js

@@ -0,0 +1,2 @@
+function e(){return{name:"elevateab-sdk",config(){return{ssr:{noExternal:["@elevateab/sdk"]}}}}}export{e as elevate};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["/**\n * Vite plugin for @elevateab/sdk\n *\n * Automatically configures Vite's SSR settings so the Elevate SDK\n * works correctly with Shopify Hydrogen (and other Vite-based SSR frameworks).\n *\n * Without this plugin, the SDK is externalized during SSR by default,\n * which causes \"Cannot redefine property: Shopify\" errors during HMR\n * in development. The plugin tells Vite to bundle the SDK into the\n * server build, giving Vite proper control over module evaluation\n * and hot-reload lifecycle.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import { elevate } from '@elevateab/sdk/vite';\n *\n * export default defineConfig({\n *   plugins: [hydrogen(), oxygen(), elevate(), reactRouter(), tsconfigPaths()],\n * });\n * ```\n */\n\nimport type { Plugin } from 'vite';\n\nexport function elevate(): Plugin {\n  return {\n    name: 'elevateab-sdk',\n    config() {\n      return {\n        ssr: {\n          noExternal: ['@elevateab/sdk'],\n        },\n      };\n    },\n  };\n}\n"],"mappings":"AAyBO,SAASA,GAAkB,CAChC,MAAO,CACL,KAAM,gBACN,QAAS,CACP,MAAO,CACL,IAAK,CACH,WAAY,CAAC,gBAAgB,CAC/B,CACF,CACF,CACF,CACF","names":["elevate"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevateab/sdk",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Elevate AB Testing SDK for Hydrogen and Remix frameworks",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -21,6 +21,11 @@
       "types": "./dist/next.d.ts",
       "import": "./dist/next.js",
       "require": "./dist/next.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js",
+      "require": "./dist/vite.cjs"
     }
   },
   "files": [
@@ -75,6 +80,7 @@
     "@types/ua-parser-js": "^0.7.39",
     "next": "^14.2.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1"
   }
 }