xjs-node 1.0.2 → 1.0.3

package/dist/prcs/http/http-resolver-context.d.ts

@@ -1,4 +1,7 @@
-import { ClientOption, HttpResponse, IHttpClient, RequestOption } from "./i-http-client";
+/// <reference types="node" />
+/// <reference types="node" />
+import { OutgoingHttpHeaders, IncomingHttpHeaders } from "http";
+import { ClientOption, IHttpClient } from "./i-http-client";
 import { Loggable } from "xjs-common";
 export declare const s_clientMode: {
     nodejs: {
@@ -25,29 +28,70 @@ export declare class HttpResolverContext implements IHttpClient {
     private _cookies?;
     get clientMode(): string;
     constructor(cmv: number, op?: ClientOption, _l?: Loggable);
-    /**
-     * request GET to the url.
-     * @param url target url.
-     * @param op.headers http headers.
-     * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
-     * @param op.downloadPath {@link RequestOption.downloadPath}
-     * @param op.timeout {@link RequestOption.timeout}
-     * @returns string encoded by utf-8 as response payload.
-     */
-    get(url: string, op?: RequestOption & {
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+    } & {
         outerRedirectCount?: number;
-    }): Promise<HttpResponse>;
-    /**
-     * request POST to the url.
-     * @param url target url.
-     * @param payload request payload. if this is an object, it is treated as json.
-     * @param op.headers http headers.
-     * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
-     * @param op.downloadPath {@link RequestOption.downloadPath}
-     * @param op.timeout {@link RequestOption.timeout}
-     * @returns string encoded by utf-8 as response payload.
-     */
-    post(url: string, payload: any, op?: RequestOption): Promise<HttpResponse>;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "string";
+    } & {
+        outerRedirectCount?: number;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "buffer";
+    } & {
+        outerRedirectCount?: number;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: Buffer;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "string";
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "buffer";
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: Buffer;
+    }>;
     private createProxyAgent;
     private getIn;
     private postIn;

package/dist/prcs/http/http-resolver-context.js

@@ -104,6 +104,7 @@ class HttpResolverContext {
      * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
      * @param op.downloadPath {@link RequestOption.downloadPath}
      * @param op.timeout {@link RequestOption.timeout}
+     * @param op.responseType {@link RequestOption.responseType}
      * @returns string encoded by utf-8 as response payload.
      */
     async get(url, op) {
@@ -121,6 +122,7 @@ class HttpResolverContext {
      * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
      * @param op.downloadPath {@link RequestOption.downloadPath}
      * @param op.timeout {@link RequestOption.timeout}
+     * @param op.responseType {@link RequestOption.responseType}
      * @returns string encoded by utf-8 as response payload.
      */
     async post(url, payload, op) {
@@ -238,9 +240,9 @@ class HttpResolverContext {
                     retBuf = zlib.gunzipSync(retBuf);
                 else if (contentEncofing == "br")
                     retBuf = zlib.brotliDecompressSync(retBuf);
-                const data = retBuf.toString("utf8");
+                const data = rc.responseType === "buffer" ? retBuf : retBuf.toString("utf8");
                 if (sc !== 2) {
-                    if (data.trim())
+                    if (xjs_common_1.UType.isString(data) && data.trim())
                         this.warn(data);
                     reject(new xjs_common_1.XjsErr(s_errCode, `Https received a error status ${res.statusCode}`));
                 }

package/dist/prcs/http/http-resolver.d.ts

@@ -1,6 +1,9 @@
+/// <reference types="node" />
+/// <reference types="node" />
 import { Loggable } from "xjs-common";
 import { HttpResolverContext } from "./http-resolver-context";
-import { ClientOption, HttpResponse, IHttpClient, RequestOption } from "./i-http-client";
+import { ClientOption, IHttpClient } from "./i-http-client";
+import { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
 export interface ClientMode {
     id: number;
     cipherOrder: number[];
@@ -28,9 +31,69 @@ export declare class HttpResolver implements IHttpClient {
      * @returns a http client as new context.
      */
     newContext(op?: ClientOption): HttpResolverContext;
-    get(url: string, op?: RequestOption & ClientOption & {
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+    } & ClientOption & {
         redirectAsNewRequest?: boolean;
-    }): Promise<HttpResponse>;
-    post(url: string, payload: any, op?: RequestOption & ClientOption): Promise<HttpResponse>;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "string";
+    } & ClientOption & {
+        redirectAsNewRequest?: boolean;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    get(url: string, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "buffer";
+    } & ClientOption & {
+        redirectAsNewRequest?: boolean;
+    }): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: Buffer;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+    } & ClientOption): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "string";
+    } & ClientOption): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: string;
+    }>;
+    post(url: string, payload: any, op?: {
+        headers?: OutgoingHttpHeaders;
+        ignoreQuery?: boolean;
+        downloadPath?: string;
+        timeout?: number;
+        responseType: "buffer";
+    } & ClientOption): Promise<{
+        headers?: IncomingHttpHeaders;
+        payload: Buffer;
+    }>;
     private fixCmv;
 }

package/dist/prcs/http/i-http-client.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
 import { ClientMode, ProxyConfig } from "./http-resolver";
 export interface ClientOption {
@@ -20,6 +21,10 @@ export interface RequestOption {
      * timeout milliseconds to wait for socket inactivity. default is infinity.
      */
     timeout?: number;
+    /**
+     * type of response payload. default is string (utf-8).
+     */
+    responseType?: "string" | "buffer";
 }
 export interface HttpResponse {
     /**
@@ -27,9 +32,9 @@ export interface HttpResponse {
      */
     headers?: IncomingHttpHeaders;
     /**
-     * string encoded by utf-8 as response payload.
+     * response payload which has a type depends on {@link RequestOption.responseType}.
      */
-    payload?: string;
+    payload?: string | Buffer;
 }
 export interface IHttpClient {
     /**
@@ -41,6 +46,7 @@ export interface IHttpClient {
      * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
      * @param op.downloadPath {@link RequestOption.downloadPath}
      * @param op.timeout {@link RequestOption.timeout}
+     * @param op.responseType {@link RequestOption.responseType}
      * @param op.redirectAsNewRequest handle redirect as new request. this may be efficient when using proxy which is implemented reverse proxy.
      * @returns http response. {@link HttpResponse}
      */
@@ -57,6 +63,7 @@ export interface IHttpClient {
      * @param op.ignoreQuery {@link RequestOption.ignoreQuery}
      * @param op.downloadPath {@link RequestOption.downloadPath}
      * @param op.timeout {@link RequestOption.timeout}
+     * @param op.responseType {@link RequestOption.responseType}
      * @returns http response. {@link HttpResponse}
      */
     post(url: string, payload: any, op?: RequestOption & ClientOption): Promise<HttpResponse>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xjs-node",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "library modules for nodejs + typescript that bundled general-purpose implementations.",
   "repository": {
     "type": "git",