@singcl/ad-execute-manager 2.0.11 → 2.0.12

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

@@ -25,12 +25,12 @@ declare class RewardAdFather {
      * 使用管理器执行广告
      * @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 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 +87,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,18 +95,18 @@ declare class RewardAdFather {
      * @throws {Error} 子类必须实现此方法
      */
     ad(ctx?: {
-        options?: IRewordAdConfig;
+        options?: import("./typings/ad.js").IAdOptions;
         collection?: CallbackCollection;
         recovered?: RecoveredInfo;
     }, next?: Function): Promise<unknown>;
     /**
      * 确保广告按顺序执行
      * @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-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要求的参数
-     */
-    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:插屏
      */
-    remain?: number;
+    adTypeR?: 1 | 2;
+    /**
+     * 广告结束类型
+     */
+    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 = {
+export type IApiError = {
     /**
-     * 广告执行场景
+     * 错误信息
      */
-    scene: number;
-    /**
-     * 是否看完
-     */
-    isEnded: boolean;
-    /**
-     * 完整观看次数
-     */
-    count: number;
+    errMsg?: string;
     /**
-     * 剩余观看次数
+     * 错误码
      */
-    remain?: number;
+    errorCode?: number;
     /**
-     * 执行下一个任务的回调函数，手动调用以继续执行流程[end]
+     * 错误信息
      */
-    end?: () => void;
-    /**
-     * 执行下一个任务的回调函数， 手动调用以继续执行流程[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) => void;
+    onFinish?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
+    /**
+     * 广告执行成功回调
+     */
+    onAlways?: (args: ICallbackArgs & {
+        [key: string]: unknown;
+    }) => void;
     /**
      * 广告执行失败回调
      */
@@ -162,19 +187,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,91 +1,97 @@
-{
-  "name": "@singcl/ad-execute-manager",
-  "version": "2.0.11",
-  "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": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "main": "./dist/index.cjs",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "author": {
-    "name": "singcl",
-    "email": "iambabyer@gmail.com",
-    "url": "https://github.com/singcl"
-  },
-  "license": "MIT",
-  "homepage": "https://npmjs.com/package/@singcl/ad-execute-manager",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/singcl/ad-execute-manager.git"
-  },
-  "bugs": {
-    "url": "https://github.com/singcl/ad-execute-manager/issues"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "keywords": [
-    "ad",
-    "advertisement",
-    "reward-ad",
-    "interstitial-ad",
-    "ad-manager",
-    "ad-execution",
-    "javascript",
-    "nodejs"
-  ],
-  "scripts": {
-    "build": "rslib build && tsc",
-    "dev": "rslib build --watch",
-    "format": "prettier --write .",
-    "lint": "eslint .",
-    "test": "rstest",
-    "prepublishOnly": "npm i && npm run build",
-    "packages:install": "node build-packages.js install",
-    "packages:build": "node build-packages.js build",
-    "packages:publish": "node build-packages.js publish",
-    "packages:publish:patch": "node build-packages.js publish patch",
-    "packages:publish:minor": "node build-packages.js publish minor",
-    "packages:publish:major": "node build-packages.js publish major",
-    "packages:lint": "node build-packages.js lint",
-    "packages:format": "node build-packages.js format",
-    "packages:clean": "node build-packages.js clean",
-    "packages:all": "node build-packages.js all",
-    "packages:all:patch": "node build-packages.js all patch",
-    "packages:all:minor": "node build-packages.js all minor",
-    "packages:all:major": "node build-packages.js all major"
-  },
-  "devDependencies": {
-    "@babel/eslint-parser": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@douyin-microapp/typings": "^1.3.1",
-    "@eslint/js": "^9.39.1",
-    "@rslib/core": "^0.18.5",
-    "@rstest/core": "^0.7.2",
-    "@singcl/ad-execute-manager": "^1.11.12",
-    "eslint": "^9.39.2",
-    "eslint-plugin-import": "^2.32.0",
-    "globals": "^16.5.0",
-    "prettier": "^3.7.3",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "@ad-execute-manager/core": "^2.0.5",
-    "@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/count-recorder": "^2.0.5",
-    "@ad-execute-manager/serializable-error": "^2.0.5",
-    "@ad-execute-manager/storage": "^2.0.5",
-    "@ad-execute-manager/event": "^2.0.5",
-    "@ad-execute-manager/analytics": "^2.0.5"
-  }
-}
+{
+  "name": "@singcl/ad-execute-manager",
+  "version": "2.0.12",
+  "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": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": {
+    "name": "singcl",
+    "email": "iambabyer@gmail.com",
+    "url": "https://github.com/singcl"
+  },
+  "license": "MIT",
+  "homepage": "https://npmx.dev/package/@singcl/ad-execute-manager",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/singcl/ad-execute-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/singcl/ad-execute-manager/issues"
+  },
+  "engines": {
+    "node": ">=8.0.0",
+    "npm": ">=6.0.0",
+    "yarn": ">=1.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ad",
+    "advertisement",
+    "reward-ad",
+    "interstitial-ad",
+    "ad-manager",
+    "ad-execution",
+    "javascript",
+    "nodejs"
+  ],
+  "scripts": {
+    "build": "rslib build && tsc",
+    "dev": "rslib build --watch",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "rstest",
+    "prepublishOnly": "npm i && npm run build",
+    "packages:install": "node build-packages.js install",
+    "packages:build": "node build-packages.js build",
+    "packages:publish": "node build-packages.js publish",
+    "packages:publish:patch": "node build-packages.js publish patch",
+    "packages:publish:minor": "node build-packages.js publish minor",
+    "packages:publish:major": "node build-packages.js publish major",
+    "packages:lint": "node build-packages.js lint",
+    "packages:format": "node build-packages.js format",
+    "packages:clean": "node build-packages.js clean",
+    "packages:all": "node build-packages.js all",
+    "packages:all:patch": "node build-packages.js all patch",
+    "packages:all:minor": "node build-packages.js all minor",
+    "packages:all:major": "node build-packages.js all major"
+  },
+  "devDependencies": {
+    "@babel/eslint-parser": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@douyin-microapp/typings": "^1.3.1",
+    "@eslint/js": "^9.39.1",
+    "@rslib/core": "^0.18.5",
+    "@rstest/core": "^0.7.2",
+    "@singcl/ad-execute-manager": "^1.11.12",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.3",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@ad-execute-manager/core": "^2.0.5",
+    "@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/count-recorder": "^2.0.5",
+    "@ad-execute-manager/serializable-error": "^2.0.5",
+    "@ad-execute-manager/storage": "^2.0.5",
+    "@ad-execute-manager/event": "^2.0.5",
+    "@ad-execute-manager/analytics": "^2.0.5"
+  }
+}