@base44/app-plugin-commerce 0.1.0

package/src/commerce/admin/layout/Sidebar.jsx

@@ -0,0 +1,130 @@
+import React, { useEffect, useRef, useState } from "react";
+import { NavLink, useLocation } from "react-router-dom";
+import { Badge } from "@/components/ui/badge";
+import {
+  BadgePercent,
+  BarChart3,
+  LayoutDashboard,
+  Package,
+  Settings,
+  ShoppingCart,
+  Sparkles,
+  Users,
+  Webhook,
+} from "lucide-react";
+import { call } from "../lib/api";
+import { useAdminHref } from "../context/BasePathContext";
+
+const NAV = [
+  { items: [{ label: "Dashboard", path: "", icon: LayoutDashboard, end: true }] },
+  {
+    items: [
+      { label: "Orders", path: "orders", icon: ShoppingCart, badge: "processing" },
+      { label: "Customers", path: "customers", icon: Users },
+      { label: "Reports", path: "reports", icon: BarChart3 },
+    ],
+  },
+  {
+    title: "Products",
+    icon: Package,
+    items: [
+      { label: "All Products", path: "products", end: true },
+      { label: "Categories", path: "products/categories" },
+      { label: "Tags", path: "products/tags" },
+      { label: "Attributes", path: "products/attributes" },
+      { label: "Reviews", path: "products/reviews" },
+    ],
+  },
+  {
+    title: "Marketing",
+    icon: BadgePercent,
+    items: [{ label: "Coupons", path: "coupons" }],
+  },
+  {
+    items: [{ label: "Settings", path: "settings", icon: Settings }],
+  },
+  {
+    title: "Status",
+    icon: Webhook,
+    items: [{ label: "Webhooks", path: "webhooks" }],
+  },
+];
+
+/** Left navigation. `onNavigate` closes the mobile sheet; `onOpenBot` opens the StoreAdmin bot panel. */
+export default function Sidebar({ onNavigate, onOpenBot }) {
+  const href = useAdminHref();
+  const location = useLocation();
+  const [processingCount, setProcessingCount] = useState(null);
+  const lastFetch = useRef(0);
+
+  // Non-blocking processing-orders badge; refresh at most every 15s on navigation.
+  useEffect(() => {
+    const now = Date.now();
+    if (now - lastFetch.current < 15000) return;
+    lastFetch.current = now;
+    call("admin-orders", "status-counts", {}, { silent: true })
+      .then((counts) => setProcessingCount(counts?.processing ?? 0))
+      .catch(() => {});
+  }, [location.pathname]);
+
+  const linkClass = ({ isActive }) =>
+    `flex items-center gap-2.5 rounded-md px-3 py-2 text-sm transition-colors ${
+      isActive
+        ? "bg-primary/10 font-medium text-primary"
+        : "text-muted-foreground hover:bg-muted hover:text-foreground"
+    }`;
+
+  return (
+    <div className="flex h-full flex-col">
+      <div className="flex h-14 items-center gap-2 border-b px-4">
+        <Package className="h-5 w-5 text-primary" />
+        <span className="font-semibold">Store Admin</span>
+      </div>
+      <nav className="flex-1 space-y-4 overflow-y-auto p-3">
+        {NAV.map((group, gi) => (
+          <div key={gi}>
+            {group.title && (
+              <div className="mb-1 px-3 text-xs font-semibold uppercase tracking-wide text-muted-foreground/70">
+                {group.title}
+              </div>
+            )}
+            <div className="space-y-0.5">
+              {group.items.map((item) => {
+                const Icon = item.icon;
+                return (
+                  <NavLink
+                    key={item.path}
+                    to={href(item.path)}
+                    end={item.end}
+                    className={linkClass}
+                    onClick={onNavigate}
+                  >
+                    {Icon && <Icon className="h-4 w-4 shrink-0" />}
+                    <span className="flex-1">{item.label}</span>
+                    {item.badge === "processing" && processingCount > 0 && (
+                      <Badge variant="secondary" className="h-5 min-w-5 justify-center px-1.5">
+                        {processingCount}
+                      </Badge>
+                    )}
+                  </NavLink>
+                );
+              })}
+            </div>
+          </div>
+        ))}
+      </nav>
+      {onOpenBot && (
+        <div className="border-t p-3">
+          <button
+            type="button"
+            onClick={onOpenBot}
+            className="flex w-full items-center gap-2.5 rounded-md px-3 py-2 text-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
+          >
+            <Sparkles className="h-4 w-4 shrink-0 text-primary" />
+            <span className="flex-1 text-left">StoreAdmin bot</span>
+          </button>
+        </div>
+      )}
+    </div>
+  );
+}

package/src/commerce/admin/layout/Topbar.jsx

@@ -0,0 +1,94 @@
+import React from "react";
+import { Link, useLocation } from "react-router-dom";
+import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { ChevronRight, LogOut, Menu, UserCircle } from "lucide-react";
+import { base44 } from "../lib/api";
+import { useAuth } from "./AuthGuard";
+import { useBasePath, useAdminHref } from "../context/BasePathContext";
+import { ADMIN_ROUTES } from "../routes";
+
+/** Match an internal path (no leading slash) against ADMIN_ROUTES patterns. */
+function matchRoute(path) {
+  const segs = path.split("/").filter(Boolean);
+  return ADMIN_ROUTES.find((r) => {
+    const pSegs = r.path.split("/").filter(Boolean);
+    if (pSegs.length !== segs.length) return false;
+    return pSegs.every((p, i) => p.startsWith(":") || p === segs[i]);
+  });
+}
+
+function useBreadcrumbs() {
+  const { pathname } = useLocation();
+  const base = useBasePath();
+  const rel = pathname.startsWith(base) ? pathname.slice(base.length) : pathname;
+  const segs = rel.split("/").filter(Boolean);
+  const crumbs = [{ label: "Dashboard", path: "" }];
+  segs.forEach((seg, i) => {
+    const prefix = segs.slice(0, i + 1).join("/");
+    const route = matchRoute(prefix);
+    crumbs.push({
+      label: route?.label || decodeURIComponent(seg),
+      path: prefix,
+      last: i === segs.length - 1,
+    });
+  });
+  return crumbs;
+}
+
+/** Top bar: mobile menu button, breadcrumbs, user menu. */
+export default function Topbar({ onMenuClick }) {
+  const user = useAuth();
+  const href = useAdminHref();
+  const crumbs = useBreadcrumbs();
+
+  return (
+    <header className="sticky top-0 z-10 flex h-14 items-center gap-3 border-b bg-background px-4">
+      <Button variant="ghost" size="icon" className="lg:hidden" onClick={onMenuClick}>
+        <Menu className="h-5 w-5" />
+      </Button>
+      <nav className="flex min-w-0 flex-1 items-center gap-1 text-sm">
+        {crumbs.map((crumb, i) => (
+          <React.Fragment key={i}>
+            {i > 0 && <ChevronRight className="h-3.5 w-3.5 shrink-0 text-muted-foreground/50" />}
+            {crumb.last || i === crumbs.length - 1 ? (
+              <span className="truncate font-medium">{crumb.label}</span>
+            ) : (
+              <Link
+                to={href(crumb.path)}
+                className="shrink-0 text-muted-foreground hover:text-foreground"
+              >
+                {crumb.label}
+              </Link>
+            )}
+          </React.Fragment>
+        ))}
+      </nav>
+      <DropdownMenu>
+        <DropdownMenuTrigger asChild>
+          <Button variant="ghost" size="sm" className="gap-2">
+            <UserCircle className="h-5 w-5" />
+            <span className="hidden max-w-40 truncate sm:inline">{user?.email}</span>
+          </Button>
+        </DropdownMenuTrigger>
+        <DropdownMenuContent align="end">
+          <DropdownMenuLabel className="font-normal">
+            <div className="text-sm font-medium">{user?.full_name || "Administrator"}</div>
+            <div className="text-xs text-muted-foreground">{user?.email}</div>
+          </DropdownMenuLabel>
+          <DropdownMenuSeparator />
+          <DropdownMenuItem onClick={() => base44.auth.logout()}>
+            <LogOut className="mr-2 h-4 w-4" /> Sign out
+          </DropdownMenuItem>
+        </DropdownMenuContent>
+      </DropdownMenu>
+    </header>
+  );
+}

package/src/commerce/admin/lib/api.js

@@ -0,0 +1,55 @@
+/**
+ * Single touchpoint for the Base44 SDK client and backend-function calls.
+ *
+ * Expects your app to export the client as a named `base44` export, as
+ * Base44's default `src/api/base44Client.js` does. If your app uses a
+ * default export instead, this import is the ONLY line you need to adjust.
+ * (A static "named-or-default" probe is not possible here: referencing an
+ * export the module doesn't have is a hard error at build time.)
+ */
+import { base44 } from "@/api/base44Client";
+import { toast } from "sonner";
+
+/**
+ * Invoke a backend function using the template's `{action, ...payload}` convention.
+ *
+ * - Returns the unwrapped `data` when the function responds with the
+ *   `{success, data}` envelope, otherwise the raw response body.
+ * - On failure: shows an error toast (unless `opts.silent`) and rethrows an
+ *   Error carrying `.code` and `.details` from the function's error body.
+ *
+ * @param {string} fn - function name without the "commerce/" prefix, e.g.
+ *   "admin-orders" (invoked as "commerce/admin-orders" — the prefix is added here)
+ * @param {string|null} action - action name, e.g. "status-counts" (null = send payload as-is)
+ * @param {object} payload
+ * @param {{silent?: boolean}} opts
+ */
+export async function call(fn, action, payload = {}, opts = {}) {
+  try {
+    const body = action ? { action, ...payload } : { ...payload };
+    const res = await base44.functions.invoke(`commerce/${fn}`, body);
+    const data = res?.data;
+    if (data && typeof data === "object" && "success" in data) {
+      if (data.success === false) {
+        throw Object.assign(new Error(data.error || "Request failed"), {
+          code: data.code,
+          details: data,
+        });
+      }
+      return "data" in data ? data.data : data;
+    }
+    return data;
+  } catch (err) {
+    const body = err.response?.data;
+    const message = body?.error || err.message || "Request failed";
+    const wrapped = Object.assign(new Error(message), {
+      code: body?.code || err.code,
+      details: body || err.details || null,
+      status: err.response?.status,
+    });
+    if (!opts.silent) toast.error(message);
+    throw wrapped;
+  }
+}
+
+export { base44 };

package/src/commerce/admin/lib/constants.js

@@ -0,0 +1,157 @@
+/** Shared enums, labels and badge colors for the admin UI. */
+
+export const ORDER_STATUSES = [
+  { value: "pending", label: "Pending payment", color: "bg-amber-100 text-amber-800 border-amber-200" },
+  { value: "processing", label: "Processing", color: "bg-green-100 text-green-800 border-green-200" },
+  { value: "on-hold", label: "On hold", color: "bg-orange-100 text-orange-800 border-orange-200" },
+  { value: "completed", label: "Completed", color: "bg-blue-100 text-blue-800 border-blue-200" },
+  { value: "cancelled", label: "Cancelled", color: "bg-gray-100 text-gray-700 border-gray-200" },
+  { value: "refunded", label: "Refunded", color: "bg-slate-100 text-slate-700 border-slate-200" },
+  { value: "failed", label: "Failed", color: "bg-red-100 text-red-800 border-red-200" },
+];
+
+export const PRODUCT_STATUSES = [
+  { value: "draft", label: "Draft", color: "bg-gray-100 text-gray-700 border-gray-200" },
+  { value: "pending", label: "Pending review", color: "bg-amber-100 text-amber-800 border-amber-200" },
+  { value: "private", label: "Private", color: "bg-slate-100 text-slate-700 border-slate-200" },
+  { value: "publish", label: "Published", color: "bg-green-100 text-green-800 border-green-200" },
+];
+
+export const PRODUCT_TYPES = [
+  { value: "simple", label: "Simple product" },
+  { value: "grouped", label: "Grouped product" },
+  { value: "external", label: "External/Affiliate product" },
+  { value: "variable", label: "Variable product" },
+];
+
+export const CATALOG_VISIBILITIES = [
+  { value: "visible", label: "Shop and search results" },
+  { value: "catalog", label: "Shop only" },
+  { value: "search", label: "Search results only" },
+  { value: "hidden", label: "Hidden" },
+];
+
+export const STOCK_STATUSES = [
+  { value: "instock", label: "In stock", color: "bg-green-100 text-green-800 border-green-200" },
+  { value: "outofstock", label: "Out of stock", color: "bg-red-100 text-red-800 border-red-200" },
+  { value: "onbackorder", label: "On backorder", color: "bg-amber-100 text-amber-800 border-amber-200" },
+];
+
+export const BACKORDER_OPTIONS = [
+  { value: "no", label: "Do not allow" },
+  { value: "notify", label: "Allow, but notify customer" },
+  { value: "yes", label: "Allow" },
+];
+
+export const TAX_STATUSES = [
+  { value: "taxable", label: "Taxable" },
+  { value: "shipping", label: "Shipping only" },
+  { value: "none", label: "None" },
+];
+
+export const COUPON_TYPES = [
+  { value: "percent", label: "Percentage discount" },
+  { value: "fixed_cart", label: "Fixed cart discount" },
+  { value: "fixed_product", label: "Fixed product discount" },
+];
+
+export const REVIEW_STATUSES = [
+  { value: "approved", label: "Approved", color: "bg-green-100 text-green-800 border-green-200" },
+  { value: "hold", label: "Pending", color: "bg-amber-100 text-amber-800 border-amber-200" },
+  { value: "spam", label: "Spam", color: "bg-red-100 text-red-800 border-red-200" },
+  { value: "trash", label: "Trash", color: "bg-gray-100 text-gray-700 border-gray-200" },
+];
+
+export const WEBHOOK_STATUSES = [
+  { value: "active", label: "Active", color: "bg-green-100 text-green-800 border-green-200" },
+  { value: "paused", label: "Paused", color: "bg-amber-100 text-amber-800 border-amber-200" },
+  { value: "disabled", label: "Disabled", color: "bg-gray-100 text-gray-700 border-gray-200" },
+];
+
+export const WEBHOOK_TOPICS = [
+  "order.created", "order.updated", "order.deleted", "order.restored",
+  "product.created", "product.updated", "product.deleted", "product.restored",
+  "customer.created", "customer.updated", "customer.deleted",
+  "coupon.created", "coupon.updated", "coupon.deleted",
+];
+
+export const SHIPPING_METHOD_TYPES = [
+  { value: "flat_rate", label: "Flat rate" },
+  { value: "free_shipping", label: "Free shipping" },
+  { value: "local_pickup", label: "Local pickup" },
+];
+
+export const FREE_SHIPPING_REQUIRES = [
+  { value: "", label: "No requirement" },
+  { value: "coupon", label: "A valid free shipping coupon" },
+  { value: "min_amount", label: "A minimum order amount" },
+  { value: "either", label: "A minimum order amount OR a coupon" },
+  { value: "both", label: "A minimum order amount AND a coupon" },
+];
+
+/**
+ * The 11 transactional emails.
+ * `recipient: "admin"` emails expose a Recipient override in the Emails settings.
+ * `managed_by_auth` emails are handled by Base44 auth, not this template.
+ */
+export const EMAIL_TYPES = [
+  { id: "new_order", label: "New order", recipient: "admin" },
+  { id: "cancelled_order", label: "Cancelled order", recipient: "admin" },
+  { id: "failed_order", label: "Failed order", recipient: "admin" },
+  { id: "on_hold_order", label: "Order on-hold", recipient: "customer" },
+  { id: "processing_order", label: "Processing order", recipient: "customer" },
+  { id: "completed_order", label: "Completed order", recipient: "customer" },
+  { id: "refunded_order", label: "Refunded order", recipient: "customer" },
+  { id: "customer_invoice", label: "Customer invoice / Order details", recipient: "customer", manual: true },
+  { id: "customer_note", label: "Customer note", recipient: "customer" },
+  { id: "reset_password", label: "Reset password", recipient: "customer", managed_by_auth: true },
+  { id: "new_account", label: "New account", recipient: "customer", managed_by_auth: true },
+];
+
+export const CURRENCIES = [
+  { code: "USD", name: "US Dollar", symbol: "$", decimals: 2 },
+  { code: "EUR", name: "Euro", symbol: "€", decimals: 2 },
+  { code: "GBP", name: "Pound Sterling", symbol: "£", decimals: 2 },
+  { code: "JPY", name: "Japanese Yen", symbol: "¥", decimals: 0 },
+  { code: "CNY", name: "Chinese Yuan", symbol: "¥", decimals: 2 },
+  { code: "AUD", name: "Australian Dollar", symbol: "A$", decimals: 2 },
+  { code: "CAD", name: "Canadian Dollar", symbol: "C$", decimals: 2 },
+  { code: "CHF", name: "Swiss Franc", symbol: "CHF", decimals: 2 },
+  { code: "HKD", name: "Hong Kong Dollar", symbol: "HK$", decimals: 2 },
+  { code: "SGD", name: "Singapore Dollar", symbol: "S$", decimals: 2 },
+  { code: "SEK", name: "Swedish Krona", symbol: "kr", decimals: 2 },
+  { code: "NOK", name: "Norwegian Krone", symbol: "kr", decimals: 2 },
+  { code: "DKK", name: "Danish Krone", symbol: "kr", decimals: 2 },
+  { code: "NZD", name: "New Zealand Dollar", symbol: "NZ$", decimals: 2 },
+  { code: "MXN", name: "Mexican Peso", symbol: "$", decimals: 2 },
+  { code: "BRL", name: "Brazilian Real", symbol: "R$", decimals: 2 },
+  { code: "INR", name: "Indian Rupee", symbol: "₹", decimals: 2 },
+  { code: "KRW", name: "South Korean Won", symbol: "₩", decimals: 0 },
+  { code: "TRY", name: "Turkish Lira", symbol: "₺", decimals: 2 },
+  { code: "ZAR", name: "South African Rand", symbol: "R", decimals: 2 },
+  { code: "PLN", name: "Polish Złoty", symbol: "zł", decimals: 2 },
+  { code: "CZK", name: "Czech Koruna", symbol: "Kč", decimals: 2 },
+  { code: "HUF", name: "Hungarian Forint", symbol: "Ft", decimals: 0 },
+  { code: "ILS", name: "Israeli New Shekel", symbol: "₪", decimals: 2 },
+  { code: "AED", name: "UAE Dirham", symbol: "د.إ", decimals: 2 },
+  { code: "SAR", name: "Saudi Riyal", symbol: "﷼", decimals: 2 },
+  { code: "THB", name: "Thai Baht", symbol: "฿", decimals: 2 },
+  { code: "MYR", name: "Malaysian Ringgit", symbol: "RM", decimals: 2 },
+  { code: "PHP", name: "Philippine Peso", symbol: "₱", decimals: 2 },
+  { code: "IDR", name: "Indonesian Rupiah", symbol: "Rp", decimals: 0 },
+  { code: "VND", name: "Vietnamese Dong", symbol: "₫", decimals: 0 },
+];
+
+export const CURRENCY_POSITIONS = [
+  { value: "left", label: "Left ($99.99)" },
+  { value: "right", label: "Right (99.99$)" },
+  { value: "left_space", label: "Left with space ($ 99.99)" },
+  { value: "right_space", label: "Right with space (99.99 $)" },
+];
+
+export const WEIGHT_UNITS = ["kg", "g", "lbs", "oz"];
+export const DIMENSION_UNITS = ["cm", "m", "mm", "in", "yd"];
+
+export function statusMeta(list, value) {
+  return list.find((s) => s.value === value) || { value, label: value || "—", color: "bg-gray-100 text-gray-700 border-gray-200" };
+}

package/src/commerce/admin/lib/format.js

@@ -0,0 +1,27 @@
+/** Date/text formatting helpers. */
+
+export function formatDate(iso) {
+  if (!iso) return "—";
+  const d = new Date(iso);
+  if (isNaN(d)) return "—";
+  return d.toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" });
+}
+
+export function formatDateTime(iso) {
+  if (!iso) return "—";
+  const d = new Date(iso);
+  if (isNaN(d)) return "—";
+  return d.toLocaleString(undefined, {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+export function truncate(str, n = 80) {
+  if (!str) return "";
+  const s = String(str).replace(/<[^>]*>/g, "");
+  return s.length > n ? s.slice(0, n - 1) + "…" : s;
+}

package/src/commerce/admin/lib/geo-data.js

@@ -0,0 +1,125 @@
+/**
+ * Static geographic reference data for pickers (mirror of base44/shared/commerce/data/*.ts).
+ * Countries: ISO 3166-1 alpha-2. States included for US / CA / AU; other
+ * countries accept free-text state input in AddressForm.
+ */
+
+const c = (code, name, states) => (states ? { code, name, states } : { code, name });
+const s = (code, name) => ({ code, name });
+
+export const US_STATES = [
+  s("AL", "Alabama"), s("AK", "Alaska"), s("AZ", "Arizona"), s("AR", "Arkansas"),
+  s("CA", "California"), s("CO", "Colorado"), s("CT", "Connecticut"), s("DE", "Delaware"),
+  s("DC", "District of Columbia"), s("FL", "Florida"), s("GA", "Georgia"), s("HI", "Hawaii"),
+  s("ID", "Idaho"), s("IL", "Illinois"), s("IN", "Indiana"), s("IA", "Iowa"),
+  s("KS", "Kansas"), s("KY", "Kentucky"), s("LA", "Louisiana"), s("ME", "Maine"),
+  s("MD", "Maryland"), s("MA", "Massachusetts"), s("MI", "Michigan"), s("MN", "Minnesota"),
+  s("MS", "Mississippi"), s("MO", "Missouri"), s("MT", "Montana"), s("NE", "Nebraska"),
+  s("NV", "Nevada"), s("NH", "New Hampshire"), s("NJ", "New Jersey"), s("NM", "New Mexico"),
+  s("NY", "New York"), s("NC", "North Carolina"), s("ND", "North Dakota"), s("OH", "Ohio"),
+  s("OK", "Oklahoma"), s("OR", "Oregon"), s("PA", "Pennsylvania"), s("RI", "Rhode Island"),
+  s("SC", "South Carolina"), s("SD", "South Dakota"), s("TN", "Tennessee"), s("TX", "Texas"),
+  s("UT", "Utah"), s("VT", "Vermont"), s("VA", "Virginia"), s("WA", "Washington"),
+  s("WV", "West Virginia"), s("WI", "Wisconsin"), s("WY", "Wyoming"),
+];
+
+export const CA_PROVINCES = [
+  s("AB", "Alberta"), s("BC", "British Columbia"), s("MB", "Manitoba"),
+  s("NB", "New Brunswick"), s("NL", "Newfoundland and Labrador"), s("NT", "Northwest Territories"),
+  s("NS", "Nova Scotia"), s("NU", "Nunavut"), s("ON", "Ontario"),
+  s("PE", "Prince Edward Island"), s("QC", "Quebec"), s("SK", "Saskatchewan"), s("YT", "Yukon"),
+];
+
+export const AU_STATES = [
+  s("ACT", "Australian Capital Territory"), s("NSW", "New South Wales"),
+  s("NT", "Northern Territory"), s("QLD", "Queensland"), s("SA", "South Australia"),
+  s("TAS", "Tasmania"), s("VIC", "Victoria"), s("WA", "Western Australia"),
+];
+
+export const COUNTRIES = [
+  c("AF", "Afghanistan"), c("AX", "Åland Islands"), c("AL", "Albania"), c("DZ", "Algeria"),
+  c("AS", "American Samoa"), c("AD", "Andorra"), c("AO", "Angola"), c("AI", "Anguilla"),
+  c("AQ", "Antarctica"), c("AG", "Antigua and Barbuda"), c("AR", "Argentina"), c("AM", "Armenia"),
+  c("AW", "Aruba"), c("AU", "Australia", AU_STATES), c("AT", "Austria"), c("AZ", "Azerbaijan"),
+  c("BS", "Bahamas"), c("BH", "Bahrain"), c("BD", "Bangladesh"), c("BB", "Barbados"),
+  c("BY", "Belarus"), c("BE", "Belgium"), c("BZ", "Belize"), c("BJ", "Benin"),
+  c("BM", "Bermuda"), c("BT", "Bhutan"), c("BO", "Bolivia"), c("BQ", "Bonaire, Sint Eustatius and Saba"),
+  c("BA", "Bosnia and Herzegovina"), c("BW", "Botswana"), c("BV", "Bouvet Island"), c("BR", "Brazil"),
+  c("IO", "British Indian Ocean Territory"), c("BN", "Brunei Darussalam"), c("BG", "Bulgaria"), c("BF", "Burkina Faso"),
+  c("BI", "Burundi"), c("CV", "Cabo Verde"), c("KH", "Cambodia"), c("CM", "Cameroon"),
+  c("CA", "Canada", CA_PROVINCES), c("KY", "Cayman Islands"), c("CF", "Central African Republic"), c("TD", "Chad"),
+  c("CL", "Chile"), c("CN", "China"), c("CX", "Christmas Island"), c("CC", "Cocos (Keeling) Islands"),
+  c("CO", "Colombia"), c("KM", "Comoros"), c("CG", "Congo"), c("CD", "Congo, Democratic Republic of the"),
+  c("CK", "Cook Islands"), c("CR", "Costa Rica"), c("CI", "Côte d'Ivoire"), c("HR", "Croatia"),
+  c("CU", "Cuba"), c("CW", "Curaçao"), c("CY", "Cyprus"), c("CZ", "Czechia"),
+  c("DK", "Denmark"), c("DJ", "Djibouti"), c("DM", "Dominica"), c("DO", "Dominican Republic"),
+  c("EC", "Ecuador"), c("EG", "Egypt"), c("SV", "El Salvador"), c("GQ", "Equatorial Guinea"),
+  c("ER", "Eritrea"), c("EE", "Estonia"), c("SZ", "Eswatini"), c("ET", "Ethiopia"),
+  c("FK", "Falkland Islands"), c("FO", "Faroe Islands"), c("FJ", "Fiji"), c("FI", "Finland"),
+  c("FR", "France"), c("GF", "French Guiana"), c("PF", "French Polynesia"), c("TF", "French Southern Territories"),
+  c("GA", "Gabon"), c("GM", "Gambia"), c("GE", "Georgia"), c("DE", "Germany"),
+  c("GH", "Ghana"), c("GI", "Gibraltar"), c("GR", "Greece"), c("GL", "Greenland"),
+  c("GD", "Grenada"), c("GP", "Guadeloupe"), c("GU", "Guam"), c("GT", "Guatemala"),
+  c("GG", "Guernsey"), c("GN", "Guinea"), c("GW", "Guinea-Bissau"), c("GY", "Guyana"),
+  c("HT", "Haiti"), c("HM", "Heard Island and McDonald Islands"), c("VA", "Holy See"), c("HN", "Honduras"),
+  c("HK", "Hong Kong"), c("HU", "Hungary"), c("IS", "Iceland"), c("IN", "India"),
+  c("ID", "Indonesia"), c("IR", "Iran"), c("IQ", "Iraq"), c("IE", "Ireland"),
+  c("IM", "Isle of Man"), c("IL", "Israel"), c("IT", "Italy"), c("JM", "Jamaica"),
+  c("JP", "Japan"), c("JE", "Jersey"), c("JO", "Jordan"), c("KZ", "Kazakhstan"),
+  c("KE", "Kenya"), c("KI", "Kiribati"), c("KP", "Korea, North"), c("KR", "Korea, South"),
+  c("KW", "Kuwait"), c("KG", "Kyrgyzstan"), c("LA", "Lao People's Democratic Republic"), c("LV", "Latvia"),
+  c("LB", "Lebanon"), c("LS", "Lesotho"), c("LR", "Liberia"), c("LY", "Libya"),
+  c("LI", "Liechtenstein"), c("LT", "Lithuania"), c("LU", "Luxembourg"), c("MO", "Macao"),
+  c("MG", "Madagascar"), c("MW", "Malawi"), c("MY", "Malaysia"), c("MV", "Maldives"),
+  c("ML", "Mali"), c("MT", "Malta"), c("MH", "Marshall Islands"), c("MQ", "Martinique"),
+  c("MR", "Mauritania"), c("MU", "Mauritius"), c("YT", "Mayotte"), c("MX", "Mexico"),
+  c("FM", "Micronesia"), c("MD", "Moldova"), c("MC", "Monaco"), c("MN", "Mongolia"),
+  c("ME", "Montenegro"), c("MS", "Montserrat"), c("MA", "Morocco"), c("MZ", "Mozambique"),
+  c("MM", "Myanmar"), c("NA", "Namibia"), c("NR", "Nauru"), c("NP", "Nepal"),
+  c("NL", "Netherlands"), c("NC", "New Caledonia"), c("NZ", "New Zealand"), c("NI", "Nicaragua"),
+  c("NE", "Niger"), c("NG", "Nigeria"), c("NU", "Niue"), c("NF", "Norfolk Island"),
+  c("MK", "North Macedonia"), c("MP", "Northern Mariana Islands"), c("NO", "Norway"), c("OM", "Oman"),
+  c("PK", "Pakistan"), c("PW", "Palau"), c("PS", "Palestine, State of"), c("PA", "Panama"),
+  c("PG", "Papua New Guinea"), c("PY", "Paraguay"), c("PE", "Peru"), c("PH", "Philippines"),
+  c("PN", "Pitcairn"), c("PL", "Poland"), c("PT", "Portugal"), c("PR", "Puerto Rico"),
+  c("QA", "Qatar"), c("RE", "Réunion"), c("RO", "Romania"), c("RU", "Russian Federation"),
+  c("RW", "Rwanda"), c("BL", "Saint Barthélemy"), c("SH", "Saint Helena"), c("KN", "Saint Kitts and Nevis"),
+  c("LC", "Saint Lucia"), c("MF", "Saint Martin (French part)"), c("PM", "Saint Pierre and Miquelon"), c("VC", "Saint Vincent and the Grenadines"),
+  c("WS", "Samoa"), c("SM", "San Marino"), c("ST", "Sao Tome and Principe"), c("SA", "Saudi Arabia"),
+  c("SN", "Senegal"), c("RS", "Serbia"), c("SC", "Seychelles"), c("SL", "Sierra Leone"),
+  c("SG", "Singapore"), c("SX", "Sint Maarten (Dutch part)"), c("SK", "Slovakia"), c("SI", "Slovenia"),
+  c("SB", "Solomon Islands"), c("SO", "Somalia"), c("ZA", "South Africa"), c("GS", "South Georgia and the South Sandwich Islands"),
+  c("SS", "South Sudan"), c("ES", "Spain"), c("LK", "Sri Lanka"), c("SD", "Sudan"),
+  c("SR", "Suriname"), c("SJ", "Svalbard and Jan Mayen"), c("SE", "Sweden"), c("CH", "Switzerland"),
+  c("SY", "Syrian Arab Republic"), c("TW", "Taiwan"), c("TJ", "Tajikistan"), c("TZ", "Tanzania"),
+  c("TH", "Thailand"), c("TL", "Timor-Leste"), c("TG", "Togo"), c("TK", "Tokelau"),
+  c("TO", "Tonga"), c("TT", "Trinidad and Tobago"), c("TN", "Tunisia"), c("TR", "Türkiye"),
+  c("TM", "Turkmenistan"), c("TC", "Turks and Caicos Islands"), c("TV", "Tuvalu"), c("UG", "Uganda"),
+  c("UA", "Ukraine"), c("AE", "United Arab Emirates"), c("GB", "United Kingdom"), c("US", "United States", US_STATES),
+  c("UM", "United States Minor Outlying Islands"), c("UY", "Uruguay"), c("UZ", "Uzbekistan"), c("VU", "Vanuatu"),
+  c("VE", "Venezuela"), c("VN", "Viet Nam"), c("VG", "Virgin Islands (British)"), c("VI", "Virgin Islands (U.S.)"),
+  c("WF", "Wallis and Futuna"), c("EH", "Western Sahara"), c("YE", "Yemen"), c("ZM", "Zambia"),
+  c("ZW", "Zimbabwe"),
+];
+
+export const CONTINENTS = [
+  { code: "AF", name: "Africa", countries: ["DZ","AO","BJ","BW","BF","BI","CV","CM","CF","TD","KM","CG","CD","CI","DJ","EG","GQ","ER","SZ","ET","GA","GM","GH","GN","GW","KE","LS","LR","LY","MG","MW","ML","MR","MU","YT","MA","MZ","NA","NE","NG","RE","RW","SH","ST","SN","SC","SL","SO","ZA","SS","SD","TZ","TG","TN","UG","EH","ZM","ZW"] },
+  { code: "AN", name: "Antarctica", countries: ["AQ","BV","GS","HM","TF"] },
+  { code: "AS", name: "Asia", countries: ["AF","AM","AZ","BH","BD","BT","BN","KH","CN","CY","GE","HK","IN","ID","IR","IQ","IL","JP","JO","KZ","KP","KR","KW","KG","LA","LB","MO","MY","MV","MN","MM","NP","OM","PK","PS","PH","QA","SA","SG","LK","SY","TW","TJ","TH","TL","TR","TM","AE","UZ","VN","YE"] },
+  { code: "EU", name: "Europe", countries: ["AX","AL","AD","AT","BY","BE","BA","BG","HR","CZ","DK","EE","FO","FI","FR","DE","GI","GR","GG","VA","HU","IS","IE","IM","IT","JE","LV","LI","LT","LU","MT","MD","MC","ME","NL","MK","NO","PL","PT","RO","RU","SM","RS","SK","SI","ES","SJ","SE","CH","UA","GB"] },
+  { code: "NA", name: "North America", countries: ["AI","AG","AW","BS","BB","BZ","BM","BQ","CA","KY","CR","CU","CW","DM","DO","SV","GL","GD","GP","GT","HT","HN","JM","MQ","MX","MS","NI","PA","PR","BL","KN","LC","MF","PM","VC","SX","TT","TC","US","UM","VG","VI"] },
+  { code: "OC", name: "Oceania", countries: ["AS","AU","CX","CC","CK","FJ","PF","GU","KI","MH","FM","NR","NC","NZ","NU","NF","MP","PW","PG","PN","WS","SB","TK","TO","TV","VU","WF"] },
+  { code: "SA", name: "South America", countries: ["AR","BO","BR","CL","CO","EC","FK","GF","GY","PY","PE","SR","UY","VE"] },
+];
+
+export function countryByCode(code) {
+  return COUNTRIES.find((x) => x.code === code) || null;
+}
+
+export function countryName(code) {
+  return countryByCode(code)?.name || code || "";
+}
+
+export function statesFor(code) {
+  return countryByCode(code)?.states || null;
+}