@sonordev/site-kit 7.4.0 → 8.0.0

package/dist/commerce/ProductPage.d.ts

@@ -1,39 +0,0 @@
-/**
- * @sonordev/site-kit/commerce - ProductPage
- *
- * Complete product page component with SEO metadata, breadcrumbs, and related products.
- * Use this as a drop-in for dynamic [slug] routes.
- */
-import React from 'react';
-import type { CommerceOffering, CommerceVariant } from './types';
-export interface ProductPageProps {
-    /** Pre-loaded product data (for SSR) */
-    product?: CommerceOffering;
-    /** Product slug to fetch (if not pre-loaded) */
-    slug?: string;
-    /** Show breadcrumbs navigation */
-    showBreadcrumbs?: boolean;
-    /** Show related products section */
-    showRelatedProducts?: boolean;
-    /** Number of related products to show */
-    relatedProductsLimit?: number;
-    /** Show back to shop link */
-    showBackLink?: boolean;
-    /** Base path for shop */
-    shopBasePath?: string;
-    /** Success URL after checkout */
-    successUrl?: string;
-    /** Cancel URL if checkout cancelled */
-    cancelUrl?: string;
-    /** Callback when added to cart */
-    onAddToCart?: (product: CommerceOffering, variant?: CommerceVariant, quantity?: number) => void;
-    /** Custom breadcrumb renderer */
-    renderBreadcrumbs?: (product: CommerceOffering) => React.ReactNode;
-    /** Custom SEO head renderer (for Next.js Head or similar) */
-    renderHead?: (product: CommerceOffering) => React.ReactNode;
-    /** Additional class names */
-    className?: string;
-    /** Custom styles */
-    style?: React.CSSProperties;
-}
-export declare function ProductPage({ product: propProduct, slug, showBreadcrumbs, showRelatedProducts, relatedProductsLimit, showBackLink, shopBasePath, successUrl, cancelUrl, onAddToCart, renderBreadcrumbs, renderHead, className, style, }: ProductPageProps): React.JSX.Element;

package/dist/commerce/RegistrationForm.d.ts

@@ -1,9 +0,0 @@
-/**
- * @sonordev/site-kit/commerce - RegistrationForm
- *
- * Simplified registration form for free events/classes.
- */
-import React from 'react';
-import type { RegistrationFormProps } from './types';
-export declare function RegistrationForm({ event, scheduleId, title, submitText, successMessage, collectPhone, additionalFields, onSuccess, onError, className, formClassName, inputClassName, buttonClassName, }: RegistrationFormProps): React.JSX.Element;
-export default RegistrationForm;

package/dist/commerce/SizeChart.d.ts

@@ -1,8 +0,0 @@
-import type { SizeChart as SizeChartType } from './types';
-interface SizeChartProps {
-    chart: SizeChartType;
-    selectedSize?: string;
-    className?: string;
-}
-export declare function SizeChart({ chart, selectedSize, className }: SizeChartProps): import("react").JSX.Element | null;
-export {};

package/dist/commerce/UpcomingEvents.d.ts

@@ -1,9 +0,0 @@
-/**
- * @sonordev/site-kit/commerce - UpcomingEvents
- *
- * Displays a list of upcoming events with date, title, and registration buttons.
- */
-import React from 'react';
-import type { UpcomingEventsProps } from './types';
-export declare function UpcomingEvents({ events: propEvents, limit, category, variant, layout, showViewAll, viewAllUrl, viewAllText, emptyMessage, title, onRegister, onCtaClick, className, titleClassName, eventClassName, }: UpcomingEventsProps): React.JSX.Element;
-export default UpcomingEvents;

package/dist/commerce/api.d.ts

@@ -1,179 +0,0 @@
-/**
- * @sonordev/site-kit/commerce - Commerce API
- *
- * API functions for fetching offerings, submitting orders, and registrations.
- * All data goes through Sonor API with API key auth - never Supabase directly.
- */
-import type { CommerceOffering, FetchOfferingsOptions, FetchEventsOptions, CheckoutCustomer, CheckoutResult } from './types';
-export declare function fetchOfferings(options?: FetchOfferingsOptions): Promise<CommerceOffering[]>;
-export declare function fetchOffering(slug: string): Promise<CommerceOffering | null>;
-export declare function fetchLatestOffering(type?: string, category?: string): Promise<CommerceOffering | null>;
-export declare function fetchUpcomingEvents(options?: FetchEventsOptions): Promise<CommerceOffering[]>;
-export declare function fetchNextEvent(category?: string): Promise<CommerceOffering | null>;
-export declare function fetchProducts(options?: Omit<FetchOfferingsOptions, 'type'>): Promise<CommerceOffering[]>;
-export declare function fetchServices(options?: Omit<FetchOfferingsOptions, 'type'>): Promise<CommerceOffering[]>;
-/**
- * Fetch products via public API
- */
-export declare function fetchProductsPublic(options?: {
-    category?: string;
-    limit?: number;
-    offset?: number;
-    orderBy?: 'name' | 'price' | 'created_at' | 'sort_order';
-    order?: 'asc' | 'desc';
-    search?: string;
-}): Promise<{
-    products: CommerceOffering[];
-    total: number;
-}>;
-/**
- * Fetch single product by slug
- */
-export declare function fetchProductBySlug(slug: string): Promise<CommerceOffering | null>;
-/**
- * Fetch product categories
- */
-export declare function fetchCategories(): Promise<{
-    id: string;
-    name: string;
-    slug: string;
-}[]>;
-export interface ShippingAddress {
-    street1: string;
-    street2?: string;
-    city: string;
-    state: string;
-    zip: string;
-    country?: string;
-    name?: string;
-    phone?: string;
-}
-export interface ShippingRate {
-    carrier: string;
-    service: string;
-    amount: string;
-    currency: string;
-    estimatedDays?: number;
-    objectId?: string;
-    /**
-     * Signed by the API along with the rate. Checkout charges shipping from it,
-     * not from `amount`, so send it back as `shippingQuote` (shippingSelection
-     * does). Absent from APIs that predate quotes.
-     */
-    quote?: string;
-}
-/**
- * The chosen rate as checkout options: carrier, service, amount, and the
- * signed quote the API charges shipping from. The one place a rate becomes
- * checkout fields, for CheckoutForm, ProductDetail and custom checkouts.
- */
-export declare function shippingSelection(rate: ShippingRate | null | undefined): Pick<CreateCheckoutOptions, 'shippingCarrier' | 'shippingService' | 'shippingCost' | 'shippingQuote'>;
-export interface ValidateAddressResult {
-    isValid: boolean;
-    normalized?: {
-        street1: string;
-        street2?: string;
-        city: string;
-        state: string;
-        zip: string;
-        country: string;
-    };
-    messages?: string[];
-}
-/**
- * Fetch shipping rates for checkout (when shipping is enabled)
- */
-export declare function fetchShippingRates(shippingAddress: ShippingAddress, offerings: Array<{
-    offering_id: string;
-    quantity?: number;
-}>): Promise<ShippingRate[]>;
-/**
- * Validate a shipping address before checkout
- */
-export declare function validateAddress(address: Omit<ShippingAddress, 'name' | 'phone'>): Promise<ValidateAddressResult>;
-/**
- * Fetch the active payment processor for the current project.
- * Returns 'stripe' | 'square' | null.
- */
-export declare function fetchActiveProcessor(): Promise<'stripe' | 'square' | null>;
-export declare function registerForEvent(eventId: string, scheduleId: string | undefined, customer: CheckoutCustomer): Promise<CheckoutResult>;
-export interface CheckoutLineItem {
-    offeringId: string;
-    variantId?: string;
-    scheduleId?: string;
-    quantity: number;
-}
-export interface CreateCheckoutOptions {
-    offeringId?: string;
-    variantId?: string;
-    scheduleId?: string;
-    quantity?: number;
-    /**
-     * Multi-line cart (v1: events only, all items must share offeringId + scheduleId).
-     * When provided, takes precedence over offeringId/variantId/quantity. Requires
-     * `sourceId` (Square Web Payments SDK nonce) — Square inline only in v1.
-     */
-    lineItems?: CheckoutLineItem[];
-    customer?: CheckoutCustomer;
-    successUrl?: string;
-    cancelUrl?: string;
-    /** Square card nonce from Web Payments SDK for inline card collection (no redirect) */
-    sourceId?: string;
-    /** Shipping address (required for physical products when shipping_enabled) */
-    shippingAddress?: ShippingAddress;
-    /** Selected shipping carrier from rates */
-    shippingCarrier?: string;
-    /** Selected shipping service from rates */
-    shippingService?: string;
-    /** Shipping cost in dollars (from selected rate) */
-    shippingCost?: number;
-    /** The selected rate's signed quote; the API charges shipping from it. */
-    shippingQuote?: string;
-    /** Discount/promo code to apply */
-    discountCode?: string;
-}
-export interface DiscountValidationResult {
-    valid: boolean;
-    discount_amount?: number;
-    discount_type?: 'percentage' | 'fixed_amount' | 'free_shipping';
-    discount_value?: number;
-    code?: string;
-    name?: string;
-    message?: string;
-}
-/**
- * Validate a discount code against the current order.
- * Returns the discount amount if valid, or an error message if not.
- */
-export declare function validateDiscountCode(code: string, subtotal: number, offeringIds?: string[]): Promise<DiscountValidationResult>;
-export interface ProcessorConfig {
-    processor: 'stripe' | 'square' | null;
-    squareAppId?: string;
-    squareLocationId?: string;
-    squareEnvironment?: string;
-    stripePublishableKey?: string;
-    /** Whether shipping is enabled for this project */
-    shipping_enabled?: boolean;
-}
-/**
- * Fetch client-side SDK config for the active payment processor.
- * Returns public-safe values (app IDs, location IDs) for SDK initialization.
- */
-export declare function fetchProcessorConfig(): Promise<ProcessorConfig | null>;
-/**
- * Create a Stripe PaymentIntent for inline card payment (no redirect).
- * Use with Stripe Elements on the frontend to collect and confirm card details directly.
- * The existing payment_intent.succeeded webhook handles marking the sale as paid.
- */
-export declare function createPaymentIntent(options: CreateCheckoutOptions): Promise<{
-    success: boolean;
-    clientSecret?: string;
-    saleId?: string;
-    confirmationNumber?: string;
-    error?: string;
-}>;
-/**
- * Create a checkout session for a product or service
- * Supports both Stripe and Square based on project configuration
- */
-export declare function createCheckoutSession(optionsOrOfferingId: CreateCheckoutOptions | string, legacyOptions?: Omit<CreateCheckoutOptions, 'offeringId'>): Promise<CheckoutResult>;

package/dist/commerce/events-extras.d.ts

@@ -1,60 +0,0 @@
-/**
- * Events polish: calendar links, structured data, honest capacity.
- *
- * - icsForEvent / googleCalendarUrl / createIcsRoute: "Add to calendar"
- *   without a third-party service.
- * - EventJsonLd: schema.org/Event emitted from the offering the site already
- *   fetched — free rich results.
- * - CapacityBadge: renders from spots_remaining/capacity. Per the QCR
- *   oversell incident, the seat count is the ONLY honest sold-out signal
- *   (status can stay 'active' during an emergency shutdown), so this badge
- *   never derives fullness from status.
- *
- * Server-safe: no hooks, no browser APIs — usable from RSC pages directly.
- */
-import React from 'react';
-import type { CommerceOffering, CommerceSchedule } from './types';
-export interface IcsEventInput {
-    offering: CommerceOffering;
-    schedule: CommerceSchedule;
-    /** Absolute URL of the event page, for the ICS URL property. */
-    url?: string;
-}
-/** Build a single-event .ics document. */
-export declare function icsForEvent({ offering, schedule, url }: IcsEventInput): string;
-/** Google Calendar "add event" URL for the same data. */
-export declare function googleCalendarUrl({ offering, schedule }: IcsEventInput): string;
-/**
- * Route handler factory: app/events/[slug]/calendar.ics/route.ts (or any
- * route) — resolve the event yourself, delegate the response here.
- */
-export declare function icsResponse(input: IcsEventInput): Response;
-export interface EventJsonLdProps {
-    offering: CommerceOffering;
-    schedule: CommerceSchedule;
-    /** Absolute page URL. */
-    url?: string;
-    /** Site origin for offer URLs, e.g. https://example.com */
-    origin?: string;
-}
-/** schema.org/Event structured data from data the page already fetched. */
-export declare function EventJsonLd({ offering, schedule, url, origin }: EventJsonLdProps): React.JSX.Element;
-export interface CapacityBadgeProps {
-    schedule: CommerceSchedule;
-    className?: string;
-    /** Show "N of M spots left" instead of just "N spots left" when capacity known. */
-    showTotal?: boolean;
-    /** Below this count the badge gets data-sk-urgency="low-spots". Default 5. */
-    lowThreshold?: number;
-    labels?: {
-        soldOut?: string;
-        spotsLeft?: (n: number, total?: number | null) => string;
-    };
-}
-/**
- * Honest capacity, styled by the site via data attributes:
- *   [data-sk-part="capacity-badge"][data-sk-availability="sold-out" | "open"]
- *   [data-sk-urgency="low-spots"]
- * Renders nothing when the schedule doesn't track capacity.
- */
-export declare function CapacityBadge({ schedule, className, showTotal, lowThreshold, labels, }: CapacityBadgeProps): React.JSX.Element | null;

package/dist/commerce/index.d.ts

@@ -1,33 +0,0 @@
-/**
- * @sonordev/site-kit/commerce
- *
- * Commerce module for displaying products, services, events, and classes
- * with checkout and registration flows.
- */
-export * from './types';
-export * from './utils';
-export { fetchOfferings, fetchOffering, fetchLatestOffering, fetchProducts, fetchProductsPublic, fetchProductBySlug, fetchCategories, fetchServices, fetchUpcomingEvents, fetchNextEvent, fetchShippingRates, shippingSelection, validateAddress, registerForEvent, createCheckoutSession, createPaymentIntent, fetchActiveProcessor, fetchProcessorConfig, validateDiscountCode, } from './api';
-export type { ShippingAddress, ShippingRate, ValidateAddressResult, CreateCheckoutOptions, CheckoutLineItem, ProcessorConfig, DiscountValidationResult } from './api';
-export { OfferingCard } from './OfferingCard';
-export { OfferingList } from './OfferingList';
-export { EventTile } from './EventTile';
-export { UpcomingEvents } from './UpcomingEvents';
-export { ProductEmbed } from './ProductEmbed';
-export { ProductDetail } from './ProductDetail';
-export { SizeChart } from './SizeChart';
-export { ProductGrid } from './ProductGrid';
-export { ProductPage } from './ProductPage';
-export { EventEmbed } from './EventEmbed';
-export { CheckoutForm } from './CheckoutForm';
-export { EventCheckout } from './EventCheckout';
-export type { EventCheckoutProps } from './EventCheckout';
-export { RegistrationForm } from './RegistrationForm';
-export { CalendarView } from './CalendarView';
-export { EventsAgenda } from './EventsAgenda';
-export type { EventsAgendaProps, AgendaItem } from './EventsAgenda';
-export { EventModal } from './EventModal';
-export { EventCalendar } from './EventCalendar';
-export { EventsWidget } from './EventsWidget';
-export { useEventModal } from './useEventModal';
-export { icsForEvent, icsResponse, googleCalendarUrl, EventJsonLd, CapacityBadge, } from './events-extras';
-export type { IcsEventInput, EventJsonLdProps, CapacityBadgeProps } from './events-extras';