@ad-execute-manager/helper 2.0.0-alpha.1 → 2.0.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 singcl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @singcl/helper
+
+A collection of utility helper classes for JavaScript applications including EventEmitter, Logger, Storage, CountRecorder, PubSub, and SerializableError.
+
+## Installation
+
+```bash
+npm install @singcl/helper
+```
+
+## Features
+
+- **EventEmitter**: A powerful event emitter with support for once events, max listeners, and event queuing
+- **Logger**: A flexible logging utility with multiple log levels and customizable prefixes
+- **Storage**: A storage wrapper with expiration support, including "today" expiration for daily data
+- **CountRecorder**: A utility for tracking and managing counts with expiration
+- **PubSub**: A simple publish-subscribe pattern implementation
+- **SerializableError**: An error class that can be serialized to JSON
+
+## Usage
+
+### EventEmitter
+
+```javascript
+import { EventEmitter } from '@singcl/helper';
+
+const emitter = new EventEmitter({ maxListeners: 10 });
+
+emitter.on('event', (data) => {
+  console.log('Received:', data);
+});
+
+emitter.emit('event', { message: 'Hello' });
+```
+
+### Logger
+
+```javascript
+import { Logger } from '@singcl/helper';
+
+const logger = new Logger({ prefix: 'MyApp', level: 'info' });
+
+logger.info('Application started');
+logger.error('Something went wrong');
+```
+
+### Storage
+
+```javascript
+import { Storage } from '@singcl/helper';
+
+const storage = new Storage({ prefix: 'myapp_' });
+
+// Set data that expires at end of day
+storage.setItem('dailyTask', { completed: false }, 'today');
+
+// Set data with custom expiration (2 hours)
+storage.setItem('tempData', { value: 123 }, 2 * 60 * 60 * 1000);
+
+// Get data
+const data = storage.getItem('dailyTask');
+```
+
+### CountRecorder
+
+```javascript
+import { CountRecorder } from '@singcl/helper';
+
+const recorder = CountRecorder.new({
+  local_sign: 'daily_ads',
+  total: 5,
+  expire: 'today',
+  userId: 'user123'
+});
+
+console.log(recorder.remain()); // Remaining count
+recorder.updateToday(); // Increment today's count
+```
+
+### PubSub
+
+```javascript
+import { PubSub } from '@singcl/helper';
+
+const pubsub = new PubSub();
+
+const unsubscribe = pubsub.on('topic', (data) => {
+  console.log('Received:', data);
+});
+
+pubsub.emit('topic', { message: 'Hello' });
+
+unsubscribe();
+```
+
+### SerializableError
+
+```javascript
+import { SerializableError } from '@singcl/helper';
+
+const error = new SerializableError('Something went wrong', {
+  errorCode: 500,
+  errMsg: 'Internal server error'
+});
+
+console.log(error.toJSON());
+```
+
+## API
+
+See individual class documentation for detailed API information.
+
+## License
+
+MIT

package/dist/{helper/PubSub.d.ts → PubSub.d.ts}

@@ -1,4 +1,4 @@
-export default class EventEmitter {
+export default class PubSub {
     events: {};
     on(eventName: any, callback: any): () => void;
     off(eventName: any, callback: any): void;

package/dist/{helper/SerializableError.d.ts → SerializableError.d.ts}

@@ -1,9 +1,13 @@
 export class SerializableError extends Error {
-    constructor(message: any);
+    constructor(message: any, options?: {});
     stack: string;
+    errMsg: any;
+    errorCode: any;
     toJSON(): {
         name: string;
         message: string;
         stack: string;
+        errMsg: any;
+        errorCode: any;
     };
 }

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,t)=>{for(var r in t)__webpack_require__.o(t,r)&&!__webpack_require__.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},__webpack_require__.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{CountRecorder:()=>CountRecorder,Logger:()=>Logger,EventEmitter:()=>EventEmitter,PubSub:()=>PubSub,SerializableError:()=>SerializableError,Storage:()=>src_Storage});class EventEmitter{constructor(e={}){this.events={},this.queues={},this.onceEvents={},this.maxListeners=e.maxListeners||5,this.maxQueueSize=e.maxQueueSize||1,this.maxOnceEvents=e.maxOnceEvents||5}on(e,t){(this.events[e]||(this.events[e]=[]),this.events[e].length>=this.maxListeners)?console.warn(`EventEmitter: Maximum listeners (${this.maxListeners}) reached for event "${e}". Listener not added.`):(this.events[e].push(t),this.queues[e]&&this.queues[e].length>0&&(this.queues[e].forEach(e=>{t(...e)}),this.queues[e]=[]))}once(e,t){let r=(...s)=>{t(...s),this.off(e,r)};(this.onceEvents[e]||(this.onceEvents[e]=new Set),this.onceEvents[e].size>=this.maxOnceEvents)?console.warn(`EventEmitter: Maximum once events (${this.maxOnceEvents}) reached for event "${e}". Once listener not added.`):(this.onceEvents[e].add(r),this.on(e,r))}emit(e,...t){this.events[e]&&this.events[e].length>0?[...this.events[e]].forEach(e=>{e(...t)}):(this.queues[e]||(this.queues[e]=[]),this.queues[e].length>=this.maxQueueSize&&(console.warn(`EventEmitter: Maximum queue size (${this.maxQueueSize}) reached for event "${e}". Oldest event removed.`),this.queues[e].shift()),this.queues[e].push(t))}off(e,t){if(!t){this.events[e]=[],this.onceEvents[e]=new Set;return}this.events[e]=this.events[e].filter(e=>e!==t),this.onceEvents[e]&&this.onceEvents[e].delete(t)}removeAllListeners(e){e?(delete this.events[e],delete this.queues[e],delete this.onceEvents[e]):(this.events={},this.queues={},this.onceEvents={})}static geInstance(e){return this._instance||(this._instance=new EventEmitter(e)),this._instance}}class Logger{constructor(e={}){const{prefix:t="Logger",level:r="log",enabled:s=!0}=e;this.prefix=t,this.enabled=s,this.levels={error:0,warn:1,info:2,log:3,debug:4},this.currentLevel=this.levels[r]||this.levels.log}enable(){this.enabled=!0}disable(){this.enabled=!1}isEnabled(){return this.enabled}setLevel(e){Object.prototype.hasOwnProperty.call(this.levels,e)&&(this.currentLevel=this.levels[e])}formatMessage(e,t){let r=new Date,s=`${r.getFullYear()}/${r.getMonth()+1}/${r.getDate()} ${r.getHours()}:${r.getMinutes()}:${r.getSeconds()}`;return`[${s}] [${e.toUpperCase()}] [${this.prefix}] ${t}`}_log(e,t,...r){if(!this.enabled)return;let s=this.levels[e];if(void 0!==s&&this.currentLevel>=s){let s=this.formatMessage(e,t);switch(e){case"error":console.error(s,...r);break;case"warn":console.warn(s,...r);break;case"info":console.info(s,...r);break;case"log":default:console.log(s,...r);break;case"debug":console.debug(s,...r)}}}error(e,...t){this._log("error",e,...t)}warn(e,...t){this._log("warn",e,...t)}info(e,...t){this._log("info",e,...t)}log(e,...t){this._log("log",e,...t)}debug(e,...t){this._log("debug",e,...t)}}class Storage{constructor(e={}){this.config={prefix:"storage_",expire:null,...e},this.logger=new Logger({prefix:"Storage"})}getTodayEndTimestamp(){let e=new Date;return new Date(e.getFullYear(),e.getMonth(),e.getDate(),23,59,59,999).getTime()}_setItem(e,t,r){let s=void 0!==r?r:this.config.expire;"today"===s&&(s=this.getTodayEndTimestamp()-Date.now());let i={value:t,expire:s,timestamp:Date.now()};try{tt.setStorageSync(e,JSON.stringify(i))}catch(e){console.error("Storage setItem error:",e)}}_getItem(e){try{let t=tt.getStorageSync(e);if(!t)return null;let r=JSON.parse(t);if(r.expire&&Date.now()-r.timestamp>r.expire)return this.removeItem(e),null;return r.value}catch(e){return console.error("Storage getItem error:",e),null}}setItem(e,t,r){let s=this.config.prefix+e;return this._setItem(s,t,r)}getItem(e){let t=this.config.prefix+e;return this._getItem(t)}getUserItem(e){let t=this.config.userId??"null";if("null"===t)return this.logger.error("userId is required"),null;let r=`${this.config.prefix}_${t}_${e}`;return this._getItem(r)}setUserItem(e,t,r){let s=this.config.userId??"null";if("null"===s)return void this.logger.error("userId is required");let i=`${this.config.prefix}_${s}_${e}`;return this._setItem(i,t,r)}removeItem(e){try{tt.removeStorageSync(e)}catch(e){console.error("Storage removeItem error:",e)}}clear(){try{tt.clearStorageSync()}catch(e){console.error("Storage clear error:",e)}}keys(){try{let e=[];return(tt.getStorageInfoSync().keys??[]).forEach(t=>{if(t.startsWith(this.config.prefix)){let r=JSON.parse(tt.getStorageSync(t));(!r.expire||Date.now()-r.timestamp<=r.expire)&&e.push(t.replace(this.config.prefix,""))}}),e}catch(e){return console.error("Storage keys error:",e),[]}}static new(e){return new Storage(e)}}const src_Storage=Storage;class CountRecorder{_total=0;_local_sign="";_expire="today";constructor(e){if(this.storage=src_Storage.new({userId:e.userId}),!e.local_sign)throw Error("local_sign is required");this._local_sign=e.local_sign,this._total=e.total??0,this._expire=e.expire??"today",this._init()}_init(){this._initLocalTimes()}_adTimes(){return this._total}_safeLocalValue(e){return"object"!=typeof e||null===e?{}:e}_initLocalTimes(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),r=this._safeLocalValue(t);r&&(null==r?void 0:r.total)==e||this.storage.setUserItem(this._local_sign,{total:e,today:(null==r?void 0:r.today)??0},this._expire)}updateToday(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),r=this._safeLocalValue(t),s=(null==r?void 0:r.today)??0;this.storage.setUserItem(this._local_sign,{total:e,today:s+1},this._expire)}remain(){let e=this.storage.getUserItem(this._local_sign),t=this._safeLocalValue(e),r=(null==t?void 0:t.today)??0;return Number((null==t?void 0:t.total)??0)-Number(r)}static new(e){return new CountRecorder(e)}}class PubSub{constructor(){this.events={}}on(e,t){return this.events[e]||(this.events[e]=[]),this.events[e].push(t),()=>{this.off(e,t)}}off(e,t){if(this.events[e]){if(!t){this.events[e]=[];return}this.events[e]=this.events[e].filter(e=>e!==t)}}emit(e,...t){this.events[e]&&this.events[e].forEach(r=>{try{r(...t)}catch(t){console.error(`Error in event listener for ${e}:`,t)}})}once(e,t){let r=(...s)=>{t(...s),this.off(e,r)};this.on(e,r)}listenerCount(e){return this.events[e]?this.events[e].length:0}removeAllListeners(){this.events={}}}class SerializableError extends Error{constructor(e,t={}){super(e),this.name=this.constructor.name,this.stack=Error(e).stack,this.errMsg=t.errMsg,this.errorCode=t.errorCode,Object.defineProperty(this,"message",{enumerable:!0}),Object.defineProperty(this,"name",{enumerable:!0}),Object.defineProperty(this,"stack",{enumerable:!0}),Object.defineProperty(this,"errMsg",{enumerable:!0}),Object.defineProperty(this,"errorCode",{enumerable:!0})}toJSON(){return{name:this.name,message:this.message,stack:this.stack,errMsg:this.errMsg,errorCode:this.errorCode}}}for(var __rspack_i in exports.CountRecorder=__webpack_exports__.CountRecorder,exports.EventEmitter=__webpack_exports__.EventEmitter,exports.Logger=__webpack_exports__.Logger,exports.PubSub=__webpack_exports__.PubSub,exports.SerializableError=__webpack_exports__.SerializableError,exports.Storage=__webpack_exports__.Storage,__webpack_exports__)-1===["CountRecorder","EventEmitter","Logger","PubSub","SerializableError","Storage"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -1,15 +1,6 @@
-export default AdExecuteManager;
-import AdExecuteManager from './core/AdExecuteManager';
-import RewardAdFather from './ad/RewardAdFather';
-import { SerializableError } from './helper/SerializableError';
-import { Logger } from './helper/Logger';
-import Storage from './helper/Storage';
-import { CountRecorder } from './helper/CountRecorder';
-import RewardAdGlobalRecorder from './helper/RewardAdGlobalRecorder';
-import RewardAdSceneTriggerManager from './helper/RewardAdSceneTriggerManager';
-import AdAnalyticsJS from './helper/AdAnalyticsJS';
-import RewardAdNovel from './ad/RewardAdNovel';
-import InterstitialAdFather from './ad/InterstitialAdFather';
-import InterstitialAdNovel from './ad/InterstitialAdNovel';
-import PubSub from './helper/PubSub';
-export { AdExecuteManager, RewardAdFather, SerializableError, Logger, Storage, CountRecorder, RewardAdGlobalRecorder, RewardAdSceneTriggerManager, AdAnalyticsJS, RewardAdNovel, InterstitialAdFather, InterstitialAdNovel, PubSub };
+export { EventEmitter } from "./EventEmitter.js";
+export { Logger } from "./Logger.js";
+export { CountRecorder } from "./CountRecorder.js";
+export { default as PubSub } from "./PubSub.js";
+export { SerializableError } from "./SerializableError.js";
+export { default as Storage } from "./Storage.js";

package/dist/index.js

@@ -1 +1 @@
-class e{constructor(e={}){let{prefix:t="Logger",level:s="log",enabled:n=!0}=e;this.prefix=t,this.enabled=n,this.levels={error:0,warn:1,info:2,log:3,debug:4},this.currentLevel=this.levels[s]||this.levels.log}enable(){this.enabled=!0}disable(){this.enabled=!1}isEnabled(){return this.enabled}setLevel(e){Object.prototype.hasOwnProperty.call(this.levels,e)&&(this.currentLevel=this.levels[e])}formatMessage(e,t){let s=new Date,n=`${s.getFullYear()}/${s.getMonth()+1}/${s.getDate()} ${s.getHours()}:${s.getMinutes()}:${s.getSeconds()}`;return`[${n}] [${e.toUpperCase()}] [${this.prefix}] ${t}`}_log(e,t,...s){if(!this.enabled)return;let n=this.levels[e];if(void 0!==n&&this.currentLevel>=n){let n=this.formatMessage(e,t);switch(e){case"error":console.error(n,...s);break;case"warn":console.warn(n,...s);break;case"info":console.info(n,...s);break;case"log":default:console.log(n,...s);break;case"debug":console.debug(n,...s)}}}error(e,...t){this._log("error",e,...t)}warn(e,...t){this._log("warn",e,...t)}info(e,...t){this._log("info",e,...t)}log(e,...t){this._log("log",e,...t)}debug(e,...t){this._log("debug",e,...t)}}class t{constructor(t={}){this.config={prefix:"storage_",expire:null,...t},this.logger=new e({prefix:"Storage"})}getTodayEndTimestamp(){let e=new Date;return new Date(e.getFullYear(),e.getMonth(),e.getDate(),23,59,59,999).getTime()}_setItem(e,t,s){let n=void 0!==s?s:this.config.expire;"today"===n&&(n=this.getTodayEndTimestamp()-Date.now());let i={value:t,expire:n,timestamp:Date.now()};try{tt.setStorageSync(e,JSON.stringify(i))}catch(e){console.error("Storage setItem error:",e)}}_getItem(e){try{let t=tt.getStorageSync(e);if(!t)return null;let s=JSON.parse(t);if(s.expire&&Date.now()-s.timestamp>s.expire)return this.removeItem(e),null;return s.value}catch(e){return console.error("Storage getItem error:",e),null}}setItem(e,t,s){let n=this.config.prefix+e;return this._setItem(n,t,s)}getItem(e){let t=this.config.prefix+e;return this._getItem(t)}getUserItem(e){let t=this.config.userId??"null";if("null"===t)return this.logger.error("userId is required"),null;let s=`${this.config.prefix}_${t}_${e}`;return this._getItem(s)}setUserItem(e,t,s){let n=this.config.userId??"null";if("null"===n)return void this.logger.error("userId is required");let i=`${this.config.prefix}_${n}_${e}`;return this._setItem(i,t,s)}removeItem(e){try{tt.removeStorageSync(e)}catch(e){console.error("Storage removeItem error:",e)}}clear(){try{tt.clearStorageSync()}catch(e){console.error("Storage clear error:",e)}}keys(){try{let e=[];return(tt.getStorageInfoSync().keys??[]).forEach(t=>{if(t.startsWith(this.config.prefix)){let s=JSON.parse(tt.getStorageSync(t));(!s.expire||Date.now()-s.timestamp<=s.expire)&&e.push(t.replace(this.config.prefix,""))}}),e}catch(e){return console.error("Storage keys error:",e),[]}}static new(e){return new t(e)}}let s=t;class n{_total=0;_local_sign="";_expire="today";constructor(e){if(this.storage=s.new({userId:e.userId}),!e.local_sign)throw Error("local_sign is required");this._local_sign=e.local_sign,this._total=e.total??0,this._expire=e.expire??"today",this._init()}_init(){this._initLocalTimes()}_adTimes(){return this._total}_safeLocalValue(e){return"object"!=typeof e||null===e?{}:e}_initLocalTimes(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),s=this._safeLocalValue(t);s&&s?.total==e||this.storage.setUserItem(this._local_sign,{total:e,today:s?.today??0},this._expire)}updateToday(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),s=this._safeLocalValue(t),n=s?.today??0;this.storage.setUserItem(this._local_sign,{total:e,today:n+1},this._expire)}remain(){let e=this.storage.getUserItem(this._local_sign),t=this._safeLocalValue(e),s=t?.today??0;return Number(t?.total??0)-Number(s)}static new(e){return new n(e)}}class i extends Error{constructor(e){super(e),this.name=this.constructor.name,this.stack=Error(e).stack,Object.defineProperty(this,"message",{enumerable:!0}),Object.defineProperty(this,"name",{enumerable:!0}),Object.defineProperty(this,"stack",{enumerable:!0})}toJSON(){return{name:this.name,message:this.message,stack:this.stack}}}class r{constructor(){this.events={}}on(e,t){return this.events[e]||(this.events[e]=[]),this.events[e].push(t),()=>{this.off(e,t)}}off(e,t){if(this.events[e]){if(!t){this.events[e]=[];return}this.events[e]=this.events[e].filter(e=>e!==t)}}emit(e,...t){this.events[e]&&this.events[e].forEach(s=>{try{s(...t)}catch(t){console.error(`Error in event listener for ${e}:`,t)}})}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};this.on(e,s)}listenerCount(e){return this.events[e]?this.events[e].length:0}removeAllListeners(){this.events={}}}class a{constructor(e={}){this.events={},this.queues={},this.onceEvents={},this.maxListeners=e.maxListeners||5,this.maxQueueSize=e.maxQueueSize||1,this.maxOnceEvents=e.maxOnceEvents||5}on(e,t){(this.events[e]||(this.events[e]=[]),this.events[e].length>=this.maxListeners)?console.warn(`EventEmitter: Maximum listeners (${this.maxListeners}) reached for event "${e}". Listener not added.`):(this.events[e].push(t),this.queues[e]&&this.queues[e].length>0&&(this.queues[e].forEach(e=>{t(...e)}),this.queues[e]=[]))}once(e,t){let s=(...n)=>{t(...n),this.off(e,s)};(this.onceEvents[e]||(this.onceEvents[e]=new Set),this.onceEvents[e].size>=this.maxOnceEvents)?console.warn(`EventEmitter: Maximum once events (${this.maxOnceEvents}) reached for event "${e}". Once listener not added.`):(this.onceEvents[e].add(s),this.on(e,s))}emit(e,...t){this.events[e]&&this.events[e].length>0?[...this.events[e]].forEach(e=>{e(...t)}):(this.queues[e]||(this.queues[e]=[]),this.queues[e].length>=this.maxQueueSize&&(console.warn(`EventEmitter: Maximum queue size (${this.maxQueueSize}) reached for event "${e}". Oldest event removed.`),this.queues[e].shift()),this.queues[e].push(t))}off(e,t){if(!t){this.events[e]=[],this.onceEvents[e]=new Set;return}this.events[e]=this.events[e].filter(e=>e!==t),this.onceEvents[e]&&this.onceEvents[e].delete(t)}removeAllListeners(e){e?(delete this.events[e],delete this.queues[e],delete this.onceEvents[e]):(this.events={},this.queues={},this.onceEvents={})}static geInstance(e){return this._instance||(this._instance=new a(e)),this._instance}}class o{static instance=null;_initSign="";_needReport=!1;constructor(e){if(o.instance)return o.instance;this._initSign=e?.sign??"",this._needReport=e?.needReport??!1,this._commonConfig=e?.commonConfig??null,o.instance=this}initialize(e){return this._needReport?e:void console.warn("AdAnalyticsJS needReport is false, do not report")}track(e,t,s){if(!this._needReport)return;if(!e)throw Error("eventName is required");let n=Object.assign({},this.getTrackCommonInfo(),t),i=s?.sign??"track";console.log(`-------------${i}-----------------------:`,e,n),tt.reportAnalytics(e,n)}getCommonInfo(){return this._commonConfig??{}}getTrackCommonInfo(){return this._commonConfig??{}}identify(e,t){if(!e&&0!==e)throw Error("identify user_id is required");return this._commonConfig=Object.assign({},this._commonConfig,{__user_id:e},t),this}alias(){return null}pages(){return null}page(e,t){this.track(e,t,{sign:"page"})}cpage(e){return this.page("cpage",e)}placeholder(){return null}static build(e){return o.instance||(o.instance=new o(e)),o.instance}static getInstance(){if(!o.instance)throw Error("AdAnalyticsJS instance is not init");return o.instance}static new(e){return new o(e)}}let h=o;class l{static instance=null;_initSign="";_dramaDetailData=[];_unlockChapterThreshold=2e3;_unlockChapterNum=30;_unlockChapterWaterLevel=15;_isReachThreshold=!1;_unlockedIdArr=[];constructor(e){this._initSign=e?.sign??"",this._unlockChapterThreshold=e?.unlockChapterThreshold??2e3,this._unlockChapterNum=e?.unlockChapterNum??30,this._unlockChapterWaterLevel=e?.unlockChapterWaterLevel??15}get drama(){return this._dramaDetailData}set drama(e=[]){this._dramaDetailData=e,this._checkReachThreshold(e)}_checkReachThreshold(e=[]){let t=e.filter(e=>1===e.flagTag);this._isReachThreshold=t.length>=this._unlockChapterThreshold}_isUnlockThreshold(){return this._isReachThreshold}_unlockChapterIds(e,t=this._unlockChapterNum){let s=this.drama,n=s.findIndex(t=>t.episodeId===e);if(-1===n)return;let i=n-t,r=Math.max(i,0),a=Math.min(i>=0?n+t:n+t-i,s.length);return s.slice(r,a).map(e=>e.episodeId)}_unlockChapterIdsWithWater(e,t=this._unlockChapterNum){let s=this._unlockChapterIds(e,t),n=s.filter(e=>!this._unlockedIdArr.includes(e));if(n&&n.length>=this._unlockChapterWaterLevel)return this._unlockedIdArr=Array.from(new Set(this._unlockedIdArr.concat(s))),s}ready(e,t,s){if(this._isUnlockThreshold()){let e=this._unlockChapterIdsWithWater(s);e&&e.length>0&&"function"==typeof t&&t(e)}else"function"==typeof e&&e()}onProcessUpdate(e,t){if(this._isUnlockThreshold()){let s=e.chapterId,n=this._unlockChapterIdsWithWater(s);n&&n.length>0&&"function"==typeof t&&t(n)}}onChapterChange(e,t){if(this._isUnlockThreshold()){let s=e.nextChapterId,n=this._unlockChapterIdsWithWater(s);n&&n.length>0&&"function"==typeof t&&t(n)}}unlockAll(){let e=this.drama.map(e=>({...e,flagTag:1}));this.drama=e}static build(e){return l.instance||(l.instance=new l(e)),l.instance}static getInstance(){if(!l.instance)throw Error("LovelUnlockManager instance is not init");return l.instance}static new(e){return new l(e)}}let c=l,u=Object.entries({9999:"inner_default_other"}).reduce((e,[t,s])=>(e[s]=Number(t),e),{});Object.entries({AD_TYPE_REWARD:1,AD_TYPE_INTERSTITIAL:2}).reduce((e,[t,s])=>(e[s]=t,e),{});class d{static instance=null;_initSign="";_halfway=[{scene:u.inner_default_other,count:0}];_finished=[{scene:u.inner_default_other,count:0}];constructor(e){if(d.instance)return d.instance;this._initSign=e?.sign??"",this._halfway=[{scene:u.inner_default_other,count:0}],this._finished=[{scene:u.inner_default_other,count:0}],d.instance=this}initialize(e){}_halfwayUpdate(e){let t=this._halfway.find(t=>t.scene===e.scene);t?t.count+=1:this._halfway.push({scene:e.scene,count:1})}_halfwayGet(e){let t=e?.scenes??[];return(t.length>0?this._halfway.filter(e=>t.includes(e.scene)):this._halfway).reduce((e,t)=>e+t.count,0)}_halfwayReset(){this._halfway=[{scene:u.inner_default_other,count:0}]}_finishedUpdate(e){let t=this._finished.find(t=>t.scene===e.scene);t?t.count+=1:this._finished.push({scene:e.scene,count:1})}_finishedGet(e){let t=e?.scenes??[];return(t.length>0?this._finished.filter(e=>t.includes(e.scene)):this._finished).reduce((e,t)=>e+t.count,0)}_finishedReset(){this._finished=[{scene:u.inner_default_other,count:0}]}record(e){switch(e.type){case"halfway":this._halfwayUpdate(e);break;case"finished":this._finishedUpdate(e)}}rest(e){switch(e){case"halfway":this._halfwayReset();break;case"finished":this._finishedReset()}}get(e){switch(e.type){case"halfway":return this._halfwayGet(e);case"finished":return this._finishedGet(e);default:return null}}placeholder(){return null}static build(e){return d.instance||(d.instance=new d(e)),d.instance}static getInstance(){if(!d.instance)throw Error("RewardAdGlobalRecorder instance is not init");return d.instance}}let g=d;class _{static instance=null;_initSign="";_currScene=null;_sceneTypeObj={};constructor(e){if(_.instance)return _.instance;this._initSign=e?.sign??"",this._sceneTypeObj=e?.sceneTypeObj??{},_.instance=this}initialize(e){}addScene(e){return console.log("----------------------AD触发场景:--------------------",e),this._currScene=e,this}addSceneType(e=1){return this.addScene(this._sceneTypeObj[e]),this}getCurrentScene(){return this._currScene}placeholder(){return null}static build(e){return _.instance||(_.instance=new _(e)),_.instance}static getInstance(){if(!_.instance)throw Error("RewardAdSceneTriggerManager instance is not init");return _.instance}}let f=_;export{h as AdAnalyticsJS,n as CountRecorder,a as EventEmitter,e as Logger,c as LovelUnlockManager,r as PubSub,g as RewardAdGlobalRecorder,f as RewardAdSceneTriggerManager,i as SerializableError,s as Storage};
+class e{constructor(e={}){this.events={},this.queues={},this.onceEvents={},this.maxListeners=e.maxListeners||5,this.maxQueueSize=e.maxQueueSize||1,this.maxOnceEvents=e.maxOnceEvents||5}on(e,t){(this.events[e]||(this.events[e]=[]),this.events[e].length>=this.maxListeners)?console.warn(`EventEmitter: Maximum listeners (${this.maxListeners}) reached for event "${e}". Listener not added.`):(this.events[e].push(t),this.queues[e]&&this.queues[e].length>0&&(this.queues[e].forEach(e=>{t(...e)}),this.queues[e]=[]))}once(e,t){let s=(...r)=>{t(...r),this.off(e,s)};(this.onceEvents[e]||(this.onceEvents[e]=new Set),this.onceEvents[e].size>=this.maxOnceEvents)?console.warn(`EventEmitter: Maximum once events (${this.maxOnceEvents}) reached for event "${e}". Once listener not added.`):(this.onceEvents[e].add(s),this.on(e,s))}emit(e,...t){this.events[e]&&this.events[e].length>0?[...this.events[e]].forEach(e=>{e(...t)}):(this.queues[e]||(this.queues[e]=[]),this.queues[e].length>=this.maxQueueSize&&(console.warn(`EventEmitter: Maximum queue size (${this.maxQueueSize}) reached for event "${e}". Oldest event removed.`),this.queues[e].shift()),this.queues[e].push(t))}off(e,t){if(!t){this.events[e]=[],this.onceEvents[e]=new Set;return}this.events[e]=this.events[e].filter(e=>e!==t),this.onceEvents[e]&&this.onceEvents[e].delete(t)}removeAllListeners(e){e?(delete this.events[e],delete this.queues[e],delete this.onceEvents[e]):(this.events={},this.queues={},this.onceEvents={})}static geInstance(t){return this._instance||(this._instance=new e(t)),this._instance}}class t{constructor(e={}){let{prefix:t="Logger",level:s="log",enabled:r=!0}=e;this.prefix=t,this.enabled=r,this.levels={error:0,warn:1,info:2,log:3,debug:4},this.currentLevel=this.levels[s]||this.levels.log}enable(){this.enabled=!0}disable(){this.enabled=!1}isEnabled(){return this.enabled}setLevel(e){Object.prototype.hasOwnProperty.call(this.levels,e)&&(this.currentLevel=this.levels[e])}formatMessage(e,t){let s=new Date,r=`${s.getFullYear()}/${s.getMonth()+1}/${s.getDate()} ${s.getHours()}:${s.getMinutes()}:${s.getSeconds()}`;return`[${r}] [${e.toUpperCase()}] [${this.prefix}] ${t}`}_log(e,t,...s){if(!this.enabled)return;let r=this.levels[e];if(void 0!==r&&this.currentLevel>=r){let r=this.formatMessage(e,t);switch(e){case"error":console.error(r,...s);break;case"warn":console.warn(r,...s);break;case"info":console.info(r,...s);break;case"log":default:console.log(r,...s);break;case"debug":console.debug(r,...s)}}}error(e,...t){this._log("error",e,...t)}warn(e,...t){this._log("warn",e,...t)}info(e,...t){this._log("info",e,...t)}log(e,...t){this._log("log",e,...t)}debug(e,...t){this._log("debug",e,...t)}}class s{constructor(e={}){this.config={prefix:"storage_",expire:null,...e},this.logger=new t({prefix:"Storage"})}getTodayEndTimestamp(){let e=new Date;return new Date(e.getFullYear(),e.getMonth(),e.getDate(),23,59,59,999).getTime()}_setItem(e,t,s){let r=void 0!==s?s:this.config.expire;"today"===r&&(r=this.getTodayEndTimestamp()-Date.now());let i={value:t,expire:r,timestamp:Date.now()};try{tt.setStorageSync(e,JSON.stringify(i))}catch(e){console.error("Storage setItem error:",e)}}_getItem(e){try{let t=tt.getStorageSync(e);if(!t)return null;let s=JSON.parse(t);if(s.expire&&Date.now()-s.timestamp>s.expire)return this.removeItem(e),null;return s.value}catch(e){return console.error("Storage getItem error:",e),null}}setItem(e,t,s){let r=this.config.prefix+e;return this._setItem(r,t,s)}getItem(e){let t=this.config.prefix+e;return this._getItem(t)}getUserItem(e){let t=this.config.userId??"null";if("null"===t)return this.logger.error("userId is required"),null;let s=`${this.config.prefix}_${t}_${e}`;return this._getItem(s)}setUserItem(e,t,s){let r=this.config.userId??"null";if("null"===r)return void this.logger.error("userId is required");let i=`${this.config.prefix}_${r}_${e}`;return this._setItem(i,t,s)}removeItem(e){try{tt.removeStorageSync(e)}catch(e){console.error("Storage removeItem error:",e)}}clear(){try{tt.clearStorageSync()}catch(e){console.error("Storage clear error:",e)}}keys(){try{let e=[];return(tt.getStorageInfoSync().keys??[]).forEach(t=>{if(t.startsWith(this.config.prefix)){let s=JSON.parse(tt.getStorageSync(t));(!s.expire||Date.now()-s.timestamp<=s.expire)&&e.push(t.replace(this.config.prefix,""))}}),e}catch(e){return console.error("Storage keys error:",e),[]}}static new(e){return new s(e)}}let r=s;class i{_total=0;_local_sign="";_expire="today";constructor(e){if(this.storage=r.new({userId:e.userId}),!e.local_sign)throw Error("local_sign is required");this._local_sign=e.local_sign,this._total=e.total??0,this._expire=e.expire??"today",this._init()}_init(){this._initLocalTimes()}_adTimes(){return this._total}_safeLocalValue(e){return"object"!=typeof e||null===e?{}:e}_initLocalTimes(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),s=this._safeLocalValue(t);s&&(null==s?void 0:s.total)==e||this.storage.setUserItem(this._local_sign,{total:e,today:(null==s?void 0:s.today)??0},this._expire)}updateToday(){let e=this._adTimes(),t=this.storage.getUserItem(this._local_sign),s=this._safeLocalValue(t),r=(null==s?void 0:s.today)??0;this.storage.setUserItem(this._local_sign,{total:e,today:r+1},this._expire)}remain(){let e=this.storage.getUserItem(this._local_sign),t=this._safeLocalValue(e),s=(null==t?void 0:t.today)??0;return Number((null==t?void 0:t.total)??0)-Number(s)}static new(e){return new i(e)}}class n{constructor(){this.events={}}on(e,t){return this.events[e]||(this.events[e]=[]),this.events[e].push(t),()=>{this.off(e,t)}}off(e,t){if(this.events[e]){if(!t){this.events[e]=[];return}this.events[e]=this.events[e].filter(e=>e!==t)}}emit(e,...t){this.events[e]&&this.events[e].forEach(s=>{try{s(...t)}catch(t){console.error(`Error in event listener for ${e}:`,t)}})}once(e,t){let s=(...r)=>{t(...r),this.off(e,s)};this.on(e,s)}listenerCount(e){return this.events[e]?this.events[e].length:0}removeAllListeners(){this.events={}}}class o extends Error{constructor(e,t={}){super(e),this.name=this.constructor.name,this.stack=Error(e).stack,this.errMsg=t.errMsg,this.errorCode=t.errorCode,Object.defineProperty(this,"message",{enumerable:!0}),Object.defineProperty(this,"name",{enumerable:!0}),Object.defineProperty(this,"stack",{enumerable:!0}),Object.defineProperty(this,"errMsg",{enumerable:!0}),Object.defineProperty(this,"errorCode",{enumerable:!0})}toJSON(){return{name:this.name,message:this.message,stack:this.stack,errMsg:this.errMsg,errorCode:this.errorCode}}}export{i as CountRecorder,e as EventEmitter,t as Logger,n as PubSub,o as SerializableError,r as Storage};

package/package.json

@@ -1,13 +1,8 @@
 {
   "name": "@ad-execute-manager/helper",
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0-alpha.2",
+  "description": "A collection of utility helper classes for JavaScript applications including EventEmitter, Logger, Storage, CountRecorder, PubSub, and SerializableError.",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -15,10 +10,58 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "author": "singcl",
+  "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/@ad-execute-manager/helper",
-  "peerDependencies": {
-    "@singcl/ad-execute-manager": ">=2.0.0"
+  "homepage": "https://npmjs.com/package/@singcl/helper",
+  "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": [
+    "helper",
+    "event-emitter",
+    "logger",
+    "storage",
+    "count-recorder",
+    "pubsub",
+    "serializable-error",
+    "utilities",
+    "javascript",
+    "nodejs"
+  ],
+  "scripts": {
+    "build": "rslib build && tsc",
+    "dev": "rslib build --watch",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "rstest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@babel/eslint-parser": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@eslint/js": "^9.39.1",
+    "@rslib/core": "^0.18.5",
+    "@rstest/core": "^0.7.2",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.3",
+    "typescript": "^5.9.3"
   }
 }

package/dist/ad/InterstitialAdFather.d.ts

@@ -1,131 +0,0 @@
-export default InterstitialAdFather;
-export type IRewordAdConfig = import("../typings/ad.js").IRewordAdConfig;
-export type CallbackCollection = import("../typings/ad.js").CallbackCollection;
-export type IConstructArgs = import("../typings/ad.js").IConstructArgs;
-export type IRewardedVideoAd = {
-    /**
-     * 显示激励视频广告
-     */
-    show: () => Promise<void>;
-};
-/**
- * @typedef IRewardedVideoAd
- * @property {() => Promise.<void>} show 显示激励视频广告
- */
-declare class InterstitialAdFather {
-    /** @type {IRewordAdConfig | null} */
-    static args: IRewordAdConfig | null;
-    /**
-     * @param {IRewordAdConfig} args
-     */
-    static buildArgs(args: IRewordAdConfig): void;
-    /**
-     * 使用管理器执行广告
-     * @param {Object} adInstance 广告实例
-     * @param {Object} ctx 上下文对象，用于传递数据和状态
-     * @param {Object} ctx.options 广告执行选项
-     * @param {Object} ctx.options.log 是否打印日志
-     * @param {Object} ctx.collection 回调集合
-     * @returns {Promise} 广告执行结果的Promise
-     */
-    static executeWithManager(adInstance: any, ctx: {
-        options: {
-            log: any;
-        };
-        collection: any;
-    }): Promise<any>;
-    /**
-     * @param {IConstructArgs} args
-     */
-    constructor(args: IConstructArgs);
-    _initSign: string;
-    _preserveOnEnd: boolean;
-    _interstitialAd: any;
-    _ttErrorMsgs: string[];
-    _ttErrorCodes: number[];
-    _adConfig: {};
-    /**
-     * 初始化
-     * 子类可以选择覆盖此方法，或使用默认实现
-     * @param {IRewordAdConfig} params
-     * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
-     * @returns {this} 当前实例
-     */
-    initialize(params: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
-    initialized(): boolean;
-    /**
-     * 执行广告展示
-     * @abstract
-     * @param {Object} [ctx] 上下文对象，用于传递数据和状态
-     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
-     * @param {CallbackCollection} [ctx.collection] 回调集合
-     * @param {Function} next 执行下一个任务的回调函数，在洋葱模型中手动调用以继续执行流程
-     * @returns {Promise<unknown>} 广告执行结果的Promise
-     * @throws {Error} 子类必须实现此方法
-     */
-    ad(ctx?: {
-        options?: IRewordAdConfig;
-        collection?: CallbackCollection;
-    }, next?: Function): Promise<unknown>;
-    /**
-     * 确保广告按顺序执行
-     * @param {Object} [ctx] 上下文对象，用于传递数据和状态
-     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
-     * @param {CallbackCollection} [ctx.collection] 回调集合
-     * @returns {Promise.<unknown>} 广告执行结果的Promise
-     */
-    addExecuteManager(ctx?: {
-        options?: IRewordAdConfig;
-        collection?: CallbackCollection;
-    }): Promise<unknown>;
-    destroy(): void;
-    /**
-     * 清理广告实例
-     * @abstract 清理广告实例，子类必须实现此方法
-     */
-    clear(): void;
-    /**
-     * 任务执行完成后始终执行的一个方法
-     * @abstract 任务执行完成后始终执行的一个方法，子类需要用到时实现此方法
-     * @param {object} [_args] 执行结果信息
-     */
-    record(_args?: object): this;
-    /**
-     *
-     * @param {({isEnded: boolean, count: number}) => void} callback
-     */
-    onClose(callback: ({ isEnded: boolean, count: number }: any) => void): void;
-    /**
-     *
-     * @param {({isEnded: boolean, count: number}) => void} callback
-     */
-    offClose(callback: ({ isEnded: boolean, count: number }: any) => void): void;
-    /**
-     * show
-     * @returns { Promise.<void>}
-     * @params {{errMsg: string; errCode: number}} err
-     */
-    show(): Promise<void>;
-    /**
-     * load
-     * @returns { Promise.<void>}
-     */
-    load(): Promise<void>;
-    /**
-     *
-     * @param {({errMsg: string; errCode: number}) => void} callback
-     */
-    onError(callback: any): void;
-    /**
-     *
-     * @param {({errMsg: string; errCode: number}) => void} callback
-     */
-    offError(callback: any): void;
-    onLoad(callback: any): void;
-    offLoad(callback: any): void;
-    /**
-     * 站位方法，没有任何左右
-     * @returns
-     */
-    placeholder(): any;
-}