@tsonic/nodejs 10.0.40 → 10.0.42

package/README.md

@@ -15,7 +15,7 @@ Use `@tsonic/nodejs` when you want Node-like modules (`fs`, `path`, `events`, `c
 
 ```bash
 mkdir my-app && cd my-app
-npx --yes tsonic@latest init --surface nodejs
+npx --yes tsonic@latest init --surface @tsonic/js
 npx --yes tsonic@latest add npm @tsonic/nodejs
 ```
 
@@ -40,11 +40,7 @@ npm run dev
 npx --yes tsonic@latest add npm @tsonic/nodejs
 ```
 
-If the workspace is not already Node surface, set:
-
-```bash
-npx --yes tsonic@latest init --surface nodejs
-```
+`@tsonic/nodejs` is a regular package, not a surface. Use `@tsonic/js` for the ambient JavaScript world, and add `@tsonic/nodejs` when you want `node:*` module imports. If your workspace is still on CLR, switch its `surface` to `@tsonic/js` first.
 
 ## Versioning
 
@@ -52,7 +48,13 @@ This repo is versioned by runtime major:
 
 - `10` → `versions/10/` → npm: `@tsonic/nodejs@10.x`
 
-When publishing, run: `npm publish versions/10 --access public`
+Before publishing, run `npm run selftest`.
+
+Publish with:
+
+```bash
+npm run publish:10
+```
 
 ## Core Modules (what you get)
 
@@ -93,10 +95,10 @@ emitter.on("data", (chunk) => console.log(chunk));
 ### Crypto
 
 ```ts
-import { randomUUID } from "node:crypto";
+import { createHash } from "node:crypto";
 
-const id = randomUUID();
-void id;
+const hash = createHash("sha256").update("hello").digest("hex");
+void hash;
 ```
 
 ### Process
@@ -111,22 +113,25 @@ void cwd;
 ### HTTP
 
 ```typescript
-import { http } from "@tsonic/nodejs/nodejs.Http.js";
+import { createServer } from "node:http";
+
+const server = createServer((_req, res) => {
+  res.writeHead(200, "OK");
+  res.end("Hello from Tsonic!");
+});
+
+void server;
 ```
 
 ## Imports (important)
 
-For `--surface nodejs` projects, prefer Node-style imports:
+For JS-surface projects with `@tsonic/nodejs` installed, prefer Node-style imports:
 
 - `node:fs`, `node:path`, `node:crypto`, `node:process`, ...
 - bare aliases (`fs`, `path`, `crypto`, ...) are also supported
 
 Direct ESM imports from `@tsonic/nodejs/index.js` are still supported.
 
-`node:http` is currently not mapped by the surface alias set; use:
-
-- `@tsonic/nodejs/nodejs.Http.js`
-
 ## Relationship to `@tsonic/js`
 
 - `@tsonic/js` provides JavaScript runtime APIs (JS-style `console`, `JSON`, timers, etc.)
@@ -147,6 +152,14 @@ Direct ESM imports from `@tsonic/nodejs/index.js` are still supported.
 
 See `__build/` for regeneration scripts.
 
+Run the publish-gated validation suite with:
+
+```bash
+npm run selftest
+```
+
+When sibling `@tsonic/*` repos are checked out locally, the selftest installs those local packages first, whether they are versioned package repos (for example `../js/versions/10`) or root-package repos (for example `../aspnetcore`). That keeps the consumer validation coherent across a local release wave instead of mixing one local package with stale published transitive dependencies. The selftest also fails on peer-dependency warnings, so stale local release waves are caught before publish.
+
 ## License
 
 MIT