@btst/plugin-affiliate 0.0.0-stage → 1.0.0

package/dist/client/components/shared.mjs

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

package/dist/client/constants.cjs

@@ -0,0 +1,5 @@
+'use strict';
+
+const AFFILIATE_PLUGIN_ID = "affiliate";
+
+exports.AFFILIATE_PLUGIN_ID = AFFILIATE_PLUGIN_ID;

package/dist/client/constants.mjs

@@ -0,0 +1,3 @@
+const AFFILIATE_PLUGIN_ID = "affiliate";
+
+export { AFFILIATE_PLUGIN_ID };

package/dist/client/hooks/index.cjs

@@ -0,0 +1,77 @@
+'use client';
+'use strict';
+
+const context = require('@btst/stack/context');
+const hooks = require('@btst/stack/plugins/client/hooks');
+const queryKeys = require('../../query-keys.cjs');
+const attribution = require('../../attribution.cjs');
+const constants = require('../constants.cjs');
+
+const affiliate = hooks.createResource({
+  plugin: constants.AFFILIATE_PLUGIN_ID,
+  resources: queryKeys.affiliateResources
+});
+function useAffiliatePartition() {
+  const { identity, isPending, error } = context.useIdentity();
+  const generation = context.useIdentitySourceGeneration();
+  const { plugins } = context.useStack();
+  const api = plugins?.[constants.AFFILIATE_PLUGIN_ID]?.api;
+  return {
+    identity,
+    generation,
+    isPending,
+    error: !!error,
+    endpoint: [api?.baseURL, api?.basePath],
+    headers: [...new Headers(api?.browserHeaders)],
+    credentials: api?.credentials
+  };
+}
+const useAffiliates = (params = {}) => affiliate.affiliates.list.useSuspense([params, useAffiliatePartition()]);
+const useAffiliate = (id) => affiliate.affiliates.detail.useSuspense([id, useAffiliatePartition()]);
+const useAffiliateDashboard = () => affiliate.affiliatePortal.detail.useSuspense([useAffiliatePartition()]);
+const useCommissions = (params = {}) => affiliate.affiliateCommissions.list.useSuspense([
+  params,
+  useAffiliatePartition()
+]);
+const usePayouts = (params = {}) => affiliate.affiliatePayouts.list.useSuspense([
+  params,
+  useAffiliatePartition()
+]);
+const usePayoutExport = (params = {}) => affiliate.affiliatePayouts.export.use([params, useAffiliatePartition()], {
+  enabled: false
+});
+const useCreateAffiliate = () => affiliate.affiliates.create.use();
+const useUpdateAffiliate = () => affiliate.affiliates.update.use();
+const useDeleteAffiliate = () => affiliate.affiliates.delete.use();
+const useApplyAffiliate = () => affiliate.affiliatePortal.apply.use();
+const useUpdateAffiliateProfile = () => affiliate.affiliatePortal.update.use();
+const useUpdateCommission = () => affiliate.affiliateCommissions.update.use();
+const useCreatePayout = () => affiliate.affiliatePayouts.create.use();
+const useUpdatePayout = () => affiliate.affiliatePayouts.update.use();
+function useReferralLink() {
+  const { plugins } = context.useStack();
+  const api = plugins?.[constants.AFFILIATE_PLUGIN_ID]?.api;
+  return (code, landingPath = "/") => {
+    const apiBaseURL = new URL(
+      api?.basePath ?? "/api/data",
+      api?.baseURL || window.location.origin
+    );
+    return attribution.createTrackingLink(apiBaseURL.href, code, landingPath);
+  };
+}
+
+exports.useAffiliate = useAffiliate;
+exports.useAffiliateDashboard = useAffiliateDashboard;
+exports.useAffiliates = useAffiliates;
+exports.useApplyAffiliate = useApplyAffiliate;
+exports.useCommissions = useCommissions;
+exports.useCreateAffiliate = useCreateAffiliate;
+exports.useCreatePayout = useCreatePayout;
+exports.useDeleteAffiliate = useDeleteAffiliate;
+exports.usePayoutExport = usePayoutExport;
+exports.usePayouts = usePayouts;
+exports.useReferralLink = useReferralLink;
+exports.useUpdateAffiliate = useUpdateAffiliate;
+exports.useUpdateAffiliateProfile = useUpdateAffiliateProfile;
+exports.useUpdateCommission = useUpdateCommission;
+exports.useUpdatePayout = useUpdatePayout;

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

@@ -0,0 +1,39 @@
+'use client';
+import { AffiliateApplicationInput, AffiliatePortalInput } from '../../query-keys.cjs';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { Affiliate, AffiliateStats, AffiliatePortal, ListParams, ListResult, Commission, CreateAffiliateInput, Payout, CreatePayoutInput, UpdateAffiliateInput } from '../../types.cjs';
+import '@btst/stack/plugins/client';
+
+declare const useAffiliates: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Affiliate>, Error>;
+declare const useAffiliate: (id: string) => _tanstack_react_query.UseSuspenseQueryResult<{
+    affiliate: Affiliate;
+    stats: AffiliateStats;
+}, Error>;
+declare const useAffiliateDashboard: () => _tanstack_react_query.UseSuspenseQueryResult<AffiliatePortal, Error>;
+declare const useCommissions: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Commission>, Error>;
+declare const usePayouts: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Payout>, Error>;
+declare const usePayoutExport: (params?: ListParams) => _tanstack_react_query.UseQueryResult<{
+    csv: string;
+}, Error>;
+declare const useCreateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, CreateAffiliateInput>;
+declare const useUpdateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, {
+    id: string;
+    data: UpdateAffiliateInput;
+}>;
+declare const useDeleteAffiliate: () => _tanstack_react_query.UseMutationResult<unknown, Error, string>;
+declare const useApplyAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliateApplicationInput>;
+declare const useUpdateAffiliateProfile: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliatePortalInput>;
+declare const useUpdateCommission: () => _tanstack_react_query.UseMutationResult<Commission, Error, {
+    id: string;
+    status: "approved" | "voided";
+}>;
+declare const useCreatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, CreatePayoutInput>;
+declare const useUpdatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, {
+    id: string;
+    status: "sent" | "failed";
+    reference?: string;
+}>;
+/** Build a cookie-setting tracking link using the affiliate plugin's resolved API. */
+declare function useReferralLink(): (code: string, landingPath?: string) => string;
+
+export { useAffiliate, useAffiliateDashboard, useAffiliates, useApplyAffiliate, useCommissions, useCreateAffiliate, useCreatePayout, useDeleteAffiliate, usePayoutExport, usePayouts, useReferralLink, useUpdateAffiliate, useUpdateAffiliateProfile, useUpdateCommission, useUpdatePayout };

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

@@ -0,0 +1,39 @@
+'use client';
+import { AffiliateApplicationInput, AffiliatePortalInput } from '../../query-keys.mjs';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { Affiliate, AffiliateStats, AffiliatePortal, ListParams, ListResult, Commission, CreateAffiliateInput, Payout, CreatePayoutInput, UpdateAffiliateInput } from '../../types.mjs';
+import '@btst/stack/plugins/client';
+
+declare const useAffiliates: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Affiliate>, Error>;
+declare const useAffiliate: (id: string) => _tanstack_react_query.UseSuspenseQueryResult<{
+    affiliate: Affiliate;
+    stats: AffiliateStats;
+}, Error>;
+declare const useAffiliateDashboard: () => _tanstack_react_query.UseSuspenseQueryResult<AffiliatePortal, Error>;
+declare const useCommissions: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Commission>, Error>;
+declare const usePayouts: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Payout>, Error>;
+declare const usePayoutExport: (params?: ListParams) => _tanstack_react_query.UseQueryResult<{
+    csv: string;
+}, Error>;
+declare const useCreateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, CreateAffiliateInput>;
+declare const useUpdateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, {
+    id: string;
+    data: UpdateAffiliateInput;
+}>;
+declare const useDeleteAffiliate: () => _tanstack_react_query.UseMutationResult<unknown, Error, string>;
+declare const useApplyAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliateApplicationInput>;
+declare const useUpdateAffiliateProfile: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliatePortalInput>;
+declare const useUpdateCommission: () => _tanstack_react_query.UseMutationResult<Commission, Error, {
+    id: string;
+    status: "approved" | "voided";
+}>;
+declare const useCreatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, CreatePayoutInput>;
+declare const useUpdatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, {
+    id: string;
+    status: "sent" | "failed";
+    reference?: string;
+}>;
+/** Build a cookie-setting tracking link using the affiliate plugin's resolved API. */
+declare function useReferralLink(): (code: string, landingPath?: string) => string;
+
+export { useAffiliate, useAffiliateDashboard, useAffiliates, useApplyAffiliate, useCommissions, useCreateAffiliate, useCreatePayout, useDeleteAffiliate, usePayoutExport, usePayouts, useReferralLink, useUpdateAffiliate, useUpdateAffiliateProfile, useUpdateCommission, useUpdatePayout };

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

@@ -0,0 +1,39 @@
+'use client';
+import { AffiliateApplicationInput, AffiliatePortalInput } from '../../query-keys.js';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { Affiliate, AffiliateStats, AffiliatePortal, ListParams, ListResult, Commission, CreateAffiliateInput, Payout, CreatePayoutInput, UpdateAffiliateInput } from '../../types.js';
+import '@btst/stack/plugins/client';
+
+declare const useAffiliates: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Affiliate>, Error>;
+declare const useAffiliate: (id: string) => _tanstack_react_query.UseSuspenseQueryResult<{
+    affiliate: Affiliate;
+    stats: AffiliateStats;
+}, Error>;
+declare const useAffiliateDashboard: () => _tanstack_react_query.UseSuspenseQueryResult<AffiliatePortal, Error>;
+declare const useCommissions: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Commission>, Error>;
+declare const usePayouts: (params?: ListParams) => _tanstack_react_query.UseSuspenseQueryResult<ListResult<Payout>, Error>;
+declare const usePayoutExport: (params?: ListParams) => _tanstack_react_query.UseQueryResult<{
+    csv: string;
+}, Error>;
+declare const useCreateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, CreateAffiliateInput>;
+declare const useUpdateAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, {
+    id: string;
+    data: UpdateAffiliateInput;
+}>;
+declare const useDeleteAffiliate: () => _tanstack_react_query.UseMutationResult<unknown, Error, string>;
+declare const useApplyAffiliate: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliateApplicationInput>;
+declare const useUpdateAffiliateProfile: () => _tanstack_react_query.UseMutationResult<Affiliate, Error, AffiliatePortalInput>;
+declare const useUpdateCommission: () => _tanstack_react_query.UseMutationResult<Commission, Error, {
+    id: string;
+    status: "approved" | "voided";
+}>;
+declare const useCreatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, CreatePayoutInput>;
+declare const useUpdatePayout: () => _tanstack_react_query.UseMutationResult<Payout, Error, {
+    id: string;
+    status: "sent" | "failed";
+    reference?: string;
+}>;
+/** Build a cookie-setting tracking link using the affiliate plugin's resolved API. */
+declare function useReferralLink(): (code: string, landingPath?: string) => string;
+
+export { useAffiliate, useAffiliateDashboard, useAffiliates, useApplyAffiliate, useCommissions, useCreateAffiliate, useCreatePayout, useDeleteAffiliate, usePayoutExport, usePayouts, useReferralLink, useUpdateAffiliate, useUpdateAffiliateProfile, useUpdateCommission, useUpdatePayout };

package/dist/client/hooks/index.mjs

@@ -0,0 +1,61 @@
+'use client';
+import { useStack, useIdentity, useIdentitySourceGeneration } from '@btst/stack/context';
+import { createResource } from '@btst/stack/plugins/client/hooks';
+import { affiliateResources } from '../../query-keys.mjs';
+import { createTrackingLink } from '../../attribution.mjs';
+import { AFFILIATE_PLUGIN_ID } from '../constants.mjs';
+
+const affiliate = createResource({
+  plugin: AFFILIATE_PLUGIN_ID,
+  resources: affiliateResources
+});
+function useAffiliatePartition() {
+  const { identity, isPending, error } = useIdentity();
+  const generation = useIdentitySourceGeneration();
+  const { plugins } = useStack();
+  const api = plugins?.[AFFILIATE_PLUGIN_ID]?.api;
+  return {
+    identity,
+    generation,
+    isPending,
+    error: !!error,
+    endpoint: [api?.baseURL, api?.basePath],
+    headers: [...new Headers(api?.browserHeaders)],
+    credentials: api?.credentials
+  };
+}
+const useAffiliates = (params = {}) => affiliate.affiliates.list.useSuspense([params, useAffiliatePartition()]);
+const useAffiliate = (id) => affiliate.affiliates.detail.useSuspense([id, useAffiliatePartition()]);
+const useAffiliateDashboard = () => affiliate.affiliatePortal.detail.useSuspense([useAffiliatePartition()]);
+const useCommissions = (params = {}) => affiliate.affiliateCommissions.list.useSuspense([
+  params,
+  useAffiliatePartition()
+]);
+const usePayouts = (params = {}) => affiliate.affiliatePayouts.list.useSuspense([
+  params,
+  useAffiliatePartition()
+]);
+const usePayoutExport = (params = {}) => affiliate.affiliatePayouts.export.use([params, useAffiliatePartition()], {
+  enabled: false
+});
+const useCreateAffiliate = () => affiliate.affiliates.create.use();
+const useUpdateAffiliate = () => affiliate.affiliates.update.use();
+const useDeleteAffiliate = () => affiliate.affiliates.delete.use();
+const useApplyAffiliate = () => affiliate.affiliatePortal.apply.use();
+const useUpdateAffiliateProfile = () => affiliate.affiliatePortal.update.use();
+const useUpdateCommission = () => affiliate.affiliateCommissions.update.use();
+const useCreatePayout = () => affiliate.affiliatePayouts.create.use();
+const useUpdatePayout = () => affiliate.affiliatePayouts.update.use();
+function useReferralLink() {
+  const { plugins } = useStack();
+  const api = plugins?.[AFFILIATE_PLUGIN_ID]?.api;
+  return (code, landingPath = "/") => {
+    const apiBaseURL = new URL(
+      api?.basePath ?? "/api/data",
+      api?.baseURL || window.location.origin
+    );
+    return createTrackingLink(apiBaseURL.href, code, landingPath);
+  };
+}
+
+export { useAffiliate, useAffiliateDashboard, useAffiliates, useApplyAffiliate, useCommissions, useCreateAffiliate, useCreatePayout, useDeleteAffiliate, usePayoutExport, usePayouts, useReferralLink, useUpdateAffiliate, useUpdateAffiliateProfile, useUpdateCommission, useUpdatePayout };

package/dist/client/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+const plugin = require('./plugin.cjs');
+
+
+
+exports.affiliateClientPlugin = plugin.affiliateClientPlugin;