@ait-kit/sdk 0.2.0

package/dist/rn/framework-contract.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Structural contract for the official `@apps-in-toss/framework` Ads APIs,
+ * declared from the published documentation so this package type-checks and
+ * ships without requiring the official SDK to be installed. The runtime
+ * module stays an optional peer dependency.
+ */
+export interface LoadFullScreenAdParams {
+    options: {
+        adGroupId: string;
+    };
+    onEvent: (event: {
+        type: "loaded";
+    }) => void;
+    onError: (error: unknown) => void;
+}
+/** Discriminated union per the provider contract: only userEarnedReward carries data. */
+export type FullScreenAdShowEvent = {
+    type: "requested" | "show" | "impression" | "clicked" | "dismissed" | "failedToShow";
+} | {
+    type: "userEarnedReward";
+    data: {
+        unitType: string;
+        unitAmount: number;
+    };
+};
+export interface ShowFullScreenAdParams {
+    options: {
+        adGroupId: string;
+    };
+    onEvent: (event: FullScreenAdShowEvent) => void;
+    onError: (error: unknown) => void;
+}
+export interface FullScreenAdFunctions {
+    loadFullScreenAd(params: LoadFullScreenAdParams): () => void;
+    showFullScreenAd(params: ShowFullScreenAdParams): () => void;
+}
+export interface FullScreenAdSupport {
+    loadFullScreenAd: FullScreenAdFunctions["loadFullScreenAd"] & {
+        isSupported?: () => boolean;
+    };
+    showFullScreenAd: FullScreenAdFunctions["showFullScreenAd"] & {
+        isSupported?: () => boolean;
+    };
+}
+//# sourceMappingURL=framework-contract.d.ts.map

package/dist/rn/framework-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-contract.d.ts","sourceRoot":"","sources":["../../src/rn/framework-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAAC;IAC7D,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,GAAG;QAC5D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;KAC7B,CAAC;IACF,gBAAgB,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,GAAG;QAC5D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;KAC7B,CAAC;CACH"}

package/dist/rn/framework-contract.js

@@ -0,0 +1,7 @@
+/**
+ * Structural contract for the official `@apps-in-toss/framework` Ads APIs,
+ * declared from the published documentation so this package type-checks and
+ * ships without requiring the official SDK to be installed. The runtime
+ * module stays an optional peer dependency.
+ */
+export {};

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

@@ -0,0 +1,22 @@
+import type { FullScreenAdSupport } from "./framework-contract.js";
+/**
+ * Result of trying to load the official framework module. The boolean shape
+ * (instead of thrown errors) keeps call sites explicit about the "module
+ * missing" case, which is an expected condition for optional peers.
+ */
+export type FrameworkLoadResult = {
+    available: true;
+    module: FullScreenAdSupport;
+} | {
+    available: false;
+    reason: string;
+};
+export type FrameworkLoader = () => Promise<FrameworkLoadResult>;
+/**
+ * Default lazy loader: imports `@apps-in-toss/framework` only when an ad
+ * operation needs it. A failed import is never cached, so a later call
+ * retries (the module may appear after an update or late bundle load);
+ * successful loads are cached.
+ */
+export declare function createDefaultFrameworkLoader(): FrameworkLoader;
+//# sourceMappingURL=framework-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-loader.d.ts","sourceRoot":"","sources":["../../src/rn/framework-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAChD;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CAkB9D"}

package/dist/rn/framework-loader.js

@@ -0,0 +1,26 @@
+/**
+ * Default lazy loader: imports `@apps-in-toss/framework` only when an ad
+ * operation needs it. A failed import is never cached, so a later call
+ * retries (the module may appear after an update or late bundle load);
+ * successful loads are cached.
+ */
+export function createDefaultFrameworkLoader() {
+    let cached;
+    return async () => {
+        if (cached) {
+            return { available: true, module: cached };
+        }
+        try {
+            const module = (await import("@apps-in-toss/framework"));
+            if (typeof module.loadFullScreenAd !== "function" || typeof module.showFullScreenAd !== "function") {
+                return { available: false, reason: "@apps-in-toss/framework does not expose the Ads APIs" };
+            }
+            cached = module;
+            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}` };
+        }
+    };
+}

package/dist/rn/iap.d.ts

@@ -0,0 +1,19 @@
+import { type IapAdapterOptions, type IapRecoveryResult } from "../iap/adapter.js";
+import type { IapPlatformLoader, PartialIapPlatformSdk } from "../iap/platform-contract.js";
+/**
+ * IAP adapter for React Native over the official `@apps-in-toss/framework`
+ * (optional peer, imported lazily). The contract mirrors the web entry; the
+ * two entries share the internal engine but never each other's SDK.
+ */
+export interface ReactNativeIapOptions extends Omit<IapAdapterOptions, "loader"> {
+    /**
+     * Framework injection: pass an `IAP` module instance or a custom loader
+     * (tests/consumers). Defaults to the lazy
+     * `import("@apps-in-toss/framework")` loader.
+     */
+    framework?: PartialIapPlatformSdk | IapPlatformLoader;
+}
+export type ReactNativeIap = ReturnType<typeof createReactNativeIap>;
+export type { IapRecoveryResult };
+export declare function createReactNativeIap(options: ReactNativeIapOptions): import("../iap/adapter.js").IapAdapter;
+//# sourceMappingURL=iap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iap.d.ts","sourceRoot":"","sources":["../../src/rn/iap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IAC9E;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;CACvD;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,0CAOlE"}

package/dist/rn/iap.js

@@ -0,0 +1,35 @@
+import { createIapAdapter } from "../iap/adapter.js";
+export function createReactNativeIap(options) {
+    const loader = !options.framework
+        ? createDefaultRnIapLoader()
+        : typeof options.framework === "function"
+            ? options.framework
+            : async () => ({ available: true, module: options.framework });
+    return createIapAdapter({ ...options, loader });
+}
+function createDefaultRnIapLoader() {
+    let cached;
+    return async () => {
+        if (cached) {
+            return { available: true, module: cached };
+        }
+        try {
+            const framework = (await import("@apps-in-toss/framework"));
+            const iap = framework.IAP;
+            if (typeof iap !== "object" || iap === null) {
+                return {
+                    available: false,
+                    reason: "@apps-in-toss/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/framework: ${message}` };
+        }
+    };
+}

package/dist/rn/identity.d.ts

@@ -0,0 +1,20 @@
+import { type SdkAnonymousKey, type SdkLoginResult } from "../index.js";
+import { type IdentityPlatformLoader, type IdentityPlatformSdk } from "../identity/platform-contract.js";
+export interface ReactNativeIdentityOptions {
+    /**
+     * Framework injection: pass a module exposing TossAuth/User or a custom
+     * loader (tests, dev replacements). Defaults to the lazy
+     * `import("@apps-in-toss/framework")` loader. The default never guesses
+     * the environment or substitutes a fake login.
+     */
+    framework?: IdentityPlatformSdk | IdentityPlatformLoader;
+}
+export interface ReactNativeIdentity {
+    /** Starts the platform login and validates/preserves the result. */
+    login(): Promise<SdkLoginResult>;
+    /** Looks up the SDK-issued anonymous key; never fabricates one. */
+    getAnonymousKey(): Promise<SdkAnonymousKey>;
+}
+export declare function createReactNativeIdentity(options?: ReactNativeIdentityOptions): ReactNativeIdentity;
+export declare function normalizeIdentityLoader(framework: ReactNativeIdentityOptions["framework"]): IdentityPlatformLoader;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/rn/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAGzB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mBAAmB,GAAG,sBAAsB,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,GAAG,mBAAmB,CAavG;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,0BAA0B,CAAC,WAAW,CAAC,GACjD,sBAAsB,CAQxB"}

package/dist/rn/identity.js

@@ -0,0 +1,42 @@
+import { SdkError } from "../index.js";
+import { runSdkGetAnonymousKey, runSdkLogin } from "../identity/platform-contract.js";
+export function createReactNativeIdentity(options = {}) {
+    const loader = normalizeIdentityLoader(options.framework);
+    const load = async () => {
+        const result = await loader();
+        if (!result.available) {
+            throw new SdkError("SDK_UNAVAILABLE", result.reason);
+        }
+        return result.module;
+    };
+    return {
+        login: async () => runSdkLogin(await load()),
+        getAnonymousKey: async () => runSdkGetAnonymousKey(await load())
+    };
+}
+export function normalizeIdentityLoader(framework) {
+    if (!framework) {
+        return createDefaultRnIdentityLoader();
+    }
+    if (typeof framework === "function") {
+        return framework;
+    }
+    return async () => ({ available: true, module: framework });
+}
+function createDefaultRnIdentityLoader() {
+    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}` };
+        }
+    };
+}

package/dist/rn/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * React Native adapters for `@ait-kit/sdk`.
+ *
+ * Requires the official `@apps-in-toss/framework` package (declared as an
+ * optional peer): it is imported lazily at first use, so plain Node bundles
+ * of the root entry never touch React Native code.
+ *
+ * ```ts
+ * import { createReactNativeAds } from "@ait-kit/sdk/rn";
+ *
+ * const ads = createReactNativeAds();
+ * await ads.loadFullScreenAd("AD_GROUP_ID");
+ * const result = await ads.showFullScreenAd("AD_GROUP_ID");
+ * if (result.status === "rewarded") {
+ *   // Verify the reward against your server before crediting anything.
+ * }
+ * ```
+ */
+export { createReactNativeAds, type ReactNativeAds, type ReactNativeAdsOptions, type SdkAdType } from "./ads.js";
+export { createReactNativeIap, type ReactNativeIap, type ReactNativeIapOptions } from "./iap.js";
+export type { IapRecoveryResult } from "./iap.js";
+export { createReactNativeIdentity, type ReactNativeIdentity, type ReactNativeIdentityOptions } from "./identity.js";
+export { createReactNativeStorage, type ReactNativeStorageOptions } from "./storage.js";
+export { createReactNativeNotification, createReactNativeShare, type ReactNativeNotification, type ReactNativeNotificationOptions, type ReactNativeShare, type ReactNativeShareOptions } from "./notify-share.js";
+export { createDefaultFrameworkLoader, type FrameworkLoader } from "./framework-loader.js";
+export type { FullScreenAdShowEvent, FullScreenAdSupport, LoadFullScreenAdParams, ShowFullScreenAdParams } from "./framework-contract.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rn/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3F,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC"}

package/dist/rn/index.js

@@ -0,0 +1,24 @@
+/**
+ * React Native adapters for `@ait-kit/sdk`.
+ *
+ * Requires the official `@apps-in-toss/framework` package (declared as an
+ * optional peer): it is imported lazily at first use, so plain Node bundles
+ * of the root entry never touch React Native code.
+ *
+ * ```ts
+ * import { createReactNativeAds } from "@ait-kit/sdk/rn";
+ *
+ * const ads = createReactNativeAds();
+ * await ads.loadFullScreenAd("AD_GROUP_ID");
+ * const result = await ads.showFullScreenAd("AD_GROUP_ID");
+ * if (result.status === "rewarded") {
+ *   // Verify the reward against your server before crediting anything.
+ * }
+ * ```
+ */
+export { createReactNativeAds } from "./ads.js";
+export { createReactNativeIap } from "./iap.js";
+export { createReactNativeIdentity } from "./identity.js";
+export { createReactNativeStorage } from "./storage.js";
+export { createReactNativeNotification, createReactNativeShare } from "./notify-share.js";
+export { createDefaultFrameworkLoader } from "./framework-loader.js";

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

@@ -0,0 +1,42 @@
+import { type SdkNotificationAgreementResult, type SdkShareUiResult } from "../index.js";
+import { type NotificationPlatformLoader, type NotificationPlatformSdk } from "../notification/platform-contract.js";
+import { type SharePlatformLoader, type SharePlatformSdk } from "../share/platform-contract.js";
+export interface ReactNativeNotificationOptions {
+    /**
+     * Framework injection: pass a module exposing Notification or a custom
+     * loader. Defaults to the lazy `import("@apps-in-toss/framework")` loader.
+     */
+    framework?: NotificationPlatformSdk | NotificationPlatformLoader;
+    /** Overall deadline per agreement request (default 60000ms; 0 disables). */
+    timeoutMs?: number;
+}
+export interface ReactNativeNotification {
+    /**
+     * Requests agreement for one template. The result preserves the
+     * templateCode and the platform's raw event, and describes only this
+     * request — syncing consent state to a server is the consumer's job.
+     */
+    requestAgreement(templateCode: string): Promise<SdkNotificationAgreementResult>;
+}
+export declare function createReactNativeNotification(options?: ReactNativeNotificationOptions): ReactNativeNotification;
+export interface ReactNativeShareOptions {
+    /**
+     * Framework injection: pass a module exposing Share or a custom loader.
+     * Defaults to the lazy `import("@apps-in-toss/framework")` loader.
+     */
+    framework?: SharePlatformSdk | SharePlatformLoader;
+}
+export interface ReactNativeShare {
+    /** Creates a share link for an `intoss://` deeplink path. */
+    createLink(path: string, ogImageUrl?: string): Promise<string>;
+    /**
+     * Opens the native share sheet. Resolving `closed` means the sheet flow
+     * ended — it does not prove the user shared and never grants reward
+     * eligibility.
+     */
+    sendMessage(message: string): Promise<SdkShareUiResult>;
+}
+export declare function createReactNativeShare(options?: ReactNativeShareOptions): ReactNativeShare;
+export declare function normalizeNotificationLoader(framework: ReactNativeNotificationOptions["framework"]): NotificationPlatformLoader;
+export declare function normalizeShareLoader(framework: ReactNativeShareOptions["framework"]): SharePlatformLoader;
+//# sourceMappingURL=notify-share.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify-share.d.ts","sourceRoot":"","sources":["../../src/rn/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;AAQvC,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,0BAA0B,CAAC;IACjE,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAazB;AAMD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,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,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAyClB;AAMD,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,8BAA8B,CAAC,WAAW,CAAC,GACrD,0BAA0B,CAQ5B;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,GAC9C,mBAAmB,CAQrB"}

package/dist/rn/notify-share.js

@@ -0,0 +1,159 @@
+import { SdkError } from "../index.js";
+import { runRequestAgreement } from "../notification/platform-contract.js";
+import { runShareUi, validateSharePath } from "../share/platform-contract.js";
+const DEFAULT_AGREEMENT_TIMEOUT_MS = 60_000;
+export function createReactNativeNotification(options = {}) {
+    const loader = normalizeNotificationLoader(options.framework);
+    const timeoutMs = options.timeoutMs ?? DEFAULT_AGREEMENT_TIMEOUT_MS;
+    return {
+        requestAgreement(templateCode) {
+            if (typeof templateCode !== "string" || !templateCode.trim()) {
+                return Promise.reject(new SdkError("UNSUPPORTED", "templateCode must be a non-empty string"));
+            }
+            return agreementWithLoaderDeadline(loader, templateCode, timeoutMs);
+        }
+    };
+}
+export function createReactNativeShare(options = {}) {
+    const loader = normalizeShareLoader(options.framework);
+    const load = async () => {
+        const result = await loader();
+        if (!result.available) {
+            throw new SdkError("SDK_UNAVAILABLE", result.reason);
+        }
+        return result.module;
+    };
+    return {
+        async createLink(path, ogImageUrl) {
+            const validated = validateSharePath(path);
+            const platform = await load();
+            const createLink = platform.Share?.createLink;
+            if (typeof createLink !== "function") {
+                throw new SdkError("UNSUPPORTED", "the installed SDK does not expose Share.createLink");
+            }
+            if (typeof createLink.isSupported === "function" && !createLink.isSupported()) {
+                throw new SdkError("UNSUPPORTED", "share links are not supported on this app version");
+            }
+            // Receiver-preserving member call; optional OG image only when present.
+            return platform.Share.createLink(ogImageUrl !== undefined ? { path: validated, ogImageUrl } : { path: validated });
+        },
+        async sendMessage(message) {
+            if (typeof message !== "string" || !message) {
+                throw new SdkError("UNSUPPORTED", "message must be a non-empty string");
+            }
+            const platform = await load();
+            const sendMessage = platform.Share?.sendMessage;
+            if (typeof sendMessage !== "function") {
+                throw new SdkError("UNSUPPORTED", "the installed SDK does not expose Share.sendMessage");
+            }
+            if (typeof sendMessage.isSupported === "function" && !sendMessage.isSupported()) {
+                throw new SdkError("UNSUPPORTED", "the share sheet is not supported on this app version");
+            }
+            return runShareUi(platform, message);
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Loaders
+// ---------------------------------------------------------------------------
+export function normalizeNotificationLoader(framework) {
+    if (!framework) {
+        return createDefaultRnModuleLoader();
+    }
+    if (typeof framework === "function") {
+        return framework;
+    }
+    return async () => ({ available: true, module: framework });
+}
+export function normalizeShareLoader(framework) {
+    if (!framework) {
+        return createDefaultRnModuleLoader();
+    }
+    if (typeof framework === "function") {
+        return framework;
+    }
+    return async () => ({ available: true, module: framework });
+}
+function createDefaultRnModuleLoader() {
+    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}`
+            };
+        }
+    };
+}
+/**
+ * Runs one agreement under a deadline that also covers platform loading:
+ * a stalled loader cannot wedge the request, a loader resolving after the
+ * deadline never registers, and the flow owns the remaining budget.
+ */
+async function agreementWithLoaderDeadline(loader, templateCode, timeoutMs) {
+    const timedOut = () => ({
+        status: "timeout",
+        templateCode,
+        reason: `agreement request timed out after ${timeoutMs}ms; the user may still act — resolve the state server-side before retrying`
+    });
+    if (!(timeoutMs > 0)) {
+        return runRequestAgreement(await loadNotificationPlatform(loader), templateCode, 0);
+    }
+    const startedAt = Date.now();
+    let cancelled = false;
+    let timer;
+    const loadDeadline = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            cancelled = true;
+            resolve(null);
+        }, timeoutMs);
+    });
+    let platform;
+    try {
+        platform = await Promise.race([
+            loadNotificationPlatform(loader).then((loaded) => (cancelled ? null : loaded)),
+            loadDeadline
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+    if (!platform || cancelled || Date.now() - startedAt >= timeoutMs) {
+        return timedOut();
+    }
+    const remainingMs = Math.max(1, timeoutMs - (Date.now() - startedAt));
+    // The public reason reports the CONFIGURED deadline, not the remainder
+    // left after loading; the remainder still bounds the actual flow.
+    const flow = runRequestAgreement(platform, templateCode, remainingMs);
+    const configured = timeoutMs;
+    return flow.then((result) => result.status === "timeout"
+        ? {
+            ...result,
+            reason: `agreement request timed out after ${configured}ms; the user may still act — resolve the state server-side before retrying`
+        }
+        : result);
+}
+async function loadNotificationPlatform(loader) {
+    const result = await loader();
+    if (!result.available) {
+        throw new SdkError("SDK_UNAVAILABLE", result.reason);
+    }
+    const request = result.module.Notification?.requestAgreement;
+    if (typeof request !== "function") {
+        throw new SdkError("UNSUPPORTED", "the installed SDK does not expose Notification.requestAgreement");
+    }
+    if (typeof request.isSupported === "function" && !request.isSupported()) {
+        throw new SdkError("UNSUPPORTED", "notification agreements are not supported on this app version");
+    }
+    return result.module;
+}

package/dist/rn/storage.d.ts

@@ -0,0 +1,18 @@
+import { type SdkStorage } from "../index.js";
+import { type StoragePlatformLoader, type StoragePlatformSdk } from "../storage/platform-contract.js";
+export interface ReactNativeStorageOptions {
+    /**
+     * Framework injection: pass a module exposing Storage or a custom loader
+     * (tests, dev replacements). Defaults to the lazy
+     * `import("@apps-in-toss/framework")` loader.
+     */
+    framework?: StoragePlatformSdk | StoragePlatformLoader;
+}
+/**
+ * SDK-backed storage for React Native. Keys and string values pass through
+ * verbatim (no namespace prefixing); get resolves null for missing keys and
+ * set/remove rejections propagate so failures stay observable.
+ */
+export declare function createReactNativeStorage(options?: ReactNativeStorageOptions): SdkStorage;
+export declare function normalizeStorageLoader(framework: ReactNativeStorageOptions["framework"]): StoragePlatformLoader;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +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"}

package/dist/rn/storage.js

@@ -0,0 +1,64 @@
+import { SdkError } from "../index.js";
+import { createSdkStorageFromPlatform } from "../storage/platform-contract.js";
+/**
+ * SDK-backed storage for React Native. Keys and string values pass through
+ * verbatim (no namespace prefixing); get resolves null for missing keys and
+ * set/remove rejections propagate so failures stay observable.
+ */
+export function createReactNativeStorage(options = {}) {
+    const loader = normalizeStorageLoader(options.framework);
+    let cached;
+    let resolving;
+    const resolve = () => {
+        if (cached) {
+            return Promise.resolve(cached);
+        }
+        // Concurrent initial calls share one loader invocation so custom
+        // loaders cannot hand out independent stores.
+        if (!resolving) {
+            resolving = (async () => {
+                const result = await loader();
+                if (!result.available) {
+                    throw new SdkError("SDK_UNAVAILABLE", result.reason);
+                }
+                cached = createSdkStorageFromPlatform(result.module);
+                return cached;
+            })();
+            resolving.catch(() => {
+                resolving = undefined;
+            });
+        }
+        return resolving;
+    };
+    return {
+        get: async (key) => (await resolve()).get(key),
+        set: async (key, value) => (await resolve()).set(key, value),
+        remove: async (key) => (await resolve()).remove(key)
+    };
+}
+export function normalizeStorageLoader(framework) {
+    if (!framework) {
+        return createDefaultRnStorageLoader();
+    }
+    if (typeof framework === "function") {
+        return framework;
+    }
+    return async () => ({ available: true, module: framework });
+}
+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}` };
+        }
+    };
+}

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

@@ -0,0 +1,41 @@
+import { type SdkShareUiResult } from "../index.js";
+/**
+ * Internal platform contract for the share adapter, shared by /rn and /web.
+ */
+export interface ShareCreateLinkParams {
+    path: string;
+    ogImageUrl?: string;
+}
+type FunctionWithSupport<F> = F & {
+    isSupported?: () => boolean;
+};
+export interface ShareLike {
+    createLink?: FunctionWithSupport<(params: ShareCreateLinkParams) => Promise<string>> | undefined;
+    sendMessage?: FunctionWithSupport<(message: {
+        message: string;
+    }) => Promise<void>> | undefined;
+}
+export interface SharePlatformSdk {
+    Share?: ShareLike;
+}
+export type SharePlatformLoader = () => Promise<{
+    available: true;
+    module: SharePlatformSdk;
+} | {
+    available: false;
+    reason: string;
+}>;
+/**
+ * Validates the documented input contract (an `intoss://` deeplink path)
+ * before dispatching; the resolved share link passes through verbatim.
+ */
+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.
+ */
+export declare function runShareUi(platform: SharePlatformSdk, message: string): Promise<SdkShareUiResult>;
+export {};
+//# sourceMappingURL=platform-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-contract.d.ts","sourceRoot":"","sources":["../../src/share/platform-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG9D;;GAEG;AAEH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EACP,mBAAmB,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GACvE,SAAS,CAAC;IACd,WAAW,CAAC,EACR,mBAAmB,CAAC,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GACpE,SAAS,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAC7C;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CACrF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAY3B"}