@mpgd/adapter-ait 0.7.0 → 0.9.0

package/dist/host.d.ts

@@ -1,22 +1,131 @@
-import { getTossShareLink, isMinVersionSupported, loadFullScreenAd, openGameCenterLeaderboard, share, showFullScreenAd, Storage, submitGameCenterLeaderBoardScore } from '@apps-in-toss/web-framework';
-import type { ShareResult } from '@mpgd/platform';
+import { getTossShareLink, grantPromotionRewardForGame as grantPromotionReward, IAP, isMinVersionSupported, loadFullScreenAd, openGameCenterLeaderboard, requestNotificationAgreement, share, showFullScreenAd, Storage, submitGameCenterLeaderBoardScore } from '@apps-in-toss/web-framework';
+import type { Entitlement, LogicalProductId, NotificationTopic, ShareResult } from '@mpgd/platform';
 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>;
+}
 export interface AitHostDependencies {
   readonly identityProvider: AitIdentityProvider;
-  readonly storage: Pick<typeof Storage, 'getItem' | 'setItem'>;
+  readonly storage: Pick<typeof Storage, 'getItem' | 'removeItem' | 'setItem'>;
   readonly getTossShareLink: typeof getTossShareLink;
   readonly share: typeof share;
+  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 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;
+}
+export interface AitPendingPromotionGrantInput {
+  readonly campaignId: string;
+  readonly idempotencyKey: string;
+  /** Missing for legacy or malformed pending markers; resolvers must fail closed. */
+  readonly pendingSince?: string;
+}
+export type AitPendingPromotionGrantResolution = {
+  readonly status: 'granted';
+  readonly receiptKey: string;
+} | {
+  readonly status: 'retry' | 'pending';
+};
+/**
+* Server-backed reconciliation hook for an ambiguous native promotion call.
+* Returning `retry` must only happen after the game authority decides that a
+* second provider call is safe for this single-use claim id.
+*/
+export type AitPendingPromotionGrantResolver = (input: AitPendingPromotionGrantInput) => Promise<AitPendingPromotionGrantResolution>;
+export interface AitPromotionGrantAuthorizationInput {
+  readonly campaignId: string;
+  /** Single-use claim id issued by the game backend. */
+  readonly idempotencyKey: string;
 }
+export type AitPromotionGrantAuthorization = {
+  readonly status: 'authorized';
+} | {
+  readonly status: 'pending' | 'rejected';
+};
+/**
+* Server-backed gate for the first provider call. A configured campaign is not
+* available until this hook confirms that the idempotency key is a genuine,
+* single-use game claim.
+*/
+export type AitPromotionGrantAuthorizer = (input: AitPromotionGrantAuthorizationInput) => Promise<AitPromotionGrantAuthorization>;
 export interface InstallAitHostBridgeOptions {
   readonly appName?: string;
   readonly adGroupIds?: Readonly<Record<string, string>>;
   readonly adPlacementTypes?: Readonly<Record<string, 'rewarded' | 'interstitial'>>;
+  /** 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. */
   readonly adTimeoutMs?: number;
   /** Maximum wait to acquire the process-wide native full-screen load slot. */