@builder.io/sdk-svelte 5.2.9 → 5.2.11

package/lib/browser/components/content/components/enable-editor.svelte

@@ -28,6 +28,7 @@ export let apiKey;
 export let apiHost = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let trustedHosts = undefined;
 export let model;
 export let content;
@@ -215,6 +216,11 @@ function elementRef_onIniteditingbldr(event) {
                 enrich: enrich,
             }
             : {}),
+        ...(enrichOptions
+            ? {
+                enrichOptions: enrichOptions,
+            }
+            : {}),
         ...(trustedHosts
             ? {
                 trustedHosts: trustedHosts,

package/lib/browser/components/content/components/enable-editor.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         apiHost?: BuilderEditorProps["apiHost"];
         locale?: BuilderEditorProps["locale"];
         enrich?: BuilderEditorProps["enrich"];
+        enrichOptions?: BuilderEditorProps["enrichOptions"];
         trustedHosts?: BuilderEditorProps["trustedHosts"];
         model: BuilderEditorProps["model"];
         content: BuilderEditorProps["content"];

package/lib/browser/components/content/content.svelte

@@ -28,6 +28,7 @@ export let nonce = undefined;
 export let model;
 export let apiHost = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let showContent;
 export let contentWrapper = undefined;
 export let contentWrapperProps = undefined;
@@ -140,6 +141,7 @@ setContext(ComponentsContext.key, {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   {showContent}
   {builderContextSignal}
   {contentWrapper}

package/lib/browser/components/content/content.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         model: ContentProps["model"];
         apiHost?: ContentProps["apiHost"];
         enrich?: ContentProps["enrich"];
+        enrichOptions?: ContentProps["enrichOptions"];
         showContent: ContentProps["showContent"];
         contentWrapper?: ContentProps["contentWrapper"];
         contentWrapperProps?: ContentProps["contentWrapperProps"];

package/lib/browser/components/content-variants/content-variants.svelte

@@ -23,6 +23,7 @@ export let customComponents = undefined;
 export let linkComponent = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let blocksWrapper = undefined;
 export let blocksWrapperProps = undefined;
 export let contentWrapper = undefined;
@@ -107,6 +108,7 @@ onMount(() => {
       {canTrack}
       {locale}
       {enrich}
+      {enrichOptions}
       isSsrAbTest={shouldRenderVariants}
       {blocksWrapper}
       {blocksWrapperProps}
@@ -134,6 +136,7 @@ onMount(() => {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   isSsrAbTest={shouldRenderVariants}
   {blocksWrapper}
   {blocksWrapperProps}

package/lib/browser/components/content-variants/content-variants.svelte.d.ts

@@ -22,6 +22,7 @@ declare const __propDef: {
         linkComponent?: VariantsProviderProps["linkComponent"];
         locale?: VariantsProviderProps["locale"];
         enrich?: VariantsProviderProps["enrich"];
+        enrichOptions?: VariantsProviderProps["enrichOptions"];
         blocksWrapper?: VariantsProviderProps["blocksWrapper"];
         blocksWrapperProps?: VariantsProviderProps["blocksWrapperProps"];
         contentWrapper?: VariantsProviderProps["contentWrapper"];

package/lib/browser/components/content-variants/content-variants.types.d.ts

@@ -1,4 +1,5 @@
 import type { BuilderRenderContext, RegisteredComponent } from '../../context/types';
+import type { EnrichOptions } from '../../functions/get-content/types';
 import type { ApiVersion } from '../../types/api-version';
 import type { BuilderContent } from '../../types/builder-content';
 import type { Nullable } from '../../types/typescript';
@@ -53,6 +54,13 @@ export interface ContentVariantsPrps extends ExtraFrameworkProps {
      * Enriching will Include multilevel references in the response. Defaults to `false`.
      */
     enrich?: boolean;
+    /**
+     * The `enrichOptions` used to fetch this content (optional).
+     *
+     * Passing the same value you passed to `fetchOneEntry` lets the Visual Editor
+     * resolve references in its preview the way your site fetches them.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * The element that wraps your content. Defaults to `<div>` ('ScrollView' in React Native).
      */

package/lib/browser/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.2.9";
+export declare const SDK_VERSION = "5.2.11";

package/lib/browser/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.2.9";
+export const SDK_VERSION = "5.2.11";

package/lib/browser/functions/get-content/generate-content-url.js

@@ -5,7 +5,7 @@ import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/i
 import { isBrowser } from '../is-browser';
 const isPositiveNumber = (thing) => typeof thing === 'number' && !isNaN(thing) && thing >= 0;
 export const generateContentUrl = (options) => {
-    const { limit = 30, userAttributes, query, model, apiKey, enrich, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
+    const { limit = 30, userAttributes, query, model, apiKey, enrich, enrichOptions, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
     if (!apiKey) {
         throw new Error('Missing API key');
     }
@@ -26,6 +26,10 @@ export const generateContentUrl = (options) => {
     let finalUserAttributes = userAttributes || {};
     if (enrich)
         url.searchParams.set('enrich', String(enrich));
+    // Only honored alongside `enrich=true` by the content API.
+    if (enrich && enrichOptions) {
+        url.searchParams.set('enrichOptions', JSON.stringify(enrichOptions));
+    }
     url.searchParams.set('omit', omit ?? 'meta.componentsUsed');
     if (fields) {
         url.searchParams.set('fields', fields);
@@ -76,11 +80,18 @@ export const generateContentUrl = (options) => {
     }
     return url;
 };
+const parseStudioUserAttribute = (value) => {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return value;
+};
 const getUserAttributesFromQueryOptions = (queryOptions) => {
     const newUserAttributes = {};
     for (const key in queryOptions) {
         if (key.startsWith('userAttributes.')) {
-            newUserAttributes[key] = queryOptions[key];
+            newUserAttributes[key] = parseStudioUserAttribute(queryOptions[key]);
             delete queryOptions[key];
         }
     }

package/lib/browser/functions/get-content/types.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Options to configure how `enrich` resolves references.
+ *
+ * @see {@link https://www.builder.io/c/docs/content-api#code-enrich-options-code}
+ */
+export interface EnrichOptions {
+    /**
+     * How many levels of nested references to resolve. Higher levels multiply
+     * response size, so prefer the lowest level your content needs.
+     */
+    enrichLevel?: number;
+    /**
+     * Per-model field filters applied to resolved references.
+     */
+    model?: {
+        [modelName: string]: {
+            /** Comma-separated list of fields to include */
+            fields?: string;
+            /** Comma-separated list of fields to omit */
+            omit?: string;
+        };
+    };
+}
 export interface GetContentOptions {
     /** The model to get content for (required) */
     model: string;
@@ -58,6 +81,10 @@ export interface GetContentOptions {
      * Include multilevel references in the response.
      */
     enrich?: boolean;
+    /**
+     * Constrains how `enrich` resolves references. Only honored when `enrich` is `true`.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * If provided, the API will auto-resolve localized objects to the value of this `locale` key.
      */

package/lib/browser/scripts/init-editing.d.ts

@@ -1,7 +1,9 @@
+import type { EnrichOptions } from '../functions/get-content/types';
 export declare const setupBrowserForEditing: (options: {
     modelName: string;
     apiKey: string;
     enrich?: boolean;
+    enrichOptions?: EnrichOptions;
     includeRefs?: boolean;
     locale?: string;
     trustedHosts?: string[];

package/lib/edge/components/content/components/enable-editor.svelte

@@ -28,6 +28,7 @@ export let apiKey;
 export let apiHost = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let trustedHosts = undefined;
 export let model;
 export let content;
@@ -215,6 +216,11 @@ function elementRef_onIniteditingbldr(event) {
                 enrich: enrich,
             }
             : {}),
+        ...(enrichOptions
+            ? {
+                enrichOptions: enrichOptions,
+            }
+            : {}),
         ...(trustedHosts
             ? {
                 trustedHosts: trustedHosts,

package/lib/edge/components/content/components/enable-editor.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         apiHost?: BuilderEditorProps["apiHost"];
         locale?: BuilderEditorProps["locale"];
         enrich?: BuilderEditorProps["enrich"];
+        enrichOptions?: BuilderEditorProps["enrichOptions"];
         trustedHosts?: BuilderEditorProps["trustedHosts"];
         model: BuilderEditorProps["model"];
         content: BuilderEditorProps["content"];

package/lib/edge/components/content/content.svelte

@@ -28,6 +28,7 @@ export let nonce = undefined;
 export let model;
 export let apiHost = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let showContent;
 export let contentWrapper = undefined;
 export let contentWrapperProps = undefined;
@@ -140,6 +141,7 @@ setContext(ComponentsContext.key, {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   {showContent}
   {builderContextSignal}
   {contentWrapper}

package/lib/edge/components/content/content.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         model: ContentProps["model"];
         apiHost?: ContentProps["apiHost"];
         enrich?: ContentProps["enrich"];
+        enrichOptions?: ContentProps["enrichOptions"];
         showContent: ContentProps["showContent"];
         contentWrapper?: ContentProps["contentWrapper"];
         contentWrapperProps?: ContentProps["contentWrapperProps"];

package/lib/edge/components/content-variants/content-variants.svelte

@@ -23,6 +23,7 @@ export let customComponents = undefined;
 export let linkComponent = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let blocksWrapper = undefined;
 export let blocksWrapperProps = undefined;
 export let contentWrapper = undefined;
@@ -107,6 +108,7 @@ onMount(() => {
       {canTrack}
       {locale}
       {enrich}
+      {enrichOptions}
       isSsrAbTest={shouldRenderVariants}
       {blocksWrapper}
       {blocksWrapperProps}
@@ -134,6 +136,7 @@ onMount(() => {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   isSsrAbTest={shouldRenderVariants}
   {blocksWrapper}
   {blocksWrapperProps}

package/lib/edge/components/content-variants/content-variants.svelte.d.ts

@@ -22,6 +22,7 @@ declare const __propDef: {
         linkComponent?: VariantsProviderProps["linkComponent"];
         locale?: VariantsProviderProps["locale"];
         enrich?: VariantsProviderProps["enrich"];
+        enrichOptions?: VariantsProviderProps["enrichOptions"];
         blocksWrapper?: VariantsProviderProps["blocksWrapper"];
         blocksWrapperProps?: VariantsProviderProps["blocksWrapperProps"];
         contentWrapper?: VariantsProviderProps["contentWrapper"];

package/lib/edge/components/content-variants/content-variants.types.d.ts

@@ -1,4 +1,5 @@
 import type { BuilderRenderContext, RegisteredComponent } from '../../context/types';
+import type { EnrichOptions } from '../../functions/get-content/types';
 import type { ApiVersion } from '../../types/api-version';
 import type { BuilderContent } from '../../types/builder-content';
 import type { Nullable } from '../../types/typescript';
@@ -53,6 +54,13 @@ export interface ContentVariantsPrps extends ExtraFrameworkProps {
      * Enriching will Include multilevel references in the response. Defaults to `false`.
      */
     enrich?: boolean;
+    /**
+     * The `enrichOptions` used to fetch this content (optional).
+     *
+     * Passing the same value you passed to `fetchOneEntry` lets the Visual Editor
+     * resolve references in its preview the way your site fetches them.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * The element that wraps your content. Defaults to `<div>` ('ScrollView' in React Native).
      */

package/lib/edge/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.2.9";
+export declare const SDK_VERSION = "5.2.11";

package/lib/edge/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.2.9";
+export const SDK_VERSION = "5.2.11";

package/lib/edge/functions/get-content/generate-content-url.js

@@ -5,7 +5,7 @@ import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/i
 import { isBrowser } from '../is-browser';
 const isPositiveNumber = (thing) => typeof thing === 'number' && !isNaN(thing) && thing >= 0;
 export const generateContentUrl = (options) => {
-    const { limit = 30, userAttributes, query, model, apiKey, enrich, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
+    const { limit = 30, userAttributes, query, model, apiKey, enrich, enrichOptions, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
     if (!apiKey) {
         throw new Error('Missing API key');
     }
@@ -26,6 +26,10 @@ export const generateContentUrl = (options) => {
     let finalUserAttributes = userAttributes || {};
     if (enrich)
         url.searchParams.set('enrich', String(enrich));
+    // Only honored alongside `enrich=true` by the content API.
+    if (enrich && enrichOptions) {
+        url.searchParams.set('enrichOptions', JSON.stringify(enrichOptions));
+    }
     url.searchParams.set('omit', omit ?? 'meta.componentsUsed');
     if (fields) {
         url.searchParams.set('fields', fields);
@@ -76,11 +80,18 @@ export const generateContentUrl = (options) => {
     }
     return url;
 };
+const parseStudioUserAttribute = (value) => {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return value;
+};
 const getUserAttributesFromQueryOptions = (queryOptions) => {
     const newUserAttributes = {};
     for (const key in queryOptions) {
         if (key.startsWith('userAttributes.')) {
-            newUserAttributes[key] = queryOptions[key];
+            newUserAttributes[key] = parseStudioUserAttribute(queryOptions[key]);
             delete queryOptions[key];
         }
     }

package/lib/edge/functions/get-content/types.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Options to configure how `enrich` resolves references.
+ *
+ * @see {@link https://www.builder.io/c/docs/content-api#code-enrich-options-code}
+ */
+export interface EnrichOptions {
+    /**
+     * How many levels of nested references to resolve. Higher levels multiply
+     * response size, so prefer the lowest level your content needs.
+     */
+    enrichLevel?: number;
+    /**
+     * Per-model field filters applied to resolved references.
+     */
+    model?: {
+        [modelName: string]: {
+            /** Comma-separated list of fields to include */
+            fields?: string;
+            /** Comma-separated list of fields to omit */
+            omit?: string;
+        };
+    };
+}
 export interface GetContentOptions {
     /** The model to get content for (required) */
     model: string;
@@ -58,6 +81,10 @@ export interface GetContentOptions {
      * Include multilevel references in the response.
      */
     enrich?: boolean;
+    /**
+     * Constrains how `enrich` resolves references. Only honored when `enrich` is `true`.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * If provided, the API will auto-resolve localized objects to the value of this `locale` key.
      */

package/lib/edge/scripts/init-editing.d.ts

@@ -1,7 +1,9 @@
+import type { EnrichOptions } from '../functions/get-content/types';
 export declare const setupBrowserForEditing: (options: {
     modelName: string;
     apiKey: string;
     enrich?: boolean;
+    enrichOptions?: EnrichOptions;
     includeRefs?: boolean;
     locale?: string;
     trustedHosts?: string[];

package/lib/node/components/content/components/enable-editor.svelte

@@ -28,6 +28,7 @@ export let apiKey;
 export let apiHost = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let trustedHosts = undefined;
 export let model;
 export let content;
@@ -215,6 +216,11 @@ function elementRef_onIniteditingbldr(event) {
                 enrich: enrich,
             }
             : {}),
+        ...(enrichOptions
+            ? {
+                enrichOptions: enrichOptions,
+            }
+            : {}),
         ...(trustedHosts
             ? {
                 trustedHosts: trustedHosts,

package/lib/node/components/content/components/enable-editor.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         apiHost?: BuilderEditorProps["apiHost"];
         locale?: BuilderEditorProps["locale"];
         enrich?: BuilderEditorProps["enrich"];
+        enrichOptions?: BuilderEditorProps["enrichOptions"];
         trustedHosts?: BuilderEditorProps["trustedHosts"];
         model: BuilderEditorProps["model"];
         content: BuilderEditorProps["content"];

package/lib/node/components/content/content.svelte

@@ -28,6 +28,7 @@ export let nonce = undefined;
 export let model;
 export let apiHost = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let showContent;
 export let contentWrapper = undefined;
 export let contentWrapperProps = undefined;
@@ -140,6 +141,7 @@ setContext(ComponentsContext.key, {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   {showContent}
   {builderContextSignal}
   {contentWrapper}

package/lib/node/components/content/content.svelte.d.ts

@@ -16,6 +16,7 @@ declare const __propDef: {
         model: ContentProps["model"];
         apiHost?: ContentProps["apiHost"];
         enrich?: ContentProps["enrich"];
+        enrichOptions?: ContentProps["enrichOptions"];
         showContent: ContentProps["showContent"];
         contentWrapper?: ContentProps["contentWrapper"];
         contentWrapperProps?: ContentProps["contentWrapperProps"];

package/lib/node/components/content-variants/content-variants.svelte

@@ -23,6 +23,7 @@ export let customComponents = undefined;
 export let linkComponent = undefined;
 export let locale = undefined;
 export let enrich = undefined;
+export let enrichOptions = undefined;
 export let blocksWrapper = undefined;
 export let blocksWrapperProps = undefined;
 export let contentWrapper = undefined;
@@ -107,6 +108,7 @@ onMount(() => {
       {canTrack}
       {locale}
       {enrich}
+      {enrichOptions}
       isSsrAbTest={shouldRenderVariants}
       {blocksWrapper}
       {blocksWrapperProps}
@@ -134,6 +136,7 @@ onMount(() => {
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   isSsrAbTest={shouldRenderVariants}
   {blocksWrapper}
   {blocksWrapperProps}

package/lib/node/components/content-variants/content-variants.svelte.d.ts

@@ -22,6 +22,7 @@ declare const __propDef: {
         linkComponent?: VariantsProviderProps["linkComponent"];
         locale?: VariantsProviderProps["locale"];
         enrich?: VariantsProviderProps["enrich"];
+        enrichOptions?: VariantsProviderProps["enrichOptions"];
         blocksWrapper?: VariantsProviderProps["blocksWrapper"];
         blocksWrapperProps?: VariantsProviderProps["blocksWrapperProps"];
         contentWrapper?: VariantsProviderProps["contentWrapper"];

package/lib/node/components/content-variants/content-variants.types.d.ts

@@ -1,4 +1,5 @@
 import type { BuilderRenderContext, RegisteredComponent } from '../../context/types';
+import type { EnrichOptions } from '../../functions/get-content/types';
 import type { ApiVersion } from '../../types/api-version';
 import type { BuilderContent } from '../../types/builder-content';
 import type { Nullable } from '../../types/typescript';
@@ -53,6 +54,13 @@ export interface ContentVariantsPrps extends ExtraFrameworkProps {
      * Enriching will Include multilevel references in the response. Defaults to `false`.
      */
     enrich?: boolean;
+    /**
+     * The `enrichOptions` used to fetch this content (optional).
+     *
+     * Passing the same value you passed to `fetchOneEntry` lets the Visual Editor
+     * resolve references in its preview the way your site fetches them.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * The element that wraps your content. Defaults to `<div>` ('ScrollView' in React Native).
      */

package/lib/node/constants/sdk-version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.2.9";
+export declare const SDK_VERSION = "5.2.11";

package/lib/node/constants/sdk-version.js

@@ -1 +1 @@
-export const SDK_VERSION = "5.2.9";
+export const SDK_VERSION = "5.2.11";

package/lib/node/functions/get-content/generate-content-url.js

@@ -5,7 +5,7 @@ import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/i
 import { isBrowser } from '../is-browser';
 const isPositiveNumber = (thing) => typeof thing === 'number' && !isNaN(thing) && thing >= 0;
 export const generateContentUrl = (options) => {
-    const { limit = 30, userAttributes, query, model, apiKey, enrich, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
+    const { limit = 30, userAttributes, query, model, apiKey, enrich, enrichOptions, locale, apiVersion = DEFAULT_API_VERSION, fields, omit, offset, cacheSeconds, staleCacheSeconds, sort, includeUnpublished, apiHost } = options;
     if (!apiKey) {
         throw new Error('Missing API key');
     }
@@ -26,6 +26,10 @@ export const generateContentUrl = (options) => {
     let finalUserAttributes = userAttributes || {};
     if (enrich)
         url.searchParams.set('enrich', String(enrich));
+    // Only honored alongside `enrich=true` by the content API.
+    if (enrich && enrichOptions) {
+        url.searchParams.set('enrichOptions', JSON.stringify(enrichOptions));
+    }
     url.searchParams.set('omit', omit ?? 'meta.componentsUsed');
     if (fields) {
         url.searchParams.set('fields', fields);
@@ -76,11 +80,18 @@ export const generateContentUrl = (options) => {
     }
     return url;
 };
+const parseStudioUserAttribute = (value) => {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return value;
+};
 const getUserAttributesFromQueryOptions = (queryOptions) => {
     const newUserAttributes = {};
     for (const key in queryOptions) {
         if (key.startsWith('userAttributes.')) {
-            newUserAttributes[key] = queryOptions[key];
+            newUserAttributes[key] = parseStudioUserAttribute(queryOptions[key]);
             delete queryOptions[key];
         }
     }

package/lib/node/functions/get-content/types.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Options to configure how `enrich` resolves references.
+ *
+ * @see {@link https://www.builder.io/c/docs/content-api#code-enrich-options-code}
+ */
+export interface EnrichOptions {
+    /**
+     * How many levels of nested references to resolve. Higher levels multiply
+     * response size, so prefer the lowest level your content needs.
+     */
+    enrichLevel?: number;
+    /**
+     * Per-model field filters applied to resolved references.
+     */
+    model?: {
+        [modelName: string]: {
+            /** Comma-separated list of fields to include */
+            fields?: string;
+            /** Comma-separated list of fields to omit */
+            omit?: string;
+        };
+    };
+}
 export interface GetContentOptions {
     /** The model to get content for (required) */
     model: string;
@@ -58,6 +81,10 @@ export interface GetContentOptions {
      * Include multilevel references in the response.
      */
     enrich?: boolean;
+    /**
+     * Constrains how `enrich` resolves references. Only honored when `enrich` is `true`.
+     */
+    enrichOptions?: EnrichOptions;
     /**
      * If provided, the API will auto-resolve localized objects to the value of this `locale` key.
      */

package/lib/node/scripts/init-editing.d.ts

@@ -1,7 +1,9 @@
+import type { EnrichOptions } from '../functions/get-content/types';
 export declare const setupBrowserForEditing: (options: {
     modelName: string;
     apiKey: string;
     enrich?: boolean;
+    enrichOptions?: EnrichOptions;
     includeRefs?: boolean;
     locale?: string;
     trustedHosts?: string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@builder.io/sdk-svelte",
   "description": "Builder.io SDK for Svelte",
-  "version": "5.2.9",
+  "version": "5.2.11",
   "type": "module",
   "files": [
     "lib",

package/src/components/content/components/enable-editor.svelte

@@ -78,6 +78,7 @@
   export let apiHost: BuilderEditorProps["apiHost"] = undefined;
   export let locale: BuilderEditorProps["locale"] = undefined;
   export let enrich: BuilderEditorProps["enrich"] = undefined;
+  export let enrichOptions: BuilderEditorProps["enrichOptions"] = undefined;
   export let trustedHosts: BuilderEditorProps["trustedHosts"] = undefined;
   export let model: BuilderEditorProps["model"];
   export let content: BuilderEditorProps["content"];
@@ -286,6 +287,11 @@
             enrich: enrich,
           }
         : {}),
+      ...(enrichOptions
+        ? {
+            enrichOptions: enrichOptions,
+          }
+        : {}),
       ...(trustedHosts
         ? {
             trustedHosts: trustedHosts,

package/src/components/content/content.svelte

@@ -42,6 +42,7 @@
   export let model: ContentProps["model"];
   export let apiHost: ContentProps["apiHost"] = undefined;
   export let enrich: ContentProps["enrich"] = undefined;
+  export let enrichOptions: ContentProps["enrichOptions"] = undefined;
   export let showContent: ContentProps["showContent"];
   export let contentWrapper: ContentProps["contentWrapper"] = undefined;
   export let contentWrapperProps: ContentProps["contentWrapperProps"] =
@@ -170,6 +171,7 @@
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   {showContent}
   {builderContextSignal}
   {contentWrapper}

package/src/components/content-variants/content-variants.svelte

@@ -45,6 +45,7 @@
   export let linkComponent: VariantsProviderProps["linkComponent"] = undefined;
   export let locale: VariantsProviderProps["locale"] = undefined;
   export let enrich: VariantsProviderProps["enrich"] = undefined;
+  export let enrichOptions: VariantsProviderProps["enrichOptions"] = undefined;
   export let blocksWrapper: VariantsProviderProps["blocksWrapper"] = undefined;
   export let blocksWrapperProps: VariantsProviderProps["blocksWrapperProps"] =
     undefined;
@@ -139,6 +140,7 @@
       {canTrack}
       {locale}
       {enrich}
+      {enrichOptions}
       isSsrAbTest={shouldRenderVariants}
       {blocksWrapper}
       {blocksWrapperProps}
@@ -166,6 +168,7 @@
   {canTrack}
   {locale}
   {enrich}
+  {enrichOptions}
   isSsrAbTest={shouldRenderVariants}
   {blocksWrapper}
   {blocksWrapperProps}

package/src/components/content-variants/content-variants.types.ts

@@ -1,4 +1,5 @@
 import type { BuilderRenderContext, RegisteredComponent } from '../../context/types';
+import type { EnrichOptions } from '../../functions/get-content/types';
 import type { ApiVersion } from '../../types/api-version';
 import type { BuilderContent } from '../../types/builder-content';
 import type { Nullable } from '../../types/typescript';
@@ -63,6 +64,14 @@ export interface ContentVariantsPrps extends ExtraFrameworkProps {
    */
   enrich?: boolean;
 
+  /**
+   * The `enrichOptions` used to fetch this content (optional).
+   *
+   * Passing the same value you passed to `fetchOneEntry` lets the Visual Editor
+   * resolve references in its preview the way your site fetches them.
+   */
+  enrichOptions?: EnrichOptions;
+
   /**
    * The element that wraps your content. Defaults to `<div>` ('ScrollView' in React Native).
    */

package/src/constants/sdk-version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "5.2.9"
+export const SDK_VERSION = "5.2.11"

package/src/functions/get-content/generate-content-url.ts

@@ -13,6 +13,7 @@ export const generateContentUrl = (options: GetContentOptions): URL => {
     model,
     apiKey,
     enrich,
+    enrichOptions,
     locale,
     apiVersion = DEFAULT_API_VERSION,
     fields,
@@ -44,6 +45,11 @@ export const generateContentUrl = (options: GetContentOptions): URL => {
   }
   let finalUserAttributes: Record<string, any> = userAttributes || {};
   if (enrich) url.searchParams.set('enrich', String(enrich));
+
+  // Only honored alongside `enrich=true` by the content API.
+  if (enrich && enrichOptions) {
+    url.searchParams.set('enrichOptions', JSON.stringify(enrichOptions));
+  }
   url.searchParams.set('omit', omit ?? 'meta.componentsUsed');
   if (fields) {
     url.searchParams.set('fields', fields);
@@ -96,11 +102,16 @@ export const generateContentUrl = (options: GetContentOptions): URL => {
   }
   return url;
 };
+const parseStudioUserAttribute = (value: unknown) => {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  return value;
+};
 const getUserAttributesFromQueryOptions = (queryOptions: any) => {
   const newUserAttributes: any = {};
   for (const key in queryOptions) {
     if (key.startsWith('userAttributes.')) {
-      newUserAttributes[key] = queryOptions[key];
+      newUserAttributes[key] = parseStudioUserAttribute(queryOptions[key]);
       delete queryOptions[key];
     }
   }

package/src/functions/get-content/types.ts

@@ -1,3 +1,27 @@
+/**
+ * Options to configure how `enrich` resolves references.
+ *
+ * @see {@link https://www.builder.io/c/docs/content-api#code-enrich-options-code}
+ */
+export interface EnrichOptions {
+  /**
+   * How many levels of nested references to resolve. Higher levels multiply
+   * response size, so prefer the lowest level your content needs.
+   */
+  enrichLevel?: number;
+
+  /**
+   * Per-model field filters applied to resolved references.
+   */
+  model?: {
+    [modelName: string]: {
+      /** Comma-separated list of fields to include */
+      fields?: string;
+      /** Comma-separated list of fields to omit */
+      omit?: string;
+    };
+  };
+}
 export interface GetContentOptions {
   /** The model to get content for (required) */
   model: string;
@@ -67,6 +91,11 @@ export interface GetContentOptions {
    */
   enrich?: boolean;
 
+  /**
+   * Constrains how `enrich` resolves references. Only honored when `enrich` is `true`.
+   */
+  enrichOptions?: EnrichOptions;
+
   /**
    * If provided, the API will auto-resolve localized objects to the value of this `locale` key.
    */

package/src/scripts/init-editing.ts

@@ -1,5 +1,6 @@
 import { SDK_VERSION } from '../constants/sdk-version';
 import { TARGET } from '../constants/target';
+import type { EnrichOptions } from '../functions/get-content/types';
 import { isBrowser } from '../functions/is-browser';
 import { isFromTrustedHost } from '../functions/is-from-trusted-host';
 let isSetupForEditing = false;
@@ -7,6 +8,9 @@ export const setupBrowserForEditing = (options: {
   modelName: string;
   apiKey: string;
   enrich?: boolean;
+  // Forwarded to the editor as part of `builder.updateContent` below, so its
+  // preview can resolve references with the same constraints as this site's fetch.
+  enrichOptions?: EnrichOptions;
   includeRefs?: boolean;
   locale?: string;
   trustedHosts?: string[];