@svadmin/devtools 0.2.3 → 0.3.0

package/README.md

@@ -13,6 +13,10 @@ and the CLI can share:
   resource operations, menu visibility, provider routing, and route paths.
 - `toPermissionDiagnostic(resource, action, result)` — normalizes access-control
   results for display.
+- `buildAdminDiagnostics(options)` — combines the complete application snapshot,
+  provider/resource/route diagnostics, and a healthy/warning/error summary.
+- `buildDevtoolsHealthSummary(input)` — derives a small health summary for a
+  panel badge, CLI output, or readiness check.
 - Re-exports the whole `@svadmin/devtools-contract` surface.
 
 UI rendering stays in `@svadmin/ui` (`DevTools.svelte`); this package is the
@@ -34,6 +38,12 @@ collector.recordDiagnostic({
 
 const snapshot = collector.snapshot({ requestId: 'req-1' });
 const providers = buildProviderDiagnostics(config.providers);
+const diagnostics = buildAdminDiagnostics({
+  providers: config.providers,
+  resources: config.resources,
+  basePath: '/admin',
+});
+diagnostics.health.status; // 'healthy' | 'warning' | 'error'
 ```
 
-Secrets are redacted by `redactDevtoolsRecord` before a snapshot is produced.
+Secrets are redacted by `redactDevtoolsRecord` before a snapshot is produced.

package/dist/index.d.ts

@@ -10,6 +10,17 @@ export { createDevtoolsSnapshot, redactDevtoolsRecord } from '@svadmin/devtools-
 export type { DevtoolsCacheDiagnostics, DevtoolsDiagnostic, DevtoolsEvent, DevtoolsLocation, DevtoolsProviderDiagnostic, DevtoolsQueryDiagnostic, DevtoolsSeverity, DevtoolsSnapshot, DevtoolsSource, DevtoolsTraceContext, SvadminDevtoolsSnapshot, } from '@svadmin/devtools-contract';
 import { type DevtoolsDiagnostic, type DevtoolsEvent, type DevtoolsProviderDiagnostic, type DevtoolsSnapshot, type DevtoolsSource, type DevtoolsTraceContext } from '@svadmin/devtools-contract';
 import type { ProviderBundle, ResourceDefinition } from '@svadmin/core';
+export type DevtoolsHealthStatus = 'healthy' | 'warning' | 'error';
+export interface DevtoolsHealthSummary {
+    status: DevtoolsHealthStatus;
+    errors: number;
+    warnings: number;
+    info: number;
+    configuredProviders: number;
+    totalProviders: number;
+    resources: number;
+    routes: number;
+}
 export interface DevtoolsCollectorOptions {
     source?: DevtoolsSource;
     maxEvents?: number;
@@ -24,6 +35,22 @@ export interface DevtoolsCollector {
     snapshot(context?: DevtoolsTraceContext): DevtoolsSnapshot;
     subscribe(listener: (snapshot: DevtoolsSnapshot) => void): () => void;
 }
+export interface DevtoolsAppDiagnostics {
+    snapshot: DevtoolsSnapshot;
+    providers: DevtoolsProviderDiagnostic[];
+    resources: DevtoolsResourceDiagnostic[];
+    routes: DevtoolsRouteDiagnostic[];
+    health: DevtoolsHealthSummary;
+}
+export interface BuildAdminDiagnosticsOptions {
+    providers: ProviderBundle;
+    resources: readonly ResourceDefinition[];
+    diagnostics?: readonly DevtoolsDiagnostic[];
+    events?: readonly DevtoolsEvent[];
+    source?: DevtoolsSource;
+    context?: DevtoolsTraceContext;
+    basePath?: string;
+}
 /**
  * Bounded in-memory collector. Events and diagnostics are capped so a long-lived
  * admin session cannot grow without limit; snapshots are redacted on build.
@@ -61,3 +88,16 @@ export declare function toPermissionDiagnostic(resource: string, action: string,
     can: boolean;
     reason?: string;
 }): DevtoolsPermissionDiagnostic;
+export declare function buildDevtoolsHealthSummary(input: {
+    diagnostics: readonly DevtoolsDiagnostic[];
+    providers: readonly DevtoolsProviderDiagnostic[];
+    resources: readonly DevtoolsResourceDiagnostic[];
+    routes: readonly DevtoolsRouteDiagnostic[];
+}): DevtoolsHealthSummary;
+/**
+ * Builds the complete JSON-safe application diagnostic view used by DevTools,
+ * the CLI, and integration tests. The input contains only provider/resource
+ * metadata and already-sanitized diagnostics/events; no runtime payloads are
+ * copied into the result.
+ */
+export declare function buildAdminDiagnostics(options: BuildAdminDiagnosticsOptions): DevtoolsAppDiagnostics;

package/dist/index.js

@@ -126,3 +126,52 @@ export function toPermissionDiagnostic(resource, action, result) {
         ...(result.reason !== undefined ? { reason: result.reason } : {}),
     };
 }
+export function buildDevtoolsHealthSummary(input) {
+    const errors = input.diagnostics.filter((diagnostic) => diagnostic.severity === 'error').length;
+    const warnings = input.diagnostics.filter((diagnostic) => diagnostic.severity === 'warning').length;
+    const info = input.diagnostics.filter((diagnostic) => diagnostic.severity === 'info').length;
+    const status = errors > 0
+        ? 'error'
+        : warnings > 0
+            ? 'warning'
+            : 'healthy';
+    return {
+        status,
+        errors,
+        warnings,
+        info,
+        configuredProviders: input.providers.filter((provider) => provider.configured).length,
+        totalProviders: input.providers.length,
+        resources: input.resources.length,
+        routes: input.routes.length,
+    };
+}
+/**
+ * Builds the complete JSON-safe application diagnostic view used by DevTools,
+ * the CLI, and integration tests. The input contains only provider/resource
+ * metadata and already-sanitized diagnostics/events; no runtime payloads are
+ * copied into the result.
+ */
+export function buildAdminDiagnostics(options) {
+    const providers = buildProviderDiagnostics(options.providers);
+    const resources = buildResourceDiagnostics(options.resources);
+    const routes = buildRouteDiagnostics(options.resources, options.basePath);
+    const diagnostics = [...(options.diagnostics ?? [])];
+    const events = [...(options.events ?? [])];
+    const context = options.context ?? {};
+    const snapshot = createDevtoolsSnapshot({
+        source: options.source ?? 'frontend',
+        diagnostics,
+        events,
+        ...(context.requestId !== undefined ? { requestId: context.requestId } : {}),
+        ...(context.traceId !== undefined ? { traceId: context.traceId } : {}),
+        ...(context.correlationId !== undefined ? { correlationId: context.correlationId } : {}),
+    });
+    return {
+        snapshot,
+        providers,
+        resources,
+        routes,
+        health: buildDevtoolsHealthSummary({ diagnostics, providers, resources, routes }),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/devtools",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Headless diagnostics core for svadmin — query traces, provider diagnostics, permission/resource/route inspection",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "@svadmin/devtools-contract": "^0.3.0"
   },
   "peerDependencies": {
-    "@svadmin/core": "^0.59.0"
+    "@svadmin/core": "^0.60.0"
   },
   "peerDependenciesMeta": {
     "@svadmin/core": {