candidhealth 0.18.2 → 0.22.2-15e24b1

package/Client.d.ts

@@ -10,8 +10,10 @@ import { Eligibility } from "./api/resources/eligibility/client/Client";
 import { Encounters } from "./api/resources/encounters/client/Client";
 import { ExpectedNetworkStatus } from "./api/resources/expectedNetworkStatus/client/Client";
 import { Exports } from "./api/resources/exports/client/Client";
+import { ExternalPaymentAccountConfig } from "./api/resources/externalPaymentAccountConfig/client/Client";
 import { FeeSchedules } from "./api/resources/feeSchedules/client/Client";
 import { Guarantor } from "./api/resources/guarantor/client/Client";
+import { ImportInvoice } from "./api/resources/importInvoice/client/Client";
 import { InsuranceAdjudications } from "./api/resources/insuranceAdjudications/client/Client";
 import { InsurancePayments } from "./api/resources/insurancePayments/client/Client";
 import { InsuranceRefunds } from "./api/resources/insuranceRefunds/client/Client";
@@ -25,13 +27,20 @@ import { WriteOffs } from "./api/resources/writeOffs/client/Client";
 import { ServiceFacility } from "./api/resources/serviceFacility/client/Client";
 export declare namespace CandidApiClient {
     interface Options {
-        environment?: environments.CandidApiEnvironment | string;
-        token?: core.Supplier<core.BearerToken | undefined>;
+        environment?: core.Supplier<environments.CandidApiEnvironment | string>;
+        clientId: core.Supplier<string>;
+        clientSecret: core.Supplier<string>;
+    }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
     }
 }
 export declare class CandidApiClient {
-    protected readonly options: CandidApiClient.Options;
-    constructor(options: CandidApiClient.Options);
+    protected readonly _options: CandidApiClient.Options;
+    private readonly _oauthTokenProvider;
+    constructor(_options: CandidApiClient.Options);
     protected _auth: Auth | undefined;
     get auth(): Auth;
     protected _billingNotes: BillingNotes | undefined;
@@ -46,10 +55,14 @@ export declare class CandidApiClient {
     get expectedNetworkStatus(): ExpectedNetworkStatus;
     protected _exports: Exports | undefined;
     get exports(): Exports;
+    protected _externalPaymentAccountConfig: ExternalPaymentAccountConfig | undefined;
+    get externalPaymentAccountConfig(): ExternalPaymentAccountConfig;
     protected _feeSchedules: FeeSchedules | undefined;
     get feeSchedules(): FeeSchedules;
     protected _guarantor: Guarantor | undefined;
     get guarantor(): Guarantor;
+    protected _importInvoice: ImportInvoice | undefined;
+    get importInvoice(): ImportInvoice;
     protected _insuranceAdjudications: InsuranceAdjudications | undefined;
     get insuranceAdjudications(): InsuranceAdjudications;
     protected _insurancePayments: InsurancePayments | undefined;

package/Client.js

@@ -2,112 +2,162 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CandidApiClient = void 0;
-const Client_1 = require("./api/resources/auth/client/Client");
-const Client_2 = require("./api/resources/billingNotes/client/Client");
-const Client_3 = require("./api/resources/contracts/client/Client");
-const Client_4 = require("./api/resources/eligibility/client/Client");
-const Client_5 = require("./api/resources/encounters/client/Client");
-const Client_6 = require("./api/resources/expectedNetworkStatus/client/Client");
-const Client_7 = require("./api/resources/exports/client/Client");
-const Client_8 = require("./api/resources/feeSchedules/client/Client");
-const Client_9 = require("./api/resources/guarantor/client/Client");
-const Client_10 = require("./api/resources/insuranceAdjudications/client/Client");
-const Client_11 = require("./api/resources/insurancePayments/client/Client");
-const Client_12 = require("./api/resources/insuranceRefunds/client/Client");
-const Client_13 = require("./api/resources/organizationServiceFacilities/client/Client");
-const Client_14 = require("./api/resources/organizationProviders/client/Client");
-const Client_15 = require("./api/resources/patientPayments/client/Client");
-const Client_16 = require("./api/resources/patientRefunds/client/Client");
-const Client_17 = require("./api/resources/payers/client/Client");
-const Client_18 = require("./api/resources/tasks/client/Client");
-const Client_19 = require("./api/resources/writeOffs/client/Client");
-const Client_20 = require("./api/resources/serviceFacility/client/Client");
+const core = __importStar(require("./core"));
+const Client_1 = require("./api/resources/auth/resources/v2/client/Client");
+const Client_2 = require("./api/resources/auth/client/Client");
+const Client_3 = require("./api/resources/billingNotes/client/Client");
+const Client_4 = require("./api/resources/contracts/client/Client");
+const Client_5 = require("./api/resources/eligibility/client/Client");
+const Client_6 = require("./api/resources/encounters/client/Client");
+const Client_7 = require("./api/resources/expectedNetworkStatus/client/Client");
+const Client_8 = require("./api/resources/exports/client/Client");
+const Client_9 = require("./api/resources/externalPaymentAccountConfig/client/Client");
+const Client_10 = require("./api/resources/feeSchedules/client/Client");
+const Client_11 = require("./api/resources/guarantor/client/Client");
+const Client_12 = require("./api/resources/importInvoice/client/Client");
+const Client_13 = require("./api/resources/insuranceAdjudications/client/Client");
+const Client_14 = require("./api/resources/insurancePayments/client/Client");
+const Client_15 = require("./api/resources/insuranceRefunds/client/Client");
+const Client_16 = require("./api/resources/organizationServiceFacilities/client/Client");
+const Client_17 = require("./api/resources/organizationProviders/client/Client");
+const Client_18 = require("./api/resources/patientPayments/client/Client");
+const Client_19 = require("./api/resources/patientRefunds/client/Client");
+const Client_20 = require("./api/resources/payers/client/Client");
+const Client_21 = require("./api/resources/tasks/client/Client");
+const Client_22 = require("./api/resources/writeOffs/client/Client");
+const Client_23 = require("./api/resources/serviceFacility/client/Client");
 class CandidApiClient {
-    options;
-    constructor(options) {
-        this.options = options;
+    constructor(_options) {
+        this._options = _options;
+        this._oauthTokenProvider = new core.OAuthTokenProvider({
+            clientId: this._options.clientId,
+            clientSecret: this._options.clientSecret,
+            authClient: new Client_1.V2({
+                environment: this._options.environment,
+            }),
+        });
     }
-    _auth;
     get auth() {
-        return (this._auth ??= new Client_1.Auth(this.options));
+        var _a;
+        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new Client_2.Auth(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _billingNotes;
     get billingNotes() {
-        return (this._billingNotes ??= new Client_2.BillingNotes(this.options));
+        var _a;
+        return ((_a = this._billingNotes) !== null && _a !== void 0 ? _a : (this._billingNotes = new Client_3.BillingNotes(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _contracts;
     get contracts() {
-        return (this._contracts ??= new Client_3.Contracts(this.options));
+        var _a;
+        return ((_a = this._contracts) !== null && _a !== void 0 ? _a : (this._contracts = new Client_4.Contracts(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _eligibility;
     get eligibility() {
-        return (this._eligibility ??= new Client_4.Eligibility(this.options));
+        var _a;
+        return ((_a = this._eligibility) !== null && _a !== void 0 ? _a : (this._eligibility = new Client_5.Eligibility(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _encounters;
     get encounters() {
-        return (this._encounters ??= new Client_5.Encounters(this.options));
+        var _a;
+        return ((_a = this._encounters) !== null && _a !== void 0 ? _a : (this._encounters = new Client_6.Encounters(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _expectedNetworkStatus;
     get expectedNetworkStatus() {
-        return (this._expectedNetworkStatus ??= new Client_6.ExpectedNetworkStatus(this.options));
+        var _a;
+        return ((_a = this._expectedNetworkStatus) !== null && _a !== void 0 ? _a : (this._expectedNetworkStatus = new Client_7.ExpectedNetworkStatus(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _exports;
     get exports() {
-        return (this._exports ??= new Client_7.Exports(this.options));
+        var _a;
+        return ((_a = this._exports) !== null && _a !== void 0 ? _a : (this._exports = new Client_8.Exports(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get externalPaymentAccountConfig() {
+        var _a;
+        return ((_a = this._externalPaymentAccountConfig) !== null && _a !== void 0 ? _a : (this._externalPaymentAccountConfig = new Client_9.ExternalPaymentAccountConfig(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _feeSchedules;
     get feeSchedules() {
-        return (this._feeSchedules ??= new Client_8.FeeSchedules(this.options));
+        var _a;
+        return ((_a = this._feeSchedules) !== null && _a !== void 0 ? _a : (this._feeSchedules = new Client_10.FeeSchedules(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _guarantor;
     get guarantor() {
-        return (this._guarantor ??= new Client_9.Guarantor(this.options));
+        var _a;
+        return ((_a = this._guarantor) !== null && _a !== void 0 ? _a : (this._guarantor = new Client_11.Guarantor(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
+    }
+    get importInvoice() {
+        var _a;
+        return ((_a = this._importInvoice) !== null && _a !== void 0 ? _a : (this._importInvoice = new Client_12.ImportInvoice(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _insuranceAdjudications;
     get insuranceAdjudications() {
-        return (this._insuranceAdjudications ??= new Client_10.InsuranceAdjudications(this.options));
+        var _a;
+        return ((_a = this._insuranceAdjudications) !== null && _a !== void 0 ? _a : (this._insuranceAdjudications = new Client_13.InsuranceAdjudications(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _insurancePayments;
     get insurancePayments() {
-        return (this._insurancePayments ??= new Client_11.InsurancePayments(this.options));
+        var _a;
+        return ((_a = this._insurancePayments) !== null && _a !== void 0 ? _a : (this._insurancePayments = new Client_14.InsurancePayments(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _insuranceRefunds;
     get insuranceRefunds() {
-        return (this._insuranceRefunds ??= new Client_12.InsuranceRefunds(this.options));
+        var _a;
+        return ((_a = this._insuranceRefunds) !== null && _a !== void 0 ? _a : (this._insuranceRefunds = new Client_15.InsuranceRefunds(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _organizationServiceFacilities;
     get organizationServiceFacilities() {
-        return (this._organizationServiceFacilities ??= new Client_13.OrganizationServiceFacilities(this.options));
+        var _a;
+        return ((_a = this._organizationServiceFacilities) !== null && _a !== void 0 ? _a : (this._organizationServiceFacilities = new Client_16.OrganizationServiceFacilities(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _organizationProviders;
     get organizationProviders() {
-        return (this._organizationProviders ??= new Client_14.OrganizationProviders(this.options));
+        var _a;
+        return ((_a = this._organizationProviders) !== null && _a !== void 0 ? _a : (this._organizationProviders = new Client_17.OrganizationProviders(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _patientPayments;
     get patientPayments() {
-        return (this._patientPayments ??= new Client_15.PatientPayments(this.options));
+        var _a;
+        return ((_a = this._patientPayments) !== null && _a !== void 0 ? _a : (this._patientPayments = new Client_18.PatientPayments(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _patientRefunds;
     get patientRefunds() {
-        return (this._patientRefunds ??= new Client_16.PatientRefunds(this.options));
+        var _a;
+        return ((_a = this._patientRefunds) !== null && _a !== void 0 ? _a : (this._patientRefunds = new Client_19.PatientRefunds(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _payers;
     get payers() {
-        return (this._payers ??= new Client_17.Payers(this.options));
+        var _a;
+        return ((_a = this._payers) !== null && _a !== void 0 ? _a : (this._payers = new Client_20.Payers(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _tasks;
     get tasks() {
-        return (this._tasks ??= new Client_18.Tasks(this.options));
+        var _a;
+        return ((_a = this._tasks) !== null && _a !== void 0 ? _a : (this._tasks = new Client_21.Tasks(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _writeOffs;
     get writeOffs() {
-        return (this._writeOffs ??= new Client_19.WriteOffs(this.options));
+        var _a;
+        return ((_a = this._writeOffs) !== null && _a !== void 0 ? _a : (this._writeOffs = new Client_22.WriteOffs(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
-    _serviceFacility;
     get serviceFacility() {
-        return (this._serviceFacility ??= new Client_20.ServiceFacility(this.options));
+        var _a;
+        return ((_a = this._serviceFacility) !== null && _a !== void 0 ? _a : (this._serviceFacility = new Client_23.ServiceFacility(Object.assign(Object.assign({}, this._options), { token: () => __awaiter(this, void 0, void 0, function* () { return yield this._oauthTokenProvider.getToken(); }) }))));
     }
 }
 exports.CandidApiClient = CandidApiClient;

package/api/resources/auth/client/Client.d.ts

@@ -6,13 +6,18 @@ import * as core from "../../../../core";
 import { V2 } from "../resources/v2/client/Client";
 export declare namespace Auth {
     interface Options {
-        environment?: environments.CandidApiEnvironment | string;
+        environment?: core.Supplier<environments.CandidApiEnvironment | string>;
         token?: core.Supplier<core.BearerToken | undefined>;
     }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
 }
 export declare class Auth {
-    protected readonly options: Auth.Options;
-    constructor(options: Auth.Options);
+    protected readonly _options: Auth.Options;
+    constructor(_options?: Auth.Options);
     protected _v2: V2 | undefined;
     get v2(): V2;
 }

package/api/resources/auth/client/Client.js

@@ -6,13 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Auth = void 0;
 const Client_1 = require("../resources/v2/client/Client");
 class Auth {
-    options;
-    constructor(options) {
-        this.options = options;
+    constructor(_options = {}) {
+        this._options = _options;
     }
-    _v2;
     get v2() {
-        return (this._v2 ??= new Client_1.V2(this.options));
+        var _a;
+        return ((_a = this._v2) !== null && _a !== void 0 ? _a : (this._v2 = new Client_1.V2(this._options)));
     }
 }
 exports.Auth = Auth;

package/api/resources/auth/resources/v2/client/Client.d.ts

@@ -3,29 +3,49 @@
  */
 import * as environments from "../../../../../../environments";
 import * as core from "../../../../../../core";
-import * as CandidApi from "../../../../..";
+import * as CandidApi from "../../../../../index";
 export declare namespace V2 {
     interface Options {
-        environment?: environments.CandidApiEnvironment | string;
+        environment?: core.Supplier<environments.CandidApiEnvironment | string>;
         token?: core.Supplier<core.BearerToken | undefined>;
     }
+    interface RequestOptions {
+        timeoutInSeconds?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+    }
 }
 export declare class V2 {
-    protected readonly options: V2.Options;
-    constructor(options: V2.Options);
+    protected readonly _options: V2.Options;
+    constructor(_options?: V2.Options);
     /**
-     * Authenticating with the Candid Health API.
+     * <Callout intent="info">
+     * Candid Health SDKs automatically handle authentication workflows after configuring them with the `client_id` and
+     * `client_secret`.
+     * </Callout>
      *
      * Candid Health utilizes the [OAuth 2.0 bearer token authentication scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our auth flow. You obtain the bearer token for all
      * subsequent API requests via the `/auth/token` endpoint defined below, which requires you to provide your `client_id` and `client_secret`. Your `client_id` and `client_secret` can be [generated](https://support.joincandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys) from the "Users & Credentials" tab by your org admin.
      *
-     * The bearer token should be provided in the `Authorization` header for all subsequent API calls.
+     * The bearer token is a signed [JWT](https://jwt.io/). The public key for the JWT can be found [here](https://candidhealth.auth0.com/pem) for any verification workflows.
      *
-     * **Warning:**
+     * The bearer token should be provided in the `Authorization` header for all subsequent API calls.
      *
+     * <Callout intent="warning">
      * The bearer token expires 5 hours after it has been created. After it has expired, the client will receive an "HTTP 401
-     * Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an "HTTP 429 Too Many Requests" error.
+     * Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between
+     * requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an `HTTP 429 Too Many Requests` error.
+     * </Callout>
+     *
+     * @param {CandidApi.auth.v2.AuthGetTokenRequest} request
+     * @param {V2.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await candidApi.auth.v2.getToken({
+     *         clientId: "YOUR_CLIENT_ID",
+     *         clientSecret: "YOUR_CLIENT_SECRET"
+     *     })
      */
-    getToken(request: CandidApi.auth.v2.AuthGetTokenRequest): Promise<core.APIResponse<CandidApi.auth.v2.AuthGetTokenResponse, CandidApi.auth.v2.getToken.Error>>;
+    getToken(request: CandidApi.auth.v2.AuthGetTokenRequest, requestOptions?: V2.RequestOptions): Promise<core.APIResponse<CandidApi.auth.v2.AuthGetTokenResponse, CandidApi.auth.v2.getToken.Error>>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/api/resources/auth/resources/v2/client/Client.js

@@ -25,6 +25,15 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -32,79 +41,102 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.V2 = void 0;
 const environments = __importStar(require("../../../../../../environments"));
 const core = __importStar(require("../../../../../../core"));
-const CandidApi = __importStar(require("../../../../.."));
-const serializers = __importStar(require("../../../../../../serialization"));
+const CandidApi = __importStar(require("../../../../../index"));
+const serializers = __importStar(require("../../../../../../serialization/index"));
 const url_join_1 = __importDefault(require("url-join"));
 class V2 {
-    options;
-    constructor(options) {
-        this.options = options;
+    constructor(_options = {}) {
+        this._options = _options;
     }
     /**
-     * Authenticating with the Candid Health API.
+     * <Callout intent="info">
+     * Candid Health SDKs automatically handle authentication workflows after configuring them with the `client_id` and
+     * `client_secret`.
+     * </Callout>
      *
      * Candid Health utilizes the [OAuth 2.0 bearer token authentication scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) in our auth flow. You obtain the bearer token for all
      * subsequent API requests via the `/auth/token` endpoint defined below, which requires you to provide your `client_id` and `client_secret`. Your `client_id` and `client_secret` can be [generated](https://support.joincandidhealth.com/hc/en-us/articles/23065219476244--Generating-Candid-API-Keys) from the "Users & Credentials" tab by your org admin.
      *
-     * The bearer token should be provided in the `Authorization` header for all subsequent API calls.
+     * The bearer token is a signed [JWT](https://jwt.io/). The public key for the JWT can be found [here](https://candidhealth.auth0.com/pem) for any verification workflows.
      *
-     * **Warning:**
+     * The bearer token should be provided in the `Authorization` header for all subsequent API calls.
      *
+     * <Callout intent="warning">
      * The bearer token expires 5 hours after it has been created. After it has expired, the client will receive an "HTTP 401
-     * Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an "HTTP 429 Too Many Requests" error.
+     * Unauthorized" error, at which point the client should generate a new token. It is important that tokens be reused between
+     * requests; if the client attempts to generate a token too often, it will be rate-limited and will receive an `HTTP 429 Too Many Requests` error.
+     * </Callout>
+     *
+     * @param {CandidApi.auth.v2.AuthGetTokenRequest} request
+     * @param {V2.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await candidApi.auth.v2.getToken({
+     *         clientId: "YOUR_CLIENT_ID",
+     *         clientSecret: "YOUR_CLIENT_SECRET"
+     *     })
      */
-    async getToken(request) {
-        const _response = await core.fetcher({
-            url: (0, url_join_1.default)(this.options.environment ?? environments.CandidApiEnvironment.Production, "/api/auth/v2/token"),
-            method: "POST",
-            headers: {
-                Authorization: await this._getAuthorizationHeader(),
-                "X-Fern-Language": "JavaScript",
-                "X-Fern-SDK-Name": "candidhealth",
-                "X-Fern-SDK-Version": "0.18.2",
-            },
-            contentType: "application/json",
-            body: await serializers.auth.v2.AuthGetTokenRequest.jsonOrThrow(request, {
-                unrecognizedObjectKeys: "strip",
-            }),
-            timeoutMs: 60000,
-        });
-        if (_response.ok) {
-            return {
-                ok: true,
-                body: await serializers.auth.v2.AuthGetTokenResponse.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
-                    allowUnrecognizedUnionMembers: true,
-                    allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
+    getToken(request, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.environment))) !== null && _a !== void 0 ? _a : environments.CandidApiEnvironment.Production, "/api/auth/v2/token"),
+                method: "POST",
+                headers: {
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Fern-Language": "JavaScript",
+                    "X-Fern-SDK-Name": "candidhealth",
+                    "X-Fern-SDK-Version": "0.22.2-15e24b1",
+                    "X-Fern-Runtime": core.RUNTIME.type,
+                    "X-Fern-Runtime-Version": core.RUNTIME.version,
+                },
+                contentType: "application/json",
+                body: yield serializers.auth.v2.AuthGetTokenRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
                 }),
-            };
-        }
-        if (_response.error.reason === "status-code") {
-            switch (_response.error.body?.errorName) {
-                case "TooManyRequestsError":
-                    return {
-                        ok: false,
-                        error: await serializers.auth.v2.getToken.Error.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            breadcrumbsPrefix: ["response"],
-                        }),
-                    };
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    ok: true,
+                    body: yield serializers.auth.v2.AuthGetTokenResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch ((_b = _response.error.body) === null || _b === void 0 ? void 0 : _b.errorName) {
+                    case "TooManyRequestsError":
+                        return {
+                            ok: false,
+                            error: yield serializers.auth.v2.getToken.Error.parseOrThrow(_response.error.body, {
+                                unrecognizedObjectKeys: "passthrough",
+                                allowUnrecognizedUnionMembers: true,
+                                allowUnrecognizedEnumValues: true,
+                                breadcrumbsPrefix: ["response"],
+                            }),
+                        };
+                }
             }
-        }
-        return {
-            ok: false,
-            error: CandidApi.auth.v2.getToken.Error._unknown(_response.error),
-        };
+            return {
+                ok: false,
+                error: CandidApi.auth.v2.getToken.Error._unknown(_response.error),
+            };
+        });
     }
-    async _getAuthorizationHeader() {
-        const bearer = await core.Supplier.get(this.options.token);
-        if (bearer != null) {
-            return `Bearer ${bearer}`;
-        }
-        return undefined;
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const bearer = yield core.Supplier.get(this._options.token);
+            if (bearer != null) {
+                return `Bearer ${bearer}`;
+            }
+            return undefined;
+        });
     }
 }
 exports.V2 = V2;

package/api/resources/auth/resources/v2/client/getToken.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as CandidApi from "../../../../..";
+import * as CandidApi from "../../../../../index";
 import * as core from "../../../../../../core";
 export declare type Error = CandidApi.auth.v2.getToken.Error.TooManyRequestsError | CandidApi.auth.v2.getToken.Error._Unknown;
 export declare namespace Error {

package/api/resources/auth/resources/v2/client/getToken.js

@@ -27,7 +27,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Error = void 0;
-const CandidApi = __importStar(require("../../../../.."));
+const CandidApi = __importStar(require("../../../../../index"));
 exports.Error = {
     tooManyRequestsError: (value) => {
         return {

package/api/resources/auth/resources/v2/client/index.d.ts

@@ -1 +1,2 @@
+export * from "./requests";
 export * as getToken from "./getToken";

package/api/resources/auth/resources/v2/client/index.js

@@ -15,6 +15,9 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importStar = (this && this.__importStar) || function (mod) {
     if (mod && mod.__esModule) return mod;
     var result = {};
@@ -24,4 +27,5 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getToken = void 0;
+__exportStar(require("./requests"), exports);
 exports.getToken = __importStar(require("./getToken"));

package/api/resources/auth/resources/v2/client/requests/index.d.ts

@@ -0,0 +1 @@
+export { type AuthGetTokenRequest } from "./AuthGetTokenRequest";

package/api/resources/auth/resources/v2/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/resources/auth/resources/v2/types/index.d.ts

@@ -1,3 +1,2 @@
-export * from "./AuthGetTokenRequest";
 export * from "./AuthGetTokenResponse";
 export * from "./TooManyRequestsErrorType";

package/api/resources/auth/resources/v2/types/index.js

@@ -14,6 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./AuthGetTokenRequest"), exports);
 __exportStar(require("./AuthGetTokenResponse"), exports);
 __exportStar(require("./TooManyRequestsErrorType"), exports);