@rovela-ai/sdk 0.1.2 → 0.1.3

package/dist/checkout/types.d.ts

@@ -0,0 +1,263 @@
+/**
+ * @rovela/sdk/checkout/types
+ *
+ * Type definitions for the checkout module.
+ * Stripe Connect with Direct Charges and platform fees.
+ */
+import type { Address } from '../core/types';
+/**
+ * Line item for checkout session creation.
+ * Prices are in cents (e.g., 1999 = $19.99)
+ */
+export interface CheckoutLineItem {
+    /** Product ID from database */
+    productId?: string;
+    /** Variant ID if applicable */
+    variantId?: string;
+    /** Display name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Price in cents */
+    price: number;
+    /** Quantity */
+    quantity: number;
+    /** Product image URL */
+    image?: string;
+    /** Variant attributes */
+    attributes?: Record<string, string>;
+}
+/**
+ * Request to create a Stripe Checkout session
+ */
+export interface CheckoutSessionRequest {
+    /** Items to purchase */
+    items: CheckoutLineItem[];
+    /** Customer email (optional, will be collected if not provided) */
+    customerEmail?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /** Shipping address (optional) */
+    shippingAddress?: Address;
+    /** URL to redirect on success (must include {CHECKOUT_SESSION_ID} placeholder) */
+    successUrl: string;
+    /** URL to redirect on cancel */
+    cancelUrl: string;
+    /** Custom metadata to attach to the session */
+    metadata?: Record<string, string>;
+}
+/**
+ * Response from checkout session creation
+ */
+export interface CheckoutSessionResponse {
+    /** Stripe Checkout session ID */
+    sessionId: string;
+    /** URL to redirect customer to Stripe Checkout */
+    url: string;
+}
+/**
+ * Error response from checkout API
+ */
+export interface CheckoutApiError {
+    /** Error message */
+    error: string;
+    /** Error code for programmatic handling */
+    code: 'EMPTY_CART' | 'INVALID_REQUEST' | 'STRIPE_NOT_CONFIGURED' | 'ACCOUNT_NOT_CONNECTED' | 'CHECKOUT_ERROR' | 'WEBHOOK_ERROR' | 'SIGNATURE_INVALID';
+}
+/**
+ * Parameters for creating an order from a completed checkout session
+ */
+export interface CreateOrderParams {
+    /** Stripe Checkout session ID */
+    sessionId: string;
+    /** Customer email */
+    email: string;
+    /** Line items from the checkout */
+    items: CheckoutLineItem[];
+    /** Subtotal in cents */
+    subtotal: number;
+    /** Tax amount in cents */
+    tax: number;
+    /** Shipping amount in cents */
+    shipping: number;
+    /** Total amount in cents */
+    total: number;
+    /** Shipping address */
+    shippingAddress: Address;
+    /** Billing address (optional) */
+    billingAddress?: Address;
+    /** Stripe Payment Intent ID */
+    stripePaymentIntentId: string;
+    /** Stripe Customer ID (if customer was created) */
+    stripeCustomerId?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+}
+/**
+ * Result from processing a webhook
+ */
+export interface WebhookResult {
+    /** Whether the webhook was received and processed */
+    received: boolean;
+    /** The event type that was processed */
+    event?: string;
+    /** Order ID if an order was created */
+    orderId?: string;
+    /** Error message if processing failed */
+    error?: string;
+}
+/**
+ * Checkout flow steps
+ */
+export type CheckoutStep = 'cart' | 'information' | 'shipping' | 'payment' | 'success';
+/**
+ * Shipping option returned from calculation
+ */
+export interface ShippingOption {
+    /** Unique identifier */
+    id: string;
+    /** Display name (e.g., "Standard Shipping") */
+    name: string;
+    /** Description (e.g., "5-7 business days") */
+    description?: string;
+    /** Price in cents */
+    price: number;
+    /** Estimated delivery time */
+    estimatedDays?: string;
+}
+/**
+ * Checkout state for the useCheckout hook
+ */
+export interface CheckoutState {
+    /** Current step in checkout flow */
+    step: CheckoutStep;
+    /** Customer email */
+    email: string | null;
+    /** Shipping address */
+    shippingAddress: Address | null;
+    /** Billing address (if different from shipping) */
+    billingAddress: Address | null;
+    /** Selected shipping option */
+    selectedShipping: ShippingOption | null;
+    /** Whether checkout is processing */
+    isProcessing: boolean;
+    /** Error message if any */
+    error: string | null;
+}
+/**
+ * Props for CheckoutButton component
+ */
+export interface CheckoutButtonProps {
+    /** Button text (default: "Checkout") */
+    children?: React.ReactNode;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Custom className */
+    className?: string;
+    /** Callback before redirect */
+    onBeforeCheckout?: () => void | Promise<void>;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Full width */
+    fullWidth?: boolean;
+}
+/**
+ * Props for ShippingForm component
+ */
+export interface ShippingFormProps {
+    /** Initial values */
+    defaultValues?: Partial<Address>;
+    /** Callback on valid submission */
+    onSubmit: (address: Address) => void;
+    /** Callback on cancel */
+    onCancel?: () => void;
+    /** Whether form is submitting */
+    isSubmitting?: boolean;
+    /** Custom className */
+    className?: string;
+    /** Show billing address option */
+    showBillingAddress?: boolean;
+    /** Callback when billing address is different */
+    onBillingAddressChange?: (address: Address | null) => void;
+}
+/**
+ * Props for OrderSummary component
+ */
+export interface OrderSummaryProps {
+    /** Line items to display */
+    items?: CheckoutLineItem[];
+    /** Subtotal in cents */
+    subtotal?: number;
+    /** Shipping cost in cents */
+    shipping?: number;
+    /** Tax in cents */
+    tax?: number;
+    /** Total in cents */
+    total?: number;
+    /** Currency code */
+    currency?: string;
+    /** Locale for formatting */
+    locale?: string;
+    /** Custom className */
+    className?: string;
+    /** Whether to show item details */
+    showItems?: boolean;
+    /** Whether to show edit link */
+    showEditLink?: boolean;
+    /** Edit link href */
+    editHref?: string;
+}
+/**
+ * Props for CheckoutSuccess component
+ */
+export interface CheckoutSuccessProps {
+    /** Order ID to display */
+    orderId?: string;
+    /** Customer email for order updates */
+    email?: string;
+    /** Custom className */
+    className?: string;
+    /** Continue shopping link */
+    continueShoppingHref?: string;
+    /** View order link pattern */
+    viewOrderHref?: string;
+    /** Callback on mount (useful for cart clearing) */
+    onMount?: () => void;
+}
+/**
+ * Options for the useCheckout hook
+ */
+export interface UseCheckoutOptions {
+    /** Customer email (if known) */
+    customerEmail?: string;
+    /** Store customer ID (if authenticated) */
+    customerId?: string;
+    /** Custom success URL */
+    successUrl?: string;
+    /** Custom cancel URL */
+    cancelUrl?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** Callback on successful session creation (before redirect) */
+    onSuccess?: (session: CheckoutSessionResponse) => void;
+    /** Callback on error */
+    onError?: (error: CheckoutApiError) => void;
+    /** Whether to clear cart on checkout (default: true) */
+    clearCartOnCheckout?: boolean;
+}
+/**
+ * Return type for the useCheckout hook
+ */
+export interface UseCheckoutReturn {
+    /** Start checkout process */
+    checkout: () => Promise<void>;
+    /** Whether checkout is in progress */
+    isLoading: boolean;
+    /** Last error (if any) */
+    error: CheckoutApiError | null;
+    /** Clear error state */
+    clearError: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checkout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkout/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAM5C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;CACZ;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,IAAI,EACA,YAAY,GACZ,iBAAiB,GACjB,uBAAuB,GACvB,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,CAAA;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+BAA+B;IAC/B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAA;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,YAAY,CAAA;IAClB,qBAAqB;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,uBAAuB;IACvB,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,mDAAmD;IACnD,cAAc,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,+BAA+B;IAC/B,gBAAgB,EAAE,cAAc,GAAG,IAAI,CAAA;IACvC,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAA;IACrB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,mCAAmC;IACnC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACpC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,iCAAiC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IACtD,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC3C,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAA;IAClB,0BAA0B;IAC1B,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,wBAAwB;IACxB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB"}

package/dist/checkout/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/types
+ *
+ * Type definitions for the checkout module.
+ * Stripe Connect with Direct Charges and platform fees.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/checkout/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/checkout/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/core/config.d.ts

@@ -0,0 +1,296 @@
+/**
+ * @rovela/sdk/core/config
+ *
+ * Configuration system for reading blueprint.json at runtime.
+ * The blueprint is generated by Rovela and placed at .rovela/blueprint.json
+ */
+import type { StoreConfig } from './types';
+export type ProductType = 'physical' | 'digital' | 'both';
+export type BusinessStage = 'startup' | 'growth' | 'established';
+export type Inspiration = 'apple' | 'nike' | 'stripe' | 'airbnb' | 'glossier' | 'patagonia' | 'spotify' | 'medium' | 'tesla' | 'etsy' | 'kylie-cosmetics' | 'warby-parker';
+export interface ColorScale {
+    50: string;
+    100: string;
+    200: string;
+    300: string;
+    400: string;
+    500: string;
+    600: string;
+    700: string;
+    800: string;
+    900: string;
+    950: string;
+}
+export interface SemanticColors {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+}
+export interface ColorGradient {
+    name: string;
+    type: 'linear' | 'radial';
+    colors: string[];
+    direction: string;
+    usage: string[];
+}
+export interface FontConfig {
+    name: string;
+    weights: number[];
+    fallback: string[];
+}
+export interface BlueprintStore {
+    id: string;
+    name: string;
+    slug: string;
+    description: string;
+    productType: ProductType;
+    businessStage: BusinessStage;
+    currency: string;
+    locale: string;
+}
+export interface BlueprintTheme {
+    inspiration?: Inspiration;
+    personality?: {
+        x: number;
+        y: number;
+    };
+    colors: {
+        primary: ColorScale;
+        secondary: ColorScale;
+        accent: ColorScale;
+        neutral: ColorScale;
+        semantic: SemanticColors;
+        gradients?: ColorGradient[];
+        semanticMappings?: Record<string, {
+            dark: string;
+            light: string;
+        }>;
+    };
+    typography?: {
+        heading: FontConfig;
+        body: FontConfig;
+        mono: FontConfig;
+    };
+    spacing?: 'cozy' | 'balanced' | 'spacious';
+    borderRadius?: 'none' | 'subtle' | 'rounded' | 'pill';
+    animation?: 'none' | 'subtle' | 'smooth' | 'playful';
+    layout?: {
+        containerWidth: string;
+        gridColumns: number;
+        gridGap: string;
+        breakpoints: Record<string, string>;
+    };
+    borders?: {
+        radius: Record<string, string>;
+        width: Record<string, string>;
+    };
+    effects?: {
+        shadows: Record<string, string>;
+        blurs: Record<string, string>;
+        overlays: Record<string, string>;
+        gradients?: ColorGradient[];
+    };
+    imagery?: {
+        style: string;
+        tone: string[];
+        subjects: string[];
+        treatments: string[];
+        avoid: string[];
+    };
+}
+export interface BlueprintBrand {
+    tagline: string;
+    uniqueValue: string;
+    targetAudience: string;
+    voice: {
+        tone: string[];
+        personality: string[];
+        vocabulary: {
+            preferred: string[];
+            avoid: string[];
+        };
+    };
+    personality?: {
+        archetype: string;
+        traits: string[];
+        values: string[];
+    };
+    positioning?: {
+        statement: string;
+        uniqueValue: string;
+        targetAudience: string;
+        competitiveAdvantage: string[];
+    };
+    visualStyle?: {
+        aesthetic: string;
+        mood: string[];
+        principles: string[];
+    };
+    differentiators?: string[];
+    emotionalResponse?: string[];
+}
+export interface HomepageHero {
+    headline: string;
+    subheadline: string;
+    cta: {
+        text: string;
+        link: string;
+    };
+    imageQuery?: string;
+    layout?: 'left' | 'center' | 'right';
+}
+export interface HomepageFeature {
+    icon: string;
+    title: string;
+    description: string;
+}
+export interface HomepageTestimonial {
+    quote: string;
+    author: string;
+    role?: string;
+    avatar?: string;
+}
+export interface HomepagePricingTier {
+    name: string;
+    price: number;
+    period?: string;
+    features: string[];
+    cta: string;
+    highlighted?: boolean;
+}
+export interface HomepageFAQ {
+    question: string;
+    answer: string;
+}
+export interface BlueprintHomepage {
+    hero: HomepageHero;
+    features?: {
+        title: string;
+        subtitle?: string;
+        items: HomepageFeature[];
+    };
+    testimonials?: {
+        title: string;
+        items: HomepageTestimonial[];
+    };
+    pricing?: {
+        title: string;
+        subtitle?: string;
+        tiers: HomepagePricingTier[];
+    };
+    faq?: {
+        title: string;
+        items: HomepageFAQ[];
+    };
+    cta?: {
+        headline: string;
+        description: string;
+        buttonText: string;
+        buttonLink?: string;
+    };
+}
+export interface BlueprintModules {
+    auth?: {
+        enabled: boolean;
+        guestCheckout: boolean;
+        customerAccounts: boolean;
+    };
+    products?: {
+        hasVariants: boolean;
+        trackInventory: boolean;
+    };
+    orders?: {
+        processing: 'instant' | 'manual';
+        returnPolicy: 'none' | '7-days' | '14-days' | '30-days' | '60-days';
+        refundType: 'full' | 'store-credit' | 'exchange' | 'case-by-case';
+    };
+    shipping?: {
+        method: 'carrier' | 'pickup' | 'delivery' | 'dropship';
+        rates: 'free' | 'flat' | 'weight' | 'location' | 'realtime';
+        processingTime: 'same-day' | '1-2-days' | '3-5-days' | '1-2-weeks' | 'made-to-order';
+    };
+    digital?: {
+        productTypes: string[];
+        deliveryMethod: 'download' | 'email' | 'access';
+        accessDuration: 'lifetime' | '1-year' | '6-months' | '30-days';
+    };
+    payments?: {
+        provider: 'stripe';
+        currency: string;
+        taxHandling: 'included' | 'checkout' | 'none' | 'service';
+    };
+    emails?: {
+        templates: ('order-confirmation' | 'shipping-update' | 'welcome' | 'password-reset')[];
+    };
+}
+export interface BlueprintSEO {
+    title: string;
+    description: string;
+    keywords: string[];
+    ogImage?: string;
+}
+export interface BlueprintMetadata {
+    blueprintVersion?: string;
+    questionnaireId?: string;
+    sdkVersion?: string;
+    generatedBy?: string;
+    generatedAt?: string;
+    confidence?: number;
+}
+/**
+ * Complete Blueprint structure as generated by Rovela
+ */
+export interface Blueprint {
+    store: BlueprintStore;
+    theme: BlueprintTheme;
+    brand: BlueprintBrand;
+    homepage: BlueprintHomepage;
+    modules?: BlueprintModules;
+    seo?: BlueprintSEO;
+    metadata?: BlueprintMetadata;
+}
+/**
+ * Load and parse the blueprint.json file
+ * @throws Error if blueprint file is not found or invalid
+ */
+export declare function loadBlueprint(): Blueprint;
+/**
+ * Get the full blueprint object
+ * Use this when you need access to all blueprint data (theme, brand, homepage, etc.)
+ */
+export declare function getBlueprint(): Blueprint;
+/**
+ * Get simplified store configuration
+ * Use this for basic store info (name, currency, locale)
+ */
+export declare function getStoreConfig(): StoreConfig;
+/**
+ * Clear cached blueprint and config (useful for testing or hot reloading)
+ */
+export declare function clearConfigCache(): void;
+/**
+ * Check if blueprint exists at the expected path
+ */
+export declare function blueprintExists(): boolean;
+/**
+ * Get theme configuration from blueprint
+ */
+export declare function getTheme(): BlueprintTheme;
+/**
+ * Get brand configuration from blueprint
+ */
+export declare function getBrand(): BlueprintBrand;
+/**
+ * Get homepage configuration from blueprint
+ */
+export declare function getHomepage(): BlueprintHomepage;
+/**
+ * Get module configuration from blueprint
+ */
+export declare function getModules(): BlueprintModules | undefined;
+/**
+ * Get SEO configuration from blueprint
+ */
+export declare function getSEO(): BlueprintSEO | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}