@dotcms/client 1.5.6 → 1.6.0-next.36

package/README.md

@@ -84,7 +84,7 @@ The `@dotcms/client` is a powerful JavaScript/TypeScript SDK designed to simplif
 **For Local Development:**
 
 -   🐳 [Docker setup guide](https://github.com/dotCMS/core/tree/main/docker/docker-compose-examples/single-node-demo-site)
--   💻 [Local installation guide](https://dev.dotcms.com/docs/quick-start-guide)
+-   💻 [Local installation guide](https://dev.dotcms.com/getting-started/setup/run-locally)
 
 #### Create a dotCMS API Key
 
@@ -100,7 +100,7 @@ This integration requires an API Key with read-only permissions for security bes
 
 For detailed instructions, please refer to the [dotCMS API Documentation - Read-only token](https://dev.dotcms.com/docs/rest-api-authentication#ReadOnlyToken).
 
-#### Installation
+### Installation
 
 Install the SDK and required dependencies:
 
@@ -121,7 +121,7 @@ import { createDotCMSClient } from '@dotcms/client';
 // Create a client instance
 const client = createDotCMSClient({
     dotcmsUrl: 'https://your-dotcms-instance.com',
-    authToken: 'your-auth-token', // Optional for public content
+    authToken: 'your-auth-token',
     siteId: 'your-site-id' // Optional site identifier
 });
 
@@ -361,7 +361,7 @@ const response = await client.ai.search(
 );
 
 // Access results with match scores
-resp[onse].results.forEach(result => {
+response.results.forEach(result => {
     console.log(result.title);
     console.log('Matches:', result.matches); // Distance and extracted text
 });
@@ -457,11 +457,8 @@ response.contentlets.forEach(post => {
 #### Typing AI Search Results
 
 ```typescript
-import type {
-    DotCMSAISearchResponse,
-    DotCMSBasicContentlet,
-    DISTANCE_FUNCTIONS
-} from '@dotcms/types';
+import { DISTANCE_FUNCTIONS } from '@dotcms/types';
+import type { DotCMSAISearchResponse, DotCMSBasicContentlet } from '@dotcms/types';
 
 // Define your content type
 interface Article extends DotCMSBasicContentlet {
@@ -688,6 +685,69 @@ const response = await client.page.get('/about-us', {
 });
 ```
 
+### How to Enable Page Editing
+
+The `@dotcms/client` SDK is responsible for **fetching** your page, while a framework SDK ([`@dotcms/react`](https://www.npmjs.com/package/@dotcms/react) or [`@dotcms/angular`](https://www.npmjs.com/package/@dotcms/angular)) makes that page **editable** inside the [Universal Visual Editor (UVE)](https://dev.dotcms.com/docs/uve-headless-config).
+
+The flow is always the same three steps:
+
+1. **Fetch the page** on the server with `client.page.get()`.
+2. **Connect the page to the editor** with the framework hook/service (`useEditableDotCMSPage` in React, `DotCMSEditablePageService` in Angular).
+3. **Render the layout** with `DotCMSLayoutBody`, mapping your content types to components.
+
+#### 1. Fetch the page with `client.page.get()`
+
+Fetch the full page response on the server. The complete response object — not just `pageAsset` — must be forwarded to the editor layer, because it carries the data UVE needs to track changes.
+
+```typescript
+// server-side, e.g. a Next.js Server Component
+import { createDotCMSClient } from '@dotcms/client';
+
+const client = createDotCMSClient({
+    dotcmsUrl: 'https://your-dotcms-instance.com',
+    authToken: 'your-auth-token',
+    siteId: 'your-site-id'
+});
+
+// Return the whole response so the framework SDK can make it editable
+export async function getPage(path: string) {
+    return await client.page.get(path);
+}
+```
+
+#### 2. Make the page editable (React example)
+
+Pass the full page response into `useEditableDotCMSPage`. The hook keeps the page in sync with UVE while editing and returns the same `pageAsset` / `content` shape you get from `client.page.get()`, so the component works identically in and out of the editor.
+
+```tsx
+'use client';
+
+import { DotCMSLayoutBody, useEditableDotCMSPage } from '@dotcms/react';
+import { pageComponents } from '@/components/content-types';
+
+export function Page({ pageContent }) {
+    // `pageContent` is the full response from client.page.get()
+    const { pageAsset } = useEditableDotCMSPage(pageContent);
+
+    return (
+        <DotCMSLayoutBody
+            page={pageAsset}
+            components={pageComponents}
+            mode={process.env.NEXT_PUBLIC_DOTCMS_MODE}
+        />
+    );
+}
+```
+
+> 💡 Using Angular? Use [`DotCMSEditablePageService`](https://www.npmjs.com/package/@dotcms/angular) together with `DotCMSLayoutBody` — the same fetch → make-editable → render flow applies.
+
+#### 3. Render the layout with `DotCMSLayoutBody`
+
+`DotCMSLayoutBody` renders the page's rows, columns, and containers, and maps each contentlet to one of your components via the `components` prop. When loaded inside UVE it automatically applies the `data-dot-*` attributes that make the page editable — no extra wiring required.
+
+#### Working example
+
+See the page-editing flow end to end in the official Next.js example — [`examples/nextjs`](https://github.com/dotCMS/core/tree/main/examples/nextjs). In particular, [`src/views/Page.tsx`](https://github.com/dotCMS/core/blob/main/examples/nextjs/src/views/Page.tsx) uses `useEditableDotCMSPage` and `DotCMSLayoutBody` exactly as shown above.
 
 ## API Reference
 
@@ -816,14 +876,15 @@ getCollection<T = DotCMSBasicContentlet>(
 
 #### Builder Methods
 
-| Method       | Arguments                     | Description                              |
-| ------------ | ----------------------------- | ---------------------------------------- |
-| `query()`    | `string` \| `BuildQuery`      | Filter content using query builder       |
-| `limit()`    | `number`                      | Set number of items to return            |
-| `page()`     | `number`                      | Set which page of results to fetch       |
-| `sortBy()`   | `SortBy[]`                    | Sort by one or more fields               |
-| `language()` | `number \| string`            | Set content language                     |
-| `depth()`    | `number`                      | Set depth of related content             |
+| Method                | Arguments                     | Description                                                        |
+| --------------------- | ----------------------------- | ------------------------------------------------------------------ |
+| `query()`             | `string` \| `BuildQuery`      | Filter content using query builder                                 |
+| `limit()`             | `number`                      | Set number of items to return                                      |
+| `page()`              | `number`                      | Set which page of results to fetch                                 |
+| `sortBy()`            | `SortBy[]`                    | Sort by one or more fields                                         |
+| `language()`          | `number \| string`            | Set content language                                               |
+| `depth()`             | `number`                      | Set depth of related content                                       |
+| `includeSystemHost()` | -                             | Include content from the System Host alongside the configured site |
 
 #### Example
 ```typescript
@@ -1137,12 +1198,13 @@ DotHttpError: "Network request failed"
 
 ### Choosing the Right Method
 
-The dotCMS Client SDK provides four core methods for fetching data. Use this quick guide to decide which one is best for your use case:
+The dotCMS Client SDK provides five core methods for fetching data. Use this quick guide to decide which one is best for your use case:
 
 | Method                           | Use When You Need...                                          | Best For                                                                                                                                                                                         |
 | -------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `client.page.get()`              | A full page with layout, containers, and related content      | **Rendering entire pages** with a single request. Ideal for headless setups, SSR/SSG frameworks, and cases where you want everything—page structure, content, and navigation—tied to a URL path. |
-| `client.content.getCollection()` | A filtered list of content items from a specific content type | Populating dynamic blocks, lists, search results, widgets, or reusable components.                                                                                                               |
+| `client.content.getCollection()` | A filtered list of content items from a specific content type | Populating dynamic blocks, lists, search results, widgets, or reusable components using the fluent query builder.                                                                                |
+| `client.content.query()`         | Full control over a raw Lucene query string                   | Advanced search scenarios where you need direct Lucene syntax without the `getCollection()` query-builder DSL or automatic `contentType.` field prefixing.                                        |
 | `client.ai.search()`             | Semantic/AI-powered content discovery based on natural language | **Intelligent search experiences** where users describe what they're looking for in natural language. Great for search features, content recommendations, and finding relevant content by meaning rather than exact keywords. ⚠️ **Experimental API** |
 | `client.navigation.get()`        | Only the site's navigation structure (folders and links)      | Standalone menus or use cases where navigation is needed outside of page context.                                                                                                                |
 
@@ -1156,7 +1218,7 @@ For most use cases, `client.page.get()` is all you need. It lets you retrieve:
 
 All in a single request using GraphQL.
 
-Only use `content.getCollection()` or `navigation.get()` if you have advanced needs, like real-time data fetching or building custom dynamic components.
+Only use `content.getCollection()`, `content.query()`, or `navigation.get()` if you have advanced needs, like real-time data fetching or building custom dynamic components.
 
 > 🔍 **For comprehensive examples of advanced GraphQL querying including relationships and custom fields,** see the [How to Work with GraphQL](#how-to-work-with-graphql) section.
 
@@ -1165,7 +1227,7 @@ Only use `content.getCollection()` or `navigation.get()` if you have advanced ne
 The SDK follows a client-builder pattern with four main APIs:
 
 - **Page API** (`client.page.get()`) - Fetches complete page content with layout and containers
-- **Content API** (`client.content.getCollection()`) - Builder pattern for querying content collections
+- **Content API** (`client.content.getCollection()`, `client.content.query()`) - Builder pattern for querying content collections or raw Lucene queries
 - **AI API** (`client.ai.search()`) - AI-powered semantic search using embeddings and vector similarity ⚠️ **Experimental**
 - **Navigation API** (`client.navigation.get()`) - Fetches site navigation structure
 
@@ -1182,7 +1244,7 @@ We offer multiple channels to get help with the dotCMS Client SDK:
 -   **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-client` when posting questions.
--   **Enterprise Support**: Enterprise customers can access premium support through the [dotCMS Support Portal](https://helpdesk.dotcms.com/support/).
+-   **Enterprise Support**: Enterprise customers can access premium support through the [dotCMS Support Portal](https://www.dotcms.com/support).
 
 When reporting issues, please include:
 
@@ -1203,6 +1265,14 @@ GitHub pull requests are the preferred method to contribute code to dotCMS. We w
 
 Please ensure your code follows the existing style and includes appropriate tests.
 
+## Licensing
+
+dotCMS is available under either the [Business Source License 1.1 (BSL)](https://www.dotcms.com/bsl) or a commercial license.
+
+Under the BSL, dotCMS can be used at no cost by individual developers, small businesses or agencies under $5M in total finances, and by larger organizations in non-production environments. Every BSL release automatically converts to GPL v3 four years after its release date. For full terms and FAQs, visit [dotcms.com/bsl](https://www.dotcms.com/bsl) and [dotcms.com/bsl-faq](https://www.dotcms.com/bsl-faq).
+
+Production use in larger organizations, along with access to managed cloud, SLAs, support, and enterprise capabilities, is available under a commercial license from dotCMS. For details on commercial plans, features, and support options, see [dotcms.com/pricing](https://www.dotcms.com/pricing).
+
 ## Changelog
 
 ### v1.3.0
@@ -1362,11 +1432,3 @@ import { RequestOptions } from '@dotcms/types';
 // After
 import { DotRequestOptions } from '@dotcms/types';
 ```
-
-## Licensing
-
-dotCMS is available under either the [Business Source License 1.1 (BSL)](https://www.dotcms.com/bsl) or a commercial license.
-
-Under the BSL, dotCMS can be used at no cost by individual developers, small businesses or agencies under $5M in total finances, and by larger organizations in non-production environments. Every BSL release automatically converts to GPL v3 four years after its release date. For full terms and FAQs, visit [dotcms.com/bsl](https://www.dotcms.com/bsl) and [dotcms.com/bsl-faq](https://www.dotcms.com/bsl-faq).
-
-Production use in larger organizations, along with access to managed cloud, SLAs, support, and enterprise capabilities, is available under a commercial license from dotCMS. For details on commercial plans, features, and support options, see [dotcms.com/pricing](https://www.dotcms.com/pricing).

package/index.cjs.js

@@ -112,7 +112,7 @@ class FetchHttpClient extends types.BaseHttpClient {
     }
 }
 
-/******************************************************************************
+/*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
 
 Permission to use, copy, modify, and/or distribute this software for any
@@ -126,7 +126,7 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
-/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+/* global Reflect, Promise */
 
 
 function __classPrivateFieldGet(receiver, state, kind, f) {
@@ -140,12 +140,7 @@ function __classPrivateFieldSet(receiver, state, value, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-}
-
-typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-};
+}
 
 /**
  * Utility functions for AI search parameter mapping and processing
@@ -2310,6 +2305,19 @@ function mapContentResponse(responseData, keys) {
         return accumulator;
     }, {});
 }
+/**
+ * Returns a shallow copy of the object with every key whose value is `undefined` removed.
+ *
+ * `undefined` is not valid JSON, so keeping such keys breaks consumers that serialize the value
+ * (e.g. Next.js Pages Router `getServerSideProps`/`getStaticProps`). `null` and other falsy values
+ * are preserved since they serialize fine.
+ *
+ * @param {Record<string, unknown>} object - Source object to clean
+ * @returns {Record<string, unknown>} New object without `undefined` values
+ */
+function removeUndefinedValues(object) {
+    return Object.fromEntries(Object.entries(object).filter(([, value]) => value !== undefined));
+}
 /**
  * Executes a GraphQL query against the DotCMS API.
  *
@@ -2429,12 +2437,10 @@ class PageClient extends BaseApiClient {
             additionalQueries: contentQuery,
             verbose
         });
-        const normalizedUrl = url.startsWith('/') ? url : `/${url}`;
-        const requestVariables = {
-            // The url is expected to have a leading slash to comply on VanityURL Matching, some frameworks like Angular will not add the leading slash
-            url: normalizedUrl,
-            // Translate the UVE_MODE key ('EDIT' | 'PREVIEW' | ...) to the value the backend PageMode enum expects ('EDIT_MODE' | 'PREVIEW_MODE' | ...)
-            mode: types.UVE_MODE[mode],
+        const newURL = url.startsWith('/') ? url : `/${url}`;
+        const requestVariables = removeUndefinedValues({
+            url: newURL,
+            mode: types.UVE_MODE[mode], // Translate the UVE_MODE key ('EDIT' | 'PREVIEW' | ...) to the value the backend PageMode enum expects ('EDIT_MODE' | 'PREVIEW_MODE' | ...)
             languageId,
             personaId,
             fireRules,
@@ -2442,7 +2448,7 @@ class PageClient extends BaseApiClient {
             siteId,
             variantName,
             ...variables
-        };
+        });
         const requestHeaders = this.requestOptions.headers;
         const requestBody = JSON.stringify({ query: completeQuery, variables: requestVariables });
         try {
@@ -2458,12 +2464,12 @@ class PageClient extends BaseApiClient {
                     .filter((error) => !error.extensions?.code)
                     .forEach((error) => {
                     if (verbose) {
-                        logVerboseError(normalizedUrl, error.message, {
+                        logVerboseError(newURL, error.message, {
                             variables: requestVariables
                         });
                     }
                     else {
-                        consola.consola.error(`[DotCMS GraphQL Error] ${normalizedUrl}: `, error.message);
+                        consola.consola.error(`[DotCMS GraphQL Error] ${newURL}: `, error.message);
                     }
                 });
             }
@@ -2489,19 +2495,19 @@ class PageClient extends BaseApiClient {
                     const status = structuredError.extensions?.status ??
                         (code === 'NOT_FOUND' ? 404 : code === 'PERMISSION_DENIED' ? 403 : 400);
                     const message = code === 'NOT_FOUND'
-                        ? `Page '${normalizedUrl}' was not found`
+                        ? `Page '${newURL}' was not found`
                         : code === 'PERMISSION_DENIED'
-                            ? `Permission denied: you do not have access to page '${normalizedUrl}'. Verify the page permissions in dotCMS and that the auth token has sufficient access.`
-                            : `Page '${normalizedUrl}' could not be loaded (${code})`;
+                            ? `Permission denied: you do not have access to page '${newURL}'. Verify the page permissions in dotCMS and that the auth token has sufficient access.`
+                            : `Page '${newURL}' could not be loaded (${code})`;
                     if (verbose) {
-                        logVerboseError(normalizedUrl, message, {
+                        logVerboseError(newURL, message, {
                             status,
                             code,
                             variables: requestVariables
                         });
                     }
                     else {
-                        consola.consola.error(`[DotCMS GraphQL Error] ${normalizedUrl}: `, message);
+                        consola.consola.error(`[DotCMS GraphQL Error] ${newURL}: `, message);
                     }
                     throw new types.DotErrorPage(message, status, code, undefined, {
                         query: completeQuery,
@@ -2515,10 +2521,10 @@ class PageClient extends BaseApiClient {
                 : null;
             const styleEditorSchemas = pageResponse ? pageResponse.page.styleEditorSchemas : [];
             if (!pageResponse) {
-                throw new types.DotErrorPage(`Page '${normalizedUrl}' was not found`, 404, 'NOT_FOUND', new types.DotHttpError({
+                throw new types.DotErrorPage(`Page '${newURL}' was not found`, 404, 'NOT_FOUND', new types.DotHttpError({
                     status: 404,
                     statusText: 'Not Found',
-                    message: `Page '${normalizedUrl}' was not found`,
+                    message: `Page '${newURL}' was not found`,
                     data: response.errors
                 }), { query: completeQuery, variables: requestVariables });
             }
@@ -2531,7 +2537,9 @@ class PageClient extends BaseApiClient {
                     query: completeQuery,
                     variables: requestVariables
                 },
-                errors: response.errors?.length ? response.errors : undefined,
+                // Always return an array (never `undefined`) so the response stays JSON-serializable
+                // for consumers like Next.js Pages Router (getServerSideProps/getStaticProps throw on undefined).
+                errors: response.errors?.length ? response.errors : [],
                 ...(styleEditorSchemas?.length && { styleEditorSchemas })
             };
         }
@@ -2540,9 +2548,9 @@ class PageClient extends BaseApiClient {
                 throw error;
             }
             if (error instanceof types.DotHttpError) {
-                throw new types.DotErrorPage(`Page request failed for URL '${normalizedUrl}': ${error.message}`, error.status, 'UNKNOWN', error, { query: completeQuery, variables: requestVariables });
+                throw new types.DotErrorPage(`Page request failed for URL '${newURL}': ${error.message}`, error.status, 'UNKNOWN', error, { query: completeQuery, variables: requestVariables });
             }
-            throw new types.DotErrorPage(`Page request failed for URL '${normalizedUrl}': ${error instanceof Error ? error.message : 'Unknown error'}`, 500, 'UNKNOWN', undefined, { query: completeQuery, variables: requestVariables });
+            throw new types.DotErrorPage(`Page request failed for URL '${newURL}': ${error instanceof Error ? error.message : 'Unknown error'}`, 500, 'UNKNOWN', undefined, { query: completeQuery, variables: requestVariables });
         }
     }
 }

package/index.esm.js

@@ -110,7 +110,7 @@ class FetchHttpClient extends BaseHttpClient {
     }
 }
 
-/******************************************************************************
+/*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
 
 Permission to use, copy, modify, and/or distribute this software for any
@@ -124,7 +124,7 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
-/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+/* global Reflect, Promise */
 
 
 function __classPrivateFieldGet(receiver, state, kind, f) {
@@ -138,12 +138,7 @@ function __classPrivateFieldSet(receiver, state, value, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-}
-
-typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-};
+}
 
 /**
  * Utility functions for AI search parameter mapping and processing
@@ -2308,6 +2303,19 @@ function mapContentResponse(responseData, keys) {
         return accumulator;
     }, {});
 }
+/**
+ * Returns a shallow copy of the object with every key whose value is `undefined` removed.
+ *
+ * `undefined` is not valid JSON, so keeping such keys breaks consumers that serialize the value
+ * (e.g. Next.js Pages Router `getServerSideProps`/`getStaticProps`). `null` and other falsy values
+ * are preserved since they serialize fine.
+ *
+ * @param {Record<string, unknown>} object - Source object to clean
+ * @returns {Record<string, unknown>} New object without `undefined` values
+ */
+function removeUndefinedValues(object) {
+    return Object.fromEntries(Object.entries(object).filter(([, value]) => value !== undefined));
+}
 /**
  * Executes a GraphQL query against the DotCMS API.
  *
@@ -2427,12 +2435,10 @@ class PageClient extends BaseApiClient {
             additionalQueries: contentQuery,
             verbose
         });
-        const normalizedUrl = url.startsWith('/') ? url : `/${url}`;
-        const requestVariables = {
-            // The url is expected to have a leading slash to comply on VanityURL Matching, some frameworks like Angular will not add the leading slash
-            url: normalizedUrl,
-            // Translate the UVE_MODE key ('EDIT' | 'PREVIEW' | ...) to the value the backend PageMode enum expects ('EDIT_MODE' | 'PREVIEW_MODE' | ...)
-            mode: UVE_MODE[mode],
+        const newURL = url.startsWith('/') ? url : `/${url}`;
+        const requestVariables = removeUndefinedValues({
+            url: newURL,
+            mode: UVE_MODE[mode], // Translate the UVE_MODE key ('EDIT' | 'PREVIEW' | ...) to the value the backend PageMode enum expects ('EDIT_MODE' | 'PREVIEW_MODE' | ...)
             languageId,
             personaId,
             fireRules,
@@ -2440,7 +2446,7 @@ class PageClient extends BaseApiClient {
             siteId,
             variantName,
             ...variables
-        };
+        });
         const requestHeaders = this.requestOptions.headers;
         const requestBody = JSON.stringify({ query: completeQuery, variables: requestVariables });
         try {
@@ -2456,12 +2462,12 @@ class PageClient extends BaseApiClient {
                     .filter((error) => !error.extensions?.code)
                     .forEach((error) => {
                     if (verbose) {
-                        logVerboseError(normalizedUrl, error.message, {
+                        logVerboseError(newURL, error.message, {
                             variables: requestVariables
                         });
                     }
                     else {
-                        consola.error(`[DotCMS GraphQL Error] ${normalizedUrl}: `, error.message);
+                        consola.error(`[DotCMS GraphQL Error] ${newURL}: `, error.message);
                     }
                 });
             }
@@ -2487,19 +2493,19 @@ class PageClient extends BaseApiClient {
                     const status = structuredError.extensions?.status ??
                         (code === 'NOT_FOUND' ? 404 : code === 'PERMISSION_DENIED' ? 403 : 400);
                     const message = code === 'NOT_FOUND'
-                        ? `Page '${normalizedUrl}' was not found`
+                        ? `Page '${newURL}' was not found`
                         : code === 'PERMISSION_DENIED'
-                            ? `Permission denied: you do not have access to page '${normalizedUrl}'. Verify the page permissions in dotCMS and that the auth token has sufficient access.`
-                            : `Page '${normalizedUrl}' could not be loaded (${code})`;
+                            ? `Permission denied: you do not have access to page '${newURL}'. Verify the page permissions in dotCMS and that the auth token has sufficient access.`
+                            : `Page '${newURL}' could not be loaded (${code})`;
                     if (verbose) {
-                        logVerboseError(normalizedUrl, message, {
+                        logVerboseError(newURL, message, {
                             status,
                             code,
                             variables: requestVariables
                         });
                     }
                     else {
-                        consola.error(`[DotCMS GraphQL Error] ${normalizedUrl}: `, message);
+                        consola.error(`[DotCMS GraphQL Error] ${newURL}: `, message);
                     }
                     throw new DotErrorPage(message, status, code, undefined, {
                         query: completeQuery,
@@ -2513,10 +2519,10 @@ class PageClient extends BaseApiClient {
                 : null;
             const styleEditorSchemas = pageResponse ? pageResponse.page.styleEditorSchemas : [];
             if (!pageResponse) {
-                throw new DotErrorPage(`Page '${normalizedUrl}' was not found`, 404, 'NOT_FOUND', new DotHttpError({
+                throw new DotErrorPage(`Page '${newURL}' was not found`, 404, 'NOT_FOUND', new DotHttpError({
                     status: 404,
                     statusText: 'Not Found',
-                    message: `Page '${normalizedUrl}' was not found`,
+                    message: `Page '${newURL}' was not found`,
                     data: response.errors
                 }), { query: completeQuery, variables: requestVariables });
             }
@@ -2529,7 +2535,9 @@ class PageClient extends BaseApiClient {
                     query: completeQuery,
                     variables: requestVariables
                 },
-                errors: response.errors?.length ? response.errors : undefined,
+                // Always return an array (never `undefined`) so the response stays JSON-serializable
+                // for consumers like Next.js Pages Router (getServerSideProps/getStaticProps throw on undefined).
+                errors: response.errors?.length ? response.errors : [],
                 ...(styleEditorSchemas?.length && { styleEditorSchemas })
             };
         }
@@ -2538,9 +2546,9 @@ class PageClient extends BaseApiClient {
                 throw error;
             }
             if (error instanceof DotHttpError) {
-                throw new DotErrorPage(`Page request failed for URL '${normalizedUrl}': ${error.message}`, error.status, 'UNKNOWN', error, { query: completeQuery, variables: requestVariables });
+                throw new DotErrorPage(`Page request failed for URL '${newURL}': ${error.message}`, error.status, 'UNKNOWN', error, { query: completeQuery, variables: requestVariables });
             }
-            throw new DotErrorPage(`Page request failed for URL '${normalizedUrl}': ${error instanceof Error ? error.message : 'Unknown error'}`, 500, 'UNKNOWN', undefined, { query: completeQuery, variables: requestVariables });
+            throw new DotErrorPage(`Page request failed for URL '${newURL}': ${error instanceof Error ? error.message : 'Unknown error'}`, 500, 'UNKNOWN', undefined, { query: completeQuery, variables: requestVariables });
         }
     }
 }

package/internal.cjs.js

@@ -1,6 +1,5 @@
 'use strict';
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Transforms a GraphQL Page response to a Page Entity.
  *
@@ -19,7 +18,12 @@ const graphqlToPageEntity = (page) => {
     }
     const { layout, template, containers, urlContentMap, viewAs, host, vanityUrl, runningExperimentId, numberContents, _map, ...pageAsset } = page;
     const data = (_map || {});
-    const typedPageAsset = pageAsset;
+    // styleEditorSchemas comes back as null from GraphQL outside EDIT_MODE. Separate it from the
+    // rest of the page fields so it can be omitted entirely when it has no value. Emitting
+    // `undefined` (the previous behaviour) breaks JSON serialization for consumers like Next.js
+    // Pages Router (getServerSideProps/getStaticProps), while omitting the key keeps the optional
+    // DotCMSPage.styleEditorSchemas type accurate.
+    const { styleEditorSchemas, ...typedPageAsset } = pageAsset;
     // Merge all urlContentMap keys into _map, except _map itself
     const mergedUrlContentMap = {
         ...(urlContentMap?._map || {}),
@@ -43,9 +47,8 @@ const graphqlToPageEntity = (page) => {
         page: {
             ...data,
             ...typedPageAsset,
-            // GQL returns null when not in EDIT_MODE; normalize to undefined so the
-            // DotCMSPage type (StyleEditorFormSchema[], non-null) remains accurate.
-            styleEditorSchemas: typedPageAsset.styleEditorSchemas ?? undefined
+            // Only re-add styleEditorSchemas when it actually has a value (see destructure above).
+            ...(styleEditorSchemas ? { styleEditorSchemas } : {})
         }
     };
 };

package/internal.esm.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Transforms a GraphQL Page response to a Page Entity.
  *
@@ -17,7 +16,12 @@ const graphqlToPageEntity = (page) => {
     }
     const { layout, template, containers, urlContentMap, viewAs, host, vanityUrl, runningExperimentId, numberContents, _map, ...pageAsset } = page;
     const data = (_map || {});
-    const typedPageAsset = pageAsset;
+    // styleEditorSchemas comes back as null from GraphQL outside EDIT_MODE. Separate it from the
+    // rest of the page fields so it can be omitted entirely when it has no value. Emitting
+    // `undefined` (the previous behaviour) breaks JSON serialization for consumers like Next.js
+    // Pages Router (getServerSideProps/getStaticProps), while omitting the key keeps the optional
+    // DotCMSPage.styleEditorSchemas type accurate.
+    const { styleEditorSchemas, ...typedPageAsset } = pageAsset;
     // Merge all urlContentMap keys into _map, except _map itself
     const mergedUrlContentMap = {
         ...(urlContentMap?._map || {}),
@@ -41,9 +45,8 @@ const graphqlToPageEntity = (page) => {
         page: {
             ...data,
             ...typedPageAsset,
-            // GQL returns null when not in EDIT_MODE; normalize to undefined so the
-            // DotCMSPage type (StyleEditorFormSchema[], non-null) remains accurate.
-            styleEditorSchemas: typedPageAsset.styleEditorSchemas ?? undefined
+            // Only re-add styleEditorSchemas when it actually has a value (see destructure above).
+            ...(styleEditorSchemas ? { styleEditorSchemas } : {})
         }
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/client",
-  "version": "1.5.6",
+  "version": "1.6.0-next.36",
   "description": "Official JavaScript library for interacting with DotCMS REST APIs.",
   "repository": {
     "type": "git",
@@ -12,9 +12,6 @@
   "devDependencies": {
     "@dotcms/types": "latest"
   },
-  "scripts": {
-    "build": "nx run sdk-client:build:js; cd ../../../../dotCMS/src/main/webapp/html/js/editor-js; rm -rf src package.json *.esm.d.ts"
-  },
   "keywords": [
     "dotCMS",
     "CMS",
@@ -56,4 +53,4 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "types": "./index.d.ts"
-}
+}

package/src/lib/client/page/utils.d.ts

@@ -27,6 +27,17 @@ export declare function buildQuery(queryData: Record<string, string>): string;
  * @returns {Record<string, unknown> | undefined} New object containing only the specified keys
  */
 export declare function mapContentResponse(responseData: Record<string, unknown> | undefined, keys: string[]): Record<string, unknown> | undefined;
+/**
+ * Returns a shallow copy of the object with every key whose value is `undefined` removed.
+ *
+ * `undefined` is not valid JSON, so keeping such keys breaks consumers that serialize the value
+ * (e.g. Next.js Pages Router `getServerSideProps`/`getStaticProps`). `null` and other falsy values
+ * are preserved since they serialize fine.
+ *
+ * @param {Record<string, unknown>} object - Source object to clean
+ * @returns {Record<string, unknown>} New object without `undefined` values
+ */
+export declare function removeUndefinedValues(object: Record<string, unknown>): Record<string, unknown>;
 /**
  * Executes a GraphQL query against the DotCMS API.
  *