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-53f7c35748f9b41bb07f888796c7417ea84e5e63ab0e9e2aa4a8d64e48713b24.yml
 openapi_spec_hash: 098ce74bcff31c61870e3d0ce357814b
-config_hash: b8c48b915f11a452e84fafc0e851a772
+config_hash: 90f5a16140d721a24bffafbc30abaf35

api.md

@@ -1,10 +1,3 @@
-# Shared
-
-Types:
-
-- <code><a href="./src/resources/shared.ts">File</a></code>
-- <code><a href="./src/resources/shared.ts">Folder</a></code>
-
 # CustomMetadataFields
 
 Types:
@@ -24,6 +17,8 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/files/files.ts">File</a></code>
+- <code><a href="./src/resources/files/files.ts">Folder</a></code>
 - <code><a href="./src/resources/files/files.ts">Metadata</a></code>
 - <code><a href="./src/resources/files/files.ts">FileUpdateResponse</a></code>
 - <code><a href="./src/resources/files/files.ts">FileCopyResponse</a></code>

src/client.ts

@@ -38,6 +38,7 @@ import { Accounts } from './resources/accounts/accounts';
 import { Beta } from './resources/beta/beta';
 import { Cache } from './resources/cache/cache';
 import {
+  File,
   FileCopyParams,
   FileCopyResponse,
   FileMoveParams,
@@ -49,6 +50,7 @@ import {
   FileUploadParams,
   FileUploadResponse,
   Files,
+  Folder,
   Metadata,
 } from './resources/files/files';
 import {
@@ -826,6 +828,8 @@ export declare namespace ImageKit {
 
   export {
     Files as Files,
+    type File as File,
+    type Folder as Folder,
     type Metadata as Metadata,
     type FileUpdateResponse as FileUpdateResponse,
     type FileCopyResponse as FileCopyResponse,
@@ -873,7 +877,4 @@ export declare namespace ImageKit {
     type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };
-
-  export type File = API.File;
-  export type Folder = API.Folder;
 }

src/resources/assets.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as Shared from './shared';
+import * as FilesAPI from './files/files';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
@@ -20,7 +20,7 @@ export class Assets extends APIResource {
   }
 }
 
-export type AssetListResponse = Array<Shared.File | Shared.Folder>;
+export type AssetListResponse = Array<FilesAPI.File | FilesAPI.Folder>;
 
 export interface AssetListParams {
   /**

src/resources/files/files.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as Shared from '../shared';
 import * as BulkAPI from './bulk';
 import {
   Bulk,
@@ -103,7 +102,7 @@ export class Files extends APIResource {
    * const file = await client.files.get('fileId');
    * ```
    */
-  get(fileID: string, options?: RequestOptions): APIPromise<Shared.File> {
+  get(fileID: string, options?: RequestOptions): APIPromise<File> {
     return this._client.get(path`/v1/files/${fileID}/details`, options);
   }
 
@@ -192,6 +191,201 @@ export class Files extends APIResource {
   }
 }
 
+/**
+ * Object containing details of a file or file version.
+ */
+export interface File {
+  /**
+   * An array of tags assigned to the file by auto tagging.
+   */
+  AITags?: Array<File.AITag> | null;
+
+  /**
+   * Date and time when the file was uploaded. The date and time is in ISO8601
+   * format.
+   */
+  createdAt?: string;
+
+  /**
+   * An string with custom coordinates of the file.
+   */
+  customCoordinates?: string | null;
+
+  /**
+   * An object with custom metadata for the file.
+   */
+  customMetadata?: { [key: string]: unknown };
+
+  /**
+   * Optional text to describe the contents of the file. Can be set by the user or
+   * the ai-auto-description extension.
+   */
+  description?: string;
+
+  /**
+   * Unique identifier of the asset.
+   */
+  fileId?: string;
+
+  /**
+   * Path of the file. This is the path you would use in the URL to access the file.
+   * For example, if the file is at the root of the media library, the path will be
+   * `/file.jpg`. If the file is inside a folder named `images`, the path will be
+   * `/images/file.jpg`.
+   */
+  filePath?: string;
+
+  /**
+   * Type of the file. Possible values are `image`, `non-image`.
+   */
+  fileType?: string;
+
+  /**
+   * Specifies if the image has an alpha channel.
+   */
+  hasAlpha?: boolean;
+
+  /**
+   * Height of the file.
+   */
+  height?: number;
+
+  /**
+   * Specifies if the file is private or not.
+   */
+  isPrivateFile?: boolean;
+
+  /**
+   * Specifies if the file is published or not.
+   */
+  isPublished?: boolean;
+
+  /**
+   * MIME type of the file.
+   */
+  mime?: string;
+
+  /**
+   * Name of the asset.
+   */
+  name?: string;
+
+  /**
+   * Size of the file in bytes.
+   */
+  size?: number;
+
+  /**
+   * An array of tags assigned to the file. Tags are used to search files in the
+   * media library.
+   */
+  tags?: Array<string> | null;
+
+  /**
+   * URL of the thumbnail image. This URL is used to access the thumbnail image of
+   * the file in the media library.
+   */
+  thumbnail?: string;
+
+  /**
+   * Type of the asset.
+   */
+  type?: 'file' | 'file-version';
+
+  /**
+   * Date and time when the file was last updated. The date and time is in ISO8601
+   * format.
+   */
+  updatedAt?: string;
+
+  /**
+   * URL of the file.
+   */
+  url?: string;
+
+  /**
+   * An object with details of the file version.
+   */
+  versionInfo?: File.VersionInfo;
+
+  /**
+   * Width of the file.
+   */
+  width?: number;
+}
+
+export namespace File {
+  export interface AITag {
+    /**
+     * Confidence score of the tag.
+     */
+    confidence?: number;
+
+    /**
+     * Name of the tag.
+     */
+    name?: string;
+
+    /**
+     * Source of the tag. Possible values are `google-auto-tagging` and
+     * `aws-auto-tagging`.
+     */
+    source?: string;
+  }
+
+  /**
+   * An object with details of the file version.
+   */
+  export interface VersionInfo {
+    /**
+     * Unique identifier of the file version.
+     */
+    id?: string;
+
+    /**
+     * Name of the file version.
+     */
+    name?: string;
+  }
+}
+
+export interface Folder {
+  /**
+   * Date and time when the folder was created. The date and time is in ISO8601
+   * format.
+   */
+  createdAt?: string;
+
+  /**
+   * Unique identifier of the asset.
+   */
+  folderId?: string;
+
+  /**
+   * Path of the folder. This is the path you would use in the URL to access the
+   * folder. For example, if the folder is at the root of the media library, the path
+   * will be /folder. If the folder is inside another folder named images, the path
+   * will be /images/folder.
+   */
+  folderPath?: string;
+
+  /**
+   * Name of the asset.
+   */
+  name?: string;
+
+  /**
+   * Type of the asset.
+   */
+  type?: 'folder';
+
+  /**
+   * Date and time when the folder was last updated. The date and time is in ISO8601
+   * format.
+   */
+  updatedAt?: string;
+}
+
 /**
  * JSON object containing metadata.
  */
@@ -417,7 +611,7 @@ export namespace Metadata {
 /**
  * Object containing details of a file or file version.
  */
-export interface FileUpdateResponse extends Shared.File {
+export interface FileUpdateResponse extends File {
   extensionStatus?: FileUpdateResponse.ExtensionStatus;
 }
 
@@ -1242,6 +1436,8 @@ Files.Versions = Versions;
 
 export declare namespace Files {
   export {
+    type File as File,
+    type Folder as Folder,
     type Metadata as Metadata,
     type FileUpdateResponse as FileUpdateResponse,
     type FileCopyResponse as FileCopyResponse,

src/resources/files/index.ts

@@ -13,6 +13,8 @@ export {
 } from './bulk';
 export {
   Files,
+  type File,
+  type Folder,
   type Metadata,
   type FileUpdateResponse,
   type FileCopyResponse,

src/resources/files/versions.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as Shared from '../shared';
+import * as FilesAPI from './files';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -52,7 +52,7 @@ export class Versions extends APIResource {
    * });
    * ```
    */
-  get(versionID: string, params: VersionGetParams, options?: RequestOptions): APIPromise<Shared.File> {
+  get(versionID: string, params: VersionGetParams, options?: RequestOptions): APIPromise<FilesAPI.File> {
     const { fileId } = params;
     return this._client.get(path`/v1/files/${fileId}/versions/${versionID}`, options);
   }
@@ -72,13 +72,13 @@ export class Versions extends APIResource {
     versionID: string,
     params: VersionRestoreParams,
     options?: RequestOptions,
-  ): APIPromise<Shared.File> {
+  ): APIPromise<FilesAPI.File> {
     const { fileId } = params;
     return this._client.put(path`/v1/files/${fileId}/versions/${versionID}/restore`, options);
   }
 }
 
-export type VersionListResponse = Array<Shared.File>;
+export type VersionListResponse = Array<FilesAPI.File>;
 
 export interface VersionDeleteResponse {}
 

src/resources/index.ts

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './shared';
 export { Accounts } from './accounts/accounts';
 export { Assets, type AssetListResponse, type AssetListParams } from './assets';
 export { Beta } from './beta/beta';
@@ -16,6 +15,8 @@ export {
 } from './custom-metadata-fields';
 export {
   Files,
+  type File,
+  type Folder,
   type Metadata,
   type FileUpdateResponse,
   type FileCopyResponse,