@edgelens/playwright-plugin 0.0.0-stage → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdgeLens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
+# @edgelens/playwright-plugin
+
+Playwright integration for [EdgeLens](https://edgelens.ai) — write a
+Playwright test that gets a real edge AI camera as a fixture, with
+auto-allocate, auto-release, and project presets for each
+(deviceType, os) combination.
+
+## Install
+
+```sh
+npm install -D @edgelens/playwright-plugin @edgelens/core @playwright/test
+```
+
+Requires Node 18+.
+
+## Quickstart
+
+```ts
+// e2e/camera.spec.ts
+import { readFile } from "node:fs/promises";
+import { test, expect } from "@edgelens/playwright-plugin";
+
+test("camera displays the test pattern", async ({ device, page }) => {
+  await device.display.show("https://example.com/test-pattern.png");
+  await device.display.waitStable();
+
+  // device.host is reachable from your test process — the platform
+  // proxies through to the camera-LAN device.
+  await page.goto(`http://${device.host}:8000/preview`);
+  await expect(page).toHaveScreenshot();
+});
+
+test("inference latency", async ({ device }) => {
+  // deploy() uploads local file data.
+  const blob = new Blob([await readFile("./models/face.cvimodel")]);
+  await device.deploy({ model: { name: "face.cvimodel", blob } });
+  await device.inference.start();
+  const stats = await device.inference.run(30);
+  expect(stats.fps.avg).toBeGreaterThan(15);
+  expect(stats.latency_ms.p95).toBeLessThan(100);
+});
+```
+
+`device` (and `session`, `client`) are **worker-scoped** by default —
+one camera per worker process, shared across every test in that
+worker. The right tradeoff for read-only test suites where sessions
+take 30s+ to provision.
+
+For tests that mutate device state and want isolation, use
+`workerSession` directly or override in `test.use()` — see
+`Test scopes` below.
+
+## Configure
+
+In `playwright.config.ts`:
+
+```ts
+import { defineConfig } from "@playwright/test";
+import { edgelensProjects } from "@edgelens/playwright-plugin";
+
+export default defineConfig({
+  projects: [
+    ...edgelensProjects({
+      apiKey: process.env.EDGELENS_API_KEY,
+      // matrix: [{ deviceType: "recamera-2002", os: "stock-os" }],
+    }),
+  ],
+});
+```
+
+`edgelensProjects()` emits one Playwright project per
+`(deviceType, os)` combination — by default both `stock-os` and
+`recamagined`. Filter with the standard Playwright `--project=...`
+flag.
+
+Or, no projects — just `use: { edgelensOptions: ... }` directly:
+
+```ts
+import { defineConfig } from "@playwright/test";
+
+export default defineConfig({
+  use: {
+    edgelensOptions: {
+      apiKey: process.env.EDGELENS_API_KEY,
+      session: { deviceType: "recamera-2002", os: "stock-os", timeoutS: 1800 },
+    },
+  },
+});
+```
+
+## Fixtures
+
+| Fixture | Scope | What |
+|---|---|---|
+| `client` | test | `EdgeLensClient` from `@edgelens/core`, defaults to the worker-scoped one |
+| `session` | test | `Session`, defaults to the worker-scoped one |
+| `device` | test | `Device` (the test surface), defaults to the worker-scoped one |
+| `workerClient` | worker | One `EdgeLensClient` per worker process |
+| `workerSession` | worker | One ready `Session` per worker, auto-released at worker teardown |
+| `workerDevice` | worker | The `Device` from the worker-scoped session |
+| `edgelensOptions` | worker | The options passed to the underlying client + lifecycle helpers (override in `use`) |
+
+## Test scopes
+
+**Worker-scoped (default — `device`):** one camera per worker, reused
+across every test in that worker. Wall-clock-cheap, but tests share
+device state — order matters and a stuck device may take other tests
+down with it.
+
+**Test-scoped:** define a custom fixture if you want a fresh device
+every test:
+
+```ts
+import { test as base, allocateSession, releaseSession } from "@edgelens/playwright-plugin";
+
+const test = base.extend<{ freshDevice: import("@edgelens/core").Device }>({
+  freshDevice: async ({ workerClient, edgelensOptions }, use) => {
+    const session = await allocateSession(workerClient, edgelensOptions);
+    try {
+      await use(session.device);
+    } finally {
+      await releaseSession(session);
+    }
+  },
+});
+```
+
+## Errors
+
+The fixtures don't swallow errors during setup — Playwright reports
+fixture failures as the cause of the test failure. Teardown errors
+(failed release) are swallowed by default so they don't mask the
+original test failure; pass an `onError` callback to `releaseSession`
+to log them.
+
+## Develop
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run build
+```
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/index.cjs

@@ -0,0 +1,152 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULTS: () => DEFAULTS,
+  allocateSession: () => allocateSession,
+  buildClient: () => buildClient,
+  edgelensProjects: () => edgelensProjects,
+  expect: () => import_test2.expect,
+  releaseSession: () => releaseSession,
+  test: () => test
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/fixtures.ts
+var import_test = require("@playwright/test");
+
+// src/lifecycle.ts
+var import_core = require("@edgelens/core");
+var DEFAULTS = {
+  waitReadyTimeoutMs: 5 * 6e4,
+  waitReadyPollMs: 2e3
+};
+function buildClient(opts) {
+  return new import_core.EdgeLensClient({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {},
+    ...opts.client ?? {}
+  });
+}
+async function allocateSession(client, opts = {}, onReleaseError = (err) => console.warn("edgelens: session release failed after waitReady error:", err)) {
+  const session = await client.createSession(opts.session ?? {});
+  try {
+    await session.waitReady(
+      opts.waitReadyTimeoutMs ?? DEFAULTS.waitReadyTimeoutMs,
+      opts.waitReadyPollMs ?? DEFAULTS.waitReadyPollMs
+    );
+  } catch (err) {
+    await releaseSession(session, onReleaseError);
+    throw err;
+  }
+  return session;
+}
+async function releaseSession(session, onError) {
+  if (!session) return;
+  try {
+    await session.release();
+  } catch (e) {
+    if (onError) onError(e);
+  }
+}
+
+// src/fixtures.ts
+var import_test2 = require("@playwright/test");
+var test = import_test.test.extend({
+  // -------- worker-scoped: client / session / device -----------------------
+  // The default fixture options. Override in playwright.config.ts via:
+  //   use: { edgelensOptions: { session: { os: "recamagined" } } }
+  edgelensOptions: [
+    { waitReadyTimeoutMs: DEFAULTS.waitReadyTimeoutMs, waitReadyPollMs: DEFAULTS.waitReadyPollMs },
+    { option: true, scope: "worker" }
+  ],
+  workerClient: [
+    async ({ edgelensOptions }, use) => {
+      const client = buildClient(edgelensOptions);
+      await use(client);
+    },
+    { scope: "worker" }
+  ],
+  workerSession: [
+    async ({ workerClient, edgelensOptions }, use) => {
+      const session = await allocateSession(workerClient, edgelensOptions);
+      try {
+        await use(session);
+      } finally {
+        await releaseSession(session);
+      }
+    },
+    { scope: "worker", timeout: 0 }
+  ],
+  workerDevice: [
+    async ({ workerSession }, use) => {
+      await use(workerSession.device);
+    },
+    { scope: "worker" }
+  ],
+  // -------- test-scoped: passthrough to worker-scoped by default ----------
+  client: async ({ workerClient }, use) => {
+    await use(workerClient);
+  },
+  session: async ({ workerSession }, use) => {
+    await use(workerSession);
+  },
+  device: async ({ workerSession }, use) => {
+    await use(workerSession.device);
+  }
+});
+
+// src/projects.ts
+var DEFAULT_MATRIX = [
+  { deviceType: "recamera-2002", os: "stock-os" },
+  { deviceType: "recamera-2002", os: "recamagined" }
+];
+function edgelensProjects(opts = {}) {
+  const matrix = opts.matrix ?? DEFAULT_MATRIX;
+  return matrix.map(({ deviceType, os, sessionTimeoutS }) => {
+    const session = {
+      deviceType,
+      os,
+      ...sessionTimeoutS !== void 0 ? { timeoutS: sessionTimeoutS } : {}
+    };
+    return {
+      name: `${deviceType}/${os}`,
+      use: {
+        edgelensOptions: {
+          ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+          ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {},
+          session
+        }
+      }
+    };
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULTS,
+  allocateSession,
+  buildClient,
+  edgelensProjects,
+  expect,
+  releaseSession,
+  test
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/fixtures.ts","../src/lifecycle.ts","../src/projects.ts"],"sourcesContent":["export { test, expect } from \"./fixtures.js\";\nexport type { EdgelensTestFixtures, EdgelensWorkerFixtures } from \"./fixtures.js\";\nexport {\n  allocateSession,\n  releaseSession,\n  buildClient,\n  DEFAULTS,\n} from \"./lifecycle.js\";\nexport type { EdgelensFixtureOptions } from \"./lifecycle.js\";\nexport { edgelensProjects } from \"./projects.js\";\nexport type { EdgelensProject, EdgelensProjectsOptions } from \"./projects.js\";\n","/**\n * Playwright fixtures. The standard import:\n *\n *   import { test, expect } from \"@edgelens/playwright-plugin\";\n *\n *   test(\"display playback\", async ({ device }) => {\n *     await device.display.play(\"https://example.com/video.mp4\");\n *     // ... assertions\n *   });\n *\n * Two scopes:\n *\n * - **worker-scoped** (`workerDevice`, `workerSession`, `workerClient`)\n *   — one camera per worker process, reused across every test in that\n *   worker. The right default when sessions take 30+s to provision and\n *   tests are mostly read-only.\n *\n * - **test-scoped** (`device`, `session`, `client`) — fresh camera per\n *   test. Picks the worker-scoped one up by default but can be\n *   overridden via `test.use({ session: ... })`.\n */\n\nimport { test as base } from \"@playwright/test\";\nimport { EdgeLensClient } from \"@edgelens/core\";\nimport type { Device, Session } from \"@edgelens/core\";\n\nimport {\n  DEFAULTS,\n  allocateSession,\n  buildClient,\n  releaseSession,\n  type EdgelensFixtureOptions,\n} from \"./lifecycle.js\";\n\nexport interface EdgelensWorkerFixtures {\n  edgelensOptions: EdgelensFixtureOptions;\n  workerClient: EdgeLensClient;\n  workerSession: Session;\n  workerDevice: Device;\n}\n\nexport interface EdgelensTestFixtures {\n  /** Fresh per-test client. Defaults to the worker-scoped one. */\n  client: EdgeLensClient;\n  /** Fresh per-test session. Defaults to the worker-scoped one. */\n  session: Session;\n  /** Fresh per-test device. Defaults to the worker-scoped one. */\n  device: Device;\n}\n\nexport const test = base.extend<EdgelensTestFixtures, EdgelensWorkerFixtures>({\n  // -------- worker-scoped: client / session / device -----------------------\n\n  // The default fixture options. Override in playwright.config.ts via:\n  //   use: { edgelensOptions: { session: { os: \"recamagined\" } } }\n  edgelensOptions: [\n    { waitReadyTimeoutMs: DEFAULTS.waitReadyTimeoutMs, waitReadyPollMs: DEFAULTS.waitReadyPollMs },\n    { option: true, scope: \"worker\" },\n  ],\n\n  workerClient: [\n    async ({ edgelensOptions }, use) => {\n      const client = buildClient(edgelensOptions);\n      await use(client);\n    },\n    { scope: \"worker\" },\n  ],\n\n  workerSession: [\n    async ({ workerClient, edgelensOptions }, use) => {\n      const session = await allocateSession(workerClient, edgelensOptions);\n      try {\n        await use(session);\n      } finally {\n        await releaseSession(session);\n      }\n    },\n    { scope: \"worker\", timeout: 0 },\n  ],\n\n  workerDevice: [\n    async ({ workerSession }, use) => {\n      await use(workerSession.device);\n    },\n    { scope: \"worker\" },\n  ],\n\n  // -------- test-scoped: passthrough to worker-scoped by default ----------\n\n  client: async ({ workerClient }, use) => {\n    await use(workerClient);\n  },\n\n  session: async ({ workerSession }, use) => {\n    await use(workerSession);\n  },\n\n  device: async ({ workerSession }, use) => {\n    await use(workerSession.device);\n  },\n});\n\nexport { expect } from \"@playwright/test\";\n","/**\n * Fixture lifecycle helpers — the actual session-allocation +\n * release logic. Kept separate from `fixtures.ts` so it's easy to\n * unit-test without Playwright's runner.\n */\n\nimport { EdgeLensClient } from \"@edgelens/core\";\nimport type {\n  CreateSessionOptions,\n  EdgeLensClientOptions,\n  Session,\n} from \"@edgelens/core\";\n\nexport interface EdgelensFixtureOptions {\n  /** API key. Falls back to `EDGELENS_API_KEY` env var. */\n  apiKey?: string;\n  /** Override the platform API base URL. */\n  baseUrl?: string;\n  /** Per-test session params. Same shape as `client.createSession()`. */\n  session?: CreateSessionOptions;\n  /** How long to wait for `status=ready`. Default 5 minutes. */\n  waitReadyTimeoutMs?: number;\n  /** Test poll interval while waiting for ready. Default 2s. */\n  waitReadyPollMs?: number;\n  /** Extra options passed through to the underlying HTTP client. */\n  client?: Pick<EdgeLensClientOptions, \"timeoutMs\" | \"retryPolicy\" | \"userAgent\" | \"fetch\">;\n}\n\nexport const DEFAULTS = {\n  waitReadyTimeoutMs: 5 * 60_000,\n  waitReadyPollMs: 2_000,\n} as const;\n\nexport function buildClient(opts: EdgelensFixtureOptions): EdgeLensClient {\n  return new EdgeLensClient({\n    ...(opts.apiKey !== undefined ? { apiKey: opts.apiKey } : {}),\n    ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),\n    ...(opts.client ?? {}),\n  });\n}\n\n/**\n * Allocate a session and wait for it to be ready.\n *\n * Thrown errors propagate to the test (Playwright will fail the\n * fixture setup); the caller is responsible for invoking\n * `releaseSession()` on the result in a `finally` to avoid leaking\n * a billable device.\n *\n * If `waitReady` rejects, the caller never receives the session, so\n * it is released here before the original error is rethrown. A\n * failed release goes to `onReleaseError` (default `console.warn`)\n * and never replaces the original error.\n */\nexport async function allocateSession(\n  client: EdgeLensClient,\n  opts: EdgelensFixtureOptions = {},\n  onReleaseError: (err: unknown) => void = (err) =>\n    console.warn(\"edgelens: session release failed after waitReady error:\", err),\n): Promise<Session> {\n  const session = await client.createSession(opts.session ?? {});\n  try {\n    await session.waitReady(\n      opts.waitReadyTimeoutMs ?? DEFAULTS.waitReadyTimeoutMs,\n      opts.waitReadyPollMs ?? DEFAULTS.waitReadyPollMs,\n    );\n  } catch (err) {\n    await releaseSession(session, onReleaseError);\n    throw err;\n  }\n  return session;\n}\n\n/**\n * Release a session, swallowing any errors that fire during\n * teardown (a failing release shouldn't mask the actual test\n * failure that preceded it).\n */\nexport async function releaseSession(\n  session: Session | undefined,\n  onError?: (err: unknown) => void,\n): Promise<void> {\n  if (!session) return;\n  try {\n    await session.release();\n  } catch (e) {\n    if (onError) onError(e);\n  }\n}\n","/**\n * Project presets for common (deviceType, os) combinations.\n *\n * Use in `playwright.config.ts`:\n *\n *   import { defineConfig } from \"@playwright/test\";\n *   import { edgelensProjects } from \"@edgelens/playwright-plugin\";\n *\n *   export default defineConfig({\n *     projects: [\n *       ...edgelensProjects({ apiKey: process.env.EDGELENS_API_KEY }),\n *     ],\n *   });\n *\n * Each project sets `edgelensOptions.session` to the matching combo.\n * Test files filter via `test.use({ ... })` or Playwright's project\n * tag mechanism (`test.describe.configure({ tag: [\"@stock-os\"] })`).\n */\n\nimport type { CreateSessionOptions, DeviceType, OSType } from \"@edgelens/core\";\n\nimport type { EdgelensFixtureOptions } from \"./lifecycle.js\";\n\nexport interface EdgelensProject {\n  name: string;\n  use: {\n    edgelensOptions: EdgelensFixtureOptions;\n  };\n}\n\nexport interface EdgelensMatrixEntry {\n  deviceType: DeviceType;\n  os: OSType;\n  sessionTimeoutS?: number;\n}\n\nexport interface EdgelensProjectsOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  /** Which (deviceType, os) combos to expose. Defaults to all supported. */\n  matrix?: EdgelensMatrixEntry[];\n}\n\nconst DEFAULT_MATRIX: EdgelensMatrixEntry[] = [\n  { deviceType: \"recamera-2002\", os: \"stock-os\" },\n  { deviceType: \"recamera-2002\", os: \"recamagined\" },\n];\n\nexport function edgelensProjects(\n  opts: EdgelensProjectsOptions = {},\n): EdgelensProject[] {\n  const matrix = opts.matrix ?? DEFAULT_MATRIX;\n  return matrix.map(({ deviceType, os, sessionTimeoutS }) => {\n    const session: CreateSessionOptions = {\n      deviceType,\n      os,\n      ...(sessionTimeoutS !== undefined ? { timeoutS: sessionTimeoutS } : {}),\n    };\n    return {\n      name: `${deviceType}/${os}`,\n      use: {\n        edgelensOptions: {\n          ...(opts.apiKey !== undefined ? { apiKey: opts.apiKey } : {}),\n          ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),\n          session,\n        },\n      },\n    };\n  });\n}\n"],"mappings":"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","names":["import_test","base"]}

package/dist/index.d.cts

@@ -0,0 +1,105 @@
+import * as playwright_test from 'playwright/test';
+import { CreateSessionOptions, EdgeLensClientOptions, EdgeLensClient, Session, Device, DeviceType, OSType } from '@edgelens/core';
+export { expect } from '@playwright/test';
+
+/**
+ * Fixture lifecycle helpers — the actual session-allocation +
+ * release logic. Kept separate from `fixtures.ts` so it's easy to
+ * unit-test without Playwright's runner.
+ */
+
+interface EdgelensFixtureOptions {
+    /** API key. Falls back to `EDGELENS_API_KEY` env var. */
+    apiKey?: string;
+    /** Override the platform API base URL. */
+    baseUrl?: string;
+    /** Per-test session params. Same shape as `client.createSession()`. */
+    session?: CreateSessionOptions;
+    /** How long to wait for `status=ready`. Default 5 minutes. */
+    waitReadyTimeoutMs?: number;
+    /** Test poll interval while waiting for ready. Default 2s. */
+    waitReadyPollMs?: number;
+    /** Extra options passed through to the underlying HTTP client. */
+    client?: Pick<EdgeLensClientOptions, "timeoutMs" | "retryPolicy" | "userAgent" | "fetch">;
+}
+declare const DEFAULTS: {
+    readonly waitReadyTimeoutMs: number;
+    readonly waitReadyPollMs: 2000;
+};
+declare function buildClient(opts: EdgelensFixtureOptions): EdgeLensClient;
+/**
+ * Allocate a session and wait for it to be ready.
+ *
+ * Thrown errors propagate to the test (Playwright will fail the
+ * fixture setup); the caller is responsible for invoking
+ * `releaseSession()` on the result in a `finally` to avoid leaking
+ * a billable device.
+ *
+ * If `waitReady` rejects, the caller never receives the session, so
+ * it is released here before the original error is rethrown. A
+ * failed release goes to `onReleaseError` (default `console.warn`)
+ * and never replaces the original error.
+ */
+declare function allocateSession(client: EdgeLensClient, opts?: EdgelensFixtureOptions, onReleaseError?: (err: unknown) => void): Promise<Session>;
+/**
+ * Release a session, swallowing any errors that fire during
+ * teardown (a failing release shouldn't mask the actual test
+ * failure that preceded it).
+ */
+declare function releaseSession(session: Session | undefined, onError?: (err: unknown) => void): Promise<void>;
+
+interface EdgelensWorkerFixtures {
+    edgelensOptions: EdgelensFixtureOptions;
+    workerClient: EdgeLensClient;
+    workerSession: Session;
+    workerDevice: Device;
+}
+interface EdgelensTestFixtures {
+    /** Fresh per-test client. Defaults to the worker-scoped one. */
+    client: EdgeLensClient;
+    /** Fresh per-test session. Defaults to the worker-scoped one. */
+    session: Session;
+    /** Fresh per-test device. Defaults to the worker-scoped one. */
+    device: Device;
+}
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & EdgelensTestFixtures, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions & EdgelensWorkerFixtures>;
+
+/**
+ * Project presets for common (deviceType, os) combinations.
+ *
+ * Use in `playwright.config.ts`:
+ *
+ *   import { defineConfig } from "@playwright/test";
+ *   import { edgelensProjects } from "@edgelens/playwright-plugin";
+ *
+ *   export default defineConfig({
+ *     projects: [
+ *       ...edgelensProjects({ apiKey: process.env.EDGELENS_API_KEY }),
+ *     ],
+ *   });
+ *
+ * Each project sets `edgelensOptions.session` to the matching combo.
+ * Test files filter via `test.use({ ... })` or Playwright's project
+ * tag mechanism (`test.describe.configure({ tag: ["@stock-os"] })`).
+ */
+
+interface EdgelensProject {
+    name: string;
+    use: {
+        edgelensOptions: EdgelensFixtureOptions;
+    };
+}
+interface EdgelensMatrixEntry {
+    deviceType: DeviceType;
+    os: OSType;
+    sessionTimeoutS?: number;
+}
+interface EdgelensProjectsOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    /** Which (deviceType, os) combos to expose. Defaults to all supported. */
+    matrix?: EdgelensMatrixEntry[];
+}
+declare function edgelensProjects(opts?: EdgelensProjectsOptions): EdgelensProject[];
+
+export { DEFAULTS, type EdgelensFixtureOptions, type EdgelensProject, type EdgelensProjectsOptions, type EdgelensTestFixtures, type EdgelensWorkerFixtures, allocateSession, buildClient, edgelensProjects, releaseSession, test };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import * as playwright_test from 'playwright/test';
+import { CreateSessionOptions, EdgeLensClientOptions, EdgeLensClient, Session, Device, DeviceType, OSType } from '@edgelens/core';
+export { expect } from '@playwright/test';
+
+/**
+ * Fixture lifecycle helpers — the actual session-allocation +
+ * release logic. Kept separate from `fixtures.ts` so it's easy to
+ * unit-test without Playwright's runner.
+ */
+
+interface EdgelensFixtureOptions {
+    /** API key. Falls back to `EDGELENS_API_KEY` env var. */
+    apiKey?: string;
+    /** Override the platform API base URL. */
+    baseUrl?: string;
+    /** Per-test session params. Same shape as `client.createSession()`. */
+    session?: CreateSessionOptions;
+    /** How long to wait for `status=ready`. Default 5 minutes. */
+    waitReadyTimeoutMs?: number;
+    /** Test poll interval while waiting for ready. Default 2s. */
+    waitReadyPollMs?: number;
+    /** Extra options passed through to the underlying HTTP client. */
+    client?: Pick<EdgeLensClientOptions, "timeoutMs" | "retryPolicy" | "userAgent" | "fetch">;
+}
+declare const DEFAULTS: {
+    readonly waitReadyTimeoutMs: number;
+    readonly waitReadyPollMs: 2000;
+};
+declare function buildClient(opts: EdgelensFixtureOptions): EdgeLensClient;
+/**
+ * Allocate a session and wait for it to be ready.
+ *
+ * Thrown errors propagate to the test (Playwright will fail the
+ * fixture setup); the caller is responsible for invoking
+ * `releaseSession()` on the result in a `finally` to avoid leaking
+ * a billable device.
+ *
+ * If `waitReady` rejects, the caller never receives the session, so
+ * it is released here before the original error is rethrown. A
+ * failed release goes to `onReleaseError` (default `console.warn`)
+ * and never replaces the original error.
+ */
+declare function allocateSession(client: EdgeLensClient, opts?: EdgelensFixtureOptions, onReleaseError?: (err: unknown) => void): Promise<Session>;
+/**
+ * Release a session, swallowing any errors that fire during
+ * teardown (a failing release shouldn't mask the actual test
+ * failure that preceded it).
+ */
+declare function releaseSession(session: Session | undefined, onError?: (err: unknown) => void): Promise<void>;
+
+interface EdgelensWorkerFixtures {
+    edgelensOptions: EdgelensFixtureOptions;
+    workerClient: EdgeLensClient;
+    workerSession: Session;
+    workerDevice: Device;
+}
+interface EdgelensTestFixtures {
+    /** Fresh per-test client. Defaults to the worker-scoped one. */
+    client: EdgeLensClient;
+    /** Fresh per-test session. Defaults to the worker-scoped one. */
+    session: Session;
+    /** Fresh per-test device. Defaults to the worker-scoped one. */
+    device: Device;
+}
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & EdgelensTestFixtures, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions & EdgelensWorkerFixtures>;
+
+/**
+ * Project presets for common (deviceType, os) combinations.
+ *
+ * Use in `playwright.config.ts`:
+ *
+ *   import { defineConfig } from "@playwright/test";
+ *   import { edgelensProjects } from "@edgelens/playwright-plugin";
+ *
+ *   export default defineConfig({
+ *     projects: [
+ *       ...edgelensProjects({ apiKey: process.env.EDGELENS_API_KEY }),
+ *     ],
+ *   });
+ *
+ * Each project sets `edgelensOptions.session` to the matching combo.
+ * Test files filter via `test.use({ ... })` or Playwright's project
+ * tag mechanism (`test.describe.configure({ tag: ["@stock-os"] })`).
+ */
+
+interface EdgelensProject {
+    name: string;
+    use: {
+        edgelensOptions: EdgelensFixtureOptions;
+    };
+}
+interface EdgelensMatrixEntry {
+    deviceType: DeviceType;
+    os: OSType;
+    sessionTimeoutS?: number;
+}
+interface EdgelensProjectsOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    /** Which (deviceType, os) combos to expose. Defaults to all supported. */
+    matrix?: EdgelensMatrixEntry[];
+}
+declare function edgelensProjects(opts?: EdgelensProjectsOptions): EdgelensProject[];
+
+export { DEFAULTS, type EdgelensFixtureOptions, type EdgelensProject, type EdgelensProjectsOptions, type EdgelensTestFixtures, type EdgelensWorkerFixtures, allocateSession, buildClient, edgelensProjects, releaseSession, test };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/fixtures.ts
+import { test as base } from "@playwright/test";
+
+// src/lifecycle.ts
+import { EdgeLensClient } from "@edgelens/core";
+var DEFAULTS = {
+  waitReadyTimeoutMs: 5 * 6e4,
+  waitReadyPollMs: 2e3
+};
+function buildClient(opts) {
+  return new EdgeLensClient({
+    ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+    ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {},
+    ...opts.client ?? {}
+  });
+}
+async function allocateSession(client, opts = {}, onReleaseError = (err) => console.warn("edgelens: session release failed after waitReady error:", err)) {
+  const session = await client.createSession(opts.session ?? {});
+  try {
+    await session.waitReady(
+      opts.waitReadyTimeoutMs ?? DEFAULTS.waitReadyTimeoutMs,
+      opts.waitReadyPollMs ?? DEFAULTS.waitReadyPollMs
+    );
+  } catch (err) {
+    await releaseSession(session, onReleaseError);
+    throw err;
+  }
+  return session;
+}
+async function releaseSession(session, onError) {
+  if (!session) return;
+  try {
+    await session.release();
+  } catch (e) {
+    if (onError) onError(e);
+  }
+}
+
+// src/fixtures.ts
+import { expect } from "@playwright/test";
+var test = base.extend({
+  // -------- worker-scoped: client / session / device -----------------------
+  // The default fixture options. Override in playwright.config.ts via:
+  //   use: { edgelensOptions: { session: { os: "recamagined" } } }
+  edgelensOptions: [
+    { waitReadyTimeoutMs: DEFAULTS.waitReadyTimeoutMs, waitReadyPollMs: DEFAULTS.waitReadyPollMs },
+    { option: true, scope: "worker" }
+  ],
+  workerClient: [
+    async ({ edgelensOptions }, use) => {
+      const client = buildClient(edgelensOptions);
+      await use(client);
+    },
+    { scope: "worker" }
+  ],
+  workerSession: [
+    async ({ workerClient, edgelensOptions }, use) => {
+      const session = await allocateSession(workerClient, edgelensOptions);
+      try {
+        await use(session);
+      } finally {
+        await releaseSession(session);
+      }
+    },
+    { scope: "worker", timeout: 0 }
+  ],
+  workerDevice: [
+    async ({ workerSession }, use) => {
+      await use(workerSession.device);
+    },
+    { scope: "worker" }
+  ],
+  // -------- test-scoped: passthrough to worker-scoped by default ----------
+  client: async ({ workerClient }, use) => {
+    await use(workerClient);
+  },
+  session: async ({ workerSession }, use) => {
+    await use(workerSession);
+  },
+  device: async ({ workerSession }, use) => {
+    await use(workerSession.device);
+  }
+});
+
+// src/projects.ts
+var DEFAULT_MATRIX = [
+  { deviceType: "recamera-2002", os: "stock-os" },
+  { deviceType: "recamera-2002", os: "recamagined" }
+];
+function edgelensProjects(opts = {}) {
+  const matrix = opts.matrix ?? DEFAULT_MATRIX;
+  return matrix.map(({ deviceType, os, sessionTimeoutS }) => {
+    const session = {
+      deviceType,
+      os,
+      ...sessionTimeoutS !== void 0 ? { timeoutS: sessionTimeoutS } : {}
+    };
+    return {
+      name: `${deviceType}/${os}`,
+      use: {
+        edgelensOptions: {
+          ...opts.apiKey !== void 0 ? { apiKey: opts.apiKey } : {},
+          ...opts.baseUrl !== void 0 ? { baseUrl: opts.baseUrl } : {},
+          session
+        }
+      }
+    };
+  });
+}
+export {
+  DEFAULTS,
+  allocateSession,
+  buildClient,
+  edgelensProjects,
+  expect,
+  releaseSession,
+  test
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fixtures.ts","../src/lifecycle.ts","../src/projects.ts"],"sourcesContent":["/**\n * Playwright fixtures. The standard import:\n *\n *   import { test, expect } from \"@edgelens/playwright-plugin\";\n *\n *   test(\"display playback\", async ({ device }) => {\n *     await device.display.play(\"https://example.com/video.mp4\");\n *     // ... assertions\n *   });\n *\n * Two scopes:\n *\n * - **worker-scoped** (`workerDevice`, `workerSession`, `workerClient`)\n *   — one camera per worker process, reused across every test in that\n *   worker. The right default when sessions take 30+s to provision and\n *   tests are mostly read-only.\n *\n * - **test-scoped** (`device`, `session`, `client`) — fresh camera per\n *   test. Picks the worker-scoped one up by default but can be\n *   overridden via `test.use({ session: ... })`.\n */\n\nimport { test as base } from \"@playwright/test\";\nimport { EdgeLensClient } from \"@edgelens/core\";\nimport type { Device, Session } from \"@edgelens/core\";\n\nimport {\n  DEFAULTS,\n  allocateSession,\n  buildClient,\n  releaseSession,\n  type EdgelensFixtureOptions,\n} from \"./lifecycle.js\";\n\nexport interface EdgelensWorkerFixtures {\n  edgelensOptions: EdgelensFixtureOptions;\n  workerClient: EdgeLensClient;\n  workerSession: Session;\n  workerDevice: Device;\n}\n\nexport interface EdgelensTestFixtures {\n  /** Fresh per-test client. Defaults to the worker-scoped one. */\n  client: EdgeLensClient;\n  /** Fresh per-test session. Defaults to the worker-scoped one. */\n  session: Session;\n  /** Fresh per-test device. Defaults to the worker-scoped one. */\n  device: Device;\n}\n\nexport const test = base.extend<EdgelensTestFixtures, EdgelensWorkerFixtures>({\n  // -------- worker-scoped: client / session / device -----------------------\n\n  // The default fixture options. Override in playwright.config.ts via:\n  //   use: { edgelensOptions: { session: { os: \"recamagined\" } } }\n  edgelensOptions: [\n    { waitReadyTimeoutMs: DEFAULTS.waitReadyTimeoutMs, waitReadyPollMs: DEFAULTS.waitReadyPollMs },\n    { option: true, scope: \"worker\" },\n  ],\n\n  workerClient: [\n    async ({ edgelensOptions }, use) => {\n      const client = buildClient(edgelensOptions);\n      await use(client);\n    },\n    { scope: \"worker\" },\n  ],\n\n  workerSession: [\n    async ({ workerClient, edgelensOptions }, use) => {\n      const session = await allocateSession(workerClient, edgelensOptions);\n      try {\n        await use(session);\n      } finally {\n        await releaseSession(session);\n      }\n    },\n    { scope: \"worker\", timeout: 0 },\n  ],\n\n  workerDevice: [\n    async ({ workerSession }, use) => {\n      await use(workerSession.device);\n    },\n    { scope: \"worker\" },\n  ],\n\n  // -------- test-scoped: passthrough to worker-scoped by default ----------\n\n  client: async ({ workerClient }, use) => {\n    await use(workerClient);\n  },\n\n  session: async ({ workerSession }, use) => {\n    await use(workerSession);\n  },\n\n  device: async ({ workerSession }, use) => {\n    await use(workerSession.device);\n  },\n});\n\nexport { expect } from \"@playwright/test\";\n","/**\n * Fixture lifecycle helpers — the actual session-allocation +\n * release logic. Kept separate from `fixtures.ts` so it's easy to\n * unit-test without Playwright's runner.\n */\n\nimport { EdgeLensClient } from \"@edgelens/core\";\nimport type {\n  CreateSessionOptions,\n  EdgeLensClientOptions,\n  Session,\n} from \"@edgelens/core\";\n\nexport interface EdgelensFixtureOptions {\n  /** API key. Falls back to `EDGELENS_API_KEY` env var. */\n  apiKey?: string;\n  /** Override the platform API base URL. */\n  baseUrl?: string;\n  /** Per-test session params. Same shape as `client.createSession()`. */\n  session?: CreateSessionOptions;\n  /** How long to wait for `status=ready`. Default 5 minutes. */\n  waitReadyTimeoutMs?: number;\n  /** Test poll interval while waiting for ready. Default 2s. */\n  waitReadyPollMs?: number;\n  /** Extra options passed through to the underlying HTTP client. */\n  client?: Pick<EdgeLensClientOptions, \"timeoutMs\" | \"retryPolicy\" | \"userAgent\" | \"fetch\">;\n}\n\nexport const DEFAULTS = {\n  waitReadyTimeoutMs: 5 * 60_000,\n  waitReadyPollMs: 2_000,\n} as const;\n\nexport function buildClient(opts: EdgelensFixtureOptions): EdgeLensClient {\n  return new EdgeLensClient({\n    ...(opts.apiKey !== undefined ? { apiKey: opts.apiKey } : {}),\n    ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),\n    ...(opts.client ?? {}),\n  });\n}\n\n/**\n * Allocate a session and wait for it to be ready.\n *\n * Thrown errors propagate to the test (Playwright will fail the\n * fixture setup); the caller is responsible for invoking\n * `releaseSession()` on the result in a `finally` to avoid leaking\n * a billable device.\n *\n * If `waitReady` rejects, the caller never receives the session, so\n * it is released here before the original error is rethrown. A\n * failed release goes to `onReleaseError` (default `console.warn`)\n * and never replaces the original error.\n */\nexport async function allocateSession(\n  client: EdgeLensClient,\n  opts: EdgelensFixtureOptions = {},\n  onReleaseError: (err: unknown) => void = (err) =>\n    console.warn(\"edgelens: session release failed after waitReady error:\", err),\n): Promise<Session> {\n  const session = await client.createSession(opts.session ?? {});\n  try {\n    await session.waitReady(\n      opts.waitReadyTimeoutMs ?? DEFAULTS.waitReadyTimeoutMs,\n      opts.waitReadyPollMs ?? DEFAULTS.waitReadyPollMs,\n    );\n  } catch (err) {\n    await releaseSession(session, onReleaseError);\n    throw err;\n  }\n  return session;\n}\n\n/**\n * Release a session, swallowing any errors that fire during\n * teardown (a failing release shouldn't mask the actual test\n * failure that preceded it).\n */\nexport async function releaseSession(\n  session: Session | undefined,\n  onError?: (err: unknown) => void,\n): Promise<void> {\n  if (!session) return;\n  try {\n    await session.release();\n  } catch (e) {\n    if (onError) onError(e);\n  }\n}\n","/**\n * Project presets for common (deviceType, os) combinations.\n *\n * Use in `playwright.config.ts`:\n *\n *   import { defineConfig } from \"@playwright/test\";\n *   import { edgelensProjects } from \"@edgelens/playwright-plugin\";\n *\n *   export default defineConfig({\n *     projects: [\n *       ...edgelensProjects({ apiKey: process.env.EDGELENS_API_KEY }),\n *     ],\n *   });\n *\n * Each project sets `edgelensOptions.session` to the matching combo.\n * Test files filter via `test.use({ ... })` or Playwright's project\n * tag mechanism (`test.describe.configure({ tag: [\"@stock-os\"] })`).\n */\n\nimport type { CreateSessionOptions, DeviceType, OSType } from \"@edgelens/core\";\n\nimport type { EdgelensFixtureOptions } from \"./lifecycle.js\";\n\nexport interface EdgelensProject {\n  name: string;\n  use: {\n    edgelensOptions: EdgelensFixtureOptions;\n  };\n}\n\nexport interface EdgelensMatrixEntry {\n  deviceType: DeviceType;\n  os: OSType;\n  sessionTimeoutS?: number;\n}\n\nexport interface EdgelensProjectsOptions {\n  apiKey?: string;\n  baseUrl?: string;\n  /** Which (deviceType, os) combos to expose. Defaults to all supported. */\n  matrix?: EdgelensMatrixEntry[];\n}\n\nconst DEFAULT_MATRIX: EdgelensMatrixEntry[] = [\n  { deviceType: \"recamera-2002\", os: \"stock-os\" },\n  { deviceType: \"recamera-2002\", os: \"recamagined\" },\n];\n\nexport function edgelensProjects(\n  opts: EdgelensProjectsOptions = {},\n): EdgelensProject[] {\n  const matrix = opts.matrix ?? DEFAULT_MATRIX;\n  return matrix.map(({ deviceType, os, sessionTimeoutS }) => {\n    const session: CreateSessionOptions = {\n      deviceType,\n      os,\n      ...(sessionTimeoutS !== undefined ? { timeoutS: sessionTimeoutS } : {}),\n    };\n    return {\n      name: `${deviceType}/${os}`,\n      use: {\n        edgelensOptions: {\n          ...(opts.apiKey !== undefined ? { apiKey: opts.apiKey } : {}),\n          ...(opts.baseUrl !== undefined ? { baseUrl: opts.baseUrl } : {}),\n          session,\n        },\n      },\n    };\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@edgelens/playwright-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.2",
+  "description": "Playwright integration for EdgeLens — per-test camera sessions, auto-release, project presets.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@edgelens/core": "^0.2.2",
+    "@playwright/test": ">=1.50.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.55.0",
+    "@types/node": "^20.19.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "edgelens",
+    "playwright",
+    "playwright-plugin",
+    "edge-ai",
+    "testing",
+    "device-farm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edgelens-ai/edgelens-sdk.git",
+    "directory": "integrations/playwright"
+  },
+  "homepage": "https://edgelens.ai",
+  "bugs": {
+    "url": "https://github.com/edgelens-ai/edgelens-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}