@alwatr/nitrobase-engine 7.10.0 → 7.10.1

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [7.10.1](https://github.com/Alwatr/nitrobase/compare/v7.10.0...v7.10.1) (2025-12-14)
+
+### 🧹 Miscellaneous Chores
+
+* update tsconfig extends to use @alwatr/nanolib ([ffbc8ce](https://github.com/Alwatr/nitrobase/commit/ffbc8ce74d47d7f4e1ff0061722df10f68af11cc))
+
+### 🔗 Dependencies update
+
+* replace '@alwatr/nano-build' with '@alwatr/nanolib' in logger imports ([9a355b9](https://github.com/Alwatr/nitrobase/commit/9a355b92b27434a3cd132e7e52df5c2e112ca97e))
+* update `@alwatr/nanolib` and `@types/node` dependencies across all packages. ([bc6d96f](https://github.com/Alwatr/nitrobase/commit/bc6d96f4fd423bcfb817d74b526596669d8a8aed))
+* update dependencies and switch prettier config to @alwatr/nanolib ([e2c9ffb](https://github.com/Alwatr/nitrobase/commit/e2c9ffb5f62d88a1ddaef77886d41c0cb7df604d))
+
 ## [7.10.0](https://github.com/Alwatr/nitrobase/compare/v7.9.0...v7.10.0) (2025-09-21)
 
 ### 🐛 Bug Fixes

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/nitrobase-engine v7.10.0 */
-__dev_mode__: console.debug("📦 @alwatr/nitrobase-engine v7.10.0");
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{AlwatrNitrobase:()=>AlwatrNitrobase});module.exports=__toCommonJS(main_exports);var import_delay=require("@alwatr/delay");var import_exit_hook=require("@alwatr/exit-hook");var import_nitrobase_helper=require("@alwatr/nitrobase-helper");var import_nitrobase_reference=require("@alwatr/nitrobase-reference");var import_nitrobase_types=require("@alwatr/nitrobase-types");var import_node_fs=require("@alwatr/node-fs");var import_logger=require("@alwatr/logger");var logger=(0,import_logger.createLogger)("@alwatr/nitrobase-engine");__dev_mode__:logger.logFileModule?.("alwatr-nitrobase");var AlwatrNitrobase=class _AlwatrNitrobase{constructor(config){this.config=config;this.cacheReferences__={};this.storeChanged_=this.storeChanged_.bind(this);logger.logMethodArgs?.("new",config);this.config.defaultChangeDebounce??=40;this.rootDb__=this.loadRootDb__();(0,import_exit_hook.exitHook)(this.exitHook__.bind(this))}static{this.version="7.10.0"}static{this.rootDbStat__={name:".nitrobase",region:import_nitrobase_types.Region.Secret,type:import_nitrobase_types.StoreFileType.Collection,extension:import_nitrobase_types.StoreFileExtension.Json,changeDebounce:40}}hasStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);const exists=this.rootDb__.hasItem(id_);logger.logMethodFull?.("hasStore",id_,exists);return exists}newDocument(stat,data){logger.logMethodArgs?.("newDocument",stat);return this.newStoreFile__({...stat,type:import_nitrobase_types.StoreFileType.Document},data)}newCollection(stat){logger.logMethodArgs?.("newCollection",stat);return this.newStoreFile__({...stat,type:import_nitrobase_types.StoreFileType.Collection})}newStoreFile__(stat,data){logger.logMethodArgs?.("newStoreFile__",stat);stat.changeDebounce??=this.config.defaultChangeDebounce;let fileStoreRef;if(stat.type===import_nitrobase_types.StoreFileType.Document){if(data===void 0){logger.accident("newStoreFile__","document_data_required",stat);throw new Error("document_data_required",{cause:stat})}fileStoreRef=import_nitrobase_reference.DocumentReference.newRefFromData(stat,data,this.storeChanged_)}else if(stat.type===import_nitrobase_types.StoreFileType.Collection){fileStoreRef=import_nitrobase_reference.CollectionReference.newRefFromData(stat,this.storeChanged_)}else{logger.accident("newStoreFile__","store_file_type_not_supported",stat);throw new Error("store_file_type_not_supported",{cause:stat})}if(this.rootDb__.hasItem(fileStoreRef.id)){logger.accident("newStoreFile__","store_file_already_defined",stat);throw new Error("store_file_already_defined",{cause:stat})}this.rootDb__.addItem(fileStoreRef.id,stat);this.cacheReferences__[fileStoreRef.id]=fileStoreRef;this.storeChanged_(fileStoreRef)}async openDocument(documentId){const id=(0,import_nitrobase_helper.getStoreId)(documentId);logger.logMethodArgs?.("openDocument",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof import_nitrobase_reference.DocumentReference)){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openDocument","document_not_found",id);throw new Error("document_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=import_nitrobase_types.StoreFileType.Document){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}const context=await this.readContext__(storeStat);const docRef=import_nitrobase_reference.DocumentReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=docRef;return docRef}async openCollection(collectionId){const id=(0,import_nitrobase_helper.getStoreId)(collectionId);logger.logMethodArgs?.("openCollection",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof import_nitrobase_reference.CollectionReference)){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openCollection","collection_not_found",id);throw new Error("collection_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=import_nitrobase_types.StoreFileType.Collection){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_not_found",{cause:id})}const context=await this.readContext__(storeStat);const colRef=import_nitrobase_reference.CollectionReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=colRef;return colRef}unloadStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);logger.logMethodArgs?.("unloadStore",id_);const ref=this.cacheReferences__[id_];if(ref===void 0)return;if(ref.hasUnprocessedChanges_===true){ref.updateDelayed_=false;this.storeChanged_(ref)}delete this.cacheReferences__[id_]}async removeStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);logger.logMethodArgs?.("removeStore",id_);if(!this.rootDb__.hasItem(id_)){logger.accident("removeStore","document_not_found",id_);throw new Error("document_not_found",{cause:id_})}const ref=this.cacheReferences__[id_];if(ref!==void 0){ref.freeze=true;ref.updateDelayed_=false;ref.hasUnprocessedChanges_=false;delete this.cacheReferences__[id_]}const path=(0,import_nitrobase_helper.getStorePath)(this.rootDb__.getItemData(id_));this.rootDb__.removeItem(id_);await import_delay.delay.by(0);try{await(0,import_node_fs.unlink)((0,import_node_fs.resolve)(this.config.rootPath,path))}catch(error){logger.error("removeStore","remove_file_failed",error,{id:storeId,path})}}async saveAll(){logger.logMethod?.("saveAll");for(const ref of Object.values(this.cacheReferences__)){if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){ref.updateDelayed_=false;await this.storeChanged_(ref)}}}async readContext__(path){if(typeof path!=="string")path=(0,import_nitrobase_helper.getStorePath)(path);logger.logMethodArgs?.("readContext__",path);logger.time?.(`readContext__time(${path})`);const context=await(0,import_node_fs.readJson)((0,import_node_fs.resolve)(this.config.rootPath,path));logger.timeEnd?.(`readContext__time(${path})`);return context}writeContext__(path,context){if(typeof path!=="string")path=(0,import_nitrobase_helper.getStorePath)(path);logger.logMethodArgs?.("writeContext__",path);return(0,import_node_fs.writeJson)((0,import_node_fs.resolve)(this.config.rootPath,path),context)}async storeChanged_(from){logger.logMethodArgs?.("storeChanged__",from.id);const rev=from.getStoreMeta().rev;try{await this.writeContext__(from.path,from.getFullContext_());if(rev===from.getStoreMeta().rev){from.hasUnprocessedChanges_=false}}catch(error){logger.error("storeChanged__","write_context_failed",{id:from.id,error})}}loadRootDb__(){logger.logMethod?.("loadRootDb__");const fullPath=(0,import_node_fs.resolve)(this.config.rootPath,(0,import_nitrobase_helper.getStorePath)(_AlwatrNitrobase.rootDbStat__));if(!(0,import_node_fs.existsSync)(fullPath)){if(this.config.errorWhenNotInitialized===true){throw new Error("store_not_found",{cause:"Nitrobase not initialized"})}logger.banner("Initialize new alwatr-nitrobase");return import_nitrobase_reference.CollectionReference.newRefFromData(_AlwatrNitrobase.rootDbStat__,this.storeChanged_)}const context=(0,import_node_fs.readJson)(fullPath,true);return import_nitrobase_reference.CollectionReference.newRefFromContext(context,this.storeChanged_,"root-db")}exitHook__(){logger.logMethod?.("exitHook__");for(const ref of Object.values(this.cacheReferences__)){logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`,ref.hasUnprocessedChanges_);if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){logger.incident?.("exitHook__","rescue_unsaved_context",{id:ref.id});(0,import_node_fs.writeJson)((0,import_node_fs.resolve)(this.config.rootPath,ref.path),ref.getFullContext_(),true);ref.hasUnprocessedChanges_=false}}}getStoreList(){logger.logMethod?.("getStoreList");return this.rootDb__.values()}};0&&(module.exports={AlwatrNitrobase});
+/** 📦 @alwatr/nitrobase-engine v7.10.1 */
+__dev_mode__: console.debug("📦 @alwatr/nitrobase-engine v7.10.1");
+"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{AlwatrNitrobase:()=>AlwatrNitrobase});module.exports=__toCommonJS(main_exports);var import_delay=require("@alwatr/delay");var import_exit_hook=require("@alwatr/exit-hook");var import_nitrobase_helper=require("@alwatr/nitrobase-helper");var import_nitrobase_reference=require("@alwatr/nitrobase-reference");var import_nitrobase_types=require("@alwatr/nitrobase-types");var import_node_fs=require("@alwatr/node-fs");var import_logger=require("@alwatr/logger");var logger=(0,import_logger.createLogger)("@alwatr/nitrobase-engine");__dev_mode__:logger.logFileModule?.("alwatr-nitrobase");var AlwatrNitrobase=class _AlwatrNitrobase{constructor(config){this.config=config;this.cacheReferences__={};this.storeChanged_=this.storeChanged_.bind(this);logger.logMethodArgs?.("new",config);this.config.defaultChangeDebounce??=40;this.rootDb__=this.loadRootDb__();(0,import_exit_hook.exitHook)(this.exitHook__.bind(this))}static{this.version="7.10.1"}static{this.rootDbStat__={name:".nitrobase",region:import_nitrobase_types.Region.Secret,type:import_nitrobase_types.StoreFileType.Collection,extension:import_nitrobase_types.StoreFileExtension.Json,changeDebounce:40}}hasStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);const exists=this.rootDb__.hasItem(id_);logger.logMethodFull?.("hasStore",id_,exists);return exists}newDocument(stat,data){logger.logMethodArgs?.("newDocument",stat);return this.newStoreFile__({...stat,type:import_nitrobase_types.StoreFileType.Document},data)}newCollection(stat){logger.logMethodArgs?.("newCollection",stat);return this.newStoreFile__({...stat,type:import_nitrobase_types.StoreFileType.Collection})}newStoreFile__(stat,data){logger.logMethodArgs?.("newStoreFile__",stat);stat.changeDebounce??=this.config.defaultChangeDebounce;let fileStoreRef;if(stat.type===import_nitrobase_types.StoreFileType.Document){if(data===void 0){logger.accident("newStoreFile__","document_data_required",stat);throw new Error("document_data_required",{cause:stat})}fileStoreRef=import_nitrobase_reference.DocumentReference.newRefFromData(stat,data,this.storeChanged_)}else if(stat.type===import_nitrobase_types.StoreFileType.Collection){fileStoreRef=import_nitrobase_reference.CollectionReference.newRefFromData(stat,this.storeChanged_)}else{logger.accident("newStoreFile__","store_file_type_not_supported",stat);throw new Error("store_file_type_not_supported",{cause:stat})}if(this.rootDb__.hasItem(fileStoreRef.id)){logger.accident("newStoreFile__","store_file_already_defined",stat);throw new Error("store_file_already_defined",{cause:stat})}this.rootDb__.addItem(fileStoreRef.id,stat);this.cacheReferences__[fileStoreRef.id]=fileStoreRef;this.storeChanged_(fileStoreRef)}async openDocument(documentId){const id=(0,import_nitrobase_helper.getStoreId)(documentId);logger.logMethodArgs?.("openDocument",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof import_nitrobase_reference.DocumentReference)){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openDocument","document_not_found",id);throw new Error("document_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=import_nitrobase_types.StoreFileType.Document){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}const context=await this.readContext__(storeStat);const docRef=import_nitrobase_reference.DocumentReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=docRef;return docRef}async openCollection(collectionId){const id=(0,import_nitrobase_helper.getStoreId)(collectionId);logger.logMethodArgs?.("openCollection",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof import_nitrobase_reference.CollectionReference)){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openCollection","collection_not_found",id);throw new Error("collection_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=import_nitrobase_types.StoreFileType.Collection){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_not_found",{cause:id})}const context=await this.readContext__(storeStat);const colRef=import_nitrobase_reference.CollectionReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=colRef;return colRef}unloadStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);logger.logMethodArgs?.("unloadStore",id_);const ref=this.cacheReferences__[id_];if(ref===void 0)return;if(ref.hasUnprocessedChanges_===true){ref.updateDelayed_=false;this.storeChanged_(ref)}delete this.cacheReferences__[id_]}async removeStore(storeId){const id_=(0,import_nitrobase_helper.getStoreId)(storeId);logger.logMethodArgs?.("removeStore",id_);if(!this.rootDb__.hasItem(id_)){logger.accident("removeStore","document_not_found",id_);throw new Error("document_not_found",{cause:id_})}const ref=this.cacheReferences__[id_];if(ref!==void 0){ref.freeze=true;ref.updateDelayed_=false;ref.hasUnprocessedChanges_=false;delete this.cacheReferences__[id_]}const path=(0,import_nitrobase_helper.getStorePath)(this.rootDb__.getItemData(id_));this.rootDb__.removeItem(id_);await import_delay.delay.by(0);try{await(0,import_node_fs.unlink)((0,import_node_fs.resolve)(this.config.rootPath,path))}catch(error){logger.error("removeStore","remove_file_failed",error,{id:storeId,path})}}async saveAll(){logger.logMethod?.("saveAll");for(const ref of Object.values(this.cacheReferences__)){if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){ref.updateDelayed_=false;await this.storeChanged_(ref)}}}async readContext__(path){if(typeof path!=="string")path=(0,import_nitrobase_helper.getStorePath)(path);logger.logMethodArgs?.("readContext__",path);logger.time?.(`readContext__time(${path})`);const context=await(0,import_node_fs.readJson)((0,import_node_fs.resolve)(this.config.rootPath,path));logger.timeEnd?.(`readContext__time(${path})`);return context}writeContext__(path,context){if(typeof path!=="string")path=(0,import_nitrobase_helper.getStorePath)(path);logger.logMethodArgs?.("writeContext__",path);return(0,import_node_fs.writeJson)((0,import_node_fs.resolve)(this.config.rootPath,path),context)}async storeChanged_(from){logger.logMethodArgs?.("storeChanged__",from.id);const rev=from.getStoreMeta().rev;try{await this.writeContext__(from.path,from.getFullContext_());if(rev===from.getStoreMeta().rev){from.hasUnprocessedChanges_=false}}catch(error){logger.error("storeChanged__","write_context_failed",{id:from.id,error})}}loadRootDb__(){logger.logMethod?.("loadRootDb__");const fullPath=(0,import_node_fs.resolve)(this.config.rootPath,(0,import_nitrobase_helper.getStorePath)(_AlwatrNitrobase.rootDbStat__));if(!(0,import_node_fs.existsSync)(fullPath)){if(this.config.errorWhenNotInitialized===true){throw new Error("store_not_found",{cause:"Nitrobase not initialized"})}logger.banner("Initialize new alwatr-nitrobase");return import_nitrobase_reference.CollectionReference.newRefFromData(_AlwatrNitrobase.rootDbStat__,this.storeChanged_)}const context=(0,import_node_fs.readJson)(fullPath,true);return import_nitrobase_reference.CollectionReference.newRefFromContext(context,this.storeChanged_,"root-db")}exitHook__(){logger.logMethod?.("exitHook__");for(const ref of Object.values(this.cacheReferences__)){logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`,ref.hasUnprocessedChanges_);if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){logger.incident?.("exitHook__","rescue_unsaved_context",{id:ref.id});(0,import_node_fs.writeJson)((0,import_node_fs.resolve)(this.config.rootPath,ref.path),ref.getFullContext_(),true);ref.hasUnprocessedChanges_=false}}}getStoreList(){logger.logMethod?.("getStoreList");return this.rootDb__.values()}};0&&(module.exports={AlwatrNitrobase});
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts", "../src/alwatr-nitrobase.ts", "../src/logger.ts"],
-  "sourcesContent": ["export * from './alwatr-nitrobase.js';\n", "import {delay} from '@alwatr/delay';\nimport {exitHook} from '@alwatr/exit-hook';\nimport {getStoreId, getStorePath} from '@alwatr/nitrobase-helper';\nimport {CollectionReference, DocumentReference} from '@alwatr/nitrobase-reference';\nimport {\n  StoreFileType,\n  StoreFileExtension,\n  Region,\n  type StoreFileStat,\n  type StoreFileContext,\n  type CollectionContext,\n  type DocumentContext,\n  type StoreFileId,\n  type CollectionItem,\n} from '@alwatr/nitrobase-types';\nimport {existsSync, readJson, resolve, unlink, writeJson} from '@alwatr/node-fs';\n\nimport {logger} from './logger.js';\n\n__dev_mode__: logger.logFileModule?.('alwatr-nitrobase');\n\n/**\n * AlwatrNitrobase configuration.\n */\nexport interface AlwatrNitrobaseConfig {\n  /**\n   * The root path of the storage.\n   * This is where the AlwatrNitrobase will nitrobase its data.\n   */\n  rootPath: string;\n\n  /**\n   * The save debounce timeout in milliseconds for minimal disk I/O usage.\n   * This is used to limit the frequency of disk writes for performance reasons.\n   * The recommended value is `40`.\n   */\n  defaultChangeDebounce?: number;\n\n  /**\n   * If true, an error will be thrown when trying to read or write to a nitrobase file that is not initialized (new storage).\n   * The default value is `false` but highly recommended to set it to `true` in production to prevent data loss.\n   */\n  errorWhenNotInitialized?: boolean;\n}\n\n/**\n * AlwatrNitrobase engine.\n *\n * It provides methods to read, write, validate, and manage nitrobase files.\n * It also provides methods to interact with `documents` and `collections` in the nitrobase.\n */\nexport class AlwatrNitrobase {\n  /**\n   * The Alwatr Nitrobase version string.\n   *\n   * Use for nitrobase file format version for check compatibility.\n   */\n  public static readonly version = __package_version__;\n\n  /**\n   * The root nitrobase file stat.\n   */\n  private static readonly rootDbStat__: StoreFileStat = {\n    name: '.nitrobase',\n    region: Region.Secret,\n    type: StoreFileType.Collection,\n    extension: StoreFileExtension.Json,\n    changeDebounce: 40,\n  };\n\n  /**\n   * `collectionReference` of all `storeFileStat`s.\n   * This is the root nitrobase collection.\n   */\n  private rootDb__;\n\n  /**\n   * Keep all loaded nitrobase file context loaded in memory.\n   */\n  private cacheReferences__: DictionaryReq<DocumentReference | CollectionReference> = {};\n\n  /**\n   * Constructs an AlwatrNitrobase instance with the provided configuration.\n   *\n   * @param config The configuration of the AlwatrNitrobase engine.\n   * @example\n   * ```typescript\n   * const alwatrStore = new AlwatrNitrobase({\n   *   rootPath: './db',\n   *   saveDebounce: 40,\n   * });\n   * ```\n   */\n  constructor(public readonly config: AlwatrNitrobaseConfig) {\n    this.storeChanged_ = this.storeChanged_.bind(this);\n\n    logger.logMethodArgs?.('new', config);\n    this.config.defaultChangeDebounce ??= 40;\n    this.rootDb__ = this.loadRootDb__();\n    exitHook(this.exitHook__.bind(this));\n  }\n\n  /**\n   * Checks if a nitrobase file with the given ID exists.\n   *\n   * @param storeId - The ID of the nitrobase file to check.\n   * @returns `true` if the nitrobase file exists, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!alwatrStore.hasStore('user1/profile')) {\n   *  alwatrStore.defineDocument(...)\n   * }\n   * ```\n   */\n  public hasStore(storeId: StoreFileId): boolean {\n    const id_ = getStoreId(storeId);\n    const exists = this.rootDb__.hasItem(id_);\n    logger.logMethodFull?.('hasStore', id_, exists);\n    return exists;\n  }\n\n  /**\n   * Defines a new document with the given configuration and initial data.\n   * If a document with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   * @template TDoc document data type\n   * @example\n   * ```typescript\n   * await alwatrStore.newDocument<Order>(\n   *   {\n   *     name: 'profile',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   },\n   *   {\n   *     name: 'Ali',\n   *     email: 'ali@alwatr.io',\n   *   }\n   * );\n   * ```\n   */\n  public newDocument<TDoc extends JsonObject = JsonObject>(stat: Omit<StoreFileStat, 'type'>, data: TDoc): void {\n    logger.logMethodArgs?.('newDocument', stat);\n    return this.newStoreFile__(\n      {\n        ...stat,\n        type: StoreFileType.Document,\n      },\n      data,\n    );\n  }\n\n  /**\n   * Defines a new collection with the given configuration and initial data.\n   * If a collection with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @example\n   * ```typescript\n   * await alwatrStore.newCollection<Order>(\n   *   {\n   *     name: 'orders',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   }\n   * );\n   * ```\n   */\n  public newCollection(stat: Omit<StoreFileStat, 'type'>): void {\n    logger.logMethodArgs?.('newCollection', stat);\n    return this.newStoreFile__({\n      ...stat,\n      type: StoreFileType.Collection,\n    });\n  }\n\n  /**\n   * Defines a AlwatrNitrobaseFile with the given configuration and initial data.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   */\n  private newStoreFile__(stat: StoreFileStat, data?: DictionaryOpt): void {\n    logger.logMethodArgs?.('newStoreFile__', stat);\n\n    (stat.changeDebounce as number | undefined) ??= this.config.defaultChangeDebounce;\n\n    let fileStoreRef: DocumentReference | CollectionReference;\n    if (stat.type === StoreFileType.Document) {\n      if (data === undefined) {\n        logger.accident('newStoreFile__', 'document_data_required', stat);\n        throw new Error('document_data_required', {cause: stat});\n      }\n      fileStoreRef = DocumentReference.newRefFromData(stat, data, this.storeChanged_);\n    }\n    else if (stat.type === StoreFileType.Collection) {\n      fileStoreRef = CollectionReference.newRefFromData(stat, this.storeChanged_);\n    }\n    else {\n      logger.accident('newStoreFile__', 'store_file_type_not_supported', stat);\n      throw new Error('store_file_type_not_supported', {cause: stat});\n    }\n\n    if (this.rootDb__.hasItem(fileStoreRef.id)) {\n      logger.accident('newStoreFile__', 'store_file_already_defined', stat);\n      throw new Error('store_file_already_defined', {cause: stat});\n    }\n\n    this.rootDb__.addItem(fileStoreRef.id, stat);\n    this.cacheReferences__[fileStoreRef.id] = fileStoreRef;\n\n    // fileStoreRef.save();\n    this.storeChanged_(fileStoreRef);\n  }\n\n  /**\n   * Open a document with the given id and create and return a DocumentReference.\n   * If the document not exists or its not a document, an error is thrown.\n   *\n   * @template TDoc document data type\n   * @param documentId document id {@link StoreFileId}\n   * @returns document reference {@link DocumentReference}\n   * @example\n   * ```typescript\n   * const userProfile = await alwatrStore.openDocument<User>({\n   *   name: 'user1/profile',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * userProfile.update({name: 'ali'});\n   * ```\n   */\n  public async openDocument<TDoc extends JsonObject>(documentId: StoreFileId): Promise<DocumentReference<TDoc>> {\n    const id = getStoreId(documentId);\n    logger.logMethodArgs?.('openDocument', id);\n\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof DocumentReference)) {\n        logger.accident('openDocument', 'document_wrong_type', id);\n        throw new Error('document_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as DocumentReference<TDoc>;\n    }\n\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openDocument', 'document_not_found', id);\n      throw new Error('document_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Document) {\n      logger.accident('openDocument', 'document_wrong_type', id);\n      throw new Error('document_wrong_type', {cause: id});\n    }\n\n    const context = await this.readContext__<DocumentContext<TDoc>>(storeStat);\n    const docRef = DocumentReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = docRef as unknown as DocumentReference;\n    return docRef;\n  }\n\n  /**\n   * Open a collection with the given id and create and return a CollectionReference.\n   * If the collection not exists or its not a collection, an error is thrown.\n   *\n   * @template TItem collection item data type\n   * @param collectionId collection id {@link StoreFileId}\n   * @returns collection reference {@link CollectionReference}\n   * @example\n   * ```typescript\n   * const orders = await alwatrStore.openCollection<Order>({\n   *   name: 'orders',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * orders.append({name: 'order 1'});\n   * ```\n   */\n  public async openCollection<TItem extends JsonObject>(collectionId: StoreFileId): Promise<CollectionReference<TItem>> {\n    const id = getStoreId(collectionId);\n    logger.logMethodArgs?.('openCollection', id);\n\n    // try to get from cache\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof CollectionReference)) {\n        logger.accident('openCollection', 'collection_wrong_type', id);\n        throw new Error('collection_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as CollectionReference<TItem>;\n    }\n\n    // load and create new collection reference\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openCollection', 'collection_not_found', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Collection) {\n      logger.accident('openCollection', 'collection_wrong_type', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const context = await this.readContext__<CollectionContext<TItem>>(storeStat);\n    const colRef = CollectionReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = colRef as unknown as CollectionReference;\n    return colRef;\n  }\n\n  /**\n   * Unloads the nitrobase file with the given id from memory.\n   *\n   * @param storeId The unique identifier of the nitrobase file. {@link StoreFileId}\n   * @example\n   * ```typescript\n   * alwatrStore.unloadStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // true\n   * ```\n   */\n  public unloadStore(storeId: StoreFileId): void {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('unloadStore', id_);\n    const ref = this.cacheReferences__[id_];\n    if (ref === undefined) return;\n    if (ref.hasUnprocessedChanges_ === true) {\n      ref.updateDelayed_ = false;\n      this.storeChanged_(ref);\n    }\n    delete this.cacheReferences__[id_];\n  }\n\n  /**\n   * Remove document or collection from nitrobase and delete the file from disk.\n   * If the file is not found, an error is thrown.\n   * If the file is not unloaded, it will be unloaded first.\n   * You don't need to await this method to complete unless you want to make sure the file is deleted on disk.\n   *\n   * @param storeId The ID of the file to delete. {@link StoreFileId}\n   * @returns A Promise that resolves when the file is deleted.\n   * @example\n   * ```typescript\n   * alwatrStore.removeStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // false\n   * ```\n   */\n  public async removeStore(storeId: StoreFileId): Promise<void> {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('removeStore', id_);\n    if (!this.rootDb__.hasItem(id_)) {\n      logger.accident('removeStore', 'document_not_found', id_);\n      throw new Error('document_not_found', {cause: id_});\n    }\n    const ref = this.cacheReferences__[id_];\n    if (ref !== undefined) {\n      // direct unload to prevent save\n      ref.freeze = true;\n      ref.updateDelayed_ = false;\n      ref.hasUnprocessedChanges_ = false;\n      delete this.cacheReferences__[id_]; // unload\n    }\n    const path = getStorePath(this.rootDb__.getItemData(id_));\n    this.rootDb__.removeItem(id_);\n    await delay.by(0);\n    try {\n      await unlink(resolve(this.config.rootPath, path));\n    }\n    catch (error) {\n      logger.error('removeStore', 'remove_file_failed', error, {id: storeId, path});\n    }\n  }\n\n  /**\n   * Saves all changes in the nitrobase.\n   *\n   * @returns A Promise that resolves when all changes are saved.\n   * @example\n   * ```typescript\n   * await alwatrStore.saveAll();\n   * ```\n   */\n  public async saveAll(): Promise<void> {\n    logger.logMethod?.('saveAll');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        ref.updateDelayed_ = false;\n        await this.storeChanged_(ref);\n      }\n    }\n  }\n\n  /**\n   * Reads the context from a given path or StoreFileStat object.\n   *\n   * @param path The path or StoreFileStat object from which to read the context.\n   * @returns A promise that resolves to the context object.\n   */\n  private async readContext__<T extends StoreFileContext>(path: string | StoreFileStat): Promise<T> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('readContext__', path);\n    logger.time?.(`readContext__time(${path})`);\n    const context = (await readJson(resolve(this.config.rootPath, path))) as T;\n    logger.timeEnd?.(`readContext__time(${path})`);\n    return context;\n  }\n\n  /**\n   * Writes the context to the specified path.\n   *\n   * @template T The type of the context.\n   * @param path The path where the context will be written.\n   * @param context The context to be written.\n   * @param sync Indicates whether the write operation should be synchronous.\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  private writeContext__<T extends StoreFileContext>(path: string | StoreFileStat, context: T): Promise<void> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('writeContext__', path);\n    return writeJson(resolve(this.config.rootPath, path), context);\n  }\n\n  /**\n   * Write nitrobase file context.\n   *\n   * @param from nitrobase file reference\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  protected async storeChanged_<T extends JsonObject>(from: DocumentReference<T> | CollectionReference<T>): Promise<void> {\n    logger.logMethodArgs?.('storeChanged__', from.id);\n    const rev = from.getStoreMeta().rev;\n    try {\n      await this.writeContext__(from.path, from.getFullContext_());\n      if (rev === from.getStoreMeta().rev) {\n        // Context not changed during saving\n        from.hasUnprocessedChanges_ = false;\n      }\n    }\n    catch (error) {\n      logger.error('storeChanged__', 'write_context_failed', {id: from.id, error});\n    }\n  }\n\n  /**\n   * Load storeFilesCollection or create new one.\n   */\n  private loadRootDb__(): CollectionReference<StoreFileStat> {\n    logger.logMethod?.('loadRootDb__');\n    const fullPath = resolve(this.config.rootPath, getStorePath(AlwatrNitrobase.rootDbStat__));\n    if (!existsSync(fullPath)) {\n      if (this.config.errorWhenNotInitialized === true) {\n        throw new Error('store_not_found', {cause: 'Nitrobase not initialized'});\n      }\n\n      logger.banner('Initialize new alwatr-nitrobase');\n      return CollectionReference.newRefFromData(AlwatrNitrobase.rootDbStat__, this.storeChanged_);\n    }\n    // else\n    const context = readJson<CollectionContext<StoreFileStat>>(fullPath, true);\n    return CollectionReference.newRefFromContext(context, this.storeChanged_, 'root-db');\n  }\n\n  /**\n   * Save all nitrobase files.\n   */\n  private exitHook__(): void {\n    logger.logMethod?.('exitHook__');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`, ref.hasUnprocessedChanges_);\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        logger.incident?.('exitHook__', 'rescue_unsaved_context', {id: ref.id});\n        writeJson(resolve(this.config.rootPath, ref.path), ref.getFullContext_(), true);\n        ref.hasUnprocessedChanges_ = false;\n      }\n    }\n  }\n\n  /**\n   * Get all nitrobase files.\n   *\n   * @returns all nitrobase files.\n   * @example\n   * ```typescript\n   * const storeList = alwatrStore.getStoreList();\n   * for (const nitrobase of storeList) {\n   *   console.log(nitrobase.meta.id, nitrobase.data);\n   * }\n   */\n  public getStoreList(): CollectionItem<Omit<StoreFileStat, 'schemaVer'>>[] {\n    logger.logMethod?.('getStoreList');\n    return this.rootDb__.values();\n  }\n}\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\nimport type {} from '@alwatr/type-helper';\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"],
+  "sourcesContent": ["export * from './alwatr-nitrobase.js';\n", "import {delay} from '@alwatr/delay';\nimport {exitHook} from '@alwatr/exit-hook';\nimport {getStoreId, getStorePath} from '@alwatr/nitrobase-helper';\nimport {CollectionReference, DocumentReference} from '@alwatr/nitrobase-reference';\nimport {\n  StoreFileType,\n  StoreFileExtension,\n  Region,\n  type StoreFileStat,\n  type StoreFileContext,\n  type CollectionContext,\n  type DocumentContext,\n  type StoreFileId,\n  type CollectionItem,\n} from '@alwatr/nitrobase-types';\nimport {existsSync, readJson, resolve, unlink, writeJson} from '@alwatr/node-fs';\n\nimport {logger} from './logger.js';\n\n__dev_mode__: logger.logFileModule?.('alwatr-nitrobase');\n\n/**\n * AlwatrNitrobase configuration.\n */\nexport interface AlwatrNitrobaseConfig {\n  /**\n   * The root path of the storage.\n   * This is where the AlwatrNitrobase will nitrobase its data.\n   */\n  rootPath: string;\n\n  /**\n   * The save debounce timeout in milliseconds for minimal disk I/O usage.\n   * This is used to limit the frequency of disk writes for performance reasons.\n   * The recommended value is `40`.\n   */\n  defaultChangeDebounce?: number;\n\n  /**\n   * If true, an error will be thrown when trying to read or write to a nitrobase file that is not initialized (new storage).\n   * The default value is `false` but highly recommended to set it to `true` in production to prevent data loss.\n   */\n  errorWhenNotInitialized?: boolean;\n}\n\n/**\n * AlwatrNitrobase engine.\n *\n * It provides methods to read, write, validate, and manage nitrobase files.\n * It also provides methods to interact with `documents` and `collections` in the nitrobase.\n */\nexport class AlwatrNitrobase {\n  /**\n   * The Alwatr Nitrobase version string.\n   *\n   * Use for nitrobase file format version for check compatibility.\n   */\n  public static readonly version = __package_version__;\n\n  /**\n   * The root nitrobase file stat.\n   */\n  private static readonly rootDbStat__: StoreFileStat = {\n    name: '.nitrobase',\n    region: Region.Secret,\n    type: StoreFileType.Collection,\n    extension: StoreFileExtension.Json,\n    changeDebounce: 40,\n  };\n\n  /**\n   * `collectionReference` of all `storeFileStat`s.\n   * This is the root nitrobase collection.\n   */\n  private rootDb__;\n\n  /**\n   * Keep all loaded nitrobase file context loaded in memory.\n   */\n  private cacheReferences__: DictionaryReq<DocumentReference | CollectionReference> = {};\n\n  /**\n   * Constructs an AlwatrNitrobase instance with the provided configuration.\n   *\n   * @param config The configuration of the AlwatrNitrobase engine.\n   * @example\n   * ```typescript\n   * const alwatrStore = new AlwatrNitrobase({\n   *   rootPath: './db',\n   *   saveDebounce: 40,\n   * });\n   * ```\n   */\n  constructor(public readonly config: AlwatrNitrobaseConfig) {\n    this.storeChanged_ = this.storeChanged_.bind(this);\n\n    logger.logMethodArgs?.('new', config);\n    this.config.defaultChangeDebounce ??= 40;\n    this.rootDb__ = this.loadRootDb__();\n    exitHook(this.exitHook__.bind(this));\n  }\n\n  /**\n   * Checks if a nitrobase file with the given ID exists.\n   *\n   * @param storeId - The ID of the nitrobase file to check.\n   * @returns `true` if the nitrobase file exists, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!alwatrStore.hasStore('user1/profile')) {\n   *  alwatrStore.defineDocument(...)\n   * }\n   * ```\n   */\n  public hasStore(storeId: StoreFileId): boolean {\n    const id_ = getStoreId(storeId);\n    const exists = this.rootDb__.hasItem(id_);\n    logger.logMethodFull?.('hasStore', id_, exists);\n    return exists;\n  }\n\n  /**\n   * Defines a new document with the given configuration and initial data.\n   * If a document with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   * @template TDoc document data type\n   * @example\n   * ```typescript\n   * await alwatrStore.newDocument<Order>(\n   *   {\n   *     name: 'profile',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   },\n   *   {\n   *     name: 'Ali',\n   *     email: 'ali@alwatr.io',\n   *   }\n   * );\n   * ```\n   */\n  public newDocument<TDoc extends JsonObject = JsonObject>(stat: Omit<StoreFileStat, 'type'>, data: TDoc): void {\n    logger.logMethodArgs?.('newDocument', stat);\n    return this.newStoreFile__(\n      {\n        ...stat,\n        type: StoreFileType.Document,\n      },\n      data,\n    );\n  }\n\n  /**\n   * Defines a new collection with the given configuration and initial data.\n   * If a collection with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @example\n   * ```typescript\n   * await alwatrStore.newCollection<Order>(\n   *   {\n   *     name: 'orders',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   }\n   * );\n   * ```\n   */\n  public newCollection(stat: Omit<StoreFileStat, 'type'>): void {\n    logger.logMethodArgs?.('newCollection', stat);\n    return this.newStoreFile__({\n      ...stat,\n      type: StoreFileType.Collection,\n    });\n  }\n\n  /**\n   * Defines a AlwatrNitrobaseFile with the given configuration and initial data.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   */\n  private newStoreFile__(stat: StoreFileStat, data?: DictionaryOpt): void {\n    logger.logMethodArgs?.('newStoreFile__', stat);\n\n    (stat.changeDebounce as number | undefined) ??= this.config.defaultChangeDebounce;\n\n    let fileStoreRef: DocumentReference | CollectionReference;\n    if (stat.type === StoreFileType.Document) {\n      if (data === undefined) {\n        logger.accident('newStoreFile__', 'document_data_required', stat);\n        throw new Error('document_data_required', {cause: stat});\n      }\n      fileStoreRef = DocumentReference.newRefFromData(stat, data, this.storeChanged_);\n    }\n    else if (stat.type === StoreFileType.Collection) {\n      fileStoreRef = CollectionReference.newRefFromData(stat, this.storeChanged_);\n    }\n    else {\n      logger.accident('newStoreFile__', 'store_file_type_not_supported', stat);\n      throw new Error('store_file_type_not_supported', {cause: stat});\n    }\n\n    if (this.rootDb__.hasItem(fileStoreRef.id)) {\n      logger.accident('newStoreFile__', 'store_file_already_defined', stat);\n      throw new Error('store_file_already_defined', {cause: stat});\n    }\n\n    this.rootDb__.addItem(fileStoreRef.id, stat);\n    this.cacheReferences__[fileStoreRef.id] = fileStoreRef;\n\n    // fileStoreRef.save();\n    this.storeChanged_(fileStoreRef);\n  }\n\n  /**\n   * Open a document with the given id and create and return a DocumentReference.\n   * If the document not exists or its not a document, an error is thrown.\n   *\n   * @template TDoc document data type\n   * @param documentId document id {@link StoreFileId}\n   * @returns document reference {@link DocumentReference}\n   * @example\n   * ```typescript\n   * const userProfile = await alwatrStore.openDocument<User>({\n   *   name: 'user1/profile',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * userProfile.update({name: 'ali'});\n   * ```\n   */\n  public async openDocument<TDoc extends JsonObject>(documentId: StoreFileId): Promise<DocumentReference<TDoc>> {\n    const id = getStoreId(documentId);\n    logger.logMethodArgs?.('openDocument', id);\n\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof DocumentReference)) {\n        logger.accident('openDocument', 'document_wrong_type', id);\n        throw new Error('document_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as DocumentReference<TDoc>;\n    }\n\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openDocument', 'document_not_found', id);\n      throw new Error('document_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Document) {\n      logger.accident('openDocument', 'document_wrong_type', id);\n      throw new Error('document_wrong_type', {cause: id});\n    }\n\n    const context = await this.readContext__<DocumentContext<TDoc>>(storeStat);\n    const docRef = DocumentReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = docRef as unknown as DocumentReference;\n    return docRef;\n  }\n\n  /**\n   * Open a collection with the given id and create and return a CollectionReference.\n   * If the collection not exists or its not a collection, an error is thrown.\n   *\n   * @template TItem collection item data type\n   * @param collectionId collection id {@link StoreFileId}\n   * @returns collection reference {@link CollectionReference}\n   * @example\n   * ```typescript\n   * const orders = await alwatrStore.openCollection<Order>({\n   *   name: 'orders',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * orders.append({name: 'order 1'});\n   * ```\n   */\n  public async openCollection<TItem extends JsonObject>(collectionId: StoreFileId): Promise<CollectionReference<TItem>> {\n    const id = getStoreId(collectionId);\n    logger.logMethodArgs?.('openCollection', id);\n\n    // try to get from cache\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof CollectionReference)) {\n        logger.accident('openCollection', 'collection_wrong_type', id);\n        throw new Error('collection_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as CollectionReference<TItem>;\n    }\n\n    // load and create new collection reference\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openCollection', 'collection_not_found', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Collection) {\n      logger.accident('openCollection', 'collection_wrong_type', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const context = await this.readContext__<CollectionContext<TItem>>(storeStat);\n    const colRef = CollectionReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = colRef as unknown as CollectionReference;\n    return colRef;\n  }\n\n  /**\n   * Unloads the nitrobase file with the given id from memory.\n   *\n   * @param storeId The unique identifier of the nitrobase file. {@link StoreFileId}\n   * @example\n   * ```typescript\n   * alwatrStore.unloadStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // true\n   * ```\n   */\n  public unloadStore(storeId: StoreFileId): void {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('unloadStore', id_);\n    const ref = this.cacheReferences__[id_];\n    if (ref === undefined) return;\n    if (ref.hasUnprocessedChanges_ === true) {\n      ref.updateDelayed_ = false;\n      this.storeChanged_(ref);\n    }\n    delete this.cacheReferences__[id_];\n  }\n\n  /**\n   * Remove document or collection from nitrobase and delete the file from disk.\n   * If the file is not found, an error is thrown.\n   * If the file is not unloaded, it will be unloaded first.\n   * You don't need to await this method to complete unless you want to make sure the file is deleted on disk.\n   *\n   * @param storeId The ID of the file to delete. {@link StoreFileId}\n   * @returns A Promise that resolves when the file is deleted.\n   * @example\n   * ```typescript\n   * alwatrStore.removeStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // false\n   * ```\n   */\n  public async removeStore(storeId: StoreFileId): Promise<void> {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('removeStore', id_);\n    if (!this.rootDb__.hasItem(id_)) {\n      logger.accident('removeStore', 'document_not_found', id_);\n      throw new Error('document_not_found', {cause: id_});\n    }\n    const ref = this.cacheReferences__[id_];\n    if (ref !== undefined) {\n      // direct unload to prevent save\n      ref.freeze = true;\n      ref.updateDelayed_ = false;\n      ref.hasUnprocessedChanges_ = false;\n      delete this.cacheReferences__[id_]; // unload\n    }\n    const path = getStorePath(this.rootDb__.getItemData(id_));\n    this.rootDb__.removeItem(id_);\n    await delay.by(0);\n    try {\n      await unlink(resolve(this.config.rootPath, path));\n    }\n    catch (error) {\n      logger.error('removeStore', 'remove_file_failed', error, {id: storeId, path});\n    }\n  }\n\n  /**\n   * Saves all changes in the nitrobase.\n   *\n   * @returns A Promise that resolves when all changes are saved.\n   * @example\n   * ```typescript\n   * await alwatrStore.saveAll();\n   * ```\n   */\n  public async saveAll(): Promise<void> {\n    logger.logMethod?.('saveAll');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        ref.updateDelayed_ = false;\n        await this.storeChanged_(ref);\n      }\n    }\n  }\n\n  /**\n   * Reads the context from a given path or StoreFileStat object.\n   *\n   * @param path The path or StoreFileStat object from which to read the context.\n   * @returns A promise that resolves to the context object.\n   */\n  private async readContext__<T extends StoreFileContext>(path: string | StoreFileStat): Promise<T> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('readContext__', path);\n    logger.time?.(`readContext__time(${path})`);\n    const context = (await readJson(resolve(this.config.rootPath, path))) as T;\n    logger.timeEnd?.(`readContext__time(${path})`);\n    return context;\n  }\n\n  /**\n   * Writes the context to the specified path.\n   *\n   * @template T The type of the context.\n   * @param path The path where the context will be written.\n   * @param context The context to be written.\n   * @param sync Indicates whether the write operation should be synchronous.\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  private writeContext__<T extends StoreFileContext>(path: string | StoreFileStat, context: T): Promise<void> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('writeContext__', path);\n    return writeJson(resolve(this.config.rootPath, path), context);\n  }\n\n  /**\n   * Write nitrobase file context.\n   *\n   * @param from nitrobase file reference\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  protected async storeChanged_<T extends JsonObject>(from: DocumentReference<T> | CollectionReference<T>): Promise<void> {\n    logger.logMethodArgs?.('storeChanged__', from.id);\n    const rev = from.getStoreMeta().rev;\n    try {\n      await this.writeContext__(from.path, from.getFullContext_());\n      if (rev === from.getStoreMeta().rev) {\n        // Context not changed during saving\n        from.hasUnprocessedChanges_ = false;\n      }\n    }\n    catch (error) {\n      logger.error('storeChanged__', 'write_context_failed', {id: from.id, error});\n    }\n  }\n\n  /**\n   * Load storeFilesCollection or create new one.\n   */\n  private loadRootDb__(): CollectionReference<StoreFileStat> {\n    logger.logMethod?.('loadRootDb__');\n    const fullPath = resolve(this.config.rootPath, getStorePath(AlwatrNitrobase.rootDbStat__));\n    if (!existsSync(fullPath)) {\n      if (this.config.errorWhenNotInitialized === true) {\n        throw new Error('store_not_found', {cause: 'Nitrobase not initialized'});\n      }\n\n      logger.banner('Initialize new alwatr-nitrobase');\n      return CollectionReference.newRefFromData(AlwatrNitrobase.rootDbStat__, this.storeChanged_);\n    }\n    // else\n    const context = readJson<CollectionContext<StoreFileStat>>(fullPath, true);\n    return CollectionReference.newRefFromContext(context, this.storeChanged_, 'root-db');\n  }\n\n  /**\n   * Save all nitrobase files.\n   */\n  private exitHook__(): void {\n    logger.logMethod?.('exitHook__');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`, ref.hasUnprocessedChanges_);\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        logger.incident?.('exitHook__', 'rescue_unsaved_context', {id: ref.id});\n        writeJson(resolve(this.config.rootPath, ref.path), ref.getFullContext_(), true);\n        ref.hasUnprocessedChanges_ = false;\n      }\n    }\n  }\n\n  /**\n   * Get all nitrobase files.\n   *\n   * @returns all nitrobase files.\n   * @example\n   * ```typescript\n   * const storeList = alwatrStore.getStoreList();\n   * for (const nitrobase of storeList) {\n   *   console.log(nitrobase.meta.id, nitrobase.data);\n   * }\n   */\n  public getStoreList(): CollectionItem<Omit<StoreFileStat, 'schemaVer'>>[] {\n    logger.logMethod?.('getStoreList');\n    return this.rootDb__.values();\n  }\n}\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nanolib';\nimport type {} from '@alwatr/type-helper';\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"],
   "mappings": "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",
   "names": []
 }

package/dist/main.mjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/nitrobase-engine v7.10.0 */
-__dev_mode__: console.debug("📦 @alwatr/nitrobase-engine v7.10.0");
-import{delay}from"@alwatr/delay";import{exitHook}from"@alwatr/exit-hook";import{getStoreId,getStorePath}from"@alwatr/nitrobase-helper";import{CollectionReference,DocumentReference}from"@alwatr/nitrobase-reference";import{StoreFileType,StoreFileExtension,Region}from"@alwatr/nitrobase-types";import{existsSync,readJson,resolve,unlink,writeJson}from"@alwatr/node-fs";import{createLogger}from"@alwatr/logger";var logger=createLogger("@alwatr/nitrobase-engine");__dev_mode__:logger.logFileModule?.("alwatr-nitrobase");var AlwatrNitrobase=class _AlwatrNitrobase{constructor(config){this.config=config;this.cacheReferences__={};this.storeChanged_=this.storeChanged_.bind(this);logger.logMethodArgs?.("new",config);this.config.defaultChangeDebounce??=40;this.rootDb__=this.loadRootDb__();exitHook(this.exitHook__.bind(this))}static{this.version="7.10.0"}static{this.rootDbStat__={name:".nitrobase",region:Region.Secret,type:StoreFileType.Collection,extension:StoreFileExtension.Json,changeDebounce:40}}hasStore(storeId){const id_=getStoreId(storeId);const exists=this.rootDb__.hasItem(id_);logger.logMethodFull?.("hasStore",id_,exists);return exists}newDocument(stat,data){logger.logMethodArgs?.("newDocument",stat);return this.newStoreFile__({...stat,type:StoreFileType.Document},data)}newCollection(stat){logger.logMethodArgs?.("newCollection",stat);return this.newStoreFile__({...stat,type:StoreFileType.Collection})}newStoreFile__(stat,data){logger.logMethodArgs?.("newStoreFile__",stat);stat.changeDebounce??=this.config.defaultChangeDebounce;let fileStoreRef;if(stat.type===StoreFileType.Document){if(data===void 0){logger.accident("newStoreFile__","document_data_required",stat);throw new Error("document_data_required",{cause:stat})}fileStoreRef=DocumentReference.newRefFromData(stat,data,this.storeChanged_)}else if(stat.type===StoreFileType.Collection){fileStoreRef=CollectionReference.newRefFromData(stat,this.storeChanged_)}else{logger.accident("newStoreFile__","store_file_type_not_supported",stat);throw new Error("store_file_type_not_supported",{cause:stat})}if(this.rootDb__.hasItem(fileStoreRef.id)){logger.accident("newStoreFile__","store_file_already_defined",stat);throw new Error("store_file_already_defined",{cause:stat})}this.rootDb__.addItem(fileStoreRef.id,stat);this.cacheReferences__[fileStoreRef.id]=fileStoreRef;this.storeChanged_(fileStoreRef)}async openDocument(documentId){const id=getStoreId(documentId);logger.logMethodArgs?.("openDocument",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof DocumentReference)){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openDocument","document_not_found",id);throw new Error("document_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=StoreFileType.Document){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}const context=await this.readContext__(storeStat);const docRef=DocumentReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=docRef;return docRef}async openCollection(collectionId){const id=getStoreId(collectionId);logger.logMethodArgs?.("openCollection",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof CollectionReference)){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openCollection","collection_not_found",id);throw new Error("collection_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=StoreFileType.Collection){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_not_found",{cause:id})}const context=await this.readContext__(storeStat);const colRef=CollectionReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=colRef;return colRef}unloadStore(storeId){const id_=getStoreId(storeId);logger.logMethodArgs?.("unloadStore",id_);const ref=this.cacheReferences__[id_];if(ref===void 0)return;if(ref.hasUnprocessedChanges_===true){ref.updateDelayed_=false;this.storeChanged_(ref)}delete this.cacheReferences__[id_]}async removeStore(storeId){const id_=getStoreId(storeId);logger.logMethodArgs?.("removeStore",id_);if(!this.rootDb__.hasItem(id_)){logger.accident("removeStore","document_not_found",id_);throw new Error("document_not_found",{cause:id_})}const ref=this.cacheReferences__[id_];if(ref!==void 0){ref.freeze=true;ref.updateDelayed_=false;ref.hasUnprocessedChanges_=false;delete this.cacheReferences__[id_]}const path=getStorePath(this.rootDb__.getItemData(id_));this.rootDb__.removeItem(id_);await delay.by(0);try{await unlink(resolve(this.config.rootPath,path))}catch(error){logger.error("removeStore","remove_file_failed",error,{id:storeId,path})}}async saveAll(){logger.logMethod?.("saveAll");for(const ref of Object.values(this.cacheReferences__)){if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){ref.updateDelayed_=false;await this.storeChanged_(ref)}}}async readContext__(path){if(typeof path!=="string")path=getStorePath(path);logger.logMethodArgs?.("readContext__",path);logger.time?.(`readContext__time(${path})`);const context=await readJson(resolve(this.config.rootPath,path));logger.timeEnd?.(`readContext__time(${path})`);return context}writeContext__(path,context){if(typeof path!=="string")path=getStorePath(path);logger.logMethodArgs?.("writeContext__",path);return writeJson(resolve(this.config.rootPath,path),context)}async storeChanged_(from){logger.logMethodArgs?.("storeChanged__",from.id);const rev=from.getStoreMeta().rev;try{await this.writeContext__(from.path,from.getFullContext_());if(rev===from.getStoreMeta().rev){from.hasUnprocessedChanges_=false}}catch(error){logger.error("storeChanged__","write_context_failed",{id:from.id,error})}}loadRootDb__(){logger.logMethod?.("loadRootDb__");const fullPath=resolve(this.config.rootPath,getStorePath(_AlwatrNitrobase.rootDbStat__));if(!existsSync(fullPath)){if(this.config.errorWhenNotInitialized===true){throw new Error("store_not_found",{cause:"Nitrobase not initialized"})}logger.banner("Initialize new alwatr-nitrobase");return CollectionReference.newRefFromData(_AlwatrNitrobase.rootDbStat__,this.storeChanged_)}const context=readJson(fullPath,true);return CollectionReference.newRefFromContext(context,this.storeChanged_,"root-db")}exitHook__(){logger.logMethod?.("exitHook__");for(const ref of Object.values(this.cacheReferences__)){logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`,ref.hasUnprocessedChanges_);if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){logger.incident?.("exitHook__","rescue_unsaved_context",{id:ref.id});writeJson(resolve(this.config.rootPath,ref.path),ref.getFullContext_(),true);ref.hasUnprocessedChanges_=false}}}getStoreList(){logger.logMethod?.("getStoreList");return this.rootDb__.values()}};export{AlwatrNitrobase};
+/** 📦 @alwatr/nitrobase-engine v7.10.1 */
+__dev_mode__: console.debug("📦 @alwatr/nitrobase-engine v7.10.1");
+import{delay}from"@alwatr/delay";import{exitHook}from"@alwatr/exit-hook";import{getStoreId,getStorePath}from"@alwatr/nitrobase-helper";import{CollectionReference,DocumentReference}from"@alwatr/nitrobase-reference";import{StoreFileType,StoreFileExtension,Region}from"@alwatr/nitrobase-types";import{existsSync,readJson,resolve,unlink,writeJson}from"@alwatr/node-fs";import{createLogger}from"@alwatr/logger";var logger=createLogger("@alwatr/nitrobase-engine");__dev_mode__:logger.logFileModule?.("alwatr-nitrobase");var AlwatrNitrobase=class _AlwatrNitrobase{constructor(config){this.config=config;this.cacheReferences__={};this.storeChanged_=this.storeChanged_.bind(this);logger.logMethodArgs?.("new",config);this.config.defaultChangeDebounce??=40;this.rootDb__=this.loadRootDb__();exitHook(this.exitHook__.bind(this))}static{this.version="7.10.1"}static{this.rootDbStat__={name:".nitrobase",region:Region.Secret,type:StoreFileType.Collection,extension:StoreFileExtension.Json,changeDebounce:40}}hasStore(storeId){const id_=getStoreId(storeId);const exists=this.rootDb__.hasItem(id_);logger.logMethodFull?.("hasStore",id_,exists);return exists}newDocument(stat,data){logger.logMethodArgs?.("newDocument",stat);return this.newStoreFile__({...stat,type:StoreFileType.Document},data)}newCollection(stat){logger.logMethodArgs?.("newCollection",stat);return this.newStoreFile__({...stat,type:StoreFileType.Collection})}newStoreFile__(stat,data){logger.logMethodArgs?.("newStoreFile__",stat);stat.changeDebounce??=this.config.defaultChangeDebounce;let fileStoreRef;if(stat.type===StoreFileType.Document){if(data===void 0){logger.accident("newStoreFile__","document_data_required",stat);throw new Error("document_data_required",{cause:stat})}fileStoreRef=DocumentReference.newRefFromData(stat,data,this.storeChanged_)}else if(stat.type===StoreFileType.Collection){fileStoreRef=CollectionReference.newRefFromData(stat,this.storeChanged_)}else{logger.accident("newStoreFile__","store_file_type_not_supported",stat);throw new Error("store_file_type_not_supported",{cause:stat})}if(this.rootDb__.hasItem(fileStoreRef.id)){logger.accident("newStoreFile__","store_file_already_defined",stat);throw new Error("store_file_already_defined",{cause:stat})}this.rootDb__.addItem(fileStoreRef.id,stat);this.cacheReferences__[fileStoreRef.id]=fileStoreRef;this.storeChanged_(fileStoreRef)}async openDocument(documentId){const id=getStoreId(documentId);logger.logMethodArgs?.("openDocument",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof DocumentReference)){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openDocument","document_not_found",id);throw new Error("document_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=StoreFileType.Document){logger.accident("openDocument","document_wrong_type",id);throw new Error("document_wrong_type",{cause:id})}const context=await this.readContext__(storeStat);const docRef=DocumentReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=docRef;return docRef}async openCollection(collectionId){const id=getStoreId(collectionId);logger.logMethodArgs?.("openCollection",id);if(Object.hasOwn(this.cacheReferences__,id)){const ref=this.cacheReferences__[id];if(!(ref instanceof CollectionReference)){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_wrong_type",{cause:id})}return this.cacheReferences__[id]}if(!this.rootDb__.hasItem(id)){logger.accident("openCollection","collection_not_found",id);throw new Error("collection_not_found",{cause:id})}const storeStat=this.rootDb__.getItemData(id);if(storeStat.type!=StoreFileType.Collection){logger.accident("openCollection","collection_wrong_type",id);throw new Error("collection_not_found",{cause:id})}const context=await this.readContext__(storeStat);const colRef=CollectionReference.newRefFromContext(context,this.storeChanged_);this.cacheReferences__[id]=colRef;return colRef}unloadStore(storeId){const id_=getStoreId(storeId);logger.logMethodArgs?.("unloadStore",id_);const ref=this.cacheReferences__[id_];if(ref===void 0)return;if(ref.hasUnprocessedChanges_===true){ref.updateDelayed_=false;this.storeChanged_(ref)}delete this.cacheReferences__[id_]}async removeStore(storeId){const id_=getStoreId(storeId);logger.logMethodArgs?.("removeStore",id_);if(!this.rootDb__.hasItem(id_)){logger.accident("removeStore","document_not_found",id_);throw new Error("document_not_found",{cause:id_})}const ref=this.cacheReferences__[id_];if(ref!==void 0){ref.freeze=true;ref.updateDelayed_=false;ref.hasUnprocessedChanges_=false;delete this.cacheReferences__[id_]}const path=getStorePath(this.rootDb__.getItemData(id_));this.rootDb__.removeItem(id_);await delay.by(0);try{await unlink(resolve(this.config.rootPath,path))}catch(error){logger.error("removeStore","remove_file_failed",error,{id:storeId,path})}}async saveAll(){logger.logMethod?.("saveAll");for(const ref of Object.values(this.cacheReferences__)){if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){ref.updateDelayed_=false;await this.storeChanged_(ref)}}}async readContext__(path){if(typeof path!=="string")path=getStorePath(path);logger.logMethodArgs?.("readContext__",path);logger.time?.(`readContext__time(${path})`);const context=await readJson(resolve(this.config.rootPath,path));logger.timeEnd?.(`readContext__time(${path})`);return context}writeContext__(path,context){if(typeof path!=="string")path=getStorePath(path);logger.logMethodArgs?.("writeContext__",path);return writeJson(resolve(this.config.rootPath,path),context)}async storeChanged_(from){logger.logMethodArgs?.("storeChanged__",from.id);const rev=from.getStoreMeta().rev;try{await this.writeContext__(from.path,from.getFullContext_());if(rev===from.getStoreMeta().rev){from.hasUnprocessedChanges_=false}}catch(error){logger.error("storeChanged__","write_context_failed",{id:from.id,error})}}loadRootDb__(){logger.logMethod?.("loadRootDb__");const fullPath=resolve(this.config.rootPath,getStorePath(_AlwatrNitrobase.rootDbStat__));if(!existsSync(fullPath)){if(this.config.errorWhenNotInitialized===true){throw new Error("store_not_found",{cause:"Nitrobase not initialized"})}logger.banner("Initialize new alwatr-nitrobase");return CollectionReference.newRefFromData(_AlwatrNitrobase.rootDbStat__,this.storeChanged_)}const context=readJson(fullPath,true);return CollectionReference.newRefFromContext(context,this.storeChanged_,"root-db")}exitHook__(){logger.logMethod?.("exitHook__");for(const ref of Object.values(this.cacheReferences__)){logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`,ref.hasUnprocessedChanges_);if(ref.hasUnprocessedChanges_===true&&ref.freeze!==true){logger.incident?.("exitHook__","rescue_unsaved_context",{id:ref.id});writeJson(resolve(this.config.rootPath,ref.path),ref.getFullContext_(),true);ref.hasUnprocessedChanges_=false}}}getStoreList(){logger.logMethod?.("getStoreList");return this.rootDb__.values()}};export{AlwatrNitrobase};
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/alwatr-nitrobase.ts", "../src/logger.ts"],
-  "sourcesContent": ["import {delay} from '@alwatr/delay';\nimport {exitHook} from '@alwatr/exit-hook';\nimport {getStoreId, getStorePath} from '@alwatr/nitrobase-helper';\nimport {CollectionReference, DocumentReference} from '@alwatr/nitrobase-reference';\nimport {\n  StoreFileType,\n  StoreFileExtension,\n  Region,\n  type StoreFileStat,\n  type StoreFileContext,\n  type CollectionContext,\n  type DocumentContext,\n  type StoreFileId,\n  type CollectionItem,\n} from '@alwatr/nitrobase-types';\nimport {existsSync, readJson, resolve, unlink, writeJson} from '@alwatr/node-fs';\n\nimport {logger} from './logger.js';\n\n__dev_mode__: logger.logFileModule?.('alwatr-nitrobase');\n\n/**\n * AlwatrNitrobase configuration.\n */\nexport interface AlwatrNitrobaseConfig {\n  /**\n   * The root path of the storage.\n   * This is where the AlwatrNitrobase will nitrobase its data.\n   */\n  rootPath: string;\n\n  /**\n   * The save debounce timeout in milliseconds for minimal disk I/O usage.\n   * This is used to limit the frequency of disk writes for performance reasons.\n   * The recommended value is `40`.\n   */\n  defaultChangeDebounce?: number;\n\n  /**\n   * If true, an error will be thrown when trying to read or write to a nitrobase file that is not initialized (new storage).\n   * The default value is `false` but highly recommended to set it to `true` in production to prevent data loss.\n   */\n  errorWhenNotInitialized?: boolean;\n}\n\n/**\n * AlwatrNitrobase engine.\n *\n * It provides methods to read, write, validate, and manage nitrobase files.\n * It also provides methods to interact with `documents` and `collections` in the nitrobase.\n */\nexport class AlwatrNitrobase {\n  /**\n   * The Alwatr Nitrobase version string.\n   *\n   * Use for nitrobase file format version for check compatibility.\n   */\n  public static readonly version = __package_version__;\n\n  /**\n   * The root nitrobase file stat.\n   */\n  private static readonly rootDbStat__: StoreFileStat = {\n    name: '.nitrobase',\n    region: Region.Secret,\n    type: StoreFileType.Collection,\n    extension: StoreFileExtension.Json,\n    changeDebounce: 40,\n  };\n\n  /**\n   * `collectionReference` of all `storeFileStat`s.\n   * This is the root nitrobase collection.\n   */\n  private rootDb__;\n\n  /**\n   * Keep all loaded nitrobase file context loaded in memory.\n   */\n  private cacheReferences__: DictionaryReq<DocumentReference | CollectionReference> = {};\n\n  /**\n   * Constructs an AlwatrNitrobase instance with the provided configuration.\n   *\n   * @param config The configuration of the AlwatrNitrobase engine.\n   * @example\n   * ```typescript\n   * const alwatrStore = new AlwatrNitrobase({\n   *   rootPath: './db',\n   *   saveDebounce: 40,\n   * });\n   * ```\n   */\n  constructor(public readonly config: AlwatrNitrobaseConfig) {\n    this.storeChanged_ = this.storeChanged_.bind(this);\n\n    logger.logMethodArgs?.('new', config);\n    this.config.defaultChangeDebounce ??= 40;\n    this.rootDb__ = this.loadRootDb__();\n    exitHook(this.exitHook__.bind(this));\n  }\n\n  /**\n   * Checks if a nitrobase file with the given ID exists.\n   *\n   * @param storeId - The ID of the nitrobase file to check.\n   * @returns `true` if the nitrobase file exists, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!alwatrStore.hasStore('user1/profile')) {\n   *  alwatrStore.defineDocument(...)\n   * }\n   * ```\n   */\n  public hasStore(storeId: StoreFileId): boolean {\n    const id_ = getStoreId(storeId);\n    const exists = this.rootDb__.hasItem(id_);\n    logger.logMethodFull?.('hasStore', id_, exists);\n    return exists;\n  }\n\n  /**\n   * Defines a new document with the given configuration and initial data.\n   * If a document with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   * @template TDoc document data type\n   * @example\n   * ```typescript\n   * await alwatrStore.newDocument<Order>(\n   *   {\n   *     name: 'profile',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   },\n   *   {\n   *     name: 'Ali',\n   *     email: 'ali@alwatr.io',\n   *   }\n   * );\n   * ```\n   */\n  public newDocument<TDoc extends JsonObject = JsonObject>(stat: Omit<StoreFileStat, 'type'>, data: TDoc): void {\n    logger.logMethodArgs?.('newDocument', stat);\n    return this.newStoreFile__(\n      {\n        ...stat,\n        type: StoreFileType.Document,\n      },\n      data,\n    );\n  }\n\n  /**\n   * Defines a new collection with the given configuration and initial data.\n   * If a collection with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @example\n   * ```typescript\n   * await alwatrStore.newCollection<Order>(\n   *   {\n   *     name: 'orders',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   }\n   * );\n   * ```\n   */\n  public newCollection(stat: Omit<StoreFileStat, 'type'>): void {\n    logger.logMethodArgs?.('newCollection', stat);\n    return this.newStoreFile__({\n      ...stat,\n      type: StoreFileType.Collection,\n    });\n  }\n\n  /**\n   * Defines a AlwatrNitrobaseFile with the given configuration and initial data.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   */\n  private newStoreFile__(stat: StoreFileStat, data?: DictionaryOpt): void {\n    logger.logMethodArgs?.('newStoreFile__', stat);\n\n    (stat.changeDebounce as number | undefined) ??= this.config.defaultChangeDebounce;\n\n    let fileStoreRef: DocumentReference | CollectionReference;\n    if (stat.type === StoreFileType.Document) {\n      if (data === undefined) {\n        logger.accident('newStoreFile__', 'document_data_required', stat);\n        throw new Error('document_data_required', {cause: stat});\n      }\n      fileStoreRef = DocumentReference.newRefFromData(stat, data, this.storeChanged_);\n    }\n    else if (stat.type === StoreFileType.Collection) {\n      fileStoreRef = CollectionReference.newRefFromData(stat, this.storeChanged_);\n    }\n    else {\n      logger.accident('newStoreFile__', 'store_file_type_not_supported', stat);\n      throw new Error('store_file_type_not_supported', {cause: stat});\n    }\n\n    if (this.rootDb__.hasItem(fileStoreRef.id)) {\n      logger.accident('newStoreFile__', 'store_file_already_defined', stat);\n      throw new Error('store_file_already_defined', {cause: stat});\n    }\n\n    this.rootDb__.addItem(fileStoreRef.id, stat);\n    this.cacheReferences__[fileStoreRef.id] = fileStoreRef;\n\n    // fileStoreRef.save();\n    this.storeChanged_(fileStoreRef);\n  }\n\n  /**\n   * Open a document with the given id and create and return a DocumentReference.\n   * If the document not exists or its not a document, an error is thrown.\n   *\n   * @template TDoc document data type\n   * @param documentId document id {@link StoreFileId}\n   * @returns document reference {@link DocumentReference}\n   * @example\n   * ```typescript\n   * const userProfile = await alwatrStore.openDocument<User>({\n   *   name: 'user1/profile',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * userProfile.update({name: 'ali'});\n   * ```\n   */\n  public async openDocument<TDoc extends JsonObject>(documentId: StoreFileId): Promise<DocumentReference<TDoc>> {\n    const id = getStoreId(documentId);\n    logger.logMethodArgs?.('openDocument', id);\n\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof DocumentReference)) {\n        logger.accident('openDocument', 'document_wrong_type', id);\n        throw new Error('document_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as DocumentReference<TDoc>;\n    }\n\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openDocument', 'document_not_found', id);\n      throw new Error('document_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Document) {\n      logger.accident('openDocument', 'document_wrong_type', id);\n      throw new Error('document_wrong_type', {cause: id});\n    }\n\n    const context = await this.readContext__<DocumentContext<TDoc>>(storeStat);\n    const docRef = DocumentReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = docRef as unknown as DocumentReference;\n    return docRef;\n  }\n\n  /**\n   * Open a collection with the given id and create and return a CollectionReference.\n   * If the collection not exists or its not a collection, an error is thrown.\n   *\n   * @template TItem collection item data type\n   * @param collectionId collection id {@link StoreFileId}\n   * @returns collection reference {@link CollectionReference}\n   * @example\n   * ```typescript\n   * const orders = await alwatrStore.openCollection<Order>({\n   *   name: 'orders',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * orders.append({name: 'order 1'});\n   * ```\n   */\n  public async openCollection<TItem extends JsonObject>(collectionId: StoreFileId): Promise<CollectionReference<TItem>> {\n    const id = getStoreId(collectionId);\n    logger.logMethodArgs?.('openCollection', id);\n\n    // try to get from cache\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof CollectionReference)) {\n        logger.accident('openCollection', 'collection_wrong_type', id);\n        throw new Error('collection_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as CollectionReference<TItem>;\n    }\n\n    // load and create new collection reference\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openCollection', 'collection_not_found', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Collection) {\n      logger.accident('openCollection', 'collection_wrong_type', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const context = await this.readContext__<CollectionContext<TItem>>(storeStat);\n    const colRef = CollectionReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = colRef as unknown as CollectionReference;\n    return colRef;\n  }\n\n  /**\n   * Unloads the nitrobase file with the given id from memory.\n   *\n   * @param storeId The unique identifier of the nitrobase file. {@link StoreFileId}\n   * @example\n   * ```typescript\n   * alwatrStore.unloadStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // true\n   * ```\n   */\n  public unloadStore(storeId: StoreFileId): void {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('unloadStore', id_);\n    const ref = this.cacheReferences__[id_];\n    if (ref === undefined) return;\n    if (ref.hasUnprocessedChanges_ === true) {\n      ref.updateDelayed_ = false;\n      this.storeChanged_(ref);\n    }\n    delete this.cacheReferences__[id_];\n  }\n\n  /**\n   * Remove document or collection from nitrobase and delete the file from disk.\n   * If the file is not found, an error is thrown.\n   * If the file is not unloaded, it will be unloaded first.\n   * You don't need to await this method to complete unless you want to make sure the file is deleted on disk.\n   *\n   * @param storeId The ID of the file to delete. {@link StoreFileId}\n   * @returns A Promise that resolves when the file is deleted.\n   * @example\n   * ```typescript\n   * alwatrStore.removeStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // false\n   * ```\n   */\n  public async removeStore(storeId: StoreFileId): Promise<void> {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('removeStore', id_);\n    if (!this.rootDb__.hasItem(id_)) {\n      logger.accident('removeStore', 'document_not_found', id_);\n      throw new Error('document_not_found', {cause: id_});\n    }\n    const ref = this.cacheReferences__[id_];\n    if (ref !== undefined) {\n      // direct unload to prevent save\n      ref.freeze = true;\n      ref.updateDelayed_ = false;\n      ref.hasUnprocessedChanges_ = false;\n      delete this.cacheReferences__[id_]; // unload\n    }\n    const path = getStorePath(this.rootDb__.getItemData(id_));\n    this.rootDb__.removeItem(id_);\n    await delay.by(0);\n    try {\n      await unlink(resolve(this.config.rootPath, path));\n    }\n    catch (error) {\n      logger.error('removeStore', 'remove_file_failed', error, {id: storeId, path});\n    }\n  }\n\n  /**\n   * Saves all changes in the nitrobase.\n   *\n   * @returns A Promise that resolves when all changes are saved.\n   * @example\n   * ```typescript\n   * await alwatrStore.saveAll();\n   * ```\n   */\n  public async saveAll(): Promise<void> {\n    logger.logMethod?.('saveAll');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        ref.updateDelayed_ = false;\n        await this.storeChanged_(ref);\n      }\n    }\n  }\n\n  /**\n   * Reads the context from a given path or StoreFileStat object.\n   *\n   * @param path The path or StoreFileStat object from which to read the context.\n   * @returns A promise that resolves to the context object.\n   */\n  private async readContext__<T extends StoreFileContext>(path: string | StoreFileStat): Promise<T> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('readContext__', path);\n    logger.time?.(`readContext__time(${path})`);\n    const context = (await readJson(resolve(this.config.rootPath, path))) as T;\n    logger.timeEnd?.(`readContext__time(${path})`);\n    return context;\n  }\n\n  /**\n   * Writes the context to the specified path.\n   *\n   * @template T The type of the context.\n   * @param path The path where the context will be written.\n   * @param context The context to be written.\n   * @param sync Indicates whether the write operation should be synchronous.\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  private writeContext__<T extends StoreFileContext>(path: string | StoreFileStat, context: T): Promise<void> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('writeContext__', path);\n    return writeJson(resolve(this.config.rootPath, path), context);\n  }\n\n  /**\n   * Write nitrobase file context.\n   *\n   * @param from nitrobase file reference\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  protected async storeChanged_<T extends JsonObject>(from: DocumentReference<T> | CollectionReference<T>): Promise<void> {\n    logger.logMethodArgs?.('storeChanged__', from.id);\n    const rev = from.getStoreMeta().rev;\n    try {\n      await this.writeContext__(from.path, from.getFullContext_());\n      if (rev === from.getStoreMeta().rev) {\n        // Context not changed during saving\n        from.hasUnprocessedChanges_ = false;\n      }\n    }\n    catch (error) {\n      logger.error('storeChanged__', 'write_context_failed', {id: from.id, error});\n    }\n  }\n\n  /**\n   * Load storeFilesCollection or create new one.\n   */\n  private loadRootDb__(): CollectionReference<StoreFileStat> {\n    logger.logMethod?.('loadRootDb__');\n    const fullPath = resolve(this.config.rootPath, getStorePath(AlwatrNitrobase.rootDbStat__));\n    if (!existsSync(fullPath)) {\n      if (this.config.errorWhenNotInitialized === true) {\n        throw new Error('store_not_found', {cause: 'Nitrobase not initialized'});\n      }\n\n      logger.banner('Initialize new alwatr-nitrobase');\n      return CollectionReference.newRefFromData(AlwatrNitrobase.rootDbStat__, this.storeChanged_);\n    }\n    // else\n    const context = readJson<CollectionContext<StoreFileStat>>(fullPath, true);\n    return CollectionReference.newRefFromContext(context, this.storeChanged_, 'root-db');\n  }\n\n  /**\n   * Save all nitrobase files.\n   */\n  private exitHook__(): void {\n    logger.logMethod?.('exitHook__');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`, ref.hasUnprocessedChanges_);\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        logger.incident?.('exitHook__', 'rescue_unsaved_context', {id: ref.id});\n        writeJson(resolve(this.config.rootPath, ref.path), ref.getFullContext_(), true);\n        ref.hasUnprocessedChanges_ = false;\n      }\n    }\n  }\n\n  /**\n   * Get all nitrobase files.\n   *\n   * @returns all nitrobase files.\n   * @example\n   * ```typescript\n   * const storeList = alwatrStore.getStoreList();\n   * for (const nitrobase of storeList) {\n   *   console.log(nitrobase.meta.id, nitrobase.data);\n   * }\n   */\n  public getStoreList(): CollectionItem<Omit<StoreFileStat, 'schemaVer'>>[] {\n    logger.logMethod?.('getStoreList');\n    return this.rootDb__.values();\n  }\n}\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\nimport type {} from '@alwatr/type-helper';\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"],
+  "sourcesContent": ["import {delay} from '@alwatr/delay';\nimport {exitHook} from '@alwatr/exit-hook';\nimport {getStoreId, getStorePath} from '@alwatr/nitrobase-helper';\nimport {CollectionReference, DocumentReference} from '@alwatr/nitrobase-reference';\nimport {\n  StoreFileType,\n  StoreFileExtension,\n  Region,\n  type StoreFileStat,\n  type StoreFileContext,\n  type CollectionContext,\n  type DocumentContext,\n  type StoreFileId,\n  type CollectionItem,\n} from '@alwatr/nitrobase-types';\nimport {existsSync, readJson, resolve, unlink, writeJson} from '@alwatr/node-fs';\n\nimport {logger} from './logger.js';\n\n__dev_mode__: logger.logFileModule?.('alwatr-nitrobase');\n\n/**\n * AlwatrNitrobase configuration.\n */\nexport interface AlwatrNitrobaseConfig {\n  /**\n   * The root path of the storage.\n   * This is where the AlwatrNitrobase will nitrobase its data.\n   */\n  rootPath: string;\n\n  /**\n   * The save debounce timeout in milliseconds for minimal disk I/O usage.\n   * This is used to limit the frequency of disk writes for performance reasons.\n   * The recommended value is `40`.\n   */\n  defaultChangeDebounce?: number;\n\n  /**\n   * If true, an error will be thrown when trying to read or write to a nitrobase file that is not initialized (new storage).\n   * The default value is `false` but highly recommended to set it to `true` in production to prevent data loss.\n   */\n  errorWhenNotInitialized?: boolean;\n}\n\n/**\n * AlwatrNitrobase engine.\n *\n * It provides methods to read, write, validate, and manage nitrobase files.\n * It also provides methods to interact with `documents` and `collections` in the nitrobase.\n */\nexport class AlwatrNitrobase {\n  /**\n   * The Alwatr Nitrobase version string.\n   *\n   * Use for nitrobase file format version for check compatibility.\n   */\n  public static readonly version = __package_version__;\n\n  /**\n   * The root nitrobase file stat.\n   */\n  private static readonly rootDbStat__: StoreFileStat = {\n    name: '.nitrobase',\n    region: Region.Secret,\n    type: StoreFileType.Collection,\n    extension: StoreFileExtension.Json,\n    changeDebounce: 40,\n  };\n\n  /**\n   * `collectionReference` of all `storeFileStat`s.\n   * This is the root nitrobase collection.\n   */\n  private rootDb__;\n\n  /**\n   * Keep all loaded nitrobase file context loaded in memory.\n   */\n  private cacheReferences__: DictionaryReq<DocumentReference | CollectionReference> = {};\n\n  /**\n   * Constructs an AlwatrNitrobase instance with the provided configuration.\n   *\n   * @param config The configuration of the AlwatrNitrobase engine.\n   * @example\n   * ```typescript\n   * const alwatrStore = new AlwatrNitrobase({\n   *   rootPath: './db',\n   *   saveDebounce: 40,\n   * });\n   * ```\n   */\n  constructor(public readonly config: AlwatrNitrobaseConfig) {\n    this.storeChanged_ = this.storeChanged_.bind(this);\n\n    logger.logMethodArgs?.('new', config);\n    this.config.defaultChangeDebounce ??= 40;\n    this.rootDb__ = this.loadRootDb__();\n    exitHook(this.exitHook__.bind(this));\n  }\n\n  /**\n   * Checks if a nitrobase file with the given ID exists.\n   *\n   * @param storeId - The ID of the nitrobase file to check.\n   * @returns `true` if the nitrobase file exists, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!alwatrStore.hasStore('user1/profile')) {\n   *  alwatrStore.defineDocument(...)\n   * }\n   * ```\n   */\n  public hasStore(storeId: StoreFileId): boolean {\n    const id_ = getStoreId(storeId);\n    const exists = this.rootDb__.hasItem(id_);\n    logger.logMethodFull?.('hasStore', id_, exists);\n    return exists;\n  }\n\n  /**\n   * Defines a new document with the given configuration and initial data.\n   * If a document with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   * @template TDoc document data type\n   * @example\n   * ```typescript\n   * await alwatrStore.newDocument<Order>(\n   *   {\n   *     name: 'profile',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   },\n   *   {\n   *     name: 'Ali',\n   *     email: 'ali@alwatr.io',\n   *   }\n   * );\n   * ```\n   */\n  public newDocument<TDoc extends JsonObject = JsonObject>(stat: Omit<StoreFileStat, 'type'>, data: TDoc): void {\n    logger.logMethodArgs?.('newDocument', stat);\n    return this.newStoreFile__(\n      {\n        ...stat,\n        type: StoreFileType.Document,\n      },\n      data,\n    );\n  }\n\n  /**\n   * Defines a new collection with the given configuration and initial data.\n   * If a collection with the same ID already exists, an error is thrown.\n   *\n   * @param stat nitrobase file stat\n   * @example\n   * ```typescript\n   * await alwatrStore.newCollection<Order>(\n   *   {\n   *     name: 'orders',\n   *     region: Region.PerUser,\n   *     ownerId: 'user1',\n   *   }\n   * );\n   * ```\n   */\n  public newCollection(stat: Omit<StoreFileStat, 'type'>): void {\n    logger.logMethodArgs?.('newCollection', stat);\n    return this.newStoreFile__({\n      ...stat,\n      type: StoreFileType.Collection,\n    });\n  }\n\n  /**\n   * Defines a AlwatrNitrobaseFile with the given configuration and initial data.\n   *\n   * @param stat nitrobase file stat\n   * @param data initial data for the document\n   */\n  private newStoreFile__(stat: StoreFileStat, data?: DictionaryOpt): void {\n    logger.logMethodArgs?.('newStoreFile__', stat);\n\n    (stat.changeDebounce as number | undefined) ??= this.config.defaultChangeDebounce;\n\n    let fileStoreRef: DocumentReference | CollectionReference;\n    if (stat.type === StoreFileType.Document) {\n      if (data === undefined) {\n        logger.accident('newStoreFile__', 'document_data_required', stat);\n        throw new Error('document_data_required', {cause: stat});\n      }\n      fileStoreRef = DocumentReference.newRefFromData(stat, data, this.storeChanged_);\n    }\n    else if (stat.type === StoreFileType.Collection) {\n      fileStoreRef = CollectionReference.newRefFromData(stat, this.storeChanged_);\n    }\n    else {\n      logger.accident('newStoreFile__', 'store_file_type_not_supported', stat);\n      throw new Error('store_file_type_not_supported', {cause: stat});\n    }\n\n    if (this.rootDb__.hasItem(fileStoreRef.id)) {\n      logger.accident('newStoreFile__', 'store_file_already_defined', stat);\n      throw new Error('store_file_already_defined', {cause: stat});\n    }\n\n    this.rootDb__.addItem(fileStoreRef.id, stat);\n    this.cacheReferences__[fileStoreRef.id] = fileStoreRef;\n\n    // fileStoreRef.save();\n    this.storeChanged_(fileStoreRef);\n  }\n\n  /**\n   * Open a document with the given id and create and return a DocumentReference.\n   * If the document not exists or its not a document, an error is thrown.\n   *\n   * @template TDoc document data type\n   * @param documentId document id {@link StoreFileId}\n   * @returns document reference {@link DocumentReference}\n   * @example\n   * ```typescript\n   * const userProfile = await alwatrStore.openDocument<User>({\n   *   name: 'user1/profile',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * userProfile.update({name: 'ali'});\n   * ```\n   */\n  public async openDocument<TDoc extends JsonObject>(documentId: StoreFileId): Promise<DocumentReference<TDoc>> {\n    const id = getStoreId(documentId);\n    logger.logMethodArgs?.('openDocument', id);\n\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof DocumentReference)) {\n        logger.accident('openDocument', 'document_wrong_type', id);\n        throw new Error('document_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as DocumentReference<TDoc>;\n    }\n\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openDocument', 'document_not_found', id);\n      throw new Error('document_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Document) {\n      logger.accident('openDocument', 'document_wrong_type', id);\n      throw new Error('document_wrong_type', {cause: id});\n    }\n\n    const context = await this.readContext__<DocumentContext<TDoc>>(storeStat);\n    const docRef = DocumentReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = docRef as unknown as DocumentReference;\n    return docRef;\n  }\n\n  /**\n   * Open a collection with the given id and create and return a CollectionReference.\n   * If the collection not exists or its not a collection, an error is thrown.\n   *\n   * @template TItem collection item data type\n   * @param collectionId collection id {@link StoreFileId}\n   * @returns collection reference {@link CollectionReference}\n   * @example\n   * ```typescript\n   * const orders = await alwatrStore.openCollection<Order>({\n   *   name: 'orders',\n   *   region: Region.PerUser,\n   *   ownerId: 'user1',\n   * });\n   * orders.append({name: 'order 1'});\n   * ```\n   */\n  public async openCollection<TItem extends JsonObject>(collectionId: StoreFileId): Promise<CollectionReference<TItem>> {\n    const id = getStoreId(collectionId);\n    logger.logMethodArgs?.('openCollection', id);\n\n    // try to get from cache\n    if (Object.hasOwn(this.cacheReferences__, id)) {\n      const ref = this.cacheReferences__[id];\n      if (!(ref instanceof CollectionReference)) {\n        logger.accident('openCollection', 'collection_wrong_type', id);\n        throw new Error('collection_wrong_type', {cause: id});\n      }\n      return this.cacheReferences__[id] as unknown as CollectionReference<TItem>;\n    }\n\n    // load and create new collection reference\n    if (!this.rootDb__.hasItem(id)) {\n      logger.accident('openCollection', 'collection_not_found', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const storeStat = this.rootDb__.getItemData(id);\n\n    if (storeStat.type != StoreFileType.Collection) {\n      logger.accident('openCollection', 'collection_wrong_type', id);\n      throw new Error('collection_not_found', {cause: id});\n    }\n\n    const context = await this.readContext__<CollectionContext<TItem>>(storeStat);\n    const colRef = CollectionReference.newRefFromContext(context, this.storeChanged_);\n    this.cacheReferences__[id] = colRef as unknown as CollectionReference;\n    return colRef;\n  }\n\n  /**\n   * Unloads the nitrobase file with the given id from memory.\n   *\n   * @param storeId The unique identifier of the nitrobase file. {@link StoreFileId}\n   * @example\n   * ```typescript\n   * alwatrStore.unloadStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // true\n   * ```\n   */\n  public unloadStore(storeId: StoreFileId): void {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('unloadStore', id_);\n    const ref = this.cacheReferences__[id_];\n    if (ref === undefined) return;\n    if (ref.hasUnprocessedChanges_ === true) {\n      ref.updateDelayed_ = false;\n      this.storeChanged_(ref);\n    }\n    delete this.cacheReferences__[id_];\n  }\n\n  /**\n   * Remove document or collection from nitrobase and delete the file from disk.\n   * If the file is not found, an error is thrown.\n   * If the file is not unloaded, it will be unloaded first.\n   * You don't need to await this method to complete unless you want to make sure the file is deleted on disk.\n   *\n   * @param storeId The ID of the file to delete. {@link StoreFileId}\n   * @returns A Promise that resolves when the file is deleted.\n   * @example\n   * ```typescript\n   * alwatrStore.removeStore({name: 'user-list', region: Region.Secret});\n   * alwatrStore.hasStore({name: 'user-list', region: Region.Secret}); // false\n   * ```\n   */\n  public async removeStore(storeId: StoreFileId): Promise<void> {\n    const id_ = getStoreId(storeId);\n    logger.logMethodArgs?.('removeStore', id_);\n    if (!this.rootDb__.hasItem(id_)) {\n      logger.accident('removeStore', 'document_not_found', id_);\n      throw new Error('document_not_found', {cause: id_});\n    }\n    const ref = this.cacheReferences__[id_];\n    if (ref !== undefined) {\n      // direct unload to prevent save\n      ref.freeze = true;\n      ref.updateDelayed_ = false;\n      ref.hasUnprocessedChanges_ = false;\n      delete this.cacheReferences__[id_]; // unload\n    }\n    const path = getStorePath(this.rootDb__.getItemData(id_));\n    this.rootDb__.removeItem(id_);\n    await delay.by(0);\n    try {\n      await unlink(resolve(this.config.rootPath, path));\n    }\n    catch (error) {\n      logger.error('removeStore', 'remove_file_failed', error, {id: storeId, path});\n    }\n  }\n\n  /**\n   * Saves all changes in the nitrobase.\n   *\n   * @returns A Promise that resolves when all changes are saved.\n   * @example\n   * ```typescript\n   * await alwatrStore.saveAll();\n   * ```\n   */\n  public async saveAll(): Promise<void> {\n    logger.logMethod?.('saveAll');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        ref.updateDelayed_ = false;\n        await this.storeChanged_(ref);\n      }\n    }\n  }\n\n  /**\n   * Reads the context from a given path or StoreFileStat object.\n   *\n   * @param path The path or StoreFileStat object from which to read the context.\n   * @returns A promise that resolves to the context object.\n   */\n  private async readContext__<T extends StoreFileContext>(path: string | StoreFileStat): Promise<T> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('readContext__', path);\n    logger.time?.(`readContext__time(${path})`);\n    const context = (await readJson(resolve(this.config.rootPath, path))) as T;\n    logger.timeEnd?.(`readContext__time(${path})`);\n    return context;\n  }\n\n  /**\n   * Writes the context to the specified path.\n   *\n   * @template T The type of the context.\n   * @param path The path where the context will be written.\n   * @param context The context to be written.\n   * @param sync Indicates whether the write operation should be synchronous.\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  private writeContext__<T extends StoreFileContext>(path: string | StoreFileStat, context: T): Promise<void> {\n    if (typeof path !== 'string') path = getStorePath(path);\n    logger.logMethodArgs?.('writeContext__', path);\n    return writeJson(resolve(this.config.rootPath, path), context);\n  }\n\n  /**\n   * Write nitrobase file context.\n   *\n   * @param from nitrobase file reference\n   * @returns A promise that resolves when the write operation is complete.\n   */\n  protected async storeChanged_<T extends JsonObject>(from: DocumentReference<T> | CollectionReference<T>): Promise<void> {\n    logger.logMethodArgs?.('storeChanged__', from.id);\n    const rev = from.getStoreMeta().rev;\n    try {\n      await this.writeContext__(from.path, from.getFullContext_());\n      if (rev === from.getStoreMeta().rev) {\n        // Context not changed during saving\n        from.hasUnprocessedChanges_ = false;\n      }\n    }\n    catch (error) {\n      logger.error('storeChanged__', 'write_context_failed', {id: from.id, error});\n    }\n  }\n\n  /**\n   * Load storeFilesCollection or create new one.\n   */\n  private loadRootDb__(): CollectionReference<StoreFileStat> {\n    logger.logMethod?.('loadRootDb__');\n    const fullPath = resolve(this.config.rootPath, getStorePath(AlwatrNitrobase.rootDbStat__));\n    if (!existsSync(fullPath)) {\n      if (this.config.errorWhenNotInitialized === true) {\n        throw new Error('store_not_found', {cause: 'Nitrobase not initialized'});\n      }\n\n      logger.banner('Initialize new alwatr-nitrobase');\n      return CollectionReference.newRefFromData(AlwatrNitrobase.rootDbStat__, this.storeChanged_);\n    }\n    // else\n    const context = readJson<CollectionContext<StoreFileStat>>(fullPath, true);\n    return CollectionReference.newRefFromContext(context, this.storeChanged_, 'root-db');\n  }\n\n  /**\n   * Save all nitrobase files.\n   */\n  private exitHook__(): void {\n    logger.logMethod?.('exitHook__');\n    for (const ref of Object.values(this.cacheReferences__)) {\n      logger.logProperty?.(`StoreFile.${ref.id}.hasUnprocessedChanges`, ref.hasUnprocessedChanges_);\n      if (ref.hasUnprocessedChanges_ === true && ref.freeze !== true) {\n        logger.incident?.('exitHook__', 'rescue_unsaved_context', {id: ref.id});\n        writeJson(resolve(this.config.rootPath, ref.path), ref.getFullContext_(), true);\n        ref.hasUnprocessedChanges_ = false;\n      }\n    }\n  }\n\n  /**\n   * Get all nitrobase files.\n   *\n   * @returns all nitrobase files.\n   * @example\n   * ```typescript\n   * const storeList = alwatrStore.getStoreList();\n   * for (const nitrobase of storeList) {\n   *   console.log(nitrobase.meta.id, nitrobase.data);\n   * }\n   */\n  public getStoreList(): CollectionItem<Omit<StoreFileStat, 'schemaVer'>>[] {\n    logger.logMethod?.('getStoreList');\n    return this.rootDb__.values();\n  }\n}\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nanolib';\nimport type {} from '@alwatr/type-helper';\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"],
   "mappings": ";;AAAA,OAAQ,UAAY,gBACpB,OAAQ,aAAe,oBACvB,OAAQ,WAAY,iBAAmB,2BACvC,OAAQ,oBAAqB,sBAAwB,8BACrD,OACE,cACA,mBACA,WAOK,0BACP,OAAQ,WAAY,SAAU,QAAS,OAAQ,cAAgB,kBCf/D,OAAQ,iBAAmB,iBAKpB,IAAM,OAAyB,aAAa,0BAAgB,EDcnE,aAAc,OAAO,gBAAgB,kBAAkB,EAgChD,IAAM,gBAAN,MAAM,gBAAgB,CA0C3B,YAA4B,OAA+B,CAA/B,mBAd5B,KAAQ,kBAA4E,CAAC,EAenF,KAAK,cAAgB,KAAK,cAAc,KAAK,IAAI,EAEjD,OAAO,gBAAgB,MAAO,MAAM,EACpC,KAAK,OAAO,wBAA0B,GACtC,KAAK,SAAW,KAAK,aAAa,EAClC,SAAS,KAAK,WAAW,KAAK,IAAI,CAAC,CACrC,CA3CA,YAAuB,QAAU,SAKjC,YAAwB,aAA8B,CACpD,KAAM,aACN,OAAQ,OAAO,OACf,KAAM,cAAc,WACpB,UAAW,mBAAmB,KAC9B,eAAgB,EAClB,EA8CO,SAAS,QAA+B,CAC7C,MAAM,IAAM,WAAW,OAAO,EAC9B,MAAM,OAAS,KAAK,SAAS,QAAQ,GAAG,EACxC,OAAO,gBAAgB,WAAY,IAAK,MAAM,EAC9C,OAAO,MACT,CAwBO,YAAkD,KAAmC,KAAkB,CAC5G,OAAO,gBAAgB,cAAe,IAAI,EAC1C,OAAO,KAAK,eACV,CACE,GAAG,KACH,KAAM,cAAc,QACtB,EACA,IACF,CACF,CAkBO,cAAc,KAAyC,CAC5D,OAAO,gBAAgB,gBAAiB,IAAI,EAC5C,OAAO,KAAK,eAAe,CACzB,GAAG,KACH,KAAM,cAAc,UACtB,CAAC,CACH,CAQQ,eAAe,KAAqB,KAA4B,CACtE,OAAO,gBAAgB,iBAAkB,IAAI,EAE5C,KAAK,iBAA0C,KAAK,OAAO,sBAE5D,IAAI,aACJ,GAAI,KAAK,OAAS,cAAc,SAAU,CACxC,GAAI,OAAS,OAAW,CACtB,OAAO,SAAS,iBAAkB,yBAA0B,IAAI,EAChE,MAAM,IAAI,MAAM,yBAA0B,CAAC,MAAO,IAAI,CAAC,CACzD,CACA,aAAe,kBAAkB,eAAe,KAAM,KAAM,KAAK,aAAa,CAChF,SACS,KAAK,OAAS,cAAc,WAAY,CAC/C,aAAe,oBAAoB,eAAe,KAAM,KAAK,aAAa,CAC5E,KACK,CACH,OAAO,SAAS,iBAAkB,gCAAiC,IAAI,EACvE,MAAM,IAAI,MAAM,gCAAiC,CAAC,MAAO,IAAI,CAAC,CAChE,CAEA,GAAI,KAAK,SAAS,QAAQ,aAAa,EAAE,EAAG,CAC1C,OAAO,SAAS,iBAAkB,6BAA8B,IAAI,EACpE,MAAM,IAAI,MAAM,6BAA8B,CAAC,MAAO,IAAI,CAAC,CAC7D,CAEA,KAAK,SAAS,QAAQ,aAAa,GAAI,IAAI,EAC3C,KAAK,kBAAkB,aAAa,EAAE,EAAI,aAG1C,KAAK,cAAc,YAAY,CACjC,CAmBA,MAAa,aAAsC,WAA2D,CAC5G,MAAM,GAAK,WAAW,UAAU,EAChC,OAAO,gBAAgB,eAAgB,EAAE,EAEzC,GAAI,OAAO,OAAO,KAAK,kBAAmB,EAAE,EAAG,CAC7C,MAAM,IAAM,KAAK,kBAAkB,EAAE,EACrC,GAAI,EAAE,eAAe,mBAAoB,CACvC,OAAO,SAAS,eAAgB,sBAAuB,EAAE,EACzD,MAAM,IAAI,MAAM,sBAAuB,CAAC,MAAO,EAAE,CAAC,CACpD,CACA,OAAO,KAAK,kBAAkB,EAAE,CAClC,CAEA,GAAI,CAAC,KAAK,SAAS,QAAQ,EAAE,EAAG,CAC9B,OAAO,SAAS,eAAgB,qBAAsB,EAAE,EACxD,MAAM,IAAI,MAAM,qBAAsB,CAAC,MAAO,EAAE,CAAC,CACnD,CAEA,MAAM,UAAY,KAAK,SAAS,YAAY,EAAE,EAE9C,GAAI,UAAU,MAAQ,cAAc,SAAU,CAC5C,OAAO,SAAS,eAAgB,sBAAuB,EAAE,EACzD,MAAM,IAAI,MAAM,sBAAuB,CAAC,MAAO,EAAE,CAAC,CACpD,CAEA,MAAM,QAAU,MAAM,KAAK,cAAqC,SAAS,EACzE,MAAM,OAAS,kBAAkB,kBAAkB,QAAS,KAAK,aAAa,EAC9E,KAAK,kBAAkB,EAAE,EAAI,OAC7B,OAAO,MACT,CAmBA,MAAa,eAAyC,aAAgE,CACpH,MAAM,GAAK,WAAW,YAAY,EAClC,OAAO,gBAAgB,iBAAkB,EAAE,EAG3C,GAAI,OAAO,OAAO,KAAK,kBAAmB,EAAE,EAAG,CAC7C,MAAM,IAAM,KAAK,kBAAkB,EAAE,EACrC,GAAI,EAAE,eAAe,qBAAsB,CACzC,OAAO,SAAS,iBAAkB,wBAAyB,EAAE,EAC7D,MAAM,IAAI,MAAM,wBAAyB,CAAC,MAAO,EAAE,CAAC,CACtD,CACA,OAAO,KAAK,kBAAkB,EAAE,CAClC,CAGA,GAAI,CAAC,KAAK,SAAS,QAAQ,EAAE,EAAG,CAC9B,OAAO,SAAS,iBAAkB,uBAAwB,EAAE,EAC5D,MAAM,IAAI,MAAM,uBAAwB,CAAC,MAAO,EAAE,CAAC,CACrD,CAEA,MAAM,UAAY,KAAK,SAAS,YAAY,EAAE,EAE9C,GAAI,UAAU,MAAQ,cAAc,WAAY,CAC9C,OAAO,SAAS,iBAAkB,wBAAyB,EAAE,EAC7D,MAAM,IAAI,MAAM,uBAAwB,CAAC,MAAO,EAAE,CAAC,CACrD,CAEA,MAAM,QAAU,MAAM,KAAK,cAAwC,SAAS,EAC5E,MAAM,OAAS,oBAAoB,kBAAkB,QAAS,KAAK,aAAa,EAChF,KAAK,kBAAkB,EAAE,EAAI,OAC7B,OAAO,MACT,CAYO,YAAY,QAA4B,CAC7C,MAAM,IAAM,WAAW,OAAO,EAC9B,OAAO,gBAAgB,cAAe,GAAG,EACzC,MAAM,IAAM,KAAK,kBAAkB,GAAG,EACtC,GAAI,MAAQ,OAAW,OACvB,GAAI,IAAI,yBAA2B,KAAM,CACvC,IAAI,eAAiB,MACrB,KAAK,cAAc,GAAG,CACxB,CACA,OAAO,KAAK,kBAAkB,GAAG,CACnC,CAgBA,MAAa,YAAY,QAAqC,CAC5D,MAAM,IAAM,WAAW,OAAO,EAC9B,OAAO,gBAAgB,cAAe,GAAG,EACzC,GAAI,CAAC,KAAK,SAAS,QAAQ,GAAG,EAAG,CAC/B,OAAO,SAAS,cAAe,qBAAsB,GAAG,EACxD,MAAM,IAAI,MAAM,qBAAsB,CAAC,MAAO,GAAG,CAAC,CACpD,CACA,MAAM,IAAM,KAAK,kBAAkB,GAAG,EACtC,GAAI,MAAQ,OAAW,CAErB,IAAI,OAAS,KACb,IAAI,eAAiB,MACrB,IAAI,uBAAyB,MAC7B,OAAO,KAAK,kBAAkB,GAAG,CACnC,CACA,MAAM,KAAO,aAAa,KAAK,SAAS,YAAY,GAAG,CAAC,EACxD,KAAK,SAAS,WAAW,GAAG,EAC5B,MAAM,MAAM,GAAG,CAAC,EAChB,GAAI,CACF,MAAM,OAAO,QAAQ,KAAK,OAAO,SAAU,IAAI,CAAC,CAClD,OACO,MAAO,CACZ,OAAO,MAAM,cAAe,qBAAsB,MAAO,CAAC,GAAI,QAAS,IAAI,CAAC,CAC9E,CACF,CAWA,MAAa,SAAyB,CACpC,OAAO,YAAY,SAAS,EAC5B,UAAW,OAAO,OAAO,OAAO,KAAK,iBAAiB,EAAG,CACvD,GAAI,IAAI,yBAA2B,MAAQ,IAAI,SAAW,KAAM,CAC9D,IAAI,eAAiB,MACrB,MAAM,KAAK,cAAc,GAAG,CAC9B,CACF,CACF,CAQA,MAAc,cAA0C,KAA0C,CAChG,GAAI,OAAO,OAAS,SAAU,KAAO,aAAa,IAAI,EACtD,OAAO,gBAAgB,gBAAiB,IAAI,EAC5C,OAAO,OAAO,qBAAqB,IAAI,GAAG,EAC1C,MAAM,QAAW,MAAM,SAAS,QAAQ,KAAK,OAAO,SAAU,IAAI,CAAC,EACnE,OAAO,UAAU,qBAAqB,IAAI,GAAG,EAC7C,OAAO,OACT,CAWQ,eAA2C,KAA8B,QAA2B,CAC1G,GAAI,OAAO,OAAS,SAAU,KAAO,aAAa,IAAI,EACtD,OAAO,gBAAgB,iBAAkB,IAAI,EAC7C,OAAO,UAAU,QAAQ,KAAK,OAAO,SAAU,IAAI,EAAG,OAAO,CAC/D,CAQA,MAAgB,cAAoC,KAAoE,CACtH,OAAO,gBAAgB,iBAAkB,KAAK,EAAE,EAChD,MAAM,IAAM,KAAK,aAAa,EAAE,IAChC,GAAI,CACF,MAAM,KAAK,eAAe,KAAK,KAAM,KAAK,gBAAgB,CAAC,EAC3D,GAAI,MAAQ,KAAK,aAAa,EAAE,IAAK,CAEnC,KAAK,uBAAyB,KAChC,CACF,OACO,MAAO,CACZ,OAAO,MAAM,iBAAkB,uBAAwB,CAAC,GAAI,KAAK,GAAI,KAAK,CAAC,CAC7E,CACF,CAKQ,cAAmD,CACzD,OAAO,YAAY,cAAc,EACjC,MAAM,SAAW,QAAQ,KAAK,OAAO,SAAU,aAAa,iBAAgB,YAAY,CAAC,EACzF,GAAI,CAAC,WAAW,QAAQ,EAAG,CACzB,GAAI,KAAK,OAAO,0BAA4B,KAAM,CAChD,MAAM,IAAI,MAAM,kBAAmB,CAAC,MAAO,2BAA2B,CAAC,CACzE,CAEA,OAAO,OAAO,iCAAiC,EAC/C,OAAO,oBAAoB,eAAe,iBAAgB,aAAc,KAAK,aAAa,CAC5F,CAEA,MAAM,QAAU,SAA2C,SAAU,IAAI,EACzE,OAAO,oBAAoB,kBAAkB,QAAS,KAAK,cAAe,SAAS,CACrF,CAKQ,YAAmB,CACzB,OAAO,YAAY,YAAY,EAC/B,UAAW,OAAO,OAAO,OAAO,KAAK,iBAAiB,EAAG,CACvD,OAAO,cAAc,aAAa,IAAI,EAAE,yBAA0B,IAAI,sBAAsB,EAC5F,GAAI,IAAI,yBAA2B,MAAQ,IAAI,SAAW,KAAM,CAC9D,OAAO,WAAW,aAAc,yBAA0B,CAAC,GAAI,IAAI,EAAE,CAAC,EACtE,UAAU,QAAQ,KAAK,OAAO,SAAU,IAAI,IAAI,EAAG,IAAI,gBAAgB,EAAG,IAAI,EAC9E,IAAI,uBAAyB,KAC/B,CACF,CACF,CAaO,cAAmE,CACxE,OAAO,YAAY,cAAc,EACjC,OAAO,KAAK,SAAS,OAAO,CAC9B,CACF",
   "names": []
 }

package/package.json

@@ -1,25 +1,23 @@
 {
   "name": "@alwatr/nitrobase-engine",
   "description": "Nitrobase is a blazingly fast, lightweight database built on JSON. It stores data entirely in memory for lightning-quick access, while also providing a JSON file backup for persistence. You can easily serve your data over the web using our high-performance accelerated Nginx server.",
-  "version": "7.10.0",
+  "version": "7.10.1",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nitrobase/issues",
   "dependencies": {
-    "@alwatr/delay": "^6.0.8",
-    "@alwatr/exit-hook": "^5.5.16",
-    "@alwatr/logger": "^6.0.5",
-    "@alwatr/nitrobase-helper": "^7.10.0",
-    "@alwatr/nitrobase-reference": "^7.10.0",
-    "@alwatr/nitrobase-types": "^7.10.0",
-    "@alwatr/node-fs": "^5.5.19"
+    "@alwatr/delay": "^6.0.18",
+    "@alwatr/exit-hook": "^5.5.26",
+    "@alwatr/logger": "^6.0.15",
+    "@alwatr/nitrobase-helper": "^7.10.1",
+    "@alwatr/nitrobase-reference": "^7.10.1",
+    "@alwatr/nitrobase-types": "^7.10.1",
+    "@alwatr/node-fs": "^5.5.29",
+    "@alwatr/type-helper": "^7.0.0"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^6.3.1",
-    "@alwatr/prettier-config": "^5.0.4",
-    "@alwatr/tsconfig-base": "^6.0.2",
-    "@alwatr/type-helper": "^6.1.1",
-    "@types/node": "^22.18.6",
-    "typescript": "^5.9.2"
+    "@alwatr/nanolib": "^7.3.4",
+    "@types/node": "^24.10.4",
+    "typescript": "^5.9.3"
   },
   "exports": {
     ".": {
@@ -49,7 +47,7 @@
   "license": "MPL-2.0",
   "main": "./dist/main.cjs",
   "module": "./dist/main.mjs",
-  "prettier": "@alwatr/prettier-config",
+  "prettier": "@alwatr/nanolib/prettier-config",
   "publishConfig": {
     "access": "public"
   },
@@ -75,5 +73,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "4079c7884711b767ac812d14d4ec7eafe6e19081"
+  "gitHead": "e23943a279d6b0905b205c0c17b2b3249efab226"
 }