@shware/purchase 5.0.0 → 5.1.0

package/dist/app-store/index.cjs

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_app_store_config = require("./config.cjs");
 const require_app_store_handler = require("./handler.cjs");
+const require_app_store_mapper = require("./mapper.cjs");
 exports.AppStoreConfig = require_app_store_config.AppStoreConfig;
 exports.AppStoreNotificationHandler = require_app_store_handler.AppStoreNotificationHandler;
+exports.mapCancellationDetails = require_app_store_mapper.mapCancellationDetails;

package/dist/app-store/index.d.cts

@@ -1,3 +1,4 @@
 import { AppStoreConfig } from "./config.cjs";
 import { AppStoreNotificationEvent, AppStoreNotificationHandler } from "./handler.cjs";
-export { AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler };
+import { AppStoreCancellationSource, mapCancellationDetails } from "./mapper.cjs";
+export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, mapCancellationDetails };

package/dist/app-store/index.d.mts

@@ -1,3 +1,4 @@
 import { AppStoreConfig } from "./config.mjs";
 import { AppStoreNotificationEvent, AppStoreNotificationHandler } from "./handler.mjs";
-export { AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler };
+import { AppStoreCancellationSource, mapCancellationDetails } from "./mapper.mjs";
+export { type AppStoreCancellationSource, AppStoreConfig, type AppStoreNotificationEvent, AppStoreNotificationHandler, mapCancellationDetails };

package/dist/app-store/index.mjs

@@ -1,3 +1,4 @@
 import { AppStoreConfig } from "./config.mjs";
 import { AppStoreNotificationHandler } from "./handler.mjs";
-export { AppStoreConfig, AppStoreNotificationHandler };
+import { mapCancellationDetails } from "./mapper.mjs";
+export { AppStoreConfig, AppStoreNotificationHandler, mapCancellationDetails };

package/dist/app-store/mapper.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/app-store/mapper.ts
+/**
+* Who ended an App Store subscription and why, from the notification that reported it. Null for
+* anything that is not a cancellation, including the customer turning auto-renew back on.
+*
+* ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+* ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)
+*/
+function mapCancellationDetails(source) {
+	const { notificationType, subtype, expirationIntent } = source;
+	const details = (initiator, reason) => ({
+		initiator,
+		reason,
+		feedback: null,
+		comment: null
+	});
+	switch (notificationType) {
+		case "DID_CHANGE_RENEWAL_STATUS": return subtype === "AUTO_RENEW_DISABLED" ? details("user", subtype) : null;
+		case "EXPIRED": switch (subtype ?? expirationIntentSubtype(expirationIntent)) {
+			case "VOLUNTARY": return details("user", "VOLUNTARY");
+			case "BILLING_RETRY": return details("system", "BILLING_RETRY");
+			case "PRICE_INCREASE": return details("user", "PRICE_INCREASE");
+			case "PRODUCT_NOT_FOR_SALE": return details("developer", "PRODUCT_NOT_FOR_SALE");
+			default: return details("system", "EXPIRED");
+		}
+		case "DID_FAIL_TO_RENEW":
+		case "GRACE_PERIOD_EXPIRED":
+		case "REFUND":
+		case "REVOKE": return details("system", notificationType);
+		default: return null;
+	}
+}
+/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */
+function expirationIntentSubtype(intent) {
+	switch (intent) {
+		case 1: return "VOLUNTARY";
+		case 2: return "BILLING_RETRY";
+		case 3: return "PRICE_INCREASE";
+		case 4: return "PRODUCT_NOT_FOR_SALE";
+		default: return;
+	}
+}
+//#endregion
+exports.mapCancellationDetails = mapCancellationDetails;
+
+//# sourceMappingURL=mapper.cjs.map

package/dist/app-store/mapper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.cjs","names":[],"sources":["../../src/app-store/mapper.ts"],"sourcesContent":["import type { CancellationDetails } from '../subscription/index';\n\n/**\n * The App Store Server Notification fields that say why a subscription stops renewing: the\n * notification type and subtype, plus `expirationIntent` from the renewal info once it has\n * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the\n * App Store Server Library.\n */\nexport interface AppStoreCancellationSource {\n  notificationType: string;\n  subtype?: string | null;\n  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */\n  expirationIntent?: number | null;\n}\n\n/**\n * Who ended an App Store subscription and why, from the notification that reported it. Null for\n * anything that is not a cancellation, including the customer turning auto-renew back on.\n *\n * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)\n * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)\n */\nexport function mapCancellationDetails(\n  source: AppStoreCancellationSource\n): CancellationDetails | null {\n  const { notificationType, subtype, expirationIntent } = source;\n  const details = (initiator: CancellationDetails['initiator'], reason: string) => ({\n    initiator,\n    reason,\n    feedback: null,\n    comment: null,\n  });\n\n  switch (notificationType) {\n    case 'DID_CHANGE_RENEWAL_STATUS':\n      return subtype === 'AUTO_RENEW_DISABLED' ? details('user', subtype) : null;\n    case 'EXPIRED':\n      switch (subtype ?? expirationIntentSubtype(expirationIntent)) {\n        case 'VOLUNTARY':\n          return details('user', 'VOLUNTARY');\n        case 'BILLING_RETRY':\n          return details('system', 'BILLING_RETRY');\n        case 'PRICE_INCREASE':\n          return details('user', 'PRICE_INCREASE');\n        case 'PRODUCT_NOT_FOR_SALE':\n          return details('developer', 'PRODUCT_NOT_FOR_SALE');\n        default:\n          return details('system', 'EXPIRED');\n      }\n    case 'DID_FAIL_TO_RENEW':\n    case 'GRACE_PERIOD_EXPIRED':\n    case 'REFUND':\n    case 'REVOKE':\n      return details('system', notificationType);\n    default:\n      return null;\n  }\n}\n\n/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */\nfunction expirationIntentSubtype(intent: number | null | undefined) {\n  switch (intent) {\n    case 1:\n      return 'VOLUNTARY';\n    case 2:\n      return 'BILLING_RETRY';\n    case 3:\n      return 'PRICE_INCREASE';\n    case 4:\n      return 'PRODUCT_NOT_FOR_SALE';\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,uBACd,QAC4B;CAC5B,MAAM,EAAE,kBAAkB,SAAS,qBAAqB;CACxD,MAAM,WAAW,WAA6C,YAAoB;EAChF;EACA;EACA,UAAU;EACV,SAAS;CACX;CAEA,QAAQ,kBAAR;EACE,KAAK,6BACH,OAAO,YAAY,wBAAwB,QAAQ,QAAQ,OAAO,IAAI;EACxE,KAAK,WACH,QAAQ,WAAW,wBAAwB,gBAAgB,GAA3D;GACE,KAAK,aACH,OAAO,QAAQ,QAAQ,WAAW;GACpC,KAAK,iBACH,OAAO,QAAQ,UAAU,eAAe;GAC1C,KAAK,kBACH,OAAO,QAAQ,QAAQ,gBAAgB;GACzC,KAAK,wBACH,OAAO,QAAQ,aAAa,sBAAsB;GACpD,SACE,OAAO,QAAQ,UAAU,SAAS;EACtC;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,UACH,OAAO,QAAQ,UAAU,gBAAgB;EAC3C,SACE,OAAO;CACX;AACF;;AAGA,SAAS,wBAAwB,QAAmC;CAClE,QAAQ,QAAR;EACE,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,SACE;CACJ;AACF"}

package/dist/app-store/mapper.d.cts

@@ -0,0 +1,25 @@
+import { CancellationDetails } from "../subscription/index.cjs";
+//#region src/app-store/mapper.d.ts
+/**
+ * The App Store Server Notification fields that say why a subscription stops renewing: the
+ * notification type and subtype, plus `expirationIntent` from the renewal info once it has
+ * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the
+ * App Store Server Library.
+ */
+interface AppStoreCancellationSource {
+  notificationType: string;
+  subtype?: string | null;
+  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */
+  expirationIntent?: number | null;
+}
+/**
+ * Who ended an App Store subscription and why, from the notification that reported it. Null for
+ * anything that is not a cancellation, including the customer turning auto-renew back on.
+ *
+ * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+ * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)
+ */
+declare function mapCancellationDetails(source: AppStoreCancellationSource): CancellationDetails | null;
+//#endregion
+export { AppStoreCancellationSource, mapCancellationDetails };
+//# sourceMappingURL=mapper.d.cts.map

package/dist/app-store/mapper.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/app-store/mapper.ts"],"mappings":";;;;;;;;UAQiB;EACf;EACA;;EAEA;;;;;;;;;iBAUc,uBACd,QAAQ,6BACP"}

package/dist/app-store/mapper.d.mts

@@ -0,0 +1,25 @@
+import { CancellationDetails } from "../subscription/index.mjs";
+//#region src/app-store/mapper.d.ts
+/**
+ * The App Store Server Notification fields that say why a subscription stops renewing: the
+ * notification type and subtype, plus `expirationIntent` from the renewal info once it has
+ * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the
+ * App Store Server Library.
+ */
+interface AppStoreCancellationSource {
+  notificationType: string;
+  subtype?: string | null;
+  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */
+  expirationIntent?: number | null;
+}
+/**
+ * Who ended an App Store subscription and why, from the notification that reported it. Null for
+ * anything that is not a cancellation, including the customer turning auto-renew back on.
+ *
+ * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+ * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)
+ */
+declare function mapCancellationDetails(source: AppStoreCancellationSource): CancellationDetails | null;
+//#endregion
+export { AppStoreCancellationSource, mapCancellationDetails };
+//# sourceMappingURL=mapper.d.mts.map

package/dist/app-store/mapper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.mts","names":[],"sources":["../../src/app-store/mapper.ts"],"mappings":";;;;;;;;UAQiB;EACf;EACA;;EAEA;;;;;;;;;iBAUc,uBACd,QAAQ,6BACP"}

package/dist/app-store/mapper.mjs

@@ -0,0 +1,46 @@
+//#region src/app-store/mapper.ts
+/**
+* Who ended an App Store subscription and why, from the notification that reported it. Null for
+* anything that is not a cancellation, including the customer turning auto-renew back on.
+*
+* ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)
+* ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)
+*/
+function mapCancellationDetails(source) {
+	const { notificationType, subtype, expirationIntent } = source;
+	const details = (initiator, reason) => ({
+		initiator,
+		reason,
+		feedback: null,
+		comment: null
+	});
+	switch (notificationType) {
+		case "DID_CHANGE_RENEWAL_STATUS": return subtype === "AUTO_RENEW_DISABLED" ? details("user", subtype) : null;
+		case "EXPIRED": switch (subtype ?? expirationIntentSubtype(expirationIntent)) {
+			case "VOLUNTARY": return details("user", "VOLUNTARY");
+			case "BILLING_RETRY": return details("system", "BILLING_RETRY");
+			case "PRICE_INCREASE": return details("user", "PRICE_INCREASE");
+			case "PRODUCT_NOT_FOR_SALE": return details("developer", "PRODUCT_NOT_FOR_SALE");
+			default: return details("system", "EXPIRED");
+		}
+		case "DID_FAIL_TO_RENEW":
+		case "GRACE_PERIOD_EXPIRED":
+		case "REFUND":
+		case "REVOKE": return details("system", notificationType);
+		default: return null;
+	}
+}
+/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */
+function expirationIntentSubtype(intent) {
+	switch (intent) {
+		case 1: return "VOLUNTARY";
+		case 2: return "BILLING_RETRY";
+		case 3: return "PRICE_INCREASE";
+		case 4: return "PRODUCT_NOT_FOR_SALE";
+		default: return;
+	}
+}
+//#endregion
+export { mapCancellationDetails };
+
+//# sourceMappingURL=mapper.mjs.map

package/dist/app-store/mapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.mjs","names":[],"sources":["../../src/app-store/mapper.ts"],"sourcesContent":["import type { CancellationDetails } from '../subscription/index';\n\n/**\n * The App Store Server Notification fields that say why a subscription stops renewing: the\n * notification type and subtype, plus `expirationIntent` from the renewal info once it has\n * expired. Strings and numbers as Apple sends them, so this needs no runtime import of the\n * App Store Server Library.\n */\nexport interface AppStoreCancellationSource {\n  notificationType: string;\n  subtype?: string | null;\n  /** `JWSRenewalInfoDecodedPayload.expirationIntent`: 1 customer, 2 billing, 3 price increase, 4 unavailable, 5 other. */\n  expirationIntent?: number | null;\n}\n\n/**\n * Who ended an App Store subscription and why, from the notification that reported it. Null for\n * anything that is not a cancellation, including the customer turning auto-renew back on.\n *\n * ref: [notificationType](https://developer.apple.com/documentation/appstoreservernotifications/notificationtype)\n * ref: [expirationIntent](https://developer.apple.com/documentation/appstoreserverapi/expirationintent)\n */\nexport function mapCancellationDetails(\n  source: AppStoreCancellationSource\n): CancellationDetails | null {\n  const { notificationType, subtype, expirationIntent } = source;\n  const details = (initiator: CancellationDetails['initiator'], reason: string) => ({\n    initiator,\n    reason,\n    feedback: null,\n    comment: null,\n  });\n\n  switch (notificationType) {\n    case 'DID_CHANGE_RENEWAL_STATUS':\n      return subtype === 'AUTO_RENEW_DISABLED' ? details('user', subtype) : null;\n    case 'EXPIRED':\n      switch (subtype ?? expirationIntentSubtype(expirationIntent)) {\n        case 'VOLUNTARY':\n          return details('user', 'VOLUNTARY');\n        case 'BILLING_RETRY':\n          return details('system', 'BILLING_RETRY');\n        case 'PRICE_INCREASE':\n          return details('user', 'PRICE_INCREASE');\n        case 'PRODUCT_NOT_FOR_SALE':\n          return details('developer', 'PRODUCT_NOT_FOR_SALE');\n        default:\n          return details('system', 'EXPIRED');\n      }\n    case 'DID_FAIL_TO_RENEW':\n    case 'GRACE_PERIOD_EXPIRED':\n    case 'REFUND':\n    case 'REVOKE':\n      return details('system', notificationType);\n    default:\n      return null;\n  }\n}\n\n/** The EXPIRED subtype Apple would have sent for an `expirationIntent`. */\nfunction expirationIntentSubtype(intent: number | null | undefined) {\n  switch (intent) {\n    case 1:\n      return 'VOLUNTARY';\n    case 2:\n      return 'BILLING_RETRY';\n    case 3:\n      return 'PRICE_INCREASE';\n    case 4:\n      return 'PRODUCT_NOT_FOR_SALE';\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;AAsBA,SAAgB,uBACd,QAC4B;CAC5B,MAAM,EAAE,kBAAkB,SAAS,qBAAqB;CACxD,MAAM,WAAW,WAA6C,YAAoB;EAChF;EACA;EACA,UAAU;EACV,SAAS;CACX;CAEA,QAAQ,kBAAR;EACE,KAAK,6BACH,OAAO,YAAY,wBAAwB,QAAQ,QAAQ,OAAO,IAAI;EACxE,KAAK,WACH,QAAQ,WAAW,wBAAwB,gBAAgB,GAA3D;GACE,KAAK,aACH,OAAO,QAAQ,QAAQ,WAAW;GACpC,KAAK,iBACH,OAAO,QAAQ,UAAU,eAAe;GAC1C,KAAK,kBACH,OAAO,QAAQ,QAAQ,gBAAgB;GACzC,KAAK,wBACH,OAAO,QAAQ,aAAa,sBAAsB;GACpD,SACE,OAAO,QAAQ,UAAU,SAAS;EACtC;EACF,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,UACH,OAAO,QAAQ,UAAU,gBAAgB;EAC3C,SACE,OAAO;CACX;AACF;;AAGA,SAAS,wBAAwB,QAAmC;CAClE,QAAQ,QAAR;EACE,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,SACE;CACJ;AACF"}

package/dist/google-play/index.cjs

@@ -8,4 +8,6 @@ exports.OneTimeProductNotificationType = require_google_play_real_time_developer
 exports.SubscriptionNotificationType = require_google_play_real_time_developer_notification.SubscriptionNotificationType;
 exports.VoidedPurchaseProductType = require_google_play_real_time_developer_notification.VoidedPurchaseProductType;
 exports.VoidedPurchaseRefundType = require_google_play_real_time_developer_notification.VoidedPurchaseRefundType;
+exports.mapCanceledAt = require_google_play_mapper.mapCanceledAt;
+exports.mapCancellationDetails = require_google_play_mapper.mapCancellationDetails;
 exports.mapSubscriptionStatus = require_google_play_mapper.mapSubscriptionStatus;

package/dist/google-play/index.d.cts

@@ -1,4 +1,4 @@
 import { GooglePlayConfig } from "./config.cjs";
 import { DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlaySubscriptionState, OneTimeProductNotification, OneTimeProductNotificationType, PubsubMessage, SubscriptionNotification, SubscriptionNotificationType, TestNotification, VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType } from "./real-time-developer-notification.cjs";
-import { mapSubscriptionStatus } from "./mapper.cjs";
-export { type DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, type GooglePlaySubscriptionState, type OneTimeProductNotification, OneTimeProductNotificationType, type PubsubMessage, type SubscriptionNotification, SubscriptionNotificationType, type TestNotification, type VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapSubscriptionStatus };
+import { CanceledStateContext, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus } from "./mapper.cjs";
+export { type CanceledStateContext, type DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, type GooglePlaySubscriptionState, type OneTimeProductNotification, OneTimeProductNotificationType, type PubsubMessage, type SubscriptionNotification, SubscriptionNotificationType, type TestNotification, type VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };

package/dist/google-play/index.d.mts

@@ -1,4 +1,4 @@
 import { GooglePlayConfig } from "./config.mjs";
 import { DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlaySubscriptionState, OneTimeProductNotification, OneTimeProductNotificationType, PubsubMessage, SubscriptionNotification, SubscriptionNotificationType, TestNotification, VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType } from "./real-time-developer-notification.mjs";
-import { mapSubscriptionStatus } from "./mapper.mjs";
-export { type DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, type GooglePlaySubscriptionState, type OneTimeProductNotification, OneTimeProductNotificationType, type PubsubMessage, type SubscriptionNotification, SubscriptionNotificationType, type TestNotification, type VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapSubscriptionStatus };
+import { CanceledStateContext, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus } from "./mapper.mjs";
+export { type CanceledStateContext, type DeveloperNotification, GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, type GooglePlaySubscriptionState, type OneTimeProductNotification, OneTimeProductNotificationType, type PubsubMessage, type SubscriptionNotification, SubscriptionNotificationType, type TestNotification, type VoidedPurchaseNotification, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };

package/dist/google-play/index.mjs

@@ -1,4 +1,4 @@
 import { GooglePlayConfig } from "./config.mjs";
 import { GOOGLE_PLAY_SUBSCRIPTION_STATES, OneTimeProductNotificationType, SubscriptionNotificationType, VoidedPurchaseProductType, VoidedPurchaseRefundType } from "./real-time-developer-notification.mjs";
-import { mapSubscriptionStatus } from "./mapper.mjs";
-export { GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, OneTimeProductNotificationType, SubscriptionNotificationType, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapSubscriptionStatus };
+import { mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus } from "./mapper.mjs";
+export { GOOGLE_PLAY_SUBSCRIPTION_STATES, GooglePlayConfig, OneTimeProductNotificationType, SubscriptionNotificationType, VoidedPurchaseProductType, VoidedPurchaseRefundType, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };

package/dist/google-play/mapper.cjs

@@ -13,7 +13,55 @@ function mapSubscriptionStatus(state) {
 		default: throw new Error(`Unknown Google Play subscription state: ${state}`);
 	}
 }
+/** Play's cancel-survey answers in the shared vocabulary. */
+const SURVEY_FEEDBACK = {
+	CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE: "unused",
+	CANCEL_SURVEY_REASON_TECHNICAL_ISSUES: "low_quality",
+	CANCEL_SURVEY_REASON_COST_RELATED: "too_expensive",
+	CANCEL_SURVEY_REASON_FOUND_BETTER_APP: "switched_service",
+	CANCEL_SURVEY_REASON_OTHERS: "other"
+};
+/**
+* Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel
+* (and for free text when it is "Other"), which comes back in `cancelSurveyResult`. Null while
+* the subscription renews, and for a replacement: that is the linked purchase taking over, not a
+* cancellation to report.
+*/
+function mapCancellationDetails(context) {
+	if (!context) return null;
+	if (context.userInitiatedCancellation) {
+		const survey = context.userInitiatedCancellation.cancelSurveyResult;
+		return {
+			initiator: "user",
+			reason: survey?.reason ?? null,
+			feedback: survey?.reason && SURVEY_FEEDBACK[survey.reason] || null,
+			comment: survey?.reasonUserInput ?? null
+		};
+	}
+	if (context.systemInitiatedCancellation) return {
+		initiator: "system",
+		reason: "SYSTEM_INITIATED",
+		feedback: null,
+		comment: null
+	};
+	if (context.developerInitiatedCancellation) return {
+		initiator: "developer",
+		reason: "DEVELOPER_INITIATED",
+		feedback: null,
+		comment: null
+	};
+	return null;
+}
+/**
+* When the subscription was cancelled. Only a user cancellation carries the time; for the others
+* the caller falls back to when it learnt of it.
+*/
+function mapCanceledAt(context) {
+	return context?.userInitiatedCancellation?.cancelTime ?? null;
+}
 //#endregion
+exports.mapCanceledAt = mapCanceledAt;
+exports.mapCancellationDetails = mapCancellationDetails;
 exports.mapSubscriptionStatus = mapSubscriptionStatus;
 
 //# sourceMappingURL=mapper.cjs.map

package/dist/google-play/mapper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.cjs","names":[],"sources":["../../src/google-play/mapper.ts"],"sourcesContent":["import type { SubscriptionStatus } from '../subscription/index';\nimport type { GooglePlaySubscriptionState } from './real-time-developer-notification';\n\nexport function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus {\n  switch (state) {\n    case 'SUBSCRIPTION_STATE_PENDING':\n      return 'PENDING';\n    case 'SUBSCRIPTION_STATE_ACTIVE':\n      return 'ACTIVE';\n    case 'SUBSCRIPTION_STATE_PAUSED':\n      return 'PAUSED';\n    case 'SUBSCRIPTION_STATE_IN_GRACE_PERIOD':\n      return 'IN_GRACE_PERIOD';\n    case 'SUBSCRIPTION_STATE_ON_HOLD':\n      return 'ON_HOLD';\n    case 'SUBSCRIPTION_STATE_CANCELED':\n      return 'CANCELED';\n    case 'SUBSCRIPTION_STATE_EXPIRED':\n      return 'EXPIRED';\n    case 'SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED':\n      return 'PENDING_PURCHASE_CANCELED';\n    default:\n      throw new Error(`Unknown Google Play subscription state: ${state}`);\n  }\n}\n"],"mappings":";;AAGA,SAAgB,sBAAsB,OAAwD;CAC5F,QAAQ,OAAR;EACE,KAAK,8BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,+BACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,gDACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,2CAA2C,OAAO;CACtE;AACF"}
+{"version":3,"file":"mapper.cjs","names":[],"sources":["../../src/google-play/mapper.ts"],"sourcesContent":["import type { CancellationDetails, SubscriptionStatus } from '../subscription/index';\nimport type { GooglePlaySubscriptionState } from './real-time-developer-notification';\n\nexport function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus {\n  switch (state) {\n    case 'SUBSCRIPTION_STATE_PENDING':\n      return 'PENDING';\n    case 'SUBSCRIPTION_STATE_ACTIVE':\n      return 'ACTIVE';\n    case 'SUBSCRIPTION_STATE_PAUSED':\n      return 'PAUSED';\n    case 'SUBSCRIPTION_STATE_IN_GRACE_PERIOD':\n      return 'IN_GRACE_PERIOD';\n    case 'SUBSCRIPTION_STATE_ON_HOLD':\n      return 'ON_HOLD';\n    case 'SUBSCRIPTION_STATE_CANCELED':\n      return 'CANCELED';\n    case 'SUBSCRIPTION_STATE_EXPIRED':\n      return 'EXPIRED';\n    case 'SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED':\n      return 'PENDING_PURCHASE_CANCELED';\n    default:\n      throw new Error(`Unknown Google Play subscription state: ${state}`);\n  }\n}\n\n/** Play's cancel-survey answers in the shared vocabulary. */\nconst SURVEY_FEEDBACK: Record<string, CancellationDetails['feedback']> = {\n  CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE: 'unused',\n  CANCEL_SURVEY_REASON_TECHNICAL_ISSUES: 'low_quality',\n  CANCEL_SURVEY_REASON_COST_RELATED: 'too_expensive',\n  CANCEL_SURVEY_REASON_FOUND_BETTER_APP: 'switched_service',\n  CANCEL_SURVEY_REASON_OTHERS: 'other',\n};\n\n/**\n * `canceledStateContext` of `purchases.subscriptionsv2.get`, declared structurally so this\n * module does not depend on the Play Developer API client.\n */\nexport interface CanceledStateContext {\n  userInitiatedCancellation?: {\n    cancelTime?: string | null;\n    cancelSurveyResult?: { reason?: string | null; reasonUserInput?: string | null } | null;\n  } | null;\n  systemInitiatedCancellation?: object | null;\n  developerInitiatedCancellation?: object | null;\n  replacementCancellation?: object | null;\n}\n\n/**\n * Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel\n * (and for free text when it is \"Other\"), which comes back in `cancelSurveyResult`. Null while\n * the subscription renews, and for a replacement: that is the linked purchase taking over, not a\n * cancellation to report.\n */\nexport function mapCancellationDetails(\n  context: CanceledStateContext | null | undefined\n): CancellationDetails | null {\n  if (!context) return null;\n  if (context.userInitiatedCancellation) {\n    const survey = context.userInitiatedCancellation.cancelSurveyResult;\n    return {\n      initiator: 'user',\n      reason: survey?.reason ?? null,\n      feedback: (survey?.reason && SURVEY_FEEDBACK[survey.reason]) || null,\n      comment: survey?.reasonUserInput ?? null,\n    };\n  }\n  if (context.systemInitiatedCancellation) {\n    return { initiator: 'system', reason: 'SYSTEM_INITIATED', feedback: null, comment: null };\n  }\n  if (context.developerInitiatedCancellation) {\n    return { initiator: 'developer', reason: 'DEVELOPER_INITIATED', feedback: null, comment: null };\n  }\n  return null;\n}\n\n/**\n * When the subscription was cancelled. Only a user cancellation carries the time; for the others\n * the caller falls back to when it learnt of it.\n */\nexport function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null {\n  return context?.userInitiatedCancellation?.cancelTime ?? null;\n}\n"],"mappings":";;AAGA,SAAgB,sBAAsB,OAAwD;CAC5F,QAAQ,OAAR;EACE,KAAK,8BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,+BACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,gDACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,2CAA2C,OAAO;CACtE;AACF;;AAGA,MAAM,kBAAmE;CACvE,uCAAuC;CACvC,uCAAuC;CACvC,mCAAmC;CACnC,uCAAuC;CACvC,6BAA6B;AAC/B;;;;;;;AAsBA,SAAgB,uBACd,SAC4B;CAC5B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,2BAA2B;EACrC,MAAM,SAAS,QAAQ,0BAA0B;EACjD,OAAO;GACL,WAAW;GACX,QAAQ,QAAQ,UAAU;GAC1B,UAAW,QAAQ,UAAU,gBAAgB,OAAO,WAAY;GAChE,SAAS,QAAQ,mBAAmB;EACtC;CACF;CACA,IAAI,QAAQ,6BACV,OAAO;EAAE,WAAW;EAAU,QAAQ;EAAoB,UAAU;EAAM,SAAS;CAAK;CAE1F,IAAI,QAAQ,gCACV,OAAO;EAAE,WAAW;EAAa,QAAQ;EAAuB,UAAU;EAAM,SAAS;CAAK;CAEhG,OAAO;AACT;;;;;AAMA,SAAgB,cAAc,SAAiE;CAC7F,OAAO,SAAS,2BAA2B,cAAc;AAC3D"}

package/dist/google-play/mapper.d.cts

@@ -1,7 +1,35 @@
+import { CancellationDetails, SubscriptionStatus } from "../subscription/index.cjs";
 import { GooglePlaySubscriptionState } from "./real-time-developer-notification.cjs";
-import { SubscriptionStatus } from "../subscription/index.cjs";
 //#region src/google-play/mapper.d.ts
 declare function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus;
+/**
+ * `canceledStateContext` of `purchases.subscriptionsv2.get`, declared structurally so this
+ * module does not depend on the Play Developer API client.
+ */
+interface CanceledStateContext {
+  userInitiatedCancellation?: {
+    cancelTime?: string | null;
+    cancelSurveyResult?: {
+      reason?: string | null;
+      reasonUserInput?: string | null;
+    } | null;
+  } | null;
+  systemInitiatedCancellation?: object | null;
+  developerInitiatedCancellation?: object | null;
+  replacementCancellation?: object | null;
+}
+/**
+ * Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel
+ * (and for free text when it is "Other"), which comes back in `cancelSurveyResult`. Null while
+ * the subscription renews, and for a replacement: that is the linked purchase taking over, not a
+ * cancellation to report.
+ */
+declare function mapCancellationDetails(context: CanceledStateContext | null | undefined): CancellationDetails | null;
+/**
+ * When the subscription was cancelled. Only a user cancellation carries the time; for the others
+ * the caller falls back to when it learnt of it.
+ */
+declare function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null;
 //#endregion
-export { mapSubscriptionStatus };
+export { CanceledStateContext, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };
 //# sourceMappingURL=mapper.d.cts.map

package/dist/google-play/mapper.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/google-play/mapper.ts"],"mappings":";;;iBAGgB,sBAAsB,OAAO,8BAA8B"}
+{"version":3,"file":"mapper.d.cts","names":[],"sources":["../../src/google-play/mapper.ts"],"mappings":";;;iBAGgB,sBAAsB,OAAO,8BAA8B;;;;;UAoC1D;EACf;IACE;IACA;MAAuB;MAAwB;;;EAEjD;EACA;EACA;;;;;;;;iBASc,uBACd,SAAS,0CACR;;;;;iBAwBa,cAAc,SAAS"}

package/dist/google-play/mapper.d.mts

@@ -1,7 +1,35 @@
+import { CancellationDetails, SubscriptionStatus } from "../subscription/index.mjs";
 import { GooglePlaySubscriptionState } from "./real-time-developer-notification.mjs";
-import { SubscriptionStatus } from "../subscription/index.mjs";
 //#region src/google-play/mapper.d.ts
 declare function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus;
+/**
+ * `canceledStateContext` of `purchases.subscriptionsv2.get`, declared structurally so this
+ * module does not depend on the Play Developer API client.
+ */
+interface CanceledStateContext {
+  userInitiatedCancellation?: {
+    cancelTime?: string | null;
+    cancelSurveyResult?: {
+      reason?: string | null;
+      reasonUserInput?: string | null;
+    } | null;
+  } | null;
+  systemInitiatedCancellation?: object | null;
+  developerInitiatedCancellation?: object | null;
+  replacementCancellation?: object | null;
+}
+/**
+ * Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel
+ * (and for free text when it is "Other"), which comes back in `cancelSurveyResult`. Null while
+ * the subscription renews, and for a replacement: that is the linked purchase taking over, not a
+ * cancellation to report.
+ */
+declare function mapCancellationDetails(context: CanceledStateContext | null | undefined): CancellationDetails | null;
+/**
+ * When the subscription was cancelled. Only a user cancellation carries the time; for the others
+ * the caller falls back to when it learnt of it.
+ */
+declare function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null;
 //#endregion
-export { mapSubscriptionStatus };
+export { CanceledStateContext, mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };
 //# sourceMappingURL=mapper.d.mts.map

package/dist/google-play/mapper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.mts","names":[],"sources":["../../src/google-play/mapper.ts"],"mappings":";;;iBAGgB,sBAAsB,OAAO,8BAA8B"}
+{"version":3,"file":"mapper.d.mts","names":[],"sources":["../../src/google-play/mapper.ts"],"mappings":";;;iBAGgB,sBAAsB,OAAO,8BAA8B;;;;;UAoC1D;EACf;IACE;IACA;MAAuB;MAAwB;;;EAEjD;EACA;EACA;;;;;;;;iBASc,uBACd,SAAS,0CACR;;;;;iBAwBa,cAAc,SAAS"}

package/dist/google-play/mapper.mjs

@@ -12,7 +12,53 @@ function mapSubscriptionStatus(state) {
 		default: throw new Error(`Unknown Google Play subscription state: ${state}`);
 	}
 }
+/** Play's cancel-survey answers in the shared vocabulary. */
+const SURVEY_FEEDBACK = {
+	CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE: "unused",
+	CANCEL_SURVEY_REASON_TECHNICAL_ISSUES: "low_quality",
+	CANCEL_SURVEY_REASON_COST_RELATED: "too_expensive",
+	CANCEL_SURVEY_REASON_FOUND_BETTER_APP: "switched_service",
+	CANCEL_SURVEY_REASON_OTHERS: "other"
+};
+/**
+* Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel
+* (and for free text when it is "Other"), which comes back in `cancelSurveyResult`. Null while
+* the subscription renews, and for a replacement: that is the linked purchase taking over, not a
+* cancellation to report.
+*/
+function mapCancellationDetails(context) {
+	if (!context) return null;
+	if (context.userInitiatedCancellation) {
+		const survey = context.userInitiatedCancellation.cancelSurveyResult;
+		return {
+			initiator: "user",
+			reason: survey?.reason ?? null,
+			feedback: survey?.reason && SURVEY_FEEDBACK[survey.reason] || null,
+			comment: survey?.reasonUserInput ?? null
+		};
+	}
+	if (context.systemInitiatedCancellation) return {
+		initiator: "system",
+		reason: "SYSTEM_INITIATED",
+		feedback: null,
+		comment: null
+	};
+	if (context.developerInitiatedCancellation) return {
+		initiator: "developer",
+		reason: "DEVELOPER_INITIATED",
+		feedback: null,
+		comment: null
+	};
+	return null;
+}
+/**
+* When the subscription was cancelled. Only a user cancellation carries the time; for the others
+* the caller falls back to when it learnt of it.
+*/
+function mapCanceledAt(context) {
+	return context?.userInitiatedCancellation?.cancelTime ?? null;
+}
 //#endregion
-export { mapSubscriptionStatus };
+export { mapCanceledAt, mapCancellationDetails, mapSubscriptionStatus };
 
 //# sourceMappingURL=mapper.mjs.map

package/dist/google-play/mapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.mjs","names":[],"sources":["../../src/google-play/mapper.ts"],"sourcesContent":["import type { SubscriptionStatus } from '../subscription/index';\nimport type { GooglePlaySubscriptionState } from './real-time-developer-notification';\n\nexport function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus {\n  switch (state) {\n    case 'SUBSCRIPTION_STATE_PENDING':\n      return 'PENDING';\n    case 'SUBSCRIPTION_STATE_ACTIVE':\n      return 'ACTIVE';\n    case 'SUBSCRIPTION_STATE_PAUSED':\n      return 'PAUSED';\n    case 'SUBSCRIPTION_STATE_IN_GRACE_PERIOD':\n      return 'IN_GRACE_PERIOD';\n    case 'SUBSCRIPTION_STATE_ON_HOLD':\n      return 'ON_HOLD';\n    case 'SUBSCRIPTION_STATE_CANCELED':\n      return 'CANCELED';\n    case 'SUBSCRIPTION_STATE_EXPIRED':\n      return 'EXPIRED';\n    case 'SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED':\n      return 'PENDING_PURCHASE_CANCELED';\n    default:\n      throw new Error(`Unknown Google Play subscription state: ${state}`);\n  }\n}\n"],"mappings":";AAGA,SAAgB,sBAAsB,OAAwD;CAC5F,QAAQ,OAAR;EACE,KAAK,8BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,+BACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,gDACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,2CAA2C,OAAO;CACtE;AACF"}
+{"version":3,"file":"mapper.mjs","names":[],"sources":["../../src/google-play/mapper.ts"],"sourcesContent":["import type { CancellationDetails, SubscriptionStatus } from '../subscription/index';\nimport type { GooglePlaySubscriptionState } from './real-time-developer-notification';\n\nexport function mapSubscriptionStatus(state: GooglePlaySubscriptionState): SubscriptionStatus {\n  switch (state) {\n    case 'SUBSCRIPTION_STATE_PENDING':\n      return 'PENDING';\n    case 'SUBSCRIPTION_STATE_ACTIVE':\n      return 'ACTIVE';\n    case 'SUBSCRIPTION_STATE_PAUSED':\n      return 'PAUSED';\n    case 'SUBSCRIPTION_STATE_IN_GRACE_PERIOD':\n      return 'IN_GRACE_PERIOD';\n    case 'SUBSCRIPTION_STATE_ON_HOLD':\n      return 'ON_HOLD';\n    case 'SUBSCRIPTION_STATE_CANCELED':\n      return 'CANCELED';\n    case 'SUBSCRIPTION_STATE_EXPIRED':\n      return 'EXPIRED';\n    case 'SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED':\n      return 'PENDING_PURCHASE_CANCELED';\n    default:\n      throw new Error(`Unknown Google Play subscription state: ${state}`);\n  }\n}\n\n/** Play's cancel-survey answers in the shared vocabulary. */\nconst SURVEY_FEEDBACK: Record<string, CancellationDetails['feedback']> = {\n  CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE: 'unused',\n  CANCEL_SURVEY_REASON_TECHNICAL_ISSUES: 'low_quality',\n  CANCEL_SURVEY_REASON_COST_RELATED: 'too_expensive',\n  CANCEL_SURVEY_REASON_FOUND_BETTER_APP: 'switched_service',\n  CANCEL_SURVEY_REASON_OTHERS: 'other',\n};\n\n/**\n * `canceledStateContext` of `purchases.subscriptionsv2.get`, declared structurally so this\n * module does not depend on the Play Developer API client.\n */\nexport interface CanceledStateContext {\n  userInitiatedCancellation?: {\n    cancelTime?: string | null;\n    cancelSurveyResult?: { reason?: string | null; reasonUserInput?: string | null } | null;\n  } | null;\n  systemInitiatedCancellation?: object | null;\n  developerInitiatedCancellation?: object | null;\n  replacementCancellation?: object | null;\n}\n\n/**\n * Why a Play subscription stopped renewing. The Play Store asks the user for a reason on cancel\n * (and for free text when it is \"Other\"), which comes back in `cancelSurveyResult`. Null while\n * the subscription renews, and for a replacement: that is the linked purchase taking over, not a\n * cancellation to report.\n */\nexport function mapCancellationDetails(\n  context: CanceledStateContext | null | undefined\n): CancellationDetails | null {\n  if (!context) return null;\n  if (context.userInitiatedCancellation) {\n    const survey = context.userInitiatedCancellation.cancelSurveyResult;\n    return {\n      initiator: 'user',\n      reason: survey?.reason ?? null,\n      feedback: (survey?.reason && SURVEY_FEEDBACK[survey.reason]) || null,\n      comment: survey?.reasonUserInput ?? null,\n    };\n  }\n  if (context.systemInitiatedCancellation) {\n    return { initiator: 'system', reason: 'SYSTEM_INITIATED', feedback: null, comment: null };\n  }\n  if (context.developerInitiatedCancellation) {\n    return { initiator: 'developer', reason: 'DEVELOPER_INITIATED', feedback: null, comment: null };\n  }\n  return null;\n}\n\n/**\n * When the subscription was cancelled. Only a user cancellation carries the time; for the others\n * the caller falls back to when it learnt of it.\n */\nexport function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null {\n  return context?.userInitiatedCancellation?.cancelTime ?? null;\n}\n"],"mappings":";AAGA,SAAgB,sBAAsB,OAAwD;CAC5F,QAAQ,OAAR;EACE,KAAK,8BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,6BACH,OAAO;EACT,KAAK,sCACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,+BACH,OAAO;EACT,KAAK,8BACH,OAAO;EACT,KAAK,gDACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,2CAA2C,OAAO;CACtE;AACF;;AAGA,MAAM,kBAAmE;CACvE,uCAAuC;CACvC,uCAAuC;CACvC,mCAAmC;CACnC,uCAAuC;CACvC,6BAA6B;AAC/B;;;;;;;AAsBA,SAAgB,uBACd,SAC4B;CAC5B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,2BAA2B;EACrC,MAAM,SAAS,QAAQ,0BAA0B;EACjD,OAAO;GACL,WAAW;GACX,QAAQ,QAAQ,UAAU;GAC1B,UAAW,QAAQ,UAAU,gBAAgB,OAAO,WAAY;GAChE,SAAS,QAAQ,mBAAmB;EACtC;CACF;CACA,IAAI,QAAQ,6BACV,OAAO;EAAE,WAAW;EAAU,QAAQ;EAAoB,UAAU;EAAM,SAAS;CAAK;CAE1F,IAAI,QAAQ,gCACV,OAAO;EAAE,WAAW;EAAa,QAAQ;EAAuB,UAAU;EAAM,SAAS;CAAK;CAEhG,OAAO;AACT;;;;;AAMA,SAAgB,cAAc,SAAiE;CAC7F,OAAO,SAAS,2BAA2B,cAAc;AAC3D"}

package/dist/index.cjs

@@ -5,7 +5,10 @@ const require_google_play_config = require("./google-play/config.cjs");
 const require_stripe_config = require("./stripe/config.cjs");
 exports.AVAILABLE_STATUSES = require_subscription_index.AVAILABLE_STATUSES;
 exports.AppStoreConfig = require_app_store_config.AppStoreConfig;
+exports.CANCELLATION_FEEDBACKS = require_subscription_index.CANCELLATION_FEEDBACKS;
+exports.CANCELLATION_INITIATORS = require_subscription_index.CANCELLATION_INITIATORS;
 exports.GooglePlayConfig = require_google_play_config.GooglePlayConfig;
 exports.PLATFORMS = require_subscription_index.PLATFORMS;
+exports.RESUBSCRIBE_INTENTS = require_subscription_index.RESUBSCRIBE_INTENTS;
 exports.SUBSCRIPTION_STATUSES = require_subscription_index.SUBSCRIPTION_STATUSES;
 exports.StripeConfig = require_stripe_config.StripeConfig;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AppStoreConfig } from "./app-store/config.cjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PLATFORMS, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.cjs";
 import { GooglePlayConfig } from "./google-play/config.cjs";
-import { AVAILABLE_STATUSES, PLATFORMS, Platform, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.cjs";
 import { StripeConfig } from "./stripe/config.cjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, GooglePlayConfig, PLATFORMS, type Platform, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PLATFORMS, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { AppStoreConfig } from "./app-store/config.mjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, CancellationDetails, CancellationFeedback, CancellationInitiator, PLATFORMS, Platform, RESUBSCRIBE_INTENTS, ResubscribeIntent, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.mjs";
 import { GooglePlayConfig } from "./google-play/config.mjs";
-import { AVAILABLE_STATUSES, PLATFORMS, Platform, SUBSCRIPTION_STATUSES, SubscriptionStatus } from "./subscription/index.mjs";
 import { StripeConfig } from "./stripe/config.mjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, GooglePlayConfig, PLATFORMS, type Platform, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, type CancellationDetails, type CancellationFeedback, type CancellationInitiator, GooglePlayConfig, PLATFORMS, type Platform, RESUBSCRIBE_INTENTS, type ResubscribeIntent, SUBSCRIPTION_STATUSES, StripeConfig, type SubscriptionStatus };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { AVAILABLE_STATUSES, PLATFORMS, SUBSCRIPTION_STATUSES } from "./subscription/index.mjs";
+import { AVAILABLE_STATUSES, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES } from "./subscription/index.mjs";
 import { AppStoreConfig } from "./app-store/config.mjs";
 import { GooglePlayConfig } from "./google-play/config.mjs";
 import { StripeConfig } from "./stripe/config.mjs";
-export { AVAILABLE_STATUSES, AppStoreConfig, GooglePlayConfig, PLATFORMS, SUBSCRIPTION_STATUSES, StripeConfig };
+export { AVAILABLE_STATUSES, AppStoreConfig, CANCELLATION_FEEDBACKS, CANCELLATION_INITIATORS, GooglePlayConfig, PLATFORMS, RESUBSCRIBE_INTENTS, SUBSCRIPTION_STATUSES, StripeConfig };

package/dist/stripe/index.cjs

@@ -14,6 +14,7 @@ exports.createCheckoutSessionSchema = require_stripe_schema.createCheckoutSessio
 exports.getBeginCheckoutProperties = require_stripe_mapper.getBeginCheckoutProperties;
 exports.getPendingCheckouts = require_stripe_pending_checkout.getPendingCheckouts;
 exports.getPurchaseProperties = require_stripe_mapper.getPurchaseProperties;
+exports.mapCancellationDetails = require_stripe_mapper.mapCancellationDetails;
 exports.mapCharge = require_stripe_mapper.mapCharge;
 exports.mapCheckoutSession = require_stripe_mapper.mapCheckoutSession;
 exports.mapInvoice = require_stripe_mapper.mapInvoice;

package/dist/stripe/index.d.cts

@@ -1,8 +1,9 @@
+import { CancellationDetails } from "../subscription/index.cjs";
 import { PriceId, StripeConfig, StripeMode } from "./config.cjs";
 import { StripeEventHandler } from "./handler.cjs";
-import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.cjs";
-import { CancellationDetails, CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.cjs";
+import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.cjs";
+import { CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.cjs";
 import { METADATA_KEYS } from "./metadata.cjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.cjs";
 import { Stripe } from "stripe";
-export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };
+export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };

package/dist/stripe/index.d.mts

@@ -1,8 +1,9 @@
+import { CancellationDetails } from "../subscription/index.mjs";
 import { PriceId, StripeConfig, StripeMode } from "./config.mjs";
 import { StripeEventHandler } from "./handler.mjs";
-import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
-import { CancellationDetails, CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.mjs";
+import { BeginCheckoutProperties, CheckoutSession, LineItem, PaymentStatus, Price, ProductPrice, PurchaseProperties, getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
+import { CreateCheckoutSessionDTO, cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.mjs";
 import { METADATA_KEYS } from "./metadata.mjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.mjs";
 import { Stripe } from "stripe";
-export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };
+export { type BeginCheckoutProperties, type CancellationDetails, type CheckoutSession, type CreateCheckoutSessionDTO, type LineItem, METADATA_KEYS, type PaymentStatus, type Price, type PriceId, type ProductPrice, type PurchaseProperties, type Stripe, StripeConfig, StripeEventHandler, type StripeMode, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };

package/dist/stripe/index.mjs

@@ -1,7 +1,7 @@
 import { StripeConfig } from "./config.mjs";
 import { StripeEventHandler } from "./handler.mjs";
-import { getBeginCheckoutProperties, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
+import { getBeginCheckoutProperties, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price } from "./mapper.mjs";
 import { cancellationDetailsSchema, createCheckoutSessionSchema } from "./schema.mjs";
 import { METADATA_KEYS } from "./metadata.mjs";
 import { addPendingCheckout, getPendingCheckouts, removePendingCheckout } from "./pending-checkout.mjs";
-export { METADATA_KEYS, StripeConfig, StripeEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };
+export { METADATA_KEYS, StripeConfig, StripeEventHandler, addPendingCheckout, cancellationDetailsSchema, createCheckoutSessionSchema, getBeginCheckoutProperties, getPendingCheckouts, getPurchaseProperties, mapCancellationDetails, mapCharge, mapCheckoutSession, mapInvoice, mapLineItem, mapPaymentIntent, mapPrice, mapSubscriptionStatus, mapTime, minorUnits, price, removePendingCheckout };

package/dist/stripe/mapper.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_subscription_index = require("../subscription/index.cjs");
 //#region src/stripe/mapper.ts
 function mapTime(stripeTimestampSeconds) {
 	if (!stripeTimestampSeconds) return null;
@@ -198,10 +199,27 @@ function getBeginCheckoutProperties(p) {
 		}]
 	};
 }
+/**
+* Stripe's `cancellation_details` in the shared shape. The object is present on every
+* subscription with all three fields null, so an active one maps to null rather than an empty
+* record. `reason` says who acted: `cancellation_requested` is the customer (or us on their
+* behalf), the payment reasons are Stripe ending it.
+*/
+function mapCancellationDetails(subscription) {
+	const details = subscription.cancellation_details;
+	if (!details || !details.reason && !details.feedback && !details.comment) return null;
+	return {
+		initiator: details.reason === "payment_failed" || details.reason === "payment_disputed" ? "system" : "user",
+		reason: details.reason ?? null,
+		feedback: details.feedback ? require_subscription_index.CANCELLATION_FEEDBACKS.includes(details.feedback) ? details.feedback : "other" : null,
+		comment: details.comment ?? null
+	};
+}
 //#endregion
 exports.ZERO_DECIMAL_CURRENCIES = ZERO_DECIMAL_CURRENCIES;
 exports.getBeginCheckoutProperties = getBeginCheckoutProperties;
 exports.getPurchaseProperties = getPurchaseProperties;
+exports.mapCancellationDetails = mapCancellationDetails;
 exports.mapCharge = mapCharge;
 exports.mapCheckoutSession = mapCheckoutSession;
 exports.mapInvoice = mapInvoice;