@mailwoman/core 2.0.6 → 2.2.0

package/out/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA"}

package/out/lifecycle/lru-cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   LRU cache utilities.
+ */
+import { LRUCache } from "lru-cache";
+export interface AsyncDisposableLRUCacheOptions {
+    max: number;
+    displayName?: string;
+}
+/**
+ * An LRU cache that automatically disposes of its values when they are evicted.
+ */
+export declare class AsyncDisposableLRUCache<K extends object, V extends AsyncDisposable> extends LRUCache<K, V> implements AsyncDisposable {
+    readonly displayName: string;
+    constructor({ max, displayName }: AsyncDisposableLRUCacheOptions);
+    [Symbol.asyncDispose](): Promise<void>;
+    toString(): string;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/out/lifecycle/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../lifecycle/lru-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,MAAM,WAAW,8BAA8B;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,qBAAa,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,eAAe,CAC/E,SAAQ,QAAQ,CAAC,CAAC,EAAE,CAAC,CACrB,YAAW,eAAe;IAE1B,SAAgB,WAAW,EAAE,MAAM,CAAA;gBAEvB,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,8BAA8B;IASnD,CAAC,MAAM,CAAC,YAAY,CAAC;IAOlB,QAAQ;CAGxB"}

package/out/lifecycle/lru-cache.js

@@ -0,0 +1,31 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   LRU cache utilities.
+ */
+import { LRUCache } from "lru-cache";
+/**
+ * An LRU cache that automatically disposes of its values when they are evicted.
+ */
+export class AsyncDisposableLRUCache extends LRUCache {
+    displayName;
+    constructor({ max, displayName }) {
+        super({
+            max,
+            dispose: (value) => value[Symbol.asyncDispose](),
+        });
+        this.displayName = displayName ?? "cache";
+    }
+    async [Symbol.asyncDispose]() {
+        for (const [key, value] of this.entries()) {
+            await value[Symbol.asyncDispose]();
+            this.delete(key);
+        }
+    }
+    toString() {
+        return `Async LRU ${this.displayName}`;
+    }
+}
+//# sourceMappingURL=lru-cache.js.map

package/out/lifecycle/lru-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.js","sourceRoot":"","sources":["../../lifecycle/lru-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAOpC;;GAEG;AACH,MAAM,OAAO,uBACZ,SAAQ,QAAc;IAGN,WAAW,CAAQ;IAEnC,YAAY,EAAE,GAAG,EAAE,WAAW,EAAkC;QAC/D,KAAK,CAAC;YACL,GAAG;YACH,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;SAChD,CAAC,CAAA;QAEF,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,OAAO,CAAA;IAC1C,CAAC;IAEM,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;IACF,CAAC;IAEe,QAAQ;QACvB,OAAO,aAAa,IAAI,CAAC,WAAW,EAAE,CAAA;IACvC,CAAC;CACD"}

package/out/lifecycle/services.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for creating branded nominal types.
+ */
+/**
+ * Type definition for a class which implements the AsyncDisposable interface.
+ *
+ * @category Utilities
+ * @internal
+ */
+export type ServiceConstructor<T> = new (...args: any[]) => T & AsyncDisposable;
+/**
+ * Type-predicate to determine if a given input is a ServiceConstructor, i.e. a function which is a
+ * constructor for a class which implements the AsyncDisposable interface.
+ */
+export declare function isServiceConstructor<T>(input: unknown): input is ServiceConstructor<T>;
+/**
+ * Stateful context for a service registry.
+ *
+ * This is used to provide a context for services during resolution.
+ */
+export interface ServiceRegistryContext {
+    abortController: AbortController;
+}
+/**
+ * Type definition for a function which returns an instance which implements the AsyncDisposable
+ * interface.
+ *
+ * @category Utilities
+ * @internal
+ */
+export type ServiceCallback<T extends AsyncDisposable> = {
+    (context: ServiceRegistryContext): Promise<T> | T;
+};
+export type ServiceResolver<T extends AsyncDisposable = AsyncDisposable> = T | ServiceCallback<T> | ServiceConstructor<T>;
+declare const kInstance: unique symbol;
+declare const kResolver: unique symbol;
+declare const kRegistryMap: unique symbol;
+/**
+ * Given a service which may not yet be resolved, intercept any method calls and resolve the service
+ * before invoking the method.
+ *
+ * @category Services
+ */
+export type ServiceMethodResolver<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : T[K];
+};
+/**
+ * Promise-like wrapper for asynchronous services.
+ *
+ * @see {@linkcode ServiceRepository} for usage.
+ */
+export declare class Service<T extends AsyncDisposable = AsyncDisposable> implements PromiseLike<T>, AsyncDisposable {
+    /**
+     * Instance of the service.
+     *
+     * @internal
+     */
+    [kInstance]: T | null;
+    /**
+     * Resolver for the service.
+     *
+     * @internal
+     */
+    [kResolver]?: ServiceResolver<T>;
+    /**
+     * Context for the parent service registry.
+     */
+    readonly context: ServiceRegistryContext;
+    protected constructor(resolver: ServiceResolver<T>);
+    /**
+     * Given an instance of a service, attach it to the resolver.
+     *
+     * This can be used to attach a service that was created outside of the resolver, such as when a
+     * resolver is defined from a TypeScript interface.
+     *
+     * @internal
+     */
+    attach(service: T): void;
+    /**
+     * Resolve the service instance.
+     *
+     * This method is called implicitly when the service is awaited.
+     */
+    protected resolve(): Promise<T>;
+    /**
+     * Resolve the service instance. Called implicitly when the service is awaited.
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Service repository for managing asynchronous services.
+ *
+ * @singleton
+ */
+export declare class ServiceRepository extends Service<AsyncDisposable> {
+    static readonly [kRegistryMap]: Map<any, Service<any>>;
+    /**
+     * Abort controller for the service repository.
+     */
+    static readonly abortController: AbortController;
+    /**
+     * Inspect the current state of the service registry.
+     */
+    static inspect(): Service<any>[];
+    /**
+     * Dispose of all services in the registry.
+     */
+    static [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Dispose of all services in the registry.
+     */
+    static dispose(): Promise<void>;
+    /**
+     * Register a pre-initialized service with the service repository.
+     *
+     * @param service - An instance of a service.
+     */
+    static register<T extends AsyncDisposable>(service: T): Service<T> & ServiceMethodResolver<T>;
+    /**
+     * Register a service resolver with the service repository.
+     *
+     * @param serviceCallback - A callback which returns a service instance.
+     */
+    static register<T extends AsyncDisposable>(serviceCallback: ServiceCallback<T>): Service<T> & ServiceMethodResolver<T>;
+    /**
+     * Register a service constructor with the service repository.
+     *
+     * @param ServiceConstructor - A constructor which returns a service instance.
+     */
+    static register<T extends AsyncDisposable>(ServiceConstructor: ServiceConstructor<T>): Service<T> & ServiceMethodResolver<T>;
+    /**
+     * Register a service with the service repository.
+     *
+     * @param resolver - A service resolver, instance, or constructor.
+     */
+    static register<T extends AsyncDisposable>(resolver: ServiceResolver<T>): Service<T> & ServiceMethodResolver<T>;
+    constructor();
+}
+export {};
+//# sourceMappingURL=services.d.ts.map

package/out/lifecycle/services.d.ts.map

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

package/out/lifecycle/services.js

@@ -0,0 +1,190 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for creating branded nominal types.
+ */
+import { ResourceError } from "../errors/schema.js";
+import { ConsoleLogger } from "../logging/index.js";
+import { ServiceSymbol } from "./ServiceSymbol.js";
+/**
+ * Type-predicate to determine if a given input is a ServiceConstructor, i.e. a function which is a
+ * constructor for a class which implements the AsyncDisposable interface.
+ */
+export function isServiceConstructor(input) {
+    if (typeof input !== "function")
+        return false;
+    if (!input.prototype || typeof input.prototype !== "object")
+        return false;
+    return Object.hasOwn(input.prototype, Symbol.asyncDispose) || Object.hasOwn(input.prototype, ServiceSymbol.asyncInit);
+}
+const kInstance = Symbol.for("ServiceInstance");
+const kResolver = Symbol.for("ServiceResolver");
+const kRegistryMap = Symbol.for("ServiceRepositoryMap");
+/**
+ * Promise-like wrapper for asynchronous services.
+ *
+ * @see {@linkcode ServiceRepository} for usage.
+ */
+export class Service {
+    /**
+     * Instance of the service.
+     *
+     * @internal
+     */
+    [kInstance] = null;
+    /**
+     * Resolver for the service.
+     *
+     * @internal
+     */
+    [kResolver];
+    /**
+     * Context for the parent service registry.
+     */
+    context;
+    constructor(resolver) {
+        this[kResolver] = resolver;
+        this.context = {
+            abortController: ServiceRepository.abortController,
+        };
+    }
+    /**
+     * Given an instance of a service, attach it to the resolver.
+     *
+     * This can be used to attach a service that was created outside of the resolver, such as when a
+     * resolver is defined from a TypeScript interface.
+     *
+     * @internal
+     */
+    attach(service) {
+        this[kInstance] = service;
+    }
+    /**
+     * Resolve the service instance.
+     *
+     * This method is called implicitly when the service is awaited.
+     */
+    async resolve() {
+        if (this[kInstance])
+            return this[kInstance];
+        if (!this[kResolver])
+            throw ResourceError.from(500, "Cannot resolve service without a resolver. Did you mean to call `attach` before calling `resolve`?");
+        if (typeof this[kResolver] === "function") {
+            if (isServiceConstructor(this[kResolver])) {
+                this[kInstance] = new this[kResolver]();
+                return this[kInstance];
+            }
+            const nextInstance = await this[kResolver](this.context);
+            if (ServiceSymbol.isAsyncInitializable(nextInstance)) {
+                await nextInstance[ServiceSymbol.asyncInit]();
+            }
+            this[kInstance] = nextInstance;
+            return this[kInstance];
+        }
+        if (typeof this[kResolver] === "object") {
+            const nextInstance = this[kResolver];
+            if (ServiceSymbol.isAsyncInitializable(nextInstance)) {
+                await nextInstance[ServiceSymbol.asyncInit]();
+            }
+            this[kInstance] = nextInstance;
+            return this[kInstance];
+        }
+        throw ResourceError.from(500, `Invalid resolver type. ${this[kResolver]}`);
+    }
+    /**
+     * Resolve the service instance. Called implicitly when the service is awaited.
+     */
+    then(onfulfilled, onrejected) {
+        return this.resolve()
+            .then((instance) => {
+            if (!this[kResolver]) {
+                throw ResourceError.from(500, "Service resolver was disposed before service was resolved.");
+            }
+            ServiceRepository[kRegistryMap].set(this[kResolver], this);
+            return instance;
+        })
+            .then(onfulfilled, onrejected);
+    }
+    async [Symbol.asyncDispose]() {
+        if (!this[kInstance]) {
+            ConsoleLogger.warn("Attempted to dispose a service resolver without a service!");
+            return;
+        }
+        if (typeof this[kInstance][Symbol.asyncDispose] !== "function") {
+            ConsoleLogger.warn("Attempted to dispose a service resolver without a disposable service!");
+            return;
+        }
+        await this[kInstance][Symbol.asyncDispose]();
+    }
+}
+/**
+ * Service repository for managing asynchronous services.
+ *
+ * @singleton
+ */
+export class ServiceRepository extends Service {
+    static [kRegistryMap] = new Map();
+    /**
+     * Abort controller for the service repository.
+     */
+    static abortController = new AbortController();
+    /**
+     * Inspect the current state of the service registry.
+     */
+    static inspect() {
+        const services = [...this[kRegistryMap].values()].reverse();
+        return services;
+    }
+    /**
+     * Dispose of all services in the registry.
+     */
+    static async [Symbol.asyncDispose]() {
+        const services = ServiceRepository.inspect();
+        ConsoleLogger.debug(`🚮 Disposing ${services.length} services...`);
+        for (const service of services) {
+            const label = String(service[kInstance]);
+            ConsoleLogger.debug(`[${label}] Disposing...`);
+            const marked = ServiceSymbol.markAsDisposed(service[kInstance]);
+            if (!marked)
+                continue;
+            await service[Symbol.asyncDispose]();
+        }
+        this[kRegistryMap].clear();
+    }
+    /**
+     * Dispose of all services in the registry.
+     */
+    static dispose() {
+        return this[Symbol.asyncDispose]();
+    }
+    static register(resolver) {
+        const service = new Service(resolver);
+        const serviceMethodResolver = new Proxy(service, {
+            get(target, prop) {
+                if (prop in target) {
+                    return target[prop];
+                }
+                return async (...args) => {
+                    const instance = (await target);
+                    if (typeof instance[prop] === "function") {
+                        return instance[prop](...args);
+                    }
+                    return instance[prop];
+                };
+            },
+            [Symbol.for("nodejs.util.inspect.custom")]() {
+                return "ServiceMethodResolver";
+            },
+        });
+        return serviceMethodResolver;
+    }
+    constructor() {
+        if (new.target === ServiceRepository) {
+            throw new TypeError("Cannot instantiate static class `ServiceRepository`.");
+        }
+        super(null);
+    }
+}
+//# sourceMappingURL=services.js.map

package/out/lifecycle/services.js.map

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

package/out/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./shared.js";
+//# sourceMappingURL=index.d.ts.map

package/out/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA"}

package/out/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./shared.js";
+//# sourceMappingURL=index.js.map

package/out/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA"}

package/out/logging/shared.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { BaseLogger as PinoBaseLogger, Level as PinoLevel, LogFn as PinoLogFn, Logger as PinoLogger } from "pino";
+export type Logger = PinoLogger;
+export type Level = PinoLevel;
+export type LogFn = PinoLogFn;
+export type BaseLogger = Pick<PinoBaseLogger, Exclude<Level, "fatal">>;
+/**
+ * Labels log levels in the browser console.
+ */
+export declare const LogLevelLabel: {
+    readonly info: "[INFO]";
+    readonly warn: "[WARN]";
+    readonly error: "[ERROR]";
+    readonly debug: "[DEBUG]";
+    readonly trace: "[TRACE]";
+    readonly fatal: "[FATAL]";
+};
+/**
+ * Predefined log levels.
+ */
+export declare const LogLevels: Level[];
+type LoggerFactory = (prefix?: string | null, ...args: string[]) => Logger;
+/**
+ * Creates a logger with the given prefix.
+ */
+export declare const createConsoleLogger: LoggerFactory;
+export type BaseConsoleLogger = Record<Level, LogFn>;
+export type IRuntimeLogger = BaseConsoleLogger;
+/**
+ * Creates a logger with the given prefix.
+ */
+export declare function createLogger(prefix?: string, ...args: string[][]): Logger;
+/**
+ * A singleton logger instance for the browser.
+ *
+ * ```js
+ * import { ConsoleLogger } from "#logger/browser";
+ *
+ * ConsoleLogger.info("Hello, world!");
+ * ```
+ *
+ * @implements {IRuntimeLogger}
+ */
+export declare class ConsoleLogger {
+    static info: typeof console.info;
+    static warn: typeof console.warn;
+    static error: typeof console.error;
+    static debug: typeof console.debug;
+    static trace: typeof console.trace;
+    /**
+     * Creates a logger with the given prefix.
+     */
+    static prefix(logPrefix: string): Logger;
+}
+export {};
+//# sourceMappingURL=shared.d.ts.map

package/out/logging/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../logging/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAEtH,MAAM,MAAM,MAAM,GAAG,UAAU,CAAA;AAE/B,MAAM,MAAM,KAAK,GAAG,SAAS,CAAA;AAE7B,MAAM,MAAM,KAAK,GAAG,SAAS,CAAA;AAE7B,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;AAItE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOgB,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,SAAS,EAAiC,KAAK,EAAE,CAAA;AAE9D,KAAK,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAA;AAgB1E;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAkBjC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAEpD,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAA;AAM9C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CA6BzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACzB,MAAM,CAAC,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,CAAA;IAChC,MAAM,CAAC,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,CAAA;IAClC,MAAM,CAAC,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,CAAA;IAClC,MAAM,CAAC,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,CAAA;IAElC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM;CAG/B"}

package/out/logging/shared.js

@@ -0,0 +1,100 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+//#region Constants
+/**
+ * Labels log levels in the browser console.
+ */
+export const LogLevelLabel = {
+    info: "[INFO]",
+    warn: "[WARN]",
+    error: "[ERROR]",
+    debug: "[DEBUG]",
+    trace: "[TRACE]",
+    fatal: "[FATAL]",
+};
+/**
+ * Predefined log levels.
+ */
+export const LogLevels = Object.keys(LogLevelLabel);
+/**
+ * Colors for log levels in the browser console.
+ */
+const LogLevelColors = {
+    info: `light-dark(#0043CE, #4589FF)`,
+    warn: `light-dark(#F1C21B, #F1C21B)`,
+    error: `light-dark(#DA1E28, #FA4D56)`,
+    debug: `light-dark(#8A3FFC, #A56EFF)`,
+    trace: `light-dark(#8A3FFC, #A56EFF)`,
+    fatal: `light-dark(#DA1E28, #FA4D56)`,
+};
+//#region Functions
+/**
+ * Creates a logger with the given prefix.
+ */
+export const createConsoleLogger = (prefix, ...args) => {
+    const msgPrefix = prefix ? `(${prefix}):` : ":";
+    const logger = {
+        msgPrefix,
+    };
+    for (const level of LogLevels) {
+        const label = LogLevelLabel[level];
+        // @ts-expect-error Alias the log method to the appropriate console method,
+        // defaulting to console.log if the level is not supported.
+        const method = level in console ? console[level] : console.log;
+        logger[level] = method.bind(console, `${label} ${msgPrefix}`, ...args);
+    }
+    return logger;
+};
+//#endregion
+//#region Functions
+/**
+ * Creates a logger with the given prefix.
+ */
+export function createLogger(prefix, ...args) {
+    const msgPrefix = prefix ? `(${prefix}):` : ":";
+    /**
+     * @type {Partial<Logger>}
+     */
+    const logger = {
+        msgPrefix,
+    };
+    for (const level of LogLevels) {
+        const label = LogLevelLabel[level];
+        const color = LogLevelColors[level];
+        // @ts-expect-error Alias the log method to the appropriate console method,
+        // defaulting to console.log if the level is not supported.
+        const method = level in console ? console[level] : console.log;
+        logger[level] = method.bind(console, `%c${label}%c ${msgPrefix}%c`, `font-weight: 700; color: ${color};`, `font-weight: 600; color: CanvasText;`, "", ...args);
+    }
+    return logger;
+}
+/**
+ * A singleton logger instance for the browser.
+ *
+ * ```js
+ * import { ConsoleLogger } from "#logger/browser";
+ *
+ * ConsoleLogger.info("Hello, world!");
+ * ```
+ *
+ * @implements {IRuntimeLogger}
+ */
+export class ConsoleLogger {
+    static info;
+    static warn;
+    static error;
+    static debug;
+    static trace;
+    /**
+     * Creates a logger with the given prefix.
+     */
+    static prefix(logPrefix) {
+        return createLogger(logPrefix);
+    }
+}
+Object.assign(ConsoleLogger, createLogger());
+//#endregion
+//# sourceMappingURL=shared.js.map

package/out/logging/shared.js.map

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

package/out/logging/tables.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export {};
+//# sourceMappingURL=tables.d.ts.map

package/out/logging/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../logging/tables.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}