`concurrency: 0` is documented to disable the limit, but expandConfig turns it into 20

[mkpoli]

api.ts documents concurrency: 0 as disabling the limit:

By default, the client performs up to 20 concurrent requests. You can set this option to a higher number to increase the concurrency limit or set it to 0 to disable concurrency limits completely.

libsql-client-ts/packages/libsql-core/src/api.ts

Lines 59 to 63 in 889a2ec

	/** Concurrency limit.
	*
	* By default, the client performs up to 20 concurrent requests. You can set this option to a higher
	* number to increase the concurrency limit or set it to 0 to disable concurrency limits completely.
	*/

but expandConfig normalizes with a falsy-default:

concurrency = Math.max(0, concurrency || 20);

libsql-client-ts/packages/libsql-core/src/config.ts

Line 56 in 889a2ec

concurrency = Math.max(0, concurrency || 20);

0 || 20 is 20, so the documented value silently becomes the default:

import { expandConfig } from "@libsql/core/config";

expandConfig({ url: "https://example.turso.io", concurrency: 0 }, true).concurrency;
// actual: 20 — expected: 0

The rest of the chain already handles 0 as documented: both clients feed config.concurrency straight into promise-limit, which treats a falsy limit as pass-through. Only the clamp in expandConfig loses the value, so the fix is one line:

concurrency = Math.max(0, concurrency ?? 20);

One semantic decision for you: with ||, negative values currently clamp to 0 and then mean "unlimited" further down; with ?? they still clamp to 0 and keep meaning unlimited, but you may prefer to reject them explicitly. Worth keeping "0 = unlimited" as the contract either way rather than redefining the docs — on serverless runtimes a finite limit is itself a hazard: one client instance is typically shared per isolate, so the semaphore queues query 21+ in module-scope state and starts it from whichever request's query finishes first. On Cloudflare Workers, where a finished request's continuations are canceled, that cross-request handoff can wedge the queue. concurrency: Infinity survives the || clamp and is the workaround that disables the limit today; concurrency: 0, the documented form, silently restores the cap of 20.

Happy to send the one-line PR with regression cases for undefined, 0, a positive number, and a negative number.