@fluojs/platform-fastify 1.0.6 → 1.0.8

package/README.ko.md

@@ -149,7 +149,7 @@ fluo의 Fastify 어댑터는 높은 동시성 시나리오에서 raw Node.js 어
 
 ## 공개 API 개요
 
-- `createFastifyAdapter(options)`: Fastify 어댑터를 위한 권장 팩토리입니다.
+- `createFastifyAdapter(options, multipartOptions?)`: Fastify 어댑터를 위한 권장 팩토리입니다. 선택적 두 번째 인자는 직접 어댑터를 생성할 때 `maxFileSize`, `maxFiles`, `maxTotalSize` 같은 multipart 제한을 설정합니다.
 - `bootstrapFastifyApplication(module, options)`: 암시적 리스닝 없이 수행하는 고급 부트스트랩입니다.
 - `runFastifyApplication(module, options)`: 생명주기 관리를 포함한 빠른 시작 헬퍼입니다. timeout/실패 시에는 해당 상태를 로그와 `process.exitCode`로 보고하고, 최종 프로세스 종료는 주변 호스트에 맡깁니다.
 - `isFastifyMultipartTooLargeError(error)`: Fastify error shape 전반에서 multipart limit error를 감지합니다.

package/README.md

@@ -149,7 +149,7 @@ The same file also covers Fastify-specific native route registration with wildca
 
 ## Public API Overview
 
-- `createFastifyAdapter(options)`: Recommended factory for the Fastify adapter.
+- `createFastifyAdapter(options, multipartOptions?)`: Recommended factory for the Fastify adapter. The optional second argument configures multipart limits such as `maxFileSize`, `maxFiles`, and `maxTotalSize` for direct adapter construction.
 - `bootstrapFastifyApplication(module, options)`: advanced bootstrap without implicit listening.
 - `runFastifyApplication(module, options)`: Quick-start helper with lifecycle management. On timeout/failure it reports the condition through logging and `process.exitCode`, while leaving final process termination to the surrounding host.
 - `isFastifyMultipartTooLargeError(error)`: Detects multipart limit errors across Fastify error shapes.

package/dist/adapter.js

@@ -2,10 +2,10 @@ import { Transform } from 'node:stream';
 import multipart from '@fastify/multipart';
 import { createErrorResponse, createServerBackedHttpAdapterRealtimeCapability, HttpException, InternalServerErrorException, PayloadTooLargeException } from '@fluojs/http';
 import { attachFrameworkRequestNativeRouteHandoff, bindRawRequestNativeRouteHandoff, consumeRawRequestNativeRouteHandoff, isRoutePathNormalizationSensitive } from '@fluojs/http/internal';
-import { bootstrapHttpAdapterApplication, createConsoleApplicationLogger, runHttpAdapterApplication } from '@fluojs/runtime/internal/http-adapter';
+import { bootstrapHttpAdapterApplication, runHttpAdapterApplication } from '@fluojs/runtime/internal/http-adapter';
 import { dispatchWithRequestResponseFactory } from '@fluojs/runtime/internal/request-response-factory';
 import { cloneHeaderValue, createDeferredFrameworkRequestShell, createMemoizedAsyncValue, createMemoizedValue, parseQueryParamsFromSearch, snapshotSimpleQueryRecord, splitRawRequestUrl } from '@fluojs/runtime/internal-node';
-import { createNodeShutdownSignalRegistration, defaultNodeShutdownSignals } from '@fluojs/runtime/node';
+import { createConsoleApplicationLogger, createNodeShutdownSignalRegistration, defaultNodeShutdownSignals } from '@fluojs/runtime/node';
 import fastify from 'fastify';
 
 /**
@@ -217,7 +217,7 @@ function createNativeFastFrameworkRequest(request, lazySignal, urlParts, maxBody
     query: readSimpleQueryRecord(request.query),
     queryFactory: () => parseQueryParamsFromSearch(urlParts.search),
     raw: request.raw,
-    requestId: resolvePrimaryRequestIdFromHeaders(request.raw.headers),
+    requestId: resolveRequestIdFromHeaders(request.raw.headers),
     signal: lazySignal.signal,
     url: urlParts.path + urlParts.search
   });
@@ -563,7 +563,7 @@ function createDeferredFrameworkRequest(request, signal, multipartOptions, maxBo
     query: querySnapshot,
     queryFactory: () => parseQueryParamsFromSearch(urlParts.search),
     raw: request.raw,
-    requestId: resolvePrimaryRequestIdFromHeaders(headerSnapshot),
+    requestId: resolveRequestIdFromHeaders(headerSnapshot),
     signal,
     url: urlParts.path + urlParts.search
   });
@@ -746,10 +746,6 @@ function resolveRequestIdFromHeaders(headers) {
   const requestId = headers['x-request-id'] ?? headers['x-correlation-id'];
   return Array.isArray(requestId) ? requestId[0] : requestId;
 }
-function resolvePrimaryRequestIdFromHeaders(headers) {
-  const requestId = headers['x-request-id'];
-  return Array.isArray(requestId) ? requestId[0] : requestId;
-}
 function createFastifyApp(httpsOptions, maxBodySize) {
   if (httpsOptions) {
     return fastify({
@@ -780,8 +776,14 @@ function captureRawBodyPreParsingHook(request, _reply, payload, done) {
   }
   const chunks = [];
   const capture = new Transform({
-    transform(chunk, _encoding, callback) {
-      const bufferChunk = Buffer.isBuffer(chunk) ? chunk : chunk instanceof Uint8Array ? Buffer.from(chunk) : Buffer.from(String(chunk), 'utf8');
+    transform(chunk, encoding, callback) {
+      let bufferChunk;
+      try {
+        bufferChunk = createRawBodyBufferChunk(chunk, encoding);
+      } catch (error) {
+        callback(error instanceof Error ? error : new Error(String(error)));
+        return;
+      }
       chunks.push(bufferChunk);
       capture.receivedEncodedLength += bufferChunk.byteLength;
       callback(null, chunk);
@@ -800,6 +802,18 @@ function captureRawBodyPreParsingHook(request, _reply, payload, done) {
   payload.pipe(capture);
   done(null, capture);
 }
+function createRawBodyBufferChunk(chunk, encoding) {
+  if (Buffer.isBuffer(chunk)) {
+    return chunk;
+  }
+  if (chunk instanceof Uint8Array) {
+    return Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+  }
+  if (typeof chunk === 'string') {
+    return Buffer.from(chunk, encoding);
+  }
+  throw new TypeError(`Fastify raw-body capture received unsupported ${typeof chunk} stream chunk.`);
+}
 function isMultipartRequestContentType(contentType) {
   const primaryValue = Array.isArray(contentType) ? contentType[0] : contentType;
   return typeof primaryValue === 'string' && primaryValue.toLowerCase().includes('multipart/form-data');

package/package.json

@@ -8,7 +8,7 @@
     "platform",
     "server"
   ],
-  "version": "1.0.6",
+  "version": "1.0.8",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -38,13 +38,13 @@
     "@fastify/multipart": "^9.2.1",
     "fastify": "^5.8.5",
     "fastify-raw-body": "^5.0.0",
-    "@fluojs/http": "^1.1.0",
-    "@fluojs/runtime": "^1.1.6"
+    "@fluojs/http": "^1.1.2",
+    "@fluojs/runtime": "^1.1.8"
   },
   "devDependencies": {
     "vitest": "^3.2.4",
     "@fluojs/di": "^1.1.0",
-    "@fluojs/testing": "^1.0.5"
+    "@fluojs/testing": "^1.0.6"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",