chore: add .NET wrapper for SpannerLib (googleapis#533)

* chore: add CreatePool and CreateConnection functions for SpannerLib

Creates a spannerlib module and adds functions for CreatePool and CreateConnection.

* chore: add Java wrapper for SpannerLib

Adds a Java wrapper for SpannerLib and some simple tests for this wrapper.

* chore: add Execute function for SpannerLib

Adds an Execute function for SpannerLib that can be used to execute any type
of SQL statement. The return type is always a Rows object. The Rows object
is empty for DDL statements, it only contains ResultSetStats for DML statements
without a THEN RETURN clause, and it contains actual row data for queries and
DML statements with a THEN RETURN clause.

The Execute function can also be used to execute client-side SQL statements,
like BEGIN, COMMIT, SET, SHOW, etc.

* chore: add transaction support for SpannerLib

* chore: add ExecuteBatch to SpannerLib

Adds an ExecuteBatch function to SpannerLib that supports executing DML or DDL
statements as a single batch. The function accepts an ExecuteBatchDml request
for both types of batches. The type of batch that is actually being executed
is determined based on the statements in the batch. Mixing DML and DDL in the
same batch is not supported. Queries are also not supported in batches.

* chore: add WriteMutations function for SpannerLib

Adds a WriteMutations function for SpannerLib. This function can be used
to write mutations to Spanner in two ways:
1. In a transaction: The mutations are buffered in the current read/write transaction.
   The returned message is empty.
2. Outside a transaction: The mutations are written to Spanner directly in a new read/write
   transaction. The returned message contains the CommitResponse.

* chore: add .NET wrapper for SpannerLib

Adds a .NET wrapper and tests for SpannerLib.

* chore: add Java wrapper for SpannerLib (googleapis#527)

* chore: add Java wrapper for SpannerLib

Adds a Java wrapper for SpannerLib and some simple tests for this wrapper.

* chore: add Execute function for SpannerLib (googleapis#529)

* chore: add Execute function for SpannerLib

Adds an Execute function for SpannerLib that can be used to execute any type
of SQL statement. The return type is always a Rows object. The Rows object
is empty for DDL statements, it only contains ResultSetStats for DML statements
without a THEN RETURN clause, and it contains actual row data for queries and
DML statements with a THEN RETURN clause.

The Execute function can also be used to execute client-side SQL statements,
like BEGIN, COMMIT, SET, SHOW, etc.

* chore: add transaction support for SpannerLib (googleapis#530)

* chore: add transaction support for SpannerLib

* chore: add ExecuteBatch to SpannerLib (googleapis#531)

* chore: add ExecuteBatch to SpannerLib

Adds an ExecuteBatch function to SpannerLib that supports executing DML or DDL
statements as a single batch. The function accepts an ExecuteBatchDml request
for both types of batches. The type of batch that is actually being executed
is determined based on the statements in the batch. Mixing DML and DDL in the
same batch is not supported. Queries are also not supported in batches.

* chore: add WriteMutations function for SpannerLib (googleapis#532)

Adds a WriteMutations function for SpannerLib. This function can be used
to write mutations to Spanner in two ways:
1. In a transaction: The mutations are buffered in the current read/write transaction.
   The returned message is empty.
2. Outside a transaction: The mutations are written to Spanner directly in a new read/write
   transaction. The returned message contains the CommitResponse.

* fix: check for error after calling Next()

* chore: return long instead of int

* chore: remove TODO

* chore: add grpc-server API for SpannerLib (googleapis#534)

* chore: add grpc-server API for SpannerLib

Adds a gRPC server that exposes the API of SpannerLib. This allows clients
to connect to run SpannerLib as a child process and connect to it using
gRPC.

* refactor(ruby): Introduce MessageHandler and Rows classes (googleapis#553)

* refactor: add new message handler in ruby wrapper

* chore: delay transaction activation until actual use (googleapis#552)

* chore: store temp TransactionOptions in connection state

Store temporary TransactionOptions in the connection state as local options. Local options
only apply to the current transaction. This simplifies the internal state handling of the
driver, as all transaction state should only be read from the connection state, and not
also from a temporary variable.

This also enables the use of a combination of temporary transaction options and using
SQL statements to set further options. The shared library always includes temporary
transaction options, as the BeginTransaction function accepts TransactionOptions as an
input argument. This meant that using SQL statements to set further transaction options
was not supported through the shared library.

* chore: delay transaction activation until actual use

Delay the actual transaction activation until the first actual usage of the transaction.
That is; the first time that a statement is being sent to Spanner. This allows the
application to amend the transaction options after calling BeginTx or executing
`BEGIN TRANSACTION`. The transaction options can be amended by executing a statement
like `SET TRANSACTION READ ONLY`.

* chore: update actions/checkout action to v5 (googleapis#555)

* fix: update all dependencies (googleapis#551)

* fix: update all dependencies

* chore: go mod tidy

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>

* chore: add signal handler to remove temp file

* chore: add .NET gRPC wrapper (googleapis#539)

* fix: update dependency net.java.dev.jna:jna to v5.18.0 (googleapis#538)

* chore: update all dependencies (googleapis#537)

* fix: update all dependencies (googleapis#536)

* fix: update all dependencies

* chore: go mod tidy

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>

* chore(main): release 1.18.1 (googleapis#525)

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>

* fix: update module github.com/googleapis/go-sql-spanner to v1.18.1 (googleapis#540)

* chore: add .NET gRPC wrapper

Adds a gRPC wrapper for .NET. This wrapper uses the gRPC API to connect to SpannerLib.
The gRPC channel uses a Unix domain socket.

* fix: update dependency net.java.dev.jna:jna to v5.18.1 (googleapis#544)

This PR contains the following updates:

| Package | Change | Age | Confidence |
|---|---|---|---|
| [net.java.dev.jna:jna](https://redirect.github.com/java-native-access/jna) | `5.18.0` -> `5.18.1` | [![age](https://developer.mend.io/api/mc/badges/age/maven/net.java.dev.jna:jna/5.18.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/maven/net.java.dev.jna:jna/5.18.0/5.18.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>java-native-access/jna (net.java.dev.jna:jna)</summary>

### [`v5.18.1`](https://redirect.github.com/java-native-access/jna/blob/HEAD/CHANGES.md#Release-5181)

[Compare Source](https://redirect.github.com/java-native-access/jna/compare/5.18.0...5.18.1)

\==============

## Bug Fixes

- [#&#8203;1686](https://redirect.github.com/java-native-access/jna/issues/1686): Fix `sortFields` race condition while getting fields - [@&#8203;bendk](https://redirect.github.com/bendk).

</details>

---

### Configuration

📅 **Schedule**: Branch creation - Between 12:00 AM and 03:59 AM ( * 0-3 * * * ) (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/googleapis/go-sql-spanner).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0MS4xMzEuOSIsInVwZGF0ZWRJblZlciI6IjQxLjEzMS45IiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->

* feat: add authority param support to DSN (googleapis#546)

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* fix: update all dependencies (googleapis#542)

* fix: update all dependencies

* chore: go mod tidy

* build: add ByteBuddy for Java wrapper

---------

Co-authored-by: Knut Olav Løite <koloite@gmail.com>

* feat(ruby): Add Ruby FFI wrapper for spannerlib (googleapis#545)

* feat(ruby): add Ruby FFI wrapper for spannerlib

* chore(main): release 1.19.0 (googleapis#541)

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>

* chore: store temp TransactionOptions in connection state (googleapis#548)

Store temporary TransactionOptions in the connection state as local options. Local options
only apply to the current transaction. This simplifies the internal state handling of the
driver, as all transaction state should only be read from the connection state, and not
also from a temporary variable.

This also enables the use of a combination of temporary transaction options and using
SQL statements to set further options. The shared library always includes temporary
transaction options, as the BeginTransaction function accepts TransactionOptions as an
input argument. This meant that using SQL statements to set further transaction options
was not supported through the shared library.

* feat: parse SET TRANSACTION statements (googleapis#549)

* feat: parse SET TRANSACTION statements

Parse SET TRANSACTION statements and translate these to SET LOCAL statements.
SET TRANSACTION may only be executed in a transaction block, and can only be
used for a specific, limited set of connection properties. The syntax is
specified by the SQL standard and PostgreSQL.

See also https://www.postgresql.org/docs/current/sql-set-transaction.html

This change only adds partial support. The following features will be added
in future changes:
1. SET TRANSACTION READ {WRITE | ONLY} is not picked up by the driver, as
   the type of transaction is set directly when BeginTx is called. A
   refactor of this transaction handling is needed to be able to pick up
   SET TRANSACTION READ ONLY / SET TRANSACTION READ WRITE statements that
   are executed after BeginTx has been called.
2. PostgreSQL allows multiple transaction modes to be set in a single
   SET TRANSACTION statement. E.g. the following is allowed:
   SET TRANSACTION READ WRITE, ISOLATION LEVEL SERIALIZABLE
   The current implementation only supports one transaction mode per
   SET statement.

* feat: support multiple transaction options in one statement

* feat: support transaction options in BEGIN statements (googleapis#550)

* feat: parse SET TRANSACTION statements

Parse SET TRANSACTION statements and translate these to SET LOCAL statements.
SET TRANSACTION may only be executed in a transaction block, and can only be
used for a specific, limited set of connection properties. The syntax is
specified by the SQL standard and PostgreSQL.

See also https://www.postgresql.org/docs/current/sql-set-transaction.html

This change only adds partial support. The following features will be added
in future changes:
1. SET TRANSACTION READ {WRITE | ONLY} is not picked up by the driver, as
   the type of transaction is set directly when BeginTx is called. A
   refactor of this transaction handling is needed to be able to pick up
   SET TRANSACTION READ ONLY / SET TRANSACTION READ WRITE statements that
   are executed after BeginTx has been called.
2. PostgreSQL allows multiple transaction modes to be set in a single
   SET TRANSACTION statement. E.g. the following is allowed:
   SET TRANSACTION READ WRITE, ISOLATION LEVEL SERIALIZABLE
   The current implementation only supports one transaction mode per
   SET statement.

* feat: support multiple transaction options in one statement

* feat: support transaction options in BEGIN statements

Adds support for including transaction options in BEGIN statements, like:

```sql
BEGIN READ ONLY;
BEGIN READ WRITE;
BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ;
BEGIN READ WRITE, ISOLATION LEVEL SERIALIZABLE;
```

* chore: re-trigger checks

* chore: add timeout for server startup

---------

Signed-off-by: Marco Pracucci <marco@pracucci.com>
Co-authored-by: Mend Renovate <bot@renovateapp.com>
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Marco Pracucci <marco@pracucci.com>
Co-authored-by: aakashanandg <aakashanand@google.com>

* chore: return long instead of int

* chore: remove TODO

---------

Signed-off-by: Marco Pracucci <marco@pracucci.com>
Co-authored-by: aakashanandg <aakashanand@google.com>
Co-authored-by: Mend Renovate <bot@renovateapp.com>
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Marco Pracucci <marco@pracucci.com>

---------

Signed-off-by: Marco Pracucci <marco@pracucci.com>
Co-authored-by: aakashanandg <aakashanand@google.com>
Co-authored-by: Mend Renovate <bot@renovateapp.com>
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Marco Pracucci <marco@pracucci.com>

Author: 5 people

.github/workflows/spanner-lib-tests.yml

@@ -48,19 +48,27 @@ jobs:
       - name: Build shared library
         working-directory: spannerlib/shared
         run: go build -o spannerlib.so -buildmode=c-shared shared_lib.go
+      - name: Build gRPC server
+        working-directory: spannerlib/grpc-server
+        run: |
+          go build -o grpc_server server.go
+          chmod +x grpc_server
       - name: Copy to Java wrapper
         working-directory: spannerlib
         run: |
           echo "$RUNNER_OS"
           if [ "$RUNNER_OS" == "Windows" ]; then
             mkdir -p wrappers/spannerlib-java/src/main/resources/win32-x86-64
             cp shared/spannerlib.so wrappers/spannerlib-java/src/main/resources/win32-x86-64/spanner.dll
+            cp grpc-server/grpc_server wrappers/spannerlib-java/src/main/resources/win32-x86-64/grpc_server
           elif [ "$RUNNER_OS" == "macOS" ]; then
             mkdir -p wrappers/spannerlib-java/src/main/resources/darwin-aarch64
             cp shared/spannerlib.so wrappers/spannerlib-java/src/main/resources/darwin-aarch64/libspanner.dylib
+            cp grpc-server/grpc_server wrappers/spannerlib-java/src/main/resources/darwin-aarch64/grpc_server
           else
             mkdir -p wrappers/spannerlib-java/src/main/resources/linux-x86-64
             cp shared/spannerlib.so wrappers/spannerlib-java/src/main/resources/linux-x86-64/libspanner.so
+            cp grpc-server/grpc_server wrappers/spannerlib-java/src/main/resources/linux-x86-64/grpc_server
           fi
         shell: bash
       - name: ls spannerlib.so
@@ -71,3 +79,90 @@ jobs:
         run: mvn -Djna.debug_load=true test
         working-directory: spannerlib/wrappers/spannerlib-java
         shell: bash
+
+  dotnet-wrapper:
+    strategy:
+      matrix:
+        go-version: [1.25.x]
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Install dotnet
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '9.0.x'
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: 'true'
+      - name: Build shared library
+        working-directory: spannerlib/shared
+        run: go build -o spannerlib.so -buildmode=c-shared shared_lib.go
+      - name: Copy to .NET wrapper
+        working-directory: spannerlib
+        run: |
+          mkdir -p wrappers/spannerlib-dotnet/spannerlib-dotnet-native/libraries/any
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            cp shared/spannerlib.so wrappers/spannerlib-dotnet/spannerlib-dotnet-native/libraries/any/spannerlib.dll
+          else
+            cp shared/spannerlib.so wrappers/spannerlib-dotnet/spannerlib-dotnet-native/libraries/any/spannerlib
+          fi
+        shell: bash
+      - name: Build .NET native library package
+        run: dotnet pack
+        working-directory: spannerlib/wrappers/spannerlib-dotnet/spannerlib-dotnet-native
+        shell: bash
+      - name: Add .NET package source
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            echo ${GITHUB_WORKSPACE}"\spannerlib\wrappers\spannerlib-dotnet\spannerlib-dotnet-native\bin\Release"
+            dotnet nuget add source ${GITHUB_WORKSPACE}"\spannerlib\wrappers\spannerlib-dotnet\spannerlib-dotnet-native\bin\Release" --name local
+          else
+            dotnet nuget add source "$PWD"/bin/Release --name local
+          fi
+        working-directory: spannerlib/wrappers/spannerlib-dotnet/spannerlib-dotnet-native
+        shell: bash
+      - name: Build gRPC server
+        working-directory: spannerlib/grpc-server
+        run: |
+          go build -o grpc_server server.go
+          chmod +x grpc_server
+      - name: Copy gRPC server to .NET wrapper
+        working-directory: spannerlib
+        run: |
+          mkdir -p wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-server/binaries/any
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            cp grpc-server/grpc_server wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-server/binaries/any/grpc_server.exe
+          else
+            cp grpc-server/grpc_server wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-server/binaries/any/grpc_server
+          fi
+        shell: bash
+      - name: Build .NET gRPC server package
+        run: dotnet pack
+        working-directory: spannerlib/wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-server
+        shell: bash
+      - name: Add .NET package source
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            dotnet nuget add source ${GITHUB_WORKSPACE}"\spannerlib\wrappers\spannerlib-dotnet\spannerlib-dotnet-grpc-server\bin\Release" --name local-grpc-server
+          else
+            dotnet nuget add source "$PWD"/bin/Release --name local-grpc-server
+          fi
+        working-directory: spannerlib/wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-server
+        shell: bash
+      - name: Restore dependencies
+        run: dotnet restore
+        working-directory: spannerlib/wrappers/spannerlib-dotnet
+        shell: bash
+      - name: Build
+        run: dotnet build --no-restore
+        working-directory: spannerlib/wrappers/spannerlib-dotnet
+        shell: bash
+      - name: .NET Unit Tests
+        working-directory: spannerlib/wrappers/spannerlib-dotnet/spannerlib-dotnet-tests
+        run: dotnet test --no-build --verbosity normal
+        shell: bash

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "spannerlib/grpc-server/googleapis"]
+	path = spannerlib/grpc-server/googleapis
+	url = git@github.com:googleapis/googleapis.git

spannerlib/go.mod

@@ -10,7 +10,9 @@ require (
 	cloud.google.com/go/longrunning v0.6.7
 	cloud.google.com/go/spanner v1.86.0
 	github.com/google/go-cmp v0.7.0
+	github.com/google/uuid v1.6.0
 	github.com/googleapis/go-sql-spanner v1.19.0
+	google.golang.org/genproto/googleapis/api v0.0.0-20250818200422-3122310a409c
 	google.golang.org/grpc v1.76.0
 	google.golang.org/protobuf v1.36.10
 )
@@ -36,7 +38,6 @@ require (
 	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
 	github.com/golang/protobuf v1.5.4 // indirect
 	github.com/google/s2a-go v0.1.9 // indirect
-	github.com/google/uuid v1.6.0 // indirect
 	github.com/googleapis/enterprise-certificate-proxy v0.3.6 // indirect
 	github.com/googleapis/gax-go/v2 v2.15.0 // indirect
 	github.com/hashicorp/golang-lru/v2 v2.0.7 // indirect
@@ -62,6 +63,5 @@ require (
 	golang.org/x/time v0.13.0 // indirect
 	google.golang.org/api v0.252.0 // indirect
 	google.golang.org/genproto v0.0.0-20250804133106-a7a43d27e69b // indirect
-	google.golang.org/genproto/googleapis/api v0.0.0-20250818200422-3122310a409c // indirect
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20251007200510-49b9836ed3ff // indirect
 )

spannerlib/grpc-server/build-dotnet-darwin-aarch64.sh

@@ -0,0 +1,4 @@
+go build -o grpc_server server.go
+chmod +x grpc_server
+cp grpc_server ../wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc/binaries/any/grpc_server
+cp grpc_server ../wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc/binaries/osx-arm64/grpc_server

spannerlib/grpc-server/build-java-darwin-aarch64.sh

@@ -0,0 +1,4 @@
+go build -o grpc_server server.go
+chmod +x grpc_server
+mkdir -p ../wrappers/spannerlib-java/src/main/resources/darwin-aarch64
+cp grpc_server ../wrappers/spannerlib-java/src/main/resources/darwin-aarch64/grpc_server

spannerlib/grpc-server/build-protos.sh

@@ -0,0 +1,25 @@
+PATH="${PATH}:${HOME}/go/bin"
+ln -sf "${PWD}"/google/spannerlib googleapis/google/spannerlib
+cd googleapis || exit 1
+protoc \
+  --go_out=../ \
+  --go_opt=paths=source_relative \
+  --go-grpc_out=../ \
+  --go-grpc_opt=paths=source_relative \
+  google/spannerlib/v1/spannerlib.proto
+protoc \
+  --java_out=../../wrappers/spannerlib-java/src/main/java/ \
+  --plugin=protoc-gen-java-grpc=/Users/loite/protoc-gen-grpc-java-1.75.0-osx-aarch_64.exe \
+  --java-grpc_out=../../wrappers/spannerlib-java/src/main/java/ \
+  --java-grpc_opt=paths=source_relative \
+  google/spannerlib/v1/spannerlib.proto
+protoc \
+  --csharp_out=../../wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-v1/ \
+  --plugin=protoc-gen-csharp_grpc=/Users/loite/.nuget/packages/grpc.tools/2.72.0/tools/macosx_x64/grpc_csharp_plugin \
+  --csharp_grpc_out=../../wrappers/spannerlib-dotnet/spannerlib-dotnet-grpc-v1/ \
+  --csharp_opt=file_extension=.g.cs \
+  --csharp_grpc_opt=no_server \
+  --proto_path=. \
+  google/spannerlib/v1/spannerlib.proto
+cd .. || exit 1
+rm googleapis/google/spannerlib

spannerlib/grpc-server/google/spannerlib/spannerlib

@@ -0,0 +1 @@
+/Users/loite/GolandProjects/go-sql-spanner/spannerlib/grpc-server/google/spannerlib