@featureflare/sdk-js 0.0.3 → 0.0.4

package/README.md

@@ -1,6 +1,6 @@
 # @featureflare/sdk-js
 
-JavaScript/TypeScript SDK for ShipIt feature flags.
+JavaScript/TypeScript SDK for FeatureFlare feature flags.
 
 ## Installation
 
@@ -17,15 +17,15 @@ yarn add @featureflare/sdk-js
 ### Basic Example
 
 ```typescript
-import { ShipItClient } from '@featureflare/sdk-js';
+import { FeatureFlareClient } from '@featureflare/sdk-js';
 
 // SDK automatically uses production API URL
-// Set SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY env var, or pass sdkKey explicitly
-const shipit = new ShipItClient({
+// Set FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY env var, or pass sdkKey explicitly
+const featureflare = new FeatureFlareClient({
   sdkKey: 'your-sdk-key-here'
 });
 
-const enabled = await shipit.bool('new-nav', { id: 'user-123' }, false);
+const enabled = await featureflare.bool('new-nav', { id: 'user-123' }, false);
 console.log(enabled);
 ```
 
@@ -33,29 +33,37 @@ console.log(enabled);
 
 The SDK automatically reads from environment variables if `sdkKey` is not provided:
 
-- `SHIPIT_CLIENT_KEY` - Client SDK key (for browser/mobile)
-- `SHIPIT_SERVER_KEY` - Server SDK key (for backend)
+- `FEATUREFLARE_CLIENT_KEY` - Client SDK key (for browser/mobile)
+- `FEATUREFLARE_SERVER_KEY` - Server SDK key (for backend)
 
 ```typescript
-// In Node.js, this will use SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY from env
-const shipit = new ShipItClient();
+// In Node.js, this will use FEATUREFLARE_CLIENT_KEY or FEATUREFLARE_SERVER_KEY from env
+const featureflare = new FeatureFlareClient();
 ```
 
 ### API Base URL
 
 The SDK automatically determines the API base URL:
 
-- **Browser**: Uses `window.location.origin` (assumes API is on same origin)
-- **Node.js**: Uses the production ShipIt API endpoint
+- **`options.apiBaseUrl`**: Highest priority if provided.
+- **Environment variables**: `FEATUREFLARE_API_BASE_URL`, then `SHIPIT_API_BASE_URL`.
+- **Default fallback**: `https://shipit-api-392444455847.us-central1.run.app`.
 
-The API URL cannot be overridden.
+Example override:
+
+```typescript
+const featureflare = new FeatureFlareClient({
+  apiBaseUrl: 'https://shipit-api-392444455847.us-central1.run.app',
+  sdkKey: 'featureflare_cli_...'
+});
+```
 
 ### User Payload
 
 ```typescript
-import { ShipItClient, type ShipItUserPayload } from '@featureflare/sdk-js';
+import { FeatureFlareClient, type FeatureFlareUserPayload } from '@featureflare/sdk-js';
 
-const user: ShipItUserPayload = {
+const user: FeatureFlareUserPayload = {
   id: 'user-123',        // Required: unique user identifier
   email: 'user@example.com',
   name: 'John Doe',
@@ -66,28 +74,29 @@ const user: ShipItUserPayload = {
   }
 };
 
-const enabled = await shipit.bool('feature-flag', user, false);
+const enabled = await featureflare.bool('feature-flag', user, false);
 ```
 
 ## API Reference
 
-### `ShipItClient`
+### `FeatureFlareClient`
 
 #### Constructor
 
 ```typescript
-new ShipItClient(options?: ShipItClientOptions)
+new FeatureFlareClient(options?: FeatureFlareClientOptions)
 ```
 
 **Options:**
 
-- `sdkKey?: string` - SDK key (client or server). If not provided, reads from `SHIPIT_CLIENT_KEY` or `SHIPIT_SERVER_KEY` env vars.
+- `apiBaseUrl?: string` - Explicit FeatureFlare API base URL.
+- `sdkKey?: string` - SDK key (client or server). If not provided, reads from `FEATUREFLARE_CLIENT_KEY` or `FEATUREFLARE_SERVER_KEY` env vars.
 - `projectKey?: string` - Legacy: project key (requires `envKey`). Not recommended.
 - `envKey?: string` - Environment key (default: `'production'`). Only used with `projectKey`.
 
 #### Methods
 
-##### `bool(flagKey: string, user: ShipItUserPayload, defaultValue?: boolean): Promise<boolean>`
+##### `bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>`
 
 Evaluates a boolean feature flag for a user.
 
@@ -100,7 +109,7 @@ Returns `Promise<boolean>` - The flag value for the user.
 **Example:**
 
 ```typescript
-const enabled = await shipit.bool('new-nav', { id: 'user-123' }, false);
+const enabled = await featureflare.bool('new-nav', { id: 'user-123' }, false);
 ```
 
 ## Error Handling
@@ -109,7 +118,7 @@ If the API request fails (network error, non-2xx status), the SDK returns the `d
 
 ```typescript
 try {
-  const enabled = await shipit.bool('flag', user, false);
+  const enabled = await featureflare.bool('flag', user, false);
 } catch (error) {
   // Handle network errors
   console.error('Failed to evaluate flag:', error);
@@ -123,7 +132,7 @@ Each environment has two SDK keys:
 - **Server key**: Secret. Use only in trusted server environments.
 - **Client key**: Not a secret. Intended for browser/mobile SDKs.
 
-Get your SDK keys from your ShipIt Console → Environments.
+Get your SDK keys from your FeatureFlare Console → Environments.
 
 ## License
 

package/dist/index.cjs

@@ -1,35 +1,45 @@
 'use strict';
 
 // src/index.ts
-function getApiBaseUrl() {
-  if (typeof window !== "undefined" && typeof window.location !== "undefined") {
-    return window.location.origin;
+var DEFAULT_FEATUREFLARE_API_BASE_URL = "https://shipit-api-392444455847.us-central1.run.app";
+function getApiBaseUrlFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.FEATUREFLARE_API_BASE_URL?.trim() || process.env.SHIPIT_API_BASE_URL?.trim() || null;
   }
-  return "https://shipit-api-246728836834.us-central1.run.app";
+  return null;
+}
+function getApiBaseUrl(explicit) {
+  const fromOptions = explicit?.trim();
+  if (fromOptions) return fromOptions;
+  const fromEnv = getApiBaseUrlFromEnv();
+  if (fromEnv) return fromEnv;
+  return DEFAULT_FEATUREFLARE_API_BASE_URL;
 }
 function getSdkKeyFromEnv() {
   if (typeof process !== "undefined" && process.env) {
-    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
+    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;
   }
   return null;
 }
-var ShipItClient = class {
+var FeatureFlareClient = class {
   apiBaseUrl;
   sdkKey;
   projectKey;
   envKey;
   constructor(options = {}) {
-    this.apiBaseUrl = getApiBaseUrl().replace(/\/$/, "");
+    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";
     if (!this.sdkKey && !this.projectKey) {
-      throw new Error("ShipItClient requires either sdkKey (recommended) or projectKey (legacy). Set SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY env var, or pass sdkKey in options.");
+      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."
+      );
     }
   }
   normalizeUser(input) {
     const key = (input.id ?? input.key ?? "").trim();
-    if (!key) throw new Error("ShipItClient requires user.id (or legacy user.key).");
+    if (!key) throw new Error("FeatureFlareClient requires user.id (or legacy user.key).");
     return {
       key,
       email: input.email,
@@ -68,6 +78,6 @@ var ShipItClient = class {
   }
 };
 
-exports.ShipItClient = ShipItClient;
+exports.FeatureFlareClient = FeatureFlareClient;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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 ShipItUserPayload = {\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 ShipItUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nfunction getApiBaseUrl(): string {\n  // Browser: use current origin (assumes API is on same origin)\n  if (typeof window !== 'undefined' && typeof (window as any).location !== 'undefined') {\n    return (window as any).location.origin;\n  }\n  // Node.js: always use production API\n  return 'https://shipit-api-246728836834.us-central1.run.app';\n}\n\nexport type ShipItClientOptions = {\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;\n  }\n  return null;\n}\n\nexport class ShipItClient {\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: ShipItClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl().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('ShipItClient requires either sdkKey (recommended) or projectKey (legacy). Set SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY env var, or pass sdkKey in options.');\n    }\n  }\n\n  private normalizeUser(input: ShipItUserPayload): ShipItUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('ShipItClient 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: ShipItUserPayload, 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 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"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-type ShipItUserPayload = {
+type FeatureFlareUserPayload = {
     /** Unique user identifier (preferred). */
     id?: string;
     /** Legacy alias for id. */
@@ -11,19 +11,20 @@ type ShipItUserPayload = {
     /** Legacy alias for meta. */
     custom?: Record<string, string | number | boolean | null>;
 };
-type ShipItClientOptions = {
+type FeatureFlareClientOptions = {
+    apiBaseUrl?: string;
     sdkKey?: string;
     projectKey?: string;
     envKey?: string;
 };
-declare class ShipItClient {
+declare class FeatureFlareClient {
     private readonly apiBaseUrl;
     private readonly sdkKey;
     private readonly projectKey;
     private readonly envKey;
-    constructor(options?: ShipItClientOptions);
+    constructor(options?: FeatureFlareClientOptions);
     private normalizeUser;
-    bool(flagKey: string, user: ShipItUserPayload, defaultValue?: boolean): Promise<boolean>;
+    bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>;
 }
 
-export { ShipItClient, type ShipItClientOptions, type ShipItUserPayload };
+export { FeatureFlareClient, type FeatureFlareClientOptions, type FeatureFlareUserPayload };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type ShipItUserPayload = {
+type FeatureFlareUserPayload = {
     /** Unique user identifier (preferred). */
     id?: string;
     /** Legacy alias for id. */
@@ -11,19 +11,20 @@ type ShipItUserPayload = {
     /** Legacy alias for meta. */
     custom?: Record<string, string | number | boolean | null>;
 };
-type ShipItClientOptions = {
+type FeatureFlareClientOptions = {
+    apiBaseUrl?: string;
     sdkKey?: string;
     projectKey?: string;
     envKey?: string;
 };
-declare class ShipItClient {
+declare class FeatureFlareClient {
     private readonly apiBaseUrl;
     private readonly sdkKey;
     private readonly projectKey;
     private readonly envKey;
-    constructor(options?: ShipItClientOptions);
+    constructor(options?: FeatureFlareClientOptions);
     private normalizeUser;
-    bool(flagKey: string, user: ShipItUserPayload, defaultValue?: boolean): Promise<boolean>;
+    bool(flagKey: string, user: FeatureFlareUserPayload, defaultValue?: boolean): Promise<boolean>;
 }
 
-export { ShipItClient, type ShipItClientOptions, type ShipItUserPayload };
+export { FeatureFlareClient, type FeatureFlareClientOptions, type FeatureFlareUserPayload };

package/dist/index.js

@@ -1,33 +1,43 @@
 // src/index.ts
-function getApiBaseUrl() {
-  if (typeof window !== "undefined" && typeof window.location !== "undefined") {
-    return window.location.origin;
+var DEFAULT_FEATUREFLARE_API_BASE_URL = "https://shipit-api-392444455847.us-central1.run.app";
+function getApiBaseUrlFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.FEATUREFLARE_API_BASE_URL?.trim() || process.env.SHIPIT_API_BASE_URL?.trim() || null;
   }
-  return "https://shipit-api-246728836834.us-central1.run.app";
+  return null;
+}
+function getApiBaseUrl(explicit) {
+  const fromOptions = explicit?.trim();
+  if (fromOptions) return fromOptions;
+  const fromEnv = getApiBaseUrlFromEnv();
+  if (fromEnv) return fromEnv;
+  return DEFAULT_FEATUREFLARE_API_BASE_URL;
 }
 function getSdkKeyFromEnv() {
   if (typeof process !== "undefined" && process.env) {
-    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
+    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;
   }
   return null;
 }
-var ShipItClient = class {
+var FeatureFlareClient = class {
   apiBaseUrl;
   sdkKey;
   projectKey;
   envKey;
   constructor(options = {}) {
-    this.apiBaseUrl = getApiBaseUrl().replace(/\/$/, "");
+    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";
     if (!this.sdkKey && !this.projectKey) {
-      throw new Error("ShipItClient requires either sdkKey (recommended) or projectKey (legacy). Set SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY env var, or pass sdkKey in options.");
+      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."
+      );
     }
   }
   normalizeUser(input) {
     const key = (input.id ?? input.key ?? "").trim();
-    if (!key) throw new Error("ShipItClient requires user.id (or legacy user.key).");
+    if (!key) throw new Error("FeatureFlareClient requires user.id (or legacy user.key).");
     return {
       key,
       email: input.email,
@@ -66,6 +76,6 @@ var ShipItClient = class {
   }
 };
 
-export { ShipItClient };
+export { FeatureFlareClient };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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 ShipItUserPayload = {\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 ShipItUser = {\n  key: string;\n  email?: string;\n  name?: string;\n  country?: string;\n  custom?: Record<string, string | number | boolean | null>;\n};\n\nfunction getApiBaseUrl(): string {\n  // Browser: use current origin (assumes API is on same origin)\n  if (typeof window !== 'undefined' && typeof (window as any).location !== 'undefined') {\n    return (window as any).location.origin;\n  }\n  // Node.js: always use production API\n  return 'https://shipit-api-246728836834.us-central1.run.app';\n}\n\nexport type ShipItClientOptions = {\n  sdkKey?: string;\n  projectKey?: string;\n  envKey?: string;\n};\n\nfunction getSdkKeyFromEnv(): string | null {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;\n  }\n  return null;\n}\n\nexport class ShipItClient {\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: ShipItClientOptions = {}) {\n    this.apiBaseUrl = getApiBaseUrl().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('ShipItClient requires either sdkKey (recommended) or projectKey (legacy). Set SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY env var, or pass sdkKey in options.');\n    }\n  }\n\n  private normalizeUser(input: ShipItUserPayload): ShipItUser {\n    const key = (input.id ?? input.key ?? '').trim();\n    if (!key) throw new Error('ShipItClient 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: ShipItUserPayload, 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 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"]}

package/package.json

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