feat: expose deal ID as replica ID

Closes: #216

README.md

@@ -140,6 +140,7 @@ curl http://localhost:40080/v0/blob/ad7ef987-a932-495c-aa0c-7ffcabeda45f/status
   "id": "ad7ef987-a932-495c-aa0c-7ffcabeda45f",
   "replicas": [
     {
+      "id": 1,
       "provider": "f1234",
       "status": "active",
       "lastVerified": "2020-12-01T22:48:00Z",

api/model.go

@@ -22,6 +22,7 @@ type (
 		Pieces   []Piece `json:"pieces"`
 	}
 	Piece struct {
+		Id           int64     `json:"id"`
 		Expiration   time.Time `json:"expiration"`
 		LastVerified time.Time `json:"lastVerified"`
 		PieceCID     string    `json:"pieceCid"`

api/server/handler.go

@@ -158,6 +158,7 @@ func (m *HttpServer) handleBlobGetStatusByID(w http.ResponseWriter, r *http.Requ
 			apiPieces := make([]api.Piece, 0, len(replica.Pieces))
 			for _, piece := range replica.Pieces {
 				apiPieces = append(apiPieces, api.Piece{
+					Id:           piece.Id,
 					Expiration:   piece.Expiration,
 					LastVerified: piece.LastUpdated,
 					PieceCID:     piece.PieceCID,

blob/blob.go

@@ -15,9 +15,7 @@ var (
 	ErrBlobNotFound = errors.New("no blob is found with given ID")
 )
 
-var (
-	logger = log.Logger("motion/blobstore")
-)
+var logger = log.Logger("motion/blobstore")
 
 type (
 	// ID uniquely identifies a blob.
@@ -37,6 +35,7 @@ type (
 		Pieces   []Piece
 	}
 	Piece struct {
+		Id          int64
 		Expiration  time.Time
 		LastUpdated time.Time
 		PieceCID    string

integration/singularity/store.go

@@ -519,6 +519,7 @@ func (s *SingularityStore) Describe(ctx context.Context, id blob.ID) (*blob.Desc
 			updatedAt = time.Time{}
 		}
 		piece := blob.Piece{
+			Id:          deal.ID,
 			Expiration:  epochutil.EpochToTime(int32(deal.EndEpoch)),
 			LastUpdated: updatedAt,
 			PieceCID:    deal.PieceCid,

openapi.yaml

@@ -112,6 +112,9 @@ paths:
                           items:
                             type: object
                             properties:
+                              id:
+                                type: integer
+                                description: 'Unique, opaque identifier for the replica.'
                               expiration:
                                 type: string
                                 format: date-time
@@ -133,7 +136,8 @@ paths:
                     replica:
                         provider: 'f0xxxx'
                         pieces: 
-                          - expiration: '2023-06-29T00:00:00Z'
+                          - id: 1
+                            expiration: '2023-06-29T00:00:00Z'
                             lastVerified: '2023-05-29T00:00:00Z'
                             pieceCid: 'baguqexxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
                             status: 'active'