@tilli-pro/cookieconsent-plugin 0.7.50 → 0.7.52

package/dist/config/gui-options/scripts/cookiePrefsButtonDragObserver.d.ts

@@ -1,3 +1,4 @@
+import type { ShowPreferencesFn } from "./showPreferences.d";
 /**
  * attach a MutationObserver the **first time** the user hovers over–
  * enabling a limited "drag up" functionality for the floating button.
@@ -14,7 +15,7 @@ export type HTMLDivElementWithDragObserver = HTMLDivElement & {
     _startY?: number | null;
 };
 /** determine whether the user "tapped" or "dragged" (open prefs if "tapped") */
-export declare const ontouchend: HTMLDivElementWithDragObserver["ontouchend"];
+export declare const ontouchend: (this: HTMLDivElementWithDragObserver, e: TouchEvent, showPreferences: ShowPreferencesFn) => void;
 /** store the touch start coordinates */
 export declare const ontouchstart: HTMLDivElementWithDragObserver["ontouchstart"];
 //# sourceMappingURL=cookiePrefsButtonDragObserver.d.ts.map

package/dist/config/gui-options/scripts/cookiePrefsButtonDragObserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cookiePrefsButtonDragObserver.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/cookiePrefsButtonDragObserver.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;yBAuHG,OAAO,SAAS,OAAO,eAAe,cAAc,CAAC,OAAO,SAAS,IAAI,GAC3E,cAAc,GACd,aAAa,CAAC;AAxHlB,wBAwHoB;AAEpB,MAAM,MAAM,8BAA8B,GAAG,cAAc,GAAG;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,UAAU,EA0BlB,8BAA8B,CAAC,YAAY,CAAC,CAAC;AAElD,wCAAwC;AACxC,eAAO,MAAM,YAAY,EAOpB,8BAA8B,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"cookiePrefsButtonDragObserver.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/cookiePrefsButtonDragObserver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;GAQG;yBAuHG,OAAO,SAAS,OAAO,eAAe,cAAc,CAAC,OAAO,SAAS,IAAI,GAC3E,cAAc,GACd,aAAa,CAAC;AAxHlB,wBAwHoB;AAEpB,MAAM,MAAM,8BAA8B,GAAG,cAAc,GAAG;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,UAAU,SACf,8BAA8B,KACjC,UAAU,mBACI,iBAAiB,KACjC,IAuBF,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,YAAY,EAOpB,8BAA8B,CAAC,cAAc,CAAC,CAAC"}

package/dist/config/gui-options/scripts/cookiePrefsButtonDragObserver.js

@@ -1,9 +1,5 @@
 "use client";
 import { buttonId } from "../html-components/ManageCookiePrefsButton";
-// import { showPreferences } from "./injectManageCookiePrefsButton";
-const showPreferences = () => {
-    console.debug("showPreferences");
-};
 /**
  * attach a MutationObserver the **first time** the user hovers over–
  * enabling a limited "drag up" functionality for the floating button.
@@ -119,7 +115,7 @@ export default (function (e) {
         attachDragEvents(button);
 });
 /** determine whether the user "tapped" or "dragged" (open prefs if "tapped") */
-export const ontouchend = function ontouchend(e) {
+export const ontouchend = function ontouchend(e, showPreferences) {
     const touch = e.changedTouches[0];
     const { clientX: endX, clientY: endY } = touch ?? {};
     if (!endX || !endY)
@@ -137,7 +133,7 @@ export const ontouchend = function ontouchend(e) {
     /** reset coordinates to avoid future issues */
     this._startX = null;
     this._startY = null;
-};
+}; // as HTMLDivElementWithDragObserver["ontouchend"]; // disabled since we added `showPreferences` as a param
 /** store the touch start coordinates */
 export const ontouchstart = function ontouchstart(e) {
     const touch = e.touches[0];

package/dist/config/gui-options/scripts/injectManageCookiePrefsButton.d.ts

@@ -1,8 +1,7 @@
-import type * as _CookieConsent from "@tilli-pro/cookieconsent";
-export declare const showPreferences: typeof _CookieConsent.showPreferences;
+import type { ShowPreferencesFn } from "./showPreferences.d";
 /** injects the floating cookie consent "manage preferences" icon button into the DOM */
-declare const inject: () => HTMLDivElement;
+declare const inject: (showPreferences: ShowPreferencesFn) => HTMLDivElement;
 /** entry point */
-export declare function injectManageCookiePrefsButton(): ReturnType<typeof inject>;
+export declare function injectManageCookiePrefsButton(showPreferences: ShowPreferencesFn): ReturnType<typeof inject>;
 export {};
 //# sourceMappingURL=injectManageCookiePrefsButton.d.ts.map

package/dist/config/gui-options/scripts/injectManageCookiePrefsButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injectManageCookiePrefsButton.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/injectManageCookiePrefsButton.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,cAAc,MAAM,0BAA0B,CAAC;AAiBhE,eAAO,MAAM,eAAe,uCAIoC,CAAC;AAEjE,wFAAwF;AACxF,QAAA,MAAM,MAAM,QAAO,cAkBlB,CAAC;AAEF,kBAAkB;AAClB,wBAAgB,6BAA6B,IAAI,UAAU,CAAC,OAAO,MAAM,CAAC,CAiBzE"}
+{"version":3,"file":"injectManageCookiePrefsButton.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/injectManageCookiePrefsButton.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,wFAAwF;AACxF,QAAA,MAAM,MAAM,oBAAqB,iBAAiB,KAAG,cAkBpD,CAAC;AAEF,kBAAkB;AAClB,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,iBAAiB,GACjC,UAAU,CAAC,OAAO,MAAM,CAAC,CAkB3B"}

package/dist/config/gui-options/scripts/injectManageCookiePrefsButton.js

@@ -1,19 +1,15 @@
 "use client";
 import ManageCookiePrefsButton, { containerId, } from "../html-components/ManageCookiePrefsButton";
 import cookiePrefsButtonDragObserver, { ontouchend, ontouchstart, } from "./cookiePrefsButtonDragObserver";
-export const showPreferences = typeof CookieConsent !== "undefined" &&
-    typeof CookieConsent.showPreferences === "function"
-    ? CookieConsent.showPreferences
-    : (await import("@tilli-pro/cookieconsent")).showPreferences;
 /** injects the floating cookie consent "manage preferences" icon button into the DOM */
-const inject = () => {
+const inject = (showPreferences) => {
     const container = document.body.appendChild(Object.assign(document.createElement("div"), {
         id: containerId,
         innerHTML: ManageCookiePrefsButton( /* TODO: __LANGUAGE__ */),
         onclick: showPreferences /** prefer over `data-cc="show-preferencesModal"` -- @see https://cookieconsent.orestbida.com/reference/api-reference.html#showpreferences */,
         onmouseover: cookiePrefsButtonDragObserver,
         // [mobile (touch) support]
-        ontouchend,
+        ontouchend: (e) => ontouchend?.call(container, e, showPreferences),
         ontouchstart,
     }));
     /** load drag observer upon DOM injection (unfortunate fix to prevent the need for 2x "ontouchstart" events) */
@@ -21,7 +17,7 @@ const inject = () => {
     return container;
 };
 /** entry point */
-export function injectManageCookiePrefsButton() {
+export function injectManageCookiePrefsButton(showPreferences) {
     return ((container) => {
         /** observe the DOM (to handle the case where the injected manage prefs button somehow gets removed) */
         new MutationObserver(() => {
@@ -30,8 +26,9 @@ export function injectManageCookiePrefsButton() {
             if (alreadyInjected)
                 return;
             /** if the container is no longer in <body>, re-inject */
-            container = inject();
+            container = inject(showPreferences);
         }).observe(document.body, { childList: true, subtree: true });
         return container;
-    })(document.getElementById(containerId) ?? inject());
+    })(document.getElementById(containerId) ??
+        inject(showPreferences));
 }

package/dist/config/gui-options/scripts/showPreferences.mjs.d.ts

@@ -0,0 +1,3 @@
+import type * as _CookieConsent from "@tilli-pro/cookieconsent";
+export declare const showPreferences: typeof _CookieConsent.showPreferences;
+//# sourceMappingURL=showPreferences.mjs.d.ts.map

package/dist/config/gui-options/scripts/showPreferences.mjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showPreferences.mjs.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/showPreferences.mjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,cAAc,MAAM,0BAA0B,CAAC;AAShE,eAAO,MAAM,eAAe,uCAQc,CAAC"}

package/dist/config/gui-options/scripts/showPreferences.mjs.js

@@ -0,0 +1,6 @@
+export const showPreferences = typeof CookieConsent !== "undefined" &&
+    typeof CookieConsent.showPreferences === "function"
+    ? CookieConsent.showPreferences
+    : (() => {
+        console.error("Attempted to open cookie preferences modal, but the cookie consent plugin is not available at this time.");
+    })();

package/dist/config/gui-options/scripts/showPreferences.node.d.ts

@@ -0,0 +1,2 @@
+export { showPreferences } from "@tilli-pro/cookieconsent";
+//# sourceMappingURL=showPreferences.node.d.ts.map

package/dist/config/gui-options/scripts/showPreferences.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showPreferences.node.d.ts","sourceRoot":"","sources":["../../../../src/config/gui-options/scripts/showPreferences.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/config/gui-options/scripts/showPreferences.node.js

@@ -0,0 +1 @@
+export { showPreferences } from "@tilli-pro/cookieconsent";

package/dist/init/brf.js

@@ -3,6 +3,7 @@ import { LABELS } from "../config/categories/labels";
 import cookies from "../config/cookies";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 // TODO: auto-detect detect language
 const __LANGUAGE__ = "en"; // "English" ("English")
 const categories = {
@@ -61,5 +62,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (BRF)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/nudge-website.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 const categories = {
     necessary: {
         enabled: true, // "necessary" category is always enabled.
@@ -120,5 +121,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/nudge.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 const categories = {
     necessary: {
         enabled: true, // "necessary" category is always enabled.
@@ -28,5 +29,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/tilli-pay-website.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 // TODO: migrate from monay.com to tillipay.com
 const categories = {
     necessary: {
@@ -200,5 +201,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/tilli-pay.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 const categories = {
     necessary: {
         enabled: true, // "necessary" category is always enabled.
@@ -18,5 +19,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/tilli-website.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 const categories = {
     necessary: {
         enabled: true, // "necessary" category is always enabled.
@@ -206,5 +207,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/tilliX.js

@@ -1,6 +1,7 @@
 import _config from "../config";
 import { run } from "../init";
 import { makeInitFn, stripInvalidLinkedCategoriesFromTranslations, } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 const categories = {
     necessary: {
         enabled: true, // "necessary" category is always enabled.
@@ -20,5 +21,5 @@ const config = {
     language,
 };
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/dist/init/utils.d.ts

@@ -1,5 +1,6 @@
 import type { CookieConsentConfig } from "@tilli-pro/cookieconsent";
 import type * as CookieConsent from "@tilli-pro/cookieconsent";
-export declare const makeInitFn: (initFn: typeof CookieConsent.run, config: CookieConsentConfig) => () => Promise<void>;
+import type { ShowPreferencesFn } from "../config/gui-options/scripts/showPreferences.d";
+export declare const makeInitFn: (initFn: typeof CookieConsent.run, config: CookieConsentConfig, showPreferences: ShowPreferencesFn) => () => Promise<void>;
 export declare const stripInvalidLinkedCategoriesFromTranslations: (translations: CookieConsentConfig["language"]["translations"], categories: CookieConsentConfig["categories"], alsoClearCookieTables?: boolean) => CookieConsentConfig["language"]["translations"];
 //# sourceMappingURL=utils.d.ts.map

package/dist/init/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/init/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAK/D,eAAO,MAAM,UAAU,WACb,OAAO,aAAa,CAAC,GAAG,UACxB,mBAAmB,wBAiB5B,CAAC;AAEF,eAAO,MAAM,4CAA4C,iBACzC,mBAAmB,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,cACjD,mBAAmB,CAAC,YAAY,CAAC,0BACtB,OAAO,KAC7B,mBAAmB,CAAC,UAAU,CAAC,CAAC,cAAc,CAkC9C,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/init/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAI/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,eAAO,MAAM,UAAU,WACb,OAAO,aAAa,CAAC,GAAG,UACxB,mBAAmB,mBACV,iBAAiB,wBAiBnC,CAAC;AAEF,eAAO,MAAM,4CAA4C,iBACzC,mBAAmB,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,cACjD,mBAAmB,CAAC,YAAY,CAAC,0BACtB,OAAO,KAC7B,mBAAmB,CAAC,UAAU,CAAC,CAAC,cAAc,CAkC9C,CAAC"}

package/dist/init/utils.js

@@ -1,11 +1,11 @@
 import { injectReactRemoveScrollToggle } from "../config/gui-options/scripts/forceDisableReactRemoveScroll";
 import { injectManageCookiePrefsButton } from "../config/gui-options/scripts/injectManageCookiePrefsButton";
-export const makeInitFn = (initFn, config) => {
+export const makeInitFn = (initFn, config, showPreferences) => {
     return async () => {
         /** inject the cookie-consent banner (pop-up) */
         await initFn(config);
         /** ...then, inject the floating cookie consent "manage preferences" icon button into the DOM (floats @ the bottom right) */
-        injectManageCookiePrefsButton();
+        injectManageCookiePrefsButton(showPreferences);
         /** ...and, force-disable "react-remove-scroll" -- only upon opening up the "manage preferences" dialog
          *
          *  > this handles the edge case where there's a shadcn (radix-ui) dialog open

package/dist/react-components/hooks/useCookieConsent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCookieConsent.d.ts","sourceRoot":"","sources":["../../../src/react-components/hooks/useCookieConsent.ts"],"names":[],"mappings":"AAUA,wBAAgB,gBAAgB,SAO/B"}
+{"version":3,"file":"useCookieConsent.d.ts","sourceRoot":"","sources":["../../../src/react-components/hooks/useCookieConsent.ts"],"names":[],"mappings":"AAWA,wBAAgB,gBAAgB,SAO/B"}

package/dist/react-components/hooks/useCookieConsent.js

@@ -4,11 +4,12 @@ import { run } from "@tilli-pro/cookieconsent";
 import { COOKIE_CONSENT_ENABLED } from "../../_consts";
 import config from "../../config";
 import { makeInitFn } from "../../init/utils";
+import { showPreferences } from "../../config/gui-options/scripts/showPreferences.node";
 export function useCookieConsent() {
     useEffect(() => {
         if (!COOKIE_CONSENT_ENABLED)
             return;
-        const init = makeInitFn(run, config);
+        const init = makeInitFn(run, config, showPreferences);
         void init();
     }, []);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tilli-pro/cookieconsent-plugin",
-  "version": "0.7.50",
+  "version": "0.7.52",
   "private": false,
   "publishConfig": {
     "access": "public"

package/src/config/gui-options/scripts/cookiePrefsButtonDragObserver.ts

@@ -3,11 +3,7 @@
 import type * as _CookieConsent from "@tilli-pro/cookieconsent";
 
 import { buttonId } from "../html-components/ManageCookiePrefsButton";
-// import { showPreferences } from "./injectManageCookiePrefsButton";
-
-const showPreferences = () => {
-  console.debug("showPreferences");
-};
+import type { ShowPreferencesFn } from "./showPreferences.d";
 
 /**
  * attach a MutationObserver the **first time** the user hovers over–
@@ -149,6 +145,7 @@ export type HTMLDivElementWithDragObserver = HTMLDivElement & {
 export const ontouchend = function ontouchend(
   this: HTMLDivElementWithDragObserver,
   e: TouchEvent,
+  showPreferences: ShowPreferencesFn,
 ): void {
   const touch = e.changedTouches[0];
   const { clientX: endX, clientY: endY } = touch ?? {};
@@ -172,7 +169,7 @@ export const ontouchend = function ontouchend(
   /** reset coordinates to avoid future issues */
   this._startX = null;
   this._startY = null;
-} as HTMLDivElementWithDragObserver["ontouchend"];
+} // as HTMLDivElementWithDragObserver["ontouchend"]; // disabled since we added `showPreferences` as a param
 
 /** store the touch start coordinates */
 export const ontouchstart = function ontouchstart(

package/src/config/gui-options/scripts/injectManageCookiePrefsButton.ts

@@ -1,7 +1,5 @@
 "use client";
 
-import type * as _CookieConsent from "@tilli-pro/cookieconsent";
-
 import type { HTMLDivElementWithDragObserver } from "./cookiePrefsButtonDragObserver";
 import ManageCookiePrefsButton, {
   containerId,
@@ -10,21 +8,10 @@ import cookiePrefsButtonDragObserver, {
   ontouchend,
   ontouchstart,
 } from "./cookiePrefsButtonDragObserver";
-
-declare const CookieConsent:
-  | {
-      showPreferences?: typeof _CookieConsent.showPreferences;
-    }
-  | undefined;
-
-export const showPreferences =
-  typeof CookieConsent !== "undefined" &&
-  typeof CookieConsent.showPreferences === "function"
-    ? CookieConsent.showPreferences
-    : (await import("@tilli-pro/cookieconsent")).showPreferences;
+import type { ShowPreferencesFn } from "./showPreferences.d";
 
 /** injects the floating cookie consent "manage preferences" icon button into the DOM */
-const inject = (): HTMLDivElement => {
+const inject = (showPreferences: ShowPreferencesFn): HTMLDivElement => {
   const container = document.body.appendChild(
     Object.assign(document.createElement("div"), {
       id: containerId,
@@ -33,7 +20,7 @@ const inject = (): HTMLDivElement => {
         showPreferences /** prefer over `data-cc="show-preferencesModal"` -- @see https://cookieconsent.orestbida.com/reference/api-reference.html#showpreferences */,
       onmouseover: cookiePrefsButtonDragObserver,
       // [mobile (touch) support]
-      ontouchend,
+      ontouchend: (e) => ontouchend?.call(container, e, showPreferences),
       ontouchstart,
     } satisfies Partial<HTMLDivElement>),
   ) as HTMLDivElementWithDragObserver;
@@ -45,7 +32,9 @@ const inject = (): HTMLDivElement => {
 };
 
 /** entry point */
-export function injectManageCookiePrefsButton(): ReturnType<typeof inject> {
+export function injectManageCookiePrefsButton(
+  showPreferences: ShowPreferencesFn,
+): ReturnType<typeof inject> {
   return ((container) => {
     /** observe the DOM (to handle the case where the injected manage prefs button somehow gets removed) */
     new MutationObserver(() => {
@@ -55,11 +44,12 @@ export function injectManageCookiePrefsButton(): ReturnType<typeof inject> {
       if (alreadyInjected) return;
 
       /** if the container is no longer in <body>, re-inject */
-      container = inject();
+      container = inject(showPreferences);
     }).observe(document.body, { childList: true, subtree: true });
 
     return container;
   })(
-    (document.getElementById(containerId) as HTMLDivElement | null) ?? inject(),
+    (document.getElementById(containerId) as HTMLDivElement | null) ??
+      inject(showPreferences),
   );
 }

package/src/config/gui-options/scripts/showPreferences.d.ts

@@ -0,0 +1,5 @@
+import type CookieConsent from "@tilli-pro/cookieconsent";
+
+export type ShowPreferencesFn = NonNullable<
+  NonNullable<typeof CookieConsent>["showPreferences"]
+>;

package/src/config/gui-options/scripts/showPreferences.mjs.ts

@@ -0,0 +1,18 @@
+import type * as _CookieConsent from "@tilli-pro/cookieconsent";
+import type { ShowPreferencesFn } from "./showPreferences.d";
+
+declare const CookieConsent:
+  | {
+      showPreferences?: typeof _CookieConsent.showPreferences;
+    }
+  | undefined;
+
+export const showPreferences =
+  typeof CookieConsent !== "undefined" &&
+  typeof CookieConsent.showPreferences === "function"
+    ? CookieConsent.showPreferences
+    : (() => {
+        console.error(
+          "Attempted to open cookie preferences modal, but the cookie consent plugin is not available at this time.",
+        );
+      })() as unknown as ShowPreferencesFn;

package/src/config/gui-options/scripts/showPreferences.node.ts

@@ -0,0 +1 @@
+export { showPreferences } from "@tilli-pro/cookieconsent";

package/src/init/brf.ts

@@ -8,6 +8,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 // TODO: auto-detect detect language
 const __LANGUAGE__ = "en"; // "English" ("English")
@@ -74,5 +75,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (BRF)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/nudge-website.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 const categories: CookieConsentConfig["categories"] = {
   necessary: {
@@ -136,5 +137,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/nudge.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 const categories: CookieConsentConfig["categories"] = {
   necessary: {
@@ -41,5 +42,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/tilli-pay-website.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 // TODO: migrate from monay.com to tillipay.com
 
@@ -217,5 +218,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/tilli-pay.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 const categories: CookieConsentConfig["categories"] = {
   necessary: {
@@ -31,5 +32,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/tilli-website.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 const categories: CookieConsentConfig["categories"] = {
   necessary: {
@@ -223,5 +224,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/tilliX.ts

@@ -6,6 +6,7 @@ import {
   makeInitFn,
   stripInvalidLinkedCategoriesFromTranslations,
 } from "./utils";
+import { showPreferences } from "../config/gui-options/scripts/showPreferences.mjs";
 
 const categories: CookieConsentConfig["categories"] = {
   necessary: {
@@ -33,5 +34,5 @@ const config: CookieConsentConfig = {
 };
 
 // console.debug({ config }, "Initializing Cookie Consent (tilli Website)...");
-const init = makeInitFn(run, config);
+const init = makeInitFn(run, config, showPreferences);
 void init();

package/src/init/utils.ts

@@ -3,17 +3,19 @@ import type * as CookieConsent from "@tilli-pro/cookieconsent";
 
 import { injectReactRemoveScrollToggle } from "../config/gui-options/scripts/forceDisableReactRemoveScroll";
 import { injectManageCookiePrefsButton } from "../config/gui-options/scripts/injectManageCookiePrefsButton";
+import type { ShowPreferencesFn } from "../config/gui-options/scripts/showPreferences.d";
 
 export const makeInitFn = (
   initFn: typeof CookieConsent.run,
   config: CookieConsentConfig,
+  showPreferences: ShowPreferencesFn,
 ) => {
   return async () => {
     /** inject the cookie-consent banner (pop-up) */
     await initFn(config);
 
     /** ...then, inject the floating cookie consent "manage preferences" icon button into the DOM (floats @ the bottom right) */
-    injectManageCookiePrefsButton();
+    injectManageCookiePrefsButton(showPreferences);
 
     /** ...and, force-disable "react-remove-scroll" -- only upon opening up the "manage preferences" dialog
      *

package/src/react-components/hooks/useCookieConsent.ts

@@ -7,12 +7,13 @@ import { run } from "@tilli-pro/cookieconsent";
 import { COOKIE_CONSENT_ENABLED } from "../../_consts";
 import config from "../../config";
 import { makeInitFn } from "../../init/utils";
+import { showPreferences } from "../../config/gui-options/scripts/showPreferences.node";
 
 export function useCookieConsent() {
   useEffect(() => {
     if (!COOKIE_CONSENT_ENABLED) return;
 
-    const init = makeInitFn(run, config);
+    const init = makeInitFn(run, config, showPreferences);
     void init();
   }, []);
 }