@cbxss/eoka 0.1.0-beta.2 → 0.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @cbxss/eoka
2
2
 
3
- The Node.js SDK for the eoka NDJSON browser sidecar. Beta `0.1.0-beta.1` is published under the npm `next` tag; this source checkout prepares **`0.1.0-beta.2`, not yet published or qualified**. The repository source package remains private, with public artifacts staged only by the publication workflow. It supports **Node.js 24 LTS, starting at 24.21.0** (`^24.21.0`) and exports compiled ESM and TypeScript declarations. Node 22 and Current/non-LTS lines are outside the support policy. CommonJS `require` is not an export.
3
+ The Node.js SDK for the eoka NDJSON browser sidecar. Beta `0.1.0-beta.2` is published under the npm `next` tag; this source checkout prepares **`0.1.0-beta.3`, not yet published or qualified**. The repository source package remains private, with public artifacts staged only by the publication workflow. It supports **Node.js 24 LTS, starting at 24.21.0** (`^24.21.0`) and exports compiled ESM and TypeScript declarations. Node 22 and Current/non-LTS lines are outside the support policy. CommonJS `require` is not an export.
4
4
 
5
5
  ```sh
6
6
  npm install @cbxss/eoka@next
@@ -12,7 +12,7 @@ The SDK provides correlated subprocess transport, typed browser/page operations,
12
12
 
13
13
  Managed targets are `linux-x64-gnu`, `linux-arm64-gnu`, `darwin-x64`, `darwin-arm64`, and `win32-x64`. Linux managed selection requires glibc >= 2.35 and rejects musl/Alpine; Windows arm64 and unknown combinations are rejected before downloads. GNU release artifacts are built on Ubuntu 22.04 and checked for GLIBC requirements no higher than 2.35. Arbitrary source-built or host-development binaries are not qualified by that result.
14
14
 
15
- Both explicit server and Chrome paths are an expert override for managed platform checks, not a new support guarantee. Node.js support does not imply Bun, Deno, browser-side JavaScript, or drop-in Puppeteer compatibility. Packed npm consumption and credential-free registry installation with a Linux Chrome smoke are verified for beta.1; beta.2 requires fresh qualification. pnpm/Yarn remain unqualified.
15
+ Both explicit server and Chrome paths are an expert override for managed platform checks, not a new support guarantee. Node.js support does not imply Bun, Deno, browser-side JavaScript, or drop-in Puppeteer compatibility. Packed npm consumption and credential-free registry installation with a Linux Chrome smoke are verified for beta.2; beta.3 requires fresh qualification. pnpm/Yarn remain unqualified.
16
16
 
17
17
  ## Managed launch and explicit preparation
18
18
 
@@ -123,10 +123,10 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
123
123
  && rm -rf /var/lib/apt/lists/*
124
124
  WORKDIR /app
125
125
  RUN chown node:node /app
126
- COPY --chown=node:node cbxss-eoka-0.1.0-beta.2.tgz cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz ./
126
+ COPY --chown=node:node cbxss-eoka-0.1.0-beta.3.tgz cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.3.tgz ./
127
127
  USER node
128
128
  RUN npm init -y && npm install --ignore-scripts --omit=optional --no-audit --no-fund \
129
- ./cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz ./cbxss-eoka-0.1.0-beta.2.tgz
129
+ ./cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.3.tgz ./cbxss-eoka-0.1.0-beta.3.tgz
130
130
  ENV EOKA_BROWSER_CACHE_DIR=/app/browser-cache
131
131
  ENV EOKA_RUNTIME_DIR=/tmp/eoka
132
132
  RUN node node_modules/@cbxss/eoka/examples/install-browser.mjs
@@ -137,7 +137,7 @@ Network is needed during image preparation for npm dependencies and the pinned C
137
137
 
138
138
  ## Build, source staging, and local consumption
139
139
 
140
- This SDK and its five native packages share reserved npm version `0.1.0-beta.2`. The native server is pinned separately to `0.6.0`, published registry core to `0.7.0`, and the protocol to `1.3`; npm version equality is not wire compatibility. Release manifests accept exact semantic versions, including prereleases, but reject floating ranges, tags, and malformed versions. Packaged servers are checked against their name/version/platform, staged release metadata, actual binary digest, and expected handshake version. Explicit servers still must pass the protocol handshake.
140
+ This SDK and its five native packages share reserved npm version `0.1.0-beta.3`. The native server is pinned separately to `0.6.1`, published registry core to `0.7.2`, and the protocol to `1.3`; npm version equality is not wire compatibility. Release manifests accept exact semantic versions, including prereleases, but reject floating ranges, tags, and malformed versions. Packaged servers are checked against their name/version/platform, staged release metadata, actual binary digest, and expected handshake version. Explicit servers still must pass the protocol handshake.
141
141
 
142
142
  The source manifest intentionally has no fabricated hashes for unprepared native artifacts. The source package omits native optional dependencies so a clean `npm ci` does not need unpublished packages. Staging derives all five exact native dependencies from the validated release manifest and adds them to the staged SDK's package metadata. Packing the source SDK alone is useful for import/type gates, but is **not** a ready managed server distribution. Missing native packages (including after `--omit=optional`) raise `ServerPackageMissing`; a present package with an unstaged SDK pin raises `ReleaseNotPrepared`. There is no compile/download fallback.
143
143
 
@@ -170,8 +170,8 @@ In a separate ESM application, install the matching native tarball as a direct d
170
170
 
171
171
  ```sh
172
172
  npm install --ignore-scripts --omit=optional \
173
- /absolute/path/to/cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.2.tgz \
174
- /absolute/path/to/cbxss-eoka-0.1.0-beta.2.tgz
173
+ /absolute/path/to/cbxss-eoka-server-linux-x64-gnu-0.1.0-beta.3.tgz \
174
+ /absolute/path/to/cbxss-eoka-0.1.0-beta.3.tgz
175
175
  npm install --save-dev typescript@5.9.3 @types/node@24.19.2
176
176
  ```
177
177
 
@@ -429,26 +429,27 @@ From the repository root use `mise run node-build`, `node-check`, or `node-consu
429
429
 
430
430
  ## Prerelease qualification and publication
431
431
 
432
- Core `0.7.0` is published on crates.io. Reserved prerelease versions are
433
- server/protocol crates `0.6.0`, wire protocol `1.3`, and SDK/native npm packages
434
- `0.1.0-beta.2`. Source and ordinary staged packages remain private;
432
+ Core `0.7.2` is published on crates.io. Reserved prerelease versions are
433
+ server crate `0.6.1`, protocol crate `0.6.0`, wire protocol `1.3`, and SDK/native
434
+ npm packages `0.1.0-beta.3`. Source and ordinary staged packages remain private;
435
435
  `--publication` is a separate, fail-closed staging mode.
436
436
 
437
- ### Pending beta.2
437
+ ### Pending beta.3
438
438
 
439
- Beta.1 remains published under `next`. Beta.2 repackages the existing native server
440
- with the Windows operation-lock contention fix and shorter registry-smoke runtime
441
- paths merged in [PR #63](https://github.com/shrimp-software/eoka-tools/pull/63)
442
- at `c72892066bb12c51c084166e54059cae3854f0e6`. No Rust, core, protocol, Chrome,
443
- or dependency version changes are required. Native binaries must be rebuilt from
444
- the new release source; repacking beta.1 binaries would omit the lock fix.
439
+ Beta.2 was published under `next` on 2026-10-18 from
440
+ `bd346b47d907ba9b71c603c4c94e77024c9f0fdd` (server `0.6.0`, core `0.7.0`).
441
+ Beta.3 rebuilds the native server as `0.6.1` against published core `0.7.2`,
442
+ which removes reflection-visible headless and platform leaks
443
+ ([eoka#37](https://github.com/shrimp-software/eoka/pull/37)). No protocol, Chrome,
444
+ or SDK API changes are required. Native binaries must be rebuilt from the new
445
+ release source; repacking beta.2 binaries would omit the core fixes.
445
446
 
446
- Beta.2 has not been published. Release authorization requires local SDK checks
447
+ Beta.3 has not been published. Release authorization requires local SDK checks
447
448
  and fresh five-platform native qualification (including Windows live-owner
448
449
  recovery) in the publication workflow at the exact current protected `main` commit.
449
450
  The readiness record's `ready` status means no recorded source defect blocks
450
- qualification; it is not beta.2 runtime evidence or permission to publish.
451
- The historical evidence below is retained and does not qualify beta.2.
451
+ qualification; it is not beta.3 runtime evidence or permission to publish.
452
+ The historical evidence below is retained and does not qualify beta.3.
452
453
 
453
454
  `.github/workflows/qualify-node-release.yml` builds all five native targets and
454
455
  qualifies installed tarballs outside the repository. GNU builds use Ubuntu 22.04
@@ -480,10 +481,10 @@ mise run node-qualify-release -- --stage /absolute/stage \
480
481
  ```
481
482
 
482
483
  The workflow resolves `source_ref` to an immutable tools revision and builds
483
- against published registry core `0.7.0`, without a sibling checkout or Cargo
484
+ against published registry core `0.7.2`, without a sibling checkout or Cargo
484
485
  patch. It checks every native build's core identity and exact source lockfile,
485
486
  including registry checksum
486
- `447a498ec28c34b2020be583617c70f89dc718228bb02db5750f72e4da333a1e`.
487
+ `bb088753bbef0585bcbaa1e868e4e59b5ee99db40844ba9cb3ec4822ca95e019`.
487
488
  Local host-development staging and `--preview` remain separate from release
488
489
  qualification and cannot authorize publication.
489
490
 
@@ -514,7 +515,7 @@ the documented native timing defects; changing Chrome's container layout require
514
515
  renewed qualification, not an implicit generic muxer or transcoder.
515
516
 
516
517
  `publish-node.yml` is manual, restricted to an exact current protected `main`
517
- commit, and publishes only `0.1.0-beta.2` under `next` with npm provenance.
518
+ commit, and publishes only `0.1.0-beta.3` under `next` with npm provenance.
518
519
  It requires an existing `npm-prerelease` environment with required reviewers
519
520
  and a single allowed deployment branch, `main`. By default it uses only npm
520
521
  trusted publishing through OIDC, requires self-review to be disabled, and
@@ -539,7 +540,7 @@ Both modes retain GitHub OIDC provenance and the same qualification checks.
539
540
  Normal trusted publication still requires operator setup. On 2026-10-15, the
540
541
  GitHub `npm-prerelease` environment allowed only branch `main`, but its sole
541
542
  required reviewer was `cbxss` and `prevent_self_review` was `false`. The normal
542
- publication gate therefore rejects that configuration. Before beta.2 publication,
543
+ publication gate therefore rejects that configuration. Before beta.3 publication,
543
544
  an operator must enable `prevent_self_review: true`, arrange an independent
544
545
  required reviewer, and confirm npm trusted publishers on all six existing packages
545
546
  for owner `shrimp-software`, repository `eoka-tools`, workflow `publish-node.yml`,
@@ -550,7 +551,7 @@ secret and revoke its token after confirming the migration. No environment,
550
551
  secret, token, or npm setting is changed by this release preparation.
551
552
 
552
553
  The bootstrap procedure above is historical first-publication guidance, not the
553
- normal beta.2 release path or an automatic fallback. A bootstrap rerun after a
554
+ normal beta.3 release path or an automatic fallback. A bootstrap rerun after a
554
555
  partial upload still needs the token and must follow same-run recovery below.
555
556
 
556
557
  The publish job accepts only same-run, same-source qualified artifacts and
@@ -1,63 +1,63 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "sdkVersion": "0.1.0-beta.2",
3
+ "sdkVersion": "0.1.0-beta.3",
4
4
  "installerVersion": "3.2.4",
5
5
  "server": {
6
- "version": "0.6.0",
6
+ "version": "0.6.1",
7
7
  "protocolVersion": "1.3",
8
8
  "platforms": {
9
9
  "linux-x64-gnu": {
10
10
  "packageName": "@cbxss/eoka-server-linux-x64-gnu",
11
- "packageVersion": "0.1.0-beta.2",
11
+ "packageVersion": "0.1.0-beta.3",
12
12
  "target": "x86_64-unknown-linux-gnu",
13
13
  "asset": "eoka-server-linux-amd64",
14
14
  "executablePath": "bin/eoka-server",
15
- "sha256": "4f6b5dca392902fca36f454a2735c9722832e74697feea5e87aacc23ea6b8e46",
16
- "size": 16997800,
15
+ "sha256": "445c2f1dfb84df9ad6d868d78b2ba67a1b107d1fc96ae3d7a1ce9fc97e8c2089",
16
+ "size": 16968272,
17
17
  "minimumGlibc": "2.35",
18
18
  "development": false
19
19
  },
20
20
  "linux-arm64-gnu": {
21
21
  "packageName": "@cbxss/eoka-server-linux-arm64-gnu",
22
- "packageVersion": "0.1.0-beta.2",
22
+ "packageVersion": "0.1.0-beta.3",
23
23
  "target": "aarch64-unknown-linux-gnu",
24
24
  "asset": "eoka-server-linux-arm64",
25
25
  "executablePath": "bin/eoka-server",
26
- "sha256": "014fdd7c78797f4955e7c3788984a94cc01d3a1f91501b9be32dc33ebdb30d3c",
27
- "size": 16288304,
26
+ "sha256": "291df6255ab1b98ffe1f0fc8c0473d508cdd2d26d46f0517b7fe060a8949ed78",
27
+ "size": 16247368,
28
28
  "minimumGlibc": "2.35",
29
29
  "development": false
30
30
  },
31
31
  "darwin-x64": {
32
32
  "packageName": "@cbxss/eoka-server-darwin-x64",
33
- "packageVersion": "0.1.0-beta.2",
33
+ "packageVersion": "0.1.0-beta.3",
34
34
  "target": "x86_64-apple-darwin",
35
35
  "asset": "eoka-server-darwin-amd64",
36
36
  "executablePath": "bin/eoka-server",
37
- "sha256": "20eca3d9f171e94f6b9f86ed8f2f7c49813b8905574c0b5234e9f2efad75577b",
38
- "size": 15079232,
37
+ "sha256": "e73e1048854a2671e63ff0ea86e30dd7d15df50f6328958fa35f0a71fb088ea8",
38
+ "size": 15055664,
39
39
  "minimumGlibc": null,
40
40
  "development": false
41
41
  },
42
42
  "darwin-arm64": {
43
43
  "packageName": "@cbxss/eoka-server-darwin-arm64",
44
- "packageVersion": "0.1.0-beta.2",
44
+ "packageVersion": "0.1.0-beta.3",
45
45
  "target": "aarch64-apple-darwin",
46
46
  "asset": "eoka-server-darwin-arm64",
47
47
  "executablePath": "bin/eoka-server",
48
- "sha256": "0c10b1a0aaacc57be62904bb39f72cee92125cf8d4fb858330a3f458bda9ec5d",
49
- "size": 14608624,
48
+ "sha256": "faba395aef1347ddce39cb3ce1fa52029a801a172d19c1632c0256a15a83022c",
49
+ "size": 14604368,
50
50
  "minimumGlibc": null,
51
51
  "development": false
52
52
  },
53
53
  "win32-x64": {
54
54
  "packageName": "@cbxss/eoka-server-win32-x64",
55
- "packageVersion": "0.1.0-beta.2",
55
+ "packageVersion": "0.1.0-beta.3",
56
56
  "target": "x86_64-pc-windows-msvc",
57
57
  "asset": "eoka-server-windows-amd64.exe",
58
58
  "executablePath": "bin/eoka-server.exe",
59
- "sha256": "000978048095b63cafc6c5e4cb250dd40267a8dd0a73697f84f99e51a3066b3d",
60
- "size": 14114816,
59
+ "sha256": "57829a23155279220964b4d3e07ab6d87c500818d92aed86c23d4fa4b59b74c4",
60
+ "size": 14133248,
61
61
  "minimumGlibc": null,
62
62
  "development": false
63
63
  }
package/dist/release.js CHANGED
@@ -29,7 +29,7 @@ export function validateReleaseManifest(value) {
29
29
  const chrome = object(manifest.chrome);
30
30
  const servers = object(server.platforms);
31
31
  const browsers = object(chrome.platforms);
32
- if (manifest.schemaVersion !== 1 || !exactNpmVersion(manifest.sdkVersion) || manifest.installerVersion !== '3.2.4' || server.version !== '0.6.0' || server.protocolVersion !== `${protocolVersion.major}.${protocolVersion.minor}` || chrome.buildId !== '155.0.8059.39')
32
+ if (manifest.schemaVersion !== 1 || !exactNpmVersion(manifest.sdkVersion) || manifest.installerVersion !== '3.2.4' || server.version !== '0.6.1' || server.protocolVersion !== `${protocolVersion.major}.${protocolVersion.minor}` || chrome.buildId !== '155.0.8059.39')
33
33
  throw new Error('Incompatible release versions');
34
34
  if (Object.keys(servers).length !== platformIds.length || Object.keys(browsers).length !== platformIds.length)
35
35
  throw new Error('Incomplete platform mapping');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cbxss/eoka",
3
- "version": "0.1.0-beta.2",
3
+ "version": "0.1.0-beta.3",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Node.js SDK with pinned Chrome installation and verified eoka sidecar resolution",
@@ -58,11 +58,11 @@
58
58
  "typescript": "5.9.3"
59
59
  },
60
60
  "optionalDependencies": {
61
- "@cbxss/eoka-server-linux-x64-gnu": "0.1.0-beta.2",
62
- "@cbxss/eoka-server-linux-arm64-gnu": "0.1.0-beta.2",
63
- "@cbxss/eoka-server-darwin-x64": "0.1.0-beta.2",
64
- "@cbxss/eoka-server-darwin-arm64": "0.1.0-beta.2",
65
- "@cbxss/eoka-server-win32-x64": "0.1.0-beta.2"
61
+ "@cbxss/eoka-server-linux-x64-gnu": "0.1.0-beta.3",
62
+ "@cbxss/eoka-server-linux-arm64-gnu": "0.1.0-beta.3",
63
+ "@cbxss/eoka-server-darwin-x64": "0.1.0-beta.3",
64
+ "@cbxss/eoka-server-darwin-arm64": "0.1.0-beta.3",
65
+ "@cbxss/eoka-server-win32-x64": "0.1.0-beta.3"
66
66
  },
67
67
  "repository": {
68
68
  "type": "git",