SKILL.md
Runtime & HTTP – Contentstack Dart SDK
When to use
- Changing how requests are built or executed
- Working with
http, headers, hosts/regions, or error mapping from responses - Adjusting runtime dependencies (
pubspec.yaml) or environment loading (dotenv)
Instructions
HTTP stack
- HTTP calls use the
httppackage—keep usage consistent with Dart async/await patterns elsewhere inlib/src/ - Do not introduce an alternate HTTP client for the same code paths without team agreement
Configuration
dotenvis used in tests and may be used for local/dev configuration—never commit real credentials ([../testing/SKILL.md](../testing/SKILL.md))pathandfilesupport path handling where needed; keep imports minimal
Logging
loggeris a dependency; avoid logging sensitive tokens or full auth headers
Packaging
- Keep
pubspec.yamlconstraints coherent with Dart SDK bounds (>=2.12.0 <4.0.0) - Publishing flow: see [.github/workflows/publish.yml](../../.github/workflows/publish.yml)
Retries and resilience
- If adding retries, backoff, or timeouts, document behavior in public API or internal modules and add tests where feasible
References
- [../contentstack-dart-sdk/SKILL.md](../contentstack-dart-sdk/SKILL.md)
- http package
- [../dev-workflow/SKILL.md](../dev-workflow/SKILL.md)