@thi.ng/imago 1.2.4 → 1.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-21T08:21:58Z
+- **Last updated**: 2025-07-21T15:28:55Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [1.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/imago@1.3.0) (2025-07-21)
+
+#### 🚀 Features
+
+- add `dataURL` output option ([eca0ee3](https://github.com/thi-ng/umbrella/commit/eca0ee3))
+
 ### [1.2.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/imago@1.2.1) (2025-07-14)
 
 #### 🩹 Bug fixes

package/README.md

@@ -375,7 +375,7 @@ For Node.js REPL:
 const imago = await import("@thi.ng/imago");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.08 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.17 KB
 
 ## Dependencies
 

package/api.d.ts

@@ -372,6 +372,19 @@ export interface OutputSpec extends ProcSpec {
      * WebP output options. See [Sharp docs](https://sharp.pixelplumbing.com/api-output#webp)
      */
     webp?: WebpOptions;
+    /**
+     * Only used if {@link OutputSpec.path} is NOT set. If true, output will be
+     * captured as data URL, otherwise as binary data/buffer.
+     *
+     * @remarks
+     * Other conditions:
+     *
+     * - Requires {@link OutputSpec.format} to be set to a data URL compatible
+     *   image format.
+     * - An error will be thrown during processing if the encoded image size
+     *   exceeds 32KB.
+     */
+    dataURL?: boolean;
 }
 export interface ResizeSpec extends ProcSpec {
     op: "resize";

package/ops/output.d.ts

@@ -1,3 +1,4 @@
 import type { Processor } from "../api.js";
 export declare const outputProc: Processor;
+export declare const asDataURL: (mime: string, data: Buffer) => string;
 //# sourceMappingURL=output.d.ts.map

package/ops/output.js

@@ -1,7 +1,8 @@
 import { encode } from "@thi.ng/blurhash";
 import { isNumber, isPlainObject } from "@thi.ng/checks";
+import { illegalArgs } from "@thi.ng/errors";
 import { writeFile, writeJSON } from "@thi.ng/file-io";
-import { firstNonNullKey } from "@thi.ng/object-utils/first-non-null";
+import { firstNonNullKey } from "@thi.ng/object-utils";
 import { join, resolve } from "node:path";
 import { formatPath } from "../path.js";
 const outputProc = async (spec, input, ctx) => {
@@ -79,7 +80,7 @@ const outputProc = async (spec, input, ctx) => {
     writeFile(path, result, null, ctx.logger);
     ctx.outputs[opts.id] = path;
   } else {
-    ctx.outputs[opts.id] = result;
+    ctx.outputs[opts.id] = format && opts.dataURL ? asDataURL(`image/${format}`, result) : result;
   }
   return [input, false];
 };
@@ -122,6 +123,12 @@ const __outputBlurHash = async (opts, output, ctx) => {
   ctx.logger.debug("computed blurhash:", hash);
   ctx.outputs[opts.id] = hash;
 };
+const asDataURL = (mime, data) => {
+  if (data.length > 32768)
+    illegalArgs("encoded image too large for dataURL (max. 32KB allowed)");
+  return `data:${mime};base64,${data.toString("base64")}`;
+};
 export {
+  asDataURL,
   outputProc
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/imago",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "JSON & API-based declarative and extensible image processing trees/pipelines",
   "type": "module",
   "module": "./index.js",
@@ -189,5 +189,5 @@
     "status": "alpha",
     "year": 2024
   },
-  "gitHead": "11747c482773d3da03c8b7848b25a56251ccd759\n"
+  "gitHead": "0c467cd5bdf66531dc159e226d10cb6718426cc1\n"
 }