Class ApiCaptureGenerator

java.lang.Object

com.shaft.capture.generate.api.ApiCaptureGenerator

public final class ApiCaptureGenerator
extends Object

Generates, optionally compiles, and optionally replays a SHAFT.API TestNG class from a recorded session's API transactions. Mirrors com.shaft.capture.generate.CaptureGenerator's validate->analyze->render-> compile->replay->report staging, reusing GeneratedTestValidator and CaptureGenerationReport rather than inventing parallel types.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ApiCaptureGenerator.TransactionLeaves	One transaction's classified response leaves, for a "pin this path" picker UI.

Constructor Summary

Constructors

Constructor	Description
ApiCaptureGenerator()
ApiCaptureGenerator(CaptureJsonCodec codec, GeneratedTestValidator validator, NetworkBodyStore bodyStore)
ApiCaptureGenerator(CaptureJsonCodec codec, GeneratedTestValidator validator, NetworkBodyStore bodyStore, CaptureEnrichmentService enrichmentService)	Creates a generator with an injectable AI naming-enrichment service, for tests that need to fake the provider boundary without any network/process call.

Method Summary

Modifier and Type	Method	Description
ApiCaptureGenerationResult	generate(ApiCaptureGenerationRequest request)	Generates, validates, and reports one SHAFT.API test class.
List<ApiCaptureGenerator.TransactionLeaves>	listResponseLeaves(Path sessionPath, List<String> excludedTransactionIds)	Lists classified response leaves for each renderable transaction in a recorded session, without generating any test source -- the basis for a "pin this path as a business assertion" picker UI (issue #3530 negative-case).

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ApiCaptureGenerator

public ApiCaptureGenerator()

ApiCaptureGenerator

public ApiCaptureGenerator(CaptureJsonCodec codec,
 GeneratedTestValidator validator,
 NetworkBodyStore bodyStore)

ApiCaptureGenerator

public ApiCaptureGenerator(CaptureJsonCodec codec,
 GeneratedTestValidator validator,
 NetworkBodyStore bodyStore,
 CaptureEnrichmentService enrichmentService)

Creates a generator with an injectable AI naming-enrichment service, for tests that need to fake the provider boundary without any network/process call.

Parameters:

codec - session codec

validator - compile/replay validator

bodyStore - network body resolver

enrichmentService - AI naming-enrichment service (see CaptureEnrichmentService.previewApiScenarioName(String, String, List, String, String, ApprovalPolicy))

Method Details

generate

public ApiCaptureGenerationResult generate(ApiCaptureGenerationRequest request)

Generates, validates, and reports one SHAFT.API test class.

Parameters:

request - generation options

Returns:

generated artifacts and report

listResponseLeaves

public List<ApiCaptureGenerator.TransactionLeaves> listResponseLeaves(Path sessionPath,
 List<String> excludedTransactionIds)

Lists classified response leaves for each renderable transaction in a recorded session, without generating any test source -- the basis for a "pin this path as a business assertion" picker UI (issue #3530 negative-case). A LeafClassification.SENSITIVE leaf's value is never returned, even redacted-in-source values like tokens must not leave this method.

Parameters:

sessionPath - persisted Capture JSON path

excludedTransactionIds - transaction ids to omit, same semantics as generate(ApiCaptureGenerationRequest)

Returns:

one entry per renderable transaction, in recorded order; empty if the session cannot be read