@start9labs/start-sdk 0.4.0-beta.9 → 0.4.0

package/base/lib/util/ip.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CGNAT = exports.IPV6_LINK_LOCAL = exports.IPV6_LOOPBACK = exports.IPV4_LOOPBACK = exports.PRIVATE_IPV4_RANGES = exports.IpNet = exports.IpAddress = void 0;
+/**
+ * Represents an IPv4 or IPv6 address as raw octets with arithmetic and comparison operations.
+ *
+ * IPv4 addresses have 4 octets, IPv6 addresses have 16 octets.
+ *
+ * @example
+ * ```ts
+ * const ip = IpAddress.parse("192.168.1.1")
+ * const next = ip.add(1) // 192.168.1.2
+ * ```
+ */
+class IpAddress {
+    constructor(octets, renderedAddress) {
+        this.octets = octets;
+        this.renderedAddress = renderedAddress;
+        this.renderedOctets = [...octets];
+    }
+    /**
+     * Parses an IP address string into an IpAddress instance.
+     * Supports both IPv4 dotted-decimal and IPv6 colon-hex notation (including `::` shorthand).
+     * @param address - The IP address string to parse
+     * @returns A new IpAddress instance
+     * @throws Error if the address format is invalid
+     */
+    static parse(address) {
+        let octets;
+        if (address.includes(':')) {
+            octets = new Array(16).fill(0);
+            const segs = address.split(':');
+            let idx = 0;
+            let octIdx = 0;
+            while (segs[idx]) {
+                const num = parseInt(segs[idx], 16);
+                octets[octIdx++] = num >> 8;
+                octets[octIdx++] = num & 255;
+                idx += 1;
+            }
+            const lastSegIdx = segs.length - 1;
+            if (idx < lastSegIdx) {
+                idx = lastSegIdx;
+                octIdx = 15;
+                while (segs[idx]) {
+                    const num = parseInt(segs[idx], 16);
+                    octets[octIdx--] = num & 255;
+                    octets[octIdx--] = num >> 8;
+                    idx -= 1;
+                }
+            }
+        }
+        else {
+            octets = address.split('.').map(Number);
+            if (octets.length !== 4)
+                throw new Error('invalid ipv4 address');
+        }
+        if (octets.some((o) => isNaN(o) || o > 255)) {
+            throw new Error('invalid ip address');
+        }
+        return new IpAddress(octets, address);
+    }
+    /**
+     * Creates an IpAddress from a raw octet array.
+     * @param octets - Array of 4 octets (IPv4) or 16 octets (IPv6), each 0-255
+     * @returns A new IpAddress instance
+     * @throws Error if the octet array length is not 4 or 16, or any octet exceeds 255
+     */
+    static fromOctets(octets) {
+        if (octets.length == 4) {
+            if (octets.some((o) => o > 255)) {
+                throw new Error('invalid ip address');
+            }
+            return new IpAddress(octets, octets.join('.'));
+        }
+        else if (octets.length == 16) {
+            if (octets.some((o) => o > 255)) {
+                throw new Error('invalid ip address');
+            }
+            let pre = octets.slice(0, 8);
+            while (pre[pre.length - 1] == 0) {
+                pre.pop();
+            }
+            let post = octets.slice(8);
+            while (post[0] == 0) {
+                post.unshift();
+            }
+            if (pre.length + post.length == 16) {
+                return new IpAddress(octets, octets.join(':'));
+            }
+            else {
+                return new IpAddress(octets, pre.join(':') + '::' + post.join(':'));
+            }
+        }
+        else {
+            throw new Error('invalid ip address');
+        }
+    }
+    /** Returns true if this is an IPv4 address (4 octets). */
+    isIpv4() {
+        return this.octets.length === 4;
+    }
+    /** Returns true if this is an IPv6 address (16 octets). */
+    isIpv6() {
+        return this.octets.length === 16;
+    }
+    /** Returns true if this is a public IPv4 address (not in any private range). */
+    isPublic() {
+        return this.isIpv4() && !exports.PRIVATE_IPV4_RANGES.some((r) => r.contains(this));
+    }
+    /**
+     * Returns a new IpAddress incremented by `n`.
+     * @param n - The integer amount to add (fractional part is truncated)
+     * @returns A new IpAddress with the result
+     * @throws Error on overflow
+     */
+    add(n) {
+        let octets = [...this.octets];
+        n = Math.floor(n);
+        for (let i = octets.length - 1; i >= 0; i--) {
+            octets[i] += n;
+            if (octets[i] > 255) {
+                n = octets[i] >> 8;
+                octets[i] &= 255;
+            }
+            else {
+                break;
+            }
+        }
+        if (octets[0] > 255) {
+            throw new Error('overflow incrementing ip');
+        }
+        return IpAddress.fromOctets(octets);
+    }
+    /**
+     * Returns a new IpAddress decremented by `n`.
+     * @param n - The integer amount to subtract (fractional part is truncated)
+     * @returns A new IpAddress with the result
+     * @throws Error on underflow
+     */
+    sub(n) {
+        let octets = [...this.octets];
+        n = Math.floor(n);
+        for (let i = octets.length - 1; i >= 0; i--) {
+            octets[i] -= n;
+            if (octets[i] < 0) {
+                n = Math.ceil(Math.abs(octets[i]) / 256);
+                octets[i] = ((octets[i] % 256) + 256) % 256;
+            }
+            else {
+                break;
+            }
+        }
+        if (octets[0] < 0) {
+            throw new Error('underflow decrementing ip');
+        }
+        return IpAddress.fromOctets(octets);
+    }
+    /**
+     * Compares this address to another, returning -1, 0, or 1.
+     * @param other - An IpAddress instance or string to compare against
+     * @returns -1 if this < other, 0 if equal, 1 if this > other
+     */
+    cmp(other) {
+        if (typeof other === 'string')
+            other = IpAddress.parse(other);
+        const len = Math.max(this.octets.length, other.octets.length);
+        for (let i = 0; i < len; i++) {
+            const left = this.octets[i] || 0;
+            const right = other.octets[i] || 0;
+            if (left > right) {
+                return 1;
+            }
+            else if (left < right) {
+                return -1;
+            }
+        }
+        return 0;
+    }
+    /** The string representation of this IP address (e.g. `"192.168.1.1"` or `"::1"`). Cached and recomputed only when octets change. */
+    get address() {
+        if (this.renderedOctets.length === this.octets.length &&
+            this.renderedOctets.every((o, idx) => o === this.octets[idx])) {
+            // already rendered
+        }
+        else if (this.octets.length === 4) {
+            this.renderedAddress = this.octets.join('.');
+            this.renderedOctets = [...this.octets];
+        }
+        else if (this.octets.length === 16) {
+            const contigZeros = this.octets.reduce((acc, x, idx) => {
+                if (x === 0) {
+                    acc.current++;
+                }
+                else {
+                    acc.current = 0;
+                }
+                if (acc.current > acc.end - acc.start) {
+                    acc.end = idx + 1;
+                    acc.start = acc.end - acc.current;
+                }
+                return acc;
+            }, { start: 0, end: 0, current: 0 });
+            if (contigZeros.end - contigZeros.start >= 2) {
+                return `${this.octets.slice(0, contigZeros.start).join(':')}::${this.octets.slice(contigZeros.end).join(':')}`;
+            }
+            this.renderedAddress = this.octets.join(':');
+            this.renderedOctets = [...this.octets];
+        }
+        else {
+            console.warn('invalid octet length for IpAddress', this.octets);
+        }
+        return this.renderedAddress;
+    }
+}
+exports.IpAddress = IpAddress;
+/**
+ * Represents an IP network (CIDR notation) combining an IP address with a prefix length.
+ * Extends IpAddress with network-specific operations like containment checks and broadcast calculation.
+ *
+ * @example
+ * ```ts
+ * const net = IpNet.parse("192.168.1.0/24")
+ * net.contains("192.168.1.100") // true
+ * net.broadcast() // 192.168.1.255
+ * ```
+ */
+class IpNet extends IpAddress {
+    constructor(octets, prefix, address) {
+        super(octets, address);
+        this.prefix = prefix;
+    }
+    /**
+     * Creates an IpNet from an IpAddress and prefix length.
+     * @param ip - The base IP address
+     * @param prefix - The CIDR prefix length (0-32 for IPv4, 0-128 for IPv6)
+     * @returns A new IpNet instance
+     * @throws Error if prefix exceeds the address bit length
+     */
+    static fromIpPrefix(ip, prefix) {
+        if (prefix > ip.octets.length * 8) {
+            throw new Error('invalid prefix');
+        }
+        return new IpNet(ip.octets, prefix, ip.address);
+    }
+    /**
+     * Parses a CIDR notation string (e.g. `"192.168.1.0/24"`) into an IpNet.
+     * @param ipnet - The CIDR string to parse
+     * @returns A new IpNet instance
+     */
+    static parse(ipnet) {
+        const [address, prefixStr] = ipnet.split('/', 2);
+        const ip = IpAddress.parse(address);
+        const prefix = Number(prefixStr);
+        return IpNet.fromIpPrefix(ip, prefix);
+    }
+    /**
+     * Checks whether this network contains the given address or subnet.
+     * @param address - An IP address or subnet (string, IpAddress, or IpNet)
+     * @returns True if the address falls within this network's range
+     */
+    contains(address) {
+        if (typeof address === 'string')
+            address = IpAddress.parse(address);
+        if (address instanceof IpNet && address.prefix < this.prefix)
+            return false;
+        if (this.octets.length !== address.octets.length)
+            return false;
+        let prefix = this.prefix;
+        let idx = 0;
+        while (idx < this.octets.length && prefix >= 8) {
+            if (this.octets[idx] !== address.octets[idx]) {
+                return false;
+            }
+            idx += 1;
+            prefix -= 8;
+        }
+        if (prefix === 0 || idx >= this.octets.length)
+            return true;
+        const mask = 255 ^ (255 >> prefix);
+        return (this.octets[idx] & mask) === (address.octets[idx] & mask);
+    }
+    /** Returns the network address (all host bits zeroed) for this subnet. */
+    zero() {
+        let octets = [];
+        let prefix = this.prefix;
+        for (let idx = 0; idx < this.octets.length; idx++) {
+            if (prefix >= 8) {
+                octets[idx] = this.octets[idx];
+                prefix -= 8;
+            }
+            else {
+                const mask = 255 ^ (255 >> prefix);
+                octets[idx] = this.octets[idx] & mask;
+                prefix = 0;
+            }
+        }
+        return IpAddress.fromOctets(octets);
+    }
+    /** Returns the broadcast address (all host bits set to 1) for this subnet. */
+    broadcast() {
+        let octets = [];
+        let prefix = this.prefix;
+        for (let idx = 0; idx < this.octets.length; idx++) {
+            if (prefix >= 8) {
+                octets[idx] = this.octets[idx];
+                prefix -= 8;
+            }
+            else {
+                const mask = 255 >> prefix;
+                octets[idx] = this.octets[idx] | mask;
+                prefix = 0;
+            }
+        }
+        return IpAddress.fromOctets(octets);
+    }
+    /** The CIDR notation string for this network (e.g. `"192.168.1.0/24"`). */
+    get ipnet() {
+        return `${this.address}/${this.prefix}`;
+    }
+}
+exports.IpNet = IpNet;
+/** All private IPv4 ranges: loopback (127.0.0.0/8), Class A (10.0.0.0/8), Class B (172.16.0.0/12), Class C (192.168.0.0/16). */
+exports.PRIVATE_IPV4_RANGES = [
+    IpNet.parse('127.0.0.0/8'),
+    IpNet.parse('10.0.0.0/8'),
+    IpNet.parse('172.16.0.0/12'),
+    IpNet.parse('192.168.0.0/16'),
+];
+/** IPv4 loopback network (127.0.0.0/8). */
+exports.IPV4_LOOPBACK = IpNet.parse('127.0.0.0/8');
+/** IPv6 loopback address (::1/128). */
+exports.IPV6_LOOPBACK = IpNet.parse('::1/128');
+/** IPv6 link-local network (fe80::/10). */
+exports.IPV6_LINK_LOCAL = IpNet.parse('fe80::/10');
+/** Carrier-Grade NAT (CGNAT) address range (100.64.0.0/10), per RFC 6598. */
+exports.CGNAT = IpNet.parse('100.64.0.0/10');
+//# sourceMappingURL=ip.js.map

package/base/lib/util/ip.js.map

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

package/base/lib/util/logErrorOnce.d.ts

@@ -0,0 +1 @@
+export declare function logErrorOnce(err: unknown): void;

package/base/lib/util/logErrorOnce.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logErrorOnce = logErrorOnce;
+const loggedErrors = new WeakSet();
+function logErrorOnce(err) {
+    if (typeof err === 'object' && err !== null) {
+        if (loggedErrors.has(err))
+            return;
+        loggedErrors.add(err);
+    }
+    console.error(err);
+}
+//# sourceMappingURL=logErrorOnce.js.map

package/base/lib/util/logErrorOnce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logErrorOnce.js","sourceRoot":"","sources":["../../../../base/lib/util/logErrorOnce.ts"],"names":[],"mappings":";;AAEA,oCAMC;AARD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAU,CAAA;AAE1C,SAAgB,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAM;QACjC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC"}

package/base/lib/util/once.d.ts

@@ -1 +1,14 @@
+/**
+ * Wraps a function so it is only executed once. Subsequent calls return the cached result.
+ *
+ * @param fn - The function to execute at most once
+ * @returns A wrapper that lazily evaluates `fn` on first call and caches the result
+ *
+ * @example
+ * ```ts
+ * const getConfig = once(() => loadExpensiveConfig())
+ * getConfig() // loads config
+ * getConfig() // returns cached result
+ * ```
+ */
 export declare function once<B>(fn: () => B): () => B;

package/base/lib/util/once.js

@@ -1,6 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.once = once;
+/**
+ * Wraps a function so it is only executed once. Subsequent calls return the cached result.
+ *
+ * @param fn - The function to execute at most once
+ * @returns A wrapper that lazily evaluates `fn` on first call and caches the result
+ *
+ * @example
+ * ```ts
+ * const getConfig = once(() => loadExpensiveConfig())
+ * getConfig() // loads config
+ * getConfig() // returns cached result
+ * ```
+ */
 function once(fn) {
     let result = [];
     return () => {

package/base/lib/util/once.js.map

@@ -1 +1 @@
-{"version":3,"file":"once.js","sourceRoot":"","sources":["../../../../base/lib/util/once.ts"],"names":[],"mappings":";;AAAA,oBAQC;AARD,SAAgB,IAAI,CAAI,EAAW;IACjC,IAAI,MAAM,GAAa,EAAE,CAAA;IACzB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../../../base/lib/util/once.ts"],"names":[],"mappings":";;AAaA,oBAQC;AArBD;;;;;;;;;;;;GAYG;AACH,SAAgB,IAAI,CAAI,EAAW;IACjC,IAAI,MAAM,GAAa,EAAE,CAAA;IACzB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;QACjB,CAAC;QACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC,CAAA;AACH,CAAC"}

package/base/lib/util/patterns.d.ts

@@ -1,14 +1,23 @@
-import { Pattern } from "../actions/input/inputSpecTypes";
+import { Pattern } from '../actions/input/inputSpecTypes';
+/** Pattern for validating IPv6 addresses. */
 export declare const ipv6: Pattern;
+/** Pattern for validating IPv4 addresses. */
 export declare const ipv4: Pattern;
+/** Pattern for validating hostnames (RFC-compliant). */
 export declare const hostname: Pattern;
+/** Pattern for validating `.local` mDNS hostnames. */
 export declare const localHostname: Pattern;
-export declare const torHostname: Pattern;
+/** Pattern for validating HTTP/HTTPS URLs. */
 export declare const url: Pattern;
+/** Pattern for validating `.local` URLs (mDNS/LAN). */
 export declare const localUrl: Pattern;
-export declare const torUrl: Pattern;
+/** Pattern for validating ASCII-only strings (printable characters). */
 export declare const ascii: Pattern;
+/** Pattern for validating fully qualified domain names (FQDNs). */
 export declare const domain: Pattern;
+/** Pattern for validating email addresses. */
 export declare const email: Pattern;
+/** Pattern for validating email addresses, optionally with a display name (e.g. `"John Doe <john@example.com>"`). */
 export declare const emailWithName: Pattern;
+/** Pattern for validating base64-encoded strings. */
 export declare const base64: Pattern;

package/base/lib/util/patterns.js

@@ -33,58 +33,61 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.base64 = exports.emailWithName = exports.email = exports.domain = exports.ascii = exports.torUrl = exports.localUrl = exports.url = exports.torHostname = exports.localHostname = exports.hostname = exports.ipv4 = exports.ipv6 = void 0;
+exports.base64 = exports.emailWithName = exports.email = exports.domain = exports.ascii = exports.localUrl = exports.url = exports.localHostname = exports.hostname = exports.ipv4 = exports.ipv6 = void 0;
 const regexes = __importStar(require("./regexes"));
+/** Pattern for validating IPv6 addresses. */
 exports.ipv6 = {
     regex: regexes.ipv6.matches(),
-    description: "Must be a valid IPv6 address",
+    description: 'Must be a valid IPv6 address',
 };
+/** Pattern for validating IPv4 addresses. */
 exports.ipv4 = {
     regex: regexes.ipv4.matches(),
-    description: "Must be a valid IPv4 address",
+    description: 'Must be a valid IPv4 address',
 };
+/** Pattern for validating hostnames (RFC-compliant). */
 exports.hostname = {
     regex: regexes.hostname.matches(),
-    description: "Must be a valid hostname",
+    description: 'Must be a valid hostname',
 };
+/** Pattern for validating `.local` mDNS hostnames. */
 exports.localHostname = {
     regex: regexes.localHostname.matches(),
     description: 'Must be a valid ".local" hostname',
 };
-exports.torHostname = {
-    regex: regexes.torHostname.matches(),
-    description: 'Must be a valid Tor (".onion") hostname',
-};
+/** Pattern for validating HTTP/HTTPS URLs. */
 exports.url = {
     regex: regexes.url.matches(),
-    description: "Must be a valid URL",
+    description: 'Must be a valid URL',
 };
+/** Pattern for validating `.local` URLs (mDNS/LAN). */
 exports.localUrl = {
     regex: regexes.localUrl.matches(),
     description: 'Must be a valid ".local" URL',
 };
-exports.torUrl = {
-    regex: regexes.torUrl.matches(),
-    description: 'Must be a valid Tor (".onion") URL',
-};
+/** Pattern for validating ASCII-only strings (printable characters). */
 exports.ascii = {
     regex: regexes.ascii.matches(),
-    description: "May only contain ASCII characters. See https://www.w3schools.com/charsets/ref_html_ascii.asp",
+    description: 'May only contain ASCII characters. See https://www.w3schools.com/charsets/ref_html_ascii.asp',
 };
+/** Pattern for validating fully qualified domain names (FQDNs). */
 exports.domain = {
     regex: regexes.domain.matches(),
-    description: "Must be a valid Fully Qualified Domain Name",
+    description: 'Must be a valid Fully Qualified Domain Name',
 };
+/** Pattern for validating email addresses. */
 exports.email = {
     regex: regexes.email.matches(),
-    description: "Must be a valid email address",
+    description: 'Must be a valid email address',
 };
+/** Pattern for validating email addresses, optionally with a display name (e.g. `"John Doe <john@example.com>"`). */
 exports.emailWithName = {
     regex: regexes.emailWithName.matches(),
-    description: "Must be a valid email address, optionally with a name",
+    description: 'Must be a valid email address, optionally with a name',
 };
+/** Pattern for validating base64-encoded strings. */
 exports.base64 = {
     regex: regexes.base64.matches(),
-    description: "May only contain base64 characters. See https://base64.guru/learn/base64-characters",
+    description: 'May only contain base64 characters. See https://base64.guru/learn/base64-characters',
 };
 //# sourceMappingURL=patterns.js.map

package/base/lib/util/patterns.js.map

@@ -1 +1 @@
-{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../../base/lib/util/patterns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mDAAoC;AAEvB,QAAA,IAAI,GAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;IAC7B,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAEY,QAAA,IAAI,GAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;IAC7B,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAEY,QAAA,QAAQ,GAAY;IAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE;IACjC,WAAW,EAAE,0BAA0B;CACxC,CAAA;AAEY,QAAA,aAAa,GAAY;IACpC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,mCAAmC;CACjD,CAAA;AAEY,QAAA,WAAW,GAAY;IAClC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE;IACpC,WAAW,EAAE,yCAAyC;CACvD,CAAA;AAEY,QAAA,GAAG,GAAY;IAC1B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;IAC5B,WAAW,EAAE,qBAAqB;CACnC,CAAA;AAEY,QAAA,QAAQ,GAAY;IAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE;IACjC,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAEY,QAAA,MAAM,GAAY;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;IAC/B,WAAW,EAAE,oCAAoC;CAClD,CAAA;AAEY,QAAA,KAAK,GAAY;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;IAC9B,WAAW,EACT,8FAA8F;CACjG,CAAA;AAEY,QAAA,MAAM,GAAY;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;IAC/B,WAAW,EAAE,6CAA6C;CAC3D,CAAA;AAEY,QAAA,KAAK,GAAY;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,+BAA+B;CAC7C,CAAA;AAEY,QAAA,aAAa,GAAY;IACpC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,uDAAuD;CACrE,CAAA;AAEY,QAAA,MAAM,GAAY;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;IAC/B,WAAW,EACT,qFAAqF;CACxF,CAAA"}
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../../base/lib/util/patterns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mDAAoC;AAEpC,6CAA6C;AAChC,QAAA,IAAI,GAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;IAC7B,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAED,6CAA6C;AAChC,QAAA,IAAI,GAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;IAC7B,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAED,wDAAwD;AAC3C,QAAA,QAAQ,GAAY;IAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE;IACjC,WAAW,EAAE,0BAA0B;CACxC,CAAA;AAED,sDAAsD;AACzC,QAAA,aAAa,GAAY;IACpC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,mCAAmC;CACjD,CAAA;AAED,8CAA8C;AACjC,QAAA,GAAG,GAAY;IAC1B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;IAC5B,WAAW,EAAE,qBAAqB;CACnC,CAAA;AAED,uDAAuD;AAC1C,QAAA,QAAQ,GAAY;IAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE;IACjC,WAAW,EAAE,8BAA8B;CAC5C,CAAA;AAED,wEAAwE;AAC3D,QAAA,KAAK,GAAY;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;IAC9B,WAAW,EACT,8FAA8F;CACjG,CAAA;AAED,mEAAmE;AACtD,QAAA,MAAM,GAAY;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;IAC/B,WAAW,EAAE,6CAA6C;CAC3D,CAAA;AAED,8CAA8C;AACjC,QAAA,KAAK,GAAY;IAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,+BAA+B;CAC7C,CAAA;AAED,qHAAqH;AACxG,QAAA,aAAa,GAAY;IACpC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,uDAAuD;CACrE,CAAA;AAED,qDAAqD;AACxC,QAAA,MAAM,GAAY;IAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;IAC/B,WAAW,EACT,qFAAqF;CACxF,CAAA"}

package/base/lib/util/regexes.d.ts

@@ -1,20 +1,59 @@
+/**
+ * A wrapper around RegExp that supports composition into larger patterns.
+ * Provides helpers to produce anchored (full-match), grouped (sub-expression),
+ * and unanchored (contains) regex source strings.
+ *
+ * @example
+ * ```ts
+ * const digit = new ComposableRegex(/\d+/)
+ * digit.matches()  // "^\\d+$"
+ * digit.contains() // "\\d+"
+ * digit.asExpr()   // "(\\d+)"
+ * ```
+ */
 export declare class ComposableRegex {
     readonly regex: RegExp;
     constructor(regex: RegExp | string);
+    /** Returns the regex source wrapped in a capturing group, suitable for embedding in a larger expression. */
     asExpr(): string;
+    /** Returns the regex source anchored with `^...$` for full-string matching. */
     matches(): string;
+    /** Returns the raw regex source string for substring/containment matching. */
     contains(): string;
 }
+/**
+ * Escapes all regex special characters in a string so it can be used as a literal in a RegExp.
+ * @param str - The string to escape
+ * @returns The escaped string safe for regex interpolation
+ */
+export declare const escapeLiteral: (str: string) => string;
+/** Composable regex for matching IPv6 addresses (all standard forms including `::` shorthand). */
 export declare const ipv6: ComposableRegex;
+/** Composable regex for matching IPv4 addresses in dotted-decimal notation. */
 export declare const ipv4: ComposableRegex;
+/** Composable regex for matching RFC-compliant hostnames. */
 export declare const hostname: ComposableRegex;
+/** Composable regex for matching `.local` mDNS hostnames. */
 export declare const localHostname: ComposableRegex;
-export declare const torHostname: ComposableRegex;
+/** Composable regex for matching HTTP/HTTPS URLs. */
 export declare const url: ComposableRegex;
+/** Composable regex for matching `.local` URLs (mDNS/LAN). */
 export declare const localUrl: ComposableRegex;
-export declare const torUrl: ComposableRegex;
+/** Composable regex for matching printable ASCII characters (space through tilde). */
 export declare const ascii: ComposableRegex;
+/** Composable regex for matching fully qualified domain names. */
 export declare const domain: ComposableRegex;
+/** Composable regex for matching email addresses. */
 export declare const email: ComposableRegex;
+/** Composable regex for matching email addresses optionally preceded by a display name (e.g. `"Name <email>"`). */
 export declare const emailWithName: ComposableRegex;
+/** Composable regex for matching base64-encoded strings (no whitespace). */
 export declare const base64: ComposableRegex;
+/** Composable regex for matching base64-encoded strings that may contain interspersed whitespace. */
+export declare const base64Whitespace: ComposableRegex;
+/**
+ * Creates a composable regex for matching PEM-encoded blocks with the given label.
+ * @param label - The PEM label (e.g. `"CERTIFICATE"`, `"RSA PRIVATE KEY"`)
+ * @returns A ComposableRegex matching `-----BEGIN <label>-----...-----END <label>-----`
+ */
+export declare const pem: (label: string) => ComposableRegex;