Feat/tesktkit session run (#268)

- Authentication Refactor: Unified all auth methods under BoltConnection, removed protocol-version coupling, and standardized send()->getResponse() flow.
- Connection & Message Factory: BoltMessageFactory now uses the full connection; added state tracking, logging, and proper cleanup for unconsumed results.
- Transaction Handling: BoltUnmanagedTransaction now throws TransactionException; improved commit/rollback guards and clearer error messages.
 - Session Management: Added Session::close() to discard unconsumed results; centralized retry logic in TransactionHelper; improved connection tracking and cleanup.
 - TransactionHelper: Extracted and unified retry/rollback logic for consistent transaction error handling.
 - SummarizedResultFormatter: Unified handling of contains-system-updates vs system-updates for cross-version compatibility.
 - Query ID Tracking: Added qid to CypherList for query traceability.
 - AbstractRunner: Returns more precise error responses (DriverErrorResponse, TransactionException); simplified result extraction.
 - Retryable Messages: RetryablePositive now actually commits; RetryableNegative returns proper client error types.
 - Metadata Decoding: All transaction methods now decode CypherMap/CypherList metadata into structured PHP values.
 - DriverErrorResponse: Extended to differentiate Neo4jException and TransactionException.
 - Socket Timeout: Set 24-hour timeout to ensure persistent connections for long-running sessions.

Author: p123-stack

.github/workflows/testkit.yml

@@ -68,11 +68,5 @@ jobs:
 
       - name: Run integration tests
         run: |
-          docker compose up -d --remove-orphans --wait --no-build \
-            server1 \
-            server2 \
-            server3 \
-            server4 \
-            testkit_backend
-
-          docker compose run --rm testkit ./testkit.sh
+          docker compose up -d --remove-orphans --wait --no-build testkit_backend neo4j
+          docker compose up testkit

Dockerfile.neo4j-okta

@@ -28,7 +28,7 @@
         "psr/http-factory": "^1.0",
         "psr/http-client": "^1.0",
         "php-http/message": "^1.0",
-        "stefanak-michal/bolt": "^7.2.4",
+        "stefanak-michal/bolt": "^7.1.4",
         "symfony/polyfill-php80": "^1.2",
         "psr/simple-cache": ">=2.0",
         "ext-json": "*",

composer.json

@@ -53,7 +53,7 @@ services:
       - .env
   neo4j:
     <<: *common
-    image: neo4j:5.23-enterprise
+    image: neo4j:5-enterprise
     hostname: neo4j
     networks:
       - neo4j
@@ -62,7 +62,7 @@ services:
       - "11474:7474"
     environment:
       <<: *common-env
-      NEO4J_ACCEPT_LICENSE_AGREEMENT: 'yes'  # Also add this
+      NEO4J_ACCEPT_LICENSE_AGREEMENT: 'yes'
       NEO4J_server_bolt_advertised__address: neo4j:7687
       NEO4J_server_http_advertised__address: neo4j:7474
 
@@ -119,6 +119,7 @@ services:
 
   testkit:
     image: python:3.13
+    command: ./testkit.sh
     volumes:
       - .:/opt/project
     working_dir: /opt/project/testkit-backend
@@ -131,6 +132,9 @@ services:
       TEST_DRIVER_NAME: php
       TEST_DRIVER_REPO: /opt/project
       TEST_BACKEND_HOST: testkit_backend
+      TEST_STUB_HOST: testkit
+    depends_on:
+      - testkit_backend
 
   testkit_backend:
     <<: *common-php
@@ -141,7 +145,5 @@ services:
       - neo4j
     extra_hosts:
       - "host.docker.internal:host-gateway"
-    depends_on:
-      - neo4j
     ports:
       - "9876:9876"