Integration Tests for Published SDKs v0.2.0

[bafu]

Overview

Created integration test scripts to verify the published SDK packages work correctly after release. Both TypeScript (npm) and Python (PyPI) packages were tested with the complete workflow.

Files Created

integration-tests/
├── package.json           # npm dependencies
├── requirements.txt       # Python dependencies
├── test-published-sdk.ts  # TypeScript integration test
├── test_published_sdk.py  # Python integration test
└── README.md              # Setup and usage instructions

Test Workflow

Both scripts perform the same workflow:

1. Generate Test Image - Creates a PNG image with current timestamp
2. Register Image - Uploads and registers with Numbers Protocol API
3. Update Metadata - Updates the asset's headline to "SDK Test v0.2.0"
4. Verify Engine Search - Searches for the asset by NID
5. Get Asset Tree - Retrieves provenance data

How to Run

Prerequisites

export CAPTURE_TOKEN=your_token_here

TypeScript

cd integration-tests
npm install
npm run test:ts

Python

cd integration-tests
pip install -r requirements.txt
python test_published_sdk.py

Test Results (2026-01-30)

TypeScript SDK (@numbersprotocol/capture-sdk@0.2.0)

Step	Status	Details
Generate Image	✅ PASS	test-image-1769772200385.png (7655 bytes)
Register	✅ PASS	NID: bafkreigja7va5vhvqhbloxfr2tnypydvsyud4gfu7hspyyp72fsfejmkui
Update Headline	✅ PASS	Set to "SDK Test v0.2.0"
Verify Engine	⚠️ AUTH issue	API backend issue (see note below)
Asset Tree	✅ PASS	Retrieved asset CID

Asset URL: https://verify.numbersprotocol.io/asset-profile/bafkreigja7va5vhvqhbloxfr2tnypydvsyud4gfu7hspyyp72fsfejmkui

Python SDK (numbersprotocol-capture-sdk==0.2.0)

Step	Status	Details
Generate Image	✅ PASS	test-image-1769772326.png (4622 bytes)
Register	✅ PASS	NID: bafkreicsw2vy4dn4grk6qpcsmblrllojp7ylc25kibru2pdy6ryl4su6iy
Update Headline	✅ PASS	Set to "SDK Test v0.2.0"
Verify Engine	⚠️ AUTH issue	API backend issue (see note below)
Asset Tree	✅ PASS	Pending blockchain confirmation (expected)

Asset URL: https://verify.numbersprotocol.io/asset-profile/bafkreicsw2vy4dn4grk6qpcsmblrllojp7ylc25kibru2pdy6ryl4su6iy

Note on Verify Engine

The searchAsset API returned "Authentication credentials were not provided." This appears to be a backend API issue, not an SDK problem. The SDK correctly sends the token in the form data as per the API specification:

const formData = new FormData()
formData.append('token', this.token)

The core SDK functionality (register, update, get, getAssetTree) works correctly. The verify engine search is a non-critical feature that may require backend investigation.

Conclusion

✅ Both published SDK packages (v0.2.0) are working correctly for the core functionality:

• Asset registration
• Metadata updates
• Asset retrieval
• Asset tree/provenance data

The integration tests provide a reliable way to verify future releases.

[bafu]

Bug Found and Fixed: Verify Engine Authentication

During integration testing, we discovered that the searchAsset / search_asset methods were failing with:

Authentication credentials were not provided.

Root Cause

The SDK was incorrectly sending the authentication token in the form data instead of the HTTP Authorization header.

Documentation: https://docs.numbersprotocol.io/developers/verify-engine-api/

The Verify Engine API requires:

Authorization: token YOUR_CAPTURE_TOKEN

Fix Applied in v0.2.1

TypeScript (ts/src/client.ts):

// Fixed: Token now sent in Authorization header
const response = await fetch(ASSET_SEARCH_API_URL, {
  method: 'POST',
  headers: {
    Authorization: `token ${this.token}`,
  },
  body: formData,
})

Python (python/numbersprotocol_capture/client.py):

# Fixed: Token now sent in Authorization header
headers = {"Authorization": f"token {self._token}"}
response = self._client.post(
    ASSET_SEARCH_API_URL,
    headers=headers,
    data=form_data,
)

Updated Test Results (v0.2.1)

Step	TypeScript	Python
Generate Image	✅ PASS	✅ PASS
Register	✅ PASS	✅ PASS
Update Headline	✅ PASS	✅ PASS
Verify Engine	✅ PASS	✅ PASS
Asset Tree	✅ PASS	✅ PASS

Release

v0.2.1 has been released with this fix:

• npm: @numbersprotocol/capture-sdk@0.2.1
• PyPI: numbersprotocol-capture-sdk==0.2.1

The integration tests have been updated to require v0.2.1+.