@fluojs/platform-nodejs 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -43,7 +43,7 @@ await app.listen();
43
43
  ## 주요 패턴
44
44
 
45
45
  ### 서버 옵션 커스텀
46
- 어댑터는 HTTPS 설정 바디 크기 제한을 포함한 표준 Node.js 서버 옵션을 수용합니다.
46
+ 어댑터는 문서화된 Node.js transport 옵션인 host/port 바인딩, HTTPS 설정, request body 제한, raw-body 보존, listen retry 설정, shutdown drain bound를 제공합니다.
47
47
 
48
48
  ```typescript
49
49
  const adapter = createNodejsAdapter({
@@ -58,12 +58,12 @@ const adapter = createNodejsAdapter({
58
58
 
59
59
  `maxBodySize`는 바이트 수를 나타내는 숫자만 받습니다. 이 값은 raw Node 요청 바디가 아직 스트리밍되는 동안 바로 강제되며, 부트스트랩 시 `multipart.maxTotalSize`를 따로 재정의하지 않으면 같은 값이 멀티파트 전체 페이로드 한도의 기본값으로도 사용됩니다.
60
60
 
61
- `createNodejsAdapter()`는 기본 port로 `3000`을 사용하고 `process.env.PORT`를 무시하며, `port`, `maxBodySize`, `retryDelayMs`, `retryLimit`, `shutdownTimeoutMs`가 잘못되면 throw합니다. 기본 request body cap은 `1 MiB`입니다.
61
+ `createNodejsAdapter()`는 기본 port로 `3000`을 사용하고 `process.env.PORT`를 무시하며, `port`, `maxBodySize`, `retryDelayMs`, `retryLimit`, adapter-level `shutdownTimeoutMs`가 잘못되면 throw합니다. 기본 request body cap은 `1 MiB`입니다.
62
62
 
63
63
  ### 직접 애플리케이션 실행
64
64
  `runNodejsApplication`을 사용하여 graceful shutdown 및 로깅이 포함된 보일러플레이트 없는 시작이 가능합니다.
65
65
 
66
- 시그널 기반 종료가 `forceExitTimeoutMs`를 넘기거나 실패하면 헬퍼는 해당 상태를 로그와 `process.exitCode`로 보고하지만, 최종 프로세스 종료는 호스트 프로세스 소유자에게 맡깁니다.
66
+ 시그널 기반 종료가 run-helper `forceExitTimeoutMs`를 넘기거나 실패하면 헬퍼는 해당 상태를 로그와 `process.exitCode`로 보고하지만, 최종 프로세스 종료는 호스트 프로세스 소유자에게 맡깁니다. Connection drain bound에는 adapter-level `shutdownTimeoutMs`를, signal handler completion bound에는 run-helper `forceExitTimeoutMs`를 사용하세요.
67
67
 
68
68
  ```typescript
69
69
  import { runNodejsApplication } from '@fluojs/platform-nodejs';
package/README.md CHANGED
@@ -43,7 +43,7 @@ await app.listen();
43
43
  ## Common Patterns
44
44
 
45
45
  ### Customizing Server Options
46
- The adapter accepts standard Node.js server options including HTTPS configuration and body size limits.
46
+ The adapter exposes the documented Node.js transport options: host/port binding, HTTPS configuration, request body limits, raw-body preservation, listen retry settings, and shutdown drain bounds.
47
47
 
48
48
  ```typescript
49
49
  const adapter = createNodejsAdapter({
@@ -58,12 +58,12 @@ const adapter = createNodejsAdapter({
58
58
 
59
59
  `maxBodySize` accepts a byte count number. It is enforced while the raw Node request body is still streaming, and the same limit becomes the default total multipart payload cap unless you override `multipart.maxTotalSize` during bootstrap.
60
60
 
61
- `createNodejsAdapter()` defaults to port `3000`, ignores `process.env.PORT`, and throws when `port`, `maxBodySize`, `retryDelayMs`, `retryLimit`, or `shutdownTimeoutMs` are invalid. The default request body cap is `1 MiB`.
61
+ `createNodejsAdapter()` defaults to port `3000`, ignores `process.env.PORT`, and throws when `port`, `maxBodySize`, `retryDelayMs`, `retryLimit`, or adapter-level `shutdownTimeoutMs` are invalid. The default request body cap is `1 MiB`.
62
62
 
63
63
  ### Direct Application Execution
64
64
  You can use `runNodejsApplication` for a zero-boilerplate startup that includes graceful shutdown and logging.
65
65
 
66
- When signal-driven shutdown exceeds `forceExitTimeoutMs` or fails, the helper logs the condition and sets `process.exitCode`, but leaves final process termination to the host process owner.
66
+ When signal-driven shutdown exceeds the run-helper `forceExitTimeoutMs` or fails, the helper logs the condition and sets `process.exitCode`, but leaves final process termination to the host process owner. Use adapter-level `shutdownTimeoutMs` for connection drain bounds and run-helper `forceExitTimeoutMs` for signal handler completion bounds.
67
67
 
68
68
  ```typescript
69
69
  import { runNodejsApplication } from '@fluojs/platform-nodejs';
package/package.json CHANGED
@@ -9,7 +9,7 @@
9
9
  "platform",
10
10
  "server"
11
11
  ],
12
- "version": "1.0.2",
12
+ "version": "1.0.3",
13
13
  "private": false,
14
14
  "license": "MIT",
15
15
  "repository": {
@@ -36,8 +36,8 @@
36
36
  "dist"
37
37
  ],
38
38
  "dependencies": {
39
- "@fluojs/runtime": "^1.1.0",
40
- "@fluojs/http": "^1.0.0"
39
+ "@fluojs/http": "^1.1.0",
40
+ "@fluojs/runtime": "^1.1.2"
41
41
  },
42
42
  "devDependencies": {
43
43
  "vitest": "^3.2.4"