@get-skipper/core 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,45 @@
+# @get-skipper/core
+
+Core package for Skipper — Google Sheets client, resolver, and shared utilities used by all framework plugins.
+
+This package is not typically used directly. Install the plugin for your test framework instead:
+- [`@get-skipper/playwright`](../playwright/README.md)
+- [`@get-skipper/jest`](../jest/README.md)
+- [`@get-skipper/vitest`](../vitest/README.md)
+- [`@get-skipper/cypress`](../cypress/README.md)
+- [`@get-skipper/nightwatch`](../nightwatch/README.md)
+
+## API
+
+### `SkipperResolver`
+
+```ts
+import { SkipperResolver } from '@get-skipper/core';
+
+const resolver = new SkipperResolver({
+  spreadsheetId: 'your-spreadsheet-id',
+  credentials: { credentialsFile: './service-account.json' },
+});
+
+await resolver.initialize();
+resolver.isTestEnabled('tests/auth/login.spec.ts > login > should log in'); // true | false
+```
+
+### `buildTestId(filePath, titlePath)`
+
+Builds a canonical test ID from a file path and title path array:
+
+```ts
+import { buildTestId } from '@get-skipper/core';
+
+buildTestId('/abs/path/tests/auth/login.spec.ts', ['login', 'should log in']);
+// → "tests/auth/login.spec.ts > login > should log in"
+```
+
+### `SheetsWriter`
+
+Used internally by plugins in sync mode to reconcile the spreadsheet.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,183 @@
+import { sheets_v4 } from 'googleapis';
+
+/**
+ * Skipper logger — output is suppressed unless SKIPPER_DEBUG=1 (or any truthy value).
+ */
+declare function log(message: string): void;
+declare function warn(message: string): void;
+declare function error(message: string): void;
+
+type SkipperMode = 'read-only' | 'sync';
+interface ServiceAccountCredentials {
+    type: 'service_account';
+    project_id: string;
+    private_key_id: string;
+    private_key: string;
+    client_email: string;
+    client_id: string;
+    auth_uri: string;
+    token_uri: string;
+}
+type SkipperCredentials = ServiceAccountCredentials | {
+    credentialsFile: string;
+} | {
+    credentialsBase64: string;
+};
+interface SkipperConfig {
+    /** Google Spreadsheet ID (from the URL). */
+    spreadsheetId: string;
+    /**
+     * Service account credentials. Three forms accepted:
+     * - Inline object: the parsed JSON service account
+     * - `{ credentialsFile: './service-account.json' }` — path to JSON file (local dev)
+     * - `{ credentialsBase64: process.env.GOOGLE_CREDS_B64 }` — base64-encoded JSON (CI)
+     */
+    credentials: SkipperCredentials;
+    /** Sheet tab name. Defaults to the first sheet. */
+    sheetName?: string;
+    /**
+     * Additional sheet tab names to read from (read-only).
+     * Entries from these sheets are merged with the primary sheet.
+     * Useful for shared skip lists across multiple projects.
+     * When the same test ID appears in multiple sheets, the most
+     * restrictive (latest) disabledUntil date wins.
+     */
+    referenceSheets?: string[];
+    /** Header name of the test ID column. Defaults to "testId". */
+    testIdColumn?: string;
+    /** Header name of the disabledUntil date column. Defaults to "disabledUntil". */
+    disabledUntilColumn?: string;
+}
+interface TestEntry {
+    testId: string;
+    /** null = no date set = test is enabled */
+    disabledUntil: Date | null;
+    notes?: string;
+}
+
+interface SheetFetchResult {
+    /** Resolved sheet tab name. */
+    sheetName: string;
+    /** Numeric sheet ID (used for batchUpdate deletions). */
+    sheetId: number;
+    /** Raw rows including the header row (row 0). */
+    rawRows: string[][];
+    /** Parsed header cells (trimmed). */
+    header: string[];
+    /** Parsed test entries. */
+    entries: TestEntry[];
+}
+interface FetchAllResult {
+    /** Full data for the primary (writable) sheet — used by SheetsWriter. */
+    primary: SheetFetchResult;
+    /** Merged entries from primary + all referenceSheets — used by SkipperResolver. */
+    entries: TestEntry[];
+    /**
+     * Authenticated Sheets API client — returned here so callers (SheetsWriter)
+     * can reuse the same auth session for write operations without a second auth call.
+     */
+    sheets: sheets_v4.Sheets;
+}
+declare class SheetsClient {
+    private readonly config;
+    constructor(config: SkipperConfig);
+    private fetchSheet;
+    /**
+     * Fetches the primary sheet and all reference sheets in a single API session.
+     *
+     * Returns:
+     * - `primary`: the primary sheet's full result (rawRows + header) for writer use
+     * - `entries`: merged test entries from all sheets (for resolver use)
+     * - `sheets`: the authenticated Sheets API client (reuse for write operations)
+     *
+     * googleapis and google-auth-library are loaded here via dynamic import so that
+     * worker processes, which only call SkipperResolver.fromJSON(), never load them.
+     *
+     * Deduplication: when the same testId appears in multiple sheets, the most
+     * restrictive (latest) disabledUntil wins.
+     */
+    fetchAll(): Promise<FetchAllResult>;
+}
+
+declare class SheetsWriter {
+    private readonly client;
+    private readonly config;
+    constructor(config: SkipperConfig);
+    /**
+     * Reconciles the spreadsheet with the discovered test IDs:
+     * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)
+     * - Deletes rows for tests that no longer exist in the suite
+     *
+     * Only the primary sheet is modified. Reference sheets are never written to.
+     * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).
+     * The header row (row 1) is never modified.
+     *
+     * A single fetchAll() call is made to retrieve sheet metadata, existing entries,
+     * and raw rows — no redundant API calls.
+     */
+    sync(discoveredIds: string[]): Promise<void>;
+}
+
+/**
+ * SkipperResolver is the primary interface used by framework plugins.
+ *
+ * Lifecycle:
+ * 1. Call `initialize()` once before tests run (in globalSetup / before hook).
+ * 2. Call `isTestEnabled(testId)` per test to decide whether to skip.
+ * 3. In sync mode, call `toJSON()` to serialize the cache for cross-process sharing.
+ * 4. In worker processes, use `SkipperResolver.fromJSON()` to rehydrate.
+ */
+declare class SkipperResolver {
+    private readonly client;
+    private readonly config;
+    /** normalized testId → disabledUntil ISO string (null = no date = enabled) */
+    private cache;
+    private initialized;
+    constructor(config: SkipperConfig);
+    /**
+     * Fetches the spreadsheet and populates the in-memory cache.
+     * Must be called once before `isTestEnabled()`.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Returns true if the test should run.
+     *
+     * Logic:
+     * - Not in spreadsheet → true (opt-out model: unknown tests run by default)
+     * - disabledUntil is null or in the past → true
+     * - disabledUntil is in the future → false
+     */
+    isTestEnabled(testId: string): boolean;
+    /**
+     * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).
+     * Dates are stored as ISO strings; null means no date (enabled).
+     */
+    toJSON(): Record<string, string | null>;
+    /**
+     * Rehydrates a resolver from a serialized cache.
+     * Used in worker processes that cannot call initialize() again.
+     */
+    static fromJSON(data: Record<string, string | null>): SkipperResolver;
+    getMode(): SkipperMode;
+}
+
+/**
+ * Normalizes a testId for consistent comparison:
+ * - trim leading/trailing whitespace
+ * - lowercase
+ * - collapse multiple whitespace characters into a single space
+ */
+declare function normalizeTestId(id: string): string;
+/**
+ * Builds a canonical testId from a file path and the test title path.
+ *
+ * Format: "{relativePath} > {titlePath.join(' > ')}"
+ * Example: "tests/auth/login.spec.ts > login > should log in with valid credentials"
+ *
+ * The filePath is made relative to process.cwd() if it is absolute.
+ * The titlePath is the array of describe block names + the test name,
+ * as provided by the test framework (never pre-joined).
+ */
+declare function buildTestId(filePath: string, titlePath: string[]): string;
+
+export { type ServiceAccountCredentials, SheetsClient, SheetsWriter, type SkipperConfig, type SkipperCredentials, type SkipperMode, SkipperResolver, type TestEntry, buildTestId, error, log, normalizeTestId, warn };

package/dist/index.d.ts

@@ -0,0 +1,183 @@
+import { sheets_v4 } from 'googleapis';
+
+/**
+ * Skipper logger — output is suppressed unless SKIPPER_DEBUG=1 (or any truthy value).
+ */
+declare function log(message: string): void;
+declare function warn(message: string): void;
+declare function error(message: string): void;
+
+type SkipperMode = 'read-only' | 'sync';
+interface ServiceAccountCredentials {
+    type: 'service_account';
+    project_id: string;
+    private_key_id: string;
+    private_key: string;
+    client_email: string;
+    client_id: string;
+    auth_uri: string;
+    token_uri: string;
+}
+type SkipperCredentials = ServiceAccountCredentials | {
+    credentialsFile: string;
+} | {
+    credentialsBase64: string;
+};
+interface SkipperConfig {
+    /** Google Spreadsheet ID (from the URL). */
+    spreadsheetId: string;
+    /**
+     * Service account credentials. Three forms accepted:
+     * - Inline object: the parsed JSON service account
+     * - `{ credentialsFile: './service-account.json' }` — path to JSON file (local dev)
+     * - `{ credentialsBase64: process.env.GOOGLE_CREDS_B64 }` — base64-encoded JSON (CI)
+     */
+    credentials: SkipperCredentials;
+    /** Sheet tab name. Defaults to the first sheet. */
+    sheetName?: string;
+    /**
+     * Additional sheet tab names to read from (read-only).
+     * Entries from these sheets are merged with the primary sheet.
+     * Useful for shared skip lists across multiple projects.
+     * When the same test ID appears in multiple sheets, the most
+     * restrictive (latest) disabledUntil date wins.
+     */
+    referenceSheets?: string[];
+    /** Header name of the test ID column. Defaults to "testId". */
+    testIdColumn?: string;
+    /** Header name of the disabledUntil date column. Defaults to "disabledUntil". */
+    disabledUntilColumn?: string;
+}
+interface TestEntry {
+    testId: string;
+    /** null = no date set = test is enabled */
+    disabledUntil: Date | null;
+    notes?: string;
+}
+
+interface SheetFetchResult {
+    /** Resolved sheet tab name. */
+    sheetName: string;
+    /** Numeric sheet ID (used for batchUpdate deletions). */
+    sheetId: number;
+    /** Raw rows including the header row (row 0). */
+    rawRows: string[][];
+    /** Parsed header cells (trimmed). */
+    header: string[];
+    /** Parsed test entries. */
+    entries: TestEntry[];
+}
+interface FetchAllResult {
+    /** Full data for the primary (writable) sheet — used by SheetsWriter. */
+    primary: SheetFetchResult;
+    /** Merged entries from primary + all referenceSheets — used by SkipperResolver. */
+    entries: TestEntry[];
+    /**
+     * Authenticated Sheets API client — returned here so callers (SheetsWriter)
+     * can reuse the same auth session for write operations without a second auth call.
+     */
+    sheets: sheets_v4.Sheets;
+}
+declare class SheetsClient {
+    private readonly config;
+    constructor(config: SkipperConfig);
+    private fetchSheet;
+    /**
+     * Fetches the primary sheet and all reference sheets in a single API session.
+     *
+     * Returns:
+     * - `primary`: the primary sheet's full result (rawRows + header) for writer use
+     * - `entries`: merged test entries from all sheets (for resolver use)
+     * - `sheets`: the authenticated Sheets API client (reuse for write operations)
+     *
+     * googleapis and google-auth-library are loaded here via dynamic import so that
+     * worker processes, which only call SkipperResolver.fromJSON(), never load them.
+     *
+     * Deduplication: when the same testId appears in multiple sheets, the most
+     * restrictive (latest) disabledUntil wins.
+     */
+    fetchAll(): Promise<FetchAllResult>;
+}
+
+declare class SheetsWriter {
+    private readonly client;
+    private readonly config;
+    constructor(config: SkipperConfig);
+    /**
+     * Reconciles the spreadsheet with the discovered test IDs:
+     * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)
+     * - Deletes rows for tests that no longer exist in the suite
+     *
+     * Only the primary sheet is modified. Reference sheets are never written to.
+     * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).
+     * The header row (row 1) is never modified.
+     *
+     * A single fetchAll() call is made to retrieve sheet metadata, existing entries,
+     * and raw rows — no redundant API calls.
+     */
+    sync(discoveredIds: string[]): Promise<void>;
+}
+
+/**
+ * SkipperResolver is the primary interface used by framework plugins.
+ *
+ * Lifecycle:
+ * 1. Call `initialize()` once before tests run (in globalSetup / before hook).
+ * 2. Call `isTestEnabled(testId)` per test to decide whether to skip.
+ * 3. In sync mode, call `toJSON()` to serialize the cache for cross-process sharing.
+ * 4. In worker processes, use `SkipperResolver.fromJSON()` to rehydrate.
+ */
+declare class SkipperResolver {
+    private readonly client;
+    private readonly config;
+    /** normalized testId → disabledUntil ISO string (null = no date = enabled) */
+    private cache;
+    private initialized;
+    constructor(config: SkipperConfig);
+    /**
+     * Fetches the spreadsheet and populates the in-memory cache.
+     * Must be called once before `isTestEnabled()`.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Returns true if the test should run.
+     *
+     * Logic:
+     * - Not in spreadsheet → true (opt-out model: unknown tests run by default)
+     * - disabledUntil is null or in the past → true
+     * - disabledUntil is in the future → false
+     */
+    isTestEnabled(testId: string): boolean;
+    /**
+     * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).
+     * Dates are stored as ISO strings; null means no date (enabled).
+     */
+    toJSON(): Record<string, string | null>;
+    /**
+     * Rehydrates a resolver from a serialized cache.
+     * Used in worker processes that cannot call initialize() again.
+     */
+    static fromJSON(data: Record<string, string | null>): SkipperResolver;
+    getMode(): SkipperMode;
+}
+
+/**
+ * Normalizes a testId for consistent comparison:
+ * - trim leading/trailing whitespace
+ * - lowercase
+ * - collapse multiple whitespace characters into a single space
+ */
+declare function normalizeTestId(id: string): string;
+/**
+ * Builds a canonical testId from a file path and the test title path.
+ *
+ * Format: "{relativePath} > {titlePath.join(' > ')}"
+ * Example: "tests/auth/login.spec.ts > login > should log in with valid credentials"
+ *
+ * The filePath is made relative to process.cwd() if it is absolute.
+ * The titlePath is the array of describe block names + the test name,
+ * as provided by the test framework (never pre-joined).
+ */
+declare function buildTestId(filePath: string, titlePath: string[]): string;
+
+export { type ServiceAccountCredentials, SheetsClient, SheetsWriter, type SkipperConfig, type SkipperCredentials, type SkipperMode, SkipperResolver, type TestEntry, buildTestId, error, log, normalizeTestId, warn };

package/dist/index.js

@@ -0,0 +1,348 @@
+"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, {
+  SheetsClient: () => SheetsClient,
+  SheetsWriter: () => SheetsWriter,
+  SkipperResolver: () => SkipperResolver,
+  buildTestId: () => buildTestId,
+  error: () => error,
+  log: () => log,
+  normalizeTestId: () => normalizeTestId,
+  warn: () => warn
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/logger.ts
+function isEnabled() {
+  return Boolean(process.env.SKIPPER_DEBUG);
+}
+function log(message) {
+  if (isEnabled()) console.log(message);
+}
+function warn(message) {
+  if (isEnabled()) console.warn(message);
+}
+function error(message) {
+  if (isEnabled()) console.error(message);
+}
+
+// src/client.ts
+var fs = __toESM(require("fs"));
+
+// src/cache.ts
+var path = __toESM(require("path"));
+function normalizeTestId(id) {
+  return id.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function buildTestId(filePath, titlePath) {
+  const relativePath = path.isAbsolute(filePath) ? path.relative(process.cwd(), filePath) : filePath;
+  const normalizedPath = relativePath.split(path.sep).join("/");
+  return [normalizedPath, ...titlePath].join(" > ");
+}
+
+// src/client.ts
+function resolveCredentials(config) {
+  const { credentials } = config;
+  if ("credentialsFile" in credentials) {
+    const raw = fs.readFileSync(credentials.credentialsFile, "utf8");
+    return JSON.parse(raw);
+  }
+  if ("credentialsBase64" in credentials) {
+    const raw = Buffer.from(credentials.credentialsBase64, "base64").toString("utf8");
+    return JSON.parse(raw);
+  }
+  return credentials;
+}
+var SheetsClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async fetchSheet(sheets, sheetName, sheetId) {
+    const spreadsheetId = this.config.spreadsheetId;
+    const testIdCol = this.config.testIdColumn ?? "testId";
+    const disabledUntilCol = this.config.disabledUntilColumn ?? "disabledUntil";
+    const response = await sheets.spreadsheets.values.get({ spreadsheetId, range: sheetName });
+    const rawRows = response.data.values ?? [];
+    if (rawRows.length === 0) {
+      return { sheetName, sheetId, rawRows, header: [], entries: [] };
+    }
+    const header = rawRows[0].map((h) => String(h).trim());
+    const testIdIdx = header.indexOf(testIdCol);
+    const disabledUntilIdx = header.indexOf(disabledUntilCol);
+    const notesIdx = header.indexOf("notes");
+    if (testIdIdx === -1) {
+      throw new Error(
+        `[skipper] Column "${testIdCol}" not found in sheet "${sheetName}". Found columns: ${header.join(", ")}`
+      );
+    }
+    const entries = [];
+    for (let i = 1; i < rawRows.length; i++) {
+      const row = rawRows[i];
+      const testId = row[testIdIdx] ? String(row[testIdIdx]).trim() : "";
+      if (!testId) continue;
+      let disabledUntil = null;
+      if (disabledUntilIdx !== -1 && row[disabledUntilIdx]) {
+        const raw = String(row[disabledUntilIdx]).trim();
+        if (raw) {
+          const parsed = new Date(raw);
+          if (!isNaN(parsed.getTime())) {
+            disabledUntil = parsed;
+          } else {
+            warn(
+              `[skipper] Row ${i + 1} in "${sheetName}": invalid date "${raw}" in "${disabledUntilCol}" \u2014 treating as enabled`
+            );
+          }
+        }
+      }
+      const notes = notesIdx !== -1 && row[notesIdx] ? String(row[notesIdx]) : void 0;
+      entries.push({ testId, disabledUntil, notes });
+    }
+    return { sheetName, sheetId, rawRows, header, entries };
+  }
+  /**
+   * Fetches the primary sheet and all reference sheets in a single API session.
+   *
+   * Returns:
+   * - `primary`: the primary sheet's full result (rawRows + header) for writer use
+   * - `entries`: merged test entries from all sheets (for resolver use)
+   * - `sheets`: the authenticated Sheets API client (reuse for write operations)
+   *
+   * googleapis and google-auth-library are loaded here via dynamic import so that
+   * worker processes, which only call SkipperResolver.fromJSON(), never load them.
+   *
+   * Deduplication: when the same testId appears in multiple sheets, the most
+   * restrictive (latest) disabledUntil wins.
+   */
+  async fetchAll() {
+    const { google } = await import("googleapis");
+    const { JWT } = await import("google-auth-library");
+    const creds = resolveCredentials(this.config);
+    const auth = new JWT({
+      email: creds.client_email,
+      key: creds.private_key,
+      scopes: ["https://www.googleapis.com/auth/spreadsheets"]
+    });
+    const sheets = google.sheets({ version: "v4", auth });
+    const spreadsheetId = this.config.spreadsheetId;
+    const meta = await sheets.spreadsheets.get({ spreadsheetId });
+    const allSheetMeta = meta.data.sheets ?? [];
+    const sheetIdByName = new Map(
+      allSheetMeta.filter((s) => s.properties?.title != null && s.properties.sheetId != null).map((s) => [s.properties.title, s.properties.sheetId])
+    );
+    const primaryName = this.config.sheetName ?? allSheetMeta[0]?.properties?.title ?? "Sheet1";
+    const primaryId = sheetIdByName.get(primaryName);
+    if (primaryId == null) {
+      throw new Error(`[skipper] Sheet "${primaryName}" not found in spreadsheet.`);
+    }
+    const primary = await this.fetchSheet(sheets, primaryName, primaryId);
+    const referenceEntries = [];
+    for (const refName of this.config.referenceSheets ?? []) {
+      const refId = sheetIdByName.get(refName);
+      if (refId == null) {
+        warn(`[skipper] Reference sheet "${refName}" not found \u2014 skipping.`);
+        continue;
+      }
+      const result = await this.fetchSheet(sheets, refName, refId);
+      referenceEntries.push(...result.entries);
+    }
+    const merged = /* @__PURE__ */ new Map();
+    for (const entry of [...primary.entries, ...referenceEntries]) {
+      const key = normalizeTestId(entry.testId);
+      const existing = merged.get(key);
+      if (!existing) {
+        merged.set(key, entry);
+      } else if (entry.disabledUntil !== null) {
+        if (existing.disabledUntil === null || entry.disabledUntil > existing.disabledUntil) {
+          merged.set(key, entry);
+        }
+      }
+    }
+    return { primary, entries: [...merged.values()], sheets };
+  }
+};
+
+// src/writer.ts
+var SheetsWriter = class {
+  constructor(config) {
+    this.config = config;
+    this.client = new SheetsClient(config);
+  }
+  /**
+   * Reconciles the spreadsheet with the discovered test IDs:
+   * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)
+   * - Deletes rows for tests that no longer exist in the suite
+   *
+   * Only the primary sheet is modified. Reference sheets are never written to.
+   * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).
+   * The header row (row 1) is never modified.
+   *
+   * A single fetchAll() call is made to retrieve sheet metadata, existing entries,
+   * and raw rows — no redundant API calls.
+   */
+  async sync(discoveredIds) {
+    const { primary, entries: existingEntries, sheets } = await this.client.fetchAll();
+    const { sheetName, sheetId, rawRows, header } = primary;
+    const testIdCol = this.config.testIdColumn ?? "testId";
+    const disabledUntilCol = this.config.disabledUntilColumn ?? "disabledUntil";
+    const normalizedDiscovered = new Set(discoveredIds.map(normalizeTestId));
+    const normalizedExisting = new Map(
+      existingEntries.map((e) => [normalizeTestId(e.testId), e])
+    );
+    const toAdd = discoveredIds.filter((id) => !normalizedExisting.has(normalizeTestId(id)));
+    const toRemoveNormalized = new Set(
+      [...normalizedExisting.keys()].filter((nid) => !normalizedDiscovered.has(nid))
+    );
+    if (toAdd.length === 0 && toRemoveNormalized.size === 0) {
+      log("[skipper] Spreadsheet is already up to date.");
+      return;
+    }
+    const spreadsheetId = this.config.spreadsheetId;
+    const testIdIdx = header.indexOf(testIdCol);
+    const rowIndicesToDelete = [];
+    for (let i = 1; i < rawRows.length; i++) {
+      const id = rawRows[i][testIdIdx] ? String(rawRows[i][testIdIdx]).trim() : "";
+      if (id && toRemoveNormalized.has(normalizeTestId(id))) {
+        rowIndicesToDelete.push(i);
+      }
+    }
+    const deleteRequests = rowIndicesToDelete.sort((a, b) => b - a).map((rowIdx) => ({
+      deleteDimension: {
+        range: { sheetId, dimension: "ROWS", startIndex: rowIdx, endIndex: rowIdx + 1 }
+      }
+    }));
+    if (deleteRequests.length > 0) {
+      await sheets.spreadsheets.batchUpdate({
+        spreadsheetId,
+        requestBody: { requests: deleteRequests }
+      });
+      log(`[skipper] Removed ${deleteRequests.length} obsolete test(s) from spreadsheet.`);
+    }
+    if (toAdd.length > 0) {
+      const headerIdxDisabledUntil = header.indexOf(disabledUntilCol);
+      const newRows = toAdd.map((testId) => {
+        const row = new Array(Math.max(testIdIdx + 1, headerIdxDisabledUntil + 1)).fill("");
+        row[testIdIdx] = testId;
+        if (headerIdxDisabledUntil !== -1) row[headerIdxDisabledUntil] = "";
+        return row;
+      });
+      await sheets.spreadsheets.values.append({
+        spreadsheetId,
+        range: sheetName,
+        valueInputOption: "RAW",
+        requestBody: { values: newRows }
+      });
+      log(`[skipper] Added ${toAdd.length} new test(s) to spreadsheet.`);
+    }
+  }
+};
+
+// src/resolver.ts
+var SkipperResolver = class _SkipperResolver {
+  constructor(config) {
+    /** normalized testId → disabledUntil ISO string (null = no date = enabled) */
+    this.cache = /* @__PURE__ */ new Map();
+    this.initialized = false;
+    this.config = config;
+    this.client = new SheetsClient(config);
+  }
+  /**
+   * Fetches the spreadsheet and populates the in-memory cache.
+   * Must be called once before `isTestEnabled()`.
+   */
+  async initialize() {
+    const { entries } = await this.client.fetchAll();
+    this.cache = new Map(
+      entries.map((e) => [
+        normalizeTestId(e.testId),
+        e.disabledUntil ? e.disabledUntil.toISOString() : null
+      ])
+    );
+    this.initialized = true;
+  }
+  /**
+   * Returns true if the test should run.
+   *
+   * Logic:
+   * - Not in spreadsheet → true (opt-out model: unknown tests run by default)
+   * - disabledUntil is null or in the past → true
+   * - disabledUntil is in the future → false
+   */
+  isTestEnabled(testId) {
+    if (!this.initialized) {
+      throw new Error(
+        "[skipper] SkipperResolver.initialize() must be called before isTestEnabled(). Did you forget to add the globalSetup to your config?"
+      );
+    }
+    const normalized = normalizeTestId(testId);
+    if (!this.cache.has(normalized)) return true;
+    const iso = this.cache.get(normalized);
+    if (!iso) return true;
+    return new Date(iso) <= /* @__PURE__ */ new Date();
+  }
+  /**
+   * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).
+   * Dates are stored as ISO strings; null means no date (enabled).
+   */
+  toJSON() {
+    return Object.fromEntries(this.cache);
+  }
+  /**
+   * Rehydrates a resolver from a serialized cache.
+   * Used in worker processes that cannot call initialize() again.
+   */
+  static fromJSON(data) {
+    const resolver = new _SkipperResolver({
+      spreadsheetId: "",
+      credentials: { credentialsBase64: "" }
+    });
+    resolver.cache = new Map(Object.entries(data));
+    resolver.initialized = true;
+    return resolver;
+  }
+  getMode() {
+    const mode = process.env.SKIPPER_MODE;
+    if (mode === "sync") return "sync";
+    return "read-only";
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SheetsClient,
+  SheetsWriter,
+  SkipperResolver,
+  buildTestId,
+  error,
+  log,
+  normalizeTestId,
+  warn
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/logger.ts","../src/client.ts","../src/cache.ts","../src/writer.ts","../src/resolver.ts"],"sourcesContent":["export { log, warn, error } from './logger';\nexport { SheetsClient } from './client';\nexport { SheetsWriter } from './writer';\nexport { SkipperResolver } from './resolver';\nexport { buildTestId, normalizeTestId } from './cache';\nexport type {\n  SkipperConfig,\n  SkipperCredentials,\n  SkipperMode,\n  ServiceAccountCredentials,\n  TestEntry,\n} from './types';\n","/**\n * Skipper logger — output is suppressed unless SKIPPER_DEBUG=1 (or any truthy value).\n */\n\nfunction isEnabled(): boolean {\n  return Boolean(process.env.SKIPPER_DEBUG);\n}\n\nexport function log(message: string): void {\n  if (isEnabled()) console.log(message);\n}\n\nexport function warn(message: string): void {\n  if (isEnabled()) console.warn(message);\n}\n\nexport function error(message: string): void {\n  if (isEnabled()) console.error(message);\n}\n","import * as fs from 'fs';\nimport { normalizeTestId } from './cache';\nimport { warn } from './logger';\nimport type { SkipperConfig, TestEntry, ServiceAccountCredentials } from './types';\n\n// googleapis and google-auth-library are imported dynamically inside fetchAll() so that\n// worker processes that only call SkipperResolver.fromJSON() never load these modules.\n// Loading googleapis initialises an HTTP keep-alive agent that prevents worker exit.\nimport type { sheets_v4 } from 'googleapis';\n\nfunction resolveCredentials(config: SkipperConfig): ServiceAccountCredentials {\n  const { credentials } = config;\n\n  if ('credentialsFile' in credentials) {\n    const raw = fs.readFileSync(credentials.credentialsFile, 'utf8');\n    return JSON.parse(raw) as ServiceAccountCredentials;\n  }\n\n  if ('credentialsBase64' in credentials) {\n    const raw = Buffer.from(credentials.credentialsBase64, 'base64').toString('utf8');\n    return JSON.parse(raw) as ServiceAccountCredentials;\n  }\n\n  return credentials as ServiceAccountCredentials;\n}\n\nexport interface SheetFetchResult {\n  /** Resolved sheet tab name. */\n  sheetName: string;\n  /** Numeric sheet ID (used for batchUpdate deletions). */\n  sheetId: number;\n  /** Raw rows including the header row (row 0). */\n  rawRows: string[][];\n  /** Parsed header cells (trimmed). */\n  header: string[];\n  /** Parsed test entries. */\n  entries: TestEntry[];\n}\n\nexport interface FetchAllResult {\n  /** Full data for the primary (writable) sheet — used by SheetsWriter. */\n  primary: SheetFetchResult;\n  /** Merged entries from primary + all referenceSheets — used by SkipperResolver. */\n  entries: TestEntry[];\n  /**\n   * Authenticated Sheets API client — returned here so callers (SheetsWriter)\n   * can reuse the same auth session for write operations without a second auth call.\n   */\n  sheets: sheets_v4.Sheets;\n}\n\nexport class SheetsClient {\n  private readonly config: SkipperConfig;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n  }\n\n  private async fetchSheet(\n    sheets: sheets_v4.Sheets,\n    sheetName: string,\n    sheetId: number,\n  ): Promise<SheetFetchResult> {\n    const spreadsheetId = this.config.spreadsheetId;\n    const testIdCol = this.config.testIdColumn ?? 'testId';\n    const disabledUntilCol = this.config.disabledUntilColumn ?? 'disabledUntil';\n\n    const response = await sheets.spreadsheets.values.get({ spreadsheetId, range: sheetName });\n    const rawRows = (response.data.values ?? []) as string[][];\n\n    if (rawRows.length === 0) {\n      return { sheetName, sheetId, rawRows, header: [], entries: [] };\n    }\n\n    const header = rawRows[0].map((h: string) => String(h).trim());\n    const testIdIdx = header.indexOf(testIdCol);\n    const disabledUntilIdx = header.indexOf(disabledUntilCol);\n    const notesIdx = header.indexOf('notes');\n\n    if (testIdIdx === -1) {\n      throw new Error(\n        `[skipper] Column \"${testIdCol}\" not found in sheet \"${sheetName}\". ` +\n          `Found columns: ${header.join(', ')}`,\n      );\n    }\n\n    const entries: TestEntry[] = [];\n    for (let i = 1; i < rawRows.length; i++) {\n      const row = rawRows[i];\n      const testId = row[testIdIdx] ? String(row[testIdIdx]).trim() : '';\n      if (!testId) continue;\n\n      let disabledUntil: Date | null = null;\n      if (disabledUntilIdx !== -1 && row[disabledUntilIdx]) {\n        const raw = String(row[disabledUntilIdx]).trim();\n        if (raw) {\n          const parsed = new Date(raw);\n          if (!isNaN(parsed.getTime())) {\n            disabledUntil = parsed;\n          } else {\n            warn(\n              `[skipper] Row ${i + 1} in \"${sheetName}\": invalid date \"${raw}\" in \"${disabledUntilCol}\" — treating as enabled`,\n            );\n          }\n        }\n      }\n\n      const notes = notesIdx !== -1 && row[notesIdx] ? String(row[notesIdx]) : undefined;\n      entries.push({ testId, disabledUntil, notes });\n    }\n\n    return { sheetName, sheetId, rawRows, header, entries };\n  }\n\n  /**\n   * Fetches the primary sheet and all reference sheets in a single API session.\n   *\n   * Returns:\n   * - `primary`: the primary sheet's full result (rawRows + header) for writer use\n   * - `entries`: merged test entries from all sheets (for resolver use)\n   * - `sheets`: the authenticated Sheets API client (reuse for write operations)\n   *\n   * googleapis and google-auth-library are loaded here via dynamic import so that\n   * worker processes, which only call SkipperResolver.fromJSON(), never load them.\n   *\n   * Deduplication: when the same testId appears in multiple sheets, the most\n   * restrictive (latest) disabledUntil wins.\n   */\n  async fetchAll(): Promise<FetchAllResult> {\n    // Dynamic imports — only executed when actually fetching from the spreadsheet.\n    const { google } = await import('googleapis');\n    const { JWT } = await import('google-auth-library');\n\n    const creds = resolveCredentials(this.config);\n    const auth = new JWT({\n      email: creds.client_email,\n      key: creds.private_key,\n      scopes: ['https://www.googleapis.com/auth/spreadsheets'],\n    });\n    const sheets = google.sheets({ version: 'v4', auth });\n\n    const spreadsheetId = this.config.spreadsheetId;\n    const meta = await sheets.spreadsheets.get({ spreadsheetId });\n    const allSheetMeta = meta.data.sheets ?? [];\n\n    const sheetIdByName = new Map<string, number>(\n      allSheetMeta\n        .filter((s) => s.properties?.title != null && s.properties.sheetId != null)\n        .map((s) => [s.properties!.title!, s.properties!.sheetId!]),\n    );\n\n    const primaryName = this.config.sheetName ?? allSheetMeta[0]?.properties?.title ?? 'Sheet1';\n    const primaryId = sheetIdByName.get(primaryName);\n    if (primaryId == null) {\n      throw new Error(`[skipper] Sheet \"${primaryName}\" not found in spreadsheet.`);\n    }\n\n    const primary = await this.fetchSheet(sheets, primaryName, primaryId);\n\n    const referenceEntries: TestEntry[] = [];\n    for (const refName of this.config.referenceSheets ?? []) {\n      const refId = sheetIdByName.get(refName);\n      if (refId == null) {\n        warn(`[skipper] Reference sheet \"${refName}\" not found — skipping.`);\n        continue;\n      }\n      const result = await this.fetchSheet(sheets, refName, refId);\n      referenceEntries.push(...result.entries);\n    }\n\n    const merged = new Map<string, TestEntry>();\n    for (const entry of [...primary.entries, ...referenceEntries]) {\n      const key = normalizeTestId(entry.testId);\n      const existing = merged.get(key);\n      if (!existing) {\n        merged.set(key, entry);\n      } else if (entry.disabledUntil !== null) {\n        if (existing.disabledUntil === null || entry.disabledUntil > existing.disabledUntil) {\n          merged.set(key, entry);\n        }\n      }\n    }\n\n    return { primary, entries: [...merged.values()], sheets };\n  }\n}\n","import * as path from 'path';\n\n/**\n * Normalizes a testId for consistent comparison:\n * - trim leading/trailing whitespace\n * - lowercase\n * - collapse multiple whitespace characters into a single space\n */\nexport function normalizeTestId(id: string): string {\n  return id.trim().toLowerCase().replace(/\\s+/g, ' ');\n}\n\n/**\n * Builds a canonical testId from a file path and the test title path.\n *\n * Format: \"{relativePath} > {titlePath.join(' > ')}\"\n * Example: \"tests/auth/login.spec.ts > login > should log in with valid credentials\"\n *\n * The filePath is made relative to process.cwd() if it is absolute.\n * The titlePath is the array of describe block names + the test name,\n * as provided by the test framework (never pre-joined).\n */\nexport function buildTestId(filePath: string, titlePath: string[]): string {\n  const relativePath = path.isAbsolute(filePath)\n    ? path.relative(process.cwd(), filePath)\n    : filePath;\n\n  const normalizedPath = relativePath.split(path.sep).join('/');\n  return [normalizedPath, ...titlePath].join(' > ');\n}\n","import { SheetsClient } from './client';\nimport { normalizeTestId } from './cache';\nimport { log } from './logger';\nimport type { SkipperConfig, TestEntry } from './types';\n\nexport class SheetsWriter {\n  private readonly client: SheetsClient;\n  private readonly config: SkipperConfig;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n    this.client = new SheetsClient(config);\n  }\n\n  /**\n   * Reconciles the spreadsheet with the discovered test IDs:\n   * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)\n   * - Deletes rows for tests that no longer exist in the suite\n   *\n   * Only the primary sheet is modified. Reference sheets are never written to.\n   * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).\n   * The header row (row 1) is never modified.\n   *\n   * A single fetchAll() call is made to retrieve sheet metadata, existing entries,\n   * and raw rows — no redundant API calls.\n   */\n  async sync(discoveredIds: string[]): Promise<void> {\n    // One fetchAll() resolves the sheet name from metadata, fetches existing\n    // entries, and returns raw rows and the authenticated Sheets client —\n    // all in two API calls (metadata + values). No second auth/fetch needed.\n    const { primary, entries: existingEntries, sheets } = await this.client.fetchAll();\n    const { sheetName, sheetId, rawRows, header } = primary;\n\n    const testIdCol = this.config.testIdColumn ?? 'testId';\n    const disabledUntilCol = this.config.disabledUntilColumn ?? 'disabledUntil';\n\n    const normalizedDiscovered = new Set(discoveredIds.map(normalizeTestId));\n    const normalizedExisting = new Map<string, TestEntry>(\n      existingEntries.map((e) => [normalizeTestId(e.testId), e]),\n    );\n\n    const toAdd = discoveredIds.filter((id) => !normalizedExisting.has(normalizeTestId(id)));\n    const toRemoveNormalized = new Set(\n      [...normalizedExisting.keys()].filter((nid) => !normalizedDiscovered.has(nid)),\n    );\n\n    if (toAdd.length === 0 && toRemoveNormalized.size === 0) {\n      log('[skipper] Spreadsheet is already up to date.');\n      return;\n    }\n\n    const spreadsheetId = this.config.spreadsheetId;\n\n    const testIdIdx = header.indexOf(testIdCol);\n\n    // Identify 0-based row indices (within rawRows) to delete, skipping header at 0.\n    const rowIndicesToDelete: number[] = [];\n    for (let i = 1; i < rawRows.length; i++) {\n      const id = rawRows[i][testIdIdx] ? String(rawRows[i][testIdIdx]).trim() : '';\n      if (id && toRemoveNormalized.has(normalizeTestId(id))) {\n        rowIndicesToDelete.push(i);\n      }\n    }\n\n    // Deletions must be sorted descending to avoid index shifting.\n    const deleteRequests = rowIndicesToDelete\n      .sort((a, b) => b - a)\n      .map((rowIdx) => ({\n        deleteDimension: {\n          range: { sheetId, dimension: 'ROWS', startIndex: rowIdx, endIndex: rowIdx + 1 },\n        },\n      }));\n\n    if (deleteRequests.length > 0) {\n      await sheets.spreadsheets.batchUpdate({\n        spreadsheetId,\n        requestBody: { requests: deleteRequests },\n      });\n      log(`[skipper] Removed ${deleteRequests.length} obsolete test(s) from spreadsheet.`);\n    }\n\n    // Append new rows.\n    if (toAdd.length > 0) {\n      const headerIdxDisabledUntil = header.indexOf(disabledUntilCol);\n\n      const newRows = toAdd.map((testId) => {\n        const row: string[] = new Array(Math.max(testIdIdx + 1, headerIdxDisabledUntil + 1)).fill('');\n        row[testIdIdx] = testId;\n        if (headerIdxDisabledUntil !== -1) row[headerIdxDisabledUntil] = '';\n        return row;\n      });\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId,\n        range: sheetName,\n        valueInputOption: 'RAW',\n        requestBody: { values: newRows },\n      });\n      log(`[skipper] Added ${toAdd.length} new test(s) to spreadsheet.`);\n    }\n  }\n}\n","import { SheetsClient } from './client';\nimport { normalizeTestId } from './cache';\nimport type { SkipperConfig, SkipperMode } from './types';\n\n/**\n * SkipperResolver is the primary interface used by framework plugins.\n *\n * Lifecycle:\n * 1. Call `initialize()` once before tests run (in globalSetup / before hook).\n * 2. Call `isTestEnabled(testId)` per test to decide whether to skip.\n * 3. In sync mode, call `toJSON()` to serialize the cache for cross-process sharing.\n * 4. In worker processes, use `SkipperResolver.fromJSON()` to rehydrate.\n */\nexport class SkipperResolver {\n  private readonly client: SheetsClient;\n  private readonly config: SkipperConfig;\n  /** normalized testId → disabledUntil ISO string (null = no date = enabled) */\n  private cache: Map<string, string | null> = new Map();\n  private initialized = false;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n    this.client = new SheetsClient(config);\n  }\n\n  /**\n   * Fetches the spreadsheet and populates the in-memory cache.\n   * Must be called once before `isTestEnabled()`.\n   */\n  async initialize(): Promise<void> {\n    const { entries } = await this.client.fetchAll();\n    this.cache = new Map(\n      entries.map((e) => [\n        normalizeTestId(e.testId),\n        e.disabledUntil ? e.disabledUntil.toISOString() : null,\n      ]),\n    );\n    this.initialized = true;\n  }\n\n  /**\n   * Returns true if the test should run.\n   *\n   * Logic:\n   * - Not in spreadsheet → true (opt-out model: unknown tests run by default)\n   * - disabledUntil is null or in the past → true\n   * - disabledUntil is in the future → false\n   */\n  isTestEnabled(testId: string): boolean {\n    if (!this.initialized) {\n      throw new Error(\n        '[skipper] SkipperResolver.initialize() must be called before isTestEnabled(). ' +\n          'Did you forget to add the globalSetup to your config?',\n      );\n    }\n\n    const normalized = normalizeTestId(testId);\n    if (!this.cache.has(normalized)) return true;\n\n    const iso = this.cache.get(normalized);\n    if (!iso) return true;\n\n    return new Date(iso) <= new Date();\n  }\n\n  /**\n   * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).\n   * Dates are stored as ISO strings; null means no date (enabled).\n   */\n  toJSON(): Record<string, string | null> {\n    return Object.fromEntries(this.cache);\n  }\n\n  /**\n   * Rehydrates a resolver from a serialized cache.\n   * Used in worker processes that cannot call initialize() again.\n   */\n  static fromJSON(data: Record<string, string | null>): SkipperResolver {\n    // We pass a dummy config since the client is never used after fromJSON\n    const resolver = new SkipperResolver({\n      spreadsheetId: '',\n      credentials: { credentialsBase64: '' },\n    });\n    resolver.cache = new Map(Object.entries(data));\n    resolver.initialized = true;\n    return resolver;\n  }\n\n  getMode(): SkipperMode {\n    const mode = process.env.SKIPPER_MODE;\n    if (mode === 'sync') return 'sync';\n    return 'read-only';\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,304 @@
+// src/logger.ts
+function isEnabled() {
+  return Boolean(process.env.SKIPPER_DEBUG);
+}
+function log(message) {
+  if (isEnabled()) console.log(message);
+}
+function warn(message) {
+  if (isEnabled()) console.warn(message);
+}
+function error(message) {
+  if (isEnabled()) console.error(message);
+}
+
+// src/client.ts
+import * as fs from "fs";
+
+// src/cache.ts
+import * as path from "path";
+function normalizeTestId(id) {
+  return id.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function buildTestId(filePath, titlePath) {
+  const relativePath = path.isAbsolute(filePath) ? path.relative(process.cwd(), filePath) : filePath;
+  const normalizedPath = relativePath.split(path.sep).join("/");
+  return [normalizedPath, ...titlePath].join(" > ");
+}
+
+// src/client.ts
+function resolveCredentials(config) {
+  const { credentials } = config;
+  if ("credentialsFile" in credentials) {
+    const raw = fs.readFileSync(credentials.credentialsFile, "utf8");
+    return JSON.parse(raw);
+  }
+  if ("credentialsBase64" in credentials) {
+    const raw = Buffer.from(credentials.credentialsBase64, "base64").toString("utf8");
+    return JSON.parse(raw);
+  }
+  return credentials;
+}
+var SheetsClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async fetchSheet(sheets, sheetName, sheetId) {
+    const spreadsheetId = this.config.spreadsheetId;
+    const testIdCol = this.config.testIdColumn ?? "testId";
+    const disabledUntilCol = this.config.disabledUntilColumn ?? "disabledUntil";
+    const response = await sheets.spreadsheets.values.get({ spreadsheetId, range: sheetName });
+    const rawRows = response.data.values ?? [];
+    if (rawRows.length === 0) {
+      return { sheetName, sheetId, rawRows, header: [], entries: [] };
+    }
+    const header = rawRows[0].map((h) => String(h).trim());
+    const testIdIdx = header.indexOf(testIdCol);
+    const disabledUntilIdx = header.indexOf(disabledUntilCol);
+    const notesIdx = header.indexOf("notes");
+    if (testIdIdx === -1) {
+      throw new Error(
+        `[skipper] Column "${testIdCol}" not found in sheet "${sheetName}". Found columns: ${header.join(", ")}`
+      );
+    }
+    const entries = [];
+    for (let i = 1; i < rawRows.length; i++) {
+      const row = rawRows[i];
+      const testId = row[testIdIdx] ? String(row[testIdIdx]).trim() : "";
+      if (!testId) continue;
+      let disabledUntil = null;
+      if (disabledUntilIdx !== -1 && row[disabledUntilIdx]) {
+        const raw = String(row[disabledUntilIdx]).trim();
+        if (raw) {
+          const parsed = new Date(raw);
+          if (!isNaN(parsed.getTime())) {
+            disabledUntil = parsed;
+          } else {
+            warn(
+              `[skipper] Row ${i + 1} in "${sheetName}": invalid date "${raw}" in "${disabledUntilCol}" \u2014 treating as enabled`
+            );
+          }
+        }
+      }
+      const notes = notesIdx !== -1 && row[notesIdx] ? String(row[notesIdx]) : void 0;
+      entries.push({ testId, disabledUntil, notes });
+    }
+    return { sheetName, sheetId, rawRows, header, entries };
+  }
+  /**
+   * Fetches the primary sheet and all reference sheets in a single API session.
+   *
+   * Returns:
+   * - `primary`: the primary sheet's full result (rawRows + header) for writer use
+   * - `entries`: merged test entries from all sheets (for resolver use)
+   * - `sheets`: the authenticated Sheets API client (reuse for write operations)
+   *
+   * googleapis and google-auth-library are loaded here via dynamic import so that
+   * worker processes, which only call SkipperResolver.fromJSON(), never load them.
+   *
+   * Deduplication: when the same testId appears in multiple sheets, the most
+   * restrictive (latest) disabledUntil wins.
+   */
+  async fetchAll() {
+    const { google } = await import("googleapis");
+    const { JWT } = await import("google-auth-library");
+    const creds = resolveCredentials(this.config);
+    const auth = new JWT({
+      email: creds.client_email,
+      key: creds.private_key,
+      scopes: ["https://www.googleapis.com/auth/spreadsheets"]
+    });
+    const sheets = google.sheets({ version: "v4", auth });
+    const spreadsheetId = this.config.spreadsheetId;
+    const meta = await sheets.spreadsheets.get({ spreadsheetId });
+    const allSheetMeta = meta.data.sheets ?? [];
+    const sheetIdByName = new Map(
+      allSheetMeta.filter((s) => s.properties?.title != null && s.properties.sheetId != null).map((s) => [s.properties.title, s.properties.sheetId])
+    );
+    const primaryName = this.config.sheetName ?? allSheetMeta[0]?.properties?.title ?? "Sheet1";
+    const primaryId = sheetIdByName.get(primaryName);
+    if (primaryId == null) {
+      throw new Error(`[skipper] Sheet "${primaryName}" not found in spreadsheet.`);
+    }
+    const primary = await this.fetchSheet(sheets, primaryName, primaryId);
+    const referenceEntries = [];
+    for (const refName of this.config.referenceSheets ?? []) {
+      const refId = sheetIdByName.get(refName);
+      if (refId == null) {
+        warn(`[skipper] Reference sheet "${refName}" not found \u2014 skipping.`);
+        continue;
+      }
+      const result = await this.fetchSheet(sheets, refName, refId);
+      referenceEntries.push(...result.entries);
+    }
+    const merged = /* @__PURE__ */ new Map();
+    for (const entry of [...primary.entries, ...referenceEntries]) {
+      const key = normalizeTestId(entry.testId);
+      const existing = merged.get(key);
+      if (!existing) {
+        merged.set(key, entry);
+      } else if (entry.disabledUntil !== null) {
+        if (existing.disabledUntil === null || entry.disabledUntil > existing.disabledUntil) {
+          merged.set(key, entry);
+        }
+      }
+    }
+    return { primary, entries: [...merged.values()], sheets };
+  }
+};
+
+// src/writer.ts
+var SheetsWriter = class {
+  constructor(config) {
+    this.config = config;
+    this.client = new SheetsClient(config);
+  }
+  /**
+   * Reconciles the spreadsheet with the discovered test IDs:
+   * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)
+   * - Deletes rows for tests that no longer exist in the suite
+   *
+   * Only the primary sheet is modified. Reference sheets are never written to.
+   * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).
+   * The header row (row 1) is never modified.
+   *
+   * A single fetchAll() call is made to retrieve sheet metadata, existing entries,
+   * and raw rows — no redundant API calls.
+   */
+  async sync(discoveredIds) {
+    const { primary, entries: existingEntries, sheets } = await this.client.fetchAll();
+    const { sheetName, sheetId, rawRows, header } = primary;
+    const testIdCol = this.config.testIdColumn ?? "testId";
+    const disabledUntilCol = this.config.disabledUntilColumn ?? "disabledUntil";
+    const normalizedDiscovered = new Set(discoveredIds.map(normalizeTestId));
+    const normalizedExisting = new Map(
+      existingEntries.map((e) => [normalizeTestId(e.testId), e])
+    );
+    const toAdd = discoveredIds.filter((id) => !normalizedExisting.has(normalizeTestId(id)));
+    const toRemoveNormalized = new Set(
+      [...normalizedExisting.keys()].filter((nid) => !normalizedDiscovered.has(nid))
+    );
+    if (toAdd.length === 0 && toRemoveNormalized.size === 0) {
+      log("[skipper] Spreadsheet is already up to date.");
+      return;
+    }
+    const spreadsheetId = this.config.spreadsheetId;
+    const testIdIdx = header.indexOf(testIdCol);
+    const rowIndicesToDelete = [];
+    for (let i = 1; i < rawRows.length; i++) {
+      const id = rawRows[i][testIdIdx] ? String(rawRows[i][testIdIdx]).trim() : "";
+      if (id && toRemoveNormalized.has(normalizeTestId(id))) {
+        rowIndicesToDelete.push(i);
+      }
+    }
+    const deleteRequests = rowIndicesToDelete.sort((a, b) => b - a).map((rowIdx) => ({
+      deleteDimension: {
+        range: { sheetId, dimension: "ROWS", startIndex: rowIdx, endIndex: rowIdx + 1 }
+      }
+    }));
+    if (deleteRequests.length > 0) {
+      await sheets.spreadsheets.batchUpdate({
+        spreadsheetId,
+        requestBody: { requests: deleteRequests }
+      });
+      log(`[skipper] Removed ${deleteRequests.length} obsolete test(s) from spreadsheet.`);
+    }
+    if (toAdd.length > 0) {
+      const headerIdxDisabledUntil = header.indexOf(disabledUntilCol);
+      const newRows = toAdd.map((testId) => {
+        const row = new Array(Math.max(testIdIdx + 1, headerIdxDisabledUntil + 1)).fill("");
+        row[testIdIdx] = testId;
+        if (headerIdxDisabledUntil !== -1) row[headerIdxDisabledUntil] = "";
+        return row;
+      });
+      await sheets.spreadsheets.values.append({
+        spreadsheetId,
+        range: sheetName,
+        valueInputOption: "RAW",
+        requestBody: { values: newRows }
+      });
+      log(`[skipper] Added ${toAdd.length} new test(s) to spreadsheet.`);
+    }
+  }
+};
+
+// src/resolver.ts
+var SkipperResolver = class _SkipperResolver {
+  constructor(config) {
+    /** normalized testId → disabledUntil ISO string (null = no date = enabled) */
+    this.cache = /* @__PURE__ */ new Map();
+    this.initialized = false;
+    this.config = config;
+    this.client = new SheetsClient(config);
+  }
+  /**
+   * Fetches the spreadsheet and populates the in-memory cache.
+   * Must be called once before `isTestEnabled()`.
+   */
+  async initialize() {
+    const { entries } = await this.client.fetchAll();
+    this.cache = new Map(
+      entries.map((e) => [
+        normalizeTestId(e.testId),
+        e.disabledUntil ? e.disabledUntil.toISOString() : null
+      ])
+    );
+    this.initialized = true;
+  }
+  /**
+   * Returns true if the test should run.
+   *
+   * Logic:
+   * - Not in spreadsheet → true (opt-out model: unknown tests run by default)
+   * - disabledUntil is null or in the past → true
+   * - disabledUntil is in the future → false
+   */
+  isTestEnabled(testId) {
+    if (!this.initialized) {
+      throw new Error(
+        "[skipper] SkipperResolver.initialize() must be called before isTestEnabled(). Did you forget to add the globalSetup to your config?"
+      );
+    }
+    const normalized = normalizeTestId(testId);
+    if (!this.cache.has(normalized)) return true;
+    const iso = this.cache.get(normalized);
+    if (!iso) return true;
+    return new Date(iso) <= /* @__PURE__ */ new Date();
+  }
+  /**
+   * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).
+   * Dates are stored as ISO strings; null means no date (enabled).
+   */
+  toJSON() {
+    return Object.fromEntries(this.cache);
+  }
+  /**
+   * Rehydrates a resolver from a serialized cache.
+   * Used in worker processes that cannot call initialize() again.
+   */
+  static fromJSON(data) {
+    const resolver = new _SkipperResolver({
+      spreadsheetId: "",
+      credentials: { credentialsBase64: "" }
+    });
+    resolver.cache = new Map(Object.entries(data));
+    resolver.initialized = true;
+    return resolver;
+  }
+  getMode() {
+    const mode = process.env.SKIPPER_MODE;
+    if (mode === "sync") return "sync";
+    return "read-only";
+  }
+};
+export {
+  SheetsClient,
+  SheetsWriter,
+  SkipperResolver,
+  buildTestId,
+  error,
+  log,
+  normalizeTestId,
+  warn
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts","../src/client.ts","../src/cache.ts","../src/writer.ts","../src/resolver.ts"],"sourcesContent":["/**\n * Skipper logger — output is suppressed unless SKIPPER_DEBUG=1 (or any truthy value).\n */\n\nfunction isEnabled(): boolean {\n  return Boolean(process.env.SKIPPER_DEBUG);\n}\n\nexport function log(message: string): void {\n  if (isEnabled()) console.log(message);\n}\n\nexport function warn(message: string): void {\n  if (isEnabled()) console.warn(message);\n}\n\nexport function error(message: string): void {\n  if (isEnabled()) console.error(message);\n}\n","import * as fs from 'fs';\nimport { normalizeTestId } from './cache';\nimport { warn } from './logger';\nimport type { SkipperConfig, TestEntry, ServiceAccountCredentials } from './types';\n\n// googleapis and google-auth-library are imported dynamically inside fetchAll() so that\n// worker processes that only call SkipperResolver.fromJSON() never load these modules.\n// Loading googleapis initialises an HTTP keep-alive agent that prevents worker exit.\nimport type { sheets_v4 } from 'googleapis';\n\nfunction resolveCredentials(config: SkipperConfig): ServiceAccountCredentials {\n  const { credentials } = config;\n\n  if ('credentialsFile' in credentials) {\n    const raw = fs.readFileSync(credentials.credentialsFile, 'utf8');\n    return JSON.parse(raw) as ServiceAccountCredentials;\n  }\n\n  if ('credentialsBase64' in credentials) {\n    const raw = Buffer.from(credentials.credentialsBase64, 'base64').toString('utf8');\n    return JSON.parse(raw) as ServiceAccountCredentials;\n  }\n\n  return credentials as ServiceAccountCredentials;\n}\n\nexport interface SheetFetchResult {\n  /** Resolved sheet tab name. */\n  sheetName: string;\n  /** Numeric sheet ID (used for batchUpdate deletions). */\n  sheetId: number;\n  /** Raw rows including the header row (row 0). */\n  rawRows: string[][];\n  /** Parsed header cells (trimmed). */\n  header: string[];\n  /** Parsed test entries. */\n  entries: TestEntry[];\n}\n\nexport interface FetchAllResult {\n  /** Full data for the primary (writable) sheet — used by SheetsWriter. */\n  primary: SheetFetchResult;\n  /** Merged entries from primary + all referenceSheets — used by SkipperResolver. */\n  entries: TestEntry[];\n  /**\n   * Authenticated Sheets API client — returned here so callers (SheetsWriter)\n   * can reuse the same auth session for write operations without a second auth call.\n   */\n  sheets: sheets_v4.Sheets;\n}\n\nexport class SheetsClient {\n  private readonly config: SkipperConfig;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n  }\n\n  private async fetchSheet(\n    sheets: sheets_v4.Sheets,\n    sheetName: string,\n    sheetId: number,\n  ): Promise<SheetFetchResult> {\n    const spreadsheetId = this.config.spreadsheetId;\n    const testIdCol = this.config.testIdColumn ?? 'testId';\n    const disabledUntilCol = this.config.disabledUntilColumn ?? 'disabledUntil';\n\n    const response = await sheets.spreadsheets.values.get({ spreadsheetId, range: sheetName });\n    const rawRows = (response.data.values ?? []) as string[][];\n\n    if (rawRows.length === 0) {\n      return { sheetName, sheetId, rawRows, header: [], entries: [] };\n    }\n\n    const header = rawRows[0].map((h: string) => String(h).trim());\n    const testIdIdx = header.indexOf(testIdCol);\n    const disabledUntilIdx = header.indexOf(disabledUntilCol);\n    const notesIdx = header.indexOf('notes');\n\n    if (testIdIdx === -1) {\n      throw new Error(\n        `[skipper] Column \"${testIdCol}\" not found in sheet \"${sheetName}\". ` +\n          `Found columns: ${header.join(', ')}`,\n      );\n    }\n\n    const entries: TestEntry[] = [];\n    for (let i = 1; i < rawRows.length; i++) {\n      const row = rawRows[i];\n      const testId = row[testIdIdx] ? String(row[testIdIdx]).trim() : '';\n      if (!testId) continue;\n\n      let disabledUntil: Date | null = null;\n      if (disabledUntilIdx !== -1 && row[disabledUntilIdx]) {\n        const raw = String(row[disabledUntilIdx]).trim();\n        if (raw) {\n          const parsed = new Date(raw);\n          if (!isNaN(parsed.getTime())) {\n            disabledUntil = parsed;\n          } else {\n            warn(\n              `[skipper] Row ${i + 1} in \"${sheetName}\": invalid date \"${raw}\" in \"${disabledUntilCol}\" — treating as enabled`,\n            );\n          }\n        }\n      }\n\n      const notes = notesIdx !== -1 && row[notesIdx] ? String(row[notesIdx]) : undefined;\n      entries.push({ testId, disabledUntil, notes });\n    }\n\n    return { sheetName, sheetId, rawRows, header, entries };\n  }\n\n  /**\n   * Fetches the primary sheet and all reference sheets in a single API session.\n   *\n   * Returns:\n   * - `primary`: the primary sheet's full result (rawRows + header) for writer use\n   * - `entries`: merged test entries from all sheets (for resolver use)\n   * - `sheets`: the authenticated Sheets API client (reuse for write operations)\n   *\n   * googleapis and google-auth-library are loaded here via dynamic import so that\n   * worker processes, which only call SkipperResolver.fromJSON(), never load them.\n   *\n   * Deduplication: when the same testId appears in multiple sheets, the most\n   * restrictive (latest) disabledUntil wins.\n   */\n  async fetchAll(): Promise<FetchAllResult> {\n    // Dynamic imports — only executed when actually fetching from the spreadsheet.\n    const { google } = await import('googleapis');\n    const { JWT } = await import('google-auth-library');\n\n    const creds = resolveCredentials(this.config);\n    const auth = new JWT({\n      email: creds.client_email,\n      key: creds.private_key,\n      scopes: ['https://www.googleapis.com/auth/spreadsheets'],\n    });\n    const sheets = google.sheets({ version: 'v4', auth });\n\n    const spreadsheetId = this.config.spreadsheetId;\n    const meta = await sheets.spreadsheets.get({ spreadsheetId });\n    const allSheetMeta = meta.data.sheets ?? [];\n\n    const sheetIdByName = new Map<string, number>(\n      allSheetMeta\n        .filter((s) => s.properties?.title != null && s.properties.sheetId != null)\n        .map((s) => [s.properties!.title!, s.properties!.sheetId!]),\n    );\n\n    const primaryName = this.config.sheetName ?? allSheetMeta[0]?.properties?.title ?? 'Sheet1';\n    const primaryId = sheetIdByName.get(primaryName);\n    if (primaryId == null) {\n      throw new Error(`[skipper] Sheet \"${primaryName}\" not found in spreadsheet.`);\n    }\n\n    const primary = await this.fetchSheet(sheets, primaryName, primaryId);\n\n    const referenceEntries: TestEntry[] = [];\n    for (const refName of this.config.referenceSheets ?? []) {\n      const refId = sheetIdByName.get(refName);\n      if (refId == null) {\n        warn(`[skipper] Reference sheet \"${refName}\" not found — skipping.`);\n        continue;\n      }\n      const result = await this.fetchSheet(sheets, refName, refId);\n      referenceEntries.push(...result.entries);\n    }\n\n    const merged = new Map<string, TestEntry>();\n    for (const entry of [...primary.entries, ...referenceEntries]) {\n      const key = normalizeTestId(entry.testId);\n      const existing = merged.get(key);\n      if (!existing) {\n        merged.set(key, entry);\n      } else if (entry.disabledUntil !== null) {\n        if (existing.disabledUntil === null || entry.disabledUntil > existing.disabledUntil) {\n          merged.set(key, entry);\n        }\n      }\n    }\n\n    return { primary, entries: [...merged.values()], sheets };\n  }\n}\n","import * as path from 'path';\n\n/**\n * Normalizes a testId for consistent comparison:\n * - trim leading/trailing whitespace\n * - lowercase\n * - collapse multiple whitespace characters into a single space\n */\nexport function normalizeTestId(id: string): string {\n  return id.trim().toLowerCase().replace(/\\s+/g, ' ');\n}\n\n/**\n * Builds a canonical testId from a file path and the test title path.\n *\n * Format: \"{relativePath} > {titlePath.join(' > ')}\"\n * Example: \"tests/auth/login.spec.ts > login > should log in with valid credentials\"\n *\n * The filePath is made relative to process.cwd() if it is absolute.\n * The titlePath is the array of describe block names + the test name,\n * as provided by the test framework (never pre-joined).\n */\nexport function buildTestId(filePath: string, titlePath: string[]): string {\n  const relativePath = path.isAbsolute(filePath)\n    ? path.relative(process.cwd(), filePath)\n    : filePath;\n\n  const normalizedPath = relativePath.split(path.sep).join('/');\n  return [normalizedPath, ...titlePath].join(' > ');\n}\n","import { SheetsClient } from './client';\nimport { normalizeTestId } from './cache';\nimport { log } from './logger';\nimport type { SkipperConfig, TestEntry } from './types';\n\nexport class SheetsWriter {\n  private readonly client: SheetsClient;\n  private readonly config: SkipperConfig;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n    this.client = new SheetsClient(config);\n  }\n\n  /**\n   * Reconciles the spreadsheet with the discovered test IDs:\n   * - Appends rows for tests not yet in the primary sheet (with empty disabledUntil)\n   * - Deletes rows for tests that no longer exist in the suite\n   *\n   * Only the primary sheet is modified. Reference sheets are never written to.\n   * Rows are matched by normalized testId (case-insensitive, whitespace-collapsed).\n   * The header row (row 1) is never modified.\n   *\n   * A single fetchAll() call is made to retrieve sheet metadata, existing entries,\n   * and raw rows — no redundant API calls.\n   */\n  async sync(discoveredIds: string[]): Promise<void> {\n    // One fetchAll() resolves the sheet name from metadata, fetches existing\n    // entries, and returns raw rows and the authenticated Sheets client —\n    // all in two API calls (metadata + values). No second auth/fetch needed.\n    const { primary, entries: existingEntries, sheets } = await this.client.fetchAll();\n    const { sheetName, sheetId, rawRows, header } = primary;\n\n    const testIdCol = this.config.testIdColumn ?? 'testId';\n    const disabledUntilCol = this.config.disabledUntilColumn ?? 'disabledUntil';\n\n    const normalizedDiscovered = new Set(discoveredIds.map(normalizeTestId));\n    const normalizedExisting = new Map<string, TestEntry>(\n      existingEntries.map((e) => [normalizeTestId(e.testId), e]),\n    );\n\n    const toAdd = discoveredIds.filter((id) => !normalizedExisting.has(normalizeTestId(id)));\n    const toRemoveNormalized = new Set(\n      [...normalizedExisting.keys()].filter((nid) => !normalizedDiscovered.has(nid)),\n    );\n\n    if (toAdd.length === 0 && toRemoveNormalized.size === 0) {\n      log('[skipper] Spreadsheet is already up to date.');\n      return;\n    }\n\n    const spreadsheetId = this.config.spreadsheetId;\n\n    const testIdIdx = header.indexOf(testIdCol);\n\n    // Identify 0-based row indices (within rawRows) to delete, skipping header at 0.\n    const rowIndicesToDelete: number[] = [];\n    for (let i = 1; i < rawRows.length; i++) {\n      const id = rawRows[i][testIdIdx] ? String(rawRows[i][testIdIdx]).trim() : '';\n      if (id && toRemoveNormalized.has(normalizeTestId(id))) {\n        rowIndicesToDelete.push(i);\n      }\n    }\n\n    // Deletions must be sorted descending to avoid index shifting.\n    const deleteRequests = rowIndicesToDelete\n      .sort((a, b) => b - a)\n      .map((rowIdx) => ({\n        deleteDimension: {\n          range: { sheetId, dimension: 'ROWS', startIndex: rowIdx, endIndex: rowIdx + 1 },\n        },\n      }));\n\n    if (deleteRequests.length > 0) {\n      await sheets.spreadsheets.batchUpdate({\n        spreadsheetId,\n        requestBody: { requests: deleteRequests },\n      });\n      log(`[skipper] Removed ${deleteRequests.length} obsolete test(s) from spreadsheet.`);\n    }\n\n    // Append new rows.\n    if (toAdd.length > 0) {\n      const headerIdxDisabledUntil = header.indexOf(disabledUntilCol);\n\n      const newRows = toAdd.map((testId) => {\n        const row: string[] = new Array(Math.max(testIdIdx + 1, headerIdxDisabledUntil + 1)).fill('');\n        row[testIdIdx] = testId;\n        if (headerIdxDisabledUntil !== -1) row[headerIdxDisabledUntil] = '';\n        return row;\n      });\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId,\n        range: sheetName,\n        valueInputOption: 'RAW',\n        requestBody: { values: newRows },\n      });\n      log(`[skipper] Added ${toAdd.length} new test(s) to spreadsheet.`);\n    }\n  }\n}\n","import { SheetsClient } from './client';\nimport { normalizeTestId } from './cache';\nimport type { SkipperConfig, SkipperMode } from './types';\n\n/**\n * SkipperResolver is the primary interface used by framework plugins.\n *\n * Lifecycle:\n * 1. Call `initialize()` once before tests run (in globalSetup / before hook).\n * 2. Call `isTestEnabled(testId)` per test to decide whether to skip.\n * 3. In sync mode, call `toJSON()` to serialize the cache for cross-process sharing.\n * 4. In worker processes, use `SkipperResolver.fromJSON()` to rehydrate.\n */\nexport class SkipperResolver {\n  private readonly client: SheetsClient;\n  private readonly config: SkipperConfig;\n  /** normalized testId → disabledUntil ISO string (null = no date = enabled) */\n  private cache: Map<string, string | null> = new Map();\n  private initialized = false;\n\n  constructor(config: SkipperConfig) {\n    this.config = config;\n    this.client = new SheetsClient(config);\n  }\n\n  /**\n   * Fetches the spreadsheet and populates the in-memory cache.\n   * Must be called once before `isTestEnabled()`.\n   */\n  async initialize(): Promise<void> {\n    const { entries } = await this.client.fetchAll();\n    this.cache = new Map(\n      entries.map((e) => [\n        normalizeTestId(e.testId),\n        e.disabledUntil ? e.disabledUntil.toISOString() : null,\n      ]),\n    );\n    this.initialized = true;\n  }\n\n  /**\n   * Returns true if the test should run.\n   *\n   * Logic:\n   * - Not in spreadsheet → true (opt-out model: unknown tests run by default)\n   * - disabledUntil is null or in the past → true\n   * - disabledUntil is in the future → false\n   */\n  isTestEnabled(testId: string): boolean {\n    if (!this.initialized) {\n      throw new Error(\n        '[skipper] SkipperResolver.initialize() must be called before isTestEnabled(). ' +\n          'Did you forget to add the globalSetup to your config?',\n      );\n    }\n\n    const normalized = normalizeTestId(testId);\n    if (!this.cache.has(normalized)) return true;\n\n    const iso = this.cache.get(normalized);\n    if (!iso) return true;\n\n    return new Date(iso) <= new Date();\n  }\n\n  /**\n   * Serializes the cache for cross-process sharing (e.g. globalSetup → workers).\n   * Dates are stored as ISO strings; null means no date (enabled).\n   */\n  toJSON(): Record<string, string | null> {\n    return Object.fromEntries(this.cache);\n  }\n\n  /**\n   * Rehydrates a resolver from a serialized cache.\n   * Used in worker processes that cannot call initialize() again.\n   */\n  static fromJSON(data: Record<string, string | null>): SkipperResolver {\n    // We pass a dummy config since the client is never used after fromJSON\n    const resolver = new SkipperResolver({\n      spreadsheetId: '',\n      credentials: { credentialsBase64: '' },\n    });\n    resolver.cache = new Map(Object.entries(data));\n    resolver.initialized = true;\n    return resolver;\n  }\n\n  getMode(): SkipperMode {\n    const mode = process.env.SKIPPER_MODE;\n    if (mode === 'sync') return 'sync';\n    return 'read-only';\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@get-skipper/core",
+  "version": "1.0.0",
+  "description": "Core Google Sheets client and resolver for Skipper test-gating plugins",
+  "keywords": [
+    "skipper",
+    "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": {
+    "googleapis": "^140.0.0",
+    "google-auth-library": "^9.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest --config ../../jest.config.js --testPathPattern=packages/core/"
+  }
+}