@swan-io/shared-business 15.1.2 → 15.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swan-io/shared-business",
-  "version": "15.1.2",
+  "version": "15.2.0",
   "engines": {
     "node": ">22.12.0"
   },
@@ -28,7 +28,7 @@
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "react-native-web": ">=0.21.2",
-    "@swan-io/lake": "15.1.2"
+    "@swan-io/lake": "15.2.0"
   },
   "dependencies": {
     "@formatjs/intl": "^4.1.11",
@@ -40,6 +40,7 @@
     "iban": "^0.0.14",
     "react-atomic-state": "^2.1.0",
     "react-dropzone": "^15.0.0",
+    "prism-react-renderer": "^2.4.1",
     "rifm": "^0.12.1",
     "ts-pattern": "^5.9.0",
     "uuid": "^14.0.0"
@@ -49,10 +50,10 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/react-native": "^0.72.8",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "react-native-web": "^0.21.2",
     "type-fest": "^5.6.0",
-    "@swan-io/lake": "15.1.2"
+    "@swan-io/lake": "15.2.0"
   }
 }

package/src/utils/flags.d.ts

@@ -0,0 +1,19 @@
+import { Future, Result } from "@swan-io/boxed";
+import { ReactNode } from "react";
+export declare class FlagClient<Flags extends Record<string, unknown>, Context extends Record<string, string | number | boolean>> {
+    private readonly url;
+    private context;
+    private listeners;
+    constructor(url: string, initialContext?: Partial<Context>);
+    addListener(listener: (flags: Flags) => void): void;
+    removeListener(listener: (flags: Flags) => void): void;
+    setContext(context: Partial<Context>): void;
+    fetchFlags(): Future<Result<Flags, unknown>>;
+}
+export declare const createFlagsProvider: <Flags extends Record<string, unknown>, Context extends Record<string, string | number | boolean>>(client: FlagClient<Flags, Context>, flagDefaults: Flags) => {
+    FlagsProvider: ({ children, loader }: {
+        children: ReactNode;
+        loader?: ReactNode;
+    }) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null;
+    useFlag: <K extends keyof Flags>(flagName: K) => Flags[K];
+};

package/src/utils/flags.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Request } from "@swan-io/request";
+import { createContext, useContext, useEffect, useState } from "react";
+export class FlagClient {
+    constructor(url, initialContext = {}) {
+        this.listeners = [];
+        this.url = url;
+        this.context = initialContext;
+    }
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    removeListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index !== -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    setContext(context) {
+        this.context = {
+            ...this.context,
+            ...context,
+        };
+        // reload flags when context changes
+        this.fetchFlags();
+    }
+    fetchFlags() {
+        const queryParams = new URLSearchParams(this.context).toString();
+        return Request.make({
+            url: `${this.url}?${queryParams}`,
+            method: "GET",
+            type: "json",
+        })
+            .mapOk(response => response.response.getOr({}))
+            .tapOk(flags => {
+            this.listeners.forEach(listener => listener(flags));
+        });
+    }
+}
+export const createFlagsProvider = (client, flagDefaults) => {
+    const FlagsContext = createContext(null);
+    return {
+        FlagsProvider: ({ children, loader = null }) => {
+            const [flags, setFlags] = useState(null);
+            // biome-ignore lint/correctness/useExhaustiveDependencies: we need to run this effect only once, when the component is mounted
+            useEffect(() => {
+                const listener = (flags) => {
+                    setFlags(flags);
+                };
+                client.addListener(listener);
+                const future = client.fetchFlags().tapError(() => {
+                    // If fetching flags fails, we still want to provide the default flags to avoid breaking the app
+                    setFlags(flagDefaults);
+                });
+                return () => {
+                    client.removeListener(listener);
+                    future.cancel();
+                };
+            }, []);
+            if (flags == null) {
+                return loader;
+            }
+            return _jsx(FlagsContext.Provider, { value: flags, children: children });
+        },
+        useFlag: (flagName) => {
+            var _a;
+            const flags = useContext(FlagsContext);
+            return (_a = flags === null || flags === void 0 ? void 0 : flags[flagName]) !== null && _a !== void 0 ? _a : flagDefaults[flagName];
+        },
+    };
+};