@tinkerlandai/longplay-sdk 0.0.0-stage → 0.10.4

package/dist/openrouter.d.ts

@@ -0,0 +1,43 @@
+import { OpenRouter } from '@openrouter/sdk';
+import { ChatUsage } from '@openrouter/sdk/models';
+import { F as FoundationApi } from './api-5gAz4-Sb.js';
+import { c as createAiPricing, A as AiUsageContext, a as AiTokenUsage, b as AiTokenQuote } from './ai-usage-Btwg1nD7.js';
+import './screen-D81zCpfi.js';
+import 'zod';
+import 'zod/v4';
+import '@ai-sdk/provider';
+
+type OpenRouterUsageRecord = {
+    context: AiUsageContext;
+    generationId: string | null;
+    modelId: string | null;
+    usage: ChatUsage | null;
+    tokens: AiTokenUsage | null;
+    quote: AiTokenQuote | null;
+    receipt: Awaited<ReturnType<FoundationApi["mutateBalance"]>> | null;
+    phase: "captured" | "quoted" | "settled" | "incomplete";
+};
+type OpenRouterUsageOptions = {
+    openRouter: OpenRouter;
+    pricing: ReturnType<typeof createAiPricing>;
+    client: Pick<FoundationApi, "mutateBalance">;
+    context: () => AiUsageContext | Promise<AiUsageContext>;
+    persist: (record: OpenRouterUsageRecord) => Promise<void>;
+    reasoning: "output" | "separate";
+    mapTokens?: (usage: ChatUsage) => AiTokenUsage;
+};
+type OpenRouterTrackOptions = Pick<OpenRouterUsageOptions, "pricing" | "client" | "persist" | "reasoning" | "mapTokens"> & {
+    context: AiUsageContext;
+    generationId: string;
+    /** Actual provider response model, without the openrouter/ provider prefix. */
+    modelId: string;
+    usage: ChatUsage;
+    /** Use the saved quoted record for a retry; never reprice an uncertain settlement. */
+    quote?: AiTokenQuote;
+};
+/** Settle a saved current OpenRouter usage response without calling the model again. */
+declare function trackOpenRouterUsage(options: OpenRouterTrackOptions): Promise<OpenRouterUsageRecord>;
+/** Wrap the current OpenRouter chat.send API. Persist raw usage before pricing or settlement. */
+declare function createOpenRouterUsageClient(options: OpenRouterUsageOptions): OpenRouter;
+
+export { type OpenRouterTrackOptions, type OpenRouterUsageOptions, type OpenRouterUsageRecord, createOpenRouterUsageClient, trackOpenRouterUsage };

package/dist/openrouter.js

@@ -0,0 +1 @@
+import"./chunk-YQHPEP4X.js";import"./chunk-2HFA34QO.js";import{qa as i}from"./chunk-ACF2FBUB.js";import"./chunk-G56XGVMS.js";import"./chunk-MRN4HP4W.js";import"./chunk-7DXL3LHT.js";import"./chunk-XSVQHPQT.js";import{z as k}from"zod";var c=k.number().int().min(0).max(1e9);function R(e,o){let a=c.parse(e.promptTokens),p=c.parse(e.completionTokens),s=c.parse(e.promptTokensDetails?.cachedTokens??0),t=c.parse(e.promptTokensDetails?.cacheWriteTokens??0),r=c.parse(e.promptTokensDetails?.audioTokens??0),l=c.parse(e.completionTokensDetails?.audioTokens??0),n=c.parse(e.completionTokensDetails?.reasoningTokens??0);if(c.parse(e.totalTokens)!==a+p||s+t+r>a||n+l>p||(e.promptTokensDetails?.videoTokens??0)>0)throw new i("AI_USAGE_UNAVAILABLE","Token pools must conserve usage; video needs an explicit token mapper");return{input:a-s-t-r,output:p-l-(o==="separate"?n:0),cache_read:s,cache_write:t,input_audio:r,output_audio:l,reasoning:o==="separate"?n:0}}function I(e){if(!Number.isFinite(e)||e<0)throw new i("AI_USAGE_UNAVAILABLE","Provider cost must be a nonnegative USD amount");let o=String(e),a=o.includes("e")?e.toFixed(18).replace(/0+$/,"").replace(/\.$/,""):o;if(!/^(0|[1-9]\d{0,11})(\.\d{1,18})?$/.test(a)||Number(a)!==e)throw new i("AI_USAGE_UNAVAILABLE","Provider cost exceeds the supported precision");return a}async function f(e){if(typeof window<"u")throw new i("SERVER_ONLY","OpenRouter accounting requires your backend");if(!["output","separate"].includes(e.reasoning)||!e.modelId||!e.generationId)throw new i("INVALID_REQUEST","Actual model, generation ID and reasoning pricing are required");let o={context:e.context,generationId:e.generationId,modelId:`openrouter/${e.modelId}`,usage:e.usage,tokens:null,quote:null,receipt:null,phase:"captured"};await e.persist(o);let a=e.mapTokens?e.mapTokens(e.usage):R(e.usage,e.reasoning),p=e.usage.cost==null?void 0:I(e.usage.cost),s=e.quote??await e.pricing.quoteTokens({modelId:o.modelId,tokens:a});if(s.pricing.modelId!==o.modelId||Object.keys(a).some(l=>a[l]!==s.tokens[l]))throw new i("INVALID_REQUEST","Saved quote must match the provider model and token pools");await e.persist({...o,tokens:a,quote:s,phase:"quoted"});let t=await e.pricing.trackTokens(e.client,{...e.context,quote:s,providerCostUsd:p,generationId:e.generationId});if(!t.receipt.accepted)throw new i("AI_BALANCE_REJECTED","OpenRouter usage was saved but the balance request was rejected");let r={...o,tokens:a,quote:s,receipt:t,phase:"settled"};return await e.persist(r),r}function T(e){if(typeof window<"u")throw new i("SERVER_ONLY","OpenRouter accounting requires your backend");if(!["output","separate"].includes(e.reasoning))throw new i("INVALID_REQUEST","Reasoning pricing is required");let o=e.openRouter.chat;async function a(t){if(!t.usage||!t.modelId||!t.generationId)throw new i("AI_USAGE_UNAVAILABLE","OpenRouter did not return final usage and the actual model");await f({...e,context:t.context,generationId:t.generationId,modelId:t.modelId.slice(11),usage:t.usage})}let p=async(t,r)=>{let n={context:await e.context(),generationId:null,modelId:null,usage:null,tokens:null,quote:null,receipt:null,phase:"incomplete"},d;try{d=await o.send(t,r)}catch(g){throw await e.persist(n),g}if(!(d instanceof ReadableStream)){if(n={...n,generationId:d.id,modelId:d.model?`openrouter/${d.model}`:null,usage:d.usage??null},!n.usage||!n.modelId)throw await e.persist(n),new i("AI_USAGE_UNAVAILABLE","OpenRouter omitted final accounting");return await a(n),d}let w=d.getReader(),m=!1;return new ReadableStream({async pull(g){try{let{value:u,done:A}=await w.read();if(A){if(m=!0,!n.usage||!n.modelId)throw await e.persist(n),new i("AI_USAGE_UNAVAILABLE","OpenRouter stream ended without final accounting");await a(n),g.close();return}if(u.error)throw new i("AI_PROVIDER_ERROR",u.error.message);u.usage&&(n={...n,generationId:u.id,modelId:u.model?`openrouter/${u.model}`:null,usage:u.usage}),g.enqueue(u)}catch(u){m||(m=!0,await e.persist(n)),await w.cancel(u),g.error(u)}},async cancel(g){m||(m=!0,await e.persist(n)),await w.cancel(g)}})},s=new Proxy(o,{get(t,r){return r==="send"?p:Reflect.get(t,r,t)}});return new Proxy(e.openRouter,{get(t,r){return r==="chat"?s:Reflect.get(t,r,t)}})}export{T as createOpenRouterUsageClient,f as trackOpenRouterUsage};

package/dist/page.d.ts

@@ -0,0 +1,134 @@
+import { a as ConfigurationSync } from './configuration-sync-CywDxRkX.js';
+import { J as JsonValue, R as Result } from './growth-rules-B4YYy64R.js';
+import { z } from 'zod';
+import './screen-D81zCpfi.js';
+
+/** GET /api/v1/page-experiments/{environmentId}: page experiments and the saved groups they reference only. */
+declare const pageExperimentPayloadSchema: z.ZodObject<{
+    environmentId: z.ZodUUID;
+    trackExposures: z.ZodBoolean;
+    generation: z.ZodString;
+    experiments: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            attribute: z.ZodOptional<z.ZodString>;
+            seed: z.ZodString;
+            hashVersion: z.ZodLiteral<2>;
+            ranges: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strict>>>;
+        condition: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        force: z.ZodOptional<z.ZodNumber>;
+        hashAttribute: z.ZodOptional<z.ZodString>;
+        seed: z.ZodOptional<z.ZodString>;
+        hashVersion: z.ZodOptional<z.ZodLiteral<2>>;
+        ranges: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        urlPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            include: z.ZodBoolean;
+            type: z.ZodEnum<{
+                regex: "regex";
+                simple: "simple";
+            }>;
+            pattern: z.ZodString;
+        }, z.core.$strict>>>;
+        persistQueryString: z.ZodOptional<z.ZodBoolean>;
+        parentConditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            condition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+            gate: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        weights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        coverage: z.ZodOptional<z.ZodNumber>;
+        fallbackAttribute: z.ZodOptional<z.ZodString>;
+        disableStickyBucketing: z.ZodOptional<z.ZodBoolean>;
+        bucketVersion: z.ZodOptional<z.ZodNumber>;
+        minBucketVersion: z.ZodOptional<z.ZodNumber>;
+        meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            passthrough: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        changeId: z.ZodString;
+        variations: z.ZodArray<z.ZodObject<{
+            urlRedirect: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    savedGroups: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"hashed">;
+        attributeKey: z.ZodString;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"list">;
+        attributeKey: z.ZodString;
+        values: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"condition">;
+        condition: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+type PageExperimentPayload = z.infer<typeof pageExperimentPayloadSchema>;
+
+/**
+ * Page experiments for anonymous merchant pages (docs/growthbook-sdk-delivery.md): URL redirect experiments delivered
+ * by a public App environment ID. Assignment, URL targeting and query-string overrides use the vendored GrowthBook
+ * engine; the exposure is sent before navigating and kept until acknowledged. The environment ID is public and never
+ * authenticates anything.
+ */
+type PageExperimentsOptions = {
+    configuration?: ConfigurationSync;
+    /** The public App environment ID shown in the console. */
+    environmentId: string;
+    /** Indiana API origin; defaults to https://api.longplayai.com. */
+    baseUrl?: string;
+    /** Extra targeting attributes; they win over the automatic ones. */
+    attributes?: Record<string, JsonValue>;
+    /** Override navigation (default `location.replace`). */
+    navigate?: (url: string) => void;
+    /** Minimum wait before navigating; default 100 ms with the default navigation, 0 with a custom one. */
+    navigateDelay?: number;
+    /** Longest wait for the exposure to be sent before navigating anyway; default 1000 ms. */
+    maxNavigateDelay?: number;
+    /** Skip redirects whose destination is on another host or protocol. */
+    disableCrossOriginUrlRedirects?: boolean;
+    /** Set false to evaluate without recording exposures. */
+    trackExposures?: boolean;
+    /** First-party cookie that keeps the anonymous device id (default `indiana_did`). */
+    deviceIdCookie?: string;
+    fetch?: typeof globalThis.fetch;
+    log?: (message: string, details: Record<string, unknown>) => void;
+};
+type Redirect = {
+    urlRedirect: string;
+};
+/** sdk-js util mergeQueryStrings: the current page's query parameters the destination does not set itself. */
+declare function mergeQueryStrings(oldUrl: string, newUrl: string): string;
+/** autoAttributesPlugin getAutoAttributes: id, URL parts, page title, browser, device type and UTM parameters. */
+declare function pageAttributes(id: string, location: Location | URL): {
+    id: string;
+    deviceId: string;
+    url: string;
+    path: string;
+    host: string;
+    query: string;
+    pageTitle: string;
+    browser: string;
+    deviceType: string;
+};
+/** Structural check of the page payload (the full schema lives in @indiana/contracts gb-page.ts). */
+declare function readPayload(value: unknown): PageExperimentPayload;
+declare function createPageExperiments(options: PageExperimentsOptions): {
+    /** Loads the payload, runs the page experiments and starts following navigation. */
+    start(): Promise<void>;
+    /** Reloads the payload and re-runs (for example after the console published a change). */
+    refresh(): Promise<void>;
+    setAttributes(attributes: Record<string, JsonValue>): void;
+    /** The latest assignment per experiment key. */
+    getResults(): Map<string, Result<Redirect>>;
+    readonly generation: string | null;
+    /** Stops following navigation and sends pending exposures. */
+    destroy(): void;
+};
+type PageExperiments = ReturnType<typeof createPageExperiments>;
+
+export { type PageExperiments, type PageExperimentsOptions, createPageExperiments, mergeQueryStrings, pageAttributes, readPayload };

package/dist/page.js

@@ -0,0 +1 @@
+import{d as o,e as r,f as e,g as f}from"./chunk-VMM3GA3L.js";import"./chunk-HOW7NIIR.js";import"./chunk-DSPLGTQI.js";import"./chunk-MRN4HP4W.js";import"./chunk-XSVQHPQT.js";export{f as createPageExperiments,o as mergeQueryStrings,r as pageAttributes,e as readPayload};

package/dist/paywall-EJCNWDHK.js

@@ -0,0 +1 @@
+import{b as Z}from"./chunk-SSLZKIIU.js";import{M as B}from"./chunk-2HFA34QO.js";import{L as V,i as G,ma as W,oa as X,qa as w}from"./chunk-ACF2FBUB.js";import{a as j}from"./chunk-DSPLGTQI.js";import"./chunk-G56XGVMS.js";import"./chunk-MRN4HP4W.js";import"./chunk-7DXL3LHT.js";import"./chunk-XSVQHPQT.js";async function ee(b,n,y){if(n.status!=="complete")throw new w("INVALID_RESPONSE","A verified completed purchase is required");if(await y.onComplete?.(n),!b||!y.check)return;let R=V.parse(await y.check());if(R.internal_feature_id!==b.internal_feature_id||R.quantity!==b.quantity)throw new w("INVALID_RESPONSE","The access requirement changed");R.allowed&&await y.onAccessGranted?.(R)}async function fe(b,n){let y=n.check?V.parse(await n.check()):null;if(y?.allowed)return await n.onAccessGranted?.(y),{check:y,host:null};let R=Z(b.ownerDocument),r=await n.start(),E=r.view??await r.refresh();if(!E)throw new w("INVALID_RESPONSE","Paywall presentation is missing");let{mountScreenPreview:te}=await import("./screen-renderer-JMHV4GPP.js"),c=b.ownerDocument,_=new AbortController,C=c.createElement("section"),K=c.createElement("div"),D=c.createElement("div"),g=c.createElement("p"),u=c.createElement("button"),M=c.createElement("button"),d=c.createElement("dialog"),i=E.document.screen.strings.defaultLocale.startsWith("zh");C.dataset.indianaPaywall="",C.setAttribute("aria-label",E.document.name),C.style.cssText="width:100%;box-sizing:border-box;background:#fff;color:#172033;font:14px/1.5 system-ui,sans-serif",D.style.cssText="display:flex;gap:12px;padding:12px 20px;align-items:center;flex-wrap:wrap",g.setAttribute("role","status"),M.textContent=i?"\u5173\u95ED":"Close",u.textContent=i?"\u91CD\u8BD5":"Retry",u.hidden=!0,D.append(g,u,M),C.append(K,D);let L=E.document.presentation,O,p=!1,$=!1,f=null,Y=!1,m=()=>!Y&&n.canInteract?.()!==!1,q=!1,a=null,U=null,Q=new Map;async function H(e){if(!(!m()||!e.checkoutUrl||Q.get(e.operationId)===e.checkoutUrl)){Q.set(e.operationId,e.checkoutUrl);try{n.onCheckoutUrl?await n.onCheckoutUrl(e.checkoutUrl):c.defaultView?.location.assign(e.checkoutUrl)}catch(o){throw Q.delete(e.operationId),o}}}let N=e=>{g.textContent=e instanceof Error?e.message:i?"\u8BF7\u6C42\u5931\u8D25":"Request failed",j(n.onError,e),u.hidden=a===null};async function k(e){if(!($||p||!m())){$=!0,u.hidden=!0,g.textContent="";try{await e()}catch(o){p||N(o)}finally{$=!1}}}async function ne(e){await ee(y,e,n)}async function v(e){if(p)return;if(!m()){a=async()=>v(await r.read()),u.hidden=!1;return}if(g.textContent=e.status,e.problem){let t=e.problem;a=T,u.textContent=i?"\u68C0\u67E5\u5E76\u6062\u590D\u539F\u64CD\u4F5C":"Check and recover original purchase",N(new w(t.code,t.reason==="RESULT_UNKNOWN"?i?"\u4ED8\u6B3E\u7ED3\u679C\u5C1A\u672A\u786E\u5B9A\uFF0C\u8BF7\u6062\u590D\u539F\u64CD\u4F5C\uFF0C\u6682\u52FF\u91CD\u590D\u8D2D\u4E70\u3002":"The payment result is unknown. Recover the original purchase before buying again.":t.phase==="fulfillment"?i?"\u4ED8\u6B3E\u5DF2\u8BB0\u5F55\uFF0C\u5546\u6237\u6743\u76CA\u5904\u7406\u9700\u8981\u6838\u5BF9\u3002":"Payment was recorded. Access fulfillment needs attention.":t.code==="CAPABILITY_UNAVAILABLE"?i?"\u5546\u6237\u5C1A\u4E0D\u652F\u6301\u672C\u6B21\u8D2D\u4E70\u6240\u9700\u7684\u5B8C\u6574\u80FD\u529B\uFF0C\u8BF7\u5904\u7406\u540E\u6062\u590D\u539F\u64CD\u4F5C\u3002":"The merchant does not currently support all actions required by this purchase. Recover the original purchase after this is resolved.":t.code==="NOT_CONFIGURED"?i?"\u4ED8\u6B3E\u670D\u52A1\u8FDE\u63A5\u9700\u8981\u5904\u7406\uFF0C\u8BF7\u8054\u7CFB\u5546\u6237\u540E\u6062\u590D\u539F\u64CD\u4F5C\u3002":"The payment connection needs attention. Contact the merchant, then recover the original purchase.":i?"\u539F\u8D2D\u4E70\u64CD\u4F5C\u9700\u8981\u5904\u7406\uFF0C\u8BF7\u67E5\u8BE2\u6216\u6062\u590D\u6B64\u64CD\u4F5C\u3002":"The original purchase needs attention. Check or recover this operation.",void 0,void 0,t));return}if(e.merchantExecution?.type==="purchase"&&e.merchantExecution.paymentStatus==="succeeded"&&!["applied","not_applicable"].includes(e.merchantExecution.fulfillmentStatus)&&(g.textContent=i?"\u4ED8\u6B3E\u5DF2\u8BB0\u5F55\uFF0C\u6B63\u5728\u7B49\u5F85\u5546\u6237\u5B8C\u6210\u5904\u7406\u3002":"Payment was recorded. Waiting for merchant fulfillment."),e.status==="complete"){a=null,await ne(e);return}if(e.status!=="pending"){if(r.canReselect===!1){g.textContent=i?"\u6B63\u5728\u6838\u5BF9\u539F\u8D2D\u4E70\u7ED3\u679C":"Checking the original purchase result",u.textContent=i?"\u67E5\u8BE2\u7ED3\u679C":"Check result",a=async()=>v(await r.read()),u.hidden=!1;return}u.textContent=i?"\u91CD\u8BD5":"Retry",a=null,f=null;return}await H(e);let o=Date.now()+6e5,l=2e3;for(;!p&&Date.now()<o;){if(await new Promise(h=>{let P=()=>{clearTimeout(I),h()},I=setTimeout(()=>{_.signal.removeEventListener("abort",P),h()},l);_.signal.addEventListener("abort",P,{once:!0})}),p)return;if(!m()){a=async()=>v(await r.read()),u.hidden=!1;return}let t=await r.read();if(!t.problem&&t.status==="pending"&&await H(t),t.status!=="pending"||t.problem){await v(t);return}l=Math.min(l*1.5,3e4)}a=async()=>v(await r.read()),u.hidden=!1}async function T(){U?.remove(),U=null,a=T;let e=await r.confirm();if(!m()){a=T,u.hidden=!1;return}if(e.problem){await v(e);return}if(e.status==="pending"){if(e.checkoutUrl)await H(e);else if(e.execution&&e.execution.provider!=="merchant"||e.nativePurchase){if(!n.onPurchase)throw new w("PURCHASE_HANDLER_REQUIRED","Provide the merchant or native purchase handler");await n.onPurchase({operation:e,signal:_.signal})}}a=async()=>v(await r.read()),await v(e)}function re(e){U?.remove();let o=c.createElement("div"),l=c.createElement("button"),t=c.createElement("button"),h=c.createElement("p");h.textContent=e.lines.map(s=>s.productName).join(", ")+" \xB7 "+G(e.charge?.totalMinor??e.catalogAmountMinor-(e.discount?.amountMinor??0),e.currency),l.textContent=i?"\u786E\u8BA4\u8D2D\u4E70":"Confirm purchase",t.textContent=i?"\u53D6\u6D88":"Cancel",l.onclick=()=>{k(T)};let P=async()=>{let s=await r.cancel();p||(o.remove(),U=null,await v(s))};t.onclick=()=>{a=P,k(P)};let I=c.createElement("div");for(let s of e.lines){let J=c.createElement("p");J.textContent=`${s.productName} \xB7 ${G(s.catalogAmountMinor,e.currency)}${W(s.interval,i?"zh-CN":"en",s.intervalCount??1)}`,I.append(J);for(let x of s.prepaid??[]){let F=c.createElement("p"),A=r.view?.capabilities.plans[s.productVersionId]?.prepaid?.find(ae=>ae.internalFeatureId===x.internal_feature_id);F.textContent=`${A?.name??x.internal_feature_id} \xB7 ${x.quantity} ${i?"\u4EFD":"packs"} \xD7 ${x.terms.units}`,A&&(F.textContent+=W(A.reset==="week"||A.reset==="month"||A.reset==="year"?A.reset:"one_time",i?"zh-CN":"en",A.resetCount)),I.append(F)}if(s.trial){let x=c.createElement("p");x.textContent=i?`\u8BD5\u7528 ${s.trial.days} \u5929\uFF1B${s.trial.cardRequired?"\u9700\u8981\u63D0\u4F9B\u4ED8\u6B3E\u65B9\u5F0F":"\u65E0\u9700\u63D0\u4F9B\u4ED8\u6B3E\u65B9\u5F0F"}`:`Trial days: ${s.trial.days}; ${s.trial.cardRequired?"a payment method is required":"no payment method is required"}`,I.append(x)}}if(!e.charge){let s=c.createElement("p");s.textContent=i?"\u76EE\u5F55\u4EF7\u683C\uFF1B\u6700\u7EC8\u91D1\u989D\u4EE5\u7ED3\u8D26\u65F6\u7A0E\u8D39\u548C\u8BD5\u7528\u89C4\u5219\u4E3A\u51C6\u3002":"Catalog price; the final charge depends on checkout taxes and trial terms.",I.append(s)}o.append(h,I,l,t),D.prepend(o),U=o,a=null}async function z(){if(!f)return;if(a=z,!q){let o=r.view,l=o?.document.buttons[f.actionId],t=o&&l?.type==="checkout"?B(l.product,f.selection,o.capabilities):null;if(!t)throw new w("PRODUCT_UNAVAILABLE","Choose an available Product in this purchase area");let h=await n.resolveOfferId?.({actionId:f.actionId,productVersionId:t});if(p)return;h!==void 0&&(f.offerId=h),q=!0}if(!m()){u.hidden=!1;return}let e=await r.preview(f);p||re(e)}function S(e="destroy"){p||(p=!0,_.abort(),O?.destroy(),r.destroy(),d.open&&d.close(),d.remove(),C.remove(),R(),e==="dismiss"&&j(n.onDismiss))}M.onclick=()=>{m()&&S("dismiss")},d.addEventListener("cancel",e=>{e.preventDefault(),m()&&S("dismiss")}),u.onclick=()=>{a&&k(a)};try{if(L.type==="inline")b.append(C);else{let e={sm:420,md:640,lg:900};d.style.cssText=`padding:0;border:0;max-width:calc(100vw - 32px);max-height:calc(100dvh - 32px);overflow:auto;width:${"size"in L?e[L.size]+"px":"100vw"}`,d.setAttribute("aria-label",E.document.name),d.append(C),b.append(d),m()&&d.showModal()}O=te(K,{mode:"live",rendererUrl:r.webViewUrl,title:E.document.name,onAction(e,o={}){if(!m())return;let l=r.view,t=l?.document.buttons[e];if(!t)return;if(t.type==="close"){k(async()=>{await n.onAction?.(e),S(n.onAction?"action":"dismiss")});return}if(t.type==="action"){a=async()=>{if(t.action.type==="event"){if(!n.onEvent)throw new w("EVENT_HANDLER_REQUIRED","Provide the event handler");await n.onEvent(t.action.event)}else n.onOpenUrl?await n.onOpenUrl(t.action.url):c.defaultView?.location.assign(t.action.url);await n.onAction?.(e),a=null},k(a);return}if((r.quote||f)&&r.canReselect===!1){a=r.quote?async()=>v(await r.read()):z,k(a);return}let h=l&&B(t.product,o,l.capabilities);if(!l||!h){N(new w("PRODUCT_UNAVAILABLE","Choose an available Product in this purchase area"));return}if(n.onPurchaseIntent){a=null,k(async()=>{let P={actionId:e,productVersionId:h,selection:structuredClone(o),featureQuantities:X(l.document.screen,h,o,l.capabilities)};await n.onPurchaseIntent(P)});return}if(f&&f.actionId!==e){N(new w("COMMAND_PENDING","Finish the current purchase"));return}f||(f={requestId:crypto.randomUUID(),actionId:e,selection:o},q=!1),k(z)},onEscape:()=>{m()&&S("dismiss")},onError:e=>N(new Error(e))}),O.update(E.document.screen,E.document.screen.strings.defaultLocale,{capabilities:E.capabilities,serverInput:{bindings:[],answers:{}}}),await O.ready}catch(e){throw S(),e}return{check:y,host:{setSuspended(e){Y=e,C.hidden=e,e&&d.open?d.close():!e&&!p&&L.type!=="inline"&&!d.open&&d.showModal()},destroy:S,refresh:async()=>{if(!m()){if(r.view)return r.view;throw new w("PRECONDITION_FAILED","Paywall presentation is suspended")}let e=await r.refresh();return p||O?.updateCapabilities(e.capabilities),e}}}}export{fe as showPaywall};

package/dist/popup.d.ts

@@ -0,0 +1,191 @@
+import { b as ScreenAction, c as ScreenNode, d as ScreenDocument } from './screen-D81zCpfi.js';
+import { O as Offer, a as OfferUnavailableReason } from './coupon-fA1QujHt.js';
+import { b as CustomerPageData, a as SurfaceData, c as ScreenParameters, d as ScreenRendererInput, S as ScreenAnswers, C as CustomerDataIntent } from './customer-page-km5f1PJZ.js';
+import { WindowLike } from 'dompurify';
+import 'zod';
+
+type PopupEvent = {
+    type: "shown";
+} | {
+    type: "action";
+    actionId: string;
+    nodeId?: string;
+    name: string;
+    properties: ScreenAction["properties"];
+    /** Presentation-only choices; validate actual prices and entitlements on the server. */
+    selection?: Record<string, string | boolean | number>;
+} | {
+    type: "closed";
+    reason: "close_button" | "escape" | "action" | "destroy" | "timeout";
+} | {
+    /** claim_offer 按钮的领取结果（showRemotePopup 才有；离线 showPopup 没有投放凭证，不能领取）。 */
+    type: "offer";
+    actionId: string;
+    offer: Offer | null;
+    reason: OfferUnavailableReason | "error" | null;
+};
+
+/**
+ * Render the current ScreenDocument 4 into DOM.
+ *
+ * 这个函数会被 `rendererRuntime.toString()` 序列化后放进沙箱 iframe（Web）或 WebView（iOS / Android）
+ * 里单独执行，所以**必须完全自包含**：不能引用函数外的任何变量、导入或辅助函数（类型除外）。
+ * packages/sdk/src/renderer/runtime.test.ts 会在没有模块作用域的环境里执行序列化结果来保证这一点。
+ *
+ * 安全：文案一律通过 textContent 写入；自定义 HTML 由宿主清洗后放进各自的 Shadow DOM；
+ * iframe 的 CSP 只允许执行带 nonce 的本脚本，不能联网，原生图片允许 https 或经过校验的有界内嵌 SVG/JPEG。
+ */
+type RendererMode = "live" | "editor";
+/** Host UI copy for editor controls, independent of the document content locale. */
+type RendererEditorMessages = {
+    emptyContainer?: string;
+    nodeTypes?: Partial<Record<ScreenNode["type"], string>>;
+};
+type ScreenNodeRect = {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** Editor shortcuts typed while focus is inside the canvas; the host owns their meaning. */
+type RendererEditorKey = {
+    key: string;
+    phase: "down" | "up";
+    meta: boolean;
+    ctrl: boolean;
+    shift: boolean;
+    alt: boolean;
+};
+
+/** Preserve authoritative decimal strings and localize their digits without rounding through Number. */
+declare function formatCustomerDecimal(value: string, locale: string): string;
+
+/**
+ * 自定义 HTML 块的内容策略（服务端发布、控制台预览、SDK 渲染共用）：
+ * 只允许排版类标签和 https 图片；不允许脚本、表单、链接、内联样式和事件属性；
+ * CSS 不允许外部资源、@import 和未知语法。按钮通过 data-grow-action 绑定文档里的动作。
+ * 结果是幂等的：清洗过的内容再清洗一次不变。
+ */
+declare function sanitizeCustomHtml(html: string, css: string, actionIds: readonly string[], window: WindowLike): {
+    html: string;
+    css: string;
+};
+type HtmlCodeDiagnostic = {
+    language: "html" | "css";
+    from: number;
+    to: number;
+    severity: "warning" | "error";
+    message: string;
+};
+/** Authoring diagnostics use the exact same sanitizer as publication and delivery. No relaxed preview policy. */
+declare function inspectCustomHtml(html: string, css: string, actionIds: readonly string[], window: WindowLike): {
+    html: string;
+    css: string;
+    diagnostics: HtmlCodeDiagnostic[];
+    valid: boolean;
+};
+/** Strict validation always runs; repeated pure design can reuse HTML/CSS preparation. */
+declare function prepareScreen(input: unknown, window: WindowLike): ScreenDocument;
+
+declare const hostedRendererShell: {
+    readonly tag: string;
+    readonly csp: string;
+    readonly html: string;
+};
+
+/** The bootstrap the shell's CSP hash authorizes. */
+declare function hostedRendererScript(): string;
+
+type PopupHandle = {
+    destroy: () => void;
+    updateCapabilities: (data: SurfaceData) => void;
+};
+/**
+ * Passive import. Call explicitly after obtaining an approved configuration.
+ * 接受完整文档（离线使用导出的发布版本）或下发的单语言文档；多语言时按 options.locale 与浏览器语言挑选。
+ */
+type PopupOptions = {
+    /** Hosted public shell, supplied by the current SDK gateway after authorization. */
+    rendererUrl?: string;
+    onError?: (error: unknown) => void;
+    locale?: string;
+    capabilities?: SurfaceData;
+    onEvent?: (event: PopupEvent) => void | Promise<void>;
+};
+type PreparedPopupHandle = PopupHandle & {
+    /** Resolves after the first rendered response, rather than the bridge handshake. */
+    ready: Promise<void>;
+    /** Display the prepared iframe in place. A handle is used for one presentation. */
+    show(): PopupHandle;
+};
+declare function showPopup(input: ScreenDocument, options?: PopupOptions): PopupHandle;
+/** Explicitly prepare an already-authorized screen before the opening click.
+ * Destroy on unmount or identity change. Preparation emits no display or action events. */
+declare function preparePopup(input: ScreenDocument, options?: PopupOptions): PreparedPopupHandle;
+type ScreenPreviewHandle = {
+    /** Rejects if the renderer cannot start; this does not grant customer authorization. */
+    ready: Promise<void>;
+    /** The document of the last update. */
+    readonly document: ScreenDocument | null;
+    /** 重新渲染（完整文档 + 当前编辑的语言；缺失的文案用默认语言淡显）。 */
+    update(doc: ScreenDocument, locale: string, 
+    /** Current single-screen presentation and server-owned input bindings. */
+    options?: {
+        parameters?: ScreenParameters;
+        capabilities?: SurfaceData;
+        customerData?: CustomerPageData;
+        serverInput?: ScreenRendererInput;
+        selection?: Record<string, string | boolean | number>;
+        /** Explicitly restart a live page even when its design and input are unchanged. */
+        reset?: boolean;
+    }): void;
+    updateCustomerData(data: CustomerPageData): void;
+    updateCapabilities(data: SurfaceData): void;
+    /** Resize the visible viewport without replacing the document or interaction state. */
+    resizeViewport(height: number): void;
+    /** 编辑模式下的悬停与选中描边。 */
+    highlight(hoverId: string | null, selectedId: string | null): void;
+    destroy(): void;
+};
+/**
+ * 控制台编辑器的画布：同一个渲染器，以「编辑模式」嵌在容器里（不是弹出层）。
+ * 点击选中、悬停高亮、双击进入文字编辑都通过回调告诉编辑器；按钮不会执行动作。
+ * mode 为 "live" 时按钮可点（翻译页等只读预览里用于查看交互），回调 onAction。
+ */
+declare function mountScreenPreview(container: HTMLElement, options?: {
+    mode?: RendererMode;
+    rendererUrl?: string;
+    title?: string;
+    /** Translate editor controls without changing authored text or the content locale. */
+    editorMessages?: RendererEditorMessages;
+    /** 固定模拟浏览器的高度；全屏铺满，其他展示方式在该视口内滚动。 */
+    viewportHeight?: number;
+    onHover?: (id: string | null) => void;
+    onSelect?: (id: string | null) => void;
+    onEdit?: (id: string) => void;
+    onAction?: (actionId: string, selection?: Record<string, string | boolean | number>, answers?: ScreenAnswers) => void;
+    onSelection?: (selection: Record<string, string | boolean | number>) => void;
+    onAnswers?: (answers: ScreenAnswers) => void;
+    onRendered?: () => void;
+    /** Live previews report the page actually rendered, when the current screen is rendered. */
+    onPageChange?: (pageId: string) => void;
+    onEscape?: () => void;
+    onResize?: (height: number) => void;
+    /** Editing-only geometry in iframe viewport coordinates; no DOM access across the sandbox. */
+    onLayout?: (nodes: ScreenNodeRect[]) => void;
+    /** Editing-only shortcuts typed while focus is inside the canvas. */
+    onKey?: (key: RendererEditorKey) => void;
+    /** Editing-only pinch or ctrl + wheel zoom; positive deltas zoom out. */
+    onZoom?: (delta: number) => void;
+    onError?: (message: string) => void;
+    onCustomerDataIntent?: (intent: CustomerDataIntent) => void;
+}): ScreenPreviewHandle;
+type CustomerPageHandle = {
+    versionId: string;
+    refresh(): Promise<void>;
+    snapshot(): CustomerPageData;
+    destroy(): void;
+};
+
+export { type CustomerPageHandle, type HtmlCodeDiagnostic, type PopupEvent, type PopupHandle, type PopupOptions, type PreparedPopupHandle, type RendererEditorKey, type RendererEditorMessages, ScreenDocument, type ScreenNodeRect, type ScreenPreviewHandle, formatCustomerDecimal, hostedRendererScript, hostedRendererShell, inspectCustomHtml, mountScreenPreview, preparePopup, prepareScreen, sanitizeCustomHtml, showPopup };

package/dist/popup.js

@@ -0,0 +1 @@
+import{a as o,b as r,c as e,d as f,e as m,g as p,h as t,i as x,j as a}from"./chunk-X6BCUINI.js";import"./chunk-SSLZKIIU.js";import"./chunk-ACF2FBUB.js";import"./chunk-DSPLGTQI.js";import"./chunk-7DXL3LHT.js";import"./chunk-XSVQHPQT.js";export{p as formatCustomerDecimal,r as hostedRendererScript,o as hostedRendererShell,f as inspectCustomHtml,a as mountScreenPreview,x as preparePopup,m as prepareScreen,e as sanitizeCustomHtml,t as showPopup};