@omniretail/omniflags-react-native 1.0.0

package/README.md

@@ -0,0 +1,122 @@
+# @omniretail/omniflags-react-native
+
+React Native SDK for OmniFlags.
+
+## Installation
+
+```bash
+npm install @omniretail/omniflags-react-native @react-native-async-storage/async-storage
+```
+
+Follow the [AsyncStorage setup guide](https://react-native-async-storage.github.io/async-storage/docs/install) to link the native module. If you're using Expo:
+
+```bash
+npx expo install @react-native-async-storage/async-storage
+```
+
+## Quick start
+
+```tsx
+import { OmniFlagsProvider, useFlag } from "@omniretail/omniflags-react-native";
+
+function App() {
+  return (
+    <OmniFlagsProvider sdkKey="your-sdk-key">
+      <MyApp />
+    </OmniFlagsProvider>
+  );
+}
+
+function MyApp() {
+  const enabled = useFlag("store.new-checkout");
+  return enabled ? <NewCheckout /> : <LegacyCheckout />;
+}
+```
+
+## Provider
+
+```tsx
+<OmniFlagsProvider sdkKey="your-sdk-key">
+  {children}
+</OmniFlagsProvider>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `sdkKey` | `string` | **Required.** SDK key from the OmniFlags dashboard. |
+
+Flags are persisted to AsyncStorage and refreshed when the app returns to the foreground.
+
+## Hooks
+
+### `useFlag`
+
+```tsx
+const enabled = useFlag("store.new-checkout");
+const enabled = useFlag("store.new-checkout", { customerId: "cust-123" }); // with context
+const enabled = useFlag("store.new-checkout", undefined, false);            // custom default
+```
+
+### `useFlagValue`
+
+```tsx
+const theme = useFlagValue<string>("store.theme", "light");
+const limit = useFlagValue<number>("store.item-limit", 10);
+const theme = useFlagValue<string>("store.theme", "light", { businessId: "biz-456" }); // with context
+```
+
+### `useFlagVariant`
+
+Returns the full evaluation result — value, variant, reason, and which rule matched.
+
+```tsx
+const result = useFlagVariant("store.new-checkout");
+// result.value, result.variant, result.reason, result.ruleId, result.errorCode
+```
+
+### `useFlagLoading`
+
+Returns the current loading state of the flag client.
+
+```tsx
+const { isFetching, isLoading, origin, error } = useFlagLoading();
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `isFetching` | `boolean` | A network request is in flight. |
+| `isLoading` | `boolean` | No flags have been loaded yet (first fetch pending). |
+| `origin` | `FlagOrigin` | Where the current flags came from: `"NONE"`, `"CACHE"`, or `"SERVER"`. |
+| `error` | `Error \| null` | The last fetch error, or `null`. |
+
+```tsx
+function FlagGate({ children }: { children: React.ReactNode }) {
+  const { isLoading } = useFlagLoading();
+  if (isLoading) return <ActivityIndicator />;
+  return <>{children}</>;
+}
+```
+
+### `useOmniFlags`
+
+Low-level access to the underlying client and ready state.
+
+```tsx
+const { client, ready } = useOmniFlags();
+```
+
+## Context
+
+Context is passed per evaluation call — customer, business, branch, country, etc. There is no persistent context state.
+
+```tsx
+function CheckoutButton({ customerId, businessBranchId }: Props) {
+  const ctx = { customerId, businessBranchId };
+  const enabled = useFlag("store.new-checkout", ctx);
+  return enabled ? <NewCheckoutButton /> : <LegacyCheckoutButton />;
+}
+```
+
+## Flag keys
+
+Keys are namespaced by project: `{projectKey}.{flagKey}`. Find the full flag key in the OmniFlags dashboard on the flag detail page.

package/dist/async-storage-cache.d.ts

@@ -0,0 +1,15 @@
+import type { CacheAdapter } from "@omniretail/omniflags-core";
+import type AsyncStorage from "@react-native-async-storage/async-storage";
+export interface AsyncStorageLike {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+export type ReactNativeAsyncStorage = typeof AsyncStorage;
+export declare class AsyncStorageCache implements CacheAdapter {
+    private storage;
+    constructor(storage: AsyncStorageLike);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}

package/dist/async-storage-cache.js

@@ -0,0 +1,36 @@
+/**
+ * AsyncStorage-backed cache for React Native.
+ * Uses @react-native-async-storage/async-storage under the hood.
+ */
+const PREFIX = "omniflags:snapshot:";
+export class AsyncStorageCache {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async get(key) {
+        try {
+            return await this.storage.getItem(PREFIX + key);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        try {
+            await this.storage.setItem(PREFIX + key, value);
+        }
+        catch {
+            /* non-fatal — storage may be full */
+        }
+    }
+    async remove(key) {
+        try {
+            await this.storage.removeItem(PREFIX + key);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=async-storage-cache.js.map

package/dist/async-storage-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage-cache.js","sourceRoot":"","sources":["../src/async-storage-cache.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAUrC,MAAM,OAAO,iBAAiB;IACpB,OAAO,CAAmB;IAElC,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/context.d.ts

@@ -0,0 +1,7 @@
+import type { OmniFlagsClient } from "@omniretail/omniflags-core";
+export interface OmniFlagsContextValue {
+    client: OmniFlagsClient;
+    ready: boolean;
+}
+export declare const OmniFlagsContext: import("react").Context<OmniFlagsContextValue | null>;
+export declare function useOmniFlagsContext(): OmniFlagsContextValue;

package/dist/context.js

@@ -0,0 +1,10 @@
+import { createContext, useContext } from "react";
+export const OmniFlagsContext = createContext(null);
+export function useOmniFlagsContext() {
+    const ctx = useContext(OmniFlagsContext);
+    if (!ctx) {
+        throw new Error("useOmniFlags* hooks must be used inside <OmniFlagsProvider>");
+    }
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAQlD,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAElF,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,9 @@
+import type { EvaluationContext, EvaluationResult, LoadingState } from "@omniretail/omniflags-core";
+export declare function useFlagLoading(): LoadingState;
+export declare function useOmniFlags(): {
+    client: import("@omniretail/omniflags-core").OmniFlagsClient;
+    ready: boolean;
+};
+export declare function useFlag(flagKey: string, context?: EvaluationContext, defaultValue?: boolean): boolean;
+export declare function useFlagValue<T = unknown>(flagKey: string, defaultValue: T, context?: EvaluationContext): T;
+export declare function useFlagVariant(flagKey: string, context?: EvaluationContext): EvaluationResult;

package/dist/hooks.js

@@ -0,0 +1,69 @@
+import { useState, useEffect, useRef } from "react";
+import { useOmniFlagsContext } from "./context.js";
+export function useFlagLoading() {
+    const { client } = useOmniFlagsContext();
+    const [state, setState] = useState(() => client.loadingState);
+    useEffect(() => {
+        const unsub = client.on("PROVIDER_LOADING_STATE_CHANGED", () => {
+            setState(client.loadingState);
+        });
+        return unsub;
+    }, [client]);
+    return state;
+}
+export function useOmniFlags() {
+    const { client, ready } = useOmniFlagsContext();
+    return { client, ready };
+}
+export function useFlag(flagKey, context, defaultValue = false) {
+    const { client } = useOmniFlagsContext();
+    const contextRef = useRef(context);
+    contextRef.current = context;
+    const [value, setValue] = useState(() => client.isEnabled(flagKey, context, defaultValue));
+    useEffect(() => {
+        const update = () => {
+            const next = client.isEnabled(flagKey, contextRef.current, defaultValue);
+            setValue((prev) => (prev === next ? prev : next));
+        };
+        update();
+        const unsubReady = client.on("PROVIDER_READY", update);
+        const unsubChange = client.on("PROVIDER_CONFIGURATION_CHANGED", update);
+        return () => { unsubReady(); unsubChange(); };
+    }, [client, flagKey, defaultValue]);
+    return value;
+}
+export function useFlagValue(flagKey, defaultValue, context) {
+    const { client } = useOmniFlagsContext();
+    const contextRef = useRef(context);
+    contextRef.current = context;
+    const [value, setValue] = useState(() => client.getValue(flagKey, context, defaultValue));
+    useEffect(() => {
+        const update = () => {
+            const next = client.getValue(flagKey, contextRef.current, defaultValue);
+            setValue((prev) => (Object.is(prev, next) ? prev : next));
+        };
+        update();
+        const unsubReady = client.on("PROVIDER_READY", update);
+        const unsubChange = client.on("PROVIDER_CONFIGURATION_CHANGED", update);
+        return () => { unsubReady(); unsubChange(); };
+    }, [client, flagKey, defaultValue]);
+    return value;
+}
+export function useFlagVariant(flagKey, context) {
+    const { client } = useOmniFlagsContext();
+    const contextRef = useRef(context);
+    contextRef.current = context;
+    const [result, setResult] = useState(() => client.getVariant(flagKey, context));
+    useEffect(() => {
+        const update = () => {
+            const next = client.getVariant(flagKey, contextRef.current);
+            setResult((prev) => (prev.variant === next.variant && prev.reason === next.reason ? prev : next));
+        };
+        update();
+        const unsubReady = client.on("PROVIDER_READY", update);
+        const unsubChange = client.on("PROVIDER_CONFIGURATION_CHANGED", update);
+        return () => { unsubReady(); unsubChange(); };
+    }, [client, flagKey]);
+    return result;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { OmniFlagsProvider } from "./provider.js";
+export type { OmniFlagsProviderProps } from "./provider.js";
+export { AsyncStorageCache } from "./async-storage-cache.js";
+export type { AsyncStorageLike, ReactNativeAsyncStorage } from "./async-storage-cache.js";
+export { useOmniFlags, useFlag, useFlagValue, useFlagVariant, useFlagLoading } from "./hooks.js";
+export { OmniFlagsContext } from "./context.js";
+export type { OmniFlagsContextValue } from "./context.js";
+export type { EvaluationContext, EvaluationResult, FlagConfig, FlagOrigin, Hook, LoadingState, ProviderEvent, } from "@omniretail/omniflags-core";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { OmniFlagsProvider } from "./provider.js";
+export { AsyncStorageCache } from "./async-storage-cache.js";
+export { useOmniFlags, useFlag, useFlagValue, useFlagVariant, useFlagLoading } from "./hooks.js";
+export { OmniFlagsContext } from "./context.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,9 @@
+import React, { type ReactNode } from "react";
+import { type ReactNativeAsyncStorage } from "./async-storage-cache.js";
+export interface OmniFlagsProviderProps {
+    sdkKey: string;
+    children?: ReactNode;
+    /** Optional override for AsyncStorage implementation (tests/custom runtimes). */
+    asyncStorage?: ReactNativeAsyncStorage;
+}
+export declare function OmniFlagsProvider({ sdkKey, children, asyncStorage, ...rest }: OmniFlagsProviderProps): React.FunctionComponentElement<React.ProviderProps<import("./context.js").OmniFlagsContextValue | null>>;

package/dist/provider.js

@@ -0,0 +1,38 @@
+import React, { useEffect, useRef, useState } from "react";
+import { AppState } from "react-native";
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { OmniFlagsClient } from "@omniretail/omniflags-core";
+import { OmniFlagsContext } from "./context.js";
+import { AsyncStorageCache } from "./async-storage-cache.js";
+export function OmniFlagsProvider({ sdkKey, children, asyncStorage, ...rest }) {
+    const provider = rest.provider;
+    const [ready, setReady] = useState(false);
+    const clientRef = useRef(null);
+    if (!clientRef.current) {
+        clientRef.current = new OmniFlagsClient({ sdkKey, provider }, new AsyncStorageCache(asyncStorage ?? AsyncStorage));
+    }
+    const client = clientRef.current;
+    useEffect(() => {
+        let mounted = true;
+        client.waitForReady().then(() => {
+            if (mounted)
+                setReady(true);
+        });
+        return () => {
+            mounted = false;
+            void client.shutdown();
+        };
+    }, [client]);
+    useEffect(() => {
+        const subscription = AppState.addEventListener("change", (nextState) => {
+            if (nextState === "active") {
+                client.refresh();
+            }
+        });
+        return () => {
+            subscription.remove();
+        };
+    }, [client]);
+    return React.createElement(OmniFlagsContext.Provider, { value: { client, ready } }, children);
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,YAAY,MAAM,2CAA2C,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAgC,MAAM,0BAA0B,CAAC;AAc3F,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,GAAG,IAAI,EACgB;IACvB,MAAM,QAAQ,GAAI,IAAsB,CAAC,QAAQ,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAEvD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,GAAG,IAAI,eAAe,CACrC,EAAE,MAAM,EAAE,QAAQ,EAAE,EACpB,IAAI,iBAAiB,CAAC,YAAY,IAAI,YAAY,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,MAAM,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC9B,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;YAChB,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;YACrE,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,KAAK,CAAC,aAAa,CACxB,gBAAgB,CAAC,QAAQ,EACzB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAC5B,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@omniretail/omniflags-react-native",
+  "version": "1.0.0",
+  "description": "OmniFlags React Native SDK — provider + hooks with built-in AsyncStorage offline cache",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    }
+  },
+  "dependencies": {
+    "@omniretail/omniflags-core": "file:../core"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^29.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "feature-flags",
+    "omniflags",
+    "react-native"
+  ],
+  "license": "MIT"
+}