@flagdown/react 0.0.4 → 0.0.5

package/README.md

@@ -3,7 +3,7 @@
 Use the `Feature` component to switch between new UI and a fallback in React 18+.
 
 ```sh
-npm install @flagdown/react@0.0.4
+npm install @flagdown/react@0.0.5
 ```
 
 ```tsx
@@ -57,3 +57,13 @@ apps using it. Client-side flags are not an authorization boundary.
 are internal; the package exposes no flag hooks or direct evaluation functions.
 Use `FlagdownProvider` to configure your project. A provider without project
 configuration renders each feature's fallback.
+
+API transport types are generated from `openapi/flagdown-api.json` with
+`openapi-typescript` before SDK typechecking and building. They stay internal;
+the public exports remain `Feature`, `FlagdownProvider` and their prop types.
+The runtime still rejects malformed or non-boolean flag values.
+
+For SDK development, run `npm run --workspace @flagdown/react generate:types`
+to regenerate `src/generated/api.d.ts`. This file is ignored by git and is never
+the source of truth. Backend CI checks candidate contracts against the current
+SDK before publishing the generated specification to this repository.

package/dist/index.js

@@ -21,19 +21,28 @@ var disabledFlagEvaluator = {
   isEnabled: () => false
 };
 
+// src/api-types.ts
+var clientFlagsPath = "/v1/client/flags";
+
 // src/remote.ts
 async function fetchFlagState(apiUrl, clientToken, signal) {
-  const response = await fetch(apiUrl.replace(/\/$/, "") + "/v1/client/flags", {
-    headers: { "x-flagdown-client-token": clientToken },
+  const headers = { "x-flagdown-client-token": clientToken };
+  const response = await fetch(apiUrl.replace(/\/$/, "") + clientFlagsPath, {
+    headers,
     cache: "no-store",
     signal
   });
   if (!response.ok) throw new Error(`Flagdown request failed (${response.status})`);
   const data = await response.json();
-  if (!data || typeof data !== "object" || !("flags" in data) || !data.flags || typeof data.flags !== "object" || Array.isArray(data.flags) || Object.values(data.flags).some((value) => typeof value !== "boolean")) {
+  if (!data || typeof data !== "object" || !("flags" in data) || !data.flags || typeof data.flags !== "object" || Array.isArray(data.flags)) {
     throw new Error("Invalid Flagdown response");
   }
-  return data.flags;
+  const flags = Object.fromEntries(Object.entries(data.flags).map(([key, enabled]) => {
+    if (typeof enabled !== "boolean") throw new Error("Invalid Flagdown response");
+    return [key, enabled];
+  }));
+  const result = { flags };
+  return result.flags;
 }
 
 // src/FlagdownProvider.tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flagdown/react",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "license": "MIT",
   "type": "module",
   "description": "React SDK for evaluating Flagdown feature flags.",
@@ -28,9 +28,10 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "generate:types": "node scripts/generate-api-types.mjs",
+    "build": "node scripts/generate-api-types.mjs && tsup src/index.ts --format esm --dts --clean",
     "test": "bun test",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "node scripts/generate-api-types.mjs && tsc --noEmit"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -38,6 +39,7 @@
   },
   "devDependencies": {
     "@types/react": "^18",
+    "openapi-typescript": "7.13.0",
     "react": "^18",
     "react-dom": "^18",
     "tsup": "^8",