fix: migrate transaction docs and examples to transactions() API (#373)

* fix: migrate transaction docs and examples to transactions() API

Move the write mode-selection Javadoc in OpenFgaClient and the example
projects off the double-negative disableTransactions(boolean) to the
affirmative transactions()/isTransactionsEnabled() API. Also switch the
internal write mode branch to !isTransactionsEnabled() so the SDK no longer
calls its own soon-to-be-deprecated method. Behavior is unchanged.

Test call sites that still use disableTransactions are intentionally left
for the deprecation issue, which will migrate them and keep one back-compat
test under @SuppressWarnings.

Refs #368

* fix: clarify write mode Javadoc for the no-options overload

Address review feedback. The write(request) overload takes no options, so
describing the mode as options.isTransactionsEnabled() implied a call on an
absent or null options reference. Reword both overloads to key the mode off
the transactions() setter and state that transactional mode is the default
when no options are passed.

Docs only, no behavior change.

Refs #368

Author: curfew-marathon

examples/basic-examples/src/main/java/dev/openfga/sdk/example/Example1.java

@@ -117,7 +117,7 @@ public void run(String apiUrl) throws Exception {
                                         // relation
                                         )),
                         new ClientWriteOptions()
-                                .disableTransactions(true)
+                                .transactions(false)
                                 .authorizationModelId(authorizationModel.getAuthorizationModelId()))
                 .get();
         System.out.println("Done Writing Tuples");

examples/basic-examples/src/main/kotlin/dev/openfga/sdk/example/KotlinExample1.kt

@@ -117,7 +117,7 @@ internal class KotlinExample1 {
                         )
                     ),
                 ClientWriteOptions()
-                    .disableTransactions(true)
+                    .transactions(false)
                     .authorizationModelId(authorizationModel.authorizationModelId)
             )
             .get()

src/main/java/dev/openfga/sdk/api/client/OpenFgaClient.java

@@ -412,7 +412,7 @@ public CompletableFuture<ClientReadResponse> read(ClientReadRequest request, Cli
      * <p>This method can operate in two modes depending on the options provided:</p>
      *
      * <h3>Transactional Mode (default)</h3>
-     * <p>When {@code options.disableTransactions()} is false or not set:</p>
+     * <p>Used by default, when no options are passed or when {@code transactions(true)} is set:</p>
      * <ul>
      *   <li>All writes and deletes are executed as a single atomic transaction</li>
      *   <li>If any tuple fails, the entire operation fails and no changes are made</li>
@@ -421,7 +421,7 @@ public CompletableFuture<ClientReadResponse> read(ClientReadRequest request, Cli
      * </ul>
      *
      * <h3>Non-Transactional Mode</h3>
-     * <p>When {@code options.disableTransactions()} is true:</p>
+     * <p>Used when {@code transactions(false)} is set on the options:</p>
      * <ul>
      *   <li>Tuples are processed in chunks (size controlled by {@code transactionChunkSize})</li>
      *   <li>Each chunk is processed independently - some may succeed while others fail</li>
@@ -466,7 +466,7 @@ public CompletableFuture<ClientWriteResponse> write(ClientWriteRequest request)
      * <p>This method can operate in two modes depending on the options provided:</p>
      *
      * <h3>Transactional Mode (default)</h3>
-     * <p>When {@code options.disableTransactions()} is false or not set:</p>
+     * <p>Used by default, when no options are passed or when {@code transactions(true)} is set:</p>
      * <ul>
      *   <li>All writes and deletes are executed as a single atomic transaction</li>
      *   <li>If any tuple fails, the entire operation fails and no changes are made</li>
@@ -475,7 +475,7 @@ public CompletableFuture<ClientWriteResponse> write(ClientWriteRequest request)
      * </ul>
      *
      * <h3>Non-Transactional Mode</h3>
-     * <p>When {@code options.disableTransactions()} is true:</p>
+     * <p>Used when {@code transactions(false)} is set on the options:</p>
      * <ul>
      *   <li>Tuples are processed in chunks (size controlled by {@code transactionChunkSize})</li>
      *   <li>Each chunk is processed independently - some may succeed while others fail</li>
@@ -515,7 +515,7 @@ public CompletableFuture<ClientWriteResponse> write(ClientWriteRequest request,
         configuration.assertValid();
         String storeId = configuration.getStoreIdChecked();
 
-        if (options != null && options.disableTransactions()) {
+        if (options != null && !options.isTransactionsEnabled()) {
             return writeNonTransaction(storeId, request, options);
         }
 

src/test-integration/java/dev/openfga/sdk/example/Example1.java

@@ -117,7 +117,7 @@ public void run(String apiUrl) throws Exception {
                                         // relation
                                         )),
                         new ClientWriteOptions()
-                                .disableTransactions(true)
+                                .transactions(false)
                                 .authorizationModelId(authorizationModel.getAuthorizationModelId()))
                 .get();
         System.out.println("Done Writing Tuples");