Skip to content

Commit 1de836f

Browse files
github-actions[bot]speakeasybotspeakeasy-github[bot]
authored
chore: 🐝 Update SDK - Generate 0.12.1 (#26)
* ## SDK Changes Detected: * `stackone.hris.listEmployeeTimeOffRequests()`: `response.data.[]` **Changed** **Breaking** ⚠️ * `stackone.hris.getEmployeesTimeOffRequest()`: `response.data` **Changed** **Breaking** ⚠️ * `stackone.hris.listTimeOffRequests()`: `response.data.[]` **Changed** **Breaking** ⚠️ * `stackone.hris.getTimeOffRequest()`: `response.data` **Changed** **Breaking** ⚠️ * empty commit to trigger [run-tests] workflow --------- Co-authored-by: speakeasybot <bot@speakeasyapi.dev> Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
1 parent 3424a70 commit 1de836f

File tree

12 files changed

+169
-91
lines changed

12 files changed

+169
-91
lines changed

‎.speakeasy/gen.lock‎

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
lockVersion: 2.0.0
22
id: 90080b12-9e47-459d-875f-5a0a3b2545d2
33
management:
4-
docChecksum: 1d1ba8d67210928dd7dae6d13dace15a
4+
docChecksum: 1420fe44878fd7285097f674d59f7821
55
docVersion: 1.0.0
66
speakeasyVersion: 1.606.9
77
generationVersion: 2.687.13
8-
releaseVersion: 0.11.0
9-
configChecksum: 6ba0671cefcdde628fb8f716868a09a8
8+
releaseVersion: 0.12.1
9+
configChecksum: 13c01c36beb5ad25574a313eb3e22967
1010
repoURL: https://github.com/StackOneHQ/stackone-client-java.git
1111
published: true
1212
features:
@@ -6060,7 +6060,7 @@ examples:
60606060
x-account-id: "<id>"
60616061
responses:
60626062
"200":
6063-
application/json: {"data": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "created_date": "2021-01-01T01:01:01.000Z", "updated_date": "2021-01-01T01:01:01.000Z", "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}}]}
6063+
application/json: {"data": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}}]}
60646064
"400":
60656065
application/json: {"statusCode": 400, "message": "Bad Request", "timestamp": "2023-05-30T00:00:00.000Z", "data": {"statusCode": 400, "message": "Bad Request", "headers": {}}, "provider_errors": [{"status": 400, "url": "https://api.provider.com/v1/resource", "raw": {}, "headers": {}}]}
60666066
"401":
@@ -6134,7 +6134,7 @@ examples:
61346134
x-account-id: "<id>"
61356135
responses:
61366136
"200":
6137-
application/json: {"data": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "created_date": "2021-01-01T01:01:01.000Z", "updated_date": "2021-01-01T01:01:01.000Z", "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}, "comment": "Taking a day off for personal reasons"}}
6137+
application/json: {"data": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z", "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}, "comment": "Taking a day off for personal reasons"}}
61386138
"400":
61396139
application/json: {"statusCode": 400, "message": "Bad Request", "timestamp": "2023-05-30T00:00:00.000Z", "data": null, "provider_errors": [{"status": 400, "url": "https://api.provider.com/v1/resource", "raw": {}, "headers": {}}]}
61406140
"401":
@@ -7085,7 +7085,7 @@ examples:
70857085
x-account-id: "<id>"
70867086
responses:
70877087
"200":
7088-
application/json: {"data": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "created_date": "2021-01-01T01:01:01.000Z", "updated_date": "2021-01-01T01:01:01.000Z", "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}, "comment": "Taking a day off for personal reasons"}}
7088+
application/json: {"data": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "employee_id": "1687-3", "remote_employee_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "approver_id": "1687-4", "remote_approver_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "start_date": "2021-01-01T01:01:01.000", "end_date": "2021-01-01T01:01:01.000", "start_half_day": true, "end_half_day": true, "duration": "P3Y6M4DT12H30M5S", "time_off_policy_id": "cx280928933", "remote_time_off_policy_id": "e3cb75bf-aa84-466e-a6c1-b8322b257a48", "reason": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}, "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z", "policy": {"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "name": "Holidays", "description": "Usable for regional and national holidays of employees.", "type": {"value": "holiday"}, "duration_unit": {"value": "hours"}, "reasons": [{"id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3", "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"}], "created_at": "2021-01-01T01:01:01.000Z", "updated_at": "2021-01-01T01:01:01.000Z"}, "comment": "Taking a day off for personal reasons"}}
70897089
"400":
70907090
application/json: {"statusCode": 400, "message": "Bad Request", "timestamp": "2023-05-30T00:00:00.000Z", "data": {"statusCode": 400, "message": "Bad Request", "headers": {}}, "provider_errors": [{"status": 400, "url": "https://api.provider.com/v1/resource", "raw": {}, "headers": {}}]}
70917091
"401":
@@ -15709,8 +15709,7 @@ examplesVersion: 1.0.2
1570915709
generatedTests: {}
1571015710
releaseNotes: |
1571115711
## SDK Changes Detected:
15712-
* `stackone.hris.downloadEmployeeDocument()`: `response` **Changed** **Breaking** :warning:
15713-
* `stackone.ats.downloadApplicationDocument()`: `response` **Changed** **Breaking** :warning:
15714-
* `stackone.ticketing.downloadTicketingAttachment()`: `response` **Changed** **Breaking** :warning:
15715-
* `stackone.documents.downloadFile()`: `response` **Changed** **Breaking** :warning:
15716-
* `stackone.messaging.downloadMessagingAttachment()`: `response` **Changed** **Breaking** :warning:
15712+
* `stackone.hris.listEmployeeTimeOffRequests()`: `response.data.[]` **Changed** **Breaking** :warning:
15713+
* `stackone.hris.getEmployeesTimeOffRequest()`: `response.data` **Changed** **Breaking** :warning:
15714+
* `stackone.hris.listTimeOffRequests()`: `response.data.[]` **Changed** **Breaking** :warning:
15715+
* `stackone.hris.getTimeOffRequest()`: `response.data` **Changed** **Breaking** :warning:

‎.speakeasy/gen.yaml‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,10 +21,11 @@ generation:
2121
generateNewTests: false
2222
skipResponseBodyAssertions: false
2323
java:
24-
version: 0.11.0
24+
version: 0.12.1
2525
additionalDependencies: []
2626
additionalPlugins: []
2727
artifactID: stackone-client-java
28+
asyncMode: enabled
2829
baseErrorName: StackOneError
2930
clientServerStatusCodesAsErrors: true
3031
companyEmail: contact@stackone.com
@@ -33,6 +34,7 @@ java:
3334
defaultErrorName: SDKError
3435
enableAsync: false
3536
enableCustomCodeRegions: false
37+
enableStreamingUploads: false
3638
flattenGlobalSecurity: true
3739
githubURL: github.com/owner/repo
3840
groupID: com.stackone

‎.speakeasy/workflow.lock‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,20 @@ speakeasyVersion: 1.606.9
22
sources:
33
StackOne-OAS:
44
sourceNamespace: stackone-oas
5-
sourceRevisionDigest: sha256:71e6401670a8823188081589486a2d7f318244c0d25e2137d5a047d348fda0fb
6-
sourceBlobDigest: sha256:f5765d18bcbb70aef9deacf294fa2134ef50275bc88abacdc989370a7dbf08df
5+
sourceRevisionDigest: sha256:ff752927de69874fc3cf39f9c3bb3b1a4be37ecd336cb2bf483447014af80c19
6+
sourceBlobDigest: sha256:66eac07cc9c97d84eb653685050371f759bafa988fb7bac816e1e65b026a2b65
77
tags:
88
- latest
9-
- speakeasy-sdk-regen-1756425972
9+
- speakeasy-sdk-regen-1756997949
1010
- 1.0.0
1111
targets:
1212
stackone:
1313
source: StackOne-OAS
1414
sourceNamespace: stackone-oas
15-
sourceRevisionDigest: sha256:71e6401670a8823188081589486a2d7f318244c0d25e2137d5a047d348fda0fb
16-
sourceBlobDigest: sha256:f5765d18bcbb70aef9deacf294fa2134ef50275bc88abacdc989370a7dbf08df
15+
sourceRevisionDigest: sha256:ff752927de69874fc3cf39f9c3bb3b1a4be37ecd336cb2bf483447014af80c19
16+
sourceBlobDigest: sha256:66eac07cc9c97d84eb653685050371f759bafa988fb7bac816e1e65b026a2b65
1717
codeSamplesNamespace: stack-one-oas-java-code-samples
18-
codeSamplesRevisionDigest: sha256:947229253c215b075bdc9965b84797ea41281f9ca2bab8e80186955f343c3ead
18+
codeSamplesRevisionDigest: sha256:102b53c788924d49f1d860c82de131740ae7094560249bb1efad197579b5b435
1919
workflow:
2020
workflowVersion: 1.0.0
2121
speakeasyVersion: latest

‎README.md‎

Lines changed: 69 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Accounting: The documentation for the StackOne Unified API - ACCOUNTING
2525
* [Retries](#retries)
2626
* [Error Handling](#error-handling)
2727
* [Server Selection](#server-selection)
28+
* [Asynchronous Support](#asynchronous-support)
2829
* [Authentication](#authentication)
2930
* [Debugging](#debugging)
3031
* [Development](#development)
@@ -44,15 +45,15 @@ The samples below show how a published SDK artifact is used:
4445

4546
Gradle:
4647
```groovy
47-
implementation 'com.stackone:stackone-client-java:0.11.0'
48+
implementation 'com.stackone:stackone-client-java:0.12.1'
4849
```
4950

5051
Maven:
5152
```xml
5253
<dependency>
5354
<groupId>com.stackone</groupId>
5455
<artifactId>stackone-client-java</artifactId>
55-
<version>0.11.0</version>
56+
<version>0.12.1</version>
5657
</dependency>
5758
```
5859

@@ -795,6 +796,72 @@ public class Application {
795796
```
796797
<!-- End Server Selection [server] -->
797798

799+
<!-- Start Asynchronous Support [async-support] -->
800+
## Asynchronous Support
801+
802+
The SDK provides comprehensive asynchronous support using Java's [`CompletableFuture<T>`][comp-fut] and [Reactive Streams `Publisher<T>`][reactive-streams] APIs. This design makes no assumptions about your choice of reactive toolkit, allowing seamless integration with any reactive library.
803+
804+
<details>
805+
<summary>Why Use Async?</summary>
806+
807+
Asynchronous operations provide several key benefits:
808+
809+
- **Non-blocking I/O**: Your threads stay free for other work while operations are in flight
810+
- **Better resource utilization**: Handle more concurrent operations with fewer threads
811+
- **Improved scalability**: Build highly responsive applications that can handle thousands of concurrent requests
812+
- **Reactive integration**: Works seamlessly with reactive streams and backpressure handling
813+
814+
</details>
815+
816+
<details>
817+
<summary>Reactive Library Integration</summary>
818+
819+
The SDK returns [Reactive Streams `Publisher<T>`][reactive-streams] instances for operations dealing with streams involving multiple I/O interactions. We use Reactive Streams instead of JDK Flow API to provide broader compatibility with the reactive ecosystem, as most reactive libraries natively support Reactive Streams.
820+
821+
**Why Reactive Streams over JDK Flow?**
822+
- **Broader ecosystem compatibility**: Most reactive libraries (Project Reactor, RxJava, Akka Streams, etc.) natively support Reactive Streams
823+
- **Industry standard**: Reactive Streams is the de facto standard for reactive programming in Java
824+
- **Better interoperability**: Seamless integration without additional adapters for most use cases
825+
826+
**Integration with Popular Libraries:**
827+
- **Project Reactor**: Use `Flux.from(publisher)` to convert to Reactor types
828+
- **RxJava**: Use `Flowable.fromPublisher(publisher)` for RxJava integration
829+
- **Akka Streams**: Use `Source.fromPublisher(publisher)` for Akka Streams integration
830+
- **Vert.x**: Use `ReadStream.fromPublisher(vertx, publisher)` for Vert.x reactive streams
831+
- **Mutiny**: Use `Multi.createFrom().publisher(publisher)` for Quarkus Mutiny integration
832+
833+
**For JDK Flow API Integration:**
834+
If you need JDK Flow API compatibility (e.g., for Quarkus/Mutiny 2), you can use adapters:
835+
```java
836+
// Convert Reactive Streams Publisher to Flow Publisher
837+
Flow.Publisher<T> flowPublisher = FlowAdapters.toFlowPublisher(reactiveStreamsPublisher);
838+
839+
// Convert Flow Publisher to Reactive Streams Publisher
840+
Publisher<T> reactiveStreamsPublisher = FlowAdapters.toPublisher(flowPublisher);
841+
```
842+
843+
For standard single-response operations, the SDK returns `CompletableFuture<T>` for straightforward async execution.
844+
845+
</details>
846+
847+
<details>
848+
<summary>Supported Operations</summary>
849+
850+
Async support is available for:
851+
852+
- **[Server-sent Events](#server-sent-event-streaming)**: Stream real-time events with Reactive Streams `Publisher<T>`
853+
- **[JSONL Streaming](#jsonl-streaming)**: Process streaming JSON lines asynchronously
854+
- **[Pagination](#pagination)**: Iterate through paginated results using `callAsPublisher()` and `callAsPublisherUnwrapped()`
855+
- **[File Uploads](#file-uploads)**: Upload files asynchronously with progress tracking
856+
- **[File Downloads](#file-downloads)**: Download files asynchronously with streaming support
857+
- **[Standard Operations](#example)**: All regular API calls return `CompletableFuture<T>` for async execution
858+
859+
</details>
860+
861+
[comp-fut]: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
862+
[reactive-streams]: https://www.reactive-streams.org/
863+
<!-- End Asynchronous Support [async-support] -->
864+
798865
<!-- Start Authentication [security] -->
799866
## Authentication
800867

‎RELEASES.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -198,4 +198,14 @@ Based on:
198198
### Generated
199199
- [java v0.11.0] .
200200
### Releases
201-
- [Maven Central v0.11.0] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.11.0 - .
201+
- [Maven Central v0.11.0] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.11.0 - .
202+
203+
## 2025-09-04 14:58:45
204+
### Changes
205+
Based on:
206+
- OpenAPI Doc
207+
- Speakeasy CLI 1.606.9 (2.687.13) https://github.com/speakeasy-api/speakeasy
208+
### Generated
209+
- [java v0.12.1] .
210+
### Releases
211+
- [Maven Central v0.12.1] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.12.1 - .

‎build.gradle‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ publishing {
105105
// https://github.com/gradle/gradle/issues/18619
106106
groupId = "com.stackone"
107107
artifactId = "stackone-client-java"
108-
version = "0.11.0"
108+
version = "0.12.1"
109109

110110
from components.java
111111

0 commit comments

Comments
 (0)