zone4code-sdk 1.0.10 → 1.0.11

package/dist/index.cjs

@@ -21,8 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthClient: () => AuthClient,
+  CommerceClient: () => CommerceClient,
+  DocClient: () => DocClient,
   EntityQueryBuilder: () => EntityQueryBuilder,
   MemoryStorage: () => MemoryStorage,
+  NotificationClient: () => NotificationClient,
   SchemaClient: () => SchemaClient,
   Zone4CodeClient: () => Zone4CodeClient,
   createClient: () => createClient,
@@ -92,7 +95,7 @@ var AuthClient = class _AuthClient {
     this.storage = storage;
     this.storageKey = storageKey;
     this.refreshStorageKey = refreshStorageKey;
-    this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
+    this.fetchFn = options.fetchFn || ((...args) => fetch(...args));
     this.autoRefresh = options.autoRefresh !== void 0 ? options.autoRefresh : true;
     this.tokenExpiryBuffer = options.tokenExpiryBuffer !== void 0 ? options.tokenExpiryBuffer : 30;
     this.onSessionExpiredCallback = options.onSessionExpired;
@@ -546,6 +549,501 @@ var AuthClient = class _AuthClient {
   }
 };
 
+// src/commerce.ts
+var CommerceClient = class {
+  gatewayUrl;
+  tenantId;
+  fetchWithAuth;
+  fetchFn;
+  constructor(options) {
+    this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
+    this.tenantId = options.tenantId;
+    this.fetchWithAuth = options.fetchWithAuth;
+    this.fetchFn = options.fetchFn;
+  }
+  // --- Products ---
+  /**
+   * List catalog products with search, category filtering, and pagination
+   */
+  async getProducts(params) {
+    const query = new URLSearchParams();
+    if (params?.search) query.set("search", params.search);
+    if (params?.category) query.set("category", params.category);
+    if (params?.status) query.set("status", params.status);
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.orderBy) query.set("orderBy", params.orderBy);
+    if (params?.sortedBy) query.set("sortedBy", params.sortedBy);
+    if (params?.language) query.set("language", params.language);
+    if (params?.type) query.set("type", params.type);
+    const qs = query.toString();
+    const url = `${this.gatewayUrl}/commerce/products${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchFn(url, {
+      method: "GET",
+      headers: { "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 products with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? { data } : data;
+  }
+  /**
+   * Get a single product by slug or ID
+   */
+  async getProductBySlug(slug, language) {
+    const query = language ? `?language=${encodeURIComponent(language)}` : "";
+    const url = `${this.gatewayUrl}/commerce/products/${encodeURIComponent(slug)}${query}`;
+    const res = await this.fetchFn(url, {
+      method: "GET",
+      headers: { "x-tenant-id": this.tenantId }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Product not found with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Create a new product (requires merchant/admin authentication)
+   */
+  async createProduct(product) {
+    const url = `${this.gatewayUrl}/commerce/products`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify(product),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to create product with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  // --- Categories ---
+  /**
+   * List store categories
+   */
+  async getCategories(params) {
+    const query = new URLSearchParams();
+    if (params?.parent !== void 0) query.set("parent", String(params.parent));
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    const qs = query.toString();
+    const url = `${this.gatewayUrl}/commerce/categories${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchFn(url, {
+      method: "GET",
+      headers: { "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 categories with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? data : data.data || [];
+  }
+  // --- Orders & Checkout ---
+  /**
+   * Create a new customer checkout order
+   */
+  async createOrder(payload) {
+    const url = `${this.gatewayUrl}/commerce/orders`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify(payload),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to create order with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Verify checkout taxes, shipping fees, and product availability
+   */
+  async verifyCheckout(payload) {
+    const url = `${this.gatewayUrl}/commerce/orders/checkout/verify`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify(payload),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Checkout verification failed with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Track order by tracking number
+   */
+  async trackOrder(trackingNumber) {
+    const url = `${this.gatewayUrl}/commerce/orders/tracking/${encodeURIComponent(trackingNumber)}`;
+    const res = await this.fetchFn(url, {
+      method: "GET",
+      headers: { "x-tenant-id": this.tenantId }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Order tracking failed with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * List customer orders (authenticated)
+   */
+  async getOrders(params) {
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.tracking_number) query.set("tracking_number", params.tracking_number);
+    const qs = query.toString();
+    const url = `${this.gatewayUrl}/commerce/orders${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "GET",
+      headers: { "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 orders with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? { data } : data;
+  }
+  // --- Coupons ---
+  /**
+   * Verify and calculate discount for a promo coupon code
+   */
+  async verifyCoupon(payload) {
+    const url = `${this.gatewayUrl}/commerce/coupons/verify`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify(payload),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Coupon verification failed with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  // --- Settings ---
+  /**
+   * Get store and commerce configuration settings
+   */
+  async getSettings() {
+    const url = `${this.gatewayUrl}/commerce/settings`;
+    const res = await this.fetchFn(url, {
+      method: "GET",
+      headers: { "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 settings with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+};
+
+// src/doc.ts
+var DocClient = class {
+  gatewayUrl;
+  tenantId;
+  fetchWithAuth;
+  fetchFn;
+  constructor(options) {
+    this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
+    this.tenantId = options.tenantId;
+    this.fetchWithAuth = options.fetchWithAuth;
+    this.fetchFn = options.fetchFn;
+  }
+  /**
+   * Upload one or more files to object storage (S3/MinIO) with automated thumbnailing
+   */
+  async upload(files) {
+    const url = `${this.gatewayUrl}/doc/upload`;
+    let body;
+    if (typeof FormData !== "undefined" && files instanceof FormData) {
+      body = files;
+    } else {
+      body = new FormData();
+      if (Array.isArray(files)) {
+        for (const file of files) {
+          body.append("files", file);
+        }
+      } else {
+        body.append("files", files);
+      }
+    }
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body,
+      headers: {
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `File upload failed with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * List documents with optional folder filtering and pagination
+   */
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.folderId) query.set("folderId", params.folderId);
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.limit) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    const url = `${this.gatewayUrl}/doc/document${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "GET",
+      headers: { "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 documents with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? data : data.documents || data.items || [];
+  }
+  /**
+   * Get a single document record by ID
+   */
+  async get(id) {
+    const url = `${this.gatewayUrl}/doc/document/${encodeURIComponent(id)}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "GET",
+      headers: { "x-tenant-id": this.tenantId }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Document not found with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+  /**
+   * Delete a document by ID
+   */
+  async delete(id) {
+    const url = `${this.gatewayUrl}/doc/document/${encodeURIComponent(id)}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "DELETE",
+      headers: { "x-tenant-id": this.tenantId }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to delete document with HTTP ${res.status}`);
+    }
+    return { success: true };
+  }
+  /**
+   * List document folders
+   */
+  async listFolders() {
+    const url = `${this.gatewayUrl}/doc/folder`;
+    const res = await this.fetchWithAuth(url, {
+      method: "GET",
+      headers: { "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 folders with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? data : data.folders || [];
+  }
+  /**
+   * Create a new folder for organizing documents
+   */
+  async createFolder(name, parentId) {
+    const url = `${this.gatewayUrl}/doc/folder`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify({ name, parentId: parentId || null }),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to create folder with HTTP ${res.status}`);
+    }
+    return res.json();
+  }
+};
+
+// src/notification.ts
+var NotificationClient = class {
+  gatewayUrl;
+  tenantId;
+  fetchWithAuth;
+  fetchFn;
+  constructor(options) {
+    this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
+    this.tenantId = options.tenantId;
+    this.fetchWithAuth = options.fetchWithAuth;
+    this.fetchFn = options.fetchFn;
+  }
+  /**
+   * Send an SMS message via configured SMS gateways (Twilio / SMS API)
+   */
+  async sendSms(payload) {
+    const url = `${this.gatewayUrl}/notification/sms`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify({
+        to: payload.to,
+        body: payload.message,
+        from: payload.from,
+        provider: payload.provider
+      }),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to send SMS with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return {
+      success: true,
+      messageId: data.id || data.messageId || data.sid,
+      status: data.status || "sent"
+    };
+  }
+  /**
+   * Send an email or template email
+   */
+  async sendEmail(payload) {
+    const shopSlug = payload.shopSlug || this.tenantId;
+    const localeCode = payload.localeCode || "en";
+    const url = `${this.gatewayUrl}/notification/${encodeURIComponent(shopSlug)}/sendEmail/${encodeURIComponent(localeCode)}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify({
+        to: Array.isArray(payload.to) ? payload.to.join(",") : payload.to,
+        subject: payload.subject,
+        html: payload.html,
+        text: payload.text,
+        templateId: payload.templateId,
+        templateData: payload.templateData
+      }),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to send Email with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return {
+      success: true,
+      messageId: data.id || data.messageId,
+      status: data.status || "sent"
+    };
+  }
+  /**
+   * Send Firebase Cloud Messaging (FCM) Push Notification
+   */
+  async sendPush(payload) {
+    const url = `${this.gatewayUrl}/notification/firebase_message`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify({
+        token: payload.token,
+        tokens: payload.tokens,
+        topic: payload.topic,
+        notification: {
+          title: payload.title,
+          body: payload.body
+        },
+        data: payload.data || {}
+      }),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to send Push Notification with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return {
+      success: true,
+      messageId: data.messageId || data.id,
+      status: "sent"
+    };
+  }
+  /**
+   * Register a device push token for push notifications
+   */
+  async registerPushToken(payload) {
+    const url = `${this.gatewayUrl}/notification/firebase_registration`;
+    const res = await this.fetchWithAuth(url, {
+      method: "POST",
+      body: JSON.stringify({
+        token: payload.token,
+        userId: payload.userId,
+        platform: payload.platform || "web",
+        metadata: payload.metadata || {}
+      }),
+      headers: {
+        "Content-Type": "application/json",
+        "x-tenant-id": this.tenantId
+      }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ message: res.statusText }));
+      throw new Error(err.message || `Failed to register push token with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return { success: true, id: data.id };
+  }
+  /**
+   * Get recent in-app notifications
+   */
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.page) query.set("page", String(params.page));
+    if (params?.limit) query.set("limit", String(params.limit));
+    const qs = query.toString();
+    const url = `${this.gatewayUrl}/notification/notification${qs ? `?${qs}` : ""}`;
+    const res = await this.fetchWithAuth(url, {
+      method: "GET",
+      headers: { "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 notifications with HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    return Array.isArray(data) ? data : data.notifications || data.items || [];
+  }
+};
+
 // src/query-builder.ts
 var EntityQueryBuilder = class {
   gatewayUrl;
@@ -560,7 +1058,7 @@ var EntityQueryBuilder = class {
     this.tenantId = options.tenantId;
     this.typeName = options.typeName;
     this.getToken = options.getToken || (() => null);
-    this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
+    this.fetchFn = options.fetchFn || ((...args) => fetch(...args));
     this.fetchWithAuth = options.fetchWithAuth;
     if (options.defaultLanguage) {
       const langVal = typeof options.defaultLanguage === "function" ? options.defaultLanguage() : options.defaultLanguage;
@@ -989,7 +1487,7 @@ var SchemaClient = class {
     this.gatewayUrl = options.gatewayUrl.replace(/\/+$/, "");
     this.tenantId = options.tenantId;
     this.getToken = options.getToken || (() => null);
-    this.fetchFn = options.fetchFn || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
+    this.fetchFn = options.fetchFn || ((...args) => fetch(...args));
     this.fetchWithAuth = options.fetchWithAuth;
   }
   getHeaders() {
@@ -1047,20 +1545,24 @@ var Zone4CodeClient = class {
   tenantId;
   auth;
   schema;
+  doc;
+  notification;
+  commerce;
   storage;
   fetchFn;
   currentLanguage = null;
-  constructor(config) {
-    if (!config.gatewayUrl) {
-      throw new Error("Zone4CodeClient requires a `gatewayUrl` (e.g., http://localhost:8080)");
-    }
-    if (!config.tenantId) {
-      throw new Error("Zone4CodeClient requires a `tenantId` (workspace identifier)");
-    }
-    this.gatewayUrl = config.gatewayUrl.replace(/\/+$/, "");
-    this.tenantId = config.tenantId;
+  constructor(config = {}) {
+    const globalObj = typeof globalThis !== "undefined" ? globalThis : {};
+    const procEnv = globalObj.process?.env || {};
+    const winEnv = globalObj.window?.env || globalObj.__ZONE4BUILD_ENV__ || {};
+    const envGateway = procEnv.ZONE4BUILD_GATEWAY_URL || procEnv.VITE_ZONE4BUILD_GATEWAY_URL || winEnv.ZONE4BUILD_GATEWAY_URL || globalObj.__ZONE4BUILD_GATEWAY_URL__;
+    const resolvedGatewayUrl = config.gatewayUrl || envGateway || "https://api.zone4build.com";
+    const envTenant = procEnv.ZONE4BUILD_WORKSPACE_ID || procEnv.VITE_ZONE4BUILD_WORKSPACE_ID || winEnv.ZONE4BUILD_WORKSPACE_ID || globalObj.__ZONE4BUILD_WORKSPACE_ID__;
+    const resolvedTenantId = config.tenantId || envTenant || "default";
+    this.gatewayUrl = resolvedGatewayUrl.replace(/\/+$/, "");
+    this.tenantId = resolvedTenantId;
     this.storage = config.storage || getDefaultStorage();
-    this.fetchFn = config.fetch || (typeof fetch !== "undefined" ? fetch : globalThis.fetch);
+    this.fetchFn = config.fetch || ((...args) => fetch(...args));
     this.currentLanguage = config.defaultLanguage !== void 0 ? config.defaultLanguage : "en";
     this.auth = new AuthClient({
       gatewayUrl: this.gatewayUrl,
@@ -1081,7 +1583,32 @@ var Zone4CodeClient = class {
       fetchFn: this.fetchFn,
       fetchWithAuth: (url, init) => this.auth.fetchWithAuth(url, init)
     });
+    this.doc = new DocClient({
+      gatewayUrl: this.gatewayUrl,
+      tenantId: this.tenantId,
+      fetchWithAuth: (url, init) => this.auth.fetchWithAuth(url, init),
+      fetchFn: this.fetchFn
+    });
+    this.notification = new NotificationClient({
+      gatewayUrl: this.gatewayUrl,
+      tenantId: this.tenantId,
+      fetchWithAuth: (url, init) => this.auth.fetchWithAuth(url, init),
+      fetchFn: this.fetchFn
+    });
+    this.commerce = new CommerceClient({
+      gatewayUrl: this.gatewayUrl,
+      tenantId: this.tenantId,
+      fetchWithAuth: (url, init) => this.auth.fetchWithAuth(url, init),
+      fetchFn: this.fetchFn
+    });
+    this.generic = {
+      from: (typeName) => this.from(typeName),
+      entities: (typeName) => this.from(typeName),
+      schema: this.schema,
+      getMe: () => this.getMe()
+    };
   }
+  generic;
   /**
    * Set the active default language for API requests (e.g., 'en', 'fr', 'ar', or '*' for raw)
    */
@@ -1149,8 +1676,11 @@ function createClient(config) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthClient,
+  CommerceClient,
+  DocClient,
   EntityQueryBuilder,
   MemoryStorage,
+  NotificationClient,
   SchemaClient,
   Zone4CodeClient,
   createClient,