@enslo/sd-metadata 2.3.0 → 3.0.0

package/docs/types.ja.md

@@ -10,6 +10,8 @@
   - [`ParseResult`](#parseresult)
   - [`GenerationMetadata`](#generationmetadata)
   - [`GenerationSoftware`](#generationsoftware)
+  - [`C2paMetadata`](#c2pametadata)
+  - [`C2paVendor`](#c2pavendor)
   - [`EmbedMetadata`](#embedmetadata)
   - [`RawMetadata`](#rawmetadata)
   - [`WriteResult`](#writeresult)
@@ -47,6 +49,7 @@
 ```typescript
 type ParseResult =
   | { status: 'success'; metadata: GenerationMetadata; raw: RawMetadata }
+  | { status: 'c2pa'; c2pa: C2paMetadata }
   | { status: 'unrecognized'; raw: RawMetadata }
   | { status: 'empty' }
   | { status: 'invalid'; message?: string };
@@ -57,6 +60,8 @@ type ParseResult =
 - **`success`**: メタデータのパースに成功
   - `metadata`: 統一されたメタデータオブジェクト
   - `raw`: ラウンドトリップ変換用の元のフォーマット固有データ
+- **`c2pa`**: 画像が C2PA Content Credentials を持つが、パース可能な生成メタデータがない
+  - `c2pa`: 未検証の Content Credentials を表す `C2paMetadata`。`raw` フィールドは存在しません — 署名済みマニフェストはラウンドトリップ書き込み用に公開されません。
 - **`unrecognized`**: 画像にメタデータがあるがフォーマットが認識できない
   - `raw`: 元のメタデータが保持される
 - **`empty`**: 画像にメタデータが見つからない
@@ -75,7 +80,14 @@ switch (result.status) {
     console.log(`Generated by ${result.metadata.software}`);
     console.log(`Prompt: ${result.metadata.prompt}`);
     break;
-  
+
+  case 'c2pa':
+    // Content Credentials を検出（例：OpenAI ChatGPT、Google Gemini）。
+    // 検出のみ — 署名は検証されません。
+    console.log(`生成元（未検証）: ${result.c2pa.vendor}`);
+    console.log(`Claim generator: ${result.c2pa.claimGenerator ?? 'unknown'}`);
+    break;
+
   case 'unrecognized':
     console.log('不明なメタデータフォーマット');
     break;
@@ -172,6 +184,73 @@ function displaySoftware(software: GenerationSoftware): string {
 
 ---
 
+### `C2paMetadata`
+
+画像に埋め込まれた C2PA Content Credentials から読み取った内容。
+
+C2PAマニフェストを持つ画像（現在は **OpenAI ChatGPT** と **Google Gemini**）で、パース可能な生成メタデータがない場合に `read()` が `{ status: 'c2pa', c2pa }` として返します。`GenerationMetadata` とは異なり、**プロンプト・シード・モデル・サイズを一切持ちません**: これらのツールは生成パラメータではなく Content Credentials を埋め込むためです。`C2paMetadata` は `BaseMetadata` を**拡張しません**。
+
+```typescript
+export interface C2paMetadata {
+  /** マニフェストの claim generator／署名者から特定した粗いベンダー。 */
+  vendor: C2paVendor;
+  /**
+   * マニフェストが学習アルゴリズム由来（AI生成）の IPTC DigitalSourceType を
+   * 宣言している場合に `true`。カメラ／スキャンのソースタイプはフラグされません。
+   */
+  aiGenerated: boolean;
+  /** 生の IPTC DigitalSourceType URI。存在する場合はそのまま提供されます。 */
+  digitalSourceType?: string;
+  /** C2PA の `claim_generator_info.name`（存在する場合）。 */
+  claimGenerator?: string;
+}
+```
+
+> **重要 — 検証ではなく検出のみ。** Content Credentials の存在は真正性の証明にはなりません（文字列は偽造可能）。不在も人間由来の証明にはなりません: Content Credentials はスクリーンショット、SNSへの再アップロード、再エンコードによって日常的に剥奪されます。
+>
+> **現時点ではPNGのみ。** マニフェストはPNGの `caBX` チャンクから読み取られます。JPEG/WebP対応は予定されています。
+
+**例：**
+
+```typescript
+import { read, c2paVendorLabels } from '@enslo/sd-metadata';
+
+const result = read(imageData);
+
+if (result.status === 'c2pa') {
+  const { vendor, aiGenerated, claimGenerator } = result.c2pa;
+  console.log('Vendor:', c2paVendorLabels[vendor]);
+  console.log('Declared AI-generated:', aiGenerated);
+  console.log('Claim generator:', claimGenerator ?? 'unknown');
+}
+```
+
+---
+
+### `C2paVendor`
+
+画像の C2PA Content Credentials の粗いベンダー特定。[`C2paMetadata`](#c2pametadata) の `vendor` 判別子として、また `c2paVendorLabels` のキー型として使用します。
+
+```typescript
+export type C2paVendor = 'openai' | 'google' | 'unknown';
+```
+
+設計上、これは粗い特定です: C2PAマニフェストは生成元ベンダー（`'openai'` → ChatGPT、`'google'` → Gemini、`'unknown'` → ベンダーが具体的に認識されないAI生成マニフェスト）を特定しますが、具体的なモデルは特定**しません**。
+
+**例：**
+
+```typescript
+import { c2paVendorLabels } from '@enslo/sd-metadata';
+import type { C2paVendor } from '@enslo/sd-metadata';
+
+function displayVendor(vendor: C2paVendor): string {
+  return c2paVendorLabels[vendor];
+  // => "OpenAI (ChatGPT)", "Google (Gemini)", "AI-generated (Content Credentials)"
+}
+```
+
+---
+
 ### `EmbedMetadata`
 
 `embed()` と `stringify()` で使用するユーザー作成カスタムメタデータ型。`GenerationMetadata` が既知のAIツールからのパース結果を表すのに対し、`EmbedMetadata` はユーザーが独自にメタデータを組み立てるための型です。`BaseMetadata` にオプションのNovelAIキャラクタープロンプトと設定行への任意キーバリュー（`extras`）を追加。

package/docs/types.md

@@ -10,6 +10,8 @@ Complete type reference for `@enslo/sd-metadata`.
   - [`ParseResult`](#parseresult)
   - [`GenerationMetadata`](#generationmetadata)
   - [`GenerationSoftware`](#generationsoftware)
+  - [`C2paMetadata`](#c2pametadata)
+  - [`C2paVendor`](#c2pavendor)
   - [`EmbedMetadata`](#embedmetadata)
   - [`RawMetadata`](#rawmetadata)
   - [`WriteResult`](#writeresult)
@@ -47,6 +49,7 @@ The result type returned by the `read()` function.
 ```typescript
 type ParseResult =
   | { status: 'success'; metadata: GenerationMetadata; raw: RawMetadata }
+  | { status: 'c2pa'; c2pa: C2paMetadata }
   | { status: 'unrecognized'; raw: RawMetadata }
   | { status: 'empty' }
   | { status: 'invalid'; message?: string };
@@ -57,6 +60,8 @@ type ParseResult =
 - **`success`**: Metadata was successfully parsed
   - `metadata`: Unified metadata object
   - `raw`: Original format-specific data for round-trip conversion
+- **`c2pa`**: Image carries C2PA Content Credentials (AI provenance) but no parseable generation metadata
+  - `c2pa`: `C2paMetadata` describing the declared (unverified) provenance. There is no `raw` field — the signed manifest is not exposed for round-trip writing.
 - **`unrecognized`**: Image has metadata but format is not recognized
   - `raw`: Original metadata is preserved
 - **`empty`**: No metadata found in the image
@@ -75,7 +80,14 @@ switch (result.status) {
     console.log(`Generated by ${result.metadata.software}`);
     console.log(`Prompt: ${result.metadata.prompt}`);
     break;
-  
+
+  case 'c2pa':
+    // Content Credentials detected (e.g. OpenAI ChatGPT, Google Gemini).
+    // Detection only — the signature is NOT verified.
+    console.log(`Provenance vendor: ${result.c2pa.vendor} (unverified)`);
+    console.log(`Claim generator: ${result.c2pa.claimGenerator ?? 'unknown'}`);
+    break;
+
   case 'unrecognized':
     console.log('Unknown metadata format');
     break;
@@ -172,6 +184,73 @@ function displaySoftware(software: GenerationSoftware): string {
 
 ---
 
+### `C2paMetadata`
+
+Content Credentials (C2PA) read from an image's signed provenance manifest.
+
+This is returned by `read()` as `{ status: 'c2pa', c2pa }` for images that carry a C2PA manifest — currently **OpenAI ChatGPT** and **Google Gemini** — but no parseable generation metadata. Unlike `GenerationMetadata`, it carries **no prompt, seed, model, or size**: these tools embed provenance, not generation parameters. `C2paMetadata` does **not** extend `BaseMetadata`.
+
+```typescript
+export interface C2paMetadata {
+  /** Coarse vendor attribution from the manifest's claim generator / signer. */
+  vendor: C2paVendor;
+  /**
+   * `true` when the manifest declares a trained-algorithmic (AI-generated)
+   * IPTC DigitalSourceType. Camera/scan source types are not flagged.
+   */
+  aiGenerated: boolean;
+  /** Raw IPTC DigitalSourceType URI, surfaced verbatim when present. */
+  digitalSourceType?: string;
+  /** C2PA `claim_generator_info.name`, when present. */
+  claimGenerator?: string;
+}
+```
+
+> **Important — detection only, not verification.** Presence of Content Credentials is not proof of authenticity (the strings are forgeable). Absence is not proof of human origin either: Content Credentials are routinely stripped by screenshots, social-media re-uploads, and re-encoding.
+>
+> **PNG only today.** The manifest is read from the PNG `caBX` chunk; JPEG/WebP support is planned.
+
+**Example:**
+
+```typescript
+import { read, c2paVendorLabels } from '@enslo/sd-metadata';
+
+const result = read(imageData);
+
+if (result.status === 'c2pa') {
+  const { vendor, aiGenerated, claimGenerator } = result.c2pa;
+  console.log('Vendor:', c2paVendorLabels[vendor]);
+  console.log('Declared AI-generated:', aiGenerated);
+  console.log('Claim generator:', claimGenerator ?? 'unknown');
+}
+```
+
+---
+
+### `C2paVendor`
+
+Coarse vendor attribution for an image's C2PA Content Credentials. Used as the `vendor` discriminator on [`C2paMetadata`](#c2pametadata) and as the key type for `c2paVendorLabels`.
+
+```typescript
+export type C2paVendor = 'openai' | 'google' | 'unknown';
+```
+
+By design this is coarse: a C2PA manifest identifies the producing vendor (`'openai'` → ChatGPT, `'google'` → Gemini, `'unknown'` → an AI-generated manifest whose vendor is not specifically recognized) but **not** the specific model.
+
+**Example:**
+
+```typescript
+import { c2paVendorLabels } from '@enslo/sd-metadata';
+import type { C2paVendor } from '@enslo/sd-metadata';
+
+function displayVendor(vendor: C2paVendor): string {
+  return c2paVendorLabels[vendor];
+  // => "OpenAI (ChatGPT)", "Google (Gemini)", "AI-generated (Content Credentials)"
+}
+```
+
+---
+
 ### `EmbedMetadata`
 
 User-created custom metadata for the `embed()` and `stringify()` functions. While `GenerationMetadata` represents parsed output from a known AI tool, `EmbedMetadata` is designed for composing metadata from scratch. Extends `BaseMetadata` with optional NovelAI character prompts and arbitrary key-value extras for the settings line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enslo/sd-metadata",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "description": "Read and write AI-generated image metadata",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,7 +55,7 @@
   "devDependencies": {
     "@biomejs/biome": "catalog:",
     "@types/node": "catalog:",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/coverage-v8": "^4.1.8",
     "tsdown": "catalog:",
     "typescript": "catalog:",
     "vitest": "catalog:"