Store Information

const response = await komerza.getStore();

async function loadStore() {
  const response = await komerza.getStore();

  if (!response.success) {
    showError(response.message);
    return null;
  }

  return response.data;
}

interface Store {
  id: string;
  name: string;
  description: string; // markdown
  url: string; // the subdomain only, e.g. "mystore"
  domain: string;
  customDomain?: string;
  currencyCode: string; // ISO 4217 in lowercase, e.g. "usd" - every price is in this currency
  isAdaptiveCurrencyEnabled?: boolean;
  rating: number; // across all reviews
  maintenanceReason?: string; // set while the store is in maintenance mode
  branding?: {
    iconFileName?: string;
    bannerFileName?: string;
    accentColor?: string; // hex, e.g. "#6366f1"
  };
  products: Product[]; // see Products
  categories?: Category[];
  termsOfServiceUrl?: string;
  refundPolicyUrl?: string;
  privacyPolicyUrl?: string;
  externalSupportUrl?: string;
  externalSupportDescription?: string;
  affiliateOptions?: {
    isEnabled: boolean;
    defaultPercentageOff: number; // the buyer's discount through an affiliate link
    isPublicRegistrationEnabled: boolean;
  };
  dateCreated: string;
}

const products = store.products
  .filter((product) => product.visibility === 0)
  .sort((a, b) => a.order - b.order);

interface Category {
  id: string;
  name: string;
  slug?: string;
  imageName?: string; // see Images
  order: number;
  visibility: number; // 0 public, as for products
  productCount: number;
  products: string[]; // product IDs
}

function categoriesWithProducts(store) {
  const byId = new Map(store.products.map((product) => [product.id, product]));

  return (store.categories ?? [])
    .filter((category) => category.visibility === 0)
    .sort((a, b) => a.order - b.order)
    .map((category) => ({
      ...category,
      products: category.products
        .map((id) => byId.get(id))
        .filter((product) => product && product.visibility === 0),
    }));
}

const [logoUrl, bannerUrl] = await Promise.all([
  komerza.getStoreLogoUrl(),
  komerza.getStoreBannerUrl(),
]);

if (store.branding?.iconFileName) {
  document.getElementById("logo").src = await komerza.getStoreLogoUrl();
}

const links = [
  ["Terms of service", store.termsOfServiceUrl],
  ["Refund policy", store.refundPolicyUrl],
  ["Privacy policy", store.privacyPolicyUrl],
  [store.externalSupportDescription || "Support", store.externalSupportUrl],
].filter(([, url]) => url);

const footer = document.getElementById("footer-links");
for (const [label, url] of links) {
  const a = document.createElement("a");
  a.href = url;
  a.textContent = label;
  footer.append(a);
}

function showMaintenance(store) {
  if (!store.maintenanceReason) return false;

  document.getElementById("shop").hidden = true;
  document.getElementById("maintenance").textContent = store.maintenanceReason;
  return true;
}

const response = await komerza.getPublicStoreStats();

interface PublicStoreStats {
  totalOrders: string; // e.g. "100+"
  totalCustomers: string;
  totalProducts: string;
  averageRating: number | null;
  totalReviews: string;
  storeAge: string; // e.g. "6 months"
}