@featureflare/sdk-js 0.0.5 → 0.0.7

package/README.md

@@ -35,6 +35,7 @@ The SDK automatically reads from environment variables if `sdkKey` is not provid
 
 - `FEATUREFLARE_CLIENT_KEY` - Client SDK key (for browser/mobile)
 - `FEATUREFLARE_SERVER_KEY` - Server SDK key (for backend)
+- `FEATUREFLARE_ENV_KEY` - Expected environment key binding (`development`, `staging`, `production`, etc.)
 
 ```typescript
 // In Node.js, this will use FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY from env
@@ -94,6 +95,8 @@ new FeatureFlareClient(options?: FeatureFlareClientOptions)
 - `projectKey?: string` - Legacy: project key (requires `envKey`). Not recommended.
 - `envKey?: string` - Environment key (default: `'production'`). Only used with `projectKey`.
 
+When using `sdkKey`, `envKey` is sent as an expected environment binding. The API rejects requests if the key's actual environment does not match `envKey`.
+
 #### Methods
 
 ##### `bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>`
@@ -112,6 +115,21 @@ Returns `Promise<boolean>` - The flag value for the user.
 const enabled = await featureflare.bool('new-nav', { id: 'user-123' }, false);
 ```
 
+##### `flags(user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<Record<string, boolean>>`
+
+Fetches all boolean flags for the provided user.
+
+- `user`: User payload with `id` or `key` (required)
+- `defaultValue`: Default value to apply for missing/offline evaluations (default: `false`)
+
+Returns `Promise<Record<string, boolean>>` - A map of `flagKey -> value`.
+
+**Example:**
+
+```typescript
+const allFlags = await featureflare.flags({ id: 'user-123' }, false);
+```
+
 ## Error Handling
 
 If the API request fails (network error, non-2xx status), the SDK returns the `defaultValue`. Network errors (DNS, timeout, connection refused) will throw; wrap calls in `try/catch` if you want to handle them.

package/dist/index.cjs

@@ -15,6 +15,12 @@ function getApiBaseUrl(explicit) {
   if (fromEnv) return fromEnv;
   return DEFAULT_FEATUREFLARE_API_BASE_URL;
 }
+function getEnvKeyFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.FEATUREFLARE_ENV_KEY?.trim() || process.env.SHIPIT_ENV_KEY?.trim() || null;
+  }
+  return null;
+}
 function getSdkKeyFromEnv() {
   if (typeof process !== "undefined" && process.env) {
     return process.env.FEATUREFLARE_CLIENT_KEY?.trim() || process.env.FEATUREFLARE_SERVER_KEY?.trim() || process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
@@ -26,11 +32,14 @@ var FeatureFlareClient = class {
   sdkKey;
   projectKey;
   envKey;
+  expectedEnvKey;
   constructor(options = {}) {
     this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\/$/, "");
     this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();
     this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;
-    this.envKey = options.envKey ?? "production";
+    const resolvedEnvKey = options.envKey?.trim() || getEnvKeyFromEnv() || "production";
+    this.envKey = resolvedEnvKey;
+    this.expectedEnvKey = resolvedEnvKey;
     if (!this.sdkKey && !this.projectKey) {
       throw new Error(
         "FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options."
@@ -59,7 +68,8 @@ var FeatureFlareClient = class {
       body: JSON.stringify({
         flagKey,
         user: normalizedUser,
-        defaultValue
+        defaultValue,
+        expectedEnvKey: this.expectedEnvKey ?? void 0
       })
     }) : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {
       method: "POST",
@@ -76,6 +86,33 @@ var FeatureFlareClient = class {
     const json = await res.json();
     return json.value;
   }
+  async flags(user, defaultValue = false) {
+    if (!this.sdkKey) {
+      throw new Error("FeatureFlareClient.flags requires sdkKey. Legacy projectKey mode does not support listing all flags.");
+    }
+    const normalizedUser = this.normalizeUser(user);
+    const res = await fetch(`${this.apiBaseUrl}/api/v1/sdk/flags`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-featureflare-sdk-key": this.sdkKey
+      },
+      body: JSON.stringify({
+        user: normalizedUser,
+        defaultValue,
+        expectedEnvKey: this.expectedEnvKey ?? void 0
+      })
+    });
+    if (!res.ok) return [];
+    const json = await res.json();
+    if (Array.isArray(json.flags)) {
+      return json.flags.filter(
+        (entry) => !!entry && typeof entry.key === "string" && typeof entry.value === "boolean"
+      ).map((entry) => ({ key: entry.key, value: entry.value }));
+    }
+    const values = json.values ?? {};
+    return Object.entries(values).map(([key, value]) => ({ key, value: Boolean(value) }));
+  }
 };
 
 exports.FeatureFlareClient = FeatureFlareClient;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export type FeatureFlareUserPayload = {\n  /** Unique user identifier (preferred). */\n  id?: string;\n  /** Legacy alias for id. */\n  key?: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  /** Queryable attributes. */\n  meta?: Record<string, string | number | boolean | null>;\n  /** Legacy alias for meta. */\n  custom?: Record<string, string | number | boolean | null>;\n};\n\ntype FeatureFlareUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nconst DEFAULT_FEATUREFLARE_API_BASE_URL =\n  'https://shipit-api-392444455847.us-central1.run.app';\n\nfunction getApiBaseUrlFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_API_BASE_URL?.trim() ||\n      process.env.SHIPIT_API_BASE_URL?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getApiBaseUrl(explicit?: string): string {\n  const fromOptions = explicit?.trim();\n  if (fromOptions) return fromOptions;\n\n  const fromEnv = getApiBaseUrlFromEnv();\n  if (fromEnv) return fromEnv;\n\n  return DEFAULT_FEATUREFLARE_API_BASE_URL;\n}\n\nexport type FeatureFlareClientOptions = {\n  apiBaseUrl?: string;\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_CLIENT_KEY?.trim() ||\n      process.env.FEATUREFLARE_SERVER_KEY?.trim() ||\n      process.env.SHIPIT_CLIENT_KEY?.trim() ||\n      process.env.SHIPIT_SERVER_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nexport class FeatureFlareClient {\n  private readonly apiBaseUrl: string;\n  private readonly sdkKey: string | null;\n  private readonly projectKey: string | null;\n  private readonly envKey: string;\n\n  constructor(options: FeatureFlareClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\\/$/, '');\n    this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();\n    this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;\n    this.envKey = options.envKey ?? 'production';\n\n    if (!this.sdkKey && !this.projectKey) {\n      throw new Error(\n        'FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options.'\n      );\n    }\n  }\n\n  private normalizeUser(input: FeatureFlareUserPayload): FeatureFlareUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('FeatureFlareClient requires user.id (or legacy user.key).');\n    return {\n      key,\n      email: input.email,\n      name: input.name,\n      country: input.country,\n      custom: input.meta ?? input.custom\n    };\n  }\n\n  async bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue = false): Promise<boolean> {\n    const normalizedUser = this.normalizeUser(user);\n    const res = this.sdkKey\n      ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {\n          method: 'POST',\n          headers: {\n            'content-type': 'application/json',\n            'x-featureflare-sdk-key': this.sdkKey\n          },\n          body: JSON.stringify({\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        })\n      : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify({\n            projectKey: this.projectKey,\n            envKey: this.envKey,\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        });\n\n    if (!res.ok) return defaultValue;\n    const json = (await res.json()) as { value: boolean };\n    return json.value;\n  }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export type FeatureFlareUserPayload = {\n  /** Unique user identifier (preferred). */\n  id?: string;\n  /** Legacy alias for id. */\n  key?: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  /** Queryable attributes. */\n  meta?: Record<string, string | number | boolean | null>;\n  /** Legacy alias for meta. */\n  custom?: Record<string, string | number | boolean | null>;\n};\n\ntype FeatureFlareUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nconst DEFAULT_FEATUREFLARE_API_BASE_URL =\n  'https://shipit-api-392444455847.us-central1.run.app';\n\nfunction getApiBaseUrlFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_API_BASE_URL?.trim() ||\n      process.env.SHIPIT_API_BASE_URL?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getApiBaseUrl(explicit?: string): string {\n  const fromOptions = explicit?.trim();\n  if (fromOptions) return fromOptions;\n\n  const fromEnv = getApiBaseUrlFromEnv();\n  if (fromEnv) return fromEnv;\n\n  return DEFAULT_FEATUREFLARE_API_BASE_URL;\n}\n\nexport type FeatureFlareClientOptions = {\n  apiBaseUrl?: string;\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getEnvKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_ENV_KEY?.trim() ||\n      process.env.SHIPIT_ENV_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_CLIENT_KEY?.trim() ||\n      process.env.FEATUREFLARE_SERVER_KEY?.trim() ||\n      process.env.SHIPIT_CLIENT_KEY?.trim() ||\n      process.env.SHIPIT_SERVER_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nexport class FeatureFlareClient {\n  private readonly apiBaseUrl: string;\n  private readonly sdkKey: string | null;\n  private readonly projectKey: string | null;\n  private readonly envKey: string;\n  private readonly expectedEnvKey: string | null;\n\n  constructor(options: FeatureFlareClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\\/$/, '');\n    this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();\n    this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;\n    const resolvedEnvKey = options.envKey?.trim() || getEnvKeyFromEnv() || 'production';\n    this.envKey = resolvedEnvKey;\n    this.expectedEnvKey = resolvedEnvKey;\n\n    if (!this.sdkKey && !this.projectKey) {\n      throw new Error(\n        'FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options.'\n      );\n    }\n  }\n\n  private normalizeUser(input: FeatureFlareUserPayload): FeatureFlareUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('FeatureFlareClient requires user.id (or legacy user.key).');\n    return {\n      key,\n      email: input.email,\n      name: input.name,\n      country: input.country,\n      custom: input.meta ?? input.custom\n    };\n  }\n\n  async bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue = false): Promise<boolean> {\n    const normalizedUser = this.normalizeUser(user);\n    const res = this.sdkKey\n      ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {\n          method: 'POST',\n          headers: {\n            'content-type': 'application/json',\n            'x-featureflare-sdk-key': this.sdkKey\n          },\n          body: JSON.stringify({\n            flagKey,\n            user: normalizedUser,\n            defaultValue,\n            expectedEnvKey: this.expectedEnvKey ?? undefined\n          })\n        })\n      : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify({\n            projectKey: this.projectKey,\n            envKey: this.envKey,\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        });\n\n    if (!res.ok) return defaultValue;\n    const json = (await res.json()) as { value: boolean };\n    return json.value;\n  }\n\n  async flags(user: FeatureFlareUserPayload, defaultValue = false): Promise<Array<{ key: string; value: boolean }>> {\n    if (!this.sdkKey) {\n      throw new Error('FeatureFlareClient.flags requires sdkKey. Legacy projectKey mode does not support listing all flags.');\n    }\n\n    const normalizedUser = this.normalizeUser(user);\n    const res = await fetch(`${this.apiBaseUrl}/api/v1/sdk/flags`, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        'x-featureflare-sdk-key': this.sdkKey\n      },\n      body: JSON.stringify({\n        user: normalizedUser,\n        defaultValue,\n        expectedEnvKey: this.expectedEnvKey ?? undefined\n      })\n    });\n\n    if (!res.ok) return [];\n    const json = (await res.json()) as {\n      flags?: Array<{ key: string; value: boolean }>;\n      values?: Record<string, boolean>;\n    };\n\n    if (Array.isArray(json.flags)) {\n      return json.flags\n        .filter((entry): entry is { key: string; value: boolean } =>\n          !!entry && typeof entry.key === 'string' && typeof entry.value === 'boolean'\n        )\n        .map((entry) => ({ key: entry.key, value: entry.value }));\n    }\n\n    const values = json.values ?? {};\n    return Object.entries(values).map(([key, value]) => ({ key, value: Boolean(value) }));\n  }\n}\n"]}

package/dist/index.d.cts

@@ -22,9 +22,14 @@ declare class FeatureFlareClient {
     private readonly sdkKey;
     private readonly projectKey;
     private readonly envKey;
+    private readonly expectedEnvKey;
     constructor(options?: FeatureFlareClientOptions);
     private normalizeUser;
     bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>;
+    flags(user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<Array<{
+        key: string;
+        value: boolean;
+    }>>;
 }
 
 export { FeatureFlareClient, type FeatureFlareClientOptions, type FeatureFlareUserPayload };

package/dist/index.d.ts

@@ -22,9 +22,14 @@ declare class FeatureFlareClient {
     private readonly sdkKey;
     private readonly projectKey;
     private readonly envKey;
+    private readonly expectedEnvKey;
     constructor(options?: FeatureFlareClientOptions);
     private normalizeUser;
     bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>;
+    flags(user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<Array<{
+        key: string;
+        value: boolean;
+    }>>;
 }
 
 export { FeatureFlareClient, type FeatureFlareClientOptions, type FeatureFlareUserPayload };

package/dist/index.js

@@ -13,6 +13,12 @@ function getApiBaseUrl(explicit) {
   if (fromEnv) return fromEnv;
   return DEFAULT_FEATUREFLARE_API_BASE_URL;
 }
+function getEnvKeyFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.FEATUREFLARE_ENV_KEY?.trim() || process.env.SHIPIT_ENV_KEY?.trim() || null;
+  }
+  return null;
+}
 function getSdkKeyFromEnv() {
   if (typeof process !== "undefined" && process.env) {
     return process.env.FEATUREFLARE_CLIENT_KEY?.trim() || process.env.FEATUREFLARE_SERVER_KEY?.trim() || process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
@@ -24,11 +30,14 @@ var FeatureFlareClient = class {
   sdkKey;
   projectKey;
   envKey;
+  expectedEnvKey;
   constructor(options = {}) {
     this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\/$/, "");
     this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();
     this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;
-    this.envKey = options.envKey ?? "production";
+    const resolvedEnvKey = options.envKey?.trim() || getEnvKeyFromEnv() || "production";
+    this.envKey = resolvedEnvKey;
+    this.expectedEnvKey = resolvedEnvKey;
     if (!this.sdkKey && !this.projectKey) {
       throw new Error(
         "FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options."
@@ -57,7 +66,8 @@ var FeatureFlareClient = class {
       body: JSON.stringify({
         flagKey,
         user: normalizedUser,
-        defaultValue
+        defaultValue,
+        expectedEnvKey: this.expectedEnvKey ?? void 0
       })
     }) : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {
       method: "POST",
@@ -74,6 +84,33 @@ var FeatureFlareClient = class {
     const json = await res.json();
     return json.value;
   }
+  async flags(user, defaultValue = false) {
+    if (!this.sdkKey) {
+      throw new Error("FeatureFlareClient.flags requires sdkKey. Legacy projectKey mode does not support listing all flags.");
+    }
+    const normalizedUser = this.normalizeUser(user);
+    const res = await fetch(`${this.apiBaseUrl}/api/v1/sdk/flags`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-featureflare-sdk-key": this.sdkKey
+      },
+      body: JSON.stringify({
+        user: normalizedUser,
+        defaultValue,
+        expectedEnvKey: this.expectedEnvKey ?? void 0
+      })
+    });
+    if (!res.ok) return [];
+    const json = await res.json();
+    if (Array.isArray(json.flags)) {
+      return json.flags.filter(
+        (entry) => !!entry && typeof entry.key === "string" && typeof entry.value === "boolean"
+      ).map((entry) => ({ key: entry.key, value: entry.value }));
+    }
+    const values = json.values ?? {};
+    return Object.entries(values).map(([key, value]) => ({ key, value: Boolean(value) }));
+  }
 };
 
 export { FeatureFlareClient };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type FeatureFlareUserPayload = {\n  /** Unique user identifier (preferred). */\n  id?: string;\n  /** Legacy alias for id. */\n  key?: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  /** Queryable attributes. */\n  meta?: Record<string, string | number | boolean | null>;\n  /** Legacy alias for meta. */\n  custom?: Record<string, string | number | boolean | null>;\n};\n\ntype FeatureFlareUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nconst DEFAULT_FEATUREFLARE_API_BASE_URL =\n  'https://shipit-api-392444455847.us-central1.run.app';\n\nfunction getApiBaseUrlFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_API_BASE_URL?.trim() ||\n      process.env.SHIPIT_API_BASE_URL?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getApiBaseUrl(explicit?: string): string {\n  const fromOptions = explicit?.trim();\n  if (fromOptions) return fromOptions;\n\n  const fromEnv = getApiBaseUrlFromEnv();\n  if (fromEnv) return fromEnv;\n\n  return DEFAULT_FEATUREFLARE_API_BASE_URL;\n}\n\nexport type FeatureFlareClientOptions = {\n  apiBaseUrl?: string;\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_CLIENT_KEY?.trim() ||\n      process.env.FEATUREFLARE_SERVER_KEY?.trim() ||\n      process.env.SHIPIT_CLIENT_KEY?.trim() ||\n      process.env.SHIPIT_SERVER_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nexport class FeatureFlareClient {\n  private readonly apiBaseUrl: string;\n  private readonly sdkKey: string | null;\n  private readonly projectKey: string | null;\n  private readonly envKey: string;\n\n  constructor(options: FeatureFlareClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\\/$/, '');\n    this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();\n    this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;\n    this.envKey = options.envKey ?? 'production';\n\n    if (!this.sdkKey && !this.projectKey) {\n      throw new Error(\n        'FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options.'\n      );\n    }\n  }\n\n  private normalizeUser(input: FeatureFlareUserPayload): FeatureFlareUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('FeatureFlareClient requires user.id (or legacy user.key).');\n    return {\n      key,\n      email: input.email,\n      name: input.name,\n      country: input.country,\n      custom: input.meta ?? input.custom\n    };\n  }\n\n  async bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue = false): Promise<boolean> {\n    const normalizedUser = this.normalizeUser(user);\n    const res = this.sdkKey\n      ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {\n          method: 'POST',\n          headers: {\n            'content-type': 'application/json',\n            'x-featureflare-sdk-key': this.sdkKey\n          },\n          body: JSON.stringify({\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        })\n      : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify({\n            projectKey: this.projectKey,\n            envKey: this.envKey,\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        });\n\n    if (!res.ok) return defaultValue;\n    const json = (await res.json()) as { value: boolean };\n    return json.value;\n  }\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type FeatureFlareUserPayload = {\n  /** Unique user identifier (preferred). */\n  id?: string;\n  /** Legacy alias for id. */\n  key?: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  /** Queryable attributes. */\n  meta?: Record<string, string | number | boolean | null>;\n  /** Legacy alias for meta. */\n  custom?: Record<string, string | number | boolean | null>;\n};\n\ntype FeatureFlareUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nconst DEFAULT_FEATUREFLARE_API_BASE_URL =\n  'https://shipit-api-392444455847.us-central1.run.app';\n\nfunction getApiBaseUrlFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_API_BASE_URL?.trim() ||\n      process.env.SHIPIT_API_BASE_URL?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getApiBaseUrl(explicit?: string): string {\n  const fromOptions = explicit?.trim();\n  if (fromOptions) return fromOptions;\n\n  const fromEnv = getApiBaseUrlFromEnv();\n  if (fromEnv) return fromEnv;\n\n  return DEFAULT_FEATUREFLARE_API_BASE_URL;\n}\n\nexport type FeatureFlareClientOptions = {\n  apiBaseUrl?: string;\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getEnvKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_ENV_KEY?.trim() ||\n      process.env.SHIPIT_ENV_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.FEATUREFLARE_CLIENT_KEY?.trim() ||\n      process.env.FEATUREFLARE_SERVER_KEY?.trim() ||\n      process.env.SHIPIT_CLIENT_KEY?.trim() ||\n      process.env.SHIPIT_SERVER_KEY?.trim() ||\n      null\n    );\n  }\n  return null;\n}\n\nexport class FeatureFlareClient {\n  private readonly apiBaseUrl: string;\n  private readonly sdkKey: string | null;\n  private readonly projectKey: string | null;\n  private readonly envKey: string;\n  private readonly expectedEnvKey: string | null;\n\n  constructor(options: FeatureFlareClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl(options.apiBaseUrl).replace(/\\/$/, '');\n    this.sdkKey = options.sdkKey?.trim() || getSdkKeyFromEnv();\n    this.projectKey = options.projectKey?.trim() ? options.projectKey.trim() : null;\n    const resolvedEnvKey = options.envKey?.trim() || getEnvKeyFromEnv() || 'production';\n    this.envKey = resolvedEnvKey;\n    this.expectedEnvKey = resolvedEnvKey;\n\n    if (!this.sdkKey && !this.projectKey) {\n      throw new Error(\n        'FeatureFlareClient requires either sdkKey (recommended) or projectKey (legacy). Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey in options.'\n      );\n    }\n  }\n\n  private normalizeUser(input: FeatureFlareUserPayload): FeatureFlareUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('FeatureFlareClient requires user.id (or legacy user.key).');\n    return {\n      key,\n      email: input.email,\n      name: input.name,\n      country: input.country,\n      custom: input.meta ?? input.custom\n    };\n  }\n\n  async bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue = false): Promise<boolean> {\n    const normalizedUser = this.normalizeUser(user);\n    const res = this.sdkKey\n      ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {\n          method: 'POST',\n          headers: {\n            'content-type': 'application/json',\n            'x-featureflare-sdk-key': this.sdkKey\n          },\n          body: JSON.stringify({\n            flagKey,\n            user: normalizedUser,\n            defaultValue,\n            expectedEnvKey: this.expectedEnvKey ?? undefined\n          })\n        })\n      : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify({\n            projectKey: this.projectKey,\n            envKey: this.envKey,\n            flagKey,\n            user: normalizedUser,\n            defaultValue\n          })\n        });\n\n    if (!res.ok) return defaultValue;\n    const json = (await res.json()) as { value: boolean };\n    return json.value;\n  }\n\n  async flags(user: FeatureFlareUserPayload, defaultValue = false): Promise<Array<{ key: string; value: boolean }>> {\n    if (!this.sdkKey) {\n      throw new Error('FeatureFlareClient.flags requires sdkKey. Legacy projectKey mode does not support listing all flags.');\n    }\n\n    const normalizedUser = this.normalizeUser(user);\n    const res = await fetch(`${this.apiBaseUrl}/api/v1/sdk/flags`, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        'x-featureflare-sdk-key': this.sdkKey\n      },\n      body: JSON.stringify({\n        user: normalizedUser,\n        defaultValue,\n        expectedEnvKey: this.expectedEnvKey ?? undefined\n      })\n    });\n\n    if (!res.ok) return [];\n    const json = (await res.json()) as {\n      flags?: Array<{ key: string; value: boolean }>;\n      values?: Record<string, boolean>;\n    };\n\n    if (Array.isArray(json.flags)) {\n      return json.flags\n        .filter((entry): entry is { key: string; value: boolean } =>\n          !!entry && typeof entry.key === 'string' && typeof entry.value === 'boolean'\n        )\n        .map((entry) => ({ key: entry.key, value: entry.value }));\n    }\n\n    const values = json.values ?? {};\n    return Object.entries(values).map(([key, value]) => ({ key, value: Boolean(value) }));\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featureflare/sdk-js",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "private": false,
   "publishConfig": {
     "access": "public"