Merge commit '3c60637c1a27da8ba66888de518d58d5707801f2' as 'repos/effect-smol'

repos/effect-smol/packages/platform-node/src/NodeRuntime.ts

@@ -0,0 +1,53 @@
+/**
+ * Node.js process runner for Effect programs.
+ *
+ * This module exports `runMain`, which runs one Effect as the main process
+ * fiber in Node.js. It reuses the shared Node runtime runner, including its
+ * error reporting, `SIGINT` / `SIGTERM` interruption, and optional teardown
+ * behavior.
+ *
+ * @since 4.0.0
+ */
+import * as NodeRuntime from "@effect/platform-node-shared/NodeRuntime"
+import type { Effect } from "effect/Effect"
+import type * as Runtime from "effect/Runtime"
+
+/**
+ * Helps you run a main effect with built-in error handling, logging, and signal management.
+ *
+ * **When to use**
+ *
+ * Use to run a Node.js application's main Effect with structured error
+ * handling, log management, interrupt support, or advanced teardown
+ * capabilities.
+ *
+ * **Details**
+ *
+ * This function launches an Effect as the main entry point, setting exit codes
+ * based on success or failure, handling interrupts (e.g., Ctrl+C), and optionally
+ * logging errors. By default, it logs errors and uses a "pretty" format, but both
+ * behaviors can be turned off. You can also provide custom teardown logic to
+ * finalize resources or produce different exit codes.
+ *
+ * The optional configuration object can include:
+ * - `disableErrorReporting`: Turn off automatic error logging.
+ * - `teardown`: Provide custom finalization logic.
+ *
+ * @category running
+ * @since 4.0.0
+ */
+export const runMain: {
+  (
+    options?: {
+      readonly disableErrorReporting?: boolean | undefined
+      readonly teardown?: Runtime.Teardown | undefined
+    }
+  ): <E, A>(effect: Effect<A, E>) => void
+  <E, A>(
+    effect: Effect<A, E>,
+    options?: {
+      readonly disableErrorReporting?: boolean | undefined
+      readonly teardown?: Runtime.Teardown | undefined
+    }
+  ): void
+} = NodeRuntime.runMain