/**
 * This file was auto-generated by openapi-typescript.
 * Do not make direct changes to the file.
 */

export interface paths {
    "/auth/sessions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Authenticate a demo merchant user
         * @description Creates a revocable server-side session. Expected credential failures are
         *     externally indistinguishable. The response sets the host-only
         *     `__Host-zpa_session` cookie; the raw token is never present in JSON.
         */
        post: operations["createAuthSession"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/auth/session": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get the current session summary */
        get: operations["getAuthSession"];
        put?: never;
        post?: never;
        /**
         * Revoke the current session
         * @description Revokes server-side state before expiring the browser cookie.
         */
        delete: operations["deleteAuthSession"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/periods": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List approved reporting periods
         * @description Returns every complete allowlisted day, Iranian week, Jalali month, and
         *     Persian season inside the imported dataset's local-date coverage, with
         *     server-calculated UTC and Tehran-local half-open boundaries. Periods are
         *     grouped by type and ordered newest-first inside each group. Clients start
         *     runs with a returned `periodId` and never submit arbitrary timestamps.
         */
        get: operations["listAnalyticsPeriods"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/terminals": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List terminals owned by the authenticated merchant
         * @description Returns display-safe terminal choices scoped exclusively from the authenticated server session.
         */
        get: operations["listMerchantTerminals"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/runs": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Create or return the current analytics run
         * @description Idempotently resolves the current merchant/dataset/metric version
         *     and starts only missing sections. Equivalent concurrent starts deduplicate.
         */
        post: operations["createAnalyticsRun"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/runs/{runId}": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
            };
            cookie?: never;
        };
        /** Get the current run snapshot */
        get: operations["getAnalyticsRun"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/runs/{runId}/events": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
            };
            cookie?: never;
        };
        /**
         * Stream partial analytics results
         * @description Authenticated SSE stream. Events are retained for one hour. A retained
         *     `Last-Event-ID` replays only later events. Missing, invalid, unauthorized,
         *     or expired ids reset safely by emitting `run.snapshot` with
         *     `recovery=RESET_TO_SNAPSHOT`, then continuing from new events.
         *
         *     Event types are `run.snapshot`, `section.started`, `section.ready`,
         *     `section.failed`, `section.suppressed`, `run.completed`, and `heartbeat`.
         *     Each event has an opaque `id` and one-line JSON `data` matching one of the
         *     schemas named by `AnalyticsSseEvent`.
         */
        get: operations["streamAnalyticsRunEvents"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/runs/{runId}/sections/{sectionId}/retry-attempts": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
                sectionId: components["parameters"]["SectionIdPath"];
            };
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Retry one exhausted failed section
         * @description Does not clear or restart ready sibling sections.
         */
        post: operations["createAnalyticsSectionRetryAttempt"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/session-details": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List authorized merchant-owned session evidence
         * @description Cursor-paginated detail rows for one approved period and view. Stable
         *     ordering is `createdAt DESC, sessionId DESC`. The server binds cursors to
         *     merchant, filters, and ordering. Cross-tenant and absent ids are not
         *     distinguishable.
         */
        get: operations["listAnalyticsSessionDetails"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/sessions/{sessionId}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get one merchant-owned payment session and attempt history */
        get: operations["getAnalyticsSession"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/session-details.csv": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Export the authorized detail view as CSV
         * @description Uses the same tenant scope, approved period, filters, and allowlisted
         *     projection as `listAnalyticsSessionDetails`. Cursor and page limit do not
         *     apply. Output is UTF-8 with a BOM, a Persian header row whose labels use
         *     normal spaces, comma separators, CRLF records, and RFC 4180 quoting.
         *
         *     Stable columns are:
         *     `شناسه نشست پرداخت`, `شناسه پایانه`, `وضعیت پرداخت`, `مبلغ ریال`,
         *     `کارمزد ریال`, `زمان ایجاد`, `زمان انقضا`, `تعداد تلاش`,
         *     `وضعیت آخرین تلاش`, `زمان آخرین تلاش`, `زمان تأیید`, `زمان تسویه`,
         *     `مرحله مشاهده شده شکست`.
         *
         *     CSV status labels are Persian: `Paid` is `پرداخت شده و تأیید نشده`,
         *     `Verified` is `تأیید شده`, `Failed` is `ناموفق`, `Reversed` is
         *     `برگشت خورده`, and `InBank` is `در بانک`. Numeric cells remain plain
         *     calculation-safe numbers and timestamps remain UTC ISO values.
         *
         *     Columns unavailable to the chosen authorized view are empty. Payer tokens,
         *     credentials, peer data, internal ids, and any field unavailable in the JSON
         *     detail view are forbidden. Potential spreadsheet formulas in textual cells
         *     are prefixed with an apostrophe before CSV quoting.
         */
        get: operations["exportAnalyticsSessionDetailsCsv"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/growth-reports": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Create or reuse a growth report */
        post: operations["createGrowthReport"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/growth-reports/latest": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["getLatestGrowthReport"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/growth-reports/{reportId}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["getGrowthReport"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/growth-reports/{reportId}/events": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["streamGrowthReportEvents"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/ai-insights/{module}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Return the latest persisted insight without waiting for generation */
        get: operations["getLatestAIInsight"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/ai-insights/{module}/refreshes": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Enqueue an independent insight refresh */
        post: operations["refreshAIInsight"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/ai-insights/{module}/sections/{sectionId}/refreshes": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Refresh one independently persisted AI narrative section */
        post: operations["refreshAIInsightSection"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/ai-insight-refreshes/{jobId}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["getAIInsightRefresh"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/analytics/ai-insight-refreshes/{jobId}/events": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Replay up to one hour of durable job events and continue as SSE */
        get: operations["streamAIInsightRefreshEvents"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Return a terminal coach workspace or an all-terminal rollup */
        get: operations["getGrowthCoachDashboard"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/terminals/{terminalId}/profile": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["getGrowthCoachProfile"];
        put: operations["putGrowthCoachProfile"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/terminals/{terminalId}/refreshes": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["refreshGrowthCoach"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/plans": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["listGrowthCoachPlans"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/actions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["listGoldenSteps"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/goals": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["listMonthlyGoals"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/goals/{goalId}/subtasks/{subtaskId}/transitions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["transitionGoalSubtask"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/deadline-proposals/{proposalId}/decisions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["decideGoalDeadlineProposal"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/recommendations/{id}/decisions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["decideGrowthCoachRecommendation"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/actions/{id}/transitions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["transitionGoldenStep"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/difficulty-proposals/{id}/decisions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post: operations["decideGrowthCoachDifficulty"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/refreshes/{jobId}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["getGrowthCoachJob"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/growth-coach/refreshes/{jobId}/events": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get: operations["streamGrowthCoachJob"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
}
export type webhooks = Record<string, never>;
export interface components {
    schemas: {
        GrowthCoachProfileInput: {
            businessDescription: string;
            niches: string[];
            salesChannels: string[];
            primaryGoal: string;
            constraints: string;
        };
        GrowthCoachProfile: components["schemas"]["GrowthCoachProfileInput"] & {
            profileId: string;
            terminalId: string;
            version: number;
            difficulty: number;
            /** Format: date-time */
            createdAt: string;
        };
        GrowthCoachJob: {
            jobId: string;
            /** @enum {string} */
            state: "QUEUED" | "RUNNING" | "COMPLETED" | "FAILED";
            eventsUrl: string;
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            updatedAt: string;
        };
        GrowthCoachRefreshInput: {
            /** @enum {string} */
            cadence: "WEEKLY" | "MONTHLY";
        };
        GrowthCoachProfileResult: {
            profile: components["schemas"]["GrowthCoachProfile"];
            generationJobs: components["schemas"]["GrowthCoachJob"][];
            pageInsightJobs: components["schemas"]["AIInsightJob"][];
        };
        GrowthCoachRecommendation: {
            recommendationId: string;
            planId: string;
            rank: number;
            /** @enum {string} */
            status: "OFFERED" | "ACCEPTED" | "REJECTED" | "EXPIRED";
            /** @enum {string} */
            actionType: "MANUAL" | "METRIC";
            title: string;
            rationale: string;
            expectedImpact: string;
            /** @enum {string} */
            effort: "LOW" | "MEDIUM" | "HIGH";
            evidenceIds: string[];
            metricId?: string | null;
            metricDirection?: string | null;
            actionLevel?: string | null;
            baseline?: number | null;
            target?: number | null;
            /** Format: int64 */
            sampleSize: number;
            /** Format: date */
            deadline: string;
            subtasks: components["schemas"]["GeneratedGoalSubtask"][];
            eventIds: string[];
        };
        GeneratedGoalSubtask: {
            title: string;
            /** Format: date */
            deadline: string | null;
            eventId: string | null;
        };
        GoalSubtask: {
            subtaskId: string;
            position: number;
            title: string;
            /** @enum {string} */
            status: "TODO" | "DONE";
            /** Format: date */
            deadline: string;
            eventId?: string | null;
            /** Format: date-time */
            completedAt?: string | null;
        };
        GoalDeadlineProposal: {
            proposalId: string;
            goalId: string;
            subtaskId: string;
            eventId: string;
            /** Format: date */
            currentDeadline: string;
            /** Format: date */
            proposedDeadline: string;
            reason: string;
            /** @enum {string} */
            status: "OFFERED" | "ACCEPTED" | "REJECTED" | "EXPIRED";
            /** Format: date-time */
            decidedAt?: string | null;
        };
        MonthlyGoal: {
            goalId: string;
            recommendationId: string;
            terminalId: string;
            title: string;
            expectedImpact: string;
            /** @enum {string} */
            status: "ACTIVE" | "COMPLETED" | "MISSED" | "ABANDONED";
            /** @enum {string} */
            metricId: "paid_count" | "paid_amount" | "fee_amount" | "avg_latency" | "success_rate";
            /** @enum {string} */
            metricDirection: "INCREASE" | "DECREASE";
            baseline: number;
            target: number;
            currentValue: number;
            progressPercent: number;
            /** Format: int64 */
            sampleSize: number;
            /** Format: date */
            deadline: string;
            eventIds: string[];
            subtasks: components["schemas"]["GoalSubtask"][];
            deadlineProposals: components["schemas"]["GoalDeadlineProposal"][];
            /** Format: date-time */
            updatedAt: string;
        };
        GrowthCoachPlan: {
            planId: string;
            parentId?: string | null;
            /** @enum {string} */
            cadence: "DAILY" | "WEEKLY" | "MONTHLY";
            status: string;
            /** Format: date */
            periodStart: string;
            /** Format: date */
            periodEnd: string;
            dailyBrief?: string | null;
            difficulty: number;
            suggestions: components["schemas"]["GrowthCoachRecommendation"][];
            /** Format: date-time */
            generatedAt: string;
        };
        GoldenStep: {
            actionId: string;
            recommendationId: string;
            terminalId: string;
            /** @enum {string} */
            actionType: "MANUAL" | "METRIC";
            title: string;
            /** @enum {string} */
            status: "NOT_STARTED" | "IN_PROGRESS" | "COMPLETED" | "ABANDONED" | "MISSED";
            metricId?: string | null;
            metricDirection?: string | null;
            baseline?: number | null;
            target?: number | null;
            currentValue?: number | null;
            /** Format: int64 */
            sampleSize: number;
            /** Format: date */
            deadline: string;
            /** Format: date-time */
            updatedAt: string;
        };
        GrowthCoachTerminalRollup: {
            terminalId: string;
            /** @enum {string} */
            onboardingStatus: "REQUIRED" | "COMPLETE";
            activeActions: number;
            overdueActions: number;
            completionRate: number;
        };
        GrowthCoachDashboard: {
            /** @enum {string} */
            scope: "TERMINAL" | "ALL_TERMINALS";
            terminalId?: string | null;
            /** Format: date */
            dataThrough?: string | null;
            /** @enum {string} */
            generationState: "ONBOARDING_REQUIRED" | "GENERATING" | "IDLE" | "UNAVAILABLE";
            profile?: components["schemas"]["GrowthCoachProfile"] | null;
            plans: components["schemas"]["GrowthCoachPlan"][];
            actions: components["schemas"]["GoldenStep"][];
            terminals: components["schemas"]["GrowthCoachTerminalRollup"][];
            difficultyProposals: components["schemas"]["GrowthCoachDifficultyProposal"][];
        };
        GrowthCoachDifficultyProposal: {
            proposalId: string;
            fromLevel: number;
            toLevel: number;
            reason: string;
            /** @enum {string} */
            status: "OFFERED" | "ACCEPTED" | "REJECTED" | "EXPIRED";
        };
        CoachDecision: {
            /** @enum {string} */
            decision: "ACCEPTED" | "REJECTED";
            reason: string;
            note: string;
        };
        CreateGrowthReportRequest: {
            terminalId?: string;
            /** @description When omitted, the request reuses the current matching report. Manual retries remain available until the requested scope has persisted AI copy. */
            refresh?: boolean;
        };
        GrowthRange: {
            /** Format: int64 */
            p10: number;
            /** Format: int64 */
            p50: number;
            /** Format: int64 */
            p90: number;
        };
        GrowthForecastPoint: {
            /** Format: date-time */
            date: string;
            /** Format: int64 */
            baselineSessions: number;
            /** Format: int64 */
            baselineAmountRial: number;
            paidSessions: components["schemas"]["GrowthRange"];
            paidAmountRial: components["schemas"]["GrowthRange"];
            eventIds?: string[];
        };
        GrowthForecast: {
            /** Format: date-time */
            startDate: string;
            /** @enum {integer} */
            horizonDays: 90;
            /** @enum {string} */
            confidence: "HIGH" | "MEDIUM" | "LOW" | "INSUFFICIENT_DATA";
            suppressionReason?: string;
            points: components["schemas"]["GrowthForecastPoint"][];
            backtest: {
                origins: number;
                /** Format: int64 */
                sessionMapeBps: number;
                /** Format: int64 */
                amountMapeBps: number;
                /** Format: int64 */
                intervalCoverageBps: number;
            };
        };
        GrowthHistoricalWin: {
            evidenceId: string;
            eventId: string;
            eventTitleFa: string;
            /** Format: date-time */
            startDate: string;
            /** Format: date-time */
            endDate: string;
            eligible?: boolean;
            suppressionReason?: string;
            observationCount?: number;
            /** Format: int64 */
            baselineSessionCount?: number;
            /** Format: int64 */
            baselinePaidSessions?: number;
            /** Format: int64 */
            baselineAmountRial?: number;
            /** Format: int64 */
            actualSessionCount?: number;
            /** Format: int64 */
            actualPaidSessions?: number;
            /** Format: int64 */
            actualAmountRial?: number;
            /** Format: int64 */
            sessionUpliftBps?: number;
            /** Format: int64 */
            paidSessionUpliftBps?: number;
            /** Format: int64 */
            amountUpliftBps?: number;
            materialWin: boolean;
            materialDecline?: boolean;
        };
        GrowthOpportunity: {
            evidenceId: string;
            eventId: string;
            eventTitleFa: string;
            /** Format: date-time */
            date: string;
            /** Format: int64 */
            similarityBps: number;
            expectedSessions: components["schemas"]["GrowthRange"];
            expectedAmountRial: components["schemas"]["GrowthRange"];
            historicalEvidenceId: string;
        };
        GrowthHistoricalEventEvidence: {
            /** Format: date-time */
            priorStartDate: string;
            /** Format: date-time */
            priorEndDate: string;
            /** @description Number of eligible comparison windows used to establish the baseline. */
            observationCount: number;
            /** Format: int64 */
            paidSessionUpliftBps: number;
            /** Format: int64 */
            amountUpliftBps: number;
            materialWin: boolean;
            materialDecline: boolean;
        };
        GrowthProfileEventEvidence: {
            matchedSignals: string[];
            historyUnavailableReason?: components["schemas"]["GrowthHistoryUnavailableReason"];
        };
        /** @enum {string} */
        GrowthHistoryUnavailableReason: "INSUFFICIENT_BASELINE_OBSERVATIONS" | "INSUFFICIENT_BASELINE_SESSIONS" | "INSUFFICIENT_HISTORY" | "INCOMPLETE_EVENT_WINDOW" | "INSUFFICIENT_COHORT" | "TERMINAL_SCOPE_UNSUPPORTED";
        GrowthUpcomingEventCommon: {
            evidenceId: string;
            eventId: string;
            occasionKey: string;
            /** @enum {string} */
            eventVariant: "PRIMARY" | "CAMPAIGN_WINDOW" | "OPERATIONAL_WINDOW";
            eventTitleFa: string;
            /** Format: date-time */
            date: string;
            /** Format: date-time */
            endDate: string;
            eventType: string;
            officialHoliday: boolean;
            merchantCategories: string[];
            behavioralChannels: string[];
        };
        GrowthUpcomingHistoricalEvent: components["schemas"]["GrowthUpcomingEventCommon"] & {
            /** @enum {string} */
            insightBasis: "HISTORICAL";
            historicalEvidence: components["schemas"]["GrowthHistoricalEventEvidence"];
        } & {
            /**
             * @description discriminator enum property added by openapi-typescript
             * @enum {string}
             */
            insightBasis: "HISTORICAL";
        };
        GrowthUpcomingProfileEvent: components["schemas"]["GrowthUpcomingEventCommon"] & {
            /** @enum {string} */
            insightBasis: "BUSINESS_PROFILE";
            profileEvidence: components["schemas"]["GrowthProfileEventEvidence"];
        } & {
            /**
             * @description discriminator enum property added by openapi-typescript
             * @enum {string}
             */
            insightBasis: "BUSINESS_PROFILE";
        };
        GrowthUpcomingEvent: components["schemas"]["GrowthUpcomingHistoricalEvent"] | components["schemas"]["GrowthUpcomingProfileEvent"];
        /** @description Exactly three recommendations are returned in descending priority order. Their positive integer priorityPercent values sum to 100. */
        GrowthEventRecommendation: {
            evidenceId: string;
            priorityPercent: number;
            /** @enum {string} */
            stance: "PROMOTE" | "PREPARE" | "CAUTION";
            /** @enum {string} */
            insightBasis: "HISTORICAL" | "BUSINESS_PROFILE";
            relevanceReason: string;
        };
        GrowthRisk: {
            evidenceId: string;
            /** Format: date-time */
            date: string;
            /** Format: date-time */
            endDate?: string;
            /**
             * Format: int64
             * @description At least one decline dimension is 2000 BPS or greater.
             */
            sessionDeclineBps: number;
            /**
             * Format: int64
             * @description At least one decline dimension is 2000 BPS or greater.
             */
            amountDeclineBps: number;
            expectedSessions: components["schemas"]["GrowthRange"];
            expectedAmountRial: components["schemas"]["GrowthRange"];
        };
        GrowthPeer: {
            /** @enum {string} */
            state: "READY" | "SUPPRESSED";
            reason?: string;
            eligiblePeerCount: number;
            /** Format: int64 */
            combinedPeerSessionCount: number;
            /** Format: int64 */
            medianPaidSessions: number;
            /** Format: int64 */
            percentileBps: number;
        };
        GrowthCampaignBrief: {
            headline: string;
            interpretation: string;
            offerSuggestion: string;
            messageSuggestion: string;
            preparationAction: string;
            limitation: string;
            evidenceIds: string[];
        };
        GrowthFallbackBrief: {
            headlineFa: string;
            guidanceFa: string;
            offerFa: string;
            messageFa: string;
            preparationFa: string;
            limitationFa: string;
            evidenceIds: string[];
        };
        GrowthEvidence: {
            events: components["schemas"]["GrowthUpcomingEvent"][];
            merchantContext: {
                category: string;
                niches: string[];
                salesChannels: string[];
                businessDescriptions?: string[];
            };
        };
        GrowthReport: {
            reportId: string;
            revision: number;
            /** @enum {string} */
            status: "QUEUED" | "ANALYZING" | "GENERATING" | "READY" | "PARTIAL" | "FAILED";
            scope: {
                terminalId?: string | null;
            };
            /** @enum {integer} */
            horizonDays: 90;
            deterministicEvidence?: components["schemas"]["GrowthEvidence"];
            aiCopy?: {
                /** @description Ranked in descending priorityPercent order; the three percentages sum to exactly 100. */
                eventRecommendations: components["schemas"]["GrowthEventRecommendation"][];
            };
            failureCode?: string;
            cached: boolean;
            stale: boolean;
            /**
             * Format: date-time
             * @description Current time while no AI summary exists for the scope; otherwise the next refresh boundary for that terminal scope in the Tehran day. The all-terminals selection is a separate scope.
             */
            nextRefreshAt: string;
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            updatedAt: string;
            /** Format: uri-reference */
            eventsUrl: string;
        };
        /** @enum {string} */
        AIInsightModule: "overview" | "payments" | "fees" | "peers" | "transactions" | "growth";
        AIInsightNarrative: {
            headline: string;
            body: string;
            evidenceIds: string[];
        };
        AIInsightFinding: {
            evidenceId: string;
            title: string;
            summary: string;
            scoreBps: number;
            /** @enum {string} */
            confidence: "HIGH" | "MEDIUM" | "LOW" | "INSUFFICIENT_DATA";
        };
        AIInsightOption: {
            title: string;
            description: string;
            evidenceIds: string[];
        };
        AIInsightCopy: {
            past: components["schemas"]["AIInsightNarrative"];
            latestObserved: components["schemas"]["AIInsightNarrative"];
            future7Days: components["schemas"]["AIInsightNarrative"];
            future30Days: components["schemas"]["AIInsightNarrative"];
            future90Days?: components["schemas"]["AIInsightNarrative"];
            findings: components["schemas"]["AIInsightFinding"][];
            options: components["schemas"]["AIInsightOption"][];
        };
        AIInsight: {
            insightId: string;
            module: components["schemas"]["AIInsightModule"];
            revision: number;
            /** @enum {string} */
            status: "READY" | "PARTIAL";
            scope: {
                terminalId?: string | null;
                periodId?: string | null;
            };
            /** Format: date */
            asOfDate: string;
            /** Format: date */
            dataThroughDate: string;
            /** Format: date */
            forecastStartDate: string;
            /** @enum {string} */
            freshness: "FRESH" | "LAGGING" | "STALE";
            dataLagDays: number;
            /** @enum {string} */
            confidence: "HIGH" | "MEDIUM" | "LOW" | "INSUFFICIENT_DATA";
            copy: components["schemas"]["AIInsightCopy"];
            evidence: {
                [key: string]: unknown;
            };
            calendarContext: {
                [key: string]: unknown;
            }[];
            refreshState: {
                [key: string]: unknown;
            };
            sectionRefreshState: {
                [key: string]: components["schemas"]["AIInsightRefreshState"];
            };
            /** Format: date-time */
            generatedAt: string;
        };
        AIInsightRefreshRequest: {
            terminalId?: string;
            /** @description Server-offered reporting period used to match the visible analytics run. */
            periodId?: string;
        };
        AIInsightJob: {
            jobId: string;
            snapshotId: string;
            module: components["schemas"]["AIInsightModule"];
            /** @enum {string} */
            sectionId: "full" | "past" | "latest-observed" | "future-7-days" | "future-30-days" | "future-90-days" | "findings" | "options";
            /** @enum {string} */
            state: "QUEUED" | "RUNNING" | "COMPLETED" | "FAILED";
            /** Format: uri-reference */
            eventsUrl: string;
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            updatedAt: string;
        };
        /** @enum {string} */
        AIInsightSection: "past" | "latest-observed" | "future-7-days" | "future-30-days" | "future-90-days" | "findings" | "options";
        AIInsightRefreshState: {
            /** @enum {string} */
            state: "IDLE" | "QUEUED" | "RUNNING" | "FAILED" | "LIMITED";
            jobId?: string;
            /** Format: uri-reference */
            eventsUrl?: string;
            /** Format: date-time */
            nextRefreshAt?: string;
        };
        LoginRequest: {
            /** @example merchant-0001 */
            username: string;
            password: string;
        };
        AuthSession: {
            user: components["schemas"]["MerchantUserSummary"];
            merchant: components["schemas"]["MerchantSummary"];
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            idleExpiresAt: string;
            /** Format: date-time */
            absoluteExpiresAt: string;
            /** @description Session-bound CSRF token. It is not an authentication token and must not be logged. */
            csrfToken: string;
        };
        MerchantUserSummary: {
            userId: string;
            /** @example merchant-0001 */
            username: string;
        };
        MerchantSummary: {
            /** @description Opaque API identifier, never accepted as authorization input. */
            merchantId: string;
            displayName: string;
            profileIsSynthetic: boolean;
        };
        /** @enum {string} */
        PeriodType: "DAY" | "WEEK" | "JALALI_MONTH" | "PERSIAN_SEASON";
        /** @example jm-1405-05 */
        PeriodId: string;
        ReportingPeriod: {
            periodId: components["schemas"]["PeriodId"];
            periodType: components["schemas"]["PeriodType"];
            /**
             * Format: date-time
             * @description Inclusive UTC boundary.
             * @example 2026-07-23T20:30:00Z
             */
            startAt: string;
            /**
             * Format: date-time
             * @description Exclusive UTC boundary.
             * @example 2026-08-22T20:30:00Z
             */
            endAt: string;
            /**
             * Format: date-time
             * @description Inclusive Asia/Tehran civil boundary with explicit offset.
             * @example 2026-07-24T00:00:00+03:30
             */
            localStartAt: string;
            /**
             * Format: date-time
             * @description Exclusive Asia/Tehran civil boundary with explicit offset.
             * @example 2026-08-23T00:00:00+03:30
             */
            localEndAt: string;
            /** @constant */
            timezone: "Asia/Tehran";
            /** @example مرداد ۱۴۰۵ */
            jalaliLabelFa: string;
            isComplete: boolean;
            isDefault: boolean;
        };
        PeriodList: {
            defaultPeriodId: components["schemas"]["PeriodId"];
            /** @description Dataset-bounded complete periods, grouped by type and newest-first within each group. */
            periods: components["schemas"]["ReportingPeriod"][];
        };
        CreateAnalyticsRunRequest: {
            periodId: components["schemas"]["PeriodId"];
            terminalId?: string;
        };
        Terminal: {
            terminalId: string;
            displayName: string;
            /** Format: int64 */
            sessionCount: number;
            isDefault: boolean;
        };
        TerminalList: {
            terminals: components["schemas"]["Terminal"][];
        };
        AnalyticsScope: {
            terminalId: string | null;
        };
        /** @example run_01K2M7YYYYYYYYYYYYYYYYYYYY */
        RunId: string;
        /** @enum {string} */
        SectionId: "overview" | "payment_performance" | "fees" | "peer_comparison" | "transactions";
        /** @enum {string} */
        AnalyticsRunState: "IN_PROGRESS" | "COMPLETE" | "COMPLETE_WITH_FAILURES";
        /** @enum {string} */
        SectionState: "QUEUED" | "CALCULATING" | "READY" | "FAILED" | "SUPPRESSED";
        AnalyticsRun: {
            runId: components["schemas"]["RunId"];
            state: components["schemas"]["AnalyticsRunState"];
            period: components["schemas"]["ReportingPeriod"];
            /** @description Opaque identifier for the immutable completed-import snapshot. */
            datasetSnapshotId: string;
            /** @constant */
            metricDefinitionVersion: "0.5.0";
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            updatedAt: string;
            /** Format: uri-reference */
            eventsUrl: string;
            scope: components["schemas"]["AnalyticsScope"];
            sections: {
                overview: components["schemas"]["OverviewSection"];
                paymentPerformance: components["schemas"]["PaymentPerformanceSection"];
                fees: components["schemas"]["FeesSection"];
                peerComparison: components["schemas"]["PeerComparisonSection"];
                transactions: components["schemas"]["TransactionsSection"];
            };
        };
        QueuedSection: {
            /** @constant */
            state: "QUEUED";
            /** Format: date-time */
            queuedAt?: string | null;
        };
        CalculatingSection: {
            /** @constant */
            state: "CALCULATING";
            /** Format: date-time */
            startedAt: string;
        };
        FailedSection: {
            /** @constant */
            state: "FAILED";
            /** Format: date-time */
            failedAt: string;
            /** @enum {string} */
            errorCode: "CALCULATION_FAILED" | "CALCULATION_TIMEOUT" | "SOURCE_UNAVAILABLE" | "UNSUPPORTED_METRIC_VERSION";
            canRetry: boolean;
            /** Format: uri-reference */
            retryAttemptsUrl?: string | null;
        };
        ReadySectionMetadata: {
            /** Format: date-time */
            calculatedAt: string;
            datasetSnapshotId: string;
            /** @constant */
            metricDefinitionVersion: "0.5.0";
        };
        IntegerMetric: {
            metricId: string;
            value: number;
            /** @enum {string} */
            unit: "SESSIONS" | "RIAL";
        };
        DecimalMetric: {
            metricId: string;
            /** @description Null only when the denominator is zero or source is unavailable. */
            value: string | null;
            /** @enum {string} */
            unit: "PERCENT" | "RATIO";
            numerator: number;
            denominator: number;
        };
        TimingDistribution: {
            /** @enum {string} */
            metricId: "init_time_ms" | "verify_time_ms";
            p50Ms: number | null;
            p95Ms: number | null;
            sampleSize: number;
            eligibleSampleSize: number;
            coveragePercent: string | null;
        };
        PreviousPeriodComparison: {
            /** @enum {string} */
            state: "AVAILABLE" | "UNAVAILABLE";
            baselinePeriod: components["schemas"]["ReportingPeriod"];
            absoluteChange?: string | null;
            relativeChangePercent?: string | null;
            /** @enum {string|null} */
            unavailableReason?: "EMPTY_BASELINE" | "ZERO_BASELINE" | "SOURCE_UNAVAILABLE" | null;
            isActionableInsightEligible?: boolean;
        };
        OverviewData: {
            /**
             * @example {
             *       "metricId": "bank_paid_sessions",
             *       "value": 420,
             *       "unit": "SESSIONS"
             *     }
             */
            bankPaidSessions: components["schemas"]["IntegerMetric"];
            /**
             * @example {
             *       "metricId": "bank_paid_amount_rial",
             *       "value": 680000000,
             *       "unit": "RIAL"
             *     }
             */
            bankPaidAmountRial: components["schemas"]["IntegerMetric"];
            paymentSuccessRate: components["schemas"]["DecimalMetric"];
            verificationCompletionRate: components["schemas"]["DecimalMetric"];
            comparisons: {
                [key: string]: components["schemas"]["PreviousPeriodComparison"];
            };
            paymentHistory: components["schemas"]["PaymentHistoryPoint"][];
        };
        PaymentHistoryPoint: {
            /** Format: date */
            localDate: string;
            /** @description Tehran-local hour bucket, present only for DAY periods. */
            localHour?: number;
            /** Format: int64 */
            totalSessions: number;
            /** Format: int64 */
            bankPaidSessions: number;
            /** Format: int64 */
            bankPaidAmountRial: number;
        };
        PaymentPerformanceData: {
            bankPaidSessions: components["schemas"]["IntegerMetric"];
            verifiedSessions: components["schemas"]["IntegerMetric"];
            unverifiedPaidSessions: components["schemas"]["IntegerMetric"];
            failedSessions: components["schemas"]["IntegerMetric"];
            reversedSessions: components["schemas"]["IntegerMetric"];
            noAttemptSessions: components["schemas"]["IntegerMetric"];
            reachedBankSessions: components["schemas"]["IntegerMetric"];
            retriedSessions: components["schemas"]["IntegerMetric"];
            retryRecoveryRate: components["schemas"]["DecimalMetric"];
            initTiming: components["schemas"]["TimingDistribution"];
            verifyTiming: components["schemas"]["TimingDistribution"];
        };
        TransactionStatusDistribution: {
            status: components["schemas"]["SessionStatus"];
            /** Format: int64 */
            count: number;
            sharePercent: string | null;
        };
        TransactionStatusTrendPoint: {
            /** Format: date */
            localDate: string;
            localHour?: number;
            /** Format: int64 */
            paidSessions: number;
            /** Format: int64 */
            verifiedSessions: number;
            /** Format: int64 */
            failedSessions: number;
            /** Format: int64 */
            reversedSessions: number;
            /** Format: int64 */
            totalSessions: number;
        };
        TransactionsData: {
            totalSessions: components["schemas"]["IntegerMetric"];
            bankSuccessRate: components["schemas"]["DecimalMetric"];
            verificationCompletionRate: components["schemas"]["DecimalMetric"];
            failureRate: components["schemas"]["DecimalMetric"];
            /** @description Canonical order is Paid, Verified, Failed, Reversed. */
            statusDistribution: components["schemas"]["TransactionStatusDistribution"][];
            statusTrend: components["schemas"]["TransactionStatusTrendPoint"][];
        };
        FeesData: {
            paidFeeAmountRial: components["schemas"]["IntegerMetric"];
            bankPaidAmountRial: components["schemas"]["IntegerMetric"];
            paidFeeRate: components["schemas"]["DecimalMetric"];
            comparison: components["schemas"]["PreviousPeriodComparison"];
        };
        PeerMetric: {
            /** @enum {string} */
            metricId: "payment_success_rate" | "verification_completion_rate" | "retry_recovery_rate" | "init_time_ms_p50" | "init_time_ms_p95" | "verify_time_ms_p50" | "verify_time_ms_p95" | "paid_fee_rate";
            cohortMedian: string;
            /** @description Higher always means better; lower-is-better metrics are direction-adjusted. */
            merchantPerformancePercentile: string;
            /** @enum {string} */
            direction: "HIGHER_IS_BETTER" | "LOWER_IS_BETTER";
        };
        PeerComparisonData: {
            eligiblePeerCount: number;
            combinedPeerSessionCount: number;
            metrics: components["schemas"]["PeerMetric"][];
        };
        OverviewReadySection: {
            /** @constant */
            sectionId: "overview";
            /** @constant */
            state: "READY";
            metadata: components["schemas"]["ReadySectionMetadata"];
            data: components["schemas"]["OverviewData"];
        };
        PaymentPerformanceReadySection: {
            /** @constant */
            sectionId: "payment_performance";
            /** @constant */
            state: "READY";
            metadata: components["schemas"]["ReadySectionMetadata"];
            data: components["schemas"]["PaymentPerformanceData"];
        };
        TransactionsReadySection: {
            /** @constant */
            sectionId: "transactions";
            /** @constant */
            state: "READY";
            metadata: components["schemas"]["ReadySectionMetadata"];
            data: components["schemas"]["TransactionsData"];
        };
        FeesReadySection: {
            /** @constant */
            sectionId: "fees";
            /** @constant */
            state: "READY";
            metadata: components["schemas"]["ReadySectionMetadata"];
            data: components["schemas"]["FeesData"];
        };
        PeerComparisonReadySection: {
            /** @constant */
            sectionId: "peer_comparison";
            /** @constant */
            state: "READY";
            metadata: components["schemas"]["ReadySectionMetadata"];
            data: components["schemas"]["PeerComparisonData"];
        };
        PeerComparisonSuppressedSection: {
            /** @constant */
            sectionId: "peer_comparison";
            /** @constant */
            state: "SUPPRESSED";
            metadata: components["schemas"]["ReadySectionMetadata"];
            /**
             * @description `TERMINAL_SCOPE_UNSUPPORTED` is returned for terminal-scoped runs because
             *     the approved peer cohort is merchant-grain and must not be presented as
             *     if it benchmarked one terminal.
             * @enum {string}
             */
            reason: "INSUFFICIENT_COHORT" | "TERMINAL_SCOPE_UNSUPPORTED";
            eligiblePeerCount: number;
            combinedPeerSessionCount: number;
            /** @constant */
            requiredPeerCount: 10;
            /** @constant */
            requiredPeerSessionCount: 1000;
        };
        OverviewSection: components["schemas"]["QueuedSection"] | components["schemas"]["CalculatingSection"] | components["schemas"]["FailedSection"] | components["schemas"]["OverviewReadySection"];
        PaymentPerformanceSection: components["schemas"]["QueuedSection"] | components["schemas"]["CalculatingSection"] | components["schemas"]["FailedSection"] | components["schemas"]["PaymentPerformanceReadySection"];
        TransactionsSection: components["schemas"]["QueuedSection"] | components["schemas"]["CalculatingSection"] | components["schemas"]["FailedSection"] | components["schemas"]["TransactionsReadySection"];
        FeesSection: components["schemas"]["QueuedSection"] | components["schemas"]["CalculatingSection"] | components["schemas"]["FailedSection"] | components["schemas"]["FeesReadySection"];
        PeerComparisonSection: components["schemas"]["QueuedSection"] | components["schemas"]["CalculatingSection"] | components["schemas"]["FailedSection"] | components["schemas"]["PeerComparisonReadySection"] | components["schemas"]["PeerComparisonSuppressedSection"];
        /** @enum {string} */
        DetailView: "ALL" | "UNVERIFIED_PAID" | "FAILED" | "RETRIED";
        /** @enum {string} */
        FailureStage: "NO_ATTEMPT" | "REACHED_BANK" | "OTHER_OBSERVED";
        /** @enum {string} */
        SessionStatus: "Paid" | "Verified" | "Failed" | "Reversed";
        /** @enum {string} */
        AttemptStatus: "InBank" | "Paid" | "Verified" | "Failed" | "Reversed";
        AttemptSummary: {
            sequence: number;
            status: components["schemas"]["AttemptStatus"];
            /** Format: date-time */
            createdAt?: string | null;
            initTimeMs?: number | null;
            verifyTimeMs?: number | null;
        };
        SessionDetail: {
            /** @description Opaque merchant-local API id, not the internal database key. */
            sessionId: string;
            /** @description Existing opaque source terminal reference shown as `شناسه پایانه`; tenant-scoped display/trace data only. */
            terminalId: string;
            sessionStatus: components["schemas"]["SessionStatus"];
            amountRial: number;
            feeAmountRial: number;
            /** Format: date-time */
            createdAt: string;
            /** Format: date-time */
            expiresAt?: string | null;
            /** Format: date-time */
            verifiedAt?: string | null;
            /** Format: date-time */
            settledAt?: string | null;
            attemptCount: number;
            failureStage?: components["schemas"]["FailureStage"] | null;
            /** @description Bounded ordered attempt summary; payer tokens and response codes are absent. */
            attempts: components["schemas"]["AttemptSummary"][];
        };
        PageInfo: {
            limit: number;
            hasNextPage: boolean;
            nextCursor: string | null;
        };
        SessionDetailPage: {
            period: components["schemas"]["ReportingPeriod"];
            view: components["schemas"]["DetailView"];
            appliedFilters: {
                terminalId?: string | null;
                failureStage?: components["schemas"]["FailureStage"] | null;
                status?: components["schemas"]["SessionStatus"] | null;
                /** Format: int64 */
                minAmountRial?: number | null;
                /** Format: int64 */
                maxAmountRial?: number | null;
            };
            items: components["schemas"]["SessionDetail"][];
            pageInfo: components["schemas"]["PageInfo"];
        };
        EventId: string;
        SseEventBase: {
            eventId: components["schemas"]["EventId"];
            runId: components["schemas"]["RunId"];
            /** Format: date-time */
            occurredAt: string;
        };
        RunSnapshotEvent: components["schemas"]["SseEventBase"] & {
            /** @enum {string} */
            recovery: "INITIAL" | "REPLAYED" | "RESET_TO_SNAPSHOT";
            run: components["schemas"]["AnalyticsRun"];
        };
        SectionStartedEvent: components["schemas"]["SseEventBase"] & {
            sectionId: components["schemas"]["SectionId"];
            /** Format: date-time */
            startedAt: string;
        };
        SectionReadyEvent: components["schemas"]["SseEventBase"] & {
            sectionId: components["schemas"]["SectionId"];
            section: components["schemas"]["OverviewReadySection"] | components["schemas"]["PaymentPerformanceReadySection"] | components["schemas"]["TransactionsReadySection"] | components["schemas"]["FeesReadySection"] | components["schemas"]["PeerComparisonReadySection"];
        };
        SectionFailedEvent: components["schemas"]["SseEventBase"] & {
            sectionId: components["schemas"]["SectionId"];
            section: components["schemas"]["FailedSection"];
        };
        SectionSuppressedEvent: components["schemas"]["SseEventBase"] & {
            /** @constant */
            sectionId: "peer_comparison";
            section: components["schemas"]["PeerComparisonSuppressedSection"];
        };
        RunCompletedEvent: components["schemas"]["SseEventBase"] & {
            run: components["schemas"]["AnalyticsRun"];
        };
        HeartbeatEvent: components["schemas"]["SseEventBase"] & {
            /** Format: date-time */
            serverTime: string;
        };
        /** @description JSON payload carried in the SSE `data` field; event name selects the schema. */
        AnalyticsSseEvent: components["schemas"]["RunSnapshotEvent"] | components["schemas"]["SectionStartedEvent"] | components["schemas"]["SectionReadyEvent"] | components["schemas"]["SectionFailedEvent"] | components["schemas"]["SectionSuppressedEvent"] | components["schemas"]["RunCompletedEvent"] | components["schemas"]["HeartbeatEvent"];
        FieldError: {
            /** @description Allowlisted public field name; never a database path. */
            field: string;
            reason: string;
        };
        /** @description RFC 9457 Problem Details with stable application extensions. */
        Problem: {
            /**
             * Format: uri
             * @description Stable problem type URI under `https://zarinpal.amiirkhl.ir/docs/errors/{error-slug}`.
             */
            type: string;
            title: string;
            /** @description Must equal the actual HTTP response status. */
            status: number;
            /** @description Safe occurrence-specific guidance; clients must not parse it. */
            detail: string;
            /** Format: uri-reference */
            instance: string;
            /** @description Stable application error code used by clients. */
            code: string;
            requestId: string;
            errors?: components["schemas"]["FieldError"][];
            /**
             * Format: uri-reference
             * @description Optional safe recovery link for run-related problems.
             */
            snapshotUrl?: string;
            /**
             * Format: date-time
             * @description Present for REFRESH_LIMITED responses.
             */
            nextRefreshAt?: string;
        };
    };
    responses: {
        /** @description Request syntax, cursor, event id, or parameter combination is invalid. */
        BadRequest: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description The current session is missing, malformed, expired, or revoked. */
        Unauthenticated: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                /**
                 * @example {
                 *       "type": "https://zarinpal.amiirkhl.ir/docs/errors/unauthenticated",
                 *       "title": "Authentication required",
                 *       "status": 401,
                 *       "detail": "Sign in to continue.",
                 *       "instance": "/api/v1/analytics/runs",
                 *       "code": "UNAUTHENTICATED",
                 *       "requestId": "req_01K2M8A0000000000000000000"
                 *     }
                 */
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description The authenticated request is not permitted or failed CSRF/origin checks. */
        Forbidden: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Resource is absent or is outside the authenticated merchant boundary. */
        ResourceNotFound: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                /**
                 * @example {
                 *       "type": "https://zarinpal.amiirkhl.ir/docs/errors/resource-not-found",
                 *       "title": "Resource not found",
                 *       "status": 404,
                 *       "detail": "The requested resource is unavailable.",
                 *       "instance": "/api/v1/analytics/runs/run_unknown",
                 *       "code": "RESOURCE_NOT_FOUND",
                 *       "requestId": "req_01K2M8A0000000000000000000"
                 *     }
                 */
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Current resource state does not permit the requested operation. */
        Conflict: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Request exceeds the 16 KiB JSON body limit. */
        RequestTooLarge: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Export exceeds 100,000 rows or 50 MiB estimated uncompressed output. */
        ExportTooLarge: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                /**
                 * @example {
                 *       "type": "https://zarinpal.amiirkhl.ir/docs/errors/export-too-large",
                 *       "title": "Export is too large",
                 *       "status": 413,
                 *       "detail": "Narrow the approved filters and try again.",
                 *       "instance": "/api/v1/analytics/session-details.csv",
                 *       "code": "EXPORT_TOO_LARGE",
                 *       "requestId": "req_01K2M8A0000000000000000000"
                 *     }
                 */
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Request media type is not supported. */
        UnsupportedMediaType: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Request is well-formed but violates the interface contract. */
        ValidationFailed: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                /**
                 * @example {
                 *       "type": "https://zarinpal.amiirkhl.ir/docs/errors/validation-error",
                 *       "title": "Request validation failed",
                 *       "status": 422,
                 *       "detail": "One or more request values are invalid.",
                 *       "instance": "/api/v1/analytics/runs",
                 *       "code": "VALIDATION_ERROR",
                 *       "requestId": "req_01K2M8A0000000000000000000",
                 *       "errors": [
                 *         {
                 *           "field": "periodId",
                 *           "reason": "UNKNOWN_PERIOD"
                 *         }
                 *       ]
                 *     }
                 */
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Authenticated-user or merchant rate limit reached before work began. */
        RateLimited: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "Retry-After": components["headers"]["RetryAfter"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description SSE concurrency limit reached for the user or merchant. */
        ConnectionLimited: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "Retry-After": components["headers"]["RetryAfter"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Unexpected server failure; implementation details are not exposed. */
        InternalError: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Required authoritative dependency is unavailable; protected requests fail closed. */
        DependencyUnavailable: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "Retry-After": components["headers"]["RetryAfter"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Analytics dependency is temporarily unavailable. */
        AnalyticsUnavailable: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "Retry-After": components["headers"]["RetryAfter"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
        /** @description Export did not complete within the 60-second deadline before streaming began. */
        ExportTimeout: {
            headers: {
                "Cache-Control": components["headers"]["PrivateNoStore"];
                "Retry-After": components["headers"]["RetryAfter"];
                "X-Request-ID": components["headers"]["RequestId"];
                [name: string]: unknown;
            };
            content: {
                "application/problem+json": components["schemas"]["Problem"];
            };
        };
    };
    parameters: {
        /** @description Opaque analytics run identifier; possession does not authorize access. */
        RunIdPath: components["schemas"]["RunId"];
        SectionIdPath: components["schemas"]["SectionId"];
        /**
         * @description Client-generated intent key reused unchanged for retries of one intent.
         * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
         */
        IdempotencyKeyHeader: string;
        /** @description CSRF token for the current authenticated session; never log this value. */
        CsrfTokenHeader: string;
        /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
        OriginHeader: string;
        /** @description Optional safe correlation id. The server may replace invalid values. */
        RequestIdHeader: string;
        /** @description Stable id returned by `listAnalyticsPeriods`. */
        PeriodIdQuery: components["schemas"]["PeriodId"];
        DetailViewQuery: components["schemas"]["DetailView"];
        /** @description Valid only when `view=FAILED`. */
        FailureStageQuery: components["schemas"]["FailureStage"];
        /** @description Approved opaque source terminal reference resolved only inside the authenticated merchant; never an authorization input. */
        TerminalIdQuery: string;
        SessionStatusQuery: components["schemas"]["SessionStatus"];
        MinAmountRialQuery: number;
        MaxAmountRialQuery: number;
        /** @description Opaque integrity-protected cursor bound to tenant, view, filters, and ordering. */
        CursorQuery: string;
        /** @description Page size; defaults to 25 and cannot exceed 100. */
        LimitQuery: number;
    };
    requestBodies: never;
    headers: {
        /** @description Server correlation id for this request. */
        RequestId: string;
        /** @description Prevents storage of authenticated merchant data. */
        PrivateNoStore: "private, no-store";
        /** @description Seconds until retry is permitted. */
        RetryAfter: number;
    };
    pathItems: never;
}
export type $defs = Record<string, never>;
export interface operations {
    createAuthSession: {
        parameters: {
            query?: never;
            header: {
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["LoginRequest"];
            };
        };
        responses: {
            /** @description Authenticated session created. */
            201: {
                headers: {
                    /**
                     * @description Secure opaque session cookie; value is intentionally omitted from examples.
                     * @example __Host-zpa_session=<opaque>; Path=/; Secure; HttpOnly; SameSite=Lax
                     */
                    "Set-Cookie"?: string;
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AuthSession"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            413: components["responses"]["RequestTooLarge"];
            415: components["responses"]["UnsupportedMediaType"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["DependencyUnavailable"];
        };
    };
    getAuthSession: {
        parameters: {
            query?: never;
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current authenticated merchant-user session. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AuthSession"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["DependencyUnavailable"];
        };
    };
    deleteAuthSession: {
        parameters: {
            query?: never;
            header: {
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current authenticated session revoked. */
            204: {
                headers: {
                    /**
                     * @description Expired session cookie.
                     * @example __Host-zpa_session=; Path=/; Max-Age=0; Secure; HttpOnly; SameSite=Lax
                     */
                    "Set-Cookie"?: string;
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content?: never;
            };
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["DependencyUnavailable"];
        };
    };
    listAnalyticsPeriods: {
        parameters: {
            query?: {
                /** @description Optional allowlisted period type. */
                periodType?: components["schemas"]["PeriodType"];
            };
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Approved period choices and default selection. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["PeriodList"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["DependencyUnavailable"];
        };
    };
    listMerchantTerminals: {
        parameters: {
            query?: never;
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Merchant-owned terminal choices ordered by session volume. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["TerminalList"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    createAnalyticsRun: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateAnalyticsRunRequest"];
            };
        };
        responses: {
            /** @description Existing current run returned with no new work required. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    /** @description Whether this response replayed a prior intent result. */
                    "Idempotency-Replayed"?: boolean;
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AnalyticsRun"];
                };
            };
            /** @description Current run accepted and one or more missing sections are queued/calculating. */
            202: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    /** @description Whether this response replayed a prior intent result. */
                    "Idempotency-Replayed"?: boolean;
                    /** @description Relative URL of the run snapshot. */
                    Location?: string;
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AnalyticsRun"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            413: components["responses"]["RequestTooLarge"];
            415: components["responses"]["UnsupportedMediaType"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getAnalyticsRun: {
        parameters: {
            query?: never;
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current state of every run section. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AnalyticsRun"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    streamAnalyticsRunEvents: {
        parameters: {
            query?: never;
            header?: {
                /** @description Opaque last processed event id; must not contain NUL, LF, or CR. */
                "Last-Event-ID"?: string;
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description UTF-8 event stream. A named heartbeat is emitted every 15 seconds. */
            200: {
                headers: {
                    /** @description Prevents transformation or storage of the live event stream. */
                    "Cache-Control"?: "no-cache, no-transform";
                    /** @description Deployment hint disabling Nginx response buffering. */
                    "X-Accel-Buffering"?: "no";
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "text/event-stream": string;
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            429: components["responses"]["ConnectionLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    createAnalyticsSectionRetryAttempt: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                /** @description Opaque analytics run identifier; possession does not authorize access. */
                runId: components["parameters"]["RunIdPath"];
                sectionId: components["parameters"]["SectionIdPath"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Retry accepted or equivalent current retry returned. */
            202: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    /** @description Relative run snapshot URL. */
                    Location?: string;
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AnalyticsRun"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            404: components["responses"]["ResourceNotFound"];
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    listAnalyticsSessionDetails: {
        parameters: {
            query: {
                /** @description Stable id returned by `listAnalyticsPeriods`. */
                periodId: components["parameters"]["PeriodIdQuery"];
                view: components["parameters"]["DetailViewQuery"];
                /** @description Valid only when `view=FAILED`. */
                failureStage?: components["parameters"]["FailureStageQuery"];
                /** @description Approved opaque source terminal reference resolved only inside the authenticated merchant; never an authorization input. */
                terminalId?: components["parameters"]["TerminalIdQuery"];
                status?: components["parameters"]["SessionStatusQuery"];
                minAmountRial?: components["parameters"]["MinAmountRialQuery"];
                maxAmountRial?: components["parameters"]["MaxAmountRialQuery"];
                /** @description Opaque integrity-protected cursor bound to tenant, view, filters, and ordering. */
                cursor?: components["parameters"]["CursorQuery"];
                /** @description Page size; defaults to 25 and cannot exceed 100. */
                limit?: components["parameters"]["LimitQuery"];
            };
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Authorized detail page. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["SessionDetailPage"];
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getAnalyticsSession: {
        parameters: {
            query?: never;
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                sessionId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Authorized merchant-owned session. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["SessionDetail"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    exportAnalyticsSessionDetailsCsv: {
        parameters: {
            query: {
                /** @description Stable id returned by `listAnalyticsPeriods`. */
                periodId: components["parameters"]["PeriodIdQuery"];
                view: components["parameters"]["DetailViewQuery"];
                /** @description Valid only when `view=FAILED`. */
                failureStage?: components["parameters"]["FailureStageQuery"];
                /** @description Approved opaque source terminal reference resolved only inside the authenticated merchant; never an authorization input. */
                terminalId?: components["parameters"]["TerminalIdQuery"];
                status?: components["parameters"]["SessionStatusQuery"];
                minAmountRial?: components["parameters"]["MinAmountRialQuery"];
                maxAmountRial?: components["parameters"]["MaxAmountRialQuery"];
            };
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Complete authorized CSV export. */
            200: {
                headers: {
                    "Cache-Control": components["headers"]["PrivateNoStore"];
                    /**
                     * @description Attachment with ASCII fallback first and UTF-8 `filename*` second.
                     *     Filename contains only server-generated view, period id, and time.
                     * @example attachment; filename="unverified_paid-jm-1405-05-20260820T093000Z.csv"; filename*=UTF-8''unverified_paid-jm-1405-05-20260820T093000Z.csv
                     */
                    "Content-Disposition"?: string;
                    /** @description Prevents content sniffing. */
                    "X-Content-Type-Options"?: "nosniff";
                    "X-Request-ID": components["headers"]["RequestId"];
                    [name: string]: unknown;
                };
                content: {
                    /**
                     * @example "شناسه نشست پرداخت","شناسه پایانه","وضعیت پرداخت","مبلغ ریال","کارمزد ریال","زمان ایجاد","زمان انقضا","تعداد تلاش","وضعیت آخرین تلاش","زمان آخرین تلاش","زمان تأیید","زمان تسویه","مرحله مشاهده شده شکست"
                     *     ses_01K2M8,term_0042,پرداخت شده و تأیید نشده,1500000,2000,2026-06-01T08:00:00Z,2026-06-01T08:15:00Z,1,پرداخت شده و تأیید نشده,2026-06-01T08:02:00Z,,,
                     */
                    "text/csv; charset=utf-8": string;
                };
            };
            400: components["responses"]["BadRequest"];
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            413: components["responses"]["ExportTooLarge"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            500: components["responses"]["InternalError"];
            503: components["responses"]["AnalyticsUnavailable"];
            504: components["responses"]["ExportTimeout"];
        };
    };
    createGrowthReport: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateGrowthReportRequest"];
            };
        };
        responses: {
            /** @description Matching durable report reused. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthReport"];
                };
            };
            /** @description Report accepted for generation. */
            202: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthReport"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getLatestGrowthReport: {
        parameters: {
            query?: {
                terminalId?: string;
            };
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Latest successful report for the authorized scope. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthReport"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getGrowthReport: {
        parameters: {
            query?: never;
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                reportId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Authorized report snapshot. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthReport"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    streamGrowthReportEvents: {
        parameters: {
            query?: never;
            header?: {
                "Last-Event-ID"?: string;
            };
            path: {
                reportId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Stable-id report snapshots and heartbeats. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "text/event-stream": string;
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
        };
    };
    getLatestAIInsight: {
        parameters: {
            query?: {
                terminalId?: string;
                /** @description Server-offered reporting period used to match the visible analytics run. */
                periodId?: string;
            };
            header?: {
                /** @description Optional safe correlation id. The server may replace invalid values. */
                "X-Request-ID"?: components["parameters"]["RequestIdHeader"];
            };
            path: {
                module: components["schemas"]["AIInsightModule"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Latest ready or deterministic-partial snapshot. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsight"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            422: components["responses"]["ValidationFailed"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    refreshAIInsight: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
            };
            path: {
                module: components["schemas"]["AIInsightModule"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AIInsightRefreshRequest"];
            };
        };
        responses: {
            /** @description Idempotent job reused. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsightJob"];
                };
            };
            /** @description Refresh accepted. */
            202: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsightJob"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            404: components["responses"]["ResourceNotFound"];
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    refreshAIInsightSection: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
                /** @description Strict same-origin evidence validated with Fetch Metadata where available. */
                Origin: components["parameters"]["OriginHeader"];
            };
            path: {
                module: components["schemas"]["AIInsightModule"];
                sectionId: components["schemas"]["AIInsightSection"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AIInsightRefreshRequest"];
            };
        };
        responses: {
            /** @description Idempotent job reused. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsightJob"];
                };
            };
            /** @description Section refresh accepted. */
            202: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsightJob"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            403: components["responses"]["Forbidden"];
            404: components["responses"]["ResourceNotFound"];
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getAIInsightRefresh: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                jobId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Tenant-scoped refresh job. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AIInsightJob"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
        };
    };
    streamAIInsightRefreshEvents: {
        parameters: {
            query?: never;
            header?: {
                "Last-Event-ID"?: number;
            };
            path: {
                jobId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Durable job events and heartbeats. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "text/event-stream": string;
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
        };
    };
    getGrowthCoachDashboard: {
        parameters: {
            query?: {
                terminalId?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Persisted coach state and deterministic progress. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthCoachDashboard"];
                };
            };
            401: components["responses"]["Unauthenticated"];
            404: components["responses"]["ResourceNotFound"];
            503: components["responses"]["AnalyticsUnavailable"];
        };
    };
    getGrowthCoachProfile: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                terminalId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current profile version. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthCoachProfile"];
                };
            };
            404: components["responses"]["ResourceNotFound"];
        };
    };
    putGrowthCoachProfile: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                terminalId: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["GrowthCoachProfileInput"];
            };
        };
        responses: {
            /** @description New profile version and generation jobs. */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthCoachProfileResult"];
                };
            };
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
        };
    };
    refreshGrowthCoach: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                terminalId: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["GrowthCoachRefreshInput"];
            };
        };
        responses: {
            /** @description Cadence-scoped coach refresh queued. */
            202: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthCoachJob"];
                };
            };
            404: components["responses"]["ResourceNotFound"];
            409: components["responses"]["Conflict"];
            422: components["responses"]["ValidationFailed"];
            429: components["responses"]["RateLimited"];
        };
    };
    listGrowthCoachPlans: {
        parameters: {
            query?: {
                terminalId?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Coach plans. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        plans: components["schemas"]["GrowthCoachPlan"][];
                    };
                };
            };
        };
    };
    listGoldenSteps: {
        parameters: {
            query?: {
                terminalId?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Shared Golden Steps workspace. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        actions: components["schemas"]["GoldenStep"][];
                    };
                };
            };
        };
    };
    listMonthlyGoals: {
        parameters: {
            query?: {
                terminalId?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Automatically tracked monthly goals with manual action subtasks. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        goals: components["schemas"]["MonthlyGoal"][];
                    };
                };
            };
        };
    };
    transitionGoalSubtask: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                goalId: string;
                subtaskId: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    transition: "COMPLETE" | "REOPEN";
                };
            };
        };
        responses: {
            /** @description Updated user-completed subtask. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GoalSubtask"];
                };
            };
            409: components["responses"]["Conflict"];
        };
    };
    decideGoalDeadlineProposal: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                proposalId: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    decision: "ACCEPT" | "REJECT";
                };
            };
        };
        responses: {
            /** @description Deadline proposal decision. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GoalDeadlineProposal"];
                };
            };
            409: components["responses"]["Conflict"];
        };
    };
    decideGrowthCoachRecommendation: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                id: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CoachDecision"];
            };
        };
        responses: {
            /** @description Decision recorded and accepted action created when applicable. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            409: components["responses"]["Conflict"];
        };
    };
    transitionGoldenStep: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                id: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    transition: "START" | "COMPLETE" | "ABANDON";
                };
            };
        };
        responses: {
            /** @description Updated action. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GoldenStep"];
                };
            };
            409: components["responses"]["Conflict"];
        };
    };
    decideGrowthCoachDifficulty: {
        parameters: {
            query?: never;
            header: {
                /**
                 * @description Client-generated intent key reused unchanged for retries of one intent.
                 * @example 95f6ec2d-26e8-4983-afd4-8a6d4434726b
                 */
                "Idempotency-Key": components["parameters"]["IdempotencyKeyHeader"];
                /** @description CSRF token for the current authenticated session; never log this value. */
                "X-CSRF-Token": components["parameters"]["CsrfTokenHeader"];
            };
            path: {
                id: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CoachDecision"];
            };
        };
        responses: {
            /** @description Difficulty decision recorded. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            409: components["responses"]["Conflict"];
        };
    };
    getGrowthCoachJob: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                jobId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Generation job. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["GrowthCoachJob"];
                };
            };
            404: components["responses"]["ResourceNotFound"];
        };
    };
    streamGrowthCoachJob: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                jobId: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Job snapshots. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "text/event-stream": string;
                };
            };
        };
    };
}