Imported from voxgig-sdk/bluefin-payconex-sdk (
kotlin/AGENTS.md). Install upstream withnpx skills add voxgig-sdk/bluefin-payconex-sdk --skill kotlin. Copyright stays with the author.
BluefinPayconex Kotlin — Agent Guide
The Kotlin client for the BluefinPayconex API. This directory is generated — do not edit it by hand; change the model/template/component in .sdk/ and regenerate. See the project guide for the full workflow and the aontu model language.
Paths below (
.sdk/…) are relative to the project root — one level up from thiskotlin/directory.
Regenerate this target
cd ../.sdk
npm run build # only if you changed a component
npm run generate # refreshes this kotlin/ directoryThen build and test the generated output:
# in this target directory (kotlin/):
make build
make testWhat generates this target
| Source | Path | Edit when… |
|---|---|---|
| Target definition | .sdk/model/target/kotlin.aon |
deps, module, extension, phases change |
| Templates | .sdk/tm/kotlin/ |
the file is the same for every API (runtime, transport, base classes) — copied verbatim with placeholder substitution |
| Components | .sdk/src/cmp/kotlin/ |
the file's shape depends on the API (entities, constructor, README, tests) — TypeScript that walks the model |
Decision rule: same for every API → template; depends on the API →
component. After editing a component run npm run build before
npm run generate; template-only edits just need npm run generate.
Features in this target
Each feature is a flat file in the feature/ package. Its hooks and
default activation come from .sdk/model/feature/<name>.aon; customise
the runtime under .sdk/tm/kotlin/feature/ and regenerate.
| Feature | Runtime file | Active hooks |
|---|---|---|
| audit — Structured audit trail of operations | feature/audit_feature.kt |
PreDone, PreUnexpected |
| clienttrack — Client identity and per-request correlation headers | feature/clienttrack_feature.kt |
PostConstruct, PreRequest |
| idempotency — Idempotency keys for safe retries of mutating operations | feature/idempotency_feature.kt |
PreRequest |
| log — Structured request and response logging | feature/log_feature.kt |
GetData, GetMatch, PostConstruct, PostConstructEntity, PrePoint, PreRequest, PreResponse, PreResult, PreSpec, SetData, SetMatch |
| metrics — Statistics capture: per-operation counters and latency | feature/metrics_feature.kt |
PreDone, PrePoint, PreUnexpected |
| paging — Pagination signals for list operations | feature/paging_feature.kt |
PreRequest, PreResult |
| ratelimit — Client-side rate limiting via a token bucket | feature/ratelimit_feature.kt |
— |
| retry — Automatic retry of transient failures with exponential backoff | feature/retry_feature.kt |
— |
| telemetry — Distributed tracing spans with W3C trace-context propagation | feature/telemetry_feature.kt |
PreDone, PrePoint, PreRequest, PreUnexpected |
| test — In-memory mock transport for testing without a live server | feature/test_feature.kt |
GetData, GetMatch, PostConstruct, PostConstructEntity, PrePoint, PreRequest, PreResponse, PreResult, PreSpec, SetData, SetMatch |
| timeout — Per-request timeout with transport abort | feature/timeout_feature.kt |
— |
Generated by @voxgig/sdkgen. See the project guide.