@figma-vars/hooks 3.0.0-beta.1 → 3.1.0

package/dist/hooks/useVariables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,0LAUxB,CAAC"}
+{"version":3,"file":"useVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAIzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,0LAgDxB,CAAA"}

package/dist/index-5ZyKWuYv.cjs

@@ -0,0 +1 @@
+"use strict";var N=Object.defineProperty;var g=(t,s,r)=>s in t?N(t,s,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[s]=r;var m=(t,s,r)=>g(t,typeof s!="symbol"?s+"":s,r);const T="https://api.figma.com",O=`${T}/v1/files`,v=t=>`/v1/files/${t}/variables/published`,P=t=>`/v1/files/${t}/variables`,y=t=>`${O}/${t}/variables/local`,D="application/json",p="X-FIGMA-TOKEN",h="A Figma API token is required.",B=`${h} and file key are required.`,U="Failed to perform bulk update.",w="Failed to create Figma variable.",b="Failed to delete Figma variable.",C="Failed to update Figma variable.",G="An error occurred while fetching data from the Figma API.";class l extends Error{constructor(r,o,c){super(r);m(this,"statusCode");m(this,"retryAfter");this.name="FigmaApiError",this.statusCode=o,this.retryAfter=c??void 0,Error.captureStackTrace&&Error.captureStackTrace(this,l)}}async function V(t,s,r){if(!s)throw new Error(h);const{signal:o,timeout:c,fetch:F=fetch}=r??{};let i,A;const a=o||(c?(A=new AbortController,i=setTimeout(()=>{A==null||A.abort()},c),A.signal):void 0);try{const E=t.startsWith("http://")||t.startsWith("https://")?t:`${T}${t.startsWith("/")?"":"/"}${t}`,n=await F(E,{method:"GET",headers:{[p]:s,"Content-Type":D},...a!==void 0&&{signal:a}});if(i!==void 0&&(clearTimeout(i),i=void 0),!n.ok){let R=G;const L=n.status;let d;if(L===429){const _=n.headers.get("Retry-After");if(_){const e=parseInt(_,10);Number.isNaN(e)||(d=e)}}try{const _=n.headers.get("content-type");if(_!=null&&_.includes("application/json")){const e=await n.json();e!=null&&e.message?R=e.message:e!=null&&e.err&&(R=e.err)}}catch{}throw new l(R,L,d)}return n.json()}catch(E){throw i!==void 0&&(clearTimeout(i),i=void 0),E}}async function H(t,s,r,o,c){if(!s)throw new Error(h);const{signal:F,timeout:i,fetch:A=fetch}=c??{};let a,E;const n=F||(i?(E=new AbortController,a=setTimeout(()=>{E==null||E.abort()},i),E.signal):void 0);try{const d={method:{CREATE:"POST",UPDATE:"PUT",DELETE:"DELETE"}[r],headers:{"Content-Type":"application/json",[p]:s},...n!==void 0&&{signal:n}};o&&(d.body=JSON.stringify(o));const _=t.startsWith("http://")||t.startsWith("https://")?t:`${T}${t.startsWith("/")?"":"/"}${t}`,e=await A(_,d);if(a!==void 0&&(clearTimeout(a),a=void 0),!e.ok){const S=e.status;let u="An API error occurred",M;if(S===429){const I=e.headers.get("Retry-After");if(I){const f=parseInt(I,10);Number.isNaN(f)||(M=f)}}try{const I=e.headers.get("content-type");if(I!=null&&I.includes("application/json")){const f=await e.json();u=f.err||f.message||u}}catch{}throw new l(u,S,M)}return e.status===204||!e.body?{}:e.json()}catch(R){throw a!==void 0&&(clearTimeout(a),a=void 0),R}}function $(t,s){return t.filter(r=>{let o=!0;return s.resolvedType&&(o=o&&r.resolvedType===s.resolvedType),s.name&&(o=o&&r.name.includes(s.name)),o})}exports.CONTENT_TYPE_JSON=D;exports.ERROR_MSG_BULK_UPDATE_FAILED=U;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=w;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=b;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=G;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=B;exports.ERROR_MSG_TOKEN_REQUIRED=h;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=C;exports.FIGMA_API_BASE_URL=T;exports.FIGMA_FILES_ENDPOINT=O;exports.FIGMA_FILE_VARIABLES_PATH=P;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=y;exports.FIGMA_PUBLISHED_VARIABLES_PATH=v;exports.FIGMA_TOKEN_HEADER=p;exports.FigmaApiError=l;exports.fetcher=V;exports.filterVariables=$;exports.mutator=H;

package/dist/index-ClHLYVvu.js

@@ -0,0 +1,142 @@
+var L = Object.defineProperty;
+var S = (t, s, r) => s in t ? L(t, s, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[s] = r;
+var I = (t, s, r) => S(t, typeof s != "symbol" ? s + "" : s, r);
+const T = "https://api.figma.com", M = `${T}/v1/files`, D = (t) => `/v1/files/${t}/variables/published`, G = (t) => `/v1/files/${t}/variables`, b = (t) => `${M}/${t}/variables/local`, N = "application/json", y = "X-FIGMA-TOKEN", F = "A Figma API token is required.", P = `${F} and file key are required.`, C = "Failed to perform bulk update.", $ = "Failed to create Figma variable.", U = "Failed to delete Figma variable.", j = "Failed to update Figma variable.", O = "An error occurred while fetching data from the Figma API.";
+class p extends Error {
+  constructor(r, a, A) {
+    super(r);
+    /** HTTP status code from the API response. */
+    I(this, "statusCode");
+    /**
+     * Retry-After header value in seconds (for 429 rate limit errors).
+     * Undefined if not a rate limit error or header not present.
+     */
+    I(this, "retryAfter");
+    this.name = "FigmaApiError", this.statusCode = a, this.retryAfter = A ?? void 0, Error.captureStackTrace && Error.captureStackTrace(this, p);
+  }
+}
+async function B(t, s, r) {
+  if (!s)
+    throw new Error(F);
+  const {
+    signal: a,
+    timeout: A,
+    fetch: u = fetch
+  } = r ?? {};
+  let o, d;
+  const i = a || (A ? (d = new AbortController(), o = setTimeout(() => {
+    d == null || d.abort();
+  }, A), d.signal) : void 0);
+  try {
+    const n = t.startsWith("http://") || t.startsWith("https://") ? t : `${T}${t.startsWith("/") ? "" : "/"}${t}`, c = await u(n, {
+      method: "GET",
+      headers: {
+        [y]: s,
+        "Content-Type": N
+      },
+      ...i !== void 0 && { signal: i }
+    });
+    if (o !== void 0 && (clearTimeout(o), o = void 0), !c.ok) {
+      let f = O;
+      const m = c.status;
+      let h;
+      if (m === 429) {
+        const E = c.headers.get("Retry-After");
+        if (E) {
+          const e = parseInt(E, 10);
+          Number.isNaN(e) || (h = e);
+        }
+      }
+      try {
+        const E = c.headers.get("content-type");
+        if (E != null && E.includes("application/json")) {
+          const e = await c.json();
+          e != null && e.message ? f = e.message : e != null && e.err && (f = e.err);
+        }
+      } catch {
+      }
+      throw new p(f, m, h);
+    }
+    return c.json();
+  } catch (n) {
+    throw o !== void 0 && (clearTimeout(o), o = void 0), n;
+  }
+}
+async function H(t, s, r, a, A) {
+  if (!s)
+    throw new Error(F);
+  const {
+    signal: u,
+    timeout: o,
+    fetch: d = fetch
+  } = A ?? {};
+  let i, n;
+  const c = u || (o ? (n = new AbortController(), i = setTimeout(() => {
+    n == null || n.abort();
+  }, o), n.signal) : void 0);
+  try {
+    const h = {
+      method: {
+        CREATE: "POST",
+        UPDATE: "PUT",
+        DELETE: "DELETE"
+      }[r],
+      headers: {
+        "Content-Type": "application/json",
+        [y]: s
+      },
+      ...c !== void 0 && { signal: c }
+    };
+    a && (h.body = JSON.stringify(a));
+    const E = t.startsWith("http://") || t.startsWith("https://") ? t : `${T}${t.startsWith("/") ? "" : "/"}${t}`, e = await d(E, h);
+    if (i !== void 0 && (clearTimeout(i), i = void 0), !e.ok) {
+      const g = e.status;
+      let R = "An API error occurred", v;
+      if (g === 429) {
+        const l = e.headers.get("Retry-After");
+        if (l) {
+          const _ = parseInt(l, 10);
+          Number.isNaN(_) || (v = _);
+        }
+      }
+      try {
+        const l = e.headers.get("content-type");
+        if (l != null && l.includes("application/json")) {
+          const _ = await e.json();
+          R = _.err || _.message || R;
+        }
+      } catch {
+      }
+      throw new p(R, g, v);
+    }
+    return e.status === 204 || !e.body ? {} : e.json();
+  } catch (f) {
+    throw i !== void 0 && (clearTimeout(i), i = void 0), f;
+  }
+}
+function V(t, s) {
+  return t.filter((r) => {
+    let a = !0;
+    return s.resolvedType && (a = a && r.resolvedType === s.resolvedType), s.name && (a = a && r.name.includes(s.name)), a;
+  });
+}
+export {
+  N as C,
+  F as E,
+  G as F,
+  P as a,
+  p as b,
+  V as c,
+  T as d,
+  M as e,
+  B as f,
+  D as g,
+  b as h,
+  y as i,
+  C as j,
+  $ as k,
+  U as l,
+  H as m,
+  j as n,
+  O as o
+};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react/jsx-runtime"),i=require("react"),_=require("swr"),p=i.createContext(void 0),v=({children:e,token:o,fileKey:t,fallbackFile:r})=>{const s=r===void 0?{token:o,fileKey:t}:{token:o,fileKey:t,fallbackFile:r};return b.jsx(p.Provider,{value:s,children:e})},l=()=>{const e=i.useContext(p);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e},h="https://api.figma.com",w=`${h}/v1/variables`,T=w,A=e=>`${w}/${e}`,I="application/json",y="X-FIGMA-TOKEN",c="A Figma API token is required.",g="An error occurred while fetching data from the Figma API.";async function V(e,o){if(!o)throw new Error(c);const t=await fetch(e,{method:"GET",headers:{[y]:o,"Content-Type":I}});if(!t.ok){let r=g;try{const s=await t.json();s!=null&&s.message&&(r=s.message)}catch{}throw new Error(r)}return t.json()}const E=()=>{const{token:e,fileKey:o}=l(),t=e&&o?`https://api.figma.com/v1/files/${o}/variables/local`:null;return _(t&&e?[t,e]:null,t&&e?([s,n])=>V(s,n):()=>Promise.resolve(void 0))},R=()=>{const{data:e}=E(),o=i.useMemo(()=>e!=null&&e.meta?Object.values(e.meta.variableCollections):[],[e]),t=i.useMemo(()=>e!=null&&e.meta?e.meta.variableCollections:{},[e]);return{collections:o,collectionsById:t}},C=()=>{const{data:e}=E();return i.useMemo(()=>{const o=[],t={},r={};if(e!=null&&e.meta)for(const s of Object.values(e.meta.variableCollections)){o.push(...s.modes),t[s.id]=s.modes;for(const n of s.modes)r[n.modeId]=n}return{modes:o,modesByCollectionId:t,modesById:r}},[e])};function M(e,o){switch(o.type){case"loading":return{...e,status:"loading",error:null};case"success":return{...e,status:"success",data:o.payload};case"error":return{...e,status:"error",error:o.payload};default:return e}}const d=e=>{const o={status:"idle",data:null,error:null},[t,r]=i.useReducer(M,o);return{mutate:i.useCallback(async n=>{r({type:"loading"});try{const a=await e(n);return r({type:"success",payload:a}),a}catch(a){r({type:"error",payload:a});return}},[e]),...t,isLoading:t.status==="loading",isSuccess:t.status==="success",isError:t.status==="error"}};async function m(e,o,t,r){if(!o)throw new Error(c);const a={method:{CREATE:"POST",UPDATE:"PUT",DELETE:"DELETE"}[t],headers:{"Content-Type":"application/json",[y]:o}};r&&(a.body=JSON.stringify(r));const u=await fetch(`${h}${e}`,a);if(!u.ok){const f=await u.json().catch(()=>({}));throw new Error(f.err||f.message||"An API error occurred")}return u.status===204||!u.body?{}:u.json()}const P=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(T,e,"CREATE",t)})},O=()=>{const{token:e}=l();return d(async({variableId:t,payload:r})=>{if(!e)throw new Error(c);return await m(A(t),e,"UPDATE",r)})},D=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(A(t),e,"DELETE",void 0)})},F=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(T,e,"CREATE",t)})};function S(e,o){return e.filter(t=>{let r=!0;return o.resolvedType&&(r=r&&t.resolvedType===o.resolvedType),o.name&&(r=r&&t.name.includes(o.name)),r})}exports.FigmaVarsProvider=v;exports.filterVariables=S;exports.useBulkUpdateVariables=F;exports.useCreateVariable=P;exports.useDeleteVariable=D;exports.useUpdateVariable=O;exports.useVariableCollections=R;exports.useVariableModes=C;exports.useVariables=E;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("react/jsx-runtime"),u=require("react"),m=require("swr"),i=require("./index-5ZyKWuYv.cjs"),k=u.createContext(void 0);function A(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 _(e){if(A(e))return e}const V=({children:e,token:r,fileKey:t,fallbackFile:o,swrConfig:s})=>{const a=u.useId(),l=u.useMemo(()=>`figma-vars-provider-${a}`,[a]),f=u.useMemo(()=>{if(o){if(typeof o=="object"){const n=_(o);if(n)return n;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 n=JSON.parse(o),d=_(n);if(d)return d;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(n){process.env.NODE_ENV!=="production"&&console.error(`[figma-vars-hooks] Failed to parse fallbackFile JSON: ${n instanceof Error?n.message:"Unknown error"}`);return}}},[o]),c=u.useMemo(()=>{const n={token:r,fileKey:t,providerId:l,...s!==void 0&&{swrConfig:s}};return o===void 0?n:{...n,fallbackFile:o,parsedFallbackFile:f}},[r,t,o,f,l,s]);return g.jsx(k.Provider,{value:c,children:e})},b=()=>{const e=u.useContext(k);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e};function M(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e;return!!(t&&r)&&t&&r?[`https://api.figma.com/v1/files/${r}/variables/local`,t]:s?[`fallback-${o??"default"}`,"fallback"]:null}function O(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e;return!!(t&&r)&&t&&r?[`https://api.figma.com/v1/files/${r}/variables/published`,t]:s?[`fallback-${o??"default"}`,"fallback"]:null}function I(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=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])),s&&o&&a.push([`fallback-${o}`,"fallback"]),a}const R=()=>{const{token:e,fileKey:r,fallbackFile:t,parsedFallbackFile:o,providerId:s,swrConfig:a}=b(),f=M({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return m(f,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[d,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!d||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(d,E)},a)},S=()=>{const{data:e}=R(),r=u.useMemo(()=>e!=null&&e.meta?Object.values(e.meta.variableCollections):[],[e]),t=u.useMemo(()=>e!=null&&e.meta?e.meta.variableCollections:{},[e]);return{collections:r,collectionsById:t}},K=()=>{const{data:e}=R();return u.useMemo(()=>{const r=[],t={},o={};if(e!=null&&e.meta)for(const s of Object.values(e.meta.variableCollections)){r.push(...s.modes),t[s.id]=s.modes;for(const a of s.modes)o[a.modeId]=a}return{modes:r,modesByCollectionId:t,modesById:o}},[e])};function T(e,r){switch(r.type){case"loading":return{...e,status:"loading",error:null};case"success":return{...e,status:"success",data:r.payload};case"error":return{...e,status:"error",error:r.payload};default:return e}}const v=(e,r)=>{const{throwOnError:t=!1}={},o={status:"idle",data:null,error:null},[s,a]=u.useReducer(T,o),l=u.useRef(e),f=u.useRef({throwOnError:t}),c=u.useRef(!0),n=u.useRef(0);return u.useEffect(()=>{l.current=e,f.current={throwOnError:t}},[e,t]),u.useEffect(()=>(c.current=!0,()=>{c.current=!1}),[]),{mutate:u.useCallback(async E=>{if(!c.current)return;const y=++n.current;a({type:"loading"});try{const p=await l.current(E);return c.current&&y===n.current&&a({type:"success",payload:p}),p}catch(p){const h=p;if(c.current&&y===n.current&&a({type:"error",payload:h}),f.current.throwOnError)throw h;return}},[]),...s,isLoading:s.status==="loading",isSuccess:s.status==="success",isError:s.status==="error"}},C=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"CREATE",{variables:[{action:"CREATE",...o}]})})},L=()=>{const{token:e,fileKey:r}=b();return v(async({variableId:o,payload:s})=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",{variables:[{action:"UPDATE",id:o,...s}]})})},P=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"DELETE",{variables:[{action:"DELETE",id:o}]})})},D=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",o)})},U=()=>{const{mutate:e}=m.useSWRConfig(),{token:r,fileKey:t,fallbackFile:o,providerId:s}=b(),a=!!o;return{invalidate:()=>{const c=I({fileKey:t,token:r,providerId:s,hasFallback:a});for(const n of c)e(n)},revalidate:()=>{const c=I({fileKey:t,token:r,providerId:s,hasFallback:a});for(const n of c)e(n,void 0,{revalidate:!0})}}},N=()=>{const{token:e,fileKey:r,fallbackFile:t,parsedFallbackFile:o,providerId:s,swrConfig:a}=b(),f=O({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return m(f,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[d,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!d||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(d,E)},a)};function w(e){return e instanceof i.FigmaApiError}function F(e){return w(e)?e.statusCode:null}function j(e,r="An error occurred"){return e instanceof Error?e.message||r:typeof e=="string"?e:r}function B(e,r){return F(e)===r}exports.FigmaApiError=i.FigmaApiError;exports.filterVariables=i.filterVariables;exports.FigmaVarsProvider=V;exports.getErrorMessage=j;exports.getErrorStatus=F;exports.hasErrorStatus=B;exports.isFigmaApiError=w;exports.useBulkUpdateVariables=D;exports.useCreateVariable=C;exports.useDeleteVariable=P;exports.useInvalidateVariables=U;exports.usePublishedVariables=N;exports.useUpdateVariable=L;exports.useVariableCollections=S;exports.useVariableModes=K;exports.useVariables=R;

package/dist/index.d.cts

@@ -52,20 +52,25 @@ export { FigmaVarsProvider } from 'contexts';
  * }
  * ```
  */
-export { useVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, } from 'hooks';
+export { useVariables, usePublishedVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, useInvalidateVariables, } from 'hooks';
 /**
  * Utility functions for Figma Variable management.
  *
  * @remarks
- * Helpers like `filterVariables` for searching and filtering variable lists. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
+ * Helpers like `filterVariables` for searching and filtering variable lists, and error handling utilities. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
  *
  * @example
  * ```ts
- * import { filterVariables } from '@figma-vars/hooks';
+ * import { filterVariables, isFigmaApiError, getErrorStatus } from '@figma-vars/hooks';
  * const filtered = filterVariables(variables, { resolvedType: 'COLOR' });
+ *
+ * // Error handling
+ * if (isFigmaApiError(error)) {
+ *   console.log('Status:', error.statusCode);
+ * }
  * ```
  */
-export { filterVariables } from 'utils';
+export { filterVariables, isFigmaApiError, getErrorStatus, getErrorMessage, hasErrorStatus, } from 'utils';
 /**
  * All official TypeScript types for advanced usage and type-safe integration.
  *

package/dist/index.d.ts

@@ -52,20 +52,25 @@ export { FigmaVarsProvider } from 'contexts';
  * }
  * ```
  */
-export { useVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, } from 'hooks';
+export { useVariables, usePublishedVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, useInvalidateVariables, } from 'hooks';
 /**
  * Utility functions for Figma Variable management.
  *
  * @remarks
- * Helpers like `filterVariables` for searching and filtering variable lists. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
+ * Helpers like `filterVariables` for searching and filtering variable lists, and error handling utilities. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
  *
  * @example
  * ```ts
- * import { filterVariables } from '@figma-vars/hooks';
+ * import { filterVariables, isFigmaApiError, getErrorStatus } from '@figma-vars/hooks';
  * const filtered = filterVariables(variables, { resolvedType: 'COLOR' });
+ *
+ * // Error handling
+ * if (isFigmaApiError(error)) {
+ *   console.log('Status:', error.statusCode);
+ * }
  * ```
  */
-export { filterVariables } from 'utils';
+export { filterVariables, isFigmaApiError, getErrorStatus, getErrorMessage, hasErrorStatus, } from 'utils';
 /**
  * All official TypeScript types for advanced usage and type-safe integration.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC;;;;;;;;;;GAUG;AACH,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,OAAO,CAAA;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,OAAO,CAAA;AAEd;;;;;;;;;;GAUG;AACH,cAAc,OAAO,CAAA"}