@mpgd/adapter-ait 0.13.3 → 0.14.0

package/dist/iap-diagnostics.d.ts

@@ -0,0 +1,59 @@
+/**
+* Stable diagnostic codes for Apps in Toss in-app purchases.
+*
+* The host bridge attaches one of these codes to a non-completed
+* `PurchaseResult.diagnostic`, a partial `PurchaseRestoreResult.diagnostic`, or
+* a rejected `commerce.getProducts`/`commerce.restore` bridge call. Native SDK
+* error codes are passed through separately as `providerCode`. Codes never
+* carry order ids, player ids, tokens or other personal data.
+*
+* This module is SDK-free so game UI code can compare codes without importing
+* the Apps in Toss framework.
+*/
+export declare const aitIapDiagnosticCodes: {
+  /** IAP is not configured or the running Toss app lacks a required IAP method. */
+  readonly unavailable: 'AIT_IAP_UNAVAILABLE';
+  /** The requested logical product has no configured SKU mapping. */
+  readonly productNotConfigured: 'AIT_IAP_PRODUCT_NOT_CONFIGURED';
+  /** The native SDK returned no value, which it does on an unsupported Toss app version. */
+  readonly unsupportedAppVersion: 'AIT_IAP_UNSUPPORTED_APP_VERSION';
+  /** The native product catalog call failed or did not settle in time. */
+  readonly catalogUnavailable: 'AIT_IAP_CATALOG_UNAVAILABLE';
+  /** The native product catalog is empty. */
+  readonly catalogEmpty: 'AIT_IAP_CATALOG_EMPTY';
+  /** The native catalog has products, but none of the configured SKUs is usable. */
+  readonly configuredSkusNotVisible: 'AIT_IAP_CONFIGURED_SKUS_NOT_VISIBLE';
+  /** The configured SKU is not a one-time (consumable or non-consumable) product. */
+  readonly productTypeUnsupported: 'AIT_IAP_PRODUCT_TYPE_UNSUPPORTED';
+  /** The game-owned `prepareIap` hook rejected or did not settle in time. */
+  readonly preparationFailed: 'AIT_IAP_PREPARATION_FAILED';
+  /** Pending provider orders could not be read, so no new checkout was opened. */
+  readonly pendingOrderCheckFailed: 'AIT_IAP_PENDING_ORDER_CHECK_FAILED';
+  /** An earlier paid order for this product was just granted; no new checkout was opened. */
+  readonly pendingOrderRecovered: 'AIT_IAP_PENDING_ORDER_RECOVERED';
+  /** A paid order is still awaiting its server grant; no new checkout was opened. */
+  readonly pendingOrderUnresolved: 'AIT_IAP_PENDING_ORDER_UNRESOLVED';
+  /** The durable purchase-attempt marker could not be read or written. */
+  readonly attemptStorageUnavailable: 'AIT_IAP_ATTEMPT_STORAGE_UNAVAILABLE';
+  /** The same client purchase key already has an unfinished attempt. */
+  readonly attemptPending: 'AIT_IAP_ATTEMPT_PENDING';
+  /** Another purchase checkout or restore holds the IAP lock; nothing was charged. */
+  readonly checkoutInProgress: 'AIT_IAP_CHECKOUT_IN_PROGRESS';
+  /** The native checkout could not be opened. */
+  readonly checkoutStartFailed: 'AIT_IAP_CHECKOUT_START_FAILED';
+  /** The native checkout did not report a terminal result in time. */
+  readonly checkoutTimeout: 'AIT_IAP_CHECKOUT_TIMEOUT';
+  /** The native checkout reported an error before an order was observed. */
+  readonly nativePurchaseFailed: 'AIT_IAP_NATIVE_PURCHASE_FAILED';
+  /** A provider order exists but the game server has not confirmed its grant. */
+  readonly grantPending: 'AIT_IAP_GRANT_PENDING';
+  /** The server grant succeeded but the native acknowledgement failed or was not observed. */
+  readonly grantCompletionFailed: 'AIT_IAP_GRANT_COMPLETION_FAILED';
+  /** The game-owned entitlement reader failed or did not settle in time. */
+  readonly entitlementReadFailed: 'AIT_IAP_ENTITLEMENT_READ_FAILED';
+  /** Restore ran out of time before reconciling pending orders. */
+  readonly restoreTimeout: 'AIT_IAP_RESTORE_TIMEOUT';
+};
+export type AitIapDiagnosticCode = typeof aitIapDiagnosticCodes[keyof typeof aitIapDiagnosticCodes];
+/** Native error code the SDK reports after a checkout whose grant callback returned false. */
+export declare const aitIapProductNotGrantedByPartnerCode = "PRODUCT_NOT_GRANTED_BY_PARTNER";

package/dist/iap-diagnostics.js

@@ -0,0 +1,58 @@
+/**
+ * Stable diagnostic codes for Apps in Toss in-app purchases.
+ *
+ * The host bridge attaches one of these codes to a non-completed
+ * `PurchaseResult.diagnostic`, a partial `PurchaseRestoreResult.diagnostic`, or
+ * a rejected `commerce.getProducts`/`commerce.restore` bridge call. Native SDK
+ * error codes are passed through separately as `providerCode`. Codes never
+ * carry order ids, player ids, tokens or other personal data.
+ *
+ * This module is SDK-free so game UI code can compare codes without importing
+ * the Apps in Toss framework.
+ */
+export const aitIapDiagnosticCodes = {
+    /** IAP is not configured or the running Toss app lacks a required IAP method. */
+    unavailable: 'AIT_IAP_UNAVAILABLE',
+    /** The requested logical product has no configured SKU mapping. */
+    productNotConfigured: 'AIT_IAP_PRODUCT_NOT_CONFIGURED',
+    /** The native SDK returned no value, which it does on an unsupported Toss app version. */
+    unsupportedAppVersion: 'AIT_IAP_UNSUPPORTED_APP_VERSION',
+    /** The native product catalog call failed or did not settle in time. */
+    catalogUnavailable: 'AIT_IAP_CATALOG_UNAVAILABLE',
+    /** The native product catalog is empty. */
+    catalogEmpty: 'AIT_IAP_CATALOG_EMPTY',
+    /** The native catalog has products, but none of the configured SKUs is usable. */
+    configuredSkusNotVisible: 'AIT_IAP_CONFIGURED_SKUS_NOT_VISIBLE',
+    /** The configured SKU is not a one-time (consumable or non-consumable) product. */
+    productTypeUnsupported: 'AIT_IAP_PRODUCT_TYPE_UNSUPPORTED',
+    /** The game-owned `prepareIap` hook rejected or did not settle in time. */
+    preparationFailed: 'AIT_IAP_PREPARATION_FAILED',
+    /** Pending provider orders could not be read, so no new checkout was opened. */
+    pendingOrderCheckFailed: 'AIT_IAP_PENDING_ORDER_CHECK_FAILED',
+    /** An earlier paid order for this product was just granted; no new checkout was opened. */
+    pendingOrderRecovered: 'AIT_IAP_PENDING_ORDER_RECOVERED',
+    /** A paid order is still awaiting its server grant; no new checkout was opened. */
+    pendingOrderUnresolved: 'AIT_IAP_PENDING_ORDER_UNRESOLVED',
+    /** The durable purchase-attempt marker could not be read or written. */
+    attemptStorageUnavailable: 'AIT_IAP_ATTEMPT_STORAGE_UNAVAILABLE',
+    /** The same client purchase key already has an unfinished attempt. */
+    attemptPending: 'AIT_IAP_ATTEMPT_PENDING',
+    /** Another purchase checkout or restore holds the IAP lock; nothing was charged. */
+    checkoutInProgress: 'AIT_IAP_CHECKOUT_IN_PROGRESS',
+    /** The native checkout could not be opened. */
+    checkoutStartFailed: 'AIT_IAP_CHECKOUT_START_FAILED',
+    /** The native checkout did not report a terminal result in time. */
+    checkoutTimeout: 'AIT_IAP_CHECKOUT_TIMEOUT',
+    /** The native checkout reported an error before an order was observed. */
+    nativePurchaseFailed: 'AIT_IAP_NATIVE_PURCHASE_FAILED',
+    /** A provider order exists but the game server has not confirmed its grant. */
+    grantPending: 'AIT_IAP_GRANT_PENDING',
+    /** The server grant succeeded but the native acknowledgement failed or was not observed. */
+    grantCompletionFailed: 'AIT_IAP_GRANT_COMPLETION_FAILED',
+    /** The game-owned entitlement reader failed or did not settle in time. */
+    entitlementReadFailed: 'AIT_IAP_ENTITLEMENT_READ_FAILED',
+    /** Restore ran out of time before reconciling pending orders. */
+    restoreTimeout: 'AIT_IAP_RESTORE_TIMEOUT',
+};
+/** Native error code the SDK reports after a checkout whose grant callback returned false. */
+export const aitIapProductNotGrantedByPartnerCode = 'PRODUCT_NOT_GRANTED_BY_PARTNER';

package/dist/index.d.ts

@@ -23,5 +23,7 @@ export declare function createAitPlatformGateway(input: {
   readonly bridge?: GamePlatformBridge;
   readonly fallbackBridge?: GamePlatformBridge;
 }): PlatformGateway;
+export { aitIapDiagnosticCodes, aitIapProductNotGrantedByPartnerCode, type AitIapDiagnosticCode, } from './iap-diagnostics.js';
+export { aitBrowserOrigins, isAitBrowserOrigin } from './origins.js';
 export { aitLifecyclePauseEvent, aitLifecycleResumeEvent, createAitLifecycleAdapter, dispatchAitLifecycleEvent, } from './lifecycle.js';
 export declare function createAitSandboxBridge(options?: CreateAitSandboxBridgeOptions): GamePlatformBridge;

package/dist/index.js

@@ -121,6 +121,8 @@ export function createAitPlatformGateway(input) {
         },
     };
 }
+export { aitIapDiagnosticCodes, aitIapProductNotGrantedByPartnerCode, } from './iap-diagnostics.js';
+export { aitBrowserOrigins, isAitBrowserOrigin } from './origins.js';
 export { aitLifecyclePauseEvent, aitLifecycleResumeEvent, createAitLifecycleAdapter, dispatchAitLifecycleEvent, } from './lifecycle.js';
 function getBridge() {
     return globalThis.__GAME_PLATFORM_BRIDGE__;

package/dist/origins.d.ts

@@ -0,0 +1,10 @@
+/**
+* Browser origins an Apps in Toss mini-app can send requests from.
+*
+* Game backends use this list for an exact CORS allowlist. The `web` pair is
+* used by released and QR-test WebView bundles, and SDK 3.x bundles can also
+* send the `apps` pair. This module is SDK-free and safe to import on a server.
+*/
+export declare function aitBrowserOrigins(appName: string): readonly string[];
+/** Exact-match check of a request `Origin` header against `aitBrowserOrigins(appName)`. */
+export declare function isAitBrowserOrigin(appName: string, origin: string | null | undefined): boolean;

package/dist/origins.js

@@ -0,0 +1,31 @@
+/**
+ * Browser origins an Apps in Toss mini-app can send requests from.
+ *
+ * Game backends use this list for an exact CORS allowlist. The `web` pair is
+ * used by released and QR-test WebView bundles, and SDK 3.x bundles can also
+ * send the `apps` pair. This module is SDK-free and safe to import on a server.
+ */
+export function aitBrowserOrigins(appName) {
+    const host = normalizeAitOriginAppName(appName);
+    return Object.freeze([
+        `https://${host}.web.tossmini.com`,
+        `https://${host}.private-web.tossmini.com`,
+        `https://${host}.apps.tossmini.com`,
+        `https://${host}.private-apps.tossmini.com`,
+    ]);
+}
+/** Exact-match check of a request `Origin` header against `aitBrowserOrigins(appName)`. */
+export function isAitBrowserOrigin(appName, origin) {
+    return typeof origin === 'string' && aitBrowserOrigins(appName).includes(origin);
+}
+function normalizeAitOriginAppName(appName) {
+    if (typeof appName !== 'string') {
+        throw new TypeError('AIT appName must be a string.');
+    }
+    // Browsers send lower-case hosts in the Origin header.
+    const normalized = appName.trim().toLowerCase();
+    if (!/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/u.test(normalized)) {
+        throw new TypeError('AIT appName must be a DNS label: 1 to 63 letters, numbers or inner hyphens.');
+    }
+    return normalized;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/adapter-ait",
-  "version": "0.13.3",
+  "version": "0.14.0",
   "description": "Apps in Toss WebView platform adapter for mpgd games.",
   "license": "MIT",
   "repository": {
@@ -53,14 +53,18 @@
       "types": "./dist/authority-fetch.d.ts",
       "default": "./dist/authority-fetch.js"
     },
+    "./origins": {
+      "types": "./dist/origins.d.ts",
+      "default": "./dist/origins.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@mpgd/platform": "0.17.0",
-    "@mpgd/bridge": "0.11.0"
+    "@mpgd/bridge": "0.11.0",
+    "@mpgd/platform": "0.18.0"
   },
   "peerDependencies": {
     "@apps-in-toss/web-framework": ">=3.0.0 <4"
@@ -76,7 +80,7 @@
     "ttsc": "0.30.4",
     "typescript": "7.0.2",
     "vitest": "^4.0.0",
-    "@mpgd/game-runtime": "0.6.0"
+    "@mpgd/game-runtime": "0.6.1"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",