org.inovus.flags 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+Closed Source. Proprietary & Confidential.
+
+Copyright (c) 2026 Inovus Ltd. All rights reserved.
+
+This software and associated documentation (the "Software") are the
+proprietary and confidential property of Inovus Ltd.
+
+No part of the Software may be used, copied, modified, merged, published,
+distributed, sublicensed, or sold without prior written permission from
+Inovus Ltd.
+
+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
+INOVUS LTD 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

@@ -0,0 +1,354 @@
+# org.inovus.flags
+
+TypeScript client for Totum feature flags. Call `init()` once at startup, then read flags **synchronously** from memory — with background refresh and safe fallbacks when the network is unavailable.
+
+**Zero runtime dependencies.** Requires global `fetch` (Node 18+, browsers, Workers).
+
+---
+
+## Install
+
+```bash
+npm install org.inovus.flags
+```
+
+```typescript
+import { createFlagsClient } from 'org.inovus.flags';
+import type {
+  FlagDeclaration,
+  EvaluationContext,
+  FlagsClient,
+  FlagType,
+} from 'org.inovus.flags';
+```
+
+---
+
+## Prerequisites
+
+Your platform team provides two values — add them to `.env`, hosting secrets, or CI:
+
+| Variable | Purpose |
+|----------|---------|
+| `FLAGS_PROXY_URL` | Base URL of the flags HTTP API (no trailing slash required) |
+| `FLAGS_API_KEY` | API key sent as header `X-Flags-Api-Key` |
+
+```env
+FLAGS_PROXY_URL=https://flags.example.com
+FLAGS_API_KEY=your-proxy-key
+```
+
+**Do not** put Cloudflare account tokens or other infrastructure credentials in application code.
+
+**Next.js:** use `.env.local` / project settings. Prefix with `NEXT_PUBLIC_` only if the browser bundle must read them (both values will be visible in the client — the proxy key is a limited gate, not an account secret).
+
+---
+
+## Quick start
+
+```typescript
+import { createFlagsClient } from 'org.inovus.flags';
+
+const flags = createFlagsClient({
+  proxyUrl: process.env.FLAGS_PROXY_URL!,
+  apiKey: process.env.FLAGS_API_KEY!,
+});
+
+await flags.init([
+  { flagKey: 'my-app-dark-mode', type: 'boolean', defaultValue: false },
+  { flagKey: 'my-app-checkout-flow', type: 'string', defaultValue: 'v1' },
+]);
+
+// Synchronous — no await on getters
+const darkMode = flags.getBoolean('my-app-dark-mode', false);
+const checkout = flags.getString('my-app-checkout-flow', 'v1');
+```
+
+---
+
+## Flag keys
+
+Use one shared flag platform for the organisation. Separate products by **flag key prefix** (hyphen-separated):
+
+- `totum-admin-dark-mode`
+- `mobile-checkout-flow`
+- `video-uploader-metrics-enabled`
+
+Flag keys allow **letters, numbers, and hyphens only** — no dots.
+
+Each `flagKey` in code must exist in the flag dashboard with the **matching type** (`boolean`, `string`, `number`, `object`).
+
+### Dashboard: “Enabled” is not the same as `true`
+
+| Control | Meaning | Typical API `reason` |
+|---------|---------|----------------------|
+| **Enabled** (toggle) | Flag is active and evaluated | If off → `DISABLED` |
+| **Default** (variant) | Value when no targeting rules match | `DEFAULT` |
+
+**Enabled does not force boolean `true`.** A flag can be Enabled with **Default = `false`** and no rules — the API correctly returns `false` with `"reason":"DEFAULT"`.
+
+To enable a feature for **everyone**, set **Default** to the `true` variant. For partial rollouts, add targeting rules and pass matching `context` on `init` / `refresh`.
+
+| `reason` | Meaning |
+|----------|---------|
+| `DEFAULT` | No rule matched; default variant served |
+| `DISABLED` | Flag toggle off |
+| `TARGETING_MATCH` | A targeting rule matched |
+| `SPLIT` | Percentage / rollout bucket |
+| `ERROR` | Evaluation problem — check `errorCode` in the response |
+
+---
+
+## Integration pattern (required)
+
+1. **One client** per app (singleton or React context).
+2. **`await flags.init(declarations[, context])`** once before relying on flag values — list **every** flag the app reads.
+3. **Synchronous reads:** `getBoolean`, `getString`, `getNumber`, `getObject` — **never** `await` these.
+4. **`await flags.refresh(context?)`** after login or when targeting attributes change (`userId`, `plan`, etc.).
+5. **`flags.destroy()`** optional — stops the background refresh timer on app teardown.
+
+### Targeting context
+
+```typescript
+await flags.init(
+  [{ flagKey: 'my-app-dark-mode', type: 'boolean', defaultValue: false }],
+  { userId: 'anonymous' }
+);
+
+await flags.refresh({ userId: user.id, plan: user.plan });
+```
+
+### React (sketch)
+
+```typescript
+import { createFlagsClient, type FlagDeclaration } from 'org.inovus.flags';
+
+const declarations: FlagDeclaration[] = [
+  { flagKey: 'my-app-dark-mode', type: 'boolean', defaultValue: false },
+];
+
+export const flags = createFlagsClient({
+  proxyUrl: process.env.NEXT_PUBLIC_FLAGS_PROXY_URL!,
+  apiKey: process.env.NEXT_PUBLIC_FLAGS_API_KEY!,
+});
+
+let initPromise: Promise<void> | null = null;
+
+export function ensureFlagsInit(context?: EvaluationContext): Promise<void> {
+  if (!initPromise) initPromise = flags.init(declarations, context);
+  return initPromise;
+}
+```
+
+Gate UI until `ensureFlagsInit()` resolves, or accept `defaultValue` until loaded.
+
+### Node backend
+
+```typescript
+const flags = createFlagsClient({
+  proxyUrl: process.env.FLAGS_PROXY_URL!,
+  apiKey: process.env.FLAGS_API_KEY!,
+  persist: false,
+});
+
+await flags.init(declarations);
+await flags.refresh({ userId: req.user.id });
+```
+
+---
+
+## Client options
+
+| Option | Required | Default | Description |
+|--------|----------|---------|-------------|
+| `proxyUrl` | Yes | — | Flags API base URL |
+| `apiKey` | Yes | — | `X-Flags-Api-Key` header value |
+| `ttl` | No | `30000` | Background refresh interval (ms) |
+| `persist` | No | `true` | Persist cache to `localStorage` in browsers (`flags_cache` key) |
+
+---
+
+## API reference
+
+### `createFlagsClient(options): FlagsClient`
+
+### `init(declarations, context?): Promise<void>`
+
+- **declarations:** `{ flagKey, type, defaultValue }[]`
+- **type:** `'boolean' | 'string' | 'number' | 'object'`
+- One batch HTTP request; starts background refresh
+- Does not throw on network failure (logs warnings)
+
+### `refresh(context?): Promise<void>`
+
+Re-fetches declared flags. On failure, **keeps** existing cache.
+
+### `getBoolean` / `getString` / `getNumber` / `getObject`
+
+Synchronous. Never throws. Wrong or missing key → `defaultValue` + console warning.
+
+### `destroy(): void`
+
+Stops background interval.
+
+### Types
+
+```typescript
+type FlagType = 'boolean' | 'string' | 'number' | 'object';
+type EvaluationContext = Record<string, string | number | boolean>;
+
+interface FlagDeclaration {
+  flagKey: string;
+  type: FlagType;
+  defaultValue: unknown;
+}
+```
+
+---
+
+## HTTP API (what the SDK calls)
+
+### Authentication
+
+```http
+X-Flags-Api-Key: <FLAGS_API_KEY>
+```
+
+### `GET /health`
+
+No auth. `{ "status": "ok" }`
+
+### `POST /evaluate/batch`
+
+Auth required. Body: non-empty array of:
+
+```json
+{
+  "flagKey": "my-app-dark-mode",
+  "type": "boolean",
+  "defaultValue": false,
+  "context": { "userId": "user-123", "plan": "premium" }
+}
+```
+
+Response `200`: array of `{ flagKey, value, reason }` in request order.
+
+### `401 Unauthorized`
+
+Missing or invalid API key.
+
+---
+
+## Caching and failures
+
+**Fallback order** (first match wins):
+
+1. Fresh batch response  
+2. In-memory cache (stale is OK)  
+3. `localStorage` `flags_cache` (browsers, if `persist: true`)  
+4. `defaultValue` passed to `getX()`
+
+**Console warnings** (prefix `[org.inovus.flags]`):
+
+- `init: Worker unreachable and no persisted cache; getX() will use defaults`
+- `refresh: failed; keeping existing cache`
+- `get: flag "..." not in cache; using defaultValue`
+
+---
+
+## Anti-patterns
+
+| Wrong | Correct |
+|-------|---------|
+| Infrastructure credentials in the app | `FLAGS_PROXY_URL` + `FLAGS_API_KEY` only |
+| `await flags.getBoolean(...)` | `flags.getBoolean(...)` |
+| HTTP request per flag per render | `init()` once; sync reads |
+| Flag not listed in `init()` | Declare every flag in `init()` |
+| Direct calls to the flag provider API | Use this SDK only |
+| Reset UI to defaults when refresh fails | SDK keeps cache |
+| Skip `await init()` | Await `init()` or gate UI |
+
+---
+
+## New flag checklist
+
+1. Create the flag in the dashboard with the correct type and **Default** variant.
+2. Add to `init([..., { flagKey, type, defaultValue }])`.
+3. Read with the matching `getX()` and the same `flagKey`.
+4. Add targeting via `context` on `init` / `refresh` if needed.
+
+---
+
+## Troubleshooting
+
+| Symptom | Action |
+|---------|--------|
+| Always `defaultValue` | `await init()`; verify `GET /health` |
+| HTTP 401 | Check `FLAGS_API_KEY` with platform team |
+| Wrong value | Align dashboard type and `init` declaration |
+| Stale after login | `await refresh({ userId, plan, ... })` |
+| Tests flaky | `persist: false` in test setup |
+| `reason: "ERROR"` | Flag missing or type mismatch in dashboard |
+| Enabled in UI but `false` + `DEFAULT` | Set **Default** variant to `true` or add targeting |
+
+### Verify connectivity (curl)
+
+```bash
+curl "https://flags.example.com/health"
+```
+
+```bash
+curl -X POST "https://flags.example.com/evaluate/batch" \
+  -H "Content-Type: application/json" \
+  -H "X-Flags-Api-Key: your-proxy-key" \
+  -d '[{"flagKey":"my-app-dark-mode","type":"boolean","defaultValue":false}]'
+```
+
+**Windows cmd** (escape `"` inside `-d` as `\"`):
+
+```bat
+curl "https://flags.example.com/health"
+curl -X POST "https://flags.example.com/evaluate/batch" -H "Content-Type: application/json" -H "X-Flags-Api-Key: your-proxy-key" -d "[{\"flagKey\":\"my-app-dark-mode\",\"type\":\"boolean\",\"defaultValue\":false}]"
+```
+
+---
+
+## App template
+
+```typescript
+import { createFlagsClient, type FlagDeclaration } from 'org.inovus.flags';
+
+const DECLARATIONS: FlagDeclaration[] = [
+  // { flagKey: 'my-app-feature-x', type: 'boolean', defaultValue: false },
+];
+
+export const flags = createFlagsClient({
+  proxyUrl: process.env.FLAGS_PROXY_URL!,
+  apiKey: process.env.FLAGS_API_KEY!,
+  persist: typeof window !== 'undefined',
+});
+
+let ready: Promise<void> | null = null;
+
+export function initFlags(context?: Record<string, string | number | boolean>) {
+  if (!ready) ready = flags.init(DECLARATIONS, context);
+  return ready;
+}
+```
+
+---
+
+## AI agents
+
+When implementing feature flags in an application:
+
+- Follow the **integration pattern** and **anti-patterns** above.
+- Use only `FLAGS_PROXY_URL` and `FLAGS_API_KEY` from the environment.
+- List every flag in `init()` before calling `getX()`.
+- Do not bypass this SDK for routine flag reads.
+
+---
+
+## License
+
+Closed Source. Proprietary & Confidential. See `LICENSE`.

package/dist/index.cjs

@@ -0,0 +1,203 @@
+"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, {
+  FlagsCache: () => FlagsCache,
+  createFlagsClient: () => createFlagsClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cache.ts
+var FlagsCache = class {
+  constructor(ttl, persist) {
+    this.ttl = ttl;
+    this.persist = persist;
+    this.values = {};
+    this.timestamp = 0;
+    this.load();
+  }
+  set(values) {
+    this.values = values;
+    this.timestamp = Date.now();
+    if (this.persist) this.save();
+  }
+  get(flagKey) {
+    return this.values[flagKey];
+  }
+  isStale() {
+    return this.timestamp === 0 || Date.now() - this.timestamp > this.ttl;
+  }
+  clear() {
+    this.values = {};
+    this.timestamp = 0;
+    if (this.persist && typeof localStorage !== "undefined") {
+      localStorage.removeItem("flags_cache");
+    }
+  }
+  save() {
+    if (typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(
+        "flags_cache",
+        JSON.stringify({
+          values: this.values,
+          timestamp: this.timestamp
+        })
+      );
+    } catch {
+    }
+  }
+  load() {
+    if (!this.persist || typeof localStorage === "undefined") return;
+    try {
+      const raw = localStorage.getItem("flags_cache");
+      if (!raw) return;
+      const parsed = JSON.parse(raw);
+      if (parsed?.values && typeof parsed.timestamp === "number") {
+        this.values = parsed.values;
+        this.timestamp = parsed.timestamp;
+      }
+    } catch {
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_TTL = 3e4;
+function warn(message) {
+  if (typeof console !== "undefined" && console.warn) {
+    console.warn(`[org.inovus.flags] ${message}`);
+  }
+}
+var FlagsClientImpl = class {
+  constructor(options) {
+    this.declarations = [];
+    this.proxyUrl = options.proxyUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.ttl = options.ttl ?? DEFAULT_TTL;
+    const persist = options.persist ?? true;
+    this.cache = new FlagsCache(this.ttl, persist);
+  }
+  async init(declarations, context) {
+    this.declarations = declarations;
+    this.context = context;
+    const ok = await this.fetchAndCache(context);
+    if (!ok) {
+      const hasCache = declarations.some((d) => this.cache.get(d.flagKey) !== void 0);
+      if (!hasCache) {
+        warn("init: Worker unreachable and no persisted cache; getX() will use defaults");
+      }
+    }
+    this.startBackgroundRefresh();
+  }
+  async refresh(context) {
+    if (context !== void 0) {
+      this.context = context;
+    }
+    const ok = await this.fetchAndCache(this.context);
+    if (!ok) {
+      warn("refresh: failed; keeping existing cache");
+    }
+  }
+  getBoolean(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "boolean");
+  }
+  getString(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "string");
+  }
+  getNumber(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "number");
+  }
+  getObject(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => v !== null && typeof v === "object");
+  }
+  destroy() {
+    if (this.refreshTimer !== void 0) {
+      clearInterval(this.refreshTimer);
+      this.refreshTimer = void 0;
+    }
+  }
+  read(flagKey, defaultValue, guard) {
+    const cached = this.cache.get(flagKey);
+    if (cached === void 0) {
+      warn(`get: flag "${flagKey}" not in cache; using defaultValue`);
+      return defaultValue;
+    }
+    if (!guard(cached)) {
+      warn(`get: flag "${flagKey}" has wrong type in cache; using defaultValue`);
+      return defaultValue;
+    }
+    return cached;
+  }
+  startBackgroundRefresh() {
+    this.destroy();
+    this.refreshTimer = setInterval(() => {
+      void this.refresh();
+    }, this.ttl);
+  }
+  async fetchAndCache(context) {
+    if (this.declarations.length === 0) return true;
+    const body = this.declarations.map((d) => ({
+      flagKey: d.flagKey,
+      type: d.type,
+      defaultValue: d.defaultValue,
+      ...context ? { context } : {}
+    }));
+    try {
+      const response = await fetch(`${this.proxyUrl}/evaluate/batch`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Flags-Api-Key": this.apiKey
+        },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        return false;
+      }
+      const results = await response.json();
+      if (!Array.isArray(results)) {
+        return false;
+      }
+      const values = {};
+      for (const result of results) {
+        if (result && typeof result.flagKey === "string") {
+          values[result.flagKey] = result.value;
+        }
+      }
+      this.cache.set(values);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/index.ts
+function createFlagsClient(options) {
+  return new FlagsClientImpl(options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlagsCache,
+  createFlagsClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cache.ts","../src/client.ts"],"sourcesContent":["import { FlagsClientImpl } from './client';\nimport type { FlagsClient, FlagsClientOptions } from './types';\n\nexport function createFlagsClient(options: FlagsClientOptions): FlagsClient {\n  return new FlagsClientImpl(options);\n}\n\nexport type {\n  CachedFlagStore,\n  EvaluationContext,\n  EvaluationRequest,\n  EvaluationResult,\n  FlagDeclaration,\n  FlagType,\n  FlagsClient,\n  FlagsClientOptions,\n} from './types';\n\nexport { FlagsCache } from './cache';\n","export class FlagsCache {\n  private values: Record<string, unknown> = {};\n  private timestamp = 0;\n\n  constructor(\n    private ttl: number,\n    private persist: boolean\n  ) {\n    this.load();\n  }\n\n  set(values: Record<string, unknown>): void {\n    this.values = values;\n    this.timestamp = Date.now();\n    if (this.persist) this.save();\n  }\n\n  get(flagKey: string): unknown | undefined {\n    return this.values[flagKey];\n  }\n\n  isStale(): boolean {\n    return this.timestamp === 0 || Date.now() - this.timestamp > this.ttl;\n  }\n\n  clear(): void {\n    this.values = {};\n    this.timestamp = 0;\n    if (this.persist && typeof localStorage !== 'undefined') {\n      localStorage.removeItem('flags_cache');\n    }\n  }\n\n  private save(): void {\n    if (typeof localStorage === 'undefined') return;\n    try {\n      localStorage.setItem(\n        'flags_cache',\n        JSON.stringify({\n          values: this.values,\n          timestamp: this.timestamp,\n        })\n      );\n    } catch {\n      /* quota exceeded */\n    }\n  }\n\n  private load(): void {\n    if (!this.persist || typeof localStorage === 'undefined') return;\n    try {\n      const raw = localStorage.getItem('flags_cache');\n      if (!raw) return;\n      const parsed = JSON.parse(raw);\n      if (parsed?.values && typeof parsed.timestamp === 'number') {\n        this.values = parsed.values;\n        this.timestamp = parsed.timestamp;\n      }\n    } catch {\n      /* malformed */\n    }\n  }\n}\n","import { FlagsCache } from './cache';\nimport type {\n  EvaluationContext,\n  EvaluationResult,\n  FlagDeclaration,\n  FlagsClient,\n  FlagsClientOptions,\n} from './types';\n\nconst DEFAULT_TTL = 30_000;\n\nfunction warn(message: string): void {\n  if (typeof console !== 'undefined' && console.warn) {\n    console.warn(`[org.inovus.flags] ${message}`);\n  }\n}\n\nexport class FlagsClientImpl implements FlagsClient {\n  private readonly proxyUrl: string;\n  private readonly apiKey: string;\n  private readonly ttl: number;\n  private readonly cache: FlagsCache;\n  private declarations: FlagDeclaration[] = [];\n  private context: EvaluationContext | undefined;\n  private refreshTimer: ReturnType<typeof setInterval> | undefined;\n\n  constructor(options: FlagsClientOptions) {\n    this.proxyUrl = options.proxyUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.ttl = options.ttl ?? DEFAULT_TTL;\n    const persist = options.persist ?? true;\n    this.cache = new FlagsCache(this.ttl, persist);\n  }\n\n  async init(declarations: FlagDeclaration[], context?: EvaluationContext): Promise<void> {\n    this.declarations = declarations;\n    this.context = context;\n    const ok = await this.fetchAndCache(context);\n    if (!ok) {\n      const hasCache = declarations.some((d) => this.cache.get(d.flagKey) !== undefined);\n      if (!hasCache) {\n        warn('init: Worker unreachable and no persisted cache; getX() will use defaults');\n      }\n    }\n    this.startBackgroundRefresh();\n  }\n\n  async refresh(context?: EvaluationContext): Promise<void> {\n    if (context !== undefined) {\n      this.context = context;\n    }\n    const ok = await this.fetchAndCache(this.context);\n    if (!ok) {\n      warn('refresh: failed; keeping existing cache');\n    }\n  }\n\n  getBoolean(flagKey: string, defaultValue: boolean): boolean {\n    return this.read(flagKey, defaultValue, (v): v is boolean => typeof v === 'boolean');\n  }\n\n  getString(flagKey: string, defaultValue: string): string {\n    return this.read(flagKey, defaultValue, (v): v is string => typeof v === 'string');\n  }\n\n  getNumber(flagKey: string, defaultValue: number): number {\n    return this.read(flagKey, defaultValue, (v): v is number => typeof v === 'number');\n  }\n\n  getObject<T>(flagKey: string, defaultValue: T): T {\n    return this.read(flagKey, defaultValue, (v): v is T => v !== null && typeof v === 'object');\n  }\n\n  destroy(): void {\n    if (this.refreshTimer !== undefined) {\n      clearInterval(this.refreshTimer);\n      this.refreshTimer = undefined;\n    }\n  }\n\n  private read<T>(\n    flagKey: string,\n    defaultValue: T,\n    guard: (value: unknown) => value is T\n  ): T {\n    const cached = this.cache.get(flagKey);\n    if (cached === undefined) {\n      warn(`get: flag \"${flagKey}\" not in cache; using defaultValue`);\n      return defaultValue;\n    }\n    if (!guard(cached)) {\n      warn(`get: flag \"${flagKey}\" has wrong type in cache; using defaultValue`);\n      return defaultValue;\n    }\n    return cached;\n  }\n\n  private startBackgroundRefresh(): void {\n    this.destroy();\n    this.refreshTimer = setInterval(() => {\n      void this.refresh();\n    }, this.ttl);\n  }\n\n  private async fetchAndCache(context?: EvaluationContext): Promise<boolean> {\n    if (this.declarations.length === 0) return true;\n\n    const body = this.declarations.map((d) => ({\n      flagKey: d.flagKey,\n      type: d.type,\n      defaultValue: d.defaultValue,\n      ...(context ? { context } : {}),\n    }));\n\n    try {\n      const response = await fetch(`${this.proxyUrl}/evaluate/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Flags-Api-Key': this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        return false;\n      }\n\n      const results = (await response.json()) as EvaluationResult[];\n      if (!Array.isArray(results)) {\n        return false;\n      }\n\n      const values: Record<string, unknown> = {};\n      for (const result of results) {\n        if (result && typeof result.flagKey === 'string') {\n          values[result.flagKey] = result.value;\n        }\n      }\n      this.cache.set(values);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+type FlagType = 'boolean' | 'string' | 'number' | 'object';
+type EvaluationContext = Record<string, string | number | boolean>;
+interface FlagDeclaration {
+    flagKey: string;
+    type: FlagType;
+    defaultValue: unknown;
+}
+interface EvaluationRequest extends FlagDeclaration {
+    context?: EvaluationContext;
+}
+interface EvaluationResult<T = unknown> {
+    flagKey: string;
+    value: T;
+    reason: string;
+}
+interface CachedFlagStore {
+    values: Record<string, unknown>;
+    timestamp: number;
+}
+interface FlagsClientOptions {
+    proxyUrl: string;
+    apiKey: string;
+    ttl?: number;
+    persist?: boolean;
+}
+interface FlagsClient {
+    init(declarations: FlagDeclaration[], context?: EvaluationContext): Promise<void>;
+    refresh(context?: EvaluationContext): Promise<void>;
+    getBoolean(flagKey: string, defaultValue: boolean): boolean;
+    getString(flagKey: string, defaultValue: string): string;
+    getNumber(flagKey: string, defaultValue: number): number;
+    getObject<T>(flagKey: string, defaultValue: T): T;
+    destroy(): void;
+}
+
+declare class FlagsCache {
+    private ttl;
+    private persist;
+    private values;
+    private timestamp;
+    constructor(ttl: number, persist: boolean);
+    set(values: Record<string, unknown>): void;
+    get(flagKey: string): unknown | undefined;
+    isStale(): boolean;
+    clear(): void;
+    private save;
+    private load;
+}
+
+declare function createFlagsClient(options: FlagsClientOptions): FlagsClient;
+
+export { type CachedFlagStore, type EvaluationContext, type EvaluationRequest, type EvaluationResult, type FlagDeclaration, type FlagType, FlagsCache, type FlagsClient, type FlagsClientOptions, createFlagsClient };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+type FlagType = 'boolean' | 'string' | 'number' | 'object';
+type EvaluationContext = Record<string, string | number | boolean>;
+interface FlagDeclaration {
+    flagKey: string;
+    type: FlagType;
+    defaultValue: unknown;
+}
+interface EvaluationRequest extends FlagDeclaration {
+    context?: EvaluationContext;
+}
+interface EvaluationResult<T = unknown> {
+    flagKey: string;
+    value: T;
+    reason: string;
+}
+interface CachedFlagStore {
+    values: Record<string, unknown>;
+    timestamp: number;
+}
+interface FlagsClientOptions {
+    proxyUrl: string;
+    apiKey: string;
+    ttl?: number;
+    persist?: boolean;
+}
+interface FlagsClient {
+    init(declarations: FlagDeclaration[], context?: EvaluationContext): Promise<void>;
+    refresh(context?: EvaluationContext): Promise<void>;
+    getBoolean(flagKey: string, defaultValue: boolean): boolean;
+    getString(flagKey: string, defaultValue: string): string;
+    getNumber(flagKey: string, defaultValue: number): number;
+    getObject<T>(flagKey: string, defaultValue: T): T;
+    destroy(): void;
+}
+
+declare class FlagsCache {
+    private ttl;
+    private persist;
+    private values;
+    private timestamp;
+    constructor(ttl: number, persist: boolean);
+    set(values: Record<string, unknown>): void;
+    get(flagKey: string): unknown | undefined;
+    isStale(): boolean;
+    clear(): void;
+    private save;
+    private load;
+}
+
+declare function createFlagsClient(options: FlagsClientOptions): FlagsClient;
+
+export { type CachedFlagStore, type EvaluationContext, type EvaluationRequest, type EvaluationResult, type FlagDeclaration, type FlagType, FlagsCache, type FlagsClient, type FlagsClientOptions, createFlagsClient };

package/dist/index.js

@@ -0,0 +1,175 @@
+// src/cache.ts
+var FlagsCache = class {
+  constructor(ttl, persist) {
+    this.ttl = ttl;
+    this.persist = persist;
+    this.values = {};
+    this.timestamp = 0;
+    this.load();
+  }
+  set(values) {
+    this.values = values;
+    this.timestamp = Date.now();
+    if (this.persist) this.save();
+  }
+  get(flagKey) {
+    return this.values[flagKey];
+  }
+  isStale() {
+    return this.timestamp === 0 || Date.now() - this.timestamp > this.ttl;
+  }
+  clear() {
+    this.values = {};
+    this.timestamp = 0;
+    if (this.persist && typeof localStorage !== "undefined") {
+      localStorage.removeItem("flags_cache");
+    }
+  }
+  save() {
+    if (typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(
+        "flags_cache",
+        JSON.stringify({
+          values: this.values,
+          timestamp: this.timestamp
+        })
+      );
+    } catch {
+    }
+  }
+  load() {
+    if (!this.persist || typeof localStorage === "undefined") return;
+    try {
+      const raw = localStorage.getItem("flags_cache");
+      if (!raw) return;
+      const parsed = JSON.parse(raw);
+      if (parsed?.values && typeof parsed.timestamp === "number") {
+        this.values = parsed.values;
+        this.timestamp = parsed.timestamp;
+      }
+    } catch {
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_TTL = 3e4;
+function warn(message) {
+  if (typeof console !== "undefined" && console.warn) {
+    console.warn(`[org.inovus.flags] ${message}`);
+  }
+}
+var FlagsClientImpl = class {
+  constructor(options) {
+    this.declarations = [];
+    this.proxyUrl = options.proxyUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.ttl = options.ttl ?? DEFAULT_TTL;
+    const persist = options.persist ?? true;
+    this.cache = new FlagsCache(this.ttl, persist);
+  }
+  async init(declarations, context) {
+    this.declarations = declarations;
+    this.context = context;
+    const ok = await this.fetchAndCache(context);
+    if (!ok) {
+      const hasCache = declarations.some((d) => this.cache.get(d.flagKey) !== void 0);
+      if (!hasCache) {
+        warn("init: Worker unreachable and no persisted cache; getX() will use defaults");
+      }
+    }
+    this.startBackgroundRefresh();
+  }
+  async refresh(context) {
+    if (context !== void 0) {
+      this.context = context;
+    }
+    const ok = await this.fetchAndCache(this.context);
+    if (!ok) {
+      warn("refresh: failed; keeping existing cache");
+    }
+  }
+  getBoolean(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "boolean");
+  }
+  getString(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "string");
+  }
+  getNumber(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => typeof v === "number");
+  }
+  getObject(flagKey, defaultValue) {
+    return this.read(flagKey, defaultValue, (v) => v !== null && typeof v === "object");
+  }
+  destroy() {
+    if (this.refreshTimer !== void 0) {
+      clearInterval(this.refreshTimer);
+      this.refreshTimer = void 0;
+    }
+  }
+  read(flagKey, defaultValue, guard) {
+    const cached = this.cache.get(flagKey);
+    if (cached === void 0) {
+      warn(`get: flag "${flagKey}" not in cache; using defaultValue`);
+      return defaultValue;
+    }
+    if (!guard(cached)) {
+      warn(`get: flag "${flagKey}" has wrong type in cache; using defaultValue`);
+      return defaultValue;
+    }
+    return cached;
+  }
+  startBackgroundRefresh() {
+    this.destroy();
+    this.refreshTimer = setInterval(() => {
+      void this.refresh();
+    }, this.ttl);
+  }
+  async fetchAndCache(context) {
+    if (this.declarations.length === 0) return true;
+    const body = this.declarations.map((d) => ({
+      flagKey: d.flagKey,
+      type: d.type,
+      defaultValue: d.defaultValue,
+      ...context ? { context } : {}
+    }));
+    try {
+      const response = await fetch(`${this.proxyUrl}/evaluate/batch`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Flags-Api-Key": this.apiKey
+        },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        return false;
+      }
+      const results = await response.json();
+      if (!Array.isArray(results)) {
+        return false;
+      }
+      const values = {};
+      for (const result of results) {
+        if (result && typeof result.flagKey === "string") {
+          values[result.flagKey] = result.value;
+        }
+      }
+      this.cache.set(values);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/index.ts
+function createFlagsClient(options) {
+  return new FlagsClientImpl(options);
+}
+export {
+  FlagsCache,
+  createFlagsClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts","../src/client.ts","../src/index.ts"],"sourcesContent":["export class FlagsCache {\n  private values: Record<string, unknown> = {};\n  private timestamp = 0;\n\n  constructor(\n    private ttl: number,\n    private persist: boolean\n  ) {\n    this.load();\n  }\n\n  set(values: Record<string, unknown>): void {\n    this.values = values;\n    this.timestamp = Date.now();\n    if (this.persist) this.save();\n  }\n\n  get(flagKey: string): unknown | undefined {\n    return this.values[flagKey];\n  }\n\n  isStale(): boolean {\n    return this.timestamp === 0 || Date.now() - this.timestamp > this.ttl;\n  }\n\n  clear(): void {\n    this.values = {};\n    this.timestamp = 0;\n    if (this.persist && typeof localStorage !== 'undefined') {\n      localStorage.removeItem('flags_cache');\n    }\n  }\n\n  private save(): void {\n    if (typeof localStorage === 'undefined') return;\n    try {\n      localStorage.setItem(\n        'flags_cache',\n        JSON.stringify({\n          values: this.values,\n          timestamp: this.timestamp,\n        })\n      );\n    } catch {\n      /* quota exceeded */\n    }\n  }\n\n  private load(): void {\n    if (!this.persist || typeof localStorage === 'undefined') return;\n    try {\n      const raw = localStorage.getItem('flags_cache');\n      if (!raw) return;\n      const parsed = JSON.parse(raw);\n      if (parsed?.values && typeof parsed.timestamp === 'number') {\n        this.values = parsed.values;\n        this.timestamp = parsed.timestamp;\n      }\n    } catch {\n      /* malformed */\n    }\n  }\n}\n","import { FlagsCache } from './cache';\nimport type {\n  EvaluationContext,\n  EvaluationResult,\n  FlagDeclaration,\n  FlagsClient,\n  FlagsClientOptions,\n} from './types';\n\nconst DEFAULT_TTL = 30_000;\n\nfunction warn(message: string): void {\n  if (typeof console !== 'undefined' && console.warn) {\n    console.warn(`[org.inovus.flags] ${message}`);\n  }\n}\n\nexport class FlagsClientImpl implements FlagsClient {\n  private readonly proxyUrl: string;\n  private readonly apiKey: string;\n  private readonly ttl: number;\n  private readonly cache: FlagsCache;\n  private declarations: FlagDeclaration[] = [];\n  private context: EvaluationContext | undefined;\n  private refreshTimer: ReturnType<typeof setInterval> | undefined;\n\n  constructor(options: FlagsClientOptions) {\n    this.proxyUrl = options.proxyUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.ttl = options.ttl ?? DEFAULT_TTL;\n    const persist = options.persist ?? true;\n    this.cache = new FlagsCache(this.ttl, persist);\n  }\n\n  async init(declarations: FlagDeclaration[], context?: EvaluationContext): Promise<void> {\n    this.declarations = declarations;\n    this.context = context;\n    const ok = await this.fetchAndCache(context);\n    if (!ok) {\n      const hasCache = declarations.some((d) => this.cache.get(d.flagKey) !== undefined);\n      if (!hasCache) {\n        warn('init: Worker unreachable and no persisted cache; getX() will use defaults');\n      }\n    }\n    this.startBackgroundRefresh();\n  }\n\n  async refresh(context?: EvaluationContext): Promise<void> {\n    if (context !== undefined) {\n      this.context = context;\n    }\n    const ok = await this.fetchAndCache(this.context);\n    if (!ok) {\n      warn('refresh: failed; keeping existing cache');\n    }\n  }\n\n  getBoolean(flagKey: string, defaultValue: boolean): boolean {\n    return this.read(flagKey, defaultValue, (v): v is boolean => typeof v === 'boolean');\n  }\n\n  getString(flagKey: string, defaultValue: string): string {\n    return this.read(flagKey, defaultValue, (v): v is string => typeof v === 'string');\n  }\n\n  getNumber(flagKey: string, defaultValue: number): number {\n    return this.read(flagKey, defaultValue, (v): v is number => typeof v === 'number');\n  }\n\n  getObject<T>(flagKey: string, defaultValue: T): T {\n    return this.read(flagKey, defaultValue, (v): v is T => v !== null && typeof v === 'object');\n  }\n\n  destroy(): void {\n    if (this.refreshTimer !== undefined) {\n      clearInterval(this.refreshTimer);\n      this.refreshTimer = undefined;\n    }\n  }\n\n  private read<T>(\n    flagKey: string,\n    defaultValue: T,\n    guard: (value: unknown) => value is T\n  ): T {\n    const cached = this.cache.get(flagKey);\n    if (cached === undefined) {\n      warn(`get: flag \"${flagKey}\" not in cache; using defaultValue`);\n      return defaultValue;\n    }\n    if (!guard(cached)) {\n      warn(`get: flag \"${flagKey}\" has wrong type in cache; using defaultValue`);\n      return defaultValue;\n    }\n    return cached;\n  }\n\n  private startBackgroundRefresh(): void {\n    this.destroy();\n    this.refreshTimer = setInterval(() => {\n      void this.refresh();\n    }, this.ttl);\n  }\n\n  private async fetchAndCache(context?: EvaluationContext): Promise<boolean> {\n    if (this.declarations.length === 0) return true;\n\n    const body = this.declarations.map((d) => ({\n      flagKey: d.flagKey,\n      type: d.type,\n      defaultValue: d.defaultValue,\n      ...(context ? { context } : {}),\n    }));\n\n    try {\n      const response = await fetch(`${this.proxyUrl}/evaluate/batch`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'X-Flags-Api-Key': this.apiKey,\n        },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        return false;\n      }\n\n      const results = (await response.json()) as EvaluationResult[];\n      if (!Array.isArray(results)) {\n        return false;\n      }\n\n      const values: Record<string, unknown> = {};\n      for (const result of results) {\n        if (result && typeof result.flagKey === 'string') {\n          values[result.flagKey] = result.value;\n        }\n      }\n      this.cache.set(values);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n","import { FlagsClientImpl } from './client';\nimport type { FlagsClient, FlagsClientOptions } from './types';\n\nexport function createFlagsClient(options: FlagsClientOptions): FlagsClient {\n  return new FlagsClientImpl(options);\n}\n\nexport type {\n  CachedFlagStore,\n  EvaluationContext,\n  EvaluationRequest,\n  EvaluationResult,\n  FlagDeclaration,\n  FlagType,\n  FlagsClient,\n  FlagsClientOptions,\n} from './types';\n\nexport { FlagsCache } from './cache';\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "org.inovus.flags",
+  "version": "1.0.0",
+  "description": "TypeScript client for cf-flags-proxy with stale-while-revalidate caching",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.0.9",
+    "happy-dom": "^17.4.4",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  }
+}