@get-skipper/vitest 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,55 @@
+# @get-skipper/vitest
+
+Skipper plugin for [Vitest](https://vitest.dev/) — enable/disable tests from a Google Spreadsheet.
+
+## Installation
+
+```bash
+pnpm add -D @get-skipper/vitest
+# or
+npm install --save-dev @get-skipper/vitest
+```
+
+## Setup
+
+Update `vitest.config.ts` — this is the **only change required**:
+
+```ts
+import { defineConfig } from 'vitest/config';
+import { createSkipperGlobalSetup, createSkipperGlobalTeardown, setupFile } from '@get-skipper/vitest';
+
+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({
+  test: {
+    globalSetup: [createSkipperGlobalSetup(skipperConfig)],
+    globalTeardown: [createSkipperGlobalTeardown(skipperConfig)],
+    setupFiles: [setupFile],
+    // ... rest of your config
+  },
+});
+```
+
+No changes to test files are required. Tests with a future `disabledUntil` date are automatically skipped.
+
+## Test ID Format
+
+```
+{relative file path} > {describe block(s)} > {test name}
+```
+
+## 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.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { SkipperConfig } from '@get-skipper/core';
+export { SkipperConfig } from '@get-skipper/core';
+
+declare function createSkipperGlobalSetup(config: SkipperConfig): () => Promise<void>;
+
+declare function createSkipperGlobalTeardown(config: SkipperConfig): () => Promise<void>;
+
+/**
+ * Absolute path to the setup file.
+ * Add to `setupFiles` in vitest.config.ts:
+ *
+ * ```ts
+ * import { setupFile } from '@get-skipper/vitest';
+ * export default defineConfig({ test: { setupFiles: [setupFile] } });
+ * ```
+ */
+declare const setupFile: string;
+
+export { createSkipperGlobalSetup, createSkipperGlobalTeardown, setupFile };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { SkipperConfig } from '@get-skipper/core';
+export { SkipperConfig } from '@get-skipper/core';
+
+declare function createSkipperGlobalSetup(config: SkipperConfig): () => Promise<void>;
+
+declare function createSkipperGlobalTeardown(config: SkipperConfig): () => Promise<void>;
+
+/**
+ * Absolute path to the setup file.
+ * Add to `setupFiles` in vitest.config.ts:
+ *
+ * ```ts
+ * import { setupFile } from '@get-skipper/vitest';
+ * export default defineConfig({ test: { setupFiles: [setupFile] } });
+ * ```
+ */
+declare const setupFile: string;
+
+export { createSkipperGlobalSetup, createSkipperGlobalTeardown, setupFile };

package/dist/index.js

@@ -0,0 +1,86 @@
+"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, {
+  createSkipperGlobalSetup: () => createSkipperGlobalSetup,
+  createSkipperGlobalTeardown: () => createSkipperGlobalTeardown,
+  setupFile: () => setupFile
+});
+module.exports = __toCommonJS(index_exports);
+var path2 = __toESM(require("path"));
+
+// 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-vitest-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.");
+  };
+}
+
+// src/globalTeardown.ts
+var import_core2 = require("@get-skipper/core");
+function createSkipperGlobalTeardown(config) {
+  return async function skipperGlobalTeardown() {
+    if (process.env.SKIPPER_MODE !== "sync") return;
+    const raw = process.env.SKIPPER_DISCOVERED_TESTS;
+    if (!raw) {
+      (0, import_core2.warn)("[skipper] No discovered tests found \u2014 skipping spreadsheet sync.");
+      return;
+    }
+    let discoveredIds;
+    try {
+      discoveredIds = JSON.parse(raw);
+    } catch {
+      (0, import_core2.error)("[skipper] Failed to parse SKIPPER_DISCOVERED_TESTS \u2014 skipping sync.");
+      return;
+    }
+    (0, import_core2.log)(`[skipper] Syncing ${discoveredIds.length} test(s) to spreadsheet\u2026`);
+    const writer = new import_core2.SheetsWriter(config);
+    await writer.sync(discoveredIds);
+  };
+}
+
+// src/index.ts
+var setupFile = path2.resolve(__dirname, "setup.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSkipperGlobalSetup,
+  createSkipperGlobalTeardown,
+  setupFile
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/globalSetup.ts","../src/globalTeardown.ts"],"sourcesContent":["import * as path from 'path';\n\nexport { createSkipperGlobalSetup } from './globalSetup';\nexport { createSkipperGlobalTeardown } from './globalTeardown';\nexport type { SkipperConfig } from '@get-skipper/core';\n\n/**\n * Absolute path to the setup file.\n * Add to `setupFiles` in vitest.config.ts:\n *\n * ```ts\n * import { setupFile } from '@get-skipper/vitest';\n * export default defineConfig({ test: { setupFiles: [setupFile] } });\n * ```\n */\nexport const setupFile = path.resolve(__dirname, 'setup.js');\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-vitest-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    // Write cache to a temp file instead of an env var to avoid OS env-var size\n    // limits for large test suites. Vitest workers can read this shared file.\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded.');\n  };\n}\n","import { SheetsWriter, log, warn, error } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\nexport function createSkipperGlobalTeardown(config: SkipperConfig) {\n  return async function skipperGlobalTeardown(): Promise<void> {\n    if (process.env.SKIPPER_MODE !== 'sync') return;\n\n    const raw = process.env.SKIPPER_DISCOVERED_TESTS;\n    if (!raw) {\n      warn('[skipper] No discovered tests found — skipping spreadsheet sync.');\n      return;\n    }\n\n    let discoveredIds: string[];\n    try {\n      discoveredIds = JSON.parse(raw) as string[];\n    } catch {\n      error('[skipper] Failed to parse SKIPPER_DISCOVERED_TESTS — skipping sync.');\n      return;\n    }\n\n    log(`[skipper] Syncing ${discoveredIds.length} test(s) to spreadsheet…`);\n    const writer = new SheetsWriter(config);\n    await writer.sync(discoveredIds);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,QAAsB;;;ACAtB,SAAoB;AACpB,SAAoB;AACpB,WAAsB;AACtB,kBAAqC;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,4BAA4B;AAE9E,SAAS,yBAAyB,QAAuB;AAC9D,SAAO,eAAe,qBAAoC;AACxD,UAAM,WAAW,IAAI,4BAAgB,MAAM;AAC3C,UAAM,SAAS,WAAW;AAG1B,IAAG,iBAAc,oBAAoB,KAAK,UAAU,SAAS,OAAO,CAAC,GAAG,MAAM;AAC9E,yBAAI,+BAA+B;AAAA,EACrC;AACF;;;ACjBA,IAAAC,eAA+C;AAGxC,SAAS,4BAA4B,QAAuB;AACjE,SAAO,eAAe,wBAAuC;AAC3D,QAAI,QAAQ,IAAI,iBAAiB,OAAQ;AAEzC,UAAM,MAAM,QAAQ,IAAI;AACxB,QAAI,CAAC,KAAK;AACR,6BAAK,uEAAkE;AACvE;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,sBAAgB,KAAK,MAAM,GAAG;AAAA,IAChC,QAAQ;AACN,8BAAM,0EAAqE;AAC3E;AAAA,IACF;AAEA,0BAAI,qBAAqB,cAAc,MAAM,+BAA0B;AACvE,UAAM,SAAS,IAAI,0BAAa,MAAM;AACtC,UAAM,OAAO,KAAK,aAAa;AAAA,EACjC;AACF;;;AFVO,IAAM,YAAiB,cAAQ,WAAW,UAAU;","names":["path","import_core"]}

package/dist/index.mjs

@@ -0,0 +1,49 @@
+// src/index.ts
+import * as path2 from "path";
+
+// 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-vitest-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.");
+  };
+}
+
+// src/globalTeardown.ts
+import { SheetsWriter, log as log2, warn, error } from "@get-skipper/core";
+function createSkipperGlobalTeardown(config) {
+  return async function skipperGlobalTeardown() {
+    if (process.env.SKIPPER_MODE !== "sync") return;
+    const raw = process.env.SKIPPER_DISCOVERED_TESTS;
+    if (!raw) {
+      warn("[skipper] No discovered tests found \u2014 skipping spreadsheet sync.");
+      return;
+    }
+    let discoveredIds;
+    try {
+      discoveredIds = JSON.parse(raw);
+    } catch {
+      error("[skipper] Failed to parse SKIPPER_DISCOVERED_TESTS \u2014 skipping sync.");
+      return;
+    }
+    log2(`[skipper] Syncing ${discoveredIds.length} test(s) to spreadsheet\u2026`);
+    const writer = new SheetsWriter(config);
+    await writer.sync(discoveredIds);
+  };
+}
+
+// src/index.ts
+var setupFile = path2.resolve(__dirname, "setup.js");
+export {
+  createSkipperGlobalSetup,
+  createSkipperGlobalTeardown,
+  setupFile
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/globalSetup.ts","../src/globalTeardown.ts"],"sourcesContent":["import * as path from 'path';\n\nexport { createSkipperGlobalSetup } from './globalSetup';\nexport { createSkipperGlobalTeardown } from './globalTeardown';\nexport type { SkipperConfig } from '@get-skipper/core';\n\n/**\n * Absolute path to the setup file.\n * Add to `setupFiles` in vitest.config.ts:\n *\n * ```ts\n * import { setupFile } from '@get-skipper/vitest';\n * export default defineConfig({ test: { setupFiles: [setupFile] } });\n * ```\n */\nexport const setupFile = path.resolve(__dirname, 'setup.js');\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-vitest-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    // Write cache to a temp file instead of an env var to avoid OS env-var size\n    // limits for large test suites. Vitest workers can read this shared file.\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded.');\n  };\n}\n","import { SheetsWriter, log, warn, error } from '@get-skipper/core';\nimport type { SkipperConfig } from '@get-skipper/core';\n\nexport function createSkipperGlobalTeardown(config: SkipperConfig) {\n  return async function skipperGlobalTeardown(): Promise<void> {\n    if (process.env.SKIPPER_MODE !== 'sync') return;\n\n    const raw = process.env.SKIPPER_DISCOVERED_TESTS;\n    if (!raw) {\n      warn('[skipper] No discovered tests found — skipping spreadsheet sync.');\n      return;\n    }\n\n    let discoveredIds: string[];\n    try {\n      discoveredIds = JSON.parse(raw) as string[];\n    } catch {\n      error('[skipper] Failed to parse SKIPPER_DISCOVERED_TESTS — skipping sync.');\n      return;\n    }\n\n    log(`[skipper] Syncing ${discoveredIds.length} test(s) to spreadsheet…`);\n    const writer = new SheetsWriter(config);\n    await writer.sync(discoveredIds);\n  };\n}\n"],"mappings":";AAAA,YAAYA,WAAU;;;ACAtB,YAAY,QAAQ;AACpB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,iBAAiB,WAAW;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,4BAA4B;AAE9E,SAAS,yBAAyB,QAAuB;AAC9D,SAAO,eAAe,qBAAoC;AACxD,UAAM,WAAW,IAAI,gBAAgB,MAAM;AAC3C,UAAM,SAAS,WAAW;AAG1B,IAAG,iBAAc,oBAAoB,KAAK,UAAU,SAAS,OAAO,CAAC,GAAG,MAAM;AAC9E,QAAI,+BAA+B;AAAA,EACrC;AACF;;;ACjBA,SAAS,cAAc,OAAAC,MAAK,MAAM,aAAa;AAGxC,SAAS,4BAA4B,QAAuB;AACjE,SAAO,eAAe,wBAAuC;AAC3D,QAAI,QAAQ,IAAI,iBAAiB,OAAQ;AAEzC,UAAM,MAAM,QAAQ,IAAI;AACxB,QAAI,CAAC,KAAK;AACR,WAAK,uEAAkE;AACvE;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,sBAAgB,KAAK,MAAM,GAAG;AAAA,IAChC,QAAQ;AACN,YAAM,0EAAqE;AAC3E;AAAA,IACF;AAEA,IAAAA,KAAI,qBAAqB,cAAc,MAAM,+BAA0B;AACvE,UAAM,SAAS,IAAI,aAAa,MAAM;AACtC,UAAM,OAAO,KAAK,aAAa;AAAA,EACjC;AACF;;;AFVO,IAAM,YAAiB,cAAQ,WAAW,UAAU;","names":["path","log"]}

package/dist/setup.js

@@ -0,0 +1,87 @@
+"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 __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
+));
+
+// src/setup.ts
+var fs = __toESM(require("fs"));
+var import_core2 = require("@get-skipper/core");
+
+// src/globalSetup.ts
+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-vitest-cache.json");
+
+// src/setup.ts
+var g = globalThis;
+function getResolver() {
+  if (!fs.existsSync(SKIPPER_CACHE_PATH)) {
+    throw new Error(
+      "[skipper] Skipper cache file not found. Did you add createSkipperGlobalSetup() to globalSetup in vitest.config?"
+    );
+  }
+  const raw = fs.readFileSync(SKIPPER_CACHE_PATH, "utf8");
+  return import_core2.SkipperResolver.fromJSON(JSON.parse(raw));
+}
+var resolver = getResolver();
+var describeStack = [];
+function appendDiscovered(testId) {
+  const existing = process.env.SKIPPER_DISCOVERED_TESTS;
+  const arr = existing ? JSON.parse(existing) : [];
+  arr.push(testId);
+  process.env.SKIPPER_DISCOVERED_TESTS = JSON.stringify(arr);
+}
+var originalDescribe = g.describe;
+if (originalDescribe) {
+  g.describe = Object.assign(
+    (name, fn) => {
+      describeStack.push(name);
+      originalDescribe(name, () => {
+        try {
+          fn();
+        } finally {
+          describeStack.pop();
+        }
+      });
+    },
+    originalDescribe
+  );
+}
+var originalTest = g.test;
+if (originalTest) {
+  const wrapped = Object.assign(
+    (name, fn, timeout) => {
+      if (fn === void 0) return originalTest(name, fn, timeout);
+      const stack = new Error().stack ?? "";
+      const match = stack.match(/\((.+?):\d+:\d+\)/);
+      const filePath = match ? match[1] : "unknown";
+      const testId = (0, import_core2.buildTestId)(filePath, [...describeStack, name]);
+      appendDiscovered(testId);
+      return resolver.isTestEnabled(testId) ? originalTest(name, fn, timeout) : originalTest.skip(name, fn, timeout);
+    },
+    originalTest
+  );
+  g.test = wrapped;
+  g.it = wrapped;
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup.ts","../src/globalSetup.ts"],"sourcesContent":["/**\n * Vitest setup file — add to `setupFiles` in vitest.config.ts.\n *\n * This file:\n * 1. Rehydrates the SkipperResolver from the cache file written by globalSetup\n * 2. Overrides globalThis.test / globalThis.it to auto-skip disabled tests\n * 3. Collects all discovered test IDs into SKIPPER_DISCOVERED_TESTS for sync mode\n */\nimport * as fs from 'fs';\nimport { SkipperResolver, buildTestId } from '@get-skipper/core';\nimport { SKIPPER_CACHE_PATH } from './globalSetup';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst g = globalThis as any;\n\nfunction getResolver(): SkipperResolver {\n  if (!fs.existsSync(SKIPPER_CACHE_PATH)) {\n    throw new Error(\n      '[skipper] Skipper cache file not found. ' +\n        'Did you add createSkipperGlobalSetup() to globalSetup in vitest.config?',\n    );\n  }\n  const raw = fs.readFileSync(SKIPPER_CACHE_PATH, 'utf8');\n  return SkipperResolver.fromJSON(JSON.parse(raw) as Record<string, string | null>);\n}\n\nconst resolver = getResolver();\n\n// Stack tracking current describe blocks\nconst describeStack: string[] = [];\n\nfunction appendDiscovered(testId: string): void {\n  const existing = process.env.SKIPPER_DISCOVERED_TESTS;\n  const arr: string[] = existing ? JSON.parse(existing) : [];\n  arr.push(testId);\n  process.env.SKIPPER_DISCOVERED_TESTS = JSON.stringify(arr);\n}\n\n// Override describe to maintain the stack\nconst originalDescribe = g.describe as ((name: string, fn: () => void) => void) | undefined;\nif (originalDescribe) {\n  g.describe = Object.assign(\n    (name: string, fn: () => void) => {\n      describeStack.push(name);\n      originalDescribe(name, () => {\n        try {\n          fn();\n        } finally {\n          describeStack.pop();\n        }\n      });\n    },\n    originalDescribe,\n  );\n}\n\n// Override test / it\ntype TestLike = ((name: string, fn?: () => void | Promise<void>, timeout?: number) => void) & {\n  skip: (name: string, fn?: () => void | Promise<void>, timeout?: number) => void;\n  [key: string]: unknown;\n};\n\nconst originalTest = g.test as TestLike | undefined;\nif (originalTest) {\n  const wrapped = Object.assign(\n    (name: string, fn?: () => void | Promise<void>, timeout?: number) => {\n      if (fn === undefined) return originalTest(name, fn, timeout);\n\n      // Derive file path from Error stack\n      const stack = new Error().stack ?? '';\n      const match = stack.match(/\\((.+?):\\d+:\\d+\\)/);\n      const filePath = match ? match[1] : 'unknown';\n\n      const testId = buildTestId(filePath, [...describeStack, name]);\n      appendDiscovered(testId);\n\n      return resolver.isTestEnabled(testId)\n        ? originalTest(name, fn, timeout)\n        : originalTest.skip(name, fn, timeout);\n    },\n    originalTest,\n  );\n\n  g.test = wrapped;\n  g.it = wrapped;\n}\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-vitest-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    // Write cache to a temp file instead of an env var to avoid OS env-var size\n    // limits for large test suites. Vitest workers can read this shared file.\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded.');\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAQA,SAAoB;AACpB,IAAAA,eAA6C;;;ACR7C,SAAoB;AACpB,WAAsB;AACtB,kBAAqC;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,4BAA4B;;;ADOrF,IAAM,IAAI;AAEV,SAAS,cAA+B;AACtC,MAAI,CAAI,cAAW,kBAAkB,GAAG;AACtC,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,QAAM,MAAS,gBAAa,oBAAoB,MAAM;AACtD,SAAO,6BAAgB,SAAS,KAAK,MAAM,GAAG,CAAkC;AAClF;AAEA,IAAM,WAAW,YAAY;AAG7B,IAAM,gBAA0B,CAAC;AAEjC,SAAS,iBAAiB,QAAsB;AAC9C,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,MAAgB,WAAW,KAAK,MAAM,QAAQ,IAAI,CAAC;AACzD,MAAI,KAAK,MAAM;AACf,UAAQ,IAAI,2BAA2B,KAAK,UAAU,GAAG;AAC3D;AAGA,IAAM,mBAAmB,EAAE;AAC3B,IAAI,kBAAkB;AACpB,IAAE,WAAW,OAAO;AAAA,IAClB,CAAC,MAAc,OAAmB;AAChC,oBAAc,KAAK,IAAI;AACvB,uBAAiB,MAAM,MAAM;AAC3B,YAAI;AACF,aAAG;AAAA,QACL,UAAE;AACA,wBAAc,IAAI;AAAA,QACpB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA;AAAA,EACF;AACF;AAQA,IAAM,eAAe,EAAE;AACvB,IAAI,cAAc;AAChB,QAAM,UAAU,OAAO;AAAA,IACrB,CAAC,MAAc,IAAiC,YAAqB;AACnE,UAAI,OAAO,OAAW,QAAO,aAAa,MAAM,IAAI,OAAO;AAG3D,YAAM,QAAQ,IAAI,MAAM,EAAE,SAAS;AACnC,YAAM,QAAQ,MAAM,MAAM,mBAAmB;AAC7C,YAAM,WAAW,QAAQ,MAAM,CAAC,IAAI;AAEpC,YAAM,aAAS,0BAAY,UAAU,CAAC,GAAG,eAAe,IAAI,CAAC;AAC7D,uBAAiB,MAAM;AAEvB,aAAO,SAAS,cAAc,MAAM,IAChC,aAAa,MAAM,IAAI,OAAO,IAC9B,aAAa,KAAK,MAAM,IAAI,OAAO;AAAA,IACzC;AAAA,IACA;AAAA,EACF;AAEA,IAAE,OAAO;AACT,IAAE,KAAK;AACT;","names":["import_core"]}

package/dist/setup.mjs

@@ -0,0 +1,63 @@
+// src/setup.ts
+import * as fs from "fs";
+import { SkipperResolver as SkipperResolver2, buildTestId } from "@get-skipper/core";
+
+// src/globalSetup.ts
+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-vitest-cache.json");
+
+// src/setup.ts
+var g = globalThis;
+function getResolver() {
+  if (!fs.existsSync(SKIPPER_CACHE_PATH)) {
+    throw new Error(
+      "[skipper] Skipper cache file not found. Did you add createSkipperGlobalSetup() to globalSetup in vitest.config?"
+    );
+  }
+  const raw = fs.readFileSync(SKIPPER_CACHE_PATH, "utf8");
+  return SkipperResolver2.fromJSON(JSON.parse(raw));
+}
+var resolver = getResolver();
+var describeStack = [];
+function appendDiscovered(testId) {
+  const existing = process.env.SKIPPER_DISCOVERED_TESTS;
+  const arr = existing ? JSON.parse(existing) : [];
+  arr.push(testId);
+  process.env.SKIPPER_DISCOVERED_TESTS = JSON.stringify(arr);
+}
+var originalDescribe = g.describe;
+if (originalDescribe) {
+  g.describe = Object.assign(
+    (name, fn) => {
+      describeStack.push(name);
+      originalDescribe(name, () => {
+        try {
+          fn();
+        } finally {
+          describeStack.pop();
+        }
+      });
+    },
+    originalDescribe
+  );
+}
+var originalTest = g.test;
+if (originalTest) {
+  const wrapped = Object.assign(
+    (name, fn, timeout) => {
+      if (fn === void 0) return originalTest(name, fn, timeout);
+      const stack = new Error().stack ?? "";
+      const match = stack.match(/\((.+?):\d+:\d+\)/);
+      const filePath = match ? match[1] : "unknown";
+      const testId = buildTestId(filePath, [...describeStack, name]);
+      appendDiscovered(testId);
+      return resolver.isTestEnabled(testId) ? originalTest(name, fn, timeout) : originalTest.skip(name, fn, timeout);
+    },
+    originalTest
+  );
+  g.test = wrapped;
+  g.it = wrapped;
+}
+//# sourceMappingURL=setup.mjs.map

package/dist/setup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup.ts","../src/globalSetup.ts"],"sourcesContent":["/**\n * Vitest setup file — add to `setupFiles` in vitest.config.ts.\n *\n * This file:\n * 1. Rehydrates the SkipperResolver from the cache file written by globalSetup\n * 2. Overrides globalThis.test / globalThis.it to auto-skip disabled tests\n * 3. Collects all discovered test IDs into SKIPPER_DISCOVERED_TESTS for sync mode\n */\nimport * as fs from 'fs';\nimport { SkipperResolver, buildTestId } from '@get-skipper/core';\nimport { SKIPPER_CACHE_PATH } from './globalSetup';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst g = globalThis as any;\n\nfunction getResolver(): SkipperResolver {\n  if (!fs.existsSync(SKIPPER_CACHE_PATH)) {\n    throw new Error(\n      '[skipper] Skipper cache file not found. ' +\n        'Did you add createSkipperGlobalSetup() to globalSetup in vitest.config?',\n    );\n  }\n  const raw = fs.readFileSync(SKIPPER_CACHE_PATH, 'utf8');\n  return SkipperResolver.fromJSON(JSON.parse(raw) as Record<string, string | null>);\n}\n\nconst resolver = getResolver();\n\n// Stack tracking current describe blocks\nconst describeStack: string[] = [];\n\nfunction appendDiscovered(testId: string): void {\n  const existing = process.env.SKIPPER_DISCOVERED_TESTS;\n  const arr: string[] = existing ? JSON.parse(existing) : [];\n  arr.push(testId);\n  process.env.SKIPPER_DISCOVERED_TESTS = JSON.stringify(arr);\n}\n\n// Override describe to maintain the stack\nconst originalDescribe = g.describe as ((name: string, fn: () => void) => void) | undefined;\nif (originalDescribe) {\n  g.describe = Object.assign(\n    (name: string, fn: () => void) => {\n      describeStack.push(name);\n      originalDescribe(name, () => {\n        try {\n          fn();\n        } finally {\n          describeStack.pop();\n        }\n      });\n    },\n    originalDescribe,\n  );\n}\n\n// Override test / it\ntype TestLike = ((name: string, fn?: () => void | Promise<void>, timeout?: number) => void) & {\n  skip: (name: string, fn?: () => void | Promise<void>, timeout?: number) => void;\n  [key: string]: unknown;\n};\n\nconst originalTest = g.test as TestLike | undefined;\nif (originalTest) {\n  const wrapped = Object.assign(\n    (name: string, fn?: () => void | Promise<void>, timeout?: number) => {\n      if (fn === undefined) return originalTest(name, fn, timeout);\n\n      // Derive file path from Error stack\n      const stack = new Error().stack ?? '';\n      const match = stack.match(/\\((.+?):\\d+:\\d+\\)/);\n      const filePath = match ? match[1] : 'unknown';\n\n      const testId = buildTestId(filePath, [...describeStack, name]);\n      appendDiscovered(testId);\n\n      return resolver.isTestEnabled(testId)\n        ? originalTest(name, fn, timeout)\n        : originalTest.skip(name, fn, timeout);\n    },\n    originalTest,\n  );\n\n  g.test = wrapped;\n  g.it = wrapped;\n}\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-vitest-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    // Write cache to a temp file instead of an env var to avoid OS env-var size\n    // limits for large test suites. Vitest workers can read this shared file.\n    fs.writeFileSync(SKIPPER_CACHE_PATH, JSON.stringify(resolver.toJSON()), 'utf8');\n    log('[skipper] Spreadsheet loaded.');\n  };\n}\n"],"mappings":";AAQA,YAAY,QAAQ;AACpB,SAAS,mBAAAA,kBAAiB,mBAAmB;;;ACR7C,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,iBAAiB,WAAW;AAG9B,IAAM,qBAA0B,UAAQ,UAAO,GAAG,4BAA4B;;;ADOrF,IAAM,IAAI;AAEV,SAAS,cAA+B;AACtC,MAAI,CAAI,cAAW,kBAAkB,GAAG;AACtC,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AACA,QAAM,MAAS,gBAAa,oBAAoB,MAAM;AACtD,SAAOC,iBAAgB,SAAS,KAAK,MAAM,GAAG,CAAkC;AAClF;AAEA,IAAM,WAAW,YAAY;AAG7B,IAAM,gBAA0B,CAAC;AAEjC,SAAS,iBAAiB,QAAsB;AAC9C,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,MAAgB,WAAW,KAAK,MAAM,QAAQ,IAAI,CAAC;AACzD,MAAI,KAAK,MAAM;AACf,UAAQ,IAAI,2BAA2B,KAAK,UAAU,GAAG;AAC3D;AAGA,IAAM,mBAAmB,EAAE;AAC3B,IAAI,kBAAkB;AACpB,IAAE,WAAW,OAAO;AAAA,IAClB,CAAC,MAAc,OAAmB;AAChC,oBAAc,KAAK,IAAI;AACvB,uBAAiB,MAAM,MAAM;AAC3B,YAAI;AACF,aAAG;AAAA,QACL,UAAE;AACA,wBAAc,IAAI;AAAA,QACpB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA;AAAA,EACF;AACF;AAQA,IAAM,eAAe,EAAE;AACvB,IAAI,cAAc;AAChB,QAAM,UAAU,OAAO;AAAA,IACrB,CAAC,MAAc,IAAiC,YAAqB;AACnE,UAAI,OAAO,OAAW,QAAO,aAAa,MAAM,IAAI,OAAO;AAG3D,YAAM,QAAQ,IAAI,MAAM,EAAE,SAAS;AACnC,YAAM,QAAQ,MAAM,MAAM,mBAAmB;AAC7C,YAAM,WAAW,QAAQ,MAAM,CAAC,IAAI;AAEpC,YAAM,SAAS,YAAY,UAAU,CAAC,GAAG,eAAe,IAAI,CAAC;AAC7D,uBAAiB,MAAM;AAEvB,aAAO,SAAS,cAAc,MAAM,IAChC,aAAa,MAAM,IAAI,OAAO,IAC9B,aAAa,KAAK,MAAM,IAAI,OAAO;AAAA,IACzC;AAAA,IACA;AAAA,EACF;AAEA,IAAE,OAAO;AACT,IAAE,KAAK;AACT;","names":["SkipperResolver","SkipperResolver"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@get-skipper/vitest",
+  "version": "1.0.0",
+  "description": "Skipper plugin for Vitest — enable/disable tests from a Google Spreadsheet",
+  "keywords": [
+    "skipper",
+    "vitest",
+    "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": {
+    "vitest": ">=1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest --config ../../jest.config.js --testPathPattern=packages/vitest/"
+  }
+}