@singcl/ad-execute-manager 2.0.11 → 2.0.13

package/dist/ad-interstitial/src/InterstitialAdFather.d.ts

@@ -27,12 +27,12 @@ declare class InterstitialAdFather {
      * 使用管理器执行广告
      * @param {Object} adInstance 广告实例
      * @param {Object} ctx 上下文对象，用于传递数据和状态
-     * @param {Object} ctx.options 广告执行选项
-     * @param {Object} ctx.collection 回调集合
+     * @param {import('./typings/ad.js').IAdOptions} ctx.options 广告执行选项
+     * @param {CallbackCollection} ctx.collection 回调集合
      */
     static executeWithManager(adInstance: any, ctx: {
-        options: any;
-        collection: any;
+        options: import("./typings/ad.js").IAdOptions;
+        collection: CallbackCollection;
     }): Promise<import("@ad-execute-manager/core/dist/AdExecuteManager.js").ITaskResult & {
         [key: string]: any;
     }>;
@@ -61,11 +61,11 @@ declare class InterstitialAdFather {
     /**
      * 初始化
      * 子类可以选择覆盖此方法，或使用默认实现
-     * @param {IRewordAdConfig} params
+     * @param {import('./typings/ad.js').IAdOptions} params
      * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
      * @returns {this} 当前实例
      */
-    initialize(params: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
+    initialize(params: import("./typings/ad.js").IAdOptions, callback?: (v: IRewardedVideoAd) => void): this;
     initialized(): boolean;
     /**
      * 执行广告展示
@@ -84,11 +84,11 @@ declare class InterstitialAdFather {
     /**
      * 确保广告按顺序执行
      * @param {Object} [ctx] 上下文对象，用于传递数据和状态
-     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
      * @param {CallbackCollection} [ctx.collection] 回调集合
      */
     addExecuteManager(ctx?: {
-        options?: IRewordAdConfig;
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: CallbackCollection;
     }): Promise<import("@ad-execute-manager/core/dist/AdExecuteManager.js").ITaskResult & {
         [key: string]: any;

package/dist/ad-interstitial/src/InterstitialAdNovel.d.ts

@@ -176,11 +176,11 @@ declare class InterstitialAdNovel extends InterstitialAdFather {
     /**
      * 初始化
      * 子类可以选择覆盖此方法，或使用默认实现
-     * @param {IRewordAdConfig} args
+     * @param {import('./typings/ad.js').IAdOptions} args
      * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
      * @returns {this} 当前实例
      */
-    initialize(args: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
+    initialize(args: import("./typings/ad.js").IAdOptions, callback?: (v: IRewardedVideoAd) => void): this;
     _initAdLister(): void;
     /**
      * @param {object} args
@@ -300,18 +300,31 @@ declare class InterstitialAdNovel extends InterstitialAdFather {
         ad_is_completed: number;
     }): any;
     get rewardAd(): any;
+    /**
+     * 确保广告按顺序执行
+     * @override
+     * @param {Object} [ctx] 上下文对象，用于传递数据和状态
+     * @param {import('.  /typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').CallbackCollection} [ctx.collection] 回调集合
+     */
+    override addExecuteManager(ctx?: {
+        options?: any;
+        collection?: import("./typings/ad.js").CallbackCollection;
+    }): Promise<import("@ad-execute-manager/core/dist/AdExecuteManager.js").ITaskResult & {
+        [key: string]: any;
+    }>;
     /**
      * ATTENTION: 应用一旦进入后台，90%概率.show() 方法的.then() 回调将不会被执行, .catch() 回调也不会被执行。
      * 此时将进入超时处理逻辑
      * @override
      * @param {object} [ctx] 广告执行上下文
-     * @param {import('./typings/ad.js').IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
      * @param {import('./typings/ad.js').CallbackCollection} [ctx.collection] 回调集合
      * @param {Function} next 执行下一个任务的回调函数，手动调用以继续执行流程
      * @returns {Promise.<object | Undefined>}
      */
     override ad(ctx?: {
-        options?: import("./typings/ad.js").IRewordAdConfig;
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: import("./typings/ad.js").CallbackCollection;
     }, next?: Function): Promise<object | undefined>;
     /**

package/dist/ad-interstitial/src/typings/ad.d.ts

@@ -22,18 +22,12 @@ export type IRewordAdConfig = {
      * 额外观看广告的次数，合法的数据范围为 1～4，multiton 为 true 时必填
      */
     multitonRewardTimes?: number | undefined;
+};
+export type IRewordAdOther = {
     /**
-     * 场景值 - 自用参数，非tt API要求的参数
-     */
-    scene?: number | undefined;
-    /**
-     * 广告超时时间 单位ms - 自用参数，非tt API要求的参数
-     */
-    timeout?: number | undefined;
-    /**
-     * 重试次数 - 自用参数 ，非tt API要求的参数
+     * 是否需要在超时情况下结束广告 - 自用参数，非tt API要求的参数
      */
-    retry: number;
+    needEndOnTimeout?: boolean | undefined;
     /**
      * 是否绑定永远的错误事件 - 自用参数，非tt API要求的参数
      */
@@ -50,10 +44,6 @@ export type InterstitialAdConfig = {
     scene?: number | undefined;
 };
 export type IExeCallbackArgs = {
-    /**
-     * 广告执行场景
-     */
-    scene: number;
     /**
      * 是否看完
      */
@@ -63,40 +53,77 @@ export type IExeCallbackArgs = {
      */
     count: number;
     /**
-     * 剩余观看次数
+     * 广告场景
+     */
+    scene?: string;
+    /**
+     * 广告类型 1:激励视频 2:插屏
+     */
+    adTypeR?: 1 | 2;
+    /**
+     * 广告结束类型
      */
-    remain?: number;
+    end_type?: "finished" | "halfway";
 };
 export type CallbackCollection = {
     /**
      * 每次外部回调
      */
-    always?: (ctx?: IExeCallbackArgs) => void;
+    always?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 完整看完广告外部回调 不管一个还是几个
      */
-    finished?: (ctx?: IExeCallbackArgs) => void;
+    finished?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 半途退出广告外部回调
      */
-    halfway?: (ctx?: IExeCallbackArgs) => void;
+    halfway?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 取消广告外部回调
      */
-    cancel?: (ctx?: IExeCallbackArgs) => void;
+    cancel?: () => void;
     /**
      * 展示广告外部回调
      */
-    before?: (ctx?: IExeCallbackArgs) => void;
+    before?: (ctx?: {
+        scene: number;
+    }) => void;
     /**
      * 展示广告成功外部回调
      */
-    success?: (ctx?: IExeCallbackArgs) => void;
+    success?: (ctx?: {
+        scene: number;
+    }) => void;
+    /**
+     * 计时回调 scene: 广告场景 frequency: 广告展示前间隔时间 time: 广告展示时前间戳
+     */
+    prelude?: (ctx?: {
+        scene: number;
+        frequency: number;
+        time: number;
+    }) => void;
+};
+export type IAdOptionsOther = {
+    /**
+     * 场景值 - 自用参数，非tt API要求的参数
+     */
+    scene?: number | undefined;
+    /**
+     * 广告超时时间 单位ms - 自用参数，非tt API要求的参数
+     */
+    timeout?: number | undefined;
     /**
-     * 计时回调
+     * 重试次数 - 自用参数 ，非tt API要求的参数
      */
-    prelude?: (ctx?: unknown) => void;
+    retry: number;
 };
+export type IAdOptions = IRewordAdConfig & IRewordAdOther & IAdOptionsOther;
 export type RecoveredInfo = {
     /**
      * 恢复重试次数
@@ -111,48 +138,46 @@ export type RecoveredInfo = {
      */
     message: string;
 };
-export type ICallbackArgs = {
-    /**
-     * 广告执行场景
-     */
-    scene: number;
-    /**
-     * 是否看完
-     */
-    isEnded: boolean;
-    /**
-     * 完整观看次数
-     */
-    count: number;
+export type IApiError = {
     /**
-     * 剩余观看次数
+     * 错误信息
      */
-    remain?: number;
+    errMsg?: string;
     /**
-     * 执行下一个任务的回调函数，手动调用以继续执行流程[end]
+     * 错误码
      */
-    end?: () => void;
+    errorCode?: number;
     /**
-     * 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
+     * 错误信息
      */
-    circle?: (args: {
-        ignoreRemain: boolean;
-        scene: number;
-    }) => void;
+    message?: string;
 };
+export type ICallbackArgs = IExeCallbackArgs;
 export type IConnection = {
     /**
      * 广告中途退出回调
      */
-    onHalfway?: (args: ICallbackArgs) => void;
+    onHalfway?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告展示回调
      */
-    onShow?: (args: ICallbackArgs) => void;
+    onShow?: (args: {
+        scene: number;
+    }) => void;
+    /**
+     * 广告执行成功回调
+     */
+    onFinish?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告执行成功回调
      */
-    onFinish?: (args: ICallbackArgs) => void;
+    onAlways?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告执行失败回调
      */
@@ -163,14 +188,6 @@ export type IConstructArgs = {
      * 初始化标识
      */
     sign: string;
-    /**
-     * 是否开启日志
-     */
-    log?: boolean | undefined;
-    /**
-     * 重试次数
-     */
-    retry: number;
     /**
      * 是否保留tt激励视频广告实例
      */

package/dist/ad-reward/src/RewardAdFather.d.ts

@@ -4,6 +4,8 @@ export type CallbackCollection = import("./typings/ad.js").CallbackCollection;
 export type RecoveredInfo = import("./typings/ad.js").RecoveredInfo;
 export type IConstructArgs = import("./typings/ad.js").IConstructArgs;
 export type RewardedVideoAd = import("./typings/create-rewarded-video-ad.js").RewardedVideoAd;
+export type ITaskResult = import("./typings/ad.js").ITaskResult;
+export type ITaskResultGeneric<T extends unknown> = ITaskResult & T;
 export type IRewardedVideoAd = {
     /**
      * 显示激励视频广告
@@ -22,18 +24,18 @@ declare class RewardAdFather {
      */
     static buildArgs(args: IRewordAdConfig): void;
     /**
+     * @template {object} T
      * 使用管理器执行广告
      * @param {Object} adInstance 广告实例
      * @param {Object} ctx 上下文对象，用于传递数据和状态
-     * @param {Object} ctx.options 广告执行选项
-     * @param {Object} ctx.collection 回调集合
+     * @param {import('./typings/ad.js').IAdOptions} ctx.options 广告执行选项
+     * @param {CallbackCollection} ctx.collection 回调集合
+     * @returns {Promise<ITaskResultGeneric<T> | undefined>} 广告执行结果的Promise
      */
-    static executeWithManager(adInstance: any, ctx: {
-        options: any;
-        collection: any;
-    }): Promise<import("@ad-execute-manager/core/dist/AdExecuteManager.js").ITaskResult & {
-        [key: string]: any;
-    }>;
+    static executeWithManager<T extends unknown>(adInstance: any, ctx: {
+        options: import("./typings/ad.js").IAdOptions;
+        collection: CallbackCollection;
+    }): Promise<ITaskResultGeneric<T> | undefined>;
     /**
      * @param {IConstructArgs} args
      */
@@ -61,11 +63,11 @@ declare class RewardAdFather {
     /**
      * 初始化
      * 子类可以选择覆盖此方法，或使用默认实现
-     * @param {IRewordAdConfig} params
+     * @param {import('./typings/ad.js').IAdOptions} params
      * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
      * @returns {this} 当前实例
      */
-    initialize(params: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
+    initialize(params: import("./typings/ad.js").IAdOptions, callback?: (v: IRewardedVideoAd) => void): this;
     initialized(): boolean;
     /**
      * 激励视频展示失败时始终执行的一个方法
@@ -87,7 +89,7 @@ declare class RewardAdFather {
      * 执行广告展示
      * @abstract
      * @param {Object} [ctx] 上下文对象，用于传递数据和状态
-     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
      * @param {CallbackCollection} [ctx.collection] 回调集合
      * @param {RecoveredInfo} [ctx.recovered] 恢复重试信息
      * @param {Function} next 执行下一个任务的回调函数，在洋葱模型中手动调用以继续执行流程
@@ -95,22 +97,22 @@ declare class RewardAdFather {
      * @throws {Error} 子类必须实现此方法
      */
     ad(ctx?: {
-        options?: IRewordAdConfig;
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: CallbackCollection;
         recovered?: RecoveredInfo;
     }, next?: Function): Promise<unknown>;
     /**
+     * @template {object} T
      * 确保广告按顺序执行
      * @param {Object} [ctx] 上下文对象，用于传递数据和状态
-     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
      * @param {CallbackCollection} [ctx.collection] 回调集合
+     * @returns {Promise<ITaskResultGeneric<T> | undefined>} 广告执行结果的Promise
      */
-    addExecuteManager(ctx?: {
-        options?: IRewordAdConfig;
+    addExecuteManager<T extends unknown>(ctx?: {
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: CallbackCollection;
-    }): Promise<import("@ad-execute-manager/core/dist/AdExecuteManager.js").ITaskResult & {
-        [key: string]: any;
-    }>;
+    }): Promise<ITaskResultGeneric<T> | undefined>;
     destroy(): void;
     /**
      * 清理广告实例

package/dist/ad-reward/src/RewardAdNovel.d.ts

@@ -1,78 +1,6 @@
 export default RewardAdNovel;
 export type IRewordAdConfig = import("./typings/ad.js").IRewordAdConfig;
-export type ICallbackArgs = {
-    /**
-     * 广告执行场景
-     */
-    scene: number;
-    /**
-     * 是否看完
-     */
-    isEnded: boolean;
-    /**
-     * 完整观看次数
-     */
-    count: number;
-    /**
-     * 执行下一个任务的回调函数，手动调用以继续执行流程[end]
-     */
-    end?: () => void;
-    /**
-     * 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
-     */
-    circle?: (args: {
-        ignoreRemain: boolean;
-        scene: number;
-    }) => void;
-};
-export type IConnection = {
-    /**
-     * 广告中途退出回调
-     */
-    onHalfway?: (args: ICallbackArgs) => void;
-    /**
-     * 广告展示回调
-     */
-    onShow?: (args: ICallbackArgs) => void;
-    /**
-     * 广告执行成功回调
-     */
-    onFinish?: (args: ICallbackArgs) => void;
-    /**
-     * 广告执行成功回调
-     */
-    onAlways?: (args: ICallbackArgs) => void;
-    /**
-     * 广告执行失败回调
-     */
-    onError?: (e: unknown) => void;
-};
-export type IConstructArgs = {
-    /**
-     * 初始化标识
-     */
-    sign?: string;
-    /**
-     * 是否开启日志
-     */
-    log?: boolean;
-    /**
-     * 是否保留tt激励视频广告实例
-     */
-    preserveOnEnd?: boolean;
-    /**
-     * 是否需要在超时情况下结束广告
-     */
-    needEndOnTimeout?: boolean;
-    /**
-     * 激励视频参数 (可选)
-     */
-    adConfig?: IRewordAdConfig | undefined;
-    /**
-     * 回调集合
-     */
-    collection?: IConnection | undefined;
-};
+export type IConstructArgs = import("./typings/ad.js").IConstructArgs;
 export type ICloseArgs = {
     /**
      * 是否看完
@@ -93,30 +21,7 @@ export type IRewardedVideoAd = {
  * @typedef {import('./typings/ad.js').IRewordAdConfig} IRewordAdConfig
  */
 /**
- * @typedef ICallbackArgs
- * @property {number} scene 广告执行场景
- * @property {boolean} isEnded 是否看完
- * @property {number} count 完整观看次数
- * @property {() => void} [end] 执行下一个任务的回调函数，手动调用以继续执行流程[end]
- * @property {(args: {ignoreRemain: boolean, scene: number}) => void} [circle] 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
- *
- */
-/**
- * @typedef IConnection
- * @property {(args: ICallbackArgs) => void} [onHalfway] 广告中途退出回调
- * @property {(args: ICallbackArgs) => void} [onShow] 广告展示回调
- * @property {(args: ICallbackArgs) => void} [onFinish] 广告执行成功回调
- * @property {(args: ICallbackArgs) => void} [onAlways] 广告执行成功回调
- * @property {(e:unknown) => void} [onError] 广告执行失败回调
- */
-/**
- * @typedef IConstructArgs
- * @property {string} [sign] 初始化标识
- * @property {boolean} [log] 是否开启日志
- * @property {boolean} [preserveOnEnd] 是否保留tt激励视频广告实例
- * @property {boolean} [needEndOnTimeout] 是否需要在超时情况下结束广告
- * @property {IRewordAdConfig=} [adConfig] 激励视频参数 (可选)
- * @property {IConnection=} [collection] 回调集合
+ * @typedef {import('./typings/ad.js').IConstructArgs} IConstructArgs
  */
 /**
  * @typedef ICloseArgs
@@ -145,11 +50,6 @@ declare class RewardAdNovel extends RewardAdFather {
      * @returns  {RewardAdNovel}
      */
     static "new"(args: IConstructArgs): RewardAdNovel;
-    /**
-     * @param {IConstructArgs} args
-     *
-     */
-    constructor(args: IConstructArgs);
     _onHalfway: any;
     _onShow: any;
     _onFinish: any;
@@ -169,6 +69,7 @@ declare class RewardAdNovel extends RewardAdFather {
     _adSpeedCloseTimer: any;
     _adSpeedCloseTime: number;
     _needEndOnTimeout: boolean;
+    _lookUpRemainOnError: boolean;
     /** @deprecated TODO 移除 */
     _needSpeedEndOnTimeout: boolean;
     bindAdCloseLister: any;
@@ -180,11 +81,11 @@ declare class RewardAdNovel extends RewardAdFather {
     /**
      * 初始化
      * 子类可以选择覆盖此方法，或使用默认实现
-     * @param {IRewordAdConfig} args
+     * @param {import('./typings/ad.js').IAdOptions} args
      * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
      * @returns {this} 当前实例
      */
-    initialize(args: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
+    initialize(args: import("./typings/ad.js").IAdOptions, callback?: (v: IRewardedVideoAd) => void): this;
     _initAdLister(): void;
     /**
      * @param {object} args
@@ -275,6 +176,7 @@ declare class RewardAdNovel extends RewardAdFather {
     /**
      * 广告展示失败分析
      * 子类需要埋点可以选择覆盖此方法
+     * ATTENTION：该方法可能会调用两次，一次是show().catch()，一次是onError()，所以需要做好去重处理
      * @protected
      * @param {object} _args
      * @param {string} _args.scene 广告执行场景 必填
@@ -345,14 +247,14 @@ declare class RewardAdNovel extends RewardAdFather {
     /**
      * @override
      * @param {object} [ctx] 广告执行上下文
-     * @param {import('./typings/ad.js').IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('./typings/ad.js').IAdOptions} [ctx.options] 广告执行选项
      * @param {import('./typings/ad.js').CallbackCollection} [ctx.collection] 回调集合
      * @param {import('./typings/ad.js').RecoveredInfo} [ctx.recovered] 恢复重试信息
      * @param {Function} next 执行下一个任务的回调函数，手动调用以继续执行流程
      * @returns {Promise.<object | Undefined>}
      */
     override ad(ctx?: {
-        options?: import("./typings/ad.js").IRewordAdConfig;
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: import("./typings/ad.js").CallbackCollection;
         recovered?: import("./typings/ad.js").RecoveredInfo;
     }, next?: Function): Promise<object | undefined>;

package/dist/ad-reward/src/typings/ad.d.ts

@@ -22,18 +22,12 @@ export type IRewordAdConfig = {
      * 额外观看广告的次数，合法的数据范围为 1～4，multiton 为 true 时必填
      */
     multitonRewardTimes?: number | undefined;
+};
+export type IRewordAdOther = {
     /**
-     * 场景值 - 自用参数，非tt API要求的参数
+     * 是否需要在超时情况下结束广告 - 自用参数，非tt API要求的参数
      */
-    scene?: number | undefined;
-    /**
-     * 广告超时时间 单位ms - 自用参数，非tt API要求的参数
-     */
-    timeout?: number | undefined;
-    /**
-     * 重试次数 - 自用参数 ，非tt API要求的参数
-     */
-    retry: number;
+    needEndOnTimeout?: boolean | undefined;
     /**
      * 是否绑定永远的错误事件 - 自用参数，非tt API要求的参数
      */
@@ -50,10 +44,6 @@ export type InterstitialAdConfig = {
     scene?: number | undefined;
 };
 export type IExeCallbackArgs = {
-    /**
-     * 广告执行场景
-     */
-    scene: number;
     /**
      * 是否看完
      */
@@ -63,40 +53,77 @@ export type IExeCallbackArgs = {
      */
     count: number;
     /**
-     * 剩余观看次数
+     * 广告场景
+     */
+    scene?: string;
+    /**
+     * 广告类型 1:激励视频 2:插屏
+     */
+    adTypeR?: 1 | 2;
+    /**
+     * 广告结束类型
      */
-    remain?: number;
+    end_type?: "finished" | "halfway";
 };
 export type CallbackCollection = {
     /**
-     * 完成广告外部回调 不管看不看完
+     * 每次外部回调
      */
-    always?: (ctx?: IExeCallbackArgs) => void;
+    always?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 完整看完广告外部回调 不管一个还是几个
      */
-    finished?: (ctx?: IExeCallbackArgs) => void;
+    finished?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 半途退出广告外部回调
      */
-    halfway?: (ctx?: IExeCallbackArgs) => void;
+    halfway?: (ctx?: IExeCallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 取消广告外部回调
      */
-    cancel?: (ctx?: IExeCallbackArgs) => void;
+    cancel?: () => void;
     /**
      * 展示广告外部回调
      */
-    before?: (ctx?: IExeCallbackArgs) => void;
+    before?: (ctx?: {
+        scene: number;
+    }) => void;
     /**
      * 展示广告成功外部回调
      */
-    success?: (ctx?: IExeCallbackArgs) => void;
+    success?: (ctx?: {
+        scene: number;
+    }) => void;
     /**
-     * 计时回调
+     * 计时回调 scene: 广告场景 frequency: 广告展示前间隔时间 time: 广告展示时前间戳
      */
-    prelude?: (ctx?: unknown) => void;
+    prelude?: (ctx?: {
+        scene: number;
+        frequency: number;
+        time: number;
+    }) => void;
 };
+export type IAdOptionsOther = {
+    /**
+     * 场景值 - 自用参数，非tt API要求的参数
+     */
+    scene?: number | undefined;
+    /**
+     * 广告超时时间 单位ms - 自用参数，非tt API要求的参数
+     */
+    timeout?: number | undefined;
+    /**
+     * 重试次数 - 自用参数 ，非tt API要求的参数
+     */
+    retry: number;
+};
+export type IAdOptions = IRewordAdConfig & IRewordAdOther & IAdOptionsOther;
 export type RecoveredInfo = {
     /**
      * 恢复重试次数
@@ -111,48 +138,80 @@ export type RecoveredInfo = {
      */
     message: string;
 };
-export type ICallbackArgs = {
+export type IApiError = {
     /**
-     * 广告执行场景
+     * 错误信息
      */
-    scene: number;
+    errMsg?: string;
     /**
-     * 是否看完
+     * 错误码
      */
-    isEnded: boolean;
+    errorCode?: number;
     /**
-     * 完整观看次数
+     * 错误信息
      */
-    count: number;
+    message?: string;
+};
+export type ITaskResult = {
     /**
-     * 剩余观看次数
+     * 广告任务的唯一标识符
      */
-    remain?: number;
+    id: string;
     /**
-     * 执行下一个任务的回调函数，手动调用以继续执行流程[end]
+     * 广告错误信息
      */
-    end?: () => void;
+    apiError?: IApiError;
     /**
-     * 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
+     * 广告任务后台恢复前台时预估重试次数的原因
      */
-    circle?: (args: {
-        ignoreRemain: boolean;
-        scene: number;
-    }) => void;
+    recovered?: RecoveredInfo;
+    /**
+     * 广告场景
+     */
+    scene?: string;
+    /**
+     * 广告类型 1:激励视频 2:插屏
+     */
+    adTypeR?: 1 | 2;
+    /**
+     * 广告结束类型
+     */
+    end_type?: "finished" | "halfway";
+    /**
+     * 是否看完广告
+     */
+    isEnded?: boolean;
+    /**
+     * 完整观看广告次数
+     */
+    count?: number;
 };
+export type ICallbackArgs = IExeCallbackArgs;
 export type IConnection = {
     /**
      * 广告中途退出回调
      */
-    onHalfway?: (args: ICallbackArgs) => void;
+    onHalfway?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告展示回调
      */
-    onShow?: (args: ICallbackArgs) => void;
+    onShow?: (args: {
+        scene: number;
+    }) => void;
+    /**
+     * 广告执行成功回调
+     */
+    onFinish?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告执行成功回调
      */
-    onFinish?: (args: ICallbackArgs) => void;
+    onAlways?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告执行失败回调
      */
@@ -162,19 +221,19 @@ export type IConstructArgs = {
     /**
      * 初始化标识
      */
-    sign: string;
+    sign?: string;
     /**
-     * 是否开启日志
+     * 是否保留tt激励视频广告实例
      */
-    log?: boolean | undefined;
+    preserveOnEnd?: boolean;
     /**
-     * 重试次数
+     * 是否需要在超时情况下结束广告
      */
-    retry: number;
+    needEndOnTimeout?: boolean;
     /**
-     * 是否保留tt激励视频广告实例
+     * 是否需要在错误情况下查询剩余次数
      */
-    preserveOnEnd: boolean;
+    lookUpRemainOnError?: boolean;
     /**
      * 激励视频参数 (可选)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singcl/ad-execute-manager",
-  "version": "2.0.11",
+  "version": "2.0.13",
   "description": "A powerful and flexible ad execution management library for handling reward-based ads, interstitial ads, and other advertising formats in JavaScript applications.",
   "type": "module",
   "exports": {
@@ -21,7 +21,7 @@
     "url": "https://github.com/singcl"
   },
   "license": "MIT",
-  "homepage": "https://npmjs.com/package/@singcl/ad-execute-manager",
+  "homepage": "https://npmx.dev/package/@singcl/ad-execute-manager",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/singcl/ad-execute-manager.git"
@@ -30,7 +30,13 @@
     "url": "https://github.com/singcl/ad-execute-manager/issues"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=8.0.0",
+    "npm": ">=6.0.0",
+    "yarn": ">=1.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "keywords": [
     "ad",
@@ -78,10 +84,10 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@ad-execute-manager/core": "^2.0.5",
+    "@ad-execute-manager/core": "^2.0.6",
     "@ad-execute-manager/logger": "^2.0.5",
-    "@ad-execute-manager/ad-reward": "^2.0.5",
-    "@ad-execute-manager/ad-interstitial": "^2.0.5",
+    "@ad-execute-manager/ad-reward": "^2.0.6",
+    "@ad-execute-manager/ad-interstitial": "^2.0.6",
     "@ad-execute-manager/count-recorder": "^2.0.5",
     "@ad-execute-manager/serializable-error": "^2.0.5",
     "@ad-execute-manager/storage": "^2.0.5",