@builder.io/sdk-svelte 1.0.4 → 1.0.6

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.4";
+export declare const SDK_VERSION = "1.0.6";

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

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.4";
+export const SDK_VERSION = "1.0.6";

package/lib/browser/functions/get-builder-search-params/index.d.ts

@@ -1,5 +1,4 @@
-type QueryObject = Record<string, string | string[]>;
-export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+import type { QueryObject } from '../../helpers/search/search.js';
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -8,5 +7,3 @@ export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchP
  */
 export declare const getBuilderSearchParams: (_options: QueryObject | URLSearchParams | undefined) => QueryObject;
 export declare const getBuilderSearchParamsFromWindow: () => QueryObject;
-export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
-export {};

package/lib/browser/functions/get-builder-search-params/index.js

@@ -1,13 +1,7 @@
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { isBrowser } from '../is-browser.js';
 const BUILDER_SEARCHPARAMS_PREFIX = 'builder.';
 const BUILDER_OPTIONS_PREFIX = 'options.';
-export const convertSearchParamsToQueryObject = (searchParams) => {
-    const options = {};
-    searchParams.forEach((value, key) => {
-        options[key] = value;
-    });
-    return options;
-};
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -35,4 +29,3 @@ export const getBuilderSearchParamsFromWindow = () => {
     const searchParams = new URLSearchParams(window.location.search);
     return getBuilderSearchParams(searchParams);
 };
-export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;

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

@@ -1,6 +1,7 @@
 import { flatten } from '../../helpers/flatten.js';
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { DEFAULT_API_VERSION } from '../../types/api-version.js';
-import { getBuilderSearchParamsFromWindow, normalizeSearchParams } from '../get-builder-search-params/index.js';
+import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/index.js';
 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 } = options;

package/lib/browser/functions/is-editing.d.ts

@@ -1 +1,2 @@
-export declare function isEditing(): boolean;
+import { type Search } from '../helpers/search/search.js';
+export declare function isEditing(search?: Search): boolean;

package/lib/browser/functions/is-editing.js

@@ -1,5 +1,6 @@
 import { TARGET } from '../constants/target.js';
+import { getSearchString } from '../helpers/search/search.js';
 import { isIframe } from './is-iframe.js';
-export function isEditing() {
-    return isIframe() && (TARGET === 'reactNative' || window.location.search.indexOf('builder.frameEditing=') !== -1);
+export function isEditing(search) {
+    return isIframe() && (TARGET === 'reactNative' || getSearchString(search || window.location.search).indexOf('builder.frameEditing=') !== -1);
 }

package/lib/browser/functions/is-previewing.d.ts

@@ -1 +1,2 @@
-export declare function isPreviewing(): boolean;
+import type { Search } from '../helpers/search/search.js';
+export declare function isPreviewing(search?: Search): boolean;

package/lib/browser/functions/is-previewing.js

@@ -1,11 +1,13 @@
+import { getSearchString } from '../helpers/search/search.js';
 import { isBrowser } from './is-browser.js';
 import { isEditing } from './is-editing.js';
-export function isPreviewing() {
+export function isPreviewing(search) {
     if (!isBrowser()) {
         return false;
     }
-    if (isEditing()) {
+    const normalizedSearch = getSearchString(search || window.location.search);
+    if (isEditing(normalizedSearch)) {
         return false;
     }
-    return Boolean(location.search.indexOf('builder.preview=') !== -1);
+    return Boolean(normalizedSearch.indexOf('builder.preview=') !== -1);
 }

package/lib/browser/helpers/search/search.d.ts

@@ -0,0 +1,5 @@
+export type QueryObject = Record<string, string | string[]>;
+export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
+export type Search = URLSearchParams | string | QueryObject;
+export declare const getSearchString: (search: Search) => string;

package/lib/browser/helpers/search/search.js

@@ -0,0 +1,17 @@
+export const convertSearchParamsToQueryObject = (searchParams) => {
+    const options = {};
+    searchParams.forEach((value, key) => {
+        options[key] = value;
+    });
+    return options;
+};
+export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;
+export const getSearchString = (search) => {
+    if (typeof search === 'string') {
+        return search;
+    }
+    else if (search instanceof URLSearchParams) {
+        return search.toString();
+    }
+    return new URLSearchParams(search).toString();
+};

package/lib/browser/index.d.ts

@@ -1,7 +1,10 @@
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

package/lib/browser/index.js

@@ -1,10 +1,13 @@
 // ignore prettier formatting for this file because the order of exports is meaningful
 // prettier-ignore
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 // prettier-ignore
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.4";
+export declare const SDK_VERSION = "1.0.6";

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

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.4";
+export const SDK_VERSION = "1.0.6";

package/lib/edge/functions/get-builder-search-params/index.d.ts

@@ -1,5 +1,4 @@
-type QueryObject = Record<string, string | string[]>;
-export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+import type { QueryObject } from '../../helpers/search/search.js';
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -8,5 +7,3 @@ export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchP
  */
 export declare const getBuilderSearchParams: (_options: QueryObject | URLSearchParams | undefined) => QueryObject;
 export declare const getBuilderSearchParamsFromWindow: () => QueryObject;
-export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
-export {};

package/lib/edge/functions/get-builder-search-params/index.js

@@ -1,13 +1,7 @@
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { isBrowser } from '../is-browser.js';
 const BUILDER_SEARCHPARAMS_PREFIX = 'builder.';
 const BUILDER_OPTIONS_PREFIX = 'options.';
-export const convertSearchParamsToQueryObject = (searchParams) => {
-    const options = {};
-    searchParams.forEach((value, key) => {
-        options[key] = value;
-    });
-    return options;
-};
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -35,4 +29,3 @@ export const getBuilderSearchParamsFromWindow = () => {
     const searchParams = new URLSearchParams(window.location.search);
     return getBuilderSearchParams(searchParams);
 };
-export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;

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

@@ -1,6 +1,7 @@
 import { flatten } from '../../helpers/flatten.js';
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { DEFAULT_API_VERSION } from '../../types/api-version.js';
-import { getBuilderSearchParamsFromWindow, normalizeSearchParams } from '../get-builder-search-params/index.js';
+import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/index.js';
 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 } = options;

package/lib/edge/functions/is-editing.d.ts

@@ -1 +1,2 @@
-export declare function isEditing(): boolean;
+import { type Search } from '../helpers/search/search.js';
+export declare function isEditing(search?: Search): boolean;

package/lib/edge/functions/is-editing.js

@@ -1,5 +1,6 @@
 import { TARGET } from '../constants/target.js';
+import { getSearchString } from '../helpers/search/search.js';
 import { isIframe } from './is-iframe.js';
-export function isEditing() {
-    return isIframe() && (TARGET === 'reactNative' || window.location.search.indexOf('builder.frameEditing=') !== -1);
+export function isEditing(search) {
+    return isIframe() && (TARGET === 'reactNative' || getSearchString(search || window.location.search).indexOf('builder.frameEditing=') !== -1);
 }

package/lib/edge/functions/is-previewing.d.ts

@@ -1 +1,2 @@
-export declare function isPreviewing(): boolean;
+import type { Search } from '../helpers/search/search.js';
+export declare function isPreviewing(search?: Search): boolean;

package/lib/edge/functions/is-previewing.js

@@ -1,11 +1,13 @@
+import { getSearchString } from '../helpers/search/search.js';
 import { isBrowser } from './is-browser.js';
 import { isEditing } from './is-editing.js';
-export function isPreviewing() {
+export function isPreviewing(search) {
     if (!isBrowser()) {
         return false;
     }
-    if (isEditing()) {
+    const normalizedSearch = getSearchString(search || window.location.search);
+    if (isEditing(normalizedSearch)) {
         return false;
     }
-    return Boolean(location.search.indexOf('builder.preview=') !== -1);
+    return Boolean(normalizedSearch.indexOf('builder.preview=') !== -1);
 }

package/lib/edge/helpers/search/search.d.ts

@@ -0,0 +1,5 @@
+export type QueryObject = Record<string, string | string[]>;
+export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
+export type Search = URLSearchParams | string | QueryObject;
+export declare const getSearchString: (search: Search) => string;

package/lib/edge/helpers/search/search.js

@@ -0,0 +1,17 @@
+export const convertSearchParamsToQueryObject = (searchParams) => {
+    const options = {};
+    searchParams.forEach((value, key) => {
+        options[key] = value;
+    });
+    return options;
+};
+export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;
+export const getSearchString = (search) => {
+    if (typeof search === 'string') {
+        return search;
+    }
+    else if (search instanceof URLSearchParams) {
+        return search.toString();
+    }
+    return new URLSearchParams(search).toString();
+};

package/lib/edge/index.d.ts

@@ -1,7 +1,10 @@
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

package/lib/edge/index.js

@@ -1,10 +1,13 @@
 // ignore prettier formatting for this file because the order of exports is meaningful
 // prettier-ignore
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 // prettier-ignore
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.4";
+export declare const SDK_VERSION = "1.0.6";

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

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.4";
+export const SDK_VERSION = "1.0.6";

package/lib/node/functions/get-builder-search-params/index.d.ts

@@ -1,5 +1,4 @@
-type QueryObject = Record<string, string | string[]>;
-export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+import type { QueryObject } from '../../helpers/search/search.js';
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -8,5 +7,3 @@ export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchP
  */
 export declare const getBuilderSearchParams: (_options: QueryObject | URLSearchParams | undefined) => QueryObject;
 export declare const getBuilderSearchParamsFromWindow: () => QueryObject;
-export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
-export {};

package/lib/node/functions/get-builder-search-params/index.js

@@ -1,13 +1,7 @@
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { isBrowser } from '../is-browser.js';
 const BUILDER_SEARCHPARAMS_PREFIX = 'builder.';
 const BUILDER_OPTIONS_PREFIX = 'options.';
-export const convertSearchParamsToQueryObject = (searchParams) => {
-    const options = {};
-    searchParams.forEach((value, key) => {
-        options[key] = value;
-    });
-    return options;
-};
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
  * relevant to the Builder SDK.
@@ -35,4 +29,3 @@ export const getBuilderSearchParamsFromWindow = () => {
     const searchParams = new URLSearchParams(window.location.search);
     return getBuilderSearchParams(searchParams);
 };
-export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;

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

@@ -1,6 +1,7 @@
 import { flatten } from '../../helpers/flatten.js';
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { DEFAULT_API_VERSION } from '../../types/api-version.js';
-import { getBuilderSearchParamsFromWindow, normalizeSearchParams } from '../get-builder-search-params/index.js';
+import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/index.js';
 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 } = options;

package/lib/node/functions/is-editing.d.ts

@@ -1 +1,2 @@
-export declare function isEditing(): boolean;
+import { type Search } from '../helpers/search/search.js';
+export declare function isEditing(search?: Search): boolean;

package/lib/node/functions/is-editing.js

@@ -1,5 +1,6 @@
 import { TARGET } from '../constants/target.js';
+import { getSearchString } from '../helpers/search/search.js';
 import { isIframe } from './is-iframe.js';
-export function isEditing() {
-    return isIframe() && (TARGET === 'reactNative' || window.location.search.indexOf('builder.frameEditing=') !== -1);
+export function isEditing(search) {
+    return isIframe() && (TARGET === 'reactNative' || getSearchString(search || window.location.search).indexOf('builder.frameEditing=') !== -1);
 }

package/lib/node/functions/is-previewing.d.ts

@@ -1 +1,2 @@
-export declare function isPreviewing(): boolean;
+import type { Search } from '../helpers/search/search.js';
+export declare function isPreviewing(search?: Search): boolean;

package/lib/node/functions/is-previewing.js

@@ -1,11 +1,13 @@
+import { getSearchString } from '../helpers/search/search.js';
 import { isBrowser } from './is-browser.js';
 import { isEditing } from './is-editing.js';
-export function isPreviewing() {
+export function isPreviewing(search) {
     if (!isBrowser()) {
         return false;
     }
-    if (isEditing()) {
+    const normalizedSearch = getSearchString(search || window.location.search);
+    if (isEditing(normalizedSearch)) {
         return false;
     }
-    return Boolean(location.search.indexOf('builder.preview=') !== -1);
+    return Boolean(normalizedSearch.indexOf('builder.preview=') !== -1);
 }

package/lib/node/helpers/search/search.d.ts

@@ -0,0 +1,5 @@
+export type QueryObject = Record<string, string | string[]>;
+export declare const convertSearchParamsToQueryObject: (searchParams: URLSearchParams) => QueryObject;
+export declare const normalizeSearchParams: (searchParams: QueryObject | URLSearchParams) => QueryObject;
+export type Search = URLSearchParams | string | QueryObject;
+export declare const getSearchString: (search: Search) => string;

package/lib/node/helpers/search/search.js

@@ -0,0 +1,17 @@
+export const convertSearchParamsToQueryObject = (searchParams) => {
+    const options = {};
+    searchParams.forEach((value, key) => {
+        options[key] = value;
+    });
+    return options;
+};
+export const normalizeSearchParams = (searchParams) => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;
+export const getSearchString = (search) => {
+    if (typeof search === 'string') {
+        return search;
+    }
+    else if (search instanceof URLSearchParams) {
+        return search.toString();
+    }
+    return new URLSearchParams(search).toString();
+};

package/lib/node/index.d.ts

@@ -1,7 +1,10 @@
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

package/lib/node/index.js

@@ -1,10 +1,13 @@
 // ignore prettier formatting for this file because the order of exports is meaningful
 // prettier-ignore
 export * from './index-helpers/top-of-file.js';
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 // prettier-ignore
 export * from './index-helpers/blocks-exports.js';
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js';

package/package.json

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

package/src/constants/sdk-version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.4"
+export const SDK_VERSION = "1.0.6"

package/src/functions/get-builder-search-params/index.ts

@@ -1,14 +1,8 @@
+import type { QueryObject } from '../../helpers/search/search.js';
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { isBrowser } from '../is-browser.js';
 const BUILDER_SEARCHPARAMS_PREFIX = 'builder.';
 const BUILDER_OPTIONS_PREFIX = 'options.';
-type QueryObject = Record<string, string | string[]>;
-export const convertSearchParamsToQueryObject = (searchParams: URLSearchParams): QueryObject => {
-  const options: Record<string, string> = {};
-  searchParams.forEach((value, key) => {
-    options[key] = value;
-  });
-  return options;
-};
 
 /**
  * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
@@ -36,5 +30,4 @@ export const getBuilderSearchParamsFromWindow = () => {
   }
   const searchParams = new URLSearchParams(window.location.search);
   return getBuilderSearchParams(searchParams);
-};
-export const normalizeSearchParams = (searchParams: QueryObject | URLSearchParams): QueryObject => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams
+}

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

@@ -1,6 +1,7 @@
 import { flatten } from '../../helpers/flatten.js';
+import { normalizeSearchParams } from '../../helpers/search/search.js';
 import { DEFAULT_API_VERSION } from '../../types/api-version.js';
-import { getBuilderSearchParamsFromWindow, normalizeSearchParams } from '../get-builder-search-params/index.js';
+import { getBuilderSearchParamsFromWindow } from '../get-builder-search-params/index.js';
 import type { GetContentOptions } from './types.js';
 const isPositiveNumber = (thing: unknown) => typeof thing === 'number' && !isNaN(thing) && thing >= 0;
 export const generateContentUrl = (options: GetContentOptions): URL => {

package/src/functions/is-editing.ts

@@ -1,5 +1,6 @@
 import { TARGET } from '../constants/target.js';
+import { getSearchString, type Search } from '../helpers/search/search.js';
 import { isIframe } from './is-iframe.js';
-export function isEditing(): boolean {
-  return isIframe() && (TARGET === 'reactNative' || window.location.search.indexOf('builder.frameEditing=') !== -1);
+export function isEditing(search?: Search) {
+  return isIframe() && (TARGET === 'reactNative' || getSearchString(search || window.location.search).indexOf('builder.frameEditing=') !== -1);
 }

package/src/functions/is-previewing.ts

@@ -1,11 +1,14 @@
+import type { Search } from '../helpers/search/search.js';
+import { getSearchString } from '../helpers/search/search.js';
 import { isBrowser } from './is-browser.js';
 import { isEditing } from './is-editing.js';
-export function isPreviewing() {
+export function isPreviewing(search?: Search) {
   if (!isBrowser()) {
     return false;
   }
-  if (isEditing()) {
+  const normalizedSearch = getSearchString(search || window.location.search);
+  if (isEditing(normalizedSearch)) {
     return false;
   }
-  return Boolean(location.search.indexOf('builder.preview=') !== -1);
+  return Boolean(normalizedSearch.indexOf('builder.preview=') !== -1);
 }

package/src/helpers/search/search.ts

@@ -0,0 +1,18 @@
+export type QueryObject = Record<string, string | string[]>;
+export const convertSearchParamsToQueryObject = (searchParams: URLSearchParams): QueryObject => {
+  const options: Record<string, string> = {};
+  searchParams.forEach((value, key) => {
+    options[key] = value;
+  });
+  return options;
+};
+export const normalizeSearchParams = (searchParams: QueryObject | URLSearchParams): QueryObject => searchParams instanceof URLSearchParams ? convertSearchParamsToQueryObject(searchParams) : searchParams;
+export type Search = URLSearchParams | string | QueryObject;
+export const getSearchString = (search: Search): string => {
+  if (typeof search === 'string') {
+    return search;
+  } else if (search instanceof URLSearchParams) {
+    return search.toString();
+  }
+  return new URLSearchParams((search as any)).toString();
+}

package/src/index.ts

@@ -1,11 +1,15 @@
 // ignore prettier formatting for this file because the order of exports is meaningful
 // prettier-ignore
 export * from './index-helpers/top-of-file.js';
+
+/**
+ * In the React SDK, this file is marked with `use client`.
+ */
 // prettier-ignore
 export * from './index-helpers/blocks-exports.js';
 
 /**
- * We have a separate entry point to the SDKs that guarantees no components are being imported. This is useful
- * for React SDK, which would break in the NextJS App directory because the component imports have `use client` in them.
+ * In the React SDK, this file is not marked with `use client`, to allow
+ * NextJS App Directory to use the SDK helper functions without issues.
  */
 export * from './server-index.js'