@ait-kit/sdk 0.2.0 → 0.4.0

package/README.md

@@ -99,7 +99,7 @@ SDK initialization never grants or completes pending orders by itself.
 | Grant completion notify | ✅ | ✅ | sent only after server grant confirms |
 | Full-screen ads | ✅ | ➖ | ads are RN-only today |
 | Notification agreement | ✅ | ✅ | event-based, one template per request |
-| Share link / share sheet | ✅ | ✅ | `intoss://` paths; `closed` ≠ shared |
+| Share link / share sheet | ✅ | ✅ | `intoss://` paths; `completed` ≠ shared |
 | Unsupported app version | `SdkError("UNSUPPORTED")` | same | per-function `isSupported` gates |
 
 Notification and sharing adapters ship in both entries (see below).
@@ -136,8 +136,13 @@ Contracts:
   reject with `SdkError("INVALID_LOGIN_RESULT")`; unsupported environments
   with `UNSUPPORTED`; SDK rejections propagate unchanged.
 - **Anonymous key** results must be the documented `{ type: "HASH", hash }`
-  shape. Anything else (including sentinel values) rejects with
-  `SdkError("INVALID_ANONYMOUS_KEY")` — the adapter never invents a key.
+  shape. Anything else (including the official SDK's `"ERROR"` sentinel)
+  rejects with `SdkError("INVALID_ANONYMOUS_KEY")` — the adapter never
+  invents a key. One exception: on React Native the official
+  `getAnonymousKey()` resolves `undefined` when the installed app is below
+  the feature's minimum version, which rejects with
+  `SdkError("UNSUPPORTED")` instead — an unsupported environment, not a
+  malformed key.
 - **Storage** keys and string values pass through byte-for-byte: no
   namespace prefixing, no key transformation. Compose namespaced keys
   yourself (e.g. `cart:items`). `get` resolves `null` for missing keys;
@@ -171,10 +176,10 @@ const result = await notification.requestAgreement("TEMPLATE_CODE");
 const share = createReactNativeShare();
 const link = await share.createLink("intoss://my-app/about", "https://cdn/og.png");
 
-// 3. Share sheet: "closed" means the sheet flow ended — nothing more.
+// 3. Share sheet: "completed" means the SDK share call finished — nothing more.
 const uiResult = await share.sendMessage(`check this out ${link}`);
-// uiResult.status: "closed" | "failed" — closed does NOT prove the user
-// shared and never grants share-reward eligibility.
+// uiResult.status: "completed" | "failed" — completed does NOT prove the
+// user shared and never grants share-reward eligibility.
 ```
 
 Contracts:
@@ -186,8 +191,10 @@ Contracts:
 - **Share links** validate the documented `intoss://` path contract
   (`INVALID_SHARE_PATH` otherwise) and pass the resolved link through
   verbatim. OG image generation is the consumer's concern.
-- **Share sheet** resolution is `closed`, not "completed" — reward grants
-  and completion tracking stay with the consumer.
+- **Share sheet** resolution is `completed`, meaning ONLY that the SDK share
+  call finished — the underlying SDKs do not report whether the sheet opened,
+  closed, or the user actually shared. Reward grants and completion tracking
+  stay with the consumer. (Renamed from `closed` in 0.3.0; see Migrating.)
 - Unsupported surfaces/app versions reject with `SdkError("UNSUPPORTED")`.
 
 ## React Native full-screen ads
@@ -216,7 +223,16 @@ Behavior:
   are single-use: after a show flow ends (rewarded, dismissed, failed,
   timeout), a fresh load is required.
 - The whole show flow has one deadline (`showTimeoutMs`, default 60s);
-  `loadTimeoutMs` (default 30s) bounds loads.
+  `loadTimeoutMs` (default 30s) bounds loads. The deadline is a single
+  budget covering SDK loading AND the provider event flow: a loader that
+  consumes most of it leaves only the remainder for the event wait, and a
+  fully consumed budget never registers with the provider. Timeout results
+  come from the event flow's own deadline, so the subscription is cleaned
+  up before the timeout settles — no orphaned listener outlives the call.
+- Slot updates land inside the returned promise's settlement: a failed
+  load frees its slot before the caller's `catch` resumes (an immediate
+  retry starts a fresh registration), and a successful load is promoted
+  before the caller's `await` resumes (an immediate show works).
 - Missing or failed-to-import framework → `SdkError("SDK_UNAVAILABLE")`;
   unsupported app versions → `SdkError("UNSUPPORTED")`. Load failures are
   never permanently cached — a later call retries the import.
@@ -234,3 +250,156 @@ notification and sharing.)
 
 `@ait-kit/sdk` is versioned independently from the server API packages
 (`@ait-kit/api-*`), which release in lockstep with each other.
+
+## Verified official SDK versions
+
+The adapters are developed and continuously checked against these exact
+official releases (see `scripts/test-package-tarballs.mjs`):
+
+| Official package | Verified version | Peer range |
+|---|---|---|
+| `@apps-in-toss/framework` (RN) | 2.10.10 | `>=2.10.10` |
+| `@apps-in-toss/web-framework` (Web) | 3.4.0 | `>=3.4.0` |
+
+Older versions may work where the runtime surfaces match (every capability
+is checked per function and missing ones reject with `UNSUPPORTED`), but
+only the versions above are verified. Newer versions are expected to work
+via the same structural checks; if an official export shape changes, the
+per-operation errors surface it instead of silent misbehavior.
+
+## Migrating
+
+### 0.3.0 — share sheet result `closed` → `completed`
+
+`sendMessage` now resolves `{ status: "completed" }` instead of
+`{ status: "closed" }`. The meaning also got precise: `completed` states
+only that the SDK share **call** finished. It does not prove the share
+sheet opened or closed, that the user shared, or that any reward
+eligibility was earned. Update any `status === "closed"` checks; failure
+results (`status: "failed"` with `code`/`reason`) are unchanged.
+
+### 0.3.0 — RN adapters call the official export shapes
+
+The React Native default loaders now convert the official flat exports
+(`appLogin`, `getAnonymousKey`, `requestNotificationAgreement`,
+`getTossShareLink`, `share`) into the shared adapter contracts. Previously
+a correctly installed official RN SDK still produced
+`SdkError("UNSUPPORTED")` for these five capabilities because the loaders
+looked for the web SDK's namespaced shapes. Custom `framework` injections
+using the internal namespaced contract or a loader keep working unchanged.
+
+One error-mapping change rides along: the official RN `getAnonymousKey()`
+resolving `undefined` (installed app below the feature's minimum version)
+now rejects with `SdkError("UNSUPPORTED")` instead of
+`INVALID_ANONYMOUS_KEY`; the `"ERROR"` sentinel still rejects with
+`INVALID_ANONYMOUS_KEY`.
+
+## Review requests
+
+```ts
+import { createReactNativeReview } from "@ait-kit/sdk/rn";
+// Web: import { createWebReview } from "@ait-kit/sdk/web";
+const review = createReactNativeReview(); // share one instance across screens
+if (await review.isSupported()) await review.request();
+```
+
+`ReviewAdapter` is a runtime-neutral root type. Factories accept `framework`
+(shared `Review.request` contract or async loader), like the existing adapters.
+RN translates the official `requestReview()` export; Web calls `Review.request()`.
+The official SDK loads only on use. Missing features/support checkers return
+`false`; import failure throws `SDK_UNAVAILABLE`; support-check exceptions propagate.
+`request()` rechecks support and throws `UNSUPPORTED` when unavailable.
+Concurrent requests on one instance share one Promise, cleared after success or
+failure. There is no retry or timeout.
+
+`Promise<void>` completion does not establish whether UI appeared or a review
+was written. Never grant rewards, unlock features, or block navigation on review
+completion. Complete and persist the core action first, then start a separately
+error-handled review request without awaiting it in the core flow. The consumer
+owns request timing, session limits, cooldowns and storage. Do not log raw SDK
+errors by default.
+
+Official reference: [Review.request](https://developers-apps-in-toss.toss.im/documentation/sdk/domains-api/review/review.request.md)
+(Android/iOS Toss 5.253.0+, checked by the SDK). Verified package surfaces:
+RN 2.10.10 and Web 3.4.0. Device UI behavior requires separate manual verification;
+unit/tarball tests use injected SDKs or a stubbed native bridge.
+
+## Explicit direct promotion rewards
+
+```ts
+import { createReactNativePromotion } from "@ait-kit/sdk/rn";
+// Web: import { createWebPromotion } from "@ait-kit/sdk/web";
+const promotion = createReactNativePromotion({ timeoutMs: 15_000 });
+const support = await promotion.getSupport();
+// RN 2.10.10 exposes no support checker: support is "unknown", not "supported".
+// Opt into direct grants explicitly, with app-specific eligibility/budget checks.
+```
+
+`PromotionAdapter`, `PromotionSupport`, `PromotionGrantInput` and
+`PromotionGrantResult` are runtime-neutral root types. Both factories accept
+`framework` (shared `Promotion.grantReward` contract or async loader).
+RN calls `grantPromotionReward({ params: { promotionCode, amount } })`;
+Web calls only `Promotion.grantReward({ promotionCode, amount })`.
+There is no legacy Web fallback or fallback to/from server payment flows.
+
+`getSupport()` reports `unsupported` for missing functions or an explicit false
+check, `supported` for a true check, and `unknown` when a function has no checker.
+Import failures throw `SDK_UNAVAILABLE`; support-check exceptions propagate.
+Every grant rechecks support. RN's documented `undefined` and the provider's
+`UNSUPPORTED_APP_VERSION` throw `UNSUPPORTED`; malformed Web responses stay unknown.
+
+Input errors throw `INVALID_PROMOTION_INPUT` before loading/calling the SDK:
+`promotionCode` must be non-empty without surrounding whitespace (never trimmed
+into a different code), and `amount` must be a positive safe integer. Campaign
+eligibility, maximum amounts and budgets remain the consumer's responsibility.
+
+Results:
+
+- `granted` has a non-empty `rewardKey` and means only that the SDK reported success.
+- `rejected` carries an explicit documented refusal code: `4100`, `4104`, `4105`,
+  `4108`, `4109`, `4110`, `4112`, or `4114`.
+- `unknown` means confirmation is required: SDK exceptions/sentinels, malformed or
+  contradictory responses, deadlines, `UNKNOWN_ERROR`, `4113`, or new provider
+  codes. `4113` never becomes an inferred already-granted ledger state.
+
+Provider messages and raw errors are not included in grant results. Provider codes
+are retained only as bounded uppercase alphanumeric/underscore tokens; do not log
+reward keys, promotion codes or whole SDK responses.
+
+Share one adapter instance. A concurrent grant throws `PROMOTION_IN_PROGRESS`;
+completed results are never cached as idempotent payments. `timeoutMs` defaults to
+0 (disabled), accepts integers through 2147483647, and covers loading and the SDK
+call. Elapsed time is checked before dispatch and when the SDK settles, so delayed
+timer callbacks cannot start an overdue payment or turn a late result into success.
+After timeout the result is unknown, but the instance stays locked until the
+actual operation settles. A loader finishing after timeout never starts payment.
+A late success/failure cannot change the returned timeout result. There is no
+cancellation, automatic retry, or protection across instances/devices/restarts.
+
+Consumer UI pattern (all callbacks are supplied by the app):
+
+```ts
+async function grantOnce(input, ui) {
+  ui.disableGrantAction();
+  try {
+    const result = await promotion.grantReward(input);
+    if (result.status === "unknown") {
+      ui.showConfirmationRequired(); // keep disabled; never retry automatically
+      return;
+    }
+    ui.showSdkResult(result); // client report only; not a server ledger receipt
+  } catch {
+    ui.showConfirmationRequired(); // do not dump raw exceptions or auto-reenable
+  }
+}
+```
+
+Posting a client result to a server is not independent payment verification.
+Consumers requiring a server ledger must keep their existing three-stage server
+payment path. This API does not require client-side mTLS certificates/proxy tokens
+and does not replace TrailBase claims or owned-currency accounting.
+
+Official reference: [Promotion.grantReward](https://developers-apps-in-toss.toss.im/documentation/sdk/domains-api/promotion/promotion.grantreward.md).
+Contracts are checked against RN 2.10.10 and Web 3.4.0 published types/code with
+synthetic bridge fixtures. Device checks and official test-promotion calls remain
+manual; no real promotion is invoked by tests.

package/dist/index.d.ts

@@ -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_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";
 /**
@@ -62,12 +62,14 @@ export type SdkNotificationAgreementResult = {
     reason?: string;
 };
 /**
- * Result of opening the share UI. `closed` means the native share sheet
- * flow ended normally — it does NOT prove the user actually shared, and it
- * never grants share-reward eligibility on its own.
+ * Result of opening the share UI. `completed` means ONLY that the SDK share
+ * call finished — it does NOT prove the share sheet opened or closed, that
+ * the user actually shared, and it never grants share-reward eligibility.
+ * (Renamed from `closed` in 0.3.0: the underlying SDKs guarantee the call
+ * completing, not the sheet's lifecycle.)
  */
 export type SdkShareUiResult = {
-    status: "closed";
+    status: "completed";
 } | {
     status: "failed";
     code?: string;
@@ -212,4 +214,6 @@ 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";
 //# 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":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,mDAAmD;AACnD,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,CAAC;AAMzB,mEAAmE;AACnE,MAAM,MAAM,4BAA4B,GAAG,cAAc,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GACtC;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC,4BAA4B,EAAE,mBAAmB,CAAC,CAAC;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,GACD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,uEAAuE;IACvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAMD,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAC9E,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,GAAG,kBAAkB,GAAG,WAAW,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,CAAC,EAAE,2BAA2B,CAAC;IAC3C,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAClG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAKtF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,mBAAmB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClF,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,mBAAmB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAClF,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,gDAAgD;AAChD,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,YAAY,CAAC;IAEnB,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAI7E;CACF;AAED,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}

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/promotion/platform-contract.js

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

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 {};

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

@@ -1 +1 @@
-{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/rn/ads.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAClD,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5D;AAWD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAuLxF"}
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/rn/ads.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAClD,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5D;AAmED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAqKxF"}