@uniformdev/canvas-contentful 17.7.1-alpha.34 → 18.0.0

package/LICENSE.txt

@@ -1,2 +1,2 @@
-© 2022 Uniform Systems, Inc. All Rights Reserved.
+© 2023 Uniform Systems, Inc. All Rights Reserved.
 See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/dist/index.d.ts

@@ -28,7 +28,7 @@ declare class ContentfulClientList {
 }
 
 /** The default shape of the Contentful entry. Note that this can change if the query is altered. */
-declare type ContentfulEntryResult<TFields> = {
+type ContentfulEntryResult<TFields> = {
     /**
      * The shape of the `fields` that the Contentful REST API is expected to return for this entry
      * https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/entries/entry
@@ -40,14 +40,14 @@ declare type ContentfulEntryResult<TFields> = {
     sys: Partial<Pick<Sys, 'id' | 'type'>>;
 };
 
-declare type EnhancerValue = ContentfulEntryResult<unknown> | ContentfulEntryResult<unknown>[] | null;
+type EnhancerValue = ContentfulEntryResult<unknown> | ContentfulEntryResult<unknown>[] | null;
 declare const contentfulRichTextToHtmlEnhancer: ComponentParameterEnhancerFunction<EnhancerValue>;
 
-declare type EntrySelectorParameterValue = {
+type EntrySelectorParameterValue = {
     entryId: string;
     source?: string;
 } | string | null | undefined;
-declare type CreateContentfulQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
+type CreateContentfulQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
     /** Canvas parameter name being queried for. Not defined if using batching. */
     parameterName?: string;
     /** Canvas parameter value being fetched. Not defined if using batching. */
@@ -60,8 +60,8 @@ declare type CreateContentfulQueryOptions<TContext extends EnhancerContext = Enh
     context: TContext;
 };
 /** The default shape of the result value of the Contentful enhancer. Note that this can change if the query is altered. */
-declare type ContentfulEnhancerResult<TFields> = ContentfulEntryResult<TFields> | null;
-declare type CreateContentfulEnhancerOptions = {
+type ContentfulEnhancerResult<TFields> = ContentfulEntryResult<TFields> | null;
+type CreateContentfulEnhancerOptions = {
     /** Either a list of Contentful clients for use with multi-space/environment-enabled Canvas projects.
      * Or a single Contentful client for use with legacy Canvas data.*/
     client: ContentfulClientApi | ContentfulClientList;
@@ -78,11 +78,11 @@ declare type CreateContentfulEnhancerOptions = {
 declare const CANVAS_CONTENTFUL_PARAMETER_TYPES: readonly string[];
 declare function createContentfulEnhancer({ client, previewClient, createQuery, useBatching, limitPolicy, }: CreateContentfulEnhancerOptions): ComponentParameterEnhancer<EntrySelectorParameterValue, ContentfulEnhancerResult<unknown>>;
 
-declare type ContentfulMultiEntryParameterValue = {
+type ContentfulMultiEntryParameterValue = {
     entries: string[];
     source: string;
 } | null | undefined;
-declare type CreateContentfulMultiEntryQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
+type CreateContentfulMultiEntryQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
     /** Canvas parameter name being queried for */
     parameterName: string;
     /** Canvas parameter value being fetched */
@@ -95,8 +95,8 @@ declare type CreateContentfulMultiEntryQueryOptions<TContext extends EnhancerCon
     context: TContext;
 };
 /** The default shape of the result value of the Contentful Multi Entry enhancer. Note that this can change if the query is altered. */
-declare type ContentfulMultiEntryEnhancerResult<TFields> = ContentfulEntryResult<TFields>[] | null;
-declare type CreateContentfulMultiEntryEnhancerOptions = {
+type ContentfulMultiEntryEnhancerResult<TFields> = ContentfulEntryResult<TFields>[] | null;
+type CreateContentfulMultiEntryEnhancerOptions = {
     /** Either a list of Contentful clients for use with multi-space/environment-enabled Canvas projects. */
     clients: ContentfulClientList;
     /** Creates the Contentful client's query params for specific parameters. See https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters */
@@ -107,7 +107,7 @@ declare const CANVAS_CONTENTFUL_MULTI_PARAMETER_TYPES: readonly string[];
 declare function createContentfulMultiEnhancer({ clients, createQuery, limitPolicy, }: CreateContentfulMultiEntryEnhancerOptions): ComponentParameterEnhancer<ContentfulMultiEntryParameterValue, ContentfulMultiEntryEnhancerResult<unknown>>;
 
 declare const CANVAS_CONTENTFUL_QUERY_PARAMETER_TYPES: readonly string[];
-declare type ContentfulQueryParameterValue = {
+type ContentfulQueryParameterValue = {
     source: string;
     contentType: string;
     count: number;
@@ -115,8 +115,8 @@ declare type ContentfulQueryParameterValue = {
     sortOrder?: 'asc' | 'desc';
 } | null | undefined;
 /** The default shape of the result value of the Contentful Query enhancer. Note that this can change if the query is altered. */
-declare type ContentfulQueryEnhancerResult<TFields> = ContentfulEntryResult<TFields>[] | null;
-declare type CreateContentfulQueryApiQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
+type ContentfulQueryEnhancerResult<TFields> = ContentfulEntryResult<TFields>[] | null;
+type CreateContentfulQueryApiQueryOptions<TContext extends EnhancerContext = EnhancerContext> = {
     /** Canvas parameter name being queried for */
     parameterName: string;
     /** Canvas parameter value being fetched */
@@ -128,7 +128,7 @@ declare type CreateContentfulQueryApiQueryOptions<TContext extends EnhancerConte
     /** The enhancer context provided to the enhance() function */
     context: TContext;
 };
-declare type CreateContentfulQueryEnhancerOptions = {
+type CreateContentfulQueryEnhancerOptions = {
     /** Either a list of Contentful clients for use with multi-space/environment-enabled Canvas projects. */
     clients: ContentfulClientList;
     /** Creates the Contentful client's query params for specific parameters. See https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters */

package/dist/index.esm.js

@@ -1 +1,499 @@
-var x=class{constructor(t){this._clients={},Array.isArray(t)?t.forEach(n=>this.addClient(n)):t&&this.addClient(t)}addClient({source:t="default",client:n,previewClient:o}){if(this._clients[t])throw new Error(`The source ${t} is always registered`);if(!n)throw new Error("You must provide a Contentful client for the ContentfulClientList");this._clients[t]={client:n,previewClient:o||n}}getClient({source:t="default",isPreviewClient:n}){let o=this._clients[t];if(!!o)return n?o.previewClient:o.client}};import{documentToHtmlString as N}from"@contentful/rich-text-html-renderer";var W=({parameter:e})=>{let t=e.value;if(!t)return t;if(!I(t))return L(t),t;for(let n of t)L(n);return t};function L(e){var t;typeof(e==null?void 0:e.fields)=="object"&&Object.entries((t=e.fields)!=null?t:{}).forEach(([n,o])=>{typeof o=="object"&&"nodeType"in o&&o.nodeType==="document"&&(e.fields[n]=N(o))})}function I(e){return Array.isArray(e)}import{createBatchEnhancer as k,UniqueBatchEntries as S}from"@uniformdev/canvas";import{createLimitPolicy as Q}from"@uniformdev/canvas";var v=Q({throttle:{limit:55,interval:1e3}});function P(e){return typeof e=="string"?e:typeof e=="object"&&e&&"error"in e?e.error:e instanceof Error?e.toString():JSON.stringify(e,null,2)}function $(e,t){if(!!e)return`${t==="desc"?"-":""}${e}`}function A({clients:e,parameterValue:t,parameterName:n,component:o,context:E}){let{source:i="default"}=t,l=e.getClient({source:i,isPreviewClient:E.preview});if(!l)throw new Error(`No Contentful client could be resolved for source key '${i}' referenced in parameter '${n} in component '${o.type}'. Ensure that the 'clients' property you are passing to the enhancer has a client instance registered for the source key.`);return l}var T={select:"fields",include:1},_=Object.freeze(["contentfulEntry"]);function j(e){return e instanceof x}function fe({client:e,previewClient:t,createQuery:n,useBatching:o,limitPolicy:E}){if(!e)throw new Error("No Contentful clients were provided to the enhancer. You must provide at least one client via the `client` or `clients` property.");let l=(()=>{if(j(e))return e;let s=new x;return s.addClient({client:e,previewClient:t}),s})(),y=E||v;return o?k({handleBatch:async s=>{var f;let u=s.reduce((a,r)=>{let{parameter:C,parameterName:c,component:d,context:m}=r.args,h=C.value;if(!O(h))return a;let g=R({parameterValue:h,parameterName:c,clients:l,component:d,context:m}),p="";if(w(h))p="legacy-group";else{let{source:M="default"}=h;p=M}return a[p]&&Array.isArray(a[p].tasks)?a[p].tasks.push(r):a[p]={client:g,tasks:[r]},a},{});try{console.time("fetch all entries");for await(let[a,r]of Object.entries(u)){let{context:C,component:c}=r.tasks[0].args,d=(f=n==null?void 0:n({component:c,defaultQuery:{...T},context:C}))!=null?f:T,m=new S(r.tasks,g=>w(g.parameter.value)?g.parameter.value:g.parameter.value.entryId),h=Object.keys(m.groups);console.time(`fetch entries ${a}`);try{(await r.client.getEntries({"sys.id[in]":h.join(","),limit:h.length,...d})).items.forEach(p=>{m.resolveKey(p.sys.id,p)}),m.resolveRemaining(null)}finally{console.timeEnd(`fetch entries ${a}`)}}console.timeEnd("fetch all entries")}catch(a){let r=P(a),C=new Error(`Failed loading Contentful entries batch (${s.length}) ${r}`);s.forEach(c=>c.reject(C))}},shouldQueue:({parameter:s})=>V(s),limitPolicy:y}):{enhanceOne:async function({parameter:u,parameterName:f,component:a,context:r}){var C,c;if(V(u)){if(!O(u.value))return null;let d=R({clients:l,parameterName:f,parameterValue:u.value,component:a,context:r}),m=w(u.value)?u.value:u.value.entryId,h=(C=n==null?void 0:n({parameter:u,parameterName:f,component:a,defaultQuery:{...T},context:r}))!=null?C:T;try{return console.time(`fetch entry ${m}`),await d.getEntry(m,h)}catch(g){let p=P(g);throw w(u.value)?new Error(`Failed loading Contentful entry '${u.value}' referenced in parameter '${f}': ${p}`):new Error(`Failed loading Contentful entry '${m}' from source '${(c=u.value.source)!=null?c:"default"}' referenced in parameter '${f}': ${p}`)}finally{console.timeEnd(`fetch entry ${m}`)}}},limitPolicy:y}}function V(e){var t;return e.type===_[0]&&(((t=e.value)==null?void 0:t.entryId)||typeof e.value=="string")}function w(e){return typeof e=="string"}function O(e){return!(!e||!w(e)&&!e.entryId)}function R({clients:e,parameterValue:t,parameterName:n,component:o,context:E}){if(w(t)){let y=e.getClient({isPreviewClient:E.preview});if(!y)throw new Error(`Parameter '${n}' in component '${o.type}' has a value '${t}' that is not compatible with multi-space/environment usage. If you wish to use multiple spaces/environments, you must convert your Canvas component parameters to the multi-space/environment compatible version. Otherwise, you can continue to use your parameters as-is, but must specify one of the clients provided to the Contentful enhancer as the 'default' client by registering it without specifying a source key.`);return y}let{source:i="default"}=t,l=e.getClient({source:i,isPreviewClient:E.preview});if(!l)throw new Error(`No Contentful client could be resolved for source key '${i}' referenced in parameter '${n} in component '${o.type}'. Ensure that the 'clients' property you are passing to the enhancer has a client instance registered for the source key.`);return l}var b={select:"fields",include:1},Y=Object.freeze(["contentfulMultiEntry"]);function pe({clients:e,createQuery:t,limitPolicy:n}){if(!e)throw new Error("No Contentful clients were provided to the enhancer. You must provide at least one client via the ContentfulClientList.");return{enhanceOne:async function({parameter:i,parameterName:l,component:y,context:s}){var u,f;if(B(i)){if(!U(i.value))return null;let a=A({clients:e,parameterName:l,parameterValue:i.value,component:y,context:s}),r=i.value.entries,C=(u=t==null?void 0:t({parameter:i,parameterName:l,component:y,defaultQuery:{...b},context:s}))!=null?u:b;try{console.time(`fetch entries ${r.join()}`);let c=await a.getEntries({"sys.id[in]":r.join(),limit:r.length,...C});return q(c.items,r)}catch(c){let d=P(c);throw new Error(`Failed loading Contentful entries '${r.join()}' from source '${(f=i.value.source)!=null?f:"default"}' referenced in parameter '${l}': ${d}`)}finally{console.timeEnd(`fetch entries ${r.join()}`)}}},limitPolicy:n||v}}function B(e){return e.type===Y[0]}function U(e){var t;return!(!e||!((t=e.entries)!=null&&t.length))}function q(e,t){var o;if(!e.length||!((o=e[0].sys)!=null&&o.id))return e;let n=[];for(let E of t){let i=e.find(l=>l.sys.id===E);i&&n.push(i)}return n}var D=Object.freeze(["contentfulQuery"]),F={select:"fields",include:1};function he({clients:e,createQuery:t,limitPolicy:n}){if(!e)throw new Error("No Contentful clients were provided to the enhancer. You must provide at least one client via the ContentfulClientList.");return{enhanceOne:async function({parameter:i,parameterName:l,component:y,context:s}){var u,f;if(z(i)){if(!K(i.value))return null;let a=A({clients:e,parameterName:l,parameterValue:i.value,component:y,context:s}),r=i.value,C=G(r.count),c=(u=t==null?void 0:t({parameter:i,parameterName:l,component:y,defaultQuery:{...F},context:s}))!=null?u:F,d=`fetch query: ${C} entries with '${r.contentType}' content type`;try{return console.time(d),(await a.getEntries({content_type:r.contentType,order:$(r.sortBy,r.sortOrder),limit:C,...c})).items}catch(m){let h=P(m);throw new Error(`Failed loading Contentful entries with '${r.contentType}' content type from source '${(f=r.source)!=null?f:"default"}' referenced in parameter '${l}': ${h}`)}finally{console.timeEnd(d)}}},limitPolicy:n||v}}function z(e){return e.type===D[0]}function K(e){return!(!e||!e.source||!e.contentType||typeof e.count=="undefined")}function G(e){return!e||e<1?1:e>1e3?1e3:e}export{Y as CANVAS_CONTENTFUL_MULTI_PARAMETER_TYPES,_ as CANVAS_CONTENTFUL_PARAMETER_TYPES,D as CANVAS_CONTENTFUL_QUERY_PARAMETER_TYPES,x as ContentfulClientList,W as contentfulRichTextToHtmlEnhancer,fe as createContentfulEnhancer,pe as createContentfulMultiEnhancer,he as createContentfulQueryEnhancer};
+// src/ContentfulClientList.ts
+var ContentfulClientList = class {
+  constructor(clients) {
+    this._clients = {};
+    if (Array.isArray(clients)) {
+      clients.forEach((client) => this.addClient(client));
+    } else if (clients) {
+      this.addClient(clients);
+    }
+  }
+  addClient({ source = "default", client, previewClient }) {
+    if (this._clients[source]) {
+      throw new Error(`The source ${source} is always registered`);
+    }
+    if (!client) {
+      throw new Error("You must provide a Contentful client for the ContentfulClientList");
+    }
+    this._clients[source] = {
+      client,
+      previewClient: previewClient || client
+    };
+  }
+  getClient({
+    source = "default",
+    isPreviewClient
+  }) {
+    const found = this._clients[source];
+    if (!found) {
+      return void 0;
+    }
+    return isPreviewClient ? found.previewClient : found.client;
+  }
+};
+
+// src/contentfulRichTextToHtmlEnhancer.ts
+import { documentToHtmlString } from "@contentful/rich-text-html-renderer";
+var contentfulRichTextToHtmlEnhancer = ({
+  parameter
+}) => {
+  const value = parameter.value;
+  if (!value) {
+    return value;
+  }
+  if (!isArrayValue(value)) {
+    updateEntryFields(value);
+    return value;
+  }
+  for (const entry of value) {
+    updateEntryFields(entry);
+  }
+  return value;
+};
+function updateEntryFields(entry) {
+  var _a;
+  if (typeof (entry == null ? void 0 : entry.fields) !== "object") {
+    return;
+  }
+  Object.entries((_a = entry.fields) != null ? _a : {}).forEach(([key, value]) => {
+    if (typeof value === "object" && "nodeType" in value && value.nodeType === "document") {
+      entry.fields[key] = documentToHtmlString(value);
+    }
+  });
+}
+function isArrayValue(value) {
+  return Array.isArray(value);
+}
+
+// src/createContentfulEnhancer.ts
+import {
+  createBatchEnhancer,
+  UniqueBatchEntries
+} from "@uniformdev/canvas";
+
+// src/utils.ts
+import { createLimitPolicy } from "@uniformdev/canvas";
+var defaultContentfulLimitPolicy = createLimitPolicy({
+  throttle: {
+    limit: 55,
+    interval: 1e3
+  }
+});
+function getErrorMessageFromContentfulError(e) {
+  if (typeof e === "string") {
+    return e;
+  }
+  if (typeof e === "object" && e && "error" in e) {
+    return e.error;
+  }
+  if (e instanceof Error) {
+    return e.toString();
+  }
+  return JSON.stringify(e, null, 2);
+}
+function toContentfulOrder(sortBy, sortOrder) {
+  if (!sortBy) {
+    return void 0;
+  }
+  return `${sortOrder === "desc" ? "-" : ""}${sortBy}`;
+}
+function resolveClientForParameter({
+  clients,
+  parameterValue,
+  parameterName,
+  component,
+  context
+}) {
+  const { source = "default" } = parameterValue;
+  const client = clients.getClient({
+    source,
+    isPreviewClient: context.preview
+  });
+  if (!client) {
+    throw new Error(
+      `No Contentful client could be resolved for source key '${source}' referenced in parameter '${parameterName} in component '${component.type}'. Ensure that the 'clients' property you are passing to the enhancer has a client instance registered for the source key.`
+    );
+  }
+  return client;
+}
+
+// src/createContentfulEnhancer.ts
+var defaultQuery = {
+  select: "fields",
+  include: 1
+};
+var CANVAS_CONTENTFUL_PARAMETER_TYPES = Object.freeze(["contentfulEntry"]);
+function isClientList(client) {
+  return client instanceof ContentfulClientList;
+}
+function createContentfulEnhancer({
+  client,
+  previewClient,
+  createQuery,
+  useBatching,
+  limitPolicy
+}) {
+  if (!client) {
+    throw new Error(
+      "No Contentful clients were provided to the enhancer. You must provide at least one client via the `client` or `clients` property."
+    );
+  }
+  const resolveClients = () => {
+    if (isClientList(client)) {
+      return client;
+    }
+    const clientList = new ContentfulClientList();
+    clientList.addClient({
+      client,
+      previewClient
+    });
+    return clientList;
+  };
+  const clients = resolveClients();
+  const finalLimitPolicy = limitPolicy || defaultContentfulLimitPolicy;
+  if (useBatching) {
+    return createBatchEnhancer({
+      handleBatch: async (queuedTasks) => {
+        var _a;
+        const taskGroups = queuedTasks.reduce((result, queuedTask) => {
+          const { parameter, parameterName, component, context } = queuedTask.args;
+          const paramValue = parameter.value;
+          if (!isParameterValueDefined(paramValue)) {
+            return result;
+          }
+          const client2 = resolveClientForParameter2({
+            parameterValue: paramValue,
+            parameterName,
+            clients,
+            component,
+            context
+          });
+          let groupKey = "";
+          if (isLegacyValue(paramValue)) {
+            groupKey = "legacy-group";
+          } else {
+            const { source = "default" } = paramValue;
+            groupKey = source;
+          }
+          if (result[groupKey] && Array.isArray(result[groupKey].tasks)) {
+            result[groupKey].tasks.push(queuedTask);
+          } else {
+            result[groupKey] = {
+              client: client2,
+              tasks: [queuedTask]
+            };
+          }
+          return result;
+        }, {});
+        try {
+          console.time("fetch all entries");
+          for await (const [environmentKey, taskGroup] of Object.entries(taskGroups)) {
+            const { context, component } = taskGroup.tasks[0].args;
+            const query = (_a = createQuery == null ? void 0 : createQuery({
+              component,
+              defaultQuery: { ...defaultQuery },
+              context
+            })) != null ? _a : defaultQuery;
+            const uniqueBatchEntries = new UniqueBatchEntries(
+              taskGroup.tasks,
+              (task) => isLegacyValue(task.parameter.value) ? task.parameter.value : task.parameter.value.entryId
+            );
+            const idsToResolve = Object.keys(uniqueBatchEntries.groups);
+            console.time(`fetch entries ${environmentKey}`);
+            try {
+              const entries = await taskGroup.client.getEntries({
+                "sys.id[in]": idsToResolve.join(","),
+                limit: idsToResolve.length,
+                ...query
+              });
+              entries.items.forEach((entry) => {
+                uniqueBatchEntries.resolveKey(entry.sys.id, entry);
+              });
+              uniqueBatchEntries.resolveRemaining(null);
+            } finally {
+              console.timeEnd(`fetch entries ${environmentKey}`);
+            }
+          }
+          console.timeEnd("fetch all entries");
+        } catch (e) {
+          const message = getErrorMessageFromContentfulError(e);
+          const error = new Error(
+            `Failed loading Contentful entries batch (${queuedTasks.length}) ${message}`
+          );
+          queuedTasks.forEach((task) => task.reject(error));
+        }
+      },
+      shouldQueue: ({ parameter }) => parameterIsContentfulEntrySelector(parameter),
+      limitPolicy: finalLimitPolicy
+    });
+  } else {
+    return {
+      enhanceOne: async function contentfulEnhancer({ parameter, parameterName, component, context }) {
+        var _a, _b;
+        if (parameterIsContentfulEntrySelector(parameter)) {
+          if (!isParameterValueDefined(parameter.value)) {
+            return null;
+          }
+          const client2 = resolveClientForParameter2({
+            clients,
+            parameterName,
+            parameterValue: parameter.value,
+            component,
+            context
+          });
+          const entryId = isLegacyValue(parameter.value) ? parameter.value : parameter.value.entryId;
+          const query = (_a = createQuery == null ? void 0 : createQuery({
+            parameter,
+            parameterName,
+            component,
+            defaultQuery: { ...defaultQuery },
+            context
+          })) != null ? _a : defaultQuery;
+          try {
+            console.time(`fetch entry ${entryId}`);
+            const entry = await client2.getEntry(entryId, query);
+            return entry;
+          } catch (e) {
+            const message = getErrorMessageFromContentfulError(e);
+            if (isLegacyValue(parameter.value)) {
+              throw new Error(
+                `Failed loading Contentful entry '${parameter.value}' referenced in parameter '${parameterName}': ${message}`
+              );
+            } else {
+              throw new Error(
+                `Failed loading Contentful entry '${entryId}' from source '${(_b = parameter.value.source) != null ? _b : "default"}' referenced in parameter '${parameterName}': ${message}`
+              );
+            }
+          } finally {
+            console.timeEnd(`fetch entry ${entryId}`);
+          }
+        }
+      },
+      limitPolicy: finalLimitPolicy
+    };
+  }
+}
+function parameterIsContentfulEntrySelector(parameter) {
+  var _a;
+  return parameter.type === CANVAS_CONTENTFUL_PARAMETER_TYPES[0] && (((_a = parameter.value) == null ? void 0 : _a.entryId) || typeof parameter.value === "string");
+}
+function isLegacyValue(value) {
+  return typeof value === "string";
+}
+function isParameterValueDefined(value) {
+  if (!value || !isLegacyValue(value) && !value.entryId) {
+    return false;
+  }
+  return true;
+}
+function resolveClientForParameter2({
+  clients,
+  parameterValue,
+  parameterName,
+  component,
+  context
+}) {
+  if (isLegacyValue(parameterValue)) {
+    const client2 = clients.getClient({ isPreviewClient: context.preview });
+    if (!client2) {
+      throw new Error(
+        `Parameter '${parameterName}' in component '${component.type}' has a value '${parameterValue}' that is not compatible with multi-space/environment usage. If you wish to use multiple spaces/environments, you must convert your Canvas component parameters to the multi-space/environment compatible version. Otherwise, you can continue to use your parameters as-is, but must specify one of the clients provided to the Contentful enhancer as the 'default' client by registering it without specifying a source key.`
+      );
+    }
+    return client2;
+  }
+  const { source = "default" } = parameterValue;
+  const client = clients.getClient({
+    source,
+    isPreviewClient: context.preview
+  });
+  if (!client) {
+    throw new Error(
+      `No Contentful client could be resolved for source key '${source}' referenced in parameter '${parameterName} in component '${component.type}'. Ensure that the 'clients' property you are passing to the enhancer has a client instance registered for the source key.`
+    );
+  }
+  return client;
+}
+
+// src/createContentfulMultiEnhancer.ts
+var defaultQuery2 = {
+  select: "fields",
+  include: 1
+};
+var CANVAS_CONTENTFUL_MULTI_PARAMETER_TYPES = Object.freeze(["contentfulMultiEntry"]);
+function createContentfulMultiEnhancer({
+  clients,
+  createQuery,
+  limitPolicy
+}) {
+  if (!clients) {
+    throw new Error(
+      "No Contentful clients were provided to the enhancer. You must provide at least one client via the ContentfulClientList."
+    );
+  }
+  const finalLimitPolicy = limitPolicy || defaultContentfulLimitPolicy;
+  return {
+    enhanceOne: async function contentfulMultiEntryEnhancer({
+      parameter,
+      parameterName,
+      component,
+      context
+    }) {
+      var _a, _b;
+      if (parameterIsContentfulMultiEntry(parameter)) {
+        if (!isParameterValueDefined2(parameter.value)) {
+          return null;
+        }
+        const client = resolveClientForParameter({
+          clients,
+          parameterName,
+          parameterValue: parameter.value,
+          component,
+          context
+        });
+        const entryIds = parameter.value.entries;
+        const query = (_a = createQuery == null ? void 0 : createQuery({
+          parameter,
+          parameterName,
+          component,
+          defaultQuery: { ...defaultQuery2 },
+          context
+        })) != null ? _a : defaultQuery2;
+        try {
+          console.time(`fetch entries ${entryIds.join()}`);
+          const entries = await client.getEntries({
+            "sys.id[in]": entryIds.join(),
+            limit: entryIds.length,
+            ...query
+          });
+          const items = syncEntriesOrder(entries.items, entryIds);
+          return items;
+        } catch (e) {
+          const message = getErrorMessageFromContentfulError(e);
+          throw new Error(
+            `Failed loading Contentful entries '${entryIds.join()}' from source '${(_b = parameter.value.source) != null ? _b : "default"}' referenced in parameter '${parameterName}': ${message}`
+          );
+        } finally {
+          console.timeEnd(`fetch entries ${entryIds.join()}`);
+        }
+      }
+    },
+    limitPolicy: finalLimitPolicy
+  };
+}
+function parameterIsContentfulMultiEntry(parameter) {
+  return parameter.type === CANVAS_CONTENTFUL_MULTI_PARAMETER_TYPES[0];
+}
+function isParameterValueDefined2(value) {
+  var _a;
+  if (!value || !((_a = value.entries) == null ? void 0 : _a.length)) {
+    return false;
+  }
+  return true;
+}
+function syncEntriesOrder(entries, entryIds) {
+  var _a;
+  if (!entries.length || !((_a = entries[0].sys) == null ? void 0 : _a.id)) {
+    return entries;
+  }
+  const sorted = [];
+  for (const entryId of entryIds) {
+    const entry = entries.find((x) => x.sys.id === entryId);
+    if (entry) {
+      sorted.push(entry);
+    }
+  }
+  return sorted;
+}
+
+// src/createContentfulQueryEnhancer.ts
+var CANVAS_CONTENTFUL_QUERY_PARAMETER_TYPES = Object.freeze(["contentfulQuery"]);
+var defaultQuery3 = {
+  select: "fields",
+  include: 1
+};
+function createContentfulQueryEnhancer({
+  clients,
+  createQuery,
+  limitPolicy
+}) {
+  if (!clients) {
+    throw new Error(
+      "No Contentful clients were provided to the enhancer. You must provide at least one client via the ContentfulClientList."
+    );
+  }
+  const finalLimitPolicy = limitPolicy || defaultContentfulLimitPolicy;
+  return {
+    enhanceOne: async function contentfulQueryEnhancer({ parameter, parameterName, component, context }) {
+      var _a, _b;
+      if (parameterIsContentfulQuery(parameter)) {
+        if (!isParameterValueDefined3(parameter.value)) {
+          return null;
+        }
+        const client = resolveClientForParameter({
+          clients,
+          parameterName,
+          parameterValue: parameter.value,
+          component,
+          context
+        });
+        const value = parameter.value;
+        const count = getValidCount(value.count);
+        const query = (_a = createQuery == null ? void 0 : createQuery({
+          parameter,
+          parameterName,
+          component,
+          defaultQuery: { ...defaultQuery3 },
+          context
+        })) != null ? _a : defaultQuery3;
+        const timerLabel = `fetch query: ${count} entries with '${value.contentType}' content type`;
+        try {
+          console.time(timerLabel);
+          const entries = await client.getEntries({
+            content_type: value.contentType,
+            order: toContentfulOrder(value.sortBy, value.sortOrder),
+            limit: count,
+            ...query
+          });
+          return entries.items;
+        } catch (e) {
+          const message = getErrorMessageFromContentfulError(e);
+          throw new Error(
+            `Failed loading Contentful entries with '${value.contentType}' content type from source '${(_b = value.source) != null ? _b : "default"}' referenced in parameter '${parameterName}': ${message}`
+          );
+        } finally {
+          console.timeEnd(timerLabel);
+        }
+      }
+    },
+    limitPolicy: finalLimitPolicy
+  };
+}
+function parameterIsContentfulQuery(parameter) {
+  return parameter.type === CANVAS_CONTENTFUL_QUERY_PARAMETER_TYPES[0];
+}
+function isParameterValueDefined3(value) {
+  if (!value || !value.source || !value.contentType || typeof value.count === "undefined") {
+    return false;
+  }
+  return true;
+}
+function getValidCount(count) {
+  if (!count || count < 1) {
+    return 1;
+  }
+  if (count > 1e3) {
+    return 1e3;
+  }
+  return count;
+}
+export {
+  CANVAS_CONTENTFUL_MULTI_PARAMETER_TYPES,
+  CANVAS_CONTENTFUL_PARAMETER_TYPES,
+  CANVAS_CONTENTFUL_QUERY_PARAMETER_TYPES,
+  ContentfulClientList,
+  contentfulRichTextToHtmlEnhancer,
+  createContentfulEnhancer,
+  createContentfulMultiEnhancer,
+  createContentfulQueryEnhancer
+};