@singcl/ad-execute-manager 2.1.1 → 2.2.0

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

@@ -85,6 +85,14 @@ declare class RewardAdNovel extends RewardAdFather {
     _finishedCallback: any;
     _resolve: any;
     _next: any;
+    /** @type {{options: import('./typings/ad.js').IAdOptions, collection: import('./typings/ad.js').CallbackCollection, recovered: import('./typings/ad.js').RecoveredInfo}} */
+    _adExecuteArgs: {
+        options: import("./typings/ad.js").IAdOptions;
+        collection: import("./typings/ad.js").CallbackCollection;
+        recovered: import("./typings/ad.js").RecoveredInfo;
+    };
+    /** @type {Function} */
+    _adNext: Function;
     /** @type {number} 广告执行场景 */
     _scene: number;
     _adTypeR: 1;
@@ -147,6 +155,7 @@ declare class RewardAdNovel extends RewardAdFather {
     }): void;
     novelConfig: RewardAdNovelConfig;
     _onInnerExecuteBefore(): any;
+    _onAdExecuteBefore(): any;
     /**
      * @param {object} _args
      * @param {string} _args.scene 广告执行场景 必填
@@ -160,6 +169,7 @@ declare class RewardAdNovel extends RewardAdFather {
         recovered?: import("./typings/ad.js").RecoveredInfo;
     }): any;
     /**
+     * @private
      * 广告展示超时设置
      * @param {object} args
      * @param {string} args.scene 广告执行场景 必填
@@ -167,12 +177,7 @@ declare class RewardAdNovel extends RewardAdFather {
      * @param {Function} args.end 结束当前广告任务的回调函数 必填
      * @param {boolean} [args.preserved] 是否在超时情况下保留广告实例 - 自用参数，非tt API要求的参数
      */
-    _setAdTimeout(args: {
-        scene: string;
-        timeout?: number;
-        end: Function;
-        preserved?: boolean;
-    }): void;
+    private _setAdTimeout;
     /**
      * 子类可以选择覆盖此方法
      * 添加超时情况下结束任务前的回调
@@ -314,29 +319,46 @@ declare class RewardAdNovel extends RewardAdFather {
     _recovered: import("./typings/ad.js").RecoveredInfo;
     _preservedOnTimeout: boolean;
     /**
+     * ATTENTION: 广告循环执行内部函数，如果需要循环执行，请使用adCircleInner()函数, 不要直接调用此函数
+     * @private
      * @param {object} [ctx] 广告执行上下文
      * @param {object} [ctx.options] 广告执行选项
      * @param {number} [ctx.options.scene] 广告执行场景 必填
      * @param {number} [ctx.options.timeout] 广告超时时间 单位ms
      * @param {object} ctx.collection 回调集合
-     * @param {import('./typings/ad.js').RecoveredInfo} [ctx.recovered] 恢复重试信息
      * @param {(v?: unknown) => void} ctx.collection.resolve 广告执行成功的回调函数
-     * @param {(v?: unknown) => void} [ctx.collection.reject] 广告执行失败的回调函数
      * @param {(v?: unknown) => void} [ctx.collection.before] 广告执行前的回调函数
      * @param {(v?: unknown) => void} [ctx.collection.success] 广告执行成功的回调函数
      * @param {(v?: unknown) => void} [ctx.collection.prelude] 拉起广告前计时的回调函数
+     * @param {import('./typings/ad.js').RecoveredInfo} [ctx.recovered] 恢复重试信息
      * @param {Function} next 执行下一个任务的回调函数，手动调用以继续执行流程
      */
-    _adInner(ctx?: {
+    private _adInner;
+    _before: (v?: unknown) => void;
+    _success: (v?: unknown) => void;
+    /**
+     * 广告循环执行
+     * @public
+     * @param {object} [ctx] 广告执行上下文
+     * @param {object} [ctx.options] 广告执行选项
+     * @param {number} [ctx.options.scene] 广告执行场景 必填
+     * @param {number} [ctx.options.timeout] 广告超时时间 单位ms
+     * @param {object} ctx.collection 回调集合
+     * @param {(v?: unknown) => void} [ctx.collection.before] 广告执行前的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.success] 广告执行成功的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.prelude] 拉起广告前计时的回调函数
+     */
+    public adCircleInner(ctx?: {
         options?: {
             scene?: number;
             timeout?: number;
         };
-        collection: object;
-        recovered?: import("./typings/ad.js").RecoveredInfo;
-    }, next?: Function): void;
-    _before: any;
-    _success: any;
+        collection: {
+            before?: (v?: unknown) => void;
+            success?: (v?: unknown) => void;
+            prelude?: (v?: unknown) => void;
+        };
+    }): void;
     /**
      * 广告加载
      * @returns
@@ -348,7 +370,7 @@ declare class RewardAdNovel extends RewardAdFather {
      */
     adShow(): Promise<void>;
     /**
-     * @deprecated - 已废弃，使用onExeAlways代替
+     * @deprecated - 2.x版本自v2.1.1开始已废弃，使用onExeAlways代替
      * - 关闭广告时候调用的回调,不管是否看完视频都会调用
      * - 调用adExecuteManager时collection.always回调
      * @param {Array.<unknown>} args
@@ -361,7 +383,7 @@ declare class RewardAdNovel extends RewardAdFather {
      */
     onExeAlways(...args: Array<unknown>): any;
     /**
-     * @deprecated 已废弃，使用onExeHalfway代替
+     * @deprecated 2.x版本自v2.1.1开始已废弃，使用onExeHalfway代替
      * - 广告未看完时候调用的回调
      * - 调用adExecuteManager时collection.halfway回调
      * @param {Array.<unknown>} args
@@ -374,7 +396,7 @@ declare class RewardAdNovel extends RewardAdFather {
      */
     onExeHalfway(...args: Array<unknown>): any;
     /**
-     * @deprecated 已废弃，使用onExeFinished代替
+     * @deprecated 2.x版本自v2.1.1开始已废弃，使用onExeFinished代替
      * - 广告看完时候调用的回调
      * - 调用adExecuteManager时collection.finished回调
      * @param {Array.<unknown>} args

package/dist/count-recorder/src/CountRecorder.d.ts

@@ -33,6 +33,19 @@ export class CountRecorder {
     _initLocalTimes(): void;
     updateToday(): void;
     remain(): number;
+    /**
+     * 保存指定次数
+     * @param {number} count 次数
+     */
+    save(count: number): void;
+    /**
+     * 清除当前类的本地存储
+     */
+    clear(): void;
+    /**
+     * 重置当前类的本地存储
+     */
+    reset(): void;
 }
 export type IConstructorArgs = {
     /**

package/dist/storage/src/Storage.d.ts

@@ -106,6 +106,11 @@ declare class Storage {
      * @param {number|'today'} expire 过期时间（毫秒）或'today'表示当天有效，可选
      */
     setUserItem(key: string, value: any, expire: number | "today"): void;
+    /**
+     * 删除用户维度的存储项
+     * @param {string} key 存储键
+     */
+    removeUserItem(key: string): void;
     /**
      * 删除存储项
      * @param {string} key 存储键

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singcl/ad-execute-manager",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "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": {
@@ -88,9 +88,9 @@
     "@ad-execute-manager/logger": "^2.0.5",
     "@ad-execute-manager/ad-reward": "^2.1.1",
     "@ad-execute-manager/ad-interstitial": "^2.0.6",
-    "@ad-execute-manager/count-recorder": "^2.0.5",
+    "@ad-execute-manager/count-recorder": "^2.1.0",
     "@ad-execute-manager/serializable-error": "^2.0.5",
-    "@ad-execute-manager/storage": "^2.0.5",
+    "@ad-execute-manager/storage": "^2.1.0",
     "@ad-execute-manager/event": "^2.0.5",
     "@ad-execute-manager/analytics": "^2.0.5"
   }