paperkite 0.1.0

package/dist/src/config/model.js

@@ -0,0 +1,97 @@
+export const FLOW_SECTIONS = ["triggers", "commands", "schedules", "services"];
+export class FlowCatalog {
+    definitionsByKind;
+    path;
+    constructor(definitionsByKind, path) {
+        this.definitionsByKind = definitionsByKind;
+        this.path = path;
+    }
+    definitions(kind) {
+        if (!kind)
+            return FLOW_SECTIONS.flatMap((section) => this.definitionsByKind[sectionToKind(section)]);
+        return [...this.definitionsByKind[normalizeKind(kind)]];
+    }
+    enabled(kind) {
+        return this.definitions(kind).filter((item) => item.kind === "command" || item.enabled);
+    }
+    capabilityRefs() {
+        const refs = new Set();
+        for (const item of this.enabled()) {
+            if ("capability" in item && item.capability)
+                refs.add(item.capability);
+            if (item.kind === "schedule" || item.kind === "command")
+                refs.add(item.action.capability);
+            if (item.kind === "trigger") {
+                for (const action of item.actions)
+                    refs.add(action.capability);
+            }
+        }
+        return refs;
+    }
+    find(identifier, kind) {
+        const value = identifier.trim();
+        const separator = value.indexOf(":");
+        const requestedKind = separator >= 0 ? normalizeKind(value.slice(0, separator)) : kind;
+        const requestedId = separator >= 0 ? value.slice(separator + 1) : value;
+        const candidates = this.definitions(requestedKind);
+        const matches = candidates.filter((item) => item.id === requestedId);
+        if (matches.length > 1)
+            throw new Error(`flow id is ambiguous: ${identifier}`);
+        return matches[0];
+    }
+}
+export function normalizeKind(kind) {
+    if (kind === "triggers" || kind === "trigger")
+        return "trigger";
+    if (kind === "commands" || kind === "command")
+        return "command";
+    if (kind === "schedules" || kind === "schedule")
+        return "schedule";
+    if (kind === "services" || kind === "service")
+        return "service";
+    throw new Error(`unknown flow kind: ${kind}`);
+}
+function sectionToKind(section) {
+    return normalizeKind(section);
+}
+export function normalizeBool(value, fallback) {
+    if (value === undefined || value === null)
+        return fallback;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (["true", "yes", "on", "1"].includes(normalized))
+            return true;
+        if (["false", "no", "off", "0", ""].includes(normalized))
+            return false;
+        throw new Error(`invalid boolean: ${value}`);
+    }
+    return Boolean(value);
+}
+export function normalizeSession(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const result = String(value).trim();
+    return result || undefined;
+}
+export function normalizePositiveInt(value, field, fallback) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const number = Number(value);
+    if (!Number.isInteger(number) || number <= 0)
+        throw new Error(`${field} must be a positive integer`);
+    return number;
+}
+export function normalizeMaxRuns(value) {
+    if (value === undefined || value === null || value === "" || Number(value) === -1)
+        return undefined;
+    const number = Number(value);
+    if (!Number.isInteger(number) || number <= 0)
+        throw new Error("maxRuns must be a positive integer or -1");
+    return number;
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=model.js.map

package/dist/src/config/model.js.map

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

package/dist/src/config/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function paperkiteHome(): string;
+export declare function defaultSettingsFile(): string;
+export declare function defaultFlowsFile(): string;

package/dist/src/config/paths.js

@@ -0,0 +1,12 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function paperkiteHome() {
+    return process.env.PAPERKITE_HOME?.trim() || join(homedir(), ".paperkite");
+}
+export function defaultSettingsFile() {
+    return join(paperkiteHome(), "settings.yml");
+}
+export function defaultFlowsFile() {
+    return join(paperkiteHome(), "flows.yml");
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/config/settings.d.ts

@@ -0,0 +1,19 @@
+export interface SessionGuardSettings {
+    readonly windowMs: number;
+    readonly threshold: number;
+    readonly backoffMinMs: number;
+    readonly backoffMaxMs: number;
+}
+export interface AppSettings {
+    readonly telegram: {
+        readonly apiId: number;
+        readonly apiHash: string;
+        readonly sessionsDir: string;
+        readonly sessionGuard?: SessionGuardSettings;
+    };
+    readonly logging: {
+        readonly level: string;
+        readonly directory: string;
+    };
+}
+export declare function loadSettings(path?: string): Promise<AppSettings>;

package/dist/src/config/settings.js

@@ -0,0 +1,44 @@
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { parse } from "yaml";
+import { isRecord, normalizeSession } from "./model.js";
+import { defaultSettingsFile } from "./paths.js";
+export async function loadSettings(path = defaultSettingsFile()) {
+    const base = dirname(resolve(path));
+    const data = parse(await readFile(resolve(path), "utf8"));
+    if (!isRecord(data) || !isRecord(data.telegram)) {
+        throw new Error("settings.yml needs a telegram section");
+    }
+    const apiId = Number(data.telegram.apiId);
+    const apiHash = normalizeSession(data.telegram.apiHash);
+    if (!Number.isInteger(apiId) || apiId <= 0 || !apiHash) {
+        throw new Error("settings.yml needs telegram.apiId and telegram.apiHash");
+    }
+    const sessionsDir = normalizeSession(data.telegram.sessionsDir) ?? "accounts";
+    const logging = isRecord(data.logging) ? data.logging : {};
+    const guard = isRecord(data.telegram.sessionGuard) ? data.telegram.sessionGuard : {};
+    return {
+        telegram: {
+            apiId,
+            apiHash,
+            sessionsDir: resolve(base, sessionsDir),
+            sessionGuard: {
+                windowMs: positiveNumber(guard.windowMs ?? 60_000, "sessionGuard.windowMs"),
+                threshold: positiveNumber(guard.threshold ?? 5, "sessionGuard.threshold"),
+                backoffMinMs: positiveNumber(guard.backoffMinMs ?? 30_000, "sessionGuard.backoffMinMs"),
+                backoffMaxMs: positiveNumber(guard.backoffMaxMs ?? 30 * 60_000, "sessionGuard.backoffMaxMs")
+            }
+        },
+        logging: {
+            level: String(logging.level ?? "info").toLowerCase(),
+            directory: resolve(base, String(logging.directory ?? "logs"))
+        }
+    };
+}
+function positiveNumber(value, field) {
+    const number = Number(value);
+    if (!Number.isFinite(number) || number <= 0)
+        throw new Error("settings.yml needs a positive " + field);
+    return Math.floor(number);
+}
+//# sourceMappingURL=settings.js.map

package/dist/src/config/settings.js.map

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

package/dist/src/control/process-lock.d.ts

@@ -0,0 +1,4 @@
+export interface ProcessLock {
+    release(): Promise<void>;
+}
+export declare function acquireProcessLock(file: string): Promise<ProcessLock>;

package/dist/src/control/process-lock.js

@@ -0,0 +1,57 @@
+import { mkdir, open, readFile, unlink } from "node:fs/promises";
+import { dirname } from "node:path";
+export async function acquireProcessLock(file) {
+    await mkdir(dirname(file), { recursive: true });
+    try {
+        const handle = await open(file, "wx");
+        await handle.writeFile(JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() }) + "\n");
+        let released = false;
+        return {
+            release: async () => {
+                if (released)
+                    return;
+                released = true;
+                await handle.close();
+                await unlink(file).catch(() => undefined);
+            }
+        };
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "EEXIST")
+            throw error;
+        const existing = await readLock(file);
+        if (existing?.pid && isRunning(existing.pid)) {
+            throw new Error("another paperkite process is using " + file);
+        }
+        await unlink(file).catch(() => undefined);
+        return acquireProcessLock(file);
+    }
+}
+async function readLock(file) {
+    try {
+        const value = JSON.parse(await readFile(file, "utf8"));
+        if (typeof value === "object" && value !== null && "pid" in value) {
+            const pid = Number(value.pid);
+            return Number.isInteger(pid) ? { pid } : undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function isRunning(pid) {
+    if (pid === process.pid)
+        return true;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return isNodeError(error) && error.code === "EPERM";
+    }
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=process-lock.js.map

package/dist/src/control/process-lock.js.map

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

package/dist/src/control/socket.d.ts

@@ -0,0 +1,14 @@
+import type { ActionSpecInput, FlowPatch, RuntimeControl } from "@paperkite/sdk";
+export type { RuntimeControl };
+interface ControlRequest {
+    readonly action?: string;
+    readonly id?: string;
+    readonly spec?: ActionSpecInput;
+    readonly patch?: FlowPatch;
+}
+export interface ControlServer {
+    close(): Promise<void>;
+}
+export declare function controlPath(): string;
+export declare function startControlServer(runtime: RuntimeControl, path?: string): Promise<ControlServer>;
+export declare function requestControl<T = unknown>(request: ControlRequest, path?: string, timeoutMs?: number): Promise<T>;

package/dist/src/control/socket.js

@@ -0,0 +1,131 @@
+import { chmod, mkdir, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { createConnection, createServer } from "node:net";
+import { createInterface } from "node:readline";
+import { paperkiteHome } from "../config/paths.js";
+export function controlPath() {
+    if (process.platform === "win32")
+        return "\\\\.\\pipe\\paperkite-control";
+    return join(paperkiteHome(), "control.sock");
+}
+export async function startControlServer(runtime, path = controlPath()) {
+    if (process.platform !== "win32") {
+        await mkdir(dirname(path), { recursive: true });
+        await unlink(path).catch(() => undefined);
+    }
+    const server = createServer((socket) => handleConnection(socket, runtime));
+    await listen(server, path);
+    if (process.platform !== "win32")
+        await chmod(path, 0o600).catch(() => undefined);
+    return {
+        close: async () => {
+            server.close();
+            await unlink(path).catch(() => undefined);
+        }
+    };
+}
+export async function requestControl(request, path = controlPath(), timeoutMs = 3_000) {
+    return new Promise((resolve, reject) => {
+        const socket = createConnection(path);
+        const input = createInterface({ input: socket, crlfDelay: Infinity });
+        const timer = setTimeout(() => {
+            socket.destroy(new Error("control request timed out"));
+        }, timeoutMs);
+        let settled = false;
+        const finish = (error, value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            input.close();
+            socket.destroy();
+            if (error)
+                reject(error);
+            else
+                resolve(value);
+        };
+        socket.once("error", (error) => finish(error));
+        socket.once("connect", () => socket.write(JSON.stringify(request) + "\n"));
+        input.once("line", (line) => {
+            try {
+                const response = JSON.parse(line);
+                if (response.ok)
+                    finish(undefined, response.result);
+                else
+                    finish(new Error(response.error || "control request failed"));
+            }
+            catch (error) {
+                finish(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    });
+}
+async function handleConnection(socket, runtime) {
+    const input = createInterface({ input: socket, crlfDelay: Infinity });
+    for await (const line of input) {
+        let response;
+        try {
+            response = { ok: true, result: await dispatch(runtime, JSON.parse(line)) };
+        }
+        catch (error) {
+            response = { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+        socket.write(JSON.stringify(response) + "\n");
+    }
+    socket.end();
+}
+async function dispatch(runtime, request) {
+    const action = request.action;
+    if (action === "snapshot")
+        return runtime.snapshot;
+    if (action === "plugins")
+        return runtime.listPlugins();
+    if (action === "runtime.reload") {
+        await runtime.reload();
+        return true;
+    }
+    if (action === "action.run") {
+        if (!request.spec)
+            throw new Error("action.run needs spec");
+        await runtime.executeAction(request.spec);
+        return true;
+    }
+    if (!request.id)
+        throw new Error("control request needs id");
+    if (action === "flow.run") {
+        await runtime.runFlow(request.id);
+        return true;
+    }
+    if (action === "service.start") {
+        await runtime.startService(request.id);
+        return true;
+    }
+    if (action === "service.stop") {
+        await runtime.stopService(request.id);
+        return true;
+    }
+    if (action === "flow.update") {
+        if (!request.patch)
+            throw new Error("flow.update needs id and patch");
+        return runtime.updateFlow(request.id, request.patch);
+    }
+    if (action === "flow.reload") {
+        await runtime.reloadFlow(request.id);
+        return true;
+    }
+    if (action === "session.reconnect") {
+        await runtime.reconnectSession(request.id);
+        return true;
+    }
+    throw new Error("unknown control action: " + action);
+}
+function listen(server, path) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(path, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=socket.js.map

package/dist/src/control/socket.js.map

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

package/dist/src/engine/hooks.d.ts

@@ -0,0 +1,4 @@
+import type { ActionHook } from "@paperkite/sdk";
+export declare function loadHook(reference: string | undefined, configFile: string | undefined): Promise<ActionHook | undefined>;
+export declare function invalidateHook(reference: string | undefined, configFile: string | undefined): void;
+export declare function invalidateAllHooks(): void;

package/dist/src/engine/hooks.js

@@ -0,0 +1,38 @@
+import { readFile } from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+const loaded = new Map();
+export async function loadHook(reference, configFile) {
+    if (!reference)
+        return undefined;
+    const file = hookFile(reference, configFile);
+    const cached = loaded.get(file);
+    if (cached)
+        return cached;
+    const hook = await importHook(file);
+    loaded.set(file, hook);
+    return hook;
+}
+export function invalidateHook(reference, configFile) {
+    if (!reference)
+        return;
+    loaded.delete(hookFile(reference, configFile));
+}
+export function invalidateAllHooks() {
+    loaded.clear();
+}
+function hookFile(reference, configFile) {
+    const base = configFile ? resolve(configFile, "..") : process.cwd();
+    return resolve(base, reference);
+}
+async function importHook(file) {
+    const source = await readFile(file, "utf8");
+    const js = stripTypeScriptTypes(source, { sourceUrl: pathToFileURL(file).href });
+    const url = `data:text/javascript;base64,${Buffer.from(js, "utf8").toString("base64")}`;
+    const module = (await import(url));
+    if (typeof module.default !== "function")
+        throw new Error("hook must export a default function: " + file);
+    return module.default;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/engine/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/engine/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAA6B,EAAE,UAA8B;IAC1F,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAA6B,EAAE,UAA8B;IAC1F,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB,EAAE,UAA8B;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACpE,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,+BAA+B,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxF,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAA0B,CAAC;IAC5D,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,IAAI,CAAC,CAAC;IAC1G,OAAO,MAAM,CAAC,OAAqB,CAAC;AACtC,CAAC"}

package/dist/src/engine/logger.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeLogger } from "@paperkite/sdk";
+export declare class AppLogger implements RuntimeLogger {
+    private readonly level;
+    private readonly directory?;
+    private readonly scope?;
+    private readonly threshold;
+    private readonly children;
+    constructor(level?: string, directory?: string | undefined, scope?: string | undefined);
+    child(scope: string): AppLogger;
+    registeredScopes(): readonly string[];
+    logDirectory(): string | undefined;
+    debug(message: string, ...values: unknown[]): void;
+    info(message: string, ...values: unknown[]): void;
+    warn(message: string, ...values: unknown[]): void;
+    error(message: string, ...values: unknown[]): void;
+    private write;
+}

package/dist/src/engine/logger.js

@@ -0,0 +1,78 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+const levels = ["debug", "info", "warn", "error"];
+export class AppLogger {
+    level;
+    directory;
+    scope;
+    threshold;
+    children = new Map();
+    constructor(level = "info", directory, scope) {
+        this.level = level;
+        this.directory = directory;
+        this.scope = scope;
+        this.threshold = Math.max(0, levels.indexOf(normalizeLevel(level)));
+    }
+    child(scope) {
+        const existing = this.children.get(scope);
+        if (existing)
+            return existing;
+        const child = new AppLogger(this.level, this.directory, scope);
+        this.children.set(scope, child);
+        return child;
+    }
+    registeredScopes() {
+        return [...this.children.keys()];
+    }
+    logDirectory() {
+        return this.directory;
+    }
+    debug(message, ...values) {
+        this.write("debug", message, values);
+    }
+    info(message, ...values) {
+        this.write("info", message, values);
+    }
+    warn(message, ...values) {
+        this.write("warn", message, values);
+    }
+    error(message, ...values) {
+        this.write("error", message, values);
+    }
+    write(level, message, values) {
+        if (levels.indexOf(level) < this.threshold)
+            return;
+        const suffix = values.length ? " " + values.map(formatValue).join(" ") : "";
+        const line = new Date().toISOString() +
+            " " +
+            level.toUpperCase() +
+            (this.scope ? " [" + this.scope + "]" : "") +
+            " " +
+            message +
+            suffix +
+            "\n";
+        process.stderr.write(line);
+        if (this.directory) {
+            void mkdir(this.directory, { recursive: true })
+                .then(() => appendFile(join(this.directory, basename(this.scope || "paperkite") + ".log"), line, "utf8"))
+                .catch(() => undefined);
+        }
+    }
+}
+function normalizeLevel(value) {
+    const lowered = value.toLowerCase();
+    return levels.includes(lowered) ? lowered : "info";
+}
+function formatValue(value) {
+    if (value instanceof Error)
+        return value.stack || value.message;
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/engine/logger.js.map

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