smart-glide-react 1.0.0

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next.ts"],"names":[],"mappings":";;;;;AAuBO,SAAS,oBAAA,CAAqB;AAAA,EACnC,GAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA,GAAU;AACZ,CAAA,EAAmC;AACjC,EAAA,MAAM,QACJ,OAAA,CAAQ,GAAA,CAAI,+BAA+B,EAAA,EAC3C,OAAA,CAAQ,OAAO,EAAE,CAAA;AAEnB,EAAA,MAAM,UACJ,OAAA,CAAQ,GAAA,CAAI,yCAAyC,MAAA,EACrD,OAAA,CAAQ,OAAO,EAAE,CAAA;AAEnB,EAAA,MAAM,QAAA,GAAW,GAAA,CAAI,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAEtC,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,MAAM,IAAI,QAAQ,CAAA,GAAA,EAAM,KAAK,CAAA,GAAA,EAAM,OAAO,CAAA,QAAA,CAAA;AAC9D;AAEA,IAAO,YAAA,GAAQ","file":"next.js","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — Next.js entry point\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SmartGlideLoaderConfig {\n  src: string;\n  width: number;\n  quality?: number;\n}\n\n/**\n * Smart Glide loader for `next/image`.\n *\n * Usage in `smart-glide-loader.ts` (project root):\n * ```ts\n * export { smartGlideNextLoader as default } from 'smart-glide-react/next';\n * ```\n *\n * Then in `next.config.ts`:\n * ```ts\n * images: { loader: 'custom', loaderFile: './smart-glide-loader.ts' }\n * ```\n */\nexport function smartGlideNextLoader({\n  src,\n  width,\n  quality = 80,\n}: SmartGlideLoaderConfig): string {\n  const base = (\n    process.env.NEXT_PUBLIC_SMART_GLIDE_URL ?? ''\n  ).replace(/\\/$/, '');\n\n  const prefix = (\n    process.env.NEXT_PUBLIC_SMART_GLIDE_DELIVERY_PATH ?? '/img'\n  ).replace(/^\\//, '');\n\n  const cleanSrc = src.replace(/^\\//, '');\n\n  return `${base}/${prefix}/${cleanSrc}?w=${width}&q=${quality}&fm=webp`;\n}\n\nexport default smartGlideNextLoader;\n"]}

package/dist/next.mjs

@@ -0,0 +1,16 @@
+// src/next.ts
+function smartGlideNextLoader({
+  src,
+  width,
+  quality = 80
+}) {
+  const base = (process.env.NEXT_PUBLIC_SMART_GLIDE_URL ?? "").replace(/\/$/, "");
+  const prefix = (process.env.NEXT_PUBLIC_SMART_GLIDE_DELIVERY_PATH ?? "/img").replace(/^\//, "");
+  const cleanSrc = src.replace(/^\//, "");
+  return `${base}/${prefix}/${cleanSrc}?w=${width}&q=${quality}&fm=webp`;
+}
+var next_default = smartGlideNextLoader;
+
+export { next_default as default, smartGlideNextLoader };
+//# sourceMappingURL=next.mjs.map
+//# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next.ts"],"names":[],"mappings":";AAuBO,SAAS,oBAAA,CAAqB;AAAA,EACnC,GAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA,GAAU;AACZ,CAAA,EAAmC;AACjC,EAAA,MAAM,QACJ,OAAA,CAAQ,GAAA,CAAI,+BAA+B,EAAA,EAC3C,OAAA,CAAQ,OAAO,EAAE,CAAA;AAEnB,EAAA,MAAM,UACJ,OAAA,CAAQ,GAAA,CAAI,yCAAyC,MAAA,EACrD,OAAA,CAAQ,OAAO,EAAE,CAAA;AAEnB,EAAA,MAAM,QAAA,GAAW,GAAA,CAAI,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAEtC,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,MAAM,IAAI,QAAQ,CAAA,GAAA,EAAM,KAAK,CAAA,GAAA,EAAM,OAAO,CAAA,QAAA,CAAA;AAC9D;AAEA,IAAO,YAAA,GAAQ","file":"next.mjs","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — Next.js entry point\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SmartGlideLoaderConfig {\n  src: string;\n  width: number;\n  quality?: number;\n}\n\n/**\n * Smart Glide loader for `next/image`.\n *\n * Usage in `smart-glide-loader.ts` (project root):\n * ```ts\n * export { smartGlideNextLoader as default } from 'smart-glide-react/next';\n * ```\n *\n * Then in `next.config.ts`:\n * ```ts\n * images: { loader: 'custom', loaderFile: './smart-glide-loader.ts' }\n * ```\n */\nexport function smartGlideNextLoader({\n  src,\n  width,\n  quality = 80,\n}: SmartGlideLoaderConfig): string {\n  const base = (\n    process.env.NEXT_PUBLIC_SMART_GLIDE_URL ?? ''\n  ).replace(/\\/$/, '');\n\n  const prefix = (\n    process.env.NEXT_PUBLIC_SMART_GLIDE_DELIVERY_PATH ?? '/img'\n  ).replace(/^\\//, '');\n\n  const cleanSrc = src.replace(/^\\//, '');\n\n  return `${base}/${prefix}/${cleanSrc}?w=${width}&q=${quality}&fm=webp`;\n}\n\nexport default smartGlideNextLoader;\n"]}

package/dist/server.d.mts

@@ -0,0 +1,112 @@
+/** Named responsive presets available on the Laravel backend. */
+type ResponsivePreset = 'hero' | 'thumbnails' | 'square' | 'portrait' | 'hd' | 'fhd' | 'retina' | (string & {});
+/** Named image profiles available on the Laravel backend. */
+type ImageProfile = 'default' | 'thumbnail' | 'hero' | 'portrait' | 'square' | 'profile_photo' | 'cover' | 'background' | (string & {});
+/** Response shape returned by the `/img-data` API. */
+interface SmartGlideData {
+    src: string;
+    srcset?: string | null;
+    sizes?: string | null;
+    widths?: number[];
+    blurDataUrl?: string | null;
+    schema?: Record<string, unknown> | null;
+}
+/** Options passed to `useSmartGlide` and lower-level helpers. */
+interface SmartGlideOptions {
+    /** Relative path of the image (e.g. `"products/phone.jpg"`). */
+    path: string;
+    /**
+     * Base URL of your Laravel app (e.g. `"https://api.example.com"`).
+     * Defaults to the `NEXT_PUBLIC_SMART_GLIDE_URL` / `VITE_SMART_GLIDE_URL`
+     * environment variable when omitted.
+     */
+    baseUrl?: string;
+    /** Named or custom compression profile (default: `"default"`). */
+    profile?: ImageProfile;
+    /**
+     * Responsive breakpoints:
+     *  - `"hero"` — named preset
+     *  - `[640, 960, 1280]` — custom widths
+     *  - `false` — disable srcset
+     */
+    responsive?: ResponsivePreset | number[] | false;
+    /** Fetch the blurred Base64 LQIP from the server. Enables `blurDataUrl`. */
+    blurPlaceholder?: boolean;
+    /** Request JSON-LD `ImageObject` data from the server. */
+    schema?: boolean;
+    /** Extra Glide transformation params (w, h, fit, focus, q…). */
+    params?: Record<string, string | number>;
+    /**
+     * Additional fetch options forwarded to the underlying `fetch()` call.
+     * (e.g. `{ next: { revalidate: 3600 } }` for Next.js ISR)
+     */
+    fetchOptions?: RequestInit;
+}
+
+/**
+ * Fetch Smart Glide image data on the server.
+ * Use this inside Next.js Server Components or `generateStaticParams`.
+ *
+ * Supports Next.js ISR via `fetchOptions.next.revalidate`.
+ *
+ * @example
+ * // app/products/[id]/page.tsx  (Server Component)
+ * import { fetchSmartGlideData } from 'smart-glide-react/server';
+ *
+ * export default async function ProductPage({ params }) {
+ *   const image = await fetchSmartGlideData({
+ *     path: `products/${params.id}.jpg`,
+ *     profile: 'hero',
+ *     responsive: 'retina',
+ *     blurPlaceholder: true,
+ *     schema: true,
+ *     baseUrl: process.env.SMART_GLIDE_URL, // server-side env (no NEXT_PUBLIC_ prefix)
+ *     fetchOptions: { next: { revalidate: 3600 } }, // ISR: revalidate every hour
+ *   });
+ *
+ *   return (
+ *     <img
+ *       src={image.src}
+ *       srcSet={image.srcset ?? undefined}
+ *       sizes={image.sizes ?? undefined}
+ *       alt="Product"
+ *       {...(image.blurDataUrl
+ *         ? { style: { backgroundImage: `url(${image.blurDataUrl})` } }
+ *         : {})}
+ *     />
+ *   );
+ * }
+ */
+declare function fetchSmartGlideData(options: SmartGlideOptions): Promise<SmartGlideData>;
+/**
+ * Fetch multiple images in parallel — useful for generating static params
+ * or pre-loading image data for a collection of items.
+ *
+ * @example
+ * const [hero, thumbnail, avatar] = await fetchSmartGlideMany([
+ *   { path: 'home/hero.jpg',    profile: 'hero',      responsive: 'fhd' },
+ *   { path: 'home/thumb.jpg',   profile: 'thumbnail', responsive: 'thumbnails' },
+ *   { path: 'avatars/user.jpg', profile: 'profile_photo' },
+ * ], { baseUrl: process.env.SMART_GLIDE_URL });
+ */
+declare function fetchSmartGlideMany(items: Omit<SmartGlideOptions, 'baseUrl'>[], shared: Pick<SmartGlideOptions, 'baseUrl' | 'fetchOptions'>): Promise<SmartGlideData[]>;
+/**
+ * Fetch Smart Glide data and return a preload `<link>` hint header value.
+ * Use with `headers()` in Next.js route handlers or middleware.
+ *
+ * @example
+ * // app/api/page-data/route.ts
+ * import { headers } from 'next/headers';
+ * import { buildPreloadHeader } from 'smart-glide-react/server';
+ *
+ * export async function GET() {
+ *   const preload = await buildPreloadHeader('home/hero.jpg', {
+ *     baseUrl: process.env.SMART_GLIDE_URL,
+ *     profile: 'hero',
+ *   });
+ *   return new Response(null, { headers: { Link: preload } });
+ * }
+ */
+declare function buildPreloadHeader(path: string, options: SmartGlideOptions): Promise<string>;
+
+export { buildPreloadHeader, fetchSmartGlideData, fetchSmartGlideMany };

package/dist/server.d.ts

@@ -0,0 +1,112 @@
+/** Named responsive presets available on the Laravel backend. */
+type ResponsivePreset = 'hero' | 'thumbnails' | 'square' | 'portrait' | 'hd' | 'fhd' | 'retina' | (string & {});
+/** Named image profiles available on the Laravel backend. */
+type ImageProfile = 'default' | 'thumbnail' | 'hero' | 'portrait' | 'square' | 'profile_photo' | 'cover' | 'background' | (string & {});
+/** Response shape returned by the `/img-data` API. */
+interface SmartGlideData {
+    src: string;
+    srcset?: string | null;
+    sizes?: string | null;
+    widths?: number[];
+    blurDataUrl?: string | null;
+    schema?: Record<string, unknown> | null;
+}
+/** Options passed to `useSmartGlide` and lower-level helpers. */
+interface SmartGlideOptions {
+    /** Relative path of the image (e.g. `"products/phone.jpg"`). */
+    path: string;
+    /**
+     * Base URL of your Laravel app (e.g. `"https://api.example.com"`).
+     * Defaults to the `NEXT_PUBLIC_SMART_GLIDE_URL` / `VITE_SMART_GLIDE_URL`
+     * environment variable when omitted.
+     */
+    baseUrl?: string;
+    /** Named or custom compression profile (default: `"default"`). */
+    profile?: ImageProfile;
+    /**
+     * Responsive breakpoints:
+     *  - `"hero"` — named preset
+     *  - `[640, 960, 1280]` — custom widths
+     *  - `false` — disable srcset
+     */
+    responsive?: ResponsivePreset | number[] | false;
+    /** Fetch the blurred Base64 LQIP from the server. Enables `blurDataUrl`. */
+    blurPlaceholder?: boolean;
+    /** Request JSON-LD `ImageObject` data from the server. */
+    schema?: boolean;
+    /** Extra Glide transformation params (w, h, fit, focus, q…). */
+    params?: Record<string, string | number>;
+    /**
+     * Additional fetch options forwarded to the underlying `fetch()` call.
+     * (e.g. `{ next: { revalidate: 3600 } }` for Next.js ISR)
+     */
+    fetchOptions?: RequestInit;
+}
+
+/**
+ * Fetch Smart Glide image data on the server.
+ * Use this inside Next.js Server Components or `generateStaticParams`.
+ *
+ * Supports Next.js ISR via `fetchOptions.next.revalidate`.
+ *
+ * @example
+ * // app/products/[id]/page.tsx  (Server Component)
+ * import { fetchSmartGlideData } from 'smart-glide-react/server';
+ *
+ * export default async function ProductPage({ params }) {
+ *   const image = await fetchSmartGlideData({
+ *     path: `products/${params.id}.jpg`,
+ *     profile: 'hero',
+ *     responsive: 'retina',
+ *     blurPlaceholder: true,
+ *     schema: true,
+ *     baseUrl: process.env.SMART_GLIDE_URL, // server-side env (no NEXT_PUBLIC_ prefix)
+ *     fetchOptions: { next: { revalidate: 3600 } }, // ISR: revalidate every hour
+ *   });
+ *
+ *   return (
+ *     <img
+ *       src={image.src}
+ *       srcSet={image.srcset ?? undefined}
+ *       sizes={image.sizes ?? undefined}
+ *       alt="Product"
+ *       {...(image.blurDataUrl
+ *         ? { style: { backgroundImage: `url(${image.blurDataUrl})` } }
+ *         : {})}
+ *     />
+ *   );
+ * }
+ */
+declare function fetchSmartGlideData(options: SmartGlideOptions): Promise<SmartGlideData>;
+/**
+ * Fetch multiple images in parallel — useful for generating static params
+ * or pre-loading image data for a collection of items.
+ *
+ * @example
+ * const [hero, thumbnail, avatar] = await fetchSmartGlideMany([
+ *   { path: 'home/hero.jpg',    profile: 'hero',      responsive: 'fhd' },
+ *   { path: 'home/thumb.jpg',   profile: 'thumbnail', responsive: 'thumbnails' },
+ *   { path: 'avatars/user.jpg', profile: 'profile_photo' },
+ * ], { baseUrl: process.env.SMART_GLIDE_URL });
+ */
+declare function fetchSmartGlideMany(items: Omit<SmartGlideOptions, 'baseUrl'>[], shared: Pick<SmartGlideOptions, 'baseUrl' | 'fetchOptions'>): Promise<SmartGlideData[]>;
+/**
+ * Fetch Smart Glide data and return a preload `<link>` hint header value.
+ * Use with `headers()` in Next.js route handlers or middleware.
+ *
+ * @example
+ * // app/api/page-data/route.ts
+ * import { headers } from 'next/headers';
+ * import { buildPreloadHeader } from 'smart-glide-react/server';
+ *
+ * export async function GET() {
+ *   const preload = await buildPreloadHeader('home/hero.jpg', {
+ *     baseUrl: process.env.SMART_GLIDE_URL,
+ *     profile: 'hero',
+ *   });
+ *   return new Response(null, { headers: { Link: preload } });
+ * }
+ */
+declare function buildPreloadHeader(path: string, options: SmartGlideOptions): Promise<string>;
+
+export { buildPreloadHeader, fetchSmartGlideData, fetchSmartGlideMany };

package/dist/server.js

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/url-builder.ts
+function resolveBaseUrl(baseUrl) {
+  if (baseUrl) return baseUrl.replace(/\/$/, "");
+  if (typeof process !== "undefined") {
+    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_URL ?? process.env.VITE_SMART_GLIDE_URL ?? process.env.SMART_GLIDE_URL ?? "";
+    if (env) return env.replace(/\/$/, "");
+  }
+  return "";
+}
+function resolveDataPath(dataPath) {
+  if (dataPath) return "/" + dataPath.replace(/^\/|\/$/g, "");
+  if (typeof process !== "undefined") {
+    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DATA_PATH ?? "/img-data";
+    return "/" + env.replace(/^\/|\/$/g, "");
+  }
+  return "/img-data";
+}
+function buildDataUrl(path, options) {
+  const base = resolveBaseUrl(options.baseUrl);
+  const prefix = resolveDataPath(options.dataPath);
+  const cleanPath = path.replace(/^\//, "");
+  const params = {};
+  if (options.profile) params.profile = options.profile;
+  if (options.blurPlaceholder) params.blur_placeholder = "1";
+  if (options.schema) params.schema = "1";
+  if (options.responsive === false) {
+    params.responsive = "0";
+  } else if (Array.isArray(options.responsive)) {
+    params.responsive = options.responsive.join(",");
+  } else if (options.responsive) {
+    params.responsive = options.responsive;
+  }
+  if (options.params) {
+    Object.entries(options.params).forEach(([k, v]) => {
+      params[k] = String(v);
+    });
+  }
+  const query = new URLSearchParams(params).toString();
+  return `${base}${prefix}/${cleanPath}${query ? "?" + query : ""}`;
+}
+
+// src/server.ts
+async function fetchSmartGlideData(options) {
+  const url = buildDataUrl(options.path, options);
+  const response = await fetch(url, {
+    headers: {
+      Accept: "application/json",
+      // Forward server-side env Accept header for AVIF negotiation
+      "X-Smart-Glide-Client": "react-sdk"
+    },
+    ...options.fetchOptions ?? {}
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Smart Glide API error: ${response.status} ${response.statusText} \u2014 ${url}`
+    );
+  }
+  return response.json();
+}
+async function fetchSmartGlideMany(items, shared) {
+  return Promise.all(
+    items.map((item) => fetchSmartGlideData({ ...shared, ...item }))
+  );
+}
+async function buildPreloadHeader(path, options) {
+  const data = await fetchSmartGlideData({ ...options, path });
+  const parts = [`<${data.src}>; rel=preload; as=image`];
+  if (data.srcset) {
+    parts.push(`imagesrcset="${data.srcset}"`);
+  }
+  if (data.sizes) {
+    parts.push(`imagesizes="${data.sizes}"`);
+  }
+  return parts.join("; ");
+}
+
+exports.buildPreloadHeader = buildPreloadHeader;
+exports.fetchSmartGlideData = fetchSmartGlideData;
+exports.fetchSmartGlideMany = fetchSmartGlideMany;
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/url-builder.ts","../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — URL Builder\n// Builds Smart Glide delivery URLs client-side (no API call needed).\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { ImageProfile, ResponsivePreset, SmartGlideOptions } from './types';\n\n/** Resolve the base URL from options or environment variables. */\nexport function resolveBaseUrl(baseUrl?: string): string {\n  if (baseUrl) return baseUrl.replace(/\\/$/, '');\n\n  // Next.js public env\n  if (typeof process !== 'undefined') {\n    const env =\n      process.env.NEXT_PUBLIC_SMART_GLIDE_URL ??\n      process.env.VITE_SMART_GLIDE_URL ??\n      process.env.SMART_GLIDE_URL ??\n      '';\n    if (env) return env.replace(/\\/$/, '');\n  }\n\n  return '';\n}\n\n/** Resolve the delivery path prefix (default: `/img`). */\nexport function resolveDeliveryPath(deliveryPath?: string): string {\n  if (deliveryPath) return '/' + deliveryPath.replace(/^\\/|\\/$/g, '');\n\n  if (typeof process !== 'undefined') {\n    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DELIVERY_PATH ?? '/img';\n    return '/' + env.replace(/^\\/|\\/$/g, '');\n  }\n\n  return '/img';\n}\n\n/** Resolve the data API path prefix (default: `/img-data`). */\nexport function resolveDataPath(dataPath?: string): string {\n  if (dataPath) return '/' + dataPath.replace(/^\\/|\\/$/g, '');\n\n  if (typeof process !== 'undefined') {\n    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DATA_PATH ?? '/img-data';\n    return '/' + env.replace(/^\\/|\\/$/g, '');\n  }\n\n  return '/img-data';\n}\n\n/** Build a single Smart Glide delivery URL (unsigned — for preview/dev). */\nexport function buildDeliveryUrl(\n  path: string,\n  params: Record<string, string | number> = {},\n  options: { baseUrl?: string; deliveryPath?: string } = {}\n): string {\n  const base = resolveBaseUrl(options.baseUrl);\n  const prefix = resolveDeliveryPath(options.deliveryPath);\n  const cleanPath = path.replace(/^\\//, '');\n\n  const queryParams = Object.entries(params)\n    .filter(([, v]) => v !== undefined && v !== '')\n    .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n    .join('&');\n\n  return `${base}${prefix}/${cleanPath}${queryParams ? '?' + queryParams : ''}`;\n}\n\n/** Build the JSON data API URL for a given path. */\nexport function buildDataUrl(\n  path: string,\n  options: SmartGlideOptions & { deliveryPath?: string; dataPath?: string }\n): string {\n  const base = resolveBaseUrl(options.baseUrl);\n  const prefix = resolveDataPath(options.dataPath);\n  const cleanPath = path.replace(/^\\//, '');\n\n  const params: Record<string, string> = {};\n\n  if (options.profile) params.profile = options.profile;\n  if (options.blurPlaceholder) params.blur_placeholder = '1';\n  if (options.schema) params.schema = '1';\n\n  // Responsive\n  if (options.responsive === false) {\n    params.responsive = '0';\n  } else if (Array.isArray(options.responsive)) {\n    params.responsive = options.responsive.join(',');\n  } else if (options.responsive) {\n    params.responsive = options.responsive;\n  }\n\n  // Extra Glide params\n  if (options.params) {\n    Object.entries(options.params).forEach(([k, v]) => {\n      params[k] = String(v);\n    });\n  }\n\n  const query = new URLSearchParams(params).toString();\n  return `${base}${prefix}/${cleanPath}${query ? '?' + query : ''}`;\n}\n\n/** Resolve a named or custom responsive set to an array of widths. */\nconst NAMED_SETS: Record<string, number[]> = {\n  hero:       [640, 960, 1280, 1600, 1920],\n  thumbnails: [240, 320, 480],\n  square:     [320, 480, 640],\n  portrait:   [480, 768, 1024],\n  hd:         [960, 1280, 1600],\n  fhd:        [1280, 1600, 1920, 2560],\n  retina:     [640, 960, 1280, 1920, 2560],\n};\n\nexport function resolveWidths(\n  responsive?: string | number[] | false | null\n): number[] {\n  if (responsive === false) return [];\n\n  if (responsive === null || responsive === undefined) {\n    return NAMED_SETS.retina; // sensible default\n  }\n\n  if (Array.isArray(responsive)) return responsive;\n\n  return NAMED_SETS[responsive] ?? NAMED_SETS.retina;\n}\n\n/**\n * Build srcset and sizes strings entirely client-side\n * (no API call — for use with Next.js custom loader or static generation).\n */\nexport function buildSrcSet(\n  path: string,\n  params: Record<string, string | number> = {},\n  widths: number[] = NAMED_SETS.retina,\n  options: { baseUrl?: string; deliveryPath?: string } = {}\n): { srcset: string; sizes: string } {\n  const entries = widths.map((w) =>\n    `${buildDeliveryUrl(path, { ...params, w }, options)} ${w}w`\n  );\n\n  const sizes = widths\n    .map((w) => `(max-width: ${w}px) 100vw`)\n    .concat('100vw')\n    .join(', ');\n\n  return {\n    srcset: entries.join(', '),\n    sizes,\n  };\n}\n","// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — Server utilities (Next.js App Router / RSC)\n// These functions run on the server — do NOT import in client components.\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { SmartGlideData, SmartGlideOptions } from './types';\nimport { buildDataUrl } from './url-builder';\n\n/**\n * Fetch Smart Glide image data on the server.\n * Use this inside Next.js Server Components or `generateStaticParams`.\n *\n * Supports Next.js ISR via `fetchOptions.next.revalidate`.\n *\n * @example\n * // app/products/[id]/page.tsx  (Server Component)\n * import { fetchSmartGlideData } from 'smart-glide-react/server';\n *\n * export default async function ProductPage({ params }) {\n *   const image = await fetchSmartGlideData({\n *     path: `products/${params.id}.jpg`,\n *     profile: 'hero',\n *     responsive: 'retina',\n *     blurPlaceholder: true,\n *     schema: true,\n *     baseUrl: process.env.SMART_GLIDE_URL, // server-side env (no NEXT_PUBLIC_ prefix)\n *     fetchOptions: { next: { revalidate: 3600 } }, // ISR: revalidate every hour\n *   });\n *\n *   return (\n *     <img\n *       src={image.src}\n *       srcSet={image.srcset ?? undefined}\n *       sizes={image.sizes ?? undefined}\n *       alt=\"Product\"\n *       {...(image.blurDataUrl\n *         ? { style: { backgroundImage: `url(${image.blurDataUrl})` } }\n *         : {})}\n *     />\n *   );\n * }\n */\nexport async function fetchSmartGlideData(\n  options: SmartGlideOptions\n): Promise<SmartGlideData> {\n  const url = buildDataUrl(options.path, options);\n\n  const response = await fetch(url, {\n    headers: {\n      Accept: 'application/json',\n      // Forward server-side env Accept header for AVIF negotiation\n      'X-Smart-Glide-Client': 'react-sdk',\n    },\n    ...(options.fetchOptions ?? {}),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `Smart Glide API error: ${response.status} ${response.statusText} — ${url}`\n    );\n  }\n\n  return response.json() as Promise<SmartGlideData>;\n}\n\n/**\n * Fetch multiple images in parallel — useful for generating static params\n * or pre-loading image data for a collection of items.\n *\n * @example\n * const [hero, thumbnail, avatar] = await fetchSmartGlideMany([\n *   { path: 'home/hero.jpg',    profile: 'hero',      responsive: 'fhd' },\n *   { path: 'home/thumb.jpg',   profile: 'thumbnail', responsive: 'thumbnails' },\n *   { path: 'avatars/user.jpg', profile: 'profile_photo' },\n * ], { baseUrl: process.env.SMART_GLIDE_URL });\n */\nexport async function fetchSmartGlideMany(\n  items: Omit<SmartGlideOptions, 'baseUrl'>[],\n  shared: Pick<SmartGlideOptions, 'baseUrl' | 'fetchOptions'>\n): Promise<SmartGlideData[]> {\n  return Promise.all(\n    items.map((item) => fetchSmartGlideData({ ...shared, ...item }))\n  );\n}\n\n/**\n * Fetch Smart Glide data and return a preload `<link>` hint header value.\n * Use with `headers()` in Next.js route handlers or middleware.\n *\n * @example\n * // app/api/page-data/route.ts\n * import { headers } from 'next/headers';\n * import { buildPreloadHeader } from 'smart-glide-react/server';\n *\n * export async function GET() {\n *   const preload = await buildPreloadHeader('home/hero.jpg', {\n *     baseUrl: process.env.SMART_GLIDE_URL,\n *     profile: 'hero',\n *   });\n *   return new Response(null, { headers: { Link: preload } });\n * }\n */\nexport async function buildPreloadHeader(\n  path: string,\n  options: SmartGlideOptions\n): Promise<string> {\n  const data = await fetchSmartGlideData({ ...options, path });\n  const parts = [`<${data.src}>; rel=preload; as=image`];\n\n  if (data.srcset) {\n    parts.push(`imagesrcset=\"${data.srcset}\"`);\n  }\n\n  if (data.sizes) {\n    parts.push(`imagesizes=\"${data.sizes}\"`);\n  }\n\n  return parts.join('; ');\n}\n"]}

package/dist/server.mjs

@@ -0,0 +1,79 @@
+// src/url-builder.ts
+function resolveBaseUrl(baseUrl) {
+  if (baseUrl) return baseUrl.replace(/\/$/, "");
+  if (typeof process !== "undefined") {
+    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_URL ?? process.env.VITE_SMART_GLIDE_URL ?? process.env.SMART_GLIDE_URL ?? "";
+    if (env) return env.replace(/\/$/, "");
+  }
+  return "";
+}
+function resolveDataPath(dataPath) {
+  if (dataPath) return "/" + dataPath.replace(/^\/|\/$/g, "");
+  if (typeof process !== "undefined") {
+    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DATA_PATH ?? "/img-data";
+    return "/" + env.replace(/^\/|\/$/g, "");
+  }
+  return "/img-data";
+}
+function buildDataUrl(path, options) {
+  const base = resolveBaseUrl(options.baseUrl);
+  const prefix = resolveDataPath(options.dataPath);
+  const cleanPath = path.replace(/^\//, "");
+  const params = {};
+  if (options.profile) params.profile = options.profile;
+  if (options.blurPlaceholder) params.blur_placeholder = "1";
+  if (options.schema) params.schema = "1";
+  if (options.responsive === false) {
+    params.responsive = "0";
+  } else if (Array.isArray(options.responsive)) {
+    params.responsive = options.responsive.join(",");
+  } else if (options.responsive) {
+    params.responsive = options.responsive;
+  }
+  if (options.params) {
+    Object.entries(options.params).forEach(([k, v]) => {
+      params[k] = String(v);
+    });
+  }
+  const query = new URLSearchParams(params).toString();
+  return `${base}${prefix}/${cleanPath}${query ? "?" + query : ""}`;
+}
+
+// src/server.ts
+async function fetchSmartGlideData(options) {
+  const url = buildDataUrl(options.path, options);
+  const response = await fetch(url, {
+    headers: {
+      Accept: "application/json",
+      // Forward server-side env Accept header for AVIF negotiation
+      "X-Smart-Glide-Client": "react-sdk"
+    },
+    ...options.fetchOptions ?? {}
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Smart Glide API error: ${response.status} ${response.statusText} \u2014 ${url}`
+    );
+  }
+  return response.json();
+}
+async function fetchSmartGlideMany(items, shared) {
+  return Promise.all(
+    items.map((item) => fetchSmartGlideData({ ...shared, ...item }))
+  );
+}
+async function buildPreloadHeader(path, options) {
+  const data = await fetchSmartGlideData({ ...options, path });
+  const parts = [`<${data.src}>; rel=preload; as=image`];
+  if (data.srcset) {
+    parts.push(`imagesrcset="${data.srcset}"`);
+  }
+  if (data.sizes) {
+    parts.push(`imagesizes="${data.sizes}"`);
+  }
+  return parts.join("; ");
+}
+
+export { buildPreloadHeader, fetchSmartGlideData, fetchSmartGlideMany };
+//# sourceMappingURL=server.mjs.map
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/url-builder.ts","../src/server.ts"],"names":[],"mappings":"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","file":"server.mjs","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — URL Builder\n// Builds Smart Glide delivery URLs client-side (no API call needed).\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { ImageProfile, ResponsivePreset, SmartGlideOptions } from './types';\n\n/** Resolve the base URL from options or environment variables. */\nexport function resolveBaseUrl(baseUrl?: string): string {\n  if (baseUrl) return baseUrl.replace(/\\/$/, '');\n\n  // Next.js public env\n  if (typeof process !== 'undefined') {\n    const env =\n      process.env.NEXT_PUBLIC_SMART_GLIDE_URL ??\n      process.env.VITE_SMART_GLIDE_URL ??\n      process.env.SMART_GLIDE_URL ??\n      '';\n    if (env) return env.replace(/\\/$/, '');\n  }\n\n  return '';\n}\n\n/** Resolve the delivery path prefix (default: `/img`). */\nexport function resolveDeliveryPath(deliveryPath?: string): string {\n  if (deliveryPath) return '/' + deliveryPath.replace(/^\\/|\\/$/g, '');\n\n  if (typeof process !== 'undefined') {\n    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DELIVERY_PATH ?? '/img';\n    return '/' + env.replace(/^\\/|\\/$/g, '');\n  }\n\n  return '/img';\n}\n\n/** Resolve the data API path prefix (default: `/img-data`). */\nexport function resolveDataPath(dataPath?: string): string {\n  if (dataPath) return '/' + dataPath.replace(/^\\/|\\/$/g, '');\n\n  if (typeof process !== 'undefined') {\n    const env = process.env.NEXT_PUBLIC_SMART_GLIDE_DATA_PATH ?? '/img-data';\n    return '/' + env.replace(/^\\/|\\/$/g, '');\n  }\n\n  return '/img-data';\n}\n\n/** Build a single Smart Glide delivery URL (unsigned — for preview/dev). */\nexport function buildDeliveryUrl(\n  path: string,\n  params: Record<string, string | number> = {},\n  options: { baseUrl?: string; deliveryPath?: string } = {}\n): string {\n  const base = resolveBaseUrl(options.baseUrl);\n  const prefix = resolveDeliveryPath(options.deliveryPath);\n  const cleanPath = path.replace(/^\\//, '');\n\n  const queryParams = Object.entries(params)\n    .filter(([, v]) => v !== undefined && v !== '')\n    .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n    .join('&');\n\n  return `${base}${prefix}/${cleanPath}${queryParams ? '?' + queryParams : ''}`;\n}\n\n/** Build the JSON data API URL for a given path. */\nexport function buildDataUrl(\n  path: string,\n  options: SmartGlideOptions & { deliveryPath?: string; dataPath?: string }\n): string {\n  const base = resolveBaseUrl(options.baseUrl);\n  const prefix = resolveDataPath(options.dataPath);\n  const cleanPath = path.replace(/^\\//, '');\n\n  const params: Record<string, string> = {};\n\n  if (options.profile) params.profile = options.profile;\n  if (options.blurPlaceholder) params.blur_placeholder = '1';\n  if (options.schema) params.schema = '1';\n\n  // Responsive\n  if (options.responsive === false) {\n    params.responsive = '0';\n  } else if (Array.isArray(options.responsive)) {\n    params.responsive = options.responsive.join(',');\n  } else if (options.responsive) {\n    params.responsive = options.responsive;\n  }\n\n  // Extra Glide params\n  if (options.params) {\n    Object.entries(options.params).forEach(([k, v]) => {\n      params[k] = String(v);\n    });\n  }\n\n  const query = new URLSearchParams(params).toString();\n  return `${base}${prefix}/${cleanPath}${query ? '?' + query : ''}`;\n}\n\n/** Resolve a named or custom responsive set to an array of widths. */\nconst NAMED_SETS: Record<string, number[]> = {\n  hero:       [640, 960, 1280, 1600, 1920],\n  thumbnails: [240, 320, 480],\n  square:     [320, 480, 640],\n  portrait:   [480, 768, 1024],\n  hd:         [960, 1280, 1600],\n  fhd:        [1280, 1600, 1920, 2560],\n  retina:     [640, 960, 1280, 1920, 2560],\n};\n\nexport function resolveWidths(\n  responsive?: string | number[] | false | null\n): number[] {\n  if (responsive === false) return [];\n\n  if (responsive === null || responsive === undefined) {\n    return NAMED_SETS.retina; // sensible default\n  }\n\n  if (Array.isArray(responsive)) return responsive;\n\n  return NAMED_SETS[responsive] ?? NAMED_SETS.retina;\n}\n\n/**\n * Build srcset and sizes strings entirely client-side\n * (no API call — for use with Next.js custom loader or static generation).\n */\nexport function buildSrcSet(\n  path: string,\n  params: Record<string, string | number> = {},\n  widths: number[] = NAMED_SETS.retina,\n  options: { baseUrl?: string; deliveryPath?: string } = {}\n): { srcset: string; sizes: string } {\n  const entries = widths.map((w) =>\n    `${buildDeliveryUrl(path, { ...params, w }, options)} ${w}w`\n  );\n\n  const sizes = widths\n    .map((w) => `(max-width: ${w}px) 100vw`)\n    .concat('100vw')\n    .join(', ');\n\n  return {\n    srcset: entries.join(', '),\n    sizes,\n  };\n}\n","// ─────────────────────────────────────────────────────────────────────────────\n// smart-glide-react — Server utilities (Next.js App Router / RSC)\n// These functions run on the server — do NOT import in client components.\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { SmartGlideData, SmartGlideOptions } from './types';\nimport { buildDataUrl } from './url-builder';\n\n/**\n * Fetch Smart Glide image data on the server.\n * Use this inside Next.js Server Components or `generateStaticParams`.\n *\n * Supports Next.js ISR via `fetchOptions.next.revalidate`.\n *\n * @example\n * // app/products/[id]/page.tsx  (Server Component)\n * import { fetchSmartGlideData } from 'smart-glide-react/server';\n *\n * export default async function ProductPage({ params }) {\n *   const image = await fetchSmartGlideData({\n *     path: `products/${params.id}.jpg`,\n *     profile: 'hero',\n *     responsive: 'retina',\n *     blurPlaceholder: true,\n *     schema: true,\n *     baseUrl: process.env.SMART_GLIDE_URL, // server-side env (no NEXT_PUBLIC_ prefix)\n *     fetchOptions: { next: { revalidate: 3600 } }, // ISR: revalidate every hour\n *   });\n *\n *   return (\n *     <img\n *       src={image.src}\n *       srcSet={image.srcset ?? undefined}\n *       sizes={image.sizes ?? undefined}\n *       alt=\"Product\"\n *       {...(image.blurDataUrl\n *         ? { style: { backgroundImage: `url(${image.blurDataUrl})` } }\n *         : {})}\n *     />\n *   );\n * }\n */\nexport async function fetchSmartGlideData(\n  options: SmartGlideOptions\n): Promise<SmartGlideData> {\n  const url = buildDataUrl(options.path, options);\n\n  const response = await fetch(url, {\n    headers: {\n      Accept: 'application/json',\n      // Forward server-side env Accept header for AVIF negotiation\n      'X-Smart-Glide-Client': 'react-sdk',\n    },\n    ...(options.fetchOptions ?? {}),\n  });\n\n  if (!response.ok) {\n    throw new Error(\n      `Smart Glide API error: ${response.status} ${response.statusText} — ${url}`\n    );\n  }\n\n  return response.json() as Promise<SmartGlideData>;\n}\n\n/**\n * Fetch multiple images in parallel — useful for generating static params\n * or pre-loading image data for a collection of items.\n *\n * @example\n * const [hero, thumbnail, avatar] = await fetchSmartGlideMany([\n *   { path: 'home/hero.jpg',    profile: 'hero',      responsive: 'fhd' },\n *   { path: 'home/thumb.jpg',   profile: 'thumbnail', responsive: 'thumbnails' },\n *   { path: 'avatars/user.jpg', profile: 'profile_photo' },\n * ], { baseUrl: process.env.SMART_GLIDE_URL });\n */\nexport async function fetchSmartGlideMany(\n  items: Omit<SmartGlideOptions, 'baseUrl'>[],\n  shared: Pick<SmartGlideOptions, 'baseUrl' | 'fetchOptions'>\n): Promise<SmartGlideData[]> {\n  return Promise.all(\n    items.map((item) => fetchSmartGlideData({ ...shared, ...item }))\n  );\n}\n\n/**\n * Fetch Smart Glide data and return a preload `<link>` hint header value.\n * Use with `headers()` in Next.js route handlers or middleware.\n *\n * @example\n * // app/api/page-data/route.ts\n * import { headers } from 'next/headers';\n * import { buildPreloadHeader } from 'smart-glide-react/server';\n *\n * export async function GET() {\n *   const preload = await buildPreloadHeader('home/hero.jpg', {\n *     baseUrl: process.env.SMART_GLIDE_URL,\n *     profile: 'hero',\n *   });\n *   return new Response(null, { headers: { Link: preload } });\n * }\n */\nexport async function buildPreloadHeader(\n  path: string,\n  options: SmartGlideOptions\n): Promise<string> {\n  const data = await fetchSmartGlideData({ ...options, path });\n  const parts = [`<${data.src}>; rel=preload; as=image`];\n\n  if (data.srcset) {\n    parts.push(`imagesrcset=\"${data.srcset}\"`);\n  }\n\n  if (data.sizes) {\n    parts.push(`imagesizes=\"${data.sizes}\"`);\n  }\n\n  return parts.join('; ');\n}\n"]}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "smart-glide-react",
+  "version": "1.0.0",
+  "description": "React & Next.js SDK for Laravel Smart Glide — responsive images, blur placeholders, JSON-LD schema, and AVIF/WebP auto-negotiation.",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./next": {
+      "import": "./dist/next.mjs",
+      "require": "./dist/next.cjs",
+      "types": "./dist/next.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.cjs",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "laravel",
+    "smart-glide",
+    "react",
+    "nextjs",
+    "next-image",
+    "image",
+    "responsive-images",
+    "srcset",
+    "webp",
+    "avif",
+    "blur-placeholder",
+    "lqip",
+    "seo",
+    "json-ld",
+    "image-optimization"
+  ],
+  "author": "Shadi Shammaa <shadi.shammaa@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/shammaa/smart-glide-react",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shammaa/smart-glide-react.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shammaa/smart-glide-react/issues"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}