@seedmancer/playwright 0.1.0 → 0.2.0

package/README.md

@@ -72,3 +72,44 @@ test.describe("admin flows", () => {
 | CLI not found | `Seedmancer CLI not found. Make sure it is installed and available in PATH.` |
 | Non-zero exit | `Seedmancer exited with status <N>: <stderr/stdout>` |
 | Killed by signal | `Seedmancer was terminated by signal: <signal>` |
+
+## Global setup — pull scenarios before the suite
+
+Use `@seedmancer/playwright/global-setup` to pull seed data from Seedmancer Cloud once before the test suite starts. This is separate from the per-test seeding fixture.
+
+### 1. Create a global setup file
+
+```ts
+// playwright.global-setup.ts
+import { createSeedmancerGlobalSetup } from "@seedmancer/playwright/global-setup"
+
+export default createSeedmancerGlobalSetup({
+  scenarios: ["api-test"],
+  // tokenEnv defaults to "SEEDMANCER_API_TOKEN"
+  tokenEnv: "SEEDMANCER_API_TOKEN",
+  // cwd defaults to process.cwd()
+  cwd: "../",
+})
+```
+
+### 2. Reference it from your Playwright config
+
+```ts
+// playwright.config.ts
+import { defineConfig } from "@playwright/test"
+
+export default defineConfig({
+  globalSetup: "./playwright.global-setup.ts",
+})
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `scenarios` | `string[]` | required | Scenarios to pull from Seedmancer Cloud. |
+| `token` | `string` | — | API token. Takes precedence over `tokenEnv`. |
+| `tokenEnv` | `string` | `"SEEDMANCER_API_TOKEN"` | Environment variable name to read the token from. |
+| `cwd` | `string` | `process.cwd()` | Working directory for the CLI (directory containing `seedmancer.yaml`). |
+
+The token is never logged or included in error messages.

package/dist/global-setup.d.ts

@@ -0,0 +1,8 @@
+export type SeedmancerGlobalSetupOptions = {
+    scenarios: string[];
+    token?: string;
+    tokenEnv?: string;
+    cwd?: string;
+};
+export declare function createSeedmancerGlobalSetup(options: SeedmancerGlobalSetupOptions): () => Promise<void>;
+//# sourceMappingURL=global-setup.d.ts.map

package/dist/global-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.d.ts","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAmCF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,SAEU,OAAO,CAAC,IAAI,CAAC,CAgB7D"}

package/dist/global-setup.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSeedmancerGlobalSetup = createSeedmancerGlobalSetup;
+const node_child_process_1 = require("node:child_process");
+function runSeedmancerPull(scenario, token, cwd) {
+    const result = (0, node_child_process_1.spawnSync)('seedmancer', ['pull', scenario, '--token', token], {
+        cwd,
+        stdio: 'pipe',
+        encoding: 'utf-8',
+    });
+    if (result.error !== undefined) {
+        const err = result.error;
+        if (err.code === 'ENOENT') {
+            throw new Error('Seedmancer CLI not found. Make sure it is installed and available in PATH.\n' +
+                'See https://seedmancer.dev/docs/install for installation instructions.');
+        }
+        throw result.error;
+    }
+    if (result.signal !== null) {
+        throw new Error(`Seedmancer was terminated by signal: ${result.signal}`);
+    }
+    if (result.status !== 0) {
+        const output = [result.stderr?.trim(), result.stdout?.trim()]
+            .filter(Boolean)
+            .join('\n');
+        throw new Error(`seedmancer pull failed for scenario "${scenario}" with status ${result.status}` +
+            (output.length > 0 ? `:\n${output}` : ''));
+    }
+}
+function createSeedmancerGlobalSetup(options) {
+    return async function seedmancerGlobalSetup() {
+        const cwd = options.cwd ?? process.cwd();
+        const tokenEnv = options.tokenEnv ?? 'SEEDMANCER_API_TOKEN';
+        const token = options.token ?? process.env[tokenEnv];
+        if (token === undefined || token === '') {
+            throw new Error(`Seedmancer API token is missing. ` +
+                `Set the ${tokenEnv} environment variable or pass token directly.`);
+        }
+        for (const scenario of options.scenarios) {
+            runSeedmancerPull(scenario, token, cwd);
+        }
+    };
+}
+//# sourceMappingURL=global-setup.js.map

package/dist/global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-setup.js","sourceRoot":"","sources":["../src/global-setup.ts"],"names":[],"mappings":";;AA0CA,kEAmBC;AA7DD,2DAA+C;AAS/C,SAAS,iBAAiB,CAAC,QAAgB,EAAE,KAAa,EAAE,GAAW;IACrE,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,YAAY,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;QAC3E,GAAG;QACH,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAA8B,CAAC;QAClD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,8EAA8E;gBAC5E,wEAAwE,CAC3E,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;aAC1D,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,iBAAiB,MAAM,CAAC,MAAM,EAAE;YAC9E,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,2BAA2B,CACzC,OAAqC;IAErC,OAAO,KAAK,UAAU,qBAAqB;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,sBAAsB,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAErD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,mCAAmC;gBACjC,WAAW,QAAQ,+CAA+C,CACrE,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedmancer/playwright",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Playwright integration for Seedmancer – automatically seed your database before each test",
   "keywords": [
     "playwright",
@@ -22,6 +22,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./global-setup": {
+      "types": "./dist/global-setup.d.ts",
+      "default": "./dist/global-setup.js"
     }
   },
   "files": [