kansoku-react 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# kansoku-react
+
+## 0.1.0
+
+### Minor Changes
+
+- b1c1458: Initial browser SDK: page views with navigation and attribution capture, session
+  and identity helpers (including set-once traits and keyed email), experiment exposure,
+  bounded persistent batching with retries, and lifecycle-safe beacon/keepalive exit delivery
+  with `page_leave`. Cross-origin identity via parent-domain cookies and `linkTo` handoff,
+  configurable bot flagging, and opt-in client error and web vitals capture (measurement code
+  loads on demand). React provider and hooks support StrictMode and server rendering.
+
+### Patch Changes
+
+- Updated dependencies [b1c1458]
+  - kansoku-js@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nadeem Bitar
+
+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,77 @@
-# Temporary Holding Version
+# kansoku-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 `kansoku-js`, with no runtime dependencies beyond the React and SDK peers.
+
+```bash
+bun add kansoku-js kansoku-react react
+```
+
+```tsx
+import { KansokuProvider, useTrack, useIdentify, useExperiment } from "kansoku-react"
+
+export function App() {
+  return (
+    <KansokuProvider
+      options={{ baseUrl: "https://analytics.example.com", writeKey: "ksk_w_public" }}
+    >
+      <Signup />
+    </KansokuProvider>
+  )
+}
+
+function Signup() {
+  const track = useTrack()
+  useIdentify("user_42", { plan: "team" })
+  useExperiment("signup_copy", "b")
+  return <button onClick={() => track("signup_started")}>Sign up</button>
+}
+```
+
+`KansokuProvider` reads `options` once. Remount with a `key` to reconfigure or change ownership
+mode. It constructs without capture, starts from an effect, stops on cleanup and never calls
+`shutdown()`. StrictMode's setup/cleanup/setup cycle is supported. You can instead pass
+`client={analytics}`; you then own its entire lifecycle, and the provider leaves it untouched.
+
+`useKansoku()` returns the client for `flush()`, `reset()`, `group()` and other methods.
+It throws if called without a provider in the browser; server rendering returns a no-op client.
+`useIdentifyOnce(userId, traits?)` follows the same user/client lifecycle as `useIdentify`,
+emitting explicit identify_once v1. It suppresses duplicate StrictMode effect setup; set-once
+is a server trait operation. A later identify v2 may replace the initialized value.
+
+`useTrack()` returns a stable tracking callback. `useIdentify(userId, traits?)` identifies on
+ID changes, ignoring traits object identity. An undefined user does not reset identity:
+call `useKansoku().reset()` explicitly on logout. `useExperiment(name, variant, properties?)`
+records exposure from an effect and relies on the core's per-session dedupe.
+
+## Routing
+
+React Router and other History API routers require no additional page-view code. Automatic
+capture is enabled by default. For explicit control, disable page autocapture and use a key:
+
+```tsx
+import { usePageView } from "kansoku-react"
+import { useLocation } from "react-router"
+
+function PageTracking() {
+  const location = useLocation()
+  usePageView(location.pathname + location.search, { section: "app" })
+  return null
+}
+// Provider options must include autocapture: { pageViews: false } for this pattern.
+```
+
+`usePageView(key, properties?)` emits on mount and key changes. It warns once in development
+when automatic page capture is still enabled, because using both counts views twice.
+
+Server rendering produces HTML without browser globals or network capture. Both packages
+are ESM-only; Node 20.19+ (22.12+ on Node 22) supports `require(esm)`. Jest's default
+CommonJS mode needs both packages in its ESM transform allowlist or native ESM configuration.
+TypeScript consumers install compatible `@types/react` (an optional peer for JS consumers).
+
+The provider passes `options.autocapture.clientErrors` and `options.autocapture.webVitals` to
+the core unchanged. Both default to `false`. Explicitly enabling them captures sanitized errors
+and document-scoped vitals, including under StrictMode's repeated effect setup/cleanup. Vitals
+use a deferred measurement file and retain their first view's attribution across SPA routes.
+Both events count as server engagement; consider bounce/duration consequences before adoption.
+See the [delivery and privacy guide](../../docs/guides/delivery-and-privacy.md#optional-client-errors-and-web-vitals)
+for limits, finalization, privacy and unsupported measurements.

package/dist/context.d.ts

@@ -0,0 +1,5 @@
+import type { KansokuClient } from "kansoku-js";
+export interface KansokuContextValue {
+    client: KansokuClient;
+}
+export declare const KansokuContext: import("react").Context<KansokuContextValue | null>;

package/dist/hooks/useExperiment.d.ts

@@ -0,0 +1,3 @@
+import type { JsonObject } from "kansoku-js";
+/** Record rendered exposure; kansoku-js owns per-session deduplication, including StrictMode. */
+export declare function useExperiment(experiment: string, variant: string, properties?: JsonObject): void;

package/dist/hooks/useIdentify.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from "kansoku-js";
+export declare function useIdentify(userId: string | undefined, traits?: JsonObject): void;

package/dist/hooks/useIdentifyOnce.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from "kansoku-js";
+export declare function useIdentifyOnce(userId: string | undefined, traits?: JsonObject): void;

package/dist/hooks/useKansoku.d.ts

@@ -0,0 +1,2 @@
+import type { KansokuClient } from "kansoku-js";
+export declare function useKansoku(): KansokuClient;

package/dist/hooks/usePageView.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from "kansoku-js";
+export declare function usePageView(key: string, properties?: JsonObject): void;

package/dist/hooks/useTrack.d.ts

@@ -0,0 +1,2 @@
+import type { KansokuClient } from "kansoku-js";
+export declare function useTrack(): KansokuClient["track"];

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { version } from "./version.js";
+export { KansokuProvider } from "./provider.js";
+export type { KansokuProviderProps } from "./provider.js";
+export { KansokuContext } from "./context.js";
+export type { KansokuContextValue } from "./context.js";
+export { createNoopClient } from "./noop-client.js";
+export { useKansoku } from "./hooks/useKansoku.js";
+export { useTrack } from "./hooks/useTrack.js";
+export { usePageView } from "./hooks/usePageView.js";
+export { useIdentify } from "./hooks/useIdentify.js";
+export { useIdentifyOnce } from "./hooks/useIdentifyOnce.js";
+export { useExperiment } from "./hooks/useExperiment.js";
+export type { KansokuClient, KansokuOptions, TrackOptions, JsonObject, IdentifierKind, } from "kansoku-js";

package/dist/index.js

@@ -0,0 +1,5 @@
+"use client";
+var c="0.1.0";var x=c;import{createKansoku as v}from"kansoku-js";import{useEffect as C,useMemo as j,useState as b}from"react";import{createContext as g}from"react";var u=g(null);var r=()=>{},p=()=>"",f=async()=>{};function a(){let e=Object.freeze({baseUrl:"",writeKey:"",sourceService:"",autoStart:!1,exitTransport:"keepalive",botDetection:"off",crossOriginLink:Object.freeze({accept:!1,allowedOrigins:[]}),flushAt:20,flushIntervalMs:5000,maxQueueSize:1000,maxBatchEvents:100,maxBatchBytes:1048576,maxRetries:0,retryBaseDelayMs:500,requestTimeoutMs:1e4,persistQueue:!1,storage:"memory",storageKeyPrefix:"kansoku",sessionTimeoutMs:1800000,schemaVersions:Object.freeze({}),autocapture:Object.freeze({pageViews:!1,sessions:!1}),optOut:!0,respectDoNotTrack:!1,respectGlobalPrivacyControl:!1,debug:!1,fetch:async()=>new Response(null,{status:204}),now:Date.now,timers:{setTimeout,clearTimeout}});return{linkTo:String,track:r,page:r,identify:r,identifyOnce:r,alias:r,group:r,experiment:r,setIdentifiers:r,reset:r,start:r,stop:r,optOut:r,optIn:r,flush:f,shutdown:f,getAnonymousId:p,getSessionId:p,getUserId:()=>{return},isOptedOut:()=>!0,stats:Object.freeze({queued:0,accepted:0,bestEffortQueued:0,rejected:0,dropped:0}),config:e}}import{jsxDEV as w}from"react/jsx-dev-runtime";function O(e){let[o]=b(()=>({client:e.client??(typeof window>"u"?a():v({...e.options,autoStart:!1})),owned:!e.client})),t=e.client??o.client,s=!e.client&&o.owned;C(()=>{if(!s)return;return t.start(),()=>t.stop()},[t,s]);let n=j(()=>({client:t}),[t]);return w(u.Provider,{value:n,children:e.children},void 0,!1,void 0,this)}import{useContext as E}from"react";var h=a();function i(){let e=E(u);if(e)return e.client;if(typeof window>"u")return h;throw Error("useKansoku must be used inside <KansokuProvider>")}import{useCallback as P}from"react";function R(){let e=i();return P((...o)=>e.track(...o),[e])}import{useEffect as V,useRef as l}from"react";var d=!1;function N(e,o){let t=i(),s=l(o),n=l(void 0);s.current=o,V(()=>{if(n.current?.client===t&&n.current.key===e)return;let y=typeof process<"u"&&process.env?.NODE_ENV==="production";if(t.config.autocapture.pageViews&&!y&&!d)d=!0,console.warn("kansoku-react: usePageView is active but kansoku-js autocapture.pageViews is still enabled; pass autocapture: { pageViews: false } to createKansoku or KansokuProvider options to avoid duplicate page_view events");t.page(s.current),n.current={client:t,key:e}},[t,e])}import{useEffect as T,useRef as k}from"react";function D(e,o){let t=i(),s=k(o);s.current=o;let n=k(void 0);T(()=>{if(!e){n.current=void 0;return}if(n.current?.client===t&&n.current.userId===e)return;t.identify(e,s.current),n.current={client:t,userId:e}},[t,e])}import{useEffect as I,useRef as m}from"react";function J(e,o){let t=i(),s=m(o);s.current=o;let n=m(void 0);I(()=>{if(!e){n.current=void 0;return}if(n.current?.client===t&&n.current.userId===e)return;t.identifyOnce(e,s.current),n.current={client:t,userId:e}},[t,e])}import{useEffect as z,useRef as M}from"react";function S(e,o,t){let s=i(),n=M(t);n.current=t,z(()=>{s.experiment(e,o,n.current)},[s,e,o])}export{u as KansokuContext,O as KansokuProvider,a as createNoopClient,S as useExperiment,D as useIdentify,J as useIdentifyOnce,i as useKansoku,N as usePageView,R as useTrack,x as version};
+
+//# debugId=7FACCC7FDB263B3664756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,19 @@
+{
+  "version": 3,
+  "sources": ["../src/version.ts", "../src/provider.tsx", "../src/context.ts", "../src/noop-client.ts", "../src/hooks/useKansoku.ts", "../src/hooks/useTrack.ts", "../src/hooks/usePageView.ts", "../src/hooks/useIdentify.ts", "../src/hooks/useIdentifyOnce.ts", "../src/hooks/useExperiment.ts"],
+  "sourcesContent": [
+    "import { version as packageVersion } from \"../package.json\"\nexport const version: string = packageVersion\n",
+    "import { createKansoku } from \"kansoku-js\"\nimport type { KansokuClient, KansokuOptions } from \"kansoku-js\"\nimport { useEffect, useMemo, useState } from \"react\"\nimport type { ReactElement, ReactNode } from \"react\"\n\nimport { KansokuContext } from \"./context.js\"\nimport { createNoopClient } from \"./noop-client.js\"\n\nexport type KansokuProviderProps = (\n  | { client: KansokuClient; options?: never }\n  | { options: KansokuOptions; client?: never }\n) & { children: ReactNode }\n\nexport function KansokuProvider(props: KansokuProviderProps): ReactElement {\n  const [initial] = useState(() => ({\n    client:\n      props.client ??\n      (typeof window === \"undefined\"\n        ? createNoopClient()\n        : createKansoku({ ...props.options!, autoStart: false })),\n    owned: !props.client,\n  }))\n  const client = props.client ?? initial.client\n  const ownsClient = !props.client && initial.owned\n  useEffect(() => {\n    if (!ownsClient) return\n    client.start()\n    return () => client.stop()\n  }, [client, ownsClient])\n  const value = useMemo(() => ({ client }), [client])\n  return <KansokuContext.Provider value={value}>{props.children}</KansokuContext.Provider>\n}\n",
+    "import type { KansokuClient } from \"kansoku-js\"\nimport { createContext } from \"react\"\n\nexport interface KansokuContextValue {\n  client: KansokuClient\n}\nexport const KansokuContext = createContext<KansokuContextValue | null>(null)\n",
+    "import type { KansokuClient, ResolvedKansokuOptions } from \"kansoku-js\"\n\nconst noop = () => {}\nconst empty = () => \"\"\nconst resolved = async () => {}\nexport function createNoopClient(): KansokuClient {\n  const config: ResolvedKansokuOptions = Object.freeze({\n    baseUrl: \"\",\n    writeKey: \"\",\n    sourceService: \"\",\n    autoStart: false,\n    exitTransport: \"keepalive\",\n    botDetection: \"off\",\n    crossOriginLink: Object.freeze({ accept: false, allowedOrigins: [] }),\n    flushAt: 20,\n    flushIntervalMs: 5000,\n    maxQueueSize: 1000,\n    maxBatchEvents: 100,\n    maxBatchBytes: 1048576,\n    maxRetries: 0,\n    retryBaseDelayMs: 500,\n    requestTimeoutMs: 10000,\n    persistQueue: false,\n    storage: \"memory\",\n    storageKeyPrefix: \"kansoku\",\n    sessionTimeoutMs: 1800000,\n    schemaVersions: Object.freeze({}),\n    autocapture: Object.freeze({ pageViews: false, sessions: false }),\n    optOut: true,\n    respectDoNotTrack: false,\n    respectGlobalPrivacyControl: false,\n    debug: false,\n    fetch: (async () => new Response(null, { status: 204 })) as unknown as typeof fetch,\n    now: Date.now,\n    timers: { setTimeout, clearTimeout },\n  })\n  return {\n    linkTo: String,\n    track: noop,\n    page: noop,\n    identify: noop,\n    identifyOnce: noop,\n    alias: noop,\n    group: noop,\n    experiment: noop,\n    setIdentifiers: noop,\n    reset: noop,\n    start: noop,\n    stop: noop,\n    optOut: noop,\n    optIn: noop,\n    flush: resolved,\n    shutdown: resolved,\n    getAnonymousId: empty,\n    getSessionId: empty,\n    getUserId: () => undefined,\n    isOptedOut: () => true,\n    stats: Object.freeze({\n      queued: 0,\n      accepted: 0,\n      bestEffortQueued: 0,\n      rejected: 0,\n      dropped: 0,\n    }),\n    config,\n  }\n}\n",
+    "import type { KansokuClient } from \"kansoku-js\"\nimport { useContext } from \"react\"\n\nimport { KansokuContext } from \"../context.js\"\nimport { createNoopClient } from \"../noop-client.js\"\n\nconst serverClient = createNoopClient()\nexport function useKansoku(): KansokuClient {\n  const value = useContext(KansokuContext)\n  if (value) return value.client\n  if (typeof window === \"undefined\") return serverClient\n  throw new Error(\"useKansoku must be used inside <KansokuProvider>\")\n}\n",
+    "import type { KansokuClient } from \"kansoku-js\"\nimport { useCallback } from \"react\"\n\nimport { useKansoku } from \"./useKansoku.js\"\n\nexport function useTrack(): KansokuClient[\"track\"] {\n  const client = useKansoku()\n  return useCallback((...args) => client.track(...args), [client])\n}\n",
+    "import type { JsonObject, KansokuClient } from \"kansoku-js\"\nimport { useEffect, useRef } from \"react\"\n\nimport { useKansoku } from \"./useKansoku.js\"\n\ndeclare const process: { env?: { NODE_ENV?: string } }\n\nlet warned = false\nexport function usePageView(key: string, properties?: JsonObject): void {\n  const client = useKansoku()\n  const latest = useRef(properties)\n  const previous = useRef<{ client: KansokuClient; key: string } | undefined>(undefined)\n  latest.current = properties\n  useEffect(() => {\n    if (previous.current?.client === client && previous.current.key === key) return\n    const production = typeof process !== \"undefined\" && process.env?.NODE_ENV === \"production\"\n    if (client.config.autocapture.pageViews && !production && !warned) {\n      warned = true\n      console.warn(\n        \"kansoku-react: usePageView is active but kansoku-js autocapture.pageViews is still enabled; pass autocapture: { pageViews: false } to createKansoku or KansokuProvider options to avoid duplicate page_view events\",\n      )\n    }\n    client.page(latest.current)\n    previous.current = { client, key }\n  }, [client, key])\n}\n",
+    "import type { JsonObject, KansokuClient } from \"kansoku-js\"\nimport { useEffect, useRef } from \"react\"\n\nimport { useKansoku } from \"./useKansoku.js\"\n\nexport function useIdentify(userId: string | undefined, traits?: JsonObject): void {\n  const client = useKansoku()\n  const latest = useRef(traits)\n  latest.current = traits\n  const previous = useRef<{ client: KansokuClient; userId: string } | undefined>(undefined)\n  useEffect(() => {\n    if (!userId) {\n      previous.current = undefined\n      return\n    }\n    if (previous.current?.client === client && previous.current.userId === userId) return\n    client.identify(userId, latest.current)\n    previous.current = { client, userId }\n  }, [client, userId])\n}\n",
+    "import type { JsonObject, KansokuClient } from \"kansoku-js\"\nimport { useEffect, useRef } from \"react\"\n\nimport { useKansoku } from \"./useKansoku.js\"\n\nexport function useIdentifyOnce(userId: string | undefined, traits?: JsonObject): void {\n  const client = useKansoku()\n  const latest = useRef(traits)\n  latest.current = traits\n  const previous = useRef<{ client: KansokuClient; userId: string } | undefined>(undefined)\n  useEffect(() => {\n    if (!userId) {\n      previous.current = undefined\n      return\n    }\n    if (previous.current?.client === client && previous.current.userId === userId) return\n    client.identifyOnce(userId, latest.current)\n    previous.current = { client, userId }\n  }, [client, userId])\n}\n",
+    "import type { JsonObject } from \"kansoku-js\"\nimport { useEffect, useRef } from \"react\"\n\nimport { useKansoku } from \"./useKansoku.js\"\n\n/** Record rendered exposure; kansoku-js owns per-session deduplication, including StrictMode. */\nexport function useExperiment(experiment: string, variant: string, properties?: JsonObject): void {\n  const client = useKansoku()\n  const latest = useRef(properties)\n  latest.current = properties\n  useEffect(() => {\n    client.experiment(experiment, variant, latest.current)\n  }, [client, experiment, variant])\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "7FACCC7FDB263B3664756E2164756E21",
+  "names": []
+}

package/dist/noop-client.d.ts

@@ -0,0 +1,2 @@
+import type { KansokuClient } from "kansoku-js";
+export declare function createNoopClient(): KansokuClient;

package/dist/provider.d.ts

@@ -0,0 +1,12 @@
+import type { KansokuClient, KansokuOptions } from "kansoku-js";
+import type { ReactElement, ReactNode } from "react";
+export type KansokuProviderProps = ({
+    client: KansokuClient;
+    options?: never;
+} | {
+    options: KansokuOptions;
+    client?: never;
+}) & {
+    children: ReactNode;
+};
+export declare function KansokuProvider(props: KansokuProviderProps): ReactElement;

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const version: string;

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "kansoku-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "React bindings for kansoku-js",
+  "keywords": [
+    "analytics",
+    "browser",
+    "kansoku",
+    "react"
+  ],
+  "homepage": "https://github.com/shinzui/kansoku-ts#readme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shinzui/kansoku-ts.git",
+    "directory": "packages/kansoku-react"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "bun ../../scripts/build.ts .",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "kansoku-js": "workspace:*",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "peerDependencies": {
+    "@types/react": ">=18",
+    "kansoku-js": "^0.1.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "kansoku": {
+    "banner": "\"use client\";"
+  }
+}