Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add additional properties to FileMetadataResponse #147

Merged
merged 2 commits into from
May 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/few-pants-thank.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@google/generative-ai": patch
---

Add additional properties `videoMetadata` and `error` to `FileMetadataResponse` type.
11 changes: 11 additions & 0 deletions docs/reference/files/generative-ai.errordetails.__type_.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; ["@type"](./generative-ai.errordetails.__type_.md)

## ErrorDetails."@type" property

**Signature:**

```typescript
"@type"?: string;
```
11 changes: 11 additions & 0 deletions docs/reference/files/generative-ai.errordetails.domain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [domain](./generative-ai.errordetails.domain.md)

## ErrorDetails.domain property

**Signature:**

```typescript
domain?: string;
```
23 changes: 23 additions & 0 deletions docs/reference/files/generative-ai.errordetails.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md)

## ErrorDetails interface

Details object that may be included in an error response.

**Signature:**

```typescript
export interface ErrorDetails
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| ["@type"?](./generative-ai.errordetails.__type_.md) | | string | _(Optional)_ |
| [domain?](./generative-ai.errordetails.domain.md) | | string | _(Optional)_ |
| [metadata?](./generative-ai.errordetails.metadata.md) | | Record&lt;string, unknown&gt; | _(Optional)_ |
| [reason?](./generative-ai.errordetails.reason.md) | | string | _(Optional)_ |

11 changes: 11 additions & 0 deletions docs/reference/files/generative-ai.errordetails.metadata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [metadata](./generative-ai.errordetails.metadata.md)

## ErrorDetails.metadata property

**Signature:**

```typescript
metadata?: Record<string, unknown>;
```
11 changes: 11 additions & 0 deletions docs/reference/files/generative-ai.errordetails.reason.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [reason](./generative-ai.errordetails.reason.md)

## ErrorDetails.reason property

**Signature:**

```typescript
reason?: string;
```
13 changes: 13 additions & 0 deletions docs/reference/files/generative-ai.filemetadataresponse.error.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [FileMetadataResponse](./generative-ai.filemetadataresponse.md) &gt; [error](./generative-ai.filemetadataresponse.error.md)

## FileMetadataResponse.error property

Error populated if file processing has failed.

**Signature:**

```typescript
error?: RpcStatus;
```
2 changes: 2 additions & 0 deletions docs/reference/files/generative-ai.filemetadataresponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ export interface FileMetadataResponse
| --- | --- | --- | --- |
| [createTime](./generative-ai.filemetadataresponse.createtime.md) | | string | |
| [displayName?](./generative-ai.filemetadataresponse.displayname.md) | | string | _(Optional)_ |
| [error?](./generative-ai.filemetadataresponse.error.md) | | [RpcStatus](./generative-ai.rpcstatus.md) | _(Optional)_ Error populated if file processing has failed. |
| [expirationTime](./generative-ai.filemetadataresponse.expirationtime.md) | | string | |
| [mimeType](./generative-ai.filemetadataresponse.mimetype.md) | | string | |
| [name](./generative-ai.filemetadataresponse.name.md) | | string | |
Expand All @@ -26,4 +27,5 @@ export interface FileMetadataResponse
| [state](./generative-ai.filemetadataresponse.state.md) | | [FileState](./generative-ai.filestate.md) | |
| [updateTime](./generative-ai.filemetadataresponse.updatetime.md) | | string | |
| [uri](./generative-ai.filemetadataresponse.uri.md) | | string | |
| [videoMetadata?](./generative-ai.filemetadataresponse.videometadata.md) | | [VideoMetadata](./generative-ai.videometadata.md) | _(Optional)_ Video metadata populated after processing is complete. |

Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [FileMetadataResponse](./generative-ai.filemetadataresponse.md) &gt; [videoMetadata](./generative-ai.filemetadataresponse.videometadata.md)

## FileMetadataResponse.videoMetadata property

Video metadata populated after processing is complete.

**Signature:**

```typescript
videoMetadata?: VideoMetadata;
```
3 changes: 3 additions & 0 deletions docs/reference/files/generative-ai.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,13 @@

| Interface | Description |
| --- | --- |
| [ErrorDetails](./generative-ai.errordetails.md) | Details object that may be included in an error response. |
| [FileMetadata](./generative-ai.filemetadata.md) | Metadata to provide alongside a file upload |
| [FileMetadataResponse](./generative-ai.filemetadataresponse.md) | File metadata response from server. |
| [ListFilesResponse](./generative-ai.listfilesresponse.md) | Response from calling [GoogleAIFileManager.listFiles()](./generative-ai.googleaifilemanager.listfiles.md) |
| [ListParams](./generative-ai.listparams.md) | Params to pass to [GoogleAIFileManager.listFiles()](./generative-ai.googleaifilemanager.listfiles.md) |
| [RequestOptions](./generative-ai.requestoptions.md) | Params passed to getGenerativeModel() or GoogleAIFileManager(). |
| [RpcStatus](./generative-ai.rpcstatus.md) | Standard RPC error status object. |
| [UploadFileResponse](./generative-ai.uploadfileresponse.md) | Response from calling [GoogleAIFileManager.uploadFile()](./generative-ai.googleaifilemanager.uploadfile.md) |
| [VideoMetadata](./generative-ai.videometadata.md) | Metadata populated when video has been processed. |

13 changes: 13 additions & 0 deletions docs/reference/files/generative-ai.rpcstatus.code.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [RpcStatus](./generative-ai.rpcstatus.md) &gt; [code](./generative-ai.rpcstatus.code.md)

## RpcStatus.code property

Error status code

**Signature:**

```typescript
code: number;
```
13 changes: 13 additions & 0 deletions docs/reference/files/generative-ai.rpcstatus.details.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [RpcStatus](./generative-ai.rpcstatus.md) &gt; [details](./generative-ai.rpcstatus.details.md)

## RpcStatus.details property

A list of messages that carry the error details.

**Signature:**

```typescript
details?: ErrorDetails[];
```
22 changes: 22 additions & 0 deletions docs/reference/files/generative-ai.rpcstatus.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [RpcStatus](./generative-ai.rpcstatus.md)

## RpcStatus interface

Standard RPC error status object.

**Signature:**

```typescript
export interface RpcStatus
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [code](./generative-ai.rpcstatus.code.md) | | number | Error status code |
| [details?](./generative-ai.rpcstatus.details.md) | | [ErrorDetails](./generative-ai.errordetails.md)<!-- -->\[\] | _(Optional)_ A list of messages that carry the error details. |
| [message](./generative-ai.rpcstatus.message.md) | | string | A developer-facing error message. |

13 changes: 13 additions & 0 deletions docs/reference/files/generative-ai.rpcstatus.message.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [RpcStatus](./generative-ai.rpcstatus.md) &gt; [message](./generative-ai.rpcstatus.message.md)

## RpcStatus.message property

A developer-facing error message.

**Signature:**

```typescript
message: string;
```
20 changes: 20 additions & 0 deletions docs/reference/files/generative-ai.videometadata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [VideoMetadata](./generative-ai.videometadata.md)

## VideoMetadata interface

Metadata populated when video has been processed.

**Signature:**

```typescript
export interface VideoMetadata
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [videoDuration](./generative-ai.videometadata.videoduration.md) | | string | The video duration in protobuf [Duration](https://cloud.google.com/ruby/docs/reference/google-cloud-workflows-v1/latest/Google-Protobuf-Duration#json-mapping) format. |

13 changes: 13 additions & 0 deletions docs/reference/files/generative-ai.videometadata.videoduration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [VideoMetadata](./generative-ai.videometadata.md) &gt; [videoDuration](./generative-ai.videometadata.videoduration.md)

## VideoMetadata.videoDuration property

The video duration in protobuf [Duration](https://cloud.google.com/ruby/docs/reference/google-cloud-workflows-v1/latest/Google-Protobuf-Duration#json-mapping) format.

**Signature:**

```typescript
videoDuration: string;
```
11 changes: 11 additions & 0 deletions docs/reference/main/generative-ai.errordetails.__type_.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; ["@type"](./generative-ai.errordetails.__type_.md)

## ErrorDetails."@type" property

**Signature:**

```typescript
"@type"?: string;
```
11 changes: 11 additions & 0 deletions docs/reference/main/generative-ai.errordetails.domain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [domain](./generative-ai.errordetails.domain.md)

## ErrorDetails.domain property

**Signature:**

```typescript
domain?: string;
```
23 changes: 23 additions & 0 deletions docs/reference/main/generative-ai.errordetails.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md)

## ErrorDetails interface

Details object that may be included in an error response.

**Signature:**

```typescript
export interface ErrorDetails
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| ["@type"?](./generative-ai.errordetails.__type_.md) | | string | _(Optional)_ |
| [domain?](./generative-ai.errordetails.domain.md) | | string | _(Optional)_ |
| [metadata?](./generative-ai.errordetails.metadata.md) | | Record&lt;string, unknown&gt; | _(Optional)_ |
| [reason?](./generative-ai.errordetails.reason.md) | | string | _(Optional)_ |

11 changes: 11 additions & 0 deletions docs/reference/main/generative-ai.errordetails.metadata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [metadata](./generative-ai.errordetails.metadata.md)

## ErrorDetails.metadata property

**Signature:**

```typescript
metadata?: Record<string, unknown>;
```
11 changes: 11 additions & 0 deletions docs/reference/main/generative-ai.errordetails.reason.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@google/generative-ai](./generative-ai.md) &gt; [ErrorDetails](./generative-ai.errordetails.md) &gt; [reason](./generative-ai.errordetails.reason.md)

## ErrorDetails.reason property

**Signature:**

```typescript
reason?: string;
```
Original file line number Diff line number Diff line change
Expand Up @@ -19,5 +19,5 @@ constructor(message: string, status?: number, statusText?: string, errorDetails?
| message | string | |
| status | number | _(Optional)_ |
| statusText | string | _(Optional)_ |
| errorDetails | ErrorDetails\[\] | _(Optional)_ |
| errorDetails | [ErrorDetails](./generative-ai.errordetails.md)<!-- -->\[\] | _(Optional)_ |

Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ export declare class GoogleGenerativeAIFetchError extends GoogleGenerativeAIErro

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [errorDetails?](./generative-ai.googlegenerativeaifetcherror.errordetails.md) | | ErrorDetails\[\] | _(Optional)_ |
| [errorDetails?](./generative-ai.googlegenerativeaifetcherror.errordetails.md) | | [ErrorDetails](./generative-ai.errordetails.md)<!-- -->\[\] | _(Optional)_ |
| [status?](./generative-ai.googlegenerativeaifetcherror.status.md) | | number | _(Optional)_ |
| [statusText?](./generative-ai.googlegenerativeaifetcherror.statustext.md) | | string | _(Optional)_ |

1 change: 1 addition & 0 deletions docs/reference/main/generative-ai.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@
| [EmbedContentRequest](./generative-ai.embedcontentrequest.md) | Params for calling [GenerativeModel.embedContent()](./generative-ai.generativemodel.embedcontent.md) |
| [EmbedContentResponse](./generative-ai.embedcontentresponse.md) | Response from calling [GenerativeModel.embedContent()](./generative-ai.generativemodel.embedcontent.md)<!-- -->. |
| [EnhancedGenerateContentResponse](./generative-ai.enhancedgeneratecontentresponse.md) | Response object wrapped with helper methods. |
| [ErrorDetails](./generative-ai.errordetails.md) | Details object that may be included in an error response. |
| [FileData](./generative-ai.filedata.md) | Data pointing to a file uploaded with the Files API. |
| [FileDataPart](./generative-ai.filedatapart.md) | Content part interface if the part represents FunctionResponse. |
| [FunctionCall](./generative-ai.functioncall.md) | A predicted \[FunctionCall\] returned from the model that contains a string representing the \[FunctionDeclaration.name\] and a structured JSON object containing the parameters and their values. |
Expand Down
14 changes: 2 additions & 12 deletions packages/main/src/errors.ts
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@
* limitations under the License.
*/

import { ErrorDetails } from "../types";

/**
* Basic error type for this SDK.
* @public
Expand Down Expand Up @@ -62,15 +64,3 @@ export class GoogleGenerativeAIFetchError extends GoogleGenerativeAIError {
* @public
*/
export class GoogleGenerativeAIRequestInputError extends GoogleGenerativeAIError {}

/**
* Details object that may be included in an error response.
* @public
*/
interface ErrorDetails {
"@type"?: string;
reason?: string;
domain?: string;
metadata?: Record<string, unknown>;
[key: string]: unknown;
}
Loading
Loading