@mpgd/adapter-ait 0.10.0 → 0.12.0

package/dist/host.d.ts

@@ -4,6 +4,12 @@ import type { AitAdPlacementType } from './ad-config.js';
 import type { GamePlatformBridge } from './index.js';
 export type AitIdentityProvider = () => Promise<unknown>;
 /**
+* Shares one game identity hash read across a wrapper session.
+* Rejected reads are evicted so a resumed mobile host can retry after login or
+* WebView state has recovered.
+*/
+export declare function createAitSessionIdentityProvider(provider?: AitIdentityProvider): AitIdentityProvider;
+/**
 * 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.

package/dist/host.js

@@ -44,8 +44,31 @@ const launchEntries = new Set([
     'leaderboard',
     'friend-challenge',
 ]);
+const defaultAitIdentityProvider = () => getUserKeyForGame();
+/**
+ * Shares one game identity hash read across a wrapper session.
+ * Rejected reads are evicted so a resumed mobile host can retry after login or
+ * WebView state has recovered.
+ */
+export function createAitSessionIdentityProvider(provider = defaultAitIdentityProvider) {
+    let pending;
+    return () => {
+        const current = pending;
+        if (current !== undefined) {
+            return current;
+        }
+        const attempt = Promise.resolve().then(provider);
+        void (pending = attempt);
+        void attempt.catch(() => {
+            if (pending === attempt) {
+                pending = undefined;
+            }
+        });
+        return attempt;
+    };
+}
 const defaultDependencies = {
-    identityProvider: getUserKeyForGame,
+    identityProvider: defaultAitIdentityProvider,
     storage: Storage,
     getTossShareLink,
     share,
@@ -65,7 +88,11 @@ export function installAitHostBridge(options = {}) {
     return bridge;
 }
 export function createAitHostBridge(options = {}) {
-    const dependencies = { ...defaultDependencies, ...options.dependencies };
+    const configuredDependencies = { ...defaultDependencies, ...options.dependencies };
+    const dependencies = {
+        ...configuredDependencies,
+        identityProvider: createAitSessionIdentityProvider(configuredDependencies.identityProvider),
+    };
     const appName = normalizeAppName(options.appName ?? 'mpgd-kit');
     const adGroupIds = normalizeAdGroupIds(options.adGroupIds);
     const adPlacementTypes = normalizeAdPlacementTypes(options.adPlacementTypes);

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { type BridgeRequest, type BridgeResponse } from '@mpgd/bridge';
-import type { PlatformGateway } from '@mpgd/platform';
+import { type PlatformGateway } from '@mpgd/platform';
 export interface GamePlatformBridge {
   request(input: BridgeRequest): Promise<BridgeResponse>;
 }

package/dist/index.js

@@ -1,10 +1,15 @@
 import { bridgeStorageLoadProtocol, decodeBridgeStorageLoadData, } from '@mpgd/bridge';
+import { PlatformOperationError, } from '@mpgd/platform';
 import { createAitLifecycleAdapter } from './lifecycle.js';
 export function createAitPlatformGateway(input) {
     async function request(method, payload) {
         const bridge = input.bridge ?? getBridge() ?? input.fallbackBridge;
         if (bridge === undefined) {
-            throw new Error('AIT bridge is not installed.');
+            throw new PlatformOperationError({
+                code: 'AIT_BRIDGE_NOT_INSTALLED',
+                message: 'AIT bridge is not installed.',
+                retryable: false,
+            });
         }
         const response = await bridge.request({
             id: crypto.randomUUID(),
@@ -18,7 +23,7 @@ export function createAitPlatformGateway(input) {
             },
         });
         if (!response.ok) {
-            throw new Error(response.error.message);
+            throw new PlatformOperationError(response.error);
         }
         return response.data;
     }

package/dist/local-mock.d.ts

@@ -6,11 +6,28 @@
 * commerce: those paths must be verified in the Toss app sandbox/console.
 */
 declare function unsupported(): boolean;
+/**
+* Local browsers have no native safe-area constant. Throwing preserves the
+* wrapper's CSS `env(safe-area-inset-*)` fallback while keeping ESM exports in
+* parity with the SDK surface consumed by the adapter.
+*/
+export declare const SafeArea: {
+  get(): never;
+  subscribe(_input: {
+    readonly onEvent: (insets: unknown) => void;
+  }): () => void;
+};
 export declare const Storage: {
   getItem(key: string): Promise<string | null>;
   setItem(key: string, value: string): Promise<void>;
   removeItem(key: string): Promise<void>;
 };
+export declare const User: {
+  getAnonymousKey(): Promise<{
+    readonly type: 'HASH';
+    readonly hash: string;
+  }>;
+};
 export declare function getUserKeyForGame(): Promise<{
   readonly type: 'HASH';
   readonly hash: string;

package/dist/local-mock.js

@@ -12,6 +12,19 @@ function unsupported() {
 function noOpSubscription() {
     return () => { };
 }
+/**
+ * Local browsers have no native safe-area constant. Throwing preserves the
+ * wrapper's CSS `env(safe-area-inset-*)` fallback while keeping ESM exports in
+ * parity with the SDK surface consumed by the adapter.
+ */
+export const SafeArea = {
+    get() {
+        throw new Error('SafeArea is unavailable in the Apps in Toss local mock.');
+    },
+    subscribe(_input) {
+        return noOpSubscription();
+    },
+};
 export const Storage = {
     async getItem(key) {
         return localStorageValues.get(key) ?? null;
@@ -23,8 +36,13 @@ export const Storage = {
         localStorageValues.delete(key);
     },
 };
+export const User = {
+    async getAnonymousKey() {
+        return { type: 'HASH', hash: 'ait-local-player' };
+    },
+};
 export async function getUserKeyForGame() {
-    return { type: 'HASH', hash: 'ait-local-player' };
+    return User.getAnonymousKey();
 }
 export async function getTossShareLink() {
     return globalThis.location?.href ?? 'https://localhost/';

package/dist/safe-area.d.ts

@@ -0,0 +1,54 @@
+/** Raw Apps in Toss safe-area values expressed in CSS pixels. */
+export interface AitSafeAreaInsets {
+  readonly top: number;
+  readonly right: number;
+  readonly bottom: number;
+  readonly left: number;
+}
+/** Minimal SDK surface kept injectable for deterministic wrapper tests. */
+export interface AitSafeAreaSource {
+  get(): unknown;
+  subscribe(input: {
+    readonly onEvent: (insets: unknown) => void;
+  }): () => void;
+}
+/** Minimal CSS declaration surface required by the bridge. */
+export interface AitSafeAreaCssStyle {
+  getPropertyValue(property: string): string;
+  getPropertyPriority?(property: string): string;
+  setProperty(property: string, value: string, priority?: string): void;
+  removeProperty(property: string): string;
+}
+export interface InstallAitSafeAreaCssVariablesOptions {
+  readonly source?: AitSafeAreaSource;
+  readonly style?: AitSafeAreaCssStyle;
+  /** Override only when a host version or custom navigation treatment has a measured band. */
+  readonly navigationControlBandHeightPx?: number;
+  /** Override only when native navigation uses a measured right-edge gap. */
+  readonly navigationControlEdgeGapPx?: number;
+}
+/**
+* Apps in Toss positions the game navigation controls immediately below the
+* native top safe area. Keep full-width app chrome below this additional band.
+*/
+export declare const aitNavigationControlBandHeightPx = 52;
+/** Apps in Toss navigation controls retain this edge gap from the safe right inset. */
+export declare const aitNavigationControlEdgeGapPx = 10;
+/** CSS contract shared by generated AIT wrappers and full-bleed games. */
+export declare const aitSafeAreaCssVariables: Readonly<{
+  readonly top: '--mpgd-safe-area-top';
+  readonly right: '--mpgd-safe-area-right';
+  readonly bottom: '--mpgd-safe-area-bottom';
+  readonly left: '--mpgd-safe-area-left';
+  readonly navigationControlTop: '--mpgd-ait-navigation-control-top';
+  readonly navigationControlRight: '--mpgd-ait-navigation-control-right';
+  readonly navigationContentTop: '--mpgd-ait-navigation-content-top';
+}>;
+/**
+* Mirror the official AIT `SafeArea` snapshot into CSS custom properties and
+* keep them current when the WebView changes presentation or orientation.
+*
+* CSS `env(safe-area-inset-*)` remains the wrapper's pre-SDK fallback. Invalid
+* or unavailable native values never overwrite that fallback.
+*/
+export declare function installAitSafeAreaCssVariables(options?: InstallAitSafeAreaCssVariablesOptions): () => void;

package/dist/safe-area.js

@@ -0,0 +1,132 @@
+import { SafeArea } from '@apps-in-toss/web-framework';
+/**
+ * Apps in Toss positions the game navigation controls immediately below the
+ * native top safe area. Keep full-width app chrome below this additional band.
+ */
+export const aitNavigationControlBandHeightPx = 52;
+/** Apps in Toss navigation controls retain this edge gap from the safe right inset. */
+export const aitNavigationControlEdgeGapPx = 10;
+/** CSS contract shared by generated AIT wrappers and full-bleed games. */
+export const aitSafeAreaCssVariables = Object.freeze({
+    top: '--mpgd-safe-area-top',
+    right: '--mpgd-safe-area-right',
+    bottom: '--mpgd-safe-area-bottom',
+    left: '--mpgd-safe-area-left',
+    navigationControlTop: '--mpgd-ait-navigation-control-top',
+    navigationControlRight: '--mpgd-ait-navigation-control-right',
+    navigationContentTop: '--mpgd-ait-navigation-content-top',
+});
+const maximumSafeAreaInsetPx = 4096;
+const maximumCssPixelOptionPx = 4096;
+/**
+ * Mirror the official AIT `SafeArea` snapshot into CSS custom properties and
+ * keep them current when the WebView changes presentation or orientation.
+ *
+ * CSS `env(safe-area-inset-*)` remains the wrapper's pre-SDK fallback. Invalid
+ * or unavailable native values never overwrite that fallback.
+ */
+export function installAitSafeAreaCssVariables(options = {}) {
+    const navigationControlBandHeightPx = normalizeCssPixelOption(options.navigationControlBandHeightPx, aitNavigationControlBandHeightPx, 'navigationControlBandHeightPx');
+    const navigationControlEdgeGapPx = normalizeCssPixelOption(options.navigationControlEdgeGapPx, aitNavigationControlEdgeGapPx, 'navigationControlEdgeGapPx');
+    const style = options.style ?? resolveDocumentRootStyle();
+    if (style === undefined) {
+        return () => { };
+    }
+    const source = options.source ?? SafeArea;
+    const previous = rememberCssVariables(style);
+    let active = true;
+    let unsubscribe = () => { };
+    const apply = (input) => {
+        if (!active) {
+            return;
+        }
+        const insets = normalizeAitSafeAreaInsets(input);
+        if (insets === null) {
+            return;
+        }
+        style.setProperty(aitSafeAreaCssVariables.top, formatCssPixels(insets.top));
+        style.setProperty(aitSafeAreaCssVariables.right, formatCssPixels(insets.right));
+        style.setProperty(aitSafeAreaCssVariables.bottom, formatCssPixels(insets.bottom));
+        style.setProperty(aitSafeAreaCssVariables.left, formatCssPixels(insets.left));
+        style.setProperty(aitSafeAreaCssVariables.navigationControlTop, formatCssPixels(insets.top));
+        style.setProperty(aitSafeAreaCssVariables.navigationControlRight, formatCssPixels(insets.right + navigationControlEdgeGapPx));
+        style.setProperty(aitSafeAreaCssVariables.navigationContentTop, formatCssPixels(insets.top + navigationControlBandHeightPx));
+    };
+    try {
+        apply(source.get());
+    }
+    catch {
+        // Local browsers and older Toss hosts keep the CSS env() fallback.
+    }
+    try {
+        const subscribed = source.subscribe({ onEvent: apply });
+        unsubscribe = typeof subscribed === 'function' ? subscribed : () => { };
+    }
+    catch {
+        // A missing native event bridge must not prevent the game from booting.
+    }
+    return () => {
+        if (!active) {
+            return;
+        }
+        active = false;
+        try {
+            unsubscribe();
+        }
+        finally {
+            restoreCssVariables(style, previous);
+        }
+    };
+}
+function normalizeAitSafeAreaInsets(input) {
+    if (typeof input !== 'object' || input === null) {
+        return null;
+    }
+    const record = input;
+    const top = normalizeInset(record.top);
+    const right = normalizeInset(record.right);
+    const bottom = normalizeInset(record.bottom);
+    const left = normalizeInset(record.left);
+    if (top === null || right === null || bottom === null || left === null) {
+        return null;
+    }
+    return { top, right, bottom, left };
+}
+function normalizeInset(input) {
+    return typeof input === 'number'
+        && Number.isFinite(input)
+        && input >= 0
+        && input <= maximumSafeAreaInsetPx
+        ? input
+        : null;
+}
+function normalizeCssPixelOption(input, fallback, name) {
+    const value = input ?? fallback;
+    if (!Number.isFinite(value) || value < 0 || value > maximumCssPixelOptionPx) {
+        throw new TypeError(`${name} must be a non-negative finite CSS pixel value.`);
+    }
+    return value;
+}
+function formatCssPixels(value) {
+    return `${Object.is(value, -0) ? 0 : value}px`;
+}
+function resolveDocumentRootStyle() {
+    return typeof document === 'undefined' ? undefined : document.documentElement.style;
+}
+function rememberCssVariables(style) {
+    return Object.values(aitSafeAreaCssVariables).map((property) => ({
+        property,
+        value: style.getPropertyValue(property),
+        priority: style.getPropertyPriority?.(property) ?? '',
+    }));
+}
+function restoreCssVariables(style, previous) {
+    for (const entry of previous) {
+        if (entry.value.length === 0) {
+            style.removeProperty(entry.property);
+        }
+        else {
+            style.setProperty(entry.property, entry.value, entry.priority);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/adapter-ait",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Apps in Toss WebView platform adapter for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -45,6 +45,10 @@
       "types": "./dist/local-mock.d.ts",
       "default": "./dist/local-mock.js"
     },
+    "./safe-area": {
+      "types": "./dist/safe-area.d.ts",
+      "default": "./dist/safe-area.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -52,7 +56,7 @@
   ],
   "dependencies": {
     "@mpgd/bridge": "0.9.0",
-    "@mpgd/platform": "0.10.0"
+    "@mpgd/platform": "0.11.0"
   },
   "peerDependencies": {
     "@apps-in-toss/web-framework": ">=3.0.0 <4"