unstale

pypi / surrealdb

surrealdb

What changed in surrealdb 1 to 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-21.

3 breaking4 new APIs and options4 behavior and defaults6 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.1 on npm

surrealdb 25 changes

Breaking changes 1

New APIs and options 1

Behavior and default changes 2

Fixes and other changes 1

  • Fixes the WebSocket session transaction ID issue.

    2.0.0release notes

surrealdb 112 changes

Breaking changes 2

  • GeometryPolygon enforces GeoJSON-compliant closed linear rings.

    1.0.7release notes

  • Database method return types are simplified to Value.

    1.0.7release notes

New APIs and options 3

  • Live queries initiated in db.query can now be subscribed to.

    1.0.7release notes

  • Adds support for using a native embedded database.

    1.0.7release notes

  • The client issues text-based queries instead of using the v1 RPC methods.

    1.0.7release notes

Behavior and default changes 2

  • RecordId can now be serialized and deserialized by pydantic.

    1.0.8release notes

  • Duration.parse() supports parsing compound durations.

    1.0.7release notes

Fixes and other changes 5

  • The package now supports Python 3.9.

    1.0.8release notes

  • Fixes a race condition in concurrent environments.

    1.0.7release notes

  • Fixes encoding of decimal.Decimal values.

    1.0.7release notes

  • Fixes Duration encoding and decoding.

    1.0.7release notes

  • String identifiers in RecordID are escaped to match SurrealDB behaviour.

    1.0.7release notes