@btst/plugin-affiliate 0.0.0-stage → 1.0.0-beta.0

package/dist/client/components/pages.mjs

@@ -0,0 +1,138 @@
+'use client';
+import { jsx } from 'react/jsx-runtime';
+import { useState, useEffect, lazy } from 'react';
+import { ComposedRoute } from '@btst/stack/client/components';
+import { affiliatePermissions } from '../../permissions.mjs';
+import { AffiliateNotFound, AffiliateLoading, AffiliateError } from './shared.mjs';
+
+const Affiliates = lazy(
+  () => import('./pages/affiliates-page.internal.mjs').then((m) => ({
+    default: m.AffiliatesPage
+  }))
+);
+const Detail = lazy(
+  () => import('./pages/affiliate-detail-page.internal.mjs').then((m) => ({
+    default: m.AffiliateDetailPage
+  }))
+);
+const Commissions = lazy(
+  () => import('./pages/commissions-page.internal.mjs').then((m) => ({
+    default: m.CommissionsPage
+  }))
+);
+const Payouts = lazy(
+  () => import('./pages/payouts-page.internal.mjs').then((m) => ({
+    default: m.PayoutsPage
+  }))
+);
+const Apply = lazy(
+  () => import('./pages/affiliate-apply-page.internal.mjs').then((m) => ({
+    default: m.AffiliateApplyPage
+  }))
+);
+const Portal = lazy(
+  () => import('./pages/affiliate-portal-page.internal.mjs').then((m) => ({
+    default: m.AffiliatePortalPage
+  }))
+);
+function BrowserPage({ children }) {
+  const [mounted, setMounted] = useState(false);
+  useEffect(() => setMounted(true), []);
+  return mounted ? children : /* @__PURE__ */ jsx(AffiliateLoading, {});
+}
+const boundary = {
+  ErrorComponent: AffiliateError,
+  LoadingComponent: AffiliateLoading,
+  NotFoundComponent: AffiliateNotFound,
+  onError: (error) => console.error("[btst/affiliate]", error)
+};
+function AffiliateList() {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Affiliates, {}) });
+}
+function AffiliateDetail(props) {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Detail, { ...props }) });
+}
+function CommissionList() {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Commissions, {}) });
+}
+function PayoutList() {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Payouts, {}) });
+}
+function Application() {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Apply, {}) });
+}
+function PortalDashboard() {
+  return /* @__PURE__ */ jsx(BrowserPage, { children: /* @__PURE__ */ jsx(Portal, {}) });
+}
+function AffiliatesPageComponent() {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: "/affiliate/admin/affiliates",
+      permission: affiliatePermissions.affiliate.read({ scope: "collection" }),
+      PageComponent: AffiliateList
+    }
+  );
+}
+function AffiliateDetailPageComponent({ id }) {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: `/affiliate/admin/affiliates/${id}`,
+      permission: affiliatePermissions.affiliate.read({
+        scope: "record",
+        affiliateId: id
+      }),
+      PageComponent: AffiliateDetail,
+      props: { id }
+    }
+  );
+}
+function CommissionsPageComponent() {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: "/affiliate/admin/commissions",
+      permission: affiliatePermissions.commission.read(),
+      PageComponent: CommissionList
+    }
+  );
+}
+function PayoutsPageComponent() {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: "/affiliate/admin/payouts",
+      permission: affiliatePermissions.payout.read(),
+      PageComponent: PayoutList
+    }
+  );
+}
+function AffiliateApplyPageComponent() {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: "/affiliate/apply",
+      permission: affiliatePermissions.application.create(),
+      PageComponent: Application
+    }
+  );
+}
+function AffiliatePortalPageComponent() {
+  return /* @__PURE__ */ jsx(
+    ComposedRoute,
+    {
+      ...boundary,
+      path: "/affiliate/portal",
+      permission: affiliatePermissions.portal.read(),
+      PageComponent: PortalDashboard
+    }
+  );
+}
+
+export { AffiliateApplyPageComponent, AffiliateDetailPageComponent, AffiliatePortalPageComponent, AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent };

package/dist/client/components/shared.cjs

@@ -0,0 +1,331 @@
+'use client';
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const react = require('react');
+const context = require('@btst/stack/context');
+const permissions = require('../../permissions.cjs');
+const constants = require('../constants.cjs');
+
+function AffiliatePage({
+  title,
+  description,
+  action,
+  admin = true,
+  children
+}) {
+  const { Link, resolve } = context.usePluginSiteNavigation(constants.AFFILIATE_PLUGIN_ID);
+  const { localization } = context.usePluginOverrides(constants.AFFILIATE_PLUGIN_ID);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-page", "data-testid": "affiliate-page", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("header", { className: "affiliate-heading", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h1", { children: title }),
+        description && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "affiliate-muted", children: description })
+      ] }),
+      action
+    ] }),
+    admin && /* @__PURE__ */ jsxRuntime.jsxs("nav", { className: "affiliate-nav", "aria-label": "Affiliate administration", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        context.PermissionAccess,
+        {
+          permission: permissions.affiliatePermissions.affiliate.read({
+            scope: "collection"
+          }),
+          children: /* @__PURE__ */ jsxRuntime.jsx(Link, { href: resolve("affiliate/admin/affiliates").href, children: localization?.affiliates ?? "Affiliates" })
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(context.PermissionAccess, { permission: permissions.affiliatePermissions.commission.read(), children: /* @__PURE__ */ jsxRuntime.jsx(Link, { href: resolve("affiliate/admin/commissions").href, children: localization?.commissions ?? "Commissions" }) }),
+      /* @__PURE__ */ jsxRuntime.jsx(context.PermissionAccess, { permission: permissions.affiliatePermissions.payout.read(), children: /* @__PURE__ */ jsxRuntime.jsx(Link, { href: resolve("affiliate/admin/payouts").href, children: localization?.payouts ?? "Payouts" }) })
+    ] }),
+    children
+  ] });
+}
+function Field({
+  label,
+  hint,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "affiliate-field", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { children: label }),
+    children,
+    hint && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "affiliate-muted affiliate-small", children: hint })
+  ] });
+}
+function ProfileFields({
+  affiliate,
+  defaults,
+  userId = false,
+  admin = false
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-form-grid", children: [
+    userId && /* @__PURE__ */ jsxRuntime.jsx(
+      Field,
+      {
+        label: "User ID",
+        hint: "The account that will own this affiliate portal.",
+        children: /* @__PURE__ */ jsxRuntime.jsx("input", { name: "userId", required: true, maxLength: 255 })
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx(Field, { label: "Name", children: /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        name: "name",
+        required: true,
+        maxLength: 200,
+        autoComplete: "name",
+        defaultValue: affiliate?.name ?? defaults?.name ?? ""
+      }
+    ) }),
+    /* @__PURE__ */ jsxRuntime.jsx(Field, { label: "Email", children: /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        name: "email",
+        type: "email",
+        required: true,
+        maxLength: 320,
+        autoComplete: "email",
+        defaultValue: affiliate?.email ?? defaults?.email ?? ""
+      }
+    ) }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      Field,
+      {
+        label: "Referral code",
+        hint: "3\u201364 lowercase letters, numbers, or single hyphens. Leave blank to generate a code.",
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          "input",
+          {
+            name: "code",
+            minLength: 3,
+            maxLength: 64,
+            pattern: "[a-z0-9]+(-[a-z0-9]+)*",
+            defaultValue: affiliate?.code ?? ""
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      Field,
+      {
+        label: "Payout details",
+        hint: "Payment instructions for the person arranging your payouts.",
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          "textarea",
+          {
+            name: "payoutDetails",
+            rows: 3,
+            maxLength: 1e4,
+            defaultValue: affiliate?.payoutDetails ?? ""
+          }
+        )
+      }
+    ),
+    admin && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Field, { label: "Status", children: /* @__PURE__ */ jsxRuntime.jsxs("select", { name: "status", defaultValue: affiliate?.status ?? "pending", children: [
+        (!affiliate || affiliate.status === "pending") && /* @__PURE__ */ jsxRuntime.jsx("option", { value: "pending", children: "Pending" }),
+        /* @__PURE__ */ jsxRuntime.jsx("option", { value: "approved", children: "Approved" }),
+        /* @__PURE__ */ jsxRuntime.jsx("option", { value: "suspended", children: "Suspended" })
+      ] }) }),
+      /* @__PURE__ */ jsxRuntime.jsx(Field, { label: "Commission rule", children: /* @__PURE__ */ jsxRuntime.jsxs(
+        "select",
+        {
+          name: "commissionType",
+          defaultValue: affiliate?.commissionType ?? "",
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", children: "Program default" }),
+            /* @__PURE__ */ jsxRuntime.jsx("option", { value: "percent", children: "Percentage" }),
+            /* @__PURE__ */ jsxRuntime.jsx("option", { value: "flat", children: "Flat amount" })
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        Field,
+        {
+          label: "Commission value",
+          hint: "Percentage points, or a flat amount in minor units (100 = USD 1.00).",
+          children: /* @__PURE__ */ jsxRuntime.jsx(
+            "input",
+            {
+              name: "commissionValue",
+              type: "number",
+              min: "0",
+              step: "any",
+              defaultValue: affiliate?.commissionValue ?? ""
+            }
+          )
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(Field, { label: "Internal notes", children: /* @__PURE__ */ jsxRuntime.jsx(
+        "textarea",
+        {
+          name: "notes",
+          maxLength: 1e4,
+          rows: 3,
+          defaultValue: affiliate?.notes ?? ""
+        }
+      ) })
+    ] })
+  ] });
+}
+function readProfile(fields) {
+  const code = String(fields.get("code") ?? "").trim();
+  return {
+    name: String(fields.get("name") ?? ""),
+    email: String(fields.get("email") ?? ""),
+    ...code ? { code } : {},
+    payoutDetails: String(fields.get("payoutDetails") ?? "")
+  };
+}
+function useAffiliateAction() {
+  const [error, setError] = react.useState("");
+  const [message, setMessage] = react.useState("");
+  const [pending, setPending] = react.useState(false);
+  const run = async (action, success = "") => {
+    setError("");
+    setMessage("");
+    setPending(true);
+    try {
+      await action();
+      setMessage(success);
+    } catch (caught) {
+      setError(
+        caught instanceof Error ? caught.message : "The change could not be saved. Try again."
+      );
+    } finally {
+      setPending(false);
+    }
+  };
+  return { error, message, pending, run };
+}
+function ActionNotice({
+  error,
+  message
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    error && /* @__PURE__ */ jsxRuntime.jsx("p", { role: "alert", className: "affiliate-error", children: error }),
+    message && /* @__PURE__ */ jsxRuntime.jsx("p", { role: "status", children: message })
+  ] });
+}
+function Status({ value }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { className: "affiliate-status", "data-status": value, children: value.charAt(0).toUpperCase() + value.slice(1) });
+}
+function money(amount, currency) {
+  const formatter = new Intl.NumberFormat(void 0, {
+    style: "currency",
+    currency
+  });
+  const digits = formatter.resolvedOptions().maximumFractionDigits ?? 2;
+  return formatter.format(amount / 10 ** digits);
+}
+function date(value) {
+  return new Date(value).toLocaleDateString(void 0, {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+}
+function Stats({ stats }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "section",
+    {
+      "aria-label": "Affiliate performance",
+      className: "affiliate-performance",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("dl", { className: "affiliate-metrics", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Referral clicks" }),
+            /* @__PURE__ */ jsxRuntime.jsx("dd", { children: stats.clicks.toLocaleString() })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Conversions" }),
+            /* @__PURE__ */ jsxRuntime.jsx("dd", { children: stats.conversions.toLocaleString() })
+          ] })
+        ] }),
+        stats.totals.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(
+          "div",
+          {
+            className: "affiliate-table-scroll",
+            role: "region",
+            "aria-label": "Commission totals",
+            tabIndex: 0,
+            children: /* @__PURE__ */ jsxRuntime.jsxs("table", { children: [
+              /* @__PURE__ */ jsxRuntime.jsx("caption", { className: "affiliate-sr-only", children: "Commission totals by currency" }),
+              /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+                /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Currency" }),
+                /* @__PURE__ */ jsxRuntime.jsx("th", { className: "affiliate-number", children: "Pending" }),
+                /* @__PURE__ */ jsxRuntime.jsx("th", { className: "affiliate-number", children: "Approved" }),
+                /* @__PURE__ */ jsxRuntime.jsx("th", { className: "affiliate-number", children: "Paid" })
+              ] }) }),
+              /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: stats.totals.map((total) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+                /* @__PURE__ */ jsxRuntime.jsx("th", { scope: "row", children: total.currency }),
+                /* @__PURE__ */ jsxRuntime.jsx("td", { className: "affiliate-number", children: money(total.pending, total.currency) }),
+                /* @__PURE__ */ jsxRuntime.jsx("td", { className: "affiliate-number", children: money(total.approved, total.currency) }),
+                /* @__PURE__ */ jsxRuntime.jsx("td", { className: "affiliate-number", children: money(total.paid, total.currency) })
+              ] }, total.currency)) })
+            ] })
+          }
+        )
+      ]
+    }
+  );
+}
+function Pagination({
+  offset,
+  total,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-pagination", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "affiliate-muted", children: total === 0 ? "No results" : `${offset + 1}\u2013${Math.min(offset + 25, total)} of ${total}` }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-actions", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          disabled: offset === 0,
+          onClick: () => onChange(Math.max(0, offset - 25)),
+          children: "Previous page"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          disabled: offset + 25 >= total,
+          onClick: () => onChange(offset + 25),
+          children: "Next page"
+        }
+      )
+    ] })
+  ] });
+}
+function AffiliateLoading() {
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "affiliate-page", role: "status", children: "Loading affiliate information\u2026" });
+}
+function AffiliateError({ error, resetErrorBoundary }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-page affiliate-stack", role: "alert", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("h1", { children: "Affiliate information unavailable" }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { children: error instanceof Error && error.message ? error.message : "Check your access and try again." }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: resetErrorBoundary, children: "Retry loading" })
+  ] });
+}
+function AffiliateNotFound({ message }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-page", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("h1", { children: "Affiliate not found" }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { children: message })
+  ] });
+}
+
+exports.ActionNotice = ActionNotice;
+exports.AffiliateError = AffiliateError;
+exports.AffiliateLoading = AffiliateLoading;
+exports.AffiliateNotFound = AffiliateNotFound;
+exports.AffiliatePage = AffiliatePage;
+exports.Field = Field;
+exports.Pagination = Pagination;
+exports.ProfileFields = ProfileFields;
+exports.Stats = Stats;
+exports.Status = Status;
+exports.date = date;
+exports.money = money;
+exports.readProfile = readProfile;
+exports.useAffiliateAction = useAffiliateAction;