{"id":28910537,"url":"https://github.com/couchbase-ecosystem/wasmcloud-provider-couchbase","last_synced_at":"2026-01-12T11:25:55.641Z","repository":{"id":242905653,"uuid":"810440264","full_name":"Couchbase-Ecosystem/wasmcloud-provider-couchbase","owner":"Couchbase-Ecosystem","description":"Wasmcloud Couchbase capabilities provider","archived":false,"fork":false,"pushed_at":"2025-04-28T14:48:33.000Z","size":64285,"stargazers_count":6,"open_issues_count":6,"forks_count":8,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-10-17T04:18:46.498Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Couchbase-Ecosystem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-04T17:46:33.000Z","updated_at":"2025-07-24T14:28:38.000Z","dependencies_parsed_at":"2024-06-05T17:20:50.357Z","dependency_job_id":"da963325-9494-4972-96d8-fad61caeed31","html_url":"https://github.com/Couchbase-Ecosystem/wasmcloud-provider-couchbase","commit_stats":null,"previous_names":["couchbaselabs/wasmcloud-provider-couchbase","couchbase-examples/wasmcloud-provider-couchbase","couchbase-ecosystem/wasmcloud-provider-couchbase"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Couchbase-Ecosystem/wasmcloud-provider-couchbase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Couchbase-Ecosystem%2Fwasmcloud-provider-couchbase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Couchbase-Ecosystem%2Fwasmcloud-provider-couchbase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Couchbase-Ecosystem%2Fwasmcloud-provider-couchbase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Couchbase-Ecosystem%2Fwasmcloud-provider-couchbase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Couchbase-Ecosystem","download_url":"https://codeload.github.com/Couchbase-Ecosystem/wasmcloud-provider-couchbase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Couchbase-Ecosystem%2Fwasmcloud-provider-couchbase/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-21T18:14:01.926Z","updated_at":"2026-01-12T11:25:55.636Z","avatar_url":"https://github.com/Couchbase-Ecosystem.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/couchbaselabs/wasmcloud-provider-couchbase )\n\n# wasmcloud-provider-couchbase\n\nThis is a capability provider for wasmCloud to provide Couchbase KV connectivity to Wasm applications via the `wasmcloud-couchbase` interface.\n\nThis provider uses the **RawJSONTranscoder** for Couchbase, storing any new keys as binary data. The deserialization into a `struct` or structured data must be done on the component side as the provider does not have information about the desired shape of data.\n\n## Interface support\n\n- [x] wasmcloud:couchbase/document@0.1.0-draft\n- [ ] wasmcloud:couchbase/fts@0.1.0-draft\n- [ ] wasmcloud:couchbase/subdocument-lookup@0.1.0-draft\n- [ ] wasmcloud:couchbase/subdocument-mutate@0.1.0-draft\n- [ ] wasmcloud:couchbase/sqlpp@0.1.0-draft\n\n## Build\n\nPrerequisites:\n\n- [wash 0.30](https://wasmcloud.com/docs/installation) or later\n\nBuild this capability provider with:\n\n```shell\nwash build\n```\n\nBuild the example components with:\n\n```shell\nwash build -p components/rust\nwash build -p components/golang\n```\n\n## Run\n\n### Prerequisites\n\n- [wash 0.30](https://wasmcloud.com/docs/installation) or later\n- The [secrets-nats-kv](https://github.com/wasmCloud/wasmCloud/tree/main/crates/secrets-nats-kv) CLI installed (for now this requires a Rust toolchain)\n- A built couchbase capability provider, see [#build](#build)\n- Setup Couchbase server with the required configuration for testing using docker-compose.yaml in the repo.\n\n```bash\ndocker-compose up -d\n```\n\nAlternatively, you can use [Quick Install](https://docs.couchbase.com/server/current/getting-started/do-a-quick-install.html) guide with a bucket named **test** created.\n\n### Running\n\n```shell\nWASMCLOUD_SECRETS_TOPIC=wasmcloud.secrets \\\n    wash up -d\n\n# Generate encryption keys and run the backend\nexport ENCRYPTION_XKEY_SEED=$(wash keys gen curve -o json | jq -r '.seed')\nexport TRANSIT_XKEY_SEED=$(wash keys gen curve -o json | jq -r '.seed')\nsecrets-nats-kv run \u0026\n# Put the password in the NATS KV secrets backend\nprovider_key=$(wash inspect ./build/wasmcloud-provider-couchbase.par.gz -o json | jq -r '.service')\nsecrets-nats-kv put couchbase_password --string password\nsecrets-nats-kv add-mapping $provider_key --secret couchbase_password\nwash app deploy ./wadm.yaml\n```\n\nThen you can invoke either the Rust component or the Golang component on port 8080 and 8081, respectively. Both components implement the exact same functionality, which simply takes a payload and a path to roundtrip a JSON document in Couchbase.\n\n```shell\ncurl -d '{\"demo\": true, \"couchbase\": \"db\", \"wasmcloud\": \"application platform\"}' \\\n    localhost:8080/mykey\n{\"demo\": true, \"couchbase\": \"db\", \"wasmcloud\": \"application platform\"}%\n```\n\n## Test\n\nTo test the WIT bindings, download [wit-bindgen](https://github.com/bytecodealliance/wit-bindgen) and run the following:\n\n```console\nwit-deps \u0026\u0026 wit-bindgen rust --out-dir /tmp/wit wit/\n```\n\nThis will attempt to generate Rust based bindings, in a folder under `/tmp` (which will be cleaned up eventually), but in doing so, will check that the WIT definitions are valid (as they must be to complete binding generation).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbase-ecosystem%2Fwasmcloud-provider-couchbase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcouchbase-ecosystem%2Fwasmcloud-provider-couchbase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbase-ecosystem%2Fwasmcloud-provider-couchbase/lists"}