jopijs 0.0.1

package/dist/@core/routeConfig.d.ts

@@ -0,0 +1,48 @@
+import type { JopiMiddleware, JopiPostMiddleware, WebSiteImpl } from "./jopiWebSite.tsx";
+import type { JopiRequest } from "./jopiRequest.tsx";
+import { PriorityLevel } from "jopi-toolkit/jk_tools";
+export declare class RouteConfig {
+    private readonly webSite;
+    private readonly route;
+    constructor(webSite: WebSiteImpl, route: string);
+    readonly onGET: RouteConfig_OnGET;
+    readonly onPOST: RouteConfig_Core;
+    readonly onPUT: RouteConfig_Core;
+    readonly onDELETE: RouteConfig_Core;
+    readonly onHEAD: RouteConfig_Core;
+    readonly onPATCH: RouteConfig_Core;
+    readonly onOPTIONS: RouteConfig_Core;
+    readonly onALL: RouteConfig_Core;
+}
+declare class RouteConfig_Core {
+    protected readonly webSite: WebSiteImpl;
+    protected readonly route: string;
+    protected readonly method: string;
+    constructor(webSite: WebSiteImpl, route: string, method: string);
+    add_middleware(middleware: JopiMiddleware, priority?: PriorityLevel): void;
+    add_postMiddleware(middleware: JopiPostMiddleware, priority?: PriorityLevel): void;
+    add_requiredRole(...roles: string[]): void;
+}
+declare class RouteConfig_OnGET extends RouteConfig_Core {
+    cache_disableAutomaticCache(): void;
+    /**
+     * Define a function which is called when the response is get from the cache.
+     * If a value is returned, then this value is used as the new value,
+     * allowing to replace what comes from the cache.
+     * @param handler
+     */
+    cache_afterGetFromCache(handler: (req: JopiRequest, res: Response) => Promise<Response | undefined | void>): void;
+    /**
+     * Defines a function which can alter the response to save into the cache or avoid cache adding.
+     * If returns a response: this response will be added into the cache.
+     * If returns undefined: will not add the response into the cache.
+     */
+    cache_beforeAddToCache(handler: (req: JopiRequest, res: Response) => Promise<Response | undefined | void>): void;
+    /**
+     * Define a function which is called before checking the cache.
+     * This allows doing some checking, and if needed, it can return
+     * a response and bypass the request cycle.
+     */
+    cache_beforeCheckingCache(handler: (req: JopiRequest) => Promise<Response | undefined | void>): void;
+}
+export {};

package/dist/@core/routeConfig.js

@@ -0,0 +1,102 @@
+import { PriorityLevel } from "jopi-toolkit/jk_tools";
+export class RouteConfig {
+    webSite;
+    route;
+    constructor(webSite, route) {
+        this.webSite = webSite;
+        this.route = route;
+        this.onGET = new RouteConfig_OnGET(this.webSite, this.route, "GET");
+        this.onPOST = new RouteConfig_Core(this.webSite, this.route, "POST");
+        this.onPUT = new RouteConfig_Core(this.webSite, this.route, "PUT");
+        this.onDELETE = new RouteConfig_Core(this.webSite, this.route, "DELETE");
+        this.onHEAD = new RouteConfig_Core(this.webSite, this.route, "HEAD");
+        this.onPATCH = new RouteConfig_Core(this.webSite, this.route, "PATCH");
+        this.onOPTIONS = new RouteConfig_Core(this.webSite, this.route, "OPTIONS");
+        this.onALL = new RouteConfig_Core(this.webSite, this.route, "*");
+    }
+    onGET;
+    onPOST;
+    onPUT;
+    onDELETE;
+    onHEAD;
+    onPATCH;
+    onOPTIONS;
+    onALL;
+}
+class RouteConfig_Core {
+    webSite;
+    route;
+    method;
+    constructor(webSite, route, method) {
+        this.webSite = webSite;
+        this.route = route;
+        this.method = method;
+    }
+    add_middleware(middleware, priority = PriorityLevel.default) {
+        let routeInfos = this.webSite.getRouteInfos(this.method, this.route);
+        if (!routeInfos)
+            return;
+        if (!routeInfos.middlewares)
+            routeInfos.middlewares = [];
+        routeInfos.middlewares.push({ priority, value: middleware });
+    }
+    add_postMiddleware(middleware, priority = PriorityLevel.default) {
+        let routeInfos = this.webSite.getRouteInfos(this.method, this.route);
+        if (!routeInfos)
+            return;
+        if (!routeInfos.postMiddlewares)
+            routeInfos.postMiddlewares = [];
+        routeInfos.postMiddlewares.push({ priority, value: middleware });
+    }
+    add_requiredRole(...roles) {
+        let routeInfos = this.webSite.getRouteInfos(this.method, this.route);
+        if (!routeInfos)
+            return;
+        if (!routeInfos.requiredRoles)
+            routeInfos.requiredRoles = [];
+        routeInfos?.requiredRoles.push(...roles);
+    }
+}
+class RouteConfig_OnGET extends RouteConfig_Core {
+    cache_disableAutomaticCache() {
+        let routeInfos = this.webSite.getRouteInfos("GET", this.route);
+        if (!routeInfos)
+            return;
+        routeInfos.mustEnableAutomaticCache = false;
+    }
+    /**
+     * Define a function which is called when the response is get from the cache.
+     * If a value is returned, then this value is used as the new value,
+     * allowing to replace what comes from the cache.
+     * @param handler
+     */
+    cache_afterGetFromCache(handler) {
+        let routeInfos = this.webSite.getRouteInfos("GET", this.route);
+        if (!routeInfos)
+            return;
+        routeInfos.afterGetFromCache = handler;
+    }
+    /**
+     * Defines a function which can alter the response to save into the cache or avoid cache adding.
+     * If returns a response: this response will be added into the cache.
+     * If returns undefined: will not add the response into the cache.
+     */
+    cache_beforeAddToCache(handler) {
+        let routeInfos = this.webSite.getRouteInfos("GET", this.route);
+        if (!routeInfos)
+            return;
+        routeInfos.beforeAddToCache = handler;
+    }
+    /**
+     * Define a function which is called before checking the cache.
+     * This allows doing some checking, and if needed, it can return
+     * a response and bypass the request cycle.
+     */
+    cache_beforeCheckingCache(handler) {
+        let routeInfos = this.webSite.getRouteInfos("GET", this.route);
+        if (!routeInfos)
+            return;
+        routeInfos.beforeCheckingCache = handler;
+    }
+}
+//# sourceMappingURL=routeConfig.js.map

package/dist/@core/routeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeConfig.js","sourceRoot":"","sources":["../../src/@core/routeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAEpD,MAAM,OAAO,WAAW;IACS;IACA;IAD7B,YAA6B,OAAoB,EACpB,KAAa;QADb,YAAO,GAAP,OAAO,CAAa;QACpB,UAAK,GAAL,KAAK,CAAQ;QAEtC,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IAEe,KAAK,CAAoB;IACzB,MAAM,CAAmB;IACzB,KAAK,CAAmB;IACxB,QAAQ,CAAmB;IAC3B,MAAM,CAAmB;IACzB,OAAO,CAAmB;IAC1B,SAAS,CAAmB;IAC5B,KAAK,CAAmB;CAC3C;AAED,MAAM,gBAAgB;IACa;IACA;IACA;IAF/B,YAA+B,OAAoB,EACpB,KAAa,EACb,MAAc;QAFd,YAAO,GAAP,OAAO,CAAa;QACpB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;IAC7C,CAAC;IAED,cAAc,CAAC,UAA0B,EAAE,WAA0B,aAAa,CAAC,OAAO;QACtF,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,CAAC,UAAU,CAAC,WAAW;YAAE,UAAU,CAAC,WAAW,GAAG,EAAE,CAAC;QACzD,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAC,CAAC,CAAC;IAC/D,CAAC;IAED,kBAAkB,CAAC,UAA8B,EAAE,WAA0B,aAAa,CAAC,OAAO;QAC9F,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,CAAC,UAAU,CAAC,eAAe;YAAE,UAAU,CAAC,eAAe,GAAG,EAAE,CAAC;QACjE,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAC,CAAC,CAAC;IACnE,CAAC;IAED,gBAAgB,CAAC,GAAG,KAAe;QAC/B,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,CAAC,UAAU,CAAC,aAAa;YAAE,UAAU,CAAC,aAAa,GAAG,EAAE,CAAC;QAC7D,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7C,CAAC;CACJ;AAED,MAAM,iBAAkB,SAAQ,gBAAgB;IAC5C,2BAA2B;QACvB,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,UAAU,CAAC,wBAAwB,GAAG,KAAK,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CAAC,OAAkF;QACtG,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,UAAU,CAAC,iBAAiB,GAAG,OAAO,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,OAAkF;QACrG,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,UAAU,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,yBAAyB,CAAC,OAAmE;QACzF,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,UAAU,CAAC,mBAAmB,GAAG,OAAO,CAAC;IAC7C,CAAC;CACJ"}

package/dist/@core/searchParamFilter.d.ts

@@ -0,0 +1,70 @@
+export interface SearchParamFilter {
+    /**
+     * If true, transform the search param value to uppercase.
+     * The default value is false.
+     */
+    toUpperCase?: boolean;
+    /**
+     * If true, transforme the search value to lowercase.
+     * Has priority over toUpperCase.
+     * Default value is true.
+     */
+    toLowerCase?: boolean;
+    /**
+     * If true, then ignore toLowerCase and toUpperCase.
+     * The default value is false.
+     */
+    ignoreCase?: boolean;
+    /**
+     * If true, all values are allowed.
+     * Default is false.
+     */
+    allowAllValues?: boolean;
+    /**
+     * If defined, then limit possible value to this list.
+     * Has priority over allowAllValue.
+     */
+    values?: string[];
+    /**
+     * If true, then we can have the param name without a value.
+     * Default is false.
+     */
+    allowsNameOnly?: boolean;
+    /**
+     * The max number of time this search params can be present.
+     * The default value is 1.
+     */
+    max?: number;
+    /**
+     * If this search param is not present, then add it with this value.
+     */
+    defaultValue?: string;
+    /**
+     * For dev tests.
+     * Allow calling "debugger" when processing this rule.
+     */
+    debug?: boolean;
+}
+export declare enum SortValues {
+    ASC = "asc",
+    DESC = "desc",
+    IGNORE = "ignore"
+}
+export interface FilterOptions {
+    /**
+     * Allow saying how to sort params.
+     * The default value is ASC.
+     */
+    sort?: SortValues;
+    /**
+     * If true, then remove all search params.
+     */
+    removeAll?: boolean;
+}
+export type SearchParamFilterFunction = (url: URL) => void;
+/**
+ * Create an optimized function which will filter a URL search params.
+ */
+export declare function buildSearchParamFilter(options: FilterOptions, params: {
+    [paramName: string]: SearchParamFilter;
+}): SearchParamFilterFunction;

package/dist/@core/searchParamFilter.js

@@ -0,0 +1,212 @@
+export var SortValues;
+(function (SortValues) {
+    // noinspection JSUnusedGlobalSymbols
+    SortValues["ASC"] = "asc";
+    SortValues["DESC"] = "desc";
+    SortValues["IGNORE"] = "ignore";
+})(SortValues || (SortValues = {}));
+/**
+ * Create an optimized function which will filter a URL search params.
+ */
+export function buildSearchParamFilter(options, params) {
+    if (options.removeAll) {
+        return url => url.search = "";
+    }
+    if (options.sort === undefined)
+        options.sort = SortValues.ASC;
+    const filters = {};
+    for (const paramName in params) {
+        const filter = params[paramName];
+        if (filter.max === 0)
+            continue;
+        filters[paramName] = optionsToFunction(params[paramName]);
+    }
+    let paramNames = Object.keys(filters);
+    if (options.sort === SortValues.ASC) {
+        paramNames = paramNames.sort();
+    }
+    else if (options.sort === SortValues.DESC) {
+        paramNames = paramNames.sort().reverse();
+    }
+    return function (url) {
+        if (!url.search)
+            return;
+        const sp = url.searchParams;
+        let newSearchValue = "";
+        paramNames.forEach(paramName => {
+            const filterPart = filters[paramName];
+            if (filterPart.debug)
+                debugger;
+            let values;
+            if (filterPart.onlyOneParam) {
+                const value = sp.get(paramName);
+                if (!value) {
+                    if (filterPart.allowsNameOnly && sp.has(paramName)) {
+                        newSearchValue += `&${paramName}`;
+                    }
+                    if (filterPart.defaultValue) {
+                        newSearchValue += `&${paramName}=${filterPart.defaultValue}`;
+                    }
+                    return;
+                }
+                values = [value];
+            }
+            else {
+                values = sp.getAll(paramName);
+                if (values.length === 0) {
+                    if (filterPart.defaultValue) {
+                        newSearchValue += `&${paramName}=${filterPart.defaultValue}`;
+                    }
+                    else if (filterPart.allowsNameOnly && sp.has(paramName)) {
+                        newSearchValue += `&${paramName}`;
+                    }
+                    return;
+                }
+                else if ((values.length === 1) && (values[0].length === 0)) {
+                    if (filterPart.allowsNameOnly) {
+                        newSearchValue += `&${paramName}`;
+                    }
+                }
+            }
+            const pipeline = filterPart.pipeline;
+            if (pipeline.length === 1) {
+                pipeline[0](values);
+            }
+            else {
+                for (let i = 0; i < pipeline.length; i++) {
+                    if (!pipeline[i](values))
+                        break;
+                }
+            }
+            if (values.length) {
+                if (values.length === 1) {
+                    if (values[0].length !== 0) {
+                        newSearchValue += `&${paramName}=${values[0]}`;
+                    }
+                }
+                else {
+                    values.forEach(v => {
+                        if (v.length !== 0)
+                            newSearchValue += `&${paramName}=${v}`;
+                    });
+                }
+            }
+        });
+        if (newSearchValue.length)
+            url.search = "?" + newSearchValue.substring(1);
+        else
+            url.search = "";
+    };
+}
+function optionsToFunction(filter) {
+    const res = {
+        pipeline: [],
+        isRemoveAll: false,
+        onlyOneParam: false,
+        allowsNameOnly: false,
+        debug: filter.debug
+    };
+    const pipeline = res.pipeline;
+    //region Set default filter values
+    if (filter.max === undefined)
+        filter.max = 1;
+    if (filter.allowAllValues === undefined)
+        filter.allowAllValues = false;
+    if (filter.allowsNameOnly === undefined)
+        filter.allowsNameOnly = false;
+    if (!filter.allowAllValues) {
+        if (!filter.values) {
+            res.isRemoveAll = true;
+            return res;
+        }
+    }
+    if (filter.ignoreCase) {
+        filter.toLowerCase = false;
+        filter.toUpperCase = false;
+    }
+    else {
+        if (!filter.toLowerCase) {
+            filter.toLowerCase = !filter.toUpperCase;
+        }
+        if (filter.toUpperCase) {
+            if (filter.toLowerCase) {
+                filter.toUpperCase = false;
+            }
+        }
+        else {
+            filter.toUpperCase = false;
+        }
+    }
+    //endregion
+    const limitToOne = filter.max === 1;
+    res.onlyOneParam = limitToOne;
+    res.defaultValue = filter.defaultValue;
+    res.allowsNameOnly = filter.allowsNameOnly;
+    // Transform allowed value.
+    //
+    if (filter.values) {
+        if (filter.toLowerCase)
+            filter.values = filter.values.map(v => v.toLowerCase());
+        else if (filter.toUpperCase)
+            filter.values = filter.values.map(v => v.toUpperCase());
+    }
+    if (filter.toUpperCase) {
+        if (limitToOne) {
+            pipeline.push(all => {
+                all[0] = all[0].toUpperCase();
+                return true;
+            });
+        }
+        else {
+            pipeline.push(all => {
+                all.forEach((v, i) => {
+                    all[i] = v.toUpperCase();
+                });
+                return true;
+            });
+        }
+    }
+    else if (filter.toLowerCase) {
+        if (limitToOne) {
+            pipeline.push(all => {
+                all[0] = all[0].toLowerCase();
+                return true;
+            });
+        }
+        else {
+            pipeline.push(all => {
+                all.forEach((v, i) => {
+                    all[i] = v.toLowerCase();
+                });
+                return true;
+            });
+        }
+    }
+    if (!filter.allowAllValues) {
+        const allowedValues = filter.values;
+        if (limitToOne) {
+            pipeline.push(v => {
+                const res = allowedValues.includes(v[0]);
+                if (!res) {
+                    v[0] = "";
+                    return false;
+                }
+                return true;
+            });
+        }
+        else {
+            pipeline.push(v => {
+                let res = false;
+                for (let i = 0; i < v.length; i++) {
+                    if (!allowedValues.includes(v[i]))
+                        v[i] = "";
+                    else
+                        res = true;
+                }
+                return res;
+            });
+        }
+    }
+    return res;
+}
+//# sourceMappingURL=searchParamFilter.js.map

package/dist/@core/searchParamFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchParamFilter.js","sourceRoot":"","sources":["../../src/@core/searchParamFilter.ts"],"names":[],"mappings":"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"}

package/dist/@core/serverFetch.d.ts

@@ -0,0 +1,122 @@
+import { type SendingBody } from "./jopiWebSite.tsx";
+import type { LoadBalancer } from "./loadBalancing.ts";
+import { JopiRequest } from "./jopiRequest.js";
+export interface ServerDownResult<T> {
+    newServer?: ServerFetch<T>;
+    newServerWeight?: number;
+}
+export interface FetchOptions {
+    headers?: Headers;
+    method?: string;
+    verbose?: boolean;
+}
+export interface ServerFetchOptions<T> {
+    /**
+     * Allow automatically removing the trailing slashs for the website root.
+     * If I have http://127.0.0.1/, then it's begun http://127.0.0.1
+     * Default value is false.
+     */
+    removeRootTrailingSlash?: boolean;
+    /**
+     * Is called before a request.
+     * Is used to start the server if we are doing headless.
+     */
+    beforeRequesting?: (url: string, fetchOptions: FetchOptions, data: T) => void | Promise<void>;
+    /**
+     * Is called if we detect that the server is down.
+     * Allow starting a script which will restart the server
+     * or send a mal to the admin.
+     *
+     * @returns
+     *      true if we can retry the call.
+     *      false if we can't.
+     */
+    ifServerIsDown?: (fetcher: ServerFetch<T>, data: T) => Promise<ServerDownResult<T> | undefined>;
+    headers?: Headers;
+    userDefaultHeaders?: boolean;
+    cookies?: {
+        [key: string]: string;
+    };
+    verbose?: boolean;
+    /**
+     * The public URL of the website.
+     * It's the url that he must use to build the url in his content.
+     * It's not the url of the server where he can be reached.
+     *
+     * Setting a public url will allow automatically setting the X-Forwarded-Host and X-Forwarded-Proto headers.
+     */
+    publicUrl?: string | URL;
+    /**
+     * An object which will be sent to beforeRequesting.
+     * Will also be where ifServerIsDown can store his state.
+     */
+    data?: T;
+    /**
+     * Allow rewriting the url for complex cases.
+     */
+    rewriteUrl?: (url: string, headers: Headers, fetcher: ServerFetch<any>) => URL;
+    /**
+     * Allow rewriting a redirection.
+     */
+    translateRedirect?: (url: string) => URL;
+    /**
+     * The weight of this server, if using inside a load balancer.
+     */
+    weight?: number;
+    /**
+     * If set, then will be called to start the start.
+     * The resulting value is the number of seconds to wait for inactivity.
+     */
+    doStartServer?: (data: any) => Promise<number>;
+    /**
+     * If set, then will be called to stop the server when not need anymore.
+     */
+    doStopServer?: (data: any) => Promise<void>;
+}
+export declare class ServerFetch<T> {
+    private readonly options;
+    private lastURL;
+    /**
+     * The load-balancer will attach himself if this instance
+     * is used by a load balancer.
+     */
+    loadBalancer?: LoadBalancer;
+    /**
+     * Create an instance that translates urls from an origin to a destination.
+     *      Ex: http://127.0.0.1 --> https://www.mywebiste.com
+     *      Ex: https://my-server.com --> https://134.555.666.66:7890 (with hostname: my-server.com)
+     *
+     * @param publicUrl
+     *      The origin of our current website.
+     * @param targetUrl
+     *      The origin of the target website.
+     * @param hostName
+     *      Must be set if toOrigin use an IP and not a hostname.
+     *      (will set the Host header)
+     * @param options
+     *      Options for the ServerFetch instance.
+     */
+    static fromTo<T>(publicUrl: string, targetUrl: string, hostName?: string, options?: ServerFetchOptions<T>): ServerFetch<T>;
+    static getOptionsFor_fromTo<T>(publicUrl: string, targetUrl: string, hostName?: string, options?: ServerFetchOptions<T>): ServerFetchOptions<T>;
+    static useOrigin<T>(serverOrigin: string, options?: ServerFetchOptions<T>): ServerFetch<T>;
+    static useIP<T>(serverOrigin: string, ip: string, options?: ServerFetchOptions<T>): ServerFetch<T>;
+    static getOptionsFor_useOrigin<T>(serverOrigin: string, options?: ServerFetchOptions<T>): ServerFetchOptions<T>;
+    static getOptionsFor_useIP<T>(serverOrigin: string, ip: string, options?: ServerFetchOptions<T>): ServerFetchOptions<T>;
+    static useAsIs<T>(options?: ServerFetchOptions<T>): ServerFetch<T>;
+    protected constructor(options?: ServerFetchOptions<T> | undefined);
+    checkIfServerOk(): Promise<boolean>;
+    private useDefaultHeaders;
+    private compileCookies;
+    /**
+     * Allow directly proxy a request as if we were directly asking the target server.
+     */
+    directProxy(req: JopiRequest): Promise<Response>;
+    fetchWith(req: JopiRequest): Promise<Response>;
+    fetch(method: string, url: URL, body?: SendingBody, headers?: Headers): Promise<Response>;
+    fetch2(method: string, url: string, body?: SendingBody, headers?: Headers): Promise<Response>;
+    normalizeUrl(urlInfos: URL): string;
+    /**
+     * Allow fetching some content.
+     */
+    private doFetch;
+}