@adviser/cement 0.4.7 → 0.4.8

package/uri.d.ts

@@ -0,0 +1,137 @@
+import { Result } from "./result.js";
+import { KeysParam } from "./utils/get-params-result.js";
+import { StripCommand } from "./utils/stripper.js";
+type NullOrUndef = null | undefined;
+type OneKey<K extends string, V = string> = Record<K, V>;
+export interface URIInterface<R extends URIInterface<R>> {
+    readonly getParams: Iterable<[string, string]>;
+    hasParam(key: string): boolean;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: KeysParam): Result<Record<string, string>>;
+    match(other: CoerceURI): MatchResult;
+    clone(): R;
+    asURL(): URL;
+    toString(): string;
+    toJSON(): string;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+}
+export interface MatchResult {
+    readonly score: number;
+    readonly protocol: boolean;
+    readonly hostname: boolean;
+    readonly port: boolean;
+    readonly pathname: boolean;
+    readonly pathParts: string[];
+    readonly params: Record<string, string>;
+}
+export interface URIObject {
+    readonly style: "host" | "path";
+    readonly protocol: string;
+    readonly pathname: string;
+    readonly searchParams: Record<string, string>;
+}
+export interface PathURIObject extends URIObject {
+    readonly style: "path";
+}
+export interface HostURIObject extends URIObject {
+    readonly style: "host";
+    readonly hostname: string;
+    readonly port: string;
+}
+export declare function isURL(value: unknown): value is URL;
+declare const customInspectSymbol: unique symbol;
+export declare class MutableURL extends URL {
+    private readonly _sysURL;
+    private _protocol;
+    private _pathname;
+    private _hasHostpart;
+    constructor(urlStr: string);
+    [customInspectSymbol](): string;
+    clone(): MutableURL;
+    get host(): string;
+    get port(): string;
+    set port(p: string);
+    get hostname(): string;
+    set hostname(h: string);
+    set pathname(p: string);
+    get pathname(): string;
+    get protocol(): string;
+    set protocol(p: string);
+    get hash(): string;
+    set hash(h: string);
+    get searchParams(): URLSearchParams;
+    get search(): string;
+    toString(): string;
+}
+export declare class BuildURI implements URIInterface<BuildURI> {
+    _url: MutableURL;
+    private constructor();
+    static is(value: unknown): value is BuildURI;
+    static from(strURLUri?: CoerceURI, defaultProtocol?: string): BuildURI;
+    match(other: CoerceURI): MatchResult;
+    port(p: string): BuildURI;
+    hostname(h: string): BuildURI;
+    protocol(p: string): BuildURI;
+    pathname(p: string): BuildURI;
+    hash(h: string): BuildURI;
+    resolve(p: CoerceURI): BuildURI;
+    appendRelative(p: CoerceURI): BuildURI;
+    cleanParams(...remove: (string | string[])[]): BuildURI;
+    searchParams(val: Record<string, string | number | boolean | Date | null | undefined>, mode?: "reset" | "merge"): BuildURI;
+    hashParams(val: Record<string, string | number | boolean | Date | null | undefined>, mode?: "reset" | "merge"): BuildURI;
+    delParam(key: string): BuildURI;
+    defParam(key: string, str: string): BuildURI;
+    setParam(key: string, str: string): BuildURI;
+    hasParam(key: string): boolean;
+    get getParams(): Iterable<[string, string]>;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: KeysParam): Result<Record<string, string>>;
+    getHashParams(...keys: KeysParam): Result<Record<string, string>>;
+    toString(): string;
+    toJSON(): string;
+    asURL(): URL;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+    clone(): BuildURI;
+    get onlyHostAndSchema(): string;
+    get withoutHostAndSchema(): string;
+    URI(): URI;
+}
+export type CoerceURI = string | URI | MutableURL | URL | BuildURI | NullOrUndef;
+export declare function isCoerceURI(value: unknown): value is CoerceURI;
+export declare const hasHostPartProtocols: Set<string>;
+export declare class URI implements URIInterface<URI> {
+    static protocolHasHostpart(protocol: string): () => void;
+    match(other: CoerceURI): MatchResult;
+    static merge(into: CoerceURI, from: CoerceURI, defaultProtocol?: string): URI;
+    static is(value: unknown): value is URI;
+    static from(strURLUri?: CoerceURI, defaultProtocol?: string): URI;
+    static fromResult(strURLUri?: CoerceURI, defaultProtocol?: string): Result<URI>;
+    readonly _url: MutableURL;
+    private constructor();
+    build(): BuildURI;
+    get hostname(): string;
+    get onlyHostAndSchema(): string;
+    get withoutHostAndSchema(): string;
+    get port(): string;
+    get host(): string;
+    get search(): string;
+    get protocol(): string;
+    get pathname(): string;
+    get hash(): string;
+    get getParams(): Iterable<[string, string]>;
+    get getHashes(): Iterable<[string, string]>;
+    hasParam(key: string): boolean;
+    getParam<T extends string | undefined>(key: string | OneKey<string>, def?: T): T extends string ? string : string | undefined;
+    getParamResult(key: string, msgFn?: (key: string) => string): Result<string>;
+    getParamsResult(...keys: KeysParam): Result<Record<string, string>>;
+    getHashParams(...keys: KeysParam): Result<Record<string, string>>;
+    clone(): URI;
+    asURL(): URL;
+    toString(): string;
+    toJSON(): string;
+    asObj(...strips: StripCommand[]): Partial<HostURIObject | PathURIObject>;
+}
+export {};
+//# sourceMappingURL=uri.d.ts.map

package/uri.d.ts.map

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