polyv-live-api-sdk 1.0.0

package/dist/services/finance.service.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Finance Service
+ *
+ * Service for managing PolyV finance-related operations (Audio/Video Moderation).
+ * Provides methods for audio and video moderation settings and records.
+ *
+ * @module services/finance
+ */
+import type { PolyVClient } from '../client.js';
+import type { AudioModerationSettings, ListAudioModerationRecordsParams, ListAudioModerationRecordsResponse, UpdateAudioModerationSettingsParams, VideoModerationSettings, UpdateVideoModerationSettingsParams, ListVideoModerationResultsParams, ListVideoModerationResultsResponse } from '../types/finance.js';
+/**
+ * FinanceService
+ *
+ * Provides methods to interact with PolyV Finance APIs (Audio/Video Moderation).
+ *
+ * @example
+ * ```typescript
+ * const client = new PolyVClient({ appId: 'xxx', appSecret: 'yyy' });
+ * const settings = await client.finance.getAudioModerationSettings(123456);
+ * ```
+ */
+export declare class FinanceService {
+    private client;
+    /**
+     * Create a new FinanceService instance
+     *
+     * @param client - The PolyVClient instance to use for API calls
+     */
+    constructor(client: PolyVClient);
+    /**
+     * Get audio moderation settings
+     * Query audio moderation settings for a channel
+     *
+     * @param channelId - Channel ID
+     * @returns Audio moderation settings
+     *
+     * @example
+     * ```typescript
+     * const settings = await client.finance.getAudioModerationSettings(123456);
+     * console.log(settings.moderationEnabled);
+     * ```
+     */
+    getAudioModerationSettings(channelId: number | string): Promise<AudioModerationSettings>;
+    /**
+     * List audio moderation records
+     * Query paginated list of audio moderation records
+     *
+     * @param channelId - Channel ID
+     * @param params - Optional filter parameters
+     * @returns Paginated list of audio moderation records
+     *
+     * @example
+     * ```typescript
+     * const records = await client.finance.listAudioModerationRecords(123456, {
+     *   pageNumber: 1,
+     *   pageSize: 10,
+     * });
+     * ```
+     */
+    listAudioModerationRecords(channelId: number | string, params?: Omit<ListAudioModerationRecordsParams, 'channelId'>): Promise<ListAudioModerationRecordsResponse>;
+    /**
+     * Update audio moderation settings
+     * Modify audio moderation settings for a channel
+     *
+     * @param channelId - Channel ID
+     * @param settings - Update parameters
+     * @returns true on success
+     *
+     * @example
+     * ```typescript
+     * await client.finance.updateAudioModerationSettings(123456, {
+     *   moderationEnabled: 'Y',
+     *   moderationStrategy: 'normal',
+     * });
+     * ```
+     */
+    updateAudioModerationSettings(channelId: number | string, settings: UpdateAudioModerationSettingsParams): Promise<boolean>;
+    /**
+     * Get video moderation settings
+     * Query video moderation settings for a channel
+     *
+     * @param channelId - Channel ID
+     * @returns Video moderation settings
+     *
+     * @example
+     * ```typescript
+     * const settings = await client.finance.getVideoModerationSettings(123456);
+     * console.log(settings.imageFrequency);
+     * ```
+     */
+    getVideoModerationSettings(channelId: number | string): Promise<VideoModerationSettings>;
+    /**
+     * Update video moderation settings
+     * Modify video moderation settings for a channel
+     *
+     * @param channelId - Channel ID
+     * @param settings - Update parameters (all required)
+     * @returns true on success
+     *
+     * @example
+     * ```typescript
+     * await client.finance.updateVideoModerationSettings(123456, {
+     *   moderationEnabled: 'Y',
+     *   moderationStrategy: 'finance_serious',
+     *   imageFrequency: 60,
+     *   illegalNotify: {
+     *     platformEnabled: 'Y',
+     *   },
+     * });
+     * ```
+     */
+    updateVideoModerationSettings(channelId: number | string, settings: UpdateVideoModerationSettingsParams): Promise<boolean>;
+    /**
+     * List video moderation results
+     * Query paginated list of video moderation results
+     *
+     * @param channelId - Channel ID
+     * @param params - Optional filter parameters
+     * @returns Paginated list of video moderation results
+     *
+     * @example
+     * ```typescript
+     * const results = await client.finance.listVideoModerationResults(123456, {
+     *   sessionId: 'abc123',
+     *   pageNumber: 1,
+     *   pageSize: 20,
+     * });
+     * ```
+     */
+    listVideoModerationResults(channelId: number | string, params?: Omit<ListVideoModerationResultsParams, 'channelId'>): Promise<ListVideoModerationResultsResponse>;
+    /**
+     * Validate channel ID
+     */
+    private validateChannelId;
+    /**
+     * Validate Y/N value
+     */
+    private validateYNValue;
+    /**
+     * Validate audio moderation strategy
+     */
+    private validateAudioModerationStrategy;
+    /**
+     * Validate video moderation strategy
+     */
+    private validateVideoModerationStrategy;
+    /**
+     * Validate image frequency
+     */
+    private validateImageFrequency;
+    /**
+     * Validate illegal notify settings
+     */
+    private validateIllegalNotify;
+    /**
+     * Validate pagination parameters
+     */
+    private validatePagination;
+}
+//# sourceMappingURL=finance.service.d.ts.map

package/dist/services/finance.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance.service.d.ts","sourceRoot":"","sources":["../../src/services/finance.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EAClC,mCAAmC,EACnC,uBAAuB,EACvB,mCAAmC,EACnC,gCAAgC,EAChC,kCAAkC,EAEnC,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAc;IAE5B;;;;OAIG;gBACS,MAAM,EAAE,WAAW;IAQ/B;;;;;;;;;;;;OAYG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAW9F;;;;;;;;;;;;;;;OAeG;IACG,0BAA0B,CAC9B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,MAAM,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,WAAW,CAAC,GAC3D,OAAO,CAAC,kCAAkC,CAAC;IAyC9C;;;;;;;;;;;;;;;OAeG;IACG,6BAA6B,CACjC,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,QAAQ,EAAE,mCAAmC,GAC5C,OAAO,CAAC,OAAO,CAAC;IA4CnB;;;;;;;;;;;;OAYG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAW9F;;;;;;;;;;;;;;;;;;;OAmBG;IACG,6BAA6B,CACjC,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,QAAQ,EAAE,mCAAmC,GAC5C,OAAO,CAAC,OAAO,CAAC;IAuCnB;;;;;;;;;;;;;;;;OAgBG;IACG,0BAA0B,CAC9B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,MAAM,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,WAAW,CAAC,GAC3D,OAAO,CAAC,kCAAkC,CAAC;IAuC9C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAOvC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAOvC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/services/group.service.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Group Service
+ *
+ * Service for managing PolyV Group Account operations (v2 API).
+ * Provides methods for resource allocation to sub-accounts including:
+ * - Live streaming concurrency and duration
+ * - VOD flow and storage space
+ * - Allocation record queries
+ *
+ * @module services/group
+ */
+import type { PolyVClient } from '../client.js';
+import type { ListAllocateLogParams, ListAllocateLogResponse, SetConcurrencesParams, SetFlowParams, SetLiveDurationsParams, SetSpaceParams } from '../types/group.js';
+/**
+ * GroupService
+ *
+ * Provides methods to interact with PolyV Group Account APIs (v2).
+ * Used for managing sub-account resource allocation.
+ *
+ * @example
+ * ```typescript
+ * const client = new PolyVClient({ appId: 'xxx', appSecret: 'yyy' });
+ *
+ * // Allocate live concurrency to sub-account
+ * await client.group.setConcurrences({
+ *   email: 'sub@polyv.com',
+ *   concurrences: 100,
+ *   type: 'add'
+ * });
+ *
+ * // Query allocation records
+ * const logs = await client.group.listAllocateLog({
+ *   emails: 'sub@polyv.com'
+ * });
+ * ```
+ */
+export declare class GroupService {
+    private client;
+    /**
+     * Create a new GroupService instance
+     *
+     * @param client - The PolyVClient instance to use for API calls
+     */
+    constructor(client: PolyVClient);
+    /**
+     * List allocation records for sub-accounts
+     * Query allocation history for one or more sub-accounts
+     *
+     * @param params - Query parameters including emails (required)
+     * @returns Paginated list of allocation records
+     *
+     * @example
+     * ```typescript
+     * const logs = await client.group.listAllocateLog({
+     *   emails: 'sub@polyv.com',
+     *   type: 'live',
+     *   page: 1,
+     *   pageSize: 20
+     * });
+     * ```
+     */
+    listAllocateLog(params: ListAllocateLogParams): Promise<ListAllocateLogResponse>;
+    /**
+     * Set live concurrency for a sub-account
+     * Allocate or recover live streaming concurrency
+     *
+     * @param params - Parameters including email (required) and concurrences (required)
+     * @returns "success" on successful allocation
+     *
+     * @example
+     * ```typescript
+     * // Add concurrency
+     * await client.group.setConcurrences({
+     *   email: 'sub@polyv.com',
+     *   concurrences: 100,
+     *   type: 'add'
+     * });
+     *
+     * // Recover concurrency
+     * await client.group.setConcurrences({
+     *   email: 'sub@polyv.com',
+     *   concurrences: 50,
+     *   type: 'recover'
+     * });
+     * ```
+     */
+    setConcurrences(params: SetConcurrencesParams): Promise<string>;
+    /**
+     * Set VOD flow for a sub-account
+     * Allocate or recover VOD flow/bandwidth
+     *
+     * @param params - Parameters including email (required)
+     * @returns "success" on successful allocation
+     *
+     * @example
+     * ```typescript
+     * // Add flow
+     * await client.group.setFlow({
+     *   email: 'sub@polyv.com',
+     *   type: 'add'
+     * });
+     *
+     * // Recover all flow
+     * await client.group.setFlow({
+     *   email: 'sub@polyv.com',
+     *   type: 'recover',
+     *   all: 1
+     * });
+     * ```
+     */
+    setFlow(params: SetFlowParams): Promise<string>;
+    /**
+     * Set live duration for a sub-account
+     * Allocate or recover live streaming minutes
+     *
+     * @param params - Parameters including email (required) and duration (required)
+     * @returns "success" on successful allocation
+     *
+     * @example
+     * ```typescript
+     * // Add duration
+     * await client.group.setLiveDurations({
+     *   email: 'sub@polyv.com',
+     *   duration: 1000,
+     *   type: 'add'
+     * });
+     *
+     * // Recover duration
+     * await client.group.setLiveDurations({
+     *   email: 'sub@polyv.com',
+     *   duration: 500,
+     *   type: 'recover'
+     * });
+     * ```
+     */
+    setLiveDurations(params: SetLiveDurationsParams): Promise<string>;
+    /**
+     * Set VOD space for a sub-account
+     * Allocate or recover VOD storage space (in GB)
+     *
+     * @param params - Parameters including email (required)
+     * @returns "success" on successful allocation
+     *
+     * @example
+     * ```typescript
+     * // Add space
+     * await client.group.setSpace({
+     *   email: 'sub@polyv.com',
+     *   space: 10,
+     *   type: 'add'
+     * });
+     *
+     * // Recover all space
+     * await client.group.setSpace({
+     *   email: 'sub@polyv.com',
+     *   type: 'recover',
+     *   all: 1
+     * });
+     * ```
+     */
+    setSpace(params: SetSpaceParams): Promise<string>;
+    /**
+     * Validate email (single)
+     */
+    private validateEmail;
+    /**
+     * Validate emails (comma-separated)
+     */
+    private validateEmails;
+    /**
+     * Validate allocation log type
+     */
+    private validateAllocateLogType;
+    /**
+     * Validate allocation type (add/recover)
+     */
+    private validateAllocationType;
+    /**
+     * Validate positive integer
+     */
+    private validatePositiveInteger;
+    /**
+     * Validate all parameter (only valid with type=recover)
+     */
+    private validateAllParameter;
+    /**
+     * Validate pagination parameters
+     */
+    private validatePagination;
+}
+//# sourceMappingURL=group.service.d.ts.map

package/dist/services/group.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.service.d.ts","sourceRoot":"","sources":["../../src/services/group.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAE5B;;;;OAIG;gBACS,MAAM,EAAE,WAAW;IAQ/B;;;;;;;;;;;;;;;;OAgBG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2CtF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCrE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCrD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCvE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA8CvD;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/services/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Services Module
+ *
+ * This module exports all service classes for the PolyV SDK.
+ */
+export { ChannelService } from './channel.service.js';
+export { ChatService } from './chat.service.js';
+export { LiveInteractionService } from './live-interaction.service.js';
+export { AccountService } from './account.service.js';
+export { WebService } from './web.service.js';
+export { PlatformService } from './platform.service.js';
+export { FinanceService } from './finance.service.js';
+export { GroupService } from './group.service.js';
+export { V4AiService } from './v4/ai.service.js';
+export { V4RobotService } from './v4/robot.service.js';
+export { V4ChannelService } from './v4/channel.service.js';
+export { V4ChatService } from './v4/chat.service.js';
+export { V4StatisticsService } from './v4/statistics.service.js';
+export { V4UserService } from './v4/user.service.js';
+export { V4GlobalService } from './v4/global.service.js';
+export { V4GroupService } from './v4/group.service.js';
+export { V4MaterialService } from './v4/material.service.js';
+export { V4PlatformService } from './v4/platform.service.js';
+export { V4WebAppService } from './v4/webapp.service.js';
+export { PlayerService } from './player.service.js';
+export { OtherService } from './other.service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}