@grest-ts/logger 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @grest-ts/logger
+
+Async context-aware logging library for Grest Framework.
+
+## Features
+
+- Multiple log levels (debug, info, warn, error, critical)
+- Async context propagation (per-request logging)
+- Pluggable loggers (console, custom)
+- Structured data logging
+
+## Quick usage example
+
+```typescript
+
+GGLog.debug(this, "Doing something cool!", {coolSomethingId: something.id})
+
+GGLog.info(this, "Doing something cool!", {coolSomethingId: something.id})
+
+GGLog.warn(this, "Doing something cool!", {coolSomethingId: something.id})
+
+GGLog.error(this, "Something went wrong", {coolSomethingId: something.id})
+
+const error = new Error("Something went wrong!")
+GGLog.error(this, error)
+GGLog.error(this, "User registration flow failed!", error)
+
+// All levels provide multiple ways to log messages:
+GGLog[LEVEL](this, "Doing something cool!", {coolSomethingId: something.id})
+GGLog[LEVEL](this, new Error("some error"))
+GGLog[LEVEL](this, "My flow failed", new Error("some error"))
+```
+
+## Documentation
+
+- [Usage](./README-usage.md) - How to use logging in your application.
+- [Testing](./README-testkit.md) - How to test log output with testkit.
+- [Extending](./README-extending.md) - How to add custom loggers.

package/dist/src/GGLog.d.ts

@@ -0,0 +1,50 @@
+import { GGLocatorKey, GGLocatorScope } from "@grest-ts/locator";
+import { GGLogger } from "./GGLogger";
+import { LogLevel } from "./types";
+export declare const GG_LOG: GGLocatorKey<GGLog>;
+/**
+ * Logging system with async context awareness.
+ *
+ * GGLog uses GGAsyncContext for context propagation. It adds itself to
+ * whatever context exists, enabling per-runtime logger isolation.
+ *
+ * Usage:
+ * - Initialize: `GGLog.init()` (adds GGLog to current context)
+ * - Add loggers: `GGLog.add(new GGLoggerConsole())`
+ * - Log messages: `GGLog.info(this, "message", {data})`
+ */
+export declare class GGLog {
+    private readonly loggers;
+    private globalMinLevel;
+    private constructor();
+    /**
+     * Initialize GGLog - creates a new instance and adds it to the current context.
+     */
+    static init(scope?: GGLocatorScope): GGLog;
+    addLogger(logger: GGLogger): this;
+    private clearLoggers;
+    private isLevelLoggedInternal;
+    private log;
+    static getLogger<T extends GGLogger>(type: new (...args: any[]) => T): T | undefined;
+    getLoggerInstance<T extends GGLogger>(type: new (...args: any[]) => T): T | undefined;
+    static add(logger: GGLogger): void;
+    static clear(): void;
+    static isLevelLogged(level: LogLevel): boolean;
+    private static log;
+    static debug(context: any, error: Error, data?: any): void;
+    static debug(context: any, message: string, data?: any): void;
+    static debug(context: any, message: string, error: Error, data?: any): void;
+    static info(context: any, error: Error, data?: any): void;
+    static info(context: any, message: string, data?: any): void;
+    static info(context: any, message: string, error: Error, data?: any): void;
+    static warn(context: any, error: Error, data?: any): void;
+    static warn(context: any, message: string, data?: any): void;
+    static warn(context: any, message: string, error: Error, data?: any): void;
+    static error(context: any, error: Error, data?: any): void;
+    static error(context: any, message: string, data?: any): void;
+    static error(context: any, message: string, error: Error, data?: any): void;
+    static critical(context: any, error: Error, data?: any): void;
+    static critical(context: any, message: string, data?: any): void;
+    static critical(context: any, message: string, error: Error, data?: any): void;
+}
+//# sourceMappingURL=GGLog.d.ts.map

package/dist/src/GGLog.d.ts.map

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

package/dist/src/GGLog.js

@@ -0,0 +1,150 @@
+import { GGLocator, GGLocatorKey } from "@grest-ts/locator";
+import { LogLevel } from "./types.js";
+export const GG_LOG = new GGLocatorKey("GGLog");
+/**
+ * Logging system with async context awareness.
+ *
+ * GGLog uses GGAsyncContext for context propagation. It adds itself to
+ * whatever context exists, enabling per-runtime logger isolation.
+ *
+ * Usage:
+ * - Initialize: `GGLog.init()` (adds GGLog to current context)
+ * - Add loggers: `GGLog.add(new GGLoggerConsole())`
+ * - Log messages: `GGLog.info(this, "message", {data})`
+ */
+export class GGLog {
+    loggers = [];
+    globalMinLevel = LogLevel.CRITICAL + 1; // No loggers = nothing logged
+    constructor() {
+    }
+    /**
+     * Initialize GGLog - creates a new instance and adds it to the current context.
+     */
+    static init(scope) {
+        const instance = new GGLog();
+        (scope ?? GGLocator.getScope()).set(GG_LOG, instance);
+        return instance;
+    }
+    // -----------------------------------------------
+    // Instance methods (operate on current context's loggers)
+    // -----------------------------------------------
+    addLogger(logger) {
+        this.loggers.push(logger);
+        if (this.loggers.length === 0) {
+            this.globalMinLevel = LogLevel.CRITICAL + 1;
+        }
+        else {
+            this.globalMinLevel = Math.min(...this.loggers.map(l => l.minLevel));
+        }
+        return this;
+    }
+    clearLoggers() {
+        this.loggers.length = 0;
+        this.globalMinLevel = LogLevel.CRITICAL + 1;
+    }
+    isLevelLoggedInternal(level) {
+        return level >= this.globalMinLevel;
+    }
+    log(entry) {
+        for (const logger of this.loggers) {
+            try {
+                logger.log(entry);
+            }
+            catch (error) {
+                // Prevent logger errors from breaking the application
+                console.error('Logger error:', error);
+            }
+        }
+    }
+    // -----------------------------------------------
+    // Static methods - main API
+    // -----------------------------------------------
+    static getLogger(type) {
+        return GG_LOG.get().loggers.find((l) => l instanceof type);
+    }
+    getLoggerInstance(type) {
+        return this.loggers.find((l) => l instanceof type);
+    }
+    static add(logger) {
+        GG_LOG.get().addLogger(logger);
+    }
+    static clear() {
+        GG_LOG.tryGet()?.clearLoggers();
+    }
+    static isLevelLogged(level) {
+        return GG_LOG.get().isLevelLoggedInternal(level);
+    }
+    static log(level, context, messageOrError, dataOrError, possiblyError) {
+        const ctx = GG_LOG.tryGet();
+        if (!ctx) {
+            console.warn("Log context not setup for message: ", messageOrError, dataOrError, possiblyError);
+            return;
+        }
+        // Fast path: skip all work if no logger cares about this level
+        if (!ctx.isLevelLoggedInternal(level)) {
+            return;
+        }
+        let message = undefined;
+        let data = undefined;
+        let error = undefined;
+        if (typeof messageOrError === "string") {
+            message = messageOrError;
+        }
+        else if (messageOrError instanceof Error) {
+            error = messageOrError;
+        }
+        else if (messageOrError) {
+            data = messageOrError;
+        }
+        if (dataOrError instanceof Error) {
+            error = dataOrError;
+        }
+        else if (dataOrError) {
+            data = dataOrError;
+        }
+        if (possiblyError instanceof Error) {
+            error = possiblyError;
+        }
+        // This is to support GGHttpError log levels
+        if (error && "logLevel" in error) {
+            if (error.logLevel === "error") {
+                level = LogLevel.ERROR;
+            }
+            else if (error.logLevel === "warn") {
+                level = LogLevel.WARN;
+            }
+            else if (error.logLevel === "info") {
+                level = LogLevel.INFO;
+            }
+            else if (error.logLevel === "debug") {
+                level = LogLevel.DEBUG;
+            }
+        }
+        const entry = {
+            timestamp: new Date(),
+            level,
+            contextName: typeof context === 'string' ? context : (context?.name ?? context?.constructor?.name),
+            message,
+            data,
+            error,
+            requestContext: undefined
+        };
+        ctx.log(entry);
+    }
+    static debug(context, a, b, c) {
+        this.log(LogLevel.DEBUG, context, a, b, c);
+    }
+    static info(context, a, b, c) {
+        this.log(LogLevel.INFO, context, a, b, c);
+    }
+    static warn(context, a, b, c) {
+        this.log(LogLevel.WARN, context, a, b, c);
+    }
+    static error(context, a, b, c) {
+        this.log(LogLevel.ERROR, context, a, b, c);
+    }
+    static critical(context, a, b, c) {
+        this.log(LogLevel.CRITICAL, context, a, b, c);
+    }
+}
+//# sourceMappingURL=GGLog.js.map

package/dist/src/GGLog.js.map

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

package/dist/src/GGLogger.d.ts

@@ -0,0 +1,9 @@
+import { LogEntry, LogLevel } from "./types";
+/**
+ * Logger strategy interface
+ */
+export interface GGLogger {
+    readonly minLevel: LogLevel;
+    log(entry: LogEntry): void;
+}
+//# sourceMappingURL=GGLogger.d.ts.map

package/dist/src/GGLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogger.d.ts","sourceRoot":"","sources":["../../src/GGLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAC,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC9B"}

package/dist/src/GGLogger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GGLogger.js.map

package/dist/src/GGLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogger.js","sourceRoot":"","sources":["../../src/GGLogger.ts"],"names":[],"mappings":""}

package/dist/src/IAsyncLocalStorage.d.ts

@@ -0,0 +1,8 @@
+export interface IAsyncLocalStorage<T> {
+    run<R>(store: T, callback: () => R): R;
+    getStore(): T | undefined;
+    exit<R>(callback: () => R): R;
+    enterWith(store: T): void;
+}
+export declare const AsyncLocalStorageImpl: new <T>() => IAsyncLocalStorage<T>;
+//# sourceMappingURL=IAsyncLocalStorage.d.ts.map

package/dist/src/IAsyncLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAsyncLocalStorage.d.ts","sourceRoot":"","sources":["../../src/IAsyncLocalStorage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACjC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAEvC,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;IAE1B,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9B,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7B;AAyCD,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC,CACA,CAAC"}

package/dist/src/IAsyncLocalStorage.js

@@ -0,0 +1,38 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+class BrowserAsyncLocalStorage {
+    store = undefined;
+    run(store, callback) {
+        const previousStore = this.store;
+        this.store = store;
+        try {
+            return callback();
+        }
+        finally {
+            this.store = previousStore;
+        }
+    }
+    getStore() {
+        return this.store;
+    }
+    exit(callback) {
+        const previousStore = this.store;
+        this.store = undefined;
+        try {
+            return callback();
+        }
+        finally {
+            this.store = previousStore;
+        }
+    }
+    enterWith(store) {
+        this.store = store;
+    }
+}
+const isBrowser = typeof globalThis !== 'undefined' &&
+    typeof globalThis.window !== 'undefined' &&
+    typeof globalThis.window.document !== 'undefined';
+// Export the appropriate implementation based on environment
+// In browser: use BrowserAsyncLocalStorage
+// In Node.js: use native AsyncLocalStorage from async_hooks
+export const AsyncLocalStorageImpl = isBrowser ? BrowserAsyncLocalStorage : AsyncLocalStorage;
+//# sourceMappingURL=IAsyncLocalStorage.js.map

package/dist/src/IAsyncLocalStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAsyncLocalStorage.js","sourceRoot":"","sources":["../../src/IAsyncLocalStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAA;AAYlD,MAAM,wBAAwB;IAClB,KAAK,GAAkB,SAAS,CAAC;IAEzC,GAAG,CAAI,KAAQ,EAAE,QAAiB;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACD,OAAO,QAAQ,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;QAC/B,CAAC;IACL,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,CAAI,QAAiB;QACrB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC;YACD,OAAO,QAAQ,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;QAC/B,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAQ;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ;AAED,MAAM,SAAS,GAAG,OAAO,UAAU,KAAK,WAAW;IAC/C,OAAQ,UAAkB,CAAC,MAAM,KAAK,WAAW;IACjD,OAAQ,UAAkB,CAAC,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;AAE/D,6DAA6D;AAC7D,2CAA2C;AAC3C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAC9B,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAE,iBAAyB,CAAC"}

package/dist/src/index-browser.d.ts

@@ -0,0 +1,5 @@
+export * from './GGLog';
+export * from './GGLogger';
+export * from './types';
+export type { IAsyncLocalStorage } from './IAsyncLocalStorage';
+//# sourceMappingURL=index-browser.d.ts.map

package/dist/src/index-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,YAAY,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA"}

package/dist/src/index-browser.js

@@ -0,0 +1,5 @@
+export * from './GGLog.js';
+export * from './GGLogger.js';
+export * from './types.js';
+// AsyncLocalStorageImpl excluded — uses Node.js async_hooks
+//# sourceMappingURL=index-browser.js.map

package/dist/src/index-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-browser.js","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AAExB,4DAA4D"}

package/dist/src/index-node.d.ts

@@ -0,0 +1,5 @@
+export * from './GGLog';
+export * from './GGLogger';
+export * from './types';
+export { type IAsyncLocalStorage, AsyncLocalStorageImpl } from './IAsyncLocalStorage';
+//# sourceMappingURL=index-node.d.ts.map

package/dist/src/index-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAC,KAAK,kBAAkB,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAA"}

package/dist/src/index-node.js

@@ -0,0 +1,5 @@
+export * from './GGLog.js';
+export * from './GGLogger.js';
+export * from './types.js';
+export { AsyncLocalStorageImpl } from './IAsyncLocalStorage.js';
+//# sourceMappingURL=index-node.js.map

package/dist/src/index-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,OAAO,EAA0B,qBAAqB,EAAC,MAAM,sBAAsB,CAAA"}

package/dist/src/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "//": "THIS FILE IS GENERATED - DO NOT EDIT",
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "lib": [
+      "ES2022",
+      "DOM"
+    ],
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "**/*"
+  ]
+}

package/dist/src/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Complete log entry structure
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: LogLevel;
+    contextName?: string;
+    message: string;
+    data?: any;
+    error?: Error | string | unknown;
+    requestContext?: any;
+}
+/**
+ * Log levels
+ */
+export declare enum LogLevel {
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    CRITICAL = 5
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,GAAG,CAAC;CACxB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,QAAQ,IAAI;CACf"}

package/dist/src/types.js

@@ -0,0 +1,12 @@
+/**
+ * Log levels
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["CRITICAL"] = 5] = "CRITICAL";
+})(LogLevel || (LogLevel = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,+CAAY,CAAA;AAChB,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}

package/dist/testkit/GGLogCommands.d.ts

@@ -0,0 +1,19 @@
+import { CapturedLogEntry, SerializableLogMatcher } from "./GGTestLogger";
+import { LogLevel } from "@grest-ts/logger";
+export interface FindFromPayload {
+    fromIndex: number;
+    matcher: SerializableLogMatcher;
+    minLevel?: LogLevel;
+}
+export interface RetrieveFromPayload {
+    fromIndex: number;
+    minLevel?: LogLevel;
+}
+export declare const GGLogIPC: {
+    worker: {
+        getCursor: import("@grest-ts/ipc").IPCClientRequest<void, number>;
+        findFrom: import("@grest-ts/ipc").IPCClientRequest<FindFromPayload, CapturedLogEntry>;
+        retrieveFrom: import("@grest-ts/ipc").IPCClientRequest<RetrieveFromPayload, CapturedLogEntry[]>;
+    };
+};
+//# sourceMappingURL=GGLogCommands.d.ts.map

package/dist/testkit/GGLogCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogCommands.d.ts","sourceRoot":"","sources":["../../testkit/GGLogCommands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAgB,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAQ,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAA"}

package/dist/testkit/GGLogCommands.js

@@ -0,0 +1,31 @@
+import { GG_TEST_RUNTIME_WORKER, GGTestRuntimeWorker } from "@grest-ts/testkit";
+import { IPCClient } from "@grest-ts/ipc";
+import { GGTestLogger } from "./GGTestLogger.js";
+import { GGLog } from "@grest-ts/logger";
+export const GGLogIPC = {
+    worker: {
+        getCursor: IPCClient.defineRequest("logs.getCursor"),
+        findFrom: IPCClient.defineRequest("logs.findFrom"),
+        retrieveFrom: IPCClient.defineRequest("logs.retrieveFrom"),
+    }
+};
+GGTestRuntimeWorker.onBeforeRuntimeStart(() => {
+    const worker = GG_TEST_RUNTIME_WORKER.get();
+    const getLogger = () => {
+        const logger = GGLog.getLogger(GGTestLogger);
+        if (!logger) {
+            throw new Error("GGTestLogger not found. Make sure @grest-ts/logger/testkit is loaded.");
+        }
+        return logger;
+    };
+    worker.onIpcRequest(GGLogIPC.worker.getCursor, () => {
+        return getLogger().getCursor();
+    });
+    worker.onIpcRequest(GGLogIPC.worker.findFrom, (payload) => {
+        return getLogger().findFrom(payload.fromIndex, payload.matcher, payload.minLevel);
+    });
+    worker.onIpcRequest(GGLogIPC.worker.retrieveFrom, (payload) => {
+        return getLogger().retrieveFrom(payload.fromIndex, payload.minLevel);
+    });
+});
+//# sourceMappingURL=GGLogCommands.js.map

package/dist/testkit/GGLogCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogCommands.js","sourceRoot":"","sources":["../../testkit/GGLogCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAmB,YAAY,EAAyB,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAC,KAAK,EAAW,MAAM,kBAAkB,CAAC;AAajD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,MAAM,EAAE;QACJ,SAAS,EAAE,SAAS,CAAC,aAAa,CAAe,gBAAgB,CAAC;QAClE,QAAQ,EAAE,SAAS,CAAC,aAAa,CAA2C,eAAe,CAAC;QAC5F,YAAY,EAAE,SAAS,CAAC,aAAa,CAA0C,mBAAmB,CAAC;KACtG;CACJ,CAAA;AAED,mBAAmB,CAAC,oBAAoB,CAAC,GAAG,EAAE;IAC1C,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,GAAiB,EAAE;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE;QAChD,OAAO,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;QACtD,OAAO,SAAS,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;QAC1D,OAAO,SAAS,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/testkit/GGLogCursor.d.ts

@@ -0,0 +1,30 @@
+import { LogLevel } from "@grest-ts/logger";
+import { GGTestRuntime } from "@grest-ts/testkit";
+import { CapturedLogEntry } from "./GGTestLogger";
+export type LogMatcher = string | RegExp | Partial<CapturedLogEntry>;
+export interface LogQueryOptions {
+    minLevel?: LogLevel;
+}
+/**
+ * Represents a cursor position in the log stream.
+ * Stores the starting index per runtime for querying logs from that point onwards.
+ */
+export declare class GGLogCursor {
+    private readonly runtimes;
+    private readonly cursors;
+    constructor(runtimes: GGTestRuntime[], cursors: Map<GGTestRuntime, number>);
+    /**
+     * Find a log entry matching the given matcher across all runtimes.
+     * Returns the first match or null if not found.
+     */
+    find(matcher: LogMatcher, options?: LogQueryOptions): Promise<CapturedLogEntry | null>;
+    /**
+     * Retrieve all log entries from the cursor position onwards.
+     */
+    retrieve(options?: LogQueryOptions): Promise<CapturedLogEntry[]>;
+    /**
+     * Convert LogMatcher to SerializableLogMatcher for IPC.
+     */
+    private toSerializable;
+}
+//# sourceMappingURL=GGLogCursor.d.ts.map

package/dist/testkit/GGLogCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogCursor.d.ts","sourceRoot":"","sources":["../../testkit/GGLogCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAC,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAGxE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC;IAK1E;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAoB5F;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkBtE;;OAEG;IACH,OAAO,CAAC,cAAc;CASzB"}

package/dist/testkit/GGLogCursor.js

@@ -0,0 +1,62 @@
+import { GGLogIPC } from "./GGLogCommands.js";
+/**
+ * Represents a cursor position in the log stream.
+ * Stores the starting index per runtime for querying logs from that point onwards.
+ */
+export class GGLogCursor {
+    runtimes;
+    cursors;
+    constructor(runtimes, cursors) {
+        this.runtimes = runtimes;
+        this.cursors = cursors;
+    }
+    /**
+     * Find a log entry matching the given matcher across all runtimes.
+     * Returns the first match or null if not found.
+     */
+    async find(matcher, options) {
+        const serializable = this.toSerializable(matcher);
+        const results = await Promise.all(this.runtimes.map(async (runtime) => {
+            const fromIndex = this.cursors.get(runtime) ?? 0;
+            return runtime.sendCommand(GGLogIPC.worker.findFrom, {
+                fromIndex,
+                matcher: serializable,
+                minLevel: options?.minLevel
+            });
+        }));
+        // Return first non-null match (sorted by index for determinism)
+        const matches = results.filter((r) => r !== null);
+        if (matches.length === 0)
+            return null;
+        return matches.sort((a, b) => a.index - b.index)[0];
+    }
+    /**
+     * Retrieve all log entries from the cursor position onwards.
+     */
+    async retrieve(options) {
+        const allLogs = [];
+        await Promise.all(this.runtimes.map(async (runtime) => {
+            const fromIndex = this.cursors.get(runtime) ?? 0;
+            const logs = await runtime.sendCommand(GGLogIPC.worker.retrieveFrom, {
+                fromIndex,
+                minLevel: options?.minLevel
+            });
+            allLogs.push(...logs);
+        }));
+        // Sort by timestamp for consistent ordering across runtimes
+        return allLogs.sort((a, b) => a.timestamp - b.timestamp);
+    }
+    /**
+     * Convert LogMatcher to SerializableLogMatcher for IPC.
+     */
+    toSerializable(matcher) {
+        if (typeof matcher === 'string') {
+            return { type: 'string', value: matcher };
+        }
+        if (matcher instanceof RegExp) {
+            return { type: 'regex', pattern: matcher.source, flags: matcher.flags };
+        }
+        return { type: 'object', value: matcher };
+    }
+}
+//# sourceMappingURL=GGLogCursor.js.map

package/dist/testkit/GGLogCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLogCursor.js","sourceRoot":"","sources":["../../testkit/GGLogCursor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AAQzC;;;GAGG;AACH,MAAM,OAAO,WAAW;IAEH,QAAQ,CAAkB;IAC1B,OAAO,CAA6B;IAErD,YAAY,QAAyB,EAAE,OAAmC;QACtE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,OAAmB,EAAE,OAAyB;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACjD,SAAS;gBACT,OAAO,EAAE,YAAY;gBACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC9B,CAAC,CAAC;QACP,CAAC,CAAC,CACL,CAAC;QAEF,gEAAgE;QAChE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAyB;QACpC,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,MAAM,OAAO,CAAC,GAAG,CACb,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE;gBACjE,SAAS;gBACT,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC9B,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CACL,CAAC;QAEF,4DAA4D;QAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAmB;QACtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC9C,CAAC;QACD,IAAI,OAAO,YAAY,MAAM,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAkC,EAAE,CAAC;IACzE,CAAC;CACJ"}