@tern-secure/shared 1.0.0

package/dist/loadTernUIScript.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loadTernUIScript.ts","../src/loadScript.ts"],"sourcesContent":["import type { TernSecureInstanceTreeOptions } from \"@tern-secure/types\";\nimport { loadScript } from \"./loadScript\";\n\n\nexport type LoadTernUISCriptOptions = TernSecureInstanceTreeOptions & {\n  apiKey?: string;\n  customDomain?: string;\n  proxyUrl?: string;\n  version?: string;\n  isLocalDev?: boolean;\n  scriptHost?: string;\n  localPort?: string;\n  nonce?: string;\n}\n\nexport const loadTernUIScript = async (options?: LoadTernUISCriptOptions) => {\n  const existingScript =  document.querySelector<HTMLScriptElement>('script[data-ternui-script]');\n  console.log('[TernSecure-shared] Existing script:', existingScript);\n\n  if (existingScript) {\n    return new Promise((resolve, reject) => {\n      existingScript.addEventListener('load', () => {\n        resolve(existingScript);\n      });\n\n      existingScript.addEventListener('error', (error) => {\n        reject(error);\n      });\n    });\n  }\n\n  if (!options?.customDomain) {\n    throw new Error('TernUI script requires a custom domain or proxy URL to be specified in options.');\n  }\n  \n  return loadScript(ternUIgetScriptUrl(options), {\n    async: true,\n    //crossOrigin: undefined,\n     beforeLoad: beforeLoadWithOptions(options)\n    }).catch((error) => {\n      console.error('[TernSecure] Failed to load TernUI script:', error);\n      throw new Error('Failed to load TernUI script');\n    });\n  }\n\nexport const ternUIgetScriptUrl = (options?: LoadTernUISCriptOptions) => {\n    const isDevelopment = process.env.NODE_ENV === 'development';\n    const version = options?.version || process.env.TERN_UI_VERSION || 'latest';\n\n    if ( isDevelopment) {\n        const localHost = process.env.TERN_UI_HOST || 'localhost';\n        const localPort = options?.localPort || process.env.TERN_UI_PORT || '4000';\n        return `http://${localHost}:${localPort}/ternsecure.browser.js`;\n        //return `http://cdn.lifesprintcare.ca/dist/ternsecure.browser.js`\n    }\n    return `http://cdn.lifesprintcare.ca/dist/ternsecure.browser.js`\n\n    //const ternsecureCDN = options?.customDomain || \n                          //(options?.proxyUrl && new URL(options.proxyUrl).host) || 'cdn.tern-secure.com';\n    //return `${ternsecureCDN}/ternsecure.browser.js`;\n    //return `https://${ternsecureCDN}/npm/@ternsecure/tern-ui@${version}/dist/ternsecure.browser.js`;\n\n}\n\n    \nconst beforeLoadWithOptions = (options?: LoadTernUISCriptOptions) => (script: HTMLScriptElement) => {\n  const attributes = constructScriptAttributes(options);\n  Object.entries(attributes).forEach(([key, value]) => {\n    if (value) script.setAttribute(key, String(value));\n  });\n  console.log('[TernSecure-shared] Script attributes set:', attributes);\n};\n\nexport const constructScriptAttributes = (options?: LoadTernUISCriptOptions) => {\n  return {\n    'data-domain': options?.customDomain || '',\n    'data-apikey': options?.apiKey || '',\n    'data-environment': process.env.NODE_ENV || 'development',\n    'data-proxyUrl': options?.proxyUrl || '',\n    'data-version': options?.version || process.env.TERN_UI_VERSION || 'latest',\n    ...(options?.nonce ? { nonce: options.nonce } : {})\n  };\n};","  import { retry } from './retry'\n\n  type LoadScriptOptions = {\n    async?: boolean;\n    defer?: boolean;\n    crossOrigin?: 'anonymous' | 'use-credentials';\n    nonce?: string;\n    beforeLoad?: (script: HTMLScriptElement) => void;\n  };\n\n  export async function loadScript(src ='', options: LoadScriptOptions): Promise<HTMLScriptElement> {\n    const { async, defer, crossOrigin, nonce, beforeLoad } = options;\n\n    const load = () => {\n      return new Promise<HTMLScriptElement>((resolve, reject) => {\n        if (!src) {\n          reject(new Error('Script src is required'));\n        }\n\n        if (!document || !document.body) {\n          reject(new Error('Document body is not available'));\n        }\n\n        const script = document.createElement('script');\n\n        if (crossOrigin) script.setAttribute('crossorigin', crossOrigin);\n        script.async = async || false;\n        script.defer = defer || false;\n\n        let resolved = false;\n        let timeoutId: NodeJS.Timeout | null = null;\n\n        const cleanup = () => {\n          script.removeEventListener('load', handleLoad);\n          script.removeEventListener('error', handleError);\n          if (timeoutId) {\n            clearTimeout(timeoutId);\n            timeoutId = null;\n          }\n        };\n        \n        const handleLoad = () => {\n          if (resolved) return;\n          console.log(`[loadScript] Script loaded successfully: ${src}`);\n\n          resolved = true;\n          cleanup();\n          resolve(script);\n        };\n        \n        const handleError = (error: ErrorEvent) => {\n          if (resolved) return;\n          resolved = true;\n          cleanup();\n          script.remove();\n          console.error(`[loadScript] Failed to load script: ${src}`, error);\n          reject(new Error(`Failed to load script: ${src}, Error: ${error.message || error}`));\n        };\n        \n        script.addEventListener('load', handleLoad);\n        script.addEventListener('error', handleError);\n\n        script.src = src;\n        script.nonce = nonce;\n        beforeLoad?.(script);\n\n        console.log(`[loadScript] Appending script to document body: ${src}`);\n        document.body.appendChild(script)\n      });\n    };\n\n    return load()\n\n    //return retry(load, { shouldRetry: (_, iterations) => iterations <=5 });\n  }"],"mappings":"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","names":[]}

package/dist/loadTernUIScript.mjs

@@ -0,0 +1,63 @@
+import {
+  loadScript
+} from "./chunk-HATJQ74R.mjs";
+
+// src/loadTernUIScript.ts
+var loadTernUIScript = async (options) => {
+  const existingScript = document.querySelector("script[data-ternui-script]");
+  console.log("[TernSecure-shared] Existing script:", existingScript);
+  if (existingScript) {
+    return new Promise((resolve, reject) => {
+      existingScript.addEventListener("load", () => {
+        resolve(existingScript);
+      });
+      existingScript.addEventListener("error", (error) => {
+        reject(error);
+      });
+    });
+  }
+  if (!(options == null ? void 0 : options.customDomain)) {
+    throw new Error("TernUI script requires a custom domain or proxy URL to be specified in options.");
+  }
+  return loadScript(ternUIgetScriptUrl(options), {
+    async: true,
+    //crossOrigin: undefined,
+    beforeLoad: beforeLoadWithOptions(options)
+  }).catch((error) => {
+    console.error("[TernSecure] Failed to load TernUI script:", error);
+    throw new Error("Failed to load TernUI script");
+  });
+};
+var ternUIgetScriptUrl = (options) => {
+  const isDevelopment = process.env.NODE_ENV === "development";
+  const version = (options == null ? void 0 : options.version) || process.env.TERN_UI_VERSION || "latest";
+  if (isDevelopment) {
+    const localHost = process.env.TERN_UI_HOST || "localhost";
+    const localPort = (options == null ? void 0 : options.localPort) || process.env.TERN_UI_PORT || "4000";
+    return `http://${localHost}:${localPort}/ternsecure.browser.js`;
+  }
+  return `http://cdn.lifesprintcare.ca/dist/ternsecure.browser.js`;
+};
+var beforeLoadWithOptions = (options) => (script) => {
+  const attributes = constructScriptAttributes(options);
+  Object.entries(attributes).forEach(([key, value]) => {
+    if (value) script.setAttribute(key, String(value));
+  });
+  console.log("[TernSecure-shared] Script attributes set:", attributes);
+};
+var constructScriptAttributes = (options) => {
+  return {
+    "data-domain": (options == null ? void 0 : options.customDomain) || "",
+    "data-apikey": (options == null ? void 0 : options.apiKey) || "",
+    "data-environment": process.env.NODE_ENV || "development",
+    "data-proxyUrl": (options == null ? void 0 : options.proxyUrl) || "",
+    "data-version": (options == null ? void 0 : options.version) || process.env.TERN_UI_VERSION || "latest",
+    ...(options == null ? void 0 : options.nonce) ? { nonce: options.nonce } : {}
+  };
+};
+export {
+  constructScriptAttributes,
+  loadTernUIScript,
+  ternUIgetScriptUrl
+};
+//# sourceMappingURL=loadTernUIScript.mjs.map

package/dist/loadTernUIScript.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loadTernUIScript.ts"],"sourcesContent":["import type { TernSecureInstanceTreeOptions } from \"@tern-secure/types\";\nimport { loadScript } from \"./loadScript\";\n\n\nexport type LoadTernUISCriptOptions = TernSecureInstanceTreeOptions & {\n  apiKey?: string;\n  customDomain?: string;\n  proxyUrl?: string;\n  version?: string;\n  isLocalDev?: boolean;\n  scriptHost?: string;\n  localPort?: string;\n  nonce?: string;\n}\n\nexport const loadTernUIScript = async (options?: LoadTernUISCriptOptions) => {\n  const existingScript =  document.querySelector<HTMLScriptElement>('script[data-ternui-script]');\n  console.log('[TernSecure-shared] Existing script:', existingScript);\n\n  if (existingScript) {\n    return new Promise((resolve, reject) => {\n      existingScript.addEventListener('load', () => {\n        resolve(existingScript);\n      });\n\n      existingScript.addEventListener('error', (error) => {\n        reject(error);\n      });\n    });\n  }\n\n  if (!options?.customDomain) {\n    throw new Error('TernUI script requires a custom domain or proxy URL to be specified in options.');\n  }\n  \n  return loadScript(ternUIgetScriptUrl(options), {\n    async: true,\n    //crossOrigin: undefined,\n     beforeLoad: beforeLoadWithOptions(options)\n    }).catch((error) => {\n      console.error('[TernSecure] Failed to load TernUI script:', error);\n      throw new Error('Failed to load TernUI script');\n    });\n  }\n\nexport const ternUIgetScriptUrl = (options?: LoadTernUISCriptOptions) => {\n    const isDevelopment = process.env.NODE_ENV === 'development';\n    const version = options?.version || process.env.TERN_UI_VERSION || 'latest';\n\n    if ( isDevelopment) {\n        const localHost = process.env.TERN_UI_HOST || 'localhost';\n        const localPort = options?.localPort || process.env.TERN_UI_PORT || '4000';\n        return `http://${localHost}:${localPort}/ternsecure.browser.js`;\n        //return `http://cdn.lifesprintcare.ca/dist/ternsecure.browser.js`\n    }\n    return `http://cdn.lifesprintcare.ca/dist/ternsecure.browser.js`\n\n    //const ternsecureCDN = options?.customDomain || \n                          //(options?.proxyUrl && new URL(options.proxyUrl).host) || 'cdn.tern-secure.com';\n    //return `${ternsecureCDN}/ternsecure.browser.js`;\n    //return `https://${ternsecureCDN}/npm/@ternsecure/tern-ui@${version}/dist/ternsecure.browser.js`;\n\n}\n\n    \nconst beforeLoadWithOptions = (options?: LoadTernUISCriptOptions) => (script: HTMLScriptElement) => {\n  const attributes = constructScriptAttributes(options);\n  Object.entries(attributes).forEach(([key, value]) => {\n    if (value) script.setAttribute(key, String(value));\n  });\n  console.log('[TernSecure-shared] Script attributes set:', attributes);\n};\n\nexport const constructScriptAttributes = (options?: LoadTernUISCriptOptions) => {\n  return {\n    'data-domain': options?.customDomain || '',\n    'data-apikey': options?.apiKey || '',\n    'data-environment': process.env.NODE_ENV || 'development',\n    'data-proxyUrl': options?.proxyUrl || '',\n    'data-version': options?.version || process.env.TERN_UI_VERSION || 'latest',\n    ...(options?.nonce ? { nonce: options.nonce } : {})\n  };\n};"],"mappings":";;;;;AAeO,IAAM,mBAAmB,OAAO,YAAsC;AAC3E,QAAM,iBAAkB,SAAS,cAAiC,4BAA4B;AAC9F,UAAQ,IAAI,wCAAwC,cAAc;AAElE,MAAI,gBAAgB;AAClB,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,qBAAe,iBAAiB,QAAQ,MAAM;AAC5C,gBAAQ,cAAc;AAAA,MACxB,CAAC;AAED,qBAAe,iBAAiB,SAAS,CAAC,UAAU;AAClD,eAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAEA,MAAI,EAAC,mCAAS,eAAc;AAC1B,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AAEA,SAAO,WAAW,mBAAmB,OAAO,GAAG;AAAA,IAC7C,OAAO;AAAA;AAAA,IAEN,YAAY,sBAAsB,OAAO;AAAA,EAC1C,CAAC,EAAE,MAAM,CAAC,UAAU;AAClB,YAAQ,MAAM,8CAA8C,KAAK;AACjE,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD,CAAC;AACH;AAEK,IAAM,qBAAqB,CAAC,YAAsC;AACrE,QAAM,gBAAgB,QAAQ,IAAI,aAAa;AAC/C,QAAM,WAAU,mCAAS,YAAW,QAAQ,IAAI,mBAAmB;AAEnE,MAAK,eAAe;AAChB,UAAM,YAAY,QAAQ,IAAI,gBAAgB;AAC9C,UAAM,aAAY,mCAAS,cAAa,QAAQ,IAAI,gBAAgB;AACpE,WAAO,UAAU,SAAS,IAAI,SAAS;AAAA,EAE3C;AACA,SAAO;AAOX;AAGA,IAAM,wBAAwB,CAAC,YAAsC,CAAC,WAA8B;AAClG,QAAM,aAAa,0BAA0B,OAAO;AACpD,SAAO,QAAQ,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACnD,QAAI,MAAO,QAAO,aAAa,KAAK,OAAO,KAAK,CAAC;AAAA,EACnD,CAAC;AACD,UAAQ,IAAI,8CAA8C,UAAU;AACtE;AAEO,IAAM,4BAA4B,CAAC,YAAsC;AAC9E,SAAO;AAAA,IACL,gBAAe,mCAAS,iBAAgB;AAAA,IACxC,gBAAe,mCAAS,WAAU;AAAA,IAClC,oBAAoB,QAAQ,IAAI,YAAY;AAAA,IAC5C,kBAAiB,mCAAS,aAAY;AAAA,IACtC,iBAAgB,mCAAS,YAAW,QAAQ,IAAI,mBAAmB;AAAA,IACnE,IAAI,mCAAS,SAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,EACnD;AACF;","names":[]}

package/dist/react/index.d.mts

@@ -0,0 +1,54 @@
+import * as _tern_secure_types from '@tern-secure/types';
+import { TernSecureInstanceTree, TernSecureAuthProvider, TernSecureState } from '@tern-secure/types';
+import * as react from 'react';
+import react__default from 'react';
+
+declare const useTernSecure: () => TernSecureInstanceTree;
+
+type TernSecureAuthContextType = {
+    authProvider: TernSecureAuthProvider | null | undefined;
+    authState: TernSecureState;
+};
+declare const TernSecureInstanceContext: react.Context<{
+    value: TernSecureInstanceTree;
+} | undefined>;
+declare const useTernSecureInstanceContext: () => TernSecureInstanceTree;
+declare const TernSecureAuthContext: react.Context<{
+    value: TernSecureAuthContextType;
+} | undefined>;
+declare const useTernSecureAuthContext: () => TernSecureAuthContextType;
+declare const SessionContext: react.Context<{
+    value: _tern_secure_types.SignedInSession | null;
+} | undefined>;
+declare const useSessionContext: () => _tern_secure_types.SignedInSession | null;
+declare const UserContext: react.Context<{
+    value: _tern_secure_types.TernSecureUser | null;
+} | undefined>;
+declare const useUserContext: () => _tern_secure_types.TernSecureUser | null;
+declare function useAssertWrappedByTernSecureProvider(displayNameOrFn: string | (() => void)): void;
+
+/**
+ * Assert that the context value exists, otherwise throw an error.
+ *
+ * @internal
+ */
+declare function assertContextExists(contextVal: unknown, msgOrCtx: string | react__default.Context<any>): asserts contextVal;
+type Options = {
+    assertCtxFn?: (v: unknown, msg: string) => void;
+};
+type ContextAndHook<T> = react__default.Context<{
+    value: T;
+} | undefined>;
+type UseCtxFn<T> = () => T;
+/**
+ * Create and return a Context and two hooks that return the context value.
+ * The Context type is derived from the type passed in by the user.
+ *
+ * The first hook returned guarantees that the context exists so the returned value is always `CtxValue`
+ * The second hook makes no guarantees, so the returned value can be `CtxValue | undefined`
+ *
+ * @internal
+ */
+declare const createContextAndHook: <CtxValue>(displayName: string, options?: Options) => [ContextAndHook<CtxValue>, UseCtxFn<CtxValue>, UseCtxFn<CtxValue | Partial<CtxValue>>];
+
+export { SessionContext, TernSecureAuthContext, TernSecureInstanceContext, UserContext, assertContextExists, createContextAndHook, useAssertWrappedByTernSecureProvider, useSessionContext, useTernSecure, useTernSecureAuthContext, useTernSecureInstanceContext, useUserContext };

package/dist/react/index.d.ts

@@ -0,0 +1,54 @@
+import * as _tern_secure_types from '@tern-secure/types';
+import { TernSecureInstanceTree, TernSecureAuthProvider, TernSecureState } from '@tern-secure/types';
+import * as react from 'react';
+import react__default from 'react';
+
+declare const useTernSecure: () => TernSecureInstanceTree;
+
+type TernSecureAuthContextType = {
+    authProvider: TernSecureAuthProvider | null | undefined;
+    authState: TernSecureState;
+};
+declare const TernSecureInstanceContext: react.Context<{
+    value: TernSecureInstanceTree;
+} | undefined>;
+declare const useTernSecureInstanceContext: () => TernSecureInstanceTree;
+declare const TernSecureAuthContext: react.Context<{
+    value: TernSecureAuthContextType;
+} | undefined>;
+declare const useTernSecureAuthContext: () => TernSecureAuthContextType;
+declare const SessionContext: react.Context<{
+    value: _tern_secure_types.SignedInSession | null;
+} | undefined>;
+declare const useSessionContext: () => _tern_secure_types.SignedInSession | null;
+declare const UserContext: react.Context<{
+    value: _tern_secure_types.TernSecureUser | null;
+} | undefined>;
+declare const useUserContext: () => _tern_secure_types.TernSecureUser | null;
+declare function useAssertWrappedByTernSecureProvider(displayNameOrFn: string | (() => void)): void;
+
+/**
+ * Assert that the context value exists, otherwise throw an error.
+ *
+ * @internal
+ */
+declare function assertContextExists(contextVal: unknown, msgOrCtx: string | react__default.Context<any>): asserts contextVal;
+type Options = {
+    assertCtxFn?: (v: unknown, msg: string) => void;
+};
+type ContextAndHook<T> = react__default.Context<{
+    value: T;
+} | undefined>;
+type UseCtxFn<T> = () => T;
+/**
+ * Create and return a Context and two hooks that return the context value.
+ * The Context type is derived from the type passed in by the user.
+ *
+ * The first hook returned guarantees that the context exists so the returned value is always `CtxValue`
+ * The second hook makes no guarantees, so the returned value can be `CtxValue | undefined`
+ *
+ * @internal
+ */
+declare const createContextAndHook: <CtxValue>(displayName: string, options?: Options) => [ContextAndHook<CtxValue>, UseCtxFn<CtxValue>, UseCtxFn<CtxValue | Partial<CtxValue>>];
+
+export { SessionContext, TernSecureAuthContext, TernSecureInstanceContext, UserContext, assertContextExists, createContextAndHook, useAssertWrappedByTernSecureProvider, useSessionContext, useTernSecure, useTernSecureAuthContext, useTernSecureInstanceContext, useUserContext };

package/dist/react/index.js

@@ -0,0 +1,116 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/index.ts
+var react_exports = {};
+__export(react_exports, {
+  SessionContext: () => SessionContext,
+  TernSecureAuthContext: () => TernSecureAuthContext,
+  TernSecureInstanceContext: () => TernSecureInstanceContext,
+  UserContext: () => UserContext,
+  assertContextExists: () => assertContextExists,
+  createContextAndHook: () => createContextAndHook,
+  useAssertWrappedByTernSecureProvider: () => useAssertWrappedByTernSecureProvider,
+  useSessionContext: () => useSessionContext,
+  useTernSecure: () => useTernSecure,
+  useTernSecureAuthContext: () => useTernSecureAuthContext,
+  useTernSecureInstanceContext: () => useTernSecureInstanceContext,
+  useUserContext: () => useUserContext
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/ternsecureProvider.tsx
+var import_react2 = require("react");
+
+// src/react/ternsecureCtx.ts
+var import_react = __toESM(require("react"));
+function assertContextExists(contextVal, msgOrCtx) {
+  if (!contextVal) {
+    throw typeof msgOrCtx === "string" ? new Error(msgOrCtx) : new Error(`${msgOrCtx.displayName} not found`);
+  }
+}
+var createContextAndHook = (displayName, options) => {
+  const { assertCtxFn = assertContextExists } = options || {};
+  const Ctx = import_react.default.createContext(void 0);
+  Ctx.displayName = displayName;
+  const useCtx = () => {
+    const ctx = import_react.default.useContext(Ctx);
+    assertCtxFn(ctx, `${displayName} not found`);
+    return ctx.value;
+  };
+  const useCtxWithoutGuarantee = () => {
+    const ctx = import_react.default.useContext(Ctx);
+    return ctx ? ctx.value : {};
+  };
+  return [Ctx, useCtx, useCtxWithoutGuarantee];
+};
+
+// src/react/ternsecureProvider.tsx
+var [TernSecureInstanceContext, useTernSecureInstanceContext] = createContextAndHook("TernSecureInstanceContext");
+var [TernSecureAuthContext, useTernSecureAuthContext] = createContextAndHook("TernSecureAuthContext");
+var [SessionContext, useSessionContext] = createContextAndHook("SessionContext");
+var [UserContext, useUserContext] = createContextAndHook("UserContext");
+function useAssertWrappedByTernSecureProvider(displayNameOrFn) {
+  const ctx = (0, import_react2.useContext)(TernSecureInstanceContext);
+  if (!ctx) {
+    if (typeof displayNameOrFn === "function") {
+      displayNameOrFn();
+      return;
+    }
+    throw new Error(
+      `${displayNameOrFn} can only be used within the <TernSecureProvider /> component.
+      
+Possible fixes:
+1. Ensure that the <TernSecureProvider /> is correctly wrapping your application
+2. Check for multiple versions of @tern-secure packages in your project`
+    );
+  }
+}
+
+// src/react/hooks/useTernSecure.ts
+var useTernSecure = () => {
+  useAssertWrappedByTernSecureProvider("useTernSecure");
+  return useTernSecureInstanceContext();
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionContext,
+  TernSecureAuthContext,
+  TernSecureInstanceContext,
+  UserContext,
+  assertContextExists,
+  createContextAndHook,
+  useAssertWrappedByTernSecureProvider,
+  useSessionContext,
+  useTernSecure,
+  useTernSecureAuthContext,
+  useTernSecureInstanceContext,
+  useUserContext
+});
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts","../../src/react/ternsecureProvider.tsx","../../src/react/ternsecureCtx.ts","../../src/react/hooks/useTernSecure.ts"],"sourcesContent":["export * from './hooks'\n\nexport {\n    useAssertWrappedByTernSecureProvider,\n    useTernSecureInstanceContext,\n    useTernSecureAuthContext,\n    useSessionContext,\n    useUserContext,\n    SessionContext,\n    UserContext,\n    TernSecureAuthContext,\n    TernSecureInstanceContext\n} from './ternsecureProvider'\n\nexport {\n    assertContextExists,\n    createContextAndHook\n} from './ternsecureCtx'","'use client'\n\nimport { useContext } from 'react';\nimport type { \n  TernSecureAuthProvider,\n  TernSecureInstanceTree,\n  TernSecureState,\n} from '@tern-secure/types';\nimport { createContextAndHook } from './ternsecureCtx';\n\nexport type TernSecureAuthContextType = {\n  authProvider: TernSecureAuthProvider | null | undefined;\n  authState: TernSecureState;\n}\n\n\n// Create TernSecure instance context\nconst [TernSecureInstanceContext, useTernSecureInstanceContext] = \n  createContextAndHook<TernSecureInstanceTree>('TernSecureInstanceContext');\n\nconst [TernSecureAuthContext, useTernSecureAuthContext] =\n  createContextAndHook<TernSecureAuthContextType>('TernSecureAuthContext');\n\nconst [SessionContext, useSessionContext] = \ncreateContextAndHook<TernSecureInstanceTree['auth']['session']>('SessionContext');\n\nconst [UserContext, useUserContext] = \ncreateContextAndHook<TernSecureInstanceTree['auth']['user']>('UserContext');\n\n// Assert helper\nfunction useAssertWrappedByTernSecureProvider(displayNameOrFn: string | (() => void)): void {\n  //const ctx = useTernSecureInstanceContext();\n  const ctx = useContext(TernSecureInstanceContext);\n  \n  if (!ctx) {\n    if (typeof displayNameOrFn === 'function') {\n      displayNameOrFn();\n      return;\n    }\n\n    throw new Error(\n      `${displayNameOrFn} can only be used within the <TernSecureProvider /> component.\n      \nPossible fixes:\n1. Ensure that the <TernSecureProvider /> is correctly wrapping your application\n2. Check for multiple versions of @tern-secure packages in your project`\n    );\n  }\n}\n\n\nexport {\n  TernSecureInstanceContext,\n  TernSecureAuthContext,\n  SessionContext,\n  UserContext,\n  useTernSecureAuthContext,\n  useSessionContext,\n  useUserContext,\n  useTernSecureInstanceContext,\n  useAssertWrappedByTernSecureProvider\n};","'use client'\n\nimport React from 'react';\n\n/**\n * Assert that the context value exists, otherwise throw an error.\n *\n * @internal\n */\nexport function assertContextExists(contextVal: unknown, msgOrCtx: string | React.Context<any>): asserts contextVal {\n  if (!contextVal) {\n    throw typeof msgOrCtx === 'string' ? new Error(msgOrCtx) : new Error(`${msgOrCtx.displayName} not found`);\n  }\n}\ntype Options = { assertCtxFn?: (v: unknown, msg: string) => void };\ntype ContextAndHook<T> = React.Context<{ value: T } | undefined>;\ntype UseCtxFn<T> = () => T;\n\n/**\n * Create and return a Context and two hooks that return the context value.\n * The Context type is derived from the type passed in by the user.\n *\n * The first hook returned guarantees that the context exists so the returned value is always `CtxValue`\n * The second hook makes no guarantees, so the returned value can be `CtxValue | undefined`\n *\n * @internal\n */\n\nexport const createContextAndHook = <CtxValue>(\n  displayName: string,\n  options?: Options,\n): [ContextAndHook<CtxValue>, UseCtxFn<CtxValue>, UseCtxFn<CtxValue | Partial<CtxValue>>] => {\n  const { assertCtxFn = assertContextExists } = options || {};\n  const Ctx = React.createContext<{ value: CtxValue } | undefined >(undefined);\n  Ctx.displayName = displayName;\n\n  const useCtx = () => {\n    const ctx = React.useContext(Ctx);\n    assertCtxFn(ctx, `${displayName} not found`);\n    return (ctx as any).value as CtxValue;\n  };\n\n  const useCtxWithoutGuarantee = () => {\n    const ctx = React.useContext(Ctx);\n    return ctx ? ctx.value : {}\n  };\n\n    /**\n     * Assert that the context value exists, otherwise throw an error.\n    if (ctx === undefined) {\n      throw new Error(`use${name} must be used within a ${name}Provider`);\n    }\n    return ctx.value;\n    */\n\n  return [Ctx, useCtx, useCtxWithoutGuarantee];\n}","import type { \n    TernSecureInstanceTree\n} from \"@tern-secure/types\";\nimport { \n    useAssertWrappedByTernSecureProvider, \n    useTernSecureInstanceContext \n} from \"../ternsecureProvider\";\n\nexport const useTernSecure = (): TernSecureInstanceTree => {\n    /**\n     * if no assertion is needed, you can use the following:\n     *  const instance  = useTernSecureInstanceContext();\n     *  if (!instance) {\n     *      throw new Error('useTernSecure must be used within a TernSecureProvider');\n     *  }\n     *  return instance;\n     */\n    \n    useAssertWrappedByTernSecureProvider('useTernSecure');\n    return useTernSecureInstanceContext();\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,IAAAA,gBAA2B;;;ACA3B,mBAAkB;AAOX,SAAS,oBAAoB,YAAqB,UAA2D;AAClH,MAAI,CAAC,YAAY;AACf,UAAM,OAAO,aAAa,WAAW,IAAI,MAAM,QAAQ,IAAI,IAAI,MAAM,GAAG,SAAS,WAAW,YAAY;AAAA,EAC1G;AACF;AAeO,IAAM,uBAAuB,CAClC,aACA,YAC2F;AAC3F,QAAM,EAAE,cAAc,oBAAoB,IAAI,WAAW,CAAC;AAC1D,QAAM,MAAM,aAAAC,QAAM,cAAgD,MAAS;AAC3E,MAAI,cAAc;AAElB,QAAM,SAAS,MAAM;AACnB,UAAM,MAAM,aAAAA,QAAM,WAAW,GAAG;AAChC,gBAAY,KAAK,GAAG,WAAW,YAAY;AAC3C,WAAQ,IAAY;AAAA,EACtB;AAEA,QAAM,yBAAyB,MAAM;AACnC,UAAM,MAAM,aAAAA,QAAM,WAAW,GAAG;AAChC,WAAO,MAAM,IAAI,QAAQ,CAAC;AAAA,EAC5B;AAUA,SAAO,CAAC,KAAK,QAAQ,sBAAsB;AAC7C;;;ADvCA,IAAM,CAAC,2BAA2B,4BAA4B,IAC5D,qBAA6C,2BAA2B;AAE1E,IAAM,CAAC,uBAAuB,wBAAwB,IACpD,qBAAgD,uBAAuB;AAEzE,IAAM,CAAC,gBAAgB,iBAAiB,IACxC,qBAAgE,gBAAgB;AAEhF,IAAM,CAAC,aAAa,cAAc,IAClC,qBAA6D,aAAa;AAG1E,SAAS,qCAAqC,iBAA8C;AAE1F,QAAM,UAAM,0BAAW,yBAAyB;AAEhD,MAAI,CAAC,KAAK;AACR,QAAI,OAAO,oBAAoB,YAAY;AACzC,sBAAgB;AAChB;AAAA,IACF;AAEA,UAAM,IAAI;AAAA,MACR,GAAG,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA,IAKpB;AAAA,EACF;AACF;;;AExCO,IAAM,gBAAgB,MAA8B;AAUvD,uCAAqC,eAAe;AACpD,SAAO,6BAA6B;AACxC;","names":["import_react","React"]}

package/dist/react/index.mjs

@@ -0,0 +1,68 @@
+// src/react/ternsecureProvider.tsx
+import { useContext } from "react";
+
+// src/react/ternsecureCtx.ts
+import React from "react";
+function assertContextExists(contextVal, msgOrCtx) {
+  if (!contextVal) {
+    throw typeof msgOrCtx === "string" ? new Error(msgOrCtx) : new Error(`${msgOrCtx.displayName} not found`);
+  }
+}
+var createContextAndHook = (displayName, options) => {
+  const { assertCtxFn = assertContextExists } = options || {};
+  const Ctx = React.createContext(void 0);
+  Ctx.displayName = displayName;
+  const useCtx = () => {
+    const ctx = React.useContext(Ctx);
+    assertCtxFn(ctx, `${displayName} not found`);
+    return ctx.value;
+  };
+  const useCtxWithoutGuarantee = () => {
+    const ctx = React.useContext(Ctx);
+    return ctx ? ctx.value : {};
+  };
+  return [Ctx, useCtx, useCtxWithoutGuarantee];
+};
+
+// src/react/ternsecureProvider.tsx
+var [TernSecureInstanceContext, useTernSecureInstanceContext] = createContextAndHook("TernSecureInstanceContext");
+var [TernSecureAuthContext, useTernSecureAuthContext] = createContextAndHook("TernSecureAuthContext");
+var [SessionContext, useSessionContext] = createContextAndHook("SessionContext");
+var [UserContext, useUserContext] = createContextAndHook("UserContext");
+function useAssertWrappedByTernSecureProvider(displayNameOrFn) {
+  const ctx = useContext(TernSecureInstanceContext);
+  if (!ctx) {
+    if (typeof displayNameOrFn === "function") {
+      displayNameOrFn();
+      return;
+    }
+    throw new Error(
+      `${displayNameOrFn} can only be used within the <TernSecureProvider /> component.
+      
+Possible fixes:
+1. Ensure that the <TernSecureProvider /> is correctly wrapping your application
+2. Check for multiple versions of @tern-secure packages in your project`
+    );
+  }
+}
+
+// src/react/hooks/useTernSecure.ts
+var useTernSecure = () => {
+  useAssertWrappedByTernSecureProvider("useTernSecure");
+  return useTernSecureInstanceContext();
+};
+export {
+  SessionContext,
+  TernSecureAuthContext,
+  TernSecureInstanceContext,
+  UserContext,
+  assertContextExists,
+  createContextAndHook,
+  useAssertWrappedByTernSecureProvider,
+  useSessionContext,
+  useTernSecure,
+  useTernSecureAuthContext,
+  useTernSecureInstanceContext,
+  useUserContext
+};
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/ternsecureProvider.tsx","../../src/react/ternsecureCtx.ts","../../src/react/hooks/useTernSecure.ts"],"sourcesContent":["'use client'\n\nimport { useContext } from 'react';\nimport type { \n  TernSecureAuthProvider,\n  TernSecureInstanceTree,\n  TernSecureState,\n} from '@tern-secure/types';\nimport { createContextAndHook } from './ternsecureCtx';\n\nexport type TernSecureAuthContextType = {\n  authProvider: TernSecureAuthProvider | null | undefined;\n  authState: TernSecureState;\n}\n\n\n// Create TernSecure instance context\nconst [TernSecureInstanceContext, useTernSecureInstanceContext] = \n  createContextAndHook<TernSecureInstanceTree>('TernSecureInstanceContext');\n\nconst [TernSecureAuthContext, useTernSecureAuthContext] =\n  createContextAndHook<TernSecureAuthContextType>('TernSecureAuthContext');\n\nconst [SessionContext, useSessionContext] = \ncreateContextAndHook<TernSecureInstanceTree['auth']['session']>('SessionContext');\n\nconst [UserContext, useUserContext] = \ncreateContextAndHook<TernSecureInstanceTree['auth']['user']>('UserContext');\n\n// Assert helper\nfunction useAssertWrappedByTernSecureProvider(displayNameOrFn: string | (() => void)): void {\n  //const ctx = useTernSecureInstanceContext();\n  const ctx = useContext(TernSecureInstanceContext);\n  \n  if (!ctx) {\n    if (typeof displayNameOrFn === 'function') {\n      displayNameOrFn();\n      return;\n    }\n\n    throw new Error(\n      `${displayNameOrFn} can only be used within the <TernSecureProvider /> component.\n      \nPossible fixes:\n1. Ensure that the <TernSecureProvider /> is correctly wrapping your application\n2. Check for multiple versions of @tern-secure packages in your project`\n    );\n  }\n}\n\n\nexport {\n  TernSecureInstanceContext,\n  TernSecureAuthContext,\n  SessionContext,\n  UserContext,\n  useTernSecureAuthContext,\n  useSessionContext,\n  useUserContext,\n  useTernSecureInstanceContext,\n  useAssertWrappedByTernSecureProvider\n};","'use client'\n\nimport React from 'react';\n\n/**\n * Assert that the context value exists, otherwise throw an error.\n *\n * @internal\n */\nexport function assertContextExists(contextVal: unknown, msgOrCtx: string | React.Context<any>): asserts contextVal {\n  if (!contextVal) {\n    throw typeof msgOrCtx === 'string' ? new Error(msgOrCtx) : new Error(`${msgOrCtx.displayName} not found`);\n  }\n}\ntype Options = { assertCtxFn?: (v: unknown, msg: string) => void };\ntype ContextAndHook<T> = React.Context<{ value: T } | undefined>;\ntype UseCtxFn<T> = () => T;\n\n/**\n * Create and return a Context and two hooks that return the context value.\n * The Context type is derived from the type passed in by the user.\n *\n * The first hook returned guarantees that the context exists so the returned value is always `CtxValue`\n * The second hook makes no guarantees, so the returned value can be `CtxValue | undefined`\n *\n * @internal\n */\n\nexport const createContextAndHook = <CtxValue>(\n  displayName: string,\n  options?: Options,\n): [ContextAndHook<CtxValue>, UseCtxFn<CtxValue>, UseCtxFn<CtxValue | Partial<CtxValue>>] => {\n  const { assertCtxFn = assertContextExists } = options || {};\n  const Ctx = React.createContext<{ value: CtxValue } | undefined >(undefined);\n  Ctx.displayName = displayName;\n\n  const useCtx = () => {\n    const ctx = React.useContext(Ctx);\n    assertCtxFn(ctx, `${displayName} not found`);\n    return (ctx as any).value as CtxValue;\n  };\n\n  const useCtxWithoutGuarantee = () => {\n    const ctx = React.useContext(Ctx);\n    return ctx ? ctx.value : {}\n  };\n\n    /**\n     * Assert that the context value exists, otherwise throw an error.\n    if (ctx === undefined) {\n      throw new Error(`use${name} must be used within a ${name}Provider`);\n    }\n    return ctx.value;\n    */\n\n  return [Ctx, useCtx, useCtxWithoutGuarantee];\n}","import type { \n    TernSecureInstanceTree\n} from \"@tern-secure/types\";\nimport { \n    useAssertWrappedByTernSecureProvider, \n    useTernSecureInstanceContext \n} from \"../ternsecureProvider\";\n\nexport const useTernSecure = (): TernSecureInstanceTree => {\n    /**\n     * if no assertion is needed, you can use the following:\n     *  const instance  = useTernSecureInstanceContext();\n     *  if (!instance) {\n     *      throw new Error('useTernSecure must be used within a TernSecureProvider');\n     *  }\n     *  return instance;\n     */\n    \n    useAssertWrappedByTernSecureProvider('useTernSecure');\n    return useTernSecureInstanceContext();\n}"],"mappings":";AAEA,SAAS,kBAAkB;;;ACA3B,OAAO,WAAW;AAOX,SAAS,oBAAoB,YAAqB,UAA2D;AAClH,MAAI,CAAC,YAAY;AACf,UAAM,OAAO,aAAa,WAAW,IAAI,MAAM,QAAQ,IAAI,IAAI,MAAM,GAAG,SAAS,WAAW,YAAY;AAAA,EAC1G;AACF;AAeO,IAAM,uBAAuB,CAClC,aACA,YAC2F;AAC3F,QAAM,EAAE,cAAc,oBAAoB,IAAI,WAAW,CAAC;AAC1D,QAAM,MAAM,MAAM,cAAgD,MAAS;AAC3E,MAAI,cAAc;AAElB,QAAM,SAAS,MAAM;AACnB,UAAM,MAAM,MAAM,WAAW,GAAG;AAChC,gBAAY,KAAK,GAAG,WAAW,YAAY;AAC3C,WAAQ,IAAY;AAAA,EACtB;AAEA,QAAM,yBAAyB,MAAM;AACnC,UAAM,MAAM,MAAM,WAAW,GAAG;AAChC,WAAO,MAAM,IAAI,QAAQ,CAAC;AAAA,EAC5B;AAUA,SAAO,CAAC,KAAK,QAAQ,sBAAsB;AAC7C;;;ADvCA,IAAM,CAAC,2BAA2B,4BAA4B,IAC5D,qBAA6C,2BAA2B;AAE1E,IAAM,CAAC,uBAAuB,wBAAwB,IACpD,qBAAgD,uBAAuB;AAEzE,IAAM,CAAC,gBAAgB,iBAAiB,IACxC,qBAAgE,gBAAgB;AAEhF,IAAM,CAAC,aAAa,cAAc,IAClC,qBAA6D,aAAa;AAG1E,SAAS,qCAAqC,iBAA8C;AAE1F,QAAM,MAAM,WAAW,yBAAyB;AAEhD,MAAI,CAAC,KAAK;AACR,QAAI,OAAO,oBAAoB,YAAY;AACzC,sBAAgB;AAChB;AAAA,IACF;AAEA,UAAM,IAAI;AAAA,MACR,GAAG,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA,IAKpB;AAAA,EACF;AACF;;;AExCO,IAAM,gBAAgB,MAA8B;AAUvD,uCAAqC,eAAe;AACpD,SAAO,6BAA6B;AACxC;","names":[]}

package/dist/retry.d.mts

@@ -0,0 +1,46 @@
+type Milliseconds = number;
+type RetryOptions = Partial<{
+    /**
+     * The initial delay before the first retry.
+     * @default 125
+     */
+    initialDelay: Milliseconds;
+    /**
+     * The maximum delay between retries.
+     * The delay between retries will never exceed this value.
+     * If set to 0, the delay will increase indefinitely.
+     * @default 0
+     */
+    maxDelayBetweenRetries: Milliseconds;
+    /**
+     * The multiplier for the exponential backoff.
+     * @default 2
+     */
+    factor: number;
+    /**
+     * A function to determine if the operation should be retried.
+     * The callback accepts the error that was thrown and the number of iterations.
+     * The iterations variable references the number of retries AFTER attempt
+     * that caused the error and starts at 1 (as in, this is the 1st, 2nd, nth retry).
+     * @default (error, iterations) => iterations < 5
+     */
+    shouldRetry: (error: unknown, iterations: number) => boolean;
+    /**
+     * Controls whether the helper should retry the operation immediately once before applying exponential backoff.
+     * The delay for the immediate retry is 100ms.
+     * @default false
+     */
+    retryImmediately: boolean;
+    /**
+     * If true, the intervals will be multiplied by a factor in the range of [1,2].
+     * @default true
+     */
+    jitter: boolean;
+}>;
+/**
+ * Retries a callback until it succeeds or the shouldRetry function returns false.
+ * See {@link RetryOptions} for the available options.
+ */
+declare const retry: <T>(callback: () => T | Promise<T>, options?: RetryOptions) => Promise<T>;
+
+export { retry };

package/dist/retry.d.ts

@@ -0,0 +1,46 @@
+type Milliseconds = number;
+type RetryOptions = Partial<{
+    /**
+     * The initial delay before the first retry.
+     * @default 125
+     */
+    initialDelay: Milliseconds;
+    /**
+     * The maximum delay between retries.
+     * The delay between retries will never exceed this value.
+     * If set to 0, the delay will increase indefinitely.
+     * @default 0
+     */
+    maxDelayBetweenRetries: Milliseconds;
+    /**
+     * The multiplier for the exponential backoff.
+     * @default 2
+     */
+    factor: number;
+    /**
+     * A function to determine if the operation should be retried.
+     * The callback accepts the error that was thrown and the number of iterations.
+     * The iterations variable references the number of retries AFTER attempt
+     * that caused the error and starts at 1 (as in, this is the 1st, 2nd, nth retry).
+     * @default (error, iterations) => iterations < 5
+     */
+    shouldRetry: (error: unknown, iterations: number) => boolean;
+    /**
+     * Controls whether the helper should retry the operation immediately once before applying exponential backoff.
+     * The delay for the immediate retry is 100ms.
+     * @default false
+     */
+    retryImmediately: boolean;
+    /**
+     * If true, the intervals will be multiplied by a factor in the range of [1,2].
+     * @default true
+     */
+    jitter: boolean;
+}>;
+/**
+ * Retries a callback until it succeeds or the shouldRetry function returns false.
+ * See {@link RetryOptions} for the available options.
+ */
+declare const retry: <T>(callback: () => T | Promise<T>, options?: RetryOptions) => Promise<T>;
+
+export { retry };

package/dist/retry.js

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/retry.ts
+var retry_exports = {};
+__export(retry_exports, {
+  retry: () => retry
+});
+module.exports = __toCommonJS(retry_exports);
+var defaultOptions = {
+  initialDelay: 125,
+  maxDelayBetweenRetries: 0,
+  factor: 2,
+  shouldRetry: (_, iteration) => iteration < 5,
+  retryImmediately: false,
+  jitter: true
+};
+var RETRY_IMMEDIATELY_DELAY = 100;
+var sleep = async (ms) => new Promise((s) => setTimeout(s, ms));
+var applyJitter = (delay, jitter) => {
+  return jitter ? delay * (1 + Math.random()) : delay;
+};
+var createExponentialDelayAsyncFn = (opts) => {
+  let timesCalled = 0;
+  const calculateDelayInMs = () => {
+    const constant = opts.initialDelay;
+    const base = opts.factor;
+    let delay = constant * Math.pow(base, timesCalled);
+    delay = applyJitter(delay, opts.jitter);
+    return Math.min(opts.maxDelayBetweenRetries || delay, delay);
+  };
+  return async () => {
+    await sleep(calculateDelayInMs());
+    timesCalled++;
+  };
+};
+var retry = async (callback, options = {}) => {
+  let iterations = 0;
+  const { shouldRetry, initialDelay, maxDelayBetweenRetries, factor, retryImmediately, jitter } = {
+    ...defaultOptions,
+    ...options
+  };
+  const delay = createExponentialDelayAsyncFn({
+    initialDelay,
+    maxDelayBetweenRetries,
+    factor,
+    jitter
+  });
+  while (true) {
+    try {
+      return await callback();
+    } catch (e) {
+      iterations++;
+      if (!shouldRetry(e, iterations)) {
+        throw e;
+      }
+      if (retryImmediately && iterations === 1) {
+        await sleep(applyJitter(RETRY_IMMEDIATELY_DELAY, jitter));
+      } else {
+        await delay();
+      }
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  retry
+});
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retry.ts"],"sourcesContent":["type Milliseconds = number;\n\ntype RetryOptions = Partial<{\n  /**\n   * The initial delay before the first retry.\n   * @default 125\n   */\n  initialDelay: Milliseconds;\n  /**\n   * The maximum delay between retries.\n   * The delay between retries will never exceed this value.\n   * If set to 0, the delay will increase indefinitely.\n   * @default 0\n   */\n  maxDelayBetweenRetries: Milliseconds;\n  /**\n   * The multiplier for the exponential backoff.\n   * @default 2\n   */\n  factor: number;\n  /**\n   * A function to determine if the operation should be retried.\n   * The callback accepts the error that was thrown and the number of iterations.\n   * The iterations variable references the number of retries AFTER attempt\n   * that caused the error and starts at 1 (as in, this is the 1st, 2nd, nth retry).\n   * @default (error, iterations) => iterations < 5\n   */\n  shouldRetry: (error: unknown, iterations: number) => boolean;\n  /**\n   * Controls whether the helper should retry the operation immediately once before applying exponential backoff.\n   * The delay for the immediate retry is 100ms.\n   * @default false\n   */\n  retryImmediately: boolean;\n  /**\n   * If true, the intervals will be multiplied by a factor in the range of [1,2].\n   * @default true\n   */\n  jitter: boolean;\n}>;\n\nconst defaultOptions: Required<RetryOptions> = {\n  initialDelay: 125,\n  maxDelayBetweenRetries: 0,\n  factor: 2,\n  shouldRetry: (_: unknown, iteration: number) => iteration < 5,\n  retryImmediately: false,\n  jitter: true,\n};\n\nconst RETRY_IMMEDIATELY_DELAY = 100;\n\nconst sleep = async (ms: Milliseconds) => new Promise(s => setTimeout(s, ms));\n\nconst applyJitter = (delay: Milliseconds, jitter: boolean) => {\n  return jitter ? delay * (1 + Math.random()) : delay;\n};\n\nconst createExponentialDelayAsyncFn = (\n  opts: Required<Pick<RetryOptions, 'initialDelay' | 'maxDelayBetweenRetries' | 'factor' | 'jitter'>>,\n) => {\n  let timesCalled = 0;\n\n  const calculateDelayInMs = () => {\n    const constant = opts.initialDelay;\n    const base = opts.factor;\n    let delay = constant * Math.pow(base, timesCalled);\n    delay = applyJitter(delay, opts.jitter);\n    return Math.min(opts.maxDelayBetweenRetries || delay, delay);\n  };\n\n  return async (): Promise<void> => {\n    await sleep(calculateDelayInMs());\n    timesCalled++;\n  };\n};\n\n/**\n * Retries a callback until it succeeds or the shouldRetry function returns false.\n * See {@link RetryOptions} for the available options.\n */\nexport const retry = async <T>(callback: () => T | Promise<T>, options: RetryOptions = {}): Promise<T> => {\n  let iterations = 0;\n  const { shouldRetry, initialDelay, maxDelayBetweenRetries, factor, retryImmediately, jitter } = {\n    ...defaultOptions,\n    ...options,\n  };\n\n  const delay = createExponentialDelayAsyncFn({\n    initialDelay,\n    maxDelayBetweenRetries,\n    factor,\n    jitter,\n  });\n\n  while (true) {\n    try {\n      return await callback();\n    } catch (e) {\n      iterations++;\n      if (!shouldRetry(e, iterations)) {\n        throw e;\n      }\n      if (retryImmediately && iterations === 1) {\n        await sleep(applyJitter(RETRY_IMMEDIATELY_DELAY, jitter));\n      } else {\n        await delay();\n      }\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCA,IAAM,iBAAyC;AAAA,EAC7C,cAAc;AAAA,EACd,wBAAwB;AAAA,EACxB,QAAQ;AAAA,EACR,aAAa,CAAC,GAAY,cAAsB,YAAY;AAAA,EAC5D,kBAAkB;AAAA,EAClB,QAAQ;AACV;AAEA,IAAM,0BAA0B;AAEhC,IAAM,QAAQ,OAAO,OAAqB,IAAI,QAAQ,OAAK,WAAW,GAAG,EAAE,CAAC;AAE5E,IAAM,cAAc,CAAC,OAAqB,WAAoB;AAC5D,SAAO,SAAS,SAAS,IAAI,KAAK,OAAO,KAAK;AAChD;AAEA,IAAM,gCAAgC,CACpC,SACG;AACH,MAAI,cAAc;AAElB,QAAM,qBAAqB,MAAM;AAC/B,UAAM,WAAW,KAAK;AACtB,UAAM,OAAO,KAAK;AAClB,QAAI,QAAQ,WAAW,KAAK,IAAI,MAAM,WAAW;AACjD,YAAQ,YAAY,OAAO,KAAK,MAAM;AACtC,WAAO,KAAK,IAAI,KAAK,0BAA0B,OAAO,KAAK;AAAA,EAC7D;AAEA,SAAO,YAA2B;AAChC,UAAM,MAAM,mBAAmB,CAAC;AAChC;AAAA,EACF;AACF;AAMO,IAAM,QAAQ,OAAU,UAAgC,UAAwB,CAAC,MAAkB;AACxG,MAAI,aAAa;AACjB,QAAM,EAAE,aAAa,cAAc,wBAAwB,QAAQ,kBAAkB,OAAO,IAAI;AAAA,IAC9F,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,QAAQ,8BAA8B;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,SAAO,MAAM;AACX,QAAI;AACF,aAAO,MAAM,SAAS;AAAA,IACxB,SAAS,GAAG;AACV;AACA,UAAI,CAAC,YAAY,GAAG,UAAU,GAAG;AAC/B,cAAM;AAAA,MACR;AACA,UAAI,oBAAoB,eAAe,GAAG;AACxC,cAAM,MAAM,YAAY,yBAAyB,MAAM,CAAC;AAAA,MAC1D,OAAO;AACL,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;","names":[]}