{"ref":"artifact:cap-postgres-btp-connectivity","page":"/artifacts/cap-postgres-btp-connectivity","json":"/artifacts/cap-postgres-btp-connectivity.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"cap-postgres-btp-connectivity","name":"cap-postgres-btp-connectivity","artifact_type":"cds-plugin","ecosystem":"cap","flavors":[{"key":"node","source":{"url":"https://www.npmjs.com/package/cap-postgres-btp-connectivity","title":"cap-postgres-btp-connectivity — npm README","checked":"2026-09-13","quote":"Community adapter for connecting a Node.js CAP application to a private PostgreSQL database through SAP BTP Connectivity Service and SAP Cloud Connector."}}],"domain":"data-and-persistence","origin_ring":"independent","description":{"one_line":"Connects a CAP Node.js application to a [PostgreSQL](external:postgresql) database that is not publicly reachable, tunnelling through BTP Connectivity and the Cloud Connector.","short":"Tunnels CAP Node.js to a private PostgreSQL via Cloud Connector"},"links":{"npm":"https://www.npmjs.com/package/cap-postgres-btp-connectivity"},"type_properties":{"distribution":{"value":["npm"],"sources":[{"url":"https://www.npmjs.com/package/cap-postgres-btp-connectivity","title":"cap-postgres-btp-connectivity — README","checked":"2026-10-18","quote":"npm install cap-postgres-btp-connectivity"}]}},"provides":["capability:database-connectors"],"provenance":{"discovered_via":[{"source":"source:npm"},{"source":"source:discover"}],"first_seen":"2026-08-30"},"source_available":false,"history":[{"date":"2026-09-08","field":"links.repo","from":"https://github.com/TODO/cap-postgres-btp-connectivity","to":"npm: https://www.npmjs.com/package/cap-postgres-btp-connectivity","reason":"The repository was a placeholder that never resolved — github.com/TODO/… . There is no public repository for this package, so npm is its address and source_available says why."},{"date":"2026-09-08","field":"description.one_line","from":"CAP PostgreSQL adapter for private databases reached through SAP BTP Connectivity and Cloud Connector","to":"Connects a CAP Node.js application to a PostgreSQL database that is not publicly reachable, tunnelling through BTP Connectivity and the Cloud Connector.","reason":"Placement copied the package's own npm description. Replaced with a line written for this graph — what it does and where it sits — because an unattributed sentence is an unattributed claim."},{"date":"2026-09-15","field":"requires","from":"external:postgresql, artifact:btp-connectivity","to":"external:postgresql, artifact:btp-connectivity, artifact:sap-cloud-connector","reason":"The README names the Cloud Connector TCP mapping as a prerequisite; the edge became possible with the Cloud Connector entry in intake-20260915-cloud-connector."},{"date":"2026-09-19","field":"connects","from":null,"to":"postgresql","reason":"The adapter required PostgreSQL, the Connectivity service and the Cloud Connector as three separate things. The connection says how they line up: the database is the target, and the service is what the connection runs through."},{"date":"2026-09-22","field":"connects[0].sources","from":null,"to":"+1","reason":"The second reader read the connects batch of 2026-09-19 on 2026-09-22, after its acceptance, and found: tcp rested on no quote of the edge's own; the README's line on the Cloud Connector's TCP configuration is quoted now."}],"requires":["external:postgresql","artifact:btp-connectivity",{"ref":"artifact:sap-cloud-connector","for":"The private [PostgreSQL](external:postgresql) database is reached through a Cloud Connector TCP system mapping, whose Location ID and virtual host and port the package is configured with.","sources":[{"url":"https://www.npmjs.com/package/cap-postgres-btp-connectivity","title":"cap-postgres-btp-connectivity — README","checked":"2026-09-15","quote":"Do not continue with the package configuration until the BTP subaccount is connected to Cloud Connector, the TCP mapping is reachable, and the virtual host, virtual port, and Location ID are known."}]}],"connects":[{"ref":"external:postgresql","kind":"data","protocols":["socks5","tcp"],"direction":"outbound","via":"artifact:btp-connectivity","for":"Opening the database connection of a CAP application to a PostgreSQL server in a private network, through the Connectivity service's SOCKS5 endpoint and a TCP mapping in the Cloud Connector.","sources":[{"url":"https://unpkg.com/cap-postgres-btp-connectivity@0.3.0/README.md","title":"cap-postgres-btp-connectivity 0.3.0 — README","checked":"2026-09-19","quote":"Community adapter for connecting a Node.js CAP application to a private PostgreSQL database through SAP BTP Connectivity Service and SAP Cloud Connector."},{"url":"https://unpkg.com/cap-postgres-btp-connectivity@0.3.0/README.md","title":"cap-postgres-btp-connectivity 0.3.0 — README, references","checked":"2026-09-19","quote":"explains the Connectivity service SOCKS5 endpoint"},{"url":"https://unpkg.com/cap-postgres-btp-connectivity@0.3.0/README.md","title":"cap-postgres-btp-connectivity 0.3.0 — README, Cloud Connector configuration","checked":"2026-09-22","quote":"Use the third document to perform the required Cloud Connector TCP configuration."}]}],"drafted_with_ai":true},"effective_normative_relations":[{"instrument":"instrument:sap-developer-license-3-2-cap","relation":"use-constrained-by","sections":["1","2","3"],"applies_when":"A cds-plugin is used with SAP CAP materials, or an artifact is explicitly identified as a CAP plugin or application.","note":"This is inherited applicability, not a licence verdict about the artifact itself. Review the agreement for the actual materials and use; an explicit artifact relationship to another revision takes precedence.","scope":{"kind":"artifact"},"sources":[{"url":"https://cap.cloud.sap/resources/license/developer-license-3_2_CAP.txt","title":"SAP Developer License Agreement 3.2 CAP","checked":"2026-09-16","quote":"documentation, plug-ins, templates, scripts and sample code, libraries, software development kits"}],"inherited_from":"cap-plugins-and-applications","relevant_capabilities":["agent-systems-access","async-processing","data-import-export","database-connectors","deployment","destinations","llm-integration","mcp-servers","plugin-authoring","replication","retrieval-augmented-generation","rfc-connectivity"]}],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"3 months since release"},{"label":"Continuity","tier":"fair","evidence":"1 publisher on npm"},{"label":"Repository","tier":"unknown","evidence":"no repository data"}],"compatibility":[{"label":"Declared for","tier":"fair","evidence":"nothing declared"},{"label":"Survived majors","tier":"unknown","evidence":"first released after @sap/cds 10 shipped"},{"label":"Maintainer's CI","tier":"unknown","evidence":"no repository data"}],"practice":[{"label":"Tests","tier":"unknown","evidence":"npm test script, tree not read"},{"label":"Docs","tier":"good","evidence":"README 19 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":8,"unit":"installs/week"},{"value":null,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","latest_version":"0.3.0","majors":{"0.1":{"version":"0.1.0","date":"2026-08-03"},"0.2":{"version":"0.2.0","date":"2026-08-03"},"0.3":{"version":"0.3.0","date":"2026-08-05"}},"license":"Apache-2.0","first_release":"2026-08-03","last_release":"2026-08-05","releases":20,"cadence_days":0,"maintainers":1,"repository":null,"peer_cds":null,"test_script":true,"types":false,"downloads_weekly":8,"months_since_release":3,"dormant":false,"repository_directory":null,"dependencies":0,"node_engine":">=20","downloads_monthly":116,"npm_document_version":"0.3.0","npm_document_integrity":"sha512-3yWpCB5PT25fY89nAZBCzfojYzy83CV6MMi3w3LJzmWWmrOFs++Mkhla0F+uQ+tKPzg51PCBIEPvC5JP+Dmg6w==","npm_document_tarball":"https://registry.npmjs.org/cap-postgres-btp-connectivity/-/cap-postgres-btp-connectivity-0.3.0.tgz","readme_path":"README.md","readme_bytes":18992,"readme_source":"npm","changelog":false,"license_file":true,"license_path":"LICENSE","license_name":"Copyright 2026 cap-postgres-btp-connectivity contributors"},"release_notes":{"license":"Copyright 2026 cap-postgres-btp-connectivity contributors","quotable":false,"versions":[{"version":"0.3.0","date":"2026-08-05"},{"version":"0.2.9","date":"2026-08-05"},{"version":"0.2.8","date":"2026-08-05"},{"version":"0.2.7","date":"2026-08-05"},{"version":"0.2.6","date":"2026-08-03"},{"version":"0.2.5","date":"2026-08-03"},{"version":"0.2.4","date":"2026-08-03"},{"version":"0.2.3","date":"2026-08-03"},{"version":"0.2.2","date":"2026-08-03"},{"version":"0.2.1","date":"2026-08-03"},{"version":"0.2.0","date":"2026-08-03"},{"version":"0.1.9","date":"2026-08-03"},{"version":"0.1.8","date":"2026-08-03"},{"version":"0.1.7","date":"2026-08-03"},{"version":"0.1.6","date":"2026-08-03"},{"version":"0.1.5","date":"2026-08-03"},{"version":"0.1.4","date":"2026-08-03"},{"version":"0.1.2","date":"2026-08-03"},{"version":"0.1.1","date":"2026-08-03"},{"version":"0.1.0","date":"2026-08-03"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[],"contributors":[],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[{"ref":"artifact:btp-postgresql-hyperscaler","name":"PostgreSQL on SAP BTP, hyperscaler option","json":"/artifacts/btp-postgresql-hyperscaler.json","derived":true,"through":{"ref":"external:postgresql","name":"PostgreSQL","json":"/externals/postgresql.json"},"path":[{"kind":"requires","source":"artifact:cap-postgres-btp-connectivity","target":"external:postgresql"},{"kind":"delivers","source":"artifact:btp-postgresql-hyperscaler","target":"external:postgresql"}]}],"parts":[],"add_ons":[],"answered_through_parts":[]}}