@birtalanrobert/game-economy 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -4,6 +4,114 @@ Each package carries its own version. A release publishes only the packages
 whose version is not yet on the registry; `pnpm release` asks npm and skips the
 rest.
 
+## game-economy 2.0.0
+
+### Breaking
+
+- **`EntryKind` has `reversal`, a debit.** A reader that switches over the
+  kinds exhaustively, or keeps a record keyed by them, has one more.
+
+### Added
+
+- **`reverse`: a purchase's currency taken back because its money went back
+  another way** — a refund made at the payment provider, a chargeback.
+  `refund` gives back only a whole purchase, which is right for a buyer asking
+  and wrong for money already gone: a reversal takes whatever of the purchase is
+  left, which may be less than all of it, or nothing, and answers with what it
+  took and what the holder had spent already — what nothing can take back, for
+  the game to decide what it costs them. A purchase is given back once, by a
+  refund or a reversal, whichever comes first: a reversal of one given back
+  already takes nothing and names the entry that did. Idempotent by key, as
+  every write is. Designed against Holdfast's Silver, whose chargebacks take
+  back what is unspent and flag what was spent.
+- **The migration `AddReversals1791548064129`**, in `gameEconomyMigrations`:
+  the kind, and the check that a reversal, like a refund, names its purchase.
+
+### Migrating from 1.x
+
+Run the new migration. A product that only credits, spends, refunds and reads
+needs nothing else.
+
+## billing 4.0.0
+
+Selling a pack — a premium currency, a ticket — as a single payment, rather
+than a plan by the month: what four of the seventeen specifications sell.
+First consumed by Holdfast's Silver.
+
+### Breaking
+
+- **`BillingProvider` has `refund`.** An implementation of the port — a test
+  fake among them — needs one; `NoBilling`'s refuses, as everything else of
+  its does.
+- **`BillingEvent` has `eventId`, and two more kinds.** The event's own
+  identifier, the same on every delivery, is what makes a webhook delivered
+  twice recognisable as one. `kind` may now also be `refund` and `dispute`:
+  a reader that switches over it exhaustively has two more cases, and a fake
+  that builds events needs the id.
+- **`CheckoutRequest.price` may be an `InlinePrice`.** A provider reading it
+  as a string must handle the other shape.
+
+### Added
+
+- **A single payment priced by its amount** (`InlinePrice`): the amount in
+  minor units, the currency, the name the buyer reads, whether the tax is
+  inside the amount, and the provider's tax code. A pack whose price an
+  operator edits in the product's own settings is charged as written, with no
+  price in the provider's dashboard to drift from it. For `payment` mode only;
+  a subscription is still priced by its plan's identifier.
+- **`CheckoutRequest.metadata` and `locale`.** The caller's own keys travel
+  with `subject` onto the session and, for a single payment, onto the payment
+  itself — which a refund or a dispute names, never the session. The payment
+  page opens in the buyer's language.
+- **`refund({ payment, amount?, reference })`**, idempotent on the reference,
+  answering with the refund's status: `pending` until the payment method
+  confirms, `succeeded`, or `failed`.
+- **Events for a single payment's life.** A checkout event carries the
+  payment, the tax the provider worked out and the caller's metadata, and is
+  paid only when the money arrived — a session completed with a bank debit
+  still clearing is not, and `checkout.session.async_payment_succeeded` and
+  `…_failed` say what became of it. `charge.refunded` is a `refund` event with
+  how much has gone back so far, every refund together — the only way a
+  product hears of one made in the provider's dashboard. `charge.dispute
+.funds_withdrawn` and `…_reinstated` are `dispute` events, with whether the
+  money left or came back; an inquiry that moves nothing raises neither.
+- **`StripeBillingOptions.apiUrl`**: the provider's API somewhere other than
+  Stripe's own — stripe-mock in a pipeline, a suite's stub vendor.
+
+### Migrating from 3.x
+
+Add `refund` to any implementation of `BillingProvider`, and `eventId` to any
+`BillingEvent` a test builds. A product that only reads events, starts
+subscriptions and calls `NoBilling` or `StripeBilling` needs nothing else.
+
+## http 2.0.1
+
+### Fixed
+
+- **A request the client could fix was answered "an unexpected error
+  occurred".** body-parser and raw-body throw `http-errors` before any handler
+  runs — a body past the limit (413), a charset or an encoding nothing reads
+  (415), and JSON that does not parse (400), which Nest alone turns into a 400
+  of its own — and `toProblemDetails` knew neither their class nor their
+  shape, so the rest became a 500 and were logged as the service's own
+  failure. An `Error` carrying a 4xx `status` and `expose: true`, the
+  library's word that its message was written for the client, now keeps its
+  status, its code and its message; one not so marked is a 500 that says
+  nothing, as before.
+
+## idempotency 1.2.1
+
+### Fixed
+
+- **A raw body was fingerprinted one byte at a time.** A request whose body is
+  bytes rather than JSON — an image sent as itself, which Express's raw parser
+  hands over as a `Buffer` — was walked as an object: one entry per byte, each
+  keyed by its index and sorted as text, so a two-megabyte upload became four
+  million strings before the key could be claimed. A body that is any view of
+  bytes now stands for their SHA-256, behind a prefix no JSON value can begin
+  with, so the same bytes are the same request and no JSON body can pass for a
+  binary one.
+
 ## game-economy 1.0.0
 
 ### Added

package/README.md

@@ -98,6 +98,24 @@ any of it is spent or it was refunded already, and `not_found` for one that is
 not the holder's purchase. Whether it is still within a refund window, and the
 money's own return, are the game's and its payment provider's.
 
+`reverse` is for money that went back another way — a refund made at the
+payment provider, a chargeback. It takes whatever of the purchase is left,
+which may be less than all of it, or nothing, and answers with what it took
+and what the holder had spent already:
+
+```ts
+const { entry, taken, spent, earlier } = await economy.reverse(holderId, {
+  purchaseId,
+  reason: 'stripe.dispute',
+  idempotencyKey: `dispute:${eventId}`,
+});
+// spent > 0: currency the holder used that nothing took back — the game decides what that costs them.
+```
+
+A purchase is given back once, by a refund or a reversal, whichever comes
+first: a reversal of one given back already takes nothing and names the entry
+that did (`earlier`), and two at once leave one of them standing.
+
 ## Two things it deliberately does not do
 
 - **Move currency between holders.** A gift between players is a transfer

package/dist/kinds.d.ts

@@ -6,10 +6,13 @@
  */
 export declare const CREDIT_KINDS: readonly ["purchase", "grant"];
 /**
- * The two ways it leaves: **spent** in the game, or a purchase **refunded** —
- * its money handed back and its currency taken back with it.
+ * The ways it leaves: **spent** in the game; a purchase **refunded** — its
+ * money handed back and all its currency taken back with it; or a purchase
+ * **reversed** — its money gone back another way, a refund made at the
+ * payment provider or a chargeback, and whatever of its currency is left
+ * taken back.
  */
-export declare const DEBIT_KINDS: readonly ["spend", "refund"];
+export declare const DEBIT_KINDS: readonly ["spend", "refund", "reversal"];
 export type CreditKind = (typeof CREDIT_KINDS)[number];
 export type DebitKind = (typeof DEBIT_KINDS)[number];
 export type EntryKind = CreditKind | DebitKind;

package/dist/kinds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gCAAiC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,WAAW,8BAA+B,CAAC;AAExD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC"}
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gCAAiC,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,0CAA2C,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC"}

package/dist/kinds.js

@@ -9,8 +9,11 @@ exports.DEBIT_KINDS = exports.CREDIT_KINDS = void 0;
  */
 exports.CREDIT_KINDS = ['purchase', 'grant'];
 /**
- * The two ways it leaves: **spent** in the game, or a purchase **refunded** —
- * its money handed back and its currency taken back with it.
+ * The ways it leaves: **spent** in the game; a purchase **refunded** — its
+ * money handed back and all its currency taken back with it; or a purchase
+ * **reversed** — its money gone back another way, a refund made at the
+ * payment provider or a chargeback, and whatever of its currency is left
+ * taken back.
  */
-exports.DEBIT_KINDS = ['spend', 'refund'];
+exports.DEBIT_KINDS = ['spend', 'refund', 'reversal'];
 //# sourceMappingURL=kinds.js.map

package/dist/kinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,YAAY,GAAG,CAAC,UAAU,EAAE,OAAO,CAAU,CAAC;AAE3D;;;GAGG;AACU,QAAA,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAU,CAAC"}
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,YAAY,GAAG,CAAC,UAAU,EAAE,OAAO,CAAU,CAAC;AAE3D;;;;;;GAMG;AACU,QAAA,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC"}

package/dist/migrations/1791548064129-AddReversals.d.ts

@@ -0,0 +1,20 @@
+import type { MigrationInterface, QueryRunner } from 'typeorm';
+/**
+ * Adds the reversal: a purchase's currency taken back because its money went
+ * back another way — a refund made at the payment provider, a chargeback.
+ *
+ * A debit like a refund, and of the same purchase — so it carries
+ * `refund_of`, and the unique index on that column makes a purchase given
+ * back once, by a refund or by a reversal, whichever comes first. Unlike a
+ * refund it takes whatever of the purchase is left, which may be less than
+ * all of it.
+ *
+ * `down` restores the narrower checks, and so fails while any reversal is
+ * recorded: an append-only ledger is not narrowed by forgetting its entries.
+ */
+export declare class AddReversals1791548064129 implements MigrationInterface {
+    name: string;
+    up(queryRunner: QueryRunner): Promise<void>;
+    down(queryRunner: QueryRunner): Promise<void>;
+}
+//# sourceMappingURL=1791548064129-AddReversals.d.ts.map

package/dist/migrations/1791548064129-AddReversals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"1791548064129-AddReversals.d.ts","sourceRoot":"","sources":["../../src/migrations/1791548064129-AddReversals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,IAAI,SAA+B;IAE7B,EAAE,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAWpD"}

package/dist/migrations/1791548064129-AddReversals.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddReversals1791548064129 = void 0;
+/**
+ * Adds the reversal: a purchase's currency taken back because its money went
+ * back another way — a refund made at the payment provider, a chargeback.
+ *
+ * A debit like a refund, and of the same purchase — so it carries
+ * `refund_of`, and the unique index on that column makes a purchase given
+ * back once, by a refund or by a reversal, whichever comes first. Unlike a
+ * refund it takes whatever of the purchase is left, which may be less than
+ * all of it.
+ *
+ * `down` restores the narrower checks, and so fails while any reversal is
+ * recorded: an append-only ledger is not narrowed by forgetting its entries.
+ */
+class AddReversals1791548064129 {
+    name = 'AddReversals1791548064129';
+    async up(queryRunner) {
+        await queryRunner.query(`
+      ALTER TABLE "mortar_economy_entries"
+        DROP CONSTRAINT "ck_economy_entries_kind",
+        DROP CONSTRAINT "ck_economy_entries_refund",
+        ADD CONSTRAINT "ck_economy_entries_kind"
+          CHECK ("kind" IN ('purchase', 'grant', 'spend', 'refund', 'reversal')),
+        ADD CONSTRAINT "ck_economy_entries_refund"
+          CHECK (("kind" IN ('refund', 'reversal')) = ("refund_of" IS NOT NULL))
+    `);
+    }
+    async down(queryRunner) {
+        await queryRunner.query(`
+      ALTER TABLE "mortar_economy_entries"
+        DROP CONSTRAINT "ck_economy_entries_kind",
+        DROP CONSTRAINT "ck_economy_entries_refund",
+        ADD CONSTRAINT "ck_economy_entries_kind"
+          CHECK ("kind" IN ('purchase', 'grant', 'spend', 'refund')),
+        ADD CONSTRAINT "ck_economy_entries_refund"
+          CHECK (("kind" = 'refund') = ("refund_of" IS NOT NULL))
+    `);
+    }
+}
+exports.AddReversals1791548064129 = AddReversals1791548064129;
+//# sourceMappingURL=1791548064129-AddReversals.js.map

package/dist/migrations/1791548064129-AddReversals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"1791548064129-AddReversals.js","sourceRoot":"","sources":["../../src/migrations/1791548064129-AddReversals.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACH,MAAa,yBAAyB;IACpC,IAAI,GAAG,2BAA2B,CAAC;IAEnC,KAAK,CAAC,EAAE,CAAC,WAAwB;QAC/B,MAAM,WAAW,CAAC,KAAK,CAAC;;;;;;;;KAQvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAwB;QACjC,MAAM,WAAW,CAAC,KAAK,CAAC;;;;;;;;KAQvB,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,8DA0BC"}

package/dist/nestjs/economy-views.d.ts

@@ -11,7 +11,7 @@ export interface EntryView {
     readonly balanceAfter: number;
     readonly reason: string;
     readonly reference: string | null;
-    /** For a refund, the purchase it gives back. */
+    /** For a refund or a reversal, the purchase it gives back. */
     readonly refundOf: string | null;
     readonly metadata: Record<string, unknown> | null;
     readonly occurredAt: Date;
@@ -35,4 +35,19 @@ export interface Reconciliation {
     readonly lots: number;
     readonly agrees: boolean;
 }
+/**
+ * A purchase reversed: the entry that took back what was left of it — none
+ * when nothing was — how much that was, and how much of the purchase the
+ * holder had spent already, which nothing can take back.
+ */
+export interface Reversal {
+    readonly entry: EntryView | null;
+    readonly taken: number;
+    readonly spent: number;
+    /**
+     * The refund or reversal that had given the purchase back before, under
+     * another key: nothing more is taken, and nothing is newly spent.
+     */
+    readonly earlier: EntryView | null;
+}
 //# sourceMappingURL=economy-views.d.ts.map

package/dist/nestjs/economy-views.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"economy-views.d.ts","sourceRoot":"","sources":["../../src/nestjs/economy-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B"}
+{"version":3,"file":"economy-views.d.ts","sourceRoot":"","sources":["../../src/nestjs/economy-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;CACpC"}

package/dist/nestjs/game-economy.service.d.ts

@@ -1,5 +1,5 @@
 import type { DataSource } from 'typeorm';
-import type { EntryView, LotView, Reconciliation } from './economy-views';
+import type { EntryView, LotView, Reconciliation, Reversal } from './economy-views';
 import type { GameEconomyOptions } from './game-economy-options.types';
 import type { MovementRequest, RefundRequest } from './movement-request.types';
 /**
@@ -37,6 +37,19 @@ export declare class GameEconomyService {
      * when it was refunded already, and `not_found` for one not the holder's.
      */
     refund(holderId: string, request: RefundRequest): Promise<EntryView>;
+    /**
+     * A purchase reversed: its money gone back another way — a refund made at
+     * the payment provider, a chargeback — and whatever of its currency is left
+     * taken back, which may be less than all of it, or nothing. Answers with
+     * what was taken and what the holder had spent of it already, which nothing
+     * takes back; the game decides what that costs them.
+     *
+     * A purchase given back before — refunded, or reversed under another key —
+     * takes nothing more, and the answer names that entry instead. The same key
+     * again answers as it did the first time. `not_found` for a purchase not the
+     * holder's.
+     */
+    reverse(holderId: string, request: RefundRequest): Promise<Reversal>;
     /** A holder's balance in a currency: nothing for one never credited. */
     balance(holderId: string, currency: string): Promise<number>;
     /** A page of a holder's entries in a currency, the newest first. */

package/dist/nestjs/game-economy.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-economy.service.d.ts","sourceRoot":"","sources":["../../src/nestjs/game-economy.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AASzD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAuB/E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAG3B,UAAU,EAAE,UAAU,EACvC,OAAO,EAAE,kBAAkB;IAU7B,+FAA+F;IACzF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3E,yEAAyE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9E;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IA+B3E;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAsC1E,wEAAwE;IAClE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,oEAAoE;IAC9D,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/D,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBrE,iHAAiH;IAC3G,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAoBlE;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAmB9D,MAAM;IA4BpB,wGAAwG;YAC1F,IAAI;IAclB;;;OAGG;YACW,OAAO;YAsBP,MAAM;YA+BN,IAAI;YAiBJ,UAAU;YAaV,QAAQ;YAmBR,KAAK;CAYpB"}
+{"version":3,"file":"game-economy.service.d.ts","sourceRoot":"","sources":["../../src/nestjs/game-economy.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AASzD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAuB/E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAG3B,UAAU,EAAE,UAAU,EACvC,OAAO,EAAE,kBAAkB;IAU7B,+FAA+F;IACzF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3E,yEAAyE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9E;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IA+B3E;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAsC1E;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgD1E,wEAAwE;IAClE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,oEAAoE;IAC9D,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/D,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBrE,iHAAiH;IAC3G,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAoBlE;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAmB9D,MAAM;IA4BpB,wGAAwG;YAC1F,IAAI;IAclB;;;OAGG;YACW,OAAO;YAsBP,MAAM;YA+BN,IAAI;YAiBJ,UAAU;YAaV,QAAQ;YAmBR,KAAK;CAYpB"}

package/dist/nestjs/game-economy.service.js

@@ -108,6 +108,52 @@ class GameEconomyService {
             return entry;
         });
     }
+    /**
+     * A purchase reversed: its money gone back another way — a refund made at
+     * the payment provider, a chargeback — and whatever of its currency is left
+     * taken back, which may be less than all of it, or nothing. Answers with
+     * what was taken and what the holder had spent of it already, which nothing
+     * takes back; the game decides what that costs them.
+     *
+     * A purchase given back before — refunded, or reversed under another key —
+     * takes nothing more, and the answer names that entry instead. The same key
+     * again answers as it did the first time. `not_found` for a purchase not the
+     * holder's.
+     */
+    async reverse(holderId, request) {
+        (0, check_request_1.checkRequest)(holderId, request);
+        if (!UUID.test(request.purchaseId))
+            throw new http_1.NotFoundError('Purchase', request.purchaseId);
+        return (0, database_1.runInTransaction)(this.dataSource, async (manager) => {
+            const found = await this.lotOf(manager, holderId, request.purchaseId);
+            if (!found || found.kind !== 'purchase') {
+                throw new http_1.NotFoundError('Purchase', request.purchaseId);
+            }
+            const balance = await this.lock(manager, holderId, found.currency);
+            const amount = (0, to_amount_1.toAmount)(found.amount);
+            const [keyed] = (await manager.query(`SELECT ${entry_view_of_1.ENTRY_COLUMNS} FROM "mortar_economy_entries"
+          WHERE "holder_id" = $1 AND "idempotency_key" = $2`, [holderId, request.idempotencyKey]));
+            if (keyed) {
+                const entry = (0, entry_view_of_1.entryViewOf)(keyed);
+                if (entry.kind !== 'reversal' || entry.refundOf !== found.entry_id) {
+                    throw new errors_1.LedgerKeyReusedError(request.idempotencyKey);
+                }
+                return { entry, taken: entry.amount, spent: amount - entry.amount, earlier: null };
+            }
+            const [given] = (await manager.query(`SELECT ${entry_view_of_1.ENTRY_COLUMNS} FROM "mortar_economy_entries" WHERE "refund_of" = $1`, [found.entry_id]));
+            if (given)
+                return { entry: null, taken: 0, spent: 0, earlier: (0, entry_view_of_1.entryViewOf)(given) };
+            // Read again under the lock: a spend may have drawn on it meanwhile.
+            const lot = (await this.lotOf(manager, holderId, request.purchaseId));
+            const remaining = (0, to_amount_1.toAmount)(lot.remaining);
+            if (remaining === 0)
+                return { entry: null, taken: 0, spent: amount, earlier: null };
+            const entry = await this.insert(manager, holderId, 'reversal', { ...request, currency: lot.currency, amount: remaining }, balance - remaining, lot.entry_id);
+            await this.draw(manager, entry.id, [{ lotId: lot.entry_id, amount: remaining }]);
+            await this.setBalance(manager, holderId, lot.currency, entry.balanceAfter);
+            return { entry, taken: remaining, spent: amount - remaining, earlier: null };
+        });
+    }
     /** A holder's balance in a currency: nothing for one never credited. */
     async balance(holderId, currency) {
         const [row] = (await (0, database_1.resolveManager)(this.dataSource).query(`SELECT "balance" FROM "mortar_economy_balances" WHERE "holder_id" = $1 AND "currency" = $2`, [holderId, currency]));

package/dist/nestjs/game-economy.service.js.map

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

package/dist/nestjs/index.d.ts

@@ -1,17 +1,18 @@
 import { CreateGameEconomy1791401023940 } from '../migrations/1791401023940-CreateGameEconomy';
+import { AddReversals1791548064129 } from '../migrations/1791548064129-AddReversals';
 import { EconomyBalance } from './economy-balance.entity';
 import { EconomyDraw } from './economy-draw.entity';
 import { EconomyEntry } from './economy-entry.entity';
 import { EconomyLot } from './economy-lot.entity';
 export { EconomyBalance, EconomyDraw, EconomyEntry, EconomyLot };
-export { CreateGameEconomy1791401023940 };
+export { AddReversals1791548064129, CreateGameEconomy1791401023940 };
 export { GameEconomyModule } from './game-economy.module';
 export { GameEconomyService } from './game-economy.service';
 export type { GameEconomyOptions } from './game-economy-options.types';
 export type { MovementRequest, RefundRequest } from './movement-request.types';
-export type { EntryView, LotView, Reconciliation } from './economy-views';
+export type { EntryView, LotView, Reconciliation, Reversal } from './economy-views';
 /** Register alongside the project's own entities. */
-export declare const gameEconomyEntities: (typeof EconomyBalance | typeof EconomyDraw | typeof EconomyEntry | typeof EconomyLot)[];
+export declare const gameEconomyEntities: (typeof EconomyEntry | typeof EconomyBalance | typeof EconomyLot | typeof EconomyDraw)[];
 /** Register alongside the project's own migrations. */
 export declare const gameEconomyMigrations: (typeof CreateGameEconomy1791401023940)[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1E,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,0FAA0D,CAAC;AAE3F,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,2CAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpF,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,0FAA0D,CAAC;AAE3F,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,2CAA8D,CAAC"}

package/dist/nestjs/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.gameEconomyMigrations = exports.gameEconomyEntities = exports.GameEconomyService = exports.GameEconomyModule = exports.CreateGameEconomy1791401023940 = exports.EconomyLot = exports.EconomyEntry = exports.EconomyDraw = exports.EconomyBalance = void 0;
+exports.gameEconomyMigrations = exports.gameEconomyEntities = exports.GameEconomyService = exports.GameEconomyModule = exports.CreateGameEconomy1791401023940 = exports.AddReversals1791548064129 = exports.EconomyLot = exports.EconomyEntry = exports.EconomyDraw = exports.EconomyBalance = void 0;
 const _1791401023940_CreateGameEconomy_1 = require("../migrations/1791401023940-CreateGameEconomy");
 Object.defineProperty(exports, "CreateGameEconomy1791401023940", { enumerable: true, get: function () { return _1791401023940_CreateGameEconomy_1.CreateGameEconomy1791401023940; } });
+const _1791548064129_AddReversals_1 = require("../migrations/1791548064129-AddReversals");
+Object.defineProperty(exports, "AddReversals1791548064129", { enumerable: true, get: function () { return _1791548064129_AddReversals_1.AddReversals1791548064129; } });
 const economy_balance_entity_1 = require("./economy-balance.entity");
 Object.defineProperty(exports, "EconomyBalance", { enumerable: true, get: function () { return economy_balance_entity_1.EconomyBalance; } });
 const economy_draw_entity_1 = require("./economy-draw.entity");
@@ -18,5 +20,5 @@ Object.defineProperty(exports, "GameEconomyService", { enumerable: true, get: fu
 /** Register alongside the project's own entities. */
 exports.gameEconomyEntities = [economy_entry_entity_1.EconomyEntry, economy_balance_entity_1.EconomyBalance, economy_lot_entity_1.EconomyLot, economy_draw_entity_1.EconomyDraw];
 /** Register alongside the project's own migrations. */
-exports.gameEconomyMigrations = [_1791401023940_CreateGameEconomy_1.CreateGameEconomy1791401023940];
+exports.gameEconomyMigrations = [_1791401023940_CreateGameEconomy_1.CreateGameEconomy1791401023940, _1791548064129_AddReversals_1.AddReversals1791548064129];
 //# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;AAAA,oGAA+F;AAOtF,+GAPA,iEAA8B,OAOA;AANvC,qEAA0D;AAKjD,+FALA,uCAAc,OAKA;AAJvB,+DAAoD;AAI3B,4FAJhB,iCAAW,OAIgB;AAHpC,iEAAsD;AAGhB,6FAH7B,mCAAY,OAG6B;AAFlD,6DAAkD;AAEE,2FAF3C,+BAAU,OAE2C;AAE9D,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAK3B,qDAAqD;AACxC,QAAA,mBAAmB,GAAG,CAAC,mCAAY,EAAE,uCAAc,EAAE,+BAAU,EAAE,iCAAW,CAAC,CAAC;AAE3F,uDAAuD;AAC1C,QAAA,qBAAqB,GAAG,CAAC,iEAA8B,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;AAAA,oGAA+F;AAQ3D,+GAR3B,iEAA8B,OAQ2B;AAPlE,0FAAqF;AAO5E,0GAPA,uDAAyB,OAOA;AANlC,qEAA0D;AAKjD,+FALA,uCAAc,OAKA;AAJvB,+DAAoD;AAI3B,4FAJhB,iCAAW,OAIgB;AAHpC,iEAAsD;AAGhB,6FAH7B,mCAAY,OAG6B;AAFlD,6DAAkD;AAEE,2FAF3C,+BAAU,OAE2C;AAE9D,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAK3B,qDAAqD;AACxC,QAAA,mBAAmB,GAAG,CAAC,mCAAY,EAAE,uCAAc,EAAE,+BAAU,EAAE,iCAAW,CAAC,CAAC;AAE3F,uDAAuD;AAC1C,QAAA,qBAAqB,GAAG,CAAC,iEAA8B,EAAE,uDAAyB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@birtalanrobert/game-economy",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "A game's premium currency as an append-only ledger: every purchase, grant, spend and refund, reconcilable to the last unit",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -38,7 +38,7 @@
   "type": "commonjs",
   "dependencies": {
     "@birtalanrobert/database": "^1.2.0",
-    "@birtalanrobert/http": "^2.0.0"
+    "@birtalanrobert/http": "^2.0.1"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",

package/src/kinds.ts

@@ -7,10 +7,13 @@
 export const CREDIT_KINDS = ['purchase', 'grant'] as const;
 
 /**
- * The two ways it leaves: **spent** in the game, or a purchase **refunded** —
- * its money handed back and its currency taken back with it.
+ * The ways it leaves: **spent** in the game; a purchase **refunded** — its
+ * money handed back and all its currency taken back with it; or a purchase
+ * **reversed** — its money gone back another way, a refund made at the
+ * payment provider or a chargeback, and whatever of its currency is left
+ * taken back.
  */
-export const DEBIT_KINDS = ['spend', 'refund'] as const;
+export const DEBIT_KINDS = ['spend', 'refund', 'reversal'] as const;
 
 export type CreditKind = (typeof CREDIT_KINDS)[number];
 export type DebitKind = (typeof DEBIT_KINDS)[number];

package/src/migrations/1791548064129-AddReversals.ts

@@ -0,0 +1,42 @@
+import type { MigrationInterface, QueryRunner } from 'typeorm';
+
+/**
+ * Adds the reversal: a purchase's currency taken back because its money went
+ * back another way — a refund made at the payment provider, a chargeback.
+ *
+ * A debit like a refund, and of the same purchase — so it carries
+ * `refund_of`, and the unique index on that column makes a purchase given
+ * back once, by a refund or by a reversal, whichever comes first. Unlike a
+ * refund it takes whatever of the purchase is left, which may be less than
+ * all of it.
+ *
+ * `down` restores the narrower checks, and so fails while any reversal is
+ * recorded: an append-only ledger is not narrowed by forgetting its entries.
+ */
+export class AddReversals1791548064129 implements MigrationInterface {
+  name = 'AddReversals1791548064129';
+
+  async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE "mortar_economy_entries"
+        DROP CONSTRAINT "ck_economy_entries_kind",
+        DROP CONSTRAINT "ck_economy_entries_refund",
+        ADD CONSTRAINT "ck_economy_entries_kind"
+          CHECK ("kind" IN ('purchase', 'grant', 'spend', 'refund', 'reversal')),
+        ADD CONSTRAINT "ck_economy_entries_refund"
+          CHECK (("kind" IN ('refund', 'reversal')) = ("refund_of" IS NOT NULL))
+    `);
+  }
+
+  async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE "mortar_economy_entries"
+        DROP CONSTRAINT "ck_economy_entries_kind",
+        DROP CONSTRAINT "ck_economy_entries_refund",
+        ADD CONSTRAINT "ck_economy_entries_kind"
+          CHECK ("kind" IN ('purchase', 'grant', 'spend', 'refund')),
+        ADD CONSTRAINT "ck_economy_entries_refund"
+          CHECK (("kind" = 'refund') = ("refund_of" IS NOT NULL))
+    `);
+  }
+}

package/src/nestjs/economy-views.ts

@@ -12,7 +12,7 @@ export interface EntryView {
   readonly balanceAfter: number;
   readonly reason: string;
   readonly reference: string | null;
-  /** For a refund, the purchase it gives back. */
+  /** For a refund or a reversal, the purchase it gives back. */
   readonly refundOf: string | null;
   readonly metadata: Record<string, unknown> | null;
   readonly occurredAt: Date;
@@ -38,3 +38,19 @@ export interface Reconciliation {
   readonly lots: number;
   readonly agrees: boolean;
 }
+
+/**
+ * A purchase reversed: the entry that took back what was left of it — none
+ * when nothing was — how much that was, and how much of the purchase the
+ * holder had spent already, which nothing can take back.
+ */
+export interface Reversal {
+  readonly entry: EntryView | null;
+  readonly taken: number;
+  readonly spent: number;
+  /**
+   * The refund or reversal that had given the purchase back before, under
+   * another key: nothing more is taken, and nothing is newly spent.
+   */
+  readonly earlier: EntryView | null;
+}

package/src/nestjs/game-economy.service.ts

@@ -9,7 +9,7 @@ import type { CreditKind, EntryKind } from '../kinds';
 import { isSpendOrder } from '../spend-order';
 import type { Draw, Lot } from '../types';
 import { checkRequest } from './check-request';
-import type { EntryView, LotView, Reconciliation } from './economy-views';
+import type { EntryView, LotView, Reconciliation, Reversal } from './economy-views';
 import { ENTRY_COLUMNS, entryViewOf, type EntryRow } from './entry-view-of';
 import type { GameEconomyOptions } from './game-economy-options.types';
 import type { MovementRequest, RefundRequest } from './movement-request.types';
@@ -154,6 +154,66 @@ export class GameEconomyService {
     });
   }
 
+  /**
+   * A purchase reversed: its money gone back another way — a refund made at
+   * the payment provider, a chargeback — and whatever of its currency is left
+   * taken back, which may be less than all of it, or nothing. Answers with
+   * what was taken and what the holder had spent of it already, which nothing
+   * takes back; the game decides what that costs them.
+   *
+   * A purchase given back before — refunded, or reversed under another key —
+   * takes nothing more, and the answer names that entry instead. The same key
+   * again answers as it did the first time. `not_found` for a purchase not the
+   * holder's.
+   */
+  async reverse(holderId: string, request: RefundRequest): Promise<Reversal> {
+    checkRequest(holderId, request);
+    if (!UUID.test(request.purchaseId)) throw new NotFoundError('Purchase', request.purchaseId);
+    return runInTransaction(this.dataSource, async (manager) => {
+      const found = await this.lotOf(manager, holderId, request.purchaseId);
+      if (!found || found.kind !== 'purchase') {
+        throw new NotFoundError('Purchase', request.purchaseId);
+      }
+      const balance = await this.lock(manager, holderId, found.currency);
+      const amount = toAmount(found.amount);
+
+      const [keyed] = (await manager.query(
+        `SELECT ${ENTRY_COLUMNS} FROM "mortar_economy_entries"
+          WHERE "holder_id" = $1 AND "idempotency_key" = $2`,
+        [holderId, request.idempotencyKey],
+      )) as EntryRow[];
+      if (keyed) {
+        const entry = entryViewOf(keyed);
+        if (entry.kind !== 'reversal' || entry.refundOf !== found.entry_id) {
+          throw new LedgerKeyReusedError(request.idempotencyKey);
+        }
+        return { entry, taken: entry.amount, spent: amount - entry.amount, earlier: null };
+      }
+
+      const [given] = (await manager.query(
+        `SELECT ${ENTRY_COLUMNS} FROM "mortar_economy_entries" WHERE "refund_of" = $1`,
+        [found.entry_id],
+      )) as EntryRow[];
+      if (given) return { entry: null, taken: 0, spent: 0, earlier: entryViewOf(given) };
+
+      // Read again under the lock: a spend may have drawn on it meanwhile.
+      const lot = (await this.lotOf(manager, holderId, request.purchaseId))!;
+      const remaining = toAmount(lot.remaining);
+      if (remaining === 0) return { entry: null, taken: 0, spent: amount, earlier: null };
+      const entry = await this.insert(
+        manager,
+        holderId,
+        'reversal',
+        { ...request, currency: lot.currency, amount: remaining },
+        balance - remaining,
+        lot.entry_id,
+      );
+      await this.draw(manager, entry.id, [{ lotId: lot.entry_id, amount: remaining }]);
+      await this.setBalance(manager, holderId, lot.currency, entry.balanceAfter);
+      return { entry, taken: remaining, spent: amount - remaining, earlier: null };
+    });
+  }
+
   /** A holder's balance in a currency: nothing for one never credited. */
   async balance(holderId: string, currency: string): Promise<number> {
     const [row] = (await resolveManager(this.dataSource).query(

package/src/nestjs/index.ts

@@ -1,19 +1,20 @@
 import { CreateGameEconomy1791401023940 } from '../migrations/1791401023940-CreateGameEconomy';
+import { AddReversals1791548064129 } from '../migrations/1791548064129-AddReversals';
 import { EconomyBalance } from './economy-balance.entity';
 import { EconomyDraw } from './economy-draw.entity';
 import { EconomyEntry } from './economy-entry.entity';
 import { EconomyLot } from './economy-lot.entity';
 
 export { EconomyBalance, EconomyDraw, EconomyEntry, EconomyLot };
-export { CreateGameEconomy1791401023940 };
+export { AddReversals1791548064129, CreateGameEconomy1791401023940 };
 export { GameEconomyModule } from './game-economy.module';
 export { GameEconomyService } from './game-economy.service';
 export type { GameEconomyOptions } from './game-economy-options.types';
 export type { MovementRequest, RefundRequest } from './movement-request.types';
-export type { EntryView, LotView, Reconciliation } from './economy-views';
+export type { EntryView, LotView, Reconciliation, Reversal } from './economy-views';
 
 /** Register alongside the project's own entities. */
 export const gameEconomyEntities = [EconomyEntry, EconomyBalance, EconomyLot, EconomyDraw];
 
 /** Register alongside the project's own migrations. */
-export const gameEconomyMigrations = [CreateGameEconomy1791401023940];
+export const gameEconomyMigrations = [CreateGameEconomy1791401023940, AddReversals1791548064129];