@asaidimu/utils-sync 2.3.0 → 2.3.2

package/index.js

@@ -1 +1 @@
-"use strict";var e=require("@asaidimu/utils-error"),t=class t extends e.SystemError{constructor(e,i){super({code:"SYNC_ERROR",message:e,cause:i}),this.name="SyncError",Object.setPrototypeOf(this,t.prototype)}},i=class e extends t{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name="TimeoutError",Object.setPrototypeOf(this,e.prototype)}},r=class e extends t{constructor(t){super("[Serializer] The serializer has been marked as done!",t),this.name="SerializerExecutionDone",Object.setPrototypeOf(this,e.prototype)}},s=class{_locked=!1;_capacity;_yieldMode;waiters=[];constructor(e){this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??"macrotask"}async lock(e){if(!this._locked)return void(this._locked=!0);if(this.waiters.length>=this._capacity)throw new Error(`Mutex queue is full (capacity: ${this._capacity})`);let t;const r=new Promise(e=>t=e);if(this.waiters.push(t),null==e)return void await r;let s;await Promise.race([r.then(()=>clearTimeout(s)),new Promise((r,n)=>{s=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),n(new i("Mutex lock timed out"))},e)})])}tryLock(){return!this._locked&&(this._locked=!0,!0)}unlock(){if(!this._locked)throw new Error("Mutex is not locked");const e=this.waiters.shift();e?"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0):this._locked=!1}locked(){return this._locked}pending(){return this.waiters.length}},n=class{mutex=new s({yieldMode:"microtask"});promise=null;_value=null;_error;_done=!1;retry;throws;constructor({retry:e,throws:t}={}){this.retry=Boolean(e),this.throws=Boolean(t)}resolve(e){if(this._done)throw new Error("Cannot resolve: operation is already completed.");if(this.running())throw new Error("Cannot resolve: operation is currently running.");this._value=e,this._done=!0}async do(e,t){return this._done?this.peek():this.promise?this._awaitWithTimeout(this.promise,t,"Once do() timed out"):(await this.mutex.lock(),this.promise?(this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")):(this.promise=(async()=>{try{this._value=await e(),this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.retry&&!this._done&&(this.promise=null)}return this.peek()})(),this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")))}doSync(e){if(this._done){if(this.throws&&this._error)throw this._error;return this.peek()}if(this.promise){const e=new Error("Cannot execute doSync while an async operation is pending.");if(this.throws)throw e;return{value:null,error:e}}if(!this.mutex.tryLock()){const e=new Error("Cannot execute doSync: lock is currently held.");if(this.throws)throw e;return{value:null,error:e}}if(this.promise||this._done){if(this.mutex.unlock(),this._done){if(this.throws&&this._error)throw this._error;return this.peek()}const e=new Error("Cannot execute doSync while an async operation is pending.");if(this.throws)throw e;return{value:null,error:e}}try{const t=e();this._value=t,this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.mutex.unlock()}return this.peek()}running(){return null!==this.promise&&!this.done()}peek(){return{value:this._value,error:this._error}}get(){if(!this._done)throw new Error("Once operation is not yet complete");if(this._error)throw this._error;return this._value}reset(){if(this.running())throw new Error("Cannot reset Once while an operation is in progress.");this._done=!1,this.promise=null,this._value=null,this._error=void 0}done(){return this._done}current(){return this.promise}_awaitWithTimeout(e,t,r="Operation timed out"){if(null==t)return e;let s;return Promise.race([e.then(e=>(clearTimeout(s),e)),new Promise((e,n)=>{s=setTimeout(()=>n(new i(r)),t)})])}};exports.Debouncer=class{_delay;_leading;_timer;_pendingFn;_pendingResolvers=[];_leadingFired=!1;constructor(e){this._delay=e?.delay??300,this._leading=e?.leading??!1}do(e){return new Promise(t=>{this._enqueue(e,t)})}fire(e){this._enqueue(e,void 0)}_enqueue(e,t){if(this._pendingFn=e,t&&this._pendingResolvers.push(t),this._leading&&!this._leadingFired)return this._leadingFired=!0,this._fire(),clearTimeout(this._timer),void(this._timer=setTimeout(()=>{this._leadingFired=!1,void 0!==this._pendingFn&&this._fire()},this._delay));clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._fire()},this._delay)}cancel(){clearTimeout(this._timer),this._timer=void 0,this._pendingFn=void 0,this._leadingFired=!1;const e=this._pendingResolvers.splice(0);for(const t of e)t({status:"cancelled"})}async flush(){return this._pendingFn?(clearTimeout(this._timer),this._timer=void 0,this._leadingFired=!1,this._fire()):null}pending(){return void 0!==this._pendingFn}async _fire(){const e=this._pendingFn,t=this._pendingResolvers.splice(0);let i;this._pendingFn=void 0;try{i={status:"ok",value:await e()}}catch(e){i={status:"error",error:e}}for(const e of t)e(i);return i}},exports.Latch=class{_open=!1;_resolve;_promise;constructor(){this._promise=new Promise(e=>{this._resolve=e})}open(){this._open||(this._open=!0,this._resolve())}async wait(e){if(this._open)return;if(null==e)return this._promise;let t;await Promise.race([this._promise.then(()=>clearTimeout(t)),new Promise((r,s)=>{t=setTimeout(()=>s(new i("Latch timed out")),e)})])}isOpen(){return this._open}},exports.Mutex=s,exports.Once=n,exports.OnceExecutionConflict=class e extends t{constructor(t){super("[Once] A method has already been registered!",t),this.name="OnceExecutionConflict",Object.setPrototypeOf(this,e.prototype)}},exports.RWMutex=class{_readers=0;_writeLocked=!1;_pendingWriters=0;_yieldMode;readerWaiters=[];writerWaiters=[];constructor(e){this._yieldMode=e?.yieldMode??"microtask"}async rlock(e){if(!this._writeLocked&&0===this._pendingWriters)return void this._readers++;let t;const r=new Promise(e=>t=e);if(this.readerWaiters.push(t),null==e)return void await r;let s;await Promise.race([r.then(()=>clearTimeout(s)),new Promise((r,n)=>{s=setTimeout(()=>{const e=this.readerWaiters.indexOf(t);-1!==e&&this.readerWaiters.splice(e,1),n(new i("RWMutex rlock timed out"))},e)})])}runlock(){if(this._readers<=0)throw new Error("RWMutex: runlock called without a matching rlock");this._readers--,this._tryWakeWriter()}async lock(e){if(!this._writeLocked&&0===this._readers)return void(this._writeLocked=!0);let t;this._pendingWriters++;const r=new Promise(e=>t=e);if(this.writerWaiters.push(t),null==e)return void await r;let s;await Promise.race([r.then(()=>clearTimeout(s)),new Promise((r,n)=>{s=setTimeout(()=>{const e=this.writerWaiters.indexOf(t);-1!==e&&(this.writerWaiters.splice(e,1),this._pendingWriters--),n(new i("RWMutex lock timed out"))},e)})])}unlock(){if(!this._writeLocked)throw new Error("RWMutex: unlock called without a matching lock");this._writeLocked=!1,this._tryWakeWriter()||this._wakeAllReaders()}async read(e,t){await this.rlock(t);try{return await e()}finally{this.runlock()}}async write(e,t){await this.lock(t);try{return await e()}finally{this.unlock()}}writeLocked(){return this._writeLocked}readers(){return this._readers}pendingWriters(){return this._pendingWriters}pendingReaders(){return this.readerWaiters.length}_tryWakeWriter(){if(this._writeLocked||this._readers>0)return!1;const e=this.writerWaiters.shift();return!!e&&(this._writeLocked=!0,this._pendingWriters--,this._schedule(e),!0)}_wakeAllReaders(){const e=this.readerWaiters.splice(0);if(0!==e.length){this._readers+=e.length;for(const t of e)this._schedule(t)}}_schedule(e){"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0)}},exports.ResourceRegistry=class{entries=new Map;resourceToOnce=new WeakMap;finalizer;onCreate;onCreateSync;onDispose;onEvict;constructor(e){if(this.onCreate=e.onCreate,this.onCreateSync=e.onCreateSync,this.onDispose=e.onDispose,this.onEvict=e.onEvict,!this.onCreate&&!this.onCreateSync)throw new Error("[ResourceRegistry] Must provide either `onCreate` or `onCreateSync`.");this.finalizer=new FinalizationRegistry(({key:e,ref:t})=>{this.entries.get(e)===t&&(this.entries.delete(e),this.onEvict?.(e))})}async get(e,t,i){if(!this.onCreate)throw new Error('[ResourceRegistry] Async get() called, but no "onCreate" factory provided.');let r=this.entries.get(e),s=r?.deref();if(!s){s=new n({throws:!1});const t=new WeakRef(s);this.entries.set(e,t),this.finalizer.register(s,{key:e,ref:t},s)}const o=await s.do(()=>this.onCreate(e,t),i);if(o.error)throw this.entries.get(e)?.deref()===s&&(this.entries.delete(e),this.finalizer.unregister(s)),o.error;const a=o.value;return this.resourceToOnce.set(a,s),a}getSync(e,t){if(!this.onCreateSync)throw new Error('[ResourceRegistry] Sync get() called, but no "onCreateSync" factory provided.');let i=this.entries.get(e),r=i?.deref();if(!r){r=new n({throws:!1});const t=new WeakRef(r);this.entries.set(e,t),this.finalizer.register(r,{key:e,ref:t},r)}const s=r.doSync(()=>this.onCreateSync(e,t));if(s.error)throw this.entries.get(e)?.deref()===r&&(this.entries.delete(e),this.finalizer.unregister(r)),s.error;const o=s.value;return this.resourceToOnce.set(o,r),o}async release(e){const t=this.entries.get(e);if(!t)return!1;try{const e=t.deref();if(e&&(this.finalizer.unregister(e),e.done())){const t=e.get();t&&this.onDispose&&(await this.onDispose(t),this.resourceToOnce.delete(t))}}catch(e){throw e}finally{this.entries.delete(e)}return!0}async clear(){for(const e of this.entries.values()){const t=e.deref();if(t&&(this.finalizer.unregister(t),t.done()&&this.onDispose)){const e=t.get();e&&(await this.onDispose(e),this.resourceToOnce.delete(e))}}this.entries.clear()}has(e){return this.entries.has(e)}get size(){return this.entries.size}},exports.Semaphore=class{_slots;_available;_capacity;_yieldMode;waiters=[];constructor(e){if(this._slots=e?.slots??1,this._available=this._slots,this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??"macrotask",this._slots<1)throw new Error("Semaphore slots must be >= 1")}async acquire(e){if(this._available>0)return void this._available--;if(this.waiters.length>=this._capacity)throw new Error(`Semaphore queue is full (capacity: ${this._capacity})`);let t;const r=new Promise(e=>t=e);if(this.waiters.push(t),null==e)return void await r;let s;await Promise.race([r.then(()=>clearTimeout(s)),new Promise((r,n)=>{s=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),n(new i("Semaphore acquire timed out"))},e)})])}tryAcquire(){return this._available>0&&(this._available--,!0)}release(){if(this._available>=this._slots)throw new Error("Semaphore released more times than acquired");const e=this.waiters.shift();e?"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0):this._available++}async run(e,t){await this.acquire(t);try{return await e()}finally{this.release()}}available(){return this._available}pending(){return this.waiters.length}slots(){return this._slots}},exports.Serializer=class{mutex;_done=!1;_lastValue=null;_lastError=void 0;_hasRun=!1;constructor(e){this.mutex=new s({capacity:e?.capacity??1e3,yieldMode:e?.yieldMode??"macrotask"})}async do(e,t){if(this._done)return{value:null,error:new r};try{await this.mutex.lock(t)}catch(e){return{value:null,error:e}}let i,s=null;try{if(this._done)throw new r;s=await e(),this._lastValue=s,this._lastError=void 0,this._hasRun=!0}catch(e){i=e,this._lastError=e,this._hasRun=!0}finally{this.mutex.unlock()}return{value:s,error:i}}peek(){return{value:this._lastValue,error:this._lastError}}hasRun(){return this._hasRun}close(){this._done=!0}pending(){return this.mutex.pending()}running(){return this.mutex.locked()}},exports.SerializerExecutionDone=r,exports.SharedResource=class{constructor(e,t,i={}){this.factory=e,this.onCleanup=t,this.options=i}_count=0;init=new n({retry:!1,throws:!1});pendingMicrotask=!1;cleanupTimer;get subscribers(){return this._count}async acquire(){this.cancelPendingCleanup(),this._count++;const e=await this.init.do(this.factory);if(e.error)throw e.error;return e.value}release(){this._count<=0?console.warn("SharedResource.release() called, but count is already 0."):(this._count--,0===this._count&&this.scheduleCleanup())}peek(){const e=this.init.peek();return e.error?null:e.value}forceCleanup(){this.cancelPendingCleanup(),this._count=0,this.executeCleanup()}cancelPendingCleanup(){this.pendingMicrotask=!1,void 0!==this.cleanupTimer&&(clearTimeout(this.cleanupTimer),this.cleanupTimer=void 0)}scheduleCleanup(){const e=this.options.gracePeriod??"microtask";if("sync"!==e)return"microtask"===e?(this.pendingMicrotask=!0,void queueMicrotask(()=>{!this.pendingMicrotask||this._count>0||(this.pendingMicrotask=!1,this.executeCleanup())})):void(this.cleanupTimer=setTimeout(()=>{this.cleanupTimer=void 0,this._count>0||this.executeCleanup()},e));this.executeCleanup()}executeCleanup(){const e=this.init.peek();try{this.onCleanup(e.value)}catch(e){console.error("[SharedResource] Error during cleanup callback:",e)}this.init.running()||this.init.reset()}},exports.SyncError=t,exports.TimeoutError=i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@asaidimu/utils-error");var t=class{_delay;_leading;_timer;_pendingFn;_pendingResolvers=[];_leadingFired=!1;constructor(e){this._delay=e?.delay??300,this._leading=e?.leading??!1}do(e){return new Promise(t=>{this._enqueue(e,t)})}fire(e){this._enqueue(e,void 0)}_enqueue(e,t){if(this._pendingFn=e,t&&this._pendingResolvers.push(t),this._leading&&!this._leadingFired){this._leadingFired=!0,this._fire(),clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._pendingFn!==void 0&&this._fire()},this._delay);return}clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._fire()},this._delay)}cancel(){clearTimeout(this._timer),this._timer=void 0,this._pendingFn=void 0,this._leadingFired=!1;let e=this._pendingResolvers.splice(0);for(let t of e)t({status:`cancelled`})}async flush(){return this._pendingFn?(clearTimeout(this._timer),this._timer=void 0,this._leadingFired=!1,this._fire()):null}pending(){return this._pendingFn!==void 0}async _fire(){let e=this._pendingFn,t=this._pendingResolvers.splice(0);this._pendingFn=void 0;let n;try{n={status:`ok`,value:await e()}}catch(e){n={status:`error`,error:e}}for(let e of t)e(n);return n}},n=class t extends e.SystemError{constructor(e,n){super({code:`SYNC_ERROR`,message:e,cause:n}),this.name=`SyncError`,Object.setPrototypeOf(this,t.prototype)}},r=class e extends n{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name=`TimeoutError`,Object.setPrototypeOf(this,e.prototype)}},i=class e extends n{constructor(t){super(`[Once] A method has already been registered!`,t),this.name=`OnceExecutionConflict`,Object.setPrototypeOf(this,e.prototype)}},a=class e extends n{constructor(t){super(`[Serializer] The serializer has been marked as done!`,t),this.name=`SerializerExecutionDone`,Object.setPrototypeOf(this,e.prototype)}},o=class{_open=!1;_resolve;_promise;constructor(){this._promise=new Promise(e=>{this._resolve=e})}open(){this._open||(this._open=!0,this._resolve())}async wait(e){if(this._open)return;if(e==null)return this._promise;let t;await Promise.race([this._promise.then(()=>clearTimeout(t)),new Promise((n,i)=>{t=setTimeout(()=>i(new r(`Latch timed out`)),e)})])}isOpen(){return this._open}},s=class{_locked=!1;_capacity;_yieldMode;waiters=[];constructor(e){this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??`macrotask`}async lock(e){if(!this._locked){this._locked=!0;return}if(this.waiters.length>=this._capacity)throw Error(`Mutex queue is full (capacity: ${this._capacity})`);let t,n=new Promise(e=>t=e);if(this.waiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),a(new r(`Mutex lock timed out`))},e)})])}tryLock(){return this._locked?!1:(this._locked=!0,!0)}unlock(){if(!this._locked)throw Error(`Mutex is not locked`);let e=this.waiters.shift();e?this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0):this._locked=!1}locked(){return this._locked}pending(){return this.waiters.length}},c=class{mutex=new s({yieldMode:`microtask`});promise=null;_value=null;_error;_done=!1;retry;throws;constructor({retry:e,throws:t}={}){this.retry=!!e,this.throws=!!t}resolve(e){if(this._done)throw Error(`Cannot resolve: operation is already completed.`);if(this.running())throw Error(`Cannot resolve: operation is currently running.`);this._value=e,this._done=!0}async do(e,t){return this._done?this.peek():this.promise?this._awaitWithTimeout(this.promise,t,`Once do() timed out`):(await this.mutex.lock(),this.promise?(this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,`Once do() timed out`)):(this.promise=(async()=>{try{this._value=await e(),this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.retry&&!this._done&&(this.promise=null)}return this.peek()})(),this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,`Once do() timed out`)))}doSync(e){if(this._done){if(this.throws&&this._error)throw this._error;return this.peek()}if(this.promise){let e=Error(`Cannot execute doSync while an async operation is pending.`);if(this.throws)throw e;return{value:null,error:e}}if(!this.mutex.tryLock()){let e=Error(`Cannot execute doSync: lock is currently held.`);if(this.throws)throw e;return{value:null,error:e}}if(this.promise||this._done){if(this.mutex.unlock(),this._done){if(this.throws&&this._error)throw this._error;return this.peek()}let e=Error(`Cannot execute doSync while an async operation is pending.`);if(this.throws)throw e;return{value:null,error:e}}try{let t=e();this._value=t,this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.mutex.unlock()}return this.peek()}running(){return this.promise!==null&&!this.done()}peek(){return{value:this._value,error:this._error}}get(){if(!this._done)throw Error(`Once operation is not yet complete`);if(this._error)throw this._error;return this._value}reset(){if(this.running())throw Error(`Cannot reset Once while an operation is in progress.`);this._done=!1,this.promise=null,this._value=null,this._error=void 0}done(){return this._done}current(){return this.promise}_awaitWithTimeout(e,t,n=`Operation timed out`){if(t==null)return e;let i;return Promise.race([e.then(e=>(clearTimeout(i),e)),new Promise((e,a)=>{i=setTimeout(()=>a(new r(n)),t)})])}},l=class{_readers=0;_writeLocked=!1;_pendingWriters=0;_yieldMode;readerWaiters=[];writerWaiters=[];constructor(e){this._yieldMode=e?.yieldMode??`microtask`}async rlock(e){if(!this._writeLocked&&this._pendingWriters===0){this._readers++;return}let t,n=new Promise(e=>t=e);if(this.readerWaiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.readerWaiters.indexOf(t);e!==-1&&this.readerWaiters.splice(e,1),a(new r(`RWMutex rlock timed out`))},e)})])}runlock(){if(this._readers<=0)throw Error(`RWMutex: runlock called without a matching rlock`);this._readers--,this._tryWakeWriter()}async lock(e){if(!this._writeLocked&&this._readers===0){this._writeLocked=!0;return}this._pendingWriters++;let t,n=new Promise(e=>t=e);if(this.writerWaiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.writerWaiters.indexOf(t);e!==-1&&(this.writerWaiters.splice(e,1),this._pendingWriters--),a(new r(`RWMutex lock timed out`))},e)})])}unlock(){if(!this._writeLocked)throw Error(`RWMutex: unlock called without a matching lock`);this._writeLocked=!1,this._tryWakeWriter()||this._wakeAllReaders()}async read(e,t){await this.rlock(t);try{return await e()}finally{this.runlock()}}async write(e,t){await this.lock(t);try{return await e()}finally{this.unlock()}}writeLocked(){return this._writeLocked}readers(){return this._readers}pendingWriters(){return this._pendingWriters}pendingReaders(){return this.readerWaiters.length}_tryWakeWriter(){if(this._writeLocked||this._readers>0)return!1;let e=this.writerWaiters.shift();return e?(this._writeLocked=!0,this._pendingWriters--,this._schedule(e),!0):!1}_wakeAllReaders(){let e=this.readerWaiters.splice(0);if(e.length!==0){this._readers+=e.length;for(let t of e)this._schedule(t)}}_schedule(e){this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0)}},u=class{_slots;_available;_capacity;_yieldMode;waiters=[];constructor(e){if(this._slots=e?.slots??1,this._available=this._slots,this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??`macrotask`,this._slots<1)throw Error(`Semaphore slots must be >= 1`)}async acquire(e){if(this._available>0){this._available--;return}if(this.waiters.length>=this._capacity)throw Error(`Semaphore queue is full (capacity: ${this._capacity})`);let t,n=new Promise(e=>t=e);if(this.waiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),a(new r(`Semaphore acquire timed out`))},e)})])}tryAcquire(){return this._available>0?(this._available--,!0):!1}release(){if(this._available>=this._slots)throw Error(`Semaphore released more times than acquired`);let e=this.waiters.shift();e?this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0):this._available++}async run(e,t){await this.acquire(t);try{return await e()}finally{this.release()}}available(){return this._available}pending(){return this.waiters.length}slots(){return this._slots}},d=class{mutex;_closed=!1;_lastValue=null;_lastError=void 0;_hasRun=!1;_closeOnce=new c;constructor(e){this.mutex=new s({capacity:e?.capacity??1e3,yieldMode:e?.yieldMode??`macrotask`})}async do(e,t){return this._closed?{value:null,error:new a}:this._enqueue(e,t)}close(){return this._closed=!0,this._closeOnce.do(async()=>this._enqueue((()=>{})))}done(){return this._closeOnce.done()}peek(){return{value:this._lastValue,error:this._lastError}}hasRun(){return this._hasRun}pending(){return this.mutex.pending()}running(){return this.mutex.locked()}async _enqueue(e,t){try{await this.mutex.lock(t)}catch(e){return{value:null,error:e}}let n=null,r;try{n=await e(),this._lastValue=n,this._lastError=void 0,this._hasRun=!0}catch(e){r=e,this._lastError=e,this._hasRun=!0}finally{this.mutex.unlock()}return{value:n,error:r}}},f=class{factory;onCleanup;options;_count=0;init=new c({retry:!1,throws:!1});pendingMicrotask=!1;cleanupTimer;constructor(e,t,n={}){this.factory=e,this.onCleanup=t,this.options=n}get subscribers(){return this._count}async acquire(){this.cancelPendingCleanup(),this._count++;let e=await this.init.do(this.factory);if(e.error)throw e.error;return e.value}release(){if(this._count<=0){console.warn(`SharedResource.release() called, but count is already 0.`);return}this._count--,this._count===0&&this.scheduleCleanup()}peek(){let e=this.init.peek();return e.error?null:e.value}forceCleanup(){this.cancelPendingCleanup(),this._count=0,this.executeCleanup()}cancelPendingCleanup(){this.pendingMicrotask=!1,this.cleanupTimer!==void 0&&(clearTimeout(this.cleanupTimer),this.cleanupTimer=void 0)}scheduleCleanup(){let e=this.options.gracePeriod??`microtask`;if(e===`sync`){this.executeCleanup();return}if(e===`microtask`){this.pendingMicrotask=!0,queueMicrotask(()=>{!this.pendingMicrotask||this._count>0||(this.pendingMicrotask=!1,this.executeCleanup())});return}this.cleanupTimer=setTimeout(()=>{this.cleanupTimer=void 0,!(this._count>0)&&this.executeCleanup()},e)}executeCleanup(){let e=this.init.peek();try{this.onCleanup(e.value)}catch(e){console.error(`[SharedResource] Error during cleanup callback:`,e)}this.init.running()||this.init.reset()}},p=class{entries=new Map;resourceToOnce=new WeakMap;finalizer;onCreate;onCreateSync;onDispose;onEvict;constructor(e){if(this.onCreate=e.onCreate,this.onCreateSync=e.onCreateSync,this.onDispose=e.onDispose,this.onEvict=e.onEvict,!this.onCreate&&!this.onCreateSync)throw Error("[ResourceRegistry] Must provide either `onCreate` or `onCreateSync`.");this.finalizer=new FinalizationRegistry(({key:e,ref:t})=>{this.entries.get(e)===t&&(this.entries.delete(e),this.onEvict?.(e))})}async get(e,t,n){if(!this.onCreate)throw Error(`[ResourceRegistry] Async get() called, but no "onCreate" factory provided.`);let r=this.entries.get(e)?.deref();if(!r){r=new c({throws:!1});let t=new WeakRef(r);this.entries.set(e,t),this.finalizer.register(r,{key:e,ref:t},r)}let i=await r.do(()=>this.onCreate(e,t),n);if(i.error)throw this.entries.get(e)?.deref()===r&&(this.entries.delete(e),this.finalizer.unregister(r)),i.error;let a=i.value;return this.resourceToOnce.set(a,r),a}getSync(e,t){if(!this.onCreateSync)throw Error(`[ResourceRegistry] Sync get() called, but no "onCreateSync" factory provided.`);let n=this.entries.get(e)?.deref();if(!n){n=new c({throws:!1});let t=new WeakRef(n);this.entries.set(e,t),this.finalizer.register(n,{key:e,ref:t},n)}let r=n.doSync(()=>this.onCreateSync(e,t));if(r.error)throw this.entries.get(e)?.deref()===n&&(this.entries.delete(e),this.finalizer.unregister(n)),r.error;let i=r.value;return this.resourceToOnce.set(i,n),i}async release(e){let t=this.entries.get(e);if(!t)return!1;try{let e=t.deref();if(e&&(this.finalizer.unregister(e),e.done())){let t=e.get();t&&this.onDispose&&(await this.onDispose(t),this.resourceToOnce.delete(t))}}catch(e){throw e}finally{this.entries.delete(e)}return!0}async clear(){for(let e of this.entries.values()){let t=e.deref();if(t&&(this.finalizer.unregister(t),t.done()&&this.onDispose)){let e=t.get();e&&(await this.onDispose(e),this.resourceToOnce.delete(e))}}this.entries.clear()}has(e){return this.entries.has(e)}get size(){return this.entries.size}};exports.Debouncer=t,exports.Latch=o,exports.Mutex=s,exports.Once=c,exports.OnceExecutionConflict=i,exports.RWMutex=l,exports.ResourceRegistry=p,exports.Semaphore=u,exports.Serializer=d,exports.SerializerExecutionDone=a,exports.SharedResource=f,exports.SyncError=n,exports.TimeoutError=r;

package/index.mjs

@@ -1 +1 @@
-import{SystemError as e}from"@asaidimu/utils-error";var t=class{_delay;_leading;_timer;_pendingFn;_pendingResolvers=[];_leadingFired=!1;constructor(e){this._delay=e?.delay??300,this._leading=e?.leading??!1}do(e){return new Promise(t=>{this._enqueue(e,t)})}fire(e){this._enqueue(e,void 0)}_enqueue(e,t){if(this._pendingFn=e,t&&this._pendingResolvers.push(t),this._leading&&!this._leadingFired)return this._leadingFired=!0,this._fire(),clearTimeout(this._timer),void(this._timer=setTimeout(()=>{this._leadingFired=!1,void 0!==this._pendingFn&&this._fire()},this._delay));clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._fire()},this._delay)}cancel(){clearTimeout(this._timer),this._timer=void 0,this._pendingFn=void 0,this._leadingFired=!1;const e=this._pendingResolvers.splice(0);for(const t of e)t({status:"cancelled"})}async flush(){return this._pendingFn?(clearTimeout(this._timer),this._timer=void 0,this._leadingFired=!1,this._fire()):null}pending(){return void 0!==this._pendingFn}async _fire(){const e=this._pendingFn,t=this._pendingResolvers.splice(0);let i;this._pendingFn=void 0;try{i={status:"ok",value:await e()}}catch(e){i={status:"error",error:e}}for(const e of t)e(i);return i}},i=class t extends e{constructor(e,i){super({code:"SYNC_ERROR",message:e,cause:i}),this.name="SyncError",Object.setPrototypeOf(this,t.prototype)}},r=class e extends i{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name="TimeoutError",Object.setPrototypeOf(this,e.prototype)}},s=class e extends i{constructor(t){super("[Once] A method has already been registered!",t),this.name="OnceExecutionConflict",Object.setPrototypeOf(this,e.prototype)}},n=class e extends i{constructor(t){super("[Serializer] The serializer has been marked as done!",t),this.name="SerializerExecutionDone",Object.setPrototypeOf(this,e.prototype)}},o=class{_open=!1;_resolve;_promise;constructor(){this._promise=new Promise(e=>{this._resolve=e})}open(){this._open||(this._open=!0,this._resolve())}async wait(e){if(this._open)return;if(null==e)return this._promise;let t;await Promise.race([this._promise.then(()=>clearTimeout(t)),new Promise((i,s)=>{t=setTimeout(()=>s(new r("Latch timed out")),e)})])}isOpen(){return this._open}},a=class{_locked=!1;_capacity;_yieldMode;waiters=[];constructor(e){this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??"macrotask"}async lock(e){if(!this._locked)return void(this._locked=!0);if(this.waiters.length>=this._capacity)throw new Error(`Mutex queue is full (capacity: ${this._capacity})`);let t;const i=new Promise(e=>t=e);if(this.waiters.push(t),null==e)return void await i;let s;await Promise.race([i.then(()=>clearTimeout(s)),new Promise((i,n)=>{s=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),n(new r("Mutex lock timed out"))},e)})])}tryLock(){return!this._locked&&(this._locked=!0,!0)}unlock(){if(!this._locked)throw new Error("Mutex is not locked");const e=this.waiters.shift();e?"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0):this._locked=!1}locked(){return this._locked}pending(){return this.waiters.length}},h=class{mutex=new a({yieldMode:"microtask"});promise=null;_value=null;_error;_done=!1;retry;throws;constructor({retry:e,throws:t}={}){this.retry=Boolean(e),this.throws=Boolean(t)}resolve(e){if(this._done)throw new Error("Cannot resolve: operation is already completed.");if(this.running())throw new Error("Cannot resolve: operation is currently running.");this._value=e,this._done=!0}async do(e,t){return this._done?this.peek():this.promise?this._awaitWithTimeout(this.promise,t,"Once do() timed out"):(await this.mutex.lock(),this.promise?(this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")):(this.promise=(async()=>{try{this._value=await e(),this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.retry&&!this._done&&(this.promise=null)}return this.peek()})(),this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")))}doSync(e){if(this._done){if(this.throws&&this._error)throw this._error;return this.peek()}if(this.promise){const e=new Error("Cannot execute doSync while an async operation is pending.");if(this.throws)throw e;return{value:null,error:e}}if(!this.mutex.tryLock()){const e=new Error("Cannot execute doSync: lock is currently held.");if(this.throws)throw e;return{value:null,error:e}}if(this.promise||this._done){if(this.mutex.unlock(),this._done){if(this.throws&&this._error)throw this._error;return this.peek()}const e=new Error("Cannot execute doSync while an async operation is pending.");if(this.throws)throw e;return{value:null,error:e}}try{const t=e();this._value=t,this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.mutex.unlock()}return this.peek()}running(){return null!==this.promise&&!this.done()}peek(){return{value:this._value,error:this._error}}get(){if(!this._done)throw new Error("Once operation is not yet complete");if(this._error)throw this._error;return this._value}reset(){if(this.running())throw new Error("Cannot reset Once while an operation is in progress.");this._done=!1,this.promise=null,this._value=null,this._error=void 0}done(){return this._done}current(){return this.promise}_awaitWithTimeout(e,t,i="Operation timed out"){if(null==t)return e;let s;return Promise.race([e.then(e=>(clearTimeout(s),e)),new Promise((e,n)=>{s=setTimeout(()=>n(new r(i)),t)})])}},c=class{_readers=0;_writeLocked=!1;_pendingWriters=0;_yieldMode;readerWaiters=[];writerWaiters=[];constructor(e){this._yieldMode=e?.yieldMode??"microtask"}async rlock(e){if(!this._writeLocked&&0===this._pendingWriters)return void this._readers++;let t;const i=new Promise(e=>t=e);if(this.readerWaiters.push(t),null==e)return void await i;let s;await Promise.race([i.then(()=>clearTimeout(s)),new Promise((i,n)=>{s=setTimeout(()=>{const e=this.readerWaiters.indexOf(t);-1!==e&&this.readerWaiters.splice(e,1),n(new r("RWMutex rlock timed out"))},e)})])}runlock(){if(this._readers<=0)throw new Error("RWMutex: runlock called without a matching rlock");this._readers--,this._tryWakeWriter()}async lock(e){if(!this._writeLocked&&0===this._readers)return void(this._writeLocked=!0);let t;this._pendingWriters++;const i=new Promise(e=>t=e);if(this.writerWaiters.push(t),null==e)return void await i;let s;await Promise.race([i.then(()=>clearTimeout(s)),new Promise((i,n)=>{s=setTimeout(()=>{const e=this.writerWaiters.indexOf(t);-1!==e&&(this.writerWaiters.splice(e,1),this._pendingWriters--),n(new r("RWMutex lock timed out"))},e)})])}unlock(){if(!this._writeLocked)throw new Error("RWMutex: unlock called without a matching lock");this._writeLocked=!1,this._tryWakeWriter()||this._wakeAllReaders()}async read(e,t){await this.rlock(t);try{return await e()}finally{this.runlock()}}async write(e,t){await this.lock(t);try{return await e()}finally{this.unlock()}}writeLocked(){return this._writeLocked}readers(){return this._readers}pendingWriters(){return this._pendingWriters}pendingReaders(){return this.readerWaiters.length}_tryWakeWriter(){if(this._writeLocked||this._readers>0)return!1;const e=this.writerWaiters.shift();return!!e&&(this._writeLocked=!0,this._pendingWriters--,this._schedule(e),!0)}_wakeAllReaders(){const e=this.readerWaiters.splice(0);if(0!==e.length){this._readers+=e.length;for(const t of e)this._schedule(t)}}_schedule(e){"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0)}},l=class{_slots;_available;_capacity;_yieldMode;waiters=[];constructor(e){if(this._slots=e?.slots??1,this._available=this._slots,this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??"macrotask",this._slots<1)throw new Error("Semaphore slots must be >= 1")}async acquire(e){if(this._available>0)return void this._available--;if(this.waiters.length>=this._capacity)throw new Error(`Semaphore queue is full (capacity: ${this._capacity})`);let t;const i=new Promise(e=>t=e);if(this.waiters.push(t),null==e)return void await i;let s;await Promise.race([i.then(()=>clearTimeout(s)),new Promise((i,n)=>{s=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),n(new r("Semaphore acquire timed out"))},e)})])}tryAcquire(){return this._available>0&&(this._available--,!0)}release(){if(this._available>=this._slots)throw new Error("Semaphore released more times than acquired");const e=this.waiters.shift();e?"microtask"===this._yieldMode?queueMicrotask(e):setTimeout(e,0):this._available++}async run(e,t){await this.acquire(t);try{return await e()}finally{this.release()}}available(){return this._available}pending(){return this.waiters.length}slots(){return this._slots}},u=class{mutex;_done=!1;_lastValue=null;_lastError=void 0;_hasRun=!1;constructor(e){this.mutex=new a({capacity:e?.capacity??1e3,yieldMode:e?.yieldMode??"macrotask"})}async do(e,t){if(this._done)return{value:null,error:new n};try{await this.mutex.lock(t)}catch(e){return{value:null,error:e}}let i,r=null;try{if(this._done)throw new n;r=await e(),this._lastValue=r,this._lastError=void 0,this._hasRun=!0}catch(e){i=e,this._lastError=e,this._hasRun=!0}finally{this.mutex.unlock()}return{value:r,error:i}}peek(){return{value:this._lastValue,error:this._lastError}}hasRun(){return this._hasRun}close(){this._done=!0}pending(){return this.mutex.pending()}running(){return this.mutex.locked()}},d=class{constructor(e,t,i={}){this.factory=e,this.onCleanup=t,this.options=i}_count=0;init=new h({retry:!1,throws:!1});pendingMicrotask=!1;cleanupTimer;get subscribers(){return this._count}async acquire(){this.cancelPendingCleanup(),this._count++;const e=await this.init.do(this.factory);if(e.error)throw e.error;return e.value}release(){this._count<=0?console.warn("SharedResource.release() called, but count is already 0."):(this._count--,0===this._count&&this.scheduleCleanup())}peek(){const e=this.init.peek();return e.error?null:e.value}forceCleanup(){this.cancelPendingCleanup(),this._count=0,this.executeCleanup()}cancelPendingCleanup(){this.pendingMicrotask=!1,void 0!==this.cleanupTimer&&(clearTimeout(this.cleanupTimer),this.cleanupTimer=void 0)}scheduleCleanup(){const e=this.options.gracePeriod??"microtask";if("sync"!==e)return"microtask"===e?(this.pendingMicrotask=!0,void queueMicrotask(()=>{!this.pendingMicrotask||this._count>0||(this.pendingMicrotask=!1,this.executeCleanup())})):void(this.cleanupTimer=setTimeout(()=>{this.cleanupTimer=void 0,this._count>0||this.executeCleanup()},e));this.executeCleanup()}executeCleanup(){const e=this.init.peek();try{this.onCleanup(e.value)}catch(e){console.error("[SharedResource] Error during cleanup callback:",e)}this.init.running()||this.init.reset()}},_=class{entries=new Map;resourceToOnce=new WeakMap;finalizer;onCreate;onCreateSync;onDispose;onEvict;constructor(e){if(this.onCreate=e.onCreate,this.onCreateSync=e.onCreateSync,this.onDispose=e.onDispose,this.onEvict=e.onEvict,!this.onCreate&&!this.onCreateSync)throw new Error("[ResourceRegistry] Must provide either `onCreate` or `onCreateSync`.");this.finalizer=new FinalizationRegistry(({key:e,ref:t})=>{this.entries.get(e)===t&&(this.entries.delete(e),this.onEvict?.(e))})}async get(e,t,i){if(!this.onCreate)throw new Error('[ResourceRegistry] Async get() called, but no "onCreate" factory provided.');let r=this.entries.get(e),s=r?.deref();if(!s){s=new h({throws:!1});const t=new WeakRef(s);this.entries.set(e,t),this.finalizer.register(s,{key:e,ref:t},s)}const n=await s.do(()=>this.onCreate(e,t),i);if(n.error)throw this.entries.get(e)?.deref()===s&&(this.entries.delete(e),this.finalizer.unregister(s)),n.error;const o=n.value;return this.resourceToOnce.set(o,s),o}getSync(e,t){if(!this.onCreateSync)throw new Error('[ResourceRegistry] Sync get() called, but no "onCreateSync" factory provided.');let i=this.entries.get(e),r=i?.deref();if(!r){r=new h({throws:!1});const t=new WeakRef(r);this.entries.set(e,t),this.finalizer.register(r,{key:e,ref:t},r)}const s=r.doSync(()=>this.onCreateSync(e,t));if(s.error)throw this.entries.get(e)?.deref()===r&&(this.entries.delete(e),this.finalizer.unregister(r)),s.error;const n=s.value;return this.resourceToOnce.set(n,r),n}async release(e){const t=this.entries.get(e);if(!t)return!1;try{const e=t.deref();if(e&&(this.finalizer.unregister(e),e.done())){const t=e.get();t&&this.onDispose&&(await this.onDispose(t),this.resourceToOnce.delete(t))}}catch(e){throw e}finally{this.entries.delete(e)}return!0}async clear(){for(const e of this.entries.values()){const t=e.deref();if(t&&(this.finalizer.unregister(t),t.done()&&this.onDispose)){const e=t.get();e&&(await this.onDispose(e),this.resourceToOnce.delete(e))}}this.entries.clear()}has(e){return this.entries.has(e)}get size(){return this.entries.size}};export{t as Debouncer,o as Latch,a as Mutex,h as Once,s as OnceExecutionConflict,c as RWMutex,_ as ResourceRegistry,l as Semaphore,u as Serializer,n as SerializerExecutionDone,d as SharedResource,i as SyncError,r as TimeoutError};
+import{SystemError as e}from"@asaidimu/utils-error";var t=class{_delay;_leading;_timer;_pendingFn;_pendingResolvers=[];_leadingFired=!1;constructor(e){this._delay=e?.delay??300,this._leading=e?.leading??!1}do(e){return new Promise(t=>{this._enqueue(e,t)})}fire(e){this._enqueue(e,void 0)}_enqueue(e,t){if(this._pendingFn=e,t&&this._pendingResolvers.push(t),this._leading&&!this._leadingFired){this._leadingFired=!0,this._fire(),clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._pendingFn!==void 0&&this._fire()},this._delay);return}clearTimeout(this._timer),this._timer=setTimeout(()=>{this._leadingFired=!1,this._fire()},this._delay)}cancel(){clearTimeout(this._timer),this._timer=void 0,this._pendingFn=void 0,this._leadingFired=!1;let e=this._pendingResolvers.splice(0);for(let t of e)t({status:`cancelled`})}async flush(){return this._pendingFn?(clearTimeout(this._timer),this._timer=void 0,this._leadingFired=!1,this._fire()):null}pending(){return this._pendingFn!==void 0}async _fire(){let e=this._pendingFn,t=this._pendingResolvers.splice(0);this._pendingFn=void 0;let n;try{n={status:`ok`,value:await e()}}catch(e){n={status:`error`,error:e}}for(let e of t)e(n);return n}},n=class t extends e{constructor(e,n){super({code:`SYNC_ERROR`,message:e,cause:n}),this.name=`SyncError`,Object.setPrototypeOf(this,t.prototype)}},r=class e extends n{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name=`TimeoutError`,Object.setPrototypeOf(this,e.prototype)}},i=class e extends n{constructor(t){super(`[Once] A method has already been registered!`,t),this.name=`OnceExecutionConflict`,Object.setPrototypeOf(this,e.prototype)}},a=class e extends n{constructor(t){super(`[Serializer] The serializer has been marked as done!`,t),this.name=`SerializerExecutionDone`,Object.setPrototypeOf(this,e.prototype)}},o=class{_open=!1;_resolve;_promise;constructor(){this._promise=new Promise(e=>{this._resolve=e})}open(){this._open||(this._open=!0,this._resolve())}async wait(e){if(this._open)return;if(e==null)return this._promise;let t;await Promise.race([this._promise.then(()=>clearTimeout(t)),new Promise((n,i)=>{t=setTimeout(()=>i(new r(`Latch timed out`)),e)})])}isOpen(){return this._open}},s=class{_locked=!1;_capacity;_yieldMode;waiters=[];constructor(e){this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??`macrotask`}async lock(e){if(!this._locked){this._locked=!0;return}if(this.waiters.length>=this._capacity)throw Error(`Mutex queue is full (capacity: ${this._capacity})`);let t,n=new Promise(e=>t=e);if(this.waiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),a(new r(`Mutex lock timed out`))},e)})])}tryLock(){return this._locked?!1:(this._locked=!0,!0)}unlock(){if(!this._locked)throw Error(`Mutex is not locked`);let e=this.waiters.shift();e?this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0):this._locked=!1}locked(){return this._locked}pending(){return this.waiters.length}},c=class{mutex=new s({yieldMode:`microtask`});promise=null;_value=null;_error;_done=!1;retry;throws;constructor({retry:e,throws:t}={}){this.retry=!!e,this.throws=!!t}resolve(e){if(this._done)throw Error(`Cannot resolve: operation is already completed.`);if(this.running())throw Error(`Cannot resolve: operation is currently running.`);this._value=e,this._done=!0}async do(e,t){return this._done?this.peek():this.promise?this._awaitWithTimeout(this.promise,t,`Once do() timed out`):(await this.mutex.lock(),this.promise?(this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,`Once do() timed out`)):(this.promise=(async()=>{try{this._value=await e(),this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.retry&&!this._done&&(this.promise=null)}return this.peek()})(),this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,`Once do() timed out`)))}doSync(e){if(this._done){if(this.throws&&this._error)throw this._error;return this.peek()}if(this.promise){let e=Error(`Cannot execute doSync while an async operation is pending.`);if(this.throws)throw e;return{value:null,error:e}}if(!this.mutex.tryLock()){let e=Error(`Cannot execute doSync: lock is currently held.`);if(this.throws)throw e;return{value:null,error:e}}if(this.promise||this._done){if(this.mutex.unlock(),this._done){if(this.throws&&this._error)throw this._error;return this.peek()}let e=Error(`Cannot execute doSync while an async operation is pending.`);if(this.throws)throw e;return{value:null,error:e}}try{let t=e();this._value=t,this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.mutex.unlock()}return this.peek()}running(){return this.promise!==null&&!this.done()}peek(){return{value:this._value,error:this._error}}get(){if(!this._done)throw Error(`Once operation is not yet complete`);if(this._error)throw this._error;return this._value}reset(){if(this.running())throw Error(`Cannot reset Once while an operation is in progress.`);this._done=!1,this.promise=null,this._value=null,this._error=void 0}done(){return this._done}current(){return this.promise}_awaitWithTimeout(e,t,n=`Operation timed out`){if(t==null)return e;let i;return Promise.race([e.then(e=>(clearTimeout(i),e)),new Promise((e,a)=>{i=setTimeout(()=>a(new r(n)),t)})])}},l=class{_readers=0;_writeLocked=!1;_pendingWriters=0;_yieldMode;readerWaiters=[];writerWaiters=[];constructor(e){this._yieldMode=e?.yieldMode??`microtask`}async rlock(e){if(!this._writeLocked&&this._pendingWriters===0){this._readers++;return}let t,n=new Promise(e=>t=e);if(this.readerWaiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.readerWaiters.indexOf(t);e!==-1&&this.readerWaiters.splice(e,1),a(new r(`RWMutex rlock timed out`))},e)})])}runlock(){if(this._readers<=0)throw Error(`RWMutex: runlock called without a matching rlock`);this._readers--,this._tryWakeWriter()}async lock(e){if(!this._writeLocked&&this._readers===0){this._writeLocked=!0;return}this._pendingWriters++;let t,n=new Promise(e=>t=e);if(this.writerWaiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.writerWaiters.indexOf(t);e!==-1&&(this.writerWaiters.splice(e,1),this._pendingWriters--),a(new r(`RWMutex lock timed out`))},e)})])}unlock(){if(!this._writeLocked)throw Error(`RWMutex: unlock called without a matching lock`);this._writeLocked=!1,this._tryWakeWriter()||this._wakeAllReaders()}async read(e,t){await this.rlock(t);try{return await e()}finally{this.runlock()}}async write(e,t){await this.lock(t);try{return await e()}finally{this.unlock()}}writeLocked(){return this._writeLocked}readers(){return this._readers}pendingWriters(){return this._pendingWriters}pendingReaders(){return this.readerWaiters.length}_tryWakeWriter(){if(this._writeLocked||this._readers>0)return!1;let e=this.writerWaiters.shift();return e?(this._writeLocked=!0,this._pendingWriters--,this._schedule(e),!0):!1}_wakeAllReaders(){let e=this.readerWaiters.splice(0);if(e.length!==0){this._readers+=e.length;for(let t of e)this._schedule(t)}}_schedule(e){this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0)}},u=class{_slots;_available;_capacity;_yieldMode;waiters=[];constructor(e){if(this._slots=e?.slots??1,this._available=this._slots,this._capacity=e?.capacity??1/0,this._yieldMode=e?.yieldMode??`macrotask`,this._slots<1)throw Error(`Semaphore slots must be >= 1`)}async acquire(e){if(this._available>0){this._available--;return}if(this.waiters.length>=this._capacity)throw Error(`Semaphore queue is full (capacity: ${this._capacity})`);let t,n=new Promise(e=>t=e);if(this.waiters.push(t),e==null){await n;return}let i;await Promise.race([n.then(()=>clearTimeout(i)),new Promise((n,a)=>{i=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),a(new r(`Semaphore acquire timed out`))},e)})])}tryAcquire(){return this._available>0?(this._available--,!0):!1}release(){if(this._available>=this._slots)throw Error(`Semaphore released more times than acquired`);let e=this.waiters.shift();e?this._yieldMode===`microtask`?queueMicrotask(e):setTimeout(e,0):this._available++}async run(e,t){await this.acquire(t);try{return await e()}finally{this.release()}}available(){return this._available}pending(){return this.waiters.length}slots(){return this._slots}},d=class{mutex;_closed=!1;_lastValue=null;_lastError=void 0;_hasRun=!1;_closeOnce=new c;constructor(e){this.mutex=new s({capacity:e?.capacity??1e3,yieldMode:e?.yieldMode??`macrotask`})}async do(e,t){return this._closed?{value:null,error:new a}:this._enqueue(e,t)}close(){return this._closed=!0,this._closeOnce.do(async()=>this._enqueue((()=>{})))}done(){return this._closeOnce.done()}peek(){return{value:this._lastValue,error:this._lastError}}hasRun(){return this._hasRun}pending(){return this.mutex.pending()}running(){return this.mutex.locked()}async _enqueue(e,t){try{await this.mutex.lock(t)}catch(e){return{value:null,error:e}}let n=null,r;try{n=await e(),this._lastValue=n,this._lastError=void 0,this._hasRun=!0}catch(e){r=e,this._lastError=e,this._hasRun=!0}finally{this.mutex.unlock()}return{value:n,error:r}}},f=class{factory;onCleanup;options;_count=0;init=new c({retry:!1,throws:!1});pendingMicrotask=!1;cleanupTimer;constructor(e,t,n={}){this.factory=e,this.onCleanup=t,this.options=n}get subscribers(){return this._count}async acquire(){this.cancelPendingCleanup(),this._count++;let e=await this.init.do(this.factory);if(e.error)throw e.error;return e.value}release(){if(this._count<=0){console.warn(`SharedResource.release() called, but count is already 0.`);return}this._count--,this._count===0&&this.scheduleCleanup()}peek(){let e=this.init.peek();return e.error?null:e.value}forceCleanup(){this.cancelPendingCleanup(),this._count=0,this.executeCleanup()}cancelPendingCleanup(){this.pendingMicrotask=!1,this.cleanupTimer!==void 0&&(clearTimeout(this.cleanupTimer),this.cleanupTimer=void 0)}scheduleCleanup(){let e=this.options.gracePeriod??`microtask`;if(e===`sync`){this.executeCleanup();return}if(e===`microtask`){this.pendingMicrotask=!0,queueMicrotask(()=>{!this.pendingMicrotask||this._count>0||(this.pendingMicrotask=!1,this.executeCleanup())});return}this.cleanupTimer=setTimeout(()=>{this.cleanupTimer=void 0,!(this._count>0)&&this.executeCleanup()},e)}executeCleanup(){let e=this.init.peek();try{this.onCleanup(e.value)}catch(e){console.error(`[SharedResource] Error during cleanup callback:`,e)}this.init.running()||this.init.reset()}},p=class{entries=new Map;resourceToOnce=new WeakMap;finalizer;onCreate;onCreateSync;onDispose;onEvict;constructor(e){if(this.onCreate=e.onCreate,this.onCreateSync=e.onCreateSync,this.onDispose=e.onDispose,this.onEvict=e.onEvict,!this.onCreate&&!this.onCreateSync)throw Error("[ResourceRegistry] Must provide either `onCreate` or `onCreateSync`.");this.finalizer=new FinalizationRegistry(({key:e,ref:t})=>{this.entries.get(e)===t&&(this.entries.delete(e),this.onEvict?.(e))})}async get(e,t,n){if(!this.onCreate)throw Error(`[ResourceRegistry] Async get() called, but no "onCreate" factory provided.`);let r=this.entries.get(e)?.deref();if(!r){r=new c({throws:!1});let t=new WeakRef(r);this.entries.set(e,t),this.finalizer.register(r,{key:e,ref:t},r)}let i=await r.do(()=>this.onCreate(e,t),n);if(i.error)throw this.entries.get(e)?.deref()===r&&(this.entries.delete(e),this.finalizer.unregister(r)),i.error;let a=i.value;return this.resourceToOnce.set(a,r),a}getSync(e,t){if(!this.onCreateSync)throw Error(`[ResourceRegistry] Sync get() called, but no "onCreateSync" factory provided.`);let n=this.entries.get(e)?.deref();if(!n){n=new c({throws:!1});let t=new WeakRef(n);this.entries.set(e,t),this.finalizer.register(n,{key:e,ref:t},n)}let r=n.doSync(()=>this.onCreateSync(e,t));if(r.error)throw this.entries.get(e)?.deref()===n&&(this.entries.delete(e),this.finalizer.unregister(n)),r.error;let i=r.value;return this.resourceToOnce.set(i,n),i}async release(e){let t=this.entries.get(e);if(!t)return!1;try{let e=t.deref();if(e&&(this.finalizer.unregister(e),e.done())){let t=e.get();t&&this.onDispose&&(await this.onDispose(t),this.resourceToOnce.delete(t))}}catch(e){throw e}finally{this.entries.delete(e)}return!0}async clear(){for(let e of this.entries.values()){let t=e.deref();if(t&&(this.finalizer.unregister(t),t.done()&&this.onDispose)){let e=t.get();e&&(await this.onDispose(e),this.resourceToOnce.delete(e))}}this.entries.clear()}has(e){return this.entries.has(e)}get size(){return this.entries.size}};export{t as Debouncer,o as Latch,s as Mutex,c as Once,i as OnceExecutionConflict,l as RWMutex,p as ResourceRegistry,u as Semaphore,d as Serializer,a as SerializerExecutionDone,f as SharedResource,n as SyncError,r as TimeoutError};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asaidimu/utils-sync",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "A collection of sync utilities.",
   "main": "index.js",
   "module": "index.mjs",
@@ -34,7 +34,9 @@
       }
     }
   },
-  "dependencies": {},
+  "dependencies": {
+    "@asaidimu/utils-error": "^1.0.0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "tag": "latest",
@@ -59,5 +61,6 @@
         }
       ]
     ]
-  }
+  },
+  "peerDependencies": {}
 }