jazz-tools 0.18.2 → 0.18.4

package/dist/index.js

@@ -37,7 +37,7 @@ import {
   randomSessionProvider,
   subscribeToCoValue,
   zodReExport_exports
-} from "./chunk-IERUTUXB.js";
+} from "./chunk-LHQQZH7I.js";
 
 // src/tools/auth/clerk/index.ts
 import {

package/dist/media/{chunk-KR2V6X2N.js → chunk-W3S526L3.js}

@@ -1,89 +1,5 @@
-// src/media/create-image.ts
-import {
-  ImageDefinition
-} from "jazz-tools";
-function createImageFactory(impl) {
-  return (source, options) => createImage(source, options, impl);
-}
-async function createImage(imageBlobOrFile, options, impl) {
-  const { width: originalWidth, height: originalHeight } = await impl.getImageSize(imageBlobOrFile);
-  const def = {
-    originalSize: [originalWidth, originalHeight],
-    progressive: false,
-    placeholderDataURL: void 0,
-    files: {}
-  };
-  if (options?.placeholder === "blur") {
-    def.placeholderDataURL = await impl.getPlaceholderBase64(imageBlobOrFile);
-  }
-  if (options?.maxSize === void 0) {
-    def.original = await impl.createFileStreamFromSource(
-      imageBlobOrFile,
-      options?.owner
-    );
-    def.files[`${originalWidth}x${originalHeight}`] = def.original;
-  } else if (options?.maxSize >= originalWidth && options?.maxSize >= originalHeight) {
-    def.original = await impl.createFileStreamFromSource(
-      imageBlobOrFile,
-      options?.owner
-    );
-    def.files[`${originalWidth}x${originalHeight}`] = def.original;
-  } else {
-    const { width, height } = getNewDimensions(
-      originalWidth,
-      originalHeight,
-      options.maxSize
-    );
-    const blob = await impl.resize(imageBlobOrFile, width, height);
-    def.originalSize = [width, height];
-    def.original = await impl.createFileStreamFromSource(blob, options?.owner);
-    def.files[`${width}x${height}`] = def.original;
-  }
-  const imageCoValue = ImageDefinition.create(
-    {
-      originalSize: def.originalSize,
-      progressive: def.progressive,
-      placeholderDataURL: def.placeholderDataURL,
-      original: def.original,
-      ...def.files
-    },
-    options?.owner
-  );
-  if (options?.progressive) {
-    imageCoValue.$jazz.set("progressive", true);
-    const resizes = [256, 1024, 2048].filter(
-      (s) => s < Math.max(imageCoValue.originalSize[0], imageCoValue.originalSize[1])
-    );
-    for (const size of resizes) {
-      const { width, height } = getNewDimensions(
-        originalWidth,
-        originalHeight,
-        size
-      );
-      const blob = await impl.resize(imageBlobOrFile, width, height);
-      imageCoValue.$jazz.set(
-        `${width}x${height}`,
-        await impl.createFileStreamFromSource(blob, options?.owner)
-      );
-    }
-  }
-  return imageCoValue;
-}
-var getNewDimensions = (originalWidth, originalHeight, maxSize) => {
-  if (originalWidth > originalHeight) {
-    return {
-      width: maxSize,
-      height: Math.round(maxSize * (originalHeight / originalWidth))
-    };
-  }
-  return {
-    width: Math.round(maxSize * (originalWidth / originalHeight)),
-    height: maxSize
-  };
-};
-
 // src/media/utils.ts
-import { Account as Account2, FileStream as FileStream2, ImageDefinition as ImageDefinition2 } from "jazz-tools";
+import { Account, FileStream, ImageDefinition } from "jazz-tools";
 function highestResAvailable(image, wantedWidth, wantedHeight) {
   const availableSizes = image.$jazz.raw.keys().filter((key) => /^\d+x\d+$/.test(key)).map((key) => {
     const [w, h] = key.split("x").map(Number);
@@ -139,11 +55,11 @@ function isLoaded(id) {
   if (!id) {
     return false;
   }
-  return !!Account2.getMe().$jazz.localNode.getLoaded(id);
+  return !!Account.getMe().$jazz.localNode.getLoaded(id);
 }
 async function loadImage(imageOrId) {
   if (typeof imageOrId === "string") {
-    const image = await ImageDefinition2.load(imageOrId, {
+    const image = await ImageDefinition.load(imageOrId, {
       resolve: {
         original: true
       }
@@ -161,7 +77,7 @@ async function loadImage(imageOrId) {
     console.warn("Unable to find the original image");
     return null;
   }
-  const loadedOriginal = await FileStream2.load(imageOrId.original.$jazz.id);
+  const loadedOriginal = await FileStream.load(imageOrId.original.$jazz.id);
   if (!loadedOriginal) {
     console.warn("Unable to find the original image");
     return null;
@@ -173,7 +89,7 @@ async function loadImage(imageOrId) {
   };
 }
 async function loadImageBySize(imageOrId, wantedWidth, wantedHeight) {
-  const image = typeof imageOrId === "string" ? await ImageDefinition2.load(imageOrId) : imageOrId;
+  const image = typeof imageOrId === "string" ? await ImageDefinition.load(imageOrId) : imageOrId;
   if (image === null) {
     return null;
   }
@@ -196,7 +112,7 @@ async function loadImageBySize(imageOrId, wantedWidth, wantedHeight) {
   if (!file) {
     return null;
   }
-  const loadedFile = await FileStream2.load(file.id);
+  const loadedFile = await FileStream.load(file.id);
   if (!loadedFile) {
     return null;
   }
@@ -207,10 +123,97 @@ async function loadImageBySize(imageOrId, wantedWidth, wantedHeight) {
   };
 }
 
+// src/media/create-image-factory.ts
+import {
+  ImageDefinition as ImageDefinition2
+} from "jazz-tools";
+function createImageFactory(impl, imageTypeGuard) {
+  return (source, options) => {
+    imageTypeGuard?.(source);
+    return createImage(source, options ?? {}, impl);
+  };
+}
+async function createImage(imageBlobOrFile, options, impl) {
+  const { width: originalWidth, height: originalHeight } = await impl.getImageSize(imageBlobOrFile);
+  const def = {
+    originalSize: [originalWidth, originalHeight],
+    progressive: false,
+    placeholderDataURL: void 0,
+    files: {}
+  };
+  if (options?.placeholder === "blur") {
+    def.placeholderDataURL = await impl.getPlaceholderBase64(imageBlobOrFile);
+  }
+  if (options?.maxSize === void 0) {
+    def.original = await impl.createFileStreamFromSource(
+      imageBlobOrFile,
+      options?.owner
+    );
+    def.files[`${originalWidth}x${originalHeight}`] = def.original;
+  } else if (options?.maxSize >= originalWidth && options?.maxSize >= originalHeight) {
+    def.original = await impl.createFileStreamFromSource(
+      imageBlobOrFile,
+      options?.owner
+    );
+    def.files[`${originalWidth}x${originalHeight}`] = def.original;
+  } else {
+    const { width, height } = getNewDimensions(
+      originalWidth,
+      originalHeight,
+      options.maxSize
+    );
+    const blob = await impl.resize(imageBlobOrFile, width, height);
+    def.originalSize = [width, height];
+    def.original = await impl.createFileStreamFromSource(blob, options?.owner);
+    def.files[`${width}x${height}`] = def.original;
+  }
+  const imageCoValue = ImageDefinition2.create(
+    {
+      originalSize: def.originalSize,
+      progressive: def.progressive,
+      placeholderDataURL: def.placeholderDataURL,
+      original: def.original,
+      ...def.files
+    },
+    options?.owner
+  );
+  if (options?.progressive) {
+    imageCoValue.$jazz.set("progressive", true);
+    const resizes = [256, 1024, 2048].filter(
+      (s) => s < Math.max(imageCoValue.originalSize[0], imageCoValue.originalSize[1])
+    );
+    for (const size of resizes) {
+      const { width, height } = getNewDimensions(
+        originalWidth,
+        originalHeight,
+        size
+      );
+      const blob = await impl.resize(imageBlobOrFile, width, height);
+      imageCoValue.$jazz.set(
+        `${width}x${height}`,
+        await impl.createFileStreamFromSource(blob, options?.owner)
+      );
+    }
+  }
+  return imageCoValue;
+}
+var getNewDimensions = (originalWidth, originalHeight, maxSize) => {
+  if (originalWidth > originalHeight) {
+    return {
+      width: maxSize,
+      height: Math.round(maxSize * (originalHeight / originalWidth))
+    };
+  }
+  return {
+    width: Math.round(maxSize * (originalWidth / originalHeight)),
+    height: maxSize
+  };
+};
+
 export {
-  createImageFactory,
   highestResAvailable,
   loadImage,
-  loadImageBySize
+  loadImageBySize,
+  createImageFactory
 };
-//# sourceMappingURL=chunk-KR2V6X2N.js.map
+//# sourceMappingURL=chunk-W3S526L3.js.map

package/dist/media/chunk-W3S526L3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/media/utils.ts","../../src/media/create-image-factory.ts"],"sourcesContent":["import type { CoID } from \"cojson\";\nimport { Account, FileStream, ImageDefinition } from \"jazz-tools\";\n\nexport function highestResAvailable(\n  image: ImageDefinition,\n  wantedWidth: number,\n  wantedHeight: number,\n): { width: number; height: number; image: FileStream } | null {\n  const availableSizes: [number, number, string][] = image.$jazz.raw\n    .keys()\n    .filter((key) => /^\\d+x\\d+$/.test(key))\n    .map((key) => {\n      const [w, h] = key.split(\"x\").map(Number) as [number, number];\n      return [w, h, key];\n    });\n\n  if (availableSizes.length === 0) {\n    return image.original\n      ? {\n          width: image.originalSize[0],\n          height: image.originalSize[1],\n          image: image.original,\n        }\n      : null;\n  }\n\n  const sortedSizes = availableSizes\n    .map((size) => {\n      return {\n        size,\n        match: sizesMatchWanted(size[0], size[1], wantedWidth, wantedHeight),\n        isLoaded: isLoaded(\n          image.$jazz.raw.get(size[2]) as CoID<any> | undefined,\n        ),\n      };\n    })\n    .sort((a, b) => a.match - b.match);\n\n  // We try to find the better already loaded image\n  // note: `toReversed` is not available in react-native.\n  const bestLoaded = [...sortedSizes]\n    .reverse()\n    .find((el) => el.isLoaded && image[el.size[2]]?.getChunks());\n\n  // if I can't find a good match, let's use the highest resolution\n  const bestTarget =\n    sortedSizes.find((el) => el.match > 0.95) || sortedSizes.at(-1);\n\n  // if the best target is already loaded, we are done\n  if (image[bestTarget!.size[2]]?.getChunks()) {\n    return image[bestTarget!.size[2]]\n      ? {\n          width: bestTarget!.size[0],\n          height: bestTarget!.size[1],\n          image: image[bestTarget!.size[2]]!,\n        }\n      : null;\n  }\n\n  // if the best already loaded is not the best target\n  // let's trigger the load of the best target\n  if (bestLoaded) {\n    image[bestTarget!.size[2]]?.getChunks();\n    return image[bestLoaded.size[2]]\n      ? {\n          width: bestLoaded.size[0],\n          height: bestLoaded.size[1],\n          image: image[bestLoaded.size[2]]!,\n        }\n      : null;\n  }\n\n  // if nothing is loaded, then start fetching all the images till the best\n  for (let size of sortedSizes) {\n    if (size.match <= bestTarget!.match) {\n      image[size.size[2]]?.getChunks();\n    }\n  }\n\n  return null;\n}\n\nfunction sizesMatchWanted(\n  w: number,\n  h: number,\n  wantedW: number,\n  wantedH: number,\n): number {\n  const area1 = w * h;\n  const area2 = wantedW * wantedH;\n\n  const areaRatio = area1 / area2;\n\n  // // Below 0.95 means the image is too small, we don't want to upscale it\n  // if (areaRatio < 0.95) {\n  //   return 9999;\n  // }\n\n  return areaRatio;\n}\n\nfunction isLoaded(id: CoID<any> | null | undefined): boolean {\n  if (!id) {\n    return false;\n  }\n\n  return !!Account.getMe().$jazz.localNode.getLoaded(id);\n}\n\nexport async function loadImage(\n  imageOrId: ImageDefinition | string,\n): Promise<{ width: number; height: number; image: FileStream } | null> {\n  if (typeof imageOrId === \"string\") {\n    const image = await ImageDefinition.load(imageOrId, {\n      resolve: {\n        original: true,\n      },\n    });\n\n    if (image === null || image.original === null) {\n      return null;\n    }\n\n    return {\n      width: image.originalSize[0],\n      height: image.originalSize[1],\n      image: image.original,\n    };\n  }\n\n  if (!imageOrId.original) {\n    console.warn(\"Unable to find the original image\");\n    return null;\n  }\n\n  const loadedOriginal = await FileStream.load(imageOrId.original.$jazz.id);\n\n  if (!loadedOriginal) {\n    console.warn(\"Unable to find the original image\");\n    return null;\n  }\n\n  return {\n    width: imageOrId.originalSize[0],\n    height: imageOrId.originalSize[1],\n    image: loadedOriginal,\n  };\n}\n\nexport async function loadImageBySize(\n  imageOrId: ImageDefinition | string,\n  wantedWidth: number,\n  wantedHeight: number,\n): Promise<{ width: number; height: number; image: FileStream } | null> {\n  // @ts-expect-error The resolved type for CoMap does not include catchall properties\n  const image: ImageDefinition | null =\n    typeof imageOrId === \"string\"\n      ? await ImageDefinition.load(imageOrId)\n      : imageOrId;\n\n  if (image === null) {\n    return null;\n  }\n\n  if (image.progressive === false) {\n    return loadImage(imageOrId);\n  }\n\n  const availableSizes: [number, number, string][] = image.$jazz.raw\n    .keys()\n    .filter((key) => /^\\d+x\\d+$/.test(key))\n    .map((key) => {\n      const [w, h] = key.split(\"x\").map(Number) as [number, number];\n      return [w, h, key];\n    });\n\n  if (availableSizes.length === 0) {\n    return null;\n  }\n\n  const sortedSizes = availableSizes\n    .map((size) => ({\n      size,\n      match: sizesMatchWanted(size[0], size[1], wantedWidth, wantedHeight),\n    }))\n    .sort((a, b) => a.match - b.match);\n\n  const bestTarget =\n    sortedSizes.find((el) => el.match > 0.95) || sortedSizes.at(-1)!;\n\n  // The image's `wxh` keys reference FileStream.\n  // image[bestTarget.size[2]] returns undefined if FileStream hasn't loaded yet.\n  // Since we only need the file's ID to fetch it later, we check the raw _refs\n  // which contain only the linked covalue's ID.\n  const file = image.$jazz.refs[bestTarget.size[2]];\n\n  if (!file) {\n    return null;\n  }\n\n  const loadedFile = await FileStream.load(file.id);\n\n  if (!loadedFile) {\n    return null;\n  }\n\n  return {\n    width: bestTarget.size[0],\n    height: bestTarget.size[1],\n    image: loadedFile,\n  };\n}\n","import {\n  Account,\n  FileStream,\n  Group,\n  ImageDefinition,\n  type Loaded,\n} from \"jazz-tools\";\n\nexport type SourceType = Blob | File | string;\n\nexport type ResizeOutput = Blob | string;\n\nexport type CreateImageOptions = {\n  /** The owner of the image. Can be either a Group or Account. If not specified, the current user will be the owner. */\n  owner?: Group | Account;\n  /**\n   * Controls placeholder generation for the image.\n   * - `\"blur\"`: Generates a blurred placeholder image (default)\n   * - `false`: No placeholder is generated\n   * @default \"blur\"\n   */\n  placeholder?: \"blur\" | false;\n  /**\n   * Maximum size constraint for the image. The image will be resized to fit within this size while maintaining aspect ratio.\n   * If the image is smaller than maxSize in both dimensions, no resizing occurs.\n   * @example 1024 // Resizes image to fit within 1024px in the largest dimension\n   */\n  maxSize?: number; // | [number, number];\n  /**\n   * The progressive loading pattern is a technique that allows images to load incrementally, starting with a small version and gradually replacing it with a larger version as it becomes available.\n   * This is useful for improving the user experience by showing a placeholder while the image is loading.\n   *\n   * Passing progressive: true to createImage() will create internal smaller versions of the image for future uses.\n   *\n   * @default false\n   */\n  progressive?: boolean;\n};\n\nexport type CreateImageImpl<\n  TSourceType = SourceType,\n  TResizeOutput = ResizeOutput,\n> = {\n  createFileStreamFromSource: (\n    imageBlobOrFile: TSourceType | TResizeOutput,\n    owner?: Group | Account,\n  ) => Promise<FileStream>;\n  getImageSize: (\n    imageBlobOrFile: TSourceType,\n  ) => Promise<{ width: number; height: number }>;\n  getPlaceholderBase64: (imageBlobOrFile: TSourceType) => Promise<string>;\n  resize: (\n    imageBlobOrFile: TSourceType,\n    width: number,\n    height: number,\n  ) => Promise<TResizeOutput>;\n};\n\nexport function createImageFactory<TSourceType, TResizeOutput>(\n  impl: CreateImageImpl<TSourceType, TResizeOutput>,\n  imageTypeGuard?: (imageBlobOrFile: TSourceType) => void,\n) {\n  return (source: TSourceType, options?: CreateImageOptions) => {\n    imageTypeGuard?.(source);\n    return createImage(source, options ?? {}, impl);\n  };\n}\n\nasync function createImage<TSourceType, TResizeOutput>(\n  imageBlobOrFile: TSourceType,\n  options: CreateImageOptions,\n  impl: CreateImageImpl<TSourceType, TResizeOutput>,\n): Promise<Loaded<typeof ImageDefinition, { $each: true }>> {\n  // Get the original size of the image\n  const { width: originalWidth, height: originalHeight } =\n    await impl.getImageSize(imageBlobOrFile);\n\n  const def: {\n    originalSize: [number, number];\n    progressive: boolean;\n    placeholderDataURL: string | undefined;\n    original?: FileStream;\n    files: Record<string, FileStream>;\n  } = {\n    originalSize: [originalWidth, originalHeight],\n    progressive: false,\n    placeholderDataURL: undefined,\n    files: {},\n  };\n\n  // Placeholder\n  if (options?.placeholder === \"blur\") {\n    def.placeholderDataURL = await impl.getPlaceholderBase64(imageBlobOrFile);\n  }\n\n  /**\n   * Original\n   *\n   * Save the original image.\n   * If the maxSize is set, resize the image to the maxSize if needed\n   */\n  if (options?.maxSize === undefined) {\n    def.original = await impl.createFileStreamFromSource(\n      imageBlobOrFile,\n      options?.owner,\n    );\n    def.files[`${originalWidth}x${originalHeight}`] = def.original;\n  } else if (\n    options?.maxSize >= originalWidth &&\n    options?.maxSize >= originalHeight\n  ) {\n    // no resizes required, just return the original image\n    def.original = await impl.createFileStreamFromSource(\n      imageBlobOrFile,\n      options?.owner,\n    );\n    def.files[`${originalWidth}x${originalHeight}`] = def.original;\n  } else {\n    const { width, height } = getNewDimensions(\n      originalWidth,\n      originalHeight,\n      options.maxSize,\n    );\n\n    const blob = await impl.resize(imageBlobOrFile, width, height);\n    def.originalSize = [width, height];\n    def.original = await impl.createFileStreamFromSource(blob, options?.owner);\n    def.files[`${width}x${height}`] = def.original;\n  }\n\n  const imageCoValue = ImageDefinition.create(\n    {\n      originalSize: def.originalSize,\n      progressive: def.progressive,\n      placeholderDataURL: def.placeholderDataURL,\n      original: def.original,\n      ...def.files,\n    },\n    options?.owner,\n  );\n\n  /**\n   * Progressive loading\n   *\n   * Save a set of resized images using three sizes: 256, 1024, 2048\n   *\n   * On the client side, the image will be loaded progressively, starting from the smallest size and increasing the size until the original size is reached.\n   */\n  if (options?.progressive) {\n    imageCoValue.$jazz.set(\"progressive\", true);\n\n    const resizes = ([256, 1024, 2048] as const).filter(\n      (s) =>\n        s <\n        Math.max(imageCoValue.originalSize[0], imageCoValue.originalSize[1]),\n    );\n\n    for (const size of resizes) {\n      const { width, height } = getNewDimensions(\n        originalWidth,\n        originalHeight,\n        size,\n      );\n\n      const blob = await impl.resize(imageBlobOrFile, width, height);\n      imageCoValue.$jazz.set(\n        `${width}x${height}`,\n        await impl.createFileStreamFromSource(blob, options?.owner),\n      );\n    }\n  }\n\n  return imageCoValue;\n}\n\nconst getNewDimensions = (\n  originalWidth: number,\n  originalHeight: number,\n  maxSize: number,\n) => {\n  if (originalWidth > originalHeight) {\n    return {\n      width: maxSize,\n      height: Math.round(maxSize * (originalHeight / originalWidth)),\n    };\n  }\n\n  return {\n    width: Math.round(maxSize * (originalWidth / originalHeight)),\n    height: maxSize,\n  };\n};\n"],"mappings":";AACA,SAAS,SAAS,YAAY,uBAAuB;AAE9C,SAAS,oBACd,OACA,aACA,cAC6D;AAC7D,QAAM,iBAA6C,MAAM,MAAM,IAC5D,KAAK,EACL,OAAO,CAAC,QAAQ,YAAY,KAAK,GAAG,CAAC,EACrC,IAAI,CAAC,QAAQ;AACZ,UAAM,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM;AACxC,WAAO,CAAC,GAAG,GAAG,GAAG;AAAA,EACnB,CAAC;AAEH,MAAI,eAAe,WAAW,GAAG;AAC/B,WAAO,MAAM,WACT;AAAA,MACE,OAAO,MAAM,aAAa,CAAC;AAAA,MAC3B,QAAQ,MAAM,aAAa,CAAC;AAAA,MAC5B,OAAO,MAAM;AAAA,IACf,IACA;AAAA,EACN;AAEA,QAAM,cAAc,eACjB,IAAI,CAAC,SAAS;AACb,WAAO;AAAA,MACL;AAAA,MACA,OAAO,iBAAiB,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,aAAa,YAAY;AAAA,MACnE,UAAU;AAAA,QACR,MAAM,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,CAAC,EACA,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAInC,QAAM,aAAa,CAAC,GAAG,WAAW,EAC/B,QAAQ,EACR,KAAK,CAAC,OAAO,GAAG,YAAY,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;AAG7D,QAAM,aACJ,YAAY,KAAK,CAAC,OAAO,GAAG,QAAQ,IAAI,KAAK,YAAY,GAAG,EAAE;AAGhE,MAAI,MAAM,WAAY,KAAK,CAAC,CAAC,GAAG,UAAU,GAAG;AAC3C,WAAO,MAAM,WAAY,KAAK,CAAC,CAAC,IAC5B;AAAA,MACE,OAAO,WAAY,KAAK,CAAC;AAAA,MACzB,QAAQ,WAAY,KAAK,CAAC;AAAA,MAC1B,OAAO,MAAM,WAAY,KAAK,CAAC,CAAC;AAAA,IAClC,IACA;AAAA,EACN;AAIA,MAAI,YAAY;AACd,UAAM,WAAY,KAAK,CAAC,CAAC,GAAG,UAAU;AACtC,WAAO,MAAM,WAAW,KAAK,CAAC,CAAC,IAC3B;AAAA,MACE,OAAO,WAAW,KAAK,CAAC;AAAA,MACxB,QAAQ,WAAW,KAAK,CAAC;AAAA,MACzB,OAAO,MAAM,WAAW,KAAK,CAAC,CAAC;AAAA,IACjC,IACA;AAAA,EACN;AAGA,WAAS,QAAQ,aAAa;AAC5B,QAAI,KAAK,SAAS,WAAY,OAAO;AACnC,YAAM,KAAK,KAAK,CAAC,CAAC,GAAG,UAAU;AAAA,IACjC;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,iBACP,GACA,GACA,SACA,SACQ;AACR,QAAM,QAAQ,IAAI;AAClB,QAAM,QAAQ,UAAU;AAExB,QAAM,YAAY,QAAQ;AAO1B,SAAO;AACT;AAEA,SAAS,SAAS,IAA2C;AAC3D,MAAI,CAAC,IAAI;AACP,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,CAAC,QAAQ,MAAM,EAAE,MAAM,UAAU,UAAU,EAAE;AACvD;AAEA,eAAsB,UACpB,WACsE;AACtE,MAAI,OAAO,cAAc,UAAU;AACjC,UAAM,QAAQ,MAAM,gBAAgB,KAAK,WAAW;AAAA,MAClD,SAAS;AAAA,QACP,UAAU;AAAA,MACZ;AAAA,IACF,CAAC;AAED,QAAI,UAAU,QAAQ,MAAM,aAAa,MAAM;AAC7C,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,OAAO,MAAM,aAAa,CAAC;AAAA,MAC3B,QAAQ,MAAM,aAAa,CAAC;AAAA,MAC5B,OAAO,MAAM;AAAA,IACf;AAAA,EACF;AAEA,MAAI,CAAC,UAAU,UAAU;AACvB,YAAQ,KAAK,mCAAmC;AAChD,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,MAAM,WAAW,KAAK,UAAU,SAAS,MAAM,EAAE;AAExE,MAAI,CAAC,gBAAgB;AACnB,YAAQ,KAAK,mCAAmC;AAChD,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,OAAO,UAAU,aAAa,CAAC;AAAA,IAC/B,QAAQ,UAAU,aAAa,CAAC;AAAA,IAChC,OAAO;AAAA,EACT;AACF;AAEA,eAAsB,gBACpB,WACA,aACA,cACsE;AAEtE,QAAM,QACJ,OAAO,cAAc,WACjB,MAAM,gBAAgB,KAAK,SAAS,IACpC;AAEN,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,gBAAgB,OAAO;AAC/B,WAAO,UAAU,SAAS;AAAA,EAC5B;AAEA,QAAM,iBAA6C,MAAM,MAAM,IAC5D,KAAK,EACL,OAAO,CAAC,QAAQ,YAAY,KAAK,GAAG,CAAC,EACrC,IAAI,CAAC,QAAQ;AACZ,UAAM,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM;AACxC,WAAO,CAAC,GAAG,GAAG,GAAG;AAAA,EACnB,CAAC;AAEH,MAAI,eAAe,WAAW,GAAG;AAC/B,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,eACjB,IAAI,CAAC,UAAU;AAAA,IACd;AAAA,IACA,OAAO,iBAAiB,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,aAAa,YAAY;AAAA,EACrE,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAEnC,QAAM,aACJ,YAAY,KAAK,CAAC,OAAO,GAAG,QAAQ,IAAI,KAAK,YAAY,GAAG,EAAE;AAMhE,QAAM,OAAO,MAAM,MAAM,KAAK,WAAW,KAAK,CAAC,CAAC;AAEhD,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,MAAM,WAAW,KAAK,KAAK,EAAE;AAEhD,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,OAAO,WAAW,KAAK,CAAC;AAAA,IACxB,QAAQ,WAAW,KAAK,CAAC;AAAA,IACzB,OAAO;AAAA,EACT;AACF;;;ACnNA;AAAA,EAIE,mBAAAA;AAAA,OAEK;AAoDA,SAAS,mBACd,MACA,gBACA;AACA,SAAO,CAAC,QAAqB,YAAiC;AAC5D,qBAAiB,MAAM;AACvB,WAAO,YAAY,QAAQ,WAAW,CAAC,GAAG,IAAI;AAAA,EAChD;AACF;AAEA,eAAe,YACb,iBACA,SACA,MAC0D;AAE1D,QAAM,EAAE,OAAO,eAAe,QAAQ,eAAe,IACnD,MAAM,KAAK,aAAa,eAAe;AAEzC,QAAM,MAMF;AAAA,IACF,cAAc,CAAC,eAAe,cAAc;AAAA,IAC5C,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,OAAO,CAAC;AAAA,EACV;AAGA,MAAI,SAAS,gBAAgB,QAAQ;AACnC,QAAI,qBAAqB,MAAM,KAAK,qBAAqB,eAAe;AAAA,EAC1E;AAQA,MAAI,SAAS,YAAY,QAAW;AAClC,QAAI,WAAW,MAAM,KAAK;AAAA,MACxB;AAAA,MACA,SAAS;AAAA,IACX;AACA,QAAI,MAAM,GAAG,aAAa,IAAI,cAAc,EAAE,IAAI,IAAI;AAAA,EACxD,WACE,SAAS,WAAW,iBACpB,SAAS,WAAW,gBACpB;AAEA,QAAI,WAAW,MAAM,KAAK;AAAA,MACxB;AAAA,MACA,SAAS;AAAA,IACX;AACA,QAAI,MAAM,GAAG,aAAa,IAAI,cAAc,EAAE,IAAI,IAAI;AAAA,EACxD,OAAO;AACL,UAAM,EAAE,OAAO,OAAO,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AAEA,UAAM,OAAO,MAAM,KAAK,OAAO,iBAAiB,OAAO,MAAM;AAC7D,QAAI,eAAe,CAAC,OAAO,MAAM;AACjC,QAAI,WAAW,MAAM,KAAK,2BAA2B,MAAM,SAAS,KAAK;AACzE,QAAI,MAAM,GAAG,KAAK,IAAI,MAAM,EAAE,IAAI,IAAI;AAAA,EACxC;AAEA,QAAM,eAAeA,iBAAgB;AAAA,IACnC;AAAA,MACE,cAAc,IAAI;AAAA,MAClB,aAAa,IAAI;AAAA,MACjB,oBAAoB,IAAI;AAAA,MACxB,UAAU,IAAI;AAAA,MACd,GAAG,IAAI;AAAA,IACT;AAAA,IACA,SAAS;AAAA,EACX;AASA,MAAI,SAAS,aAAa;AACxB,iBAAa,MAAM,IAAI,eAAe,IAAI;AAE1C,UAAM,UAAW,CAAC,KAAK,MAAM,IAAI,EAAY;AAAA,MAC3C,CAAC,MACC,IACA,KAAK,IAAI,aAAa,aAAa,CAAC,GAAG,aAAa,aAAa,CAAC,CAAC;AAAA,IACvE;AAEA,eAAW,QAAQ,SAAS;AAC1B,YAAM,EAAE,OAAO,OAAO,IAAI;AAAA,QACxB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,YAAM,OAAO,MAAM,KAAK,OAAO,iBAAiB,OAAO,MAAM;AAC7D,mBAAa,MAAM;AAAA,QACjB,GAAG,KAAK,IAAI,MAAM;AAAA,QAClB,MAAM,KAAK,2BAA2B,MAAM,SAAS,KAAK;AAAA,MAC5D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,IAAM,mBAAmB,CACvB,eACA,gBACA,YACG;AACH,MAAI,gBAAgB,gBAAgB;AAClC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,QAAQ,KAAK,MAAM,WAAW,iBAAiB,cAAc;AAAA,IAC/D;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,KAAK,MAAM,WAAW,gBAAgB,eAAe;AAAA,IAC5D,QAAQ;AAAA,EACV;AACF;","names":["ImageDefinition"]}

package/dist/media/create-image/browser.d.ts

@@ -0,0 +1,43 @@
+import { FileStream } from "jazz-tools";
+/**
+ * Creates an ImageDefinition from an image File or Blob with built-in UX features.
+ *
+ * This function creates a specialized CoValue for managing images in Jazz applications.
+ * It supports blurry placeholders, built-in resizing, and progressive loading patterns.
+ *
+ * @returns Promise that resolves to an ImageDefinition
+ *
+ * @example
+ * ```ts
+ * import { createImage } from "jazz-tools/media";
+ *
+ * // Create an image from a file input
+ * async function handleFileUpload(event: React.ChangeEvent<HTMLInputElement>) {
+ *   const file = event.target.files?.[0];
+ *   if (file) {
+ *     // Creates ImageDefinition with a blurry placeholder, limited to 1024px
+ *     // on the longest side, and multiple resolutions automatically
+ *     const image = await createImage(file, {
+ *       owner: me._owner,
+ *       maxSize: 1024,
+ *       placeholder: "blur",
+ *       progressive: true,
+ *     });
+ *
+ *     // Store the image in your application data
+ *     me.profile.image = image;
+ *   }
+ * }
+ * ```
+ */
+export declare const createImage: (source: Blob | File, options?: import("../create-image-factory").CreateImageOptions) => Promise<{
+    readonly [key: string]: FileStream;
+} & {
+    readonly original: FileStream | null;
+    readonly originalSize: [number, number];
+    readonly placeholderDataURL: string | undefined;
+    readonly progressive: boolean;
+} & {
+    readonly [key: string]: FileStream | null;
+} & import("jazz-tools").CoMap>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/media/create-image/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/media/create-image/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAS,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,WAAW;;;;;;;;;+BAYvB,CAAC"}

package/dist/media/create-image/react-native.d.ts

@@ -0,0 +1,37 @@
+import type { Account, Group } from "jazz-tools";
+import { FileStream } from "jazz-tools";
+/**
+ * Creates an ImageDefinition from an image file path with built-in UX features.
+ *
+ * This function creates a specialized CoValue for managing images in Jazz applications.
+ * It supports blurry placeholders, built-in resizing, and progressive loading patterns.
+ *
+ * @returns Promise that resolves to an ImageDefinition
+ *
+ * @example
+ * ```ts
+ * import { createImage } from "jazz-tools/media";
+ *
+ * async function uploadImageFromCamera(imagePath: string) {
+ *   const image = await createImage(imagePath, {
+ *     maxSize: 800,
+ *     placeholder: "blur",
+ *     progressive: false,
+ *   });
+ *
+ *   return image;
+ * }
+ * ```
+ */
+export declare const createImage: (source: string, options?: import("../create-image-factory").CreateImageOptions) => Promise<{
+    readonly [key: string]: FileStream;
+} & {
+    readonly original: FileStream | null;
+    readonly originalSize: [number, number];
+    readonly placeholderDataURL: string | undefined;
+    readonly progressive: boolean;
+} & {
+    readonly [key: string]: FileStream | null;
+} & import("jazz-tools").CoMap>;
+export declare function createFileStreamFromSource(filePath: string, owner?: Account | Group): Promise<FileStream>;
+//# sourceMappingURL=react-native.d.ts.map

package/dist/media/create-image/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../../src/media/create-image/react-native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;+BAcvB,CAAC;AAwEF,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GACtB,OAAO,CAAC,UAAU,CAAC,CAOrB"}

package/dist/media/create-image/server.d.ts

@@ -0,0 +1,34 @@
+import { FileStream } from "jazz-tools";
+export type SharpImageType = File | Blob | Buffer | ArrayBuffer | Uint8Array | Uint8ClampedArray | Int8Array | Uint16Array | Int16Array | Uint32Array | Int32Array | Float32Array | Float64Array;
+/**
+ * Creates an ImageDefinition from an image File, Blob or Buffer with built-in UX features.
+ *
+ * This function creates a specialized CoValue for managing images in Jazz applications.
+ * It supports blurry placeholders, built-in resizing, and progressive loading patterns.
+ *
+ * @returns Promise that resolves to an ImageDefinition
+ *
+ * @example
+ * ```ts
+ * import fs from "node:fs";
+ * import { createImage } from "jazz-tools/media";
+ *
+ * const imageBuffer = fs.readFileSync("path/to/image.jpg");
+ * const image = await createImage(imageBuffer, {
+ *   maxSize: 800,
+ *   placeholder: "blur",
+ *   progressive: false,
+ * });
+ * ```
+ */
+export declare const createImage: (source: SharpImageType, options?: import("../create-image-factory").CreateImageOptions) => Promise<{
+    readonly [key: string]: FileStream;
+} & {
+    readonly original: FileStream | null;
+    readonly originalSize: [number, number];
+    readonly placeholderDataURL: string | undefined;
+    readonly progressive: boolean;
+} & {
+    readonly [key: string]: FileStream | null;
+} & import("jazz-tools").CoMap>;
+//# sourceMappingURL=server.d.ts.map

package/dist/media/create-image/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/media/create-image/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAS,MAAM,YAAY,CAAC;AAIxD,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,WAAW,GACX,UAAU,GACV,iBAAiB,GACjB,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,CAAC;AAYjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;+BAYvB,CAAC"}

package/dist/media/create-image/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/media/create-image/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../../../src/media/create-image/server.test.ts"],"names":[],"mappings":""}

package/dist/media/{create-image.d.ts → create-image-factory.d.ts}

@@ -1,5 +1,6 @@
 import { Account, FileStream, Group } from "jazz-tools";
 export type SourceType = Blob | File | string;
+export type ResizeOutput = Blob | string;
 export type CreateImageOptions = {
     /** The owner of the image. Can be either a Group or Account. If not specified, the current user will be the owner. */
     owner?: Group | Account;
@@ -26,16 +27,16 @@ export type CreateImageOptions = {
      */
     progressive?: boolean;
 };
-export type CreateImageImpl = {
-    createFileStreamFromSource: (imageBlobOrFile: SourceType, owner?: Group | Account) => Promise<FileStream>;
-    getImageSize: (imageBlobOrFile: SourceType) => Promise<{
+export type CreateImageImpl<TSourceType = SourceType, TResizeOutput = ResizeOutput> = {
+    createFileStreamFromSource: (imageBlobOrFile: TSourceType | TResizeOutput, owner?: Group | Account) => Promise<FileStream>;
+    getImageSize: (imageBlobOrFile: TSourceType) => Promise<{
         width: number;
         height: number;
     }>;
-    getPlaceholderBase64: (imageBlobOrFile: SourceType) => Promise<string>;
-    resize: (imageBlobOrFile: SourceType, width: number, height: number) => Promise<Blob | string>;
+    getPlaceholderBase64: (imageBlobOrFile: TSourceType) => Promise<string>;
+    resize: (imageBlobOrFile: TSourceType, width: number, height: number) => Promise<TResizeOutput>;
 };
-export declare function createImageFactory(impl: CreateImageImpl): (source: SourceType, options: CreateImageOptions) => Promise<{
+export declare function createImageFactory<TSourceType, TResizeOutput>(impl: CreateImageImpl<TSourceType, TResizeOutput>, imageTypeGuard?: (imageBlobOrFile: TSourceType) => void): (source: TSourceType, options?: CreateImageOptions) => Promise<{
     readonly [key: string]: FileStream;
 } & {
     readonly original: FileStream | null;
@@ -45,4 +46,4 @@ export declare function createImageFactory(impl: CreateImageImpl): (source: Sour
 } & {
     readonly [key: string]: FileStream | null;
 } & import("jazz-tools").CoMap>;
-//# sourceMappingURL=create-image.d.ts.map
+//# sourceMappingURL=create-image-factory.d.ts.map

package/dist/media/create-image-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image-factory.d.ts","sourceRoot":"","sources":["../../src/media/create-image-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,UAAU,EACV,KAAK,EAGN,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sHAAsH;IACtH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,CACzB,WAAW,GAAG,UAAU,EACxB,aAAa,GAAG,YAAY,IAC1B;IACF,0BAA0B,EAAE,CAC1B,eAAe,EAAE,WAAW,GAAG,aAAa,EAC5C,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,KACpB,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,YAAY,EAAE,CACZ,eAAe,EAAE,WAAW,KACzB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,oBAAoB,EAAE,CAAC,eAAe,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,EAAE,CACN,eAAe,EAAE,WAAW,EAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,aAAa,EAC3D,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,aAAa,CAAC,EACjD,cAAc,CAAC,EAAE,CAAC,eAAe,EAAE,WAAW,KAAK,IAAI,YAEvC,WAAW,YAAY,kBAAkB;;;;;;;;;gCAI1D"}

package/dist/media/create-image-factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-image-factory.test.d.ts.map

package/dist/media/create-image-factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image-factory.test.d.ts","sourceRoot":"","sources":["../../src/media/create-image-factory.test.ts"],"names":[],"mappings":""}

package/dist/media/exports.d.ts

@@ -0,0 +1,3 @@
+export { highestResAvailable, loadImage, loadImageBySize } from "./utils.js";
+export { createImageFactory } from "./create-image-factory";
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/media/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/media/index.browser.d.ts

@@ -1,15 +1,3 @@
-import { FileStream } from "jazz-tools";
-import { CreateImageOptions, createImageFactory } from "./create-image.js";
-export { highestResAvailable, loadImage, loadImageBySize } from "./utils.js";
-export { createImageFactory };
-export declare function createImage(imageBlobOrFile: Blob | File | string, options?: CreateImageOptions): Promise<{
-    readonly [key: string]: FileStream;
-} & {
-    readonly original: FileStream | null;
-    readonly originalSize: [number, number];
-    readonly placeholderDataURL: string | undefined;
-    readonly progressive: boolean;
-} & {
-    readonly [key: string]: FileStream | null;
-} & import("jazz-tools").CoMap>;
+export * from "./exports";
+export { createImage } from "./create-image/browser";
 //# sourceMappingURL=index.browser.d.ts.map

package/dist/media/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/media/index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAA0B,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAsB,WAAW,CAC/B,eAAe,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,kBAAkB;;;;;;;;;gCAQ7B"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/media/index.browser.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/media/index.browser.js

@@ -3,24 +3,24 @@ import {
   highestResAvailable,
   loadImage,
   loadImageBySize
-} from "./chunk-KR2V6X2N.js";
+} from "./chunk-W3S526L3.js";
 
-// src/media/index.browser.ts
+// src/media/create-image/browser.ts
 import { FileStream } from "jazz-tools";
-async function createImage(imageBlobOrFile, options) {
-  return createImageFactory({
+var createImage = createImageFactory(
+  {
     createFileStreamFromSource,
     getImageSize,
     getPlaceholderBase64,
     resize
-  })(imageBlobOrFile, options || {});
-}
-async function createFileStreamFromSource(imageBlobOrFile, owner) {
-  if (typeof imageBlobOrFile === "string") {
-    throw new Error(
-      "createFileStreamFromSource(string) is not supported on this platform"
-    );
+  },
+  (imageBlobOrFile) => {
+    if (typeof imageBlobOrFile === "string") {
+      throw new Error("createImage(string) is not supported on this platform");
+    }
   }
+);
+async function createFileStreamFromSource(imageBlobOrFile, owner) {
   return FileStream.createFromBlob(imageBlobOrFile, owner);
 }
 function getImageFromBlob(blob) {
@@ -38,16 +38,10 @@ function getImageFromBlob(blob) {
   });
 }
 async function getImageSize(imageBlobOrFile) {
-  if (typeof imageBlobOrFile === "string") {
-    throw new Error("getImageSize(string) is not supported on browser");
-  }
   const image = await getImageFromBlob(imageBlobOrFile);
   return { width: image.width, height: image.height };
 }
 async function getPlaceholderBase64(imageBlobOrFile) {
-  if (typeof imageBlobOrFile === "string") {
-    throw new Error("getPlaceholderBase64(string) is not supported on browser");
-  }
   const image = await getImageFromBlob(imageBlobOrFile);
   const { width, height } = resizeDimensionsKeepingAspectRatio(
     image.width,
@@ -76,9 +70,6 @@ var resizeDimensionsKeepingAspectRatio = (width, height, maxSize) => {
   }
 };
 async function resize(imageBlobOrFile, width, height) {
-  if (typeof imageBlobOrFile === "string") {
-    throw new Error("resize(string) is not supported on browser");
-  }
   const mimeType = imageBlobOrFile.type;
   const image = await getImageFromBlob(imageBlobOrFile);
   const canvas = document.createElement("canvas");

package/dist/media/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/media/index.browser.ts"],"sourcesContent":["import { Account, FileStream, Group, ImageDefinition } from \"jazz-tools\";\nimport { CreateImageOptions, createImageFactory } from \"./create-image.js\";\n\nexport { highestResAvailable, loadImage, loadImageBySize } from \"./utils.js\";\n\nexport { createImageFactory };\n\nexport async function createImage(\n  imageBlobOrFile: Blob | File | string,\n  options?: CreateImageOptions,\n) {\n  return createImageFactory({\n    createFileStreamFromSource,\n    getImageSize,\n    getPlaceholderBase64,\n    resize,\n  })(imageBlobOrFile, options || {});\n}\n\n//  Image Manipulations\nasync function createFileStreamFromSource(\n  imageBlobOrFile: Blob | File | string,\n  owner?: Account | Group,\n): Promise<FileStream> {\n  if (typeof imageBlobOrFile === \"string\") {\n    throw new Error(\n      \"createFileStreamFromSource(string) is not supported on this platform\",\n    );\n  }\n\n  return FileStream.createFromBlob(imageBlobOrFile, owner);\n}\n\n// using createImageBitmap is ~10x slower than Image object\n// Image object: 640 milliseconds\n// createImageBitmap: 8128 milliseconds\nfunction getImageFromBlob(blob: Blob): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      resolve(img);\n      URL.revokeObjectURL(img.src);\n    };\n    img.onerror = () => {\n      reject(new Error(\"Failed to load image\"));\n      URL.revokeObjectURL(img.src);\n    };\n    img.src = URL.createObjectURL(blob);\n  });\n}\n\nasync function getImageSize(\n  imageBlobOrFile: Blob | File | string,\n): Promise<{ width: number; height: number }> {\n  if (typeof imageBlobOrFile === \"string\") {\n    throw new Error(\"getImageSize(string) is not supported on browser\");\n  }\n\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  return { width: image.width, height: image.height };\n}\n\nasync function getPlaceholderBase64(\n  imageBlobOrFile: Blob | File | string,\n): Promise<string> {\n  if (typeof imageBlobOrFile === \"string\") {\n    throw new Error(\"getPlaceholderBase64(string) is not supported on browser\");\n  }\n\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  const { width, height } = resizeDimensionsKeepingAspectRatio(\n    image.width,\n    image.height,\n    8,\n  );\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n\n  const ctx = canvas.getContext(\"2d\");\n\n  if (!ctx) {\n    throw new Error(\"Failed to get context\");\n  }\n\n  ctx.drawImage(image, 0, 0, width, height);\n\n  return canvas.toDataURL(\"image/png\");\n}\n\nconst resizeDimensionsKeepingAspectRatio = (\n  width: number,\n  height: number,\n  maxSize: number,\n): { width: number; height: number } => {\n  if (width <= maxSize && height <= maxSize) {\n    return { width, height };\n  }\n\n  const aspectRatio = width / height;\n\n  if (width >= height) {\n    return { width: maxSize, height: Math.round(maxSize / aspectRatio) };\n  } else {\n    return { width: Math.round(maxSize * aspectRatio), height: maxSize };\n  }\n};\n\nasync function resize(\n  imageBlobOrFile: Blob | File | string,\n  width: number,\n  height: number,\n): Promise<Blob> {\n  if (typeof imageBlobOrFile === \"string\") {\n    throw new Error(\"resize(string) is not supported on browser\");\n  }\n\n  const mimeType = imageBlobOrFile.type;\n\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n\n  const ctx = canvas.getContext(\"2d\");\n\n  if (!ctx) {\n    throw new Error(\"Failed to get context\");\n  }\n\n  ctx.drawImage(image, 0, 0, width, height);\n\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (!blob) {\n          reject(new Error(\"Failed to convert canvas to blob\"));\n          return;\n        }\n        resolve(blob);\n      },\n      mimeType,\n      0.8,\n    );\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/media/create-image/browser.ts"],"sourcesContent":["import { Account, FileStream, Group } from \"jazz-tools\";\nimport { createImageFactory } from \"../create-image-factory\";\n\n/**\n * Creates an ImageDefinition from an image File or Blob with built-in UX features.\n *\n * This function creates a specialized CoValue for managing images in Jazz applications.\n * It supports blurry placeholders, built-in resizing, and progressive loading patterns.\n *\n * @returns Promise that resolves to an ImageDefinition\n *\n * @example\n * ```ts\n * import { createImage } from \"jazz-tools/media\";\n *\n * // Create an image from a file input\n * async function handleFileUpload(event: React.ChangeEvent<HTMLInputElement>) {\n *   const file = event.target.files?.[0];\n *   if (file) {\n *     // Creates ImageDefinition with a blurry placeholder, limited to 1024px\n *     // on the longest side, and multiple resolutions automatically\n *     const image = await createImage(file, {\n *       owner: me._owner,\n *       maxSize: 1024,\n *       placeholder: \"blur\",\n *       progressive: true,\n *     });\n *\n *     // Store the image in your application data\n *     me.profile.image = image;\n *   }\n * }\n * ```\n */\nexport const createImage = createImageFactory(\n  {\n    createFileStreamFromSource,\n    getImageSize,\n    getPlaceholderBase64,\n    resize,\n  },\n  (imageBlobOrFile) => {\n    if (typeof imageBlobOrFile === \"string\") {\n      throw new Error(\"createImage(string) is not supported on this platform\");\n    }\n  },\n);\n\n//  Image Manipulations\nasync function createFileStreamFromSource(\n  imageBlobOrFile: Blob | File,\n  owner?: Account | Group,\n): Promise<FileStream> {\n  return FileStream.createFromBlob(imageBlobOrFile, owner);\n}\n\n// using createImageBitmap is ~10x slower than Image object\n// Image object: 640 milliseconds\n// createImageBitmap: 8128 milliseconds\nfunction getImageFromBlob(blob: Blob): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      resolve(img);\n      URL.revokeObjectURL(img.src);\n    };\n    img.onerror = () => {\n      reject(new Error(\"Failed to load image\"));\n      URL.revokeObjectURL(img.src);\n    };\n    img.src = URL.createObjectURL(blob);\n  });\n}\n\nasync function getImageSize(\n  imageBlobOrFile: Blob | File,\n): Promise<{ width: number; height: number }> {\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  return { width: image.width, height: image.height };\n}\n\nasync function getPlaceholderBase64(\n  imageBlobOrFile: Blob | File,\n): Promise<string> {\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  const { width, height } = resizeDimensionsKeepingAspectRatio(\n    image.width,\n    image.height,\n    8,\n  );\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n\n  const ctx = canvas.getContext(\"2d\");\n\n  if (!ctx) {\n    throw new Error(\"Failed to get context\");\n  }\n\n  ctx.drawImage(image, 0, 0, width, height);\n\n  return canvas.toDataURL(\"image/png\");\n}\n\nconst resizeDimensionsKeepingAspectRatio = (\n  width: number,\n  height: number,\n  maxSize: number,\n): { width: number; height: number } => {\n  if (width <= maxSize && height <= maxSize) {\n    return { width, height };\n  }\n\n  const aspectRatio = width / height;\n\n  if (width >= height) {\n    return { width: maxSize, height: Math.round(maxSize / aspectRatio) };\n  } else {\n    return { width: Math.round(maxSize * aspectRatio), height: maxSize };\n  }\n};\n\nasync function resize(\n  imageBlobOrFile: Blob | File,\n  width: number,\n  height: number,\n): Promise<Blob> {\n  const mimeType = imageBlobOrFile.type;\n\n  const image = await getImageFromBlob(imageBlobOrFile);\n\n  const canvas = document.createElement(\"canvas\");\n  canvas.width = width;\n  canvas.height = height;\n\n  const ctx = canvas.getContext(\"2d\");\n\n  if (!ctx) {\n    throw new Error(\"Failed to get context\");\n  }\n\n  ctx.drawImage(image, 0, 0, width, height);\n\n  return new Promise<Blob>((resolve, reject) => {\n    canvas.toBlob(\n      (blob) => {\n        if (!blob) {\n          reject(new Error(\"Failed to convert canvas to blob\"));\n          return;\n        }\n        resolve(blob);\n      },\n      mimeType,\n      0.8,\n    );\n  });\n}\n"],"mappings":";;;;;;;;AAAA,SAAkB,kBAAyB;AAkCpC,IAAM,cAAc;AAAA,EACzB;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,CAAC,oBAAoB;AACnB,QAAI,OAAO,oBAAoB,UAAU;AACvC,YAAM,IAAI,MAAM,uDAAuD;AAAA,IACzE;AAAA,EACF;AACF;AAGA,eAAe,2BACb,iBACA,OACqB;AACrB,SAAO,WAAW,eAAe,iBAAiB,KAAK;AACzD;AAKA,SAAS,iBAAiB,MAAuC;AAC/D,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,MAAM,IAAI,MAAM;AACtB,QAAI,SAAS,MAAM;AACjB,cAAQ,GAAG;AACX,UAAI,gBAAgB,IAAI,GAAG;AAAA,IAC7B;AACA,QAAI,UAAU,MAAM;AAClB,aAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,UAAI,gBAAgB,IAAI,GAAG;AAAA,IAC7B;AACA,QAAI,MAAM,IAAI,gBAAgB,IAAI;AAAA,EACpC,CAAC;AACH;AAEA,eAAe,aACb,iBAC4C;AAC5C,QAAM,QAAQ,MAAM,iBAAiB,eAAe;AAEpD,SAAO,EAAE,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AACpD;AAEA,eAAe,qBACb,iBACiB;AACjB,QAAM,QAAQ,MAAM,iBAAiB,eAAe;AAEpD,QAAM,EAAE,OAAO,OAAO,IAAI;AAAA,IACxB,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,EACF;AAEA,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,QAAQ;AACf,SAAO,SAAS;AAEhB,QAAM,MAAM,OAAO,WAAW,IAAI;AAElC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,MAAI,UAAU,OAAO,GAAG,GAAG,OAAO,MAAM;AAExC,SAAO,OAAO,UAAU,WAAW;AACrC;AAEA,IAAM,qCAAqC,CACzC,OACA,QACA,YACsC;AACtC,MAAI,SAAS,WAAW,UAAU,SAAS;AACzC,WAAO,EAAE,OAAO,OAAO;AAAA,EACzB;AAEA,QAAM,cAAc,QAAQ;AAE5B,MAAI,SAAS,QAAQ;AACnB,WAAO,EAAE,OAAO,SAAS,QAAQ,KAAK,MAAM,UAAU,WAAW,EAAE;AAAA,EACrE,OAAO;AACL,WAAO,EAAE,OAAO,KAAK,MAAM,UAAU,WAAW,GAAG,QAAQ,QAAQ;AAAA,EACrE;AACF;AAEA,eAAe,OACb,iBACA,OACA,QACe;AACf,QAAM,WAAW,gBAAgB;AAEjC,QAAM,QAAQ,MAAM,iBAAiB,eAAe;AAEpD,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,QAAQ;AACf,SAAO,SAAS;AAEhB,QAAM,MAAM,OAAO,WAAW,IAAI;AAElC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,MAAI,UAAU,OAAO,GAAG,GAAG,OAAO,MAAM;AAExC,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,WAAO;AAAA,MACL,CAAC,SAAS;AACR,YAAI,CAAC,MAAM;AACT,iBAAO,IAAI,MAAM,kCAAkC,CAAC;AACpD;AAAA,QACF;AACA,gBAAQ,IAAI;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/media/index.d.ts

@@ -1,7 +1,6 @@
 import type { ImageDefinition } from "jazz-tools";
-import { CreateImageOptions, SourceType, createImageFactory } from "./create-image.js";
-export { highestResAvailable, loadImage, loadImageBySize } from "./utils.js";
-export { createImageFactory };
+import { CreateImageOptions } from "./create-image-factory";
+export * from "./exports";
 /**
  * Creates an ImageDefinition from an image file or blob with built-in UX features.
  *
@@ -32,7 +31,16 @@ export { createImageFactory };
  *   }
  * }
  * ```
+ * ```
+ */
+export declare function createImage(imageBlobOrFile: Blob | File, options?: CreateImageOptions): Promise<ImageDefinition>;
+/**
+ * Creates an ImageDefinition from an image file path with built-in UX features.
  *
+ * This function creates a specialized CoValue for managing images in Jazz applications.
+ * It supports blurry placeholders, built-in resizing, and progressive loading patterns.
+ *
+ * @returns Promise that resolves to an ImageDefinition
  * @example
  * ```ts
  * // React Native example
@@ -49,5 +57,5 @@ export { createImageFactory };
  * }
  * ```
  */
-export declare function createImage(imageBlobOrFile: SourceType, options?: CreateImageOptions): Promise<ImageDefinition>;
+export declare function createImage(filePath: string, options?: CreateImageOptions): Promise<ImageDefinition>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,eAAe,EAAE,UAAU,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,cAAc,WAAW,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,eAAe,EAAE,IAAI,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/media/index.js

@@ -3,7 +3,7 @@ import {
   highestResAvailable,
   loadImage,
   loadImageBySize
-} from "./chunk-KR2V6X2N.js";
+} from "./chunk-W3S526L3.js";
 export {
   createImageFactory,
   highestResAvailable,