@tryfinch/finch-api 6.27.0 → 6.29.0

package/src/resources/connect/connect.ts

@@ -1,14 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as SessionsAPI from './sessions';
+import { APIResource } from "../../resource.js";
+import * as SessionsAPI from "./sessions.js";
 import {
   SessionNewParams,
   SessionNewResponse,
   SessionReauthenticateParams,
   SessionReauthenticateResponse,
   Sessions,
-} from './sessions';
+} from "./sessions.js";
 
 export class Connect extends APIResource {
   sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);

package/src/resources/connect/index.ts

@@ -1,10 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Connect } from './connect';
+export { Connect } from "./connect.js";
 export {
   Sessions,
   type SessionNewResponse,
   type SessionReauthenticateResponse,
   type SessionNewParams,
   type SessionReauthenticateParams,
-} from './sessions';
+} from "./sessions.js";

package/src/resources/connect/sessions.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as Core from '../../core';
+import { APIResource } from "../../resource.js";
+import * as Core from "../../core.js";
 
 export class Sessions extends APIResource {
   /**

package/src/resources/connect.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './connect/index';
+export * from "./connect/index.js";

package/src/resources/hris/benefits/benefits.ts

@@ -1,11 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import { isRequestOptions } from '../../../core';
-import * as Core from '../../../core';
-import * as BenefitsAPI from './benefits';
-import * as Shared from '../../shared';
-import * as IndividualsAPI from './individuals';
+import { APIResource } from "../../../resource.js";
+import { isRequestOptions } from "../../../core.js";
+import * as Core from "../../../core.js";
+import * as BenefitsAPI from "./benefits.js";
+import * as Shared from "../../shared.js";
+import * as IndividualsAPI from "./individuals.js";
 import {
   EnrolledIndividualBenefitResponse,
   IndividualBenefit,
@@ -16,8 +16,8 @@ import {
   IndividualUnenrollManyParams,
   Individuals,
   UnenrolledIndividualBenefitResponse,
-} from './individuals';
-import { SinglePage } from '../../../pagination';
+} from "./individuals.js";
+import { SinglePage } from "../../../pagination.js";
 
 export class Benefits extends APIResource {
   individuals: IndividualsAPI.Individuals = new IndividualsAPI.Individuals(this._client);
@@ -25,6 +25,12 @@ export class Benefits extends APIResource {
   /**
    * Creates a new company-wide deduction or contribution. Please use the
    * `/providers` endpoint to view available types for each provider.
+   *
+   * @example
+   * ```ts
+   * const createCompanyBenefitsResponse =
+   *   await client.hris.benefits.create();
+   * ```
    */
   create(
     body?: BenefitCreateParams,
@@ -43,6 +49,13 @@ export class Benefits extends APIResource {
 
   /**
    * Lists deductions and contributions information for a given item
+   *
+   * @example
+   * ```ts
+   * const companyBenefit = await client.hris.benefits.retrieve(
+   *   'benefit_id',
+   * );
+   * ```
    */
   retrieve(benefitId: string, options?: Core.RequestOptions): Core.APIPromise<CompanyBenefit> {
     return this._client.get(`/employer/benefits/${benefitId}`, options);
@@ -50,6 +63,12 @@ export class Benefits extends APIResource {
 
   /**
    * Updates an existing company-wide deduction or contribution
+   *
+   * @example
+   * ```ts
+   * const updateCompanyBenefitResponse =
+   *   await client.hris.benefits.update('benefit_id');
+   * ```
    */
   update(
     benefitId: string,
@@ -70,6 +89,14 @@ export class Benefits extends APIResource {
 
   /**
    * List all company-wide deductions and contributions.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const companyBenefit of client.hris.benefits.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(options?: Core.RequestOptions): Core.PagePromise<CompanyBenefitsSinglePage, CompanyBenefit> {
     return this._client.getAPIList('/employer/benefits', CompanyBenefitsSinglePage, options);
@@ -77,6 +104,14 @@ export class Benefits extends APIResource {
 
   /**
    * Get deductions metadata
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const benefitListSupportedBenefitsResponse of client.hris.benefits.listSupportedBenefits()) {
+   *   // ...
+   * }
+   * ```
    */
   listSupportedBenefits(
     options?: Core.RequestOptions,
@@ -219,6 +254,11 @@ export interface CompanyBenefit {
    */
   benefit_id: string;
 
+  /**
+   * The company match for this benefit.
+   */
+  company_contribution: CompanyBenefit.CompanyContribution | null;
+
   description: string | null;
 
   /**
@@ -232,6 +272,25 @@ export interface CompanyBenefit {
   type: BenefitType | null;
 }
 
+export namespace CompanyBenefit {
+  /**
+   * The company match for this benefit.
+   */
+  export interface CompanyContribution {
+    tiers?: Array<CompanyContribution.Tier>;
+
+    type?: 'match';
+  }
+
+  export namespace CompanyContribution {
+    export interface Tier {
+      match?: number;
+
+      threshold?: number;
+    }
+  }
+}
+
 export interface CreateCompanyBenefitsResponse {
   /**
    * The id of the benefit.
@@ -338,6 +397,11 @@ export interface BenefitListSupportedBenefitsResponse {
 export type BenfitContribution = BenefitContribution | null;
 
 export interface BenefitCreateParams {
+  /**
+   * The company match for this benefit.
+   */
+  company_contribution?: BenefitCreateParams.CompanyContribution | null;
+
   /**
    * Name of the benefit as it appears in the provider and pay statements. Recommend
    * limiting this to <30 characters due to limitations in specific providers (e.g.
@@ -356,6 +420,25 @@ export interface BenefitCreateParams {
   type?: BenefitType | null;
 }
 
+export namespace BenefitCreateParams {
+  /**
+   * The company match for this benefit.
+   */
+  export interface CompanyContribution {
+    tiers?: Array<CompanyContribution.Tier>;
+
+    type?: 'match';
+  }
+
+  export namespace CompanyContribution {
+    export interface Tier {
+      match?: number;
+
+      threshold?: number;
+    }
+  }
+}
+
 export interface BenefitUpdateParams {
   /**
    * Updated name or description.

package/src/resources/hris/benefits/index.ts

@@ -18,7 +18,7 @@ export {
   type BenfitContribution,
   type BenefitCreateParams,
   type BenefitUpdateParams,
-} from './benefits';
+} from "./benefits.js";
 export {
   IndividualBenefitsSinglePage,
   Individuals,
@@ -29,4 +29,4 @@ export {
   type IndividualEnrollManyParams,
   type IndividualRetrieveManyBenefitsParams,
   type IndividualUnenrollManyParams,
-} from './individuals';
+} from "./individuals.js";

package/src/resources/hris/benefits/individuals.ts

@@ -1,10 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import { isRequestOptions } from '../../../core';
-import * as Core from '../../../core';
-import * as BenefitsAPI from './benefits';
-import { SinglePage } from '../../../pagination';
+import { APIResource } from "../../../resource.js";
+import { isRequestOptions } from "../../../core.js";
+import * as Core from "../../../core.js";
+import * as BenefitsAPI from "./benefits.js";
+import { SinglePage } from "../../../pagination.js";
 
 export class Individuals extends APIResource {
   /**
@@ -12,6 +12,15 @@ export class Individuals extends APIResource {
    * operation. If the employee is already enrolled, the enrollment amounts will be
    * adjusted. Making the same request multiple times will not create new
    * enrollments, but will continue to set the state of the existing enrollment.
+   *
+   * @example
+   * ```ts
+   * const enrolledIndividualBenefitResponse =
+   *   await client.hris.benefits.individuals.enrollMany(
+   *     'benefit_id',
+   *     [{}],
+   *   );
+   * ```
    */
   enrollMany(
     benefitId: string,
@@ -35,6 +44,14 @@ export class Individuals extends APIResource {
 
   /**
    * Lists individuals currently enrolled in a given deduction.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.hris.benefits.individuals.enrolledIds(
+   *     'benefit_id',
+   *   );
+   * ```
    */
   enrolledIds(
     benefitId: string,
@@ -45,6 +62,16 @@ export class Individuals extends APIResource {
 
   /**
    * Get enrollment information for the given individuals.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const individualBenefit of client.hris.benefits.individuals.retrieveManyBenefits(
+   *   'benefit_id',
+   * )) {
+   *   // ...
+   * }
+   * ```
    */
   retrieveManyBenefits(
     benefitId: string,
@@ -72,6 +99,14 @@ export class Individuals extends APIResource {
 
   /**
    * Unenroll individuals from a deduction or contribution
+   *
+   * @example
+   * ```ts
+   * const unenrolledIndividualBenefitResponse =
+   *   await client.hris.benefits.individuals.unenrollMany(
+   *     'benefit_id',
+   *   );
+   * ```
    */
   unenrollMany(
     benefitId: string,

package/src/resources/hris/benefits.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './benefits/index';
+export * from "./benefits/index.js";

package/src/resources/hris/company/company.ts

@@ -1,15 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
-import * as HRISAPI from '../hris';
-import * as PayStatementItemAPI from './pay-statement-item/pay-statement-item';
+import { APIResource } from "../../../resource.js";
+import * as Core from "../../../core.js";
+import * as HRISAPI from "../hris.js";
+import * as PayStatementItemAPI from "./pay-statement-item/pay-statement-item.js";
 import {
   PayStatementItem,
   PayStatementItemListParams,
   PayStatementItemListResponse,
   PayStatementItemListResponsesPage,
-} from './pay-statement-item/pay-statement-item';
+} from "./pay-statement-item/pay-statement-item.js";
 
 export class CompanyResource extends APIResource {
   payStatementItem: PayStatementItemAPI.PayStatementItem = new PayStatementItemAPI.PayStatementItem(
@@ -18,6 +18,11 @@ export class CompanyResource extends APIResource {
 
   /**
    * Read basic company data
+   *
+   * @example
+   * ```ts
+   * const company = await client.hris.company.retrieve();
+   * ```
    */
   retrieve(options?: Core.RequestOptions): Core.APIPromise<Company> {
     return this._client.get('/employer/company', options);
@@ -74,40 +79,40 @@ export namespace Company {
     /**
      * The name of the bank associated in the payroll/HRIS system.
      */
-    account_name?: string | null;
+    account_name: string | null;
 
     /**
      * 10-12 digit number to specify the bank account
      */
-    account_number?: string | null;
+    account_number: string | null;
 
     /**
      * The type of bank account.
      */
-    account_type?: 'checking' | 'savings' | null;
+    account_type: 'checking' | 'savings' | null;
 
     /**
      * Name of the banking institution.
      */
-    institution_name?: string | null;
+    institution_name: string | null;
 
     /**
      * A nine-digit code that's based on the U.S. Bank location where your account was
      * opened.
      */
-    routing_number?: string | null;
+    routing_number: string | null;
   }
 
   export interface Department {
     /**
      * The department name.
      */
-    name?: string | null;
+    name: string | null;
 
     /**
      * The parent department, if present.
      */
-    parent?: Department.Parent | null;
+    parent: Department.Parent | null;
   }
 
   export namespace Department {
@@ -118,7 +123,7 @@ export namespace Company {
       /**
        * The parent department's name.
        */
-      name?: string | null;
+      name: string | null;
     }
   }
 
@@ -129,12 +134,12 @@ export namespace Company {
     /**
      * The tax payer subtype of the company.
      */
-    subtype?: 's_corporation' | 'c_corporation' | 'b_corporation' | null;
+    subtype: 's_corporation' | 'c_corporation' | 'b_corporation' | null;
 
     /**
      * The tax payer type of the company.
      */
-    type?:
+    type:
       | 'llc'
       | 'lp'
       | 'corporation'

package/src/resources/hris/company/index.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { CompanyResource, type Company } from './company';
+export { CompanyResource, type Company } from "./company.js";
 export {
   PayStatementItemListResponsesPage,
   PayStatementItem,
   type PayStatementItemListResponse,
   type PayStatementItemListParams,
-} from './pay-statement-item/index';
+} from "./pay-statement-item/index.js";

package/src/resources/hris/company/pay-statement-item/index.ts

@@ -5,7 +5,7 @@ export {
   PayStatementItem,
   type PayStatementItemListResponse,
   type PayStatementItemListParams,
-} from './pay-statement-item';
+} from "./pay-statement-item.js";
 export {
   RuleListResponsesPage,
   Rules,
@@ -15,4 +15,4 @@ export {
   type RuleDeleteResponse,
   type RuleCreateParams,
   type RuleUpdateParams,
-} from './rules';
+} from "./rules.js";

package/src/resources/hris/company/pay-statement-item/pay-statement-item.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../../resource';
-import { isRequestOptions } from '../../../../core';
-import * as Core from '../../../../core';
-import * as RulesAPI from './rules';
+import { APIResource } from "../../../../resource.js";
+import { isRequestOptions } from "../../../../core.js";
+import * as Core from "../../../../core.js";
+import * as RulesAPI from "./rules.js";
 import {
   RuleCreateParams,
   RuleCreateResponse,
@@ -13,8 +13,8 @@ import {
   RuleUpdateParams,
   RuleUpdateResponse,
   Rules,
-} from './rules';
-import { ResponsesPage } from '../../../../pagination';
+} from "./rules.js";
+import { ResponsesPage } from "../../../../pagination.js";
 
 export class PayStatementItem extends APIResource {
   rules: RulesAPI.Rules = new RulesAPI.Rules(this._client);
@@ -23,6 +23,14 @@ export class PayStatementItem extends APIResource {
    * **Beta:** this endpoint currently serves employers onboarded after March 4th and
    * historical support will be added soon Retrieve a list of detailed pay statement
    * items for the access token's connection account.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const payStatementItemListResponse of client.hris.company.payStatementItem.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: PayStatementItemListParams,

package/src/resources/hris/company/pay-statement-item/rules.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../../resource';
-import { isRequestOptions } from '../../../../core';
-import * as Core from '../../../../core';
-import { ResponsesPage } from '../../../../pagination';
+import { APIResource } from "../../../../resource.js";
+import { isRequestOptions } from "../../../../core.js";
+import * as Core from "../../../../core.js";
+import { ResponsesPage } from "../../../../pagination.js";
 
 export class Rules extends APIResource {
   /**
@@ -13,6 +13,12 @@ export class Rules extends APIResource {
    * example, pay statement items that meet certain conditions can be labeled as a
    * pre-tax 401k. This metadata can be retrieved where pay statement item
    * information is available.
+   *
+   * @example
+   * ```ts
+   * const rule =
+   *   await client.hris.company.payStatementItem.rules.create();
+   * ```
    */
   create(body?: RuleCreateParams, options?: Core.RequestOptions): Core.APIPromise<RuleCreateResponse>;
   create(options?: Core.RequestOptions): Core.APIPromise<RuleCreateResponse>;
@@ -29,6 +35,14 @@ export class Rules extends APIResource {
   /**
    * **Beta:** this endpoint currently serves employers onboarded after March 4th and
    * historical support will be added soon Update a rule for a pay statement item.
+   *
+   * @example
+   * ```ts
+   * const rule =
+   *   await client.hris.company.payStatementItem.rules.update(
+   *     'rule_id',
+   *   );
+   * ```
    */
   update(
     ruleId: string,
@@ -50,6 +64,14 @@ export class Rules extends APIResource {
   /**
    * **Beta:** this endpoint currently serves employers onboarded after March 4th and
    * historical support will be added soon List all rules of a connection account.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const ruleListResponse of client.hris.company.payStatementItem.rules.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(options?: Core.RequestOptions): Core.PagePromise<RuleListResponsesPage, RuleListResponse> {
     return this._client.getAPIList('/employer/pay-statement-item/rule', RuleListResponsesPage, options);
@@ -58,6 +80,14 @@ export class Rules extends APIResource {
   /**
    * **Beta:** this endpoint currently serves employers onboarded after March 4th and
    * historical support will be added soon Delete a rule for a pay statement item.
+   *
+   * @example
+   * ```ts
+   * const rule =
+   *   await client.hris.company.payStatementItem.rules.delete(
+   *     'rule_id',
+   *   );
+   * ```
    */
   delete(ruleId: string, options?: Core.RequestOptions): Core.APIPromise<RuleDeleteResponse> {
     return this._client.delete(`/employer/pay-statement-item/rule/${ruleId}`, options);

package/src/resources/hris/company/pay-statement-item.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './pay-statement-item/index';
+export * from "./pay-statement-item/index.js";

package/src/resources/hris/company.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './company/index';
+export * from "./company/index.js";

package/src/resources/hris/directory.ts

@@ -1,13 +1,21 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import { isRequestOptions } from '../../core';
-import * as Core from '../../core';
-import { IndividualsPage, type IndividualsPageParams } from '../../pagination';
+import { APIResource } from "../../resource.js";
+import { isRequestOptions } from "../../core.js";
+import * as Core from "../../core.js";
+import { IndividualsPage, type IndividualsPageParams } from "../../pagination.js";
 
 export class Directory extends APIResource {
   /**
    * Read company directory and organization structure
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const individualInDirectory of client.hris.directory.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     query?: DirectoryListParams,
@@ -34,37 +42,37 @@ export interface IndividualInDirectory {
   /**
    * A stable Finch `id` (UUID v4) for an individual in the company.
    */
-  id?: string;
+  id: string;
 
   /**
    * The department object.
    */
-  department?: IndividualInDirectory.Department | null;
+  department: IndividualInDirectory.Department | null;
 
   /**
    * The legal first name of the individual.
    */
-  first_name?: string | null;
+  first_name: string | null;
 
   /**
    * `true` if the individual is an active employee or contractor at the company.
    */
-  is_active?: boolean | null;
+  is_active: boolean | null;
 
   /**
    * The legal last name of the individual.
    */
-  last_name?: string | null;
+  last_name: string | null;
 
   /**
    * The manager object.
    */
-  manager?: IndividualInDirectory.Manager | null;
+  manager: IndividualInDirectory.Manager | null;
 
   /**
    * The legal middle name of the individual.
    */
-  middle_name?: string | null;
+  middle_name: string | null;
 }
 
 export namespace IndividualInDirectory {
@@ -85,7 +93,7 @@ export namespace IndividualInDirectory {
     /**
      * A stable Finch `id` (UUID v4) for an individual in the company.
      */
-    id?: string;
+    id: string;
   }
 }