Merge pull request #60 from reductoai/release-please--branches--main--changes--next--components--reductoai

release: 0.14.0

Author: kirthi20

.github/workflows/ci.yml

@@ -1,12 +1,14 @@
 name: CI
 on:
   push:
-    branches-ignore:
-      - 'generated'
-      - 'codegen/**'
-      - 'integrated/**'
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+    branches:
+      - '**'
+      - '!integrated/**'
+      - '!stl-preview-head/**'
+      - '!stl-preview-base/**'
+      - '!generated'
+      - '!codegen/**'
+      - 'codegen/stl/**'
   pull_request:
     branches-ignore:
       - 'stl-preview-head/**'
@@ -19,7 +21,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/reductoai-node' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -41,7 +43,7 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -55,14 +57,18 @@ jobs:
         run: ./scripts/build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/reductoai-node'
+        if: |-
+          github.repository == 'stainless-sdks/reductoai-node' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v6
+        uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
       - name: Upload tarball
-        if: github.repository == 'stainless-sdks/reductoai-node'
+        if: |-
+          github.repository == 'stainless-sdks/reductoai-node' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
@@ -74,7 +80,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/reductoai-node' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4

.github/workflows/publish-npm.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v3

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'reductoai/reducto-node-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Check release environment
         run: |

.gitignore

@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 node_modules
 yarn-error.log
 codegen.log

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.13.0"
+  ".": "0.14.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 16
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/reducto%2Freductoai-af6e6c678515bd54067a0bbe911a064a8bf6e14ecdb26ecc915f5c0bb2bab579.yml
-openapi_spec_hash: b7f1b74e7f52a511d90eb8fecb4e0987
-config_hash: 12c16025a3b7554fa6377191d68b1903
+configured_endpoints: 17
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/reducto%2Freductoai-a7d4d4927e87215a1579a2e32662922b0a58150641c0009dad505fc48fcf301b.yml
+openapi_spec_hash: b11bdb290665a5ac0778f2cbbaaffea4
+config_hash: db384d1185f4b249044f9ad6a988384f

CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## 0.14.0 (2026-03-24)
+
+Full Changelog: [v0.13.0...v0.14.0](https://github.com/reductoai/reducto-node-sdk/compare/v0.13.0...v0.14.0)
+
+### Features
+
+* **api:** api update ([30c30e1](https://github.com/reductoai/reducto-node-sdk/commit/30c30e1f01b7b4c61dbfa1b5be2131f6bf8b393e))
+* **api:** api update ([d11ad60](https://github.com/reductoai/reducto-node-sdk/commit/d11ad6012aba58e5a6742e214bdf9c2330aa838a))
+* **api:** api update ([9c1a856](https://github.com/reductoai/reducto-node-sdk/commit/9c1a85657c3d6d94eac9cf7f938771e4ff3aeef8))
+* **api:** api update ([380fa3b](https://github.com/reductoai/reducto-node-sdk/commit/380fa3b5cd05dbad8a001bdcab6ab61bfc4f0cc7))
+* **api:** api update ([7809f77](https://github.com/reductoai/reducto-node-sdk/commit/7809f7722c1c2c553ad3337229b9388977254e4e))
+* **api:** api update ([1f987fb](https://github.com/reductoai/reducto-node-sdk/commit/1f987fb226f1e4c2d6dc2f7a93ccdd3f79b17165))
+* **api:** api update ([ee1424c](https://github.com/reductoai/reducto-node-sdk/commit/ee1424c6ce3726ac2e0a8b14799b23bdd7cf5b80))
+* **api:** api update ([f2e686f](https://github.com/reductoai/reducto-node-sdk/commit/f2e686fbdd7e79a93975813553f00c3d6a3f27da))
+* **api:** api update ([4835bff](https://github.com/reductoai/reducto-node-sdk/commit/4835bffb9fb214136f5e943351d16c2077e16d2f))
+* **api:** api update ([fe7b7b2](https://github.com/reductoai/reducto-node-sdk/commit/fe7b7b2bdede6e7d91e298ac57f16f64582012a5))
+* **api:** api update ([1f64e17](https://github.com/reductoai/reducto-node-sdk/commit/1f64e171a54adf2bb387601da2b7c2db4a1fd6ae))
+* **api:** api update ([0b036c8](https://github.com/reductoai/reducto-node-sdk/commit/0b036c88555b3699b280979e2784e68c99d480a3))
+* **api:** api update ([37d1e9b](https://github.com/reductoai/reducto-node-sdk/commit/37d1e9b68358ae4ec9f8e9fa43c522b491b65d48))
+* **api:** api update ([3fff9d0](https://github.com/reductoai/reducto-node-sdk/commit/3fff9d03440d49dd7dc42293bdccdcd96bea5c26))
+* **api:** api update ([4234099](https://github.com/reductoai/reducto-node-sdk/commit/42340999ca0976567bff5f8297af3438640ea481))
+* **api:** api update ([375f898](https://github.com/reductoai/reducto-node-sdk/commit/375f89847c91462034a3a358a67f6368f4043e95))
+* **api:** api update ([6f83d8b](https://github.com/reductoai/reducto-node-sdk/commit/6f83d8b5c62ebf40488fae811ad2efca06f45c7c))
+* **api:** api update ([3885830](https://github.com/reductoai/reducto-node-sdk/commit/3885830b959fefe73a7b26dc3a2ecff719b4a9f2))
+* **api:** api update ([95c7a86](https://github.com/reductoai/reducto-node-sdk/commit/95c7a86249bf78b6164d648e34c161213ef098dd))
+* **api:** api update ([1a746fc](https://github.com/reductoai/reducto-node-sdk/commit/1a746fc043c060a266bf87cd575945cb8077290f))
+* **api:** api update ([6398260](https://github.com/reductoai/reducto-node-sdk/commit/6398260030d99c5707906aa51e0574580001468c))
+* **api:** api update ([3104233](https://github.com/reductoai/reducto-node-sdk/commit/31042333c8bdb44df5be843d72a6ce73114ddbec))
+* **api:** api update ([31a32f1](https://github.com/reductoai/reducto-node-sdk/commit/31a32f15eed8d855d3f17794a6ba0a01a8c7bc37))
+* **api:** api update ([869f688](https://github.com/reductoai/reducto-node-sdk/commit/869f688baf43a76936766a10e2e39fb2d92730c5))
+* **api:** api update ([1bc5ebb](https://github.com/reductoai/reducto-node-sdk/commit/1bc5ebb13d723d2f2dd08b22cf9de56c2f1f581e))
+* **api:** api update ([de2dad4](https://github.com/reductoai/reducto-node-sdk/commit/de2dad4e85c0e2846737a1b282aea23529c33bc5))
+* **api:** api update ([21a0bc0](https://github.com/reductoai/reducto-node-sdk/commit/21a0bc0317272966c09e56229dc1b43c63b74e23))
+* **api:** api update ([816ec6b](https://github.com/reductoai/reducto-node-sdk/commit/816ec6b489eed42d237f92431e3546145f7efa2f))
+* **api:** manual updates ([fd3f6e2](https://github.com/reductoai/reducto-node-sdk/commit/fd3f6e2467d1900ea41884a633521b2453781e2e))
+* **api:** manual updates ([7ed517c](https://github.com/reductoai/reducto-node-sdk/commit/7ed517cc2583869fc0964e19d0752da82703a6f4))
+* **api:** manual updates ([eb92503](https://github.com/reductoai/reducto-node-sdk/commit/eb92503eabed860922088a06479431f285b9511f))
+* **api:** manual updates ([12a3fa2](https://github.com/reductoai/reducto-node-sdk/commit/12a3fa257c3011beb28467c1ba8371f6c8fc2f22))
+* **files:** add support for string alternative to file upload type ([6ab83a7](https://github.com/reductoai/reducto-node-sdk/commit/6ab83a76b2c240a44721ab2018c3af8cf94d7512))
+
+
+### Bug Fixes
+
+* **client:** preserve URL params already embedded in path ([59c9805](https://github.com/reductoai/reducto-node-sdk/commit/59c9805592e28602db91d80e1681e080bb861511))
+* **docs/contributing:** correct pnpm link command ([cff59cc](https://github.com/reductoai/reducto-node-sdk/commit/cff59cca0aab03a23198288cd1ea11b0cc95f2ce))
+* **mcp:** correct code tool API endpoint ([2c26c48](https://github.com/reductoai/reducto-node-sdk/commit/2c26c48cc5540089e4ca1717296638b4552784eb))
+* **mcp:** return correct lines on typescript errors ([497e0ee](https://github.com/reductoai/reducto-node-sdk/commit/497e0ee1cb2d898b7fbee174363573393995148d))
+
+
+### Chores
+
+* break long lines in snippets into multiline ([9d52de4](https://github.com/reductoai/reducto-node-sdk/commit/9d52de4d7faa0b0a61a3ed55a0416270f26d2d51))
+* **ci:** skip uploading artifacts on stainless-internal branches ([3b9dcfc](https://github.com/reductoai/reducto-node-sdk/commit/3b9dcfcde4abfd3212ca1d06dfb63d1c26717c26))
+* **ci:** upgrade `actions/github-script` ([ce9af3a](https://github.com/reductoai/reducto-node-sdk/commit/ce9af3a38224880fa4475a831e129c7420e3d85a))
+* **client:** do not parse responses with empty content-length ([7d0ca9a](https://github.com/reductoai/reducto-node-sdk/commit/7d0ca9acdfea271373512a7c5b2b6868220e627f))
+* fix typo in descriptions ([9c4fa8a](https://github.com/reductoai/reducto-node-sdk/commit/9c4fa8a091e22f01e029b1e898b1ea0b7df8d110))
+* **internal:** codegen related update ([75d075b](https://github.com/reductoai/reducto-node-sdk/commit/75d075b2b4fc068ce0c7d13ffb5aadbc35163ea0))
+* **internal:** codegen related update ([12de323](https://github.com/reductoai/reducto-node-sdk/commit/12de3239143efba43a97f884ab454a6f9bf2fdfd))
+* **internal:** codegen related update ([ba4aea5](https://github.com/reductoai/reducto-node-sdk/commit/ba4aea56bea1bc533d8c9dfa72fead39e214817c))
+* **internal:** move stringifyQuery implementation to internal function ([77fbeb6](https://github.com/reductoai/reducto-node-sdk/commit/77fbeb61508bc627e19d5cf52ce87d803041135b))
+* **internal:** remove mock server code ([c2d42e0](https://github.com/reductoai/reducto-node-sdk/commit/c2d42e0f5e7e41318f9fb1199e6530b2bc3b8765))
+* **internal:** tweak CI branches ([40eb8b0](https://github.com/reductoai/reducto-node-sdk/commit/40eb8b09d0a7712d602df15702b53c5e8ba514ce))
+* **internal:** update `actions/checkout` version ([ca6f81a](https://github.com/reductoai/reducto-node-sdk/commit/ca6f81aebf40afce8fdd8ec6fe35d32b90c48eef))
+* **internal:** update gitignore ([e62d6d4](https://github.com/reductoai/reducto-node-sdk/commit/e62d6d4cd49c300976983b5a1710ccb2907673c0))
+* **internal:** upgrade babel, qs, js-yaml ([93ee721](https://github.com/reductoai/reducto-node-sdk/commit/93ee721b989715136efdb83704739985a87947db))
+* update mock server docs ([3036bda](https://github.com/reductoai/reducto-node-sdk/commit/3036bda24c93ab49d3b76e45bd895815b923b27e))
+
 ## 0.13.0 (2025-12-02)
 
 Full Changelog: [v0.12.0...v0.13.0](https://github.com/reductoai/reducto-node-sdk/compare/v0.12.0...v0.13.0)

CONTRIBUTING.md

@@ -60,17 +60,11 @@ $ yarn link reductoai
 # With pnpm
 $ pnpm link --global
 $ cd ../my-package
-$ pnpm link -—global reductoai
+$ pnpm link --global reductoai
 ```
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```sh
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```sh
 $ yarn run test
 ```

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Reducto
+   Copyright 2026 Reducto
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -27,7 +27,7 @@ const client = new Reducto({
   environment: 'eu', // or 'production' | 'au'; defaults to 'production'
 });
 
-const response = await client.parse.run({ input: 'https://pdfobject.com/pdf/sample.pdf' });
+const parse = await client.parse.create({ input: 'https://pdfobject.com/pdf/sample.pdf' });
 ```
 
 ### Request & Response types
@@ -43,42 +43,12 @@ const client = new Reducto({
   environment: 'eu', // or 'production' | 'au'; defaults to 'production'
 });
 
-const params: Reducto.ParseRunParams = { input: 'https://pdfobject.com/pdf/sample.pdf' };
-const response: Reducto.ParseRunResponse = await client.parse.run(params);
+const params: Reducto.ParseCreateParams = { input: 'https://pdfobject.com/pdf/sample.pdf' };
+const parse: Reducto.ParseCreateResponse = await client.parse.create(params);
 ```
 
 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 Reducto, { toFile } from 'reductoai';
-
-const client = new Reducto();
-
-// If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.upload({ file: fs.createReadStream('/path/to/file') });
-
-// Or if you have the web `File` API you can pass a `File` instance:
-await client.upload({ file: new File(['my bytes'], 'file') });
-
-// You can also pass a `fetch` `Response`:
-await client.upload({ file: await fetch('https://somesite/file') });
-
-// Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.upload({ file: await toFile(Buffer.from('my bytes'), 'file') });
-await client.upload({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
-```
-
 ## Handling errors
 
 When the library is unable to connect to the API,
@@ -87,8 +57,8 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const response = await client.parse
-  .run({ input: 'https://pdfobject.com/pdf/sample.pdf' })
+const parse = await client.parse
+  .create({ input: 'https://pdfobject.com/pdf/sample.pdf' })
   .catch(async (err) => {
     if (err instanceof Reducto.APIError) {
       console.log(err.status); // 400
@@ -129,7 +99,7 @@ const client = new Reducto({
 });
 
 // Or, configure per-request:
-await client.parse.run({ input: 'https://pdfobject.com/pdf/sample.pdf' }, {
+await client.parse.create({ input: 'https://pdfobject.com/pdf/sample.pdf' }, {
   maxRetries: 5,
 });
 ```
@@ -146,7 +116,7 @@ const client = new Reducto({
 });
 
 // Override per-request:
-await client.parse.run({ input: 'https://pdfobject.com/pdf/sample.pdf' }, {
+await client.parse.create({ input: 'https://pdfobject.com/pdf/sample.pdf' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -167,15 +137,17 @@ You can also use the `.withResponse()` method to get the raw `Response` along wi
 ```ts
 const client = new Reducto();
 
-const response = await client.parse.run({ input: 'https://pdfobject.com/pdf/sample.pdf' }).asResponse();
+const response = await client.parse
+  .create({ input: 'https://pdfobject.com/pdf/sample.pdf' })
+  .asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: response, response: raw } = await client.parse
-  .run({ input: 'https://pdfobject.com/pdf/sample.pdf' })
+const { data: parse, response: raw } = await client.parse
+  .create({ input: 'https://pdfobject.com/pdf/sample.pdf' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(response);
+console.log(parse);
 ```
 
 ### Making custom/undocumented requests
@@ -279,7 +251,7 @@ const client = new Reducto({
 });
 
 // Override per-request:
-await client.parse.run(
+await client.parse.create(
   { input: 'https://pdfobject.com/pdf/sample.pdf' },
   {
     httpAgent: new http.Agent({ keepAlive: false }),