@ait-kit/sdk 0.3.0 → 0.5.0

package/dist/iap/adapter.js

@@ -1,6 +1,8 @@
 import { SdkError } from "../index.js";
 import { IapGrantCoordinator } from "./grant-coordinator.js";
 import {} from "./platform-contract.js";
+import { queryOrderHistory } from "./order-history.js";
+import { querySubscriptionInfo } from "./subscription-info.js";
 import { runPurchaseFlow } from "./purchase-flow.js";
 const DEFAULT_PURCHASE_TIMEOUT_MS = 180_000;
 /**
@@ -34,6 +36,17 @@ export function createIapAdapter(options) {
         return fn;
     };
     return {
+        async getCompletedOrRefundedOrders(params) {
+            return queryOrderHistory(load, options.orderHistoryPagination, params);
+        },
+        async getSubscriptionInfo(orderId) {
+            if (typeof orderId !== "string" || !orderId.trim()) {
+                throw new SdkError("INVALID_IAP_INPUT", "orderId must be a non-empty string");
+            }
+            const platform = await load();
+            ensureOperation(platform.getSubscriptionInfo, "getSubscriptionInfo");
+            return querySubscriptionInfo(platform, orderId);
+        },
         async getProductItemList() {
             const platform = await load();
             ensureOperation(platform.getProductItemList, "getProductItemList");

package/dist/iap/order-history.d.ts

@@ -0,0 +1,6 @@
+import { type IapOrderHistoryPage } from "../index.js";
+import { type PartialIapPlatformSdk } from "./platform-contract.js";
+export declare function queryOrderHistory(load: () => Promise<PartialIapPlatformSdk>, pagination: IapOrderHistoryPage["pagination"], params?: {
+    key?: string | null;
+}): Promise<IapOrderHistoryPage>;
+//# sourceMappingURL=order-history.d.ts.map

package/dist/iap/order-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-history.d.ts","sourceRoot":"","sources":["../../src/iap/order-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,mBAAmB,EAAoC,MAAM,aAAa,CAAC;AACnG,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAC1C,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAC7C,MAAM,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAyC9B"}

package/dist/iap/order-history.js

@@ -0,0 +1,54 @@
+import { SdkError } from "../index.js";
+import { toIapErrorCode } from "./platform-contract.js";
+export async function queryOrderHistory(load, pagination, params) {
+    if (params !== undefined && (!isRecord(params) || Array.isArray(params))) {
+        throw new SdkError("INVALID_IAP_INPUT", "history params must be an object with an optional key");
+    }
+    const key = params?.key;
+    if (key !== undefined && key !== null && (typeof key !== "string" || !key.trim())) {
+        throw new SdkError("INVALID_IAP_INPUT", "history key must be a non-empty string or null");
+    }
+    if (pagination === "first_page_only" && key !== undefined && key !== null) {
+        throw new SdkError("UNSUPPORTED", "the WebView SDK only supports the first order history page");
+    }
+    const platform = await load();
+    const query = platform.getCompletedOrRefundedOrders;
+    if (typeof query !== "function" || (typeof query.isSupported === "function" && !query.isSupported())) {
+        throw new SdkError("UNSUPPORTED", "order history is not supported on this app version");
+    }
+    let result;
+    try {
+        // WebView's official function takes no arguments; never send a fabricated cursor.
+        result = pagination === "cursor" && key !== undefined
+            ? await query.call(platform, { key })
+            : await query.call(platform);
+    }
+    catch (error) {
+        if (toIapErrorCode(error) === "UNSUPPORTED_APP_VERSION") {
+            throw new SdkError("UNSUPPORTED", "order history is not supported on this app version", { cause: error });
+        }
+        throw error;
+    }
+    if (result === undefined)
+        throw new SdkError("UNSUPPORTED", "order history is not supported on this app version");
+    if (!isRecord(result) || typeof result.hasNext !== "boolean" || !Array.isArray(result.orders) ||
+        (result.nextKey !== undefined && result.nextKey !== null &&
+            (typeof result.nextKey !== "string" || !result.nextKey.trim())) ||
+        !result.orders.every(isOrder)) {
+        throw new SdkError("INVALID_IAP_RESULT", "the provider returned malformed order history");
+    }
+    return {
+        orders: result.orders.map(order => ({ orderId: order.orderId, sku: order.sku, status: order.status, date: order.date })),
+        hasNext: result.hasNext,
+        ...(result.nextKey !== undefined ? { nextKey: result.nextKey } : {}),
+        pagination
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isOrder(value) {
+    return isRecord(value) && typeof value.orderId === "string" && !!value.orderId.trim() &&
+        typeof value.sku === "string" && !!value.sku.trim() && typeof value.date === "string" && !!value.date.trim() &&
+        (value.status === "COMPLETED" || value.status === "REFUNDED");
+}

package/dist/iap/platform-contract.d.ts

@@ -1,5 +1,5 @@
 /**
- * Internal platform contract shared by the /rn and /web IAP adapters.
+ * Internal platform contract shared by the /rn and /webview IAP adapters.
  * Each entry point declares its own structural copy of the official SDK
  * surface (they are different npm packages with identical Domains API
  * shapes); this module is the common, platform-neutral engine boundary and
@@ -20,6 +20,14 @@ type WithSupport<F> = F & {
     isSupported?: () => boolean;
 };
 export interface IapPlatformSdk {
+    getCompletedOrRefundedOrders: WithSupport<(params?: {
+        key?: string | null;
+    }) => Promise<unknown>>;
+    getSubscriptionInfo: WithSupport<(args: {
+        params: {
+            orderId: string;
+        };
+    }) => Promise<unknown>>;
     getProductItemList: WithSupport<() => Promise<{
         products: IapProduct[];
     }>>;

package/dist/iap/platform-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-contract.d.ts","sourceRoot":"","sources":["../../src/iap/platform-contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,6BAA6B,EAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,2EAA2E;AAC3E,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,WAAW,CAAC,MAAM,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3E,0BAA0B,EAAE,WAAW,CAAC,CAAC,MAAM,EAAE,wBAAwB,KAAK,MAAM,IAAI,CAAC,CAAC;IAC1F,+BAA+B,EAAE,WAAW,CAC1C,CAAC,MAAM,EAAE,6BAA6B,KAAK,MAAM,IAAI,CACtD,CAAC;IACF,gBAAgB,EAAE,WAAW,CAAC,MAAM,OAAO,CAAC;QAAE,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5E,oBAAoB,EAAE,WAAW,CAC/B,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAC5D,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;KACjC,CAAC,IAAI,MAAM,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAC3C;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAC1F,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASxD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjE"}
+{"version":3,"file":"platform-contract.d.ts","sourceRoot":"","sources":["../../src/iap/platform-contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,6BAA6B,EAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,2EAA2E;AAC3E,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,4BAA4B,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,mBAAmB,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,kBAAkB,EAAE,WAAW,CAAC,MAAM,OAAO,CAAC;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3E,0BAA0B,EAAE,WAAW,CAAC,CAAC,MAAM,EAAE,wBAAwB,KAAK,MAAM,IAAI,CAAC,CAAC;IAC1F,+BAA+B,EAAE,WAAW,CAC1C,CAAC,MAAM,EAAE,6BAA6B,KAAK,MAAM,IAAI,CACtD,CAAC;IACF,gBAAgB,EAAE,WAAW,CAAC,MAAM,OAAO,CAAC;QAAE,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5E,oBAAoB,EAAE,WAAW,CAC/B,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAC5D,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;KACjC,CAAC,IAAI,MAAM,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAC3C;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAC1F,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASxD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjE"}

package/dist/iap/platform-contract.js

@@ -1,5 +1,5 @@
 /**
- * Internal platform contract shared by the /rn and /web IAP adapters.
+ * Internal platform contract shared by the /rn and /webview IAP adapters.
  * Each entry point declares its own structural copy of the official SDK
  * surface (they are different npm packages with identical Domains API
  * shapes); this module is the common, platform-neutral engine boundary and

package/dist/iap/purchase-flow.d.ts

@@ -11,7 +11,7 @@ export interface PurchaseFlowOptions {
     timeoutMs: number;
 }
 /**
- * Shared purchase flow for the /rn and /web IAP adapters, built on the
+ * Shared purchase flow for the /rn and /webview IAP adapters, built on the
  * common event-flow base:
  *
  * - The platform's `processProductGrant` slot wraps the consumer-injected

package/dist/iap/purchase-flow.js

@@ -2,7 +2,7 @@ import { runEventFlow } from "../event-flow.js";
 import {} from "./grant-coordinator.js";
 import { toIapErrorCode, toIapErrorMessage } from "./platform-contract.js";
 /**
- * Shared purchase flow for the /rn and /web IAP adapters, built on the
+ * Shared purchase flow for the /rn and /webview IAP adapters, built on the
  * common event-flow base:
  *
  * - The platform's `processProductGrant` slot wraps the consumer-injected

package/dist/iap/subscription-info.d.ts

@@ -0,0 +1,6 @@
+import { type IapSubscriptionInfo } from "../index.js";
+import { type PartialIapPlatformSdk } from "./platform-contract.js";
+export declare function querySubscriptionInfo(platform: PartialIapPlatformSdk, orderId: string): Promise<{
+    subscription: IapSubscriptionInfo;
+}>;
+//# sourceMappingURL=subscription-info.d.ts.map

package/dist/iap/subscription-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-info.d.ts","sourceRoot":"","sources":["../../src/iap/subscription-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA2B5I"}

package/dist/iap/subscription-info.js

@@ -0,0 +1,38 @@
+import { SdkError } from "../index.js";
+import { toIapErrorCode } from "./platform-contract.js";
+export async function querySubscriptionInfo(platform, orderId) {
+    let result;
+    try {
+        result = await platform.getSubscriptionInfo({ params: { orderId } });
+    }
+    catch (error) {
+        if (toIapErrorCode(error) === "UNSUPPORTED_APP_VERSION") {
+            throw new SdkError("UNSUPPORTED", "subscription queries are not supported on this app version", { cause: error });
+        }
+        throw error;
+    }
+    // The RN SDK returns undefined on unsupported host versions.
+    if (result === undefined)
+        throw new SdkError("UNSUPPORTED", "subscription queries are not supported on this app version");
+    const info = isRecord(result) ? result.subscription : undefined;
+    if (!isRecord(info) || typeof info.catalogId !== "number" || !Number.isFinite(info.catalogId) ||
+        typeof info.status !== "string" || !info.status.trim() ||
+        !nullableString(info.expiresAt) || !nullableString(info.gracePeriodExpiresAt) ||
+        typeof info.isAutoRenew !== "boolean" || typeof info.isAccessible !== "boolean") {
+        throw new SdkError("INVALID_IAP_RESULT", "the provider returned malformed subscription information");
+    }
+    return { subscription: {
+            catalogId: info.catalogId,
+            status: info.status,
+            expiresAt: info.expiresAt,
+            isAutoRenew: info.isAutoRenew,
+            gracePeriodExpiresAt: info.gracePeriodExpiresAt,
+            isAccessible: info.isAccessible
+        } };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function nullableString(value) {
+    return value === null || typeof value === "string";
+}

package/dist/identity/platform-contract.d.ts

@@ -1,7 +1,7 @@
 import { type SdkAnonymousKey, type SdkLoginResult } from "../index.js";
 /**
  * Internal platform contract for the login/anonymous-identity adapters,
- * shared by /rn and /web. Each entry declares its own structural copy of
+ * shared by /rn and /webview. Each entry declares its own structural copy of
  * the official SDK surface; this module is the common engine boundary and
  * is never exported from a public subpath.
  */

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * The root entry is runtime-neutral: common types and errors only, with no
  * imports of any official runtime SDK. Runtime adapters live in subpaths —
- * `@ait-kit/sdk/rn` for React Native (ads today; more domains later).
+ * `@ait-kit/sdk/rn` for React Native and `@ait-kit/sdk/webview` for WebView.
  */
 /** Reward payload reported by rewarded ad flows. */
 export interface AdReward {
@@ -28,7 +28,7 @@ export type AdShowResult = {
     reason?: string;
 };
 /** Stable error codes for SDK adapter failures. */
-export type SdkErrorCode = "SDK_UNAVAILABLE" | "UNSUPPORTED" | "AD_NOT_LOADED" | "AD_ALREADY_SHOWING" | "AD_LOAD_FAILED" | "AD_LOAD_TIMEOUT" | "INVALID_LOGIN_RESULT" | "INVALID_ANONYMOUS_KEY" | "INVALID_SHARE_PATH";
+export type SdkErrorCode = "SDK_UNAVAILABLE" | "UNSUPPORTED" | "AD_NOT_LOADED" | "AD_ALREADY_SHOWING" | "AD_LOAD_FAILED" | "AD_LOAD_TIMEOUT" | "INVALID_BANNER_INPUT" | "BANNER_INIT_TIMEOUT" | "BANNER_TARGET_IN_USE" | "BANNER_ATTACH_FAILED" | "INVALID_IAP_INPUT" | "INVALID_IAP_RESULT" | "INVALID_LOGIN_RESULT" | "INVALID_ANONYMOUS_KEY" | "INVALID_PROMOTION_INPUT" | "PROMOTION_IN_PROGRESS" | "INVALID_SHARE_PATH";
 /** Terminal agreement outcomes delivered by the platform event. */
 export type SdkNotificationAgreementType = "newAgreement" | "alreadyAgreed" | "agreementRejected";
 /**
@@ -95,7 +95,7 @@ export interface SdkAnonymousKey {
     type: "HASH";
     hash: string;
 }
-/** Minimal storage contract shared by the /rn and /web adapters. */
+/** Minimal storage contract shared by the /rn and /webview adapters. */
 export interface SdkStorage {
     /** Resolves the stored string, or null when the key has no value. */
     get(key: string): Promise<string | null>;
@@ -214,4 +214,31 @@ export declare class SdkError extends Error {
         cause?: unknown;
     });
 }
+export type { ReviewAdapter } from "./review/platform-contract.js";
+export type { PromotionAdapter, PromotionSupport, PromotionGrantInput, PromotionGrantResult } from "./promotion/platform-contract.js";
+/** Provider subscription state; unknown future states are preserved without inference. */
+export type IapSubscriptionStatus = "ACTIVE" | "EXPIRED" | "IN_GRACE_PERIOD" | "ON_HOLD" | "PAUSED" | "REVOKED" | (string & {});
+/** Provider snapshot only; server verification remains the source of entitlement decisions. */
+export interface IapSubscriptionInfo {
+    catalogId: number;
+    status: IapSubscriptionStatus;
+    expiresAt: string | null;
+    isAutoRenew: boolean;
+    gracePeriodExpiresAt: string | null;
+    isAccessible: boolean;
+}
+/** One completed purchase or refund reported by the provider. */
+export interface IapCompletedOrRefundedOrder {
+    orderId: string;
+    sku: string;
+    status: "COMPLETED" | "REFUNDED";
+    date: string;
+}
+export interface IapOrderHistoryPage {
+    orders: IapCompletedOrRefundedOrder[];
+    hasNext: boolean;
+    nextKey?: string | null;
+    /** WebView currently exposes only the first page, even when hasNext is true. */
+    pagination: "cursor" | "first_page_only";
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,7 +3,7 @@
  *
  * The root entry is runtime-neutral: common types and errors only, with no
  * imports of any official runtime SDK. Runtime adapters live in subpaths —
- * `@ait-kit/sdk/rn` for React Native (ads today; more domains later).
+ * `@ait-kit/sdk/rn` for React Native and `@ait-kit/sdk/webview` for WebView.
  */
 /** Typed error surfaced by the SDK adapters. */
 export class SdkError extends Error {

package/dist/notification/platform-contract.d.ts

@@ -1,7 +1,7 @@
 import type { SdkNotificationAgreementResult } from "../index.js";
 /**
  * Internal platform contract for the notification-agreement adapter,
- * shared by /rn and /web (never exported from a public subpath).
+ * shared by /rn and /webview (never exported from a public subpath).
  */
 export interface NotificationAgreementParams {
     options: {

package/dist/platform-loader.d.ts

@@ -0,0 +1,16 @@
+/** Internal runtime-neutral loader primitives; no official SDK is imported here. */
+export type PlatformLoadResult<T> = {
+    available: true;
+    module: T;
+} | {
+    available: false;
+    reason: string;
+};
+export type PlatformLoader<T> = () => Promise<PlatformLoadResult<T>>;
+/** Preserve injected loaders verbatim and construct defaults only when needed. */
+export declare function resolvePlatformLoader<T>(framework: T | PlatformLoader<T> | undefined, createDefault: () => PlatformLoader<T>): PlatformLoader<T>;
+/** Cache only successful selections; unavailable results and thrown loads retry. */
+export declare function createCachedPlatformLoader<T>(load: PlatformLoader<T>, errorReason: (error: unknown) => string): PlatformLoader<T>;
+/** Preserve existing diagnostic detail policies chosen by each adapter. */
+export declare function frameworkImportError(packageName: string, error: unknown, includeDetails: boolean): string;
+//# sourceMappingURL=platform-loader.d.ts.map

package/dist/platform-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-loader.d.ts","sourceRoot":"","sources":["../src/platform-loader.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC5B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACzC,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,SAAS,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,EAC5C,aAAa,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,GACrC,cAAc,CAAC,CAAC,CAAC,CAInB;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GACtC,cAAc,CAAC,CAAC,CAAC,CAcnB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAKzG"}

package/dist/platform-loader.js

@@ -0,0 +1,35 @@
+/** Preserve injected loaders verbatim and construct defaults only when needed. */
+export function resolvePlatformLoader(framework, createDefault) {
+    if (!framework)
+        return createDefault();
+    if (typeof framework === "function")
+        return framework;
+    return async () => ({ available: true, module: framework });
+}
+/** Cache only successful selections; unavailable results and thrown loads retry. */
+export function createCachedPlatformLoader(load, errorReason) {
+    let cached;
+    return async () => {
+        if (cached)
+            return { available: true, module: cached.module };
+        try {
+            const result = await load();
+            // Keep the cache independent from the mutable result envelope returned
+            // to callers, as the original per-adapter loaders did.
+            if (result.available)
+                cached = { available: true, module: result.module };
+            return result;
+        }
+        catch (error) {
+            return { available: false, reason: errorReason(error) };
+        }
+    };
+}
+/** Preserve existing diagnostic detail policies chosen by each adapter. */
+export function frameworkImportError(packageName, error, includeDetails) {
+    const prefix = `failed to import ${packageName}`;
+    if (!includeDetails)
+        return prefix;
+    const message = error instanceof Error ? error.message : String(error);
+    return `${prefix}: ${message}`;
+}

package/dist/promotion/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { PromotionAdapter, PromotionPlatformLoader } from "./platform-contract.js";
+export declare function createPromotionAdapter(loader: PromotionPlatformLoader, timeoutMs?: number): PromotionAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/promotion/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/promotion/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAiDhC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,SAAI,GAAG,gBAAgB,CA+DvG"}

package/dist/promotion/adapter.js

@@ -0,0 +1,128 @@
+import { SdkError } from "../index.js";
+// Official Promotion.grantReward documentation (RN 2.10.10 / Web 3.4.0).
+// 4113 is intentionally absent: it cannot establish this attempt's outcome.
+const REJECTION_CODES = new Set(["4100", "4104", "4105", "4108", "4109", "4110", "4112", "4114"]);
+function unknown(reason, providerCode) {
+    return providerCode === undefined ? { status: "unknown", reason } : { status: "unknown", reason, providerCode };
+}
+function normalize(value, thrown) {
+    if (typeof value !== "object" || value === null) {
+        return unknown(thrown || value === "ERROR" ? "sdk_error" : "invalid_response");
+    }
+    const data = value;
+    const rawCode = data.errorCode ?? data.code;
+    const code = typeof rawCode === "string" && /^[A-Z0-9_]{1,64}$/.test(rawCode) ? rawCode : undefined;
+    const hasError = "errorCode" in data || "code" in data || "error" in data || "message" in data;
+    if (("key" in data && (thrown || hasError)) ||
+        (data.code !== undefined && data.errorCode !== undefined && data.code !== data.errorCode)) {
+        return unknown("invalid_response", code);
+    }
+    if (!thrown && typeof data.key === "string" && data.key.trim().length > 0) {
+        return { status: "granted", rewardKey: data.key };
+    }
+    if ("key" in data)
+        return unknown("invalid_response", code);
+    if (code === "UNSUPPORTED_APP_VERSION") {
+        throw new SdkError("UNSUPPORTED", "direct promotion rewards are not supported on this app version");
+    }
+    if (code && REJECTION_CODES.has(code))
+        return { status: "rejected", providerCode: code };
+    return unknown(code ? "ambiguous_provider_error" : thrown ? "sdk_error" : "invalid_response", code);
+}
+function support(platform) {
+    const grant = platform.Promotion?.grantReward;
+    if (typeof grant !== "function")
+        return "unsupported";
+    if (typeof grant.isSupported !== "function")
+        return "unknown";
+    return grant.isSupported() ? "supported" : "unsupported";
+}
+function validate(input) {
+    if (!input || typeof input.promotionCode !== "string" || !input.promotionCode.trim() ||
+        input.promotionCode !== input.promotionCode.trim() || !Number.isSafeInteger(input.amount) || input.amount <= 0) {
+        throw new SdkError("INVALID_PROMOTION_INPUT", "promotionCode must be non-empty without surrounding whitespace and amount must be a positive safe integer");
+    }
+    // Snapshot before loading; callers cannot change the pending payment input.
+    return { promotionCode: input.promotionCode, amount: input.amount };
+}
+export function createPromotionAdapter(loader, timeoutMs = 0) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0 || timeoutMs > 2_147_483_647) {
+        throw new SdkError("INVALID_PROMOTION_INPUT", "timeoutMs must be an integer from 0 to 2147483647");
+    }
+    let inFlight = false;
+    const load = async () => {
+        const result = await loader();
+        if (!result.available)
+            throw new SdkError("SDK_UNAVAILABLE", result.reason);
+        return result.module;
+    };
+    return {
+        async getSupport() { return support(await load()); },
+        grantReward(input) {
+            let validated;
+            try {
+                validated = validate(input);
+            }
+            catch (error) {
+                return Promise.reject(error);
+            }
+            if (inFlight)
+                return Promise.reject(new SdkError("PROMOTION_IN_PROGRESS", "a direct promotion request is still in progress"));
+            inFlight = true;
+            const now = typeof performance !== "undefined" && typeof performance.now === "function"
+                ? performance.now.bind(performance)
+                : Date.now;
+            const startedAt = now();
+            let expired = false;
+            // Timers cannot run while JS is blocked or draining microtasks. Check the
+            // elapsed budget too, using one clock source for the entire request.
+            const hasExpired = () => expired || (timeoutMs > 0 && now() - startedAt >= timeoutMs);
+            let timer;
+            const work = Promise.resolve().then(async () => {
+                if (hasExpired())
+                    return unknown("timeout");
+                const platform = await load();
+                // A loading timeout must not launch a new payment later.
+                if (hasExpired())
+                    return unknown("timeout");
+                const availability = support(platform);
+                if (hasExpired())
+                    return unknown("timeout");
+                if (availability === "unsupported") {
+                    throw new SdkError("UNSUPPORTED", "the installed SDK or app does not support direct promotion rewards");
+                }
+                let response;
+                try {
+                    response = await platform.Promotion.grantReward(validated);
+                }
+                catch (error) {
+                    if (hasExpired())
+                        return unknown("timeout");
+                    // The RN conversion uses this only for the documented undefined result.
+                    if (error instanceof SdkError && error.code === "UNSUPPORTED")
+                        throw error;
+                    return normalize(error, true);
+                }
+                if (hasExpired())
+                    return unknown("timeout");
+                return normalize(response, false);
+            }).catch((error) => {
+                // A delayed loader/support failure must not beat an elapsed deadline.
+                if (hasExpired())
+                    return unknown("timeout");
+                throw error;
+            }).finally(() => {
+                inFlight = false;
+                if (timer !== undefined)
+                    clearTimeout(timer);
+            });
+            if (timeoutMs === 0)
+                return work;
+            const deadline = new Promise(resolve => {
+                timer = setTimeout(() => { expired = true; resolve(unknown("timeout")); }, timeoutMs);
+            });
+            // Only actual SDK/load settlement releases the lock, not this race.
+            return Promise.race([work, deadline]);
+        }
+    };
+}

package/dist/promotion/platform-contract.d.ts

@@ -0,0 +1,37 @@
+export type PromotionSupport = "supported" | "unsupported" | "unknown";
+export interface PromotionGrantInput {
+    promotionCode: string;
+    amount: number;
+}
+export type PromotionGrantResult = {
+    status: "granted";
+    rewardKey: string;
+} | {
+    status: "rejected";
+    providerCode: string;
+} | {
+    status: "unknown";
+    reason: "sdk_error" | "timeout" | "invalid_response" | "ambiguous_provider_error";
+    providerCode?: string;
+};
+/** Client SDK reports are not independently verified server ledger evidence. */
+export interface PromotionAdapter {
+    getSupport(): Promise<PromotionSupport>;
+    grantReward(input: PromotionGrantInput): Promise<PromotionGrantResult>;
+}
+/** Injected results are untrusted, just like the native bridge response. */
+export interface PromotionPlatformSdk {
+    Promotion?: {
+        grantReward?: ((input: PromotionGrantInput) => Promise<unknown>) & {
+            isSupported?: () => boolean;
+        };
+    };
+}
+export type PromotionPlatformLoader = () => Promise<{
+    available: true;
+    module: PromotionPlatformSdk;
+} | {
+    available: false;
+    reason: string;
+}>;
+//# sourceMappingURL=platform-contract.d.ts.map

package/dist/promotion/platform-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-contract.d.ts","sourceRoot":"","sources":["../../src/promotion/platform-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,kBAAkB,GAAG,0BAA0B,CAAC;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxE;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG;YACjE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;SAC7B,CAAC;KACH,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,CAC/C;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GACjD;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CACvC,CAAC"}

package/dist/review/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { ReviewAdapter, ReviewPlatformLoader } from "./platform-contract.js";
+export declare function createReviewAdapter(loader: ReviewPlatformLoader): ReviewAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/review/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/review/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAqB,MAAM,wBAAwB,CAAC;AAErG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CA6B/E"}

package/dist/review/adapter.js

@@ -0,0 +1,33 @@
+import { SdkError } from "../index.js";
+export function createReviewAdapter(loader) {
+    let inFlight;
+    const load = async () => {
+        const result = await loader();
+        if (!result.available)
+            throw new SdkError("SDK_UNAVAILABLE", result.reason);
+        return result.module;
+    };
+    const supported = (platform) => {
+        const request = platform.Review?.request;
+        return typeof request === "function" &&
+            typeof request.isSupported === "function" && request.isSupported() === true;
+    };
+    return {
+        async isSupported() {
+            return supported(await load());
+        },
+        request() {
+            if (inFlight)
+                return inFlight;
+            // Schedule loading after publishing the lock, including reentrant loaders.
+            inFlight = Promise.resolve().then(async () => {
+                const platform = await load();
+                if (!supported(platform)) {
+                    throw new SdkError("UNSUPPORTED", "review requests are not supported on this app version");
+                }
+                await platform.Review.request();
+            }).finally(() => { inFlight = undefined; });
+            return inFlight;
+        }
+    };
+}

package/dist/review/platform-contract.d.ts

@@ -0,0 +1,21 @@
+/** Minimal injectable shape shared by the platform adapters. */
+export interface ReviewPlatformSdk {
+    Review?: {
+        request?: (() => Promise<void>) & {
+            isSupported?: () => boolean;
+        };
+    };
+}
+export type ReviewPlatformLoader = () => Promise<{
+    available: true;
+    module: ReviewPlatformSdk;
+} | {
+    available: false;
+    reason: string;
+}>;
+/** Completion only means the SDK call settled, never that a review was written. */
+export interface ReviewAdapter {
+    isSupported(): Promise<boolean>;
+    request(): Promise<void>;
+}
+//# sourceMappingURL=platform-contract.d.ts.map

package/dist/review/platform-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-contract.d.ts","sourceRoot":"","sources":["../../src/review/platform-contract.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG;YAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;SAAE,CAAC;KACnE,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAC5C;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC9C;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CACvC,CAAC;AAEF,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/review/platform-contract.js

@@ -0,0 +1 @@
+export {};