@reventlessdev/rescript-node 2.0.0-alpha.15 → 2.0.0-alpha.17

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 2.0.0-alpha.17 (2026-09-28)
+
+### Features
+
+* **node:** bind node:test and node:assert, lstatSync, execPath and base64 decoding ([c067e39](https://github.com/ReventlessDev/reventless-core/commit/c067e39ce3a5979f3a18c4761e4673baa6c11ffd))
+* **node:** bind readline's promise API, process.platform and spawnSync's shell option ([c166726](https://github.com/ReventlessDev/reventless-core/commit/c166726008a08bb8b4b3e7b9d33dabde02389bad))
+
+
+# 2.0.0-alpha.16 (2026-09-27)
+
+### Features
+
+* **node:** bind node:test and node:assert, lstatSync, execPath and base64 decoding ([c067e39](https://github.com/ReventlessDev/reventless-core/commit/c067e39ce3a5979f3a18c4761e4673baa6c11ffd))
+
+
 # 2.0.0-alpha.15 (2026-09-23)
 
 * feat(node)!: every command-line tool reads its arguments through parseArgs ([2e41979](https://github.com/ReventlessDev/reventless-core/commit/2e41979b73646c46356e197e17eb4a3da0154c73))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/rescript-node",
-  "version": "2.0.0-alpha.15",
+  "version": "2.0.0-alpha.17",
   "description": "ReScript bindings for the Node.js standard library",
   "license": "Apache-2.0",
   "devDependencies": {

package/rescript.json

@@ -15,6 +15,7 @@
       "dir": "src",
       "subdirs": true,
       "public": [
+        "NodeAssert",
         "NodeBuffer",
         "NodeChildProcess",
         "NodeCrypto",
@@ -24,7 +25,9 @@
         "NodeOs",
         "NodePath",
         "NodeProcess",
+        "NodeReadline",
         "NodeStreams",
+        "NodeTest",
         "NodeUrl",
         "NodeUtil",
         "NodeZlib"

package/src/NodeAssert.res

@@ -0,0 +1,35 @@
+/** Bindings for [`node:assert/strict`](https://nodejs.org/api/assert.html#strict-assertion-mode).
+
+    The strict module only: `equal` is `===` and `deepEqual` is `deepStrictEqual`,
+    so a test cannot pass on a coercion. Each assertion that takes a message has a
+    `…Msg` form; the message replaces Node's generated one when the assertion
+    fails, so it should say what went wrong rather than restate the values. */
+@module("node:assert/strict")
+external equal: ('a, 'a) => unit = "equal"
+
+@module("node:assert/strict")
+external equalMsg: ('a, 'a, string) => unit = "equal"
+
+@module("node:assert/strict")
+external deepEqual: ('a, 'a) => unit = "deepEqual"
+
+@module("node:assert/strict")
+external deepEqualMsg: ('a, 'a, string) => unit = "deepEqual"
+
+@module("node:assert/strict")
+external ok: bool => unit = "ok"
+
+@module("node:assert/strict")
+external okMsg: (bool, string) => unit = "ok"
+
+/** `assert.match`, renamed because `match` is not an identifier in ReScript. */
+@module("node:assert/strict")
+external matches: (string, RegExp.t) => unit = "match"
+
+@module("node:assert/strict")
+external doesNotMatch: (string, RegExp.t) => unit = "doesNotMatch"
+
+/** Always throws, so it types as any value — usable as the arm of a `switch` that
+    has nothing to return. */
+@module("node:assert/strict")
+external fail: string => 'a = "fail"

package/src/NodeAssert.res.mjs

@@ -0,0 +1,2 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+/* This output is empty. Its source's type definitions, externals and/or unused code got optimized away. */

package/src/NodeBuffer.res

@@ -25,6 +25,10 @@ external fromStringBase64Url: (string, @as("base64url") _) => t = "from"
 
 /** A `Buffer` over a copy of the bytes. A plain `Uint8Array` — what the AWS SDK
     hands back — has only the array's own `toString`, which joins the numbers. */
+/** Standard base64, the alphabet of a `data:…;base64,` URI. */
+@val @scope("Buffer")
+external fromStringBase64: (string, @as("base64") _) => t = "from"
+
 @val @scope("Buffer")
 external fromBytes: Uint8Array.t => t = "from"
 

package/src/NodeChildProcess.res

@@ -8,6 +8,10 @@ type execOptions = {
   maxBuffer?: int,
   /** Written to the child's stdin, which is then closed. */
   input?: string,
+  /** Runs the command through a shell. Needed on Windows to start a `.cmd` shim
+      such as `pnpm`, and for a shell builtin such as `command -v`; otherwise
+      leave it off, since a shell re-splits the arguments. */
+  shell?: bool,
 }
 
 @module("node:child_process")

package/src/NodeFs.res

@@ -16,6 +16,15 @@ existsSync: string => bool = "existsSync"
 @module("node:fs")
 external realpathSync: string => string = "realpathSync"
 
+type stats
+
+/** Stats the path itself rather than what it points to, which is the only way to
+    tell a symbolic link from its target. */
+@module("node:fs")
+external lstatSync: string => stats = "lstatSync"
+
+@send external isSymbolicLink: stats => bool = "isSymbolicLink"
+
 /** Set a file's access and modification times, in seconds since the epoch.
 
     The reason this exists here rather than as a shell-out to `touch`: a build

package/src/NodeProcess.res

@@ -23,6 +23,17 @@ external exit: int => unit = "exit"
 @val @scope("process")
 external pid: int = "pid"
 
+/** The absolute path of the running `node` binary — what a test spawns a script
+    with, so the child runs on the same Node as the parent rather than whichever
+    `node` is first on `PATH`. */
+@val @scope("process")
+external execPath: string = "execPath"
+
+/** The operating system Node was built for: `"darwin"`, `"linux"`, `"win32"`, …
+    A string rather than a variant because the set is Node's to extend. */
+@val @scope("process")
+external platform: string = "platform"
+
 /** `versions["node"]` is the running Node's version, without the leading `v`. */
 @val @scope("process")
 external versions: dict<string> = "versions"

package/src/NodeReadline.res

@@ -0,0 +1,20 @@
+/** Bindings for [`node:readline/promises`](https://nodejs.org/api/readline.html#promises-api):
+    asking a question on a terminal and awaiting the answer.
+
+    The promise form, for a prompt that reads one answer at a time. A stream read
+    line by line is {!NodeStreams.Readline}. The interface holds stdin open, so
+    close it once the last answer is in or the process will not exit. */
+type t
+
+type options = {input: NodeProcess.stream, output: NodeProcess.stream}
+
+@module("node:readline/promises")
+external createInterface: options => t = "createInterface"
+
+/** Writes the question to `output` and resolves with the line typed in reply,
+    without its line ending. */
+@send
+external question: (t, string) => promise<string> = "question"
+
+@send
+external close: t => unit = "close"

package/src/NodeReadline.res.mjs

@@ -0,0 +1,2 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+/* This output is empty. Its source's type definitions, externals and/or unused code got optimized away. */

package/src/NodeTest.res

@@ -0,0 +1,23 @@
+/** Bindings for [`node:test`](https://nodejs.org/api/test.html), the runner behind
+    `node --test`.
+
+    Only the forms a test file declares itself with. A test body is synchronous
+    unless it is bound through {!testAsync}; a promise returned from {!test}'s body
+    would not be awaited by the type, so the two are kept apart. */
+@module("node:test")
+external test: (string, unit => unit) => unit = "test"
+
+@module("node:test")
+external testAsync: (string, unit => promise<unit>) => unit = "test"
+
+/** Whether a test runs, or why it is skipped. Node takes `false` or a reason
+    string, and prints the reason beside the skipped test. */
+@unboxed
+type skip = | @as(false) Run | Skip(string)
+
+type options = {skip?: skip}
+
+/** A test that decides at load time whether it can run — one that needs a sibling
+    checkout, say, and skips with a reason where there is none. */
+@module("node:test")
+external testWith: (string, options, unit => unit) => unit = "test"

package/src/NodeTest.res.mjs

@@ -0,0 +1,2 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+/* This output is empty. Its source's type definitions, externals and/or unused code got optimized away. */