xjs-node 2.1.0 → 2.1.2

package/build/func/u-file.d.ts

@@ -12,9 +12,11 @@ export declare namespace UFile {
     function mkdir(p: MaybeArray<string>): boolean;
     function write(p: MaybeArray<string>, c: string): void;
     /**
-     * remove a file. no error if the file to be removed doesn't exist.
+     * remove a file. default is no error if the file to be removed doesn't exist.
+     * @param p path of the file. if passed as an array those are joined.
+     * @param errorIfAbsent raise an error if the file to be removed doesn't exist.
      */
-    function rm(p: MaybeArray<string>): void;
+    function rm(p: MaybeArray<string>, errorIfAbsent?: boolean): void;
     function exists(p: MaybeArray<string>): boolean;
     /**
      * return a file status. if the file of the status doesn't exist, this returns `null`.
@@ -22,6 +24,13 @@ export declare namespace UFile {
     function status(p: MaybeArray<string>): FileStatus;
     function read(p: MaybeArray<string>): Buffer;
     function read(p: MaybeArray<string>, encoding: BufferEncoding): string;
+    /**
+     * read specified file path as a json object.
+     * @param p file path
+     * @param d default value if the file path doesn't exist. default of this is `{}`.
+     * @param encoding encoding used by file reading. default is `utf-8`.
+     */
+    function readAsJson<T>(p: MaybeArray<string>, d?: any, encoding?: BufferEncoding): T;
     function cp(from: MaybeArray<string>, to: MaybeArray<string>): void;
     function mv(from: MaybeArray<string>, to: MaybeArray<string>): void;
     function ls(p: MaybeArray<string>): string[];

package/build/func/u-file.js

@@ -56,12 +56,12 @@ var UFile;
     }
     UFile.write = write;
     /**
-     * remove a file. no error if the file to be removed doesn't exist.
+     * remove a file. default is no error if the file to be removed doesn't exist.
+     * @param p path of the file. if passed as an array those are joined.
+     * @param errorIfAbsent raise an error if the file to be removed doesn't exist.
      */
-    function rm(p) {
-        const pt = (0, u_1.joinPath)(p);
-        if (fs.existsSync(pt))
-            fs.rmSync(pt, { recursive: true });
+    function rm(p, errorIfAbsent) {
+        fs.rmSync((0, u_1.joinPath)(p), { recursive: true, force: !errorIfAbsent });
     }
     UFile.rm = rm;
     function exists(p) {
@@ -83,6 +83,16 @@ var UFile;
         return fs.readFileSync(f, encoding);
     }
     UFile.read = read;
+    /**
+     * read specified file path as a json object.
+     * @param p file path
+     * @param d default value if the file path doesn't exist. default of this is `{}`.
+     * @param encoding encoding used by file reading. default is `utf-8`.
+     */
+    function readAsJson(p, d = {}, encoding = "utf-8") {
+        return UFile.exists(p) ? JSON.parse(UFile.read(p, encoding)) : d;
+    }
+    UFile.readAsJson = readAsJson;
     function cp(from, to) {
         const f = (0, u_1.joinPath)(from), t = (0, u_1.joinPath)(to);
         if (!fs.existsSync(f))

package/build/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./func/u";
 export * from "./func/u-file";
-export { HttpResolver, ClientMode } from "./prcs/http/http-resolver";
-export { s_clientMode } from "./prcs/http/http-resolver-context";
-export { IHttpClient, HttpResponse } from "./prcs/http/i-http-client";
+export { HttpResolver, ClientMode } from "./prcs/http-resolver";
+export { s_clientMode } from "./prcs/http-resolver-context";
+export { HttpClient, HttpResponse } from "./obj/http-client";

package/build/index.js

@@ -17,7 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.s_clientMode = exports.HttpResolver = void 0;
 __exportStar(require("./func/u"), exports);
 __exportStar(require("./func/u-file"), exports);
-var http_resolver_1 = require("./prcs/http/http-resolver");
+var http_resolver_1 = require("./prcs/http-resolver");
 Object.defineProperty(exports, "HttpResolver", { enumerable: true, get: function () { return http_resolver_1.HttpResolver; } });
-var http_resolver_context_1 = require("./prcs/http/http-resolver-context");
+var http_resolver_context_1 = require("./prcs/http-resolver-context");
 Object.defineProperty(exports, "s_clientMode", { enumerable: true, get: function () { return http_resolver_context_1.s_clientMode; } });

package/build/{prcs/http/i-http-client.d.ts → obj/http-client.d.ts}

@@ -1,5 +1,5 @@
 import { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
-import { ClientMode, ProxyConfig } from "./http-resolver";
+import { ClientMode, ProxyConfig } from "../prcs/http-resolver";
 export interface ClientOption {
     /**
      * {@link s_clientMode} that is imitated. default is random between chrome or firefox.
@@ -30,7 +30,7 @@ export interface RequestOption {
      */
     responseType?: "string" | "buffer";
 }
-export interface HttpResponse<T = string | Buffer> {
+export interface HttpResponse<T = string> {
     /**
      * http headers in the response.
      */
@@ -40,7 +40,7 @@ export interface HttpResponse<T = string | Buffer> {
      */
     payload?: T;
 }
-export interface IHttpClient {
+export interface HttpClient {
     /**
      * request GET to the url with new context.
      * @param url target url. (currently https only)

package/build/prcs/{http/http-resolver-context.d.ts → http-resolver-context.d.ts}

@@ -1,4 +1,4 @@
-import { ClientOption, HttpResponse, IHttpClient, RequestOption } from "./i-http-client";
+import { ClientOption, HttpResponse, HttpClient, RequestOption } from "../obj/http-client";
 import { Loggable } from "xjs-common";
 export declare const s_clientMode: {
     nodejs: {
@@ -14,7 +14,7 @@ export declare const s_clientMode: {
         cipherOrder: number[];
     };
 };
-export declare class HttpResolverContext implements IHttpClient {
+export declare class HttpResolverContext implements HttpClient {
     readonly cmv: number;
     private _l;
     private readonly _als;

package/build/prcs/{http/http-resolver-context.js → http-resolver-context.js}

@@ -42,8 +42,8 @@ const url_1 = require("url");
 const https_1 = require("https");
 const http_1 = require("http");
 const async_hooks_1 = require("async_hooks");
-const u_file_1 = require("../../func/u-file");
-const u_1 = require("../../func/u");
+const u_file_1 = require("../func/u-file");
+const u_1 = require("../func/u");
 const xjs_common_1 = require("xjs-common");
 const stream_1 = require("stream");
 exports.s_clientMode = {

package/build/prcs/{http/http-resolver.d.ts → http-resolver.d.ts}

@@ -1,6 +1,6 @@
 import { Loggable } from "xjs-common";
 import { HttpResolverContext } from "./http-resolver-context";
-import { ClientOption, HttpResponse, IHttpClient, RequestOption } from "./i-http-client";
+import { ClientOption, HttpResponse, HttpClient, RequestOption } from "../obj/http-client";
 export interface ClientMode {
     id: number;
     cipherOrder: number[];
@@ -13,7 +13,7 @@ export interface ProxyConfig {
         pass: string;
     };
 }
-export declare class HttpResolver implements IHttpClient {
+export declare class HttpResolver implements HttpClient {
     private _baseCmv;
     private _l;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xjs-node",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "library modules for nodejs + typescript that bundled general-purpose implementations.",
   "repository": {
     "type": "git",
@@ -38,4 +38,4 @@
   "dependencies": {
     "xjs-common": "^13.0.0"
   }
-}
+}