@figma-vars/hooks 3.0.0 → 3.1.0

package/dist/index.mjs

@@ -1,131 +1,212 @@
-import { jsx as K } from "react/jsx-runtime";
-import { createContext as L, useMemo as m, useContext as T, useReducer as V, useRef as w, useEffect as k, useCallback as _ } from "react";
-import A, { useSWRConfig as S } from "swr";
-import { f as I, E as v, a as p, m as E, F as b, b as h, c as P } from "./index-Cd4HQQHO.js";
-import { d as te } from "./index-Cd4HQQHO.js";
-const g = L(void 0);
-let R = 0;
-const G = ({
+import { jsx as O } from "react/jsx-runtime";
+import { createContext as P, useId as _, useMemo as p, useContext as x, useReducer as L, useRef as m, useEffect as g, useCallback as T } from "react";
+import V, { useSWRConfig as j } from "swr";
+import { f as A, E as b, a as E, m as y, F as h, b as D } from "./index-ClHLYVvu.js";
+import { c as ie } from "./index-ClHLYVvu.js";
+const C = P(void 0);
+function S(e) {
+  if (typeof e != "object" || e === null)
+    return !1;
+  const r = e;
+  if (typeof r.meta != "object" || r.meta === null)
+    return !1;
+  const t = r.meta;
+  return !(typeof t.variableCollections != "object" || t.variableCollections === null || typeof t.variables != "object" || t.variables === null);
+}
+function I(e) {
+  if (S(e))
+    return e;
+}
+const W = ({
   children: e,
-  token: t,
-  fileKey: r,
+  token: r,
+  fileKey: t,
   fallbackFile: o,
   swrConfig: n
 }) => {
-  const s = m(() => (R += 1, `figma-vars-provider-${R}`), []), c = m(() => {
-    const a = {
-      token: t,
-      fileKey: r,
-      providerId: s,
+  const a = _(), c = p(() => `figma-vars-provider-${a}`, [a]), u = p(() => {
+    if (o) {
+      if (typeof o == "object") {
+        const s = I(o);
+        if (s)
+          return s;
+        process.env.NODE_ENV !== "production" && console.warn(
+          "[figma-vars-hooks] fallbackFile object does not match expected Figma Variables API response structure. Expected { meta: { variableCollections: {...}, variables: {...} } }"
+        );
+        return;
+      }
+      if (typeof o == "string")
+        try {
+          const s = JSON.parse(o), l = I(s);
+          if (l)
+            return l;
+          process.env.NODE_ENV !== "production" && console.warn(
+            "[figma-vars-hooks] Parsed fallbackFile JSON does not match expected Figma Variables API response structure. Expected { meta: { variableCollections: {...}, variables: {...} } }"
+          );
+          return;
+        } catch (s) {
+          process.env.NODE_ENV !== "production" && console.error(
+            `[figma-vars-hooks] Failed to parse fallbackFile JSON: ${s instanceof Error ? s.message : "Unknown error"}`
+          );
+          return;
+        }
+    }
+  }, [o]), i = p(() => {
+    const s = {
+      token: r,
+      fileKey: t,
+      providerId: c,
       ...n !== void 0 && { swrConfig: n }
     };
-    return o === void 0 ? a : { ...a, fallbackFile: o };
-  }, [t, r, o, s, n]);
-  return /* @__PURE__ */ K(g.Provider, { value: c, children: e });
-}, u = () => {
-  const e = T(g);
+    return o === void 0 ? s : {
+      ...s,
+      fallbackFile: o,
+      // Keep for backward compatibility
+      parsedFallbackFile: u
+      // Pre-parsed version for hooks to use
+    };
+  }, [r, t, o, u, c, n]);
+  return /* @__PURE__ */ O(C.Provider, { value: i, children: e });
+}, d = () => {
+  const e = x(C);
   if (e === void 0)
     throw new Error(
       "useFigmaTokenContext must be used within a FigmaVarsProvider"
     );
   return e;
-}, C = () => {
-  const { token: e, fileKey: t, fallbackFile: r, providerId: o, swrConfig: n } = u(), s = t ? `https://api.figma.com/v1/files/${t}/variables/local` : null, l = !!(e && s) ? [s, e] : !!r ? [`fallback-${o ?? "default"}`, "fallback"] : null;
-  return A(
-    l,
-    async (...i) => {
-      const [f, d] = Array.isArray(i[0]) ? i[0] : [i[0], i[1]];
-      if (r)
-        return typeof r == "string" ? JSON.parse(r) : r;
-      if (!f || !d)
+};
+function N(e) {
+  const { fileKey: r, token: t, providerId: o, hasFallback: n } = e;
+  return !!(t && r) && t && r ? [`https://api.figma.com/v1/files/${r}/variables/local`, t] : n ? [`fallback-${o ?? "default"}`, "fallback"] : null;
+}
+function B(e) {
+  const { fileKey: r, token: t, providerId: o, hasFallback: n } = e;
+  return !!(t && r) && t && r ? [`https://api.figma.com/v1/files/${r}/variables/published`, t] : n ? [`fallback-${o ?? "default"}`, "fallback"] : null;
+}
+function F(e) {
+  const { fileKey: r, token: t, providerId: o, hasFallback: n } = e, a = [];
+  return t && r && (a.push([
+    `https://api.figma.com/v1/files/${r}/variables/local`,
+    t
+  ]), a.push([
+    `https://api.figma.com/v1/files/${r}/variables/published`,
+    t
+  ])), n && o && a.push([`fallback-${o}`, "fallback"]), a;
+}
+const K = () => {
+  const {
+    token: e,
+    fileKey: r,
+    fallbackFile: t,
+    parsedFallbackFile: o,
+    providerId: n,
+    swrConfig: a
+  } = d(), u = N({
+    fileKey: r,
+    token: e,
+    providerId: n,
+    hasFallback: !!(t || o)
+  });
+  return V(
+    u,
+    async (...s) => {
+      if (o)
+        return o;
+      if (t && typeof t == "object")
+        return t;
+      const [l, f] = Array.isArray(s[0]) ? s[0] : [s[0], s[1]];
+      if (!l || !f)
         throw new Error("Missing URL or token for live API request");
-      return I(f, d);
+      return A(l, f);
     },
-    n
+    a
   );
-}, N = () => {
-  const { data: e } = C(), t = m(
+}, H = () => {
+  const { data: e } = K(), r = p(
     () => e != null && e.meta ? Object.values(e.meta.variableCollections) : [],
     [e]
-  ), r = m(
+  ), t = p(
     () => e != null && e.meta ? e.meta.variableCollections : {},
     [e]
   );
   return {
-    collections: t,
-    collectionsById: r
+    collections: r,
+    collectionsById: t
   };
-}, j = () => {
-  const { data: e } = C();
-  return m(() => {
-    const t = [], r = {}, o = {};
+}, Y = () => {
+  const { data: e } = K();
+  return p(() => {
+    const r = [], t = {}, o = {};
     if (e != null && e.meta)
       for (const n of Object.values(
         e.meta.variableCollections
       )) {
-        t.push(...n.modes), r[n.id] = n.modes;
-        for (const s of n.modes)
-          o[s.modeId] = s;
+        r.push(...n.modes), t[n.id] = n.modes;
+        for (const a of n.modes)
+          o[a.modeId] = a;
       }
     return {
-      modes: t,
-      modesByCollectionId: r,
+      modes: r,
+      modesByCollectionId: t,
       modesById: o
     };
   }, [e]);
 };
-function B(e, t) {
-  switch (t.type) {
+function M(e, r) {
+  switch (r.type) {
     case "loading":
       return { ...e, status: "loading", error: null };
     case "success":
-      return { ...e, status: "success", data: t.payload };
+      return { ...e, status: "success", data: r.payload };
     case "error":
-      return { ...e, status: "error", error: t.payload };
+      return { ...e, status: "error", error: r.payload };
     default:
       return e;
   }
 }
-const y = (e) => {
-  const t = {
+const k = (e, r) => {
+  const { throwOnError: t = !1 } = {}, o = {
     status: "idle",
     data: null,
     error: null
-  }, [r, o] = V(B, t), n = w(e), s = w(!0);
-  return k(() => {
-    n.current = e;
-  }, [e]), k(() => (s.current = !0, () => {
-    s.current = !1;
+  }, [n, a] = L(M, o), c = m(e), u = m({ throwOnError: t }), i = m(!0), s = m(0);
+  return g(() => {
+    c.current = e, u.current = { throwOnError: t };
+  }, [e, t]), g(() => (i.current = !0, () => {
+    i.current = !1;
   }), []), {
-    mutate: _(
-      async (a) => {
-        if (s.current) {
-          o({ type: "loading" });
-          try {
-            const l = await n.current(a);
-            return s.current && o({ type: "success", payload: l }), l;
-          } catch (l) {
-            s.current && o({ type: "error", payload: l });
-            return;
-          }
+    mutate: T(
+      async (f) => {
+        if (!i.current)
+          return;
+        const w = ++s.current;
+        a({ type: "loading" });
+        try {
+          const v = await c.current(f);
+          return i.current && w === s.current && a({ type: "success", payload: v }), v;
+        } catch (v) {
+          const R = v;
+          if (i.current && w === s.current && a({ type: "error", payload: R }), u.current.throwOnError)
+            throw R;
+          return;
         }
       },
       []
-      // Empty deps array - mutationFn is accessed via ref
+      // Empty deps array - mutationFn and options are accessed via refs
     ),
-    ...r,
-    isLoading: r.status === "loading",
-    isSuccess: r.status === "success",
-    isError: r.status === "error"
+    ...n,
+    isLoading: n.status === "loading",
+    isSuccess: n.status === "success",
+    isError: n.status === "error"
   };
-}, H = () => {
-  const { token: e, fileKey: t } = u();
-  return y(async (o) => {
+}, z = () => {
+  const { token: e, fileKey: r } = d();
+  return k(async (o) => {
     if (!e)
-      throw new Error(v);
-    if (!t)
-      throw new Error(p);
-    return await E(b(t), e, "CREATE", {
+      throw new Error(b);
+    if (!r)
+      throw new Error(E);
+    return await y(h(r), e, "CREATE", {
       variables: [
         {
           action: "CREATE",
@@ -134,19 +215,19 @@ const y = (e) => {
       ]
     });
   });
-}, q = () => {
-  const { token: e, fileKey: t } = u();
-  return y(
+}, X = () => {
+  const { token: e, fileKey: r } = d();
+  return k(
     async ({
       variableId: o,
       payload: n
     }) => {
       if (!e)
-        throw new Error(v);
-      if (!t)
-        throw new Error(p);
-      return await E(
-        b(t),
+        throw new Error(b);
+      if (!r)
+        throw new Error(E);
+      return await y(
+        h(r),
         e,
         "UPDATE",
         {
@@ -161,14 +242,14 @@ const y = (e) => {
       );
     }
   );
-}, J = () => {
-  const { token: e, fileKey: t } = u();
-  return y(async (o) => {
+}, Z = () => {
+  const { token: e, fileKey: r } = d();
+  return k(async (o) => {
     if (!e)
-      throw new Error(v);
-    if (!t)
-      throw new Error(p);
-    return await E(b(t), e, "DELETE", {
+      throw new Error(b);
+    if (!r)
+      throw new Error(E);
+    return await y(h(r), e, "DELETE", {
       variables: [
         {
           action: "DELETE",
@@ -177,98 +258,100 @@ const y = (e) => {
       ]
     });
   });
-}, Q = () => {
-  const { token: e, fileKey: t } = u();
-  return y(async (o) => {
+}, ee = () => {
+  const { token: e, fileKey: r } = d();
+  return k(async (o) => {
     if (!e)
-      throw new Error(v);
-    if (!t)
-      throw new Error(p);
-    return await E(
-      b(t),
+      throw new Error(b);
+    if (!r)
+      throw new Error(E);
+    return await y(
+      h(r),
       e,
       "UPDATE",
       o
     );
   });
-}, W = () => {
-  const { mutate: e } = S(), { fileKey: t, providerId: r } = u();
+}, re = () => {
+  const { mutate: e } = j(), { token: r, fileKey: t, fallbackFile: o, providerId: n } = d(), a = !!o;
   return {
     invalidate: () => {
-      if (!t) return;
-      const s = [
-        `https://api.figma.com/v1/files/${t}/variables/local`,
-        "token-placeholder"
-      ];
-      e(s);
-      const c = [
-        h(t),
-        "token-placeholder"
-      ];
-      if (e(c), r) {
-        const a = [`fallback-${r}`, "fallback"];
-        e(a);
-      }
+      const i = F({
+        fileKey: t,
+        token: r,
+        providerId: n,
+        hasFallback: a
+      });
+      for (const s of i)
+        e(s);
     },
     revalidate: () => {
-      if (!t) return;
-      const s = [
-        `https://api.figma.com/v1/files/${t}/variables/local`,
-        "token-placeholder"
-      ];
-      e(s, void 0, { revalidate: !0 });
-      const c = [
-        h(t),
-        "token-placeholder"
-      ];
-      if (e(c, void 0, { revalidate: !0 }), r) {
-        const a = [`fallback-${r}`, "fallback"];
-        e(a, void 0, { revalidate: !0 });
-      }
+      const i = F({
+        fileKey: t,
+        token: r,
+        providerId: n,
+        hasFallback: a
+      });
+      for (const s of i)
+        e(s, void 0, { revalidate: !0 });
     }
   };
-}, Y = () => {
-  const { token: e, fileKey: t, fallbackFile: r, providerId: o, swrConfig: n } = u(), s = t ? h(t) : null, l = !!(e && s) ? [s, e] : !!r ? [`fallback-${o ?? "default"}`, "fallback"] : null;
-  return A(
-    l,
-    async (...i) => {
-      const [f, d] = Array.isArray(i[0]) ? i[0] : [i[0], i[1]];
-      if (r)
-        return typeof r == "string" ? JSON.parse(r) : r;
-      if (!f || !d)
+}, te = () => {
+  const {
+    token: e,
+    fileKey: r,
+    fallbackFile: t,
+    parsedFallbackFile: o,
+    providerId: n,
+    swrConfig: a
+  } = d(), u = B({
+    fileKey: r,
+    token: e,
+    providerId: n,
+    hasFallback: !!(t || o)
+  });
+  return V(
+    u,
+    async (...s) => {
+      if (o)
+        return o;
+      if (t && typeof t == "object")
+        return t;
+      const [l, f] = Array.isArray(s[0]) ? s[0] : [s[0], s[1]];
+      if (!l || !f)
         throw new Error("Missing URL or token for live API request");
-      return I(f, d);
+      return A(l, f);
     },
-    n
+    a
   );
 };
-function M(e) {
-  return e instanceof P;
-}
 function U(e) {
-  return M(e) ? e.statusCode : null;
+  return e instanceof D;
+}
+function $(e) {
+  return U(e) ? e.statusCode : null;
 }
-function z(e, t = "An error occurred") {
-  return e instanceof Error ? e.message || t : typeof e == "string" ? e : t;
+function oe(e, r = "An error occurred") {
+  return e instanceof Error ? e.message || r : typeof e == "string" ? e : r;
 }
-function X(e, t) {
-  return U(e) === t;
+function ne(e, r) {
+  return $(e) === r;
 }
 export {
-  P as FigmaApiError,
-  G as FigmaVarsProvider,
-  te as filterVariables,
-  z as getErrorMessage,
-  U as getErrorStatus,
-  X as hasErrorStatus,
-  M as isFigmaApiError,
-  Q as useBulkUpdateVariables,
-  H as useCreateVariable,
-  J as useDeleteVariable,
-  W as useInvalidateVariables,
-  Y as usePublishedVariables,
-  q as useUpdateVariable,
-  N as useVariableCollections,
-  j as useVariableModes,
-  C as useVariables
+  D as FigmaApiError,
+  W as FigmaVarsProvider,
+  ie as filterVariables,
+  oe as getErrorMessage,
+  $ as getErrorStatus,
+  ne as hasErrorStatus,
+  U as isFigmaApiError,
+  ee as useBulkUpdateVariables,
+  z as useCreateVariable,
+  Z as useDeleteVariable,
+  re as useInvalidateVariables,
+  te as usePublishedVariables,
+  X as useUpdateVariable,
+  H as useVariableCollections,
+  Y as useVariableModes,
+  K as useVariables
 };

package/dist/types/contexts.d.ts

@@ -41,6 +41,7 @@ export interface FigmaTokenContextType {
     /**
      * Optional fallback variable JSON file for offline or static use cases.
      * Allows FigmaVars to function without a live API request.
+     * @deprecated Use parsedFallbackFile instead. This is kept for backward compatibility.
      */
     fallbackFile?: LocalVariablesResponse | PublishedVariablesResponse | string;
     /**

package/dist/types/contexts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/types/contexts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,MAAM,CAAA;IAM3E;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,MAAM,CAAA;IAC3E;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B"}
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/types/contexts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,MAAM,CAAA;IAe3E;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,MAAM,CAAA;IAC3E;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAC7B"}

package/dist/types/figma.d.ts

@@ -271,6 +271,8 @@ export interface FigmaError {
  * Extends the standard Error class to include HTTP status code information,
  * making it easier for consumers to handle different error types (401, 403, 404, 429, etc.).
  *
+ * For rate limit errors (429), includes retry-after information parsed from response headers.
+ *
  * @example
  * ```ts
  * import { FigmaApiError } from '@figma-vars/hooks';
@@ -283,6 +285,7 @@ export interface FigmaError {
  *       // Handle authentication error
  *     } else if (error.statusCode === 429) {
  *       // Handle rate limit
+ *       console.log(`Retry after ${error.retryAfter} seconds`);
  *     }
  *   }
  * }
@@ -293,6 +296,11 @@ export interface FigmaError {
 export declare class FigmaApiError extends Error {
     /** HTTP status code from the API response. */
     readonly statusCode: number;
-    constructor(message: string, statusCode: number);
+    /**
+     * Retry-After header value in seconds (for 429 rate limit errors).
+     * Undefined if not a rate limit error or header not present.
+     */
+    readonly retryAfter: number | undefined;
+    constructor(message: string, statusCode: number, retryAfter?: number);
 }
 //# sourceMappingURL=figma.d.ts.map

package/dist/types/figma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figma.d.ts","sourceRoot":"","sources":["../../src/types/figma.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"figma.d.ts","sourceRoot":"","sources":["../../src/types/figma.ts"],"names":[],"mappings":"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"}

package/dist/types/mutations.d.ts

@@ -292,6 +292,20 @@ export interface MutationState<TData> {
     data: TData | null;
     error: Error | null;
 }
+/**
+ * Options for configuring mutation behavior.
+ *
+ * @public
+ */
+export interface MutationOptions {
+    /**
+     * If true, errors will be rethrown instead of being caught and stored in state.
+     * This allows callers to use try/catch for error handling.
+     *
+     * @default false
+     */
+    throwOnError?: boolean;
+}
 /**
  * Return value of mutation hooks.
  *

package/dist/types/mutations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/types/mutations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/types/mutations.ts"],"names":[],"mappings":"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"}

package/dist/utils/errorHelpers.d.ts

@@ -93,4 +93,50 @@ export declare function getErrorMessage(error: unknown, defaultMessage?: string)
  * @public
  */
 export declare function hasErrorStatus(error: unknown, statusCode: number): boolean;
+/**
+ * Checks if an error represents a rate limit (429) response.
+ *
+ * @remarks
+ * Convenience function to check if an error is a rate limit error.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error is a rate limit error (429), `false` otherwise.
+ *
+ * @example
+ * ```tsx
+ * import { isRateLimited } from '@figma-vars/hooks';
+ *
+ * if (isRateLimited(error)) {
+ *   // Handle rate limit, maybe retry after delay
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isRateLimited(error: unknown): boolean;
+/**
+ * Gets the retry-after value in seconds from a rate limit error.
+ *
+ * @remarks
+ * Returns the number of seconds to wait before retrying, as specified in the Retry-After header.
+ * Returns `null` if the error is not a rate limit error or if no retry-after value is available.
+ *
+ * @param error - The error to extract retry-after from.
+ * @returns The number of seconds to wait, or `null` if not available.
+ *
+ * @example
+ * ```tsx
+ * import { getRetryAfter } from '@figma-vars/hooks';
+ *
+ * const retryAfter = getRetryAfter(error);
+ * if (retryAfter !== null) {
+ *   setTimeout(() => {
+ *     // Retry the request
+ *   }, retryAfter * 1000);
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function getRetryAfter(error: unknown): number | null;
 //# sourceMappingURL=errorHelpers.d.ts.map