feat: update from fork

Feat/streamed list objects consumer

Author: SoulPancake

examples/streamed-list-objects/Makefile

@@ -0,0 +1,16 @@
+.PHONY: build run run-openfga
+all: build
+
+project_name=.
+openfga_version=latest
+language=java
+
+build:
+	./gradlew -P language=$(language) build
+
+run:
+	./gradlew -P language=$(language) run
+
+run-openfga:
+	docker pull docker.io/openfga/openfga:${openfga_version} && \
+		docker run -p 8080:8080 docker.io/openfga/openfga:${openfga_version} run

examples/streamed-list-objects/README.md

@@ -0,0 +1,82 @@
+# Streamed List Objects example for OpenFGA's Java SDK
+
+This example demonstrates working with the `POST` `/stores/:id/streamed-list-objects` endpoint in OpenFGA using the Java SDK.
+
+## Prerequisites
+
+If you do not already have an OpenFGA instance running, you can start one using the following command:
+
+```bash
+make run-openfga
+```
+
+Or directly with docker:
+
+```bash
+docker run -d -p 8080:8080 openfga/openfga run
+```
+
+## Configure the example
+
+You may need to configure the example for your environment by setting environment variables:
+
+```bash
+export FGA_API_URL=http://localhost:8080
+```
+
+Optional authentication configuration:
+```bash
+export FGA_CLIENT_ID=your-client-id
+export FGA_CLIENT_SECRET=your-client-secret
+export FGA_API_AUDIENCE=your-api-audience
+export FGA_API_TOKEN_ISSUER=your-token-issuer
+```
+
+## Running the example
+
+Build the project:
+
+```bash
+make build
+```
+
+Run the example:
+
+```bash
+make run
+```
+
+This will:
+1. Create a temporary store
+2. Create an authorization model
+3. Write 100 mock tuples
+4. Stream all objects using the `streamedListObjects` API
+5. Display each object as it's received
+6. Clean up the temporary store
+
+## What to expect
+
+The example will output each object as it's streamed from the server:
+
+```
+Created temporary store (01HXXX...)
+Created temporary authorization model (01GXXX...)
+Writing 100 mock tuples to store.
+Listing objects using streaming endpoint:
+  document:0
+  document:1
+  document:2
+  ...
+  document:99
+API returned 100 objects.
+Deleted temporary store (01HXXX...)
+Finished.
+```
+
+## Note
+
+The streaming API is particularly useful when dealing with large result sets, as it:
+- Reduces memory usage by processing objects one at a time
+- Provides faster time-to-first-result
+- Allows for real-time processing of results
+- Is only limited by execution timeout rather than result set size

examples/streamed-list-objects/build.gradle

@@ -0,0 +1,63 @@
+plugins {
+    id 'application'
+    id 'com.diffplug.spotless' version '8.0.0'
+}
+
+application {
+    mainClass = 'dev.openfga.sdk.example.StreamedListObjectsExample'
+}
+
+repositories {
+    mavenCentral()
+}
+
+ext {
+    jacksonVersion = "2.18.2"
+}
+
+dependencies {
+    // Use local build of SDK
+    implementation files('../../build/libs/openfga-sdk-0.9.2.jar')
+
+    // Serialization
+    implementation("com.fasterxml.jackson.core:jackson-core:$jacksonVersion")
+    implementation("com.fasterxml.jackson.core:jackson-annotations:$jacksonVersion")
+    implementation("com.fasterxml.jackson.core:jackson-databind:$jacksonVersion")
+    implementation("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:$jacksonVersion")
+    implementation("org.openapitools:jackson-databind-nullable:0.2.7")
+
+    // OpenTelemetry (required by SDK)
+    implementation platform("io.opentelemetry:opentelemetry-bom:1.54.1")
+    implementation "io.opentelemetry:opentelemetry-api"
+
+    // JSR305 (required by SDK)
+    implementation "com.google.code.findbugs:jsr305:3.0.2"
+}
+
+// Use spotless plugin to automatically format code, remove unused import, etc
+// To apply changes directly to the file, run `gradlew spotlessApply`
+// Ref: https://github.com/diffplug/spotless/tree/main/plugin-gradle
+spotless {
+    // comment out below to run spotless as part of the `check` task
+    enforceCheck false
+    format 'misc', {
+        // define the files (e.g. '*.gradle', '*.md') to apply `misc` to
+        target '.gitignore'
+        // define the steps to apply to those files
+        trimTrailingWhitespace()
+        indentWithSpaces() // Takes an integer argument if you don't like 4
+        endWithNewline()
+    }
+    java {
+        palantirJavaFormat()
+        removeUnusedImports()
+        importOrder()
+    }
+}
+
+// Use spotless plugin to automatically format code, remove unused import, etc
+// To apply changes directly to the file, run `gradlew spotlessApply`
+// Ref: https://github.com/diffplug/spotless/tree/main/plugin-gradle
+tasks.register('fmt') {
+    dependsOn 'spotlessApply'
+}

examples/streamed-list-objects/gradle.properties

@@ -0,0 +1 @@
+language=java

examples/streamed-list-objects/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists