@12-apps/discounts 1.11.0 → 1.12.0

package/dist/e2e/globs.d.ts

@@ -0,0 +1,40 @@
+/** Every packaged `.feature`, for `defineBddConfig({ features })`. */
+export declare const discountsFeatures: string;
+/**
+ * The base `defineBddConfig({ featuresRoot })` must be given, and it is NOT
+ * optional decoration.
+ *
+ * bddgen mirrors each feature's path RELATIVE TO `featuresRoot` under
+ * `outputDir`. Left unset it defaults to the config's own directory, so a
+ * feature living under `node_modules/...` compiles to a path Playwright then
+ * IGNORES, because its default `testIgnore` excludes `**\/node_modules/**`.
+ *
+ * The result is the worst kind of green: bddgen reports the features compiled,
+ * Playwright collects zero specs from them, and the run passes with the whole
+ * packaged suite silently absent.
+ *
+ * A host running SEVERAL packaged suites gives `featuresRoot` the directory they
+ * all sit under, since bddgen takes exactly one — and that is safe to do,
+ * because a feature outside it is a hard exit from bddgen, never a quiet
+ * omission.
+ */
+export declare const discountsFeaturesRoot: string;
+/**
+ * Every packaged step definition, for `defineBddConfig({ steps })`.
+ *
+ * COMPILED JavaScript, and that is the reason this package has a build step at
+ * all while everything else it exports is raw `.ts` through the `exports` map.
+ * Those entries are consumed by an application's BUNDLER, which transpiles
+ * whatever it is pointed at. These are loaded by NODE — `playwright.config.ts`
+ * imports this module, and bddgen imports the step files — and Node refuses to
+ * strip types from anything under `node_modules`
+ * (`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`). Playwright's own TS transform
+ * does not rescue them either; it skips `node_modules` by design.
+ *
+ * The host's own steps glob must ALSO be listed — that is where its
+ * `defineDiscountsWorld` call lives, and playwright-bdd imports every step
+ * file before any scenario runs, which is what makes the registration land in
+ * time in every worker.
+ */
+export declare const discountsSteps: string;
+//# sourceMappingURL=globs.d.ts.map

package/dist/e2e/globs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globs.d.ts","sourceRoot":"","sources":["../../src/e2e/globs.ts"],"names":[],"mappings":"AA6BA,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,MAAqD,CAAC;AAEtF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAwC,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EAAE,MAAsD,CAAC"}

package/dist/e2e/globs.js

@@ -0,0 +1,66 @@
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+/**
+ * Where this package's journeys and their steps live, ON DISK, in the consumer's
+ * `node_modules`.
+ *
+ * `defineBddConfig` takes filesystem globs, not module specifiers — it hands
+ * them to a glob matcher, so `'@12-apps/discounts/features/**'` matches
+ * nothing and, worse, matches nothing SILENTLY: bddgen compiles the features it
+ * found, finds none, and the run is green with zero journeys.
+ *
+ * So the paths are RESOLVED here instead of written down by every consumer. A
+ * host that hard-codes `node_modules/@12-apps/discounts/...` is broken by
+ * pnpm's nested store, by a workspace link, and by this package's own layout
+ * changing; resolving from the package's own entry point is correct under all
+ * three.
+ */
+const require_ = createRequire(import.meta.url);
+/**
+ * The package root, found from a file this package definitely exports.
+ * `./package.json` is exported precisely so this lookup needs no guess about
+ * directory depth.
+ */
+function packageRoot() {
+    return dirname(require_.resolve('@12-apps/discounts/package.json'));
+}
+/** Every packaged `.feature`, for `defineBddConfig({ features })`. */
+export const discountsFeatures = join(packageRoot(), 'features/**/*.feature');
+/**
+ * The base `defineBddConfig({ featuresRoot })` must be given, and it is NOT
+ * optional decoration.
+ *
+ * bddgen mirrors each feature's path RELATIVE TO `featuresRoot` under
+ * `outputDir`. Left unset it defaults to the config's own directory, so a
+ * feature living under `node_modules/...` compiles to a path Playwright then
+ * IGNORES, because its default `testIgnore` excludes `**\/node_modules/**`.
+ *
+ * The result is the worst kind of green: bddgen reports the features compiled,
+ * Playwright collects zero specs from them, and the run passes with the whole
+ * packaged suite silently absent.
+ *
+ * A host running SEVERAL packaged suites gives `featuresRoot` the directory they
+ * all sit under, since bddgen takes exactly one — and that is safe to do,
+ * because a feature outside it is a hard exit from bddgen, never a quiet
+ * omission.
+ */
+export const discountsFeaturesRoot = join(packageRoot(), 'features');
+/**
+ * Every packaged step definition, for `defineBddConfig({ steps })`.
+ *
+ * COMPILED JavaScript, and that is the reason this package has a build step at
+ * all while everything else it exports is raw `.ts` through the `exports` map.
+ * Those entries are consumed by an application's BUNDLER, which transpiles
+ * whatever it is pointed at. These are loaded by NODE — `playwright.config.ts`
+ * imports this module, and bddgen imports the step files — and Node refuses to
+ * strip types from anything under `node_modules`
+ * (`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`). Playwright's own TS transform
+ * does not rescue them either; it skips `node_modules` by design.
+ *
+ * The host's own steps glob must ALSO be listed — that is where its
+ * `defineDiscountsWorld` call lives, and playwright-bdd imports every step
+ * file before any scenario runs, which is what makes the registration land in
+ * time in every worker.
+ */
+export const discountsSteps = join(packageRoot(), 'dist/e2e/steps/**/*.js');
+//# sourceMappingURL=globs.js.map

package/dist/e2e/globs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globs.js","sourceRoot":"","sources":["../../src/e2e/globs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD;;;;GAIG;AACH,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAW,IAAI,CAAC,WAAW,EAAE,EAAE,uBAAuB,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAW,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,IAAI,CAAC,WAAW,EAAE,EAAE,wBAAwB,CAAC,CAAC"}

package/dist/e2e/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@12-apps/discounts/e2e` — the packaged promotions journeys and the port a
+ * host implements to run them.
+ *
+ * The `e2e` capability the manifest declares. A host adds the three globs to
+ * its bdd config and calls `defineDiscountsWorld` from inside its own steps
+ * glob; every scenario this package ships then runs in that host, including the
+ * ones added after it integrated. Nothing is copied, so nothing can rot.
+ */
+export { discountsFeatures, discountsFeaturesRoot, discountsSteps } from './globs.js';
+export { defineDiscountsWorld, discountsWorld, type DiscountsFixtures, type DiscountsWorld, } from './world.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/e2e/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/e2e/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@12-apps/discounts/e2e` — the packaged promotions journeys and the port a
+ * host implements to run them.
+ *
+ * The `e2e` capability the manifest declares. A host adds the three globs to
+ * its bdd config and calls `defineDiscountsWorld` from inside its own steps
+ * glob; every scenario this package ships then runs in that host, including the
+ * ones added after it integrated. Nothing is copied, so nothing can rot.
+ */
+export { discountsFeatures, discountsFeaturesRoot, discountsSteps } from './globs.js';
+export { defineDiscountsWorld, discountsWorld, } from './world.js';
+//# sourceMappingURL=index.js.map

package/dist/e2e/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/e2e/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,cAAc,GAGf,MAAM,YAAY,CAAC"}

package/dist/e2e/steps/journey.steps.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=journey.steps.d.ts.map

package/dist/e2e/steps/journey.steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.steps.d.ts","sourceRoot":"","sources":["../../../src/e2e/steps/journey.steps.ts"],"names":[],"mappings":""}

package/dist/e2e/steps/journey.steps.js

@@ -0,0 +1,146 @@
+import { expect } from '@playwright/test';
+import { createBdd } from 'playwright-bdd';
+import { discountsWorld } from '../world.js';
+/**
+ * The packaged journeys' step definitions.
+ *
+ * Every locator is a test id THIS package's own components render, which is
+ * what makes the scenarios portable: `discounts-grid`, `discount-dialog`,
+ * `discount-action-edit`, `combo-slots` and the `total-form-field-*` family
+ * mean the same thing in any app that mounts `createWebDiscounts`. Everything a
+ * host owns — sign-in, routing, how a percentage reads — arrives through the
+ * world port rather than being written down here.
+ *
+ * ## Why `package.json` declares this file under `sideEffects`
+ *
+ * Every Given/When/Then below runs at IMPORT time — registering a step is the
+ * whole point of the module, and it exports nothing anybody imports by name. To
+ * a bundler doing tree-shaking that reads as dead weight, and dropping it is
+ * licensed: the result is a suite where bddgen reports the features compiled
+ * and every scenario then fails on an undefined step.
+ *
+ * Not one step asserts a SENTENCE. The origin host's spec did — it clicked
+ * `menuitem { name: 'Editar' }` and a `Salvar alterações` button — which is why
+ * it could only ever have run in that host: copy is required config, so the next
+ * adopter's words are different by construction and the spec would fail for a
+ * reason unrelated to promotions working.
+ */
+const { Given, When, Then } = createBdd();
+const GRID = 'discounts-grid';
+const DIALOG = 'discount-dialog';
+/** The name the current scenario minted, so later steps can find its row. */
+let currentName = '';
+Given('I am signed in as somebody who may manage promotions', async ({ page }) => {
+    await discountsWorld().signInAsManager(page);
+});
+When('I open the promotions screen', async ({ page }) => {
+    await discountsWorld().openDiscountsScreen(page);
+    await expect(page.getByTestId(GRID)).toBeVisible();
+});
+Then('the promotions grid is visible', async ({ page }) => {
+    await expect(page.getByTestId(GRID)).toBeVisible();
+});
+/** The create dialog, open and ready to be filled. */
+async function openCreateDialog(page) {
+    await page.getByTestId('new-discount-button').click();
+    const dialog = page.getByTestId(DIALOG);
+    await expect(dialog).toBeVisible();
+    return dialog;
+}
+When('I compose a percentage promotion', async ({ page }) => {
+    const { newName, percent } = discountsWorld().fixtures;
+    currentName = newName('Journey');
+    const dialog = await openCreateDialog(page);
+    await dialog.getByTestId('total-form-field-name').fill(currentName);
+    // Percentage is the default kind; clicking it anyway is the interaction that
+    // proves the toggle drives which value field is mounted.
+    await dialog.getByTestId('total-form-field-kind-item-PERCENTAGE').click();
+    await dialog.getByTestId('total-form-field-percentOff').fill(percent);
+    await dialog.getByTestId('discount-form-submit').click();
+    await expect(dialog).toBeHidden();
+});
+/**
+ * The row is found by NAME, and a name is the one user-visible string here that
+ * is not copy — the scenario chose it a moment ago, so naming it is naming a
+ * fixture rather than an adopter's wording.
+ */
+function rowFor(page, name) {
+    return page.getByTestId(GRID).getByRole('row', { name: new RegExp(name) });
+}
+Then('the promotion is listed with its rate', async ({ page }) => {
+    const row = rowFor(page, currentName);
+    await expect(row).toBeVisible();
+    // The round trip is the claim: a rate typed as a percentage comes back as one
+    // only if the conversion into basis points and back out BOTH ran. How it
+    // reads is the host's formatting, so the host states it.
+    await expect(row.getByText(discountsWorld().fixtures.percentInGrid)).toBeVisible();
+});
+When('I start composing a promotion', async ({ page }) => {
+    await openCreateDialog(page);
+});
+Then('the percentage field is the one on screen', async ({ page }) => {
+    await expect(page.getByTestId(DIALOG).getByTestId('total-form-field-percentOff')).toBeVisible();
+});
+When('I switch it to a fixed amount', async ({ page }) => {
+    await page.getByTestId(DIALOG).getByTestId('total-form-field-kind-item-FIXED_AMOUNT').click();
+});
+Then('the amount field REPLACES the percentage one', async ({ page }) => {
+    const dialog = page.getByTestId(DIALOG);
+    await expect(dialog.getByTestId('total-form-field-amountOff')).toBeVisible();
+    // Replaced, not hidden: a merely-hidden percentage input would still submit a
+    // stale rate alongside an amount the operator typed.
+    await expect(dialog.getByTestId('total-form-field-percentOff')).toHaveCount(0);
+});
+When('I switch it to a combo', async ({ page }) => {
+    await page.getByTestId(DIALOG).getByTestId('total-form-field-kind-item-COMBO').click();
+});
+Then('the scope question disappears and the group builder takes its place', async ({ page }) => {
+    const dialog = page.getByTestId(DIALOG);
+    // A combo COVERS the groups it is made of, so scope stops being a question at
+    // all — unmounted rather than disabled. That is what stops an operator
+    // building a combination the write path then refuses.
+    await expect(dialog.getByTestId('total-form-field-scope-item-ORDER')).toHaveCount(0);
+    await expect(dialog.getByTestId('combo-slots')).toBeVisible();
+});
+Then('the scope question comes back for a plain kind', async ({ page }) => {
+    const dialog = page.getByTestId(DIALOG);
+    await dialog.getByTestId('total-form-field-kind-item-FIXED_AMOUNT').click();
+    await expect(dialog.getByTestId('total-form-field-scope-item-ORDER')).toBeVisible();
+});
+When('I set the activation to a coupon code', async ({ page }) => {
+    await page.getByTestId(DIALOG).getByTestId('total-form-field-trigger-item-CODE').click();
+});
+Then('the coupon field is revealed', async ({ page }) => {
+    await expect(page.getByTestId(DIALOG).getByTestId('total-form-field-code')).toBeVisible();
+});
+/** Open the row's kebab and take one of its entries by its STABLE id. */
+async function chooseRowAction(page, action) {
+    await rowFor(page, currentName).locator('[data-testid^="discount-actions-"]').click();
+    await page.getByTestId(`discount-action-${action}`).click();
+}
+When('I rename it from the row menu', async ({ page }) => {
+    await chooseRowAction(page, 'edit');
+    const dialog = page.getByTestId(DIALOG);
+    await expect(dialog).toBeVisible();
+    currentName = `${currentName} II`;
+    await dialog.getByTestId('total-form-field-name').fill(currentName);
+    await dialog.getByTestId('discount-form-submit').click();
+    await expect(dialog).toBeHidden();
+});
+Then('the grid shows the new name', async ({ page }) => {
+    // The grid re-read the server — proof the write landed, rather than proof the
+    // dialog closed.
+    await expect(rowFor(page, currentName)).toBeVisible();
+});
+When('I delete it from the row menu', async ({ page }) => {
+    await chooseRowAction(page, 'delete');
+    // The menu entry only OPENS the confirmation; the DELETE leaves when it is
+    // confirmed.
+    await page.getByTestId('discount-delete-confirm-confirm-button').click();
+});
+Then('the promotion is gone from the grid', async ({ page }) => {
+    // A soft delete: the row leaves the list even though the record survives for
+    // its redemption history.
+    await expect(rowFor(page, currentName)).toHaveCount(0);
+});
+//# sourceMappingURL=journey.steps.js.map

package/dist/e2e/steps/journey.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.steps.js","sourceRoot":"","sources":["../../../src/e2e/steps/journey.steps.ts"],"names":[],"mappings":"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"}

package/dist/e2e/world.d.ts

@@ -0,0 +1,76 @@
+import type { Page } from '@playwright/test';
+/**
+ * The port a HOST implements to run the packaged promotions journeys.
+ *
+ * The journeys are portable because every assertion in them reads a test id
+ * this package's own components render — `discounts-grid`, `discount-dialog`,
+ * `discount-action-edit`, `total-form-field-*` mean the same thing in any app
+ * that mounts `createWebDiscounts`. What is NOT portable is everything around
+ * them: how an app signs somebody in, how it routes to the promotions screen,
+ * how it returns to a known state, and how it renders a percentage.
+ *
+ * It replaces a 167-line spec in the origin host (`discounts.e2e.ts`), which
+ * asserted this package's test ids from a repo it does not build — the
+ * arrangement whose failure mode is silent from here: rename an id inside the
+ * package and a spec it cannot see goes red somewhere it does not run.
+ */
+/**
+ * Facts about the host that the assertions have to name.
+ *
+ * A journey has to talk about SOMETHING: a permission to tick, a name to type,
+ * a rendered value to look for. None of that can live in a feature file without
+ * inventing one host's fixture as though it were everybody's.
+ */
+export interface DiscountsFixtures {
+    /**
+     * A name no seed uses, minted FRESH per call.
+     *
+     * A function rather than a string because these journeys WRITE: the
+     * promotions table carries a per-tenant unique index on the name, so a
+     * constant would collide with itself on the second scenario and on every
+     * re-run against the same database.
+     */
+    newName: (prefix: string) => string;
+    /** The percentage a create journey types, as the form takes it (e.g. `15`). */
+    percent: string;
+    /**
+     * How that percentage READS in the grid once saved (e.g. `15%`).
+     *
+     * Stated by the host because formatting is the host's: `createWebDiscounts`
+     * takes a locale and a currency, so the same 15 renders differently in two
+     * adopters. It is the round-trip that matters — a value typed as a percentage
+     * comes back as one only if the conversion into basis points and back out
+     * both ran — and this is the half a package cannot spell.
+     */
+    percentInGrid: string;
+}
+/** What a host must be able to do for these journeys to run in it. */
+export interface DiscountsWorld {
+    /**
+     * Put the browser in a known signed-in state as somebody who may manage
+     * promotions, and return the store to a known one.
+     *
+     * These journeys write, so the reset is load-bearing rather than hygiene: a
+     * scenario that renamed a promotion would otherwise hand the next one a
+     * catalog it did not expect.
+     */
+    signInAsManager(page: Page): Promise<void>;
+    /** Land on the promotions screen and wait until its grid has rendered. */
+    openDiscountsScreen(page: Page): Promise<void>;
+    fixtures: DiscountsFixtures;
+}
+/**
+ * Install the host's implementation. Call this from a module inside the host's
+ * OWN steps glob — playwright-bdd imports every step file before any scenario
+ * runs, so a top-level call there is registered in time, in every worker.
+ */
+export declare function defineDiscountsWorld(world: DiscountsWorld): void;
+/**
+ * The installed world, or a refusal naming the fix.
+ *
+ * Throws rather than returning null: a step that ran against an absent world
+ * would fail on whatever it touched next, somewhere unrelated to the actual
+ * mistake, which is a diagnosis nobody should have to make twice.
+ */
+export declare function discountsWorld(): DiscountsWorld;
+//# sourceMappingURL=world.d.ts.map

package/dist/e2e/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/e2e/world.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAS/C"}

package/dist/e2e/world.js

@@ -0,0 +1,25 @@
+let installed = null;
+/**
+ * Install the host's implementation. Call this from a module inside the host's
+ * OWN steps glob — playwright-bdd imports every step file before any scenario
+ * runs, so a top-level call there is registered in time, in every worker.
+ */
+export function defineDiscountsWorld(world) {
+    installed = world;
+}
+/**
+ * The installed world, or a refusal naming the fix.
+ *
+ * Throws rather than returning null: a step that ran against an absent world
+ * would fail on whatever it touched next, somewhere unrelated to the actual
+ * mistake, which is a diagnosis nobody should have to make twice.
+ */
+export function discountsWorld() {
+    if (!installed) {
+        throw new Error('No discounts e2e world is installed. Call defineDiscountsWorld({ … }) from a module ' +
+            "inside your own `steps` glob — playwright-bdd imports those before any " +
+            'scenario runs, which is what makes the registration land in every worker.');
+    }
+    return installed;
+}
+//# sourceMappingURL=world.js.map

package/dist/e2e/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../../src/e2e/world.ts"],"names":[],"mappings":"AAiEA,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,sFAAsF;YACpF,yEAAyE;YACzE,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/features/promotions.feature

@@ -0,0 +1,52 @@
+# The promotions admin's journeys, portable to any host that mounts
+# `createWebDiscounts`.
+#
+# Every assertion reads a test id THIS package renders. Nothing here names a
+# sentence: the origin host's spec clicked `Editar` and `Salvar alterações`,
+# which is its pt-BR and would fail in the next adopter for a reason that has
+# nothing to do with promotions working. What a scenario needs to NAME — a
+# fresh promotion name, a rate, how that rate reads once saved — comes from the
+# host's fixtures.
+Feature: Promotions
+
+  Background:
+    Given I am signed in as somebody who may manage promotions
+
+  Scenario: The promotions grid renders
+    When I open the promotions screen
+    Then the promotions grid is visible
+
+  Scenario: A manager composes a percentage promotion and finds it in the grid
+    # The round trip is the claim: a rate typed as a percentage comes back as
+    # one only if the conversion into basis points AND back out both ran.
+    When I open the promotions screen
+    And I compose a percentage promotion
+    Then the promotion is listed with its rate
+
+  Scenario: The value field follows the kind, and scope disappears for a combo
+    # Three rules in one dialog, all of them about the form refusing to let an
+    # operator build something the write path would reject.
+    When I open the promotions screen
+    And I start composing a promotion
+    Then the percentage field is the one on screen
+    When I switch it to a fixed amount
+    Then the amount field REPLACES the percentage one
+    When I switch it to a combo
+    Then the scope question disappears and the group builder takes its place
+    And the scope question comes back for a plain kind
+    When I set the activation to a coupon code
+    Then the coupon field is revealed
+
+  Scenario: A manager renames a promotion from its row menu
+    When I open the promotions screen
+    And I compose a percentage promotion
+    And I rename it from the row menu
+    Then the grid shows the new name
+
+  Scenario: A manager deletes a promotion from its row menu
+    # Confirm-gated, and a SOFT delete — the row leaves the list while the
+    # record survives for its redemption history.
+    When I open the promotions screen
+    And I compose a percentage promotion
+    And I delete it from the row menu
+    Then the promotion is gone from the grid

package/package.json

@@ -1,8 +1,10 @@
 {
   "name": "@12-apps/discounts",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "**/e2e/**"
+  ],
   "description": "The discount/promotion domain: a host-agnostic evaluator (percentage or fixed amount, order/category/item scope, automatic or coupon-triggered, stacking and exclusivity, integer-cent allocation) plus the admin CRUD surface as wiring-contract route descriptors over a store port. No database, no framework, no baked user copy.",
   "exports": {
     ".": "./src/index.ts",
@@ -18,9 +20,14 @@
     "./server/en-US": "./src/server/en-US.ts",
     "./react/en-US": "./src/react/en-US.ts",
     "./locales": "./src/locales.ts",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./e2e": {
+      "types": "./dist/e2e/index.d.ts",
+      "default": "./dist/e2e/index.js"
+    }
   },
   "scripts": {
+    "build": "tsc -p tsconfig.e2e.json",
     "check-types": "tsc --noEmit",
     "clean": "rm -rf node_modules coverage dist",
     "dev": "storybook dev -p 6009",
@@ -44,7 +51,9 @@
     "@12-apps/wiring": ">=1.3.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
-    "react-router-dom": ">=7.0.0"
+    "react-router-dom": ">=7.0.0",
+    "@playwright/test": ">=1.55.0",
+    "playwright-bdd": ">=8.3.0"
   },
   "peerDependenciesMeta": {
     "@12-apps/wiring": {
@@ -58,6 +67,12 @@
     },
     "react-router-dom": {
       "optional": true
+    },
+    "@playwright/test": {
+      "optional": true
+    },
+    "playwright-bdd": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -69,6 +84,7 @@
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.0",
     "@mui/material": "^6.5.0",
+    "@playwright/test": "^1.61.1",
     "@storybook/addon-docs": "^9.1.10",
     "@storybook/addon-links": "^9.1.10",
     "@storybook/react-vite": "^9.1.10",
@@ -80,6 +96,7 @@
     "eslint-plugin-storybook": "9.1.10",
     "eslint-plugin-test-flakiness": "^1.4.0",
     "jsdom": "^25.0.1",
+    "playwright-bdd": "^9.2.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-router-dom": "^7.0.0",
@@ -117,7 +134,8 @@
     "!**/*.stories.*",
     "!**/*.test-story.*",
     "!**/test-helpers.*",
-    "!**/__stories__/**"
+    "!**/__stories__/**",
+    "features"
   ],
   "wiring": {
     "db": {

package/src/e2e/globs.ts

@@ -0,0 +1,70 @@
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+/**
+ * Where this package's journeys and their steps live, ON DISK, in the consumer's
+ * `node_modules`.
+ *
+ * `defineBddConfig` takes filesystem globs, not module specifiers — it hands
+ * them to a glob matcher, so `'@12-apps/discounts/features/**'` matches
+ * nothing and, worse, matches nothing SILENTLY: bddgen compiles the features it
+ * found, finds none, and the run is green with zero journeys.
+ *
+ * So the paths are RESOLVED here instead of written down by every consumer. A
+ * host that hard-codes `node_modules/@12-apps/discounts/...` is broken by
+ * pnpm's nested store, by a workspace link, and by this package's own layout
+ * changing; resolving from the package's own entry point is correct under all
+ * three.
+ */
+const require_ = createRequire(import.meta.url);
+
+/**
+ * The package root, found from a file this package definitely exports.
+ * `./package.json` is exported precisely so this lookup needs no guess about
+ * directory depth.
+ */
+function packageRoot(): string {
+  return dirname(require_.resolve('@12-apps/discounts/package.json'));
+}
+
+/** Every packaged `.feature`, for `defineBddConfig({ features })`. */
+export const discountsFeatures: string = join(packageRoot(), 'features/**/*.feature');
+
+/**
+ * The base `defineBddConfig({ featuresRoot })` must be given, and it is NOT
+ * optional decoration.
+ *
+ * bddgen mirrors each feature's path RELATIVE TO `featuresRoot` under
+ * `outputDir`. Left unset it defaults to the config's own directory, so a
+ * feature living under `node_modules/...` compiles to a path Playwright then
+ * IGNORES, because its default `testIgnore` excludes `**\/node_modules/**`.
+ *
+ * The result is the worst kind of green: bddgen reports the features compiled,
+ * Playwright collects zero specs from them, and the run passes with the whole
+ * packaged suite silently absent.
+ *
+ * A host running SEVERAL packaged suites gives `featuresRoot` the directory they
+ * all sit under, since bddgen takes exactly one — and that is safe to do,
+ * because a feature outside it is a hard exit from bddgen, never a quiet
+ * omission.
+ */
+export const discountsFeaturesRoot: string = join(packageRoot(), 'features');
+
+/**
+ * Every packaged step definition, for `defineBddConfig({ steps })`.
+ *
+ * COMPILED JavaScript, and that is the reason this package has a build step at
+ * all while everything else it exports is raw `.ts` through the `exports` map.
+ * Those entries are consumed by an application's BUNDLER, which transpiles
+ * whatever it is pointed at. These are loaded by NODE — `playwright.config.ts`
+ * imports this module, and bddgen imports the step files — and Node refuses to
+ * strip types from anything under `node_modules`
+ * (`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`). Playwright's own TS transform
+ * does not rescue them either; it skips `node_modules` by design.
+ *
+ * The host's own steps glob must ALSO be listed — that is where its
+ * `defineDiscountsWorld` call lives, and playwright-bdd imports every step
+ * file before any scenario runs, which is what makes the registration land in
+ * time in every worker.
+ */
+export const discountsSteps: string = join(packageRoot(), 'dist/e2e/steps/**/*.js');

package/src/e2e/index.ts

@@ -0,0 +1,16 @@
+/**
+ * `@12-apps/discounts/e2e` — the packaged promotions journeys and the port a
+ * host implements to run them.
+ *
+ * The `e2e` capability the manifest declares. A host adds the three globs to
+ * its bdd config and calls `defineDiscountsWorld` from inside its own steps
+ * glob; every scenario this package ships then runs in that host, including the
+ * ones added after it integrated. Nothing is copied, so nothing can rot.
+ */
+export { discountsFeatures, discountsFeaturesRoot, discountsSteps } from './globs.js';
+export {
+  defineDiscountsWorld,
+  discountsWorld,
+  type DiscountsFixtures,
+  type DiscountsWorld,
+} from './world.js';

package/src/e2e/steps/journey.steps.ts

@@ -0,0 +1,170 @@
+import { expect, type Locator, type Page } from '@playwright/test';
+import { createBdd } from 'playwright-bdd';
+
+import { discountsWorld } from '../world.js';
+
+/**
+ * The packaged journeys' step definitions.
+ *
+ * Every locator is a test id THIS package's own components render, which is
+ * what makes the scenarios portable: `discounts-grid`, `discount-dialog`,
+ * `discount-action-edit`, `combo-slots` and the `total-form-field-*` family
+ * mean the same thing in any app that mounts `createWebDiscounts`. Everything a
+ * host owns — sign-in, routing, how a percentage reads — arrives through the
+ * world port rather than being written down here.
+ *
+ * ## Why `package.json` declares this file under `sideEffects`
+ *
+ * Every Given/When/Then below runs at IMPORT time — registering a step is the
+ * whole point of the module, and it exports nothing anybody imports by name. To
+ * a bundler doing tree-shaking that reads as dead weight, and dropping it is
+ * licensed: the result is a suite where bddgen reports the features compiled
+ * and every scenario then fails on an undefined step.
+ *
+ * Not one step asserts a SENTENCE. The origin host's spec did — it clicked
+ * `menuitem { name: 'Editar' }` and a `Salvar alterações` button — which is why
+ * it could only ever have run in that host: copy is required config, so the next
+ * adopter's words are different by construction and the spec would fail for a
+ * reason unrelated to promotions working.
+ */
+const { Given, When, Then } = createBdd();
+
+const GRID = 'discounts-grid';
+const DIALOG = 'discount-dialog';
+
+/** The name the current scenario minted, so later steps can find its row. */
+let currentName = '';
+
+Given('I am signed in as somebody who may manage promotions', async ({ page }) => {
+  await discountsWorld().signInAsManager(page);
+});
+
+When('I open the promotions screen', async ({ page }) => {
+  await discountsWorld().openDiscountsScreen(page);
+  await expect(page.getByTestId(GRID)).toBeVisible();
+});
+
+Then('the promotions grid is visible', async ({ page }) => {
+  await expect(page.getByTestId(GRID)).toBeVisible();
+});
+
+/** The create dialog, open and ready to be filled. */
+async function openCreateDialog(page: Page): Promise<Locator> {
+  await page.getByTestId('new-discount-button').click();
+  const dialog = page.getByTestId(DIALOG);
+  await expect(dialog).toBeVisible();
+  return dialog;
+}
+
+When('I compose a percentage promotion', async ({ page }) => {
+  const { newName, percent } = discountsWorld().fixtures;
+  currentName = newName('Journey');
+  const dialog = await openCreateDialog(page);
+  await dialog.getByTestId('total-form-field-name').fill(currentName);
+  // Percentage is the default kind; clicking it anyway is the interaction that
+  // proves the toggle drives which value field is mounted.
+  await dialog.getByTestId('total-form-field-kind-item-PERCENTAGE').click();
+  await dialog.getByTestId('total-form-field-percentOff').fill(percent);
+  await dialog.getByTestId('discount-form-submit').click();
+  await expect(dialog).toBeHidden();
+});
+
+/**
+ * The row is found by NAME, and a name is the one user-visible string here that
+ * is not copy — the scenario chose it a moment ago, so naming it is naming a
+ * fixture rather than an adopter's wording.
+ */
+function rowFor(page: Page, name: string): Locator {
+  return page.getByTestId(GRID).getByRole('row', { name: new RegExp(name) });
+}
+
+Then('the promotion is listed with its rate', async ({ page }) => {
+  const row = rowFor(page, currentName);
+  await expect(row).toBeVisible();
+  // The round trip is the claim: a rate typed as a percentage comes back as one
+  // only if the conversion into basis points and back out BOTH ran. How it
+  // reads is the host's formatting, so the host states it.
+  await expect(row.getByText(discountsWorld().fixtures.percentInGrid)).toBeVisible();
+});
+
+When('I start composing a promotion', async ({ page }) => {
+  await openCreateDialog(page);
+});
+
+Then('the percentage field is the one on screen', async ({ page }) => {
+  await expect(page.getByTestId(DIALOG).getByTestId('total-form-field-percentOff')).toBeVisible();
+});
+
+When('I switch it to a fixed amount', async ({ page }) => {
+  await page.getByTestId(DIALOG).getByTestId('total-form-field-kind-item-FIXED_AMOUNT').click();
+});
+
+Then('the amount field REPLACES the percentage one', async ({ page }) => {
+  const dialog = page.getByTestId(DIALOG);
+  await expect(dialog.getByTestId('total-form-field-amountOff')).toBeVisible();
+  // Replaced, not hidden: a merely-hidden percentage input would still submit a
+  // stale rate alongside an amount the operator typed.
+  await expect(dialog.getByTestId('total-form-field-percentOff')).toHaveCount(0);
+});
+
+When('I switch it to a combo', async ({ page }) => {
+  await page.getByTestId(DIALOG).getByTestId('total-form-field-kind-item-COMBO').click();
+});
+
+Then('the scope question disappears and the group builder takes its place', async ({ page }) => {
+  const dialog = page.getByTestId(DIALOG);
+  // A combo COVERS the groups it is made of, so scope stops being a question at
+  // all — unmounted rather than disabled. That is what stops an operator
+  // building a combination the write path then refuses.
+  await expect(dialog.getByTestId('total-form-field-scope-item-ORDER')).toHaveCount(0);
+  await expect(dialog.getByTestId('combo-slots')).toBeVisible();
+});
+
+Then('the scope question comes back for a plain kind', async ({ page }) => {
+  const dialog = page.getByTestId(DIALOG);
+  await dialog.getByTestId('total-form-field-kind-item-FIXED_AMOUNT').click();
+  await expect(dialog.getByTestId('total-form-field-scope-item-ORDER')).toBeVisible();
+});
+
+When('I set the activation to a coupon code', async ({ page }) => {
+  await page.getByTestId(DIALOG).getByTestId('total-form-field-trigger-item-CODE').click();
+});
+
+Then('the coupon field is revealed', async ({ page }) => {
+  await expect(page.getByTestId(DIALOG).getByTestId('total-form-field-code')).toBeVisible();
+});
+
+/** Open the row's kebab and take one of its entries by its STABLE id. */
+async function chooseRowAction(page: Page, action: 'edit' | 'delete'): Promise<void> {
+  await rowFor(page, currentName).locator('[data-testid^="discount-actions-"]').click();
+  await page.getByTestId(`discount-action-${action}`).click();
+}
+
+When('I rename it from the row menu', async ({ page }) => {
+  await chooseRowAction(page, 'edit');
+  const dialog = page.getByTestId(DIALOG);
+  await expect(dialog).toBeVisible();
+  currentName = `${currentName} II`;
+  await dialog.getByTestId('total-form-field-name').fill(currentName);
+  await dialog.getByTestId('discount-form-submit').click();
+  await expect(dialog).toBeHidden();
+});
+
+Then('the grid shows the new name', async ({ page }) => {
+  // The grid re-read the server — proof the write landed, rather than proof the
+  // dialog closed.
+  await expect(rowFor(page, currentName)).toBeVisible();
+});
+
+When('I delete it from the row menu', async ({ page }) => {
+  await chooseRowAction(page, 'delete');
+  // The menu entry only OPENS the confirmation; the DELETE leaves when it is
+  // confirmed.
+  await page.getByTestId('discount-delete-confirm-confirm-button').click();
+});
+
+Then('the promotion is gone from the grid', async ({ page }) => {
+  // A soft delete: the row leaves the list even though the record survives for
+  // its redemption history.
+  await expect(rowFor(page, currentName)).toHaveCount(0);
+});

package/src/e2e/world.ts

@@ -0,0 +1,93 @@
+import type { Page } from '@playwright/test';
+
+/**
+ * The port a HOST implements to run the packaged promotions journeys.
+ *
+ * The journeys are portable because every assertion in them reads a test id
+ * this package's own components render — `discounts-grid`, `discount-dialog`,
+ * `discount-action-edit`, `total-form-field-*` mean the same thing in any app
+ * that mounts `createWebDiscounts`. What is NOT portable is everything around
+ * them: how an app signs somebody in, how it routes to the promotions screen,
+ * how it returns to a known state, and how it renders a percentage.
+ *
+ * It replaces a 167-line spec in the origin host (`discounts.e2e.ts`), which
+ * asserted this package's test ids from a repo it does not build — the
+ * arrangement whose failure mode is silent from here: rename an id inside the
+ * package and a spec it cannot see goes red somewhere it does not run.
+ */
+
+/**
+ * Facts about the host that the assertions have to name.
+ *
+ * A journey has to talk about SOMETHING: a permission to tick, a name to type,
+ * a rendered value to look for. None of that can live in a feature file without
+ * inventing one host's fixture as though it were everybody's.
+ */
+export interface DiscountsFixtures {
+  /**
+   * A name no seed uses, minted FRESH per call.
+   *
+   * A function rather than a string because these journeys WRITE: the
+   * promotions table carries a per-tenant unique index on the name, so a
+   * constant would collide with itself on the second scenario and on every
+   * re-run against the same database.
+   */
+  newName: (prefix: string) => string;
+  /** The percentage a create journey types, as the form takes it (e.g. `15`). */
+  percent: string;
+  /**
+   * How that percentage READS in the grid once saved (e.g. `15%`).
+   *
+   * Stated by the host because formatting is the host's: `createWebDiscounts`
+   * takes a locale and a currency, so the same 15 renders differently in two
+   * adopters. It is the round-trip that matters — a value typed as a percentage
+   * comes back as one only if the conversion into basis points and back out
+   * both ran — and this is the half a package cannot spell.
+   */
+  percentInGrid: string;
+}
+
+/** What a host must be able to do for these journeys to run in it. */
+export interface DiscountsWorld {
+  /**
+   * Put the browser in a known signed-in state as somebody who may manage
+   * promotions, and return the store to a known one.
+   *
+   * These journeys write, so the reset is load-bearing rather than hygiene: a
+   * scenario that renamed a promotion would otherwise hand the next one a
+   * catalog it did not expect.
+   */
+  signInAsManager(page: Page): Promise<void>;
+  /** Land on the promotions screen and wait until its grid has rendered. */
+  openDiscountsScreen(page: Page): Promise<void>;
+  fixtures: DiscountsFixtures;
+}
+
+let installed: DiscountsWorld | null = null;
+
+/**
+ * Install the host's implementation. Call this from a module inside the host's
+ * OWN steps glob — playwright-bdd imports every step file before any scenario
+ * runs, so a top-level call there is registered in time, in every worker.
+ */
+export function defineDiscountsWorld(world: DiscountsWorld): void {
+  installed = world;
+}
+
+/**
+ * The installed world, or a refusal naming the fix.
+ *
+ * Throws rather than returning null: a step that ran against an absent world
+ * would fail on whatever it touched next, somewhere unrelated to the actual
+ * mistake, which is a diagnosis nobody should have to make twice.
+ */
+export function discountsWorld(): DiscountsWorld {
+  if (!installed) {
+    throw new Error(
+      'No discounts e2e world is installed. Call defineDiscountsWorld({ … }) from a module ' +
+        "inside your own `steps` glob — playwright-bdd imports those before any " +
+        'scenario runs, which is what makes the registration land in every worker.',
+    );
+  }
+  return installed;
+}

package/src/manifest/index.ts

@@ -82,6 +82,18 @@ export const discountsManifest = {
    * as the order that redeemed it is a rule that can be redeemed twice.
    */
   db: { partial: "prisma/discounts.prisma", migrations: "prisma/migrations" },
+  /**
+   * The promotions journeys (`../e2e`), and the world port a host implements
+   * to run them.
+   *
+   * Undeclared, they were adopted BY CONVENTION: a 167-line spec in the origin
+   * host asserting this package's own test ids from a repo it does not build —
+   * the arrangement whose failure mode is silent from here, since renaming an
+   * id in this package goes red somewhere this package cannot see. Declared, a
+   * host either binds `featuresRoot` or declines in writing, and the decline
+   * lands in the wiring report rather than in nobody's head.
+   */
+  e2e: { entry: "@12-apps/discounts/e2e", world: { factory: "defineDiscountsWorld" } },
   server: ["http"],
   web: ["surface", "areas"],
 } as const satisfies PackageManifest;

package/src/react/discount-actions-menu.tsx

@@ -92,17 +92,23 @@ export function DiscountActionsMenu({
 
   const remove = useDeleteConfirm(row, api, copy, onError);
 
+  // Each entry carries a test id derived from its STABLE id, never its label:
+  // a label is host copy, so a spec clicking one is pinned to a single
+  // adopter's words — which is exactly what the packaged journeys exist not to
+  // be. The origin host's spec reached for `menuitem { name: 'Editar' }`.
   const items: DropdownMenuItem[] = [];
   if (canEdit) {
     items.push({
       id: "edit",
       label: copy.actions.edit,
+      dataTestId: "discount-action-edit",
       onClick: () => setEditOpen(true),
     });
   }
   items.push({
     id: "delete",
     label: copy.actions.delete,
+    dataTestId: "discount-action-delete",
     color: "danger",
     onClick: remove.request,
   });