@storewatch/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edin Skeja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# @storewatch/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React bindings for the Storewatch browser SDK.
+
+```tsx
+import { StorewatchProvider, useStorewatch, money } from "@storewatch/react";
+
+<StorewatchProvider publicKey="sw_pk_…" endpoint="https://ingest.example.com/v1/batch">
+  <App />
+</StorewatchProvider>;
+
+const sw = useStorewatch();
+sw.track("add_to_cart", { productId, quantity: 1, cartValue: money(1249, "SEK") });
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { StorewatchProvider, useStorewatch, type StorewatchProviderProps } from "./provider.js";
+export { getStorewatch, init, money, type Consent, type Storewatch, type StorewatchOptions } from "@storewatch/browser";

package/dist/index.js

@@ -0,0 +1,30 @@
+"use client";
+
+// src/provider.tsx
+import { createContext, useContext, useEffect, useState } from "react";
+import { getStorewatch, init } from "@storewatch/browser";
+import { jsx } from "react/jsx-runtime";
+var StorewatchContext = createContext(null);
+function StorewatchProvider({ children, ...options }) {
+  const [client, setClient] = useState(null);
+  useEffect(() => {
+    setClient(init(options));
+  }, [options.publicKey]);
+  useEffect(() => {
+    client?.setConsent(options.consent ?? "pending");
+  }, [client, options.consent]);
+  return /* @__PURE__ */ jsx(StorewatchContext.Provider, { value: client, children });
+}
+function useStorewatch() {
+  return useContext(StorewatchContext) ?? getStorewatch();
+}
+
+// src/index.ts
+import { getStorewatch as getStorewatch2, init as init2, money } from "@storewatch/browser";
+export {
+  StorewatchProvider,
+  getStorewatch2 as getStorewatch,
+  init2 as init,
+  money,
+  useStorewatch
+};

package/dist/provider.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+import { type Storewatch, type StorewatchOptions } from "@storewatch/browser";
+export type StorewatchProviderProps = StorewatchOptions & {
+    children?: ReactNode;
+};
+/**
+ * Initialises Storewatch once per page. `consent` is reactive: pass your
+ * consent banner's state and changes are applied immediately.
+ */
+export declare function StorewatchProvider({ children, ...options }: StorewatchProviderProps): import("react").JSX.Element;
+/**
+ * The Storewatch client. Works with or without a provider (e.g. when init
+ * happened in Next's instrumentation-client.ts). Safe to call before init
+ * (including from child effects, which React runs first): early calls are
+ * queued and replayed.
+ */
+export declare function useStorewatch(): Storewatch;

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@storewatch/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "React bindings for the Storewatch browser SDK.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@storewatch/browser": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "happy-dom": "^21.0.1",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "tsup": "^9.0.0",
+    "@storewatch/config": "0.0.0"
+  },
+  "keywords": [
+    "storewatch",
+    "analytics",
+    "ecommerce"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p .",
+    "test": "vitest run"
+  }
 }