@augmenting-integrations/flags 0.2.1 → 1.0.0

package/dist/createFlags.cjs

@@ -0,0 +1,108 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var createFlags_exports = {};
+__export(createFlags_exports, {
+  createFlags: () => createFlags
+});
+module.exports = __toCommonJS(createFlags_exports);
+var import_react = require("react");
+const EMPTY = Object.freeze({});
+function createFlags(opts) {
+  const { flags, storageKey } = opts;
+  const eventName = `flags:changed:${storageKey}`;
+  let cachedRaw = void 0;
+  let cachedSnapshot = {};
+  function readSnapshot() {
+    if (typeof window === "undefined") return EMPTY;
+    let raw;
+    try {
+      raw = window.localStorage.getItem(storageKey);
+    } catch {
+      return cachedSnapshot;
+    }
+    if (raw === cachedRaw) return cachedSnapshot;
+    cachedRaw = raw;
+    try {
+      cachedSnapshot = raw ? JSON.parse(raw) : {};
+    } catch {
+      cachedSnapshot = {};
+    }
+    return cachedSnapshot;
+  }
+  function writeOverrides(next) {
+    if (typeof window === "undefined") return;
+    const json = JSON.stringify(next);
+    try {
+      window.localStorage.setItem(storageKey, json);
+    } catch {
+    }
+    cachedRaw = json;
+    cachedSnapshot = next;
+    window.dispatchEvent(new Event(eventName));
+  }
+  function subscribe(callback) {
+    if (typeof window === "undefined") return () => {
+    };
+    const handler = () => {
+      cachedRaw = void 0;
+      callback();
+    };
+    window.addEventListener(eventName, handler);
+    window.addEventListener("storage", handler);
+    return () => {
+      window.removeEventListener(eventName, handler);
+      window.removeEventListener("storage", handler);
+    };
+  }
+  function getServerSnapshot() {
+    return EMPTY;
+  }
+  function useFlag(key) {
+    const overrides = (0, import_react.useSyncExternalStore)(subscribe, readSnapshot, getServerSnapshot);
+    if (key in overrides) return overrides[key];
+    const def = flags[key];
+    return def.default;
+  }
+  function setFlag(key, value) {
+    const current = typeof window === "undefined" ? {} : { ...readSnapshot() };
+    current[key] = value;
+    writeOverrides(current);
+  }
+  function resetFlag(key) {
+    const current = typeof window === "undefined" ? {} : { ...readSnapshot() };
+    delete current[key];
+    writeOverrides(current);
+  }
+  function resetAllFlags() {
+    writeOverrides({});
+  }
+  function listFlags() {
+    return Object.entries(flags).map(([key, def]) => ({
+      key,
+      ...def
+    }));
+  }
+  return { useFlag, setFlag, resetFlag, resetAllFlags, listFlags };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFlags
+});
+//# sourceMappingURL=createFlags.cjs.map

package/dist/createFlags.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createFlags.tsx"],"sourcesContent":["\"use client\";\n\nimport { useSyncExternalStore } from \"react\";\nimport type { FlagDef, FlagsMap } from \"./index.js\";\n\ntype Overrides = Record<string, unknown>;\n\nconst EMPTY: Overrides = Object.freeze({}) as Overrides;\n\n/**\n * Build a per-app flag system. Each consuming app calls this once with its\n * own flag definitions and a unique localStorage namespace. Returns a hook\n * + helpers + a studio panel scoped to those flags.\n */\nexport function createFlags<F extends FlagsMap>(opts: { flags: F; storageKey: string }) {\n  const { flags, storageKey } = opts;\n  const eventName = `flags:changed:${storageKey}`;\n\n  // Cache for stable getSnapshot reference (required by useSyncExternalStore).\n  let cachedRaw: string | null | undefined = undefined;\n  let cachedSnapshot: Overrides = {};\n\n  function readSnapshot(): Overrides {\n    if (typeof window === \"undefined\") return EMPTY;\n    let raw: string | null;\n    try {\n      raw = window.localStorage.getItem(storageKey);\n    } catch {\n      return cachedSnapshot;\n    }\n    if (raw === cachedRaw) return cachedSnapshot;\n    cachedRaw = raw;\n    try {\n      cachedSnapshot = raw ? (JSON.parse(raw) as Overrides) : {};\n    } catch {\n      cachedSnapshot = {};\n    }\n    return cachedSnapshot;\n  }\n\n  function writeOverrides(next: Overrides) {\n    if (typeof window === \"undefined\") return;\n    const json = JSON.stringify(next);\n    try {\n      window.localStorage.setItem(storageKey, json);\n    } catch {\n      // ignore quota / private mode errors\n    }\n    cachedRaw = json;\n    cachedSnapshot = next;\n    window.dispatchEvent(new Event(eventName));\n  }\n\n  function subscribe(callback: () => void) {\n    if (typeof window === \"undefined\") return () => {};\n    const handler = () => {\n      cachedRaw = undefined;\n      callback();\n    };\n    window.addEventListener(eventName, handler);\n    window.addEventListener(\"storage\", handler);\n    return () => {\n      window.removeEventListener(eventName, handler);\n      window.removeEventListener(\"storage\", handler);\n    };\n  }\n\n  function getServerSnapshot(): Overrides {\n    return EMPTY;\n  }\n\n  type FlagKey = keyof F & string;\n\n  function useFlag<T = unknown>(key: FlagKey): T {\n    const overrides = useSyncExternalStore(subscribe, readSnapshot, getServerSnapshot);\n    if (key in overrides) return overrides[key] as T;\n    const def = flags[key] as FlagDef;\n    return def.default as T;\n  }\n\n  function setFlag(key: FlagKey, value: unknown) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    current[key] = value;\n    writeOverrides(current);\n  }\n\n  function resetFlag(key: FlagKey) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    delete current[key];\n    writeOverrides(current);\n  }\n\n  function resetAllFlags() {\n    writeOverrides({});\n  }\n\n  function listFlags() {\n    return Object.entries(flags).map(([key, def]) => ({\n      key,\n      ...(def as FlagDef),\n    }));\n  }\n\n  return { useFlag, setFlag, resetFlag, resetAllFlags, listFlags };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAqC;AAKrC,MAAM,QAAmB,OAAO,OAAO,CAAC,CAAC;AAOlC,SAAS,YAAgC,MAAwC;AACtF,QAAM,EAAE,OAAO,WAAW,IAAI;AAC9B,QAAM,YAAY,iBAAiB,UAAU;AAG7C,MAAI,YAAuC;AAC3C,MAAI,iBAA4B,CAAC;AAEjC,WAAS,eAA0B;AACjC,QAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAI;AACJ,QAAI;AACF,YAAM,OAAO,aAAa,QAAQ,UAAU;AAAA,IAC9C,QAAQ;AACN,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,UAAW,QAAO;AAC9B,gBAAY;AACZ,QAAI;AACF,uBAAiB,MAAO,KAAK,MAAM,GAAG,IAAkB,CAAC;AAAA,IAC3D,QAAQ;AACN,uBAAiB,CAAC;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAEA,WAAS,eAAe,MAAiB;AACvC,QAAI,OAAO,WAAW,YAAa;AACnC,UAAM,OAAO,KAAK,UAAU,IAAI;AAChC,QAAI;AACF,aAAO,aAAa,QAAQ,YAAY,IAAI;AAAA,IAC9C,QAAQ;AAAA,IAER;AACA,gBAAY;AACZ,qBAAiB;AACjB,WAAO,cAAc,IAAI,MAAM,SAAS,CAAC;AAAA,EAC3C;AAEA,WAAS,UAAU,UAAsB;AACvC,QAAI,OAAO,WAAW,YAAa,QAAO,MAAM;AAAA,IAAC;AACjD,UAAM,UAAU,MAAM;AACpB,kBAAY;AACZ,eAAS;AAAA,IACX;AACA,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,MAAM;AACX,aAAO,oBAAoB,WAAW,OAAO;AAC7C,aAAO,oBAAoB,WAAW,OAAO;AAAA,IAC/C;AAAA,EACF;AAEA,WAAS,oBAA+B;AACtC,WAAO;AAAA,EACT;AAIA,WAAS,QAAqB,KAAiB;AAC7C,UAAM,gBAAY,mCAAqB,WAAW,cAAc,iBAAiB;AACjF,QAAI,OAAO,UAAW,QAAO,UAAU,GAAG;AAC1C,UAAM,MAAM,MAAM,GAAG;AACrB,WAAO,IAAI;AAAA,EACb;AAEA,WAAS,QAAQ,KAAc,OAAgB;AAC7C,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,YAAQ,GAAG,IAAI;AACf,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,UAAU,KAAc;AAC/B,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,WAAO,QAAQ,GAAG;AAClB,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,gBAAgB;AACvB,mBAAe,CAAC,CAAC;AAAA,EACnB;AAEA,WAAS,YAAY;AACnB,WAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,OAAO;AAAA,MAChD;AAAA,MACA,GAAI;AAAA,IACN,EAAE;AAAA,EACJ;AAEA,SAAO,EAAE,SAAS,SAAS,WAAW,eAAe,UAAU;AACjE;","names":[]}

package/dist/{index.mjs → createFlags.js}

@@ -1,6 +1,6 @@
-// src/createFlags.tsx
+"use client";
 import { useSyncExternalStore } from "react";
-var EMPTY = Object.freeze({});
+const EMPTY = Object.freeze({});
 function createFlags(opts) {
   const { flags, storageKey } = opts;
   const eventName = `flags:changed:${storageKey}`;
@@ -81,4 +81,4 @@ function createFlags(opts) {
 export {
   createFlags
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=createFlags.js.map

package/dist/{index.mjs.map → createFlags.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/createFlags.tsx"],"sourcesContent":["\"use client\";\n\nimport { useSyncExternalStore } from \"react\";\nimport type { FlagDef, FlagsMap } from \"./index.js\";\n\ntype Overrides = Record<string, unknown>;\n\nconst EMPTY: Overrides = Object.freeze({}) as Overrides;\n\n/**\n * Build a per-app flag system. Each consuming app calls this once with its\n * own flag definitions and a unique localStorage namespace. Returns a hook\n * + helpers + a studio panel scoped to those flags.\n */\nexport function createFlags<F extends FlagsMap>(opts: { flags: F; storageKey: string }) {\n  const { flags, storageKey } = opts;\n  const eventName = `flags:changed:${storageKey}`;\n\n  // Cache for stable getSnapshot reference (required by useSyncExternalStore).\n  let cachedRaw: string | null | undefined = undefined;\n  let cachedSnapshot: Overrides = {};\n\n  function readSnapshot(): Overrides {\n    if (typeof window === \"undefined\") return EMPTY;\n    let raw: string | null;\n    try {\n      raw = window.localStorage.getItem(storageKey);\n    } catch {\n      return cachedSnapshot;\n    }\n    if (raw === cachedRaw) return cachedSnapshot;\n    cachedRaw = raw;\n    try {\n      cachedSnapshot = raw ? (JSON.parse(raw) as Overrides) : {};\n    } catch {\n      cachedSnapshot = {};\n    }\n    return cachedSnapshot;\n  }\n\n  function writeOverrides(next: Overrides) {\n    if (typeof window === \"undefined\") return;\n    const json = JSON.stringify(next);\n    try {\n      window.localStorage.setItem(storageKey, json);\n    } catch {\n      // ignore quota / private mode errors\n    }\n    cachedRaw = json;\n    cachedSnapshot = next;\n    window.dispatchEvent(new Event(eventName));\n  }\n\n  function subscribe(callback: () => void) {\n    if (typeof window === \"undefined\") return () => {};\n    const handler = () => {\n      cachedRaw = undefined;\n      callback();\n    };\n    window.addEventListener(eventName, handler);\n    window.addEventListener(\"storage\", handler);\n    return () => {\n      window.removeEventListener(eventName, handler);\n      window.removeEventListener(\"storage\", handler);\n    };\n  }\n\n  function getServerSnapshot(): Overrides {\n    return EMPTY;\n  }\n\n  type FlagKey = keyof F & string;\n\n  function useFlag<T = unknown>(key: FlagKey): T {\n    const overrides = useSyncExternalStore(subscribe, readSnapshot, getServerSnapshot);\n    if (key in overrides) return overrides[key] as T;\n    const def = flags[key] as FlagDef;\n    return def.default as T;\n  }\n\n  function setFlag(key: FlagKey, value: unknown) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    current[key] = value;\n    writeOverrides(current);\n  }\n\n  function resetFlag(key: FlagKey) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    delete current[key];\n    writeOverrides(current);\n  }\n\n  function resetAllFlags() {\n    writeOverrides({});\n  }\n\n  function listFlags() {\n    return Object.entries(flags).map(([key, def]) => ({\n      key,\n      ...(def as FlagDef),\n    }));\n  }\n\n  return { useFlag, setFlag, resetFlag, resetAllFlags, listFlags };\n}\n"],"mappings":";AAEA,SAAS,4BAA4B;AAKrC,IAAM,QAAmB,OAAO,OAAO,CAAC,CAAC;AAOlC,SAAS,YAAgC,MAAwC;AACtF,QAAM,EAAE,OAAO,WAAW,IAAI;AAC9B,QAAM,YAAY,iBAAiB,UAAU;AAG7C,MAAI,YAAuC;AAC3C,MAAI,iBAA4B,CAAC;AAEjC,WAAS,eAA0B;AACjC,QAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAI;AACJ,QAAI;AACF,YAAM,OAAO,aAAa,QAAQ,UAAU;AAAA,IAC9C,QAAQ;AACN,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,UAAW,QAAO;AAC9B,gBAAY;AACZ,QAAI;AACF,uBAAiB,MAAO,KAAK,MAAM,GAAG,IAAkB,CAAC;AAAA,IAC3D,QAAQ;AACN,uBAAiB,CAAC;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAEA,WAAS,eAAe,MAAiB;AACvC,QAAI,OAAO,WAAW,YAAa;AACnC,UAAM,OAAO,KAAK,UAAU,IAAI;AAChC,QAAI;AACF,aAAO,aAAa,QAAQ,YAAY,IAAI;AAAA,IAC9C,QAAQ;AAAA,IAER;AACA,gBAAY;AACZ,qBAAiB;AACjB,WAAO,cAAc,IAAI,MAAM,SAAS,CAAC;AAAA,EAC3C;AAEA,WAAS,UAAU,UAAsB;AACvC,QAAI,OAAO,WAAW,YAAa,QAAO,MAAM;AAAA,IAAC;AACjD,UAAM,UAAU,MAAM;AACpB,kBAAY;AACZ,eAAS;AAAA,IACX;AACA,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,MAAM;AACX,aAAO,oBAAoB,WAAW,OAAO;AAC7C,aAAO,oBAAoB,WAAW,OAAO;AAAA,IAC/C;AAAA,EACF;AAEA,WAAS,oBAA+B;AACtC,WAAO;AAAA,EACT;AAIA,WAAS,QAAqB,KAAiB;AAC7C,UAAM,YAAY,qBAAqB,WAAW,cAAc,iBAAiB;AACjF,QAAI,OAAO,UAAW,QAAO,UAAU,GAAG;AAC1C,UAAM,MAAM,MAAM,GAAG;AACrB,WAAO,IAAI;AAAA,EACb;AAEA,WAAS,QAAQ,KAAc,OAAgB;AAC7C,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,YAAQ,GAAG,IAAI;AACf,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,UAAU,KAAc;AAC/B,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,WAAO,QAAQ,GAAG;AAClB,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,gBAAgB;AACvB,mBAAe,CAAC,CAAC;AAAA,EACnB;AAEA,WAAS,YAAY;AACnB,WAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,OAAO;AAAA,MAChD;AAAA,MACA,GAAI;AAAA,IACN,EAAE;AAAA,EACJ;AAEA,SAAO,EAAE,SAAS,SAAS,WAAW,eAAe,UAAU;AACjE;","names":[]}
+{"version":3,"sources":["../src/createFlags.tsx"],"sourcesContent":["\"use client\";\n\nimport { useSyncExternalStore } from \"react\";\nimport type { FlagDef, FlagsMap } from \"./index.js\";\n\ntype Overrides = Record<string, unknown>;\n\nconst EMPTY: Overrides = Object.freeze({}) as Overrides;\n\n/**\n * Build a per-app flag system. Each consuming app calls this once with its\n * own flag definitions and a unique localStorage namespace. Returns a hook\n * + helpers + a studio panel scoped to those flags.\n */\nexport function createFlags<F extends FlagsMap>(opts: { flags: F; storageKey: string }) {\n  const { flags, storageKey } = opts;\n  const eventName = `flags:changed:${storageKey}`;\n\n  // Cache for stable getSnapshot reference (required by useSyncExternalStore).\n  let cachedRaw: string | null | undefined = undefined;\n  let cachedSnapshot: Overrides = {};\n\n  function readSnapshot(): Overrides {\n    if (typeof window === \"undefined\") return EMPTY;\n    let raw: string | null;\n    try {\n      raw = window.localStorage.getItem(storageKey);\n    } catch {\n      return cachedSnapshot;\n    }\n    if (raw === cachedRaw) return cachedSnapshot;\n    cachedRaw = raw;\n    try {\n      cachedSnapshot = raw ? (JSON.parse(raw) as Overrides) : {};\n    } catch {\n      cachedSnapshot = {};\n    }\n    return cachedSnapshot;\n  }\n\n  function writeOverrides(next: Overrides) {\n    if (typeof window === \"undefined\") return;\n    const json = JSON.stringify(next);\n    try {\n      window.localStorage.setItem(storageKey, json);\n    } catch {\n      // ignore quota / private mode errors\n    }\n    cachedRaw = json;\n    cachedSnapshot = next;\n    window.dispatchEvent(new Event(eventName));\n  }\n\n  function subscribe(callback: () => void) {\n    if (typeof window === \"undefined\") return () => {};\n    const handler = () => {\n      cachedRaw = undefined;\n      callback();\n    };\n    window.addEventListener(eventName, handler);\n    window.addEventListener(\"storage\", handler);\n    return () => {\n      window.removeEventListener(eventName, handler);\n      window.removeEventListener(\"storage\", handler);\n    };\n  }\n\n  function getServerSnapshot(): Overrides {\n    return EMPTY;\n  }\n\n  type FlagKey = keyof F & string;\n\n  function useFlag<T = unknown>(key: FlagKey): T {\n    const overrides = useSyncExternalStore(subscribe, readSnapshot, getServerSnapshot);\n    if (key in overrides) return overrides[key] as T;\n    const def = flags[key] as FlagDef;\n    return def.default as T;\n  }\n\n  function setFlag(key: FlagKey, value: unknown) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    current[key] = value;\n    writeOverrides(current);\n  }\n\n  function resetFlag(key: FlagKey) {\n    const current = typeof window === \"undefined\" ? {} : { ...readSnapshot() };\n    delete current[key];\n    writeOverrides(current);\n  }\n\n  function resetAllFlags() {\n    writeOverrides({});\n  }\n\n  function listFlags() {\n    return Object.entries(flags).map(([key, def]) => ({\n      key,\n      ...(def as FlagDef),\n    }));\n  }\n\n  return { useFlag, setFlag, resetFlag, resetAllFlags, listFlags };\n}\n"],"mappings":";AAEA,SAAS,4BAA4B;AAKrC,MAAM,QAAmB,OAAO,OAAO,CAAC,CAAC;AAOlC,SAAS,YAAgC,MAAwC;AACtF,QAAM,EAAE,OAAO,WAAW,IAAI;AAC9B,QAAM,YAAY,iBAAiB,UAAU;AAG7C,MAAI,YAAuC;AAC3C,MAAI,iBAA4B,CAAC;AAEjC,WAAS,eAA0B;AACjC,QAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAI;AACJ,QAAI;AACF,YAAM,OAAO,aAAa,QAAQ,UAAU;AAAA,IAC9C,QAAQ;AACN,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,UAAW,QAAO;AAC9B,gBAAY;AACZ,QAAI;AACF,uBAAiB,MAAO,KAAK,MAAM,GAAG,IAAkB,CAAC;AAAA,IAC3D,QAAQ;AACN,uBAAiB,CAAC;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAEA,WAAS,eAAe,MAAiB;AACvC,QAAI,OAAO,WAAW,YAAa;AACnC,UAAM,OAAO,KAAK,UAAU,IAAI;AAChC,QAAI;AACF,aAAO,aAAa,QAAQ,YAAY,IAAI;AAAA,IAC9C,QAAQ;AAAA,IAER;AACA,gBAAY;AACZ,qBAAiB;AACjB,WAAO,cAAc,IAAI,MAAM,SAAS,CAAC;AAAA,EAC3C;AAEA,WAAS,UAAU,UAAsB;AACvC,QAAI,OAAO,WAAW,YAAa,QAAO,MAAM;AAAA,IAAC;AACjD,UAAM,UAAU,MAAM;AACpB,kBAAY;AACZ,eAAS;AAAA,IACX;AACA,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,iBAAiB,WAAW,OAAO;AAC1C,WAAO,MAAM;AACX,aAAO,oBAAoB,WAAW,OAAO;AAC7C,aAAO,oBAAoB,WAAW,OAAO;AAAA,IAC/C;AAAA,EACF;AAEA,WAAS,oBAA+B;AACtC,WAAO;AAAA,EACT;AAIA,WAAS,QAAqB,KAAiB;AAC7C,UAAM,YAAY,qBAAqB,WAAW,cAAc,iBAAiB;AACjF,QAAI,OAAO,UAAW,QAAO,UAAU,GAAG;AAC1C,UAAM,MAAM,MAAM,GAAG;AACrB,WAAO,IAAI;AAAA,EACb;AAEA,WAAS,QAAQ,KAAc,OAAgB;AAC7C,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,YAAQ,GAAG,IAAI;AACf,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,UAAU,KAAc;AAC/B,UAAM,UAAU,OAAO,WAAW,cAAc,CAAC,IAAI,EAAE,GAAG,aAAa,EAAE;AACzE,WAAO,QAAQ,GAAG;AAClB,mBAAe,OAAO;AAAA,EACxB;AAEA,WAAS,gBAAgB;AACvB,mBAAe,CAAC,CAAC;AAAA,EACnB;AAEA,WAAS,YAAY;AACnB,WAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,OAAO;AAAA,MAChD;AAAA,MACA,GAAI;AAAA,IACN,EAAE;AAAA,EACJ;AAEA,SAAO,EAAE,SAAS,SAAS,WAAW,eAAe,UAAU;AACjE;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,29 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  createFlags: () => import_createFlags.createFlags
+});
+module.exports = __toCommonJS(index_exports);
+var import_createFlags = require("./createFlags.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFlags
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type FlagDef =\n  | { type: \"boolean\"; default: boolean; description: string }\n  | { type: \"string\"; default: string; description: string }\n  | { type: \"number\"; default: number; description: string }\n  | {\n      type: \"enum\";\n      default: string;\n      options: string[];\n      description: string;\n    };\n\nexport type FlagsMap = Record<string, FlagDef>;\n\nexport { createFlags } from \"./createFlags.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,yBAA4B;","names":[]}

package/dist/index.js

@@ -1,2 +1,5 @@
-export { createFlags } from "./createFlags.js";
+import { createFlags } from "./createFlags.js";
+export {
+  createFlags
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type FlagDef =\n  | { type: \"boolean\"; default: boolean; description: string }\n  | { type: \"string\"; default: string; description: string }\n  | { type: \"number\"; default: number; description: string }\n  | {\n      type: \"enum\";\n      default: string;\n      options: string[];\n      description: string;\n    };\n\nexport type FlagsMap = Record<string, FlagDef>;\n\nexport { createFlags } from \"./createFlags.js\";\n"],"mappings":"AAaA,SAAS,mBAAmB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augmenting-integrations/flags",
-  "version": "0.2.1",
+  "version": "1.0.0",
   "description": "Feature flag hook (useFlag) and per-app studio panel. Flag definitions are passed in by the consuming app.",
   "license": "MIT",
   "publishConfig": {

package/dist/createFlags.jsx

@@ -1,95 +0,0 @@
-"use client";
-import { useSyncExternalStore } from "react";
-const EMPTY = Object.freeze({});
-/**
- * Build a per-app flag system. Each consuming app calls this once with its
- * own flag definitions and a unique localStorage namespace. Returns a hook
- * + helpers + a studio panel scoped to those flags.
- */
-export function createFlags(opts) {
-    const { flags, storageKey } = opts;
-    const eventName = `flags:changed:${storageKey}`;
-    // Cache for stable getSnapshot reference (required by useSyncExternalStore).
-    let cachedRaw = undefined;
-    let cachedSnapshot = {};
-    function readSnapshot() {
-        if (typeof window === "undefined")
-            return EMPTY;
-        let raw;
-        try {
-            raw = window.localStorage.getItem(storageKey);
-        }
-        catch {
-            return cachedSnapshot;
-        }
-        if (raw === cachedRaw)
-            return cachedSnapshot;
-        cachedRaw = raw;
-        try {
-            cachedSnapshot = raw ? JSON.parse(raw) : {};
-        }
-        catch {
-            cachedSnapshot = {};
-        }
-        return cachedSnapshot;
-    }
-    function writeOverrides(next) {
-        if (typeof window === "undefined")
-            return;
-        const json = JSON.stringify(next);
-        try {
-            window.localStorage.setItem(storageKey, json);
-        }
-        catch {
-            // ignore quota / private mode errors
-        }
-        cachedRaw = json;
-        cachedSnapshot = next;
-        window.dispatchEvent(new Event(eventName));
-    }
-    function subscribe(callback) {
-        if (typeof window === "undefined")
-            return () => { };
-        const handler = () => {
-            cachedRaw = undefined;
-            callback();
-        };
-        window.addEventListener(eventName, handler);
-        window.addEventListener("storage", handler);
-        return () => {
-            window.removeEventListener(eventName, handler);
-            window.removeEventListener("storage", handler);
-        };
-    }
-    function getServerSnapshot() {
-        return EMPTY;
-    }
-    function useFlag(key) {
-        const overrides = useSyncExternalStore(subscribe, readSnapshot, getServerSnapshot);
-        if (key in overrides)
-            return overrides[key];
-        const def = flags[key];
-        return def.default;
-    }
-    function setFlag(key, value) {
-        const current = typeof window === "undefined" ? {} : { ...readSnapshot() };
-        current[key] = value;
-        writeOverrides(current);
-    }
-    function resetFlag(key) {
-        const current = typeof window === "undefined" ? {} : { ...readSnapshot() };
-        delete current[key];
-        writeOverrides(current);
-    }
-    function resetAllFlags() {
-        writeOverrides({});
-    }
-    function listFlags() {
-        return Object.entries(flags).map(([key, def]) => ({
-            key,
-            ...def,
-        }));
-    }
-    return { useFlag, setFlag, resetFlag, resetAllFlags, listFlags };
-}
-//# sourceMappingURL=createFlags.jsx.map

package/dist/createFlags.jsx.map

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