fix: add missing metadata fields to /execute/ payload and clean up consent status request

[sd-gh-bot]

User description

Summary

Fixes two gaps identified in the mobile SDK vs API alignment analysis.

Gap 1 — /execute/ payload missing 6 optional fields (Critical)

The SpotDraft backend POST .../execute/ endpoint accepts first_name, last_name, user_email, additional_custom_information, key_pointer_information, and external_metadata but the SDK was silently dropping all of them. Teams that need custom metadata or user-detail capture on consent records were completely blocked.

Changes:

File	Change
ClickwrapSubmitMetadata	New public model with 6 optional fields
SubmissionRequestModel / RequestBody	Added all 6 optional fields; null values are omitted from the JSON payload — backward-compatible
ClickwrapRepository (interface + impl)	Accept and forward ClickwrapSubmitMetadata?
ClickwrapService.submitAcceptance()	Accept and forward ClickwrapSubmitMetadata?
SpotDraftManager.submitAcceptance()	New optional metadata parameter (default nil/null) — backward-compatible

Gap 2 — ConsentStatusRequest sending unused fields (Minor / Cleanup)

ConsentStatusRequest was sending additional_custom_information, key_pointer_information, and agreements to POST .../consent_status/ which the API does not consume. Stripped back to user_identifier only to keep the wire format accurate.

---

How to validate

1. Backward-compatibility — existing call sites still compile unchanged

// iOS — no change needed from callers
SpotDraftManager.submitAcceptance(userIdentifier: userId)

// Android — no change needed from callers
SpotDraftManager.submitAcceptance(userIdentifier = userId)

2. New metadata path — pass metadata and verify it reaches the backend

// iOS
let metadata = ClickwrapSubmitMetadata(
    firstName: "Jane",
    lastName: "Doe",
    userEmail: "jane@example.com",
    additionalCustomInformation: ["plan": "enterprise"],
    keyPointerInformation: ["contractRef": "MSA-2024"],
    externalMetadata: ["crmId": "SF-00001"]
)
SpotDraftManager.submitAcceptance(userIdentifier: userId, metadata: metadata)

// Android
val metadata = ClickwrapSubmitMetadata(
    firstName = "Jane",
    lastName = "Doe",
    userEmail = "jane@example.com",
    additionalCustomInformation = mapOf("plan" to "enterprise"),
    keyPointerInformation = mapOf("contractRef" to "MSA-2024"),
    externalMetadata = mapOf("crmId" to "SF-00001")
)
SpotDraftManager.submitAcceptance(userIdentifier = userId, metadata = metadata)

Enable SDK logging (enableLogging = true in ClickwrapConfig) and confirm the POST body printed to the log includes the metadata fields.

3. Verify consent status request is slim

Enable logging and confirm POST .../consent_status/ body is {"user_identifier": "<id>"} only.

4. Integration test against staging

Point baseURL to the staging environment, trigger submitAcceptance with metadata, and confirm the created contract record on the SpotDraft dashboard shows the custom information fields populated.

---

References: Gap analysis — [mobile-sdk-api-gap-analysis.md]

---

Generated description

Below is a concise technical summary of the changes proposed in this PR:
Enable optional metadata to flow through SpotDraftManager, ClickwrapService, ClickwrapRepository, and SubmissionRequestModel so the /execute/ endpoint can capture the six custom consent fields. Clarify ConsentStatusRequest to only send user_identifier to keep the consent status payload aligned with the API.

Topic	Details
Consent status payload	Trim the ConsentStatusRequest body to only include user_identifier to reflect the backend contract. Modified files (1) spotdraftclickwrap/src/main/java/com/app/android/clickwrap/networking/models/request/ConsentStatusRequest.kt Latest Contributors(2) User Commit Date neo@spotdraft.com fix: add missing metad... May 18, 2026 himanshu.m@tequity.tech Initial commit November 17, 2025
Metadata submission	Enable metadata fields captured by ClickwrapSubmitMetadata to pass through the manager, service, repository, and request model so custom user and contract context reaches the /execute/ endpoint. Modified files (5) spotdraftclickwrap/src/main/java/com/app/android/clickwrap/core/ClickwrapService.kt spotdraftclickwrap/src/main/java/com/app/android/clickwrap/core/SpotDraftManager.kt spotdraftclickwrap/src/main/java/com/app/android/clickwrap/domain/models/ClickwrapSubmitMetadata.kt spotdraftclickwrap/src/main/java/com/app/android/clickwrap/networking/models/request/SubmissionRequestModel.kt spotdraftclickwrap/src/main/java/com/app/android/clickwrap/repository/ClickwrapRepository.kt Latest Contributors(2) User Commit Date neo@spotdraft.com fix: add missing metad... May 18, 2026 himanshu.m@tequity.tech Initial commit November 17, 2025

_{Review this PR on Baz | Customize your next review}