Merge commit '36c66dd290d3ce6eb1ccd310d0c658d4a32bb8eb' as 'repos/effect'

repos/effect/packages/platform-node-shared/src/NodePath.ts

@@ -0,0 +1,80 @@
+/**
+ * Node-backed provider for Effect's `Path` service.
+ *
+ * This module turns Node's `node:path` and `node:url` APIs into `Path` layers.
+ * `layer` uses the host platform path implementation, while `layerPosix` and
+ * `layerWin32` provide fixed POSIX and Windows variants. All three layers also
+ * include helpers for converting between file paths and file URLs.
+ *
+ * @since 4.0.0
+ */
+import * as Effect from "effect/Effect"
+import * as Layer from "effect/Layer"
+import { Path, TypeId } from "effect/Path"
+import { BadArgument } from "effect/PlatformError"
+import * as NodePath from "node:path"
+import * as NodeUrl from "node:url"
+
+const fromFileUrl = (url: URL): Effect.Effect<string, BadArgument> =>
+  Effect.try({
+    try: () => NodeUrl.fileURLToPath(url),
+    catch: (cause) =>
+      new BadArgument({
+        module: "Path",
+        method: "fromFileUrl",
+        cause
+      })
+  })
+
+const toFileUrl = (path: string): Effect.Effect<URL, BadArgument> =>
+  Effect.try({
+    try: () => NodeUrl.pathToFileURL(path),
+    catch: (cause) =>
+      new BadArgument({
+        module: "Path",
+        method: "toFileUrl",
+        cause
+      })
+  })
+
+/**
+ * Provides the `Path` service using Node's POSIX path implementation plus
+ * file URL conversion helpers.
+ *
+ * @category layers
+ * @since 4.0.0
+ */
+export const layerPosix: Layer.Layer<Path> = Layer.succeed(Path)({
+  [TypeId]: TypeId,
+  ...NodePath.posix,
+  fromFileUrl,
+  toFileUrl
+})
+
+/**
+ * Provides the `Path` service using Node's Windows path implementation plus
+ * file URL conversion helpers.
+ *
+ * @category layers
+ * @since 4.0.0
+ */
+export const layerWin32: Layer.Layer<Path> = Layer.succeed(Path)({
+  [TypeId]: TypeId,
+  ...NodePath.win32,
+  fromFileUrl,
+  toFileUrl
+})
+
+/**
+ * Provides the default `Path` service using the host platform's Node path
+ * implementation plus file URL conversion helpers.
+ *
+ * @category layers
+ * @since 4.0.0
+ */
+export const layer: Layer.Layer<Path> = Layer.succeed(Path)({
+  [TypeId]: TypeId,
+  ...NodePath,
+  fromFileUrl,
+  toFileUrl
+})