feat: additional builder methods (#34)

* feat: additional builder methods

* chore: changeset

Author: emensch

.changeset/busy-buckets-play.md

@@ -0,0 +1,6 @@
+---
+'@contentauth/c2pa-wasm': patch
+'@contentauth/c2pa-web': patch
+---
+
+Add builder methods: setRemoteUrl, setNoEmbed, and setThumbnailFromBlob

packages/c2pa-wasm/src/wasm_builder.rs

@@ -46,8 +46,8 @@ impl WasmBuilder {
     /// The URL must return the manifest data and is injected into the destination asset when signing.
     /// For remote-only manifests, set the `no_embed` flag to `true`.
     #[wasm_bindgen(js_name = setRemoteUrl)]
-    pub fn set_remote_url(&mut self, format: &str) {
-        self.builder.set_remote_url(format);
+    pub fn set_remote_url(&mut self, url: &str) {
+        self.builder.set_remote_url(url);
     }
 
     /// Sets the state of the no_embed flag.

packages/c2pa-web/src/lib/builder.spec.ts

@@ -10,7 +10,7 @@
 import { describe, expect, test } from 'vitest';
 import { createC2pa } from './c2pa.js';
 
-import wasmSrc from '@contentauth/c2pa-wasm/assets/c2pa_bg.wasm?url';
+import wasmSrc from '@contentauth/c2pa-web/resources/c2pa.wasm?url';
 import { ManifestDefinition } from '@contentauth/c2pa-types';
 
 describe('builder', () => {

packages/c2pa-web/src/lib/builder.ts

@@ -28,6 +28,29 @@ export interface BuilderFactory {
  * Exposes methods for building C2PA manifests and signing assets.
  */
 export interface Builder {
+  /**
+   * Sets the remote URL for a remote manifest. The manifest is expected to be available at this location.
+   *
+   * @param url URL pointing to the location the remote manifest will be stored.
+   */
+  setRemoteUrl: (url: string) => Promise<void>;
+
+  /**
+   * Sets the state of the no_embed flag. To skip embedding a manifest (e.g. for the remote-only case) set this to `true`.
+   *
+   * @param noEmbed Value to set the no_embed flag.
+   * @returns
+   */
+  setNoEmbed: (noEmbed: boolean) => Promise<void>;
+
+  /**
+   * Set a thumbnail from a blob to be included in the manifest. The blob should represent the asset being signed.
+   *
+   * @param format Format of the thumbnail
+   * @param blob Blob of the thumbnail bytes
+   */
+  setThumbnailFromBlob: (format: string, blob: Blob) => Promise<void>;
+
   /**
    * Add an ingredient to the builder from a definition, format, and blob.
    * Values specified in the ingredient definition will be merged with the ingredient, and these values take precendence.
@@ -103,6 +126,18 @@ function createBuilder(
   const { tx } = worker;
 
   return {
+    async setRemoteUrl(url) {
+      await tx.builder_setRemoteUrl(id, url);
+    },
+
+    async setNoEmbed(noEmbed) {
+      await tx.builder_setNoEmbed(id, noEmbed);
+    },
+
+    async setThumbnailFromBlob(format, blob) {
+      await tx.builder_setThumbnailFromBlob(id, format, blob);
+    },
+
     async addIngredientFromBlob(
       ingredientDefinition: Ingredient,
       format: string,

packages/c2pa-web/src/lib/reader.spec.ts

@@ -10,7 +10,7 @@
 import { describe, expect, test } from 'vitest';
 import { createC2pa } from './c2pa.js';
 import { Settings } from './settings.js';
-import wasmSrc from '@contentauth/c2pa-wasm/assets/c2pa_bg.wasm?url';
+import wasmSrc from '@contentauth/c2pa-web/resources/c2pa.wasm?url';
 
 import C_with_CAWG_data from '../../test/fixtures/assets/C_with_CAWG_data.jpg';
 import C_with_CAWG_data_thumbnail from '../../test/fixtures/assets/C_with_CAWG_data_thumbnail.jpg';

packages/c2pa-web/src/lib/worker.ts

@@ -72,6 +72,18 @@ rx({
     const builderId = builderMap.add(builder);
     return builderId;
   },
+  builder_setRemoteUrl(builderId, url) {
+    const builder = builderMap.get(builderId);
+    builder.setRemoteUrl(url);
+  },
+  builder_setNoEmbed(builderId, noEmbed) {
+    const builder = builderMap.get(builderId);
+    builder.setNoEmbed(noEmbed);
+  },
+  builder_setThumbnailFromBlob(builderId, format, blob) {
+    const builder = builderMap.get(builderId);
+    builder.setThumbnailFromBlob(format, blob);
+  },
   builder_addIngredientFromBlob(builderId, json, format, blob) {
     const builder = builderMap.get(builderId);
     builder.addIngredientFromBlob(json, format, blob);

packages/c2pa-web/src/lib/worker/rpc.ts

@@ -35,6 +35,13 @@ const { createTx, rx } = channel<{
   builder_fromJson: (json: string) => number;
 
   // Builder methods
+  builder_setRemoteUrl: (builderId: number, url: string) => void;
+  builder_setNoEmbed: (builderId: number, noEmbed: boolean) => void;
+  builder_setThumbnailFromBlob: (
+    builderId: number,
+    format: string,
+    blob: Blob
+  ) => void;
   builder_addIngredientFromBlob: (
     builderId: number,
     json: string,