@fairu/sdk 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [1.0.1](https://github.com/sushidev-team/fairu-sdk-typescript/compare/v1.0.0...v1.0.1) (2026-01-05)
+
+
+### Bug Fixes
+
+* include generated GraphQL types in repository ([e917822](https://github.com/sushidev-team/fairu-sdk-typescript/commit/e917822299fa527ac82e3e5a1012dcb594e8f2cd))
+
+## 1.0.0 (2026-01-04)
+
+
+### Bug Fixes
+
+* add codegen step to CI workflow ([2802899](https://github.com/sushidev-team/fairu-sdk-typescript/commit/28028995f4978284a879eb5bb034269a0d1cf9fa))
+* add ESLint 9 flat config ([6870d77](https://github.com/sushidev-team/fairu-sdk-typescript/commit/6870d77ba4258665f2b7a46e7cb1a4ab092f222d))

package/README.md

@@ -0,0 +1,447 @@
+# @fairu/sdk
+
+TypeScript SDK for the Fairu GraphQL API with React hooks and vanilla client support.
+
+## Features
+
+- **React Hooks** for all GraphQL operations (assets, folders, galleries, copyrights, licenses, users, roles, etc.)
+- **Vanilla Client** for Node.js and non-React frameworks
+- **Fragment System** with fluent builder API
+- **Upload Hooks** with progress tracking (simple + multipart)
+- **FileProxy URL Builder** for image transformations
+- **Graphcache** for normalized caching
+- **Full TypeScript support** with generated types from the GraphQL schema
+- **Dynamic Base URL** configuration with environment variable support
+
+## Installation
+
+```bash
+npm install @fairu/sdk urql graphql
+```
+
+For React applications:
+```bash
+npm install @fairu/sdk urql graphql react react-dom
+```
+
+## Quick Start
+
+### React
+
+```tsx
+import { FairuProvider, useAssets, useUpload } from '@fairu/sdk/react';
+
+function App() {
+  return (
+    <FairuProvider
+      url="https://fairu.app/graphql"
+      token={process.env.FAIRU_TOKEN}
+    >
+      <AssetGallery />
+    </FairuProvider>
+  );
+}
+
+function AssetGallery() {
+  const { assets, fetching, error, hasMore, total } = useAssets({
+    page: 1,
+    perPage: 20
+  });
+  const { upload, progress, status } = useUpload();
+
+  if (fetching) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      <p>{total} assets found</p>
+      {assets.map((asset) => (
+        <img key={asset.id} src={asset.url} alt={asset.alt} />
+      ))}
+    </div>
+  );
+}
+```
+
+### Vanilla TypeScript
+
+```typescript
+import { createVanillaClient } from '@fairu/sdk/vanilla';
+
+const client = createVanillaClient({
+  url: 'https://fairu.app/graphql',
+  token: 'your-token',
+});
+
+// Fetch an asset
+const asset = await client.assets.find('asset-id');
+
+// List assets with pagination
+const { data, paginatorInfo } = await client.assets.list({
+  page: 1,
+  perPage: 20,
+  folderId: 'folder-id',
+});
+
+// Upload a file
+const result = await client.upload.simple(file, {
+  folderId: 'folder-id',
+  alt: 'My image',
+});
+```
+
+## Examples
+
+Check out the complete example applications:
+
+- **[Vite + React Example](./examples/vite-react/)** - Full-featured example with asset browser, gallery viewer, search, and file uploads
+- **[Next.js App Router Example](./examples/nextjs-app/)** - Example using Next.js 15 with App Router and optimized images
+
+## API Reference
+
+### React Hooks
+
+#### Asset Hooks
+
+```tsx
+import { useAsset, useAssets, useSearch, useMultipleAssets } from '@fairu/sdk/react';
+
+// Fetch single asset by ID
+const { asset, fetching, error, refetch } = useAsset('asset-id');
+
+// Fetch asset by path
+const { asset } = useAssetByPath('/folder/image.jpg');
+
+// Fetch paginated assets
+const { assets, pagination, hasMore, total, refetch } = useAssets({
+  page: 1,
+  perPage: 20,
+  folder: 'folder-id',
+});
+
+// Search assets
+const { assets, pagination, hasMore } = useSearch('search query', {
+  page: 1,
+  perPage: 20,
+  orderBy: 'created_at',
+  orderDirection: 'DESC',
+});
+
+// Fetch multiple assets by IDs
+const { assets, fetching } = useMultipleAssets(['id1', 'id2', 'id3']);
+```
+
+#### Folder Hooks
+
+```tsx
+import { useFolder, useFolderByPath } from '@fairu/sdk/react';
+
+// Browse folder contents (assets + subfolders)
+const { entries, pagination, hasMore } = useFolder({
+  folder: 'folder-id',
+  page: 1,
+  perPage: 50,
+  search: 'optional search',
+  orderBy: 'name',
+  orderDirection: 'ASC',
+});
+
+// Get folder by path
+const { folder } = useFolderByPath('/path/to/folder');
+```
+
+#### Gallery Hooks
+
+```tsx
+import { useGallery, useGalleries, useGalleryItems } from '@fairu/sdk/react';
+
+// Fetch single gallery
+const { gallery, fetching, error } = useGallery('gallery-id');
+
+// Fetch galleries list
+const { galleries, pagination, hasMore, total } = useGalleries({
+  tenants: ['tenant-id'],
+  page: 1,
+  perPage: 20,
+  search: 'optional search',
+});
+
+// Fetch gallery items with pagination
+const { galleryName, items, pagination, hasMore } = useGalleryItems('gallery-id', {
+  page: 1,
+  perPage: 50,
+});
+```
+
+#### Additional Hooks
+
+```tsx
+import {
+  useCopyright, useCopyrights,
+  useLicense, useLicenses,
+  useTenant, useHealthCheck, useSupportedDomains,
+} from '@fairu/sdk/react';
+
+// Copyrights
+const { copyright } = useCopyright('copyright-id');
+const { copyrights, pagination } = useCopyrights({ page: 1, perPage: 20 });
+
+// Licenses
+const { license } = useLicense('license-id');
+const { licenses, pagination } = useLicenses({ page: 1, perPage: 20 });
+
+// Tenant info
+const { tenant, fetching } = useTenant();
+
+// Health check
+const { health } = useHealthCheck();
+
+// Supported domains
+const { domains } = useSupportedDomains();
+```
+
+#### Mutation Hooks
+
+```tsx
+import { useUpdateAsset, useDeleteAsset } from '@fairu/sdk/react';
+
+// Update asset
+const { updateAsset, fetching } = useUpdateAsset();
+await updateAsset({
+  id: 'asset-id',
+  alt: 'New alt text',
+  caption: 'New caption',
+  description: 'New description',
+});
+
+// Delete asset
+const { deleteAsset, fetching } = useDeleteAsset();
+const success = await deleteAsset('asset-id');
+```
+
+#### Upload Hooks
+
+```tsx
+import { useUpload, useMultipartUpload } from '@fairu/sdk/react';
+
+// Simple upload (for files < 50MB)
+const { upload, progress, status, error, cancel, reset } = useUpload();
+
+const result = await upload(file, {
+  folderId: 'folder-id',
+  alt: 'Description',
+});
+
+console.log('Upload progress:', progress.percentage, '%');
+console.log('Status:', status); // 'idle' | 'uploading' | 'success' | 'error'
+
+// Multipart upload (for large files)
+const { upload, progress, partsCompleted, totalParts, cancel } = useMultipartUpload();
+
+await upload(largeFile, {
+  folderId: 'folder-id',
+  chunkSize: 10 * 1024 * 1024, // 10MB chunks
+  concurrency: 3, // Upload 3 chunks in parallel
+});
+```
+
+### FileProxy URL Builder
+
+```typescript
+import { fileProxy, useFileProxyUrl, useResponsiveImageUrl } from '@fairu/sdk/fileproxy';
+
+// Build URLs programmatically
+const url = fileProxy('asset-id', 'image.jpg')
+  .width(800)
+  .height(600)
+  .quality(85)
+  .format('webp')
+  .fit('cover')
+  .focal(50, 30, 1.5)
+  .build();
+
+// React hook for single image
+function AssetImage({ asset }) {
+  const url = useFileProxyUrl(asset.id, asset.name, {
+    width: 800,
+    format: 'webp',
+    quality: 85,
+    focal: asset.focal_point,
+  });
+
+  return <img src={url} alt={asset.alt} />;
+}
+
+// Responsive images with srcSet
+function ResponsiveImage({ asset }) {
+  const { src, srcSet, sizes } = useResponsiveImageUrl(
+    asset.id,
+    asset.name,
+    {
+      widths: [400, 800, 1200, 1600],
+      sizes: '(max-width: 600px) 100vw, 50vw',
+      format: 'webp',
+      quality: 80,
+    }
+  );
+
+  return <img src={src} srcSet={srcSet} sizes={sizes} alt={asset.alt} />;
+}
+```
+
+### Fragment System
+
+```typescript
+import { FragmentBuilder, fragments } from '@fairu/sdk/fragments';
+
+// Use predefined fragments
+const minimalFragment = fragments.asset('minimal');
+const fullFragment = fragments.asset('full');
+
+// Build custom fragments
+const customFragment = FragmentBuilder.for('FairuAsset')
+  .name('MyAssetFragment')
+  .select(['id', 'name', 'url', 'width', 'height', 'blurhash'])
+  .with('copyrights', (f) => f.select(['id', 'name', 'email']))
+  .build();
+
+// Use with hooks
+const { asset } = useAsset('id', { fragment: customFragment });
+```
+
+### Error Handling
+
+```typescript
+import { FairuError, ValidationError, AuthenticationError, GraphQLError } from '@fairu/sdk';
+
+try {
+  await updateAsset({ id: 'invalid' });
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.log('Validation errors:', error.validationErrors);
+    // { field: ['error message'] }
+  } else if (error instanceof AuthenticationError) {
+    console.log('Authentication failed - check your token');
+  } else if (error instanceof GraphQLError) {
+    console.log('GraphQL error:', error.message);
+  } else if (error instanceof FairuError) {
+    console.log('General error:', error.message, error.code);
+  }
+}
+```
+
+## Configuration
+
+### React Provider
+
+```tsx
+import { FairuProvider } from '@fairu/sdk/react';
+
+<FairuProvider
+  // GraphQL endpoint (required)
+  url="https://fairu.app/graphql"
+
+  // API token - can be static string or getter function
+  token="your-api-token"
+  // OR: getToken={() => localStorage.getItem('token')}
+
+  // FileProxy base URL (optional, default: https://files.fairu.app)
+  fileProxyUrl="https://files.fairu.app"
+
+  // Cache configuration (optional)
+  cache={{
+    enabled: true,
+  }}
+
+  // Global error handler (optional)
+  onError={(error) => {
+    console.error('GraphQL Error:', error);
+    // Send to error tracking service, show notification, etc.
+  }}
+>
+  <App />
+</FairuProvider>
+```
+
+### Environment Variables
+
+The SDK supports environment variables for configuration:
+
+```bash
+# Vite
+VITE_FAIRU_URL=https://fairu.app/graphql
+VITE_FAIRU_TOKEN=your-token
+
+# Next.js
+NEXT_PUBLIC_FAIRU_URL=https://fairu.app/graphql
+NEXT_PUBLIC_FAIRU_TOKEN=your-token
+
+# Node.js
+FAIRU_URL=https://fairu.app/graphql
+FAIRU_TOKEN=your-token
+```
+
+## TypeScript
+
+All types are exported from the package:
+
+```typescript
+import type {
+  // Entity types
+  FairuAsset,
+  FairuFolder,
+  FairuGallery,
+  FairuCopyright,
+  FairuLicense,
+  FairuUser,
+  FairuRole,
+  FairuTenant,
+
+  // Input types
+  FairuFileDto,
+  FairuFolderDto,
+  FairuGalleryDto,
+
+  // Enum types
+  FairuLicenseType,
+  FairuSortingDirection,
+  FairuUploadType,
+
+  // Query/Hook result types
+  AssetData,
+  AssetListData,
+  GalleryData,
+  FolderEntryData,
+} from '@fairu/sdk';
+```
+
+## Package Exports
+
+```typescript
+// Main exports (types, errors, core utilities)
+import { FairuError, ValidationError } from '@fairu/sdk';
+
+// React hooks and provider
+import {
+  FairuProvider,
+  useAsset,
+  useAssets,
+  useUpload
+} from '@fairu/sdk/react';
+
+// Vanilla client (no React dependency)
+import { createVanillaClient } from '@fairu/sdk/vanilla';
+
+// FileProxy utilities
+import { fileProxy, FileProxyBuilder } from '@fairu/sdk/fileproxy';
+
+// Fragment system
+import { FragmentBuilder, fragments } from '@fairu/sdk/fragments';
+
+// Upload utilities
+import { UploadError } from '@fairu/sdk/upload';
+```
+
+## License
+
+MIT

package/dist/FairuClient-BUObk5LJ.cjs

@@ -0,0 +1,91 @@
+"use strict";
+const core = require("@urql/core");
+const wonka = require("wonka");
+const FairuError = require("./FairuError-DWH_Nwk0.cjs");
+const DEFAULT_CONFIG = {
+  url: "https://fairu.app/graphql",
+  fileProxyUrl: "https://files.fairu.app",
+  retry: {
+    maxAttempts: 3,
+    delayMs: 1e3,
+    retryIf: (error) => {
+      return error.message.includes("Network") || error.message.includes("fetch");
+    }
+  },
+  cache: {
+    enabled: true,
+    keys: {}
+  }
+};
+function createErrorExchange(onError) {
+  return core.mapExchange({
+    onResult: (result) => {
+      if (result.error && onError) {
+        const fairuError = FairuError.FairuError.fromCombinedError(result.error);
+        onError(fairuError);
+      }
+      return result;
+    }
+  });
+}
+function createAuthExchange(config) {
+  return ({ forward }) => {
+    return (operations$) => {
+      return wonka.pipe(
+        operations$,
+        wonka.map((operation) => {
+          let token = null;
+          if (config.token) {
+            token = config.token;
+          } else if (config.getToken) {
+            const result = config.getToken();
+            if (typeof result === "string" || result === null) {
+              token = result;
+            }
+          }
+          if (!token) {
+            return operation;
+          }
+          const fetchOptions = typeof operation.context.fetchOptions === "object" ? operation.context.fetchOptions : {};
+          return {
+            ...operation,
+            context: {
+              ...operation.context,
+              fetchOptions: {
+                ...fetchOptions,
+                headers: {
+                  ...fetchOptions.headers,
+                  Authorization: `Bearer ${token}`
+                }
+              }
+            }
+          };
+        }),
+        forward
+      );
+    };
+  };
+}
+function createFairuClient(config = {}) {
+  const url = config.url ?? DEFAULT_CONFIG.url;
+  const cacheConfig = { ...DEFAULT_CONFIG.cache, ...config.cache };
+  const exchanges = [];
+  if (config.token || config.getToken) {
+    exchanges.push(createAuthExchange(config));
+  }
+  if (cacheConfig.enabled) {
+    exchanges.push(core.cacheExchange);
+  }
+  if (config.onError) {
+    exchanges.push(createErrorExchange(config.onError));
+  }
+  exchanges.push(core.fetchExchange);
+  return new core.Client({
+    url,
+    exchanges,
+    requestPolicy: "cache-first"
+  });
+}
+exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.createFairuClient = createFairuClient;
+//# sourceMappingURL=FairuClient-BUObk5LJ.cjs.map

package/dist/FairuClient-BUObk5LJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuClient-BUObk5LJ.cjs","sources":["../src/client/config.ts","../src/client/FairuClient.ts"],"sourcesContent":["/**\n * Configuration options for the Fairu client.\n */\nexport interface FairuClientConfig {\n  /**\n   * The GraphQL API URL.\n   * @default 'https://fairu.app/graphql'\n   */\n  url?: string;\n\n  /**\n   * Static API token for authentication.\n   */\n  token?: string;\n\n  /**\n   * Function to dynamically get the API token.\n   * Useful for token refresh or async token retrieval.\n   */\n  getToken?: () => string | null | Promise<string | null>;\n\n  /**\n   * Cache configuration options.\n   */\n  cache?: CacheConfig;\n\n  /**\n   * Retry configuration for failed requests.\n   */\n  retry?: RetryConfig;\n\n  /**\n   * Callback for handling errors globally.\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * FileProxy base URL for image transformations.\n   * @default 'https://files.fairu.app'\n   */\n  fileProxyUrl?: string;\n}\n\n/**\n * Cache configuration options.\n */\nexport interface CacheConfig {\n  /**\n   * Whether caching is enabled.\n   * @default true\n   */\n  enabled?: boolean;\n\n  /**\n   * Custom entity keys for cache normalization.\n   */\n  keys?: Record<string, (data: unknown) => string | null>;\n}\n\n/**\n * Retry configuration options.\n */\nexport interface RetryConfig {\n  /**\n   * Maximum number of retry attempts.\n   * @default 3\n   */\n  maxAttempts?: number;\n\n  /**\n   * Delay between retries in milliseconds.\n   * @default 1000\n   */\n  delayMs?: number;\n\n  /**\n   * Function to determine if an error should trigger a retry.\n   */\n  retryIf?: (error: Error) => boolean;\n}\n\n/**\n * Default configuration values.\n */\nexport const DEFAULT_CONFIG: Required<\n  Pick<FairuClientConfig, 'url' | 'fileProxyUrl'>\n> & {\n  retry: Required<RetryConfig>;\n  cache: Required<CacheConfig>;\n} = {\n  url: 'https://fairu.app/graphql',\n  fileProxyUrl: 'https://files.fairu.app',\n  retry: {\n    maxAttempts: 3,\n    delayMs: 1000,\n    retryIf: (error: Error) => {\n      // Only retry network errors by default\n      return error.message.includes('Network') || error.message.includes('fetch');\n    },\n  },\n  cache: {\n    enabled: true,\n    keys: {},\n  },\n};\n","import {\n  Client,\n  fetchExchange,\n  cacheExchange,\n  type Exchange,\n  type OperationResult,\n  type Operation,\n  mapExchange,\n} from '@urql/core';\nimport { map, pipe } from 'wonka';\nimport { DEFAULT_CONFIG, type FairuClientConfig } from './config';\nimport { FairuError } from '../errors';\n\n/**\n * Create an error handling exchange.\n */\nfunction createErrorExchange(onError?: (error: Error) => void): Exchange {\n  return mapExchange({\n    onResult: (result: OperationResult) => {\n      if (result.error && onError) {\n        const fairuError = FairuError.fromCombinedError(result.error);\n        onError(fairuError);\n      }\n      return result;\n    },\n  });\n}\n\n/**\n * Create an authentication exchange that adds Bearer token to requests.\n */\nfunction createAuthExchange(config: FairuClientConfig): Exchange {\n  return ({ forward }) => {\n    return (operations$) => {\n      return pipe(\n        operations$,\n        map((operation: Operation) => {\n          let token: string | null = null;\n\n          if (config.token) {\n            token = config.token;\n          } else if (config.getToken) {\n            const result = config.getToken();\n            if (typeof result === 'string' || result === null) {\n              token = result;\n            }\n          }\n\n          if (!token) {\n            return operation;\n          }\n\n          const fetchOptions =\n            typeof operation.context.fetchOptions === 'object'\n              ? operation.context.fetchOptions\n              : {};\n\n          return {\n            ...operation,\n            context: {\n              ...operation.context,\n              fetchOptions: {\n                ...fetchOptions,\n                headers: {\n                  ...(fetchOptions as Record<string, unknown>).headers as Record<string, string>,\n                  Authorization: `Bearer ${token}`,\n                },\n              },\n            },\n          };\n        }),\n        forward\n      );\n    };\n  };\n}\n\n/**\n * Create a urql client configured for the Fairu GraphQL API.\n */\nexport function createFairuClient(config: FairuClientConfig = {}): Client {\n  const url = config.url ?? DEFAULT_CONFIG.url;\n  const cacheConfig = { ...DEFAULT_CONFIG.cache, ...config.cache };\n\n  const exchanges: Exchange[] = [];\n\n  // Auth exchange (adds Bearer token)\n  if (config.token || config.getToken) {\n    exchanges.push(createAuthExchange(config));\n  }\n\n  // Cache exchange (if enabled)\n  if (cacheConfig.enabled) {\n    exchanges.push(cacheExchange);\n  }\n\n  // Error exchange\n  if (config.onError) {\n    exchanges.push(createErrorExchange(config.onError));\n  }\n\n  // Fetch exchange (must be last)\n  exchanges.push(fetchExchange);\n\n  return new Client({\n    url,\n    exchanges,\n    requestPolicy: 'cache-first',\n  });\n}\n\nexport type { Client };\n"],"names":["mapExchange","FairuError","pipe","map","cacheExchange","fetchExchange","Client"],"mappings":";;;;AAoFO,MAAM,iBAKT;AAAA,EACF,KAAK;AAAA,EACL,cAAc;AAAA,EACd,OAAO;AAAA,IACL,aAAa;AAAA,IACb,SAAS;AAAA,IACT,SAAS,CAAC,UAAiB;AAEzB,aAAO,MAAM,QAAQ,SAAS,SAAS,KAAK,MAAM,QAAQ,SAAS,OAAO;AAAA,IAC5E;AAAA,EAAA;AAAA,EAEF,OAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,CAAA;AAAA,EAAC;AAEX;ACxFA,SAAS,oBAAoB,SAA4C;AACvE,SAAOA,iBAAY;AAAA,IACjB,UAAU,CAAC,WAA4B;AACrC,UAAI,OAAO,SAAS,SAAS;AAC3B,cAAM,aAAaC,WAAAA,WAAW,kBAAkB,OAAO,KAAK;AAC5D,gBAAQ,UAAU;AAAA,MACpB;AACA,aAAO;AAAA,IACT;AAAA,EAAA,CACD;AACH;AAKA,SAAS,mBAAmB,QAAqC;AAC/D,SAAO,CAAC,EAAE,cAAc;AACtB,WAAO,CAAC,gBAAgB;AACtB,aAAOC,MAAAA;AAAAA,QACL;AAAA,QACAC,MAAAA,IAAI,CAAC,cAAyB;AAC5B,cAAI,QAAuB;AAE3B,cAAI,OAAO,OAAO;AAChB,oBAAQ,OAAO;AAAA,UACjB,WAAW,OAAO,UAAU;AAC1B,kBAAM,SAAS,OAAO,SAAA;AACtB,gBAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,sBAAQ;AAAA,YACV;AAAA,UACF;AAEA,cAAI,CAAC,OAAO;AACV,mBAAO;AAAA,UACT;AAEA,gBAAM,eACJ,OAAO,UAAU,QAAQ,iBAAiB,WACtC,UAAU,QAAQ,eAClB,CAAA;AAEN,iBAAO;AAAA,YACL,GAAG;AAAA,YACH,SAAS;AAAA,cACP,GAAG,UAAU;AAAA,cACb,cAAc;AAAA,gBACZ,GAAG;AAAA,gBACH,SAAS;AAAA,kBACP,GAAI,aAAyC;AAAA,kBAC7C,eAAe,UAAU,KAAK;AAAA,gBAAA;AAAA,cAChC;AAAA,YACF;AAAA,UACF;AAAA,QAEJ,CAAC;AAAA,QACD;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;AAKO,SAAS,kBAAkB,SAA4B,IAAY;AACxE,QAAM,MAAM,OAAO,OAAO,eAAe;AACzC,QAAM,cAAc,EAAE,GAAG,eAAe,OAAO,GAAG,OAAO,MAAA;AAEzD,QAAM,YAAwB,CAAA;AAG9B,MAAI,OAAO,SAAS,OAAO,UAAU;AACnC,cAAU,KAAK,mBAAmB,MAAM,CAAC;AAAA,EAC3C;AAGA,MAAI,YAAY,SAAS;AACvB,cAAU,KAAKC,kBAAa;AAAA,EAC9B;AAGA,MAAI,OAAO,SAAS;AAClB,cAAU,KAAK,oBAAoB,OAAO,OAAO,CAAC;AAAA,EACpD;AAGA,YAAU,KAAKC,kBAAa;AAE5B,SAAO,IAAIC,KAAAA,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA,eAAe;AAAA,EAAA,CAChB;AACH;;;"}

package/dist/FairuClient-CT-IPh8i.js

@@ -0,0 +1,92 @@
+import { fetchExchange, Client, mapExchange, cacheExchange } from "@urql/core";
+import { pipe, map } from "wonka";
+import { F as FairuError } from "./FairuError-D8sSmRAa.js";
+const DEFAULT_CONFIG = {
+  url: "https://fairu.app/graphql",
+  fileProxyUrl: "https://files.fairu.app",
+  retry: {
+    maxAttempts: 3,
+    delayMs: 1e3,
+    retryIf: (error) => {
+      return error.message.includes("Network") || error.message.includes("fetch");
+    }
+  },
+  cache: {
+    enabled: true,
+    keys: {}
+  }
+};
+function createErrorExchange(onError) {
+  return mapExchange({
+    onResult: (result) => {
+      if (result.error && onError) {
+        const fairuError = FairuError.fromCombinedError(result.error);
+        onError(fairuError);
+      }
+      return result;
+    }
+  });
+}
+function createAuthExchange(config) {
+  return ({ forward }) => {
+    return (operations$) => {
+      return pipe(
+        operations$,
+        map((operation) => {
+          let token = null;
+          if (config.token) {
+            token = config.token;
+          } else if (config.getToken) {
+            const result = config.getToken();
+            if (typeof result === "string" || result === null) {
+              token = result;
+            }
+          }
+          if (!token) {
+            return operation;
+          }
+          const fetchOptions = typeof operation.context.fetchOptions === "object" ? operation.context.fetchOptions : {};
+          return {
+            ...operation,
+            context: {
+              ...operation.context,
+              fetchOptions: {
+                ...fetchOptions,
+                headers: {
+                  ...fetchOptions.headers,
+                  Authorization: `Bearer ${token}`
+                }
+              }
+            }
+          };
+        }),
+        forward
+      );
+    };
+  };
+}
+function createFairuClient(config = {}) {
+  const url = config.url ?? DEFAULT_CONFIG.url;
+  const cacheConfig = { ...DEFAULT_CONFIG.cache, ...config.cache };
+  const exchanges = [];
+  if (config.token || config.getToken) {
+    exchanges.push(createAuthExchange(config));
+  }
+  if (cacheConfig.enabled) {
+    exchanges.push(cacheExchange);
+  }
+  if (config.onError) {
+    exchanges.push(createErrorExchange(config.onError));
+  }
+  exchanges.push(fetchExchange);
+  return new Client({
+    url,
+    exchanges,
+    requestPolicy: "cache-first"
+  });
+}
+export {
+  DEFAULT_CONFIG as D,
+  createFairuClient as c
+};
+//# sourceMappingURL=FairuClient-CT-IPh8i.js.map

package/dist/FairuClient-CT-IPh8i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuClient-CT-IPh8i.js","sources":["../src/client/config.ts","../src/client/FairuClient.ts"],"sourcesContent":["/**\n * Configuration options for the Fairu client.\n */\nexport interface FairuClientConfig {\n  /**\n   * The GraphQL API URL.\n   * @default 'https://fairu.app/graphql'\n   */\n  url?: string;\n\n  /**\n   * Static API token for authentication.\n   */\n  token?: string;\n\n  /**\n   * Function to dynamically get the API token.\n   * Useful for token refresh or async token retrieval.\n   */\n  getToken?: () => string | null | Promise<string | null>;\n\n  /**\n   * Cache configuration options.\n   */\n  cache?: CacheConfig;\n\n  /**\n   * Retry configuration for failed requests.\n   */\n  retry?: RetryConfig;\n\n  /**\n   * Callback for handling errors globally.\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * FileProxy base URL for image transformations.\n   * @default 'https://files.fairu.app'\n   */\n  fileProxyUrl?: string;\n}\n\n/**\n * Cache configuration options.\n */\nexport interface CacheConfig {\n  /**\n   * Whether caching is enabled.\n   * @default true\n   */\n  enabled?: boolean;\n\n  /**\n   * Custom entity keys for cache normalization.\n   */\n  keys?: Record<string, (data: unknown) => string | null>;\n}\n\n/**\n * Retry configuration options.\n */\nexport interface RetryConfig {\n  /**\n   * Maximum number of retry attempts.\n   * @default 3\n   */\n  maxAttempts?: number;\n\n  /**\n   * Delay between retries in milliseconds.\n   * @default 1000\n   */\n  delayMs?: number;\n\n  /**\n   * Function to determine if an error should trigger a retry.\n   */\n  retryIf?: (error: Error) => boolean;\n}\n\n/**\n * Default configuration values.\n */\nexport const DEFAULT_CONFIG: Required<\n  Pick<FairuClientConfig, 'url' | 'fileProxyUrl'>\n> & {\n  retry: Required<RetryConfig>;\n  cache: Required<CacheConfig>;\n} = {\n  url: 'https://fairu.app/graphql',\n  fileProxyUrl: 'https://files.fairu.app',\n  retry: {\n    maxAttempts: 3,\n    delayMs: 1000,\n    retryIf: (error: Error) => {\n      // Only retry network errors by default\n      return error.message.includes('Network') || error.message.includes('fetch');\n    },\n  },\n  cache: {\n    enabled: true,\n    keys: {},\n  },\n};\n","import {\n  Client,\n  fetchExchange,\n  cacheExchange,\n  type Exchange,\n  type OperationResult,\n  type Operation,\n  mapExchange,\n} from '@urql/core';\nimport { map, pipe } from 'wonka';\nimport { DEFAULT_CONFIG, type FairuClientConfig } from './config';\nimport { FairuError } from '../errors';\n\n/**\n * Create an error handling exchange.\n */\nfunction createErrorExchange(onError?: (error: Error) => void): Exchange {\n  return mapExchange({\n    onResult: (result: OperationResult) => {\n      if (result.error && onError) {\n        const fairuError = FairuError.fromCombinedError(result.error);\n        onError(fairuError);\n      }\n      return result;\n    },\n  });\n}\n\n/**\n * Create an authentication exchange that adds Bearer token to requests.\n */\nfunction createAuthExchange(config: FairuClientConfig): Exchange {\n  return ({ forward }) => {\n    return (operations$) => {\n      return pipe(\n        operations$,\n        map((operation: Operation) => {\n          let token: string | null = null;\n\n          if (config.token) {\n            token = config.token;\n          } else if (config.getToken) {\n            const result = config.getToken();\n            if (typeof result === 'string' || result === null) {\n              token = result;\n            }\n          }\n\n          if (!token) {\n            return operation;\n          }\n\n          const fetchOptions =\n            typeof operation.context.fetchOptions === 'object'\n              ? operation.context.fetchOptions\n              : {};\n\n          return {\n            ...operation,\n            context: {\n              ...operation.context,\n              fetchOptions: {\n                ...fetchOptions,\n                headers: {\n                  ...(fetchOptions as Record<string, unknown>).headers as Record<string, string>,\n                  Authorization: `Bearer ${token}`,\n                },\n              },\n            },\n          };\n        }),\n        forward\n      );\n    };\n  };\n}\n\n/**\n * Create a urql client configured for the Fairu GraphQL API.\n */\nexport function createFairuClient(config: FairuClientConfig = {}): Client {\n  const url = config.url ?? DEFAULT_CONFIG.url;\n  const cacheConfig = { ...DEFAULT_CONFIG.cache, ...config.cache };\n\n  const exchanges: Exchange[] = [];\n\n  // Auth exchange (adds Bearer token)\n  if (config.token || config.getToken) {\n    exchanges.push(createAuthExchange(config));\n  }\n\n  // Cache exchange (if enabled)\n  if (cacheConfig.enabled) {\n    exchanges.push(cacheExchange);\n  }\n\n  // Error exchange\n  if (config.onError) {\n    exchanges.push(createErrorExchange(config.onError));\n  }\n\n  // Fetch exchange (must be last)\n  exchanges.push(fetchExchange);\n\n  return new Client({\n    url,\n    exchanges,\n    requestPolicy: 'cache-first',\n  });\n}\n\nexport type { Client };\n"],"names":[],"mappings":";;;AAoFO,MAAM,iBAKT;AAAA,EACF,KAAK;AAAA,EACL,cAAc;AAAA,EACd,OAAO;AAAA,IACL,aAAa;AAAA,IACb,SAAS;AAAA,IACT,SAAS,CAAC,UAAiB;AAEzB,aAAO,MAAM,QAAQ,SAAS,SAAS,KAAK,MAAM,QAAQ,SAAS,OAAO;AAAA,IAC5E;AAAA,EAAA;AAAA,EAEF,OAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,CAAA;AAAA,EAAC;AAEX;ACxFA,SAAS,oBAAoB,SAA4C;AACvE,SAAO,YAAY;AAAA,IACjB,UAAU,CAAC,WAA4B;AACrC,UAAI,OAAO,SAAS,SAAS;AAC3B,cAAM,aAAa,WAAW,kBAAkB,OAAO,KAAK;AAC5D,gBAAQ,UAAU;AAAA,MACpB;AACA,aAAO;AAAA,IACT;AAAA,EAAA,CACD;AACH;AAKA,SAAS,mBAAmB,QAAqC;AAC/D,SAAO,CAAC,EAAE,cAAc;AACtB,WAAO,CAAC,gBAAgB;AACtB,aAAO;AAAA,QACL;AAAA,QACA,IAAI,CAAC,cAAyB;AAC5B,cAAI,QAAuB;AAE3B,cAAI,OAAO,OAAO;AAChB,oBAAQ,OAAO;AAAA,UACjB,WAAW,OAAO,UAAU;AAC1B,kBAAM,SAAS,OAAO,SAAA;AACtB,gBAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,sBAAQ;AAAA,YACV;AAAA,UACF;AAEA,cAAI,CAAC,OAAO;AACV,mBAAO;AAAA,UACT;AAEA,gBAAM,eACJ,OAAO,UAAU,QAAQ,iBAAiB,WACtC,UAAU,QAAQ,eAClB,CAAA;AAEN,iBAAO;AAAA,YACL,GAAG;AAAA,YACH,SAAS;AAAA,cACP,GAAG,UAAU;AAAA,cACb,cAAc;AAAA,gBACZ,GAAG;AAAA,gBACH,SAAS;AAAA,kBACP,GAAI,aAAyC;AAAA,kBAC7C,eAAe,UAAU,KAAK;AAAA,gBAAA;AAAA,cAChC;AAAA,YACF;AAAA,UACF;AAAA,QAEJ,CAAC;AAAA,QACD;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AACF;AAKO,SAAS,kBAAkB,SAA4B,IAAY;AACxE,QAAM,MAAM,OAAO,OAAO,eAAe;AACzC,QAAM,cAAc,EAAE,GAAG,eAAe,OAAO,GAAG,OAAO,MAAA;AAEzD,QAAM,YAAwB,CAAA;AAG9B,MAAI,OAAO,SAAS,OAAO,UAAU;AACnC,cAAU,KAAK,mBAAmB,MAAM,CAAC;AAAA,EAC3C;AAGA,MAAI,YAAY,SAAS;AACvB,cAAU,KAAK,aAAa;AAAA,EAC9B;AAGA,MAAI,OAAO,SAAS;AAClB,cAAU,KAAK,oBAAoB,OAAO,OAAO,CAAC;AAAA,EACpD;AAGA,YAAU,KAAK,aAAa;AAE5B,SAAO,IAAI,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA,eAAe;AAAA,EAAA,CAChB;AACH;"}