@monterosa/sdk-consent-kit 2.0.0-rc.2 → 2.0.0-rc.3

package/dist/index.cjs

@@ -0,0 +1,403 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var sdkLauncherKit = require('@monterosa/sdk-launcher-kit');
+var sdkUtil = require('@monterosa/sdk-util');
+
+/**
+ * @license
+ * @monterosa/sdk-consent-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Actions used for parent-child bridge communication.
+ *
+ * @internal
+ */
+var ConsentAction;
+(function (ConsentAction) {
+    /**
+     * Sent when consent state is updated.
+     */
+    ConsentAction["OnConsentUpdated"] = "consentOnConsentUpdated";
+    /**
+     * Request to set consent state from child to parent.
+     */
+    ConsentAction["SetConsent"] = "consentSetConsent";
+})(ConsentAction || (ConsentAction = {}));
+/**
+ * Internal event names for the consent emitter.
+ *
+ * @internal
+ */
+var ConsentEvent;
+(function (ConsentEvent) {
+    /**
+     * Emitted when consent state changes.
+     */
+    ConsentEvent["ConsentChanged"] = "consent_changed";
+})(ConsentEvent || (ConsentEvent = {}));
+/**
+ * Defines error codes that may be encountered when using the Consent kit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   setConsentState({ necessary: false });
+ * } catch (err) {
+ *   if (err.code === ConsentError.NecessaryCategoryRequired) {
+ *     // handle necessary category error
+ *   }
+ * }
+ * ```
+ */
+exports.ConsentError = void 0;
+(function (ConsentError) {
+    /**
+     * Indicates that the 'necessary' category cannot be set to false.
+     */
+    ConsentError["NecessaryCategoryRequired"] = "necessary_category_required";
+    /**
+     * Indicates that consent cannot be set from a child experience.
+     */
+    ConsentError["CannotSetFromChild"] = "cannot_set_from_child";
+})(exports.ConsentError || (exports.ConsentError = {}));
+/**
+ * Error messages for consent errors.
+ *
+ * @internal
+ */
+const ConsentErrorMessages = {
+    [exports.ConsentError.NecessaryCategoryRequired]: () => "Cannot set 'necessary' category to false. Strictly necessary functionality cannot be disabled.",
+    [exports.ConsentError.CannotSetFromChild]: () => 'Cannot set consent state from embedded experience. Consent is managed by the parent application.',
+};
+
+/**
+ * @license
+ * @monterosa/sdk-consent-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Internal Consent class that manages consent state.
+ *
+ * @internal
+ */
+class Consent extends sdkUtil.Emitter {
+    /**
+     * The current consent state.
+     * Setting this value will automatically emit ConsentChanged event if the state
+     *  actually changed.
+     */
+    get state() {
+        return this._state;
+    }
+    set state(value) {
+        const previousState = this._state;
+        this._state = value;
+        // Only emit if state changed to a non-null value
+        if (value !== null && !Consent.isConsentStateEqual(previousState, value)) {
+            this.emit(ConsentEvent.ConsentChanged, value);
+        }
+    }
+    /**
+     * Whether consent mode is active.
+     * Returns true when state has been set.
+     */
+    get isActive() {
+        return this._state !== null;
+    }
+    constructor() {
+        super();
+        this._state = null;
+    }
+    /**
+     * Compare two consent states for equality.
+     *
+     * @param a - First consent state (or null)
+     * @param b - Second consent state (or null)
+     * @returns Whether the states are equal
+     */
+    static isConsentStateEqual(a, b) {
+        if (a === null && b === null)
+            return true;
+        if (a === null || b === null)
+            return false;
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        const aRecord = a;
+        const bRecord = b;
+        return keysA.every((key) => aRecord[key] === bRecord[key]);
+    }
+    /**
+     * Get the singleton instance of the Consent class.
+     *
+     * @returns The Consent singleton instance.
+     */
+    static getInstance() {
+        if (!Consent.instance) {
+            Consent.instance = new Consent();
+        }
+        return Consent.instance;
+    }
+}
+
+/**
+ * @license
+ * @monterosa/sdk-consent-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+const consentHooks = [];
+let hooksRegistered = false;
+/**
+ * Get the consent kit instance.
+ *
+ * @returns The consent kit instance.
+ *
+ * @internal
+ */
+function getConsent() {
+    const consent = Consent.getInstance();
+    if (!hooksRegistered) {
+        // Register hooks only once
+        for (const hook of consentHooks) {
+            hook(consent);
+        }
+        hooksRegistered = true;
+    }
+    return consent;
+}
+/**
+ * Register a hook that will be called when consent is initialised.
+ *
+ * @param hook - The hook function to register.
+ *
+ * @internal
+ */
+function registerConsentHook(hook) {
+    consentHooks.push(hook);
+}
+/**
+ * Set the consent state.
+ *
+ * @remarks
+ * - The 'necessary' category cannot be set to false
+ * - Cannot be called from a child experience (use parent application instead)
+ *
+ * @example
+ * ```typescript
+ * setConsentState({
+ *   necessary: true,
+ *   analytics: true,
+ *   marketing: false,
+ *   functional: true,
+ * });
+ * ```
+ *
+ * @param state - The consent state to set
+ * @throws {MonterosaError} If called from a child experience
+ * @throws {MonterosaError} If 'necessary' category is set to false
+ */
+function setConsentState(state) {
+    const parentApp = sdkLauncherKit.getParentApplication();
+    // Cannot set consent from a child experience
+    if (parentApp !== null) {
+        throw new sdkUtil.MonterosaError(exports.ConsentError.CannotSetFromChild, ConsentErrorMessages[exports.ConsentError.CannotSetFromChild]());
+    }
+    // Necessary category cannot be false
+    if ('necessary' in state && state.necessary === false) {
+        throw new sdkUtil.MonterosaError(exports.ConsentError.NecessaryCategoryRequired, ConsentErrorMessages[exports.ConsentError.NecessaryCategoryRequired]());
+    }
+    const consent = getConsent();
+    consent.state = state;
+}
+/**
+ * Get the current consent state.
+ *
+ * @example
+ * ```typescript
+ * const state = getConsentState();
+ * if (state.analytics) {
+ *   // Analytics consent granted
+ * }
+ * ```
+ *
+ * @returns The current consent state, or empty object if consent mode not active
+ */
+function getConsentState() {
+    var _a;
+    return ((_a = getConsent().state) !== null && _a !== void 0 ? _a : {});
+}
+/**
+ * Check if consent is granted for a specific category.
+ *
+ * @remarks
+ * - The 'necessary' category always returns true
+ * - Returns true if consent mode is not active (backwards compatibility)
+ * - Returns false for missing keys when consent mode is active (GDPR strict opt-in)
+ * - Returns the boolean value if the category exists in consent state
+ *
+ * @example
+ * ```typescript
+ * if (hasConsent('analytics')) {
+ *   // Track analytics event
+ * }
+ * ```
+ *
+ * @param category - The consent category to check
+ * @returns Whether consent is granted for the category
+ */
+function hasConsent(category) {
+    var _a;
+    // 'necessary' always returns true
+    if (category === 'necessary') {
+        return true;
+    }
+    const consent = getConsent();
+    // If consent mode not active, allow everything (backwards compatibility)
+    if (!consent.isActive) {
+        return true;
+    }
+    // GDPR strict opt-in: missing keys default to false
+    return (((_a = consent.state) === null || _a === void 0 ? void 0 : _a[category]) === true);
+}
+/**
+ * Subscribe to consent state changes.
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = onConsentChanged((state) => {
+ *   console.log('Consent changed:', state);
+ * });
+ *
+ * // Later, to stop listening:
+ * unsubscribe();
+ * ```
+ *
+ * @param callback - The callback to call when consent state changes
+ * @returns A function to unsubscribe from the event
+ */
+function onConsentChanged(callback) {
+    const consent = getConsent();
+    return consent.on(ConsentEvent.ConsentChanged, callback);
+}
+/**
+ * Update consent state from parent (used internally by bridge).
+ *
+ * @param state - The consent state received from parent
+ *
+ * @internal
+ */
+function updateConsentFromParent(state) {
+    const consent = getConsent();
+    consent.state = state;
+}
+
+/**
+ * @license
+ * @monterosa/sdk-consent-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+const experienceUnsubs = new Map();
+/**
+ * Handle when an experience is embedded.
+ * Sends current consent state to the child (queued by the bridge until
+ * the experience is initialised) and subscribes to consent changes.
+ *
+ * @param experience - The embedded experience
+ *
+ * @internal
+ */
+function handleExperienceEmbedded(experience) {
+    const consent = getConsent();
+    // Send current consent state if active.
+    // The bridge queues this message until the experience is initialised.
+    if (consent.isActive) {
+        sdkLauncherKit.sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {
+            state: consent.state,
+        });
+    }
+    // Subscribe to consent changes and push to child
+    const consentChangedUnsub = onConsentChanged((state) => {
+        sdkLauncherKit.sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {
+            state,
+        });
+    });
+    experienceUnsubs.set(experience.id, [consentChangedUnsub]);
+}
+/**
+ * Handle when an experience is unmounted.
+ * Cleans up subscriptions for the experience.
+ *
+ * @param experience - The unmounted experience
+ *
+ * @internal
+ */
+function handleExperienceUnmounted(experience) {
+    const unsubs = experienceUnsubs.get(experience.id);
+    if (unsubs) {
+        for (const unsub of unsubs) {
+            unsub();
+        }
+        experienceUnsubs.delete(experience.id);
+    }
+}
+/**
+ * Hook to listen for consent messages from parent application.
+ * This is called when consent-kit is initialised in a child Experience.
+ *
+ * @param consent - The consent kit instance
+ * @returns Unsubscribe function
+ *
+ * @internal
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function parentMessagesHook(consent) {
+    const parentApp = sdkLauncherKit.getParentApplication();
+    if (parentApp === null) {
+        return () => { };
+    }
+    return sdkLauncherKit.onSdkMessage(parentApp, (message) => {
+        if (message.action === ConsentAction.OnConsentUpdated) {
+            const { state } = message.payload;
+            updateConsentFromParent(state);
+        }
+    });
+}
+
+/**
+ * Manages user consent state between the parent page and embedded Experiences.
+ *
+ * @packageDocumentation
+ */
+// Register bridge handlers for parent-child communication
+sdkLauncherKit.onStateChanged((experience, state) => {
+    if (state === 'mounted') {
+        handleExperienceEmbedded(experience);
+    }
+    else if (state === 'unmounted') {
+        handleExperienceUnmounted(experience);
+    }
+});
+// Register hook for child experiences to receive consent from parent
+registerConsentHook(parentMessagesHook);
+
+exports.getConsentState = getConsentState;
+exports.hasConsent = hasConsent;
+exports.onConsentChanged = onConsentChanged;
+exports.setConsentState = setConsentState;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/types.ts","../src/consent.ts","../src/api.ts","../src/bridge.ts","../src/index.ts"],"sourcesContent":["/**\n * @license\n * @monterosa/sdk-consent-kit\n *\n * Copyright © 2026 Monterosa Productions Limited. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { Emitter, Unsubscribe } from '@monterosa/sdk-util';\n\n/**\n * Default consent categories commonly used for GDPR/privacy compliance.\n *\n * @remarks\n * - `necessary` - Essential cookies/tracking required for the site to function\n * - `analytics` - Analytics and performance tracking\n * - `marketing` - Marketing and advertising tracking\n * - `functional` - User preference and personalization tracking\n */\nexport type DefaultCategory =\n  | 'necessary'\n  | 'analytics'\n  | 'marketing'\n  | 'functional';\n\n/**\n * Represents the consent state for each category.\n * Maps category names to boolean values indicating whether consent is granted.\n *\n * @typeParam T - The type of category keys, defaults to DefaultCategory\n *\n * @example\n * ```typescript\n * const state: ConsentState = {\n *   necessary: true,\n *   analytics: false,\n *   marketing: false,\n *   preferences: true,\n * };\n * ```\n */\nexport type ConsentState<T extends string = DefaultCategory> = {\n  [K in T]?: boolean;\n};\n\n/**\n * Actions used for parent-child bridge communication.\n *\n * @internal\n */\nexport enum ConsentAction {\n  /**\n   * Sent when consent state is updated.\n   */\n  OnConsentUpdated = 'consentOnConsentUpdated',\n  /**\n   * Request to set consent state from child to parent.\n   */\n  SetConsent = 'consentSetConsent',\n}\n\n/**\n * Internal event names for the consent emitter.\n *\n * @internal\n */\nexport enum ConsentEvent {\n  /**\n   * Emitted when consent state changes.\n   */\n  ConsentChanged = 'consent_changed',\n}\n\n/**\n * Defines error codes that may be encountered when using the Consent kit.\n *\n * @example\n * ```typescript\n * try {\n *   setConsentState({ necessary: false });\n * } catch (err) {\n *   if (err.code === ConsentError.NecessaryCategoryRequired) {\n *     // handle necessary category error\n *   }\n * }\n * ```\n */\nexport enum ConsentError {\n  /**\n   * Indicates that the 'necessary' category cannot be set to false.\n   */\n  NecessaryCategoryRequired = 'necessary_category_required',\n  /**\n   * Indicates that consent cannot be set from a child experience.\n   */\n  CannotSetFromChild = 'cannot_set_from_child',\n}\n\n/**\n * Error messages for consent errors.\n *\n * @internal\n */\nexport const ConsentErrorMessages = {\n  [ConsentError.NecessaryCategoryRequired]: () =>\n    \"Cannot set 'necessary' category to false. Strictly necessary functionality cannot be disabled.\",\n  [ConsentError.CannotSetFromChild]: () =>\n    'Cannot set consent state from embedded experience. Consent is managed by the parent application.',\n};\n\n/**\n * Hook function type for registering consent hooks.\n *\n * @internal\n */\nexport type ConsentHook = (consent: ConsentKit) => Unsubscribe;\n\n/**\n * The ConsentKit interface provides properties and methods\n * for managing user consent state.\n *\n * @internal\n */\nexport interface ConsentKit extends Emitter {\n  /**\n   * Whether consent mode is active.\n   * Returns true when state has been set.\n   */\n  readonly isActive: boolean;\n  /**\n   * The current consent state.\n   */\n  state: ConsentState | null;\n}\n","/**\n * @license\n * @monterosa/sdk-consent-kit\n *\n * Copyright © 2026 Monterosa Productions Limited. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { Emitter } from '@monterosa/sdk-util';\n\nimport { ConsentKit, ConsentState, ConsentEvent } from './types';\n\n/**\n * Internal Consent class that manages consent state.\n *\n * @internal\n */\nexport class Consent extends Emitter implements ConsentKit {\n  private static instance: Consent;\n\n  private _state: ConsentState | null = null;\n\n  /**\n   * The current consent state.\n   * Setting this value will automatically emit ConsentChanged event if the state\n   *  actually changed.\n   */\n  get state(): ConsentState | null {\n    return this._state;\n  }\n\n  set state(value: ConsentState | null) {\n    const previousState = this._state;\n    this._state = value;\n\n    // Only emit if state changed to a non-null value\n    if (value !== null && !Consent.isConsentStateEqual(previousState, value)) {\n      this.emit(ConsentEvent.ConsentChanged, value);\n    }\n  }\n\n  /**\n   * Whether consent mode is active.\n   * Returns true when state has been set.\n   */\n  get isActive(): boolean {\n    return this._state !== null;\n  }\n\n  private constructor() {\n    super();\n  }\n\n  /**\n   * Compare two consent states for equality.\n   *\n   * @param a - First consent state (or null)\n   * @param b - Second consent state (or null)\n   * @returns Whether the states are equal\n   */\n  private static isConsentStateEqual<T extends string = string>(\n    a: ConsentState<T> | null,\n    b: ConsentState<T> | null,\n  ): boolean {\n    if (a === null && b === null) return true;\n    if (a === null || b === null) return false;\n\n    const keysA = Object.keys(a);\n    const keysB = Object.keys(b);\n\n    if (keysA.length !== keysB.length) return false;\n\n    const aRecord = a as Record<string, boolean | undefined>;\n    const bRecord = b as Record<string, boolean | undefined>;\n\n    return keysA.every((key) => aRecord[key] === bRecord[key]);\n  }\n\n  /**\n   * Get the singleton instance of the Consent class.\n   *\n   * @returns The Consent singleton instance.\n   */\n  public static getInstance(): Consent {\n    if (!Consent.instance) {\n      Consent.instance = new Consent();\n    }\n\n    return Consent.instance;\n  }\n}\n","/**\n * @license\n * @monterosa/sdk-consent-kit\n *\n * Copyright © 2026 Monterosa Productions Limited. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { Unsubscribe, MonterosaError } from '@monterosa/sdk-util';\nimport { getParentApplication } from '@monterosa/sdk-launcher-kit';\n\nimport {\n  ConsentState,\n  ConsentKit,\n  ConsentEvent,\n  ConsentError,\n  ConsentErrorMessages,\n  ConsentHook,\n} from './types';\n\nimport { Consent } from './consent';\n\nconst consentHooks: ConsentHook[] = [];\nlet hooksRegistered = false;\n\n/**\n * Get the consent kit instance.\n *\n * @returns The consent kit instance.\n *\n * @internal\n */\nexport function getConsent(): ConsentKit {\n  const consent = Consent.getInstance();\n\n  if (!hooksRegistered) {\n    // Register hooks only once\n    for (const hook of consentHooks) {\n      hook(consent);\n    }\n\n    hooksRegistered = true;\n  }\n\n  return consent;\n}\n\n/**\n * Register a hook that will be called when consent is initialised.\n *\n * @param hook - The hook function to register.\n *\n * @internal\n */\nexport function registerConsentHook(hook: ConsentHook): void {\n  consentHooks.push(hook);\n}\n\n/**\n * Set the consent state.\n *\n * @remarks\n * - The 'necessary' category cannot be set to false\n * - Cannot be called from a child experience (use parent application instead)\n *\n * @example\n * ```typescript\n * setConsentState({\n *   necessary: true,\n *   analytics: true,\n *   marketing: false,\n *   functional: true,\n * });\n * ```\n *\n * @param state - The consent state to set\n * @throws {MonterosaError} If called from a child experience\n * @throws {MonterosaError} If 'necessary' category is set to false\n */\nexport function setConsentState<T extends string = string>(\n  state: ConsentState<T>,\n): void {\n  const parentApp = getParentApplication();\n\n  // Cannot set consent from a child experience\n  if (parentApp !== null) {\n    throw new MonterosaError(\n      ConsentError.CannotSetFromChild,\n      ConsentErrorMessages[ConsentError.CannotSetFromChild](),\n    );\n  }\n\n  // Necessary category cannot be false\n  if ('necessary' in state && state.necessary === false) {\n    throw new MonterosaError(\n      ConsentError.NecessaryCategoryRequired,\n      ConsentErrorMessages[ConsentError.NecessaryCategoryRequired](),\n    );\n  }\n\n  const consent = getConsent();\n  consent.state = state;\n}\n\n/**\n * Get the current consent state.\n *\n * @example\n * ```typescript\n * const state = getConsentState();\n * if (state.analytics) {\n *   // Analytics consent granted\n * }\n * ```\n *\n * @returns The current consent state, or empty object if consent mode not active\n */\nexport function getConsentState<T extends string = string>(): ConsentState<T> {\n  return (getConsent().state ?? {}) as ConsentState<T>;\n}\n\n/**\n * Check if consent is granted for a specific category.\n *\n * @remarks\n * - The 'necessary' category always returns true\n * - Returns true if consent mode is not active (backwards compatibility)\n * - Returns false for missing keys when consent mode is active (GDPR strict opt-in)\n * - Returns the boolean value if the category exists in consent state\n *\n * @example\n * ```typescript\n * if (hasConsent('analytics')) {\n *   // Track analytics event\n * }\n * ```\n *\n * @param category - The consent category to check\n * @returns Whether consent is granted for the category\n */\nexport function hasConsent(category: string): boolean {\n  // 'necessary' always returns true\n  if (category === 'necessary') {\n    return true;\n  }\n\n  const consent = getConsent();\n\n  // If consent mode not active, allow everything (backwards compatibility)\n  if (!consent.isActive) {\n    return true;\n  }\n\n  // GDPR strict opt-in: missing keys default to false\n  return (\n    (consent.state as Record<string, boolean | undefined>)?.[category] === true\n  );\n}\n\n/**\n * Subscribe to consent state changes.\n *\n * @example\n * ```typescript\n * const unsubscribe = onConsentChanged((state) => {\n *   console.log('Consent changed:', state);\n * });\n *\n * // Later, to stop listening:\n * unsubscribe();\n * ```\n *\n * @param callback - The callback to call when consent state changes\n * @returns A function to unsubscribe from the event\n */\nexport function onConsentChanged<T extends string = string>(\n  callback: (state: ConsentState<T>) => void,\n): Unsubscribe {\n  const consent = getConsent();\n\n  return consent.on(ConsentEvent.ConsentChanged, callback);\n}\n\n/**\n * Update consent state from parent (used internally by bridge).\n *\n * @param state - The consent state received from parent\n *\n * @internal\n */\nexport function updateConsentFromParent<T extends string = string>(\n  state: ConsentState<T>,\n): void {\n  const consent = getConsent();\n  consent.state = state;\n}\n","/**\n * @license\n * @monterosa/sdk-consent-kit\n *\n * Copyright © 2026 Monterosa Productions Limited. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { Unsubscribe } from '@monterosa/sdk-util';\nimport {\n  Experience,\n  Message,\n  getParentApplication,\n  onSdkMessage,\n  sendSdkMessage,\n} from '@monterosa/sdk-launcher-kit';\n\nimport { ConsentKit, ConsentState, ConsentAction } from './types';\n\nimport { getConsent, onConsentChanged, updateConsentFromParent } from './api';\n\nconst experienceUnsubs = new Map<string, Unsubscribe[]>();\n\n/**\n * Handle when an experience is embedded.\n * Sends current consent state to the child (queued by the bridge until\n * the experience is initialised) and subscribes to consent changes.\n *\n * @param experience - The embedded experience\n *\n * @internal\n */\nexport function handleExperienceEmbedded(experience: Experience): void {\n  const consent = getConsent();\n\n  // Send current consent state if active.\n  // The bridge queues this message until the experience is initialised.\n  if (consent.isActive) {\n    sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {\n      state: consent.state,\n    });\n  }\n\n  // Subscribe to consent changes and push to child\n  const consentChangedUnsub = onConsentChanged((state) => {\n    sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {\n      state,\n    });\n  });\n\n  experienceUnsubs.set(experience.id, [consentChangedUnsub]);\n}\n\n/**\n * Handle when an experience is unmounted.\n * Cleans up subscriptions for the experience.\n *\n * @param experience - The unmounted experience\n *\n * @internal\n */\nexport function handleExperienceUnmounted(experience: Experience): void {\n  const unsubs = experienceUnsubs.get(experience.id);\n\n  if (unsubs) {\n    for (const unsub of unsubs) {\n      unsub();\n    }\n\n    experienceUnsubs.delete(experience.id);\n  }\n}\n\n/**\n * Hook to listen for consent messages from parent application.\n * This is called when consent-kit is initialised in a child Experience.\n *\n * @param consent - The consent kit instance\n * @returns Unsubscribe function\n *\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function parentMessagesHook(consent: ConsentKit): Unsubscribe {\n  const parentApp = getParentApplication();\n\n  if (parentApp === null) {\n    return () => {};\n  }\n\n  return onSdkMessage(parentApp, (message: Message) => {\n    if (message.action === ConsentAction.OnConsentUpdated) {\n      const { state } = message.payload as { state: ConsentState };\n\n      updateConsentFromParent(state);\n    }\n  });\n}\n","/**\n * Manages user consent state between the parent page and embedded Experiences.\n *\n * @packageDocumentation\n */\n\n/**\n * @license\n * @monterosa/sdk-consent-kit\n *\n * Copyright © 2026 Monterosa Productions Limited. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { onStateChanged } from '@monterosa/sdk-launcher-kit';\n\nimport {\n  handleExperienceEmbedded,\n  handleExperienceUnmounted,\n  parentMessagesHook,\n} from './bridge';\n\nimport { registerConsentHook } from './api';\n\n// Register bridge handlers for parent-child communication\nonStateChanged((experience, state) => {\n  if (state === 'mounted') {\n    handleExperienceEmbedded(experience);\n  } else if (state === 'unmounted') {\n    handleExperienceUnmounted(experience);\n  }\n});\n\n// Register hook for child experiences to receive consent from parent\nregisterConsentHook(parentMessagesHook);\n\n// Public API exports\nexport {\n  setConsentState,\n  getConsentState,\n  hasConsent,\n  onConsentChanged,\n} from './api';\n\n// Type exports\nexport { DefaultCategory, ConsentState, ConsentError } from './types';\n"],"names":["ConsentError","Emitter","getParentApplication","MonterosaError","sendSdkMessage","onSdkMessage","onStateChanged"],"mappings":"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"}

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@monterosa/sdk-consent-kit",
-  "version": "2.0.0-rc.2",
+  "version": "2.0.0-rc.3",
   "description": "Consent Kit for the Monterosa JS SDK",
   "author": "Monterosa Productions Limited <hello@monterosa.co.uk> (https://www.monterosa.co/)",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
     }
   },
   "files": [
@@ -31,8 +32,8 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@monterosa/sdk-launcher-kit": "2.0.0-rc.2",
-    "@monterosa/sdk-util": "2.0.0-rc.2"
+    "@monterosa/sdk-launcher-kit": "2.0.0-rc.3",
+    "@monterosa/sdk-util": "2.0.0-rc.3"
   },
   "devDependencies": {
     "@faker-js/faker": "^6.3.1",
@@ -52,5 +53,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0e2d4cd71055bf0ab38ec5a73d6040c55151da1c"
+  "gitHead": "d692ad26af0b5ea7cd7b664168bffa069f9ab911"
 }