@start9labs/start-sdk 0.4.0-beta.6 → 0.4.0-beta.61

package/base/lib/util/regexes.js

@@ -1,6 +1,19 @@
 "use strict";
 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 = exports.ComposableRegex = void 0;
+exports.pem = exports.base64Whitespace = exports.base64 = exports.emailWithName = exports.email = exports.domain = exports.ascii = exports.localUrl = exports.url = exports.localHostname = exports.hostname = exports.ipv4 = exports.ipv6 = exports.escapeLiteral = exports.ComposableRegex = void 0;
+/**
+ * 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+)"
+ * ```
+ */
 class ComposableRegex {
     constructor(regex) {
         if (regex instanceof RegExp) {
@@ -10,34 +23,63 @@ class ComposableRegex {
             this.regex = new RegExp(regex);
         }
     }
+    /** Returns the regex source wrapped in a capturing group, suitable for embedding in a larger expression. */
     asExpr() {
         return `(${this.regex.source})`;
     }
+    /** Returns the regex source anchored with `^...$` for full-string matching. */
     matches() {
         return `^${this.regex.source}$`;
     }
+    /** Returns the raw regex source string for substring/containment matching. */
     contains() {
         return this.regex.source;
     }
 }
 exports.ComposableRegex = ComposableRegex;
+/**
+ * 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
+ */
+const escapeLiteral = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+exports.escapeLiteral = escapeLiteral;
+/** Composable regex for matching IPv6 addresses (all standard forms including `::` shorthand). */
 // https://ihateregex.io/expr/ipv6/
 exports.ipv6 = new ComposableRegex(/(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))/);
+/** Composable regex for matching IPv4 addresses in dotted-decimal notation. */
 // https://ihateregex.io/expr/ipv4/
 exports.ipv4 = new ComposableRegex(/(\b25[0-5]|\b2[0-4][0-9]|\b[01]?[0-9][0-9]?)(\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}/);
+/** Composable regex for matching RFC-compliant hostnames. */
 exports.hostname = new ComposableRegex(/(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])/);
+/** Composable regex for matching `.local` mDNS hostnames. */
 exports.localHostname = new ComposableRegex(/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.local/);
-exports.torHostname = new ComposableRegex(/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.onion/);
+/** Composable regex for matching HTTP/HTTPS URLs. */
 // https://ihateregex.io/expr/url/
 exports.url = new ComposableRegex(/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)/);
+/** Composable regex for matching `.local` URLs (mDNS/LAN). */
 exports.localUrl = new ComposableRegex(/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.local\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)/);
-exports.torUrl = new ComposableRegex(/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.onion\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)/);
+/** Composable regex for matching printable ASCII characters (space through tilde). */
 // https://ihateregex.io/expr/ascii/
 exports.ascii = new ComposableRegex(/[ -~]*/);
+/** Composable regex for matching fully qualified domain names. */
 exports.domain = new ComposableRegex(/[A-Za-z0-9.-]+\.[A-Za-z]{2,}/);
+/** Composable regex for matching email addresses. */
 // https://www.regular-expressions.info/email.html
 exports.email = new ComposableRegex(`[A-Za-z0-9._%+-]+@${exports.domain.asExpr()}`);
+/** Composable regex for matching email addresses optionally preceded by a display name (e.g. `"Name <email>"`). */
 exports.emailWithName = new ComposableRegex(`${exports.email.asExpr()}|([^<]*<${exports.email.asExpr()}>)`);
+/** Composable regex for matching base64-encoded strings (no whitespace). */
 //https://rgxdb.com/r/1NUN74O6
 exports.base64 = new ComposableRegex(/(?:[a-zA-Z0-9+\/]{4})*(?:|(?:[a-zA-Z0-9+\/]{3}=)|(?:[a-zA-Z0-9+\/]{2}==)|(?:[a-zA-Z0-9+\/]{1}===))/);
+/** Composable regex for matching base64-encoded strings that may contain interspersed whitespace. */
+//https://rgxdb.com/r/1NUN74O6
+exports.base64Whitespace = new ComposableRegex(/(?:([a-zA-Z0-9+\/]\s*){4})*(?:|(?:([a-zA-Z0-9+\/]\s*){3}=)|(?:([a-zA-Z0-9+\/]\s*){2}==)|(?:([a-zA-Z0-9+\/]\s*){1}===))/);
+/**
+ * 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>-----`
+ */
+const pem = (label) => new ComposableRegex(`-----BEGIN ${(0, exports.escapeLiteral)(label)}-----\r?\n[a-zA-Z0-9+/\n\r=]*?\r?\n-----END ${(0, exports.escapeLiteral)(label)}-----`);
+exports.pem = pem;
 //# sourceMappingURL=regexes.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"regexes.js","sourceRoot":"","sources":["../../../../base/lib/util/regexes.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAe;IAE1B,YAAY,KAAsB;QAChC,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IACD,MAAM;QACJ,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAA;IACjC,CAAC;IACD,OAAO;QACL,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAA;IACjC,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;CACF;AAlBD,0CAkBC;AAED,mCAAmC;AACtB,QAAA,IAAI,GAAG,IAAI,eAAe,CACrC,qpBAAqpB,CACtpB,CAAA;AAED,mCAAmC;AACtB,QAAA,IAAI,GAAG,IAAI,eAAe,CACrC,2FAA2F,CAC5F,CAAA;AAEY,QAAA,QAAQ,GAAG,IAAI,eAAe,CACzC,2GAA2G,CAC5G,CAAA;AAEY,QAAA,aAAa,GAAG,IAAI,eAAe,CAC9C,sCAAsC,CACvC,CAAA;AAEY,QAAA,WAAW,GAAG,IAAI,eAAe,CAC5C,sCAAsC,CACvC,CAAA;AAED,kCAAkC;AACrB,QAAA,GAAG,GAAG,IAAI,eAAe,CACpC,0GAA0G,CAC3G,CAAA;AAEY,QAAA,QAAQ,GAAG,IAAI,eAAe,CACzC,6FAA6F,CAC9F,CAAA;AAEY,QAAA,MAAM,GAAG,IAAI,eAAe,CACvC,6FAA6F,CAC9F,CAAA;AAED,oCAAoC;AACvB,QAAA,KAAK,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAA;AAErC,QAAA,MAAM,GAAG,IAAI,eAAe,CAAC,8BAA8B,CAAC,CAAA;AAEzE,kDAAkD;AACrC,QAAA,KAAK,GAAG,IAAI,eAAe,CAAC,qBAAqB,cAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAEnE,QAAA,aAAa,GAAG,IAAI,eAAe,CAC9C,GAAG,aAAK,CAAC,MAAM,EAAE,WAAW,aAAK,CAAC,MAAM,EAAE,IAAI,CAC/C,CAAA;AAED,8BAA8B;AACjB,QAAA,MAAM,GAAG,IAAI,eAAe,CACvC,oGAAoG,CACrG,CAAA"}
+{"version":3,"file":"regexes.js","sourceRoot":"","sources":["../../../../base/lib/util/regexes.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,MAAa,eAAe;IAE1B,YAAY,KAAsB;QAChC,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IACD,4GAA4G;IAC5G,MAAM;QACJ,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAA;IACjC,CAAC;IACD,+EAA+E;IAC/E,OAAO;QACL,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAA;IACjC,CAAC;IACD,8EAA8E;IAC9E,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;CACF;AArBD,0CAqBC;AAED;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAC3C,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AAD/B,QAAA,aAAa,iBACkB;AAE5C,kGAAkG;AAClG,mCAAmC;AACtB,QAAA,IAAI,GAAG,IAAI,eAAe,CACrC,qpBAAqpB,CACtpB,CAAA;AAED,+EAA+E;AAC/E,mCAAmC;AACtB,QAAA,IAAI,GAAG,IAAI,eAAe,CACrC,2FAA2F,CAC5F,CAAA;AAED,6DAA6D;AAChD,QAAA,QAAQ,GAAG,IAAI,eAAe,CACzC,2GAA2G,CAC5G,CAAA;AAED,6DAA6D;AAChD,QAAA,aAAa,GAAG,IAAI,eAAe,CAC9C,sCAAsC,CACvC,CAAA;AAED,qDAAqD;AACrD,kCAAkC;AACrB,QAAA,GAAG,GAAG,IAAI,eAAe,CACpC,0GAA0G,CAC3G,CAAA;AAED,8DAA8D;AACjD,QAAA,QAAQ,GAAG,IAAI,eAAe,CACzC,6FAA6F,CAC9F,CAAA;AAED,sFAAsF;AACtF,oCAAoC;AACvB,QAAA,KAAK,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAA;AAElD,kEAAkE;AACrD,QAAA,MAAM,GAAG,IAAI,eAAe,CAAC,8BAA8B,CAAC,CAAA;AAEzE,qDAAqD;AACrD,kDAAkD;AACrC,QAAA,KAAK,GAAG,IAAI,eAAe,CAAC,qBAAqB,cAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAEhF,mHAAmH;AACtG,QAAA,aAAa,GAAG,IAAI,eAAe,CAC9C,GAAG,aAAK,CAAC,MAAM,EAAE,WAAW,aAAK,CAAC,MAAM,EAAE,IAAI,CAC/C,CAAA;AAED,4EAA4E;AAC5E,8BAA8B;AACjB,QAAA,MAAM,GAAG,IAAI,eAAe,CACvC,oGAAoG,CACrG,CAAA;AAED,qGAAqG;AACrG,8BAA8B;AACjB,QAAA,gBAAgB,GAAG,IAAI,eAAe,CACjD,wHAAwH,CACzH,CAAA;AAED;;;;GAIG;AACI,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,EAAE,CACnC,IAAI,eAAe,CACjB,cAAc,IAAA,qBAAa,EAAC,KAAK,CAAC,+CAA+C,IAAA,qBAAa,EAAC,KAAK,CAAC,OAAO,CAC7G,CAAA;AAHU,QAAA,GAAG,OAGb"}

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

@@ -1 +1,16 @@
-export declare const splitCommand: (command: string | [string, ...string[]]) => string[];
+import { AllowReadonly } from '../types';
+/**
+ * Normalizes a command into an argv-style string array.
+ * If given a string, wraps it as `["sh", "-c", command]`.
+ * If given a tuple, returns it as-is.
+ *
+ * @param command - A shell command string or a pre-split argv tuple
+ * @returns An argv-style string array suitable for process execution
+ *
+ * @example
+ * ```ts
+ * splitCommand("echo hello")           // ["sh", "-c", "echo hello"]
+ * splitCommand(["node", "index.js"])   // ["node", "index.js"]
+ * ```
+ */
+export declare const splitCommand: (command: string | AllowReadonly<[string, ...string[]]>) => string[];

package/base/lib/util/splitCommand.js

@@ -1,11 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.splitCommand = void 0;
-const ts_matches_1 = require("ts-matches");
+/**
+ * Normalizes a command into an argv-style string array.
+ * If given a string, wraps it as `["sh", "-c", command]`.
+ * If given a tuple, returns it as-is.
+ *
+ * @param command - A shell command string or a pre-split argv tuple
+ * @returns An argv-style string array suitable for process execution
+ *
+ * @example
+ * ```ts
+ * splitCommand("echo hello")           // ["sh", "-c", "echo hello"]
+ * splitCommand(["node", "index.js"])   // ["node", "index.js"]
+ * ```
+ */
 const splitCommand = (command) => {
-    if ((0, ts_matches_1.arrayOf)(ts_matches_1.string).test(command))
+    if (Array.isArray(command))
         return command;
-    return ["sh", "-c", command];
+    return ['sh', '-c', command];
 };
 exports.splitCommand = splitCommand;
 //# sourceMappingURL=splitCommand.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"splitCommand.js","sourceRoot":"","sources":["../../../../base/lib/util/splitCommand.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAErC,MAAM,YAAY,GAAG,CAC1B,OAAuC,EAC7B,EAAE;IACZ,IAAI,IAAA,oBAAO,EAAC,mBAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACjD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC9B,CAAC,CAAA;AALY,QAAA,YAAY,gBAKxB"}
+{"version":3,"file":"splitCommand.js","sourceRoot":"","sources":["../../../../base/lib/util/splitCommand.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;GAaG;AACI,MAAM,YAAY,GAAG,CAC1B,OAAsD,EAC5C,EAAE;IACZ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC1C,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAiB,CAAC,CAAA;AACxC,CAAC,CAAA;AALY,QAAA,YAAY,gBAKxB"}

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

@@ -1,3 +1,10 @@
+/**
+ * Extracts a string result from a stdout/stderr pair.
+ * Returns `stdout` on success; rejects with `stderr` if it is non-empty.
+ *
+ * @param x - An object containing `stdout` and `stderr` strings
+ * @returns A promise resolving to `stdout`, or rejecting with `stderr`
+ */
 export declare function stringFromStdErrOut(x: {
     stdout: string;
     stderr: string;

package/base/lib/util/stringFromStdErrOut.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stringFromStdErrOut = stringFromStdErrOut;
+/**
+ * Extracts a string result from a stdout/stderr pair.
+ * Returns `stdout` on success; rejects with `stderr` if it is non-empty.
+ *
+ * @param x - An object containing `stdout` and `stderr` strings
+ * @returns A promise resolving to `stdout`, or rejecting with `stderr`
+ */
 async function stringFromStdErrOut(x) {
     return x?.stderr ? Promise.reject(x.stderr) : x.stdout;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"stringFromStdErrOut.js","sourceRoot":"","sources":["../../../../base/lib/util/stringFromStdErrOut.ts"],"names":[],"mappings":";;AAAA,kDAKC;AALM,KAAK,UAAU,mBAAmB,CAAC,CAGzC;IACC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACxD,CAAC"}
+{"version":3,"file":"stringFromStdErrOut.js","sourceRoot":"","sources":["../../../../base/lib/util/stringFromStdErrOut.ts"],"names":[],"mappings":";;AAOA,kDAKC;AAZD;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CAAC,CAGzC;IACC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACxD,CAAC"}

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

@@ -1,20 +1,55 @@
-import * as T from "../types";
+import * as T from '../types';
+/**
+ * Flattens an intersection type into a single object type for improved readability in IDE tooltips.
+ * Arrays pass through unchanged; objects are remapped to a single flat type.
+ *
+ * @example
+ * ```ts
+ * type Merged = FlattenIntersection<{ a: 1 } & { b: 2 }>
+ * // Result: { a: 1; b: 2 }
+ * ```
+ */
 export type FlattenIntersection<T> = T extends ArrayLike<any> ? T : T extends object ? {} & {
     [P in keyof T]: T[P];
 } : T;
+/** Shorthand alias for {@link FlattenIntersection}. */
 export type _<T> = FlattenIntersection<T>;
+/**
+ * Type guard that checks whether a value is a {@link T.KnownError}.
+ * Returns true if the value is an object containing an `error` or `error-code` property.
+ *
+ * @param e - The value to check
+ * @returns True if `e` is a KnownError
+ */
 export declare const isKnownError: (e: unknown) => e is T.KnownError;
 declare const affine: unique symbol;
+/**
+ * A branded/nominal type wrapper using a unique symbol to make structurally identical types incompatible.
+ * Useful for creating distinct type identities at the type level.
+ */
 export type Affine<A> = {
     [affine]: A;
 };
 type NeverPossible = {
     [affine]: string;
 };
+/**
+ * Evaluates to `never` if `A` is `any`, otherwise resolves to `A`.
+ * Useful for preventing `any` from silently propagating through generic constraints.
+ */
 export type NoAny<A> = NeverPossible extends A ? keyof NeverPossible extends keyof A ? never : A : A;
-type CapitalLetters = "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" | "S" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z";
-type Numbers = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+type CapitalLetters = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
+type Numbers = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
 type CapitalChars = CapitalLetters | Numbers;
-export type ToKebab<S extends string> = S extends string ? S extends `${infer Head}${CapitalChars}${infer Tail}` ? Head extends "" ? Tail extends "" ? Lowercase<S> : S extends `${infer Caps}${Tail}` ? Caps extends CapitalChars ? Tail extends CapitalLetters ? `${Lowercase<Caps>}-${Lowercase<Tail>}` : Tail extends `${CapitalLetters}${string}` ? `${ToKebab<Caps>}-${ToKebab<Tail>}` : `${ToKebab<Caps>}${ToKebab<Tail>}` : never : never : Tail extends "" ? S extends `${Head}${infer Caps}` ? Caps extends CapitalChars ? Head extends Lowercase<Head> ? Caps extends Numbers ? Head extends `${string}${Numbers}` ? never : `${ToKebab<Head>}-${Caps}` : `${ToKebab<Head>}-${ToKebab<Caps>}` : never : never : never : S extends `${Head}${infer Caps}${Tail}` ? Caps extends CapitalChars ? Head extends Lowercase<Head> ? Tail extends CapitalLetters ? `${ToKebab<Head>}-${ToKebab<Caps>}-${Lowercase<Tail>}` : Tail extends `${CapitalLetters}${string}` ? Head extends Numbers ? never : Head extends `${string}${Numbers}` ? never : `${Head}-${ToKebab<Caps>}-${ToKebab<Tail>}` : `${ToKebab<Head>}-${Lowercase<Caps>}${ToKebab<Tail>}` : never : never : never : S : never;
+/**
+ * Converts a PascalCase or camelCase string type to kebab-case at the type level.
+ *
+ * @example
+ * ```ts
+ * type Result = ToKebab<"FooBar"> // "foo-bar"
+ * ```
+ */
+export type ToKebab<S extends string> = S extends string ? S extends `${infer Head}${CapitalChars}${infer Tail}` ? Head extends '' ? Tail extends '' ? Lowercase<S> : S extends `${infer Caps}${Tail}` ? Caps extends CapitalChars ? Tail extends CapitalLetters ? `${Lowercase<Caps>}-${Lowercase<Tail>}` : Tail extends `${CapitalLetters}${string}` ? `${ToKebab<Caps>}-${ToKebab<Tail>}` : `${ToKebab<Caps>}${ToKebab<Tail>}` : never : never : Tail extends '' ? S extends `${Head}${infer Caps}` ? Caps extends CapitalChars ? Head extends Lowercase<Head> ? Caps extends Numbers ? Head extends `${string}${Numbers}` ? never : `${ToKebab<Head>}-${Caps}` : `${ToKebab<Head>}-${ToKebab<Caps>}` : never : never : never : S extends `${Head}${infer Caps}${Tail}` ? Caps extends CapitalChars ? Head extends Lowercase<Head> ? Tail extends CapitalLetters ? `${ToKebab<Head>}-${ToKebab<Caps>}-${Lowercase<Tail>}` : Tail extends `${CapitalLetters}${string}` ? Head extends Numbers ? never : Head extends `${string}${Numbers}` ? never : `${Head}-${ToKebab<Caps>}-${ToKebab<Tail>}` : `${ToKebab<Head>}-${Lowercase<Caps>}${ToKebab<Tail>}` : never : never : never : S : never;
+/** A generic object type with string keys and unknown values. */
 export type StringObject = Record<string, unknown>;
 export {};

package/base/lib/util/typeHelpers.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isKnownError = void 0;
-const isKnownError = (e) => e instanceof Object && ("error" in e || "error-code" in e);
+/**
+ * Type guard that checks whether a value is a {@link T.KnownError}.
+ * Returns true if the value is an object containing an `error` or `error-code` property.
+ *
+ * @param e - The value to check
+ * @returns True if `e` is a KnownError
+ */
+const isKnownError = (e) => e instanceof Object && ('error' in e || 'error-code' in e);
 exports.isKnownError = isKnownError;
 function test() {
     // prettier-ignore

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

@@ -1 +1 @@
-{"version":3,"file":"typeHelpers.js","sourceRoot":"","sources":["../../../../base/lib/util/typeHelpers.ts"],"names":[],"mappings":";;;AAUO,MAAM,YAAY,GAAG,CAAC,CAAU,EAAqB,EAAE,CAC5D,CAAC,YAAY,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC,CAAA;AAD/C,QAAA,YAAY,gBACmC;AA8F5D,SAAS,IAAI;IACX,kBAAkB;IAClB,MAAM,CAAC,GAAG,CAAO,CAIhB,EAAE,EAAE,GAAE,CAAC,CAAA;IACR,CAAC,CAA+B,IAAI,CAAC,CAAA;IACrC,mBAAmB;IACnB,CAAC,CAA+B,IAAI,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"typeHelpers.js","sourceRoot":"","sources":["../../../../base/lib/util/typeHelpers.ts"],"names":[],"mappings":";;;AAqBA;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,CAAU,EAAqB,EAAE,CAC5D,CAAC,YAAY,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC,CAAA;AAD/C,QAAA,YAAY,gBACmC;AA+G5D,SAAS,IAAI;IACX,kBAAkB;IAClB,MAAM,CAAC,GAAG,CAAO,CAIhB,EAAE,EAAE,GAAE,CAAC,CAAA;IACR,CAAC,CAA+B,IAAI,CAAC,CAAA;IACrC,mBAAmB;IACnB,CAAC,CAA+B,IAAI,CAAC,CAAA;AACvC,CAAC"}

package/base/lib/zExport.d.ts

@@ -0,0 +1,14 @@
+import { z as _z } from 'zod'
+import type { DeepPartial } from './types'
+
+type ZodDeepPartial = <T>(a: _z.ZodType<T>) => _z.ZodType<DeepPartial<T>>
+type ZodDeepLoose = <T>(a: _z.ZodType<T>) => _z.ZodType<T>
+
+declare module 'zod' {
+  namespace z {
+    const deepPartial: ZodDeepPartial
+    const deepLoose: ZodDeepLoose
+  }
+}
+
+export { _z as z }

package/base/lib/zExport.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+
+const zod_1 = require("zod");
+const zod_deep_partial_1 = require("zod-deep-partial");
+
+// Recursively make all ZodObjects in a schema loose (preserve extra keys at every nesting level).
+// Uses _zod.def.type duck-typing instead of instanceof to avoid issues with mismatched zod versions.
+function deepLoose(schema) {
+  const def = schema._zod?.def;
+  if (!def) return schema;
+  let result;
+  switch (def.type) {
+    case "optional":
+      result = deepLoose(def.innerType).optional();
+      break;
+    case "nullable":
+      result = deepLoose(def.innerType).nullable();
+      break;
+    case "object": {
+      const newShape = {};
+      for (const key in schema.shape) {
+        newShape[key] = deepLoose(schema.shape[key]);
+      }
+      result = zod_1.z.looseObject(newShape);
+      break;
+    }
+    case "array":
+      result = zod_1.z.array(deepLoose(def.element));
+      break;
+    case "union":
+      result = zod_1.z.union(def.options.map((o) => deepLoose(o)));
+      break;
+    case "intersection":
+      result = zod_1.z.intersection(deepLoose(def.left), deepLoose(def.right));
+      break;
+    case "record":
+      result = zod_1.z.record(def.keyType, deepLoose(def.valueType));
+      break;
+    case "tuple":
+      result = zod_1.z.tuple(def.items.map((i) => deepLoose(i)));
+      break;
+    case "lazy":
+      result = zod_1.z.lazy(() => deepLoose(def.getter()));
+      break;
+    default:
+      return schema;
+  }
+  return result;
+}
+
+// Add deepPartial and deepLoose to z at runtime
+zod_1.z.deepPartial = (a) =>
+  deepLoose((0, zod_deep_partial_1.zodDeepPartial)(a));
+zod_1.z.deepLoose = deepLoose;
+
+// Override z.object to produce loose objects by default (extra keys are preserved, not stripped).
+const _origObject = zod_1.z.object;
+const _patchedObject = (...args) => _origObject(...args).loose();
+
+// In CJS (Node.js), patch the source module in require.cache where 'object' is a writable property;
+// the CJS getter chain (index → external → schemas) then relays the patched version.
+// We walk only the zod entry module's dependency tree and match by identity (=== origObject).
+try {
+  const _zodModule = require.cache[require.resolve("zod")];
+  for (const child of _zodModule?.children ?? []) {
+    for (const grandchild of child.children ?? []) {
+      const desc = Object.getOwnPropertyDescriptor(
+        grandchild.exports,
+        "object",
+      );
+      if (desc?.value === _origObject && desc.writable) {
+        grandchild.exports.object = _patchedObject;
+      }
+    }
+  }
+} catch (_) {
+  // Not in CJS/Node environment (e.g. browser) — require.cache unavailable
+}
+
+// z.object is a non-configurable getter on the zod namespace, so we can't override it directly.
+// Shadow it by exporting a new object with _z as prototype and our patched object on the instance.
+const z = Object.create(zod_1.z, {
+  object: {
+    value: _patchedObject,
+    writable: true,
+    configurable: true,
+    enumerable: true,
+  },
+});
+
+exports.z = z;