@ait-kit/sdk 0.3.0 → 0.5.0

package/dist/rn/official-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"official-module.d.ts","sourceRoot":"","sources":["../../src/rn/official-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAyB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE7F;;;;;;;;;;;;;GAaG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAE/D,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACnE,eAAe,CAAC,EAAE,gBAAgB,CAChC,MAAM,OAAO,CAAC,0BAA0B,GAAG,OAAO,GAAG,SAAS,CAAC,CAChE,CAAC;IACF,4BAA4B,CAAC,EAAE,gBAAgB,CAC7C,CAAC,MAAM,EAAE,2BAA2B,KAAK,MAAM,IAAI,CACpD,CAAC;IACF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC3E;AAkBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CA6B9F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,uBAAuB,CAWtG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB,GAAG,gBAAgB,CAsBxF"}
+{"version":3,"file":"official-module.d.ts","sourceRoot":"","sources":["../../src/rn/official-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAEnG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAyB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE7F;;;;;;;;;;;;;GAaG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAE/D,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAA;KAAE,KAAK,OAAO,CACzF;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,GAAG,SAAS,CAClG,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,gBAAgB,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACnE,eAAe,CAAC,EAAE,gBAAgB,CAChC,MAAM,OAAO,CAAC,0BAA0B,GAAG,OAAO,GAAG,SAAS,CAAC,CAChE,CAAC;IACF,4BAA4B,CAAC,EAAE,gBAAgB,CAC7C,CAAC,MAAM,EAAE,2BAA2B,KAAK,MAAM,IAAI,CACpD,CAAC;IACF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC3E;AAkBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CA6B9F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,yBAAyB,GAAG,uBAAuB,CAWtG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB,GAAG,gBAAgB,CAsBxF;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,gCAAgC,EAAE,iBAAiB,CAKnI;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,yBAAyB,GAAG,oBAAoB,CAUhG"}

package/dist/rn/official-module.js

@@ -84,3 +84,23 @@ export function adaptOfficialRnShare(module) {
     }
     return share;
 }
+/** Translate the official flat review function, preserving both receivers. */
+export function adaptOfficialRnReview(module) {
+    const request = module.requestReview;
+    return typeof request === "function"
+        ? { Review: { request: preserveSupport(request, () => request.call(module)) } }
+        : {};
+}
+/** Flat RN API uses a params wrapper and undefined for unsupported app versions. */
+export function adaptOfficialRnPromotion(module) {
+    const grant = module.grantPromotionReward;
+    if (typeof grant !== "function")
+        return {};
+    return { Promotion: { grantReward: preserveSupport(grant, async (input) => {
+                const result = await grant.call(module, { params: input });
+                if (result === undefined) {
+                    throw new SdkError("UNSUPPORTED", "the installed app version does not support direct promotion rewards");
+                }
+                return result;
+            }) } };
+}

package/dist/rn/platform-loader.d.ts

@@ -0,0 +1,4 @@
+import { type PlatformLoader, type PlatformLoadResult } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export declare function createRnPlatformLoader<T>(select: (module: typeof import("@apps-in-toss/framework")) => PlatformLoadResult<T>, includeErrorDetails?: boolean): PlatformLoader<T>;
+//# sourceMappingURL=platform-loader.d.ts.map

package/dist/rn/platform-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-loader.d.ts","sourceRoot":"","sources":["../../src/rn/platform-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvI,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,yBAAyB,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,EACnF,mBAAmB,UAAO,GACzB,cAAc,CAAC,CAAC,CAAC,CAKnB"}

package/dist/rn/platform-loader.js

@@ -0,0 +1,5 @@
+import { createCachedPlatformLoader, frameworkImportError } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export function createRnPlatformLoader(select, includeErrorDetails = true) {
+    return createCachedPlatformLoader(async () => select(await import("@apps-in-toss/framework")), error => frameworkImportError("@apps-in-toss/framework", error, includeErrorDetails));
+}

package/dist/rn/promotion.d.ts

@@ -0,0 +1,9 @@
+import type { PromotionAdapter, PromotionPlatformLoader, PromotionPlatformSdk } from "../promotion/platform-contract.js";
+export interface ReactNativePromotionOptions {
+    /** Shared Promotion contract or async loader; defaults to the official SDK. */
+    framework?: PromotionPlatformSdk | PromotionPlatformLoader;
+    /** Overall wait deadline; 0 (default) disables it. Timeout does not cancel payment. */
+    timeoutMs?: number;
+}
+export declare function createReactNativePromotion(options?: ReactNativePromotionOptions): PromotionAdapter;
+//# sourceMappingURL=promotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../../src/rn/promotion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzH,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAAC;IAC3D,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC,GAAG,gBAAgB,CAEtG"}

package/dist/rn/promotion.js

@@ -0,0 +1,11 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
+import { createPromotionAdapter } from "../promotion/adapter.js";
+import { adaptOfficialRnPromotion } from "./official-module.js";
+export function createReactNativePromotion(options = {}) {
+    return createPromotionAdapter(resolvePlatformLoader(options.framework, createDefaultPromotionLoader), options.timeoutMs);
+}
+/** Keep import diagnostics redacted for direct-promotion operations. */
+function createDefaultPromotionLoader() {
+    return createRnPlatformLoader(module => ({ available: true, module: adaptOfficialRnPromotion(module) }), false);
+}

package/dist/rn/review.d.ts

@@ -0,0 +1,7 @@
+import type { ReviewAdapter, ReviewPlatformLoader, ReviewPlatformSdk } from "../review/platform-contract.js";
+export interface ReactNativeReviewOptions {
+    /** Shared contract injection, or a loader; defaults to the lazy official SDK. */
+    framework?: ReviewPlatformSdk | ReviewPlatformLoader;
+}
+export declare function createReactNativeReview(options?: ReactNativeReviewOptions): ReviewAdapter;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/rn/review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAG7G,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,SAAS,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;CACtD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa,CAE7F"}

package/dist/rn/review.js

@@ -0,0 +1,10 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
+import { createReviewAdapter } from "../review/adapter.js";
+import { adaptOfficialRnReview } from "./official-module.js";
+export function createReactNativeReview(options = {}) {
+    return createReviewAdapter(resolvePlatformLoader(options.framework, createDefaultReviewLoader));
+}
+function createDefaultReviewLoader() {
+    return createRnPlatformLoader(module => ({ available: true, module: adaptOfficialRnReview(module) }), false);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/rn/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,UAAU,CA8BZ;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,yBAAyB,CAAC,WAAW,CAAC,GAChD,qBAAqB,CAQvB"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/rn/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,UAAU,CA8BZ;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,yBAAyB,CAAC,WAAW,CAAC,GAChD,qBAAqB,CAEvB"}

package/dist/rn/storage.js

@@ -1,3 +1,5 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
 import { SdkError } from "../index.js";
 import { createSdkStorageFromPlatform } from "../storage/platform-contract.js";
 /**
@@ -37,30 +39,8 @@ export function createReactNativeStorage(options = {}) {
     };
 }
 export function normalizeStorageLoader(framework) {
-    if (!framework) {
-        return createDefaultRnStorageLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultRnStorageLoader);
 }
 function createDefaultRnStorageLoader() {
-    let cached;
-    return async () => {
-        if (cached) {
-            return { available: true, module: cached };
-        }
-        try {
-            // The official RN SDK exposes Storage under the same namespaced shape
-            // as the shared contract, so no conversion is needed.
-            const framework = await import("@apps-in-toss/framework");
-            cached = framework;
-            return { available: true, module: cached };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { available: false, reason: `failed to import @apps-in-toss/framework: ${message}` };
-        }
-    };
+    return createRnPlatformLoader(module => ({ available: true, module: module }));
 }

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-contract.js

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

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/webview/framework-loader.js

@@ -0,0 +1,16 @@
+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 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" };
+        }
+        return { available: true, module: iap };
+    });
+}

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"}