zone4code-sdk 1.0.2 → 1.0.4

package/dist/index.js

@@ -1,23 +1,3 @@
-// src/storage.ts
-var MemoryStorage = class {
-  store = /* @__PURE__ */ new Map();
-  getItem(key) {
-    return this.store.get(key) ?? null;
-  }
-  setItem(key, value) {
-    this.store.set(key, value);
-  }
-  removeItem(key) {
-    this.store.delete(key);
-  }
-};
-function getDefaultStorage() {
-  if (typeof window !== "undefined" && window.localStorage) {
-    return window.localStorage;
-  }
-  return new MemoryStorage();
-}
-
 // src/auth.ts
 function decodeJwtPayload(token) {
   try {
@@ -42,7 +22,9 @@ var AuthClient = class _AuthClient {
   tenantId;
   storage;
   storageKey;
+  refreshStorageKey;
   token = null;
+  refreshTokenValue = null;
   fetchFn;
   static TOKEN_KEY_PREFIX = "z4c_token_";
   constructor(options) {
@@ -50,6 +32,7 @@ var AuthClient = class _AuthClient {
     this.tenantId = options.tenantId;
     this.storage = options.storage;
     this.storageKey = options.storageKey || _AuthClient.TOKEN_KEY_PREFIX + this.tenantId;
+    this.refreshStorageKey = this.storageKey + "_refresh";
     this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
     if (options.initialToken) {
       this.setToken(options.initialToken);
@@ -58,11 +41,18 @@ var AuthClient = class _AuthClient {
         if (stored) this.token = stored;
       }).catch(() => {
       });
+      Promise.resolve(this.storage.getItem(this.refreshStorageKey)).then((stored) => {
+        if (stored) this.refreshTokenValue = stored;
+      }).catch(() => {
+      });
     }
   }
   getToken() {
     return this.token;
   }
+  getRefreshToken() {
+    return this.refreshTokenValue;
+  }
   setToken(token) {
     this.token = token;
     if (token) {
@@ -71,6 +61,14 @@ var AuthClient = class _AuthClient {
       this.storage.removeItem(this.storageKey);
     }
   }
+  setRefreshToken(token) {
+    this.refreshTokenValue = token;
+    if (token) {
+      this.storage.setItem(this.refreshStorageKey, token);
+    } else {
+      this.storage.removeItem(this.refreshStorageKey);
+    }
+  }
   isAuthenticated() {
     return !!this.token;
   }
@@ -179,6 +177,9 @@ var AuthClient = class _AuthClient {
     if (token) {
       this.setToken(token);
     }
+    if (json.refresh_token) {
+      this.setRefreshToken(json.refresh_token);
+    }
     const user = this.getUser() || json.user;
     return {
       token: token || "",
@@ -187,6 +188,163 @@ var AuthClient = class _AuthClient {
       ...json
     };
   }
+  /**
+   * Authenticate via Google OAuth ID token
+   */
+  async loginWithGoogle(token) {
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/login/google`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      },
+      body: JSON.stringify({ token })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || err.error || `Google login failed with HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    const jwt = json.token || json.access_token;
+    if (jwt) {
+      this.setToken(jwt);
+    }
+    if (json.refresh_token) {
+      this.setRefreshToken(json.refresh_token);
+    }
+    const user = this.getUser() || json.user;
+    return {
+      token: jwt || "",
+      refreshToken: json.refresh_token,
+      user,
+      ...json
+    };
+  }
+  /**
+   * Renew expired access token using stored or provided refresh token
+   */
+  async refreshToken(refreshToken) {
+    const tokenToUse = refreshToken || this.getRefreshToken();
+    if (!tokenToUse) {
+      throw new Error("No refresh token available");
+    }
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/refresh`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      },
+      body: JSON.stringify({ refresh_token: tokenToUse })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || err.error || `Token refresh failed with HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    const token = json.token || json.access_token;
+    if (token) {
+      this.setToken(token);
+    }
+    if (json.refresh_token) {
+      this.setRefreshToken(json.refresh_token);
+    }
+    const user = this.getUser() || json.user;
+    return {
+      token: token || "",
+      refreshToken: json.refresh_token,
+      user,
+      ...json
+    };
+  }
+  /**
+   * Request password reset email
+   */
+  async forgotPassword(data) {
+    const payload = typeof data === "string" ? { email: data } : data;
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/auth/forgot-password`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      },
+      body: JSON.stringify(payload)
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(json.message || json.error || `Forgot password request failed with HTTP ${res.status}`);
+    }
+    return json;
+  }
+  /**
+   * Complete password reset using action token
+   */
+  async resetPassword(data) {
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/auth/reset-password`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      },
+      body: JSON.stringify(data)
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(json.message || json.error || `Reset password failed with HTTP ${res.status}`);
+    }
+    return json;
+  }
+  /**
+   * Change password for current or specified user
+   */
+  async changePassword(data, userId) {
+    const targetUserId = userId || this.getUser()?.id;
+    if (!targetUserId) {
+      throw new Error("User ID required: user is not logged in and no userId was provided");
+    }
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/user/${targetUserId}/change-password`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId,
+        ...this.token ? { "Authorization": `Bearer ${this.token}` } : {}
+      },
+      body: JSON.stringify(data)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || err.error || `Change password failed with HTTP ${res.status}`);
+    }
+    return res.json().catch(() => ({ success: true }));
+  }
+  /**
+   * Update profile attributes for current or specified user
+   */
+  async updateProfile(data, userId) {
+    const targetUserId = userId || this.getUser()?.id;
+    if (!targetUserId) {
+      throw new Error("User ID required: user is not logged in and no userId was provided");
+    }
+    const url = `${this.gatewayUrl}/auth/${this.tenantId}/user/${targetUserId}`;
+    const res = await this.fetchFn(url, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId,
+        ...this.token ? { "Authorization": `Bearer ${this.token}` } : {}
+      },
+      body: JSON.stringify(data)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || err.error || `Update profile failed with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
   /**
    * Fetch current authenticated user profile
    */
@@ -212,51 +370,11 @@ var AuthClient = class _AuthClient {
     return res.json();
   }
   /**
-   * Log out and clear saved token
+   * Log out and clear saved tokens
    */
   logout() {
     this.setToken(null);
-  }
-};
-
-// src/schema.ts
-var SchemaClient = class {
-  gatewayUrl;
-  tenantId;
-  getToken;
-  fetchFn;
-  constructor(options) {
-    this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
-    this.tenantId = options.tenantId;
-    this.getToken = options.getToken;
-    this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
-  }
-  getHeaders() {
-    const headers = {
-      "Content-Type": "application/json",
-      "x-tenant-id": this.tenantId
-    };
-    const token = this.getToken();
-    if (token) {
-      headers["Authorization"] = `Bearer ${token}`;
-    }
-    return headers;
-  }
-  /**
-   * Define a new JSON Schema or alter an existing schema for an entity type in real-time
-   */
-  async define(definition) {
-    const url = `${this.gatewayUrl}/generic/${this.tenantId}/definition`;
-    const res = await this.fetchFn(url, {
-      method: "POST",
-      headers: this.getHeaders(),
-      body: JSON.stringify(definition)
-    });
-    if (!res.ok) {
-      const err = await res.json().catch(() => ({ message: res.statusText }));
-      throw new Error(err.message || `Failed to define schema for ${definition.typeName}`);
-    }
-    return res.json();
+    this.setRefreshToken(null);
   }
 };
 
@@ -343,6 +461,19 @@ var EntityQueryBuilder = class {
     this.queryParams.append(`related[${relationName}]`, ids);
     return this;
   }
+  /**
+   * Declaratively expand graph relations (Supabase-style join expansion)
+   * Example: .include('placed_by', 'payment', 'items')
+   */
+  include(...relations) {
+    const existing = this.queryParams.get("include");
+    const existingList = existing ? existing.split(",").map((s) => s.trim()) : [];
+    const combined = Array.from(/* @__PURE__ */ new Set([...existingList, ...relations.map((s) => s.trim())])).filter(Boolean);
+    if (combined.length > 0) {
+      this.queryParams.set("include", combined.join(","));
+    }
+    return this;
+  }
   // ----------------------------------------------------
   // Sorting, Pagination & Modifiers
   // ----------------------------------------------------
@@ -391,10 +522,21 @@ var EntityQueryBuilder = class {
     return res.json();
   }
   /**
-   * Fetch a single entity by ID
+   * Fetch a single entity by ID with optional expansion and flattening
    */
-  async get(id) {
-    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}`;
+  async get(id, options) {
+    const params = new URLSearchParams(this.queryParams);
+    if (options?.flat !== void 0) {
+      params.set("flat", options.flat ? "true" : "false");
+    }
+    if (options?.include && options.include.length > 0) {
+      const existing = params.get("include");
+      const existingList = existing ? existing.split(",").map((s) => s.trim()) : [];
+      const combined = Array.from(/* @__PURE__ */ new Set([...existingList, ...options.include.map((s) => s.trim())])).filter(Boolean);
+      params.set("include", combined.join(","));
+    }
+    const qs = params.toString();
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}${qs ? `?${qs}` : ""}`;
     const res = await this.fetchFn(url, {
       headers: this.getHeaders()
     });
@@ -451,7 +593,194 @@ var EntityQueryBuilder = class {
     }
     return { success: true };
   }
+  /**
+   * Fetch revision history for an entity record
+   */
+  async revisions(id) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/revisions`;
+    const res = await this.fetchFn(url, {
+      headers: this.getHeaders()
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to fetch revisions for ${this.typeName}/${id}`);
+    }
+    return res.json();
+  }
+  /**
+   * Fetch all graph relations for this entity record
+   */
+  async getRelations(id, lang) {
+    const qs = lang ? `?lang=${encodeURIComponent(lang)}` : "";
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/relations${qs}`;
+    const res = await this.fetchFn(url, {
+      headers: this.getHeaders()
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to fetch relations for ${this.typeName}/${id}`);
+    }
+    return res.json();
+  }
+  /**
+   * Link this record to another entity record
+   */
+  async link(id, payload) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/relations`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: this.getHeaders(),
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to create relation for ${this.typeName}/${id}`);
+    }
+    return res.json().catch(() => ({ success: true }));
+  }
+  /**
+   * Replace the full set of relations of one relation name
+   */
+  async setLinks(id, payload) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/relations`;
+    const res = await this.fetchFn(url, {
+      method: "PUT",
+      headers: this.getHeaders(),
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to replace relations for ${this.typeName}/${id}`);
+    }
+    return res.json().catch(() => ({ success: true }));
+  }
+  /**
+   * Remove one graph link between two records
+   */
+  async unlink(id, relationName, targetId, targetTypeName) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/relations/${encodeURIComponent(relationName)}/${encodeURIComponent(targetId)}?targetTypeName=${encodeURIComponent(targetTypeName)}`;
+    const res = await this.fetchFn(url, {
+      method: "DELETE",
+      headers: this.getHeaders()
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to delete relation ${relationName} for ${this.typeName}/${id}`);
+    }
+    return res.json().catch(() => ({ success: true }));
+  }
+  /**
+   * Execute a type-level workflow plugin action (e.g. checkout, batch-process)
+   */
+  async action(actionName, payload) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/actions/${actionName}`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: this.getHeaders(),
+      body: payload ? JSON.stringify(payload) : void 0
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Action ${actionName} failed on type ${this.typeName}`);
+    }
+    return res.json();
+  }
+  /**
+   * Execute an instance-level workflow plugin action (e.g. cancel order, approve)
+   */
+  async instanceAction(id, actionName, payload) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/${id}/actions/${actionName}`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: this.getHeaders(),
+      body: payload ? JSON.stringify(payload) : void 0
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Action ${actionName} failed on ${this.typeName}/${id}`);
+    }
+    return res.json();
+  }
+  /**
+   * Export matching entity records to CSV format with active filters
+   */
+  async exportCsv() {
+    const qs = this.queryParams.toString();
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/${this.typeName}/export/csv${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchFn(url, {
+      headers: {
+        ...this.getHeaders(),
+        "Accept": "text/csv"
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to export CSV for ${this.typeName}`);
+    }
+    return res.text();
+  }
+};
+
+// src/schema.ts
+var SchemaClient = class {
+  gatewayUrl;
+  tenantId;
+  getToken;
+  fetchFn;
+  constructor(options) {
+    this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
+    this.tenantId = options.tenantId;
+    this.getToken = options.getToken;
+    this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
+  }
+  getHeaders() {
+    const headers = {
+      "Content-Type": "application/json",
+      "x-tenant-id": this.tenantId
+    };
+    const token = this.getToken();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+    return headers;
+  }
+  /**
+   * Define a new JSON Schema or alter an existing schema for an entity type in real-time
+   */
+  async define(definition) {
+    const url = `${this.gatewayUrl}/generic/${this.tenantId}/definition`;
+    const res = await this.fetchFn(url, {
+      method: "POST",
+      headers: this.getHeaders(),
+      body: JSON.stringify(definition)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to define schema for ${definition.typeName}`);
+    }
+    return res.json();
+  }
+};
+
+// src/storage.ts
+var MemoryStorage = class {
+  store = /* @__PURE__ */ new Map();
+  getItem(key) {
+    return this.store.get(key) ?? null;
+  }
+  setItem(key, value) {
+    this.store.set(key, value);
+  }
+  removeItem(key) {
+    this.store.delete(key);
+  }
 };
+function getDefaultStorage() {
+  if (typeof window !== "undefined" && window.localStorage) {
+    return window.localStorage;
+  }
+  return new MemoryStorage();
+}
 
 // src/client.ts
 var Zone4CodeClient = class {
@@ -505,6 +834,27 @@ var Zone4CodeClient = class {
   entities(typeName) {
     return this.from(typeName);
   }
+  /**
+   * Get current authenticated user profile and platform wallet
+   */
+  async getMe() {
+    const token = this.auth.getToken();
+    if (!token) {
+      throw new Error("Not authenticated: please call login() or setToken() first");
+    }
+    const res = await this.fetchFn(`${this.gatewayUrl}/generic/${this.tenantId}/me`, {
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${token}`,
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to fetch profile & wallet (HTTP ${res.status})`);
+    }
+    return res.json();
+  }
   /**
    * Check gateway connectivity & health
    */