npm - @asaidimu/utils-persistence - Versions diffs - 6.1.11 → 6.1.12 - Mend

@asaidimu/utils-persistence 6.1.11 → 6.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/index.js CHANGED Viewed

	@@ -1 +1 @@
1	- "use strict";var e,t,i=require("@asaidimu/utils-events"),r=require("@asaidimu/utils-database"),s=require("@asaidimu/utils-error"),n=Object.create,o=Object.defineProperty,a=Object.getOwnPropertyDescriptor,c=Object.getOwnPropertyNames,u=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty,h=(e={"node_modules/.bun/@asaidimu+query@1.1.2/node_modules/@asaidimu/query/index.js"(e,t){var i,r=Object.defineProperty,s=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,a={};((e,t)=>{for(var i in t)r(e,i,{get:t[i],enumerable:!0})})(a,{QueryBuilder:()=>c,createJoiner:()=>g,createMatcher:()=>l,createPaginator:()=>q,createProjector:()=>E,createSorter:()=>b}),t.exports=(i=a,((e,t,i,a)=>{if(t&&"object"==typeof t\|\|"function"==typeof t)for(let c of n(t))!o.call(e,c)&&c!==i&&r(e,c,{get:()=>t[c],enumerable:!(a=s(t,c))\|\|a.enumerable});return e})(r({},"__esModule",{value:!0}),i));var c=class{query;constructor(){this.query={}}where(e){return this.query.filters=e,this}orderBy(e,t){return this.query.sort\|\|(this.query.sort=[]),this.query.sort.push({field:e,direction:t}),this}offset(e,t){return this.query.pagination={type:"offset",offset:e,limit:t},this}cursor(e,t,i){return this.query.pagination={type:"cursor",cursor:e,limit:t,direction:i},this}include(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.include=e,this}exclude(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.exclude=e,this}computed(e,t){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:"computed",expression:e,alias:t}),this}case(e,t,i){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:"case",conditions:e,else:t,alias:i}),this}join(e,t,i){return this.query.joins\|\|(this.query.joins=[]),this.query.joins.push({relation:e,alias:i,query:t}),this}aggregate(e,t){return this.query.aggregations={groupBy:e,metrics:t},this}window(e){return this.query.window\|\|(this.query.window=[]),this.query.window.push(e),this}hint(e){return this.query.hints\|\|(this.query.hints=[]),this.query.hints.push(e),this}build(){return this.query}};function u(e){function t(e,t){return function(e){return"field"===e?.type}(t)?e[t.field]:function(e){return"value"===e?.type}(t)?t.value:function(e){return"function"===e?.type}(t)?r(t,e):function(e){return"computed"===e?.type}(t)?r(t.expression,e):function(e){return"case"===e?.type}(t)?function(e,t){for(let i of t.conditions)if(s(e,i.when))return i.then;return t.else}(e,t):t}let i=new Map([["and",(e,t)=>t.every(t=>s(e,t))],["or",(e,t)=>t.some(t=>s(e,t))],["not",(e,t)=>!t.every(t=>s(e,t))],["nor",(e,t)=>!t.some(t=>s(e,t))],["xor",(e,t)=>1===t.filter(t=>s(e,t)).length]]);function r(i,r){let s=i.arguments.map(e=>t(r,e));if(e[i.function])return e[i.function](...s);throw new Error(`Function ${i.function} not found!`)}function s(r,s){if(function(e){return!!e&&void 0!==e.conditions}(s))return function(e,t){let{operator:r,conditions:s}=t,n=i.get(r);if(n)return n(e,s);throw new Error(`Unsupported logical operator: ${r}`)}(r,s);if(!s\|\|!s.field)return!1;let{field:n,operator:o,value:a}=s,c=r[n],u=t(r,a),l=new Map([["eq",(e,t)=>e===t],["neq",(e,t)=>e!==t],["lt",(e,t)=>e<t],["lte",(e,t)=>e<=t],["gt",(e,t)=>e>t],["gte",(e,t)=>e>=t],["in",(e,t)=>Array.isArray(t)&&t.includes(e)],["nin",(e,t)=>Array.isArray(t)&&!t.includes(e)],["contains",(e,t)=>"string"==typeof e?e.includes(t):!!Array.isArray(e)&&e.includes(a)],["ncontains",(e,t)=>"string"==typeof e&&!e.includes(t)],["startswith",(e,t)=>"string"==typeof e&&e.startsWith(t)],["endswith",(e,t)=>"string"==typeof e&&e.endsWith(t)],["exists",e=>null!=e],["nexists",e=>null==e]]),h=e[o]\|\|l.get(o);if(h)return h(c,u);throw new Error(`Unsupported comparison operator: ${o}`)}return{resolve:t,evaluate:s}}function l(e){let{evaluate:t}=u(e),i=new WeakMap;function r(e,r){let s=i.get(e);s\|\|(s=new Map,i.set(e,s));let n=JSON.stringify(r);if(s.has(n))return s.get(n);let o=t(e,r);return s.set(n,o),o}return{matcher:r,match:r}}var h=class extends Error{constructor(e,t){super(e),this.code=t,this.name="JoinError"}},p=e=>e&&"field"in e&&"operator"in e&&"value"in e,d=(e,t)=>{if(e){if(p(e)&&e){let i=(e=>"object"==typeof e&&null!==e&&"type"in e&&"field"===e.type)(e.value)?((e,t)=>t.split(".").reduce((e,t)=>e?.[t],e))(t,e.value.field):e.value;return{...e,value:i}}if((e=>"operator"in e&&"conditions"in e)(e)){let i={...e};return e.conditions&&(i.conditions=e.conditions.map(e=>d(e,t))),i}return e}},f=async(e,t,i,r)=>{try{if(((e,t)=>{if(!e.relation)throw new h("Join configuration must specify a relation","INVALID_CONFIG");if(!t[e.relation])throw new h(`Collection "${e.relation}" not found in database`,"COLLECTION_NOT_FOUND");if(e.alias&&"string"!=typeof e.alias)throw new h("Join alias must be a string","INVALID_ALIAS")})(i,e),!Array.isArray(t))throw new h("Source data must be an array","INVALID_SOURCE_DATA");let s,n=e[i.relation];return i.query?.filters&&p(i.query.filters)&&(s=((e,t)=>{let i=new Map;return e.forEach(e=>{let r=e[t];i.has(r)\|\|i.set(r,[]),i.get(r).push(e)}),i})(n,i.query.filters.field)),(await Promise.all(t.map(async e=>{let t,o=((e,t)=>{if(!e)return{};let i=d(e.filters,t);return{...e,filters:i}})(i.query,e);return t=o.filters&&p(o.filters)&&s?.has(o.filters.value)?s.get(o.filters.value)\|\|[]:n.filter(e=>r.matcher(e,o.filters)),((e,t,i)=>{let r=i.alias\|\|i.relation;return[{...e,[r]:t}]})(e,await[e=>o.sort?r.sorter(e,o.sort):e,e=>o.projection?r.projector(e,o.projection):e,async e=>o.pagination?await r.paginator(e,o.pagination):e].reduce(async(e,t)=>t(await e),Promise.resolve(t)),i)}))).flat()}catch(e){throw e instanceof h?e:new h(`Join operation failed: ${e.message}`,"JOIN_EXECUTION_ERROR")}},y=async(e,t,i,r)=>i.reduce(async(t,i)=>f(e,await t,i,r),Promise.resolve(t));function g(){return{join:y}}var m=class extends Error{constructor(e,t){super(`Unsupported comparison between ${typeof e} and ${typeof t}`),this.name="UnsupportedComparisonError"}},w=class extends Error{constructor(e){super(`Unsupported sort direction: ${e}`),this.name="InvalidSortDirectionError"}};function v(e,t,i){if(e===t)return 0;if(null==e\|\|null==t)return null==e?"asc"===i?-1:1:"asc"===i?1:-1;if("string"==typeof e&&"string"==typeof t)return"asc"===i?e.localeCompare(t):t.localeCompare(e);if("number"==typeof e&&"number"==typeof t)return"asc"===i?e-t:t-e;throw new m(e,t)}function _(e,t){let i=Array.from(e);return 0===t.length?i:i.sort((e,i)=>{for(let r of t){let{field:t,direction:s}=r,n=e[t],o=i[t];try{if("asc"!==s&&"desc"!==s)throw new w(s);let e=v(n,o,s);if(0!==e)return e}catch(e){throw e instanceof m\|\|e instanceof w?e:new Error(`Error comparing field '${t}': ${e.message}`)}}return 0})}function b(){return{sort:_}}function E(e){let{resolve:t}=u(e);function i(e,r){let s={};return r.include?.length&&function(e,t,r){for(let s of t){if("string"==typeof s){let t=s;r[t]=e[t];continue}for(let[t,n]of Object.entries(s))if(Object.prototype.hasOwnProperty.call(e,t)){let s=i(e[t],n);r[t]=s}}}(e,r.include,s),r.exclude?.length&&function(e,t,r){0===Object.keys(r).length&&Object.assign(r,e);for(let e of t)if("string"!=typeof e)for(let[t,s]of Object.entries(e)){if(!Object.prototype.hasOwnProperty.call(r,t))continue;let e=r[t];e&&"object"==typeof e?r[t]=i(e,s):delete r[t]}else delete r[e]}(e,r.exclude,s),r.computed?.length&&function(e,i,r){for(let s of i)r[s.alias]=t(e,s)}(e,r.computed,s),s}return{project:i}}async functionS(e,t,i=e=>String(e)){"offset"===t.type?yieldasync function(e,t){let{offset:i,limit:r}=t,s=0,n=r,o=[];for await(let t of e)n<=0&&(yield o,o=[],n=r),s<i?s++:(o.push(t),n--);o.length>0&&(yield o)}(e,t):yieldasync function*(e,t,i){let{cursor:r,limit:s,direction:n}=t,o=s,a=void 0===r,c=[];if("forward"===n)for await(let t of e)o<=0&&(yield c,c=[],o=s),a?(c.push(t),o--):a=i(t)===r;else{let t=[];for await(let i of e)t.push(i);for(let e=t.length-1;e>=0;e--){let n=t[e];a?(c.push(n),o--,o<=0&&(yield c,c=[],o=s)):a=i(n)===r}}c.length>0&&(yield c)}(e,t,i)}function q(){return{paginate:S}}}},function(){return t\|\|(0,e[c(e)[0]])((t={exports:{}}).exports,t),t.exports}),p=((e,t,i)=>(i=null!=e?n(u(e)):{},((e,t,i,r)=>{if(t&&"object"==typeof t\|\|"function"==typeof t)for(let s of c(t))l.call(e,s)\|\|s===i\|\|o(e,s,{get:()=>t[s],enumerable:!(r=a(t,s))\|\|r.enumerable});return e})(e&&e.__esModule?i:o(i,"default",{value:e,enumerable:!0}),e)))(h()),d=class e extends s.SystemError{constructor(t,i){super({code:"SYNC_ERROR",message:t,cause:i}),this.name="SyncError",Object.setPrototypeOf(this,e.prototype)}},f=class e extends d{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name="TimeoutError",Object.setPrototypeOf(this,e.prototype)}},y=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 r;await Promise.race([i.then(()=>clearTimeout(r)),new Promise((i,s)=>{r=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),s(new f("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}},g=class{mutex=new y({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 r;return Promise.race([e.then(e=>(clearTimeout(r),e)),new Promise((e,s)=>{r=setTimeout(()=>s(new f(i)),t)})])}},m=class{constructor(e,t,i={}){this.factory=e,this.onCleanup=t,this.options=i}_count=0;init=new g({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()}},w=class e{static dbResources=new Map;static eventBusMap=new Map;static createDatabaseFactory(e){return async()=>{const{database:t,enableTelemetry:i=!1,collection:s="stores"}=e,n=await r.DatabaseConnection({database:t,enableTelemetry:i},r.createIndexedDbStore);try{await n.createCollection({name:s,version:"1.0.0",nestedSchemas:{},fields:{store:{name:"store",type:"string",required:!0},data:{name:"data",type:"object",required:!0},version:{name:"version",type:"string",required:!0},app:{name:"app",type:"string",required:!0}}})}catch(e){if(e instanceof r.DatabaseError&&"SCHEMA_ALREADY_EXISTS"!==e.type)throw e}return n}}static createDatabaseCleanup(t){return i=>{i?.close();const r=[];e.eventBusMap.forEach((e,i)=>{i.startsWith(`${t}_store_`)&&(e.clear(),r.push(i))}),r.forEach(t=>e.eventBusMap.delete(t))}}static async acquireDatabase(t){const i=t.database;if(!e.dbResources.has(i)){const r=new m(e.createDatabaseFactory(t),e.createDatabaseCleanup(i),{gracePeriod:"microtask"});e.dbResources.set(i,r)}return e.dbResources.get(i).acquire()}static releaseDatabase(t){const i=e.dbResources.get(t);i&&i.release()}static async getCollection(t){const i=await e.acquireDatabase(t),r=t.collection??"stores";return i.collection(r)}static getEventBus(t,r){const s=`${t}_store_${r}`;return e.eventBusMap.has(s)\|\|e.eventBusMap.set(s,i.createEventBus({errorHandler:e=>console.error(`Event bus error for ${t}:${r}:`,e),broadcast:{channel:s}})),e.eventBusMap.get(s)}};exports.EphemeralPersistence=class{eventBus;inMemoryState=null;config;constructor(e){this.config=e,this.eventBus=this.initializeEventBus(),this.setupLwwSynchronizationListener()}initializeEventBus(){const e={errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey} (Ephemeral LWW):`,e)};return"undefined"!=typeof process&&"test"===process.env.NODE_ENV\|\|(e.broadcast={channel:`ephemeral_lww_${this.config.storageKey}`}),i.createEventBus(e)}setupLwwSynchronizationListener(){this.eventBus.subscribe("store:updated",({storageKey:e,instanceId:t,state:i,timestamp:r,version:s})=>{e===this.config.storageKey&&(!this.inMemoryState\|\|r&&r>this.inMemoryState.timestamp)&&(this.inMemoryState={data:i,timestamp:r,instanceId:t,version:s})})}set(e,t){try{const i=Date.now();return this.inMemoryState={data:structuredClone(t),timestamp:i,instanceId:e,version:this.config.version},this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:e,state:t,timestamp:i,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to set state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}get(){return this.inMemoryState?.data??null}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.config.storageKey&&r!==e&&t(s)})}clear(){try{const e=Date.now(),t="clear-initiator";return this.inMemoryState={data:null,timestamp:e,instanceId:t,version:this.config.version},this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:t,state:null,timestamp:e,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}},exports.IndexedDBPersistence=class{collection=null;collectionPromise;config;eventBus;initialized=!1;_initializing=!1;initializationCallbacks=[];doc=null;getStoreName(){return`_${this.config.app}_${this.config.store}_`}constructor(e){this.config=e,this.collectionPromise=w.getCollection(this.config),this.collectionPromise.then(e=>{this.collection=e,this.initialize()}).catch(e=>{console.error(`Failed to initialize collection for store ${this.getStoreName()}:`,e)}),this.eventBus=w.getEventBus(this.config.database,this.getStoreName()),this.eventBus.subscribe("store:updated",({storageKey:e})=>{e===this.getStoreName()&&(this.doc=null)})}async initialize(){this._initializing=!0;try{const e=await this._get();if(e&&e.version!==this.config.version&&this.config.onUpgrade){const{state:t}=await this.config.onUpgrade({data:e.data,version:e.version,app:e.app});await this.set("migration",t)}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize and upgrade store ${this.getStoreName()}:`,e)}finally{this._initializing=!1}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}async getCollection(){return this.collection??this.collectionPromise}async set(e,t){this.initialized\|\|this._initializing\|\|await new Promise(e=>this._onInitialized(e));try{const i=await this.getCollection(),r=await this._read(),s={store:this.getStoreName(),data:t,version:this.config.version,app:this.config.app};let n;return r?n=await r.update(s):(this.doc=await i.create(s),n=!0),n&&this.eventBus.emit({name:"store:updated",payload:{storageKey:this.getStoreName(),instanceId:e,state:t,version:this.config.version,app:this.config.app}}),n}catch(t){return console.error(`Failed to set state for store ${this.getStoreName()} in database ${this.config.database} by instance ${e}:`,t),!1}}async _read(){if(this.doc)return this.doc;const e=await this.getCollection(),t=(new p.QueryBuilder).where({field:"store",operator:"eq",value:this.getStoreName()}).build();return this.doc=await e.find(t.filters),this.doc}async _get(){try{const e=await this._read();return e?e.read().then(()=>e):null}catch(e){return console.error(`Failed to get state for store ${this.getStoreName()} in database ${this.config.database}:`,e),null}}async get(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));const e=await this._get();return e?e.data:null}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.getStoreName()&&r!==e&&t(s)})}async clear(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));try{const e=await this._read();return!e\|\|!await e.delete()\|\|(this.doc=null,this.eventBus.emit({name:"store:updated",payload:{storageKey:this.getStoreName(),instanceId:"",state:null,version:this.config.version,app:this.config.app}}),!0)}catch(e){return console.error(`Failed to clear state for store ${this.getStoreName()} in database ${this.config.database}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}async close(){w.releaseDatabase(this.config.database)}},exports.WebStoragePersistence=class{eventBus;storage;config;initialized=!1;initializationCallbacks=[];constructor(e){this.config=e,this.storage=e.session?sessionStorage:localStorage,this.eventBus=this.initializeEventBus(),this.initialize(),e.session\|\|this.setupStorageEventListener()}async initialize(){try{const e=this.storage.getItem(this.getStoreName());if(e){const t=JSON.parse(e);if(t.version!==this.config.version&&this.config.onUpgrade){const{state:e}=await this.config.onUpgrade({data:t.state,version:t.version,app:t.app});this.set("migration",e)}}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize WebStoragePersistence for ${this.config.storageKey}:`,e)}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}initializeEventBus(){const e={batch:{size:0,delay:0},errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey}:`,e)};return"undefined"!=typeof process&&"test"===process.env.NODE_ENV\|\|(e.broadcast={channel:`storage_${this.getStoreName()}`}),i.createEventBus(e)}getStoreName(){return`_${this.config.app}_${this.config.storageKey}_`}setupStorageEventListener(){window.addEventListener("storage",e=>{if(e.key===this.getStoreName()&&e.newValue)try{const t=JSON.parse(e.newValue);t&&this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:"external",state:t.state,version:t.version,app:t.app}})}catch(e){console.error("Failed to parse storage event data:",e)}})}set(e,t){try{const i={state:structuredClone(t),version:this.config.version,app:this.config.app},r=JSON.stringify(i);return this.storage.setItem(this.getStoreName(),r),this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:e,state:t,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to persist state to web storage for ${this.config.storageKey}:`,e),!1}}_get(){try{const e=this.storage.getItem(this.getStoreName());if(!e)return null;return JSON.parse(e).state}catch(e){return console.error(`Failed to retrieve state from web storage for ${this.config.storageKey}:`,e),null}}async get(){return this.initialized\|\|await new Promise(e=>{this._onInitialized(e)}),this._get()}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.config.storageKey&&r!==e&&t(s)})}clear(){try{return this.storage.removeItem(this.getStoreName()),this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:"clear-initiator",state:null,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear persisted state for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}};
1	+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>()=>(t\|\|(e((t={exports:{}}).exports,t),e=null),t.exports);let t=require("@asaidimu/utils-events"),n=require("@asaidimu/utils-database"),r=require("@asaidimu/utils-error");var i=class{eventBus;storage;config;initialized=!1;initializationCallbacks=[];constructor(e){this.config=e,this.storage=e.session?sessionStorage:localStorage,this.eventBus=this.initializeEventBus(),this.initialize(),e.session\|\|this.setupStorageEventListener()}async initialize(){try{let e=this.storage.getItem(this.getStoreName());if(e){let t=JSON.parse(e);if(t.version!==this.config.version&&this.config.onUpgrade){let{state:e}=await this.config.onUpgrade({data:t.state,version:t.version,app:t.app});this.set(`migration`,e)}}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize WebStoragePersistence for ${this.config.storageKey}:`,e)}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}initializeEventBus(){let e={batch:{size:0,delay:0},errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey}:`,e)};return(typeof process>`u`\|\|process.env.NODE_ENV!==`test`)&&(e.broadcast={channel:`storage_${this.getStoreName()}`}),(0,t.createEventBus)(e)}getStoreName(){return`_${this.config.app}_${this.config.storageKey}_`}setupStorageEventListener(){window.addEventListener(`storage`,e=>{if(!(e.key!==this.getStoreName()\|\|!e.newValue))try{let t=JSON.parse(e.newValue);t&&this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:`external`,state:t.state,version:t.version,app:t.app}})}catch(e){console.error(`Failed to parse storage event data:`,e)}})}set(e,t){try{let n={state:structuredClone(t),version:this.config.version,app:this.config.app},r=JSON.stringify(n);return this.storage.setItem(this.getStoreName(),r),this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:e,state:t,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to persist state to web storage for ${this.config.storageKey}:`,e),!1}}_get(){try{let e=this.storage.getItem(this.getStoreName());return e?JSON.parse(e).state:null}catch(e){return console.error(`Failed to retrieve state from web storage for ${this.config.storageKey}:`,e),null}}async get(){return this.initialized\|\|await new Promise(e=>{this._onInitialized(e)}),this._get()}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.config.storageKey&&r!==e&&t(i)})}clear(){try{return this.storage.removeItem(this.getStoreName()),this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:`clear-initiator`,state:null,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear persisted state for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}},a=e(((e,t)=>{var n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,o=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})},s=(e,t,o,s)=>{if(t&&typeof t==`object`\|\|typeof t==`function`)for(let c of i(t))!a.call(e,c)&&c!==o&&n(e,c,{get:()=>t[c],enumerable:!(s=r(t,c))\|\|s.enumerable});return e},c=e=>s(n({},`__esModule`,{value:!0}),e),l={};o(l,{QueryBuilder:()=>u,createJoiner:()=>j,createMatcher:()=>v,createPaginator:()=>z,createProjector:()=>L,createSorter:()=>I}),t.exports=c(l);var u=class{query;constructor(){this.query={}}where(e){return this.query.filters=e,this}orderBy(e,t){return this.query.sort\|\|(this.query.sort=[]),this.query.sort.push({field:e,direction:t}),this}offset(e,t){return this.query.pagination={type:`offset`,offset:e,limit:t},this}cursor(e,t,n){return this.query.pagination={type:`cursor`,cursor:e,limit:t,direction:n},this}include(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.include=e,this}exclude(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.exclude=e,this}computed(e,t){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:`computed`,expression:e,alias:t}),this}case(e,t,n){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:`case`,conditions:e,else:t,alias:n}),this}join(e,t,n){return this.query.joins\|\|(this.query.joins=[]),this.query.joins.push({relation:e,alias:n,query:t}),this}aggregate(e,t){return this.query.aggregations={groupBy:e,metrics:t},this}window(e){return this.query.window\|\|(this.query.window=[]),this.query.window.push(e),this}hint(e){return this.query.hints\|\|(this.query.hints=[]),this.query.hints.push(e),this}build(){return this.query}};function d(e){function t(e,t){return f(t)?e[t.field]:p(t)?t.value:g(t)?i(t,e):m(t)?i(t.expression,e):h(t)?a(e,t):t}let n=new Map([[`and`,(e,t)=>t.every(t=>o(e,t))],[`or`,(e,t)=>t.some(t=>o(e,t))],[`not`,(e,t)=>!t.every(t=>o(e,t))],[`nor`,(e,t)=>!t.some(t=>o(e,t))],[`xor`,(e,t)=>t.filter(t=>o(e,t)).length===1]]);function r(e,t){let{operator:r,conditions:i}=t,a=n.get(r);if(a)return a(e,i);throw Error(`Unsupported logical operator: ${r}`)}function i(n,r){let i=n.arguments.map(e=>t(r,e));if(e[n.function])return e[n.function](...i);throw Error(`Function ${n.function} not found!`)}function a(e,t){for(let n of t.conditions)if(o(e,n.when))return n.then;return t.else}function o(n,i){if(_(i))return r(n,i);if(!i\|\|!i.field)return!1;let{field:a,operator:o,value:s}=i,c=n[a],l=t(n,s),u=new Map([[`eq`,(e,t)=>e===t],[`neq`,(e,t)=>e!==t],[`lt`,(e,t)=>e<t],[`lte`,(e,t)=>e<=t],[`gt`,(e,t)=>e>t],[`gte`,(e,t)=>e>=t],[`in`,(e,t)=>Array.isArray(t)&&t.includes(e)],[`nin`,(e,t)=>Array.isArray(t)&&!t.includes(e)],[`contains`,(e,t)=>typeof e==`string`?e.includes(t):Array.isArray(e)?e.includes(s):!1],[`ncontains`,(e,t)=>typeof e==`string`&&!e.includes(t)],[`startswith`,(e,t)=>typeof e==`string`&&e.startsWith(t)],[`endswith`,(e,t)=>typeof e==`string`&&e.endsWith(t)],[`exists`,e=>e!=null],[`nexists`,e=>e==null]]),d=e[o]\|\|u.get(o);if(d)return d(c,l);throw Error(`Unsupported comparison operator: ${o}`)}return{resolve:t,evaluate:o}}function f(e){return e?.type===`field`}function p(e){return e?.type===`value`}function m(e){return e?.type===`computed`}function h(e){return e?.type===`case`}function g(e){return e?.type===`function`}function _(e){return e?e.conditions!==void 0:!1}function v(e){let{evaluate:t}=d(e),n=new WeakMap;function r(e,r){let i=n.get(e);i\|\|(i=new Map,n.set(e,i));let a=JSON.stringify(r);if(i.has(a))return i.get(a);let o=t(e,r);return i.set(a,o),o}return{matcher:r,match:r}}var y=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`JoinError`}},b=e=>e&&`field`in e&&`operator`in e&&`value`in e,x=e=>`operator`in e&&`conditions`in e,S=e=>typeof e==`object`&&!!e&&`type`in e&&e.type===`field`,C=(e,t)=>{if(!e.relation)throw new y(`Join configuration must specify a relation`,`INVALID_CONFIG`);if(!t[e.relation])throw new y(`Collection "${e.relation}" not found in database`,`COLLECTION_NOT_FOUND`);if(e.alias&&typeof e.alias!=`string`)throw new y(`Join alias must be a string`,`INVALID_ALIAS`)},w=(e,t)=>t.split(`.`).reduce((e,t)=>e?.[t],e),T=(e,t)=>{if(e){if(b(e)&&e){let n=S(e.value)?w(t,e.value.field):e.value;return{...e,value:n}}if(x(e)){let n={...e};return e.conditions&&(n.conditions=e.conditions.map(e=>T(e,t))),n}return e}},E=(e,t)=>{if(!e)return{};let n=T(e.filters,t);return{...e,filters:n}},D=(e,t,n)=>{let r=n.alias\|\|n.relation;return[{...e,[r]:t}]},O=(e,t)=>{let n=new Map;return e.forEach(e=>{let r=e[t];n.has(r)\|\|n.set(r,[]),n.get(r).push(e)}),n},k=async(e,t,n,r)=>{try{if(C(n,e),!Array.isArray(t))throw new y(`Source data must be an array`,`INVALID_SOURCE_DATA`);let i=e[n.relation],a;return n.query?.filters&&b(n.query.filters)&&(a=O(i,n.query.filters.field)),(await Promise.all(t.map(async e=>{let t=E(n.query,e),o;return o=t.filters&&b(t.filters)&&a?.has(t.filters.value)?a.get(t.filters.value)\|\|[]:i.filter(e=>r.matcher(e,t.filters)),D(e,await[e=>t.sort?r.sorter(e,t.sort):e,e=>t.projection?r.projector(e,t.projection):e,async e=>t.pagination?await r.paginator(e,t.pagination):e].reduce(async(e,t)=>t(await e),Promise.resolve(o)),n)}))).flat()}catch(e){throw e instanceof y?e:new y(`Join operation failed: ${e.message}`,`JOIN_EXECUTION_ERROR`)}},A=async(e,t,n,r)=>n.reduce(async(t,n)=>k(e,await t,n,r),Promise.resolve(t));function j(){return{join:A}}var M=class extends Error{constructor(e,t){super(`Unsupported comparison between ${typeof e} and ${typeof t}`),this.name=`UnsupportedComparisonError`}},N=class extends Error{constructor(e){super(`Unsupported sort direction: ${e}`),this.name=`InvalidSortDirectionError`}};function P(e,t,n){if(e===t)return 0;if(e==null\|\|t==null)return e==null?n===`asc`?-1:1:n===`asc`?1:-1;if(typeof e==`string`&&typeof t==`string`)return n===`asc`?e.localeCompare(t):t.localeCompare(e);if(typeof e==`number`&&typeof t==`number`)return n===`asc`?e-t:t-e;throw new M(e,t)}function F(e,t){let n=Array.from(e);return t.length===0?n:n.sort((e,n)=>{for(let r of t){let{field:t,direction:i}=r,a=e[t],o=n[t];try{if(i!==`asc`&&i!==`desc`)throw new N(i);let e=P(a,o,i);if(e!==0)return e}catch(e){throw e instanceof M\|\|e instanceof N?e:Error(`Error comparing field '${t}': ${e.message}`)}}return 0})}function I(){return{sort:F}}function L(e){let{resolve:t}=d(e);function n(e,t,n){for(let r of t){if(typeof r==`string`){let t=r;n[t]=e[t];continue}for(let[t,i]of Object.entries(r))Object.prototype.hasOwnProperty.call(e,t)&&(n[t]=a(e[t],i))}}function r(e,t,n){Object.keys(n).length===0&&Object.assign(n,e);for(let e of t){if(typeof e==`string`){let t=e;delete n[t];continue}for(let[t,r]of Object.entries(e)){if(!Object.prototype.hasOwnProperty.call(n,t))continue;let e=n[t];e&&typeof e==`object`?n[t]=a(e,r):delete n[t]}}}function i(e,n,r){for(let i of n)r[i.alias]=t(e,i)}function a(e,t){let a={};return t.include?.length&&n(e,t.include,a),t.exclude?.length&&r(e,t.exclude,a),t.computed?.length&&i(e,t.computed,a),a}return{project:a}}async functionR(e,t,n=e=>String(e)){t.type===`offset`?yieldB(e,t):yieldV(e,t,n)}function z(){return{paginate:R}}async functionB(e,t){let{offset:n,limit:r}=t,i=0,a=r,o=[];for await(let t of e){if(a<=0&&(yield o,o=[],a=r),i<n){i++;continue}o.push(t),a--}o.length>0&&(yield o)}async function*V(e,t,n){let{cursor:r,limit:i,direction:a}=t,o=i,s=r===void 0,c=[];if(a===`forward`)for await(let t of e){if(o<=0&&(yield c,c=[],o=i),!s){s=n(t)===r;continue}c.push(t),o--}else{let t=[];for await(let n of e)t.push(n);for(let e=t.length-1;e>=0;e--){let a=t[e];if(!s){s=n(a)===r;continue}c.push(a),o--,o<=0&&(yield c,c=[],o=i)}}c.length>0&&(yield c)}0&&(t.exports={QueryBuilder,createJoiner,createMatcher,createPaginator,createProjector,createSorter})}))(),o=class e extends r.SystemError{constructor(t,n){super({code:`SYNC_ERROR`,message:t,cause:n}),this.name=`SyncError`,Object.setPrototypeOf(this,e.prototype)}},s=class e extends o{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name=`TimeoutError`,Object.setPrototypeOf(this,e.prototype)}},c=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 r;await Promise.race([n.then(()=>clearTimeout(r)),new Promise((n,i)=>{r=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),i(new s(`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}},l=class{mutex=new c({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 r;return Promise.race([e.then(e=>(clearTimeout(r),e)),new Promise((e,i)=>{r=setTimeout(()=>i(new s(n)),t)})])}},u=class{factory;onCleanup;options;_count=0;init=new l({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()}},d=class e{static dbResources=new Map;static eventBusMap=new Map;static createDatabaseFactory(e){return async()=>{let{database:t,enableTelemetry:r=!1,collection:i=`stores`}=e,a=await(0,n.DatabaseConnection)({database:t,enableTelemetry:r},n.createIndexedDbStore);try{await a.createCollection({name:i,version:`1.0.0`,nestedSchemas:{},fields:{store:{name:`store`,type:`string`,required:!0},data:{name:`data`,type:`object`,required:!0},version:{name:`version`,type:`string`,required:!0},app:{name:`app`,type:`string`,required:!0}}})}catch(e){if(e instanceof n.DatabaseError&&e.type!==`SCHEMA_ALREADY_EXISTS`)throw e}return a}}static createDatabaseCleanup(t){return n=>{n?.close();let r=[];e.eventBusMap.forEach((e,n)=>{n.startsWith(`${t}_store_`)&&(e.clear(),r.push(n))}),r.forEach(t=>e.eventBusMap.delete(t))}}static async acquireDatabase(t){let n=t.database;if(!e.dbResources.has(n)){let r=new u(e.createDatabaseFactory(t),e.createDatabaseCleanup(n),{gracePeriod:`microtask`});e.dbResources.set(n,r)}return e.dbResources.get(n).acquire()}static releaseDatabase(t){let n=e.dbResources.get(t);n&&n.release()}static async getCollection(t){let n=await e.acquireDatabase(t),r=t.collection??`stores`;return n.collection(r)}static getEventBus(n,r){let i=`${n}_store_${r}`;return e.eventBusMap.has(i)\|\|e.eventBusMap.set(i,(0,t.createEventBus)({errorHandler:e=>console.error(`Event bus error for ${n}:${r}:`,e),broadcast:{channel:i}})),e.eventBusMap.get(i)}},f=class{collection=null;collectionPromise;config;eventBus;initialized=!1;_initializing=!1;initializationCallbacks=[];doc=null;getStoreName(){return`_${this.config.app}_${this.config.store}_`}constructor(e){this.config=e,this.collectionPromise=d.getCollection(this.config),this.collectionPromise.then(e=>{this.collection=e,this.initialize()}).catch(e=>{console.error(`Failed to initialize collection for store ${this.getStoreName()}:`,e)}),this.eventBus=d.getEventBus(this.config.database,this.getStoreName()),this.eventBus.subscribe(`store:updated`,({storageKey:e})=>{e===this.getStoreName()&&(this.doc=null)})}async initialize(){this._initializing=!0;try{let e=await this._get();if(e&&e.version!==this.config.version&&this.config.onUpgrade){let{state:t}=await this.config.onUpgrade({data:e.data,version:e.version,app:e.app});await this.set(`migration`,t)}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize and upgrade store ${this.getStoreName()}:`,e)}finally{this._initializing=!1}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}async getCollection(){return this.collection??this.collectionPromise}async set(e,t){!this.initialized&&!this._initializing&&await new Promise(e=>this._onInitialized(e));try{let n=await this.getCollection(),r=await this._read(),i={store:this.getStoreName(),data:t,version:this.config.version,app:this.config.app},a;return r?a=await r.update(i):(this.doc=await n.create(i),a=!0),a&&this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.getStoreName(),instanceId:e,state:t,version:this.config.version,app:this.config.app}}),a}catch(t){return console.error(`Failed to set state for store ${this.getStoreName()} in database ${this.config.database} by instance ${e}:`,t),!1}}async _read(){if(this.doc)return this.doc;let e=await this.getCollection(),t=new a.QueryBuilder().where({field:`store`,operator:`eq`,value:this.getStoreName()}).build();return this.doc=await e.find(t.filters),this.doc}async _get(){try{let e=await this._read();return e?e.read().then(()=>e):null}catch(e){return console.error(`Failed to get state for store ${this.getStoreName()} in database ${this.config.database}:`,e),null}}async get(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));let e=await this._get();return e?e.data:null}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.getStoreName()&&r!==e&&t(i)})}async clear(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));try{let e=await this._read();return e&&await e.delete()?(this.doc=null,this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.getStoreName(),instanceId:``,state:null,version:this.config.version,app:this.config.app}}),!0):!0}catch(e){return console.error(`Failed to clear state for store ${this.getStoreName()} in database ${this.config.database}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}async close(){d.releaseDatabase(this.config.database)}},p=class{eventBus;inMemoryState=null;config;constructor(e){this.config=e,this.eventBus=this.initializeEventBus(),this.setupLwwSynchronizationListener()}initializeEventBus(){let e={errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey} (Ephemeral LWW):`,e)};return(typeof process>`u`\|\|process.env.NODE_ENV!==`test`)&&(e.broadcast={channel:`ephemeral_lww_${this.config.storageKey}`}),(0,t.createEventBus)(e)}setupLwwSynchronizationListener(){this.eventBus.subscribe(`store:updated`,({storageKey:e,instanceId:t,state:n,timestamp:r,version:i})=>{e===this.config.storageKey&&(!this.inMemoryState\|\|r&&r>this.inMemoryState.timestamp)&&(this.inMemoryState={data:n,timestamp:r,instanceId:t,version:i})})}set(e,t){try{let n=Date.now();return this.inMemoryState={data:structuredClone(t),timestamp:n,instanceId:e,version:this.config.version},this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:e,state:t,timestamp:n,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to set state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}get(){return this.inMemoryState?.data??null}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.config.storageKey&&r!==e&&t(i)})}clear(){try{let e=Date.now(),t=`clear-initiator`;return this.inMemoryState={data:null,timestamp:e,instanceId:t,version:this.config.version},this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:t,state:null,timestamp:e,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}};exports.EphemeralPersistence=p,exports.IndexedDBPersistence=f,exports.WebStoragePersistence=i;

package/index.mjs CHANGED Viewed

	@@ -1 +1 @@
1	- import{createEventBus as e}from"@asaidimu/utils-events";import{DatabaseConnection as t,createIndexedDbStore as i,DatabaseError as r}from"@asaidimu/utils-database";import{SystemError as s}from"@asaidimu/utils-error";var n,o,a=Object.create,c=Object.defineProperty,u=Object.getOwnPropertyDescriptor,l=Object.getOwnPropertyNames,h=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty,d=(n={"node_modules/.bun/@asaidimu+query@1.1.2/node_modules/@asaidimu/query/index.js"(e,t){var i,r=Object.defineProperty,s=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,a={};((e,t)=>{for(var i in t)r(e,i,{get:t[i],enumerable:!0})})(a,{QueryBuilder:()=>c,createJoiner:()=>g,createMatcher:()=>l,createPaginator:()=>E,createProjector:()=>S,createSorter:()=>b}),t.exports=(i=a,((e,t,i,a)=>{if(t&&"object"==typeof t\|\|"function"==typeof t)for(let c of n(t))!o.call(e,c)&&c!==i&&r(e,c,{get:()=>t[c],enumerable:!(a=s(t,c))\|\|a.enumerable});return e})(r({},"__esModule",{value:!0}),i));var c=class{query;constructor(){this.query={}}where(e){return this.query.filters=e,this}orderBy(e,t){return this.query.sort\|\|(this.query.sort=[]),this.query.sort.push({field:e,direction:t}),this}offset(e,t){return this.query.pagination={type:"offset",offset:e,limit:t},this}cursor(e,t,i){return this.query.pagination={type:"cursor",cursor:e,limit:t,direction:i},this}include(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.include=e,this}exclude(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.exclude=e,this}computed(e,t){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:"computed",expression:e,alias:t}),this}case(e,t,i){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:"case",conditions:e,else:t,alias:i}),this}join(e,t,i){return this.query.joins\|\|(this.query.joins=[]),this.query.joins.push({relation:e,alias:i,query:t}),this}aggregate(e,t){return this.query.aggregations={groupBy:e,metrics:t},this}window(e){return this.query.window\|\|(this.query.window=[]),this.query.window.push(e),this}hint(e){return this.query.hints\|\|(this.query.hints=[]),this.query.hints.push(e),this}build(){return this.query}};function u(e){function t(e,t){return function(e){return"field"===e?.type}(t)?e[t.field]:function(e){return"value"===e?.type}(t)?t.value:function(e){return"function"===e?.type}(t)?r(t,e):function(e){return"computed"===e?.type}(t)?r(t.expression,e):function(e){return"case"===e?.type}(t)?function(e,t){for(let i of t.conditions)if(s(e,i.when))return i.then;return t.else}(e,t):t}let i=new Map([["and",(e,t)=>t.every(t=>s(e,t))],["or",(e,t)=>t.some(t=>s(e,t))],["not",(e,t)=>!t.every(t=>s(e,t))],["nor",(e,t)=>!t.some(t=>s(e,t))],["xor",(e,t)=>1===t.filter(t=>s(e,t)).length]]);function r(i,r){let s=i.arguments.map(e=>t(r,e));if(e[i.function])return e[i.function](...s);throw new Error(`Function ${i.function} not found!`)}function s(r,s){if(function(e){return!!e&&void 0!==e.conditions}(s))return function(e,t){let{operator:r,conditions:s}=t,n=i.get(r);if(n)return n(e,s);throw new Error(`Unsupported logical operator: ${r}`)}(r,s);if(!s\|\|!s.field)return!1;let{field:n,operator:o,value:a}=s,c=r[n],u=t(r,a),l=new Map([["eq",(e,t)=>e===t],["neq",(e,t)=>e!==t],["lt",(e,t)=>e<t],["lte",(e,t)=>e<=t],["gt",(e,t)=>e>t],["gte",(e,t)=>e>=t],["in",(e,t)=>Array.isArray(t)&&t.includes(e)],["nin",(e,t)=>Array.isArray(t)&&!t.includes(e)],["contains",(e,t)=>"string"==typeof e?e.includes(t):!!Array.isArray(e)&&e.includes(a)],["ncontains",(e,t)=>"string"==typeof e&&!e.includes(t)],["startswith",(e,t)=>"string"==typeof e&&e.startsWith(t)],["endswith",(e,t)=>"string"==typeof e&&e.endsWith(t)],["exists",e=>null!=e],["nexists",e=>null==e]]),h=e[o]\|\|l.get(o);if(h)return h(c,u);throw new Error(`Unsupported comparison operator: ${o}`)}return{resolve:t,evaluate:s}}function l(e){let{evaluate:t}=u(e),i=new WeakMap;function r(e,r){let s=i.get(e);s\|\|(s=new Map,i.set(e,s));let n=JSON.stringify(r);if(s.has(n))return s.get(n);let o=t(e,r);return s.set(n,o),o}return{matcher:r,match:r}}var h=class extends Error{constructor(e,t){super(e),this.code=t,this.name="JoinError"}},p=e=>e&&"field"in e&&"operator"in e&&"value"in e,d=(e,t)=>{if(e){if(p(e)&&e){let i=(e=>"object"==typeof e&&null!==e&&"type"in e&&"field"===e.type)(e.value)?((e,t)=>t.split(".").reduce((e,t)=>e?.[t],e))(t,e.value.field):e.value;return{...e,value:i}}if((e=>"operator"in e&&"conditions"in e)(e)){let i={...e};return e.conditions&&(i.conditions=e.conditions.map(e=>d(e,t))),i}return e}},f=async(e,t,i,r)=>{try{if(((e,t)=>{if(!e.relation)throw new h("Join configuration must specify a relation","INVALID_CONFIG");if(!t[e.relation])throw new h(`Collection "${e.relation}" not found in database`,"COLLECTION_NOT_FOUND");if(e.alias&&"string"!=typeof e.alias)throw new h("Join alias must be a string","INVALID_ALIAS")})(i,e),!Array.isArray(t))throw new h("Source data must be an array","INVALID_SOURCE_DATA");let s,n=e[i.relation];return i.query?.filters&&p(i.query.filters)&&(s=((e,t)=>{let i=new Map;return e.forEach(e=>{let r=e[t];i.has(r)\|\|i.set(r,[]),i.get(r).push(e)}),i})(n,i.query.filters.field)),(await Promise.all(t.map(async e=>{let t,o=((e,t)=>{if(!e)return{};let i=d(e.filters,t);return{...e,filters:i}})(i.query,e);return t=o.filters&&p(o.filters)&&s?.has(o.filters.value)?s.get(o.filters.value)\|\|[]:n.filter(e=>r.matcher(e,o.filters)),((e,t,i)=>{let r=i.alias\|\|i.relation;return[{...e,[r]:t}]})(e,await[e=>o.sort?r.sorter(e,o.sort):e,e=>o.projection?r.projector(e,o.projection):e,async e=>o.pagination?await r.paginator(e,o.pagination):e].reduce(async(e,t)=>t(await e),Promise.resolve(t)),i)}))).flat()}catch(e){throw e instanceof h?e:new h(`Join operation failed: ${e.message}`,"JOIN_EXECUTION_ERROR")}},y=async(e,t,i,r)=>i.reduce(async(t,i)=>f(e,await t,i,r),Promise.resolve(t));function g(){return{join:y}}var m=class extends Error{constructor(e,t){super(`Unsupported comparison between ${typeof e} and ${typeof t}`),this.name="UnsupportedComparisonError"}},w=class extends Error{constructor(e){super(`Unsupported sort direction: ${e}`),this.name="InvalidSortDirectionError"}};function v(e,t,i){if(e===t)return 0;if(null==e\|\|null==t)return null==e?"asc"===i?-1:1:"asc"===i?1:-1;if("string"==typeof e&&"string"==typeof t)return"asc"===i?e.localeCompare(t):t.localeCompare(e);if("number"==typeof e&&"number"==typeof t)return"asc"===i?e-t:t-e;throw new m(e,t)}function _(e,t){let i=Array.from(e);return 0===t.length?i:i.sort((e,i)=>{for(let r of t){let{field:t,direction:s}=r,n=e[t],o=i[t];try{if("asc"!==s&&"desc"!==s)throw new w(s);let e=v(n,o,s);if(0!==e)return e}catch(e){throw e instanceof m\|\|e instanceof w?e:new Error(`Error comparing field '${t}': ${e.message}`)}}return 0})}function b(){return{sort:_}}function S(e){let{resolve:t}=u(e);function i(e,r){let s={};return r.include?.length&&function(e,t,r){for(let s of t){if("string"==typeof s){let t=s;r[t]=e[t];continue}for(let[t,n]of Object.entries(s))if(Object.prototype.hasOwnProperty.call(e,t)){let s=i(e[t],n);r[t]=s}}}(e,r.include,s),r.exclude?.length&&function(e,t,r){0===Object.keys(r).length&&Object.assign(r,e);for(let e of t)if("string"!=typeof e)for(let[t,s]of Object.entries(e)){if(!Object.prototype.hasOwnProperty.call(r,t))continue;let e=r[t];e&&"object"==typeof e?r[t]=i(e,s):delete r[t]}else delete r[e]}(e,r.exclude,s),r.computed?.length&&function(e,i,r){for(let s of i)r[s.alias]=t(e,s)}(e,r.computed,s),s}return{project:i}}async functionq(e,t,i=e=>String(e)){"offset"===t.type?yieldasync function(e,t){let{offset:i,limit:r}=t,s=0,n=r,o=[];for await(let t of e)n<=0&&(yield o,o=[],n=r),s<i?s++:(o.push(t),n--);o.length>0&&(yield o)}(e,t):yieldasync function*(e,t,i){let{cursor:r,limit:s,direction:n}=t,o=s,a=void 0===r,c=[];if("forward"===n)for await(let t of e)o<=0&&(yield c,c=[],o=s),a?(c.push(t),o--):a=i(t)===r;else{let t=[];for await(let i of e)t.push(i);for(let e=t.length-1;e>=0;e--){let n=t[e];a?(c.push(n),o--,o<=0&&(yield c,c=[],o=s)):a=i(n)===r}}c.length>0&&(yield c)}(e,t,i)}function E(){return{paginate:q}}}},function(){return o\|\|(0,n[l(n)[0]])((o={exports:{}}).exports,o),o.exports}),f=class{eventBus;storage;config;initialized=!1;initializationCallbacks=[];constructor(e){this.config=e,this.storage=e.session?sessionStorage:localStorage,this.eventBus=this.initializeEventBus(),this.initialize(),e.session\|\|this.setupStorageEventListener()}async initialize(){try{const e=this.storage.getItem(this.getStoreName());if(e){const t=JSON.parse(e);if(t.version!==this.config.version&&this.config.onUpgrade){const{state:e}=await this.config.onUpgrade({data:t.state,version:t.version,app:t.app});this.set("migration",e)}}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize WebStoragePersistence for ${this.config.storageKey}:`,e)}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}initializeEventBus(){const t={batch:{size:0,delay:0},errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey}:`,e)};return"undefined"!=typeof process&&"test"===process.env.NODE_ENV\|\|(t.broadcast={channel:`storage_${this.getStoreName()}`}),e(t)}getStoreName(){return`_${this.config.app}_${this.config.storageKey}_`}setupStorageEventListener(){window.addEventListener("storage",e=>{if(e.key===this.getStoreName()&&e.newValue)try{const t=JSON.parse(e.newValue);t&&this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:"external",state:t.state,version:t.version,app:t.app}})}catch(e){console.error("Failed to parse storage event data:",e)}})}set(e,t){try{const i={state:structuredClone(t),version:this.config.version,app:this.config.app},r=JSON.stringify(i);return this.storage.setItem(this.getStoreName(),r),this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:e,state:t,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to persist state to web storage for ${this.config.storageKey}:`,e),!1}}_get(){try{const e=this.storage.getItem(this.getStoreName());if(!e)return null;return JSON.parse(e).state}catch(e){return console.error(`Failed to retrieve state from web storage for ${this.config.storageKey}:`,e),null}}async get(){return this.initialized\|\|await new Promise(e=>{this._onInitialized(e)}),this._get()}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.config.storageKey&&r!==e&&t(s)})}clear(){try{return this.storage.removeItem(this.getStoreName()),this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:"clear-initiator",state:null,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear persisted state for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}},y=((e,t,i)=>(i=null!=e?a(h(e)):{},((e,t,i,r)=>{if(t&&"object"==typeof t\|\|"function"==typeof t)for(let s of l(t))p.call(e,s)\|\|s===i\|\|c(e,s,{get:()=>t[s],enumerable:!(r=u(t,s))\|\|r.enumerable});return e})(e&&e.__esModule?i:c(i,"default",{value:e,enumerable:!0}),e)))(d()),g=class e extends s{constructor(t,i){super({code:"SYNC_ERROR",message:t,cause:i}),this.name="SyncError",Object.setPrototypeOf(this,e.prototype)}},m=class e extends g{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name="TimeoutError",Object.setPrototypeOf(this,e.prototype)}},w=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 r;await Promise.race([i.then(()=>clearTimeout(r)),new Promise((i,s)=>{r=setTimeout(()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),s(new m("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}},v=class{mutex=new w({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 r;return Promise.race([e.then(e=>(clearTimeout(r),e)),new Promise((e,s)=>{r=setTimeout(()=>s(new m(i)),t)})])}},_=class{constructor(e,t,i={}){this.factory=e,this.onCleanup=t,this.options=i}_count=0;init=new v({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()}},b=class s{static dbResources=new Map;static eventBusMap=new Map;static createDatabaseFactory(e){return async()=>{const{database:s,enableTelemetry:n=!1,collection:o="stores"}=e,a=await t({database:s,enableTelemetry:n},i);try{await a.createCollection({name:o,version:"1.0.0",nestedSchemas:{},fields:{store:{name:"store",type:"string",required:!0},data:{name:"data",type:"object",required:!0},version:{name:"version",type:"string",required:!0},app:{name:"app",type:"string",required:!0}}})}catch(e){if(e instanceof r&&"SCHEMA_ALREADY_EXISTS"!==e.type)throw e}return a}}static createDatabaseCleanup(e){return t=>{t?.close();const i=[];s.eventBusMap.forEach((t,r)=>{r.startsWith(`${e}_store_`)&&(t.clear(),i.push(r))}),i.forEach(e=>s.eventBusMap.delete(e))}}static async acquireDatabase(e){const t=e.database;if(!s.dbResources.has(t)){const i=new _(s.createDatabaseFactory(e),s.createDatabaseCleanup(t),{gracePeriod:"microtask"});s.dbResources.set(t,i)}return s.dbResources.get(t).acquire()}static releaseDatabase(e){const t=s.dbResources.get(e);t&&t.release()}static async getCollection(e){const t=await s.acquireDatabase(e),i=e.collection??"stores";return t.collection(i)}static getEventBus(t,i){const r=`${t}_store_${i}`;return s.eventBusMap.has(r)\|\|s.eventBusMap.set(r,e({errorHandler:e=>console.error(`Event bus error for ${t}:${i}:`,e),broadcast:{channel:r}})),s.eventBusMap.get(r)}},S=class{collection=null;collectionPromise;config;eventBus;initialized=!1;_initializing=!1;initializationCallbacks=[];doc=null;getStoreName(){return`_${this.config.app}_${this.config.store}_`}constructor(e){this.config=e,this.collectionPromise=b.getCollection(this.config),this.collectionPromise.then(e=>{this.collection=e,this.initialize()}).catch(e=>{console.error(`Failed to initialize collection for store ${this.getStoreName()}:`,e)}),this.eventBus=b.getEventBus(this.config.database,this.getStoreName()),this.eventBus.subscribe("store:updated",({storageKey:e})=>{e===this.getStoreName()&&(this.doc=null)})}async initialize(){this._initializing=!0;try{const e=await this._get();if(e&&e.version!==this.config.version&&this.config.onUpgrade){const{state:t}=await this.config.onUpgrade({data:e.data,version:e.version,app:e.app});await this.set("migration",t)}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize and upgrade store ${this.getStoreName()}:`,e)}finally{this._initializing=!1}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}async getCollection(){return this.collection??this.collectionPromise}async set(e,t){this.initialized\|\|this._initializing\|\|await new Promise(e=>this._onInitialized(e));try{const i=await this.getCollection(),r=await this._read(),s={store:this.getStoreName(),data:t,version:this.config.version,app:this.config.app};let n;return r?n=await r.update(s):(this.doc=await i.create(s),n=!0),n&&this.eventBus.emit({name:"store:updated",payload:{storageKey:this.getStoreName(),instanceId:e,state:t,version:this.config.version,app:this.config.app}}),n}catch(t){return console.error(`Failed to set state for store ${this.getStoreName()} in database ${this.config.database} by instance ${e}:`,t),!1}}async _read(){if(this.doc)return this.doc;const e=await this.getCollection(),t=(new y.QueryBuilder).where({field:"store",operator:"eq",value:this.getStoreName()}).build();return this.doc=await e.find(t.filters),this.doc}async _get(){try{const e=await this._read();return e?e.read().then(()=>e):null}catch(e){return console.error(`Failed to get state for store ${this.getStoreName()} in database ${this.config.database}:`,e),null}}async get(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));const e=await this._get();return e?e.data:null}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.getStoreName()&&r!==e&&t(s)})}async clear(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));try{const e=await this._read();return!e\|\|!await e.delete()\|\|(this.doc=null,this.eventBus.emit({name:"store:updated",payload:{storageKey:this.getStoreName(),instanceId:"",state:null,version:this.config.version,app:this.config.app}}),!0)}catch(e){return console.error(`Failed to clear state for store ${this.getStoreName()} in database ${this.config.database}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}async close(){b.releaseDatabase(this.config.database)}},q=class{eventBus;inMemoryState=null;config;constructor(e){this.config=e,this.eventBus=this.initializeEventBus(),this.setupLwwSynchronizationListener()}initializeEventBus(){const t={errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey} (Ephemeral LWW):`,e)};return"undefined"!=typeof process&&"test"===process.env.NODE_ENV\|\|(t.broadcast={channel:`ephemeral_lww_${this.config.storageKey}`}),e(t)}setupLwwSynchronizationListener(){this.eventBus.subscribe("store:updated",({storageKey:e,instanceId:t,state:i,timestamp:r,version:s})=>{e===this.config.storageKey&&(!this.inMemoryState\|\|r&&r>this.inMemoryState.timestamp)&&(this.inMemoryState={data:i,timestamp:r,instanceId:t,version:s})})}set(e,t){try{const i=Date.now();return this.inMemoryState={data:structuredClone(t),timestamp:i,instanceId:e,version:this.config.version},this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:e,state:t,timestamp:i,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to set state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}get(){return this.inMemoryState?.data??null}subscribe(e,t){return this.eventBus.subscribe("store:updated",({storageKey:i,instanceId:r,state:s})=>{i===this.config.storageKey&&r!==e&&t(s)})}clear(){try{const e=Date.now(),t="clear-initiator";return this.inMemoryState={data:null,timestamp:e,instanceId:t,version:this.config.version},this.eventBus.emit({name:"store:updated",payload:{storageKey:this.config.storageKey,instanceId:t,state:null,timestamp:e,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}};export{q as EphemeralPersistence,S as IndexedDBPersistence,f as WebStoragePersistence};
1	+ import{createEventBus as e}from"@asaidimu/utils-events";import{DatabaseConnection as t,DatabaseError as n,createIndexedDbStore as r}from"@asaidimu/utils-database";import{SystemError as i}from"@asaidimu/utils-error";var a=(e,t)=>()=>(t\|\|(e((t={exports:{}}).exports,t),e=null),t.exports),o=class{eventBus;storage;config;initialized=!1;initializationCallbacks=[];constructor(e){this.config=e,this.storage=e.session?sessionStorage:localStorage,this.eventBus=this.initializeEventBus(),this.initialize(),e.session\|\|this.setupStorageEventListener()}async initialize(){try{let e=this.storage.getItem(this.getStoreName());if(e){let t=JSON.parse(e);if(t.version!==this.config.version&&this.config.onUpgrade){let{state:e}=await this.config.onUpgrade({data:t.state,version:t.version,app:t.app});this.set(`migration`,e)}}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize WebStoragePersistence for ${this.config.storageKey}:`,e)}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}initializeEventBus(){let t={batch:{size:0,delay:0},errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey}:`,e)};return(typeof process>`u`\|\|process.env.NODE_ENV!==`test`)&&(t.broadcast={channel:`storage_${this.getStoreName()}`}),e(t)}getStoreName(){return`_${this.config.app}_${this.config.storageKey}_`}setupStorageEventListener(){window.addEventListener(`storage`,e=>{if(!(e.key!==this.getStoreName()\|\|!e.newValue))try{let t=JSON.parse(e.newValue);t&&this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:`external`,state:t.state,version:t.version,app:t.app}})}catch(e){console.error(`Failed to parse storage event data:`,e)}})}set(e,t){try{let n={state:structuredClone(t),version:this.config.version,app:this.config.app},r=JSON.stringify(n);return this.storage.setItem(this.getStoreName(),r),this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:e,state:t,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to persist state to web storage for ${this.config.storageKey}:`,e),!1}}_get(){try{let e=this.storage.getItem(this.getStoreName());return e?JSON.parse(e).state:null}catch(e){return console.error(`Failed to retrieve state from web storage for ${this.config.storageKey}:`,e),null}}async get(){return this.initialized\|\|await new Promise(e=>{this._onInitialized(e)}),this._get()}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.config.storageKey&&r!==e&&t(i)})}clear(){try{return this.storage.removeItem(this.getStoreName()),this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:`clear-initiator`,state:null,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear persisted state for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}},s=a(((e,t)=>{var n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,o=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})},s=(e,t,o,s)=>{if(t&&typeof t==`object`\|\|typeof t==`function`)for(let c of i(t))!a.call(e,c)&&c!==o&&n(e,c,{get:()=>t[c],enumerable:!(s=r(t,c))\|\|s.enumerable});return e},c=e=>s(n({},`__esModule`,{value:!0}),e),l={};o(l,{QueryBuilder:()=>u,createJoiner:()=>j,createMatcher:()=>v,createPaginator:()=>z,createProjector:()=>L,createSorter:()=>I}),t.exports=c(l);var u=class{query;constructor(){this.query={}}where(e){return this.query.filters=e,this}orderBy(e,t){return this.query.sort\|\|(this.query.sort=[]),this.query.sort.push({field:e,direction:t}),this}offset(e,t){return this.query.pagination={type:`offset`,offset:e,limit:t},this}cursor(e,t,n){return this.query.pagination={type:`cursor`,cursor:e,limit:t,direction:n},this}include(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.include=e,this}exclude(e){return this.query.projection\|\|(this.query.projection={}),this.query.projection.exclude=e,this}computed(e,t){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:`computed`,expression:e,alias:t}),this}case(e,t,n){return this.query.projection\|\|(this.query.projection={}),this.query.projection.computed\|\|(this.query.projection.computed=[]),this.query.projection.computed.push({type:`case`,conditions:e,else:t,alias:n}),this}join(e,t,n){return this.query.joins\|\|(this.query.joins=[]),this.query.joins.push({relation:e,alias:n,query:t}),this}aggregate(e,t){return this.query.aggregations={groupBy:e,metrics:t},this}window(e){return this.query.window\|\|(this.query.window=[]),this.query.window.push(e),this}hint(e){return this.query.hints\|\|(this.query.hints=[]),this.query.hints.push(e),this}build(){return this.query}};function d(e){function t(e,t){return f(t)?e[t.field]:p(t)?t.value:g(t)?i(t,e):m(t)?i(t.expression,e):h(t)?a(e,t):t}let n=new Map([[`and`,(e,t)=>t.every(t=>o(e,t))],[`or`,(e,t)=>t.some(t=>o(e,t))],[`not`,(e,t)=>!t.every(t=>o(e,t))],[`nor`,(e,t)=>!t.some(t=>o(e,t))],[`xor`,(e,t)=>t.filter(t=>o(e,t)).length===1]]);function r(e,t){let{operator:r,conditions:i}=t,a=n.get(r);if(a)return a(e,i);throw Error(`Unsupported logical operator: ${r}`)}function i(n,r){let i=n.arguments.map(e=>t(r,e));if(e[n.function])return e[n.function](...i);throw Error(`Function ${n.function} not found!`)}function a(e,t){for(let n of t.conditions)if(o(e,n.when))return n.then;return t.else}function o(n,i){if(_(i))return r(n,i);if(!i\|\|!i.field)return!1;let{field:a,operator:o,value:s}=i,c=n[a],l=t(n,s),u=new Map([[`eq`,(e,t)=>e===t],[`neq`,(e,t)=>e!==t],[`lt`,(e,t)=>e<t],[`lte`,(e,t)=>e<=t],[`gt`,(e,t)=>e>t],[`gte`,(e,t)=>e>=t],[`in`,(e,t)=>Array.isArray(t)&&t.includes(e)],[`nin`,(e,t)=>Array.isArray(t)&&!t.includes(e)],[`contains`,(e,t)=>typeof e==`string`?e.includes(t):Array.isArray(e)?e.includes(s):!1],[`ncontains`,(e,t)=>typeof e==`string`&&!e.includes(t)],[`startswith`,(e,t)=>typeof e==`string`&&e.startsWith(t)],[`endswith`,(e,t)=>typeof e==`string`&&e.endsWith(t)],[`exists`,e=>e!=null],[`nexists`,e=>e==null]]),d=e[o]\|\|u.get(o);if(d)return d(c,l);throw Error(`Unsupported comparison operator: ${o}`)}return{resolve:t,evaluate:o}}function f(e){return e?.type===`field`}function p(e){return e?.type===`value`}function m(e){return e?.type===`computed`}function h(e){return e?.type===`case`}function g(e){return e?.type===`function`}function _(e){return e?e.conditions!==void 0:!1}function v(e){let{evaluate:t}=d(e),n=new WeakMap;function r(e,r){let i=n.get(e);i\|\|(i=new Map,n.set(e,i));let a=JSON.stringify(r);if(i.has(a))return i.get(a);let o=t(e,r);return i.set(a,o),o}return{matcher:r,match:r}}var y=class extends Error{constructor(e,t){super(e),this.code=t,this.name=`JoinError`}},b=e=>e&&`field`in e&&`operator`in e&&`value`in e,x=e=>`operator`in e&&`conditions`in e,S=e=>typeof e==`object`&&!!e&&`type`in e&&e.type===`field`,C=(e,t)=>{if(!e.relation)throw new y(`Join configuration must specify a relation`,`INVALID_CONFIG`);if(!t[e.relation])throw new y(`Collection "${e.relation}" not found in database`,`COLLECTION_NOT_FOUND`);if(e.alias&&typeof e.alias!=`string`)throw new y(`Join alias must be a string`,`INVALID_ALIAS`)},w=(e,t)=>t.split(`.`).reduce((e,t)=>e?.[t],e),T=(e,t)=>{if(e){if(b(e)&&e){let n=S(e.value)?w(t,e.value.field):e.value;return{...e,value:n}}if(x(e)){let n={...e};return e.conditions&&(n.conditions=e.conditions.map(e=>T(e,t))),n}return e}},E=(e,t)=>{if(!e)return{};let n=T(e.filters,t);return{...e,filters:n}},D=(e,t,n)=>{let r=n.alias\|\|n.relation;return[{...e,[r]:t}]},O=(e,t)=>{let n=new Map;return e.forEach(e=>{let r=e[t];n.has(r)\|\|n.set(r,[]),n.get(r).push(e)}),n},k=async(e,t,n,r)=>{try{if(C(n,e),!Array.isArray(t))throw new y(`Source data must be an array`,`INVALID_SOURCE_DATA`);let i=e[n.relation],a;return n.query?.filters&&b(n.query.filters)&&(a=O(i,n.query.filters.field)),(await Promise.all(t.map(async e=>{let t=E(n.query,e),o;return o=t.filters&&b(t.filters)&&a?.has(t.filters.value)?a.get(t.filters.value)\|\|[]:i.filter(e=>r.matcher(e,t.filters)),D(e,await[e=>t.sort?r.sorter(e,t.sort):e,e=>t.projection?r.projector(e,t.projection):e,async e=>t.pagination?await r.paginator(e,t.pagination):e].reduce(async(e,t)=>t(await e),Promise.resolve(o)),n)}))).flat()}catch(e){throw e instanceof y?e:new y(`Join operation failed: ${e.message}`,`JOIN_EXECUTION_ERROR`)}},A=async(e,t,n,r)=>n.reduce(async(t,n)=>k(e,await t,n,r),Promise.resolve(t));function j(){return{join:A}}var M=class extends Error{constructor(e,t){super(`Unsupported comparison between ${typeof e} and ${typeof t}`),this.name=`UnsupportedComparisonError`}},N=class extends Error{constructor(e){super(`Unsupported sort direction: ${e}`),this.name=`InvalidSortDirectionError`}};function P(e,t,n){if(e===t)return 0;if(e==null\|\|t==null)return e==null?n===`asc`?-1:1:n===`asc`?1:-1;if(typeof e==`string`&&typeof t==`string`)return n===`asc`?e.localeCompare(t):t.localeCompare(e);if(typeof e==`number`&&typeof t==`number`)return n===`asc`?e-t:t-e;throw new M(e,t)}function F(e,t){let n=Array.from(e);return t.length===0?n:n.sort((e,n)=>{for(let r of t){let{field:t,direction:i}=r,a=e[t],o=n[t];try{if(i!==`asc`&&i!==`desc`)throw new N(i);let e=P(a,o,i);if(e!==0)return e}catch(e){throw e instanceof M\|\|e instanceof N?e:Error(`Error comparing field '${t}': ${e.message}`)}}return 0})}function I(){return{sort:F}}function L(e){let{resolve:t}=d(e);function n(e,t,n){for(let r of t){if(typeof r==`string`){let t=r;n[t]=e[t];continue}for(let[t,i]of Object.entries(r))Object.prototype.hasOwnProperty.call(e,t)&&(n[t]=a(e[t],i))}}function r(e,t,n){Object.keys(n).length===0&&Object.assign(n,e);for(let e of t){if(typeof e==`string`){let t=e;delete n[t];continue}for(let[t,r]of Object.entries(e)){if(!Object.prototype.hasOwnProperty.call(n,t))continue;let e=n[t];e&&typeof e==`object`?n[t]=a(e,r):delete n[t]}}}function i(e,n,r){for(let i of n)r[i.alias]=t(e,i)}function a(e,t){let a={};return t.include?.length&&n(e,t.include,a),t.exclude?.length&&r(e,t.exclude,a),t.computed?.length&&i(e,t.computed,a),a}return{project:a}}async functionR(e,t,n=e=>String(e)){t.type===`offset`?yieldB(e,t):yieldV(e,t,n)}function z(){return{paginate:R}}async functionB(e,t){let{offset:n,limit:r}=t,i=0,a=r,o=[];for await(let t of e){if(a<=0&&(yield o,o=[],a=r),i<n){i++;continue}o.push(t),a--}o.length>0&&(yield o)}async function*V(e,t,n){let{cursor:r,limit:i,direction:a}=t,o=i,s=r===void 0,c=[];if(a===`forward`)for await(let t of e){if(o<=0&&(yield c,c=[],o=i),!s){s=n(t)===r;continue}c.push(t),o--}else{let t=[];for await(let n of e)t.push(n);for(let e=t.length-1;e>=0;e--){let a=t[e];if(!s){s=n(a)===r;continue}c.push(a),o--,o<=0&&(yield c,c=[],o=i)}}c.length>0&&(yield c)}0&&(t.exports={QueryBuilder,createJoiner,createMatcher,createPaginator,createProjector,createSorter})}))(),c=class e extends i{constructor(t,n){super({code:`SYNC_ERROR`,message:t,cause:n}),this.name=`SyncError`,Object.setPrototypeOf(this,e.prototype)}},l=class e extends c{constructor(t){super(`[ArtifactContainer] Operation timed out: ${t}`),this.name=`TimeoutError`,Object.setPrototypeOf(this,e.prototype)}},u=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 r;await Promise.race([n.then(()=>clearTimeout(r)),new Promise((n,i)=>{r=setTimeout(()=>{let e=this.waiters.indexOf(t);e!==-1&&this.waiters.splice(e,1),i(new l(`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}},d=class{mutex=new u({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 r;return Promise.race([e.then(e=>(clearTimeout(r),e)),new Promise((e,i)=>{r=setTimeout(()=>i(new l(n)),t)})])}},f=class{factory;onCleanup;options;_count=0;init=new d({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 i{static dbResources=new Map;static eventBusMap=new Map;static createDatabaseFactory(e){return async()=>{let{database:i,enableTelemetry:a=!1,collection:o=`stores`}=e,s=await t({database:i,enableTelemetry:a},r);try{await s.createCollection({name:o,version:`1.0.0`,nestedSchemas:{},fields:{store:{name:`store`,type:`string`,required:!0},data:{name:`data`,type:`object`,required:!0},version:{name:`version`,type:`string`,required:!0},app:{name:`app`,type:`string`,required:!0}}})}catch(e){if(e instanceof n&&e.type!==`SCHEMA_ALREADY_EXISTS`)throw e}return s}}static createDatabaseCleanup(e){return t=>{t?.close();let n=[];i.eventBusMap.forEach((t,r)=>{r.startsWith(`${e}_store_`)&&(t.clear(),n.push(r))}),n.forEach(e=>i.eventBusMap.delete(e))}}static async acquireDatabase(e){let t=e.database;if(!i.dbResources.has(t)){let n=new f(i.createDatabaseFactory(e),i.createDatabaseCleanup(t),{gracePeriod:`microtask`});i.dbResources.set(t,n)}return i.dbResources.get(t).acquire()}static releaseDatabase(e){let t=i.dbResources.get(e);t&&t.release()}static async getCollection(e){let t=await i.acquireDatabase(e),n=e.collection??`stores`;return t.collection(n)}static getEventBus(t,n){let r=`${t}_store_${n}`;return i.eventBusMap.has(r)\|\|i.eventBusMap.set(r,e({errorHandler:e=>console.error(`Event bus error for ${t}:${n}:`,e),broadcast:{channel:r}})),i.eventBusMap.get(r)}},m=class{collection=null;collectionPromise;config;eventBus;initialized=!1;_initializing=!1;initializationCallbacks=[];doc=null;getStoreName(){return`_${this.config.app}_${this.config.store}_`}constructor(e){this.config=e,this.collectionPromise=p.getCollection(this.config),this.collectionPromise.then(e=>{this.collection=e,this.initialize()}).catch(e=>{console.error(`Failed to initialize collection for store ${this.getStoreName()}:`,e)}),this.eventBus=p.getEventBus(this.config.database,this.getStoreName()),this.eventBus.subscribe(`store:updated`,({storageKey:e})=>{e===this.getStoreName()&&(this.doc=null)})}async initialize(){this._initializing=!0;try{let e=await this._get();if(e&&e.version!==this.config.version&&this.config.onUpgrade){let{state:t}=await this.config.onUpgrade({data:e.data,version:e.version,app:e.app});await this.set(`migration`,t)}this.initialized=!0,this.initializationCallbacks.forEach(e=>e()),this.initializationCallbacks=[]}catch(e){console.error(`Failed to initialize and upgrade store ${this.getStoreName()}:`,e)}finally{this._initializing=!1}}_onInitialized(e){this.initialized?e():this.initializationCallbacks.push(e)}async getCollection(){return this.collection??this.collectionPromise}async set(e,t){!this.initialized&&!this._initializing&&await new Promise(e=>this._onInitialized(e));try{let n=await this.getCollection(),r=await this._read(),i={store:this.getStoreName(),data:t,version:this.config.version,app:this.config.app},a;return r?a=await r.update(i):(this.doc=await n.create(i),a=!0),a&&this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.getStoreName(),instanceId:e,state:t,version:this.config.version,app:this.config.app}}),a}catch(t){return console.error(`Failed to set state for store ${this.getStoreName()} in database ${this.config.database} by instance ${e}:`,t),!1}}async _read(){if(this.doc)return this.doc;let e=await this.getCollection(),t=new s.QueryBuilder().where({field:`store`,operator:`eq`,value:this.getStoreName()}).build();return this.doc=await e.find(t.filters),this.doc}async _get(){try{let e=await this._read();return e?e.read().then(()=>e):null}catch(e){return console.error(`Failed to get state for store ${this.getStoreName()} in database ${this.config.database}:`,e),null}}async get(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));let e=await this._get();return e?e.data:null}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.getStoreName()&&r!==e&&t(i)})}async clear(){this.initialized\|\|await new Promise(e=>this._onInitialized(e));try{let e=await this._read();return e&&await e.delete()?(this.doc=null,this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.getStoreName(),instanceId:``,state:null,version:this.config.version,app:this.config.app}}),!0):!0}catch(e){return console.error(`Failed to clear state for store ${this.getStoreName()} in database ${this.config.database}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}async close(){p.releaseDatabase(this.config.database)}},h=class{eventBus;inMemoryState=null;config;constructor(e){this.config=e,this.eventBus=this.initializeEventBus(),this.setupLwwSynchronizationListener()}initializeEventBus(){let t={errorHandler:e=>console.error(`Event bus error for ${this.config.storageKey} (Ephemeral LWW):`,e)};return(typeof process>`u`\|\|process.env.NODE_ENV!==`test`)&&(t.broadcast={channel:`ephemeral_lww_${this.config.storageKey}`}),e(t)}setupLwwSynchronizationListener(){this.eventBus.subscribe(`store:updated`,({storageKey:e,instanceId:t,state:n,timestamp:r,version:i})=>{e===this.config.storageKey&&(!this.inMemoryState\|\|r&&r>this.inMemoryState.timestamp)&&(this.inMemoryState={data:n,timestamp:r,instanceId:t,version:i})})}set(e,t){try{let n=Date.now();return this.inMemoryState={data:structuredClone(t),timestamp:n,instanceId:e,version:this.config.version},this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:e,state:t,timestamp:n,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to set state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}get(){return this.inMemoryState?.data??null}subscribe(e,t){return this.eventBus.subscribe(`store:updated`,({storageKey:n,instanceId:r,state:i})=>{n===this.config.storageKey&&r!==e&&t(i)})}clear(){try{let e=Date.now(),t=`clear-initiator`;return this.inMemoryState={data:null,timestamp:e,instanceId:t,version:this.config.version},this.eventBus.emit({name:`store:updated`,payload:{storageKey:this.config.storageKey,instanceId:t,state:null,timestamp:e,version:this.config.version,app:this.config.app}}),!0}catch(e){return console.error(`Failed to clear state in EphemeralPersistence (LWW) for ${this.config.storageKey}:`,e),!1}}stats(){return{version:this.config.version,id:this.config.app}}};export{h as EphemeralPersistence,m as IndexedDBPersistence,o as WebStoragePersistence};

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@asaidimu/utils-persistence",
-  "version": "6.1.11",
+  "version": "6.1.12",
   "description": "Persistence utilities.",
   "main": "index.js",
   "module": "index.mjs",
@@ -31,7 +31,7 @@
   "dependencies": {
     "@asaidimu/indexed": "^3.0.1",
     "@asaidimu/query": "^1.1.2",
-    "@asaidimu/utils-database": "^3.1.8",
+    "@asaidimu/utils-database": "^3.1.9",
     "@asaidimu/utils-events": "^1.0.0",
     "uuid": "^14.0.0"
   },

package/index.d.mts DELETED Viewed

@@ -1,300 +0,0 @@
-/**
- * configuration object for initializing a persistence store.
- *
- * this configuration allows you to:
- * - define the **schema/application version** of the data being persisted.
- * - distinguish between multiple **applications** that may run on the same host
- *   (so they don’t overwrite each other’s storage).
- * - optionally provide an **upgrade handler** to migrate persisted data when
- *   the version changes.
- *
- * @template T the type of data being persisted.
- */
-interface StoreConfig<T> {
-    /**
-     * the semantic version string (e.g., "1.0.0") of the data schema or application.
-     *
-     * this is used for version control and data migrations.
-     * when the persisted state’s version does not match the current version,
-     * the `onUpgrade` function will be invoked (if provided).
-     */
-    version: string;
-    /**
-     * a unique application identifier (e.g., "chat-app" or "my-dashboard").
-     *
-     * this prevents collisions between different apps or modules
-     * that might share the same persistence backend (e.g., localstorage).
-     *
-     * example: if two apps both persist under the key "user", the `app`
-     * value ensures they can be distinguished.
-     */
-    app: string;
-    /**
-     * optional handler for upgrading persisted state across versions.
-     *
-     * this function will be called when the persisted state’s `version`
-     * does not match the `version` specified in this config.
-     *
-     * @param state the existing state object, including:
-     *  - `data`: the current persisted data (or null if none exists).
-     *  - `version`: the version string stored with the data.
-     *  - `app`: the application identifier stored with the data.
-     *
-     * @returns a new state object with:
-     *  - `state`: the migrated data (or null if clearing/resetting).
-     *  - `version`: the new version string (must match `config.version`).
-     *
-     * example:
-     * ```ts
-     * onupgrade: async ({ data, version, app }) => {
-     *   if (version === "1.0.0") {
-     *     // migrate from 1.0.0 to 2.0.0
-     *     return { state: { ...data, newfield: "default" }, version: "2.0.0" };
-     *   }
-     *   return { state: data, version: "2.0.0" };
-     * }
-     * ```
-     */
-    onUpgrade?: (state: {
-        data: T | null;
-        version: string;
-        app: string;
-    }) => Promise<{
-        state: T | null;
-        version: string;
-    }>;
-    /**
-     * enables or disables developer mode for the persistence store.
-     *
-     * when set to `true`, the store may provide additional logging,
-     * verbose error reporting, or bypass certain production constraints
-     * (such as strict cache validation) to aid in debugging.
-     *
-     * @default false
-     */
-    dev?: boolean;
-}
-interface SimplePersistence<T> {
-    /**
-     * Persists data to storage.
-     *
-     * @param id The **unique identifier of the *consumer instance*** making the change. This is NOT the ID of the data (`T`) itself.
-     * Think of it as the ID of the specific browser tab, component, or module that's currently interacting with the persistence layer.
-     * It should typically be a **UUID** generated once at the consumer instance's instantiation.
-     * This `id` is crucial for the `subscribe` method, helping to differentiate updates originating from the current instance versus other instances/tabs, thereby preventing self-triggered notification loops.
-     * @param state The state (of type T) to persist. This state is generally considered the **global or shared state** that all instances interact with.
-     * @returns `true` if the operation was successful, `false` if an error occurred. For asynchronous implementations (like `IndexedDBPersistence`), this returns a `Promise<boolean>`.
-     */
-    set(id: string, state: T): boolean | Promise<boolean>;
-    /**
-     * Retrieves the global persisted data from storage.
-     *
-     * @returns The retrieved state of type `T`, or `null` if no data is found or if an error occurs during retrieval/parsing.
-     * For asynchronous implementations, this returns a `Promise<T | null>`.
-     */
-    get(): (T | null) | Promise<T | null>;
-    /**
-     * Subscribes to changes in the global persisted data that originate from *other* instances of your application (e.g., other tabs or independent components using the same persistence layer).
-     *
-     * @param id The **unique identifier of the *consumer instance* subscribing**. This allows the persistence implementation to filter out notifications that were initiated by the subscribing instance itself.
-     * @param callback The function to call when the global persisted data changes from *another* source. The new state (`T`) is passed as an argument to this callback.
-     * @returns A function that, when called, will unsubscribe the provided callback from future updates. Call this when your component or instance is no longer active to prevent memory leaks.
-     */
-    subscribe(id: string, callback: (state: T) => void): () => void;
-    /**
-     * Clears (removes) the entire global persisted data from storage.
-     *
-     * @returns `true` if the operation was successful, `false` if an error occurred. For asynchronous implementations, this returns a `Promise<boolean>`.
-     */
-    clear(): boolean | Promise<boolean>;
-    /**
-     * Returns metadata about the persistence layer.
-     *
-     * This is useful for distinguishing between multiple apps running on the same host
-     * (e.g., several apps served at `localhost:3000` that share the same storage key).
-     *
-     * @returns An object containing:
-     * - `version`: The semantic version string of the persistence schema or application.
-     * - `id`: A unique identifier for the application using this persistence instance.
-     */
-    stats(): {
-        version: string;
-        id: string;
-    };
-}
-interface StorageEvents {
-    "store:updated": {
-        storageKey: string;
-        instanceId: string;
-        state: any;
-        timestamp?: number;
-        version: string;
-        app: string;
-    };
-}
-/**
- * Configuration options specific to the WebStoragePersistence adapter.
- */
-interface WebStoragePersistenceConfig {
-    /**
-     * The key under which data is stored in web storage (e.g., 'user-profile').
-     */
-    storageKey: string;
-    /**
-     * If true, uses sessionStorage instead of localStorage. Defaults to false.
-     */
-    session?: boolean;
-}
-/**
- * Implements SimplePersistence using web storage (localStorage or sessionStorage).
- * Supports cross-tab synchronization and data versioning with upgrade handlers.
- */
-declare class WebStoragePersistence<T> implements SimplePersistence<T> {
-    private readonly eventBus;
-    private readonly storage;
-    private readonly config;
-    private initialized;
-    private initializationCallbacks;
-    constructor(config: StoreConfig<T> & WebStoragePersistenceConfig);
-    private initialize;
-    private _onInitialized;
-    private initializeEventBus;
-    private getStoreName;
-    private setupStorageEventListener;
-    set(instanceId: string, state: T): boolean;
-    private _get;
-    get(): Promise<T | null>;
-    subscribe(instanceId: string, onStateChange: (state: T) => void): () => void;
-    clear(): boolean;
-    stats(): {
-        version: string;
-        id: string;
-    };
-}
-interface IndexedDBPersistenceConfig {
-    store: string;
-    database: string;
-    collection: string;
-    enableTelemetry?: boolean;
-}
-declare class IndexedDBPersistence<T> implements SimplePersistence<T> {
-    private collection;
-    private collectionPromise;
-    private config;
-    private eventBus;
-    private initialized;
-    private _initializing;
-    private initializationCallbacks;
-    private doc;
-    private getStoreName;
-    constructor(config: StoreConfig<T> & IndexedDBPersistenceConfig);
-    private initialize;
-    private _onInitialized;
-    private getCollection;
-    /**
-     * Writes state.  Waits for initialisation (migration) to complete first.
-     */
-    set(id: string, state: T): Promise<boolean>;
-    private _read;
-    /**
-     * Returns the stored document data (after ensuring it has been
-     * fully read from the underlying store).  The `document.read()`
-     * call populates internal state and we then return the document
-     * itself which has all fields available.
-     */
-    private _get;
-    get(): Promise<T | null>;
-    subscribe(id: string, callback: (state: T) => void): () => void;
-    clear(): Promise<boolean>;
-    stats(): {
-        version: string;
-        id: string;
-    };
-    /**
-     * Closes this persistence instance, releasing our reference on the
-     * shared database.  The actual database connection is closed only
-     * when every active store has been released.
-     */
-    close(): Promise<void>;
-}
-/**
- * Implements SimplePersistence using an in-memory store.
- * Data is NOT persisted across page loads or application restarts.
- *
- * Synchronization: This class fully synchronizes its in-memory state across
- * different browser tabs using an event bus with a Last Write Wins (LWW) strategy.
- * When a state is set or cleared in one tab, the latest version (based on timestamp)
- * will propagate to and update the in-memory state of all other tabs.
- *
- * IMPORTANT: While the in-memory state is synchronized *across tabs*, it remains
- * ephemeral within each tab. Closing all tabs will result in data loss.
- *
- * Note: The best use case for this class is in tests where intergration with a
- * SimplePersistence is required.
- */
-declare class EphemeralPersistence<T> implements SimplePersistence<T> {
-    private readonly eventBus;
-    private inMemoryState;
-    private readonly config;
-    /**
-     * Initializes a new instance of EphemeralPersistence.
-     * @param config Configuration object for the persistence adapter.
-     */
-    constructor(config: StoreConfig<T> & {
-        storageKey: string;
-    });
-    /**
-     * Initializes the event bus with configured settings for cross-tab communication.
-     * @returns Configured event bus instance.
-     */
-    private initializeEventBus;
-    /**
-     * Sets up an internal listener to synchronize the in-memory state
-     * using the Last Write Wins (LWW) strategy.
-     */
-    private setupLwwSynchronizationListener;
-    /**
-     * Persists the provided state to in-memory storage and notifies all subscribers
-     * across tabs. The state is synchronized using LWW.
-     * @param instanceId Unique identifier of the instance making the update.
-     * @param state The state to persist.
-     * @returns True if successful, false if an error occurs.
-     */
-    set(instanceId: string, state: T): boolean;
-    /**
-     * Retrieves the current synchronized state from in-memory storage.
-     * @returns The synchronized state, or null if not set or if cleared.
-     */
-    get(): T | null;
-    /**
-     * Subscribes to updates in the in-memory state.
-     * The callback is invoked when the state is updated by any instance
-     * (including other tabs) *excluding the subscribing instance's own 'set' or 'clear' calls*.
-     * @param instanceId Unique identifier of the subscribing instance.
-     * @param onStateChange Callback to invoke with the updated state.
-     * @returns Function to unsubscribe from updates.
-     */
-    subscribe(instanceId: string, onStateChange: (state: T) => void): () => void;
-    /**
-     * Clears the in-memory state of this instance and synchronizes this clear
-     * across all tabs using the LWW strategy.
-     * @returns True if successful, false if an error occurs.
-     */
-    clear(): boolean;
-    /**
-     * Returns metadata about the persistence layer.
-     *
-     * @returns An object containing:
-     * - `version`: The semantic version string of the persistence schema or application.
-     * - `id`: A unique identifier for the application using this persistence instance.
-     */
-    stats(): {
-        version: string;
-        id: string;
-    };
-}
-export { EphemeralPersistence, IndexedDBPersistence, type IndexedDBPersistenceConfig, type SimplePersistence, type StorageEvents, type StoreConfig, WebStoragePersistence, type WebStoragePersistenceConfig };