Trasversale · Package · Active

@codestormlab/cs-contracts-connectors

Shared connector contract package for service-to-service datasource integrations and product-facing adapter layers.

• TypeScript declarations
• Dual package exports

Spec sheet

Package name

@codestormlab/cs-contracts-connectors

Repository path

platform-shared-packages/packages/contracts-connectors

Primary consumer

platform-connectors-service, MCP tools and product BFFs

Responsibilities

• Define reusable connector DTOs and response shapes.
• Keep product adapters aligned with the shared datasource boundary.

Interfaces and contract surface

• Package root export

Consumers

• platform-connectors-service
• platform-mcp-service
• sfdc backend
• sfdc frontend
• cs-portal backend

Notes

• Product backends should translate this technical contract into public product contracts.

Source references

• docs/core-services-integration.md
• platform-shared-packages/packages/contracts-connectors/package.json

Transazioni multi-oggetto

@codestormlab/cs-contracts-connectors espone una transazione provider-agnostic tramite:

• ConnectorTransactionRequest con allOrNone: true;
• operation create, update, upsert e delete identificate da id stabile;
• ConnectorTransactionValueReference per dichiarare dipendenze tra operation, riordinate con topological sort stabile e rifiutate quando mancanti o cicliche;
• precondizione UNCHANGED_SINCE per optimistic concurrency;
• ConnectorTransactionResponse con un risultato normalizzato e recordId per ogni operation;
• codici strutturati tra cui PRECONDITION_FAILED e TRANSACTION_LIMIT_EXCEEDED.

Il contratto non contiene URL o payload Composite Graph. La traduzione Salesforce resta nel relativo adapter di platform-connectors-service; un provider privo della capability transactionalMutations rifiuta la richiesta e non esegue fallback su mutation separate.