@trokky/client 2.0.3

package/dist/media/helper.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Media Helper Module
+ * Utilities for working with Trokky media assets with dynamic variant discovery
+ */
+import type { HttpClient } from '../http/client.js';
+import type { MediaFieldValue } from '@trokky/trokky/types';
+export interface MediaVariant {
+    url: string;
+    width: number;
+    height: number;
+    format: string;
+    size: number;
+}
+export interface MediaFile {
+    id: string;
+    url: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    metadata?: {
+        path?: string;
+        extension?: string;
+        originalFilename?: string;
+        imageVariants?: Record<string, MediaVariant>;
+        originalDimensions?: {
+            width: number;
+            height: number;
+        };
+    };
+    _createdAt: string;
+}
+export interface MediaResponse {
+    success: boolean;
+    data: {
+        file: MediaFile;
+    };
+}
+/**
+ * Media helper class for working with media assets
+ */
+export declare class MediaHelper {
+    private http;
+    private metadataCache;
+    constructor(http: HttpClient);
+    /**
+     * Fetch media metadata to check available variants
+     */
+    fetchMetadata(mediaId: string): Promise<MediaFile | null>;
+    /**
+     * Get the URL for a media asset
+     * @param mediaAsset The media asset reference
+     * @param variant The desired variant name (e.g., 'thumbnail', 'preview', or any custom variant)
+     * @returns The media URL or null if not available
+     */
+    getUrl(mediaAsset: MediaFieldValue | null | undefined, variant?: string): string | null;
+    /**
+     * Validate and get the best available media URL
+     * Checks if variant exists and falls back to original if not
+     */
+    getValidatedUrl(mediaAsset: MediaFieldValue | null | undefined, variant?: string): Promise<string | null>;
+    /**
+     * Get the best image URL for a given max width
+     * This method dynamically discovers available variants and chooses the best one
+     */
+    getBestUrlForWidth(mediaAsset: MediaFieldValue | null | undefined, maxWidth: number): Promise<string | null>;
+    /**
+     * Get available variants for a media asset
+     * Returns an array of variant names that are available
+     */
+    getAvailableVariants(mediaAsset: MediaFieldValue | null | undefined): Promise<string[]>;
+    /**
+     * Check if a media asset has a specific variant
+     */
+    hasVariant(mediaAsset: MediaFieldValue | null | undefined, variant: string): Promise<boolean>;
+    /**
+     * Get all variant URLs for a media asset
+     * Returns an object with variant names as keys and URLs as values
+     */
+    getAllVariantUrls(mediaAsset: MediaFieldValue | null | undefined): Promise<Record<string, string>>;
+    /**
+     * Clear the metadata cache
+     */
+    clearCache(): void;
+    /**
+     * Clear cache for a specific media ID
+     */
+    clearCacheFor(mediaId: string): void;
+}
+//# sourceMappingURL=helper.d.ts.map

package/dist/media/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/media/helper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAC5C,kBAAkB,CAAC,EAAE;YACnB,KAAK,EAAE,MAAM,CAAA;YACb,MAAM,EAAE,MAAM,CAAA;SACf,CAAA;KACF,CAAA;IACD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS,CAAA;KAChB,CAAA;CACF;AAED;;GAEG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,aAAa,CAA+C;gBAEhD,IAAI,EAAE,UAAU;IAEpC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAkB/D;;;;;OAKG;IACH,MAAM,CACJ,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,IAAI;IAgBhB;;;OAGG;IACG,eAAe,CACnB,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyCzB;;;OAGG;IACG,kBAAkB,CACtB,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC9C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqDzB;;;OAGG;IACG,oBAAoB,CACxB,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAC7C,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBpB;;OAEG;IACG,UAAU,CACd,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IAenB;;;OAGG;IACG,iBAAiB,CACrB,UAAU,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAsBlC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGrC"}

package/dist/media/helper.js

@@ -0,0 +1,197 @@
+/**
+ * Media Helper Module
+ * Utilities for working with Trokky media assets with dynamic variant discovery
+ */
+/**
+ * Media helper class for working with media assets
+ */
+export class MediaHelper {
+    constructor(http) {
+        this.http = http;
+        this.metadataCache = new Map();
+    }
+    /**
+     * Fetch media metadata to check available variants
+     */
+    async fetchMetadata(mediaId) {
+        const cacheKey = mediaId;
+        if (this.metadataCache.has(cacheKey)) {
+            return this.metadataCache.get(cacheKey);
+        }
+        const promise = this.http.get(`/media/${mediaId}`)
+            .then(response => response?.data?.file || null)
+            .catch(error => {
+            console.warn(`Failed to fetch media metadata for ${mediaId}:`, error);
+            return null;
+        });
+        this.metadataCache.set(cacheKey, promise);
+        return promise;
+    }
+    /**
+     * Get the URL for a media asset
+     * @param mediaAsset The media asset reference
+     * @param variant The desired variant name (e.g., 'thumbnail', 'preview', or any custom variant)
+     * @returns The media URL or null if not available
+     */
+    getUrl(mediaAsset, variant) {
+        if (!mediaAsset?.asset?._ref) {
+            return null;
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const baseUrl = this.http.getBaseUrl();
+        if (!variant || variant === 'original') {
+            return `${baseUrl}/media/${mediaId}/file`;
+        }
+        // Return optimistic URL for SSR/SSG
+        return `${baseUrl}/media/${mediaId}/variants/${variant}`;
+    }
+    /**
+     * Validate and get the best available media URL
+     * Checks if variant exists and falls back to original if not
+     */
+    async getValidatedUrl(mediaAsset, variant) {
+        if (!mediaAsset?.asset?._ref) {
+            return null;
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const baseUrl = this.http.getBaseUrl();
+        // Always have original as fallback
+        const originalUrl = `${baseUrl}/media/${mediaId}/file`;
+        if (!variant || variant === 'original') {
+            return originalUrl;
+        }
+        // Fetch metadata to check if variant exists
+        const metadata = await this.fetchMetadata(mediaId);
+        if (!metadata) {
+            // If we can't fetch metadata, return original as safe fallback
+            return originalUrl;
+        }
+        // Check if the specific variant exists
+        const variantExists = metadata.metadata?.imageVariants?.[variant];
+        if (variantExists) {
+            return `${baseUrl}/media/${mediaId}/variants/${variant}`;
+        }
+        // Try thumbnail as a fallback (it's always generated)
+        if (variant !== 'thumbnail' && metadata.metadata?.imageVariants?.['thumbnail']) {
+            console.warn(`Variant '${variant}' not found for media ${mediaId}, using thumbnail`);
+            return `${baseUrl}/media/${mediaId}/variants/thumbnail`;
+        }
+        // Final fallback to original
+        console.warn(`No variants found for media ${mediaId}, using original`);
+        return originalUrl;
+    }
+    /**
+     * Get the best image URL for a given max width
+     * This method dynamically discovers available variants and chooses the best one
+     */
+    async getBestUrlForWidth(mediaAsset, maxWidth) {
+        if (!mediaAsset?.asset?._ref) {
+            return null;
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const baseUrl = this.http.getBaseUrl();
+        const originalUrl = `${baseUrl}/media/${mediaId}/file`;
+        // Fetch metadata to discover available variants
+        const metadata = await this.fetchMetadata(mediaId);
+        if (!metadata?.metadata?.imageVariants) {
+            // No variants available, return original
+            return originalUrl;
+        }
+        // Find the best variant based on width
+        const variants = metadata.metadata.imageVariants;
+        let bestVariant = null;
+        let closestLarger = null;
+        let closestSmaller = null;
+        for (const [name, variant] of Object.entries(variants)) {
+            if (!variant)
+                continue;
+            if (variant.width === maxWidth) {
+                // Exact match
+                bestVariant = { name, variant };
+                break;
+            }
+            else if (variant.width > maxWidth) {
+                // Larger than needed
+                if (!closestLarger || variant.width < closestLarger.variant.width) {
+                    closestLarger = { name, variant };
+                }
+            }
+            else {
+                // Smaller than needed
+                if (!closestSmaller || variant.width > closestSmaller.variant.width) {
+                    closestSmaller = { name, variant };
+                }
+            }
+        }
+        // Choose the best variant: exact match > closest larger > closest smaller > original
+        const chosen = bestVariant || closestLarger || closestSmaller;
+        if (chosen) {
+            return `${baseUrl}/media/${mediaId}/variants/${chosen.name}`;
+        }
+        return originalUrl;
+    }
+    /**
+     * Get available variants for a media asset
+     * Returns an array of variant names that are available
+     */
+    async getAvailableVariants(mediaAsset) {
+        if (!mediaAsset?.asset?._ref) {
+            return [];
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const metadata = await this.fetchMetadata(mediaId);
+        const variants = ['original']; // Always have original
+        if (metadata?.metadata?.imageVariants) {
+            variants.push(...Object.keys(metadata.metadata.imageVariants));
+        }
+        return variants;
+    }
+    /**
+     * Check if a media asset has a specific variant
+     */
+    async hasVariant(mediaAsset, variant) {
+        if (!mediaAsset?.asset?._ref) {
+            return false;
+        }
+        if (!variant || variant === 'original') {
+            return true;
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const metadata = await this.fetchMetadata(mediaId);
+        return !!metadata?.metadata?.imageVariants?.[variant];
+    }
+    /**
+     * Get all variant URLs for a media asset
+     * Returns an object with variant names as keys and URLs as values
+     */
+    async getAllVariantUrls(mediaAsset) {
+        if (!mediaAsset?.asset?._ref) {
+            return {};
+        }
+        const mediaId = mediaAsset.asset._ref;
+        const baseUrl = this.http.getBaseUrl();
+        const metadata = await this.fetchMetadata(mediaId);
+        const urls = {
+            original: `${baseUrl}/media/${mediaId}/file`
+        };
+        if (metadata?.metadata?.imageVariants) {
+            for (const variantName of Object.keys(metadata.metadata.imageVariants)) {
+                urls[variantName] = `${baseUrl}/media/${mediaId}/variants/${variantName}`;
+            }
+        }
+        return urls;
+    }
+    /**
+     * Clear the metadata cache
+     */
+    clearCache() {
+        this.metadataCache.clear();
+    }
+    /**
+     * Clear cache for a specific media ID
+     */
+    clearCacheFor(mediaId) {
+        this.metadataCache.delete(mediaId);
+    }
+}
+//# sourceMappingURL=helper.js.map

package/dist/media/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/media/helper.ts"],"names":[],"mappings":"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"}

package/dist/media/url-builder.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Fluent Image URL Builder
+ * Provides a chainable API for building media URLs with transformations
+ *
+ * Inspired by Sanity's @sanity/image-url builder
+ */
+import type { MediaFieldValue } from '@trokky/trokky/types';
+export interface ImageUrlBuilderOptions {
+    /** Base URL for media API */
+    baseUrl: string;
+    /** Use proxy path instead of direct API URL */
+    proxyPath?: string;
+}
+export type ImageFormat = 'webp' | 'jpeg' | 'jpg' | 'png' | 'avif' | 'auto';
+export type ImageFit = 'cover' | 'contain' | 'fill' | 'inside' | 'outside';
+/**
+ * Fluent builder for constructing media URLs with transformations
+ *
+ * @example
+ * ```typescript
+ * const url = client.imageUrl(article.featuredImage)
+ *   .width(800)
+ *   .height(400)
+ *   .format('webp')
+ *   .quality(85)
+ *   .url()
+ * ```
+ */
+export declare class ImageUrlBuilder {
+    private options;
+    private mediaId;
+    private _width?;
+    private _height?;
+    private _format?;
+    private _quality?;
+    private _fit?;
+    private _variant?;
+    private _blur?;
+    private _sharpen?;
+    private _grayscale?;
+    constructor(options: ImageUrlBuilderOptions);
+    /**
+     * Set the image source from a media field value
+     */
+    image(source: MediaFieldValue | string | null | undefined): this;
+    /**
+     * Set image width
+     */
+    width(w: number): this;
+    /**
+     * Set image height
+     */
+    height(h: number): this;
+    /**
+     * Set both width and height
+     */
+    size(w: number, h: number): this;
+    /**
+     * Set image format
+     */
+    format(fmt: ImageFormat): this;
+    /**
+     * Set image quality (1-100)
+     */
+    quality(q: number): this;
+    /**
+     * Set image fit mode
+     */
+    fit(mode: ImageFit): this;
+    /**
+     * Use a predefined variant (e.g., 'thumbnail', 'medium', 'large')
+     * When a variant is set, other transformations are ignored
+     */
+    variant(name: string): this;
+    /**
+     * Apply blur effect (0-100)
+     */
+    blur(amount: number): this;
+    /**
+     * Apply sharpening (0-100)
+     */
+    sharpen(amount: number): this;
+    /**
+     * Convert to grayscale
+     */
+    grayscale(): this;
+    /**
+     * Preset for thumbnail size (200x200 cover)
+     */
+    thumbnail(): this;
+    /**
+     * Preset for medium size
+     */
+    medium(): this;
+    /**
+     * Preset for large size
+     */
+    large(): this;
+    /**
+     * Get the original file without transformations
+     */
+    original(): this;
+    /**
+     * Auto-select best format for browser
+     */
+    auto(): this;
+    /**
+     * Build and return the URL string
+     */
+    url(): string | null;
+    /**
+     * Build URL string (alias for url())
+     */
+    toString(): string;
+}
+/**
+ * Create an image URL builder factory
+ */
+export declare function createImageUrlBuilder(options: ImageUrlBuilderOptions): (source: MediaFieldValue | string | null | undefined) => ImageUrlBuilder;
+/**
+ * Get responsive srcset for an image
+ *
+ * @example
+ * ```typescript
+ * const srcset = getSrcSet(article.image, {
+ *   baseUrl: 'http://localhost:3000/api',
+ *   widths: [400, 800, 1200]
+ * })
+ * // Returns: "/media/abc123/file?w=400 400w, /media/abc123/file?w=800 800w, ..."
+ * ```
+ */
+export declare function getSrcSet(source: MediaFieldValue | null | undefined, options: {
+    baseUrl: string;
+    proxyPath?: string;
+    widths?: number[];
+    variants?: string[];
+}): string | null;
+/**
+ * Get the best variant for a given viewport width
+ */
+export declare function getBestVariant(maxWidth: number): string;
+//# sourceMappingURL=url-builder.d.ts.map

package/dist/media/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/media/url-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAC3E,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE1E;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAYd,OAAO,CAAC,OAAO;IAX3B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,IAAI,CAAC,CAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;gBAER,OAAO,EAAE,sBAAsB;IAEnD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAiBhE;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAK9B;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKzB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,GAAG,IAAI,MAAM,GAAG,IAAI;IAqDpB;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,IAC5C,QAAQ,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,eAAe,CAG7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,EAAE;IACP,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB,GACA,MAAM,GAAG,IAAI,CAuCf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKvD"}