@apps-in-toss/web-bridge 0.0.0-dev.1763036638916 → 0.0.0-dev.1764816865438

package/built/bridge.d.ts

@@ -26,6 +26,7 @@ export * from './getGameCenterGameProfile';
 export * from './openGameCenterLeaderboard';
 export * from './submitGameCenterLeaderBoardScore';
 export * from './getUserKeyForGame';
+export * from './getIsTossLoginIntegratedService';
 export * from './grantPromotionRewardForGame';
 export * from './getLocale';
 export * from './getSchemeUri';

package/built/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var getIsTossLoginIntegratedService=createAsyncBridge("getIsTossLoginIntegratedService");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/built/getIsTossLoginIntegratedService.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @public
+ * @category 토스 로그인
+ * @name getIsTossLoginIntegratedService
+ * @description
+ * 유저가 토스 로그인을 연동했는지 여부를 확인해요.
+ * 기존 토스 로그인 사용자를 찾아서 게임 식별자로 전환하는 마이그레이션을 할 때 사용할 수 있어요.
+ * @returns {Promise<boolean | undefined>}
+ * 토스 로그인이 연동된 유저인지 여부를 반환해요.
+ * - `true`: 토스 로그인이 연동된 유저에요.
+ * - `false`: 토스 로그인이 연동되지 않은 유저에요.
+ * - `undefined`: 앱 버전이 최소 지원 버전보다 낮아요.
+ * @throw {message: "oauth2ClientId 설정이 필요합니다."} - 토스 로그인을 사용하지 않는 미니앱에서 호출했을 때 발생해요.
+ * @example
+ * ```tsx
+ * // react-native
+ * 
+ * import { getIsTossLoginIntegratedService } from '@apps-in-toss/web-framework';
+ *
+ * function GetIsTossLoginIntegratedServiceButton() {
+ *   async function handlePress() {
+ *     try {
+ *       const result = await getIsTossLoginIntegratedService();
+ *
+ *       if (result === undefined) {
+ *         console.warn('지원하지 않는 앱 버전이에요.');
+ *         return;
+ *       }
+ *       if (result === true) {
+ *         console.log('토스 로그인이 연동된 유저에요.');
+ *         // 여기에서 토스 로그인 연동 유저에 대한 처리를 할 수 있어요.
+ *       }
+ *       if (result === false) {
+ *         console.log('토스 로그인이 연동되지 않은 유저에요.');
+ *         // 여기에서 토스 로그인 연동 유저가 아닌 경우에 대한 처리를 할 수 있어요.
+ *       }
+ *     } catch (error) {
+ *       console.error(error);
+ *     }
+ *   }
+ *
+ *   return (
+ *     <input type="button" onClick={handlePress} value="토스 로그인 통합 서비스 여부 확인" />
+ *   );
+ * }
+ * ```
+ */
+export declare function getIsTossLoginIntegratedService(): Promise<boolean | undefined>;
+
+export {};

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
 });
@@ -304,7 +307,7 @@ var IAP = {
    * @category 인앱결제
    * @name getPendingOrders
    * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-   * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   * @returns {Promise<{ orders: { orderId: string; sku: string; paymentCompletedDate: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
    *
    * @example
    * ### 대기 중인 주문 목록 가져오기
@@ -321,7 +324,9 @@ var IAP = {
    * }
    * ```
    */
-  getPendingOrders: (0, import_bridge_core3.createAsyncBridge)("getPendingOrders"),
+  getPendingOrders: (0, import_bridge_core3.createAsyncBridge)(
+    "getPendingOrders"
+  ),
   /**
    * @public
    * @category 인앱결제
@@ -1058,6 +1063,283 @@ 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.0.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 });
+      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:
@@ -1066,6 +1348,7 @@ __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
   IAP,
   SafeAreaInsets,
   Storage,
+  TossAds,
   appsInTossEvent,
   env,
   fetchAlbumPhotos,
@@ -1076,9 +1359,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';
@@ -230,7 +230,7 @@ declare const IAP: {
      * @category 인앱결제
      * @name getPendingOrders
      * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-     * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     * @returns {Promise<{ orders: { orderId: string; sku: string; paymentCompletedDate: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
      *
      * @example
      * ### 대기 중인 주문 목록 가져오기
@@ -251,6 +251,7 @@ declare const IAP: {
         orders: {
             orderId: string;
             sku: string;
+            paymentCompletedDate: string;
         }[];
     }>;
     /**
@@ -341,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;
 };
@@ -966,4 +967,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';
@@ -230,7 +230,7 @@ declare const IAP: {
      * @category 인앱결제
      * @name getPendingOrders
      * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-     * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+     * @returns {Promise<{ orders: { orderId: string; sku: string; paymentCompletedDate: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
      *
      * @example
      * ### 대기 중인 주문 목록 가져오기
@@ -251,6 +251,7 @@ declare const IAP: {
         orders: {
             orderId: string;
             sku: string;
+            paymentCompletedDate: string;
         }[];
     }>;
     /**
@@ -341,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;
 };
@@ -966,4 +967,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

@@ -262,7 +262,7 @@ var IAP = {
    * @category 인앱결제
    * @name getPendingOrders
    * @description 대기 중인 주문 목록을 가져와요. 이 함수를 사용하면 결제가 아직 완료되지 않은 주문 정보를 확인할 수 있어요.
-   * @returns {Promise<{ orders: { orderId: string; sku: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
+   * @returns {Promise<{ orders: { orderId: string; sku: string; paymentCompletedDate: string; }[]}}>} 대기 중인 주문의 배열을 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 `undefined`를 반환해요.
    *
    * @example
    * ### 대기 중인 주문 목록 가져오기
@@ -279,7 +279,9 @@ var IAP = {
    * }
    * ```
    */
-  getPendingOrders: createAsyncBridge2("getPendingOrders"),
+  getPendingOrders: createAsyncBridge2(
+    "getPendingOrders"
+  ),
   /**
    * @public
    * @category 인앱결제
@@ -1020,6 +1022,283 @@ 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.0.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 });
+      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 {
@@ -1027,6 +1306,7 @@ export {
   IAP,
   SafeAreaInsets,
   Storage,
+  TossAds,
   appsInTossEvent,
   env,
   fetchAlbumPhotos,
@@ -1037,9 +1317,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": "0.0.0-dev.1763036638916",
+  "version": "0.0.0-dev.1764816865438",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "prepack": "yarn build",
@@ -28,11 +28,11 @@
     "built"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "0.0.0-dev.1763036638916"
+    "@apps-in-toss/types": "0.0.0-dev.1764816865438"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "0.0.0-dev.1763036638916",
-    "@apps-in-toss/framework": "0.0.0-dev.1763036638916",
+    "@apps-in-toss/bridge-core": "0.0.0-dev.1764816865438",
+    "@apps-in-toss/framework": "0.0.0-dev.1764816865438",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e9ecae9a4d3c75925e3c8199dbf7ef1e46d23f6d"
+  "gitHead": "d72f564708d831e445bf0ae4e1b9f8cce536dc16"
 }