@liteguard/liteguard-react 0.2.20260314

package/README.md

@@ -0,0 +1,141 @@
+# @liteguard/liteguard-react
+
+[![JavaScript SDK](https://github.com/liteguard/liteguard/actions/workflows/test-js.yml/badge.svg)](https://github.com/liteguard/liteguard/actions/workflows/test-js.yml)
+[![npm](https://img.shields.io/npm/v/@liteguard/liteguard-react)](https://www.npmjs.com/package/@liteguard/liteguard-react)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/liteguard/liteguard/blob/main/LICENSE)
+
+> Feature guards, observability, and security response in a single import — evaluated locally, zero network overhead per check.
+
+React bindings for Liteguard. Drop in `<LiteguardProvider>` and use the `useIsOpen` hook to gate any component tree — guards are evaluated locally with no network round-trips.
+
+Powered by [`@liteguard/liteguard-browser`](https://www.npmjs.com/package/@liteguard/liteguard-browser) under the hood, so runtime behavior, signal telemetry, and CVE auto-disable all work out of the box.
+
+---
+
+## Installation
+
+```bash
+npm install @liteguard/liteguard-react
+```
+
+React 18+ and react-dom 18+ are required as peer dependencies.
+
+---
+
+## Quick Start
+
+```tsx
+import { LiteguardProvider, useIsOpen } from '@liteguard/liteguard-react';
+
+function CheckoutButton() {
+  const enabled = useIsOpen('payments.checkout');
+  if (!enabled) return null;
+  return <button onClick={checkout}>Checkout</button>;
+}
+
+export function App() {
+  return (
+    <LiteguardProvider projectClientKeyId="pckid-..." properties={{ userId: 'user-123', plan: 'pro' }}>
+      <CheckoutButton />
+    </LiteguardProvider>
+  );
+}
+```
+
+---
+
+## API Reference
+
+### `<LiteguardProvider>`
+
+Context provider that initializes the Liteguard browser client and makes it available to all descendant components. Place it near the top of your component tree, typically alongside your other providers.
+
+```tsx
+<LiteguardProvider
+  projectClientKeyId="pckid-..."
+  environment="production"      // optional — uses workspace default if omitted
+  properties={{ userId: 'user-123', plan: 'pro' }}  // optional initial properties
+  fallback={false}              // default result while guards are loading
+>
+  {children}
+</LiteguardProvider>
+```
+
+All `init` options are accepted as props with the same `camelCase` names:
+
+| Prop | Default | Description |
+|---|---|---|
+| `projectClientKeyId` | required | Your Liteguard project client key |
+| `environment` | workspace default | Environment slug |
+| `fallback` | `false` | Guard result before rules load |
+| `refreshRateSeconds` | `30` | Guard rule refresh interval |
+| `flushRateSeconds` | `10` | Signal flush interval |
+| `flushSize` | `500` | Max buffered signals before forced flush |
+| `httpTimeoutSeconds` | `4` | HTTP request timeout |
+| `backendUrl` | `https://api.liteguard.io` | API base URL override |
+
+### `useIsOpen(name, options?) → boolean`
+
+Hook that returns `true` if the named guard is open for the current context. Re-renders when guard rules are refreshed.
+
+```tsx
+const enabled = useIsOpen('payments.checkout');
+
+// With per-call property override
+const enabled = useIsOpen('payments.checkout', { properties: { region: 'us-east-1' } });
+```
+
+> `useIsOpen` is intentionally render-safe and does not emit `guard_execution` measurement signals. For guarded execution with telemetry, use `useLiteguardClient().executeIfOpen(...)`.
+
+### `useLiteguardClient() → LiteguardClient`
+
+Returns the underlying `LiteguardClient` instance. Use this for guarded execution with measurement signals, programmatic property management, or direct guard checks outside of React rendering.
+
+```tsx
+function CheckoutButton() {
+  const client = useLiteguardClient();
+
+  const handleClick = async () => {
+    const session = await client.executeIfOpenAsync('payments.checkout', async () => {
+      return createCheckoutSession();
+    });
+
+    if (session === undefined) {
+      // guard was closed
+    }
+  };
+
+  return <button onClick={handleClick}>Checkout</button>;
+}
+```
+
+---
+
+## Guard Evaluation
+
+Guards are evaluated **client-side** against rules fetched once at initialization and refreshed periodically. Rules are evaluated in order — **first matching rule wins**. If no rule matches the guard's configured default applies.
+
+```
+guard "payments.checkout"
+  rule: plan == "pro"           → open
+  rule: userId in [canary-list] → open
+  default                       → closed
+```
+
+### Operators
+
+| Operator | Description |
+|---|---|
+| `EQUALS` | Exact match |
+| `NOT_EQUALS` | Negated exact match |
+| `IN` | Value in a set |
+| `NOT_IN` | Value not in a set |
+| `REGEX` | Regular expression match |
+| `GT` / `GTE` | Greater than / greater or equal |
+| `LT` / `LTE` | Less than / less or equal |
+
+---
+
+## License
+
+Apache 2.0 — see [LICENSE](https://github.com/liteguard/liteguard/blob/main/LICENSE).

package/dist/index.d.mts

@@ -0,0 +1,120 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { LiteguardClient, ClientOptions, Properties, Options } from '@liteguard/liteguard-browser';
+
+/** Props for {@link LiteguardProvider}. */
+type LiteguardProviderProps = {
+    /**
+     * An externally created {@link LiteguardClient} instance. When provided,
+     * the provider uses this client directly and does **not** manage its
+     * lifecycle (you are responsible for calling `start()` / `shutdown()`).
+     */
+    client?: LiteguardClient;
+    /**
+     * Your project client key ID. When provided (without `client`), the
+     * provider automatically creates, starts, and shuts down a managed client.
+     */
+    projectClientKeyId?: string;
+    /** Optional SDK configuration overrides for the managed client. */
+    options?: ClientOptions;
+    /** Optional default properties applied to the active client scope. */
+    properties?: Properties;
+    environment?: ClientOptions['environment'];
+    fallback?: ClientOptions['fallback'];
+    refreshRateSeconds?: ClientOptions['refreshRateSeconds'];
+    flushRateSeconds?: ClientOptions['flushRateSeconds'];
+    flushSize?: ClientOptions['flushSize'];
+    backendUrl?: ClientOptions['backendUrl'];
+    quiet?: ClientOptions['quiet'];
+    httpTimeoutSeconds?: ClientOptions['httpTimeoutSeconds'];
+    flushBufferMultiplier?: ClientOptions['flushBufferMultiplier'];
+    disableMeasurement?: ClientOptions['disableMeasurement'];
+    /**
+     * React node rendered while the managed client is fetching its initial
+     * guard bundle. Defaults to `null` (render nothing).
+     */
+    loading?: ReactNode;
+    /** Application subtree that gains access to the Liteguard client via context. */
+    children: ReactNode;
+};
+/**
+ * React context provider that makes a Liteguard client available to the
+ * component tree via React context.
+ *
+ * **Managed mode** — pass `projectClientKeyId` (and optional `options`) to
+ * have the provider create, start, and shut down a client automatically.
+ * While the initial guard bundle is loading, the optional `loading` subtree
+ * is rendered instead of `children`.
+ *
+ * **External mode** — pass a pre-configured `client` instance and the
+ * provider simply makes it available through context without managing its
+ * lifecycle.
+ *
+ * @example
+ * ```tsx
+ * // Managed mode
+ * <LiteguardProvider projectClientKeyId="pk_live_..." loading={<Spinner />}>
+ *   <App />
+ * </LiteguardProvider>
+ *
+ * // External mode
+ * const client = new LiteguardClient('pk_live_...');
+ * await client.start();
+ * <LiteguardProvider client={client}>
+ *   <App />
+ * </LiteguardProvider>
+ * ```
+ */
+declare function LiteguardProvider({ client, projectClientKeyId, options, properties, environment, fallback, refreshRateSeconds, flushRateSeconds, flushSize, backendUrl, quiet, httpTimeoutSeconds, flushBufferMultiplier, disableMeasurement, loading, children, }: LiteguardProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Return the nearest Liteguard client from React context, or `null` if no
+ * provider is present.
+ *
+ * Prefer {@link useLiteguardClient} when you need to assert that a client
+ * is available.
+ *
+ * @returns The {@link LiteguardClient}, or `null`.
+ */
+declare function useLiteguard(): LiteguardClient | null;
+/**
+ * Return the nearest Liteguard client from React context. Throws if no
+ * client is available — ensures the component is rendered inside a
+ * {@link LiteguardProvider}.
+ *
+ * @returns The {@link LiteguardClient}.
+ * @throws {Error} When no Liteguard client is reachable.
+ */
+declare function useLiteguardClient(): LiteguardClient;
+/**
+ * Returns `true` once the Liteguard client has fetched its initial guard
+ * bundle. Re-renders the component automatically when the ready state
+ * changes.
+ *
+ * @returns `true` when the client is ready, `false` otherwise.
+ */
+declare function useLiteguardReady(): boolean;
+/**
+ * Return `true` if the named guard is open for the current context.
+ * Re-renders automatically whenever the guard bundle is refreshed.
+ *
+ * Internally uses `peekIsOpen` so guard checks during renders do **not**
+ * emit telemetry signals or consume rate-limit slots. For guarded
+ * side-effects that need telemetry, call
+ * `useLiteguardClient().executeIfOpen()` in an event handler or effect.
+ *
+ * @param name - Guard name to evaluate (e.g. `"feature.beta"`).
+ * @param options - Optional per-call overrides (extra properties, fallback).
+ * @returns `true` if the guard is open, `false` otherwise.
+ *
+ * @example
+ * ```tsx
+ * function Banner() {
+ *   const showBeta = useIsOpen('promo.banner');
+ *   if (!showBeta) return null;
+ *   return <div>Try our new beta!</div>;
+ * }
+ * ```
+ */
+declare function useIsOpen(name: string, options?: Partial<Options>): boolean;
+
+export { LiteguardProvider, type LiteguardProviderProps, useIsOpen, useLiteguard, useLiteguardClient, useLiteguardReady };

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { LiteguardClient, ClientOptions, Properties, Options } from '@liteguard/liteguard-browser';
+
+/** Props for {@link LiteguardProvider}. */
+type LiteguardProviderProps = {
+    /**
+     * An externally created {@link LiteguardClient} instance. When provided,
+     * the provider uses this client directly and does **not** manage its
+     * lifecycle (you are responsible for calling `start()` / `shutdown()`).
+     */
+    client?: LiteguardClient;
+    /**
+     * Your project client key ID. When provided (without `client`), the
+     * provider automatically creates, starts, and shuts down a managed client.
+     */
+    projectClientKeyId?: string;
+    /** Optional SDK configuration overrides for the managed client. */
+    options?: ClientOptions;
+    /** Optional default properties applied to the active client scope. */
+    properties?: Properties;
+    environment?: ClientOptions['environment'];
+    fallback?: ClientOptions['fallback'];
+    refreshRateSeconds?: ClientOptions['refreshRateSeconds'];
+    flushRateSeconds?: ClientOptions['flushRateSeconds'];
+    flushSize?: ClientOptions['flushSize'];
+    backendUrl?: ClientOptions['backendUrl'];
+    quiet?: ClientOptions['quiet'];
+    httpTimeoutSeconds?: ClientOptions['httpTimeoutSeconds'];
+    flushBufferMultiplier?: ClientOptions['flushBufferMultiplier'];
+    disableMeasurement?: ClientOptions['disableMeasurement'];
+    /**
+     * React node rendered while the managed client is fetching its initial
+     * guard bundle. Defaults to `null` (render nothing).
+     */
+    loading?: ReactNode;
+    /** Application subtree that gains access to the Liteguard client via context. */
+    children: ReactNode;
+};
+/**
+ * React context provider that makes a Liteguard client available to the
+ * component tree via React context.
+ *
+ * **Managed mode** — pass `projectClientKeyId` (and optional `options`) to
+ * have the provider create, start, and shut down a client automatically.
+ * While the initial guard bundle is loading, the optional `loading` subtree
+ * is rendered instead of `children`.
+ *
+ * **External mode** — pass a pre-configured `client` instance and the
+ * provider simply makes it available through context without managing its
+ * lifecycle.
+ *
+ * @example
+ * ```tsx
+ * // Managed mode
+ * <LiteguardProvider projectClientKeyId="pk_live_..." loading={<Spinner />}>
+ *   <App />
+ * </LiteguardProvider>
+ *
+ * // External mode
+ * const client = new LiteguardClient('pk_live_...');
+ * await client.start();
+ * <LiteguardProvider client={client}>
+ *   <App />
+ * </LiteguardProvider>
+ * ```
+ */
+declare function LiteguardProvider({ client, projectClientKeyId, options, properties, environment, fallback, refreshRateSeconds, flushRateSeconds, flushSize, backendUrl, quiet, httpTimeoutSeconds, flushBufferMultiplier, disableMeasurement, loading, children, }: LiteguardProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Return the nearest Liteguard client from React context, or `null` if no
+ * provider is present.
+ *
+ * Prefer {@link useLiteguardClient} when you need to assert that a client
+ * is available.
+ *
+ * @returns The {@link LiteguardClient}, or `null`.
+ */
+declare function useLiteguard(): LiteguardClient | null;
+/**
+ * Return the nearest Liteguard client from React context. Throws if no
+ * client is available — ensures the component is rendered inside a
+ * {@link LiteguardProvider}.
+ *
+ * @returns The {@link LiteguardClient}.
+ * @throws {Error} When no Liteguard client is reachable.
+ */
+declare function useLiteguardClient(): LiteguardClient;
+/**
+ * Returns `true` once the Liteguard client has fetched its initial guard
+ * bundle. Re-renders the component automatically when the ready state
+ * changes.
+ *
+ * @returns `true` when the client is ready, `false` otherwise.
+ */
+declare function useLiteguardReady(): boolean;
+/**
+ * Return `true` if the named guard is open for the current context.
+ * Re-renders automatically whenever the guard bundle is refreshed.
+ *
+ * Internally uses `peekIsOpen` so guard checks during renders do **not**
+ * emit telemetry signals or consume rate-limit slots. For guarded
+ * side-effects that need telemetry, call
+ * `useLiteguardClient().executeIfOpen()` in an event handler or effect.
+ *
+ * @param name - Guard name to evaluate (e.g. `"feature.beta"`).
+ * @param options - Optional per-call overrides (extra properties, fallback).
+ * @returns `true` if the guard is open, `false` otherwise.
+ *
+ * @example
+ * ```tsx
+ * function Banner() {
+ *   const showBeta = useIsOpen('promo.banner');
+ *   if (!showBeta) return null;
+ *   return <div>Try our new beta!</div>;
+ * }
+ * ```
+ */
+declare function useIsOpen(name: string, options?: Partial<Options>): boolean;
+
+export { LiteguardProvider, type LiteguardProviderProps, useIsOpen, useLiteguard, useLiteguardClient, useLiteguardReady };

package/dist/index.js

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LiteguardProvider: () => LiteguardProvider,
+  useIsOpen: () => useIsOpen,
+  useLiteguard: () => useLiteguard,
+  useLiteguardClient: () => useLiteguardClient,
+  useLiteguardReady: () => useLiteguardReady
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.tsx
+var import_react = require("react");
+var import_liteguard_browser = require("@liteguard/liteguard-browser");
+var import_jsx_runtime = require("react/jsx-runtime");
+var LiteguardContext = (0, import_react.createContext)(null);
+function subscribeNoop() {
+  return () => {
+  };
+}
+function useOptionalClient() {
+  return (0, import_react.useContext)(LiteguardContext);
+}
+function useClientValue(client, getSnapshot, fallback) {
+  return (0, import_react.useSyncExternalStore)(
+    client ? client.subscribe.bind(client) : subscribeNoop,
+    client ? getSnapshot : () => fallback,
+    () => fallback
+  );
+}
+function LiteguardProvider({
+  client,
+  projectClientKeyId,
+  options,
+  properties,
+  environment,
+  fallback,
+  refreshRateSeconds,
+  flushRateSeconds,
+  flushSize,
+  backendUrl,
+  quiet,
+  httpTimeoutSeconds,
+  flushBufferMultiplier,
+  disableMeasurement,
+  loading = null,
+  children
+}) {
+  const resolvedOptions = (0, import_react.useMemo)(
+    () => ({
+      ...options ?? {},
+      ...environment !== void 0 ? { environment } : {},
+      ...fallback !== void 0 ? { fallback } : {},
+      ...refreshRateSeconds !== void 0 ? { refreshRateSeconds } : {},
+      ...flushRateSeconds !== void 0 ? { flushRateSeconds } : {},
+      ...flushSize !== void 0 ? { flushSize } : {},
+      ...backendUrl !== void 0 ? { backendUrl } : {},
+      ...quiet !== void 0 ? { quiet } : {},
+      ...httpTimeoutSeconds !== void 0 ? { httpTimeoutSeconds } : {},
+      ...flushBufferMultiplier !== void 0 ? { flushBufferMultiplier } : {},
+      ...disableMeasurement !== void 0 ? { disableMeasurement } : {}
+    }),
+    [
+      options,
+      environment,
+      fallback,
+      refreshRateSeconds,
+      flushRateSeconds,
+      flushSize,
+      backendUrl,
+      quiet,
+      httpTimeoutSeconds,
+      flushBufferMultiplier,
+      disableMeasurement
+    ]
+  );
+  const optionsKey = (0, import_react.useMemo)(() => JSON.stringify(resolvedOptions), [resolvedOptions]);
+  const propertiesKey = (0, import_react.useMemo)(() => JSON.stringify(properties ?? {}), [properties]);
+  const [managedClient, setManagedClient] = (0, import_react.useState)(() => client ?? null);
+  const [error, setError] = (0, import_react.useState)(null);
+  (0, import_react.useEffect)(() => {
+    if (client) {
+      setManagedClient(client);
+      return;
+    }
+    if (!projectClientKeyId) {
+      setManagedClient(null);
+      return;
+    }
+    let cancelled = false;
+    const nextClient = new import_liteguard_browser.LiteguardClient(projectClientKeyId, resolvedOptions);
+    setManagedClient(nextClient);
+    setError(null);
+    const unsubscribe = nextClient.subscribe(() => {
+      if (!cancelled) {
+        setManagedClient(nextClient);
+      }
+    });
+    void nextClient.start().catch((startError) => {
+      if (!cancelled) {
+        setError(startError);
+      }
+    });
+    return () => {
+      cancelled = true;
+      unsubscribe();
+      void nextClient.shutdown();
+    };
+  }, [client, projectClientKeyId, optionsKey, resolvedOptions]);
+  const activeClient = client ?? managedClient;
+  const ready = useClientValue(activeClient, () => activeClient?.isReady() ?? false, false);
+  (0, import_react.useEffect)(() => {
+    if (!activeClient) {
+      return;
+    }
+    activeClient.resetProperties();
+    if (properties && Object.keys(properties).length > 0) {
+      activeClient.addProperties(properties);
+    }
+  }, [activeClient, propertiesKey, properties]);
+  if (error) {
+    throw error;
+  }
+  if (projectClientKeyId && !ready) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: loading });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(LiteguardContext.Provider, { value: activeClient, children });
+}
+function useLiteguard() {
+  return useOptionalClient();
+}
+function useLiteguardClient() {
+  const client = useOptionalClient();
+  if (!client) {
+    throw new Error(
+      "[liteguard] No Liteguard React client available. Wrap your app in LiteguardProvider."
+    );
+  }
+  return client;
+}
+function useLiteguardReady() {
+  const client = useOptionalClient();
+  return useClientValue(client, () => client?.isReady() ?? false, false);
+}
+function useIsOpen(name, options) {
+  const client = useOptionalClient();
+  const fallback = options?.fallback ?? false;
+  return useClientValue(client, () => client?.peekIsOpen(name, options) ?? fallback, fallback);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LiteguardProvider,
+  useIsOpen,
+  useLiteguard,
+  useLiteguardClient,
+  useLiteguardReady
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx"],"sourcesContent":["export {\n  LiteguardProvider,\n  useIsOpen,\n  useLiteguard,\n  useLiteguardClient,\n  useLiteguardReady,\n} from './provider.js';\nexport type { LiteguardProviderProps } from './provider.js';\n","import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\nimport { LiteguardClient } from '@liteguard/liteguard-browser';\nimport type { ClientOptions, Options, Properties } from '@liteguard/liteguard-browser';\n\nconst LiteguardContext = createContext<LiteguardClient | null>(null);\n\n/** Props for {@link LiteguardProvider}. */\nexport type LiteguardProviderProps = {\n  /**\n   * An externally created {@link LiteguardClient} instance. When provided,\n   * the provider uses this client directly and does **not** manage its\n   * lifecycle (you are responsible for calling `start()` / `shutdown()`).\n   */\n  client?: LiteguardClient;\n  /**\n   * Your project client key ID. When provided (without `client`), the\n   * provider automatically creates, starts, and shuts down a managed client.\n   */\n  projectClientKeyId?: string;\n  /** Optional SDK configuration overrides for the managed client. */\n  options?: ClientOptions;\n  /** Optional default properties applied to the active client scope. */\n  properties?: Properties;\n  environment?: ClientOptions['environment'];\n  fallback?: ClientOptions['fallback'];\n  refreshRateSeconds?: ClientOptions['refreshRateSeconds'];\n  flushRateSeconds?: ClientOptions['flushRateSeconds'];\n  flushSize?: ClientOptions['flushSize'];\n  backendUrl?: ClientOptions['backendUrl'];\n  quiet?: ClientOptions['quiet'];\n  httpTimeoutSeconds?: ClientOptions['httpTimeoutSeconds'];\n  flushBufferMultiplier?: ClientOptions['flushBufferMultiplier'];\n  disableMeasurement?: ClientOptions['disableMeasurement'];\n  /**\n   * React node rendered while the managed client is fetching its initial\n   * guard bundle. Defaults to `null` (render nothing).\n   */\n  loading?: ReactNode;\n  /** Application subtree that gains access to the Liteguard client via context. */\n  children: ReactNode;\n};\n\n/** Provide a stable no-op subscription for components rendered without a client. */\nfunction subscribeNoop(): () => void {\n  return () => {};\n}\n\n/** Resolve the nearest Liteguard client from React context. */\nfunction useOptionalClient(): LiteguardClient | null {\n  return useContext(LiteguardContext);\n}\n\n/** Subscribe a component to client refreshes and fall back cleanly when absent. */\nfunction useClientValue<T>(client: LiteguardClient | null, getSnapshot: () => T, fallback: T): T {\n  return useSyncExternalStore(\n    client ? client.subscribe.bind(client) : subscribeNoop,\n    client ? getSnapshot : () => fallback,\n    () => fallback,\n  );\n}\n\n/**\n * React context provider that makes a Liteguard client available to the\n * component tree via React context.\n *\n * **Managed mode** — pass `projectClientKeyId` (and optional `options`) to\n * have the provider create, start, and shut down a client automatically.\n * While the initial guard bundle is loading, the optional `loading` subtree\n * is rendered instead of `children`.\n *\n * **External mode** — pass a pre-configured `client` instance and the\n * provider simply makes it available through context without managing its\n * lifecycle.\n *\n * @example\n * ```tsx\n * // Managed mode\n * <LiteguardProvider projectClientKeyId=\"pk_live_...\" loading={<Spinner />}>\n *   <App />\n * </LiteguardProvider>\n *\n * // External mode\n * const client = new LiteguardClient('pk_live_...');\n * await client.start();\n * <LiteguardProvider client={client}>\n *   <App />\n * </LiteguardProvider>\n * ```\n */\nexport function LiteguardProvider({\n  client,\n  projectClientKeyId,\n  options,\n  properties,\n  environment,\n  fallback,\n  refreshRateSeconds,\n  flushRateSeconds,\n  flushSize,\n  backendUrl,\n  quiet,\n  httpTimeoutSeconds,\n  flushBufferMultiplier,\n  disableMeasurement,\n  loading = null,\n  children,\n}: LiteguardProviderProps) {\n  const resolvedOptions = useMemo<ClientOptions>(\n    () => ({\n      ...(options ?? {}),\n      ...(environment !== undefined ? { environment } : {}),\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(refreshRateSeconds !== undefined ? { refreshRateSeconds } : {}),\n      ...(flushRateSeconds !== undefined ? { flushRateSeconds } : {}),\n      ...(flushSize !== undefined ? { flushSize } : {}),\n      ...(backendUrl !== undefined ? { backendUrl } : {}),\n      ...(quiet !== undefined ? { quiet } : {}),\n      ...(httpTimeoutSeconds !== undefined ? { httpTimeoutSeconds } : {}),\n      ...(flushBufferMultiplier !== undefined ? { flushBufferMultiplier } : {}),\n      ...(disableMeasurement !== undefined ? { disableMeasurement } : {}),\n    }),\n    [\n      options,\n      environment,\n      fallback,\n      refreshRateSeconds,\n      flushRateSeconds,\n      flushSize,\n      backendUrl,\n      quiet,\n      httpTimeoutSeconds,\n      flushBufferMultiplier,\n      disableMeasurement,\n    ],\n  );\n  const optionsKey = useMemo(() => JSON.stringify(resolvedOptions), [resolvedOptions]);\n  const propertiesKey = useMemo(() => JSON.stringify(properties ?? {}), [properties]);\n  const [managedClient, setManagedClient] = useState<LiteguardClient | null>(() => client ?? null);\n  const [error, setError] = useState<unknown>(null);\n\n  useEffect(() => {\n    if (client) {\n      setManagedClient(client);\n      return;\n    }\n\n    if (!projectClientKeyId) {\n      setManagedClient(null);\n      return;\n    }\n\n    let cancelled = false;\n    const nextClient = new LiteguardClient(projectClientKeyId, resolvedOptions);\n    setManagedClient(nextClient);\n    setError(null);\n\n    const unsubscribe = nextClient.subscribe(() => {\n      if (!cancelled) {\n        setManagedClient(nextClient);\n      }\n    });\n\n    void nextClient.start().catch((startError) => {\n      if (!cancelled) {\n        setError(startError);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n      unsubscribe();\n      void nextClient.shutdown();\n    };\n  }, [client, projectClientKeyId, optionsKey, resolvedOptions]);\n\n  const activeClient = client ?? managedClient;\n  const ready = useClientValue(activeClient, () => activeClient?.isReady() ?? false, false);\n\n  useEffect(() => {\n    if (!activeClient) {\n      return;\n    }\n\n    activeClient.resetProperties();\n    if (properties && Object.keys(properties).length > 0) {\n      activeClient.addProperties(properties);\n    }\n  }, [activeClient, propertiesKey, properties]);\n\n  if (error) {\n    throw error;\n  }\n  if (projectClientKeyId && !ready) {\n    return <>{loading}</>;\n  }\n\n  return <LiteguardContext.Provider value={activeClient}>{children}</LiteguardContext.Provider>;\n}\n\n/**\n * Return the nearest Liteguard client from React context, or `null` if no\n * provider is present.\n *\n * Prefer {@link useLiteguardClient} when you need to assert that a client\n * is available.\n *\n * @returns The {@link LiteguardClient}, or `null`.\n */\nexport function useLiteguard(): LiteguardClient | null {\n  return useOptionalClient();\n}\n\n/**\n * Return the nearest Liteguard client from React context. Throws if no\n * client is available — ensures the component is rendered inside a\n * {@link LiteguardProvider}.\n *\n * @returns The {@link LiteguardClient}.\n * @throws {Error} When no Liteguard client is reachable.\n */\nexport function useLiteguardClient(): LiteguardClient {\n  const client = useOptionalClient();\n  if (!client) {\n    throw new Error(\n      '[liteguard] No Liteguard React client available. Wrap your app in LiteguardProvider.',\n    );\n  }\n  return client;\n}\n\n/**\n * Returns `true` once the Liteguard client has fetched its initial guard\n * bundle. Re-renders the component automatically when the ready state\n * changes.\n *\n * @returns `true` when the client is ready, `false` otherwise.\n */\nexport function useLiteguardReady(): boolean {\n  const client = useOptionalClient();\n  return useClientValue(client, () => client?.isReady() ?? false, false);\n}\n\n/**\n * Return `true` if the named guard is open for the current context.\n * Re-renders automatically whenever the guard bundle is refreshed.\n *\n * Internally uses `peekIsOpen` so guard checks during renders do **not**\n * emit telemetry signals or consume rate-limit slots. For guarded\n * side-effects that need telemetry, call\n * `useLiteguardClient().executeIfOpen()` in an event handler or effect.\n *\n * @param name - Guard name to evaluate (e.g. `\"feature.beta\"`).\n * @param options - Optional per-call overrides (extra properties, fallback).\n * @returns `true` if the guard is open, `false` otherwise.\n *\n * @example\n * ```tsx\n * function Banner() {\n *   const showBeta = useIsOpen('promo.banner');\n *   if (!showBeta) return null;\n *   return <div>Try our new beta!</div>;\n * }\n * ```\n */\nexport function useIsOpen(name: string, options?: Partial<Options>): boolean {\n  const client = useOptionalClient();\n  const fallback = options?.fallback ?? false;\n  return useClientValue(client, () => client?.peekIsOpen(name, options) ?? fallback, fallback);\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,153 @@
+// src/provider.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useMemo,
+  useState,
+  useSyncExternalStore
+} from "react";
+import { LiteguardClient } from "@liteguard/liteguard-browser";
+import { Fragment, jsx } from "react/jsx-runtime";
+var LiteguardContext = createContext(null);
+function subscribeNoop() {
+  return () => {
+  };
+}
+function useOptionalClient() {
+  return useContext(LiteguardContext);
+}
+function useClientValue(client, getSnapshot, fallback) {
+  return useSyncExternalStore(
+    client ? client.subscribe.bind(client) : subscribeNoop,
+    client ? getSnapshot : () => fallback,
+    () => fallback
+  );
+}
+function LiteguardProvider({
+  client,
+  projectClientKeyId,
+  options,
+  properties,
+  environment,
+  fallback,
+  refreshRateSeconds,
+  flushRateSeconds,
+  flushSize,
+  backendUrl,
+  quiet,
+  httpTimeoutSeconds,
+  flushBufferMultiplier,
+  disableMeasurement,
+  loading = null,
+  children
+}) {
+  const resolvedOptions = useMemo(
+    () => ({
+      ...options ?? {},
+      ...environment !== void 0 ? { environment } : {},
+      ...fallback !== void 0 ? { fallback } : {},
+      ...refreshRateSeconds !== void 0 ? { refreshRateSeconds } : {},
+      ...flushRateSeconds !== void 0 ? { flushRateSeconds } : {},
+      ...flushSize !== void 0 ? { flushSize } : {},
+      ...backendUrl !== void 0 ? { backendUrl } : {},
+      ...quiet !== void 0 ? { quiet } : {},
+      ...httpTimeoutSeconds !== void 0 ? { httpTimeoutSeconds } : {},
+      ...flushBufferMultiplier !== void 0 ? { flushBufferMultiplier } : {},
+      ...disableMeasurement !== void 0 ? { disableMeasurement } : {}
+    }),
+    [
+      options,
+      environment,
+      fallback,
+      refreshRateSeconds,
+      flushRateSeconds,
+      flushSize,
+      backendUrl,
+      quiet,
+      httpTimeoutSeconds,
+      flushBufferMultiplier,
+      disableMeasurement
+    ]
+  );
+  const optionsKey = useMemo(() => JSON.stringify(resolvedOptions), [resolvedOptions]);
+  const propertiesKey = useMemo(() => JSON.stringify(properties ?? {}), [properties]);
+  const [managedClient, setManagedClient] = useState(() => client ?? null);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (client) {
+      setManagedClient(client);
+      return;
+    }
+    if (!projectClientKeyId) {
+      setManagedClient(null);
+      return;
+    }
+    let cancelled = false;
+    const nextClient = new LiteguardClient(projectClientKeyId, resolvedOptions);
+    setManagedClient(nextClient);
+    setError(null);
+    const unsubscribe = nextClient.subscribe(() => {
+      if (!cancelled) {
+        setManagedClient(nextClient);
+      }
+    });
+    void nextClient.start().catch((startError) => {
+      if (!cancelled) {
+        setError(startError);
+      }
+    });
+    return () => {
+      cancelled = true;
+      unsubscribe();
+      void nextClient.shutdown();
+    };
+  }, [client, projectClientKeyId, optionsKey, resolvedOptions]);
+  const activeClient = client ?? managedClient;
+  const ready = useClientValue(activeClient, () => activeClient?.isReady() ?? false, false);
+  useEffect(() => {
+    if (!activeClient) {
+      return;
+    }
+    activeClient.resetProperties();
+    if (properties && Object.keys(properties).length > 0) {
+      activeClient.addProperties(properties);
+    }
+  }, [activeClient, propertiesKey, properties]);
+  if (error) {
+    throw error;
+  }
+  if (projectClientKeyId && !ready) {
+    return /* @__PURE__ */ jsx(Fragment, { children: loading });
+  }
+  return /* @__PURE__ */ jsx(LiteguardContext.Provider, { value: activeClient, children });
+}
+function useLiteguard() {
+  return useOptionalClient();
+}
+function useLiteguardClient() {
+  const client = useOptionalClient();
+  if (!client) {
+    throw new Error(
+      "[liteguard] No Liteguard React client available. Wrap your app in LiteguardProvider."
+    );
+  }
+  return client;
+}
+function useLiteguardReady() {
+  const client = useOptionalClient();
+  return useClientValue(client, () => client?.isReady() ?? false, false);
+}
+function useIsOpen(name, options) {
+  const client = useOptionalClient();
+  const fallback = options?.fallback ?? false;
+  return useClientValue(client, () => client?.peekIsOpen(name, options) ?? fallback, fallback);
+}
+export {
+  LiteguardProvider,
+  useIsOpen,
+  useLiteguard,
+  useLiteguardClient,
+  useLiteguardReady
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\nimport { LiteguardClient } from '@liteguard/liteguard-browser';\nimport type { ClientOptions, Options, Properties } from '@liteguard/liteguard-browser';\n\nconst LiteguardContext = createContext<LiteguardClient | null>(null);\n\n/** Props for {@link LiteguardProvider}. */\nexport type LiteguardProviderProps = {\n  /**\n   * An externally created {@link LiteguardClient} instance. When provided,\n   * the provider uses this client directly and does **not** manage its\n   * lifecycle (you are responsible for calling `start()` / `shutdown()`).\n   */\n  client?: LiteguardClient;\n  /**\n   * Your project client key ID. When provided (without `client`), the\n   * provider automatically creates, starts, and shuts down a managed client.\n   */\n  projectClientKeyId?: string;\n  /** Optional SDK configuration overrides for the managed client. */\n  options?: ClientOptions;\n  /** Optional default properties applied to the active client scope. */\n  properties?: Properties;\n  environment?: ClientOptions['environment'];\n  fallback?: ClientOptions['fallback'];\n  refreshRateSeconds?: ClientOptions['refreshRateSeconds'];\n  flushRateSeconds?: ClientOptions['flushRateSeconds'];\n  flushSize?: ClientOptions['flushSize'];\n  backendUrl?: ClientOptions['backendUrl'];\n  quiet?: ClientOptions['quiet'];\n  httpTimeoutSeconds?: ClientOptions['httpTimeoutSeconds'];\n  flushBufferMultiplier?: ClientOptions['flushBufferMultiplier'];\n  disableMeasurement?: ClientOptions['disableMeasurement'];\n  /**\n   * React node rendered while the managed client is fetching its initial\n   * guard bundle. Defaults to `null` (render nothing).\n   */\n  loading?: ReactNode;\n  /** Application subtree that gains access to the Liteguard client via context. */\n  children: ReactNode;\n};\n\n/** Provide a stable no-op subscription for components rendered without a client. */\nfunction subscribeNoop(): () => void {\n  return () => {};\n}\n\n/** Resolve the nearest Liteguard client from React context. */\nfunction useOptionalClient(): LiteguardClient | null {\n  return useContext(LiteguardContext);\n}\n\n/** Subscribe a component to client refreshes and fall back cleanly when absent. */\nfunction useClientValue<T>(client: LiteguardClient | null, getSnapshot: () => T, fallback: T): T {\n  return useSyncExternalStore(\n    client ? client.subscribe.bind(client) : subscribeNoop,\n    client ? getSnapshot : () => fallback,\n    () => fallback,\n  );\n}\n\n/**\n * React context provider that makes a Liteguard client available to the\n * component tree via React context.\n *\n * **Managed mode** — pass `projectClientKeyId` (and optional `options`) to\n * have the provider create, start, and shut down a client automatically.\n * While the initial guard bundle is loading, the optional `loading` subtree\n * is rendered instead of `children`.\n *\n * **External mode** — pass a pre-configured `client` instance and the\n * provider simply makes it available through context without managing its\n * lifecycle.\n *\n * @example\n * ```tsx\n * // Managed mode\n * <LiteguardProvider projectClientKeyId=\"pk_live_...\" loading={<Spinner />}>\n *   <App />\n * </LiteguardProvider>\n *\n * // External mode\n * const client = new LiteguardClient('pk_live_...');\n * await client.start();\n * <LiteguardProvider client={client}>\n *   <App />\n * </LiteguardProvider>\n * ```\n */\nexport function LiteguardProvider({\n  client,\n  projectClientKeyId,\n  options,\n  properties,\n  environment,\n  fallback,\n  refreshRateSeconds,\n  flushRateSeconds,\n  flushSize,\n  backendUrl,\n  quiet,\n  httpTimeoutSeconds,\n  flushBufferMultiplier,\n  disableMeasurement,\n  loading = null,\n  children,\n}: LiteguardProviderProps) {\n  const resolvedOptions = useMemo<ClientOptions>(\n    () => ({\n      ...(options ?? {}),\n      ...(environment !== undefined ? { environment } : {}),\n      ...(fallback !== undefined ? { fallback } : {}),\n      ...(refreshRateSeconds !== undefined ? { refreshRateSeconds } : {}),\n      ...(flushRateSeconds !== undefined ? { flushRateSeconds } : {}),\n      ...(flushSize !== undefined ? { flushSize } : {}),\n      ...(backendUrl !== undefined ? { backendUrl } : {}),\n      ...(quiet !== undefined ? { quiet } : {}),\n      ...(httpTimeoutSeconds !== undefined ? { httpTimeoutSeconds } : {}),\n      ...(flushBufferMultiplier !== undefined ? { flushBufferMultiplier } : {}),\n      ...(disableMeasurement !== undefined ? { disableMeasurement } : {}),\n    }),\n    [\n      options,\n      environment,\n      fallback,\n      refreshRateSeconds,\n      flushRateSeconds,\n      flushSize,\n      backendUrl,\n      quiet,\n      httpTimeoutSeconds,\n      flushBufferMultiplier,\n      disableMeasurement,\n    ],\n  );\n  const optionsKey = useMemo(() => JSON.stringify(resolvedOptions), [resolvedOptions]);\n  const propertiesKey = useMemo(() => JSON.stringify(properties ?? {}), [properties]);\n  const [managedClient, setManagedClient] = useState<LiteguardClient | null>(() => client ?? null);\n  const [error, setError] = useState<unknown>(null);\n\n  useEffect(() => {\n    if (client) {\n      setManagedClient(client);\n      return;\n    }\n\n    if (!projectClientKeyId) {\n      setManagedClient(null);\n      return;\n    }\n\n    let cancelled = false;\n    const nextClient = new LiteguardClient(projectClientKeyId, resolvedOptions);\n    setManagedClient(nextClient);\n    setError(null);\n\n    const unsubscribe = nextClient.subscribe(() => {\n      if (!cancelled) {\n        setManagedClient(nextClient);\n      }\n    });\n\n    void nextClient.start().catch((startError) => {\n      if (!cancelled) {\n        setError(startError);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n      unsubscribe();\n      void nextClient.shutdown();\n    };\n  }, [client, projectClientKeyId, optionsKey, resolvedOptions]);\n\n  const activeClient = client ?? managedClient;\n  const ready = useClientValue(activeClient, () => activeClient?.isReady() ?? false, false);\n\n  useEffect(() => {\n    if (!activeClient) {\n      return;\n    }\n\n    activeClient.resetProperties();\n    if (properties && Object.keys(properties).length > 0) {\n      activeClient.addProperties(properties);\n    }\n  }, [activeClient, propertiesKey, properties]);\n\n  if (error) {\n    throw error;\n  }\n  if (projectClientKeyId && !ready) {\n    return <>{loading}</>;\n  }\n\n  return <LiteguardContext.Provider value={activeClient}>{children}</LiteguardContext.Provider>;\n}\n\n/**\n * Return the nearest Liteguard client from React context, or `null` if no\n * provider is present.\n *\n * Prefer {@link useLiteguardClient} when you need to assert that a client\n * is available.\n *\n * @returns The {@link LiteguardClient}, or `null`.\n */\nexport function useLiteguard(): LiteguardClient | null {\n  return useOptionalClient();\n}\n\n/**\n * Return the nearest Liteguard client from React context. Throws if no\n * client is available — ensures the component is rendered inside a\n * {@link LiteguardProvider}.\n *\n * @returns The {@link LiteguardClient}.\n * @throws {Error} When no Liteguard client is reachable.\n */\nexport function useLiteguardClient(): LiteguardClient {\n  const client = useOptionalClient();\n  if (!client) {\n    throw new Error(\n      '[liteguard] No Liteguard React client available. Wrap your app in LiteguardProvider.',\n    );\n  }\n  return client;\n}\n\n/**\n * Returns `true` once the Liteguard client has fetched its initial guard\n * bundle. Re-renders the component automatically when the ready state\n * changes.\n *\n * @returns `true` when the client is ready, `false` otherwise.\n */\nexport function useLiteguardReady(): boolean {\n  const client = useOptionalClient();\n  return useClientValue(client, () => client?.isReady() ?? false, false);\n}\n\n/**\n * Return `true` if the named guard is open for the current context.\n * Re-renders automatically whenever the guard bundle is refreshed.\n *\n * Internally uses `peekIsOpen` so guard checks during renders do **not**\n * emit telemetry signals or consume rate-limit slots. For guarded\n * side-effects that need telemetry, call\n * `useLiteguardClient().executeIfOpen()` in an event handler or effect.\n *\n * @param name - Guard name to evaluate (e.g. `\"feature.beta\"`).\n * @param options - Optional per-call overrides (extra properties, fallback).\n * @returns `true` if the guard is open, `false` otherwise.\n *\n * @example\n * ```tsx\n * function Banner() {\n *   const showBeta = useIsOpen('promo.banner');\n *   if (!showBeta) return null;\n *   return <div>Try our new beta!</div>;\n * }\n * ```\n */\nexport function useIsOpen(name: string, options?: Partial<Options>): boolean {\n  const client = useOptionalClient();\n  const fallback = options?.fallback ?? false;\n  return useClientValue(client, () => client?.peekIsOpen(name, options) ?? fallback, fallback);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@liteguard/liteguard-react",
+    "version": "0.2.20260314",
+    "description": "React bindings for Liteguard — feature guards, observability, and CVE auto-disable via LiteguardProvider and useIsOpen hook",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "license": "Apache-2.0",
+    "homepage": "https://liteguard.io",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/liteguard/liteguard.git",
+        "directory": "sdk/js/packages/liteguard-react"
+    },
+    "keywords": [
+        "feature-flags",
+        "feature-guards",
+        "feature-toggles",
+        "liteguard",
+        "react",
+        "observability",
+        "security"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "sideEffects": false,
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts --sourcemap --clean"
+    },
+    "dependencies": {
+        "@liteguard/liteguard-browser": "*"
+    },
+    "peerDependencies": {
+        "react": ">=18",
+        "react-dom": ">=18"
+    }
+}