@enslo/sd-metadata 1.4.2 → 1.5.0

package/README.ja.md

@@ -117,9 +117,7 @@ fileInput.addEventListener('change', async (e) => {
   if (!file) return;
   
   const arrayBuffer = await file.arrayBuffer();
-  const imageData = new Uint8Array(arrayBuffer);
-  
-  const result = read(imageData);
+  const result = read(arrayBuffer);
   
   if (result.status === 'success') {
     document.getElementById('tool').textContent = result.metadata.software;
@@ -137,12 +135,10 @@ fileInput.addEventListener('change', async (e) => {
 // CDNからインポート
 import { read } from 'https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@latest/dist/index.js';
 
-// 画像を取得してメタデータを読み込み
 const response = await fetch(imageUrl);
 const arrayBuffer = await response.arrayBuffer();
-const imageData = new Uint8Array(arrayBuffer);
+const result = read(arrayBuffer);
 
-const result = read(imageData);
 if (result.status === 'success') {
   console.log('Tool:', result.metadata.software);
   console.log('Prompt:', result.metadata.prompt);
@@ -153,7 +149,7 @@ if (result.status === 'success') {
 > 本番環境では `@latest` の代わりに特定のバージョンを指定してください：
 >
 > ```text
-> https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@1.4.1/dist/index.js
+> https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@1.5.0/dist/index.js
 > ```
 
 ### 応用例
@@ -335,7 +331,7 @@ if (result.status === 'success') {
 
 ## APIリファレンス
 
-### `read(data: Uint8Array): ParseResult`
+### `read(input: Uint8Array | ArrayBuffer): ParseResult`
 
 画像ファイルからメタデータを読み込み、パースします。
 
@@ -350,13 +346,13 @@ if (result.status === 'success') {
 - `{ status: 'invalid', message? }` - 破損または非対応の画像フォーマット
   - `message`: オプションのエラー説明
 
-### `write(data: Uint8Array, metadata: ParseResult): WriteResult`
+### `write(input: Uint8Array | ArrayBuffer, metadata: ParseResult): WriteResult`
 
 画像ファイルにメタデータを書き込みます。
 
 **パラメータ:**
 
-- `data` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）
+- `input` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）
 - `metadata` - `read()` から得られた `ParseResult`
   - `status: 'success'` または `'empty'` - 直接書き込み可能
   - `status: 'unrecognized'` - 同じフォーマット：そのまま書き込み、異なるフォーマット：warning付きでメタデータ削除
@@ -370,13 +366,13 @@ if (result.status === 'success') {
   - `'conversionFailed'`: メタデータ変換に失敗（例：互換性のないフォーマット）
   - `'writeFailed'`: 画像へのメタデータ埋め込みに失敗
 
-### `writeAsWebUI(data: Uint8Array, metadata: GenerationMetadata): WriteResult`
+### `writeAsWebUI(input: Uint8Array | ArrayBuffer, metadata: GenerationMetadata): WriteResult`
 
 SD WebUI (A1111) フォーマットで画像にメタデータを書き込みます。
 
 **パラメータ:**
 
-- `data` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）
+- `input` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）
 - `metadata` - 埋め込む生成メタデータ
   - 任意のツールからでも、カスタム作成でも可能
   - 自動的にWebUIフォーマットに変換される

package/README.md

@@ -93,7 +93,6 @@ const { read } = require('@enslo/sd-metadata');
 import { read, write } from '@enslo/sd-metadata';
 import { readFileSync, writeFileSync } from 'fs';
 
-// Read metadata from any supported format
 const imageData = readFileSync('image.png');
 const result = read(imageData);
 
@@ -117,9 +116,7 @@ fileInput.addEventListener('change', async (e) => {
   if (!file) return;
   
   const arrayBuffer = await file.arrayBuffer();
-  const imageData = new Uint8Array(arrayBuffer);
-  
-  const result = read(imageData);
+  const result = read(arrayBuffer);
   
   if (result.status === 'success') {
     document.getElementById('tool').textContent = result.metadata.software;
@@ -137,12 +134,10 @@ For bookmarklets or userscripts (Tampermonkey, Violentmonkey, etc.), load from j
 // Import from CDN
 import { read } from 'https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@latest/dist/index.js';
 
-// Fetch image and read metadata
 const response = await fetch(imageUrl);
 const arrayBuffer = await response.arrayBuffer();
-const imageData = new Uint8Array(arrayBuffer);
+const result = read(arrayBuffer);
 
-const result = read(imageData);
 if (result.status === 'success') {
   console.log('Tool:', result.metadata.software);
   console.log('Prompt:', result.metadata.prompt);
@@ -153,7 +148,7 @@ if (result.status === 'success') {
 > For production use, pin to a specific version instead of `@latest`:
 >
 > ```text
-> https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@1.4.2/dist/index.js
+> https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@1.5.0/dist/index.js
 > ```
 
 ### Advanced Examples
@@ -335,7 +330,7 @@ if (result.status === 'success') {
 
 ## API Reference
 
-### `read(data: Uint8Array): ParseResult`
+### `read(input: Uint8Array | ArrayBuffer): ParseResult`
 
 Reads and parses metadata from an image file.
 
@@ -350,13 +345,13 @@ Reads and parses metadata from an image file.
 - `{ status: 'invalid', message? }` - Corrupted or unsupported image format
   - `message`: Optional error description
 
-### `write(data: Uint8Array, metadata: ParseResult): WriteResult`
+### `write(input: Uint8Array | ArrayBuffer, metadata: ParseResult): WriteResult`
 
 Writes metadata to an image file.
 
 **Parameters:**
 
-- `data` - Target image file data (PNG, JPEG, or WebP)
+- `input` - Target image file data (PNG, JPEG, or WebP)
 - `metadata` - `ParseResult` from `read()`
   - `status: 'success'` or `'empty'` - Can write directly
   - `status: 'unrecognized'` - Same format: writes as-is; Cross-format: drops metadata with warning
@@ -370,13 +365,13 @@ Writes metadata to an image file.
   - `'conversionFailed'`: Metadata conversion failed (e.g., incompatible format)
   - `'writeFailed'`: Failed to embed metadata into the image
 
-### `writeAsWebUI(data: Uint8Array, metadata: GenerationMetadata): WriteResult`
+### `writeAsWebUI(input: Uint8Array | ArrayBuffer, metadata: GenerationMetadata): WriteResult`
 
 Writes metadata to an image in SD WebUI (A1111) format.
 
 **Parameters:**
 
-- `data` - Target image file data (PNG, JPEG, or WebP)
+- `input` - Target image file data (PNG, JPEG, or WebP)
 - `metadata` - Generation metadata to embed
   - Can be from any tool or custom-created
   - Automatically converted to WebUI format

package/dist/index.d.ts

@@ -300,10 +300,10 @@ type ParseResult = {
  * Automatically detects the image format (PNG, JPEG, WebP) and parses
  * any embedded generation metadata.
  *
- * @param data - Image file data
+ * @param input - Image file data (Uint8Array or ArrayBuffer)
  * @returns Parse result containing metadata and raw data
  */
-declare function read(data: Uint8Array): ParseResult;
+declare function read(input: Uint8Array | ArrayBuffer): ParseResult;
 
 /**
  * Write API for sd-metadata
@@ -351,11 +351,11 @@ type WriteResult = {
  * if necessary. For unrecognized metadata with cross-format conversion,
  * metadata is dropped and a warning is returned.
  *
- * @param data - Target image file data
+ * @param input - Target image file data (Uint8Array or ArrayBuffer)
  * @param metadata - ParseResult from `read()`
  * @returns New image data with embedded metadata (or warning if metadata was dropped)
  */
-declare function write(data: Uint8Array, metadata: ParseResult): WriteResult;
+declare function write(input: Uint8Array | ArrayBuffer, metadata: ParseResult): WriteResult;
 
 /**
  * WebUI (A1111) format writer for sd-metadata
@@ -377,7 +377,7 @@ declare function write(data: Uint8Array, metadata: ParseResult): WriteResult;
  * - PNG: `parameters` tEXt/iTXt chunk (encoding auto-selected based on content)
  * - JPEG/WebP: Exif UserComment field
  *
- * @param data - Target image file data (PNG, JPEG, or WebP)
+ * @param input - Target image file data (Uint8Array or ArrayBuffer)
  * @param metadata - Generation metadata to embed
  * @returns New image data with embedded metadata, or error
  *
@@ -403,7 +403,7 @@ declare function write(data: Uint8Array, metadata: ParseResult): WriteResult;
  * }
  * ```
  */
-declare function writeAsWebUI(data: Uint8Array, metadata: GenerationMetadata): WriteResult;
+declare function writeAsWebUI(input: Uint8Array | ArrayBuffer, metadata: GenerationMetadata): WriteResult;
 
 /**
  * A1111-format metadata serialization utilities

package/dist/index.js

@@ -1030,6 +1030,9 @@ function parseMetadata(entries) {
 }
 
 // src/utils/binary.ts
+function toUint8Array(input) {
+  return input instanceof ArrayBuffer ? new Uint8Array(input) : input;
+}
 function readUint24LE(data, offset) {
   return (data[offset] ?? 0) | (data[offset + 1] ?? 0) << 8 | (data[offset + 2] ?? 0) << 16;
 }
@@ -1641,7 +1644,8 @@ function sourceToKeyword(source) {
 }
 
 // src/api/read.ts
-function read(data) {
+function read(input) {
+  const data = toUint8Array(input);
   const format = detectFormat(data);
   if (!format) {
     return { status: "invalid", message: "Unknown image format" };
@@ -2715,7 +2719,8 @@ function buildExifChunk(segments) {
 }
 
 // src/api/write.ts
-function write(data, metadata) {
+function write(input, metadata) {
+  const data = toUint8Array(input);
   const targetFormat = detectFormat(data);
   if (!targetFormat) {
     return { ok: false, error: { type: "unsupportedFormat" } };
@@ -2915,7 +2920,8 @@ function formatAsWebUI(metadata) {
 }
 
 // src/api/write-webui.ts
-function writeAsWebUI(data, metadata) {
+function writeAsWebUI(input, metadata) {
+  const data = toUint8Array(input);
   const format = detectFormat(data);
   if (!format) {
     return Result.error({ type: "unsupportedFormat" });