bestraw-sdk 1.0.0

package/dist/index.js

@@ -0,0 +1,508 @@
+// src/base.ts
+var BestrawError = class extends Error {
+  constructor(status, message, details) {
+    super(message);
+    this.name = "BestrawError";
+    this.status = status;
+    this.details = details;
+    const err = details?.error;
+    if (err?.code) {
+      this.code = err.code;
+    }
+    if (err?.meta) {
+      this.meta = err.meta;
+    }
+  }
+};
+var BaseClient = class {
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiToken = config.apiToken;
+    this.defaultLocale = config.defaultLocale;
+    this.getAuthToken = config.getAuthToken;
+  }
+  async headers() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiToken) {
+      headers["Authorization"] = `Bearer ${this.apiToken}`;
+    } else if (this.getAuthToken) {
+      const token = await this.getAuthToken();
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+    }
+    return headers;
+  }
+  appendLocale(path, locale) {
+    const effectiveLocale = locale || this.defaultLocale;
+    if (!effectiveLocale) return path;
+    const separator = path.includes("?") ? "&" : "?";
+    return `${path}${separator}locale=${effectiveLocale}`;
+  }
+  async request(path, options = {}) {
+    const { locale, ...fetchOptions } = options;
+    const url = `${this.baseUrl}${this.appendLocale(path, locale)}`;
+    const headers = await this.headers();
+    if (fetchOptions.body instanceof FormData) {
+      delete headers["Content-Type"];
+    }
+    const response = await fetch(url, {
+      ...fetchOptions,
+      headers: {
+        ...headers,
+        ...fetchOptions.headers
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({
+        message: response.statusText
+      }));
+      throw new BestrawError(
+        response.status,
+        error.error?.message ?? error.message ?? "Request failed",
+        error
+      );
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    const json = await response.json();
+    return json.data !== void 0 ? json.data : json;
+  }
+};
+
+// src/namespaces/menu.ts
+var MenuNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // --- Menus ---
+  async getMenus(locale) {
+    return this.client.request("/api/menu/menus", { locale });
+  }
+  async getMenu(documentId, options) {
+    const query = options?.populate ? `?populate=${options.populate}` : "";
+    return this.client.request(`/api/menu/menus/${documentId}${query}`, { locale: options?.locale });
+  }
+  async createMenu(data, locale) {
+    return this.client.request("/api/menu/menus", {
+      method: "POST",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async updateMenu(documentId, data, locale) {
+    return this.client.request(`/api/menu/menus/${documentId}`, {
+      method: "PUT",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async deleteMenu(documentId) {
+    await this.client.request(`/api/menu/menus/${documentId}`, { method: "DELETE" });
+  }
+  // --- Variants ---
+  async getVariants(menuDocumentId, locale) {
+    return this.client.request(`/api/menu/menus/${menuDocumentId}/variants`, { locale });
+  }
+  async getActiveVariant(menuDocumentId, locale) {
+    return this.client.request(`/api/menu/menus/${menuDocumentId}/active-variant`, { locale });
+  }
+  async setActiveVariant(menuDocumentId, variantDocumentId) {
+    await this.client.request(`/api/menu/menus/${menuDocumentId}/active-variant`, {
+      method: "PUT",
+      body: JSON.stringify({ variantId: variantDocumentId })
+    });
+  }
+  async createVariant(data, locale) {
+    return this.client.request("/api/menu/variants", {
+      method: "POST",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async updateVariant(documentId, data, locale) {
+    return this.client.request(`/api/menu/variants/${documentId}`, {
+      method: "PUT",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async deleteVariant(documentId) {
+    await this.client.request(`/api/menu/variants/${documentId}`, { method: "DELETE" });
+  }
+  // --- Categories ---
+  async createCategory(data, locale) {
+    return this.client.request("/api/menu/categories", {
+      method: "POST",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async updateCategory(documentId, data, locale) {
+    return this.client.request(`/api/menu/categories/${documentId}`, {
+      method: "PUT",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async deleteCategory(documentId) {
+    await this.client.request(`/api/menu/categories/${documentId}`, { method: "DELETE" });
+  }
+  async sortCategories(variantDocumentId, sortedCategoryIds) {
+    await this.client.request(`/api/menu/variants/${variantDocumentId}/sort-categories`, {
+      method: "PUT",
+      body: JSON.stringify({ sortedCategoryIds })
+    });
+  }
+  // --- Meals ---
+  async createMeal(data, locale) {
+    return this.client.request("/api/menu/meals", {
+      method: "POST",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async updateMeal(documentId, data, locale) {
+    return this.client.request(`/api/menu/meals/${documentId}`, {
+      method: "PUT",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async deleteMeal(documentId) {
+    await this.client.request(`/api/menu/meals/${documentId}`, { method: "DELETE" });
+  }
+  async sortMeals(categoryDocumentId, sortedMealIds) {
+    await this.client.request(`/api/menu/categories/${categoryDocumentId}/sort-meals`, {
+      method: "PUT",
+      body: JSON.stringify({ sortedMealIds })
+    });
+  }
+  // --- Pictures (Strapi Upload API - core, not plugin) ---
+  async uploadPicture(file, ref, refId, field) {
+    const formData = new FormData();
+    formData.append("files", file);
+    formData.append("ref", ref);
+    formData.append("refId", refId);
+    formData.append("field", field);
+    return this.client.request("/api/upload", {
+      method: "POST",
+      body: formData
+    });
+  }
+  async deletePicture(pictureId) {
+    await this.client.request(`/api/upload/files/${pictureId}`, { method: "DELETE" });
+  }
+};
+
+// src/namespaces/restaurant.ts
+var RestaurantNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async getInfo(locale) {
+    return this.client.request("/api/restaurant/restaurant-info", { locale });
+  }
+  async updateInfo(data, locale) {
+    return this.client.request("/api/restaurant/restaurant-info", {
+      method: "PUT",
+      body: JSON.stringify({ data }),
+      locale
+    });
+  }
+  async getHours() {
+    return this.client.request("/api/restaurant/opening-hours");
+  }
+  async getStatus() {
+    return this.client.request("/api/restaurant/opening-hours/status");
+  }
+  async updateHours(data) {
+    return this.client.request("/api/restaurant/opening-hours", {
+      method: "PUT",
+      body: JSON.stringify({ data })
+    });
+  }
+  async getTheme() {
+    return this.client.request("/api/restaurant/theme");
+  }
+  async updateTheme(data) {
+    return this.client.request("/api/restaurant/theme", {
+      method: "PUT",
+      body: JSON.stringify({ data })
+    });
+  }
+};
+
+// src/namespaces/customer.ts
+var CustomerNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async requestOtp(phone) {
+    return this.client.request("/api/customer/auth/request-otp", {
+      method: "POST",
+      body: JSON.stringify({ phone })
+    });
+  }
+  async verifyOtp(phone, code) {
+    return this.client.request("/api/customer/auth/verify-otp", {
+      method: "POST",
+      body: JSON.stringify({ phone, code })
+    });
+  }
+  async requestEmailOtp(email) {
+    return this.client.request("/api/customer/auth/request-email-otp", {
+      method: "POST",
+      body: JSON.stringify({ email })
+    });
+  }
+  async verifyEmailOtp(email, code) {
+    return this.client.request("/api/customer/auth/verify-email-otp", {
+      method: "POST",
+      body: JSON.stringify({ email, code })
+    });
+  }
+  async getMe() {
+    return this.client.request("/api/customer/customers/me");
+  }
+  async updateMe(data) {
+    return this.client.request("/api/customer/customers/me", {
+      method: "PUT",
+      body: JSON.stringify({ data })
+    });
+  }
+};
+
+// src/utils.ts
+function stringifyQuery(obj) {
+  const parts = [];
+  function flatten(value, prefix) {
+    if (value === null || value === void 0) return;
+    if (Array.isArray(value)) {
+      value.forEach((item, i) => flatten(item, `${prefix}[${i}]`));
+    } else if (typeof value === "object") {
+      for (const [key, val] of Object.entries(value)) {
+        flatten(val, prefix ? `${prefix}[${key}]` : key);
+      }
+    } else {
+      parts.push(`${encodeURIComponent(prefix)}=${encodeURIComponent(String(value))}`);
+    }
+  }
+  flatten(obj, "");
+  return parts.join("&");
+}
+
+// src/namespaces/ordering.ts
+var OrderingNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // --- Customer routes ---
+  async createOrder(data) {
+    return this.client.request("/api/ordering/orders", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async getMyOrders() {
+    return this.client.request("/api/ordering/orders/mine");
+  }
+  async getMyOrder(documentId) {
+    return this.client.request(`/api/ordering/orders/mine/${documentId}`);
+  }
+  async cancelOrder(documentId, reason) {
+    return this.client.request(`/api/ordering/orders/${documentId}/cancel`, {
+      method: "PUT",
+      body: JSON.stringify({ reason })
+    });
+  }
+  // --- Admin / KDS routes ---
+  async getOrders(query) {
+    const qs = query ? "?" + stringifyQuery(query) : "";
+    return this.client.request(`/api/ordering/orders${qs}`);
+  }
+  async getOrder(documentId) {
+    return this.client.request(`/api/ordering/orders/${documentId}`);
+  }
+  async updateOrderStatus(documentId, status) {
+    return this.client.request(`/api/ordering/orders/${documentId}/status`, {
+      method: "PUT",
+      body: JSON.stringify({ status })
+    });
+  }
+  async getActiveOrders() {
+    return this.client.request("/api/ordering/orders/active");
+  }
+  async getPublicOrderSettings() {
+    return this.client.request("/api/ordering/order-settings/public");
+  }
+  async getOrderSettings() {
+    return this.client.request("/api/ordering/order-settings");
+  }
+  async updateOrderSettings(data) {
+    return this.client.request("/api/ordering/order-settings", {
+      method: "PUT",
+      body: JSON.stringify({ data })
+    });
+  }
+};
+
+// src/namespaces/payment.ts
+var PaymentNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async createPaymentIntent(orderDocumentId) {
+    return this.client.request("/api/payment/payments/create-intent", {
+      method: "POST",
+      body: JSON.stringify({ orderDocumentId })
+    });
+  }
+  async getPayment(documentId) {
+    return this.client.request(`/api/payment/payments/${documentId}`);
+  }
+  async refundPayment(documentId, amount) {
+    return this.client.request(`/api/payment/payments/${documentId}/refund`, {
+      method: "POST",
+      body: JSON.stringify({ amount })
+    });
+  }
+};
+
+// src/namespaces/loyalty.ts
+var LoyaltyNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  // --- Customer routes ---
+  async getMyAccount() {
+    return this.client.request("/api/loyalty/loyalty/me");
+  }
+  async getMyTransactions() {
+    return this.client.request("/api/loyalty/loyalty/me/transactions");
+  }
+  async redeemReward(rewardIndex) {
+    return this.client.request("/api/loyalty/loyalty/redeem", {
+      method: "POST",
+      body: JSON.stringify({ rewardIndex })
+    });
+  }
+  // --- Public ---
+  async getProgram() {
+    return this.client.request("/api/loyalty/loyalty/program");
+  }
+  // --- Admin ---
+  async getAccounts() {
+    return this.client.request("/api/loyalty/loyalty/accounts");
+  }
+  async adjustPoints(accountDocumentId, points, description) {
+    return this.client.request(`/api/loyalty/loyalty/accounts/${accountDocumentId}/adjust`, {
+      method: "POST",
+      body: JSON.stringify({ points, description })
+    });
+  }
+};
+
+// src/namespaces/blog.ts
+var BlogNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async getArticles(options) {
+    const params = new URLSearchParams();
+    if (options?.category) params.set("category", options.category);
+    if (options?.tag) params.set("tag", options.tag);
+    if (options?.featured) params.set("featured", "true");
+    if (options?.page) params.set("pagination[page]", String(options.page));
+    if (options?.pageSize) params.set("pagination[pageSize]", String(options.pageSize));
+    if (options?.locale) params.set("locale", options.locale);
+    const qs = params.toString();
+    return this.client.request(`/api/blog/articles${qs ? `?${qs}` : ""}`);
+  }
+  async getArticle(slug, locale) {
+    const params = locale ? `?locale=${locale}` : "";
+    return this.client.request(`/api/blog/articles/${slug}${params}`);
+  }
+  async getCategories(locale) {
+    const params = locale ? `?locale=${locale}` : "";
+    return this.client.request(`/api/blog/categories${params}`);
+  }
+};
+
+// src/client.ts
+var BestrawClient = class extends BaseClient {
+  constructor(config) {
+    super(config);
+    this.menu = new MenuNamespace(this);
+    this.restaurant = new RestaurantNamespace(this);
+    this.customer = new CustomerNamespace(this);
+    this.ordering = new OrderingNamespace(this);
+    this.payment = new PaymentNamespace(this);
+    this.loyalty = new LoyaltyNamespace(this);
+    this.blog = new BlogNamespace(this);
+  }
+};
+
+// src/errors.ts
+var ErrorCode = {
+  // Generic
+  UNKNOWN: "UNKNOWN",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  // Auth / Customer
+  AUTH_REQUIRED: "AUTH_REQUIRED",
+  INVALID_PHONE: "INVALID_PHONE",
+  INVALID_EMAIL: "INVALID_EMAIL",
+  NO_ACTIVE_SESSION: "NO_ACTIVE_SESSION",
+  OTP_EXPIRED: "OTP_EXPIRED",
+  OTP_TOO_MANY_ATTEMPTS: "OTP_TOO_MANY_ATTEMPTS",
+  OTP_INVALID: "OTP_INVALID",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  // Ordering
+  ORDER_DISABLED: "ORDER_DISABLED",
+  TAKEAWAY_DISABLED: "TAKEAWAY_DISABLED",
+  DINEIN_DISABLED: "DINEIN_DISABLED",
+  MAX_ORDERS_REACHED: "MAX_ORDERS_REACHED",
+  EMPTY_ORDER: "EMPTY_ORDER",
+  MEAL_NOT_FOUND: "MEAL_NOT_FOUND",
+  MEAL_UNAVAILABLE: "MEAL_UNAVAILABLE",
+  ORDER_NOT_FOUND: "ORDER_NOT_FOUND",
+  INVALID_STATUS_TRANSITION: "INVALID_STATUS_TRANSITION",
+  CANNOT_CANCEL_ORDER: "CANNOT_CANCEL_ORDER",
+  // Payment
+  PAYMENT_ORDER_NOT_FOUND: "PAYMENT_ORDER_NOT_FOUND",
+  PAYMENT_INVALID_ORDER_STATUS: "PAYMENT_INVALID_ORDER_STATUS",
+  PAYMENT_NOT_FOUND: "PAYMENT_NOT_FOUND",
+  PAYMENT_CANNOT_REFUND: "PAYMENT_CANNOT_REFUND",
+  PAYMENT_FAILED: "PAYMENT_FAILED",
+  // Loyalty
+  LOYALTY_ACCOUNT_NOT_FOUND: "LOYALTY_ACCOUNT_NOT_FOUND",
+  REWARD_NOT_FOUND: "REWARD_NOT_FOUND",
+  REWARD_INACTIVE: "REWARD_INACTIVE",
+  NOT_ENOUGH_POINTS: "NOT_ENOUGH_POINTS"
+};
+var AppError = class extends Error {
+  constructor(code, statusCode, message, meta) {
+    super(message);
+    this.name = "AppError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.meta = meta;
+  }
+};
+export {
+  AppError,
+  BaseClient,
+  BestrawClient,
+  BestrawError,
+  BlogNamespace,
+  CustomerNamespace,
+  ErrorCode,
+  LoyaltyNamespace,
+  MenuNamespace,
+  OrderingNamespace,
+  PaymentNamespace,
+  RestaurantNamespace
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "bestraw-sdk",
+  "version": "1.0.0",
+  "description": "SDK for BeStraw restaurant platform",
+  "license": "MIT",
+  "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/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "clean": "rm -rf dist"
+  }
+}