@vzn/vx-reapi 0.0.644 → 0.0.646

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 vx contributors
+Copyright (c) 2026 VZN
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -8,7 +8,7 @@ BuildBuddy, Buildbarn, bazel-remote: mature server implementations, none of
 which we had to write, because a REAPI server is deliberately dumb.
 
 ```sh
-npm install -D @vzn/vx @vzn/vx-reapi   # or: pnpm add -D -w · yarn add -D (-W on Yarn 1) · bun add -d
+bun add -d @vzn/vx @vzn/vx-reapi
 ```
 
 ```ts
@@ -344,20 +344,15 @@ without its inputs and caches the result.
 
 ## Tests
 
-`bun test` runs the unit suite anywhere. The round-trip suite needs a real
-server:
+`bun test` runs the unit suite anywhere. The round-trip suites need real
+servers, which `vx run test.live --filter @vzn/vx-reapi` brings with Docker:
+`services.cache` (bazel-remote on `:19092`) and `services.exec` (NativeLink on
+`:51051`) run in the foreground until the run ends. CI runs it in the Linux
+distributed run, where they start on the agent that runs `test.live`.
 
-```sh
-docker run -d -p 19092:9092 buchgr/bazel-remote-cache:latest \
-  --dir /data --max_size 1 --grpc_address 0.0.0.0:9092 --http_address 0.0.0.0:8080
-
-VX_REAPI_TEST_ENDPOINT=grpc://127.0.0.1:19092 bun test
-```
-
-Without an endpoint those tests skip; CI sets `VX_REQUIRE_REAPI=1`, which turns
-an absent endpoint into a failure so the suite cannot silently vanish. The
-remote-execution suites need an execution server in `VX_REAPI_EXEC_ENDPOINT`;
-CI sets it with `VX_REQUIRE_REAPI_EXEC=1`.
+Without an endpoint those tests skip; `test.live` sets `VX_REQUIRE_REAPI=1` and
+`VX_REQUIRE_REAPI_EXEC=1`, which turn an absent endpoint into a failure so the
+suites cannot silently vanish.
 
 ## Protocol coverage
 
@@ -443,8 +438,8 @@ the packages a build needs. The answer is the design doc's §7.4 recipe,
 
 ```ts
 install: {
-  exec: { command: 'pnpm install --frozen-lockfile', remote: 'only' },
-  inputs: { files: ['package.json', 'pnpm-lock.yaml'] },
+  exec: { command: 'bun install --frozen-lockfile', remote: 'only' },
+  inputs: { files: ['package.json', 'bun.lock'] },
   cache: {
     outputs: { files: ['node_modules/**'] },
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx-reapi",
-  "version": "0.0.644",
+  "version": "0.0.646",
   "license": "MIT",
   "description": "Bazel Remote Execution API plugin for vx — remote cache (ActionCache + CAS) against NativeLink, BuildBuddy, Buildbarn or bazel-remote.",
   "keywords": [
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@vzn/vx": "^0.0.644"
+    "@vzn/vx": "^0.0.646"
   },
   "repository": {
     "type": "git",

package/src/cache.ts

@@ -96,12 +96,18 @@ export class ReapiRemoteCache {
    * hit vs miss. Costs one extra round trip, and only for a PREDICTED HIT:
    * a miss still answers in one call.
    */
-  async has(hash: string): Promise<boolean> {
+  async has(hash: string): Promise<{ size: number; durationMs?: number } | null> {
     const result = await this.client.getActionResult(actionDigestFor(hash))
-    if (result === null) return false
+    if (result === null) return null
     const file = result.output_files?.find((f) => f.path === ARTIFACT_PATH)
-    if (file === undefined) return false
-    return (await this.client.findMissingBlobs([file.digest])).length === 0
+    if (file === undefined) return null
+    if ((await this.client.findMissingBlobs([file.digest])).length > 0) return null
+    // The duration only when it rode inline: a CAS read for it is a round trip.
+    const durationMs = decodeDuration(result.stdout_raw)
+    return {
+      size: Number(file.digest.size_bytes),
+      ...(durationMs === undefined ? {} : { durationMs }),
+    }
   }
 
   /**