@plyven/web-debug

Debug-only browser helper that mirrors your app’s fetch / XMLHttpRequest / Axios calls into the local Plyven agent.

Browser app
  → Plyven.install / attachAxios
  → Your real API (unchanged)
  → Local Plyven agent

• No cloud, no telemetry
• Dev-only — do not ship in production bundles

Full guide: React.js integration

SDK distribution status: SDK release notes

Install (0.1.0)

Not published to the npm registry yet. Until a release explicitly publishes @plyven/web-debug, install from this repository (path or staged tarball).

Local / path (supported today)

# from the Plyven checkout:
cd packages/web-debug && npm install && npm run build

# in your app:
npm install -D ../path/to/Plyven/packages/web-debug

Staged tarball (supported today)

After scripts/stage-sdk-release.ps1 in the Plyven repo:

npm install -D ../path/to/Plyven/dist/sdk/plyven-web-debug-0.1.0.tgz

Public npm (future only)

When this package is actually published:

npm install -D @plyven/web-debug

Do not use the registry command above until publish succeeds (npm view @plyven/web-debug must resolve).

Usage

import { Plyven } from "@plyven/web-debug";

if (import.meta.env.DEV) {
  Plyven.install({
    host: import.meta.env.VITE_PLYVEN_HOST ?? "127.0.0.1",
    port: 8081,
  });
}

Axios only:

import axios from "axios";
import { Plyven } from "@plyven/web-debug";

if (import.meta.env.DEV) {
  Plyven.install({ host: "127.0.0.1", patchFetch: false, patchXHR: false });
  Plyven.attachAxios(axios);
}

Build note

Published artifacts use the compiled dist/ output. prepublishOnly runs npm run build so a publish cannot ship without compiling TypeScript first. Local path installs should run npm run build in this package before consuming it.

License

Proprietary — Plyven Commercial Software and SDK License. license in package.json is UNLICENSED. Not open source.