@get-skipper/playwright 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skipper Contributors
+
+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

@@ -0,0 +1,74 @@
+# @get-skipper/playwright
+
+Skipper plugin for [Playwright](https://playwright.dev/) — enable/disable tests from a Google Spreadsheet.
+
+## Installation
+
+```bash
+pnpm add -D @get-skipper/playwright
+# or
+npm install --save-dev @get-skipper/playwright
+```
+
+## Setup
+
+### 1. Configure `playwright.config.ts`
+
+```ts
+import { defineConfig } from '@playwright/test';
+import { createSkipperGlobalSetup, SkipperReporter } from '@get-skipper/playwright';
+
+const skipperConfig = {
+  spreadsheetId: process.env.SKIPPER_SPREADSHEET_ID!,
+  credentials: { credentialsBase64: process.env.GOOGLE_CREDS_B64! },
+  // Or for local dev:
+  // credentials: { credentialsFile: './service-account.json' },
+};
+
+export default defineConfig({
+  globalSetup: createSkipperGlobalSetup(skipperConfig),
+  reporter: [
+    ['list'],
+    [SkipperReporter, skipperConfig], // handles sync mode
+  ],
+  // ... rest of your config
+});
+```
+
+### 2. Update test file imports
+
+Replace the `@playwright/test` import with `@get-skipper/playwright`:
+
+```ts
+// Before:
+import { test, expect } from '@playwright/test';
+
+// After:
+import { test, expect } from '@get-skipper/playwright';
+```
+
+The API is identical — `test` and `expect` work exactly as before. Tests with a future `disabledUntil` date in the spreadsheet are automatically skipped.
+
+## Test ID Format
+
+Tests are identified in the spreadsheet as:
+
+```
+{relative file path} > {describe block(s)} > {test name}
+```
+
+Example:
+```
+tests/auth/login.spec.ts > login > should log in with valid credentials
+```
+
+## Modes
+
+- **`read-only`** (default): reads the spreadsheet, skips disabled tests. No writes.
+- **`sync`** (`SKIPPER_MODE=sync`): same as read-only + reconciles the spreadsheet after the run.
+
+See the [root README](../../README.md) for full setup instructions including Google Sheets configuration.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,45 @@
+import { SkipperConfig, SkipperResolver } from '@get-skipper/core';
+export { SkipperConfig } from '@get-skipper/core';
+import * as _playwright_test from '@playwright/test';
+export { expect } from '@playwright/test';
+import { Reporter, TestCase, TestResult, FullResult } from '@playwright/test/reporter';
+
+declare function createSkipperGlobalSetup(config: SkipperConfig): () => Promise<void>;
+
+type SkipperWorkerFixtures = {
+    _skipperResolver: SkipperResolver;
+};
+type SkipperTestFixtures = {
+    _skipperAutoSkip: void;
+};
+/**
+ * Extended Playwright `test` that automatically skips tests disabled in the spreadsheet.
+ *
+ * The resolver is initialized once per worker (reading from the cache file written
+ * by the globalSetup). Each test is checked via an auto-use fixture.
+ *
+ * Usage: replace `import { test } from '@playwright/test'`
+ *        with    `import { test } from '@get-skipper/playwright'`
+ */
+declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & SkipperTestFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions & SkipperWorkerFixtures>;
+
+/**
+ * SkipperReporter collects all test IDs discovered during the run.
+ * In sync mode (`SKIPPER_MODE=sync`), it reconciles the spreadsheet on completion:
+ * - Adds new tests (with empty disabledUntil)
+ * - Removes rows for tests no longer in the suite
+ *
+ * Add to playwright.config.ts:
+ * ```ts
+ * reporter: [['list'], [SkipperReporter, skipperConfig]]
+ * ```
+ */
+declare class SkipperReporter implements Reporter {
+    private readonly config;
+    private readonly discoveredIds;
+    constructor(config: SkipperConfig);
+    onTestEnd(test: TestCase, _result: TestResult): void;
+    onEnd(_result: FullResult): Promise<void>;
+}
+
+export { SkipperReporter, createSkipperGlobalSetup, test };

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import { SkipperConfig, SkipperResolver } from '@get-skipper/core';
+export { SkipperConfig } from '@get-skipper/core';
+import * as _playwright_test from '@playwright/test';
+export { expect } from '@playwright/test';
+import { Reporter, TestCase, TestResult, FullResult } from '@playwright/test/reporter';
+
+declare function createSkipperGlobalSetup(config: SkipperConfig): () => Promise<void>;
+
+type SkipperWorkerFixtures = {
+    _skipperResolver: SkipperResolver;
+};
+type SkipperTestFixtures = {
+    _skipperAutoSkip: void;
+};
+/**
+ * Extended Playwright `test` that automatically skips tests disabled in the spreadsheet.
+ *
+ * The resolver is initialized once per worker (reading from the cache file written
+ * by the globalSetup). Each test is checked via an auto-use fixture.
+ *
+ * Usage: replace `import { test } from '@playwright/test'`
+ *        with    `import { test } from '@get-skipper/playwright'`
+ */
+declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & SkipperTestFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions & SkipperWorkerFixtures>;
+
+/**
+ * SkipperReporter collects all test IDs discovered during the run.
+ * In sync mode (`SKIPPER_MODE=sync`), it reconciles the spreadsheet on completion:
+ * - Adds new tests (with empty disabledUntil)
+ * - Removes rows for tests no longer in the suite
+ *
+ * Add to playwright.config.ts:
+ * ```ts
+ * reporter: [['list'], [SkipperReporter, skipperConfig]]
+ * ```
+ */
+declare class SkipperReporter implements Reporter {
+    private readonly config;
+    private readonly discoveredIds;
+    constructor(config: SkipperConfig);
+    onTestEnd(test: TestCase, _result: TestResult): void;
+    onEnd(_result: FullResult): Promise<void>;
+}
+
+export { SkipperReporter, createSkipperGlobalSetup, test };

package/dist/index.js

@@ -0,0 +1,114 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SkipperReporter: () => SkipperReporter,
+  createSkipperGlobalSetup: () => createSkipperGlobalSetup,
+  expect: () => import_test2.expect,
+  test: () => test
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/globalSetup.ts
+var fs = __toESM(require("fs"));
+var os = __toESM(require("os"));
+var path = __toESM(require("path"));
+var import_core = require("@get-skipper/core");
+var SKIPPER_CACHE_PATH = path.join(os.tmpdir(), ".skipper-playwright-cache.json");
+function createSkipperGlobalSetup(config) {
+  return async function skipperGlobalSetup() {
+    const resolver = new import_core.SkipperResolver(config);
+    await resolver.initialize();
+    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), "utf8");
+    (0, import_core.log)("[skipper] Spreadsheet loaded and cache written.");
+  };
+}
+
+// src/fixtures.ts
+var fs2 = __toESM(require("fs"));
+var import_test = require("@playwright/test");
+var import_core2 = require("@get-skipper/core");
+var import_test2 = require("@playwright/test");
+var test = import_test.test.extend({
+  _skipperResolver: [
+    async ({}, use) => {
+      const raw = fs2.readFileSync(SKIPPER_CACHE_PATH, "utf8");
+      const data = JSON.parse(raw);
+      const resolver = import_core2.SkipperResolver.fromJSON(data);
+      await use(resolver);
+    },
+    { scope: "worker" }
+  ],
+  _skipperAutoSkip: [
+    async ({ _skipperResolver }, use, testInfo) => {
+      const titlePath = testInfo.titlePath.filter(Boolean);
+      const testId = (0, import_core2.buildTestId)(testInfo.file, titlePath);
+      if (!_skipperResolver.isTestEnabled(testId)) {
+        testInfo.skip(true, `[skipper] Disabled until date in spreadsheet has not passed yet.`);
+      }
+      await use();
+    },
+    { auto: true }
+  ]
+});
+
+// src/reporter.ts
+var import_core3 = require("@get-skipper/core");
+var SkipperReporter = class {
+  constructor(config) {
+    this.discoveredIds = [];
+    this.config = config;
+  }
+  onTestEnd(test2, _result) {
+    const titlePath = test2.titlePath().filter(Boolean);
+    const testId = (0, import_core3.buildTestId)(test2.location.file, titlePath);
+    this.discoveredIds.push(testId);
+  }
+  async onEnd(_result) {
+    const mode = process.env.SKIPPER_MODE;
+    if (mode !== "sync") return;
+    if (this.discoveredIds.length === 0) {
+      (0, import_core3.log)("[skipper] No tests discovered \u2014 skipping spreadsheet sync.");
+      return;
+    }
+    (0, import_core3.log)(`[skipper] Syncing ${this.discoveredIds.length} test(s) to spreadsheet\u2026`);
+    const writer = new import_core3.SheetsWriter(this.config);
+    await writer.sync(this.discoveredIds);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SkipperReporter,
+  createSkipperGlobalSetup,
+  expect,
+  test
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/globalSetup.ts","../src/fixtures.ts","../src/reporter.ts"],"sourcesContent":["export { createSkipperGlobalSetup } from './globalSetup';\nexport { test, expect } from './fixtures';\nexport { SkipperReporter } from './reporter';\nexport type { SkipperConfig } from '@get-skipper/core';\n","import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { SkipperResolver, log } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\nexport const SKIPPER_CACHE_PATH = path.join(os.tmpdir(), '.skipper-playwright-cache.json');\n\nexport function createSkipperGlobalSetup(config: SkipperConfig) {\n  return async function skipperGlobalSetup(): Promise<void> {\n    const resolver = new SkipperResolver(config);\n    await resolver.initialize();\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded and cache written.');\n  };\n}\n","import * as fs from 'fs';\nimport { test as base } from '@playwright/test';\nimport { SkipperResolver, buildTestId } from '@get-skipper/core';\nimport { SKIPPER_CACHE_PATH } from './globalSetup';\n\ntype SkipperWorkerFixtures = {\n  _skipperResolver: SkipperResolver;\n};\n\ntype SkipperTestFixtures = {\n  _skipperAutoSkip: void;\n};\n\n/**\n * Extended Playwright `test` that automatically skips tests disabled in the spreadsheet.\n *\n * The resolver is initialized once per worker (reading from the cache file written\n * by the globalSetup). Each test is checked via an auto-use fixture.\n *\n * Usage: replace `import { test } from '@playwright/test'`\n *        with    `import { test } from '@get-skipper/playwright'`\n */\nexport const test = base.extend<SkipperTestFixtures, SkipperWorkerFixtures>({\n  _skipperResolver: [\n    async ({}, use) => {\n      const raw = fs.readFileSync(SKIPPER_CACHE_PATH, 'utf8');\n      const data = JSON.parse(raw) as Record<string, string | null>;\n      const resolver = SkipperResolver.fromJSON(data);\n      await use(resolver);\n    },\n    { scope: 'worker' },\n  ],\n\n  _skipperAutoSkip: [\n    async ({ _skipperResolver }, use, testInfo) => {\n      const titlePath = testInfo.titlePath.filter(Boolean);\n      const testId = buildTestId(testInfo.file, titlePath);\n\n      if (!_skipperResolver.isTestEnabled(testId)) {\n        testInfo.skip(true, `[skipper] Disabled until date in spreadsheet has not passed yet.`);\n      }\n\n      await use();\n    },\n    { auto: true },\n  ],\n});\n\nexport { expect } from '@playwright/test';\n","import type { Reporter, TestCase, TestResult, FullResult } from '@playwright/test/reporter';\nimport { SheetsWriter, buildTestId, log } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\n/**\n * SkipperReporter collects all test IDs discovered during the run.\n * In sync mode (`SKIPPER_MODE=sync`), it reconciles the spreadsheet on completion:\n * - Adds new tests (with empty disabledUntil)\n * - Removes rows for tests no longer in the suite\n *\n * Add to playwright.config.ts:\n * ```ts\n * reporter: [['list'], [SkipperReporter, skipperConfig]]\n * ```\n */\nexport class SkipperReporter implements Reporter {\n  private readonly config: SkipperConfig;\n  private readonly discoveredIds: string[] = [];\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n  }\n\n  onTestEnd(test: TestCase, _result: TestResult): void {\n    const titlePath = test.titlePath().filter(Boolean);\n    const testId = buildTestId(test.location.file, titlePath);\n    this.discoveredIds.push(testId);\n  }\n\n  async onEnd(_result: FullResult): Promise<void> {\n    const mode = process.env.SKIPPER_MODE;\n    if (mode !== 'sync') return;\n\n    if (this.discoveredIds.length === 0) {\n      log('[skipper] No tests discovered — skipping spreadsheet sync.');\n      return;\n    }\n\n    log(`[skipper] Syncing ${this.discoveredIds.length} test(s) to spreadsheet…`);\n    const writer = new SheetsWriter(this.config);\n    await writer.sync(this.discoveredIds);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,SAAoB;AACpB,SAAoB;AACpB,WAAsB;AACtB,kBAAqC;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,gCAAgC;AAElF,SAAS,yBAAyB,QAAuB;AAC9D,SAAO,eAAe,qBAAoC;AACxD,UAAM,WAAW,IAAI,4BAAgB,MAAM;AAC3C,UAAM,SAAS,WAAW;AAC1B,IAAG,iBAAc,oBAAoB,KAAK,UAAU,SAAS,OAAO,CAAC,GAAG,MAAM;AAC9E,yBAAI,iDAAiD;AAAA,EACvD;AACF;;;ACfA,IAAAA,MAAoB;AACpB,kBAA6B;AAC7B,IAAAC,eAA6C;AA8C7C,IAAAC,eAAuB;AA1BhB,IAAM,OAAO,YAAAC,KAAK,OAAmD;AAAA,EAC1E,kBAAkB;AAAA,IAChB,OAAO,CAAC,GAAG,QAAQ;AACjB,YAAM,MAAS,iBAAa,oBAAoB,MAAM;AACtD,YAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,YAAM,WAAW,6BAAgB,SAAS,IAAI;AAC9C,YAAM,IAAI,QAAQ;AAAA,IACpB;AAAA,IACA,EAAE,OAAO,SAAS;AAAA,EACpB;AAAA,EAEA,kBAAkB;AAAA,IAChB,OAAO,EAAE,iBAAiB,GAAG,KAAK,aAAa;AAC7C,YAAM,YAAY,SAAS,UAAU,OAAO,OAAO;AACnD,YAAM,aAAS,0BAAY,SAAS,MAAM,SAAS;AAEnD,UAAI,CAAC,iBAAiB,cAAc,MAAM,GAAG;AAC3C,iBAAS,KAAK,MAAM,kEAAkE;AAAA,MACxF;AAEA,YAAM,IAAI;AAAA,IACZ;AAAA,IACA,EAAE,MAAM,KAAK;AAAA,EACf;AACF,CAAC;;;AC7CD,IAAAC,eAA+C;AAcxC,IAAM,kBAAN,MAA0C;AAAA,EAI/C,YAAY,QAAuB;AAFnC,SAAiB,gBAA0B,CAAC;AAG1C,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,UAAUC,OAAgB,SAA2B;AACnD,UAAM,YAAYA,MAAK,UAAU,EAAE,OAAO,OAAO;AACjD,UAAM,aAAS,0BAAYA,MAAK,SAAS,MAAM,SAAS;AACxD,SAAK,cAAc,KAAK,MAAM;AAAA,EAChC;AAAA,EAEA,MAAM,MAAM,SAAoC;AAC9C,UAAM,OAAO,QAAQ,IAAI;AACzB,QAAI,SAAS,OAAQ;AAErB,QAAI,KAAK,cAAc,WAAW,GAAG;AACnC,4BAAI,iEAA4D;AAChE;AAAA,IACF;AAEA,0BAAI,qBAAqB,KAAK,cAAc,MAAM,+BAA0B;AAC5E,UAAM,SAAS,IAAI,0BAAa,KAAK,MAAM;AAC3C,UAAM,OAAO,KAAK,KAAK,aAAa;AAAA,EACtC;AACF;","names":["fs","import_core","import_test","base","import_core","test"]}

package/dist/index.mjs

@@ -0,0 +1,74 @@
+// src/globalSetup.ts
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { SkipperResolver, log } from "@get-skipper/core";
+var SKIPPER_CACHE_PATH = path.join(os.tmpdir(), ".skipper-playwright-cache.json");
+function createSkipperGlobalSetup(config) {
+  return async function skipperGlobalSetup() {
+    const resolver = new SkipperResolver(config);
+    await resolver.initialize();
+    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), "utf8");
+    log("[skipper] Spreadsheet loaded and cache written.");
+  };
+}
+
+// src/fixtures.ts
+import * as fs2 from "fs";
+import { test as base } from "@playwright/test";
+import { SkipperResolver as SkipperResolver2, buildTestId } from "@get-skipper/core";
+import { expect } from "@playwright/test";
+var test = base.extend({
+  _skipperResolver: [
+    async ({}, use) => {
+      const raw = fs2.readFileSync(SKIPPER_CACHE_PATH, "utf8");
+      const data = JSON.parse(raw);
+      const resolver = SkipperResolver2.fromJSON(data);
+      await use(resolver);
+    },
+    { scope: "worker" }
+  ],
+  _skipperAutoSkip: [
+    async ({ _skipperResolver }, use, testInfo) => {
+      const titlePath = testInfo.titlePath.filter(Boolean);
+      const testId = buildTestId(testInfo.file, titlePath);
+      if (!_skipperResolver.isTestEnabled(testId)) {
+        testInfo.skip(true, `[skipper] Disabled until date in spreadsheet has not passed yet.`);
+      }
+      await use();
+    },
+    { auto: true }
+  ]
+});
+
+// src/reporter.ts
+import { SheetsWriter, buildTestId as buildTestId2, log as log2 } from "@get-skipper/core";
+var SkipperReporter = class {
+  constructor(config) {
+    this.discoveredIds = [];
+    this.config = config;
+  }
+  onTestEnd(test2, _result) {
+    const titlePath = test2.titlePath().filter(Boolean);
+    const testId = buildTestId2(test2.location.file, titlePath);
+    this.discoveredIds.push(testId);
+  }
+  async onEnd(_result) {
+    const mode = process.env.SKIPPER_MODE;
+    if (mode !== "sync") return;
+    if (this.discoveredIds.length === 0) {
+      log2("[skipper] No tests discovered \u2014 skipping spreadsheet sync.");
+      return;
+    }
+    log2(`[skipper] Syncing ${this.discoveredIds.length} test(s) to spreadsheet\u2026`);
+    const writer = new SheetsWriter(this.config);
+    await writer.sync(this.discoveredIds);
+  }
+};
+export {
+  SkipperReporter,
+  createSkipperGlobalSetup,
+  expect,
+  test
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/globalSetup.ts","../src/fixtures.ts","../src/reporter.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { SkipperResolver, log } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\nexport const SKIPPER_CACHE_PATH = path.join(os.tmpdir(), '.skipper-playwright-cache.json');\n\nexport function createSkipperGlobalSetup(config: SkipperConfig) {\n  return async function skipperGlobalSetup(): Promise<void> {\n    const resolver = new SkipperResolver(config);\n    await resolver.initialize();\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded and cache written.');\n  };\n}\n","import * as fs from 'fs';\nimport { test as base } from '@playwright/test';\nimport { SkipperResolver, buildTestId } from '@get-skipper/core';\nimport { SKIPPER_CACHE_PATH } from './globalSetup';\n\ntype SkipperWorkerFixtures = {\n  _skipperResolver: SkipperResolver;\n};\n\ntype SkipperTestFixtures = {\n  _skipperAutoSkip: void;\n};\n\n/**\n * Extended Playwright `test` that automatically skips tests disabled in the spreadsheet.\n *\n * The resolver is initialized once per worker (reading from the cache file written\n * by the globalSetup). Each test is checked via an auto-use fixture.\n *\n * Usage: replace `import { test } from '@playwright/test'`\n *        with    `import { test } from '@get-skipper/playwright'`\n */\nexport const test = base.extend<SkipperTestFixtures, SkipperWorkerFixtures>({\n  _skipperResolver: [\n    async ({}, use) => {\n      const raw = fs.readFileSync(SKIPPER_CACHE_PATH, 'utf8');\n      const data = JSON.parse(raw) as Record<string, string | null>;\n      const resolver = SkipperResolver.fromJSON(data);\n      await use(resolver);\n    },\n    { scope: 'worker' },\n  ],\n\n  _skipperAutoSkip: [\n    async ({ _skipperResolver }, use, testInfo) => {\n      const titlePath = testInfo.titlePath.filter(Boolean);\n      const testId = buildTestId(testInfo.file, titlePath);\n\n      if (!_skipperResolver.isTestEnabled(testId)) {\n        testInfo.skip(true, `[skipper] Disabled until date in spreadsheet has not passed yet.`);\n      }\n\n      await use();\n    },\n    { auto: true },\n  ],\n});\n\nexport { expect } from '@playwright/test';\n","import type { Reporter, TestCase, TestResult, FullResult } from '@playwright/test/reporter';\nimport { SheetsWriter, buildTestId, log } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\n/**\n * SkipperReporter collects all test IDs discovered during the run.\n * In sync mode (`SKIPPER_MODE=sync`), it reconciles the spreadsheet on completion:\n * - Adds new tests (with empty disabledUntil)\n * - Removes rows for tests no longer in the suite\n *\n * Add to playwright.config.ts:\n * ```ts\n * reporter: [['list'], [SkipperReporter, skipperConfig]]\n * ```\n */\nexport class SkipperReporter implements Reporter {\n  private readonly config: SkipperConfig;\n  private readonly discoveredIds: string[] = [];\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n  }\n\n  onTestEnd(test: TestCase, _result: TestResult): void {\n    const titlePath = test.titlePath().filter(Boolean);\n    const testId = buildTestId(test.location.file, titlePath);\n    this.discoveredIds.push(testId);\n  }\n\n  async onEnd(_result: FullResult): Promise<void> {\n    const mode = process.env.SKIPPER_MODE;\n    if (mode !== 'sync') return;\n\n    if (this.discoveredIds.length === 0) {\n      log('[skipper] No tests discovered — skipping spreadsheet sync.');\n      return;\n    }\n\n    log(`[skipper] Syncing ${this.discoveredIds.length} test(s) to spreadsheet…`);\n    const writer = new SheetsWriter(this.config);\n    await writer.sync(this.discoveredIds);\n  }\n}\n"],"mappings":";AAAA,YAAY,QAAQ;AACpB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,iBAAiB,WAAW;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,gCAAgC;AAElF,SAAS,yBAAyB,QAAuB;AAC9D,SAAO,eAAe,qBAAoC;AACxD,UAAM,WAAW,IAAI,gBAAgB,MAAM;AAC3C,UAAM,SAAS,WAAW;AAC1B,IAAG,iBAAc,oBAAoB,KAAK,UAAU,SAAS,OAAO,CAAC,GAAG,MAAM;AAC9E,QAAI,iDAAiD;AAAA,EACvD;AACF;;;ACfA,YAAYA,SAAQ;AACpB,SAAS,QAAQ,YAAY;AAC7B,SAAS,mBAAAC,kBAAiB,mBAAmB;AA8C7C,SAAS,cAAc;AA1BhB,IAAM,OAAO,KAAK,OAAmD;AAAA,EAC1E,kBAAkB;AAAA,IAChB,OAAO,CAAC,GAAG,QAAQ;AACjB,YAAM,MAAS,iBAAa,oBAAoB,MAAM;AACtD,YAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,YAAM,WAAWC,iBAAgB,SAAS,IAAI;AAC9C,YAAM,IAAI,QAAQ;AAAA,IACpB;AAAA,IACA,EAAE,OAAO,SAAS;AAAA,EACpB;AAAA,EAEA,kBAAkB;AAAA,IAChB,OAAO,EAAE,iBAAiB,GAAG,KAAK,aAAa;AAC7C,YAAM,YAAY,SAAS,UAAU,OAAO,OAAO;AACnD,YAAM,SAAS,YAAY,SAAS,MAAM,SAAS;AAEnD,UAAI,CAAC,iBAAiB,cAAc,MAAM,GAAG;AAC3C,iBAAS,KAAK,MAAM,kEAAkE;AAAA,MACxF;AAEA,YAAM,IAAI;AAAA,IACZ;AAAA,IACA,EAAE,MAAM,KAAK;AAAA,EACf;AACF,CAAC;;;AC7CD,SAAS,cAAc,eAAAC,cAAa,OAAAC,YAAW;AAcxC,IAAM,kBAAN,MAA0C;AAAA,EAI/C,YAAY,QAAuB;AAFnC,SAAiB,gBAA0B,CAAC;AAG1C,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,UAAUC,OAAgB,SAA2B;AACnD,UAAM,YAAYA,MAAK,UAAU,EAAE,OAAO,OAAO;AACjD,UAAM,SAASF,aAAYE,MAAK,SAAS,MAAM,SAAS;AACxD,SAAK,cAAc,KAAK,MAAM;AAAA,EAChC;AAAA,EAEA,MAAM,MAAM,SAAoC;AAC9C,UAAM,OAAO,QAAQ,IAAI;AACzB,QAAI,SAAS,OAAQ;AAErB,QAAI,KAAK,cAAc,WAAW,GAAG;AACnC,MAAAD,KAAI,iEAA4D;AAChE;AAAA,IACF;AAEA,IAAAA,KAAI,qBAAqB,KAAK,cAAc,MAAM,+BAA0B;AAC5E,UAAM,SAAS,IAAI,aAAa,KAAK,MAAM;AAC3C,UAAM,OAAO,KAAK,KAAK,aAAa;AAAA,EACtC;AACF;","names":["fs","SkipperResolver","SkipperResolver","buildTestId","log","test"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@get-skipper/playwright",
+  "version": "1.0.0",
+  "description": "Skipper plugin for Playwright — enable/disable tests from a Google Spreadsheet",
+  "keywords": [
+    "skipper",
+    "playwright",
+    "testing",
+    "google-sheets",
+    "test-gating"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@get-skipper/core": "1.0.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest --config ../../jest.config.js --testPathPattern=packages/playwright/"
+  }
+}