jazz-tools 0.18.1 → 0.18.3

package/.turbo/turbo-build.log

@@ -1,12 +1,12 @@
 
-> jazz-tools@0.18.1 build /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.18.3 build /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsup && pnpm types && pnpm build:svelte
 
 CLI Building entry: {"index":"src/index.ts","testing":"src/testing.ts"}
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/browser/index.ts"}
 CLI Using tsconfig: tsconfig.json
-CLI Building entry: {"index":"src/media/index.ts","index.browser":"src/media/index.browser.ts","index.native":"src/media/index.native.ts"}
+CLI Building entry: {"index":"src/media/index.ts","index.browser":"src/media/index.browser.ts","index.native":"src/media/index.native.ts","index.server":"src/media/index.server.ts"}
 CLI Using tsconfig: tsconfig.json
 CLI Building entry: {"index":"src/expo/index.ts","testing":"src/expo/testing.ts","crypto":"src/expo/crypto.ts"}
 CLI Using tsconfig: tsconfig.json
@@ -107,91 +107,93 @@
 ESM Build start
 CLI Cleaning output folder
 ESM Build start
-ESM dist/react/ssr.js     688.00 B
-ESM dist/react/ssr.js.map 1.12 KB
-ESM ⚡️ Build success in 28ms
-ESM dist/tiptap/index.js     564.00 B
-ESM dist/tiptap/index.js.map 1.21 KB
-ESM ⚡️ Build success in 27ms
 ESM dist/worker/index.js     2.33 KB
 ESM dist/worker/index.js.map 4.79 KB
-ESM ⚡️ Build success in 25ms
-ESM dist/media/index.js              236.00 B
-ESM dist/media/index.browser.js      3.21 KB
-ESM dist/media/index.native.js       3.53 KB
-ESM dist/media/chunk-KR2V6X2N.js     6.42 KB
-ESM dist/media/index.js.map          71.00 B
-ESM dist/media/index.native.js.map   6.52 KB
-ESM dist/media/index.browser.js.map  6.02 KB
-ESM dist/media/chunk-KR2V6X2N.js.map 16.19 KB
-ESM ⚡️ Build success in 34ms
+ESM ⚡️ Build success in 17ms
+ESM dist/tiptap/index.js     564.00 B
+ESM dist/tiptap/index.js.map 1.21 KB
+ESM ⚡️ Build success in 19ms
+ESM dist/react/ssr.js     688.00 B
+ESM dist/react/ssr.js.map 1.12 KB
+ESM ⚡️ Build success in 21ms
+ESM dist/better-auth/auth/client.js     4.36 KB
 ESM dist/better-auth/auth/server.js     5.94 KB
 ESM dist/better-auth/auth/react.js      1.19 KB
-ESM dist/better-auth/auth/client.js     4.36 KB
+ESM dist/better-auth/auth/client.js.map 8.12 KB
 ESM dist/better-auth/auth/server.js.map 10.66 KB
 ESM dist/better-auth/auth/react.js.map  3.37 KB
-ESM dist/better-auth/auth/client.js.map 8.12 KB
-ESM ⚡️ Build success in 26ms
-ESM dist/browser/index.js     13.44 KB
-ESM dist/browser/index.js.map 28.70 KB
-ESM ⚡️ Build success in 40ms
+ESM ⚡️ Build success in 19ms
+ESM dist/media/index.js              236.00 B
+ESM dist/media/index.browser.js      2.79 KB
+ESM dist/media/index.native.js       2.90 KB
+ESM dist/media/index.server.js       2.95 KB
+ESM dist/media/chunk-W3S526L3.js     6.47 KB
+ESM dist/media/index.js.map          71.00 B
+ESM dist/media/index.browser.js.map  6.15 KB
+ESM dist/media/index.native.js.map   6.09 KB
+ESM dist/media/index.server.js.map   6.37 KB
+ESM dist/media/chunk-W3S526L3.js.map 16.57 KB
+ESM ⚡️ Build success in 28ms
 ESM dist/react-native/index.js       2.53 KB
 ESM dist/react-native/testing.js     120.00 B
 ESM dist/react-native/crypto.js      161.00 B
 ESM dist/react-native/index.js.map   5.68 KB
 ESM dist/react-native/testing.js.map 176.00 B
 ESM dist/react-native/crypto.js.map  197.00 B
-ESM ⚡️ Build success in 46ms
+ESM ⚡️ Build success in 29ms
+ESM dist/browser/index.js     13.44 KB
+ESM dist/browser/index.js.map 28.70 KB
+ESM ⚡️ Build success in 36ms
 ESM dist/expo/index.js       4.68 KB
 ESM dist/expo/testing.js     112.00 B
 ESM dist/expo/crypto.js      153.00 B
 ESM dist/expo/index.js.map   10.23 KB
-ESM dist/expo/crypto.js.map  189.00 B
 ESM dist/expo/testing.js.map 168.00 B
-ESM ⚡️ Build success in 50ms
+ESM dist/expo/crypto.js.map  189.00 B
+ESM ⚡️ Build success in 36ms
 ESM dist/react-native-core/index.js       17.90 KB
 ESM dist/react-native-core/testing.js     119.00 B
 ESM dist/react-native-core/crypto.js      2.10 KB
 ESM dist/react-native-core/index.js.map   36.66 KB
-ESM dist/react-native-core/testing.js.map 175.00 B
 ESM dist/react-native-core/crypto.js.map  4.25 KB
-ESM ⚡️ Build success in 47ms
-ESM dist/react/index.js       24.66 KB
+ESM dist/react-native-core/testing.js.map 175.00 B
+ESM ⚡️ Build success in 37ms
 ESM dist/react/testing.js     122.00 B
-ESM dist/react/index.js.map   53.09 KB
+ESM dist/react/index.js       24.66 KB
 ESM dist/react/testing.js.map 165.00 B
-ESM ⚡️ Build success in 61ms
+ESM dist/react/index.js.map   53.43 KB
+ESM ⚡️ Build success in 42ms
 ESM dist/prosemirror/index.js     77.63 KB
 ESM dist/prosemirror/index.js.map 306.98 KB
-ESM ⚡️ Build success in 62ms
+ESM ⚡️ Build success in 47ms
 ESM dist/inspector/index.js     61.52 KB
 ESM dist/inspector/index.js.map 109.98 KB
-ESM ⚡️ Build success in 76ms
+ESM ⚡️ Build success in 57ms
+ESM dist/testing.js            7.17 KB
 ESM dist/index.js              26.13 KB
 ESM dist/chunk-IERUTUXB.js     163.90 KB
-ESM dist/testing.js            7.17 KB
 ESM dist/testing.js.map        14.10 KB
 ESM dist/index.js.map          52.92 KB
 ESM dist/chunk-IERUTUXB.js.map 389.03 KB
-ESM ⚡️ Build success in 108ms
+ESM ⚡️ Build success in 79ms
+ESM dist/react-core/index.js              141.07 KB
 ESM dist/react-core/testing.js            1.17 KB
 ESM dist/react-core/chunk-7DYMJ74I.js     279.00 B
-ESM dist/react-core/index.js              141.07 KB
 ESM dist/react-core/testing.js.map        1.82 KB
 ESM dist/react-core/chunk-7DYMJ74I.js.map 533.00 B
 ESM dist/react-core/index.js.map          383.45 KB
-ESM ⚡️ Build success in 107ms
+ESM ⚡️ Build success in 78ms
 ESM dist/inspector/register-custom-element.js     218.00 B
 ESM dist/inspector/register-custom-element.js.map 314.00 B
 ESM dist/inspector/custom-element-WCY6D3QJ.js     1.53 MB
 ESM dist/inspector/custom-element-WCY6D3QJ.js.map 2.35 MB
-ESM ⚡️ Build success in 147ms
+ESM ⚡️ Build success in 112ms
 
-> jazz-tools@0.18.1 types /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.18.3 types /home/runner/_work/jazz/jazz/packages/jazz-tools
 > tsc --outDir dist
 
 
-> jazz-tools@0.18.1 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
+> jazz-tools@0.18.3 build:svelte /home/runner/_work/jazz/jazz/packages/jazz-tools
 > rm -rf dist/svelte && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json
 
 src/svelte -> dist/svelte

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # jazz-tools
 
+## 0.18.3
+
+### Patch Changes
+
+- b526ab6: Set 18.x as latest
+- d69aa68: Added a server implementation of `createImage()` to create images in server environments using the "sharp" library
+  - cojson@0.18.3
+  - cojson-storage-indexeddb@0.18.3
+  - cojson-transport-ws@0.18.3
+
+## 0.18.2
+
+### Patch Changes
+
+- Updated dependencies [82ba2dd]
+- Updated dependencies [01f4889]
+  - cojson@0.18.2
+  - cojson-storage-indexeddb@0.18.2
+  - cojson-transport-ws@0.18.2
+
 ## 0.18.1
 
 ### Patch Changes

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"}