receipt-payload

[Daniel-Ric]

Motivation

• Receipt parsing needed to accept additional real-world shapes such as stringified Receipt payloads, nested receipt fields, and prefixed JWTs to avoid brittle inventory creator detection.
• The creators/top aggregation needed to account for direct creatorId/creatorID fields in entitlement entries in addition to embedded receipt parsing.

Description

• Added and exported extractReceiptEntitlements in src/services/minecraft.service.js that normalizes receipts by stripping Bearer/JWT prefixes, decoding JWTs with {complete: true, json: true}, parsing stringified Receipt values, handling unpadded base64url payloads, and recursively unwrapping nested receipt objects.
• Updated src/routes/inventory.routes.js to use extractReceiptEntitlements and to count direct creatorId/creatorID fields before attempting receipt decoding.
• Adjusted imports to export and use extractReceiptEntitlements and added jsonwebtoken usage within the service only (no new dependencies beyond existing ones).
• Added unit tests in tests/messaging.test.js covering prefixed JWTs, JWTs with a stringified Receipt payload, nested receipt strings, JSON, base64, and object receipts.

Testing

• Ran the test suite with npm test and all automated tests passed successfully.
• Test run summary: 14 tests, 0 failures, including the new receipt parsing test cases in tests/messaging.test.js.

---

Codex Task