@featureflare/sdk-js 0.0.1

package/README.md

@@ -0,0 +1,130 @@
+# @featureflare/sdk-js
+
+JavaScript/TypeScript SDK for ShipIt feature flags.
+
+## Installation
+
+```bash
+npm install @featureflare/sdk-js
+# or
+pnpm add @featureflare/sdk-js
+# or
+yarn add @featureflare/sdk-js
+```
+
+## Usage
+
+### Basic Example
+
+```typescript
+import { ShipItClient } 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({
+  sdkKey: 'your-sdk-key-here'
+});
+
+const enabled = await shipit.bool('new-nav', { id: 'user-123' }, false);
+console.log(enabled);
+```
+
+### Environment Variables
+
+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)
+
+```typescript
+// In Node.js, this will use SHIPIT_CLIENT_KEY or SHIPIT_SERVER_KEY from env
+const shipit = new ShipItClient();
+```
+
+### 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
+
+The API URL cannot be overridden.
+
+### User Payload
+
+```typescript
+import { ShipItClient, type ShipItUserPayload } from '@featureflare/sdk-js';
+
+const user: ShipItUserPayload = {
+  id: 'user-123',        // Required: unique user identifier
+  email: 'user@example.com',
+  name: 'John Doe',
+  country: 'US',
+  meta: {                // Custom attributes for targeting
+    companyId: 'acme',
+    plan: 'pro'
+  }
+};
+
+const enabled = await shipit.bool('feature-flag', user, false);
+```
+
+## API Reference
+
+### `ShipItClient`
+
+#### Constructor
+
+```typescript
+new ShipItClient(options?: ShipItClientOptions)
+```
+
+**Options:**
+
+- `sdkKey?: string` - SDK key (client or server). If not provided, reads from `SHIPIT_CLIENT_KEY` or `SHIPIT_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>`
+
+Evaluates a boolean feature flag for a user.
+
+- `flagKey`: The flag key to evaluate
+- `user`: User payload with `id` or `key` (required)
+- `defaultValue`: Default value if evaluation fails (default: `false`)
+
+Returns `Promise<boolean>` - The flag value for the user.
+
+**Example:**
+
+```typescript
+const enabled = await shipit.bool('new-nav', { 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.
+
+```typescript
+try {
+  const enabled = await shipit.bool('flag', user, false);
+} catch (error) {
+  // Handle network errors
+  console.error('Failed to evaluate flag:', error);
+}
+```
+
+## SDK Keys
+
+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.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+// src/index.ts
+function getApiBaseUrl() {
+  if (typeof window !== "undefined" && typeof window.location !== "undefined") {
+    return window.location.origin;
+  }
+  return "https://shipit-api-246728836834.us-central1.run.app";
+}
+function getSdkKeyFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
+  }
+  return null;
+}
+var ShipItClient = class {
+  apiBaseUrl;
+  sdkKey;
+  projectKey;
+  envKey;
+  constructor(options = {}) {
+    this.apiBaseUrl = getApiBaseUrl().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.");
+    }
+  }
+  normalizeUser(input) {
+    const key = (input.id ?? input.key ?? "").trim();
+    if (!key) throw new Error("ShipItClient requires user.id (or legacy user.key).");
+    return {
+      key,
+      email: input.email,
+      name: input.name,
+      country: input.country,
+      custom: input.meta ?? input.custom
+    };
+  }
+  async bool(flagKey, user, defaultValue = false) {
+    const normalizedUser = this.normalizeUser(user);
+    const res = this.sdkKey ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-featureflare-sdk-key": this.sdkKey
+      },
+      body: JSON.stringify({
+        flagKey,
+        user: normalizedUser,
+        defaultValue
+      })
+    }) : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        projectKey: this.projectKey,
+        envKey: this.envKey,
+        flagKey,
+        user: normalizedUser,
+        defaultValue
+      })
+    });
+    if (!res.ok) return defaultValue;
+    const json = await res.json();
+    return json.value;
+  }
+};
+
+exports.ShipItClient = ShipItClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"]}

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+type ShipItUserPayload = {
+    /** Unique user identifier (preferred). */
+    id?: string;
+    /** Legacy alias for id. */
+    key?: string;
+    email?: string;
+    name?: string;
+    country?: string;
+    /** Queryable attributes. */
+    meta?: Record<string, string | number | boolean | null>;
+    /** Legacy alias for meta. */
+    custom?: Record<string, string | number | boolean | null>;
+};
+type ShipItClientOptions = {
+    sdkKey?: string;
+    projectKey?: string;
+    envKey?: string;
+};
+declare class ShipItClient {
+    private readonly apiBaseUrl;
+    private readonly sdkKey;
+    private readonly projectKey;
+    private readonly envKey;
+    constructor(options?: ShipItClientOptions);
+    private normalizeUser;
+    bool(flagKey: string, user: ShipItUserPayload, defaultValue?: boolean): Promise<boolean>;
+}
+
+export { ShipItClient, type ShipItClientOptions, type ShipItUserPayload };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+type ShipItUserPayload = {
+    /** Unique user identifier (preferred). */
+    id?: string;
+    /** Legacy alias for id. */
+    key?: string;
+    email?: string;
+    name?: string;
+    country?: string;
+    /** Queryable attributes. */
+    meta?: Record<string, string | number | boolean | null>;
+    /** Legacy alias for meta. */
+    custom?: Record<string, string | number | boolean | null>;
+};
+type ShipItClientOptions = {
+    sdkKey?: string;
+    projectKey?: string;
+    envKey?: string;
+};
+declare class ShipItClient {
+    private readonly apiBaseUrl;
+    private readonly sdkKey;
+    private readonly projectKey;
+    private readonly envKey;
+    constructor(options?: ShipItClientOptions);
+    private normalizeUser;
+    bool(flagKey: string, user: ShipItUserPayload, defaultValue?: boolean): Promise<boolean>;
+}
+
+export { ShipItClient, type ShipItClientOptions, type ShipItUserPayload };

package/dist/index.js

@@ -0,0 +1,71 @@
+// src/index.ts
+function getApiBaseUrl() {
+  if (typeof window !== "undefined" && typeof window.location !== "undefined") {
+    return window.location.origin;
+  }
+  return "https://shipit-api-246728836834.us-central1.run.app";
+}
+function getSdkKeyFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.SHIPIT_CLIENT_KEY?.trim() || process.env.SHIPIT_SERVER_KEY?.trim() || null;
+  }
+  return null;
+}
+var ShipItClient = class {
+  apiBaseUrl;
+  sdkKey;
+  projectKey;
+  envKey;
+  constructor(options = {}) {
+    this.apiBaseUrl = getApiBaseUrl().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.");
+    }
+  }
+  normalizeUser(input) {
+    const key = (input.id ?? input.key ?? "").trim();
+    if (!key) throw new Error("ShipItClient requires user.id (or legacy user.key).");
+    return {
+      key,
+      email: input.email,
+      name: input.name,
+      country: input.country,
+      custom: input.meta ?? input.custom
+    };
+  }
+  async bool(flagKey, user, defaultValue = false) {
+    const normalizedUser = this.normalizeUser(user);
+    const res = this.sdkKey ? await fetch(`${this.apiBaseUrl}/api/v1/sdk/eval`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-featureflare-sdk-key": this.sdkKey
+      },
+      body: JSON.stringify({
+        flagKey,
+        user: normalizedUser,
+        defaultValue
+      })
+    }) : await fetch(`${this.apiBaseUrl}/api/v1/eval`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        projectKey: this.projectKey,
+        envKey: this.envKey,
+        flagKey,
+        user: normalizedUser,
+        defaultValue
+      })
+    });
+    if (!res.ok) return defaultValue;
+    const json = await res.json();
+    return json.value;
+  }
+};
+
+export { ShipItClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@featureflare/sdk-js",
+  "version": "0.0.1",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "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",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "format": "prettier -w ."
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "eslint": "^9.16.0",
+    "prettier": "^3.4.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.17.0"
+  }
+}