@pallasoft/ps-core-components 2.32.0 → 2.34.0

package/dist/analytics/index.d.ts

@@ -0,0 +1,12 @@
+export * from '../components/ps-analytics-provider';
+export * from '../components/ps-client-error-reporter';
+export * from '../components/ps-consent-banner';
+export * from '../constants/ps-analytics-config';
+export * from '../constants/ps-client-error-config';
+export * from '../hooks/use-consent';
+export * from '../models/analytics-csp-input';
+export * from '../models/analytics-csp-origins';
+export * from '../models/ps-consent-api';
+export * from '../models/ps-consent-choice';
+export * from '../services/analytics-csp-service';
+export * from './report-client-error';

package/dist/analytics/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../components/ps-analytics-provider"), exports);
+__exportStar(require("../components/ps-client-error-reporter"), exports);
+__exportStar(require("../components/ps-consent-banner"), exports);
+__exportStar(require("../constants/ps-analytics-config"), exports);
+__exportStar(require("../constants/ps-client-error-config"), exports);
+__exportStar(require("../hooks/use-consent"), exports);
+__exportStar(require("../models/analytics-csp-input"), exports);
+__exportStar(require("../models/analytics-csp-origins"), exports);
+__exportStar(require("../models/ps-consent-api"), exports);
+__exportStar(require("../models/ps-consent-choice"), exports);
+__exportStar(require("../services/analytics-csp-service"), exports);
+__exportStar(require("./report-client-error"), exports);

package/dist/analytics/report-client-error.d.ts

@@ -0,0 +1 @@
+export declare const reportClientError: (error: unknown, context?: string) => void;

package/dist/analytics/report-client-error.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportClientError = void 0;
+const ps_client_error_service_1 = require("../services/ps-client-error-service");
+const reportClientError = (error, context) => ps_client_error_service_1.PsClientErrorService.report(error, context);
+exports.reportClientError = reportClientError;

package/dist/components/ps-analytics-provider.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+export interface PsAnalyticsProviderProps {
+    children?: ReactNode;
+    googleAnalyticsId?: string;
+    googleTagManagerUrl?: string;
+    postHogKey?: string;
+    postHogApiHost?: string;
+    userId?: string | null;
+    appVersion?: string;
+    nonce?: string;
+    consentCookieName?: string;
+    pathname?: string;
+}
+export declare const PsAnalyticsProvider: ({ children, googleAnalyticsId, googleTagManagerUrl, postHogKey, postHogApiHost, userId, appVersion, nonce, consentCookieName, pathname, }: PsAnalyticsProviderProps) => import("react").JSX.Element;

package/dist/components/ps-analytics-provider.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsAnalyticsProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const ps_analytics_config_1 = require("../constants/ps-analytics-config");
+const use_consent_1 = require("../hooks/use-consent");
+const ps_analytics_key_service_1 = require("../services/ps-analytics-key-service");
+const ps_google_analytics_service_1 = require("../services/ps-google-analytics-service");
+const ps_post_hog_service_1 = require("../services/ps-post-hog-service");
+const PsAnalyticsProvider = ({ children, googleAnalyticsId, googleTagManagerUrl = ps_analytics_config_1.PsAnalyticsConfig.defaultTagManagerUrl, postHogKey, postHogApiHost, userId, appVersion, nonce, consentCookieName = ps_analytics_config_1.PsAnalyticsConfig.defaultConsentCookieName, pathname, }) => {
+    const { isGranted } = (0, use_consent_1.useConsent)(consentCookieName);
+    const [postHog, setPostHog] = (0, react_1.useState)(null);
+    const identifiedRef = (0, react_1.useRef)(null);
+    const isGoogleOn = ps_analytics_key_service_1.PsAnalyticsKeyService.isEnabled(googleAnalyticsId);
+    const isPostHogOn = ps_analytics_key_service_1.PsAnalyticsKeyService.isEnabled(postHogKey);
+    const currentPath = pathname !== undefined ? pathname : '';
+    const normalizedUserId = userId ? userId : null;
+    (0, react_1.useEffect)(() => {
+        if (!isGoogleOn)
+            return;
+        if (!isGranted) {
+            ps_google_analytics_service_1.PsGoogleAnalyticsService.disable(googleAnalyticsId);
+            return;
+        }
+        ps_google_analytics_service_1.PsGoogleAnalyticsService.load(googleAnalyticsId, googleTagManagerUrl, nonce);
+    }, [isGoogleOn, isGranted, googleAnalyticsId, googleTagManagerUrl, nonce]);
+    (0, react_1.useEffect)(() => {
+        if (!isGoogleOn || !isGranted)
+            return;
+        ps_google_analytics_service_1.PsGoogleAnalyticsService.configure(googleAnalyticsId, currentPath, normalizedUserId);
+    }, [isGoogleOn, isGranted, googleAnalyticsId, currentPath, normalizedUserId]);
+    (0, react_1.useEffect)(() => {
+        if (!isPostHogOn)
+            return;
+        if (!isGranted) {
+            if (postHog)
+                postHog.opt_out_capturing();
+            return;
+        }
+        let isCancelled = false;
+        ps_post_hog_service_1.PsPostHogService.load(postHogKey, postHogApiHost).then((client) => {
+            if (!isCancelled)
+                setPostHog(client);
+        });
+        return () => {
+            isCancelled = true;
+        };
+    }, [isPostHogOn, isGranted, postHogKey, postHogApiHost]);
+    (0, react_1.useEffect)(() => {
+        if (!postHog || !isGranted)
+            return;
+        if (normalizedUserId) {
+            postHog.identify(normalizedUserId, appVersion ? { app_version: appVersion } : undefined);
+            identifiedRef.current = normalizedUserId;
+            return;
+        }
+        if (identifiedRef.current) {
+            postHog.reset();
+            identifiedRef.current = null;
+        }
+    }, [postHog, isGranted, normalizedUserId, appVersion]);
+    (0, react_1.useEffect)(() => {
+        if (!postHog || !isGranted)
+            return;
+        postHog.capture(ps_analytics_config_1.PsAnalyticsConfig.postHog.pageviewEvent, {
+            $pathname: currentPath,
+        });
+    }, [postHog, isGranted, currentPath]);
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
+};
+exports.PsAnalyticsProvider = PsAnalyticsProvider;

package/dist/components/ps-client-error-reporter.d.ts

@@ -0,0 +1,5 @@
+export interface PsClientErrorReporterProps {
+    endpoint: string;
+    appVersion?: string;
+}
+export declare const PsClientErrorReporter: ({ endpoint, appVersion }: PsClientErrorReporterProps) => null;

package/dist/components/ps-client-error-reporter.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsClientErrorReporter = void 0;
+const react_1 = require("react");
+const ps_client_error_config_1 = require("../constants/ps-client-error-config");
+const ps_client_error_service_1 = require("../services/ps-client-error-service");
+const PsClientErrorReporter = ({ endpoint, appVersion }) => {
+    (0, react_1.useEffect)(() => {
+        ps_client_error_service_1.PsClientErrorService.configure({ endpoint, appVersion });
+        const onError = (event) => ps_client_error_service_1.PsClientErrorService.report(event.error ? event.error : event.message, '', ps_client_error_config_1.PsClientErrorConfig.sources.error);
+        const onRejection = (event) => ps_client_error_service_1.PsClientErrorService.report(event.reason, '', ps_client_error_config_1.PsClientErrorConfig.sources.rejection);
+        window.addEventListener('error', onError);
+        window.addEventListener('unhandledrejection', onRejection);
+        return () => {
+            window.removeEventListener('error', onError);
+            window.removeEventListener('unhandledrejection', onRejection);
+            ps_client_error_service_1.PsClientErrorService.clear();
+        };
+    }, [endpoint, appVersion]);
+    return null;
+};
+exports.PsClientErrorReporter = PsClientErrorReporter;

package/dist/components/ps-consent-banner.d.ts

@@ -0,0 +1,11 @@
+export interface PsConsentBannerProps {
+    title: string;
+    message: string;
+    acceptLabel: string;
+    rejectLabel: string;
+    privacyPolicyHref: string;
+    privacyPolicyLabel: string;
+    consentCookieName?: string;
+    className?: string;
+}
+export declare const PsConsentBanner: ({ title, message, acceptLabel, rejectLabel, privacyPolicyHref, privacyPolicyLabel, consentCookieName, className, }: PsConsentBannerProps) => import("react").JSX.Element | null;

package/dist/components/ps-consent-banner.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsConsentBanner = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const ps_design_system_1 = require("@pallasoft/ps-design-system");
+const ps_analytics_config_1 = require("../constants/ps-analytics-config");
+const use_consent_1 = require("../hooks/use-consent");
+const ps_button_1 = require("./ps-button");
+const PsConsentBanner = ({ title, message, acceptLabel, rejectLabel, privacyPolicyHref, privacyPolicyLabel, consentCookieName = ps_analytics_config_1.PsAnalyticsConfig.defaultConsentCookieName, className, }) => {
+    const { isBannerOpen, accept, reject } = (0, use_consent_1.useConsent)(consentCookieName);
+    const ref = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (isBannerOpen)
+            ref.current?.focus();
+    }, [isBannerOpen]);
+    if (!isBannerOpen)
+        return null;
+    return ((0, jsx_runtime_1.jsxs)("div", { ref: ref, role: 'dialog', "aria-label": title, "aria-live": 'polite', tabIndex: -1, className: `ps-card fixed inset-x-3 bottom-3 flex flex-col gap-3 p-4 shadow-lg outline-none sm:left-auto sm:right-4 sm:max-w-md ${className ? className : ''}`, style: { zIndex: ps_design_system_1.PallasoftZIndex.Toast }, children: [(0, jsx_runtime_1.jsxs)("p", { className: 'text-sm', children: [message, ' ', (0, jsx_runtime_1.jsx)("a", { className: 'underline', href: privacyPolicyHref, children: privacyPolicyLabel })] }), (0, jsx_runtime_1.jsxs)("div", { className: 'flex gap-2', children: [(0, jsx_runtime_1.jsx)(ps_button_1.PsButton, { className: 'flex-1', size: 'compact', variant: 'secondary', onClick: reject, children: rejectLabel }), (0, jsx_runtime_1.jsx)(ps_button_1.PsButton, { className: 'flex-1', size: 'compact', variant: 'secondary', onClick: accept, children: acceptLabel })] })] }));
+};
+exports.PsConsentBanner = PsConsentBanner;

package/dist/constants/ps-analytics-config.d.ts

@@ -0,0 +1,19 @@
+export declare const PsAnalyticsConfig: {
+    readonly offValues: readonly ["", "_"];
+    readonly defaultConsentCookieName: "ps_consent";
+    readonly consentGranted: "granted";
+    readonly consentDenied: "denied";
+    readonly consentMaxAgeSeconds: 31536000;
+    readonly defaultTagManagerUrl: "https://www.googletagmanager.com";
+    readonly tagManagerScriptPath: "/gtag/js?id=";
+    readonly scriptAttribute: "data-ps-analytics";
+    readonly postHog: {
+        readonly defaults: "2026-05-30";
+        readonly personProfiles: "identified_only";
+        readonly autocapture: true;
+        readonly capturePageleave: true;
+        readonly captureExceptions: true;
+        readonly pageviewEvent: "$pageview";
+    };
+    readonly listSeparator: ",";
+};

package/dist/constants/ps-analytics-config.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsAnalyticsConfig = void 0;
+exports.PsAnalyticsConfig = {
+    offValues: ['', '_'],
+    defaultConsentCookieName: 'ps_consent',
+    consentGranted: 'granted',
+    consentDenied: 'denied',
+    consentMaxAgeSeconds: 31536000,
+    defaultTagManagerUrl: 'https://www.googletagmanager.com',
+    tagManagerScriptPath: '/gtag/js?id=',
+    scriptAttribute: 'data-ps-analytics',
+    postHog: {
+        defaults: '2026-05-30',
+        personProfiles: 'identified_only',
+        autocapture: true,
+        capturePageleave: true,
+        captureExceptions: true,
+        pageviewEvent: '$pageview',
+    },
+    listSeparator: ',',
+};

package/dist/constants/ps-client-error-config.d.ts

@@ -0,0 +1,23 @@
+export declare const PsClientErrorConfig: {
+    readonly maxReportsPerPage: 10;
+    readonly maxStackLength: 2048;
+    readonly maxMessageLength: 500;
+    readonly maxContextLength: 200;
+    readonly jsonContentType: "application/json";
+    readonly emailPattern: RegExp;
+    readonly redactedValue: "[redacted]";
+    readonly unknownMessage: "Unknown error";
+    readonly botPattern: RegExp;
+    readonly mobilePattern: RegExp;
+    readonly userAgentClasses: {
+        readonly bot: "bot";
+        readonly mobile: "mobile";
+        readonly desktop: "desktop";
+        readonly unknown: "unknown";
+    };
+    readonly sources: {
+        readonly error: "error";
+        readonly rejection: "unhandledrejection";
+        readonly boundary: "boundary";
+    };
+};

package/dist/constants/ps-client-error-config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PsClientErrorConfig = void 0;
+exports.PsClientErrorConfig = {
+    maxReportsPerPage: 10,
+    maxStackLength: 2048,
+    maxMessageLength: 500,
+    maxContextLength: 200,
+    jsonContentType: 'application/json',
+    emailPattern: /[^\s@"'()<>]+@[^\s@"'()<>]+\.[^\s@"'()<>]+/g,
+    redactedValue: '[redacted]',
+    unknownMessage: 'Unknown error',
+    botPattern: /bot|crawl|spider|slurp|headless/i,
+    mobilePattern: /mobi|android|iphone|ipad/i,
+    userAgentClasses: { bot: 'bot', mobile: 'mobile', desktop: 'desktop', unknown: 'unknown' },
+    sources: { error: 'error', rejection: 'unhandledrejection', boundary: 'boundary' },
+};

package/dist/esm/analytics/index.js

@@ -0,0 +1,12 @@
+export * from '../components/ps-analytics-provider';
+export * from '../components/ps-client-error-reporter';
+export * from '../components/ps-consent-banner';
+export * from '../constants/ps-analytics-config';
+export * from '../constants/ps-client-error-config';
+export * from '../hooks/use-consent';
+export * from '../models/analytics-csp-input';
+export * from '../models/analytics-csp-origins';
+export * from '../models/ps-consent-api';
+export * from '../models/ps-consent-choice';
+export * from '../services/analytics-csp-service';
+export * from './report-client-error';

package/dist/esm/analytics/report-client-error.js

@@ -0,0 +1,2 @@
+import { PsClientErrorService } from '../services/ps-client-error-service';
+export const reportClientError = (error, context) => PsClientErrorService.report(error, context);

package/dist/esm/components/ps-analytics-provider.js

@@ -0,0 +1,68 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { PsAnalyticsConfig } from '../constants/ps-analytics-config';
+import { useConsent } from '../hooks/use-consent';
+import { PsAnalyticsKeyService } from '../services/ps-analytics-key-service';
+import { PsGoogleAnalyticsService } from '../services/ps-google-analytics-service';
+import { PsPostHogService } from '../services/ps-post-hog-service';
+export const PsAnalyticsProvider = ({ children, googleAnalyticsId, googleTagManagerUrl = PsAnalyticsConfig.defaultTagManagerUrl, postHogKey, postHogApiHost, userId, appVersion, nonce, consentCookieName = PsAnalyticsConfig.defaultConsentCookieName, pathname, }) => {
+    const { isGranted } = useConsent(consentCookieName);
+    const [postHog, setPostHog] = useState(null);
+    const identifiedRef = useRef(null);
+    const isGoogleOn = PsAnalyticsKeyService.isEnabled(googleAnalyticsId);
+    const isPostHogOn = PsAnalyticsKeyService.isEnabled(postHogKey);
+    const currentPath = pathname !== undefined ? pathname : '';
+    const normalizedUserId = userId ? userId : null;
+    useEffect(() => {
+        if (!isGoogleOn)
+            return;
+        if (!isGranted) {
+            PsGoogleAnalyticsService.disable(googleAnalyticsId);
+            return;
+        }
+        PsGoogleAnalyticsService.load(googleAnalyticsId, googleTagManagerUrl, nonce);
+    }, [isGoogleOn, isGranted, googleAnalyticsId, googleTagManagerUrl, nonce]);
+    useEffect(() => {
+        if (!isGoogleOn || !isGranted)
+            return;
+        PsGoogleAnalyticsService.configure(googleAnalyticsId, currentPath, normalizedUserId);
+    }, [isGoogleOn, isGranted, googleAnalyticsId, currentPath, normalizedUserId]);
+    useEffect(() => {
+        if (!isPostHogOn)
+            return;
+        if (!isGranted) {
+            if (postHog)
+                postHog.opt_out_capturing();
+            return;
+        }
+        let isCancelled = false;
+        PsPostHogService.load(postHogKey, postHogApiHost).then((client) => {
+            if (!isCancelled)
+                setPostHog(client);
+        });
+        return () => {
+            isCancelled = true;
+        };
+    }, [isPostHogOn, isGranted, postHogKey, postHogApiHost]);
+    useEffect(() => {
+        if (!postHog || !isGranted)
+            return;
+        if (normalizedUserId) {
+            postHog.identify(normalizedUserId, appVersion ? { app_version: appVersion } : undefined);
+            identifiedRef.current = normalizedUserId;
+            return;
+        }
+        if (identifiedRef.current) {
+            postHog.reset();
+            identifiedRef.current = null;
+        }
+    }, [postHog, isGranted, normalizedUserId, appVersion]);
+    useEffect(() => {
+        if (!postHog || !isGranted)
+            return;
+        postHog.capture(PsAnalyticsConfig.postHog.pageviewEvent, {
+            $pathname: currentPath,
+        });
+    }, [postHog, isGranted, currentPath]);
+    return _jsx(_Fragment, { children: children });
+};

package/dist/esm/components/ps-client-error-reporter.js

@@ -0,0 +1,18 @@
+import { useEffect } from 'react';
+import { PsClientErrorConfig } from '../constants/ps-client-error-config';
+import { PsClientErrorService } from '../services/ps-client-error-service';
+export const PsClientErrorReporter = ({ endpoint, appVersion }) => {
+    useEffect(() => {
+        PsClientErrorService.configure({ endpoint, appVersion });
+        const onError = (event) => PsClientErrorService.report(event.error ? event.error : event.message, '', PsClientErrorConfig.sources.error);
+        const onRejection = (event) => PsClientErrorService.report(event.reason, '', PsClientErrorConfig.sources.rejection);
+        window.addEventListener('error', onError);
+        window.addEventListener('unhandledrejection', onRejection);
+        return () => {
+            window.removeEventListener('error', onError);
+            window.removeEventListener('unhandledrejection', onRejection);
+            PsClientErrorService.clear();
+        };
+    }, [endpoint, appVersion]);
+    return null;
+};

package/dist/esm/components/ps-consent-banner.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { PallasoftZIndex } from '@pallasoft/ps-design-system';
+import { PsAnalyticsConfig } from '../constants/ps-analytics-config';
+import { useConsent } from '../hooks/use-consent';
+import { PsButton } from './ps-button';
+export const PsConsentBanner = ({ title, message, acceptLabel, rejectLabel, privacyPolicyHref, privacyPolicyLabel, consentCookieName = PsAnalyticsConfig.defaultConsentCookieName, className, }) => {
+    const { isBannerOpen, accept, reject } = useConsent(consentCookieName);
+    const ref = useRef(null);
+    useEffect(() => {
+        if (isBannerOpen)
+            ref.current?.focus();
+    }, [isBannerOpen]);
+    if (!isBannerOpen)
+        return null;
+    return (_jsxs("div", { ref: ref, role: 'dialog', "aria-label": title, "aria-live": 'polite', tabIndex: -1, className: `ps-card fixed inset-x-3 bottom-3 flex flex-col gap-3 p-4 shadow-lg outline-none sm:left-auto sm:right-4 sm:max-w-md ${className ? className : ''}`, style: { zIndex: PallasoftZIndex.Toast }, children: [_jsxs("p", { className: 'text-sm', children: [message, ' ', _jsx("a", { className: 'underline', href: privacyPolicyHref, children: privacyPolicyLabel })] }), _jsxs("div", { className: 'flex gap-2', children: [_jsx(PsButton, { className: 'flex-1', size: 'compact', variant: 'secondary', onClick: reject, children: rejectLabel }), _jsx(PsButton, { className: 'flex-1', size: 'compact', variant: 'secondary', onClick: accept, children: acceptLabel })] })] }));
+};

package/dist/esm/constants/ps-analytics-config.js

@@ -0,0 +1,19 @@
+export const PsAnalyticsConfig = {
+    offValues: ['', '_'],
+    defaultConsentCookieName: 'ps_consent',
+    consentGranted: 'granted',
+    consentDenied: 'denied',
+    consentMaxAgeSeconds: 31536000,
+    defaultTagManagerUrl: 'https://www.googletagmanager.com',
+    tagManagerScriptPath: '/gtag/js?id=',
+    scriptAttribute: 'data-ps-analytics',
+    postHog: {
+        defaults: '2026-05-30',
+        personProfiles: 'identified_only',
+        autocapture: true,
+        capturePageleave: true,
+        captureExceptions: true,
+        pageviewEvent: '$pageview',
+    },
+    listSeparator: ',',
+};

package/dist/esm/constants/ps-client-error-config.js

@@ -0,0 +1,14 @@
+export const PsClientErrorConfig = {
+    maxReportsPerPage: 10,
+    maxStackLength: 2048,
+    maxMessageLength: 500,
+    maxContextLength: 200,
+    jsonContentType: 'application/json',
+    emailPattern: /[^\s@"'()<>]+@[^\s@"'()<>]+\.[^\s@"'()<>]+/g,
+    redactedValue: '[redacted]',
+    unknownMessage: 'Unknown error',
+    botPattern: /bot|crawl|spider|slurp|headless/i,
+    mobilePattern: /mobi|android|iphone|ipad/i,
+    userAgentClasses: { bot: 'bot', mobile: 'mobile', desktop: 'desktop', unknown: 'unknown' },
+    sources: { error: 'error', rejection: 'unhandledrejection', boundary: 'boundary' },
+};

package/dist/esm/hooks/use-consent.js

@@ -0,0 +1,17 @@
+import { useCallback, useSyncExternalStore } from 'react';
+import { PsAnalyticsConfig } from '../constants/ps-analytics-config';
+import { PsConsentService } from '../services/ps-consent-service';
+export const useConsent = (consentCookieName = PsAnalyticsConfig.defaultConsentCookieName) => {
+    const state = useSyncExternalStore((listener) => PsConsentService.subscribe(listener), () => PsConsentService.snapshot(consentCookieName), () => PsConsentService.serverState);
+    const accept = useCallback(() => PsConsentService.choose(consentCookieName, PsAnalyticsConfig.consentGranted), [consentCookieName]);
+    const reject = useCallback(() => PsConsentService.choose(consentCookieName, PsAnalyticsConfig.consentDenied), [consentCookieName]);
+    const reopen = useCallback(() => PsConsentService.reopen(consentCookieName), [consentCookieName]);
+    return {
+        choice: state.choice,
+        isGranted: state.choice === PsAnalyticsConfig.consentGranted,
+        isBannerOpen: state === PsConsentService.serverState ? false : state.choice === null || state.isReopened,
+        accept,
+        reject,
+        reopen,
+    };
+};

package/dist/esm/hooks/use-ps-debounced-revalidate.js

@@ -0,0 +1,23 @@
+import { useCallback, useEffect, useRef } from 'react';
+export const usePsDebouncedRevalidate = (revalidator, delayMilliseconds) => {
+    const latest = useRef(revalidator);
+    const timer = useRef(null);
+    latest.current = revalidator;
+    const fire = useCallback(() => {
+        timer.current = null;
+        if (latest.current.state !== 'idle') {
+            timer.current = setTimeout(fire, delayMilliseconds);
+            return;
+        }
+        void latest.current.revalidate();
+    }, [delayMilliseconds]);
+    useEffect(() => () => {
+        if (timer.current !== null)
+            clearTimeout(timer.current);
+    }, []);
+    return useCallback(() => {
+        if (timer.current !== null)
+            clearTimeout(timer.current);
+        timer.current = setTimeout(fire, delayMilliseconds);
+    }, [delayMilliseconds, fire]);
+};

package/dist/esm/hooks/use-ps-live.js

@@ -0,0 +1,34 @@
+import { useEffect, useRef } from 'react';
+export const usePsLive = (input) => {
+    const latest = useRef(input);
+    const { enabled, open, path } = input;
+    const eventKey = input.events.join(',');
+    latest.current = input;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let isActive = true;
+        let close = null;
+        void open({
+            events: latest.current.events,
+            fetchToken: () => latest.current.fetchToken(),
+            onEvent: (name, payload) => latest.current.onEvent(name, payload),
+            onResume: () => {
+                const { onResume } = latest.current;
+                if (onResume !== undefined)
+                    onResume();
+            },
+            path,
+        }).then((handle) => {
+            if (isActive)
+                close = () => handle.close();
+            else
+                handle.close();
+        });
+        return () => {
+            isActive = false;
+            if (close !== null)
+                close();
+        };
+    }, [enabled, eventKey, open, path]);
+};

package/dist/esm/index.js

@@ -76,6 +76,8 @@ export * from './hooks/use-ps-debounced-value';
 export * from './hooks/use-ps-change-queue';
 export * from './interfaces/ps-change-queue-input';
 export * from './interfaces/ps-change-queue-result';
+export * from './hooks/use-ps-live';
+export * from './hooks/use-ps-debounced-revalidate';
 export * from './hooks/use-ps-optimistic-rows';
 export * from './hooks/use-ps-optimistic-fetcher';
 export * from './hooks/use-ps-optimistic-save';
@@ -88,6 +90,9 @@ export * from './services/ps-optimistic-save-service';
 export * from './services/ps-client-param-revalidation-service';
 export * from './interfaces/ps-fetcher-like';
 export * from './interfaces/ps-fetcher-submit-options';
+export * from './interfaces/ps-live-handle';
+export * from './interfaces/ps-live-input';
+export * from './interfaces/ps-live-open-options';
 export * from './interfaces/ps-optimistic-fetcher-input';
 export * from './interfaces/ps-optimistic-fetcher-result';
 export * from './interfaces/ps-revalidator-like';

package/dist/esm/interfaces/ps-live-handle.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/interfaces/ps-live-input.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/interfaces/ps-live-open-options.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/analytics-csp-input.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/analytics-csp-origins.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-client-error-payload.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-client-error-settings.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-consent-api.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-consent-choice.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-consent-state.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/models/ps-gtag-window.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/services/analytics-csp-service.js

@@ -0,0 +1,27 @@
+import { PsAnalyticsConfig } from '../constants/ps-analytics-config';
+import { PsAnalyticsKeyService } from './ps-analytics-key-service';
+export class AnalyticsCspService {
+    static origins(input) {
+        const isGoogleOn = PsAnalyticsKeyService.isEnabled(input.googleAnalyticsId);
+        const isPostHogOn = PsAnalyticsKeyService.isEnabled(input.postHogKey);
+        const googleUrls = isGoogleOn ? this.parse(input.googleAnalyticsUrls) : [];
+        const tagManagerUrls = isGoogleOn ? this.parse(input.googleTagManagerUrls) : [];
+        const postHogUrls = isPostHogOn ? this.parse(input.postHogUrls) : [];
+        return {
+            scriptSrc: this.unique([...tagManagerUrls, ...postHogUrls]),
+            connectSrc: this.unique([...googleUrls, ...tagManagerUrls, ...postHogUrls]),
+            imgSrc: this.unique([...googleUrls, ...tagManagerUrls]),
+        };
+    }
+    static parse(value) {
+        if (!value)
+            return [];
+        return value
+            .split(PsAnalyticsConfig.listSeparator)
+            .map((item) => item.trim())
+            .filter((item) => PsAnalyticsKeyService.isEnabled(item));
+    }
+    static unique(values) {
+        return Array.from(new Set(values));
+    }
+}

package/dist/esm/services/ps-analytics-key-service.js

@@ -0,0 +1,8 @@
+import { PsAnalyticsConfig } from '../constants/ps-analytics-config';
+export class PsAnalyticsKeyService {
+    static isEnabled(value) {
+        if (value === null || value === undefined)
+            return false;
+        return !PsAnalyticsConfig.offValues.includes(value.trim());
+    }
+}