@finatic/client 0.9.0 → 0.9.2

package/dist/generated/wrappers/session.js

@@ -1,1232 +0,0 @@
-"use strict";
-/**
- * Generated wrapper functions for session operations (Phase 2A).
- *
- * This file is regenerated on each run - do not edit directly.
- * For custom logic, edit src/custom/wrappers/session.ts instead.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionWrapper = void 0;
-const request_id_1 = require("../utils/request-id");
-const retry_1 = require("../utils/retry");
-const logger_1 = require("../utils/logger");
-const error_handling_1 = require("../utils/error-handling");
-const cache_1 = require("../utils/cache");
-const interceptors_1 = require("../utils/interceptors");
-const plain_object_1 = require("../utils/plain-object");
-/**
- * Session wrapper functions.
- * Provides simplified method names and response unwrapping.
- */
-class SessionWrapper {
-    constructor(api, config, sdkConfig) {
-        this.api = api;
-        if (config !== undefined) {
-            this.config = config;
-        }
-        if (sdkConfig !== undefined) {
-            this.sdkConfig = sdkConfig;
-        }
-        this.logger = (0, logger_1.getLogger)(sdkConfig);
-    }
-    // Session context setters (called by session management)
-    setSessionContext(sessionId, companyId, csrfToken) {
-        this.sessionId = sessionId;
-        this.companyId = companyId;
-        this.csrfToken = csrfToken;
-    }
-    // Utility methods (Phase 2A)
-    _generateRequestId() {
-        return (0, request_id_1.generateRequestId)();
-    }
-    async _retryApiCall(fn) {
-        return (0, retry_1.retryApiCall)(fn);
-    }
-    _handleError(error, requestId) {
-        return (0, error_handling_1.handleError)(error, requestId);
-    }
-    /**
-     * Init Session
-     *
-     * Initialize a new session with company API key.
-  
-     * @param params {InitSessionParams} Input parameters object
-     * @returns {Promise<InitSessionResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: POST /api/v1/session/init
-     * @methodId init_session_api_v1_session_init_post
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Minimal example with required parameters only
-     * const result = await finatic.initSession({
-      xApiKey: 'example'
-     * });
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message);
-     * }
-     * ```
-     */
-    async initSession(params) {
-        // Phase 2C: Extract individual params from input params object
-        const xApiKey = params.xApiKey;
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/init', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Init Session', {
-            request_id: requestId,
-            method: 'POST',
-            path: '/api/v1/session/init',
-            params: params,
-            action: 'initSession',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.initSessionApiV1SessionInitPost({ xApiKey: xApiKey }, { headers: { 'x-request-id': requestId } });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/init', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Init Session completed', {
-                request_id: requestId,
-                action: 'initSession',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Init Session failed', error, {
-                request_id: requestId,
-                action: 'initSession',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Start Session
-     *
-     * Start a session with a one-time token.
-  
-     * @param params {StartSessionParams} Input parameters object
-     * @returns {Promise<StartSessionResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: POST /api/v1/session/start
-     * @methodId start_session_api_v1_session_start_post
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Minimal example with required parameters only
-     * const result = await finatic.startSession({
-      OneTimeToken: 'example',
-      body: {}
-     * });
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message);
-     * }
-     * ```
-     */
-    async startSession(params) {
-        // Phase 2C: Extract individual params from input params object
-        const OneTimeToken = params.OneTimeToken;
-        const body = params.body;
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/start', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Start Session', {
-            request_id: requestId,
-            method: 'POST',
-            path: '/api/v1/session/start',
-            params: params,
-            action: 'startSession',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.startSessionApiV1SessionStartPost({ oneTimeToken: OneTimeToken, sessionStartRequest: body }, { headers: { 'x-request-id': requestId } });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/start', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Start Session completed', {
-                request_id: requestId,
-                action: 'startSession',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Start Session failed', error, {
-                request_id: requestId,
-                action: 'startSession',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Get Portal Url
-     *
-     * Get a portal URL with token for a session.
-     *
-     * The session must be in ACTIVE or AUTHENTICATING state and the request must come from the same device
-     * that initiated the session. Device info is automatically validated from the request.
-  
-     * @param params {GetPortalUrlParams} Input parameters object (empty for methods with no parameters)
-     * @returns {Promise<GetPortalUrlResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: GET /api/v1/session/portal
-     * @methodId get_portal_url_api_v1_session_portal_get
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Example with no parameters
-     * const result = await finatic.getPortalUrl({});
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * }
-     * ```
-     */
-    async getPortalUrl(params) {
-        // Phase 2C: Extract individual params from input params object
-        // No parameters to extract
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('GET', '/api/v1/session/portal', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Get Portal Url', {
-            request_id: requestId,
-            method: 'GET',
-            path: '/api/v1/session/portal',
-            params: params,
-            action: 'getPortalUrl',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.getPortalUrlApiV1SessionPortalGet({ sessionId: this.sessionId }, { headers: { 'x-request-id': requestId } });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('GET', '/api/v1/session/portal', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Get Portal Url completed', {
-                request_id: requestId,
-                action: 'getPortalUrl',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Get Portal Url failed', error, {
-                request_id: requestId,
-                action: 'getPortalUrl',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Get Session User
-     *
-     * Get user information and fresh tokens for a completed session.
-     *
-     * This endpoint is designed for server SDKs to retrieve user information
-     * and authentication tokens after successful OTP verification.
-     *
-     *
-     * Security:
-     * - Requires valid session in ACTIVE state
-     * - Validates device fingerprint binding
-     * - Generates fresh tokens (not returning stored ones)
-     * - Only accessible to authenticated sessions with user_id
-  
-     * @param params {GetSessionUserParams} Input parameters object
-     * @returns {Promise<GetSessionUserResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: GET /api/v1/session/{session_id}/user
-     * @methodId get_session_user_api_v1_session__session_id__user_get
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Minimal example with required parameters only
-     * const result = await finatic.getSessionUser({
-      sessionId: 'id-123'
-     * });
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message);
-     * }
-     * ```
-     */
-    async getSessionUser(params) {
-        // Phase 2C: Extract individual params from input params object
-        const sessionId = params.sessionId;
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('GET', '/api/v1/session/{session_id}/user', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Get Session User', {
-            request_id: requestId,
-            method: 'GET',
-            path: '/api/v1/session/{session_id}/user',
-            params: params,
-            action: 'getSessionUser',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.getSessionUserApiV1SessionSessionIdUserGet({ sessionId: sessionId, companyId: this.companyId }, { headers: { 'x-request-id': requestId } });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('GET', '/api/v1/session/{session_id}/user', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Get Session User completed', {
-                request_id: requestId,
-                action: 'getSessionUser',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Get Session User failed', error, {
-                request_id: requestId,
-                action: 'getSessionUser',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Authenticate Session
-     *
-     *
-  
-     * @param params {AuthenticateSessionParams} Input parameters object
-     * @returns {Promise<AuthenticateSessionResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: POST /api/v1/session/authenticate
-     * @methodId authenticate_session_api_v1_session_authenticate_post
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Minimal example with required parameters only
-     * const result = await finatic.authenticateSession({
-      sessionId: 'id-123',
-      userId: 'id-123'
-     * });
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message);
-     * }
-     * ```
-     */
-    async authenticateSession(params) {
-        // Authentication check
-        if (!this.sessionId) {
-            throw new Error('Session not initialized. Call startSession() first.');
-        }
-        // Phase 2C: Extract individual params from input params object
-        const sessionId = params.sessionId;
-        const userId = params.userId;
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/authenticate', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Authenticate Session', {
-            request_id: requestId,
-            method: 'POST',
-            path: '/api/v1/session/authenticate',
-            params: params,
-            action: 'authenticateSession',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.authenticateSessionApiV1SessionAuthenticatePost({ directAuthRequest: { session_id: sessionId, user_id: userId } }, {
-                    headers: {
-                        'x-session-id': this.sessionId,
-                        'x-company-id': this.companyId,
-                        'x-csrf-token': this.csrfToken,
-                        'x-request-id': requestId,
-                    },
-                });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/authenticate', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Authenticate Session completed', {
-                request_id: requestId,
-                action: 'authenticateSession',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Authenticate Session failed', error, {
-                request_id: requestId,
-                action: 'authenticateSession',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Refresh Session
-     *
-     * Refresh an existing session by extending its expiration time.
-     *
-     * This endpoint allows users to extend their session before it expires.
-     * The session will be extended by the default duration (24 hours).
-  
-     * @param params {RefreshSessionParams} Input parameters object (empty for methods with no parameters)
-     * @returns {Promise<RefreshSessionResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: POST /api/v1/session/refresh
-     * @methodId refresh_session_api_v1_session_refresh_post
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Example with no parameters
-     * const result = await finatic.refreshSession({});
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * }
-     * ```
-     */
-    async refreshSession(params) {
-        // Authentication check
-        if (!this.sessionId) {
-            throw new Error('Session not initialized. Call startSession() first.');
-        }
-        // Phase 2C: Extract individual params from input params object
-        // No parameters to extract
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/refresh', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Refresh Session', {
-            request_id: requestId,
-            method: 'POST',
-            path: '/api/v1/session/refresh',
-            params: params,
-            action: 'refreshSession',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.refreshSessionApiV1SessionRefreshPost({ sessionId: this.sessionId, companyId: this.companyId }, { headers: { 'x-request-id': requestId } });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/refresh', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Refresh Session completed', {
-                request_id: requestId,
-                action: 'refreshSession',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Refresh Session failed', error, {
-                request_id: requestId,
-                action: 'refreshSession',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-    /**
-     * Test Webhook
-     *
-     * Send a test webhook for the specified event type to the company's configured endpoints.
-  
-     * @param params {TestWebhookParams} Input parameters object
-     * @returns {Promise<TestWebhookResponse>} Standard response with success/Error/Warning structure
-     *
-     * Generated from: POST /api/v1/session/webhook/test
-     * @methodId test_webhook_api_v1_session_webhook_test_post
-     * @category session
-     * @example
-     * ```typescript-client
-     * // Minimal example with required parameters only
-     * const result = await finatic.testWebhook({
-      eventType: 'example'
-     * });
-     *
-     * // Access the response data
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message);
-     * }
-     * ```
-     * @example
-     * ```typescript-client
-     * // Full example with optional parameters
-     * const result = await finatic.testWebhook({
-      eventType: 'example',
-      sampleData: 'example'
-     * });
-     *
-     * // Handle response with warnings
-     * if (result.success) {
-     *   console.log('Data:', result.success.data);
-     *   if (result.Warning && result.Warning.length > 0) {
-     *     console.warn('Warnings:', result.Warning);
-     *   }
-     * } else if (result.Error) {
-     *   console.error('Error:', result.Error.message, result.Error.code);
-     * }
-     * ```
-     */
-    async testWebhook(params) {
-        // Authentication check
-        if (!this.sessionId) {
-            throw new Error('Session not initialized. Call startSession() first.');
-        }
-        // Phase 2C: Extract individual params from input params object
-        const eventType = params.eventType;
-        const sampleData = params.sampleData;
-        // Generate request ID
-        const requestId = this._generateRequestId();
-        // Input validation (Phase 2B: zod)
-        if (this.sdkConfig?.validationEnabled) {
-            // TODO: Generate validation schema from endpoint parameters
-            // const validationSchema = z.object({ ... });
-            // validateParams(validationSchema, params, this.sdkConfig);
-        }
-        // Check cache (Phase 2B: optional caching)
-        const shouldCache = true;
-        const cache = (0, cache_1.getCache)(this.sdkConfig);
-        if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-            const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/webhook/test', params, this.sdkConfig);
-            const cached = cache.get(cacheKey);
-            if (cached) {
-                this.logger.debug('Cache hit', { request_id: requestId, cache_key: cacheKey });
-                return cached;
-            }
-        }
-        // Structured logging (Phase 2B: pino)
-        this.logger.debug('Test Webhook', {
-            request_id: requestId,
-            method: 'POST',
-            path: '/api/v1/session/webhook/test',
-            params: params,
-            action: 'testWebhook',
-        });
-        try {
-            const response = await (0, retry_1.retryApiCall)(async () => {
-                const apiResponse = await this.api.testWebhookApiV1SessionWebhookTestPost({
-                    finaticapiApiV1RoutersSessionSessionRouterTestWebhookRequest: {
-                        event_type: eventType,
-                        ...(sampleData !== undefined ? { sample_data: sampleData } : {}),
-                    },
-                }, {
-                    headers: {
-                        'x-session-id': this.sessionId,
-                        'x-company-id': this.companyId,
-                        'x-csrf-token': this.csrfToken,
-                        'x-request-id': requestId,
-                    },
-                });
-                return await (0, interceptors_1.applyResponseInterceptors)(apiResponse, this.sdkConfig);
-            }, {}, this.sdkConfig);
-            // Phase 2C: Unwrap API response and transform to standard response structure
-            const responseData = response && typeof response === 'object' && 'data' in response
-                ? response.data
-                : response;
-            if (!(responseData && typeof responseData === 'object' && 'data' in responseData)) {
-                throw new Error('Unexpected response shape: missing data');
-            }
-            const apiData = responseData.data;
-            const warnings = Array.isArray(responseData.warnings)
-                ? responseData.warnings
-                : undefined;
-            const meta = responseData.meta;
-            // Build standard response structure
-            const standardResponse = {
-                success: {
-                    data: (0, plain_object_1.convertToPlainObject)(apiData),
-                    ...(meta ? { meta } : {}),
-                },
-                ...(warnings && warnings.length > 0
-                    ? {
-                        Warning: warnings.map((w) => ({
-                            message: w.message || String(w),
-                            code: w.code,
-                            details: w.details || w,
-                        })),
-                    }
-                    : {}),
-            };
-            if (cache && this.sdkConfig?.cacheEnabled && shouldCache) {
-                const cacheKey = (0, cache_1.generateCacheKey)('POST', '/api/v1/session/webhook/test', params, this.sdkConfig);
-                cache.set(cacheKey, standardResponse, this.sdkConfig.cacheTtl || 300);
-            }
-            this.logger.debug('Test Webhook completed', {
-                request_id: requestId,
-                action: 'testWebhook',
-            });
-            // Phase 2C: Return standard response structure (already plain objects)
-            return standardResponse;
-        }
-        catch (error) {
-            try {
-                await (0, interceptors_1.applyErrorInterceptors)(error, this.sdkConfig);
-            }
-            catch { }
-            this.logger.error('Test Webhook failed', error, {
-                request_id: requestId,
-                action: 'testWebhook',
-            });
-            // Phase 2C: Extract error details from Axios errors or generic errors
-            let errorMessage = error instanceof Error ? error.message : String(error);
-            let errorCode = 'UNKNOWN_ERROR';
-            let errorStatus;
-            let errorDetails = {};
-            // Handle Axios errors (from OpenAPI generator)
-            if (error?.isAxiosError || error?.response) {
-                const axiosError = error;
-                errorStatus = axiosError.response?.status;
-                errorCode = axiosError.code || `HTTP_${errorStatus || 'UNKNOWN'}`;
-                errorMessage =
-                    axiosError.response?.data?.message ||
-                        axiosError.response?.statusText ||
-                        axiosError.message ||
-                        errorMessage;
-                errorDetails = {
-                    status: errorStatus,
-                    statusText: axiosError.response?.statusText,
-                    responseData: axiosError.response?.data,
-                    requestUrl: axiosError.config?.url,
-                    requestMethod: axiosError.config?.method,
-                };
-            }
-            else if (error instanceof Error) {
-                errorCode = error?.code || 'UNKNOWN_ERROR';
-                errorDetails = {
-                    stack: error.stack,
-                    name: error.name,
-                };
-            }
-            else {
-                errorDetails = { error };
-            }
-            // Phase 2C: Return standard error response structure
-            const errorResponse = {
-                success: {
-                    data: null,
-                },
-                Error: {
-                    message: errorMessage,
-                    code: errorCode,
-                    status: errorStatus,
-                    details: errorDetails,
-                },
-            };
-            return errorResponse;
-        }
-        // TODO Phase 2D: Add complex validation schemas (unions, enums, nested)
-        // TODO Phase 2D: Add orphaned method detection
-        // TODO Phase 2D: Add advanced convenience methods
-    }
-}
-exports.SessionWrapper = SessionWrapper;
-//# sourceMappingURL=session.js.map