@shware/purchase 5.0.0 → 5.1.1

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

@@ -20,7 +20,7 @@ type Options = {
   appId: `${number}`;
   bundleId: string;
 };
-declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
+export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   readonly appId: string;
   readonly bundleId: string;
   private readonly products;
@@ -45,5 +45,4 @@ declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, P
   getCreditExpiresAt: (productId: string) => string;
 }
 //#endregion
-export { AppStoreConfig };
 //# sourceMappingURL=config.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;cAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;qBAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}

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

@@ -20,7 +20,7 @@ type Options = {
   appId: `${number}`;
   bundleId: string;
 };
-declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
+export declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PL extends string = never, PI extends string = never> {
   readonly appId: string;
   readonly bundleId: string;
   private readonly products;
@@ -45,5 +45,4 @@ declare class AppStoreConfig<NS extends Lowercase<string> = Lowercase<string>, P
   getCreditExpiresAt: (productId: string) => string;
 }
 //#endregion
-export { AppStoreConfig };
 //# sourceMappingURL=config.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;cAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/app-store/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,2BACA;WAES,MAAM;WACN,eAAe;WACf,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI;WACvC,UAAU,YAAY;EAE/B,kBAAkB;EAElB,YAAY,QAAQ,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,eAAe;;;;;;EAajF,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI;EAM5C,UAAO,kBAAsB,MAAC,eAAA,IAAA,IAAA,IAAA,IAAA;;KAW3B;EAAY;EAAoB;;qBAExB,eACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA;WAES;WACA;mBAEQ;mBACA;mBACA;mBACA;MAEb;GAMH,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI,IAAI;UAWnD;SASA,SAAU,aAAW,mBAAmB,qBAAmB,8BAA0B,SACjF,YAAO,eAAA,MAAA,MAAA;;EAMlB,eAAgB,UAAU,IAAI,UAAU,IAAE,MAClC,GAAC,kBACW,KAAK,YAAY,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,QAAA,KAAA,KAAA;EAMnD,aAAc,aAAa,MAAM,qBAAmB,WACvC,UAAU,aAAa,GAAC,WACzB,aAKK,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;EAGrD,gBAAiB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAI1E,eAAe,IAAI,IAAI,IAAI,IAAI,KAAK;;EAIrD,sBAAmB,MAAU,IAAE,eAAiB;EAUhD,UAAO,sBAAwB;EAO/B,mBAAgB,sBAAwB;EAOxC,UAAO;EAQP,kBAAe;mBAOE;EAMjB,qBAAkB"}

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

@@ -1,6 +1,6 @@
 import { JWSRenewalInfoDecodedPayload, JWSTransactionDecodedPayload, NotificationTypeV2, ResponseBodyV2DecodedPayload } from "@apple/app-store-server-library";
 //#region src/app-store/handler.d.ts
-interface AppStoreNotificationEvent {
+export interface AppStoreNotificationEvent {
   payload: ResponseBodyV2DecodedPayload;
   transaction: JWSTransactionDecodedPayload | null;
   renewalInfo: JWSRenewalInfoDecodedPayload | null;
@@ -12,7 +12,7 @@ type NotificationHandlerFn = (event: AppStoreNotificationEvent) => Promise<void>
  * renewalInfo) first and passes the decoded event in. Subtype branching stays inside each
  * handler: Apple subtypes share the handler's derived context and are usually a few lines each.
  */
-declare class AppStoreNotificationHandler {
+export declare class AppStoreNotificationHandler {
   private readonly handlers;
   private constructor();
   static create(): AppStoreNotificationHandler;
@@ -20,5 +20,4 @@ declare class AppStoreNotificationHandler {
   process: (event: AppStoreNotificationEvent) => Promise<void>;
 }
 //#endregion
-export { AppStoreNotificationEvent, AppStoreNotificationHandler };
 //# sourceMappingURL=handler.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.cts","names":[],"sources":["../../src/app-store/handler.ts"],"mappings":";;UAOiB;EACf,SAAS;EACT,aAAa;EACb,aAAa;;KAGV,yBAAyB,OAAO,8BAA8B;;;;;;;cAQtD;mBACM;UAEV;SAIA,UAAM;EAIb,KAAE,MAAU,oBAAkB,SAAW;EASzC,UAAO,OAAiB,8BAA4B"}
+{"version":3,"file":"handler.d.cts","names":[],"sources":["../../src/app-store/handler.ts"],"mappings":";;iBAOiB;EACf,SAAS;EACT,aAAa;EACb,aAAa;;KAGV,yBAAyB,OAAO,8BAA8B;;;;;;;qBAQtD;mBACM;UAEV;SAIA,UAAM;EAIb,KAAE,MAAU,oBAAkB,SAAW;EASzC,UAAO,OAAiB,8BAA4B"}

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

@@ -1,6 +1,6 @@
 import { JWSRenewalInfoDecodedPayload, JWSTransactionDecodedPayload, NotificationTypeV2, ResponseBodyV2DecodedPayload } from "@apple/app-store-server-library";
 //#region src/app-store/handler.d.ts
-interface AppStoreNotificationEvent {
+export interface AppStoreNotificationEvent {
   payload: ResponseBodyV2DecodedPayload;
   transaction: JWSTransactionDecodedPayload | null;
   renewalInfo: JWSRenewalInfoDecodedPayload | null;
@@ -12,7 +12,7 @@ type NotificationHandlerFn = (event: AppStoreNotificationEvent) => Promise<void>
  * renewalInfo) first and passes the decoded event in. Subtype branching stays inside each
  * handler: Apple subtypes share the handler's derived context and are usually a few lines each.
  */
-declare class AppStoreNotificationHandler {
+export declare class AppStoreNotificationHandler {
   private readonly handlers;
   private constructor();
   static create(): AppStoreNotificationHandler;
@@ -20,5 +20,4 @@ declare class AppStoreNotificationHandler {
   process: (event: AppStoreNotificationEvent) => Promise<void>;
 }
 //#endregion
-export { AppStoreNotificationEvent, AppStoreNotificationHandler };
 //# sourceMappingURL=handler.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.mts","names":[],"sources":["../../src/app-store/handler.ts"],"mappings":";;UAOiB;EACf,SAAS;EACT,aAAa;EACb,aAAa;;KAGV,yBAAyB,OAAO,8BAA8B;;;;;;;cAQtD;mBACM;UAEV;SAIA,UAAM;EAIb,KAAE,MAAU,oBAAkB,SAAW;EASzC,UAAO,OAAiB,8BAA4B"}
+{"version":3,"file":"handler.d.mts","names":[],"sources":["../../src/app-store/handler.ts"],"mappings":";;iBAOiB;EACf,SAAS;EACT,aAAa;EACb,aAAa;;KAGV,yBAAyB,OAAO,8BAA8B;;;;;;;qBAQtD;mBACM;UAEV;SAIA,UAAM;EAIb,KAAE,MAAU,oBAAkB,SAAW;EASzC,UAAO,OAAiB,8BAA4B"}

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,24 @@
+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.
+ */
+export 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)
+ */
+export declare function mapCancellationDetails(source: AppStoreCancellationSource): CancellationDetails | null;
+//#endregion
+//# 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":";;;;;;;;iBAQiB;EACf;EACA;;EAEA;;;;;;;;;wBAUc,uBACd,QAAQ,6BACP"}

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

@@ -0,0 +1,24 @@
+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.
+ */
+export 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)
+ */
+export declare function mapCancellationDetails(source: AppStoreCancellationSource): CancellationDetails | null;
+//#endregion
+//# 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":";;;;;;;;iBAQiB;EACf;EACA;;EAEA;;;;;;;;;wBAUc,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/config.d.cts

@@ -22,7 +22,7 @@ type Options = {
   package: string;
   audience: string;
 };
-declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PI extends string = never> {
+export declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PI extends string = never> {
   readonly package: string;
   readonly audience: string;
   private readonly onetimes;
@@ -44,5 +44,4 @@ declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>,
   getCreditExpiresAt: (productId: string, planId?: string) => string;
 }
 //#endregion
-export { GooglePlayConfig };
 //# sourceMappingURL=config.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/google-play/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,UAAU;WAED;WACA,QAAQ,iBAAiB,IAAI,IAAI,IAAI;WACrC,OAAO,YAAY;IAAa,OAAO;IAAI,gBAAgB;;WAC3D,cAAc;EAEvB,YAAY,QAAQ,iBAAiB,IAAI,IAAI,IAAI,KAAK;;;;;;EAYtD,WAAY,UAAU,mBAAiB,QAC7B,UAAU,YAAY,GAAC,MACzB,IAAE,eACO,IAAE,WACP,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,IAAI;EAMpC,gBAAiB,oBAAoB,MAAM,MAAI,SACpC,KAAK,SAAS,uCAAkC,iBAAA,IAAA,IAAA,IAAA;;KAWxD;EAAY;EAAiB;;cAErB,iBACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA;WAES;WACA;mBACQ;mBACA;mBACA;GAIhB,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI;mBAcrC;UAIV;SAQA,SACL,aAAW,mBACX,8BACA,8BAA0B,SAEjB,YAAO,iBAAA,MAAA,MAAA;EAKlB,eAAgB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;EAI3F,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aAKK,iBAAiB,IAAI,IAAI,IAAI,KAAK;;EAInD,oBAAiB;EAMjB,UAAO,mBAAqB,mBAAmB;EAQ/C,mBAAgB,mBAAqB,mBAAmB;EAQxD,UAAO;EAMP,kBAAe,mBAAqB;mBAOnB;EAOjB,qBAAkB,mBAAqB"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/google-play/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,UAAU;WAED;WACA,QAAQ,iBAAiB,IAAI,IAAI,IAAI;WACrC,OAAO,YAAY;IAAa,OAAO;IAAI,gBAAgB;;WAC3D,cAAc;EAEvB,YAAY,QAAQ,iBAAiB,IAAI,IAAI,IAAI,KAAK;;;;;;EAYtD,WAAY,UAAU,mBAAiB,QAC7B,UAAU,YAAY,GAAC,MACzB,IAAE,eACO,IAAE,WACP,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,IAAI;EAMpC,gBAAiB,oBAAoB,MAAM,MAAI,SACpC,KAAK,SAAS,uCAAkC,iBAAA,IAAA,IAAA,IAAA;;KAWxD;EAAY;EAAiB;;qBAErB,iBACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA;WAES;WACA;mBACQ;mBACA;mBACA;GAIhB,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI;mBAcrC;UAIV;SAQA,SACL,aAAW,mBACX,8BACA,8BAA0B,SAEjB,YAAO,iBAAA,MAAA,MAAA;EAKlB,eAAgB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;EAI3F,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aAKK,iBAAiB,IAAI,IAAI,IAAI,KAAK;;EAInD,oBAAiB;EAMjB,UAAO,mBAAqB,mBAAmB;EAQ/C,mBAAgB,mBAAqB,mBAAmB;EAQxD,UAAO;EAMP,kBAAe,mBAAqB;mBAOnB;EAOjB,qBAAkB,mBAAqB"}

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

@@ -22,7 +22,7 @@ type Options = {
   package: string;
   audience: string;
 };
-declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PI extends string = never> {
+export declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>, PE extends string = string, BP extends string = string, PI extends string = never> {
   readonly package: string;
   readonly audience: string;
   private readonly onetimes;
@@ -44,5 +44,4 @@ declare class GooglePlayConfig<NS extends Lowercase<string> = Lowercase<string>,
   getCreditExpiresAt: (productId: string, planId?: string) => string;
 }
 //#endregion
-export { GooglePlayConfig };
 //# sourceMappingURL=config.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/google-play/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,UAAU;WAED;WACA,QAAQ,iBAAiB,IAAI,IAAI,IAAI;WACrC,OAAO,YAAY;IAAa,OAAO;IAAI,gBAAgB;;WAC3D,cAAc;EAEvB,YAAY,QAAQ,iBAAiB,IAAI,IAAI,IAAI,KAAK;;;;;;EAYtD,WAAY,UAAU,mBAAiB,QAC7B,UAAU,YAAY,GAAC,MACzB,IAAE,eACO,IAAE,WACP,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,IAAI;EAMpC,gBAAiB,oBAAoB,MAAM,MAAI,SACpC,KAAK,SAAS,uCAAkC,iBAAA,IAAA,IAAA,IAAA;;KAWxD;EAAY;EAAiB;;cAErB,iBACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA;WAES;WACA;mBACQ;mBACA;mBACA;GAIhB,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI;mBAcrC;UAIV;SAQA,SACL,aAAW,mBACX,8BACA,8BAA0B,SAEjB,YAAO,iBAAA,MAAA,MAAA;EAKlB,eAAgB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;EAI3F,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aAKK,iBAAiB,IAAI,IAAI,IAAI,KAAK;;EAInD,oBAAiB;EAMjB,UAAO,mBAAqB,mBAAmB;EAQ/C,mBAAgB,mBAAqB,mBAAmB;EAQxD,UAAO;EAMP,kBAAe,mBAAqB;mBAOnB;EAOjB,qBAAkB,mBAAqB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/google-play/config.ts"],"mappings":";;cAIM;cAEA,aACJ,WAAW,oBAAoB,mBAC/B,4BACA,4BACA,2BACA,UAAU;WAED;WACA,QAAQ,iBAAiB,IAAI,IAAI,IAAI;WACrC,OAAO,YAAY;IAAa,OAAO;IAAI,gBAAgB;;WAC3D,cAAc;EAEvB,YAAY,QAAQ,iBAAiB,IAAI,IAAI,IAAI,KAAK;;;;;;EAYtD,WAAY,UAAU,mBAAiB,QAC7B,UAAU,YAAY,GAAC,MACzB,IAAE,eACO,IAAE,WACP,aACT,aAAa,IAAI,IAAI,IAAI,IAAI,IAAI;EAMpC,gBAAiB,oBAAoB,MAAM,MAAI,SACpC,KAAK,SAAS,uCAAkC,iBAAA,IAAA,IAAA,IAAA;;KAWxD;EAAY;EAAiB;;qBAErB,iBACX,WAAW,oBAAoB,mBAC/B,4BACA,4BACA;WAES;WACA;mBACQ;mBACA;mBACA;GAIhB,aAAU,cAAkB,aAAa,IAAI,IAAI,IAAI;mBAcrC;UAIV;SAQA,SACL,aAAW,mBACX,8BACA,8BAA0B,SAEjB,YAAO,iBAAA,MAAA,MAAA;EAKlB,eAAgB,aAAa,MAAM,qBAAmB,WAAa,UAAU,aAAa,MAAC,aAAA,IAAA,IAAA,IAAA,IAAA;EAI3F,UAAW,aAAa,MAAM,qBAAmB,WACpC,UAAU,aAAa,GAAC,WACzB,aAKK,iBAAiB,IAAI,IAAI,IAAI,KAAK;;EAInD,oBAAiB;EAMjB,UAAO,mBAAqB,mBAAmB;EAQ/C,mBAAgB,mBAAqB,mBAAmB;EAQxD,UAAO;EAMP,kBAAe,mBAAqB;mBAOnB;EAOjB,qBAAkB,mBAAqB"}

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,34 @@
+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;
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null;
 //#endregion
-export { 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":";;;wBAGgB,sBAAsB,OAAO,8BAA8B;;;;;iBAoC1D;EACf;IACE;IACA;MAAuB;MAAwB;;;EAEjD;EACA;EACA;;;;;;;;wBASc,uBACd,SAAS,0CACR;;;;;wBAwBa,cAAc,SAAS"}

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

@@ -1,7 +1,34 @@
+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;
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function mapCanceledAt(context: CanceledStateContext | null | undefined): string | null;
 //#endregion
-export { 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":";;;wBAGgB,sBAAsB,OAAO,8BAA8B;;;;;iBAoC1D;EACf;IACE;IACA;MAAuB;MAAwB;;;EAEjD;EACA;EACA;;;;;;;;wBASc,uBACd,SAAS,0CACR;;;;;wBAwBa,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