@owlmeans/server-payment 0.1.18-rc.2 → 0.1.18-rc.21

package/build/plugins/refunds.js

@@ -0,0 +1,80 @@
+import { STRIPE_PAYGATE_ALIAS } from '../consts.js';
+import { fulfillments, idOf, isMissingObject, subscriptions } from '../utils.js';
+/** A charge by id, or `null` when the paygate has none. */
+export const retrieveCharge = async (stripe, chargeId) => {
+    try {
+        return await stripe.charges.retrieve(chargeId);
+    }
+    catch (error) {
+        if (isMissingObject(error)) {
+            return null;
+        }
+        throw error;
+    }
+};
+const subscriptionOfInvoice = async (ctx, stripe, invoiceId) => {
+    const latest = await subscriptions(ctx).load({ paygate: STRIPE_PAYGATE_ALIAS, latestInvoiceId: invoiceId });
+    if (latest != null) {
+        return latest;
+    }
+    let invoice;
+    try {
+        invoice = await stripe.invoices.retrieve(invoiceId);
+    }
+    catch (error) {
+        if (isMissingObject(error)) {
+            return null;
+        }
+        throw error;
+    }
+    // `invoice.subscription` is top-level on the API version the client is pinned to.
+    const subscriptionId = idOf(invoice.subscription);
+    return subscriptionId != null
+        ? await subscriptions(ctx).byExternalId(subscriptionId, STRIPE_PAYGATE_ALIAS)
+        : null;
+};
+/**
+ * Resolve a refund or a dispute to the record it is about: by payment intent to a fulfillment;
+ * by charge to a fulfillment (stored charge, else the charge's payment intent — whose charge id is
+ * then remembered), else the charge's invoice; by invoice to the subscription whose latest invoice
+ * it is, else the invoice's subscription. `null` when nothing here paid for it.
+ */
+export const resolvePaymentTarget = async (ctx, stripe, ref) => {
+    const ledger = fulfillments(ctx);
+    let charge = ref.charge ?? null;
+    let paymentIntentId = ref.paymentIntentId;
+    const chargeId = ref.chargeId ?? charge?.id;
+    if (paymentIntentId != null) {
+        const record = await ledger.load({ paygate: STRIPE_PAYGATE_ALIAS, paymentIntentId });
+        if (record != null) {
+            return { kind: 'fulfillment', record, charge, paymentIntentId };
+        }
+    }
+    let invoiceId = ref.invoiceId;
+    if (chargeId != null) {
+        const record = await ledger.load({ paygate: STRIPE_PAYGATE_ALIAS, chargeId });
+        if (record != null) {
+            return { kind: 'fulfillment', record, charge, paymentIntentId: paymentIntentId ?? record.paymentIntentId };
+        }
+        charge = charge ?? await retrieveCharge(stripe, chargeId);
+        const chargeIntent = idOf(charge?.payment_intent);
+        if (chargeIntent != null && chargeIntent !== paymentIntentId) {
+            paymentIntentId = chargeIntent;
+            const byIntent = await ledger.load({ paygate: STRIPE_PAYGATE_ALIAS, paymentIntentId: chargeIntent });
+            if (byIntent != null) {
+                const record = byIntent.chargeId == null ? await ledger.update({ ...byIntent, chargeId }) : byIntent;
+                return { kind: 'fulfillment', record, charge, paymentIntentId: chargeIntent };
+            }
+        }
+        // `charge.invoice` is top-level on the API version the client is pinned to.
+        invoiceId = invoiceId ?? idOf(charge?.invoice);
+    }
+    if (invoiceId != null) {
+        const record = await subscriptionOfInvoice(ctx, stripe, invoiceId);
+        if (record != null) {
+            return { kind: 'subscription', record, charge, paymentIntentId, invoiceId };
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=refunds.js.map

package/build/plugins/refunds.js.map

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

package/build/plugins/stripe.d.ts

@@ -1,6 +1,8 @@
-import Stripe from 'stripe';
-import type { PaymentPlan, PaymentPlugin, PaymentProduct } from '../types.js';
-export declare const amountCheckoutLineItem: (product: PaymentProduct, plan: PaymentPlan, amountMinor: number) => {
+import type Stripe from 'stripe';
+import { TaxBehavior } from '@owlmeans/payment';
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { CheckoutPlugin, CreateLinkParams, PaymentPlan, PaymentProduct } from '../types.js';
+export declare const amountCheckoutLineItem: (product: PaymentProduct, plan: PaymentPlan, amountMinor: number, behavior?: TaxBehavior) => {
     lineItem: Stripe.Checkout.SessionCreateParams.LineItem;
     chargeMinor: number;
     currency: string;
@@ -10,5 +12,35 @@ export declare const quantityCheckoutLineItem: (price: Stripe.Price, policy: {
     maximum: number;
     default: number;
 }) => Stripe.Checkout.SessionCreateParams.LineItem;
-export declare const stripePlugin: PaymentPlugin;
+/** The plan an amount/quantity checkout of a consumable product sells: the named one, else the first. */
+export declare const consumablePlanOf: (ctx: ApiContext, productSku: string, planSku?: string) => Promise<{
+    product: PaymentProduct;
+    plan: PaymentPlan;
+}>;
+/**
+ * Stripe refuses `consent_collection.terms_of_service` while the account has no terms-of-service URL
+ * in its Dashboard (Settings → Public details): an `invalid_request_error` on the param
+ * `consent_collection[terms_of_service]` saying "You cannot collect consent to your terms of service
+ * unless a URL is set in the Stripe Dashboard …". Matched on the param with a terms message, or on
+ * the message alone; any other error type never matches.
+ */
+export declare const isMissingTermsUrl: (error: unknown) => boolean;
+/**
+ * A Stripe Checkout URL: an amount or quantity purchase of a consumable product, or a subscription
+ * to `planSku` (else the product's first recurring plan). A free plan is never checked out.
+ *
+ * With a consumer-rights policy: a locked billing country overrides the declared one (another is
+ * `BillingCountryLocked`); the charge currency is the profile's, else the region's; an amount
+ * checkout is narrowed by the checkout plugins (`CheckoutLimitExceeded`) and charged without FX
+ * when its policy currency is the charge currency; a subscription needs a fresh start request
+ * bound to its plan; the terms checkbox and the legal submit texts come from the copy.
+ */
+export declare const createCheckoutLink: (ctx: ApiContext, stripe: Stripe, params: CreateLinkParams, plugins?: readonly CheckoutPlugin[]) => Promise<string>;
+/**
+ * Verify a Stripe webhook against the configured override secret, then the managed endpoint's
+ * stored one, and dispatch it.
+ *
+ * @throws PaygateError('signature') | WebhookSetupError('secret')
+ */
+export declare const handleStripeWebhook: (ctx: ApiContext, stripe: Stripe, request: unknown) => Promise<void>;
 //# sourceMappingURL=stripe.d.ts.map

package/build/plugins/stripe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/plugins/stripe.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAS3B,OAAO,KAAK,EAAoB,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AA8D/F,eAAO,MAAM,sBAAsB,YACxB,cAAc,QAAQ,WAAW,eAAe,MAAM,KAC9D;IAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAejG,CAAA;AAED,eAAO,MAAM,wBAAwB,UAC5B,MAAM,CAAC,KAAK,UAAU;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACjF,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAIrC,CAAA;AAEF,eAAO,MAAM,YAAY,EAAE,aAoF1B,CAAA"}
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/plugins/stripe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,EAG8C,WAAW,EAC/D,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAejE,OAAO,KAAK,EACO,cAAc,EAAuB,gBAAgB,EAAE,WAAW,EAAE,cAAc,EACpG,MAAM,aAAa,CAAA;AAqGpB,eAAO,MAAM,sBAAsB,YACxB,cAAc,QAAQ,WAAW,eAAe,MAAM,aAAY,WAAW,KACrF;IAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAejG,CAAA;AAED,eAAO,MAAM,wBAAwB,UAC5B,MAAM,CAAC,KAAK,UAAU;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACjF,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,QAIrC,CAAA;AAEF,yGAAyG;AACzG,eAAO,MAAM,gBAAgB,QACtB,UAAU,cAAc,MAAM,YAAY,MAAM,KACpD,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAWxD,CAAA;AAuJD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,UAAW,OAAO,KAAG,OAelD,CAAA;AA+GD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QACxB,UAAU,UAAU,MAAM,UAAU,gBAAgB,YAAW,SAAS,cAAc,EAAE,KAC5F,OAAO,CAAC,MAAM,CAuKhB,CAAA;AAQD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAe,UAAU,UAAU,MAAM,WAAW,OAAO,KAAG,OAAO,CAAC,IAAI,CAwBzG,CAAA"}