@mpgd/adapter-ait 0.8.0 → 0.10.0

package/dist/ad-config.d.ts

@@ -1,5 +1,6 @@
+export type AitAdPlacementType = 'rewarded' | 'interstitial' | 'banner';
 export interface AitAdBridgeConfig {
   readonly adGroupIds: Readonly<Record<string, string>>;
-  readonly adPlacementTypes: Readonly<Record<string, 'rewarded' | 'interstitial'>>;
+  readonly adPlacementTypes: Readonly<Record<string, AitAdPlacementType>>;
 }
 export declare function extractAitAdBridgeConfig(input: unknown, sourceLabel?: string): AitAdBridgeConfig;

package/dist/ad-config.js

@@ -9,7 +9,7 @@ export function extractAitAdBridgeConfig(input, sourceLabel = 'ad placements') {
     for (const [placementIndex, placement] of placements.entries()) {
         if (!isRecord(placement)
             || typeof placement.id !== 'string'
-            || (placement.type !== 'rewarded' && placement.type !== 'interstitial')) {
+            || !isAitAdPlacementType(placement.type)) {
             throw new Error(`AIT ad placement entry at index ${placementIndex} is invalid: ${sourceLabel}`);
         }
         if (placementIds.has(placement.id)) {
@@ -28,6 +28,9 @@ export function extractAitAdBridgeConfig(input, sourceLabel = 'ad placements') {
     }
     return { adGroupIds, adPlacementTypes };
 }
+function isAitAdPlacementType(value) {
+    return value === 'rewarded' || value === 'interstitial' || value === 'banner';
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/host.d.ts

@@ -1,20 +1,81 @@
-import { getTossShareLink, grantPromotionRewardForGame as grantPromotionReward, isMinVersionSupported, loadFullScreenAd, openGameCenterLeaderboard, requestNotificationAgreement, share, showFullScreenAd, Storage, submitGameCenterLeaderBoardScore } from '@apps-in-toss/web-framework';
-import type { NotificationTopic, ShareResult } from '@mpgd/platform';
+import { getTossShareLink, grantPromotionRewardForGame as grantPromotionReward, IAP, isMinVersionSupported, loadFullScreenAd, openGameCenterLeaderboard, requestNotificationAgreement, share, showFullScreenAd, Storage, submitGameCenterLeaderBoardScore, TossAds } from '@apps-in-toss/web-framework';
+import type { Entitlement, LogicalProductId, NotificationTopic, ShareResult } from '@mpgd/platform';
+import type { AitAdPlacementType } from './ad-config.js';
 import type { GamePlatformBridge } from './index.js';
 export type AitIdentityProvider = () => Promise<unknown>;
+/**
+* The AIT SDK adds support-version metadata to native functions over time.
+* The host only depends on the callable surface and an optional support probe
+* so adapter tests remain compatible with older wrappers and newer SDKs.
+*/
+type AitOptionalCapabilityMethod<T extends (...args: never[]) => unknown> = (...args: Parameters<T>) => ReturnType<T>;
+interface AitCapabilityProbe {
+  readonly isSupported?: () => boolean;
+}
+type AitNativeMethod<T extends (...args: never[]) => unknown> = AitOptionalCapabilityMethod<T> & AitCapabilityProbe;
+interface AitIapDependencies {
+  readonly createOneTimePurchaseOrder: AitNativeMethod<typeof IAP.createOneTimePurchaseOrder>;
+  readonly getProductItemList: AitNativeMethod<typeof IAP.getProductItemList>;
+  readonly getPendingOrders: AitNativeMethod<typeof IAP.getPendingOrders>;
+  readonly completeProductGrant: AitNativeMethod<typeof IAP.completeProductGrant>;
+}
+interface AitBannerDependencies {
+  readonly initialize: typeof TossAds.initialize;
+  readonly attachBanner: typeof TossAds.attachBanner;
+}
 export interface AitHostDependencies {
   readonly identityProvider: AitIdentityProvider;
   readonly storage: Pick<typeof Storage, 'getItem' | 'removeItem' | 'setItem'>;
   readonly getTossShareLink: typeof getTossShareLink;
   readonly share: typeof share;
-  readonly grantPromotionReward: typeof grantPromotionReward;
-  readonly requestNotificationAgreement: typeof requestNotificationAgreement;
+  readonly grantPromotionReward: AitNativeMethod<typeof grantPromotionReward>;
+  readonly requestNotificationAgreement: AitNativeMethod<typeof requestNotificationAgreement>;
   readonly isMinVersionSupported: typeof isMinVersionSupported;
-  readonly loadFullScreenAd: typeof loadFullScreenAd;
-  readonly showFullScreenAd: typeof showFullScreenAd;
-  readonly openGameCenterLeaderboard: typeof openGameCenterLeaderboard;
-  readonly submitGameCenterLeaderBoardScore: typeof submitGameCenterLeaderBoardScore;
+  readonly loadFullScreenAd: AitNativeMethod<typeof loadFullScreenAd>;
+  readonly showFullScreenAd: AitNativeMethod<typeof showFullScreenAd>;
+  readonly tossAds: AitBannerDependencies;
+  readonly openGameCenterLeaderboard: AitNativeMethod<typeof openGameCenterLeaderboard>;
+  readonly submitGameCenterLeaderBoardScore: AitNativeMethod<typeof submitGameCenterLeaderBoardScore>;
+  readonly iap: AitIapDependencies;
+}
+/** Game-owned logical product mapped to a console-issued Apps in Toss SKU. */
+export interface AitIapProductConfig {
+  readonly productId: LogicalProductId;
+  readonly sku: string;
+  /** Apps in Toss currently displays KRW prices; override only for a supported future catalog. */
+  readonly currencyCode?: string;
+}
+export interface AitIapPreparationInput {
+  readonly intent: 'purchase' | 'restore';
+  readonly productId?: LogicalProductId;
+  readonly platformSku?: string;
+}
+/**
+* Game-owned server gate that ensures the anonymous game key is linked to a
+* Toss login user before a purchase or pending-order recovery can proceed.
+*/
+export type AitIapPreparer = (input: AitIapPreparationInput) => Promise<boolean>;
+export interface AitIapProductGrantVerificationInput {
+  readonly orderId: string;
+  readonly productId: LogicalProductId;
+  readonly platformSku: string;
+  readonly idempotencyKey: string;
+  readonly source: 'process-product-grant' | 'pending-order-restore';
+  /** Client callback time only; the game authority must use the order status time. */
+  readonly purchasedAt: string;
+  readonly signal: AbortSignal;
+  readonly timeoutMs: number;
 }
+/**
+* A server-backed verifier. Returning false keeps the provider-side grant
+* pending; the bridge never manufactures a client-side entitlement.
+*/
+export type AitIapProductGrantVerifier = (input: AitIapProductGrantVerificationInput) => Promise<boolean>;
+/**
+* Reads durable purchase entitlements from the game authority. Native product
+* callbacks are intentionally not treated as a source of ownership state.
+*/
+export type AitIapEntitlementReader = () => Promise<readonly Entitlement[]>;
 export interface AitPromotionRewardConfig {
   readonly promotionCode: string;
   readonly amount: number;
@@ -53,14 +114,27 @@ export type AitPromotionGrantAuthorization = {
 * single-use game claim.
 */
 export type AitPromotionGrantAuthorizer = (input: AitPromotionGrantAuthorizationInput) => Promise<AitPromotionGrantAuthorization>;
+export interface AitBannerAppearance {
+  readonly theme?: 'auto' | 'light' | 'dark';
+  readonly tone?: 'blackAndWhite' | 'grey';
+  readonly variant?: 'card' | 'expanded';
+}
 export interface InstallAitHostBridgeOptions {
   readonly appName?: string;
   readonly adGroupIds?: Readonly<Record<string, string>>;
-  readonly adPlacementTypes?: Readonly<Record<string, 'rewarded' | 'interstitial'>>;
+  readonly adPlacementTypes?: Readonly<Record<string, AitAdPlacementType>>;
   /** Logical campaign ids mapped to console-issued Apps in Toss promotion configuration. */
   readonly promotionRewards?: Readonly<Record<string, AitPromotionRewardConfig>>;
   readonly authorizePromotionGrant?: AitPromotionGrantAuthorizer;
   readonly resolvePendingPromotionGrant?: AitPendingPromotionGrantResolver;
+  /** Enable IAP only with logical-to-native SKU mappings and both server hooks. */
+  readonly iapProducts?: readonly AitIapProductConfig[];
+  readonly prepareIap?: AitIapPreparer;
+  readonly verifyIapProductGrant?: AitIapProductGrantVerifier;
+  /** Required to expose native IAP so ownership survives a wrapper restart. */
+  readonly readIapEntitlements?: AitIapEntitlementReader;
+  /** May be shortened, but never extended beyond the native callback-safe default. */
+  readonly iapProductGrantTimeoutMs?: number;
   /** Logical notification topics mapped to approved Apps in Toss template codes. */
   readonly notificationTemplateCodes?: Partial<Readonly<Record<NotificationTopic, string>>>;
   /** Maximum total wait for the native show request before display is observed. */
@@ -71,6 +145,10 @@ export interface InstallAitHostBridgeOptions {
   readonly adDisplayStartTimeoutMs?: number;
   /** Last-resort cleanup when the native SDK omits its terminal display callback. */
   readonly adMaximumDisplayMs?: number;
+  /** Maximum wait for an inline banner to render or report no-fill/failure. */
+  readonly bannerRenderTimeoutMs?: number;
+  /** Provider-neutral host preference mapped to the Apps in Toss banner appearance. */
+  readonly bannerAppearance?: AitBannerAppearance;
   readonly dependencies?: Partial<AitHostDependencies>;
 }
 export declare function installAitHostBridge(options?: InstallAitHostBridgeOptions): GamePlatformBridge;