kerium 0.1.0

package/README.md

@@ -0,0 +1,14 @@
+# Kerium
+
+Kerium is a small library containing some POSIX-style code.
+The focus is on providing shared utilities for other projects.
+
+# Logging
+
+Kerium exposes a flexible logging API that uses the same levels as syslog.
+
+# Errors
+
+The entire set of POSIX errnos are exposed through the `Errno` enum.
+The `ErrnoException` class extends the built-in `Error` with errnos, and provides JSON functionality.
+You can use `strerror` to get a human-readable description of an errno.

package/dist/error.d.ts

@@ -0,0 +1,431 @@
+/**
+ * Standard POSIX error codes.
+ * @see https://en.wikipedia.org/wiki/Errno.h
+ */
+export declare enum Errno {
+    /** Operation not permitted */
+    EPERM = 1,
+    /** No such file or directory */
+    ENOENT = 2,
+    /** No such process */
+    ESRCH = 3,
+    /** Interrupted system call */
+    EINTR = 4,
+    /** Input/output error */
+    EIO = 5,
+    /** No such device or address */
+    ENXIO = 6,
+    /** Argument list too long */
+    E2BIG = 7,
+    /** Exec format error */
+    ENOEXEC = 8,
+    /** Bad file descriptor */
+    EBADF = 9,
+    /** No child processes */
+    ECHILD = 10,
+    /** Resource temporarily unavailable */
+    EAGAIN = 11,
+    /** Out of memory */
+    ENOMEM = 12,
+    /** Permission denied */
+    EACCES = 13,
+    /** Bad address */
+    EFAULT = 14,
+    /** Block device required */
+    ENOTBLK = 15,
+    /** Resource busy or locked */
+    EBUSY = 16,
+    /** File exists */
+    EEXIST = 17,
+    /** Invalid cross-device link */
+    EXDEV = 18,
+    /** No such device */
+    ENODEV = 19,
+    /** File is not a directory */
+    ENOTDIR = 20,
+    /** File is a directory */
+    EISDIR = 21,
+    /** Invalid argument */
+    EINVAL = 22,
+    /** Too many open files in system */
+    ENFILE = 23,
+    /** Too many open files */
+    EMFILE = 24,
+    /** Text file busy */
+    ETXTBSY = 26,
+    /** File is too big */
+    EFBIG = 27,
+    /** No space left on disk */
+    ENOSPC = 28,
+    /** Illegal seek */
+    ESPIPE = 29,
+    /** Cannot modify a read-only file system */
+    EROFS = 30,
+    /** Too many links */
+    EMLINK = 31,
+    /** Broken pipe */
+    EPIPE = 32,
+    /** Numerical argument out of domain */
+    EDOM = 33,
+    /** Numerical result out of range */
+    ERANGE = 34,
+    /** Resource deadlock would occur */
+    EDEADLK = 35,
+    /** File name too long */
+    ENAMETOOLONG = 36,
+    /** No locks available */
+    ENOLCK = 37,
+    /** Function not implemented */
+    ENOSYS = 38,
+    /** Directory is not empty */
+    ENOTEMPTY = 39,
+    /** Too many levels of symbolic links */
+    ELOOP = 40,
+    /** No message of desired type */
+    ENOMSG = 42,
+    /** Identifier removed */
+    EIDRM = 43,
+    /** Channel number out of range */
+    ECHRNG = 44,
+    /** Level 2 not synchronized */
+    EL2NSYNC = 45,
+    /** Level 3 halted */
+    EL3HLT = 46,
+    /** Level 3 reset */
+    EL3RST = 47,
+    /** Link number out of range */
+    ENRNG = 48,
+    /** Protocol driver not attached */
+    EUNATCH = 49,
+    /** No CSI structure available */
+    ECSI = 50,
+    /** Level 2 halted */
+    EL2HLT = 51,
+    /** Invalid exchange */
+    EBADE = 52,
+    /** Invalid request descriptor */
+    EBADR = 53,
+    /** Exchange full */
+    EXFULL = 54,
+    /** No anode */
+    ENOANO = 55,
+    /** Invalid request code */
+    EBADRQC = 56,
+    /** Invalid slot */
+    EBADSLT = 57,
+    /** Bad font file format */
+    EBFONT = 59,
+    /** Device not a stream */
+    ENOSTR = 60,
+    /** No data available */
+    ENODATA = 61,
+    /** Timer expired */
+    ETIME = 62,
+    /** Out of streams resources */
+    ENOSR = 63,
+    /** Machine is not on the network */
+    ENONET = 64,
+    /** Package not installed */
+    ENOPKG = 65,
+    /** Object is remote */
+    EREMOTE = 66,
+    /** Link has been severed */
+    ENOLINK = 67,
+    /** Advertise error */
+    EADV = 68,
+    /** Srmount error */
+    ESRMNT = 69,
+    /** Communication error on send */
+    ECOMM = 70,
+    /** Protocol error */
+    EPROTO = 71,
+    /** Multihop attempted */
+    EMULTIHOP = 72,
+    /** RFS specific error */
+    EDOTDOT = 73,
+    /** Bad message */
+    EBADMSG = 74,
+    /** Value too large for defined data type */
+    EOVERFLOW = 75,
+    /** Name not unique on network */
+    ENOTUNIQ = 76,
+    /** File descriptor in bad state */
+    EBADFD = 77,
+    /** Remote address changed */
+    EREMCHG = 78,
+    /** Can not access a needed shared library */
+    ELIBACC = 79,
+    /** Accessing a corrupted shared library */
+    ELIBBAD = 80,
+    /** .lib section in a.out corrupted */
+    ELIBSCN = 81,
+    /** Attempting to link in too many shared libraries */
+    ELIBMAX = 82,
+    /** Cannot exec a shared library directly */
+    ELIBEXEC = 83,
+    /** Invalid or incomplete multibyte or wide character */
+    EILSEQ = 84,
+    /** Interrupted system call should be restarted */
+    ERESTART = 85,
+    /** Streams pipe error */
+    ESTRPIPE = 86,
+    /** Too many users */
+    EUSERS = 87,
+    /** Socket operation on non-socket */
+    ENOTSOCK = 88,
+    /** Destination address required */
+    EDESTADDRREQ = 89,
+    /** Message too long */
+    EMSGSIZE = 90,
+    /** Protocol wrong type for socket */
+    EPROTOTYPE = 91,
+    /** Protocol not available */
+    ENOPROTOOPT = 92,
+    /** Protocol not supported */
+    EPROTONOSUPPORT = 93,
+    /** Socket type not supported */
+    ESOCKTNOSUPPORT = 94,
+    /** Operation is not supported */
+    ENOTSUP = 95,
+    /** Protocol family not supported */
+    EPFNOSUPPORT = 96,
+    /** Address family not supported by protocol */
+    EAFNOSUPPORT = 97,
+    /** Address already in use */
+    EADDRINUSE = 98,
+    /** Cannot assign requested address */
+    EADDRNOTAVAIL = 99,
+    /** Network is down */
+    ENETDOWN = 100,
+    /** Network is unreachable */
+    ENETUNREACH = 101,
+    /** Network dropped connection on reset */
+    ENETRESET = 102,
+    /** Software caused connection abort */
+    ECONNABORTED = 103,
+    /** Connection reset by peer */
+    ECONNRESET = 104,
+    /** No buffer space available */
+    ENOBUFS = 105,
+    /** Transport endpoint is already connected */
+    EISCONN = 106,
+    /** Transport endpoint is not connected */
+    ENOTCONN = 107,
+    /** Cannot send after transport endpoint shutdown */
+    ESHUTDOWN = 108,
+    /** Too many references: cannot splice */
+    ETOOMANYREFS = 109,
+    /** Connection timed out */
+    ETIMEDOUT = 110,
+    /** Connection refused */
+    ECONNREFUSED = 111,
+    /** Host is down */
+    EHOSTDOWN = 112,
+    /** No route to host */
+    EHOSTUNREACH = 113,
+    /** Operation already in progress */
+    EALREADY = 114,
+    /** Operation now in progress */
+    EINPROGRESS = 115,
+    /** Stale file handle */
+    ESTALE = 116,
+    /** Structure needs cleaning */
+    EEUCLEAN = 117,
+    /** Not a XENIX named type file */
+    ENOTNAM = 118,
+    /** No XENIX semaphores available */
+    ENAVAIL = 119,
+    /** Is a named type file */
+    EISNAM = 120,
+    /** Remote I/O error */
+    EREMOTEIO = 121,
+    /** Disk quota exceeded */
+    EDQUOT = 122,
+    /** No medium found */
+    ENOMEDIUM = 123,
+    /** Wrong medium type */
+    EMEDIUMTYPE = 124,
+    /** Operation canceled */
+    ECANCELED = 125,
+    /** Required key not available */
+    ENOKEY = 126,
+    /** Key has expired */
+    EKEYEXPIRED = 127,
+    /** Key has been revoked */
+    EKEYREVOKED = 128,
+    /** Key was rejected by service */
+    EKEYREJECTED = 129,
+    /** Owner died */
+    EOWNERDEAD = 130,
+    /** State not recoverable */
+    ENOTRECOVERABLE = 131,
+    /** Operation not possible due to RF-kill */
+    ERFKILL = 132,
+    /** Memory page has hardware error */
+    EHWPOISON = 133
+}
+/**
+ * Strings associated with each error code.
+ * @internal
+ */
+declare const errnoMessages: {
+    readonly 1: "Operation not permitted";
+    readonly 2: "No such file or directory";
+    readonly 3: "No such process";
+    readonly 4: "Interrupted system call";
+    readonly 5: "Input/output error";
+    readonly 6: "No such device or address";
+    readonly 7: "Argument list too long";
+    readonly 8: "Exec format error";
+    readonly 9: "Bad file descriptor";
+    readonly 10: "No child processes";
+    readonly 11: "Resource temporarily unavailable";
+    readonly 12: "Out of memory";
+    readonly 13: "Permission denied";
+    readonly 14: "Bad address";
+    readonly 15: "Block device required";
+    readonly 16: "Resource busy or locked";
+    readonly 17: "File exists";
+    readonly 18: "Invalid cross-device link";
+    readonly 19: "No such device";
+    readonly 20: "File is not a directory";
+    readonly 21: "File is a directory";
+    readonly 22: "Invalid argument";
+    readonly 23: "Too many open files in system";
+    readonly 24: "Too many open files";
+    readonly 26: "Text file busy";
+    readonly 27: "File is too big";
+    readonly 28: "No space left on disk";
+    readonly 29: "Illegal seek";
+    readonly 30: "Cannot modify a read-only file system";
+    readonly 31: "Too many links";
+    readonly 32: "Broken pipe";
+    readonly 33: "Numerical argument out of domain";
+    readonly 34: "Numerical result out of range";
+    readonly 35: "Resource deadlock would occur";
+    readonly 36: "File name too long";
+    readonly 37: "No locks available";
+    readonly 38: "Function not implemented";
+    readonly 39: "Directory is not empty";
+    readonly 40: "Too many levels of symbolic links";
+    readonly 42: "No message of desired type";
+    readonly 43: "Identifier removed";
+    readonly 44: "Channel number out of range";
+    readonly 45: "Level 2 not synchronized";
+    readonly 46: "Level 3 halted";
+    readonly 47: "Level 3 reset";
+    readonly 48: "Link number out of range";
+    readonly 49: "Protocol driver not attached";
+    readonly 50: "No CSI structure available";
+    readonly 51: "Level 2 halted";
+    readonly 52: "Invalid exchange";
+    readonly 53: "Invalid request descriptor";
+    readonly 54: "Exchange full";
+    readonly 55: "No anode";
+    readonly 56: "Invalid request code";
+    readonly 57: "Invalid slot";
+    readonly 59: "Bad font file format";
+    readonly 60: "Device not a stream";
+    readonly 61: "No data available";
+    readonly 62: "Timer expired";
+    readonly 63: "Out of streams resources";
+    readonly 64: "Machine is not on the network";
+    readonly 65: "Package not installed";
+    readonly 66: "Object is remote";
+    readonly 67: "Link has been severed";
+    readonly 68: "Advertise error";
+    readonly 69: "Srmount error";
+    readonly 70: "Communication error on send";
+    readonly 71: "Protocol error";
+    readonly 72: "Multihop attempted";
+    readonly 73: "RFS specific error";
+    readonly 74: "Bad message";
+    readonly 75: "Value too large for defined data type";
+    readonly 76: "Name not unique on network";
+    readonly 77: "File descriptor in bad state";
+    readonly 78: "Remote address changed";
+    readonly 79: "Can not access a needed shared library";
+    readonly 80: "Accessing a corrupted shared library";
+    readonly 81: ".lib section in a.out corrupted";
+    readonly 82: "Attempting to link in too many shared libraries";
+    readonly 83: "Cannot exec a shared library directly";
+    readonly 84: "Invalid or incomplete multibyte or wide character";
+    readonly 85: "Interrupted system call should be restarted";
+    readonly 86: "Streams pipe error";
+    readonly 87: "Too many users";
+    readonly 88: "Socket operation on non-socket";
+    readonly 89: "Destination address required";
+    readonly 90: "Message too long";
+    readonly 91: "Protocol wrong type for socket";
+    readonly 92: "Protocol not available";
+    readonly 93: "Protocol not supported";
+    readonly 94: "Socket type not supported";
+    readonly 95: "Operation is not supported";
+    readonly 96: "Protocol family not supported";
+    readonly 97: "Address family not supported by protocol";
+    readonly 98: "Address already in use";
+    readonly 99: "Cannot assign requested address";
+    readonly 100: "Network is down";
+    readonly 101: "Network is unreachable";
+    readonly 102: "Network dropped connection on reset";
+    readonly 103: "Software caused connection abort";
+    readonly 104: "Connection reset by peer";
+    readonly 105: "No buffer space available";
+    readonly 106: "Transport endpoint is already connected";
+    readonly 107: "Transport endpoint is not connected";
+    readonly 108: "Cannot send after transport endpoint shutdown";
+    readonly 109: "Too many references: cannot splice";
+    readonly 110: "Connection timed out";
+    readonly 111: "Connection refused";
+    readonly 112: "Host is down";
+    readonly 113: "No route to host";
+    readonly 114: "Operation already in progress";
+    readonly 115: "Operation now in progress";
+    readonly 116: "Stale file handle";
+    readonly 117: "Structure needs cleaning";
+    readonly 118: "Not a XENIX named type file";
+    readonly 119: "No XENIX semaphores available";
+    readonly 120: "Is a named type file";
+    readonly 121: "Remote I/O error";
+    readonly 122: "Disk quota exceeded";
+    readonly 123: "No medium found";
+    readonly 124: "Wrong medium type";
+    readonly 125: "Operation canceled";
+    readonly 126: "Required key not available";
+    readonly 127: "Key has expired";
+    readonly 128: "Key has been revoked";
+    readonly 129: "Key was rejected by service";
+    readonly 130: "Owner died";
+    readonly 131: "State not recoverable";
+    readonly 132: "Operation not possible due to RF-kill";
+    readonly 133: "Memory page has hardware error";
+};
+type ErrnoMessage<T extends Errno | keyof typeof Errno> = (typeof errnoMessages)[T extends Errno ? T : T extends keyof typeof Errno ? (typeof Errno)[T] : ''];
+export declare function strerror<const T extends Errno | keyof typeof Errno>(errno: T): ErrnoMessage<T>;
+/**
+ * JSON representation of an error.
+ */
+export interface ErrnoExceptionJSON {
+    errno: Errno;
+    message: string;
+    path?: string;
+    code: keyof typeof Errno;
+    stack: string;
+    syscall: string;
+}
+/**
+ * An error with additional information about what happened
+ */
+export declare class ErrnoException extends Error implements NodeJS.ErrnoException {
+    errno: Errno;
+    message: string;
+    syscall: string;
+    stack: string;
+    code: keyof typeof Errno;
+    constructor(errno: Errno, message?: string, syscall?: string);
+    toString(): string;
+    toJSON(): ErrnoExceptionJSON;
+    static fromJSON(json: ErrnoExceptionJSON): ErrnoException;
+    static With(code: keyof typeof Errno, syscall?: string): ErrnoException;
+}
+export {};

package/dist/error.js

@@ -0,0 +1,444 @@
+/**
+ * Standard POSIX error codes.
+ * @see https://en.wikipedia.org/wiki/Errno.h
+ */
+export var Errno;
+(function (Errno) {
+    /** Operation not permitted */
+    Errno[Errno["EPERM"] = 1] = "EPERM";
+    /** No such file or directory */
+    Errno[Errno["ENOENT"] = 2] = "ENOENT";
+    /** No such process */
+    Errno[Errno["ESRCH"] = 3] = "ESRCH";
+    /** Interrupted system call */
+    Errno[Errno["EINTR"] = 4] = "EINTR";
+    /** Input/output error */
+    Errno[Errno["EIO"] = 5] = "EIO";
+    /** No such device or address */
+    Errno[Errno["ENXIO"] = 6] = "ENXIO";
+    /** Argument list too long */
+    Errno[Errno["E2BIG"] = 7] = "E2BIG";
+    /** Exec format error */
+    Errno[Errno["ENOEXEC"] = 8] = "ENOEXEC";
+    /** Bad file descriptor */
+    Errno[Errno["EBADF"] = 9] = "EBADF";
+    /** No child processes */
+    Errno[Errno["ECHILD"] = 10] = "ECHILD";
+    /** Resource temporarily unavailable */
+    Errno[Errno["EAGAIN"] = 11] = "EAGAIN";
+    /** Out of memory */
+    Errno[Errno["ENOMEM"] = 12] = "ENOMEM";
+    /** Permission denied */
+    Errno[Errno["EACCES"] = 13] = "EACCES";
+    /** Bad address */
+    Errno[Errno["EFAULT"] = 14] = "EFAULT";
+    /** Block device required */
+    Errno[Errno["ENOTBLK"] = 15] = "ENOTBLK";
+    /** Resource busy or locked */
+    Errno[Errno["EBUSY"] = 16] = "EBUSY";
+    /** File exists */
+    Errno[Errno["EEXIST"] = 17] = "EEXIST";
+    /** Invalid cross-device link */
+    Errno[Errno["EXDEV"] = 18] = "EXDEV";
+    /** No such device */
+    Errno[Errno["ENODEV"] = 19] = "ENODEV";
+    /** File is not a directory */
+    Errno[Errno["ENOTDIR"] = 20] = "ENOTDIR";
+    /** File is a directory */
+    Errno[Errno["EISDIR"] = 21] = "EISDIR";
+    /** Invalid argument */
+    Errno[Errno["EINVAL"] = 22] = "EINVAL";
+    /** Too many open files in system */
+    Errno[Errno["ENFILE"] = 23] = "ENFILE";
+    /** Too many open files */
+    Errno[Errno["EMFILE"] = 24] = "EMFILE";
+    /** Text file busy */
+    Errno[Errno["ETXTBSY"] = 26] = "ETXTBSY";
+    /** File is too big */
+    Errno[Errno["EFBIG"] = 27] = "EFBIG";
+    /** No space left on disk */
+    Errno[Errno["ENOSPC"] = 28] = "ENOSPC";
+    /** Illegal seek */
+    Errno[Errno["ESPIPE"] = 29] = "ESPIPE";
+    /** Cannot modify a read-only file system */
+    Errno[Errno["EROFS"] = 30] = "EROFS";
+    /** Too many links */
+    Errno[Errno["EMLINK"] = 31] = "EMLINK";
+    /** Broken pipe */
+    Errno[Errno["EPIPE"] = 32] = "EPIPE";
+    /** Numerical argument out of domain */
+    Errno[Errno["EDOM"] = 33] = "EDOM";
+    /** Numerical result out of range */
+    Errno[Errno["ERANGE"] = 34] = "ERANGE";
+    /** Resource deadlock would occur */
+    Errno[Errno["EDEADLK"] = 35] = "EDEADLK";
+    /** File name too long */
+    Errno[Errno["ENAMETOOLONG"] = 36] = "ENAMETOOLONG";
+    /** No locks available */
+    Errno[Errno["ENOLCK"] = 37] = "ENOLCK";
+    /** Function not implemented */
+    Errno[Errno["ENOSYS"] = 38] = "ENOSYS";
+    /** Directory is not empty */
+    Errno[Errno["ENOTEMPTY"] = 39] = "ENOTEMPTY";
+    /** Too many levels of symbolic links */
+    Errno[Errno["ELOOP"] = 40] = "ELOOP";
+    /** No message of desired type */
+    Errno[Errno["ENOMSG"] = 42] = "ENOMSG";
+    /** Identifier removed */
+    Errno[Errno["EIDRM"] = 43] = "EIDRM";
+    /** Channel number out of range */
+    Errno[Errno["ECHRNG"] = 44] = "ECHRNG";
+    /** Level 2 not synchronized */
+    Errno[Errno["EL2NSYNC"] = 45] = "EL2NSYNC";
+    /** Level 3 halted */
+    Errno[Errno["EL3HLT"] = 46] = "EL3HLT";
+    /** Level 3 reset */
+    Errno[Errno["EL3RST"] = 47] = "EL3RST";
+    /** Link number out of range */
+    Errno[Errno["ENRNG"] = 48] = "ENRNG";
+    /** Protocol driver not attached */
+    Errno[Errno["EUNATCH"] = 49] = "EUNATCH";
+    /** No CSI structure available */
+    Errno[Errno["ECSI"] = 50] = "ECSI";
+    /** Level 2 halted */
+    Errno[Errno["EL2HLT"] = 51] = "EL2HLT";
+    /** Invalid exchange */
+    Errno[Errno["EBADE"] = 52] = "EBADE";
+    /** Invalid request descriptor */
+    Errno[Errno["EBADR"] = 53] = "EBADR";
+    /** Exchange full */
+    Errno[Errno["EXFULL"] = 54] = "EXFULL";
+    /** No anode */
+    Errno[Errno["ENOANO"] = 55] = "ENOANO";
+    /** Invalid request code */
+    Errno[Errno["EBADRQC"] = 56] = "EBADRQC";
+    /** Invalid slot */
+    Errno[Errno["EBADSLT"] = 57] = "EBADSLT";
+    /** Bad font file format */
+    Errno[Errno["EBFONT"] = 59] = "EBFONT";
+    /** Device not a stream */
+    Errno[Errno["ENOSTR"] = 60] = "ENOSTR";
+    /** No data available */
+    Errno[Errno["ENODATA"] = 61] = "ENODATA";
+    /** Timer expired */
+    Errno[Errno["ETIME"] = 62] = "ETIME";
+    /** Out of streams resources */
+    Errno[Errno["ENOSR"] = 63] = "ENOSR";
+    /** Machine is not on the network */
+    Errno[Errno["ENONET"] = 64] = "ENONET";
+    /** Package not installed */
+    Errno[Errno["ENOPKG"] = 65] = "ENOPKG";
+    /** Object is remote */
+    Errno[Errno["EREMOTE"] = 66] = "EREMOTE";
+    /** Link has been severed */
+    Errno[Errno["ENOLINK"] = 67] = "ENOLINK";
+    /** Advertise error */
+    Errno[Errno["EADV"] = 68] = "EADV";
+    /** Srmount error */
+    Errno[Errno["ESRMNT"] = 69] = "ESRMNT";
+    /** Communication error on send */
+    Errno[Errno["ECOMM"] = 70] = "ECOMM";
+    /** Protocol error */
+    Errno[Errno["EPROTO"] = 71] = "EPROTO";
+    /** Multihop attempted */
+    Errno[Errno["EMULTIHOP"] = 72] = "EMULTIHOP";
+    /** RFS specific error */
+    Errno[Errno["EDOTDOT"] = 73] = "EDOTDOT";
+    /** Bad message */
+    Errno[Errno["EBADMSG"] = 74] = "EBADMSG";
+    /** Value too large for defined data type */
+    Errno[Errno["EOVERFLOW"] = 75] = "EOVERFLOW";
+    /** Name not unique on network */
+    Errno[Errno["ENOTUNIQ"] = 76] = "ENOTUNIQ";
+    /** File descriptor in bad state */
+    Errno[Errno["EBADFD"] = 77] = "EBADFD";
+    /** Remote address changed */
+    Errno[Errno["EREMCHG"] = 78] = "EREMCHG";
+    /** Can not access a needed shared library */
+    Errno[Errno["ELIBACC"] = 79] = "ELIBACC";
+    /** Accessing a corrupted shared library */
+    Errno[Errno["ELIBBAD"] = 80] = "ELIBBAD";
+    /** .lib section in a.out corrupted */
+    Errno[Errno["ELIBSCN"] = 81] = "ELIBSCN";
+    /** Attempting to link in too many shared libraries */
+    Errno[Errno["ELIBMAX"] = 82] = "ELIBMAX";
+    /** Cannot exec a shared library directly */
+    Errno[Errno["ELIBEXEC"] = 83] = "ELIBEXEC";
+    /** Invalid or incomplete multibyte or wide character */
+    Errno[Errno["EILSEQ"] = 84] = "EILSEQ";
+    /** Interrupted system call should be restarted */
+    Errno[Errno["ERESTART"] = 85] = "ERESTART";
+    /** Streams pipe error */
+    Errno[Errno["ESTRPIPE"] = 86] = "ESTRPIPE";
+    /** Too many users */
+    Errno[Errno["EUSERS"] = 87] = "EUSERS";
+    /** Socket operation on non-socket */
+    Errno[Errno["ENOTSOCK"] = 88] = "ENOTSOCK";
+    /** Destination address required */
+    Errno[Errno["EDESTADDRREQ"] = 89] = "EDESTADDRREQ";
+    /** Message too long */
+    Errno[Errno["EMSGSIZE"] = 90] = "EMSGSIZE";
+    /** Protocol wrong type for socket */
+    Errno[Errno["EPROTOTYPE"] = 91] = "EPROTOTYPE";
+    /** Protocol not available */
+    Errno[Errno["ENOPROTOOPT"] = 92] = "ENOPROTOOPT";
+    /** Protocol not supported */
+    Errno[Errno["EPROTONOSUPPORT"] = 93] = "EPROTONOSUPPORT";
+    /** Socket type not supported */
+    Errno[Errno["ESOCKTNOSUPPORT"] = 94] = "ESOCKTNOSUPPORT";
+    /** Operation is not supported */
+    Errno[Errno["ENOTSUP"] = 95] = "ENOTSUP";
+    /** Protocol family not supported */
+    Errno[Errno["EPFNOSUPPORT"] = 96] = "EPFNOSUPPORT";
+    /** Address family not supported by protocol */
+    Errno[Errno["EAFNOSUPPORT"] = 97] = "EAFNOSUPPORT";
+    /** Address already in use */
+    Errno[Errno["EADDRINUSE"] = 98] = "EADDRINUSE";
+    /** Cannot assign requested address */
+    Errno[Errno["EADDRNOTAVAIL"] = 99] = "EADDRNOTAVAIL";
+    /** Network is down */
+    Errno[Errno["ENETDOWN"] = 100] = "ENETDOWN";
+    /** Network is unreachable */
+    Errno[Errno["ENETUNREACH"] = 101] = "ENETUNREACH";
+    /** Network dropped connection on reset */
+    Errno[Errno["ENETRESET"] = 102] = "ENETRESET";
+    /** Software caused connection abort */
+    Errno[Errno["ECONNABORTED"] = 103] = "ECONNABORTED";
+    /** Connection reset by peer */
+    Errno[Errno["ECONNRESET"] = 104] = "ECONNRESET";
+    /** No buffer space available */
+    Errno[Errno["ENOBUFS"] = 105] = "ENOBUFS";
+    /** Transport endpoint is already connected */
+    Errno[Errno["EISCONN"] = 106] = "EISCONN";
+    /** Transport endpoint is not connected */
+    Errno[Errno["ENOTCONN"] = 107] = "ENOTCONN";
+    /** Cannot send after transport endpoint shutdown */
+    Errno[Errno["ESHUTDOWN"] = 108] = "ESHUTDOWN";
+    /** Too many references: cannot splice */
+    Errno[Errno["ETOOMANYREFS"] = 109] = "ETOOMANYREFS";
+    /** Connection timed out */
+    Errno[Errno["ETIMEDOUT"] = 110] = "ETIMEDOUT";
+    /** Connection refused */
+    Errno[Errno["ECONNREFUSED"] = 111] = "ECONNREFUSED";
+    /** Host is down */
+    Errno[Errno["EHOSTDOWN"] = 112] = "EHOSTDOWN";
+    /** No route to host */
+    Errno[Errno["EHOSTUNREACH"] = 113] = "EHOSTUNREACH";
+    /** Operation already in progress */
+    Errno[Errno["EALREADY"] = 114] = "EALREADY";
+    /** Operation now in progress */
+    Errno[Errno["EINPROGRESS"] = 115] = "EINPROGRESS";
+    /** Stale file handle */
+    Errno[Errno["ESTALE"] = 116] = "ESTALE";
+    /** Structure needs cleaning */
+    Errno[Errno["EEUCLEAN"] = 117] = "EEUCLEAN";
+    /** Not a XENIX named type file */
+    Errno[Errno["ENOTNAM"] = 118] = "ENOTNAM";
+    /** No XENIX semaphores available */
+    Errno[Errno["ENAVAIL"] = 119] = "ENAVAIL";
+    /** Is a named type file */
+    Errno[Errno["EISNAM"] = 120] = "EISNAM";
+    /** Remote I/O error */
+    Errno[Errno["EREMOTEIO"] = 121] = "EREMOTEIO";
+    /** Disk quota exceeded */
+    Errno[Errno["EDQUOT"] = 122] = "EDQUOT";
+    /** No medium found */
+    Errno[Errno["ENOMEDIUM"] = 123] = "ENOMEDIUM";
+    /** Wrong medium type */
+    Errno[Errno["EMEDIUMTYPE"] = 124] = "EMEDIUMTYPE";
+    /** Operation canceled */
+    Errno[Errno["ECANCELED"] = 125] = "ECANCELED";
+    /** Required key not available */
+    Errno[Errno["ENOKEY"] = 126] = "ENOKEY";
+    /** Key has expired */
+    Errno[Errno["EKEYEXPIRED"] = 127] = "EKEYEXPIRED";
+    /** Key has been revoked */
+    Errno[Errno["EKEYREVOKED"] = 128] = "EKEYREVOKED";
+    /** Key was rejected by service */
+    Errno[Errno["EKEYREJECTED"] = 129] = "EKEYREJECTED";
+    /** Owner died */
+    Errno[Errno["EOWNERDEAD"] = 130] = "EOWNERDEAD";
+    /** State not recoverable */
+    Errno[Errno["ENOTRECOVERABLE"] = 131] = "ENOTRECOVERABLE";
+    /** Operation not possible due to RF-kill */
+    Errno[Errno["ERFKILL"] = 132] = "ERFKILL";
+    /** Memory page has hardware error */
+    Errno[Errno["EHWPOISON"] = 133] = "EHWPOISON";
+})(Errno || (Errno = {}));
+/**
+ * Strings associated with each error code.
+ * @internal
+ */
+const errnoMessages = {
+    [Errno.EPERM]: 'Operation not permitted',
+    [Errno.ENOENT]: 'No such file or directory',
+    [Errno.ESRCH]: 'No such process',
+    [Errno.EINTR]: 'Interrupted system call',
+    [Errno.EIO]: 'Input/output error',
+    [Errno.ENXIO]: 'No such device or address',
+    [Errno.E2BIG]: 'Argument list too long',
+    [Errno.ENOEXEC]: 'Exec format error',
+    [Errno.EBADF]: 'Bad file descriptor',
+    [Errno.ECHILD]: 'No child processes',
+    [Errno.EAGAIN]: 'Resource temporarily unavailable',
+    [Errno.ENOMEM]: 'Out of memory',
+    [Errno.EACCES]: 'Permission denied',
+    [Errno.EFAULT]: 'Bad address',
+    [Errno.ENOTBLK]: 'Block device required',
+    [Errno.EBUSY]: 'Resource busy or locked',
+    [Errno.EEXIST]: 'File exists',
+    [Errno.EXDEV]: 'Invalid cross-device link',
+    [Errno.ENODEV]: 'No such device',
+    [Errno.ENOTDIR]: 'File is not a directory',
+    [Errno.EISDIR]: 'File is a directory',
+    [Errno.EINVAL]: 'Invalid argument',
+    [Errno.ENFILE]: 'Too many open files in system',
+    [Errno.EMFILE]: 'Too many open files',
+    [Errno.ETXTBSY]: 'Text file busy',
+    [Errno.EFBIG]: 'File is too big',
+    [Errno.ENOSPC]: 'No space left on disk',
+    [Errno.ESPIPE]: 'Illegal seek',
+    [Errno.EROFS]: 'Cannot modify a read-only file system',
+    [Errno.EMLINK]: 'Too many links',
+    [Errno.EPIPE]: 'Broken pipe',
+    [Errno.EDOM]: 'Numerical argument out of domain',
+    [Errno.ERANGE]: 'Numerical result out of range',
+    [Errno.EDEADLK]: 'Resource deadlock would occur',
+    [Errno.ENAMETOOLONG]: 'File name too long',
+    [Errno.ENOLCK]: 'No locks available',
+    [Errno.ENOSYS]: 'Function not implemented',
+    [Errno.ENOTEMPTY]: 'Directory is not empty',
+    [Errno.ELOOP]: 'Too many levels of symbolic links',
+    [Errno.ENOMSG]: 'No message of desired type',
+    [Errno.EIDRM]: 'Identifier removed',
+    [Errno.ECHRNG]: 'Channel number out of range',
+    [Errno.EL2NSYNC]: 'Level 2 not synchronized',
+    [Errno.EL3HLT]: 'Level 3 halted',
+    [Errno.EL3RST]: 'Level 3 reset',
+    [Errno.ENRNG]: 'Link number out of range',
+    [Errno.EUNATCH]: 'Protocol driver not attached',
+    [Errno.ECSI]: 'No CSI structure available',
+    [Errno.EL2HLT]: 'Level 2 halted',
+    [Errno.EBADE]: 'Invalid exchange',
+    [Errno.EBADR]: 'Invalid request descriptor',
+    [Errno.EXFULL]: 'Exchange full',
+    [Errno.ENOANO]: 'No anode',
+    [Errno.EBADRQC]: 'Invalid request code',
+    [Errno.EBADSLT]: 'Invalid slot',
+    [Errno.EBFONT]: 'Bad font file format',
+    [Errno.ENOSTR]: 'Device not a stream',
+    [Errno.ENODATA]: 'No data available',
+    [Errno.ETIME]: 'Timer expired',
+    [Errno.ENOSR]: 'Out of streams resources',
+    [Errno.ENONET]: 'Machine is not on the network',
+    [Errno.ENOPKG]: 'Package not installed',
+    [Errno.EREMOTE]: 'Object is remote',
+    [Errno.ENOLINK]: 'Link has been severed',
+    [Errno.EADV]: 'Advertise error',
+    [Errno.ESRMNT]: 'Srmount error',
+    [Errno.ECOMM]: 'Communication error on send',
+    [Errno.EPROTO]: 'Protocol error',
+    [Errno.EMULTIHOP]: 'Multihop attempted',
+    [Errno.EDOTDOT]: 'RFS specific error',
+    [Errno.EBADMSG]: 'Bad message',
+    [Errno.EOVERFLOW]: 'Value too large for defined data type',
+    [Errno.ENOTUNIQ]: 'Name not unique on network',
+    [Errno.EBADFD]: 'File descriptor in bad state',
+    [Errno.EREMCHG]: 'Remote address changed',
+    [Errno.ELIBACC]: 'Can not access a needed shared library',
+    [Errno.ELIBBAD]: 'Accessing a corrupted shared library',
+    [Errno.ELIBSCN]: '.lib section in a.out corrupted',
+    [Errno.ELIBMAX]: 'Attempting to link in too many shared libraries',
+    [Errno.ELIBEXEC]: 'Cannot exec a shared library directly',
+    [Errno.EILSEQ]: 'Invalid or incomplete multibyte or wide character',
+    [Errno.ERESTART]: 'Interrupted system call should be restarted',
+    [Errno.ESTRPIPE]: 'Streams pipe error',
+    [Errno.EUSERS]: 'Too many users',
+    [Errno.ENOTSOCK]: 'Socket operation on non-socket',
+    [Errno.EDESTADDRREQ]: 'Destination address required',
+    [Errno.EMSGSIZE]: 'Message too long',
+    [Errno.EPROTOTYPE]: 'Protocol wrong type for socket',
+    [Errno.ENOPROTOOPT]: 'Protocol not available',
+    [Errno.EPROTONOSUPPORT]: 'Protocol not supported',
+    [Errno.ESOCKTNOSUPPORT]: 'Socket type not supported',
+    [Errno.ENOTSUP]: 'Operation is not supported',
+    [Errno.EPFNOSUPPORT]: 'Protocol family not supported',
+    [Errno.EAFNOSUPPORT]: 'Address family not supported by protocol',
+    [Errno.EADDRINUSE]: 'Address already in use',
+    [Errno.EADDRNOTAVAIL]: 'Cannot assign requested address',
+    [Errno.ENETDOWN]: 'Network is down',
+    [Errno.ENETUNREACH]: 'Network is unreachable',
+    [Errno.ENETRESET]: 'Network dropped connection on reset',
+    [Errno.ECONNABORTED]: 'Software caused connection abort',
+    [Errno.ECONNRESET]: 'Connection reset by peer',
+    [Errno.ENOBUFS]: 'No buffer space available',
+    [Errno.EISCONN]: 'Transport endpoint is already connected',
+    [Errno.ENOTCONN]: 'Transport endpoint is not connected',
+    [Errno.ESHUTDOWN]: 'Cannot send after transport endpoint shutdown',
+    [Errno.ETOOMANYREFS]: 'Too many references: cannot splice',
+    [Errno.ETIMEDOUT]: 'Connection timed out',
+    [Errno.ECONNREFUSED]: 'Connection refused',
+    [Errno.EHOSTDOWN]: 'Host is down',
+    [Errno.EHOSTUNREACH]: 'No route to host',
+    [Errno.EALREADY]: 'Operation already in progress',
+    [Errno.EINPROGRESS]: 'Operation now in progress',
+    [Errno.ESTALE]: 'Stale file handle',
+    [Errno.EEUCLEAN]: 'Structure needs cleaning',
+    [Errno.ENOTNAM]: 'Not a XENIX named type file',
+    [Errno.ENAVAIL]: 'No XENIX semaphores available',
+    [Errno.EISNAM]: 'Is a named type file',
+    [Errno.EREMOTEIO]: 'Remote I/O error',
+    [Errno.EDQUOT]: 'Disk quota exceeded',
+    [Errno.ENOMEDIUM]: 'No medium found',
+    [Errno.EMEDIUMTYPE]: 'Wrong medium type',
+    [Errno.ECANCELED]: 'Operation canceled',
+    [Errno.ENOKEY]: 'Required key not available',
+    [Errno.EKEYEXPIRED]: 'Key has expired',
+    [Errno.EKEYREVOKED]: 'Key has been revoked',
+    [Errno.EKEYREJECTED]: 'Key was rejected by service',
+    [Errno.EOWNERDEAD]: 'Owner died',
+    [Errno.ENOTRECOVERABLE]: 'State not recoverable',
+    [Errno.ERFKILL]: 'Operation not possible due to RF-kill',
+    [Errno.EHWPOISON]: 'Memory page has hardware error',
+};
+export function strerror(errno) {
+    const _errno = typeof errno == 'string' ? Errno[errno] : errno;
+    return (_errno in errnoMessages ? errnoMessages[_errno] : '');
+}
+/**
+ * An error with additional information about what happened
+ */
+export class ErrnoException extends Error {
+    errno;
+    message;
+    syscall;
+    code;
+    constructor(errno, message = errnoMessages[errno], syscall = '') {
+        super(message);
+        this.errno = errno;
+        this.message = message;
+        this.syscall = syscall;
+        this.code = Errno[errno];
+    }
+    toString() {
+        return this.code + ': ' + this.message;
+    }
+    toJSON() {
+        return {
+            errno: this.errno,
+            code: this.code,
+            stack: this.stack,
+            message: this.message,
+            syscall: this.syscall,
+        };
+    }
+    static fromJSON(json) {
+        const err = new ErrnoException(json.errno, json.message, json.syscall);
+        err.code = json.code;
+        err.stack = json.stack;
+        return err;
+    }
+    static With(code, syscall) {
+        return new ErrnoException(Errno[code], errnoMessages[Errno[code]], syscall);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './error.js';
+export * as log from './log.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './error.js';
+export * as log from './log.js';

package/dist/log.d.ts

@@ -0,0 +1,129 @@
+import { List } from 'utilium';
+/**
+ * The log levels
+ */
+export declare const enum Level {
+    /** Emergency */
+    EMERG = 0,
+    /** Alert */
+    ALERT = 1,
+    /** Critical */
+    CRIT = 2,
+    /** Error */
+    ERR = 3,
+    /** Warning */
+    WARN = 4,
+    /** Notice */
+    NOTICE = 5,
+    /** Informational */
+    INFO = 6,
+    /** Debug */
+    DEBUG = 7
+}
+/** An object mapping log levels to a textual representation of them */
+export declare const levels: readonly ["emergency", "alert", "critical", "error", "warning", "notice", "info", "debug"];
+export declare function levelOf(value: (typeof levels)[Level]): Level;
+/** A log entry */
+export interface Entry {
+    level: Level;
+    timestamp: Date;
+    elapsedMs: number;
+    message: string;
+}
+/** The list of log entries */
+export declare const entries: List<Entry>;
+/**
+ * Log a message
+ */
+export declare function log(level: Level, message: string): void;
+/** Shortcut for logging emergencies */
+export declare const emerg: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging alerts */
+export declare const alert: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging critical errors */
+export declare const crit: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging non-critical errors */
+export declare const err: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging warnings */
+export declare const warn: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging notices */
+export declare const notice: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging informational messages */
+export declare const info: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/** Shortcut for logging debug messages */
+export declare const debug: <T extends {
+    toString(): string;
+} | Error>(message: T) => T;
+/**
+ * Shortcut for logging usage of deprecated functions at runtime
+ * @param symbol The thing that is deprecated
+ */
+export declare function deprecated(symbol: string): void;
+export interface FormatOptions {
+    /**
+     * Whether to use ANSI escape codes (e.g. for Xterm) or CSS (for browsers) to colorize the log
+     */
+    style: 'ansi' | 'css';
+    /**
+     * How to colorize the message:
+     * - `level`: Colorize the level.
+     * - `message`: Colorize the message. For EMERG and ALERT, the level is also included.
+     */
+    colorize: 'level' | 'message';
+}
+/**
+ * Various format functions included to make using the logger easier.
+ * These are not the only formats you can use.
+ */
+export declare function fancy({ style, colorize }: FormatOptions): (entry: Entry) => Generator<string, void, unknown>;
+export declare function format(entry: Entry): string[];
+/** Whether log entries are being recorded */
+export declare let isEnabled: boolean;
+export interface Configuration {
+    /**
+     * If false, log messages will not be recorded or outputted
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * The minimum level needed to output a message
+     * @default Level.ALERT
+     */
+    level?: Level | (typeof levels)[Level];
+    /**
+     * Whether to include stack traces.
+     * @default false
+     */
+    stack?: boolean;
+    /**
+     * Formats a log entry into a string
+     * @default `[${ms / 1000}] ${message}`
+     */
+    format?(this: void, entry: Entry): string | Iterable<string>;
+    /**
+     * Outputs a log message
+     * @default console.error()
+     */
+    output?(this: void, ...message: string[]): unknown;
+    /**
+     * If set, output() all current entries after `configure` is done
+     * @default false
+     */
+    dumpBacklog?: boolean;
+}
+/** Configure logging behavior */
+export declare function configure(options: Configuration): void;

package/dist/log.js

@@ -0,0 +1,176 @@
+/* Logging utilities. The things in this file are named to work nicely when you import as a namespace. */
+import { List } from 'utilium';
+/** An object mapping log levels to a textual representation of them */
+export const levels = [
+    'emergency',
+    'alert',
+    'critical',
+    'error',
+    'warning',
+    'notice',
+    'info',
+    'debug',
+];
+export function levelOf(value) {
+    return levels.indexOf(value);
+}
+/** The list of log entries */
+export const entries = new List();
+/**
+ * Log a message
+ */
+export function log(level, message) {
+    if (!isEnabled)
+        return;
+    const entry = {
+        level,
+        message,
+        timestamp: new Date(),
+        elapsedMs: performance.now(),
+    };
+    entries.add(entry);
+    output(entry);
+}
+function _shortcut(level) {
+    return function (message) {
+        log(level, message.toString());
+        return message;
+    };
+}
+// Shortcuts
+/** Shortcut for logging emergencies */
+export const emerg = _shortcut(0 /* Level.EMERG */);
+/** Shortcut for logging alerts */
+export const alert = _shortcut(1 /* Level.ALERT */);
+/** Shortcut for logging critical errors */
+export const crit = _shortcut(2 /* Level.CRIT */);
+/** Shortcut for logging non-critical errors */
+export const err = _shortcut(3 /* Level.ERR */);
+/** Shortcut for logging warnings */
+export const warn = _shortcut(4 /* Level.WARN */);
+/** Shortcut for logging notices */
+export const notice = _shortcut(5 /* Level.NOTICE */);
+/** Shortcut for logging informational messages */
+export const info = _shortcut(6 /* Level.INFO */);
+/** Shortcut for logging debug messages */
+export const debug = _shortcut(7 /* Level.DEBUG */);
+/**
+ * Shortcut for logging usage of deprecated functions at runtime
+ * @param symbol The thing that is deprecated
+ */
+export function deprecated(symbol) {
+    log(4 /* Level.WARN */, symbol + ' is deprecated and should not be used.');
+}
+// Formatting and output
+function ansi(text, format) {
+    return `\x1b[${format}m${text}\x1b[0m`;
+}
+function _prettyMs(entry, style) {
+    const text = '[' + (entry.elapsedMs / 1000).toFixed(3).padStart(10) + '] ';
+    switch (style) {
+        case 'ansi':
+            return [ansi(text, '2;37')];
+        case 'css':
+            return ['%c' + text, 'opacity: 0.8; color: white;'];
+        default:
+            return [text];
+    }
+}
+const levelColor = {
+    ansi: {
+        [0 /* Level.EMERG */]: '1;4;37;41',
+        [1 /* Level.ALERT */]: '1;37;41',
+        [2 /* Level.CRIT */]: '1;35',
+        [3 /* Level.ERR */]: '1;31',
+        [4 /* Level.WARN */]: '1;33',
+        [5 /* Level.NOTICE */]: '1;36',
+        [6 /* Level.INFO */]: '1;37',
+        [7 /* Level.DEBUG */]: '0;2;37',
+    },
+    css: {
+        [0 /* Level.EMERG */]: 'font-weight: bold; text-decoration: underline; color: white; background-color: red;',
+        [1 /* Level.ALERT */]: 'font-weight: bold; color: white; background-color: red;',
+        [2 /* Level.CRIT */]: 'font-weight: bold; color: magenta;',
+        [3 /* Level.ERR */]: 'font-weight: bold; color: red;',
+        [4 /* Level.WARN */]: 'font-weight: bold; color: yellow;',
+        [5 /* Level.NOTICE */]: 'font-weight: bold; color: cyan;',
+        [6 /* Level.INFO */]: 'font-weight: bold; color: white;',
+        [7 /* Level.DEBUG */]: 'opacity: 0.8; color: white;',
+    },
+};
+const messageColor = {
+    ansi: {
+        [0 /* Level.EMERG */]: '1;31',
+        [1 /* Level.ALERT */]: '1;31',
+        [2 /* Level.CRIT */]: '1;31',
+        [3 /* Level.ERR */]: '31',
+        [4 /* Level.WARN */]: '33',
+        [5 /* Level.NOTICE */]: '1;37',
+        [6 /* Level.INFO */]: '37',
+        [7 /* Level.DEBUG */]: '2;37',
+    },
+    css: {
+        [0 /* Level.EMERG */]: 'font-weight: bold; color: red;',
+        [1 /* Level.ALERT */]: 'font-weight: bold; color: red;',
+        [2 /* Level.CRIT */]: 'font-weight: bold; color: red;',
+        [3 /* Level.ERR */]: 'color: red;',
+        [4 /* Level.WARN */]: 'color: yellow;',
+        [5 /* Level.NOTICE */]: 'font-weight: bold; color: white;',
+        [6 /* Level.INFO */]: 'color: white;',
+        [7 /* Level.DEBUG */]: 'opacity: 0.8; color: white;',
+    },
+};
+/**
+ * Various format functions included to make using the logger easier.
+ * These are not the only formats you can use.
+ */
+export function fancy({ style, colorize }) {
+    return function* (entry) {
+        yield* _prettyMs(entry, style);
+        const levelText = style == 'ansi'
+            ? [ansi(levels[entry.level].toUpperCase(), levelColor.ansi[entry.level])]
+            : ['%c' + levels[entry.level].toUpperCase(), levelColor.css[entry.level]];
+        if (colorize == 'level') {
+            yield* levelText;
+            yield entry.message;
+            return;
+        }
+        if (entry.level < 2 /* Level.CRIT */) {
+            yield* levelText;
+            yield ': ';
+        }
+        if (colorize == 'message')
+            yield ansi(entry.message, messageColor.ansi[entry.level]);
+        else
+            yield* ['%c' + entry.message, messageColor.css[entry.level]];
+    };
+}
+let _format = (entry) => [..._prettyMs(entry), entry.message];
+export function format(entry) {
+    const formatted = _format(entry);
+    return typeof formatted == 'string' ? [formatted] : Array.from(formatted);
+}
+let _output = console.error;
+function output(entry) {
+    if (entry.level > minLevel)
+        return;
+    _output(...format(entry));
+}
+let minLevel = 1 /* Level.ALERT */;
+let includeStack = false;
+// Configuration
+/** Whether log entries are being recorded */
+export let isEnabled = true;
+/** Configure logging behavior */
+export function configure(options) {
+    _format = options.format ?? _format;
+    _output = options.output ?? _output;
+    minLevel = typeof options.level == 'string' ? levelOf(options.level) : (options.level ?? minLevel);
+    isEnabled = options.enabled ?? isEnabled;
+    includeStack = options.stack ?? includeStack;
+    if (!options.dumpBacklog)
+        return;
+    for (const entry of entries) {
+        output(entry);
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+	"name": "kerium",
+	"version": "0.1.0",
+	"description": "POSIX-style errors, logging, and more",
+	"author": "James Prevett <jp@jamespre.dev> (https://jamespre.dev)",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/james-pre/kerium.git"
+	},
+	"funding": {
+		"type": "individual",
+		"url": "https://github.com/sponsors/james-pre"
+	},
+	"homepage": "https://github.com/james-pre/kerium#readme",
+	"bugs": {
+		"url": "https://github.com/james-pre/kerium/issues"
+	},
+	"license": "MIT",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"format:check": "prettier --check .",
+		"format": "prettier --write .",
+		"lint": "tsc --noEmit && eslint src",
+		"test": "tsx --test",
+		"prepublishOnly": "npx tsc"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.12.0",
+		"@types/node": "^20.12.7",
+		"eslint": "^9.12.0",
+		"prettier": "^3.2.5",
+		"tsx": "^4.19.1",
+		"typedoc": "^0.27.6",
+		"typescript": "^5.7.2",
+		"typescript-eslint": "^8.8.0"
+	},
+	"dependencies": {
+		"utilium": "^2.0.0"
+	}
+}