typepki-strconv 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kenji Urushima
+
+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,22 @@
+typepki-strconv: TypePKI string converters and utilities sub module for TypePKI library
+====================================================================================
+
+The 'TypePKI' library is an opensource free TypeScript PKI library which is the successor of the long lived [jsrsasign](https://kjur.github.io/jsrsasign) library.
+
+The 'typepki-strconv' is a TypeScript string converters and utilities sub module for TypePKI library. 
+
+Following string types are supported:
+- Base64 and Base64URL encoded string
+- hexadecimal string
+- ArrayBuffer
+- Zule time
+- UTF8 string
+- raw string
+- ISO 8859-1 latin string
+- PEM string
+- UCS2 string
+- byte array
+- IPv4 and v6 address
+
+## FEATURE
+- Dual CommonJS/ES module package supporting CommonJS(CJS) and ES modules

package/dist/import/conv.d.mts

@@ -0,0 +1,193 @@
+export declare function b64tohex(b64: string): string;
+export declare function hextob64(hex: string): string;
+export declare function b64toutf8(b64: string): string;
+export declare function utf8tob64(u8: string): string;
+export declare function b64utoutf8(b64u: string): string;
+export declare function utf8tob64u(u8: string): string;
+export declare function hextoutf8(hex: string): string;
+export declare function utf8tohex(u8: string): string;
+export declare function b64utohex(b64u: string): string;
+export declare function hextob64u(hex: string): string;
+/**
+ * convert a hexadecimal string to raw string
+ * @param hex hexadecimal string
+ * @return rawstring
+ * @see {@link rstrtohex}
+ * @example
+ * hextorstr("616161") -> "aaa"
+ * hextorstr("610061") -> "a\x00a"
+ */
+export declare function hextorstr(hex: string): string;
+/**
+ * convert a raw string to a hexadecimal string
+ * @param s raw string
+ * @return hexadecimal string
+ * @see {@link hextorstr}
+ * @example
+ * rstrtohex("aaa") -> "616161"
+ * rstrtohex("a\x00a") -> "610061"
+ */
+export declare function rstrtohex(s: string): string;
+/**
+ * convert a raw string to a Base64 encoded string.
+ * @param s raw string
+ * @return Base64URL encoded string
+ * @example
+ * rstrtob64("aaa") -> "YWFh"
+ */
+export declare function rstrtob64(s: string): string;
+/**
+ * convert a Base64 encoded string to a Base64URL encoded string.
+ * @param sIn - Base64 encoded string
+ * @return Base64URL encoded string
+ * @see {@link b64utob64}
+ * @example
+ * b64tob64u("ab+c3f/==") → "ab-c3f_"
+ */
+export declare function b64tob64u(sIn: string): string;
+/**
+ * convert a Base64URL encoded string to a Base64 encoded string.
+ * @param sIn - Base64URL encoded string
+ * @return Base64 encoded string
+ * @see {@link b64tob64u}
+ * @example
+ * b64utob64("ab-c3f_") -> "ab+c3f/=="
+ */
+export declare function b64utob64(sIn: string): string;
+/**
+ * convert from binary string to hexadecimal string of ASN.1 BitString value with unused bit<br/>
+ * @param s binary string (ex. "101")
+ * @return hexadecimal string of ASN.1 BitString value with unused bit
+ * @see {@link bitstrtobinstr}
+ *
+ * @description
+ * This function converts from an binary string (ex. "101") to
+ * hexadecimal string of ASN.1 BitString value
+ * with unused bit (ex. "05a0"). <br/>
+ * When "s" is not binary string, this returns null.
+ *
+ * @example
+ * binstrtobitstr("101") -> "05a0"
+ * binstrtobitstr("001") -> "0520"
+ * binstrtobitstr("11001") -> "03c8"
+ * binstrtobitstr("101000001") -> "07a080"
+ * binstrtobitstr(101) -> null // not number
+ * binstrtobitstr("xyz") -> null // not binary string
+ */
+export declare const binstrtobitstr: (s: string) => string | null;
+/**
+ * convert from hexadecimal string of ASN.1 BitString value with unused bit to binary string
+ * @param h - hexadecimal string of ASN.1 BitString value with unused bit
+ * @return binary string
+ * @see {@link binstrtobitstr}
+ * @see {@link inttobitstr}
+ *
+ * @description
+ * This function converts from hexadecimal string of ASN.1 BitString
+ * value with unused bit to its integer value. <br/>
+ * When an improper hexadecimal string of BitString value
+ * is applied, this returns null.
+ *
+ * @example
+ * bitstrtobinstr("05a0") -> "101"
+ * bitstrtobinstr("0520") -> "001"
+ * bitstrtobinstr("07a080") -> "101000001"
+ * bitstrtobinstr(502) -> null // non ASN.1 BitString value
+ * bitstrtobinstr("ff00") -> null // for improper BitString value
+ */
+export declare function bitstrtobinstr(h: string): string | null;
+/**
+ * convert from integer value to hexadecimal string of ASN.1 BitString value with unused bit
+ * @param n integer value of ASN.1 BitString
+ * @return hexadecimal string of ASN.1 BitString value with unused bit
+ * @see bitstrtoint
+ *
+ * @description
+ * This function converts from an integer value to
+ * hexadecimal string of ASN.1 BitString value
+ * with unused bit. <br/>
+ * When "n" is not non-negative number, this returns null
+ *
+ * @example
+ * // 25 -> 11001b -> 11001000b unusedbit=03 -> 0xc8 unusedbit=03 -> "03c8"
+ * inttobitstr(25) -> "03c8"
+ * inttobitstr(-3) -> null
+ * inttobitstr("abc") -> null
+ * inttobitstr(parseInt("11001", 2)) -> "03c8"
+ * inttobitstr(parseInt("101", 2)) -> "05a0"
+ * inttobitstr(parseInt("101000001", 2)) -> "07a080"
+ */
+export declare function inttobitstr(n: number): string | null;
+/**
+ * create padded string with specified length and padding string
+ * @param s input string
+ * @param len output string length
+ * @param defpadchar padding character (default is "0")
+ * @return padded string
+ * @example
+ * strpad("1234", 10, "0") -> "0000001234"
+ * strpad("1234", 10, " ") -> "      1234"
+ * strpad("1234", 10)      -> "0000001234"
+ */
+export declare const strpad: (s: string, len: number, defpadchar?: string) => string;
+/**
+ * represents JSON data structure
+ * @example
+ * let db: Dictionary<number> = { apple: 10, orange: 20 }
+ */
+export interface Dictionary<Type> {
+    /**
+     * key string
+     */
+    [key: string]: Type;
+}
+/**
+ * convert array of names to bit string
+ * @param namearray array of name string
+ * @param namedb associative array of name and value
+ * @return binary string (ex. "110001")
+ *
+ * @description
+ * This function converts from an array of names to
+ * a binary string. DB value bit will be set.
+ * Note that ordering of namearray items
+ * will be ignored.
+ * This function may be useful to implement ASN.1 BitString such as KeyUsage.
+ *
+ * @example
+ * let db: Dictionary<number> = { a: 0, b: 3, c: 8, d: 9, e: 17, f: 19 };
+ * namearraytobinstr(['a', 'c', 'd'], db) -> '1000000011'
+ * namearraytobinstr(['c', 'b'], db) -> '000100001'
+ */
+export declare function namearraytobinstr(namearray: Array<string>, namedb: Dictionary<number>): string;
+/**
+ * get value of array by key name list<br/>
+ * @param valIn - array of associative array
+ * @param sKey - concatinated key list with dot (ex. 'type.name.0.info')
+ * @param defIn - default value if value is not found (OPTIONAL)
+ * @return value if found otherwise returns def
+ *
+ * @description
+ * This function returns the value of an array or associative array
+ * which referred by a concatinated key list string.
+ * If a value for key is not defined, it returns 'undefined' by default.
+ * When an optional argument 'def' is specified and a value for key is
+ * not defined, it returns a value of 'def'.
+ *
+ * @example
+ * let p = {
+ *   fruit: apple,
+ *   info: [
+ *     { toy: 4 },
+ *     { pen: 6 }
+ *   ]
+ * };
+ * aryval(p, 'fruit') -> "apple"
+ * aryval(p, 'info') -> [{toy: 4},{pen: 6}]
+ * aryval(p, 'info.1') -> {pen: 6}
+ * aryval(p, 'info.1.pen') -> 6
+ * aryval(p, 'money.amount') -> undefined
+ * aryval(p, 'money.amount', null) -> null
+ */
+export declare function aryval(valIn: any, sKey: string, defIn?: any): any;
+//# sourceMappingURL=conv.d.mts.map

package/dist/import/conv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv.d.mts","sourceRoot":"","sources":["../../src/conv.mts"],"names":[],"mappings":"AACA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAGD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3C;AAGD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAGD;;;;;;;GAOG;AAKH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C;AAGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,MAAO,MAAM,KAAG,MAAM,GAAG,IAQnD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWpD;AAOD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,MAAO,MAAM,OAAO,MAAM,eAAe,MAAM,KAAG,MAIpE,CAAC;AAGF;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI;IAC9B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AAQH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GACzB,MAAM,CAYR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,CAejE"}

package/dist/import/conv_arybuf.d.mts

@@ -0,0 +1,30 @@
+/**
+ * convert a hexadecimal string to an ArrayBuffer
+ * @param hex - hexadecimal string
+ * @return ArrayBuffer
+ *
+ * @description
+ * This function converts from a hexadecimal string to an ArrayBuffer.
+ *
+ * @example
+ * hextoArrayBuffer("fffa01") -> ArrayBuffer of [255, 250, 1]
+ */
+export declare function hextoArrayBuffer(hex: string): ArrayBuffer;
+/**
+ * convert an ArrayBuffer to a hexadecimal string
+ * @param buffer - ArrayBuffer
+ * @return hexadecimal string
+ *
+ * @description
+ * This function converts from an ArrayBuffer to a hexadecimal string.
+ *
+ * @example
+ * var buffer = new ArrayBuffer(3);
+ * var view = new DataView(buffer);
+ * view.setUint8(0, 0xfa);
+ * view.setUint8(1, 0xfb);
+ * view.setUint8(2, 0x01);
+ * ArrayBuffertohex(buffer) -> "fafb01"
+ */
+export declare function ArrayBuffertohex(buffer: ArrayBuffer): string;
+//# sourceMappingURL=conv_arybuf.d.mts.map

package/dist/import/conv_arybuf.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_arybuf.d.mts","sourceRoot":"","sources":["../../src/conv_arybuf.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAYzD;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAS5D"}

package/dist/import/conv_ba.d.mts

@@ -0,0 +1,27 @@
+/**
+ * convert a ASCII string to a hexadecimal string of ASCII codes.
+ * @description
+ * NOTE: This can't be used for non ASCII characters.
+ * @param s - ASCII string
+ * @return hexadecimal string
+ */
+export declare function stohex(s: string): string;
+/**
+ * convert an array of bytes(Number) to hexadecimal string.
+ * @param a - a array of bytes
+ * @return hexadecimal string
+ */
+export declare function BAtohex(a: Array<number>): string;
+/**
+ * convert a string to an array of character codes
+ * @param s - string
+ * @return array of character code value
+ */
+export declare function stoBA(s: string): Array<number>;
+/**
+ * convert an array of character codes to a string
+ * @param a - a array of character codes
+ * @return string
+ */
+export declare function BAtos(a: Array<number>): string;
+//# sourceMappingURL=conv_ba.d.mts.map

package/dist/import/conv_ba.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_ba.d.mts","sourceRoot":"","sources":["../../src/conv_ba.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAQhD;AAGD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAM9C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAM9C"}

package/dist/import/conv_ip.d.mts

@@ -0,0 +1,69 @@
+/**
+ * convert any IPv6 address to a 16 byte hexadecimal string
+ * @param sIn - ipv6 address string
+ * @return 16 byte hexadecimal string of IPv6 address
+ *
+ * @description
+ * This function converts any IPv6 address representation string
+ * to a 16 byte hexadecimal string of address.
+ *
+ * @example
+ */
+export declare function ipv6tohex(sIn: string): string;
+/**
+ * convert a 16 byte hexadecimal string to RFC 5952 canonicalized IPv6 address
+ * @param hex - hexadecimal string of 16 byte IPv6 address
+ * @return IPv6 address string canonicalized by RFC 5952
+ *
+ * @description
+ * This function converts a 16 byte hexadecimal string to
+ * <a href="https://tools.ietf.org/html/rfc5952">RFC 5952</a>
+ * canonicalized IPv6 address string.
+ *
+ * @example
+ * hextoipv6("871020010db8000000000000000000000004") -> "2001:db8::4"
+ * hextoipv6("871020010db8000000000000000000") -> raise exception
+ * hextoipv6("xyzxyzxyzxyzxyzxyzxyzxyzxyzxyzxyzxyz") -> raise exception
+ */
+export declare function hextoipv6(hex: string): string;
+/**
+ * convert a hexadecimal string to IP addresss
+ * @param s - hexadecimal string of IP address
+ * @return IP address string
+ *
+ * @description
+ * This function converts a hexadecimal string of IPv4 or
+ * IPv6 address to IPv4 or IPv6 address string.
+ * If byte length is not 4 nor 16, this returns a
+ * hexadecimal string without conversion.
+ *
+ * @example
+ * hextoip("c0a80101") -> "192.168.1.1"
+ * hextoip("871020010db8000000000000000000000004") -> "2001:db8::4"
+ * hextoip("c0a80100ffffff00") -> "192.168.1.0/24"
+ * hextoip("c0a801010203") -> "c0a801010203" // wrong 6 bytes
+ * hextoip("zzz")) -> raise exception because of not hexadecimal
+ */
+export declare function hextoip(s: string): string;
+/**
+ * convert IPv4/v6 addresss to a hexadecimal string
+ * @param sIn - IPv4/v6 address string
+ * @return hexadecimal string of IP address
+ * @see hextoip
+ * @see ipv6tohex
+ *
+ * @description
+ * This function converts IPv4 or IPv6 address string to
+ * a hexadecimal string of IPv4 or IPv6 address.
+ *
+ * @example
+ * iptohex("192.168.1.1") -> "c0a80101"
+ * iptohex("2001:db8::4") -> "871020010db8000000000000000000000004"
+ * iptohex("192.168.1.1/24") -> "c0a80101ffffff00"
+ * iptohex("2001:db8::/120") -> "871020010db8000000000000000000000000ffffffffffffffffffffffffffffffffff00"
+ * iptohex("zzz")) -> raise exception
+ */
+export declare function iptohex(sIn: string): string;
+export declare function ipprefixlen(hMask: string): number;
+export declare function ipnetmask(prefixlen: number, len: number): string;
+//# sourceMappingURL=conv_ip.d.mts.map

package/dist/import/conv_ip.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_ip.d.mts","sourceRoot":"","sources":["../../src/conv_ip.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqB7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmC7C;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA+B3C;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD;AAWD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhE"}

package/dist/import/conv_iso88591.d.mts

@@ -0,0 +1,19 @@
+/**
+ * convert a hexadecimal ISO 8859-1 latin string to UTF-8 string
+ * @param h hexadecimal ISO 8859-1 latin string
+ * @return UTF-8 string
+ * @see {@link utf8toiso88591hex}
+ * @example
+ * iso88591hextoutf8("41a9fa") -> "A©ú"
+ */
+export declare function iso88591hextoutf8(h: string): string;
+/**
+ * convert UTF-8 string to a hexadecimal ISO 8859-1 latin string
+ * @param s hexadecimal ISO 8859-1 latin string
+ * @return UTF-8 string
+ * @see {@link iso88591hextoutf8}
+ * @example
+ * utf8toiso88591hex("A©ú") -> "41a9fa"
+ */
+export declare function utf8toiso88591hex(s: string): string;
+//# sourceMappingURL=conv_iso88591.d.mts.map

package/dist/import/conv_iso88591.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_iso88591.d.mts","sourceRoot":"","sources":["../../src/conv_iso88591.mts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/import/conv_pem.d.mts

@@ -0,0 +1,109 @@
+/**
+ * get PEM string from hexadecimal data and header string
+ * @param dataHex - hexadecimal string of PEM body
+ * @param pemHeader - PEM header string (ex. 'RSA PRIVATE KEY')
+ * @param separator - new line string
+ * @return PEM formatted string of input data
+ *
+ * @description
+ * This function converts a hexadecimal string to a PEM string with
+ * a specified header. Its line break will be CRLF("\r\n").
+ *
+ * @example
+ * hextopem('616161', 'RSA PRIVATE KEY') ->
+ * -----BEGIN PRIVATE KEY-----
+ * YWFh
+ * -----END PRIVATE KEY-----
+ */
+export declare function hextopem(dataHex: string, pemHeader: string, separator?: string): string;
+/**
+ * get hexacedimal string from PEM format data
+ * @param s - PEM formatted string
+ * @param sHead - PEM header string without BEGIN/END
+ * @return hexadecimal string data of PEM contents
+ *
+ * @description
+ * This static method gets a hexacedimal string of contents
+ * from PEM format data. You can explicitly specify PEM header
+ * by sHead argument.
+ * Any space characters such as white space or new line
+ * will be omitted.
+ *
+ * @example
+ * pemtohex("-----BEGIN PUBLIC KEY...") -> "3082..."
+ * pemtohex("-----BEGIN CERTIFICATE...", "CERTIFICATE") -> "3082..."
+ * pemtohex(" \r\n-----BEGIN DSA PRIVATE KEY...") -> "3082..."
+ * pemtohex("-----BEGIN EC PARAMETERS...----BEGIN EC PRIVATE KEY...." -> "3082..."
+ */
+export declare function pemtohex(s: string, sHead?: string): string;
+/**
+ * get Base64 string from PEM format data
+ * @param pem - PEM formatted string
+ * @param sHead - PEM header string without BEGIN/END
+ * @return Base64 string
+ *
+ * @description
+ * This static method gets a Base64 string of contents
+ * from PEM format data.
+ *
+ * @example
+ * pemtob64("-----BEGIN CERTIFICATE...", "CERTIFICATE") -> "MIIBvTCC..."
+ * pemtob64("-----BEGIN CERTIFICATE...") -> "MIIBvTCC..."
+ */
+export declare function pemtob64(pem: string, sHead?: string): string;
+/**
+ * get PEM string from Base64 string
+ * @param b64 - Base64 string of PEM body
+ * @param pemHeader - PEM header string (ex. 'RSA PRIVATE KEY')
+ * @param separator - new line string
+ * @return PEM formatted string of input data
+ *
+ * @description
+ * This function converts a Base64 string to a PEM string with
+ * a specified header. Its line break will be CRLF("\r\n").
+ *
+ * @example
+ * b64topem('YWFh', 'RSA PRIVATE KEY') ->
+ * -----BEGIN PRIVATE KEY-----
+ * YWFh
+ * -----END PRIVATE KEY-----
+ */
+export declare function b64topem(b64: string, pemHeader: string, separator?: string): string;
+/**
+ * convert a Base64 encoded string with new lines to a hexadecimal string
+ * @param s - Base64 encoded string with new lines
+ * @return hexadecimal string
+ *
+ * @description
+ * This function converts from a Base64 encoded
+ * string with new lines to a hexadecimal string.
+ * This is useful to handle PEM encoded file.
+ * This function removes any non-Base64 characters (i.e. not 0-9,A-Z,a-z,\,+,=)
+ * including new line.
+ *
+ * @example
+ * hextob64nl(
+ * "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Njc4\r\n" +
+ * "OTAxMjM0NTY3ODkwCg==\r\n")
+ * ->
+ * "123456789012345678901234567890123456789012345678901234567890"
+ */
+export declare function b64nltohex(s: string): string;
+/**
+ * wrap string with new lines to fit in specified width
+ * @param sIn - string
+ * @param n - width
+ * @param separator - line separator
+ * @return wrapped string with new lines
+ *
+ * @description
+ * This function wrap a string with new lines to fit in specified width.
+ *
+ * @example
+ * foldnl("1234567890", 6)
+ * ->
+ * 123456
+ * 7890
+ */
+export declare function foldnl(sIn: string, n: number, separator?: string): string;
+//# sourceMappingURL=conv_pem.d.mts.map

package/dist/import/conv_pem.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_pem.d.mts","sourceRoot":"","sources":["../../src/conv_pem.mts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,SAAS,GACjB,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,SAAS,GACjB,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,MAAM,CAKzE"}

package/dist/import/conv_ucs2.d.mts

@@ -0,0 +1,14 @@
+/**
+ * convert UCS-2 hexadecimal stirng to UTF-8 string
+ * @param s - hexadecimal string of UCS-2 string (ex. "0066")
+ * @return UTF-8 string
+ *
+ * @description
+ * This function converts hexadecimal value of UCS-2 string to
+ * UTF-8 string.
+ *
+ * @example
+ * ucs2hextoutf8("006600fc0072") -> "für"
+ */
+export declare function ucs2hextoutf8(s: string): string;
+//# sourceMappingURL=conv_ucs2.d.mts.map

package/dist/import/conv_ucs2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_ucs2.d.mts","sourceRoot":"","sources":["../../src/conv_ucs2.mts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AASH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB/C"}

package/dist/import/conv_uricmp.d.mts

@@ -0,0 +1,29 @@
+/**
+ * convert a URLComponent string such like "%67%68" to a hexadecimal string.
+ * @param s - URIComponent string such like "%67%68"
+ * @return hexadecimal string
+ * @example
+ * uricmptohex("%67%68") -> "6768"
+ */
+export declare function uricmptohex(s: string): string;
+/**
+ * convert a hexadecimal string to a URLComponent string such like "%67%68".
+ * @param s - hexadecimal string
+ * @return URIComponent string such like "%67%68"
+ * @example
+ * hextouricmp("6768") -> "%67%68"
+ */
+export declare function hextouricmp(s: string): string;
+/**
+ * convert UTF8 hexadecimal string to a URLComponent string such like "%67%68".
+ * @param u8 - UTF8 hexadecimal string
+ * @return URIComponent string such like "%67%68"
+ *
+ * @description
+ * Note that these "<code>0-9A-Za-z!'()*-._~</code>" characters will not
+ * converted to "%xx" format by builtin 'encodeURIComponent()' function.
+ * However this 'encodeURIComponentAll()' function will convert
+ * all of characters into "%xx" format.
+ */
+export declare function encodeURIComponentAll(u8: string): string;
+//# sourceMappingURL=conv_uricmp.d.mts.map

package/dist/import/conv_uricmp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv_uricmp.d.mts","sourceRoot":"","sources":["../../src/conv_uricmp.mts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYxD"}