@dotcms/client 0.0.1-beta.40 → 0.0.1-beta.42

package/README.md

@@ -264,8 +264,17 @@ The `page.get()` method accepts an optional second argument of type [`DotCMSPage
 | `languageId` | string \| number | Language version of the page                     |
 | `mode`       | string           | Rendering mode: `LIVE`, `PREVIEW_MODE`, etc.     |
 | `personaId`  | string           | Personalize content based on persona ID          |
-| `graphql`    | object           | Extend the response with additional content/data |
-| `fireRules`  | boolean          | Whether to trigger page rules                    |
+| `graphql`    | DotCMSGraphQLParams          | GraphQL options for extending the response       |
+| `fireRules`  | boolean         | Whether to trigger page rules                    |
+
+The `graphql` option allows you to customize the page and content data returned. It accepts:
+
+| Property    | Type     | Description                                           |
+| ----------- | -------- | ----------------------------------------------------- |
+| `page`      | string   | GraphQL partial query that will be automatically wrapped with the page context. (you don't need to include the `page(url:"/")` wrapper in your query)    |
+| `content`   | object   | Named queries to fetch additional content             |
+| `fragments` | string[] | GraphQL fragments that can be reused across queries   |
+| `variables` | object   | Variables to pass into the GraphQL queries            |
 
 > 💡 See [`DotCMSPageRequestParams`](https://github.com/dotCMS/core/blob/6e003eb697554ea9636a1fec59bc0fa020b84390/core-web/libs/sdk/types/src/lib/client/public.ts#L5-L54) for a full list of supported options.
 

package/next.cjs.js

@@ -228,8 +228,8 @@ const buildPageQuery = ({ page, fragments, additionalQueries }) => {
 
   ${fragments ? fragments.join('\n\n') : ''}
 
-  query PageContent($url: String!, $languageId: String, $mode: String, $personaId: String, $fireRules: Boolean, $publishDate: String, $siteId: String) {
-    page: page(url: $url, languageId: $languageId, pageMode: $mode, persona: $personaId, fireRules: $fireRules, publishDate: $publishDate, site: $siteId) {
+  query PageContent($url: String!, $languageId: String, $mode: String, $personaId: String, $fireRules: Boolean, $publishDate: String, $siteId: String, $variantName: String) {
+    page: page(url: $url, languageId: $languageId, pageMode: $mode, persona: $personaId, fireRules: $fireRules, publishDate: $publishDate, site: $siteId, variantName: $variantName) {
       ...DotCMSPage
       ${page ? '...ClientPage' : ''}
     }
@@ -375,7 +375,7 @@ class PageClient {
      * ```
      */
     async get(url, options) {
-        const { languageId = '1', mode = 'LIVE', siteId = this.siteId, fireRules = false, personaId, publishDate, graphql = {} } = options || {};
+        const { languageId = '1', mode = 'LIVE', siteId = this.siteId, fireRules = false, personaId, publishDate, variantName, graphql = {} } = options || {};
         const { page, content = {}, variables, fragments } = graphql;
         const contentQuery = buildQuery(content);
         const completeQuery = buildPageQuery({
@@ -392,6 +392,7 @@ class PageClient {
             fireRules,
             publishDate,
             siteId,
+            variantName,
             ...variables
         };
         const requestHeaders = this.requestOptions.headers;
@@ -404,7 +405,7 @@ class PageClient {
             });
             if (errors) {
                 errors.forEach((error) => {
-                    throw new Error(error.message);
+                    consola.error('[DotCMS GraphQL Error]: ', error.message);
                 });
             }
             const pageResponse = transforms.graphqlToPageEntity(data);

package/next.esm.js

@@ -1,4 +1,4 @@
-import { consola } from 'consola';
+import consola$1, { consola } from 'consola';
 import { E as ErrorMessages, g as graphqlToPageEntity, C as Content } from './transforms.esm.js';
 
 class NavigationClient {
@@ -226,8 +226,8 @@ const buildPageQuery = ({ page, fragments, additionalQueries }) => {
 
   ${fragments ? fragments.join('\n\n') : ''}
 
-  query PageContent($url: String!, $languageId: String, $mode: String, $personaId: String, $fireRules: Boolean, $publishDate: String, $siteId: String) {
-    page: page(url: $url, languageId: $languageId, pageMode: $mode, persona: $personaId, fireRules: $fireRules, publishDate: $publishDate, site: $siteId) {
+  query PageContent($url: String!, $languageId: String, $mode: String, $personaId: String, $fireRules: Boolean, $publishDate: String, $siteId: String, $variantName: String) {
+    page: page(url: $url, languageId: $languageId, pageMode: $mode, persona: $personaId, fireRules: $fireRules, publishDate: $publishDate, site: $siteId, variantName: $variantName) {
       ...DotCMSPage
       ${page ? '...ClientPage' : ''}
     }
@@ -373,7 +373,7 @@ class PageClient {
      * ```
      */
     async get(url, options) {
-        const { languageId = '1', mode = 'LIVE', siteId = this.siteId, fireRules = false, personaId, publishDate, graphql = {} } = options || {};
+        const { languageId = '1', mode = 'LIVE', siteId = this.siteId, fireRules = false, personaId, publishDate, variantName, graphql = {} } = options || {};
         const { page, content = {}, variables, fragments } = graphql;
         const contentQuery = buildQuery(content);
         const completeQuery = buildPageQuery({
@@ -390,6 +390,7 @@ class PageClient {
             fireRules,
             publishDate,
             siteId,
+            variantName,
             ...variables
         };
         const requestHeaders = this.requestOptions.headers;
@@ -402,7 +403,7 @@ class PageClient {
             });
             if (errors) {
                 errors.forEach((error) => {
-                    throw new Error(error.message);
+                    consola$1.error('[DotCMS GraphQL Error]: ', error.message);
                 });
             }
             const pageResponse = graphqlToPageEntity(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/client",
-  "version": "0.0.1-beta.40",
+  "version": "0.0.1-beta.42",
   "description": "Official JavaScript library for interacting with DotCMS REST APIs.",
   "repository": {
     "type": "git",