@nosslabs/iap 7.0.0 → 8.0.0-next.0

package/CHANGELOG.md

@@ -5,6 +5,92 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version
 
 ## [Unreleased]
 
+## [8.0.0-next.0] — 2026-08-17
+
+**First release of the Capacitor 8 line, on the `@next` npm dist-tag.** The
+Capacitor 7 line continues as `7.x` on `@latest` (and on the new `@latest-7`
+dist-tag); `@latest` stays at `7.1.0` until the 8.x line graduates. Install the
+candidate with `npm install @nosslabs/iap@next`.
+
+Note that `@next` previously pointed at `7.0.0-next.0`, a Capacitor 7
+prerelease; it now moves to the Capacitor 8 line. `7.0.0-next.0` remains
+installable by exact version.
+
+**Opens the Capacitor 8 line.** Same library, next platform major: the peer
+range moves from Capacitor 7 to Capacitor 8, and nothing else changes. Cap-7
+consumers stay on `7.x` — `^7` ranges don't auto-resolve to `8.x`.
+
+### Changed (BREAKING, vs `7.1.0` — peer range only)
+
+- **Anchored the `8.x` line to Capacitor 8.** Peer dependencies moved to
+  `@capacitor/core`, `@capacitor/preferences` and (optional) `@capacitor/app`
+  at `>=8.0.0` — the forward-open range that upstream `@capacitor/*` plugins
+  and `@capgo/native-purchases` themselves declare — and
+  `@capgo/native-purchases` at `^8.0.0`, which stays a caret because the
+  adapter binds to its method signatures. The Cap-7 ranges
+  (`@capacitor/*: ^7.0.0`, `@capgo/native-purchases: ^7.16.2`) are dropped —
+  they were the only thing blocking a clean `npm install` in a Capacitor 8 app.
+  Upgrading is a peer-dep bump plus `npx cap sync`.
+- **`VERSION` is now typed `string` rather than the literal `"0.1.0"`.** It is
+  injected from `package.json` at build time instead of being hard-coded, so
+  it finally reports the version that is actually installed.
+
+### Fixed
+
+- **CommonJS consumers can type-check again.** The `exports` map declared a
+  single top-level `types` entry, so `require()` resolved the CommonJS bundle
+  against ESM declarations and `tsc` failed with TS1479 under
+  `moduleResolution: node16`/`nodenext`. `types` is now nested per condition,
+  with `require` pointing at the `dist/index.d.cts` the build already emitted.
+  Affects `7.1.0` and earlier too.
+- **`VERSION` no longer reports `0.1.0`.** It was hard-coded and never updated
+  by any publish step, so error reports from every released build
+  misattributed their version.
+
+### Notes
+
+- **No runtime API changes.** `createIAP({ ... })` config, the `IAP` instance
+  surface, the event map, the error codes and the backend contract are all
+  byte-for-byte what `7.1.0` shipped. Nothing in `src/` needed a call-site fix:
+  every `@capgo/native-purchases` method this library calls
+  (`isBillingSupported`, `getProducts`, `purchaseProduct`, `getPurchases`,
+  `acknowledgePurchase`, `manageSubscriptions`, `getStorefront`) keeps its
+  `7.16.2` signature in `8.6.5`. The plugin's v8 additions — `consumePurchase()`,
+  `presentOfferCodeRedeemSheet()`, the `billingPlanType` purchase option, the
+  `onlyCurrentEntitlements` filter on `getPurchases()`, and the StoreKit
+  commitment/renewal metadata on `Product` and `Transaction` — are all optional
+  and none are consumed.
+- **`getStorefront()` keeps its capability probe.** The plugin declares
+  `getStorefront()` on its TypeScript interface as of `8.5.0`, but the peer
+  range also admits `8.0.0`–`8.4.x`, which don't register the native method. The
+  adapter therefore still gates on the Capacitor plugin header rather than the
+  declared type, and still resolves `null` when the method is absent — including
+  for the plugin's own "storefront unavailable" signal, an empty `countryCode`.
+
+## [7.1.0] — 2026-07-04
+
+### Added
+
+- `iap.getStorefront(): Promise<Storefront | null>` — reads the user's App
+  Store / Google Play storefront (the country their store account is registered
+  to). Returns the new exported `Storefront` type, with `countryCode` normalized
+  to ISO 3166-1 alpha-2 across platforms (iOS reports alpha-3, Android alpha-2);
+  the raw native value is preserved on `countryCodeRaw`, plus the Apple
+  `storefrontId` (iOS only) and `platform`. Resolves `null` on web, when the
+  installed `@capgo/native-purchases` build doesn't register the native
+  `getStorefront` method, or when the storefront is unavailable (e.g. EU
+  alternative distribution). Read it live and treat it as a UX/targeting hint —
+  for compliance/entitlement decisions, trust the server-side signed storefront.
+
+### Changed
+
+- Anchored the `7.x` line to **Capacitor 7**: peer dependencies narrowed to
+  `@capacitor/*: ^7.0.0` and `@capgo/native-purchases: ^7.16.2` (dropping the
+  `^8.0.0` allowances). The `^7.16.2` range admits the Capacitor-7 capgo build
+  that adds native `getStorefront`. Capacitor-8 support will ship in
+  `@nosslabs/iap` v8. (`getStorefront()` itself still degrades gracefully on
+  capgo builds that predate the native method.)
+
 ## [7.0.0] — 2026-05-14
 
 **GA of the Capacitor 7+ line.** `@latest` on npm moves from `5.0.0`

package/README.md

@@ -2,10 +2,15 @@
 
 > Thin Capacitor IAP orchestrator. Server-side validation via [Attesto](https://attesto.nossdev.com).
 
-**Status: `7.0.0` — GA on `@latest`** (the Capacitor 7+ line, built on `@capgo/native-purchases`). The Capacitor 5 line (`cordova-plugin-purchase`) continues as `5.x` from the `5.x` branch — `^5` ranges still resolve to `5.x`. See the [CHANGELOG](./CHANGELOG.md) for the GA delta and [Migration](https://iap.nossdev.com/migration/) for upgrading from `5.x`.
+**Status: `8.0.0-next.0` — the Capacitor 8 line, on `@next`** (built on `@capgo/native-purchases@^8`). `@latest` remains `7.1.0` (Capacitor 7) while the 8.x line soaks. The Capacitor 7 line continues as `7.x` (also on `@latest-7`) and the Capacitor 5 line (`cordova-plugin-purchase`) as `5.x` — `^7` and `^5` ranges still resolve to their own lines. See the [CHANGELOG](./CHANGELOG.md) for the `8.0.0-next.0` delta and [Migration](https://iap.nossdev.com/migration/).
 
 ```bash
-npm install @nosslabs/iap @capgo/native-purchases
+# Capacitor 8 — release candidate, on @next
+npm install @nosslabs/iap@next @capgo/native-purchases
+
+# Capacitor 7 — the current @latest line
+npm install @nosslabs/iap @capgo/native-purchases@lts-v7
+
 npx cap sync
 ```
 
@@ -77,8 +82,9 @@ It does **not**: talk to Attesto directly, define entitlement business logic, ma
 
 | `@nosslabs/iap` | Capacitor | Native plugin | dist-tag | Status |
 |---|---|---|---|---|
-| 7.x | 7.x (also runs on 8.x) | `@capgo/native-purchases 7.16.x` (or `^8` on Cap 8) | `@latest` | **Current** |
-| 5.x | 5.x | `cordova-plugin-purchase ^13.x` | (pinned via `^5`) | Maintenance |
+| 8.x | 8.x and later | `@capgo/native-purchases ^8` | `@next` | **Release candidate** — `8.0.0-next.0` |
+| 7.x | 7.x | `@capgo/native-purchases@lts-v7` | `@latest`, `@latest-7` | **Current** |
+| 5.x | 5.x | `cordova-plugin-purchase ^13.x` | `@latest-5` (pin via `^5`) | Maintenance |
 
 ## Optional peer dependency
 

package/dist/index.cjs

@@ -139,11 +139,293 @@ var init_platform = __esm({
   }
 });
 
+// src/lib/iso-country.ts
+function toAlpha2(code) {
+  if (!code) return null;
+  const normalized = code.trim().toUpperCase();
+  if (normalized.length === 2) return normalized;
+  if (normalized.length === 3) return ALPHA3_TO_ALPHA2[normalized] ?? null;
+  return null;
+}
+var ALPHA3_TO_ALPHA2;
+var init_iso_country = __esm({
+  "src/lib/iso-country.ts"() {
+    ALPHA3_TO_ALPHA2 = {
+      ABW: "AW",
+      AFG: "AF",
+      AGO: "AO",
+      AIA: "AI",
+      ALA: "AX",
+      ALB: "AL",
+      AND: "AD",
+      ARE: "AE",
+      ARG: "AR",
+      ARM: "AM",
+      ASM: "AS",
+      ATA: "AQ",
+      ATF: "TF",
+      ATG: "AG",
+      AUS: "AU",
+      AUT: "AT",
+      AZE: "AZ",
+      BDI: "BI",
+      BEL: "BE",
+      BEN: "BJ",
+      BES: "BQ",
+      BFA: "BF",
+      BGD: "BD",
+      BGR: "BG",
+      BHR: "BH",
+      BHS: "BS",
+      BIH: "BA",
+      BLM: "BL",
+      BLR: "BY",
+      BLZ: "BZ",
+      BMU: "BM",
+      BOL: "BO",
+      BRA: "BR",
+      BRB: "BB",
+      BRN: "BN",
+      BTN: "BT",
+      BVT: "BV",
+      BWA: "BW",
+      CAF: "CF",
+      CAN: "CA",
+      CCK: "CC",
+      CHE: "CH",
+      CHL: "CL",
+      CHN: "CN",
+      CIV: "CI",
+      CMR: "CM",
+      COD: "CD",
+      COG: "CG",
+      COK: "CK",
+      COL: "CO",
+      COM: "KM",
+      CPV: "CV",
+      CRI: "CR",
+      CUB: "CU",
+      CUW: "CW",
+      CXR: "CX",
+      CYM: "KY",
+      CYP: "CY",
+      CZE: "CZ",
+      DEU: "DE",
+      DJI: "DJ",
+      DMA: "DM",
+      DNK: "DK",
+      DOM: "DO",
+      DZA: "DZ",
+      ECU: "EC",
+      EGY: "EG",
+      ERI: "ER",
+      ESH: "EH",
+      ESP: "ES",
+      EST: "EE",
+      ETH: "ET",
+      FIN: "FI",
+      FJI: "FJ",
+      FLK: "FK",
+      FRA: "FR",
+      FRO: "FO",
+      FSM: "FM",
+      GAB: "GA",
+      GBR: "GB",
+      GEO: "GE",
+      GGY: "GG",
+      GHA: "GH",
+      GIB: "GI",
+      GIN: "GN",
+      GLP: "GP",
+      GMB: "GM",
+      GNB: "GW",
+      GNQ: "GQ",
+      GRC: "GR",
+      GRD: "GD",
+      GRL: "GL",
+      GTM: "GT",
+      GUF: "GF",
+      GUM: "GU",
+      GUY: "GY",
+      HKG: "HK",
+      HMD: "HM",
+      HND: "HN",
+      HRV: "HR",
+      HTI: "HT",
+      HUN: "HU",
+      IDN: "ID",
+      IMN: "IM",
+      IND: "IN",
+      IOT: "IO",
+      IRL: "IE",
+      IRN: "IR",
+      IRQ: "IQ",
+      ISL: "IS",
+      ISR: "IL",
+      ITA: "IT",
+      JAM: "JM",
+      JEY: "JE",
+      JOR: "JO",
+      JPN: "JP",
+      KAZ: "KZ",
+      KEN: "KE",
+      KGZ: "KG",
+      KHM: "KH",
+      KIR: "KI",
+      KNA: "KN",
+      KOR: "KR",
+      KWT: "KW",
+      LAO: "LA",
+      LBN: "LB",
+      LBR: "LR",
+      LBY: "LY",
+      LCA: "LC",
+      LIE: "LI",
+      LKA: "LK",
+      LSO: "LS",
+      LTU: "LT",
+      LUX: "LU",
+      LVA: "LV",
+      MAC: "MO",
+      MAF: "MF",
+      MAR: "MA",
+      MCO: "MC",
+      MDA: "MD",
+      MDG: "MG",
+      MDV: "MV",
+      MEX: "MX",
+      MHL: "MH",
+      MKD: "MK",
+      MLI: "ML",
+      MLT: "MT",
+      MMR: "MM",
+      MNE: "ME",
+      MNG: "MN",
+      MNP: "MP",
+      MOZ: "MZ",
+      MRT: "MR",
+      MSR: "MS",
+      MTQ: "MQ",
+      MUS: "MU",
+      MWI: "MW",
+      MYS: "MY",
+      MYT: "YT",
+      NAM: "NA",
+      NCL: "NC",
+      NER: "NE",
+      NFK: "NF",
+      NGA: "NG",
+      NIC: "NI",
+      NIU: "NU",
+      NLD: "NL",
+      NOR: "NO",
+      NPL: "NP",
+      NRU: "NR",
+      NZL: "NZ",
+      OMN: "OM",
+      PAK: "PK",
+      PAN: "PA",
+      PCN: "PN",
+      PER: "PE",
+      PHL: "PH",
+      PLW: "PW",
+      PNG: "PG",
+      POL: "PL",
+      PRI: "PR",
+      PRK: "KP",
+      PRT: "PT",
+      PRY: "PY",
+      PSE: "PS",
+      PYF: "PF",
+      QAT: "QA",
+      REU: "RE",
+      ROU: "RO",
+      RUS: "RU",
+      RWA: "RW",
+      SAU: "SA",
+      SDN: "SD",
+      SEN: "SN",
+      SGP: "SG",
+      SGS: "GS",
+      SHN: "SH",
+      SJM: "SJ",
+      SLB: "SB",
+      SLE: "SL",
+      SLV: "SV",
+      SMR: "SM",
+      SOM: "SO",
+      SPM: "PM",
+      SRB: "RS",
+      SSD: "SS",
+      STP: "ST",
+      SUR: "SR",
+      SVK: "SK",
+      SVN: "SI",
+      SWE: "SE",
+      SWZ: "SZ",
+      SXM: "SX",
+      SYC: "SC",
+      SYR: "SY",
+      TCA: "TC",
+      TCD: "TD",
+      TGO: "TG",
+      THA: "TH",
+      TJK: "TJ",
+      TKL: "TK",
+      TKM: "TM",
+      TLS: "TL",
+      TON: "TO",
+      TTO: "TT",
+      TUN: "TN",
+      TUR: "TR",
+      TUV: "TV",
+      TWN: "TW",
+      TZA: "TZ",
+      UGA: "UG",
+      UKR: "UA",
+      UMI: "UM",
+      URY: "UY",
+      USA: "US",
+      UZB: "UZ",
+      VAT: "VA",
+      VCT: "VC",
+      VEN: "VE",
+      VGB: "VG",
+      VIR: "VI",
+      VNM: "VN",
+      VUT: "VU",
+      WLF: "WF",
+      WSM: "WS",
+      YEM: "YE",
+      ZAF: "ZA",
+      ZMB: "ZM",
+      ZWE: "ZW"
+    };
+  }
+});
+
 // src/adapters/native/capgo/native-adapter.ts
 var native_adapter_exports = {};
 __export(native_adapter_exports, {
   CapgoNativeAdapter: () => CapgoNativeAdapter
 });
+function nativeStorefrontRegistered() {
+  const headers = core.Capacitor.PluginHeaders;
+  return headers?.find((h) => h.name === "NativePurchases")?.methods?.some((m) => m.name === "getStorefront") ?? false;
+}
+function normalizeStorefront(raw) {
+  const code = raw?.countryCode?.trim();
+  if (!code) return null;
+  const platform = getPlatform() === "android" ? "google" : "apple";
+  return {
+    // alpha-2 when recognized; otherwise the uppercased raw code as a
+    // best-effort fallback (see `Storefront.countryCode`).
+    countryCode: toAlpha2(code) ?? code.toUpperCase(),
+    countryCodeRaw: code,
+    storefrontId: raw.storefrontId,
+    platform
+  };
+}
 function normalizeProduct(p, type) {
   const priceMicros = Math.round(p.price * 1e6).toString();
   return {
@@ -219,6 +501,7 @@ var CapgoNativeAdapter;
 var init_native_adapter = __esm({
   "src/adapters/native/capgo/native-adapter.ts"() {
     init_errors();
+    init_iso_country();
     init_platform();
     CapgoNativeAdapter = class {
       async isAvailable() {
@@ -302,6 +585,24 @@ var init_native_adapter = __esm({
           });
         }
       }
+      /**
+       * Read the current storefront from the native plugin — which is expected to
+       * source it from StoreKit 2 `Storefront.current` on iOS (alpha-3) and
+       * `getBillingConfigAsync()` on Android (alpha-2) — normalizing `countryCode`
+       * to alpha-2. Silent like {@link CapgoNativeAdapter.isAvailable}: any
+       * unavailability — older plugin (no native method registered), native
+       * rejection, or empty country — resolves to `null` rather than throwing.
+       */
+      async getStorefront() {
+        if (!nativeStorefrontRegistered()) return null;
+        const np = nativePurchases.NativePurchases;
+        try {
+          const raw = await np.getStorefront?.();
+          return raw ? normalizeStorefront(raw) : null;
+        } catch {
+          return null;
+        }
+      }
       async dispose() {
       }
     };
@@ -832,6 +1133,9 @@ var WebStubAdapter = class {
       message: "Subscription management is not supported on the web platform."
     });
   }
+  async getStorefront() {
+    return null;
+  }
 };
 
 // src/adapters/native/index.ts
@@ -1933,6 +2237,10 @@ function createIAP(input) {
       }
       return state.adapter.getProducts(state.products.map((p) => ({ id: p.id, type: p.type })));
     },
+    async getStorefront() {
+      requireInitialized(state);
+      return state.adapter?.getStorefront?.() ?? null;
+    },
     hasEntitlement(key) {
       return state.entitlements.some((e) => e.key === key);
     },
@@ -1996,7 +2304,7 @@ function requireInitialized(state) {
 init_errors();
 
 // src/version.ts
-var VERSION = "0.1.0";
+var VERSION = "8.0.0-next.0";
 
 exports.DEFAULT_PERMANENT_ERROR_CODES = DEFAULT_PERMANENT_ERROR_CODES;
 exports.HttpBackendAdapter = HttpBackendAdapter;