@btst/plugin-affiliate 0.0.0-stage → 1.0.0

package/dist/attribution.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+const AFFILIATE_COOKIE_NAME = "btst_affiliate";
+function safeLandingPath(value = "/") {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(value);
+  } catch {
+    throw new Error("Invalid landing path");
+  }
+  if (!decoded.startsWith("/") || decoded.startsWith("//") || /[\\\u0000-\u0020\u007f]/.test(decoded)) {
+    throw new Error("Landing path must be a local absolute path");
+  }
+  const parsed = new URL(value, "https://affiliate.invalid");
+  if (parsed.origin !== "https://affiliate.invalid" || parsed.pathname.startsWith("//") || decodeURIComponent(parsed.pathname).startsWith("//"))
+    throw new Error("Invalid landing path");
+  return parsed.pathname + parsed.search + parsed.hash;
+}
+function referralCodeFromURL(url, parameters = ["ref", "affiliate"]) {
+  const parsed = typeof url === "string" ? new URL(url, "https://affiliate.invalid") : url;
+  for (const name of parameters) {
+    const value = parsed.searchParams.get(name);
+    if (value) return value;
+  }
+  return null;
+}
+function isClickWithinWindow(click, days = 30, now = /* @__PURE__ */ new Date()) {
+  const age = now.getTime() - new Date(click.createdAt).getTime();
+  return Number.isFinite(age) && age >= 0 && age < days * 864e5;
+}
+function selectAttributionClick(previous, current, options = {}) {
+  return options.attributionMode === "first_touch" && previous && isClickWithinWindow(previous, options.attributionWindowDays) ? previous : current;
+}
+function createReferralLink(baseURL, code, landingPath = "/") {
+  const base = new URL(baseURL);
+  if (!["https:", "http:"].includes(base.protocol))
+    throw new Error("Referral links require HTTP or HTTPS");
+  const url = new URL(safeLandingPath(landingPath), base.origin);
+  url.searchParams.set("ref", code);
+  return url.href;
+}
+function attributionFromRequest(request) {
+  const code = referralCodeFromURL(request.url);
+  if (code) return { code };
+  for (const cookie of (request.headers.get("cookie") ?? "").split(";")) {
+    const separator = cookie.indexOf("=");
+    if (separator < 0 || cookie.slice(0, separator).trim() !== AFFILIATE_COOKIE_NAME)
+      continue;
+    try {
+      const clickId = decodeURIComponent(cookie.slice(separator + 1).trim());
+      return clickId ? { clickId } : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function createTrackingLink(apiBaseURL, code, landingPath = "/") {
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(code) || code.length < 3 || code.length > 64)
+    throw new Error("Invalid affiliate code");
+  const base = new URL(apiBaseURL);
+  if (!["http:", "https:"].includes(base.protocol))
+    throw new Error("Tracking links require HTTP or HTTPS");
+  const url = new URL(
+    `${base.pathname.replace(/\/$/, "")}/affiliate/track/${encodeURIComponent(code)}`,
+    base.origin
+  );
+  url.searchParams.set("to", safeLandingPath(landingPath));
+  return url.href;
+}
+function getReferralRedirect(value, apiBaseURL) {
+  const url = new URL(value);
+  const code = referralCodeFromURL(url);
+  if (!code) return null;
+  url.searchParams.delete("ref");
+  url.searchParams.delete("affiliate");
+  return createTrackingLink(
+    apiBaseURL,
+    code,
+    url.pathname + url.search + url.hash
+  );
+}
+
+exports.AFFILIATE_COOKIE_NAME = AFFILIATE_COOKIE_NAME;
+exports.attributionFromRequest = attributionFromRequest;
+exports.createReferralLink = createReferralLink;
+exports.createTrackingLink = createTrackingLink;
+exports.getReferralRedirect = getReferralRedirect;
+exports.isClickWithinWindow = isClickWithinWindow;
+exports.referralCodeFromURL = referralCodeFromURL;
+exports.safeLandingPath = safeLandingPath;
+exports.selectAttributionClick = selectAttributionClick;

package/dist/attribution.d.cts

@@ -0,0 +1,20 @@
+import { ReferralClick, AffiliateOptions } from './types.cjs';
+
+declare const AFFILIATE_COOKIE_NAME = "btst_affiliate";
+/** Only local absolute paths are accepted; URL parsing also catches encoded authority paths. */
+declare function safeLandingPath(value?: string): string;
+declare function referralCodeFromURL(url: string | URL, parameters?: string[]): string | null;
+declare function isClickWithinWindow(click: Pick<ReferralClick, "createdAt">, days?: number, now?: Date): boolean;
+/** The caller must load the previous opaque cookie click ID from the database first. */
+declare function selectAttributionClick(previous: ReferralClick | null, current: ReferralClick, options?: AffiliateOptions): ReferralClick;
+declare function createReferralLink(baseURL: string, code: string, landingPath?: string): string;
+/** Checkout helpers resolve query codes or opaque click IDs; timestamps always come from the database. */
+declare function attributionFromRequest(request: Request): {
+    code?: string;
+    clickId?: string;
+} | undefined;
+declare function createTrackingLink(apiBaseURL: string, code: string, landingPath?: string): string;
+/** Redirect query-param referrals through tracking once, then return to the landing page without referral params. */
+declare function getReferralRedirect(value: string | URL, apiBaseURL: string): string | null;
+
+export { AFFILIATE_COOKIE_NAME, attributionFromRequest, createReferralLink, createTrackingLink, getReferralRedirect, isClickWithinWindow, referralCodeFromURL, safeLandingPath, selectAttributionClick };

package/dist/attribution.d.mts

@@ -0,0 +1,20 @@
+import { ReferralClick, AffiliateOptions } from './types.mjs';
+
+declare const AFFILIATE_COOKIE_NAME = "btst_affiliate";
+/** Only local absolute paths are accepted; URL parsing also catches encoded authority paths. */
+declare function safeLandingPath(value?: string): string;
+declare function referralCodeFromURL(url: string | URL, parameters?: string[]): string | null;
+declare function isClickWithinWindow(click: Pick<ReferralClick, "createdAt">, days?: number, now?: Date): boolean;
+/** The caller must load the previous opaque cookie click ID from the database first. */
+declare function selectAttributionClick(previous: ReferralClick | null, current: ReferralClick, options?: AffiliateOptions): ReferralClick;
+declare function createReferralLink(baseURL: string, code: string, landingPath?: string): string;
+/** Checkout helpers resolve query codes or opaque click IDs; timestamps always come from the database. */
+declare function attributionFromRequest(request: Request): {
+    code?: string;
+    clickId?: string;
+} | undefined;
+declare function createTrackingLink(apiBaseURL: string, code: string, landingPath?: string): string;
+/** Redirect query-param referrals through tracking once, then return to the landing page without referral params. */
+declare function getReferralRedirect(value: string | URL, apiBaseURL: string): string | null;
+
+export { AFFILIATE_COOKIE_NAME, attributionFromRequest, createReferralLink, createTrackingLink, getReferralRedirect, isClickWithinWindow, referralCodeFromURL, safeLandingPath, selectAttributionClick };

package/dist/attribution.d.ts

@@ -0,0 +1,20 @@
+import { ReferralClick, AffiliateOptions } from './types.js';
+
+declare const AFFILIATE_COOKIE_NAME = "btst_affiliate";
+/** Only local absolute paths are accepted; URL parsing also catches encoded authority paths. */
+declare function safeLandingPath(value?: string): string;
+declare function referralCodeFromURL(url: string | URL, parameters?: string[]): string | null;
+declare function isClickWithinWindow(click: Pick<ReferralClick, "createdAt">, days?: number, now?: Date): boolean;
+/** The caller must load the previous opaque cookie click ID from the database first. */
+declare function selectAttributionClick(previous: ReferralClick | null, current: ReferralClick, options?: AffiliateOptions): ReferralClick;
+declare function createReferralLink(baseURL: string, code: string, landingPath?: string): string;
+/** Checkout helpers resolve query codes or opaque click IDs; timestamps always come from the database. */
+declare function attributionFromRequest(request: Request): {
+    code?: string;
+    clickId?: string;
+} | undefined;
+declare function createTrackingLink(apiBaseURL: string, code: string, landingPath?: string): string;
+/** Redirect query-param referrals through tracking once, then return to the landing page without referral params. */
+declare function getReferralRedirect(value: string | URL, apiBaseURL: string): string | null;
+
+export { AFFILIATE_COOKIE_NAME, attributionFromRequest, createReferralLink, createTrackingLink, getReferralRedirect, isClickWithinWindow, referralCodeFromURL, safeLandingPath, selectAttributionClick };

package/dist/attribution.mjs

@@ -0,0 +1,82 @@
+const AFFILIATE_COOKIE_NAME = "btst_affiliate";
+function safeLandingPath(value = "/") {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(value);
+  } catch {
+    throw new Error("Invalid landing path");
+  }
+  if (!decoded.startsWith("/") || decoded.startsWith("//") || /[\\\u0000-\u0020\u007f]/.test(decoded)) {
+    throw new Error("Landing path must be a local absolute path");
+  }
+  const parsed = new URL(value, "https://affiliate.invalid");
+  if (parsed.origin !== "https://affiliate.invalid" || parsed.pathname.startsWith("//") || decodeURIComponent(parsed.pathname).startsWith("//"))
+    throw new Error("Invalid landing path");
+  return parsed.pathname + parsed.search + parsed.hash;
+}
+function referralCodeFromURL(url, parameters = ["ref", "affiliate"]) {
+  const parsed = typeof url === "string" ? new URL(url, "https://affiliate.invalid") : url;
+  for (const name of parameters) {
+    const value = parsed.searchParams.get(name);
+    if (value) return value;
+  }
+  return null;
+}
+function isClickWithinWindow(click, days = 30, now = /* @__PURE__ */ new Date()) {
+  const age = now.getTime() - new Date(click.createdAt).getTime();
+  return Number.isFinite(age) && age >= 0 && age < days * 864e5;
+}
+function selectAttributionClick(previous, current, options = {}) {
+  return options.attributionMode === "first_touch" && previous && isClickWithinWindow(previous, options.attributionWindowDays) ? previous : current;
+}
+function createReferralLink(baseURL, code, landingPath = "/") {
+  const base = new URL(baseURL);
+  if (!["https:", "http:"].includes(base.protocol))
+    throw new Error("Referral links require HTTP or HTTPS");
+  const url = new URL(safeLandingPath(landingPath), base.origin);
+  url.searchParams.set("ref", code);
+  return url.href;
+}
+function attributionFromRequest(request) {
+  const code = referralCodeFromURL(request.url);
+  if (code) return { code };
+  for (const cookie of (request.headers.get("cookie") ?? "").split(";")) {
+    const separator = cookie.indexOf("=");
+    if (separator < 0 || cookie.slice(0, separator).trim() !== AFFILIATE_COOKIE_NAME)
+      continue;
+    try {
+      const clickId = decodeURIComponent(cookie.slice(separator + 1).trim());
+      return clickId ? { clickId } : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function createTrackingLink(apiBaseURL, code, landingPath = "/") {
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(code) || code.length < 3 || code.length > 64)
+    throw new Error("Invalid affiliate code");
+  const base = new URL(apiBaseURL);
+  if (!["http:", "https:"].includes(base.protocol))
+    throw new Error("Tracking links require HTTP or HTTPS");
+  const url = new URL(
+    `${base.pathname.replace(/\/$/, "")}/affiliate/track/${encodeURIComponent(code)}`,
+    base.origin
+  );
+  url.searchParams.set("to", safeLandingPath(landingPath));
+  return url.href;
+}
+function getReferralRedirect(value, apiBaseURL) {
+  const url = new URL(value);
+  const code = referralCodeFromURL(url);
+  if (!code) return null;
+  url.searchParams.delete("ref");
+  url.searchParams.delete("affiliate");
+  return createTrackingLink(
+    apiBaseURL,
+    code,
+    url.pathname + url.search + url.hash
+  );
+}
+
+export { AFFILIATE_COOKIE_NAME, attributionFromRequest, createReferralLink, createTrackingLink, getReferralRedirect, isClickWithinWindow, referralCodeFromURL, safeLandingPath, selectAttributionClick };

package/dist/client/components/index.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+const pages = require('./pages.cjs');
+
+
+
+exports.AffiliateApplyPageComponent = pages.AffiliateApplyPageComponent;
+exports.AffiliateDetailPageComponent = pages.AffiliateDetailPageComponent;
+exports.AffiliatePortalPageComponent = pages.AffiliatePortalPageComponent;
+exports.AffiliatesPageComponent = pages.AffiliatesPageComponent;
+exports.CommissionsPageComponent = pages.CommissionsPageComponent;
+exports.PayoutsPageComponent = pages.PayoutsPageComponent;

package/dist/client/components/index.d.cts

@@ -0,0 +1,13 @@
+'use client';
+import * as react from 'react';
+
+declare function AffiliatesPageComponent(): react.JSX.Element;
+declare function AffiliateDetailPageComponent({ id }: {
+    id: string;
+}): react.JSX.Element;
+declare function CommissionsPageComponent(): react.JSX.Element;
+declare function PayoutsPageComponent(): react.JSX.Element;
+declare function AffiliateApplyPageComponent(): react.JSX.Element;
+declare function AffiliatePortalPageComponent(): react.JSX.Element;
+
+export { AffiliateApplyPageComponent, AffiliateDetailPageComponent, AffiliatePortalPageComponent, AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent };

package/dist/client/components/index.d.mts

@@ -0,0 +1,13 @@
+'use client';
+import * as react from 'react';
+
+declare function AffiliatesPageComponent(): react.JSX.Element;
+declare function AffiliateDetailPageComponent({ id }: {
+    id: string;
+}): react.JSX.Element;
+declare function CommissionsPageComponent(): react.JSX.Element;
+declare function PayoutsPageComponent(): react.JSX.Element;
+declare function AffiliateApplyPageComponent(): react.JSX.Element;
+declare function AffiliatePortalPageComponent(): react.JSX.Element;
+
+export { AffiliateApplyPageComponent, AffiliateDetailPageComponent, AffiliatePortalPageComponent, AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent };

package/dist/client/components/index.d.ts

@@ -0,0 +1,13 @@
+'use client';
+import * as react from 'react';
+
+declare function AffiliatesPageComponent(): react.JSX.Element;
+declare function AffiliateDetailPageComponent({ id }: {
+    id: string;
+}): react.JSX.Element;
+declare function CommissionsPageComponent(): react.JSX.Element;
+declare function PayoutsPageComponent(): react.JSX.Element;
+declare function AffiliateApplyPageComponent(): react.JSX.Element;
+declare function AffiliatePortalPageComponent(): react.JSX.Element;
+
+export { AffiliateApplyPageComponent, AffiliateDetailPageComponent, AffiliatePortalPageComponent, AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent };

package/dist/client/components/index.mjs

@@ -0,0 +1 @@
+export { AffiliateApplyPageComponent, AffiliateDetailPageComponent, AffiliatePortalPageComponent, AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent } from './pages.mjs';

package/dist/client/components/pages/affiliate-apply-page.internal.cjs

@@ -0,0 +1,59 @@
+'use client';
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const react = require('react');
+const context = require('@btst/stack/context');
+const client_hooks_index = require('../../hooks/index.cjs');
+const constants = require('../../constants.cjs');
+const shared = require('../shared.cjs');
+
+function AffiliateApplyPage() {
+  const { identity } = context.useIdentity();
+  const [applied, setApplied] = react.useState(false);
+  const apply = client_hooks_index.useApplyAffiliate();
+  const action = shared.useAffiliateAction();
+  const { Link, resolve } = context.usePluginSiteNavigation(constants.AFFILIATE_PLUGIN_ID);
+  const { localization } = context.usePluginOverrides(constants.AFFILIATE_PLUGIN_ID);
+  const save = (event) => {
+    event.preventDefault();
+    const fields = new FormData(event.currentTarget);
+    void action.run(async () => {
+      await apply.mutateAsync(shared.readProfile(fields));
+      setApplied(true);
+    }, "Application submitted");
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    shared.AffiliatePage,
+    {
+      title: localization?.apply ?? "Become an affiliate",
+      description: "Apply for a referral code and earn commissions on attributed conversions after approval.",
+      admin: false,
+      children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "affiliate-application", children: [
+        /* @__PURE__ */ jsxRuntime.jsx(shared.ActionNotice, { ...action }),
+        applied ? /* @__PURE__ */ jsxRuntime.jsxs("section", { className: "affiliate-stack", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Your application is pending review" }),
+          /* @__PURE__ */ jsxRuntime.jsx("p", { children: "You can view your status and update your payout details in the affiliate portal." }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            Link,
+            {
+              className: "affiliate-primary",
+              href: resolve("affiliate/portal").href,
+              children: "Open affiliate portal"
+            }
+          )
+        ] }) : /* @__PURE__ */ jsxRuntime.jsx("form", { className: "affiliate-stack", onSubmit: save, children: /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { disabled: action.pending, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            shared.ProfileFields,
+            {
+              defaults: { name: identity?.name, email: identity?.email }
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx("button", { className: "affiliate-primary", type: "submit", children: action.pending ? "Submitting\u2026" : "Submit application" })
+        ] }) })
+      ] })
+    }
+  );
+}
+
+exports.AffiliateApplyPage = AffiliateApplyPage;

package/dist/client/components/pages/affiliate-apply-page.internal.mjs

@@ -0,0 +1,57 @@
+'use client';
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useState } from 'react';
+import { useIdentity, usePluginSiteNavigation, usePluginOverrides } from '@btst/stack/context';
+import { useApplyAffiliate } from '../../hooks/index.mjs';
+import { AFFILIATE_PLUGIN_ID } from '../../constants.mjs';
+import { useAffiliateAction, AffiliatePage, ActionNotice, ProfileFields, readProfile } from '../shared.mjs';
+
+function AffiliateApplyPage() {
+  const { identity } = useIdentity();
+  const [applied, setApplied] = useState(false);
+  const apply = useApplyAffiliate();
+  const action = useAffiliateAction();
+  const { Link, resolve } = usePluginSiteNavigation(AFFILIATE_PLUGIN_ID);
+  const { localization } = usePluginOverrides(AFFILIATE_PLUGIN_ID);
+  const save = (event) => {
+    event.preventDefault();
+    const fields = new FormData(event.currentTarget);
+    void action.run(async () => {
+      await apply.mutateAsync(readProfile(fields));
+      setApplied(true);
+    }, "Application submitted");
+  };
+  return /* @__PURE__ */ jsx(
+    AffiliatePage,
+    {
+      title: localization?.apply ?? "Become an affiliate",
+      description: "Apply for a referral code and earn commissions on attributed conversions after approval.",
+      admin: false,
+      children: /* @__PURE__ */ jsxs("div", { className: "affiliate-application", children: [
+        /* @__PURE__ */ jsx(ActionNotice, { ...action }),
+        applied ? /* @__PURE__ */ jsxs("section", { className: "affiliate-stack", children: [
+          /* @__PURE__ */ jsx("h2", { children: "Your application is pending review" }),
+          /* @__PURE__ */ jsx("p", { children: "You can view your status and update your payout details in the affiliate portal." }),
+          /* @__PURE__ */ jsx(
+            Link,
+            {
+              className: "affiliate-primary",
+              href: resolve("affiliate/portal").href,
+              children: "Open affiliate portal"
+            }
+          )
+        ] }) : /* @__PURE__ */ jsx("form", { className: "affiliate-stack", onSubmit: save, children: /* @__PURE__ */ jsxs("fieldset", { disabled: action.pending, children: [
+          /* @__PURE__ */ jsx(
+            ProfileFields,
+            {
+              defaults: { name: identity?.name, email: identity?.email }
+            }
+          ),
+          /* @__PURE__ */ jsx("button", { className: "affiliate-primary", type: "submit", children: action.pending ? "Submitting\u2026" : "Submit application" })
+        ] }) })
+      ] })
+    }
+  );
+}
+
+export { AffiliateApplyPage };

package/dist/client/components/pages/affiliate-detail-page.internal.cjs

@@ -0,0 +1,112 @@
+'use client';
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const context = require('@btst/stack/context');
+const permissions = require('../../../permissions.cjs');
+const client_hooks_index = require('../../hooks/index.cjs');
+const constants = require('../../constants.cjs');
+const shared = require('../shared.cjs');
+
+function AffiliateDetailPage({ id }) {
+  const { data } = client_hooks_index.useAffiliate(id);
+  const { affiliate, stats } = data;
+  const update = client_hooks_index.useUpdateAffiliate();
+  const remove = client_hooks_index.useDeleteAffiliate();
+  const action = shared.useAffiliateAction();
+  const { Link, resolve, navigate } = context.usePluginSiteNavigation(constants.AFFILIATE_PLUGIN_ID);
+  const facts = {
+    affiliateId: affiliate.id,
+    userId: affiliate.userId,
+    status: affiliate.status
+  };
+  const save = (event) => {
+    event.preventDefault();
+    const fields = new FormData(event.currentTarget);
+    const commissionType = String(fields.get("commissionType") ?? "");
+    const commissionValue = String(fields.get("commissionValue") ?? "");
+    void action.run(async () => {
+      if (commissionType && !commissionValue.trim())
+        throw new Error(
+          "Enter a commission value or select the program default."
+        );
+      await update.mutateAsync({
+        id,
+        data: {
+          ...shared.readProfile(fields),
+          status: String(fields.get("status")),
+          notes: String(fields.get("notes") ?? ""),
+          commissionType: commissionType ? commissionType : null,
+          commissionValue: commissionType ? Number(commissionValue) : null
+        }
+      });
+    }, "Affiliate profile saved");
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    shared.AffiliatePage,
+    {
+      title: affiliate.name,
+      description: affiliate.email,
+      action: /* @__PURE__ */ jsxRuntime.jsx(shared.Status, { value: affiliate.status }),
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(Link, { href: resolve("affiliate/admin/affiliates").href, children: "Back to affiliates" }),
+        /* @__PURE__ */ jsxRuntime.jsx(shared.Stats, { stats }),
+        /* @__PURE__ */ jsxRuntime.jsx(shared.ActionNotice, { ...action }),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          context.PermissionAccess,
+          {
+            permission: permissions.affiliatePermissions.affiliate.update(facts),
+            children: /* @__PURE__ */ jsxRuntime.jsxs(
+              "form",
+              {
+                className: "affiliate-stack",
+                onSubmit: save,
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Profile and commission rule" }),
+                  /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "affiliate-small affiliate-muted", children: [
+                    "Account: ",
+                    affiliate.userId
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsxs("fieldset", { disabled: action.pending, children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(shared.ProfileFields, { affiliate, admin: true }),
+                    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "affiliate-actions", children: /* @__PURE__ */ jsxRuntime.jsx("button", { className: "affiliate-primary", type: "submit", children: action.pending ? "Saving\u2026" : "Save profile" }) })
+                  ] })
+                ]
+              },
+              affiliate.updatedAt
+            )
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          context.PermissionAccess,
+          {
+            permission: permissions.affiliatePermissions.affiliate.delete(facts),
+            children: /* @__PURE__ */ jsxRuntime.jsxs("section", { className: "affiliate-section affiliate-stack", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Remove affiliate" }),
+              /* @__PURE__ */ jsxRuntime.jsx("p", { className: "affiliate-muted", children: "Only affiliates without conversions, commissions, or payouts can be deleted. Suspend a partner to stop new referrals and preserve their history." }),
+              /* @__PURE__ */ jsxRuntime.jsx("div", { children: /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  disabled: action.pending,
+                  onClick: () => {
+                    if (window.confirm(
+                      `Delete ${affiliate.name}? This removes their affiliate profile.`
+                    ))
+                      void action.run(async () => {
+                        await remove.mutateAsync(id);
+                        await navigate("affiliate/admin/affiliates");
+                      });
+                  },
+                  children: "Delete affiliate"
+                }
+              ) })
+            ] })
+          }
+        )
+      ]
+    }
+  );
+}
+
+exports.AffiliateDetailPage = AffiliateDetailPage;

package/dist/client/components/pages/affiliate-detail-page.internal.mjs

@@ -0,0 +1,110 @@
+'use client';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { usePluginSiteNavigation, PermissionAccess } from '@btst/stack/context';
+import { affiliatePermissions } from '../../../permissions.mjs';
+import { useAffiliate, useUpdateAffiliate, useDeleteAffiliate } from '../../hooks/index.mjs';
+import { AFFILIATE_PLUGIN_ID } from '../../constants.mjs';
+import { useAffiliateAction, AffiliatePage, Stats, ActionNotice, ProfileFields, Status, readProfile } from '../shared.mjs';
+
+function AffiliateDetailPage({ id }) {
+  const { data } = useAffiliate(id);
+  const { affiliate, stats } = data;
+  const update = useUpdateAffiliate();
+  const remove = useDeleteAffiliate();
+  const action = useAffiliateAction();
+  const { Link, resolve, navigate } = usePluginSiteNavigation(AFFILIATE_PLUGIN_ID);
+  const facts = {
+    affiliateId: affiliate.id,
+    userId: affiliate.userId,
+    status: affiliate.status
+  };
+  const save = (event) => {
+    event.preventDefault();
+    const fields = new FormData(event.currentTarget);
+    const commissionType = String(fields.get("commissionType") ?? "");
+    const commissionValue = String(fields.get("commissionValue") ?? "");
+    void action.run(async () => {
+      if (commissionType && !commissionValue.trim())
+        throw new Error(
+          "Enter a commission value or select the program default."
+        );
+      await update.mutateAsync({
+        id,
+        data: {
+          ...readProfile(fields),
+          status: String(fields.get("status")),
+          notes: String(fields.get("notes") ?? ""),
+          commissionType: commissionType ? commissionType : null,
+          commissionValue: commissionType ? Number(commissionValue) : null
+        }
+      });
+    }, "Affiliate profile saved");
+  };
+  return /* @__PURE__ */ jsxs(
+    AffiliatePage,
+    {
+      title: affiliate.name,
+      description: affiliate.email,
+      action: /* @__PURE__ */ jsx(Status, { value: affiliate.status }),
+      children: [
+        /* @__PURE__ */ jsx(Link, { href: resolve("affiliate/admin/affiliates").href, children: "Back to affiliates" }),
+        /* @__PURE__ */ jsx(Stats, { stats }),
+        /* @__PURE__ */ jsx(ActionNotice, { ...action }),
+        /* @__PURE__ */ jsx(
+          PermissionAccess,
+          {
+            permission: affiliatePermissions.affiliate.update(facts),
+            children: /* @__PURE__ */ jsxs(
+              "form",
+              {
+                className: "affiliate-stack",
+                onSubmit: save,
+                children: [
+                  /* @__PURE__ */ jsx("h2", { children: "Profile and commission rule" }),
+                  /* @__PURE__ */ jsxs("p", { className: "affiliate-small affiliate-muted", children: [
+                    "Account: ",
+                    affiliate.userId
+                  ] }),
+                  /* @__PURE__ */ jsxs("fieldset", { disabled: action.pending, children: [
+                    /* @__PURE__ */ jsx(ProfileFields, { affiliate, admin: true }),
+                    /* @__PURE__ */ jsx("div", { className: "affiliate-actions", children: /* @__PURE__ */ jsx("button", { className: "affiliate-primary", type: "submit", children: action.pending ? "Saving\u2026" : "Save profile" }) })
+                  ] })
+                ]
+              },
+              affiliate.updatedAt
+            )
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          PermissionAccess,
+          {
+            permission: affiliatePermissions.affiliate.delete(facts),
+            children: /* @__PURE__ */ jsxs("section", { className: "affiliate-section affiliate-stack", children: [
+              /* @__PURE__ */ jsx("h2", { children: "Remove affiliate" }),
+              /* @__PURE__ */ jsx("p", { className: "affiliate-muted", children: "Only affiliates without conversions, commissions, or payouts can be deleted. Suspend a partner to stop new referrals and preserve their history." }),
+              /* @__PURE__ */ jsx("div", { children: /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  disabled: action.pending,
+                  onClick: () => {
+                    if (window.confirm(
+                      `Delete ${affiliate.name}? This removes their affiliate profile.`
+                    ))
+                      void action.run(async () => {
+                        await remove.mutateAsync(id);
+                        await navigate("affiliate/admin/affiliates");
+                      });
+                  },
+                  children: "Delete affiliate"
+                }
+              ) })
+            ] })
+          }
+        )
+      ]
+    }
+  );
+}
+
+export { AffiliateDetailPage };