@revturbine/sdk 0.2.71 → 0.2.73

package/dist/index.d.ts

@@ -2152,6 +2152,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>;
@@ -2995,6 +2998,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;
@@ -3011,6 +3015,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>;
@@ -3030,6 +3035,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<{
@@ -3037,6 +3048,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>;
@@ -3056,6 +3068,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;
@@ -11413,6 +11431,10 @@ declare function parseUiPath(raw: Record<string, unknown>): PlacementUiPath;
 declare function parsePromotion(raw?: Record<string, unknown>): PlacementPromotion | undefined;
 /**
  * Get or create the default global placement type registry.
+ *
+ * On the React entry the registry comes pre-seeded with the built-in slot
+ * types; on the headless entry it starts empty (headless consumers register
+ * their own types via {@link PlacementTypeRegistry.register}).
  */
 declare function getDefaultRegistry(): PlacementTypeRegistry;
 /**
@@ -12851,6 +12873,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;
     /**
@@ -12864,6 +12913,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;
@@ -15174,9 +15231,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"];
@@ -16007,6 +16070,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"];
@@ -20961,23 +21036,6 @@ interface PostHogIntegrationOptions extends PostHogAnalyticsProviderOptions {
  */
 declare function createPostHogIntegration(options: PostHogIntegrationOptions): EventConsumerProvider;
 
-/**
- * Register all built-in slot types on the given registry.
- *
- * Built-in types cover the core surface types:
- * - banner       → BannerSlot (full-width top/bottom)
- * - modal        → ModalSlot (overlay dialog, optional/blocking)
- * - in_page      → InPageSlot (card/embed in page flow)
- * - toast        → ToastSlot (ephemeral notification)
- * - button       → ButtonSlot (nav bar / CTA button)
- * - full_page    → FullPageSlot (dedicated managed page)
- * - email/sms/push → channel previews (static out-of-band mocks)
- *
- * Additional specialized types registered as in_page variants:
- * - quota_meter  → QuotaMeterSlot (usage meter + upgrade CTA)
- */
-declare function registerBuiltinSlotTypes(registry: PlacementTypeRegistry): void;
-
 /**
  * Pre-defined surface template ID sets.
  *
@@ -21546,6 +21604,23 @@ declare function registerBuiltinSnoozeResolver(snooze: (outputId: string, second
  */
 declare function dispatchCtaClick(uiPath: PlacementUiPath, context: CtaResolverContext, resolvers: CtaResolverRegistry, fallback?: (uiPath: PlacementUiPath) => void): boolean;
 
+/**
+ * Register all built-in slot types on the given registry.
+ *
+ * Built-in types cover the core surface types:
+ * - banner       → BannerSlot (full-width top/bottom)
+ * - modal        → ModalSlot (overlay dialog, optional/blocking)
+ * - in_page      → InPageSlot (card/embed in page flow)
+ * - toast        → ToastSlot (ephemeral notification)
+ * - button       → ButtonSlot (nav bar / CTA button)
+ * - full_page    → FullPageSlot (dedicated managed page)
+ * - email/sms/push → channel previews (static out-of-band mocks)
+ *
+ * Additional specialized types registered as in_page variants:
+ * - quota_meter  → QuotaMeterSlot (usage meter + upgrade CTA)
+ */
+declare function registerBuiltinSlotTypes(registry: PlacementTypeRegistry): void;
+
 /**
  * Props for {@link BannerSlot}.
  * Extends {@link PlacementSlotProps} with banner-specific options.