zubbl-sdk 1.0.0 → 1.0.1

package/dist/zubbl-sdk.cjs.js

@@ -1,19 +1,54 @@
 'use strict';
 
+// index.js
+
 let _apiKey = null;
+let _tenantId = null;
+let _appId = null;
 
-function init({ apiKey }) {
+function init({ apiKey, tenantId, appId }) {
   if (!apiKey) throw new Error("API key required for Zubbl SDK");
+  if (!tenantId) throw new Error("tenantId required for Zubbl SDK");
+  if (!appId) throw new Error("appId required for Zubbl SDK");
   _apiKey = apiKey;
+  _tenantId = tenantId;
+  _appId = appId;
 }
 
-async function identifyUser({ external_user_id, email, name }) {
-  if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
-  if (!external_user_id) throw new Error("external_user_id is required");
-  const res = await fetch("https://api.zubbl.com/sdk/identify/" + external_user_id, {
+/**
+ * identifyUser({ email, name, external_user_id? })
+ * - If external_user_id present, legacy fast path.
+ * - If not, POST to /sdk/identify with {email, name} (backend creates or returns user).
+ * Always includes X-Tenant-ID and X-App-ID headers.
+ */
+async function identifyUser({ email, name, external_user_id }) {
+  if (!_apiKey || !_tenantId || !_appId)
+    throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
+
+  // Fast path if ext ID provided (legacy)
+  if (external_user_id) {
+    const res = await fetch(`https://api.zubbl.com/sdk/identify/${external_user_id}`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${_apiKey}`,
+        "X-Tenant-ID": _tenantId,
+        "X-App-ID": _appId,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ email, name })
+    });
+    if (!res.ok) throw new Error(`Identify failed: ${res.status}`);
+    return res.json();
+  }
+
+  // Modern plug-and-play: only email/name
+  if (!email) throw new Error("email is required");
+  const res = await fetch("https://api.zubbl.com/sdk/identify", {
     method: "POST",
     headers: {
       "Authorization": `Bearer ${_apiKey}`,
+      "X-Tenant-ID": _tenantId,
+      "X-App-ID": _appId,
       "Content-Type": "application/json"
     },
     body: JSON.stringify({ email, name })
@@ -23,11 +58,14 @@ async function identifyUser({ external_user_id, email, name }) {
 }
 
 async function getTiles({ external_user_id }) {
-  if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
+  if (!_apiKey || !_tenantId || !_appId)
+    throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
   if (!external_user_id) throw new Error("external_user_id is required");
-  const res = await fetch("https://api.zubbl.com/sdk/external-users/" + external_user_id + "/tiles", {
+  const res = await fetch(`https://api.zubbl.com/sdk/external-users/${external_user_id}/tiles`, {
     headers: {
-      "Authorization": `Bearer ${_apiKey}`
+      "Authorization": `Bearer ${_apiKey}`,
+      "X-Tenant-ID": _tenantId,
+      "X-App-ID": _appId
     }
   });
   if (!res.ok) throw new Error(`getTiles failed: ${res.status}`);

package/dist/zubbl-sdk.esm.js

@@ -1,17 +1,52 @@
+// index.js
+
 let _apiKey = null;
+let _tenantId = null;
+let _appId = null;
 
-function init({ apiKey }) {
+function init({ apiKey, tenantId, appId }) {
   if (!apiKey) throw new Error("API key required for Zubbl SDK");
+  if (!tenantId) throw new Error("tenantId required for Zubbl SDK");
+  if (!appId) throw new Error("appId required for Zubbl SDK");
   _apiKey = apiKey;
+  _tenantId = tenantId;
+  _appId = appId;
 }
 
-async function identifyUser({ external_user_id, email, name }) {
-  if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
-  if (!external_user_id) throw new Error("external_user_id is required");
-  const res = await fetch("https://api.zubbl.com/sdk/identify/" + external_user_id, {
+/**
+ * identifyUser({ email, name, external_user_id? })
+ * - If external_user_id present, legacy fast path.
+ * - If not, POST to /sdk/identify with {email, name} (backend creates or returns user).
+ * Always includes X-Tenant-ID and X-App-ID headers.
+ */
+async function identifyUser({ email, name, external_user_id }) {
+  if (!_apiKey || !_tenantId || !_appId)
+    throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
+
+  // Fast path if ext ID provided (legacy)
+  if (external_user_id) {
+    const res = await fetch(`https://api.zubbl.com/sdk/identify/${external_user_id}`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${_apiKey}`,
+        "X-Tenant-ID": _tenantId,
+        "X-App-ID": _appId,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ email, name })
+    });
+    if (!res.ok) throw new Error(`Identify failed: ${res.status}`);
+    return res.json();
+  }
+
+  // Modern plug-and-play: only email/name
+  if (!email) throw new Error("email is required");
+  const res = await fetch("https://api.zubbl.com/sdk/identify", {
     method: "POST",
     headers: {
       "Authorization": `Bearer ${_apiKey}`,
+      "X-Tenant-ID": _tenantId,
+      "X-App-ID": _appId,
       "Content-Type": "application/json"
     },
     body: JSON.stringify({ email, name })
@@ -21,11 +56,14 @@ async function identifyUser({ external_user_id, email, name }) {
 }
 
 async function getTiles({ external_user_id }) {
-  if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
+  if (!_apiKey || !_tenantId || !_appId)
+    throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
   if (!external_user_id) throw new Error("external_user_id is required");
-  const res = await fetch("https://api.zubbl.com/sdk/external-users/" + external_user_id + "/tiles", {
+  const res = await fetch(`https://api.zubbl.com/sdk/external-users/${external_user_id}/tiles`, {
     headers: {
-      "Authorization": `Bearer ${_apiKey}`
+      "Authorization": `Bearer ${_apiKey}`,
+      "X-Tenant-ID": _tenantId,
+      "X-App-ID": _appId
     }
   });
   if (!res.ok) throw new Error(`getTiles failed: ${res.status}`);

package/dist/zubbl-sdk.umd.js

@@ -4,20 +4,55 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.ZubblSdk = factory());
 })(this, (function () { 'use strict';
 
+  // index.js
+
   let _apiKey = null;
+  let _tenantId = null;
+  let _appId = null;
 
-  function init({ apiKey }) {
+  function init({ apiKey, tenantId, appId }) {
     if (!apiKey) throw new Error("API key required for Zubbl SDK");
+    if (!tenantId) throw new Error("tenantId required for Zubbl SDK");
+    if (!appId) throw new Error("appId required for Zubbl SDK");
     _apiKey = apiKey;
+    _tenantId = tenantId;
+    _appId = appId;
   }
 
-  async function identifyUser({ external_user_id, email, name }) {
-    if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
-    if (!external_user_id) throw new Error("external_user_id is required");
-    const res = await fetch("https://api.zubbl.com/sdk/identify/" + external_user_id, {
+  /**
+   * identifyUser({ email, name, external_user_id? })
+   * - If external_user_id present, legacy fast path.
+   * - If not, POST to /sdk/identify with {email, name} (backend creates or returns user).
+   * Always includes X-Tenant-ID and X-App-ID headers.
+   */
+  async function identifyUser({ email, name, external_user_id }) {
+    if (!_apiKey || !_tenantId || !_appId)
+      throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
+
+    // Fast path if ext ID provided (legacy)
+    if (external_user_id) {
+      const res = await fetch(`https://api.zubbl.com/sdk/identify/${external_user_id}`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${_apiKey}`,
+          "X-Tenant-ID": _tenantId,
+          "X-App-ID": _appId,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ email, name })
+      });
+      if (!res.ok) throw new Error(`Identify failed: ${res.status}`);
+      return res.json();
+    }
+
+    // Modern plug-and-play: only email/name
+    if (!email) throw new Error("email is required");
+    const res = await fetch("https://api.zubbl.com/sdk/identify", {
       method: "POST",
       headers: {
         "Authorization": `Bearer ${_apiKey}`,
+        "X-Tenant-ID": _tenantId,
+        "X-App-ID": _appId,
         "Content-Type": "application/json"
       },
       body: JSON.stringify({ email, name })
@@ -27,11 +62,14 @@
   }
 
   async function getTiles({ external_user_id }) {
-    if (!_apiKey) throw new Error("Call init({ apiKey }) before using SDK methods!");
+    if (!_apiKey || !_tenantId || !_appId)
+      throw new Error("Call init({ apiKey, tenantId, appId }) before using SDK methods!");
     if (!external_user_id) throw new Error("external_user_id is required");
-    const res = await fetch("https://api.zubbl.com/sdk/external-users/" + external_user_id + "/tiles", {
+    const res = await fetch(`https://api.zubbl.com/sdk/external-users/${external_user_id}/tiles`, {
       headers: {
-        "Authorization": `Bearer ${_apiKey}`
+        "Authorization": `Bearer ${_apiKey}`,
+        "X-Tenant-ID": _tenantId,
+        "X-App-ID": _appId
       }
     });
     if (!res.ok) throw new Error(`getTiles failed: ${res.status}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zubbl-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Zubbl SDK for secure policy enforcement (browser, Node, universal)",
   "main": "dist/zubbl-sdk.cjs.js",
   "module": "dist/zubbl-sdk.esm.js",
@@ -29,5 +29,8 @@
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^16.0.1",
     "rollup": "^4.2.0"
+  },
+  "dependencies": {
+    "zubbl-sdk": "^1.0.0"
   }
 }

package/src/index.d.ts

@@ -1,15 +1,52 @@
-export interface IdentifyUserParams {
-  external_user_id: string;
-  email?: string;
-  name?: string;
-}
+declare module "zubbl-sdk" {
+  interface ZubblInitOptions {
+    apiKey: string;
+    tenantId: string;
+    appId: string;
+  }
+
+  interface IdentifyUserParams {
+    email: string;
+    name?: string;
+    external_user_id?: string;
+  }
+
+  interface IdentifyUserResponse {
+    external_user_id: string;
+    tenant_id: string;
+    app_id: string;
+    group_name?: string | null;
+    created: boolean;
+  }
+
+  interface GetTilesParams {
+    external_user_id: string;
+  }
+
+  interface Tile {
+    tile_name: string;
+    rule_data: any;
+    scope: string;
+  }
+
+  interface GetTilesResponse {
+    external_user_id: string;
+    tenant_id: string;
+    app_id: string;
+    group_name?: string | null;
+    tiles: Tile[];
+  }
+
+  export function init(options: ZubblInitOptions): void;
+  export function identifyUser(params: IdentifyUserParams): Promise<IdentifyUserResponse>;
+  export function getTiles(params: GetTilesParams): Promise<GetTilesResponse>;
+
+  const _default: {
+    init: typeof init;
+    identifyUser: typeof identifyUser;
+    getTiles: typeof getTiles;
+  };
 
-export interface Tile {
-  tile_name: string;
-  rule_data: any;
-  scope: string;
+  export default _default;
 }
 
-export function init(params: { apiKey: string }): void;
-export function identifyUser(params: IdentifyUserParams): Promise<any>;
-export function getTiles(params: { external_user_id: string }): Promise<{ tiles: Tile[] }>;