feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 42
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-911102f2eaf3be4b34381f6ba089330bed099bb72eb93667ce2f6e72b5934c8c.yml
-openapi_spec_hash: 637ad417a580137914441bd790b04cc2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-0726d89b19f532c7fb92990d688a9bfb5aa4a9a871d64f49d4ba45bac6998e4a.yml
+openapi_spec_hash: 9525bb02ab496b3459a1f93ac50968e3
 config_hash: 70f9408b8d1dfbcf262a20d6eed50e1c

README.md

@@ -31,7 +31,7 @@ const client = new ImageKit({
 });
 
 const response = await client.files.upload({
-  file: 'https://www.example.com/public-url.jpg',
+  file: fs.createReadStream('path/to/file'),
   fileName: 'file-name.jpg',
 });
 
@@ -52,7 +52,7 @@ const client = new ImageKit({
 });
 
 const params: ImageKit.FileUploadParams = {
-  file: 'https://www.example.com/public-url.jpg',
+  file: fs.createReadStream('path/to/file'),
   fileName: 'file-name.jpg',
 };
 const response: ImageKit.FileUploadResponse = await client.files.upload(params);
@@ -76,23 +76,17 @@ import ImageKit, { toFile } from '@imagekit/nodejs';
 const client = new ImageKit();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.beta.v2.files.upload({ file: fs.createReadStream('/path/to/file'), fileName: 'fileName' });
+await client.files.upload({ file: fs.createReadStream('/path/to/file'), fileName: 'fileName' });
 
 // Or if you have the web `File` API you can pass a `File` instance:
-await client.beta.v2.files.upload({ file: new File(['my bytes'], 'file'), fileName: 'fileName' });
+await client.files.upload({ file: new File(['my bytes'], 'file'), fileName: 'fileName' });
 
 // You can also pass a `fetch` `Response`:
-await client.beta.v2.files.upload({ file: await fetch('https://somesite/file'), fileName: 'fileName' });
+await client.files.upload({ file: await fetch('https://somesite/file'), fileName: 'fileName' });
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.beta.v2.files.upload({
-  file: await toFile(Buffer.from('my bytes'), 'file'),
-  fileName: 'fileName',
-});
-await client.beta.v2.files.upload({
-  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
-  fileName: 'fileName',
-});
+await client.files.upload({ file: await toFile(Buffer.from('my bytes'), 'file'), fileName: 'fileName' });
+await client.files.upload({ file: await toFile(new Uint8Array([0, 1, 2]), 'file'), fileName: 'fileName' });
 ```
 
 ## URL generation
@@ -301,7 +295,7 @@ a subclass of `APIError` will be thrown:
 <!-- prettier-ignore -->
 ```ts
 const response = await client.files
-  .upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' })
+  .upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
   .catch(async (err) => {
     if (err instanceof ImageKit.APIError) {
       console.log(err.status); // 400
@@ -342,7 +336,7 @@ const client = new ImageKit({
 });
 
 // Or, configure per-request:
-await client.files.upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' }, {
+await client.files.upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' }, {
   maxRetries: 5,
 });
 ```
@@ -359,7 +353,7 @@ const client = new ImageKit({
 });
 
 // Override per-request:
-await client.files.upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' }, {
+await client.files.upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -383,13 +377,13 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 const client = new ImageKit();
 
 const response = await client.files
-  .upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' })
+  .upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
   .asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
 const { data: response, response: raw } = await client.files
-  .upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' })
+  .upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(response.videoCodec);

src/resources/files/files.ts

@@ -25,6 +25,7 @@ import {
   Versions,
 } from './versions';
 import { APIPromise } from '../../core/api-promise';
+import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { multipartFormRequestOptions } from '../../internal/uploads';
@@ -175,7 +176,7 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * const response = await client.files.upload({
-   *   file: 'file',
+   *   file: fs.createReadStream('path/to/file'),
    *   fileName: 'fileName',
    * });
    * ```
@@ -1081,7 +1082,7 @@ export interface FileUploadParams {
    * When supplying a URL, the server must receive the response headers within 8
    * seconds; otherwise the request fails with 400 Bad Request.
    */
-  file: string;
+  file: Uploadable;
 
   /**
    * The name with which the file has to be uploaded. The file name can contain:

tests/api-resources/files/files.test.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import ImageKit from '@imagekit/nodejs';
+import ImageKit, { toFile } from '@imagekit/nodejs';
 
 const client = new ImageKit({
   privateAPIKey: 'My Private API Key',
@@ -153,7 +153,10 @@ describe('resource files', () => {
 
   // Prism tests are disabled
   test.skip('upload: only required params', async () => {
-    const responsePromise = client.files.upload({ file: 'file', fileName: 'fileName' });
+    const responsePromise = client.files.upload({
+      file: await toFile(Buffer.from('# my file contents'), 'README.md'),
+      fileName: 'fileName',
+    });
     const rawResponse = await responsePromise.asResponse();
     expect(rawResponse).toBeInstanceOf(Response);
     const response = await responsePromise;
@@ -166,7 +169,7 @@ describe('resource files', () => {
   // Prism tests are disabled
   test.skip('upload: required and optional params', async () => {
     const response = await client.files.upload({
-      file: 'file',
+      file: await toFile(Buffer.from('# my file contents'), 'README.md'),
       fileName: 'fileName',
       token: 'token',
       checks: '"request.folder" : "marketing/"\n',