@dotcms/analytics 0.0.1-beta.43 → 0.0.1-beta.44

package/README.md

@@ -1,159 +1,226 @@
-# @dotcms/analytics
+# dotCMS Content Analytics SDK (@dotcms/analytics)
 
-`@dotcms/analytics` is the official dotCMS JavaScript library for Content Analytics that helps track events and analytics in your webapps. Available for both browser and React applications.
+Lightweight JavaScript SDK for tracking content-aware events in dotCMS. Works in vanilla JS and React apps. Angular & Vue support coming soon.
 
-## Features
+## 🚀 Quick Start
 
--   **Simple Browser Integration**: Easy to implement via script tags using IIFE implementation
--   **React Support**: Built-in React components and hooks for seamless integration
--   **Event Tracking**: Simple API to track custom events with additional properties
--   **Automatic PageView**: Option to automatically track page views
--   **Debug Mode**: Optional debug logging for development
+### Vanilla JavaScript
 
-## Installation
+**CDN (Script Tag - Auto Page View)**
+
+```html
+<script
+    src="ca.min.js"
+    data-analytics-server="https://demo.dotcms.com"
+    data-analytics-key="SITE_KEY"
+    data-analytics-auto-page-view></script>
+```
+
+**npm (ES Module)**
 
 ```bash
 npm install @dotcms/analytics
 ```
 
-Or include the script in your HTML page:
+```javascript
+import { initializeContentAnalytics } from '@dotcms/analytics';
 
-```html
-<script src="ca.min.js"></script>
-```
+const analytics = initializeContentAnalytics({
+    siteKey: 'SITE_KEY',
+    server: 'https://demo.dotcms.com'
+});
 
-## React Integration
+analytics.track('page-loaded');
+```
 
-### Provider Setup
+### React
 
-First, import the provider:
+```bash
+npm install @dotcms/analytics
+```
 
 ```tsx
 import { DotContentAnalyticsProvider } from '@dotcms/analytics/react';
-```
 
-Wrap your application with the `DotContentAnalyticsProvider`:
-
-```tsx
-// Example configuration
-const analyticsConfig = {
-    apiKey: 'your-api-key-from-dotcms-analytics-app',
-    server: 'https://your-dotcms-instance.com'
+const config = {
+    siteKey: 'SITE_KEY',
+    server: 'https://demo.dotcms.com',
+    autoPageView: true // Optional, default is true
 };
 
-function App() {
-    return (
-        <DotContentAnalyticsProvider config={analyticsConfig}>
-            <YourApp />
-        </DotContentAnalyticsProvider>
-    );
-}
+<DotContentAnalyticsProvider config={config}>
+    <App />
+</DotContentAnalyticsProvider>;
 ```
 
-### Tracking Custom Events
+## 📘 Core Concepts
 
-Use the `useContentAnalytics` hook to track custom events:
+### Events
 
-```tsx
-import { useContentAnalytics } from '@dotcms/analytics/react';
+Track any user action as an event using `track('event-name', { payload })`.
 
-function Activity({ title, urlTitle }) {
-    const { track } = useContentAnalytics();
+### Page Views
 
-    // First parameter: custom event name to identify the action
-    // Second parameter: object with properties you want to track
+Tracked automatically (or manually) on route changes.
 
-    return <button onClick={() => track('btn-click', { title, urlTitle })}>See Details →</button>;
-}
+### Sessions
+
+-   30-minute timeout
+-   Resets at midnight UTC
+-   New session if UTM campaign changes
+
+### Identity
+
+-   Anonymous user ID persisted across sessions
+-   Stored in `dot_analytics_user_id`
+
+## ⚙️ Configuration Options
+
+| Option         | Type       | Required | Default | Description                            |
+| -------------- | ---------- | -------- | ------- | -------------------------------------- |
+| `siteKey`      | `string`   | ✅       | -       | Site key from dotCMS Analytics app     |
+| `server`       | `string`   | ✅       | -       | Your dotCMS server URL                 |
+| `debug`        | `boolean`  | ❌       | `false` | Enable verbose logging                 |
+| `autoPageView` | `boolean`  | ❌       | `true`  | Auto track page views on route changes |
+| `redirectFn`   | `function` | ❌       | -       | Custom handler for redirects           |
+
+## 🛠️ Usage Examples
+
+### Vanilla JavaScript
+
+**Manual Page View & Events**
+
+```javascript
+// After init with the <script> tag the dotAnalytics is added to the window.
+window.dotAnalytics.track('cta-click', { button: 'Buy Now' });
+window.dotAnalytics.pageView();
 ```
 
-### Manual Page View Tracking
+**Advanced: Manual Init with Custom Properties**
+
+```javascript
+const analytics = initializeContentAnalytics({
+    siteKey: 'abc123',
+    server: 'https://your-dotcms.com',
+    debug: true,
+    autoPageView: false
+});
 
-To manually track page views, first disable automatic tracking in your config:
+analytics.track('custom-event', {
+    category: 'Marketing',
+    value: 'Banner Clicked'
+});
+
+analytics.pageView();
+```
+
+### React
+
+**Track Events**
 
 ```tsx
-const analyticsConfig = {
-    apiKey: 'your-api-key-from-dotcms-analytics-app',
-    server: 'https://your-dotcms-instance.com',
-    autoPageView: false // Disable automatic tracking
-};
+const { track } = useContentAnalytics();
+track('cta-click', { label: 'Download PDF' });
 ```
 
-Then use the `useContentAnalytics` hook in your layout component:
+**Manual Page View**
 
 ```tsx
-import { useContentAnalytics } from '@dotcms/analytics/react';
+const { pageView } = useContentAnalytics();
+useEffect(() => {
+    pageView();
+}, []);
+```
+
+**Advanced: Manual Tracking with Router**
+
+```tsx
+import { useLocation } from 'react-router-dom';
+const { pageView } = useContentAnalytics();
+const location = useLocation();
 
-function Layout({ children }) {
-    const { pageView } = useContentAnalytics();
+useEffect(() => {
+    pageView();
+}, [location]);
+```
 
-    useEffect(() => {
-        pageView({
-            // Add any custom properties you want to track
-            myCustomValue: '2'
-        });
-    }, []);
+## API Reference
 
-    return <div>{children}</div>;
+```typescript
+interface DotCMSAnalytics {
+    track: (eventName: string, payload?: Record<string, unknown>) => void;
+    pageView: () => void;
 }
 ```
 
-## Browser Configuration
+**Enriched AnalyticsEvent includes:**
 
-The script can be configured using data attributes:
+-   `context`: siteKey, sessionId, userId
+-   `page`: URL, title, referrer, path
+-   `device`: screen size, language, viewport
+-   `utm`: source, medium, campaign, term, etc.
 
--   **data-analytics-server**: URL of the server where events will be sent. If not provided, the current domain will be used
--   **data-analytics-debug**: Enables debug logging
--   **data-analytics-auto-page-view**: Recommended for IIFE implementation. Enables automatic page view tracking
--   **data-analytics-key**: **(Required)** API key for authentication
+## Under the Hood
 
-```html
-<!-- Example configuration -->
-<script
-    src="ca.min.js"
-    data-analytics-server="http://localhost:8080"
-    data-analytics-key="dev-key-123"
-    data-analytics-auto-page-view
-    data-analytics-debug></script>
+### Storage Keys
 
-<!-- Without automatic tracking - events must be sent manually -->
-<script
-    src="ca.min.js"
-    data-analytics-server="http://localhost:8080"
-    data-analytics-debug
-    data-analytics-key="dev-key-123"></script>
-```
+-   `dot_analytics_user_id`
+-   `dot_analytics_session_id`
+-   `dot_analytics_session_utm`
+-   `dot_analytics_session_start`
+
+### Editor Detection
+
+Analytics are disabled when inside the dotCMS editor.
+
+## Debugging & Troubleshooting
+
+**Not seeing events?**
+
+-   Ensure `siteKey` & `server` are correct
+-   Enable debug mode
+-   Check network requests to: `https://your-server/api/v1/analytics/content/event`
+-   Avoid using inside dotCMS editor (auto-disabled)
 
 ## Roadmap
 
-The following features are planned for future releases:
+-   Scroll depth & file download tracking
+-   Form interaction analytics
+-   Angular & Vue support
+-   Realtime dashboard
+
+## dotCMS Support
+
+We offer multiple channels to get help with the dotCMS React SDK:
 
-2. **Headless Support**
-    - Angular integration for event tracking
+-   **GitHub Issues**: For bug reports and feature requests, please [open an issue](https://github.com/dotCMS/core/issues/new/choose) in the GitHub repository.
+-   **Community Forum**: Join our [community discussions](https://community.dotcms.com/) to ask questions and share solutions.
+-   **Stack Overflow**: Use the tag `dotcms-react` when posting questions.
+-   **Enterprise Support**: Enterprise customers can access premium support through the [dotCMS Support Portal](https://helpdesk.dotcms.com/support/).
 
-## Contributing
+When reporting issues, please include:
 
-GitHub pull requests are the preferred method to contribute code to dotCMS. Before any pull requests can be accepted, an automated tool will ask you to agree to the [dotCMS Contributor's Agreement](https://gist.github.com/wezell/85ef45298c48494b90d92755b583acb3).
+-   SDK version you're using
+-   React version
+-   Minimal reproduction steps
+-   Expected vs. actual behavior
 
-## Licensing
+## How To Contribute
 
-dotCMS comes in multiple editions and as such is dual licensed. The dotCMS Community Edition is licensed under the GPL 3.0 and is freely available for download, customization and deployment for use within organizations of all stripes. dotCMS Enterprise Editions (EE) adds a number of enterprise features and is available via a supported, indemnified commercial license from dotCMS. For the differences between the editions, see [the feature page](http://dotcms.com/cms-platform/features).
+GitHub pull requests are the preferred method to contribute code to dotCMS. We welcome contributions to the DotCMS UVE SDK! If you'd like to contribute, please follow these steps:
 
-## Support
+1. Fork the repository [dotCMS/core](https://github.com/dotCMS/core)
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
 
-If you need help or have any questions, please [open an issue](https://github.com/dotCMS/core/issues/new/choose) in the GitHub repository.
+Please ensure your code follows the existing style and includes appropriate tests.
 
-## Documentation
+## Licensing Information
 
-Always refer to the official [DotCMS documentation](https://www.dotcms.com/docs/latest/) for comprehensive guides and API references.
+dotCMS comes in multiple editions and as such is dual-licensed. The dotCMS Community Edition is licensed under the GPL 3.0 and is freely available for download, customization, and deployment for use within organizations of all stripes. dotCMS Enterprise Editions (EE) adds several enterprise features and is available via a supported, indemnified commercial license from dotCMS. For the differences between the editions, see [the feature page](http://www.dotcms.com/cms-platform/features).
 
-## Getting Help
+This SDK is part of dotCMS's dual-licensed platform (GPL 3.0 for Community, commercial license for Enterprise).
 
-| Source          | Location                                                            |
-| --------------- | ------------------------------------------------------------------- |
-| Installation    | [Installation](https://dotcms.com/docs/latest/installation)         |
-| Documentation   | [Documentation](https://dotcms.com/docs/latest/table-of-contents)   |
-| Videos          | [Helpful Videos](http://dotcms.com/videos/)                         |
-| Forums/Listserv | [via Google Groups](https://groups.google.com/forum/#!forum/dotCMS) |
-| Twitter         | @dotCMS                                                             |
-| Main Site       | [dotCMS.com](https://dotcms.com/)                                   |
+[Learn more ](https://www.dotcms.com)at [dotcms.com](https://www.dotcms.com).

package/lib/dotAnalytics/plugin/dot-analytics.plugin.js

@@ -1,54 +1,79 @@
+import { EVENT_TYPES as y } from "../shared/dot-content-analytics.constants.js";
 import { sendAnalyticsEventToServer as c } from "../shared/dot-content-analytics.http.js";
-const f = (l) => {
-  let t = !1;
+const p = (v) => {
+  let r = !1;
   return {
     name: "dot-analytics",
-    config: l,
+    config: v,
     /**
      * Initialize the plugin
      */
-    initialize: () => (t = !0, Promise.resolve()),
+    initialize: () => (r = !0, Promise.resolve()),
     /**
      * Track a page view event
      * Takes enriched data from properties and creates final structured event
      */
-    page: (n) => {
-      const { config: e, payload: o } = n, { context: i, page: s, device: d, utm: r, local_time: g } = o;
-      if (!t)
+    page: (a) => {
+      const { config: t, payload: e } = a, { context: n, page: o, device: i, utm: s, local_time: l } = e;
+      if (!r)
         throw new Error("DotAnalytics: Plugin not initialized");
-      const a = {
-        context: i,
+      if (!n || !o || !i || !l)
+        throw new Error("DotAnalytics: Missing required payload data for pageview event");
+      const d = {
+        context: n,
         events: [
           {
-            event_type: "pageview",
-            local_time: g,
-            page: s,
-            device: d,
-            ...r && { utm: r }
+            event_type: y.PAGEVIEW,
+            local_time: l,
+            data: {
+              page: o,
+              device: i,
+              ...s && { utm: s }
+            }
           }
         ]
       };
-      return e.debug && console.warn("Event to send:", a), c(a, e);
+      return t.debug && console.warn("DotAnalytics: Pageview event to send:", d), c(d, t);
     },
+    // TODO: Fix this when we haver the final design for the track event
     /**
      * Track a custom event
      * Takes enriched data and sends it to the analytics server
      */
-    track: (n) => {
-      const { config: e, payload: o } = n;
-      if (!t)
+    track: (a) => {
+      const { config: t, payload: e } = a;
+      if (!r)
         throw new Error("DotAnalytics: Plugin not initialized");
-      const i = {
-        context: o.context
+      if ("events" in e && Array.isArray(e.events)) {
+        const o = e, i = {
+          context: o.context,
+          events: o.events
+        };
+        return t.debug && console.warn("DotAnalytics: Track event to send:", i), c(i, t);
+      }
+      if (!e.context || !e.local_time)
+        throw new Error("DotAnalytics: Missing required payload data for track event");
+      const n = {
+        context: e.context,
+        events: [
+          {
+            event_type: y.TRACK,
+            local_time: e.local_time,
+            data: {
+              event: e.event,
+              ...e.properties
+            }
+          }
+        ]
       };
-      return c(i, e);
+      return t.debug && console.warn("DotAnalytics: Track event to send (fallback):", n), c(n, t);
     },
     /**
      * Check if the plugin is loaded
      */
-    loaded: () => t
+    loaded: () => r
   };
 };
 export {
-  f as dotAnalytics
+  p as dotAnalytics
 };

package/lib/dotAnalytics/plugin/enricher/dot-analytics.enricher.plugin.d.ts

@@ -19,13 +19,12 @@ export declare const dotAnalyticsEnricherPlugin: () => {
     }) => {
         local_time: string;
         utm?: import('../../shared/dot-content-analytics.model').DotCMSUtmData | undefined;
-        page: import('analytics').PageData;
+        page: import('../../shared/dot-content-analytics.model').DotCMSPageData;
         device: import('../../shared/dot-content-analytics.model').DotCMSDeviceData;
-        type: string;
-        properties: Record<string, unknown>;
         event: string;
+        properties: Record<string, unknown>;
         options: Record<string, unknown>;
-        context: import('../../shared/dot-content-analytics.model').DotCMSAnalyticsContext;
+        context?: import('../../shared/dot-content-analytics.model').DotCMSAnalyticsContext | undefined;
     };
     /**
      * TRACK EVENT ENRICHMENT - Runs after identity context injection
@@ -35,11 +34,11 @@ export declare const dotAnalyticsEnricherPlugin: () => {
         payload: DotCMSAnalyticsPayload;
     }) => {
         events: {
-            event_type: string;
-            custom_event: string;
+            event_type: "track";
             local_time: string;
-            properties: {
+            data: {
                 src: string;
+                event: string;
             };
         }[];
     };

package/lib/dotAnalytics/plugin/enricher/dot-analytics.enricher.plugin.js

@@ -1,27 +1,28 @@
-import { ANALYTICS_SOURCE_TYPE as r } from "../../shared/dot-content-analytics.constants.js";
-import { getLocalTime as n, enrichPagePayloadOptimized as o } from "../../shared/dot-content-analytics.utils.js";
-const s = () => ({
+import { ANALYTICS_SOURCE_TYPE as n, EVENT_TYPES as r } from "../../shared/dot-content-analytics.constants.js";
+import { getLocalTime as a, enrichPagePayloadOptimized as i } from "../../shared/dot-content-analytics.utils.js";
+const l = () => ({
   name: "enrich-dot-analytics",
   /**
    * PAGE VIEW ENRICHMENT - Runs after identity context injection
    * Uses optimized enrichment that leverages analytics.js payload data
    */
-  "page:dot-analytics": ({ payload: e }) => o(e),
+  "page:dot-analytics": ({ payload: e }) => i(e),
+  // TODO: Fix this when we haver the final design for the track event
   /**
    * TRACK EVENT ENRICHMENT - Runs after identity context injection
    * Creates structured track events with pre-injected context
    */
   "track:dot-analytics": ({ payload: e }) => {
-    const t = n();
+    const t = a();
     return {
       events: [
         {
-          event_type: "track",
-          custom_event: e.event,
+          event_type: r.TRACK,
           local_time: t,
-          properties: {
+          data: {
+            event: e.event,
             ...e.properties,
-            src: r
+            src: n
           }
         }
       ]
@@ -29,5 +30,5 @@ const s = () => ({
   }
 });
 export {
-  s as dotAnalyticsEnricherPlugin
+  l as dotAnalyticsEnricherPlugin
 };

package/lib/dotAnalytics/shared/dot-content-analytics.constants.d.ts

@@ -1,7 +1,18 @@
 export declare const ANALYTICS_WINDOWS_KEY = "dotAnalytics";
 export declare const ANALYTICS_SOURCE_TYPE = "dotAnalytics";
 export declare const ANALYTICS_ENDPOINT = "/api/v1/analytics/content/event";
-export declare const EXPECTED_UTM_KEYS: string[];
+/**
+ * Event Types
+ * Only two event types are supported in DotCMS Analytics
+ */
+export declare const EVENT_TYPES: {
+    readonly PAGEVIEW: "pageview";
+    readonly TRACK: "track";
+};
+/**
+ * Expected UTM parameter keys for campaign tracking
+ */
+export declare const EXPECTED_UTM_KEYS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content", "utm_id"];
 /**
  * Session configuration constants
  */
@@ -19,4 +30,4 @@ export declare const USER_ID_KEY = "dot_analytics_user_id";
  * - click: Detects real user interaction with minimal performance impact
  * - visibilitychange: Handled separately to detect tab changes
  */
-export declare const ACTIVITY_EVENTS: string[];
+export declare const ACTIVITY_EVENTS: readonly ["click"];

package/lib/dotAnalytics/shared/dot-content-analytics.constants.js

@@ -1,10 +1,14 @@
-const _ = "dotAnalytics", t = _, n = "/api/v1/analytics/content/event", s = 30, E = "dot_analytics_session_id", S = "dot_analytics_user_id", c = ["click"];
+const t = "dotAnalytics", E = t, _ = "/api/v1/analytics/content/event", c = {
+  PAGEVIEW: "pageview",
+  TRACK: "track"
+}, n = 30, s = "dot_analytics_session_id", S = "dot_analytics_user_id", T = ["click"];
 export {
-  c as ACTIVITY_EVENTS,
-  n as ANALYTICS_ENDPOINT,
-  t as ANALYTICS_SOURCE_TYPE,
-  _ as ANALYTICS_WINDOWS_KEY,
-  s as DEFAULT_SESSION_TIMEOUT_MINUTES,
-  E as SESSION_STORAGE_KEY,
+  T as ACTIVITY_EVENTS,
+  _ as ANALYTICS_ENDPOINT,
+  E as ANALYTICS_SOURCE_TYPE,
+  t as ANALYTICS_WINDOWS_KEY,
+  n as DEFAULT_SESSION_TIMEOUT_MINUTES,
+  c as EVENT_TYPES,
+  s as SESSION_STORAGE_KEY,
   S as USER_ID_KEY
 };

package/lib/dotAnalytics/shared/dot-content-analytics.http.d.ts

@@ -1,9 +1,9 @@
-import { DotCMSAnalyticsConfig, DotCMSPageViewRequestBody, DotCMSTrackRequestBody } from './dot-content-analytics.model';
+import { DotCMSAnalyticsConfig, DotCMSAnalyticsRequestBody } from './dot-content-analytics.model';
 
 /**
  * Send an analytics event to the server
- * @param data - The event data
- * @param options - The options for the event
- * @returns A promise that resolves to the response from the server
+ * @param payload - The event payload data
+ * @param config - The analytics configuration
+ * @returns A promise that resolves when the request is complete
  */
-export declare const sendAnalyticsEventToServer: (payload: DotCMSPageViewRequestBody | DotCMSTrackRequestBody, options: DotCMSAnalyticsConfig) => Promise<void>;
+export declare const sendAnalyticsEventToServer: (payload: DotCMSAnalyticsRequestBody, config: DotCMSAnalyticsConfig) => Promise<void>;

package/lib/dotAnalytics/shared/dot-content-analytics.http.js

@@ -1,16 +1,29 @@
-import { ANALYTICS_ENDPOINT as o } from "./dot-content-analytics.constants.js";
-const n = async (r, t) => {
+import { ANALYTICS_ENDPOINT as a } from "./dot-content-analytics.constants.js";
+const i = async (o, t) => {
   try {
-    const e = await fetch(`${t.server}${o}`, {
+    const e = await fetch(`${t.server}${a}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(r)
+      body: JSON.stringify(o)
     });
-    e.ok || console.error(`DotAnalytics: Server responded with status ${e.status}`);
+    if (!e.ok) {
+      const n = e.statusText || "Unknown Error", s = `HTTP ${e.status}: ${n}`;
+      try {
+        const r = await e.json();
+        r.message ? console.warn(`DotAnalytics: ${r.message} (${s})`) : console.warn(
+          `DotAnalytics: ${s} - No error message in response`
+        );
+      } catch (r) {
+        console.warn(
+          `DotAnalytics: ${s} - Failed to parse error response:`,
+          r
+        );
+      }
+    }
   } catch (e) {
     console.error("DotAnalytics: Error sending event:", e);
   }
 };
 export {
-  n as sendAnalyticsEventToServer
+  i as sendAnalyticsEventToServer
 };

package/lib/dotAnalytics/shared/dot-content-analytics.model.d.ts

@@ -1,3 +1,5 @@
+import { EVENT_TYPES } from './dot-content-analytics.constants';
+
 declare global {
     interface Window {
         __dotAnalyticsCleanup?: () => void;
@@ -32,21 +34,49 @@ export interface DotCMSAnalyticsConfig {
     redirectFn?: (url: string) => void;
 }
 /**
- * Individual analytics event structure for DotCMS.
- * Represents a single event within an analytics request sent to the DotCMS analytics server.
+ * Supported event types in DotCMS Analytics.
+ * Only two event types are supported: pageview and track.
  */
-export interface DotCMSAnalyticsEvent {
+export type DotCMSEventType = (typeof EVENT_TYPES)[keyof typeof EVENT_TYPES];
+/**
+ * Base structure for all analytics events.
+ * All events share this common structure.
+ */
+export interface DotCMSEventBase {
     /** The type of event being tracked */
-    event_type: 'pageview' | 'track';
-    /** Page data associated with the event */
-    page: DotCMSPageData;
-    /** Device and browser information */
-    device: DotCMSDeviceData;
-    /** UTM parameters for campaign tracking */
-    utm?: DotCMSUtmData;
+    event_type: DotCMSEventType;
     /** Local timestamp when the event occurred */
     local_time: string;
 }
+/**
+ * Pageview-specific analytics event structure.
+ * Contains data specific to page view tracking.
+ */
+export interface DotCMSPageViewEvent extends DotCMSEventBase {
+    event_type: 'pageview';
+    /** Pageview-specific event data with structured format */
+    data: {
+        /** Page data associated with the event */
+        page: DotCMSPageData;
+        /** Device and browser information */
+        device: DotCMSDeviceData;
+        /** UTM parameters for campaign tracking (optional) */
+        utm?: DotCMSUtmData;
+    };
+}
+/**
+ * Track-specific analytics event structure.
+ * Contains data specific to custom event tracking.
+ */
+export interface DotCMSTrackEvent extends DotCMSEventBase {
+    event_type: 'track';
+    /** Track-specific event data with flexible structure */
+    data: Record<string, unknown>;
+}
+/**
+ * Union type for all possible analytics events.
+ */
+export type DotCMSEvent = DotCMSPageViewEvent | DotCMSTrackEvent;
 /**
  * Analytics request body for page view events in DotCMS.
  * Structure sent to the DotCMS analytics server for page tracking.
@@ -54,8 +84,8 @@ export interface DotCMSAnalyticsEvent {
 export interface DotCMSPageViewRequestBody {
     /** Context information shared across all events */
     context: DotCMSAnalyticsContext;
-    /** Array of analytics events to be tracked */
-    events: DotCMSAnalyticsEvent[];
+    /** Array of pageview analytics events to be tracked */
+    events: DotCMSPageViewEvent[];
 }
 /**
  * Analytics request body for track events in DotCMS.
@@ -64,8 +94,22 @@ export interface DotCMSPageViewRequestBody {
 export interface DotCMSTrackRequestBody {
     /** Context information shared across all events */
     context: DotCMSAnalyticsContext;
-    /** Array of analytics events to be tracked */
-    events?: DotCMSAnalyticsEvent[];
+    /** Array of track analytics events to be tracked */
+    events: DotCMSTrackEvent[];
+}
+/**
+ * Union type for all possible request bodies.
+ */
+export type DotCMSAnalyticsRequestBody = DotCMSPageViewRequestBody | DotCMSTrackRequestBody;
+/**
+ * Enriched payload structure returned by the enricher plugin.
+ * Contains pre-structured events and context for direct use in analytics requests.
+ */
+export interface DotCMSEnrichedPayload {
+    /** Analytics context shared across events */
+    context: DotCMSAnalyticsContext;
+    /** Array of pre-structured analytics events */
+    events: DotCMSEvent[];
 }
 /**
  * Browser event data collected from the user's session in DotCMS.
@@ -108,22 +152,22 @@ export interface DotCMSBrowserEventData {
  * The payload structure for DotCMS analytics events.
  * This interface represents the complete data structure that flows through
  * the analytics pipeline, including original event data and enriched context.
+ *
+ * This is the internal payload used by Analytics.js and our plugins.
  */
 export interface DotCMSAnalyticsPayload {
-    /** The type of analytics event */
-    type: string;
-    /** Additional properties associated with the event */
-    properties: Record<string, unknown>;
     /** The event name or identifier */
     event: string;
+    /** Additional properties associated with the event */
+    properties: Record<string, unknown>;
     /** Configuration options for the event */
     options: Record<string, unknown>;
     /** Analytics context shared across events */
-    context: DotCMSAnalyticsContext;
+    context?: DotCMSAnalyticsContext;
     /** Page data for the current page */
-    page: DotCMSPageData;
+    page?: DotCMSPageData;
     /** Device and browser information */
-    device: DotCMSDeviceData;
+    device?: DotCMSDeviceData;
     /** UTM parameters for campaign tracking */
     utm?: DotCMSUtmData;
     /** Local timestamp when the event occurred */
@@ -146,9 +190,8 @@ export interface DotCMSAnalyticsParams {
 export interface DotCMSAnalytics {
     /**
      * Track a page view event.
-     * @param payload - Optional additional data to include with the page view
      */
-    pageView: (payload?: Record<string, unknown>) => void;
+    pageView: () => void;
     /**
      * Track a custom event.
      * @param eventName - The name/type of the event to track
@@ -217,14 +260,12 @@ export interface DotCMSPageData {
     doc_protocol: string | undefined;
     /** Document search parameters */
     doc_search: string;
-    /** DotCMS host domain */
-    dot_host: string | undefined;
-    /** DotCMS page path */
-    dot_path: string | undefined;
+    /** Document host domain */
+    doc_host: string | undefined;
+    /** Document path */
+    doc_path: string | undefined;
     /** Page title */
     title: string | undefined;
-    /** User agent string */
-    user_agent?: string;
     /** Language identifier */
     language_id?: string;
     /** Persona identifier */

package/lib/dotAnalytics/shared/dot-content-analytics.utils.d.ts

@@ -1,4 +1,4 @@
-import { DotCMSAnalyticsConfig, DotCMSAnalyticsContext, DotCMSAnalyticsPayload, DotCMSBrowserEventData, DotCMSDeviceData, DotCMSUtmData } from './dot-content-analytics.model';
+import { DotCMSAnalyticsConfig, DotCMSAnalyticsContext, DotCMSAnalyticsPayload, DotCMSBrowserEventData, DotCMSDeviceData, DotCMSPageData, DotCMSUtmData } from './dot-content-analytics.model';
 import { PageData } from 'analytics';
 
 export { cleanupActivityTracking, getLastActivity, getSessionInfo, initializeActivityTracking, isUserInactive, updateSessionActivity } from './dot-content-analytics.activity-tracker';
@@ -52,11 +52,7 @@ export declare const extractUTMParameters: (location: Location) => Record<string
  */
 export declare const defaultRedirectFn: (href: string) => string;
 /**
- * Check if we're inside the DotCMS editor
- */
-export declare const isInsideEditor: () => boolean;
-/**
- * Gets local time in ISO format
+ * Gets local time in ISO format without milliseconds
  */
 export declare const getLocalTime: () => string;
 /**
@@ -83,13 +79,12 @@ export declare const enrichWithUtmData: (payload: DotCMSAnalyticsPayload) => Dot
 export declare const enrichPagePayloadOptimized: (payload: DotCMSAnalyticsPayload, location?: Location) => {
     local_time: string;
     utm?: DotCMSUtmData | undefined;
-    page: PageData;
+    page: DotCMSPageData;
     device: DotCMSDeviceData;
-    type: string;
-    properties: Record<string, unknown>;
     event: string;
+    properties: Record<string, unknown>;
     options: Record<string, unknown>;
-    context: DotCMSAnalyticsContext;
+    context?: DotCMSAnalyticsContext | undefined;
 };
 /**
  * @deprecated Use enrichPagePayloadOptimized instead to avoid data duplication
@@ -102,10 +97,9 @@ export declare const enrichPagePayload: (payload: DotCMSAnalyticsPayload, locati
         utm?: DotCMSUtmData | undefined;
         page: PageData;
         device: DotCMSDeviceData;
-        type: string;
-        properties: Record<string, unknown>;
         event: string;
+        properties: Record<string, unknown>;
         options: Record<string, unknown>;
-        context: DotCMSAnalyticsContext;
+        context?: DotCMSAnalyticsContext | undefined;
     };
 };

package/lib/dotAnalytics/shared/dot-content-analytics.utils.js

@@ -1,9 +1,9 @@
-import { SESSION_STORAGE_KEY as l, DEFAULT_SESSION_TIMEOUT_MINUTES as S, USER_ID_KEY as h } from "./dot-content-analytics.constants.js";
-let g = null;
+import { SESSION_STORAGE_KEY as h, DEFAULT_SESSION_TIMEOUT_MINUTES as S, USER_ID_KEY as m } from "./dot-content-analytics.constants.js";
+let d = null;
 const u = (t) => {
   const e = Date.now(), n = Math.random().toString(36).substr(2, 9), o = Math.random().toString(36).substr(2, 9);
   return `${t}_${e}_${n}${o}`;
-}, m = {
+}, l = {
   getItem: (t) => {
     try {
       return localStorage.getItem(t);
@@ -19,9 +19,9 @@ const u = (t) => {
     }
   }
 }, f = () => {
-  let t = m.getItem(h);
-  return t || (t = u("user"), m.setItem(h, t)), t;
-}, w = (t) => {
+  let t = l.getItem(m);
+  return t || (t = u("user"), l.setItem(m, t)), t;
+}, _ = (t) => {
   const e = new Date(t), n = /* @__PURE__ */ new Date(), o = new Date(
     e.getUTCFullYear(),
     e.getUTCMonth(),
@@ -33,15 +33,15 @@ const u = (t) => {
   if (typeof window > "u")
     return u("session_fallback");
   try {
-    const e = sessionStorage.getItem(l);
+    const e = sessionStorage.getItem(h);
     if (e) {
-      const { sessionId: s, startTime: i, lastActivity: c } = JSON.parse(e), d = !w(i), r = t - c < S * 60 * 1e3;
-      if (d && r)
+      const { sessionId: s, startTime: c, lastActivity: i } = JSON.parse(e), g = !_(c), a = t - i < S * 60 * 1e3;
+      if (g && a)
         return sessionStorage.setItem(
-          l,
+          h,
           JSON.stringify({
             sessionId: s,
-            startTime: i,
+            startTime: c,
             lastActivity: t
           })
         ), s;
@@ -51,7 +51,7 @@ const u = (t) => {
       startTime: t,
       lastActivity: t
     };
-    return sessionStorage.setItem(l, JSON.stringify(o)), n;
+    return sessionStorage.setItem(h, JSON.stringify(o)), n;
   } catch {
     return u("session_fallback");
   }
@@ -65,67 +65,59 @@ const u = (t) => {
     session_id: e,
     user_id: n
   };
-}, I = () => g || (g = {
+}, w = () => d || (d = {
   user_language: navigator.language || void 0,
   doc_encoding: document.characterSet || document.charset || void 0,
   screen_resolution: typeof screen < "u" && screen.width && screen.height ? `${screen.width}x${screen.height}` : void 0
-}, g), $ = () => {
-  if (typeof window > "u")
-    return !1;
-  try {
-    const t = window.self !== window.top, e = window.location.href.includes("mode=EDIT_MODE"), n = window.location.href.includes("/vtl/");
-    return t || e || n;
-  } catch {
-    return !1;
-  }
-}, D = () => {
+}, d), I = () => {
   try {
     const t = (/* @__PURE__ */ new Date()).getTimezoneOffset(), e = t > 0 ? "-" : "+", n = Math.abs(t), o = Math.floor(n / 60), s = n % 60;
     return `${e}${o.toString().padStart(2, "0")}:${s.toString().padStart(2, "0")}`;
   } catch {
     return "+00:00";
   }
-}, y = () => {
+}, D = () => {
   try {
-    const t = /* @__PURE__ */ new Date(), e = D(), n = t.getFullYear(), o = (t.getMonth() + 1).toString().padStart(2, "0"), s = t.getDate().toString().padStart(2, "0"), i = t.getHours().toString().padStart(2, "0"), c = t.getMinutes().toString().padStart(2, "0"), d = t.getSeconds().toString().padStart(2, "0"), r = t.getMilliseconds().toString().padStart(3, "0");
-    return `${n}-${o}-${s}T${i}:${c}:${d}.${r}${e}`;
+    const t = /* @__PURE__ */ new Date(), e = I(), n = t.getFullYear(), o = (t.getMonth() + 1).toString().padStart(2, "0"), s = t.getDate().toString().padStart(2, "0"), c = t.getHours().toString().padStart(2, "0"), i = t.getMinutes().toString().padStart(2, "0"), g = t.getSeconds().toString().padStart(2, "0");
+    return `${n}-${o}-${s}T${c}:${i}:${g}${e}`;
   } catch {
     return (/* @__PURE__ */ new Date()).toISOString();
   }
-}, v = (t, e = typeof window < "u" ? window.location : {}) => {
-  const n = y(), o = I(), { properties: s } = t, { utm: i } = s, c = {
+}, $ = (t, e = typeof window < "u" ? window.location : {}) => {
+  const n = D(), o = w(), { properties: s } = t, { utm: c } = s, i = {
     url: s.url ?? e.href,
-    path: s.path ?? e.pathname,
-    hash: s.hash ?? e.hash ?? "",
-    search: s.search ?? e.search ?? "",
+    doc_encoding: o.doc_encoding,
+    doc_hash: s.hash ?? e.hash ?? "",
+    doc_protocol: e.protocol,
+    doc_search: s.search ?? e.search ?? "",
+    doc_host: e.hostname,
+    doc_path: s.path ?? e.pathname,
     title: s.title ?? (document == null ? void 0 : document.title),
-    width: String(s.width),
-    height: String(s.height),
-    referrer: s.referrer ?? (document == null ? void 0 : document.referrer)
-  }, d = {
+    language_id: void 0,
+    persona: void 0
+  }, g = {
     screen_resolution: o.screen_resolution,
     language: o.user_language,
     viewport_width: String(s.width),
     viewport_height: String(s.height)
-  }, r = {};
-  if (i && typeof i == "object") {
-    const a = i;
-    a.medium && (r.medium = a.medium), a.source && (r.source = a.source), a.campaign && (r.campaign = a.campaign), a.term && (r.term = a.term), a.content && (r.content = a.content);
+  }, a = {};
+  if (c && typeof c == "object") {
+    const r = c;
+    r.medium && (a.medium = r.medium), r.source && (a.source = r.source), r.campaign && (a.campaign = r.campaign), r.term && (a.term = r.term), r.content && (a.content = r.content);
   }
   return {
     ...t,
-    page: c,
-    device: d,
-    ...Object.keys(r).length > 0 && { utm: r },
+    page: i,
+    device: g,
+    ...Object.keys(a).length > 0 && { utm: a },
     local_time: n
   };
 };
 export {
-  v as enrichPagePayloadOptimized,
+  $ as enrichPagePayloadOptimized,
   u as generateSecureId,
   T as getAnalyticsContext,
-  y as getLocalTime,
+  D as getLocalTime,
   p as getSessionId,
-  f as getUserId,
-  $ as isInsideEditor
+  f as getUserId
 };

package/lib/react/hook/useContentAnalytics.js

@@ -1,34 +1,32 @@
-import { useContext as c, useRef as u, useCallback as o } from "react";
-import { isInsideEditor as s } from "../../dotAnalytics/shared/dot-content-analytics.utils.js";
+import { useContext as c, useRef as u, useCallback as a } from "react";
+import { getUVEState as i } from "../../../uve/src/lib/core/core.utils.js";
+import "../../../uve/src/internal/constants.js";
 import l from "../contexts/DotContentAnalyticsContext.js";
-const w = () => {
-  const t = c(l), i = u(null);
+const S = () => {
+  const t = c(l), n = u(null);
   if (!t)
     throw new Error(
       "useContentAnalytics must be used within a DotContentAnalyticsProvider and analytics must be successfully initialized"
     );
-  const r = o(
-    (e, n = {}) => {
-      s() || t.track(e, {
-        ...n,
+  const s = a(
+    (o, e = {}) => {
+      i() || t.track(o, {
+        ...e,
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       });
     },
     [t]
-  ), a = o(
-    (e = {}) => {
-      if (!s()) {
-        const n = window.location.pathname;
-        n !== i.current && (i.current = n, t.pageView(e));
-      }
-    },
-    [t]
-  );
+  ), r = a(() => {
+    if (!i()) {
+      const e = window.location.pathname;
+      e !== n.current && (n.current = e, t.pageView());
+    }
+  }, [t]);
   return {
-    track: r,
-    pageView: a
+    track: s,
+    pageView: r
   };
 };
 export {
-  w as useContentAnalytics
+  S as useContentAnalytics
 };

package/lib/react/hook/useRouterTracker.js

@@ -1,13 +1,14 @@
-import { useRef as r, useEffect as i } from "react";
-import { isInsideEditor as u } from "../../dotAnalytics/shared/dot-content-analytics.utils.js";
-function s(t) {
-  const n = r(null);
+import { useRef as u, useEffect as i } from "react";
+import { getUVEState as a } from "../../../uve/src/lib/core/core.utils.js";
+import "../../../uve/src/internal/constants.js";
+function p(t) {
+  const n = u(null);
   i(() => {
     if (!t)
       return;
     function e() {
-      const o = window.location.pathname;
-      o !== n.current && !u() && t && (n.current = o, t.pageView());
+      const o = window.location.pathname, r = a();
+      o !== n.current && !r && t && (n.current = o, t.pageView());
     }
     return e(), window.addEventListener("popstate", e), window.addEventListener("beforeunload", e), () => {
       window.removeEventListener("popstate", e), window.removeEventListener("beforeunload", e);
@@ -15,5 +16,5 @@ function s(t) {
   }, [t]);
 }
 export {
-  s as useRouterTracker
+  p as useRouterTracker
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/analytics",
-  "version": "0.0.1-beta.43",
+  "version": "0.0.1-beta.44",
   "description": "Official JavaScript library for Content Analytics with DotCMS.",
   "repository": {
     "type": "git",
@@ -23,7 +23,8 @@
     "analytics": "^0.8.14"
   },
   "peerDependencies": {
-    "react": "19.1.0"
+    "react": "19.1.0",
+    "@dotcms/uve": "0.0.1-beta.44"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.1.6",

package/types/src/lib/editor/public.js

@@ -0,0 +1,5 @@
+var N = /* @__PURE__ */ ((r) => (r.EDIT = "EDIT_MODE", r.PREVIEW = "PREVIEW_MODE", r.LIVE = "LIVE", r.UNKNOWN = "UNKNOWN", r))(N || {}), E = /* @__PURE__ */ ((r) => (r.CONTENT_CHANGES = "changes", r.PAGE_RELOAD = "page-reload", r.REQUEST_BOUNDS = "request-bounds", r.IFRAME_SCROLL = "iframe-scroll", r.CONTENTLET_HOVERED = "contentlet-hovered", r))(E || {});
+export {
+  E as UVEEventType,
+  N as UVE_MODE
+};

package/types/src/lib/events/internal.js

@@ -0,0 +1,4 @@
+var t = /* @__PURE__ */ ((e) => (e.UVE_RELOAD_PAGE = "uve-reload-page", e.UVE_REQUEST_BOUNDS = "uve-request-bounds", e.UVE_EDITOR_PONG = "uve-editor-pong", e.UVE_SCROLL_INSIDE_IFRAME = "uve-scroll-inside-iframe", e.UVE_SET_PAGE_DATA = "uve-set-page-data", e.UVE_COPY_CONTENTLET_INLINE_EDITING_SUCCESS = "uve-copy-contentlet-inline-editing-success", e))(t || {});
+export {
+  t as __DOTCMS_UVE_EVENT__
+};

package/uve/src/internal/constants.js

@@ -0,0 +1,3 @@
+import { UVEEventType as n } from "../../../types/src/lib/editor/public.js";
+import { onContentletHovered as r, onIframeScroll as o, onRequestBounds as t, onPageReload as E, onContentChanges as u } from "./events.js";
+n.CONTENT_CHANGES + "", n.PAGE_RELOAD + "", n.REQUEST_BOUNDS + "", n.IFRAME_SCROLL + "", n.CONTENTLET_HOVERED + "";

package/uve/src/internal/events.js

@@ -0,0 +1,108 @@
+import { UVEEventType as a } from "../../../types/src/lib/editor/public.js";
+import { __DOTCMS_UVE_EVENT__ as s } from "../../../types/src/lib/events/internal.js";
+import { findDotCMSElement as M, findDotCMSVTLData as p, getClosestDotCMSContainerData as w, getDotCMSPageBounds as S } from "../lib/dom/dom.utils.js";
+function U(o) {
+  const t = (n) => {
+    n.data.name === s.UVE_SET_PAGE_DATA && o(n.data.payload);
+  };
+  return window.addEventListener("message", t), {
+    unsubscribe: () => {
+      window.removeEventListener("message", t);
+    },
+    event: a.CONTENT_CHANGES
+  };
+}
+function V(o) {
+  const t = (n) => {
+    n.data.name === s.UVE_RELOAD_PAGE && o();
+  };
+  return window.addEventListener("message", t), {
+    unsubscribe: () => {
+      window.removeEventListener("message", t);
+    },
+    event: a.PAGE_RELOAD
+  };
+}
+function I(o) {
+  const t = (n) => {
+    if (n.data.name === s.UVE_REQUEST_BOUNDS) {
+      const e = Array.from(
+        document.querySelectorAll('[data-dot-object="container"]')
+      ), i = S(e);
+      o(i);
+    }
+  };
+  return window.addEventListener("message", t), {
+    unsubscribe: () => {
+      window.removeEventListener("message", t);
+    },
+    event: a.REQUEST_BOUNDS
+  };
+}
+function Y(o) {
+  const t = (n) => {
+    if (n.data.name === s.UVE_SCROLL_INSIDE_IFRAME) {
+      const e = n.data.direction;
+      o(e);
+    }
+  };
+  return window.addEventListener("message", t), {
+    unsubscribe: () => {
+      window.removeEventListener("message", t);
+    },
+    event: a.IFRAME_SCROLL
+  };
+}
+function B(o) {
+  const t = (n) => {
+    var d, r, E, c, T, l, m, _, u, C;
+    const e = M(n.target);
+    if (!e)
+      return;
+    const { x: i, y: g, width: v, height: N } = e.getBoundingClientRect(), f = ((d = e.dataset) == null ? void 0 : d.dotObject) === "container", L = {
+      identifier: "TEMP_EMPTY_CONTENTLET",
+      title: "TEMP_EMPTY_CONTENTLET",
+      contentType: "TEMP_EMPTY_CONTENTLET_TYPE",
+      inode: "TEMPY_EMPTY_CONTENTLET_INODE",
+      widgetTitle: "TEMP_EMPTY_CONTENTLET",
+      baseType: "TEMP_EMPTY_CONTENTLET",
+      onNumberOfPages: 1
+    }, P = {
+      identifier: (r = e.dataset) == null ? void 0 : r.dotIdentifier,
+      title: (E = e.dataset) == null ? void 0 : E.dotTitle,
+      inode: (c = e.dataset) == null ? void 0 : c.dotInode,
+      contentType: (T = e.dataset) == null ? void 0 : T.dotType,
+      baseType: (l = e.dataset) == null ? void 0 : l.dotBasetype,
+      widgetTitle: (m = e.dataset) == null ? void 0 : m.dotWidgetTitle,
+      onNumberOfPages: (_ = e.dataset) == null ? void 0 : _.dotOnNumberOfPages
+    }, O = p(e), b = {
+      container: (
+        // Here extract dot-container from contentlet if it is Headless
+        // or search in parent container if it is VTL
+        (u = e.dataset) != null && u.dotContainer ? JSON.parse((C = e.dataset) == null ? void 0 : C.dotContainer) : w(e)
+      ),
+      contentlet: f ? L : P,
+      vtlFiles: O
+    };
+    o({
+      x: i,
+      y: g,
+      width: v,
+      height: N,
+      payload: b
+    });
+  };
+  return document.addEventListener("pointermove", t), {
+    unsubscribe: () => {
+      document.removeEventListener("pointermove", t);
+    },
+    event: a.CONTENTLET_HOVERED
+  };
+}
+export {
+  U as onContentChanges,
+  B as onContentletHovered,
+  Y as onIframeScroll,
+  V as onPageReload,
+  I as onRequestBounds
+};

package/uve/src/lib/core/core.utils.js

@@ -0,0 +1,21 @@
+import { UVE_MODE as t } from "../../../../types/src/lib/editor/public.js";
+import "../../internal/constants.js";
+function p() {
+  if (typeof window > "u" || window.parent === window || !window.location)
+    return;
+  const e = new URL(window.location.href), o = Object.values(t);
+  let a = e.searchParams.get("mode") ?? t.EDIT;
+  const s = e.searchParams.get("language_id"), n = e.searchParams.get("personaId"), r = e.searchParams.get("variantName"), i = e.searchParams.get("experimentId"), c = e.searchParams.get("publishDate"), d = e.searchParams.get("dotCMSHost");
+  return o.includes(a) || (a = t.EDIT), {
+    mode: a,
+    languageId: s,
+    persona: n,
+    variantName: r,
+    experimentId: i,
+    publishDate: c,
+    dotCMSHost: d
+  };
+}
+export {
+  p as getUVEState
+};

package/uve/src/lib/dom/dom.utils.js

@@ -0,0 +1,81 @@
+import "../../internal/constants.js";
+function C(t) {
+  return t.map((a) => {
+    const o = a.getBoundingClientRect(), n = Array.from(
+      a.querySelectorAll('[data-dot-object="contentlet"]')
+    );
+    return {
+      x: o.x,
+      y: o.y,
+      width: o.width,
+      height: o.height,
+      payload: JSON.stringify({
+        container: u(a)
+      }),
+      contentlets: f(o, n)
+    };
+  });
+}
+function f(t, a) {
+  return a.map((o) => {
+    var d, r, i, e, s, c;
+    const n = o.getBoundingClientRect();
+    return {
+      x: 0,
+      y: n.y - t.y,
+      width: n.width,
+      height: n.height,
+      payload: JSON.stringify({
+        container: (d = o.dataset) != null && d.dotContainer ? JSON.parse((r = o.dataset) == null ? void 0 : r.dotContainer) : y(o),
+        contentlet: {
+          identifier: (i = o.dataset) == null ? void 0 : i.dotIdentifier,
+          title: (e = o.dataset) == null ? void 0 : e.dotTitle,
+          inode: (s = o.dataset) == null ? void 0 : s.dotInode,
+          contentType: (c = o.dataset) == null ? void 0 : c.dotType
+        }
+      })
+    };
+  });
+}
+function u(t) {
+  var a, o, n, d;
+  return {
+    acceptTypes: ((a = t.dataset) == null ? void 0 : a.dotAcceptTypes) || "",
+    identifier: ((o = t.dataset) == null ? void 0 : o.dotIdentifier) || "",
+    maxContentlets: ((n = t.dataset) == null ? void 0 : n.maxContentlets) || "",
+    uuid: ((d = t.dataset) == null ? void 0 : d.dotUuid) || ""
+  };
+}
+function y(t) {
+  const a = t.closest('[data-dot-object="container"]');
+  return a ? u(a) : (console.warn("No container found for the contentlet"), null);
+}
+function g(t) {
+  var o, n, d;
+  if (!t)
+    return null;
+  const a = t.querySelector('[data-dot-object="empty-content"]');
+  return ((o = t == null ? void 0 : t.dataset) == null ? void 0 : o.dotObject) === "contentlet" || // The container inside Headless components have a span with the data-dot-object="container" attribute
+  ((n = t == null ? void 0 : t.dataset) == null ? void 0 : n.dotObject) === "container" && a || // The container inside Traditional have no content inside
+  ((d = t == null ? void 0 : t.dataset) == null ? void 0 : d.dotObject) === "container" && t.children.length === 0 ? t : g(t == null ? void 0 : t.parentElement);
+}
+function h(t) {
+  const a = t.querySelectorAll(
+    '[data-dot-object="vtl-file"]'
+  );
+  return a.length ? Array.from(a).map((o) => {
+    var n, d;
+    return {
+      inode: (n = o.dataset) == null ? void 0 : n.dotInode,
+      name: (d = o.dataset) == null ? void 0 : d.dotUrl
+    };
+  }) : null;
+}
+export {
+  g as findDotCMSElement,
+  h as findDotCMSVTLData,
+  y as getClosestDotCMSContainerData,
+  u as getDotCMSContainerData,
+  f as getDotCMSContentletsBound,
+  C as getDotCMSPageBounds
+};