@certivu/sdk 2.0.0 → 2.1.0

package/README.md

@@ -24,12 +24,13 @@ const certivu = new CertivuClient({
   generatorId: 'gen_xyz',
 })
 
-// Sign AI-generated content — returns the watermarked image + token
-const { token, record_id, watermarkedContent } = await certivu.sign({
-  content: imageBuffer,   // Buffer or Uint8Array
+// Sign AI-generated content — returns the signed file + token
+const { token, record_id, signedContent } = await certivu.sign({
+  content: imageBuffer,   // Buffer or Uint8Array (image, audio, or text)
   model: 'stable-diffusion-xl',
+  format: 'image',        // optional — auto-detected from magic bytes if omitted
 })
-// watermarkedContent is a Uint8Array — store and serve this, not the original
+// signedContent is a Uint8Array — serve this, it has provenance embedded
 
 // Verify — token optional, extracted automatically from XMP or watermark
 const result = await certivu.verify({ content: imageBuffer })
@@ -57,17 +58,22 @@ Get your API key and generator credentials at [dashboard.certivu.ai](https://das
 
 ### `certivu.sign(input)`
 
-Signs AI-generated content server-side — watermarking, hashing, and ML-DSA signing all happen in the API. Returns the signed, watermarked image.
+Signs AI-generated content server-side — watermarking, hashing, and ML-DSA signing all happen in the API. Accepts images (JPEG/PNG/WebP), audio (MP3/FLAC/WAV), and text (PDF/HTML/plain text). Returns the signed file with provenance embedded.
 
 ```typescript
-const { token, record_id, watermarkedContent } = await certivu.sign({
-  content: imageBuffer,            // Uint8Array | Buffer
+const { token, record_id, signedContent, format } = await certivu.sign({
+  content: fileBuffer,             // Uint8Array | Buffer
   model: 'stable-diffusion-xl',   // model identifier
   generatorId: 'gen_xyz',         // overrides config.generatorId
+  format: 'image',                // optional — 'image' | 'audio' | 'text', auto-detected if omitted
 })
-// watermarkedContent — Uint8Array with ctv_ token in XMP + DCT watermark embedded
+// signedContent — Uint8Array with provenance embedded (XMP / ID3 / meta tag / ZWC)
+// format — the detected/confirmed format string
+// watermarkedContent — alias for signedContent, kept for backwards compatibility
 ```
 
+Upload limit: 50 MB.
+
 ---
 
 ### `certivu.verify(input)`
@@ -88,11 +94,13 @@ const result = await certivu.verify({
   authentic: boolean,
   tampered: boolean,
   confidence: 'high' | 'medium' | 'low' | 'none',
-  token_source: 'provided' | 'xmp' | 'watermark',
+  token_source: 'provided' | 'xmp' | 'watermark' | 'phash',
+  format?: 'image' | 'audio' | 'text',
   signals: {
     watermark_found: boolean,
     record_found: boolean,
     signature_valid: boolean,
+    phash_match?: boolean,
   },
   provenance: {
     org: string,
@@ -216,7 +224,7 @@ try {
 | `402` | Quota exhausted (free tier) |
 | `403` | Generator doesn't belong to your org |
 | `404` | Generator not found or revoked |
-| `413` | Upload exceeds 20 MB limit |
+| `413` | Upload exceeds 50 MB limit |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@certivu/sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Official SDK for Certivu — quantum-resistant AI content provenance",
   "keywords": ["certivu", "ai", "provenance", "post-quantum", "ml-dsa", "watermark"],
   "homepage": "https://certivu.ai",