@ait-kit/sdk 0.2.0 → 0.4.0

package/dist/rn/official-module.js

@@ -0,0 +1,106 @@
+import { SdkError } from "../index.js";
+/**
+ * Wraps an official function for the internal contract while preserving the
+ * original receiver (the official module object, in case the implementation
+ * relies on `this`) and an optional `isSupported` flag, so version-gate
+ * checks keep working whenever the official SDK exposes them.
+ */
+function preserveSupport(original, wrapper) {
+    if (typeof original.isSupported === "function") {
+        return Object.assign(wrapper, { isSupported: () => original.isSupported() });
+    }
+    return wrapper;
+}
+/**
+ * Converts the official identity exports (`appLogin`, `getAnonymousKey`) to
+ * the shared identity contract. Missing functions stay missing so the
+ * shared engine reports UNSUPPORTED per operation.
+ */
+export function adaptOfficialRnIdentity(module) {
+    const identity = {};
+    if (typeof module.appLogin === "function") {
+        const appLogin = module.appLogin;
+        identity.TossAuth = {
+            login: preserveSupport(appLogin, () => appLogin.call(module))
+        };
+    }
+    if (typeof module.getAnonymousKey === "function") {
+        const getAnonymousKey = module.getAnonymousKey;
+        identity.User = {
+            getAnonymousKey: preserveSupport(getAnonymousKey, async () => {
+                const result = await getAnonymousKey.call(module);
+                // The official SDK resolves undefined when the installed app is
+                // below the feature's minimum version: that is an unsupported
+                // environment, not a malformed result.
+                if (result === undefined) {
+                    throw new SdkError("UNSUPPORTED", "the installed app version does not support getAnonymousKey");
+                }
+                // The "ERROR" sentinel and malformed shapes are rejected by the
+                // shared validator (runSdkGetAnonymousKey) like on any platform.
+                return result;
+            })
+        };
+    }
+    return identity;
+}
+/**
+ * Converts the official `requestNotificationAgreement` to the shared
+ * notification contract. The official params shape matches the internal
+ * one exactly, and the returned cleanup function passes through so the
+ * event flow owns and invokes it.
+ */
+export function adaptOfficialRnNotification(module) {
+    const notification = {};
+    if (typeof module.requestNotificationAgreement === "function") {
+        const requestNotificationAgreement = module.requestNotificationAgreement;
+        notification.Notification = {
+            requestAgreement: preserveSupport(requestNotificationAgreement, (params) => requestNotificationAgreement.call(module, params))
+        };
+    }
+    return notification;
+}
+/**
+ * Converts the official share exports to the shared share contract:
+ * `getTossShareLink(path, ogImageUrl?)` takes positional arguments (the
+ * internal contract's object form is unpacked here) and `share` receives
+ * the `{ message }` object as-is.
+ */
+export function adaptOfficialRnShare(module) {
+    const share = {};
+    if (typeof module.getTossShareLink === "function") {
+        const getTossShareLink = module.getTossShareLink;
+        share.Share = {
+            createLink: preserveSupport(getTossShareLink, ({ path, ogImageUrl }) => ogImageUrl !== undefined
+                ? getTossShareLink.call(module, path, ogImageUrl)
+                : getTossShareLink.call(module, path))
+        };
+    }
+    if (typeof module.share === "function") {
+        const officialShare = module.share;
+        share.Share = {
+            ...share.Share,
+            sendMessage: preserveSupport(officialShare, (message) => officialShare.call(module, message))
+        };
+    }
+    return share;
+}
+/** Translate the official flat review function, preserving both receivers. */
+export function adaptOfficialRnReview(module) {
+    const request = module.requestReview;
+    return typeof request === "function"
+        ? { Review: { request: preserveSupport(request, () => request.call(module)) } }
+        : {};
+}
+/** Flat RN API uses a params wrapper and undefined for unsupported app versions. */
+export function adaptOfficialRnPromotion(module) {
+    const grant = module.grantPromotionReward;
+    if (typeof grant !== "function")
+        return {};
+    return { Promotion: { grantReward: preserveSupport(grant, async (input) => {
+                const result = await grant.call(module, { params: input });
+                if (result === undefined) {
+                    throw new SdkError("UNSUPPORTED", "the installed app version does not support direct promotion rewards");
+                }
+                return result;
+            }) } };
+}

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

@@ -0,0 +1,4 @@
+import { type PlatformLoader, type PlatformLoadResult } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export declare function createRnPlatformLoader<T>(select: (module: typeof import("@apps-in-toss/framework")) => PlatformLoadResult<T>, includeErrorDetails?: boolean): PlatformLoader<T>;
+//# sourceMappingURL=platform-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-loader.d.ts","sourceRoot":"","sources":["../../src/rn/platform-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvI,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,yBAAyB,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,EACnF,mBAAmB,UAAO,GACzB,cAAc,CAAC,CAAC,CAAC,CAKnB"}

package/dist/rn/platform-loader.js

@@ -0,0 +1,5 @@
+import { createCachedPlatformLoader, frameworkImportError } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export function createRnPlatformLoader(select, includeErrorDetails = true) {
+    return createCachedPlatformLoader(async () => select(await import("@apps-in-toss/framework")), error => frameworkImportError("@apps-in-toss/framework", error, includeErrorDetails));
+}

package/dist/rn/promotion.d.ts

@@ -0,0 +1,9 @@
+import type { PromotionAdapter, PromotionPlatformLoader, PromotionPlatformSdk } from "../promotion/platform-contract.js";
+export interface ReactNativePromotionOptions {
+    /** Shared Promotion contract or async loader; defaults to the official SDK. */
+    framework?: PromotionPlatformSdk | PromotionPlatformLoader;
+    /** Overall wait deadline; 0 (default) disables it. Timeout does not cancel payment. */
+    timeoutMs?: number;
+}
+export declare function createReactNativePromotion(options?: ReactNativePromotionOptions): PromotionAdapter;
+//# sourceMappingURL=promotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../../src/rn/promotion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzH,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAAC;IAC3D,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC,GAAG,gBAAgB,CAEtG"}

package/dist/rn/promotion.js

@@ -0,0 +1,11 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
+import { createPromotionAdapter } from "../promotion/adapter.js";
+import { adaptOfficialRnPromotion } from "./official-module.js";
+export function createReactNativePromotion(options = {}) {
+    return createPromotionAdapter(resolvePlatformLoader(options.framework, createDefaultPromotionLoader), options.timeoutMs);
+}
+/** Keep import diagnostics redacted for direct-promotion operations. */
+function createDefaultPromotionLoader() {
+    return createRnPlatformLoader(module => ({ available: true, module: adaptOfficialRnPromotion(module) }), false);
+}

package/dist/rn/review.d.ts

@@ -0,0 +1,7 @@
+import type { ReviewAdapter, ReviewPlatformLoader, ReviewPlatformSdk } from "../review/platform-contract.js";
+export interface ReactNativeReviewOptions {
+    /** Shared contract injection, or a loader; defaults to the lazy official SDK. */
+    framework?: ReviewPlatformSdk | ReviewPlatformLoader;
+}
+export declare function createReactNativeReview(options?: ReactNativeReviewOptions): ReviewAdapter;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/rn/review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAG7G,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,SAAS,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;CACtD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa,CAE7F"}

package/dist/rn/review.js

@@ -0,0 +1,10 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
+import { createReviewAdapter } from "../review/adapter.js";
+import { adaptOfficialRnReview } from "./official-module.js";
+export function createReactNativeReview(options = {}) {
+    return createReviewAdapter(resolvePlatformLoader(options.framework, createDefaultReviewLoader));
+}
+function createDefaultReviewLoader() {
+    return createRnPlatformLoader(module => ({ available: true, module: adaptOfficialRnReview(module) }), false);
+}

package/dist/rn/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/rn/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,UAAU,CA8BZ;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,yBAAyB,CAAC,WAAW,CAAC,GAChD,qBAAqB,CAQvB"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/rn/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,UAAU,CA8BZ;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,yBAAyB,CAAC,WAAW,CAAC,GAChD,qBAAqB,CAEvB"}

package/dist/rn/storage.js

@@ -1,3 +1,5 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createRnPlatformLoader } from "./platform-loader.js";
 import { SdkError } from "../index.js";
 import { createSdkStorageFromPlatform } from "../storage/platform-contract.js";
 /**
@@ -37,28 +39,8 @@ export function createReactNativeStorage(options = {}) {
     };
 }
 export function normalizeStorageLoader(framework) {
-    if (!framework) {
-        return createDefaultRnStorageLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultRnStorageLoader);
 }
 function createDefaultRnStorageLoader() {
-    let cached;
-    return async () => {
-        if (cached) {
-            return { available: true, module: cached };
-        }
-        try {
-            const framework = (await import("@apps-in-toss/framework"));
-            cached = framework;
-            return { available: true, module: cached };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { available: false, reason: `failed to import @apps-in-toss/framework: ${message}` };
-        }
-    };
+    return createRnPlatformLoader(module => ({ available: true, module: module }));
 }

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

@@ -31,10 +31,10 @@ export type SharePlatformLoader = () => Promise<{
  */
 export declare function validateSharePath(path: string): string;
 /**
- * Wraps the share-UI call: a resolution means the native share sheet flow
- * ended normally ("closed") — it never proves the user actually shared and
- * never grants reward eligibility. Rejections surface as failed with the
- * platform's error code/message preserved.
+ * Wraps the share-UI call: a resolution means ONLY that the SDK share call
+ * completed ("completed") — it never proves the share sheet opened or that
+ * the user actually shared, and never grants reward eligibility. Rejections
+ * surface as failed with the platform's error code/message preserved.
  */
 export declare function runShareUi(platform: SharePlatformSdk, message: string): Promise<SdkShareUiResult>;
 export {};

package/dist/share/platform-contract.js

@@ -13,15 +13,15 @@ export function validateSharePath(path) {
     return path;
 }
 /**
- * Wraps the share-UI call: a resolution means the native share sheet flow
- * ended normally ("closed") — it never proves the user actually shared and
- * never grants reward eligibility. Rejections surface as failed with the
- * platform's error code/message preserved.
+ * Wraps the share-UI call: a resolution means ONLY that the SDK share call
+ * completed ("completed") — it never proves the share sheet opened or that
+ * the user actually shared, and never grants reward eligibility. Rejections
+ * surface as failed with the platform's error code/message preserved.
  */
 export async function runShareUi(platform, message) {
     try {
         await platform.Share.sendMessage({ message });
-        return { status: "closed" };
+        return { status: "completed" };
     }
     catch (error) {
         const code = readErrorCode(error);

package/dist/web/framework-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-loader.d.ts","sourceRoot":"","sources":["../../src/web/framework-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,iBAAiB,CAwBnE"}
+{"version":3,"file":"framework-loader.d.ts","sourceRoot":"","sources":["../../src/web/framework-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,iBAAiB,CAQnE"}

package/dist/web/framework-loader.js

@@ -1,3 +1,4 @@
+import { createWebPlatformLoader } from "./platform-loader.js";
 /**
  * Default lazy loader for the official web SDK: imports
  * `@apps-in-toss/web-framework` (an optional peer) only when an IAP
@@ -5,28 +6,11 @@
  * retries; successful loads are cached.
  */
 export function createDefaultWebFrameworkLoader() {
-    let cached;
-    return async () => {
-        if (cached) {
-            return { available: true, module: cached };
+    return createWebPlatformLoader((framework) => {
+        const iap = framework.IAP;
+        if (typeof iap !== "object" || iap === null) {
+            return { available: false, reason: "@apps-in-toss/web-framework does not expose an IAP domain" };
         }
-        try {
-            const framework = (await import("@apps-in-toss/web-framework"));
-            const iap = framework.IAP;
-            if (typeof iap !== "object" || iap === null) {
-                return {
-                    available: false,
-                    reason: "@apps-in-toss/web-framework does not expose an IAP domain"
-                };
-            }
-            // Per-operation capability is validated at each call site: an
-            // installed version may expose some IAP functions but not others.
-            cached = iap;
-            return { available: true, module: cached };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { available: false, reason: `failed to import @apps-in-toss/web-framework: ${message}` };
-        }
-    };
+        return { available: true, module: iap };
+    });
 }

package/dist/web/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/web/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAGzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mBAAmB,GAAG,sBAAsB,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAa/E;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA8B5E"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/web/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAGzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mBAAmB,GAAG,sBAAsB,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAa/E;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CACxD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA8B5E"}

package/dist/web/identity.js

@@ -1,3 +1,5 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createWebPlatformLoader } from "./platform-loader.js";
 import { SdkError } from "../index.js";
 import { runSdkGetAnonymousKey, runSdkLogin } from "../identity/platform-contract.js";
 import { createSdkStorageFromPlatform } from "../storage/platform-contract.js";
@@ -48,40 +50,17 @@ export function createWebStorage(options = {}) {
     };
 }
 function normalizeWebIdentityLoader(framework) {
-    if (!framework) {
-        return createDefaultWebLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultWebIdentityLoader);
 }
 function normalizeWebStorageLoader(framework) {
-    if (!framework) {
-        return createDefaultWebLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultWebStorageLoader);
 }
-function createDefaultWebLoader() {
-    let cached;
-    return async () => {
-        if (cached) {
-            return { available: true, module: cached };
-        }
-        try {
-            const framework = (await import("@apps-in-toss/web-framework"));
-            cached = framework;
-            return { available: true, module: cached };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                available: false,
-                reason: `failed to import @apps-in-toss/web-framework: ${message}`
-            };
-        }
-    };
+// The web SDK exposes the shared namespaced contract shapes directly, so
+// the default loaders consume the official module without any conversion
+// or type assertion; a failed import is never cached, successful loads are.
+function createDefaultWebIdentityLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }));
+}
+function createDefaultWebStorageLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }));
 }

package/dist/web/index.d.ts

@@ -44,4 +44,6 @@ export { createWebIdentity, type WebIdentity, type WebIdentityOptions } from "./
 export { createWebStorage, type WebStorageOptions } from "./identity.js";
 export { createWebNotification, createWebShare, type WebNotification, type WebNotificationOptions, type WebShare, type WebShareOptions } from "./notify-share.js";
 export declare function createWebIap(options: WebIapOptions): import("../iap/adapter.js").IapAdapter;
+export { createWebReview, type WebReviewOptions } from "./review.js";
+export { createWebPromotion, type WebPromotionOptions } from "./promotion.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IACtE;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;CAChF;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,0CAOlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IACtE;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;CAChF;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,0CAGlD;AAED,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/web/index.js

@@ -1,3 +1,4 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
 /**
  * Web adapters for `@ait-kit/sdk`.
  *
@@ -34,10 +35,8 @@ export { createWebStorage } from "./identity.js";
 // createWebStorage lives in identity.ts alongside the shared web loader helpers.
 export { createWebNotification, createWebShare } from "./notify-share.js";
 export function createWebIap(options) {
-    const loader = !options.framework
-        ? createDefaultWebFrameworkLoader()
-        : typeof options.framework === "function"
-            ? options.framework
-            : async () => ({ available: true, module: options.framework });
+    const loader = resolvePlatformLoader(options.framework, createDefaultWebFrameworkLoader);
     return createIapAdapter({ ...options, loader });
 }
+export { createWebReview } from "./review.js";
+export { createWebPromotion } from "./promotion.js";

package/dist/web/notify-share.d.ts

@@ -28,8 +28,9 @@ export interface WebShare {
     /** Creates a share link for an `intoss://` deeplink path. */
     createLink(path: string, ogImageUrl?: string): Promise<string>;
     /**
-     * Opens the native share sheet; `closed` never proves the user shared and
-     * never grants reward eligibility.
+     * Opens the native share sheet; `completed` means only that the SDK share
+     * call finished — it never proves the user shared and never grants reward
+     * eligibility.
      */
     sendMessage(message: string): Promise<SdkShareUiResult>;
 }

package/dist/web/notify-share.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notify-share.d.ts","sourceRoot":"","sources":["../../src/web/notify-share.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAE7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAGtB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,0BAA0B,CAAC;IACjE,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAa3F;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;CACpD;AAED,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzD;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAwCtE"}
+{"version":3,"file":"notify-share.d.ts","sourceRoot":"","sources":["../../src/web/notify-share.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAE7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAGtB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,0BAA0B,CAAC;IACjE,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAa3F;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;CACpD;AAED,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzD;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAwCtE"}

package/dist/web/notify-share.js

@@ -1,3 +1,5 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createWebPlatformLoader } from "./platform-loader.js";
 import { SdkError } from "../index.js";
 import { runRequestAgreement } from "../notification/platform-contract.js";
 import { runShareUi, validateSharePath } from "../share/platform-contract.js";
@@ -53,42 +55,18 @@ export function createWebShare(options = {}) {
     };
 }
 function normalizeWebNotificationLoader(framework) {
-    if (!framework) {
-        return createDefaultWebModuleLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultWebNotificationLoader);
 }
 function normalizeWebShareLoader(framework) {
-    if (!framework) {
-        return createDefaultWebModuleLoader();
-    }
-    if (typeof framework === "function") {
-        return framework;
-    }
-    return async () => ({ available: true, module: framework });
+    return resolvePlatformLoader(framework, createDefaultWebShareLoader);
 }
-function createDefaultWebModuleLoader() {
-    let cached;
-    return async () => {
-        if (cached) {
-            return { available: true, module: cached };
-        }
-        try {
-            const framework = (await import("@apps-in-toss/web-framework"));
-            cached = framework;
-            return { available: true, module: cached };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                available: false,
-                reason: `failed to import @apps-in-toss/web-framework: ${message}`
-            };
-        }
-    };
+// See createDefaultWebIdentityLoader in ./identity.ts: the web SDK already
+// matches the shared contract shapes, so no conversion or assertion is used.
+function createDefaultWebNotificationLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }));
+}
+function createDefaultWebShareLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }));
 }
 /**
  * Same loader-covering deadline as the React Native adapter; see

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

@@ -0,0 +1,4 @@
+import { type PlatformLoader, type PlatformLoadResult } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export declare function createWebPlatformLoader<T>(select: (module: typeof import("@apps-in-toss/web-framework")) => PlatformLoadResult<T>, includeErrorDetails?: boolean): PlatformLoader<T>;
+//# sourceMappingURL=platform-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-loader.d.ts","sourceRoot":"","sources":["../../src/web/platform-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvI,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,6BAA6B,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,EACvF,mBAAmB,UAAO,GACzB,cAAc,CAAC,CAAC,CAAC,CAKnB"}

package/dist/web/platform-loader.js

@@ -0,0 +1,5 @@
+import { createCachedPlatformLoader, frameworkImportError } from "../platform-loader.js";
+/** Lazy platform-local import followed by capability-specific selection. */
+export function createWebPlatformLoader(select, includeErrorDetails = true) {
+    return createCachedPlatformLoader(async () => select(await import("@apps-in-toss/web-framework")), error => frameworkImportError("@apps-in-toss/web-framework", error, includeErrorDetails));
+}

package/dist/web/promotion.d.ts

@@ -0,0 +1,9 @@
+import type { PromotionAdapter, PromotionPlatformLoader, PromotionPlatformSdk } from "../promotion/platform-contract.js";
+export interface WebPromotionOptions {
+    /** Shared Promotion contract or async loader; defaults to the official SDK. */
+    framework?: PromotionPlatformSdk | PromotionPlatformLoader;
+    /** Overall wait deadline; 0 (default) disables it. Timeout does not cancel payment. */
+    timeoutMs?: number;
+}
+export declare function createWebPromotion(options?: WebPromotionOptions): PromotionAdapter;
+//# sourceMappingURL=promotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../../src/web/promotion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAAC;IAC3D,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,CAEtF"}

package/dist/web/promotion.js

@@ -0,0 +1,10 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createWebPlatformLoader } from "./platform-loader.js";
+import { createPromotionAdapter } from "../promotion/adapter.js";
+export function createWebPromotion(options = {}) {
+    return createPromotionAdapter(resolvePlatformLoader(options.framework, createDefaultPromotionLoader), options.timeoutMs);
+}
+/** Keep import diagnostics redacted for direct-promotion operations. */
+function createDefaultPromotionLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }), false);
+}

package/dist/web/review.d.ts

@@ -0,0 +1,7 @@
+import type { ReviewAdapter, ReviewPlatformLoader, ReviewPlatformSdk } from "../review/platform-contract.js";
+export interface WebReviewOptions {
+    /** Shared contract injection, or a loader; defaults to the lazy official SDK. */
+    framework?: ReviewPlatformSdk | ReviewPlatformLoader;
+}
+export declare function createWebReview(options?: WebReviewOptions): ReviewAdapter;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/web/review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAE7G,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,SAAS,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;CACtD;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,aAAa,CAE7E"}

package/dist/web/review.js

@@ -0,0 +1,9 @@
+import { resolvePlatformLoader } from "../platform-loader.js";
+import { createWebPlatformLoader } from "./platform-loader.js";
+import { createReviewAdapter } from "../review/adapter.js";
+export function createWebReview(options = {}) {
+    return createReviewAdapter(resolvePlatformLoader(options.framework, createDefaultReviewLoader));
+}
+function createDefaultReviewLoader() {
+    return createWebPlatformLoader(module => ({ available: true, module: module }), false);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ait-kit/sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Frontend SDK adapters for Apps in Toss mini apps: shared contracts plus per-runtime entry points.",
   "type": "module",
   "license": "MIT",
@@ -49,8 +49,8 @@
     "prepack": "bun run build"
   },
   "peerDependencies": {
-    "@apps-in-toss/framework": "*",
-    "@apps-in-toss/web-framework": "*"
+    "@apps-in-toss/framework": ">=2.10.10",
+    "@apps-in-toss/web-framework": ">=3.4.0"
   },
   "peerDependenciesMeta": {
     "@apps-in-toss/framework": {