release: 0.1.0-alpha.24

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.23"
+  ".": "0.1.0-alpha.24"
 }

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.0-alpha.24 (2026-02-03)
+
+Full Changelog: [v0.1.0-alpha.23...v0.1.0-alpha.24](https://github.com/Scan-Documents/node-sdk/compare/v0.1.0-alpha.23...v0.1.0-alpha.24)
+
+### Chores
+
+* **client:** do not parse responses with empty content-length ([1389823](https://github.com/Scan-Documents/node-sdk/commit/13898230806689632adc8f9fa1d6e825fbade837))
+* **internal:** support oauth authorization code flow for MCP servers ([ce96b0c](https://github.com/Scan-Documents/node-sdk/commit/ce96b0c6cdee3c08414ccbe9d7eda138802e1e49))
+
 ## 0.1.0-alpha.23 (2026-02-03)
 
 Full Changelog: [v0.1.0-alpha.22...v0.1.0-alpha.23](https://github.com/Scan-Documents/node-sdk/compare/v0.1.0-alpha.22...v0.1.0-alpha.23)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "scan-documents",
-  "version": "0.1.0-alpha.23",
+  "version": "0.1.0-alpha.24",
   "description": "The official TypeScript library for the Scan Documents API",
   "author": "Scan Documents <support@scan-documents.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scan-documents-mcp",
-  "version": "0.1.0-alpha.23",
+  "version": "0.1.0-alpha.24",
   "description": "The official MCP Server for the Scan Documents API",
   "author": "Scan Documents <support@scan-documents.com>",
   "types": "dist/index.d.ts",
@@ -34,10 +34,12 @@
     "@cloudflare/cabidela": "^0.2.4",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@valtown/deno-http-worker": "^0.0.21",
+    "cookie-parser": "^1.4.6",
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "fuse.js": "^7.1.0",
     "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
+    "morgan": "^1.10.0",
     "qs": "^6.14.1",
     "typescript": "5.8.3",
     "yargs": "^17.7.2",
@@ -50,9 +52,11 @@
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",
+    "@types/cookie-parser": "^1.4.10",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
     "@types/jest": "^29.4.0",
+    "@types/morgan": "^1.9.10",
     "@types/qs": "^6.14.0",
     "@types/yargs": "^17.0.8",
     "@typescript-eslint/eslint-plugin": "8.31.1",

packages/mcp-server/src/headers.ts

@@ -3,7 +3,7 @@
 import { IncomingMessage } from 'node:http';
 import { ClientOptions } from 'scan-documents';
 
-export const parseAuthHeaders = (req: IncomingMessage): Partial<ClientOptions> => {
+export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
   const apiKey =
     Array.isArray(req.headers['x-api-key']) ? req.headers['x-api-key'][0] : req.headers['x-api-key'];
   return { apiKey };

packages/mcp-server/src/http.ts

@@ -2,8 +2,8 @@
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-
 import express from 'express';
+import morgan from 'morgan';
 import { McpOptions } from './options';
 import { ClientOptions, initMcpServer, newMcpServer } from './server';
 import { parseAuthHeaders } from './headers';
@@ -20,7 +20,7 @@ const newServer = ({
   const server = newMcpServer();
 
   try {
-    const authOptions = parseAuthHeaders(req);
+    const authOptions = parseAuthHeaders(req, false);
     initMcpServer({
       server: server,
       clientOptions: {
@@ -75,14 +75,15 @@ const del = async (req: express.Request, res: express.Response) => {
 
 export const streamableHTTPApp = ({
   clientOptions = {},
-  mcpOptions = {},
+  mcpOptions,
 }: {
   clientOptions?: ClientOptions;
-  mcpOptions?: McpOptions;
+  mcpOptions: McpOptions;
 }): express.Express => {
   const app = express();
   app.set('query parser', 'extended');
   app.use(express.json());
+  app.use(morgan('combined'));
 
   app.get('/', get);
   app.post('/', post({ clientOptions, mcpOptions }));

packages/mcp-server/src/options.ts

@@ -35,6 +35,7 @@ export function parseCLIOptions(): CLIOptions {
     })
     .option('port', {
       type: 'number',
+      default: 3000,
       description: 'Port to serve on if using http transport',
     })
     .option('socket', {

packages/mcp-server/src/server.ts

@@ -21,7 +21,7 @@ export const newMcpServer = () =>
   new McpServer(
     {
       name: 'scan_documents_api',
-      version: '0.1.0-alpha.23',
+      version: '0.1.0-alpha.24',
     },
     { capabilities: { tools: {}, logging: {} } },
   );

src/internal/parse.ts

@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: ScanDocuments, props: APIR
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

src/version.ts

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