@tryfinch/finch-api 5.12.1 → 5.13.0

package/src/resources/hris/hris.ts

@@ -103,23 +103,10 @@ export interface Money {
   currency?: string;
 }
 
-export interface Paging {
-  /**
-   * The total number of elements for the entire query (not just the given page)
-   */
-  count?: number;
-
-  /**
-   * The current start index of the returned list of elements
-   */
-  offset?: number;
-}
-
 export namespace HRIS {
   export import Income = HRISAPI.Income;
   export import Location = HRISAPI.Location;
   export import Money = HRISAPI.Money;
-  export import Paging = HRISAPI.Paging;
   export import CompanyResource = CompanyAPI.CompanyResource;
   export import Company = CompanyAPI.Company;
   export import Directory = DirectoryAPI.Directory;

package/src/resources/hris/index.ts

@@ -26,7 +26,7 @@ export {
   EmploymentDataResponsesPage,
   Employments,
 } from './employments';
-export { Income, Location, Money, Paging, HRIS } from './hris';
+export { Income, Location, Money, HRIS } from './hris';
 export {
   Individual,
   IndividualResponse,

package/src/resources/hris/pay-statements.ts

@@ -3,6 +3,7 @@
 import * as Core from "../../core";
 import { APIResource } from "../../resource";
 import * as PayStatementsAPI from "./pay-statements";
+import * as Shared from "../shared";
 import * as HRISAPI from "./hris";
 import * as BenefitsAPI from "./benefits/benefits";
 import { ResponsesPage } from "../../pagination";
@@ -200,7 +201,7 @@ export interface PayStatementResponse {
 }
 
 export interface PayStatementResponseBody {
-  paging?: HRISAPI.Paging;
+  paging?: Shared.Paging;
 
   /**
    * The array of pay statements for the current payment.

package/src/resources/index.ts

@@ -2,7 +2,8 @@
 
 export * from './shared';
 export { DisconnectResponse, Introspection, Account } from './account';
-export { Income, Location, Money, Paging, HRIS } from './hris/hris';
+export { Income, Location, Money, HRIS } from './hris/hris';
+export { Jobs } from './jobs/jobs';
 export { Provider, ProvidersSinglePage, Providers } from './providers';
 export {
   RequestForwardingForwardResponse,

package/src/resources/jobs/automated.ts

@@ -0,0 +1,139 @@
+// File generated from our OpenAPI spec by Stainless.
+
+import * as Core from "../../core";
+import { APIResource } from "../../resource";
+import { isRequestOptions } from "../../core";
+import * as AutomatedAPI from "./automated";
+import { Page, type PageParams } from "../../pagination";
+
+export class Automated extends APIResource {
+  /**
+   * Enqueue an automated job. Currently, only the `data_sync_all` job type is
+   * supported, which will enqueue a job to re-sync all data for a connection.
+   * `data_sync_all` has a concurrency limit of 1 job at a time per connection. This
+   * means that if this endpoint is called while a job is already in progress for
+   * this connection, Finch will return the `job_id` of the job that is currently in
+   * progress. Finch allows a fixed window rate limit of 1 forced refresh per hour
+   * per connection.
+   *
+   * This endpoint is available for _Scale_ tier customers as an add-on. To request
+   * access to this endpoint, please contact your Finch account manager.
+   */
+  create(
+    body: AutomatedCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AutomatedCreateResponse> {
+    return this._client.post('/jobs/automated', { body, ...options });
+  }
+
+  /**
+   * Get an automated job by `job_id`.
+   */
+  retrieve(jobId: string, options?: Core.RequestOptions): Core.APIPromise<AutomatedAsyncJob> {
+    return this._client.get(`/jobs/automated/${jobId}`, options);
+  }
+
+  /**
+   * Get all automated jobs. Automated jobs are completed by a machine. By default,
+   * jobs are sorted in descending order by submission time. For scheduled jobs such
+   * as data syncs, only the next scheduled job is shown.
+   */
+  list(
+    query?: AutomatedListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<AutomatedAsyncJobsPage, AutomatedAsyncJob>;
+  list(options?: Core.RequestOptions): Core.PagePromise<AutomatedAsyncJobsPage, AutomatedAsyncJob>;
+  list(
+    query: AutomatedListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<AutomatedAsyncJobsPage, AutomatedAsyncJob> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.getAPIList('/jobs/automated', AutomatedAsyncJobsPage, { query, ...options });
+  }
+}
+
+export class AutomatedAsyncJobsPage extends Page<AutomatedAsyncJob> {}
+
+export interface AutomatedAsyncJob {
+  /**
+   * The datetime the job completed.
+   */
+  completed_at: string | null;
+
+  /**
+   * The datetime when the job was created. for scheduled jobs, this will be the
+   * initial connection time. For ad-hoc jobs, this will be the time the creation
+   * request was received.
+   */
+  created_at: string;
+
+  /**
+   * The id of the job that has been created.
+   */
+  job_id: string;
+
+  /**
+   * The url that can be used to retrieve the job status
+   */
+  job_url: string;
+
+  /**
+   * The datetime a job is scheduled to be run. For scheduled jobs, this datetime can
+   * be in the future if the job has not yet been enqueued. For ad-hoc jobs, this
+   * field will be null.
+   */
+  scheduled_at: string | null;
+
+  /**
+   * The datetime a job entered into the job queue.
+   */
+  started_at: string | null;
+
+  status: 'pending' | 'in_progress' | 'complete' | 'error' | 'reauth_error' | 'permissions_error';
+
+  /**
+   * Only `data_sync_all` currently supported
+   */
+  type: 'data_sync_all';
+}
+
+export interface AutomatedCreateResponse {
+  /**
+   * The number of allowed refreshes per hour (per hour, fixed window)
+   */
+  allowed_refreshes: number;
+
+  /**
+   * The id of the job that has been created.
+   */
+  job_id: string;
+
+  /**
+   * The url that can be used to retrieve the job status
+   */
+  job_url: string;
+
+  /**
+   * The number of remaining refreshes available (per hour, fixed window)
+   */
+  remaining_refreshes: number;
+}
+
+export interface AutomatedCreateParams {
+  /**
+   * The type of job to start. Currently the only supported type is `data_sync_all`
+   */
+  type: 'data_sync_all';
+}
+
+export interface AutomatedListParams extends PageParams {}
+
+export namespace Automated {
+  export import AutomatedAsyncJob = AutomatedAPI.AutomatedAsyncJob;
+  export import AutomatedCreateResponse = AutomatedAPI.AutomatedCreateResponse;
+  export import AutomatedAsyncJobsPage = AutomatedAPI.AutomatedAsyncJobsPage;
+  export import AutomatedCreateParams = AutomatedAPI.AutomatedCreateParams;
+  export import AutomatedListParams = AutomatedAPI.AutomatedListParams;
+}

package/src/resources/jobs/index.ts

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless.
+
+export {
+  AutomatedAsyncJob,
+  AutomatedCreateResponse,
+  AutomatedCreateParams,
+  AutomatedListParams,
+  AutomatedAsyncJobsPage,
+  Automated,
+} from './automated';
+export { Jobs } from './jobs';
+export { ManualAsyncJob, Manual } from './manual';

package/src/resources/jobs/jobs.ts

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless.
+
+import { APIResource } from "../../resource";
+import * as AutomatedAPI from "./automated";
+import * as ManualAPI from "./manual";
+
+export class Jobs extends APIResource {
+  automated: AutomatedAPI.Automated = new AutomatedAPI.Automated(this._client);
+  manual: ManualAPI.Manual = new ManualAPI.Manual(this._client);
+}
+
+export namespace Jobs {
+  export import Automated = AutomatedAPI.Automated;
+  export import AutomatedAsyncJob = AutomatedAPI.AutomatedAsyncJob;
+  export import AutomatedCreateResponse = AutomatedAPI.AutomatedCreateResponse;
+  export import AutomatedAsyncJobsPage = AutomatedAPI.AutomatedAsyncJobsPage;
+  export import AutomatedCreateParams = AutomatedAPI.AutomatedCreateParams;
+  export import AutomatedListParams = AutomatedAPI.AutomatedListParams;
+  export import Manual = ManualAPI.Manual;
+  export import ManualAsyncJob = ManualAPI.ManualAsyncJob;
+}

package/src/resources/jobs/manual.ts

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless.
+
+import * as Core from "../../core";
+import { APIResource } from "../../resource";
+import * as ManualAPI from "./manual";
+
+export class Manual extends APIResource {
+  /**
+   * Get a manual job by `job_id`. Manual jobs are completed by a human and include
+   * Assisted Benefits jobs.
+   */
+  retrieve(jobId: string, options?: Core.RequestOptions): Core.APIPromise<ManualAsyncJob> {
+    return this._client.get(`/jobs/manual/${jobId}`, options);
+  }
+}
+
+export interface ManualAsyncJob {
+  /**
+   * Specific information about the job, such as individual statuses for batch jobs.
+   */
+  body: Array<unknown> | null;
+
+  job_id: string;
+
+  status: 'pending' | 'in_progress' | 'error' | 'complete';
+}
+
+export namespace Manual {
+  export import ManualAsyncJob = ManualAPI.ManualAsyncJob;
+}

package/src/resources/shared.ts

@@ -60,3 +60,15 @@ export interface OperationSupportMatrix {
    */
   update?: OperationSupport;
 }
+
+export interface Paging {
+  /**
+   * The total number of elements for the entire query (not just the given page)
+   */
+  count?: number;
+
+  /**
+   * The current start index of the returned list of elements
+   */
+  offset?: number;
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.12.1'; // x-release-please-version
+export const VERSION = '5.13.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.12.1";
+export declare const VERSION = "5.13.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.12.1'; // x-release-please-version
+exports.VERSION = '5.13.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.12.1'; // x-release-please-version
+export const VERSION = '5.13.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map