@nosslabs/iap 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -5,6 +5,39 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version
 
 ## [Unreleased]
 
+## [0.3.1] — 2026-05-06
+
+### Added
+
+- **`appUserId` async fetcher may now accept an optional `ctx`
+  parameter.** The library passes `{ authHeaders }` populated from
+  `backend.getAuthHeaders()` (resolved fresh per purchase), letting
+  consumers reuse the same auth they configured for IAP-backend
+  requests when their UUID-minting endpoint uses that same auth.
+  The parameter is optional convenience, not contract — zero-arg
+  fetchers from 0.2.x continue to work unchanged. Ignore the
+  parameter when your UUID endpoint uses different auth and close
+  over your own auth state instead. For consumers using a custom
+  `BackendAdapter` (no `getAuthHeaders` configured), `ctx.authHeaders`
+  is `{}`.
+
+  ```ts
+  // before — still valid
+  appUserId: async () => {
+    const r = await fetch('/api/iap/uuid', { headers: authHeaders() });
+    return (await r.json()).uuid;
+  }
+
+  // after — equivalent, no helper duplication
+  appUserId: async ({ authHeaders }) => {
+    const r = await fetch('/api/iap/uuid', { headers: authHeaders });
+    return (await r.json()).uuid;
+  }
+  ```
+
+  See `docs/guide/getting-started.md` (Pre-attaching a user identifier)
+  and `docs/api/types.md` (`AppUserId`) for the updated reference.
+
 ## [0.3.0] — 2026-05-06
 
 ### Changed (BREAKING)

package/dist/index.cjs

@@ -1232,7 +1232,11 @@ var PurchaseOrchestrator = class {
         message: `Product "${productId}" is not in the configured catalog.`
       });
     }
-    const resolvedAppUserId = appUserId !== void 0 ? await resolveAppUserId(appUserId) : void 0;
+    let resolvedAppUserId;
+    if (appUserId !== void 0) {
+      const ctx = typeof appUserId === "function" ? { authHeaders: await this.deps.getAuthHeaders() } : { authHeaders: {} };
+      resolvedAppUserId = await resolveAppUserId(appUserId, ctx);
+    }
     this.inFlight.add(productId);
     this.deps.emitter.emit("purchase-started", { productId });
     try {
@@ -1349,11 +1353,11 @@ var PurchaseOrchestrator = class {
     return { status: "verification_failed", productId, error: iapError };
   }
 };
-async function resolveAppUserId(supply) {
+async function resolveAppUserId(supply, ctx) {
   let resolved;
   if (typeof supply === "function") {
     try {
-      resolved = await supply();
+      resolved = await supply(ctx);
     } catch (cause) {
       throw new exports.IAPError({
         code: exports.IAPErrorCode.APP_USER_ID_FETCH_FAILED,
@@ -1851,6 +1855,8 @@ function createIAP(input) {
         state.logger.debug(`Resolved ${validated.data.length} product(s) from backend manifest.`);
       }
       state.adapter = await selectNativeAdapter({ products: state.products });
+      const configGetAuthHeaders = state.config.backend.getAuthHeaders;
+      const getAuthHeaders = configGetAuthHeaders ? async () => configGetAuthHeaders() : async () => ({});
       const sharedDeps = {
         nativeAdapter: state.adapter,
         backend: state.backend,
@@ -1864,7 +1870,8 @@ function createIAP(input) {
         },
         setCachePersisted: (cachedAt) => {
           state.cachedAt = cachedAt;
-        }
+        },
+        getAuthHeaders
       };
       state.orchestrator = new PurchaseOrchestrator({
         ...sharedDeps,