feat(checkout): add useIdentityVerificationCredentials hook to react and react-native

[AngelPaella]

Closes ENG4-373

getIdentityVerificationCredentials was the only camelCase non-hook export in either UI package, so merchants plumbed the order themselves:

const { order } = useCrossmintCheckout();
const credentials = getIdentityVerificationCredentials(order);

Each package now has a hook that reads the checkout context, so a merchant writes one line at the single call site where they wire the external-KYC flow:

const credentials = useIdentityVerificationCredentials();

The plain function stays exported. react-ui@4.4.0 already ships it, and it works on any order object (a server fetch, a webhook payload, the server SDK) where a hook cannot run. The hook calls it.

Notes

• I duplicated the hook per package instead of sharing it. useCrossmintCheckout carries its own CrossmintCheckoutContext in each, one driven by postMessage and one by localEventEmitter.
• I switched the React Native CrossmintIdentityVerification doc example over to the hook, since that example is the call site this is for.
• I skipped a test. The hook is useContext plus a pure accessor that client-sdk-base already covers, and the build checks the return type (IdentityVerificationCredentials | undefined).
• Stacked on feat(react-native): identity verification component and takeover flag #2019. The React Native half edits regions of examples.json and generate-reference.mjs that feat(react-native): identity verification component and takeover flag #2019 introduces, so a branch off main would conflict. GitHub retargets this to main once feat(react-native): identity verification component and takeover flag #2019 merges.

Verification

• pnpm turbo build on both packages. The hook lands in each dist/index.d.ts returning IdentityVerificationCredentials | undefined.
• pnpm generate:docs on both. The generated checkout hooks page includes the hook with its JSDoc description and example.
• pnpm turbo test:vitest on client-sdk-base, react-ui and react-native-ui: 41 tests pass.

[changeset-bot]

🦋 Changeset detected

Latest commit: 65d34a0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages

Name	Type
@crossmint/client-sdk-react-ui	Minor
@crossmint/client-sdk-react-native-ui	Minor
@crossmint/auth-ssr-nextjs-demo	Patch
@crossmint/client-sdk-nextjs-starter	Patch
@crossmint/wallets-quickstart-devkit	Patch
@crossmint/wallets-playground-react	Patch
@crossmint/wallets-playground-expo	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[greptile-apps]

Prompt To Fix All With AI

### Issue 1
packages/client/ui/react-native/examples.json:75-78
**Documentation mixed with implementation**

These user-facing examples are bundled with the hook implementation, preventing the feature and documentation from being reviewed, reverted, or released independently. Repository policy requires documentation changes to be submitted in a separate pull request; the same pattern also occurs in the React example and the rewritten React Native identity-verification example.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

_{Reviews (1): Last reviewed commit: "feat(checkout): add useIdentityVerificat..." | Re-trigger Greptile}

[greptile-apps]

Documentation mixed with implementation

These user-facing examples are bundled with the hook implementation, preventing the feature and documentation from being reviewed, reverted, or released independently. Repository policy requires documentation changes to be submitted in a separate pull request; the same pattern also occurs in the React example and the rewritten React Native identity-verification example.

Rule Used: Documentation changes should be separated into the... (source)

Learned From
Paella-Labs/crossbit-main#20976

Prompt To Fix With AI

This is a comment left during a code review.
Path: packages/client/ui/react-native/examples.json
Line: 75-78

Comment:
**Documentation mixed with implementation**

These user-facing examples are bundled with the hook implementation, preventing the feature and documentation from being reviewed, reverted, or released independently. Repository policy requires documentation changes to be submitted in a separate pull request; the same pattern also occurs in the React example and the rewritten React Native identity-verification example.

**Rule Used:** Documentation changes should be separated into the... ([source](https://app.greptile.com/crossmint/-/custom-context?memory=ce1a162d-c5de-43f7-a3c8-fc554e479bf6))

**Learned From**
[Paella-Labs/crossbit-main#20976](https://github.com/Paella-Labs/crossbit-main/pull/20976)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!