feat(api): add GET /extensions/{id_or_name}/metadata

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-ab4e7c50c41fefd891648fa84ba0258986f192ba1bde9f42cbdf487f64c4cc27.yml
-openapi_spec_hash: b4bcd6557f7045ecff30b01e02d28ac5
-config_hash: 03c7e57f268c750e2415831662e95969
+configured_endpoints: 121
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-bccc42bb10d1afe703f0374d11f33e775522069d69a13bb2345cc566a49ba4f3.yml
+openapi_spec_hash: 9f00975c0e741ed84011413674313be0
+config_hash: 3a50aee540dce69a53bb8942f5086f5e

api.md

@@ -301,6 +301,7 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/extensions.ts">ExtensionListResponse</a></code>
+- <code><a href="./src/resources/extensions.ts">ExtensionGetResponse</a></code>
 - <code><a href="./src/resources/extensions.ts">ExtensionUploadResponse</a></code>
 
 Methods:
@@ -309,6 +310,7 @@ Methods:
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">delete</a>(idOrName) -> void</code>
 - <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">download</a>(idOrName) -> Response</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/resources/extensions.ts">downloadFromChromeStore</a>({ ...params }) -> Response</code>
+- <code title="get /extensions/{id_or_name}/metadata">client.extensions.<a href="./src/resources/extensions.ts">get</a>(idOrName) -> ExtensionGetResponse</code>
 - <code title="post /extensions">client.extensions.<a href="./src/resources/extensions.ts">upload</a>({ ...params }) -> ExtensionUploadResponse</code>
 
 # BrowserPools

src/client.ts

@@ -87,6 +87,7 @@ import {
 import { KernelApp } from './core/app-framework';
 import {
   ExtensionDownloadFromChromeStoreParams,
+  ExtensionGetResponse,
   ExtensionListParams,
   ExtensionListResponse,
   ExtensionListResponsesOffsetPagination,
@@ -1117,6 +1118,7 @@ export declare namespace Kernel {
   export {
     Extensions as Extensions,
     type ExtensionListResponse as ExtensionListResponse,
+    type ExtensionGetResponse as ExtensionGetResponse,
     type ExtensionUploadResponse as ExtensionUploadResponse,
     type ExtensionListResponsesOffsetPagination as ExtensionListResponsesOffsetPagination,
     type ExtensionListParams as ExtensionListParams,

src/resources/extensions.ts

@@ -97,6 +97,19 @@ export class Extensions extends APIResource {
     });
   }
 
+  /**
+   * Get an extension's metadata (name, size, timestamps) by ID or name, without
+   * downloading the archive.
+   *
+   * @example
+   * ```ts
+   * const extension = await client.extensions.get('id_or_name');
+   * ```
+   */
+  get(idOrName: string, options?: RequestOptions): APIPromise<ExtensionGetResponse> {
+    return this._client.get(path`/extensions/${idOrName}/metadata`, options);
+  }
+
   /**
    * Upload a zip file containing an unpacked browser extension. Optionally provide a
    * unique name for later reference.
@@ -146,6 +159,37 @@ export interface ExtensionListResponse {
   name?: string | null;
 }
 
+/**
+ * A browser extension uploaded to Kernel.
+ */
+export interface ExtensionGetResponse {
+  /**
+   * Unique identifier for the extension
+   */
+  id: string;
+
+  /**
+   * Timestamp when the extension was created
+   */
+  created_at: string;
+
+  /**
+   * Size of the extension archive in bytes
+   */
+  size_bytes: number;
+
+  /**
+   * Timestamp when the extension was last used
+   */
+  last_used_at?: string | null;
+
+  /**
+   * Optional, easier-to-reference name for the extension. Must be unique within the
+   * project.
+   */
+  name?: string | null;
+}
+
 /**
  * A browser extension uploaded to Kernel.
  */
@@ -211,6 +255,7 @@ export interface ExtensionUploadParams {
 export declare namespace Extensions {
   export {
     type ExtensionListResponse as ExtensionListResponse,
+    type ExtensionGetResponse as ExtensionGetResponse,
     type ExtensionUploadResponse as ExtensionUploadResponse,
     type ExtensionListResponsesOffsetPagination as ExtensionListResponsesOffsetPagination,
     type ExtensionListParams as ExtensionListParams,

src/resources/index.ts

@@ -90,6 +90,7 @@ export {
 export {
   Extensions,
   type ExtensionListResponse,
+  type ExtensionGetResponse,
   type ExtensionUploadResponse,
   type ExtensionListParams,
   type ExtensionDownloadFromChromeStoreParams,

tests/api-resources/extensions.test.ts

@@ -52,6 +52,18 @@ describe('resource extensions', () => {
     const response = await client.extensions.downloadFromChromeStore({ url: 'url', os: 'win' });
   });
 
+  // Mock server tests are disabled
+  test.skip('get', async () => {
+    const responsePromise = client.extensions.get('id_or_name');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
   // Mock server tests are disabled
   test.skip('upload: only required params', async () => {
     const responsePromise = client.extensions.upload({