@namiml/web-sdk 3.4.6 → 3.4.7-dev.202607230324

package/dist/utils/polyfill-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Feature-detected polyfill loading for the legacy-support entry.
+ *
+ * The consumer's `isLegacyBrowser()` gate is coarse: a browser needing core-js
+ * language polyfills often still has native Custom Elements, Shadow DOM, fetch,
+ * URL, and AbortController. We detect what is genuinely missing and load only
+ * that — capable browsers skip them, most importantly the ~135KB Web Components
+ * bundle.
+ *
+ * Invariant (NAM-2271): native present -> skip; native absent -> load exactly
+ * the polyfill shipped before this change. No browser loses capability.
+ */
+export type PolyfillKind = "webcomponents" | "es5adapter" | "fetch" | "url" | "abortcontroller";
+/**
+ * Returns the polyfills a browser genuinely needs. Ordering within the returned
+ * list is not significant (it is enforced in `applyPolyfills`). Pure and
+ * side-effect free so the no-regression invariant is unit-testable without a
+ * device.
+ */
+export declare function detectMissingPolyfills(g?: typeof globalThis): PolyfillKind[];
+type Importer = () => Promise<unknown>;
+/**
+ * Default dynamic importers. Each is a separate `import()` so a capable browser
+ * never fetches the chunk. `url` points at the *minified* build; `core-js` and
+ * `whatwg-fetch` stay external (customer-provided).
+ */
+export declare const polyfillImporters: Record<PolyfillKind, Importer>;
+/**
+ * Loads the given polyfills. The Web Components pair is ordered (the bundle must
+ * apply before the ES5 adapter patches `customElements.define`); the rest are
+ * independent and run concurrently. Resolves only after every needed polyfill
+ * has applied, so a top-level `await` in legacy-support blocks the consumer's
+ * `await import(...)` until the environment is ready.
+ */
+export declare function applyPolyfills(kinds: PolyfillKind[], importers?: Record<PolyfillKind, Importer>): Promise<void>;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@namiml/web-sdk",
   "type": "module",
-  "version": "3.4.6",
+  "version": "3.4.7-dev.202607230324",
   "source": "src/nami-web.ts",
   "description": "Subscription monetization infrastructure — drop-in SDK with no-code paywalls, onboarding flows, A/B testing for web",
   "scripts": {
@@ -105,7 +105,7 @@
   "dependencies": {
     "@lit-labs/ssr-dom-shim": "^1.2.1",
     "@lit/context": "^1.1.3",
-    "@namiml/sdk-core": "3.4.6",
+    "@namiml/sdk-core": "3.4.7-dev.202607230324",
     "bowser": "^2.11.0",
     "hls.js": "^1.5.18",
     "lit": "^3.3.1",