Package app.ductape.sdk.vector

Class VectorDatabaseService

java.lang.Object

app.ductape.sdk.vector.VectorDatabaseService

public class VectorDatabaseService
extends Object

Product-level vector management; delegates runtime operations to VectorService (parity with vector-database.service.ts + shared registry in TS).

Query/cache parity: query strips product, env, tag, and cache before delegating to VectorService.query(java.util.Map<java.lang.String, java.lang.Object>) so the wire shape matches TS (embedding stays under vector). getSchemaSnapshot(Map) follows TS getSchemaSnapshot (describe stats + sample list/fetch + inferred metadata schema). When setCacheManager(CacheManager) is wired (see Ductape), query / fetchVectors honor TS cache tags via tiered CacheManager fetch/store.

Field Summary

Fields

Modifier and Type	Field	Description
final VectorActionManager	actions

Constructor Summary

Constructors

Constructor	Description
VectorDatabaseService(EnvType env, RequestContext auth)
VectorDatabaseService(EnvType env, RequestContext auth, ProductsService productsService)
VectorDatabaseService(EnvType env, RequestContext auth, ProductsService productsService, LogApiService logApiService)

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	connect(Map<String,Object> options)
void	create(Map<String,Object> options)	TS VectorDatabaseService.create: persists vector component via ProductsService.createVector(java.lang.String, java.util.Map<java.lang.String, java.lang.Object>).
void	delete(Map<String,Object> options)
Map<String,Object>	deleteVectors(Map<String,Object> options)
Map<String,Object>	describeIndex(Map<String,Object> options)
void	disconnect(Map<String,Object> options)
void	disconnectAll()
Map<String,Object>	fetch(Map<String,Object> options)
List<Map<String,Object>>	fetchAll(Map<String,Object> options)
Map<String,Object>	fetchConfig(String productTag, String vectorTag)
List<Map<String,Object>>	fetchConfigs(String productTag)
Map<String,Object>	fetchVectors(Map<String,Object> options)
Map<String,Object>	getSchemaSnapshot(String productTag, String env, String vectorTag)	TS parity: getSchemaSnapshot without optional list/stats sampling — use getSchemaSnapshot(Map).
Map<String,Object>	getSchemaSnapshot(Map<String,Object> options)	TS parity: IVectorSchemaSnapshot from vector-database.service.ts#getSchemaSnapshot — describeIndex, getStats, optional listNamespaces, list+fetch sample vectors, VectorMetadataSchemaInferer on metadata payloads.
VectorService	getService(Map<String,Object> options)	Parity with TS getService({ product, env, tag }) → VectorService.
Map<String,Object>	getStats(Map<String,Object> options)
VectorService	getVectorService(String product, String env, String tag)
Map<String,Object>	listNamespaces(Map<String,Object> options)
Map<String,Object>	query(Map<String,Object> options)
void	setCacheManager(CacheManager cacheManager)	TS VectorDatabaseService private cacheManager — call from Ductape with shared tiered cache.
void	setLogApiService(LogApiService logApiService)	Optional override; see Ductape wiring.
void	setRuntimeDefaults(RuntimeDefaults runtimeDefaults)
void	update(Map<String,Object> options)	TS VectorDatabaseService.update: ProductsService.updateVector(java.lang.String, java.lang.String, java.util.Map<java.lang.String, java.lang.Object>) + disconnect cached VectorService instances for this product tag + vector tag (all envs).
void	updateConfig(Map<String,Object> updates)
Map<String,Object>	upsert(Map<String,Object> options)

Methods inherited from class java.lang.Object

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

Field Details

actions

public final VectorActionManager actions

Constructor Details

VectorDatabaseService

public VectorDatabaseService(EnvType env,
 RequestContext auth)

VectorDatabaseService

public VectorDatabaseService(EnvType env,
 RequestContext auth,
 ProductsService productsService)

Parameters:

productsService - product API for vector configs; inject a test double for unit tests.

VectorDatabaseService

public VectorDatabaseService(EnvType env,
 RequestContext auth,
 ProductsService productsService,
 LogApiService logApiService)

Method Details

setCacheManager

public void setCacheManager(CacheManager cacheManager)

TS VectorDatabaseService private cacheManager — call from Ductape with shared tiered cache.

setLogApiService

public void setLogApiService(LogApiService logApiService)

Optional override; see Ductape wiring.

setRuntimeDefaults

public void setRuntimeDefaults(RuntimeDefaults runtimeDefaults)

updateConfig

public void updateConfig(Map<String,Object> updates)

connect

public Map<String,Object> connect(Map<String,Object> options)

disconnect

public void disconnect(Map<String,Object> options)

create

public void create(Map<String,Object> options)

TS VectorDatabaseService.create: persists vector component via ProductsService.createVector(java.lang.String, java.util.Map<java.lang.String, java.lang.Object>).

update

public void update(Map<String,Object> options)

TS VectorDatabaseService.update: ProductsService.updateVector(java.lang.String, java.lang.String, java.util.Map<java.lang.String, java.lang.Object>) + disconnect cached VectorService instances for this product tag + vector tag (all envs).

fetch

public Map<String,Object> fetch(Map<String,Object> options)

fetchAll

public List<Map<String,Object>> fetchAll(Map<String,Object> options)

delete

public void delete(Map<String,Object> options)

query

public Map<String,Object> query(Map<String,Object> options)

upsert

public Map<String,Object> upsert(Map<String,Object> options)

fetchVectors

public Map<String,Object> fetchVectors(Map<String,Object> options)

deleteVectors

public Map<String,Object> deleteVectors(Map<String,Object> options)

listNamespaces

public Map<String,Object> listNamespaces(Map<String,Object> options)

getStats

public Map<String,Object> getStats(Map<String,Object> options)

describeIndex

public Map<String,Object> describeIndex(Map<String,Object> options)

fetchConfigs

public List<Map<String,Object>> fetchConfigs(String productTag)

fetchConfig

public Map<String,Object> fetchConfig(String productTag,
 String vectorTag)

getSchemaSnapshot

public Map<String,Object> getSchemaSnapshot(String productTag,
 String env,
 String vectorTag)

TS parity: getSchemaSnapshot without optional list/stats sampling — use getSchemaSnapshot(Map).

getSchemaSnapshot

public Map<String,Object> getSchemaSnapshot(Map<String,Object> options)

TS parity: IVectorSchemaSnapshot from vector-database.service.ts#getSchemaSnapshot — describeIndex, getStats, optional listNamespaces, list+fetch sample vectors, VectorMetadataSchemaInferer on metadata payloads.

getService

public VectorService getService(Map<String,Object> options)

Parity with TS getService({ product, env, tag }) → VectorService.

getVectorService

public VectorService getVectorService(String product,
 String env,
 String tag)

disconnectAll

public void disconnectAll()