feat(api): add v0 project create api

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 15
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-332dd93ce7473cdf7114d71d7dcaf7a4acc1491717c5cd55fbf984475d92bad7.yml
-openapi_spec_hash: 15cea3398093ddc80c926606aa31d41a
-config_hash: 4cc7a55bc88549c1b7d1e960fa207961
+configured_endpoints: 16
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/stainless%2Fstainless-v0-4211d663fa2256cb1448cda8e8143dae51ab4c387a2a52fd8de6d588a69dcfc8.yml
+openapi_spec_hash: 73a5f552ba3b047363947cdbda0fd60b
+config_hash: b9e5923fc9792ef81d39a59cb6e2812e

README.md

@@ -30,9 +30,13 @@ const client = new Stainless({
   apiKey: process.env['STAINLESS_V0_API_KEY'], // This is the default and can be omitted
 });
 
-const buildObject = await client.builds.create({ revision: 'string' });
+async function main() {
+  const buildObject = await client.builds.create({ revision: 'string' });
 
-console.log(buildObject.id);
+  console.log(buildObject.id);
+}
+
+main();
 ```
 
 ### Request & Response types
@@ -48,8 +52,12 @@ const client = new Stainless({
   apiKey: process.env['STAINLESS_V0_API_KEY'], // This is the default and can be omitted
 });
 
-const params: Stainless.BuildCreateParams = { revision: 'string' };
-const buildObject: Stainless.BuildObject = await client.builds.create(params);
+async function main() {
+  const params: Stainless.BuildCreateParams = { revision: 'string' };
+  const buildObject: Stainless.BuildObject = await client.builds.create(params);
+}
+
+main();
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -62,15 +70,19 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const buildObject = await client.builds.create({ revision: 'string' }).catch(async (err) => {
-  if (err instanceof Stainless.APIError) {
-    console.log(err.status); // 400
-    console.log(err.name); // BadRequestError
-    console.log(err.headers); // {server: 'nginx', ...}
-  } else {
-    throw err;
-  }
-});
+async function main() {
+  const buildObject = await client.builds.create({ revision: 'string' }).catch(async (err) => {
+    if (err instanceof Stainless.APIError) {
+      console.log(err.status); // 400
+      console.log(err.name); // BadRequestError
+      console.log(err.headers); // {server: 'nginx', ...}
+    } else {
+      throw err;
+    }
+  });
+}
+
+main();
 ```
 
 Error codes are as follows:

api.md

@@ -2,12 +2,14 @@
 
 Types:
 
+- <code><a href="./src/resources/projects/projects.ts">ProjectCreateResponse</a></code>
 - <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="post /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">create</a>({ ...params }) -> ProjectCreateResponse</code>
 - <code title="get /v0/projects/{project}">client.projects.<a href="./src/resources/projects/projects.ts">retrieve</a>({ ...params }) -> ProjectRetrieveResponse</code>
 - <code title="patch /v0/projects/{project}">client.projects.<a href="./src/resources/projects/projects.ts">update</a>({ ...params }) -> ProjectUpdateResponse</code>
 - <code title="get /v0/projects">client.projects.<a href="./src/resources/projects/projects.ts">list</a>({ ...params }) -> ProjectListResponse</code>
@@ -80,5 +82,5 @@ Types:
 
 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/{org}">client.orgs.<a href="./src/resources/orgs.ts">retrieve</a>(org) -> OrgRetrieveResponse</code>
 - <code title="get /v0/orgs">client.orgs.<a href="./src/resources/orgs.ts">list</a>() -> OrgListResponse</code>

scripts/build

@@ -37,6 +37,8 @@ npm exec tsc-multi
 # when building .mjs
 node scripts/utils/fix-index-exports.cjs
 cp tsconfig.dist-src.json dist/src/tsconfig.json
+cp src/internal/shim-types.d.ts dist/internal/shim-types.d.ts
+cp src/internal/shim-types.d.ts dist/internal/shim-types.d.mts
 
 node scripts/utils/postprocess-files.cjs
 

src/client.ts

@@ -36,6 +36,8 @@ import {
   Builds,
 } from './resources/builds/builds';
 import {
+  ProjectCreateParams,
+  ProjectCreateResponse,
   ProjectListParams,
   ProjectListResponse,
   ProjectRetrieveParams,
@@ -727,9 +729,11 @@ export declare namespace Stainless {
 
   export {
     Projects as Projects,
+    type ProjectCreateResponse as ProjectCreateResponse,
     type ProjectRetrieveResponse as ProjectRetrieveResponse,
     type ProjectUpdateResponse as ProjectUpdateResponse,
     type ProjectListResponse as ProjectListResponse,
+    type ProjectCreateParams as ProjectCreateParams,
     type ProjectRetrieveParams as ProjectRetrieveParams,
     type ProjectUpdateParams as ProjectUpdateParams,
     type ProjectListParams as ProjectListParams,

src/internal/shim-types.d.ts

@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+/**
+ * Shims for types that we can't always rely on being available globally.
+ *
+ * Note: these only exist at the type-level, there is no corresponding runtime
+ * version for any of these symbols.
+ */
+
+/**
+ * In order to properly access the global `NodeJS` type, if it's available, we
+ * need to make use of declaration shadowing. Without this, any checks for the
+ * presence of `NodeJS.ReadableStream` will fail.
+ */
+declare namespace NodeJS {
+  interface ReadableStream {}
+}
+
+type HasProperties<T> = keyof T extends never ? false : true;
+
+// @ts-ignore
+type _ReadableStream<R = any> =
+  // @ts-ignore
+  HasProperties<NodeJS.ReadableStream> extends true ? NodeJS.ReadableStream<R> : ReadableStream<R>;
+
+// @ts-ignore
+declare const _ReadableStream: unknown extends typeof ReadableStream ? never : typeof ReadableStream;
+export { _ReadableStream as ReadableStream };

src/internal/shim-types.ts

@@ -7,8 +7,8 @@
  * messages in cases where an environment isn't fully supported.
  */
 
-import type { Fetch } from './builtin-types';
-import type { ReadableStream } from './shim-types';
+import { type Fetch } from './builtin-types';
+import { type ReadableStream } from './shim-types';
 
 export function getDefaultFetch(): Fetch {
   if (typeof fetch !== 'undefined') {

src/internal/shims.ts

@@ -138,7 +138,7 @@ export const createForm = async <T = Record<string, unknown>>(
 
 // We check for Blob not File because Bun.File doesn't inherit from File,
 // but they both inherit from Blob and have a `name` property at runtime.
-const isNamedBlob = (value: unknown) => value instanceof Blob && 'name' in value;
+const isNamedBlob = (value: object) => value instanceof Blob && 'name' in value;
 
 const isUploadable = (value: unknown) =>
   typeof value === 'object' &&

src/internal/uploads.ts

@@ -336,7 +336,7 @@ export interface BuildCreateParams {
 export namespace BuildCreateParams {
   export interface unnamed_schema_with_map_parent_0 {
     /**
-     * The file content
+     * File content
      */
     content: string;
   }
@@ -438,7 +438,7 @@ export namespace BuildCompareParams {
   export namespace Base {
     export interface unnamed_schema_with_map_parent_2 {
       /**
-       * The file content
+       * File content
        */
       content: string;
     }
@@ -468,7 +468,7 @@ export namespace BuildCompareParams {
   export namespace Head {
     export interface unnamed_schema_with_map_parent_3 {
       /**
-       * The file content
+       * File content
        */
       content: string;
     }