@shware/purchase 7.3.0 → 7.6.0

package/dist/stripe/payment-method.d.mts

@@ -0,0 +1,22 @@
+import { Stripe } from "stripe";
+//#region src/stripe/payment-method.d.ts
+/**
+ * Reusable payment methods whose outcome arrives days after the charge is attempted: Stripe's
+ * "payment methods with delayed notification" (https://docs.stripe.com/payments/payment-methods#payment-notification).
+ * A charge to one sits in `processing` until the bank answers, and can still fail then.
+ *
+ * Only types that can be saved and charged again (a subscription's or customer's default) are
+ * listed: the bank debits. One-off vouchers and transfers (Boleto, OXXO, Konbini, bank transfers)
+ * also notify late, but never come back as a saved payment method. A deny-list, so instant methods
+ * (cards, wallets, Link, PayPal, ...) need no entry; a delayed type Stripe adds later has to be
+ * added here.
+ */
+export declare const DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES: ReadonlySet<Stripe.PaymentMethod.Type>;
+/**
+ * Whether a charge to this payment method type is only known to have succeeded days later. Flows
+ * that need the money now (a Stripe pending update, which supports no such method and expires
+ * after ~23 hours) should refuse it up front rather than report a late failure.
+ */
+export declare function hasDelayedNotification(type: Stripe.PaymentMethod.Type): boolean;
+//#endregion
+//# sourceMappingURL=payment-method.d.mts.map

package/dist/stripe/payment-method.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-method.d.mts","names":[],"sources":["../../src/stripe/payment-method.ts"],"mappings":";;;;;;;;;;;;;qBAaa,2CAA2C,YAAY,OAAO,cAAc;;;;;;wBAezE,uBAAuB,MAAM,OAAO,cAAc"}

package/dist/stripe/payment-method.mjs

@@ -0,0 +1,32 @@
+//#region src/stripe/payment-method.ts
+/**
+* Reusable payment methods whose outcome arrives days after the charge is attempted: Stripe's
+* "payment methods with delayed notification" (https://docs.stripe.com/payments/payment-methods#payment-notification).
+* A charge to one sits in `processing` until the bank answers, and can still fail then.
+*
+* Only types that can be saved and charged again (a subscription's or customer's default) are
+* listed: the bank debits. One-off vouchers and transfers (Boleto, OXXO, Konbini, bank transfers)
+* also notify late, but never come back as a saved payment method. A deny-list, so instant methods
+* (cards, wallets, Link, PayPal, ...) need no entry; a delayed type Stripe adds later has to be
+* added here.
+*/
+const DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES = /* @__PURE__ */ new Set([
+	"sepa_debit",
+	"us_bank_account",
+	"bacs_debit",
+	"au_becs_debit",
+	"acss_debit",
+	"nz_bank_account"
+]);
+/**
+* Whether a charge to this payment method type is only known to have succeeded days later. Flows
+* that need the money now (a Stripe pending update, which supports no such method and expires
+* after ~23 hours) should refuse it up front rather than report a late failure.
+*/
+function hasDelayedNotification(type) {
+	return DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES.has(type);
+}
+//#endregion
+export { DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES, hasDelayedNotification };
+
+//# sourceMappingURL=payment-method.mjs.map

package/dist/stripe/payment-method.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-method.mjs","names":[],"sources":["../../src/stripe/payment-method.ts"],"sourcesContent":["import type { Stripe } from 'stripe';\n\n/**\n * Reusable payment methods whose outcome arrives days after the charge is attempted: Stripe's\n * \"payment methods with delayed notification\" (https://docs.stripe.com/payments/payment-methods#payment-notification).\n * A charge to one sits in `processing` until the bank answers, and can still fail then.\n *\n * Only types that can be saved and charged again (a subscription's or customer's default) are\n * listed: the bank debits. One-off vouchers and transfers (Boleto, OXXO, Konbini, bank transfers)\n * also notify late, but never come back as a saved payment method. A deny-list, so instant methods\n * (cards, wallets, Link, PayPal, ...) need no entry; a delayed type Stripe adds later has to be\n * added here.\n */\nexport const DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES: ReadonlySet<Stripe.PaymentMethod.Type> =\n  new Set([\n    'sepa_debit',\n    'us_bank_account',\n    'bacs_debit',\n    'au_becs_debit',\n    'acss_debit',\n    'nz_bank_account',\n  ]);\n\n/**\n * Whether a charge to this payment method type is only known to have succeeded days later. Flows\n * that need the money now (a Stripe pending update, which supports no such method and expires\n * after ~23 hours) should refuse it up front rather than report a late failure.\n */\nexport function hasDelayedNotification(type: Stripe.PaymentMethod.Type): boolean {\n  return DELAYED_NOTIFICATION_PAYMENT_METHOD_TYPES.has(type);\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,4DACX,IAAI,IAAI;CACN;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOH,SAAgB,uBAAuB,MAA0C;CAC/E,OAAO,0CAA0C,IAAI,IAAI;AAC3D"}

package/dist/stripe/subscription.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_stripe_mapper = require("./mapper.cjs");
+//#region src/stripe/subscription.ts
+/**
+* The plan's list price, which is what "$X / month" promises. The latest invoice is deliberately
+* not used: after an upgrade it is the prorated difference, and after a coupon the discounted
+* amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or
+* custom-amount price, which has no flat unit amount.
+*/
+function mapListPrice({ items }) {
+	const item = items.data.at(0);
+	const price = item?.price;
+	if (!price || price.unit_amount === null) return null;
+	return require_stripe_mapper.money(price.unit_amount * (item.quantity ?? 1), price.currency);
+}
+function mapSubscription(sub) {
+	const periodEnd = sub.items.data.at(0)?.current_period_end ?? null;
+	return {
+		status: require_stripe_mapper.mapSubscriptionStatus(sub.status),
+		autoRenewEnabled: sub.status !== "canceled" && !sub.cancel_at_period_end && sub.cancel_at === null,
+		price: mapListPrice(sub),
+		startedAt: require_stripe_mapper.mapTime(sub.start_date),
+		createdAt: require_stripe_mapper.mapTime(sub.created),
+		renewalAt: sub.status === "paused" ? null : require_stripe_mapper.mapTime(periodEnd),
+		trialStart: require_stripe_mapper.mapTime(sub.trial_start),
+		trialEnd: require_stripe_mapper.mapTime(sub.trial_end),
+		canceledAt: require_stripe_mapper.mapTime(sub.canceled_at),
+		cancellationDetails: require_stripe_mapper.mapCancellationDetails(sub)
+	};
+}
+//#endregion
+exports.mapListPrice = mapListPrice;
+exports.mapSubscription = mapSubscription;
+
+//# sourceMappingURL=subscription.cjs.map

package/dist/stripe/subscription.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.cjs","names":["money","mapSubscriptionStatus","mapTime","mapCancellationDetails"],"sources":["../../src/stripe/subscription.ts"],"sourcesContent":["import type { Stripe } from 'stripe';\nimport type { CancellationDetails, SubscriptionStatus } from '../subscription/index';\nimport {\n  type Money,\n  mapCancellationDetails,\n  mapSubscriptionStatus,\n  mapTime,\n  money,\n} from './mapper';\n\n/**\n * A Stripe subscription in the platform-neutral shape a subscription row stores. What it leaves out\n * is the app's: who the user is and which plan the product means (both from the subscription's\n * metadata and the app's config), the row id, and when the row was written.\n */\nexport interface StripeSubscriptionState {\n  status: SubscriptionStatus;\n  autoRenewEnabled: boolean;\n  /** see {@link mapListPrice}; null for a price without a flat amount */\n  price: Money | null;\n  startedAt: string;\n  createdAt: string;\n  /** null while paused: a paused subscription has no date it comes back on */\n  renewalAt: string | null;\n  trialStart: string | null;\n  trialEnd: string | null;\n  canceledAt: string | null;\n  cancellationDetails: CancellationDetails | null;\n}\n\n/**\n * The plan's list price, which is what \"$X / month\" promises. The latest invoice is deliberately\n * not used: after an upgrade it is the prorated difference, and after a coupon the discounted\n * amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or\n * custom-amount price, which has no flat unit amount.\n */\nexport function mapListPrice({ items }: Pick<Stripe.Subscription, 'items'>): Money | null {\n  const item = items.data.at(0);\n  const price = item?.price;\n  if (!price || price.unit_amount === null) return null;\n  return money(price.unit_amount * (item.quantity ?? 1), price.currency);\n}\n\nexport function mapSubscription(sub: Stripe.Subscription): StripeSubscriptionState {\n  const periodEnd = sub.items.data.at(0)?.current_period_end ?? null;\n  return {\n    status: mapSubscriptionStatus(sub.status),\n    autoRenewEnabled:\n      sub.status !== 'canceled' && !sub.cancel_at_period_end && sub.cancel_at === null,\n    price: mapListPrice(sub),\n    startedAt: mapTime(sub.start_date),\n    createdAt: mapTime(sub.created),\n    // A paused subscription (trial ended without a card, failed payment, or an explicit pause;\n    // `status_details.paused` says which) stays paused until it is resumed, so the period end it\n    // still reports is not a renewal.\n    renewalAt: sub.status === 'paused' ? null : mapTime(periodEnd),\n    trialStart: mapTime(sub.trial_start),\n    trialEnd: mapTime(sub.trial_end),\n    canceledAt: mapTime(sub.canceled_at),\n    cancellationDetails: mapCancellationDetails(sub),\n  };\n}\n"],"mappings":";;;;;;;;;AAoCA,SAAgB,aAAa,EAAE,SAA2D;CACxF,MAAM,OAAO,MAAM,KAAK,GAAG,CAAC;CAC5B,MAAM,QAAQ,MAAM;CACpB,IAAI,CAAC,SAAS,MAAM,gBAAgB,MAAM,OAAO;CACjD,OAAOA,sBAAAA,MAAM,MAAM,eAAe,KAAK,YAAY,IAAI,MAAM,QAAQ;AACvE;AAEA,SAAgB,gBAAgB,KAAmD;CACjF,MAAM,YAAY,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,sBAAsB;CAC9D,OAAO;EACL,QAAQC,sBAAAA,sBAAsB,IAAI,MAAM;EACxC,kBACE,IAAI,WAAW,cAAc,CAAC,IAAI,wBAAwB,IAAI,cAAc;EAC9E,OAAO,aAAa,GAAG;EACvB,WAAWC,sBAAAA,QAAQ,IAAI,UAAU;EACjC,WAAWA,sBAAAA,QAAQ,IAAI,OAAO;EAI9B,WAAW,IAAI,WAAW,WAAW,OAAOA,sBAAAA,QAAQ,SAAS;EAC7D,YAAYA,sBAAAA,QAAQ,IAAI,WAAW;EACnC,UAAUA,sBAAAA,QAAQ,IAAI,SAAS;EAC/B,YAAYA,sBAAAA,QAAQ,IAAI,WAAW;EACnC,qBAAqBC,sBAAAA,uBAAuB,GAAG;CACjD;AACF"}

package/dist/stripe/subscription.d.cts

@@ -0,0 +1,33 @@
+import { CancellationDetails, SubscriptionStatus } from "../subscription/index.cjs";
+import { Money } from "./mapper.cjs";
+import { Stripe } from "stripe";
+//#region src/stripe/subscription.d.ts
+/**
+ * A Stripe subscription in the platform-neutral shape a subscription row stores. What it leaves out
+ * is the app's: who the user is and which plan the product means (both from the subscription's
+ * metadata and the app's config), the row id, and when the row was written.
+ */
+export interface StripeSubscriptionState {
+  status: SubscriptionStatus;
+  autoRenewEnabled: boolean;
+  /** see {@link mapListPrice}; null for a price without a flat amount */
+  price: Money | null;
+  startedAt: string;
+  createdAt: string;
+  /** null while paused: a paused subscription has no date it comes back on */
+  renewalAt: string | null;
+  trialStart: string | null;
+  trialEnd: string | null;
+  canceledAt: string | null;
+  cancellationDetails: CancellationDetails | null;
+}
+/**
+ * The plan's list price, which is what "$X / month" promises. The latest invoice is deliberately
+ * not used: after an upgrade it is the prorated difference, and after a coupon the discounted
+ * amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or
+ * custom-amount price, which has no flat unit amount.
+ */
+export declare function mapListPrice({ items }: Pick<Stripe.Subscription, 'items'>): Money | null;
+export declare function mapSubscription(sub: Stripe.Subscription): StripeSubscriptionState;
+//#endregion
+//# sourceMappingURL=subscription.d.cts.map

package/dist/stripe/subscription.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.cts","names":[],"sources":["../../src/stripe/subscription.ts"],"mappings":";;;;;;;;;iBAeiB;EACf,QAAQ;EACR;;EAEA,OAAO;EACP;EACA;;EAEA;EACA;EACA;EACA;EACA,qBAAqB;;;;;;;;wBASP,eAAe,SAAS,KAAK,OAAO,yBAAyB;wBAO7D,gBAAgB,KAAK,OAAO,eAAe"}

package/dist/stripe/subscription.d.mts

@@ -0,0 +1,33 @@
+import { CancellationDetails, SubscriptionStatus } from "../subscription/index.mjs";
+import { Money } from "./mapper.mjs";
+import { Stripe } from "stripe";
+//#region src/stripe/subscription.d.ts
+/**
+ * A Stripe subscription in the platform-neutral shape a subscription row stores. What it leaves out
+ * is the app's: who the user is and which plan the product means (both from the subscription's
+ * metadata and the app's config), the row id, and when the row was written.
+ */
+export interface StripeSubscriptionState {
+  status: SubscriptionStatus;
+  autoRenewEnabled: boolean;
+  /** see {@link mapListPrice}; null for a price without a flat amount */
+  price: Money | null;
+  startedAt: string;
+  createdAt: string;
+  /** null while paused: a paused subscription has no date it comes back on */
+  renewalAt: string | null;
+  trialStart: string | null;
+  trialEnd: string | null;
+  canceledAt: string | null;
+  cancellationDetails: CancellationDetails | null;
+}
+/**
+ * The plan's list price, which is what "$X / month" promises. The latest invoice is deliberately
+ * not used: after an upgrade it is the prorated difference, and after a coupon the discounted
+ * amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or
+ * custom-amount price, which has no flat unit amount.
+ */
+export declare function mapListPrice({ items }: Pick<Stripe.Subscription, 'items'>): Money | null;
+export declare function mapSubscription(sub: Stripe.Subscription): StripeSubscriptionState;
+//#endregion
+//# sourceMappingURL=subscription.d.mts.map

package/dist/stripe/subscription.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.mts","names":[],"sources":["../../src/stripe/subscription.ts"],"mappings":";;;;;;;;;iBAeiB;EACf,QAAQ;EACR;;EAEA,OAAO;EACP;EACA;;EAEA;EACA;EACA;EACA;EACA,qBAAqB;;;;;;;;wBASP,eAAe,SAAS,KAAK,OAAO,yBAAyB;wBAO7D,gBAAgB,KAAK,OAAO,eAAe"}

package/dist/stripe/subscription.mjs

@@ -0,0 +1,33 @@
+import { mapCancellationDetails, mapSubscriptionStatus, mapTime, money } from "./mapper.mjs";
+//#region src/stripe/subscription.ts
+/**
+* The plan's list price, which is what "$X / month" promises. The latest invoice is deliberately
+* not used: after an upgrade it is the prorated difference, and after a coupon the discounted
+* amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or
+* custom-amount price, which has no flat unit amount.
+*/
+function mapListPrice({ items }) {
+	const item = items.data.at(0);
+	const price = item?.price;
+	if (!price || price.unit_amount === null) return null;
+	return money(price.unit_amount * (item.quantity ?? 1), price.currency);
+}
+function mapSubscription(sub) {
+	const periodEnd = sub.items.data.at(0)?.current_period_end ?? null;
+	return {
+		status: mapSubscriptionStatus(sub.status),
+		autoRenewEnabled: sub.status !== "canceled" && !sub.cancel_at_period_end && sub.cancel_at === null,
+		price: mapListPrice(sub),
+		startedAt: mapTime(sub.start_date),
+		createdAt: mapTime(sub.created),
+		renewalAt: sub.status === "paused" ? null : mapTime(periodEnd),
+		trialStart: mapTime(sub.trial_start),
+		trialEnd: mapTime(sub.trial_end),
+		canceledAt: mapTime(sub.canceled_at),
+		cancellationDetails: mapCancellationDetails(sub)
+	};
+}
+//#endregion
+export { mapListPrice, mapSubscription };
+
+//# sourceMappingURL=subscription.mjs.map

package/dist/stripe/subscription.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.mjs","names":[],"sources":["../../src/stripe/subscription.ts"],"sourcesContent":["import type { Stripe } from 'stripe';\nimport type { CancellationDetails, SubscriptionStatus } from '../subscription/index';\nimport {\n  type Money,\n  mapCancellationDetails,\n  mapSubscriptionStatus,\n  mapTime,\n  money,\n} from './mapper';\n\n/**\n * A Stripe subscription in the platform-neutral shape a subscription row stores. What it leaves out\n * is the app's: who the user is and which plan the product means (both from the subscription's\n * metadata and the app's config), the row id, and when the row was written.\n */\nexport interface StripeSubscriptionState {\n  status: SubscriptionStatus;\n  autoRenewEnabled: boolean;\n  /** see {@link mapListPrice}; null for a price without a flat amount */\n  price: Money | null;\n  startedAt: string;\n  createdAt: string;\n  /** null while paused: a paused subscription has no date it comes back on */\n  renewalAt: string | null;\n  trialStart: string | null;\n  trialEnd: string | null;\n  canceledAt: string | null;\n  cancellationDetails: CancellationDetails | null;\n}\n\n/**\n * The plan's list price, which is what \"$X / month\" promises. The latest invoice is deliberately\n * not used: after an upgrade it is the prorated difference, and after a coupon the discounted\n * amount, both of which belong in the invoice history rather than on the plan. Null for a tiered or\n * custom-amount price, which has no flat unit amount.\n */\nexport function mapListPrice({ items }: Pick<Stripe.Subscription, 'items'>): Money | null {\n  const item = items.data.at(0);\n  const price = item?.price;\n  if (!price || price.unit_amount === null) return null;\n  return money(price.unit_amount * (item.quantity ?? 1), price.currency);\n}\n\nexport function mapSubscription(sub: Stripe.Subscription): StripeSubscriptionState {\n  const periodEnd = sub.items.data.at(0)?.current_period_end ?? null;\n  return {\n    status: mapSubscriptionStatus(sub.status),\n    autoRenewEnabled:\n      sub.status !== 'canceled' && !sub.cancel_at_period_end && sub.cancel_at === null,\n    price: mapListPrice(sub),\n    startedAt: mapTime(sub.start_date),\n    createdAt: mapTime(sub.created),\n    // A paused subscription (trial ended without a card, failed payment, or an explicit pause;\n    // `status_details.paused` says which) stays paused until it is resumed, so the period end it\n    // still reports is not a renewal.\n    renewalAt: sub.status === 'paused' ? null : mapTime(periodEnd),\n    trialStart: mapTime(sub.trial_start),\n    trialEnd: mapTime(sub.trial_end),\n    canceledAt: mapTime(sub.canceled_at),\n    cancellationDetails: mapCancellationDetails(sub),\n  };\n}\n"],"mappings":";;;;;;;;AAoCA,SAAgB,aAAa,EAAE,SAA2D;CACxF,MAAM,OAAO,MAAM,KAAK,GAAG,CAAC;CAC5B,MAAM,QAAQ,MAAM;CACpB,IAAI,CAAC,SAAS,MAAM,gBAAgB,MAAM,OAAO;CACjD,OAAO,MAAM,MAAM,eAAe,KAAK,YAAY,IAAI,MAAM,QAAQ;AACvE;AAEA,SAAgB,gBAAgB,KAAmD;CACjF,MAAM,YAAY,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,sBAAsB;CAC9D,OAAO;EACL,QAAQ,sBAAsB,IAAI,MAAM;EACxC,kBACE,IAAI,WAAW,cAAc,CAAC,IAAI,wBAAwB,IAAI,cAAc;EAC9E,OAAO,aAAa,GAAG;EACvB,WAAW,QAAQ,IAAI,UAAU;EACjC,WAAW,QAAQ,IAAI,OAAO;EAI9B,WAAW,IAAI,WAAW,WAAW,OAAO,QAAQ,SAAS;EAC7D,YAAY,QAAQ,IAAI,WAAW;EACnC,UAAU,QAAQ,IAAI,SAAS;EAC/B,YAAY,QAAQ,IAAI,WAAW;EACnC,qBAAqB,uBAAuB,GAAG;CACjD;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shware/purchase",
-  "version": "7.3.0",
+  "version": "7.6.0",
   "private": false,
   "repository": {
     "type": "git",