@crvy/dsclnt

@crvy/dsclnt wraps the Diffstranding session API and gives Playwright projects a small fixture factory that keeps existing { page }-style tests working against the remote grid.

What It Solves

• Removes the session-create/connect/delete boilerplate from project-local fixtures.
• Keeps Playwright's built-in page and context flow by overriding the worker browser fixture only.
• Exposes a lower-level client for custom orchestration or non-test tooling.

Install

npm install -D @crvy/dsclnt @playwright/test

Playwright Usage

Create a local fixture module once, then keep using normal Playwright tests.

import { describe, expect, extend } from "@crvy/dsclnt";

export const { test, describe } = extend({
  apiKey: process.env.DS_API_KEY,
  apiUrl: process.env.DS_API_URL,
  playwrightVersion: process.env.PLAYWRIGHT_VERSION,
  connectTimeoutMs: 30_000,
  timeout: 300,
});

export { expect };

test already includes these convenience fixtures out of the box:

• page: standard Playwright page fixture backed by Diffstranding
• remoteContext: alias of the remote browser fixture
• remotePage: alias of the standard page fixture
• sharedPage: worker-scoped shared page for advanced cases

Then your tests can stay close to stock Playwright:

import { expect, test } from "@crvy/dsclnt";

test("loads the app", async ({ page }) => {
  await page.goto("https://example.com");
  await expect(page).toHaveTitle(/Example/);
});

If your project can rely on environment defaults alone, you can skip a local fixture file entirely and import straight from the package root:

import { describe, expect, test } from "@crvy/dsclnt";

describe("app", () => {
  test("loads the app", async ({ page }) => {
    await page.goto("https://example.com");
    await expect(page).toHaveTitle(/Example/);
  });
});

Client Usage

import { createDiffstrandingClient } from "@crvy/dsclnt/client";

const client = createDiffstrandingClient({
  apiKey: process.env.DS_API_KEY,
  apiUrl: process.env.DS_API_URL,
  resolvePlaywrightVersion: () => "1.59.1",
});

const connection = await client.createConnection({ browserType: "chromium" });

// connection.wsEndpoint
// connection.headers.Authorization
// await connection.terminate()

Defaults

• apiUrl: http://localhost:3000
• apiKey: DS_API_KEY or explicit config
• headless: true
• concurrency: 1
• timeout: 300 seconds

Provide one of the following for Playwright version resolution:

• playwrightVersion on each connection request
• extend({ playwrightVersion }) in the Playwright wrapper
• PLAYWRIGHT_VERSION in the environment
• resolvePlaywrightVersion in the client config