feat(pdp): add /piece/{cid}/status to get indexing & ipni status for piece

[rvagg]

This is just an experiment for now.

See Slack thread for more info.

[rvagg]

Querying this endpoint for a pieceCID that I'm in the process of uploading and committing every second I get:

Piece not found or does not belong to service
Piece not found or does not belong to service
Piece not found or does not belong to service
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"pending","indexed":false,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"pending","indexed":false,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"pending","indexed":false,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"indexing","indexed":false,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"creating_ad","indexed":true,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"creating_ad","indexed":true,"advertised":false,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"announced","indexed":true,"advertised":true,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"announced","indexed":true,"advertised":true,"retrieved":false}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"retrieved","indexed":true,"advertised":true,"retrieved":true,"retrievedAt":"2025-10-11T13:35:26.541494+02:00"}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"retrieved","indexed":true,"advertised":true,"retrieved":true,"retrievedAt":"2025-10-11T13:35:26.541494+02:00"}
{"pieceCid":"bafkzcibdy4hapci46px57mg3znrwydsv7x7rxisg7l7ti245wxwwfmiftgmdmbqk","status":"retrieved","indexed":true,"advertised":true,"retrieved":true,"retrievedAt":"2025-10-11T13:35:26.541494+02:00"}

[rvagg]

What this can't tell you is who pulled the advertisement (which index provider) or when they ingest, process and publish it. So there's still a gap that would have to be solved but a fixed timeout.