keystone-design-bootstrap 1.0.57 → 1.0.59

package/src/next/routes/consumer-auth.ts

@@ -160,16 +160,14 @@ async function handleLogout(_request: Request, NR: NextResponseLike): Promise<Re
 /**
  * Creates a single POST handler that routes to the correct auth action based on
  * the dynamic `[action]` path segment.
- *
- * Compatible with Next.js 14 (sync params) and 15 (async params).
  */
 export function createConsumerAuthHandlers({ NextResponse }: { NextResponse: NextResponseLike }) {
   return {
     POST: async (
       request: Request,
-      context: { params: Promise<{ action: string }> | { action: string } }
+      context: { params: Promise<{ action: string }> }
     ): Promise<Response> => {
-      const { action } = await Promise.resolve(context.params);
+      const { action } = await context.params;
       if (action === 'initiate') return handleInitiate(request, NextResponse);
       if (action === 'login') return handleLogin(request, NextResponse);
       if (action === 'signup') return handleSignup(request, NextResponse);

package/src/tracking/MetaPixelTracker.tsx

@@ -2,14 +2,20 @@
 
 import { useEffect } from 'react';
 import { usePathname } from 'next/navigation';
-import { trackViewContent } from './trackViewContent';
-import { trackInitiateCheckout } from './trackInitiateCheckout';
+import { firePixelEvent } from './firePixelEvent';
 
 type RouteRule = {
   pattern: RegExp;
   getParams: (match: RegExpMatchArray) => { contentName: string; contentCategory: string };
 };
 
+function slugToTitle(slug: string): string {
+  return slug
+    .split('-')
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(' ');
+}
+
 // Checked in order — first match wins. More specific patterns come first.
 const ROUTE_RULES: RouteRule[] = [
   {
@@ -28,6 +34,10 @@ const ROUTE_RULES: RouteRule[] = [
     pattern: /^\/locations$/,
     getParams: () => ({ contentName: 'Locations', contentCategory: 'Locations' }),
   },
+  {
+    pattern: /^\/portal$/,
+    getParams: () => ({ contentName: 'Member Portal', contentCategory: 'Pricing' }),
+  },
   {
     pattern: /^\/service-menu$/,
     getParams: () => ({ contentName: 'Service Menu', contentCategory: 'Pricing' }),
@@ -42,13 +52,6 @@ const ROUTE_RULES: RouteRule[] = [
   },
 ];
 
-function slugToTitle(slug: string): string {
-  return slug
-    .split('-')
-    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-    .join(' ');
-}
-
 type Props = {
   /** External booking URL. When set, fires InitiateCheckout on any click targeting that URL. */
   bookingUrl?: string | null;
@@ -58,6 +61,9 @@ type Props = {
  * Single client-side tracker placed once in KeystoneRootLayout.
  * - Fires ViewContent on every route change for known page patterns.
  * - Fires InitiateCheckout whenever a visitor clicks a link to the external booking URL.
+ *
+ * Portal booking tab tracking is handled directly inside PortalPage via PortalTabTracker
+ * since intent is only established when the Booking tab is explicitly opened.
  */
 export function MetaPixelTracker({ bookingUrl }: Props) {
   const pathname = usePathname();
@@ -67,7 +73,7 @@ export function MetaPixelTracker({ bookingUrl }: Props) {
       const match = pathname.match(rule.pattern);
       if (match) {
         const { contentName, contentCategory } = rule.getParams(match);
-        trackViewContent(contentName, contentCategory);
+        firePixelEvent('ViewContent', { contentName, contentCategory });
         break;
       }
     }
@@ -79,8 +85,7 @@ export function MetaPixelTracker({ bookingUrl }: Props) {
     const handleClick = (e: MouseEvent) => {
       const anchor = (e.target as Element).closest('a');
       if (anchor?.href?.startsWith(bookingUrl)) {
-        console.debug('[MetaPixel] Booking link clicked', { href: anchor.href });
-        trackInitiateCheckout();
+        firePixelEvent('InitiateCheckout');
       }
     };
 

package/src/tracking/firePixelEvent.ts

@@ -0,0 +1,26 @@
+type FbqFn = (method: string, eventName: string, params?: Record<string, string>) => void;
+
+export type PixelEvent = 'PageView' | 'ViewContent' | 'InitiateCheckout' | 'Lead';
+
+export interface PixelEventParams {
+  contentName?: string;
+  contentCategory?: string;
+}
+
+/**
+ * Single entry point for all client-side Meta Pixel event fires.
+ * Silently no-ops if fbq is not loaded (pixel not configured for this site).
+ */
+export function firePixelEvent(event: PixelEvent, params?: PixelEventParams): void {
+  if (typeof window === 'undefined') return;
+  const fbq = (window as Window & { fbq?: FbqFn }).fbq;
+  if (!fbq) {
+    console.debug('[MetaPixel] skipped — fbq not loaded', { event });
+    return;
+  }
+  const normalized: Record<string, string> = {};
+  if (params?.contentName) normalized.content_name = params.contentName;
+  if (params?.contentCategory) normalized.content_category = params.contentCategory;
+  console.debug('[MetaPixel]', event, normalized);
+  fbq('track', event, Object.keys(normalized).length > 0 ? normalized : undefined);
+}

package/src/tracking/index.ts

@@ -1,9 +1,5 @@
 export { MetaPixel } from './MetaPixel';
 export type { MetaPixelProps } from './MetaPixel';
-export { trackMetaLead } from './trackMetaLead';
-export { trackViewContent } from './trackViewContent';
-export { trackInitiateCheckout } from './trackInitiateCheckout';
 export { MetaPixelTracker } from './MetaPixelTracker';
-// Kept for custom use — MetaPixelTracker covers the standard cases automatically.
-export { ViewContentTracker } from './ViewContentTracker';
-export { BookingCtaTracker } from './BookingCtaTracker';
+export { firePixelEvent } from './firePixelEvent';
+export type { PixelEvent, PixelEventParams } from './firePixelEvent';

package/src/types/api/company-information.ts

@@ -36,6 +36,8 @@ export interface CompanyInformation {
   sales_email?: string;
   business_hours?: string;
   external_management_url?: string;
+  /** Member portal URL for this account. When set, used as the primary CTA instead of external_management_url. */
+  portal_url?: string | null;
   created_at: string;
   updated_at: string;
   photo_attachments?: PhotoAttachment[];

package/src/tracking/BookingCtaTracker.tsx

@@ -1,32 +0,0 @@
-'use client';
-
-import { useEffect } from 'react';
-import { trackInitiateCheckout } from './trackInitiateCheckout';
-
-type Props = {
-  bookingUrl: string | null | undefined;
-};
-
-/**
- * Drop into the root layout to fire Meta Pixel InitiateCheckout whenever a visitor
- * clicks any anchor whose href points to the external booking URL.
- * Uses document-level click delegation — no changes needed to individual buttons.
- */
-export function BookingCtaTracker({ bookingUrl }: Props) {
-  useEffect(() => {
-    if (!bookingUrl) return;
-
-    const handleClick = (e: MouseEvent) => {
-      const anchor = (e.target as Element).closest('a');
-      if (!anchor) return;
-      if (anchor.href && anchor.href.startsWith(bookingUrl)) {
-        trackInitiateCheckout();
-      }
-    };
-
-    document.addEventListener('click', handleClick);
-    return () => document.removeEventListener('click', handleClick);
-  }, [bookingUrl]);
-
-  return null;
-}

package/src/tracking/ViewContentTracker.tsx

@@ -1,21 +0,0 @@
-'use client';
-
-import { useEffect } from 'react';
-import { trackViewContent } from './trackViewContent';
-
-type Props = {
-  contentName?: string;
-  contentCategory?: string;
-};
-
-/**
- * Drop into any server-rendered page to fire the Meta Pixel ViewContent event on mount.
- * Renders nothing — purely a tracking side-effect component.
- */
-export function ViewContentTracker({ contentName, contentCategory }: Props) {
-  useEffect(() => {
-    trackViewContent(contentName, contentCategory);
-  }, [contentName, contentCategory]);
-
-  return null;
-}

package/src/tracking/trackInitiateCheckout.ts

@@ -1,16 +0,0 @@
-type FbqFn = (method: string, eventName: string, params?: object) => void;
-
-/**
- * Fires the client-side Meta Pixel InitiateCheckout event.
- * Call this when a visitor clicks a booking / scheduling button.
- */
-export function trackInitiateCheckout(): void {
-  if (typeof window === 'undefined') return;
-  const fbq = (window as Window & { fbq?: FbqFn }).fbq;
-  if (!fbq) {
-    console.debug('[MetaPixel] InitiateCheckout skipped — fbq not loaded');
-    return;
-  }
-  console.debug('[MetaPixel] InitiateCheckout');
-  fbq('track', 'InitiateCheckout');
-}

package/src/tracking/trackMetaLead.ts

@@ -1,14 +0,0 @@
-/**
- * Fires the client-side Meta Pixel Lead event with the same eventID as server CAPI
- * so Meta can deduplicate browser + server events.
- */
-export function trackMetaLead(eventId: string | undefined): void {
-  if (typeof window === 'undefined' || !eventId) return;
-  const fbq = (window as Window & { fbq?: (method: string, eventName: string, params?: object, options?: { eventID?: string }) => void }).fbq;
-  if (!fbq) {
-    console.debug('[MetaPixel] Lead skipped — fbq not loaded', { eventId });
-    return;
-  }
-  console.debug('[MetaPixel] Lead', { eventId });
-  fbq('track', 'Lead', {}, { eventID: eventId });
-}

package/src/tracking/trackViewContent.ts

@@ -1,19 +0,0 @@
-type FbqFn = (method: string, eventName: string, params?: object) => void;
-
-/**
- * Fires the client-side Meta Pixel ViewContent event.
- * Call this on service/offer detail pages so Meta knows which content is most engaging.
- */
-export function trackViewContent(contentName?: string, contentCategory?: string): void {
-  if (typeof window === 'undefined') return;
-  const fbq = (window as Window & { fbq?: FbqFn }).fbq;
-  if (!fbq) {
-    console.debug('[MetaPixel] ViewContent skipped — fbq not loaded', { contentName, contentCategory });
-    return;
-  }
-  const params: Record<string, string> = {};
-  if (contentName) params.content_name = contentName;
-  if (contentCategory) params.content_category = contentCategory;
-  console.debug('[MetaPixel] ViewContent', params);
-  fbq('track', 'ViewContent', params);
-}