@encorekit/web-sdk 1.1.18 → 1.1.20

package/types/api/generated/types.d.ts

@@ -0,0 +1,4509 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/publisher/sdk/v1/offers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get all available active offers/campaigns across all organizations */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                    /** @description ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). If not provided, user country will be US. */
+                    userCountry?: string;
+                    /** @description SDK version in semver format (e.g., '1.2.3'). If not provided, SDK version will be 1.2.6. */
+                    sdkVersion?: string;
+                    /** @description Client platform: android, ios, or web. If not provided, platform will be ios. */
+                    platform?: "android" | "ios" | "web";
+                    /** @description Optional SDUI variant ID to filter creatives by variant assignment */
+                    variantId?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            offers: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                organizationId: string;
+                                name: string;
+                                /** @enum {string} */
+                                payoutModel: "CPA" | "CPC" | "CPI" | "CPM";
+                                payoutAmount: number;
+                                /** @description Attribution platform (e.g., rakuten, impact, tune) */
+                                attributionPlatform: string | null;
+                                targetCountries: string[];
+                                /**
+                                 * Format: uri
+                                 * @description Primary destination URL for the campaign
+                                 */
+                                destinationUrl: string;
+                                /**
+                                 * Format: date-time
+                                 * @description UTC timestamp
+                                 */
+                                startDate: string;
+                                /**
+                                 * Format: date-time
+                                 * @description UTC timestamp (null for ongoing)
+                                 */
+                                endDate: string | null;
+                                /** @enum {string} */
+                                status: "active" | "archived" | "awaiting_approval" | "completed" | "draft";
+                                /**
+                                 * @description Current validation status of the destination URL
+                                 * @enum {string}
+                                 */
+                                linkStatus: "broken" | "error" | "text_mismatch" | "unchecked" | "valid";
+                                /** @description Expected domain of the destination URL */
+                                expectedDomain: string | null;
+                                /** @description Internal campaign notes */
+                                notes: string | null;
+                                /** @description Publisher-facing notes about this offer */
+                                publisherNotes: string | null;
+                                priority: number | null;
+                                /** @description When true, this campaign is auto-granted to every newly created app. Independent of priority (which controls ranking order only). */
+                                defaultCatalog: boolean;
+                                /**
+                                 * @description blacklist (default): all apps eligible; whitelist: only apps in campaign_allowed_apps are eligible
+                                 * @enum {string}
+                                 */
+                                targetingMode: "blacklist" | "whitelist";
+                                /** @description New/discounted price for the offer */
+                                newPrice: string | null;
+                                /** @description Original price before discount */
+                                oldPrice: string | null;
+                                /** @description User-facing value proposition, e.g., "3 months of Hulu free". Rendered in the deal email. */
+                                perk: string | null;
+                                /**
+                                 * @description Constrained promo badge for in-app offer cards: free_trial | discount. Drives the card pill display AND client-side free-trial-vs-discount logic. Clients map the enum to display text + free-trial boolean. NULL means no badge.
+                                 * @enum {string|null}
+                                 */
+                                badgeLabel: "free_trial" | "discount" | null;
+                                /** Format: date-time */
+                                createdAt: string;
+                                /** Format: date-time */
+                                updatedAt: string;
+                                /** @description Included when fetching with relations */
+                                organization?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    name: string;
+                                    description: string | null;
+                                    url: string | null;
+                                    logoUrl: string | null;
+                                    /** Format: date-time */
+                                    createdAt: string;
+                                    /** Format: date-time */
+                                    updatedAt: string;
+                                };
+                                /** @description Included if includeCreatives=true */
+                                creatives?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    /** Format: uuid */
+                                    campaignId: string;
+                                    name: string;
+                                    title: string;
+                                    subtitle: string | null;
+                                    description: string | null;
+                                    /** Format: uri */
+                                    primaryImageUrl: string;
+                                    /** Format: uri */
+                                    logoUrl: string | null;
+                                    additionalImages: string[] | null;
+                                    ctaText: string;
+                                    /**
+                                     * Format: uri
+                                     * @description Optional override for campaign destinationUrl
+                                     */
+                                    destinationUrl: string | null;
+                                    trackingParameters: {
+                                        [key: string]: unknown;
+                                    } | null;
+                                    weight: number | null;
+                                    /** @enum {string} */
+                                    status: "active" | "archived" | "draft" | "paused";
+                                    instructions: {
+                                        title: string;
+                                        subtitle: string;
+                                        ctaButtonText?: string;
+                                    }[] | null;
+                                    /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
+                                    quickInstructions: string | null;
+                                    /** @description Minimum SDK version required (null = no minimum) */
+                                    minSdkVersion: string | null;
+                                    /** @description Maximum SDK version supported (null = no maximum) */
+                                    maxSdkVersion: string | null;
+                                    /** @description Platforms this creative supports (empty = all platforms) */
+                                    supportedPlatforms: ("android" | "ios" | "web")[] | null;
+                                    /** @description Tooltip text to display on hover in Web SDK offer carousel (null = use default text) */
+                                    tooltipText: string | null;
+                                    /** @description Optional dynamic text overlay config. NULL = no overlay (legacy creatives). */
+                                    overlayConfig?: {
+                                        /** @enum {number} */
+                                        version: 1;
+                                        aspectRatio?: number;
+                                        overlays: {
+                                            id: string;
+                                            /** @description Template string resolved via SDUIContext.resolveTemplateText (e.g., '${premiumTierName}') */
+                                            template: string;
+                                            /** @description Top-left of the zone, as ratios of the rendered image */
+                                            position: {
+                                                x: number;
+                                                y: number;
+                                            };
+                                            dimensions: {
+                                                width: number;
+                                                height: number;
+                                            };
+                                            /**
+                                             * @description Horizontal alignment for wrapped text within the zone
+                                             * @enum {string}
+                                             */
+                                            alignment: "leading" | "center" | "trailing";
+                                            typography: {
+                                                fontSizeRatio: number;
+                                                fontWeight: string;
+                                                color: {
+                                                    hex: string;
+                                                } | {
+                                                    semantic: string;
+                                                } | {
+                                                    appearance: string;
+                                                };
+                                                lineHeight?: number;
+                                                letterSpacing?: number;
+                                            };
+                                            overflow?: {
+                                                minScaleFactor?: number;
+                                                maxLines?: number;
+                                                /** @enum {string} */
+                                                truncation?: "head" | "middle" | "tail" | "clip";
+                                            };
+                                        }[];
+                                    } | null;
+                                    /** Format: date-time */
+                                    createdAt: string;
+                                    /** Format: date-time */
+                                    updatedAt: string;
+                                }[];
+                            }[];
+                            metadata: {
+                                total: number;
+                                limit: number;
+                                offset: number;
+                                hasMore: boolean;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/offers/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Search eligible offers for a user with pagination support. Campaigns and creatives are randomized for A/B testing using request_id. Performs abuse checks and returns available campaigns. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        userId: string;
+                        /** @description Optional user attributes for offer selection */
+                        attributes?: {
+                            email?: string;
+                            firstName?: string;
+                            lastName?: string;
+                            mobile?: string;
+                            phoneNumber?: string;
+                            postcode?: string;
+                            postalCode?: string;
+                            city?: string;
+                            state?: string;
+                            region?: string;
+                            /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
+                            countryCode?: string;
+                            /** @description Decimal degrees as string (e.g., "37.7749") */
+                            latitude?: string;
+                            /** @description Decimal degrees as string (e.g., "-122.4194") */
+                            longitude?: string;
+                            dateOfBirth?: string;
+                            gender?: string;
+                            language?: string;
+                            subscriptionTier?: string;
+                            monthsSubscribed?: string;
+                            billingCycle?: string;
+                            lastPaymentAmount?: string;
+                            lastActiveDate?: string;
+                            totalSessions?: string;
+                            custom?: {
+                                [key: string]: string;
+                            };
+                        };
+                        /**
+                         * @description Number of campaigns to fetch (default: 10)
+                         * @default 50
+                         */
+                        limit?: number;
+                        /**
+                         * @description Pagination offset (default: 0)
+                         * @default 0
+                         */
+                        offset?: number;
+                        /**
+                         * Format: uuid
+                         * @description Session ID for deterministic pagination - if not provided, server will generate one
+                         */
+                        requestId?: string;
+                        /** @description SDK version in semver format (e.g., "1.2.3") */
+                        sdkVersion?: string;
+                        /**
+                         * @description Client platform: android, ios, or web
+                         * @enum {string}
+                         */
+                        platform?: "android" | "ios" | "web";
+                        /**
+                         * Format: uuid
+                         * @description SDUI variant ID from frontend config fetch. If provided, filters creatives by variant assignment. If not provided, no variant filtering is applied.
+                         */
+                        variantId?: string;
+                        /** @description Strict unlock mode: only include campaigns whose postback latency is less than or equal to this value (in milliseconds). Omit for no filtering. Bounded 1000..120000. */
+                        maxPostbackTimeMs?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            offers: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: uuid */
+                                organizationId: string;
+                                name: string;
+                                /** @enum {string} */
+                                payoutModel: "CPA" | "CPC" | "CPI" | "CPM";
+                                payoutAmount: number;
+                                /** @description Attribution platform (e.g., rakuten, impact, tune) */
+                                attributionPlatform: string | null;
+                                targetCountries: string[];
+                                /**
+                                 * Format: uri
+                                 * @description Primary destination URL for the campaign
+                                 */
+                                destinationUrl: string;
+                                /**
+                                 * Format: date-time
+                                 * @description UTC timestamp
+                                 */
+                                startDate: string;
+                                /**
+                                 * Format: date-time
+                                 * @description UTC timestamp (null for ongoing)
+                                 */
+                                endDate: string | null;
+                                /** @enum {string} */
+                                status: "active" | "archived" | "awaiting_approval" | "completed" | "draft";
+                                /**
+                                 * @description Current validation status of the destination URL
+                                 * @enum {string}
+                                 */
+                                linkStatus: "broken" | "error" | "text_mismatch" | "unchecked" | "valid";
+                                /** @description Expected domain of the destination URL */
+                                expectedDomain: string | null;
+                                /** @description Internal campaign notes */
+                                notes: string | null;
+                                /** @description Publisher-facing notes about this offer */
+                                publisherNotes: string | null;
+                                priority: number | null;
+                                /** @description When true, this campaign is auto-granted to every newly created app. Independent of priority (which controls ranking order only). */
+                                defaultCatalog: boolean;
+                                /**
+                                 * @description blacklist (default): all apps eligible; whitelist: only apps in campaign_allowed_apps are eligible
+                                 * @enum {string}
+                                 */
+                                targetingMode: "blacklist" | "whitelist";
+                                /** @description New/discounted price for the offer */
+                                newPrice: string | null;
+                                /** @description Original price before discount */
+                                oldPrice: string | null;
+                                /** @description User-facing value proposition, e.g., "3 months of Hulu free". Rendered in the deal email. */
+                                perk: string | null;
+                                /**
+                                 * @description Constrained promo badge for in-app offer cards: free_trial | discount. Drives the card pill display AND client-side free-trial-vs-discount logic. Clients map the enum to display text + free-trial boolean. NULL means no badge.
+                                 * @enum {string|null}
+                                 */
+                                badgeLabel: "free_trial" | "discount" | null;
+                                /** Format: date-time */
+                                createdAt: string;
+                                /** Format: date-time */
+                                updatedAt: string;
+                                /** @description Included when fetching with relations */
+                                organization?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    name: string;
+                                    description: string | null;
+                                    url: string | null;
+                                    logoUrl: string | null;
+                                    /** Format: date-time */
+                                    createdAt: string;
+                                    /** Format: date-time */
+                                    updatedAt: string;
+                                };
+                                /** @description Included if includeCreatives=true */
+                                creatives?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    /** Format: uuid */
+                                    campaignId: string;
+                                    name: string;
+                                    title: string;
+                                    subtitle: string | null;
+                                    description: string | null;
+                                    /** Format: uri */
+                                    primaryImageUrl: string;
+                                    /** Format: uri */
+                                    logoUrl: string | null;
+                                    additionalImages: string[] | null;
+                                    ctaText: string;
+                                    /**
+                                     * Format: uri
+                                     * @description Optional override for campaign destinationUrl
+                                     */
+                                    destinationUrl: string | null;
+                                    trackingParameters: {
+                                        [key: string]: unknown;
+                                    } | null;
+                                    weight: number | null;
+                                    /** @enum {string} */
+                                    status: "active" | "archived" | "draft" | "paused";
+                                    instructions: {
+                                        title: string;
+                                        subtitle: string;
+                                        ctaButtonText?: string;
+                                    }[] | null;
+                                    /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
+                                    quickInstructions: string | null;
+                                    /** @description Minimum SDK version required (null = no minimum) */
+                                    minSdkVersion: string | null;
+                                    /** @description Maximum SDK version supported (null = no maximum) */
+                                    maxSdkVersion: string | null;
+                                    /** @description Platforms this creative supports (empty = all platforms) */
+                                    supportedPlatforms: ("android" | "ios" | "web")[] | null;
+                                    /** @description Tooltip text to display on hover in Web SDK offer carousel (null = use default text) */
+                                    tooltipText: string | null;
+                                    /** @description Optional dynamic text overlay config. NULL = no overlay (legacy creatives). */
+                                    overlayConfig?: {
+                                        /** @enum {number} */
+                                        version: 1;
+                                        aspectRatio?: number;
+                                        overlays: {
+                                            id: string;
+                                            /** @description Template string resolved via SDUIContext.resolveTemplateText (e.g., '${premiumTierName}') */
+                                            template: string;
+                                            /** @description Top-left of the zone, as ratios of the rendered image */
+                                            position: {
+                                                x: number;
+                                                y: number;
+                                            };
+                                            dimensions: {
+                                                width: number;
+                                                height: number;
+                                            };
+                                            /**
+                                             * @description Horizontal alignment for wrapped text within the zone
+                                             * @enum {string}
+                                             */
+                                            alignment: "leading" | "center" | "trailing";
+                                            typography: {
+                                                fontSizeRatio: number;
+                                                fontWeight: string;
+                                                color: {
+                                                    hex: string;
+                                                } | {
+                                                    semantic: string;
+                                                } | {
+                                                    appearance: string;
+                                                };
+                                                lineHeight?: number;
+                                                letterSpacing?: number;
+                                            };
+                                            overflow?: {
+                                                minScaleFactor?: number;
+                                                maxLines?: number;
+                                                /** @enum {string} */
+                                                truncation?: "head" | "middle" | "tail" | "clip";
+                                            };
+                                        }[];
+                                    } | null;
+                                    /** Format: date-time */
+                                    createdAt: string;
+                                    /** Format: date-time */
+                                    updatedAt: string;
+                                }[];
+                            }[];
+                            metadata: {
+                                /** @description Total offers available */
+                                total: number;
+                                limit: number;
+                                offset: number;
+                                /** @description Whether there are more offers available */
+                                hasMore: boolean;
+                                executionTimeMs: number;
+                                /**
+                                 * Format: uuid
+                                 * @description Session ID used for randomization - use this for subsequent pagination requests
+                                 */
+                                requestId: string;
+                            };
+                            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+                            locale?: string;
+                            error?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/offers/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Rebrokering catalog: the full set of offers your app may serve to a given end user, to render on your own surface. Two hard, server-enforced filters always apply: entitlement (your app's opt-outs + whitelist) and geo (offers not redeemable in the end user's country are dropped — non-redeemable offers are never returned). Serve path requires `userId` (a stable end-user identifier) and geo (`countryCode`, or the end user's IP forwarded via X-Forwarded-For); missing either is a 400. Each returned creative carries a tokenized `clickUrl` — route the end user there on tap and it records an attributed transaction (bound to your app, the offer, the creative, and the userId) then 302s to the advertiser. Filter to your curated offer IDs and order CLIENT-SIDE, falling back to other returned offers so your surface is never empty (the server does not narrow to your picks). Set `includeAllRegions: true` for config-time discovery of your full addressable inventory (skips geo, needs no userId, returns no clickUrls; each offer carries targetCountries) — not for display. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description Stable identifier for the END USER you are rendering offers to (any opaque string; does not need to be PII). REQUIRED on the serve path — it is bound into each offer's clickUrl so a click records a transaction attributed to (your app, the offer, the creative, this user), and it drives per-user fraud controls (trial caps, retake blocking) at click time. Use the same value across renders for the same user. Not required when includeAllRegions is set (config mode returns no clickUrls). */
+                        userId?: string;
+                        /** @description Optional identifier for the operator/sub-publisher on whose behalf offers are shown. Carried through as an analytics dimension. Defaults to userId when omitted. */
+                        clientId?: string;
+                        /** @description ISO 3166-1 alpha-2 country code of the END USER the offers will be shown to (e.g. "US", "GB"). Provides the geography signal for geo-filtering. Resolution: this value → client IP (X-Forwarded-For aware) → (rejected if neither resolves). Send it when calling server-to-server without forwarding the end user's IP; omit it when the end user (or a proxy forwarding their IP) is the caller. Ignored when includeAllRegions is true. */
+                        countryCode?: string;
+                        /** @description CONFIG-TIME ONLY. When true, skips geo-filtering and returns the full addressable inventory for your app (entitlement still applies), with each offer's targetCountries — use this to build your curation. Do NOT use for offers displayed to an end user; those must come from a geo-scoped request (countryCode or forwarded IP). When true, no geography signal is required and countryCode is ignored. */
+                        includeAllRegions?: boolean;
+                        /** @description Optional page size (1..100). OMIT to return ALL eligible offers (the default) — catalogs are small enough that you normally take the whole set and curate client-side. Provide only if you want to page (with offset). */
+                        limit?: number;
+                        /**
+                         * @description Pagination offset (default 0). Only meaningful together with limit.
+                         * @default 0
+                         */
+                        offset?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description Offers this app is entitled to and (unless includeAllRegions) that are redeemable in the resolved end-user country, each with the default (control-variant) active creatives — never experiment-reserved ones. On serve responses each creative carries a `clickUrl` for attribution. Filter to your curated IDs and order client-side; fall back within this set so your surface is never empty. */
+                            offers: {
+                                /** Format: uuid */
+                                id: string;
+                                name: string;
+                                /** @description User-facing value proposition, e.g., "3 months of Hulu free". Rendered in the deal email. */
+                                perk: string | null;
+                                /**
+                                 * @description Constrained promo badge for in-app offer cards: free_trial | discount. Drives the card pill display AND client-side free-trial-vs-discount logic. Clients map the enum to display text + free-trial boolean. NULL means no badge.
+                                 * @enum {string|null}
+                                 */
+                                badgeLabel: "free_trial" | "discount" | null;
+                                /** @description Original price before discount */
+                                oldPrice: string | null;
+                                /** @description New/discounted price for the offer */
+                                newPrice: string | null;
+                                targetCountries: string[];
+                                organization?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    name: string;
+                                    description: string | null;
+                                    url: string | null;
+                                    logoUrl: string | null;
+                                };
+                                creatives?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    title: string;
+                                    subtitle: string | null;
+                                    description: string | null;
+                                    /** Format: uri */
+                                    primaryImageUrl: string;
+                                    /** Format: uri */
+                                    logoUrl: string | null;
+                                    additionalImages: string[] | null;
+                                    ctaText: string;
+                                    /** @description Platforms this creative supports (empty = all platforms) */
+                                    supportedPlatforms: ("android" | "ios" | "web")[] | null;
+                                    /**
+                                     * Format: uri
+                                     * @description Tokenized click URL for THIS creative. Send the end user here when they tap the offer: it records a transaction attributed to (your app, this offer, this creative, the userId you supplied) and 302-redirects to the advertiser with the transaction id substituted. Treat it as opaque, do not modify it. Present on serve responses; absent when includeAllRegions is set.
+                                     */
+                                    clickUrl?: string;
+                                }[];
+                            }[];
+                            metadata: {
+                                /** @description Total offers matching after entitlement + geo filtering (before pagination). */
+                                total: number;
+                                limit: number;
+                                offset: number;
+                                /** @description Whether more offers remain beyond this page. */
+                                hasMore: boolean;
+                            };
+                            /** @description Resolved locale served in this response (language-only, e.g. 'es'). */
+                            locale?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/offers/message": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Select one eligible offer for a third-party messaging surface (WhatsApp, Messenger, Instagram) and return the raw offer fields — the branded short clickUrl plus context (title, description, imageUrl, advertiserName, perk) — so the integrator composes their own message. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). Retries are NOT deduplicated server-side (no retry-stable client key on the request), so each call produces a distinct short link and analytics row. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Stable identifier for the integrator-client (the business / operator the message is being sent on behalf of). Carried through as an analytics dimension so impressions, clicks, and conversions can be broken down per client. */
+                        clientId: string;
+                        /** @description Conversation / thread identifier on the messaging platform. Used as the messaging-surface userId — drives bandit seeding for `/offers/message`, the transaction created at click time, and the userId dimension on the click event. */
+                        chatId: string;
+                        /** @description Required targeting attributes — country / language / platform. */
+                        attributes: {
+                            /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
+                            countryCode: string;
+                            /** @description BCP 47 language tag — drives creative locale resolution (e.g., 'en', 'es'). */
+                            language: string;
+                            /**
+                             * @description Recipient's device platform — drives creative compatibility filtering.
+                             * @enum {string}
+                             */
+                            platform: "android" | "ios" | "web";
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            /** @description Selected offer details — the branded short clickUrl plus context fields — for the integrator to compose and send their own message, or null when no eligible offer was found. No message is composed server-side. */
+                            offer: {
+                                /**
+                                 * Format: uri
+                                 * @description Branded short click URL (https://link.encorekit.com/<slug>) that 302s to the advertiser with attribution. Short enough to send as raw text on messaging surfaces.
+                                 */
+                                clickUrl: string;
+                                /** @description Creative headline/title for the offer. */
+                                title: string;
+                                /** @description Longer creative description, or null when the creative has none. */
+                                description: string | null;
+                                /**
+                                 * Format: uri
+                                 * @description Primary creative image URL.
+                                 */
+                                imageUrl: string;
+                                /** @description Display name of the advertiser (organization) behind the offer. */
+                                advertiserName: string;
+                                /** @description Campaign value proposition (e.g. "3 months of Apple Music free"), or null when the campaign has none. Surfaced explicitly so integrators can render the deal in the message they compose. */
+                                perk?: string | null;
+                                /**
+                                 * @description Constrained promo badge for the in-app offer card: "free_trial" | "discount", or null when the campaign has none. Distinct from perk (longer value proposition). Clients map the enum to display text ("Free trial" / "Discount") and free-trial-vs-discount logic. Surfaced additively.
+                                 * @enum {string|null}
+                                 */
+                                badgeLabel: "free_trial" | "discount" | null;
+                            } | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/offers/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Return the bandit-ranked eligible offers for a user (up to `limit`, default 10) so a native / custom-UI app can render them and cycle through them client-side. Each offer carries its own impressionUid plus the branded short clickUrl and context (title, description, imageUrl, additionalImages, advertiserName, advertiserLogo, perk). Calling this endpoint is NOT itself the impression — the server emits one offer.requested per offer as the served baseline; confirm an actual impression by calling POST /offers/impressions/:impression_uid/delivered when an offer is shown. Returns offers:[] when no eligible offer was found. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Stable identifier for the integrator-client (the business / operator the offer is rendered on behalf of). Carried through as an analytics dimension so impressions, clicks, and conversions can be broken down per client. */
+                        clientId: string;
+                        /** @description End-user identifier on the partner surface. Used as the bandit-seeding userId for ranking and as the userId on the transaction created at click time. */
+                        userId: string;
+                        /** @description Required targeting attributes — country / language / platform. */
+                        attributes: {
+                            /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
+                            countryCode: string;
+                            /** @description BCP 47 language tag — drives creative locale resolution (e.g., 'en', 'es'). */
+                            language: string;
+                            /**
+                             * @description Recipient's device platform — drives creative compatibility filtering.
+                             * @enum {string}
+                             */
+                            platform: "android" | "ios" | "web";
+                        };
+                        /**
+                         * @description Maximum number of offers to return (1–25, default 10). The client controls display order and cycles through them one at a time.
+                         * @default 10
+                         */
+                        limit?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            /** @description The bandit-ranked eligible offers for the user (up to `limit`), each with its own impressionUid and branded short clickUrl. Empty array when no eligible offer was found. */
+                            offers: {
+                                /** @description Per-offer impression id. Pass this to POST /offers/impressions/:impression_uid/delivered when this offer is actually shown to the user to record the impression. */
+                                impressionUid: string;
+                                /**
+                                 * Format: uri
+                                 * @description Branded short click URL (https://link.encorekit.com/<slug>) that 302s to the advertiser with attribution. Open it in-app to register the click; also usable as a share-to-friend link.
+                                 */
+                                clickUrl: string;
+                                /** @description Creative headline/title for the offer. */
+                                title: string;
+                                /** @description Longer creative description, or null when the creative has none. */
+                                description: string | null;
+                                /**
+                                 * Format: uri
+                                 * @description Primary creative image URL.
+                                 */
+                                imageUrl: string;
+                                /**
+                                 * @description Additional creative image URLs (may be empty). Supplements the primary imageUrl.
+                                 * @default []
+                                 */
+                                additionalImages: string[];
+                                /** @description Display name of the advertiser (organization) behind the offer. */
+                                advertiserName: string;
+                                /**
+                                 * Format: uri
+                                 * @description Advertiser (organization) logo URL for rendering the brand mark, or null when the advertiser has no logo set.
+                                 */
+                                advertiserLogo: string | null;
+                                /** @description Campaign value proposition (e.g. "3 months of Apple Music free"), or null when the campaign has none. */
+                                perk?: string | null;
+                                /**
+                                 * @description Constrained promo badge for the in-app offer card: "free_trial" | "discount", or null when the campaign has none. Clients map the enum to display text ("Free trial" / "Discount") and free-trial-vs-discount logic.
+                                 * @enum {string|null}
+                                 */
+                                badgeLabel: "free_trial" | "discount" | null;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/offers/impressions/{impression_uid}/delivered": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Record that a previously selected offer (impression) was actually shown to the end user — confirming an impression. Used by both the messaging surface (/offers/message) and the multi-offer feed (/offers/feed, called once per offer as it is displayed). Emits `offer.delivered`; analytics joins to `offer.requested` by impression_uid downstream. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The per-offer `impressionUid` returned by POST /offers/feed. A UUID. */
+                    impression_uid: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Unix seconds — Meta webhook `statuses[].timestamp` where status='delivered'. */
+                        deliveredTimestamp: number;
+                        /** @description Unix seconds — Meta webhook `statuses[].timestamp` where status='read'. Optional. */
+                        readTimestamp?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/transactions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Create a new transaction for a specific campaign */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        campaignId: string;
+                        userId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Created transaction ID
+                             */
+                            transactionId?: string;
+                            /** @description Generated advertiser SDK token */
+                            token?: string;
+                            /**
+                             * Format: date-time
+                             * @description When token expires
+                             */
+                            expiresAt?: string;
+                            /** @description Domain where token can be activated */
+                            allowedDomain?: string;
+                            error?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/transactions/{transactionId}/signals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Send a grant signal (provisional or final). Must be idempotent. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    transactionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Type of grant to apply
+                         * @enum {string}
+                         */
+                        grantType: "provisional" | "final";
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            error?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/transactions/{transactionId}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get verification status for a transaction. Pass verify=true to actively fetch from the advertiser before returning. */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description When true, actively fetch from the advertiser platform before returning status. Default false returns the current DB state. */
+                    verify?: boolean;
+                };
+                header?: never;
+                path: {
+                    transactionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * @description Transaction status
+                             * @enum {string|null}
+                             */
+                            status: "pending_conversion" | "provisional_granted" | "verified" | "final_granted" | "expired" | "failed" | null;
+                            error?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/entitlements/revoke": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Revoke all entitlements for a user. Sets revoked_at timestamp on all transactions with entitlements. Useful for testing. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        userId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description Provisional entitlements (temporary, require conversion) */
+                            provisional: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Verified entitlements (permanent, earned through conversion) */
+                            verified: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description All accumulated entitlements (combines verified + provisional with full original values) */
+                            all: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Request execution time in milliseconds */
+                            executionTimeMs: number;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/entitlements": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get accumulated entitlements for a user, separated by provisional and verified status */
+        get: {
+            parameters: {
+                query: {
+                    userId: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description Provisional entitlements (temporary, require conversion) */
+                            provisional: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Verified entitlements (permanent, earned through conversion) */
+                            verified: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description All accumulated entitlements (combines verified + provisional with full original values) */
+                            all: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Request execution time in milliseconds */
+                            executionTimeMs: number;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/entitlements/server": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Check if a user has active entitlements. Server-to-server only - requires HMAC authentication. HMAC signature covers query string. */
+        get: {
+            parameters: {
+                query: {
+                    userId: string;
+                };
+                header: {
+                    "x-api-key": string;
+                    "x-signature": string;
+                    "x-timestamp": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description Provisional entitlements (temporary, require conversion) */
+                            provisional: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Verified entitlements (permanent, earned through conversion) */
+                            verified: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description All accumulated entitlements (combines verified + provisional with full original values) */
+                            all: {
+                                /** @description Free trial entitlement details */
+                                freeTrial?: {
+                                    /**
+                                     * Format: date-time
+                                     * @description Start date of the entitlement (ISO8601)
+                                     */
+                                    startedAt: string | null;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                                /** @description Available discount entitlements */
+                                discounts?: {
+                                    /** @description Discount value */
+                                    value: number;
+                                    /**
+                                     * @description Discount unit
+                                     * @enum {string}
+                                     */
+                                    unit: "percent" | "dollars";
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                }[];
+                                /** @description Available credit entitlements */
+                                credits?: {
+                                    /** @description Total credit amount */
+                                    totalAmount: number;
+                                    /**
+                                     * Format: date-time
+                                     * @description Expiration date (ISO8601)
+                                     */
+                                    expiresAt: string | null;
+                                };
+                            };
+                            /** @description Request execution time in milliseconds */
+                            executionTimeMs: number;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/errors": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Report a client-side error from the SDK. API key is optional. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        errorType: string;
+                        message: string;
+                        context: string;
+                        stackTrace?: string;
+                        underlyingError?: string;
+                        /** @enum {string} */
+                        severity: "fatal" | "error" | "warning" | "info";
+                        /** Format: date-time */
+                        timestamp: string;
+                        metadata?: {
+                            [key: string]: string;
+                        };
+                        /** @enum {string} */
+                        platform: "ios" | "android" | "web";
+                        sdkVersion: string;
+                        appBundleId: string;
+                        appVersion?: string;
+                        osVersion?: string;
+                        deviceModel?: string;
+                        userId?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            acknowledged: boolean;
+                            eventId?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/ui-config": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get server-driven UI configuration for the SDK. Returns the active variant based on weighted selection and SDK version compatibility, plus app UI configuration (text/color vars). Same user ID always returns same variant. */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The user ID for deterministic variant assignment */
+                    userId: string;
+                    /** @description SDK version for compatibility filtering */
+                    sdkVersion: string;
+                    /** @description Optional language hint (e.g. 'es'). Overrides the Accept-Language header; region subtags are stripped. */
+                    language?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description SDUI variant info and layout configuration */
+                            sduiConfig: {
+                                /**
+                                 * Format: uuid
+                                 * @description The ID of the selected variant
+                                 */
+                                variantId: string;
+                                /** @description The name of the selected variant */
+                                variantName: string;
+                                /** @description The minimum SDK version required for this variant */
+                                minSdkVersion: string;
+                                /** @description The SDUI JSON layout configuration */
+                                config: {
+                                    [key: string]: unknown;
+                                };
+                            };
+                            /** @description App text/color configuration variables */
+                            remoteConfig: {
+                                /** @description App name for template substitution (e.g., 'Tinder Plus') */
+                                appName?: string | null;
+                                titleText?: string | null;
+                                subtitleText?: string | null;
+                                offerDescriptionText?: string | null;
+                                instructionsTitleText?: string | null;
+                                lastStepHeaderText?: string | null;
+                                lastStepDescriptionText?: string | null;
+                                creditClaimedTitleText?: string | null;
+                                creditClaimedSubtitleText?: string | null;
+                                applyCreditsButtonText?: string | null;
+                                accentTitleText?: string | null;
+                                accentTitleColor?: string | null;
+                                accentColor?: string | null;
+                                /** @enum {string|null} */
+                                appearanceMode?: "light" | "dark" | "auto" | null;
+                                /** @description Entitlement value for template substitution (e.g., '1' for '1 month') */
+                                entitlementValue?: string | null;
+                                /** @description Entitlement unit for template substitution (e.g., 'month', 'day', 'week') */
+                                entitlementUnit?: string | null;
+                            };
+                            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+                            locale?: string;
+                        } | {
+                            success: boolean;
+                            /**
+                             * @description No SDUI variant available
+                             * @enum {unknown|null}
+                             */
+                            sduiConfig: "null" | null;
+                            /** @description Reason why no variant is available */
+                            message: string;
+                            /** @description App text/color configuration variables */
+                            remoteConfig: {
+                                /** @description App name for template substitution (e.g., 'Tinder Plus') */
+                                appName?: string | null;
+                                titleText?: string | null;
+                                subtitleText?: string | null;
+                                offerDescriptionText?: string | null;
+                                instructionsTitleText?: string | null;
+                                lastStepHeaderText?: string | null;
+                                lastStepDescriptionText?: string | null;
+                                creditClaimedTitleText?: string | null;
+                                creditClaimedSubtitleText?: string | null;
+                                applyCreditsButtonText?: string | null;
+                                accentTitleText?: string | null;
+                                accentTitleColor?: string | null;
+                                accentColor?: string | null;
+                                /** @enum {string|null} */
+                                appearanceMode?: "light" | "dark" | "auto" | null;
+                                /** @description Entitlement value for template substitution (e.g., '1' for '1 month') */
+                                entitlementValue?: string | null;
+                                /** @description Entitlement unit for template substitution (e.g., 'month', 'day', 'week') */
+                                entitlementUnit?: string | null;
+                            };
+                            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+                            locale?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/config": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get unified SDK configuration including SDUI, entitlements, experiments, and remote config. This endpoint replaces /ui-config with a cleaner structure. Entitlement mode is implicit: if entitlements.iap.productId exists, use IAP mode; otherwise use Native mode. */
+        get: {
+            parameters: {
+                query: {
+                    /** @description User ID for deterministic variant/cohort assignment */
+                    userId: string;
+                    /** @description SDK version for compatibility filtering */
+                    sdkVersion: string;
+                    /** @description Optional language hint (e.g. 'es'). Overrides the Accept-Language header; region subtags are stripped. */
+                    language?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** @description UI configuration: template + values */
+                            ui: {
+                                /**
+                                 * Format: uuid
+                                 * @description Selected variant ID
+                                 */
+                                variantId?: string | null;
+                                /** @description Selected variant name */
+                                variantName?: string | null;
+                                /** @description Minimum SDK version for this variant */
+                                minSdkVersion?: string | null;
+                                /** @description SDUI template with placeholders */
+                                template?: {
+                                    [key: string]: unknown;
+                                } | null;
+                                /** @description Values to substitute into template */
+                                values: {
+                                    /** @description Text values for template substitution */
+                                    text: {
+                                        /** @description App name for ${appName} substitution */
+                                        appName?: string | null;
+                                        /** @description Main title text */
+                                        title?: string | null;
+                                        /** @description Subtitle text */
+                                        subtitle?: string | null;
+                                        /** @description Offer description text */
+                                        offerDescription?: string | null;
+                                        /** @description Instructions title */
+                                        instructionsTitle?: string | null;
+                                        /** @description Last step header text */
+                                        lastStepHeader?: string | null;
+                                        /** @description Last step description */
+                                        lastStepDescription?: string | null;
+                                        /** @description Credit claimed title */
+                                        creditClaimedTitle?: string | null;
+                                        /** @description Credit claimed subtitle */
+                                        creditClaimedSubtitle?: string | null;
+                                        /** @description Apply credits button text */
+                                        applyCreditsButton?: string | null;
+                                        /** @description Accent title text */
+                                        accentTitle?: string | null;
+                                        /** @description Custom headline text for SDUI variant (falls back to title) */
+                                        customHeadline?: string | null;
+                                        /** @description Custom subheadline text for SDUI variant (falls back to subtitle) */
+                                        customSubheadline?: string | null;
+                                    };
+                                    /** @description Appearance values */
+                                    appearance: {
+                                        /**
+                                         * @description Appearance mode
+                                         * @enum {string|null}
+                                         */
+                                        mode?: "light" | "dark" | "auto" | null;
+                                        /** @description Primary accent color (hex) */
+                                        accentColor?: string | null;
+                                        /** @description Accent title color (hex) */
+                                        accentTitleColor?: string | null;
+                                    };
+                                };
+                            };
+                            /** @description Entitlement configuration (IAP or Native mode) */
+                            entitlements: {
+                                /** @description IAP config. If productId exists → IAP mode. */
+                                iap?: {
+                                    /** @description Store-level subscription product ID. App Store Connect product ID for iOS apps, Google Play subscription product ID for Android apps. */
+                                    productId: string;
+                                    /** @description Google Play subscription offer ID (e.g. 'free-trial-1m'). Null or omitted for iOS apps. The Android SDK uses this value to look up the matching SubscriptionOfferDetails in the product's base plan and pass its offer token to Play Billing's BillingFlowParams.setOfferToken(). */
+                                    offerId?: string | null;
+                                    /** @description Google Play base plan ID (e.g. 'monthly', 'annual'); null for iOS. Disambiguates products that expose multiple base plans so the Android SDK resolves the correct SubscriptionOfferDetails / price for the intended base plan instead of defaulting to the first one. */
+                                    basePlanId?: string | null;
+                                    /** @description Display name for the premium tier (e.g. 'Premium', 'Pro'). Used in SDUI templates via ${premiumTierName}. */
+                                    premiumTierName?: string | null;
+                                } | null;
+                                /** @description Native/Encore-managed entitlement. Fallback if no IAP. */
+                                native?: {
+                                    /** @description Entitlement type (e.g., 'free_trial', 'credit', 'discount') */
+                                    type: string;
+                                    /** @description Raw value for template substitution (e.g., '3') */
+                                    value: string;
+                                    /** @description Raw unit for template substitution (e.g., 'months', 'days') */
+                                    unit: string;
+                                    /** @description Computed duration in days for SDK logic */
+                                    durationDays: number;
+                                } | null;
+                            };
+                            /** @description Experiment configurations */
+                            experiments: {
+                                /** @description NCL experiment config. Null if not configured. */
+                                ncl?: {
+                                    /** @description Percent of eligible users assigned to Treatment */
+                                    rolloutPct: number;
+                                    /** @description Epoch identifier. Change resets cohort assignments. */
+                                    assignmentVersion: number;
+                                    /** @description Kill switch. If false, all users go to Control. */
+                                    enabled: boolean;
+                                } | null;
+                            };
+                            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+                            locale?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/users": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Initialize user (idempotent). Called on SDK init to ensure user exists. Returns canonical UUID. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description User ID from SDK (anonymous UUID or identified) */
+                        userId: string;
+                        /** @description Optional user attributes */
+                        attributes?: {
+                            /** Format: email */
+                            email?: string;
+                            name?: string;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Canonical user UUID
+                             */
+                            userId: string;
+                            /** @description True if user was created, false if already existed */
+                            isNew: boolean;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/users/identify": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** @description Update user identity (anonymous→identified). Updates the user's app_user_id. Called when developer calls SDK.identify() after login. */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Current user ID (anonymous or identified) */
+                        currentUserId: string;
+                        /** @description New user ID (typically from login) */
+                        newUserId: string;
+                        /** @description Optional user attributes to update */
+                        attributes?: {
+                            /** Format: email */
+                            email?: string;
+                            name?: string;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Canonical user UUID
+                             */
+                            userId: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/publisher/sdk/v1/iap-links": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Link Apple Account to subscription chain (appTransactionId ↔ originalTransactionId). Idempotent: updates last_observed_at if exists. Used for NCL attribution via webhooks. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Persistent identity: Apple appTransactionID (iOS) or SharedPrefs UUID (Android). Stable per Apple Account / Google Account per app. */
+                        appTransactionId: string;
+                        /** @description Subscription chain anchor: Apple original_transaction_id (iOS) or Google purchaseToken (Android). */
+                        originalTransactionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * Format: date-time
+                             * @description When this link was first created
+                             */
+                            firstObservedAt: string;
+                            /** @description True if this is a new link, false if existing was updated */
+                            isNew: boolean;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/promo-signature": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Generate an ECDSA signature for a StoreKit 2 promotional offer purchase. Requires a subscription key and bundle ID to be configured in the publisher portal. */
+        get: {
+            parameters: {
+                query: {
+                    productId: string;
+                    applicationUsername?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            keyId: string;
+                            offerId: string;
+                            /** Format: uuid */
+                            nonce: string;
+                            timestamp: number;
+                            signature: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/test/conversions/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Simulate a conversion postback for the Paramount+ Encore Demo campaign. Unauthenticated; hard-scoped to the demo campaign at the service layer. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Transaction ID being verified
+                         */
+                        transactionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /** Format: uuid */
+                            transactionId: string;
+                            /** @enum {string} */
+                            status: "verified" | "final_granted";
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/leads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Create a lead for async advertiser email capture */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        userId: string;
+                        /** Format: uuid */
+                        campaignId: string;
+                        /** Format: email */
+                        email: string;
+                        /** @description Trial length in days as reported by StoreKit; drives reminder scheduling. */
+                        trialDurationDays?: number | null;
+                        /**
+                         * Format: uuid
+                         * @description Client-issued UUID v4 used as the conversion attribution id; substituted into the sponsor URL at email-send time.
+                         */
+                        transactionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Created lead ID
+                             */
+                            leadId: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/tester-reveal": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Record a tester reveal ping (5-shake gesture). Used to surface the device user ID in the admin portal so a tester can be added to experiment_overrides without log access. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description SDK-assigned user ID. Same value the SDK sends as ?userId= to /config. */
+                        userId: string;
+                        /** @description Persistent person-level identifier (Apple appTransactionID on iOS). Nullable on iOS<16 / unverified. */
+                        appAccountId?: string | null;
+                        /** @enum {string} */
+                        platform: "ios" | "android";
+                        /** @description Device model identifier (e.g. iPhone15,3, Pixel 7). */
+                        deviceModel?: string | null;
+                        /** @description SDK version that fired the reveal. */
+                        sdkVersion: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/claim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Create a redemption claim for a partner offer. Creates the underlying transaction and a pending redemption. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        userId: string;
+                        campaignId: string;
+                        name?: string;
+                        /** Format: email */
+                        email?: string;
+                        phone?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Opaque token addressing this redemption (status-page URL + email/SMS) */
+                            claimToken: string;
+                            /** @description Attributable partner offer link (tracking params appended + TRANSACTION_ID substituted). Raw destination when no tracking params; "" when no destination configured. */
+                            offerUrl: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/send-offer-email": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Create a redemption claim and email the user the partner offer link + resumable status link. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        userId: string;
+                        campaignId: string;
+                        /** Format: email */
+                        email: string;
+                        name?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Opaque token addressing this redemption (status-page URL + email/SMS) */
+                            claimToken: string;
+                            /** @description Attributable partner offer link (tracking params appended + TRANSACTION_ID substituted). Raw destination when no tracking params; "" when no destination configured. */
+                            offerUrl: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/{claimToken}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Get the status of a redemption claim (verifying | ready | redeemed | expired). */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    claimToken: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description Wire status: pending→verifying, then ready/redeemed/expired
+                             * @enum {string}
+                             */
+                            status: "verifying" | "ready" | "redeemed" | "expired";
+                            /** @description Partner offer that unlocks the reward, e.g. "Apple Music" */
+                            partnerLabel: string;
+                            /**
+                             * Format: date-time
+                             * @description When the reward became redeemable
+                             */
+                            readyAt?: string;
+                            /**
+                             * Format: date-time
+                             * @description When the reward was burned
+                             */
+                            redeemedAt?: string;
+                            /** @description Campaign this claim is for — ties a deep-linked claim to its offer card */
+                            campaignId: string;
+                            /** @description Campaign name */
+                            offerName: string;
+                            /** @description One active creative for the campaign (null if none) */
+                            creative: {
+                                /** @description Partner logo image URL */
+                                logoUrl: string | null;
+                                /** @description Primary creative image URL */
+                                primaryImageUrl: string | null;
+                                /** @description Creative title */
+                                title: string | null;
+                            } | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/{claimToken}/present": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Acquire/renew the exclusive presentation lease for the ready-to-redeem screen (per deviceId). */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    claimToken: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        deviceId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description True when THIS device now holds the exclusive presentation lease */
+                            granted: boolean;
+                            /**
+                             * @description Wire status of the redemption (same mapping as the status endpoint)
+                             * @enum {string}
+                             */
+                            status: "verifying" | "ready" | "redeemed" | "expired";
+                            /**
+                             * Format: date-time
+                             * @description When the granted lease lapses unless renewed (granted only)
+                             */
+                            leaseExpiresAt?: string;
+                            /** @description Lease TTL in seconds (granted only) */
+                            ttlSeconds?: number;
+                            /** @description How often the client should re-present to renew the lease (granted only) */
+                            heartbeatIntervalSeconds?: number;
+                            /**
+                             * @description True when ready but the lease is held by another live device
+                             * @enum {boolean}
+                             */
+                            lockedByOtherDevice?: true;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/{claimToken}/release": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Release the presentation lease held by this device (per deviceId). */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    claimToken: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        deviceId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            ok: true;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/redemptions/{claimToken}/redeem": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Atomically burn a ready redemption. Dead on every device thereafter. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    claimToken: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        deviceId?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            ok: true;
+                            /**
+                             * Format: date-time
+                             * @description Server time the burn committed
+                             */
+                            redeemedAt: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Ingest analytics events (single or batch). Validates with Zod and enqueues to Kafka. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        event_id: string;
+                        event_name: string;
+                        /** Format: date-time */
+                        event_timestamp: string;
+                        distinct_id?: string;
+                        properties?: {
+                            [key: string]: unknown;
+                        };
+                    } | {
+                        /** Format: uuid */
+                        event_id: string;
+                        event_name: string;
+                        /** Format: date-time */
+                        event_timestamp: string;
+                        distinct_id?: string;
+                        properties?: {
+                            [key: string]: unknown;
+                        };
+                    }[];
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            status: string;
+                            eventsReceived: number;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        AnalyticsEventEnvelope: {
+            /** Format: uuid */
+            event_id: string;
+            event_name: string;
+            /** Format: date-time */
+            event_timestamp: string;
+            distinct_id?: string;
+            properties?: {
+                [key: string]: unknown;
+            };
+        };
+        ConfigResponse: {
+            success: boolean;
+            /** @description UI configuration: template + values */
+            ui: {
+                /**
+                 * Format: uuid
+                 * @description Selected variant ID
+                 */
+                variantId?: string | null;
+                /** @description Selected variant name */
+                variantName?: string | null;
+                /** @description Minimum SDK version for this variant */
+                minSdkVersion?: string | null;
+                /** @description SDUI template with placeholders */
+                template?: {
+                    [key: string]: unknown;
+                } | null;
+                /** @description Values to substitute into template */
+                values: {
+                    /** @description Text values for template substitution */
+                    text: {
+                        /** @description App name for ${appName} substitution */
+                        appName?: string | null;
+                        /** @description Main title text */
+                        title?: string | null;
+                        /** @description Subtitle text */
+                        subtitle?: string | null;
+                        /** @description Offer description text */
+                        offerDescription?: string | null;
+                        /** @description Instructions title */
+                        instructionsTitle?: string | null;
+                        /** @description Last step header text */
+                        lastStepHeader?: string | null;
+                        /** @description Last step description */
+                        lastStepDescription?: string | null;
+                        /** @description Credit claimed title */
+                        creditClaimedTitle?: string | null;
+                        /** @description Credit claimed subtitle */
+                        creditClaimedSubtitle?: string | null;
+                        /** @description Apply credits button text */
+                        applyCreditsButton?: string | null;
+                        /** @description Accent title text */
+                        accentTitle?: string | null;
+                        /** @description Custom headline text for SDUI variant (falls back to title) */
+                        customHeadline?: string | null;
+                        /** @description Custom subheadline text for SDUI variant (falls back to subtitle) */
+                        customSubheadline?: string | null;
+                    };
+                    /** @description Appearance values */
+                    appearance: {
+                        /**
+                         * @description Appearance mode
+                         * @enum {string|null}
+                         */
+                        mode?: "light" | "dark" | "auto" | null;
+                        /** @description Primary accent color (hex) */
+                        accentColor?: string | null;
+                        /** @description Accent title color (hex) */
+                        accentTitleColor?: string | null;
+                    };
+                };
+            };
+            /** @description Entitlement configuration (IAP or Native mode) */
+            entitlements: {
+                /** @description IAP config. If productId exists → IAP mode. */
+                iap?: {
+                    /** @description Store-level subscription product ID. App Store Connect product ID for iOS apps, Google Play subscription product ID for Android apps. */
+                    productId: string;
+                    /** @description Google Play subscription offer ID (e.g. 'free-trial-1m'). Null or omitted for iOS apps. The Android SDK uses this value to look up the matching SubscriptionOfferDetails in the product's base plan and pass its offer token to Play Billing's BillingFlowParams.setOfferToken(). */
+                    offerId?: string | null;
+                    /** @description Google Play base plan ID (e.g. 'monthly', 'annual'); null for iOS. Disambiguates products that expose multiple base plans so the Android SDK resolves the correct SubscriptionOfferDetails / price for the intended base plan instead of defaulting to the first one. */
+                    basePlanId?: string | null;
+                    /** @description Display name for the premium tier (e.g. 'Premium', 'Pro'). Used in SDUI templates via ${premiumTierName}. */
+                    premiumTierName?: string | null;
+                } | null;
+                /** @description Native/Encore-managed entitlement. Fallback if no IAP. */
+                native?: {
+                    /** @description Entitlement type (e.g., 'free_trial', 'credit', 'discount') */
+                    type: string;
+                    /** @description Raw value for template substitution (e.g., '3') */
+                    value: string;
+                    /** @description Raw unit for template substitution (e.g., 'months', 'days') */
+                    unit: string;
+                    /** @description Computed duration in days for SDK logic */
+                    durationDays: number;
+                } | null;
+            };
+            /** @description Experiment configurations */
+            experiments: {
+                /** @description NCL experiment config. Null if not configured. */
+                ncl?: {
+                    /** @description Percent of eligible users assigned to Treatment */
+                    rolloutPct: number;
+                    /** @description Epoch identifier. Change resets cohort assignments. */
+                    assignmentVersion: number;
+                    /** @description Kill switch. If false, all users go to Control. */
+                    enabled: boolean;
+                } | null;
+            };
+            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+            locale?: string;
+        };
+        OffersSearchResponse: {
+            success: boolean;
+            offers: {
+                /** Format: uuid */
+                id: string;
+                /** Format: uuid */
+                organizationId: string;
+                name: string;
+                /** @enum {string} */
+                payoutModel: "CPA" | "CPC" | "CPI" | "CPM";
+                payoutAmount: number;
+                /** @description Attribution platform (e.g., rakuten, impact, tune) */
+                attributionPlatform: string | null;
+                targetCountries: string[];
+                /**
+                 * Format: uri
+                 * @description Primary destination URL for the campaign
+                 */
+                destinationUrl: string;
+                /**
+                 * Format: date-time
+                 * @description UTC timestamp
+                 */
+                startDate: string;
+                /**
+                 * Format: date-time
+                 * @description UTC timestamp (null for ongoing)
+                 */
+                endDate: string | null;
+                /** @enum {string} */
+                status: "active" | "archived" | "awaiting_approval" | "completed" | "draft";
+                /**
+                 * @description Current validation status of the destination URL
+                 * @enum {string}
+                 */
+                linkStatus: "broken" | "error" | "text_mismatch" | "unchecked" | "valid";
+                /** @description Expected domain of the destination URL */
+                expectedDomain: string | null;
+                /** @description Internal campaign notes */
+                notes: string | null;
+                /** @description Publisher-facing notes about this offer */
+                publisherNotes: string | null;
+                priority: number | null;
+                /** @description When true, this campaign is auto-granted to every newly created app. Independent of priority (which controls ranking order only). */
+                defaultCatalog: boolean;
+                /**
+                 * @description blacklist (default): all apps eligible; whitelist: only apps in campaign_allowed_apps are eligible
+                 * @enum {string}
+                 */
+                targetingMode: "blacklist" | "whitelist";
+                /** @description New/discounted price for the offer */
+                newPrice: string | null;
+                /** @description Original price before discount */
+                oldPrice: string | null;
+                /** @description User-facing value proposition, e.g., "3 months of Hulu free". Rendered in the deal email. */
+                perk: string | null;
+                /**
+                 * @description Constrained promo badge for in-app offer cards: free_trial | discount. Drives the card pill display AND client-side free-trial-vs-discount logic. Clients map the enum to display text + free-trial boolean. NULL means no badge.
+                 * @enum {string|null}
+                 */
+                badgeLabel: "free_trial" | "discount" | null;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+                /** @description Included when fetching with relations */
+                organization?: {
+                    /** Format: uuid */
+                    id: string;
+                    name: string;
+                    description: string | null;
+                    url: string | null;
+                    logoUrl: string | null;
+                    /** Format: date-time */
+                    createdAt: string;
+                    /** Format: date-time */
+                    updatedAt: string;
+                };
+                /** @description Included if includeCreatives=true */
+                creatives?: {
+                    /** Format: uuid */
+                    id: string;
+                    /** Format: uuid */
+                    campaignId: string;
+                    name: string;
+                    title: string;
+                    subtitle: string | null;
+                    description: string | null;
+                    /** Format: uri */
+                    primaryImageUrl: string;
+                    /** Format: uri */
+                    logoUrl: string | null;
+                    additionalImages: string[] | null;
+                    ctaText: string;
+                    /**
+                     * Format: uri
+                     * @description Optional override for campaign destinationUrl
+                     */
+                    destinationUrl: string | null;
+                    trackingParameters: {
+                        [key: string]: unknown;
+                    } | null;
+                    weight: number | null;
+                    /** @enum {string} */
+                    status: "active" | "archived" | "draft" | "paused";
+                    instructions: {
+                        title: string;
+                        subtitle: string;
+                        ctaButtonText?: string;
+                    }[] | null;
+                    /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
+                    quickInstructions: string | null;
+                    /** @description Minimum SDK version required (null = no minimum) */
+                    minSdkVersion: string | null;
+                    /** @description Maximum SDK version supported (null = no maximum) */
+                    maxSdkVersion: string | null;
+                    /** @description Platforms this creative supports (empty = all platforms) */
+                    supportedPlatforms: ("android" | "ios" | "web")[] | null;
+                    /** @description Tooltip text to display on hover in Web SDK offer carousel (null = use default text) */
+                    tooltipText: string | null;
+                    /** @description Optional dynamic text overlay config. NULL = no overlay (legacy creatives). */
+                    overlayConfig?: {
+                        /** @enum {number} */
+                        version: 1;
+                        aspectRatio?: number;
+                        overlays: {
+                            id: string;
+                            /** @description Template string resolved via SDUIContext.resolveTemplateText (e.g., '${premiumTierName}') */
+                            template: string;
+                            /** @description Top-left of the zone, as ratios of the rendered image */
+                            position: {
+                                x: number;
+                                y: number;
+                            };
+                            dimensions: {
+                                width: number;
+                                height: number;
+                            };
+                            /**
+                             * @description Horizontal alignment for wrapped text within the zone
+                             * @enum {string}
+                             */
+                            alignment: "leading" | "center" | "trailing";
+                            typography: {
+                                fontSizeRatio: number;
+                                fontWeight: string;
+                                color: {
+                                    hex: string;
+                                } | {
+                                    semantic: string;
+                                } | {
+                                    appearance: string;
+                                };
+                                lineHeight?: number;
+                                letterSpacing?: number;
+                            };
+                            overflow?: {
+                                minScaleFactor?: number;
+                                maxLines?: number;
+                                /** @enum {string} */
+                                truncation?: "head" | "middle" | "tail" | "clip";
+                            };
+                        }[];
+                    } | null;
+                    /** Format: date-time */
+                    createdAt: string;
+                    /** Format: date-time */
+                    updatedAt: string;
+                }[];
+            }[];
+            metadata: {
+                /** @description Total offers available */
+                total: number;
+                limit: number;
+                offset: number;
+                /** @description Whether there are more offers available */
+                hasMore: boolean;
+                executionTimeMs: number;
+                /**
+                 * Format: uuid
+                 * @description Session ID used for randomization - use this for subsequent pagination requests
+                 */
+                requestId: string;
+            };
+            /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
+            locale?: string;
+            error?: string | null;
+        };
+        Campaign: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            organizationId: string;
+            name: string;
+            /** @enum {string} */
+            payoutModel: "CPA" | "CPC" | "CPI" | "CPM";
+            payoutAmount: number;
+            /** @description Attribution platform (e.g., rakuten, impact, tune) */
+            attributionPlatform: string | null;
+            targetCountries: string[];
+            /**
+             * Format: uri
+             * @description Primary destination URL for the campaign
+             */
+            destinationUrl: string;
+            /**
+             * Format: date-time
+             * @description UTC timestamp
+             */
+            startDate: string;
+            /**
+             * Format: date-time
+             * @description UTC timestamp (null for ongoing)
+             */
+            endDate: string | null;
+            /** @enum {string} */
+            status: "active" | "archived" | "awaiting_approval" | "completed" | "draft";
+            /**
+             * @description Current validation status of the destination URL
+             * @enum {string}
+             */
+            linkStatus: "broken" | "error" | "text_mismatch" | "unchecked" | "valid";
+            /** @description Expected domain of the destination URL */
+            expectedDomain: string | null;
+            /** @description Internal campaign notes */
+            notes: string | null;
+            /** @description Publisher-facing notes about this offer */
+            publisherNotes: string | null;
+            priority: number | null;
+            /** @description When true, this campaign is auto-granted to every newly created app. Independent of priority (which controls ranking order only). */
+            defaultCatalog: boolean;
+            /**
+             * @description blacklist (default): all apps eligible; whitelist: only apps in campaign_allowed_apps are eligible
+             * @enum {string}
+             */
+            targetingMode: "blacklist" | "whitelist";
+            /** @description New/discounted price for the offer */
+            newPrice: string | null;
+            /** @description Original price before discount */
+            oldPrice: string | null;
+            /** @description User-facing value proposition, e.g., "3 months of Hulu free". Rendered in the deal email. */
+            perk: string | null;
+            /**
+             * @description Constrained promo badge for in-app offer cards: free_trial | discount. Drives the card pill display AND client-side free-trial-vs-discount logic. Clients map the enum to display text + free-trial boolean. NULL means no badge.
+             * @enum {string|null}
+             */
+            badgeLabel: "free_trial" | "discount" | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+            /** @description Included when fetching with relations */
+            organization?: {
+                /** Format: uuid */
+                id: string;
+                name: string;
+                description: string | null;
+                url: string | null;
+                logoUrl: string | null;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+            };
+            /** @description Included if includeCreatives=true */
+            creatives?: {
+                /** Format: uuid */
+                id: string;
+                /** Format: uuid */
+                campaignId: string;
+                name: string;
+                title: string;
+                subtitle: string | null;
+                description: string | null;
+                /** Format: uri */
+                primaryImageUrl: string;
+                /** Format: uri */
+                logoUrl: string | null;
+                additionalImages: string[] | null;
+                ctaText: string;
+                /**
+                 * Format: uri
+                 * @description Optional override for campaign destinationUrl
+                 */
+                destinationUrl: string | null;
+                trackingParameters: {
+                    [key: string]: unknown;
+                } | null;
+                weight: number | null;
+                /** @enum {string} */
+                status: "active" | "archived" | "draft" | "paused";
+                instructions: {
+                    title: string;
+                    subtitle: string;
+                    ctaButtonText?: string;
+                }[] | null;
+                /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
+                quickInstructions: string | null;
+                /** @description Minimum SDK version required (null = no minimum) */
+                minSdkVersion: string | null;
+                /** @description Maximum SDK version supported (null = no maximum) */
+                maxSdkVersion: string | null;
+                /** @description Platforms this creative supports (empty = all platforms) */
+                supportedPlatforms: ("android" | "ios" | "web")[] | null;
+                /** @description Tooltip text to display on hover in Web SDK offer carousel (null = use default text) */
+                tooltipText: string | null;
+                /** @description Optional dynamic text overlay config. NULL = no overlay (legacy creatives). */
+                overlayConfig?: {
+                    /** @enum {number} */
+                    version: 1;
+                    aspectRatio?: number;
+                    overlays: {
+                        id: string;
+                        /** @description Template string resolved via SDUIContext.resolveTemplateText (e.g., '${premiumTierName}') */
+                        template: string;
+                        /** @description Top-left of the zone, as ratios of the rendered image */
+                        position: {
+                            x: number;
+                            y: number;
+                        };
+                        dimensions: {
+                            width: number;
+                            height: number;
+                        };
+                        /**
+                         * @description Horizontal alignment for wrapped text within the zone
+                         * @enum {string}
+                         */
+                        alignment: "leading" | "center" | "trailing";
+                        typography: {
+                            fontSizeRatio: number;
+                            fontWeight: string;
+                            color: {
+                                hex: string;
+                            } | {
+                                semantic: string;
+                            } | {
+                                appearance: string;
+                            };
+                            lineHeight?: number;
+                            letterSpacing?: number;
+                        };
+                        overflow?: {
+                            minScaleFactor?: number;
+                            maxLines?: number;
+                            /** @enum {string} */
+                            truncation?: "head" | "middle" | "tail" | "clip";
+                        };
+                    }[];
+                } | null;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+            }[];
+        };
+        Creative: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            campaignId: string;
+            name: string;
+            title: string;
+            subtitle: string | null;
+            description: string | null;
+            /** Format: uri */
+            primaryImageUrl: string;
+            /** Format: uri */
+            logoUrl: string | null;
+            additionalImages: string[] | null;
+            ctaText: string;
+            /**
+             * Format: uri
+             * @description Optional override for campaign destinationUrl
+             */
+            destinationUrl: string | null;
+            trackingParameters: {
+                [key: string]: unknown;
+            } | null;
+            weight: number | null;
+            /** @enum {string} */
+            status: "active" | "archived" | "draft" | "paused";
+            instructions: {
+                title: string;
+                subtitle: string;
+                ctaButtonText?: string;
+            }[] | null;
+            /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
+            quickInstructions: string | null;
+            /** @description Minimum SDK version required (null = no minimum) */
+            minSdkVersion: string | null;
+            /** @description Maximum SDK version supported (null = no maximum) */
+            maxSdkVersion: string | null;
+            /** @description Platforms this creative supports (empty = all platforms) */
+            supportedPlatforms: ("android" | "ios" | "web")[] | null;
+            /** @description Tooltip text to display on hover in Web SDK offer carousel (null = use default text) */
+            tooltipText: string | null;
+            /** @description Optional dynamic text overlay config. NULL = no overlay (legacy creatives). */
+            overlayConfig?: {
+                /** @enum {number} */
+                version: 1;
+                aspectRatio?: number;
+                overlays: {
+                    id: string;
+                    /** @description Template string resolved via SDUIContext.resolveTemplateText (e.g., '${premiumTierName}') */
+                    template: string;
+                    /** @description Top-left of the zone, as ratios of the rendered image */
+                    position: {
+                        x: number;
+                        y: number;
+                    };
+                    dimensions: {
+                        width: number;
+                        height: number;
+                    };
+                    /**
+                     * @description Horizontal alignment for wrapped text within the zone
+                     * @enum {string}
+                     */
+                    alignment: "leading" | "center" | "trailing";
+                    typography: {
+                        fontSizeRatio: number;
+                        fontWeight: string;
+                        color: {
+                            hex: string;
+                        } | {
+                            semantic: string;
+                        } | {
+                            appearance: string;
+                        };
+                        lineHeight?: number;
+                        letterSpacing?: number;
+                    };
+                    overflow?: {
+                        minScaleFactor?: number;
+                        maxLines?: number;
+                        /** @enum {string} */
+                        truncation?: "head" | "middle" | "tail" | "clip";
+                    };
+                }[];
+            } | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        /** @description Included when fetching with relations */
+        Organization: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+            description: string | null;
+            url: string | null;
+            logoUrl: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        TransactionResponse: {
+            success: boolean;
+            /**
+             * Format: uuid
+             * @description Created transaction ID
+             */
+            transactionId?: string;
+            /** @description Generated advertiser SDK token */
+            token?: string;
+            /**
+             * Format: date-time
+             * @description When token expires
+             */
+            expiresAt?: string;
+            /** @description Domain where token can be activated */
+            allowedDomain?: string;
+            error?: string | null;
+        };
+        SignalResponse: {
+            success: boolean;
+            error?: string | null;
+        };
+        EntitlementsResponse: {
+            success: boolean;
+            /** @description Provisional entitlements (temporary, require conversion) */
+            provisional: {
+                /** @description Free trial entitlement details */
+                freeTrial?: {
+                    /**
+                     * Format: date-time
+                     * @description Start date of the entitlement (ISO8601)
+                     */
+                    startedAt: string | null;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+                /** @description Available discount entitlements */
+                discounts?: {
+                    /** @description Discount value */
+                    value: number;
+                    /**
+                     * @description Discount unit
+                     * @enum {string}
+                     */
+                    unit: "percent" | "dollars";
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                }[];
+                /** @description Available credit entitlements */
+                credits?: {
+                    /** @description Total credit amount */
+                    totalAmount: number;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+            };
+            /** @description Verified entitlements (permanent, earned through conversion) */
+            verified: {
+                /** @description Free trial entitlement details */
+                freeTrial?: {
+                    /**
+                     * Format: date-time
+                     * @description Start date of the entitlement (ISO8601)
+                     */
+                    startedAt: string | null;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+                /** @description Available discount entitlements */
+                discounts?: {
+                    /** @description Discount value */
+                    value: number;
+                    /**
+                     * @description Discount unit
+                     * @enum {string}
+                     */
+                    unit: "percent" | "dollars";
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                }[];
+                /** @description Available credit entitlements */
+                credits?: {
+                    /** @description Total credit amount */
+                    totalAmount: number;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+            };
+            /** @description All accumulated entitlements (combines verified + provisional with full original values) */
+            all: {
+                /** @description Free trial entitlement details */
+                freeTrial?: {
+                    /**
+                     * Format: date-time
+                     * @description Start date of the entitlement (ISO8601)
+                     */
+                    startedAt: string | null;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+                /** @description Available discount entitlements */
+                discounts?: {
+                    /** @description Discount value */
+                    value: number;
+                    /**
+                     * @description Discount unit
+                     * @enum {string}
+                     */
+                    unit: "percent" | "dollars";
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                }[];
+                /** @description Available credit entitlements */
+                credits?: {
+                    /** @description Total credit amount */
+                    totalAmount: number;
+                    /**
+                     * Format: date-time
+                     * @description Expiration date (ISO8601)
+                     */
+                    expiresAt: string | null;
+                };
+            };
+            /** @description Request execution time in milliseconds */
+            executionTimeMs: number;
+        };
+        VerificationStatusResponse: {
+            success: boolean;
+            /**
+             * @description Transaction status
+             * @enum {string|null}
+             */
+            status: "pending_conversion" | "provisional_granted" | "verified" | "final_granted" | "expired" | "failed" | null;
+            error?: string | null;
+        };
+        InitUserResponse: {
+            success: boolean;
+            /**
+             * Format: uuid
+             * @description Canonical user UUID
+             */
+            userId: string;
+            /** @description True if user was created, false if already existed */
+            isNew: boolean;
+        };
+        IdentifyUserResponse: {
+            success: boolean;
+            /**
+             * Format: uuid
+             * @description Canonical user UUID
+             */
+            userId: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;
+//# sourceMappingURL=types.d.ts.map