@fluojs/platform-nodejs 1.0.1 → 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 +3 -3
- package/README.md +3 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/package.json +3 -3
package/README.ko.md
CHANGED
|
@@ -43,7 +43,7 @@ await app.listen();
|
|
|
43
43
|
## 주요 패턴
|
|
44
44
|
|
|
45
45
|
### 서버 옵션 커스텀
|
|
46
|
-
어댑터는 HTTPS
|
|
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
|
|
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/dist/index.d.ts
CHANGED
|
@@ -59,7 +59,7 @@ export declare const bootstrapNodejsApplication: typeof bootstrapNodeApplication
|
|
|
59
59
|
* Use this factory for adapter-first startup through `fluoFactory.create(...)` when the application
|
|
60
60
|
* should run directly on Node's built-in `http` or `https` server primitives.
|
|
61
61
|
*
|
|
62
|
-
* @param options Transport-level Node.js settings such as port, retries,
|
|
62
|
+
* @param options Transport-level Node.js settings such as port, retries, body-size limits, and HTTPS options.
|
|
63
63
|
* @returns The Node.js HTTP adapter instance used by the Fluo runtime.
|
|
64
64
|
*
|
|
65
65
|
* @example
|
package/dist/index.js
CHANGED
|
@@ -61,7 +61,7 @@ export const bootstrapNodejsApplication = bootstrapNodeApplication;
|
|
|
61
61
|
* Use this factory for adapter-first startup through `fluoFactory.create(...)` when the application
|
|
62
62
|
* should run directly on Node's built-in `http` or `https` server primitives.
|
|
63
63
|
*
|
|
64
|
-
* @param options Transport-level Node.js settings such as port, retries,
|
|
64
|
+
* @param options Transport-level Node.js settings such as port, retries, body-size limits, and HTTPS options.
|
|
65
65
|
* @returns The Node.js HTTP adapter instance used by the Fluo runtime.
|
|
66
66
|
*
|
|
67
67
|
* @example
|
package/package.json
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
"platform",
|
|
10
10
|
"server"
|
|
11
11
|
],
|
|
12
|
-
"version": "1.0.
|
|
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/http": "^1.
|
|
40
|
-
"@fluojs/runtime": "^1.
|
|
39
|
+
"@fluojs/http": "^1.1.0",
|
|
40
|
+
"@fluojs/runtime": "^1.1.2"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
43
43
|
"vitest": "^3.2.4"
|