@alwatr/nitrobase-engine 7.10.1 → 9.1.0

package/dist/alwatr-nitrobase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alwatr-nitrobase.d.ts","sourceRoot":"","sources":["../src/alwatr-nitrobase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAIL,KAAK,aAAa,EAIlB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAOjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,eAAe;aA0CE,MAAM,EAAE,qBAAqB;IAzCzD;;;;OAIG;IACH,gBAAuB,OAAO,SAAuB;IAErD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAMlC;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAA8D;IAEvF;;;;;;;;;;;OAWG;gBACyB,MAAM,EAAE,qBAAqB;IASzD;;;;;;;;;;;OAWG;IACI,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAO9C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,IAAI,SAAS,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAW7G;;;;;;;;;;;;;;;OAeG;IACI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,IAAI;IAQ7D;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAiCtB;;;;;;;;;;;;;;;;OAgBG;IACU,YAAY,CAAC,IAAI,SAAS,UAAU,EAAE,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IA+B7G;;;;;;;;;;;;;;;;OAgBG;IACU,cAAc,CAAC,KAAK,SAAS,UAAU,EAAE,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAiCrH;;;;;;;;;OASG;IACI,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAY9C;;;;;;;;;;;;;OAaG;IACU,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7D;;;;;;;;OAQG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;;OAKG;YACW,aAAa;IAS3B;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;;OAKG;cACa,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAevH;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;;;;OAUG;IACI,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE;CAI1E"}
+{"version":3,"file":"alwatr-nitrobase.d.ts","sourceRoot":"","sources":["../src/alwatr-nitrobase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAIL,KAAK,aAAa,EAIlB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAQjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,eAAe;aA0CE,MAAM,EAAE,qBAAqB;IAzCzD;;;;OAIG;IACH,gBAAuB,OAAO,SAAuB;IAErD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAMlC;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAA8D;IAEvF;;;;;;;;;;;OAWG;gBACyB,MAAM,EAAE,qBAAqB;IASzD;;;;;;;;;;;OAWG;IACI,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAO9C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,WAAW,CAAC,IAAI,SAAS,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAW7G;;;;;;;;;;;;;;;OAeG;IACI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,IAAI;IAQ7D;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAiCtB;;;;;;;;;;;;;;;;OAgBG;IACU,YAAY,CAAC,IAAI,SAAS,UAAU,EAAE,UAAU,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IA+B7G;;;;;;;;;;;;;;;;OAgBG;IACU,cAAc,CAAC,KAAK,SAAS,UAAU,EAAE,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAiCrH;;;;;;;;;OASG;IACI,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAY9C;;;;;;;;;;;;;OAaG;IACU,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7D;;;;;;;;OAQG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;;OAKG;YACW,aAAa;IAS3B;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;;OAKG;cACa,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAevH;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;;;;OAUG;IACI,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE;CAI1E"}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,uCAAiD,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,uCAAiD,CAAC"}

package/dist/main.js

@@ -0,0 +1,5 @@
+/* 📦 @alwatr/nitrobase-engine v9.1.0 */
+import{delay as H}from"@alwatr/delay";import{exitHook as k}from"@alwatr/exit-hook";import{getStoreId as U,getStorePath as X}from"@alwatr/nitrobase-helper";import{CollectionReference as V,DocumentReference as Y}from"@alwatr/nitrobase-reference";import{StoreFileType as O,StoreFileExtension as L,Region as D}from"@alwatr/nitrobase-types";import{existsSync as A,readJson as $,resolve as W,unlink as J,writeJson as j}from"@alwatr/node-fs";import{createLogger as G}from"@alwatr/logger";var B=G("@alwatr/nitrobase-engine");q:B.logFileModule?.("alwatr-nitrobase");class Z{config;static version="9.1.0";static rootDbStat__={name:".nitrobase",region:D.Secret,type:O.Collection,extension:L.Json,changeDebounce:40};rootDb__;cacheReferences__={};constructor(q){this.config=q;this.storeChanged_=this.storeChanged_.bind(this),B.logMethodArgs?.("new",q),this.config.defaultChangeDebounce??=40,this.rootDb__=this.loadRootDb__(),k(this.exitHook__.bind(this))}hasStore(q){let z=U(q),K=this.rootDb__.hasItem(z);return B.logMethodFull?.("hasStore",z,K),K}newDocument(q,z){return B.logMethodArgs?.("newDocument",q),this.newStoreFile__({...q,type:O.Document},z)}newCollection(q){return B.logMethodArgs?.("newCollection",q),this.newStoreFile__({...q,type:O.Collection})}newStoreFile__(q,z){B.logMethodArgs?.("newStoreFile__",q),q.changeDebounce??=this.config.defaultChangeDebounce;let K;if(q.type===O.Document){if(z===void 0)throw B.accident("newStoreFile__","document_data_required",q),Error("document_data_required",{cause:q});K=Y.newRefFromData(q,z,this.storeChanged_)}else if(q.type===O.Collection)K=V.newRefFromData(q,this.storeChanged_);else throw B.accident("newStoreFile__","store_file_type_not_supported",q),Error("store_file_type_not_supported",{cause:q});if(this.rootDb__.hasItem(K.id))throw B.accident("newStoreFile__","store_file_already_defined",q),Error("store_file_already_defined",{cause:q});this.rootDb__.addItem(K.id,q),this.cacheReferences__[K.id]=K,this.storeChanged_(K)}async openDocument(q){let z=U(q);if(B.logMethodArgs?.("openDocument",z),Object.hasOwn(this.cacheReferences__,z)){if(!(this.cacheReferences__[z]instanceof Y))throw B.accident("openDocument","document_wrong_type",z),Error("document_wrong_type",{cause:z});return this.cacheReferences__[z]}if(!this.rootDb__.hasItem(z))throw B.accident("openDocument","document_not_found",z),Error("document_not_found",{cause:z});let K=this.rootDb__.getItemData(z);if(K.type!=O.Document)throw B.accident("openDocument","document_wrong_type",z),Error("document_wrong_type",{cause:z});let Q=await this.readContext__(K),M=Y.newRefFromContext(Q,this.storeChanged_);return this.cacheReferences__[z]=M,M}async openCollection(q){let z=U(q);if(B.logMethodArgs?.("openCollection",z),Object.hasOwn(this.cacheReferences__,z)){if(!(this.cacheReferences__[z]instanceof V))throw B.accident("openCollection","collection_wrong_type",z),Error("collection_wrong_type",{cause:z});return this.cacheReferences__[z]}if(!this.rootDb__.hasItem(z))throw B.accident("openCollection","collection_not_found",z),Error("collection_not_found",{cause:z});let K=this.rootDb__.getItemData(z);if(K.type!=O.Collection)throw B.accident("openCollection","collection_wrong_type",z),Error("collection_not_found",{cause:z});let Q=await this.readContext__(K),M=V.newRefFromContext(Q,this.storeChanged_);return this.cacheReferences__[z]=M,M}unloadStore(q){let z=U(q);B.logMethodArgs?.("unloadStore",z);let K=this.cacheReferences__[z];if(K===void 0)return;if(K.hasUnprocessedChanges_===!0)K.updateDelayed_=!1,this.storeChanged_(K);delete this.cacheReferences__[z]}async removeStore(q){let z=U(q);if(B.logMethodArgs?.("removeStore",z),!this.rootDb__.hasItem(z))throw B.accident("removeStore","document_not_found",z),Error("document_not_found",{cause:z});let K=this.cacheReferences__[z];if(K!==void 0)K.freeze=!0,K.updateDelayed_=!1,K.hasUnprocessedChanges_=!1,delete this.cacheReferences__[z];let Q=X(this.rootDb__.getItemData(z));this.rootDb__.removeItem(z),await H.by(0);try{await J(W(this.config.rootPath,Q))}catch(M){B.error("removeStore","remove_file_failed",M,{id:q,path:Q})}}async saveAll(){B.logMethod?.("saveAll");for(let q of Object.values(this.cacheReferences__))if(q.hasUnprocessedChanges_===!0&&q.freeze!==!0)q.updateDelayed_=!1,await this.storeChanged_(q)}async readContext__(q){if(typeof q!=="string")q=X(q);B.logMethodArgs?.("readContext__",q),B.time?.(`readContext__time(${q})`);let z=await $(W(this.config.rootPath,q));return B.timeEnd?.(`readContext__time(${q})`),z}writeContext__(q,z){if(typeof q!=="string")q=X(q);return B.logMethodArgs?.("writeContext__",q),j(W(this.config.rootPath,q),z)}async storeChanged_(q){B.logMethodArgs?.("storeChanged__",q.id);let z=q.getStoreMeta().rev;try{if(await this.writeContext__(q.path,q.getFullContext_()),z===q.getStoreMeta().rev)q.hasUnprocessedChanges_=!1}catch(K){B.error("storeChanged__","write_context_failed",{id:q.id,error:K})}}loadRootDb__(){B.logMethod?.("loadRootDb__");let q=W(this.config.rootPath,X(Z.rootDbStat__));if(!A(q)){if(this.config.errorWhenNotInitialized===!0)throw Error("store_not_found",{cause:"Nitrobase not initialized"});return B.banner("Initialize new alwatr-nitrobase"),V.newRefFromData(Z.rootDbStat__,this.storeChanged_)}let z=$(q,!0);return V.newRefFromContext(z,this.storeChanged_,"root-db")}exitHook__(){B.logMethod?.("exitHook__");for(let q of Object.values(this.cacheReferences__))if(B.logProperty?.(`StoreFile.${q.id}.hasUnprocessedChanges`,q.hasUnprocessedChanges_),q.hasUnprocessedChanges_===!0&&q.freeze!==!0)B.incident?.("exitHook__","rescue_unsaved_context",{id:q.id}),j(W(this.config.rootPath,q.path),q.getFullContext_(),!0),q.hasUnprocessedChanges_=!1}getStoreList(){return B.logMethod?.("getStoreList"),this.rootDb__.values()}}export{Z as AlwatrNitrobase};
+
+//# debugId=C1C6087927638DC864756E2164756E21
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1,11 @@
+{
+  "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\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\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"
+  ],
+  "mappings": "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",
+  "debugId": "C1C6087927638DC864756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,36 +1,68 @@
 {
   "name": "@alwatr/nitrobase-engine",
+  "version": "9.1.0",
   "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.1",
-  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
-  "bugs": "https://github.com/Alwatr/nitrobase/issues",
-  "dependencies": {
-    "@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/nanolib": "^7.3.4",
-    "@types/node": "^24.10.4",
-    "typescript": "^5.9.3"
+  "license": "MPL-2.0",
+  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alwatr/alwatr",
+    "directory": "pkg/nitrobase-old/engine"
   },
+  "homepage": "https://github.com/Alwatr/alwatr/tree/main/pkg/nitrobase-old/engine#readme",
+  "bugs": "https://github.com/Alwatr/alwatr/issues",
   "exports": {
     ".": {
       "types": "./dist/main.d.ts",
-      "import": "./dist/main.mjs",
-      "require": "./dist/main.cjs"
+      "import": "./dist/main.js",
+      "default": "./dist/main.js"
     }
   },
+  "sideEffects": false,
+  "dependencies": {
+    "@alwatr/delay": "9.1.0",
+    "@alwatr/exit-hook": "9.1.0",
+    "@alwatr/logger": "9.1.0",
+    "@alwatr/nitrobase-helper": "^9.1.0",
+    "@alwatr/nitrobase-reference": "^9.1.0",
+    "@alwatr/nitrobase-types": "^9.1.0",
+    "@alwatr/node-fs": "9.1.0",
+    "@alwatr/type-helper": "9.1.0"
+  },
+  "devDependencies": {
+    "@alwatr/nano-build": "9.1.0",
+    "@alwatr/tsconfig-base": "9.1.0",
+    "@alwatr/type-helper": "workspace:*",
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "b": "bun run build",
+    "build": "bun run build:ts && bun run build:es",
+    "build:es": "nano-build --preset=module src/main.ts",
+    "build:ts": "tsc --build",
+    "cl": "bun run clean",
+    "clean": "rm -rfv dist *.tsbuildinfo",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint src/ --ext .ts",
+    "t": "bun run test",
+    "test": "ALWATR_DEBUG=0 bun test",
+    "w": "bun run watch",
+    "watch": "bun run watch:ts & bun run watch:es",
+    "watch:es": "bun run build:es --watch",
+    "watch:ts": "bun run build:ts --watch --preserveWatchOutput"
+  },
   "files": [
-    "**/*.{js,mjs,cjs,map,d.ts,html,md}",
-    "!demo/**/*"
+    "dist",
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "README.md",
+    "LICENSE"
   ],
-  "homepage": "https://github.com/Alwatr/nitrobase/tree/next/packages/engine#readme",
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "alwatr",
     "data",
@@ -44,34 +76,6 @@
     "storage",
     "typescript"
   ],
-  "license": "MPL-2.0",
-  "main": "./dist/main.cjs",
-  "module": "./dist/main.mjs",
   "prettier": "@alwatr/nanolib/prettier-config",
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Alwatr/nitrobase",
-    "directory": "packages/engine"
-  },
-  "scripts": {
-    "b": "yarn run build",
-    "build": "yarn run build:ts & yarn run build:es",
-    "build:es": "nano-build --preset=module",
-    "build:ts": "tsc --build",
-    "c": "yarn run clean",
-    "cb": "yarn run clean && yarn run build",
-    "clean": "rm -rfv dist *.tsbuildinfo",
-    "d": "yarn node --enable-source-maps --trace-warnings",
-    "w": "yarn run watch",
-    "watch": "yarn run watch:ts & yarn run watch:es",
-    "watch:es": "yarn run build:es --watch",
-    "watch:ts": "yarn run build:ts --watch --preserveWatchOutput"
-  },
-  "sideEffects": false,
-  "type": "module",
-  "types": "./dist/main.d.ts",
-  "gitHead": "e23943a279d6b0905b205c0c17b2b3249efab226"
+  "gitHead": "4a25cd3e0499cf61dd761e87d3711abf9b0cd208"
 }

package/src/alwatr-nitrobase.ts

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

package/src/logger.ts

@@ -0,0 +1,4 @@
+import {createLogger} from '@alwatr/logger';
+
+
+export const logger = /* #__PURE__ */ createLogger(__package_name__);

package/src/main.ts

@@ -0,0 +1 @@
+export * from './alwatr-nitrobase.js';

package/CHANGELOG.md

@@ -1,351 +0,0 @@
-# Change Log
-
-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
-
-* add "sideEffects": false to package.json files for better tree-shaking ([cb6f75b](https://github.com/Alwatr/nitrobase/commit/cb6f75b86eb7dba6812aaad5136fcd867e885562))
-* add type imports for nano-build and type-helper in logger files ([6ca3627](https://github.com/Alwatr/nitrobase/commit/6ca362761c0d30a2813369bda49c927960c787f8))
-
-### 🔨 Code Refactoring
-
-* rename newStoreFile_ to newStoreFile__ for consistency in AlwatrNitrobase class ([2010994](https://github.com/Alwatr/nitrobase/commit/201099488a9bd379a67355df0c26fbef205626bd))
-* update access modifiers to public for class properties and methods in nitrobase and user management ([a988d63](https://github.com/Alwatr/nitrobase/commit/a988d63b61828f6ce360e7179cbaccfa19dc1ae2))
-
-### 🧹 Miscellaneous Chores
-
-* remove Exir Studio sponsorship logo from multiple README files ([506459f](https://github.com/Alwatr/nitrobase/commit/506459fea7d29b97e478da562590dd202ce7e833))
-* remove unused types from tsconfig.json files and update references ([b504ced](https://github.com/Alwatr/nitrobase/commit/b504ced4a8f98de4fe79a2c974937278bd4e46cb))
-* Update license from AGPL-3.0 to MPL-2.0 ([af1746e](https://github.com/Alwatr/nitrobase/commit/af1746ee9a3786c1cb2e0014f138e9f3b7086b8d))
-* update package.json files across all packages for consistency and improved metadata ([647900d](https://github.com/Alwatr/nitrobase/commit/647900d9966f8df275c4e2ef0550c501be38ece0))
-
-### 🔗 Dependencies update
-
-* add missing dependencies in package.json ([8fe3ae3](https://github.com/Alwatr/nitrobase/commit/8fe3ae36736564a0c56b8915cfcb52b4b00befc2))
-* remove unused packageTracer import and related code from logger.ts ([46ee9d8](https://github.com/Alwatr/nitrobase/commit/46ee9d80bb65299933c8f41631bad527ff206f38))
-* update dependencies in package.json files across all packages to latest versions ([72c20ef](https://github.com/Alwatr/nitrobase/commit/72c20efbc1cac9825fb4880772e3fad797d74a23))
-* update imports to use new package paths for improved modularity ([e59abcc](https://github.com/Alwatr/nitrobase/commit/e59abcce6d32fe3eee1c1f1b578a4b09794e95e6))
-
-## [7.8.0](https://github.com/Alwatr/nitrobase/compare/v7.7.0...v7.8.0) (2025-03-06)
-
-### Dependencies update
-
-* **deps-dev:** bump the dependencies group across 1 directory with 5 updates ([fe6ab37](https://github.com/Alwatr/nitrobase/commit/fe6ab37263f609f8bce8398462b7105b8e5a55fe)) by @dependabot[bot]
-* update @alwatr/nanolib, @alwatr/nano-build, and @alwatr/type-helper to latest versions ([5f3f89b](https://github.com/Alwatr/nitrobase/commit/5f3f89b1236f66e9167957d60d43c8d0abff108d)) by @
-
-## [7.7.0](https://github.com/Alwatr/nitrobase/compare/v7.6.1...v7.7.0) (2025-02-26)
-
-**Note:** Version bump only for package @alwatr/nitrobase-engine
-
-## [7.6.0](https://github.com/Alwatr/nitrobase/compare/v7.5.9...v7.6.0) (2025-02-26)
-
-### Miscellaneous Chores
-
-* rollback all versions ([9ff6c11](https://github.com/Alwatr/nitrobase/commit/9ff6c11ef3e44ea669a814da73ed39ddc2c8e971)) by @alimd
-
-## [7.5.8](https://github.com/Alwatr/nitrobase/compare/v7.5.7...v7.5.8) (2025-02-18)
-
-### Dependencies update
-
-* bump @alwatr/nanolib, @alwatr/nano-build, and @types/node to latest versions across multiple packages ([3e89c62](https://github.com/Alwatr/nitrobase/commit/3e89c62ad20f3afe0c38c6ae36d91bcb6199b231)) by @
-* **deps-dev:** bump the dependencies group across 1 directory with 2 updates ([03715d0](https://github.com/Alwatr/nitrobase/commit/03715d0b5534b127dfb57ffe0ea713fb168eefe6)) by @dependabot[bot]
-
-## [7.5.7](https://github.com/Alwatr/nitrobase/compare/v7.5.6...v7.5.7) (2025-02-03)
-
-### Dependencies update
-
-* update [@alwatr](https://github.com/alwatr) dependencies to latest versions ([f8bb10f](https://github.com/Alwatr/nitrobase/commit/f8bb10fa3343f25e2a442e80fbddb88c55fac813)) by @
-
-## [7.5.6](https://github.com/Alwatr/nitrobase/compare/v7.5.5...v7.5.6) (2025-02-03)
-
-### Bug Fixes
-
-* bind storeChanged_ method in constructor for proper context ([#350](https://github.com/Alwatr/nitrobase/issues/350)) ([33cf076](https://github.com/Alwatr/nitrobase/commit/33cf0767fa6f78512b687580dc1260cf882c9197)) by @
-
-## [7.5.5](https://github.com/Alwatr/nitrobase/compare/v7.5.4...v7.5.5) (2025-02-02)
-
-### Dependencies update
-
-* **deps-dev:** bump @types/node ([d60ee96](https://github.com/Alwatr/nitrobase/commit/d60ee96716b8df7837b3d7f9fe4b8705c94e5af0)) by @dependabot[bot]
-* update ([0b9eccd](https://github.com/Alwatr/nitrobase/commit/0b9eccd3b54dade17e3eeb94bd08612c57356801)) by @alimd
-
-## [7.5.4](https://github.com/Alwatr/nitrobase/compare/v7.5.3...v7.5.4) (2025-01-12)
-
-### Bug Fixes
-
-* **nitrobase:** optional data in newStoreFile_ and throw Error when data not exist for document type ([6d2a173](https://github.com/Alwatr/nitrobase/commit/6d2a173ca4414d6928ef1b703dd0836648eb0787)) by @alimd
-* **nitrobase:** remove initialData parameter from newCollection method ([56cacf0](https://github.com/Alwatr/nitrobase/commit/56cacf0e65e8be2d68f4621eaf4e6d847bf39293)) by @alimd
-* **nitrobase:** required initial data  for newDocument ([61f1788](https://github.com/Alwatr/nitrobase/commit/61f178850594ccfc0c1a4ab9429cc2e0438eb11c)) by @alimd
-
-### Code Refactoring
-
-* **nitrobase:** bind storeChanged_ method directly instead of using bind in multiple locations ([dba1da6](https://github.com/Alwatr/nitrobase/commit/dba1da6bf095e6984af98d8e6c65c64fcc3fb5af)) by @alimd
-
-### Dependencies update
-
-* **deps-dev:** bump the dependencies group across 1 directory with 11 updates ([fdd30a6](https://github.com/Alwatr/nitrobase/commit/fdd30a6639ae7ead4e8dbfaca0295cb2bf0e6649)) by @dependabot[bot]
-
-## [7.5.0](https://github.com/Alwatr/nitrobase/compare/v7.4.1...v7.5.0) (2024-11-09)
-
-### Code Refactoring
-
-* **engine:** make `config` as a public property ([6453540](https://github.com/Alwatr/nitrobase/commit/6453540aac42340cfe3b7ac9e4c26f904aaccdcc)) by @mohammadhonarvar
-
-## [7.4.0](https://github.com/Alwatr/nitrobase/compare/v7.3.1...v7.4.0) (2024-11-08)
-
-### Dependencies update
-
-* bump @alwatr/nanolib from 5.2.0 to 5.2.1 across multiple packages ([e1f87b0](https://github.com/Alwatr/nitrobase/commit/e1f87b07d33e8227440256a70f012aa63410f153)) by @
-* **deps-dev:** bump @types/node in the dependencies group ([67ffbad](https://github.com/Alwatr/nitrobase/commit/67ffbad06c95c304d47acbe46fd137fb4cf69f95)) by @dependabot[bot]
-* **deps:** bump @alwatr/nanolib from 5.0.0 to 5.2.0 in the alwatr group ([dfa1eef](https://github.com/Alwatr/nitrobase/commit/dfa1eefb191bbaac2ff2fff410bb1d3ec615d959)) by @dependabot[bot]
-
-## [7.3.1](https://github.com/Alwatr/nitrobase/compare/v7.3.0...v7.3.1) (2024-11-02)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group with 8 updates ([63f7adc](https://github.com/Alwatr/nitrobase/commit/63f7adc5ff83d4876f34d4f089a4be9b95b711a6)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 2 updates ([20fb436](https://github.com/Alwatr/nitrobase/commit/20fb436b9f146d5ec7452a693c7af8faa32bedff)) by @dependabot[bot]
-
-### Dependencies update
-
-* **deps-dev:** bump @types/node in the dependencies group ([dd3e94a](https://github.com/Alwatr/nitrobase/commit/dd3e94a4c007da8fddda4cfeffe5f0763d74952e)) by @dependabot[bot]
-* **deps:** bump the alwatr group with 6 updates ([eb9eeb1](https://github.com/Alwatr/nitrobase/commit/eb9eeb1901f7947cde783bf6f06340c984d6f59d)) by @dependabot[bot]
-
-## [7.3.0](https://github.com/Alwatr/nitrobase/compare/v7.2.1...v7.3.0) (2024-10-11)
-
-### Features
-
-* update `import`s & packages based on the latest changes of `nanolib` & prevent side-effects ([0d66f89](https://github.com/Alwatr/nitrobase/commit/0d66f894dc4ff615ab73ebd27c275f98dc384fbe)) by @mohammadhonarvar
-
-### Code Refactoring
-
-* update `import`s & packages based on the latest changes of `nanolib` ([ce990a2](https://github.com/Alwatr/nitrobase/commit/ce990a2fedc5545e971c3bb6e58b55bfba8c0bd9)) by @mohammadhonarvar
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group with 10 updates ([7bdcf3f](https://github.com/Alwatr/nitrobase/commit/7bdcf3f47ddb8e1376a1c7ae6e221811182bae58)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 10 updates ([60afdde](https://github.com/Alwatr/nitrobase/commit/60afdde98562f3023e6624ee0579d6bdee80bc32)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 6 updates ([1cf29b2](https://github.com/Alwatr/nitrobase/commit/1cf29b20055554945cd669ea9d022ab7c503d9fc)) by @dependabot[bot]
-
-## [7.2.1](https://github.com/Alwatr/nitrobase/compare/v7.2.0...v7.2.1) (2024-09-29)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump @types/node in the development-dependencies group ([9b146d2](https://github.com/Alwatr/nitrobase/commit/9b146d2f6cf7d1d79a2a6f46a5e8f50e7fb2ac75)) by @dependabot[bot]
-* **engine:** change the license to AGPL-3.0 ([f9d89d5](https://github.com/Alwatr/nitrobase/commit/f9d89d5de592b4df397c9b15156166aed90fa8d1)) by @ArmanAsadian
-
-### Dependencies update
-
-* update ([90a0fe1](https://github.com/Alwatr/nitrobase/commit/90a0fe146eb703c183c116776d7c5748918282da)) by @
-
-## [7.2.0](https://github.com/Alwatr/nitrobase/compare/v7.1.1...v7.2.0) (2024-09-24)
-
-### Code Refactoring
-
-* rename all store to nitrobase ([0928420](https://github.com/Alwatr/nitrobase/commit/0928420d8751e16ff1e8d91e1d3048a5895885a6)) by @AliMD
-* rename all store to nitrobase ([9e31765](https://github.com/Alwatr/nitrobase/commit/9e31765b63ecd94bcf600cb44cfd9e341dd11a4e)) by @AliMD
-
-## [7.1.1](https://github.com/Alwatr/nitrobase/compare/v7.1.0...v7.1.1) (2024-09-24)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group across 1 directory with 3 updates ([122251c](https://github.com/Alwatr/nitrobase/commit/122251c315c422b7e9c2d5aba827f27b321194bb)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 9 updates ([2a94694](https://github.com/Alwatr/nitrobase/commit/2a94694b2ec12c2915aa77934023328751d13837)) by @dependabot[bot]
-
-### Dependencies update
-
-* update ([82c475e](https://github.com/Alwatr/nitrobase/commit/82c475e29bd7f42ad03660556f40f180b3b6c9c6)) by @AliMD
-
-## [7.1.0](https://github.com/Alwatr/nitrobase/compare/v7.0.0...v7.1.0) (2024-09-08)
-
-### Features
-
-* **engine:** add @alwatr/nitrobase-helper package ([66bca93](https://github.com/Alwatr/nitrobase/commit/66bca93e46f344b54b6f9eb57f4a680247e36157)) by @AliMD
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group with 2 updates ([f6d8374](https://github.com/Alwatr/nitrobase/commit/f6d837417886ccf3719100570194434455fda365)) by @dependabot[bot]
-
-## [7.0.0](https://github.com/Alwatr/nitrobase/compare/v7.0.0-beta.1...v7.0.0) (2024-09-02)
-
-### Features
-
-* Add getStoreList method to AlwatrNitrobase ([25ace2a](https://github.com/Alwatr/nitrobase/commit/25ace2aa4e32d9ad99d6ac2e63ac783462b9f4e5)) by @AliMD
-
-### Bug Fixes
-
-* **engine:** set the correct names ([076fa3e](https://github.com/Alwatr/nitrobase/commit/076fa3e0d7cfe673cc58418153b7dc2aacfb340a)) by @mohammadhonarvar
-* **packages/engine:** apply some new name of methods ([e3d5712](https://github.com/Alwatr/nitrobase/commit/e3d5712e19406f58fb87b822e036df5847aab6c0)) by @mohammadhonarvar
-
-### Code Refactoring
-
-* **engine:** use  `hasItem` ([e17afa7](https://github.com/Alwatr/nitrobase/commit/e17afa7ef050cbf9f349dd6919739a01764aa24f)) by @mohammadhonarvar
-* move all demo from engine to srore package ([e34fc49](https://github.com/Alwatr/nitrobase/commit/e34fc49c71703cd287559ca4fb23f9f13842b2d0)) by @AliMD
-* Remove unused "ALWATR_DEBUG" environment variable from build script ([26e7642](https://github.com/Alwatr/nitrobase/commit/26e764280e0a2827904762ed3de21a9966ddfc63)) by @AliMD
-* Replace id_ with documentId and collectionId in AlwatrNitrobase ([e58d0fd](https://github.com/Alwatr/nitrobase/commit/e58d0fd905722352238e11ed4e308907485f8ff5)) by @AliMD
-* Update type imports in alwatr-nitrobase.ts ([d6f02ad](https://github.com/Alwatr/nitrobase/commit/d6f02ad5b779d04aa1b484bff96369483393af15)) by @AliMD
-* Update type imports in alwatr-nitrobase.ts ([274d234](https://github.com/Alwatr/nitrobase/commit/274d234e6653cade2288288a4894feb7314987a2)) by @AliMD
-
-### Dependencies update
-
-* update ([6411ff7](https://github.com/Alwatr/nitrobase/commit/6411ff7d49323b8bbf0dbb03fbc3c640b433a8bb)) by @
-
-## [7.0.0-beta.1](https://github.com/Alwatr/nitrobase/compare/v7.0.0-beta.0...v7.0.0-beta.1) (2024-08-31)
-
-### Code Refactoring
-
-* Remove unnecessary debug flag ([bdebb58](https://github.com/Alwatr/nitrobase/commit/bdebb5856310efd3628edb236f790968d94035fa)) by @
-* Update demo for test schemaVer ([4d5038b](https://github.com/Alwatr/nitrobase/commit/4d5038b3a5ae390355e2bd6524f7edc66fedc65c)) by @
-
-## [7.0.0-beta.0](https://github.com/Alwatr/nitrobase/compare/v6.2.1...v7.0.0-beta.0) (2024-08-31)
-
-### ⚠ BREAKING CHANGES
-
-* The `deleteFile` method has been renamed to `remove`. Update your code accordingly.
-* The `doc` and `collection` methods have been deprecated and should no longer be used. Instead, use the `openDocument` and `openCollection` methods.
-
-### Features
-
-* Add newDocument and newCollection methods to AlwatrNitrobase ([363f820](https://github.com/Alwatr/nitrobase/commit/363f820a104e49a49746c95e7f303982d3ecb481)) by @AliMD
-* Open document and collection with given id in AlwatrNitrobase ([5041a20](https://github.com/Alwatr/nitrobase/commit/5041a20bbf6dc3a26499aac4649e8c0d17c23537)) by @AliMD
-
-### Bug Fixes
-
-* **alwatr-nitrobase:** logger methods name issue ([4798d15](https://github.com/Alwatr/nitrobase/commit/4798d1527d05f1c7c79ddf03520e3478c0dae529)) by @AliMD
-
-### Code Refactoring
-
-* **AlwatrNitrobase:** compatible with new api ([42c30f2](https://github.com/Alwatr/nitrobase/commit/42c30f2c7a066305eaba5e6fae50bfa5dc4502c8)) by @AliMD
-* **demo:** compatible with new api ([a76cc74](https://github.com/Alwatr/nitrobase/commit/a76cc7403610661c42099aae254ca5989bda1bff)) by @AliMD
-* Remove unnecessary debug flag from yarn script ([7f21798](https://github.com/Alwatr/nitrobase/commit/7f217981fb9c53c01f469a1a0b2761d856dc7337)) by @AliMD
-* rename `deleteFile` method to `remove` ([7356079](https://github.com/Alwatr/nitrobase/commit/735607933f78424ff7bdb6728f0e7b6eb18ca8a1)) by @AliMD
-* update StoreFileStat type to make extension property optional ([e75a186](https://github.com/Alwatr/nitrobase/commit/e75a186fbafd30a3d745467a973bec06e1d8109e)) by @AliMD
-* updates the `storeChanged__` method name to `storeChanged_`. ([8fd35fa](https://github.com/Alwatr/nitrobase/commit/8fd35fa69c0ff5c5fdc1f3be11a70ca4bac7dd81)) by @AliMD
-
-### Miscellaneous Chores
-
-* fix logs messages ([73d4496](https://github.com/Alwatr/nitrobase/commit/73d4496928c6e8fa5800f31619b9be717cba3592)) by @AliMD
-
-### Dependencies update
-
-* update ([2657638](https://github.com/Alwatr/nitrobase/commit/26576384c4a8ffcf35776f19008432e194fb39de)) by @AliMD
-
-## [6.2.1](https://github.com/Alwatr/nitrobase/compare/v6.2.0...v6.2.1) (2024-08-31)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group across 1 directory with 13 updates ([7e6aa11](https://github.com/Alwatr/nitrobase/commit/7e6aa11e1b4507111993a6070b481ebc95e534c7)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 10 updates ([faf1fc1](https://github.com/Alwatr/nitrobase/commit/faf1fc15f8b4c9c4c451dd5fa1d564eb3bf3d9a3)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 9 updates ([64ac4f2](https://github.com/Alwatr/nitrobase/commit/64ac4f239c0f0a8ccdadbd736c16973bd684f811)) by @dependabot[bot]
-
-## [6.2.0](https://github.com/Alwatr/nitrobase/compare/v6.1.0...v6.2.0) (2024-07-03)
-
-### Features
-
-* Add freeze property to CollectionReference and DocumentReference ([af1d7e4](https://github.com/Alwatr/nitrobase/commit/af1d7e47b3217d4e361a63d9eb9c410e04ea9385)) by @AliMD
-
-## [6.1.0](https://github.com/Alwatr/nitrobase/compare/v6.0.5...v6.1.0) (2024-07-03)
-
-### Dependencies update
-
-* bump the development-dependencies ([546ca1b](https://github.com/Alwatr/nitrobase/commit/546ca1be049090eb3c8304fcb75e98ac0b984510)) by @AliMD
-
-## [6.0.5](https://github.com/Alwatr/nitrobase/compare/v6.0.4...v6.0.5) (2024-05-12)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group across 1 directory with 3 updates ([f97552d](https://github.com/Alwatr/nitrobase/commit/f97552d0e8e85bc2e2f0863da17502b8e55799e8)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 8 updates ([1aa95ca](https://github.com/Alwatr/nitrobase/commit/1aa95ca232a7b706eda4b0eb537316d38b27aa28)) by @dependabot[bot]
-
-## [6.0.4](https://github.com/Alwatr/nitrobase/compare/v6.0.3...v6.0.4) (2024-04-25)
-
-**Note:** Version bump only for package @alwatr/nitrobase-engine
-
-## [6.0.3](https://github.com/Alwatr/nitrobase/compare/v6.0.2...v6.0.3) (2024-03-28)
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group with 13 updates ([23fb121](https://github.com/Alwatr/nitrobase/commit/23fb1217470593d386b658f2a1d85fe4ef6e55df)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 10 updates ([ce6ee74](https://github.com/Alwatr/nitrobase/commit/ce6ee7495aaa67a8d3bb0a3f2b2ea8389e161552)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 9 updates ([686e155](https://github.com/Alwatr/nitrobase/commit/686e155d4c0ccab6daf81d280cf91299152b8583)) by @dependabot[bot]
-
-## [6.0.0](https://github.com/Alwatr/nitrobase/compare/v6.0.0-alpha.0...v6.0.0) (2024-01-24)
-
-### Features
-
-* Enhance types, add Jsonifiable type and update method signatures ([57502d2](https://github.com/Alwatr/nitrobase/commit/57502d230f0c9cb88aa9a9e71a3460f1219955b0)) by @AliMD
-
-### Miscellaneous Chores
-
-* **deps-dev:** bump the development-dependencies group with 4 updates ([7d71044](https://github.com/Alwatr/nitrobase/commit/7d71044165583f9d56fb61a05bdf51ccb104f422)) by @dependabot[bot]
-* **deps:** bump the alwatr-dependencies group with 10 updates ([cc42e89](https://github.com/Alwatr/nitrobase/commit/cc42e895179c53ee2dd60802d994ba84f5a37fde)) by @dependabot[bot]
-* **deps:** update ([0e85743](https://github.com/Alwatr/nitrobase/commit/0e85743f76f0efdd0f6cd4001eebc4550b43f43f)) by @AliMD
-* **deps:** update ([a894bfc](https://github.com/Alwatr/nitrobase/commit/a894bfc62124a3eb027cad4e8d1c974761e22dad)) by @AliMD
-
-## [6.0.0-alpha.0](https://github.com/Alwatr/nitrobase/compare/v5.1.0...v6.0.0-alpha.0) (2024-01-15)
-
-### Miscellaneous Chores
-
-* **deps:** update ([8f3edcf](https://github.com/Alwatr/nitrobase/commit/8f3edcf8a489927a6c43dfcaa5db88a579ecac80)) by @
-
-## [5.1.0](https://github.com/Alwatr/nitrobase/compare/v5.0.0...v5.1.0) (2024-01-13)
-
-**Note:** Version bump only for package @alwatr/nitrobase-engine
-
-# [5.0.0](https://github.com/Alwatr/nitrobase/compare/v5.0.0-beta...v5.0.0) (2024-01-12)
-
-### Code Refactoring
-
-* **engine:** remove all string id from public api ([c44fd1c](https://github.com/Alwatr/nitrobase/commit/c44fd1c0a7daffe20ba9e836f23d63a4dd4250b8)) by @AliMD
-
-### Features
-
-* **engine:** use alwatr exit hook ([5be4f01](https://github.com/Alwatr/nitrobase/commit/5be4f01bc746b5b4cfb1df10def3abc5632c44ee)) by @njfamirm
-* **nitrobase:** Add option to error when nitrobase not initialized ([4b27468](https://github.com/Alwatr/nitrobase/commit/4b27468a063027b357e27fdff2484932e23d46e0)) by @AliMD
-
-### BREAKING CHANGES
-
-* **engine:** The string ID has been removed from public APIs to prevent confusion caused by a simple sting ID.
-
-# [5.0.0-beta](https://github.com/Alwatr/nitrobase/compare/v4.1.0...v5.0.0-beta) (2023-12-31)
-
-### Bug Fixes
-
-* **deps:** dev deps ([b129567](https://github.com/Alwatr/nitrobase/commit/b12956768b9d60a75c0fdc43774512b86b655f78)) by @AliMD
-* **engine/demo:** benchmark ([48b4456](https://github.com/Alwatr/nitrobase/commit/48b4456cd09bf610bfe718c843e55ff0db2a9e5a)) by @njfamirm
-* **engine/demo:** import path ([6effc2c](https://github.com/Alwatr/nitrobase/commit/6effc2c105aaf4057581bc161723d59a7ea0b7e6)) by @njfamirm
-* **engine:** add types to deps ([170043d](https://github.com/Alwatr/nitrobase/commit/170043d9095c73e3c678c051bc3f34d2ccd43730)) by @njfamirm
-* **engine:** data loss issue and improve performance ([07f6877](https://github.com/Alwatr/nitrobase/commit/07f68777faec66fee4efae7afd340bebe7078f17)) by @AliMD
-* **engine:** file path ([bbc4abd](https://github.com/Alwatr/nitrobase/commit/bbc4abdbb601108dc91ee95eeaac5cbbc272cdd4)) by @njfamirm
-* **engine:** get collection issue ([742aa23](https://github.com/Alwatr/nitrobase/commit/742aa236ae98c934ea6e0904a8a91d152471a31a)) by @AliMD
-* **engine:** import type ([9f67871](https://github.com/Alwatr/nitrobase/commit/9f67871dba8528a5393ea372f136865c952a102c)) by @njfamirm
-* **engine:** Remove StoreFileStatModel class ([d47b680](https://github.com/Alwatr/nitrobase/commit/d47b680d54b8bd9a0b8926653a69cb59c8f36398)) by @AliMD
-* **engine:** unsaved data lost issues ([fec0bef](https://github.com/Alwatr/nitrobase/commit/fec0bef78ac67ddd669012d8804588883f39affa)) by @AliMD
-* **engine:** Update defaultChangeDebounce value in AlwatrNitrobase ([63edd08](https://github.com/Alwatr/nitrobase/commit/63edd08c87c675edb91b8f7aa61b901a6d1db111)) by @AliMD
-* **engine:** Update imports and refactor util.ts ([2b1f962](https://github.com/Alwatr/nitrobase/commit/2b1f9628f4578f707996fe5e6d5d92c7d093b615)) by @AliMD
-
-### Features
-
-* **engine/demo:** collection with new api ([f603e86](https://github.com/Alwatr/nitrobase/commit/f603e86d2827c66219321f9df400049e76b78c21)) by @AliMD
-* **engine:** Add data-lost-test.js demo file ([673f324](https://github.com/Alwatr/nitrobase/commit/673f3247c4b6c1bca2f9e9d9169843ca6a5e9804)) by @AliMD
-* **engine:** debounce for save file ([c92749e](https://github.com/Alwatr/nitrobase/commit/c92749e83352129c02130ac2466dd5acda289795)) by @AliMD
-* **engine:** doc demo ([f49f78b](https://github.com/Alwatr/nitrobase/commit/f49f78bd3b5942406fe74e273e87bcbf12f67c4f)) by @njfamirm
-* **engine:** enhance benchmark demo ([200da18](https://github.com/Alwatr/nitrobase/commit/200da18cd9542fa4182f910c0ad813703326fe38)) by @AliMD
-* **engine:** impediment exit hook ([68695a9](https://github.com/Alwatr/nitrobase/commit/68695a975e0ec6c473bbd2d9a62c81720f090352)) by @AliMD
-* **engine:** Refactor code to improve performance and readability ([b4c0848](https://github.com/Alwatr/nitrobase/commit/b4c0848e7518ae5c96e8ab7643716a2e923f7635)) by @AliMD
-* **node-fs:** Update logger method arguments to include truncated path ([8c6f49a](https://github.com/Alwatr/nitrobase/commit/8c6f49ad56d5667ba1280a5d28b7a39b21c3a11a)) by @AliMD

package/dist/main.cjs

@@ -1,4 +0,0 @@
-/** 📦 @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 +0,0 @@
-{
-  "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/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 +0,0 @@
-/** 📦 @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 +0,0 @@
-{
-  "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/nanolib';\nimport type {} from '@alwatr/type-helper';\n\nexport const logger = /* #__PURE__ */ createLogger(__package_name__);\n"],
-  "mappings": "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",
-  "names": []
-}