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-667f7f4988b44bc587d6eb9960ff5c8326e9f7e9b072f3f724f9f54166eff8b1.yml
-openapi_spec_hash: f2081864a4abee0480e5ff991b4c936a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-eab9713fd85da68b41e881dfd9cd71f654e8620132da2023bab7dd01e5f7852e.yml
+openapi_spec_hash: b5037b26fbe7360c6bfaf9947a65bb85
 config_hash: 70f9408b8d1dfbcf262a20d6eed50e1c

README.md

@@ -31,7 +31,7 @@ const client = new ImageKit({
 });
 
 const response = await client.files.upload({
-  file: fs.createReadStream('path/to/file'),
+  file: 'https://www.example.com/public-url.jpg',
   fileName: 'file-name.jpg',
 });
 
@@ -52,7 +52,7 @@ const client = new ImageKit({
 });
 
 const params: ImageKit.FileUploadParams = {
-  file: fs.createReadStream('path/to/file'),
+  file: 'https://www.example.com/public-url.jpg',
   fileName: 'file-name.jpg',
 };
 const response: ImageKit.FileUploadResponse = await client.files.upload(params);
@@ -76,17 +76,23 @@ import ImageKit, { toFile } from '@imagekit/nodejs';
 const client = new ImageKit();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.files.upload({ file: fs.createReadStream('/path/to/file'), fileName: 'fileName' });
+await client.beta.v2.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.files.upload({ file: new File(['my bytes'], 'file'), fileName: 'fileName' });
+await client.beta.v2.files.upload({ file: new File(['my bytes'], 'file'), fileName: 'fileName' });
 
 // You can also pass a `fetch` `Response`:
-await client.files.upload({ file: await fetch('https://somesite/file'), fileName: 'fileName' });
+await client.beta.v2.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.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' });
+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',
+});
 ```
 
 ## Handling errors
@@ -98,7 +104,7 @@ a subclass of `APIError` will be thrown:
 <!-- prettier-ignore -->
 ```ts
 const response = await client.files
-  .upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
+  .upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' })
   .catch(async (err) => {
     if (err instanceof ImageKit.APIError) {
       console.log(err.status); // 400
@@ -139,7 +145,7 @@ const client = new ImageKit({
 });
 
 // Or, configure per-request:
-await client.files.upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' }, {
+await client.files.upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' }, {
   maxRetries: 5,
 });
 ```
@@ -156,7 +162,7 @@ const client = new ImageKit({
 });
 
 // Override per-request:
-await client.files.upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' }, {
+await client.files.upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -180,13 +186,13 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 const client = new ImageKit();
 
 const response = await client.files
-  .upload({ file: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
+  .upload({ file: 'https://www.example.com/public-url.jpg', 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: fs.createReadStream('path/to/file'), fileName: 'file-name.jpg' })
+  .upload({ file: 'https://www.example.com/public-url.jpg', fileName: 'file-name.jpg' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(response.videoCodec);

src/resources/files/files.ts

@@ -25,7 +25,6 @@ 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 +174,7 @@ export class Files extends APIResource {
    * @example
    * ```ts
    * const response = await client.files.upload({
-   *   file: fs.createReadStream('path/to/file'),
+   *   file: 'https://www.example.com/path/to-image.jpg',
    *   fileName: 'fileName',
    * });
    * ```
@@ -1079,7 +1078,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: Uploadable;
+  file: string;
 
   /**
    * 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, { toFile } from '@imagekit/nodejs';
+import ImageKit from '@imagekit/nodejs';
 
 const client = new ImageKit({
   privateAPIKey: 'My Private API Key',
@@ -154,7 +154,7 @@ describe('resource files', () => {
   // Prism tests are disabled
   test.skip('upload: only required params', async () => {
     const responsePromise = client.files.upload({
-      file: await toFile(Buffer.from('# my file contents'), 'README.md'),
+      file: 'https://www.example.com/path/to-image.jpg',
       fileName: 'fileName',
     });
     const rawResponse = await responsePromise.asResponse();
@@ -169,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: await toFile(Buffer.from('# my file contents'), 'README.md'),
+      file: 'https://www.example.com/path/to-image.jpg',
       fileName: 'fileName',
       token: 'token',
       checks: '"request.folder" : "marketing/"\n',