@birtalanrobert/commerce 1.0.0 → 2.0.0

package/dist/nestjs/payment.entity.js

@@ -30,6 +30,15 @@ let Payment = class Payment extends database_1.BaseEntity {
     /** What it was for, as the owning product names it: `booking:<id>`. */
     subject;
     method;
+    /**
+     * What it was for.
+     *
+     * A tip belongs to the person who earned it and a product to neither the
+     * service nor the diary — a report counting all three as service income tells
+     * a business its haircuts are more profitable than they are, and no amount of
+     * arithmetic afterwards can separate them again.
+     */
+    kind;
     state;
     /** Minor units, and the currency it was taken in. Never a float. */
     amount;
@@ -75,6 +84,10 @@ __decorate([
     (0, typeorm_1.Column)('varchar', { length: 16 }),
     __metadata("design:type", String)
 ], Payment.prototype, "method", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 16, default: 'sale' }),
+    __metadata("design:type", String)
+], Payment.prototype, "kind", void 0);
 __decorate([
     (0, typeorm_1.Column)('varchar', { length: 24, default: 'pending' }),
     __metadata("design:type", String)

package/dist/nestjs/payment.entity.js.map

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

package/dist/nestjs/saved-card.entity.d.ts

@@ -0,0 +1,42 @@
+import { BaseEntity } from '@birtalanrobert/database';
+/**
+ * A card kept for later, with the words the customer agreed to.
+ *
+ * **The strongest thing a business can do about people not turning up, short of
+ * taking their money.** Nothing leaves the customer's account when they book;
+ * the card is simply there if a fee is later decided on — and the decision is
+ * still a human one made days afterwards, which is exactly when asking somebody
+ * to enter a card is a conversation that does not happen.
+ *
+ * A hold is not a substitute and must not be sold as one: providers expire an
+ * authorisation within days, and an appointment is usually further away.
+ *
+ * **The consent is stored as text, not as a flag.** A boolean records that
+ * somebody clicked; the sentence records what they were told they were agreeing
+ * to, which is the only thing worth anything when they say they were not.
+ */
+export declare class SavedCard extends BaseEntity {
+    tenantId: string;
+    /**
+     * Whose card it is, as the owning product names it: `customer:<id>`.
+     *
+     * No foreign key, for the same reason a payment has none — one product hangs
+     * a card off a salon's client, another off a tenant's guest.
+     */
+    subject: string;
+    provider: string;
+    /** The customer on *our* account, which is where a saved card can be used. */
+    customerRef: string;
+    paymentMethodRef: string;
+    /** Enough to recognise it — "Visa ending 4242" — and nothing more. */
+    brand: string | null;
+    last4: string | null;
+    expiryMonth: number | null;
+    expiryYear: number | null;
+    /** What they were told they were agreeing to, in the language they read it. */
+    consentText: string;
+    consentedAt: Date;
+    /** Who stored it, where a member of staff did it on somebody's behalf. */
+    storedBy: string | null;
+}
+//# sourceMappingURL=saved-card.entity.d.ts.map

package/dist/nestjs/saved-card.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-card.entity.d.ts","sourceRoot":"","sources":["../../src/nestjs/saved-card.entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,qBAGa,SAAU,SAAQ,UAAU;IAEvC,QAAQ,EAAG,MAAM,CAAC;IAElB;;;;;OAKG;IAEH,OAAO,EAAG,MAAM,CAAC;IAGjB,QAAQ,EAAG,MAAM,CAAC;IAElB,8EAA8E;IAE9E,WAAW,EAAG,MAAM,CAAC;IAGrB,gBAAgB,EAAG,MAAM,CAAC;IAE1B,sEAAsE;IAEtE,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAGtB,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAGtB,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IAG5B,UAAU,EAAG,MAAM,GAAG,IAAI,CAAC;IAE3B,+EAA+E;IAE/E,WAAW,EAAG,MAAM,CAAC;IAGrB,WAAW,EAAG,IAAI,CAAC;IAEnB,0EAA0E;IAE1E,QAAQ,EAAG,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/nestjs/saved-card.entity.js

@@ -0,0 +1,109 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SavedCard = void 0;
+const typeorm_1 = require("typeorm");
+const database_1 = require("@birtalanrobert/database");
+/**
+ * A card kept for later, with the words the customer agreed to.
+ *
+ * **The strongest thing a business can do about people not turning up, short of
+ * taking their money.** Nothing leaves the customer's account when they book;
+ * the card is simply there if a fee is later decided on — and the decision is
+ * still a human one made days afterwards, which is exactly when asking somebody
+ * to enter a card is a conversation that does not happen.
+ *
+ * A hold is not a substitute and must not be sold as one: providers expire an
+ * authorisation within days, and an appointment is usually further away.
+ *
+ * **The consent is stored as text, not as a flag.** A boolean records that
+ * somebody clicked; the sentence records what they were told they were agreeing
+ * to, which is the only thing worth anything when they say they were not.
+ */
+let SavedCard = class SavedCard extends database_1.BaseEntity {
+    tenantId;
+    /**
+     * Whose card it is, as the owning product names it: `customer:<id>`.
+     *
+     * No foreign key, for the same reason a payment has none — one product hangs
+     * a card off a salon's client, another off a tenant's guest.
+     */
+    subject;
+    provider;
+    /** The customer on *our* account, which is where a saved card can be used. */
+    customerRef;
+    paymentMethodRef;
+    /** Enough to recognise it — "Visa ending 4242" — and nothing more. */
+    brand;
+    last4;
+    expiryMonth;
+    expiryYear;
+    /** What they were told they were agreeing to, in the language they read it. */
+    consentText;
+    consentedAt;
+    /** Who stored it, where a member of staff did it on somebody's behalf. */
+    storedBy;
+};
+exports.SavedCard = SavedCard;
+__decorate([
+    (0, typeorm_1.Column)('uuid'),
+    __metadata("design:type", String)
+], SavedCard.prototype, "tenantId", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 160 }),
+    __metadata("design:type", String)
+], SavedCard.prototype, "subject", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 32 }),
+    __metadata("design:type", String)
+], SavedCard.prototype, "provider", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 128 }),
+    __metadata("design:type", String)
+], SavedCard.prototype, "customerRef", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 128 }),
+    __metadata("design:type", String)
+], SavedCard.prototype, "paymentMethodRef", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 24, nullable: true }),
+    __metadata("design:type", Object)
+], SavedCard.prototype, "brand", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 4, nullable: true }),
+    __metadata("design:type", Object)
+], SavedCard.prototype, "last4", void 0);
+__decorate([
+    (0, typeorm_1.Column)('int', { name: 'expiry_month', nullable: true }),
+    __metadata("design:type", Object)
+], SavedCard.prototype, "expiryMonth", void 0);
+__decorate([
+    (0, typeorm_1.Column)('int', { name: 'expiry_year', nullable: true }),
+    __metadata("design:type", Object)
+], SavedCard.prototype, "expiryYear", void 0);
+__decorate([
+    (0, typeorm_1.Column)('varchar', { length: 1000 }),
+    __metadata("design:type", String)
+], SavedCard.prototype, "consentText", void 0);
+__decorate([
+    (0, typeorm_1.Column)('timestamptz'),
+    __metadata("design:type", Date)
+], SavedCard.prototype, "consentedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)('uuid', { nullable: true }),
+    __metadata("design:type", Object)
+], SavedCard.prototype, "storedBy", void 0);
+exports.SavedCard = SavedCard = __decorate([
+    (0, typeorm_1.Entity)('mortar_saved_cards'),
+    (0, typeorm_1.Unique)('uq_saved_cards_tenant_id', ['tenantId', 'id']),
+    (0, typeorm_1.Index)('ix_saved_cards_subject', ['tenantId', 'subject'])
+], SavedCard);
+//# sourceMappingURL=saved-card.entity.js.map

package/dist/nestjs/saved-card.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-card.entity.js","sourceRoot":"","sources":["../../src/nestjs/saved-card.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAwD;AACxD,uDAAsD;AAEtD;;;;;;;;;;;;;;;GAeG;AAII,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,qBAAU;IAEvC,QAAQ,CAAU;IAElB;;;;;OAKG;IAEH,OAAO,CAAU;IAGjB,QAAQ,CAAU;IAElB,8EAA8E;IAE9E,WAAW,CAAU;IAGrB,gBAAgB,CAAU;IAE1B,sEAAsE;IAEtE,KAAK,CAAiB;IAGtB,KAAK,CAAiB;IAGtB,WAAW,CAAiB;IAG5B,UAAU,CAAiB;IAE3B,+EAA+E;IAE/E,WAAW,CAAU;IAGrB,WAAW,CAAQ;IAEnB,0EAA0E;IAE1E,QAAQ,CAAiB;CAC1B,CAAA;AA9CY,8BAAS;AAEpB;IADC,IAAA,gBAAM,EAAC,MAAM,CAAC;;2CACG;AASlB;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;0CAClB;AAGjB;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;2CAChB;AAIlB;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;8CACd;AAGrB;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;mDACT;AAI1B;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCAC5B;AAGtB;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCAC3B;AAGtB;IADC,IAAA,gBAAM,EAAC,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CAC5B;AAG5B;IADC,IAAA,gBAAM,EAAC,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;6CAC5B;AAI3B;IADC,IAAA,gBAAM,EAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;;8CACf;AAGrB;IADC,IAAA,gBAAM,EAAC,aAAa,CAAC;8BACR,IAAI;8CAAC;AAInB;IADC,IAAA,gBAAM,EAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2CACV;oBA7Cd,SAAS;IAHrB,IAAA,gBAAM,EAAC,oBAAoB,CAAC;IAC5B,IAAA,gBAAM,EAAC,0BAA0B,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACtD,IAAA,eAAK,EAAC,wBAAwB,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;GAC5C,SAAS,CA8CrB"}

package/dist/payments.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Where a payment is, and what may still be done to it.
+ *
+ * Pure and dependency-free, because a console renders a refund button from
+ * exactly the rule the server enforces — and a screen that offers a refund the
+ * server will refuse is a screen that teaches its user not to trust it.
+ */
+/**
+ * How the money arrived.
+ *
+ * `card` is the only one this package processes. The rest are **recorded, not
+ * taken** — and recording them is not a lesser feature: a salon is mostly cash
+ * at the counter, a restaurant's till takes meal vouchers, and a box office
+ * takes notes. A report that only counts what a provider processed tells a
+ * business a fraction of its own takings, which is worse than telling it
+ * nothing because it looks complete.
+ */
+export type PaymentMethod = 'card' | 'cash' | 'terminal' | 'voucher' | 'transfer';
+/**
+ * Where a payment is.
+ *
+ * `authorized` is separate from `captured` on purpose: a card held against a
+ * no-show fee is authorised and never captured unless the fee is applied, and
+ * that decision is a human one.
+ */
+export type PaymentState = 'pending' | 'authorized' | 'captured' | 'failed' | 'refunded' | 'partially_refunded' | 'cancelled';
+/**
+ * What a payment was for.
+ *
+ * Not decoration: a tip belongs to the person who earned it and a product to
+ * neither the service nor the diary, so a revenue report that counts all three
+ * as service income tells a business its haircuts are more profitable than they
+ * are. The distinction has to survive into the row, because it cannot be
+ * recovered from an amount afterwards.
+ */
+export type PaymentKind = 'sale' | 'deposit' | 'fee' | 'tip' | 'product';
+/**
+ * Whether money actually moved, and so can be given back.
+ *
+ * A held card has taken nothing yet — releasing it is a different operation
+ * with a different name — and a failed charge never will. Both look refundable
+ * to anyone reasoning from "there is a payment row here", which is why this is
+ * one function and not a condition written twice.
+ */
+export declare const isRefundable: (state: PaymentState) => boolean;
+/**
+ * What is left to give back, in minor units.
+ *
+ * Takes the two amounts rather than a row, because they arrive as strings from
+ * a `bigint` column in one caller and as numbers in another, and the subtraction
+ * should not be where that difference is discovered.
+ */
+export declare const refundableAmount: (amount: number, refunded: number) => number;
+//# sourceMappingURL=payments.d.ts.map

package/dist/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,UAAU,GACV,oBAAoB,GACpB,WAAW,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,KAAG,OACK,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,MACpC,CAAC"}

package/dist/payments.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Where a payment is, and what may still be done to it.
+ *
+ * Pure and dependency-free, because a console renders a refund button from
+ * exactly the rule the server enforces — and a screen that offers a refund the
+ * server will refuse is a screen that teaches its user not to trust it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refundableAmount = exports.isRefundable = void 0;
+/**
+ * Whether money actually moved, and so can be given back.
+ *
+ * A held card has taken nothing yet — releasing it is a different operation
+ * with a different name — and a failed charge never will. Both look refundable
+ * to anyone reasoning from "there is a payment row here", which is why this is
+ * one function and not a condition written twice.
+ */
+const isRefundable = (state) => state === 'captured' || state === 'partially_refunded';
+exports.isRefundable = isRefundable;
+/**
+ * What is left to give back, in minor units.
+ *
+ * Takes the two amounts rather than a row, because they arrive as strings from
+ * a `bigint` column in one caller and as numbers in another, and the subtraction
+ * should not be where that difference is discovered.
+ */
+const refundableAmount = (amount, refunded) => Math.max(0, amount - refunded);
+exports.refundableAmount = refundableAmount;
+//# sourceMappingURL=payments.js.map

package/dist/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAyCH;;;;;;;GAOG;AACI,MAAM,YAAY,GAAG,CAAC,KAAmB,EAAW,EAAE,CAC3D,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,oBAAoB,CAAC;AAD5C,QAAA,YAAY,gBACgC;AAEzD;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAU,EAAE,CAC3E,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;AADpB,QAAA,gBAAgB,oBACI"}

package/dist/providers/port.d.ts

@@ -25,6 +25,20 @@ export interface OnboardingLink {
 export interface ChargeRequest {
     /** The business being paid, as the provider knows it. */
     readonly account: string;
+    /**
+     * The customer, where one is being charged again rather than for the first
+     * time. Held on *our* account rather than the business's, because that is
+     * where a saved card lives under a destination charge.
+     */
+    readonly customer?: string;
+    /**
+     * A card already saved, to charge without anybody present.
+     *
+     * The whole point of storing one: a no-show fee is decided days later, and
+     * asking somebody who did not turn up to enter a card is a conversation that
+     * does not happen.
+     */
+    readonly paymentMethod?: string;
     readonly amount: number;
     readonly currency: string;
     /** Our cut, taken on top rather than out of the business's money. */
@@ -53,9 +67,44 @@ export interface ChargeResult {
      * failure and must not be handled as one.
      */
     readonly redirectUrl?: string;
+    /**
+     * What the browser needs to finish paying, when the customer is present.
+     *
+     * A charge created on the server has no card attached to it yet — the card is
+     * entered in a browser, against the provider's own script, so that the number
+     * never reaches us. Without this the payment can be created and never paid,
+     * which is the state a customer reads as "it took my booking and lost my
+     * money".
+     */
+    readonly clientSecret?: string;
     readonly instrument?: string;
     readonly detail?: string;
 }
+/** A card being stored for later, rather than charged now. */
+export interface SaveCardRequest {
+    /** An existing customer to attach it to, where the person already has one. */
+    readonly customer?: string;
+    /** What it is being saved for, carried through for matching a webhook back. */
+    readonly subject: string;
+    readonly reference: string;
+}
+export interface SaveCardResult {
+    /** The customer the card will hang off, created here if there was none. */
+    readonly customer: string;
+    /** The provider's handle on this attempt, to read the result back from. */
+    readonly externalId: string;
+    /** What the browser confirms against. */
+    readonly clientSecret: string;
+}
+/** A card that was actually stored, read back after the browser confirmed it. */
+export interface StoredCard {
+    readonly customer: string;
+    readonly paymentMethod: string;
+    readonly brand?: string;
+    readonly last4?: string;
+    readonly expiryMonth?: number;
+    readonly expiryYear?: number;
+}
 export interface RefundRequest {
     readonly externalId: string;
     readonly amount: number;
@@ -82,6 +131,25 @@ export interface PaymentProvider {
     capture(externalId: string, amount?: number): Promise<ChargeResult>;
     /** Releases a hold without taking anything. */
     release(externalId: string): Promise<void>;
+    /**
+     * Starts storing a card without charging it.
+     *
+     * The strongest thing a business can do about no-shows short of taking money:
+     * nothing leaves the customer's account, and the card is there if a fee is
+     * later decided on. A hold is not a substitute — providers expire one within
+     * days, and an appointment is usually further away than that.
+     */
+    saveCard(request: SaveCardRequest): Promise<SaveCardResult>;
+    /**
+     * What was actually stored, once the browser says it finished.
+     *
+     * Read back from the provider rather than believed from the browser: what a
+     * page reports is what a page was told to report, and a saved card is
+     * something a business will later charge money against.
+     */
+    storedCard(externalId: string): Promise<StoredCard | undefined>;
+    /** Forgets a stored card, at the customer's request or the business's. */
+    forgetCard(paymentMethod: string): Promise<void>;
     refund(request: RefundRequest): Promise<{
         externalId: string;
     }>;

package/dist/providers/port.d.ts.map

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

package/dist/providers/stripe.d.ts

@@ -1,5 +1,5 @@
 import Stripe from 'stripe';
-import type { ChargeRequest, ChargeResult, OnboardingLink, PaymentProvider, ProviderAccount, ProviderEvent, RefundRequest } from './port';
+import type { ChargeRequest, ChargeResult, OnboardingLink, PaymentProvider, ProviderAccount, ProviderEvent, RefundRequest, SaveCardRequest, SaveCardResult, StoredCard } from './port';
 export interface StripeConnectOptions {
     secretKey: string;
     /** The endpoint's signing secret, as the dashboard gives it: `whsec_…`. */
@@ -31,6 +31,17 @@ export declare class StripeConnect implements PaymentProvider {
     charge(request: ChargeRequest): Promise<ChargeResult>;
     capture(externalId: string, amount?: number): Promise<ChargeResult>;
     release(externalId: string): Promise<void>;
+    /**
+     * Starts storing a card without charging it.
+     *
+     * The customer is created on **our** account rather than the business's. That
+     * is not a preference: under a destination charge the money lands on the
+     * business's account while the card is ours to charge, and a customer created
+     * on the business's account cannot be used from here at all.
+     */
+    saveCard(request: SaveCardRequest): Promise<SaveCardResult>;
+    storedCard(externalId: string): Promise<StoredCard | undefined>;
+    forgetCard(paymentMethod: string): Promise<void>;
     refund(request: RefundRequest): Promise<{
         externalId: string;
     }>;

package/dist/providers/stripe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/providers/stripe.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,eAAe;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEH,OAAO,EAAE,oBAAoB;IAIpD,OAAO,CACX,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IAarB,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IAkBpB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiCrD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAanE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAarE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS;CAoB3F"}
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/providers/stripe.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,eAAe;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEH,OAAO,EAAE,oBAAoB;IAIpD,OAAO,CACX,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IAarB,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IAkBpB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsDrD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAanE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;;;;;OAOG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA4B3D,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAwB/D,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAarE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS;CAoB3F"}

package/dist/providers/stripe.js

@@ -70,10 +70,31 @@ class StripeConnect {
                 ...(request.applicationFee > 0 ? { application_fee_amount: request.applicationFee } : {}),
                 capture_method: request.capture ? 'automatic' : 'manual',
                 ...(request.description ? { description: request.description } : {}),
+                ...(request.customer ? { customer: request.customer } : {}),
+                /*
+                 * A stored card is confirmed here and now, with nobody present.
+                 *
+                 * `off_session` is what tells the network the customer is not sitting
+                 * there — it is also what makes the bank decline rather than ask for
+                 * a code it has nobody to ask, which is the honest outcome for a fee
+                 * charged three days after an appointment.
+                 */
+                ...(request.paymentMethod
+                    ? {
+                        payment_method: request.paymentMethod,
+                        confirm: true,
+                        off_session: true,
+                    }
+                    : {}),
                 // Carried through so a webhook can be matched back to what it paid
                 // for without a lookup table of our own.
                 metadata: { subject: request.subject },
-                automatic_payment_methods: { enabled: true },
+                /*
+                 * Only where a card still has to be entered. Offering a redirect
+                 * method to a charge that is already confirmed against a stored card
+                 * is a contradiction the provider rejects.
+                 */
+                ...(request.paymentMethod ? {} : { automatic_payment_methods: { enabled: true } }),
             }, 
             // The provider's own idempotency, so a retried request — a timeout, a
             // double submit — does not charge somebody twice.
@@ -96,6 +117,54 @@ class StripeConnect {
     async release(externalId) {
         await this.stripe.paymentIntents.cancel(externalId);
     }
+    /**
+     * Starts storing a card without charging it.
+     *
+     * The customer is created on **our** account rather than the business's. That
+     * is not a preference: under a destination charge the money lands on the
+     * business's account while the card is ours to charge, and a customer created
+     * on the business's account cannot be used from here at all.
+     */
+    async saveCard(request) {
+        const customer = request.customer ??
+            (await this.stripe.customers.create({ metadata: { subject: request.subject } }, { idempotencyKey: `customer-${request.reference}` })).id;
+        const intent = await this.stripe.setupIntents.create({
+            customer,
+            usage: 'off_session',
+            payment_method_types: ['card'],
+            metadata: { subject: request.subject },
+        }, { idempotencyKey: request.reference });
+        return {
+            customer,
+            externalId: intent.id,
+            // Non-null because a setup intent is created precisely to be confirmed.
+            clientSecret: intent.client_secret ?? '',
+        };
+    }
+    async storedCard(externalId) {
+        const intent = await this.stripe.setupIntents.retrieve(externalId, {
+            expand: ['payment_method'],
+        });
+        const method = intent.payment_method;
+        if (!method || typeof method === 'string' || !intent.customer)
+            return undefined;
+        const customer = typeof intent.customer === 'string' ? intent.customer : intent.customer.id;
+        return {
+            customer,
+            paymentMethod: method.id,
+            ...(method.card
+                ? {
+                    brand: method.card.brand,
+                    last4: method.card.last4,
+                    expiryMonth: method.card.exp_month,
+                    expiryYear: method.card.exp_year,
+                }
+                : {}),
+        };
+    }
+    async forgetCard(paymentMethod) {
+        await this.stripe.paymentMethods.detach(paymentMethod);
+    }
     async refund(request) {
         const refund = await this.stripe.refunds.create({
             payment_intent: request.externalId,
@@ -160,6 +229,7 @@ function interpretIntent(intent) {
     return {
         externalId: intent.id,
         state,
+        ...(intent.client_secret ? { clientSecret: intent.client_secret } : {}),
         ...(intent.next_action?.redirect_to_url?.url
             ? { redirectUrl: intent.next_action.redirect_to_url.url }
             : {}),

package/dist/providers/stripe.js.map

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

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@birtalanrobert/commerce",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Taking money on a business's behalf: payout onboarding, payments, refunds and the record of both",
   "license": "AGPL-3.0-only",
   "author": "Robert Birtalan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/birtalanrobert/mortar.git",
+    "directory": "packages/commerce"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "commonjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,11 +39,11 @@
   ],
   "dependencies": {
     "stripe": "^22.6.0",
-    "@birtalanrobert/context": "^1.1.0",
-    "@birtalanrobert/money": "^1.0.0",
     "@birtalanrobert/database": "^1.0.0",
+    "@birtalanrobert/context": "^1.1.0",
+    "@birtalanrobert/http": "^2.0.0",
     "@birtalanrobert/tenancy": "^1.1.0",
-    "@birtalanrobert/http": "^2.0.0"
+    "@birtalanrobert/money": "^1.0.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",

package/src/index.ts

@@ -27,6 +27,14 @@ export {
   type PayoutStatus,
 } from './deposits';
 
+export {
+  isRefundable,
+  refundableAmount,
+  type PaymentKind,
+  type PaymentMethod,
+  type PaymentState,
+} from './payments';
+
 export type {
   ChargeRequest,
   ChargeResult,
@@ -35,6 +43,9 @@ export type {
   ProviderAccount,
   ProviderEvent,
   RefundRequest,
+  SaveCardRequest,
+  SaveCardResult,
+  StoredCard,
 } from './providers/port';
 
 export { StripeConnect, type StripeConnectOptions } from './providers/stripe';