@btst/plugin-affiliate 1.0.0-beta.0 → 1.1.1-beta.0

package/dist/api/bridges.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+const attribution = require('../attribution.cjs');
+const schemas = require('../schemas.cjs');
+
+function createAffiliateConversionHooks(options) {
+  const capturePaymentAttribution = ({ request }) => {
+    if (!request) return void 0;
+    const parsed = schemas.createConversionSchema.shape.attribution.safeParse(
+      attribution.attributionFromRequest(request)
+    );
+    return parsed.success ? parsed.data : void 0;
+  };
+  async function paid(source, id, context) {
+    const payment = context?.payment;
+    if (!payment?.attribution) return;
+    await options.recordConversion({
+      externalRef: `${source}:${id}`,
+      amount: payment.amount,
+      currency: payment.currency,
+      attribution: payment.attribution
+    });
+  }
+  return {
+    ecommerce: {
+      capturePaymentAttribution,
+      async onAfterOrderPaid(order, context) {
+        if (order.paymentStatus !== "paid") return;
+        await paid("ecommerce", order.id, {
+          payment: {
+            amount: order.subtotal - order.discount,
+            currency: order.currency,
+            attribution: context.attribution
+          }
+        });
+      }
+    },
+    school: {
+      capturePaymentAttribution,
+      async onAfterEnroll(enrollment, _course, context) {
+        if (enrollment.status !== "enrolled" && enrollment.status !== "completed")
+          return;
+        await paid("school", enrollment.id, context);
+      }
+    },
+    calendar: {
+      capturePaymentAttribution,
+      async onAfterConfirmBooking(booking, context) {
+        if (booking.status !== "confirmed" || context?.reason === "rescheduled")
+          return;
+        await paid("calendar", booking.id, context);
+      }
+    }
+  };
+}
+
+exports.createAffiliateConversionHooks = createAffiliateConversionHooks;

package/dist/api/bridges.mjs

@@ -0,0 +1,55 @@
+import { attributionFromRequest } from '../attribution.mjs';
+import { createConversionSchema } from '../schemas.mjs';
+
+function createAffiliateConversionHooks(options) {
+  const capturePaymentAttribution = ({ request }) => {
+    if (!request) return void 0;
+    const parsed = createConversionSchema.shape.attribution.safeParse(
+      attributionFromRequest(request)
+    );
+    return parsed.success ? parsed.data : void 0;
+  };
+  async function paid(source, id, context) {
+    const payment = context?.payment;
+    if (!payment?.attribution) return;
+    await options.recordConversion({
+      externalRef: `${source}:${id}`,
+      amount: payment.amount,
+      currency: payment.currency,
+      attribution: payment.attribution
+    });
+  }
+  return {
+    ecommerce: {
+      capturePaymentAttribution,
+      async onAfterOrderPaid(order, context) {
+        if (order.paymentStatus !== "paid") return;
+        await paid("ecommerce", order.id, {
+          payment: {
+            amount: order.subtotal - order.discount,
+            currency: order.currency,
+            attribution: context.attribution
+          }
+        });
+      }
+    },
+    school: {
+      capturePaymentAttribution,
+      async onAfterEnroll(enrollment, _course, context) {
+        if (enrollment.status !== "enrolled" && enrollment.status !== "completed")
+          return;
+        await paid("school", enrollment.id, context);
+      }
+    },
+    calendar: {
+      capturePaymentAttribution,
+      async onAfterConfirmBooking(booking, context) {
+        if (booking.status !== "confirmed" || context?.reason === "rescheduled")
+          return;
+        await paid("calendar", booking.id, context);
+      }
+    }
+  };
+}
+
+export { createAffiliateConversionHooks };

package/dist/api/index.cjs

@@ -7,6 +7,7 @@ const getters = require('./getters.cjs');
 const mutations = require('./mutations.cjs');
 const attribution = require('../attribution.cjs');
 const commission = require('../commission.cjs');
+const bridges = require('./bridges.cjs');
 
 
 
@@ -47,3 +48,4 @@ exports.referralCodeFromURL = attribution.referralCodeFromURL;
 exports.safeLandingPath = attribution.safeLandingPath;
 exports.selectAttributionClick = attribution.selectAttributionClick;
 exports.calculateCommission = commission.calculateCommission;
+exports.createAffiliateConversionHooks = bridges.createAffiliateConversionHooks;

package/dist/api/index.d.cts

@@ -971,5 +971,72 @@ declare function updatePayout(adapter: DBAdapter, id: string, input: {
 /** Amounts are integer minor units; percentage values may have up to two decimals. */
 declare function calculateCommission(amount: number, type: CommissionType, value: number): number;
 
-export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
-export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };
+/** Application-owned conversion operation; source plugins remain independently installable. */
+interface AffiliateConversionBridgeOptions {
+    /** Call the configured stack's trusted.affiliate.createConversion operation. Errors propagate for payment webhook retry. */
+    recordConversion: (input: CreateConversionInput) => Promise<unknown>;
+}
+type Attribution = {
+    readonly code?: string;
+    readonly clickId?: string;
+};
+type PaymentContext = {
+    readonly payment?: {
+        readonly amount: number;
+        readonly currency: string;
+        readonly attribution?: Attribution;
+    };
+};
+/**
+ * Capture browser attribution before checkout and record only verified paid
+ * conversions using the stored snapshot. External references are namespaced by
+ * source entity; the Affiliate operation deduplicates retries and commissions.
+ */
+declare function createAffiliateConversionHooks(options: AffiliateConversionBridgeOptions): {
+    ecommerce: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterOrderPaid(order: {
+            readonly id: string;
+            readonly paymentStatus: string;
+            readonly subtotal: number;
+            readonly discount: number;
+            readonly currency: string;
+        }, context: {
+            readonly attribution?: Attribution;
+        }): Promise<void>;
+    };
+    school: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterEnroll(enrollment: {
+            readonly id: string;
+            readonly status: string;
+        }, _course: unknown, context?: PaymentContext): Promise<void>;
+    };
+    calendar: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterConfirmBooking(booking: {
+            readonly id: string;
+            readonly status: string;
+        }, context?: PaymentContext & {
+            readonly reason?: "rescheduled";
+        }): Promise<void>;
+    };
+};
+
+export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createAffiliateConversionHooks, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
+export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateConversionBridgeOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };

package/dist/api/index.d.mts

@@ -971,5 +971,72 @@ declare function updatePayout(adapter: DBAdapter, id: string, input: {
 /** Amounts are integer minor units; percentage values may have up to two decimals. */
 declare function calculateCommission(amount: number, type: CommissionType, value: number): number;
 
-export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
-export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };
+/** Application-owned conversion operation; source plugins remain independently installable. */
+interface AffiliateConversionBridgeOptions {
+    /** Call the configured stack's trusted.affiliate.createConversion operation. Errors propagate for payment webhook retry. */
+    recordConversion: (input: CreateConversionInput) => Promise<unknown>;
+}
+type Attribution = {
+    readonly code?: string;
+    readonly clickId?: string;
+};
+type PaymentContext = {
+    readonly payment?: {
+        readonly amount: number;
+        readonly currency: string;
+        readonly attribution?: Attribution;
+    };
+};
+/**
+ * Capture browser attribution before checkout and record only verified paid
+ * conversions using the stored snapshot. External references are namespaced by
+ * source entity; the Affiliate operation deduplicates retries and commissions.
+ */
+declare function createAffiliateConversionHooks(options: AffiliateConversionBridgeOptions): {
+    ecommerce: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterOrderPaid(order: {
+            readonly id: string;
+            readonly paymentStatus: string;
+            readonly subtotal: number;
+            readonly discount: number;
+            readonly currency: string;
+        }, context: {
+            readonly attribution?: Attribution;
+        }): Promise<void>;
+    };
+    school: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterEnroll(enrollment: {
+            readonly id: string;
+            readonly status: string;
+        }, _course: unknown, context?: PaymentContext): Promise<void>;
+    };
+    calendar: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterConfirmBooking(booking: {
+            readonly id: string;
+            readonly status: string;
+        }, context?: PaymentContext & {
+            readonly reason?: "rescheduled";
+        }): Promise<void>;
+    };
+};
+
+export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createAffiliateConversionHooks, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
+export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateConversionBridgeOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };

package/dist/api/index.d.ts

@@ -971,5 +971,72 @@ declare function updatePayout(adapter: DBAdapter, id: string, input: {
 /** Amounts are integer minor units; percentage values may have up to two decimals. */
 declare function calculateCommission(amount: number, type: CommissionType, value: number): number;
 
-export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
-export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };
+/** Application-owned conversion operation; source plugins remain independently installable. */
+interface AffiliateConversionBridgeOptions {
+    /** Call the configured stack's trusted.affiliate.createConversion operation. Errors propagate for payment webhook retry. */
+    recordConversion: (input: CreateConversionInput) => Promise<unknown>;
+}
+type Attribution = {
+    readonly code?: string;
+    readonly clickId?: string;
+};
+type PaymentContext = {
+    readonly payment?: {
+        readonly amount: number;
+        readonly currency: string;
+        readonly attribution?: Attribution;
+    };
+};
+/**
+ * Capture browser attribution before checkout and record only verified paid
+ * conversions using the stored snapshot. External references are namespaced by
+ * source entity; the Affiliate operation deduplicates retries and commissions.
+ */
+declare function createAffiliateConversionHooks(options: AffiliateConversionBridgeOptions): {
+    ecommerce: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterOrderPaid(order: {
+            readonly id: string;
+            readonly paymentStatus: string;
+            readonly subtotal: number;
+            readonly discount: number;
+            readonly currency: string;
+        }, context: {
+            readonly attribution?: Attribution;
+        }): Promise<void>;
+    };
+    school: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterEnroll(enrollment: {
+            readonly id: string;
+            readonly status: string;
+        }, _course: unknown, context?: PaymentContext): Promise<void>;
+    };
+    calendar: {
+        capturePaymentAttribution: ({ request }: {
+            request?: Request;
+        }) => {
+            code?: string | undefined;
+            clickId?: string | undefined;
+        } | undefined;
+        onAfterConfirmBooking(booking: {
+            readonly id: string;
+            readonly status: string;
+        }, context?: PaymentContext & {
+            readonly reason?: "rescheduled";
+        }): Promise<void>;
+    };
+};
+
+export { Affiliate, AffiliateOptions, AffiliatePortal, AffiliateStats, AffiliateStatus, Commission, CommissionStatus, CommissionType, Conversion, CreateAffiliateInput, CreateConversionInput, CreatePayoutInput, ListParams, ListResult, MarketingAsset, Payout, PayoutStatus, ReferralClick, TrackClickInput, UpdateAffiliateInput, affiliateBackendPlugin, affiliateSchema, allRows, calculateCommission, createAffiliate, createAffiliateConversionHooks, createConversion, createPayout, deleteAffiliate, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateByUserId, getAffiliateStats, getCommission, getConversionByExternalRef, getPayout, getPortal, getReferralClick, listAffiliates, listCommissions, listPayouts, serializeAffiliateRecord, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction };
+export type { AffiliateApiRouter, AffiliateBackendOptions, AffiliateConversionBridgeOptions, AffiliateDataAdapter, AffiliateHookContext, AffiliatePluginHooks };

package/dist/api/index.mjs

@@ -5,3 +5,4 @@ export { allRows, exportPayouts, getAffiliate, getAffiliateByCode, getAffiliateB
 export { createAffiliate, createConversion, createPayout, deleteAffiliate, trackClick, updateAffiliate, updateCommission, updatePayout, withAffiliateTransaction } from './mutations.mjs';
 export { AFFILIATE_COOKIE_NAME, attributionFromRequest, createReferralLink, createTrackingLink, getReferralRedirect, isClickWithinWindow, referralCodeFromURL, safeLandingPath, selectAttributionClick } from '../attribution.mjs';
 export { calculateCommission } from '../commission.mjs';
+export { createAffiliateConversionHooks } from './bridges.mjs';

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

@@ -50,7 +50,7 @@ function AffiliateDetailPage({ id }) {
       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.Stats, { page: "affiliateDetail", stats }),
         /* @__PURE__ */ jsxRuntime.jsx(shared.ActionNotice, { ...action }),
         /* @__PURE__ */ jsxRuntime.jsx(
           context.PermissionAccess,

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

@@ -48,7 +48,7 @@ function AffiliateDetailPage({ id }) {
       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(Stats, { page: "affiliateDetail", stats }),
         /* @__PURE__ */ jsx(ActionNotice, { ...action }),
         /* @__PURE__ */ jsx(
           PermissionAccess,

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

@@ -67,7 +67,7 @@ function AffiliatePortalPage() {
       children: [
         /* @__PURE__ */ jsxRuntime.jsx(shared.ActionNotice, { ...action }),
         affiliate.status !== "approved" && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "affiliate-notice", children: affiliate.status === "pending" ? "Your application is pending review. Referral tracking starts after approval." : "Your affiliate account is suspended. New referrals are not attributed. Contact the program administrator for help." }),
-        /* @__PURE__ */ jsxRuntime.jsx(shared.Stats, { stats }),
+        /* @__PURE__ */ jsxRuntime.jsx(shared.Stats, { page: "portal", stats }),
         /* @__PURE__ */ jsxRuntime.jsxs("section", { className: "affiliate-section affiliate-stack", children: [
           /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Your referral link" }),
           /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "affiliate-muted", children: [

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

@@ -65,7 +65,7 @@ function AffiliatePortalPage() {
       children: [
         /* @__PURE__ */ jsx(ActionNotice, { ...action }),
         affiliate.status !== "approved" && /* @__PURE__ */ jsx("p", { className: "affiliate-notice", children: affiliate.status === "pending" ? "Your application is pending review. Referral tracking starts after approval." : "Your affiliate account is suspended. New referrals are not attributed. Contact the program administrator for help." }),
-        /* @__PURE__ */ jsx(Stats, { stats }),
+        /* @__PURE__ */ jsx(Stats, { page: "portal", stats }),
         /* @__PURE__ */ jsxs("section", { className: "affiliate-section affiliate-stack", children: [
           /* @__PURE__ */ jsx("h2", { children: "Your referral link" }),
           /* @__PURE__ */ jsxs("p", { className: "affiliate-muted", children: [

package/dist/client/components/pages/affiliates-page.internal.cjs

@@ -3,6 +3,7 @@
 
 const jsxRuntime = require('react/jsx-runtime');
 const react = require('react');
+const pageContext = require('@btst/stack/page-context');
 const context = require('@btst/stack/context');
 const permissions = require('../../../permissions.cjs');
 const client_hooks_index = require('../../hooks/index.cjs');
@@ -23,6 +24,16 @@ function AffiliatesPage() {
   const action = shared.useAffiliateAction();
   const { Link, resolve } = context.usePluginSiteNavigation(constants.AFFILIATE_PLUGIN_ID);
   const { localization } = context.usePluginOverrides(constants.AFFILIATE_PLUGIN_ID);
+  pageContext.useRegisterPageAIContext({
+    routeName: "affiliate-admin",
+    pageDescription: JSON.stringify({
+      page: "Read-only Affiliate administration summary. No mutation tools are available.",
+      statusFilter: status || "all",
+      offset,
+      totalAffiliates: data.total,
+      visibleAffiliates: data.items.length
+    })
+  });
   const save = (event) => {
     event.preventDefault();
     const fields = new FormData(event.currentTarget);

package/dist/client/components/pages/affiliates-page.internal.mjs

@@ -1,6 +1,7 @@
 'use client';
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { useState } from 'react';
+import { useRegisterPageAIContext } from '@btst/stack/page-context';
 import { usePluginSiteNavigation, usePluginOverrides, PermissionAccess } from '@btst/stack/context';
 import { affiliatePermissions } from '../../../permissions.mjs';
 import { useAffiliates, useCreateAffiliate, useUpdateAffiliate } from '../../hooks/index.mjs';
@@ -21,6 +22,16 @@ function AffiliatesPage() {
   const action = useAffiliateAction();
   const { Link, resolve } = usePluginSiteNavigation(AFFILIATE_PLUGIN_ID);
   const { localization } = usePluginOverrides(AFFILIATE_PLUGIN_ID);
+  useRegisterPageAIContext({
+    routeName: "affiliate-admin",
+    pageDescription: JSON.stringify({
+      page: "Read-only Affiliate administration summary. No mutation tools are available.",
+      statusFilter: status || "all",
+      offset,
+      totalAffiliates: data.total,
+      visibleAffiliates: data.items.length
+    })
+  });
   const save = (event) => {
     event.preventDefault();
     const fields = new FormData(event.currentTarget);

package/dist/client/components/shared.cjs

@@ -224,7 +224,21 @@ function date(value) {
     day: "numeric"
   });
 }
-function Stats({ stats }) {
+function Stats({
+  page,
+  stats
+}) {
+  return page ? /* @__PURE__ */ jsxRuntime.jsx(PageStats, { page, stats }) : /* @__PURE__ */ jsxRuntime.jsx(DefaultStats, { stats });
+}
+function PageStats({
+  page,
+  stats
+}) {
+  const { pageOverrides } = context.usePluginOverrides(constants.AFFILIATE_PLUGIN_ID);
+  const Component = (page ? pageOverrides?.[page]?.Stats : void 0) ?? DefaultStats;
+  return /* @__PURE__ */ jsxRuntime.jsx(Component, { stats });
+}
+function DefaultStats({ stats }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "section",
     {

package/dist/client/components/shared.mjs

@@ -222,7 +222,21 @@ function date(value) {
     day: "numeric"
   });
 }
-function Stats({ stats }) {
+function Stats({
+  page,
+  stats
+}) {
+  return page ? /* @__PURE__ */ jsx(PageStats, { page, stats }) : /* @__PURE__ */ jsx(DefaultStats, { stats });
+}
+function PageStats({
+  page,
+  stats
+}) {
+  const { pageOverrides } = usePluginOverrides(AFFILIATE_PLUGIN_ID);
+  const Component = (page ? pageOverrides?.[page]?.Stats : void 0) ?? DefaultStats;
+  return /* @__PURE__ */ jsx(Component, { stats });
+}
+function DefaultStats({ stats }) {
   return /* @__PURE__ */ jsxs(
     "section",
     {

package/dist/client/index.d.cts

@@ -2,10 +2,17 @@ import * as _btst_stack_client from '@btst/stack/client';
 import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
+import { AffiliateStats } from '../types.cjs';
 import { AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent, AffiliateApplyPageComponent, AffiliatePortalPageComponent } from './components/index.cjs';
 
 /** Affiliate-specific page labels; shared services come from StackProvider. */
 interface AffiliatePluginOverrides {
+    /** Earnings and referral summary presentation, independently for admin and affiliate pages. */
+    pageOverrides?: Partial<Record<"affiliateDetail" | "portal", {
+        Stats?: ComponentType<{
+            stats: AffiliateStats;
+        }>;
+    }>>;
     localization?: Partial<{
         affiliates: string;
         commissions: string;

package/dist/client/index.d.mts

@@ -2,10 +2,17 @@ import * as _btst_stack_client from '@btst/stack/client';
 import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
+import { AffiliateStats } from '../types.mjs';
 import { AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent, AffiliateApplyPageComponent, AffiliatePortalPageComponent } from './components/index.mjs';
 
 /** Affiliate-specific page labels; shared services come from StackProvider. */
 interface AffiliatePluginOverrides {
+    /** Earnings and referral summary presentation, independently for admin and affiliate pages. */
+    pageOverrides?: Partial<Record<"affiliateDetail" | "portal", {
+        Stats?: ComponentType<{
+            stats: AffiliateStats;
+        }>;
+    }>>;
     localization?: Partial<{
         affiliates: string;
         commissions: string;

package/dist/client/index.d.ts

@@ -2,10 +2,17 @@ import * as _btst_stack_client from '@btst/stack/client';
 import * as _btst_yar from '@btst/yar';
 import * as react from 'react';
 import { ComponentType } from 'react';
+import { AffiliateStats } from '../types.js';
 import { AffiliatesPageComponent, CommissionsPageComponent, PayoutsPageComponent, AffiliateApplyPageComponent, AffiliatePortalPageComponent } from './components/index.js';
 
 /** Affiliate-specific page labels; shared services come from StackProvider. */
 interface AffiliatePluginOverrides {
+    /** Earnings and referral summary presentation, independently for admin and affiliate pages. */
+    pageOverrides?: Partial<Record<"affiliateDetail" | "portal", {
+        Stats?: ComponentType<{
+            stats: AffiliateStats;
+        }>;
+    }>>;
     localization?: Partial<{
         affiliates: string;
         commissions: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/plugin-affiliate",
-  "version": "1.0.0-beta.0",
+  "version": "1.1.1-beta.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -134,7 +134,7 @@
     "zod": "^4.2.1"
   },
   "peerDependencies": {
-    "@btst/stack": ">=6.0.0-beta.0 <7.0.0",
+    "@btst/stack": ">=6.2.0-beta.0 <6.2.0",
     "@btst/yar": ">=1.3.2",
     "@tanstack/react-query": "^5.0.0",
     "react": ">=19.2.6",
@@ -151,12 +151,12 @@
     "unbuild": "3.6.1",
     "vitest": "^4.1.12",
     "@btst/adapter-memory": "3.0.1",
-    "@btst/stack": "6.0.0-beta.0"
+    "@btst/stack": "6.2.0-beta.0"
   },
-  "gitHead": "ac7a6206d81e36262baf4392255575b4dc9bf6b5",
+  "gitHead": "a4bbf36fd6f07909353ea84aa22de491bbefc260",
   "scripts": {
     "build": "unbuild --clean",
-    "typecheck": "tsc --project tsconfig.json",
+    "typecheck": "tsc --project tsconfig.json && tsc --project tsconfig.typecheck.json",
     "test": "vitest run"
   }
 }