polyv-live-api-sdk 1.0.0

package/dist/auth/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Authentication Module
+ *
+ * Re-exports signature generation functions and types.
+ *
+ * @module auth
+ */
+export { generateSignature, generateTimestamp, sortParams, createSignature, } from './signature.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/auth/signature.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Signature Generation Module
+ *
+ * Provides MD5 and SHA256 signature generation for PolyV API authentication.
+ * Supports both Node.js (native crypto) and browser (crypto-js) environments.
+ *
+ * @module auth/signature
+ */
+import { SignatureMethod } from '../types/signature.js';
+import type { SignatureOutput, SignatureInput } from '../types/signature.js';
+import type { SignatureConfig } from '../types/auth.js';
+/**
+ * Generate signature for PolyV API authentication
+ *
+ * The signature algorithm:
+ * 1. Filter out null/undefined parameter values
+ * 2. Sort remaining parameters by key (ASCII order)
+ * 3. Concatenate as key1value1key2value2...
+ * 4. Prepend and append appSecret
+ * 5. Compute MD5 or SHA256 hash (uppercase hex)
+ *
+ * @param params Parameters to sign (includes appId, timestamp, and optional business params)
+ * @param config Signature configuration with appSecret and optional method
+ * @returns Signature output with sign, timestamp, and method
+ *
+ * @example
+ * ```typescript
+ * const result = generateSignature(
+ *   { appId: 'g4rqgmmjuo', timestamp: 1660270926732 },
+ *   { appSecret: 'fsq2k5weced1h8vui657xtdva66whf0g' }
+ * );
+ * // result.sign === '0D2BDA2FD04D93A2B8832B91FD973C4D'
+ * ```
+ */
+export declare function generateSignature(params: Record<string, unknown>, config: SignatureConfig): SignatureOutput;
+/**
+ * Generate signature for PolyV API authentication (alternative signature)
+ *
+ * @param input Signature input with appId, timestamp, and optional params
+ * @param config Signature configuration with appSecret and optional method
+ * @returns Signature output with sign, timestamp, and method
+ */
+export declare function generateSignature(input: SignatureInput, config: SignatureConfig): SignatureOutput;
+/**
+ * Generate timestamp in milliseconds
+ * @param customTimestamp Optional custom timestamp for testing
+ * @returns Current timestamp in milliseconds
+ */
+export declare function generateTimestamp(customTimestamp?: number): number;
+/**
+ * Sort parameters by key name (ASCII order)
+ * @param params Parameters to sort
+ * @returns Sorted keys array
+ */
+export declare function sortParams(params: Record<string, unknown>): string[];
+/**
+ * Create signature with just appId, appSecret, and optional business params
+ * Convenience function that auto-generates timestamp
+ *
+ * @param appId PolyV App ID
+ * @param appSecret PolyV App Secret
+ * @param params Optional business parameters
+ * @param method Signature method (default: MD5)
+ * @returns Signature output
+ */
+export declare function createSignature(appId: string, appSecret: string, params?: Record<string, unknown>, method?: SignatureMethod): SignatureOutput;
+//# sourceMappingURL=signature.d.ts.map

package/dist/auth/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../src/auth/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAuExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,eAAe,GACtB,eAAe,CAAC;AAEnB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,eAAe,GACtB,eAAe,CAAC;AA0EnB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAIpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,CAAC,EAAE,eAAe,GACvB,eAAe,CAcjB"}

package/dist/client.d.ts

@@ -0,0 +1,209 @@
+/**
+ * PolyV Client
+ *
+ * The main client class for interacting with the PolyV Live API.
+ * Provides automatic signature injection, error handling, and request management.
+ *
+ * @module client
+ */
+import { type AxiosInstance, type AxiosRequestConfig } from 'axios';
+import { ChannelService } from './services/channel.service.js';
+import { ChatService } from './services/chat.service.js';
+import { LiveInteractionService } from './services/live-interaction.service.js';
+import { AccountService } from './services/account.service.js';
+import { WebService } from './services/web.service.js';
+import { PlatformService } from './services/platform.service.js';
+import { FinanceService } from './services/finance.service.js';
+import { GroupService } from './services/group.service.js';
+import { PlayerService } from './services/player.service.js';
+import { OtherService } from './services/other.service.js';
+import { V4AiService } from './services/v4/ai.service.js';
+import { V4RobotService } from './services/v4/robot.service.js';
+import { V4ChannelService } from './services/v4/channel.service.js';
+import { V4ChatService } from './services/v4/chat.service.js';
+import { V4StatisticsService } from './services/v4/statistics.service.js';
+import { V4UserService } from './services/v4/user.service.js';
+import { V4GlobalService } from './services/v4/global.service.js';
+import { V4GroupService } from './services/v4/group.service.js';
+import { V4MaterialService } from './services/v4/material.service.js';
+import { V4PlatformService } from './services/v4/platform.service.js';
+import { V4WebAppService } from './services/v4/webapp.service.js';
+import type { RequestOptions } from './types/request.js';
+import type { PolyVClientConfig, ResolvedClientConfig } from './types/client.js';
+/**
+ * PolyVClient
+ *
+ * The main client for interacting with PolyV Live API.
+ *
+ * @example
+ * ```typescript
+ * const client = new PolyVClient({
+ *   appId: 'your-app-id',
+ *   appSecret: 'your-app-secret'
+ * });
+ *
+ * // Make a request
+ * const channels = await client.get('/channel/list', { page: 1 });
+ * ```
+ */
+export declare class PolyVClient {
+    /**
+     * Resolved configuration with defaults applied
+     */
+    readonly config: ResolvedClientConfig;
+    /**
+     * Axios HTTP client instance
+     */
+    readonly httpClient: AxiosInstance;
+    /**
+     * Channel service for managing live channels
+     */
+    readonly channel: ChannelService;
+    /**
+     * Chat service for managing chat messages
+     */
+    readonly chat: ChatService;
+    /**
+     * Live interaction service for managing interactions (lottery, questionnaire, checkin, questions)
+     */
+    readonly liveInteraction: LiveInteractionService;
+    /**
+     * Account service for managing account operations
+     */
+    readonly account: AccountService;
+    /**
+     * Web service for managing web page operations
+     */
+    readonly web: WebService;
+    /**
+     * Platform service for managing platform operations
+     */
+    readonly platform: PlatformService;
+    /**
+     * V4 AI service for managing AI and digital human operations
+     */
+    readonly v4Ai: V4AiService;
+    /**
+     * V4 Robot service for managing robot operations
+     */
+    readonly v4Robot: V4RobotService;
+    /**
+     * V4 Channel service for managing channel operations
+     */
+    readonly v4Channel: V4ChannelService;
+    /**
+     * V4 Chat service for managing chat operations
+     */
+    readonly v4Chat: V4ChatService;
+    /**
+     * V4 Statistics service for managing statistics operations
+     */
+    readonly v4Statistics: V4StatisticsService;
+    /**
+     * V4 User service for managing user operations
+     */
+    readonly v4User: V4UserService;
+    /**
+     * V4 Global service for managing global settings
+     */
+    readonly v4Global: V4GlobalService;
+    /**
+     * V4 Group service for managing group operations
+     */
+    readonly v4Group: V4GroupService;
+    /**
+     * V4 Material service for managing material library
+     */
+    readonly v4Material: V4MaterialService;
+    /**
+     * V4 Platform service for managing coupons
+     */
+    readonly v4Platform: V4PlatformService;
+    /**
+     * V4 WebApp service for managing permissions and roles
+     */
+    readonly v4WebApp: V4WebAppService;
+    /**
+     * Finance service for managing audio/video moderation
+     */
+    readonly finance: FinanceService;
+    /**
+     * Group service for managing group account resources
+     */
+    readonly group: GroupService;
+    /**
+     * Player service for managing player settings (anti-record, adverts, logo, watch feedback)
+     */
+    readonly player: PlayerService;
+    /**
+     * Other service for managing miscellaneous operations
+     */
+    readonly other: OtherService;
+    /**
+     * Create a new PolyVClient instance
+     *
+     * @param config - Client configuration options
+     */
+    constructor(config: PolyVClientConfig);
+    /**
+     * Create and configure the Axios HTTP client with interceptors
+     */
+    private createHttpClient;
+    /**
+     * Transform Axios errors to PolyVAPIError
+     */
+    private transformAxiosError;
+    /**
+     * Make a generic HTTP request
+     *
+     * @param config - Axios request configuration
+     * @returns Response data (extracted from API response)
+     */
+    request<T = unknown>(config: AxiosRequestConfig & RequestOptions): Promise<T>;
+    /**
+     * Make a GET request
+     *
+     * @param url - Request URL path
+     * @param params - Query parameters
+     * @param options - Additional request options
+     * @returns Response data
+     */
+    get<T = unknown>(url: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request
+     *
+     * @param url - Request URL path
+     * @param data - Request body data
+     * @param options - Additional request options
+     * @returns Response data
+     */
+    post<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PUT request
+     *
+     * @param url - Request URL path
+     * @param data - Request body data
+     * @param options - Additional request options
+     * @returns Response data
+     */
+    put<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a DELETE request
+     *
+     * @param url - Request URL path
+     * @param params - Query parameters
+     * @param options - Additional request options
+     * @returns Response data
+     */
+    delete<T = unknown>(url: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PATCH request
+     *
+     * @param url - Request URL path
+     * @param data - Request body data
+     * @param options - Additional request options
+     * @returns Response data
+     */
+    patch<T = unknown>(url: string, data?: unknown, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/constants/error-codes.d.ts

@@ -0,0 +1,134 @@
+/**
+ * PolyV Error Code Mapping
+ *
+ * This module defines error codes and their messages for the PolyV Live API.
+ * Error codes are organized by category:
+ * - Authentication (20000-20999): App ID, signature, timestamp issues
+ * - Parameter (10000-19999): Request parameter validation errors
+ * - Channel (30000-39999): Channel-related errors
+ * - Permission (40000-49999): Authorization and account issues
+ * - Service (50000-59999): Server-side errors
+ */
+/**
+ * PolyV API Error Code Enumeration
+ *
+ * Each error code corresponds to a specific error condition returned by the PolyV API.
+ */
+export declare enum PolyVErrorCode {
+    /** Invalid or non-existent appId */
+    INVALID_APP_ID = 20001,
+    /** Signature verification failed */
+    INVALID_SIGNATURE = 20002,
+    /** Request timestamp has expired (3 minute window) */
+    TIMESTAMP_EXPIRED = 20003,
+    /** Duplicate request detected (signatureNonce reuse) */
+    DUPLICATE_REQUEST = 20004,
+    /** Unsupported signature method */
+    INVALID_SIGNATURE_METHOD = 20005,
+    /** General parameter error */
+    INVALID_PARAMETER = 10001,
+    /** Required parameter is missing */
+    MISSING_REQUIRED_PARAMETER = 10002,
+    /** Parameter format is invalid */
+    INVALID_PARAMETER_FORMAT = 10003,
+    /** Channel does not exist */
+    CHANNEL_NOT_FOUND = 30001,
+    /** Channel has been disabled */
+    CHANNEL_DISABLED = 30002,
+    /** Channel has expired */
+    CHANNEL_EXPIRED = 30003,
+    /** Channel count limit exceeded */
+    CHANNEL_LIMIT_EXCEEDED = 30004,
+    /** Permission denied */
+    PERMISSION_DENIED = 40001,
+    /** Account balance insufficient */
+    INSUFFICIENT_BALANCE = 40002,
+    /** Feature not enabled for account */
+    FEATURE_NOT_ENABLED = 40003,
+    /** Internal server error */
+    INTERNAL_ERROR = 50001,
+    /** Service temporarily unavailable */
+    SERVICE_UNAVAILABLE = 50002,
+    /** Request timeout */
+    REQUEST_TIMEOUT = 50003
+}
+/**
+ * Error message mapping for each error code
+ */
+export declare const ERROR_MESSAGES: Record<PolyVErrorCode, string>;
+/**
+ * Error category definition
+ */
+export interface ErrorCategory {
+    /** Category name in Chinese */
+    name: string;
+    /** Error code range for this category */
+    range: {
+        min: number;
+        max: number;
+    };
+}
+/**
+ * Error categories organized by code range
+ */
+export declare const ERROR_CATEGORIES: Record<string, ErrorCategory>;
+/**
+ * Valid error category names
+ */
+export type ErrorCategoryName = keyof typeof ERROR_CATEGORIES;
+/**
+ * Get the error message for a specific error code
+ *
+ * @param code - The PolyV error code
+ * @returns The corresponding error message in Chinese
+ *
+ * @example
+ * ```typescript
+ * const message = getErrorMessage(PolyVErrorCode.INVALID_APP_ID);
+ * // Returns: '无效的 appId'
+ * ```
+ */
+export declare function getErrorMessage(code: PolyVErrorCode): string;
+/**
+ * Check if a number is a valid PolyV error code
+ *
+ * @param code - The number to check
+ * @returns True if the code is a valid PolyV error code
+ *
+ * @example
+ * ```typescript
+ * isPolyVErrorCode(20001); // true
+ * isPolyVErrorCode(99999); // false
+ * ```
+ */
+export declare function isPolyVErrorCode(code: number): boolean;
+/**
+ * Get error message by error code number with optional default message
+ *
+ * @param code - The error code number
+ * @param defaultMessage - Optional default message for unknown codes
+ * @returns The error message or default message
+ *
+ * @example
+ * ```typescript
+ * getErrorMessageByCode(20001); // '无效的 appId'
+ * getErrorMessageByCode(99999); // '未知错误'
+ * getErrorMessageByCode(99999, '自定义错误'); // '自定义错误'
+ * ```
+ */
+export declare function getErrorMessageByCode(code: number, defaultMessage?: string): string;
+/**
+ * Get the error category for a given error code
+ *
+ * @param code - The error code number
+ * @returns The category name or 'UNKNOWN' if not in any category range
+ *
+ * @example
+ * ```typescript
+ * getErrorCodeCategory(20001); // 'AUTH'
+ * getErrorCodeCategory(30001); // 'CHANNEL'
+ * getErrorCodeCategory(999); // 'UNKNOWN'
+ * ```
+ */
+export declare function getErrorCodeCategory(code: number): string;
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/constants/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/constants/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,oBAAY,cAAc;IAExB,oCAAoC;IACpC,cAAc,QAAQ;IACtB,oCAAoC;IACpC,iBAAiB,QAAQ;IACzB,sDAAsD;IACtD,iBAAiB,QAAQ;IACzB,wDAAwD;IACxD,iBAAiB,QAAQ;IACzB,mCAAmC;IACnC,wBAAwB,QAAQ;IAGhC,8BAA8B;IAC9B,iBAAiB,QAAQ;IACzB,oCAAoC;IACpC,0BAA0B,QAAQ;IAClC,kCAAkC;IAClC,wBAAwB,QAAQ;IAGhC,6BAA6B;IAC7B,iBAAiB,QAAQ;IACzB,gCAAgC;IAChC,gBAAgB,QAAQ;IACxB,0BAA0B;IAC1B,eAAe,QAAQ;IACvB,mCAAmC;IACnC,sBAAsB,QAAQ;IAG9B,wBAAwB;IACxB,iBAAiB,QAAQ;IACzB,mCAAmC;IACnC,oBAAoB,QAAQ;IAC5B,sCAAsC;IACtC,mBAAmB,QAAQ;IAG3B,4BAA4B;IAC5B,cAAc,QAAQ;IACtB,sCAAsC;IACtC,mBAAmB,QAAQ;IAC3B,sBAAsB;IACtB,eAAe,QAAQ;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CA4BzD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAqB1D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,SAAS,GAAG,MAAM,CAKnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/constants/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PolyV SDK Constants Module
+ *
+ * This module exports all constants, enumerations, and helper functions
+ * for error codes and other configuration values.
+ */
+export { PolyVErrorCode, ERROR_MESSAGES, ERROR_CATEGORIES, getErrorMessage, isPolyVErrorCode, getErrorMessageByCode, getErrorCodeCategory, type ErrorCategory, type ErrorCategoryName, } from './error-codes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PolyV SDK Error Classes
+ *
+ * This module exports all error classes and type guards for consistent error handling.
+ */
+export { PolyVError } from './polyv-error.js';
+export { PolyVAPIError } from './polyv-api-error.js';
+export { PolyVValidationError } from './polyv-validation-error.js';
+export { isPolyVError, isPolyVAPIError, isPolyVValidationError } from './type-guards.js';
+export type { PolyVErrorOptions, PolyVAPIErrorOptions, PolyVAPIErrorResponse, ValidationConstraints, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGzF,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/errors/polyv-api-error.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PolyV API Error Class
+ *
+ * Represents errors returned from the PolyV API.
+ * Contains PolyV-specific error codes and messages.
+ */
+import { PolyVError } from './polyv-error.js';
+/**
+ * Options for creating a PolyVAPIError
+ */
+export interface PolyVAPIErrorOptions {
+    polyvCode?: number;
+    polyvMessage?: string;
+    code?: string;
+    details?: unknown;
+}
+/**
+ * PolyV API response structure for error handling
+ */
+export interface PolyVAPIErrorResponse {
+    code: number;
+    status: string;
+    message: string;
+    data?: {
+        polyvCode?: number;
+        polyvMessage?: string;
+    };
+}
+export declare class PolyVAPIError extends PolyVError {
+    /**
+     * HTTP status code from the API response
+     */
+    readonly statusCode: number;
+    /**
+     * PolyV-specific error code
+     */
+    readonly polyvCode?: number;
+    /**
+     * PolyV-specific error message
+     */
+    readonly polyvMessage?: string;
+    constructor(message: string, statusCode: number, options?: PolyVAPIErrorOptions);
+    /**
+     * Create a PolyVAPIError from an API response
+     */
+    static fromResponse(response: PolyVAPIErrorResponse): PolyVAPIError;
+    /**
+     * Check if the error is retryable
+     * - 5xx errors are retryable (server errors)
+     * - 429 (rate limit) is retryable
+     * - Other 4xx errors are not retryable
+     */
+    isRetryable(): boolean;
+    /**
+     * Serialize error to JSON for logging and debugging
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string | undefined;
+        details: unknown;
+        statusCode: number;
+        polyvCode: number | undefined;
+        polyvMessage: string | undefined;
+    };
+    /**
+     * Return a formatted string representation of the error
+     */
+    toString(): string;
+}
+//# sourceMappingURL=polyv-api-error.d.ts.map

package/dist/errors/polyv-api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyv-api-error.d.ts","sourceRoot":"","sources":["../../src/errors/polyv-api-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,aAAc,SAAQ,UAAU;IAC3C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAY/E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa;IAOnE;;;;;OAKG;IACH,WAAW,IAAI,OAAO;IAYtB;;OAEG;IACM,MAAM,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;KAClC;IASD;;OAEG;IACM,QAAQ,IAAI,MAAM;CAM5B"}

package/dist/errors/polyv-error.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PolyV SDK Base Error Class
+ *
+ * All PolyV SDK errors extend from this class.
+ * Provides consistent error handling with name, message, code, and details.
+ */
+export declare class PolyVError extends Error {
+    /**
+     * Error code for programmatic error handling
+     */
+    readonly code?: string;
+    /**
+     * Additional error details
+     */
+    readonly details?: unknown;
+    constructor(message: string, code?: string, details?: unknown);
+    /**
+     * Serialize error to JSON for logging and debugging
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string | undefined;
+        details: unknown;
+    };
+    /**
+     * Return a formatted string representation of the error
+     */
+    toString(): string;
+}
+//# sourceMappingURL=polyv-error.d.ts.map

package/dist/errors/polyv-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyv-error.d.ts","sourceRoot":"","sources":["../../src/errors/polyv-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAmB7D;;OAEG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;KAClB;IASD;;OAEG;IACH,QAAQ,IAAI,MAAM;CAMnB"}

package/dist/errors/polyv-validation-error.d.ts

@@ -0,0 +1,72 @@
+/**
+ * PolyV Validation Error Class
+ *
+ * Represents parameter validation errors.
+ * Provides field-level error details and factory methods for common validation errors.
+ */
+import { PolyVError } from './polyv-error.js';
+/**
+ * Validation constraints metadata
+ */
+export interface ValidationConstraints {
+    [key: string]: unknown;
+}
+export declare class PolyVValidationError extends PolyVError {
+    /**
+     * The field that failed validation
+     */
+    readonly field?: string;
+    /**
+     * The value that was rejected
+     */
+    readonly invalidValue?: unknown;
+    /**
+     * Validation constraints that were not satisfied
+     */
+    readonly constraints?: ValidationConstraints;
+    /**
+     * Array of aggregated errors (when multiple validation errors exist)
+     */
+    readonly errors?: PolyVValidationError[];
+    constructor(message: string, field?: string, invalidValue?: unknown, constraints?: ValidationConstraints, code?: string);
+    /**
+     * Serialize error to JSON for logging and debugging
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string | undefined;
+        details: unknown;
+        field: string | undefined;
+        invalidValue: unknown;
+        constraints: ValidationConstraints | undefined;
+    };
+    /**
+     * Return a formatted string representation of the error
+     */
+    toString(): string;
+    /**
+     * Factory method for required field errors
+     */
+    static required(field: string): PolyVValidationError;
+    /**
+     * Factory method for invalid type errors
+     */
+    static invalidType(field: string, expectedType: string, actualValue: unknown): PolyVValidationError;
+    /**
+     * Factory method for out of range errors
+     */
+    static outOfRange(field: string, value: number, constraints: {
+        min?: number;
+        max?: number;
+    }): PolyVValidationError;
+    /**
+     * Factory method for pattern mismatch errors
+     */
+    static patternMismatch(field: string, value: string, pattern: RegExp): PolyVValidationError;
+    /**
+     * Aggregate multiple validation errors into a single error
+     */
+    static aggregate(errors: PolyVValidationError[]): PolyVValidationError | null;
+}
+//# sourceMappingURL=polyv-validation-error.d.ts.map

package/dist/errors/polyv-validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyv-validation-error.d.ts","sourceRoot":"","sources":["../../src/errors/polyv-validation-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,qBAAqB,EACnC,IAAI,CAAC,EAAE,MAAM;IAwBf;;OAEG;IACM,MAAM,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,YAAY,EAAE,OAAO,CAAC;QACtB,WAAW,EAAE,qBAAqB,GAAG,SAAS,CAAC;KAChD;IAcD;;OAEG;IACM,QAAQ,IAAI,MAAM;IAO3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB;IAIpD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,oBAAoB;IASnG;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,oBAAoB;IAevB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB;IAM3F;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,oBAAoB,GAAG,IAAI;CAgB9E"}