@alwatr/node-fs 1.0.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# 1.0.0-beta.0 (2024-01-08)
+
+### Bug Fixes
+
+* **node-fs:** Update import statement for make-file module ([7bddaa0](https://github.com/Alwatr/nanolib/commit/7bddaa0d629c304fedd07c4022d7503aa9b974b6)) by @AliMD
+
+### Features
+
+* **node-fs:** Add make-file-bench demo script ([ca3a57a](https://github.com/Alwatr/nanolib/commit/ca3a57a31de5a8b9c76c9d33cb9755809f09a335)) by @AliMD
+* **node-fs:** base package ([74cbe48](https://github.com/Alwatr/nanolib/commit/74cbe4821c991d1f6c3d5805b29602b922c3f505)) by @njfamirm
+* **node-fs:** copy from store ([5c23e01](https://github.com/Alwatr/nanolib/commit/5c23e01e42d438c15dcd272d2cc351527865c86c)) by @njfamirm
+* **node-fs:** definePackage and logger ([3880703](https://github.com/Alwatr/nanolib/commit/38807039895c784be6168111506b0721980cbb29)) by @njfamirm
+* **node-fs:** demo ([31f3740](https://github.com/Alwatr/nanolib/commit/31f37405a7bb2b4b02440de7f96f5cc8a474aba9)) by @njfamirm
+* **node-fs:** enhance json types ([e85d927](https://github.com/Alwatr/nanolib/commit/e85d9276374a8c5171901791a3a43acad64843a6)) by @AliMD
+* **node-fs:** enhance writeJson type ([9010c72](https://github.com/Alwatr/nanolib/commit/9010c723b1f34cd647f157466554b312fc84a1d3)) by @AliMD
+* **node-fs:** makeFile ([186ba09](https://github.com/Alwatr/nanolib/commit/186ba09822bddfe200a0ac4725063785cadd0999)) by @njfamirm
+* **node-fs:** readFile under asyncQueue ([ab12153](https://github.com/Alwatr/nanolib/commit/ab12153281600a4ac90ef627811b430a95140ddd)) by @AliMD
+* **node-fs:** rewrite new writeFile method ([7534ed1](https://github.com/Alwatr/nanolib/commit/7534ed158cdfe1ee593050255c17449960b13001)) by @AliMD
+* **node-fs:** writeFile under asyncQueue ([6d8b3d7](https://github.com/Alwatr/nanolib/commit/6d8b3d7953938fc954e8ce350206555030560978)) by @AliMD
+* **node-fs:** writeJson method ([581d4f9](https://github.com/Alwatr/nanolib/commit/581d4f958ccb262c13f23881151616b7ec5e93ee)) by @AliMD

package/LICENSE

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

package/README.md

@@ -0,0 +1,37 @@
+# Node FS
+
+Enhanced file system operations in Node.js with asynchronous queue to prevent parallel writes.
+
+## Installation
+
+```bash
+yarn add @alwatr/node-fs
+```
+
+## Features
+
+- Checks if a directory exists. If it doesn't, it creates the directory and all necessary subdirectories.
+- Before writing a file successfully, first writes it to a temporary path (`path.tmp`).
+- If a file already exists, renames and keeps the existing file at a backup path (`path.bak`).
+- If a write operation fails, the original file remains unchanged.
+- Includes `readJson` and `writeJson` functions that automatically parse and stringify JSON data.
+- Supports both synchronous and asynchronous read/write operations.
+- An asynchronous queue is used to prevent simultaneous write operations.
+- Fully written in TypeScript, includes type definitions.
+- Separate builds are provided for ESModule and CommonJS.
+- Zero dependencies, except for the nanolib library.
+- Includes a beautiful log feature, which uses the [logger](https://github.com/Alwatr/nanolib/tree/next/packages/logger) package from nanolib.
+
+## Usage
+
+```typescript
+import {writeJson} from '@alwatr/node-fs';
+
+const path = 'file.json';
+await writeJson(path, {a: 1}); // wait to finish
+writeJson(path, {a: 2}); // asynchronous write in queue
+writeJson(path, {a: 3}); // asynchronous write in queue
+
+const data = await readJson(path); // automatically wait for the queue to finish
+console.log(data.a); // 3
+```

package/dist/common.d.ts

@@ -0,0 +1,4 @@
+import { AsyncQueue } from '@alwatr/async-queue';
+export declare const logger: import("@alwatr/logger").AlwatrLogger;
+export declare const asyncQueue: AsyncQueue;
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAK/C,eAAO,MAAM,MAAM,uCAAwD,CAAC;AAE5E,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,26 @@
+import type { Dictionary } from '@alwatr/type-helper';
+/**
+ * Parse json string.
+ *
+ * @param content - json string
+ * @returns json object
+ * @example
+ * ```typescript
+ * const json = parseJson('{"a":1,"b":2}');
+ * console.log(json.a); // 1
+ * ```
+ */
+export declare function parseJson<T extends Dictionary>(content: string): T;
+/**
+ * Stringify json object.
+ *
+ * @param data - json object
+ * @returns json string
+ * @example
+ * ```typescript
+ * const json = jsonStringify({a:1, b:2});
+ * console.log(json); // '{"a":1,"b":2}'
+ * ```
+ */
+export declare function jsonStringify<T extends Dictionary>(data: T): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAQlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAQnE"}

package/dist/main.cjs

@@ -0,0 +1,3 @@
+/* @alwatr/node-fs v1.0.0-beta.0 */
+"use strict";var l=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var k=(r,e)=>{for(var o in e)l(r,o,{get:e[o],enumerable:!0})},A=(r,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of P(e))!b.call(r,a)&&a!==o&&l(r,a,{get:()=>e[a],enumerable:!(n=M(e,a))||n.enumerable});return r};var h=r=>A(l({},"__esModule",{value:!0}),r);var N={};k(N,{existsSync:()=>v.existsSync,makeEmptyFile:()=>Q,readFile:()=>d,readFileSync:()=>m,readJson:()=>j,resolve:()=>J.resolve,unlink:()=>D.unlink,writeFile:()=>u,writeFileSync:()=>y,writeJson:()=>O});module.exports=h(N);var w=require("@alwatr/async-queue"),x=require("@alwatr/logger"),i=(0,x.definePackage)("@alwatr/node-fs","1.0.0-beta.0"),c=new w.AsyncQueue;var F=require("fs"),_=require("fs/promises"),f=require("@alwatr/flat-string");function m(r){i.logMethodArgs?.("readFileSync","..."+r.slice(-32));try{return(0,f.flatString)((0,F.readFileSync)(r,{encoding:"utf-8",flag:"r"}))}catch(e){throw i.error("readFileSync","read_file_failed",{path:r},e),new Error("read_file_failed",{cause:e.cause})}}function d(r){return i.logMethodArgs?.("readFile","..."+r.slice(-32)),c.push(r,async()=>{try{return(0,f.flatString)(await(0,_.readFile)(r,{encoding:"utf-8",flag:"r"}))}catch(e){throw i.error("readFile","read_file_failed",{path:r},e),new Error("read_file_failed",{cause:e.cause})}})}var t=require("fs"),s=require("fs/promises"),g=require("path");function y(r,e){i.logMethodArgs?.("writeFileSync","..."+r.slice(-32));try{let o=(0,t.existsSync)(r);if(!o){let n=(0,g.dirname)(r);(0,t.existsSync)(n)||(0,t.mkdirSync)(n,{recursive:!0})}(0,t.writeFileSync)(r+".tmp",e,{encoding:"utf-8",flag:"w"}),o&&(0,t.renameSync)(r,r+".bak"),(0,t.renameSync)(r+".tmp",r),i.logOther?.("writeFileSync success","..."+r.slice(-32))}catch(o){throw i.error("writeFileSync","write_file_failed",{path:r},o),new Error("write_file_failed",{cause:o.cause})}}function u(r,e){return i.logMethodArgs?.("writeFile","..."+r.slice(-32)),c.push(r,async()=>{try{i.logOther?.("writeFile start","..."+r.slice(-32));let o=(0,t.existsSync)(r);if(!o){let n=(0,g.dirname)(r);(0,t.existsSync)(n)||await(0,s.mkdir)(n,{recursive:!0})}await(0,s.writeFile)(r+".tmp",e,{encoding:"utf-8",flag:"w"}),o&&await(0,s.rename)(r,r+".bak"),await(0,s.rename)(r+".tmp",r),i.logOther?.("writeFile success","..."+r.slice(-32))}catch(o){throw i.error("writeFile","write_file_failed",{path:r},o),new Error("write_file_failed",{cause:o.cause})}})}function p(r){try{return JSON.parse(r)}catch(e){throw i.error("parseJson","invalid_json",e),new Error("invalid_json",{cause:e.cause})}}function S(r){try{return JSON.stringify(r)}catch(e){throw i.error("jsonStringify","stringify_failed",e),new Error("stringify_failed",{cause:e.cause})}}function j(r,e=!1){return i.logMethodArgs?.("readJson",{path:r.slice(-32),sync:e}),e===!0?p(m(r)):d(r).then(o=>p(o))}var T=require("@alwatr/flat-string");function O(r,e,o=!1){i.logMethodArgs?.("writeJson","..."+r.slice(-32));let n=(0,T.flatString)(S(e));return o===!0?y(r,n):u(r,n)}var E=require("fs/promises");async function Q(r){return i.logMethodArgs?.("makeEmptyFile","..."+r.slice(-32)),(await(0,E.open)(r,"w")).close()}var J=require("path"),v=require("fs"),D=require("fs/promises");0&&(module.exports={existsSync,makeEmptyFile,readFile,readFileSync,readJson,resolve,unlink,writeFile,writeFileSync,writeJson});
+//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/main.ts", "../src/common.ts", "../src/read-file.ts", "../src/write-file.ts", "../src/json.ts", "../src/read-json.ts", "../src/write-json.ts", "../src/make-file.ts"],
+  "sourcesContent": ["export * from './read-file';\nexport * from './write-file';\nexport * from './read-json';\nexport * from './write-json';\nexport * from './make-file';\n\nexport {resolve} from 'node:path';\nexport {existsSync} from 'node:fs';\nexport {unlink} from 'node:fs/promises';\n", "import {AsyncQueue} from '@alwatr/async-queue';\nimport {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport const logger = definePackage('@alwatr/node-fs', __package_version__);\n\nexport const asyncQueue = new AsyncQueue();\n", "import {readFileSync as readFileSync_} from 'node:fs';\nimport {readFile as readFile_} from 'node:fs/promises';\n\nimport {flatString} from '@alwatr/flat-string';\n\nimport {asyncQueue, logger} from './common';\n\n/**\n * Enhanced read File (Synchronous).\n *\n * @param path - file path\n * @returns file content\n * @example\n * ```typescript\n * const fileContent = readFileSync('./file.txt', sync);\n * ```\n */\nexport function readFileSync(path: string): string {\n  logger.logMethodArgs?.('readFileSync', '...' + path.slice(-32));\n  // if (!existsSync(path)) throw new Error('file_not_found');\n  try {\n    return flatString(readFileSync_(path, {encoding: 'utf-8', flag: 'r'}));\n  }\n  catch (err) {\n    logger.error('readFileSync', 'read_file_failed', {path}, err);\n    throw new Error('read_file_failed', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Enhanced read File (Asynchronous).\n *\n * - If writing queue is running for target path, it will wait for it to finish.\n *\n * @param path - file path\n * @returns file content\n * @example\n * ```typescript\n * const fileContent = await readFile('./file.txt', sync);\n * ```\n */\nexport function readFile(path: string): Promise<string> {\n  logger.logMethodArgs?.('readFile', '...' + path.slice(-32));\n  // if (!existsSync(path)) throw new Error('file_not_found');\n  return asyncQueue.push(path, async () => {\n    try {\n      return flatString(await readFile_(path, {encoding: 'utf-8', flag: 'r'}));\n    }\n    catch (err) {\n      logger.error('readFile', 'read_file_failed', {path}, err);\n      throw new Error('read_file_failed', {cause: (err as Error).cause});\n    }\n  });\n}\n", "import {writeFileSync as writeFileSync_, existsSync, mkdirSync, renameSync} from 'node:fs';\nimport {mkdir, rename, writeFile as writeFile_} from 'node:fs/promises';\nimport {dirname} from 'node:path';\n\nimport {asyncQueue, logger} from './common';\n\n/**\n * Enhanced write file (Synchronous).\n *\n * - If directory not exists, create it recursively.\n * - Write file to `path.tmp` before write success.\n * - If file exists, renamed (keep) to `path.bak`.\n * - If write failed, original file will not be changed.\n *\n * @param path - file path\n * @param content - file content\n * @example\n * ```typescript\n * writeFileSync('./file.txt', 'Hello World!');\n * ```\n */\nexport function writeFileSync(path: string, content: string): void {\n  logger.logMethodArgs?.('writeFileSync', '...' + path.slice(-32));\n  try {\n    const pathExists = existsSync(path);\n    if (!pathExists) {\n      const dir = dirname(path);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, {recursive: true});\n      }\n    }\n    writeFileSync_(path + '.tmp', content, {encoding: 'utf-8', flag: 'w'});\n    if (pathExists) {\n      renameSync(path, path + '.bak');\n    }\n    renameSync(path + '.tmp', path);\n    logger.logOther?.('writeFileSync success', '...' + path.slice(-32));\n  }\n  catch (err) {\n    logger.error('writeFileSync', 'write_file_failed', {path}, err);\n    throw new Error('write_file_failed', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Enhanced write file (Asynchronous).\n *\n * - If directory not exists, create it recursively.\n * - Write file to `path.tmp` before write success.\n * - If file exists, renamed (keep) to `path.bak`.\n * - If write failed, original file will not be changed.\n *\n * @param path - file path\n * @param content - file content\n * @example\n * ```typescript\n * await writeFile('./file.txt', 'Hello World!');\n * ```\n */\nexport function writeFile(path: string, content: string): Promise<void> {\n  logger.logMethodArgs?.('writeFile', '...' + path.slice(-32));\n  return asyncQueue.push(path, async () => {\n    try {\n      logger.logOther?.('writeFile start', '...' + path.slice(-32));\n      const pathExists = existsSync(path);\n      if (!pathExists) {\n        const dir = dirname(path);\n        if (!existsSync(dir)) {\n          await mkdir(dir, {recursive: true});\n        }\n      }\n      await writeFile_(path + '.tmp', content, {encoding: 'utf-8', flag: 'w'});\n      if (pathExists) {\n        await rename(path, path + '.bak');\n      }\n      await rename(path + '.tmp', path);\n      logger.logOther?.('writeFile success', '...' + path.slice(-32));\n    }\n    catch (err) {\n      logger.error('writeFile', 'write_file_failed', {path}, err);\n      throw new Error('write_file_failed', {cause: (err as Error).cause});\n    }\n  });\n}\n", "import {logger} from './common';\n\nimport type { Dictionary } from '@alwatr/type-helper';\n\n/**\n * Parse json string.\n *\n * @param content - json string\n * @returns json object\n * @example\n * ```typescript\n * const json = parseJson('{\"a\":1,\"b\":2}');\n * console.log(json.a); // 1\n * ```\n */\nexport function parseJson<T extends Dictionary>(content: string): T {\n  try {\n    return JSON.parse(content);\n  }\n  catch (err) {\n    logger.error('parseJson', 'invalid_json', err);\n    throw new Error('invalid_json', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Stringify json object.\n *\n * @param data - json object\n * @returns json string\n * @example\n * ```typescript\n * const json = jsonStringify({a:1, b:2});\n * console.log(json); // '{\"a\":1,\"b\":2}'\n * ```\n */\nexport function jsonStringify<T extends Dictionary>(data: T): string {\n  try {\n    return JSON.stringify(data);\n  }\n  catch (err) {\n    logger.error('jsonStringify', 'stringify_failed', err);\n    throw new Error('stringify_failed', {cause: (err as Error).cause});\n  }\n}\n", "import {logger} from './common';\nimport {parseJson} from './json';\nimport {readFile, readFileSync} from './read-file';\n\nimport type {Dictionary, MaybePromise} from '@alwatr/type-helper';\n\n/**\n * Enhanced read json file (async).\n *\n * @param path - file path\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json');\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string): Promise<T>;\n/**\n * Enhanced read json file (sync).\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = readJson('./file.json', true);\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync: true): T;\n/**\n * Enhanced read json file.\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json', sync);\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync: boolean): MaybePromise<T>;\n/**\n * Enhanced read json file.\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json');\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync = false): MaybePromise<T> {\n  logger.logMethodArgs?.('readJson', {path: path.slice(-32), sync});\n  if (sync === true) {\n    return parseJson<T>(readFileSync(path));\n  }\n  else {\n    return readFile(path).then((content) => parseJson<T>(content));\n  }\n}\n", "import {flatString} from '@alwatr/flat-string';\n\nimport {logger} from './common';\nimport {jsonStringify} from './json';\nimport {writeFile, writeFileSync} from './write-file';\n\nimport type {Dictionary, MaybePromise} from '@alwatr/type-helper';\n\n/**\n * Enhanced write json file (Asynchronous).\n *\n * @param path - file path\n * @param data - json object\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 });\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync?: false): Promise<void>;\n/**\n * Enhanced write json file (Synchronous).\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * writeJsonFile('./file.json', { a:1, b:2, c:3 }, true);\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync: true): void;\n/**\n * Enhanced write json file.\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 }, sync);\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync: boolean): MaybePromise<void>;\n/**\n * Enhanced write json file.\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 });\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync = false): MaybePromise<void> {\n  logger.logMethodArgs?.('writeJson', '...' + path.slice(-32));\n  const content = flatString(jsonStringify(data));\n  return sync === true ? writeFileSync(path, content) : writeFile(path, content);\n}\n", "import {open} from 'node:fs/promises';\n\nimport {logger} from './common';\n\n/**\n * Make empty file.\n *\n * @param path - file path\n *\n * @example\n * ```ts\n * await makeFile('./file.txt');\n * ```\n */\nexport async function makeEmptyFile(path: string): Promise<void> {\n  logger.logMethodArgs?.('makeEmptyFile', '...' + path.slice(-32));\n  return (await open(path, 'w')).close();\n}\n"],
+  "mappings": ";yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,+CAAAE,EAAA,aAAAC,EAAA,iBAAAC,EAAA,aAAAC,EAAA,wDAAAC,EAAA,kBAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAT,GCAA,IAAAU,EAAyB,+BACzBC,EAA4B,0BAIfC,KAAS,iBAAc,kBAAmB,cAAmB,EAE7DC,EAAa,IAAI,aCP9B,IAAAC,EAA4C,cAC5CC,EAAoC,uBAEpCC,EAAyB,+BAclB,SAASC,EAAaC,EAAsB,CACjDC,EAAO,gBAAgB,eAAgB,MAAQD,EAAK,MAAM,GAAG,CAAC,EAE9D,GAAI,CACF,SAAO,iBAAW,EAAAE,cAAcF,EAAM,CAAC,SAAU,QAAS,KAAM,GAAG,CAAC,CAAC,CACvE,OACOG,EAAK,CACV,MAAAF,EAAO,MAAM,eAAgB,mBAAoB,CAAC,KAAAD,CAAI,EAAGG,CAAG,EACtD,IAAI,MAAM,mBAAoB,CAAC,MAAQA,EAAc,KAAK,CAAC,CACnE,CACF,CAcO,SAASC,EAASJ,EAA+B,CACtD,OAAAC,EAAO,gBAAgB,WAAY,MAAQD,EAAK,MAAM,GAAG,CAAC,EAEnDK,EAAW,KAAKL,EAAM,SAAY,CACvC,GAAI,CACF,SAAO,cAAW,QAAM,EAAAM,UAAUN,EAAM,CAAC,SAAU,QAAS,KAAM,GAAG,CAAC,CAAC,CACzE,OACOG,EAAK,CACV,MAAAF,EAAO,MAAM,WAAY,mBAAoB,CAAC,KAAAD,CAAI,EAAGG,CAAG,EAClD,IAAI,MAAM,mBAAoB,CAAC,MAAQA,EAAc,KAAK,CAAC,CACnE,CACF,CAAC,CACH,CCrDA,IAAAI,EAAiF,cACjFC,EAAqD,uBACrDC,EAAsB,gBAmBf,SAASC,EAAcC,EAAcC,EAAuB,CACjEC,EAAO,gBAAgB,gBAAiB,MAAQF,EAAK,MAAM,GAAG,CAAC,EAC/D,GAAI,CACF,IAAMG,KAAa,cAAWH,CAAI,EAClC,GAAI,CAACG,EAAY,CACf,IAAMC,KAAM,WAAQJ,CAAI,KACnB,cAAWI,CAAG,MACjB,aAAUA,EAAK,CAAC,UAAW,EAAI,CAAC,CAEpC,IACA,EAAAC,eAAeL,EAAO,OAAQC,EAAS,CAAC,SAAU,QAAS,KAAM,GAAG,CAAC,EACjEE,MACF,cAAWH,EAAMA,EAAO,MAAM,KAEhC,cAAWA,EAAO,OAAQA,CAAI,EAC9BE,EAAO,WAAW,wBAAyB,MAAQF,EAAK,MAAM,GAAG,CAAC,CACpE,OACOM,EAAK,CACV,MAAAJ,EAAO,MAAM,gBAAiB,oBAAqB,CAAC,KAAAF,CAAI,EAAGM,CAAG,EACxD,IAAI,MAAM,oBAAqB,CAAC,MAAQA,EAAc,KAAK,CAAC,CACpE,CACF,CAiBO,SAASC,EAAUP,EAAcC,EAAgC,CACtE,OAAAC,EAAO,gBAAgB,YAAa,MAAQF,EAAK,MAAM,GAAG,CAAC,EACpDQ,EAAW,KAAKR,EAAM,SAAY,CACvC,GAAI,CACFE,EAAO,WAAW,kBAAmB,MAAQF,EAAK,MAAM,GAAG,CAAC,EAC5D,IAAMG,KAAa,cAAWH,CAAI,EAClC,GAAI,CAACG,EAAY,CACf,IAAMC,KAAM,WAAQJ,CAAI,KACnB,cAAWI,CAAG,GACjB,QAAM,SAAMA,EAAK,CAAC,UAAW,EAAI,CAAC,CAEtC,CACA,QAAM,EAAAK,WAAWT,EAAO,OAAQC,EAAS,CAAC,SAAU,QAAS,KAAM,GAAG,CAAC,EACnEE,GACF,QAAM,UAAOH,EAAMA,EAAO,MAAM,EAElC,QAAM,UAAOA,EAAO,OAAQA,CAAI,EAChCE,EAAO,WAAW,oBAAqB,MAAQF,EAAK,MAAM,GAAG,CAAC,CAChE,OACOM,EAAK,CACV,MAAAJ,EAAO,MAAM,YAAa,oBAAqB,CAAC,KAAAF,CAAI,EAAGM,CAAG,EACpD,IAAI,MAAM,oBAAqB,CAAC,MAAQA,EAAc,KAAK,CAAC,CACpE,CACF,CAAC,CACH,CCpEO,SAASI,EAAgCC,EAAoB,CAClE,GAAI,CACF,OAAO,KAAK,MAAMA,CAAO,CAC3B,OACOC,EAAK,CACV,MAAAC,EAAO,MAAM,YAAa,eAAgBD,CAAG,EACvC,IAAI,MAAM,eAAgB,CAAC,MAAQA,EAAc,KAAK,CAAC,CAC/D,CACF,CAaO,SAASE,EAAoCC,EAAiB,CACnE,GAAI,CACF,OAAO,KAAK,UAAUA,CAAI,CAC5B,OACOH,EAAK,CACV,MAAAC,EAAO,MAAM,gBAAiB,mBAAoBD,CAAG,EAC/C,IAAI,MAAM,mBAAoB,CAAC,MAAQA,EAAc,KAAK,CAAC,CACnE,CACF,CCQO,SAASI,EAA+BC,EAAcC,EAAO,GAAwB,CAE1F,OADAC,EAAO,gBAAgB,WAAY,CAAC,KAAMF,EAAK,MAAM,GAAG,EAAG,KAAAC,CAAI,CAAC,EAC5DA,IAAS,GACJE,EAAaC,EAAaJ,CAAI,CAAC,EAG/BK,EAASL,CAAI,EAAE,KAAMM,GAAYH,EAAaG,CAAO,CAAC,CAEjE,CC5DA,IAAAC,EAAyB,+BAsDlB,SAASC,EAAgCC,EAAcC,EAASC,EAAO,GAA2B,CACvGC,EAAO,gBAAgB,YAAa,MAAQH,EAAK,MAAM,GAAG,CAAC,EAC3D,IAAMI,KAAU,cAAWC,EAAcJ,CAAI,CAAC,EAC9C,OAAOC,IAAS,GAAOI,EAAcN,EAAMI,CAAO,EAAIG,EAAUP,EAAMI,CAAO,CAC/E,CC1DA,IAAAI,EAAmB,uBAcnB,eAAsBC,EAAcC,EAA6B,CAC/D,OAAAC,EAAO,gBAAgB,gBAAiB,MAAQD,EAAK,MAAM,GAAG,CAAC,GACvD,QAAM,QAAKA,EAAM,GAAG,GAAG,MAAM,CACvC,CPXA,IAAAE,EAAsB,gBACtBC,EAAyB,cACzBC,EAAqB",
+  "names": ["main_exports", "__export", "makeEmptyFile", "readFile", "readFileSync", "readJson", "writeFile", "writeFileSync", "writeJson", "__toCommonJS", "import_async_queue", "import_logger", "logger", "asyncQueue", "import_node_fs", "import_promises", "import_flat_string", "readFileSync", "path", "logger", "readFileSync_", "err", "readFile", "asyncQueue", "readFile_", "import_node_fs", "import_promises", "import_node_path", "writeFileSync", "path", "content", "logger", "pathExists", "dir", "writeFileSync_", "err", "writeFile", "asyncQueue", "writeFile_", "parseJson", "content", "err", "logger", "jsonStringify", "data", "readJson", "path", "sync", "logger", "parseJson", "readFileSync", "readFile", "content", "import_flat_string", "writeJson", "path", "data", "sync", "logger", "content", "jsonStringify", "writeFileSync", "writeFile", "import_promises", "makeEmptyFile", "path", "logger", "import_node_path", "import_node_fs", "import_promises"]
+}

package/dist/main.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+export * from './read-file';
+export * from './write-file';
+export * from './read-json';
+export * from './write-json';
+export * from './make-file';
+export { resolve } from 'node:path';
+export { existsSync } from 'node:fs';
+export { unlink } from 'node:fs/promises';
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AACnC,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/main.mjs

@@ -0,0 +1,3 @@
+/* @alwatr/node-fs v1.0.0-beta.0 */
+import{AsyncQueue as w}from"@alwatr/async-queue";import{definePackage as x}from"@alwatr/logger";var e=x("@alwatr/node-fs","1.0.0-beta.0"),n=new w;import{readFileSync as F}from"fs";import{readFile as _}from"fs/promises";import{flatString as c}from"@alwatr/flat-string";function l(r){e.logMethodArgs?.("readFileSync","..."+r.slice(-32));try{return c(F(r,{encoding:"utf-8",flag:"r"}))}catch(i){throw e.error("readFileSync","read_file_failed",{path:r},i),new Error("read_file_failed",{cause:i.cause})}}function f(r){return e.logMethodArgs?.("readFile","..."+r.slice(-32)),n.push(r,async()=>{try{return c(await _(r,{encoding:"utf-8",flag:"r"}))}catch(i){throw e.error("readFile","read_file_failed",{path:r},i),new Error("read_file_failed",{cause:i.cause})}})}import{writeFileSync as S,existsSync as s,mkdirSync as T,renameSync as m}from"fs";import{mkdir as E,rename as d,writeFile as J}from"fs/promises";import{dirname as g}from"path";function y(r,i){e.logMethodArgs?.("writeFileSync","..."+r.slice(-32));try{let o=s(r);if(!o){let t=g(r);s(t)||T(t,{recursive:!0})}S(r+".tmp",i,{encoding:"utf-8",flag:"w"}),o&&m(r,r+".bak"),m(r+".tmp",r),e.logOther?.("writeFileSync success","..."+r.slice(-32))}catch(o){throw e.error("writeFileSync","write_file_failed",{path:r},o),new Error("write_file_failed",{cause:o.cause})}}function u(r,i){return e.logMethodArgs?.("writeFile","..."+r.slice(-32)),n.push(r,async()=>{try{e.logOther?.("writeFile start","..."+r.slice(-32));let o=s(r);if(!o){let t=g(r);s(t)||await E(t,{recursive:!0})}await J(r+".tmp",i,{encoding:"utf-8",flag:"w"}),o&&await d(r,r+".bak"),await d(r+".tmp",r),e.logOther?.("writeFile success","..."+r.slice(-32))}catch(o){throw e.error("writeFile","write_file_failed",{path:r},o),new Error("write_file_failed",{cause:o.cause})}})}function a(r){try{return JSON.parse(r)}catch(i){throw e.error("parseJson","invalid_json",i),new Error("invalid_json",{cause:i.cause})}}function p(r){try{return JSON.stringify(r)}catch(i){throw e.error("jsonStringify","stringify_failed",i),new Error("stringify_failed",{cause:i.cause})}}function L(r,i=!1){return e.logMethodArgs?.("readJson",{path:r.slice(-32),sync:i}),i===!0?a(l(r)):f(r).then(o=>a(o))}import{flatString as v}from"@alwatr/flat-string";function Y(r,i,o=!1){e.logMethodArgs?.("writeJson","..."+r.slice(-32));let t=v(p(i));return o===!0?y(r,t):u(r,t)}import{open as D}from"fs/promises";async function er(r){return e.logMethodArgs?.("makeEmptyFile","..."+r.slice(-32)),(await D(r,"w")).close()}import{resolve as fr}from"path";import{existsSync as dr}from"fs";import{unlink as yr}from"fs/promises";export{dr as existsSync,er as makeEmptyFile,f as readFile,l as readFileSync,L as readJson,fr as resolve,yr as unlink,u as writeFile,y as writeFileSync,Y as writeJson};
+//# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/common.ts", "../src/read-file.ts", "../src/write-file.ts", "../src/json.ts", "../src/read-json.ts", "../src/write-json.ts", "../src/make-file.ts", "../src/main.ts"],
+  "sourcesContent": ["import {AsyncQueue} from '@alwatr/async-queue';\nimport {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport const logger = definePackage('@alwatr/node-fs', __package_version__);\n\nexport const asyncQueue = new AsyncQueue();\n", "import {readFileSync as readFileSync_} from 'node:fs';\nimport {readFile as readFile_} from 'node:fs/promises';\n\nimport {flatString} from '@alwatr/flat-string';\n\nimport {asyncQueue, logger} from './common';\n\n/**\n * Enhanced read File (Synchronous).\n *\n * @param path - file path\n * @returns file content\n * @example\n * ```typescript\n * const fileContent = readFileSync('./file.txt', sync);\n * ```\n */\nexport function readFileSync(path: string): string {\n  logger.logMethodArgs?.('readFileSync', '...' + path.slice(-32));\n  // if (!existsSync(path)) throw new Error('file_not_found');\n  try {\n    return flatString(readFileSync_(path, {encoding: 'utf-8', flag: 'r'}));\n  }\n  catch (err) {\n    logger.error('readFileSync', 'read_file_failed', {path}, err);\n    throw new Error('read_file_failed', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Enhanced read File (Asynchronous).\n *\n * - If writing queue is running for target path, it will wait for it to finish.\n *\n * @param path - file path\n * @returns file content\n * @example\n * ```typescript\n * const fileContent = await readFile('./file.txt', sync);\n * ```\n */\nexport function readFile(path: string): Promise<string> {\n  logger.logMethodArgs?.('readFile', '...' + path.slice(-32));\n  // if (!existsSync(path)) throw new Error('file_not_found');\n  return asyncQueue.push(path, async () => {\n    try {\n      return flatString(await readFile_(path, {encoding: 'utf-8', flag: 'r'}));\n    }\n    catch (err) {\n      logger.error('readFile', 'read_file_failed', {path}, err);\n      throw new Error('read_file_failed', {cause: (err as Error).cause});\n    }\n  });\n}\n", "import {writeFileSync as writeFileSync_, existsSync, mkdirSync, renameSync} from 'node:fs';\nimport {mkdir, rename, writeFile as writeFile_} from 'node:fs/promises';\nimport {dirname} from 'node:path';\n\nimport {asyncQueue, logger} from './common';\n\n/**\n * Enhanced write file (Synchronous).\n *\n * - If directory not exists, create it recursively.\n * - Write file to `path.tmp` before write success.\n * - If file exists, renamed (keep) to `path.bak`.\n * - If write failed, original file will not be changed.\n *\n * @param path - file path\n * @param content - file content\n * @example\n * ```typescript\n * writeFileSync('./file.txt', 'Hello World!');\n * ```\n */\nexport function writeFileSync(path: string, content: string): void {\n  logger.logMethodArgs?.('writeFileSync', '...' + path.slice(-32));\n  try {\n    const pathExists = existsSync(path);\n    if (!pathExists) {\n      const dir = dirname(path);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, {recursive: true});\n      }\n    }\n    writeFileSync_(path + '.tmp', content, {encoding: 'utf-8', flag: 'w'});\n    if (pathExists) {\n      renameSync(path, path + '.bak');\n    }\n    renameSync(path + '.tmp', path);\n    logger.logOther?.('writeFileSync success', '...' + path.slice(-32));\n  }\n  catch (err) {\n    logger.error('writeFileSync', 'write_file_failed', {path}, err);\n    throw new Error('write_file_failed', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Enhanced write file (Asynchronous).\n *\n * - If directory not exists, create it recursively.\n * - Write file to `path.tmp` before write success.\n * - If file exists, renamed (keep) to `path.bak`.\n * - If write failed, original file will not be changed.\n *\n * @param path - file path\n * @param content - file content\n * @example\n * ```typescript\n * await writeFile('./file.txt', 'Hello World!');\n * ```\n */\nexport function writeFile(path: string, content: string): Promise<void> {\n  logger.logMethodArgs?.('writeFile', '...' + path.slice(-32));\n  return asyncQueue.push(path, async () => {\n    try {\n      logger.logOther?.('writeFile start', '...' + path.slice(-32));\n      const pathExists = existsSync(path);\n      if (!pathExists) {\n        const dir = dirname(path);\n        if (!existsSync(dir)) {\n          await mkdir(dir, {recursive: true});\n        }\n      }\n      await writeFile_(path + '.tmp', content, {encoding: 'utf-8', flag: 'w'});\n      if (pathExists) {\n        await rename(path, path + '.bak');\n      }\n      await rename(path + '.tmp', path);\n      logger.logOther?.('writeFile success', '...' + path.slice(-32));\n    }\n    catch (err) {\n      logger.error('writeFile', 'write_file_failed', {path}, err);\n      throw new Error('write_file_failed', {cause: (err as Error).cause});\n    }\n  });\n}\n", "import {logger} from './common';\n\nimport type { Dictionary } from '@alwatr/type-helper';\n\n/**\n * Parse json string.\n *\n * @param content - json string\n * @returns json object\n * @example\n * ```typescript\n * const json = parseJson('{\"a\":1,\"b\":2}');\n * console.log(json.a); // 1\n * ```\n */\nexport function parseJson<T extends Dictionary>(content: string): T {\n  try {\n    return JSON.parse(content);\n  }\n  catch (err) {\n    logger.error('parseJson', 'invalid_json', err);\n    throw new Error('invalid_json', {cause: (err as Error).cause});\n  }\n}\n\n/**\n * Stringify json object.\n *\n * @param data - json object\n * @returns json string\n * @example\n * ```typescript\n * const json = jsonStringify({a:1, b:2});\n * console.log(json); // '{\"a\":1,\"b\":2}'\n * ```\n */\nexport function jsonStringify<T extends Dictionary>(data: T): string {\n  try {\n    return JSON.stringify(data);\n  }\n  catch (err) {\n    logger.error('jsonStringify', 'stringify_failed', err);\n    throw new Error('stringify_failed', {cause: (err as Error).cause});\n  }\n}\n", "import {logger} from './common';\nimport {parseJson} from './json';\nimport {readFile, readFileSync} from './read-file';\n\nimport type {Dictionary, MaybePromise} from '@alwatr/type-helper';\n\n/**\n * Enhanced read json file (async).\n *\n * @param path - file path\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json');\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string): Promise<T>;\n/**\n * Enhanced read json file (sync).\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = readJson('./file.json', true);\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync: true): T;\n/**\n * Enhanced read json file.\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json', sync);\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync: boolean): MaybePromise<T>;\n/**\n * Enhanced read json file.\n *\n * @param path - file path\n * @param sync - sync mode\n * @returns json object\n * @example\n * ```typescript\n * const fileContent = await readJson('./file.json');\n * ```\n */\nexport function readJson<T extends Dictionary>(path: string, sync = false): MaybePromise<T> {\n  logger.logMethodArgs?.('readJson', {path: path.slice(-32), sync});\n  if (sync === true) {\n    return parseJson<T>(readFileSync(path));\n  }\n  else {\n    return readFile(path).then((content) => parseJson<T>(content));\n  }\n}\n", "import {flatString} from '@alwatr/flat-string';\n\nimport {logger} from './common';\nimport {jsonStringify} from './json';\nimport {writeFile, writeFileSync} from './write-file';\n\nimport type {Dictionary, MaybePromise} from '@alwatr/type-helper';\n\n/**\n * Enhanced write json file (Asynchronous).\n *\n * @param path - file path\n * @param data - json object\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 });\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync?: false): Promise<void>;\n/**\n * Enhanced write json file (Synchronous).\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * writeJsonFile('./file.json', { a:1, b:2, c:3 }, true);\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync: true): void;\n/**\n * Enhanced write json file.\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 }, sync);\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync: boolean): MaybePromise<void>;\n/**\n * Enhanced write json file.\n *\n * @param path - file path\n * @param data - json object\n * @param sync - sync mode\n * @example\n * ```typescript\n * await writeJsonFile('./file.json', { a:1, b:2, c:3 });\n * ```\n */\nexport function writeJson<T extends Dictionary>(path: string, data: T, sync = false): MaybePromise<void> {\n  logger.logMethodArgs?.('writeJson', '...' + path.slice(-32));\n  const content = flatString(jsonStringify(data));\n  return sync === true ? writeFileSync(path, content) : writeFile(path, content);\n}\n", "import {open} from 'node:fs/promises';\n\nimport {logger} from './common';\n\n/**\n * Make empty file.\n *\n * @param path - file path\n *\n * @example\n * ```ts\n * await makeFile('./file.txt');\n * ```\n */\nexport async function makeEmptyFile(path: string): Promise<void> {\n  logger.logMethodArgs?.('makeEmptyFile', '...' + path.slice(-32));\n  return (await open(path, 'w')).close();\n}\n", "export * from './read-file';\nexport * from './write-file';\nexport * from './read-json';\nexport * from './write-json';\nexport * from './make-file';\n\nexport {resolve} from 'node:path';\nexport {existsSync} from 'node:fs';\nexport {unlink} from 'node:fs/promises';\n"],
+  "mappings": "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",
+  "names": ["AsyncQueue", "definePackage", "logger", "asyncQueue", "readFileSync_", "readFile_", "flatString", "readFileSync", "path", "logger", "err", "readFile", "asyncQueue", "writeFileSync_", "existsSync", "mkdirSync", "renameSync", "mkdir", "rename", "writeFile_", "dirname", "writeFileSync", "path", "content", "logger", "pathExists", "dir", "err", "writeFile", "asyncQueue", "parseJson", "content", "err", "logger", "jsonStringify", "data", "readJson", "path", "sync", "logger", "parseJson", "readFileSync", "readFile", "content", "flatString", "writeJson", "path", "data", "sync", "logger", "content", "jsonStringify", "writeFileSync", "writeFile", "open", "makeEmptyFile", "path", "logger", "resolve", "existsSync", "unlink"]
+}

package/dist/make-file.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Make empty file.
+ *
+ * @param path - file path
+ *
+ * @example
+ * ```ts
+ * await makeFile('./file.txt');
+ * ```
+ */
+export declare function makeEmptyFile(path: string): Promise<void>;
+//# sourceMappingURL=make-file.d.ts.map

package/dist/make-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-file.d.ts","sourceRoot":"","sources":["../src/make-file.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D"}

package/dist/read-file.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Enhanced read File (Synchronous).
+ *
+ * @param path - file path
+ * @returns file content
+ * @example
+ * ```typescript
+ * const fileContent = readFileSync('./file.txt', sync);
+ * ```
+ */
+export declare function readFileSync(path: string): string;
+/**
+ * Enhanced read File (Asynchronous).
+ *
+ * - If writing queue is running for target path, it will wait for it to finish.
+ *
+ * @param path - file path
+ * @returns file content
+ * @example
+ * ```typescript
+ * const fileContent = await readFile('./file.txt', sync);
+ * ```
+ */
+export declare function readFile(path: string): Promise<string>;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../src/read-file.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtD"}

package/dist/read-json.d.ts

@@ -0,0 +1,37 @@
+import type { Dictionary, MaybePromise } from '@alwatr/type-helper';
+/**
+ * Enhanced read json file (async).
+ *
+ * @param path - file path
+ * @returns json object
+ * @example
+ * ```typescript
+ * const fileContent = await readJson('./file.json');
+ * ```
+ */
+export declare function readJson<T extends Dictionary>(path: string): Promise<T>;
+/**
+ * Enhanced read json file (sync).
+ *
+ * @param path - file path
+ * @param sync - sync mode
+ * @returns json object
+ * @example
+ * ```typescript
+ * const fileContent = readJson('./file.json', true);
+ * ```
+ */
+export declare function readJson<T extends Dictionary>(path: string, sync: true): T;
+/**
+ * Enhanced read json file.
+ *
+ * @param path - file path
+ * @param sync - sync mode
+ * @returns json object
+ * @example
+ * ```typescript
+ * const fileContent = await readJson('./file.json', sync);
+ * ```
+ */
+export declare function readJson<T extends Dictionary>(path: string, sync: boolean): MaybePromise<T>;
+//# sourceMappingURL=read-json.d.ts.map

package/dist/read-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-json.d.ts","sourceRoot":"","sources":["../src/read-json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACzE;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;AAC5E;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC"}

package/dist/write-file.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Enhanced write file (Synchronous).
+ *
+ * - If directory not exists, create it recursively.
+ * - Write file to `path.tmp` before write success.
+ * - If file exists, renamed (keep) to `path.bak`.
+ * - If write failed, original file will not be changed.
+ *
+ * @param path - file path
+ * @param content - file content
+ * @example
+ * ```typescript
+ * writeFileSync('./file.txt', 'Hello World!');
+ * ```
+ */
+export declare function writeFileSync(path: string, content: string): void;
+/**
+ * Enhanced write file (Asynchronous).
+ *
+ * - If directory not exists, create it recursively.
+ * - Write file to `path.tmp` before write success.
+ * - If file exists, renamed (keep) to `path.bak`.
+ * - If write failed, original file will not be changed.
+ *
+ * @param path - file path
+ * @param content - file content
+ * @example
+ * ```typescript
+ * await writeFile('./file.txt', 'Hello World!');
+ * ```
+ */
+export declare function writeFile(path: string, content: string): Promise<void>;
+//# sourceMappingURL=write-file.d.ts.map

package/dist/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../src/write-file.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAqBjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBtE"}

package/dist/write-json.d.ts

@@ -0,0 +1,37 @@
+import type { Dictionary, MaybePromise } from '@alwatr/type-helper';
+/**
+ * Enhanced write json file (Asynchronous).
+ *
+ * @param path - file path
+ * @param data - json object
+ * @example
+ * ```typescript
+ * await writeJsonFile('./file.json', { a:1, b:2, c:3 });
+ * ```
+ */
+export declare function writeJson<T extends Dictionary>(path: string, data: T, sync?: false): Promise<void>;
+/**
+ * Enhanced write json file (Synchronous).
+ *
+ * @param path - file path
+ * @param data - json object
+ * @param sync - sync mode
+ * @example
+ * ```typescript
+ * writeJsonFile('./file.json', { a:1, b:2, c:3 }, true);
+ * ```
+ */
+export declare function writeJson<T extends Dictionary>(path: string, data: T, sync: true): void;
+/**
+ * Enhanced write json file.
+ *
+ * @param path - file path
+ * @param data - json object
+ * @param sync - sync mode
+ * @example
+ * ```typescript
+ * await writeJsonFile('./file.json', { a:1, b:2, c:3 }, sync);
+ * ```
+ */
+export declare function writeJson<T extends Dictionary>(path: string, data: T, sync: boolean): MaybePromise<void>;
+//# sourceMappingURL=write-json.d.ts.map

package/dist/write-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-json.d.ts","sourceRoot":"","sources":["../src/write-json.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACpG;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;AACzF;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@alwatr/node-fs",
+  "version": "1.0.0-beta.0",
+  "description": "Enhanced file system operations in Node.js with asynchronous queue to prevent parallel writes.",
+  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
+  "keywords": [
+    "node-fs",
+    "fs",
+    "file",
+    "filesystem",
+    "readFile",
+    "writeFile",
+    "readJson",
+    "writeJson",
+    "JSON",
+    "async",
+    "queue",
+    "cross-platform",
+    "ECMAScript",
+    "typescript",
+    "javascript",
+    "node",
+    "nodejs",
+    "esm",
+    "module",
+    "utility",
+    "util",
+    "utils",
+    "nanolib",
+    "alwatr"
+  ],
+  "type": "module",
+  "main": "./dist/main.cjs",
+  "module": "./dist/main.mjs",
+  "types": "./dist/main.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/main.mjs",
+      "require": "./dist/main.cjs",
+      "types": "./dist/main.d.ts"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "**/*.{js,mjs,cjs,map,d.ts,html,md}",
+    "!demo/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alwatr/nanolib",
+    "directory": "packages/node-fs"
+  },
+  "homepage": "https://github.com/Alwatr/nanolib/tree/next/packages/node-fs#readme",
+  "bugs": {
+    "url": "https://github.com/Alwatr/nanolib/issues"
+  },
+  "prettier": "@alwatr/prettier-config",
+  "scripts": {
+    "b": "yarn run build",
+    "w": "yarn run watch",
+    "c": "yarn run clean",
+    "cb": "yarn run clean && yarn run build",
+    "d": "yarn run build:es && yarn node --enable-source-maps --trace-warnings",
+    "build": "yarn run build:ts & yarn run build:es",
+    "build:es": "nano-build --preset=module",
+    "build:ts": "tsc --build",
+    "watch": "yarn run watch:ts & yarn run watch:es",
+    "watch:es": "yarn run build:es --watch",
+    "watch:ts": "yarn run build:ts --watch --preserveWatchOutput",
+    "clean": "rm -rfv dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@alwatr/async-queue": "^1.1.0",
+    "@alwatr/flat-string": "^1.0.12",
+    "@alwatr/logger": "^3.2.1"
+  },
+  "devDependencies": {
+    "@alwatr/nano-build": "^1.3.0",
+    "@alwatr/prettier-config": "^1.0.4",
+    "@alwatr/tsconfig-base": "^1.1.0",
+    "@alwatr/type-helper": "^1.0.3",
+    "@types/node": "^20.10.7",
+    "typescript": "^5.3.3"
+  },
+  "gitHead": "51edc127640bdfd74834e98d2d09de6f16564a8d"
+}