@reopt-ai/data-sdk-client 0.1.2 → 0.1.4

package/dist/next.d.ts

@@ -1,9 +1,8 @@
 import * as react from 'react';
-export { R as ReoptClient, a as ReoptClientConfig, W as WebVitalMetric } from './client-B6gFgjju.js';
+export { R as ReoptClient, a as ReoptClientConfig, W as WebVitalMetric } from './client-CW9DfTlm.js';
 import { ReoptProviderProps } from './react.js';
 export { ReoptContextValue, useConsent, useIdentify, usePageView, usePageViewOnMount, useReopt, useReoptClient, useTrack, useTrackOnMount } from './react.js';
 export { ReoptBootstrap } from '@reopt-ai/data-contract/identity';
-import '@reopt-ai/data-sdk-core';
 
 /**
  * `ReoptProvider` for the App Router. Identical to the React one except

package/dist/next.js

@@ -35,7 +35,7 @@ function PageViewTracker() {
     const key = search ? `${pathname}?${search}` : pathname;
     if (lastKey.current === key) return;
     lastKey.current = key;
-    pageView({ path: pathname, properties: search ? { search } : void 0 });
+    pageView({ properties: search ? { search } : void 0 });
   }, [pathname, searchParams, pageView]);
   return null;
 }

package/dist/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/next/index.tsx"],"sourcesContent":["\"use client\";\n\nimport { Suspense, useCallback, useEffect, useRef } from \"react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { useReportWebVitals } from \"next/web-vitals\";\nimport type { WebVitalMetric } from \"../capture/web-vitals.js\";\nimport { ReoptProvider as BaseProvider, useReopt, type ReoptProviderProps } from \"../react/index.js\";\n\n/**\n * `ReoptProvider` for the App Router. Identical to the React one except\n * that it does not send the first `$pageview` itself — `<ReoptPageView />`\n * owns page views, the first one included, so nothing is counted twice.\n *\n * Because this module starts with `\"use client\"`, importing it from a server\n * component (your `app/layout.tsx`) creates the client boundary for you.\n */\nexport function ReoptProvider(props: ReoptProviderProps) {\n  return <BaseProvider {...props} initialPageView={false} />;\n}\n\n/**\n * Sends `$pageview` on every App Router navigation — pathname *and* query\n * string, so a filter change or a UTM landing counts. Render it as a\n * sibling of your page content, inside `<ReoptProvider>`; wrapping children\n * would rerender the whole tree on every navigation.\n *\n * It carries its own `<Suspense>` because `useSearchParams()` requires one\n * on prerendered routes; without it the nearest boundary — possibly your\n * entire layout — would fall back to client rendering.\n */\nexport function ReoptPageView() {\n  return (\n    <Suspense fallback={null}>\n      <PageViewTracker />\n    </Suspense>\n  );\n}\n\nfunction PageViewTracker() {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n  const { pageView } = useReopt();\n  const lastKey = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (!pathname) return;\n    const search = searchParams?.toString() ?? \"\";\n    const key = search ? `${pathname}?${search}` : pathname;\n    // StrictMode runs this effect twice for one navigation; the URL did not change, so neither should the count.\n    if (lastKey.current === key) return;\n    lastKey.current = key;\n    pageView({ path: pathname, properties: search ? { search } : undefined });\n  }, [pathname, searchParams, pageView]);\n\n  return null;\n}\n\n/**\n * Sends `$web_vitals` for every Core Web Vital Next reports (TTFB, FCP,\n * LCP, CLS, INP, …). Place it next to `<ReoptPageView />`.\n */\nexport function ReoptWebVitals() {\n  const { captureWebVital } = useReopt();\n  // A changing callback would re-report metrics already delivered.\n  const report = useCallback((metric: WebVitalMetric) => captureWebVital(metric), [captureWebVital]);\n  useReportWebVitals(report);\n  return null;\n}\n\nexport {\n  useReopt,\n  useReoptClient,\n  useTrack,\n  useIdentify,\n  usePageView,\n  useConsent,\n  useTrackOnMount,\n  usePageViewOnMount,\n} from \"../react/index.js\";\nexport type { ReoptContextValue, ReoptProviderProps } from \"../react/index.js\";\nexport type { ReoptBootstrap, ReoptClientConfig } from \"../config.js\";\nexport type { ReoptClient } from \"../client.js\";\nexport type { WebVitalMetric };\n"],"mappings":";;;;;;;;;;;;;;;;AAEA,SAAS,UAAU,aAAa,WAAW,cAAc;AACzD,SAAS,aAAa,uBAAuB;AAC7C,SAAS,0BAA0B;AAa1B;AADF,SAASA,eAAc,OAA2B;AACvD,SAAO,oBAAC,iBAAc,GAAG,OAAO,iBAAiB,OAAO;AAC1D;AAYO,SAAS,gBAAgB;AAC9B,SACE,oBAAC,YAAS,UAAU,MAClB,8BAAC,mBAAgB,GACnB;AAEJ;AAEA,SAAS,kBAAkB;AACzB,QAAM,WAAW,YAAY;AAC7B,QAAM,eAAe,gBAAgB;AACrC,QAAM,EAAE,SAAS,IAAI,SAAS;AAC9B,QAAM,UAAU,OAAsB,IAAI;AAE1C,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AACf,UAAM,SAAS,cAAc,SAAS,KAAK;AAC3C,UAAM,MAAM,SAAS,GAAG,QAAQ,IAAI,MAAM,KAAK;AAE/C,QAAI,QAAQ,YAAY,IAAK;AAC7B,YAAQ,UAAU;AAClB,aAAS,EAAE,MAAM,UAAU,YAAY,SAAS,EAAE,OAAO,IAAI,OAAU,CAAC;AAAA,EAC1E,GAAG,CAAC,UAAU,cAAc,QAAQ,CAAC;AAErC,SAAO;AACT;AAMO,SAAS,iBAAiB;AAC/B,QAAM,EAAE,gBAAgB,IAAI,SAAS;AAErC,QAAM,SAAS,YAAY,CAAC,WAA2B,gBAAgB,MAAM,GAAG,CAAC,eAAe,CAAC;AACjG,qBAAmB,MAAM;AACzB,SAAO;AACT;","names":["ReoptProvider"]}
+{"version":3,"sources":["../src/next/index.tsx"],"sourcesContent":["\"use client\";\n\nimport { Suspense, useCallback, useEffect, useRef } from \"react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport { useReportWebVitals } from \"next/web-vitals\";\nimport type { WebVitalMetric } from \"../capture/web-vitals.js\";\nimport { ReoptProvider as BaseProvider, useReopt, type ReoptProviderProps } from \"../react/index.js\";\n\n/**\n * `ReoptProvider` for the App Router. Identical to the React one except\n * that it does not send the first `$pageview` itself — `<ReoptPageView />`\n * owns page views, the first one included, so nothing is counted twice.\n *\n * Because this module starts with `\"use client\"`, importing it from a server\n * component (your `app/layout.tsx`) creates the client boundary for you.\n */\nexport function ReoptProvider(props: ReoptProviderProps) {\n  return <BaseProvider {...props} initialPageView={false} />;\n}\n\n/**\n * Sends `$pageview` on every App Router navigation — pathname *and* query\n * string, so a filter change or a UTM landing counts. Render it as a\n * sibling of your page content, inside `<ReoptProvider>`; wrapping children\n * would rerender the whole tree on every navigation.\n *\n * It carries its own `<Suspense>` because `useSearchParams()` requires one\n * on prerendered routes; without it the nearest boundary — possibly your\n * entire layout — would fall back to client rendering.\n */\nexport function ReoptPageView() {\n  return (\n    <Suspense fallback={null}>\n      <PageViewTracker />\n    </Suspense>\n  );\n}\n\nfunction PageViewTracker() {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n  const { pageView } = useReopt();\n  const lastKey = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (!pathname) return;\n    const search = searchParams?.toString() ?? \"\";\n    const key = search ? `${pathname}?${search}` : pathname;\n    // StrictMode runs this effect twice for one navigation; the URL did not change, so neither should the count.\n    if (lastKey.current === key) return;\n    lastKey.current = key;\n    // No explicit `path`: the runtime stamps it from `location.pathname`\n    // (identical to `usePathname()` once the navigation has committed), and\n    // that is the only path `normalizePath` applies to. Passing `pathname`\n    // here would bypass the hook for the very event whose cardinality it\n    // exists to control.\n    pageView({ properties: search ? { search } : undefined });\n  }, [pathname, searchParams, pageView]);\n\n  return null;\n}\n\n/**\n * Sends `$web_vitals` for every Core Web Vital Next reports (TTFB, FCP,\n * LCP, CLS, INP, …). Place it next to `<ReoptPageView />`.\n */\nexport function ReoptWebVitals() {\n  const { captureWebVital } = useReopt();\n  // A changing callback would re-report metrics already delivered.\n  const report = useCallback((metric: WebVitalMetric) => captureWebVital(metric), [captureWebVital]);\n  useReportWebVitals(report);\n  return null;\n}\n\nexport {\n  useReopt,\n  useReoptClient,\n  useTrack,\n  useIdentify,\n  usePageView,\n  useConsent,\n  useTrackOnMount,\n  usePageViewOnMount,\n} from \"../react/index.js\";\nexport type { ReoptContextValue, ReoptProviderProps } from \"../react/index.js\";\nexport type { ReoptBootstrap, ReoptClientConfig } from \"../config.js\";\nexport type { ReoptClient } from \"../client.js\";\nexport type { WebVitalMetric };\n"],"mappings":";;;;;;;;;;;;;;;;AAEA,SAAS,UAAU,aAAa,WAAW,cAAc;AACzD,SAAS,aAAa,uBAAuB;AAC7C,SAAS,0BAA0B;AAa1B;AADF,SAASA,eAAc,OAA2B;AACvD,SAAO,oBAAC,iBAAc,GAAG,OAAO,iBAAiB,OAAO;AAC1D;AAYO,SAAS,gBAAgB;AAC9B,SACE,oBAAC,YAAS,UAAU,MAClB,8BAAC,mBAAgB,GACnB;AAEJ;AAEA,SAAS,kBAAkB;AACzB,QAAM,WAAW,YAAY;AAC7B,QAAM,eAAe,gBAAgB;AACrC,QAAM,EAAE,SAAS,IAAI,SAAS;AAC9B,QAAM,UAAU,OAAsB,IAAI;AAE1C,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AACf,UAAM,SAAS,cAAc,SAAS,KAAK;AAC3C,UAAM,MAAM,SAAS,GAAG,QAAQ,IAAI,MAAM,KAAK;AAE/C,QAAI,QAAQ,YAAY,IAAK;AAC7B,YAAQ,UAAU;AAMlB,aAAS,EAAE,YAAY,SAAS,EAAE,OAAO,IAAI,OAAU,CAAC;AAAA,EAC1D,GAAG,CAAC,UAAU,cAAc,QAAQ,CAAC;AAErC,SAAO;AACT;AAMO,SAAS,iBAAiB;AAC/B,QAAM,EAAE,gBAAgB,IAAI,SAAS;AAErC,QAAM,SAAS,YAAY,CAAC,WAA2B,gBAAgB,MAAM,GAAG,CAAC,eAAe,CAAC;AACjG,qBAAmB,MAAM;AACzB,SAAO;AACT;","names":["ReoptProvider"]}

package/dist/react.d.ts

@@ -2,9 +2,7 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { ReoptBootstrap } from '@reopt-ai/data-contract/identity';
 export { ReoptBootstrap } from '@reopt-ai/data-contract/identity';
-import { TrackEventOptions, QueueResult, IdentifyOptions, IncrementOptions, DecrementOptions, PageViewOptions, FlushResult, ConsentCategory } from '@reopt-ai/data-sdk-core';
-export { ConsentCategory, DecrementOptions, FlushResult, IdentifyOptions, IncrementOptions, PageViewOptions, QueueResult, TrackEventOptions } from '@reopt-ai/data-sdk-core';
-import { R as ReoptClient, W as WebVitalMetric, a as ReoptClientConfig } from './client-B6gFgjju.js';
+import { R as ReoptClient, T as TrackEventOptions, Q as QueueResult, I as IdentifyOptions, c as IncrementOptions, D as DecrementOptions, P as PageViewOptions, W as WebVitalMetric, F as FlushResult, C as ConsentCategory, a as ReoptClientConfig } from './client-CW9DfTlm.js';
 
 interface ReoptContextValue {
     /** `null` during server rendering and before hydration. */
@@ -73,4 +71,4 @@ declare function useTrackOnMount(name: string, properties?: Record<string, unkno
 /** Sends one `$pageview` on mount with the options current at that moment. */
 declare function usePageViewOnMount(options?: PageViewOptions): void;
 
-export { ReoptClient, ReoptClientConfig, type ReoptContextValue, ReoptProvider, type ReoptProviderProps, WebVitalMetric, useConsent, useIdentify, usePageView, usePageViewOnMount, useReopt, useReoptClient, useTrack, useTrackOnMount };
+export { ConsentCategory, DecrementOptions, FlushResult, IdentifyOptions, IncrementOptions, PageViewOptions, QueueResult, ReoptClient, ReoptClientConfig, type ReoptContextValue, ReoptProvider, type ReoptProviderProps, TrackEventOptions, WebVitalMetric, useConsent, useIdentify, usePageView, usePageViewOnMount, useReopt, useReoptClient, useTrack, useTrackOnMount };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reopt-ai/data-sdk-client",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "reopt-data browser SDK — vanilla, React and Next.js App Router client components",
   "sideEffects": false,
   "license": "MIT",
@@ -51,7 +51,7 @@
     }
   },
   "dependencies": {
-    "@reopt-ai/data-contract": "0.6.1"
+    "@reopt-ai/data-contract": "0.6.2"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
@@ -64,8 +64,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@reopt-ai/data-sdk-core": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@reopt-ai/data-sdk-core": "0.0.0"
   },
   "scripts": {
     "build": "tsup && pnpm run check:dist && pnpm run check:size",

package/dist/client-B6gFgjju.d.ts

@@ -1,181 +0,0 @@
-import { ConsentConfig, BatchConfig, RetryConfig, CircuitBreakerConfig, StorageBackend, FetchLike, ReoptCore, PageViewOptions, QueueResult, IdentifyOptions, FlushResult } from '@reopt-ai/data-sdk-core';
-import { ReoptBootstrap, DeviceCookieState, ConsentCookieState } from '@reopt-ai/data-contract/identity';
-
-/**
- * The shape `next/web-vitals`' `useReportWebVitals` and the `web-vitals`
- * package both produce. Declared here so the vanilla entry does not have to
- * import either.
- */
-interface WebVitalMetric {
-    id: string;
-    name: string;
-    value: number;
-    delta?: number;
-    rating?: "good" | "needs-improvement" | "poor";
-    navigationType?: string;
-}
-type WebVitalProperties = {
-    metric_name: string;
-    metric_id: string;
-    value: number;
-    delta?: number;
-    rating?: string;
-    navigation_type?: string;
-    path: string;
-};
-
-/**
- * Rewrites a pathname before it is attached to an event, and may lift the
- * parts it removed into properties so they stay available for breakdowns:
- * `/workspace/8f3…/crm/customers/2a1…` → `{ path: "/workspace/:id/crm/customers/:id",
- * properties: { workspace_id: "8f3…" } }`.
- *
- * Applied wherever the SDK fills in a path itself — the default `$pageview`
- * path, `$pageleave`, `$web_vitals`, `$exception`. A `path` you pass to
- * `pageView()` explicitly is used as-is, so run the same function on it
- * yourself; two different rules would give one visit two different paths.
- * Must be synchronous and pure. If it throws, the raw pathname is used.
- */
-type NormalizePath = (pathname: string) => string | {
-    path: string;
-    properties?: Record<string, unknown>;
-};
-
-type IdentityStorageKind = "auto" | "cookie" | "localStorage" | "memory";
-interface IdentityConfig {
-    /**
-     * Where the device id lives. `auto` (default) prefers a cookie: Safari
-     * expires script-written `localStorage` after seven days of inactivity,
-     * which turns every returning visitor into a new device. A cookie the
-     * server also reads survives that, and lets server-side events join the
-     * same device.
-     */
-    storage?: IdentityStorageKind;
-    /** Cookie `Domain`; omit for host-only. Set to share across subdomains. */
-    cookieDomain?: string;
-    /** Cookie lifetime. Default 400 days (the longest Chrome honours). */
-    cookieMaxAgeSeconds?: number;
-}
-interface CaptureConfig {
-    /**
-     * Send `$pageview` on `init()`. Default `true` for the vanilla entry.
-     * The Next entry sets it to `false` because `<ReoptPageView />` owns page
-     * views there — including the first one.
-     */
-    pageview?: boolean;
-    /** Send `$pageleave` with time-on-page when the page is hidden or the route changes. Default `true`. */
-    pageleave?: boolean;
-    /** Attach max scroll depth to `$pageleave`. Default `true`. */
-    scrollDepth?: boolean;
-    /** Send `$exception` for uncaught errors and unhandled rejections. Default `false`. */
-    exceptions?: boolean;
-}
-interface ReoptClientConfig {
-    writeKey: string;
-    /** reopt-data origin, or the same-origin proxy prefix (e.g. `/ingest`) the Next.js proxy rewrites. */
-    baseUrl: string;
-    /** What the server already knows about this visitor. `null` = nothing. */
-    bootstrap?: ReoptBootstrap | null;
-    identity?: IdentityConfig;
-    capture?: CaptureConfig;
-    /**
-     * Hosts that receive the `reopt-device-id` header on outgoing `fetch`/XHR,
-     * so a server-side `track()` lands on the same device. `true` = the page's
-     * own hostname. **Default: off** — the trusted path is passing
-     * `getDeviceId()` to your server call explicitly; this patches `fetch`
-     * and loads as a separate chunk only when enabled.
-     */
-    tracingHeaders?: boolean | string[];
-    /** See {@link NormalizePath}. */
-    normalizePath?: NormalizePath;
-    /**
-     * Properties attached to every event from the very first one. Same as
-     * calling `register()` right after `init()`, except that nothing can
-     * slip out in between: web vitals arrive from a buffered
-     * `PerformanceObserver` and can fire the instant the client exists.
-     * Pass the page context the server already knows here; update it on
-     * client-side navigation with `register()`.
-     */
-    properties?: Record<string, unknown>;
-    consent?: ConsentConfig;
-    batch?: BatchConfig;
-    retry?: RetryConfig;
-    circuitBreaker?: CircuitBreakerConfig;
-    /** Upper bound on queued events. Default 10 000. */
-    maxQueueSize?: number;
-    /** Overrides the store for the offline queue. Default `localStorage`. */
-    queueStorage?: StorageBackend;
-    /** Prefix for storage keys. Default `reopt_`. */
-    storagePrefix?: string;
-    /**
-     * Transport override. Tests hand in a recording function so a Playwright
-     * spec can assert on the exact payload the SDK built, without intercepting
-     * the network. Defaults to the page's `fetch` (captured at init, before the
-     * tracing patch, so the SDK's own requests are never tagged twice).
-     */
-    fetch?: FetchLike;
-    debug?: boolean;
-}
-interface ResolvedCaptureConfig {
-    pageview: boolean;
-    pageleave: boolean;
-    scrollDepth: boolean;
-    exceptions: boolean;
-}
-
-interface IdentityStore {
-    readonly kind: Exclude<IdentityStorageKind, "auto">;
-    readDevice(): DeviceCookieState | null;
-    writeDevice(state: DeviceCookieState): void;
-    clearDevice(): void;
-    readConsent(): ConsentCookieState | null;
-    writeConsent(state: ConsentCookieState): void;
-    /** Engine-facing backend for the consent key, so consent decisions land in the same place. */
-    consentBackend(): StorageBackend;
-}
-
-interface ReoptClientDefaults {
-    /** Whether `init()` sends the first `$pageview`. The Next entry says no. */
-    pageview: boolean;
-}
-/**
- * The browser client: the shared engine plus everything that only makes
- * sense in a document — cookie identity, tracing headers, page leave,
- * scroll depth, exception capture, and a clock corrected against the
- * server's.
- */
-declare class ReoptClient extends ReoptCore {
-    readonly writeKey: string;
-    readonly capture: ResolvedCaptureConfig;
-    private readonly store;
-    private readonly pageLeave;
-    private readonly scroll;
-    private readonly uninstallers;
-    private torndown;
-    private readonly session;
-    private readonly normalize;
-    /** True when `writeKey` or `baseUrl` was missing: every call is a silent no-op. */
-    readonly disabled: boolean;
-    constructor(config: ReoptClientConfig, defaults?: ReoptClientDefaults);
-    /** Which store identity ended up in — `cookie`, `localStorage` or `memory`. */
-    get identityStorage(): IdentityStore["kind"];
-    pageView(options?: PageViewOptions): QueueResult;
-    identify(options: IdentifyOptions): QueueResult;
-    /** Feed a Web Vitals metric (from `next/web-vitals` or the `web-vitals` package). */
-    captureWebVital(metric: WebVitalMetric): QueueResult;
-    /** The page's path through `normalizePath`, for events the SDK stamps itself. */
-    private currentPath;
-    /** Report an error you caught yourself. */
-    captureException(error: unknown, properties?: Record<string, unknown>): QueueResult;
-    private trackException;
-    private emitPageLeave;
-    /**
-     * Log out: forget the profile and the queue, and become a new device.
-     * On a shared computer the next person must not inherit this one's
-     * history.
-     */
-    reset(): void;
-    close(): Promise<FlushResult>;
-}
-
-export { type CaptureConfig as C, type IdentityConfig as I, type NormalizePath as N, ReoptClient as R, type WebVitalMetric as W, type ReoptClientConfig as a, type ReoptClientDefaults as b, type IdentityStorageKind as c, type WebVitalProperties as d };