From b3a270c4bb71fc109642968652ff6ab99c73d9b6 Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Fri, 16 May 2025 21:11:00 +0000 Subject: [PATCH 1/2] feat(api): api update --- .stats.yml | 4 +- .../com/tryfinch/api/models/EmploymentData.kt | 9 ++-- .../api/models/EmploymentUpdateResponse.kt | 25 ++++++++--- .../models/SandboxDirectoryCreateParams.kt | 26 ++++++++--- .../models/SandboxEmploymentUpdateParams.kt | 45 ++++++++++++++----- 5 files changed, 83 insertions(+), 26 deletions(-) diff --git a/.stats.yml b/.stats.yml index 7e8e0176..2493b56b 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1,4 +1,4 @@ configured_endpoints: 45 -openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-dbbf65e94ae7a53cd5a313974761102447ccda3096fd40967c137ad3f80f7154.yml -openapi_spec_hash: 3cc9d87b60dc27283735d610d4b51a53 +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-944a0f9d35f3b8ec2ba62fa12e551cf89f0b845f8ed1e3c7f67a9fb80b32d96f.yml +openapi_spec_hash: 37c849e7b5dd941c011385b49467e077 config_hash: 53778a0b839c4f6ad34fbba051f5e8a6 diff --git a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentData.kt b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentData.kt index 3f09ee3b..bd97abad 100644 --- a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentData.kt +++ b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentData.kt @@ -320,7 +320,7 @@ private constructor( /** * Custom fields for the individual. These are fields which are defined by the employer in - * the system. + * the system. Custom fields are not currently supported for assisted connections. * * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the * server responded with an unexpected value). @@ -741,7 +741,7 @@ private constructor( /** * Custom fields for the individual. These are fields which are defined by the employer - * in the system. + * in the system. Custom fields are not currently supported for assisted connections. */ fun customFields(customFields: List?) = customFields(JsonField.ofNullable(customFields)) @@ -1285,7 +1285,10 @@ private constructor( additionalProperties = customField.additionalProperties.toMutableMap() } - fun name(name: String) = name(JsonField.of(name)) + fun name(name: String?) = name(JsonField.ofNullable(name)) + + /** Alias for calling [Builder.name] with `name.orElse(null)`. */ + fun name(name: Optional) = name(name.getOrNull()) /** * Sets [Builder.name] to an arbitrary JSON value. diff --git a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentUpdateResponse.kt b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentUpdateResponse.kt index bbd6076b..b0e8ea45 100644 --- a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentUpdateResponse.kt +++ b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/EmploymentUpdateResponse.kt @@ -143,7 +143,8 @@ private constructor( fun employment(): Optional = employment.getOptional("employment") /** - * The detailed employment status of the individual. + * The detailed employment status of the individual. Available options: `active`, `deceased`, + * `leave`, `onboarding`, `prehire`, `retired`, `terminated`. * * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the * server responded with an unexpected value). @@ -492,7 +493,12 @@ private constructor( * Custom fields for the individual. These are fields which are defined by the employer in * the system. Custom fields are not currently supported for assisted connections. */ - fun customFields(customFields: List) = customFields(JsonField.of(customFields)) + fun customFields(customFields: List?) = + customFields(JsonField.ofNullable(customFields)) + + /** Alias for calling [Builder.customFields] with `customFields.orElse(null)`. */ + fun customFields(customFields: Optional>) = + customFields(customFields.getOrNull()) /** * Sets [Builder.customFields] to an arbitrary JSON value. @@ -547,7 +553,10 @@ private constructor( */ fun employment(employment: JsonField) = apply { this.employment = employment } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ fun employmentStatus(employmentStatus: EmploymentStatus?) = employmentStatus(JsonField.ofNullable(employmentStatus)) @@ -741,7 +750,10 @@ private constructor( fun middleName(middleName: JsonField) = apply { this.middleName = middleName } /** The source system's unique employment identifier for this individual */ - fun sourceId(sourceId: String) = sourceId(JsonField.of(sourceId)) + fun sourceId(sourceId: String?) = sourceId(JsonField.ofNullable(sourceId)) + + /** Alias for calling [Builder.sourceId] with `sourceId.orElse(null)`. */ + fun sourceId(sourceId: Optional) = sourceId(sourceId.getOrNull()) /** * Sets [Builder.sourceId] to an arbitrary JSON value. @@ -1656,7 +1668,10 @@ private constructor( "Employment{subtype=$subtype, type=$type, additionalProperties=$additionalProperties}" } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, `deceased`, + * `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ class EmploymentStatus @JsonCreator private constructor(private val value: JsonField) : Enum { diff --git a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxDirectoryCreateParams.kt b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxDirectoryCreateParams.kt index e13ee7ac..2f14178b 100644 --- a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxDirectoryCreateParams.kt +++ b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxDirectoryCreateParams.kt @@ -291,7 +291,8 @@ private constructor( fun employment(): Optional = employment.getOptional("employment") /** - * The detailed employment status of the individual. + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. * * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the * server responded with an unexpected value). @@ -763,8 +764,12 @@ private constructor( * Custom fields for the individual. These are fields which are defined by the employer * in the system. Custom fields are not currently supported for assisted connections. */ - fun customFields(customFields: List) = - customFields(JsonField.of(customFields)) + fun customFields(customFields: List?) = + customFields(JsonField.ofNullable(customFields)) + + /** Alias for calling [Builder.customFields] with `customFields.orElse(null)`. */ + fun customFields(customFields: Optional>) = + customFields(customFields.getOrNull()) /** * Sets [Builder.customFields] to an arbitrary JSON value. @@ -865,7 +870,10 @@ private constructor( this.employment = employment } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ fun employmentStatus(employmentStatus: EmploymentStatus?) = employmentStatus(JsonField.ofNullable(employmentStatus)) @@ -1183,7 +1191,10 @@ private constructor( fun residence(residence: JsonField) = apply { this.residence = residence } /** The source system's unique employment identifier for this individual */ - fun sourceId(sourceId: String) = sourceId(JsonField.of(sourceId)) + fun sourceId(sourceId: String?) = sourceId(JsonField.ofNullable(sourceId)) + + /** Alias for calling [Builder.sourceId] with `sourceId.orElse(null)`. */ + fun sourceId(sourceId: Optional) = sourceId(sourceId.getOrNull()) /** * Sets [Builder.sourceId] to an arbitrary JSON value. @@ -2447,7 +2458,10 @@ private constructor( "Employment{subtype=$subtype, type=$type, additionalProperties=$additionalProperties}" } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ class EmploymentStatus @JsonCreator private constructor(private val value: JsonField) : Enum { diff --git a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxEmploymentUpdateParams.kt b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxEmploymentUpdateParams.kt index ce9ed3e1..ef6429a9 100644 --- a/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxEmploymentUpdateParams.kt +++ b/finch-java-core/src/main/kotlin/com/tryfinch/api/models/SandboxEmploymentUpdateParams.kt @@ -67,7 +67,8 @@ private constructor( fun employment(): Optional = body.employment() /** - * The detailed employment status of the individual. + * The detailed employment status of the individual. Available options: `active`, `deceased`, + * `leave`, `onboarding`, `prehire`, `retired`, `terminated`. * * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the * server responded with an unexpected value). @@ -373,10 +374,14 @@ private constructor( * Custom fields for the individual. These are fields which are defined by the employer in * the system. Custom fields are not currently supported for assisted connections. */ - fun customFields(customFields: List) = apply { + fun customFields(customFields: List?) = apply { body.customFields(customFields) } + /** Alias for calling [Builder.customFields] with `customFields.orElse(null)`. */ + fun customFields(customFields: Optional>) = + customFields(customFields.getOrNull()) + /** * Sets [Builder.customFields] to an arbitrary JSON value. * @@ -425,7 +430,10 @@ private constructor( */ fun employment(employment: JsonField) = apply { body.employment(employment) } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ fun employmentStatus(employmentStatus: EmploymentStatus?) = apply { body.employmentStatus(employmentStatus) } @@ -617,7 +625,10 @@ private constructor( fun middleName(middleName: JsonField) = apply { body.middleName(middleName) } /** The source system's unique employment identifier for this individual */ - fun sourceId(sourceId: String) = apply { body.sourceId(sourceId) } + fun sourceId(sourceId: String?) = apply { body.sourceId(sourceId) } + + /** Alias for calling [Builder.sourceId] with `sourceId.orElse(null)`. */ + fun sourceId(sourceId: Optional) = sourceId(sourceId.getOrNull()) /** * Sets [Builder.sourceId] to an arbitrary JSON value. @@ -925,7 +936,8 @@ private constructor( fun employment(): Optional = employment.getOptional("employment") /** - * The detailed employment status of the individual. + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. * * @throws FinchInvalidDataException if the JSON field has an unexpected type (e.g. if the * server responded with an unexpected value). @@ -1259,8 +1271,12 @@ private constructor( * Custom fields for the individual. These are fields which are defined by the employer * in the system. Custom fields are not currently supported for assisted connections. */ - fun customFields(customFields: List) = - customFields(JsonField.of(customFields)) + fun customFields(customFields: List?) = + customFields(JsonField.ofNullable(customFields)) + + /** Alias for calling [Builder.customFields] with `customFields.orElse(null)`. */ + fun customFields(customFields: Optional>) = + customFields(customFields.getOrNull()) /** * Sets [Builder.customFields] to an arbitrary JSON value. @@ -1319,7 +1335,10 @@ private constructor( this.employment = employment } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, + * `deceased`, `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ fun employmentStatus(employmentStatus: EmploymentStatus?) = employmentStatus(JsonField.ofNullable(employmentStatus)) @@ -1521,7 +1540,10 @@ private constructor( fun middleName(middleName: JsonField) = apply { this.middleName = middleName } /** The source system's unique employment identifier for this individual */ - fun sourceId(sourceId: String) = sourceId(JsonField.of(sourceId)) + fun sourceId(sourceId: String?) = sourceId(JsonField.ofNullable(sourceId)) + + /** Alias for calling [Builder.sourceId] with `sourceId.orElse(null)`. */ + fun sourceId(sourceId: Optional) = sourceId(sourceId.getOrNull()) /** * Sets [Builder.sourceId] to an arbitrary JSON value. @@ -2455,7 +2477,10 @@ private constructor( "Employment{subtype=$subtype, type=$type, additionalProperties=$additionalProperties}" } - /** The detailed employment status of the individual. */ + /** + * The detailed employment status of the individual. Available options: `active`, `deceased`, + * `leave`, `onboarding`, `prehire`, `retired`, `terminated`. + */ class EmploymentStatus @JsonCreator private constructor(private val value: JsonField) : Enum { From dd93e33878f4caee19d8d5b0ec28d6d73a00236b Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Fri, 16 May 2025 21:11:23 +0000 Subject: [PATCH 2/2] release: 7.2.0 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 8 ++++++++ README.md | 10 +++++----- build.gradle.kts | 2 +- 4 files changed, 15 insertions(+), 7 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index c09ad87a..ad42ef71 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "7.1.0" + ".": "7.2.0" } \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 13c5622d..bc506e14 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 7.2.0 (2025-05-16) + +Full Changelog: [v7.1.0...v7.2.0](https://github.com/Finch-API/finch-api-java/compare/v7.1.0...v7.2.0) + +### Features + +* **api:** api update ([b3a270c](https://github.com/Finch-API/finch-api-java/commit/b3a270c4bb71fc109642968652ff6ab99c73d9b6)) + ## 7.1.0 (2025-05-16) Full Changelog: [v7.0.0...v7.1.0](https://github.com/Finch-API/finch-api-java/compare/v7.0.0...v7.1.0) diff --git a/README.md b/README.md index 5aae37e8..bdb48061 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,8 @@ -[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/7.1.0) -[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/7.1.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/7.1.0) +[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/7.2.0) +[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/7.2.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/7.2.0) @@ -15,7 +15,7 @@ It is generated with [Stainless](https://www.stainless.com/). -The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/7.1.0). +The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/7.2.0). @@ -26,7 +26,7 @@ The REST API documentation can be found on [developer.tryfinch.com](https://deve ### Gradle ```kotlin -implementation("com.tryfinch.api:finch-java:7.1.0") +implementation("com.tryfinch.api:finch-java:7.2.0") ``` ### Maven @@ -35,7 +35,7 @@ implementation("com.tryfinch.api:finch-java:7.1.0") com.tryfinch.api finch-java - 7.1.0 + 7.2.0 ``` diff --git a/build.gradle.kts b/build.gradle.kts index 32793b7d..003509c6 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -8,7 +8,7 @@ repositories { allprojects { group = "com.tryfinch.api" - version = "7.1.0" // x-release-please-version + version = "7.2.0" // x-release-please-version } subprojects {