@monterosa/sdk-consent-kit 2.0.0-rc.1

package/dist/api.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @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
+ */
+import { Unsubscribe } from '@monterosa/sdk-util';
+import { ConsentState, ConsentKit, ConsentHook } from './types';
+/**
+ * Get the consent kit instance.
+ *
+ * @returns The consent kit instance.
+ *
+ * @internal
+ */
+export declare function getConsent(): ConsentKit;
+/**
+ * Register a hook that will be called when consent is initialized.
+ *
+ * @param hook - The hook function to register.
+ *
+ * @internal
+ */
+export declare function registerConsentHook(hook: ConsentHook): void;
+/**
+ * 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
+ */
+export declare function setConsentState<T extends string = string>(state: ConsentState<T>): void;
+/**
+ * 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
+ */
+export declare function getConsentState<T extends string = string>(): ConsentState<T>;
+/**
+ * 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
+ */
+export declare function hasConsent(category: string): boolean;
+/**
+ * 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
+ */
+export declare function onConsentChanged<T extends string = string>(callback: (state: ConsentState<T>) => void): Unsubscribe;
+/**
+ * Update consent state from parent (used internally by bridge).
+ *
+ * @param state - The consent state received from parent
+ *
+ * @internal
+ */
+export declare function updateConsentFromParent<T extends string = string>(state: ConsentState<T>): void;

package/dist/bridge.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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
+ */
+import { Unsubscribe } from '@monterosa/sdk-util';
+import { Experience } from '@monterosa/sdk-launcher-kit';
+import { ConsentKit } from './types';
+/**
+ * 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
+ */
+export declare function handleExperienceEmbedded(experience: Experience): void;
+/**
+ * Handle when an experience is unmounted.
+ * Cleans up subscriptions for the experience.
+ *
+ * @param experience - The unmounted experience
+ *
+ * @internal
+ */
+export declare function handleExperienceUnmounted(experience: Experience): void;
+/**
+ * Hook to listen for consent messages from parent application.
+ * This is called when consent-kit is initialized in a child experience.
+ *
+ * @param consent - The consent kit instance
+ * @returns Unsubscribe function
+ *
+ * @internal
+ */
+export declare function parentMessagesHook(consent: ConsentKit): Unsubscribe;

package/dist/consent.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @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
+ */
+import { Emitter } from '@monterosa/sdk-util';
+import { ConsentKit, ConsentState } from './types';
+/**
+ * Internal Consent class that manages consent state.
+ *
+ * @internal
+ */
+export declare class Consent extends Emitter implements ConsentKit {
+    private static instance;
+    private _state;
+    /**
+     * The current consent state.
+     * Setting this value will automatically emit ConsentChanged event if the state
+     *  actually changed.
+     */
+    get state(): ConsentState | null;
+    set state(value: ConsentState | null);
+    /**
+     * Whether consent mode is active.
+     * Returns true when state has been set.
+     */
+    get isActive(): boolean;
+    private constructor();
+    /**
+     * 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
+     */
+    private static isConsentStateEqual;
+    /**
+     * Get the singleton instance of the Consent class.
+     *
+     * @returns The Consent singleton instance.
+     */
+    static getInstance(): Consent;
+}

package/dist/index.cjs.js

@@ -0,0 +1,460 @@
+'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
+ */
+var _a;
+/**
+ * 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
+ */
+var ConsentErrorMessages = (_a = {},
+    _a[exports.ConsentError.NecessaryCategoryRequired] = function () {
+        return "Cannot set 'necessary' category to false. Strictly necessary functionality cannot be disabled.";
+    },
+    _a[exports.ConsentError.CannotSetFromChild] = function () {
+        return 'Cannot set consent state from embedded experience. Consent is managed by the parent application.';
+    },
+    _a);
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+var extendStatics = function(d, b) {
+    extendStatics = Object.setPrototypeOf ||
+        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+    return extendStatics(d, b);
+};
+
+function __extends(d, b) {
+    if (typeof b !== "function" && b !== null)
+        throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+    extendStatics(d, b);
+    function __() { this.constructor = d; }
+    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+/**
+ * @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
+ */
+var Consent = /** @class */ (function (_super) {
+    __extends(Consent, _super);
+    function Consent() {
+        var _this = _super.call(this) || this;
+        _this._state = null;
+        return _this;
+    }
+    Object.defineProperty(Consent.prototype, "state", {
+        /**
+         * The current consent state.
+         * Setting this value will automatically emit ConsentChanged event if the state
+         *  actually changed.
+         */
+        get: function () {
+            return this._state;
+        },
+        set: function (value) {
+            var 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);
+            }
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Consent.prototype, "isActive", {
+        /**
+         * Whether consent mode is active.
+         * Returns true when state has been set.
+         */
+        get: function () {
+            return this._state !== null;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * 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
+     */
+    Consent.isConsentStateEqual = function (a, b) {
+        if (a === null && b === null)
+            return true;
+        if (a === null || b === null)
+            return false;
+        var keysA = Object.keys(a);
+        var keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        var aRecord = a;
+        var bRecord = b;
+        return keysA.every(function (key) { return aRecord[key] === bRecord[key]; });
+    };
+    /**
+     * Get the singleton instance of the Consent class.
+     *
+     * @returns The Consent singleton instance.
+     */
+    Consent.getInstance = function () {
+        if (!Consent.instance) {
+            Consent.instance = new Consent();
+        }
+        return Consent.instance;
+    };
+    return Consent;
+}(sdkUtil.Emitter));
+
+/**
+ * @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
+ */
+var consentHooks = [];
+var hooksRegistered = false;
+/**
+ * Get the consent kit instance.
+ *
+ * @returns The consent kit instance.
+ *
+ * @internal
+ */
+function getConsent() {
+    var consent = Consent.getInstance();
+    if (!hooksRegistered) {
+        // Register hooks only once
+        for (var _i = 0, consentHooks_1 = consentHooks; _i < consentHooks_1.length; _i++) {
+            var hook = consentHooks_1[_i];
+            hook(consent);
+        }
+        hooksRegistered = true;
+    }
+    return consent;
+}
+/**
+ * Register a hook that will be called when consent is initialized.
+ *
+ * @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) {
+    var 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]());
+    }
+    var 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;
+    }
+    var 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) {
+    var 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) {
+    var 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
+ */
+var 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) {
+    var 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
+    var consentChangedUnsub = onConsentChanged(function (state) {
+        sdkLauncherKit.sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {
+            state: 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) {
+    var unsubs = experienceUnsubs.get(experience.id);
+    if (unsubs) {
+        for (var _i = 0, unsubs_1 = unsubs; _i < unsubs_1.length; _i++) {
+            var unsub = unsubs_1[_i];
+            unsub();
+        }
+        experienceUnsubs.delete(experience.id);
+    }
+}
+/**
+ * Hook to listen for consent messages from parent application.
+ * This is called when consent-kit is initialized 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) {
+    var parentApp = sdkLauncherKit.getParentApplication();
+    if (parentApp === null) {
+        return function () { };
+    }
+    return sdkLauncherKit.onSdkMessage(parentApp, function (message) {
+        if (message.action === ConsentAction.OnConsentUpdated) {
+            var state = message.payload.state;
+            updateConsentFromParent(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
+ */
+// Register bridge handlers for parent-child communication
+sdkLauncherKit.onStateChanged(function (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.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","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 initialized.\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 initialized 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 * @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\n/**\n * Monterosa SDK / Consent Kit\n *\n * @packageDocumentation\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/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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
+ */
+export { setConsentState, getConsentState, hasConsent, onConsentChanged, } from './api';
+export { DefaultCategory, ConsentState, ConsentError } from './types';

package/dist/index.esm.js

@@ -0,0 +1,399 @@
+import { getParentApplication, sendSdkMessage, onSdkMessage, onStateChanged } from '@monterosa/sdk-launcher-kit';
+import { Emitter, MonterosaError } from '@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
+ *   }
+ * }
+ * ```
+ */
+var ConsentError;
+(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";
+})(ConsentError || (ConsentError = {}));
+/**
+ * Error messages for consent errors.
+ *
+ * @internal
+ */
+const ConsentErrorMessages = {
+    [ConsentError.NecessaryCategoryRequired]: () => "Cannot set 'necessary' category to false. Strictly necessary functionality cannot be disabled.",
+    [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 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 initialized.
+ *
+ * @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 = getParentApplication();
+    // Cannot set consent from a child experience
+    if (parentApp !== null) {
+        throw new MonterosaError(ConsentError.CannotSetFromChild, ConsentErrorMessages[ConsentError.CannotSetFromChild]());
+    }
+    // Necessary category cannot be false
+    if ('necessary' in state && state.necessary === false) {
+        throw new MonterosaError(ConsentError.NecessaryCategoryRequired, ConsentErrorMessages[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) {
+        sendSdkMessage(experience, ConsentAction.OnConsentUpdated, {
+            state: consent.state,
+        });
+    }
+    // Subscribe to consent changes and push to child
+    const consentChangedUnsub = onConsentChanged((state) => {
+        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 initialized 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 = getParentApplication();
+    if (parentApp === null) {
+        return () => { };
+    }
+    return onSdkMessage(parentApp, (message) => {
+        if (message.action === ConsentAction.OnConsentUpdated) {
+            const { state } = message.payload;
+            updateConsentFromParent(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
+ */
+// Register bridge handlers for parent-child communication
+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);
+
+export { ConsentError, getConsentState, hasConsent, onConsentChanged, setConsentState };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","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 initialized.\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 initialized 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 * @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\n/**\n * Monterosa SDK / Consent Kit\n *\n * @packageDocumentation\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":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @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
+ */
+import { Emitter, Unsubscribe } from '@monterosa/sdk-util';
+/**
+ * Default consent categories commonly used for GDPR/privacy compliance.
+ *
+ * @remarks
+ * - `necessary` - Essential cookies/tracking required for the site to function
+ * - `analytics` - Analytics and performance tracking
+ * - `marketing` - Marketing and advertising tracking
+ * - `functional` - User preference and personalization tracking
+ */
+export type DefaultCategory = 'necessary' | 'analytics' | 'marketing' | 'functional';
+/**
+ * Represents the consent state for each category.
+ * Maps category names to boolean values indicating whether consent is granted.
+ *
+ * @typeParam T - The type of category keys, defaults to DefaultCategory
+ *
+ * @example
+ * ```typescript
+ * const state: ConsentState = {
+ *   necessary: true,
+ *   analytics: false,
+ *   marketing: false,
+ *   preferences: true,
+ * };
+ * ```
+ */
+export type ConsentState<T extends string = DefaultCategory> = {
+    [K in T]?: boolean;
+};
+/**
+ * Actions used for parent-child bridge communication.
+ *
+ * @internal
+ */
+export declare enum ConsentAction {
+    /**
+     * Sent when consent state is updated.
+     */
+    OnConsentUpdated = "consentOnConsentUpdated",
+    /**
+     * Request to set consent state from child to parent.
+     */
+    SetConsent = "consentSetConsent"
+}
+/**
+ * Internal event names for the consent emitter.
+ *
+ * @internal
+ */
+export declare enum ConsentEvent {
+    /**
+     * Emitted when consent state changes.
+     */
+    ConsentChanged = "consent_changed"
+}
+/**
+ * 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
+ *   }
+ * }
+ * ```
+ */
+export declare enum ConsentError {
+    /**
+     * Indicates that the 'necessary' category cannot be set to false.
+     */
+    NecessaryCategoryRequired = "necessary_category_required",
+    /**
+     * Indicates that consent cannot be set from a child experience.
+     */
+    CannotSetFromChild = "cannot_set_from_child"
+}
+/**
+ * Error messages for consent errors.
+ *
+ * @internal
+ */
+export declare const ConsentErrorMessages: {
+    necessary_category_required: () => string;
+    cannot_set_from_child: () => string;
+};
+/**
+ * Hook function type for registering consent hooks.
+ *
+ * @internal
+ */
+export type ConsentHook = (consent: ConsentKit) => Unsubscribe;
+/**
+ * The ConsentKit interface provides properties and methods
+ * for managing user consent state.
+ *
+ * @internal
+ */
+export interface ConsentKit extends Emitter {
+    /**
+     * Whether consent mode is active.
+     * Returns true when state has been set.
+     */
+    readonly isActive: boolean;
+    /**
+     * The current consent state.
+     */
+    state: ConsentState | null;
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@monterosa/sdk-consent-kit",
+  "version": "2.0.0-rc.1",
+  "description": "Consent Kit for the Monterosa JS SDK",
+  "author": "Monterosa Productions Limited <hello@monterosa.co.uk> (https://www.monterosa.co/)",
+  "main": "dist/index.cjs.js",
+  "browser": "dist/index.esm.js",
+  "module": "dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "cdn": "../../dist",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "rollup -c -w",
+    "build": "rollup -c",
+    "test": "jest --color",
+    "test:watch": "jest --color --watchAll",
+    "test:ci": "jest --color --ci --reporters=jest-junit --coverage",
+    "api-report": "api-extractor run --local --verbose"
+  },
+  "keywords": [],
+  "license": "MIT",
+  "peerDependencies": {
+    "@monterosa/sdk-launcher-kit": "0.x",
+    "@monterosa/sdk-util": "0.x"
+  },
+  "dependencies": {
+    "@monterosa/sdk-launcher-kit": "^2.0.0-rc.1",
+    "@monterosa/sdk-util": "^2.0.0-rc.1"
+  },
+  "devDependencies": {
+    "@faker-js/faker": "^6.3.1",
+    "@rollup/plugin-commonjs": "^21.1.0",
+    "@rollup/plugin-json": "^4.1.0",
+    "@rollup/plugin-node-resolve": "^13.3.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/jest": "29.5.3",
+    "jest": "29.6.1",
+    "jest-junit": "^13.0.0",
+    "rollup": "^2.57.0",
+    "rollup-plugin-dts": "^4.0.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "ts-jest": "29.1.1",
+    "tslib": "^2.3.0",
+    "typescript": "4.9.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "7cb580eebfab4fb87632a96519dac2f9762fc8b2"
+}