@webiny/website-builder-sdk 0.0.0-unstable.7be00a75a9 → 0.0.0-unstable.7c2def32a7

package/BindingsResolver.d.ts

@@ -9,7 +9,10 @@ export type ResolveElementParams = {
     inputAst: InputAstNode[];
     onResolved?: OnResolved;
 };
-export declare class BindingsResolver {
+export interface IBindingsResolver {
+    resolveElement(params: ResolveElementParams): ResolvedElement[];
+}
+export declare class BindingsResolver implements IBindingsResolver {
     private readonly state;
     constructor(state: DocumentState);
     resolveElement({ element, elementBindings, inputAst, onResolved }: ResolveElementParams): ResolvedElement[];

package/BindingsResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"BindingsResolver.js","sources":["../src/BindingsResolver.ts"],"sourcesContent":["import { toJS } from \"mobx\";\nimport type {\n    ComponentInput,\n    DocumentElement,\n    DocumentElementBindings,\n    DocumentElementStyleBindings,\n    DocumentState,\n    ResolvedElement,\n    SerializableCSSStyleDeclaration,\n    ValueBinding\n} from \"~/types.js\";\nimport type { InputAstNode } from \"./ComponentManifestToAstConverter.js\";\n\nexport interface OnResolved {\n    (value: any, input: ComponentInput): any;\n}\n\nexport type ResolveElementParams = {\n    element: DocumentElement;\n    elementBindings: DocumentElementBindings;\n    inputAst: InputAstNode[];\n    onResolved?: OnResolved;\n};\n\nexport class BindingsResolver {\n    private readonly state: DocumentState;\n\n    constructor(state: DocumentState) {\n        this.state = state;\n    }\n\n    public resolveElement({\n        element,\n        elementBindings,\n        inputAst,\n        onResolved\n    }: ResolveElementParams): ResolvedElement[] {\n        const repeatBindingArray = elementBindings.$repeat;\n\n        if (repeatBindingArray) {\n            const items = this.resolveBinding(repeatBindingArray, { state: toJS(this.state) });\n\n            if (!Array.isArray(items)) {\n                return [];\n            }\n\n            return items.map(item => {\n                return this.resolveSingleInstance(\n                    element,\n                    elementBindings,\n                    item,\n                    inputAst,\n                    onResolved\n                );\n            });\n        }\n\n        return [\n            this.resolveSingleInstance(element, elementBindings, undefined, inputAst, onResolved)\n        ];\n    }\n\n    private resolveSingleInstance(\n        element: DocumentElement,\n        elementBindings: DocumentElementBindings,\n        item: Record<string, any> | undefined,\n        inputAst: InputAstNode[],\n        onResolved?: OnResolved\n    ): ResolvedElement {\n        const resolvedElement: ResolvedElement = {\n            id: element.id,\n            inputs: {},\n            styles: {}\n        };\n\n        const context = { state: this.state, $: item };\n        const bindings = elementBindings.inputs ?? {};\n\n        const resolveInputsFromAst = (\n            nodes: InputAstNode[],\n            prefix: string[],\n            target: Record<string, any>\n        ) => {\n            for (const node of nodes) {\n                const pathParts = [...prefix, node.name];\n                const path = pathParts.join(\"/\");\n                const binding = bindings[path];\n                const value = this.resolveBinding(binding, context) ?? node.input.defaultValue;\n\n                const finalValue = onResolved ? onResolved(value, node.input) : value;\n\n                if (node.children.length > 0) {\n                    if (node.list) {\n                        const uniqueIndexes = this.getUniqueIndexesFromPath(path, bindings);\n\n                        target[node.name] = uniqueIndexes.map(index => {\n                            const childTarget: Record<string, any> = {};\n                            resolveInputsFromAst(\n                                node.children,\n                                [...pathParts.slice(0, -1), `${node.name}/${index}`],\n                                childTarget\n                            );\n                            return childTarget;\n                        });\n                    } else {\n                        const childTarget: Record<string, any> = {};\n                        resolveInputsFromAst(node.children, pathParts, childTarget);\n                        target[node.name] = childTarget;\n                    }\n                } else if (node.list) {\n                    // List node with no children (e.g., slot or primitive list)\n                    const uniqueIndexes = this.getUniqueIndexesFromPath(path, bindings);\n\n                    // If binding is e.g., `leftColumn/0`, we'll have `0` in unique indexes.\n                    if (uniqueIndexes.length > 0) {\n                        target[node.name] = uniqueIndexes.map(index => {\n                            const binding = bindings[`${node.name}/${index}`];\n                            const value =\n                                this.resolveBinding(binding, context) ?? node.input.defaultValue;\n                            return onResolved ? onResolved(value, node.input) : value;\n                        });\n                    } else {\n                        // If binding is a simple `children`, we simply assign the resolved value.\n                        target[node.name] = finalValue;\n                    }\n                } else if (finalValue !== undefined) {\n                    target[node.name] = finalValue;\n                }\n            }\n        };\n\n        resolveInputsFromAst(inputAst, [], resolvedElement.inputs);\n\n        // Resolve styles\n        const styles: DocumentElementStyleBindings = elementBindings.styles\n            ? (elementBindings.styles ?? {})\n            : {};\n\n        const resolvedStyles: SerializableCSSStyleDeclaration = {};\n\n        for (const [path, binding] of Object.entries(styles)) {\n            if (binding) {\n                // @ts-expect-error We're positive this is correct.\n                resolvedStyles[path] = this.resolveBinding(binding, context);\n            }\n        }\n\n        return {\n            ...resolvedElement,\n            styles: resolvedStyles\n        };\n    }\n\n    private getUniqueIndexesFromPath(flatKey: string, bindings: DocumentElementBindings) {\n        const pattern = new RegExp(`^${flatKey}\\\\/(\\\\d+)`);\n\n        const indexes = Object.keys(bindings).reduce((acc: number[], key) => {\n            const match = key.match(pattern);\n            if (match) {\n                acc.push(parseInt(match[1], 10));\n            }\n            return acc;\n        }, []);\n\n        return Array.from(new Set(indexes)).sort((a, b) => a - b);\n    }\n\n    private resolveBinding(binding: ValueBinding | undefined, context: Record<string, any>): any {\n        if (typeof binding === \"undefined\") {\n            return undefined;\n        }\n\n        if (binding.expression) {\n            return this.evaluateExpression(binding.expression, context);\n        }\n\n        return binding.static;\n    }\n\n    private evaluateExpression(expression: string | undefined, context: Record<string, any> = {}) {\n        if (!expression || expression === \"$noop\") {\n            return undefined;\n        }\n\n        try {\n            let finalExpression = expression.trim();\n\n            if (finalExpression.startsWith(\"$state\")) {\n                finalExpression = finalExpression.replace(/^\\$state/, \"state\");\n            }\n\n            finalExpression = finalExpression.replace(/\\.([0-9]+)/g, \"[$1]\");\n\n            const scopedFn = new Function(...Object.keys(context), `return ${finalExpression};`);\n            return scopedFn(...Object.values(context));\n        } catch {\n            return undefined;\n        }\n    }\n}\n"],"names":["BindingsResolver","state","element","elementBindings","inputAst","onResolved","repeatBindingArray","items","toJS","Array","item","undefined","resolvedElement","context","bindings","resolveInputsFromAst","nodes","prefix","target","node","pathParts","path","binding","value","finalValue","uniqueIndexes","index","childTarget","styles","resolvedStyles","Object","flatKey","pattern","RegExp","indexes","acc","key","match","parseInt","Set","a","b","expression","finalExpression","scopedFn","Function"],"mappings":"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"}
+{"version":3,"file":"BindingsResolver.js","sources":["../src/BindingsResolver.ts"],"sourcesContent":["import { toJS } from \"mobx\";\nimport type {\n    ComponentInput,\n    DocumentElement,\n    DocumentElementBindings,\n    DocumentElementStyleBindings,\n    DocumentState,\n    ResolvedElement,\n    SerializableCSSStyleDeclaration,\n    ValueBinding\n} from \"~/types.js\";\nimport type { InputAstNode } from \"./ComponentManifestToAstConverter.js\";\n\nexport interface OnResolved {\n    (value: any, input: ComponentInput): any;\n}\n\nexport type ResolveElementParams = {\n    element: DocumentElement;\n    elementBindings: DocumentElementBindings;\n    inputAst: InputAstNode[];\n    onResolved?: OnResolved;\n};\n\nexport interface IBindingsResolver {\n    resolveElement(params: ResolveElementParams): ResolvedElement[];\n}\n\nexport class BindingsResolver implements IBindingsResolver {\n    private readonly state: DocumentState;\n\n    constructor(state: DocumentState) {\n        this.state = state;\n    }\n\n    public resolveElement({\n        element,\n        elementBindings,\n        inputAst,\n        onResolved\n    }: ResolveElementParams): ResolvedElement[] {\n        const repeatBindingArray = elementBindings.$repeat;\n\n        if (repeatBindingArray) {\n            const items = this.resolveBinding(repeatBindingArray, { state: toJS(this.state) });\n\n            if (!Array.isArray(items)) {\n                return [];\n            }\n\n            return items.map(item => {\n                return this.resolveSingleInstance(\n                    element,\n                    elementBindings,\n                    item,\n                    inputAst,\n                    onResolved\n                );\n            });\n        }\n\n        return [\n            this.resolveSingleInstance(element, elementBindings, undefined, inputAst, onResolved)\n        ];\n    }\n\n    private resolveSingleInstance(\n        element: DocumentElement,\n        elementBindings: DocumentElementBindings,\n        item: Record<string, any> | undefined,\n        inputAst: InputAstNode[],\n        onResolved?: OnResolved\n    ): ResolvedElement {\n        const resolvedElement: ResolvedElement = {\n            id: element.id,\n            inputs: {},\n            styles: {}\n        };\n\n        const context = { state: this.state, $: item };\n        const bindings = elementBindings.inputs ?? {};\n\n        const resolveInputsFromAst = (\n            nodes: InputAstNode[],\n            prefix: string[],\n            target: Record<string, any>\n        ) => {\n            for (const node of nodes) {\n                const pathParts = [...prefix, node.name];\n                const path = pathParts.join(\"/\");\n                const binding = bindings[path];\n                const value = this.resolveBinding(binding, context) ?? node.input.defaultValue;\n\n                const finalValue = onResolved ? onResolved(value, node.input) : value;\n\n                if (node.children.length > 0) {\n                    if (node.list) {\n                        const uniqueIndexes = this.getUniqueIndexesFromPath(path, bindings);\n\n                        target[node.name] = uniqueIndexes.map(index => {\n                            const childTarget: Record<string, any> = {};\n                            resolveInputsFromAst(\n                                node.children,\n                                [...pathParts.slice(0, -1), `${node.name}/${index}`],\n                                childTarget\n                            );\n                            return childTarget;\n                        });\n                    } else {\n                        const childTarget: Record<string, any> = {};\n                        resolveInputsFromAst(node.children, pathParts, childTarget);\n                        target[node.name] = childTarget;\n                    }\n                } else if (node.list) {\n                    // List node with no children (e.g., slot or primitive list)\n                    const uniqueIndexes = this.getUniqueIndexesFromPath(path, bindings);\n\n                    // If binding is e.g., `leftColumn/0`, we'll have `0` in unique indexes.\n                    if (uniqueIndexes.length > 0) {\n                        target[node.name] = uniqueIndexes.map(index => {\n                            const binding = bindings[`${node.name}/${index}`];\n                            const value =\n                                this.resolveBinding(binding, context) ?? node.input.defaultValue;\n                            return onResolved ? onResolved(value, node.input) : value;\n                        });\n                    } else {\n                        // If binding is a simple `children`, we simply assign the resolved value.\n                        target[node.name] = finalValue;\n                    }\n                } else if (finalValue !== undefined) {\n                    target[node.name] = finalValue;\n                }\n            }\n        };\n\n        resolveInputsFromAst(inputAst, [], resolvedElement.inputs);\n\n        // Resolve styles\n        const styles: DocumentElementStyleBindings = elementBindings.styles\n            ? (elementBindings.styles ?? {})\n            : {};\n\n        const resolvedStyles: SerializableCSSStyleDeclaration = {};\n\n        for (const [path, binding] of Object.entries(styles)) {\n            if (binding) {\n                // @ts-expect-error We're positive this is correct.\n                resolvedStyles[path] = this.resolveBinding(binding, context);\n            }\n        }\n\n        return {\n            ...resolvedElement,\n            styles: resolvedStyles\n        };\n    }\n\n    private getUniqueIndexesFromPath(flatKey: string, bindings: DocumentElementBindings) {\n        const pattern = new RegExp(`^${flatKey}\\\\/(\\\\d+)`);\n\n        const indexes = Object.keys(bindings).reduce((acc: number[], key) => {\n            const match = key.match(pattern);\n            if (match) {\n                acc.push(parseInt(match[1], 10));\n            }\n            return acc;\n        }, []);\n\n        return Array.from(new Set(indexes)).sort((a, b) => a - b);\n    }\n\n    private resolveBinding(binding: ValueBinding | undefined, context: Record<string, any>): any {\n        if (typeof binding === \"undefined\") {\n            return undefined;\n        }\n\n        if (binding.expression) {\n            return this.evaluateExpression(binding.expression, context);\n        }\n\n        return binding.static;\n    }\n\n    private evaluateExpression(expression: string | undefined, context: Record<string, any> = {}) {\n        if (!expression || expression === \"$noop\") {\n            return undefined;\n        }\n\n        try {\n            let finalExpression = expression.trim();\n\n            if (finalExpression.startsWith(\"$state\")) {\n                finalExpression = finalExpression.replace(/^\\$state/, \"state\");\n            }\n\n            finalExpression = finalExpression.replace(/\\.([0-9]+)/g, \"[$1]\");\n\n            const scopedFn = new Function(...Object.keys(context), `return ${finalExpression};`);\n            return scopedFn(...Object.values(context));\n        } catch {\n            return undefined;\n        }\n    }\n}\n"],"names":["BindingsResolver","state","element","elementBindings","inputAst","onResolved","repeatBindingArray","items","toJS","Array","item","undefined","resolvedElement","context","bindings","resolveInputsFromAst","nodes","prefix","target","node","pathParts","path","binding","value","finalValue","uniqueIndexes","index","childTarget","styles","resolvedStyles","Object","flatKey","pattern","RegExp","indexes","acc","key","match","parseInt","Set","a","b","expression","finalExpression","scopedFn","Function"],"mappings":";AA4BO,MAAMA;IAGT,YAAYC,KAAoB,CAAE;QAC9B,IAAI,CAAC,KAAK,GAAGA;IACjB;IAEO,eAAe,EAClBC,OAAO,EACPC,eAAe,EACfC,QAAQ,EACRC,UAAU,EACS,EAAqB;QACxC,MAAMC,qBAAqBH,gBAAgB,OAAO;QAElD,IAAIG,oBAAoB;YACpB,MAAMC,QAAQ,IAAI,CAAC,cAAc,CAACD,oBAAoB;gBAAE,OAAOE,KAAK,IAAI,CAAC,KAAK;YAAE;YAEhF,IAAI,CAACC,MAAM,OAAO,CAACF,QACf,OAAO,EAAE;YAGb,OAAOA,MAAM,GAAG,CAACG,CAAAA,OACN,IAAI,CAAC,qBAAqB,CAC7BR,SACAC,iBACAO,MACAN,UACAC;QAGZ;QAEA,OAAO;YACH,IAAI,CAAC,qBAAqB,CAACH,SAASC,iBAAiBQ,QAAWP,UAAUC;SAC7E;IACL;IAEQ,sBACJH,OAAwB,EACxBC,eAAwC,EACxCO,IAAqC,EACrCN,QAAwB,EACxBC,UAAuB,EACR;QACf,MAAMO,kBAAmC;YACrC,IAAIV,QAAQ,EAAE;YACd,QAAQ,CAAC;YACT,QAAQ,CAAC;QACb;QAEA,MAAMW,UAAU;YAAE,OAAO,IAAI,CAAC,KAAK;YAAE,GAAGH;QAAK;QAC7C,MAAMI,WAAWX,gBAAgB,MAAM,IAAI,CAAC;QAE5C,MAAMY,uBAAuB,CACzBC,OACAC,QACAC;YAEA,KAAK,MAAMC,QAAQH,MAAO;gBACtB,MAAMI,YAAY;uBAAIH;oBAAQE,KAAK,IAAI;iBAAC;gBACxC,MAAME,OAAOD,UAAU,IAAI,CAAC;gBAC5B,MAAME,UAAUR,QAAQ,CAACO,KAAK;gBAC9B,MAAME,QAAQ,IAAI,CAAC,cAAc,CAACD,SAAST,YAAYM,KAAK,KAAK,CAAC,YAAY;gBAE9E,MAAMK,aAAanB,aAAaA,WAAWkB,OAAOJ,KAAK,KAAK,IAAII;gBAEhE,IAAIJ,KAAK,QAAQ,CAAC,MAAM,GAAG,GACvB,IAAIA,KAAK,IAAI,EAAE;oBACX,MAAMM,gBAAgB,IAAI,CAAC,wBAAwB,CAACJ,MAAMP;oBAE1DI,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGM,cAAc,GAAG,CAACC,CAAAA;wBAClC,MAAMC,cAAmC,CAAC;wBAC1CZ,qBACII,KAAK,QAAQ,EACb;+BAAIC,UAAU,KAAK,CAAC,GAAG;4BAAK,GAAGD,KAAK,IAAI,CAAC,CAAC,EAAEO,OAAO;yBAAC,EACpDC;wBAEJ,OAAOA;oBACX;gBACJ,OAAO;oBACH,MAAMA,cAAmC,CAAC;oBAC1CZ,qBAAqBI,KAAK,QAAQ,EAAEC,WAAWO;oBAC/CT,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGQ;gBACxB;qBACG,IAAIR,KAAK,IAAI,EAAE;oBAElB,MAAMM,gBAAgB,IAAI,CAAC,wBAAwB,CAACJ,MAAMP;oBAG1D,IAAIW,cAAc,MAAM,GAAG,GACvBP,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGM,cAAc,GAAG,CAACC,CAAAA;wBAClC,MAAMJ,UAAUR,QAAQ,CAAC,GAAGK,KAAK,IAAI,CAAC,CAAC,EAAEO,OAAO,CAAC;wBACjD,MAAMH,QACF,IAAI,CAAC,cAAc,CAACD,SAAST,YAAYM,KAAK,KAAK,CAAC,YAAY;wBACpE,OAAOd,aAAaA,WAAWkB,OAAOJ,KAAK,KAAK,IAAII;oBACxD;yBAGAL,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGK;gBAE5B,OAAO,IAAIA,AAAeb,WAAfa,YACPN,MAAM,CAACC,KAAK,IAAI,CAAC,GAAGK;YAE5B;QACJ;QAEAT,qBAAqBX,UAAU,EAAE,EAAEQ,gBAAgB,MAAM;QAGzD,MAAMgB,SAAuCzB,gBAAgB,MAAM,GAC5DA,gBAAgB,MAAM,IAAI,CAAC,IAC5B,CAAC;QAEP,MAAM0B,iBAAkD,CAAC;QAEzD,KAAK,MAAM,CAACR,MAAMC,QAAQ,IAAIQ,OAAO,OAAO,CAACF,QACzC,IAAIN,SAEAO,cAAc,CAACR,KAAK,GAAG,IAAI,CAAC,cAAc,CAACC,SAAST;QAI5D,OAAO;YACH,GAAGD,eAAe;YAClB,QAAQiB;QACZ;IACJ;IAEQ,yBAAyBE,OAAe,EAAEjB,QAAiC,EAAE;QACjF,MAAMkB,UAAU,IAAIC,OAAO,CAAC,CAAC,EAAEF,QAAQ,SAAS,CAAC;QAEjD,MAAMG,UAAUJ,OAAO,IAAI,CAAChB,UAAU,MAAM,CAAC,CAACqB,KAAeC;YACzD,MAAMC,QAAQD,IAAI,KAAK,CAACJ;YACxB,IAAIK,OACAF,IAAI,IAAI,CAACG,SAASD,KAAK,CAAC,EAAE,EAAE;YAEhC,OAAOF;QACX,GAAG,EAAE;QAEL,OAAO1B,MAAM,IAAI,CAAC,IAAI8B,IAAIL,UAAU,IAAI,CAAC,CAACM,GAAGC,IAAMD,IAAIC;IAC3D;IAEQ,eAAenB,OAAiC,EAAET,OAA4B,EAAO;QACzF,IAAI,AAAmB,WAAZS,SACP;QAGJ,IAAIA,QAAQ,UAAU,EAClB,OAAO,IAAI,CAAC,kBAAkB,CAACA,QAAQ,UAAU,EAAET;QAGvD,OAAOS,QAAQ,MAAM;IACzB;IAEQ,mBAAmBoB,UAA8B,EAAE7B,UAA+B,CAAC,CAAC,EAAE;QAC1F,IAAI,CAAC6B,cAAcA,AAAe,YAAfA,YACf;QAGJ,IAAI;YACA,IAAIC,kBAAkBD,WAAW,IAAI;YAErC,IAAIC,gBAAgB,UAAU,CAAC,WAC3BA,kBAAkBA,gBAAgB,OAAO,CAAC,YAAY;YAG1DA,kBAAkBA,gBAAgB,OAAO,CAAC,eAAe;YAEzD,MAAMC,WAAW,IAAIC,YAAYf,OAAO,IAAI,CAACjB,UAAU,CAAC,OAAO,EAAE8B,gBAAgB,CAAC,CAAC;YACnF,OAAOC,YAAYd,OAAO,MAAM,CAACjB;QACrC,EAAE,OAAM;YACJ;QACJ;IACJ;AACJ"}

package/ComponentInputTraverser.js

@@ -12,6 +12,10 @@ class ComponentInputTraverser {
         if (node.list) {
             value = value ?? [];
             if (0 === value.length) visitor(node, currentPath, value);
+            if (0 === node.children.length && "slot" !== node.type) {
+                if (value.length > 0) visitor(node, currentPath, value);
+                return;
+            }
             value.forEach((item, index)=>{
                 if (node.children.length > 0) {
                     const itemPath = `${currentPath}/${index}`;

package/ComponentInputTraverser.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentInputTraverser.js","sources":["../src/ComponentInputTraverser.ts"],"sourcesContent":["import type { InputAstNode } from \"./ComponentManifestToAstConverter.js\";\n\n// Visitor signature: called for every resolved leaf\nexport type InputVisitor = (node: InputAstNode, path: string, value: any) => void;\n\n/**\n * ComponentInputTraverser\n *\n * Walks an input AST and a matching data object,\n * invoking `visitor` for each leaf value found.\n */\nexport class ComponentInputTraverser {\n    private readonly ast: InputAstNode[];\n\n    constructor(ast: InputAstNode[]) {\n        this.ast = ast;\n    }\n\n    /**\n     * Traverse the given `data` object according to the AST,\n     * calling `visitor(node, path, value)` for each leaf.\n     */\n    public traverse(data: Record<string, any>, visitor: InputVisitor): void {\n        for (const node of this.ast) {\n            const rootValue = data[node.name];\n            this.traverseNode(node, rootValue, node.name, visitor);\n        }\n    }\n\n    private traverseNode(\n        node: InputAstNode,\n        value: any,\n        currentPath: string,\n        visitor: InputVisitor\n    ): void {\n        if (node.list) {\n            value = value ?? [];\n\n            if (value.length === 0) {\n                visitor(node, currentPath, value);\n            }\n\n            value.forEach((item: any, index: number) => {\n                if (node.children.length > 0) {\n                    const itemPath = `${currentPath}/${index}`;\n                    for (const child of node.children) {\n                        const childValue = item?.[child.name];\n                        const childPath = `${itemPath}/${child.name}`;\n                        this.traverseNode(child, childValue, childPath, visitor);\n                    }\n                } else {\n                    visitor(node, currentPath, item);\n                }\n            });\n        } else {\n            if (node.children.length > 0) {\n                for (const child of node.children) {\n                    const childValue = value?.[child.name];\n                    const childPath = `${currentPath}/${child.name}`;\n                    this.traverseNode(child, childValue, childPath, visitor);\n                }\n            } else {\n                visitor(node, currentPath, value);\n            }\n        }\n    }\n}\n"],"names":["ComponentInputTraverser","ast","data","visitor","node","rootValue","value","currentPath","item","index","itemPath","child","childValue","childPath"],"mappings":"AAWO,MAAMA;IAGT,YAAYC,GAAmB,CAAE;QAC7B,IAAI,CAAC,GAAG,GAAGA;IACf;IAMO,SAASC,IAAyB,EAAEC,OAAqB,EAAQ;QACpE,KAAK,MAAMC,QAAQ,IAAI,CAAC,GAAG,CAAE;YACzB,MAAMC,YAAYH,IAAI,CAACE,KAAK,IAAI,CAAC;YACjC,IAAI,CAAC,YAAY,CAACA,MAAMC,WAAWD,KAAK,IAAI,EAAED;QAClD;IACJ;IAEQ,aACJC,IAAkB,EAClBE,KAAU,EACVC,WAAmB,EACnBJ,OAAqB,EACjB;QACJ,IAAIC,KAAK,IAAI,EAAE;YACXE,QAAQA,SAAS,EAAE;YAEnB,IAAIA,AAAiB,MAAjBA,MAAM,MAAM,EACZH,QAAQC,MAAMG,aAAaD;YAG/BA,MAAM,OAAO,CAAC,CAACE,MAAWC;gBACtB,IAAIL,KAAK,QAAQ,CAAC,MAAM,GAAG,GAAG;oBAC1B,MAAMM,WAAW,GAAGH,YAAY,CAAC,EAAEE,OAAO;oBAC1C,KAAK,MAAME,SAASP,KAAK,QAAQ,CAAE;wBAC/B,MAAMQ,aAAaJ,MAAM,CAACG,MAAM,IAAI,CAAC;wBACrC,MAAME,YAAY,GAAGH,SAAS,CAAC,EAAEC,MAAM,IAAI,EAAE;wBAC7C,IAAI,CAAC,YAAY,CAACA,OAAOC,YAAYC,WAAWV;oBACpD;gBACJ,OACIA,QAAQC,MAAMG,aAAaC;YAEnC;QACJ,OACI,IAAIJ,KAAK,QAAQ,CAAC,MAAM,GAAG,GACvB,KAAK,MAAMO,SAASP,KAAK,QAAQ,CAAE;YAC/B,MAAMQ,aAAaN,OAAO,CAACK,MAAM,IAAI,CAAC;YACtC,MAAME,YAAY,GAAGN,YAAY,CAAC,EAAEI,MAAM,IAAI,EAAE;YAChD,IAAI,CAAC,YAAY,CAACA,OAAOC,YAAYC,WAAWV;QACpD;aAEAA,QAAQC,MAAMG,aAAaD;IAGvC;AACJ"}
+{"version":3,"file":"ComponentInputTraverser.js","sources":["../src/ComponentInputTraverser.ts"],"sourcesContent":["import type { InputAstNode } from \"./ComponentManifestToAstConverter.js\";\n\n// Visitor signature: called for every resolved leaf\nexport type InputVisitor = (node: InputAstNode, path: string, value: any) => void;\n\n/**\n * ComponentInputTraverser\n *\n * Walks an input AST and a matching data object,\n * invoking `visitor` for each leaf value found.\n */\nexport class ComponentInputTraverser {\n    private readonly ast: InputAstNode[];\n\n    constructor(ast: InputAstNode[]) {\n        this.ast = ast;\n    }\n\n    /**\n     * Traverse the given `data` object according to the AST,\n     * calling `visitor(node, path, value)` for each leaf.\n     */\n    public traverse(data: Record<string, any>, visitor: InputVisitor): void {\n        for (const node of this.ast) {\n            const rootValue = data[node.name];\n            this.traverseNode(node, rootValue, node.name, visitor);\n        }\n    }\n\n    private traverseNode(\n        node: InputAstNode,\n        value: any,\n        currentPath: string,\n        visitor: InputVisitor\n    ): void {\n        if (node.list) {\n            value = value ?? [];\n\n            if (value.length === 0) {\n                visitor(node, currentPath, value);\n            }\n\n            // A list of primitives (e.g. tags) is a single leaf: its value is the whole array.\n            // Visiting each item would write every item to the same path, leaving only the last.\n            // Slot lists are still visited per item, as each item creates its own element.\n            if (node.children.length === 0 && node.type !== \"slot\") {\n                if (value.length > 0) {\n                    visitor(node, currentPath, value);\n                }\n                return;\n            }\n\n            value.forEach((item: any, index: number) => {\n                if (node.children.length > 0) {\n                    const itemPath = `${currentPath}/${index}`;\n                    for (const child of node.children) {\n                        const childValue = item?.[child.name];\n                        const childPath = `${itemPath}/${child.name}`;\n                        this.traverseNode(child, childValue, childPath, visitor);\n                    }\n                } else {\n                    visitor(node, currentPath, item);\n                }\n            });\n        } else {\n            if (node.children.length > 0) {\n                for (const child of node.children) {\n                    const childValue = value?.[child.name];\n                    const childPath = `${currentPath}/${child.name}`;\n                    this.traverseNode(child, childValue, childPath, visitor);\n                }\n            } else {\n                visitor(node, currentPath, value);\n            }\n        }\n    }\n}\n"],"names":["ComponentInputTraverser","ast","data","visitor","node","rootValue","value","currentPath","item","index","itemPath","child","childValue","childPath"],"mappings":"AAWO,MAAMA;IAGT,YAAYC,GAAmB,CAAE;QAC7B,IAAI,CAAC,GAAG,GAAGA;IACf;IAMO,SAASC,IAAyB,EAAEC,OAAqB,EAAQ;QACpE,KAAK,MAAMC,QAAQ,IAAI,CAAC,GAAG,CAAE;YACzB,MAAMC,YAAYH,IAAI,CAACE,KAAK,IAAI,CAAC;YACjC,IAAI,CAAC,YAAY,CAACA,MAAMC,WAAWD,KAAK,IAAI,EAAED;QAClD;IACJ;IAEQ,aACJC,IAAkB,EAClBE,KAAU,EACVC,WAAmB,EACnBJ,OAAqB,EACjB;QACJ,IAAIC,KAAK,IAAI,EAAE;YACXE,QAAQA,SAAS,EAAE;YAEnB,IAAIA,AAAiB,MAAjBA,MAAM,MAAM,EACZH,QAAQC,MAAMG,aAAaD;YAM/B,IAAIF,AAAyB,MAAzBA,KAAK,QAAQ,CAAC,MAAM,IAAUA,AAAc,WAAdA,KAAK,IAAI,EAAa;gBACpD,IAAIE,MAAM,MAAM,GAAG,GACfH,QAAQC,MAAMG,aAAaD;gBAE/B;YACJ;YAEAA,MAAM,OAAO,CAAC,CAACE,MAAWC;gBACtB,IAAIL,KAAK,QAAQ,CAAC,MAAM,GAAG,GAAG;oBAC1B,MAAMM,WAAW,GAAGH,YAAY,CAAC,EAAEE,OAAO;oBAC1C,KAAK,MAAME,SAASP,KAAK,QAAQ,CAAE;wBAC/B,MAAMQ,aAAaJ,MAAM,CAACG,MAAM,IAAI,CAAC;wBACrC,MAAME,YAAY,GAAGH,SAAS,CAAC,EAAEC,MAAM,IAAI,EAAE;wBAC7C,IAAI,CAAC,YAAY,CAACA,OAAOC,YAAYC,WAAWV;oBACpD;gBACJ,OACIA,QAAQC,MAAMG,aAAaC;YAEnC;QACJ,OACI,IAAIJ,KAAK,QAAQ,CAAC,MAAM,GAAG,GACvB,KAAK,MAAMO,SAASP,KAAK,QAAQ,CAAE;YAC/B,MAAMQ,aAAaN,OAAO,CAACK,MAAM,IAAI,CAAC;YACtC,MAAME,YAAY,GAAGN,YAAY,CAAC,EAAEI,MAAM,IAAI,EAAE;YAChD,IAAI,CAAC,YAAY,CAACA,OAAOC,YAAYC,WAAWV;QACpD;aAEAA,QAAQC,MAAMG,aAAaD;IAGvC;AACJ"}

package/ComponentResolver.d.ts

@@ -1,14 +1,17 @@
 import type { ComponentRegistry } from "./ComponentRegistry.js";
-import type { DocumentElement, DocumentElementBindings, DocumentState, ResolvedComponent } from "./types.js";
+import type { DocumentCache, DocumentElement, DocumentElementBindings, DocumentState, ResolvedComponent } from "./types.js";
 import type { OnResolved } from "./BindingsResolver.js";
+import type { ContentEntryCache } from "./contentEntry/ContentEntryCache.js";
 export type ResolveElementParams = {
     element: DocumentElement;
     elementBindings: DocumentElementBindings;
     state: DocumentState;
+    cache?: DocumentCache;
     onResolved?: OnResolved;
 };
 export declare class ComponentResolver {
     private components;
-    constructor(registry: ComponentRegistry);
-    resolve({ element, elementBindings, onResolved, state }: ResolveElementParams): ResolvedComponent[] | null;
+    private contentEntryCache;
+    constructor(registry: ComponentRegistry, cache?: ContentEntryCache);
+    resolve({ element, elementBindings, onResolved, state, cache }: ResolveElementParams): ResolvedComponent[] | null;
 }

package/ComponentResolver.js

@@ -1,19 +1,24 @@
 import { logger } from "./Logger.js";
 import { BindingsResolver } from "./BindingsResolver.js";
+import { ContentEntryBindingsResolver } from "./contentEntry/ContentEntryBindingsResolver.js";
+import { contentEntryCache } from "./contentEntry/ContentEntryCache.js";
 import { ComponentManifestToAstConverter } from "./ComponentManifestToAstConverter.js";
 class ComponentResolver {
-    constructor(registry){
+    constructor(registry, cache = contentEntryCache){
         this.components = registry;
+        this.contentEntryCache = cache;
     }
-    resolve({ element, elementBindings = {}, onResolved, state }) {
+    resolve({ element, elementBindings = {}, onResolved, state, cache }) {
         const componentName = element.component.name;
         const blueprint = this.components.get(componentName);
         if (!blueprint) {
             logger.warn(`Unknown component: ${componentName}`);
             return null;
         }
-        const bindingsResolver = new BindingsResolver(state);
-        const instances = bindingsResolver.resolveElement({
+        const embedded = cache?.contentEntries;
+        const resolvedEntries = embedded ? new Map(Object.entries(embedded)) : void 0;
+        const resolver = new ContentEntryBindingsResolver(new BindingsResolver(state), resolvedEntries, this.contentEntryCache);
+        const instances = resolver.resolveElement({
             element,
             elementBindings,
             inputAst: ComponentManifestToAstConverter.convert(blueprint.manifest.inputs ?? []),

package/ComponentResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentResolver.js","sources":["../src/ComponentResolver.ts"],"sourcesContent":["import type { ComponentRegistry } from \"~/ComponentRegistry.js\";\nimport type {\n    DocumentElement,\n    DocumentElementBindings,\n    DocumentState,\n    ResolvedComponent\n} from \"~/types.js\";\nimport { logger } from \"./Logger.js\";\nimport type { OnResolved } from \"./BindingsResolver.js\";\nimport { BindingsResolver } from \"./BindingsResolver.js\";\nimport { ComponentManifestToAstConverter } from \"~/ComponentManifestToAstConverter.js\";\n\nexport type ResolveElementParams = {\n    element: DocumentElement;\n    elementBindings: DocumentElementBindings;\n    state: DocumentState;\n    onResolved?: OnResolved;\n};\n\nexport class ComponentResolver {\n    private components: ComponentRegistry;\n\n    constructor(registry: ComponentRegistry) {\n        this.components = registry;\n    }\n\n    resolve({\n        element,\n        elementBindings = {},\n        onResolved,\n        state\n    }: ResolveElementParams): ResolvedComponent[] | null {\n        const componentName = element.component.name;\n        const blueprint = this.components.get(componentName);\n\n        if (!blueprint) {\n            logger.warn(`Unknown component: ${componentName}`);\n            return null;\n        }\n\n        const bindingsResolver = new BindingsResolver(state);\n        const instances = bindingsResolver.resolveElement({\n            element,\n            elementBindings,\n            inputAst: ComponentManifestToAstConverter.convert(blueprint.manifest.inputs ?? []),\n            onResolved\n        });\n\n        return instances.map(instance => ({\n            component: blueprint.component,\n            manifest: blueprint.manifest!,\n            styles: instance.styles,\n            inputs: instance.inputs\n        }));\n    }\n}\n"],"names":["ComponentResolver","registry","element","elementBindings","onResolved","state","componentName","blueprint","logger","bindingsResolver","BindingsResolver","instances","ComponentManifestToAstConverter","instance"],"mappings":";;;AAmBO,MAAMA;IAGT,YAAYC,QAA2B,CAAE;QACrC,IAAI,CAAC,UAAU,GAAGA;IACtB;IAEA,QAAQ,EACJC,OAAO,EACPC,kBAAkB,CAAC,CAAC,EACpBC,UAAU,EACVC,KAAK,EACc,EAA8B;QACjD,MAAMC,gBAAgBJ,QAAQ,SAAS,CAAC,IAAI;QAC5C,MAAMK,YAAY,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD;QAEtC,IAAI,CAACC,WAAW;YACZC,OAAO,IAAI,CAAC,CAAC,mBAAmB,EAAEF,eAAe;YACjD,OAAO;QACX;QAEA,MAAMG,mBAAmB,IAAIC,iBAAiBL;QAC9C,MAAMM,YAAYF,iBAAiB,cAAc,CAAC;YAC9CP;YACAC;YACA,UAAUS,gCAAgC,OAAO,CAACL,UAAU,QAAQ,CAAC,MAAM,IAAI,EAAE;YACjFH;QACJ;QAEA,OAAOO,UAAU,GAAG,CAACE,CAAAA,WAAa;gBAC9B,WAAWN,UAAU,SAAS;gBAC9B,UAAUA,UAAU,QAAQ;gBAC5B,QAAQM,SAAS,MAAM;gBACvB,QAAQA,SAAS,MAAM;YAC3B;IACJ;AACJ"}
+{"version":3,"file":"ComponentResolver.js","sources":["../src/ComponentResolver.ts"],"sourcesContent":["import type { ComponentRegistry } from \"~/ComponentRegistry.js\";\nimport type {\n    DocumentCache,\n    DocumentElement,\n    DocumentElementBindings,\n    DocumentState,\n    ResolvedComponent\n} from \"~/types.js\";\nimport { logger } from \"./Logger.js\";\nimport type { OnResolved } from \"./BindingsResolver.js\";\nimport { BindingsResolver } from \"./BindingsResolver.js\";\nimport { ContentEntryBindingsResolver } from \"./contentEntry/ContentEntryBindingsResolver.js\";\nimport type { ContentEntryCache } from \"./contentEntry/ContentEntryCache.js\";\nimport { contentEntryCache } from \"./contentEntry/ContentEntryCache.js\";\nimport { ComponentManifestToAstConverter } from \"~/ComponentManifestToAstConverter.js\";\nexport type ResolveElementParams = {\n    element: DocumentElement;\n    elementBindings: DocumentElementBindings;\n    state: DocumentState;\n    cache?: DocumentCache;\n    onResolved?: OnResolved;\n};\n\nexport class ComponentResolver {\n    private components: ComponentRegistry;\n    private contentEntryCache: ContentEntryCache;\n\n    constructor(registry: ComponentRegistry, cache: ContentEntryCache = contentEntryCache) {\n        this.components = registry;\n        this.contentEntryCache = cache;\n    }\n\n    resolve({\n        element,\n        elementBindings = {},\n        onResolved,\n        state,\n        cache\n    }: ResolveElementParams): ResolvedComponent[] | null {\n        const componentName = element.component.name;\n        const blueprint = this.components.get(componentName);\n\n        if (!blueprint) {\n            logger.warn(`Unknown component: ${componentName}`);\n            return null;\n        }\n\n        // Build the pre-resolved entries map from the document cache\n        // (populated by `resolveContentEntries` on the server).\n        const embedded = cache?.contentEntries as Record<string, unknown> | undefined;\n        const resolvedEntries = embedded ? new Map(Object.entries(embedded)) : undefined;\n\n        const resolver = new ContentEntryBindingsResolver(\n            new BindingsResolver(state),\n            resolvedEntries,\n            this.contentEntryCache\n        );\n\n        const instances = resolver.resolveElement({\n            element,\n            elementBindings,\n            inputAst: ComponentManifestToAstConverter.convert(blueprint.manifest.inputs ?? []),\n            onResolved\n        });\n\n        return instances.map(instance => ({\n            component: blueprint.component,\n            manifest: blueprint.manifest!,\n            styles: instance.styles,\n            inputs: instance.inputs\n        }));\n    }\n}\n"],"names":["ComponentResolver","registry","cache","contentEntryCache","element","elementBindings","onResolved","state","componentName","blueprint","logger","embedded","resolvedEntries","Map","Object","undefined","resolver","ContentEntryBindingsResolver","BindingsResolver","instances","ComponentManifestToAstConverter","instance"],"mappings":";;;;;AAuBO,MAAMA;IAIT,YAAYC,QAA2B,EAAEC,QAA2BC,iBAAiB,CAAE;QACnF,IAAI,CAAC,UAAU,GAAGF;QAClB,IAAI,CAAC,iBAAiB,GAAGC;IAC7B;IAEA,QAAQ,EACJE,OAAO,EACPC,kBAAkB,CAAC,CAAC,EACpBC,UAAU,EACVC,KAAK,EACLL,KAAK,EACc,EAA8B;QACjD,MAAMM,gBAAgBJ,QAAQ,SAAS,CAAC,IAAI;QAC5C,MAAMK,YAAY,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD;QAEtC,IAAI,CAACC,WAAW;YACZC,OAAO,IAAI,CAAC,CAAC,mBAAmB,EAAEF,eAAe;YACjD,OAAO;QACX;QAIA,MAAMG,WAAWT,OAAO;QACxB,MAAMU,kBAAkBD,WAAW,IAAIE,IAAIC,OAAO,OAAO,CAACH,aAAaI;QAEvE,MAAMC,WAAW,IAAIC,6BACjB,IAAIC,iBAAiBX,QACrBK,iBACA,IAAI,CAAC,iBAAiB;QAG1B,MAAMO,YAAYH,SAAS,cAAc,CAAC;YACtCZ;YACAC;YACA,UAAUe,gCAAgC,OAAO,CAACX,UAAU,QAAQ,CAAC,MAAM,IAAI,EAAE;YACjFH;QACJ;QAEA,OAAOa,UAAU,GAAG,CAACE,CAAAA,WAAa;gBAC9B,WAAWZ,UAAU,SAAS;gBAC9B,UAAUA,UAAU,QAAQ;gBAC5B,QAAQY,SAAS,MAAM;gBACvB,QAAQA,SAAS,MAAM;YAC3B;IACJ;AACJ"}

package/ContentSdk.d.ts

@@ -1,9 +1,17 @@
-import type { Component, IContentSdk, ListPagesOptions, ListPagesResult, PublicPage, PublicRedirect, ResolvedComponent } from "./types.js";
+import type { Component, Document, IContentSdk, ListPagesOptions, ListPagesResult, PublicPage, PublicRedirect, ResolvedComponent } from "./types.js";
+import type { ActiveExperiment, VariantContent } from "./experiments/types.js";
+import { type ExperimentRenderResult, type GetPageWithExperimentOptions } from "./experiments/render.js";
 import { LiveSdk } from "./LiveSdk.js";
 import { EditingSdk } from "./EditingSdk.js";
 import { type ResolveElementParams } from "./ComponentResolver.js";
+import type { ComponentRegistry } from "./ComponentRegistry.js";
+import type { ContentEntryCache } from "./contentEntry/ContentEntryCache.js";
+import type { DocumentStoreManager } from "./DocumentStoreManager.js";
 import type { WebsiteBuilderThemeInput } from "./types/WebsiteBuilderTheme.js";
 import type { IRedirects } from "./IRedirects.js";
+import type { HeadersProvider } from "./headersProvider.js";
+import type { ContentEntryLoader } from "./contentEntry/resolveContentEntry.js";
+import type { ComponentLoaderFactory } from "./componentLoader/ComponentLoader.js";
 export type ApiConfig = {
     apiKey: string;
     apiHost: string;
@@ -11,7 +19,36 @@ export type ApiConfig = {
 };
 export type ContentSDKConfig = ApiConfig & {
     preview?: boolean;
+    previewParams?: string;
     theme?: WebsiteBuilderThemeInput;
+    /**
+     * Request headers for server-side preview and experiments. When omitted, the provider set
+     * with `setHeadersProvider` is used. Meant for apps that serve requests outside the
+     * framework hook; it never carries the tenant.
+     */
+    headersProvider?: HeadersProvider;
+    /**
+     * Loads the CMS entries that `contentEntry` inputs reference, for this SDK's content
+     * entry cache. Pass one bound to the same tenant as this SDK. When omitted, the cache's
+     * loader is left as it is.
+     */
+    contentEntryLoader?: ContentEntryLoader;
+    /**
+     * Creates the loader for components a document references but nobody registered. It gets
+     * this SDK's API client and API config. When omitted, the default set with
+     * `setDefaultComponentLoader` is used (`@webiny/sdk-nextjs` sets its remote component
+     * loading), and without one nothing is loaded.
+     */
+    componentLoader?: ComponentLoaderFactory;
+};
+/**
+ * The state a `ContentSdk` renders with. Each piece defaults to its module-level singleton, so
+ * `new ContentSdk()` shares state with `contentSdk`. `createContentClient` passes new instances.
+ */
+export type ContentSdkState = {
+    componentRegistry?: ComponentRegistry;
+    contentEntryCache?: ContentEntryCache;
+    documentStoreManager?: DocumentStoreManager;
 };
 declare class InternalContentSdk implements IContentSdk, IRedirects {
     private activeSdk;
@@ -28,17 +65,46 @@ export declare class ContentSdk implements IContentSdk, IRedirects {
     protected sdk?: InternalContentSdk;
     private isPreview;
     private lastConfig;
+    private dataProvider?;
+    private headersProvider?;
+    private componentLoaderFactory?;
+    private componentLoaderParams?;
+    private componentLoader?;
+    private readonly componentRegistry;
+    private readonly contentEntryCache;
+    private readonly documentStoreManager;
+    constructor(state?: ContentSdkState);
     init(config: ContentSDKConfig, afterInit?: () => void): void;
     getEditingSdk(): EditingSdk | undefined;
     getPage(path: string): Promise<PublicPage | null>;
+    getPageExperiment(path: string): Promise<ActiveExperiment | null>;
+    getVariantContent(variantId: string): Promise<VariantContent | null>;
+    getExperimentPaused(experimentId: string): Promise<boolean>;
+    /**
+     * Resolve and render the right page for the current visitor (control or a variant),
+     * server-side. Bucketing, targeting, exposure emission, and cache-key handling are all
+     * encapsulated here so projects do not reimplement them. See {@link getPageWithExperiment}.
+     */
+    getPageWithExperiment(path: string, options?: GetPageWithExperimentOptions): Promise<ExperimentRenderResult>;
     listPages(options?: ListPagesOptions): Promise<ListPagesResult>;
     getAllRedirects(): Promise<Map<string, PublicRedirect>>;
     getRedirectByPath(path: string): Promise<PublicRedirect | undefined>;
     registerComponent(blueprint: Component): void;
     resolveElement(params: ResolveElementParams): ResolvedComponent[] | null;
+    /**
+     * Load every component the document references that isn't registered yet, through the
+     * component loader, and register what it returns. Call it before rendering the document.
+     * Nothing is cached here: an unregistered component goes to the loader on every call.
+     */
+    loadDocumentComponents(document: Document): Promise<void>;
+    private getComponentLoader;
+    getComponentRegistry(): ComponentRegistry;
+    getContentEntryCache(): ContentEntryCache;
+    getDocumentStoreManager(): DocumentStoreManager;
     isEditing(): boolean;
     isPreviewing(): boolean;
     private assertInitialized;
+    private requireDataProvider;
 }
 export declare const contentSdk: ContentSdk;
 export {};

package/ContentSdk.js

@@ -1,14 +1,18 @@
+import { getPageWithExperiment } from "./experiments/render.js";
 import { environment } from "./Environment.js";
 import { LiveSdk } from "./LiveSdk.js";
 import { EditingSdk } from "./EditingSdk.js";
 import { ComponentResolver } from "./ComponentResolver.js";
 import { PreviewSdk } from "./PreviewSdk.js";
 import { componentRegistry } from "./ComponentRegistry.js";
+import { contentEntryCache } from "./contentEntry/ContentEntryCache.js";
+import { documentStoreManager } from "./DocumentStoreManager.js";
 import { ApiClient } from "./dataProviders/ApiClient.js";
 import { DefaultDataProvider } from "./dataProviders/DefaultDataProvider.js";
 import { Theme } from "./Theme.js";
 import { viewportManager } from "./ViewportManager.js";
 import { RedirectsProvider } from "./dataProviders/RedirectsProvider.js";
+import { createComponentLoader } from "./componentLoader/createComponentLoader.js";
 class InternalContentSdk {
     constructor(redirectsProvider, liveSdk, editingSdk){
         this.redirectsProvider = redirectsProvider;
@@ -32,23 +36,50 @@ class InternalContentSdk {
     }
 }
 class ContentSdk {
+    constructor(state = {}){
+        this.isPreview = false;
+        this.componentRegistry = state.componentRegistry ?? componentRegistry;
+        this.contentEntryCache = state.contentEntryCache ?? contentEntryCache;
+        this.documentStoreManager = state.documentStoreManager ?? documentStoreManager;
+    }
     init(config, afterInit) {
         const configHash = JSON.stringify(config);
         if (this.lastConfig && this.lastConfig === configHash) return;
         this.lastConfig = configHash;
-        const apiClient = new ApiClient(config.apiHost, config.apiKey, config.apiTenant);
+        this.headersProvider = config.headersProvider;
+        if (config.contentEntryLoader) this.contentEntryCache.setLoader(config.contentEntryLoader);
+        const apiClient = new ApiClient({
+            apiHost: config.apiHost,
+            apiKey: config.apiKey,
+            apiTenant: config.apiTenant,
+            preview: config.preview
+        });
         const dataProvider = new DefaultDataProvider({
             apiClient
         });
-        let liveSdk = new LiveSdk(dataProvider);
+        this.componentLoaderFactory = config.componentLoader;
+        this.componentLoaderParams = {
+            apiClient,
+            config: {
+                apiHost: config.apiHost,
+                apiKey: config.apiKey,
+                apiTenant: config.apiTenant
+            }
+        };
+        this.componentLoader = void 0;
+        this.dataProvider = dataProvider;
+        let liveSdk = new LiveSdk(dataProvider, this.documentStoreManager);
         if (config.preview && !environment.isEditing()) {
             this.isPreview = true;
-            liveSdk = new PreviewSdk(dataProvider, liveSdk);
+            liveSdk = new PreviewSdk(dataProvider, liveSdk, config.previewParams, config.headersProvider);
         }
         const theme = Theme.from(config.theme ?? {});
         if (environment.isClient()) viewportManager.setBreakpoints(theme.breakpoints);
         let editingSdk;
-        if (environment.isEditing()) editingSdk = new EditingSdk(liveSdk, theme);
+        if (environment.isEditing()) editingSdk = new EditingSdk(liveSdk, theme, {
+            componentRegistry: this.componentRegistry,
+            documentStoreManager: this.documentStoreManager
+        });
         this.sdk = new InternalContentSdk(new RedirectsProvider(apiClient), liveSdk, editingSdk);
         if ("function" == typeof afterInit) afterInit();
     }
@@ -60,6 +91,29 @@ class ContentSdk {
         this.assertInitialized();
         return this.sdk.getPage(path);
     }
+    getPageExperiment(path) {
+        return this.requireDataProvider().getPageExperiment(path);
+    }
+    getVariantContent(variantId) {
+        return this.requireDataProvider().getVariantContent(variantId);
+    }
+    getExperimentPaused(experimentId) {
+        return this.requireDataProvider().getExperimentPaused(experimentId);
+    }
+    getPageWithExperiment(path, options) {
+        this.assertInitialized();
+        this.requireDataProvider();
+        const experimentOptions = {
+            ...options
+        };
+        if (this.headersProvider && !experimentOptions.headersProvider) experimentOptions.headersProvider = this.headersProvider;
+        return getPageWithExperiment({
+            getPage: (p)=>this.getPage(p),
+            getPageExperiment: (p)=>this.getPageExperiment(p),
+            getVariantContent: (id)=>this.getVariantContent(id),
+            getExperimentPaused: (id)=>this.getExperimentPaused(id)
+        }, path, experimentOptions);
+    }
     listPages(options) {
         this.assertInitialized();
         return this.sdk.listPages(options);
@@ -74,11 +128,38 @@ class ContentSdk {
     }
     registerComponent(blueprint) {
         this.assertInitialized();
-        componentRegistry.register(blueprint);
+        this.componentRegistry.register(blueprint);
     }
     resolveElement(params) {
         this.assertInitialized();
-        return new ComponentResolver(componentRegistry).resolve(params);
+        return new ComponentResolver(this.componentRegistry, this.contentEntryCache).resolve(params);
+    }
+    async loadDocumentComponents(document) {
+        this.assertInitialized();
+        const names = new Set();
+        for (const element of Object.values(document.elements)){
+            const name = element.component?.name;
+            if (name && !this.componentRegistry.get(name)) names.add(name);
+        }
+        const loader = this.getComponentLoader();
+        const loads = Array.from(names).map((name)=>loader.loadComponent({
+                name
+            }));
+        const components = await Promise.all(loads);
+        for (const component of components)if (component) this.componentRegistry.register(component);
+    }
+    getComponentLoader() {
+        if (!this.componentLoader) this.componentLoader = createComponentLoader(this.componentLoaderFactory, this.componentLoaderParams);
+        return this.componentLoader;
+    }
+    getComponentRegistry() {
+        return this.componentRegistry;
+    }
+    getContentEntryCache() {
+        return this.contentEntryCache;
+    }
+    getDocumentStoreManager() {
+        return this.documentStoreManager;
     }
     isEditing() {
         return environment.isEditing();
@@ -89,8 +170,9 @@ class ContentSdk {
     assertInitialized() {
         if (!this.sdk) throw new Error("ContentSdk has not been initialized!");
     }
-    constructor(){
-        this.isPreview = false;
+    requireDataProvider() {
+        if (!this.dataProvider) throw new Error("ContentSdk has not been initialized!");
+        return this.dataProvider;
     }
 }
 const contentSdk = new ContentSdk();

package/ContentSdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContentSdk.js","sources":["../src/ContentSdk.ts"],"sourcesContent":["import type {\n    Component,\n    IContentSdk,\n    ListPagesOptions,\n    ListPagesResult,\n    PublicPage,\n    PublicRedirect,\n    ResolvedComponent\n} from \"~/types.js\";\nimport { environment } from \"./Environment.js\";\nimport { LiveSdk } from \"./LiveSdk.js\";\nimport { EditingSdk } from \"./EditingSdk.js\";\nimport { ComponentResolver, type ResolveElementParams } from \"~/ComponentResolver.js\";\nimport { PreviewSdk } from \"./PreviewSdk.js\";\nimport { componentRegistry } from \"~/ComponentRegistry.js\";\nimport { ApiClient } from \"~/dataProviders/ApiClient.js\";\nimport { DefaultDataProvider } from \"~/dataProviders/DefaultDataProvider.js\";\nimport type { WebsiteBuilderThemeInput } from \"./types/WebsiteBuilderTheme.js\";\nimport { Theme } from \"./Theme.js\";\nimport { viewportManager } from \"./ViewportManager.js\";\nimport type { IRedirects } from \"~/IRedirects.js\";\nimport { RedirectsProvider } from \"~/dataProviders/RedirectsProvider.js\";\n\nexport type ApiConfig = {\n    apiKey: string;\n    apiHost: string;\n    apiTenant: string;\n};\n\nexport type ContentSDKConfig = ApiConfig & {\n    preview?: boolean;\n    theme?: WebsiteBuilderThemeInput;\n};\n\nclass InternalContentSdk implements IContentSdk, IRedirects {\n    private activeSdk: IContentSdk;\n    private editingSdk: EditingSdk | undefined;\n    private redirectsProvider: IRedirects;\n\n    constructor(redirectsProvider: IRedirects, liveSdk: LiveSdk, editingSdk?: EditingSdk) {\n        this.redirectsProvider = redirectsProvider;\n        this.activeSdk = editingSdk ?? liveSdk;\n        this.editingSdk = editingSdk;\n    }\n\n    getEditingSdk() {\n        return this.editingSdk;\n    }\n\n    async getPage(path: string): Promise<PublicPage | null> {\n        return this.activeSdk.getPage(path);\n    }\n\n    listPages(options?: ListPagesOptions): Promise<ListPagesResult> {\n        return this.activeSdk.listPages(options);\n    }\n\n    getAllRedirects(): Promise<Map<string, PublicRedirect>> {\n        return this.redirectsProvider.getAllRedirects();\n    }\n\n    getRedirectByPath(path: string): Promise<PublicRedirect | undefined> {\n        return this.redirectsProvider.getRedirectByPath(path);\n    }\n}\n\nexport class ContentSdk implements IContentSdk, IRedirects {\n    protected sdk?: InternalContentSdk;\n    private isPreview = false;\n    private lastConfig: any;\n\n    public init(config: ContentSDKConfig, afterInit?: () => void): void {\n        const configHash = JSON.stringify(config);\n        if (this.lastConfig && this.lastConfig === configHash) {\n            return;\n        }\n\n        this.lastConfig = configHash;\n        const apiClient = new ApiClient(config.apiHost, config.apiKey, config.apiTenant);\n\n        const dataProvider = new DefaultDataProvider({ apiClient });\n\n        let liveSdk: IContentSdk = new LiveSdk(dataProvider);\n\n        if (config.preview && !environment.isEditing()) {\n            this.isPreview = true;\n            liveSdk = new PreviewSdk(dataProvider, liveSdk);\n        }\n\n        const theme = Theme.from(config.theme ?? {});\n\n        if (environment.isClient()) {\n            viewportManager.setBreakpoints(theme.breakpoints);\n        }\n\n        let editingSdk;\n        if (environment.isEditing()) {\n            editingSdk = new EditingSdk(liveSdk, theme);\n        }\n\n        this.sdk = new InternalContentSdk(\n            new RedirectsProvider(apiClient),\n            liveSdk as LiveSdk,\n            editingSdk\n        );\n\n        if (typeof afterInit === \"function\") {\n            afterInit();\n        }\n    }\n\n    public getEditingSdk() {\n        this.assertInitialized();\n        return this.sdk.getEditingSdk();\n    }\n\n    public getPage(path: string) {\n        this.assertInitialized();\n        return this.sdk.getPage(path);\n    }\n\n    public listPages(options?: ListPagesOptions) {\n        this.assertInitialized();\n        return this.sdk.listPages(options);\n    }\n\n    public async getAllRedirects() {\n        this.assertInitialized();\n        return this.sdk.getAllRedirects();\n    }\n\n    getRedirectByPath(path: string): Promise<PublicRedirect | undefined> {\n        this.assertInitialized();\n        return this.sdk.getRedirectByPath(path);\n    }\n\n    registerComponent(blueprint: Component): void {\n        this.assertInitialized();\n        componentRegistry.register(blueprint);\n    }\n\n    resolveElement(params: ResolveElementParams): ResolvedComponent[] | null {\n        this.assertInitialized();\n        return new ComponentResolver(componentRegistry).resolve(params);\n    }\n\n    isEditing() {\n        return environment.isEditing();\n    }\n\n    isPreviewing() {\n        return this.isPreview;\n    }\n\n    private assertInitialized(): asserts this is this & {\n        sdk: IContentSdk;\n    } {\n        if (!this.sdk) {\n            throw new Error(`ContentSdk has not been initialized!`);\n        }\n    }\n}\n\nexport const contentSdk = new ContentSdk();\n"],"names":["InternalContentSdk","redirectsProvider","liveSdk","editingSdk","path","options","ContentSdk","config","afterInit","configHash","JSON","apiClient","ApiClient","dataProvider","DefaultDataProvider","LiveSdk","environment","PreviewSdk","theme","Theme","viewportManager","EditingSdk","RedirectsProvider","blueprint","componentRegistry","params","ComponentResolver","Error","contentSdk"],"mappings":";;;;;;;;;;;AAkCA,MAAMA;IAKF,YAAYC,iBAA6B,EAAEC,OAAgB,EAAEC,UAAuB,CAAE;QAClF,IAAI,CAAC,iBAAiB,GAAGF;QACzB,IAAI,CAAC,SAAS,GAAGE,cAAcD;QAC/B,IAAI,CAAC,UAAU,GAAGC;IACtB;IAEA,gBAAgB;QACZ,OAAO,IAAI,CAAC,UAAU;IAC1B;IAEA,MAAM,QAAQC,IAAY,EAA8B;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAACA;IAClC;IAEA,UAAUC,OAA0B,EAA4B;QAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAACA;IACpC;IAEA,kBAAwD;QACpD,OAAO,IAAI,CAAC,iBAAiB,CAAC,eAAe;IACjD;IAEA,kBAAkBD,IAAY,EAAuC;QACjE,OAAO,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAACA;IACpD;AACJ;AAEO,MAAME;IAKF,KAAKC,MAAwB,EAAEC,SAAsB,EAAQ;QAChE,MAAMC,aAAaC,KAAK,SAAS,CAACH;QAClC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,KAAKE,YACvC;QAGJ,IAAI,CAAC,UAAU,GAAGA;QAClB,MAAME,YAAY,IAAIC,UAAUL,OAAO,OAAO,EAAEA,OAAO,MAAM,EAAEA,OAAO,SAAS;QAE/E,MAAMM,eAAe,IAAIC,oBAAoB;YAAEH;QAAU;QAEzD,IAAIT,UAAuB,IAAIa,QAAQF;QAEvC,IAAIN,OAAO,OAAO,IAAI,CAACS,YAAY,SAAS,IAAI;YAC5C,IAAI,CAAC,SAAS,GAAG;YACjBd,UAAU,IAAIe,WAAWJ,cAAcX;QAC3C;QAEA,MAAMgB,QAAQC,MAAM,IAAI,CAACZ,OAAO,KAAK,IAAI,CAAC;QAE1C,IAAIS,YAAY,QAAQ,IACpBI,gBAAgB,cAAc,CAACF,MAAM,WAAW;QAGpD,IAAIf;QACJ,IAAIa,YAAY,SAAS,IACrBb,aAAa,IAAIkB,WAAWnB,SAASgB;QAGzC,IAAI,CAAC,GAAG,GAAG,IAAIlB,mBACX,IAAIsB,kBAAkBX,YACtBT,SACAC;QAGJ,IAAI,AAAqB,cAArB,OAAOK,WACPA;IAER;IAEO,gBAAgB;QACnB,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa;IACjC;IAEO,QAAQJ,IAAY,EAAE;QACzB,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAACA;IAC5B;IAEO,UAAUC,OAA0B,EAAE;QACzC,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAACA;IAC9B;IAEA,MAAa,kBAAkB;QAC3B,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe;IACnC;IAEA,kBAAkBD,IAAY,EAAuC;QACjE,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAACA;IACtC;IAEA,kBAAkBmB,SAAoB,EAAQ;QAC1C,IAAI,CAAC,iBAAiB;QACtBC,kBAAkB,QAAQ,CAACD;IAC/B;IAEA,eAAeE,MAA4B,EAA8B;QACrE,IAAI,CAAC,iBAAiB;QACtB,OAAO,IAAIC,kBAAkBF,mBAAmB,OAAO,CAACC;IAC5D;IAEA,YAAY;QACR,OAAOT,YAAY,SAAS;IAChC;IAEA,eAAe;QACX,OAAO,IAAI,CAAC,SAAS;IACzB;IAEQ,oBAEN;QACE,IAAI,CAAC,IAAI,CAAC,GAAG,EACT,MAAM,IAAIW,MAAM;IAExB;;aA5FQ,SAAS,GAAG;;AA6FxB;AAEO,MAAMC,aAAa,IAAItB"}
+{"version":3,"file":"ContentSdk.js","sources":["../src/ContentSdk.ts"],"sourcesContent":["import type {\n    Component,\n    Document,\n    IContentSdk,\n    IDataProvider,\n    ListPagesOptions,\n    ListPagesResult,\n    PublicPage,\n    PublicRedirect,\n    ResolvedComponent\n} from \"~/types.js\";\nimport type { ActiveExperiment, VariantContent } from \"~/experiments/types.js\";\nimport {\n    getPageWithExperiment,\n    type ExperimentRenderResult,\n    type GetPageWithExperimentOptions\n} from \"~/experiments/render.js\";\nimport { environment } from \"./Environment.js\";\nimport { LiveSdk } from \"./LiveSdk.js\";\nimport { EditingSdk } from \"./EditingSdk.js\";\nimport { ComponentResolver, type ResolveElementParams } from \"~/ComponentResolver.js\";\nimport { PreviewSdk } from \"./PreviewSdk.js\";\nimport type { ComponentRegistry } from \"~/ComponentRegistry.js\";\nimport { componentRegistry } from \"~/ComponentRegistry.js\";\nimport type { ContentEntryCache } from \"~/contentEntry/ContentEntryCache.js\";\nimport { contentEntryCache } from \"~/contentEntry/ContentEntryCache.js\";\nimport type { DocumentStoreManager } from \"~/DocumentStoreManager.js\";\nimport { documentStoreManager } from \"~/DocumentStoreManager.js\";\nimport { ApiClient } from \"~/dataProviders/ApiClient.js\";\nimport { DefaultDataProvider } from \"~/dataProviders/DefaultDataProvider.js\";\nimport type { WebsiteBuilderThemeInput } from \"./types/WebsiteBuilderTheme.js\";\nimport { Theme } from \"./Theme.js\";\nimport { viewportManager } from \"./ViewportManager.js\";\nimport type { IRedirects } from \"~/IRedirects.js\";\nimport { RedirectsProvider } from \"~/dataProviders/RedirectsProvider.js\";\nimport type { HeadersProvider } from \"~/headersProvider.js\";\nimport type { ContentEntryLoader } from \"~/contentEntry/resolveContentEntry.js\";\nimport type { ComponentLoader, ComponentLoaderFactory } from \"~/componentLoader/ComponentLoader.js\";\nimport type { ComponentLoaderFactoryParams } from \"~/componentLoader/ComponentLoader.js\";\nimport { createComponentLoader } from \"~/componentLoader/createComponentLoader.js\";\n\nexport type ApiConfig = {\n    apiKey: string;\n    apiHost: string;\n    apiTenant: string;\n};\n\nexport type ContentSDKConfig = ApiConfig & {\n    preview?: boolean;\n    previewParams?: string;\n    theme?: WebsiteBuilderThemeInput;\n    /**\n     * Request headers for server-side preview and experiments. When omitted, the provider set\n     * with `setHeadersProvider` is used. Meant for apps that serve requests outside the\n     * framework hook; it never carries the tenant.\n     */\n    headersProvider?: HeadersProvider;\n    /**\n     * Loads the CMS entries that `contentEntry` inputs reference, for this SDK's content\n     * entry cache. Pass one bound to the same tenant as this SDK. When omitted, the cache's\n     * loader is left as it is.\n     */\n    contentEntryLoader?: ContentEntryLoader;\n    /**\n     * Creates the loader for components a document references but nobody registered. It gets\n     * this SDK's API client and API config. When omitted, the default set with\n     * `setDefaultComponentLoader` is used (`@webiny/sdk-nextjs` sets its remote component\n     * loading), and without one nothing is loaded.\n     */\n    componentLoader?: ComponentLoaderFactory;\n};\n\n/**\n * The state a `ContentSdk` renders with. Each piece defaults to its module-level singleton, so\n * `new ContentSdk()` shares state with `contentSdk`. `createContentClient` passes new instances.\n */\nexport type ContentSdkState = {\n    componentRegistry?: ComponentRegistry;\n    contentEntryCache?: ContentEntryCache;\n    documentStoreManager?: DocumentStoreManager;\n};\n\nclass InternalContentSdk implements IContentSdk, IRedirects {\n    private activeSdk: IContentSdk;\n    private editingSdk: EditingSdk | undefined;\n    private redirectsProvider: IRedirects;\n\n    constructor(redirectsProvider: IRedirects, liveSdk: LiveSdk, editingSdk?: EditingSdk) {\n        this.redirectsProvider = redirectsProvider;\n        this.activeSdk = editingSdk ?? liveSdk;\n        this.editingSdk = editingSdk;\n    }\n\n    getEditingSdk() {\n        return this.editingSdk;\n    }\n\n    async getPage(path: string): Promise<PublicPage | null> {\n        return this.activeSdk.getPage(path);\n    }\n\n    listPages(options?: ListPagesOptions): Promise<ListPagesResult> {\n        return this.activeSdk.listPages(options);\n    }\n\n    getAllRedirects(): Promise<Map<string, PublicRedirect>> {\n        return this.redirectsProvider.getAllRedirects();\n    }\n\n    getRedirectByPath(path: string): Promise<PublicRedirect | undefined> {\n        return this.redirectsProvider.getRedirectByPath(path);\n    }\n}\n\nexport class ContentSdk implements IContentSdk, IRedirects {\n    protected sdk?: InternalContentSdk;\n    private isPreview = false;\n    private lastConfig: any;\n    private dataProvider?: IDataProvider;\n    private headersProvider?: HeadersProvider;\n    private componentLoaderFactory?: ComponentLoaderFactory;\n    private componentLoaderParams?: ComponentLoaderFactoryParams;\n    private componentLoader?: ComponentLoader;\n    private readonly componentRegistry: ComponentRegistry;\n    private readonly contentEntryCache: ContentEntryCache;\n    private readonly documentStoreManager: DocumentStoreManager;\n\n    constructor(state: ContentSdkState = {}) {\n        this.componentRegistry = state.componentRegistry ?? componentRegistry;\n        this.contentEntryCache = state.contentEntryCache ?? contentEntryCache;\n        this.documentStoreManager = state.documentStoreManager ?? documentStoreManager;\n    }\n\n    public init(config: ContentSDKConfig, afterInit?: () => void): void {\n        const configHash = JSON.stringify(config);\n        if (this.lastConfig && this.lastConfig === configHash) {\n            return;\n        }\n\n        this.lastConfig = configHash;\n        this.headersProvider = config.headersProvider;\n        if (config.contentEntryLoader) {\n            this.contentEntryCache.setLoader(config.contentEntryLoader);\n        }\n        const apiClient = new ApiClient({\n            apiHost: config.apiHost,\n            apiKey: config.apiKey,\n            apiTenant: config.apiTenant,\n            preview: config.preview\n        });\n\n        const dataProvider = new DefaultDataProvider({ apiClient });\n\n        // The loader is created on first use, so a default set after this call still applies.\n        this.componentLoaderFactory = config.componentLoader;\n        this.componentLoaderParams = {\n            apiClient,\n            config: {\n                apiHost: config.apiHost,\n                apiKey: config.apiKey,\n                apiTenant: config.apiTenant\n            }\n        };\n        this.componentLoader = undefined;\n        this.dataProvider = dataProvider;\n\n        let liveSdk: IContentSdk = new LiveSdk(dataProvider, this.documentStoreManager);\n\n        if (config.preview && !environment.isEditing()) {\n            this.isPreview = true;\n            liveSdk = new PreviewSdk(\n                dataProvider,\n                liveSdk,\n                config.previewParams,\n                config.headersProvider\n            );\n        }\n\n        const theme = Theme.from(config.theme ?? {});\n\n        if (environment.isClient()) {\n            viewportManager.setBreakpoints(theme.breakpoints);\n        }\n\n        let editingSdk;\n        if (environment.isEditing()) {\n            editingSdk = new EditingSdk(liveSdk, theme, {\n                componentRegistry: this.componentRegistry,\n                documentStoreManager: this.documentStoreManager\n            });\n        }\n\n        this.sdk = new InternalContentSdk(\n            new RedirectsProvider(apiClient),\n            liveSdk as LiveSdk,\n            editingSdk\n        );\n\n        if (typeof afterInit === \"function\") {\n            afterInit();\n        }\n    }\n\n    public getEditingSdk() {\n        this.assertInitialized();\n        return this.sdk.getEditingSdk();\n    }\n\n    public getPage(path: string) {\n        this.assertInitialized();\n        return this.sdk.getPage(path);\n    }\n\n    public getPageExperiment(path: string): Promise<ActiveExperiment | null> {\n        return this.requireDataProvider().getPageExperiment(path);\n    }\n\n    public getVariantContent(variantId: string): Promise<VariantContent | null> {\n        return this.requireDataProvider().getVariantContent(variantId);\n    }\n\n    public getExperimentPaused(experimentId: string): Promise<boolean> {\n        return this.requireDataProvider().getExperimentPaused(experimentId);\n    }\n\n    /**\n     * Resolve and render the right page for the current visitor (control or a variant),\n     * server-side. Bucketing, targeting, exposure emission, and cache-key handling are all\n     * encapsulated here so projects do not reimplement them. See {@link getPageWithExperiment}.\n     */\n    public getPageWithExperiment(\n        path: string,\n        options?: GetPageWithExperimentOptions\n    ): Promise<ExperimentRenderResult> {\n        this.assertInitialized();\n        this.requireDataProvider();\n        const experimentOptions: GetPageWithExperimentOptions = { ...options };\n        if (this.headersProvider && !experimentOptions.headersProvider) {\n            experimentOptions.headersProvider = this.headersProvider;\n        }\n        return getPageWithExperiment(\n            {\n                getPage: p => this.getPage(p),\n                getPageExperiment: p => this.getPageExperiment(p),\n                getVariantContent: id => this.getVariantContent(id),\n                getExperimentPaused: id => this.getExperimentPaused(id)\n            },\n            path,\n            experimentOptions\n        );\n    }\n\n    public listPages(options?: ListPagesOptions) {\n        this.assertInitialized();\n        return this.sdk.listPages(options);\n    }\n\n    public async getAllRedirects() {\n        this.assertInitialized();\n        return this.sdk.getAllRedirects();\n    }\n\n    getRedirectByPath(path: string): Promise<PublicRedirect | undefined> {\n        this.assertInitialized();\n        return this.sdk.getRedirectByPath(path);\n    }\n\n    registerComponent(blueprint: Component): void {\n        this.assertInitialized();\n        this.componentRegistry.register(blueprint);\n    }\n\n    resolveElement(params: ResolveElementParams): ResolvedComponent[] | null {\n        this.assertInitialized();\n        return new ComponentResolver(this.componentRegistry, this.contentEntryCache).resolve(\n            params\n        );\n    }\n\n    /**\n     * Load every component the document references that isn't registered yet, through the\n     * component loader, and register what it returns. Call it before rendering the document.\n     * Nothing is cached here: an unregistered component goes to the loader on every call.\n     */\n    public async loadDocumentComponents(document: Document): Promise<void> {\n        this.assertInitialized();\n        const names = new Set<string>();\n        for (const element of Object.values(document.elements)) {\n            const name = element.component?.name;\n            if (name && !this.componentRegistry.get(name)) {\n                names.add(name);\n            }\n        }\n\n        const loader = this.getComponentLoader();\n        const loads = Array.from(names).map(name => loader.loadComponent({ name }));\n        const components = await Promise.all(loads);\n\n        for (const component of components) {\n            if (component) {\n                this.componentRegistry.register(component);\n            }\n        }\n    }\n\n    private getComponentLoader(): ComponentLoader {\n        if (!this.componentLoader) {\n            this.componentLoader = createComponentLoader(\n                this.componentLoaderFactory,\n                this.componentLoaderParams!\n            );\n        }\n        return this.componentLoader;\n    }\n\n    public getComponentRegistry(): ComponentRegistry {\n        return this.componentRegistry;\n    }\n\n    public getContentEntryCache(): ContentEntryCache {\n        return this.contentEntryCache;\n    }\n\n    public getDocumentStoreManager(): DocumentStoreManager {\n        return this.documentStoreManager;\n    }\n\n    isEditing() {\n        return environment.isEditing();\n    }\n\n    isPreviewing() {\n        return this.isPreview;\n    }\n\n    private assertInitialized(): asserts this is this & {\n        sdk: IContentSdk;\n    } {\n        if (!this.sdk) {\n            throw new Error(`ContentSdk has not been initialized!`);\n        }\n    }\n\n    private requireDataProvider(): IDataProvider {\n        if (!this.dataProvider) {\n            throw new Error(`ContentSdk has not been initialized!`);\n        }\n        return this.dataProvider;\n    }\n}\n\nexport const contentSdk = new ContentSdk();\n"],"names":["InternalContentSdk","redirectsProvider","liveSdk","editingSdk","path","options","ContentSdk","state","componentRegistry","contentEntryCache","documentStoreManager","config","afterInit","configHash","JSON","apiClient","ApiClient","dataProvider","DefaultDataProvider","undefined","LiveSdk","environment","PreviewSdk","theme","Theme","viewportManager","EditingSdk","RedirectsProvider","variantId","experimentId","experimentOptions","getPageWithExperiment","p","id","blueprint","params","ComponentResolver","document","names","Set","element","Object","name","loader","loads","Array","components","Promise","component","createComponentLoader","Error","contentSdk"],"mappings":"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"}

package/DocumentStoreManager.d.ts

@@ -1,11 +1,18 @@
 import type { Document } from "./types.js";
 import { DocumentStore } from "./DocumentStore.js";
-declare class DocumentStoreManager {
+export declare const DEFAULT_MAX_DOCUMENT_STORES = 10000;
+export type DocumentStoreManagerOptions = {
+    maxEntries?: number;
+};
+export declare class DocumentStoreManager {
     private stores;
+    private readonly maxEntries;
+    constructor(options?: DocumentStoreManagerOptions);
     getStores(): Map<string, DocumentStore<Document>>;
     getStore<TDocument extends Document>(id: string): DocumentStore<TDocument>;
     removeStore(id: string): void;
     hasStore(id: string): boolean;
+    clear(): void;
+    private evict;
 }
 export declare const documentStoreManager: DocumentStoreManager;
-export {};

package/DocumentStoreManager.js

@@ -1,11 +1,24 @@
 import { DocumentStore } from "./DocumentStore.js";
+const DEFAULT_MAX_DOCUMENT_STORES = 10000;
 class DocumentStoreManager {
+    constructor(options = {}){
+        this.stores = new Map();
+        this.maxEntries = options.maxEntries ?? DEFAULT_MAX_DOCUMENT_STORES;
+    }
     getStores() {
         return this.stores;
     }
     getStore(id) {
-        if (!this.stores.has(id)) this.stores.set(id, new DocumentStore());
-        return this.stores.get(id);
+        const existing = this.stores.get(id);
+        if (existing) {
+            this.stores.delete(id);
+            this.stores.set(id, existing);
+            return existing;
+        }
+        const store = new DocumentStore();
+        this.stores.set(id, store);
+        this.evict();
+        return store;
     }
     removeStore(id) {
         this.stores.delete(id);
@@ -13,11 +26,17 @@ class DocumentStoreManager {
     hasStore(id) {
         return this.stores.has(id);
     }
-    constructor(){
-        this.stores = new Map();
+    clear() {
+        this.stores.clear();
+    }
+    evict() {
+        while(this.stores.size > this.maxEntries){
+            const oldest = this.stores.keys().next().value;
+            this.stores.delete(oldest);
+        }
     }
 }
 const documentStoreManager = new DocumentStoreManager();
-export { documentStoreManager };
+export { DEFAULT_MAX_DOCUMENT_STORES, DocumentStoreManager, documentStoreManager };
 
 //# sourceMappingURL=DocumentStoreManager.js.map

package/DocumentStoreManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentStoreManager.js","sources":["../src/DocumentStoreManager.ts"],"sourcesContent":["import type { Document } from \"./types.js\";\nimport { DocumentStore } from \"./DocumentStore.js\";\n\nclass DocumentStoreManager {\n    private stores = new Map<string, DocumentStore>();\n\n    getStores() {\n        return this.stores;\n    }\n\n    getStore<TDocument extends Document>(id: string): DocumentStore<TDocument> {\n        if (!this.stores.has(id)) {\n            this.stores.set(id, new DocumentStore<TDocument>());\n        }\n        return this.stores.get(id)! as DocumentStore<TDocument>;\n    }\n\n    removeStore(id: string) {\n        this.stores.delete(id);\n    }\n\n    hasStore(id: string): boolean {\n        return this.stores.has(id);\n    }\n}\n\nexport const documentStoreManager = new DocumentStoreManager();\n"],"names":["DocumentStoreManager","id","DocumentStore","Map","documentStoreManager"],"mappings":";AAGA,MAAMA;IAGF,YAAY;QACR,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,SAAqCC,EAAU,EAA4B;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA,KACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA,IAAI,IAAIC;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAACD;IAC3B;IAEA,YAAYA,EAAU,EAAE;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAACA;IACvB;IAEA,SAASA,EAAU,EAAW;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA;IAC3B;;aAnBQ,MAAM,GAAG,IAAIE;;AAoBzB;AAEO,MAAMC,uBAAuB,IAAIJ"}
+{"version":3,"file":"DocumentStoreManager.js","sources":["../src/DocumentStoreManager.ts"],"sourcesContent":["import type { Document } from \"./types.js\";\nimport { DocumentStore } from \"./DocumentStore.js\";\n\n// High enough that an app serving one site never reaches it.\nexport const DEFAULT_MAX_DOCUMENT_STORES = 10_000;\n\nexport type DocumentStoreManagerOptions = {\n    // Stores kept before the least recently used one is dropped.\n    maxEntries?: number;\n};\n\nexport class DocumentStoreManager {\n    private stores = new Map<string, DocumentStore>();\n    private readonly maxEntries: number;\n\n    constructor(options: DocumentStoreManagerOptions = {}) {\n        this.maxEntries = options.maxEntries ?? DEFAULT_MAX_DOCUMENT_STORES;\n    }\n\n    getStores() {\n        return this.stores;\n    }\n\n    getStore<TDocument extends Document>(id: string): DocumentStore<TDocument> {\n        const existing = this.stores.get(id);\n        if (existing) {\n            // Move it to the end, so the map stays ordered from least to most recently used.\n            this.stores.delete(id);\n            this.stores.set(id, existing);\n            return existing as DocumentStore<TDocument>;\n        }\n\n        const store = new DocumentStore<TDocument>();\n        this.stores.set(id, store);\n        this.evict();\n        return store;\n    }\n\n    removeStore(id: string) {\n        this.stores.delete(id);\n    }\n\n    hasStore(id: string): boolean {\n        return this.stores.has(id);\n    }\n\n    clear() {\n        this.stores.clear();\n    }\n\n    private evict() {\n        while (this.stores.size > this.maxEntries) {\n            const oldest = this.stores.keys().next().value!;\n            this.stores.delete(oldest);\n        }\n    }\n}\n\nexport const documentStoreManager = new DocumentStoreManager();\n"],"names":["DEFAULT_MAX_DOCUMENT_STORES","DocumentStoreManager","options","Map","id","existing","store","DocumentStore","oldest","documentStoreManager"],"mappings":";AAIO,MAAMA,8BAA8B;AAOpC,MAAMC;IAIT,YAAYC,UAAuC,CAAC,CAAC,CAAE;aAH/C,MAAM,GAAG,IAAIC;QAIjB,IAAI,CAAC,UAAU,GAAGD,QAAQ,UAAU,IAAIF;IAC5C;IAEA,YAAY;QACR,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,SAAqCI,EAAU,EAA4B;QACvE,MAAMC,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAACD;QACjC,IAAIC,UAAU;YAEV,IAAI,CAAC,MAAM,CAAC,MAAM,CAACD;YACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA,IAAIC;YACpB,OAAOA;QACX;QAEA,MAAMC,QAAQ,IAAIC;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAACH,IAAIE;QACpB,IAAI,CAAC,KAAK;QACV,OAAOA;IACX;IAEA,YAAYF,EAAU,EAAE;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAACA;IACvB;IAEA,SAASA,EAAU,EAAW;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAACA;IAC3B;IAEA,QAAQ;QACJ,IAAI,CAAC,MAAM,CAAC,KAAK;IACrB;IAEQ,QAAQ;QACZ,MAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAE;YACvC,MAAMI,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,KAAK;YAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAACA;QACvB;IACJ;AACJ;AAEO,MAAMC,uBAAuB,IAAIR"}

package/EditingSdk.d.ts

@@ -1,6 +1,12 @@
 import type { ComponentGroup, IContentSdk, ListPagesOptions, ListPagesResult, PublicPage } from "./types.js";
 import { Messenger } from "./messenger/index.js";
+import type { ComponentRegistry } from "./ComponentRegistry.js";
+import type { DocumentStoreManager } from "./DocumentStoreManager.js";
 import type { WebsiteBuilderTheme } from "./types/WebsiteBuilderTheme.js";
+export type EditingSdkState = {
+    componentRegistry?: ComponentRegistry;
+    documentStoreManager?: DocumentStoreManager;
+};
 export declare class EditingSdk implements IContentSdk {
     readonly messenger: Messenger;
     private positionReportingEnabled;
@@ -9,7 +15,7 @@ export declare class EditingSdk implements IContentSdk {
     private documentStore;
     private previewDocument;
     private lastBoxesHash;
-    constructor(liveSdk: IContentSdk, theme: WebsiteBuilderTheme);
+    constructor(liveSdk: IContentSdk, theme: WebsiteBuilderTheme, state?: EditingSdkState);
     getPage(path: string): Promise<PublicPage | null>;
     listPages(options?: ListPagesOptions): Promise<ListPagesResult>;
     registerComponentGroup(group: ComponentGroup): void;

package/EditingSdk.js

@@ -9,17 +9,19 @@ import { documentStoreManager } from "./DocumentStoreManager.js";
 import { PreviewDocument } from "./PreviewDocument.js";
 import { hashObject } from "./HashObject.js";
 class EditingSdk {
-    constructor(liveSdk, theme){
+    constructor(liveSdk, theme, state = {}){
         this.positionReportingEnabled = false;
         this.previewViewport = null;
         this.lastBoxesHash = 0;
         this.liveSdk = liveSdk;
+        const registry = state.componentRegistry ?? componentRegistry;
+        const stores = state.documentStoreManager ?? documentStoreManager;
         const source = new MessageOrigin(()=>window, window.location.origin);
         const target = new MessageOrigin(()=>window.parent, this.getReferrerOrigin());
         this.previewDocument = PreviewDocument.createFromWindow();
-        this.documentStore = documentStoreManager.getStore(this.previewDocument.getId());
+        this.documentStore = stores.getStore(this.previewDocument.getId());
         this.messenger = new Messenger(source, target, "wb.editor.*");
-        componentRegistry.onRegister((reg)=>{
+        registry.onRegister((reg)=>{
             this.messenger.send("preview.component.register", reg.component.manifest);
         });
         this.setupListeners();