v0.3.0

All six ArcadeDB drivers ship together at 0.3.0: Go, Python and TypeScript, each with an HTTP and a gRPC client. They are generated against ArcadeDB server 26.10.2, the latest release, which supports every feature listed below.

Install

npm install @arcadedb/driver@0.3.0          # HTTP
npm install @arcadedb/driver-grpc@0.3.0     # gRPC
pip install arcadedb-driver==0.3.0          # HTTP
pip install arcadedb-driver-grpc==0.3.0     # gRPC
go get github.com/ArcadeData/arcadedb-drivers/go/arcadedb@v0.3.0       # HTTP
go get github.com/ArcadeData/arcadedb-drivers/go/arcadedbgrpc@v0.3.0   # gRPC

⚠️ Breaking changes

• gRPC insertStream no longer copies the database into InsertOptions.database (#45, #103). All three gRPC clients now send the database on the first chunk only, as the .proto specifies, and leave your options untouched.
  • Every supported server (26.9.1 and later) reads the database from the chunk, so nothing changes there.
  • Servers older than 26.9.1: they read only options.database, so a stream now inserts nothing and raises no error. You get rows received but inserted=0. If you are stuck on such a server, set options.database yourself.
• Errors in the middle of a stream now carry the server's real status (#117, #119). An error event during queryStream / query_stream / QueryStream (or the command version) used to surface as status 200. It now carries the event's own status, such as 500 or 503, and falls back to 200 only when the event has none. If your retry logic looks at the status, it now sees the real one.
• Go: the option types are split (#119). QueryOption is now a sealed interface, joined by CommandOption and TransactionOption. Existing calls compile unchanged. You only need to change code that implemented QueryOption itself, or that kept options in a []QueryOption and passed it to Command.

New in the HTTP clients

Everything below is in all three languages, and in both the sync and async APIs in Python.

Server administration (#122)

• Create and drop databases.
• Users: create, update, drop and list.
• Groups: save, delete and list.
• serverCommand for any other server command, still with typed errors.
• A duplicate user or database now gives a 409 (on 26.10.2 and later; older servers answer 403 and 400).
• sqlscript is now a first-class query language (SQLScript in Go).

Login sessions and API tokens (#123)

• login, loginAs, withToken and logout.
• listSessions, plus API tokens: createAPIToken, listAPITokens and deleteAPIToken.
• A multi-tenant application can log in once per user and then keep a client that holds only that user's token.

Running work (#124)

• See what is running: listQueries (filter by database or tag) and listTransactions.
• Stop it: terminateQuery, terminateQueriesByTag and terminateTransaction, each with an optional wait.
  • Every answer has a typed status: terminated, completed, terminating or not found.
  • isQueryTerminated / is_query_terminated / IsQueryTerminated tells you whether a request failed because it was terminated, as opposed to another error with the same 409 status.
• Follow long maintenance operations with db.progress().

Query tags (#117)

• Label a query, command, stream, batch load or whole transaction with queryTag / query_tag / WithQueryTag.
• You can then list and terminate work by that tag.

Richer errors (#117)

• ArcadeDBError gains retryAfter and commitIndex.
• A rejected time-series write raises TimeSeriesWriteError, which reports how many samples were written and which types or keys were dropped.

Duplex insert session over /ws (#110)

• db.insertSession() / db.insert_session() / db.InsertSession().
• You see each batch's acknowledgement before deciding what to send next and whether to commit, which POST /api/v1/batch cannot do.
• It can also join an open transaction.

EXPLAIN and PROFILE plans (#74)

• Query results now carry explain and explainPlan, so a plan no longer looks like an empty result set.

PromQL label values (#125)

• db.promql.labelValues / label_values / LabelValues, with an optional time range.
• Pass "__name__" to list the time-series type names.
• Thanks to @lextleo for the first version (#127).

New in the gRPC clients

• Insert streams inside a transaction (#46). insertStream can run through a transaction handle in all three languages, so the inserted rows commit or roll back with the transaction.
• Per-call metadata in Python (#28). Python's gRPC client now accepts per-call metadata on the twelve methods that were missing it.

Good to know

• Behind a load balancer, running work is per server. listQueries and the terminate methods only see the server the client happened to reach. These commands are never forwarded to the cluster leader.
• A just-started statement briefly shows no text. Right after a request is accepted, listQueries lists it with no language and with the request line (POST /api/v1/command/<db>) as its text. Both are filled in a moment later.
• A commit after terminateTransaction still reports success. The server answers 204 even though the transaction's writes were rolled back. This is a server issue, reported as ArcadeData/arcadedb#10164; the READMEs warn about it.

Release process

• npm packages are published with trusted publishing (OIDC). No long-lived token is involved any more (#97, #98).
• Go module tags are pushed before the Go proxy is asked about them, which avoids the 25-minute delay that hit 0.2.0 (#97).
• Release tags are protected against being moved or deleted.
• Every .proto change is now checked with buf breaking in CI (#29, #102).

All pull requests in this release

Features and fixes

• #103 feat(grpc)!: retire the InsertOptions.database mirror in all three gRPC clients (#45)
• #106 feat(http): carry explain / explainPlan in QueryEnvelope (#74)
• #111 land #28, #46 and #30 (per-call metadata in Python gRPC, insert streams in transactions)
• #112 /ws duplex insert session (#110)
• #119 adopt the 26.11.1-SNAPSHOT API additions in the HTTP clients (#117)
• #126, #128, #130 server administration and sqlscript (#122) in Go, Python and TypeScript
• #129, #132 a duplicate user or database is 409 (#122)
• #131, #133, #134 login, logout, sessions and API tokens (#123) in Go, Python and TypeScript
• #135, #136 PromQL label values (#125)
• #137 list and terminate running queries and transactions, and poll progress (#124)

Docs

• #101 fix a non-existent setting name and 1-based positional parameter examples

Release, CI and contract

• #97 trusted publishing on npm; never query the Go proxy before the tag exists
• #102 check every .proto change with buf breaking (#29)
• #99, #113, #120, #121, #138 contract refreshes, ending on the released 26.10.2
• #140 set version 0.3.0

Dependencies

• #114, #115, #116 Dependabot updates (npm dev, GitHub Actions, uv dev)

Full changelog: v0.2.0...v0.3.0

Publish results

Package	Registry	Status	Run
@arcadedb/driver	npm	published	run
@arcadedb/driver-grpc	npm	published	run
arcadedb-driver	pypi	published	run
arcadedb-driver-grpc	pypi	published	run
github.com/ArcadeData/arcadedb-drivers/go/arcadedb	goproxy	published	run
github.com/ArcadeData/arcadedb-drivers/go/arcadedbgrpc	goproxy	published	run

skipped: already on its registry. published (verified on registry): no result recorded this attempt, but the registry has the version. unknown: no result recorded and the registry did not confirm it, or a run dispatched whose outcome was not seen - check it before re-running failed jobs.

v0.2.0

Packages

Package	Registry	Version
@arcadedb/driver	npm	0.2.0
@arcadedb/driver-grpc	npm	0.2.0
arcadedb-driver	pypi	0.2.0
arcadedb-driver-grpc	pypi	0.2.0
github.com/ArcadeData/arcadedb-drivers/go/arcadedb	goproxy	0.2.0
github.com/ArcadeData/arcadedb-drivers/go/arcadedbgrpc	goproxy	0.2.0

Generated against ArcadeDB server 26.10.1.

What's Changed

Dependencies

• build(deps-dev): bump @types/node from 20.19.43 to 26.2.0 in /typescript by @dependabot[bot] in #2
• build(deps-dev): bump the npm-minor-and-patch group in /typescript with 3 updates by @dependabot[bot] in #14
• build(deps): bump astral-sh/setup-uv from 7.6.0 to 10.0.1 by @dependabot[bot] in #18
• build(deps-dev): bump @types/node from 26.3.0 to 26.4.0 in /typescript in the npm-minor-and-patch group by @dependabot[bot] in #17
• build(deps): bump anthropics/claude-code-action from 1.0.215 to 1.0.220 in the actions-minor-and-patch group by @dependabot[bot] in #55
• build(deps): bump the npm-minor-and-patch group across 1 directory with 7 updates by @dependabot[bot] in #56
• build(deps-dev): bump ruff from 0.16.5 to 0.16.7 in /python in the uv-minor-and-patch group across 1 directory by @dependabot[bot] in #54
• build(deps-dev): bump vitest from 4.1.11 to 5.0.1 in /typescript by @dependabot[bot] in #70
• build(deps): bump the actions-minor-and-patch group with 2 updates by @dependabot[bot] in #68
• build(deps): bump the uv-minor-and-patch group across 1 directory with 3 updates by @dependabot[bot] in #75
• build(deps): bump the npm-minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in #69
• build(deps): bump the actions-minor-and-patch group with 2 updates by @dependabot[bot] in #78
• build(deps): bump protobuf from 7.36.1 to 7.36.2 in /python in the uv-minor-and-patch group across 1 directory by @dependabot[bot] in #80
• build(deps-dev): bump the npm-minor-and-patch group across 1 directory with 3 updates by @dependabot[bot] in #79
• build(deps-dev): bump ruff from 0.16.8 to 0.16.9 in /python in the uv-minor-and-patch group across 1 directory by @dependabot[bot] in #89
• build(deps): bump anthropics/claude-code-action from 1.0.233 to 1.0.236 in the actions-minor-and-patch group across 1 directory by @dependabot[bot] in #88
• build(deps-dev): bump the npm-minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in #91
• build(deps): bump golang.org/x/mod from 0.40.0 to 0.41.0 in /go/tools in the gomod-minor-and-patch group across 1 directory by @dependabot[bot] in #86
• build(deps): bump anthropics/claude-code-action from 1.0.236 to 1.0.238 in the actions-minor-and-patch group by @dependabot[bot] in #93
• build(deps): bump the npm-minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in #94

Contract

• build(contract): adopt the 26.10.1-SNAPSHOT contract by @robfrank in #43
• feat(scripts): flag version-rewrite lines that assert server behaviour by @robfrank in #51
• chore: refresh contracts to latest SNAPSHOT (time-series tags and limit) by @robfrank in #57
• chore: adopt the refreshed 26.10.1-SNAPSHOT contract by @robfrank in #62

CI and build

• docs: add the Python CI badge by @robfrank in #63

Changes

• feat: @arcadedb/client, the TypeScript HTTP client (epic ArcadeData/arcadedb#4894 M1) by @robfrank in #1
• feat: allow the e2e image to be overridden for the upstream smoke job by @robfrank in #4
• feat: @arcadedb/client-grpc, the TypeScript gRPC client (epic ArcadeData/arcadedb#4894 M1b) by @robfrank in #5
• ci: watch the snapshot contract daily, and refuse to generate from a stale one by @robfrank in #6
• docs: add license, CI, and contract watch badges to README by @robfrank in #8
• chore: refresh the contract to 26.9.1-SNAPSHOT by @github-actions[bot] in #10
• chore: refresh the contract to 26.9.1-SNAPSHOT by @github-actions[bot] in #11
• chore: refresh the contract to 26.9.1-SNAPSHOT by @github-actions[bot] in #13
• docs: add CLAUDE.md at the root and in typescript/ by @robfrank in #15
• feat(python): add arcadedb-client, the Python HTTP client (M3) by @robfrank in #16
• chore: point every repository reference at ArcadeData/arcadedb-drivers by @robfrank in #19
• refactor: rename the clients from "client" to "driver" by @robfrank in #20
• build(contract): adopt the released 26.9.1 contract by @robfrank in #23
• ci: let publish.yml publish either npm package by @robfrank in #24
• docs: verify npm trusted publishers by readback, not by eye by @robfrank in #25
• feat(python): arcadedb-driver-grpc, the Python gRPC driver (epic ArcadeData/arcadedb#4894 M3b) by @robfrank in #27
• ci: gate both dependency trees on a license allow-list by @robfrank in #32
• docs: link the four published packages from the README by @robfrank in #33
• ci: port the Claude and issue-classifier workflows from arcadedb by @robfrank in #34
• docs: correct the release status now that all four clients are published by @robfrank in #35
• feat: vector search across all four clients by @robfrank in #47
• feat: time series over gRPC by @robfrank in #48
• feat: ndjson streaming for query and command by @robfrank in #53
• feat: reach the control plane without defeating a security control by @robfrank in #58
• feat: streaming bulk load over HTTP — wrap /batch in both clients by @robfrank in #59
• test(grpc): pin the two drift risks the PR #58 review flagged by @robfrank in #65
• ci: merge approved Dependabot PRs automatically by @robfrank in #72
• chore: refresh the contract to 26.10.1-SNAPSHOT and adopt it in both clients by @robfrank in #73
• chore: refresh the contract to 26.10.1-SNAPSHOT by @github-actions[bot] in #77
• chore: refresh the contract to 26.10.1-SNAPSHOT by @github-actions[bot] in #81
• ci: skip the Claude review job on Dependabot PRs by @robfrank in #82
• feat(release): one lockstep release for every driver by @robfrank in #84
• feat(go): the Go HTTP driver (M10) by @robfrank in #85
• feat(go): the Go gRPC driver (M10b) by @robfrank in #90
• chore: refresh the contract to 26.10.1-SNAPSHOT by @github-actions[bot] in #83
• feat(scripts): fetch the .proto from the release in --release mode by @robfrank in #95
• chore: adopt the released ArcadeDB 26.10.1 contracts and set version 0.2.0 by @robfrank in #96

New Contributors

• @robfrank made their first contribution in #1
• @dependabot[bot] made their first contribution in #2
• @github-actions[bot] made their first contribution in #10

...