@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 +26 -25
- package/dist/release-manifest.json +17 -17
- package/dist/release.js +1 -1
- package/package.json +6 -6
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
174
|
-
/absolute/path/to/cbxss-eoka-0.1.0-beta.
|
|
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.
|
|
433
|
-
server
|
|
434
|
-
`0.1.0-beta.
|
|
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.
|
|
437
|
+
### Pending beta.3
|
|
438
438
|
|
|
439
|
-
Beta.
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
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.
|
|
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.
|
|
451
|
-
The historical evidence below is retained and does not qualify beta.
|
|
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.
|
|
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
|
-
`
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
3
|
+
"sdkVersion": "0.1.0-beta.3",
|
|
4
4
|
"installerVersion": "3.2.4",
|
|
5
5
|
"server": {
|
|
6
|
-
"version": "0.6.
|
|
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.
|
|
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": "
|
|
16
|
-
"size":
|
|
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.
|
|
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": "
|
|
27
|
-
"size":
|
|
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.
|
|
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": "
|
|
38
|
-
"size":
|
|
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.
|
|
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": "
|
|
49
|
-
"size":
|
|
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.
|
|
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": "
|
|
60
|
-
"size":
|
|
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.
|
|
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.
|
|
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.
|
|
62
|
-
"@cbxss/eoka-server-linux-arm64-gnu": "0.1.0-beta.
|
|
63
|
-
"@cbxss/eoka-server-darwin-x64": "0.1.0-beta.
|
|
64
|
-
"@cbxss/eoka-server-darwin-arm64": "0.1.0-beta.
|
|
65
|
-
"@cbxss/eoka-server-win32-x64": "0.1.0-beta.
|
|
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",
|