feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 10
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-c9f598f79a7265337b04e831c4c36bfd8216901c74a5e6d14a38e30d33ec731b.yml
-openapi_spec_hash: 458ba78d4ac13aea449822777e9194a5
-config_hash: 7532946d051190f2cb8accabad7d586b
+configured_endpoints: 14
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-4fd8477b6ac821ae7ed8be9f2bf0995788a1b89009bf771bff6868f3a62c0c50.yml
+openapi_spec_hash: 43ec44a0c44eacf31a71a5f00cd28a83
+config_hash: 66be21d9e622533a4b22a18501a02005

README.md

@@ -26,7 +26,7 @@ The full API of this library can be found in [api.md](api.md).
 import StainlessV0 from 'stainless-v0';
 
 const client = new StainlessV0({
-  apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
+  apiKey: process.env['STAINLESS_V0_API_KEY'], // This is the default and can be omitted
 });
 
 async function main() {
@@ -47,7 +47,7 @@ This library includes TypeScript definitions for all request params and response
 import StainlessV0 from 'stainless-v0';
 
 const client = new StainlessV0({
-  apiKey: process.env['STAINLESS_API_KEY'], // This is the default and can be omitted
+  apiKey: process.env['STAINLESS_V0_API_KEY'], // This is the default and can be omitted
 });
 
 async function main() {

api.md

@@ -4,11 +4,13 @@ Types:
 
 - <code><a href="./src/resources/projects/projects.ts">ProjectRetrieveResponse</a></code>
 - <code><a href="./src/resources/projects/projects.ts">ProjectUpdateResponse</a></code>
+- <code><a href="./src/resources/projects/projects.ts">ProjectListResponse</a></code>
 
 Methods:
 
 - <code title="get /v0/projects/{projectName}">client.projects.<a href="./src/resources/projects/projects.ts">retrieve</a>(projectName) -> ProjectRetrieveResponse</code>
 - <code title="patch /v0/projects/{projectName}">client.projects.<a href="./src/resources/projects/projects.ts">update</a>(projectName, { ...params }) -> ProjectUpdateResponse</code>
+- <code title="get /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">list</a>({ ...params }) -> ProjectListResponse</code>
 
 ## Branches
 
@@ -33,6 +35,16 @@ Methods:
 - <code title="get /v0/projects/{project}/configs">client.projects.configs.<a href="./src/resources/projects/configs.ts">retrieve</a>(project, { ...params }) -> ConfigRetrieveResponse</code>
 - <code title="post /v0/projects/{project}/configs/guess">client.projects.configs.<a href="./src/resources/projects/configs.ts">guess</a>(project, { ...params }) -> ConfigGuessResponse</code>
 
+## Snippets
+
+Types:
+
+- <code><a href="./src/resources/projects/snippets.ts">SnippetCreateRequestResponse</a></code>
+
+Methods:
+
+- <code title="post /v0/projects/{projectName}/snippets/request">client.projects.snippets.<a href="./src/resources/projects/snippets.ts">createRequest</a>(projectName, { ...params }) -> SnippetCreateRequestResponse</code>
+
 # Builds
 
 Types:
@@ -56,3 +68,15 @@ Types:
 Methods:
 
 - <code title="get /v0/build_target_outputs">client.buildTargetOutputs.<a href="./src/resources/build-target-outputs.ts">retrieve</a>({ ...params }) -> BuildTargetOutputRetrieveResponse</code>
+
+# Orgs
+
+Types:
+
+- <code><a href="./src/resources/orgs.ts">OrgRetrieveResponse</a></code>
+- <code><a href="./src/resources/orgs.ts">OrgListResponse</a></code>
+
+Methods:
+
+- <code title="get /v0/orgs/{orgName}">client.orgs.<a href="./src/resources/orgs.ts">retrieve</a>(orgName) -> OrgRetrieveResponse</code>
+- <code title="get /v0/orgs">client.orgs.<a href="./src/resources/orgs.ts">list</a>() -> OrgListResponse</code>

src/client.ts

@@ -34,10 +34,13 @@ import {
   BuildTarget,
   Builds,
 } from './resources/builds';
+import { OrgListResponse, OrgRetrieveResponse, Orgs } from './resources/orgs';
 import { readEnv } from './internal/utils/env';
 import { formatRequestDetails, loggerFor } from './internal/utils/log';
 import { isEmptyObj } from './internal/utils/values';
 import {
+  ProjectListParams,
+  ProjectListResponse,
   ProjectRetrieveResponse,
   ProjectUpdateParams,
   ProjectUpdateResponse,
@@ -46,7 +49,7 @@ import {
 
 export interface ClientOptions {
   /**
-   * Defaults to process.env['STAINLESS_API_KEY'].
+   * Defaults to process.env['STAINLESS_V0_API_KEY'].
    */
   apiKey?: string | null | undefined;
 
@@ -138,7 +141,7 @@ export class StainlessV0 {
   /**
    * API Client for interfacing with the Stainless V0 API.
    *
-   * @param {string | null | undefined} [opts.apiKey=process.env['STAINLESS_API_KEY'] ?? null]
+   * @param {string | null | undefined} [opts.apiKey=process.env['STAINLESS_V0_API_KEY'] ?? null]
    * @param {string} [opts.baseURL=process.env['STAINLESS_V0_BASE_URL'] ?? https://api.stainless.com] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
@@ -149,7 +152,7 @@ export class StainlessV0 {
    */
   constructor({
     baseURL = readEnv('STAINLESS_V0_BASE_URL'),
-    apiKey = readEnv('STAINLESS_API_KEY') ?? null,
+    apiKey = readEnv('STAINLESS_V0_API_KEY') ?? null,
     ...opts
   }: ClientOptions = {}) {
     const options: ClientOptions = {
@@ -686,18 +689,22 @@ export class StainlessV0 {
   projects: API.Projects = new API.Projects(this);
   builds: API.Builds = new API.Builds(this);
   buildTargetOutputs: API.BuildTargetOutputs = new API.BuildTargetOutputs(this);
+  orgs: API.Orgs = new API.Orgs(this);
 }
 StainlessV0.Projects = Projects;
 StainlessV0.Builds = Builds;
 StainlessV0.BuildTargetOutputs = BuildTargetOutputs;
+StainlessV0.Orgs = Orgs;
 export declare namespace StainlessV0 {
   export type RequestOptions = Opts.RequestOptions;
 
   export {
     Projects as Projects,
     type ProjectRetrieveResponse as ProjectRetrieveResponse,
     type ProjectUpdateResponse as ProjectUpdateResponse,
+    type ProjectListResponse as ProjectListResponse,
     type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
   };
 
   export {
@@ -714,4 +721,10 @@ export declare namespace StainlessV0 {
     type BuildTargetOutputRetrieveResponse as BuildTargetOutputRetrieveResponse,
     type BuildTargetOutputRetrieveParams as BuildTargetOutputRetrieveParams,
   };
+
+  export {
+    Orgs as Orgs,
+    type OrgRetrieveResponse as OrgRetrieveResponse,
+    type OrgListResponse as OrgListResponse,
+  };
 }

src/resources/builds.ts

@@ -36,6 +36,10 @@ export interface BuildObject {
 
   object: 'build';
 
+  org: string;
+
+  project: string;
+
   targets: BuildObject.Targets;
 }
 
@@ -300,7 +304,7 @@ export interface BuildListParams {
   cursor?: string;
 
   /**
-   * Maximum number of builds to return, defaults to 10
+   * Maximum number of builds to return, defaults to 10 (maximum: 100)
    */
   limit?: number;
 

src/resources/index.ts

@@ -13,9 +13,12 @@ export {
   type BuildCreateParams,
   type BuildListParams,
 } from './builds';
+export { Orgs, type OrgRetrieveResponse, type OrgListResponse } from './orgs';
 export {
   Projects,
   type ProjectRetrieveResponse,
   type ProjectUpdateResponse,
+  type ProjectListResponse,
   type ProjectUpdateParams,
+  type ProjectListParams,
 } from './projects/projects';

src/resources/orgs.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Orgs extends APIResource {
+  /**
+   * TODO
+   */
+  retrieve(orgName: string, options?: RequestOptions): APIPromise<OrgRetrieveResponse> {
+    return this._client.get(path`/v0/orgs/${orgName}`, options);
+  }
+
+  /**
+   * TODO
+   */
+  list(options?: RequestOptions): APIPromise<OrgListResponse> {
+    return this._client.get('/v0/orgs', options);
+  }
+}
+
+export interface OrgRetrieveResponse {
+  display_name: string | null;
+
+  object: 'org';
+
+  slug: string;
+}
+
+export interface OrgListResponse {
+  data: Array<OrgListResponse.Data>;
+
+  has_more: boolean;
+
+  next_cursor?: string;
+}
+
+export namespace OrgListResponse {
+  export interface Data {
+    display_name: string | null;
+
+    object: 'org';
+
+    slug: string;
+  }
+}
+
+export declare namespace Orgs {
+  export { type OrgRetrieveResponse as OrgRetrieveResponse, type OrgListResponse as OrgListResponse };
+}

src/resources/projects/index.ts

@@ -12,5 +12,8 @@ export {
   Projects,
   type ProjectRetrieveResponse,
   type ProjectUpdateResponse,
+  type ProjectListResponse,
   type ProjectUpdateParams,
+  type ProjectListParams,
 } from './projects';
+export { Snippets, type SnippetCreateRequestResponse, type SnippetCreateRequestParams } from './snippets';

src/resources/projects/projects.ts

@@ -11,13 +11,16 @@ import {
   ConfigRetrieveResponse,
   Configs,
 } from './configs';
+import * as SnippetsAPI from './snippets';
+import { SnippetCreateRequestParams, SnippetCreateRequestResponse, Snippets } from './snippets';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Projects extends APIResource {
   branches: BranchesAPI.Branches = new BranchesAPI.Branches(this._client);
   configs: ConfigsAPI.Configs = new ConfigsAPI.Configs(this._client);
+  snippets: SnippetsAPI.Snippets = new SnippetsAPI.Snippets(this._client);
 
   /**
    * TODO
@@ -36,6 +39,13 @@ export class Projects extends APIResource {
   ): APIPromise<ProjectUpdateResponse> {
     return this._client.patch(path`/v0/projects/${projectName}`, { body, ...options });
   }
+
+  /**
+   * TODO
+   */
+  list(query: ProjectListParams, options?: RequestOptions): APIPromise<ProjectListResponse> {
+    return this._client.get('/v0/projects', { query, ...options });
+  }
 }
 
 export interface ProjectRetrieveResponse {
@@ -62,18 +72,57 @@ export interface ProjectUpdateResponse {
   slug: string;
 }
 
+export interface ProjectListResponse {
+  data: Array<ProjectListResponse.Data>;
+
+  has_more: boolean;
+
+  next_cursor?: string;
+}
+
+export namespace ProjectListResponse {
+  export interface Data {
+    config_repo: string;
+
+    display_name: string | null;
+
+    object: 'project';
+
+    org: string;
+
+    slug: string;
+  }
+}
+
 export interface ProjectUpdateParams {
   display_name?: string | null;
 }
 
+export interface ProjectListParams {
+  org: string;
+
+  /**
+   * Pagination cursor from a previous response
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of projects to return, defaults to 10 (maximum: 100)
+   */
+  limit?: number;
+}
+
 Projects.Branches = Branches;
 Projects.Configs = Configs;
+Projects.Snippets = Snippets;
 
 export declare namespace Projects {
   export {
     type ProjectRetrieveResponse as ProjectRetrieveResponse,
     type ProjectUpdateResponse as ProjectUpdateResponse,
+    type ProjectListResponse as ProjectListResponse,
     type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
   };
 
   export {
@@ -90,4 +139,10 @@ export declare namespace Projects {
     type ConfigRetrieveParams as ConfigRetrieveParams,
     type ConfigGuessParams as ConfigGuessParams,
   };
+
+  export {
+    Snippets as Snippets,
+    type SnippetCreateRequestResponse as SnippetCreateRequestResponse,
+    type SnippetCreateRequestParams as SnippetCreateRequestParams,
+  };
 }