@fairu/sdk 1.0.1

package/dist/client/FairuProvider.d.ts

@@ -0,0 +1,78 @@
+import { ReactNode } from 'react';
+import { Client } from 'urql';
+import { FairuClientConfig } from './config';
+import { FragmentRegistry } from '../fragments/FragmentRegistry';
+/**
+ * Context value for Fairu SDK.
+ */
+interface FairuContextValue {
+    /**
+     * The urql client instance.
+     */
+    client: Client;
+    /**
+     * Fragment registry for custom and predefined fragments.
+     */
+    fragments: FragmentRegistry | null;
+    /**
+     * FileProxy base URL.
+     */
+    fileProxyUrl: string;
+}
+/**
+ * Props for the FairuProvider component.
+ */
+export interface FairuProviderProps extends FairuClientConfig {
+    /**
+     * Child components.
+     */
+    children: ReactNode;
+    /**
+     * Custom fragment registry instance.
+     */
+    fragmentRegistry?: FragmentRegistry;
+    /**
+     * Existing urql client to use instead of creating a new one.
+     */
+    client?: Client;
+}
+/**
+ * React provider for Fairu SDK functionality.
+ *
+ * @example
+ * ```tsx
+ * import { FairuProvider } from '@fairu/sdk/react';
+ *
+ * function App() {
+ *   return (
+ *     <FairuProvider
+ *       url="https://fairu.app/graphql"
+ *       token={process.env.FAIRU_TOKEN}
+ *     >
+ *       <YourApp />
+ *     </FairuProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function FairuProvider({ children, fragmentRegistry, client: existingClient, ...clientConfig }: FairuProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the Fairu context.
+ *
+ * @throws Error if used outside of FairuProvider
+ */
+export declare function useFairuContext(): FairuContextValue;
+/**
+ * Hook to access the fragment registry.
+ */
+export declare function useFragments(): FragmentRegistry | null;
+/**
+ * Hook to get the FileProxy base URL.
+ */
+export declare function useFileProxyUrl(): string;
+/**
+ * Hook to access the urql client directly.
+ */
+export declare function useFairuClient(): Client;
+export {};
+//# sourceMappingURL=FairuProvider.d.ts.map

package/dist/client/FairuProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuProvider.d.ts","sourceRoot":"","sources":["../../src/client/FairuProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAE7C,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;GAEG;AACH,UAAU,iBAAiB;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,gBAAgB,EAChB,MAAM,EAAE,cAAc,EACtB,GAAG,YAAY,EAChB,EAAE,kBAAkB,2CA4BpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAQnD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/client/cache.d.ts

@@ -0,0 +1,6 @@
+import { CacheConfig } from './config';
+/**
+ * Create a Graphcache exchange with Fairu-specific configuration.
+ */
+export declare function createCacheExchange(config?: CacheConfig): import('urql').Exchange;
+//# sourceMappingURL=cache.d.ts.map

package/dist/client/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/client/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAuB5C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,WAAgB,2BAiO3D"}

package/dist/client/config.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Configuration options for the Fairu client.
+ */
+export interface FairuClientConfig {
+    /**
+     * The GraphQL API URL.
+     * @default 'https://fairu.app/graphql'
+     */
+    url?: string;
+    /**
+     * Static API token for authentication.
+     */
+    token?: string;
+    /**
+     * Function to dynamically get the API token.
+     * Useful for token refresh or async token retrieval.
+     */
+    getToken?: () => string | null | Promise<string | null>;
+    /**
+     * Cache configuration options.
+     */
+    cache?: CacheConfig;
+    /**
+     * Retry configuration for failed requests.
+     */
+    retry?: RetryConfig;
+    /**
+     * Callback for handling errors globally.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * FileProxy base URL for image transformations.
+     * @default 'https://files.fairu.app'
+     */
+    fileProxyUrl?: string;
+}
+/**
+ * Cache configuration options.
+ */
+export interface CacheConfig {
+    /**
+     * Whether caching is enabled.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Custom entity keys for cache normalization.
+     */
+    keys?: Record<string, (data: unknown) => string | null>;
+}
+/**
+ * Retry configuration options.
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts.
+     * @default 3
+     */
+    maxAttempts?: number;
+    /**
+     * Delay between retries in milliseconds.
+     * @default 1000
+     */
+    delayMs?: number;
+    /**
+     * Function to determine if an error should trigger a retry.
+     */
+    retryIf?: (error: Error) => boolean;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_CONFIG: Required<Pick<FairuClientConfig, 'url' | 'fileProxyUrl'>> & {
+    retry: Required<RetryConfig>;
+    cache: Required<CacheConfig>;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/client/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CACnC,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,cAAc,CAAC,CAChD,GAAG;IACF,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAgB9B,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { createFairuClient, type Client } from './FairuClient';
+export { FairuProvider, useFairuContext, useFragments, useFileProxyUrl, useFairuClient, type FairuProviderProps, } from './FairuProvider';
+export { createCacheExchange } from './cache';
+export { DEFAULT_CONFIG, type FairuClientConfig, type CacheConfig, type RetryConfig, } from './config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}

package/dist/errors/FairuError.d.ts

@@ -0,0 +1,107 @@
+import { CombinedError } from '@urql/core';
+import { GraphQLError as BaseGraphQLError } from 'graphql';
+/**
+ * Base error class for all Fairu SDK errors.
+ */
+export declare class FairuError extends Error {
+    readonly code?: string;
+    readonly originalError?: Error;
+    constructor(message: string, code?: string, originalError?: Error);
+    /**
+     * Create a FairuError from a urql CombinedError.
+     */
+    static fromCombinedError(error: CombinedError): FairuError;
+    /**
+     * Check if this error is a network error.
+     */
+    isNetworkError(): boolean;
+    /**
+     * Convert error to a plain object for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error class for validation failures.
+ */
+export declare class ValidationError extends FairuError {
+    readonly validationErrors: Record<string, string[]>;
+    constructor(message: string, validationErrors?: Record<string, string[]>);
+    /**
+     * Get errors for a specific field.
+     */
+    getFieldErrors(field: string): string[];
+    /**
+     * Check if a specific field has errors.
+     */
+    hasFieldError(field: string): boolean;
+    /**
+     * Get all field names with errors.
+     */
+    getFields(): string[];
+    /**
+     * Get the first error message for a field.
+     */
+    getFirstFieldError(field: string): string | undefined;
+    /**
+     * Get all error messages as a flat array.
+     */
+    getAllMessages(): string[];
+    /**
+     * Check if there are any validation errors.
+     */
+    hasErrors(): boolean;
+    /**
+     * Convert to JSON for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error class for authentication failures.
+ */
+export declare class AuthenticationError extends FairuError {
+    constructor(message?: string);
+    /**
+     * Check if this is an expired token error.
+     */
+    isTokenExpired(): boolean;
+    /**
+     * Check if this is a missing token error.
+     */
+    isMissingToken(): boolean;
+}
+/**
+ * Error class for GraphQL-specific errors.
+ */
+export declare class GraphQLError extends FairuError {
+    readonly graphqlErrors: readonly BaseGraphQLError[];
+    constructor(errors: readonly BaseGraphQLError[]);
+    /**
+     * Get the first GraphQL error.
+     */
+    getFirstError(): BaseGraphQLError | undefined;
+    /**
+     * Get all GraphQL errors.
+     */
+    getErrors(): readonly BaseGraphQLError[];
+    /**
+     * Check if any errors are validation errors.
+     */
+    hasValidationErrors(): boolean;
+    /**
+     * Get validation errors as a record of field names to error messages.
+     */
+    getValidationErrors(): Record<string, string[]>;
+    /**
+     * Check if any errors are authentication errors.
+     */
+    hasAuthenticationErrors(): boolean;
+    /**
+     * Get error paths.
+     */
+    getPaths(): (readonly (string | number)[] | undefined)[];
+    /**
+     * Convert to JSON for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=FairuError.d.ts.map

package/dist/errors/FairuError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FairuError.d.ts","sourceRoot":"","sources":["../../src/errors/FairuError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;IAYjE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU;IAoC1D;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,SAAgB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAGzD,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAOjD;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,GAAE,MAAuC;IAK5D;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,cAAc,IAAI,OAAO;CAG1B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,SAAgB,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;gBAE/C,MAAM,EAAE,SAAS,gBAAgB,EAAE;IAO/C;;OAEG;IACH,aAAa,IAAI,gBAAgB,GAAG,SAAS;IAI7C;;OAEG;IACH,SAAS,IAAI,SAAS,gBAAgB,EAAE;IAIxC;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAM9B;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAY/C;;OAEG;IACH,uBAAuB,IAAI,OAAO;IAMlC;;OAEG;IACH,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE;IAIxD;;OAEG;IACM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAU3C"}

package/dist/errors/UploadError.d.ts

@@ -0,0 +1,54 @@
+import { FairuError } from './FairuError';
+/**
+ * Upload error codes.
+ */
+export type UploadErrorCode = 'ABORTED' | 'NETWORK_ERROR' | 'INIT_FAILED' | 'PART_FAILED' | 'COMPLETE_FAILED' | 'SIZE_LIMIT_EXCEEDED' | 'INVALID_FILE_TYPE' | 'TIMEOUT';
+/**
+ * Error class for upload failures.
+ */
+export declare class UploadError extends FairuError {
+    readonly uploadCode?: UploadErrorCode;
+    readonly partNumber?: number;
+    constructor(message: string, code?: UploadErrorCode, partNumber?: number);
+    /**
+     * Check if the upload was aborted by the user.
+     */
+    isAborted(): boolean;
+    /**
+     * Check if this is a network error.
+     */
+    isNetworkError(): boolean;
+    /**
+     * Check if initialization failed.
+     */
+    isInitFailed(): boolean;
+    /**
+     * Check if a part upload failed.
+     */
+    isPartFailed(): boolean;
+    /**
+     * Check if completing the upload failed.
+     */
+    isCompleteFailed(): boolean;
+    /**
+     * Check if the file exceeded size limits.
+     */
+    isSizeLimitExceeded(): boolean;
+    /**
+     * Check if the file type is invalid.
+     */
+    isInvalidFileType(): boolean;
+    /**
+     * Check if the upload timed out.
+     */
+    isTimeout(): boolean;
+    /**
+     * Check if this error is retryable.
+     */
+    isRetryable(): boolean;
+    /**
+     * Convert to JSON for serialization.
+     */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=UploadError.d.ts.map

package/dist/errors/UploadError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadError.d.ts","sourceRoot":"","sources":["../../src/errors/UploadError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,eAAe,GACf,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,SAAgB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,eAAe,EACtB,UAAU,CAAC,EAAE,MAAM;IAQrB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACM,cAAc,IAAI,OAAO;IAIlC;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,WAAW,IAAI,OAAO;IAQtB;;OAEG;IACM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { FairuError, ValidationError, AuthenticationError, GraphQLError, } from './FairuError';
+export { UploadError, type UploadErrorCode } from './UploadError';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/fileproxy/FileProxyBuilder.d.ts

@@ -0,0 +1,141 @@
+import { FileProxyParams, ImageFormat, FitMode, VideoVersion, SignOptions } from './types';
+/**
+ * Fluent builder for constructing FileProxy URLs.
+ *
+ * @example
+ * ```typescript
+ * const url = new FileProxyBuilder('asset-uuid', 'image.jpg')
+ *   .width(800)
+ *   .height(600)
+ *   .quality(85)
+ *   .format('webp')
+ *   .build();
+ *
+ * // Result: https://files.fairu.app/asset-uuid/image.jpg?width=800&height=600&quality=85&format=webp
+ * ```
+ */
+export declare class FileProxyBuilder {
+    private readonly id;
+    private readonly name;
+    private params;
+    private baseUrl;
+    constructor(id: string, name: string, baseUrl?: string);
+    /**
+     * Set the width in pixels (1-6000).
+     */
+    width(value: number): this;
+    /**
+     * Set the height in pixels (1-6000).
+     */
+    height(value: number): this;
+    /**
+     * Set dimensions (width and height).
+     */
+    dimensions(width: number, height: number): this;
+    /**
+     * Set the quality (1-100, default: 95).
+     */
+    quality(value: number): this;
+    /**
+     * Set the output format.
+     */
+    format(value: ImageFormat): this;
+    /**
+     * Set the fit mode for cropping.
+     */
+    fit(value: FitMode): this;
+    /**
+     * Set the focal point for smart cropping.
+     *
+     * @param x - X position (0-100%)
+     * @param y - Y position (0-100%)
+     * @param zoom - Zoom multiplier (1.0-100.0)
+     */
+    focal(x: number, y: number, zoom?: number): this;
+    /**
+     * Set focal point from a string (e.g., "50-30-1.5" or "50,50").
+     */
+    focalFromString(value: string | null | undefined): this;
+    /**
+     * Return raw/original file without processing.
+     */
+    raw(value?: boolean): this;
+    /**
+     * Process SVG to raster WebP.
+     */
+    processSvg(value?: boolean): this;
+    /**
+     * Set video quality version.
+     */
+    version(value: VideoVersion): this;
+    /**
+     * Set video timestamp for frame extraction.
+     *
+     * @param value - Timestamp in format HH:MM:SS.mmm
+     */
+    timestamp(value: string): this;
+    /**
+     * Set timestamp from seconds.
+     */
+    timestampFromSeconds(seconds: number): this;
+    /**
+     * Sign the URL for protected files.
+     */
+    sign(options: SignOptions | string): this;
+    /**
+     * Create HMAC-SHA256 signature (environment-specific implementation needed).
+     */
+    private createHmacSignature;
+    /**
+     * Set a pre-computed signature.
+     */
+    withSignature(signature: string, signatureDate: string | number): this;
+    /**
+     * Build the URL string.
+     */
+    build(): string;
+    /**
+     * Build the query string from params.
+     */
+    private buildQueryString;
+    /**
+     * Get the current parameters.
+     */
+    getParams(): FileProxyParams;
+    /**
+     * Convert to string (alias for build).
+     */
+    toString(): string;
+}
+/**
+ * Create a new FileProxyBuilder.
+ *
+ * @example
+ * ```typescript
+ * import { fileProxy } from '@fairu/sdk/fileproxy';
+ *
+ * const url = fileProxy('asset-uuid', 'image.jpg')
+ *   .width(800)
+ *   .format('webp')
+ *   .build();
+ * ```
+ */
+export declare function fileProxy(id: string, name: string, baseUrl?: string): FileProxyBuilder;
+/**
+ * Utility functions for FileProxy.
+ */
+export declare const fileProxyUtils: {
+    /**
+     * Build a meta URL for getting image dimensions.
+     */
+    meta(id: string, baseUrl?: string): string;
+    /**
+     * Build an HLS video streaming URL.
+     */
+    hls(tenantId: string, assetId: string, path: string, baseUrl?: string): string;
+    /**
+     * Build an HLS decryption key URL.
+     */
+    hlsKey(id: string, quality: VideoVersion, filename: string, baseUrl?: string): string;
+};
+//# sourceMappingURL=FileProxyBuilder.d.ts.map

package/dist/fileproxy/FileProxyBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileProxyBuilder.d.ts","sourceRoot":"","sources":["../../src/fileproxy/FileProxyBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAS;gBAGL,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,MAAM;IAKlB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAKhC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKzB;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,IAAI;IAcnD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAsBvD;;OAEG;IACH,GAAG,CAAC,KAAK,GAAE,OAAc,GAAG,IAAI;IAKhC;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,OAAc,GAAG,IAAI;IAKvC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKlC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAc3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAmBzC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAStE;;OAEG;IACH,KAAK,IAAI,MAAM;IAWf;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,CAElB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;aACM,MAAM,YAAW,MAAM,GAAsB,MAAM;IAI5D;;OAEG;kBAES,MAAM,WACP,MAAM,QACT,MAAM,YACH,MAAM,GACd,MAAM;IAIT;;OAEG;eAEG,MAAM,WACD,YAAY,YACX,MAAM,YACP,MAAM,GACd,MAAM;CAGV,CAAC"}

package/dist/fileproxy/index.d.ts

@@ -0,0 +1,4 @@
+export { FileProxyBuilder, fileProxy, fileProxyUtils, } from './FileProxyBuilder';
+export { useFileProxyUrl, useResponsiveImageUrl, type UseFileProxyUrlOptions, } from './useFileProxyUrl';
+export type { FileProxyParams, ImageFormat, FitMode, VideoVersion, SignOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fileproxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/fileproxy/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Image format options.
+ */
+export type ImageFormat = 'jpg' | 'jpeg' | 'png' | 'webp';
+/**
+ * Fit mode for image cropping.
+ */
+export type FitMode = 'cover' | 'contain';
+/**
+ * Video quality versions.
+ */
+export type VideoVersion = 'low' | 'medium' | 'high';
+/**
+ * FileProxy URL parameters.
+ */
+export interface FileProxyParams {
+    /**
+     * Width in pixels (1-6000).
+     */
+    width?: number;
+    /**
+     * Height in pixels (1-6000).
+     */
+    height?: number;
+    /**
+     * Quality (1-100, default: 95).
+     */
+    quality?: number;
+    /**
+     * Output format.
+     */
+    format?: ImageFormat;
+    /**
+     * Fit mode for cropping.
+     */
+    fit?: FitMode;
+    /**
+     * Focal point for smart cropping (x-y-zoom).
+     */
+    focal?: string;
+    /**
+     * Return raw/original file without processing.
+     */
+    raw?: boolean;
+    /**
+     * Process SVG to raster WebP.
+     */
+    process_svg?: boolean;
+    /**
+     * Video quality version.
+     */
+    version?: VideoVersion;
+    /**
+     * Video timestamp for frame extraction (HH:MM:SS.mmm).
+     */
+    timestamp?: string;
+    /**
+     * HMAC-SHA256 signature for protected files.
+     */
+    signature?: string;
+    /**
+     * Unix timestamp for signature validation.
+     */
+    signature_date?: string;
+}
+/**
+ * Options for building signed URLs.
+ */
+export interface SignOptions {
+    /**
+     * Secret key for HMAC signature.
+     */
+    secretKey: string;
+    /**
+     * Expiration time in seconds (optional).
+     */
+    expiresIn?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fileproxy/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}