@pushwoosh/kit-helpers 4.11.1 → 4.11.3

package/analytics/identifyOpenReplay.js

@@ -8,9 +8,11 @@ export const identifyOpenReplaySession = properties => {
     store.push(properties);
     window.pwOpenReplayIdentifyStore = store;
   } else {
-    window.OpenReplay?.setUserID(properties.email);
+    var _window$OpenReplay;
+    (_window$OpenReplay = window.OpenReplay) === null || _window$OpenReplay === void 0 || _window$OpenReplay.setUserID(properties.email);
     if (properties.accountID) {
-      window.OpenReplay?.setMetadata('AccountID', `${properties.accountID}`);
+      var _window$OpenReplay2;
+      (_window$OpenReplay2 = window.OpenReplay) === null || _window$OpenReplay2 === void 0 || _window$OpenReplay2.setMetadata('AccountID', `${properties.accountID}`);
     }
   }
 };

package/callWithRetry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Retry / polling policy for a single operation.
+ *
+ * Retry is always opt-in: `callWithRetry` is the only entry point, so plain calls run once and
+ * non-idempotent operations are never retried unless a policy is passed.
+ */
+export type RetryPolicy<T> = {
+    /** Maximum number of attempts, including the first one. Must be a positive integer. */
+    readonly attempts: number;
+    /** Delay in milliseconds between two consecutive attempts. */
+    readonly delay: number;
+    /**
+     * Poll predicate. Return `true` when the result is final and the loop must stop.
+     * Omit it to stop on the first successful result (plain retry, without polling).
+     */
+    readonly until?: (result: T) => boolean;
+    /**
+     * Decide whether to retry after a thrown error. Return `true` to retry.
+     * Omit it and errors propagate immediately, which keeps non-idempotent operations safe.
+     */
+    readonly retryOnError?: (error: unknown, attempt: number) => boolean;
+};
+/**
+ * Raised when a retry / polling policy runs out of attempts before its stop condition is met.
+ */
+export declare class RetryExhaustedError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Run an async operation under a retry / polling policy — the single place that owns the
+ * attempt loop and the delay between attempts. Callers describe *when* to stop (`until`) and
+ * *whether* to retry on error (`retryOnError`); they never hand-write the loop themselves.
+ *
+ * @param operation - operation to run; receives the 1-based attempt number.
+ * @param policy - retry / polling policy.
+ */
+export declare const callWithRetry: <T>(operation: (attempt: number) => Promise<T>, policy: RetryPolicy<T>) => Promise<T>;

package/callWithRetry.js

@@ -0,0 +1,57 @@
+/**
+ * Raised when a retry / polling policy runs out of attempts before its stop condition is met.
+ */
+export class RetryExhaustedError extends Error {
+  constructor(message = 'Retry attempts exhausted!') {
+    super(message);
+    this.name = 'RetryExhaustedError';
+  }
+}
+const sleep = ms => new Promise(resolve => {
+  setTimeout(resolve, ms);
+});
+/**
+ * Run an async operation under a retry / polling policy — the single place that owns the
+ * attempt loop and the delay between attempts. Callers describe *when* to stop (`until`) and
+ * *whether* to retry on error (`retryOnError`); they never hand-write the loop themselves.
+ *
+ * @param operation - operation to run; receives the 1-based attempt number.
+ * @param policy - retry / polling policy.
+ */
+export const callWithRetry = async (operation, policy) => {
+  if (!Number.isInteger(policy.attempts) || policy.attempts < 1) {
+    throw new RangeError(`callWithRetry: "attempts" must be a positive integer, got ${policy.attempts}.`);
+  }
+  let lastAttempt = {
+    kind: 'unmet'
+  };
+  for (let attempt = 1; attempt <= policy.attempts; attempt += 1) {
+    try {
+      // eslint-disable-next-line no-await-in-loop
+      const result = await operation(attempt);
+      if (!policy.until || policy.until(result)) {
+        return result;
+      }
+      lastAttempt = {
+        kind: 'unmet'
+      };
+    } catch (error) {
+      var _policy$retryOnError;
+      if (((_policy$retryOnError = policy.retryOnError) === null || _policy$retryOnError === void 0 ? void 0 : _policy$retryOnError.call(policy, error, attempt)) !== true) {
+        throw error;
+      }
+      lastAttempt = {
+        kind: 'error',
+        error
+      };
+    }
+    if (attempt < policy.attempts) {
+      // eslint-disable-next-line no-await-in-loop
+      await sleep(policy.delay);
+    }
+  }
+  if (lastAttempt.kind === 'error') {
+    throw lastAttempt.error;
+  }
+  throw new RetryExhaustedError(`Retry policy exhausted after ${policy.attempts} attempt(s) without meeting the stop condition.`);
+};

package/expand.js

@@ -1,5 +1,7 @@
+import { createElement as _createElement } from "react";
+import { jsx as _jsx } from "react/jsx-runtime";
 /* eslint-disable react/require-default-props, react/jsx-no-bind */
-import React, { useEffect, useRef, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { CSSTransition, TransitionGroup } from 'react-transition-group';
 import styled, { css } from 'styled-components';
 const ExpandTransitionComp = ({
@@ -22,21 +24,24 @@ const ExpandTransitionComp = ({
     });
   }
   useEffect(updateStyle, [timeout]);
-  return React.createElement(CSSTransition, {
+  return _jsx(CSSTransition, {
     ...rest,
     timeout: timeout,
     classNames: className,
     onEnter: updateStyle,
     onExit: updateStyle,
-    nodeRef: refExternal
-  }, React.createElement("div", {
-    ref: refExternal,
-    className: externalClassName ? `${className} ${externalClassName}` : className,
-    style: externalStyle
-  }, React.createElement("div", {
-    ref: refInternal,
-    className: internalClassName
-  }, children)));
+    nodeRef: refExternal,
+    children: _jsx("div", {
+      ref: refExternal,
+      className: externalClassName ? `${className} ${externalClassName}` : className,
+      style: externalStyle,
+      children: _jsx("div", {
+        ref: refInternal,
+        className: internalClassName,
+        children: children
+      })
+    })
+  });
 };
 const CollapseTransition = styled(ExpandTransitionComp).withConfig({
   displayName: "CollapseTransition",
@@ -53,10 +58,11 @@ export const Collapse = ({
   children,
   className,
   ...rest
-}) => React.createElement(TransitionGroup, {
-  component: null
-}, expanded && React.createElement(CollapseTransition, {
-  ...rest,
-  externalClassName: className,
-  key: 0
-}, typeof children === 'function' ? children() : children));
+}) => _jsx(TransitionGroup, {
+  component: null,
+  children: expanded && _createElement(CollapseTransition, {
+    ...rest,
+    externalClassName: className,
+    key: 0
+  }, typeof children === 'function' ? children() : children)
+});

package/flex.d.ts

@@ -5,13 +5,13 @@ type FlexContainerProps = CommonContainerProps & {
 };
 export declare const FlexContainer: import("styled-components").StyledComponent<"div", any, FlexContainerProps, never>;
 export declare const Cluster: import("styled-components").StyledComponent<"div", any, import("./styled-helpers").CommonBoxProps & {
-    $alignContent?: import("./styled-helpers").AlignContentValue | undefined;
-    $alignItems?: import("./styled-helpers").ItemAlignmentValue | undefined;
-    $gap?: import("./styled-helpers").StrNum | undefined;
-    $justifyContent?: import("./styled-helpers").JustifyContentValue | undefined;
+    $alignContent?: import("./styled-helpers").AlignContentValue;
+    $alignItems?: import("./styled-helpers").ItemAlignmentValue;
+    $gap?: import("./styled-helpers").StrNum;
+    $justifyContent?: import("./styled-helpers").JustifyContentValue;
 } & {
-    $flexDirection?: "row" | "row-reverse" | "column" | "column-reverse" | undefined;
-    $flexWrap?: "wrap" | "nowrap" | "wrap-reverse" | undefined;
+    $flexDirection?: "row" | "row-reverse" | "column" | "column-reverse";
+    $flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
 } & {
     $flexWrap: string;
 }, "$flexWrap">;

package/grid.d.ts

@@ -7,50 +7,50 @@ type GridContainerProps = CommonContainerProps & {
 };
 export declare const GridContainer: import("styled-components").StyledComponent<"div", any, GridContainerProps, never>;
 export declare const Columns: import("styled-components").StyledComponent<"div", any, import("./styled-helpers").CommonBoxProps & {
-    $alignContent?: import("./styled-helpers").AlignContentValue | undefined;
-    $alignItems?: ItemAlignmentValue | undefined;
-    $gap?: StrNum | undefined;
-    $justifyContent?: import("./styled-helpers").JustifyContentValue | undefined;
+    $alignContent?: import("./styled-helpers").AlignContentValue;
+    $alignItems?: ItemAlignmentValue;
+    $gap?: StrNum;
+    $justifyContent?: import("./styled-helpers").JustifyContentValue;
 } & {
-    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense" | undefined;
-    $justifyItems?: ItemAlignmentValue | undefined;
-    $placeItems?: ItemAlignmentValue | undefined;
+    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense";
+    $justifyItems?: ItemAlignmentValue;
+    $placeItems?: ItemAlignmentValue;
 } & {
     $sizes: StrNum;
 }, never>;
 export declare const Rows: import("styled-components").StyledComponent<"div", any, import("./styled-helpers").CommonBoxProps & {
-    $alignContent?: import("./styled-helpers").AlignContentValue | undefined;
-    $alignItems?: ItemAlignmentValue | undefined;
-    $gap?: StrNum | undefined;
-    $justifyContent?: import("./styled-helpers").JustifyContentValue | undefined;
+    $alignContent?: import("./styled-helpers").AlignContentValue;
+    $alignItems?: ItemAlignmentValue;
+    $gap?: StrNum;
+    $justifyContent?: import("./styled-helpers").JustifyContentValue;
 } & {
-    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense" | undefined;
-    $justifyItems?: ItemAlignmentValue | undefined;
-    $placeItems?: ItemAlignmentValue | undefined;
+    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense";
+    $justifyItems?: ItemAlignmentValue;
+    $placeItems?: ItemAlignmentValue;
 } & {
     $sizes: StrNum;
 }, never>;
 export declare const Horizontal: import("styled-components").StyledComponent<"div", any, import("./styled-helpers").CommonBoxProps & {
-    $alignContent?: import("./styled-helpers").AlignContentValue | undefined;
-    $alignItems?: ItemAlignmentValue | undefined;
-    $gap?: StrNum | undefined;
-    $justifyContent?: import("./styled-helpers").JustifyContentValue | undefined;
+    $alignContent?: import("./styled-helpers").AlignContentValue;
+    $alignItems?: ItemAlignmentValue;
+    $gap?: StrNum;
+    $justifyContent?: import("./styled-helpers").JustifyContentValue;
 } & {
-    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense" | undefined;
-    $justifyItems?: ItemAlignmentValue | undefined;
-    $placeItems?: ItemAlignmentValue | undefined;
+    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense";
+    $justifyItems?: ItemAlignmentValue;
+    $placeItems?: ItemAlignmentValue;
 } & {
     $gridAutoFlow: string;
 }, "$gridAutoFlow">;
 export declare const Vertical: import("styled-components").StyledComponent<"div", any, import("./styled-helpers").CommonBoxProps & {
-    $alignContent?: import("./styled-helpers").AlignContentValue | undefined;
-    $alignItems?: ItemAlignmentValue | undefined;
-    $gap?: StrNum | undefined;
-    $justifyContent?: import("./styled-helpers").JustifyContentValue | undefined;
-} & {
-    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense" | undefined;
-    $justifyItems?: ItemAlignmentValue | undefined;
-    $placeItems?: ItemAlignmentValue | undefined;
+    $alignContent?: import("./styled-helpers").AlignContentValue;
+    $alignItems?: ItemAlignmentValue;
+    $gap?: StrNum;
+    $justifyContent?: import("./styled-helpers").JustifyContentValue;
+} & {
+    $gridAutoFlow?: "row" | "column" | "dense" | "row dense" | "column dense";
+    $justifyItems?: ItemAlignmentValue;
+    $placeItems?: ItemAlignmentValue;
 } & {
     $gridAutoFlow: string;
 }, "$gridAutoFlow">;

package/index.d.ts

@@ -5,6 +5,8 @@ export * from './hooks/useClickAway';
 export { identifyOpenReplaySession } from './analytics/identifyOpenReplay';
 export { trackEvent } from './analytics/trackEvent';
 export { formatNumber } from './formatNumber';
+export { callWithRetry, RetryExhaustedError } from './callWithRetry';
+export type { RetryPolicy } from './callWithRetry';
 export { readNavigationHistory, writeNavigationHistory } from './navigation';
 export { default as usePersistentFunction } from './hooks/usePersistentFunction';
 export { default as useEffectOnce } from './hooks/useEffectOnce';

package/index.js

@@ -5,6 +5,7 @@ export * from './hooks/useClickAway';
 export { identifyOpenReplaySession } from './analytics/identifyOpenReplay';
 export { trackEvent } from './analytics/trackEvent';
 export { formatNumber } from './formatNumber';
+export { callWithRetry, RetryExhaustedError } from './callWithRetry';
 export { readNavigationHistory, writeNavigationHistory } from './navigation';
 export { default as usePersistentFunction } from './hooks/usePersistentFunction';
 export { default as useEffectOnce } from './hooks/useEffectOnce';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushwoosh/kit-helpers",
-  "version": "4.11.1",
+  "version": "4.11.3",
   "description": "React component for build Pushwoosh products",
   "main": "index.js",
   "module": "index.js",
@@ -19,7 +19,7 @@
     "react-transition-group": "^4.4.5"
   },
   "devDependencies": {
-    "@pushwoosh/frontend-builder-engine": "^0.1.5",
+    "@pushwoosh/frontend-builder-engine": "^2.1.1",
     "@pushwoosh/kit-constants": "^1.6.0",
     "@types/react": "^16.14.20",
     "@types/react-dom": "^16.9.14",