@fairu/sdk 1.0.1

package/dist/upload/index.d.ts

@@ -0,0 +1,4 @@
+export { useUpload, type UseUploadState, type UseUploadResult, } from './useUpload';
+export { useMultipartUpload, type UseMultipartUploadState, type UseMultipartUploadResult, } from './useMultipartUpload';
+export type { UploadStatus, UploadProgress, UploadPart, UploadOptions, MultipartUploadOptions, UploadResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/upload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/upload/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Upload status.
+ */
+export type UploadStatus = 'idle' | 'preparing' | 'uploading' | 'processing' | 'completed' | 'error' | 'aborted';
+/**
+ * Upload progress information.
+ */
+export interface UploadProgress {
+    /**
+     * Bytes uploaded.
+     */
+    loaded: number;
+    /**
+     * Total bytes.
+     */
+    total: number;
+    /**
+     * Percentage (0-100).
+     */
+    percentage: number;
+}
+/**
+ * Completed upload part.
+ */
+export interface UploadPart {
+    partNumber: number;
+    etag: string;
+}
+/**
+ * Options for simple uploads.
+ */
+export interface UploadOptions {
+    /**
+     * Target folder ID.
+     */
+    folderId?: string;
+    /**
+     * Alt text for the file.
+     */
+    alt?: string;
+    /**
+     * Caption for the file.
+     */
+    caption?: string;
+    /**
+     * Description for the file.
+     */
+    description?: string;
+    /**
+     * Copyright text.
+     */
+    copyright?: string;
+    /**
+     * Focal point (e.g., "50,50").
+     */
+    focalPoint?: string;
+    /**
+     * Progress callback.
+     */
+    onProgress?: (progress: UploadProgress) => void;
+    /**
+     * Status change callback.
+     */
+    onStatusChange?: (status: UploadStatus) => void;
+    /**
+     * Abort signal for cancellation.
+     */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Options for multipart uploads.
+ */
+export interface MultipartUploadOptions extends UploadOptions {
+    /**
+     * Part size in bytes (default: 5MB).
+     */
+    partSize?: number;
+    /**
+     * Number of concurrent part uploads (default: 3).
+     */
+    concurrency?: number;
+}
+/**
+ * Result of a completed upload.
+ */
+export interface UploadResult {
+    /**
+     * ID of the uploaded file.
+     */
+    id: string;
+    /**
+     * URL of the uploaded file.
+     */
+    url: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upload/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,WAAW,GACX,YAAY,GACZ,WAAW,GACX,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAEhD;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/upload/useMultipartUpload.d.ts

@@ -0,0 +1,67 @@
+import { UploadStatus, UploadProgress, MultipartUploadOptions, UploadResult } from './types';
+import { UploadError } from '../errors';
+/**
+ * State for the multipart upload hook.
+ */
+export interface UseMultipartUploadState {
+    status: UploadStatus;
+    progress: UploadProgress;
+    error: UploadError | null;
+    result: UploadResult | null;
+    partsCompleted: number;
+    totalParts: number;
+}
+/**
+ * Result of the useMultipartUpload hook.
+ */
+export interface UseMultipartUploadResult extends UseMultipartUploadState {
+    upload: (file: File, options?: MultipartUploadOptions) => Promise<UploadResult>;
+    abort: () => void;
+    reset: () => void;
+}
+/**
+ * Hook for multipart uploads of large files.
+ *
+ * @example
+ * ```tsx
+ * function LargeFileUploader() {
+ *   const {
+ *     upload,
+ *     progress,
+ *     status,
+ *     partsCompleted,
+ *     totalParts,
+ *     abort,
+ *   } = useMultipartUpload();
+ *
+ *   const handleFileSelect = async (e) => {
+ *     const file = e.target.files?.[0];
+ *     if (!file) return;
+ *
+ *     try {
+ *       await upload(file, {
+ *         partSize: 10 * 1024 * 1024, // 10MB parts
+ *         concurrency: 5,
+ *       });
+ *     } catch (err) {
+ *       console.error('Upload failed:', err);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input type="file" onChange={handleFileSelect} />
+ *       {status === 'uploading' && (
+ *         <div>
+ *           <progress value={progress.percentage} max={100} />
+ *           <span>Parts: {partsCompleted}/{totalParts}</span>
+ *           <button onClick={abort}>Cancel</button>
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMultipartUpload(): UseMultipartUploadResult;
+//# sourceMappingURL=useMultipartUpload.d.ts.map

package/dist/upload/useMultipartUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMultipartUpload.d.ts","sourceRoot":"","sources":["../../src/upload/useMultipartUpload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,YAAY,EAEb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAwDxC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAmO7D"}

package/dist/upload/useUpload.d.ts

@@ -0,0 +1,64 @@
+import { UploadStatus, UploadProgress, UploadOptions, UploadResult } from './types';
+import { UploadError } from '../errors';
+/**
+ * State for the upload hook.
+ */
+export interface UseUploadState {
+    status: UploadStatus;
+    progress: UploadProgress;
+    error: UploadError | null;
+    result: UploadResult | null;
+}
+/**
+ * Result of the useUpload hook.
+ */
+export interface UseUploadResult extends UseUploadState {
+    /**
+     * Upload a file.
+     */
+    upload: (file: File, options?: UploadOptions) => Promise<UploadResult>;
+    /**
+     * Abort the current upload.
+     */
+    abort: () => void;
+    /**
+     * Reset the upload state.
+     */
+    reset: () => void;
+}
+/**
+ * Hook for uploading files to Fairu.
+ *
+ * @example
+ * ```tsx
+ * function FileUploader() {
+ *   const { upload, progress, status, error, result } = useUpload();
+ *
+ *   const handleFileSelect = async (e) => {
+ *     const file = e.target.files?.[0];
+ *     if (!file) return;
+ *
+ *     try {
+ *       const result = await upload(file, {
+ *         folderId: 'target-folder-id',
+ *         alt: 'Uploaded image',
+ *       });
+ *       console.log('Uploaded:', result);
+ *     } catch (err) {
+ *       console.error('Upload failed:', err);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input type="file" onChange={handleFileSelect} />
+ *       {status === 'uploading' && (
+ *         <progress value={progress.percentage} max={100} />
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useUpload(): UseUploadResult;
+//# sourceMappingURL=useUpload.d.ts.map

package/dist/upload/useUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.d.ts","sourceRoot":"","sources":["../../src/upload/useUpload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA6BxC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvE;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,IAAI,eAAe,CA6G3C"}

package/dist/upload.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const useMultipartUpload = require("./useMultipartUpload-BKnDbl8h.cjs");
+exports.useMultipartUpload = useMultipartUpload.useMultipartUpload;
+exports.useUpload = useMultipartUpload.useUpload;
+//# sourceMappingURL=upload.cjs.map

package/dist/upload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/upload.d.ts

@@ -0,0 +1,2 @@
+export * from './upload/index'
+export {}

package/dist/upload.js

@@ -0,0 +1,6 @@
+import { a, u } from "./useMultipartUpload-CPK_PgUU.js";
+export {
+  a as useMultipartUpload,
+  u as useUpload
+};
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/useFileProxyUrl-BCcux6re.cjs

@@ -0,0 +1,87 @@
+"use strict";
+const react = require("react");
+const FileProxyBuilder = require("./FileProxyBuilder-D-jZpAtd.cjs");
+function useFileProxyUrl(id, name, options = {}) {
+  return react.useMemo(() => {
+    if (!id || !name || options.skip) {
+      return null;
+    }
+    const builder = new FileProxyBuilder.FileProxyBuilder(id, name, options.baseUrl);
+    if (options.width !== void 0) {
+      builder.width(options.width);
+    }
+    if (options.height !== void 0) {
+      builder.height(options.height);
+    }
+    if (options.quality !== void 0) {
+      builder.quality(options.quality);
+    }
+    if (options.format !== void 0) {
+      builder.format(options.format);
+    }
+    if (options.fit !== void 0) {
+      builder.fit(options.fit);
+    }
+    if (options.focal) {
+      builder.focalFromString(options.focal);
+    }
+    if (options.raw) {
+      builder.raw(true);
+    }
+    if (options.processSvg) {
+      builder.processSvg(true);
+    }
+    return builder.build();
+  }, [
+    id,
+    name,
+    options.width,
+    options.height,
+    options.quality,
+    options.format,
+    options.fit,
+    options.focal,
+    options.raw,
+    options.processSvg,
+    options.baseUrl,
+    options.skip
+  ]);
+}
+function useResponsiveImageUrl(id, name, options) {
+  return react.useMemo(() => {
+    if (!id || !name || options.widths.length === 0) {
+      return { src: null, srcSet: null, sizes: void 0 };
+    }
+    const sortedWidths = [...options.widths].sort((a, b) => a - b);
+    const defaultWidth = sortedWidths[Math.floor(sortedWidths.length / 2)];
+    const srcBuilder = new FileProxyBuilder.FileProxyBuilder(id, name, options.baseUrl).width(defaultWidth);
+    if (options.format) srcBuilder.format(options.format);
+    if (options.quality) srcBuilder.quality(options.quality);
+    if (options.focal) srcBuilder.focalFromString(options.focal);
+    const src = srcBuilder.build();
+    const srcSetParts = sortedWidths.map((width) => {
+      const builder = new FileProxyBuilder.FileProxyBuilder(id, name, options.baseUrl).width(width);
+      if (options.format) builder.format(options.format);
+      if (options.quality) builder.quality(options.quality);
+      if (options.focal) builder.focalFromString(options.focal);
+      return `${builder.build()} ${width}w`;
+    });
+    return {
+      src,
+      srcSet: srcSetParts.join(", "),
+      sizes: options.sizes
+    };
+  }, [
+    id,
+    name,
+    options.widths,
+    options.sizes,
+    options.format,
+    options.quality,
+    options.focal,
+    options.baseUrl
+  ]);
+}
+exports.useFileProxyUrl = useFileProxyUrl;
+exports.useResponsiveImageUrl = useResponsiveImageUrl;
+//# sourceMappingURL=useFileProxyUrl-BCcux6re.cjs.map

package/dist/useFileProxyUrl-BCcux6re.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileProxyUrl-BCcux6re.cjs","sources":["../src/fileproxy/useFileProxyUrl.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport { FileProxyBuilder } from './FileProxyBuilder';\nimport type { ImageFormat, FitMode } from './types';\n\n/**\n * Options for the useFileProxyUrl hook.\n */\nexport interface UseFileProxyUrlOptions {\n  /**\n   * Width in pixels.\n   */\n  width?: number;\n\n  /**\n   * Height in pixels.\n   */\n  height?: number;\n\n  /**\n   * Quality (1-100).\n   */\n  quality?: number;\n\n  /**\n   * Output format.\n   */\n  format?: ImageFormat;\n\n  /**\n   * Fit mode for cropping.\n   */\n  fit?: FitMode;\n\n  /**\n   * Focal point string (e.g., \"50,50\" or \"50-30-1.5\").\n   */\n  focal?: string | null;\n\n  /**\n   * Return raw file without processing.\n   */\n  raw?: boolean;\n\n  /**\n   * Process SVG to raster.\n   */\n  processSvg?: boolean;\n\n  /**\n   * Custom base URL.\n   */\n  baseUrl?: string;\n\n  /**\n   * Skip URL generation if true.\n   */\n  skip?: boolean;\n}\n\n/**\n * React hook for generating FileProxy URLs.\n *\n * @example\n * ```tsx\n * function AssetImage({ asset }) {\n *   const url = useFileProxyUrl(asset.id, asset.name, {\n *     width: 800,\n *     format: 'webp',\n *     focal: asset.focal_point,\n *   });\n *\n *   return <img src={url} alt={asset.alt} />;\n * }\n * ```\n */\nexport function useFileProxyUrl(\n  id: string | null | undefined,\n  name: string | null | undefined,\n  options: UseFileProxyUrlOptions = {}\n): string | null {\n  return useMemo(() => {\n    // Skip if no id or name, or if explicitly skipped\n    if (!id || !name || options.skip) {\n      return null;\n    }\n\n    const builder = new FileProxyBuilder(id, name, options.baseUrl);\n\n    // Apply options\n    if (options.width !== undefined) {\n      builder.width(options.width);\n    }\n    if (options.height !== undefined) {\n      builder.height(options.height);\n    }\n    if (options.quality !== undefined) {\n      builder.quality(options.quality);\n    }\n    if (options.format !== undefined) {\n      builder.format(options.format);\n    }\n    if (options.fit !== undefined) {\n      builder.fit(options.fit);\n    }\n    if (options.focal) {\n      builder.focalFromString(options.focal);\n    }\n    if (options.raw) {\n      builder.raw(true);\n    }\n    if (options.processSvg) {\n      builder.processSvg(true);\n    }\n\n    return builder.build();\n  }, [\n    id,\n    name,\n    options.width,\n    options.height,\n    options.quality,\n    options.format,\n    options.fit,\n    options.focal,\n    options.raw,\n    options.processSvg,\n    options.baseUrl,\n    options.skip,\n  ]);\n}\n\n/**\n * React hook for generating responsive image srcset.\n *\n * @example\n * ```tsx\n * function ResponsiveImage({ asset }) {\n *   const { src, srcSet, sizes } = useResponsiveImageUrl(asset.id, asset.name, {\n *     widths: [400, 800, 1200, 1600],\n *     sizes: '(max-width: 600px) 100vw, 50vw',\n *   });\n *\n *   return <img src={src} srcSet={srcSet} sizes={sizes} alt={asset.alt} />;\n * }\n * ```\n */\nexport function useResponsiveImageUrl(\n  id: string | null | undefined,\n  name: string | null | undefined,\n  options: {\n    widths: number[];\n    sizes?: string;\n    format?: ImageFormat;\n    quality?: number;\n    focal?: string | null;\n    baseUrl?: string;\n  }\n): {\n  src: string | null;\n  srcSet: string | null;\n  sizes: string | undefined;\n} {\n  return useMemo(() => {\n    if (!id || !name || options.widths.length === 0) {\n      return { src: null, srcSet: null, sizes: undefined };\n    }\n\n    const sortedWidths = [...options.widths].sort((a, b) => a - b);\n    const defaultWidth = sortedWidths[Math.floor(sortedWidths.length / 2)];\n\n    // Generate default src\n    const srcBuilder = new FileProxyBuilder(id, name, options.baseUrl)\n      .width(defaultWidth);\n\n    if (options.format) srcBuilder.format(options.format);\n    if (options.quality) srcBuilder.quality(options.quality);\n    if (options.focal) srcBuilder.focalFromString(options.focal);\n\n    const src = srcBuilder.build();\n\n    // Generate srcSet\n    const srcSetParts = sortedWidths.map((width) => {\n      const builder = new FileProxyBuilder(id, name, options.baseUrl)\n        .width(width);\n\n      if (options.format) builder.format(options.format);\n      if (options.quality) builder.quality(options.quality);\n      if (options.focal) builder.focalFromString(options.focal);\n\n      return `${builder.build()} ${width}w`;\n    });\n\n    return {\n      src,\n      srcSet: srcSetParts.join(', '),\n      sizes: options.sizes,\n    };\n  }, [\n    id,\n    name,\n    options.widths,\n    options.sizes,\n    options.format,\n    options.quality,\n    options.focal,\n    options.baseUrl,\n  ]);\n}\n"],"names":["useMemo","FileProxyBuilder"],"mappings":";;;AA2EO,SAAS,gBACd,IACA,MACA,UAAkC,CAAA,GACnB;AACf,SAAOA,MAAAA,QAAQ,MAAM;AAEnB,QAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,MAAM;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,IAAIC,iBAAAA,iBAAiB,IAAI,MAAM,QAAQ,OAAO;AAG9D,QAAI,QAAQ,UAAU,QAAW;AAC/B,cAAQ,MAAM,QAAQ,KAAK;AAAA,IAC7B;AACA,QAAI,QAAQ,WAAW,QAAW;AAChC,cAAQ,OAAO,QAAQ,MAAM;AAAA,IAC/B;AACA,QAAI,QAAQ,YAAY,QAAW;AACjC,cAAQ,QAAQ,QAAQ,OAAO;AAAA,IACjC;AACA,QAAI,QAAQ,WAAW,QAAW;AAChC,cAAQ,OAAO,QAAQ,MAAM;AAAA,IAC/B;AACA,QAAI,QAAQ,QAAQ,QAAW;AAC7B,cAAQ,IAAI,QAAQ,GAAG;AAAA,IACzB;AACA,QAAI,QAAQ,OAAO;AACjB,cAAQ,gBAAgB,QAAQ,KAAK;AAAA,IACvC;AACA,QAAI,QAAQ,KAAK;AACf,cAAQ,IAAI,IAAI;AAAA,IAClB;AACA,QAAI,QAAQ,YAAY;AACtB,cAAQ,WAAW,IAAI;AAAA,IACzB;AAEA,WAAO,QAAQ,MAAA;AAAA,EACjB,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,EAAA,CACT;AACH;AAiBO,SAAS,sBACd,IACA,MACA,SAYA;AACA,SAAOD,MAAAA,QAAQ,MAAM;AACnB,QAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,OAAO,WAAW,GAAG;AAC/C,aAAO,EAAE,KAAK,MAAM,QAAQ,MAAM,OAAO,OAAA;AAAA,IAC3C;AAEA,UAAM,eAAe,CAAC,GAAG,QAAQ,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC7D,UAAM,eAAe,aAAa,KAAK,MAAM,aAAa,SAAS,CAAC,CAAC;AAGrE,UAAM,aAAa,IAAIC,iBAAAA,iBAAiB,IAAI,MAAM,QAAQ,OAAO,EAC9D,MAAM,YAAY;AAErB,QAAI,QAAQ,OAAQ,YAAW,OAAO,QAAQ,MAAM;AACpD,QAAI,QAAQ,QAAS,YAAW,QAAQ,QAAQ,OAAO;AACvD,QAAI,QAAQ,MAAO,YAAW,gBAAgB,QAAQ,KAAK;AAE3D,UAAM,MAAM,WAAW,MAAA;AAGvB,UAAM,cAAc,aAAa,IAAI,CAAC,UAAU;AAC9C,YAAM,UAAU,IAAIA,iBAAAA,iBAAiB,IAAI,MAAM,QAAQ,OAAO,EAC3D,MAAM,KAAK;AAEd,UAAI,QAAQ,OAAQ,SAAQ,OAAO,QAAQ,MAAM;AACjD,UAAI,QAAQ,QAAS,SAAQ,QAAQ,QAAQ,OAAO;AACpD,UAAI,QAAQ,MAAO,SAAQ,gBAAgB,QAAQ,KAAK;AAExD,aAAO,GAAG,QAAQ,MAAA,CAAO,IAAI,KAAK;AAAA,IACpC,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,YAAY,KAAK,IAAI;AAAA,MAC7B,OAAO,QAAQ;AAAA,IAAA;AAAA,EAEnB,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,EAAA,CACT;AACH;;;"}

package/dist/useFileProxyUrl-D_S1R_7O.js

@@ -0,0 +1,88 @@
+import { useMemo } from "react";
+import { F as FileProxyBuilder } from "./FileProxyBuilder-vHw1zBpJ.js";
+function useFileProxyUrl(id, name, options = {}) {
+  return useMemo(() => {
+    if (!id || !name || options.skip) {
+      return null;
+    }
+    const builder = new FileProxyBuilder(id, name, options.baseUrl);
+    if (options.width !== void 0) {
+      builder.width(options.width);
+    }
+    if (options.height !== void 0) {
+      builder.height(options.height);
+    }
+    if (options.quality !== void 0) {
+      builder.quality(options.quality);
+    }
+    if (options.format !== void 0) {
+      builder.format(options.format);
+    }
+    if (options.fit !== void 0) {
+      builder.fit(options.fit);
+    }
+    if (options.focal) {
+      builder.focalFromString(options.focal);
+    }
+    if (options.raw) {
+      builder.raw(true);
+    }
+    if (options.processSvg) {
+      builder.processSvg(true);
+    }
+    return builder.build();
+  }, [
+    id,
+    name,
+    options.width,
+    options.height,
+    options.quality,
+    options.format,
+    options.fit,
+    options.focal,
+    options.raw,
+    options.processSvg,
+    options.baseUrl,
+    options.skip
+  ]);
+}
+function useResponsiveImageUrl(id, name, options) {
+  return useMemo(() => {
+    if (!id || !name || options.widths.length === 0) {
+      return { src: null, srcSet: null, sizes: void 0 };
+    }
+    const sortedWidths = [...options.widths].sort((a, b) => a - b);
+    const defaultWidth = sortedWidths[Math.floor(sortedWidths.length / 2)];
+    const srcBuilder = new FileProxyBuilder(id, name, options.baseUrl).width(defaultWidth);
+    if (options.format) srcBuilder.format(options.format);
+    if (options.quality) srcBuilder.quality(options.quality);
+    if (options.focal) srcBuilder.focalFromString(options.focal);
+    const src = srcBuilder.build();
+    const srcSetParts = sortedWidths.map((width) => {
+      const builder = new FileProxyBuilder(id, name, options.baseUrl).width(width);
+      if (options.format) builder.format(options.format);
+      if (options.quality) builder.quality(options.quality);
+      if (options.focal) builder.focalFromString(options.focal);
+      return `${builder.build()} ${width}w`;
+    });
+    return {
+      src,
+      srcSet: srcSetParts.join(", "),
+      sizes: options.sizes
+    };
+  }, [
+    id,
+    name,
+    options.widths,
+    options.sizes,
+    options.format,
+    options.quality,
+    options.focal,
+    options.baseUrl
+  ]);
+}
+export {
+  useResponsiveImageUrl as a,
+  useFileProxyUrl as u
+};
+//# sourceMappingURL=useFileProxyUrl-D_S1R_7O.js.map

package/dist/useFileProxyUrl-D_S1R_7O.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileProxyUrl-D_S1R_7O.js","sources":["../src/fileproxy/useFileProxyUrl.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport { FileProxyBuilder } from './FileProxyBuilder';\nimport type { ImageFormat, FitMode } from './types';\n\n/**\n * Options for the useFileProxyUrl hook.\n */\nexport interface UseFileProxyUrlOptions {\n  /**\n   * Width in pixels.\n   */\n  width?: number;\n\n  /**\n   * Height in pixels.\n   */\n  height?: number;\n\n  /**\n   * Quality (1-100).\n   */\n  quality?: number;\n\n  /**\n   * Output format.\n   */\n  format?: ImageFormat;\n\n  /**\n   * Fit mode for cropping.\n   */\n  fit?: FitMode;\n\n  /**\n   * Focal point string (e.g., \"50,50\" or \"50-30-1.5\").\n   */\n  focal?: string | null;\n\n  /**\n   * Return raw file without processing.\n   */\n  raw?: boolean;\n\n  /**\n   * Process SVG to raster.\n   */\n  processSvg?: boolean;\n\n  /**\n   * Custom base URL.\n   */\n  baseUrl?: string;\n\n  /**\n   * Skip URL generation if true.\n   */\n  skip?: boolean;\n}\n\n/**\n * React hook for generating FileProxy URLs.\n *\n * @example\n * ```tsx\n * function AssetImage({ asset }) {\n *   const url = useFileProxyUrl(asset.id, asset.name, {\n *     width: 800,\n *     format: 'webp',\n *     focal: asset.focal_point,\n *   });\n *\n *   return <img src={url} alt={asset.alt} />;\n * }\n * ```\n */\nexport function useFileProxyUrl(\n  id: string | null | undefined,\n  name: string | null | undefined,\n  options: UseFileProxyUrlOptions = {}\n): string | null {\n  return useMemo(() => {\n    // Skip if no id or name, or if explicitly skipped\n    if (!id || !name || options.skip) {\n      return null;\n    }\n\n    const builder = new FileProxyBuilder(id, name, options.baseUrl);\n\n    // Apply options\n    if (options.width !== undefined) {\n      builder.width(options.width);\n    }\n    if (options.height !== undefined) {\n      builder.height(options.height);\n    }\n    if (options.quality !== undefined) {\n      builder.quality(options.quality);\n    }\n    if (options.format !== undefined) {\n      builder.format(options.format);\n    }\n    if (options.fit !== undefined) {\n      builder.fit(options.fit);\n    }\n    if (options.focal) {\n      builder.focalFromString(options.focal);\n    }\n    if (options.raw) {\n      builder.raw(true);\n    }\n    if (options.processSvg) {\n      builder.processSvg(true);\n    }\n\n    return builder.build();\n  }, [\n    id,\n    name,\n    options.width,\n    options.height,\n    options.quality,\n    options.format,\n    options.fit,\n    options.focal,\n    options.raw,\n    options.processSvg,\n    options.baseUrl,\n    options.skip,\n  ]);\n}\n\n/**\n * React hook for generating responsive image srcset.\n *\n * @example\n * ```tsx\n * function ResponsiveImage({ asset }) {\n *   const { src, srcSet, sizes } = useResponsiveImageUrl(asset.id, asset.name, {\n *     widths: [400, 800, 1200, 1600],\n *     sizes: '(max-width: 600px) 100vw, 50vw',\n *   });\n *\n *   return <img src={src} srcSet={srcSet} sizes={sizes} alt={asset.alt} />;\n * }\n * ```\n */\nexport function useResponsiveImageUrl(\n  id: string | null | undefined,\n  name: string | null | undefined,\n  options: {\n    widths: number[];\n    sizes?: string;\n    format?: ImageFormat;\n    quality?: number;\n    focal?: string | null;\n    baseUrl?: string;\n  }\n): {\n  src: string | null;\n  srcSet: string | null;\n  sizes: string | undefined;\n} {\n  return useMemo(() => {\n    if (!id || !name || options.widths.length === 0) {\n      return { src: null, srcSet: null, sizes: undefined };\n    }\n\n    const sortedWidths = [...options.widths].sort((a, b) => a - b);\n    const defaultWidth = sortedWidths[Math.floor(sortedWidths.length / 2)];\n\n    // Generate default src\n    const srcBuilder = new FileProxyBuilder(id, name, options.baseUrl)\n      .width(defaultWidth);\n\n    if (options.format) srcBuilder.format(options.format);\n    if (options.quality) srcBuilder.quality(options.quality);\n    if (options.focal) srcBuilder.focalFromString(options.focal);\n\n    const src = srcBuilder.build();\n\n    // Generate srcSet\n    const srcSetParts = sortedWidths.map((width) => {\n      const builder = new FileProxyBuilder(id, name, options.baseUrl)\n        .width(width);\n\n      if (options.format) builder.format(options.format);\n      if (options.quality) builder.quality(options.quality);\n      if (options.focal) builder.focalFromString(options.focal);\n\n      return `${builder.build()} ${width}w`;\n    });\n\n    return {\n      src,\n      srcSet: srcSetParts.join(', '),\n      sizes: options.sizes,\n    };\n  }, [\n    id,\n    name,\n    options.widths,\n    options.sizes,\n    options.format,\n    options.quality,\n    options.focal,\n    options.baseUrl,\n  ]);\n}\n"],"names":[],"mappings":";;AA2EO,SAAS,gBACd,IACA,MACA,UAAkC,CAAA,GACnB;AACf,SAAO,QAAQ,MAAM;AAEnB,QAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,MAAM;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,IAAI,iBAAiB,IAAI,MAAM,QAAQ,OAAO;AAG9D,QAAI,QAAQ,UAAU,QAAW;AAC/B,cAAQ,MAAM,QAAQ,KAAK;AAAA,IAC7B;AACA,QAAI,QAAQ,WAAW,QAAW;AAChC,cAAQ,OAAO,QAAQ,MAAM;AAAA,IAC/B;AACA,QAAI,QAAQ,YAAY,QAAW;AACjC,cAAQ,QAAQ,QAAQ,OAAO;AAAA,IACjC;AACA,QAAI,QAAQ,WAAW,QAAW;AAChC,cAAQ,OAAO,QAAQ,MAAM;AAAA,IAC/B;AACA,QAAI,QAAQ,QAAQ,QAAW;AAC7B,cAAQ,IAAI,QAAQ,GAAG;AAAA,IACzB;AACA,QAAI,QAAQ,OAAO;AACjB,cAAQ,gBAAgB,QAAQ,KAAK;AAAA,IACvC;AACA,QAAI,QAAQ,KAAK;AACf,cAAQ,IAAI,IAAI;AAAA,IAClB;AACA,QAAI,QAAQ,YAAY;AACtB,cAAQ,WAAW,IAAI;AAAA,IACzB;AAEA,WAAO,QAAQ,MAAA;AAAA,EACjB,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,EAAA,CACT;AACH;AAiBO,SAAS,sBACd,IACA,MACA,SAYA;AACA,SAAO,QAAQ,MAAM;AACnB,QAAI,CAAC,MAAM,CAAC,QAAQ,QAAQ,OAAO,WAAW,GAAG;AAC/C,aAAO,EAAE,KAAK,MAAM,QAAQ,MAAM,OAAO,OAAA;AAAA,IAC3C;AAEA,UAAM,eAAe,CAAC,GAAG,QAAQ,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC7D,UAAM,eAAe,aAAa,KAAK,MAAM,aAAa,SAAS,CAAC,CAAC;AAGrE,UAAM,aAAa,IAAI,iBAAiB,IAAI,MAAM,QAAQ,OAAO,EAC9D,MAAM,YAAY;AAErB,QAAI,QAAQ,OAAQ,YAAW,OAAO,QAAQ,MAAM;AACpD,QAAI,QAAQ,QAAS,YAAW,QAAQ,QAAQ,OAAO;AACvD,QAAI,QAAQ,MAAO,YAAW,gBAAgB,QAAQ,KAAK;AAE3D,UAAM,MAAM,WAAW,MAAA;AAGvB,UAAM,cAAc,aAAa,IAAI,CAAC,UAAU;AAC9C,YAAM,UAAU,IAAI,iBAAiB,IAAI,MAAM,QAAQ,OAAO,EAC3D,MAAM,KAAK;AAEd,UAAI,QAAQ,OAAQ,SAAQ,OAAO,QAAQ,MAAM;AACjD,UAAI,QAAQ,QAAS,SAAQ,QAAQ,QAAQ,OAAO;AACpD,UAAI,QAAQ,MAAO,SAAQ,gBAAgB,QAAQ,KAAK;AAExD,aAAO,GAAG,QAAQ,MAAA,CAAO,IAAI,KAAK;AAAA,IACpC,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,YAAY,KAAK,IAAI;AAAA,MAC7B,OAAO,QAAQ;AAAA,IAAA;AAAA,EAEnB,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ;AAAA,EAAA,CACT;AACH;"}