@iqworksai/consentiq-react 0.1.4 → 0.1.6

package/README.md

@@ -1,21 +1,21 @@
-# @consentiq/react
+# @iqworksai/consentiq-react
 
 React SDK for ConsentIQ consent management platform.
 
 ## Installation
 
 ```bash
-npm install @consentiq/react
+npm install @iqworksai/consentiq-react
 # or
-yarn add @consentiq/react
+yarn add @iqworksai/consentiq-react
 # or
-pnpm add @consentiq/react
+pnpm add @iqworksai/consentiq-react
 ```
 
 ## Quick Start
 
 ```tsx
-import { ConsentIQProvider, CookieBanner, PreferenceCenter } from '@consentiq/react';
+import { ConsentIQProvider, CookieBanner, PreferenceCenter } from '@iqworksai/consentiq-react';
 
 function App() {
   return (
@@ -35,7 +35,7 @@ function App() {
 ```tsx
 <ConsentIQProvider
   propertyKey="YOUR_PROPERTY_KEY"
-  apiUrl="https://api.consentiq.io" // Optional: custom API URL
+  apiUrl="https://consent.iqworks.ai" // Optional: custom API URL
   autoShow={true} // Optional: show banner automatically
   language="en" // Optional: override detected language
   debug={false} // Optional: enable debug logging
@@ -50,7 +50,7 @@ function App() {
 ### Using the Consent Hook
 
 ```tsx
-import { useConsentIQ } from '@consentiq/react';
+import { useConsentIQ } from '@iqworksai/consentiq-react';
 
 function Analytics() {
   const { hasConsent } = useConsentIQ();
@@ -66,7 +66,7 @@ function Analytics() {
 ### Simplified Consent Check
 
 ```tsx
-import { useConsent } from '@consentiq/react';
+import { useConsent } from '@iqworksai/consentiq-react';
 
 function MarketingScript() {
   const hasMarketing = useConsent('marketing');
@@ -80,7 +80,7 @@ function MarketingScript() {
 ### Consent Gate Component
 
 ```tsx
-import { ConsentGate } from '@consentiq/react';
+import { ConsentGate } from '@iqworksai/consentiq-react';
 
 function App() {
   return (
@@ -97,7 +97,7 @@ function App() {
 ### Manual Control
 
 ```tsx
-import { useConsentIQ } from '@consentiq/react';
+import { useConsentIQ } from '@iqworksai/consentiq-react';
 
 function SettingsPage() {
   const { showPreferenceCenter, resetConsent } = useConsentIQ();

package/dist/index.d.mts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+import React$1 from 'react';
 
 /**
  * ConsentIQ React SDK Types
  */
 type ConsentCategory = 'necessary' | 'analytics' | 'marketing' | 'preferences' | 'social';
-type ConsentMethod = 'banner' | 'preference_center' | 'api' | 'sdk';
+type ConsentMethod = 'banner' | 'preference_center' | 'api' | 'sdk' | 'form' | 'import' | 'offline';
 type BannerPosition = 'bottom' | 'bottom-left' | 'bottom-right' | 'top' | 'center';
 type BannerLayout = 'banner' | 'floating' | 'modal';
 type BannerTheme = 'light' | 'dark' | 'auto';
@@ -43,14 +43,26 @@ interface ConsentIQConfig {
     autoShow?: boolean;
     /** Custom language code (overrides auto-detection) */
     language?: string;
+    /** Alias for `language` — locale/language code to use as the default (e.g. site locale) */
+    locale?: string;
     /** Debug mode for development */
     debug?: boolean;
 }
+interface FormConsentSource {
+    selector: string | null;
+    isAutoResolved: boolean;
+    privacyNotice: {
+        id: string;
+        name: string;
+        type: string;
+    };
+}
 interface PropertyConfig {
     property: {
         id: string;
         name: string;
-        domain: string;
+        identifier: string;
+        platform: 'web' | 'ios' | 'android';
         defaultLanguage: string;
         supportedLanguages: string[];
     };
@@ -65,6 +77,8 @@ interface PropertyConfig {
     categories: CategoryInfo[];
     marketingChannels: MarketingChannelInfo[];
     geoRules: GeoRule[];
+    formConsentSources: FormConsentSource[];
+    privacyNoticeUrl: string | null;
     translations: Record<string, TranslationSet>;
 }
 interface CategoryInfo {
@@ -107,6 +121,36 @@ interface SavedConsent {
     regulationApplied: string;
     consentVersion?: string;
 }
+interface FormConsentProps {
+    propertyKey?: string;
+    apiUrl?: string;
+    subjectId: string;
+    subjectType?: 'visitor' | 'user' | 'subscriber';
+    mode?: 'granular' | 'simple';
+    simpleLabel?: string;
+    channels?: string[];
+    onConsentSubmitted?: (result: {
+        consentId: string;
+        proofHash: string;
+        consents: MarketingConsentState;
+    }) => void;
+    onConsentChange?: (consents: MarketingConsentState) => void;
+    autoSubmit?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    showDescriptions?: boolean;
+    showPrivacyLink?: boolean;
+    privacyLinkText?: string;
+    privacyUrl?: string;
+}
+interface FormConsentRef {
+    submit: () => Promise<{
+        consentId: string;
+        proofHash: string;
+    } | null>;
+    getConsents: () => MarketingConsentState;
+    reset: () => void;
+}
 interface ConsentIQContextValue {
     /** Current consent state */
     consent: ConsentState;
@@ -122,6 +166,10 @@ interface ConsentIQContextValue {
     isPreferenceCenterVisible: boolean;
     /** Current language */
     language: string;
+    /** Change the active display language (must be one of the property's supportedLanguages) */
+    changeLanguage: (language: string) => void;
+    /** Text direction derived from the active language ('rtl' for ar/he/fa/ur/…, else 'ltr') */
+    dir: 'ltr' | 'rtl';
     /** Detected regulation */
     regulation: string | null;
     /** Check if a specific category has consent */
@@ -149,9 +197,9 @@ interface ConsentIQContextValue {
 }
 
 interface ConsentIQProviderProps extends ConsentIQConfig {
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }
-declare function ConsentIQProvider({ children, propertyKey, apiUrl, subjectId: providedSubjectId, autoGenerateSubjectId, onConsentChange, onOpen, onClose, autoShow, language: preferredLanguage, debug, }: ConsentIQProviderProps): react_jsx_runtime.JSX.Element;
+declare function ConsentIQProvider({ children, propertyKey, apiUrl, subjectId: providedSubjectId, autoGenerateSubjectId, onConsentChange, onOpen, onClose, autoShow, language: preferredLanguage, locale, debug, }: ConsentIQProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access ConsentIQ context
  */
@@ -176,17 +224,95 @@ interface CookieBannerProps {
     /** Override banner theme */
     theme?: 'light' | 'dark' | 'auto';
     /** Custom styles */
-    style?: React.CSSProperties;
+    style?: React$1.CSSProperties;
 }
 declare function CookieBanner({ className, position, theme, style }: CookieBannerProps): react_jsx_runtime.JSX.Element | null;
 
+interface ConsentTriggerProps {
+    /** Custom class name for the trigger button */
+    className?: string;
+    /** Corner to anchor the trigger to */
+    position?: 'bottom-left' | 'bottom-right';
+    /** Override trigger theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Custom styles merged onto the button */
+    style?: React$1.CSSProperties;
+    /** Accessible label / tooltip text */
+    label?: string;
+}
+/**
+ * Persistent re-entry point for consent preferences.
+ *
+ * Renders a small fixed badge that reopens the Preference Center, giving users
+ * a way to change or withdraw consent after the banner is dismissed (required
+ * by GDPR/DPDPA). Hidden while the banner or Preference Center is open, so it
+ * only appears once a consent decision has been recorded.
+ */
+declare function ConsentTrigger({ className, position, theme, style, label, }: ConsentTriggerProps): react_jsx_runtime.JSX.Element | null;
+
+interface ConsentPageTriggerProps {
+    /** ConsentIQ origin, e.g. https://consent.iqworks.ai */
+    apiUrl: string;
+    /** The consent page's public token */
+    token: string;
+    /** popup = open in a modal iframe (default); redirect = navigate to the hosted page */
+    mode?: 'popup' | 'redirect';
+    /** redirect mode only: an allowlisted return URL */
+    redirect?: string;
+    onComplete?: (result: {
+        consentId?: string;
+        proofHash?: string;
+        email?: string;
+    }) => void;
+    onClose?: () => void;
+    className?: string;
+    style?: React$1.CSSProperties;
+    children?: React$1.ReactNode;
+}
+/**
+ * Opens a property's hosted consent page as a modal iframe popup (or a redirect),
+ * and reports completion. Standalone — does not require the cookie ConsentIQProvider.
+ */
+declare function ConsentPageTrigger({ apiUrl, token, mode, redirect, onComplete, onClose, className, style, children, }: ConsentPageTriggerProps): react_jsx_runtime.JSX.Element;
+
+interface ConsentFormProps {
+    /** ConsentIQ origin, e.g. https://consent.iqworks.ai */
+    apiUrl: string;
+    /** The consent page's public token (binding must have embed enabled) */
+    token: string;
+    /** If the host already knows the person's email, pass it to skip the email field */
+    email?: string;
+    onRecorded?: (result: {
+        consentId: string;
+        proofHash: string;
+    }) => void;
+    className?: string;
+}
+/**
+ * Renders a consent page's purposes as inline checkboxes on the host's own form and records
+ * consent via the embed API. Drop in on the specific forms that need inline consent — Stage 2.
+ */
+declare function ConsentForm({ apiUrl, token, email: initialEmail, onRecorded, className }: ConsentFormProps): react_jsx_runtime.JSX.Element;
+
+interface LanguageSelectorProps {
+    /** Custom class name */
+    className?: string;
+    /** Custom styles merged onto the select */
+    style?: React$1.CSSProperties;
+}
+/**
+ * Language switcher for the consent UI. Renders nothing when the property
+ * supports a single language, so callers can drop it in unconditionally.
+ */
+declare function LanguageSelector({ className, style }: LanguageSelectorProps): react_jsx_runtime.JSX.Element | null;
+
 interface PreferenceCenterProps {
     /** Custom class name */
     className?: string;
     /** Override theme */
     theme?: 'light' | 'dark' | 'auto';
     /** Custom styles */
-    style?: React.CSSProperties;
+    style?: React$1.CSSProperties;
 }
 declare function PreferenceCenter({ className, theme, style }: PreferenceCenterProps): react_jsx_runtime.JSX.Element | null;
 
@@ -194,11 +320,11 @@ interface ConsentGateProps {
     /** The consent category required to show children */
     category: ConsentCategory | string;
     /** Content to show when consent is granted */
-    children: React.ReactNode;
+    children: React$1.ReactNode;
     /** Content to show when consent is not granted (optional) */
-    fallback?: React.ReactNode;
+    fallback?: React$1.ReactNode;
     /** Content to show while loading (optional) */
-    loading?: React.ReactNode;
+    loading?: React$1.ReactNode;
 }
 /**
  * ConsentGate - Conditionally render content based on consent status
@@ -226,7 +352,59 @@ declare function ConsentGate({ category, children, fallback, loading, }: Consent
  * const ProtectedAnalytics = withConsentGate(GoogleAnalytics, 'analytics');
  * ```
  */
-declare function withConsentGate<P extends object>(Component: React.ComponentType<P>, category: ConsentCategory | string, FallbackComponent?: React.ComponentType<P>): (props: P) => react_jsx_runtime.JSX.Element | null;
+declare function withConsentGate<P extends object>(Component: React$1.ComponentType<P>, category: ConsentCategory | string, FallbackComponent?: React$1.ComponentType<P>): (props: P) => react_jsx_runtime.JSX.Element | null;
+
+declare const MarketingConsentForm: React$1.ForwardRefExoticComponent<FormConsentProps & React$1.RefAttributes<FormConsentRef>>;
+
+interface UseFormConsentOptions {
+    propertyKey: string;
+    apiUrl?: string;
+    subjectId: string;
+    subjectType?: 'visitor' | 'user' | 'subscriber';
+    debug?: boolean;
+}
+interface UseFormConsentReturn {
+    channels: MarketingChannelInfo[];
+    consents: MarketingConsentState;
+    privacyNoticeUrl: string | null;
+    lastSubmission: {
+        consentId: string;
+        proofHash: string;
+    } | null;
+    setConsent: (channel: string, value: boolean) => void;
+    setAllConsents: (value: boolean) => void;
+    submit: () => Promise<{
+        consentId: string;
+        proofHash: string;
+    } | null>;
+    isLoading: boolean;
+    isSubmitting: boolean;
+    error: string | null;
+}
+declare function useFormConsent(options: UseFormConsentOptions): UseFormConsentReturn;
+
+interface ConsentPurpose {
+    purpose_id: string;
+    label: string | null;
+    description: string | null;
+    data_items: string[] | null;
+    is_required: boolean;
+}
+interface RecordedConsent {
+    success: boolean;
+    consentId: string;
+    proofHash: string;
+}
+/**
+ * Fetches a consent page's purposes (for the host to render its own checkboxes) and records
+ * consent inline via the embed API — Stage 2 of the integration journey.
+ */
+declare function useConsentPurposes(apiUrl: string, token: string): {
+    purposes: ConsentPurpose[];
+    loading: boolean;
+    error: string | null;
+    record: (email: string, purposeConsents: Record<string, boolean>) => Promise<RecordedConsent>;
+};
 
 /**
  * ConsentIQ API Client
@@ -254,12 +432,12 @@ declare class ConsentIQApiClient {
     submitConsent(data: {
         subjectId: string;
         subjectType?: 'visitor' | 'user' | 'subscriber';
-        cookieConsents: ConsentState;
+        cookieConsents?: ConsentState;
         marketingConsents?: MarketingConsentState;
         geoCountry?: string;
         geoRegion?: string;
         geoSource?: 'ip' | 'user_override' | 'browser';
-        consentMethod?: 'banner' | 'preference_center' | 'api' | 'sdk';
+        consentMethod?: ConsentMethod;
         consentVersion?: string;
     }): Promise<{
         success: boolean;
@@ -295,4 +473,4 @@ declare function detectCountry(): string | undefined;
  */
 declare function detectLanguage(supportedLanguages: string[]): string;
 
-export { type BannerLayout, type BannerPosition, type BannerTheme, type CategoryInfo, type ConsentCategory, ConsentGate, type ConsentGateProps, ConsentIQApiClient, type ConsentIQConfig, type ConsentIQContextValue, ConsentIQProvider, type ConsentMethod, type ConsentState, CookieBanner, type CookieBannerProps, type GeoRule, type MarketingChannelInfo, type MarketingConsentState, PreferenceCenter, type PreferenceCenterProps, type PropertyConfig, type SavedConsent, type TranslationSet, detectCountry, detectLanguage, generateSubjectId, getOrCreateSubjectId, useConsent, useConsentGate, useConsentIQ, withConsentGate };
+export { type BannerLayout, type BannerPosition, type BannerTheme, type CategoryInfo, type ConsentCategory, ConsentForm, type ConsentFormProps, ConsentGate, type ConsentGateProps, ConsentIQApiClient, type ConsentIQConfig, type ConsentIQContextValue, ConsentIQProvider, type ConsentMethod, ConsentPageTrigger, type ConsentPageTriggerProps, type ConsentPurpose, type ConsentState, ConsentTrigger, type ConsentTriggerProps, CookieBanner, type CookieBannerProps, type FormConsentProps, type FormConsentRef, type FormConsentSource, type GeoRule, LanguageSelector, type LanguageSelectorProps, type MarketingChannelInfo, MarketingConsentForm, type MarketingConsentState, PreferenceCenter, type PreferenceCenterProps, type PropertyConfig, type RecordedConsent, type SavedConsent, type TranslationSet, detectCountry, detectLanguage, generateSubjectId, getOrCreateSubjectId, useConsent, useConsentGate, useConsentIQ, useConsentPurposes, useFormConsent, withConsentGate };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React from 'react';
+import React$1 from 'react';
 
 /**
  * ConsentIQ React SDK Types
  */
 type ConsentCategory = 'necessary' | 'analytics' | 'marketing' | 'preferences' | 'social';
-type ConsentMethod = 'banner' | 'preference_center' | 'api' | 'sdk';
+type ConsentMethod = 'banner' | 'preference_center' | 'api' | 'sdk' | 'form' | 'import' | 'offline';
 type BannerPosition = 'bottom' | 'bottom-left' | 'bottom-right' | 'top' | 'center';
 type BannerLayout = 'banner' | 'floating' | 'modal';
 type BannerTheme = 'light' | 'dark' | 'auto';
@@ -43,14 +43,26 @@ interface ConsentIQConfig {
     autoShow?: boolean;
     /** Custom language code (overrides auto-detection) */
     language?: string;
+    /** Alias for `language` — locale/language code to use as the default (e.g. site locale) */
+    locale?: string;
     /** Debug mode for development */
     debug?: boolean;
 }
+interface FormConsentSource {
+    selector: string | null;
+    isAutoResolved: boolean;
+    privacyNotice: {
+        id: string;
+        name: string;
+        type: string;
+    };
+}
 interface PropertyConfig {
     property: {
         id: string;
         name: string;
-        domain: string;
+        identifier: string;
+        platform: 'web' | 'ios' | 'android';
         defaultLanguage: string;
         supportedLanguages: string[];
     };
@@ -65,6 +77,8 @@ interface PropertyConfig {
     categories: CategoryInfo[];
     marketingChannels: MarketingChannelInfo[];
     geoRules: GeoRule[];
+    formConsentSources: FormConsentSource[];
+    privacyNoticeUrl: string | null;
     translations: Record<string, TranslationSet>;
 }
 interface CategoryInfo {
@@ -107,6 +121,36 @@ interface SavedConsent {
     regulationApplied: string;
     consentVersion?: string;
 }
+interface FormConsentProps {
+    propertyKey?: string;
+    apiUrl?: string;
+    subjectId: string;
+    subjectType?: 'visitor' | 'user' | 'subscriber';
+    mode?: 'granular' | 'simple';
+    simpleLabel?: string;
+    channels?: string[];
+    onConsentSubmitted?: (result: {
+        consentId: string;
+        proofHash: string;
+        consents: MarketingConsentState;
+    }) => void;
+    onConsentChange?: (consents: MarketingConsentState) => void;
+    autoSubmit?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    showDescriptions?: boolean;
+    showPrivacyLink?: boolean;
+    privacyLinkText?: string;
+    privacyUrl?: string;
+}
+interface FormConsentRef {
+    submit: () => Promise<{
+        consentId: string;
+        proofHash: string;
+    } | null>;
+    getConsents: () => MarketingConsentState;
+    reset: () => void;
+}
 interface ConsentIQContextValue {
     /** Current consent state */
     consent: ConsentState;
@@ -122,6 +166,10 @@ interface ConsentIQContextValue {
     isPreferenceCenterVisible: boolean;
     /** Current language */
     language: string;
+    /** Change the active display language (must be one of the property's supportedLanguages) */
+    changeLanguage: (language: string) => void;
+    /** Text direction derived from the active language ('rtl' for ar/he/fa/ur/…, else 'ltr') */
+    dir: 'ltr' | 'rtl';
     /** Detected regulation */
     regulation: string | null;
     /** Check if a specific category has consent */
@@ -149,9 +197,9 @@ interface ConsentIQContextValue {
 }
 
 interface ConsentIQProviderProps extends ConsentIQConfig {
-    children: React.ReactNode;
+    children: React$1.ReactNode;
 }
-declare function ConsentIQProvider({ children, propertyKey, apiUrl, subjectId: providedSubjectId, autoGenerateSubjectId, onConsentChange, onOpen, onClose, autoShow, language: preferredLanguage, debug, }: ConsentIQProviderProps): react_jsx_runtime.JSX.Element;
+declare function ConsentIQProvider({ children, propertyKey, apiUrl, subjectId: providedSubjectId, autoGenerateSubjectId, onConsentChange, onOpen, onClose, autoShow, language: preferredLanguage, locale, debug, }: ConsentIQProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Hook to access ConsentIQ context
  */
@@ -176,17 +224,95 @@ interface CookieBannerProps {
     /** Override banner theme */
     theme?: 'light' | 'dark' | 'auto';
     /** Custom styles */
-    style?: React.CSSProperties;
+    style?: React$1.CSSProperties;
 }
 declare function CookieBanner({ className, position, theme, style }: CookieBannerProps): react_jsx_runtime.JSX.Element | null;
 
+interface ConsentTriggerProps {
+    /** Custom class name for the trigger button */
+    className?: string;
+    /** Corner to anchor the trigger to */
+    position?: 'bottom-left' | 'bottom-right';
+    /** Override trigger theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Custom styles merged onto the button */
+    style?: React$1.CSSProperties;
+    /** Accessible label / tooltip text */
+    label?: string;
+}
+/**
+ * Persistent re-entry point for consent preferences.
+ *
+ * Renders a small fixed badge that reopens the Preference Center, giving users
+ * a way to change or withdraw consent after the banner is dismissed (required
+ * by GDPR/DPDPA). Hidden while the banner or Preference Center is open, so it
+ * only appears once a consent decision has been recorded.
+ */
+declare function ConsentTrigger({ className, position, theme, style, label, }: ConsentTriggerProps): react_jsx_runtime.JSX.Element | null;
+
+interface ConsentPageTriggerProps {
+    /** ConsentIQ origin, e.g. https://consent.iqworks.ai */
+    apiUrl: string;
+    /** The consent page's public token */
+    token: string;
+    /** popup = open in a modal iframe (default); redirect = navigate to the hosted page */
+    mode?: 'popup' | 'redirect';
+    /** redirect mode only: an allowlisted return URL */
+    redirect?: string;
+    onComplete?: (result: {
+        consentId?: string;
+        proofHash?: string;
+        email?: string;
+    }) => void;
+    onClose?: () => void;
+    className?: string;
+    style?: React$1.CSSProperties;
+    children?: React$1.ReactNode;
+}
+/**
+ * Opens a property's hosted consent page as a modal iframe popup (or a redirect),
+ * and reports completion. Standalone — does not require the cookie ConsentIQProvider.
+ */
+declare function ConsentPageTrigger({ apiUrl, token, mode, redirect, onComplete, onClose, className, style, children, }: ConsentPageTriggerProps): react_jsx_runtime.JSX.Element;
+
+interface ConsentFormProps {
+    /** ConsentIQ origin, e.g. https://consent.iqworks.ai */
+    apiUrl: string;
+    /** The consent page's public token (binding must have embed enabled) */
+    token: string;
+    /** If the host already knows the person's email, pass it to skip the email field */
+    email?: string;
+    onRecorded?: (result: {
+        consentId: string;
+        proofHash: string;
+    }) => void;
+    className?: string;
+}
+/**
+ * Renders a consent page's purposes as inline checkboxes on the host's own form and records
+ * consent via the embed API. Drop in on the specific forms that need inline consent — Stage 2.
+ */
+declare function ConsentForm({ apiUrl, token, email: initialEmail, onRecorded, className }: ConsentFormProps): react_jsx_runtime.JSX.Element;
+
+interface LanguageSelectorProps {
+    /** Custom class name */
+    className?: string;
+    /** Custom styles merged onto the select */
+    style?: React$1.CSSProperties;
+}
+/**
+ * Language switcher for the consent UI. Renders nothing when the property
+ * supports a single language, so callers can drop it in unconditionally.
+ */
+declare function LanguageSelector({ className, style }: LanguageSelectorProps): react_jsx_runtime.JSX.Element | null;
+
 interface PreferenceCenterProps {
     /** Custom class name */
     className?: string;
     /** Override theme */
     theme?: 'light' | 'dark' | 'auto';
     /** Custom styles */
-    style?: React.CSSProperties;
+    style?: React$1.CSSProperties;
 }
 declare function PreferenceCenter({ className, theme, style }: PreferenceCenterProps): react_jsx_runtime.JSX.Element | null;
 
@@ -194,11 +320,11 @@ interface ConsentGateProps {
     /** The consent category required to show children */
     category: ConsentCategory | string;
     /** Content to show when consent is granted */
-    children: React.ReactNode;
+    children: React$1.ReactNode;
     /** Content to show when consent is not granted (optional) */
-    fallback?: React.ReactNode;
+    fallback?: React$1.ReactNode;
     /** Content to show while loading (optional) */
-    loading?: React.ReactNode;
+    loading?: React$1.ReactNode;
 }
 /**
  * ConsentGate - Conditionally render content based on consent status
@@ -226,7 +352,59 @@ declare function ConsentGate({ category, children, fallback, loading, }: Consent
  * const ProtectedAnalytics = withConsentGate(GoogleAnalytics, 'analytics');
  * ```
  */
-declare function withConsentGate<P extends object>(Component: React.ComponentType<P>, category: ConsentCategory | string, FallbackComponent?: React.ComponentType<P>): (props: P) => react_jsx_runtime.JSX.Element | null;
+declare function withConsentGate<P extends object>(Component: React$1.ComponentType<P>, category: ConsentCategory | string, FallbackComponent?: React$1.ComponentType<P>): (props: P) => react_jsx_runtime.JSX.Element | null;
+
+declare const MarketingConsentForm: React$1.ForwardRefExoticComponent<FormConsentProps & React$1.RefAttributes<FormConsentRef>>;
+
+interface UseFormConsentOptions {
+    propertyKey: string;
+    apiUrl?: string;
+    subjectId: string;
+    subjectType?: 'visitor' | 'user' | 'subscriber';
+    debug?: boolean;
+}
+interface UseFormConsentReturn {
+    channels: MarketingChannelInfo[];
+    consents: MarketingConsentState;
+    privacyNoticeUrl: string | null;
+    lastSubmission: {
+        consentId: string;
+        proofHash: string;
+    } | null;
+    setConsent: (channel: string, value: boolean) => void;
+    setAllConsents: (value: boolean) => void;
+    submit: () => Promise<{
+        consentId: string;
+        proofHash: string;
+    } | null>;
+    isLoading: boolean;
+    isSubmitting: boolean;
+    error: string | null;
+}
+declare function useFormConsent(options: UseFormConsentOptions): UseFormConsentReturn;
+
+interface ConsentPurpose {
+    purpose_id: string;
+    label: string | null;
+    description: string | null;
+    data_items: string[] | null;
+    is_required: boolean;
+}
+interface RecordedConsent {
+    success: boolean;
+    consentId: string;
+    proofHash: string;
+}
+/**
+ * Fetches a consent page's purposes (for the host to render its own checkboxes) and records
+ * consent inline via the embed API — Stage 2 of the integration journey.
+ */
+declare function useConsentPurposes(apiUrl: string, token: string): {
+    purposes: ConsentPurpose[];
+    loading: boolean;
+    error: string | null;
+    record: (email: string, purposeConsents: Record<string, boolean>) => Promise<RecordedConsent>;
+};
 
 /**
  * ConsentIQ API Client
@@ -254,12 +432,12 @@ declare class ConsentIQApiClient {
     submitConsent(data: {
         subjectId: string;
         subjectType?: 'visitor' | 'user' | 'subscriber';
-        cookieConsents: ConsentState;
+        cookieConsents?: ConsentState;
         marketingConsents?: MarketingConsentState;
         geoCountry?: string;
         geoRegion?: string;
         geoSource?: 'ip' | 'user_override' | 'browser';
-        consentMethod?: 'banner' | 'preference_center' | 'api' | 'sdk';
+        consentMethod?: ConsentMethod;
         consentVersion?: string;
     }): Promise<{
         success: boolean;
@@ -295,4 +473,4 @@ declare function detectCountry(): string | undefined;
  */
 declare function detectLanguage(supportedLanguages: string[]): string;
 
-export { type BannerLayout, type BannerPosition, type BannerTheme, type CategoryInfo, type ConsentCategory, ConsentGate, type ConsentGateProps, ConsentIQApiClient, type ConsentIQConfig, type ConsentIQContextValue, ConsentIQProvider, type ConsentMethod, type ConsentState, CookieBanner, type CookieBannerProps, type GeoRule, type MarketingChannelInfo, type MarketingConsentState, PreferenceCenter, type PreferenceCenterProps, type PropertyConfig, type SavedConsent, type TranslationSet, detectCountry, detectLanguage, generateSubjectId, getOrCreateSubjectId, useConsent, useConsentGate, useConsentIQ, withConsentGate };
+export { type BannerLayout, type BannerPosition, type BannerTheme, type CategoryInfo, type ConsentCategory, ConsentForm, type ConsentFormProps, ConsentGate, type ConsentGateProps, ConsentIQApiClient, type ConsentIQConfig, type ConsentIQContextValue, ConsentIQProvider, type ConsentMethod, ConsentPageTrigger, type ConsentPageTriggerProps, type ConsentPurpose, type ConsentState, ConsentTrigger, type ConsentTriggerProps, CookieBanner, type CookieBannerProps, type FormConsentProps, type FormConsentRef, type FormConsentSource, type GeoRule, LanguageSelector, type LanguageSelectorProps, type MarketingChannelInfo, MarketingConsentForm, type MarketingConsentState, PreferenceCenter, type PreferenceCenterProps, type PropertyConfig, type RecordedConsent, type SavedConsent, type TranslationSet, detectCountry, detectLanguage, generateSubjectId, getOrCreateSubjectId, useConsent, useConsentGate, useConsentIQ, useConsentPurposes, useFormConsent, withConsentGate };