@entifix/testing-e2e 0.1.0-0

package/dist/playwright/test.js

@@ -0,0 +1,79 @@
+import { defineNetworkFixture } from '@msw/playwright';
+import { test as base } from '@playwright/test';
+import { isMockProfile } from '../profile/profile.js';
+import { assertExpectedServerOnce } from './assert-expected-server.js';
+/**
+ * In `live`, the network is untouched — so reaching for it is a mistake worth
+ * reporting rather than a silent no-op that makes a spec assert nothing.
+ */ const liveNetwork = ()=>new Proxy({}, {
+        get (_target, property) {
+            throw new Error(`The network fixture is not available in the live profile (tried to use "${String(property)}"). Move this expectation into a *.mock.spec.ts file.`);
+        }
+    });
+/**
+ * Playwright's own `test`, plus the reused-server guard and nothing else.
+ *
+ * For a spec that wants no msw network and no seeded session — proving the
+ * unauthenticated redirect, say. It exists so that "this spec needs no
+ * fixtures" cannot quietly mean "this spec is not checked against the artifact
+ * it is running on": importing `test` straight from `@playwright/test` is what
+ * left the account journeys resolving a principal against a live auth-service
+ * while claiming to be hermetic.
+ */ export const baseTest = base.extend({
+    expectedServer: [
+        async ({ baseURL }, use)=>{
+            await assertExpectedServerOnce(baseURL);
+            await use();
+        },
+        {
+            auto: true
+        }
+    ]
+});
+/**
+ * Builds the `test` an entifix app e2e project imports.
+ *
+ * In `mock` it installs the msw handlers over Playwright's `page.route()`
+ * (via `@msw/playwright`), so the browser talks to the fixture backend and the
+ * app itself is untouched — no worker script, no `NEXT_PUBLIC_*` switch, no
+ * mocking code shipped in the application bundle. In `live` the fixture stands
+ * down and the same specs hit the real service.
+ */ export const defineEntifixE2eTest = ({ handlers = [], passthroughOrigins = [] } = {})=>baseTest.extend({
+        handlers: [
+            handlers,
+            {
+                option: true
+            }
+        ],
+        network: [
+            async ({ context, handlers: activeHandlers }, use)=>{
+                if (!isMockProfile()) {
+                    await use(liveNetwork());
+                    return;
+                }
+                const network = defineNetworkFixture({
+                    context,
+                    handlers: activeHandlers,
+                    // An unstubbed *service* request must fail the test rather than
+                    // escape to the network: a spec that passes because it silently
+                    // talked to nothing is worse than one that fails. The app's own
+                    // origin is exempt — it legitimately serves itself.
+                    onUnhandledRequest: (request, print)=>{
+                        if (passthroughOrigins.some((origin)=>request.url.startsWith(origin))) {
+                            return;
+                        }
+                        print.error();
+                    }
+                });
+                await network.enable();
+                await use(network);
+                await network.disable();
+            },
+            {
+                auto: true
+            }
+        ]
+    });
+export { expect } from '@playwright/test';
+
+//# sourceMappingURL=test.js.map

package/dist/playwright/test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/playwright/test.ts"],"sourcesContent":["import { defineNetworkFixture, type NetworkFixture } from '@msw/playwright';\nimport { test as base } from '@playwright/test';\nimport type { AnyHandler } from 'msw';\n\nimport { isMockProfile } from '../profile/profile.js';\nimport { assertExpectedServerOnce } from './assert-expected-server.js';\n\nexport interface EntifixE2eFixtures {\n  /** The handlers the mock profile starts from. Overridable per project. */\n  handlers: AnyHandler[];\n  /** The msw network, for per-test overrides in a `*.mock.spec.ts`. */\n  network: NetworkFixture;\n  /** Refuses a hermetic run against a reused development server. */\n  expectedServer: void;\n}\n\nexport interface EntifixE2eTestOptions {\n  /**\n   * The mock backend. Ignored in the `live` profile, where the app talks to a\n   * real service.\n   */\n  handlers?: AnyHandler[];\n  /**\n   * Origins whose unstubbed requests are allowed through — in practice the app\n   * under test itself, which serves its own documents, RSC payloads and\n   * dev-tooling endpoints.\n   *\n   * Everything else must be stubbed: a request to a *service* that nobody\n   * handled fails the test rather than escaping to a machine that may not even\n   * be running.\n   */\n  passthroughOrigins?: string[];\n}\n\n/**\n * In `live`, the network is untouched — so reaching for it is a mistake worth\n * reporting rather than a silent no-op that makes a spec assert nothing.\n */\nconst liveNetwork = (): NetworkFixture =>\n  new Proxy({} as NetworkFixture, {\n    get(_target, property) {\n      throw new Error(\n        `The network fixture is not available in the live profile (tried to use \"${String(property)}\"). Move this expectation into a *.mock.spec.ts file.`,\n      );\n    },\n  });\n\n/**\n * Playwright's own `test`, plus the reused-server guard and nothing else.\n *\n * For a spec that wants no msw network and no seeded session — proving the\n * unauthenticated redirect, say. It exists so that \"this spec needs no\n * fixtures\" cannot quietly mean \"this spec is not checked against the artifact\n * it is running on\": importing `test` straight from `@playwright/test` is what\n * left the account journeys resolving a principal against a live auth-service\n * while claiming to be hermetic.\n */\nexport const baseTest = base.extend<Pick<EntifixE2eFixtures, 'expectedServer'>>(\n  {\n    expectedServer: [\n      async ({ baseURL }, use) => {\n        await assertExpectedServerOnce(baseURL);\n        await use();\n      },\n      { auto: true },\n    ],\n  },\n);\n\n/**\n * Builds the `test` an entifix app e2e project imports.\n *\n * In `mock` it installs the msw handlers over Playwright's `page.route()`\n * (via `@msw/playwright`), so the browser talks to the fixture backend and the\n * app itself is untouched — no worker script, no `NEXT_PUBLIC_*` switch, no\n * mocking code shipped in the application bundle. In `live` the fixture stands\n * down and the same specs hit the real service.\n */\nexport const defineEntifixE2eTest = ({\n  handlers = [],\n  passthroughOrigins = [],\n}: EntifixE2eTestOptions = {}) =>\n  baseTest.extend<EntifixE2eFixtures>({\n    handlers: [handlers, { option: true }],\n\n    network: [\n      async ({ context, handlers: activeHandlers }, use) => {\n        if (!isMockProfile()) {\n          await use(liveNetwork());\n          return;\n        }\n\n        const network = defineNetworkFixture({\n          context,\n          handlers: activeHandlers,\n          // An unstubbed *service* request must fail the test rather than\n          // escape to the network: a spec that passes because it silently\n          // talked to nothing is worse than one that fails. The app's own\n          // origin is exempt — it legitimately serves itself.\n          onUnhandledRequest: (request, print) => {\n            if (\n              passthroughOrigins.some(origin => request.url.startsWith(origin))\n            ) {\n              return;\n            }\n            print.error();\n          },\n        });\n\n        await network.enable();\n        await use(network);\n        await network.disable();\n      },\n      { auto: true },\n    ],\n  });\n\nexport type { NetworkFixture } from '@msw/playwright';\nexport { expect } from '@playwright/test';\n"],"names":["defineNetworkFixture","test","base","isMockProfile","assertExpectedServerOnce","liveNetwork","Proxy","get","_target","property","Error","String","baseTest","extend","expectedServer","baseURL","use","auto","defineEntifixE2eTest","handlers","passthroughOrigins","option","network","context","activeHandlers","onUnhandledRequest","request","print","some","origin","url","startsWith","error","enable","disable","expect"],"mappings":"AAAA,SAASA,oBAAoB,QAA6B,kBAAkB;AAC5E,SAASC,QAAQC,IAAI,QAAQ,mBAAmB;AAGhD,SAASC,aAAa,QAAQ,wBAAwB;AACtD,SAASC,wBAAwB,QAAQ,8BAA8B;AA6BvE;;;CAGC,GACD,MAAMC,cAAc,IAClB,IAAIC,MAAM,CAAC,GAAqB;QAC9BC,KAAIC,OAAO,EAAEC,QAAQ;YACnB,MAAM,IAAIC,MACR,CAAC,wEAAwE,EAAEC,OAAOF,UAAU,qDAAqD,CAAC;QAEtJ;IACF;AAEF;;;;;;;;;CASC,GACD,OAAO,MAAMG,WAAWV,KAAKW,MAAM,CACjC;IACEC,gBAAgB;QACd,OAAO,EAAEC,OAAO,EAAE,EAAEC;YAClB,MAAMZ,yBAAyBW;YAC/B,MAAMC;QACR;QACA;YAAEC,MAAM;QAAK;KACd;AACH,GACA;AAEF;;;;;;;;CAQC,GACD,OAAO,MAAMC,uBAAuB,CAAC,EACnCC,WAAW,EAAE,EACbC,qBAAqB,EAAE,EACD,GAAG,CAAC,CAAC,GAC3BR,SAASC,MAAM,CAAqB;QAClCM,UAAU;YAACA;YAAU;gBAAEE,QAAQ;YAAK;SAAE;QAEtCC,SAAS;YACP,OAAO,EAAEC,OAAO,EAAEJ,UAAUK,cAAc,EAAE,EAAER;gBAC5C,IAAI,CAACb,iBAAiB;oBACpB,MAAMa,IAAIX;oBACV;gBACF;gBAEA,MAAMiB,UAAUtB,qBAAqB;oBACnCuB;oBACAJ,UAAUK;oBACV,gEAAgE;oBAChE,gEAAgE;oBAChE,gEAAgE;oBAChE,oDAAoD;oBACpDC,oBAAoB,CAACC,SAASC;wBAC5B,IACEP,mBAAmBQ,IAAI,CAACC,CAAAA,SAAUH,QAAQI,GAAG,CAACC,UAAU,CAACF,UACzD;4BACA;wBACF;wBACAF,MAAMK,KAAK;oBACb;gBACF;gBAEA,MAAMV,QAAQW,MAAM;gBACpB,MAAMjB,IAAIM;gBACV,MAAMA,QAAQY,OAAO;YACvB;YACA;gBAAEjB,MAAM;YAAK;SACd;IACH,GAAG;AAGL,SAASkB,MAAM,QAAQ,mBAAmB"}

package/dist/profile/profile.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The two ways an e2e suite can be run.
+ *
+ * - `mock` — hermetic. The system under test is real; everything it talks to is
+ *   a fake wired in at the transport boundary. Needs no infrastructure, so it
+ *   runs on every pull request.
+ * - `live` — the same journeys against real services and real datastores.
+ *   Run locally (or against a deployment) once the infra stack is up.
+ *
+ * The profile is a *run* concern, never a spec concern: a spec asks the fixture
+ * for a client or a page and stays identical in both.
+ */
+export declare const E2E_PROFILES: readonly ["mock", "live"];
+export type E2eProfile = (typeof E2E_PROFILES)[number];
+/** The environment variable that selects the profile. */
+export declare const E2E_PROFILE_VAR = "E2E_PROFILE";
+/**
+ * `mock` is the default because the default has to be the one that runs
+ * anywhere: a fresh clone, a CI runner, a laptop with no minikube. Requiring
+ * infrastructure to get a green run is how e2e suites end up being skipped.
+ */
+export declare const DEFAULT_E2E_PROFILE: E2eProfile;
+/** Just enough of `process.env` to read from, so specs can pass a literal. */
+export type E2eEnv = Record<string, string | undefined>;
+/**
+ * Reads the profile from the environment.
+ *
+ * An unrecognized value throws rather than falling back: `E2E_PROFILE=live-ish`
+ * silently running the mock suite is exactly the failure this whole seam exists
+ * to prevent.
+ */
+export declare const resolveE2eProfile: (env?: E2eEnv) => E2eProfile;
+export declare const isMockProfile: (env?: E2eEnv) => boolean;
+export declare const isLiveProfile: (env?: E2eEnv) => boolean;
+/**
+ * The base URL a `live` run must be pointed at, or a failure explaining how.
+ *
+ * It **throws**; it does not skip. A suite that skips itself when its target is
+ * missing reports green for a run that tested nothing, which is how a broken
+ * live environment stays unnoticed.
+ */
+export declare const requireLiveUrl: (variable: string, env?: E2eEnv) => string;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/profile/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,2BAA4B,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,yDAAyD;AACzD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAmB,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAKxD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAK,MAAoB,KAAG,UAQ7D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OACV,CAAC;AAEpC,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,OACV,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,MAAK,MAAoB,KACxB,MAQF,CAAC"}

package/dist/profile/profile.js

@@ -0,0 +1,51 @@
+/**
+ * The two ways an e2e suite can be run.
+ *
+ * - `mock` — hermetic. The system under test is real; everything it talks to is
+ *   a fake wired in at the transport boundary. Needs no infrastructure, so it
+ *   runs on every pull request.
+ * - `live` — the same journeys against real services and real datastores.
+ *   Run locally (or against a deployment) once the infra stack is up.
+ *
+ * The profile is a *run* concern, never a spec concern: a spec asks the fixture
+ * for a client or a page and stays identical in both.
+ */ export const E2E_PROFILES = [
+    'mock',
+    'live'
+];
+/** The environment variable that selects the profile. */ export const E2E_PROFILE_VAR = 'E2E_PROFILE';
+/**
+ * `mock` is the default because the default has to be the one that runs
+ * anywhere: a fresh clone, a CI runner, a laptop with no minikube. Requiring
+ * infrastructure to get a green run is how e2e suites end up being skipped.
+ */ export const DEFAULT_E2E_PROFILE = 'mock';
+const isProfile = (value)=>E2E_PROFILES.includes(value);
+/**
+ * Reads the profile from the environment.
+ *
+ * An unrecognized value throws rather than falling back: `E2E_PROFILE=live-ish`
+ * silently running the mock suite is exactly the failure this whole seam exists
+ * to prevent.
+ */ export const resolveE2eProfile = (env = process.env)=>{
+    const raw = env[E2E_PROFILE_VAR];
+    if (raw === undefined || raw === '') return DEFAULT_E2E_PROFILE;
+    if (isProfile(raw)) return raw;
+    throw new Error(`Unknown ${E2E_PROFILE_VAR} "${raw}". Expected one of: ${E2E_PROFILES.join(', ')}.`);
+};
+export const isMockProfile = (env)=>resolveE2eProfile(env) === 'mock';
+export const isLiveProfile = (env)=>resolveE2eProfile(env) === 'live';
+/**
+ * The base URL a `live` run must be pointed at, or a failure explaining how.
+ *
+ * It **throws**; it does not skip. A suite that skips itself when its target is
+ * missing reports green for a run that tested nothing, which is how a broken
+ * live environment stays unnoticed.
+ */ export const requireLiveUrl = (variable, env = process.env)=>{
+    const value = env[variable];
+    if (value === undefined || value === '') {
+        throw new Error(`${E2E_PROFILE_VAR}=live requires ${variable} to point at the running service, e.g. ${variable}=http://localhost:3101.`);
+    }
+    return value.replace(/\/+$/, '');
+};
+
+//# sourceMappingURL=profile.js.map

package/dist/profile/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/profile/profile.ts"],"sourcesContent":["/**\n * The two ways an e2e suite can be run.\n *\n * - `mock` — hermetic. The system under test is real; everything it talks to is\n *   a fake wired in at the transport boundary. Needs no infrastructure, so it\n *   runs on every pull request.\n * - `live` — the same journeys against real services and real datastores.\n *   Run locally (or against a deployment) once the infra stack is up.\n *\n * The profile is a *run* concern, never a spec concern: a spec asks the fixture\n * for a client or a page and stays identical in both.\n */\nexport const E2E_PROFILES = ['mock', 'live'] as const;\n\nexport type E2eProfile = (typeof E2E_PROFILES)[number];\n\n/** The environment variable that selects the profile. */\nexport const E2E_PROFILE_VAR = 'E2E_PROFILE';\n\n/**\n * `mock` is the default because the default has to be the one that runs\n * anywhere: a fresh clone, a CI runner, a laptop with no minikube. Requiring\n * infrastructure to get a green run is how e2e suites end up being skipped.\n */\nexport const DEFAULT_E2E_PROFILE: E2eProfile = 'mock';\n\n/** Just enough of `process.env` to read from, so specs can pass a literal. */\nexport type E2eEnv = Record<string, string | undefined>;\n\nconst isProfile = (value: string): value is E2eProfile =>\n  (E2E_PROFILES as readonly string[]).includes(value);\n\n/**\n * Reads the profile from the environment.\n *\n * An unrecognized value throws rather than falling back: `E2E_PROFILE=live-ish`\n * silently running the mock suite is exactly the failure this whole seam exists\n * to prevent.\n */\nexport const resolveE2eProfile = (env: E2eEnv = process.env): E2eProfile => {\n  const raw = env[E2E_PROFILE_VAR];\n  if (raw === undefined || raw === '') return DEFAULT_E2E_PROFILE;\n  if (isProfile(raw)) return raw;\n\n  throw new Error(\n    `Unknown ${E2E_PROFILE_VAR} \"${raw}\". Expected one of: ${E2E_PROFILES.join(', ')}.`,\n  );\n};\n\nexport const isMockProfile = (env?: E2eEnv): boolean =>\n  resolveE2eProfile(env) === 'mock';\n\nexport const isLiveProfile = (env?: E2eEnv): boolean =>\n  resolveE2eProfile(env) === 'live';\n\n/**\n * The base URL a `live` run must be pointed at, or a failure explaining how.\n *\n * It **throws**; it does not skip. A suite that skips itself when its target is\n * missing reports green for a run that tested nothing, which is how a broken\n * live environment stays unnoticed.\n */\nexport const requireLiveUrl = (\n  variable: string,\n  env: E2eEnv = process.env,\n): string => {\n  const value = env[variable];\n  if (value === undefined || value === '') {\n    throw new Error(\n      `${E2E_PROFILE_VAR}=live requires ${variable} to point at the running service, e.g. ${variable}=http://localhost:3101.`,\n    );\n  }\n  return value.replace(/\\/+$/, '');\n};\n"],"names":["E2E_PROFILES","E2E_PROFILE_VAR","DEFAULT_E2E_PROFILE","isProfile","value","includes","resolveE2eProfile","env","process","raw","undefined","Error","join","isMockProfile","isLiveProfile","requireLiveUrl","variable","replace"],"mappings":"AAAA;;;;;;;;;;;CAWC,GACD,OAAO,MAAMA,eAAe;IAAC;IAAQ;CAAO,CAAU;AAItD,uDAAuD,GACvD,OAAO,MAAMC,kBAAkB,cAAc;AAE7C;;;;CAIC,GACD,OAAO,MAAMC,sBAAkC,OAAO;AAKtD,MAAMC,YAAY,CAACC,QACjB,AAACJ,aAAmCK,QAAQ,CAACD;AAE/C;;;;;;CAMC,GACD,OAAO,MAAME,oBAAoB,CAACC,MAAcC,QAAQD,GAAG;IACzD,MAAME,MAAMF,GAAG,CAACN,gBAAgB;IAChC,IAAIQ,QAAQC,aAAaD,QAAQ,IAAI,OAAOP;IAC5C,IAAIC,UAAUM,MAAM,OAAOA;IAE3B,MAAM,IAAIE,MACR,CAAC,QAAQ,EAAEV,gBAAgB,EAAE,EAAEQ,IAAI,oBAAoB,EAAET,aAAaY,IAAI,CAAC,MAAM,CAAC,CAAC;AAEvF,EAAE;AAEF,OAAO,MAAMC,gBAAgB,CAACN,MAC5BD,kBAAkBC,SAAS,OAAO;AAEpC,OAAO,MAAMO,gBAAgB,CAACP,MAC5BD,kBAAkBC,SAAS,OAAO;AAEpC;;;;;;CAMC,GACD,OAAO,MAAMQ,iBAAiB,CAC5BC,UACAT,MAAcC,QAAQD,GAAG;IAEzB,MAAMH,QAAQG,GAAG,CAACS,SAAS;IAC3B,IAAIZ,UAAUM,aAAaN,UAAU,IAAI;QACvC,MAAM,IAAIO,MACR,GAAGV,gBAAgB,eAAe,EAAEe,SAAS,uCAAuC,EAAEA,SAAS,uBAAuB,CAAC;IAE3H;IACA,OAAOZ,MAAMa,OAAO,CAAC,QAAQ;AAC/B,EAAE"}

package/dist/service/define-service-e2e.d.ts

@@ -0,0 +1,54 @@
+import { type AxiosInstance } from 'axios';
+import { type E2eProfile } from '../profile/profile.js';
+/** A service booted for the run, whichever profile started it. */
+export interface RunningService {
+    readonly baseUrl: string;
+    close(): Promise<void>;
+}
+export interface ServiceE2eOptions {
+    /**
+     * The variable a `live` run reads its target from, e.g.
+     * `MARKETPLACE_ADMIN_SERVICE_URL`.
+     */
+    liveUrlEnvVar: string;
+    /**
+     * Boots the service in-process for a `mock` run. Supplied by the e2e project
+     * rather than by this package, because only the project knows its own
+     * `router` and which fakes stand in for its infrastructure — and because a
+     * package under `entifix` must not depend on a `shells` one.
+     */
+    startMock: () => Promise<RunningService>;
+    /**
+     * Default `Authorization` header for every request the suite makes, built
+     * once at start-up.
+     *
+     * A guarded service answers `401` to an anonymous request, which would turn
+     * every journey in the suite into an authentication test. Supplying a
+     * principal here keeps the specs about what they are actually asserting;
+     * the guard itself is covered by its own spec, which omits or corrupts the
+     * header on purpose.
+     */
+    authorization?: () => Promise<string>;
+}
+/**
+ * The handle a service e2e spec works through. `client` and `baseUrl` are only
+ * valid once the suite has started, so both are getters that fail loudly rather
+ * than handing out an empty string.
+ */
+export interface ServiceE2eContext {
+    readonly profile: E2eProfile;
+    readonly baseUrl: string;
+    readonly client: AxiosInstance;
+}
+/**
+ * Wires a service e2e suite to the active profile.
+ *
+ * In `mock` the service is booted in-process against driver fakes; in `live` it
+ * is the process already running on `liveUrlEnvVar`. Either way the spec gets
+ * the same axios client against the same routes, so ONE suite covers both — no
+ * `test.skip` on an env var, and no second copy of the journeys.
+ *
+ * Call it at the top level of a spec file; it registers the suite hooks itself.
+ */
+export declare const defineServiceE2e: ({ liveUrlEnvVar, startMock, authorization, }: ServiceE2eOptions) => ServiceE2eContext;
+//# sourceMappingURL=define-service-e2e.d.ts.map

package/dist/service/define-service-e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-service-e2e.d.ts","sourceRoot":"","sources":["../../src/service/define-service-e2e.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlD,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,uBAAuB,CAAC;AAE/B,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,8CAI9B,iBAAiB,KAAG,iBAoDtB,CAAC"}

package/dist/service/define-service-e2e.js

@@ -0,0 +1,57 @@
+import axios from 'axios';
+import { afterAll, beforeAll } from 'vitest';
+import { requireLiveUrl, resolveE2eProfile } from '../profile/profile.js';
+/**
+ * Wires a service e2e suite to the active profile.
+ *
+ * In `mock` the service is booted in-process against driver fakes; in `live` it
+ * is the process already running on `liveUrlEnvVar`. Either way the spec gets
+ * the same axios client against the same routes, so ONE suite covers both — no
+ * `test.skip` on an env var, and no second copy of the journeys.
+ *
+ * Call it at the top level of a spec file; it registers the suite hooks itself.
+ */ export const defineServiceE2e = ({ liveUrlEnvVar, startMock, authorization })=>{
+    const profile = resolveE2eProfile();
+    let running;
+    let client;
+    const started = ()=>{
+        if (running === undefined) {
+            throw new Error('The e2e service is not running yet — read `baseUrl`/`client` inside a test, not at module scope.');
+        }
+        return running;
+    };
+    beforeAll(async ()=>{
+        running = profile === 'mock' ? await startMock() : {
+            baseUrl: requireLiveUrl(liveUrlEnvVar),
+            // Nothing to tear down: the live process outlives the run.
+            close: ()=>Promise.resolve()
+        };
+        client = axios.create({
+            baseURL: running.baseUrl,
+            headers: authorization === undefined ? undefined : {
+                Authorization: await authorization()
+            },
+            // 4xx and 5xx are assertion subjects in these suites, not transport
+            // failures — a service e2e that cannot assert on a 400 is missing half
+            // its surface.
+            validateStatus: ()=>true
+        });
+    });
+    afterAll(async ()=>{
+        await (running == null ? void 0 : running.close());
+        running = undefined;
+        client = undefined;
+    });
+    return {
+        profile,
+        get baseUrl () {
+            return started().baseUrl;
+        },
+        get client () {
+            started();
+            return client;
+        }
+    };
+};
+
+//# sourceMappingURL=define-service-e2e.js.map

package/dist/service/define-service-e2e.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/service/define-service-e2e.ts"],"sourcesContent":["import axios, { type AxiosInstance } from 'axios';\nimport { afterAll, beforeAll } from 'vitest';\n\nimport {\n  type E2eProfile,\n  requireLiveUrl,\n  resolveE2eProfile,\n} from '../profile/profile.js';\n\n/** A service booted for the run, whichever profile started it. */\nexport interface RunningService {\n  readonly baseUrl: string;\n  close(): Promise<void>;\n}\n\nexport interface ServiceE2eOptions {\n  /**\n   * The variable a `live` run reads its target from, e.g.\n   * `MARKETPLACE_ADMIN_SERVICE_URL`.\n   */\n  liveUrlEnvVar: string;\n  /**\n   * Boots the service in-process for a `mock` run. Supplied by the e2e project\n   * rather than by this package, because only the project knows its own\n   * `router` and which fakes stand in for its infrastructure — and because a\n   * package under `entifix` must not depend on a `shells` one.\n   */\n  startMock: () => Promise<RunningService>;\n  /**\n   * Default `Authorization` header for every request the suite makes, built\n   * once at start-up.\n   *\n   * A guarded service answers `401` to an anonymous request, which would turn\n   * every journey in the suite into an authentication test. Supplying a\n   * principal here keeps the specs about what they are actually asserting;\n   * the guard itself is covered by its own spec, which omits or corrupts the\n   * header on purpose.\n   */\n  authorization?: () => Promise<string>;\n}\n\n/**\n * The handle a service e2e spec works through. `client` and `baseUrl` are only\n * valid once the suite has started, so both are getters that fail loudly rather\n * than handing out an empty string.\n */\nexport interface ServiceE2eContext {\n  readonly profile: E2eProfile;\n  readonly baseUrl: string;\n  readonly client: AxiosInstance;\n}\n\n/**\n * Wires a service e2e suite to the active profile.\n *\n * In `mock` the service is booted in-process against driver fakes; in `live` it\n * is the process already running on `liveUrlEnvVar`. Either way the spec gets\n * the same axios client against the same routes, so ONE suite covers both — no\n * `test.skip` on an env var, and no second copy of the journeys.\n *\n * Call it at the top level of a spec file; it registers the suite hooks itself.\n */\nexport const defineServiceE2e = ({\n  liveUrlEnvVar,\n  startMock,\n  authorization,\n}: ServiceE2eOptions): ServiceE2eContext => {\n  const profile = resolveE2eProfile();\n  let running: RunningService | undefined;\n  let client: AxiosInstance | undefined;\n\n  const started = (): RunningService => {\n    if (running === undefined) {\n      throw new Error(\n        'The e2e service is not running yet — read `baseUrl`/`client` inside a test, not at module scope.',\n      );\n    }\n    return running;\n  };\n\n  beforeAll(async () => {\n    running =\n      profile === 'mock'\n        ? await startMock()\n        : {\n            baseUrl: requireLiveUrl(liveUrlEnvVar),\n            // Nothing to tear down: the live process outlives the run.\n            close: () => Promise.resolve(),\n          };\n    client = axios.create({\n      baseURL: running.baseUrl,\n      headers:\n        authorization === undefined\n          ? undefined\n          : { Authorization: await authorization() },\n      // 4xx and 5xx are assertion subjects in these suites, not transport\n      // failures — a service e2e that cannot assert on a 400 is missing half\n      // its surface.\n      validateStatus: () => true,\n    });\n  });\n\n  afterAll(async () => {\n    await running?.close();\n    running = undefined;\n    client = undefined;\n  });\n\n  return {\n    profile,\n    get baseUrl() {\n      return started().baseUrl;\n    },\n    get client() {\n      started();\n      return client as AxiosInstance;\n    },\n  };\n};\n"],"names":["axios","afterAll","beforeAll","requireLiveUrl","resolveE2eProfile","defineServiceE2e","liveUrlEnvVar","startMock","authorization","profile","running","client","started","undefined","Error","baseUrl","close","Promise","resolve","create","baseURL","headers","Authorization","validateStatus"],"mappings":"AAAA,OAAOA,WAAmC,QAAQ;AAClD,SAASC,QAAQ,EAAEC,SAAS,QAAQ,SAAS;AAE7C,SAEEC,cAAc,EACdC,iBAAiB,QACZ,wBAAwB;AA6C/B;;;;;;;;;CASC,GACD,OAAO,MAAMC,mBAAmB,CAAC,EAC/BC,aAAa,EACbC,SAAS,EACTC,aAAa,EACK;IAClB,MAAMC,UAAUL;IAChB,IAAIM;IACJ,IAAIC;IAEJ,MAAMC,UAAU;QACd,IAAIF,YAAYG,WAAW;YACzB,MAAM,IAAIC,MACR;QAEJ;QACA,OAAOJ;IACT;IAEAR,UAAU;QACRQ,UACED,YAAY,SACR,MAAMF,cACN;YACEQ,SAASZ,eAAeG;YACxB,2DAA2D;YAC3DU,OAAO,IAAMC,QAAQC,OAAO;QAC9B;QACNP,SAASX,MAAMmB,MAAM,CAAC;YACpBC,SAASV,QAAQK,OAAO;YACxBM,SACEb,kBAAkBK,YACdA,YACA;gBAAES,eAAe,MAAMd;YAAgB;YAC7C,oEAAoE;YACpE,uEAAuE;YACvE,eAAe;YACfe,gBAAgB,IAAM;QACxB;IACF;IAEAtB,SAAS;QACP,OAAMS,2BAAAA,QAASM,KAAK;QACpBN,UAAUG;QACVF,SAASE;IACX;IAEA,OAAO;QACLJ;QACA,IAAIM,WAAU;YACZ,OAAOH,UAAUG,OAAO;QAC1B;QACA,IAAIJ,UAAS;YACXC;YACA,OAAOD;QACT;IACF;AACF,EAAE"}

package/dist/service/index.d.ts

@@ -0,0 +1,2 @@
+export * from './define-service-e2e.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/service/index.js

@@ -0,0 +1,3 @@
+export * from './define-service-e2e.js';
+
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/service/index.ts"],"sourcesContent":["export * from './define-service-e2e.js';\n"],"names":[],"mappings":"AAAA,cAAc,0BAA0B"}

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "@entifix/testing-e2e",
+  "version": "0.1.0-0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/r10c-technologies/entifix.git",
+    "directory": "packages/ts/testing-e2e"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@entifix/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./fixtures": {
+      "@entifix/source": "./src/fixtures/index.ts",
+      "types": "./dist/fixtures/index.d.ts",
+      "import": "./dist/fixtures/index.js",
+      "default": "./dist/fixtures/index.js"
+    },
+    "./service": {
+      "@entifix/source": "./src/service/index.ts",
+      "types": "./dist/service/index.d.ts",
+      "import": "./dist/service/index.js",
+      "default": "./dist/service/index.js"
+    },
+    "./playwright": {
+      "@entifix/source": "./src/playwright/index.ts",
+      "types": "./dist/playwright/index.d.ts",
+      "import": "./dist/playwright/index.js",
+      "default": "./dist/playwright/index.js"
+    }
+  },
+  "nx": {
+    "tags": [
+      "layer:entifix",
+      "scope:shared",
+      "type:testing",
+      "tier:5"
+    ],
+    "sourceRoot": "packages/ts/testing-e2e/src",
+    "targets": {
+      "build": {
+        "executor": "@nx/js:swc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/ts/testing-e2e/dist",
+          "main": "packages/ts/testing-e2e/src/index.ts",
+          "tsConfig": "packages/ts/testing-e2e/tsconfig.lib.json",
+          "skipTypeCheck": true,
+          "stripLeadingPaths": true
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@swc/helpers": "0.5.23",
+    "@entifix/business": "0.1.0-0",
+    "@entifix/testing-unit": "0.1.0-0",
+    "@entifix/core": "0.1.0-0"
+  },
+  "peerDependencies": {
+    "@nx/devkit": ">=23 <24",
+    "@nx/playwright": ">=23 <24",
+    "@playwright/test": "*",
+    "axios": "*",
+    "effect": ">=3.22 <4",
+    "msw": "*",
+    "vitest": "*",
+    "@entifix/amqp": "0.1.0-0",
+    "@entifix/redis": "0.1.0-0",
+    "@entifix/mongo": "0.1.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@msw/playwright": {
+      "optional": true
+    },
+    "@nx/devkit": {
+      "optional": true
+    },
+    "@nx/playwright": {
+      "optional": true
+    },
+    "@playwright/test": {
+      "optional": true
+    },
+    "@entifix/amqp": {
+      "optional": true
+    },
+    "@entifix/mongo": {
+      "optional": true
+    },
+    "@entifix/redis": {
+      "optional": true
+    },
+    "axios": {
+      "optional": true
+    },
+    "msw": {
+      "optional": true
+    },
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@nx/devkit": "23.0.1",
+    "@nx/playwright": "23.0.1",
+    "effect": "3.22.1",
+    "@entifix/amqp": "0.1.0-0",
+    "@entifix/mongo": "0.1.0-0",
+    "@entifix/redis": "0.1.0-0"
+  }
+}