@webda/debug 4.0.0-beta.3

package/lib/introspection.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Information about a registered model.
+ */
+export interface ModelInfo {
+    /** Fully-qualified model identifier, e.g. "MyApp/Task" */
+    id: string;
+    /** Plural name used in REST URLs, e.g. "Tasks" */
+    plural: string;
+    /** List of action names defined on the model */
+    actions: string[];
+    /** Relation graph (links, queries, maps, binaries) */
+    relations: any;
+    /** Full raw ModelMetadata object */
+    metadata: any;
+}
+/**
+ * Information about a running service.
+ */
+export interface ServiceInfo {
+    /** Service registration name */
+    name: string;
+    /** Service type string (e.g. "Webda/Router") */
+    type: string;
+    /** Current lifecycle state (e.g. "running") */
+    state: string;
+    /** Capabilities advertised by the service */
+    capabilities: Record<string, any>;
+    /** Service configuration parameters */
+    configuration: Record<string, any>;
+}
+/**
+ * Information about a registered operation.
+ */
+export interface OperationInfo {
+    /** Operation identifier, e.g. "Task.Create" */
+    id: string;
+    /** Input schema identifier. "void" means no input. */
+    input: string;
+    /** Output schema identifier. "void" means no output. */
+    output: string;
+    /** Parameters schema identifier, if any */
+    parameters?: string;
+    /** Additional fields from the operation definition */
+    [key: string]: any;
+}
+/**
+ * Information about a single route entry.
+ */
+export interface RouteInfoEntry {
+    /** URL path pattern, e.g. "/tasks/{uuid}" */
+    path: string;
+    /** HTTP methods accepted by this route, e.g. ["GET","POST"] */
+    methods: string[];
+    /** Name of the executor service */
+    executor: string;
+}
+/**
+ * Returns introspection data for all models registered in the application.
+ *
+ * Each entry contains the model identifier, plural name, action names, relation
+ * graph, and the full raw ModelMetadata object.
+ *
+ * @returns Array of {@link ModelInfo} objects, one per registered model.
+ */
+export declare function getModels(): ModelInfo[];
+/**
+ * Returns introspection data for a single model by its identifier.
+ *
+ * @param id - Fully-qualified model identifier, e.g. "MyApp/Task".
+ * @returns The matching {@link ModelInfo}, or `undefined` if not found.
+ */
+export declare function getModel(id: string): ModelInfo | undefined;
+/**
+ * Returns introspection data for all services currently registered with Core.
+ *
+ * Null / undefined service slots are filtered out before mapping.
+ *
+ * @returns Array of {@link ServiceInfo} objects, one per registered service.
+ */
+export declare function getServices(): ServiceInfo[];
+/**
+ * Returns introspection data for all operations registered in the instance storage.
+ *
+ * The `service` and `method` internal fields are omitted by {@link listOperations};
+ * each entry gets a synthetic `id` field added.
+ *
+ * @returns Array of {@link OperationInfo} objects.
+ */
+export declare function getOperations(): OperationInfo[];
+/**
+ * Returns introspection data for all routes registered with the Router service.
+ *
+ * A single path can have multiple route entries (one per executor / method set);
+ * each is returned as a separate {@link RouteInfoEntry}.
+ *
+ * @returns Array of {@link RouteInfoEntry} objects.
+ */
+export declare function getRoutes(): RouteInfoEntry[];
+/**
+ * Returns the active application configuration object.
+ *
+ * This is the merged configuration (global + deployment overrides) that the
+ * running application was started with.
+ *
+ * @returns Plain configuration record.
+ */
+export declare function getConfig(): Record<string, any>;
+/**
+ * Returns project information including package.json data, git info, and deployment details.
+ *
+ * Adds the current working directory to the result.
+ *
+ * @returns Project information or a minimal fallback from package.json.
+ */
+export declare function getAppInfo(): Record<string, any>;

package/lib/introspection.js

@@ -0,0 +1,260 @@
+import { useApplication, useCore, useRouter, listFullOperations, useModelMetadata } from "@webda/core";
+/**
+ * Returns introspection data for all models registered in the application.
+ *
+ * Each entry contains the model identifier, plural name, action names, relation
+ * graph, and the full raw ModelMetadata object.
+ *
+ * @returns Array of {@link ModelInfo} objects, one per registered model.
+ */
+export function getModels() {
+    const app = useApplication();
+    const core = useCore();
+    const models = app.getModels();
+    return Object.entries(models).map(([key, model]) => {
+        const metadata = useModelMetadata(model);
+        let storeName;
+        let storeType;
+        try {
+            const store = core.getModelStore(model);
+            if (store) {
+                storeName = store.getName();
+                storeType = store.constructor?.name;
+            }
+        }
+        catch {
+            // No store assigned
+        }
+        return {
+            id: metadata?.Identifier || key,
+            plural: metadata?.Plural || key,
+            actions: Object.keys(metadata?.Actions || {}),
+            relations: metadata?.Relations || {},
+            store: storeName,
+            storeType,
+            schemas: metadata?.Schemas,
+            metadata
+        };
+    });
+}
+/**
+ * Returns introspection data for a single model by its identifier.
+ *
+ * @param id - Fully-qualified model identifier, e.g. "MyApp/Task".
+ * @returns The matching {@link ModelInfo}, or `undefined` if not found.
+ */
+export function getModel(id) {
+    return getModels().find(m => m.id === id);
+}
+/**
+ * Returns introspection data for all services currently registered with Core.
+ *
+ * Null / undefined service slots are filtered out before mapping.
+ *
+ * @returns Array of {@link ServiceInfo} objects, one per registered service.
+ */
+export function getServices() {
+    const core = useCore();
+    const app = useApplication();
+    const services = core.getServices();
+    const config = core.getConfiguration?.() || {};
+    return Object.entries(services)
+        .filter(([, svc]) => svc != null)
+        .map(([name, svc]) => {
+        const type = svc.parameters?.type || "unknown";
+        // Collect metric definitions and current values from the service's metrics object
+        const metricsInfo = [];
+        const metricsObj = svc.metrics;
+        if (metricsObj && typeof metricsObj === "object") {
+            for (const [key, metric] of Object.entries(metricsObj)) {
+                if (!metric || typeof metric !== "object")
+                    continue;
+                const m = metric;
+                try {
+                    const values = m.hashMap ? Object.values(m.hashMap).map((v) => ({
+                        value: v.value,
+                        labels: v.labels
+                    })) : [];
+                    metricsInfo.push({
+                        name: key,
+                        fullName: m.name,
+                        help: m.help,
+                        type: m.constructor?.name?.toLowerCase() || "unknown",
+                        labelNames: m.labelNames || [],
+                        values
+                    });
+                }
+                catch {
+                    // Skip unreadable metrics
+                }
+            }
+        }
+        return {
+            name,
+            type,
+            state: svc.getState(),
+            capabilities: svc.getCapabilities(),
+            configuration: config[name] || {},
+            schema: app.getSchema?.(app.completeNamespace(type)) || undefined,
+            metrics: metricsInfo.length > 0 ? metricsInfo : undefined
+        };
+    });
+}
+/**
+ * Returns introspection data for all operations registered in the instance storage.
+ *
+ * The `service` and `method` internal fields are omitted by {@link listOperations};
+ * each entry gets a synthetic `id` field added.
+ *
+ * @returns Array of {@link OperationInfo} objects.
+ */
+export function getOperations() {
+    const ops = listFullOperations();
+    const app = useApplication();
+    const core = useCore();
+    // Build a map of operation ID → full route URL by scanning the router's openapi metadata
+    const operationRoutes = {};
+    try {
+        const router = useRouter();
+        const routes = router.getRoutes();
+        for (const [path, infos] of Object.entries(routes)) {
+            for (const info of infos) {
+                if (!info.openapi)
+                    continue;
+                // One route can serve several verbs (PUT and PATCH), each with its own operation
+                for (const [method, methodDef] of Object.entries(info.openapi)) {
+                    if (methodDef?.operationId) {
+                        operationRoutes[methodDef.operationId] = { url: path, method: method.toLowerCase() };
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Router may not be available
+    }
+    return Object.entries(ops).map(([opId, def]) => {
+        const entry = { ...def, id: opId };
+        // Resolve input/output schema refs to actual JSON Schema objects
+        for (const key of ["input", "output"]) {
+            if (entry[key] && entry[key] !== "void") {
+                entry[`${key}Schema`] = app.getSchema?.(entry[key]) || undefined;
+            }
+        }
+        // Enrich rest with full URL from router
+        const route = operationRoutes[opId];
+        if (route) {
+            entry.rest = { ...(typeof entry.rest === "object" ? entry.rest : {}), url: route.url, method: entry.rest?.method || route.method };
+        }
+        // Dedent: find the smallest leading whitespace (skipping the first line which
+        // Function.toString() always returns at column 0) and strip it from all lines
+        const dedent = (code) => {
+            const lines = code.split("\n");
+            if (lines.length <= 1)
+                return code;
+            // Compute min indent from lines 1+ (skip first line and empty lines)
+            const indents = lines.slice(1).filter(l => l.trim().length > 0).map(l => (l.match(/^(\s*)/) || ["", ""])[1].length);
+            if (indents.length === 0)
+                return code;
+            const min = Math.min(...indents);
+            if (min === 0)
+                return code;
+            return [lines[0], ...lines.slice(1).map(l => l.slice(min))].join("\n");
+        };
+        // Resolve implementor info
+        try {
+            if (def.service) {
+                const svc = core.getService(def.service);
+                entry.implementor = { type: "service", name: def.service };
+                if (svc && def.method) {
+                    // For model actions, the real code is on the model prototype
+                    const actionName = def.context?.action?.name;
+                    const modelClass = def.context?.model;
+                    if (actionName && modelClass?.prototype?.[actionName]) {
+                        const fn = modelClass.prototype[actionName];
+                        const modelId = modelClass.getIdentifier?.() || modelClass.name || def.service;
+                        entry.implementor = { type: "model", name: modelId, method: actionName };
+                        entry.implementor.code = dedent((fn.__original || fn).toString());
+                    }
+                    else if (typeof svc[def.method] === "function") {
+                        entry.implementor.method = def.method;
+                        const fn = svc[def.method];
+                        entry.implementor.code = dedent((fn.__original || fn).toString());
+                    }
+                }
+            }
+            else if (def.model) {
+                const modelClass = app.getModel(def.model);
+                entry.implementor = { type: "model", name: def.model };
+                if (modelClass && def.method) {
+                    const fn = modelClass.prototype?.[def.method] || modelClass[def.method];
+                    if (typeof fn === "function") {
+                        entry.implementor.method = def.method;
+                        entry.implementor.code = dedent((fn.__original || fn).toString());
+                    }
+                }
+            }
+        }
+        catch {
+            // Service/model may not be resolvable
+        }
+        // Strip internal fields not useful for the UI
+        delete entry.service;
+        delete entry.model;
+        delete entry.method;
+        delete entry.context;
+        delete entry.permissionQuery;
+        return entry;
+    });
+}
+/**
+ * Returns introspection data for all routes registered with the Router service.
+ *
+ * A single path can have multiple route entries (one per executor / method set);
+ * each is returned as a separate {@link RouteInfoEntry}.
+ *
+ * @returns Array of {@link RouteInfoEntry} objects.
+ */
+export function getRoutes() {
+    const router = useRouter();
+    const routes = router.getRoutes();
+    const result = [];
+    for (const [path, infos] of Object.entries(routes)) {
+        for (const info of infos) {
+            result.push({ path, methods: info.methods, executor: info.executor });
+        }
+    }
+    return result;
+}
+/**
+ * Returns the active application configuration object.
+ *
+ * This is the merged configuration (global + deployment overrides) that the
+ * running application was started with.
+ *
+ * @returns Plain configuration record.
+ */
+export function getConfig() {
+    return useApplication().getConfiguration();
+}
+/**
+ * Returns project information including package.json data, git info, and deployment details.
+ *
+ * Adds the current working directory to the result.
+ *
+ * @returns Project information or a minimal fallback from package.json.
+ */
+export function getAppInfo() {
+    const app = useApplication();
+    const projectInfo = app.getProjectInfo?.();
+    if (projectInfo) {
+        return { ...projectInfo, workingDirectory: process.cwd() };
+    }
+    // Fallback for unpacked apps without full project info
+    const pkg = app.getPackageDescription();
+    return {
+        package: pkg,
+        workingDirectory: process.cwd()
+    };
+}
+//# sourceMappingURL=introspection.js.map

package/lib/introspection.js.map

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

package/lib/logbuffer.d.ts

@@ -0,0 +1,75 @@
+import { type WorkerLogLevel } from "@webda/workout";
+/**
+ * A single captured log entry.
+ */
+export interface LogEntry {
+    /** Unique identifier for this entry */
+    id: string;
+    /** Unix timestamp when the log was emitted */
+    timestamp: number;
+    /** Severity level */
+    level: WorkerLogLevel;
+    /** Formatted message string */
+    message: string;
+    /** Raw arguments from the log call */
+    args: any[];
+}
+/**
+ * Event emitted when a new log entry is captured.
+ */
+export type LogEvent = {
+    type: "log";
+    id: string;
+    timestamp: number;
+    level: WorkerLogLevel;
+    message: string;
+};
+type LogEventCallback = (event: LogEvent) => void;
+/**
+ * Ring buffer that captures application logs from WorkerOutput
+ * and notifies subscribers of new entries in real time.
+ */
+export declare class LogBuffer {
+    private maxSize;
+    /** Stored log entries */
+    private entries;
+    /** Active event subscribers */
+    private subscribers;
+    /** Listener function attached to WorkerOutput */
+    private listener;
+    /**
+     * Create a new LogBuffer.
+     * @param maxSize - Maximum number of entries to retain (oldest are evicted)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Start listening to WorkerOutput messages.
+     */
+    subscribe(): void;
+    /**
+     * Stop listening to WorkerOutput messages.
+     */
+    unsubscribe(): void;
+    /**
+     * Return a shallow copy of all stored entries.
+     * @returns array of log entries
+     */
+    getEntries(): LogEntry[];
+    /** Log level severity order — higher index means more severe. */
+    private static readonly LOG_LEVELS;
+    /**
+     * Filter entries by query. If the query matches a log level name,
+     * filter by severity (>= that level). Otherwise, do a text search
+     * on message and level.
+     * @param query - search string or log level name
+     * @returns matching entries
+     */
+    search(query: string): LogEntry[];
+    /**
+     * Register a callback for new log events.
+     * @param callback - function invoked on each new log event
+     * @returns unsubscribe function
+     */
+    onEvent(callback: LogEventCallback): () => void;
+}
+export {};

package/lib/logbuffer.js

@@ -0,0 +1,98 @@
+import { useWorkerOutput } from "@webda/workout";
+/**
+ * Ring buffer that captures application logs from WorkerOutput
+ * and notifies subscribers of new entries in real time.
+ */
+export class LogBuffer {
+    /**
+     * Create a new LogBuffer.
+     * @param maxSize - Maximum number of entries to retain (oldest are evicted)
+     */
+    constructor(maxSize = 2000) {
+        this.maxSize = maxSize;
+        /** Stored log entries */
+        this.entries = [];
+        /** Active event subscribers */
+        this.subscribers = new Set();
+        this.listener = (msg) => {
+            if (msg.type !== "log" || !msg.log)
+                return;
+            const id = Math.random().toString(36).substring(2);
+            const entry = {
+                id,
+                timestamp: msg.timestamp,
+                level: msg.log.level,
+                message: msg.log.args
+                    .map((a) => (typeof a === "object" ? JSON.stringify(a) : String(a)))
+                    .join(" "),
+                args: msg.log.args
+            };
+            if (this.entries.length >= this.maxSize) {
+                this.entries.shift();
+            }
+            this.entries.push(entry);
+            const event = {
+                type: "log",
+                id,
+                timestamp: entry.timestamp,
+                level: entry.level,
+                message: entry.message
+            };
+            for (const cb of this.subscribers) {
+                cb(event);
+            }
+        };
+    }
+    /**
+     * Start listening to WorkerOutput messages.
+     */
+    subscribe() {
+        useWorkerOutput().on("message", this.listener);
+    }
+    /**
+     * Stop listening to WorkerOutput messages.
+     */
+    unsubscribe() {
+        try {
+            useWorkerOutput().removeListener("message", this.listener);
+        }
+        catch {
+            // WorkerOutput may not be available
+        }
+    }
+    /**
+     * Return a shallow copy of all stored entries.
+     * @returns array of log entries
+     */
+    getEntries() {
+        return [...this.entries];
+    }
+    /**
+     * Filter entries by query. If the query matches a log level name,
+     * filter by severity (>= that level). Otherwise, do a text search
+     * on message and level.
+     * @param query - search string or log level name
+     * @returns matching entries
+     */
+    search(query) {
+        const upper = query.toUpperCase();
+        const levelIndex = LogBuffer.LOG_LEVELS.indexOf(upper);
+        if (levelIndex >= 0) {
+            return this.entries.filter(e => LogBuffer.LOG_LEVELS.indexOf(e.level) >= levelIndex);
+        }
+        const lower = query.toLowerCase();
+        return this.entries.filter(e => e.message.toLowerCase().includes(lower) || e.level.toLowerCase().includes(lower));
+    }
+    /**
+     * Register a callback for new log events.
+     * @param callback - function invoked on each new log event
+     * @returns unsubscribe function
+     */
+    onEvent(callback) {
+        this.subscribers.add(callback);
+        return () => this.subscribers.delete(callback);
+    }
+}
+/** Log level severity order — higher index means more severe. */
+LogBuffer.LOG_LEVELS = ["TRACE", "DEBUG", "INFO", "WARN", "ERROR"];
+//# sourceMappingURL=logbuffer.js.map

package/lib/logbuffer.js.map

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