@ai-ecoverse/slicc-browsers 1.19.0 → 1.19.2

package/guard-driver.mjs

@@ -354,11 +354,25 @@ export const skipReason = (vector, target, scope) => {
 
 export const inapplicable = (vector, target, scope) => skipReason(vector, target, scope) !== null;
 
+const trustedEmulationMethods = new Set([
+  'Emulation.setLocaleOverride',
+  'Emulation.setTimezoneOverride',
+]);
+
+const canTrustedEmulation = (vector) =>
+  flatten(named([...(vector?.setup ?? []), ...(vector?.trigger ?? [])])).some((step) =>
+    trustedEmulationMethods.has(step.cdp)
+  );
+
 function skipWhy(vector, row, known, guard) {
   const { reason } = row;
   if (typeof reason !== 'string' || reason === '') return 'skip without a reason';
   if (reason === skipReason(vector, row.target, guard)) return null;
   if (originReason(vector, row, reason)) return null;
+  if (reason === 'not-supported:trustedEmulation')
+    return canTrustedEmulation(vector)
+      ? null
+      : `skip with a reason the runner never gives: ${reason}`;
   if (reason.startsWith('not-supported:') && known.has(reason.slice('not-supported:'.length)))
     return null;
   return `skip with a reason the runner never gives: ${reason}`;
@@ -369,6 +383,7 @@ function forgeries(set, results, guard) {
   const known = new Set([
     'browserSession',
     'unguarded-observer',
+    'trustedEmulation',
     ...capabilities(set.vectors).filter((c) => typeof c === 'string' && c !== ''),
   ]);
   return results.flatMap((row) => {
@@ -443,3 +458,32 @@ export const idleDebuggerCleanup = (vector, step, phase, out) =>
 
 export const debuggerPaused = (events, session) =>
   events.some((event) => event.sessionId === session && event.method === 'Debugger.paused');
+
+const cdpError = (error) => {
+  const code = error?.code;
+  const message = error?.message;
+  if (code !== undefined && code !== null) return { code, message };
+  if (typeof message !== 'string') return { code, message };
+  try {
+    const parsed = JSON.parse(message);
+    if (
+      parsed &&
+      typeof parsed === 'object' &&
+      typeof parsed.code === 'number' &&
+      typeof parsed.message === 'string'
+    )
+      return { code: parsed.code, message: parsed.message };
+  } catch {}
+  return { code, message };
+};
+
+export const trustedClientOnly = (step, out) => {
+  if (!trustedEmulationMethods.has(step.cdp) || out.ok) return false;
+  const { code, message } = cdpError(out.error);
+  return (
+    Number(code) === -32000 && /only available to trusted clients/i.test(String(message ?? ''))
+  );
+};
+
+export const refusalError = (step, out, refused, gone, phase, vector) =>
+  step.refusable && !out.ok && !refused && !gone && !idleDebuggerCleanup(vector, step, phase, out);

package/guard-runner.mjs

@@ -12,7 +12,6 @@ import {
   debuggerPaused,
   expand,
   hop,
-  idleDebuggerCleanup,
   inapplicable,
   isRefusal,
   knownOrigins,
@@ -21,10 +20,12 @@ import {
   outcome,
   owned,
   parseURL,
+  refusalError,
   summary as report,
   result,
   skipReason,
   steps,
+  trustedClientOnly,
   waitFor,
 } from './guard-driver.mjs';
 import { createObserverTarget, discoveryViolation } from './observer-target.mjs';
@@ -145,6 +146,7 @@ class Execution {
     this.pending = [];
     this.errors = [];
     this.incomplete = [];
+    this.unsupported = undefined;
     this.preSent = [];
     this.notes = [];
     this.answers = [];
@@ -685,14 +687,10 @@ class Execution {
       !refused &&
       /timeout|timed out|no answer/i.test(String(out.error?.message ?? out.error));
     if (step.refusable) this.refused[step.refusal.name] = unanswered ? 'incomplete' : refused;
-    if (unanswered) this.incomplete.push(`${step.refusal.name}: no answer`);
-    else if (
-      step.refusable &&
-      !out.ok &&
-      !refused &&
-      !gone &&
-      !idleDebuggerCleanup(this.vector, step, phase, out)
-    )
+    const trusted = this.side === 'control' && trustedClientOnly(step, out);
+    if (trusted) this.unsupported = 'trustedEmulation';
+    else if (unanswered) this.incomplete.push(`${step.refusal.name}: no answer`);
+    else if (refusalError(step, out, refused, gone, phase, this.vector))
       this.errors.push(
         `${step.refusal.name} failed without a refusal: ${String(out.error?.message ?? out.error)}`
       );
@@ -1447,6 +1445,7 @@ class Execution {
         errors: this.errors,
         notes: this.notes,
         incomplete: this.incomplete,
+        unsupported: this.unsupported,
         evidence: Object.fromEntries(
           Object.entries(this.calls)
             .filter(
@@ -1758,6 +1757,8 @@ async function executeRow(job, opts, made, set, slot, index, flights) {
     flight.abandoned = true;
     return timedOut(stuck, base, made, sides, opts);
   }
+  if (legs.control.unsupported === 'trustedEmulation')
+    return skipRow(base, 'not-supported:trustedEmulation');
   const row = {
     ...result(vector, {
       ...base,

package/guard-vectors.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "setVersion": "1.19.0",
+  "setVersion": "1.19.2",
   "sources": [
     {
       "repo": "ai-ecoverse/slicc-cli",
@@ -17369,7 +17369,7 @@
       "targets": ["seven", "vault", "vault-x", "apex"],
       "observe": {
         "locale": {
-          "means": "{target}/doc?n={tag} formats in the fr-CH locale",
+          "means": "when the client can override locale, {target}/doc?n={tag} formats in fr-CH",
           "dependsOn": ["refused.2"],
           "check": {
             "expression": "(location.href === '{target}/doc?n={tag}') ? Intl.DateTimeFormat().resolvedOptions().locale : 'elsewhere'",
@@ -17387,7 +17387,7 @@
           }
         }
       },
-      "live": "the runner's own CDP sees {target}'s document load (title, marker or URL), or the guard returned its refusal for a refusable step",
+      "live": "the runner's own CDP sees {target}'s document load (title, marker or URL), or the guard returned its refusal for a refusable step; Chrome's trusted-client-only refusal of Emulation.setLocaleOverride on the ordinary control is not-supported:trustedEmulation",
       "control": {
         "origin": "ordinary",
         "via": "guard",
@@ -17490,7 +17490,7 @@
       "targets": ["seven", "vault", "vault-x", "apex"],
       "observe": {
         "timezone": {
-          "means": "{target}/doc?n={tag} runs in the Pacific/Chatham time zone",
+          "means": "when the client can override the time zone, {target}/doc?n={tag} runs in Pacific/Chatham",
           "dependsOn": ["refused.2"],
           "check": {
             "expression": "(location.href === '{target}/doc?n={tag}') ? Intl.DateTimeFormat().resolvedOptions().timeZone : 'elsewhere'",
@@ -17508,7 +17508,7 @@
           }
         }
       },
-      "live": "the runner's own CDP sees {target}'s document load (title, marker or URL), or the guard returned its refusal for a refusable step",
+      "live": "the runner's own CDP sees {target}'s document load (title, marker or URL), or the guard returned its refusal for a refusable step; Chrome's trusted-client-only refusal of Emulation.setTimezoneOverride on the ordinary control is not-supported:trustedEmulation",
       "control": {
         "origin": "ordinary",
         "via": "guard",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-browsers",
-  "version": "1.19.0",
+  "version": "1.19.2",
   "description": "SLICC's shared browser catalog, JSON schemas and discovery conformance corpus",
   "type": "module",
   "license": "Apache-2.0",
@@ -71,7 +71,7 @@
     "validate": "node scripts/validate.mjs",
     "lint": "slicc-lint && test -z \"$(gofmt -l .)\" && go mod tidy -diff && go vet ./... && GOOS=darwin go vet ./... && GOOS=windows go vet ./... && golangci-lint run && cargo fmt --check && cargo clippy --all-features --all-targets -- -D warnings && cargo check --target wasm32-wasip1 --no-default-features && cargo check --target wasm32-wasip1 --features serde && cargo check --target wasm32-wasip1 --all-features",
     "format": "biome check --write . && gofmt -w . && cargo fmt",
-    "test": "export PATH=\"$HOME/.cargo/bin:$PATH\" && node --test --test-concurrency=1 test/integration/debugger-stage1-packaging.test.mjs test/integration/debugger-raw-control.test.mjs test/integration/debugger-cleanup.test.mjs test/integration/debugger-stage1-install-vectors.test.mjs test/integration/protected-premise.test.mjs test/integration/debugger-stage1-vectors.test.mjs test/integration/self-contained.test.mjs test/integration/seven-corpus.test.mjs test/integration/browser-runner.test.mjs test/integration/fixture-client.test.mjs test/integration/guard-redirect-carrier.test.mjs test/integration/guard-redirect-session-end.test.mjs test/integration/guard-redirect-history.test.mjs test/integration/guard-redirect-iframe.test.mjs test/integration/guard-incomplete.test.mjs test/integration/guard-unparseable-wipe.test.mjs test/integration/guard-browser-ui.test.mjs test/integration/guard-snapshot-settle.test.mjs test/integration/guard-stall.test.mjs test/integration/guard-forged.test.mjs test/integration/guard-exit-steps.test.mjs test/integration/guard-exit-refusal.test.mjs test/integration/guard-frame-read.test.mjs test/integration/guard-bfcache.test.mjs test/integration/guard-bfcache-marker.test.mjs test/integration/guard-bfcache-history.test.mjs test/integration/guard-bfcache-review.test.mjs test/integration/guard-bfcache-quarantine.test.mjs test/integration/guard-error-page-navigation.test.mjs test/integration/guard-error-page-events.test.mjs test/integration/guard-error-page-reload.test.mjs test/integration/guard-world-paint.test.mjs test/integration/gates.test.mjs test/integration/validate.test.mjs test/integration/go.test.mjs test/integration/cargo.test.mjs test/integration/workflows.test.mjs test/integration/guard-sweep-union.test.mjs && node --test --test-concurrency=2 test/integration/guard-lifecycle.test.mjs test/integration/chromium-launch.test.mjs test/integration/guard-fit.test.mjs test/integration/guard-chain.test.mjs test/integration/guard-validation.test.mjs test/integration/guard-liveness.test.mjs test/integration/guard-observations.test.mjs test/integration/guard-child-latency.test.mjs test/integration/guard-adoption.test.mjs test/integration/guard-scoping.test.mjs test/integration/guard-late-pause.test.mjs test/integration/guard-legs.test.mjs test/integration/guard-fetch-enable.test.mjs test/integration/guard-diagnostics.test.mjs test/integration/guard-chrome.test.mjs test/integration/guard-worlds.test.mjs test/integration/guard-world-discovery.test.mjs test/integration/guard-world-guesses.test.mjs test/integration/guard-unparseable.test.mjs test/integration/guard-redirect-secret.test.mjs test/integration/guard-error-page.test.mjs test/integration/guard-discovery.test.mjs test/integration/guard-bfcache-chrome.test.mjs test/integration/guard-browser-page.test.mjs test/integration/guard-scales.test.mjs test/integration/guard-shared-log.test.mjs test/integration/guard-pre-beacon.test.mjs test/integration/guard-world-pause.test.mjs test/integration/guard-parallel.test.mjs test/integration/guard-client-exit.test.mjs test/integration/guard-runner.test.mjs test/integration/guard-sweep-ordinary.test.mjs test/integration/guard-sweep-seven.test.mjs test/integration/guard-sweep-vault.test.mjs test/integration/guard-sweep-vault-x.test.mjs test/integration/guard-sweep-apex.test.mjs test/integration/guard-sweep-others.test.mjs",
+    "test": "export PATH=\"$HOME/.cargo/bin:$PATH\" && node --test --test-concurrency=1 test/integration/debugger-stage1-packaging.test.mjs test/integration/debugger-raw-control.test.mjs test/integration/debugger-cleanup.test.mjs test/integration/debugger-stage1-install-vectors.test.mjs test/integration/protected-premise.test.mjs test/integration/debugger-stage1-vectors.test.mjs test/integration/self-contained.test.mjs test/integration/seven-corpus.test.mjs test/integration/browser-runner.test.mjs test/integration/fixture-client.test.mjs test/integration/guard-redirect-carrier.test.mjs test/integration/guard-redirect-session-end.test.mjs test/integration/guard-redirect-history.test.mjs test/integration/guard-redirect-iframe.test.mjs test/integration/guard-incomplete.test.mjs test/integration/guard-unparseable-wipe.test.mjs test/integration/guard-browser-ui.test.mjs test/integration/guard-snapshot-settle.test.mjs test/integration/guard-stall.test.mjs test/integration/guard-forged.test.mjs test/integration/guard-trusted-emulation.test.mjs test/integration/guard-exit-steps.test.mjs test/integration/guard-exit-refusal.test.mjs test/integration/guard-frame-read.test.mjs test/integration/guard-bfcache.test.mjs test/integration/guard-bfcache-marker.test.mjs test/integration/guard-bfcache-history.test.mjs test/integration/guard-bfcache-review.test.mjs test/integration/guard-bfcache-quarantine.test.mjs test/integration/guard-error-page-navigation.test.mjs test/integration/guard-error-page-events.test.mjs test/integration/guard-error-page-reload.test.mjs test/integration/guard-world-paint.test.mjs test/integration/gates.test.mjs test/integration/validate.test.mjs test/integration/go.test.mjs test/integration/cargo.test.mjs test/integration/workflows.test.mjs test/integration/guard-sweep-union.test.mjs && node --test --test-concurrency=2 test/integration/guard-lifecycle.test.mjs test/integration/chromium-launch.test.mjs test/integration/guard-fit.test.mjs test/integration/guard-chain.test.mjs test/integration/guard-validation.test.mjs test/integration/guard-liveness.test.mjs test/integration/guard-observations.test.mjs test/integration/guard-child-latency.test.mjs test/integration/guard-adoption.test.mjs test/integration/guard-scoping.test.mjs test/integration/guard-late-pause.test.mjs test/integration/guard-legs.test.mjs test/integration/guard-fetch-enable.test.mjs test/integration/guard-diagnostics.test.mjs test/integration/guard-chrome.test.mjs test/integration/guard-worlds.test.mjs test/integration/guard-world-discovery.test.mjs test/integration/guard-world-guesses.test.mjs test/integration/guard-unparseable.test.mjs test/integration/guard-redirect-secret.test.mjs test/integration/guard-error-page.test.mjs test/integration/guard-discovery.test.mjs test/integration/guard-bfcache-chrome.test.mjs test/integration/guard-browser-page.test.mjs test/integration/guard-scales.test.mjs test/integration/guard-shared-log.test.mjs test/integration/guard-pre-beacon.test.mjs test/integration/guard-world-pause.test.mjs test/integration/guard-parallel.test.mjs test/integration/guard-client-exit.test.mjs test/integration/guard-runner.test.mjs test/integration/guard-sweep-ordinary.test.mjs test/integration/guard-sweep-seven.test.mjs test/integration/guard-sweep-vault.test.mjs test/integration/guard-sweep-vault-x.test.mjs test/integration/guard-sweep-apex.test.mjs test/integration/guard-sweep-others.test.mjs",
     "test:unit": "mkdir -p coverage/unit && node --experimental-test-coverage --test --test-concurrency=1 --test-reporter=lcov --test-reporter-destination=coverage/unit/lcov.info test/unit/*.test.mjs && go test -race -cover ./...",
     "build": "go build ./... && cargo build --all-features && cargo build --target wasm32-wasip1 --all-features && npm pack --dry-run",
     "prepublishOnly": "node scripts/set-crate-version.mjs \"$npm_package_version\"",
@@ -82,8 +82,8 @@
     "test:unit:guard": "mkdir -p coverage/unit && node --experimental-vm-modules --no-warnings --experimental-test-coverage --test --test-concurrency=1 --test-coverage-include=guard-runner.mjs --test-coverage-include=guard-driver.mjs --test-coverage-include=fixture-server.mjs --test-coverage-include=fixture-client.mjs --test-coverage-include=observer-target.mjs --test-coverage-include=frame-read.mjs --test-coverage-include=bfcache-restore.mjs --test-coverage-include=protected-error-page.mjs --test-coverage-include=unparseable-url.mjs --test-coverage-include=scripts/browser-runner.mjs --test-coverage-include=scripts/validate.mjs --test-reporter=lcov --test-reporter-destination=coverage/unit/guard.lcov test/unit/guard-*.test.mjs && slicc-diff-cover coverage/unit/guard.lcov"
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-cdp": "1.44.3",
-    "@ai-ecoverse/slicc-shared-web": "2.13.9",
+    "@ai-ecoverse/slicc-cdp": "1.45.0",
+    "@ai-ecoverse/slicc-shared-web": "2.13.10",
     "@biomejs/biome": "2.6.3",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",