polyv-live-api-sdk 1.0.13 → 1.0.14-rc.0

package/dist/types/v4-user.d.ts

@@ -102,10 +102,14 @@ export interface GetChildAccountParams {
  * Parameters for updating a child account
  */
 export interface UpdateChildAccountParams {
-    /** Child user ID (required) */
-    childUserId: string;
+    /** Sub-account login email (required by current API docs) */
+    childEmail?: string;
+    /** Legacy child user ID alias */
+    childUserId?: string;
     /** Sub-account name */
     childName?: string;
+    /** Password */
+    password?: string;
     /** Phone number */
     telephone?: string;
     /** Description */
@@ -119,40 +123,81 @@ export interface UpdateChildAccountParams {
  * Parameters for deleting child accounts
  */
 export interface DeleteChildAccountsParams {
+    /** Sub-account login email */
+    childEmail?: string;
+    /** Sub-account login emails */
+    childEmails?: string[];
     /** Array of child user IDs to delete */
-    childUserIds: string[];
+    childUserIds?: string[];
 }
 /**
  * Child account role entity
  */
 export interface ChildAccountRole {
     /** Role ID */
-    roleId: number;
+    id: number;
     /** Role name */
-    roleName: string;
+    name: string;
+    /** Role description */
+    description?: string;
+    /** Comma-separated permission names */
+    permissionName?: string;
 }
 /**
  * Parameters for getting child account by sale
  */
 export interface GetBySaleParams {
-    /** Sale identifier */
-    sale: string;
+    /** Sale ID. Required when saleCode is omitted. */
+    saleId?: string;
+    /** Sale invitation code. Required when saleId is omitted. */
+    saleCode?: string;
+}
+/**
+ * Invite customer sale account information
+ */
+export interface InviteCustomerInfo {
+    /** PolyV user ID */
+    userId?: string;
+    /** Child account user ID */
+    childUserId?: string;
+    /** Child account name */
+    childName?: string;
+    /** Child account email */
+    childEmail?: string;
+    /** Child account avatar */
+    avatar?: string;
+    /** Child account telephone */
+    telephone?: string;
 }
 /**
  * Organization entity
  */
 export interface Organization {
     /** Organization ID */
-    organizationId: number;
+    organizationId?: number;
+    /** Organization ID returned by API */
+    id?: number;
     /** Organization name */
-    organizationName: string;
+    organizationName?: string;
+    /** Organization name returned by API */
+    name?: string;
+    /** Organization description */
+    description?: string;
+    /** Parent organization ID */
+    parentId?: number;
 }
 /**
  * Parameters for creating an organization
  */
 export interface CreateOrganizationParams {
-    /** Organization name */
-    organizationName: string;
+    /** Organization name (required by current API docs) */
+    name?: string;
+    /** Parent organization ID (required by current API docs) */
+    parentId?: number;
+    /** Organization description */
+    description?: string;
+    /** Legacy organization name alias */
+    organizationName?: string;
 }
 /**
  * Response for creating an organization
@@ -291,30 +336,94 @@ export interface DirectAuthViewerParams {
 export interface ExternalViewerItem {
     /** Viewer nickname */
     nickname: string;
-    /** Phone number */
-    mobile: string;
-    /** Name */
-    name?: string;
-    /** Email */
-    email?: string;
-    /** Area */
-    area?: string;
+    /** External viewer ID */
+    externalViewerId: string;
+    /** Viewer label IDs */
+    labelIds?: Array<string | number>;
+    /** Follow user info */
+    followUsers?: ViewerFollowUser;
+}
+/**
+ * Viewer follow user info
+ */
+export interface ViewerFollowUser {
+    /** Follow user ID */
+    userId: string;
+    /** Follow user type, defaults to wxwork */
+    type?: string;
 }
 /**
  * Parameters for importing external viewers
  */
-export interface ImportExternalViewerParams {
-    /** Array of viewers to import */
-    viewers: ExternalViewerItem[];
+export type ImportExternalViewerParams = ExternalViewerItem[];
+/**
+ * Imported external viewer item
+ */
+export interface ImportedExternalViewer {
+    /** Viewer union ID */
+    viewerUnionId: string;
+    /** Viewer nickname */
+    nickname: string;
+    /** External viewer ID */
+    externalViewerId: string;
+    /** Viewer source */
+    source?: ViewerSource;
+    /** Latest auth timestamp */
+    latestAuthTime?: number;
+    /** Created timestamp */
+    createTime?: number;
+}
+/**
+ * Response for importing external viewers
+ */
+export type ImportExternalViewerResponse = ImportedExternalViewer[];
+/**
+ * Y/N switch value
+ */
+export type UserSwitchValue = 'Y' | 'N';
+/**
+ * Tourist external auth link config
+ */
+export interface TouristExternalHrefConfig {
+    pcLink?: string;
+    mobileLink?: string;
+    androidLink?: string;
+    iosLink?: string;
+    otherLink?: string;
+    wxMiniprogramLink?: string;
+    wxMiniprogramOriginalId?: string;
+    wxMiniprogramAppId?: string;
+    mobileAppLink?: string;
+    harmonyLink?: string;
+    jumpWay?: string;
+}
+/**
+ * Parameters for updating viewer user system config
+ */
+export interface UpdateViewerUserSystemConfigParams {
+    /** Mobile login switch */
+    mobileLoginEnabled: UserSwitchValue;
+    /** WeCom login switch */
+    wxWorkLoginEnabled: UserSwitchValue;
+    /** WeChat auth validity period in days, 0-180 */
+    viewerWeixinAuthExpired?: number;
+    /** Collect mobile switch */
+    collectMobileEnabled?: UserSwitchValue;
+    /** Guest mode switch */
+    guestModeEnabled?: UserSwitchValue;
+    /** Tourist external login switch */
+    touristExternalHrefEnabled?: UserSwitchValue;
+    /** Tourist external login link config */
+    touristExternalHrefConfig?: TouristExternalHrefConfig;
 }
 /**
  * Viewer label entity
  */
 export interface ViewerLabel {
     /** Label ID */
-    labelId: number;
+    id: string | number;
     /** Label name */
-    labelName: string;
+    label: string;
 }
 /**
  * Response for listing viewer labels
@@ -327,29 +436,28 @@ export interface ListViewerLabelsResponse {
  * Parameters for creating a viewer label
  */
 export interface CreateViewerLabelParams {
-    /** Label name */
-    labelName: string;
+    /** Label names */
+    labels: string[];
 }
 /**
  * Response for creating a viewer label
  */
-export interface CreateViewerLabelResponse extends ViewerLabel {
-}
+export type CreateViewerLabelResponse = ViewerLabel[];
 /**
  * Parameters for updating a viewer label
  */
 export interface UpdateViewerLabelParams {
     /** Label ID */
-    labelId: number;
+    id: string | number;
     /** Label name */
-    labelName: string;
+    label?: string;
 }
 /**
  * Parameters for deleting a viewer label
  */
 export interface DeleteViewerLabelParams {
     /** Label ID */
-    labelId: number;
+    id: string | number;
 }
 /**
  * Parameters for adding a label to viewer
@@ -385,12 +493,56 @@ export interface Product {
     link?: string;
     /** Product type (normal, finance, position) */
     productType?: string;
+    /** PC link */
+    pcLink?: string;
+    /** Mobile link */
+    mobileLink?: string;
+    /** WeChat mini program original ID */
+    wxMiniprogramOriginalId?: string;
+    /** WeChat mini program link */
+    wxMiniprogramLink?: string;
+    /** Mobile app link */
+    mobileAppLink?: string;
+    /** iOS link */
+    iosLink?: string;
+    /** Android link */
+    androidLink?: string;
+    /** Other platform link */
+    otherLink?: string;
+    /** Product features as a JSON array string */
+    features?: string;
     /** Original price */
     price?: number;
     /** Actual price */
     realPrice?: number;
+    /** Actual price type */
+    priceType?: string;
+    /** Custom actual price */
+    customPrice?: string;
+    /** Original price type */
+    originalPriceType?: string;
+    /** Custom original price */
+    customOriginalPrice?: string;
+    /** API typo preserved for compatibility with the source document */
+    customOrignalPrice?: string;
     /** Product tag IDs */
     tagIds?: number[];
+    /** Button label */
+    btnShow?: string;
+    /** Product description */
+    productDesc?: string;
+    /** Product detail */
+    productDetail?: string;
+    /** Extended product information as a JSON object string */
+    ext?: string;
+    /** Product rank */
+    rank?: number;
+    /** Legacy type field returned by some APIs */
+    type?: string;
+    /** Extra returned params */
+    params?: unknown;
+    /** Yield/rate for finance products */
+    yield?: string | number | null;
 }
 /**
  * Parameters for listing products
@@ -420,18 +572,53 @@ export interface CreateProductParams {
     cover?: string;
     /** Product type */
     productType?: string;
+    /** PC link */
+    pcLink?: string;
+    /** Mobile link */
+    mobileLink?: string;
+    /** WeChat mini program original ID */
+    wxMiniprogramOriginalId?: string;
+    /** WeChat mini program link */
+    wxMiniprogramLink?: string;
+    /** Mobile app link */
+    mobileAppLink?: string;
+    /** iOS link */
+    iosLink?: string;
+    /** Android link */
+    androidLink?: string;
+    /** Other platform link */
+    otherLink?: string;
+    /** Product features as a JSON array string */
+    features?: string;
     /** Original price */
     price?: number;
     /** Actual price */
     realPrice?: number;
+    /** Actual price type */
+    priceType?: string;
+    /** Custom actual price */
+    customPrice?: string;
+    /** Original price type */
+    originalPriceType?: string;
+    /** Custom original price */
+    customOriginalPrice?: string;
+    /** API typo preserved for compatibility with the source document */
+    customOrignalPrice?: string;
     /** Product tag IDs */
     tagIds?: number[];
+    /** Button label */
+    btnShow?: string;
+    /** Product description */
+    productDesc?: string;
+    /** Product detail */
+    productDetail?: string;
+    /** Extended product information as a JSON object string */
+    ext?: string;
 }
 /**
  * Response for creating a product
  */
-export interface CreateProductResponse extends Product {
-}
+export type CreateProductResponse = string | null;
 /**
  * Parameters for updating a product
  */
@@ -448,12 +635,48 @@ export interface UpdateProductParams {
     cover?: string;
     /** Product type */
     productType?: string;
+    /** PC link */
+    pcLink?: string;
+    /** Mobile link */
+    mobileLink?: string;
+    /** WeChat mini program original ID */
+    wxMiniprogramOriginalId?: string;
+    /** WeChat mini program link */
+    wxMiniprogramLink?: string;
+    /** Mobile app link */
+    mobileAppLink?: string;
+    /** iOS link */
+    iosLink?: string;
+    /** Android link */
+    androidLink?: string;
+    /** Other platform link */
+    otherLink?: string;
+    /** Product features as a JSON array string */
+    features?: string;
     /** Original price */
     price?: number;
     /** Actual price */
     realPrice?: number;
+    /** Actual price type */
+    priceType?: string;
+    /** Custom actual price */
+    customPrice?: string;
+    /** Original price type */
+    originalPriceType?: string;
+    /** Custom original price */
+    customOriginalPrice?: string;
+    /** API typo preserved for compatibility with the source document */
+    customOrignalPrice?: string;
     /** Product tag IDs */
     tagIds?: number[];
+    /** Button label */
+    btnShow?: string;
+    /** Product description */
+    productDesc?: string;
+    /** Product detail */
+    productDetail?: string;
+    /** Extended product information as a JSON object string */
+    ext?: string;
 }
 /**
  * Parameters for deleting a product
@@ -467,23 +690,44 @@ export interface DeleteProductParams {
  */
 export interface ProductTag {
     /** Tag ID */
-    tagId: number;
+    id: number;
     /** Tag name */
-    tagName: string;
+    name: string;
+    /** Legacy alias for tag ID */
+    tagId?: number;
+    /** Legacy alias for tag name */
+    tagName?: string;
+    /** Tag type */
+    type?: string;
+    /** Number of linked products */
+    productCount?: number;
+    /** Created timestamp */
+    createTime?: string | number;
+    /** Updated timestamp */
+    updateTime?: string | number | null;
+}
+/**
+ * Parameters for listing product tags
+ */
+export interface ListProductTagsParams extends UserPaginationParams {
+    /** Channel ID */
+    channelId: string | number;
+    /** Keyword search */
+    keyword?: string;
 }
 /**
  * Response for listing product tags
  */
-export interface ListProductTagsResponse {
-    /** Tag list */
-    contents: ProductTag[];
+export interface ListProductTagsResponse extends UserPaginatedResponse<ProductTag> {
 }
 /**
  * Parameters for creating a product tag
  */
 export interface CreateProductTagParams {
     /** Tag name */
-    tagName: string;
+    name?: string;
+    /** Legacy alias for tag name */
+    tagName?: string;
 }
 /**
  * Response for creating a product tag
@@ -495,29 +739,85 @@ export interface CreateProductTagResponse extends ProductTag {
  */
 export interface UpdateProductTagParams {
     /** Tag ID */
-    tagId: number;
+    id?: number;
     /** Tag name */
-    tagName: string;
+    name?: string;
+    /** Legacy alias for tag ID */
+    tagId?: number;
+    /** Legacy alias for tag name */
+    tagName?: string;
 }
 /**
  * Parameters for deleting a product tag
  */
 export interface DeleteProductTagParams {
     /** Tag ID */
-    tagId: number;
+    id?: number;
+    /** Legacy alias for tag ID */
+    tagId?: number;
 }
 /**
  * Product order entity
  */
 export interface ProductOrder {
-    /** Order ID */
-    orderId: string;
-    /** Product ID */
-    productId: string;
+    /** Order number */
+    orderNo: string;
+    /** Channel ID */
+    channelId?: number;
+    /** Viewer ID */
+    viewerId?: string;
+    /** Viewer nickname */
+    viewerNickName?: string;
+    /** WeChat transaction ID */
+    transactionId?: string;
+    /** Order amount */
+    amount?: number;
+    /** Whether express delivery is enabled */
+    expressEnabled?: string;
     /** Status */
     status: string;
     /** Created timestamp */
     createTime?: number;
+    /** Paid timestamp */
+    payTime?: number;
+    /** Delivery timestamp */
+    deliveryTime?: number;
+    /** Finish timestamp */
+    finishTime?: number;
+    /** Shipping address */
+    addressExt?: ProductOrderAddress;
+    /** Ordered products */
+    products?: ProductOrderProduct[];
+}
+/**
+ * Product order address
+ */
+export interface ProductOrderAddress {
+    /** Mobile phone number */
+    mobile?: string;
+    /** Receiver name */
+    name?: string;
+    /** Province/city/area */
+    area?: string;
+    /** Detailed address */
+    address?: string;
+}
+/**
+ * Product item in an order
+ */
+export interface ProductOrderProduct {
+    /** Product snapshot ID */
+    productSnapshotId?: number;
+    /** Product amount */
+    amount?: number;
+    /** Quantity */
+    quantity?: number;
+    /** Total amount */
+    totalAmount?: number;
+    /** Product name */
+    productName?: string;
+    /** Product cover image */
+    productCover?: string;
 }
 /**
  * Parameters for listing product orders
@@ -533,33 +833,56 @@ export interface ListProductOrdersResponse extends UserPaginatedResponse<Product
  * Parameters for getting a product order
  */
 export interface GetProductOrderParams {
-    /** Order ID */
-    orderId: string;
+    /** Order number */
+    orderNo: string;
 }
 /**
  * Parameters for batch updating order status
  */
 export interface BatchUpdateOrderStatusParams {
-    /** Order IDs */
-    orderIds: string[];
+    /** Order numbers, maximum 1000 */
+    orderNos: string[];
     /** New status */
     status: string;
 }
+/**
+ * Failed order status update result
+ */
+export interface BatchUpdateOrderStatusFailOrder {
+    /** Order number */
+    orderNo: string;
+    /** Error code */
+    errCode: number;
+    /** Error message */
+    errMsg: string;
+}
+/**
+ * Response for batch updating order status
+ */
+export interface BatchUpdateOrderStatusResponse {
+    /** Successfully updated order numbers */
+    successOrderNos?: string[];
+    /** Failed order updates */
+    failOrderList?: BatchUpdateOrderStatusFailOrder[];
+}
 /**
  * Label entity
  */
 export interface Label {
     /** Label ID */
-    labelId: number;
+    id: string;
     /** Label name */
-    labelName: string;
+    name: string;
+}
+/**
+ * Parameters for listing labels
+ */
+export interface ListLabelsParams extends UserPaginationParams {
 }
 /**
  * Response for listing labels
  */
-export interface ListLabelsResponse {
-    /** Label list */
-    contents: Label[];
+export interface ListLabelsResponse extends UserPaginatedResponse<Label> {
 }
 /**
  * Parameters for creating a label
@@ -578,7 +901,7 @@ export interface CreateLabelResponse extends Label {
  */
 export interface UpdateLabelParams {
     /** Label ID */
-    labelId: number;
+    labelId: string;
     /** Label name */
     labelName: string;
 }
@@ -587,265 +910,468 @@ export interface UpdateLabelParams {
  */
 export interface DeleteLabelParams {
     /** Label ID */
-    labelId: number;
+    labelId: string;
 }
 /**
  * Parameters for adding channel label refs
  */
 export interface AddChannelLabelRefsParams {
-    /** Label ID */
-    labelId: number;
+    /** Label IDs */
+    labelIds: string[];
     /** Channel IDs */
-    channelIds: string[];
+    channelIds: Array<string | number>;
 }
 /**
  * Invite sale entity
  */
 export interface InviteSale {
-    /** Invite ID */
-    inviteId: number;
+    /** Invite sale user ID */
+    viewerUnionId: string;
     /** Nickname */
     nickname: string;
+    /** WeChat nickname */
+    wxNickName?: string | null;
+    /** WeChat avatar */
+    wxAvatar?: string | null;
+    /** Mobile phone number */
+    mobile?: string | null;
+    /** Source */
+    inviteSalesSource?: string;
+    /** Granted timestamp */
+    inviteSalesGrantedTime?: number;
+    /** Organization ID */
+    organizationId?: number;
+    /** Organization name */
+    organizationName?: string;
+    /** Whether the user is an invite sales admin */
+    inviteSalesAdmin?: string;
+    /** Bound customer count */
+    customerNum?: number;
+}
+/**
+ * Parameters for listing invite sales
+ */
+export interface ListInviteSalesParams {
+    /** Invite sale user ID, exact match */
+    viewerUnionId?: string;
+    /** Mobile phone number, exact match */
+    mobile?: string;
+    /** Nickname keyword */
+    keyword?: string;
+    /** Organization ID */
+    organizationId?: number;
+    /** Page size */
+    pageSize?: number;
+    /** Page number */
+    pageNumber?: number;
 }
 /**
  * Response for listing invite sales
  */
-export interface ListInviteSalesResponse {
-    /** Invite sales list */
-    contents: InviteSale[];
+export interface ListInviteSalesResponse extends UserPaginatedResponse<InviteSale> {
 }
 /**
  * Parameters for adding an invite sale
  */
 export interface AddInviteSaleParams {
-    /** Nickname */
-    nickname: string;
+    /** User IDs to add as invite sales, maximum 200 */
+    viewerUnionIds: string[];
+    /** Organization ID, defaults to headquarters when omitted */
+    organizationId?: number;
 }
 /**
  * Response for adding an invite sale
  */
-export interface AddInviteSaleResponse extends InviteSale {
-}
+export type AddInviteSaleResponse = void;
 /**
  * Parameters for updating an invite sale
  */
 export interface UpdateInviteSaleParams {
-    /** Invite ID */
-    inviteId: number;
-    /** Nickname */
-    nickname: string;
+    /** Invite sale user IDs to update, maximum 200 */
+    viewerUnionIds: string[];
+    /** Organization ID */
+    organizationId: number;
 }
+/**
+ * Response for updating invite sales
+ */
+export type UpdateInviteSaleResponse = void;
 /**
  * Parameters for removing an invite sale
  */
 export interface RemoveInviteSaleParams {
-    /** Invite ID */
-    inviteId: number;
+    /** Invite sale user IDs to remove, maximum 100 */
+    viewerUnionIds: string[];
+    /** New invite sale user ID to receive followed viewers */
+    newViewerUnionId?: string;
+    /** Legacy/example field accepted by the API documentation examples */
+    followViewersToNewViewerUnionId?: string;
 }
+/**
+ * Response for removing invite sales
+ */
+export type RemoveInviteSaleResponse = void;
 /**
  * Follow viewer entity
  */
 export interface FollowViewer {
+    /** Invite sale user ID */
+    inviteCustomerId: string;
+    /** Invite sale nickname */
+    inviteCustomerNickname?: string;
     /** Viewer ID */
     viewerId: string;
     /** Nickname */
     nickname: string;
+    /** Viewer phone number */
+    telephone?: string;
+    /** Follow status: 0=pending, 1=bound, 2=unbound */
+    followStatus?: number;
+    /** Follow timestamp */
+    followTime?: number;
 }
 /**
  * Parameters for listing follow viewers
  */
 export interface ListFollowViewersParams {
-    /** Invite ID */
-    inviteId: number;
+    /** Invite sale user ID, exact match */
+    inviteCustomerId?: string;
+    /** Invite sale nickname keyword */
+    inviteCustomerNickname?: string;
+    /** Viewer ID, exact match */
+    viewerId?: string;
+    /** Viewer nickname keyword */
+    username?: string;
+    /** Viewer phone number, exact match */
+    telephone?: string;
+    /** Follow statuses joined by commas, e.g. "0,1" */
+    followStatusList?: string;
+    /** Page size */
+    pageSize?: number;
+    /** Page number */
+    pageNumber?: number;
 }
 /**
  * Response for listing follow viewers
  */
-export interface ListFollowViewersResponse {
-    /** Follow viewers list */
-    contents: FollowViewer[];
+export interface ListFollowViewersResponse extends UserPaginatedResponse<FollowViewer> {
 }
 /**
  * Custom field entity
  */
 export interface CustomField {
     /** Field ID */
-    fieldId: number;
+    customFieldId: string;
     /** Field name */
-    fieldName: string;
+    customFieldName: string;
     /** Field type (text, select, etc.) */
-    fieldType: string;
+    customFieldType: string;
 }
 /**
  * Response for listing custom fields
  */
-export interface ListCustomFieldsResponse {
-    /** Custom fields list */
-    contents: CustomField[];
-}
+export type ListCustomFieldsResponse = CustomField[];
 /**
  * Parameters for adding a custom field
  */
 export interface AddCustomFieldParams {
-    /** Field name */
-    fieldName: string;
-    /** Field type */
-    fieldType: string;
+    /** Custom field ID, maximum 64 characters */
+    customFieldId: string;
+    /** Custom field name, maximum 64 characters */
+    customFieldName: string;
+    /** Custom field type, such as text, image, or link */
+    customFieldType: string;
 }
 /**
  * Response for adding a custom field
  */
-export interface AddCustomFieldResponse extends CustomField {
+export type AddCustomFieldResponse = void;
+/**
+ * Viewer custom field value
+ */
+export interface CustomFieldViewerValue {
+    /** Viewer ID */
+    viewerId: string;
+    /** Custom field ID */
+    customFieldId: string;
+    /** Custom field value */
+    customFieldValue: string;
 }
 /**
  * Parameters for adding a custom field value
  */
-export interface AddCustomFieldValueParams {
-    /** Field ID */
-    fieldId: number;
-    /** Viewer union ID */
-    viewerUnionId: string;
-    /** Field value */
-    value: string;
-}
+export type AddCustomFieldValueParams = CustomFieldViewerValue[];
+/**
+ * Response for adding custom field viewer values
+ */
+export type AddCustomFieldValueResponse = void;
 /**
  * Donate template settings
  */
 export interface DonateTemplate {
-    /** Whether enabled */
-    enabled: boolean;
-    /** Minimum amount */
-    minAmount?: number;
-    /** Maximum amount */
-    maxAmount?: number;
+    /** Cash donate switch */
+    donateCashEnabled?: UserSwitchValue;
+    /** Cash donate settings */
+    cashDonate?: TemplateCashDonate;
+    /** Gift donate switch */
+    donateGiftEnabled?: UserSwitchValue;
+    /** Gift donate settings */
+    giftDonate?: TemplateGiftDonate;
+}
+/**
+ * Cash donate settings
+ */
+export interface TemplateCashDonate {
+    /** Fixed donate amounts */
+    cashs?: number[];
+    /** Minimum custom donate amount */
+    cashMin?: number;
+}
+/**
+ * Gift donate settings
+ */
+export interface TemplateGiftDonate {
+    /** Pay way */
+    payWay?: 'CASH' | 'POINT' | string;
+    /** Cash unit */
+    cashUnit?: string | null;
+    /** Point unit */
+    pointUnit?: string | null;
+    /** Cash pay gifts */
+    cashPays?: GiftDonate[];
+    /** Point pay gifts */
+    pointPays?: GiftDonate[];
+}
+/**
+ * Gift donate item
+ */
+export interface GiftDonate {
+    /** Gift name */
+    name?: string;
+    /** Gift image URL */
+    img: string;
+    /** Dynamic thumbnail URL */
+    dynamicImg?: string | null;
+    /** Dynamic file URL */
+    dynamicFile?: string | null;
+    /** Gift price */
+    price?: number;
+    /** Gift sequence */
+    sequence?: number;
+    /** Gift switch */
+    enabled?: UserSwitchValue;
+    /** Gift unit */
+    unit?: string | null;
+    /** Image type */
+    imgType?: 'STATIC' | 'DYNAMIC' | string | null;
 }
 /**
  * Parameters for updating donate template
  */
 export interface UpdateDonateTemplateParams {
-    /** Whether enabled */
-    enabled: boolean;
-    /** Minimum amount */
-    minAmount?: number;
-    /** Maximum amount */
-    maxAmount?: number;
+    /** Gift donate switch */
+    donateGiftEnabled: UserSwitchValue;
+    /** Gift donate settings */
+    giftDonate?: TemplateGiftDonate;
 }
 /**
  * Marquee template settings
  */
 export interface MarqueeTemplate {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
+    /** Content protection switch */
+    enable?: UserSwitchValue;
+    /** Content protection type */
+    antiRecordType?: string;
+    /** Content protection display model */
+    modelType?: string;
     /** Content */
     content?: string;
+    /** Opacity */
+    opacity?: number | string;
     /** Speed */
     speed?: number;
+    fontSize?: string;
+    fontColor?: string;
+    showMode?: string;
+    doubleEnabled?: UserSwitchValue;
+    autoZoomEnabled?: UserSwitchValue;
 }
 /**
  * Parameters for updating marquee template
  */
 export interface UpdateMarqueeTemplateParams {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
+    /** Content protection switch */
+    enable?: UserSwitchValue;
+    /** Content protection type */
+    antiRecordType?: string;
+    /** Content protection display model */
+    modelType?: string;
     /** Content */
     content?: string;
+    /** Opacity */
+    opacity?: number | string;
     /** Speed */
     speed?: number;
+    fontSize?: string;
+    fontColor?: string;
+    showMode?: string;
+    doubleEnabled?: UserSwitchValue;
+    autoZoomEnabled?: UserSwitchValue;
 }
 /**
  * Role config template settings
  */
 export interface RoleConfigTemplate {
     /** Roles list */
-    roles: string[];
+    roles?: string[];
+    /** Teacher role config */
+    teacherConfig?: Record<string, unknown>;
+    /** Guest role config */
+    guestConfig?: Record<string, unknown>;
 }
 /**
  * Parameters for updating role config template
  */
 export interface UpdateRoleConfigTemplateParams {
     /** Roles list */
-    roles: string[];
+    roles?: string[];
+    /** Teacher role config */
+    teacherConfig?: Record<string, unknown>;
+    /** Guest role config */
+    guestConfig?: Record<string, unknown>;
 }
 /**
  * Playback setting
  */
 export interface PlaybackSetting {
-    /** Auto play */
-    autoPlay?: boolean;
-    /** Quality */
-    quality?: string;
+    playbackEnabled?: UserSwitchValue;
+    type?: 'single' | 'list' | string;
+    origin?: 'record' | 'playback' | 'vod' | string;
+    sectionEnabled?: UserSwitchValue;
+    chatPlaybackEnabled?: UserSwitchValue;
+    playbackMultiplierEnabled?: UserSwitchValue;
+    playbackProgressBarEnabled?: UserSwitchValue;
+    playbackProgressBarOperationType?: 'drag' | 'prohibitDrag' | 'dragHistoryOnly' | string;
+    showPlayButtonEnabled?: UserSwitchValue;
+    productPlaybackEnabled?: UserSwitchValue;
+    questionnairePlaybackEnabled?: UserSwitchValue;
+    qaPlaybackEnabled?: UserSwitchValue;
+    cardPushPlaybackEnabled?: UserSwitchValue;
+    checkInPlaybackEnabled?: UserSwitchValue;
 }
 /**
  * Parameters for updating playback setting
  */
 export interface UpdatePlaybackSettingParams {
-    /** Auto play */
-    autoPlay?: boolean;
-    /** Quality */
-    quality?: string;
+    playbackEnabled?: UserSwitchValue;
+    type?: 'single' | 'list' | string;
+    origin?: 'record' | 'playback' | 'vod' | string;
+    sectionEnabled?: UserSwitchValue;
+    playbackMultiplierEnabled?: UserSwitchValue;
+    playbackProgressBarEnabled?: UserSwitchValue;
+    playbackProgressBarOperationType?: 'drag' | 'prohibitDrag' | 'dragHistoryOnly' | string;
+    showPlayButtonEnabled?: UserSwitchValue;
+    chatPlaybackEnabled?: UserSwitchValue;
+    productPlaybackEnabled?: UserSwitchValue;
+    questionnairePlaybackEnabled?: UserSwitchValue;
+    qaPlaybackEnabled?: UserSwitchValue;
+    cardPushPlaybackEnabled?: UserSwitchValue;
+    checkInPlaybackEnabled?: UserSwitchValue;
 }
 /**
  * Audio moderation setting
  */
 export interface AudioModerationSetting {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
     /** Moderation level */
     level?: string;
+    moderationEnabled?: UserSwitchValue;
+    moderationStrategy?: string;
+    badwordEnabled?: UserSwitchValue;
+    illegalNotify?: Record<string, unknown>;
 }
 /**
  * Parameters for updating audio moderation setting
  */
 export interface UpdateAudioModerationSettingParams {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
     /** Moderation level */
     level?: string;
+    moderationEnabled?: UserSwitchValue;
+    moderationStrategy?: string;
+    badwordEnabled?: UserSwitchValue;
+    illegalNotify?: Record<string, unknown>;
 }
 /**
  * Video moderation setting
  */
 export interface VideoModerationSetting {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
     /** Moderation level */
     level?: string;
+    moderationEnabled?: UserSwitchValue;
+    moderationStrategy?: string;
+    imageFrequency?: number;
+    illegalNotify?: Record<string, unknown>;
 }
 /**
  * Parameters for updating video moderation setting
  */
 export interface UpdateVideoModerationSettingParams {
     /** Whether enabled */
-    enabled: boolean;
+    enabled?: boolean;
     /** Moderation level */
     level?: string;
+    moderationEnabled?: UserSwitchValue;
+    moderationStrategy?: string;
+    imageFrequency?: number;
+    illegalNotify?: Record<string, unknown>;
 }
 /**
  * Callback settings
  */
 export interface CallbackSettings {
-    streamCallbackUrl?: string;
-    playbackCallbackUrl?: string;
     recordCallbackUrl?: string;
-    rebirthVodCallbackUrl?: string;
-    rebirthVodCallbackEnabled?: 'Y' | 'N';
-    /** Compatibility aliases used by older SDK consumers. */
-    url?: string;
-    enabled?: boolean;
-    [key: string]: unknown;
+    recordFileCallBackType?: 'all' | 'last' | string;
+    recordCallbackVideoType?: 'm3u8' | 'mp4' | 'm3u8,mp4' | string;
+    playbackCallbackUrl?: string;
+    rebirthVodCallbackEnabled?: UserSwitchValue;
+    pptRecordCallbackUrl?: string;
+    streamCallbackUrl?: string;
+    channelBasicUpdateCallbackUrl?: string;
+    liveScanCallbackUrl?: string;
+    chatUserStatusCallbackUrl?: string;
+    interactionCallbackUrl?: string;
+    playbackCacheCallbackUrl?: string;
+    playbackSettingCallbackUrl?: string;
+    aiPptVideoCallbackUrl?: string;
+    liveViolationCutoffCallbackUrl?: string;
+    liveStatsCallbackUrl?: string;
 }
 /**
  * Parameters for updating callback settings
  */
 export interface UpdateCallbackParams {
-    streamCallbackUrl?: string;
-    playbackCallbackUrl?: string;
     recordCallbackUrl?: string;
-    rebirthVodCallbackUrl?: string;
-    rebirthVodCallbackEnabled?: 'Y' | 'N';
-    /** Compatibility aliases used by older SDK consumers. */
-    url?: string;
-    enabled?: boolean;
+    recordFileCallBackType?: 'all' | 'last' | string;
+    recordCallbackVideoType?: 'm3u8' | 'mp4' | 'm3u8,mp4' | string;
+    playbackCallbackUrl?: string;
+    rebirthVodCallbackEnabled?: UserSwitchValue;
+    pptRecordCallbackUrl?: string;
+    streamCallbackUrl?: string;
+    channelBasicUpdateCallbackUrl?: string;
+    liveScanCallbackUrl?: string;
+    playbackCacheCallbackUrl?: string;
+    aiPptVideoCallbackUrl?: string;
+    liveViolationCutoffCallbackUrl?: string;
+    liveStatsCallbackUrl?: string;
 }
 /**
  * Global switch settings
@@ -869,145 +1395,228 @@ export interface UpdateGlobalSwitchParams {
  * Global footer settings
  */
 export interface GlobalFooterSettings {
-    /** Whether enabled */
-    enabled?: boolean;
-    /** Footer content */
-    content?: string;
+    /** PolyV user ID */
+    userId?: string;
+    /** Footer switch */
+    showFooterEnabled?: UserSwitchValue;
+    /** Footer text */
+    footerText?: string;
+    /** Footer link protocol */
+    footTextLinkProtocol?: 'http://' | 'https://' | string;
+    /** Footer link URL without protocol */
+    footTextLinkUrl?: string;
 }
 /**
  * Parameters for updating global footer settings
  */
 export interface UpdateGlobalFooterParams {
-    /** Whether enabled */
-    enabled?: boolean;
-    /** Footer content */
-    content?: string;
+    showFooterEnabled?: UserSwitchValue;
+    footerText?: string;
+    footTextLinkProtocol?: 'http://' | 'https://' | string;
+    footTextLinkUrl?: string;
 }
 /**
  * PV show enable settings
  */
 export interface PvShowEnableSettings {
-    /** Whether enabled */
-    enabled?: boolean;
+    /** PV show switch */
+    enabled?: UserSwitchValue;
 }
 /**
  * Parameters for updating PV show enable settings
  */
 export interface UpdatePvShowEnableParams {
-    /** Whether enabled */
-    enabled?: boolean;
+    /** PV show switch */
+    enabled: UserSwitchValue;
 }
 /**
  * Parameters for getting mic duration
  */
 export interface GetMicDurationParams {
-    /** Channel ID */
-    channelId: string;
-    /** Session ID */
-    sessionId: string;
+    /** Start timestamp in milliseconds */
+    startTime?: number;
+    /** End timestamp in milliseconds */
+    endTime?: number;
 }
 /**
  * Mic duration response
  */
 export interface MicDurationResponse {
-    /** Duration */
-    duration: number;
-    /** Unit */
-    unit?: string;
+    /** User ID */
+    userId: string;
+    /** Used mic minutes */
+    history: number;
 }
 /**
  * MR concurrency detail response
  */
 export interface MrConcurrencyDetailResponse {
-    /** Current concurrency */
-    current: number;
-    /** Max concurrency */
-    max: number;
-    /** Peak concurrency */
-    peak: number;
+    /** Total MR concurrency */
+    mrLiveConcurrency: number;
+    /** Currently used concurrency */
+    usedCount: number;
+    /** Residual concurrency */
+    residualConcurrency: number;
+    /** Channel IDs occupying concurrency */
+    channelIds: string[];
 }
 /**
  * Parameters for sending SMS
  */
 export interface SendSmsParams {
+    /** Mobile numbers */
+    phoneNumbers?: Array<string | number>;
+    /** SMS template parameter names */
+    templateParamNames?: string[];
+    /** SMS template parameter values */
+    templateParamValues?: Array<string | number>;
     /** Mobile number */
-    mobile: string;
+    mobile?: string;
     /** SMS content */
-    content: string;
+    content?: string;
 }
 /**
  * Parameters for getting bill use detail list
  */
 export interface GetBillUseDetailListParams {
+    /** Billing item category */
+    itemCategory: string;
     /** Start date (YYYY-MM-DD) */
     startDate: string;
     /** End date (YYYY-MM-DD) */
     endDate: string;
+    /** Channel ID */
+    channelId?: string;
+    /** Page number */
+    pageNumber?: number;
+    /** Page size */
+    pageSize?: number;
 }
 /**
  * Bill use detail item
  */
 export interface BillUseDetailItem {
-    /** Bill ID */
-    billId: number;
-    /** Type */
-    type: string;
-    /** Amount */
-    amount: number;
-    /** Created timestamp */
-    createTime: number;
+    channelId?: number;
+    consumeUnit?: string;
+    consumed?: number;
+    endTime?: string;
+    itemCategory?: string;
+    itemName?: string;
+    production?: string;
+    recordId?: string;
+    remark?: string;
+    sessionId?: string;
+    avgBitRate?: string;
+    startTime?: string;
+    statDate?: string;
 }
 /**
  * Response for getting bill use detail list
  */
 export interface GetBillUseDetailListResponse {
-    /** Bill use details list */
+    pageNumber: number;
+    pageSize: number;
+    totalPages: number;
+    totalItems: number;
     contents: BillUseDetailItem[];
 }
 /**
- * Parameters for viewer lottery win
+ * Parameters for listing viewer lottery wins
  */
-export interface ViewerLotteryWinParams {
-    /** Lottery ID */
-    lotteryId: number;
+export interface ViewerLotteryWinParams extends UserPaginationParams {
     /** Viewer ID */
     viewerId: string;
 }
 /**
- * Viewer lottery win response
+ * Viewer lottery win item
  */
-export interface ViewerLotteryWinResponse {
+export interface ViewerLotteryWinItem {
+    /** Channel ID */
+    channelId?: number;
+    /** Channel name */
+    channelName?: string;
+    /** Session ID */
+    sessionId?: string;
+    /** Receive info JSON string */
+    collectInfo?: string;
+    /** Accept type */
+    acceptType?: string;
     /** Lottery ID */
-    lotteryId: number;
-    /** Prize */
+    lotteryId?: string;
+    /** Prize name */
     prize?: string;
-    /** Status */
-    status?: string;
+    /** Whether prize was received */
+    received?: boolean;
+    /** Winner code */
+    winnerCode?: string;
+    /** Activity name */
+    activityName?: string;
+    /** Win timestamp */
+    createdTime?: number;
+    /** Last modified timestamp */
+    lastModified?: number;
+    /** Whether receive info collection is enabled */
+    receiveEnabled?: boolean;
+}
+/**
+ * Response for listing viewer lottery wins
+ */
+export interface ViewerLotteryWinResponse extends UserPaginatedResponse<ViewerLotteryWinItem> {
 }
 /**
  * Parameters for getting watch log detail
  */
 export interface GetWatchLogDetailParams {
-    /** Log ID */
-    logId: number;
+    /** Viewer ID */
+    viewerId: string;
+    /** Start date (YYYY-MM-DD) */
+    startDate?: string;
+    /** End date (YYYY-MM-DD) */
+    endDate?: string;
+    /** Page number */
+    pageNumber?: number;
+    /** Page size */
+    pageSize?: number;
 }
 /**
- * Watch log detail response
+ * Watch log detail item
  */
-export interface WatchLogDetailResponse {
-    /** Log ID */
-    logId: number;
+export interface WatchLogDetailItem {
+    area?: string;
+    browser?: string;
+    ip?: string;
+    nick?: string;
+    playDuration?: string;
+    channelId?: number;
+    sessionId?: string;
+    startTime?: string | number;
+    viewType?: string;
     /** Viewer ID */
     viewerId: string;
-    /** Duration */
-    duration: number;
-    /** Start time */
-    startTime: number;
+    param4?: string;
+    param5?: string;
+}
+/**
+ * Watch log detail response
+ */
+export interface WatchLogDetailResponse extends UserPaginatedResponse<WatchLogDetailItem> {
 }
 /**
  * Parameters for getting watch log list
  */
-export interface GetWatchLogListParams extends UserPaginationParams {
+export interface GetWatchLogListParams {
+    /** Start date (YYYY-MM-DD) */
+    startDate?: string;
+    /** End date (YYYY-MM-DD) */
+    endDate?: string;
+    /** Page number */
+    pageNumber?: number;
+    /** Page size */
+    pageSize?: number;
+    /** Viewer ID */
+    viewerId?: string;
+    /** Channel ID */
+    channelId?: number;
 }
 /**
  * Global channel settings response
@@ -1055,14 +1664,14 @@ export interface UpdateGlobalChannelSettingsParams {
  * Watch log item
  */
 export interface WatchLogItem {
-    /** Log ID */
-    logId: number;
+    avgDuration?: string;
+    nick?: string;
+    totalDuration?: string;
+    viewCount?: number;
     /** Viewer ID */
     viewerId: string;
-    /** Channel ID */
-    channelId: string;
-    /** Duration */
-    duration: number;
+    param4?: string;
+    param5?: string;
 }
 /**
  * Response for getting watch log list