@cryptexlabs/codex-nodejs-common 0.16.4 → 0.16.6

package/WARP.md

@@ -0,0 +1,28 @@
+# WARP.md
+
+This file provides guidance to WARP (warp.dev) when working with code in this repository.
+
+## Commands
+- Use Node `20.11.1` from `.nvmrc` (`nvm use`).
+- Install deps: `yarn install` (postinstall runs `install-peers` to align peer deps).
+- Lint: `yarn lint`; format check/fix: `yarn prettier`, `yarn prettier:fix`.
+- Tests: `yarn test`; single test: `yarn test --testPathPattern=src/auth/authf.guard.spec.ts`; watch: `yarn test --watch`; coverage: `yarn test --coverage`.
+- Build: `yarn build` (cleans `lib/src`, emits CJS + d.ts to `lib/src`); clean: `yarn clean`.
+- Husky pre-commit runs prettier → lint → test → build; expect the hook to be slow on cold installs.
+
+## Repository structure & architecture
+- TypeScript library compiled to `lib/src`; entry point is `src/index.ts` exporting modules for auth, config, context, logging, messaging, middleware, services, and utilities.
+- Configuration core (`src/config`): `DefaultConfig` loads `.env` plus YAML config (`config/server.yaml`, `SERVER_CONFIG_PATH`, or `SERVER_CONFIG_PATTERN`), merges with `merge-anything`, and optionally hot-reloads via filesystem watchers (`SERVER_CONFIG_HOT_RELOAD`). Exposes typed configs for Kafka, JWT, Redis, SQL, telemetry, logging, metrics, pagination, and xray; DI token `"CONFIG"` is consumed across guards/services and also supplies client identity fields (`appName`, `appVersion`, `environmentName`, `clientId`).
+- Context & logging (`src/context`, `src/logger`, `src/message`): `ContextBuilder` assembles per-request `Context` with correlation ID, locale (`src/locales`), client info via `ServiceClient`, and `MessageMeta` creation. Logging flows through `ContextLogger` and `CustomLogger`, which wrap NestJS `Logger` with context filtering and correlation metadata. `JsonSerializableInterface` standardizes serialization for config- and client-aware objects.
+- Authentication/authorization (`src/auth`): `AuthfGuard` (Nest `CanActivate`) validates JWTs against the Authf service by periodically refreshing JWK→PEM keys and polling a subject blacklist; HTTP authz helpers manage attach/detach/list object relations. Includes authenticator interfaces and a `FakeAuthenticator` for tests. Guard toggles respect `DefaultConfig.authEnabled` and `authfUrl`.
+- Services layer (`src/service`): reusable infrastructure blocks—`kafka` (producer/consumer wrapper, logger, replay support, stubs), `consumer` (delegate interfaces, WebSocket consumer, helper utils), `elasticsearch` (initializer, pinger, health checks), `healthz` (component registry and aggregator), plus socket/data abstractions.
+- HTTP integration (`src/middleware`, `src/filter`, `src/pipe`, `src/exception`, `src/response`, `src/result`): middleware for API header validation and query authorization; exception/filters adapt domain errors to HTTP responses; pipes/validators; response helpers for uniform REST payloads including meta/pagination (`rest.response`, `rest.paginated.response`, interceptors) with pagination helpers in `src/result`.
+- Internationalization (`src/locales`): default `en-US` strings plus language/country enums; leveraged by `Context`/`MessageMeta` to stamp locale-aware metadata.
+
+## Testing notes
+- Jest config lives in `package.json` (rootDir `src`, `*.spec.ts`, `ts-jest`). Specs sit beside sources (e.g., `src/auth/http-authz.*.spec.ts`, `src/service/healthz/healthz.service.spec.ts`). `tsconfig.json` excludes specs from the build output.
+- Tests commonly mock collaborators with `ts-mockito`; follow existing patterns when adding new specs.
+
+## Misc
+- Module resolution base is `src` (tsconfig `baseUrl`), so prefer absolute imports from the repo root over long relative paths.
+- Build artifacts (`lib/src`) provide both JS and d.ts; `package.json` `main`/`types` point there, so run `yarn build` before publishing or linking locally.

package/coverage/clover.xml

@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<coverage generated="1769081976865" clover="3.2.0">
+  <project timestamp="1769081976865" name="All files">
+    <metrics statements="84" coveredstatements="84" conditionals="24" coveredconditionals="24" methods="17" coveredmethods="17" elements="125" coveredelements="125" complexity="0" loc="84" ncloc="84" packages="2" files="2" classes="2"/>
+    <package name="client">
+      <metrics statements="5" coveredstatements="5" conditionals="0" coveredconditionals="0" methods="1" coveredmethods="1"/>
+      <file name="client.ts" path="/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/client/client.ts">
+        <metrics statements="5" coveredstatements="5" conditionals="0" coveredconditionals="0" methods="1" coveredmethods="1"/>
+        <line num="3" count="3" type="stmt"/>
+        <line num="7" count="1" type="stmt"/>
+        <line num="8" count="1" type="stmt"/>
+        <line num="9" count="1" type="stmt"/>
+        <line num="10" count="1" type="stmt"/>
+      </file>
+    </package>
+    <package name="context">
+      <metrics statements="79" coveredstatements="79" conditionals="24" coveredconditionals="24" methods="16" coveredmethods="16"/>
+      <file name="context.builder.ts" path="/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/context/context.builder.ts">
+        <metrics statements="79" coveredstatements="79" conditionals="24" coveredconditionals="24" methods="16" coveredmethods="16"/>
+        <line num="1" count="2" type="stmt"/>
+        <line num="2" count="2" type="stmt"/>
+        <line num="11" count="2" type="stmt"/>
+        <line num="12" count="2" type="stmt"/>
+        <line num="13" count="2" type="stmt"/>
+        <line num="14" count="2" type="stmt"/>
+        <line num="15" count="2" type="stmt"/>
+        <line num="18" count="2" type="stmt"/>
+        <line num="27" count="11" type="stmt"/>
+        <line num="28" count="11" type="stmt"/>
+        <line num="29" count="11" type="stmt"/>
+        <line num="30" count="11" type="stmt"/>
+        <line num="31" count="11" type="stmt"/>
+        <line num="35" count="3" type="cond" truecount="1" falsecount="0"/>
+        <line num="36" count="1" type="stmt"/>
+        <line num="38" count="2" type="stmt"/>
+        <line num="42" count="2" type="stmt"/>
+        <line num="46" count="1" type="stmt"/>
+        <line num="65" count="1" type="stmt"/>
+        <line num="66" count="1" type="stmt"/>
+        <line num="72" count="2" type="stmt"/>
+        <line num="73" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="74" count="2" type="stmt"/>
+        <line num="76" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="77" count="2" type="stmt"/>
+        <line num="79" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="80" count="2" type="stmt"/>
+        <line num="82" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="83" count="2" type="stmt"/>
+        <line num="86" count="2" type="cond" truecount="2" falsecount="0"/>
+        <line num="88" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="89" count="1" type="stmt"/>
+        <line num="91" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="92" count="1" type="stmt"/>
+        <line num="94" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="95" count="1" type="stmt"/>
+        <line num="97" count="2" type="cond" truecount="1" falsecount="0"/>
+        <line num="98" count="1" type="stmt"/>
+        <line num="101" count="2" type="stmt"/>
+        <line num="107" count="3" type="stmt"/>
+        <line num="108" count="3" type="stmt"/>
+        <line num="109" count="3" type="stmt"/>
+        <line num="110" count="3" type="cond" truecount="1" falsecount="0"/>
+        <line num="111" count="3" type="stmt"/>
+        <line num="113" count="3" type="cond" truecount="1" falsecount="0"/>
+        <line num="114" count="3" type="stmt"/>
+        <line num="116" count="3" type="cond" truecount="1" falsecount="0"/>
+        <line num="117" count="2" type="stmt"/>
+        <line num="119" count="3" type="stmt"/>
+        <line num="123" count="1" type="stmt"/>
+        <line num="124" count="1" type="stmt"/>
+        <line num="125" count="1" type="stmt"/>
+        <line num="126" count="1" type="stmt"/>
+        <line num="127" count="1" type="stmt"/>
+        <line num="128" count="1" type="stmt"/>
+        <line num="132" count="1" type="stmt"/>
+        <line num="133" count="1" type="stmt"/>
+        <line num="134" count="1" type="stmt"/>
+        <line num="135" count="1" type="stmt"/>
+        <line num="139" count="6" type="stmt"/>
+        <line num="140" count="6" type="stmt"/>
+        <line num="144" count="6" type="stmt"/>
+        <line num="145" count="6" type="stmt"/>
+        <line num="149" count="6" type="cond" truecount="2" falsecount="0"/>
+        <line num="150" count="5" type="stmt"/>
+        <line num="152" count="1" type="stmt"/>
+        <line num="154" count="6" type="stmt"/>
+        <line num="158" count="11" type="cond" truecount="2" falsecount="0"/>
+        <line num="162" count="11" type="cond" truecount="2" falsecount="0"/>
+        <line num="166" count="22" type="cond" truecount="2" falsecount="0"/>
+        <line num="170" count="11" type="stmt"/>
+        <line num="171" count="11" type="stmt"/>
+        <line num="172" count="11" type="stmt"/>
+        <line num="178" count="11" type="stmt"/>
+        <line num="190" count="11" type="cond" truecount="1" falsecount="0"/>
+        <line num="191" count="2" type="stmt"/>
+        <line num="194" count="11" type="cond" truecount="1" falsecount="0"/>
+        <line num="195" count="1" type="stmt"/>
+        <line num="198" count="11" type="stmt"/>
+      </file>
+    </package>
+  </project>
+</coverage>

package/coverage/coverage-final.json

@@ -0,0 +1,3 @@
+{"/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/client/client.ts": {"path":"/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/client/client.ts","statementMap":{"0":{"start":{"line":7,"column":20},"end":{"line":7,"column":30}},"1":{"start":{"line":8,"column":20},"end":{"line":8,"column":35}},"2":{"start":{"line":9,"column":20},"end":{"line":9,"column":32}},"3":{"start":{"line":10,"column":20},"end":{"line":10,"column":35}},"4":{"start":{"line":3,"column":0},"end":{"line":3,"column":13}}},"fnMap":{"0":{"name":"(anonymous_0)","decl":{"start":{"line":6,"column":2},"end":{"line":6,"column":null}},"loc":{"start":{"line":10,"column":35},"end":{"line":11,"column":6}}}},"branchMap":{},"s":{"0":1,"1":1,"2":1,"3":1,"4":3},"f":{"0":1},"b":{}}
+,"/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/context/context.builder.ts": {"path":"/Users/b.woodcock/Projects/OpenSource/CryptexLabs/codex-nodejs-common/src/context/context.builder.ts","statementMap":{"0":{"start":{"line":1,"column":0},"end":{"line":1,"column":59}},"1":{"start":{"line":2,"column":0},"end":{"line":2,"column":null}},"2":{"start":{"line":11,"column":0},"end":{"line":11,"column":42}},"3":{"start":{"line":12,"column":0},"end":{"line":12,"column":36}},"4":{"start":{"line":13,"column":0},"end":{"line":13,"column":36}},"5":{"start":{"line":14,"column":0},"end":{"line":14,"column":37}},"6":{"start":{"line":15,"column":0},"end":{"line":15,"column":28}},"7":{"start":{"line":18,"column":27},"end":{"line":200,"column":null}},"8":{"start":{"line":27,"column":21},"end":{"line":27,"column":42}},"9":{"start":{"line":28,"column":21},"end":{"line":28,"column":29}},"10":{"start":{"line":29,"column":11},"end":{"line":29,"column":19}},"11":{"start":{"line":30,"column":21},"end":{"line":30,"column":60}},"12":{"start":{"line":31,"column":12},"end":{"line":31,"column":30}},"13":{"start":{"line":35,"column":4},"end":{"line":37,"column":5}},"14":{"start":{"line":36,"column":6},"end":{"line":36,"column":23}},"15":{"start":{"line":38,"column":4},"end":{"line":38,"column":22}},"16":{"start":{"line":42,"column":4},"end":{"line":42,"column":20}},"17":{"start":{"line":46,"column":4},"end":{"line":61,"column":6}},"18":{"start":{"line":65,"column":4},"end":{"line":65,"column":29}},"19":{"start":{"line":66,"column":4},"end":{"line":66,"column":16}},"20":{"start":{"line":72,"column":4},"end":{"line":72,"column":50}},"21":{"start":{"line":73,"column":4},"end":{"line":75,"column":5}},"22":{"start":{"line":74,"column":6},"end":{"line":74,"column":56}},"23":{"start":{"line":76,"column":4},"end":{"line":78,"column":5}},"24":{"start":{"line":77,"column":6},"end":{"line":77,"column":46}},"25":{"start":{"line":79,"column":4},"end":{"line":81,"column":5}},"26":{"start":{"line":80,"column":6},"end":{"line":80,"column":50}},"27":{"start":{"line":82,"column":4},"end":{"line":84,"column":5}},"28":{"start":{"line":83,"column":6},"end":{"line":83,"column":56}},"29":{"start":{"line":86,"column":6},"end":{"line":87,"column":78}},"30":{"start":{"line":88,"column":4},"end":{"line":90,"column":5}},"31":{"start":{"line":89,"column":6},"end":{"line":89,"column":36}},"32":{"start":{"line":91,"column":4},"end":{"line":93,"column":5}},"33":{"start":{"line":92,"column":6},"end":{"line":92,"column":46}},"34":{"start":{"line":94,"column":4},"end":{"line":96,"column":5}},"35":{"start":{"line":95,"column":6},"end":{"line":95,"column":45}},"36":{"start":{"line":97,"column":4},"end":{"line":99,"column":5}},"37":{"start":{"line":98,"column":6},"end":{"line":98,"column":45}},"38":{"start":{"line":101,"column":4},"end":{"line":101,"column":16}},"39":{"start":{"line":107,"column":4},"end":{"line":107,"column":55}},"40":{"start":{"line":108,"column":4},"end":{"line":108,"column":79}},"41":{"start":{"line":109,"column":4},"end":{"line":109,"column":42}},"42":{"start":{"line":110,"column":4},"end":{"line":112,"column":5}},"43":{"start":{"line":111,"column":6},"end":{"line":111,"column":67}},"44":{"start":{"line":113,"column":4},"end":{"line":115,"column":5}},"45":{"start":{"line":114,"column":6},"end":{"line":114,"column":55}},"46":{"start":{"line":116,"column":4},"end":{"line":118,"column":5}},"47":{"start":{"line":117,"column":6},"end":{"line":117,"column":46}},"48":{"start":{"line":119,"column":4},"end":{"line":119,"column":16}},"49":{"start":{"line":123,"column":4},"end":{"line":123,"column":49}},"50":{"start":{"line":124,"column":4},"end":{"line":124,"column":35}},"51":{"start":{"line":125,"column":4},"end":{"line":125,"column":37}},"52":{"start":{"line":126,"column":4},"end":{"line":126,"column":67}},"53":{"start":{"line":127,"column":4},"end":{"line":127,"column":55}},"54":{"start":{"line":128,"column":4},"end":{"line":128,"column":16}},"55":{"start":{"line":132,"column":4},"end":{"line":132,"column":46}},"56":{"start":{"line":133,"column":4},"end":{"line":133,"column":74}},"57":{"start":{"line":134,"column":4},"end":{"line":134,"column":39}},"58":{"start":{"line":135,"column":4},"end":{"line":135,"column":16}},"59":{"start":{"line":139,"column":4},"end":{"line":139,"column":39}},"60":{"start":{"line":140,"column":4},"end":{"line":140,"column":16}},"61":{"start":{"line":144,"column":4},"end":{"line":144,"column":62}},"62":{"start":{"line":145,"column":4},"end":{"line":145,"column":16}},"63":{"start":{"line":149,"column":4},"end":{"line":153,"column":5}},"64":{"start":{"line":150,"column":6},"end":{"line":150,"column":36}},"65":{"start":{"line":152,"column":6},"end":{"line":152,"column":26}},"66":{"start":{"line":154,"column":4},"end":{"line":154,"column":16}},"67":{"start":{"line":158,"column":4},"end":{"line":158,"column":38}},"68":{"start":{"line":162,"column":4},"end":{"line":162,"column":42}},"69":{"start":{"line":166,"column":4},"end":{"line":166,"column":49}},"70":{"start":{"line":170,"column":25},"end":{"line":170,"column":35}},"71":{"start":{"line":171,"column":18},"end":{"line":171,"column":35}},"72":{"start":{"line":172,"column":4},"end":{"line":176,"column":7}},"73":{"start":{"line":178,"column":20},"end":{"line":187,"column":null}},"74":{"start":{"line":190,"column":4},"end":{"line":192,"column":5}},"75":{"start":{"line":191,"column":6},"end":{"line":191,"column":32}},"76":{"start":{"line":194,"column":4},"end":{"line":196,"column":5}},"77":{"start":{"line":195,"column":6},"end":{"line":195,"column":42}},"78":{"start":{"line":198,"column":4},"end":{"line":198,"column":19}},"79":{"start":{"line":18,"column":13},"end":{"line":18,"column":27}},"80":{"start":{"line":18,"column":13},"end":{"line":200,"column":null}}},"fnMap":{"0":{"name":"(anonymous_2)","decl":{"start":{"line":26,"column":2},"end":{"line":26,"column":null}},"loc":{"start":{"line":31,"column":30},"end":{"line":32,"column":6}}},"1":{"name":"(anonymous_3)","decl":{"start":{"line":34,"column":9},"end":{"line":34,"column":12}},"loc":{"start":{"line":34,"column":12},"end":{"line":39,"column":3}}},"2":{"name":"(anonymous_4)","decl":{"start":{"line":41,"column":9},"end":{"line":41,"column":15}},"loc":{"start":{"line":41,"column":25},"end":{"line":43,"column":3}}},"3":{"name":"(anonymous_5)","decl":{"start":{"line":45,"column":9},"end":{"line":45,"column":14}},"loc":{"start":{"line":45,"column":14},"end":{"line":62,"column":3}}},"4":{"name":"(anonymous_6)","decl":{"start":{"line":64,"column":9},"end":{"line":64,"column":20}},"loc":{"start":{"line":64,"column":38},"end":{"line":67,"column":3}}},"5":{"name":"(anonymous_7)","decl":{"start":{"line":69,"column":9},"end":{"line":69,"column":27}},"loc":{"start":{"line":70,"column":69},"end":{"line":102,"column":3}}},"6":{"name":"(anonymous_8)","decl":{"start":{"line":104,"column":9},"end":{"line":104,"column":40}},"loc":{"start":{"line":105,"column":69},"end":{"line":120,"column":3}}},"7":{"name":"(anonymous_9)","decl":{"start":{"line":122,"column":9},"end":{"line":122,"column":27}},"loc":{"start":{"line":122,"column":44},"end":{"line":129,"column":3}}},"8":{"name":"(anonymous_10)","decl":{"start":{"line":131,"column":9},"end":{"line":131,"column":16}},"loc":{"start":{"line":131,"column":43},"end":{"line":136,"column":3}}},"9":{"name":"(anonymous_11)","decl":{"start":{"line":138,"column":9},"end":{"line":138,"column":25}},"loc":{"start":{"line":138,"column":47},"end":{"line":141,"column":3}}},"10":{"name":"(anonymous_12)","decl":{"start":{"line":143,"column":9},"end":{"line":143,"column":18}},"loc":{"start":{"line":143,"column":42},"end":{"line":146,"column":3}}},"11":{"name":"(anonymous_13)","decl":{"start":{"line":148,"column":9},"end":{"line":148,"column":19}},"loc":{"start":{"line":148,"column":39},"end":{"line":155,"column":3}}},"12":{"name":"(anonymous_14)","decl":{"start":{"line":157,"column":10},"end":{"line":157,"column":21}},"loc":{"start":{"line":157,"column":21},"end":{"line":159,"column":3}}},"13":{"name":"(anonymous_15)","decl":{"start":{"line":161,"column":10},"end":{"line":161,"column":27}},"loc":{"start":{"line":161,"column":27},"end":{"line":163,"column":3}}},"14":{"name":"(anonymous_16)","decl":{"start":{"line":165,"column":10},"end":{"line":165,"column":20}},"loc":{"start":{"line":165,"column":20},"end":{"line":167,"column":3}}},"15":{"name":"(anonymous_17)","decl":{"start":{"line":169,"column":9},"end":{"line":169,"column":18}},"loc":{"start":{"line":169,"column":18},"end":{"line":199,"column":3}}}},"branchMap":{"0":{"loc":{"start":{"line":35,"column":4},"end":{"line":37,"column":5}},"type":"if","locations":[{"start":{"line":35,"column":4},"end":{"line":37,"column":5}}]},"1":{"loc":{"start":{"line":73,"column":4},"end":{"line":75,"column":5}},"type":"if","locations":[{"start":{"line":73,"column":4},"end":{"line":75,"column":5}}]},"2":{"loc":{"start":{"line":76,"column":4},"end":{"line":78,"column":5}},"type":"if","locations":[{"start":{"line":76,"column":4},"end":{"line":78,"column":5}}]},"3":{"loc":{"start":{"line":79,"column":4},"end":{"line":81,"column":5}},"type":"if","locations":[{"start":{"line":79,"column":4},"end":{"line":81,"column":5}}]},"4":{"loc":{"start":{"line":82,"column":4},"end":{"line":84,"column":5}},"type":"if","locations":[{"start":{"line":82,"column":4},"end":{"line":84,"column":5}}]},"5":{"loc":{"start":{"line":86,"column":6},"end":{"line":87,"column":78}},"type":"binary-expr","locations":[{"start":{"line":86,"column":6},"end":{"line":86,"column":27}},{"start":{"line":87,"column":7},"end":{"line":87,"column":78}}]},"6":{"loc":{"start":{"line":88,"column":4},"end":{"line":90,"column":5}},"type":"if","locations":[{"start":{"line":88,"column":4},"end":{"line":90,"column":5}}]},"7":{"loc":{"start":{"line":91,"column":4},"end":{"line":93,"column":5}},"type":"if","locations":[{"start":{"line":91,"column":4},"end":{"line":93,"column":5}}]},"8":{"loc":{"start":{"line":94,"column":4},"end":{"line":96,"column":5}},"type":"if","locations":[{"start":{"line":94,"column":4},"end":{"line":96,"column":5}}]},"9":{"loc":{"start":{"line":97,"column":4},"end":{"line":99,"column":5}},"type":"if","locations":[{"start":{"line":97,"column":4},"end":{"line":99,"column":5}}]},"10":{"loc":{"start":{"line":110,"column":4},"end":{"line":112,"column":5}},"type":"if","locations":[{"start":{"line":110,"column":4},"end":{"line":112,"column":5}}]},"11":{"loc":{"start":{"line":113,"column":4},"end":{"line":115,"column":5}},"type":"if","locations":[{"start":{"line":113,"column":4},"end":{"line":115,"column":5}}]},"12":{"loc":{"start":{"line":116,"column":4},"end":{"line":118,"column":5}},"type":"if","locations":[{"start":{"line":116,"column":4},"end":{"line":118,"column":5}}]},"13":{"loc":{"start":{"line":149,"column":4},"end":{"line":153,"column":5}},"type":"if","locations":[{"start":{"line":149,"column":4},"end":{"line":153,"column":5}},{"start":{"line":151,"column":11},"end":{"line":153,"column":5}}]},"14":{"loc":{"start":{"line":158,"column":11},"end":{"line":158,"column":37}},"type":"binary-expr","locations":[{"start":{"line":158,"column":11},"end":{"line":158,"column":23}},{"start":{"line":158,"column":27},"end":{"line":158,"column":37}}]},"15":{"loc":{"start":{"line":162,"column":11},"end":{"line":162,"column":41}},"type":"binary-expr","locations":[{"start":{"line":162,"column":11},"end":{"line":162,"column":29}},{"start":{"line":162,"column":33},"end":{"line":162,"column":41}}]},"16":{"loc":{"start":{"line":166,"column":11},"end":{"line":166,"column":48}},"type":"binary-expr","locations":[{"start":{"line":166,"column":11},"end":{"line":166,"column":22}},{"start":{"line":166,"column":26},"end":{"line":166,"column":48}}]},"17":{"loc":{"start":{"line":190,"column":4},"end":{"line":192,"column":5}},"type":"if","locations":[{"start":{"line":190,"column":4},"end":{"line":192,"column":5}}]},"18":{"loc":{"start":{"line":194,"column":4},"end":{"line":196,"column":5}},"type":"if","locations":[{"start":{"line":194,"column":4},"end":{"line":196,"column":5}}]}},"s":{"0":2,"1":2,"2":2,"3":2,"4":2,"5":2,"6":2,"7":2,"8":11,"9":11,"10":11,"11":11,"12":11,"13":3,"14":1,"15":2,"16":2,"17":1,"18":1,"19":1,"20":2,"21":2,"22":2,"23":2,"24":2,"25":2,"26":2,"27":2,"28":2,"29":2,"30":2,"31":1,"32":2,"33":1,"34":2,"35":1,"36":2,"37":1,"38":2,"39":3,"40":3,"41":3,"42":3,"43":3,"44":3,"45":3,"46":3,"47":2,"48":3,"49":1,"50":1,"51":1,"52":1,"53":1,"54":1,"55":1,"56":1,"57":1,"58":1,"59":6,"60":6,"61":6,"62":6,"63":6,"64":5,"65":1,"66":6,"67":11,"68":11,"69":22,"70":11,"71":11,"72":11,"73":11,"74":11,"75":2,"76":11,"77":1,"78":11,"79":2,"80":2},"f":{"0":11,"1":3,"2":2,"3":1,"4":1,"5":2,"6":3,"7":1,"8":1,"9":6,"10":6,"11":6,"12":11,"13":11,"14":22,"15":11},"b":{"0":[1],"1":[2],"2":[2],"3":[2],"4":[2],"5":[2,1],"6":[1],"7":[1],"8":[1],"9":[1],"10":[3],"11":[3],"12":[2],"13":[5,1],"14":[11,5],"15":[11,2],"16":[22,10],"17":[2],"18":[1]}}
+}

package/coverage/lcov-report/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/lcov-report/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selecter that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);

package/coverage/lcov-report/client/client.ts.html

@@ -0,0 +1,121 @@
+
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>Code coverage report for client/client.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../prettify.css" />
+    <link rel="stylesheet" href="../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+    
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../index.html">All files</a> / <a href="index.html">client</a> client.ts</h1>
+        <div class='clearfix'>
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>5/5</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/0</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>1/1</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>5/5</span>
+            </div>
+        
+            
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { ClientInterface } from "@cryptexlabs/codex-data-model";
+&nbsp;
+export class Client implements ClientInterface {
+  public agent?: string;
+&nbsp;
+  constructor(
+    public readonly id: string,
+    public readonly version: string,
+    public readonly name: string,
+    public readonly variant: string
+  ) {}
+}
+&nbsp;</pre></td></tr></table></pre>
+
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-01-22T11:39:36.855Z
+            </div>
+        <script src="../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../sorter.js"></script>
+        <script src="../block-navigation.js"></script>
+    </body>
+</html>
+