@revturbine/sdk 0.2.71 → 0.2.72

package/dist/headless.d.ts

@@ -2150,6 +2150,9 @@ declare const ClientContextSchema: z.ZodObject<{
         }>>>;
         provider_subscription_id: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    plan: z.ZodOptional<z.ZodObject<{
+        handle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         can_upgrade: z.ZodOptional<z.ZodBoolean>;
         can_manage_billing: z.ZodOptional<z.ZodBoolean>;
@@ -2993,6 +2996,7 @@ declare const SdkMetaEventTypeSchema: z.ZodEnum<{
     sdk_init: "sdk_init";
     sdk_error: "sdk_error";
     sdk_validation_warning: "sdk_validation_warning";
+    resolution_failure: "resolution_failure";
 }>;
 declare const SdkConfigShapeSchema: z.ZodObject<{
     plans: z.ZodNumber;
@@ -3009,6 +3013,7 @@ declare const SdkMetaEventSchema: z.ZodObject<{
         sdk_init: "sdk_init";
         sdk_error: "sdk_error";
         sdk_validation_warning: "sdk_validation_warning";
+        resolution_failure: "resolution_failure";
     }>;
     occurred_at: z.ZodString;
     request_id: z.ZodOptional<z.ZodString>;
@@ -3028,6 +3033,12 @@ declare const SdkMetaEventSchema: z.ZodObject<{
         surface_templates: z.ZodNumber;
     }, z.core.$strip>>;
     message: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    placement_handle: z.ZodOptional<z.ZodString>;
+    slot_handle: z.ZodOptional<z.ZodString>;
+    surface: z.ZodOptional<z.ZodString>;
+    plan_handle: z.ZodOptional<z.ZodString>;
+    entitlement_handle: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const SdkMetaIngestBatchSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodObject<{
@@ -3035,6 +3046,7 @@ declare const SdkMetaIngestBatchSchema: z.ZodObject<{
             sdk_init: "sdk_init";
             sdk_error: "sdk_error";
             sdk_validation_warning: "sdk_validation_warning";
+            resolution_failure: "resolution_failure";
         }>;
         occurred_at: z.ZodString;
         request_id: z.ZodOptional<z.ZodString>;
@@ -3054,6 +3066,12 @@ declare const SdkMetaIngestBatchSchema: z.ZodObject<{
             surface_templates: z.ZodNumber;
         }, z.core.$strip>>;
         message: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        placement_handle: z.ZodOptional<z.ZodString>;
+        slot_handle: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+        plan_handle: z.ZodOptional<z.ZodString>;
+        entitlement_handle: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const eventPaths: ZodOpenApiPathsObject;
@@ -12758,6 +12776,33 @@ declare class RevTurbineCustomerSdk {
     private warnPiiRedactedOnce;
     /** True when keyless anonymous telemetry should fire (REQ-4 conditions). */
     private anonymousTelemetryActive;
+    /**
+     * Session-scoped dedup for `resolution_failure` diagnostics (plan 144 Q-4
+     * disposition): one emit per `(reason, primary handle)` pair, capped per
+     * session so a render loop can never flood the channel.
+     */
+    private readonly emittedResolutionDiagnostics;
+    private static readonly RESOLUTION_DIAGNOSTIC_SESSION_CAP;
+    /**
+     * Gate for `resolution_failure` diagnostics (plan 144 TASK-21). Honors BOTH
+     * opt-outs (124 Q-6, decided 2026-08-12): either `anonymousTelemetry: false`
+     * or `analytics: false` silences diagnostics — the most conservative
+     * reading, so no privacy-minded install is surprised by a new emission.
+     * Unlike {@link anonymousTelemetryActive} there is NO keyless requirement:
+     * keyed production installs emit diagnostics too (124 Q-7). `previewMode`
+     * (docs/playground renders) still suppresses, and the channel is
+     * browser-only for now (server-side diagnostics are a named follow-up).
+     */
+    private diagnosticTelemetryActive;
+    /**
+     * Emit one `resolution_failure` diagnostic (plan 144 TASK-21 — the plan-124
+     * "silent failure" channel): a placement that resolved to the fallback, or
+     * an entitlement denied for infrastructure reasons, becomes observable on
+     * the keyless meta channel. Field values are author-defined handles and
+     * closed reason codes only (TASK-20 allow-list); deduped per
+     * `(reason, primary handle)` for the session and capped.
+     */
+    private emitResolutionFailure;
     /** Fire the one anonymous `sdk_init` adoption beacon at startup. */
     private emitSdkInitTelemetry;
     /**
@@ -12771,6 +12816,14 @@ declare class RevTurbineCustomerSdk {
      * non-throwing. Stamps SDK/schema versions + a one-way hashed config id.
      */
     private emitAnonMeta;
+    /**
+     * Ungated build + POST of one allowlisted meta event — the shared tail of
+     * {@link emitAnonMeta} (keyless adoption beacons, which stay gated on
+     * keyless installs) and the `resolution_failure` diagnostics (plan 144
+     * TASK-21), which are deliberately NOT keyless-only — keyed production
+     * installs emit them too (plan 124 Q-7). Callers gate; this never throws.
+     */
+    private postAnonMeta;
     /** One-time info notice that keyless telemetry is active + how to disable it (REQ-8b). */
     private showAnonTelemetryNoticeOnce;
     private sendEvents;
@@ -15081,9 +15134,15 @@ interface components {
             bundle_version?: components["schemas"]["Anon_e17de468dbc9_4"];
             config_shape?: components["schemas"]["Anon_a070b8adf29f"];
             message?: components["schemas"]["Anon_7e1c99abdd77_2"];
+            reason?: components["schemas"]["Anon_e17de468dbc9_5"];
+            placement_handle?: components["schemas"]["Anon_e17de468dbc9_6"];
+            slot_handle?: components["schemas"]["Anon_e17de468dbc9_7"];
+            surface?: components["schemas"]["Anon_e17de468dbc9_8"];
+            plan_handle?: components["schemas"]["Anon_e17de468dbc9_9"];
+            entitlement_handle?: components["schemas"]["Anon_e17de468dbc9_10"];
         };
         /** @enum {string} */
-        SdkMetaEventType: "sdk_init" | "sdk_error" | "sdk_validation_warning";
+        SdkMetaEventType: "sdk_init" | "sdk_error" | "sdk_validation_warning" | "resolution_failure";
         SdkConfigShape: {
             plans: components["schemas"]["Anon_274ba4ca49d5"];
             entitlements: components["schemas"]["Anon_274ba4ca49d5_1"];
@@ -15914,6 +15973,18 @@ interface components {
         Anon_274ba4ca49d5_7: number;
         Anon_7e1c99abdd77_2: components["schemas"]["Anon_373775e26848_4"];
         Anon_373775e26848_4: string;
+        Anon_e17de468dbc9_5: components["schemas"]["Anon_520c691f88f7_5"];
+        Anon_520c691f88f7_5: string;
+        Anon_e17de468dbc9_6: components["schemas"]["Anon_520c691f88f7_6"];
+        Anon_520c691f88f7_6: string;
+        Anon_e17de468dbc9_7: components["schemas"]["Anon_520c691f88f7_7"];
+        Anon_520c691f88f7_7: string;
+        Anon_e17de468dbc9_8: components["schemas"]["Anon_520c691f88f7_8"];
+        Anon_520c691f88f7_8: string;
+        Anon_e17de468dbc9_9: components["schemas"]["Anon_520c691f88f7_9"];
+        Anon_520c691f88f7_9: string;
+        Anon_e17de468dbc9_10: components["schemas"]["Anon_520c691f88f7_10"];
+        Anon_520c691f88f7_10: string;
         Anon_761f976a1da1_2: string;
         Anon_57796118d046_19: string;
         Anon_4e04ec5cc4e6_4: components["schemas"]["Anon_9ac136edb99a_9"];