@dr-sentry/react 1.0.0

package/dist/esm/hooks.d.ts

@@ -0,0 +1,86 @@
+import type { DeploySentryClient } from './client';
+import type { Flag, FlagCategory, FlagDetail } from './types';
+/**
+ * Return the raw {@link DeploySentryClient} instance.
+ *
+ * Useful for advanced use-cases such as manual re-identification or
+ * subscribing to change events outside of React's lifecycle.
+ *
+ * @throws If called outside of a `<DeploySentryProvider>`.
+ */
+export declare function useDeploySentry(): DeploySentryClient;
+/**
+ * Evaluate a feature flag and return its resolved value.
+ *
+ * The component re-renders whenever the flag value changes (via SSE).
+ *
+ * @param key          - The unique flag key.
+ * @param defaultValue - Value returned while the flag is loading or if the
+ *                       key does not exist.
+ * @returns The resolved flag value, or `defaultValue`.
+ *
+ * @example
+ * ```tsx
+ * const showBanner = useFlag('show-banner', false);
+ * ```
+ */
+export declare function useFlag<T = unknown>(key: string, defaultValue: T): T;
+/**
+ * Return detailed evaluation information for a single flag.
+ *
+ * Includes the resolved value, enabled state, full metadata, and a
+ * `loading` indicator that is `true` until the initial fetch completes.
+ *
+ * @param key - The unique flag key.
+ *
+ * @example
+ * ```tsx
+ * const { value, enabled, metadata, loading } = useFlagDetail('new-checkout');
+ * ```
+ */
+export declare function useFlagDetail<T = unknown>(key: string): FlagDetail<T>;
+/**
+ * Return all flags that belong to the given category.
+ *
+ * The result is referentially stable across renders as long as the
+ * underlying flag data has not changed.
+ *
+ * @param category - One of the predefined {@link FlagCategory} values.
+ *
+ * @example
+ * ```tsx
+ * const experiments = useFlagsByCategory('experiment');
+ * ```
+ */
+export declare function useFlagsByCategory(category: FlagCategory): Flag[];
+/**
+ * Return the dispatch function for the given operation name.
+ *
+ * Reads the client from context and calls {@link DeploySentryClient.dispatch},
+ * which selects the appropriate handler based on currently enabled flags.
+ *
+ * @param operation - The name of the registered operation.
+ * @returns The resolved handler function.
+ *
+ * @throws If no handlers are registered for the operation.
+ *
+ * @example
+ * ```tsx
+ * const checkout = useDispatch<() => void>('checkout');
+ * checkout();
+ * ```
+ */
+export declare function useDispatch<T extends (...args: any[]) => any>(operation: string): T;
+/**
+ * Return all non-permanent flags whose `expiresAt` date is in the past.
+ *
+ * This is useful for building admin dashboards that surface stale flags
+ * that should be cleaned up.
+ *
+ * @example
+ * ```tsx
+ * const expired = useExpiredFlags();
+ * ```
+ */
+export declare function useExpiredFlags(): Flag[];
+//# sourceMappingURL=hooks.d.ts.map

package/dist/esm/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAqD5E;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CAEpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAQpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CA+BrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,CAQjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAGnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,IAAI,EAAE,CAWxC"}

package/dist/esm/hooks.js

@@ -0,0 +1,178 @@
+import { useCallback, useContext, useMemo, useSyncExternalStore } from 'react';
+import { DeploySentryContext } from './context';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const EMPTY_FLAGS = [];
+const DEFAULT_METADATA = {
+    category: 'feature',
+    purpose: '',
+    owners: [],
+    isPermanent: false,
+    expiresAt: undefined,
+    tags: [],
+};
+function useClient() {
+    const client = useContext(DeploySentryContext);
+    if (!client) {
+        throw new Error('DeploySentry hooks must be used within a <DeploySentryProvider>. ' +
+            'Wrap your component tree with the provider before calling any hook.');
+    }
+    return client;
+}
+/**
+ * Subscribe to the client's flag store via `useSyncExternalStore`.
+ *
+ * Every flag-change notification from the client (initial fetch or SSE
+ * update) will trigger a synchronous re-render of any component that
+ * consumes this hook.
+ */
+function useFlagSnapshot(client) {
+    const subscribe = useCallback((onStoreChange) => client.subscribe(onStoreChange), [client]);
+    const getSnapshot = useCallback(() => client.getAllFlags(), [client]);
+    // For SSR, return an empty array. Flags are fetched client-side.
+    const getServerSnapshot = useCallback(() => EMPTY_FLAGS, []);
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+// ---------------------------------------------------------------------------
+// Public hooks
+// ---------------------------------------------------------------------------
+/**
+ * Return the raw {@link DeploySentryClient} instance.
+ *
+ * Useful for advanced use-cases such as manual re-identification or
+ * subscribing to change events outside of React's lifecycle.
+ *
+ * @throws If called outside of a `<DeploySentryProvider>`.
+ */
+export function useDeploySentry() {
+    return useClient();
+}
+/**
+ * Evaluate a feature flag and return its resolved value.
+ *
+ * The component re-renders whenever the flag value changes (via SSE).
+ *
+ * @param key          - The unique flag key.
+ * @param defaultValue - Value returned while the flag is loading or if the
+ *                       key does not exist.
+ * @returns The resolved flag value, or `defaultValue`.
+ *
+ * @example
+ * ```tsx
+ * const showBanner = useFlag('show-banner', false);
+ * ```
+ */
+export function useFlag(key, defaultValue) {
+    const client = useClient();
+    // Subscribe to the store so we re-render on updates.
+    useFlagSnapshot(client);
+    const flag = client.getFlag(key);
+    if (!flag)
+        return defaultValue;
+    return (flag.enabled ? flag.value : defaultValue);
+}
+/**
+ * Return detailed evaluation information for a single flag.
+ *
+ * Includes the resolved value, enabled state, full metadata, and a
+ * `loading` indicator that is `true` until the initial fetch completes.
+ *
+ * @param key - The unique flag key.
+ *
+ * @example
+ * ```tsx
+ * const { value, enabled, metadata, loading } = useFlagDetail('new-checkout');
+ * ```
+ */
+export function useFlagDetail(key) {
+    const client = useClient();
+    useFlagSnapshot(client);
+    const flag = client.getFlag(key);
+    const loading = !client.isInitialised;
+    if (!flag) {
+        return {
+            value: undefined,
+            enabled: false,
+            metadata: DEFAULT_METADATA,
+            loading,
+        };
+    }
+    const metadata = {
+        category: flag.category,
+        purpose: flag.purpose,
+        owners: flag.owners,
+        isPermanent: flag.isPermanent,
+        expiresAt: flag.expiresAt,
+        tags: flag.tags,
+    };
+    return {
+        value: flag.value,
+        enabled: flag.enabled,
+        metadata,
+        loading,
+    };
+}
+/**
+ * Return all flags that belong to the given category.
+ *
+ * The result is referentially stable across renders as long as the
+ * underlying flag data has not changed.
+ *
+ * @param category - One of the predefined {@link FlagCategory} values.
+ *
+ * @example
+ * ```tsx
+ * const experiments = useFlagsByCategory('experiment');
+ * ```
+ */
+export function useFlagsByCategory(category) {
+    const client = useClient();
+    const allFlags = useFlagSnapshot(client);
+    return useMemo(() => allFlags.filter((f) => f.category === category), [allFlags, category]);
+}
+/**
+ * Return the dispatch function for the given operation name.
+ *
+ * Reads the client from context and calls {@link DeploySentryClient.dispatch},
+ * which selects the appropriate handler based on currently enabled flags.
+ *
+ * @param operation - The name of the registered operation.
+ * @returns The resolved handler function.
+ *
+ * @throws If no handlers are registered for the operation.
+ *
+ * @example
+ * ```tsx
+ * const checkout = useDispatch<() => void>('checkout');
+ * checkout();
+ * ```
+ */
+export function useDispatch(operation) {
+    const client = useDeploySentry();
+    return client.dispatch(operation);
+}
+/**
+ * Return all non-permanent flags whose `expiresAt` date is in the past.
+ *
+ * This is useful for building admin dashboards that surface stale flags
+ * that should be cleaned up.
+ *
+ * @example
+ * ```tsx
+ * const expired = useExpiredFlags();
+ * ```
+ */
+export function useExpiredFlags() {
+    const client = useClient();
+    const allFlags = useFlagSnapshot(client);
+    return useMemo(() => {
+        const now = Date.now();
+        return allFlags.filter((f) => {
+            if (f.isPermanent || !f.expiresAt)
+                return false;
+            return new Date(f.expiresAt).getTime() <= now;
+        });
+    }, [allFlags]);
+}
+//# 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.d.ts

@@ -0,0 +1,7 @@
+export { DeploySentryContext } from './context';
+export { DeploySentryProvider } from './provider';
+export { useDeploySentry, useDispatch, useExpiredFlags, useFlag, useFlagDetail, useFlagsByCategory, } from './hooks';
+export { DeploySentryClient } from './client';
+export { evaluateLocal } from './local-evaluator';
+export type { ApiFlagResponse, EvaluationContext, Flag, FlagCategory, FlagConfig, FlagConfigEnvironment, FlagConfigFlag, FlagConfigRule, FlagDetail, FlagMetadata, ProviderProps, Registration, SSEFlagUpdate, UserContext, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,OAAO,EACP,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,10 @@
+// Context & Provider
+export { DeploySentryContext } from './context';
+export { DeploySentryProvider } from './provider';
+// Hooks
+export { useDeploySentry, useDispatch, useExpiredFlags, useFlag, useFlagDetail, useFlagsByCategory, } from './hooks';
+// Client (advanced usage)
+export { DeploySentryClient } from './client';
+// Local evaluation (file/flagData mode)
+export { evaluateLocal } from './local-evaluator';
+//# 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,qBAAqB;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,QAAQ;AACR,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,OAAO,EACP,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/local-evaluator.d.ts

@@ -0,0 +1,12 @@
+import type { EvaluationContext, FlagConfig } from './types';
+/**
+ * Evaluate a flag locally using pre-loaded config data.
+ *
+ * This mirrors the Node SDK's local evaluator so that file/flagData mode
+ * produces consistent results across SDKs.
+ */
+export declare function evaluateLocal(config: FlagConfig, environment: string, key: string, context?: EvaluationContext): {
+    value: string;
+    reason: string;
+};
+//# sourceMappingURL=local-evaluator.d.ts.map

package/dist/esm/local-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-evaluator.d.ts","sourceRoot":"","sources":["../../src/local-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAkB,MAAM,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgBnC"}

package/dist/esm/local-evaluator.js

@@ -0,0 +1,41 @@
+/**
+ * Evaluate a flag locally using pre-loaded config data.
+ *
+ * This mirrors the Node SDK's local evaluator so that file/flagData mode
+ * produces consistent results across SDKs.
+ */
+export function evaluateLocal(config, environment, key, context) {
+    const flag = config.flags.find((f) => f.key === key);
+    if (!flag)
+        return { value: '', reason: 'flag_not_found' };
+    const envState = flag.environments[environment];
+    if (!envState || !envState.enabled)
+        return { value: flag.default_value, reason: 'env_disabled' };
+    if (flag.rules && context) {
+        const sorted = [...flag.rules].sort((a, b) => a.priority - b.priority);
+        for (const rule of sorted) {
+            if (!rule.environments[environment])
+                continue;
+            if (matchRule(rule, context))
+                return { value: rule.value, reason: 'rule_match' };
+        }
+    }
+    return { value: envState.value || flag.default_value, reason: 'default' };
+}
+function matchRule(rule, context) {
+    const val = context.attributes?.[rule.attribute] ?? '';
+    const targets = rule.target_values ?? [];
+    switch (rule.operator) {
+        case 'equals': return targets.length > 0 && val === targets[0];
+        case 'not_equals': return targets.length > 0 && val !== targets[0];
+        case 'in': return targets.includes(val);
+        case 'not_in': return !targets.includes(val);
+        case 'contains': return targets.length > 0 && val.includes(targets[0]);
+        case 'starts_with': return targets.length > 0 && val.startsWith(targets[0]);
+        case 'ends_with': return targets.length > 0 && val.endsWith(targets[0]);
+        case 'greater_than': return targets.length > 0 && parseFloat(val) > parseFloat(targets[0]);
+        case 'less_than': return targets.length > 0 && parseFloat(val) < parseFloat(targets[0]);
+        default: return false;
+    }
+}
+//# sourceMappingURL=local-evaluator.js.map

package/dist/esm/local-evaluator.js.map

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

package/dist/esm/provider.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { ProviderProps } from './types';
+/**
+ * Provides the DeploySentry client to all descendant components.
+ *
+ * The provider creates a {@link DeploySentryClient} on mount, fetches the
+ * initial flag set, opens an SSE connection for real-time updates, and tears
+ * everything down on unmount.
+ *
+ * @example
+ * ```tsx
+ * <DeploySentryProvider
+ *   apiKey="ds_live_abc123"
+ *   baseURL="https://api.dr-sentry.com"
+ *   environment="production"
+ *   project="my-app"
+ *   user={{ id: 'user-42' }}
+ * >
+ *   <App />
+ * </DeploySentryProvider>
+ * ```
+ */
+export declare function DeploySentryProvider({ apiKey, baseURL, environment, project, application, user, sessionId, mode, flagData, children, }: ProviderProps): React.ReactElement;
+//# sourceMappingURL=provider.d.ts.map

package/dist/esm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAGpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,OAAO,EACP,WAAW,EACX,OAAO,EACP,WAAW,EACX,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAsFpC"}

package/dist/esm/provider.js

@@ -0,0 +1,94 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { DeploySentryClient } from './client';
+import { DeploySentryContext } from './context';
+/**
+ * Provides the DeploySentry client to all descendant components.
+ *
+ * The provider creates a {@link DeploySentryClient} on mount, fetches the
+ * initial flag set, opens an SSE connection for real-time updates, and tears
+ * everything down on unmount.
+ *
+ * @example
+ * ```tsx
+ * <DeploySentryProvider
+ *   apiKey="ds_live_abc123"
+ *   baseURL="https://api.dr-sentry.com"
+ *   environment="production"
+ *   project="my-app"
+ *   user={{ id: 'user-42' }}
+ * >
+ *   <App />
+ * </DeploySentryProvider>
+ * ```
+ */
+export function DeploySentryProvider({ apiKey, baseURL, environment, project, application, user, sessionId, mode, flagData, children, }) {
+    const [client, setClient] = useState(null);
+    const [, setError] = useState(null);
+    // Keep a ref so the effect cleanup always targets the right instance.
+    const clientRef = useRef(null);
+    // Memoise the configuration identity so we only recreate the client when
+    // the connection parameters change, not on every render.
+    const configKey = useMemo(() => JSON.stringify({ apiKey, baseURL, environment, project, application, sessionId, mode }), [apiKey, baseURL, environment, project, application, sessionId, mode]);
+    useEffect(() => {
+        const instance = new DeploySentryClient({
+            apiKey,
+            baseURL,
+            environment,
+            project,
+            application,
+            user,
+            sessionId,
+            mode,
+            flagConfig: flagData,
+        });
+        clientRef.current = instance;
+        instance
+            .init()
+            .then(() => {
+            // Guard against the effect having been cleaned up before init resolved.
+            if (clientRef.current === instance) {
+                setClient(instance);
+                setError(null);
+            }
+        })
+            .catch((err) => {
+            if (clientRef.current === instance) {
+                setError(err instanceof Error
+                    ? err
+                    : new Error(String(err)));
+                // Still expose the client so hooks can return defaults gracefully.
+                setClient(instance);
+            }
+        });
+        return () => {
+            clientRef.current = null;
+            instance.destroy();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [configKey]);
+    // When the user context changes (but connection params stay the same),
+    // re-identify on the existing client rather than tearing it down.
+    const userKey = useMemo(() => JSON.stringify(user), [user]);
+    useEffect(() => {
+        if (!client)
+            return;
+        // The initial identify already happened inside init(), so we skip the
+        // first call by comparing refs.
+        client.identify(user).catch(() => {
+            // Swallow identify errors. The client will keep the previous state.
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [userKey, client]);
+    // Delay rendering children until the client exists. Hooks like
+    // `useFlag` throw synchronously when the context value is null, which
+    // crashes the whole subtree on the first render — before `init()` has
+    // even had a chance to run. Gating children behind the client's
+    // readiness keeps the external API (a throwing hook that enforces
+    // provider presence) while preventing that race.
+    if (!client) {
+        return _jsx(DeploySentryContext.Provider, { value: null, children: null });
+    }
+    return (_jsx(DeploySentryContext.Provider, { value: client, children: children }));
+}
+//# sourceMappingURL=provider.js.map

package/dist/esm/provider.js.map

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

package/dist/esm/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * DeploySentry React SDK type definitions.
+ *
+ * Types are defined locally so the React SDK has zero runtime dependency on
+ * the Node SDK package. They mirror the canonical shapes from @deploysentry/sdk.
+ */
+/** Categories that classify the intent and lifecycle of a feature flag. */
+export type FlagCategory = 'release' | 'feature' | 'experiment' | 'ops' | 'permission';
+/** Rich metadata attached to every feature flag. */
+export interface FlagMetadata {
+    /** Categorisation that drives lifecycle policies. */
+    category: FlagCategory;
+    /** Human-readable explanation of what this flag controls. */
+    purpose: string;
+    /** Team or individual owners responsible for this flag. */
+    owners: string[];
+    /** When true the flag is not expected to be removed. */
+    isPermanent: boolean;
+    /** ISO-8601 expiration timestamp. Undefined for permanent flags. */
+    expiresAt?: string;
+    /** Free-form tags for filtering and grouping. */
+    tags: string[];
+}
+/** A feature flag as returned by the DeploySentry API. */
+export interface Flag {
+    /** Unique key used to reference the flag in code. */
+    key: string;
+    /** Display name of the flag. */
+    name: string;
+    /** Category classification. */
+    category: FlagCategory;
+    /** Human-readable explanation of what this flag controls. */
+    purpose: string;
+    /** Team or individual owners responsible for this flag. */
+    owners: string[];
+    /** When true the flag is not expected to be removed. */
+    isPermanent: boolean;
+    /** ISO-8601 expiration timestamp. Undefined for permanent flags. */
+    expiresAt?: string;
+    /** Whether the flag is currently enabled. */
+    enabled: boolean;
+    /** The resolved value (boolean, string, number, or JSON object). */
+    value: unknown;
+    /** Free-form tags for filtering and grouping. */
+    tags: string[];
+}
+/** Detailed evaluation result for a single flag. */
+export interface FlagDetail<T = unknown> {
+    /** The resolved value after evaluation. */
+    value: T;
+    /** Whether the flag is currently enabled. */
+    enabled: boolean;
+    /** Rich metadata for the flag. */
+    metadata: FlagMetadata;
+    /** True while the initial fetch is in progress. */
+    loading: boolean;
+}
+/** User context sent with evaluation requests. */
+export interface UserContext {
+    /** Unique user identifier. */
+    id: string;
+    /** Arbitrary attributes for targeting rules. */
+    attributes?: Record<string, string>;
+}
+/** Props accepted by {@link DeploySentryProvider}. */
+export interface ProviderProps {
+    /** API key for authenticating with the DeploySentry service. */
+    apiKey: string;
+    /** Base URL of the DeploySentry API. */
+    baseURL: string;
+    /** Environment identifier (e.g. "production", "staging"). */
+    environment: string;
+    /** Project identifier. */
+    project: string;
+    /** Application identifier. */
+    application: string;
+    /** Optional user context for targeting. */
+    user?: UserContext;
+    /** Optional session identifier for consistent flag evaluation across requests. */
+    sessionId?: string;
+    /** SDK mode: 'server' (default), 'file' (local only), or 'server-with-fallback'. */
+    mode?: 'server' | 'file' | 'server-with-fallback';
+    /** Pre-loaded flag configuration for file/fallback mode. */
+    flagData?: FlagConfig;
+    /** React children. */
+    children: React.ReactNode;
+}
+/**
+ * Internal API response shape for flag evaluation.
+ * This represents the raw JSON payload from the server.
+ */
+export interface ApiFlagResponse {
+    key: string;
+    name?: string;
+    enabled: boolean;
+    value: unknown;
+    metadata?: {
+        category?: FlagCategory;
+        purpose?: string;
+        owners?: string[];
+        isPermanent?: boolean;
+        expiresAt?: string;
+        tags?: string[];
+    };
+}
+/** SSE event data for real-time flag updates. */
+export interface SSEFlagUpdate {
+    type: 'flag.updated' | 'flag.created' | 'flag.deleted';
+    flag: ApiFlagResponse;
+}
+/**
+ * A registered handler entry used by {@link DeploySentryClient.register} and
+ * {@link DeploySentryClient.dispatch}.
+ */
+export interface Registration<T extends (...args: any[]) => any = (...args: any[]) => any> {
+    handler: T;
+    flagKey?: string;
+}
+/** Optional evaluation context passed to {@link DeploySentryClient.dispatch}. */
+export interface EvaluationContext {
+    userId?: string;
+    attributes?: Record<string, string>;
+}
+/** Pre-loaded flag configuration for file/flagData mode. */
+export interface FlagConfig {
+    version: number;
+    project: string;
+    application: string;
+    exported_at: string;
+    environments: FlagConfigEnvironment[];
+    flags: FlagConfigFlag[];
+}
+/** Environment entry in a flag config file. */
+export interface FlagConfigEnvironment {
+    id: string;
+    name: string;
+    is_production: boolean;
+}
+/** Flag entry in a flag config file. */
+export interface FlagConfigFlag {
+    key: string;
+    name: string;
+    flag_type: string;
+    category: string;
+    default_value: string;
+    is_permanent: boolean;
+    expires_at?: string;
+    environments: Record<string, {
+        enabled: boolean;
+        value: string;
+    }>;
+    rules?: FlagConfigRule[];
+}
+/** Targeting rule within a flag config file. */
+export interface FlagConfigRule {
+    attribute: string;
+    operator: string;
+    target_values: string[];
+    value: string;
+    priority: number;
+    environments: Record<string, boolean>;
+}
+//# sourceMappingURL=types.d.ts.map