@wix/himalaya-cli 0.1142.0 → 0.1144.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/delivery-contract.d.ts

@@ -0,0 +1,104 @@
+import type { AppleTransaction, FinishTransactionResult, TransactionErrorCode, UnfinishedTransactionsResult, VerificationPurchaseResult } from "./index.js";
+/** Trusted host session snapshot. Not a credential: the backend adapter resolves real
+ *  credentials from its own authenticated transport, bound to this `generation`. */
+export interface SessionSnapshot {
+    /** Changes on every sign-in, sign-out, member or site change. */
+    generation: number;
+    kind: "member" | "visitor" | "owner" | "signedOut";
+}
+/** Supplied by the host, never by worker UI state. */
+export interface SessionProvider {
+    current(): SessionSnapshot;
+    /** Called after `current()` changes; returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+}
+/** A catalog item resolved by the backend for the captured member. */
+export interface PurchaseContext {
+    productId: string;
+    /** Canonical UUID the backend associates with this site/member. */
+    appAccountToken: string;
+    /** Opaque site/member scope the acknowledgement must echo. */
+    scopeKey: string;
+}
+/** The current member's association, used to recover purchases without a catalog item. */
+export interface MemberContext {
+    appAccountToken: string;
+    scopeKey: string;
+}
+export type ContextResult<T> = {
+    status: "ok";
+    context: T;
+} | {
+    status: "authRequired" | "rejected";
+} | {
+    status: "retryable";
+    retryAfterMs?: number;
+};
+/** Bound to one transaction and scope. Means verification AND durable access persistence
+ *  completed; an HTTP 2xx, a receipt or a job id is not an acknowledgement. */
+export interface ProcessingAcknowledgement {
+    transactionId: string;
+    productId: string;
+    environment: AppleTransaction["environment"];
+    scopeKey: string;
+}
+export type SubmitProofResult = {
+    status: "processed" | "alreadyProcessed";
+    acknowledgement: ProcessingAcknowledgement;
+} | {
+    status: "retryable";
+    retryAfterMs?: number;
+} | {
+    status: "authRequired" | "ownershipConflict" | "rejected";
+};
+/** PROPOSED backend agreement. Every call carries the session captured when the work
+ *  started, never whichever session is current when the request is sent. Responses are
+ *  decoded strictly; anything unrecognised is treated as invalid, never as success. */
+export interface DeliveryBackend {
+    getPurchaseContext(session: SessionSnapshot, catalogRef: string): Promise<ContextResult<PurchaseContext>>;
+    getMemberContext(session: SessionSnapshot): Promise<ContextResult<MemberContext>>;
+    /** Must be idempotent per store/environment/transaction id; delivery is at-least-once. */
+    submitProof(session: SessionSnapshot, transaction: AppleTransaction): Promise<SubmitProofResult>;
+}
+/** The three managed verbs; `appleManagedStore` in index.ts is the production binding. */
+export interface TransactionStore {
+    purchaseForVerification(input: {
+        productId: string;
+        appAccountToken: string;
+    }): Promise<VerificationPurchaseResult>;
+    getUnfinishedTransactions(): Promise<UnfinishedTransactionsResult>;
+    finishTransaction(input: {
+        transactionId: string;
+    }): Promise<FinishTransactionResult>;
+}
+export interface Clock {
+    /** Epoch milliseconds. */
+    now(): number;
+}
+export type DeliveryPhase = "idle" | "purchasing" | "awaitingApproval" | "cancelled" | "signInRequired" | "unavailable";
+/** `sessionChanged`: a purchase was requested under an earlier session and was not carried out. */
+export type DeliveryErrorCode = TransactionErrorCode | "contextUnavailable" | "contextRejected" | "proofRejected" | "sessionChanged";
+export type AccessStatus = "pending" | "confirming" | "waitingToRetry" | "signInRequired" | "ownershipConflict" | "rejected" | "confirmed";
+export type CompletionStatus = "pending" | "finished" | "notFound" | "retryRequired";
+/** Safe to render and persist: no proof, account token, transaction or member id. */
+export interface DeliveryItemState {
+    productId: string;
+    environment: AppleTransaction["environment"];
+    /** Present in the last native unfinished enumeration; null before one succeeded. */
+    held: boolean | null;
+    /** `confirmed` only from a matching acknowledgement for the current session. */
+    access: AccessStatus;
+    completion: CompletionStatus;
+    attempts: number;
+    nextAttemptAt: number | null;
+    errorCode: DeliveryErrorCode | null;
+}
+export interface DeliveryState {
+    phase: DeliveryPhase;
+    errorCode: DeliveryErrorCode | null;
+    items: DeliveryItemState[];
+    /** From the last successful enumeration; null when unknown or it failed. */
+    unfinishedCount: number | null;
+    /** Earliest `nextAttemptAt`; hosts schedule `tick()` for it (e.g. a worker `_poll`). */
+    nextWakeAt: number | null;
+}

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/delivery.d.ts

@@ -0,0 +1,33 @@
+import type { Clock, DeliveryBackend, DeliveryState, SessionProvider, TransactionStore } from "./delivery-contract.js";
+export interface PurchaseCoordinatorDependencies {
+    store: TransactionStore;
+    backend: DeliveryBackend;
+    session: SessionProvider;
+    clock: Clock;
+    /** Extra milliseconds added to a backoff step; inject for deterministic tests. */
+    jitter?: (baseDelayMs: number) => number;
+    /** Receives a fresh safe snapshot after every change. */
+    onState?: (state: DeliveryState) => void;
+}
+export interface PurchaseCoordinator {
+    /** Reconciles unfinished purchases now and again after every later session change. */
+    start(): Promise<DeliveryState>;
+    /** Buys a catalog item; the backend resolves its product id and account token.
+     *  The same member's purchase of the same item already in progress is shared, not repeated. */
+    purchase(catalogRef: string): Promise<DeliveryState>;
+    /** Re-enumerates unfinished purchases and delivers eligible ones (e.g. on resume). */
+    reconcile(): Promise<DeliveryState>;
+    /** Unblocks every waiting or blocked item with a fresh attempt budget, then reconciles. */
+    retry(): Promise<DeliveryState>;
+    /** Runs whatever retries are due at `clock.now()`. */
+    tick(): Promise<DeliveryState>;
+    getState(): DeliveryState;
+    /** Drops the session subscription and suppresses every later callback. */
+    dispose(): void;
+}
+/** Automatic attempts per item per reconciliation run; the item is never discarded after. */
+export declare const MAX_AUTOMATIC_ATTEMPTS = 5;
+export declare const MAX_RETRY_DELAY_MS = 60000;
+/** Creates a coordinator owned by the host/service lifecycle, not by a screen or render.
+ *  Closures, not classes: Tier-5 bundles must also evaluate on Hermes, which has no `class`. */
+export declare function createPurchaseCoordinator(deps: PurchaseCoordinatorDependencies): PurchaseCoordinator;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/iap/src/index.d.ts

@@ -1,3 +1,6 @@
+import type { TransactionStore } from "./delivery-contract.js";
+export * from "./delivery-contract.js";
+export * from "./delivery.js";
 /** The three store product categories. */
 export type ProductType = "subscription" | "nonConsumable" | "consumable";
 export interface Product {
@@ -132,3 +135,5 @@ export declare function getUnfinishedTransactions(): Promise<UnfinishedTransacti
 export declare function finishTransaction(input: {
     transactionId: string;
 }): Promise<FinishTransactionResult>;
+/** The managed native verbs as the delivery coordinator's store. */
+export declare const appleManagedStore: TransactionStore;