@croct/plug-react 0.4.2 → 0.5.0-next.2

package/index.js

@@ -1,339 +1,22 @@
-var jsxRuntime = require('react/jsx-runtime');
-var react = require('react');
-var csrPlug = require('@croct/plug');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var csrPlug__default = /*#__PURE__*/_interopDefaultLegacy(csrPlug);
-
-function _objectWithoutPropertiesLoose(source, excluded) {
-  if (source == null) return {};
-  var target = {};
-  var sourceKeys = Object.keys(source);
-  var key, i;
-
-  for (i = 0; i < sourceKeys.length; i++) {
-    key = sourceKeys[i];
-    if (excluded.indexOf(key) >= 0) continue;
-    target[key] = source[key];
-  }
-
-  return target;
-}
-
-function isSsr() {
-  return typeof window === 'undefined' || typeof window.document === 'undefined' || typeof window.document.createElement === 'undefined';
-}
-var croct = !isSsr() ? csrPlug__default["default"] : new Proxy(csrPlug__default["default"], {
-  get(_, property) {
-    switch (property) {
-      case 'initialized':
-        return false;
-
-      case 'plug':
-        return () => {// no-op
-        };
-
-      case 'unplug':
-        return () => Promise.resolve();
-
-      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).');
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-  }
-
-});
-
-var _excluded$4 = ["children"];
-var CroctContext = /*#__PURE__*/react.createContext(null);
-CroctContext.displayName = 'CroctContext';
-var CroctProvider = _ref => {
-  var {
-    children
-  } = _ref,
-      configuration = _objectWithoutPropertiesLoose(_ref, _excluded$4);
-
-  var parent = react.useContext(CroctContext);
-
-  if (parent !== null) {
-    throw new Error('You cannot render <CroctProvider> inside another <CroctProvider>. ' + 'Croct should only be initialized once in the application.');
-  }
-
-  var context = react.useMemo(() => ({
-    get plug() {
-      if (!croct.initialized) {
-        croct.plug(configuration);
-      }
-
-      return croct;
-    }
-
-  }), [configuration]);
-  react.useEffect(() => {
-    croct.plug(configuration);
-    return () => {
-      croct.unplug();
-    };
-  }, []);
-  return jsxRuntime.jsx(CroctContext.Provider, {
-    value: context,
-    children: children
-  });
-};
-
-class Cache {
-  constructor(defaultExpiration) {
-    this.cache = {};
-    this.defaultExpiration = void 0;
-    this.defaultExpiration = defaultExpiration;
-  }
-
-  load(configuration) {
-    var {
-      cacheKey,
-      loader,
-      fallback,
-      expiration = this.defaultExpiration
-    } = configuration;
-    var cachedEntry = this.get(cacheKey);
-
-    if (cachedEntry !== undefined) {
-      if (cachedEntry.error !== undefined) {
-        if (fallback !== undefined) {
-          return fallback;
-        }
-
-        throw cachedEntry.error;
-      }
-
-      if (cachedEntry.result !== undefined) {
-        return cachedEntry.result;
-      }
-
-      throw cachedEntry.promise;
-    }
-
-    var entry = {
-      dispose: () => {
-        if (entry.timeout !== undefined || expiration < 0) {
-          return;
-        }
-
-        entry.timeout = window.setTimeout(() => {
-          delete this.cache[cacheKey];
-        }, expiration);
-      },
-      promise: loader().then(result => {
-        entry.result = result;
-        return result;
-      }).catch(error => {
-        entry.error = error;
-      }).finally(() => {
-        entry.dispose();
-      })
-    };
-    this.cache[cacheKey] = entry;
-    throw entry.promise;
-  }
-
-  get(cacheKey) {
-    var entry = this.cache[cacheKey];
-
-    if (entry === undefined) {
-      return undefined;
-    }
-
-    if (entry.timeout !== undefined) {
-      clearTimeout(entry.timeout);
-      delete entry.timeout;
-      entry.dispose();
-    }
-
-    return entry;
-  }
-
-}
-
-var _excluded$3 = ["initial"];
-var cache = new Cache(60 * 1000);
-function useLoader(_ref) {
-  var _cache$get;
-
-  var {
-    initial
-  } = _ref,
-      options = _objectWithoutPropertiesLoose(_ref, _excluded$3);
-
-  var loadedValue = (_cache$get = cache.get(options.cacheKey)) == null ? void 0 : _cache$get.result;
-  var [value, setValue] = react.useState(loadedValue !== undefined ? loadedValue : initial);
-  var [isUnmounted, setUnmounted] = react.useState(false);
-  react.useEffect(() => {
-    if (initial !== undefined) {
-      try {
-        setValue(cache.load(options));
-      } catch (result) {
-        if (result instanceof Promise) {
-          result.then(resolvedValue => {
-            if (!isUnmounted) {
-              setValue(resolvedValue);
-            }
-          });
-          return;
-        }
-
-        setValue(undefined);
-        return;
-      }
-    }
-
-    return () => {
-      setUnmounted(true);
-    };
-  }, []);
-
-  if (value === undefined) {
-    return cache.load(options);
-  }
-
-  return value;
-}
-
-function useCroct() {
-  var context = react.useContext(CroctContext);
-
-  if (context === null) {
-    throw new Error('useCroct() can only be used in the context of a <CroctProvider> component.');
-  }
-
-  return context.plug;
-}
-
-var _excluded$2 = ["cacheKey", "fallback", "initial", "expiration"];
-
-function cleanEvaluationOptions(options) {
-  var result = {};
-
-  for (var [key, value] of Object.entries(options)) {
-    if (value !== undefined) {
-      result[key] = value;
-    }
-  }
-
-  return result;
-}
-
-function useCsrEvaluation(expression, options) {
-  var _options$attributes;
-
-  if (options === void 0) {
-    options = {};
-  }
-
-  var {
-    cacheKey,
-    fallback,
-    initial,
-    expiration
-  } = options,
-      evaluationOptions = _objectWithoutPropertiesLoose(options, _excluded$2);
-
-  var croct = useCroct();
-  return useLoader({
-    cacheKey: "useEvaluation:" + (cacheKey != null ? cacheKey : '') + ":" + expression + ":" + JSON.stringify((_options$attributes = options.attributes) != null ? _options$attributes : ''),
-    loader: () => croct.evaluate(expression, cleanEvaluationOptions(evaluationOptions)),
-    initial: initial,
-    fallback: fallback,
-    expiration: expiration
-  });
-}
-
-function useSsrEvaluation(_, _temp) {
-  var {
-    initial
-  } = _temp === void 0 ? {} : _temp;
-
-  if (initial === undefined) {
-    throw new Error('The initial value is required for server-side rendering (SSR).');
-  }
-
-  return initial;
-}
-
-var useEvaluation = isSsr() ? useSsrEvaluation : useCsrEvaluation;
-
-function useCsrContent(id, options) {
-  if (options === void 0) {
-    options = {};
-  }
-
-  var {
-    fallback,
-    initial,
-    cacheKey,
-    expiration
-  } = options;
-  var croct = useCroct();
-  return useLoader({
-    cacheKey: "useContent:" + (cacheKey != null ? cacheKey : '') + ":" + id,
-    loader: () => croct.fetch(id).then(_ref => {
-      var {
-        payload
-      } = _ref;
-      return payload;
-    }),
-    initial: initial,
-    fallback: fallback,
-    expiration: expiration
-  });
-}
-
-function useSsrContent(_, _temp) {
-  var {
-    initial
-  } = _temp === void 0 ? {} : _temp;
-
-  if (initial === undefined) {
-    throw new Error('The initial value is required for server-side rendering (SSR).');
-  }
-
-  return initial;
-}
-
-var useContent = isSsr() ? useSsrContent : useCsrContent;
-
-var _excluded$1 = ["expression", "children"];
-function Personalization(props) {
-  var {
-    expression,
-    children
-  } = props,
-      options = _objectWithoutPropertiesLoose(props, _excluded$1);
-
-  var result = useEvaluation(expression, options);
-  return jsxRuntime.jsx(react.Fragment, {
-    children: children(result)
-  });
-}
-
-var _excluded = ["id", "children"];
-var Slot = props => {
-  var {
-    id,
-    children
-  } = props,
-      options = _objectWithoutPropertiesLoose(props, _excluded);
-
-  var data = useContent(id, options);
-  return jsxRuntime.jsx(react.Fragment, {
-    children: children(data)
-  });
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-
-exports.CroctContext = CroctContext;
-exports.CroctProvider = CroctProvider;
-exports.Personalization = Personalization;
-exports.Slot = Slot;
-exports.useContent = useContent;
-exports.useCroct = useCroct;
-exports.useEvaluation = useEvaluation;
-//# sourceMappingURL=index.js.map
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@croct/plug/sdk/json"), exports);
+__exportStar(require("@croct/plug/slot"), exports);
+__exportStar(require("./CroctProvider"), exports);
+__exportStar(require("./hooks"), exports);
+__exportStar(require("./components"), exports);
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/ssr-polyfills.ts","../src/CroctProvider.tsx","../src/hooks/Cache.ts","../src/hooks/useLoader.ts","../src/hooks/useCroct.ts","../src/hooks/useEvaluation.ts","../src/hooks/useContent.ts","../src/components/Personalization/index.tsx","../src/components/Slot/index.tsx"],"sourcesContent":["import csrPlug, {Plug} from '@croct/plug';\n\nexport function isSsr(): boolean {\n    return typeof window === 'undefined'\n        || typeof window.document === 'undefined'\n        || typeof window.document.createElement === 'undefined';\n}\n\nexport const croct: Plug = !isSsr() ? csrPlug : new Proxy(csrPlug, {\n    get(_, property: keyof Plug) {\n        switch (property) {\n            case 'initialized':\n                return false;\n\n            case 'plug':\n                return () => {\n                    // no-op\n                };\n\n            case 'unplug':\n                return () => Promise.resolve();\n\n            default:\n                throw new Error(\n                    `Property croct.${String(property)} is not supported on server-side (SSR). Consider refactoring `\n                    + 'the logic as a side-effect (useEffect) or a client-side callback (onClick, onChange, etc).',\n                );\n        }\n    },\n});\n\n","import {createContext, FunctionComponent, PropsWithChildren, ReactElement, useContext, useEffect, useMemo} from 'react';\nimport {Configuration, Plug} from '@croct/plug';\nimport {croct} from './ssr-polyfills';\n\nexport type CroctProviderProps = PropsWithChildren<Configuration & Required<Pick<Configuration, 'appId'>>>;\n\nexport const CroctContext = createContext<{plug: Plug}|null>(null);\nCroctContext.displayName = 'CroctContext';\n\nexport const CroctProvider: FunctionComponent<CroctProviderProps> = ({children, ...configuration}): ReactElement => {\n    const parent = useContext(CroctContext);\n\n    if (parent !== null) {\n        throw new Error(\n            'You cannot render <CroctProvider> inside another <CroctProvider>. '\n            + 'Croct should only be initialized once in the application.',\n        );\n    }\n\n    const context = useMemo(() => ({\n        get plug() {\n            if (!croct.initialized) {\n                croct.plug(configuration);\n            }\n\n            return croct;\n        },\n    }), [configuration]);\n\n    useEffect(() => {\n        croct.plug(configuration);\n\n        return () => {\n            croct.unplug();\n        };\n    }, []);\n\n    return (\n        <CroctContext.Provider value={context}>\n            {children}\n        </CroctContext.Provider>\n    );\n};\n","export type EntryLoader<R> = (...args: any) => Promise<R>;\n\nexport type EntryOptions<R> = {\n    cacheKey: string,\n    loader: EntryLoader<R>,\n    fallback?: R,\n    expiration?: number,\n};\n\ntype Entry<R = any> = {\n    promise: Promise<any>,\n    result?: R,\n    dispose: () => void,\n    timeout?: number,\n    error?: any,\n};\n\nexport class Cache {\n    private readonly cache: Record<string, Entry> = {};\n\n    private readonly defaultExpiration: number;\n\n    public constructor(defaultExpiration: number) {\n        this.defaultExpiration = defaultExpiration;\n    }\n\n    public load<R>(configuration: EntryOptions<R>): R {\n        const {cacheKey, loader, fallback, expiration = this.defaultExpiration} = configuration;\n\n        const cachedEntry = this.get<R>(cacheKey);\n\n        if (cachedEntry !== undefined) {\n            if (cachedEntry.error !== undefined) {\n                if (fallback !== undefined) {\n                    return fallback;\n                }\n\n                throw cachedEntry.error;\n            }\n\n            if (cachedEntry.result !== undefined) {\n                return cachedEntry.result;\n            }\n\n            throw cachedEntry.promise;\n        }\n\n        const entry: Entry<R> = {\n            dispose: () => {\n                if (entry.timeout !== undefined || expiration < 0) {\n                    return;\n                }\n\n                entry.timeout = window.setTimeout(\n                    (): void => {\n                        delete this.cache[cacheKey];\n                    },\n                    expiration,\n                );\n            },\n            promise: loader()\n                .then((result): R => {\n                    entry.result = result;\n\n                    return result;\n                })\n                .catch(error => {\n                    entry.error = error;\n                })\n                .finally(() => {\n                    entry.dispose();\n                }),\n        };\n\n        this.cache[cacheKey] = entry;\n\n        throw entry.promise;\n    }\n\n    public get<R>(cacheKey: string): Entry<R>|undefined {\n        const entry = this.cache[cacheKey];\n\n        if (entry === undefined) {\n            return undefined;\n        }\n\n        if (entry.timeout !== undefined) {\n            clearTimeout(entry.timeout);\n\n            delete entry.timeout;\n\n            entry.dispose();\n        }\n\n        return entry;\n    }\n}\n","import {useEffect, useState} from 'react';\nimport {Cache, EntryOptions} from './Cache';\n\nconst cache = new Cache(60 * 1000);\n\nexport type CacheOptions<R> = EntryOptions<R> & {\n    initial?: R,\n};\n\nexport function useLoader<R>({initial, ...options}: CacheOptions<R>): R {\n    const loadedValue: R|undefined = cache.get<R>(options.cacheKey)?.result;\n    const [value, setValue] = useState(loadedValue !== undefined ? loadedValue : initial);\n    const [isUnmounted, setUnmounted] = useState(false);\n\n    useEffect(\n        () => {\n            if (initial !== undefined) {\n                try {\n                    setValue(cache.load(options));\n                } catch (result: unknown) {\n                    if (result instanceof Promise) {\n                        result.then((resolvedValue: R) => {\n                            if (!isUnmounted) {\n                                setValue(resolvedValue);\n                            }\n                        });\n\n                        return;\n                    }\n\n                    setValue(undefined);\n\n                    return;\n                }\n            }\n\n            return () => {\n                setUnmounted(true);\n            };\n        },\n        [],\n    );\n\n    if (value === undefined) {\n        return cache.load(options);\n    }\n\n    return value;\n}\n","import {Plug} from '@croct/plug';\nimport {useContext} from 'react';\nimport {CroctContext} from '../CroctProvider';\n\nexport function useCroct(): Plug {\n    const context = useContext(CroctContext);\n\n    if (context === null) {\n        throw new Error('useCroct() can only be used in the context of a <CroctProvider> component.');\n    }\n\n    return context.plug;\n}\n","import {JsonValue} from '@croct/plug/sdk/json';\nimport {EvaluationOptions} from '@croct/sdk/facade/evaluatorFacade';\nimport {useLoader} from './useLoader';\nimport {useCroct} from './useCroct';\nimport {isSsr} from '../ssr-polyfills';\n\nfunction cleanEvaluationOptions(options: EvaluationOptions): EvaluationOptions {\n    const result: EvaluationOptions = {};\n\n    for (const [key, value] of Object.entries(options)) {\n        if (value !== undefined) {\n            result[key] = value;\n        }\n    }\n\n    return result;\n}\n\nexport type UseEvaluationOptions<I, F> = EvaluationOptions & {\n    initial?: I,\n    fallback?: F,\n    cacheKey?: string,\n    expiration?: number,\n};\n\ntype UseEvaluationHook = <T extends JsonValue, I = T, F = T>(\n    expression: string,\n    options?: UseEvaluationOptions<I, F>,\n) => T | I | F;\n\nfunction useCsrEvaluation<T = JsonValue, I = T, F = T>(\n    expression: string,\n    options: UseEvaluationOptions<I, F> = {},\n): T | I | F {\n    const {cacheKey, fallback, initial, expiration, ...evaluationOptions} = options;\n    const croct = useCroct();\n\n    return useLoader<T | I | F>({\n        cacheKey: `useEvaluation:${cacheKey ?? ''}:${expression}:${JSON.stringify(options.attributes ?? '')}`,\n        loader: () => croct.evaluate<T & JsonValue>(expression, cleanEvaluationOptions(evaluationOptions)),\n        initial: initial,\n        fallback: fallback,\n        expiration: expiration,\n    });\n}\n\nfunction useSsrEvaluation<T = JsonValue, I = T, F = T>(\n    _: string,\n    {initial}: UseEvaluationOptions<I, F> = {},\n): T | I | F {\n    if (initial === undefined) {\n        throw new Error('The initial value is required for server-side rendering (SSR).');\n    }\n\n    return initial;\n}\n\nexport const useEvaluation: UseEvaluationHook = isSsr() ? useSsrEvaluation : useCsrEvaluation;\n","import {SlotContent, SlotId, SlotMap} from '@croct/plug/fetch';\nimport {NullableJsonObject} from '@croct/plug/sdk/json';\nimport {useLoader} from './useLoader';\nimport {useCroct} from './useCroct';\nimport {isSsr} from '../ssr-polyfills';\n\nexport type UseContentOptions<I, F> = {\n    fallback?: F,\n    initial?: I,\n    cacheKey?: string,\n    expiration?: number,\n};\n\nfunction useCsrContent<I, F>(id: SlotId, options: UseContentOptions<I, F> = {}): SlotContent<SlotId> | I | F {\n    const {fallback, initial, cacheKey, expiration} = options;\n    const croct = useCroct();\n\n    return useLoader({\n        cacheKey: `useContent:${cacheKey ?? ''}:${id}`,\n        loader: () => croct.fetch<SlotContent<SlotId>>(id).then(({payload}) => payload),\n        initial: initial,\n        fallback: fallback,\n        expiration: expiration,\n    });\n}\n\nfunction useSsrContent<I, F>(_: SlotId, {initial}: UseContentOptions<I, F> = {}): SlotContent<SlotId> | I | F {\n    if (initial === undefined) {\n        throw new Error('The initial value is required for server-side rendering (SSR).');\n    }\n\n    return initial;\n}\n\ntype UseContentHook = {\n    <P extends NullableJsonObject, I = P, F = P>(\n        id: keyof SlotMap extends never ? string : never,\n        options?: UseContentOptions<I, F>\n    ): P | I | F,\n\n    <S extends keyof SlotMap>(\n        id: S,\n        options?: UseContentOptions<never, never>\n    ): SlotContent<S>,\n\n    <I, S extends keyof SlotMap>(\n        id: S,\n        options?: UseContentOptions<I, never>\n    ): SlotContent<S> | I,\n\n    <F, S extends keyof SlotMap>(\n        id: S,\n        options?: UseContentOptions<never, F>\n    ): SlotContent<S> | F,\n\n    <I, F, S extends keyof SlotMap>(\n        id: S,\n        options?: UseContentOptions<I, F>\n    ): SlotContent<S> | I | F,\n};\n\nexport const useContent: UseContentHook = isSsr() ? useSsrContent : useCsrContent;\n","import {ReactChild, ReactElement, Fragment} from 'react';\nimport {JsonValue} from '@croct/plug/sdk/json';\nimport {UseEvaluationOptions, useEvaluation} from '../../hooks';\n\ntype Renderer<T> = (result: T) => ReactChild;\n\nexport type PersonalizationProps<T extends JsonValue = JsonValue, I = T, F = T> = UseEvaluationOptions<I, F> & {\n    expression: string,\n    children: Renderer<T | I | F>,\n};\n\nexport function Personalization<T extends JsonValue, I, F>(\n    props:\n        Extract<T | I | F, JsonValue> extends never\n            ? PersonalizationProps\n            : PersonalizationProps<T, I, F>,\n): ReactElement;\n\nexport function Personalization<I, F>(props: PersonalizationProps<JsonValue, I, F>): ReactElement {\n    const {expression, children, ...options} = props;\n    const result = useEvaluation(expression, options);\n\n    return (<Fragment>{children(result)}</Fragment>);\n}\n","import {Fragment, ReactChild, ReactElement} from 'react';\nimport {SlotContent, SlotId, SlotMap} from '@croct/plug/fetch';\nimport {NullableJsonObject} from '@croct/plug/sdk/json';\nimport {useContent, UseContentOptions} from '../../hooks';\n\ntype Renderer<P> = (props: P) => ReactChild;\n\nexport type SlotProps<P, I = P, F = P, S extends SlotId = SlotId> = UseContentOptions<I, F> & {\n    id: S,\n    children: Renderer<P | I | F>,\n};\n\ntype SlotComponent = {\n    <P, I, F>(\n        props:\n            Extract<P | I | F, NullableJsonObject> extends never\n                ? SlotProps<NullableJsonObject, never, never, keyof SlotMap extends never ? string : never>\n                : SlotProps<P, I, F, keyof SlotMap extends never ? string : never>\n    ): ReactElement,\n\n    <S extends keyof SlotMap>(props: SlotProps<SlotContent<S>, never, never, S>): ReactElement,\n\n    <I, S extends keyof SlotMap>(props: SlotProps<SlotContent<S>, I, never, S>): ReactElement,\n\n    <F, S extends keyof SlotMap>(props: SlotProps<SlotContent<S>, never, F, S>): ReactElement,\n\n    <I, F, S extends keyof SlotMap>(props: SlotProps<SlotContent<S>, I, F, S>): ReactElement,\n\n    (props: SlotProps<void, void, void>): ReactElement,\n};\n\nexport const Slot: SlotComponent = <I, F>(props: SlotProps<NullableJsonObject, I, F>): ReactElement => {\n    const {id, children, ...options} = props;\n    const data: SlotContent<SlotId> | I | F = useContent(id, options);\n\n    return <Fragment>{children(data)}</Fragment>;\n};\n"],"names":["isSsr","window","document","createElement","croct","csrPlug","Proxy","get","_","property","Promise","resolve","Error","String","CroctContext","createContext","displayName","CroctProvider","children","configuration","_excluded","parent","useContext","context","useMemo","plug","initialized","useEffect","unplug","_jsx","Provider","value","Cache","constructor","defaultExpiration","cache","load","cacheKey","loader","fallback","expiration","cachedEntry","undefined","error","result","promise","entry","dispose","timeout","setTimeout","then","catch","finally","clearTimeout","useLoader","initial","options","loadedValue","setValue","useState","isUnmounted","setUnmounted","resolvedValue","useCroct","cleanEvaluationOptions","key","Object","entries","useCsrEvaluation","expression","evaluationOptions","JSON","stringify","attributes","evaluate","useSsrEvaluation","useEvaluation","useCsrContent","id","fetch","payload","useSsrContent","useContent","Personalization","props","Fragment","Slot","data"],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,mDAAiC;AACjC,kDAAgC;AAChC,0CAAwB;AACxB,+CAA6B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@croct/plug-react",
-  "version": "0.4.2",
+  "version": "0.5.0-next.2",
   "description": "React components and hooks to plug your React applications into Croct.",
   "author": {
     "name": "Croct",
@@ -25,11 +25,10 @@
     "node": ">=10"
   },
   "scripts": {
-    "lint": "eslint 'src/**/*.ts' 'src/**/*.tsx' 'examples/**/*.ts' 'examples/**/*.tsx'",
+    "lint": "eslint 'src/**/*.ts' 'src/**/*.tsx'",
     "test": "jest -c jest.config.js --coverage",
     "validate": "tsc --noEmit",
-    "build": "tsc",
-    "bundle": "microbundle --jsx React.createElement --no-compress --format modern,cjs",
+    "build": "tsc -p tsconfig.build.json",
     "storybook": "start-storybook -s ./.storybook/static -p 6006 --no-manager-cache",
     "build-storybook": "build-storybook -s ./.storybook/static"
   },
@@ -38,55 +37,43 @@
     "react-dom": "^16.8.0  || ^17.0.0 || ^18.0.0"
   },
   "dependencies": {
-    "@croct/plug": "^0.10.1"
+    "@croct/plug": "^0.11.0-alpha.4",
+    "@croct/sdk": "^0.11.0-alpha.3"
   },
   "devDependencies": {
-    "@babel/core": "^7.18.5",
-    "@babel/preset-env": "^7.18.2",
-    "@babel/preset-react": "^7.17.12",
-    "@babel/preset-typescript": "^7.17.12",
-    "@storybook/addon-actions": "^6.5.9",
-    "@storybook/addon-essentials": "^6.5.9",
-    "@storybook/addon-links": "^6.5.9",
-    "@storybook/builder-webpack5": "^6.5.9",
-    "@storybook/manager-webpack5": "^6.5.9",
-    "@storybook/react": "^6.5.9",
-    "@testing-library/jest-dom": "^5.16.4",
-    "@testing-library/react": "^13.3.0",
-    "@testing-library/react-hooks": "^8.0.0",
-    "@types/jest": "^28.1.2",
-    "@types/node": "^16.11.41",
-    "@types/react": "^18.0.14",
-    "@types/react-dom": "^18.0.5",
-    "@typescript-eslint/eslint-plugin": "^5.28.0",
-    "@typescript-eslint/parser": "^5.28.0",
-    "babel-eslint": "^10.1.0",
-    "babel-jest": "^28.1.1",
-    "babel-loader": "^8.2.5",
-    "eslint": "^8.17.0",
-    "eslint-config-airbnb-base": "^15.0.0",
-    "eslint-config-standard": "^17.0.0",
-    "eslint-config-standard-react": "^11.0.1",
-    "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-jest": "^26.5.3",
-    "eslint-plugin-n": "^15.2.3",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-promise": "^6.0.0",
-    "eslint-plugin-react": "^7.30.0",
-    "eslint-plugin-standard": "^5.0.0",
-    "jest": "^28.1.1",
-    "jest-environment-jsdom": "^28.1.1",
-    "jest-environment-node": "^28.1.1",
-    "microbundle": "^0.15.0",
+    "@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.6.3",
+    "@storybook/addon-actions": "^6.5.13",
+    "@storybook/addon-essentials": "^6.5.13",
+    "@storybook/addon-links": "^6.5.13",
+    "@storybook/builder-webpack5": "^6.5.13",
+    "@storybook/manager-webpack5": "^6.5.13",
+    "@storybook/react": "^6.5.13",
+    "@testing-library/jest-dom": "^5.16.5",
+    "@testing-library/react": "^13.4.0",
+    "@types/jest": "^29.2.3",
+    "@types/node": "^18.11.9",
+    "@types/react": "^18.0.25",
+    "@types/react-dom": "^18.0.9",
+    "@typescript-eslint/eslint-plugin": "^5.43.0",
+    "@typescript-eslint/parser": "^5.43.0",
+    "babel-loader": "^9.1.0",
+    "eslint": "^8.28.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": "^4.7.3",
-    "webpack": "^5.73.0"
+    "typescript": "^4.9.3",
+    "webpack": "^5.75.0"
   },
   "files": [
     "**/*.js",
-    "**/*.js.map",
-    "**/*.ts"
+    "**/*.ts",
+    "**/*.map"
   ]
 }

package/src/api/evaluate.test.ts

@@ -0,0 +1,59 @@
+import {Evaluator} from '@croct/sdk/evaluator';
+import {evaluate, EvaluationOptions} from './evaluate';
+
+const mockEvaluate: Evaluator['evaluate'] = jest.fn();
+
+jest.mock(
+    '@croct/sdk/evaluator',
+    () => ({
+        __esModule: true,
+        /*
+     * eslint-disable-next-line prefer-arrow-callback --
+     * The mock can't be an arrow function because calling new on
+     * an arrow function is not allowed in JavaScript.
+     */
+        Evaluator: jest.fn(function constructor(this: Evaluator) {
+            this.evaluate = mockEvaluate;
+        }),
+    }),
+);
+
+describe('evaluate', () => {
+    const apiKey = '00000000-0000-0000-0000-000000000000';
+
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+
+    it('should forward the call to the evaluator', async () => {
+        const options: EvaluationOptions = {
+            apiKey: apiKey,
+            timeout: 100,
+        };
+
+        const query = 'true';
+
+        jest.mocked(mockEvaluate).mockResolvedValue(true);
+
+        await expect(evaluate(query, options)).resolves.toBe(true);
+
+        expect(Evaluator).toHaveBeenCalledWith({
+            apiKey: options.apiKey,
+        });
+
+        expect(mockEvaluate).toHaveBeenCalledWith(query, {
+            timeout: options.timeout,
+        });
+    });
+
+    it('should return the fallback value on error', async () => {
+        const options: EvaluationOptions = {
+            apiKey: apiKey,
+            fallback: false,
+        };
+
+        jest.mocked(mockEvaluate).mockRejectedValue(new Error('error'));
+
+        await expect(evaluate('true', options)).resolves.toBe(false);
+    });
+});

package/src/api/evaluate.ts

@@ -0,0 +1,19 @@
+import {Evaluator, EvaluationOptions as BaseOptions} from '@croct/sdk/evaluator';
+import {JsonValue} from '@croct/plug/sdk/json';
+
+export type EvaluationOptions<T extends JsonValue = JsonValue> = BaseOptions & {
+    apiKey: string,
+    fallback?: T,
+};
+
+export function evaluate<T extends JsonValue>(query: string, options: EvaluationOptions<T>): Promise<T> {
+    const {apiKey, fallback, ...rest} = options;
+    const promise = (new Evaluator({apiKey: apiKey}))
+        .evaluate(query, rest) as Promise<T>;
+
+    if (fallback !== undefined) {
+        return promise.catch(() => fallback);
+    }
+
+    return promise;
+}