@toglio/js 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,108 @@
+type FlagValue = boolean | string | number;
+interface FlagMap {
+    [key: string]: FlagValue;
+}
+interface SdkTargetingCondition {
+    attribute: string;
+    operator: string;
+    values: string[];
+    segmentId?: string | null;
+}
+interface SdkTargetingRule {
+    id: string;
+    name?: string | null;
+    priority: number;
+    value: string;
+    conditions: SdkTargetingCondition[];
+}
+interface SdkSegment {
+    id: string;
+    name: string;
+    members: string[];
+}
+interface SdkResponse {
+    organization: string;
+    project: string;
+    environment: string;
+    flags: FlagMap;
+    payloads?: Record<string, string>;
+    targeting?: Record<string, SdkTargetingRule[]>;
+    segments?: Record<string, SdkSegment>;
+}
+/** Atributos extras do usuário usados nas regras de targeting. */
+type UserAttributes = Record<string, string | string[]>;
+interface FeatureFlagsClientConfig {
+    /** URL base da API (ex: https://api.suaplataforma.com) */
+    baseUrl: string;
+    /** Slug da organização */
+    organization: string;
+    /** Slug do projeto */
+    project: string;
+    /** Slug do ambiente (dev | hml | prod) */
+    environment: string;
+    /** Token público de leitura do ambiente, enviado no header X-SDK-Token. */
+    apiKey: string;
+    /** Identificador estável do usuário final para rollout gradual e targeting. */
+    userId?: string;
+    /**
+     * Atributos extras do usuário para regras de targeting avançado.
+     * Exemplos: { city: 'São Paulo', plan: 'premium', groups: ['beta'] }
+     */
+    attributes?: UserAttributes;
+    /** Intervalo de polling em ms. Default: 30000. Use 0 para desativar. */
+    pollingInterval?: number;
+    /**
+     * Valores de fallback usados quando o servidor está offline ou a flag
+     * não existe. Evita que a aplicação quebre em caso de indisponibilidade.
+     */
+    defaults?: Partial<FlagMap>;
+    /** Callback chamado quando alguma flag muda de valor após um poll. */
+    onChange?: (changes: FlagChange[]) => void;
+}
+interface FlagChange {
+    key: string;
+    previous: FlagValue | undefined;
+    current: FlagValue;
+}
+interface ClientStatus {
+    initialized: boolean;
+    lastFetchAt: Date | null;
+    fetchError: Error | null;
+}
+
+declare class FeatureFlagsClient {
+    private flags;
+    private payloads;
+    private targeting;
+    private segments;
+    private readonly status;
+    private readonly poller;
+    private readonly config;
+    private readonly changeListeners;
+    constructor(config: FeatureFlagsClientConfig);
+    initialize(): Promise<void>;
+    destroy(): void;
+    isEnabled(key: string, defaultValue?: boolean): boolean;
+    getString(key: string, defaultValue?: string): string;
+    getNumber(key: string, defaultValue?: number): number;
+    getAll(): FlagMap;
+    getVariant(key: string, defaultValue?: string): string;
+    getVariantPayload(key: string): unknown;
+    getStatus(): ClientStatus;
+    addOnChange(callback: (changes: FlagChange[]) => void): () => void;
+    /**
+     * Evaluate a flag applying targeting rules first, then falling back to the
+     * server-resolved value (which already accounts for rollout %).
+     */
+    private evaluate;
+    private matchTargetingRules;
+    private ruleMatches;
+    private conditionMatches;
+    private buildUrl;
+    private fetchFlags;
+    private storageKey;
+    private saveToStorage;
+    private loadFromStorage;
+}
+
+export { type ClientStatus, FeatureFlagsClient, type FeatureFlagsClientConfig, type FlagChange, type FlagMap, type FlagValue, type SdkResponse };

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+type FlagValue = boolean | string | number;
+interface FlagMap {
+    [key: string]: FlagValue;
+}
+interface SdkTargetingCondition {
+    attribute: string;
+    operator: string;
+    values: string[];
+    segmentId?: string | null;
+}
+interface SdkTargetingRule {
+    id: string;
+    name?: string | null;
+    priority: number;
+    value: string;
+    conditions: SdkTargetingCondition[];
+}
+interface SdkSegment {
+    id: string;
+    name: string;
+    members: string[];
+}
+interface SdkResponse {
+    organization: string;
+    project: string;
+    environment: string;
+    flags: FlagMap;
+    payloads?: Record<string, string>;
+    targeting?: Record<string, SdkTargetingRule[]>;
+    segments?: Record<string, SdkSegment>;
+}
+/** Atributos extras do usuário usados nas regras de targeting. */
+type UserAttributes = Record<string, string | string[]>;
+interface FeatureFlagsClientConfig {
+    /** URL base da API (ex: https://api.suaplataforma.com) */
+    baseUrl: string;
+    /** Slug da organização */
+    organization: string;
+    /** Slug do projeto */
+    project: string;
+    /** Slug do ambiente (dev | hml | prod) */
+    environment: string;
+    /** Token público de leitura do ambiente, enviado no header X-SDK-Token. */
+    apiKey: string;
+    /** Identificador estável do usuário final para rollout gradual e targeting. */
+    userId?: string;
+    /**
+     * Atributos extras do usuário para regras de targeting avançado.
+     * Exemplos: { city: 'São Paulo', plan: 'premium', groups: ['beta'] }
+     */
+    attributes?: UserAttributes;
+    /** Intervalo de polling em ms. Default: 30000. Use 0 para desativar. */
+    pollingInterval?: number;
+    /**
+     * Valores de fallback usados quando o servidor está offline ou a flag
+     * não existe. Evita que a aplicação quebre em caso de indisponibilidade.
+     */
+    defaults?: Partial<FlagMap>;
+    /** Callback chamado quando alguma flag muda de valor após um poll. */
+    onChange?: (changes: FlagChange[]) => void;
+}
+interface FlagChange {
+    key: string;
+    previous: FlagValue | undefined;
+    current: FlagValue;
+}
+interface ClientStatus {
+    initialized: boolean;
+    lastFetchAt: Date | null;
+    fetchError: Error | null;
+}
+
+declare class FeatureFlagsClient {
+    private flags;
+    private payloads;
+    private targeting;
+    private segments;
+    private readonly status;
+    private readonly poller;
+    private readonly config;
+    private readonly changeListeners;
+    constructor(config: FeatureFlagsClientConfig);
+    initialize(): Promise<void>;
+    destroy(): void;
+    isEnabled(key: string, defaultValue?: boolean): boolean;
+    getString(key: string, defaultValue?: string): string;
+    getNumber(key: string, defaultValue?: number): number;
+    getAll(): FlagMap;
+    getVariant(key: string, defaultValue?: string): string;
+    getVariantPayload(key: string): unknown;
+    getStatus(): ClientStatus;
+    addOnChange(callback: (changes: FlagChange[]) => void): () => void;
+    /**
+     * Evaluate a flag applying targeting rules first, then falling back to the
+     * server-resolved value (which already accounts for rollout %).
+     */
+    private evaluate;
+    private matchTargetingRules;
+    private ruleMatches;
+    private conditionMatches;
+    private buildUrl;
+    private fetchFlags;
+    private storageKey;
+    private saveToStorage;
+    private loadFromStorage;
+}
+
+export { type ClientStatus, FeatureFlagsClient, type FeatureFlagsClientConfig, type FlagChange, type FlagMap, type FlagValue, type SdkResponse };

package/dist/index.js

@@ -0,0 +1,287 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FeatureFlagsClient: () => FeatureFlagsClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/poller.ts
+var Poller = class {
+  constructor(fetch2, intervalMs) {
+    this.fetch = fetch2;
+    this.intervalMs = intervalMs;
+    this.timer = null;
+    this.running = false;
+  }
+  start() {
+    if (this.running || this.intervalMs <= 0) return;
+    this.running = true;
+    this.schedule();
+  }
+  stop() {
+    this.running = false;
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  schedule() {
+    this.timer = setTimeout(async () => {
+      if (!this.running) return;
+      try {
+        await this.fetch();
+      } catch {
+      }
+      if (this.running) this.schedule();
+    }, this.intervalMs);
+  }
+};
+
+// src/client.ts
+var STORAGE_KEY_PREFIX = "ff:cache:";
+var FeatureFlagsClient = class {
+  constructor(config) {
+    this.flags = {};
+    this.payloads = {};
+    this.targeting = {};
+    this.segments = {};
+    this.status = {
+      initialized: false,
+      lastFetchAt: null,
+      fetchError: null
+    };
+    this.changeListeners = [];
+    this.config = {
+      pollingInterval: 3e4,
+      defaults: {},
+      onChange: void 0,
+      attributes: void 0,
+      ...config
+    };
+    this.poller = new Poller(
+      () => this.fetchFlags(),
+      this.config.pollingInterval
+    );
+  }
+  async initialize() {
+    const cached = this.loadFromStorage();
+    if (cached) {
+      this.flags = cached;
+    }
+    try {
+      await this.fetchFlags();
+    } catch (err) {
+      this.status.fetchError = err instanceof Error ? err : new Error(String(err));
+    }
+    this.status.initialized = true;
+    this.poller.start();
+  }
+  destroy() {
+    this.poller.stop();
+  }
+  // ─── Flag readers ───────────────────────────────────────────────────────────
+  isEnabled(key, defaultValue = false) {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    return val === true || val === "true";
+  }
+  getString(key, defaultValue = "") {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    return String(val);
+  }
+  getNumber(key, defaultValue = 0) {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    const n = Number(val);
+    return Number.isNaN(n) ? defaultValue : n;
+  }
+  getAll() {
+    return { ...this.flags };
+  }
+  getVariant(key, defaultValue = "control") {
+    const val = this.evaluate(key);
+    if (typeof val === "string" && val !== "") return val;
+    return defaultValue;
+  }
+  getVariantPayload(key) {
+    const raw = this.payloads[key];
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  getStatus() {
+    return { ...this.status };
+  }
+  addOnChange(callback) {
+    this.changeListeners.push(callback);
+    return () => {
+      const idx = this.changeListeners.indexOf(callback);
+      if (idx !== -1) this.changeListeners.splice(idx, 1);
+    };
+  }
+  // ─── Targeting evaluation ───────────────────────────────────────────────────
+  /**
+   * Evaluate a flag applying targeting rules first, then falling back to the
+   * server-resolved value (which already accounts for rollout %).
+   */
+  evaluate(key) {
+    const rules = this.targeting[key];
+    if (rules && rules.length > 0 && this.config.userId) {
+      const matched = this.matchTargetingRules(rules);
+      if (matched !== void 0) return matched;
+    }
+    if (key in this.flags) return this.flags[key];
+    if (this.config.defaults && key in this.config.defaults) {
+      return this.config.defaults[key];
+    }
+    return void 0;
+  }
+  matchTargetingRules(rules) {
+    const sorted = [...rules].sort((a, b) => a.priority - b.priority);
+    for (const rule of sorted) {
+      if (this.ruleMatches(rule)) return rule.value;
+    }
+    return void 0;
+  }
+  ruleMatches(rule) {
+    return rule.conditions.every((cond) => this.conditionMatches(cond));
+  }
+  conditionMatches(cond) {
+    var _a, _b, _c;
+    const { attribute, operator, values, segmentId } = cond;
+    const userId = (_a = this.config.userId) != null ? _a : "";
+    const attrs = (_b = this.config.attributes) != null ? _b : {};
+    if (attribute === "segment" || attribute === "group") {
+      const id = segmentId != null ? segmentId : values[0];
+      const segment = id ? this.segments[id] : void 0;
+      return segment ? segment.members.includes(userId) : false;
+    }
+    const rawValue = attribute === "userId" ? userId : attrs[attribute];
+    if (rawValue === void 0) return false;
+    const userValues = Array.isArray(rawValue) ? rawValue : [String(rawValue)];
+    switch (operator) {
+      case "IN":
+        return values.some((v) => userValues.includes(v));
+      case "NOT_IN":
+        return !values.some((v) => userValues.includes(v));
+      case "EQUALS":
+        return userValues[0] === values[0];
+      case "NOT_EQUALS":
+        return userValues[0] !== values[0];
+      case "CONTAINS":
+        return userValues.some((uv) => {
+          var _a2;
+          return uv.includes((_a2 = values[0]) != null ? _a2 : "");
+        });
+      case "MATCHES_REGEX": {
+        try {
+          const re = new RegExp((_c = values[0]) != null ? _c : "");
+          return userValues.some((uv) => re.test(uv));
+        } catch {
+          return false;
+        }
+      }
+      default:
+        return false;
+    }
+  }
+  // ─── Private helpers ────────────────────────────────────────────────────────
+  buildUrl() {
+    const { baseUrl, organization, project, environment } = this.config;
+    const base = baseUrl.replace(/\/$/, "");
+    return `${base}/sdk/organizations/${organization}/projects/${project}/environments/${environment}`;
+  }
+  async fetchFlags() {
+    var _a, _b, _c, _d;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5e3);
+    try {
+      const headers = {
+        Accept: "application/json",
+        "X-SDK-Token": this.config.apiKey
+      };
+      if (this.config.userId) {
+        headers["X-Toglio-User-Id"] = this.config.userId;
+      }
+      const response = await fetch(this.buildUrl(), { headers, signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(`SDK fetch failed: ${response.status} ${response.statusText}`);
+      }
+      const body = await response.json();
+      const incoming = (_a = body.flags) != null ? _a : {};
+      const changes = [];
+      for (const key of /* @__PURE__ */ new Set([
+        ...Object.keys(this.flags),
+        ...Object.keys(incoming)
+      ])) {
+        const previous = this.flags[key];
+        const current = incoming[key];
+        if (previous !== current) {
+          changes.push({ key, previous, current });
+        }
+      }
+      this.flags = incoming;
+      this.payloads = (_b = body.payloads) != null ? _b : {};
+      this.targeting = (_c = body.targeting) != null ? _c : {};
+      this.segments = (_d = body.segments) != null ? _d : {};
+      this.status.lastFetchAt = /* @__PURE__ */ new Date();
+      this.status.fetchError = null;
+      this.saveToStorage(incoming);
+      if (changes.length > 0) {
+        if (this.config.onChange) this.config.onChange(changes);
+        for (const listener of this.changeListeners) listener(changes);
+      }
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  storageKey() {
+    var _a;
+    return `${STORAGE_KEY_PREFIX}${this.config.organization}:${this.config.project}:${this.config.environment}:${(_a = this.config.userId) != null ? _a : "anonymous"}`;
+  }
+  saveToStorage(flags) {
+    try {
+      if (typeof localStorage !== "undefined") {
+        localStorage.setItem(this.storageKey(), JSON.stringify(flags));
+      }
+    } catch {
+    }
+  }
+  loadFromStorage() {
+    try {
+      if (typeof localStorage !== "undefined") {
+        const raw = localStorage.getItem(this.storageKey());
+        if (raw) return JSON.parse(raw);
+      }
+    } catch {
+    }
+    return null;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FeatureFlagsClient
+});

package/dist/index.mjs

@@ -0,0 +1,260 @@
+// src/poller.ts
+var Poller = class {
+  constructor(fetch2, intervalMs) {
+    this.fetch = fetch2;
+    this.intervalMs = intervalMs;
+    this.timer = null;
+    this.running = false;
+  }
+  start() {
+    if (this.running || this.intervalMs <= 0) return;
+    this.running = true;
+    this.schedule();
+  }
+  stop() {
+    this.running = false;
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  schedule() {
+    this.timer = setTimeout(async () => {
+      if (!this.running) return;
+      try {
+        await this.fetch();
+      } catch {
+      }
+      if (this.running) this.schedule();
+    }, this.intervalMs);
+  }
+};
+
+// src/client.ts
+var STORAGE_KEY_PREFIX = "ff:cache:";
+var FeatureFlagsClient = class {
+  constructor(config) {
+    this.flags = {};
+    this.payloads = {};
+    this.targeting = {};
+    this.segments = {};
+    this.status = {
+      initialized: false,
+      lastFetchAt: null,
+      fetchError: null
+    };
+    this.changeListeners = [];
+    this.config = {
+      pollingInterval: 3e4,
+      defaults: {},
+      onChange: void 0,
+      attributes: void 0,
+      ...config
+    };
+    this.poller = new Poller(
+      () => this.fetchFlags(),
+      this.config.pollingInterval
+    );
+  }
+  async initialize() {
+    const cached = this.loadFromStorage();
+    if (cached) {
+      this.flags = cached;
+    }
+    try {
+      await this.fetchFlags();
+    } catch (err) {
+      this.status.fetchError = err instanceof Error ? err : new Error(String(err));
+    }
+    this.status.initialized = true;
+    this.poller.start();
+  }
+  destroy() {
+    this.poller.stop();
+  }
+  // ─── Flag readers ───────────────────────────────────────────────────────────
+  isEnabled(key, defaultValue = false) {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    return val === true || val === "true";
+  }
+  getString(key, defaultValue = "") {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    return String(val);
+  }
+  getNumber(key, defaultValue = 0) {
+    const val = this.evaluate(key);
+    if (val === void 0) return defaultValue;
+    const n = Number(val);
+    return Number.isNaN(n) ? defaultValue : n;
+  }
+  getAll() {
+    return { ...this.flags };
+  }
+  getVariant(key, defaultValue = "control") {
+    const val = this.evaluate(key);
+    if (typeof val === "string" && val !== "") return val;
+    return defaultValue;
+  }
+  getVariantPayload(key) {
+    const raw = this.payloads[key];
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  getStatus() {
+    return { ...this.status };
+  }
+  addOnChange(callback) {
+    this.changeListeners.push(callback);
+    return () => {
+      const idx = this.changeListeners.indexOf(callback);
+      if (idx !== -1) this.changeListeners.splice(idx, 1);
+    };
+  }
+  // ─── Targeting evaluation ───────────────────────────────────────────────────
+  /**
+   * Evaluate a flag applying targeting rules first, then falling back to the
+   * server-resolved value (which already accounts for rollout %).
+   */
+  evaluate(key) {
+    const rules = this.targeting[key];
+    if (rules && rules.length > 0 && this.config.userId) {
+      const matched = this.matchTargetingRules(rules);
+      if (matched !== void 0) return matched;
+    }
+    if (key in this.flags) return this.flags[key];
+    if (this.config.defaults && key in this.config.defaults) {
+      return this.config.defaults[key];
+    }
+    return void 0;
+  }
+  matchTargetingRules(rules) {
+    const sorted = [...rules].sort((a, b) => a.priority - b.priority);
+    for (const rule of sorted) {
+      if (this.ruleMatches(rule)) return rule.value;
+    }
+    return void 0;
+  }
+  ruleMatches(rule) {
+    return rule.conditions.every((cond) => this.conditionMatches(cond));
+  }
+  conditionMatches(cond) {
+    var _a, _b, _c;
+    const { attribute, operator, values, segmentId } = cond;
+    const userId = (_a = this.config.userId) != null ? _a : "";
+    const attrs = (_b = this.config.attributes) != null ? _b : {};
+    if (attribute === "segment" || attribute === "group") {
+      const id = segmentId != null ? segmentId : values[0];
+      const segment = id ? this.segments[id] : void 0;
+      return segment ? segment.members.includes(userId) : false;
+    }
+    const rawValue = attribute === "userId" ? userId : attrs[attribute];
+    if (rawValue === void 0) return false;
+    const userValues = Array.isArray(rawValue) ? rawValue : [String(rawValue)];
+    switch (operator) {
+      case "IN":
+        return values.some((v) => userValues.includes(v));
+      case "NOT_IN":
+        return !values.some((v) => userValues.includes(v));
+      case "EQUALS":
+        return userValues[0] === values[0];
+      case "NOT_EQUALS":
+        return userValues[0] !== values[0];
+      case "CONTAINS":
+        return userValues.some((uv) => {
+          var _a2;
+          return uv.includes((_a2 = values[0]) != null ? _a2 : "");
+        });
+      case "MATCHES_REGEX": {
+        try {
+          const re = new RegExp((_c = values[0]) != null ? _c : "");
+          return userValues.some((uv) => re.test(uv));
+        } catch {
+          return false;
+        }
+      }
+      default:
+        return false;
+    }
+  }
+  // ─── Private helpers ────────────────────────────────────────────────────────
+  buildUrl() {
+    const { baseUrl, organization, project, environment } = this.config;
+    const base = baseUrl.replace(/\/$/, "");
+    return `${base}/sdk/organizations/${organization}/projects/${project}/environments/${environment}`;
+  }
+  async fetchFlags() {
+    var _a, _b, _c, _d;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5e3);
+    try {
+      const headers = {
+        Accept: "application/json",
+        "X-SDK-Token": this.config.apiKey
+      };
+      if (this.config.userId) {
+        headers["X-Toglio-User-Id"] = this.config.userId;
+      }
+      const response = await fetch(this.buildUrl(), { headers, signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(`SDK fetch failed: ${response.status} ${response.statusText}`);
+      }
+      const body = await response.json();
+      const incoming = (_a = body.flags) != null ? _a : {};
+      const changes = [];
+      for (const key of /* @__PURE__ */ new Set([
+        ...Object.keys(this.flags),
+        ...Object.keys(incoming)
+      ])) {
+        const previous = this.flags[key];
+        const current = incoming[key];
+        if (previous !== current) {
+          changes.push({ key, previous, current });
+        }
+      }
+      this.flags = incoming;
+      this.payloads = (_b = body.payloads) != null ? _b : {};
+      this.targeting = (_c = body.targeting) != null ? _c : {};
+      this.segments = (_d = body.segments) != null ? _d : {};
+      this.status.lastFetchAt = /* @__PURE__ */ new Date();
+      this.status.fetchError = null;
+      this.saveToStorage(incoming);
+      if (changes.length > 0) {
+        if (this.config.onChange) this.config.onChange(changes);
+        for (const listener of this.changeListeners) listener(changes);
+      }
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  storageKey() {
+    var _a;
+    return `${STORAGE_KEY_PREFIX}${this.config.organization}:${this.config.project}:${this.config.environment}:${(_a = this.config.userId) != null ? _a : "anonymous"}`;
+  }
+  saveToStorage(flags) {
+    try {
+      if (typeof localStorage !== "undefined") {
+        localStorage.setItem(this.storageKey(), JSON.stringify(flags));
+      }
+    } catch {
+    }
+  }
+  loadFromStorage() {
+    try {
+      if (typeof localStorage !== "undefined") {
+        const raw = localStorage.getItem(this.storageKey());
+        if (raw) return JSON.parse(raw);
+      }
+    } catch {
+    }
+    return null;
+  }
+};
+export {
+  FeatureFlagsClient
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@toglio/js",
+  "version": "0.1.0",
+  "description": "Toglio — JavaScript/TypeScript SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "feature-flags",
+    "sdk",
+    "typescript"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.5.0"
+  }
+}