Refresh integration examples to the current API

[greatest0fallt1me]

Summary

examples/client-usage.ts, examples/billing-api-integration.ts and examples/complete-integration.ts are referenced in README, but they are not type-checked or executed in CI, and src/tests/complete-integration.test.ts covers only part of them.

Why this matters

Out-of-date examples mislead integrators about request bodies, headers and error envelopes.

Scope

Add examples/ to a tsconfig used by npm run typecheck, update code to current request/response shapes (success envelope, Idempotency-Key usage), and extend the integration test to execute each example against createApp.

Relevant code in CalloraOrg/Callora-Backend:

• examples/client-usage.ts
• examples/billing-api-integration.ts
• examples/README.md
• src/__tests__/complete-integration.test.ts

Priority

Low

Acceptance criteria

• Examples compile under typecheck
• Each example runs against createApp in a test
• examples/README.md lists prerequisites
• Examples use the documented envelope fields

Validation

Run npm run typecheck and npm test -- src/__tests__/complete-integration.test.ts.

Non-goals

• Typo-only, formatting-only, or cosmetic changes.
• Unrelated refactors, dependency upgrades, or broad rewrites.
• Removing safeguards or weakening validation to make tests pass.

Contributor application

Before coding, describe the affected modules, proposed state/invariant changes, test strategy, compatibility considerations, and an estimate. Wait for assignment before starting implementation.

PR requirements

Use a feature branch and include Closes #<issue-number>. Address every criterion, map criteria to code and tests, explain security and failure-mode handling, and ensure CI passes.

Quality review

A maintainer will assess correctness, completeness, test depth, compatibility, observability, and adverse-case handling. A substantive implementation is required; merge or CI status alone does not guarantee reward eligibility.

---

Generated by Claude Code

[shobhamerabacha-star]

Hey team,

I can tackle Refresh integration examples to the current API. Proposed implementation roadmap:

• Analysis: Inspect current behavior and edge cases in CalloraOrg/Callora-Backend
• Core Implementation: Implement backend logic for Refresh integration examples to the current API with strict schema validation and idempotent execution.
• Quality Assurance: Add integration test suites for standard invocations and boundary/error conditions.

Looking forward to collaborating on this—please assign!

[EmperorNexus]

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

Hello Maintainer, I’d like to work on this task.

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

[edochieblessing09-max]

@edochieblessing09-max has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

I’m available to work on this issue and can start right away

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