@supashiphq/react-native-sdk 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Supaship
+
+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

@@ -0,0 +1,81 @@
+# Supaship React Native SDK
+
+React Native bindings for Supaship: the same hooks and patterns as [`@supashiphq/react-sdk`](https://www.npmjs.com/package/@supashiphq/react-sdk), without browser-only APIs.
+
+## Installation
+
+```bash
+npm install @supashiphq/react-native-sdk
+# peers: react, react-native (@supashiphq/javascript-sdk is bundled as a dependency)
+```
+
+## Quick start
+
+```tsx
+import { SupaProvider, useFeature, FeaturesWithFallbacks } from '@supashiphq/react-native-sdk'
+import { View, Text } from 'react-native'
+
+const features = {
+  'new-header': false,
+  'theme-config': { mode: 'dark' as const, showLogo: true },
+} satisfies FeaturesWithFallbacks
+
+export function App() {
+  return (
+    <SupaProvider
+      config={{
+        sdkKey: 'your-sdk-key',
+        environment: 'production',
+        features,
+        context: { userId: '123' },
+        // Optional: disable toolbar explicitly (dev toolbar is web-only; native apps never show it)
+        toolbar: false,
+      }}
+    >
+      <Home />
+    </SupaProvider>
+  )
+}
+
+function Home() {
+  const { feature: newHeader, isLoading } = useFeature('new-header')
+  if (isLoading) return <Text>Loading…</Text>
+  return <View>{newHeader ? <Text>New</Text> : <Text>Old</Text>}</View>
+}
+```
+
+## Type-safe feature flags
+
+Same module augmentation as the React SDK; use `@supashiphq/react-native-sdk` in your `declare module`:
+
+```ts
+import { FeaturesWithFallbacks, InferFeatures } from '@supashiphq/react-native-sdk'
+
+export const FEATURE_FLAGS = {
+  'new-header': false,
+} satisfies FeaturesWithFallbacks
+
+declare module '@supashiphq/react-native-sdk' {
+  interface Features extends InferFeatures<typeof FEATURE_FLAGS> {}
+}
+```
+
+## API
+
+Exports match the React SDK where applicable:
+
+- `SupaProvider`, `useClient`, `useFeatureContext`
+- `useFeature`, `useFeatures`
+- `SupaFeature` (boolean-style variations; children are `ReactNode`, e.g. RN `View` / `Text`)
+
+### Query behavior / `refetchOnWindowFocus`
+
+The underlying `useQuery` option **`refetchOnWindowFocus`** keeps the same name as the web SDK. On React Native it triggers a refetch when the app moves to **`AppState` `active`** (foreground), not browser window focus. The default in `useFeature` / `useFeatures` remains `false`, same as React.
+
+## Sensitive context hashing
+
+If you use `sensitiveContextProperties` on the client, evaluation uses the Web Crypto API when available. In some Hermes/React Native setups you may need a `crypto.subtle` polyfill for hashing; feature fetching without that path is unaffected. See `@supashiphq/javascript-sdk` for details.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+## Supported Versions
+
+The latest published minor version of `@supashiphq/react-native-sdk` is actively supported.
+
+## Reporting a Vulnerability
+
+If you discover a security issue, do not open a public GitHub issue.
+
+- Email: `security@supaship.com`
+- Include: impact, reproduction steps, and affected versions
+- Expected response: acknowledgement within 3 business days
+
+We will investigate, coordinate a fix, and publish a security release as needed.

package/dist/index.d.mts

@@ -0,0 +1,209 @@
+import * as _supashiphq_react_core from '@supashiphq/react-core';
+import { QueryState, UseFeaturesResult, ExtractFeatureFlagValue } from '@supashiphq/react-core';
+export { UseFeatureResult, UseFeaturesResult } from '@supashiphq/react-core';
+import * as react from 'react';
+import react__default, { ReactNode } from 'react';
+import * as _supashiphq_javascript_sdk from '@supashiphq/javascript-sdk';
+import { FeatureValue, FeaturesWithFallbacks, FeatureContext } from '@supashiphq/javascript-sdk';
+export { FeatureContext, FeatureValue, FeaturesWithFallbacks, SupaPlugin, SupaClientConfig as SupaProviderConfig, SupaToolbarPluginConfig, SupaToolbarPosition } from '@supashiphq/javascript-sdk';
+
+declare const SupaProvider: <TFeatures extends _supashiphq_javascript_sdk.WidenFeatures<Record<string, _supashiphq_javascript_sdk.FeatureValue>>>({ config, toolbar, children, }: {
+    config: Omit<_supashiphq_javascript_sdk.SupaClientConfig, "plugins" | "toolbar"> & {
+        features: TFeatures;
+    };
+    toolbar?: boolean | _supashiphq_javascript_sdk.SupaToolbarPluginConfig | undefined;
+    children: react.ReactNode;
+}) => react.JSX.Element;
+declare const useClient: <TFeatures_1 extends _supashiphq_javascript_sdk.WidenFeatures<Record<string, _supashiphq_javascript_sdk.FeatureValue>>>() => _supashiphq_javascript_sdk.SupaClient<TFeatures_1>;
+declare const useFeatureContext: () => {
+    updateContext: (context: _supashiphq_javascript_sdk.FeatureContext, mergeWithExisting?: boolean | undefined) => void;
+    getContext: () => _supashiphq_javascript_sdk.FeatureContext | undefined;
+};
+declare const useQuery: <TData = unknown, TError = Error>(queryKey: _supashiphq_react_core.QueryKey, queryFn: () => Promise<TData>, options?: _supashiphq_react_core.UseQueryOptions<TData, TError> | undefined) => _supashiphq_react_core.QueryState<TData, TError>;
+declare const useQueryClient: () => {
+    _backing: {
+        _entries: Map<string, {
+            data: unknown;
+            timestamp: number;
+        }>;
+        _timers: Map<string, NodeJS.Timeout>;
+        _observers: Map<string, Set<() => void>>;
+        getQuery(queryKey: string): unknown;
+        isStale(queryKey: string, staleTime: number): boolean;
+        setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+        subscribe(queryKey: string, callback: () => void): () => void;
+        notifyObservers(queryKey: string): void;
+        invalidateQuery(queryKey: string): void;
+        invalidateQueries(queryKeyPrefix: string): void;
+        clear(): void;
+    };
+    invalidateQueries(queryKey: _supashiphq_react_core.QueryKey): void;
+    invalidateQueriesByPrefix(queryKeyPrefix: _supashiphq_react_core.QueryKey): void;
+    clear(): void;
+};
+declare const queryCache: {
+    _entries: Map<string, {
+        data: unknown;
+        timestamp: number;
+    }>;
+    _timers: Map<string, NodeJS.Timeout>;
+    _observers: Map<string, Set<() => void>>;
+    getQuery(queryKey: string): unknown;
+    isStale(queryKey: string, staleTime: number): boolean;
+    setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+    subscribe(queryKey: string, callback: () => void): () => void;
+    notifyObservers(queryKey: string): void;
+    invalidateQuery(queryKey: string): void;
+    invalidateQueries(queryKeyPrefix: string): void;
+    clear(): void;
+};
+declare const QueryClient: new (cache?: {
+    _entries: Map<string, {
+        data: unknown;
+        timestamp: number;
+    }>;
+    _timers: Map<string, NodeJS.Timeout>;
+    _observers: Map<string, Set<() => void>>;
+    getQuery(queryKey: string): unknown;
+    isStale(queryKey: string, staleTime: number): boolean;
+    setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+    subscribe(queryKey: string, callback: () => void): () => void;
+    notifyObservers(queryKey: string): void;
+    invalidateQuery(queryKey: string): void;
+    invalidateQueries(queryKeyPrefix: string): void;
+    clear(): void;
+} | undefined) => {
+    _backing: {
+        _entries: Map<string, {
+            data: unknown;
+            timestamp: number;
+        }>;
+        _timers: Map<string, NodeJS.Timeout>;
+        _observers: Map<string, Set<() => void>>;
+        getQuery(queryKey: string): unknown;
+        isStale(queryKey: string, staleTime: number): boolean;
+        setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+        subscribe(queryKey: string, callback: () => void): () => void;
+        notifyObservers(queryKey: string): void;
+        invalidateQuery(queryKey: string): void;
+        invalidateQueries(queryKeyPrefix: string): void;
+        clear(): void;
+    };
+    invalidateQueries(queryKey: _supashiphq_react_core.QueryKey): void;
+    invalidateQueriesByPrefix(queryKeyPrefix: _supashiphq_react_core.QueryKey): void;
+    clear(): void;
+};
+declare const getInitialQueryState: typeof _supashiphq_react_core.getInitialQueryState;
+
+/**
+ * Helper type to infer feature types from your feature config for module augmentation.
+ */
+type InferFeatures<T extends FeaturesWithFallbacks> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * Interface to be augmented by users for type-safe feature flags.
+ * Use InferFeatures helper to enable type-safe feature access.
+ *
+ * @example
+ * ```ts
+ * declare module '@supashiphq/react-native-sdk' {
+ *   interface Features extends InferFeatures<typeof FEATURE_FLAGS> {}
+ * }
+ * ```
+ */
+interface Features {
+}
+/**
+ * Return type for useFeature hook with proper typing based on feature key
+ */
+type TypedFeatures = keyof Features extends never ? {
+    [key: string]: Omit<QueryState<FeatureValue | null>, 'data'> & {
+        feature: FeatureValue | null;
+    };
+} : {
+    [K in keyof Features]: Omit<QueryState<Features[K]>, 'data'> & {
+        feature: Features[K];
+    };
+};
+type FeatureKey = keyof Features extends never ? string : keyof Features;
+interface UseFeatureOptions {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}
+interface UseFeaturesOptions {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}
+
+/**
+ * Returns the state of a given feature for the current context.
+ *
+ * @remarks
+ * For type-safe feature flags, augment the Features interface:
+ * ```ts
+ * declare module '@supashiphq/react-native-sdk' {
+ *   interface Features {
+ *     'my-feature': { value: 'variant-a' | 'variant-b' }
+ *     'dark-mode': { value: boolean }
+ *   }
+ * }
+ * ```
+ */
+declare function useFeature<TKey extends FeatureKey>(key: TKey, options?: {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}): TypedFeatures[TKey];
+/**
+ * Returns the state of multiple features for the current context.
+ */
+declare function useFeatures<TKeys extends readonly FeatureKey[]>(featureNames: TKeys, options?: {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}): UseFeaturesResult<{
+    [K in TKeys[number]]: K extends keyof Features ? ExtractFeatureFlagValue<Features[K]> : FeatureValue | null;
+}>;
+
+interface SupaFeatureProps {
+    /**
+     * The feature flag key to evaluate
+     */
+    feature: FeatureKey;
+    /**
+     * Context for feature evaluation
+     */
+    context?: FeatureContext;
+    /**
+     * Whether to fetch the feature (default: true)
+     */
+    shouldFetch?: boolean;
+    /**
+     * Variations object mapping "true" or "false" to React nodes (e.g. RN Views)
+     */
+    variations: {
+        true: ReactNode;
+        false?: ReactNode;
+    };
+    /**
+     * Component to render during loading state
+     */
+    loading?: ReactNode;
+}
+/**
+ * Conditionally renders variations based on boolean-style feature flag values.
+ *
+ * @example
+ * ```tsx
+ * <SupaFeature
+ *   feature="new-header"
+ *   loading={<ActivityIndicator />}
+ *   variations={{
+ *     true: <NewHeader />,
+ *     false: <OldHeader />
+ *   }}
+ * />
+ * ```
+ */
+declare function SupaFeature({ feature, context, shouldFetch, variations, loading, }: SupaFeatureProps): react__default.JSX.Element | null;
+
+export { type FeatureKey, type Features, type InferFeatures, QueryClient, SupaFeature, type SupaFeatureProps, SupaProvider, type TypedFeatures, type UseFeatureOptions, type UseFeaturesOptions, getInitialQueryState, queryCache, useClient, useFeature, useFeatureContext, useFeatures, useQuery, useQueryClient };

package/dist/index.d.ts

@@ -0,0 +1,209 @@
+import * as _supashiphq_react_core from '@supashiphq/react-core';
+import { QueryState, UseFeaturesResult, ExtractFeatureFlagValue } from '@supashiphq/react-core';
+export { UseFeatureResult, UseFeaturesResult } from '@supashiphq/react-core';
+import * as react from 'react';
+import react__default, { ReactNode } from 'react';
+import * as _supashiphq_javascript_sdk from '@supashiphq/javascript-sdk';
+import { FeatureValue, FeaturesWithFallbacks, FeatureContext } from '@supashiphq/javascript-sdk';
+export { FeatureContext, FeatureValue, FeaturesWithFallbacks, SupaPlugin, SupaClientConfig as SupaProviderConfig, SupaToolbarPluginConfig, SupaToolbarPosition } from '@supashiphq/javascript-sdk';
+
+declare const SupaProvider: <TFeatures extends _supashiphq_javascript_sdk.WidenFeatures<Record<string, _supashiphq_javascript_sdk.FeatureValue>>>({ config, toolbar, children, }: {
+    config: Omit<_supashiphq_javascript_sdk.SupaClientConfig, "plugins" | "toolbar"> & {
+        features: TFeatures;
+    };
+    toolbar?: boolean | _supashiphq_javascript_sdk.SupaToolbarPluginConfig | undefined;
+    children: react.ReactNode;
+}) => react.JSX.Element;
+declare const useClient: <TFeatures_1 extends _supashiphq_javascript_sdk.WidenFeatures<Record<string, _supashiphq_javascript_sdk.FeatureValue>>>() => _supashiphq_javascript_sdk.SupaClient<TFeatures_1>;
+declare const useFeatureContext: () => {
+    updateContext: (context: _supashiphq_javascript_sdk.FeatureContext, mergeWithExisting?: boolean | undefined) => void;
+    getContext: () => _supashiphq_javascript_sdk.FeatureContext | undefined;
+};
+declare const useQuery: <TData = unknown, TError = Error>(queryKey: _supashiphq_react_core.QueryKey, queryFn: () => Promise<TData>, options?: _supashiphq_react_core.UseQueryOptions<TData, TError> | undefined) => _supashiphq_react_core.QueryState<TData, TError>;
+declare const useQueryClient: () => {
+    _backing: {
+        _entries: Map<string, {
+            data: unknown;
+            timestamp: number;
+        }>;
+        _timers: Map<string, NodeJS.Timeout>;
+        _observers: Map<string, Set<() => void>>;
+        getQuery(queryKey: string): unknown;
+        isStale(queryKey: string, staleTime: number): boolean;
+        setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+        subscribe(queryKey: string, callback: () => void): () => void;
+        notifyObservers(queryKey: string): void;
+        invalidateQuery(queryKey: string): void;
+        invalidateQueries(queryKeyPrefix: string): void;
+        clear(): void;
+    };
+    invalidateQueries(queryKey: _supashiphq_react_core.QueryKey): void;
+    invalidateQueriesByPrefix(queryKeyPrefix: _supashiphq_react_core.QueryKey): void;
+    clear(): void;
+};
+declare const queryCache: {
+    _entries: Map<string, {
+        data: unknown;
+        timestamp: number;
+    }>;
+    _timers: Map<string, NodeJS.Timeout>;
+    _observers: Map<string, Set<() => void>>;
+    getQuery(queryKey: string): unknown;
+    isStale(queryKey: string, staleTime: number): boolean;
+    setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+    subscribe(queryKey: string, callback: () => void): () => void;
+    notifyObservers(queryKey: string): void;
+    invalidateQuery(queryKey: string): void;
+    invalidateQueries(queryKeyPrefix: string): void;
+    clear(): void;
+};
+declare const QueryClient: new (cache?: {
+    _entries: Map<string, {
+        data: unknown;
+        timestamp: number;
+    }>;
+    _timers: Map<string, NodeJS.Timeout>;
+    _observers: Map<string, Set<() => void>>;
+    getQuery(queryKey: string): unknown;
+    isStale(queryKey: string, staleTime: number): boolean;
+    setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+    subscribe(queryKey: string, callback: () => void): () => void;
+    notifyObservers(queryKey: string): void;
+    invalidateQuery(queryKey: string): void;
+    invalidateQueries(queryKeyPrefix: string): void;
+    clear(): void;
+} | undefined) => {
+    _backing: {
+        _entries: Map<string, {
+            data: unknown;
+            timestamp: number;
+        }>;
+        _timers: Map<string, NodeJS.Timeout>;
+        _observers: Map<string, Set<() => void>>;
+        getQuery(queryKey: string): unknown;
+        isStale(queryKey: string, staleTime: number): boolean;
+        setQuery(queryKey: string, data: unknown, cacheTime?: number | undefined): void;
+        subscribe(queryKey: string, callback: () => void): () => void;
+        notifyObservers(queryKey: string): void;
+        invalidateQuery(queryKey: string): void;
+        invalidateQueries(queryKeyPrefix: string): void;
+        clear(): void;
+    };
+    invalidateQueries(queryKey: _supashiphq_react_core.QueryKey): void;
+    invalidateQueriesByPrefix(queryKeyPrefix: _supashiphq_react_core.QueryKey): void;
+    clear(): void;
+};
+declare const getInitialQueryState: typeof _supashiphq_react_core.getInitialQueryState;
+
+/**
+ * Helper type to infer feature types from your feature config for module augmentation.
+ */
+type InferFeatures<T extends FeaturesWithFallbacks> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * Interface to be augmented by users for type-safe feature flags.
+ * Use InferFeatures helper to enable type-safe feature access.
+ *
+ * @example
+ * ```ts
+ * declare module '@supashiphq/react-native-sdk' {
+ *   interface Features extends InferFeatures<typeof FEATURE_FLAGS> {}
+ * }
+ * ```
+ */
+interface Features {
+}
+/**
+ * Return type for useFeature hook with proper typing based on feature key
+ */
+type TypedFeatures = keyof Features extends never ? {
+    [key: string]: Omit<QueryState<FeatureValue | null>, 'data'> & {
+        feature: FeatureValue | null;
+    };
+} : {
+    [K in keyof Features]: Omit<QueryState<Features[K]>, 'data'> & {
+        feature: Features[K];
+    };
+};
+type FeatureKey = keyof Features extends never ? string : keyof Features;
+interface UseFeatureOptions {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}
+interface UseFeaturesOptions {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}
+
+/**
+ * Returns the state of a given feature for the current context.
+ *
+ * @remarks
+ * For type-safe feature flags, augment the Features interface:
+ * ```ts
+ * declare module '@supashiphq/react-native-sdk' {
+ *   interface Features {
+ *     'my-feature': { value: 'variant-a' | 'variant-b' }
+ *     'dark-mode': { value: boolean }
+ *   }
+ * }
+ * ```
+ */
+declare function useFeature<TKey extends FeatureKey>(key: TKey, options?: {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}): TypedFeatures[TKey];
+/**
+ * Returns the state of multiple features for the current context.
+ */
+declare function useFeatures<TKeys extends readonly FeatureKey[]>(featureNames: TKeys, options?: {
+    context?: FeatureContext;
+    shouldFetch?: boolean;
+}): UseFeaturesResult<{
+    [K in TKeys[number]]: K extends keyof Features ? ExtractFeatureFlagValue<Features[K]> : FeatureValue | null;
+}>;
+
+interface SupaFeatureProps {
+    /**
+     * The feature flag key to evaluate
+     */
+    feature: FeatureKey;
+    /**
+     * Context for feature evaluation
+     */
+    context?: FeatureContext;
+    /**
+     * Whether to fetch the feature (default: true)
+     */
+    shouldFetch?: boolean;
+    /**
+     * Variations object mapping "true" or "false" to React nodes (e.g. RN Views)
+     */
+    variations: {
+        true: ReactNode;
+        false?: ReactNode;
+    };
+    /**
+     * Component to render during loading state
+     */
+    loading?: ReactNode;
+}
+/**
+ * Conditionally renders variations based on boolean-style feature flag values.
+ *
+ * @example
+ * ```tsx
+ * <SupaFeature
+ *   feature="new-header"
+ *   loading={<ActivityIndicator />}
+ *   variations={{
+ *     true: <NewHeader />,
+ *     false: <OldHeader />
+ *   }}
+ * />
+ * ```
+ */
+declare function SupaFeature({ feature, context, shouldFetch, variations, loading, }: SupaFeatureProps): react__default.JSX.Element | null;
+
+export { type FeatureKey, type Features, type InferFeatures, QueryClient, SupaFeature, type SupaFeatureProps, SupaProvider, type TypedFeatures, type UseFeatureOptions, type UseFeaturesOptions, getInitialQueryState, queryCache, useClient, useFeature, useFeatureContext, useFeatures, useQuery, useQueryClient };

package/dist/index.js

@@ -0,0 +1,106 @@
+"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, {
+  QueryClient: () => QueryClient,
+  SupaFeature: () => SupaFeature,
+  SupaProvider: () => SupaProvider,
+  getInitialQueryState: () => getInitialQueryState,
+  queryCache: () => queryCache,
+  useClient: () => useClient,
+  useFeature: () => useFeature,
+  useFeatureContext: () => useFeatureContext,
+  useFeatures: () => useFeatures,
+  useQuery: () => useQuery,
+  useQueryClient: () => useQueryClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/supaship.ts
+var import_react_core = require("@supashiphq/react-core");
+var import_focus_native = require("@supashiphq/react-core/focus-native");
+var supaship = (0, import_react_core.createSupashipReact)(import_focus_native.useNativeFocusRefetchEffect);
+var {
+  SupaProvider,
+  useClient,
+  useFeatureContext,
+  useQuery,
+  useQueryClient,
+  queryCache,
+  QueryClient,
+  getInitialQueryState
+} = supaship;
+var useFeatureUntyped = supaship.useFeature;
+var useFeaturesUntyped = supaship.useFeatures;
+
+// src/hooks.ts
+function useFeature(key, options) {
+  return useFeatureUntyped(key, options);
+}
+function useFeatures(featureNames, options) {
+  return useFeaturesUntyped(featureNames, options);
+}
+
+// src/utils.ts
+function hasValue(value) {
+  return value !== void 0 && value !== null;
+}
+
+// src/components.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function SupaFeature({
+  feature,
+  context,
+  shouldFetch = true,
+  variations,
+  loading
+}) {
+  const { feature: featureValue, isLoading } = useFeature(feature, {
+    context,
+    shouldFetch
+  });
+  if (isLoading) {
+    return loading ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: loading }) : null;
+  }
+  const valueKey = String(featureValue);
+  if (variations.true && valueKey === "true") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: variations.true });
+  }
+  if (variations.false && (valueKey === "false" || !hasValue(featureValue))) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: variations.false });
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  QueryClient,
+  SupaFeature,
+  SupaProvider,
+  getInitialQueryState,
+  queryCache,
+  useClient,
+  useFeature,
+  useFeatureContext,
+  useFeatures,
+  useQuery,
+  useQueryClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/supaship.ts","../src/hooks.ts","../src/utils.ts","../src/components.tsx"],"sourcesContent":["export {\n  SupaProvider,\n  useClient,\n  useFeatureContext,\n  useQuery,\n  useQueryClient,\n  queryCache,\n  QueryClient,\n  getInitialQueryState,\n} from './supaship'\nexport * from './hooks'\nexport * from './types'\nexport * from './components'\n","import { createSupashipReact } from '@supashiphq/react-core'\nimport { useNativeFocusRefetchEffect } from '@supashiphq/react-core/focus-native'\n\nconst supaship = createSupashipReact(useNativeFocusRefetchEffect)\n\nexport const {\n  SupaProvider,\n  useClient,\n  useFeatureContext,\n  useQuery,\n  useQueryClient,\n  queryCache,\n  QueryClient,\n  getInitialQueryState,\n} = supaship\n\n/** @internal widened hooks — use `useFeature` / `useFeatures` from this package’s public API */\nexport const useFeatureUntyped = supaship.useFeature\n/** @internal */\nexport const useFeaturesUntyped = supaship.useFeatures\n","import { FeatureValue, FeatureContext } from '@supashiphq/javascript-sdk'\nimport type { ExtractFeatureFlagValue, UseFeaturesResult } from '@supashiphq/react-core'\nimport { useFeatureUntyped, useFeaturesUntyped } from './supaship'\nimport { FeatureKey, TypedFeatures, Features } from './types'\n\n/**\n * Returns the state of a given feature for the current context.\n *\n * @remarks\n * For type-safe feature flags, augment the Features interface:\n * ```ts\n * declare module '@supashiphq/react-native-sdk' {\n *   interface Features {\n *     'my-feature': { value: 'variant-a' | 'variant-b' }\n *     'dark-mode': { value: boolean }\n *   }\n * }\n * ```\n */\nexport function useFeature<TKey extends FeatureKey>(\n  key: TKey,\n  options?: { context?: FeatureContext; shouldFetch?: boolean }\n): TypedFeatures[TKey] {\n  return useFeatureUntyped(key as string, options) as TypedFeatures[TKey]\n}\n\n/**\n * Returns the state of multiple features for the current context.\n */\nexport function useFeatures<TKeys extends readonly FeatureKey[]>(\n  featureNames: TKeys,\n  options?: {\n    context?: FeatureContext\n    shouldFetch?: boolean\n  }\n): UseFeaturesResult<{\n  [K in TKeys[number]]: K extends keyof Features\n    ? ExtractFeatureFlagValue<Features[K]>\n    : FeatureValue | null\n}> {\n  return useFeaturesUntyped(featureNames as readonly string[], options) as UseFeaturesResult<{\n    [K in TKeys[number]]: K extends keyof Features\n      ? ExtractFeatureFlagValue<Features[K]>\n      : FeatureValue | null\n  }>\n}\n","export function hasValue(value: unknown): boolean {\n  return value !== undefined && value !== null\n}\n","import React, { ReactNode } from 'react'\nimport { useFeature } from './hooks'\nimport { FeatureKey, FeatureContext } from './types'\nimport { hasValue } from './utils'\n\nexport interface SupaFeatureProps {\n  /**\n   * The feature flag key to evaluate\n   */\n  feature: FeatureKey\n\n  /**\n   * Context for feature evaluation\n   */\n  context?: FeatureContext\n\n  /**\n   * Whether to fetch the feature (default: true)\n   */\n  shouldFetch?: boolean\n\n  /**\n   * Variations object mapping \"true\" or \"false\" to React nodes (e.g. RN Views)\n   */\n  variations: {\n    true: ReactNode\n    false?: ReactNode\n  }\n\n  /**\n   * Component to render during loading state\n   */\n  loading?: ReactNode\n}\n\n/**\n * Conditionally renders variations based on boolean-style feature flag values.\n *\n * @example\n * ```tsx\n * <SupaFeature\n *   feature=\"new-header\"\n *   loading={<ActivityIndicator />}\n *   variations={{\n *     true: <NewHeader />,\n *     false: <OldHeader />\n *   }}\n * />\n * ```\n */\nexport function SupaFeature({\n  feature,\n  context,\n  shouldFetch = true,\n  variations,\n  loading,\n}: SupaFeatureProps): React.JSX.Element | null {\n  const { feature: featureValue, isLoading } = useFeature(feature, {\n    context,\n    shouldFetch,\n  })\n\n  if (isLoading) {\n    return loading ? <>{loading}</> : null\n  }\n\n  const valueKey = String(featureValue)\n\n  if (variations.true && valueKey === 'true') {\n    return <>{variations.true}</>\n  }\n\n  if (variations.false && (valueKey === 'false' || !hasValue(featureValue))) {\n    return <>{variations.false}</>\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,wBAAoC;AACpC,0BAA4C;AAE5C,IAAM,eAAW,uCAAoB,+CAA2B;AAEzD,IAAM;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAI;AAGG,IAAM,oBAAoB,SAAS;AAEnC,IAAM,qBAAqB,SAAS;;;ACApC,SAAS,WACd,KACA,SACqB;AACrB,SAAO,kBAAkB,KAAe,OAAO;AACjD;AAKO,SAAS,YACd,cACA,SAQC;AACD,SAAO,mBAAmB,cAAmC,OAAO;AAKtE;;;AC7CO,SAAS,SAAS,OAAyB;AAChD,SAAO,UAAU,UAAa,UAAU;AAC1C;;;AC6DqB;AAbd,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AACF,GAA+C;AAC7C,QAAM,EAAE,SAAS,cAAc,UAAU,IAAI,WAAW,SAAS;AAAA,IAC/D;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,WAAW;AACb,WAAO,UAAU,2EAAG,mBAAQ,IAAM;AAAA,EACpC;AAEA,QAAM,WAAW,OAAO,YAAY;AAEpC,MAAI,WAAW,QAAQ,aAAa,QAAQ;AAC1C,WAAO,2EAAG,qBAAW,MAAK;AAAA,EAC5B;AAEA,MAAI,WAAW,UAAU,aAAa,WAAW,CAAC,SAAS,YAAY,IAAI;AACzE,WAAO,2EAAG,qBAAW,OAAM;AAAA,EAC7B;AAEA,SAAO;AACT;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,69 @@
+// src/supaship.ts
+import { createSupashipReact } from "@supashiphq/react-core";
+import { useNativeFocusRefetchEffect } from "@supashiphq/react-core/focus-native";
+var supaship = createSupashipReact(useNativeFocusRefetchEffect);
+var {
+  SupaProvider,
+  useClient,
+  useFeatureContext,
+  useQuery,
+  useQueryClient,
+  queryCache,
+  QueryClient,
+  getInitialQueryState
+} = supaship;
+var useFeatureUntyped = supaship.useFeature;
+var useFeaturesUntyped = supaship.useFeatures;
+
+// src/hooks.ts
+function useFeature(key, options) {
+  return useFeatureUntyped(key, options);
+}
+function useFeatures(featureNames, options) {
+  return useFeaturesUntyped(featureNames, options);
+}
+
+// src/utils.ts
+function hasValue(value) {
+  return value !== void 0 && value !== null;
+}
+
+// src/components.tsx
+import { Fragment, jsx } from "react/jsx-runtime";
+function SupaFeature({
+  feature,
+  context,
+  shouldFetch = true,
+  variations,
+  loading
+}) {
+  const { feature: featureValue, isLoading } = useFeature(feature, {
+    context,
+    shouldFetch
+  });
+  if (isLoading) {
+    return loading ? /* @__PURE__ */ jsx(Fragment, { children: loading }) : null;
+  }
+  const valueKey = String(featureValue);
+  if (variations.true && valueKey === "true") {
+    return /* @__PURE__ */ jsx(Fragment, { children: variations.true });
+  }
+  if (variations.false && (valueKey === "false" || !hasValue(featureValue))) {
+    return /* @__PURE__ */ jsx(Fragment, { children: variations.false });
+  }
+  return null;
+}
+export {
+  QueryClient,
+  SupaFeature,
+  SupaProvider,
+  getInitialQueryState,
+  queryCache,
+  useClient,
+  useFeature,
+  useFeatureContext,
+  useFeatures,
+  useQuery,
+  useQueryClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/supaship.ts","../src/hooks.ts","../src/utils.ts","../src/components.tsx"],"sourcesContent":["import { createSupashipReact } from '@supashiphq/react-core'\nimport { useNativeFocusRefetchEffect } from '@supashiphq/react-core/focus-native'\n\nconst supaship = createSupashipReact(useNativeFocusRefetchEffect)\n\nexport const {\n  SupaProvider,\n  useClient,\n  useFeatureContext,\n  useQuery,\n  useQueryClient,\n  queryCache,\n  QueryClient,\n  getInitialQueryState,\n} = supaship\n\n/** @internal widened hooks — use `useFeature` / `useFeatures` from this package’s public API */\nexport const useFeatureUntyped = supaship.useFeature\n/** @internal */\nexport const useFeaturesUntyped = supaship.useFeatures\n","import { FeatureValue, FeatureContext } from '@supashiphq/javascript-sdk'\nimport type { ExtractFeatureFlagValue, UseFeaturesResult } from '@supashiphq/react-core'\nimport { useFeatureUntyped, useFeaturesUntyped } from './supaship'\nimport { FeatureKey, TypedFeatures, Features } from './types'\n\n/**\n * Returns the state of a given feature for the current context.\n *\n * @remarks\n * For type-safe feature flags, augment the Features interface:\n * ```ts\n * declare module '@supashiphq/react-native-sdk' {\n *   interface Features {\n *     'my-feature': { value: 'variant-a' | 'variant-b' }\n *     'dark-mode': { value: boolean }\n *   }\n * }\n * ```\n */\nexport function useFeature<TKey extends FeatureKey>(\n  key: TKey,\n  options?: { context?: FeatureContext; shouldFetch?: boolean }\n): TypedFeatures[TKey] {\n  return useFeatureUntyped(key as string, options) as TypedFeatures[TKey]\n}\n\n/**\n * Returns the state of multiple features for the current context.\n */\nexport function useFeatures<TKeys extends readonly FeatureKey[]>(\n  featureNames: TKeys,\n  options?: {\n    context?: FeatureContext\n    shouldFetch?: boolean\n  }\n): UseFeaturesResult<{\n  [K in TKeys[number]]: K extends keyof Features\n    ? ExtractFeatureFlagValue<Features[K]>\n    : FeatureValue | null\n}> {\n  return useFeaturesUntyped(featureNames as readonly string[], options) as UseFeaturesResult<{\n    [K in TKeys[number]]: K extends keyof Features\n      ? ExtractFeatureFlagValue<Features[K]>\n      : FeatureValue | null\n  }>\n}\n","export function hasValue(value: unknown): boolean {\n  return value !== undefined && value !== null\n}\n","import React, { ReactNode } from 'react'\nimport { useFeature } from './hooks'\nimport { FeatureKey, FeatureContext } from './types'\nimport { hasValue } from './utils'\n\nexport interface SupaFeatureProps {\n  /**\n   * The feature flag key to evaluate\n   */\n  feature: FeatureKey\n\n  /**\n   * Context for feature evaluation\n   */\n  context?: FeatureContext\n\n  /**\n   * Whether to fetch the feature (default: true)\n   */\n  shouldFetch?: boolean\n\n  /**\n   * Variations object mapping \"true\" or \"false\" to React nodes (e.g. RN Views)\n   */\n  variations: {\n    true: ReactNode\n    false?: ReactNode\n  }\n\n  /**\n   * Component to render during loading state\n   */\n  loading?: ReactNode\n}\n\n/**\n * Conditionally renders variations based on boolean-style feature flag values.\n *\n * @example\n * ```tsx\n * <SupaFeature\n *   feature=\"new-header\"\n *   loading={<ActivityIndicator />}\n *   variations={{\n *     true: <NewHeader />,\n *     false: <OldHeader />\n *   }}\n * />\n * ```\n */\nexport function SupaFeature({\n  feature,\n  context,\n  shouldFetch = true,\n  variations,\n  loading,\n}: SupaFeatureProps): React.JSX.Element | null {\n  const { feature: featureValue, isLoading } = useFeature(feature, {\n    context,\n    shouldFetch,\n  })\n\n  if (isLoading) {\n    return loading ? <>{loading}</> : null\n  }\n\n  const valueKey = String(featureValue)\n\n  if (variations.true && valueKey === 'true') {\n    return <>{variations.true}</>\n  }\n\n  if (variations.false && (valueKey === 'false' || !hasValue(featureValue))) {\n    return <>{variations.false}</>\n  }\n\n  return null\n}\n"],"mappings":";AAAA,SAAS,2BAA2B;AACpC,SAAS,mCAAmC;AAE5C,IAAM,WAAW,oBAAoB,2BAA2B;AAEzD,IAAM;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAI;AAGG,IAAM,oBAAoB,SAAS;AAEnC,IAAM,qBAAqB,SAAS;;;ACApC,SAAS,WACd,KACA,SACqB;AACrB,SAAO,kBAAkB,KAAe,OAAO;AACjD;AAKO,SAAS,YACd,cACA,SAQC;AACD,SAAO,mBAAmB,cAAmC,OAAO;AAKtE;;;AC7CO,SAAS,SAAS,OAAyB;AAChD,SAAO,UAAU,UAAa,UAAU;AAC1C;;;AC6DqB;AAbd,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AACF,GAA+C;AAC7C,QAAM,EAAE,SAAS,cAAc,UAAU,IAAI,WAAW,SAAS;AAAA,IAC/D;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,WAAW;AACb,WAAO,UAAU,gCAAG,mBAAQ,IAAM;AAAA,EACpC;AAEA,QAAM,WAAW,OAAO,YAAY;AAEpC,MAAI,WAAW,QAAQ,aAAa,QAAQ;AAC1C,WAAO,gCAAG,qBAAW,MAAK;AAAA,EAC5B;AAEA,MAAI,WAAW,UAAU,aAAa,WAAW,CAAC,SAAS,YAAY,IAAI;AACzE,WAAO,gCAAG,qBAAW,OAAM;AAAA,EAC7B;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@supashiphq/react-native-sdk",
+  "version": "1.0.3",
+  "description": "Supaship SDK for React Native",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "pnpm clean && pnpm build:tsup",
+    "build:tsup": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest --watchAll=false",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "prepublishOnly": "pnpm build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-native": ">=0.71.0"
+  },
+  "dependencies": {
+    "@supashiphq/javascript-sdk": "workspace:^1.0.3",
+    "@supashiphq/react-core": "workspace:^1.0.3"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.0",
+    "@testing-library/jest-dom": "^6.4.2",
+    "@testing-library/react": "^14.2.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "react": "^18.2.0",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "~5.3.3"
+  },
+  "keywords": [
+    "feature-flags",
+    "feature-toggles",
+    "react-native",
+    "sdk"
+  ],
+  "author": "Supaship",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SupashipHQ/javascript-sdk",
+    "directory": "packages/react-native"
+  },
+  "bugs": {
+    "url": "https://github.com/SupashipHQ/javascript-sdk/issues"
+  },
+  "homepage": "https://supaship.com",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}