@12-apps/payments-e2e 1.0.0

package/dist/steps/fixtures.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The BDD `test` every packaged step binds to (FUT-743, packaged by FUT-561).
+ *
+ * Extending Playwright's own `test` rather than cucumber's runner is the whole
+ * point of playwright-bdd: these scenarios run as ordinary Playwright tests,
+ * against the host's own web server, with the same reporters, retries and
+ * traces as the specs beside them.
+ *
+ * There is deliberately NO fixture here beyond Playwright's own. An earlier
+ * version carried a `journey` fixture remembering which harness page a scenario
+ * had opened, which is exactly the kind of host knowledge that stopped these
+ * journeys from shipping with the library. Where a step needs the host, it asks
+ * {@link paymentsWorld} — a module-level registry the host installs into — so
+ * this `test` stays something a consumer never has to reconstruct.
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & import("playwright-bdd").BddTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & import("playwright-bdd").BddWorkerFixtures>;
+export declare const Given: import("playwright-bdd").PlaywrightStyleStepCtor<import("playwright-bdd").PlaywrightStyleStepFn<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & import("playwright-bdd").BddTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & import("playwright-bdd").BddWorkerFixtures>>, When: import("playwright-bdd").PlaywrightStyleStepCtor<import("playwright-bdd").PlaywrightStyleStepFn<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & import("playwright-bdd").BddTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & import("playwright-bdd").BddWorkerFixtures>>, Then: import("playwright-bdd").PlaywrightStyleStepCtor<import("playwright-bdd").PlaywrightStyleStepFn<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & import("playwright-bdd").BddTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & import("playwright-bdd").BddWorkerFixtures>>;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/steps/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/steps/fixtures.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,qUAAO,CAAC;AAEzB,eAAO,MAAQ,KAAK,oYAAE,IAAI,oYAAE,IAAI,kYAAoB,CAAC"}

package/dist/steps/fixtures.js

@@ -0,0 +1,19 @@
+import { test as base, createBdd } from 'playwright-bdd';
+/**
+ * The BDD `test` every packaged step binds to (FUT-743, packaged by FUT-561).
+ *
+ * Extending Playwright's own `test` rather than cucumber's runner is the whole
+ * point of playwright-bdd: these scenarios run as ordinary Playwright tests,
+ * against the host's own web server, with the same reporters, retries and
+ * traces as the specs beside them.
+ *
+ * There is deliberately NO fixture here beyond Playwright's own. An earlier
+ * version carried a `journey` fixture remembering which harness page a scenario
+ * had opened, which is exactly the kind of host knowledge that stopped these
+ * journeys from shipping with the library. Where a step needs the host, it asks
+ * {@link paymentsWorld} — a module-level registry the host installs into — so
+ * this `test` stays something a consumer never has to reconstruct.
+ */
+export const test = base;
+export const { Given, When, Then } = createBdd(test);
+//# sourceMappingURL=fixtures.js.map

package/dist/steps/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/steps/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC;AAEzB,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC"}

package/dist/steps/loja.steps.d.ts

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

package/dist/steps/loja.steps.d.ts.map

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

package/dist/steps/loja.steps.js

@@ -0,0 +1,68 @@
+import { expect } from '@playwright/test';
+import { paymentsWorld } from '../world.js';
+import { Given } from './fixtures.js';
+/**
+ * WHICH STORE a scenario is set in (FUT-743, packaged by FUT-561).
+ *
+ * Every one of these is a fact about the MERCHANT — what it connected, what
+ * that provider does, whether it charges online at all — and none of them is a
+ * fact about the buyer. They are separate from the buyer's own steps for that
+ * reason: the same journey is worth telling in several stores, and a Given that
+ * mixed the two would have to be rewritten per store.
+ *
+ * None of them knows how a store is BUILT. Each names a shape and hands it to
+ * the host's `PaymentsWorld.open`, which is the only part that differs between
+ * an in-page harness and a real app seeding a tenant. That is what lets these
+ * ship with the library instead of being copied into every consumer.
+ */
+Given('a compradora abre o checkout da loja de PIX', async ({ page }) => {
+    await paymentsWorld().open(page, 'pix-only');
+});
+Given('a compradora abre o checkout da loja de cartão', async ({ page }) => {
+    await paymentsWorld().open(page, 'card');
+});
+Given('a compradora abre o checkout de uma loja que aceita os dois', async ({ page }) => {
+    await paymentsWorld().open(page, 'both-methods');
+});
+Given('a compradora abre o checkout de uma loja de página externa', async ({ page }) => {
+    await paymentsWorld().open(page, 'hosted');
+});
+Given('a loja ainda não recebeu o pagamento', async ({ page }) => {
+    await paymentsWorld().open(page, 'awaiting');
+});
+Given('a loja confirma o pagamento na primeira consulta', async ({ page }) => {
+    await paymentsWorld().open(page, 'settles');
+});
+Given('o provedor da loja recusa o cartão', async ({ page }) => {
+    await paymentsWorld().open(page, 'declined');
+});
+/** Nothing can prove whether the money moved, and the provider answers no probe. */
+Given('o provedor da loja não responde de forma conclusiva', async ({ page }) => {
+    await paymentsWorld().open(page, 'unresolved');
+});
+/** Provably nothing left the building — the walk may advance, and finds nobody. */
+Given('o provedor da loja está fora do ar', async ({ page }) => {
+    await paymentsWorld().open(page, 'unavailable');
+});
+Given('a loja não tem provedor nenhum conectado', async ({ page }) => {
+    await paymentsWorld().open(page, 'no-provider');
+});
+Given('a loja não tem provedor nenhum e oferece chamar o garçom', async ({ page }) => {
+    await paymentsWorld().open(page, 'no-provider-remedy');
+});
+/**
+ * The chain is live and the config read succeeds. Only the application knows
+ * this store has switched online payments off, so only the application can say.
+ */
+Given('a loja tem provedor mas desligou os pagamentos online', async ({ page }) => {
+    const world = paymentsWorld();
+    await world.open(page, 'payments-off');
+    await expect(world.wire.paths(page)).toHaveText('GET /api/checkout/config');
+});
+Given('a loja tem dois provedores que geram token no navegador', async ({ page }) => {
+    await paymentsWorld().open(page, 'two-mintable');
+});
+Given('a loja tem um provedor de página externa seguido de um que gera token', async ({ page }) => {
+    await paymentsWorld().open(page, 'redirect-head');
+});
+//# sourceMappingURL=loja.steps.js.map

package/dist/steps/loja.steps.js.map

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

package/dist/steps/telas.steps.d.ts

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

package/dist/steps/telas.steps.d.ts.map

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

package/dist/steps/telas.steps.js

@@ -0,0 +1,40 @@
+import { expect } from '@playwright/test';
+import { paymentsWorld } from '../world.js';
+import { Given, Then } from './fixtures.js';
+/**
+ * WHICH SCREEN THE STORE'S PROVIDER ASKED FOR (FUT-596, packaged by FUT-561).
+ *
+ * These are facts about the merchant's adapter, so they sit beside
+ * `loja.steps.ts`'s Givens rather than in the buyer's own file — the buyer does
+ * nothing differently in any of them, which is exactly the claim: she fills the
+ * same form and presses the same button, and the pane underneath is whichever
+ * the provider declared.
+ *
+ * The store shapes are declarative, so a host satisfies them however it can:
+ * the harness declares a chain in-page, a real app seeds a tenant whose adapter
+ * declares the id. Either way the id is published by `GET /checkout/config` and
+ * resolved by the checkout, so these fail if the field is dropped anywhere
+ * along that path.
+ */
+Given('a loja declara que cobra na própria página', async ({ page }) => {
+    await paymentsWorld().open(page, 'screen-on-page');
+});
+Given('a loja declara que a compradora termina no provedor', async ({ page }) => {
+    await paymentsWorld().open(page, 'screen-handoff');
+});
+/** Stone and Stripe today: the capability default answers for them. */
+Given('a loja não declara tela nenhuma', async ({ page }) => {
+    await paymentsWorld().open(page, 'screen-undeclared');
+});
+/**
+ * A newer server against an older bundle. The two packages version
+ * independently, so this is an ordinary deployment state — and the one where
+ * "unknown id ⇒ render nothing" would take the whole checkout down silently.
+ */
+Given('a loja declara uma tela que este pacote não conhece', async ({ page }) => {
+    await paymentsWorld().open(page, 'screen-unknown');
+});
+Then('ela é avisada de que vai ser levada para o provedor', async ({ page }) => {
+    await expect(page.getByTestId('checkout-handoff-pending')).toBeVisible();
+});
+//# sourceMappingURL=telas.steps.js.map

package/dist/steps/telas.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telas.steps.js","sourceRoot":"","sources":["../../src/steps/telas.steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AAEH,KAAK,CAAC,4CAA4C,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACrE,MAAM,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,qDAAqD,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC9E,MAAM,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,uEAAuE;AACvE,KAAK,CAAC,iCAAiC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC1D,MAAM,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,KAAK,CAAC,qDAAqD,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC9E,MAAM,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAC7E,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3E,CAAC,CAAC,CAAC"}

package/dist/world.d.ts

@@ -0,0 +1,139 @@
+import type { Page } from '@playwright/test';
+/**
+ * The port a HOST implements to run the packaged payment journeys (FUT-561).
+ *
+ * The journeys themselves are portable: every assertion in them reads a test id
+ * the payments package's own components render, so `card-number`,
+ * `checkout-method-CARD` and `payment-paid` mean the same thing in any app that
+ * mounts the checkout. What is NOT portable is everything around them — how
+ * this app routes to a checkout, how a merchant of a given shape gets set up,
+ * and where a host records what crossed the wire.
+ *
+ * That is the whole of this port. A host implements it once, adds one glob to
+ * its bdd config, and inherits every scenario the library ships — including the
+ * ones added after it integrated. Nothing is copied, so nothing can rot.
+ */
+/**
+ * The SHAPE of a store a scenario is set in — never a vendor, and never a
+ * screen id either.
+ *
+ * A scenario says what kind of merchant it is talking about; the host decides
+ * how to produce one. That indirection is what lets the same journey run
+ * against a harness that declares an in-page provider chain and against a real
+ * app that seeds a tenant, without either of them editing the feature file.
+ *
+ * Adding a member here is a breaking change for hosts, which is the correct
+ * cost: a new scenario that needs a store nobody can build is a scenario that
+ * silently never runs.
+ */
+export type PaymentsStore = 
+/** One provider, PIX only — the simplest store there is. */
+'pix-only'
+/** One provider that mints card instruments in the browser. */
+ | 'card'
+/** One provider offering both methods. */
+ | 'both-methods'
+/** The buyer finishes on the provider's own page. */
+ | 'hosted'
+/** A PIX code nobody has paid yet — the state a buyer sits in while deciding. */
+ | 'awaiting'
+/** The provider confirms on the first poll. */
+ | 'settles'
+/** The issuer refuses. A real decline, not an outage. */
+ | 'declined'
+/** Nobody can prove whether the money moved, and no probe answers. */
+ | 'unresolved'
+/** Provably nothing left the building — the walk may advance. */
+ | 'unavailable'
+/** No provider connected at all. */
+ | 'no-provider'
+/** No provider, but the host offers something else to do. */
+ | 'no-provider-remedy'
+/** A live chain the APPLICATION has switched online payments off for. */
+ | 'payments-off'
+/** Two providers that both mint in the browser. */
+ | 'two-mintable'
+/** A hand-off provider at the head, a minting one behind it. */
+ | 'redirect-head'
+/** Declares the on-page screen (FUT-596). */
+ | 'screen-on-page'
+/** Declares the hand-off screen (FUT-596). */
+ | 'screen-handoff'
+/** Declares no screen — the capability default answers. */
+ | 'screen-undeclared'
+/** Declares a screen id this bundle has never shipped. */
+ | 'screen-unknown';
+/**
+ * Facts about the host's own fixtures that the assertions have to name.
+ *
+ * These exist because a few Thens are about WHAT CROSSED THE WIRE, not about
+ * what is on the screen — which provider received the charge, which host the
+ * buyer was sent to. Those are the assertions that caught three criticals in
+ * FUT-740, so they are worth the coupling; parameterising them here is what
+ * keeps the feature files free of one host's invented vendor names.
+ */
+export interface PaymentsFixtures {
+    /** The first provider of a multi-entry chain. */
+    headProvider: string;
+    /** The provider behind it. */
+    tailProvider: string;
+    /** A substring of the hosted checkout URL the buyer is sent to. */
+    hostedUrlFragment: string;
+    /** A substring of the payable reference the host parks before navigating. */
+    payableRef: string;
+    /** The CPF the buyer types, as the provider should receive it. */
+    taxId: string;
+}
+/**
+ * Where a host records what actually crossed the wire.
+ *
+ * A host that renders no probe can return locators that never resolve — the
+ * scenarios asserting on them will fail loudly, which is the honest outcome:
+ * those journeys are the ones that only pass because somebody is watching the
+ * bytes, and quietly skipping them would report a coverage that is not there.
+ */
+export interface PaymentsWireProbe {
+    /** Every request path the client made, in order. */
+    paths(page: Page): ReturnType<Page['getByTestId']>;
+    /** The charge body's own top-level keys. */
+    chargeKeys(page: Page): ReturnType<Page['getByTestId']>;
+    /** The charge body, verbatim. */
+    chargeBody(page: Page): ReturnType<Page['getByTestId']>;
+    /** The instrument map, or `(absent)` when none was sent. */
+    tokensByProvider(page: Page): ReturnType<Page['getByTestId']>;
+    /** Every charge a provider actually received, tagged with who received it. */
+    providerCharges(page: Page): ReturnType<Page['getByTestId']>;
+    /** How many charges reached a provider. */
+    providerChargeCount(page: Page): ReturnType<Page['getByTestId']>;
+    /** Where the host was asked to navigate, on a hand-off. */
+    navigated(page: Page): ReturnType<Page['getByTestId']>;
+}
+/** Everything a host supplies to run the packaged journeys. */
+export interface PaymentsWorld {
+    /** Put the browser on a checkout for a store of this shape. */
+    open(page: Page, store: PaymentsStore): Promise<void>;
+    /** Raise a hosted payable and show the hand-off interstitial. */
+    raiseHostedPayable(page: Page): Promise<void>;
+    /** Bring the buyer back from the provider's page, as a real return trip. */
+    returnFromProvider(page: Page): Promise<void>;
+    /** The terminal status the return leg settles to. */
+    hostedReturnStatus(page: Page): ReturnType<Page['getByTestId']>;
+    fixtures: PaymentsFixtures;
+    wire: PaymentsWireProbe;
+}
+/**
+ * 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 definePaymentsWorld(world: PaymentsWorld): void;
+/**
+ * The installed world.
+ *
+ * Throws rather than degrading: a journey that ran against a half-configured
+ * world would fail somewhere deep inside a step with a message about a missing
+ * element, and the actual cause — a host that forgot to call
+ * {@link definePaymentsWorld} — would be several layers away from the error.
+ */
+export declare function paymentsWorld(): PaymentsWorld;
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

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

package/dist/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 definePaymentsWorld(world) {
+    installed = world;
+}
+/**
+ * The installed world.
+ *
+ * Throws rather than degrading: a journey that ran against a half-configured
+ * world would fail somewhere deep inside a step with a message about a missing
+ * element, and the actual cause — a host that forgot to call
+ * {@link definePaymentsWorld} — would be several layers away from the error.
+ */
+export function paymentsWorld() {
+    if (!installed) {
+        throw new Error('No PaymentsWorld installed. Call definePaymentsWorld(...) from a module ' +
+            "inside this app's bdd `steps` glob — see @12-apps/payments-e2e's README.");
+    }
+    return installed;
+}
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAiIA,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/features/a-compra-sobrevive-ao-primeiro-provedor.feature

@@ -0,0 +1,28 @@
+@journey @cadeia
+Feature: A compra sobrevive ao primeiro provedor falhar
+
+  A lojista ordenou dois provedores. Do lado de quem compra isso tem que ser
+  invisível: o cartão é digitado UMA vez e a compra atravessa o primeiro
+  provedor caindo.
+
+  Só que um token de cartão pertence a quem o gerou, então a caminhada só
+  consegue avançar para um provedor para o qual o navegador também gerou um. É
+  por isso que a quantidade de instrumentos enviados é uma decisão do checkout,
+  e é por isso que estes cenários olham para o que foi enviado e não só para a
+  tela.
+
+
+  Scenario: O primeiro provedor cai e o segundo cobra, sem redigitar nada
+    Given a loja tem dois provedores que geram token no navegador
+    When ela informa o CPF e segue para o pagamento
+    And ela paga com um cartão novo
+    Then o pagamento é confirmado
+    And um instrumento foi gerado para cada provedor da cadeia
+    And os dois provedores receberam a cobrança
+
+  Scenario: O primeiro provedor é uma página externa e mesmo assim o mapa é enviado
+    Given a loja tem um provedor de página externa seguido de um que gera token
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    And ela paga com um cartão novo
+    Then o mapa de instrumentos traz só o provedor que gera token

package/features/a-loja-nao-cobra-online.feature

@@ -0,0 +1,25 @@
+@journey @indisponivel
+Feature: A loja não cobra online
+
+  Duas coisas diferentes levam à mesma tela, e confundir uma com a outra é um
+  defeito de verdade: uma loja que nunca conectou provedor nenhum, e uma loja
+  que tem provedor mas desligou os pagamentos online. A primeira o servidor
+  sabe; a segunda só a aplicação sabe. Se a decisão passar a ser de um lado só,
+  uma das duas lojas volta a oferecer um checkout que não vai honrar.
+
+
+  Scenario: Sem provedor nenhum, nada de pagamento aparece e nada é cobrado
+    Given a loja não tem provedor nenhum conectado
+    Then ela é avisada de que a loja não cobra online
+    And nenhuma forma de pagamento é oferecida
+    And nenhum pedido chegou a ser criado
+
+  Scenario: Sem provedor, mas com alguém para chamar
+    Given a loja não tem provedor nenhum e oferece chamar o garçom
+    Then ela recebe a opção de chamar o garçom
+    And nenhuma forma de pagamento é oferecida
+
+  Scenario: A loja tem provedor mas desligou o pagamento online
+    Given a loja tem provedor mas desligou os pagamentos online
+    Then ela é avisada de que a loja não cobra online
+    And nenhuma forma de pagamento é oferecida

package/features/a-tela-que-o-provedor-pediu.feature

@@ -0,0 +1,49 @@
+@journey @telas-de-provedor
+Feature: A tela que o provedor pediu
+
+  Cada provedor tem um jeito de cobrar, e por muito tempo o checkout desenhava
+  um só, cheio de condicionais. Agora quem cobra na nossa página e quem cobra na
+  página dele pedem telas diferentes — e é o ADAPTADOR que pede, não o checkout
+  que adivinha.
+
+  O id que ele declara nomeia a FORMA do fluxo, nunca a marca. Por isso as lojas
+  aqui têm nomes inventados: uma loja "aurora" que declara a mesma forma recebe
+  exatamente a mesma tela que um adquirente de verdade receberia.
+
+  As duas últimas cenas são as que importam de madrugada. Um provedor que não
+  declara nada continua vendendo, e um id que este pacote nunca viu — servidor
+  mais novo que o navegador, coisa normal em deploy — cai na tela de capacidade
+  em vez de deixar a compradora olhando para um painel vazio.
+
+
+  Scenario: Quem cobra na nossa página mostra o formulário aqui mesmo
+    Given a loja declara que cobra na própria página
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+
+  Scenario: Quem cobra na página dele não oferece formulário nenhum
+    Given a loja declara que a compradora termina no provedor
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then nenhum formulário de cartão é mostrado
+    And ela é avisada de que vai ser levada para o provedor
+
+  Scenario: Um provedor que não declara tela nenhuma continua vendendo
+    Given a loja não declara tela nenhuma
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+
+  Scenario: Um id que este pacote não conhece não deixa a tela em branco
+    Given a loja declara uma tela que este pacote não conhece
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+
+  Scenario: A compradora paga normalmente na loja que declara a nossa tela
+    Given a loja declara que cobra na própria página
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    And ela paga com um cartão novo
+    Then o pagamento é confirmado

package/features/comprando-com-cartao.feature

@@ -0,0 +1,24 @@
+@journey @cartao
+Feature: Comprando com cartão
+
+  A compradora digita o cartão uma vez. O que acontece com esses dados entre o
+  navegador e o provedor é onde os três defeitos críticos da FUT-740 moravam —
+  com todos os quinze checks verdes — então cada cenário aqui termina olhando
+  para o que realmente atravessou.
+
+  Background:
+    Given a compradora abre o checkout da loja de cartão
+
+  Scenario: O cartão é cobrado e o CPF chega ao provedor
+    When ela informa o CPF e segue para o pagamento
+    Then ela vê o formulário de cartão
+    When ela paga com um cartão novo
+    Then o pagamento é confirmado
+    And a cobrança enviada ao provedor carrega o cartão e o CPF dela
+    And o corpo da cobrança é o formato plano que o cliente publicado envia
+
+  Scenario: Uma loja com um provedor só não envia tokensByProvider
+    When ela informa o CPF e segue para o pagamento
+    And ela paga com um cartão novo
+    Then o pagamento é confirmado
+    And nenhum tokensByProvider é enviado

package/features/comprando-com-pix.feature

@@ -0,0 +1,25 @@
+@journey @pix
+Feature: Comprando com PIX numa loja que só aceita PIX
+
+  A loja ligou um único provedor e ele só cobra por PIX. Do ponto de vista de
+  quem compra, isso não é uma escolha: a tela mostra uma opção só, já marcada, e
+  o código aparece sem nenhum toque a mais.
+
+  O QR não é desenhado pelo checkout — ele vem do payload que o provedor gerou e
+  que a loja carregou de volta na própria resposta. Um payload que não sobrevive
+  a esse caminho vira uma tela de pagamento sem código nenhum, e é isso que
+  estes cenários vigiam.
+
+
+  Scenario: O PIX já vem marcado e o código é o do provedor
+    Given a loja ainda não recebeu o pagamento
+    When ela informa o CPF e segue para o pagamento
+    Then só a opção PIX é oferecida
+    And ela vê o QR code do PIX
+    And o código copia-e-cola veio do provedor
+
+  Scenario: O pagamento é confirmado sozinho e a compradora vê o recibo
+    Given a loja confirma o pagamento na primeira consulta
+    When ela informa o CPF e segue para o pagamento
+    Then o pagamento é confirmado
+    And o recibo mostra o valor pago

package/features/pagando-na-pagina-do-provedor.feature

@@ -0,0 +1,31 @@
+@journey @redirecionamento
+Feature: Pagando na página do provedor
+
+  Quando ninguém na cadeia consegue gerar token no navegador, o cartão é
+  digitado na página do próprio provedor. A compradora sai do site da loja e
+  volta depois — e essa volta é a parte que costuma quebrar em silêncio: a
+  aplicação foi destruída pela navegação, então a única coisa que resta é o que
+  foi guardado ANTES de sair.
+
+  Guardar primeiro e navegar depois é a regra. Invertida, a compradora paga e
+  volta para uma tela em branco.
+
+  Background:
+    Given a compradora abre o checkout de uma loja de página externa
+
+  Scenario: Nenhum formulário de cartão é oferecido, e a saída fica registrada
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then nenhum formulário de cartão é mostrado
+    And a loja registrou para onde ela seria levada
+
+  Scenario: A tela de transferência guarda o pedido e oferece um link de verdade
+    When a loja gera o pagamento hospedado
+    Then ela vê a tela de transferência para o provedor
+    And existe um link visível para a página do provedor
+    And o pedido foi guardado antes da navegação
+
+  Scenario: Ela volta do provedor e o pagamento aparece confirmado
+    When a loja gera o pagamento hospedado
+    And ela volta da página do provedor
+    Then o pagamento volta confirmado

package/features/quando-o-pagamento-nao-vai.feature

@@ -0,0 +1,40 @@
+@journey @recusas
+Feature: Quando o pagamento não vai
+
+  Recusa não é uma coisa só, e tratar as três como se fossem é o que produz o
+  dano. O emissor recusar é um problema que a compradora resolve; uma cobrança
+  que ninguém consegue confirmar é a única situação em que oferecer "tentar de
+  novo" pode custar dinheiro de verdade a ela; e uma cadeia esgotada não tem
+  nada a ver com os dados que ela digitou.
+
+  A loja destes cenários aceita PIX e cartão, então escolher o cartão é um
+  passo de verdade — e no último cenário é justamente o que sobra.
+
+
+  Scenario: O emissor recusa e ela pode tentar de novo
+    Given o provedor da loja recusa o cartão
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+    When ela paga com um cartão recusado
+    Then o pagamento falha
+    And ela pode tentar novamente
+
+  Scenario: Ninguém consegue confirmar a cobrança, então não há como pagar de novo
+    Given o provedor da loja não responde de forma conclusiva
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+    When ela paga com um cartão novo
+    Then ela é avisada de que o pagamento está sendo confirmado
+    And não existe nenhum botão de pagar na tela
+    And não existe nenhum botão de tentar novamente na tela
+
+  Scenario: A cadeia se esgota e o PIX continua disponível
+    Given o provedor da loja está fora do ar
+    When ela informa o CPF e segue para o pagamento
+    And ela escolhe pagar com cartão
+    Then ela vê o formulário de cartão
+    When ela paga com um cartão novo
+    Then o erro do cartão menciona o outro meio de pagamento
+    And a opção PIX continua na tela

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@12-apps/payments-e2e",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "The payments buyer journeys, as Gherkin a host runs against its own app",
+  "files": [
+    "dist",
+    "features",
+    "*.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf node_modules dist",
+    "lint": "eslint src --max-warnings 0",
+    "check-types": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0",
+    "playwright-bdd": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@12-apps/eslint-config": "^1.16.2",
+    "@12-apps/typescript-config": "^1.16.2",
+    "@playwright/test": "^1.56.1",
+    "playwright-bdd": "^8.4.1",
+    "typescript": "5.9.2"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}