@storewatch/nextjs 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,18 @@
-# Temporary Holding Version
+# @storewatch/nextjs
 
-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.
+Storewatch for Next.js (15.3+): start tracking before hydration and send
+events through your own domain, so ad blockers and CORS don't get in the way.
+
+```ts
+// next.config.ts
+import { withStorewatch } from "@storewatch/nextjs/config";
+export default withStorewatch(nextConfig, { ingestUrl: "https://ingest.example.com" });
+
+// instrumentation-client.ts
+import { init } from "@storewatch/nextjs";
+init({ publicKey: process.env.NEXT_PUBLIC_STOREWATCH_KEY! });
+```
+
+Events go to `/_sw/v1/batch` on your domain. If your proxy or middleware
+matcher covers every path, exclude `/_sw`. Track commerce events with
+`getStorewatch().track(…)` or `useStorewatch()`.

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Adds a first-party proxy route to a Next.js config: the SDK posts to
+ * `/_sw/v1/batch` on the store's own domain and Next forwards it to ingest.
+ * Same-origin requests survive ad blockers and need no CORS.
+ *
+ *   // next.config.ts
+ *   import { withStorewatch } from "@storewatch/nextjs/config";
+ *   export default withStorewatch(nextConfig, { ingestUrl: "https://in.storewatch.example" });
+ *
+ * If your proxy/middleware matcher covers every path, exclude `/_sw`.
+ */
+type Rewrite = {
+    source: string;
+    destination: string;
+};
+type RewriteSet = {
+    beforeFiles?: Rewrite[];
+    afterFiles?: Rewrite[];
+    fallback?: Rewrite[];
+};
+export type WithStorewatchOptions = {
+    /** Base URL of the ingest service, without a trailing slash. */
+    ingestUrl: string;
+    /** Path prefix on the store's domain. Default "/_sw". */
+    path?: string;
+};
+/**
+ * `T extends object` rather than `ConfigWithRewrites`: a type whose properties
+ * are all optional is a "weak type", and TypeScript would reject any config
+ * that shares none of them, i.e. most Next configs.
+ */
+export declare function withStorewatch<T extends object>(config: T, options: WithStorewatchOptions): T & {
+    rewrites: () => Promise<RewriteSet>;
+};
+export {};

package/dist/config.js

@@ -0,0 +1,17 @@
+// src/config.ts
+function withStorewatch(config, options) {
+  const existingRewrites = config.rewrites;
+  const prefix = options.path ?? "/_sw";
+  const ours = { source: `${prefix}/:path*`, destination: `${options.ingestUrl.replace(/\/$/, "")}/:path*` };
+  return {
+    ...config,
+    async rewrites() {
+      const existing = await existingRewrites?.() ?? [];
+      if (Array.isArray(existing)) return { beforeFiles: [ours], afterFiles: existing, fallback: [] };
+      return { ...existing, beforeFiles: [ours, ...existing.beforeFiles ?? []] };
+    }
+  };
+}
+export {
+  withStorewatch
+};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Recommended: initialise in `instrumentation-client.ts`, which Next runs once
+ * before hydration, so no event can be tracked before init and no provider is
+ * needed. `useStorewatch()` works anywhere; the provider is optional.
+ */
+export { StorewatchProvider, getStorewatch, init, useStorewatch, money, type StorewatchProviderProps } from "@storewatch/react";
+export type { Consent, Storewatch, StorewatchOptions } from "@storewatch/react";

package/dist/index.js

@@ -0,0 +1,11 @@
+"use client";
+
+// src/index.ts
+import { StorewatchProvider, getStorewatch, init, useStorewatch, money } from "@storewatch/react";
+export {
+  StorewatchProvider,
+  getStorewatch,
+  init,
+  money,
+  useStorewatch
+};

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@storewatch/nextjs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Storewatch for Next.js: provider plus a first-party ingest proxy.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@storewatch/react": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15.3",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "react": "^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"
+  }
 }