@autorender/sdk-core 0.1.22 → 0.1.23

package/dist/index.d.cts

@@ -337,6 +337,7 @@ interface LayerEnhancementOptions {
     [key: string]: any;
 }
 interface ResponsiveOptions {
+    /** Workspace-relative asset path (e.g. `products/shoe.jpg`) or `https://...` / `http://...` for remote fetch via `fetch_` prefix. */
     src: string;
     width?: number;
     sizes?: string;
@@ -357,6 +358,18 @@ interface ARInstance {
     getConnectionQuality(): '2g' | '3g' | '4g' | 'wifi' | 'unknown';
 }
 
+/**
+ * URL builder for AutoRender image URLs
+ */
+
+/**
+ * Workspace path segment for `ar.url()` / ARImage `src`.
+ *
+ * - Relative paths (`products/shoe.jpg`): each path segment is encoded separately.
+ * - Absolute URLs (`https://demo.com/photo.jpg`): emitted as `fetch_<url>`.
+ */
+declare function encodeAssetPathForDelivery(src: string): string;
+
 /**
  * Main AutoRender client factory
  * Creates an AR instance with URL building and responsive image capabilities
@@ -387,4 +400,4 @@ declare function createUploader(options: CreateUploaderOptions): UploaderInstanc
 
 declare function registerAutorenderUploaderElement(): void;
 
-export { type ARInstance, type ApiFolderRequest, type AppRunnerResponse, type CompleteUploadPayload, type CompleteUploadResponse, type CreateARConfig, type CreateUploaderOptions, type Environment, type IconRenderer, type IconSet, type IngestErrorResponse, type IngestSuccessResponse, type LabelSet, type LayerEnhancementOptions, type LayerOptions, type Palette, type PresignPayload, type PresignResponse, type PresignedFile, type ResponsiveAttributes, type ResponsiveOptions, type ThemeOptions, type TransformOptions, type UploadItem, type UploadSettings, type UploadSourceOption, type UploadStatus, type UploadSuccessFile, type UploadedFileResponse, type UploaderClassNames, type UploaderInstance, createAR, createUploader, detectBestFormat, getBestFormatSync, registerAutorenderUploaderElement, resetFormatCache };
+export { type ARInstance, type ApiFolderRequest, type AppRunnerResponse, type CompleteUploadPayload, type CompleteUploadResponse, type CreateARConfig, type CreateUploaderOptions, type Environment, type IconRenderer, type IconSet, type IngestErrorResponse, type IngestSuccessResponse, type LabelSet, type LayerEnhancementOptions, type LayerOptions, type Palette, type PresignPayload, type PresignResponse, type PresignedFile, type ResponsiveAttributes, type ResponsiveOptions, type ThemeOptions, type TransformOptions, type UploadItem, type UploadSettings, type UploadSourceOption, type UploadStatus, type UploadSuccessFile, type UploadedFileResponse, type UploaderClassNames, type UploaderInstance, createAR, createUploader, detectBestFormat, encodeAssetPathForDelivery, getBestFormatSync, registerAutorenderUploaderElement, resetFormatCache };

package/dist/index.d.ts

@@ -337,6 +337,7 @@ interface LayerEnhancementOptions {
     [key: string]: any;
 }
 interface ResponsiveOptions {
+    /** Workspace-relative asset path (e.g. `products/shoe.jpg`) or `https://...` / `http://...` for remote fetch via `fetch_` prefix. */
     src: string;
     width?: number;
     sizes?: string;
@@ -357,6 +358,18 @@ interface ARInstance {
     getConnectionQuality(): '2g' | '3g' | '4g' | 'wifi' | 'unknown';
 }
 
+/**
+ * URL builder for AutoRender image URLs
+ */
+
+/**
+ * Workspace path segment for `ar.url()` / ARImage `src`.
+ *
+ * - Relative paths (`products/shoe.jpg`): each path segment is encoded separately.
+ * - Absolute URLs (`https://demo.com/photo.jpg`): emitted as `fetch_<url>`.
+ */
+declare function encodeAssetPathForDelivery(src: string): string;
+
 /**
  * Main AutoRender client factory
  * Creates an AR instance with URL building and responsive image capabilities
@@ -387,4 +400,4 @@ declare function createUploader(options: CreateUploaderOptions): UploaderInstanc
 
 declare function registerAutorenderUploaderElement(): void;
 
-export { type ARInstance, type ApiFolderRequest, type AppRunnerResponse, type CompleteUploadPayload, type CompleteUploadResponse, type CreateARConfig, type CreateUploaderOptions, type Environment, type IconRenderer, type IconSet, type IngestErrorResponse, type IngestSuccessResponse, type LabelSet, type LayerEnhancementOptions, type LayerOptions, type Palette, type PresignPayload, type PresignResponse, type PresignedFile, type ResponsiveAttributes, type ResponsiveOptions, type ThemeOptions, type TransformOptions, type UploadItem, type UploadSettings, type UploadSourceOption, type UploadStatus, type UploadSuccessFile, type UploadedFileResponse, type UploaderClassNames, type UploaderInstance, createAR, createUploader, detectBestFormat, getBestFormatSync, registerAutorenderUploaderElement, resetFormatCache };
+export { type ARInstance, type ApiFolderRequest, type AppRunnerResponse, type CompleteUploadPayload, type CompleteUploadResponse, type CreateARConfig, type CreateUploaderOptions, type Environment, type IconRenderer, type IconSet, type IngestErrorResponse, type IngestSuccessResponse, type LabelSet, type LayerEnhancementOptions, type LayerOptions, type Palette, type PresignPayload, type PresignResponse, type PresignedFile, type ResponsiveAttributes, type ResponsiveOptions, type ThemeOptions, type TransformOptions, type UploadItem, type UploadSettings, type UploadSourceOption, type UploadStatus, type UploadSuccessFile, type UploadedFileResponse, type UploaderClassNames, type UploaderInstance, createAR, createUploader, detectBestFormat, encodeAssetPathForDelivery, getBestFormatSync, registerAutorenderUploaderElement, resetFormatCache };

package/dist/index.js

@@ -3503,15 +3503,40 @@ function normalizePlacement(placement) {
 }
 
 // src/viewtag/url-builder.ts
+var ABSOLUTE_URL_RE = /^https?:\/\//i;
+function encodeAssetPathForDelivery(src) {
+  const trimmed = src.trim();
+  if (!trimmed) {
+    return "";
+  }
+  if (ABSOLUTE_URL_RE.test(trimmed)) {
+    const fetchPayload = `fetch_${trimmed}`;
+    return encodeURIComponent(fetchPayload);
+  }
+  if (trimmed.startsWith("fetch_")) {
+    return encodeURIComponent(trimmed);
+  }
+  return trimmed.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
 function buildImageUrl(baseUrl, workspace, src, transform, defaults, enableDPR = true, connectionQuality) {
   const normalizedBase = baseUrl.replace(/\/+$/, "");
   const transformStr = buildTransformString(transform || {}, defaults, enableDPR, connectionQuality);
-  const encodedPath = src.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+  const trimmedSrc = src.trim();
+  if (ABSOLUTE_URL_RE.test(trimmedSrc)) {
+    const fetchPart = `fetch_${trimmedSrc}`;
+    const transformWithFetch = transformStr ? `${transformStr},${fetchPart}` : fetchPart;
+    return `${normalizedBase}/${workspace}/${transformWithFetch}`;
+  }
+  if (trimmedSrc.startsWith("fetch_")) {
+    const fetchPart = trimmedSrc;
+    const transformWithFetch = transformStr ? `${transformStr},${fetchPart}` : fetchPart;
+    return `${normalizedBase}/${workspace}/${transformWithFetch}`;
+  }
+  const encodedPath = encodeAssetPathForDelivery(trimmedSrc);
   if (transformStr) {
     return `${normalizedBase}/${workspace}/${transformStr}/${encodedPath}`;
-  } else {
-    return `${normalizedBase}/${workspace}/${encodedPath}`;
   }
+  return `${normalizedBase}/${workspace}/${encodedPath}`;
 }
 
 // src/viewtag/responsive.ts
@@ -3893,6 +3918,7 @@ export {
   createAR,
   createUploader,
   detectBestFormat,
+  encodeAssetPathForDelivery,
   getBestFormatSync,
   registerAutorenderUploaderElement,
   resetFormatCache