@quonfig/react-native 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.0.1
+
+- Initial release. Thin polyfill wrapper around `@quonfig/react` for React Native. Installs
+  `react-native-get-random-values` (needed by the `uuid` dependency inside `@quonfig/javascript`)
+  and the `base-64` `btoa` / `atob` shims (needed by the SDK's base64 helper which assumes
+  `window.btoa` when `typeof window !== "undefined"`, including under React Native).

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2026 Reforge
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @quonfig/react-native
+
+React Native bindings for [Quonfig](https://quonfig.com).
+
+This package is a thin polyfill wrapper around
+[`@quonfig/react`](https://github.com/quonfig/sdk-react). It installs the two web APIs the
+underlying JavaScript SDK assumes but React Native's JS runtime is missing (`crypto.getRandomValues`
+and `btoa` / `atob`), then re-exports the entire `@quonfig/react` public API. If you need a feature
+that the React SDK does not yet expose to React Native, open an issue.
+
+## Install
+
+```bash
+npm install @quonfig/react-native @quonfig/react base-64 react-native-get-random-values
+# or
+yarn add @quonfig/react-native @quonfig/react base-64 react-native-get-random-values
+```
+
+TypeScript types are included.
+
+## Usage
+
+Identical to [`@quonfig/react`](https://github.com/quonfig/sdk-react#usage) — wrap your component
+tree in `QuonfigProvider` and read flags with `useQuonfig`:
+
+```tsx
+import { QuonfigProvider, useQuonfig } from "@quonfig/react-native";
+
+const App = () => (
+  <QuonfigProvider
+    sdkKey="YOUR_SDK_KEY"
+    contextAttributes={{ user: { email: "jeffrey@example.com" } }}
+    onError={(err) => console.error(err)}
+  >
+    <Logo />
+  </QuonfigProvider>
+);
+
+const Logo = () => {
+  const { isEnabled } = useQuonfig();
+  return isEnabled("new-logo") ? <NewLogo /> : <OldLogo />;
+};
+```
+
+See the [`@quonfig/react` README](https://github.com/quonfig/sdk-react#readme) for the full API
+(`useQuonfig`, `useFlag`, `QuonfigTestProvider`, etc.) and provider prop reference.
+
+## How the polyfills work
+
+The entry point is ten lines:
+
+```ts
+import "react-native-get-random-values";
+import { decode, encode } from "base-64";
+
+if (typeof global.btoa === "undefined") {
+  global.btoa = encode;
+}
+if (typeof global.atob === "undefined") {
+  global.atob = decode;
+}
+
+export * from "@quonfig/react";
+```
+
+- **`react-native-get-random-values`** polyfills `crypto.getRandomValues()`, which the `uuid`
+  package (used by `@quonfig/javascript` to generate the per-instance hash) requires.
+- **`base-64`** provides `btoa` / `atob`. `@quonfig/javascript`'s base64 helper assumes `btoa` is
+  available whenever `typeof window !== "undefined"`, which is true under React Native — but RN's JS
+  runtime does not ship `btoa` natively.
+
+## License
+
+ISC

package/dist/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+require('react-native-get-random-values');
+var base64 = require('base-64');
+var react = require('@quonfig/react');
+
+// src/index.ts
+if (typeof global.btoa === "undefined") {
+  global.btoa = base64.encode;
+}
+if (typeof global.atob === "undefined") {
+  global.atob = base64.decode;
+}
+
+Object.keys(react).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return react[k]; }
+  });
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["encode","decode"],"mappings":";;;;;;;AAGA,IAAI,OAAO,MAAA,CAAO,IAAA,KAAS,WAAA,EAAa;AACtC,EAAA,MAAA,CAAO,IAAA,GAAOA,aAAA;AAChB;AACA,IAAI,OAAO,MAAA,CAAO,IAAA,KAAS,WAAA,EAAa;AACtC,EAAA,MAAA,CAAO,IAAA,GAAOC,aAAA;AAChB","file":"index.cjs","sourcesContent":["import \"react-native-get-random-values\";\nimport { decode, encode } from \"base-64\";\n\nif (typeof global.btoa === \"undefined\") {\n  global.btoa = encode;\n}\nif (typeof global.atob === \"undefined\") {\n  global.atob = decode;\n}\n\nexport * from \"@quonfig/react\";\n"]}

package/dist/index.d.mts

@@ -0,0 +1 @@
+export * from '@quonfig/react';

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from '@quonfig/react';

package/dist/index.mjs

@@ -0,0 +1,13 @@
+import 'react-native-get-random-values';
+import { encode, decode } from 'base-64';
+export * from '@quonfig/react';
+
+// src/index.ts
+if (typeof global.btoa === "undefined") {
+  global.btoa = encode;
+}
+if (typeof global.atob === "undefined") {
+  global.atob = decode;
+}
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAGA,IAAI,OAAO,MAAA,CAAO,IAAA,KAAS,WAAA,EAAa;AACtC,EAAA,MAAA,CAAO,IAAA,GAAO,MAAA;AAChB;AACA,IAAI,OAAO,MAAA,CAAO,IAAA,KAAS,WAAA,EAAa;AACtC,EAAA,MAAA,CAAO,IAAA,GAAO,MAAA;AAChB","file":"index.mjs","sourcesContent":["import \"react-native-get-random-values\";\nimport { decode, encode } from \"base-64\";\n\nif (typeof global.btoa === \"undefined\") {\n  global.btoa = encode;\n}\nif (typeof global.atob === \"undefined\") {\n  global.atob = decode;\n}\n\nexport * from \"@quonfig/react\";\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "packageManager": "yarn@4.11.0",
+  "name": "@quonfig/react-native",
+  "version": "0.0.1",
+  "description": "React Native bindings for Quonfig — a thin polyfill wrapper around @quonfig/react",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quonfig/sdk-react-native.git"
+  },
+  "bugs": {
+    "url": "https://github.com/quonfig/sdk-react-native/issues"
+  },
+  "homepage": "https://github.com/quonfig/sdk-react-native#readme",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist/ && tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "prettier": "prettier . -l",
+    "prettier:fix": "prettier --write .",
+    "prettier:check": "prettier . -l",
+    "version": "prettier --write CHANGELOG.md README.md && git add CHANGELOG.md README.md"
+  },
+  "author": "Jeffrey Chupp",
+  "license": "ISC",
+  "keywords": [
+    "feature-flags",
+    "config",
+    "react-native"
+  ],
+  "dependencies": {
+    "base-64": "^1.0.0",
+    "react-native-get-random-values": "^1.11.0"
+  },
+  "peerDependencies": {
+    "@quonfig/react": ">=0.0.13",
+    "react": "^18 || ^19",
+    "react-native": ">=0.70"
+  },
+  "devDependencies": {
+    "@quonfig/react": "portal:../sdk-react",
+    "@types/base-64": "^1.0.2",
+    "@types/node": "^18.6.5",
+    "prettier": "^3.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.4.0"
+  }
+}