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

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 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.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.16",
   "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",
@@ -25,6 +26,7 @@
         "NodePath",
         "NodeProcess",
         "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/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,12 @@ 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"
+
 /** `versions["node"]` is the running Node's version, without the leading `v`. */
 @val @scope("process")
 external versions: dict<string> = "versions"

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. */