@getflaggy/sdk 0.1.0

package/dist/react.mjs

@@ -0,0 +1,95 @@
+import {
+  FlaggyClient
+} from "./chunk-HBGNXCEV.mjs";
+
+// src/react/FlaggyProvider.tsx
+import { useEffect, useRef, useState, useMemo } from "react";
+
+// src/react/context.ts
+import { createContext } from "react";
+var FlaggyReactContext = createContext(null);
+
+// src/react/FlaggyProvider.tsx
+import { jsx } from "react/jsx-runtime";
+function FlaggyProvider({
+  serverUrl,
+  apiKey,
+  context,
+  enableStreaming,
+  onError,
+  children
+}) {
+  const clientRef = useRef(null);
+  const [ready, setReady] = useState(false);
+  const [error, setError] = useState(null);
+  const [, setVersion] = useState(0);
+  useEffect(() => {
+    const client = new FlaggyClient({
+      serverUrl,
+      apiKey,
+      context,
+      enableStreaming
+    });
+    clientRef.current = client;
+    setReady(false);
+    setError(null);
+    const unsubReady = client.on("ready", () => setReady(true));
+    const unsubError = client.on("error", (err) => {
+      setError(err);
+      onError?.(err);
+    });
+    const unsubChange = client.on("change", () => {
+      setVersion((v) => v + 1);
+    });
+    client.initialize();
+    return () => {
+      unsubReady();
+      unsubError();
+      unsubChange();
+      client.destroy();
+      clientRef.current = null;
+    };
+  }, [serverUrl, apiKey]);
+  const contextKey = context ? JSON.stringify(context) : "";
+  useEffect(() => {
+    if (clientRef.current && context && clientRef.current.ready) {
+      clientRef.current.setContext(context);
+    }
+  }, [contextKey]);
+  const value = useMemo(
+    () => clientRef.current ? { client: clientRef.current, ready, error } : null,
+    [ready, error]
+  );
+  if (!value) return null;
+  return /* @__PURE__ */ jsx(FlaggyReactContext.Provider, { value, children });
+}
+
+// src/react/useFlag.ts
+import { useContext } from "react";
+function useFlag(key, defaultValue) {
+  const ctx = useContext(FlaggyReactContext);
+  if (!ctx) {
+    return defaultValue;
+  }
+  return ctx.client.getFlag(key, defaultValue);
+}
+
+// src/react/useFlaggy.ts
+import { useContext as useContext2 } from "react";
+function useFlaggy() {
+  const ctx = useContext2(FlaggyReactContext);
+  if (!ctx) {
+    throw new Error("[flaggy] useFlaggy() must be used within a <FlaggyProvider>.");
+  }
+  return {
+    client: ctx.client,
+    ready: ctx.ready,
+    error: ctx.error
+  };
+}
+export {
+  FlaggyProvider,
+  useFlag,
+  useFlaggy
+};
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/FlaggyProvider.tsx","../src/react/context.ts","../src/react/useFlag.ts","../src/react/useFlaggy.ts"],"sourcesContent":["import { useEffect, useRef, useState, useMemo, type ReactNode } from 'react';\nimport { FlaggyClient } from '../client';\nimport { FlaggyReactContext } from './context';\nimport type { FlaggyContext } from '../types';\n\nexport interface FlaggyProviderProps {\n  serverUrl: string;\n  apiKey: string;\n  context?: FlaggyContext;\n  enableStreaming?: boolean;\n  /** Called when an error occurs (init failure, SSE error, etc.) */\n  onError?: (error: Error) => void;\n  children: ReactNode;\n}\n\nexport function FlaggyProvider({\n  serverUrl,\n  apiKey,\n  context,\n  enableStreaming,\n  onError,\n  children,\n}: FlaggyProviderProps) {\n  const clientRef = useRef<FlaggyClient | null>(null);\n  const [ready, setReady] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [, setVersion] = useState(0);\n\n  // Create and initialize client when serverUrl or apiKey change\n  useEffect(() => {\n    const client = new FlaggyClient({\n      serverUrl,\n      apiKey,\n      context,\n      enableStreaming,\n    });\n    clientRef.current = client;\n    setReady(false);\n    setError(null);\n\n    const unsubReady = client.on('ready', () => setReady(true));\n    const unsubError = client.on('error', (err) => {\n      setError(err);\n      onError?.(err);\n    });\n    const unsubChange = client.on('change', () => {\n      setVersion((v) => v + 1);\n    });\n\n    client.initialize();\n\n    return () => {\n      unsubReady();\n      unsubError();\n      unsubChange();\n      client.destroy();\n      clientRef.current = null;\n    };\n  }, [serverUrl, apiKey]);\n\n  // Update context when it changes (deep comparison via JSON.stringify)\n  const contextKey = context ? JSON.stringify(context) : '';\n  useEffect(() => {\n    if (clientRef.current && context && clientRef.current.ready) {\n      clientRef.current.setContext(context);\n    }\n  }, [contextKey]);\n\n  const value = useMemo(\n    () =>\n      clientRef.current\n        ? { client: clientRef.current, ready, error }\n        : null,\n    [ready, error],\n  );\n\n  if (!value) return null;\n\n  return (\n    <FlaggyReactContext.Provider value={value}>\n      {children}\n    </FlaggyReactContext.Provider>\n  );\n}\n","import { createContext } from 'react';\nimport type { FlaggyClient } from '../client';\n\nexport interface FlaggyContextValue {\n  client: FlaggyClient;\n  ready: boolean;\n  error: Error | null;\n}\n\nexport const FlaggyReactContext = createContext<FlaggyContextValue | null>(null);\n","import { useContext } from 'react';\nimport { FlaggyReactContext } from './context';\nimport type { FlagValue } from '../types';\n\nexport function useFlag<T extends FlagValue>(key: string, defaultValue: T): T {\n  const ctx = useContext(FlaggyReactContext);\n\n  if (!ctx) {\n    return defaultValue;\n  }\n\n  return ctx.client.getFlag(key, defaultValue);\n}\n","import { useContext } from 'react';\nimport { FlaggyReactContext } from './context';\n\nexport function useFlaggy() {\n  const ctx = useContext(FlaggyReactContext);\n\n  if (!ctx) {\n    throw new Error('[flaggy] useFlaggy() must be used within a <FlaggyProvider>.');\n  }\n\n  return {\n    client: ctx.client,\n    ready: ctx.ready,\n    error: ctx.error,\n  };\n}\n"],"mappings":";;;;;AAAA,SAAS,WAAW,QAAQ,UAAU,eAA+B;;;ACArE,SAAS,qBAAqB;AASvB,IAAM,qBAAqB,cAAyC,IAAI;;;ADsE3E;AAhEG,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwB;AACtB,QAAM,YAAY,OAA4B,IAAI;AAClD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,KAAK;AACxC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AACrD,QAAM,CAAC,EAAE,UAAU,IAAI,SAAS,CAAC;AAGjC,YAAU,MAAM;AACd,UAAM,SAAS,IAAI,aAAa;AAAA,MAC9B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,cAAU,UAAU;AACpB,aAAS,KAAK;AACd,aAAS,IAAI;AAEb,UAAM,aAAa,OAAO,GAAG,SAAS,MAAM,SAAS,IAAI,CAAC;AAC1D,UAAM,aAAa,OAAO,GAAG,SAAS,CAAC,QAAQ;AAC7C,eAAS,GAAG;AACZ,gBAAU,GAAG;AAAA,IACf,CAAC;AACD,UAAM,cAAc,OAAO,GAAG,UAAU,MAAM;AAC5C,iBAAW,CAAC,MAAM,IAAI,CAAC;AAAA,IACzB,CAAC;AAED,WAAO,WAAW;AAElB,WAAO,MAAM;AACX,iBAAW;AACX,iBAAW;AACX,kBAAY;AACZ,aAAO,QAAQ;AACf,gBAAU,UAAU;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,WAAW,MAAM,CAAC;AAGtB,QAAM,aAAa,UAAU,KAAK,UAAU,OAAO,IAAI;AACvD,YAAU,MAAM;AACd,QAAI,UAAU,WAAW,WAAW,UAAU,QAAQ,OAAO;AAC3D,gBAAU,QAAQ,WAAW,OAAO;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,QAAQ;AAAA,IACZ,MACE,UAAU,UACN,EAAE,QAAQ,UAAU,SAAS,OAAO,MAAM,IAC1C;AAAA,IACN,CAAC,OAAO,KAAK;AAAA,EACf;AAEA,MAAI,CAAC,MAAO,QAAO;AAEnB,SACE,oBAAC,mBAAmB,UAAnB,EAA4B,OAC1B,UACH;AAEJ;;;AEnFA,SAAS,kBAAkB;AAIpB,SAAS,QAA6B,KAAa,cAAoB;AAC5E,QAAM,MAAM,WAAW,kBAAkB;AAEzC,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,OAAO,QAAQ,KAAK,YAAY;AAC7C;;;ACZA,SAAS,cAAAA,mBAAkB;AAGpB,SAAS,YAAY;AAC1B,QAAM,MAAMC,YAAW,kBAAkB;AAEzC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,8DAA8D;AAAA,EAChF;AAEA,SAAO;AAAA,IACL,QAAQ,IAAI;AAAA,IACZ,OAAO,IAAI;AAAA,IACX,OAAO,IAAI;AAAA,EACb;AACF;","names":["useContext","useContext"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@getflaggy/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "JavaScript/React SDK for the Flaggy feature flag server",
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.mts",
+        "default": "./dist/react.mjs"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}