@lib-acr/react 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Application Control Room
+
+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,88 @@
-# Temporary Holding Version
+# @lib-acr/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 SDK: ACRProvider, hooks (useACR, useACREvent, useACRUser, useACRMetrics), an error boundary, and route tracking from `@lib-acr/react/router` for React Router.
+
+## Install
+
+```bash
+npm install @lib-acr/react
+```
+
+## Quick start
+
+```ts
+import { ACRProvider, ACRErrorBoundary, useACREvent } from '@lib-acr/react';
+import { ACRRouteTracker } from '@lib-acr/react/router';   // React Router v6.4+ only
+
+<ACRProvider config={{ apiKey: process.env.REACT_APP_ACR_API_KEY!, endpoint: 'https://acr.example.com/v1' }}>
+  <BrowserRouter>
+    <ACRRouteTracker />
+    <ACRErrorBoundary fallback={<p>Something went wrong.</p>}>
+      <App />
+    </ACRErrorBoundary>
+  </BrowserRouter>
+</ACRProvider>
+
+function AddToCart() {
+  const track = useACREvent();
+  return <button onClick={() => track('product_added_to_cart', { productId: '123', price: 500 })}>Add</button>;
+}
+```
+
+## Notes
+
+Never pass a secret key to the provider; it is rejected. User traits are sent only with `<ACRProvider collectUserTraits>`. The client is created once, so changes to `config` after mount are ignored.
+
+- **Logout:** `useACR().reset()` (or `useACRUser().reset()`) clears the user id, creates a new anonymous id and
+  starts a new session.
+- **Server-side rendering:** no client is created on the server, so no timers start there. Hooks are no-ops until the
+  provider renders in the browser, and `useACR().client` is `null` meanwhile.
+- **Options:** all `@lib-acr/browser` options apply, including `minLogLevel` (default `warn`) and
+  `activePingMinutes` (default 5, `0` turns the live-visitor ping off).
+- The entry point does not re-export `AcrClient`, `HttpTransport` or `resolveConfig` from `@lib-acr/core`.
+
+## Remote control
+
+`config.ui` controls the built-in maintenance screen, announcement banner and update prompt (default: all on). Turn
+parts off to render your own:
+
+```tsx
+import { ACRAnnouncement, ACRMaintenanceGate, useACRControls } from '@lib-acr/react';
+
+<ACRProvider config={{ apiKey, endpoint, appVersion: '2.3.0', ui: { maintenance: false, announcement: false } }}>
+  <ACRAnnouncement render={({ announcement, dismiss }) => <Banner text={announcement.message} onClose={dismiss} />} />
+  <ACRMaintenanceGate fallback={<MaintenancePage />}>
+    <App />
+  </ACRMaintenanceGate>
+</ACRProvider>;
+
+function UpdateNotice() {
+  const { release, reloadRequested } = useACRControls(); // also maintenance, announcement, flags, revision, refresh()
+  return release?.updateAvailable || reloadRequested ? <button onClick={() => location.reload()}>Update</button> : null;
+}
+```
+
+`ACRMaintenanceGate` renders its children unless maintenance applies to the current user. Its `fallback` defaults to
+nothing, so the built-in screen is what visitors see. Users in `allowUserIds` always see the children.
+
+## Feature flags
+
+```tsx
+const newCheckout = useFlag('new-checkout', false);
+```
+
+`useFlag` re-renders when the snapshot or the identified user changes. During server-side rendering and before the
+first snapshot, it and `useACRControls` return fallbacks and nothing is fetched.
+
+## Wire protocol
+
+Every SDK sends the same protocol: `POST {endpoint}/ingest/{events|logs|errors|heartbeat}` with the `X-ACR-Api-Key`
+header (and `X-ACR-Secret-Key` for server keys). The credential determines the app and environment. The body is
+`{ schemaVersion: 1, sdk, items[1..500] }`.
+Each item has a client `id`, which lets the server drop duplicates when a batch is retried.
+
+Retries use exponential backoff with jitter for network errors, 429 and 5xx responses. Other 4xx responses are not retried.
+Telemetry is buffered in a bounded in-memory queue. When it is full, the oldest items are dropped and counted in `stats()`.
+SDK code never throws into the host application.
+
+Metrics (`increment`, `gauge`, `histogram`) and traces are not yet available.

package/dist/cjs/context.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACRContext = void 0;
+exports.ACRProvider = ACRProvider;
+exports.useACRContext = useACRContext;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const browser_1 = require("@lib-acr/browser");
+const sdk_info_js_1 = require("./sdk-info.js");
+exports.ACRContext = (0, react_1.createContext)(null);
+const isBrowser = () => typeof window !== 'undefined';
+/**
+ * Creates one BrowserACR for the app, starts automatic collection on mount and flushes it on unmount. The client is
+ * created once, so later changes to `config` are ignored. During server-side rendering no client is created (it would
+ * start timers on the server); the hooks are no-ops until the provider renders in the browser.
+ */
+function ACRProvider({ config, collectUserTraits = false, children }) {
+    const [client] = (0, react_1.useState)(() => {
+        if (!isBrowser()) {
+            // Still fail fast on a secret key, even though no client is created here.
+            (0, browser_1.assertPublishableOptions)(config);
+            return null;
+        }
+        return new browser_1.BrowserACR(config, sdk_info_js_1.SDK_INFO);
+    });
+    (0, react_1.useEffect)(() => {
+        if (!client)
+            return undefined;
+        client.start();
+        return () => {
+            client.stop();
+            void client.flush();
+        };
+    }, [client]);
+    const value = (0, react_1.useMemo)(() => ({ client, collectUserTraits }), [client, collectUserTraits]);
+    return (0, jsx_runtime_1.jsx)(exports.ACRContext.Provider, { value: value, children: children });
+}
+function useACRContext() {
+    const value = (0, react_1.useContext)(exports.ACRContext);
+    if (!value)
+        throw new Error('[acr] ACR hooks and components must be used inside <ACRProvider>');
+    return value;
+}
+//# sourceMappingURL=context.js.map

package/dist/cjs/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.tsx"],"names":[],"mappings":";;;AAkCA,kCAqBC;AAED,sCAIC;;AA7DD,iCAAgG;AAChG,8CAAgG;AAChG,+CAAyC;AAW5B,QAAA,UAAU,GAAG,IAAA,qBAAa,EAAyB,IAAI,CAAC,CAAC;AActE,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC;AAE/D;;;;GAIG;AACH,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,KAAK,EAAE,QAAQ,EAAoB;IAC3F,MAAM,CAAC,MAAM,CAAC,GAAG,IAAA,gBAAQ,EAAoB,GAAG,EAAE;QAChD,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACjB,0EAA0E;YAC1E,IAAA,kCAAwB,EAAC,MAAM,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,oBAAU,CAAC,MAAM,EAAE,sBAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,IAAA,eAAO,EAAkB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC3G,OAAO,uBAAC,kBAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAuB,CAAC;AAC7E,CAAC;AAED,SAAgB,aAAa;IAC3B,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,kBAAU,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAChG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cjs/control.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useACRControlState = useACRControlState;
+exports.useFlag = useFlag;
+exports.useACRControls = useACRControls;
+exports.ACRMaintenanceGate = ACRMaintenanceGate;
+exports.ACRAnnouncement = ACRAnnouncement;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const browser_1 = require("@lib-acr/browser");
+const context_js_1 = require("./context.js");
+const noopUnsubscribe = () => undefined;
+const getServerState = () => browser_1.EMPTY_CONTROL_STATE;
+/**
+ * The full control state, re-rendering whenever it changes. During server-side rendering (no client) it is the empty
+ * state: nothing active, every flag falls back.
+ */
+function useACRControlState() {
+    const { client } = (0, context_js_1.useACRContext)();
+    const subscribe = (0, react_1.useCallback)((onChange) => (client ? client.onControlChange(() => onChange()) : noopUnsubscribe), [client]);
+    const getSnapshot = (0, react_1.useCallback)(() => (client ? client.getControlState() : browser_1.EMPTY_CONTROL_STATE), [client]);
+    return (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, getServerState);
+}
+/**
+ * Value of a feature flag for the current visitor, updated when the snapshot or the identified user changes. Returns
+ * `fallback` before the first snapshot, during server-side rendering, and when the flag is missing, disabled or
+ * served with another type.
+ *
+ * @example const newCheckout = useFlag('new-checkout', false);
+ */
+function useFlag(key, fallback) {
+    const { client } = (0, context_js_1.useACRContext)();
+    const state = useACRControlState();
+    // `state` is the dependency that changes on every relevant update; flag() reads the same snapshot.
+    return (0, react_1.useMemo)(() => (client && state.ready ? client.flag(key, fallback) : fallback), [client, state, key, fallback]);
+}
+/** Remote-control state for building your own maintenance page, banner or update prompt. */
+function useACRControls() {
+    const { client } = (0, context_js_1.useACRContext)();
+    const state = useACRControlState();
+    return (0, react_1.useMemo)(() => ({
+        maintenance: state.maintenance,
+        announcement: state.announcement,
+        release: state.release,
+        flags: state.flags,
+        revision: state.revision,
+        ready: state.ready,
+        reloadRequested: state.reloadRequested,
+        dismissAnnouncement: (id) => client?.dismissAnnouncement(id),
+        refresh: () => client?.refreshControl() ?? Promise.resolve(),
+    }), [client, state]);
+}
+/** Renders its children unless maintenance is on for this visitor. Users in `allowUserIds` always see the children. */
+function ACRMaintenanceGate({ fallback = null, children }) {
+    const { maintenance } = useACRControlState();
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: maintenance.active ? fallback : children });
+}
+/**
+ * Renders the current announcement until the visitor dismisses it. Turn off the built-in banner with
+ * `config.ui = { announcement: false }` when you use this component, or both will show.
+ */
+function ACRAnnouncement({ render }) {
+    const { announcement, dismissAnnouncement } = useACRControls();
+    if (!announcement || announcement.dismissed)
+        return null;
+    const dismiss = () => dismissAnnouncement(announcement.id);
+    if (render)
+        return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: render({ announcement, dismiss }) });
+    return ((0, jsx_runtime_1.jsxs)("div", { role: announcement.severity === 'info' ? 'status' : 'alert', "data-acr-severity": announcement.severity, children: [(0, jsx_runtime_1.jsx)("span", { children: announcement.message }), announcement.linkUrl ? ((0, jsx_runtime_1.jsx)("a", { href: announcement.linkUrl, target: "_blank", rel: "noopener noreferrer", children: "Learn more" })) : null, announcement.dismissible ? ((0, jsx_runtime_1.jsx)("button", { type: "button", "aria-label": "Dismiss announcement", onClick: dismiss, children: '×' })) : null] }));
+}
+//# sourceMappingURL=control.js.map

package/dist/cjs/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/control.tsx"],"names":[],"mappings":"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"}

package/dist/cjs/error-boundary.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACRErrorBoundary = ACRErrorBoundary;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const context_js_1 = require("./context.js");
+class ACRBoundary extends react_1.Component {
+    constructor() {
+        super(...arguments);
+        this.state = { error: null };
+        this.reset = () => {
+            this.setState({ error: null });
+        };
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        this.props.client?.captureError(error, {
+            handled: true,
+            source: 'frontend',
+            attributes: {
+                kind: 'render',
+                componentStack: info.componentStack ? info.componentStack.slice(0, 2000) : undefined,
+            },
+        });
+        this.props.onError?.(error, info);
+    }
+    render() {
+        const { error } = this.state;
+        if (error) {
+            const { fallback } = this.props;
+            return typeof fallback === 'function' ? fallback(error, this.reset) : (fallback ?? null);
+        }
+        return this.props.children;
+    }
+}
+/**
+ * Reports render errors from its subtree to ACR (handled: true, because the boundary handles them) and shows a fallback.
+ * It must sit below ACRProvider.
+ */
+function ACRErrorBoundary(props) {
+    const { client } = (0, context_js_1.useACRContext)();
+    return (0, jsx_runtime_1.jsx)(ACRBoundary, { client: client, ...props });
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/cjs/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../../src/error-boundary.tsx"],"names":[],"mappings":";;AAyDA,4CAGC;;AA5DD,iCAAkE;AAElE,6CAA6C;AAkB7C,MAAM,WAAY,SAAQ,iBAAiC;IAA3D;;QACW,UAAK,GAAe,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAkBrC,UAAK,GAAG,GAAS,EAAE;YACzB,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC;IAUJ,CAAC;IA5BC,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAEQ,iBAAiB,CAAC,KAAY,EAAE,IAAe;QACtD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE;YACrC,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aACrF;SACF,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAMQ,MAAM;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAChC,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,0BAAa,GAAE,CAAC;IACnC,OAAO,uBAAC,WAAW,IAAC,MAAM,EAAE,MAAM,KAAM,KAAK,GAAI,CAAC;AACpD,CAAC"}

package/dist/cjs/hooks.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useACR = useACR;
+exports.useACREvent = useACREvent;
+exports.useACRUser = useACRUser;
+exports.useACRMetrics = useACRMetrics;
+const react_1 = require("react");
+const context_js_1 = require("./context.js");
+const EMPTY_VITALS = Object.freeze({ fcp: null, lcp: null, cls: null, ttfb: null, inpMaxMs: null, pageLoadMs: null });
+const noopUnsubscribe = () => undefined;
+/**
+ * Everything the app needs from the client, bound once per provider. Every function is a safe no-op while there is no
+ * client (server-side rendering).
+ */
+function useACR() {
+    const { client } = (0, context_js_1.useACRContext)();
+    return (0, react_1.useMemo)(() => ({
+        /** The browser client, or null during server-side rendering. */
+        client,
+        trackEvent: (name, attributes) => client?.trackEvent(name, attributes),
+        log: (level, message, attributes) => client?.log(level, message, attributes),
+        captureError: (error, options) => client?.captureError(error, options),
+        identify: (userId) => client?.identify(userId),
+        trackPageView: (path) => client?.trackPageView(path),
+        /** Forgets the visitor (for example on logout): new anonymous id, new session, no user id. */
+        reset: () => client?.reset(),
+        flush: () => client?.flush() ?? Promise.resolve(),
+    }), [client]);
+}
+/** Returns a stable function that records a custom event: `const track = useACREvent(); track('cart_added', {sku})`. */
+function useACREvent() {
+    const { client } = (0, context_js_1.useACRContext)();
+    return (0, react_1.useCallback)((name, attributes) => client?.trackEvent(name, attributes), [client]);
+}
+function useACRUser() {
+    const { client, collectUserTraits } = (0, context_js_1.useACRContext)();
+    return (0, react_1.useMemo)(() => ({
+        identify: (userId, traits) => {
+            if (!client)
+                return;
+            client.identify(userId);
+            if (collectUserTraits && traits)
+                client.trackEvent('user_identified', traits);
+        },
+        clear: () => client?.identify(null),
+        reset: () => client?.reset(),
+    }), [client, collectUserTraits]);
+}
+/**
+ * Live Core Web Vitals for this page (LCP, FCP, CLS, TTFB, approximate INP and page load). Values are null until the
+ * browser reports them. The same values are sent to ACR when the page is hidden.
+ */
+function useACRMetrics() {
+    const { client } = (0, context_js_1.useACRContext)();
+    const subscribe = (0, react_1.useCallback)((onChange) => (client ? client.onVitals(() => onChange()) : noopUnsubscribe), [client]);
+    const getSnapshot = (0, react_1.useCallback)(() => (client ? client.getVitals() : EMPTY_VITALS), [client]);
+    const getServerSnapshot = (0, react_1.useCallback)(() => EMPTY_VITALS, []);
+    return (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cjs/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_INFO = exports.ACRErrorBoundary = exports.ACRAnnouncement = exports.ACRMaintenanceGate = exports.useACRControlState = exports.useACRControls = exports.useFlag = exports.useACRMetrics = exports.useACRUser = exports.useACREvent = exports.useACR = exports.useACRContext = exports.ACRContext = exports.ACRProvider = void 0;
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "ACRProvider", { enumerable: true, get: function () { return context_js_1.ACRProvider; } });
+Object.defineProperty(exports, "ACRContext", { enumerable: true, get: function () { return context_js_1.ACRContext; } });
+Object.defineProperty(exports, "useACRContext", { enumerable: true, get: function () { return context_js_1.useACRContext; } });
+var hooks_js_1 = require("./hooks.js");
+Object.defineProperty(exports, "useACR", { enumerable: true, get: function () { return hooks_js_1.useACR; } });
+Object.defineProperty(exports, "useACREvent", { enumerable: true, get: function () { return hooks_js_1.useACREvent; } });
+Object.defineProperty(exports, "useACRUser", { enumerable: true, get: function () { return hooks_js_1.useACRUser; } });
+Object.defineProperty(exports, "useACRMetrics", { enumerable: true, get: function () { return hooks_js_1.useACRMetrics; } });
+var control_js_1 = require("./control.js");
+Object.defineProperty(exports, "useFlag", { enumerable: true, get: function () { return control_js_1.useFlag; } });
+Object.defineProperty(exports, "useACRControls", { enumerable: true, get: function () { return control_js_1.useACRControls; } });
+Object.defineProperty(exports, "useACRControlState", { enumerable: true, get: function () { return control_js_1.useACRControlState; } });
+Object.defineProperty(exports, "ACRMaintenanceGate", { enumerable: true, get: function () { return control_js_1.ACRMaintenanceGate; } });
+Object.defineProperty(exports, "ACRAnnouncement", { enumerable: true, get: function () { return control_js_1.ACRAnnouncement; } });
+var error_boundary_js_1 = require("./error-boundary.js");
+Object.defineProperty(exports, "ACRErrorBoundary", { enumerable: true, get: function () { return error_boundary_js_1.ACRErrorBoundary; } });
+__exportStar(require("@lib-acr/browser"), exports);
+var sdk_info_js_1 = require("./sdk-info.js");
+Object.defineProperty(exports, "SDK_INFO", { enumerable: true, get: function () { return sdk_info_js_1.SDK_INFO; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAsE;AAA7D,yGAAA,WAAW,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,2GAAA,aAAa,OAAA;AAE/C,uCAA4E;AAAnE,kGAAA,MAAM,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEvD,2CAAgH;AAAvG,qGAAA,OAAO,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAEzF,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAEzB,mDAAiC;AACjC,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA"}

package/dist/cjs/router.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useACRTracking = useACRTracking;
+exports.ACRRouteTracker = ACRRouteTracker;
+const react_1 = require("react");
+const react_router_dom_1 = require("react-router-dom");
+const context_js_1 = require("./context.js");
+/**
+ * Records a page view on every route change. It needs React Router v6.4 or later, and it is exported from
+ * `@lib-acr/react/router` so apps without a router never load react-router-dom.
+ */
+function useACRTracking() {
+    const { client } = (0, context_js_1.useACRContext)();
+    const location = (0, react_router_dom_1.useLocation)();
+    (0, react_1.useEffect)(() => {
+        client?.trackPageView(location.pathname);
+    }, [client, location.pathname]);
+}
+/** Renders nothing; add it inside the router for route tracking without a hook call in your layout. */
+function ACRRouteTracker() {
+    useACRTracking();
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/dist/cjs/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":";;AAQA,wCAMC;AAGD,0CAGC;AApBD,iCAAkC;AAClC,uDAA+C;AAC/C,6CAA6C;AAE7C;;;GAGG;AACH,SAAgB,cAAc;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,0BAAa,GAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAA,8BAAW,GAAE,CAAC;IAC/B,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,uGAAuG;AACvG,SAAgB,eAAe;IAC7B,cAAc,EAAE,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/sdk-info.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_INFO = void 0;
+// Generated by scripts/sync-sdk-info.mjs from package.json. Do not edit by hand.
+exports.SDK_INFO = { name: '@lib-acr/react', version: '0.0.2' };
+//# sourceMappingURL=sdk-info.js.map

package/dist/cjs/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-info.js","sourceRoot":"","sources":["../../src/sdk-info.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACpE,QAAA,QAAQ,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC"}

package/dist/esm/context.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { BrowserACR, assertPublishableOptions } from '@lib-acr/browser';
+import { SDK_INFO } from './sdk-info.js';
+export const ACRContext = createContext(null);
+const isBrowser = () => typeof window !== 'undefined';
+/**
+ * Creates one BrowserACR for the app, starts automatic collection on mount and flushes it on unmount. The client is
+ * created once, so later changes to `config` are ignored. During server-side rendering no client is created (it would
+ * start timers on the server); the hooks are no-ops until the provider renders in the browser.
+ */
+export function ACRProvider({ config, collectUserTraits = false, children }) {
+    const [client] = useState(() => {
+        if (!isBrowser()) {
+            // Still fail fast on a secret key, even though no client is created here.
+            assertPublishableOptions(config);
+            return null;
+        }
+        return new BrowserACR(config, SDK_INFO);
+    });
+    useEffect(() => {
+        if (!client)
+            return undefined;
+        client.start();
+        return () => {
+            client.stop();
+            void client.flush();
+        };
+    }, [client]);
+    const value = useMemo(() => ({ client, collectUserTraits }), [client, collectUserTraits]);
+    return _jsx(ACRContext.Provider, { value: value, children: children });
+}
+export function useACRContext() {
+    const value = useContext(ACRContext);
+    if (!value)
+        throw new Error('[acr] ACR hooks and components must be used inside <ACRProvider>');
+    return value;
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAA0B,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAWzC,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC;AActE,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,KAAK,EAAE,QAAQ,EAAoB;IAC3F,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAoB,GAAG,EAAE;QAChD,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACjB,0EAA0E;YAC1E,wBAAwB,CAAC,MAAM,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,OAAO,CAAkB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC3G,OAAO,KAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAuB,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAChG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/control.js

@@ -0,0 +1,64 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { EMPTY_CONTROL_STATE } from '@lib-acr/browser';
+import { useACRContext } from './context.js';
+const noopUnsubscribe = () => undefined;
+const getServerState = () => EMPTY_CONTROL_STATE;
+/**
+ * The full control state, re-rendering whenever it changes. During server-side rendering (no client) it is the empty
+ * state: nothing active, every flag falls back.
+ */
+export function useACRControlState() {
+    const { client } = useACRContext();
+    const subscribe = useCallback((onChange) => (client ? client.onControlChange(() => onChange()) : noopUnsubscribe), [client]);
+    const getSnapshot = useCallback(() => (client ? client.getControlState() : EMPTY_CONTROL_STATE), [client]);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerState);
+}
+/**
+ * Value of a feature flag for the current visitor, updated when the snapshot or the identified user changes. Returns
+ * `fallback` before the first snapshot, during server-side rendering, and when the flag is missing, disabled or
+ * served with another type.
+ *
+ * @example const newCheckout = useFlag('new-checkout', false);
+ */
+export function useFlag(key, fallback) {
+    const { client } = useACRContext();
+    const state = useACRControlState();
+    // `state` is the dependency that changes on every relevant update; flag() reads the same snapshot.
+    return useMemo(() => (client && state.ready ? client.flag(key, fallback) : fallback), [client, state, key, fallback]);
+}
+/** Remote-control state for building your own maintenance page, banner or update prompt. */
+export function useACRControls() {
+    const { client } = useACRContext();
+    const state = useACRControlState();
+    return useMemo(() => ({
+        maintenance: state.maintenance,
+        announcement: state.announcement,
+        release: state.release,
+        flags: state.flags,
+        revision: state.revision,
+        ready: state.ready,
+        reloadRequested: state.reloadRequested,
+        dismissAnnouncement: (id) => client?.dismissAnnouncement(id),
+        refresh: () => client?.refreshControl() ?? Promise.resolve(),
+    }), [client, state]);
+}
+/** Renders its children unless maintenance is on for this visitor. Users in `allowUserIds` always see the children. */
+export function ACRMaintenanceGate({ fallback = null, children }) {
+    const { maintenance } = useACRControlState();
+    return _jsx(_Fragment, { children: maintenance.active ? fallback : children });
+}
+/**
+ * Renders the current announcement until the visitor dismisses it. Turn off the built-in banner with
+ * `config.ui = { announcement: false }` when you use this component, or both will show.
+ */
+export function ACRAnnouncement({ render }) {
+    const { announcement, dismissAnnouncement } = useACRControls();
+    if (!announcement || announcement.dismissed)
+        return null;
+    const dismiss = () => dismissAnnouncement(announcement.id);
+    if (render)
+        return _jsx(_Fragment, { children: render({ announcement, dismiss }) });
+    return (_jsxs("div", { role: announcement.severity === 'info' ? 'status' : 'alert', "data-acr-severity": announcement.severity, children: [_jsx("span", { children: announcement.message }), announcement.linkUrl ? (_jsx("a", { href: announcement.linkUrl, target: "_blank", rel: "noopener noreferrer", children: "Learn more" })) : null, announcement.dismissible ? (_jsx("button", { type: "button", "aria-label": "Dismiss announcement", onClick: dismiss, children: '×' })) : null] }));
+}
+//# sourceMappingURL=control.js.map

package/dist/esm/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/control.tsx"],"names":[],"mappings":"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"}

package/dist/esm/error-boundary.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component } from 'react';
+import { useACRContext } from './context.js';
+class ACRBoundary extends Component {
+    constructor() {
+        super(...arguments);
+        this.state = { error: null };
+        this.reset = () => {
+            this.setState({ error: null });
+        };
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        this.props.client?.captureError(error, {
+            handled: true,
+            source: 'frontend',
+            attributes: {
+                kind: 'render',
+                componentStack: info.componentStack ? info.componentStack.slice(0, 2000) : undefined,
+            },
+        });
+        this.props.onError?.(error, info);
+    }
+    render() {
+        const { error } = this.state;
+        if (error) {
+            const { fallback } = this.props;
+            return typeof fallback === 'function' ? fallback(error, this.reset) : (fallback ?? null);
+        }
+        return this.props.children;
+    }
+}
+/**
+ * Reports render errors from its subtree to ACR (handled: true, because the boundary handles them) and shows a fallback.
+ * It must sit below ACRProvider.
+ */
+export function ACRErrorBoundary(props) {
+    const { client } = useACRContext();
+    return _jsx(ACRBoundary, { client: client, ...props });
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/esm/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../../src/error-boundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAkB7C,MAAM,WAAY,SAAQ,SAAiC;IAA3D;;QACW,UAAK,GAAe,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAkBrC,UAAK,GAAG,GAAS,EAAE;YACzB,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC;IAUJ,CAAC;IA5BC,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAEQ,iBAAiB,CAAC,KAAY,EAAE,IAAe;QACtD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE;YACrC,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aACrF;SACF,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAMQ,MAAM;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAChC,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IACnC,OAAO,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,KAAM,KAAK,GAAI,CAAC;AACpD,CAAC"}

package/dist/esm/hooks.js

@@ -0,0 +1,54 @@
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { useACRContext } from './context.js';
+const EMPTY_VITALS = Object.freeze({ fcp: null, lcp: null, cls: null, ttfb: null, inpMaxMs: null, pageLoadMs: null });
+const noopUnsubscribe = () => undefined;
+/**
+ * Everything the app needs from the client, bound once per provider. Every function is a safe no-op while there is no
+ * client (server-side rendering).
+ */
+export function useACR() {
+    const { client } = useACRContext();
+    return useMemo(() => ({
+        /** The browser client, or null during server-side rendering. */
+        client,
+        trackEvent: (name, attributes) => client?.trackEvent(name, attributes),
+        log: (level, message, attributes) => client?.log(level, message, attributes),
+        captureError: (error, options) => client?.captureError(error, options),
+        identify: (userId) => client?.identify(userId),
+        trackPageView: (path) => client?.trackPageView(path),
+        /** Forgets the visitor (for example on logout): new anonymous id, new session, no user id. */
+        reset: () => client?.reset(),
+        flush: () => client?.flush() ?? Promise.resolve(),
+    }), [client]);
+}
+/** Returns a stable function that records a custom event: `const track = useACREvent(); track('cart_added', {sku})`. */
+export function useACREvent() {
+    const { client } = useACRContext();
+    return useCallback((name, attributes) => client?.trackEvent(name, attributes), [client]);
+}
+export function useACRUser() {
+    const { client, collectUserTraits } = useACRContext();
+    return useMemo(() => ({
+        identify: (userId, traits) => {
+            if (!client)
+                return;
+            client.identify(userId);
+            if (collectUserTraits && traits)
+                client.trackEvent('user_identified', traits);
+        },
+        clear: () => client?.identify(null),
+        reset: () => client?.reset(),
+    }), [client, collectUserTraits]);
+}
+/**
+ * Live Core Web Vitals for this page (LCP, FCP, CLS, TTFB, approximate INP and page load). Values are null until the
+ * browser reports them. The same values are sent to ACR when the page is hidden.
+ */
+export function useACRMetrics() {
+    const { client } = useACRContext();
+    const subscribe = useCallback((onChange) => (client ? client.onVitals(() => onChange()) : noopUnsubscribe), [client]);
+    const getSnapshot = useCallback(() => (client ? client.getVitals() : EMPTY_VITALS), [client]);
+    const getServerSnapshot = useCallback(() => EMPTY_VITALS, []);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/esm/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+export { ACRProvider, ACRContext, useACRContext } from './context.js';
+export { useACR, useACREvent, useACRUser, useACRMetrics } from './hooks.js';
+export { useFlag, useACRControls, useACRControlState, ACRMaintenanceGate, ACRAnnouncement } from './control.js';
+export { ACRErrorBoundary } from './error-boundary.js';
+export * from '@lib-acr/browser';
+export { SDK_INFO } from './sdk-info.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/router.js

@@ -0,0 +1,20 @@
+import { useEffect } from 'react';
+import { useLocation } from 'react-router-dom';
+import { useACRContext } from './context.js';
+/**
+ * Records a page view on every route change. It needs React Router v6.4 or later, and it is exported from
+ * `@lib-acr/react/router` so apps without a router never load react-router-dom.
+ */
+export function useACRTracking() {
+    const { client } = useACRContext();
+    const location = useLocation();
+    useEffect(() => {
+        client?.trackPageView(location.pathname);
+    }, [client, location.pathname]);
+}
+/** Renders nothing; add it inside the router for route tracking without a hook call in your layout. */
+export function ACRRouteTracker() {
+    useACRTracking();
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/dist/esm/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,eAAe;IAC7B,cAAc,EAAE,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/sdk-info.js

@@ -0,0 +1,3 @@
+// Generated by scripts/sync-sdk-info.mjs from package.json. Do not edit by hand.
+export const SDK_INFO = { name: '@lib-acr/react', version: '0.0.2' };
+//# sourceMappingURL=sdk-info.js.map

package/dist/esm/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-info.js","sourceRoot":"","sources":["../../src/sdk-info.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAW,CAAC"}

package/dist/types/context.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from 'react';
+import { BrowserACR, type BrowserAcrOptions } from '@lib-acr/browser';
+export interface ACRContextValue {
+    /**
+     * The browser client. It is null during server-side rendering, where no client is created; hooks then do nothing.
+     */
+    client: BrowserACR | null;
+    /** Whether identify(userId, traits) may send traits. Off by default because traits are often personal data. */
+    collectUserTraits: boolean;
+}
+export declare const ACRContext: import("react").Context<ACRContextValue | null>;
+export interface ACRProviderProps {
+    /**
+     * Browser options. Use the publishable key only; a secret key is rejected. `config.ui` controls the built-in
+     * maintenance screen, announcement banner and update prompt (set parts to false to render your own with
+     * useACRControls(), ACRMaintenanceGate or ACRAnnouncement).
+     */
+    config: BrowserAcrOptions;
+    /** Allow identify(userId, traits) to send traits. Default false. */
+    collectUserTraits?: boolean;
+    children?: ReactNode;
+}
+/**
+ * Creates one BrowserACR for the app, starts automatic collection on mount and flushes it on unmount. The client is
+ * created once, so later changes to `config` are ignored. During server-side rendering no client is created (it would
+ * start timers on the server); the hooks are no-ops until the provider renders in the browser.
+ */
+export declare function ACRProvider({ config, collectUserTraits, children }: ACRProviderProps): import("react").JSX.Element;
+export declare function useACRContext(): ACRContextValue;

package/dist/types/control.d.ts

@@ -0,0 +1,59 @@
+import { type ReactNode } from 'react';
+import { type AnnouncementState, type ControlState, type MaintenanceState, type ReleaseState } from '@lib-acr/browser';
+/**
+ * The full control state, re-rendering whenever it changes. During server-side rendering (no client) it is the empty
+ * state: nothing active, every flag falls back.
+ */
+export declare function useACRControlState(): ControlState;
+/**
+ * Value of a feature flag for the current visitor, updated when the snapshot or the identified user changes. Returns
+ * `fallback` before the first snapshot, during server-side rendering, and when the flag is missing, disabled or
+ * served with another type.
+ *
+ * @example const newCheckout = useFlag('new-checkout', false);
+ */
+export declare function useFlag<T>(key: string, fallback: T): T;
+export interface ACRControls {
+    /** Maintenance state for the current visitor (`active` is false for users in `allowUserIds`). */
+    maintenance: MaintenanceState;
+    /** Announcement inside its time window, or null. Check `dismissed` before showing it. */
+    announcement: AnnouncementState | null;
+    release: ReleaseState | null;
+    /** Every flag evaluated for the current visitor. */
+    flags: Readonly<Record<string, unknown>>;
+    /** Snapshot revision, null before the first snapshot. */
+    revision: number | null;
+    /** A snapshot has been received. */
+    ready: boolean;
+    /** A `reload` command asked the app to offer a reload. */
+    reloadRequested: boolean;
+    /** Hides the announcement for this visitor (remembered per id). */
+    dismissAnnouncement: (id: string) => void;
+    /** Fetches the control snapshot now. */
+    refresh: () => Promise<void>;
+}
+/** Remote-control state for building your own maintenance page, banner or update prompt. */
+export declare function useACRControls(): ACRControls;
+export interface ACRMaintenanceGateProps {
+    /**
+     * Rendered instead of the children while maintenance applies to this visitor. Default: nothing, so the built-in
+     * maintenance screen (or your own UI elsewhere) is what the visitor sees.
+     */
+    fallback?: ReactNode;
+    children?: ReactNode;
+}
+/** Renders its children unless maintenance is on for this visitor. Users in `allowUserIds` always see the children. */
+export declare function ACRMaintenanceGate({ fallback, children }: ACRMaintenanceGateProps): import("react").JSX.Element;
+export interface ACRAnnouncementRenderProps {
+    announcement: AnnouncementState;
+    dismiss: () => void;
+}
+export interface ACRAnnouncementProps {
+    /** Custom rendering. Without it a minimal, unstyled banner is rendered (role=status or alert, with a dismiss button). */
+    render?: (props: ACRAnnouncementRenderProps) => ReactNode;
+}
+/**
+ * Renders the current announcement until the visitor dismisses it. Turn off the built-in banner with
+ * `config.ui = { announcement: false }` when you use this component, or both will show.
+ */
+export declare function ACRAnnouncement({ render }: ACRAnnouncementProps): import("react").JSX.Element | null;

package/dist/types/error-boundary.d.ts

@@ -0,0 +1,13 @@
+import { type ErrorInfo, type ReactNode } from 'react';
+export interface ACRErrorBoundaryProps {
+    /** Shown instead of the children after an error. A function receives the error and a reset callback. */
+    fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+    /** Called after the error is reported. */
+    onError?: (error: Error, info: ErrorInfo) => void;
+    children?: ReactNode;
+}
+/**
+ * Reports render errors from its subtree to ACR (handled: true, because the boundary handles them) and shows a fallback.
+ * It must sit below ACRProvider.
+ */
+export declare function ACRErrorBoundary(props: ACRErrorBoundaryProps): import("react").JSX.Element;

package/dist/types/hooks.d.ts

@@ -0,0 +1,36 @@
+import type { Attributes, ErrorOptions, LogLevel, VitalsSnapshot } from '@lib-acr/browser';
+/**
+ * Everything the app needs from the client, bound once per provider. Every function is a safe no-op while there is no
+ * client (server-side rendering).
+ */
+export declare function useACR(): {
+    /** The browser client, or null during server-side rendering. */
+    client: import("@lib-acr/browser").BrowserACR | null;
+    trackEvent: (name: string, attributes?: Attributes) => void | undefined;
+    log: (level: LogLevel, message: string, attributes?: Attributes) => void | undefined;
+    captureError: (error: unknown, options?: ErrorOptions) => void | undefined;
+    identify: (userId: string | null) => void | undefined;
+    trackPageView: (path?: string) => void | undefined;
+    /** Forgets the visitor (for example on logout): new anonymous id, new session, no user id. */
+    reset: () => void | undefined;
+    flush: () => Promise<void>;
+};
+/** Returns a stable function that records a custom event: `const track = useACREvent(); track('cart_added', {sku})`. */
+export declare function useACREvent(): (name: string, attributes?: Attributes) => void;
+export interface ACRUser {
+    /**
+     * Attaches a user id to later telemetry. Traits are sent only when the provider sets `collectUserTraits`, and
+     * sensitive keys are redacted before they leave the page.
+     */
+    identify: (userId: string, traits?: Attributes) => void;
+    /** Stops attaching the user id. */
+    clear: () => void;
+    /** Like clear(), and also replaces the anonymous id and starts a new session. Use it on logout. */
+    reset: () => void;
+}
+export declare function useACRUser(): ACRUser;
+/**
+ * Live Core Web Vitals for this page (LCP, FCP, CLS, TTFB, approximate INP and page load). Values are null until the
+ * browser reports them. The same values are sent to ACR when the page is hidden.
+ */
+export declare function useACRMetrics(): VitalsSnapshot;

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export { ACRProvider, ACRContext, useACRContext } from './context.js';
+export type { ACRContextValue, ACRProviderProps } from './context.js';
+export { useACR, useACREvent, useACRUser, useACRMetrics } from './hooks.js';
+export type { ACRUser } from './hooks.js';
+export { useFlag, useACRControls, useACRControlState, ACRMaintenanceGate, ACRAnnouncement } from './control.js';
+export type { ACRControls, ACRMaintenanceGateProps, ACRAnnouncementProps, ACRAnnouncementRenderProps } from './control.js';
+export { ACRErrorBoundary } from './error-boundary.js';
+export type { ACRErrorBoundaryProps } from './error-boundary.js';
+export * from '@lib-acr/browser';
+export { SDK_INFO } from './sdk-info.js';

package/dist/types/router.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Records a page view on every route change. It needs React Router v6.4 or later, and it is exported from
+ * `@lib-acr/react/router` so apps without a router never load react-router-dom.
+ */
+export declare function useACRTracking(): void;
+/** Renders nothing; add it inside the router for route tracking without a hook call in your layout. */
+export declare function ACRRouteTracker(): null;

package/dist/types/sdk-info.d.ts

@@ -0,0 +1,4 @@
+export declare const SDK_INFO: {
+    readonly name: "@lib-acr/react";
+    readonly version: "0.0.2";
+};

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@lib-acr/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "ACR SDK for React: ACRProvider, hooks for events, users and vitals, an error boundary, and React Router page tracking.",
+  "license": "MIT",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./router": {
+      "types": "./dist/types/router.d.ts",
+      "import": "./dist/esm/router.js",
+      "require": "./dist/cjs/router.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.17"
+  },
+  "dependencies": {
+    "@lib-acr/browser": "0.0.2",
+    "@lib-acr/core": "0.0.2"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0 <20",
+    "react-router-dom": ">=6.4.0 <8"
+  },
+  "peerDependenciesMeta": {
+    "react-router-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.28.0"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/application-control-room/application.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/application-control-room/application/tree/main/packages/react#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}