Package app.ductape.sdk.products.builder

Class ProductBuilder

java.lang.Object

app.ductape.sdk.products.builder.ProductBuilder

@Beta(since="0.1.0",
      reason="Fluent DSL surface evolving to cover full TS productsBuilder.")
public final class ProductBuilder
extends Object

Sprint 3 — Fluent ProductBuilder entry point. Mirrors the TypeScript SDK's ProductsService fluent DSL but expressed as Java step-typed chains.

Usage:

 ProductBuilder builder = ductape.products().builder("my-product");
 builder
     .app("payments-app")
         .withAccessTag("billing")
         .withAction("charge", action -> action.withMethod("POST").withPath("/charge"))
         .register();
 builder
     .database("primary")
         .withTrigger("on-user-create", t -> t.withTable("users").withEvent("INSERT"))
         .withMigration("v1", m -> m.withDescription("initial schema"))
         .register();
 Map<String, Object> definition = builder.build();
 

Chains are mutator-style: every withXxx returns this to support fluent accumulation. The terminal register() call performs the network round-trip via the underlying ProductsService; the snapshot build() call on this root yields the full immutable definition map for tests / diffs / JSON snapshots.

This class is currently Beta — its surface is locked by the ProductBuilderParityTest but signature evolution may occur until 1.0.0.

Constructor Summary

Constructors

Constructor	Description
ProductBuilder(ProductsService products, String productTag)

Method Summary

Modifier and Type	Method	Description
AppChain	app(String tag)	Apps chain — top-level definition for a third-party app, including access tags, actions, notifications, and storages.
BrokerChain	broker(String tag)	Broker chain — topics + consumers + idempotency.
Map<String,Object>	build()
DatabaseChain	database(String tag)	Database chain — triggers + migrations + actions + schema.
ExecutableChain	executable()	Executable chain — wraps ProductsService.generateExecutablePayload(app.ductape.sdk.api.services.model.BootstrapModels.GenerateExecutablePayloadParams).
FallbackChain	fallback(String tag)	Fallback chain — define + register.
GraphChain	graph(String tag)	Graph chain — actions + schema.
HealthcheckChain	healthcheck(String tag)	Healthcheck chain — define + register.
ModelChain	model(String tag)	Model chain — define + register.
ProductsService	products()
String	productTag()
QuotaChain	quota(String tag)	Quota chain — define + register.
SecretChain	secret(String tag)	Secret chain — define + register.
VectorChain	vector(String tag)	Vector chain — actions + embeddings.

Methods inherited from class java.lang.Object

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

Constructor Details

ProductBuilder

public ProductBuilder(ProductsService products,
 String productTag)

Method Details

products

public ProductsService products()

Returns:

the underlying ProductsService delegate.

productTag

public String productTag()

Returns:

the product tag this builder is bound to.

app

public AppChain app(String tag)

Apps chain — top-level definition for a third-party app, including access tags, actions, notifications, and storages.

database

public DatabaseChain database(String tag)

Database chain — triggers + migrations + actions + schema.

graph

public GraphChain graph(String tag)

Graph chain — actions + schema.

vector

public VectorChain vector(String tag)

Vector chain — actions + embeddings.

broker

public BrokerChain broker(String tag)

Broker chain — topics + consumers + idempotency.

healthcheck

public HealthcheckChain healthcheck(String tag)

Healthcheck chain — define + register.

quota

public QuotaChain quota(String tag)

Quota chain — define + register.

fallback

public FallbackChain fallback(String tag)

Fallback chain — define + register.

secret

public SecretChain secret(String tag)

Secret chain — define + register.

model

public ModelChain model(String tag)

Model chain — define + register.

executable

public ExecutableChain executable()

Executable chain — wraps ProductsService.generateExecutablePayload(app.ductape.sdk.api.services.model.BootstrapModels.GenerateExecutablePayloadParams).

build

public Map<String,Object> build()

Returns:

the accumulated immutable product definition.