@figma-vars/hooks 3.1.0 → 4.0.0

package/README.md

@@ -10,24 +10,25 @@ A fast, typed React 19.2.3 hooks library for the Figma Variables API: fetch, upd
 
 Built for the modern web, this library provides a suite of hooks to fetch, manage, and mutate your design tokens/variables, making it easy to sync them between Figma and your React applications, Storybooks, or design system dashboards.
 
-![Status](https://img.shields.io/badge/status-stable-brightgreen)
-![CI](https://github.com/marklearst/figma-vars-hooks/actions/workflows/ci.yml/badge.svg)
-[![codecov](https://codecov.io/gh/marklearst/figma-vars-hooks/branch/main/graph/badge.svg)](https://codecov.io/gh/marklearst/figma-vars-hooks)
-![Test Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)
-![License](https://img.shields.io/github/license/marklearst/figma-vars-hooks)
-![GitHub last commit](https://img.shields.io/github/last-commit/marklearst/figma-vars-hooks)
-![GitHub code size](https://img.shields.io/github/languages/code-size/marklearst/figma-vars-hooks)
-
-## 📌 Why 3.0
-
-- ✨ **New DX Features**: SWR configuration support, error handling utilities, cache invalidation helpers
-- 🔧 **React 19.2 Ready**: Optimized hooks with proper cleanup and stable function references
-- 🛡️ **Better Error Handling**: `FigmaApiError` class with HTTP status codes for better error differentiation
-- ✅ **Type Safety**: Removed unsafe type assertions, improved type definitions throughout
-- 🚀 **Performance**: Hardened SWR usage (stable keys, `null` to disable, cleaner fallback handling)
+| Package                                                                                                               | Quality                                                                                                                                        | Activity                                                                                           |
+| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| [![npm version](https://img.shields.io/npm/v/%40figma-vars%2Fhooks)](https://www.npmjs.com/package/@figma-vars/hooks) | ![CI](https://github.com/marklearst/figma-vars-hooks/actions/workflows/ci.yml/badge.svg)                                                       | ![GitHub last commit](https://img.shields.io/github/last-commit/marklearst/figma-vars-hooks)       |
+| ![npm downloads](https://img.shields.io/npm/dm/%40figma-vars%2Fhooks)                                                 | [![codecov](https://codecov.io/gh/marklearst/figma-vars-hooks/branch/main/graph/badge.svg)](https://codecov.io/gh/marklearst/figma-vars-hooks) | ![Status](https://img.shields.io/badge/status-stable-brightgreen)                                  |
+| ![bundle size](https://img.shields.io/bundlephobia/minzip/%40figma-vars%2Fhooks)                                      | ![Test Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)                                                                     | ![License](https://img.shields.io/github/license/marklearst/figma-vars-hooks)                      |
+| ![node version](https://img.shields.io/node/v/%40figma-vars%2Fhooks)                                                  | ![TypeScript](https://img.shields.io/badge/TypeScript-100%25_Strict-blue?logo=typescript)                                                      | ![GitHub code size](https://img.shields.io/github/languages/code-size/marklearst/figma-vars-hooks) |
+
+## 📌 Why 4.0.0
+
+- ✨ **New Utilities**: `withRetry()` for automatic retry with exponential backoff, `redactToken()` for safe logging
+- 🔧 **Flexible API**: `baseUrl` option for fetcher/mutator, `caseInsensitive` option for filterVariables
+- 🛡️ **Better Error Handling**: Improved parsing for non-JSON API responses (HTML, plain text)
+- 🐛 **Critical Bug Fix**: SWR cache keys now correctly separate fallback and live data
+- 📚 **Improved Docs**: Comprehensive mutation return type documentation with examples
 - 📦 **Modern Tooling**: Node 20+ toolchain, strict TypeScript, and ESM-first packaging with CJS interop
 - 🖥️ **CLI Export Tool**: Automate variable exports with `figma-vars-export` for CI/CD (Enterprise required)
 
+> ⚠️ **Breaking Change**: `useFigmaToken` is now a named export. See [Migration Guide](#-migration-guide-3x--40).
+
 ## 🚀 Features at a Glance
 
 - **Modern React 19.2 hooks** for variables, collections, modes, and published variables
@@ -301,7 +302,7 @@ if (isLocalVariablesResponse(data)) {
 
 ### Error Utilities
 
-3.0.0 introduces powerful error handling utilities for type-safe error checking:
+v3 introduces powerful error handling utilities for type-safe error checking:
 
 ```tsx
 import { isFigmaApiError, getErrorStatus, getErrorMessage, hasErrorStatus } from '@figma-vars/hooks'
@@ -424,11 +425,13 @@ Customize SWR behavior globally through the provider:
 
 ### Utilities
 
-- **Filtering**: `filterVariables` (filter by type, name, etc.)
-- **Error Handling**: `isFigmaApiError`, `getErrorStatus`, `getErrorMessage`, `hasErrorStatus`
+- **Filtering**: `filterVariables` (filter by type, name, with optional `caseInsensitive` matching)
+- **Retry**: `withRetry` (automatic retry with exponential backoff for rate limits)
+- **Security**: `redactToken` (safely redact tokens for logging/display)
+- **Error Handling**: `isFigmaApiError`, `getErrorStatus`, `getErrorMessage`, `hasErrorStatus`, `isRateLimited`, `getRetryAfter`
 - **Type Guards**: `isLocalVariablesResponse`, `isPublishedVariablesResponse`, `validateFallbackData` (runtime validation)
 - **SWR Keys**: `getVariablesKey`, `getPublishedVariablesKey`, `getInvalidationKeys` (centralized cache key construction)
-- **Core helpers**: `fetcher`, `mutator`, constants for endpoints and headers
+- **Core helpers**: `fetcher`, `mutator` (with `baseUrl` option), constants for endpoints and headers
 
 ### Types
 
@@ -454,13 +457,30 @@ Customize SWR behavior globally through the provider:
 - Never commit PATs or file keys to git, Storybook static builds, or client bundles.
 - Use environment variables (`process.env` / `import.meta.env`) and secret managers; keep them server-side where possible.
 - Prefer `fallbackFile` with `token={null}`/`fileKey={null}` for demos and public Storybooks.
-- Avoid logging tokens or keys; scrub them from error messages and analytics.
+- Use `redactToken()` when logging tokens for debugging:
+
+```ts
+import { redactToken } from '@figma-vars/hooks'
+
+// Safe logging
+console.log('Using token:', redactToken(token))
+// Output: "Using token: figd_***...***cret"
+```
 
 ## 📈 Rate Limits
 
 - Figma enforces per-token limits. Rely on SWR/TanStack caching, avoid unnecessary refetches, and prefer fallback JSON for static sites.
 - Use `swrConfig` to customize `dedupingInterval` and `errorRetryCount` to optimize API usage.
-- Handle `429` rate limit errors with `isFigmaApiError` and implement exponential backoff if needed.
+- Use `withRetry()` utility for automatic retry with exponential backoff on 429 errors:
+
+```ts
+import { withRetry, fetcher } from '@figma-vars/hooks'
+
+const fetchWithRetry = withRetry(() => fetcher('/v1/files/KEY/variables/local', token), {
+  maxRetries: 3,
+  onRetry: (attempt, delay) => console.log(`Retry ${attempt}...`),
+})
+```
 
 ## 📚 Storybook & Next.js
 
@@ -511,11 +531,50 @@ export function Providers({ children }: { children: React.ReactNode }) {
 - `pnpm run build`, `pnpm test`, `pnpm run test:coverage`
 - `pnpm run check:publint`, `pnpm run check:attw`, `pnpm run check:size`
 
-## 🧭 Release Checklist (for 3.0.0)
+## 🧭 Release Checklist (for 4.0.0)
 
 - Run `pnpm run check:release`
-- Tag `v3.0.0` (CI publishes to npm)
-- Update dist-tags on npm if needed (`latest` → 3.0.0)
+- Run `pnpm version major` (creates `v4.0.0` tag)
+- CI publishes to npm automatically
+- Update dist-tags on npm if needed (`latest` → 4.0.0)
+
+## 🔄 Migration Guide (3.x → 4.0)
+
+### Breaking Change: `useFigmaToken` Export
+
+```tsx
+// Before (3.x) - NO LONGER WORKS
+import useFigmaToken from '@figma-vars/hooks'
+
+// After (4.0) - USE THIS
+import { useFigmaToken } from '@figma-vars/hooks'
+```
+
+### New Utilities (opt-in)
+
+```ts
+import { withRetry, redactToken, filterVariables } from '@figma-vars/hooks'
+
+// Automatic retry with exponential backoff
+const fetchWithRetry = withRetry(() => myApiCall(), { maxRetries: 3 })
+
+// Safe token logging
+console.log('Token:', redactToken(token)) // "figd_***...***cret"
+
+// Case-insensitive filtering
+filterVariables(vars, { name: 'primary', caseInsensitive: true })
+```
+
+### Custom API Base URL
+
+```ts
+import { fetcher, mutator } from '@figma-vars/hooks/core'
+
+// Use mock server for testing
+await fetcher('/v1/files/KEY/variables/local', token, {
+  baseUrl: 'http://localhost:3000',
+})
+```
 
 ---
 

package/dist/api/fetcher.d.ts

@@ -16,6 +16,11 @@ export interface FetcherOptions {
      * Optional fetch implementation override (useful for testing or custom fetch implementations).
      */
     fetch?: typeof fetch;
+    /**
+     * Optional base URL override. Defaults to 'https://api.figma.com'.
+     * Useful for testing with mocks or proxies.
+     */
+    baseUrl?: string;
 }
 /**
  * Low-level utility to fetch data from the Figma Variables REST API with authentication.

package/dist/api/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/api/fetcher.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CA0FpB"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/api/fetcher.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAyGpB"}

package/dist/api/mutator.d.ts

@@ -17,6 +17,11 @@ export interface MutatorOptions {
      * Optional fetch implementation override (useful for testing or custom fetch implementations).
      */
     fetch?: typeof fetch;
+    /**
+     * Optional base URL override. Defaults to 'https://api.figma.com'.
+     * Useful for testing with mocks or proxies.
+     */
+    baseUrl?: string;
 }
 /**
  * Low-level utility to send authenticated POST, PUT, or DELETE requests to the Figma Variables REST API.

package/dist/api/mutator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../../src/api/mutator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EACD,iBAAiB,GACjB;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAyGpB"}
+{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../../src/api/mutator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EACD,iBAAiB,GACjB;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAwHpB"}

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./index-5ZyKWuYv.cjs");exports.CONTENT_TYPE_JSON=_.CONTENT_TYPE_JSON;exports.ERROR_MSG_BULK_UPDATE_FAILED=_.ERROR_MSG_BULK_UPDATE_FAILED;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=_.ERROR_MSG_CREATE_VARIABLE_FAILED;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=_.ERROR_MSG_DELETE_VARIABLE_FAILED;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=_.ERROR_MSG_FETCH_FIGMA_DATA_FAILED;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=_.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED;exports.ERROR_MSG_TOKEN_REQUIRED=_.ERROR_MSG_TOKEN_REQUIRED;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=_.ERROR_MSG_UPDATE_VARIABLE_FAILED;exports.FIGMA_API_BASE_URL=_.FIGMA_API_BASE_URL;exports.FIGMA_FILES_ENDPOINT=_.FIGMA_FILES_ENDPOINT;exports.FIGMA_FILE_VARIABLES_PATH=_.FIGMA_FILE_VARIABLES_PATH;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=_.FIGMA_LOCAL_VARIABLES_ENDPOINT;exports.FIGMA_PUBLISHED_VARIABLES_PATH=_.FIGMA_PUBLISHED_VARIABLES_PATH;exports.FIGMA_TOKEN_HEADER=_.FIGMA_TOKEN_HEADER;exports.fetcher=_.fetcher;exports.filterVariables=_.filterVariables;exports.mutator=_.mutator;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./index-DFB8mxu_.cjs");exports.CONTENT_TYPE_JSON=_.CONTENT_TYPE_JSON;exports.ERROR_MSG_BULK_UPDATE_FAILED=_.ERROR_MSG_BULK_UPDATE_FAILED;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=_.ERROR_MSG_CREATE_VARIABLE_FAILED;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=_.ERROR_MSG_DELETE_VARIABLE_FAILED;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=_.ERROR_MSG_FETCH_FIGMA_DATA_FAILED;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=_.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED;exports.ERROR_MSG_TOKEN_REQUIRED=_.ERROR_MSG_TOKEN_REQUIRED;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=_.ERROR_MSG_UPDATE_VARIABLE_FAILED;exports.FIGMA_API_BASE_URL=_.FIGMA_API_BASE_URL;exports.FIGMA_FILES_ENDPOINT=_.FIGMA_FILES_ENDPOINT;exports.FIGMA_FILE_VARIABLES_PATH=_.FIGMA_FILE_VARIABLES_PATH;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=_.FIGMA_LOCAL_VARIABLES_ENDPOINT;exports.FIGMA_PUBLISHED_VARIABLES_PATH=_.FIGMA_PUBLISHED_VARIABLES_PATH;exports.FIGMA_TOKEN_HEADER=_.FIGMA_TOKEN_HEADER;exports.fetcher=_.fetcher;exports.filterVariables=_.filterVariables;exports.mutator=_.mutator;

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { C as A, j as R, k as I, l as a, o as L, a as s, E as F, n as T, d as D, e as O, F as G, h as M, g as S, i as N, f as B, c as P, m as U } from "./index-ClHLYVvu.js";
+import { C as A, j as R, k as I, l as a, o as L, a as s, E as F, n as T, d as D, e as O, F as G, h as M, g as S, i as N, f as B, c as P, m as U } from "./index-Dqg9kaMQ.js";
 export {
   A as CONTENT_TYPE_JSON,
   R as ERROR_MSG_BULK_UPDATE_FAILED,

package/dist/hooks/useBulkUpdateVariables.d.ts

@@ -6,21 +6,35 @@ import { BulkUpdatePayload } from '../types/mutations';
  * This hook is designed to perform a batch operation for creating, updating, and deleting variables, collections, and modes.
  * It provides an ergonomic API with `mutate` and loading/error state for easy integration.
  *
+ * ## Return Value
+ *
+ * The `mutate` function returns `Promise<TData | undefined>`:
+ * - On success: Returns the API response data
+ * - On error: Returns `undefined` (error stored in `error` state)
+ *
+ * Use `isSuccess`/`isError` flags or check the return value to handle results.
+ *
+ * @returns MutationResult with `mutate`, status flags (`isLoading`, `isSuccess`, `isError`),
+ * `data` (API response), and `error` (if failed).
+ *
  * @example
  * ```tsx
  * import { useBulkUpdateVariables } from '@figma-vars/hooks';
  *
  * function BulkUpdateButton() {
- *   const { mutate, isLoading, error } = useBulkUpdateVariables();
+ *   const { mutate, isLoading, isError, error } = useBulkUpdateVariables();
  *
- *   const handleBulkUpdate = () => {
- *     mutate({
+ *   const handleBulkUpdate = async () => {
+ *     const result = await mutate({
  *       variables: [{ action: 'UPDATE', id: 'VariableId:123', name: 'new-name' }],
  *     });
+ *     if (result) {
+ *       console.log('Bulk update successful');
+ *     }
  *   };
  *
  *   if (isLoading) return <div>Updating...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isError) return <div>Error: {error?.message}</div>;
  *   return <button onClick={handleBulkUpdate}>Bulk Update</button>;
  * }
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"useBulkUpdateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useBulkUpdateVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,sBAAsB,4EAiBlC,CAAA"}
+{"version":3,"file":"useBulkUpdateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useBulkUpdateVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,sBAAsB,4EAiBlC,CAAA"}

package/dist/hooks/useCreateVariable.d.ts

@@ -5,19 +5,37 @@ import { CreateVariablePayload } from '../types/mutations';
  * @remarks
  * The hook returns a `mutate` function to trigger the creation along with state flags and data.
  *
+ * ## Return Value
+ *
+ * The `mutate` function returns `Promise<TData | undefined>`:
+ * - On success: Returns the API response data
+ * - On error: Returns `undefined` (error stored in `error` state)
+ *
+ * Use `isSuccess`/`isError` flags or check the return value to handle results.
+ *
+ * @returns MutationResult with `mutate`, status flags (`isLoading`, `isSuccess`, `isError`),
+ * `data` (API response), and `error` (if failed).
+ *
  * @example
  * ```tsx
  * import { useCreateVariable } from '@figma-vars/hooks';
  *
  * function CreateVariableButton() {
- *   const { mutate, isLoading, error } = useCreateVariable();
+ *   const { mutate, isLoading, isError, error } = useCreateVariable();
  *
- *   const handleCreate = () => {
- *     mutate({ name: 'new-variable', variableCollectionId: 'VariableCollectionId:1:1', resolvedType: 'COLOR' });
+ *   const handleCreate = async () => {
+ *     const result = await mutate({
+ *       name: 'new-variable',
+ *       variableCollectionId: 'VariableCollectionId:1:1',
+ *       resolvedType: 'COLOR'
+ *     });
+ *     if (result) {
+ *       console.log('Created successfully:', result);
+ *     }
  *   };
  *
  *   if (isLoading) return <div>Creating...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isError) return <div>Error: {error?.message}</div>;
  *   return <button onClick={handleCreate}>Create Variable</button>;
  * }
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"useCreateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useCreateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,iBAAiB,gFAmB7B,CAAA"}
+{"version":3,"file":"useCreateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useCreateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,iBAAiB,gFAmB7B,CAAA"}

package/dist/hooks/useDeleteVariable.d.ts

@@ -4,17 +4,33 @@
  * @remarks
  * This hook provides a `mutate` function to trigger the deletion and exposes loading and error states.
  *
+ * ## Return Value
+ *
+ * The `mutate` function returns `Promise<TData | undefined>`:
+ * - On success: Returns the API response data
+ * - On error: Returns `undefined` (error stored in `error` state)
+ *
+ * Use `isSuccess`/`isError` flags or check the return value to handle results.
+ *
+ * @returns MutationResult with `mutate`, status flags (`isLoading`, `isSuccess`, `isError`),
+ * `data` (API response), and `error` (if failed).
+ *
  * @example
  * ```tsx
  * import { useDeleteVariable } from '@figma-vars/hooks';
  *
  * function DeleteVariableButton({ id }: { id: string }) {
- *   const { mutate, isLoading, error } = useDeleteVariable();
+ *   const { mutate, isLoading, isError, error } = useDeleteVariable();
  *
- *   const onDelete = () => mutate(id);
+ *   const onDelete = async () => {
+ *     const result = await mutate(id);
+ *     if (result) {
+ *       console.log('Deleted successfully');
+ *     }
+ *   };
  *
  *   if (isLoading) return <div>Deleting...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isError) return <div>Error: {error?.message}</div>;
  *   return <button onClick={onDelete}>Delete Variable</button>;
  * }
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"useDeleteVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useDeleteVariable.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,oDAmB7B,CAAA"}
+{"version":3,"file":"useDeleteVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useDeleteVariable.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,iBAAiB,oDAmB7B,CAAA"}

package/dist/hooks/useUpdateVariable.d.ts

@@ -5,17 +5,33 @@ import { UpdateVariablePayload } from '../types/mutations';
  * @remarks
  * The hook returns a `mutate` function to trigger the update with given payload and exposes state flags.
  *
+ * ## Return Value
+ *
+ * The `mutate` function returns `Promise<TData | undefined>`:
+ * - On success: Returns the API response data
+ * - On error: Returns `undefined` (error stored in `error` state)
+ *
+ * Use `isSuccess`/`isError` flags or check the return value to handle results.
+ *
+ * @returns MutationResult with `mutate`, status flags (`isLoading`, `isSuccess`, `isError`),
+ * `data` (API response), and `error` (if failed).
+ *
  * @example
  * ```tsx
  * import { useUpdateVariable } from '@figma-vars/hooks';
  *
  * function UpdateVariableButton({ id }: { id: string }) {
- *   const { mutate, isLoading, error } = useUpdateVariable();
+ *   const { mutate, isLoading, isError, error } = useUpdateVariable();
  *
- *   const onUpdate = () => mutate({ variableId: id, payload: { name: 'new-name' } });
+ *   const onUpdate = async () => {
+ *     const result = await mutate({ variableId: id, payload: { name: 'new-name' } });
+ *     if (result) {
+ *       console.log('Updated successfully');
+ *     }
+ *   };
  *
  *   if (isLoading) return <div>Updating...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
+ *   if (isError) return <div>Error: {error?.message}</div>;
  *   return <button onClick={onUpdate}>Update Variable</button>;
  * }
  * ```

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

@@ -1 +1 @@
-{"version":3,"file":"useUpdateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB;gBAOZ,MAAM;aACT,qBAAqB;EAyBnC,CAAA"}
+{"version":3,"file":"useUpdateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,iBAAiB;gBAOZ,MAAM;aACT,qBAAqB;EAyBnC,CAAA"}

package/dist/index-DFB8mxu_.cjs

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

package/dist/index-Dqg9kaMQ.js

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

package/dist/index.cjs

@@ -1 +1 @@
-"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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("react/jsx-runtime"),u=require("react"),v=require("swr"),i=require("./index-DFB8mxu_.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(),d=u.useMemo(()=>`figma-vars-provider-${a}`,[a]),l=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),f=_(n);if(f)return f;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:d,...s!==void 0&&{swrConfig:s}};return o===void 0?n:{...n,fallbackFile:o,parsedFallbackFile:l}},[r,t,o,l,d,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 s?[`fallback-${o??"default"}`,"fallback"]:t&&r?[`https://api.figma.com/v1/files/${r}/variables/local`,t]:null}function O(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e;return s?[`fallback-${o??"default"}`,"fallback"]:t&&r?[`https://api.figma.com/v1/files/${r}/variables/published`,t]: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(),l=M({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return v(l,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[f,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!f||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(f,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 m=(e,r)=>{const{throwOnError:t=!1}={},o={status:"idle",data:null,error:null},[s,a]=u.useReducer(T,o),d=u.useRef(e),l=u.useRef({throwOnError:t}),c=u.useRef(!0),n=u.useRef(0);return u.useEffect(()=>{d.current=e,l.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 d.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}),l.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 m(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}]})})},P=()=>{const{token:e,fileKey:r}=b();return m(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}]})})},D=()=>{const{token:e,fileKey:r}=b();return m(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}]})})},L=()=>{const{token:e,fileKey:r}=b();return m(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}=v.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(),l=O({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return v(l,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[f,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!f||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(f,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 x(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=x;exports.isFigmaApiError=w;exports.useBulkUpdateVariables=L;exports.useCreateVariable=C;exports.useDeleteVariable=D;exports.useInvalidateVariables=U;exports.usePublishedVariables=N;exports.useUpdateVariable=P;exports.useVariableCollections=S;exports.useVariableModes=K;exports.useVariables=R;