@leancodepl/cookie-consent 9.5.3

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Change Log
+
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [9.5.3](https://github.com/leancodepl/js_corelibrary/compare/v9.5.2...v9.5.3) (2025-08-26)
+
+### Bug Fixes
+
+- adjust default language handling
+  ([33fe746](https://github.com/leancodepl/js_corelibrary/commit/33fe74637f790b4476fed3f8015ae49e7eee5ce8))
+- adjust types ([5de20ba](https://github.com/leancodepl/js_corelibrary/commit/5de20bacc553ba0724bb44cb851469b274326a8d))
+- gtag package version
+  ([938e5c0](https://github.com/leancodepl/js_corelibrary/commit/938e5c0056d6063c280aeac080ffff60faccfc93))
+
+### Features
+
+- create basic cookie consent setup
+  ([edb082a](https://github.com/leancodepl/js_corelibrary/commit/edb082a93d07205366279f4819b9e0d7e1abefa2))
+- create default consent config
+  ([4f49ad2](https://github.com/leancodepl/js_corelibrary/commit/4f49ad2526b27c4f954eb41943ef03c2ff377906))

package/README.md

@@ -0,0 +1,178 @@
+# @leancodepl/cookie-consent
+
+Cookie consent helper that wires `vanilla-cookieconsent` with Google Consent Mode via `"@leancodepl/gtag"`.
+
+## Installation
+
+```bash
+npm install @leancodepl/cookie-consent
+# or
+yarn add @leancodepl/cookie-consent
+```
+
+## API
+
+### `getDefaultConsentConfig(options)`
+
+Creates a default cookie consent configuration with configurable languages and categories.
+
+- **Parameters**
+  - `options: DefaultConsentOptions` – Configuration options for languages and enabled categories
+    - `language: ("en" | "pl")[]` – Supported languages array
+    - `advertisement?: boolean` – Enable advertisement category
+    - `analytics?: boolean` – Enable analytics category
+    - `security?: boolean` – Enable security category
+    - `functionality?: boolean` – Enable functionality category
+- **Returns**
+  - `CookieConsentConfig` – Complete cookie consent configuration ready for `runCookieConsent`
+
+### `runCookieConsent(config)`
+
+Runs cookie consent and synchronizes consent state with Google via `"@leancodepl/gtag"`.
+
+- **Parameters**
+  - `config: CookieConsentConfig` – Cookie consent configuration mirroring `vanilla-cookieconsent` options, with a
+    strongly-typed `categories` shape for Google Consent Mode services.
+- **Returns**
+  - `Promise<typeof CookieConsent>` – The `vanilla-cookieconsent` module instance after initialization
+
+## Usage Examples
+
+### Using Default Configuration
+
+```jsx
+import "vanilla-cookieconsent/dist/cookieconsent.css"
+import { getDefaultConsentConfig, runCookieConsent } from "@leancodepl/cookie-consent"
+
+useEffect(() => {
+  const config = getDefaultConsentConfig({
+    language: ["en", "pl"], // English as default
+    analytics: true,
+    advertisement: true,
+    functionality: true,
+  })
+
+  runCookieConsent(config)
+}, [])
+```
+
+### Custom Configuration
+
+```jsx
+import "vanilla-cookieconsent/dist/cookieconsent.css"
+import "yourCustomStyles.css" // custom optional styles
+
+useEffect(() => {
+  runCookieConsent({
+    categories: {
+      analytics: {
+        services: {
+          analytics_storage: {
+            label: "Enables storage (such as cookies) related to analytics e.g. visit duration.",
+          },
+        },
+      },
+    },
+    guiOptions: {
+      consentModal: {
+        layout: "box wide",
+        position: "bottom right",
+      },
+      preferencesModal: {
+        layout: "box",
+      },
+    },
+    language: {
+      default: "en",
+      translations: {
+        en: {
+          consentModal: {
+            title: "We use cookies",
+            description:
+              "This website uses essential cookies to ensure its proper operation and tracking cookies to understand how you interact with it. The latter will be set only after consent.",
+            acceptAllBtn: "Accept all",
+            acceptNecessaryBtn: "Reject all",
+            showPreferencesBtn: "Manage Individual preferences",
+          },
+          preferencesModal: {
+            title: "Manage cookie preferences",
+            acceptAllBtn: "Accept all",
+            acceptNecessaryBtn: "Reject all",
+            savePreferencesBtn: "Accept current selection",
+            closeIconLabel: "Close modal",
+            sections: [
+              {
+                title: "Cookie usage",
+                description:
+                  "We use cookies to ensure the basic functionalities of the website and to enhance your online experience.",
+              },
+              {
+                title: "Strictly necessary cookies",
+                description:
+                  "These cookies are essential for the proper functioning of the website, for example for user authentication.",
+                linkedCategory: "necessary",
+              },
+              {
+                title: "Analytics",
+                description:
+                  "Cookies used for analytics help collect data that allows services to understand how users interact with a particular service. These insights allow services both to improve content and to build better features that improve the user’s experience.",
+                linkedCategory: "analytics",
+                cookieTable: {
+                  headers: {
+                    name: "Name",
+                    domain: "Service",
+                    description: "Description",
+                    expiration: "Expiration",
+                  },
+                  body: [
+                    {
+                      name: "_ga",
+                      domain: "Google Analytics",
+                      description:
+                        'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                      expiration: "Expires after 12 days",
+                    },
+                    {
+                      name: "_gid",
+                      domain: "Google Analytics",
+                      description:
+                        'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                      expiration: "Session",
+                    },
+                  ],
+                },
+              },
+              {
+                title: "Advertising",
+                description:
+                  'Google uses cookies for advertising, including serving and rendering ads, personalizing ads (depending on your ad settings at <a href=\"https://g.co/adsettings\">g.co/adsettings</a>), limiting the number of times an ad is shown to a user, muting ads you have chosen to stop seeing, and measuring the effectiveness of ads.',
+                linkedCategory: "advertising",
+              },
+              {
+                title: "Functionality",
+                description:
+                  "Cookies used for functionality allow users to interact with a service or site to access features that are fundamental to that service. Things considered fundamental to the service include preferences like the user’s choice of language, product optimizations that help maintain and improve a service, and maintaining information relating to a user’s session, such as the content of a shopping cart.",
+                linkedCategory: "functionality",
+              },
+              {
+                title: "Security",
+                description:
+                  "Cookies used for security authenticate users, prevent fraud, and protect users as they interact with a service.",
+                linkedCategory: "security",
+              },
+              {
+                title: "More information",
+                description:
+                  'For any queries in relation to the policy on cookies and your choices, please <a href="https://www.example.com/contacts">contact us</a>.',
+              },
+            ],
+          },
+        },
+      },
+    },
+  })
+}, [])
+```
+
+For advanced configuration and UI customization, refer to the official vanilla-cookieconsent documentation:
+https://cookieconsent.orestbida.com/

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@leancodepl/cookie-consent",
+  "version": "9.5.3",
+  "license": "Apache-2.0",
+  "type": "module",
+  "dependencies": {
+    "@leancodepl/gtag": "9.5.3",
+    "vanilla-cookieconsent": "^3.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leancodepl/js_corelibrary.git",
+    "directory": "packages/cookie-consent"
+  },
+  "homepage": "https://github.com/leancodepl/js_corelibrary",
+  "bugs": {
+    "url": "https://github.com/leancodepl/js_corelibrary/issues"
+  },
+  "description": "Cookie consent library with Google Consent Mode support",
+  "keywords": [
+    "cookie-consent",
+    "google-consent-mode",
+    "javascript",
+    "typescript",
+    "leancode",
+    "vanilla-cookieconsent"
+  ],
+  "author": {
+    "name": "LeanCode",
+    "url": "https://leancode.co"
+  },
+  "sideEffects": false,
+  "types": "./src/index.d.ts",
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./lib/runCookieConsent";
+export * from "./lib/getDefaultConsentConfig";

package/src/index.js

@@ -0,0 +1,3 @@
+export * from "./lib/runCookieConsent";
+export * from "./lib/getDefaultConsentConfig";
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/cookie-consent/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA"}

package/src/lib/config.d.ts

@@ -0,0 +1,208 @@
+export declare const config: {
+    en: {
+        language: {
+            consentModal: {
+                title: string;
+                description: string;
+                acceptAllBtn: string;
+                acceptNecessaryBtn: string;
+                showPreferencesBtn: string;
+            };
+            preferencesModal: {
+                title: string;
+                acceptAllBtn: string;
+                acceptNecessaryBtn: string;
+                savePreferencesBtn: string;
+                closeIconLabel: string;
+                baseSection: {
+                    title: string;
+                    description: string;
+                };
+                necessarySection: {
+                    title: string;
+                    description: string;
+                };
+            };
+            categoryPreferenceLabels: {
+                analytics: {
+                    title: string;
+                    description: string;
+                    cookieTable: {
+                        headers: {
+                            name: string;
+                            domain: string;
+                            description: string;
+                            expiration: string;
+                        };
+                        body: {
+                            name: string;
+                            domain: string;
+                            description: string;
+                            expiration: string;
+                        }[];
+                    };
+                };
+                advertisement: {
+                    title: string;
+                    description: string;
+                };
+                functionality: {
+                    title: string;
+                    description: string;
+                };
+                security: {
+                    title: string;
+                    description: string;
+                };
+            };
+        };
+        categories: {
+            analytics: {
+                services: {
+                    analytics_storage: {
+                        label: string;
+                    };
+                };
+            };
+            advertisement: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    ad_storage: {
+                        label: string;
+                    };
+                    ad_user_data: {
+                        label: string;
+                    };
+                    ad_personalization: {
+                        label: string;
+                    };
+                };
+            };
+            functionality: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    functionality_storage: {
+                        label: string;
+                    };
+                    personalization_storage: {
+                        label: string;
+                    };
+                };
+            };
+            security: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    security_storage: {
+                        label: string;
+                    };
+                };
+            };
+        };
+    };
+    pl: {
+        language: {
+            consentModal: {
+                title: string;
+                description: string;
+                acceptAllBtn: string;
+                acceptNecessaryBtn: string;
+                showPreferencesBtn: string;
+            };
+            preferencesModal: {
+                title: string;
+                acceptAllBtn: string;
+                acceptNecessaryBtn: string;
+                savePreferencesBtn: string;
+                closeIconLabel: string;
+                baseSection: {
+                    title: string;
+                    description: string;
+                };
+                necessarySection: {
+                    title: string;
+                    description: string;
+                };
+            };
+            categoryPreferenceLabels: {
+                analytics: {
+                    title: string;
+                    description: string;
+                    cookieTable: {
+                        headers: {
+                            name: string;
+                            domain: string;
+                            description: string;
+                            expiration: string;
+                        };
+                        body: {
+                            name: string;
+                            domain: string;
+                            description: string;
+                            expiration: string;
+                        }[];
+                    };
+                };
+                advertisement: {
+                    title: string;
+                    description: string;
+                };
+                functionality: {
+                    title: string;
+                    description: string;
+                };
+                security: {
+                    title: string;
+                    description: string;
+                };
+            };
+        };
+        categories: {
+            analytics: {
+                services: {
+                    analytics_storage: {
+                        label: string;
+                    };
+                };
+            };
+            advertisement: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    ad_storage: {
+                        label: string;
+                    };
+                    ad_user_data: {
+                        label: string;
+                    };
+                    ad_personalization: {
+                        label: string;
+                    };
+                };
+            };
+            functionality: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    functionality_storage: {
+                        label: string;
+                    };
+                    personalization_storage: {
+                        label: string;
+                    };
+                };
+            };
+            security: {
+                enabled: boolean;
+                readOnly: boolean;
+                services: {
+                    security_storage: {
+                        label: string;
+                    };
+                };
+            };
+        };
+    };
+};

package/src/lib/config.js

@@ -0,0 +1,218 @@
+import { catAdvertisement, catAnalytics, catFunctionality, catSecurity, serviceAdPersonalization, serviceAdStorage, serviceAdUserData, serviceAnalyticsStorage, serviceFunctionalityStorage, servicePersonalizationStorage, serviceSecurityStorage, } from "./getGoogleConsent";
+const googleAnalyticsCookieName = "_ga";
+const googleAnalyticsSessionCookieName = "_gid";
+export const config = {
+    en: {
+        language: {
+            consentModal: {
+                title: "We use cookies",
+                description: "This website uses essential cookies to ensure its proper operation and tracking cookies to understand how you interact with it. The latter will be set only after consent.",
+                acceptAllBtn: "Accept all",
+                acceptNecessaryBtn: "Reject all",
+                showPreferencesBtn: "Manage Individual preferences",
+            },
+            preferencesModal: {
+                title: "Manage cookie preferences",
+                acceptAllBtn: "Accept all",
+                acceptNecessaryBtn: "Reject all",
+                savePreferencesBtn: "Accept current selection",
+                closeIconLabel: "Close modal",
+                baseSection: {
+                    title: "Cookie usage",
+                    description: "We use cookies to ensure the basic functionalities of the website and to enhance your online experience.",
+                },
+                necessarySection: {
+                    title: "Strictly necessary cookies",
+                    description: "These cookies are essential for the proper functioning of the website, for example for user authentication.",
+                },
+            },
+            categoryPreferenceLabels: {
+                analytics: {
+                    title: "Analytics",
+                    description: "Cookies used for analytics help collect data that allows services to understand how users interact with a particular service. These insights allow services both to improve content and to build better features that improve the user's experience.",
+                    cookieTable: {
+                        headers: { name: "Name", domain: "Service", description: "Description", expiration: "Expiration" },
+                        body: [
+                            {
+                                name: googleAnalyticsCookieName,
+                                domain: "Google Analytics",
+                                description: 'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                                expiration: "Expires after 12 days",
+                            },
+                            {
+                                name: googleAnalyticsSessionCookieName,
+                                domain: "Google Analytics",
+                                description: 'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                                expiration: "Session",
+                            },
+                        ],
+                    },
+                },
+                advertisement: {
+                    title: "Advertising",
+                    description: 'Google uses cookies for advertising, including serving and rendering ads, personalizing ads (depending on your ad settings at <a href="https://g.co/adsettings">g.co/adsettings</a>), limiting the number of times an ad is shown to a user, muting ads you have chosen to stop seeing, and measuring the effectiveness of ads.',
+                },
+                functionality: {
+                    title: "Functionality",
+                    description: "Cookies used for functionality allow users to interact with a service or site to access features that are fundamental to that service. Things considered fundamental to the service include preferences like the user's choice of language, product optimizations that help maintain and improve a service, and maintaining information relating to a user's session, such as the content of a shopping cart.",
+                },
+                security: {
+                    title: "Security",
+                    description: "Cookies used for security authenticate users, prevent fraud, and protect users as they interact with a service.",
+                },
+            },
+        },
+        categories: {
+            [catAnalytics]: {
+                services: {
+                    [serviceAnalyticsStorage]: {
+                        label: "Enables storage (such as cookies) related to analytics e.g. visit duration.",
+                    },
+                },
+            },
+            [catAdvertisement]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceAdStorage]: {
+                        label: "Enables storage (such as cookies) related to advertising.",
+                    },
+                    [serviceAdUserData]: {
+                        label: "Sets consent for sending user data related to advertising to Google.",
+                    },
+                    [serviceAdPersonalization]: {
+                        label: "Sets consent for personalized advertising.",
+                    },
+                },
+            },
+            [catFunctionality]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceFunctionalityStorage]: {
+                        label: "Enables storage that supports the functionality of the website or app e.g. language settings.",
+                    },
+                    [servicePersonalizationStorage]: {
+                        label: "Enables storage related to personalization e.g. video recommendations.",
+                    },
+                },
+            },
+            [catSecurity]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceSecurityStorage]: {
+                        label: "Enables storage related to security such as authentication functionality, fraud prevention, and other user protection.",
+                    },
+                },
+            },
+        },
+    },
+    pl: {
+        language: {
+            consentModal: {
+                title: "Używamy plików cookie",
+                description: "Ta strona internetowa wykorzystuje niezbędne pliki cookie w celu zapewnienia jej prawidłowego działania oraz pliki cookie śledzące w celu zrozumienia sposobu interakcji użytkowników z witryną. Te ostatnie będą ustawione tylko po wyrażeniu zgody.",
+                acceptAllBtn: "Zaakceptuj wszystkie",
+                acceptNecessaryBtn: "Odrzuć wszystkie",
+                showPreferencesBtn: "Zarządzaj indywidualnymi preferencjami",
+            },
+            preferencesModal: {
+                title: "Zarządzaj preferencjami plików cookie",
+                acceptAllBtn: "Zaakceptuj wszystkie",
+                acceptNecessaryBtn: "Odrzuć wszystkie",
+                savePreferencesBtn: "Zaakceptuj bieżący wybór",
+                closeIconLabel: "Zamknij okno",
+                baseSection: {
+                    title: "Używanie plików cookie",
+                    description: "Używamy plików cookie w celu zapewnienia podstawowej funkcjonalności strony internetowej oraz poprawy Twojego doświadczenia online.",
+                },
+                necessarySection: {
+                    title: "Ściśle niezbędne pliki cookie",
+                    description: "Te pliki cookie są niezbędne do prawidłowego funkcjonowania strony internetowej, na przykład do uwierzytelniania użytkowników.",
+                },
+            },
+            categoryPreferenceLabels: {
+                analytics: {
+                    title: "Analityka",
+                    description: "Pliki cookie używane do analityki pomagają zbierać dane, które umożliwiają usługom zrozumienie sposobu interakcji użytkowników z określoną usługą. Te informacje pozwalają usługom zarówno poprawić treść, jak i tworzyć lepsze funkcje, które poprawiają doświadczenie użytkownika.",
+                    cookieTable: {
+                        headers: { name: "Nazwa", domain: "Usługa", description: "Opis", expiration: "Wygaśnięcie" },
+                        body: [
+                            {
+                                name: googleAnalyticsCookieName,
+                                domain: "Google Analytics",
+                                description: 'Plik cookie ustawiony przez <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                                expiration: "Wygasa po 12 dniach",
+                            },
+                            {
+                                name: googleAnalyticsSessionCookieName,
+                                domain: "Google Analytics",
+                                description: 'Plik cookie ustawiony przez <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                                expiration: "Sesja",
+                            },
+                        ],
+                    },
+                },
+                advertisement: {
+                    title: "Reklama",
+                    description: 'Google używa plików cookie do reklam, w tym do wyświetlania i renderowania reklam, personalizacji reklam (w zależności od Twoich ustawień reklam na <a href="https://g.co/adsettings">g.co/adsettings</a>), ograniczania liczby wyświetleń reklamy użytkownikowi, wyciszania reklam, które zdecydowałeś się przestać oglądać, oraz mierzenia skuteczności reklam.',
+                },
+                functionality: {
+                    title: "Funkcjonalność",
+                    description: "Pliki cookie używane do funkcjonalności umożliwiają użytkownikom interakcję z usługą lub stroną w celu uzyskania dostępu do funkcji, które są fundamentalne dla tej usługi. Do rzeczy uznawanych za fundamentalne dla usługi należą preferencje takie jak wybór języka przez użytkownika, optymalizacje produktu, które pomagają utrzymać i poprawić usługę, oraz utrzymywanie informacji dotyczących sesji użytkownika, takich jak zawartość koszyka zakupów.",
+                },
+                security: {
+                    title: "Bezpieczeństwo",
+                    description: "Pliki cookie używane do bezpieczeństwa uwierzytelniają użytkowników, zapobiegają oszustwom i chronią użytkowników podczas interakcji z usługą.",
+                },
+            },
+        },
+        categories: {
+            [catAnalytics]: {
+                services: {
+                    [serviceAnalyticsStorage]: {
+                        label: "Umożliwia przechowywanie (np. plików cookie) związane z analityką, np. czas trwania wizyty.",
+                    },
+                },
+            },
+            [catAdvertisement]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceAdStorage]: {
+                        label: "Umożliwia przechowywanie (np. plików cookie) związane z reklamą.",
+                    },
+                    [serviceAdUserData]: {
+                        label: "Ustawia zgodę na wysyłanie danych użytkownika związanych z reklamą do Google.",
+                    },
+                    [serviceAdPersonalization]: {
+                        label: "Ustawia zgodę na personalizację reklam.",
+                    },
+                },
+            },
+            [catFunctionality]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceFunctionalityStorage]: {
+                        label: "Umożliwia przechowywanie, które wspiera funkcjonalność strony internetowej lub aplikacji, np. ustawienia języka.",
+                    },
+                    [servicePersonalizationStorage]: {
+                        label: "Umożliwia przechowywanie związane z personalizacją, np. rekomendacje wideo.",
+                    },
+                },
+            },
+            [catSecurity]: {
+                enabled: true,
+                readOnly: false,
+                services: {
+                    [serviceSecurityStorage]: {
+                        label: "Umożliwia przechowywanie związane z bezpieczeństwem, takie jak funkcjonalność uwierzytelniania, zapobieganie oszustwom i inna ochrona użytkowników.",
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=config.js.map

package/src/lib/config.js.map

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

package/src/lib/getDefaultConsentConfig.d.ts

@@ -0,0 +1,29 @@
+import type { CookieConsentConfig } from "./runCookieConsent";
+type Language = "en" | "pl";
+export interface DefaultConsentOptions {
+    language: Language[];
+    advertisement?: boolean;
+    analytics?: boolean;
+    security?: boolean;
+    functionality?: boolean;
+}
+/**
+ * Creates a default cookie consent configuration with configurable languages and categories.
+ *
+ * @param options - Configuration options for languages and enabled categories
+ * @returns Complete cookie consent configuration ready for runCookieConsent
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultConsentConfig({
+ *   language: ["en", "pl"],
+ *   advertisement: true,
+ *   analytics: true,
+ *   security: true
+ * })
+ *
+ * runCookieConsent(config)
+ * ```
+ */
+export declare function getDefaultConsentConfig({ language, advertisement, analytics, security, functionality, }: DefaultConsentOptions): CookieConsentConfig;
+export {};

package/src/lib/getDefaultConsentConfig.js

@@ -0,0 +1,70 @@
+import { config } from "./config";
+import { catAdvertisement, catAnalytics, catFunctionality, catSecurity } from "./getGoogleConsent";
+const categories = [catAnalytics, catAdvertisement, catFunctionality, catSecurity];
+function buildPreferencesSections(langConfig, options) {
+    const sections = [
+        langConfig.language.preferencesModal.baseSection,
+        {
+            ...langConfig.language.preferencesModal.necessarySection,
+            linkedCategory: "necessary",
+        },
+    ];
+    for (const key of categories) {
+        if (options[key]) {
+            sections.push({
+                ...langConfig.language.categoryPreferenceLabels[key],
+                linkedCategory: key,
+            });
+        }
+    }
+    return sections;
+}
+const fallbackLanguage = "en";
+/**
+ * Creates a default cookie consent configuration with configurable languages and categories.
+ *
+ * @param options - Configuration options for languages and enabled categories
+ * @returns Complete cookie consent configuration ready for runCookieConsent
+ *
+ * @example
+ * ```typescript
+ * const config = getDefaultConsentConfig({
+ *   language: ["en", "pl"],
+ *   advertisement: true,
+ *   analytics: true,
+ *   security: true
+ * })
+ *
+ * runCookieConsent(config)
+ * ```
+ */
+export function getDefaultConsentConfig({ language = [fallbackLanguage], advertisement = false, analytics = false, security = false, functionality = false, }) {
+    const categoryOptions = { analytics, advertisement, functionality, security };
+    const defaultLanguage = language.at(0) ?? fallbackLanguage;
+    const defaultLanguageConfig = config[defaultLanguage];
+    const supportedCategories = {};
+    for (const key of categories) {
+        if (categoryOptions[key]) {
+            supportedCategories[key] = defaultLanguageConfig.categories[key];
+        }
+    }
+    const languageTranslations = {};
+    for (const lang of language) {
+        const langConfig = config[lang];
+        languageTranslations[lang] = {
+            consentModal: langConfig.language.consentModal,
+            preferencesModal: {
+                ...langConfig.language.preferencesModal,
+                sections: buildPreferencesSections(langConfig, categoryOptions),
+            },
+        };
+    }
+    return {
+        categories: supportedCategories,
+        language: {
+            default: defaultLanguage,
+            translations: languageTranslations,
+        },
+    };
+}
+//# sourceMappingURL=getDefaultConsentConfig.js.map

package/src/lib/getDefaultConsentConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultConsentConfig.js","sourceRoot":"","sources":["../../../../../packages/cookie-consent/src/lib/getDefaultConsentConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAYlG,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAU,CAAA;AAE3F,SAAS,wBAAwB,CAC/B,UAAqC,EACrC,OAAsG;IAEtG,MAAM,QAAQ,GAAG;QACf,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW;QAChD;YACE,GAAG,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB;YACxD,cAAc,EAAE,WAAW;SAC5B;KACF,CAAA;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,GAAG,CAAC;gBACpD,cAAc,EAAE,GAAG;aACpB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,gBAAgB,GAAa,IAAI,CAAA;AACvC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,GAAG,CAAC,gBAAgB,CAAC,EAC7B,aAAa,GAAG,KAAK,EACrB,SAAS,GAAG,KAAK,EACjB,QAAQ,GAAG,KAAK,EAChB,aAAa,GAAG,KAAK,GACC;IACtB,MAAM,eAAe,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;IAE7E,MAAM,eAAe,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAA;IAC1D,MAAM,qBAAqB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;IAErD,MAAM,mBAAmB,GAAsC,EAAE,CAAA;IACjE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,mBAAmB,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED,MAAM,oBAAoB,GAAgC,EAAE,CAAA;IAE5D,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAE/B,oBAAoB,CAAC,IAAI,CAAC,GAAG;YAC3B,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,YAAY;YAC9C,gBAAgB,EAAE;gBAChB,GAAG,UAAU,CAAC,QAAQ,CAAC,gBAAgB;gBACvC,QAAQ,EAAE,wBAAwB,CAAC,UAAU,EAAE,eAAe,CAAC;aAChE;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,mBAAmB;QAC/B,QAAQ,EAAE;YACR,OAAO,EAAE,eAAe;YACxB,YAAY,EAAE,oBAAoB;SACnC;KACF,CAAA;AACH,CAAC"}

package/src/lib/getGoogleConsent.d.ts

@@ -0,0 +1,20 @@
+export declare const catNecessary = "necessary";
+export declare const catAnalytics = "analytics";
+export declare const catAdvertisement = "advertisement";
+export declare const catFunctionality = "functionality";
+export declare const catSecurity = "security";
+export declare const serviceAdStorage = "ad_storage";
+export declare const serviceAdUserData = "ad_user_data";
+export declare const serviceAdPersonalization = "ad_personalization";
+export declare const serviceAnalyticsStorage = "analytics_storage";
+export declare const serviceFunctionalityStorage = "functionality_storage";
+export declare const servicePersonalizationStorage = "personalization_storage";
+export declare const serviceSecurityStorage = "security_storage";
+export type ServiceKey = typeof serviceAdPersonalization | typeof serviceAdStorage | typeof serviceAdUserData | typeof serviceAnalyticsStorage | typeof serviceFunctionalityStorage | typeof servicePersonalizationStorage | typeof serviceSecurityStorage;
+export type CategoryKey = typeof catAdvertisement | typeof catAnalytics | typeof catFunctionality | typeof catNecessary | typeof catSecurity;
+export declare const serviceKeyCategoriesMap: Record<ServiceKey, CategoryKey>;
+export declare function getGoogleConsent(): {
+    setDefaultConsent: (serviceKeys: ServiceKey[]) => void;
+    updateConsent: (serviceKeys: ServiceKey[]) => void;
+};
+export declare function getServiceValue(serviceName: ServiceKey, categoryName: CategoryKey): "denied" | "granted";

package/src/lib/getGoogleConsent.js

@@ -0,0 +1,43 @@
+import * as CookieConsent from "vanilla-cookieconsent";
+import { mkgtag } from "@leancodepl/gtag";
+export const catNecessary = "necessary";
+export const catAnalytics = "analytics";
+export const catAdvertisement = "advertisement";
+export const catFunctionality = "functionality";
+export const catSecurity = "security";
+export const serviceAdStorage = "ad_storage";
+export const serviceAdUserData = "ad_user_data";
+export const serviceAdPersonalization = "ad_personalization";
+export const serviceAnalyticsStorage = "analytics_storage";
+export const serviceFunctionalityStorage = "functionality_storage";
+export const servicePersonalizationStorage = "personalization_storage";
+export const serviceSecurityStorage = "security_storage";
+export const serviceKeyCategoriesMap = {
+    [serviceAdStorage]: catAdvertisement,
+    [serviceAnalyticsStorage]: catAnalytics,
+    [serviceFunctionalityStorage]: catFunctionality,
+    [servicePersonalizationStorage]: catFunctionality,
+    [serviceSecurityStorage]: catSecurity,
+    [serviceAdUserData]: catAdvertisement,
+    [serviceAdPersonalization]: catAdvertisement,
+};
+export function getGoogleConsent() {
+    const gtag = mkgtag();
+    function setDefaultConsent(serviceKeys) {
+        gtag({
+            event: "default_cookie_consent",
+            settings: Object.fromEntries(serviceKeys.map(serviceName => [serviceName, "denied"])),
+        });
+    }
+    function updateConsent(serviceKeys) {
+        gtag({
+            event: "cookie_consent_update",
+            settings: Object.fromEntries(serviceKeys.map(serviceKey => [serviceKey, getServiceValue(serviceKey, serviceKeyCategoriesMap[serviceKey])])),
+        });
+    }
+    return { setDefaultConsent, updateConsent };
+}
+export function getServiceValue(serviceName, categoryName) {
+    return CookieConsent.acceptedService(serviceName, categoryName) ? "granted" : "denied";
+}
+//# sourceMappingURL=getGoogleConsent.js.map

package/src/lib/getGoogleConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGoogleConsent.js","sourceRoot":"","sources":["../../../../../packages/cookie-consent/src/lib/getGoogleConsent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAA;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAA;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAC/C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAA;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAA;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAA;AAC5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAA;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAA;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAA;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAA;AAqBxD,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACtE,CAAC,gBAAgB,CAAC,EAAE,gBAAgB;IACpC,CAAC,uBAAuB,CAAC,EAAE,YAAY;IACvC,CAAC,2BAA2B,CAAC,EAAE,gBAAgB;IAC/C,CAAC,6BAA6B,CAAC,EAAE,gBAAgB;IACjD,CAAC,sBAAsB,CAAC,EAAE,WAAW;IACrC,CAAC,iBAAiB,CAAC,EAAE,gBAAgB;IACrC,CAAC,wBAAwB,CAAC,EAAE,gBAAgB;CAC7C,CAAA;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,MAAM,EAA4F,CAAA;IAE/G,SAAS,iBAAiB,CAAC,WAAyB;QAClD,IAAI,CAAC;YACH,KAAK,EAAE,wBAAwB;YAC/B,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;SACtF,CAAC,CAAA;IACJ,CAAC;IAED,SAAS,aAAa,CAAC,WAAyB;QAC9C,IAAI,CAAC;YACH,KAAK,EAAE,uBAAuB;YAC9B,QAAQ,EAAE,MAAM,CAAC,WAAW,CAC1B,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAC9G;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAA;AAC7C,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,WAAuB,EAAE,YAAyB;IAChF,OAAO,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;AACxF,CAAC"}

package/src/lib/runCookieConsent.d.ts

@@ -0,0 +1,140 @@
+import * as CookieConsent from "vanilla-cookieconsent";
+import { CategoryKey, ServiceKey, serviceKeyCategoriesMap } from "./getGoogleConsent";
+type ServiceKeysByCategory<C extends CategoryKey> = Extract<{
+    [K in keyof typeof serviceKeyCategoriesMap]: (typeof serviceKeyCategoriesMap)[K] extends C ? K : never;
+}[keyof typeof serviceKeyCategoriesMap], ServiceKey>;
+type CategoryWithServices<C extends CategoryKey> = Omit<CookieConsent.Category, "services"> & {
+    services?: Partial<Record<ServiceKeysByCategory<C>, CookieConsent.Service>>;
+};
+type Categories = Partial<{
+    [K in CategoryKey]: CategoryWithServices<K>;
+}>;
+export type CookieConsentConfig = Omit<CookieConsent.CookieConsentConfig, "categories"> & {
+    categories: Categories;
+};
+/**
+ * Runs cookie consent and synchronizes consent state with Google via `"@leancodepl/gtag"`.
+ *
+ * This function derives supported Google consent services from the provided `categories.services`
+ * and automatically calls Google consent APIs on first consent, consent, and change events while
+ * preserving any user-provided handlers.
+ *
+ * @param config - Cookie consent configuration that mirrors `vanilla-cookieconsent` options, with a strongly-typed
+ *   `categories` shape. All non-`categories` fields pass through to `vanilla-cookieconsent` unchanged.
+ *   For complete configuration details, see the vanilla-cookieconsent documentation: https://cookieconsent.orestbida.com/
+ * @returns The `vanilla-cookieconsent` module instance after initialization
+ * @example
+ * ```typescript
+    runCookieConsent({
+      categories: {
+        analytics: {
+          services: {
+            analytics_storage: {
+              label:
+                'Enables storage (such as cookies) related to analytics e.g. visit duration.'
+            }
+          }
+        }
+      },
+      guiOptions: {
+        consentModal: {
+          layout: 'box wide',
+          position: 'bottom right'
+        },
+        preferencesModal: {
+          layout: 'box'
+        }
+      },
+      language: {
+        default: 'en',
+        translations: {
+          en: {
+            consentModal: {
+              title: 'We use cookies',
+              description:
+                'This website uses essential cookies to ensure its proper operation and tracking cookies to understand how you interact with it. The latter will be set only after consent.',
+              acceptAllBtn: 'Accept all',
+              acceptNecessaryBtn: 'Reject all',
+              showPreferencesBtn: 'Manage Individual preferences'
+            },
+            preferencesModal: {
+              title: 'Manage cookie preferences',
+              acceptAllBtn: 'Accept all',
+              acceptNecessaryBtn: 'Reject all',
+              savePreferencesBtn: 'Accept current selection',
+              closeIconLabel: 'Close modal',
+              sections: [
+                {
+                  title: 'Cookie usage',
+                  description:
+                    'We use cookies to ensure the basic functionalities of the website and to enhance your online experience.'
+                },
+                {
+                  title: 'Strictly necessary cookies',
+                  description:
+                    'These cookies are essential for the proper functioning of the website, for example for user authentication.',
+                  linkedCategory: 'necessary'
+                },
+                {
+                  title: 'Analytics',
+                  description:
+                    'Cookies used for analytics help collect data that allows services to understand how users interact with a particular service. These insights allow services both to improve content and to build better features that improve the user’s experience.',
+                  linkedCategory: 'analytics',
+                  cookieTable: {
+                    headers: {
+                      name: 'Name',
+                      domain: 'Service',
+                      description: 'Description',
+                      expiration: 'Expiration'
+                    },
+                    body: [
+                      {
+                        name: '_ga',
+                        domain: 'Google Analytics',
+                        description:
+                          'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                        expiration: 'Expires after 12 days'
+                      },
+                      {
+                        name: '_gid',
+                        domain: 'Google Analytics',
+                        description:
+                          'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                        expiration: 'Session'
+                      }
+                    ]
+                  }
+                },
+                {
+                  title: 'Advertising',
+                  description:
+                    'Google uses cookies for advertising, including serving and rendering ads, personalizing ads (depending on your ad settings at <a href=\"https://g.co/adsettings\">g.co/adsettings</a>), limiting the number of times an ad is shown to a user, muting ads you have chosen to stop seeing, and measuring the effectiveness of ads.',
+                  linkedCategory: 'advertising'
+                },
+                {
+                  title: 'Functionality',
+                  description:
+                    'Cookies used for functionality allow users to interact with a service or site to access features that are fundamental to that service. Things considered fundamental to the service include preferences like the user’s choice of language, product optimizations that help maintain and improve a service, and maintaining information relating to a user’s session, such as the content of a shopping cart.',
+                  linkedCategory: 'functionality'
+                },
+                {
+                  title: 'Security',
+                  description:
+                    'Cookies used for security authenticate users, prevent fraud, and protect users as they interact with a service.',
+                  linkedCategory: 'security'
+                },
+                {
+                  title: 'More information',
+                  description:
+                    'For any queries in relation to the policy on cookies and your choices, please <a href="https://www.example.com/contacts">contact us</a>.'
+                }
+              ]
+            }
+          }
+        }
+      }
+    })
+ * ```
+ */
+export declare function runCookieConsent(config: CookieConsentConfig): Promise<typeof CookieConsent>;
+export {};

package/src/lib/runCookieConsent.js

@@ -0,0 +1,169 @@
+import * as CookieConsent from "vanilla-cookieconsent";
+import { catAnalytics, catNecessary, getGoogleConsent, } from "./getGoogleConsent";
+function getCookieConsentConfig(config) {
+    const { categories, onFirstConsent, onChange, onConsent, ...rest } = config;
+    const supportedServices = Object.values(categories).flatMap(category => Object.keys(category.services ?? {}));
+    const { setDefaultConsent, updateConsent } = getGoogleConsent();
+    setDefaultConsent(supportedServices);
+    const cookieConsentConfig = {
+        onFirstConsent: params => {
+            updateConsent(supportedServices);
+            onFirstConsent?.(params);
+        },
+        onConsent: params => {
+            updateConsent(supportedServices);
+            onConsent?.(params);
+        },
+        onChange: params => {
+            updateConsent(supportedServices);
+            onChange?.(params);
+        },
+        categories: {
+            [catNecessary]: {
+                enabled: true,
+                readOnly: true,
+                ...(categories[catNecessary] ?? {}),
+            },
+            [catAnalytics]: {
+                autoClear: {
+                    cookies: [{ name: /^_ga/ }, { name: "_gid" }],
+                },
+                ...(categories[catAnalytics] ?? {}),
+            },
+            ...categories,
+        },
+        ...rest,
+    };
+    return cookieConsentConfig;
+}
+/**
+ * Runs cookie consent and synchronizes consent state with Google via `"@leancodepl/gtag"`.
+ *
+ * This function derives supported Google consent services from the provided `categories.services`
+ * and automatically calls Google consent APIs on first consent, consent, and change events while
+ * preserving any user-provided handlers.
+ *
+ * @param config - Cookie consent configuration that mirrors `vanilla-cookieconsent` options, with a strongly-typed
+ *   `categories` shape. All non-`categories` fields pass through to `vanilla-cookieconsent` unchanged.
+ *   For complete configuration details, see the vanilla-cookieconsent documentation: https://cookieconsent.orestbida.com/
+ * @returns The `vanilla-cookieconsent` module instance after initialization
+ * @example
+ * ```typescript
+    runCookieConsent({
+      categories: {
+        analytics: {
+          services: {
+            analytics_storage: {
+              label:
+                'Enables storage (such as cookies) related to analytics e.g. visit duration.'
+            }
+          }
+        }
+      },
+      guiOptions: {
+        consentModal: {
+          layout: 'box wide',
+          position: 'bottom right'
+        },
+        preferencesModal: {
+          layout: 'box'
+        }
+      },
+      language: {
+        default: 'en',
+        translations: {
+          en: {
+            consentModal: {
+              title: 'We use cookies',
+              description:
+                'This website uses essential cookies to ensure its proper operation and tracking cookies to understand how you interact with it. The latter will be set only after consent.',
+              acceptAllBtn: 'Accept all',
+              acceptNecessaryBtn: 'Reject all',
+              showPreferencesBtn: 'Manage Individual preferences'
+            },
+            preferencesModal: {
+              title: 'Manage cookie preferences',
+              acceptAllBtn: 'Accept all',
+              acceptNecessaryBtn: 'Reject all',
+              savePreferencesBtn: 'Accept current selection',
+              closeIconLabel: 'Close modal',
+              sections: [
+                {
+                  title: 'Cookie usage',
+                  description:
+                    'We use cookies to ensure the basic functionalities of the website and to enhance your online experience.'
+                },
+                {
+                  title: 'Strictly necessary cookies',
+                  description:
+                    'These cookies are essential for the proper functioning of the website, for example for user authentication.',
+                  linkedCategory: 'necessary'
+                },
+                {
+                  title: 'Analytics',
+                  description:
+                    'Cookies used for analytics help collect data that allows services to understand how users interact with a particular service. These insights allow services both to improve content and to build better features that improve the user’s experience.',
+                  linkedCategory: 'analytics',
+                  cookieTable: {
+                    headers: {
+                      name: 'Name',
+                      domain: 'Service',
+                      description: 'Description',
+                      expiration: 'Expiration'
+                    },
+                    body: [
+                      {
+                        name: '_ga',
+                        domain: 'Google Analytics',
+                        description:
+                          'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                        expiration: 'Expires after 12 days'
+                      },
+                      {
+                        name: '_gid',
+                        domain: 'Google Analytics',
+                        description:
+                          'Cookie set by <a href="https://business.safety.google/adscookies/">Google Analytics</a>',
+                        expiration: 'Session'
+                      }
+                    ]
+                  }
+                },
+                {
+                  title: 'Advertising',
+                  description:
+                    'Google uses cookies for advertising, including serving and rendering ads, personalizing ads (depending on your ad settings at <a href=\"https://g.co/adsettings\">g.co/adsettings</a>), limiting the number of times an ad is shown to a user, muting ads you have chosen to stop seeing, and measuring the effectiveness of ads.',
+                  linkedCategory: 'advertising'
+                },
+                {
+                  title: 'Functionality',
+                  description:
+                    'Cookies used for functionality allow users to interact with a service or site to access features that are fundamental to that service. Things considered fundamental to the service include preferences like the user’s choice of language, product optimizations that help maintain and improve a service, and maintaining information relating to a user’s session, such as the content of a shopping cart.',
+                  linkedCategory: 'functionality'
+                },
+                {
+                  title: 'Security',
+                  description:
+                    'Cookies used for security authenticate users, prevent fraud, and protect users as they interact with a service.',
+                  linkedCategory: 'security'
+                },
+                {
+                  title: 'More information',
+                  description:
+                    'For any queries in relation to the policy on cookies and your choices, please <a href="https://www.example.com/contacts">contact us</a>.'
+                }
+              ]
+            }
+          }
+        }
+      }
+    })
+ * ```
+ */
+export async function runCookieConsent(config) {
+    const cookieConsent = CookieConsent;
+    const cookieConsentConfig = getCookieConsentConfig(config);
+    await cookieConsent.run(cookieConsentConfig);
+    return cookieConsent;
+}
+//# sourceMappingURL=runCookieConsent.js.map

package/src/lib/runCookieConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCookieConsent.js","sourceRoot":"","sources":["../../../../../packages/cookie-consent/src/lib/runCookieConsent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAA;AACtD,OAAO,EACL,YAAY,EAEZ,YAAY,EACZ,gBAAgB,GAGjB,MAAM,oBAAoB,CAAA;AAqB3B,SAAS,sBAAsB,CAAC,MAA2B;IACzD,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAC3E,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CACrE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CACrB,CAAA;IAEjB,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAC/D,iBAAiB,CAAC,iBAAiB,CAAC,CAAA;IAEpC,MAAM,mBAAmB,GAAsC;QAC7D,cAAc,EAAE,MAAM,CAAC,EAAE;YACvB,aAAa,CAAC,iBAAiB,CAAC,CAAA;YAChC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAA;QAC1B,CAAC;QACD,SAAS,EAAE,MAAM,CAAC,EAAE;YAClB,aAAa,CAAC,iBAAiB,CAAC,CAAA;YAChC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;QACrB,CAAC;QACD,QAAQ,EAAE,MAAM,CAAC,EAAE;YACjB,aAAa,CAAC,iBAAiB,CAAC,CAAA;YAChC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAA;QACpB,CAAC;QACD,UAAU,EAAE;YACV,CAAC,YAAY,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;aACpC;YACD,CAAC,YAAY,CAAC,EAAE;gBACd,SAAS,EAAE;oBACT,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC9C;gBACD,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;aACpC;YACD,GAAG,UAAU;SACd;QACD,GAAG,IAAI;KACR,CAAA;IAED,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2HG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA2B;IAChE,MAAM,aAAa,GAAG,aAAa,CAAA;IACnC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAE1D,MAAM,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAE5C,OAAO,aAAa,CAAA;AACtB,CAAC"}