Package
@flashy/sdk
@flashy/sdk — a zero-dependency, type-safe client for ClaimYour.Gold’s Hunter Identity API: report engagement (create a skill event) and read a public hunter record, from other systems. Every engagement requires an idempotency key and the server, never the caller, prices the activity.
version 0.1.0 · measured 2026-10-19 from a checkout · source: flashy-sdk
npm i @flashy/sdk — prepared, not yet publishedIdempotency is not optional and the server prices activity: reportEngagement requires an idempotencyKey and accepts only customerId, activity, sourceProduct, sourceRef and that key — no skill, amount or value parameter exists, so a caller that tries to influence the price has no way to do so. A replay with the same key returns { deduplicated: true } and must be treated as success.
Zero runtime dependencies, and every code example is tested: the README’s reportEngagement and getHunterRecord examples use the same routes, fields and idempotency-key shape the suite exercises, and a test fails if the prose drifts from what the tests check. The injectable fetch means the suite needs no running ClaimYour.Gold.
Edge cases — each one paid for once
The types hand-mirror the contract until they are generated
The SDK’s types mirror specs/hunter-identity.v1.yaml in flashy-contracts by hand; a drift test reads the sibling spec when it is checked out beside the SDK and fails on a route or field the types carry that the spec does not — reporting UNKNOWN, never passed, when the sibling is absent.