@apps-in-toss/web-bridge 1.5.3 → 1.6.0

package/built/index.cjs

@@ -26,6 +26,7 @@ __export(index_exports, {
   IAP: () => IAP,
   SafeAreaInsets: () => SafeAreaInsets,
   Storage: () => Storage,
+  TossAds: () => TossAds,
   appsInTossEvent: () => appsInTossEvent,
   env: () => env,
   fetchAlbumPhotos: () => fetchAlbumPhotos,
@@ -36,9 +37,11 @@ __export(index_exports, {
   getSafeAreaInsets: () => getSafeAreaInsets,
   graniteEvent: () => graniteEvent,
   isMinVersionSupported: () => isMinVersionSupported,
+  loadFullScreenAd: () => loadFullScreenAd,
   openCamera: () => openCamera,
   partner: () => partner,
   setClipboardText: () => setClipboardText,
+  showFullScreenAd: () => showFullScreenAd,
   startUpdateLocation: () => startUpdateLocation,
   tdsEvent: () => tdsEvent
 });
@@ -1060,6 +1063,287 @@ var startUpdateLocation = (params) => {
 startUpdateLocation.getPermission = () => getPermission2({ name: "geolocation", access: "access" });
 startUpdateLocation.openPermissionDialog = () => openPermissionDialog2({ name: "geolocation", access: "access" });
 
+// src/integratedAd.ts
+var import_bridge_core21 = require("@apps-in-toss/bridge-core");
+var loadFullScreenAd = Object.assign((0, import_bridge_core21.createEventBridge)("loadFullScreenAd"), {
+  isSupported: (0, import_bridge_core21.createConstantBridge)("loadFullScreenAd_isSupported")
+});
+var showFullScreenAd = Object.assign((0, import_bridge_core21.createEventBridge)("showFullScreenAd"), {
+  isSupported: (0, import_bridge_core21.createConstantBridge)("showFullScreenAd_isSupported")
+});
+
+// src/toss-ad/index.ts
+var import_bridge_core23 = require("@apps-in-toss/bridge-core");
+
+// src/toss-ad/opener.ts
+var import_bridge_core22 = require("@apps-in-toss/bridge-core");
+var openURL = (0, import_bridge_core22.createAsyncBridge)("openURL");
+function openUrlOpener(url) {
+  const transformed = getWebSchemeOrUri(url);
+  return openURL(transformed);
+}
+function getWebSchemeOrUri(uri) {
+  const isHttp = ["http://", "https://"].some((protocol) => uri.startsWith(protocol));
+  return isHttp ? supertossWeb(uri) : uri;
+}
+function supertossWeb(uri) {
+  return `supertoss://web?url=${encodeURIComponent(uri)}&external=true`;
+}
+
+// src/toss-ad/scriptLoader.ts
+var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-1.3.0.js";
+var DEFAULT_TIMEOUT_MS = 15e3;
+var pendingLoad = null;
+function getAdsSdk() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window.TossAdsSpaceKit;
+}
+function loadAdsSdk() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return Promise.reject(new Error("Ads SDK can only be loaded in a browser environment."));
+  }
+  const existing = getAdsSdk();
+  if (existing) {
+    return Promise.resolve(existing);
+  }
+  if (pendingLoad) {
+    return pendingLoad;
+  }
+  const promise = new Promise((resolve, reject) => {
+    const script = document.createElement("script");
+    const cleanup = () => {
+      script.removeEventListener("load", handleLoad);
+      script.removeEventListener("error", handleError);
+      window.clearTimeout(timeoutId);
+      pendingLoad = null;
+    };
+    const handleLoad = () => {
+      const sdk = getAdsSdk();
+      if (sdk) {
+        cleanup();
+        resolve(sdk);
+        return;
+      }
+      cleanup();
+      reject(new Error("Ads SDK script loaded but window.TossAdsSpaceKit was not exposed."));
+    };
+    const handleError = () => {
+      cleanup();
+      reject(new Error(`Failed to load Ads SDK script from ${DEFAULT_SDK_URL}.`));
+    };
+    const timeoutId = window.setTimeout(() => {
+      cleanup();
+      reject(new Error(`Loading Ads SDK timed out after ${DEFAULT_TIMEOUT_MS}ms.`));
+    }, DEFAULT_TIMEOUT_MS);
+    script.addEventListener("load", handleLoad);
+    script.addEventListener("error", handleError);
+    script.async = true;
+    script.src = DEFAULT_SDK_URL;
+    document.head.appendChild(script);
+  });
+  pendingLoad = promise;
+  return promise;
+}
+
+// src/toss-ad/index.ts
+var fetchTossAd = Object.assign((0, import_bridge_core23.createEventBridge)("fetchTossAd"), {
+  isSupported: (0, import_bridge_core23.createConstantBridge)("fetchTossAd_isSupported")
+});
+var tossAdEventLog = (0, import_bridge_core23.createAsyncBridge)("tossAdEventLog");
+var SUPPORTED_STYLE_IDS = /* @__PURE__ */ new Set(["1", "2"]);
+function fetchTossAdPromise(options) {
+  return new Promise((resolve, reject) => {
+    if (!fetchTossAd.isSupported()) {
+      reject(new Error("fetchTossAd is not supported in this environment."));
+      return;
+    }
+    return fetchTossAd({
+      options,
+      onEvent: resolve,
+      onError: reject
+    });
+  });
+}
+function normalizeAdResponse(adResponse) {
+  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
+  return {
+    requestId: adResponse.requestId ?? "",
+    status: adResponse.status ?? "OK",
+    ads,
+    ext: adResponse.ext
+  };
+}
+function normalizeApiResponse(raw) {
+  if (isApiResponse(raw)) {
+    if (raw.resultType !== "SUCCESS") {
+      return raw;
+    }
+    if (!raw.success) {
+      return {
+        resultType: "FAIL",
+        error: { reason: "fetchTossAd returned SUCCESS without payload" }
+      };
+    }
+    return { ...raw, success: normalizeAdResponse(raw.success) };
+  }
+  if (isAdResponse(raw)) {
+    return {
+      resultType: "SUCCESS",
+      success: normalizeAdResponse(raw)
+    };
+  }
+  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
+}
+function isApiResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
+}
+function isAdResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+}
+function createCustomAdFetcher() {
+  return async (_endpoint, request) => {
+    try {
+      const raw = await fetchTossAdPromise({
+        adGroupId: request.spaceUnitId,
+        sdkId: "108",
+        availableStyleIds: ["1", "2"]
+      });
+      return normalizeApiResponse(raw);
+    } catch (error) {
+      return {
+        resultType: "FAIL",
+        error: {
+          reason: error instanceof Error ? error.message : "Unknown fetchTossAd error"
+        }
+      };
+    }
+  };
+}
+var pendingLoad2 = null;
+function initialize(options) {
+  const { callbacks } = options;
+  if (window.TossAdsSpaceKit != null && window.TossAdsSpaceKit.isInitialized()) {
+    callbacks?.onInitializationFailed?.(new Error("[toss-ad] Already initialized."));
+    return;
+  }
+  if (pendingLoad2 != null) {
+    callbacks?.onInitializationFailed?.(new Error("[toss-ad] initialization already in progress."));
+  }
+  const resolveInitialized = () => callbacks?.onInitialized?.();
+  const rejectInitialized = (error) => {
+    const normalizedError = error instanceof Error ? error : new Error(String(error));
+    callbacks?.onInitializationFailed?.(normalizedError);
+  };
+  pendingLoad2 = loadAdsSdk().then((sdk) => {
+    const customAdFetcher = createCustomAdFetcher();
+    const config = { environment: "live", customAdFetcher, opener: openUrlOpener };
+    sdk.init(config);
+    resolveInitialized();
+  }).catch((error) => {
+    pendingLoad2 = null;
+    rejectInitialized(error);
+  });
+}
+function attach(adGroupId, target, options = {}) {
+  const { callbacks } = options;
+  const rejectAttached = (error) => {
+    const normalizedError = error instanceof Error ? error : new Error(String(error));
+    callbacks?.onAdFailedToRender?.({
+      slotId: "",
+      adGroupId,
+      adMetadata: {},
+      error: { code: 0, message: normalizedError.message }
+    });
+  };
+  try {
+    const spaceId = adGroupId;
+    const sdk = getAdsSdk();
+    if (!sdk) {
+      throw new Error("[toss-ad] Call initialize() before attaching an ad.");
+    }
+    if (!sdk.banner) {
+      throw new Error("[toss-ad] Loaded TossAdsSpaceKit does not support banner ads.");
+    }
+    const element = typeof target === "string" ? document.querySelector(target) : target;
+    if (!element) {
+      throw new Error(`[toss-ad] Failed to find target element: ${target}`);
+    }
+    const slotOptions = {
+      spaceId,
+      autoLoad: true,
+      theme: options.theme,
+      padding: options.padding,
+      callbacks: wrapCallbacks(adGroupId, options.callbacks)
+    };
+    sdk.banner.createSlot(element, slotOptions);
+  } catch (error) {
+    rejectAttached(error);
+  }
+}
+function destroy(slotId) {
+  const sdk = getAdsSdk();
+  if (!sdk?.banner) {
+    return;
+  }
+  sdk.banner.destroy(slotId);
+}
+function destroyAll() {
+  const sdk = getAdsSdk();
+  if (!sdk?.banner) {
+    return;
+  }
+  sdk.banner.destroyAll();
+}
+function wrapCallbacks(adGroupId, callbacks) {
+  if (!callbacks) {
+    return void 0;
+  }
+  const mapEvent = (payload) => {
+    const next = { ...payload ?? {} };
+    next.adGroupId = next.adGroupId ?? next.spaceId ?? adGroupId;
+    delete next.spaceId;
+    return next;
+  };
+  return {
+    onAdRendered: (payload) => callbacks.onAdRendered?.(mapEvent(payload)),
+    onAdViewable: (payload) => callbacks.onAdViewable?.(mapEvent(payload)),
+    onAdClicked: (payload) => callbacks.onAdClicked?.(mapEvent(payload)),
+    onAdImpression: (payload) => {
+      tossAdEventLog({
+        log_name: "display_ads_all::impression__1px_banner",
+        log_type: "event",
+        params: {
+          event_type: "impression",
+          schema_id: 1812034,
+          request_id: payload?.adMetadata?.requestId ?? ""
+        }
+      });
+      callbacks.onAdImpression?.(mapEvent(payload));
+    },
+    onAdFailedToRender: (payload) => callbacks.onAdFailedToRender?.({
+      ...mapEvent(payload),
+      error: payload?.error ?? { code: 0, message: "UNKNOWN" }
+    }),
+    onNoFill: (payload) => callbacks.onNoFill?.(mapEvent(payload))
+  };
+}
+var TossAds = {
+  initialize: Object.assign(initialize, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  attach: Object.assign(attach, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  destroy: Object.assign(destroy, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  destroyAll: Object.assign(destroyAll, {
+    isSupported: fetchTossAd.isSupported
+  })
+};
+
 // src/index.ts
 __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -1068,6 +1352,7 @@ __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
   IAP,
   SafeAreaInsets,
   Storage,
+  TossAds,
   appsInTossEvent,
   env,
   fetchAlbumPhotos,
@@ -1078,9 +1363,11 @@ __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
   getSafeAreaInsets,
   graniteEvent,
   isMinVersionSupported,
+  loadFullScreenAd,
   openCamera,
   partner,
   setClipboardText,
+  showFullScreenAd,
   startUpdateLocation,
   tdsEvent,
   ...require("@apps-in-toss/bridge-core"),

package/built/index.d.cts

@@ -1,6 +1,6 @@
 export * from './bridge';
 export * from '@apps-in-toss/bridge-core';
-import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions } from '@apps-in-toss/framework';
+import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions, LoadFullScreenAdEvent, LoadFullScreenAdOptions, ShowFullScreenAdEvent, ShowFullScreenAdOptions } from '@apps-in-toss/framework';
 import * as _apps_in_toss_types from '@apps-in-toss/types';
 import { FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
@@ -342,15 +342,15 @@ declare function getSafeAreaInsets(): {
  * ```
  */
 declare function subscribeSafeAreaInsets({ onEvent }: {
-    onEvent: (data: SafeAreaInsets) => void;
+    onEvent: (data: SafeAreaInsets$1) => void;
 }): () => void;
-interface SafeAreaInsets {
+interface SafeAreaInsets$1 {
     top: number;
     bottom: number;
     left: number;
     right: number;
 }
-declare const SafeAreaInsets: {
+declare const SafeAreaInsets$1: {
     get: typeof getSafeAreaInsets;
     subscribe: typeof subscribeSafeAreaInsets;
 };
@@ -961,4 +961,189 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, SafeAreaInsets, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };
+declare const loadFullScreenAd: ((args: {
+    onEvent: (data: LoadFullScreenAdEvent) => void;
+    onError: (error: Error) => void;
+    options?: LoadFullScreenAdOptions | undefined;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+declare const showFullScreenAd: ((args: {
+    onEvent: (data: ShowFullScreenAdEvent) => void;
+    onError: (error: Error) => void;
+    options?: ShowFullScreenAdOptions | undefined;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+
+type Environment = 'alpha' | 'live';
+type DeviceOS = 'IOS' | 'ANDROID';
+type DeviceAttStatus = 'NOT_DETERMINED' | 'RESTRICTED' | 'DENIED' | 'AUTHORIZED';
+type DeviceCarrier = 'SKT' | 'KT' | 'LGU' | 'SKT_MVNO' | 'KT_MVNO' | 'LG_MVNO';
+type RequestHeaders = Record<string, string>;
+interface DeviceInfo {
+    os?: DeviceOS;
+    osVersion?: string;
+    ua?: string;
+    ifa?: string;
+    ifv?: string | null;
+    attStatus?: DeviceAttStatus | null;
+    model?: string;
+    carrier?: DeviceCarrier;
+}
+interface SafeAreaInsets {
+    top: string;
+    bottom: string;
+    left: string;
+    right: string;
+}
+interface RuntimeInfo {
+    safeAreaInsets?: SafeAreaInsets;
+}
+type AdOpener = (url: string, target?: string, features?: string) => void;
+interface AdConfig {
+    environment: Environment;
+    apiEndpoint?: string;
+    deviceInfo?: DeviceInfo;
+    requestHeaders?: RequestHeaders;
+    runtimeInfo?: RuntimeInfo;
+    opener?: AdOpener;
+    customAdFetcher?: CustomAdFetcher;
+}
+interface AdRequest {
+    spaceUnitId: string;
+    options?: {
+        dummyAdFormat?: string;
+        maxSize?: number;
+        video?: {
+            maxDurationMs?: number;
+        };
+    };
+}
+type AdResponseStatus = 'OK' | 'NO_AD' | 'BLOCKED' | 'ERROR' | 'TIMEOUT' | 'INVALID_SPACE' | 'INVALID_REQUEST' | 'LIMITED_AD' | 'CONSENT_REQUIRED' | 'TEST_MODE';
+interface AdResponse {
+    requestId?: string;
+    status?: AdResponseStatus;
+    ads: Ad[];
+    ext?: AdResponseExt;
+}
+interface Ad {
+    styleId: string;
+    creative: Record<string, any>;
+    eventTrackingUrls?: string[];
+    eventTypes?: string[];
+    eventPayload?: string;
+    requestId?: string;
+}
+interface AdResponseExt {
+    skippableOffsetSeconds?: number;
+    reward?: {
+        type: string;
+        amount: number;
+    };
+    isAdBadgeEnabled?: boolean;
+    refetchSeconds?: number | null;
+}
+interface ApiResponse<T> {
+    resultType: 'SUCCESS' | 'HTTP_TIMEOUT' | 'NETWORK_ERROR' | 'EXECUTION_FAIL' | 'INTERRUPTED' | 'INTERNAL_ERROR' | 'FAIL';
+    success?: T;
+    error?: {
+        errorType?: number;
+        errorCode?: string;
+        reason?: string;
+        data?: Record<string, any>;
+        title?: string;
+    };
+}
+type CustomAdFetcher = (endpoint: string, request: AdRequest, headers?: RequestHeaders) => Promise<ApiResponse<AdResponse>>;
+interface InitializeOptions {
+    callbacks?: {
+        onInitialized?: () => void;
+        onInitializationFailed?: (error: Error) => void;
+    };
+}
+interface BannerSlotEventPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: {
+        creativeId: string;
+        requestId: string;
+    };
+}
+interface BannerSlotErrorPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: Record<string, never>;
+    error: {
+        code: number;
+        message: string;
+        domain?: string;
+    };
+}
+interface BannerSlotCallbacks {
+    onAdRendered?: (payload: BannerSlotEventPayload) => void;
+    onAdViewable?: (payload: BannerSlotEventPayload) => void;
+    onAdClicked?: (payload: BannerSlotEventPayload) => void;
+    onAdImpression?: (payload: BannerSlotEventPayload) => void;
+    onAdFailedToRender?: (payload: BannerSlotErrorPayload) => void;
+    onNoFill?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+    }) => void;
+}
+interface BannerSlotOptions {
+    spaceId: string;
+    autoLoad?: boolean;
+    dummyAdFormat?: string;
+    maxVideoDurationMs?: number;
+    refetchIntervalMs?: number;
+    theme?: 'light' | 'dark';
+    padding?: string;
+    callbacks?: BannerSlotCallbacks;
+}
+interface BannerSlot {
+    load(): void | Promise<void>;
+    destroy(): void;
+}
+interface BannerNamespace {
+    createSlot(target: string | HTMLElement, options: BannerSlotOptions): BannerSlot;
+    destroy(slotId: string): void;
+    destroyAll(): void;
+}
+interface AdsSdkGlobal {
+    init(config: AdConfig): void;
+    banner: BannerNamespace;
+    isInitialized(): boolean;
+}
+declare global {
+    interface Window {
+        TossAdsSpaceKit?: AdsSdkGlobal;
+    }
+}
+interface AttachOptions {
+    theme?: 'light' | 'dark';
+    padding?: string;
+    callbacks?: BannerSlotCallbacks;
+}
+
+declare function initialize(options: InitializeOptions): void;
+declare function attach(adGroupId: string, target: string | HTMLElement, options?: AttachOptions): void;
+declare function destroy(slotId: string): void;
+declare function destroyAll(): void;
+declare const TossAds: {
+    initialize: typeof initialize & {
+        isSupported: () => boolean;
+    };
+    attach: typeof attach & {
+        isSupported: () => boolean;
+    };
+    destroy: typeof destroy & {
+        isSupported: () => boolean;
+    };
+    destroyAll: typeof destroyAll & {
+        isSupported: () => boolean;
+    };
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, SafeAreaInsets$1 as SafeAreaInsets, Storage, type TdsEvent, TossAds, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/built/index.d.ts

@@ -1,6 +1,6 @@
 export * from './bridge';
 export * from '@apps-in-toss/bridge-core';
-import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions } from '@apps-in-toss/framework';
+import { LoadAdMobInterstitialAdEvent, LoadAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent, ShowAdMobInterstitialAdOptions, LoadAdMobRewardedAdEvent, LoadAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent, ShowAdMobRewardedAdOptions, LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions, LoadFullScreenAdEvent, LoadFullScreenAdOptions, ShowFullScreenAdEvent, ShowFullScreenAdOptions } from '@apps-in-toss/framework';
 import * as _apps_in_toss_types from '@apps-in-toss/types';
 import { FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
@@ -342,15 +342,15 @@ declare function getSafeAreaInsets(): {
  * ```
  */
 declare function subscribeSafeAreaInsets({ onEvent }: {
-    onEvent: (data: SafeAreaInsets) => void;
+    onEvent: (data: SafeAreaInsets$1) => void;
 }): () => void;
-interface SafeAreaInsets {
+interface SafeAreaInsets$1 {
     top: number;
     bottom: number;
     left: number;
     right: number;
 }
-declare const SafeAreaInsets: {
+declare const SafeAreaInsets$1: {
     get: typeof getSafeAreaInsets;
     subscribe: typeof subscribeSafeAreaInsets;
 };
@@ -961,4 +961,189 @@ declare const startUpdateLocation: {
     openPermissionDialog(): Promise<"denied" | "allowed">;
 };
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, SafeAreaInsets, Storage, type TdsEvent, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, openCamera, partner, setClipboardText, startUpdateLocation, tdsEvent };
+declare const loadFullScreenAd: ((args: {
+    onEvent: (data: LoadFullScreenAdEvent) => void;
+    onError: (error: Error) => void;
+    options?: LoadFullScreenAdOptions | undefined;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+declare const showFullScreenAd: ((args: {
+    onEvent: (data: ShowFullScreenAdEvent) => void;
+    onError: (error: Error) => void;
+    options?: ShowFullScreenAdOptions | undefined;
+}) => () => void) & {
+    isSupported: () => boolean;
+};
+
+type Environment = 'alpha' | 'live';
+type DeviceOS = 'IOS' | 'ANDROID';
+type DeviceAttStatus = 'NOT_DETERMINED' | 'RESTRICTED' | 'DENIED' | 'AUTHORIZED';
+type DeviceCarrier = 'SKT' | 'KT' | 'LGU' | 'SKT_MVNO' | 'KT_MVNO' | 'LG_MVNO';
+type RequestHeaders = Record<string, string>;
+interface DeviceInfo {
+    os?: DeviceOS;
+    osVersion?: string;
+    ua?: string;
+    ifa?: string;
+    ifv?: string | null;
+    attStatus?: DeviceAttStatus | null;
+    model?: string;
+    carrier?: DeviceCarrier;
+}
+interface SafeAreaInsets {
+    top: string;
+    bottom: string;
+    left: string;
+    right: string;
+}
+interface RuntimeInfo {
+    safeAreaInsets?: SafeAreaInsets;
+}
+type AdOpener = (url: string, target?: string, features?: string) => void;
+interface AdConfig {
+    environment: Environment;
+    apiEndpoint?: string;
+    deviceInfo?: DeviceInfo;
+    requestHeaders?: RequestHeaders;
+    runtimeInfo?: RuntimeInfo;
+    opener?: AdOpener;
+    customAdFetcher?: CustomAdFetcher;
+}
+interface AdRequest {
+    spaceUnitId: string;
+    options?: {
+        dummyAdFormat?: string;
+        maxSize?: number;
+        video?: {
+            maxDurationMs?: number;
+        };
+    };
+}
+type AdResponseStatus = 'OK' | 'NO_AD' | 'BLOCKED' | 'ERROR' | 'TIMEOUT' | 'INVALID_SPACE' | 'INVALID_REQUEST' | 'LIMITED_AD' | 'CONSENT_REQUIRED' | 'TEST_MODE';
+interface AdResponse {
+    requestId?: string;
+    status?: AdResponseStatus;
+    ads: Ad[];
+    ext?: AdResponseExt;
+}
+interface Ad {
+    styleId: string;
+    creative: Record<string, any>;
+    eventTrackingUrls?: string[];
+    eventTypes?: string[];
+    eventPayload?: string;
+    requestId?: string;
+}
+interface AdResponseExt {
+    skippableOffsetSeconds?: number;
+    reward?: {
+        type: string;
+        amount: number;
+    };
+    isAdBadgeEnabled?: boolean;
+    refetchSeconds?: number | null;
+}
+interface ApiResponse<T> {
+    resultType: 'SUCCESS' | 'HTTP_TIMEOUT' | 'NETWORK_ERROR' | 'EXECUTION_FAIL' | 'INTERRUPTED' | 'INTERNAL_ERROR' | 'FAIL';
+    success?: T;
+    error?: {
+        errorType?: number;
+        errorCode?: string;
+        reason?: string;
+        data?: Record<string, any>;
+        title?: string;
+    };
+}
+type CustomAdFetcher = (endpoint: string, request: AdRequest, headers?: RequestHeaders) => Promise<ApiResponse<AdResponse>>;
+interface InitializeOptions {
+    callbacks?: {
+        onInitialized?: () => void;
+        onInitializationFailed?: (error: Error) => void;
+    };
+}
+interface BannerSlotEventPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: {
+        creativeId: string;
+        requestId: string;
+    };
+}
+interface BannerSlotErrorPayload {
+    slotId: string;
+    adGroupId: string;
+    adMetadata: Record<string, never>;
+    error: {
+        code: number;
+        message: string;
+        domain?: string;
+    };
+}
+interface BannerSlotCallbacks {
+    onAdRendered?: (payload: BannerSlotEventPayload) => void;
+    onAdViewable?: (payload: BannerSlotEventPayload) => void;
+    onAdClicked?: (payload: BannerSlotEventPayload) => void;
+    onAdImpression?: (payload: BannerSlotEventPayload) => void;
+    onAdFailedToRender?: (payload: BannerSlotErrorPayload) => void;
+    onNoFill?: (payload: {
+        slotId: string;
+        adGroupId: string;
+        adMetadata: Record<string, never>;
+    }) => void;
+}
+interface BannerSlotOptions {
+    spaceId: string;
+    autoLoad?: boolean;
+    dummyAdFormat?: string;
+    maxVideoDurationMs?: number;
+    refetchIntervalMs?: number;
+    theme?: 'light' | 'dark';
+    padding?: string;
+    callbacks?: BannerSlotCallbacks;
+}
+interface BannerSlot {
+    load(): void | Promise<void>;
+    destroy(): void;
+}
+interface BannerNamespace {
+    createSlot(target: string | HTMLElement, options: BannerSlotOptions): BannerSlot;
+    destroy(slotId: string): void;
+    destroyAll(): void;
+}
+interface AdsSdkGlobal {
+    init(config: AdConfig): void;
+    banner: BannerNamespace;
+    isInitialized(): boolean;
+}
+declare global {
+    interface Window {
+        TossAdsSpaceKit?: AdsSdkGlobal;
+    }
+}
+interface AttachOptions {
+    theme?: 'light' | 'dark';
+    padding?: string;
+    callbacks?: BannerSlotCallbacks;
+}
+
+declare function initialize(options: InitializeOptions): void;
+declare function attach(adGroupId: string, target: string | HTMLElement, options?: AttachOptions): void;
+declare function destroy(slotId: string): void;
+declare function destroyAll(): void;
+declare const TossAds: {
+    initialize: typeof initialize & {
+        isSupported: () => boolean;
+    };
+    attach: typeof attach & {
+        isSupported: () => boolean;
+    };
+    destroy: typeof destroy & {
+        isSupported: () => boolean;
+    };
+    destroyAll: typeof destroyAll & {
+        isSupported: () => boolean;
+    };
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, SafeAreaInsets$1 as SafeAreaInsets, Storage, type TdsEvent, TossAds, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/built/index.js

@@ -1022,6 +1022,287 @@ var startUpdateLocation = (params) => {
 startUpdateLocation.getPermission = () => getPermission2({ name: "geolocation", access: "access" });
 startUpdateLocation.openPermissionDialog = () => openPermissionDialog2({ name: "geolocation", access: "access" });
 
+// src/integratedAd.ts
+import { createConstantBridge as createConstantBridge6, createEventBridge as createEventBridge8 } from "@apps-in-toss/bridge-core";
+var loadFullScreenAd = Object.assign(createEventBridge8("loadFullScreenAd"), {
+  isSupported: createConstantBridge6("loadFullScreenAd_isSupported")
+});
+var showFullScreenAd = Object.assign(createEventBridge8("showFullScreenAd"), {
+  isSupported: createConstantBridge6("showFullScreenAd_isSupported")
+});
+
+// src/toss-ad/index.ts
+import { createAsyncBridge as createAsyncBridge13, createConstantBridge as createConstantBridge7, createEventBridge as createEventBridge9 } from "@apps-in-toss/bridge-core";
+
+// src/toss-ad/opener.ts
+import { createAsyncBridge as createAsyncBridge12 } from "@apps-in-toss/bridge-core";
+var openURL = createAsyncBridge12("openURL");
+function openUrlOpener(url) {
+  const transformed = getWebSchemeOrUri(url);
+  return openURL(transformed);
+}
+function getWebSchemeOrUri(uri) {
+  const isHttp = ["http://", "https://"].some((protocol) => uri.startsWith(protocol));
+  return isHttp ? supertossWeb(uri) : uri;
+}
+function supertossWeb(uri) {
+  return `supertoss://web?url=${encodeURIComponent(uri)}&external=true`;
+}
+
+// src/toss-ad/scriptLoader.ts
+var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-1.3.0.js";
+var DEFAULT_TIMEOUT_MS = 15e3;
+var pendingLoad = null;
+function getAdsSdk() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window.TossAdsSpaceKit;
+}
+function loadAdsSdk() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return Promise.reject(new Error("Ads SDK can only be loaded in a browser environment."));
+  }
+  const existing = getAdsSdk();
+  if (existing) {
+    return Promise.resolve(existing);
+  }
+  if (pendingLoad) {
+    return pendingLoad;
+  }
+  const promise = new Promise((resolve, reject) => {
+    const script = document.createElement("script");
+    const cleanup = () => {
+      script.removeEventListener("load", handleLoad);
+      script.removeEventListener("error", handleError);
+      window.clearTimeout(timeoutId);
+      pendingLoad = null;
+    };
+    const handleLoad = () => {
+      const sdk = getAdsSdk();
+      if (sdk) {
+        cleanup();
+        resolve(sdk);
+        return;
+      }
+      cleanup();
+      reject(new Error("Ads SDK script loaded but window.TossAdsSpaceKit was not exposed."));
+    };
+    const handleError = () => {
+      cleanup();
+      reject(new Error(`Failed to load Ads SDK script from ${DEFAULT_SDK_URL}.`));
+    };
+    const timeoutId = window.setTimeout(() => {
+      cleanup();
+      reject(new Error(`Loading Ads SDK timed out after ${DEFAULT_TIMEOUT_MS}ms.`));
+    }, DEFAULT_TIMEOUT_MS);
+    script.addEventListener("load", handleLoad);
+    script.addEventListener("error", handleError);
+    script.async = true;
+    script.src = DEFAULT_SDK_URL;
+    document.head.appendChild(script);
+  });
+  pendingLoad = promise;
+  return promise;
+}
+
+// src/toss-ad/index.ts
+var fetchTossAd = Object.assign(createEventBridge9("fetchTossAd"), {
+  isSupported: createConstantBridge7("fetchTossAd_isSupported")
+});
+var tossAdEventLog = createAsyncBridge13("tossAdEventLog");
+var SUPPORTED_STYLE_IDS = /* @__PURE__ */ new Set(["1", "2"]);
+function fetchTossAdPromise(options) {
+  return new Promise((resolve, reject) => {
+    if (!fetchTossAd.isSupported()) {
+      reject(new Error("fetchTossAd is not supported in this environment."));
+      return;
+    }
+    return fetchTossAd({
+      options,
+      onEvent: resolve,
+      onError: reject
+    });
+  });
+}
+function normalizeAdResponse(adResponse) {
+  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
+  return {
+    requestId: adResponse.requestId ?? "",
+    status: adResponse.status ?? "OK",
+    ads,
+    ext: adResponse.ext
+  };
+}
+function normalizeApiResponse(raw) {
+  if (isApiResponse(raw)) {
+    if (raw.resultType !== "SUCCESS") {
+      return raw;
+    }
+    if (!raw.success) {
+      return {
+        resultType: "FAIL",
+        error: { reason: "fetchTossAd returned SUCCESS without payload" }
+      };
+    }
+    return { ...raw, success: normalizeAdResponse(raw.success) };
+  }
+  if (isAdResponse(raw)) {
+    return {
+      resultType: "SUCCESS",
+      success: normalizeAdResponse(raw)
+    };
+  }
+  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
+}
+function isApiResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
+}
+function isAdResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+}
+function createCustomAdFetcher() {
+  return async (_endpoint, request) => {
+    try {
+      const raw = await fetchTossAdPromise({
+        adGroupId: request.spaceUnitId,
+        sdkId: "108",
+        availableStyleIds: ["1", "2"]
+      });
+      return normalizeApiResponse(raw);
+    } catch (error) {
+      return {
+        resultType: "FAIL",
+        error: {
+          reason: error instanceof Error ? error.message : "Unknown fetchTossAd error"
+        }
+      };
+    }
+  };
+}
+var pendingLoad2 = null;
+function initialize(options) {
+  const { callbacks } = options;
+  if (window.TossAdsSpaceKit != null && window.TossAdsSpaceKit.isInitialized()) {
+    callbacks?.onInitializationFailed?.(new Error("[toss-ad] Already initialized."));
+    return;
+  }
+  if (pendingLoad2 != null) {
+    callbacks?.onInitializationFailed?.(new Error("[toss-ad] initialization already in progress."));
+  }
+  const resolveInitialized = () => callbacks?.onInitialized?.();
+  const rejectInitialized = (error) => {
+    const normalizedError = error instanceof Error ? error : new Error(String(error));
+    callbacks?.onInitializationFailed?.(normalizedError);
+  };
+  pendingLoad2 = loadAdsSdk().then((sdk) => {
+    const customAdFetcher = createCustomAdFetcher();
+    const config = { environment: "live", customAdFetcher, opener: openUrlOpener };
+    sdk.init(config);
+    resolveInitialized();
+  }).catch((error) => {
+    pendingLoad2 = null;
+    rejectInitialized(error);
+  });
+}
+function attach(adGroupId, target, options = {}) {
+  const { callbacks } = options;
+  const rejectAttached = (error) => {
+    const normalizedError = error instanceof Error ? error : new Error(String(error));
+    callbacks?.onAdFailedToRender?.({
+      slotId: "",
+      adGroupId,
+      adMetadata: {},
+      error: { code: 0, message: normalizedError.message }
+    });
+  };
+  try {
+    const spaceId = adGroupId;
+    const sdk = getAdsSdk();
+    if (!sdk) {
+      throw new Error("[toss-ad] Call initialize() before attaching an ad.");
+    }
+    if (!sdk.banner) {
+      throw new Error("[toss-ad] Loaded TossAdsSpaceKit does not support banner ads.");
+    }
+    const element = typeof target === "string" ? document.querySelector(target) : target;
+    if (!element) {
+      throw new Error(`[toss-ad] Failed to find target element: ${target}`);
+    }
+    const slotOptions = {
+      spaceId,
+      autoLoad: true,
+      theme: options.theme,
+      padding: options.padding,
+      callbacks: wrapCallbacks(adGroupId, options.callbacks)
+    };
+    sdk.banner.createSlot(element, slotOptions);
+  } catch (error) {
+    rejectAttached(error);
+  }
+}
+function destroy(slotId) {
+  const sdk = getAdsSdk();
+  if (!sdk?.banner) {
+    return;
+  }
+  sdk.banner.destroy(slotId);
+}
+function destroyAll() {
+  const sdk = getAdsSdk();
+  if (!sdk?.banner) {
+    return;
+  }
+  sdk.banner.destroyAll();
+}
+function wrapCallbacks(adGroupId, callbacks) {
+  if (!callbacks) {
+    return void 0;
+  }
+  const mapEvent = (payload) => {
+    const next = { ...payload ?? {} };
+    next.adGroupId = next.adGroupId ?? next.spaceId ?? adGroupId;
+    delete next.spaceId;
+    return next;
+  };
+  return {
+    onAdRendered: (payload) => callbacks.onAdRendered?.(mapEvent(payload)),
+    onAdViewable: (payload) => callbacks.onAdViewable?.(mapEvent(payload)),
+    onAdClicked: (payload) => callbacks.onAdClicked?.(mapEvent(payload)),
+    onAdImpression: (payload) => {
+      tossAdEventLog({
+        log_name: "display_ads_all::impression__1px_banner",
+        log_type: "event",
+        params: {
+          event_type: "impression",
+          schema_id: 1812034,
+          request_id: payload?.adMetadata?.requestId ?? ""
+        }
+      });
+      callbacks.onAdImpression?.(mapEvent(payload));
+    },
+    onAdFailedToRender: (payload) => callbacks.onAdFailedToRender?.({
+      ...mapEvent(payload),
+      error: payload?.error ?? { code: 0, message: "UNKNOWN" }
+    }),
+    onNoFill: (payload) => callbacks.onNoFill?.(mapEvent(payload))
+  };
+}
+var TossAds = {
+  initialize: Object.assign(initialize, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  attach: Object.assign(attach, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  destroy: Object.assign(destroy, {
+    isSupported: fetchTossAd.isSupported
+  }),
+  destroyAll: Object.assign(destroyAll, {
+    isSupported: fetchTossAd.isSupported
+  })
+};
+
 // src/index.ts
 export * from "@apps-in-toss/types";
 export {
@@ -1029,6 +1310,7 @@ export {
   IAP,
   SafeAreaInsets,
   Storage,
+  TossAds,
   appsInTossEvent,
   env,
   fetchAlbumPhotos,
@@ -1039,9 +1321,11 @@ export {
   getSafeAreaInsets,
   graniteEvent,
   isMinVersionSupported,
+  loadFullScreenAd,
   openCamera,
   partner,
   setClipboardText,
+  showFullScreenAd,
   startUpdateLocation,
   tdsEvent
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "1.5.3",
+  "version": "1.6.0",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -28,11 +28,11 @@
     "built"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "1.5.3"
+    "@apps-in-toss/types": "1.6.0"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "1.5.3",
-    "@apps-in-toss/framework": "1.5.3",
+    "@apps-in-toss/bridge-core": "1.6.0",
+    "@apps-in-toss/framework": "1.6.0",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "b6152cb5bd176d6fd1863ff00638b38f17269e09"
+  "gitHead": "ee1ce0d363246b54246472599e0312cd2d2c1ff5"
 }