@ait-kit/sdk 0.4.0 → 0.5.0

package/dist/rn/iap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iap.d.ts","sourceRoot":"","sources":["../../src/rn/iap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IAC9E;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;CACvD;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,0CAGlE"}
+{"version":3,"file":"iap.d.ts","sourceRoot":"","sources":["../../src/rn/iap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,wBAAwB,CAAC;IACzG;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;CACvD;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,0CAGlE"}

package/dist/rn/iap.js

@@ -3,7 +3,7 @@ import { createRnPlatformLoader } from "./platform-loader.js";
 import { createIapAdapter } from "../iap/adapter.js";
 export function createReactNativeIap(options) {
     const loader = resolvePlatformLoader(options.framework, createDefaultRnIapLoader);
-    return createIapAdapter({ ...options, loader });
+    return createIapAdapter({ ...options, loader, orderHistoryPagination: "cursor" });
 }
 function createDefaultRnIapLoader() {
     return createRnPlatformLoader((framework) => {

package/dist/share/platform-contract.d.ts

@@ -1,6 +1,6 @@
 import { type SdkShareUiResult } from "../index.js";
 /**
- * Internal platform contract for the share adapter, shared by /rn and /web.
+ * Internal platform contract for the share adapter, shared by /rn and /webview.
  */
 export interface ShareCreateLinkParams {
     path: string;

package/dist/storage/platform-contract.d.ts

@@ -1,7 +1,7 @@
 import { type SdkStorage } from "../index.js";
 /**
  * Internal platform contract for the storage adapters, shared by /rn and
- * /web. Keys and string values pass through verbatim — the adapter adds no
+ * /webview. Keys and string values pass through verbatim — the adapter adds no
  * namespace prefix and performs no key transformation; consumers that want
  * namespacing compose their own keys. Rejections from the underlying SDK
  * propagate to the caller so storage failures stay observable.

package/dist/webview/ads.d.ts

@@ -0,0 +1,10 @@
+import { type AdsAdapter, type AdsOptions, type AdsPlatformLoader } from "../ads/adapter.js";
+import type { FullScreenAdSupport } from "../ads/platform-contract.js";
+export type { SdkAdType } from "../ads/adapter.js";
+export interface WebViewAdsOptions extends Omit<AdsOptions, "loader"> {
+    /** Optional injected framework or loader; the default imports the platform SDK lazily. */
+    framework?: AdsPlatformLoader | FullScreenAdSupport;
+}
+export type WebViewAds = AdsAdapter;
+export declare function createWebViewAds(options?: WebViewAdsOptions): WebViewAds;
+//# sourceMappingURL=ads.d.ts.map

package/dist/webview/ads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/webview/ads.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC;IACnE,0FAA0F;IAC1F,SAAS,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;CACrD;AACD,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAE5E"}

package/dist/webview/ads.js

@@ -0,0 +1,14 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createAdsAdapter } from "../ads/adapter.js";
+import { createWebViewPlatformLoader } from "./platform-loader.js";
+export function createWebViewAds(options = {}) {
+    return createAdsAdapter({ ...options, loader: resolvePlatformLoader(options.framework, createDefaultAdsLoader) });
+}
+function createDefaultAdsLoader() {
+    return createWebViewPlatformLoader(module => {
+        if (typeof module.loadFullScreenAd !== "function" || typeof module.showFullScreenAd !== "function") {
+            return { available: false, reason: "@apps-in-toss/web-framework does not expose the Ads APIs" };
+        }
+        return { available: true, module };
+    });
+}

package/dist/webview/banner-contract.d.ts

@@ -0,0 +1,59 @@
+export interface WebViewBannerEvent {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: {
+        creativeId: string;
+        requestId: string;
+    };
+}
+export interface WebViewBannerError {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: Record<string, never>;
+    error: {
+        code: number;
+        message: string;
+        domain?: string;
+        mediationId?: string;
+    };
+}
+export interface WebViewBannerCallbacks {
+    onAdRendered?: (payload: WebViewBannerEvent) => void;
+    onAdViewable?: (payload: WebViewBannerEvent) => void;
+    onAdClicked?: (payload: WebViewBannerEvent) => void;
+    onAdImpression?: (payload: WebViewBannerEvent) => void;
+    onAdFailedToRender?: (payload: WebViewBannerError) => void;
+    onNoFill?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+    }) => void;
+}
+export interface WebViewBannerOptions {
+    theme?: "auto" | "light" | "dark";
+    tone?: "blackAndWhite" | "grey";
+    variant?: "card" | "expanded";
+    callbacks?: WebViewBannerCallbacks;
+    /** Cancels pending attachment and destroys this banner on abort. */
+    signal?: AbortSignal;
+}
+export interface WebViewBannerHandle {
+    destroy(): void;
+}
+type Supported<F> = F & {
+    isSupported?: () => boolean;
+};
+export interface WebViewBannerPlatform {
+    TossAds?: {
+        /** Must tolerate repeated calls after failures/timeouts, like official idempotent initialization. */
+        initialize?: Supported<(options: {
+            callbacks?: {
+                onInitialized?: () => void;
+                onInitializationFailed?: (error: Error) => void;
+            };
+        }) => void>;
+        attachBanner?: Supported<(adGroupId: string, target: string | HTMLElement, options?: Omit<WebViewBannerOptions, "signal">) => WebViewBannerHandle>;
+    };
+}
+export {};
+//# sourceMappingURL=banner-contract.d.ts.map

package/dist/webview/banner-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-contract.d.ts","sourceRoot":"","sources":["../../src/webview/banner-contract.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AACD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF;AACD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACrD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CACxG;AACD,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AACD,MAAM,WAAW,mBAAmB;IAAG,OAAO,IAAI,IAAI,CAAC;CAAE;AACzD,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AACxD,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE;QACR,qGAAqG;QACrG,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE;YAAE,SAAS,CAAC,EAAE;gBAAE,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;gBAAC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;aAAE,CAAA;SAAE,KAAK,IAAI,CAAC,CAAC;QAC3I,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,KAAK,mBAAmB,CAAC,CAAC;KACpJ,CAAC;CACH"}

package/dist/webview/banner.d.ts

@@ -0,0 +1,15 @@
+import { type PlatformLoader } from "../platform-loader.js";
+import type { WebViewBannerHandle, WebViewBannerOptions, WebViewBannerPlatform } from "./banner-contract.js";
+export type { WebViewBannerHandle, WebViewBannerOptions, WebViewBannerEvent, WebViewBannerError, WebViewBannerCallbacks, WebViewBannerPlatform } from "./banner-contract.js";
+export interface WebViewBannerAdsOptions {
+    framework?: WebViewBannerPlatform | PlatformLoader<WebViewBannerPlatform>;
+    /** Overall initialization deadline including SDK import; integer 1..2147483647ms, default 15000ms. */
+    initializeTimeoutMs?: number;
+}
+export interface WebViewBannerAds {
+    initialize(): Promise<void>;
+    /** Resolves once attached, not once rendered. Own a distinct target per live handle. */
+    attachBanner(adGroupId: string, target: string | HTMLElement, options?: WebViewBannerOptions): Promise<WebViewBannerHandle>;
+}
+export declare function createWebViewBannerAds(options?: WebViewBannerAdsOptions): WebViewBannerAds;
+//# sourceMappingURL=banner.d.ts.map

package/dist/webview/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/webview/banner.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAA8C,MAAM,sBAAsB,CAAC;AACzJ,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7K,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAC1E,sGAAsG;IACtG,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AACD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,wFAAwF;IACxF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7H;AAID,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CA+H9F"}

package/dist/webview/banner.js

@@ -0,0 +1,188 @@
+import { SdkError } from "../index.js";
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createWebViewPlatformLoader } from "./platform-loader.js";
+// Prevent two adapter instances from claiming the provider's same-element shared handle.
+const claimedTargets = new WeakSet();
+export function createWebViewBannerAds(options = {}) {
+    const timeoutMs = options.initializeTimeoutMs ?? 15_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647) {
+        throw new SdkError("INVALID_BANNER_INPUT", "initializeTimeoutMs must be an integer from 1 to 2147483647");
+    }
+    const loader = resolvePlatformLoader(options.framework, () => createWebViewPlatformLoader(module => ({ available: true, module })));
+    let initialized;
+    let pending;
+    const initialize = () => {
+        if (initialized)
+            return Promise.resolve();
+        if (pending)
+            return pending;
+        const started = now();
+        const operation = new Promise((resolve, reject) => {
+            let settled = false;
+            const finish = (error, module) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (module === undefined)
+                    reject(error);
+                else {
+                    initialized = module;
+                    resolve();
+                }
+            };
+            const expired = () => now() - started >= timeoutMs;
+            const timeout = () => new SdkError("BANNER_INIT_TIMEOUT", "banner initialization timed out");
+            const timer = setTimeout(() => finish(timeout()), timeoutMs);
+            Promise.resolve().then(loader).then(result => {
+                if (settled)
+                    return;
+                if (expired()) {
+                    finish(timeout());
+                    return;
+                }
+                if (!result.available) {
+                    finish(new SdkError("SDK_UNAVAILABLE", result.reason));
+                    return;
+                }
+                const api = result.module.TossAds;
+                const init = api?.initialize;
+                if (!supported(init)) {
+                    finish(new SdkError("UNSUPPORTED", "banner initialization is not supported"));
+                    return;
+                }
+                if (expired()) {
+                    finish(timeout());
+                    return;
+                }
+                let registering = true;
+                let outcome;
+                const complete = (value) => {
+                    if (outcome)
+                        return;
+                    outcome = value;
+                    if (!registering)
+                        settleOutcome();
+                };
+                const settleOutcome = () => {
+                    if (expired())
+                        finish(timeout());
+                    else if (outcome?.ok)
+                        finish(undefined, result.module);
+                    else if (outcome)
+                        finish(outcome.error);
+                };
+                init.call(api, { callbacks: {
+                        onInitialized: () => complete({ ok: true }),
+                        onInitializationFailed: error => complete({ ok: false, error })
+                    } });
+                registering = false;
+                if (outcome)
+                    settleOutcome();
+            }).catch(error => finish(error));
+        });
+        pending = operation;
+        void operation.then(() => { pending = undefined; }, () => { pending = undefined; });
+        return operation;
+    };
+    return { initialize, async attachBanner(adGroupId, target, attachOptions = {}) {
+            if (typeof adGroupId !== "string" || !adGroupId.trim())
+                throw new SdkError("INVALID_BANNER_INPUT", "adGroupId must be non-empty");
+            let element;
+            try {
+                element = typeof target === "string" ? (typeof document === "undefined" ? null : document.querySelector(target)) : target;
+            }
+            catch (error) {
+                throw new SdkError("INVALID_BANNER_INPUT", "banner target selector is invalid", { cause: error });
+            }
+            // Namespace validation also accepts HTML elements from another document realm.
+            if (!element || element.nodeType !== 1 || element.namespaceURI !== "http://www.w3.org/1999/xhtml") {
+                throw new SdkError("INVALID_BANNER_INPUT", "banner target must resolve to an HTML element");
+            }
+            if (claimedTargets.has(element))
+                throw new SdkError("BANNER_TARGET_IN_USE", "destroy the existing banner before reusing its target");
+            const { signal, callbacks, ...style } = attachOptions;
+            throwIfAborted(signal);
+            claimedTargets.add(element);
+            let destroyed = false;
+            let providerHandle;
+            const handle = { destroy() {
+                    if (destroyed)
+                        return;
+                    destroyed = true;
+                    signal?.removeEventListener("abort", onAbort);
+                    try {
+                        providerHandle?.destroy();
+                    }
+                    finally {
+                        claimedTargets.delete(element);
+                    }
+                } };
+            const onAbort = () => handle.destroy();
+            try {
+                await initialize();
+                throwIfAborted(signal);
+                const api = initialized?.TossAds;
+                const attach = api?.attachBanner;
+                if (!supported(attach))
+                    throw new SdkError("UNSUPPORTED", "banner attachment is not supported");
+                let registering = true;
+                let registrationError;
+                // Capture the resource before invoking consumer callbacks, including
+                // callbacks the provider emits synchronously during registration.
+                const forward = (callback) => (payload) => {
+                    if (callback)
+                        queueMicrotask(() => { if (!destroyed)
+                            callback(payload); });
+                };
+                const forwarded = {
+                    onAdRendered: forward(callbacks?.onAdRendered),
+                    onAdViewable: forward(callbacks?.onAdViewable),
+                    onAdClicked: forward(callbacks?.onAdClicked),
+                    onAdImpression: forward(callbacks?.onAdImpression),
+                    onNoFill: forward(callbacks?.onNoFill),
+                    onAdFailedToRender: payload => {
+                        if (registering)
+                            registrationError = payload;
+                        forward(callbacks?.onAdFailedToRender)(payload);
+                    }
+                };
+                let attached;
+                try {
+                    attached = attach.call(api, adGroupId, element, { ...style, callbacks: forwarded });
+                }
+                catch (error) {
+                    throw new SdkError("BANNER_ATTACH_FAILED", "provider threw during banner attachment", { cause: error });
+                }
+                registering = false;
+                if (!attached || typeof attached.destroy !== "function")
+                    throw new SdkError("BANNER_ATTACH_FAILED", "provider returned no banner handle");
+                providerHandle = attached;
+                if (registrationError)
+                    throw new SdkError("BANNER_ATTACH_FAILED", "provider rejected banner attachment", { cause: registrationError });
+                signal?.addEventListener("abort", onAbort, { once: true });
+                if (signal?.aborted) {
+                    handle.destroy();
+                    throwIfAborted(signal);
+                }
+                return handle;
+            }
+            catch (error) {
+                try {
+                    handle.destroy();
+                }
+                catch (cleanupError) {
+                    throw new AggregateError([error, cleanupError], "banner attachment and cleanup failed");
+                }
+                throw error;
+            }
+        } };
+}
+function supported(fn) {
+    return typeof fn === "function" && (typeof fn.isSupported !== "function" || fn.isSupported());
+}
+function now() { return typeof performance !== "undefined" ? performance.now() : Date.now(); }
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw signal.reason ?? new DOMException("Banner attachment aborted", "AbortError");
+}

package/dist/{web → webview}/framework-loader.d.ts

@@ -5,5 +5,5 @@ import type { IapPlatformLoader } from "../iap/platform-contract.js";
  * operation needs it. Failed imports are never cached, so a later call
  * retries; successful loads are cached.
  */
-export declare function createDefaultWebFrameworkLoader(): IapPlatformLoader;
+export declare function createDefaultWebViewFrameworkLoader(): IapPlatformLoader;
 //# sourceMappingURL=framework-loader.d.ts.map

package/dist/webview/framework-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-loader.d.ts","sourceRoot":"","sources":["../../src/webview/framework-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,mCAAmC,IAAI,iBAAiB,CAQvE"}

package/dist/{web → webview}/framework-loader.js

@@ -1,12 +1,12 @@
-import { createWebPlatformLoader } from "./platform-loader.js";
+import { createWebViewPlatformLoader } from "./platform-loader.js";
 /**
  * Default lazy loader for the official web SDK: imports
  * `@apps-in-toss/web-framework` (an optional peer) only when an IAP
  * operation needs it. Failed imports are never cached, so a later call
  * retries; successful loads are cached.
  */
-export function createDefaultWebFrameworkLoader() {
-    return createWebPlatformLoader((framework) => {
+export function createDefaultWebViewFrameworkLoader() {
+    return createWebViewPlatformLoader((framework) => {
         const iap = framework.IAP;
         if (typeof iap !== "object" || iap === null) {
             return { available: false, reason: "@apps-in-toss/web-framework does not expose an IAP domain" };

package/dist/{web → webview}/iap-contract.d.ts

@@ -1,13 +1,13 @@
 import type { IapPlatformSdk } from "../iap/platform-contract.js";
 /**
  * Structural contract for the official `@apps-in-toss/web-framework` IAP
- * domain, declared from the published documentation so /web consumers
+ * domain, declared from the published documentation so /webview consumers
  * type-check without the official web SDK installed. It is intentionally
  * independent of the /rn contract — neither entry requires the other
  * platform's package, in JavaScript or in generated declarations.
  */
-export type WebIapModule = IapPlatformSdk;
-export type WebIapFramework = {
-    IAP: WebIapModule;
+export type WebViewIapModule = IapPlatformSdk;
+export type WebViewIapFramework = {
+    IAP: WebViewIapModule;
 };
 //# sourceMappingURL=iap-contract.d.ts.map

package/dist/webview/iap-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iap-contract.d.ts","sourceRoot":"","sources":["../../src/webview/iap-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,gBAAgB,CAAC;CACvB,CAAC"}

package/dist/webview/iap-contract.js

@@ -0,0 +1 @@
+export {};

package/dist/webview/identity.d.ts

@@ -0,0 +1,40 @@
+import { type SdkAnonymousKey, type SdkLoginResult, type SdkStorage } from "../index.js";
+import { type IdentityPlatformLoader, type IdentityPlatformSdk } from "../identity/platform-contract.js";
+import { type StoragePlatformLoader, type StoragePlatformSdk } from "../storage/platform-contract.js";
+export interface WebViewIdentityOptions {
+    /**
+     * WebView framework injection: pass a module exposing TossAuth/User or a
+     * custom loader (tests, dev replacements). Defaults to the lazy
+     * `import("@apps-in-toss/web-framework")` loader. The default never
+     * guesses the environment or substitutes a fake login.
+     */
+    framework?: IdentityPlatformSdk | IdentityPlatformLoader;
+}
+export interface WebViewIdentity {
+    /** Starts the platform login and validates/preserves the result. */
+    login(): Promise<SdkLoginResult>;
+    /** Looks up the SDK-issued anonymous key; never fabricates one. */
+    getAnonymousKey(): Promise<SdkAnonymousKey>;
+}
+export declare function createWebViewIdentity(options?: WebViewIdentityOptions): WebViewIdentity;
+export interface WebViewStorageOptions {
+    /**
+     * WebView framework injection: pass a module exposing Storage or a custom
+     * loader. Defaults to the lazy `import("@apps-in-toss/web-framework")`
+     * loader.
+     */
+    framework?: StoragePlatformSdk | StoragePlatformLoader;
+}
+/** SDK-backed storage for web with the same verbatim-key contract as /rn. */
+export declare function createWebViewStorage(options?: WebViewStorageOptions): SdkStorage;
+/** @deprecated Use createWebViewIdentity from @ait-kit/sdk/webview. */
+export declare const createWebIdentity: typeof createWebViewIdentity;
+/** @deprecated Use createWebViewStorage from @ait-kit/sdk/webview. */
+export declare const createWebStorage: typeof createWebViewStorage;
+/** @deprecated Use WebViewIdentity from @ait-kit/sdk/webview. */
+export type WebIdentity = WebViewIdentity;
+/** @deprecated Use WebViewIdentityOptions from @ait-kit/sdk/webview. */
+export type WebIdentityOptions = WebViewIdentityOptions;
+/** @deprecated Use WebViewStorageOptions from @ait-kit/sdk/webview. */
+export type WebStorageOptions = WebViewStorageOptions;
+//# sourceMappingURL=identity.d.ts.map

package/dist/webview/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/webview/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAGzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mBAAmB,GAAG,sBAAsB,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAa3F;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU,CA8BpF;AAyBD,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,8BAAwB,CAAC;AACvD,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,6BAAuB,CAAC;AACrD,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAC1C,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AACxD,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC"}

package/dist/{web → webview}/identity.js

@@ -1,10 +1,10 @@
 import { resolvePlatformLoader } from "../platform-loader.js";
-import { createWebPlatformLoader } from "./platform-loader.js";
+import { createWebViewPlatformLoader } from "./platform-loader.js";
 import { SdkError } from "../index.js";
 import { runSdkGetAnonymousKey, runSdkLogin } from "../identity/platform-contract.js";
 import { createSdkStorageFromPlatform } from "../storage/platform-contract.js";
-export function createWebIdentity(options = {}) {
-    const loader = normalizeWebIdentityLoader(options.framework);
+export function createWebViewIdentity(options = {}) {
+    const loader = normalizeWebViewIdentityLoader(options.framework);
     const load = async () => {
         const result = await loader();
         if (!result.available) {
@@ -18,8 +18,8 @@ export function createWebIdentity(options = {}) {
     };
 }
 /** SDK-backed storage for web with the same verbatim-key contract as /rn. */
-export function createWebStorage(options = {}) {
-    const loader = normalizeWebStorageLoader(options.framework);
+export function createWebViewStorage(options = {}) {
+    const loader = normalizeWebViewStorageLoader(options.framework);
     let cached;
     let resolving;
     const resolve = () => {
@@ -49,18 +49,22 @@ export function createWebStorage(options = {}) {
         remove: async (key) => (await resolve()).remove(key)
     };
 }
-function normalizeWebIdentityLoader(framework) {
-    return resolvePlatformLoader(framework, createDefaultWebIdentityLoader);
+function normalizeWebViewIdentityLoader(framework) {
+    return resolvePlatformLoader(framework, createDefaultWebViewIdentityLoader);
 }
-function normalizeWebStorageLoader(framework) {
-    return resolvePlatformLoader(framework, createDefaultWebStorageLoader);
+function normalizeWebViewStorageLoader(framework) {
+    return resolvePlatformLoader(framework, createDefaultWebViewStorageLoader);
 }
 // The web SDK exposes the shared namespaced contract shapes directly, so
 // the default loaders consume the official module without any conversion
 // or type assertion; a failed import is never cached, successful loads are.
-function createDefaultWebIdentityLoader() {
-    return createWebPlatformLoader(module => ({ available: true, module: module }));
+function createDefaultWebViewIdentityLoader() {
+    return createWebViewPlatformLoader(module => ({ available: true, module: module }));
 }
-function createDefaultWebStorageLoader() {
-    return createWebPlatformLoader(module => ({ available: true, module: module }));
+function createDefaultWebViewStorageLoader() {
+    return createWebViewPlatformLoader(module => ({ available: true, module: module }));
 }
+/** @deprecated Use createWebViewIdentity from @ait-kit/sdk/webview. */
+export const createWebIdentity = createWebViewIdentity;
+/** @deprecated Use createWebViewStorage from @ait-kit/sdk/webview. */
+export const createWebStorage = createWebViewStorage;

package/dist/webview/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * WebView adapters for `@ait-kit/sdk`.
+ *
+ * Requires the official `@apps-in-toss/web-framework` package (declared as
+ * an optional peer): it is imported lazily at first use, so this entry
+ * never requires the React Native SDK, and the React Native entry never
+ * requires this one.
+ *
+ * ```ts
+ * import { createWebViewIap } from "@ait-kit/sdk/webview";
+ *
+ * const iap = createWebViewIap({
+ *   // Resolve only after YOUR server verified the order and persisted the
+ *   // grant (see the ait-kit server packages for verification flows).
+ *   grant: async ({ orderId, sku }) => {
+ *     const response = await fetch("/api/iap/grant", {
+ *       method: "POST",
+ *       body: JSON.stringify({ orderId, sku })
+ *     });
+ *     if (!response.ok) {
+ *       // Resolve-only-on-success is part of the contract: never report a
+ *       // grant your server did not verify and persist.
+ *       throw new Error(`grant request failed: HTTP ${response.status}`);
+ *     }
+ *   }
+ * });
+ * const result = await iap.purchaseOneTime("SKU_100_COINS");
+ * ```
+ */
+import { type IapAdapterOptions, type IapRecoveryResult } from "../iap/adapter.js";
+import type { IapPlatformLoader, PartialIapPlatformSdk } from "../iap/platform-contract.js";
+import type { WebViewIapFramework } from "./iap-contract.js";
+export interface WebViewIapOptions extends Omit<IapAdapterOptions, "loader" | "orderHistoryPagination"> {
+    /**
+     * WebView framework injection: pass an `IAP` module instance or a custom
+     * loader (tests/consumers). Defaults to the lazy
+     * `import("@apps-in-toss/web-framework")` loader.
+     */
+    framework?: WebViewIapFramework["IAP"] | PartialIapPlatformSdk | IapPlatformLoader;
+}
+export type WebViewIap = ReturnType<typeof createWebViewIap>;
+export type { IapRecoveryResult };
+export { createWebViewIdentity, type WebViewIdentity, type WebViewIdentityOptions } from "./identity.js";
+export { createWebViewStorage, type WebViewStorageOptions } from "./identity.js";
+export { createWebViewNotification, createWebViewShare, type WebViewNotification, type WebViewNotificationOptions, type WebViewShare, type WebViewShareOptions } from "./notify-share.js";
+export declare function createWebViewIap(options: WebViewIapOptions): import("../iap/adapter.js").IapAdapter;
+export { createWebViewReview, type WebViewReviewOptions } from "./review.js";
+export { createWebViewPromotion, type WebViewPromotionOptions } from "./promotion.js";
+/** @deprecated Use createWebViewIap from @ait-kit/sdk/webview. */
+export declare const createWebIap: typeof createWebViewIap;
+/** @deprecated Use WebViewIap from @ait-kit/sdk/webview. */
+export type WebIap = WebViewIap;
+/** @deprecated Use WebViewIapOptions from @ait-kit/sdk/webview. */
+export type WebIapOptions = WebViewIapOptions;
+export { createWebIdentity, createWebStorage, type WebIdentity, type WebIdentityOptions, type WebStorageOptions } from "./identity.js";
+export { createWebNotification, createWebShare, type WebNotification, type WebNotificationOptions, type WebShare, type WebShareOptions } from "./notify-share.js";
+export { createWebReview, type WebReviewOptions } from "./review.js";
+export { createWebPromotion, type WebPromotionOptions } from "./promotion.js";
+export { createWebViewAds, type WebViewAds, type WebViewAdsOptions, type SdkAdType } from "./ads.js";
+export type { LoadFullScreenAdParams, FullScreenAdShowEvent, ShowFullScreenAdParams, FullScreenAdFunctions, FullScreenAdSupport } from "../ads/platform-contract.js";
+export { createWebViewBannerAds, type WebViewBannerAds, type WebViewBannerAdsOptions, type WebViewBannerHandle, type WebViewBannerOptions, type WebViewBannerCallbacks, type WebViewBannerEvent, type WebViewBannerError, type WebViewBannerPlatform } from "./banner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/webview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webview/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,wBAAwB,CAAC;IACrG;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;CACpF;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,0CAG1D;AAED,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEtF,kEAAkE;AAClE,eAAO,MAAM,YAAY,yBAAmB,CAAC;AAC7C,4DAA4D;AAC5D,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC;AAChC,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvI,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClK,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACrG,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAErK,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/{web → webview}/index.js

@@ -1,6 +1,6 @@
 import { resolvePlatformLoader } from "../platform-loader.js";
 /**
- * Web adapters for `@ait-kit/sdk`.
+ * WebView adapters for `@ait-kit/sdk`.
  *
  * Requires the official `@apps-in-toss/web-framework` package (declared as
  * an optional peer): it is imported lazily at first use, so this entry
@@ -8,9 +8,9 @@ import { resolvePlatformLoader } from "../platform-loader.js";
  * requires this one.
  *
  * ```ts
- * import { createWebIap } from "@ait-kit/sdk/web";
+ * import { createWebViewIap } from "@ait-kit/sdk/webview";
  *
- * const iap = createWebIap({
+ * const iap = createWebViewIap({
  *   // Resolve only after YOUR server verified the order and persisted the
  *   // grant (see the ait-kit server packages for verification flows).
  *   grant: async ({ orderId, sku }) => {
@@ -29,14 +29,23 @@ import { resolvePlatformLoader } from "../platform-loader.js";
  * ```
  */
 import { createIapAdapter } from "../iap/adapter.js";
-import { createDefaultWebFrameworkLoader } from "./framework-loader.js";
-export { createWebIdentity } from "./identity.js";
-export { createWebStorage } from "./identity.js";
-// createWebStorage lives in identity.ts alongside the shared web loader helpers.
-export { createWebNotification, createWebShare } from "./notify-share.js";
-export function createWebIap(options) {
-    const loader = resolvePlatformLoader(options.framework, createDefaultWebFrameworkLoader);
-    return createIapAdapter({ ...options, loader });
+import { createDefaultWebViewFrameworkLoader } from "./framework-loader.js";
+export { createWebViewIdentity } from "./identity.js";
+export { createWebViewStorage } from "./identity.js";
+// createWebViewStorage lives in identity.ts alongside the shared web loader helpers.
+export { createWebViewNotification, createWebViewShare } from "./notify-share.js";
+export function createWebViewIap(options) {
+    const loader = resolvePlatformLoader(options.framework, createDefaultWebViewFrameworkLoader);
+    return createIapAdapter({ ...options, loader, orderHistoryPagination: "first_page_only" });
 }
+export { createWebViewReview } from "./review.js";
+export { createWebViewPromotion } from "./promotion.js";
+/** @deprecated Use createWebViewIap from @ait-kit/sdk/webview. */
+export const createWebIap = createWebViewIap;
+// Compatibility exports for consumers migrating from the /web entry.
+export { createWebIdentity, createWebStorage } from "./identity.js";
+export { createWebNotification, createWebShare } from "./notify-share.js";
 export { createWebReview } from "./review.js";
 export { createWebPromotion } from "./promotion.js";
+export { createWebViewAds } from "./ads.js";
+export { createWebViewBannerAds } from "./banner.js";