feat: add settings structs to the public API (#1447)

* feat: add settings structs to public API

* feat: add json schemas for settings structs

* docs: document all settings structs and fields

* docs: document settings modules

* docs: finishing documenting settings structs and fix doc lints

* docs: document main settings struct fields

* fix: naming and old field tests

* fix: add back trust.verify_trust_list

* fix: doc verify setting warnings, private icon resource, single integer for version

* fix: specify claim generator info operating system as enum

* fix: example settings files

* docs: clarify `verify_trust` doesn't include `verify_timestamp_trust`

* docs: improve certificate status fetch/override docs

* docs: clarify ocsp_fetch and certificate status settings

* fix: private `OcspFetchScope`

* docs: clarify `remote_manifest_fetch` docs

* docs: clarify thumbnail settings

* fix: use LLVM triples as claim generator OS convention

* docs: remove hidden attribute for pub(crate) fields and clean up

* fix: add c2pa-kp-claimSigning OID to trusted EKUs

* fix: don't serde skip builder.actions, only schemars skip

* fix: feature flag schemars(skip)

* fix: export settings in export_schema

* test: disable certificate status fetch by default in tests

* docs: add more docs to intent and created_assertion_labels

* fix: import settings in export_schema

* fix: pub(crate) verify trust settings and document CAWG trust option

Author: ok-nick

cli/tests/fixtures/trust/cawg_sign_settings.toml

@@ -1,8 +1,7 @@
 # c2pa-rs Configuration File
 
 # Version information.
-version_major = 1
-version_minor = 0
+version = 1
 
 # Trust settings for certificate validation.
 # [trust]
@@ -220,13 +219,13 @@ xPd7wFhjRZHfuWb2cs63xjAGjQ==
 """
 # String to trust configuration.
 trust_config = """
-//id-kp-emailProtection 
+//id-kp-emailProtection
 1.3.6.1.5.5.7.3.4
-//id-kp-documentSigning 
+//id-kp-documentSigning
 1.3.6.1.5.5.7.3.36
-//id-kp-timeStamping 
+//id-kp-timeStamping
 1.3.6.1.5.5.7.3.8
-//id-kp-OCSPSigning 
+//id-kp-OCSPSigning
 1.3.6.1.5.5.7.3.9
 // MS C2PA Signing
 1.3.6.1.4.1.311.76.59.1.9
@@ -418,8 +417,8 @@ name = "c2pa-rs testing"
 version = "1.0.0"
 # The operating system the claim generator is running on.
 #operating_system.name = "macOS"
-# Or if the name isn't specified, it can be inferred automatically.
-operating_system.infer = true
+# Or specify "auto" to infer the operating system automatically.
+operating_system = "auto"
 # Arbitrary fields can also be defined.
 #
 # By default, the SDK adds a field "org.cai.c2pa_rs" with the value

cli/tests/fixtures/trust/cawg_test_settings.toml

@@ -3,16 +3,18 @@ trusted = true
 
 [trust]
 trust_config = """
-//id-kp-emailProtection 
+//id-kp-emailProtection
 1.3.6.1.5.5.7.3.4
-//id-kp-documentSigning 
+//id-kp-documentSigning
 1.3.6.1.5.5.7.3.36
-//id-kp-timeStamping 
+//id-kp-timeStamping
 1.3.6.1.5.5.7.3.8
-//id-kp-OCSPSigning 
+//id-kp-OCSPSigning
 1.3.6.1.5.5.7.3.9
 // MS C2PA Signing
 1.3.6.1.4.1.311.76.59.1.9
+// c2pa-kp-claimSigning
+1.3.6.1.4.1.62558.2.1
 """
 trust_anchors = """
 -----BEGIN CERTIFICATE-----
@@ -227,9 +229,9 @@ xPd7wFhjRZHfuWb2cs63xjAGjQ==
 
 [cawg_trust]
 trust_config = """
-//id-kp-emailProtection 
+//id-kp-emailProtection
 1.3.6.1.5.5.7.3.4
-//id-kp-documentSigning 
+//id-kp-documentSigning
 1.3.6.1.5.5.7.3.36
 """
 trust_anchors = """

export_schema/src/main.rs

@@ -1,7 +1,7 @@
 use std::{fs, path::Path};
 
 use anyhow::Result;
-use c2pa::{Builder, ManifestDefinition, Reader};
+use c2pa::{settings::Settings, Builder, ManifestDefinition, Reader};
 use schemars::{schema::RootSchema, schema_for};
 
 fn write_schema(schema: &RootSchema, name: &str) {
@@ -24,9 +24,8 @@ fn main() -> Result<()> {
     let reader = schema_for!(Reader);
     write_schema(&reader, "Reader");
 
-    // TODO: no longer json, generate toml schema?
-    // let settings = schema_for!(Settings);
-    // write_schema(&settings, "Settings");
+    let settings = schema_for!(Settings);
+    write_schema(&settings, "Settings");
 
     Ok(())
 }

sdk/examples/c2pa.toml

@@ -1,8 +1,7 @@
 # c2pa-rs Configuration File
 
 # Version information.
-version_major = 1
-version_minor = 0
+version = 1
 
 # # Trust settings for certificate validation.
 # [trust]
@@ -66,9 +65,8 @@ name = "My Service"
 # A human readable string of the product's version.
 version = "1.0.0"
 # The operating system the claim generator is running on.
-operating_system.name = "macOS"
-# Or if the name isn't specified, it can be inferred automatically.
-operating_system.infer = true
+# Or specify "auto" to infer the operating system automatically.
+operating_system = "macOS"
 # Arbitrary fields can also be defined.
 #
 # By default, the SDK adds a field "org.cai.c2pa_rs" with the value