feat(api): OpenAPI spec update via Stainless API (#462)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 37
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-b2ed1e65ba74c2cfa35b2eeb38cd139e89ba1bdd3462e879d118259680680ebc.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-e915b33a18d4e6592966587ef174bbfe316edd9bc1fd7c17f86f372089bf80eb.yml

src/_shims/node-types.d.ts

@@ -7,7 +7,7 @@ import * as fd from 'formdata-node';
 export { type Agent } from 'node:http';
 export { type Readable } from 'node:stream';
 export { type ReadStream as FsReadStream } from 'node:fs';
-export { ReadableStream } from 'web-streams-polyfill';
+export { ReadableStream } from 'node:stream/web';
 
 export const fetch: typeof nf.default;
 

src/core.ts

@@ -274,7 +274,10 @@ export abstract class APIClient {
     return null;
   }
 
-  buildRequest<Req>(options: FinalRequestOptions<Req>): { req: RequestInit; url: string; timeout: number } {
+  buildRequest<Req>(
+    options: FinalRequestOptions<Req>,
+    { retryCount = 0 }: { retryCount?: number } = {},
+  ): { req: RequestInit; url: string; timeout: number } {
     const { method, path, query, headers: headers = {} } = options;
 
     const body =
@@ -306,7 +309,7 @@ export abstract class APIClient {
       headers[this.idempotencyHeader] = options.idempotencyKey;
     }
 
-    const reqHeaders = this.buildHeaders({ options, headers, contentLength });
+    const reqHeaders = this.buildHeaders({ options, headers, contentLength, retryCount });
 
     const req: RequestInit = {
       method,
@@ -325,10 +328,12 @@ export abstract class APIClient {
     options,
     headers,
     contentLength,
+    retryCount,
   }: {
     options: FinalRequestOptions;
     headers: Record<string, string | null | undefined>;
     contentLength: string | null | undefined;
+    retryCount: number;
   }): Record<string, string> {
     const reqHeaders: Record<string, string> = {};
     if (contentLength) {
@@ -344,6 +349,8 @@ export abstract class APIClient {
       delete reqHeaders['content-type'];
     }
 
+    reqHeaders['x-stainless-retry-count'] = String(retryCount);
+
     this.validateHeaders(reqHeaders, headers);
 
     return reqHeaders;
@@ -395,13 +402,14 @@ export abstract class APIClient {
     retriesRemaining: number | null,
   ): Promise<APIResponseProps> {
     const options = await optionsInput;
+    const maxRetries = options.maxRetries ?? this.maxRetries;
     if (retriesRemaining == null) {
-      retriesRemaining = options.maxRetries ?? this.maxRetries;
+      retriesRemaining = maxRetries;
     }
 
     await this.prepareOptions(options);
 
-    const { req, url, timeout } = this.buildRequest(options);
+    const { req, url, timeout } = this.buildRequest(options, { retryCount: maxRetries - retriesRemaining });
 
     await this.prepareRequest(req, { url, options });
 

src/resources/sandbox/directory.ts

@@ -107,6 +107,8 @@ export namespace DirectoryCreateParams {
      */
     last_name?: string | null;
 
+    latest_rehire_date?: string | null;
+
     location?: HRISAPI.Location | null;
 
     /**

src/resources/sandbox/employment.ts

@@ -85,6 +85,8 @@ export interface EmploymentUpdateResponse {
    */
   last_name?: string | null;
 
+  latest_rehire_date?: string | null;
+
   location?: HRISAPI.Location | null;
 
   /**
@@ -205,6 +207,8 @@ export interface EmploymentUpdateParams {
    */
   last_name?: string | null;
 
+  latest_rehire_date?: string | null;
+
   location?: HRISAPI.Location | null;
 
   /**

tests/api-resources/sandbox/directory.test.ts

@@ -52,6 +52,7 @@ describe('resource directory', () => {
         ],
         is_active: true,
         last_name: 'Smith',
+        latest_rehire_date: 'latest_rehire_date',
         location: {
           city: 'city',
           country: 'country',

tests/api-resources/sandbox/employment.test.ts

@@ -53,6 +53,7 @@ describe('resource employment', () => {
           ],
           is_active: true,
           last_name: 'last_name',
+          latest_rehire_date: 'latest_rehire_date',
           location: {
             city: 'city',
             country: 'country',

tests/index.test.ts

@@ -309,6 +309,37 @@ describe('retries', () => {
     expect(count).toEqual(3);
   });
 
+  test('retry count header', async () => {
+    let count = 0;
+    let capturedRequest: RequestInit | undefined;
+    const testFetch = async (url: RequestInfo, init: RequestInit = {}): Promise<Response> => {
+      count++;
+      if (count <= 2) {
+        return new Response(undefined, {
+          status: 429,
+          headers: {
+            'Retry-After': '0.1',
+          },
+        });
+      }
+      capturedRequest = init;
+      return new Response(JSON.stringify({ a: 1 }), { headers: { 'Content-Type': 'application/json' } });
+    };
+
+    const client = new Finch({
+      accessToken: 'My Access Token',
+      clientId: '4ab15e51-11ad-49f4-acae-f343b7794375',
+      clientSecret: 'My Client Secret',
+      fetch: testFetch,
+      maxRetries: 4,
+    });
+
+    expect(await client.request({ path: '/foo', method: 'get' })).toEqual({ a: 1 });
+
+    expect((capturedRequest!.headers as Headers)['x-stainless-retry-count']).toEqual('2');
+    expect(count).toEqual(3);
+  });
+
   test('retry on 429 with retry-after', async () => {
     let count = 0;
     const testFetch = async (url: RequestInfo, { signal }: RequestInit = {}): Promise<Response> => {