release: 4.2.0 (#2401)

Author: stainless-app[bot]

.devcontainer/Dockerfile

@@ -1,20 +1,17 @@
 // For format details, see https://aka.ms/devcontainer.json. For config options, see the
 // README at: https://github.com/devcontainers/templates/tree/main/src/debian
 {
-  "name": "Debian",
-  "build": {
-    "dockerfile": "Dockerfile"
+  "name": "Development",
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:latest",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {}
+  },
+  "postCreateCommand": "yarn install",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "esbenp.prettier-vscode"
+      ]
+    }
   }
-
-  // Features to add to the dev container. More info: https://containers.dev/features.
-  // "features": {},
-
-  // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  // "forwardPorts": [],
-
-  // Configure tool-specific properties.
-  // "customizations": {},
-
-  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-  // "remoteUser": "root"
 }

.devcontainer/devcontainer.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.1.0"
+  ".": "4.2.0"
 }

.release-please-manifest.json

@@ -1,2 +1,2 @@
-configured_endpoints: 1525
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-4c85e60ad7ca96a7ddadf88e1e3c7b62fb791d39d435bedfe6caac2c27081a48.yml
+configured_endpoints: 1655
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-0ed9f898b31619623e50d660d04beca50e44987bfd3eb3a6ff98d3bca2a9c569.yml

.stats.yml

@@ -65,6 +65,56 @@ main();
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
 
+## File uploads
+
+Request parameters that correspond to file uploads can be passed in many different forms:
+
+- `File` (or an object with the same structure)
+- a `fetch` `Response` (or an object with the same structure)
+- an `fs.ReadStream`
+- the return value of our `toFile` helper
+
+```ts
+import fs from 'fs';
+import fetch from 'node-fetch';
+import Cloudflare, { toFile } from 'cloudflare';
+
+const client = new Cloudflare();
+
+// If you have access to Node `fs` we recommend using `fs.createReadStream()`:
+await client.apiGateway.userSchemas.create({
+  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+  file: fs.createReadStream('/path/to/file'),
+  kind: 'openapi_v3',
+});
+
+// Or if you have the web `File` API you can pass a `File` instance:
+await client.apiGateway.userSchemas.create({
+  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+  file: new File(['my bytes'], 'file'),
+  kind: 'openapi_v3',
+});
+
+// You can also pass a `fetch` `Response`:
+await client.apiGateway.userSchemas.create({
+  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+  file: await fetch('https://somesite/file'),
+  kind: 'openapi_v3',
+});
+
+// Finally, if none of the above are convenient, you can use our `toFile` helper:
+await client.apiGateway.userSchemas.create({
+  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+  file: await toFile(Buffer.from('my bytes'), 'file'),
+  kind: 'openapi_v3',
+});
+await client.apiGateway.userSchemas.create({
+  zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
+  kind: 'openapi_v3',
+});
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API,

CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "The official TypeScript library for the Cloudflare API",
   "author": "Cloudflare <[email protected]>",
   "types": "dist/index.d.ts",
@@ -107,17 +107,17 @@
       "default": "./dist/index.mjs"
     },
     "./*.mjs": {
-      "types": "./dist/*.d.ts",
-      "default": "./dist/*.mjs"
+      "types": ["./dist/*.d.ts", "./dist/*/index.d.ts"],
+      "default": ["./dist/*.mjs", "./dist/*/index.mjs"]
     },
     "./*.js": {
-      "types": "./dist/*.d.ts",
-      "default": "./dist/*.js"
+      "types": ["./dist/*.d.ts", "./dist/*/index.d.ts"],
+      "default": ["./dist/*.js", "./dist/*/index.js"]
     },
     "./*": {
-      "types": "./dist/*.d.ts",
-      "require": "./dist/*.js",
-      "default": "./dist/*.mjs"
+      "types": ["./dist/*.d.ts", "./dist/*/index.d.ts"],
+      "require": ["./dist/*.js", "./dist/*/index.js"],
+      "default": ["./dist/*.mjs", "./dist/*/index.mjs"]
     }
   }
 }

README.md

@@ -4,7 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ]; then
+if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ]; then
   brew bundle check >/dev/null 2>&1 || {
     echo "==> Installing Homebrew dependencies…"
     brew bundle

api.md

@@ -48,8 +48,8 @@ async function defaultParseResponse<T>(props: APIResponseProps): Promise<T> {
   }
 
   const contentType = response.headers.get('content-type');
-  const isJSON =
-    contentType?.includes('application/json') || contentType?.includes('application/vnd.api+json');
+  const mediaType = contentType?.split(';')[0]?.trim();
+  const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
   if (isJSON) {
     const json = await response.json();