release: 0.1.0-alpha.10

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.9"
+  ".": "0.1.0-alpha.10"
 }

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.10 (2025-07-02)
+
+Full Changelog: [v0.1.0-alpha.9...v0.1.0-alpha.10](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.9...v0.1.0-alpha.10)
+
+### Features
+
+* add unwrapFile ([#2](https://github.com/stainless-api/stainless-api-typescript/issues/2)) ([75f71a2](https://github.com/stainless-api/stainless-api-typescript/commit/75f71a2486ef8db3c6c3c2684bf4edaba6fc758b))
+
 ## 0.1.0-alpha.9 (2025-07-02)
 
 Full Changelog: [v0.1.0-alpha.8...v0.1.0-alpha.9](https://github.com/stainless-api/stainless-api-typescript/compare/v0.1.0-alpha.8...v0.1.0-alpha.9)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/sdk",
-  "version": "0.1.0-alpha.9",
+  "version": "0.1.0-alpha.10",
   "description": "The official TypeScript library for the Stainless API",
   "author": "Stainless <>",
   "types": "dist/index.d.ts",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/mcp",
-  "version": "0.1.0-alpha.9",
+  "version": "0.1.0-alpha.10",
   "description": "The official MCP Server for the Stainless API",
   "author": "Stainless <>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -26,7 +26,7 @@ export { endpoints } from './tools';
 export const server = new McpServer(
   {
     name: 'stainless_api_sdk_api',
-    version: '0.1.0-alpha.9',
+    version: '0.1.0-alpha.10',
   },
   {
     capabilities: {

src/client.ts

@@ -55,6 +55,7 @@ import {
   parseLogLevel,
 } from './internal/utils/log';
 import { isEmptyObj } from './internal/utils/values';
+import { unwrapFile } from './lib/unwrap';
 
 const environments = {
   production: 'https://api.stainless.com',
@@ -775,6 +776,7 @@ export class Stainless {
   static UnprocessableEntityError = Errors.UnprocessableEntityError;
 
   static toFile = Uploads.toFile;
+  static unwrapFile = unwrapFile;
 
   projects: API.Projects = new API.Projects(this);
   builds: API.Builds = new API.Builds(this);

src/lib/unwrap.ts

@@ -0,0 +1,25 @@
+/**
+ * Unwrap a file value from a union type, like the build object's `documented_spec`.
+ *
+ * @example
+ *   const build = await client.builds.retrieve(buildID);
+ *   const spec = await Stainless.unwrapFile(build.documented_spec);
+ */
+export async function unwrapFile(
+  value: { type: 'content'; content: string } | { type: 'url'; url: string },
+): Promise<string>;
+export async function unwrapFile(
+  value: { type: 'content'; content: string } | { type: 'url'; url: string } | null,
+): Promise<string | null>;
+export async function unwrapFile(
+  value: { type: 'content'; content: string } | { type: 'url'; url: string } | null,
+): Promise<string | null> {
+  if (value === null) {
+    return null;
+  }
+  if (value.type === 'content') {
+    return value.content;
+  }
+  const response = await fetch(value.url);
+  return response.text();
+}

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.9'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.10'; // x-release-please-version