@tsonic/nodejs 10.0.41 → 10.0.44

package/README.md

@@ -37,11 +37,10 @@ npm run dev
 ## Existing project
 
 ```bash
-npx --yes tsonic@latest init --surface @tsonic/js
 npx --yes tsonic@latest add npm @tsonic/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.
+`@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
 
@@ -49,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)
 
@@ -90,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
@@ -108,7 +113,14 @@ 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)
@@ -120,10 +132,6 @@ For JS-surface projects with `@tsonic/nodejs` installed, prefer Node-style impor
 
 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.)
@@ -144,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