@zedtech/zedkit-flags 0.0.0-stage → 0.2.0

package/LICENSE

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

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @zedtech/zedkit-flags
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Thin helpers around [OpenFeature](https://openfeature.dev/) for typed registries, in-memory and JSON providers, server `getFlag`, React `useFlag`, and `localStorage` overrides for local dev.
+
+See [CATALOG.md](./CATALOG.md) for exports and examples.
+
+## Original work
+
+Original work by the same author.

package/dist/env-json.d.ts

@@ -0,0 +1,4 @@
+import { type FlagValue } from "./memory.js";
+export declare function parseFlagsJson(raw: string | undefined | null): Record<string, FlagValue>;
+export declare function loadFlagsFromEnv(env?: Record<string, string | undefined>, envVar?: string): Record<string, FlagValue>;
+//# sourceMappingURL=env-json.d.ts.map

package/dist/env-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-json.d.ts","sourceRoot":"","sources":["../src/env-json.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAYxF;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,MAAM,SAAsB,GAC3B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE3B"}

package/dist/env-json.js

@@ -0,0 +1,21 @@
+import { tryCatch } from "@zedtech/zedkit-core";
+const FLAG_VALUE = (value) => typeof value === "boolean" || typeof value === "string" || typeof value === "number";
+export function parseFlagsJson(raw) {
+    const trimmed = raw?.trim();
+    if (!trimmed)
+        return {};
+    const parsed = tryCatch(() => JSON.parse(trimmed));
+    if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null || Array.isArray(parsed.value)) {
+        return {};
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(parsed.value)) {
+        if (FLAG_VALUE(value))
+            out[key] = value;
+    }
+    return out;
+}
+export function loadFlagsFromEnv(env = process.env, envVar = "ZEDKIT_FLAGS_JSON") {
+    return parseFlagsJson(env[envVar]);
+}
+//# sourceMappingURL=env-json.js.map

package/dist/env-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-json.js","sourceRoot":"","sources":["../src/env-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD,MAAM,UAAU,GAAG,CAAC,KAAc,EAAsB,EAAE,CACxD,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF,MAAM,UAAU,cAAc,CAAC,GAA8B;IAC3D,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3G,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA0C,OAAO,CAAC,GAAG,EACrD,MAAM,GAAG,mBAAmB;IAE5B,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/get-flag.d.ts

@@ -0,0 +1,5 @@
+import type { Client } from "@openfeature/server-sdk";
+import type { FlagRegistry } from "./registry.js";
+import type { FlagValue } from "./memory.js";
+export declare function getFlag<T extends Record<string, FlagValue>, K extends keyof T & string>(client: Client, registry: FlagRegistry<T>, key: K): Promise<T[K]>;
+//# sourceMappingURL=get-flag.d.ts.map

package/dist/get-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-flag.d.ts","sourceRoot":"","sources":["../src/get-flag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAsB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAC3F,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,GAAG,EAAE,CAAC,GACL,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CASf"}

package/dist/get-flag.js

@@ -0,0 +1,11 @@
+export async function getFlag(client, registry, key) {
+    const defaultValue = registry.flags[key];
+    if (typeof defaultValue === "boolean") {
+        return (await client.getBooleanValue(key, defaultValue));
+    }
+    if (typeof defaultValue === "string") {
+        return (await client.getStringValue(key, defaultValue));
+    }
+    return (await client.getNumberValue(key, defaultValue));
+}
+//# sourceMappingURL=get-flag.js.map

package/dist/get-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-flag.js","sourceRoot":"","sources":["../src/get-flag.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAc,EACd,QAAyB,EACzB,GAAM;IAEN,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,CAAS,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,YAAY,CAAC,CAAS,CAAC;IAClE,CAAC;IACD,OAAO,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,YAAsB,CAAC,CAAS,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { OpenFeature, TypedInMemoryProvider } from "@openfeature/server-sdk";
+export type { Client, EvaluationContext, JsonValue, Provider } from "@openfeature/server-sdk";
+export { buildOpenFeatureFlagDefinitions, type FlagValue } from "./memory.js";
+export { createMemoryProvider } from "./server-provider.js";
+export { defineFlagRegistry, mergeFlagValues, type FlagRegistry } from "./registry.js";
+export { memoryProviderFromRegistry } from "./server-registry.js";
+export { getFlag } from "./get-flag.js";
+export { loadFlagsFromEnv, parseFlagsJson } from "./env-json.js";
+export { FLAG_OVERRIDE_STORAGE_KEY, flagOverridesSnapshot, mergeFlagValue, readFlagOverrides, subscribeFlagOverrides, writeFlagOverride, } from "./overrides.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE9F,OAAO,EAAE,+BAA+B,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { OpenFeature, TypedInMemoryProvider } from "@openfeature/server-sdk";
+export { buildOpenFeatureFlagDefinitions } from "./memory.js";
+export { createMemoryProvider } from "./server-provider.js";
+export { defineFlagRegistry, mergeFlagValues } from "./registry.js";
+export { memoryProviderFromRegistry } from "./server-registry.js";
+export { getFlag } from "./get-flag.js";
+export { loadFlagsFromEnv, parseFlagsJson } from "./env-json.js";
+export { FLAG_OVERRIDE_STORAGE_KEY, flagOverridesSnapshot, mergeFlagValue, readFlagOverrides, subscribeFlagOverrides, writeFlagOverride, } from "./overrides.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG7E,OAAO,EAAE,+BAA+B,EAAkB,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAqB,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,3 @@
+export type FlagValue = boolean | string | number;
+export declare function buildOpenFeatureFlagDefinitions(flags: Record<string, FlagValue>): Record<string, unknown>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB"}

package/dist/memory.js

@@ -0,0 +1,28 @@
+export function buildOpenFeatureFlagDefinitions(flags) {
+    const definitions = {};
+    for (const [key, value] of Object.entries(flags)) {
+        if (typeof value === "boolean") {
+            definitions[key] = {
+                variants: { on: true, off: false },
+                defaultVariant: value ? "on" : "off",
+                disabled: false,
+            };
+        }
+        else if (typeof value === "string") {
+            definitions[key] = {
+                variants: { value },
+                defaultVariant: "value",
+                disabled: false,
+            };
+        }
+        else {
+            definitions[key] = {
+                variants: { value },
+                defaultVariant: "value",
+                disabled: false,
+            };
+        }
+    }
+    return definitions;
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,+BAA+B,CAC7C,KAAgC;IAEhC,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,WAAW,CAAC,GAAG,CAAC,GAAG;gBACjB,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE;gBAClC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;gBACpC,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,WAAW,CAAC,GAAG,CAAC,GAAG;gBACjB,QAAQ,EAAE,EAAE,KAAK,EAAE;gBACnB,cAAc,EAAE,OAAO;gBACvB,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,GAAG;gBACjB,QAAQ,EAAE,EAAE,KAAK,EAAE;gBACnB,cAAc,EAAE,OAAO;gBACvB,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/overrides.d.ts

@@ -0,0 +1,8 @@
+import { type FlagValue } from "./memory.js";
+export declare const FLAG_OVERRIDE_STORAGE_KEY = "zedkit-flag-overrides";
+export declare function readFlagOverrides(storage: Pick<Storage, "getItem"> | null | undefined): Record<string, FlagValue>;
+export declare function flagOverridesSnapshot(storage: Pick<Storage, "getItem"> | null | undefined): Record<string, FlagValue>;
+export declare function writeFlagOverride(storage: Storage, flagKey: string, value: FlagValue | null): Record<string, FlagValue>;
+export declare function mergeFlagValue<T extends FlagValue>(flagKey: string, evaluated: T, overrides: Record<string, FlagValue>): T;
+export declare function subscribeFlagOverrides(onStoreChange: () => void): () => void;
+//# sourceMappingURL=overrides.d.ts.map

package/dist/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AASjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAejH;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAMrH;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,GAAG,IAAI,GACtB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAa3B;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAO1H;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAS5E"}

package/dist/overrides.js

@@ -0,0 +1,72 @@
+import { tryCatch } from "@zedtech/zedkit-core";
+export const FLAG_OVERRIDE_STORAGE_KEY = "zedkit-flag-overrides";
+let overrideSnapshot = {};
+let overrideSnapshotRaw = "";
+function invalidateOverrideSnapshot() {
+    overrideSnapshotRaw = "";
+}
+export function readFlagOverrides(storage) {
+    if (!storage)
+        return {};
+    const raw = storage.getItem(FLAG_OVERRIDE_STORAGE_KEY);
+    if (!raw?.trim())
+        return {};
+    const parsed = tryCatch(() => JSON.parse(raw));
+    if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null || Array.isArray(parsed.value)) {
+        return {};
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(parsed.value)) {
+        if (typeof value === "boolean" || typeof value === "string" || typeof value === "number") {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+export function flagOverridesSnapshot(storage) {
+    const raw = storage?.getItem(FLAG_OVERRIDE_STORAGE_KEY) ?? "";
+    if (raw === overrideSnapshotRaw)
+        return overrideSnapshot;
+    overrideSnapshotRaw = raw;
+    overrideSnapshot = readFlagOverrides(storage);
+    return overrideSnapshot;
+}
+export function writeFlagOverride(storage, flagKey, value) {
+    const current = readFlagOverrides(storage);
+    if (value === null) {
+        delete current[flagKey];
+    }
+    else {
+        current[flagKey] = value;
+    }
+    storage.setItem(FLAG_OVERRIDE_STORAGE_KEY, JSON.stringify(current));
+    invalidateOverrideSnapshot();
+    if (typeof globalThis.dispatchEvent === "function") {
+        globalThis.dispatchEvent(new Event("zedkit-flag-overrides"));
+    }
+    return current;
+}
+export function mergeFlagValue(flagKey, evaluated, overrides) {
+    if (!(flagKey in overrides))
+        return evaluated;
+    const override = overrides[flagKey];
+    if (typeof evaluated === "boolean" && typeof override === "boolean")
+        return override;
+    if (typeof evaluated === "string" && typeof override === "string")
+        return override;
+    if (typeof evaluated === "number" && typeof override === "number")
+        return override;
+    return evaluated;
+}
+export function subscribeFlagOverrides(onStoreChange) {
+    if (typeof globalThis.addEventListener !== "function")
+        return () => { };
+    const handler = () => onStoreChange();
+    globalThis.addEventListener("storage", handler);
+    globalThis.addEventListener("zedkit-flag-overrides", handler);
+    return () => {
+        globalThis.removeEventListener("storage", handler);
+        globalThis.removeEventListener("zedkit-flag-overrides", handler);
+    };
+}
+//# sourceMappingURL=overrides.js.map

package/dist/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"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"}

package/dist/react.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+import { type FlagRegistry } from "./registry.js";
+import { type FlagValue } from "./memory.js";
+export { OpenFeatureProvider, useBooleanFlagValue, useNumberFlagValue, useStringFlagValue } from "@openfeature/react-sdk";
+export { OpenFeature, TypedInMemoryProvider } from "@openfeature/web-sdk";
+export type ZedkitFlagsProviderProps<T extends Record<string, FlagValue>> = {
+    registry: FlagRegistry<T>;
+    children: ReactNode;
+};
+export declare function ZedkitFlagsProvider<T extends Record<string, FlagValue>>({ registry, children, }: ZedkitFlagsProviderProps<T>): ReactNode;
+export declare function useFlag(flagKey: string, defaultValue: boolean): boolean;
+export { defineFlagRegistry, type FlagRegistry } from "./registry.js";
+export { writeFlagOverride, FLAG_OVERRIDE_STORAGE_KEY } from "./overrides.js";
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC1H,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI;IAC1E,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EACvE,QAAQ,EACR,QAAQ,GACT,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,SAAS,CAYzC;AAcD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAIvE;AAED,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/react.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { OpenFeatureProvider, useBooleanFlagValue } from "@openfeature/react-sdk";
+import { OpenFeature, TypedInMemoryProvider } from "@openfeature/web-sdk";
+import { useEffect, useMemo, useState } from "react";
+import { buildOpenFeatureFlagDefinitions } from "./memory.js";
+import { mergeFlagValue, flagOverridesSnapshot, subscribeFlagOverrides } from "./overrides.js";
+export { OpenFeatureProvider, useBooleanFlagValue, useNumberFlagValue, useStringFlagValue } from "@openfeature/react-sdk";
+export { OpenFeature, TypedInMemoryProvider } from "@openfeature/web-sdk";
+export function ZedkitFlagsProvider({ registry, children, }) {
+    const provider = useMemo(() => new TypedInMemoryProvider(buildOpenFeatureFlagDefinitions(registry.flags)), [registry]);
+    useEffect(() => {
+        OpenFeature.setProvider(provider);
+    }, [provider]);
+    return _jsx(OpenFeatureProvider, { children: children });
+}
+function useFlagOverrides() {
+    const [overrides, setOverrides] = useState(() => flagOverridesSnapshot(typeof localStorage === "undefined" ? null : localStorage));
+    useEffect(() => {
+        return subscribeFlagOverrides(() => {
+            setOverrides(flagOverridesSnapshot(typeof localStorage === "undefined" ? null : localStorage));
+        });
+    }, []);
+    return overrides;
+}
+export function useFlag(flagKey, defaultValue) {
+    const evaluated = useBooleanFlagValue(flagKey, defaultValue);
+    const overrides = useFlagOverrides();
+    return mergeFlagValue(flagKey, evaluated, overrides);
+}
+export { defineFlagRegistry } from "./registry.js";
+export { writeFlagOverride, FLAG_OVERRIDE_STORAGE_KEY } from "./overrides.js";
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAErE,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAI/F,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC1H,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAO1E,MAAM,UAAU,mBAAmB,CAAsC,EACvE,QAAQ,EACR,QAAQ,GACoB;IAC5B,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CACH,IAAI,qBAAqB,CACvB,+BAA+B,CAAC,QAAQ,CAAC,KAAK,CAA2D,CAC1G,EACH,CAAC,QAAQ,CAAC,CACX,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACf,OAAO,KAAC,mBAAmB,cAAE,QAAQ,GAAuB,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC9C,qBAAqB,CAAC,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CACjF,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,sBAAsB,CAAC,GAAG,EAAE;YACjC,YAAY,CAAC,qBAAqB,CAAC,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACjG,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,YAAqB;IAC5D,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,OAAO,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAqB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,7 @@
+import { type FlagValue } from "./memory.js";
+export type FlagRegistry<T extends Record<string, FlagValue>> = {
+    flags: T;
+};
+export declare function defineFlagRegistry<const T extends Record<string, FlagValue>>(flags: T): FlagRegistry<T>;
+export declare function mergeFlagValues<T extends Record<string, FlagValue>>(registry: FlagRegistry<T>, overrides: Record<string, FlagValue>): Record<string, FlagValue>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI;IAC9D,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAEvG;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE3B"}

package/dist/registry.js

@@ -0,0 +1,7 @@
+export function defineFlagRegistry(flags) {
+    return { flags };
+}
+export function mergeFlagValues(registry, overrides) {
+    return { ...registry.flags, ...overrides };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,kBAAkB,CAA4C,KAAQ;IACpF,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAyB,EACzB,SAAoC;IAEpC,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;AAC7C,CAAC"}

package/dist/server-provider.d.ts

@@ -0,0 +1,4 @@
+import { TypedInMemoryProvider } from "@openfeature/server-sdk";
+import { type FlagValue } from "./memory.js";
+export declare function createMemoryProvider(flags: Record<string, FlagValue>): TypedInMemoryProvider<Record<string, Record<string, boolean> | Record<string, string> | Record<string, number> | Record<string, import("@openfeature/server-sdk").JsonValue>>>;
+//# sourceMappingURL=server-provider.d.ts.map

package/dist/server-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-provider.d.ts","sourceRoot":"","sources":["../src/server-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,kLAIpE"}

package/dist/server-provider.js

@@ -0,0 +1,6 @@
+import { TypedInMemoryProvider } from "@openfeature/server-sdk";
+import { buildOpenFeatureFlagDefinitions } from "./memory.js";
+export function createMemoryProvider(flags) {
+    return new TypedInMemoryProvider(buildOpenFeatureFlagDefinitions(flags));
+}
+//# sourceMappingURL=server-provider.js.map

package/dist/server-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-provider.js","sourceRoot":"","sources":["../src/server-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,+BAA+B,EAAkB,MAAM,aAAa,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,OAAO,IAAI,qBAAqB,CAC9B,+BAA+B,CAAC,KAAK,CAA2D,CACjG,CAAC;AACJ,CAAC"}

package/dist/server-registry.d.ts

@@ -0,0 +1,4 @@
+import { type FlagRegistry } from "./registry.js";
+import { type FlagValue } from "./memory.js";
+export declare function memoryProviderFromRegistry<T extends Record<string, FlagValue>>(registry: FlagRegistry<T>): import("@openfeature/server-sdk").TypedInMemoryProvider<Record<string, Record<string, boolean> | Record<string, string> | Record<string, number> | Record<string, import("@openfeature/server-sdk").JsonValue>>>;
+//# sourceMappingURL=server-registry.d.ts.map

package/dist/server-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.d.ts","sourceRoot":"","sources":["../src/server-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,oNAExG"}

package/dist/server-registry.js

@@ -0,0 +1,5 @@
+import { createMemoryProvider } from "./server-provider.js";
+export function memoryProviderFromRegistry(registry) {
+    return createMemoryProvider(registry.flags);
+}
+//# sourceMappingURL=server-registry.js.map

package/dist/server-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-registry.js","sourceRoot":"","sources":["../src/server-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D,MAAM,UAAU,0BAA0B,CAAsC,QAAyB;IACvG,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@zedtech/zedkit-flags",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "Typed flag registry, server evaluation, React hooks, JSON/env providers, and local override storage for dev. Original work by the same author.",
+  "keywords": [
+    "feature-flags",
+    "openfeature",
+    "react",
+    "typescript",
+    "server"
+  ],
+  "homepage": "https://github.com/zedtech-fr/zedkit/tree/main/packages/flags",
+  "bugs": {
+    "url": "https://github.com/zedtech-fr/zedkit/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zedtech-fr/zedkit",
+    "directory": "packages/flags"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "imports": {
+    "#*": "./src/*"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@openfeature/react-sdk": "1.4.1",
+    "@openfeature/server-sdk": "1.23.0",
+    "@openfeature/web-sdk": "1.10.0",
+    "react": "19.3.1"
+  },
+  "peerDependenciesMeta": {
+    "@openfeature/react-sdk": {
+      "optional": true
+    },
+    "@openfeature/web-sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@zedtech/zedkit-core": "0.2.0"
+  },
+  "devDependencies": {
+    "@openfeature/react-sdk": "1.4.1",
+    "@openfeature/server-sdk": "1.23.0",
+    "@openfeature/web-sdk": "1.10.0",
+    "@testing-library/react": "16.3.3",
+    "@testing-library/user-event": "14.6.8",
+    "@types/node": "26.6.5",
+    "@types/react": "19.3.0",
+    "jsdom": "30.1.3",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "typescript": "5.9.3",
+    "vitest": "5.0.5",
+    "@zedtech/zedkit-quality": "0.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.tests.json",
+    "lint": "eslint src tests"
+  }
 }