SDK v1.0.0 API-stability sweep

[truthixify]

Extra labels: dx, release
Tier: M (2-4 days) | Type: refactor

Context. Companions declare ^0.x; consumers keep breaking on minor bumps. Before v1.0, mark the public surface, audit exports, snapshot via api-extractor, gate PRs on the snapshot.

Scope.

• Enumerate public surface in src/index.ts; mark internal helpers @internal.
• Add @microsoft/api-extractor; snapshot at etc/sdk.api.md.
• CI blocks a PR that changes surface without updating snapshot.
• Companions' peerDependencies pin @wraith-protocol/sdk >=1.0.0 <2.

Acceptance.

• pnpm api:check passes on develop
• CI fails on undocumented public-API drift
• Companion peer ranges updated

Files. src/index.ts, api-extractor.json (new), etc/sdk.api.md (new), .github/workflows/ci.yml.

[chinecherem58]

@chinecherem58 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer I will like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @chinecherem58 to this issue.

[Chrisland58]

@Chrisland58 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer I will like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Chrisland58 to this issue.

[Neche58]

@Neche58 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

hi maintainer i will like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Neche58 to this issue.

[Meme11030]

@Meme11030 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer please I will like to work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Meme11030 to this issue.

[code3ks]

@code3ks has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

i want to work on this issue Asap

ℹ️ Repo Maintainers: To accept this application, review their application or assign @code3ks to this issue.

[drips-wave]

Congratulations, @code3ks! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @code3ks: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊