@croct/plug-react 0.7.1 → 0.8.0

package/components/Personalization/index.js

@@ -1,7 +1,7 @@
 "use strict";
 'use client';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Personalization = void 0;
+exports.Personalization = Personalization;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const hooks_1 = require("../../hooks");
@@ -10,5 +10,4 @@ function Personalization(props) {
     const result = (0, hooks_1.useEvaluation)(query, options);
     return ((0, jsx_runtime_1.jsx)(react_1.Fragment, { children: children(result) }));
 }
-exports.Personalization = Personalization;
 //# sourceMappingURL=index.js.map

package/components/Personalization/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/Personalization/index.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;AAEb,iCAA6C;AAE7C,uCAAgE;AAgBhE,SAAgB,eAAe,CAAO,KAA4C;IAC9E,MAAM,EAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAC,GAAG,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAA,qBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,CAAC,uBAAC,gBAAQ,cAAE,QAAQ,CAAC,MAAM,CAAC,GAAY,CAAC,CAAC;AACrD,CAAC;AALD,0CAKC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/Personalization/index.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAoBb,0CAKC;;AAvBD,iCAA6C;AAE7C,uCAAgE;AAgBhE,SAAgB,eAAe,CAAO,KAA4C;IAC9E,MAAM,EAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAC,GAAG,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAA,qBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,CAAC,uBAAC,gBAAQ,cAAE,QAAQ,CAAC,MAAM,CAAC,GAAY,CAAC,CAAC;AACrD,CAAC"}

package/hash.d.ts

@@ -0,0 +1 @@
+export declare function hash(value: string): string;

package/hash.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hash = hash;
+function hash(value) {
+    let code = 0;
+    for (const char of value) {
+        const charCode = char.charCodeAt(0);
+        code = (code << 5) - code + charCode;
+        code |= 0; // Convert to 32bit integer
+    }
+    return code.toString(16);
+}
+//# sourceMappingURL=hash.js.map

package/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["src/hash.ts"],"names":[],"mappings":";;AAAA,oBAWC;AAXD,SAAgB,IAAI,CAAC,KAAa;IAC9B,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAEpC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,2BAA2B;IAC1C,CAAC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/hooks/useContent.js

@@ -4,11 +4,17 @@ exports.useContent = void 0;
 const useLoader_1 = require("./useLoader");
 const useCroct_1 = require("./useCroct");
 const ssr_polyfills_1 = require("../ssr-polyfills");
+const hash_1 = require("../hash");
 function useCsrContent(id, options = {}) {
+    var _a;
     const { fallback, initial, cacheKey, expiration, ...fetchOptions } = options;
+    const { preferredLocale } = fetchOptions;
     const croct = (0, useCroct_1.useCroct)();
     return (0, useLoader_1.useLoader)({
-        cacheKey: `useContent:${cacheKey !== null && cacheKey !== void 0 ? cacheKey : ''}:${id}`,
+        cacheKey: (0, hash_1.hash)(`useContent:${cacheKey !== null && cacheKey !== void 0 ? cacheKey : ''}`
+            + `:${id}`
+            + `:${preferredLocale !== null && preferredLocale !== void 0 ? preferredLocale : ''}`
+            + `:${JSON.stringify((_a = fetchOptions.attributes) !== null && _a !== void 0 ? _a : '')}`),
         loader: () => croct.fetch(id, fetchOptions).then(({ content }) => content),
         initial: initial,
         fallback: fallback,
@@ -17,7 +23,8 @@ function useCsrContent(id, options = {}) {
 }
 function useSsrContent(_, { initial } = {}) {
     if (initial === undefined) {
-        throw new Error('The initial value is required for server-side rendering (SSR).');
+        throw new Error('The initial content is required for server-side rendering (SSR). '
+            + 'For help, see https://croct.help/sdk/react/missing-slot-content');
     }
     return initial;
 }

package/hooks/useContent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContent.js","sourceRoot":"","sources":["../src/hooks/useContent.ts"],"names":[],"mappings":";;;AAGA,2CAAsC;AACtC,yCAAoC;AACpC,oDAAuC;AASvC,SAAS,aAAa,CAClB,EAAmB,EACnB,UAAmC,EAAE;IAErC,MAAM,EAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,YAAY,EAAC,GAAG,OAAO,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAA,mBAAQ,GAAE,CAAC;IAEzB,OAAO,IAAA,qBAAS,EAAC;QACb,QAAQ,EAAE,cAAc,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAC,OAAO,EAAC,EAAE,EAAE,CAAC,OAAO,CAAC;QACxE,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAClB,CAAkB,EAClB,EAAC,OAAO,KAA6B,EAAE;IAEvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AA6BY,QAAA,UAAU,GAAmB,IAAA,qBAAK,GAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC"}
+{"version":3,"file":"useContent.js","sourceRoot":"","sources":["../src/hooks/useContent.ts"],"names":[],"mappings":";;;AAGA,2CAAsC;AACtC,yCAAoC;AACpC,oDAAuC;AACvC,kCAA6B;AAS7B,SAAS,aAAa,CAClB,EAAmB,EACnB,UAAmC,EAAE;;IAErC,MAAM,EAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,YAAY,EAAC,GAAG,OAAO,CAAC;IAC3E,MAAM,EAAC,eAAe,EAAC,GAAG,YAAY,CAAC;IACvC,MAAM,KAAK,GAAG,IAAA,mBAAQ,GAAE,CAAC;IAEzB,OAAO,IAAA,qBAAS,EAAC;QACb,QAAQ,EAAE,IAAA,WAAI,EACV,cAAc,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,EAAE;cAC5B,IAAI,EAAE,EAAE;cACR,IAAI,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,EAAE,EAAE;cAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAA,YAAY,CAAC,UAAU,mCAAI,EAAE,CAAC,EAAE,CACxD;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAC,OAAO,EAAC,EAAE,EAAE,CAAC,OAAO,CAAC;QACxE,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAClB,CAAkB,EAClB,EAAC,OAAO,KAA6B,EAAE;IAEvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,mEAAmE;cACjE,iEAAiE,CACtE,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AA6BY,QAAA,UAAU,GAAmB,IAAA,qBAAK,GAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC"}

package/hooks/useCroct.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useCroct = void 0;
+exports.useCroct = useCroct;
 const react_1 = require("react");
 const CroctProvider_1 = require("../CroctProvider");
 function useCroct() {
     const context = (0, react_1.useContext)(CroctProvider_1.CroctContext);
     if (context === null) {
-        throw new Error('useCroct() can only be used in the context of a <CroctProvider> component.');
+        throw new Error('useCroct() can only be used in the context of a <CroctProvider> component. '
+            + 'For help, see https://croct.help/sdk/react/missing-provider');
     }
     return context.plug;
 }
-exports.useCroct = useCroct;
 //# sourceMappingURL=useCroct.js.map

package/hooks/useCroct.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCroct.js","sourceRoot":"","sources":["../src/hooks/useCroct.ts"],"names":[],"mappings":";;;AACA,iCAAiC;AACjC,oDAA8C;AAE9C,SAAgB,QAAQ;IACpB,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,4BAAY,CAAC,CAAC;IAEzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC;AARD,4BAQC"}
+{"version":3,"file":"useCroct.js","sourceRoot":"","sources":["../src/hooks/useCroct.ts"],"names":[],"mappings":";;AAIA,4BAWC;AAdD,iCAAiC;AACjC,oDAA8C;AAE9C,SAAgB,QAAQ;IACpB,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,4BAAY,CAAC,CAAC;IAEzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACX,6EAA6E;cAC3E,6DAA6D,CAClE,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC;AACxB,CAAC"}

package/hooks/useEvaluation.js

@@ -4,6 +4,7 @@ exports.useEvaluation = void 0;
 const useLoader_1 = require("./useLoader");
 const useCroct_1 = require("./useCroct");
 const ssr_polyfills_1 = require("../ssr-polyfills");
+const hash_1 = require("../hash");
 function cleanEvaluationOptions(options) {
     const result = {};
     for (const [key, value] of Object.entries(options)) {
@@ -18,7 +19,9 @@ function useCsrEvaluation(query, options = {}) {
     const { cacheKey, fallback, initial, expiration, ...evaluationOptions } = options;
     const croct = (0, useCroct_1.useCroct)();
     return (0, useLoader_1.useLoader)({
-        cacheKey: `useEvaluation:${cacheKey !== null && cacheKey !== void 0 ? cacheKey : ''}:${query}:${JSON.stringify((_a = options.attributes) !== null && _a !== void 0 ? _a : '')}`,
+        cacheKey: (0, hash_1.hash)(`useEvaluation:${cacheKey !== null && cacheKey !== void 0 ? cacheKey : ''}`
+            + `:${query}`
+            + `:${JSON.stringify((_a = options.attributes) !== null && _a !== void 0 ? _a : '')}`),
         loader: () => croct.evaluate(query, cleanEvaluationOptions(evaluationOptions)),
         initial: initial,
         fallback: fallback,
@@ -27,7 +30,8 @@ function useCsrEvaluation(query, options = {}) {
 }
 function useSsrEvaluation(_, { initial } = {}) {
     if (initial === undefined) {
-        throw new Error('The initial value is required for server-side rendering (SSR).');
+        throw new Error('The initial value is required for server-side rendering (SSR). '
+            + 'For help, see https://croct.help/sdk/react/missing-evaluation-result');
     }
     return initial;
 }

package/hooks/useEvaluation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEvaluation.js","sourceRoot":"","sources":["../src/hooks/useEvaluation.ts"],"names":[],"mappings":";;;AAEA,2CAAsC;AACtC,yCAAoC;AACpC,oDAAuC;AAEvC,SAAS,sBAAsB,CAAC,OAA0B;IACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAA0C,EAAE,CAAC;QAC1F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAcD,SAAS,gBAAgB,CACrB,KAAa,EACb,UAAsC,EAAE;;IAExC,MAAM,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,iBAAiB,EAAC,GAAG,OAAO,CAAC;IAChF,MAAM,KAAK,GAAG,IAAA,mBAAQ,GAAE,CAAC;IAEzB,OAAO,IAAA,qBAAS,EAAY;QACxB,QAAQ,EAAE,iBAAiB,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,MAAA,OAAO,CAAC,UAAU,mCAAI,EAAE,CAAC,EAAE;QAChG,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAgB,KAAK,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;QAC7F,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,gBAAgB,CACrB,CAAS,EACT,EAAC,OAAO,KAAgC,EAAE;IAE1C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAEY,QAAA,aAAa,GAAsB,IAAA,qBAAK,GAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC"}
+{"version":3,"file":"useEvaluation.js","sourceRoot":"","sources":["../src/hooks/useEvaluation.ts"],"names":[],"mappings":";;;AAEA,2CAAsC;AACtC,yCAAoC;AACpC,oDAAuC;AACvC,kCAA6B;AAE7B,SAAS,sBAAsB,CAAC,OAA0B;IACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAA0C,EAAE,CAAC;QAC1F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAcD,SAAS,gBAAgB,CACrB,KAAa,EACb,UAAsC,EAAE;;IAExC,MAAM,EAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,iBAAiB,EAAC,GAAG,OAAO,CAAC;IAChF,MAAM,KAAK,GAAG,IAAA,mBAAQ,GAAE,CAAC;IAEzB,OAAO,IAAA,qBAAS,EAAY;QACxB,QAAQ,EAAE,IAAA,WAAI,EACV,iBAAiB,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,EAAE;cAC/B,IAAI,KAAK,EAAE;cACX,IAAI,IAAI,CAAC,SAAS,CAAC,MAAA,OAAO,CAAC,UAAU,mCAAI,EAAE,CAAC,EAAE,CACnD;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAgB,KAAK,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;QAC7F,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC;AACP,CAAC;AAED,SAAS,gBAAgB,CACrB,CAAS,EACT,EAAC,OAAO,KAAgC,EAAE;IAE1C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,iEAAiE;cAC/D,sEAAsE,CAC3E,CAAC;IACN,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAEY,QAAA,aAAa,GAAsB,IAAA,qBAAK,GAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC"}

package/hooks/useLoader.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useLoader = void 0;
+exports.useLoader = useLoader;
 const react_1 = require("react");
 const Cache_1 = require("./Cache");
 const cache = new Cache_1.Cache(60 * 1000);
@@ -37,5 +37,4 @@ function useLoader({ initial, ...options }) {
     }
     return value;
 }
-exports.useLoader = useLoader;
 //# sourceMappingURL=useLoader.js.map

package/hooks/useLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLoader.js","sourceRoot":"","sources":["../src/hooks/useLoader.ts"],"names":[],"mappings":";;;AAAA,iCAAkD;AAClD,mCAA4C;AAE5C,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAMnC,SAAgB,SAAS,CAAI,EAAC,OAAO,EAAE,GAAG,OAAO,EAAkB;;IAC/D,MAAM,WAAW,GAAgB,MAAA,KAAK,CAAC,GAAG,CAAI,OAAO,CAAC,QAAQ,CAAC,0CAAE,MAAM,CAAC;IACxE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEvE,IAAA,iBAAS,EACL,GAAG,EAAE;QACD,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC;gBACD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,MAAe,EAAE,CAAC;gBACvB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,aAAgB,EAAE,EAAE;wBAC7B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;4BACrB,QAAQ,CAAC,aAAa,CAAC,CAAC;wBAC5B,CAAC;oBACL,CAAC,CAAC,CAAC;oBAEH,OAAO;gBACX,CAAC;gBAED,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAEpB,OAAO;YACX,CAAC;QACL,CAAC;QAED,OAAO,GAAG,EAAE;YACR,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC/B,CAAC,CAAC;IACN,CAAC,EACD,EAAE,CACL,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAxCD,8BAwCC"}
+{"version":3,"file":"useLoader.js","sourceRoot":"","sources":["../src/hooks/useLoader.ts"],"names":[],"mappings":";;AASA,8BAwCC;AAjDD,iCAAkD;AAClD,mCAA4C;AAE5C,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAMnC,SAAgB,SAAS,CAAI,EAAC,OAAO,EAAE,GAAG,OAAO,EAAkB;;IAC/D,MAAM,WAAW,GAAgB,MAAA,KAAK,CAAC,GAAG,CAAI,OAAO,CAAC,QAAQ,CAAC,0CAAE,MAAM,CAAC;IACxE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEvE,IAAA,iBAAS,EACL,GAAG,EAAE;QACD,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC;gBACD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,MAAe,EAAE,CAAC;gBACvB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,aAAgB,EAAE,EAAE;wBAC7B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;4BACrB,QAAQ,CAAC,aAAa,CAAC,CAAC;wBAC5B,CAAC;oBACL,CAAC,CAAC,CAAC;oBAEH,OAAO;gBACX,CAAC;gBAED,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAEpB,OAAO;YACX,CAAC;QACL,CAAC;QAED,OAAO,GAAG,EAAE;YACR,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC/B,CAAC,CAAC;IACN,CAAC,EACD,EAAE,CACL,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@croct/plug-react",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "React components and hooks to plug your React applications into Croct.",
   "author": {
     "name": "Croct",
@@ -37,39 +37,39 @@
     "react-dom": "^16.8.0  || ^17.0.0 || ^18.0.0"
   },
   "dependencies": {
-    "@croct/plug": "^0.14.1",
-    "@croct/sdk": "^0.16.0"
+    "@croct/plug": "^0.16.0",
+    "@croct/sdk": "^0.17.2"
   },
   "devDependencies": {
-    "@babel/core": "^7.20.2",
-    "@babel/preset-env": "^7.20.2",
-    "@babel/preset-react": "^7.18.6",
-    "@babel/preset-typescript": "^7.18.6",
-    "@croct/eslint-plugin": "^0.7.0",
-    "@storybook/addon-actions": "^8.0.0",
-    "@storybook/addon-essentials": "^8.0.0",
-    "@storybook/addon-links": "^8.0.0",
-    "@storybook/builder-webpack5": "^8.0.0",
-    "@storybook/manager-webpack5": "^6.5.13",
-    "@storybook/react": "^8.0.0",
-    "@testing-library/jest-dom": "^6.0.0",
-    "@testing-library/react": "^15.0.0",
-    "@types/jest": "^29.2.3",
-    "@types/node": "^20.0.0",
-    "@types/react": "^18.0.25",
-    "@types/react-dom": "^18.0.9",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "babel-loader": "^9.1.0",
+    "@babel/core": "^7.25.2",
+    "@babel/preset-env": "^7.25.4",
+    "@babel/preset-react": "^7.24.7",
+    "@babel/preset-typescript": "^7.24.7",
+    "@croct/eslint-plugin": "^0.7.1",
+    "@storybook/addon-actions": "^8.2.9",
+    "@storybook/addon-essentials": "^8.2.9",
+    "@storybook/addon-links": "^8.2.9",
+    "@storybook/builder-webpack5": "^8.2.9",
+    "@storybook/manager-webpack5": "^6.5.16",
+    "@storybook/react": "^8.2.9",
+    "@testing-library/jest-dom": "^6.5.0",
+    "@testing-library/react": "^16.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.5.4",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "babel-loader": "^9.1.3",
     "eslint": "^8.57.0",
-    "jest": "^29.0.0",
-    "jest-environment-jsdom": "^29.0.0",
-    "jest-environment-node": "^29.0.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "ts-node": "^10.8.1",
-    "typescript": "^5.0.0",
-    "webpack": "^5.75.0"
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.2",
+    "webpack": "^5.94.0"
   },
   "files": [
     "**/*.js",

package/src/hash.test.ts

@@ -0,0 +1,22 @@
+import {hash} from './hash';
+
+describe('hash', () => {
+    it('should generate a hash from a string', () => {
+        const result = hash('foo');
+
+        expect(result).toEqual('18cc6');
+        expect(result).toEqual(hash('foo'));
+    });
+
+    it('should handle special characters', () => {
+        expect(hash('✨')).toEqual('2728');
+        expect(hash('💥')).toEqual('d83d');
+        expect(hash('✨💥')).toEqual('59615');
+    });
+
+    it('should generate a hash from an empty string', () => {
+        const result = hash('');
+
+        expect(result).toEqual('0');
+    });
+});

package/src/hash.ts

@@ -0,0 +1,12 @@
+export function hash(value: string): string {
+    let code = 0;
+
+    for (const char of value) {
+        const charCode = char.charCodeAt(0);
+
+        code = (code << 5) - code + charCode;
+        code |= 0; // Convert to 32bit integer
+    }
+
+    return code.toString(16);
+}

package/src/hooks/useContent.ssr.test.ts

@@ -18,6 +18,6 @@ describe('useContent (SSR)', () => {
 
     it('should require an initial value for server-side rending', () => {
         expect(() => useContent('slot-id'))
-            .toThrow(new Error('The initial value is required for server-side rendering (SSR).'));
+            .toThrow('The initial content is required for server-side rendering (SSR).');
     });
 });

package/src/hooks/useContent.test.ts

@@ -3,6 +3,7 @@ import {Plug} from '@croct/plug';
 import {useCroct} from './useCroct';
 import {useLoader} from './useLoader';
 import {useContent} from './useContent';
+import {hash} from '../hash';
 
 jest.mock(
     './useCroct',
@@ -30,11 +31,15 @@ describe('useContent (CSR)', () => {
         jest.mocked(useLoader).mockReturnValue('foo');
 
         const slotId = 'home-banner@1';
+        const preferredLocale = 'en';
+        const attributes = {example: 'value'};
+        const cacheKey = 'unique';
 
         const {result} = renderHook(
             () => useContent<{title: string}>(slotId, {
-                preferredLocale: 'en',
-                cacheKey: 'unique',
+                preferredLocale: preferredLocale,
+                attributes: attributes,
+                cacheKey: cacheKey,
                 fallback: {
                     title: 'error',
                 },
@@ -44,7 +49,7 @@ describe('useContent (CSR)', () => {
 
         expect(useCroct).toHaveBeenCalled();
         expect(useLoader).toHaveBeenCalledWith({
-            cacheKey: `useContent:unique:${slotId}`,
+            cacheKey: hash(`useContent:${cacheKey}:${slotId}:${preferredLocale}:${JSON.stringify(attributes)}`),
             fallback: {
                 title: 'error',
             },
@@ -59,6 +64,7 @@ describe('useContent (CSR)', () => {
 
         expect(fetch).toHaveBeenCalledWith(slotId, {
             preferredLocale: 'en',
+            attributes: attributes,
         });
 
         expect(result.current).toBe('foo');

package/src/hooks/useContent.ts

@@ -4,6 +4,7 @@ import {FetchOptions} from '@croct/plug/plug';
 import {useLoader} from './useLoader';
 import {useCroct} from './useCroct';
 import {isSsr} from '../ssr-polyfills';
+import {hash} from '../hash';
 
 export type UseContentOptions<I, F> = FetchOptions & {
     fallback?: F,
@@ -17,10 +18,16 @@ function useCsrContent<I, F>(
     options: UseContentOptions<I, F> = {},
 ): SlotContent | I | F {
     const {fallback, initial, cacheKey, expiration, ...fetchOptions} = options;
+    const {preferredLocale} = fetchOptions;
     const croct = useCroct();
 
     return useLoader({
-        cacheKey: `useContent:${cacheKey ?? ''}:${id}`,
+        cacheKey: hash(
+            `useContent:${cacheKey ?? ''}`
+            + `:${id}`
+            + `:${preferredLocale ?? ''}`
+            + `:${JSON.stringify(fetchOptions.attributes ?? '')}`,
+        ),
         loader: () => croct.fetch(id, fetchOptions).then(({content}) => content),
         initial: initial,
         fallback: fallback,
@@ -33,7 +40,10 @@ function useSsrContent<I, F>(
     {initial}: UseContentOptions<I, F> = {},
 ): SlotContent | I | F {
     if (initial === undefined) {
-        throw new Error('The initial value is required for server-side rendering (SSR).');
+        throw new Error(
+            'The initial content is required for server-side rendering (SSR). '
+            + 'For help, see https://croct.help/sdk/react/missing-slot-content',
+        );
     }
 
     return initial;

package/src/hooks/useCroct.ts

@@ -6,7 +6,10 @@ export function useCroct(): Plug {
     const context = useContext(CroctContext);
 
     if (context === null) {
-        throw new Error('useCroct() can only be used in the context of a <CroctProvider> component.');
+        throw new Error(
+            'useCroct() can only be used in the context of a <CroctProvider> component. '
+            + 'For help, see https://croct.help/sdk/react/missing-provider',
+        );
     }
 
     return context.plug;

package/src/hooks/useEvaluation.ssr.test.ts

@@ -18,6 +18,6 @@ describe('useEvaluation (SSR)', () => {
 
     it('should require an initial value for server-side rending', () => {
         expect(() => useEvaluation('location'))
-            .toThrow(new Error('The initial value is required for server-side rendering (SSR).'));
+            .toThrow('The initial value is required for server-side rendering (SSR).');
     });
 });

package/src/hooks/useEvaluation.test.ts

@@ -4,6 +4,7 @@ import {Plug} from '@croct/plug';
 import {useEvaluation} from './useEvaluation';
 import {useCroct} from './useCroct';
 import {useLoader} from './useLoader';
+import {hash} from '../hash';
 
 jest.mock(
     './useCroct',
@@ -39,11 +40,12 @@ describe('useEvaluation', () => {
         jest.mocked(useLoader).mockReturnValue('foo');
 
         const query = 'location';
+        const cacheKey = 'unique';
 
         const {result} = renderHook(
             () => useEvaluation(query, {
                 ...evaluationOptions,
-                cacheKey: 'unique',
+                cacheKey: cacheKey,
                 fallback: 'error',
                 expiration: 50,
             }),
@@ -51,7 +53,7 @@ describe('useEvaluation', () => {
 
         expect(useCroct).toHaveBeenCalled();
         expect(useLoader).toHaveBeenCalledWith({
-            cacheKey: 'useEvaluation:unique:location:{"foo":"bar"}',
+            cacheKey: hash(`useEvaluation:${cacheKey}:${query}:${JSON.stringify(evaluationOptions.attributes)}`),
             fallback: 'error',
             expiration: 50,
             loader: expect.any(Function),

package/src/hooks/useEvaluation.ts

@@ -3,6 +3,7 @@ import {EvaluationOptions} from '@croct/sdk/facade/evaluatorFacade';
 import {useLoader} from './useLoader';
 import {useCroct} from './useCroct';
 import {isSsr} from '../ssr-polyfills';
+import {hash} from '../hash';
 
 function cleanEvaluationOptions(options: EvaluationOptions): EvaluationOptions {
     const result: EvaluationOptions = {};
@@ -36,7 +37,11 @@ function useCsrEvaluation<T = JsonValue, I = T, F = T>(
     const croct = useCroct();
 
     return useLoader<T | I | F>({
-        cacheKey: `useEvaluation:${cacheKey ?? ''}:${query}:${JSON.stringify(options.attributes ?? '')}`,
+        cacheKey: hash(
+            `useEvaluation:${cacheKey ?? ''}`
+            + `:${query}`
+            + `:${JSON.stringify(options.attributes ?? '')}`,
+        ),
         loader: () => croct.evaluate<T & JsonValue>(query, cleanEvaluationOptions(evaluationOptions)),
         initial: initial,
         fallback: fallback,
@@ -49,7 +54,10 @@ function useSsrEvaluation<T = JsonValue, I = T, F = T>(
     {initial}: UseEvaluationOptions<I, F> = {},
 ): T | I | F {
     if (initial === undefined) {
-        throw new Error('The initial value is required for server-side rendering (SSR).');
+        throw new Error(
+            'The initial value is required for server-side rendering (SSR). '
+            + 'For help, see https://croct.help/sdk/react/missing-evaluation-result',
+        );
     }
 
     return initial;

package/src/ssr-polyfills.ts

@@ -62,7 +62,8 @@ export const croct: Plug = !isSsr()
                     throw new Error(
                         `Property croct.${String(property)} is not supported on server-side (SSR). `
                         + 'Consider refactoring  the logic as a side-effect (useEffect) or a client-side callback '
-                        + '(onClick, onChange, etc).',
+                        + '(onClick, onChange, etc). '
+                        + 'For help, see https://croct.help/sdk/react/client-logic-ssr',
                     );
             }
         },

package/ssr-polyfills.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.croct = exports.isSsr = void 0;
+exports.croct = void 0;
+exports.isSsr = isSsr;
 const plug_1 = __importDefault(require("@croct/plug"));
 function isSsr() {
     // eslint-disable-next-line @typescript-eslint/prefer-optional-chain -- The window can be undefined.
@@ -11,7 +12,6 @@ function isSsr() {
         || typeof window.document === 'undefined'
         || typeof window.document.createElement === 'undefined';
 }
-exports.isSsr = isSsr;
 exports.croct = !isSsr()
     ? (function factory() {
         let timeoutId = null;
@@ -58,7 +58,8 @@ exports.croct = !isSsr()
                 default:
                     throw new Error(`Property croct.${String(property)} is not supported on server-side (SSR). `
                         + 'Consider refactoring  the logic as a side-effect (useEffect) or a client-side callback '
-                        + '(onClick, onChange, etc).');
+                        + '(onClick, onChange, etc). '
+                        + 'For help, see https://croct.help/sdk/react/client-logic-ssr');
             }
         },
     });

package/ssr-polyfills.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-polyfills.js","sourceRoot":"","sources":["src/ssr-polyfills.ts"],"names":[],"mappings":";;;;;;AAAA,uDAA0C;AAE1C,SAAgB,KAAK;IACjB,oGAAoG;IACpG,OAAO,OAAO,MAAM,KAAK,WAAW;WAC7B,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW;WACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,KAAK,WAAW,CAAC;AAChE,CAAC;AALD,sBAKC;AAEY,QAAA,KAAK,GAAS,CAAC,KAAK,EAAE;IAC/B,CAAC,CAAC,CAAC,SAAS,OAAO;QACf,IAAI,SAAS,GAAuC,IAAI,CAAC;QACzD,IAAI,eAA2B,CAAC;QAChC,IAAI,cAAqC,CAAC;QAE1C,OAAO,IAAI,KAAK,CAAC,cAAO,EAAE;YACtB,GAAG,EAAE,SAAS,WAAW,CAAC,MAAM,EAAE,QAAoB;gBAClD,QAAQ,QAAQ,EAAE,CAAC;oBACf,KAAK,MAAM;wBACP,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;4BACrB,YAAY,CAAC,SAAS,CAAC,CAAC;4BACxB,SAAS,GAAG,IAAI,CAAC;4BACjB,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;wBACrD,CAAC;wBAED,MAAM;oBAEV,KAAK,QAAQ;wBACT,OAAO,GAAG,EAAE;4BACR,+EAA+E;4BAC/E,sFAAsF;4BACtF,oFAAoF;4BACpF,+DAA+D;4BAC/D,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC;4BAEzF,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gCACzC,eAAe,GAAG,OAAO,CAAC;gCAC1B,cAAc,GAAG,MAAM,CAAC;4BAC5B,CAAC,CAAC,CAAC;wBACP,CAAC,CAAC;gBACV,CAAC;gBAED,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;SACJ,CAAC,CAAC;IACP,CAAC,EAAE,CAAC;IACJ,CAAC,CAAC,IAAI,KAAK,CAAC,cAAO,EAAE;QACjB,GAAG,EAAE,SAAS,WAAW,CAAC,CAAC,EAAE,QAAoB;YAC7C,QAAQ,QAAQ,EAAE,CAAC;gBACf,KAAK,aAAa;oBACd,OAAO,KAAK,CAAC;gBAEjB,KAAK,MAAM;oBACP,OAAO,GAAG,EAAE;wBACR,QAAQ;oBACZ,CAAC,CAAC;gBAEN,KAAK,QAAQ;oBACT,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAEnC;oBACI,MAAM,IAAI,KAAK,CACX,kBAAkB,MAAM,CAAC,QAAQ,CAAC,0CAA0C;0BAC1E,yFAAyF;0BACzF,2BAA2B,CAChC,CAAC;YACV,CAAC;QACL,CAAC;KACJ,CAAC,CAAC"}
+{"version":3,"file":"ssr-polyfills.js","sourceRoot":"","sources":["src/ssr-polyfills.ts"],"names":[],"mappings":";;;;;;AAEA,sBAKC;AAPD,uDAA0C;AAE1C,SAAgB,KAAK;IACjB,oGAAoG;IACpG,OAAO,OAAO,MAAM,KAAK,WAAW;WAC7B,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW;WACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,KAAK,WAAW,CAAC;AAChE,CAAC;AAEY,QAAA,KAAK,GAAS,CAAC,KAAK,EAAE;IAC/B,CAAC,CAAC,CAAC,SAAS,OAAO;QACf,IAAI,SAAS,GAAuC,IAAI,CAAC;QACzD,IAAI,eAA2B,CAAC;QAChC,IAAI,cAAqC,CAAC;QAE1C,OAAO,IAAI,KAAK,CAAC,cAAO,EAAE;YACtB,GAAG,EAAE,SAAS,WAAW,CAAC,MAAM,EAAE,QAAoB;gBAClD,QAAQ,QAAQ,EAAE,CAAC;oBACf,KAAK,MAAM;wBACP,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;4BACrB,YAAY,CAAC,SAAS,CAAC,CAAC;4BACxB,SAAS,GAAG,IAAI,CAAC;4BACjB,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;wBACrD,CAAC;wBAED,MAAM;oBAEV,KAAK,QAAQ;wBACT,OAAO,GAAG,EAAE;4BACR,+EAA+E;4BAC/E,sFAAsF;4BACtF,oFAAoF;4BACpF,+DAA+D;4BAC/D,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC;4BAEzF,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gCACzC,eAAe,GAAG,OAAO,CAAC;gCAC1B,cAAc,GAAG,MAAM,CAAC;4BAC5B,CAAC,CAAC,CAAC;wBACP,CAAC,CAAC;gBACV,CAAC;gBAED,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;SACJ,CAAC,CAAC;IACP,CAAC,EAAE,CAAC;IACJ,CAAC,CAAC,IAAI,KAAK,CAAC,cAAO,EAAE;QACjB,GAAG,EAAE,SAAS,WAAW,CAAC,CAAC,EAAE,QAAoB;YAC7C,QAAQ,QAAQ,EAAE,CAAC;gBACf,KAAK,aAAa;oBACd,OAAO,KAAK,CAAC;gBAEjB,KAAK,MAAM;oBACP,OAAO,GAAG,EAAE;wBACR,QAAQ;oBACZ,CAAC,CAAC;gBAEN,KAAK,QAAQ;oBACT,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAEnC;oBACI,MAAM,IAAI,KAAK,CACX,kBAAkB,MAAM,CAAC,QAAQ,CAAC,0CAA0C;0BAC1E,yFAAyF;0BACzF,4BAA4B;0BAC5B,6DAA6D,CAClE,CAAC;YACV,CAAC;QACL,CAAC;KACJ,CAAC,CAAC"}