API Models BatchTupleResultInterface - evansims/openfga-php GitHub Wiki
Interface for batch tuple operation results. Defines the contract for tracking and analyzing the results of batch tuple operations, including success rates, responses, and error handling.
Table of Contents
OpenFGA\Models
ModelInterface
JsonSerializable
- BatchTupleResult (implementation)
public function getErrors(): array<Throwable>
Get all errors from failed chunks.
array<
Throwable>
— Errors from failed API calls
public function getFailedChunks(): int
Get the number of chunks that failed.
int
— Number of failed API requests
public function getFirstError(): Throwable|null
Get the first error that occurred.
Throwable
| null
— The first error, or null if no errors occurred
public function getResponses(): array<mixed>
Get all successful responses from completed chunks.
array<
mixed>
— Responses from successful API calls
public function getSuccessRate(): float
Calculate the success rate as a percentage.
float
— Success rate from 0.0 to 1.0
public function getSuccessfulChunks(): int
Get the number of chunks that completed successfully.
int
— Number of successful API requests
public function getTotalChunks(): int
Get the total number of chunks that were processed.
int
— Number of API requests made
public function getTotalOperations(): int
Get the total number of tuple operations that were requested.
int
— Total operations across all chunks
public function isCompleteFailure(): bool
Check if all chunks failed.
bool
— True if no chunks succeeded
public function isCompleteSuccess(): bool
Check if all chunks completed successfully.
bool
— True if no chunks failed
public function isPartialSuccess(): bool
Check if some chunks succeeded and some failed.
bool
— True if there were both successes and failures
public function jsonSerialize()
public function throwOnFailure(): void
Throw an exception if any chunks failed. If there were failures, throws the first error that occurred. This is useful for treating partial failures as complete failures when strict error handling is required.
void