@dotcms/client 26.11.3-1 → 26.11.3-1-next.3036

package/README.md

@@ -909,6 +909,10 @@ getCollection<T = DotCMSBasicContentlet>(
 | `language()`          | `number \| string`            | Set content language                                               |
 | `depth()`             | `number`                      | Set depth of related content                                       |
 | `includeSystemHost()` | -                             | Include content from the System Host alongside the configured site |
+| `variant()`           | `string`                      | Filter content by variant ID (see the note below)                  |
+
+> [!NOTE]
+> Requests made without a back-end user's token (e.g.: anonymous or front-end-only users) return the default variant, even if another variant is specified.
 
 #### Example
 ```typescript

package/index.cjs.js

@@ -4,7 +4,7 @@ var consola = require('consola');
 var types = require('@dotcms/types');
 var internal = require('./internal.cjs.js');
 
-const SDK_VERSION = "26.11.3-1";
+const SDK_VERSION = "26.11.3-1-next.3036";
 
 const DOTCMS_VERSION_HEADER = 'x-dotcms-version';
 const DOTCMS_MIN_SDK_HEADER = 'x-dotcms-min-sdk';
@@ -1765,6 +1765,12 @@ class CollectionBuilder extends BaseBuilder {
      *
      * More information here: {@link https://www.dotcms.com/docs/latest/content-api-retrieval-and-querying#ParamsOptional}
      *
+     * Only reaches a non-default variant when the request carries a back-end user's token. An
+     * anonymous request, or one made with a front-end-only token, is answered with the default
+     * variant's version of the content whatever variant it names - the call neither fails nor
+     * comes back empty. Experiment variants of a page are unaffected: those are selected by the
+     * page rendering path, not by this builder.
+     *
      * @example
      * ```ts
      * const client = new DotCMSClient(config);

package/index.esm.js

@@ -2,7 +2,7 @@ import { consola } from 'consola';
 import { BaseHttpClient, DISTANCE_FUNCTIONS, DotHttpError, DotErrorAISearch, DotErrorContent, DotErrorNavigation, UVE_MODE, DotErrorPage } from '@dotcms/types';
 import { graphqlToPageEntity } from './internal.esm.js';
 
-const SDK_VERSION = "26.11.3-1";
+const SDK_VERSION = "26.11.3-1-next.3036";
 
 const DOTCMS_VERSION_HEADER = 'x-dotcms-version';
 const DOTCMS_MIN_SDK_HEADER = 'x-dotcms-min-sdk';
@@ -1763,6 +1763,12 @@ class CollectionBuilder extends BaseBuilder {
      *
      * More information here: {@link https://www.dotcms.com/docs/latest/content-api-retrieval-and-querying#ParamsOptional}
      *
+     * Only reaches a non-default variant when the request carries a back-end user's token. An
+     * anonymous request, or one made with a front-end-only token, is answered with the default
+     * variant's version of the content whatever variant it names - the call neither fails nor
+     * comes back empty. Experiment variants of a page are unaffected: those are selected by the
+     * page rendering path, not by this builder.
+     *
      * @example
      * ```ts
      * const client = new DotCMSClient(config);

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@dotcms/client",
-  "version": "26.11.3-1",
+  "version": "26.11.3-1-next.3036",
   "description": "Official JavaScript library for interacting with DotCMS REST APIs.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dotCMS/core.git#main"
   },
   "peerDependencies": {
-    "@dotcms/types": "26.11.3-1"
+    "@dotcms/types": "26.11.3-1-next.3036"
   },
   "dependencies": {
     "consola": "^3.4.2"
   },
   "devDependencies": {
-    "@dotcms/types": "26.11.3-1"
+    "@dotcms/types": "26.11.3-1-next.3036"
   },
   "keywords": [
     "dotCMS",

package/src/lib/client/content/builders/collection/collection.d.ts

@@ -117,6 +117,12 @@ export declare class CollectionBuilder<T = unknown> extends BaseBuilder<T> {
      *
      * More information here: {@link https://www.dotcms.com/docs/latest/content-api-retrieval-and-querying#ParamsOptional}
      *
+     * Only reaches a non-default variant when the request carries a back-end user's token. An
+     * anonymous request, or one made with a front-end-only token, is answered with the default
+     * variant's version of the content whatever variant it names - the call neither fails nor
+     * comes back empty. Experiment variants of a page are unaffected: those are selected by the
+     * page rendering path, not by this builder.
+     *
      * @example
      * ```ts
      * const client = new DotCMSClient(config);