camou 0.1.0

package/dist/ipc/protocol.js

@@ -0,0 +1,128 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { launchInputSchema } from '../camoufox/config.js';
+const browserRequestBase = launchInputSchema.extend({
+    id: z.string(),
+    session: z.string().min(1),
+    tabName: z.string().min(1),
+});
+const pingRequestSchema = z.object({
+    id: z.string(),
+    action: z.literal('ping'),
+});
+const openRequestSchema = browserRequestBase.extend({
+    action: z.literal('open'),
+    url: z.string().min(1),
+});
+const snapshotRequestSchema = browserRequestBase.extend({
+    action: z.literal('snapshot'),
+    interactive: z.boolean().default(false),
+});
+const clickRequestSchema = browserRequestBase.extend({
+    action: z.literal('click'),
+    target: z.string().min(1),
+});
+const fillRequestSchema = browserRequestBase.extend({
+    action: z.literal('fill'),
+    target: z.string().min(1),
+    text: z.string(),
+});
+const pressRequestSchema = browserRequestBase.extend({
+    action: z.literal('press'),
+    key: z.string().min(1),
+});
+const screenshotRequestSchema = browserRequestBase.extend({
+    action: z.literal('screenshot'),
+    path: z.string().optional(),
+});
+const getUrlRequestSchema = browserRequestBase.extend({
+    action: z.literal('get.url'),
+});
+const getTitleRequestSchema = browserRequestBase.extend({
+    action: z.literal('get.title'),
+});
+const getTextRequestSchema = browserRequestBase.extend({
+    action: z.literal('get.text'),
+    target: z.string().min(1),
+});
+const waitRequestSchema = browserRequestBase.extend({
+    action: z.literal('wait'),
+    target: z.string().min(1),
+    timeoutMs: z.number().int().positive().optional(),
+});
+const sessionListRequestSchema = z.object({
+    id: z.string(),
+    action: z.literal('session.list'),
+});
+const sessionStopRequestSchema = z.object({
+    id: z.string(),
+    action: z.literal('session.stop'),
+    session: z.string().min(1),
+});
+const tabListRequestSchema = z.object({
+    id: z.string(),
+    action: z.literal('tab.list'),
+    session: z.string().min(1),
+});
+const tabNewRequestSchema = browserRequestBase.extend({
+    action: z.literal('tab.new'),
+    url: z.string().min(1).optional(),
+});
+const tabCloseRequestSchema = z.object({
+    id: z.string(),
+    action: z.literal('tab.close'),
+    session: z.string().min(1),
+    target: z.string().min(1),
+});
+export const daemonRequestSchema = z.discriminatedUnion('action', [
+    pingRequestSchema,
+    openRequestSchema,
+    snapshotRequestSchema,
+    clickRequestSchema,
+    fillRequestSchema,
+    pressRequestSchema,
+    screenshotRequestSchema,
+    getUrlRequestSchema,
+    getTitleRequestSchema,
+    getTextRequestSchema,
+    waitRequestSchema,
+    sessionListRequestSchema,
+    sessionStopRequestSchema,
+    tabListRequestSchema,
+    tabNewRequestSchema,
+    tabCloseRequestSchema,
+]);
+const successResponseSchema = z.object({
+    id: z.string(),
+    success: z.literal(true),
+    data: z.unknown(),
+});
+const errorPayloadSchema = z.object({
+    code: z.string(),
+    message: z.string(),
+    details: z.unknown().optional(),
+});
+const failureResponseSchema = z.object({
+    id: z.string(),
+    success: z.literal(false),
+    error: errorPayloadSchema,
+});
+export const daemonResponseSchema = z.union([successResponseSchema, failureResponseSchema]);
+export function createRequestId() {
+    return `req_${randomUUID()}`;
+}
+export function successResponse(id, data) {
+    return {
+        id,
+        success: true,
+        data,
+    };
+}
+export function failureResponse(id, error) {
+    return {
+        id,
+        success: false,
+        error,
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/ipc/protocol.js.map

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

package/dist/ipc/server.d.ts

@@ -0,0 +1,10 @@
+import { type Server } from 'node:net';
+import type { CamoucliPaths } from '../state/paths.js';
+import type { Logger } from '../util/log.js';
+import { type DaemonRequest } from './protocol.js';
+export interface IpcServerHandle {
+    server: Server;
+    close: () => Promise<void>;
+}
+export type RequestHandler = (request: DaemonRequest) => Promise<unknown>;
+export declare function createIpcServer(paths: CamoucliPaths, handler: RequestHandler, logger: Logger): Promise<IpcServerHandle>;

package/dist/ipc/server.js

@@ -0,0 +1,99 @@
+import net, {} from 'node:net';
+import { unlink } from 'node:fs/promises';
+import { isCamoucliError, toErrorPayload, ValidationError } from '../util/errors.js';
+import { daemonRequestSchema, daemonResponseSchema, failureResponse, successResponse, } from './protocol.js';
+const HTTP_PREFIXES = ['GET ', 'POST ', 'PUT ', 'DELETE ', 'PATCH ', 'HEAD ', 'OPTIONS '];
+function isHttpTraffic(line) {
+    return HTTP_PREFIXES.some((prefix) => line.startsWith(prefix));
+}
+async function removeStaleSocket(socketPath) {
+    try {
+        await unlink(socketPath);
+    }
+    catch (error) {
+        if (!(error instanceof Error) || !('code' in error) || error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+}
+function respond(socket, response) {
+    const payload = daemonResponseSchema.parse(response);
+    socket.write(`${JSON.stringify(payload)}\n`);
+}
+export async function createIpcServer(paths, handler, logger) {
+    if (paths.daemonSocketPath) {
+        await removeStaleSocket(paths.daemonSocketPath);
+    }
+    const server = net.createServer((socket) => {
+        socket.setEncoding('utf8');
+        let buffer = '';
+        socket.on('data', (chunk) => {
+            buffer += chunk;
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    continue;
+                }
+                if (isHttpTraffic(trimmed)) {
+                    logger.warn('Rejected accidental HTTP traffic');
+                    socket.end('camou-daemon only accepts newline-delimited JSON\n');
+                    return;
+                }
+                void (async () => {
+                    let requestId = 'unknown';
+                    try {
+                        const parsed = JSON.parse(trimmed);
+                        if (typeof parsed === 'object' && parsed && 'id' in parsed && typeof parsed.id === 'string') {
+                            requestId = parsed.id;
+                        }
+                        const request = daemonRequestSchema.parse(parsed);
+                        const data = await handler(request);
+                        respond(socket, successResponse(request.id, data));
+                    }
+                    catch (error) {
+                        const normalized = isCamoucliError(error)
+                            ? error
+                            : error instanceof Error && error.name === 'ZodError'
+                                ? new ValidationError('Invalid daemon request payload.')
+                                : error;
+                        logger.error('Request handling failed', { requestId, error: toErrorPayload(normalized) });
+                        respond(socket, failureResponse(requestId, toErrorPayload(normalized)));
+                    }
+                })();
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        if (paths.daemonSocketPath) {
+            server.listen(paths.daemonSocketPath, resolve);
+            return;
+        }
+        server.listen(paths.daemonPort, paths.daemonHost, resolve);
+    });
+    logger.info('IPC server listening', {
+        socketPath: paths.daemonSocketPath,
+        host: paths.daemonHost,
+        port: paths.daemonPort,
+    });
+    return {
+        server,
+        close: async () => {
+            await new Promise((resolve, reject) => {
+                server.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+            if (paths.daemonSocketPath) {
+                await removeStaleSocket(paths.daemonSocketPath);
+            }
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/ipc/server.js.map

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

package/dist/state/paths.d.ts

@@ -0,0 +1,32 @@
+export interface CamoucliPaths {
+    appName: string;
+    dataDir: string;
+    stateDir: string;
+    cacheDir: string;
+    camoufoxCacheDir: string;
+    camoufoxConfigFile: string;
+    runtimeDir: string;
+    logsDir: string;
+    browsersDir: string;
+    browserRegistryFile: string;
+    profilesDir: string;
+    presetsDir: string;
+    daemonSocketPath?: string | undefined;
+    daemonHost?: string | undefined;
+    daemonPort?: number | undefined;
+    daemonPidFile: string;
+    daemonLogFile: string;
+}
+export interface SessionPaths {
+    sessionName: string;
+    safeSessionName: string;
+    rootDir: string;
+    profileDir: string;
+    downloadsDir: string;
+    artifactsDir: string;
+}
+export declare function sanitizeName(value: string): string;
+export declare function getCamoucliPaths(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): CamoucliPaths;
+export declare function ensureBasePaths(paths: CamoucliPaths): Promise<void>;
+export declare function getSessionPaths(paths: CamoucliPaths, sessionName: string): SessionPaths;
+export declare function ensureSessionPaths(paths: CamoucliPaths, sessionName: string): Promise<SessionPaths>;

package/dist/state/paths.js

@@ -0,0 +1,121 @@
+import os from 'node:os';
+import path from 'node:path';
+import { UnsupportedPlatformError } from '../util/errors.js';
+import { ensureDir } from './store.js';
+function linuxBaseDirs(env, home) {
+    const dataRoot = env.XDG_DATA_HOME ?? path.join(home, '.local', 'share');
+    const stateRoot = env.XDG_STATE_HOME ?? path.join(home, '.local', 'state');
+    const cacheRoot = env.XDG_CACHE_HOME ?? path.join(home, '.cache');
+    const runtimeDir = env.XDG_RUNTIME_DIR
+        ? path.join(env.XDG_RUNTIME_DIR, 'camoucli')
+        : path.join(stateRoot, 'camoucli', 'runtime');
+    return {
+        dataDir: path.join(dataRoot, 'camoucli'),
+        stateDir: path.join(stateRoot, 'camoucli'),
+        cacheDir: path.join(cacheRoot, 'camoucli'),
+        runtimeDir,
+    };
+}
+function darwinBaseDirs(home) {
+    const dataDir = path.join(home, 'Library', 'Application Support', 'camoucli');
+    const stateDir = path.join(home, 'Library', 'Application Support', 'camoucli');
+    const cacheDir = path.join(home, 'Library', 'Caches', 'camoucli');
+    return {
+        dataDir,
+        stateDir,
+        cacheDir,
+        runtimeDir: path.join(stateDir, 'runtime'),
+    };
+}
+function windowsBaseDirs(env, home) {
+    const appData = env.APPDATA ?? path.join(home, 'AppData', 'Roaming');
+    const localAppData = env.LOCALAPPDATA ?? path.join(home, 'AppData', 'Local');
+    const dataDir = path.join(appData, 'camoucli');
+    const stateDir = path.join(localAppData, 'camoucli');
+    return {
+        dataDir,
+        stateDir,
+        cacheDir: path.join(localAppData, 'camoucli', 'Cache'),
+        runtimeDir: path.join(localAppData, 'camoucli', 'Runtime'),
+    };
+}
+export function sanitizeName(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'default';
+}
+export function getCamoucliPaths(env = process.env, platform = process.platform) {
+    const home = os.homedir();
+    let bases;
+    let camoufoxCacheDir;
+    if (platform === 'linux') {
+        bases = linuxBaseDirs(env, home);
+        camoufoxCacheDir = path.join(env.XDG_CACHE_HOME ?? path.join(home, '.cache'), 'camoufox');
+    }
+    else if (platform === 'darwin') {
+        bases = darwinBaseDirs(home);
+        camoufoxCacheDir = path.join(home, 'Library', 'Caches', 'camoufox');
+    }
+    else if (platform === 'win32') {
+        bases = windowsBaseDirs(env, home);
+        camoufoxCacheDir = path.join(env.LOCALAPPDATA ?? path.join(home, 'AppData', 'Local'), 'camoufox', 'Cache');
+    }
+    else {
+        throw new UnsupportedPlatformError(`Unsupported platform: ${platform}`);
+    }
+    const logsDir = path.join(bases.stateDir, 'logs');
+    const runtimeDir = bases.runtimeDir;
+    return {
+        appName: 'camoucli',
+        dataDir: bases.dataDir,
+        stateDir: bases.stateDir,
+        cacheDir: bases.cacheDir,
+        camoufoxCacheDir,
+        camoufoxConfigFile: path.join(camoufoxCacheDir, 'config.json'),
+        runtimeDir,
+        logsDir,
+        browsersDir: path.join(camoufoxCacheDir, 'browsers'),
+        browserRegistryFile: path.join(bases.dataDir, 'browsers', 'registry.json'),
+        profilesDir: path.join(bases.dataDir, 'profiles'),
+        presetsDir: path.join(bases.dataDir, 'presets'),
+        daemonSocketPath: platform === 'win32' ? undefined : path.join(runtimeDir, 'daemon.sock'),
+        daemonHost: platform === 'win32' ? '127.0.0.1' : undefined,
+        daemonPort: platform === 'win32' ? Number(env.CAMOUCLI_PORT ?? 43133) : undefined,
+        daemonPidFile: path.join(runtimeDir, 'daemon.pid'),
+        daemonLogFile: path.join(logsDir, 'daemon.log'),
+    };
+}
+export async function ensureBasePaths(paths) {
+    await Promise.all([
+        ensureDir(paths.dataDir),
+        ensureDir(paths.stateDir),
+        ensureDir(paths.cacheDir),
+        ensureDir(paths.camoufoxCacheDir),
+        ensureDir(paths.runtimeDir),
+        ensureDir(paths.logsDir),
+        ensureDir(paths.browsersDir),
+        ensureDir(paths.profilesDir),
+        ensureDir(paths.presetsDir),
+    ]);
+}
+export function getSessionPaths(paths, sessionName) {
+    const safeSessionName = sanitizeName(sessionName);
+    const rootDir = path.join(paths.profilesDir, safeSessionName);
+    return {
+        sessionName,
+        safeSessionName,
+        rootDir,
+        profileDir: path.join(rootDir, 'user-data'),
+        downloadsDir: path.join(rootDir, 'downloads'),
+        artifactsDir: path.join(rootDir, 'artifacts'),
+    };
+}
+export async function ensureSessionPaths(paths, sessionName) {
+    const sessionPaths = getSessionPaths(paths, sessionName);
+    await Promise.all([
+        ensureDir(sessionPaths.rootDir),
+        ensureDir(sessionPaths.profileDir),
+        ensureDir(sessionPaths.downloadsDir),
+        ensureDir(sessionPaths.artifactsDir),
+    ]);
+    return sessionPaths;
+}
+//# sourceMappingURL=paths.js.map

package/dist/state/paths.js.map

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

package/dist/state/store.d.ts

@@ -0,0 +1,4 @@
+export declare function ensureDir(path: string): Promise<void>;
+export declare function readJsonFile<T>(filePath: string, fallback: T): Promise<T>;
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+export declare function removePath(filePath: string): Promise<void>;

package/dist/state/store.js

@@ -0,0 +1,30 @@
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export async function ensureDir(path) {
+    await mkdir(path, { recursive: true, mode: 0o700 });
+}
+export async function readJsonFile(filePath, fallback) {
+    try {
+        const raw = await readFile(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        if (isFileMissing(error)) {
+            return fallback;
+        }
+        throw error;
+    }
+}
+export async function writeJsonFile(filePath, value) {
+    await ensureDir(dirname(filePath));
+    const tempPath = `${filePath}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+    await rename(tempPath, filePath);
+}
+export async function removePath(filePath) {
+    await rm(filePath, { recursive: true, force: true });
+}
+function isFileMissing(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=store.js.map

package/dist/state/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/state/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,QAAW;IACjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAClE,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC"}

package/dist/util/errors.d.ts

@@ -0,0 +1,45 @@
+export interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface CamoucliErrorOptions {
+    code: string;
+    message: string;
+    exitCode?: number;
+    details?: unknown;
+    cause?: unknown;
+}
+export declare class CamoucliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly details?: unknown;
+    constructor(options: CamoucliErrorOptions);
+}
+export declare class ValidationError extends CamoucliError {
+    constructor(message: string, details?: unknown, cause?: unknown);
+}
+export declare class UnsupportedPlatformError extends CamoucliError {
+    constructor(message: string, details?: unknown);
+}
+export declare class BrowserNotInstalledError extends CamoucliError {
+    constructor(message?: string);
+}
+export declare class InstallError extends CamoucliError {
+    constructor(message: string, details?: unknown, cause?: unknown);
+}
+export declare class DaemonStartError extends CamoucliError {
+    constructor(message: string, details?: unknown, cause?: unknown);
+}
+export declare class IpcError extends CamoucliError {
+    constructor(message: string, details?: unknown, cause?: unknown);
+}
+export declare class SessionError extends CamoucliError {
+    constructor(message: string, details?: unknown, cause?: unknown);
+}
+export declare class RefNotFoundError extends CamoucliError {
+    constructor(ref: string);
+}
+export declare function isCamoucliError(error: unknown): error is CamoucliError;
+export declare function toErrorPayload(error: unknown): ErrorPayload;
+export declare function getExitCode(error: unknown): number;

package/dist/util/errors.js

@@ -0,0 +1,82 @@
+export class CamoucliError extends Error {
+    code;
+    exitCode;
+    details;
+    constructor(options) {
+        super(options.message, options.cause ? { cause: options.cause } : undefined);
+        this.name = new.target.name;
+        this.code = options.code;
+        this.exitCode = options.exitCode ?? 1;
+        this.details = options.details;
+    }
+}
+export class ValidationError extends CamoucliError {
+    constructor(message, details, cause) {
+        super({ code: 'validation_error', message, details, cause, exitCode: 2 });
+    }
+}
+export class UnsupportedPlatformError extends CamoucliError {
+    constructor(message, details) {
+        super({ code: 'unsupported_platform', message, details, exitCode: 2 });
+    }
+}
+export class BrowserNotInstalledError extends CamoucliError {
+    constructor(message = 'Camoufox is not installed. Run `camou install`.') {
+        super({ code: 'browser_not_installed', message, exitCode: 3 });
+    }
+}
+export class InstallError extends CamoucliError {
+    constructor(message, details, cause) {
+        super({ code: 'install_error', message, details, cause, exitCode: 4 });
+    }
+}
+export class DaemonStartError extends CamoucliError {
+    constructor(message, details, cause) {
+        super({ code: 'daemon_start_error', message, details, cause, exitCode: 5 });
+    }
+}
+export class IpcError extends CamoucliError {
+    constructor(message, details, cause) {
+        super({ code: 'ipc_error', message, details, cause, exitCode: 6 });
+    }
+}
+export class SessionError extends CamoucliError {
+    constructor(message, details, cause) {
+        super({ code: 'session_error', message, details, cause, exitCode: 7 });
+    }
+}
+export class RefNotFoundError extends CamoucliError {
+    constructor(ref) {
+        super({
+            code: 'invalid_ref',
+            message: `Reference ${ref} is not available for the current tab. Run snapshot again.`,
+            exitCode: 8,
+        });
+    }
+}
+export function isCamoucliError(error) {
+    return error instanceof CamoucliError;
+}
+export function toErrorPayload(error) {
+    if (isCamoucliError(error)) {
+        return {
+            code: error.code,
+            message: error.message,
+            details: error.details,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: 'unexpected_error',
+            message: error.message,
+        };
+    }
+    return {
+        code: 'unexpected_error',
+        message: String(error),
+    };
+}
+export function getExitCode(error) {
+    return isCamoucliError(error) ? error.exitCode : 1;
+}
+//# sourceMappingURL=errors.js.map

package/dist/util/errors.js.map

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

package/dist/util/log.d.ts

@@ -0,0 +1,19 @@
+export interface LoggerOptions {
+    name: string;
+    filePath?: string | undefined;
+    verbose?: boolean;
+    mirrorToStderr?: boolean;
+}
+export declare class Logger {
+    readonly name: string;
+    readonly verbose: boolean;
+    private readonly mirrorToStderr;
+    private readonly stream?;
+    constructor(options: LoggerOptions);
+    debug(message: string, details?: unknown): void;
+    info(message: string, details?: unknown): void;
+    warn(message: string, details?: unknown): void;
+    error(message: string, details?: unknown): void;
+    close(): Promise<void>;
+    private write;
+}